@appclaw/agent 2.0.0

package/README.md

@@ -0,0 +1,19 @@
+# appclaw-agent
+
+Agent-native command line interface for AppClaw. It exposes deterministic
+terminal commands so Claude Code, Gemini CLI, Codex CLI, and other agents can
+inspect and operate an Appium-backed mobile session.
+
+```bash
+npm install -g appclaw-agent
+appclaw-agent help workflow
+
+appclaw-agent --session demo open com.example.app --platform android
+appclaw-agent --session demo snapshot -i --json
+appclaw-agent --session demo press @e1 --json
+appclaw-agent --session demo close
+```
+
+The first device command starts a user-local daemon. The daemon owns named
+device sessions so separate agent terminal invocations can continue operating
+on the same screen.

package/bin/appclaw-agent.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from '../dist/cli.js';
+
+process.exitCode = await run(process.argv.slice(2));

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function run(argv: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,55 @@
+import { sendCommand } from './client.js';
+import { helpText, VERSION, workflowText } from './help.js';
+import { parseInvocation } from './parser.js';
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    cyan: '\x1b[36m',
+    yellow: '\x1b[33m',
+    magenta: '\x1b[35m',
+};
+function colorOutput(session, ok, message, output) {
+    const icon = ok ? `${c.green}✔${c.reset}` : `${c.red}✘${c.reset}`;
+    const tag = session ? ` ${c.cyan}[${session}]${c.reset}` : '';
+    if (output)
+        process.stdout.write(`${c.dim}${output}${c.reset}\n`);
+    process.stdout.write(`${icon}${tag} ${message}\n`);
+}
+export async function run(argv) {
+    try {
+        const parsed = parseInvocation(argv);
+        if (parsed.local === 'version') {
+            console.log(VERSION);
+            return 0;
+        }
+        if (parsed.local === 'help') {
+            console.log(argv.includes('workflow') ? workflowText() : helpText());
+            return 0;
+        }
+        const response = await sendCommand(parsed.session, parsed.command);
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify(response)}\n`);
+        }
+        else {
+            colorOutput(response.session, response.ok, response.message, response.output);
+        }
+        return response.ok ? 0 : 1;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (argv.includes('--json')) {
+            process.stdout.write(`${JSON.stringify({ ok: false, message })}\n`);
+        }
+        else {
+            process.stderr.write(`${c.red}✘${c.reset} ${c.bold}Error:${c.reset} ${message}\n`);
+        }
+        return 1;
+    }
+}
+if (process.argv[1]?.endsWith('cli.js')) {
+    process.exitCode = await run(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+import type { Command, CommandResponse } from './types.js';
+export declare function sendCommand(session: string, command: Command): Promise<CommandResponse>;

package/dist/client.js

@@ -0,0 +1,95 @@
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { connect } from 'node:net';
+import { fileURLToPath } from 'node:url';
+import { LOCK_PATH, METADATA_PATH, SOCKET_PATH, STATE_DIR } from './paths.js';
+export async function sendCommand(session, command) {
+    const metadata = await ensureDaemon();
+    return request(metadata, { token: metadata.token, session, command });
+}
+async function ensureDaemon(retryStaleLock = true) {
+    const current = await readDaemonMetadata();
+    if (current && (await canConnect(current)))
+        return current;
+    await mkdir(STATE_DIR, { recursive: true, mode: 0o700 });
+    const ownsStartup = await acquireStartupLock();
+    if (ownsStartup) {
+        await Promise.allSettled([
+            rm(METADATA_PATH, { force: true }),
+            rm(SOCKET_PATH, { force: true }),
+        ]);
+        const entry = fileURLToPath(new URL('./daemon-entry.js', import.meta.url));
+        const child = spawn(process.execPath, [entry], {
+            detached: true,
+            stdio: 'ignore',
+            env: process.env,
+        });
+        child.unref();
+    }
+    const deadline = Date.now() + 5000;
+    while (Date.now() < deadline) {
+        const started = await readDaemonMetadata();
+        if (started && (await canConnect(started))) {
+            if (ownsStartup)
+                await rm(LOCK_PATH, { force: true });
+            return started;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    await rm(LOCK_PATH, { force: true });
+    if (!ownsStartup && retryStaleLock) {
+        return ensureDaemon(false);
+    }
+    throw new Error('Timed out starting the appclaw-agent daemon');
+}
+async function acquireStartupLock() {
+    try {
+        await writeFile(LOCK_PATH, `${process.pid}\n`, { flag: 'wx', mode: 0o600 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readDaemonMetadata() {
+    try {
+        return JSON.parse(await readFile(METADATA_PATH, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function canConnect(metadata) {
+    try {
+        const response = await request(metadata, {
+            token: metadata.token,
+            session: 'default',
+            command: { kind: 'list' },
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function request(metadata, message) {
+    return new Promise((resolve, reject) => {
+        const socket = connect(metadata.socketPath);
+        let body = '';
+        socket.setEncoding('utf8');
+        socket.once('error', reject);
+        socket.on('data', (chunk) => {
+            body += chunk;
+        });
+        socket.once('connect', () => socket.write(`${JSON.stringify(message)}\n`));
+        socket.once('end', () => {
+            try {
+                resolve(JSON.parse(body.trim()));
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/daemon-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/daemon-entry.js

@@ -0,0 +1,4 @@
+import { AgentDaemon } from './daemon.js';
+const daemon = new AgentDaemon();
+await daemon.start();
+//# sourceMappingURL=daemon-entry.js.map

package/dist/daemon-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-entry.js","sourceRoot":"","sources":["../src/daemon-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;AACjC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC"}

package/dist/daemon.d.ts

@@ -0,0 +1,11 @@
+export declare class AgentDaemon {
+    private readonly token;
+    private readonly state;
+    private server;
+    private idleTimer;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private accept;
+    private respond;
+    private refreshIdleTimer;
+}

package/dist/daemon.js

@@ -0,0 +1,85 @@
+import { randomBytes } from 'node:crypto';
+import { chmod, mkdir, rm, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { AgentDaemonState } from './server.js';
+import { LOCK_PATH, METADATA_PATH, SOCKET_PATH, STATE_DIR } from './paths.js';
+const IDLE_TIMEOUT_MS = Number(process.env.APPCLAW_AGENT_IDLE_TIMEOUT_MS ?? 30000);
+export class AgentDaemon {
+    token = randomBytes(32).toString('hex');
+    state = new AgentDaemonState();
+    server = null;
+    idleTimer = null;
+    async start() {
+        await mkdir(STATE_DIR, { recursive: true, mode: 0o700 });
+        await rm(SOCKET_PATH, { force: true });
+        const server = createServer((socket) => this.accept(socket));
+        this.server = server;
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(SOCKET_PATH, resolve);
+        });
+        await chmod(SOCKET_PATH, 0o600);
+        const metadata = {
+            pid: process.pid,
+            socketPath: SOCKET_PATH,
+            token: this.token,
+        };
+        await writeFile(METADATA_PATH, JSON.stringify(metadata), { mode: 0o600 });
+        process.once('SIGTERM', () => void this.stop());
+        process.once('SIGINT', () => void this.stop());
+        this.refreshIdleTimer();
+    }
+    async stop() {
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        await this.state.closeAll();
+        if (this.server) {
+            await new Promise((resolve) => this.server.close(() => resolve()));
+        }
+        await Promise.allSettled([
+            rm(SOCKET_PATH, { force: true }),
+            rm(METADATA_PATH, { force: true }),
+            rm(LOCK_PATH, { force: true }),
+        ]);
+        process.exitCode = 0;
+    }
+    accept(socket) {
+        let input = '';
+        socket.setEncoding('utf8');
+        socket.on('data', (chunk) => {
+            input += chunk;
+            const newline = input.indexOf('\n');
+            if (newline < 0)
+                return;
+            const raw = input.slice(0, newline);
+            void this.respond(socket, raw);
+        });
+    }
+    async respond(socket, raw) {
+        try {
+            const request = JSON.parse(raw);
+            if (request.token !== this.token) {
+                socket.end(`${JSON.stringify({ ok: false, message: 'Unauthorized daemon request' })}\n`);
+                return;
+            }
+            const response = await this.state.execute(request.session, request.command);
+            socket.end(`${JSON.stringify(response)}\n`);
+            this.refreshIdleTimer();
+        }
+        catch (error) {
+            socket.end(`${JSON.stringify({
+                ok: false,
+                message: error instanceof Error ? error.message : String(error),
+            })}\n`);
+        }
+    }
+    refreshIdleTimer() {
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        if (this.state.sessionCount > 0)
+            return;
+        this.idleTimer = setTimeout(() => void this.stop(), IDLE_TIMEOUT_MS);
+        this.idleTimer.unref();
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,3 @@
+export declare const VERSION = "0.1.0";
+export declare function helpText(): string;
+export declare function workflowText(): string;

package/dist/help.js

@@ -0,0 +1,62 @@
+export const VERSION = '0.1.0';
+export function helpText() {
+    return `appclaw-agent - terminal mobile automation for coding agents
+
+Usage:
+  appclaw-agent --session <name> <command> [options]
+
+Run \`appclaw-agent help workflow\` for the recommended agent workflow.`;
+}
+export function workflowText() {
+    return `Recommended AppClaw agent workflow:
+
+1. Open a named session:
+   appclaw-agent --session <name> open <app-id> --platform android|ios
+
+2. Inspect actionable UI:
+   appclaw-agent --session <name> snapshot -i --json
+
+3. Use returned refs or stable selectors:
+   appclaw-agent --session <name> press @e1 --json
+   appclaw-agent --session <name> fill @e2 "text" --json
+   appclaw-agent --session <name> press 'id="login_button"' --json
+
+4. Scroll the screen or a specific container:
+   appclaw-agent --session <name> scroll down --json        (scroll down — see content below)
+   appclaw-agent --session <name> scroll up --json          (scroll up — see content above)
+   appclaw-agent --session <name> scroll @e24 down --json   (scroll within a specific element)
+
+   Always use "scroll", not "swipe" — they are aliases but "scroll down/up" is unambiguous.
+   Never use "swipe @eN direction" — element-scoped swipe is not implemented.
+
+   Re-run snapshot after every state-changing action; refs are invalidated.
+
+   NOTE: snapshot reports DOM elements — it does not confirm visual on-screen
+   presence. To verify what is actually rendered, take a screenshot instead:
+   appclaw-agent --session <name> screenshot /tmp/screen.png
+
+5. Press hardware keys:
+   appclaw-agent --session <name> enter --json
+   appclaw-agent --session <name> back --json
+   appclaw-agent --session <name> home --json
+
+6. Verify visual state:
+   IMPORTANT: Always verify assertions visually via screenshot. DOM checks only confirm
+   an element exists in the hierarchy — not that it is visible on screen. An element can
+   be in the DOM but scrolled off-screen or clipped. Screenshot is the only reliable check.
+
+   - Visual/rendered check (PREFERRED — actually on screen):
+     appclaw-agent --session <name> screenshot /tmp/screen.png
+     (then read the image file to analyze visually — base pass/fail on what you see)
+   - DOM check (element exists in hierarchy, NOT a visibility guarantee):
+     appclaw-agent --session <name> is visible 'text="Sign in"' --json
+   - Vision check (requires AppClaw vision API key configured):
+     appclaw-agent --session <name> is visible --vision "search icon" --json
+     appclaw-agent --session <name> get info --vision "displayed total" --json
+     When vision is NOT configured, these commands automatically capture a screenshot
+     and return its path in screenshotPath — read that file to answer visually.
+
+7. Close the session:
+   appclaw-agent --session <name> close`;
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,UAAU,QAAQ;IACtB,OAAO;;;;;wEAK+D,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAiD+B,CAAC;AACzC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedInvocation, TargetInput } from './types.js';
+export declare function parseInvocation(argv: string[]): ParsedInvocation;
+export declare function parseTarget(value: string): TargetInput;

