agent-device 0.4.2 → 0.5.0

package/src/__tests__/cli-close.test.ts

@@ -1,155 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { runCli } from '../cli.ts';
-import { AppError } from '../utils/errors.ts';
-import type { DaemonResponse } from '../daemon-client.ts';
-
-class ExitSignal extends Error {
-  public readonly code: number;
-
-  constructor(code: number) {
-    super(`EXIT_${code}`);
-    this.code = code;
-  }
-}
-
-type RunResult = {
-  code: number | null;
-  stdout: string;
-  stderr: string;
-  daemonCalls: number;
-};
-
-async function runCliCapture(argv: string[]): Promise<RunResult> {
-  let daemonCalls = 0;
-  let stdout = '';
-  let stderr = '';
-  let code: number | null = null;
-
-  const originalExit = process.exit;
-  const originalStdoutWrite = process.stdout.write.bind(process.stdout);
-  const originalStderrWrite = process.stderr.write.bind(process.stderr);
-
-  (process as any).exit = ((nextCode?: number) => {
-    throw new ExitSignal(nextCode ?? 0);
-  }) as typeof process.exit;
-  (process.stdout as any).write = ((chunk: unknown) => {
-    stdout += String(chunk);
-    return true;
-  }) as typeof process.stdout.write;
-  (process.stderr as any).write = ((chunk: unknown) => {
-    stderr += String(chunk);
-    return true;
-  }) as typeof process.stderr.write;
-
-  const sendToDaemon = async (): Promise<DaemonResponse> => {
-    daemonCalls += 1;
-    throw new AppError('COMMAND_FAILED', 'Failed to start daemon', {
-      infoPath: '/tmp/daemon.json',
-      hint: 'stale daemon info',
-    });
-  };
-
-  try {
-    await runCli(argv, { sendToDaemon });
-  } catch (error) {
-    if (error instanceof ExitSignal) code = error.code;
-    else throw error;
-  } finally {
-    process.exit = originalExit;
-    process.stdout.write = originalStdoutWrite;
-    process.stderr.write = originalStderrWrite;
-  }
-
-  return { code, stdout, stderr, daemonCalls };
-}
-
-async function runCliCaptureWithErrorDetails(
-  argv: string[],
-  details: Record<string, unknown>,
-  message = 'Failed to start daemon',
-): Promise<RunResult> {
-  let daemonCalls = 0;
-  let stdout = '';
-  let stderr = '';
-  let code: number | null = null;
-
-  const originalExit = process.exit;
-  const originalStdoutWrite = process.stdout.write.bind(process.stdout);
-  const originalStderrWrite = process.stderr.write.bind(process.stderr);
-
-  (process as any).exit = ((nextCode?: number) => {
-    throw new ExitSignal(nextCode ?? 0);
-  }) as typeof process.exit;
-  (process.stdout as any).write = ((chunk: unknown) => {
-    stdout += String(chunk);
-    return true;
-  }) as typeof process.stdout.write;
-  (process.stderr as any).write = ((chunk: unknown) => {
-    stderr += String(chunk);
-    return true;
-  }) as typeof process.stderr.write;
-
-  const sendToDaemon = async (): Promise<DaemonResponse> => {
-    daemonCalls += 1;
-    throw new AppError('COMMAND_FAILED', message, details);
-  };
-
-  try {
-    await runCli(argv, { sendToDaemon });
-  } catch (error) {
-    if (error instanceof ExitSignal) code = error.code;
-    else throw error;
-  } finally {
-    process.exit = originalExit;
-    process.stdout.write = originalStdoutWrite;
-    process.stderr.write = originalStderrWrite;
-  }
-
-  return { code, stdout, stderr, daemonCalls };
-}
-
-test('close treats daemon startup failure as no-op', async () => {
-  const result = await runCliCapture(['close']);
-  assert.equal(result.code, null);
-  assert.equal(result.daemonCalls, 1);
-  assert.equal(result.stdout, '');
-  assert.equal(result.stderr, '');
-});
-
-test('close --json treats daemon startup failure as no-op success', async () => {
-  const result = await runCliCapture(['close', '--json']);
-  assert.equal(result.code, null);
-  assert.equal(result.daemonCalls, 1);
-  const payload = JSON.parse(result.stdout);
-  assert.equal(payload.success, true);
-  assert.equal(payload.data.closed, 'session');
-  assert.equal(payload.data.source, 'no-daemon');
-  assert.equal(result.stderr, '');
-});
-
-test('close treats lock-only daemon startup failure as no-op', async () => {
-  const result = await runCliCaptureWithErrorDetails(['close'], {
-    lockPath: '/tmp/daemon.lock',
-    hint: 'stale daemon lock',
-  });
-  assert.equal(result.code, null);
-  assert.equal(result.daemonCalls, 1);
-  assert.equal(result.stdout, '');
-  assert.equal(result.stderr, '');
-});
-
-test('close treats structured daemon startup failure as no-op without relying on message text', async () => {
-  const result = await runCliCaptureWithErrorDetails(
-    ['close'],
-    {
-      kind: 'daemon_startup_failed',
-      lockPath: '/tmp/daemon.lock',
-    },
-    'daemon bootstrap failed',
-  );
-  assert.equal(result.code, null);
-  assert.equal(result.daemonCalls, 1);
-  assert.equal(result.stdout, '');
-  assert.equal(result.stderr, '');
-});

