Eve

    Eve is Vercel's filesystem-first framework for durable agents. Files under agent/tools/ become typed model tools, which makes them a natural place to adapt the agent-device Node.js client.

    Create an Eve project, then add agent-device:

    npx eve@latest init mobile-agent
cd mobile-agent
pnpm add agent-device

    Add agent/tools/agent_device.ts:

    import { createAgentDeviceClient } from 'agent-device';
import { defineTool } from 'eve/tools';
import { z } from 'zod';

const client = createAgentDeviceClient({
  session: 'eve-agent',
  lockPolicy: 'reject',
});

export default defineTool({
  description: 'Inspect or interact with the current device UI.',
  inputSchema: z.discriminatedUnion('action', [
    z.object({
      action: z.literal('open'),
      app: z.string().min(1),
      platform: z.enum(['ios', 'android']),
    }),
    z.object({
      action: z.literal('snapshot'),
    }),
    z.object({
      action: z.literal('press'),
      ref: z.string().regex(/^@e\d+$/),
    }),
    z.object({
      action: z.literal('close'),
    }),
  ]),
  async execute(input) {
    switch (input.action) {
      case 'open':
        return await client.apps.open({ app: input.app, platform: input.platform });
      case 'snapshot':
        return await client.capture.snapshot({ interactiveOnly: true });
      case 'press':
        return await client.interactions.press({ ref: input.ref });
      case 'close':
        return await client.sessions.close();
    }
  },
});

    Eve discovers the file automatically; no tool registry is required. Tell the agent how to use it in agent/instructions.md:

    Use the agent_device tool to inspect and operate the app.

- Open the requested app before inspecting it.
- Call snapshot before every interaction.
- Only press an @e ref from the latest snapshot.
- Verify the requested outcome with another snapshot.
- Call close when the device task is complete.

    For CI or another short-lived host, the outer runner should still close the named agent-device session in its own cleanup path. Model-directed close is useful during the normal tool loop, but it is not a replacement for deterministic cleanup after errors or cancellation.

    Runtime placement

    Run the tool in Eve's app runtime when it needs local access to simulators, emulators, platform tooling, and daemon state. If Eve is hosted separately from the devices, connect through an agent-device remote proxy instead.

    Eve is currently beta, so check its current documentation when upgrading. For a production example, read Building Mobile QA Agents With Vercel Eve, which covers a PR QA agent using an agent_device tool and a deterministic CI runner.

    See Node.js API for the complete client surface.

    Need React or React Native expertise you can count on?

    Let's talk