package/dist/parser.js

@@ -0,0 +1,202 @@
+import { resolve } from 'node:path';
+export function parseInvocation(argv) {
+    const args = [...argv];
+    let session = 'default';
+    let json = false;
+    for (let i = 0; i < args.length;) {
+        if (args[i] === '--session') {
+            session = required(args[i + 1], '--session requires a name');
+            args.splice(i, 2);
+        }
+        else if (args[i] === '--json') {
+            json = true;
+            args.splice(i, 1);
+        }
+        else {
+            i++;
+        }
+    }
+    if (args.length === 0 || args[0] === '--help' || args[0] === 'help') {
+        return { session, json, local: 'help' };
+    }
+    if (args[0] === '--version' || args[0] === 'version') {
+        return { session, json, local: 'version' };
+    }
+    const name = args.shift();
+    if (name === 'session' && args[0] === 'list')
+        return { session, json, command: { kind: 'list' } };
+    if (name === 'open') {
+        const app = required(args.shift(), 'open requires an app id');
+        const platform = option(args, '--platform');
+        if (platform !== 'android' && platform !== 'ios') {
+            throw new Error('open requires --platform android|ios');
+        }
+        const rawDeviceType = option(args, '--device-type');
+        if (rawDeviceType && rawDeviceType !== 'simulator' && rawDeviceType !== 'real') {
+            throw new Error('--device-type must be simulator or real');
+        }
+        return {
+            session,
+            json,
+            command: {
+                kind: 'open',
+                options: {
+                    app,
+                    platform,
+                    ...(rawDeviceType && { deviceType: rawDeviceType }),
+                    ...(option(args, '--device') && { device: option(args, '--device') }),
+                    ...(option(args, '--udid') && { udid: option(args, '--udid') }),
+                },
+            },
+        };
+    }
+    if (name === 'snapshot') {
+        if (args.includes('--vision')) {
+            throw new Error('--vision is not supported on snapshot. Use "is visible --vision" or "get info --vision" for visual checks, or "screenshot <path>" to capture and analyze the screen.');
+        }
+        return { session, json, command: { kind: 'snapshot', interactiveOnly: args.includes('-i') } };
+    }
+    if (name === 'press') {
+        const vision = option(args, '--vision');
+        return {
+            session,
+            json,
+            command: vision
+                ? { kind: 'press', target: { text: vision }, vision }
+                : { kind: 'press', target: parseTarget(required(args[0], 'press requires a target')) },
+        };
+    }
+    if (name === 'fill') {
+        return {
+            session,
+            json,
+            command: {
+                kind: 'fill',
+                target: parseTarget(required(args[0], 'fill requires a target')),
+                text: required(args[1], 'fill requires text'),
+            },
+        };
+    }
+    if (name === 'longpress') {
+        const duration = args[1] ? Number(args[1]) : undefined;
+        if (duration !== undefined && !Number.isFinite(duration))
+            throw new Error('duration must be numeric');
+        return {
+            session,
+            json,
+            command: {
+                kind: 'longpress',
+                target: parseTarget(required(args[0], 'longpress requires a target')),
+                ...(duration !== undefined && { duration }),
+            },
+        };
+    }
+    if (name === 'swipe' || name === 'scroll') {
+        const DIRECTIONS = ['up', 'down', 'left', 'right'];
+        // swipe <target> <direction>  — element-scoped scroll
+        if (args.length >= 2 && DIRECTIONS.includes(args[1])) {
+            return {
+                session,
+                json,
+                command: {
+                    kind: 'swipe',
+                    target: parseTarget(args[0]),
+                    direction: args[1],
+                },
+            };
+        }
+        // swipe <direction>  — full-screen swipe
+        const direction = args[0];
+        if (!DIRECTIONS.includes(direction)) {
+            throw new Error(`${name} requires up|down|left|right, or <target> up|down|left|right`);
+        }
+        return { session, json, command: { kind: 'swipe', direction: direction } };
+    }
+    if (name === 'back' || name === 'home' || name === 'enter') {
+        return { session, json, command: { kind: 'key', key: name.toUpperCase() } };
+    }
+    if (name === 'get' && args[0] === 'info') {
+        const vision = option(args, '--vision');
+        if (!vision)
+            throw new Error('get info requires --vision "<description>"');
+        return { session, json, command: { kind: 'getInfo', vision } };
+    }
+    if (name === 'get' && (args[0] === 'text' || args[0] === 'attrs')) {
+        const target = parseTarget(required(args[1], `get ${args[0]} requires a target`));
+        return {
+            session,
+            json,
+            command: args[0] === 'text' ? { kind: 'getText', target } : { kind: 'getAttrs', target },
+        };
+    }
+    if (name === 'is' && args[0] === 'visible') {
+        const vision = option(args, '--vision');
+        if (vision)
+            return { session, json, command: { kind: 'isVisible', vision } };
+        const target = required(args[1], 'is visible requires a target or --vision');
+        return { session, json, command: visibleCommand(target) };
+    }
+    if (name === 'wait' && (args[0] === 'visible' || args[0] === 'gone')) {
+        const target = required(args[1], `wait ${args[0]} requires a target`);
+        const parsed = parseTargetOrText(target);
+        return {
+            session,
+            json,
+            command: { kind: 'wait', condition: args[0], ...parsed },
+        };
+    }
+    if (name === 'screenshot') {
+        return {
+            session,
+            json,
+            command: {
+                kind: 'screenshot',
+                path: resolve(required(args[0], 'screenshot requires a path')),
+            },
+        };
+    }
+    if (name === 'close')
+        return { session, json, command: { kind: 'close' } };
+    throw new Error(`Unknown command: ${name}. Run appclaw-agent help workflow.`);
+}
+export function parseTarget(value) {
+    if (/^@e\d+$/.test(value))
+        return { ref: value };
+    const selector = parseSelector(value);
+    if (selector)
+        return { selector };
+    const coords = /^(\d+),(\d+)$/.exec(value);
+    if (coords)
+        return { coordinates: [Number(coords[1]), Number(coords[2])] };
+    throw new Error(`Invalid target "${value}". Use @e1, id="...", accessibility="...", text="...", or x,y.`);
+}
+function parseTargetOrText(value) {
+    try {
+        return { target: parseTarget(value) };
+    }
+    catch {
+        return { text: value };
+    }
+}
+function visibleCommand(value) {
+    const parsed = parseTargetOrText(value);
+    return { kind: 'isVisible', ...parsed };
+}
+function parseSelector(value) {
+    const match = /^(id|accessibility|text)="([\s\S]*)"$/.exec(value);
+    if (!match)
+        return undefined;
+    return { kind: match[1], value: match[2] };
+}
+function option(args, name) {
+    const index = args.indexOf(name);
+    if (index < 0)
+        return undefined;
+    return required(args[index + 1], `${name} requires a value`);
+}
+function required(value, message) {
+    if (!value)
+        throw new Error(message);
+    return value;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,9 @@
+export declare const STATE_DIR: string;
+export declare const SOCKET_PATH: string;
+export declare const METADATA_PATH: string;
+export declare const LOCK_PATH: string;
+export interface DaemonMetadata {
+    pid: number;
+    socketPath: string;
+    token: string;
+}

package/dist/paths.js

@@ -0,0 +1,7 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const STATE_DIR = join(homedir(), '.appclaw', 'agent-cli');
+export const SOCKET_PATH = join(STATE_DIR, 'daemon.sock');
+export const METADATA_PATH = join(STATE_DIR, 'daemon.json');
+export const LOCK_PATH = join(STATE_DIR, 'daemon.lock');
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import type { Command, CommandResponse } from './types.js';
+export declare class AgentDaemonState {
+    private readonly sessions;
+    get sessionCount(): number;
+    execute(sessionName: string, command: Command): Promise<CommandResponse>;
+    closeAll(): Promise<void>;
+    private requireSession;
+}

package/dist/server.js

@@ -0,0 +1,168 @@
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { AgentRuntimeSession } from '@appclaw/core/agent-runtime';
+import { snapshotWithRefs } from './snapshot.js';
+export class AgentDaemonState {
+    sessions = new Map();
+    get sessionCount() {
+        return this.sessions.size;
+    }
+    async execute(sessionName, command) {
+        try {
+            if (command.kind === 'list') {
+                const sessions = [...this.sessions.keys()];
+                return {
+                    ok: true,
+                    message: sessions.length ? sessions.join('\n') : 'No active sessions',
+                    data: { sessions },
+                };
+            }
+            if (command.kind === 'open') {
+                const previous = this.sessions.get(sessionName);
+                if (previous) {
+                    await previous.runtime.close();
+                    this.sessions.delete(sessionName);
+                }
+                const runtime = await AgentRuntimeSession.open(command.options);
+                this.sessions.set(sessionName, { runtime, refs: null });
+                return {
+                    ok: true,
+                    session: sessionName,
+                    message: `Opened ${command.options.app} on ${command.options.platform}`,
+                    data: { sessionId: runtime.sessionId },
+                };
+            }
+            if (command.kind === 'close') {
+                const current = this.requireSession(sessionName);
+                await current.runtime.close();
+                this.sessions.delete(sessionName);
+                return { ok: true, session: sessionName, message: `Closed session ${sessionName}` };
+            }
+            const current = this.requireSession(sessionName);
+            if (command.kind === 'snapshot') {
+                const snapshot = await current.runtime.snapshot(command.interactiveOnly);
+                const formatted = snapshotWithRefs(snapshot);
+                current.refs = formatted.refs;
+                return {
+                    ok: true,
+                    session: sessionName,
+                    message: `Snapshot contains ${snapshot.elements.length} element(s)`,
+                    output: formatted.output,
+                    data: {
+                        platform: snapshot.platform,
+                        elements: snapshot.elements,
+                        refs: formatted.entries,
+                    },
+                };
+            }
+            let response;
+            switch (command.kind) {
+                case 'press':
+                    if (command.vision && !current.runtime.isVisionConfigured()) {
+                        return screenshotFallback(sessionName, current.runtime, command.vision, true);
+                    }
+                    response = result(sessionName, command.vision
+                        ? await current.runtime.visionPress(command.vision)
+                        : await current.runtime.press(resolveTarget(current, command.target)));
+                    break;
+                case 'fill':
+                    response = result(sessionName, await current.runtime.fill(resolveTarget(current, command.target), command.text));
+                    break;
+                case 'longpress':
+                    response = result(sessionName, await current.runtime.longpress(resolveTarget(current, command.target), command.duration));
+                    break;
+                case 'swipe':
+                    response = result(sessionName, command.target
+                        ? await current.runtime.swipeElement(resolveTarget(current, command.target), command.direction)
+                        : await current.runtime.swipe(command.direction));
+                    break;
+                case 'key':
+                    response = result(sessionName, await current.runtime.pressKey(command.key));
+                    break;
+                case 'getText':
+                    return result(sessionName, await current.runtime.getText(resolveTarget(current, command.target)));
+                case 'getAttrs':
+                    return result(sessionName, await current.runtime.getAttrs(resolveTarget(current, command.target)));
+                case 'getInfo':
+                    if (!current.runtime.isVisionConfigured()) {
+                        return screenshotFallback(sessionName, current.runtime, command.vision, false);
+                    }
+                    return result(sessionName, await current.runtime.visionInfo(command.vision));
+                case 'isVisible':
+                    if (command.vision && !current.runtime.isVisionConfigured()) {
+                        return screenshotFallback(sessionName, current.runtime, command.vision, false);
+                    }
+                    return result(sessionName, command.vision
+                        ? await current.runtime.visionVisible(command.vision)
+                        : await current.runtime.isVisible(command.target ? resolveTarget(current, command.target) : (command.text ?? '')));
+                case 'wait':
+                    return result(sessionName, await current.runtime.waitFor(command.condition, command.target ? resolveTarget(current, command.target) : (command.text ?? '')));
+                case 'screenshot':
+                    return result(sessionName, await current.runtime.saveScreenshot(command.path));
+                default:
+                    return { ok: false, session: sessionName, message: 'Unsupported command' };
+            }
+            if (response.ok)
+                current.refs = null;
+            return response;
+        }
+        catch (error) {
+            return {
+                ok: false,
+                session: sessionName,
+                message: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    async closeAll() {
+        const current = [...this.sessions.values()];
+        this.sessions.clear();
+        await Promise.allSettled(current.map(({ runtime }) => runtime.close()));
+    }
+    requireSession(name) {
+        const session = this.sessions.get(name);
+        if (!session) {
+            throw new Error(`No active session "${name}". Run appclaw-agent --session ${name} open first.`);
+        }
+        return session;
+    }
+}
+function resolveTarget(state, target) {
+    if ('ref' in target) {
+        if (!state.refs) {
+            throw new Error(`Reference ${target.ref} is stale. Run snapshot -i again before interacting.`);
+        }
+        const value = state.refs.get(target.ref);
+        if (!value)
+            throw new Error(`Unknown reference ${target.ref}. Run snapshot -i again.`);
+        return value;
+    }
+    if ('selector' in target)
+        return { selector: target.selector };
+    if ('coordinates' in target)
+        return { coordinates: target.coordinates };
+    throw new Error('Text targets are supported only by visibility and wait commands');
+}
+async function screenshotFallback(session, runtime, visualQuery, pressIntent) {
+    const screenshotPath = join(tmpdir(), `appclaw-visual-${Date.now()}.png`);
+    await runtime.saveScreenshot(screenshotPath);
+    const action = pressIntent
+        ? `Determine the coordinates of "${visualQuery}" from the screenshot, then use press <x,y> to tap it.`
+        : `Read this image file and visually determine if "${visualQuery}" is present on screen.`;
+    return {
+        ok: true,
+        session,
+        message: `Vision not configured — screenshot captured for visual analysis. ${action}`,
+        screenshotPath,
+        visualQuery,
+    };
+}
+function result(session, operation) {
+    return {
+        ok: operation.success,
+        session,
+        message: operation.message,
+        ...(operation.value !== undefined && { data: operation.value }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAoB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQjD,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE5D,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,OAAgB;QACjD,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3C,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB;oBACrE,IAAI,EAAE,EAAE,QAAQ,EAAE;iBACnB,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAChD,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC/B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAChE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,WAAW;oBACpB,OAAO,EAAE,UAAU,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;oBACvE,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;iBACvC,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;gBACjD,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,WAAW,EAAE,EAAE,CAAC;YACtF,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAEjD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;gBACzE,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC7C,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;gBAC9B,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,OAAO,EAAE,WAAW;oBACpB,OAAO,EAAE,qBAAqB,QAAQ,CAAC,QAAQ,CAAC,MAAM,aAAa;oBACnE,MAAM,EAAE,SAAS,CAAC,MAAM;oBACxB,IAAI,EAAE;wBACJ,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,IAAI,EAAE,SAAS,CAAC,OAAO;qBACxB;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,QAAyB,CAAC;YAC9B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,OAAO;oBACV,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;wBAC5D,OAAO,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBAChF,CAAC;oBACD,QAAQ,GAAG,MAAM,CACf,WAAW,EACX,OAAO,CAAC,MAAM;wBACZ,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;wBACnD,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CACxE,CAAC;oBACF,MAAM;gBACR,KAAK,MAAM;oBACT,QAAQ,GAAG,MAAM,CACf,WAAW,EACX,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CACjF,CAAC;oBACF,MAAM;gBACR,KAAK,WAAW;oBACd,QAAQ,GAAG,MAAM,CACf,WAAW,EACX,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAC7B,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,QAAQ,CACjB,CACF,CAAC;oBACF,MAAM;gBACR,KAAK,OAAO;oBACV,QAAQ,GAAG,MAAM,CACf,WAAW,EACX,OAAO,CAAC,MAAM;wBACZ,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAChC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,SAAS,CAClB;wBACH,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CACnD,CAAC;oBACF,MAAM;gBACR,KAAK,KAAK;oBACR,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC5E,MAAM;gBACR,KAAK,SAAS;oBACZ,OAAO,MAAM,CACX,WAAW,EACX,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CACtE,CAAC;gBACJ,KAAK,UAAU;oBACb,OAAO,MAAM,CACX,WAAW,EACX,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CACvE,CAAC;gBACJ,KAAK,SAAS;oBACZ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;wBAC1C,OAAO,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;oBACjF,CAAC;oBACD,OAAO,MAAM,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/E,KAAK,WAAW;oBACd,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;wBAC5D,OAAO,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;oBACjF,CAAC;oBACD,OAAO,MAAM,CACX,WAAW,EACX,OAAO,CAAC,MAAM;wBACZ,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;wBACrD,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAC7B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAC/E,CACN,CAAC;gBACJ,KAAK,MAAM;oBACT,OAAO,MAAM,CACX,WAAW,EACX,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAC3B,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAC/E,CACF,CAAC;gBACJ,KAAK,YAAY;oBACf,OAAO,MAAM,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjF;oBACE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;YAC/E,CAAC;YAED,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACrC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,kCAAkC,IAAI,cAAc,CAC/E,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,SAAS,aAAa,CAAC,KAAmB,EAAE,MAAmB;IAC7D,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,aAAa,MAAM,CAAC,GAAG,sDAAsD,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,GAAG,0BAA0B,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,IAAI,MAAM;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/D,IAAI,aAAa,IAAI,MAAM;QAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IACxE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;AACrF,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,OAAe,EACf,OAA4B,EAC5B,WAAmB,EACnB,WAAoB;IAEpB,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1E,MAAM,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,WAAW;QACxB,CAAC,CAAC,iCAAiC,WAAW,wDAAwD;QACtG,CAAC,CAAC,mDAAmD,WAAW,yBAAyB,CAAC;IAC5F,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO;QACP,OAAO,EAAE,oEAAoE,MAAM,EAAE;QACrF,cAAc;QACd,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CACb,OAAe,EACf,SAAiE;IAEjE,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,OAAO;QACrB,OAAO;QACP,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,7 @@
+import type { AgentSnapshot, AgentTarget } from '@appclaw/core/agent-runtime';
+import type { SnapshotRef } from './types.js';
+export declare function snapshotWithRefs(snapshot: AgentSnapshot): {
+    refs: Map<string, AgentTarget>;
+    entries: SnapshotRef[];
+    output: string;
+};

package/dist/snapshot.js

@@ -0,0 +1,26 @@
+export function snapshotWithRefs(snapshot) {
+    const refs = new Map();
+    const entries = [];
+    const lines = snapshot.elements.map((element, index) => {
+        const ref = `@e${index + 1}`;
+        const target = element.selector
+            ? { selector: element.selector }
+            : { coordinates: element.center };
+        refs.set(ref, target);
+        entries.push({ ref, target });
+        const label = element.text ? ` "${element.text}"` : '';
+        const id = element.id
+            ? ` id="${element.id}"`
+            : element.accessibilityId
+                ? ` accessibility="${element.accessibilityId}"`
+                : '';
+        const state = element.enabled ? '' : ' disabled';
+        return `${ref} [${element.type || element.action}]${label}${id}${state}`;
+    });
+    return {
+        refs,
+        entries,
+        output: lines.length ? lines.join('\n') : '(no matching elements on screen)',
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IAKtD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC5C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAgB,OAAO,CAAC,QAAQ;YAC1C,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;YAChC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE;YACnB,CAAC,CAAC,QAAQ,OAAO,CAAC,EAAE,GAAG;YACvB,CAAC,CAAC,OAAO,CAAC,eAAe;gBACvB,CAAC,CAAC,mBAAmB,OAAO,CAAC,eAAe,GAAG;gBAC/C,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;QACjD,OAAO,GAAG,GAAG,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,OAAO;QACP,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kCAAkC;KAC7E,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+import type { AgentOpenOptions, AgentSelector, AgentTarget } from '@appclaw/core/agent-runtime';
+export type Command = {
+    kind: 'open';
+    options: AgentOpenOptions;
+} | {
+    kind: 'snapshot';
+    interactiveOnly: boolean;
+} | {
+    kind: 'press';
+    target: TargetInput;
+    vision?: string;
+} | {
+    kind: 'fill';
+    target: TargetInput;
+    text: string;
+} | {
+    kind: 'longpress';
+    target: TargetInput;
+    duration?: number;
+} | {
+    kind: 'swipe';
+    direction: 'up' | 'down' | 'left' | 'right';
+    target?: TargetInput;
+} | {
+    kind: 'key';
+    key: 'BACK' | 'HOME' | 'ENTER';
+} | {
+    kind: 'getText';
+    target: TargetInput;
+} | {
+    kind: 'getAttrs';
+    target: TargetInput;
+} | {
+    kind: 'getInfo';
+    vision: string;
+} | {
+    kind: 'isVisible';
+    target?: TargetInput;
+    text?: string;
+    vision?: string;
+} | {
+    kind: 'wait';
+    condition: 'visible' | 'gone';
+    target?: TargetInput;
+    text?: string;
+} | {
+    kind: 'screenshot';
+    path: string;
+} | {
+    kind: 'list';
+} | {
+    kind: 'close';
+};
+export type TargetInput = {
+    ref: string;
+} | {
+    selector: AgentSelector;
+} | {
+    text: string;
+} | {
+    coordinates: [number, number];
+};
+export interface ParsedInvocation {
+    session: string;
+    json: boolean;
+    local?: 'help' | 'version';
+    command?: Command;
+}
+export interface DaemonRequest {
+    token: string;
+    session: string;
+    command: Command;
+}
+export interface CommandResponse {
+    ok: boolean;
+    session?: string;
+    message: string;
+    data?: unknown;
+    output?: string;
+    /** Set when vision was requested but not configured. Read this image file to answer the visualQuery visually. */
+    screenshotPath?: string;
+    visualQuery?: string;
+}
+export interface SnapshotRef {
+    ref: string;
+    target: AgentTarget;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@appclaw/agent",
+  "version": "2.0.0",
+  "description": "Agent-native terminal CLI for AppClaw mobile automation",
+  "type": "module",
+  "bin": {
+    "appclaw-agent": "bin/appclaw-agent.js"
+  },
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@appclaw/core": "2.0.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^22.0.0",
+    "conventional-changelog-conventionalcommits": "^9.3.1",
+    "semantic-release": "^24.2.9",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}