package/src/__tests__/cli-help.test.ts

@@ -1,102 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { runCli } from '../cli.ts';
-import type { DaemonResponse } from '../daemon-client.ts';
-
-class ExitSignal extends Error {
-  public readonly code: number;
-
-  constructor(code: number) {
-    super(`EXIT_${code}`);
-    this.code = code;
-  }
-}
-
-type RunResult = {
-  code: number | null;
-  stdout: string;
-  stderr: string;
-  daemonCalls: number;
-};
-
-async function runCliCapture(argv: string[]): Promise<RunResult> {
-  let daemonCalls = 0;
-  let stdout = '';
-  let stderr = '';
-  let code: number | null = null;
-
-  const originalExit = process.exit;
-  const originalStdoutWrite = process.stdout.write.bind(process.stdout);
-  const originalStderrWrite = process.stderr.write.bind(process.stderr);
-
-  (process as any).exit = ((nextCode?: number) => {
-    throw new ExitSignal(nextCode ?? 0);
-  }) as typeof process.exit;
-  (process.stdout as any).write = ((chunk: unknown) => {
-    stdout += String(chunk);
-    return true;
-  }) as typeof process.stdout.write;
-  (process.stderr as any).write = ((chunk: unknown) => {
-    stderr += String(chunk);
-    return true;
-  }) as typeof process.stderr.write;
-
-  const sendToDaemon = async (): Promise<DaemonResponse> => {
-    daemonCalls += 1;
-    return { ok: true, data: {} };
-  };
-
-  try {
-    await runCli(argv, { sendToDaemon });
-  } catch (error) {
-    if (error instanceof ExitSignal) code = error.code;
-    else throw error;
-  } finally {
-    process.exit = originalExit;
-    process.stdout.write = originalStdoutWrite;
-    process.stderr.write = originalStderrWrite;
-  }
-
-  return { code, stdout, stderr, daemonCalls };
-}
-
-test('help appstate prints command help and skips daemon dispatch', async () => {
-  const result = await runCliCapture(['help', 'appstate']);
-  assert.equal(result.code, 0);
-  assert.equal(result.daemonCalls, 0);
-  assert.match(result.stdout, /Show foreground app\/activity/);
-  assert.doesNotMatch(result.stdout, /Command flags:/);
-  assert.match(result.stdout, /Global flags:/);
-});
-
-test('appstate --help prints command help and skips daemon dispatch', async () => {
-  const result = await runCliCapture(['appstate', '--help']);
-  assert.equal(result.code, 0);
-  assert.equal(result.daemonCalls, 0);
-  assert.match(result.stdout, /Usage:\n  agent-device appstate/);
-  assert.match(result.stdout, /Global flags:/);
-});
-
-test('help unknown command prints error plus global usage and skips daemon dispatch', async () => {
-  const result = await runCliCapture(['help', 'not-a-command']);
-  assert.equal(result.code, 1);
-  assert.equal(result.daemonCalls, 0);
-  assert.match(result.stderr, /Error \(INVALID_ARGS\): Unknown command: not-a-command/);
-  assert.match(result.stdout, /Commands:/);
-  assert.match(result.stdout, /Flags:/);
-});
-
-test('unknown command --help prints error plus global usage and skips daemon dispatch', async () => {
-  const result = await runCliCapture(['not-a-command', '--help']);
-  assert.equal(result.code, 1);
-  assert.equal(result.daemonCalls, 0);
-  assert.match(result.stderr, /Error \(INVALID_ARGS\): Unknown command: not-a-command/);
-  assert.match(result.stdout, /Commands:/);
-});
-
-test('help rejects multiple positional commands and skips daemon dispatch', async () => {
-  const result = await runCliCapture(['help', 'appstate', 'extra']);
-  assert.equal(result.code, 1);
-  assert.equal(result.daemonCalls, 0);
-  assert.match(result.stderr, /Error \(INVALID_ARGS\): help accepts at most one command/);
-});

