agent-device 0.8.6 → 0.9.0

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { createAgentDeviceClient, type AgentDeviceClient, type AgentDeviceClientConfig, type AgentDeviceDevice, type AgentDeviceIdentifiers, type AgentDeviceSelectionOptions, type AgentDeviceSession, type AgentDeviceSessionDevice, type AppCloseOptions, type AppCloseResult, type AppDeployOptions, type AppDeployResult, type AppInstallFromSourceOptions, type AppInstallFromSourceResult, type AppOpenOptions, type AppOpenResult, type CaptureScreenshotOptions, type CaptureScreenshotResult, type CaptureSnapshotOptions, type CaptureSnapshotResult, type EnsureSimulatorOptions, type EnsureSimulatorResult, type MaterializationReleaseOptions, type MaterializationReleaseResult, type MetroPrepareOptions, type MetroPrepareResult, type RuntimeResult, type RuntimeSetOptions, type RuntimeShowOptions, type SessionCloseResult, type StartupPerfSample, } from './client.ts';
+export { createAgentDeviceClient, type AgentDeviceClient, type AgentDeviceClientConfig, type AgentDeviceDevice, type AgentDeviceIdentifiers, type AgentDeviceSelectionOptions, type AgentDeviceSession, type AgentDeviceSessionDevice, type AppCloseOptions, type AppCloseResult, type AppDeployOptions, type AppDeployResult, type AppInstallFromSourceOptions, type AppInstallFromSourceResult, type AppOpenOptions, type AppOpenResult, type CaptureScreenshotOptions, type CaptureScreenshotResult, type CaptureSnapshotOptions, type CaptureSnapshotResult, type EnsureSimulatorOptions, type EnsureSimulatorResult, type MaterializationReleaseOptions, type MaterializationReleaseResult, type MetroPrepareOptions, type MetroPrepareResult, type SessionCloseResult, type StartupPerfSample, } from './client.ts';
 export { AppError, type NormalizedError } from './utils/errors.ts';
 export type { MetroPrepareKind, MetroRuntimeHints } from './client-metro.ts';
 export type { SessionRuntimeHints } from './daemon/types.ts';

package/dist/src/utils/args.d.ts

