nativeapptemplate-agent 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,23 +1,108 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
 import { dispatch } from "./dispatch.js";
 import { loadDotenvIfPresent } from "./env.js";
+import { parseRenamePair } from "./rename-overrides.js";
+import { projectNameToSlug, slugToPascal, isValidSlug } from "./slug.js";
 loadDotenvIfPresent();
+export function parseArgs(argv) {
+    const specParts = [];
+    const report = {};
+    const renameOverrides = [];
+    let open = false;
+    let exitZero = false;
+    let projectName;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            continue;
+        if (arg === "--no-report")
+            report.enabled = false;
+        else if (arg === "--report-open")
+            open = true;
+        else if (arg === "--exit-zero")
+            exitZero = true;
+        else if (arg.startsWith("--report-format=")) {
+            const value = arg.slice("--report-format=".length);
+            if (value === "html" || value === "json" || value === "both")
+                report.format = value;
+        }
+        else if (arg.startsWith("--report-embed=")) {
+            report.embed = arg.slice("--report-embed=".length) !== "false";
+        }
+        else if (arg === "--rename" || arg.startsWith("--rename=")) {
+            // Accept both `--rename From=To` (per ROADMAP) and `--rename=From=To`.
+            const raw = arg === "--rename" ? argv[++i] : arg.slice("--rename=".length);
+            const pair = parseRenamePair(raw);
+            if (pair)
+                renameOverrides.push(pair);
+            else
+                console.error(`warning: ignoring malformed --rename "${raw ?? ""}" (expected From=To, e.g. --rename Shop=Clinic)`);
+        }
+        else if (arg === "--project-name" || arg.startsWith("--project-name=")) {
+            const raw = (arg === "--project-name" ? argv[++i] : arg.slice("--project-name=".length))?.trim();
+            // Accept any of "Vet Clinic" / "VetClinic" / "vet-clinic" — the slug is
+            // derived in dispatch. Reject only if it yields no valid slug at all.
+            if (raw && isValidSlug(projectNameToSlug(raw)))
+                projectName = raw;
+            else
+                console.error(`warning: ignoring invalid --project-name "${raw ?? ""}" (e.g. --project-name="Vet Clinic")`);
+        }
+        else {
+            specParts.push(arg);
+        }
+    }
+    return { spec: specParts.join(" ").trim(), report, open, exitZero, renameOverrides, ...(projectName !== undefined ? { projectName } : {}) };
+}
 export async function main(spec) {
-    const input = spec ?? process.argv.slice(2).join(" ").trim();
+    const parsed = parseArgs(process.argv.slice(2));
+    const input = (spec ?? parsed.spec).trim();
     if (!input) {
-        console.error('Usage: nativeapptemplate-agent "your spec here"');
+        console.error('Usage: nativeapptemplate-agent "your spec here" [--project-name="Vet Clinic"] [--rename From=To]... [--no-report] [--report-format=html|json|both] [--report-embed=true|false] [--report-open] [--exit-zero]');
         process.exitCode = 1;
         return;
     }
     console.log(`nativeapptemplate-agent: received spec: ${input}`);
     console.log('(tail tmp/trace/*.log in a tiled view via scripts/demo-tmux.sh)');
-    const result = await dispatch(input);
+    const result = await dispatch(input, {
+        report: parsed.report,
+        renameOverrides: parsed.renameOverrides,
+        ...(parsed.projectName !== undefined ? { projectName: parsed.projectName } : {}),
+    });
+    if (parsed.projectName !== undefined) {
+        const finalSlug = result.report.meta.slug;
+        console.log(`project: ${slugToPascal(finalSlug)} (output out/${finalSlug}/)`);
+    }
+    for (const o of result.renameOverrideOutcomes) {
+        if (o.kind === "changed")
+            console.log(`override: ${o.from} → ${o.to} (overrode planner's "${o.was}")`);
+        else if (o.kind === "noop")
+            console.log(`override: ${o.from} → ${o.to} (already the planner's pick)`);
+        else {
+            const sources = result.report.domain.renamePlan.map((p) => p.from).join(", ");
+            console.error(`warning: --rename ${o.from}=${o.to} matched no planned rename — skipped (renamable: ${sources || "none"})`);
+        }
+    }
     console.log('');
     console.log('=== run complete ===');
     console.log(`result: ${result.summary}`);
     console.log(`overall: ${result.overallPass ? 'PASS' : 'FAIL'}`);
+    if (result.reportPaths.htmlPath) {
+        console.log(`report: file://${result.reportPaths.htmlPath}`);
+        if (parsed.open && process.platform === 'darwin') {
+            spawn('open', [result.reportPaths.htmlPath], { stdio: 'ignore', detached: true }).unref();
+        }
+    }
+    else if (result.reportPaths.jsonPath) {
+        console.log(`report: ${result.reportPaths.jsonPath}`);
+    }
+    // Non-zero exit on validation failure so CI / shell `&&` chains catch
+    // it. --exit-zero opts out (e.g. when you only want the report).
+    if (!result.overallPass && !parsed.exitZero) {
+        process.exitCode = 1;
+    }
 }
 // Entry guard: run main() when this file is the program entry point. Resolve
 // both sides to canonical (symlink-followed) paths so npm bin symlinks (e.g.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,mBAAmB,EAAE,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAa;IACtC,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2CAA2C,KAAK,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,0EAA0E;AAC1E,0EAA0E;AAC1E,+BAA+B;AAC/B,IAAI,YAAY,EAAE,EAAE,CAAC;IACnB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACtC,OAAO,SAAS,KAAK,UAAU,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createMcpServer(): McpServer;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,wBAAgB,eAAe,IAAI,SAAS,CAsD3C;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1C"}