package/src/bin.ts

@@ -1,3 +0,0 @@
-import { runCli } from './cli.ts';
-
-runCli(process.argv.slice(2));

package/src/cli.ts

@@ -1,305 +0,0 @@
-import { parseArgs, toDaemonFlags, usage, usageForCommand } from './utils/args.ts';
-import { asAppError, AppError } from './utils/errors.ts';
-import { formatSnapshotText, printHumanError, printJson } from './utils/output.ts';
-import { readVersion } from './utils/version.ts';
-import { pathToFileURL } from 'node:url';
-import { sendToDaemon } from './daemon-client.ts';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-type CliDeps = {
-  sendToDaemon: typeof sendToDaemon;
-};
-
-const DEFAULT_CLI_DEPS: CliDeps = {
-  sendToDaemon,
-};
-
-export async function runCli(argv: string[], deps: CliDeps = DEFAULT_CLI_DEPS): Promise<void> {
-  const parsed = parseArgs(argv);
-  for (const warning of parsed.warnings) {
-    process.stderr.write(`Warning: ${warning}\n`);
-  }
-
-  if (parsed.flags.version) {
-    process.stdout.write(`${readVersion()}\n`);
-    process.exit(0);
-  }
-
-  const isHelpAlias = parsed.command === 'help';
-  const isHelpFlag = parsed.flags.help;
-  if (isHelpAlias || isHelpFlag) {
-    if (isHelpAlias && parsed.positionals.length > 1) {
-      printHumanError(new AppError('INVALID_ARGS', 'help accepts at most one command.'));
-      process.exit(1);
-    }
-    const helpTarget = isHelpAlias ? parsed.positionals[0] : parsed.command;
-    if (!helpTarget) {
-      process.stdout.write(`${usage()}\n`);
-      process.exit(0);
-    }
-    const commandHelp = usageForCommand(helpTarget);
-    if (commandHelp) {
-      process.stdout.write(commandHelp);
-      process.exit(0);
-    }
-    printHumanError(new AppError('INVALID_ARGS', `Unknown command: ${helpTarget}`));
-    process.stdout.write(`${usage()}\n`);
-    process.exit(1);
-  }
-
-  if (!parsed.command) {
-    process.stdout.write(`${usage()}\n`);
-    process.exit(1);
-  }
-
-  const { command, positionals, flags } = parsed;
-  const daemonFlags = toDaemonFlags(flags);
-  const sessionName = flags.session ?? process.env.AGENT_DEVICE_SESSION ?? 'default';
-  const logTailStopper = flags.verbose && !flags.json ? startDaemonLogTail() : null;
-  try {
-    if (command === 'session') {
-      const sub = positionals[0] ?? 'list';
-      if (sub !== 'list') {
-        throw new AppError('INVALID_ARGS', 'session only supports list');
-      }
-      const response = await deps.sendToDaemon({
-        session: sessionName,
-        command: 'session_list',
-        positionals: [],
-        flags: daemonFlags,
-      });
-      if (!response.ok) throw new AppError(response.error.code as any, response.error.message);
-      if (flags.json) printJson({ success: true, data: response.data ?? {} });
-      else process.stdout.write(`${JSON.stringify(response.data ?? {}, null, 2)}\n`);
-      if (logTailStopper) logTailStopper();
-      return;
-    }
-
-    const response = await deps.sendToDaemon({
-      session: sessionName,
-      command: command!,
-      positionals,
-      flags: daemonFlags,
-    });
-
-    if (response.ok) {
-      if (flags.json) {
-        printJson({ success: true, data: response.data ?? {} });
-        if (logTailStopper) logTailStopper();
-        return;
-      }
-      if (command === 'snapshot') {
-        process.stdout.write(
-          formatSnapshotText((response.data ?? {}) as Record<string, unknown>, {
-            raw: flags.snapshotRaw,
-            flatten: flags.snapshotInteractiveOnly,
-          }),
-        );
-        if (logTailStopper) logTailStopper();
-        return;
-      }
-      if (command === 'get') {
-        const sub = positionals[0];
-        if (sub === 'text') {
-          const text = (response.data as any)?.text ?? '';
-          process.stdout.write(`${text}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-        if (sub === 'attrs') {
-          const node = (response.data as any)?.node ?? {};
-          process.stdout.write(`${JSON.stringify(node, null, 2)}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-      }
-      if (command === 'find') {
-        const data = response.data as any;
-        if (typeof data?.text === 'string') {
-          process.stdout.write(`${data.text}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-        if (typeof data?.found === 'boolean') {
-          process.stdout.write(`Found: ${data.found}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-        if (data?.node) {
-          process.stdout.write(`${JSON.stringify(data.node, null, 2)}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-      }
-      if (command === 'is') {
-        const predicate = (response.data as any)?.predicate ?? 'assertion';
-        process.stdout.write(`Passed: is ${predicate}\n`);
-        if (logTailStopper) logTailStopper();
-        return;
-      }
-      if (command === 'boot') {
-        const platform = (response.data as any)?.platform ?? 'unknown';
-        const device = (response.data as any)?.device ?? (response.data as any)?.id ?? 'unknown';
-        process.stdout.write(`Boot ready: ${device} (${platform})\n`);
-        if (logTailStopper) logTailStopper();
-        return;
-      }
-      if (command === 'click') {
-        const ref = (response.data as any)?.ref ?? '';
-        const x = (response.data as any)?.x;
-        const y = (response.data as any)?.y;
-        if (ref && typeof x === 'number' && typeof y === 'number') {
-          process.stdout.write(`Clicked @${ref} (${x}, ${y})\n`);
-        }
-        if (logTailStopper) logTailStopper();
-        return;
-      }
-      if (response.data && typeof response.data === 'object') {
-        const data = response.data as Record<string, unknown>;
-        if (command === 'devices') {
-          const devices = Array.isArray((data as any).devices) ? (data as any).devices : [];
-          const lines = devices.map((d: any) => {
-            const name = d?.name ?? d?.id ?? 'unknown';
-            const platform = d?.platform ?? 'unknown';
-            const kind = d?.kind ? ` ${d.kind}` : '';
-            const booted = typeof d?.booted === 'boolean' ? ` booted=${d.booted}` : '';
-            return `${name} (${platform}${kind})${booted}`;
-          });
-          process.stdout.write(`${lines.join('\n')}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-        if (command === 'apps') {
-          const apps = Array.isArray((data as any).apps) ? (data as any).apps : [];
-          const lines = apps.map((app: any) => {
-            if (typeof app === 'string') return app;
-            if (app && typeof app === 'object') {
-              const bundleId = app.bundleId ?? app.package;
-              const name = app.name ?? app.label;
-              if (name && bundleId) return `${name} (${bundleId})`;
-              if (bundleId) return String(bundleId);
-              return JSON.stringify(app);
-            }
-            return String(app);
-          });
-          process.stdout.write(`${lines.join('\n')}\n`);
-          if (logTailStopper) logTailStopper();
-          return;
-        }
-        if (command === 'appstate') {
-          const platform = (data as any)?.platform;
-          const appBundleId = (data as any)?.appBundleId;
-          const appName = (data as any)?.appName;
-          const source = (data as any)?.source;
-          const pkg = (data as any)?.package;
-          const activity = (data as any)?.activity;
-          if (platform === 'ios') {
-            process.stdout.write(`Foreground app: ${appName ?? appBundleId ?? 'unknown'}\n`);
-            if (appBundleId) process.stdout.write(`Bundle: ${appBundleId}\n`);
-            if (source) process.stdout.write(`Source: ${source}\n`);
-            if (logTailStopper) logTailStopper();
-            return;
-          }
-          if (platform === 'android') {
-            process.stdout.write(`Foreground app: ${pkg ?? 'unknown'}\n`);
-            if (activity) process.stdout.write(`Activity: ${activity}\n`);
-            if (logTailStopper) logTailStopper();
-            return;
-          }
-        }
-      }
-      if (logTailStopper) logTailStopper();
-      return;
-    }
-
-    throw new AppError(response.error.code as any, response.error.message, response.error.details);
-  } catch (err) {
-    const appErr = asAppError(err);
-    if (command === 'close' && isDaemonStartupFailure(appErr)) {
-      if (flags.json) {
-        printJson({ success: true, data: { closed: 'session', source: 'no-daemon' } });
-      }
-      if (logTailStopper) logTailStopper();
-      return;
-    }
-    if (flags.json) {
-      printJson({
-        success: false,
-        error: { code: appErr.code, message: appErr.message, details: appErr.details },
-      });
-    } else {
-      printHumanError(appErr);
-      if (flags.verbose) {
-        try {
-          const logPath = path.join(os.homedir(), '.agent-device', 'daemon.log');
-          if (fs.existsSync(logPath)) {
-            const content = fs.readFileSync(logPath, 'utf8');
-            const lines = content.split('\n');
-            const tail = lines.slice(Math.max(0, lines.length - 200)).join('\n');
-            if (tail.trim().length > 0) {
-              process.stderr.write(`\n[daemon log]\n${tail}\n`);
-            }
-          }
-        } catch {
-          // ignore
-        }
-      }
-    }
-    if (logTailStopper) logTailStopper();
-    process.exit(1);
-  }
-}
-
-function isDaemonStartupFailure(error: AppError): boolean {
-  if (error.code !== 'COMMAND_FAILED') return false;
-  if (error.details?.kind === 'daemon_startup_failed') return true;
-  if (!error.message.toLowerCase().includes('failed to start daemon')) return false;
-  return typeof error.details?.infoPath === 'string' || typeof error.details?.lockPath === 'string';
-}
-
-const isDirectRun = pathToFileURL(process.argv[1] ?? '').href === import.meta.url;
-if (isDirectRun) {
-  runCli(process.argv.slice(2)).catch((err) => {
-    const appErr = asAppError(err);
-    printHumanError(appErr);
-    process.exit(1);
-  });
-}
-
-function startDaemonLogTail(): (() => void) | null {
-  try {
-    const logPath = path.join(os.homedir(), '.agent-device', 'daemon.log');
-    let offset = 0;
-    let stopped = false;
-    const interval = setInterval(() => {
-      if (stopped) return;
-      if (!fs.existsSync(logPath)) return;
-      try {
-        const stats = fs.statSync(logPath);
-        if (stats.size < offset) offset = 0;
-        if (stats.size <= offset) return;
-        const fd = fs.openSync(logPath, 'r');
-        try {
-          const buffer = Buffer.alloc(stats.size - offset);
-          fs.readSync(fd, buffer, 0, buffer.length, offset);
-          offset = stats.size;
-          if (buffer.length > 0) {
-            process.stdout.write(buffer.toString('utf8'));
-          }
-        } finally {
-          fs.closeSync(fd);
-        }
-      } catch {
-        // Best-effort tailing should not crash CLI flow.
-      }
-    }, 200);
-    return () => {
-      stopped = true;
-      clearInterval(interval);
-    };
-  } catch {
-    return null;
-  }
-}

package/src/core/__tests__/capabilities.test.ts

@@ -1,75 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { isCommandSupportedOnDevice } from '../capabilities.ts';
-import type { DeviceInfo } from '../../utils/device.ts';
-
-const iosSimulator: DeviceInfo = {
-  platform: 'ios',
-  id: 'sim-1',
-  name: 'iPhone',
-  kind: 'simulator',
-};
-
-const iosDevice: DeviceInfo = {
-  platform: 'ios',
-  id: 'dev-1',
-  name: 'iPhone',
-  kind: 'device',
-};
-
-const androidDevice: DeviceInfo = {
-  platform: 'android',
-  id: 'and-1',
-  name: 'Pixel',
-  kind: 'device',
-};
-
-test('iOS simulator-only commands reject iOS devices and Android', () => {
-  for (const cmd of ['alert', 'pinch']) {
-    assert.equal(isCommandSupportedOnDevice(cmd, iosSimulator), true, `${cmd} on iOS sim`);
-    assert.equal(isCommandSupportedOnDevice(cmd, iosDevice), false, `${cmd} on iOS device`);
-    assert.equal(isCommandSupportedOnDevice(cmd, androidDevice), false, `${cmd} on Android`);
-  }
-});
-
-test('simulator-only iOS commands with Android support reject iOS devices', () => {
-  for (const cmd of ['reinstall', 'record', 'settings', 'swipe']) {
-    assert.equal(isCommandSupportedOnDevice(cmd, iosSimulator), true, `${cmd} on iOS sim`);
-    assert.equal(isCommandSupportedOnDevice(cmd, iosDevice), false, `${cmd} on iOS device`);
-    assert.equal(isCommandSupportedOnDevice(cmd, androidDevice), true, `${cmd} on Android`);
-  }
-});
-
-test('core commands support iOS simulator, iOS device, and Android', () => {
-  for (const cmd of [
-    'app-switcher',
-    'apps',
-    'back',
-    'boot',
-    'click',
-    'close',
-    'fill',
-    'find',
-    'focus',
-    'get',
-    'home',
-    'long-press',
-    'open',
-    'press',
-    'screenshot',
-    'scroll',
-    'scrollintoview',
-    'snapshot',
-    'type',
-    'wait',
-  ]) {
-    assert.equal(isCommandSupportedOnDevice(cmd, iosSimulator), true, `${cmd} on iOS sim`);
-    assert.equal(isCommandSupportedOnDevice(cmd, iosDevice), true, `${cmd} on iOS device`);
-    assert.equal(isCommandSupportedOnDevice(cmd, androidDevice), true, `${cmd} on Android`);
-  }
-});
-
-test('unknown commands default to supported', () => {
-  assert.equal(isCommandSupportedOnDevice('some-future-cmd', iosSimulator), true);
-  assert.equal(isCommandSupportedOnDevice('some-future-cmd', androidDevice), true);
-});

package/src/core/__tests__/dispatch-open.test.ts

@@ -1,25 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { dispatchCommand } from '../dispatch.ts';
-import { AppError } from '../../utils/errors.ts';
-import type { DeviceInfo } from '../../utils/device.ts';
-
-test('dispatch open rejects URL as first argument when second URL is provided', async () => {
-  const device: DeviceInfo = {
-    platform: 'ios',
-    id: 'sim-1',
-    name: 'iPhone 15',
-    kind: 'simulator',
-    booted: true,
-  };
-
-  await assert.rejects(
-    () => dispatchCommand(device, 'open', ['myapp://first', 'myapp://second']),
-    (error: unknown) => {
-      assert.equal(error instanceof AppError, true);
-      assert.equal((error as AppError).code, 'INVALID_ARGS');
-      assert.match((error as AppError).message, /requires an app target as the first argument/i);
-      return true;
-    },
-  );
-});