agent-device 0.4.2 → 0.5.0

package/src/platforms/ios/devicectl.ts

@@ -1,134 +0,0 @@
-import { promises as fs } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-import type { DeviceInfo } from '../../utils/device.ts';
-import { AppError } from '../../utils/errors.ts';
-import { runCmd } from '../../utils/exec.ts';
-
-import { IOS_DEVICECTL_TIMEOUT_MS } from './config.ts';
-
-export type IosAppInfo = {
-  bundleId: string;
-  name: string;
-};
-
-type IosDeviceAppsPayload = {
-  result?: {
-    apps?: Array<{
-      bundleIdentifier?: unknown;
-      name?: unknown;
-    }>;
-  };
-};
-
-export async function runIosDevicectl(
-  args: string[],
-  context: { action: string; deviceId: string },
-): Promise<void> {
-  const fullArgs = ['devicectl', ...args];
-  const result = await runCmd('xcrun', fullArgs, {
-    allowFailure: true,
-    timeoutMs: IOS_DEVICECTL_TIMEOUT_MS,
-  });
-  if (result.exitCode === 0) return;
-  const stdout = String(result.stdout ?? '');
-  const stderr = String(result.stderr ?? '');
-  throw new AppError('COMMAND_FAILED', `Failed to ${context.action}`, {
-    cmd: 'xcrun',
-    args: fullArgs,
-    exitCode: result.exitCode,
-    stdout,
-    stderr,
-    deviceId: context.deviceId,
-    hint: resolveIosDevicectlHint(stdout, stderr) ?? IOS_DEVICECTL_DEFAULT_HINT,
-  });
-}
-
-export async function listIosDeviceApps(
-  device: DeviceInfo,
-  filter: 'user-installed' | 'all',
-): Promise<IosAppInfo[]> {
-  const jsonPath = path.join(
-    os.tmpdir(),
-    `agent-device-ios-apps-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`,
-  );
-  const args = [
-    'devicectl',
-    'device',
-    'info',
-    'apps',
-    '--device',
-    device.id,
-    '--include-all-apps',
-    '--json-output',
-    jsonPath,
-  ];
-  const result = await runCmd('xcrun', args, {
-    allowFailure: true,
-    timeoutMs: IOS_DEVICECTL_TIMEOUT_MS,
-  });
-
-  try {
-    if (result.exitCode !== 0) {
-      const stdout = String(result.stdout ?? '');
-      const stderr = String(result.stderr ?? '');
-      throw new AppError('COMMAND_FAILED', 'Failed to list iOS apps', {
-        cmd: 'xcrun',
-        args,
-        exitCode: result.exitCode,
-        stdout,
-        stderr,
-        deviceId: device.id,
-        hint: resolveIosDevicectlHint(stdout, stderr) ?? IOS_DEVICECTL_DEFAULT_HINT,
-      });
-    }
-    const jsonText = await fs.readFile(jsonPath, 'utf8');
-    const apps = parseIosDeviceAppsPayload(JSON.parse(jsonText));
-    return filterIosDeviceApps(apps, filter);
-  } catch (error) {
-    if (error instanceof AppError) throw error;
-    throw new AppError('COMMAND_FAILED', 'Failed to parse iOS apps list', {
-      deviceId: device.id,
-      cause: String(error),
-    });
-  } finally {
-    await fs.unlink(jsonPath).catch(() => {});
-  }
-}
-
-export function parseIosDeviceAppsPayload(payload: unknown): IosAppInfo[] {
-  const apps = (payload as IosDeviceAppsPayload | null | undefined)?.result?.apps;
-  if (!Array.isArray(apps)) return [];
-
-  const parsed: IosAppInfo[] = [];
-  for (const entry of apps) {
-    if (!entry || typeof entry !== 'object') continue;
-    const bundleId = typeof entry.bundleIdentifier === 'string' ? entry.bundleIdentifier.trim() : '';
-    if (!bundleId) continue;
-    const name = typeof entry.name === 'string' && entry.name.trim().length > 0 ? entry.name.trim() : bundleId;
-    parsed.push({ bundleId, name });
-  }
-  return parsed;
-}
-
-function filterIosDeviceApps(apps: IosAppInfo[], filter: 'user-installed' | 'all'): IosAppInfo[] {
-  if (filter === 'user-installed') {
-    return apps.filter((app) => !app.bundleId.startsWith('com.apple.'));
-  }
-  return apps;
-}
-
-export const IOS_DEVICECTL_DEFAULT_HINT =
-  'Ensure the iOS device is unlocked, trusted, and available in Xcode > Devices, then retry.';
-
-export function resolveIosDevicectlHint(stdout: string, stderr: string): string | null {
-  const text = `${stdout}\n${stderr}`.toLowerCase();
-  if (text.includes('device is busy') && text.includes('connecting')) {
-    return 'iOS device is still connecting. Keep it unlocked and connected by cable until it is fully available in Xcode Devices, then retry.';
-  }
-  if (text.includes('coredeviceservice') && text.includes('timed out')) {
-    return 'CoreDevice service timed out. Reconnect the device and retry; if it persists restart Xcode and the iOS device.';
-  }
-  return null;
-}

