mobile-agent-mcp 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes are documented here. This project follows [Semantic Versioning](https://semver.org):
+`MAJOR.MINOR.PATCH`: breaking, feature, or fix.
+
+## [0.1.1] - 2026-05-30
+
+### Added
+
+- Driver unit tests (Maestro arg building, adb reverse, open-url) with a mocked `spawnSync`.
+- Biome for lint + format; `pnpm lint`, `pnpm format`, and `pnpm check` now gate on it.
+- `CONTRIBUTING.md` with SemVer policy and release steps.
+
+### Fixed
+
+- `AgentError` no longer double-wraps the underlying `cause` when raised from config parsing.
+
+### Changed
+
+- Dropped the unused `fallback` parameter from `assertPlatform`.
+
+## [0.1.0] - 2026-05-30
+
+### Added
+
+- MCP stdio server and `mobile-agent` CLI: `doctor`, `list_devices`, `screenshot`,
+  `run_maestro_flow`, `run_smoke_flows`, `adb_reverse`, `open_url`, `open_dev_url`.
+- Per-repo `mobile-agent.config.json` with upward discovery and env overrides.
+- Typed errors with stable exit codes and Zod-validated config.
+
+[0.1.1]: https://github.com/anthonysbr/mobile-agent-mcp/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/anthonysbr/mobile-agent-mcp/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthony Batista
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,4 @@
+mobile-agent-mcp
+Copyright (c) 2026 Anthony Batista · https://entkreis.de
+
+Keep the LICENSE notice if you redistribute or fork. MIT allows commercial use; a link back is appreciated.

package/README.md

@@ -0,0 +1,115 @@
+# mobile-agent-mcp
+
+Drive **iOS simulators, Android emulators, and USB devices** from Cursor, Claude, Codex, or a shell. Maestro runs your flows; this package handles the host side: list devices, screenshots, deep links, `adb reverse`, per-repo config.
+
+No Expo or Flutter lock-in. Your Maestro YAML and env vars live in your project.
+
+## Install
+
+```bash
+npm install -D mobile-agent-mcp
+```
+
+You need Node 20+, [Maestro](https://maestro.mobile.dev/), Xcode on macOS for iOS, and `adb` for Android.
+
+## Config
+
+Put `mobile-agent.config.json` in the repo root. Example: [`mobile-agent.config.example.json`](mobile-agent.config.example.json).
+
+```json
+{
+  "projectRoot": ".",
+  "flowsDir": "e2e/maestro/flows",
+  "screenshotDir": "artifacts/mobile-screenshots",
+  "smokeFlows": ["smoke-login", "smoke-logout"],
+  "maestro": {
+    "bin": "maestro",
+    "defaultEnv": { "APP_ID": "com.example.app" }
+  }
+}
+```
+
+Optional `devServerUrl` builds something like `exp://192.168.x.x:8081` for Maestro and `open-dev-url`:
+
+```json
+"devServerUrl": {
+  "scheme": "exp",
+  "port": 8081,
+  "hostEnv": "EXPO_DEV_HOST",
+  "outputEnvKey": "EXPO_URL"
+}
+```
+
+Env overrides: `MOBILE_AGENT_PROJECT_ROOT`, `MOBILE_AGENT_FLOWS_DIR`, `MOBILE_AGENT_SCREENSHOT_DIR`, `MAESTRO_BIN`, `MAESTRO_DEVICE`.
+
+If MCP starts from a random cwd, set `MOBILE_AGENT_PROJECT_ROOT` to your repo path.
+
+Run `mobile-agent doctor` before a long session. Saves guessing why nothing boots.
+
+## CLI
+
+```bash
+mobile-agent doctor
+mobile-agent devices
+mobile-agent screenshot ios
+mobile-agent run my-flow ios -e APP_ID=com.example.app
+mobile-agent run-all ios
+mobile-agent adb-reverse 8081 4000
+mobile-agent open-url "myapp://home" ios
+mobile-agent open-dev-url ios
+```
+
+Flags: `--project-root`, `--flows-dir`, `--screenshot-dir`.
+
+## MCP
+
+```bash
+mobile-agent-mcp
+```
+
+| Tool | What it does |
+|------|----------------|
+| `doctor` | Config, flows dir, Maestro, adb/simctl |
+| `list_devices` | Sims, USB, Maestro version |
+| `screenshot` | PNG path |
+| `run_maestro_flow` | One flow from `flowsDir` |
+| `run_smoke_flows` | All `smokeFlows` |
+| `adb_reverse` | USB Android → localhost ports |
+| `open_url` | Any deep link |
+| `open_dev_url` | URL from config |
+
+**Cursor** (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "mobile-agent": {
+      "command": "npx",
+      "args": ["-y", "mobile-agent-mcp"],
+      "env": {
+        "MOBILE_AGENT_PROJECT_ROOT": "/absolute/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+Local checkout: point at `dist/mcp-server.js` instead of `npx`.
+
+Claude Desktop: same block in `~/Library/Application Support/Claude/claude_desktop_config.json`.
+
+No MCP? Shell works fine. See [`docs/agent-skill.md`](docs/agent-skill.md).
+
+## Programmatic use
+
+```ts
+import { createRuntime } from 'mobile-agent-mcp';
+
+const agent = createRuntime();
+agent.doctor();
+agent.screenshot('ios');
+```
+
+## Roadmap
+
+[`ROADMAP.md`](ROADMAP.md): next up **`tail_logs`** (Metro, logcat, iOS sim logs).

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { Command } from 'commander';
+import { parseEnvPairs, parsePorts } from './config.js';
+import { formatError, getExitCode } from './errors.js';
+import { createRuntime } from './runtime.js';
+import { PACKAGE_NAME, PACKAGE_VERSION } from './version.js';
+function printResult(text) {
+    process.stdout.write(`${text}\n`);
+}
+function printError(error) {
+    process.stderr.write(`[${PACKAGE_NAME}] ${formatError(error)}\n`);
+    process.exit(getExitCode(error));
+}
+const program = new Command();
+program
+    .name('mobile-agent')
+    .description('iOS/Android simulators, emulators, and USB devices via Maestro, adb, simctl')
+    .version(PACKAGE_VERSION, '-V, --version', 'Print version')
+    .option('--project-root <path>', 'Override MOBILE_AGENT_PROJECT_ROOT')
+    .option('--flows-dir <path>', 'Override MOBILE_AGENT_FLOWS_DIR')
+    .option('--screenshot-dir <path>', 'Override MOBILE_AGENT_SCREENSHOT_DIR');
+function createCliRuntime(command) {
+    const opts = command.parent?.opts() ?? {};
+    return createRuntime({
+        env: {
+            ...process.env,
+            ...(opts.projectRoot ? { MOBILE_AGENT_PROJECT_ROOT: opts.projectRoot } : {}),
+            ...(opts.flowsDir ? { MOBILE_AGENT_FLOWS_DIR: opts.flowsDir } : {}),
+            ...(opts.screenshotDir ? { MOBILE_AGENT_SCREENSHOT_DIR: opts.screenshotDir } : {}),
+        },
+        overrides: {
+            ...(opts.projectRoot ? { projectRoot: path.resolve(opts.projectRoot) } : {}),
+            ...(opts.flowsDir ? { flowsDir: path.resolve(opts.flowsDir) } : {}),
+            ...(opts.screenshotDir ? { screenshotDir: path.resolve(opts.screenshotDir) } : {}),
+        },
+    });
+}
+program
+    .command('doctor')
+    .description('Sanity check before running flows')
+    .action((_args, command) => {
+    try {
+        const runtime = createCliRuntime(command);
+        printResult(runtime.doctor());
+        if (runtime.doctorFailed()) {
+            process.exit(4);
+        }
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('devices')
+    .description('Sims, USB devices, Maestro version')
+    .action((_args, command) => {
+    try {
+        printResult(createCliRuntime(command).listDevices());
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('screenshot')
+    .argument('[platform]', 'ios or android', 'ios')
+    .description('PNG to screenshotDir; prints path')
+    .action((platform, _args, command) => {
+    try {
+        printResult(createCliRuntime(command).screenshot(platform));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('run')
+    .argument('<flow>', 'Maestro flow name or path relative to flowsDir')
+    .argument('[platform]', 'ios or android', 'ios')
+    .option('-e, --env <pair...>', 'Maestro env var KEY=VALUE')
+    .description('Run one Maestro flow')
+    .action((flow, platform, options, command) => {
+    try {
+        printResult(createCliRuntime(command).runFlow(flow, platform, parseEnvPairs(options.env)));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('run-all')
+    .argument('[platform]', 'ios or android', 'ios')
+    .option('-e, --env <pair...>', 'Maestro env var KEY=VALUE')
+    .description('Run every flow in smokeFlows from config')
+    .action((platform, options, command) => {
+    try {
+        printResult(createCliRuntime(command).runSmoke(platform, parseEnvPairs(options.env)));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('adb-reverse')
+    .argument('[ports...]', 'TCP ports to reverse')
+    .description('adb reverse for localhost ports (USB Android)')
+    .action((ports, _args, command) => {
+    try {
+        printResult(createCliRuntime(command).adbReverse(parsePorts(ports)));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('open-dev-url')
+    .argument('[platform]', 'ios or android', 'ios')
+    .description('Open URL from devServerUrl in config')
+    .action((platform, _args, command) => {
+    try {
+        printResult(createCliRuntime(command).openDevUrl(platform));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program
+    .command('open-url')
+    .argument('<url>', 'Deep link or URL to open on device')
+    .argument('[platform]', 'ios or android', 'ios')
+    .description('Open a deep link on sim or device')
+    .action((url, platform, _args, command) => {
+    try {
+        printResult(createCliRuntime(command).openUrl(url, platform));
+    }
+    catch (error) {
+        printError(error);
+    }
+});
+program.parse();
+//# 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/config.d.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const CONFIG_FILENAME = "mobile-agent.config.json";
+export type Platform = 'ios' | 'android';
+declare const ConfigFileSchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    flowsDir: z.ZodOptional<z.ZodString>;
+    screenshotDir: z.ZodOptional<z.ZodString>;
+    smokeFlows: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    devServerUrl: z.ZodOptional<z.ZodObject<{
+        scheme: z.ZodOptional<z.ZodString>;
+        port: z.ZodOptional<z.ZodNumber>;
+        hostEnv: z.ZodOptional<z.ZodString>;
+        outputEnvKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        scheme?: string | undefined;
+        port?: number | undefined;
+        hostEnv?: string | undefined;
+        outputEnvKey?: string | undefined;
+    }, {
+        scheme?: string | undefined;
+        port?: number | undefined;
+        hostEnv?: string | undefined;
+        outputEnvKey?: string | undefined;
+    }>>;
+    maestro: z.ZodOptional<z.ZodObject<{
+        bin: z.ZodOptional<z.ZodString>;
+        defaultEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        appId: z.ZodOptional<z.ZodObject<{
+            ios: z.ZodOptional<z.ZodString>;
+            android: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            ios?: string | undefined;
+            android?: string | undefined;
+        }, {
+            ios?: string | undefined;
+            android?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        bin?: string | undefined;
+        defaultEnv?: Record<string, string> | undefined;
+        appId?: {
+            ios?: string | undefined;
+            android?: string | undefined;
+        } | undefined;
+    }, {
+        bin?: string | undefined;
+        defaultEnv?: Record<string, string> | undefined;
+        appId?: {
+            ios?: string | undefined;
+            android?: string | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot?: string | undefined;
+    flowsDir?: string | undefined;
+    screenshotDir?: string | undefined;
+    smokeFlows?: string[] | undefined;
+    devServerUrl?: {
+        scheme?: string | undefined;
+        port?: number | undefined;
+        hostEnv?: string | undefined;
+        outputEnvKey?: string | undefined;
+    } | undefined;
+    maestro?: {
+        bin?: string | undefined;
+        defaultEnv?: Record<string, string> | undefined;
+        appId?: {
+            ios?: string | undefined;
+            android?: string | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    projectRoot?: string | undefined;
+    flowsDir?: string | undefined;
+    screenshotDir?: string | undefined;
+    smokeFlows?: string[] | undefined;
+    devServerUrl?: {
+        scheme?: string | undefined;
+        port?: number | undefined;
+        hostEnv?: string | undefined;
+        outputEnvKey?: string | undefined;
+    } | undefined;
+    maestro?: {
+        bin?: string | undefined;
+        defaultEnv?: Record<string, string> | undefined;
+        appId?: {
+            ios?: string | undefined;
+            android?: string | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type MobileAgentConfigFile = z.infer<typeof ConfigFileSchema>;
+export interface ResolvedConfig {
+    projectRoot: string;
+    flowsDir: string;
+    screenshotDir: string;
+    smokeFlows: string[];
+    maestroBin: string;
+    maestroDefaultEnv: Record<string, string>;
+    maestroAppIds: Partial<Record<Platform, string>>;
+    devServerUrl: MobileAgentConfigFile['devServerUrl'];
+    configPath: string | null;
+}
+export declare function findConfigFile(startDir?: string): string | null;
+export interface LoadConfigOptions {
+    startDir?: string;
+    overrides?: Partial<ResolvedConfig>;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function loadConfig(options?: LoadConfigOptions): ResolvedConfig;
+export declare function assertPlatform(value: string | undefined): Platform;
+export declare function parseEnvPairs(pairs: string[] | undefined): Record<string, string>;
+export declare function parsePorts(ports: string[]): number[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AASzC,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpB,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACpD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA0CD,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAgB9E;AAOD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAiD1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAWlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUjF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASpD"}

package/dist/config.js

@@ -0,0 +1,137 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { AgentError, ErrorCode } from './errors.js';
+export const CONFIG_FILENAME = 'mobile-agent.config.json';
+const DevServerUrlSchema = z.object({
+    scheme: z.string().min(1).optional(),
+    port: z.number().int().positive().max(65535).optional(),
+    hostEnv: z.string().min(1).optional(),
+    outputEnvKey: z.string().min(1).optional(),
+});
+const ConfigFileSchema = z.object({
+    projectRoot: z.string().min(1).optional(),
+    flowsDir: z.string().min(1).optional(),
+    screenshotDir: z.string().min(1).optional(),
+    smokeFlows: z.array(z.string().min(1)).optional(),
+    devServerUrl: DevServerUrlSchema.optional(),
+    maestro: z
+        .object({
+        bin: z.string().min(1).optional(),
+        defaultEnv: z.record(z.string(), z.string()).optional(),
+        appId: z
+            .object({
+            ios: z.string().min(1).optional(),
+            android: z.string().min(1).optional(),
+        })
+            .optional(),
+    })
+        .optional(),
+});
+const DEFAULT_FLOWS_DIR = 'e2e/maestro/flows';
+const DEFAULT_SCREENSHOT_DIR = 'artifacts/mobile-screenshots';
+function readConfigFile(filePath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        throw new AgentError(`Unable to read ${filePath}: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.CONFIG_INVALID, error);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new AgentError(`Invalid JSON in ${filePath}: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.CONFIG_INVALID, error);
+    }
+    const result = ConfigFileSchema.safeParse(parsed);
+    if (!result.success) {
+        const details = result.error.issues
+            .map((issue) => `${issue.path.join('.') || 'root'}: ${issue.message}`)
+            .join('; ');
+        throw new AgentError(`Invalid ${CONFIG_FILENAME} at ${filePath}: ${details}`, ErrorCode.CONFIG_INVALID);
+    }
+    return result.data;
+}
+export function findConfigFile(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    const root = path.parse(dir).root;
+    while (true) {
+        const candidate = path.join(dir, CONFIG_FILENAME);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        if (dir === root) {
+            break;
+        }
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+function resolvePath(baseDir, value, fallback) {
+    const target = value ?? fallback;
+    return path.resolve(baseDir, target);
+}
+export function loadConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const startDir = options.startDir ?? process.cwd();
+    const configSearchDir = env.MOBILE_AGENT_PROJECT_ROOT ?? startDir;
+    const configPath = findConfigFile(configSearchDir);
+    const fileConfig = configPath ? readConfigFile(configPath) : {};
+    const configBaseDir = configPath ? path.dirname(configPath) : path.resolve(startDir);
+    const projectRoot = resolvePath(configBaseDir, env.MOBILE_AGENT_PROJECT_ROOT ?? fileConfig.projectRoot, '.');
+    const flowsDir = resolvePath(projectRoot, env.MOBILE_AGENT_FLOWS_DIR ?? fileConfig.flowsDir, DEFAULT_FLOWS_DIR);
+    const screenshotDir = resolvePath(projectRoot, env.MOBILE_AGENT_SCREENSHOT_DIR ?? fileConfig.screenshotDir, DEFAULT_SCREENSHOT_DIR);
+    const maestroBin = env.MAESTRO_BIN ?? fileConfig.maestro?.bin ?? 'maestro';
+    const maestroDefaultEnv = fileConfig.maestro?.defaultEnv ?? {};
+    const maestroAppIds = fileConfig.maestro?.appId ?? {};
+    const devServerUrl = fileConfig.devServerUrl;
+    const smokeFlows = fileConfig.smokeFlows ?? [];
+    const resolved = {
+        projectRoot,
+        flowsDir,
+        screenshotDir,
+        smokeFlows,
+        maestroBin,
+        maestroDefaultEnv,
+        maestroAppIds,
+        devServerUrl,
+        configPath,
+    };
+    if (options.overrides) {
+        return { ...resolved, ...options.overrides };
+    }
+    return resolved;
+}
+export function assertPlatform(value) {
+    if (!value || value === 'ios') {
+        return 'ios';
+    }
+    if (value === 'android') {
+        return 'android';
+    }
+    throw new AgentError(`Unknown platform: ${value} (use ios or android)`, ErrorCode.PLATFORM_INVALID);
+}
+export function parseEnvPairs(pairs) {
+    const env = {};
+    for (const pair of pairs ?? []) {
+        const index = pair.indexOf('=');
+        if (index <= 0) {
+            throw new AgentError(`Invalid env pair: ${pair} (expected KEY=VALUE)`, ErrorCode.VALIDATION);
+        }
+        env[pair.slice(0, index)] = pair.slice(index + 1);
+    }
+    return env;
+}
+export function parsePorts(ports) {
+    const portArgs = ports.length > 0 ? ports : ['8081'];
+    return portArgs.map((port) => {
+        const value = Number(port);
+        if (!Number.isInteger(value) || value <= 0 || value > 65535) {
+            throw new AgentError(`Invalid port: ${port}`, ErrorCode.VALIDATION);
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/driver/adb.d.ts

@@ -0,0 +1,2 @@
+export declare function adbReverse(ports: number[]): string;
+//# sourceMappingURL=adb.d.ts.map

package/dist/driver/adb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.d.ts","sourceRoot":"","sources":["../../src/driver/adb.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAUlD"}

package/dist/driver/adb.js

@@ -0,0 +1,12 @@
+import { AgentError, ErrorCode } from '../errors.js';
+import { commandExists, runCommand } from './exec.js';
+export function adbReverse(ports) {
+    if (!commandExists('adb')) {
+        throw new AgentError('adb not installed', ErrorCode.TOOL_UNAVAILABLE);
+    }
+    for (const port of ports) {
+        runCommand('adb', ['reverse', `tcp:${port}`, `tcp:${port}`]);
+    }
+    return `adb reverse ok (${ports.join(', ')})`;
+}
+//# sourceMappingURL=adb.js.map

package/dist/driver/adb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adb.js","sourceRoot":"","sources":["../../src/driver/adb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,IAAI,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,mBAAmB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAChD,CAAC"}

package/dist/driver/dev-server.d.ts

@@ -0,0 +1,9 @@
+export declare function detectLanIp(): string;
+export interface DevServerUrlConfig {
+    scheme?: string;
+    port?: number;
+    hostEnv?: string;
+    outputEnvKey?: string;
+}
+export declare function resolveDevServerEnv(config: DevServerUrlConfig | undefined, env?: NodeJS.ProcessEnv): Record<string, string>;
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/driver/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/driver/dev-server.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,IAAI,MAAM,CAWpC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GAAG,SAAS,EACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB"}