agent-device 0.4.1 → 0.5.0

package/src/cli.ts

@@ -1,289 +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 && typeof app.launchable === 'boolean') {
-                return `${bundleId} (launchable=${app.launchable})`;
-              }
-              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}\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 (flags.json) {
-      printJson({
-        success: false,
-        error: { code: appErr.code, message: appErr.message, details: appErr.details },
-      });
-    } else {
-      printHumanError(appErr);
-      if (flags.verbose) {
-        try {
-          const fs = await import('node:fs');
-          const os = await import('node:os');
-          const path = await import('node:path');
-          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);
-  }
-}
-
-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;
-      const stats = fs.statSync(logPath);
-      if (stats.size <= offset) return;
-      const fd = fs.openSync(logPath, 'r');
-      const buffer = Buffer.alloc(stats.size - offset);
-      fs.readSync(fd, buffer, 0, buffer.length, offset);
-      fs.closeSync(fd);
-      offset = stats.size;
-      if (buffer.length > 0) {
-        process.stdout.write(buffer.toString('utf8'));
-      }
-    }, 200);
-    return () => {
-      stopped = true;
-      clearInterval(interval);
-    };
-  } catch {
-    return null;
-  }
-}

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

@@ -1,74 +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 ['apps', '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',
-    '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__/open-target.test.ts

@@ -1,16 +0,0 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { isDeepLinkTarget } from '../open-target.ts';
-
-test('isDeepLinkTarget accepts URL-style deep links', () => {
-  assert.equal(isDeepLinkTarget('myapp://home'), true);
-  assert.equal(isDeepLinkTarget('https://example.com'), true);
-  assert.equal(isDeepLinkTarget('tel:123456789'), true);
-  assert.equal(isDeepLinkTarget('mailto:test@example.com'), true);
-});
-
-test('isDeepLinkTarget rejects app identifiers and malformed URLs', () => {
-  assert.equal(isDeepLinkTarget('com.example.app'), false);
-  assert.equal(isDeepLinkTarget('settings'), false);
-  assert.equal(isDeepLinkTarget('http:/x'), false);
-});

package/src/core/capabilities.ts

@@ -1,57 +0,0 @@
-import type { DeviceInfo } from '../utils/device.ts';
-
-type KindMatrix = {
-  simulator?: boolean;
-  device?: boolean;
-  emulator?: boolean;
-  unknown?: boolean;
-};
-
-type CommandCapability = {
-  ios?: KindMatrix;
-  android?: KindMatrix;
-};
-
-const COMMAND_CAPABILITY_MATRIX: Record<string, CommandCapability> = {
-  // iOS simulator-only.
-  alert: { ios: { simulator: true }, android: {} },
-  pinch: { ios: { simulator: true }, android: {} },
-  'app-switcher': { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  apps: { ios: { simulator: true }, android: { emulator: true, device: true, unknown: true } },
-  back: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  boot: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  click: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  close: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  fill: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  find: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  focus: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  get: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  is: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  home: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  'long-press': { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  open: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  reinstall: { ios: { simulator: true }, android: { emulator: true, device: true, unknown: true } },
-  press: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  record: { ios: { simulator: true }, android: { emulator: true, device: true, unknown: true } },
-  screenshot: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  scroll: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  scrollintoview: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  swipe: { ios: { simulator: true }, android: { emulator: true, device: true, unknown: true } },
-  settings: { ios: { simulator: true }, android: { emulator: true, device: true, unknown: true } },
-  snapshot: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  type: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-  wait: { ios: { simulator: true, device: true }, android: { emulator: true, device: true, unknown: true } },
-};
-
-export function isCommandSupportedOnDevice(command: string, device: DeviceInfo): boolean {
-  const capability = COMMAND_CAPABILITY_MATRIX[command];
-  if (!capability) return true;
-  const byPlatform = capability[device.platform];
-  if (!byPlatform) return false;
-  const kind = (device.kind ?? 'unknown') as keyof KindMatrix;
-  return byPlatform[kind] === true;
-}
-
-export function listCapabilityCommands(): string[] {
-  return Object.keys(COMMAND_CAPABILITY_MATRIX).sort();
-}