package/src/platforms/ios/devices.ts

@@ -1,100 +0,0 @@
-import { promises as fs } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { runCmd, whichCmd } from '../../utils/exec.ts';
-import { AppError } from '../../utils/errors.ts';
-import type { DeviceInfo } from '../../utils/device.ts';
-import { resolveTimeoutMs } from '../../utils/timeouts.ts';
-
-const IOS_DEVICECTL_LIST_TIMEOUT_MS = resolveTimeoutMs(
-  process.env.AGENT_DEVICE_IOS_DEVICECTL_LIST_TIMEOUT_MS,
-  8_000,
-  500,
-);
-
-export async function listIosDevices(): Promise<DeviceInfo[]> {
-  if (process.platform !== 'darwin') {
-    throw new AppError('UNSUPPORTED_PLATFORM', 'iOS tools are only available on macOS');
-  }
-
-  const simctlAvailable = await whichCmd('xcrun');
-  if (!simctlAvailable) {
-    throw new AppError('TOOL_MISSING', 'xcrun not found in PATH');
-  }
-
-  const devices: DeviceInfo[] = [];
-
-  const simResult = await runCmd('xcrun', ['simctl', 'list', 'devices', '-j']);
-  try {
-    const payload = JSON.parse(simResult.stdout as string) as {
-      devices: Record<
-        string,
-        { name: string; udid: string; state: string; isAvailable: boolean }[]
-      >;
-    };
-    for (const runtimes of Object.values(payload.devices)) {
-      for (const device of runtimes) {
-        if (!device.isAvailable) continue;
-        devices.push({
-          platform: 'ios',
-          id: device.udid,
-          name: device.name,
-          kind: 'simulator',
-          booted: device.state === 'Booted',
-        });
-      }
-    }
-  } catch (err) {
-    throw new AppError('COMMAND_FAILED', 'Failed to parse simctl devices JSON', undefined, err);
-  }
-
-  let jsonPath: string | null = null;
-  try {
-    jsonPath = path.join(
-      os.tmpdir(),
-      `agent-device-devicectl-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`,
-    );
-    const devicectlResult = await runCmd('xcrun', ['devicectl', 'list', 'devices', '--json-output', jsonPath], {
-      allowFailure: true,
-      timeoutMs: IOS_DEVICECTL_LIST_TIMEOUT_MS,
-    });
-    if (devicectlResult.exitCode !== 0) {
-      return devices;
-    }
-    const jsonText = await fs.readFile(jsonPath, 'utf8');
-    const payload = JSON.parse(jsonText) as {
-      result?: {
-        devices?: Array<{
-          identifier?: string;
-          name?: string;
-          hardwareProperties?: { platform?: string; udid?: string };
-          deviceProperties?: { name?: string };
-          connectionProperties?: { tunnelState?: string };
-        }>;
-      };
-    };
-    for (const device of payload.result?.devices ?? []) {
-      const platform = device.hardwareProperties?.platform ?? '';
-      if (platform.toLowerCase().includes('ios')) {
-        const id = device.hardwareProperties?.udid ?? device.identifier ?? '';
-        const name = device.name ?? device.deviceProperties?.name ?? id;
-        if (!id) continue;
-        devices.push({
-          platform: 'ios',
-          id,
-          name,
-          kind: 'device',
-          booted: true,
-        });
-      }
-    }
-  } catch {
-    // Ignore devicectl failures; simulators are still supported.
-  } finally {
-    if (jsonPath) {
-      await fs.rm(jsonPath, { force: true }).catch(() => {});
-    }
-  }
-
-  return devices;
-}

package/src/platforms/ios/index.ts

@@ -1,20 +0,0 @@
-export {
-  closeIosApp,
-  installIosApp,
-  listIosApps,
-  listSimulatorApps,
-  openIosApp,
-  openIosDevice,
-  reinstallIosApp,
-  resolveIosApp,
-  screenshotIos,
-  setIosSetting,
-  uninstallIosApp,
-} from './apps.ts';
-
-export { ensureBootedSimulator } from './simulator.ts';
-
-export {
-  parseIosDeviceAppsPayload,
-  type IosAppInfo,
-} from './devicectl.ts';