package/dist/mcp.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { dispatch } from "./dispatch.js";
+import { loadDotenvIfPresent } from "./env.js";
+import { readPackageVersion } from "./version.js";
+// MCP surface (MONETIZATION.md §"MCP as a distribution surface"):
+// thin wrapper around dispatch() so any MCP-compatible AI assistant
+// (Claude Code, Cursor, Cline, Continue, Goose, ...) can invoke the
+// agent as a tool. Same backend as the CLI; different wire format.
+//
+// Run via: `npx -y nativeapptemplate-agent-mcp` from an MCP client config.
+export function createMcpServer() {
+    const server = new McpServer({
+        name: "nativeapptemplate-agent",
+        version: readPackageVersion(),
+    });
+    server.registerTool("generate_app", {
+        title: "Generate three-platform SaaS app",
+        description: "Generate a working three-platform SaaS app from a natural-language spec — Rails 8.1 API + SwiftUI iOS + Jetpack Compose Android. Validated end-to-end (rename completeness, build, vision judge). Output lands in ./out/<spec-slug>/{rails,ios,android}/. Each invocation runs ~3-5 minutes and consumes Anthropic API usage on the configured key, separate from the calling assistant's session.",
+        inputSchema: {
+            spec: z
+                .string()
+                .min(1)
+                .describe('Natural-language SaaS spec, e.g. "a walk-in queue for a barbershop"'),
+            renameOverrides: z
+                .array(z.object({ from: z.string().min(1), to: z.string().min(1) }))
+                .optional()
+                .describe('Optional manual rename overrides keyed on the substrate token (from = "Shop" | "Shopkeeper" | "ItemTag"), each replacing the planner\'s chosen target. Overrides that match no planned rename are ignored.'),
+            projectName: z
+                .string()
+                .optional()
+                .describe('Optional project name (e.g. "Vet Clinic" or "VetClinic"). Overrides the planner\'s name; the slug — which sets the output directory, DB prefix, and the Pascal project name across all three platforms — and the display name are derived from it. Ignored if it yields no valid slug.'),
+        },
+    }, async ({ spec, renameOverrides, projectName }) => {
+        const result = await dispatch(spec, {
+            ...(renameOverrides ? { renameOverrides } : {}),
+            ...(projectName !== undefined ? { projectName } : {}),
+        });
+        return {
+            content: [{ type: "text", text: result.summary }],
+            structuredContent: {
+                overallPass: result.overallPass,
+                summary: result.summary,
+                ...(result.visual ? { visual: result.visual } : {}),
+                report: result.report,
+                ...(result.reportPaths.htmlPath ? { reportHtmlPath: result.reportPaths.htmlPath } : {}),
+                ...(result.reportPaths.jsonPath ? { reportJsonPath: result.reportPaths.jsonPath } : {}),
+            },
+            isError: !result.overallPass,
+        };
+    });
+    return server;
+}
+export async function main() {
+    loadDotenvIfPresent();
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+if (isEntryPoint()) {
+    main().catch((err) => {
+        console.error(err);
+        process.exitCode = 1;
+    });
+}
+function isEntryPoint() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        const modulePath = fileURLToPath(import.meta.url);
+        const argv1Real = realpathSync(argv1);
+        return argv1Real === modulePath;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/mobile.d.ts

@@ -0,0 +1,30 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export type MobilePlatform = "ios" | "android";
+export type ScreenElement = {
+    readonly [key: string]: unknown;
+};
+export type Screenshot = {
+    readonly data: Buffer;
+    readonly mimeType: string;
+};
+export type MobileClient = {
+    callTool(name: string, args?: Record<string, unknown>): Promise<CallToolResult>;
+    useDevice(name: string | undefined): void;
+    listDevices(): Promise<readonly ScreenElement[]>;
+    listElements(): Promise<readonly ScreenElement[]>;
+    click(x: number, y: number): Promise<void>;
+    typeKeys(text: string, submit?: boolean): Promise<void>;
+    pressButton(button: string): Promise<void>;
+    takeScreenshot(): Promise<Screenshot>;
+    saveScreenshot(absolutePath: string): Promise<void>;
+    close(): Promise<void>;
+};
+export type MobileClientOptions = {
+    command?: string;
+    args?: readonly string[];
+};
+export declare function createMobileClient(opts?: MobileClientOptions): Promise<MobileClient>;
+export declare function attachMobileClient(client: Client): MobileClient;
+export declare function isStubMobile(): boolean;
+//# sourceMappingURL=mobile.d.ts.map

package/dist/mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../src/mobile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAgBzE,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG;IAI1B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAKhF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,WAAW,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACjD,YAAY,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAK3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAGhC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AAmBF,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAY1F;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE/D;AAED,wBAAgB,YAAY,IAAI,OAAO,CAKtC"}

package/dist/mobile.js

@@ -0,0 +1,173 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { scrubbedEnv } from "./env.js";
+const DEFAULT_COMMAND = "npx";
+// Pinned to 0.0.54 (was @latest). mobile-mcp 0.0.55+ closes the stdio
+// connection during the MCP `initialize` handshake with our pinned
+// @modelcontextprotocol/sdk — reproduced 2026-05-23: 0.0.54 connects and
+// lists tools; 0.0.55 and 0.0.56 both fail with "MCP error -32000:
+// Connection closed" before any tool call. The wrapper's tool-shape parsing
+// (envelope/prefix handling, `submit`/`device` args) is also written against
+// 0.0.54. Re-validate the handshake + tool schemas (and likely bump the SDK)
+// before moving this version forward.
+const DEFAULT_ARGS = ["-y", "@mobilenext/mobile-mcp@0.0.54"];
+// Lazy: spawns mobile-mcp on call, returns a typed client. close() shuts
+// the subprocess down cleanly.
+//
+// Honors NATIVEAPPTEMPLATE_STUB_MOBILE=1 (and NATIVEAPPTEMPLATE_STUB_ALL=1)
+// to short-circuit to a no-op client so unit tests don't need a sim or an
+// npx download.
+export async function createMobileClient(opts) {
+    if (isStubMobile())
+        return createStubMobileClient();
+    const transport = new StdioClientTransport({
+        command: opts?.command ?? DEFAULT_COMMAND,
+        args: [...(opts?.args ?? DEFAULT_ARGS)],
+        env: scrubbedEnv(),
+        stderr: "pipe",
+    });
+    const client = new Client({ name: "nativeapptemplate-agent-stage2", version: "0.1.0" });
+    await client.connect(transport);
+    return attachMobileClient(client);
+}
+// Wraps an already-connected MCP Client. Exported so tests can pair the
+// wrapper with an in-memory MCP server impersonating mobile-mcp, without
+// spawning npx. Production callers should use createMobileClient().
+export function attachMobileClient(client) {
+    return wrapClient(client);
+}
+export function isStubMobile() {
+    return (process.env["NATIVEAPPTEMPLATE_STUB_ALL"] === "1" ||
+        process.env["NATIVEAPPTEMPLATE_STUB_MOBILE"] === "1");
+}
+// Tools that operate at the mobile-mcp server level rather than against
+// a specific device. These don't take a `device` argument and would
+// fail validation if we injected one.
+const DEVICE_INDEPENDENT_TOOLS = new Set([
+    "mobile_list_available_devices",
+]);
+function wrapClient(client) {
+    let activeDevice;
+    const callTool = async (name, args) => {
+        const merged = activeDevice !== undefined && !DEVICE_INDEPENDENT_TOOLS.has(name)
+            ? { device: activeDevice, ...(args ?? {}) }
+            : (args ?? {});
+        const result = (await client.callTool({
+            name,
+            arguments: merged,
+        }));
+        if (result.isError) {
+            throw new Error(`mobile-mcp ${name} failed: ${textOf(result)}`);
+        }
+        return result;
+    };
+    return {
+        callTool,
+        useDevice(name) {
+            activeDevice = name;
+        },
+        async listDevices() {
+            const result = await callTool("mobile_list_available_devices");
+            // mobile-mcp 0.0.54+ returns {"devices": [...]} (envelope object,
+            // not a bare array). Earlier behavior was a bare array. Accept
+            // either so the wrapper survives version drift in either direction.
+            const text = textOf(result);
+            if (!text)
+                return [];
+            try {
+                const parsed = JSON.parse(text);
+                if (Array.isArray(parsed))
+                    return parsed;
+                if (parsed && typeof parsed === "object" && Array.isArray(parsed.devices)) {
+                    return parsed.devices;
+                }
+                return [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async listElements() {
+            const result = await callTool("mobile_list_elements_on_screen");
+            // mobile-mcp 0.0.54 returns "Found these elements on screen: [...]"
+            // — a human-readable text prefix followed by a JSON array, not
+            // pure JSON. Slice from the first '[' so JSON.parse sees just
+            // the array. Defensive against the prefix being absent in other
+            // versions too.
+            const text = textOf(result);
+            if (!text)
+                return [];
+            const arrayStart = text.indexOf("[");
+            if (arrayStart === -1)
+                return [];
+            try {
+                const parsed = JSON.parse(text.slice(arrayStart));
+                return Array.isArray(parsed) ? parsed : [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async click(x, y) {
+            // mobile-mcp 0.0.54's iOS backend (mobilecli `io tap`) rejects
+            // non-integer coordinates. centerOf often produces .5 values for
+            // even-width elements; floor them at the tool boundary so callers
+            // don't have to think about it.
+            await callTool("mobile_click_on_screen_at_coordinates", {
+                x: Math.floor(x),
+                y: Math.floor(y),
+            });
+        },
+        async typeKeys(text, submit = false) {
+            // mobile-mcp 0.0.54 requires `submit: boolean` — passing only
+            // {text} fails Zod validation with "expected boolean, received
+            // undefined". Default false; opt in to true via the second
+            // arg when the caller wants the keyboard's return/submit key
+            // tapped after typing (form-submit / keyboard-dismiss).
+            await callTool("mobile_type_keys", { text, submit });
+        },
+        async pressButton(button) {
+            await callTool("mobile_press_button", { button });
+        },
+        async takeScreenshot() {
+            const result = await callTool("mobile_take_screenshot");
+            const image = (result.content ?? []).find((c) => c.type === "image");
+            if (!image || typeof image.data !== "string") {
+                throw new Error("mobile-mcp mobile_take_screenshot returned no image data");
+            }
+            return {
+                data: Buffer.from(image.data, "base64"),
+                mimeType: typeof image.mimeType === "string" ? image.mimeType : "image/png",
+            };
+        },
+        async saveScreenshot(absolutePath) {
+            await callTool("mobile_save_screenshot", { saveTo: absolutePath });
+        },
+        async close() {
+            await client.close();
+        },
+    };
+}
+function textOf(result) {
+    for (const c of result.content ?? []) {
+        if (c.type === "text" && typeof c.text === "string")
+            return c.text;
+    }
+    return "";
+}
+function createStubMobileClient() {
+    const stubResult = { content: [] };
+    return {
+        callTool: async () => stubResult,
+        useDevice: () => { },
+        listDevices: async () => [],
+        listElements: async () => [],
+        click: async () => { },
+        typeKeys: async (_text, _submit) => { },
+        pressButton: async () => { },
+        takeScreenshot: async () => ({ data: Buffer.alloc(0), mimeType: "image/png" }),
+        saveScreenshot: async () => { },
+        close: async () => { },
+    };
+}
+//# sourceMappingURL=mobile.js.map

package/dist/mobile.js.map

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

package/dist/rails-lifecycle.d.ts

@@ -0,0 +1,16 @@
+import { type ChildProcess } from "node:child_process";
+export type RailsHandle = {
+    readonly child: ChildProcess;
+    readonly url: string;
+    stop(): Promise<void>;
+};
+export type StartRailsInput = {
+    outDir: string;
+    host?: string;
+    port?: number;
+    readyTimeoutMs?: number;
+    shutdownGraceMs?: number;
+};
+export declare function startRails(input: StartRailsInput): Promise<RailsHandle>;
+export declare function waitForReady(host: string, port: number, timeoutMs: number, childExitedEarly?: () => boolean): Promise<boolean>;
+//# sourceMappingURL=rails-lifecycle.d.ts.map

package/dist/rails-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rails-lifecycle.d.ts","sourceRoot":"","sources":["../src/rails-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoB9D,MAAM,MAAM,WAAW,GAAG;IAGxB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IAIf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAKF,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAkG7E;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,OAAO,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgBlB"}