@e2edev/agent-device 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TesterArmy, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @e2edev/agent-device
+
+The mobile backend for [`e2e`](https://www.npmjs.com/package/e2e), built on
+[agent-device](https://github.com/callstack/agent-device): iOS simulators and
+Android emulators through the same `@e2edev/e2e/backend` contract the browser backend
+implements. A test written against `screen`, `expect`, `app`, and `agent` runs
+on a device target unchanged; nothing in `e2e` core knows this package exists.
+
+## Install
+
+```bash
+npm install --save-dev @e2edev/e2e @e2edev/agent-device
+```
+
+`agent-device` needs Xcode with an iOS simulator runtime, or the Android SDK
+with an emulator. Run `npx agent-device doctor` once before handing the target
+to the runner.
+
+```ts title="e2e.config.ts"
+import { defineConfig } from '@e2edev/e2e';
+import { createAgent } from '@e2edev/e2e/agent';
+import { agentDevice } from '@e2edev/agent-device';
+import { agentDeviceTools } from '@e2edev/agent-device/tools';
+
+const iphone = agentDevice({ platform: 'ios', app: 'Settings' });
+const pixel = agentDevice({ platform: 'android', app: 'com.android.settings' });
+
+export default defineConfig({
+  targets: [
+    { name: 'iphone', platform: 'ios', backend: iphone },
+    { name: 'pixel', platform: 'android', backend: pixel },
+  ],
+  workers: 1,
+  agent: { executor: createAgent({ tools: agentDeviceTools(iphone, pixel) }) },
+});
+```
+
+A test written against `agent`, `app`, `screen`, and `device` runs on both
+targets unchanged. Only a check that names a platform label (`General` on iOS,
+`Network & internet` on Android) needs `platforms: ['ios']` or
+`platforms: ['android']` on the test.
+
+Options:
+
+| Option | Meaning |
+| --- | --- |
+| `platform` | `'ios'` or `'android'`. |
+| `app` | Bundle id, package, or display name opened fresh at the start of every attempt. Also unlocks `app.restart()` and `app.clearState()`. |
+| `device` | Simulator or emulator name or id; a booted one is picked otherwise. |
+| `session` | agent-device session name; defaults to `e2e-<target name>`. One run per session at a time. |
+| `snapshot` | `'full'` (default, includes static text) or `'interactive'` (actionable nodes only). |
+
+## What the backend declares
+
+- **Observation**: the accessibility tree, projected onto the role vocabulary
+  (iOS `Button` becomes `button`, `TextField` becomes `textbox`, `Cell` becomes
+  `listitem`; Android `android.widget.TextView` becomes `text`, `EditText`
+  becomes `textbox`, `Switch` becomes `switch`), with rects, a viewport, and
+  pixels on request with every secure field painted over. Element identifiers
+  (`ABOUT`, `android:id/title`) surface as the configured test id attribute.
+- **Actions**: tap, double tap, long press, fill, clear, check/uncheck (when
+  the tree exposes the checked state; Android switches do not), focus on
+  editable fields, `Enter`, single-character keys, swipe within a node, drag.
+  `selectOption`, `setInputFiles`, focus on a control, and other keys fail
+  with `UNSUPPORTED_CAPABILITY`.
+- **Location**: every `screen` query, plus agent-device selectors through
+  `device.locator('role=NavigationBar id=General')`.
+- **Viewport swipe**, `app.back()`, `app.restart()`, `app.clearState()`, and
+  redacted screenshots under the attempt artifact directory: the bounds of
+  every secure field are painted black before the file is kept, and a
+  screenshot that cannot be redacted is not written. No `state` capability: a
+  simulator has no portable session snapshot.
+
+## Trace cache
+
+The runner caches `agent.act` steps by their location anchor, and a device has
+no address bar. This backend reports one anyway: `app://device/<bundle
+id>/<screen title>`, with the title read off the navigation bar on iOS and the
+collapsing toolbar on Android. The cache compares pathnames, so the app
+identity is part of the path and two apps with a "General" screen never share
+an anchor. A step recorded on `/com.apple.preferences/General` replays only
+when that app is on that screen again, and a flow that stays within tap, type,
+and scroll replays with zero model calls. Pin `app` so every attempt starts on the same screen, and
+prefer the grammar over the `open_app` tool inside a step: a tool call is a
+replay gap.
+
+## The `device` fixture
+
+Deterministic device management, recorded as `device.<method>` steps. Import
+`test` from this package to have it typed.
+
+```ts
+import { test } from '@e2edev/agent-device';
+import { expect } from '@e2edev/e2e';
+
+test('shows the version offline in dark mode', async ({ agent, device, screen }) => {
+  await device.setAppearance('dark');
+  await device.setNetwork('offline');
+  await agent.act('go to General, then About');
+  await expect(screen.getByRole('button', { name: /^iOS Version/ })).toBeVisible();
+  await expect(device.locator('role=NavigationBar id=About')).toBeVisible();
+});
+```
+
+Methods: `setNetwork`, `setAirplaneMode`, `setPermission`, `setLocation`,
+`clearLocation`, `setAppearance`, `setOrientation`, `setBiometrics`,
+`enrollBiometrics`, `openApp`, `closeApp`, `foregroundApp`, `home`, `back`,
+`alert`, `dismissKeyboard`, `clipboard`, `setClipboard`, and the `locator`
+accessor.
+
+## Agent tools
+
+`@e2edev/agent-device/tools` exports `agentDeviceTools(...backends)`:
+`open_app`, `swipe` (free-form, in logical pixels), `type_text` (into the
+focused field, for editors that hide it from the tree), `alert`, and
+`screenshot` (the model sees the image). Pass every device backend the config
+declares: tool names are fixed, so two packs cannot be merged, and the pack
+dispatches each call to the backend whose attempt is running. Tools are scoped
+to the platforms of those backends, so a suite that mixes web and device
+targets can hand the pack to one `createAgent`.
+
+## Secrets
+
+Secret fills need an origin the runner can check, and an `app://` location has
+an opaque origin that no allowlist can name, so `type_secret` is denied on a
+device target before any plaintext reaches the device. Fill credentials
+through a deterministic `screen` action in a setup step instead.
+
+## Documentation
+
+Full documentation lives at [e2e.dev](https://e2e.dev).

package/dist/backend.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The agent-device backend for e2e (RFC0002): a mobile body built with the
+ * public `defineBackend`, validated by the same rules and graded by the same
+ * capabilities as any other backend. Core imports nothing from here; this
+ * package imports the contract from `@e2edev/e2e/backend` and contributes the
+ * `device` fixture the way the browser backend contributes `web`.
+ */
+import { type BackendHandle } from '@e2edev/e2e/backend';
+import { AgentDeviceSurface, type AgentDeviceOptions } from './surface.ts';
+/** Assembles the manifest for one surface. Exported for tests that script the client. */
+export declare function buildBackend(surface: AgentDeviceSurface): BackendHandle;
+/** Creates one agent-device backend: one device session per worker, one fresh app launch per attempt. */
+export declare function agentDevice(options: AgentDeviceOptions): BackendHandle;
+/** The surface behind a handle this package created; undefined for any other backend. */
+export declare function surfaceOf(backend: BackendHandle): AgentDeviceSurface | undefined;
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAI/F,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAgCvE;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAGtE;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAEhF"}

package/dist/backend.js

@@ -0,0 +1,66 @@
+/**
+ * The agent-device backend for e2e (RFC0002): a mobile body built with the
+ * public `defineBackend`, validated by the same rules and graded by the same
+ * capabilities as any other backend. Core imports nothing from here; this
+ * package imports the contract from `@e2edev/e2e/backend` and contributes the
+ * `device` fixture the way the browser backend contributes `web`.
+ */
+import { createRequire } from 'node:module';
+import { createAgentDeviceClient } from 'agent-device';
+import { defineBackend } from '@e2edev/e2e/backend';
+import { createDeviceFixture } from './device.js';
+import { AgentDeviceSurface } from './surface.js';
+const surfaces = new WeakMap();
+/** Assembles the manifest for one surface. Exported for tests that script the client. */
+export function buildBackend(surface) {
+    const handle = defineBackend({
+        name: 'agent-device',
+        version: ownVersion(),
+        spiVersion: 1,
+        init: (info) => surface.init(info),
+        startAttempt: (context) => surface.startAttempt(context),
+        endAttempt: (context) => surface.endAttempt(context),
+        dispose: (context) => surface.dispose(context),
+        observe: (operation, options) => surface.observe(operation, options),
+        locate: (expression, operation) => surface.locate(expression, operation),
+        perform: (ref, action, operation) => surface.perform(ref, action, operation),
+        swipe: (direction, momentum, operation) => surface.swipe(direction, momentum, operation),
+        app: {
+            back: (operation) => surface.back(operation),
+            ...(surface.managesApp
+                ? {
+                    restart: (operation) => surface.restart(operation),
+                    clearState: (operation) => surface.clearState(operation),
+                }
+                : {}),
+        },
+        artifacts: {
+            screenshot: (label, operation) => surface.screenshot(label, operation),
+        },
+        url: (operation) => surface.url(operation),
+        fixtures: {
+            device: (context) => createDeviceFixture(surface, context),
+        },
+    });
+    surfaces.set(handle, surface);
+    return handle;
+}
+/** Creates one agent-device backend: one device session per worker, one fresh app launch per attempt. */
+export function agentDevice(options) {
+    const factory = (session) => createAgentDeviceClient({ session });
+    return buildBackend(new AgentDeviceSurface(options, factory));
+}
+/** The surface behind a handle this package created; undefined for any other backend. */
+export function surfaceOf(backend) {
+    return surfaces.get(backend);
+}
+/** This package's published version, read through require resolution. */
+function ownVersion() {
+    try {
+        return createRequire(import.meta.url)('../package.json').version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAA+C,MAAM,cAAc,CAAC;AAE/F,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAqC,CAAC;AAElE,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,OAA2B;IACtD,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,UAAU,EAAE;QACrB,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;QACxD,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QACpD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAC9C,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;QACpE,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;QACxE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC;QAC5E,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;QACxF,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YAC5C,GAAG,CAAC,OAAO,CAAC,UAAU;gBACpB,CAAC,CAAC;oBACE,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;oBAClD,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;iBACzD;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;QACD,SAAS,EAAE;YACT,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC;SACvE;QACD,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAC1C,QAAQ,EAAE;YACR,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC;SAC3D;KACF,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,OAAO,GAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,OAAO,YAAY,CAAC,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,yEAAyE;AACzE,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAQ,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;IAC5F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/device.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The `device` fixture: deterministic device management this backend
+ * contributes. Not an agent tool; a test calls these directly to arrange or
+ * assert device state, and the harness records each call as a
+ * `device.<method>` step bounded by the action timeout.
+ */
+import type { BackendFixtureContext, Locator } from '@e2edev/e2e/backend';
+import type { AgentDeviceSurface } from './surface.ts';
+/** Permissions agent-device can grant, deny, or reset on an open app. */
+export type DevicePermission = 'camera' | 'microphone' | 'photos' | 'contacts' | 'notifications' | 'calendar' | 'location' | 'reminders' | 'motion' | 'siri' | 'media-library';
+export type DeviceOrientation = 'portrait' | 'portrait-upside-down' | 'landscape-left' | 'landscape-right';
+export type BiometricSensor = 'faceid' | 'touchid' | 'fingerprint';
+export interface ForegroundApp {
+    readonly name: string;
+    readonly bundleId?: string;
+}
+/** Deterministic device management exposed to tests as `device`. */
+export interface Device {
+    /**
+     * A locator from an agent-device selector (`'id=SW_VERSION_SPECIFIER'`,
+     * `'role=StaticText label="26.2"'`), for nodes the closed `screen` query
+     * vocabulary cannot name. Same polling and strictness as any locator.
+     */
+    locator(selector: string): Locator;
+    /** Toggles the device's Wi-Fi. */
+    setNetwork(state: 'online' | 'offline'): Promise<void>;
+    /** Toggles airplane mode. */
+    setAirplaneMode(enabled: boolean): Promise<void>;
+    /** Grants, denies, or resets one permission for the open app. */
+    setPermission(permission: DevicePermission, state: 'grant' | 'deny' | 'reset'): Promise<void>;
+    /** Sets the simulated location. */
+    setLocation(coordinates: {
+        latitude: number;
+        longitude: number;
+    }): Promise<void>;
+    /** Turns simulated location off. */
+    clearLocation(): Promise<void>;
+    /** Sets the system appearance. */
+    setAppearance(mode: 'light' | 'dark'): Promise<void>;
+    /** Rotates the device. */
+    setOrientation(orientation: DeviceOrientation): Promise<void>;
+    /** Simulates one biometric attempt on the open app. */
+    setBiometrics(sensor: BiometricSensor, result: 'match' | 'nonmatch'): Promise<void>;
+    /** Enrolls or unenrolls the simulator's Face ID or Touch ID. */
+    enrollBiometrics(sensor: 'faceid' | 'touchid', enrolled: boolean): Promise<void>;
+    /** Brings an app to the foreground; `relaunch` restarts it fresh. */
+    openApp(app: string, options?: {
+        relaunch?: boolean;
+    }): Promise<void>;
+    /** Closes the session's current app. */
+    closeApp(): Promise<void>;
+    /** The app currently in the foreground of the session. */
+    foregroundApp(): Promise<ForegroundApp>;
+    /** Sends the device to its home screen. */
+    home(): Promise<void>;
+    /** Navigates back once (in-app back). */
+    back(): Promise<void>;
+    /** Accepts or dismisses the visible system alert. */
+    alert(action: 'accept' | 'dismiss'): Promise<void>;
+    /** Dismisses the soft keyboard. */
+    dismissKeyboard(): Promise<void>;
+    /** Reads the clipboard. */
+    clipboard(): Promise<string>;
+    /** Writes the clipboard. */
+    setClipboard(text: string): Promise<void>;
+}
+/** Builds the device fixture for one attempt. */
+export declare function createDeviceFixture(surface: AgentDeviceSurface, context: BackendFixtureContext): Device;
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"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"}

package/dist/device.js

@@ -0,0 +1,77 @@
+/**
+ * The `device` fixture: deterministic device management this backend
+ * contributes. Not an agent tool; a test calls these directly to arrange or
+ * assert device state, and the harness records each call as a
+ * `device.<method>` step bounded by the action timeout.
+ */
+/** Builds the device fixture for one attempt. */
+export function createDeviceFixture(surface, context) {
+    const signal = context.signal;
+    return {
+        locator: (selector) => context.locator({ kind: 'selector', selector }),
+        async setNetwork(state) {
+            await surface.command('device.setNetwork', (client) => client.settings.update({ setting: 'wifi', state: state === 'offline' ? 'off' : 'on' }), signal);
+        },
+        async setAirplaneMode(enabled) {
+            await surface.command('device.setAirplaneMode', (client) => client.settings.update({ setting: 'airplane', state: enabled ? 'on' : 'off' }), signal);
+        },
+        async setPermission(permission, state) {
+            await surface.command('device.setPermission', (client) => client.settings.update({ setting: 'permission', permission, state }), signal);
+        },
+        async setLocation({ latitude, longitude }) {
+            await surface.command('device.setLocation', (client) => client.settings.update({ setting: 'location', state: 'set', latitude, longitude }), signal);
+        },
+        async clearLocation() {
+            await surface.command('device.clearLocation', (client) => client.settings.update({ setting: 'location', state: 'off' }), signal);
+        },
+        async setAppearance(mode) {
+            await surface.command('device.setAppearance', (client) => client.settings.update({ setting: 'appearance', state: mode }), signal);
+        },
+        async setOrientation(orientation) {
+            await surface.command('device.setOrientation', (client) => client.command.orientation({ orientation }), signal);
+        },
+        async setBiometrics(sensor, result) {
+            await surface.command('device.setBiometrics', (client) => sensor === 'fingerprint'
+                ? client.settings.update({ setting: 'fingerprint', state: result })
+                : client.settings.update({ setting: sensor, state: result }), signal);
+        },
+        async enrollBiometrics(sensor, enrolled) {
+            await surface.command('device.enrollBiometrics', (client) => client.settings.update({ setting: sensor, state: enrolled ? 'enroll' : 'unenroll' }), signal);
+        },
+        async openApp(app, options) {
+            await surface.openApp(app, options?.relaunch === true, signal);
+        },
+        async closeApp() {
+            await surface.command('device.closeApp', (client) => client.apps.close({}), signal);
+        },
+        async foregroundApp() {
+            const state = await surface.command('device.foregroundApp', (client) => client.command.appState({}), signal);
+            if ('package' in state)
+                return { name: state.package, bundleId: state.package };
+            return {
+                name: state.appName,
+                ...(state.appBundleId === undefined ? {} : { bundleId: state.appBundleId }),
+            };
+        },
+        async home() {
+            await surface.command('device.home', (client) => client.command.home({}), signal);
+        },
+        async back() {
+            await surface.command('device.back', (client) => client.command.back({ settle: true }), signal);
+        },
+        async alert(action) {
+            await surface.command('device.alert', (client) => client.command.alert({ action }), signal);
+        },
+        async dismissKeyboard() {
+            await surface.command('device.dismissKeyboard', (client) => client.command.keyboard({ action: 'dismiss' }), signal);
+        },
+        async clipboard() {
+            const result = await surface.command('device.clipboard', (client) => client.command.clipboard({ action: 'read' }), signal);
+            return result.action === 'read' ? result.text : '';
+        },
+        async setClipboard(text) {
+            await surface.command('device.setClipboard', (client) => client.command.clipboard({ action: 'write', text }), signal);
+        },
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Translation of agent-device failures onto the backend error contract.
+ *
+ * | agent-device failure                                        | Code                         |
+ * | ----------------------------------------------------------- | ---------------------------- |
+ * | already a BackendError / runner error                       | passed through untouched     |
+ * | AbortError                                                  | CANCELLED                    |
+ * | no active session / session not found                       | INVALID_STATE                |
+ * | UNSUPPORTED_OPERATION, NOT_IMPLEMENTED, UNSUPPORTED_PLATFORM | UNSUPPORTED_CAPABILITY      |
+ * | "not supported on this device" under any code                | UNSUPPORTED_CAPABILITY       |
+ * | a ref the daemon no longer knows (action paths only)        | NODE_STALE (retryable)       |
+ * | timed out                                                   | OPERATION_TIMEOUT            |
+ * | anything else                                               | BACKEND_FAILURE              |
+ */
+/** A failure's message in agent-device's normalized form. */
+export declare function message(cause: unknown): string;
+/** Translates an unexpected agent-device error at the contract boundary. */
+export declare function translateError(cause: unknown, operation: string): Error;
+/**
+ * Like translateError, but a ref the daemon no longer binds becomes retryable
+ * `NODE_STALE`: nothing was dispatched, so the harness may re-observe and
+ * re-resolve the node instead of failing the action.
+ */
+export declare function staleOr(cause: unknown, operation: string): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,6DAA6D;AAC7D,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9C;AASD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAcvE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAOhE"}

package/dist/errors.js

@@ -0,0 +1,72 @@
+/**
+ * Translation of agent-device failures onto the backend error contract.
+ *
+ * | agent-device failure                                        | Code                         |
+ * | ----------------------------------------------------------- | ---------------------------- |
+ * | already a BackendError / runner error                       | passed through untouched     |
+ * | AbortError                                                  | CANCELLED                    |
+ * | no active session / session not found                       | INVALID_STATE                |
+ * | UNSUPPORTED_OPERATION, NOT_IMPLEMENTED, UNSUPPORTED_PLATFORM | UNSUPPORTED_CAPABILITY      |
+ * | "not supported on this device" under any code                | UNSUPPORTED_CAPABILITY       |
+ * | a ref the daemon no longer knows (action paths only)        | NODE_STALE (retryable)       |
+ * | timed out                                                   | OPERATION_TIMEOUT            |
+ * | anything else                                               | BACKEND_FAILURE              |
+ */
+import { normalizeAgentDeviceError } from 'agent-device';
+import { BackendError, ConfigurationError, InfrastructureError, TestError } from '@e2edev/e2e/backend';
+import { cancelled } from './support.js';
+/**
+ * True for an error that already carries its classification: a `BackendError`
+ * from any module copy, or a runner error. Those cross the boundary untouched;
+ * re-wrapping one would turn a `POLICY_DENIED` into an infrastructure failure.
+ */
+function isClassified(cause) {
+    if (cause instanceof BackendError || cause instanceof TestError)
+        return true;
+    if (cause instanceof ConfigurationError || cause instanceof InfrastructureError)
+        return true;
+    return cause instanceof Error && cause.name === 'BackendError';
+}
+/** A failure's message in agent-device's normalized form. */
+export function message(cause) {
+    return normalizeAgentDeviceError(cause).message;
+}
+const NO_SESSION_PATTERN = /no active (?:app )?session|session\b.*\bnot found|open an app first|no app (?:is )?open/i;
+const UNSUPPORTED_CODES = new Set(['UNSUPPORTED_OPERATION', 'NOT_IMPLEMENTED', 'UNSUPPORTED_PLATFORM']);
+const UNSUPPORTED_PATTERN = /\b(?:is )?not supported\b|\bunsupported\b/i;
+const TIMEOUT_PATTERN = /\btimed?\s?out\b/i;
+const STALE_PATTERN = /\bref\b.*\b(?:not found|unknown|stale|no longer|expired|invalid|missing)|\b(?:not found|unknown|stale|no longer|expired|invalid|missing)\b.*\bref\b|refs?generation/i;
+/** Translates an unexpected agent-device error at the contract boundary. */
+export function translateError(cause, operation) {
+    if (isClassified(cause))
+        return cause;
+    if (cause instanceof Error && cause.name === 'AbortError')
+        return cancelled(`${operation} cancelled`);
+    const normalized = normalizeAgentDeviceError(cause);
+    const text = `${operation} failed: ${normalized.message}`;
+    const options = { retryable: false, cause };
+    if (normalized.code === 'SESSION_NOT_FOUND' || NO_SESSION_PATTERN.test(normalized.message)) {
+        return new BackendError('INVALID_STATE', text, options);
+    }
+    if (UNSUPPORTED_CODES.has(normalized.code) || UNSUPPORTED_PATTERN.test(normalized.message)) {
+        return new BackendError('UNSUPPORTED_CAPABILITY', text, options);
+    }
+    if (TIMEOUT_PATTERN.test(normalized.message))
+        return new BackendError('OPERATION_TIMEOUT', text, options);
+    return new BackendError('BACKEND_FAILURE', text, options);
+}
+/**
+ * Like translateError, but a ref the daemon no longer binds becomes retryable
+ * `NODE_STALE`: nothing was dispatched, so the harness may re-observe and
+ * re-resolve the node instead of failing the action.
+ */
+export function staleOr(cause, operation) {
+    if (isClassified(cause))
+        return cause;
+    const normalized = normalizeAgentDeviceError(cause);
+    if (STALE_PATTERN.test(normalized.message)) {
+        return new BackendError('NODE_STALE', `${operation}: ${normalized.message}`, { retryable: true, cause });
+    }
+    return translateError(cause, operation);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@e2edev/agent-device` public surface: the `agentDevice()` backend factory,
+ * the `device` fixture types, and a `test` typed with that fixture. `expect`
+ * and `credentials` still come from `e2e`; the agent-side tool pack lives on
+ * the `@e2edev/agent-device/tools` subpath so this entry never loads the AI SDK.
+ */
+import type { Device } from './device.ts';
+export { agentDevice } from './backend.ts';
+export type { AgentDeviceOptions, AgentDevicePlatform } from './surface.ts';
+export type { BiometricSensor, Device, DeviceOrientation, DevicePermission, ForegroundApp } from './device.ts';
+/**
+ * `test` typed with this backend's contributed `device` fixture. The same
+ * runtime `test` as `e2e`'s; only the fixture types differ.
+ */
+export declare const test: import("@e2edev/e2e").TestAPI<import("@e2edev/e2e").TestFixtures & {
+    device: Device;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/G;;;GAGG;AACH,eAAO,MAAM,IAAI;YAAyB,MAAM;EAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@e2edev/agent-device` public surface: the `agentDevice()` backend factory,
+ * the `device` fixture types, and a `test` typed with that fixture. `expect`
+ * and `credentials` still come from `e2e`; the agent-side tool pack lives on
+ * the `@e2edev/agent-device/tools` subpath so this entry never loads the AI SDK.
+ */
+import { test as base } from '@e2edev/e2e';
+export { agentDevice } from './backend.js';
+/**
+ * `test` typed with this backend's contributed `device` fixture. The same
+ * runtime `test` as `e2e`'s; only the fixture types differ.
+ */
+export const test = base.extend();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAsB,CAAC"}

package/dist/locate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LocatorExpression evaluation over one projected snapshot: the location
+ * capability's query language answered against the accessibility tree the
+ * device just reported. One immediate pass, every match in document order;
+ * polling, strictness, and staleness stay with the runner.
+ */
+import { type LocatorExpression } from '@e2edev/e2e/backend';
+import { type ProjectedNode } from './nodes.ts';
+export interface LocateOptions {
+    readonly testIdAttribute: string;
+}
+/** Resolves one expression to the nodes it currently matches. */
+export declare function resolveExpression(expression: LocatorExpression, index: readonly ProjectedNode[], options: LocateOptions): ProjectedNode[];
+//# sourceMappingURL=locate.d.ts.map

package/dist/locate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../src/locate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,iBAAiB,EAAsB,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,EAAE,aAAa,GACrB,aAAa,EAAE,CAgCjB"}