@@ -21,7 +21,7 @@ type FinalizeArgsOptions = ParseArgsOptions & {
 export declare function parseArgs(argv: string[], options?: FinalizeArgsOptions): ParsedArgs;
 export declare function parseRawArgs(argv: string[]): RawParsedArgs;
 export declare function finalizeParsedArgs(parsed: RawParsedArgs, options?: FinalizeArgsOptions): ParsedArgs;
-export declare function toDaemonFlags(flags: CliFlags): Omit<CliFlags, 'json' | 'config' | 'help' | 'version'>;
+export declare function toDaemonFlags(flags: CliFlags): Omit<CliFlags, 'json' | 'config' | 'remoteConfig' | 'help' | 'version'>;
 export declare function usage(): string;
 export declare function usageForCommand(command: string): string | null;
 export {};

package/dist/src/utils/cli-config.d.ts

@@ -1,4 +1,4 @@
-import { type CliFlags } from './command-schema.ts';
+import { type CliFlags, type FlagKey } from './command-schema.ts';
 type EnvMap = Record<string, string | undefined>;
 export declare function resolveConfigBackedFlagDefaults(options: {
     command: string | null;
@@ -6,4 +6,5 @@ export declare function resolveConfigBackedFlagDefaults(options: {
     cliFlags: CliFlags;
     env?: EnvMap;
 }): Partial<CliFlags>;
+export declare function readEnvFlagDefaultsForKeys(env: EnvMap, keys: readonly FlagKey[]): Partial<CliFlags>;
 export {};

package/dist/src/utils/command-schema.d.ts

@@ -1,6 +1,7 @@
 export type CliFlags = {
     json: boolean;
     config?: string;
+    remoteConfig?: string;
     stateDir?: string;
     daemonBaseUrl?: string;
     daemonAuthToken?: string;
@@ -97,13 +98,15 @@ export type FlagDefinition = {
     usageDescription?: string;
 };
 type CommandSchema = {
-    description: string;
+    helpDescription: string;
+    summary?: string;
     positionalArgs: readonly string[];
     allowsExtraPositionals?: boolean;
     allowedFlags: readonly FlagKey[];
     defaults?: Partial<CliFlags>;
     skipCapabilityCheck?: boolean;
     usageOverride?: string;
+    listUsageOverride?: string;
 };
 export declare const GLOBAL_FLAG_KEYS: Set<keyof CliFlags>;
 export declare function getFlagDefinition(token: string): FlagDefinition | undefined;

package/dist/src/utils/remote-config.d.ts

@@ -0,0 +1,15 @@
+import type { CliFlags } from './command-schema.ts';
+type EnvMap = Record<string, string | undefined>;
+export declare const REMOTE_OPEN_FLAG_KEYS: readonly ["remoteConfig", "session", "platform", "daemonBaseUrl", "daemonAuthToken", "daemonTransport", "metroProjectRoot", "metroKind", "metroPublicBaseUrl", "metroProxyBaseUrl", "metroBearerToken", "metroPreparePort", "metroListenHost", "metroStatusHost", "metroStartupTimeoutMs", "metroProbeTimeoutMs", "metroRuntimeFile", "metroNoReuseExisting", "metroNoInstallDeps"];
+export declare function loadRemoteConfigFile(options: {
+    configPath: string;
+    cwd: string;
+    env?: EnvMap;
+}): Partial<CliFlags>;
+export declare function resolveRemoteConfigDefaults(options: {
+    cliFlags: CliFlags;
+    cwd: string;
+    env: EnvMap;
+}): Partial<CliFlags>;
+export declare function pickRemoteOpenDefaults(defaultFlags: Partial<CliFlags>): Partial<CliFlags>;
+export {};

package/dist/src/utils/remote-open.d.ts

@@ -0,0 +1,9 @@
+import type { AgentDeviceClient } from '../client.ts';
+import type { CliFlags } from './command-schema.ts';
+export declare function resolveRemoteOpenRuntime(flags: CliFlags, client: AgentDeviceClient): Promise<{
+    platform?: 'ios' | 'android';
+    metroHost?: string;
+    metroPort?: number;
+    bundleUrl?: string;
+    launchUrl?: string;
+} | undefined>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "description": "Unified control plane for physical and virtual devices via an agent-driven CLI.",
   "license": "MIT",
   "author": "Callstack",

package/skills/agent-device/SKILL.md

@@ -33,7 +33,7 @@ Use this skill as a router, not a full manual.
 - iOS local QA: use simulators unless the task explicitly requires a physical device.
 - iOS local QA in mixed simulator/device environments: run `ensure-simulator` first and pass `--device`, `--udid`, or `--ios-simulator-device-set` on later commands.
 - Android local QA: use `install` or `reinstall` for `.apk`/`.aab` files, then relaunch by installed package name.
-- Android React Native + Metro flows: set runtime hints with `runtime set` before `open <package> --relaunch`.
+- Android React Native + Metro flows: prefer `open <package> --remote-config <path> --relaunch`.
 - In mixed-device environments, always pin the exact target with `--serial`, `--device`, `--udid`, or an isolation scope.
 - For session-bound automation runs, prefer a pre-bound session/platform instead of repeating selectors on every command: set `AGENT_DEVICE_SESSION`, set `AGENT_DEVICE_PLATFORM`, and the daemon will enforce the shared lock policy across CLI, typed client, and RPC entry points.
 - Use `--session-lock reject|strip` (or `AGENT_DEVICE_SESSION_LOCK`) only when you need to override the default reject behavior. Lock mode applies to nested `batch` steps too.
@@ -67,8 +67,7 @@ Use this when a physical iPhone is also connected and you want deterministic sim
 
 ```bash
 agent-device reinstall MyApp /path/to/app-debug.apk --platform android --serial emulator-5554
-agent-device runtime set --session qa-android --platform android --metro-host 10.0.2.2 --metro-port 8081
-agent-device open com.example.myapp --platform android --serial emulator-5554 --session qa-android --relaunch
+agent-device open com.example.myapp --remote-config ./agent-device.remote.json --relaunch
 agent-device snapshot -i
 agent-device close
 ```
@@ -186,7 +185,7 @@ That includes bound-session defaults such as `sessionLock` / `AGENT_DEVICE_SESSI
 For Android emulators by AVD name, use `boot --platform android --device <avd-name>`.
 For Android emulators without GUI, add `--headless`.
 Use `--target mobile|tv` with `--platform` (required) to pick phone/tablet vs TV targets (AndroidTV/tvOS).
-For Android React Native + Metro flows, install or reinstall the APK first, set runtime hints with `runtime set`, then use `open <package> --relaunch`; do not use `open <apk|aab> --relaunch`.
+For Android React Native + Metro flows, install or reinstall the APK first, then use `open <package> --remote-config <path> --relaunch`; do not use `open <apk|aab> --relaunch`.
 For local iOS QA in mixed simulator/device environments, use `ensure-simulator` and pass `--device` or `--udid` so automation does not attach to a physical device by accident.
 For session-bound automation, prefer `AGENT_DEVICE_SESSION` + `AGENT_DEVICE_PLATFORM`; that bound-session default now enables lock mode automatically.