nativeapptemplate-agent 0.1.1 → 0.2.0

package/dist/validation/stage2-judge.js

@@ -0,0 +1,204 @@
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { runStage2Scenario } from "./stage2.js";
+import { runLayer3 } from "./layer3.js";
+import { createMobileClient } from "../mobile.js";
+// Stage 2 rubric — domain content (because we've now navigated to the
+// list/detail view past auth) plus a defensive substrate-leak check.
+// Stage 1's "renders cleanly" criterion is intentionally not repeated;
+// if the app crashed Layer 2 build mode would have caught it.
+export const DEFAULT_STAGE2_RUBRIC = [
+    {
+        id: "domain-content",
+        question: "Does this screen show the user's domain content (a list with at least one user-created entry, or a detail view of one such entry, with that entry's state badge visible)? PASS if there's a visible list/detail item the user just created. FAIL if it shows only a launch / welcome / login / signup / empty state.",
+    },
+    {
+        id: "no-substrate-leak",
+        question: "Is the screen free of substrate-original tokens like 'Shop', 'Shopkeeper', 'ItemTag', 'NativeAppTemplate', or 'Number Tag'?",
+    },
+];
+export async function runStage2Visual(input) {
+    const screenshotDir = input.screenshotDir ?? join(process.cwd(), "tmp", "screenshots");
+    await mkdir(screenshotDir, { recursive: true });
+    const rubric = input.rubric ?? DEFAULT_STAGE2_RUBRIC;
+    const result = {};
+    if (input.iosScenario) {
+        result.ios = await runOnePlatform({
+            platform: "ios",
+            scenario: input.iosScenario,
+            screenshotDir,
+            spec: input.spec,
+            rubric,
+            ...(input.iosClient !== undefined ? { client: input.iosClient } : {}),
+        });
+    }
+    if (input.androidScenario) {
+        result.android = await runOnePlatform({
+            platform: "android",
+            scenario: input.androidScenario,
+            screenshotDir,
+            spec: input.spec,
+            rubric,
+            ...(input.androidClient !== undefined ? { client: input.androidClient } : {}),
+        });
+    }
+    return result;
+}
+async function runOnePlatform(args) {
+    const ownsClient = args.client === undefined;
+    const client = args.client ?? (await createMobileClient());
+    try {
+        // mobile-mcp requires a `device` argument on every tool call.
+        // Bootstrap: list available devices, pick the right one for this
+        // platform, set it as the active device on the wrapper. Subsequent
+        // calls inject device transparently.
+        const targetingErr = await selectDevice(client, args.platform);
+        if (targetingErr) {
+            return {
+                pass: false,
+                scenarioName: args.scenario.name,
+                stepCount: args.scenario.steps.length,
+                stepsPassed: 0,
+                screenshots: [],
+                error: targetingErr,
+            };
+        }
+        const scenario = await runStage2Scenario({
+            client,
+            scenario: args.scenario,
+            screenshotDir: args.screenshotDir,
+        });
+        const baseReport = toBaseReport(scenario);
+        // Run Layer 3 on the LAST captured screenshot even if a later
+        // scenario step failed — a partial walk that reached the domain
+        // content is still worth scoring. Stage2PlatformReport.pass
+        // remains gated on scenario.ok && layer3.pass below, so partial
+        // walks don't sneak through as overall PASS.
+        if (scenario.screenshots.length === 0) {
+            return baseReport;
+        }
+        const representative = scenario.screenshots[scenario.screenshots.length - 1];
+        const layer3 = await runLayer3({
+            screenshotPath: representative,
+            rubric: args.rubric,
+            spec: args.spec,
+        });
+        return {
+            ...baseReport,
+            pass: scenario.ok && layer3.pass,
+            representativeScreenshot: representative,
+            layer3Scores: layer3.scores,
+        };
+    }
+    finally {
+        if (ownsClient)
+            await client.close();
+    }
+}
+// Picks the mobile-mcp device for a platform and sets it as active on
+// the wrapper. Returns undefined on success, an error string on
+// failure. Heuristic: filter listDevices() by platform field if
+// available; otherwise filter by a substring match on the name (iOS
+// names tend to start with "iPhone"/"iPad"; Android emulators with
+// "emulator-"). Honors NATIVEAPPTEMPLATE_MOBILE_<IOS|ANDROID>_DEVICE
+// env var as an override for explicit targeting.
+export async function selectDevice(client, platform) {
+    const overrideKey = platform === "ios" ? "NATIVEAPPTEMPLATE_MOBILE_IOS_DEVICE" : "NATIVEAPPTEMPLATE_MOBILE_ANDROID_DEVICE";
+    const override = process.env[overrideKey];
+    let devices;
+    try {
+        devices = await client.listDevices();
+    }
+    catch (err) {
+        // Discovery failed. If an override is set, fall back to using it raw as a
+        // best-effort escape hatch; otherwise surface the failure.
+        if (override) {
+            client.useDevice(override);
+            return undefined;
+        }
+        return `mobile-mcp listDevices failed: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    if (override) {
+        // Resolve the override against the device list, matching either the
+        // canonical id or the display name, and pass the id onward. mobile-mcp's
+        // per-device tools require the id (UDID for iOS sims, serial for Android);
+        // a display name like "iPhone 17" passed raw fails every call with
+        // "Device not found" (and the wrapper reads that as 0 elements). Map
+        // name -> id here instead of trusting the override string blindly.
+        const hit = devices.find((d) => deviceMatchesHandle(d, override));
+        if (hit) {
+            const id = deviceNameOf(hit);
+            if (id) {
+                client.useDevice(id);
+                return undefined;
+            }
+        }
+        const seen = devices.map((d) => deviceNameOf(d) ?? "<unnamed>").join(", ");
+        return `${overrideKey}="${override}" matched no booted device (saw: ${seen}). Pass the device id or its exact name.`;
+    }
+    if (devices.length === 0) {
+        return `no mobile-mcp devices available (boot the ${platform} sim/emulator first)`;
+    }
+    const match = devices.find((d) => devicePlatformMatches(d, platform));
+    if (!match) {
+        const names = devices.map((d) => deviceNameOf(d) ?? "<unnamed>").join(", ");
+        return `no mobile-mcp device matched platform=${platform} (saw: ${names}). Override with ${overrideKey}=<device-name-or-id>.`;
+    }
+    const name = deviceNameOf(match);
+    if (!name) {
+        return `mobile-mcp returned a matching device with no usable name field`;
+    }
+    client.useDevice(name);
+    return undefined;
+}
+// True if `handle` equals any of the device's identifying fields — used to
+// resolve a user-supplied override (which may be a display name OR an id)
+// against mobile-mcp's device list.
+function deviceMatchesHandle(d, handle) {
+    for (const key of ["id", "udid", "serial", "name", "deviceName"]) {
+        if (d[key] === handle)
+            return true;
+    }
+    return false;
+}
+function deviceNameOf(d) {
+    // mobile-mcp's response carries both `id` (canonical handle — UDID
+    // for iOS sims, serial for Android emulators/devices) and `name`
+    // (display name like "Pixel 6", "iPhone 17"). Pass the canonical id
+    // to the `device` parameter on subsequent tool calls — it's
+    // unambiguous when multiple devices share a display name.
+    for (const key of ["id", "udid", "serial", "name", "deviceName"]) {
+        const v = d[key];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    return undefined;
+}
+function devicePlatformMatches(d, platform) {
+    // Direct platform field is the easy case.
+    for (const key of ["platform", "type", "os"]) {
+        const v = d[key];
+        if (typeof v === "string" && v.toLowerCase().includes(platform))
+            return true;
+    }
+    // Fallback: heuristic on the name.
+    const name = deviceNameOf(d) ?? "";
+    if (platform === "ios")
+        return /^(iPhone|iPad|iPod)/i.test(name);
+    return /^(emulator-|Android|Pixel|Galaxy|Nexus)/i.test(name);
+}
+function toBaseReport(scenario) {
+    const stepsPassed = scenario.steps.filter((s) => s.ok).length;
+    const failingError = scenario.steps.find((s) => !s.ok)?.error;
+    const report = {
+        pass: scenario.ok,
+        scenarioName: scenario.scenarioName,
+        stepCount: scenario.steps.length,
+        stepsPassed,
+        screenshots: scenario.screenshots,
+    };
+    if (failingError !== undefined)
+        report.error = failingError;
+    return report;
+}
+//# sourceMappingURL=stage2-judge.js.map

package/dist/validation/stage2-judge.js.map

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

package/dist/validation/stage2.d.ts

@@ -0,0 +1,73 @@
+import type { MobileClient } from "../mobile.js";
+export type Stage2Step = {
+    kind: "wait_for_text";
+    text: string;
+    timeoutMs?: number;
+    exact?: boolean;
+} | {
+    kind: "tap_text";
+    text: string;
+    timeoutMs?: number;
+    optional?: boolean;
+    exact?: boolean;
+} | {
+    kind: "tap_coordinates";
+    x: number;
+    y: number;
+    label?: string;
+} | {
+    kind: "tap_below_text";
+    text: string;
+    offsetY?: number;
+    timeoutMs?: number;
+} | {
+    kind: "type";
+    text: string;
+    submit?: boolean;
+} | {
+    kind: "press_button";
+    button: string;
+    optional?: boolean;
+} | {
+    kind: "screenshot";
+    label: string;
+} | {
+    kind: "assert_text";
+    text: string;
+} | {
+    kind: "rails_runner";
+    outDir: string;
+    ruby: string;
+    label?: string;
+    timeoutMs?: number;
+} | {
+    kind: "tap_field";
+    fieldTypes: readonly string[];
+    nth?: number;
+};
+export type Stage2Scenario = {
+    name: string;
+    steps: readonly Stage2Step[];
+};
+export type Stage2StepResult = {
+    step: Stage2Step;
+    ok: boolean;
+    durationMs: number;
+    error?: string;
+    screenshotPath?: string;
+};
+export type Stage2Result = {
+    ok: boolean;
+    scenarioName: string;
+    steps: readonly Stage2StepResult[];
+    screenshots: readonly string[];
+};
+export type Stage2Input = {
+    client: MobileClient;
+    scenario: Stage2Scenario;
+    screenshotDir: string;
+    pollIntervalMs?: number;
+    defaultWaitMs?: number;
+};
+export declare function runStage2Scenario(input: Stage2Input): Promise<Stage2Result>;
+//# sourceMappingURL=stage2.d.ts.map

package/dist/validation/stage2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage2.d.ts","sourceRoot":"","sources":["../../src/validation/stage2.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,cAAc,CAAC;AAsBhE,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAS5E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAKjE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAI9E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAOrC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAW1F;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAKF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAkDjF"}

package/dist/validation/stage2.js

@@ -0,0 +1,313 @@
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { setTimeout as sleep } from "node:timers/promises";
+import { scrubbedEnv } from "../env.js";
+const DEFAULT_POLL_INTERVAL_MS = 500;
+const DEFAULT_WAIT_MS = 10_000;
+export async function runStage2Scenario(input) {
+    await mkdir(input.screenshotDir, { recursive: true });
+    const pollMs = input.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const waitMs = input.defaultWaitMs ?? DEFAULT_WAIT_MS;
+    const stepResults = [];
+    const screenshots = [];
+    let ok = true;
+    for (let i = 0; i < input.scenario.steps.length; i++) {
+        const step = input.scenario.steps[i];
+        const started = Date.now();
+        try {
+            const screenshotPath = await runStep({
+                step,
+                index: i,
+                client: input.client,
+                scenario: input.scenario,
+                screenshotDir: input.screenshotDir,
+                pollMs,
+                waitMs,
+            });
+            const result = {
+                step,
+                ok: true,
+                durationMs: Date.now() - started,
+            };
+            if (screenshotPath) {
+                result.screenshotPath = screenshotPath;
+                screenshots.push(screenshotPath);
+            }
+            stepResults.push(result);
+        }
+        catch (err) {
+            ok = false;
+            stepResults.push({
+                step,
+                ok: false,
+                durationMs: Date.now() - started,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            break;
+        }
+    }
+    return {
+        ok,
+        scenarioName: input.scenario.name,
+        steps: stepResults,
+        screenshots,
+    };
+}
+async function runStep(a) {
+    switch (a.step.kind) {
+        case "wait_for_text": {
+            await waitForText(a.client, a.step.text, a.step.timeoutMs ?? a.waitMs, a.pollMs, undefined, a.step.exact);
+            return undefined;
+        }
+        case "tap_text": {
+            // Prefer a Button-typed match when multiple elements share the
+            // text — tap_text implies tapping something interactive, and
+            // pages often duplicate copy between a StaticText header and a
+            // Button at the bottom (e.g. iOS sign-up form has both).
+            const optional = a.step.optional === true;
+            try {
+                const el = await waitForText(a.client, a.step.text, a.step.timeoutMs ?? a.waitMs, a.pollMs, "Button", a.step.exact);
+                const center = centerOf(el);
+                if (!center)
+                    throw new Error(`tap_text "${a.step.text}": found element but could not extract coordinates`);
+                await a.client.click(center.x, center.y);
+            }
+            catch (err) {
+                if (optional)
+                    return undefined;
+                throw err;
+            }
+            return undefined;
+        }
+        case "tap_coordinates": {
+            await a.client.click(a.step.x, a.step.y);
+            return undefined;
+        }
+        case "tap_below_text": {
+            const el = await waitForText(a.client, a.step.text, a.step.timeoutMs ?? a.waitMs, a.pollMs);
+            const center = centerOf(el);
+            if (!center)
+                throw new Error(`tap_below_text "${a.step.text}": found element but could not extract coordinates`);
+            const labelHeight = labelHeightOf(el) ?? 0;
+            const offsetY = a.step.offsetY ?? 30;
+            // Bias to the center of where the field below typically sits:
+            // labelCenter.y + labelHeight/2 (bottom of label) + offsetY.
+            const targetY = center.y + labelHeight / 2 + offsetY;
+            await a.client.click(center.x, targetY);
+            return undefined;
+        }
+        case "type": {
+            await a.client.typeKeys(a.step.text, a.step.submit ?? false);
+            return undefined;
+        }
+        case "press_button": {
+            try {
+                await a.client.pressButton(a.step.button);
+            }
+            catch (err) {
+                if (a.step.optional)
+                    return undefined;
+                throw err;
+            }
+            return undefined;
+        }
+        case "screenshot": {
+            const filename = `${slug(a.scenario.name)}-${pad(a.index)}-${slug(a.step.label)}.png`;
+            const path = join(a.screenshotDir, filename);
+            await a.client.saveScreenshot(path);
+            return path;
+        }
+        case "assert_text": {
+            const elements = await a.client.listElements();
+            if (!findByText(elements, a.step.text)) {
+                throw new Error(`assert_text "${a.step.text}": not visible on screen`);
+            }
+            return undefined;
+        }
+        case "rails_runner": {
+            await runRailsRunner(a.step.outDir, a.step.ruby, a.step.timeoutMs ?? 30_000, a.step.label);
+            return undefined;
+        }
+        case "tap_field": {
+            const fieldTypes = a.step.fieldTypes.map((t) => t.toLowerCase());
+            const rawNth = a.step.nth ?? 0;
+            const elements = await a.client.listElements();
+            const matches = elements.filter((el) => {
+                const t = el["type"];
+                if (typeof t !== "string")
+                    return false;
+                const lower = t.toLowerCase();
+                return fieldTypes.some((ft) => lower.includes(ft));
+            });
+            // Negative nth counts from the end (Python-style). Useful for
+            // cross-platform forms where the same fieldTypes list yields a
+            // different number of matches per platform: iOS Sign In has 1
+            // SecureTextField; Android has 2 EditText (Email + Password).
+            // nth=-1 = "last match" = password on both.
+            const nth = rawNth < 0 ? matches.length + rawNth : rawNth;
+            const target = matches[nth];
+            if (!target) {
+                throw new Error(`tap_field [${a.step.fieldTypes.join(",")}] (nth=${rawNth}, resolved=${nth}): no element matched (saw ${matches.length} of these types out of ${elements.length} total)`);
+            }
+            const center = centerOf(target);
+            if (!center)
+                throw new Error(`tap_field [${a.step.fieldTypes.join(",")}]: found element but could not extract coordinates`);
+            await a.client.click(center.x, center.y);
+            return undefined;
+        }
+    }
+}
+async function runRailsRunner(outDir, ruby, timeoutMs, label) {
+    await new Promise((resolveStep, rejectStep) => {
+        const child = spawn("mise", ["exec", "--", "bin/rails", "runner", ruby], {
+            cwd: outDir,
+            env: scrubbedEnv(),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const out = [];
+        child.stdout?.on("data", (c) => out.push(c.toString("utf8")));
+        child.stderr?.on("data", (c) => out.push(c.toString("utf8")));
+        const timer = setTimeout(() => child.kill("SIGTERM"), timeoutMs);
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolveStep();
+            else
+                rejectStep(new Error(`rails_runner${label ? ` (${label})` : ""} exited ${code}: ${out.join("").slice(-500)}`));
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            rejectStep(err);
+        });
+    });
+}
+async function waitForText(client, text, timeoutMs, pollMs, preferType, exact) {
+    const deadline = Date.now() + timeoutMs;
+    let lastSeen = 0;
+    while (Date.now() < deadline) {
+        const elements = await client.listElements();
+        lastSeen = elements.length;
+        const match = findByText(elements, text, preferType, exact);
+        if (match)
+            return match;
+        await sleep(pollMs);
+    }
+    throw new Error(`wait_for_text "${text}": not found within ${timeoutMs}ms (last poll saw ${lastSeen} elements)`);
+}
+const TEXT_FIELDS = ["label", "name", "text", "value", "title", "accessibilityLabel", "placeholder", "identifier"];
+function findByText(elements, needle, preferType, exact) {
+    const target = needle.toLowerCase();
+    const matches = [];
+    for (const el of elements) {
+        for (const field of TEXT_FIELDS) {
+            const v = el[field];
+            if (typeof v !== "string")
+                continue;
+            const lower = v.toLowerCase();
+            const hit = exact ? lower === target : lower.includes(target);
+            if (hit) {
+                matches.push(el);
+                break;
+            }
+        }
+    }
+    if (matches.length === 0)
+        return undefined;
+    // When the same text appears on multiple elements (e.g. "Sign Up"
+    // shows up as both a StaticText page-header AND a Button at the
+    // bottom of the form), prefer the typed match the caller asked for
+    // — typically Button for tappable intents. preferType is a
+    // case-insensitive substring match so it covers both iOS ("Button")
+    // and Android ("android.widget.Button") type strings.
+    if (preferType) {
+        const want = preferType.toLowerCase();
+        const typed = matches.find((el) => {
+            const t = el["type"];
+            return typeof t === "string" && t.toLowerCase().includes(want);
+        });
+        if (typed)
+            return typed;
+        // preferType was asked but didn't match — common on Android
+        // Compose where a submit "Button" is rendered as TextView instead
+        // of a typed widget. Fall back to the bottom-most match (submit
+        // buttons sit below page headers in every form pattern we've
+        // seen). Only do this when preferType was specified — otherwise
+        // bottom-most would pick validation messages over labels for
+        // cases like wait_for_text "Password" on a form.
+        if (matches.length > 1) {
+            const withY = matches.map((el) => ({ el, y: topYOf(el) ?? 0 }));
+            withY.sort((a, b) => b.y - a.y);
+            return withY[0].el;
+        }
+    }
+    return matches[0];
+}
+function topYOf(element) {
+    const candidates = [
+        element,
+        element["coordinates"] ?? {},
+        element["rect"] ?? {},
+        element["bounds"] ?? {},
+        element["frame"] ?? {},
+    ];
+    for (const c of candidates) {
+        const y = numberAt(c, "y");
+        if (y !== undefined)
+            return y;
+    }
+    return undefined;
+}
+// mobile-mcp's element shape varies by platform: iOS often returns a flat
+// {x, y, width, height}; Android sometimes nests under {rect: {...}} or
+// {bounds: {...}}. Probe the common shapes; return undefined if none match.
+function centerOf(element) {
+    const candidates = [
+        element,
+        // mobile-mcp 0.0.54 nests under `coordinates: {x,y,width,height}`.
+        // iOS/Android variants have used `rect`, `bounds`, `frame` over time.
+        element["coordinates"] ?? {},
+        element["rect"] ?? {},
+        element["bounds"] ?? {},
+        element["frame"] ?? {},
+    ];
+    for (const c of candidates) {
+        const x = numberAt(c, "x");
+        const y = numberAt(c, "y");
+        const w = numberAt(c, "width") ?? numberAt(c, "w");
+        const h = numberAt(c, "height") ?? numberAt(c, "h");
+        if (x !== undefined && y !== undefined && w !== undefined && h !== undefined) {
+            return { x: x + w / 2, y: y + h / 2 };
+        }
+        if (x !== undefined && y !== undefined) {
+            return { x, y };
+        }
+    }
+    return undefined;
+}
+function labelHeightOf(element) {
+    const candidates = [
+        element,
+        element["coordinates"] ?? {},
+        element["rect"] ?? {},
+        element["bounds"] ?? {},
+        element["frame"] ?? {},
+    ];
+    for (const c of candidates) {
+        const h = numberAt(c, "height") ?? numberAt(c, "h");
+        if (h !== undefined)
+            return h;
+    }
+    return undefined;
+}
+function numberAt(obj, key) {
+    const v = obj[key];
+    return typeof v === "number" ? v : undefined;
+}
+function slug(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "step";
+}
+function pad(n) {
+    return n.toString().padStart(2, "0");
+}
+//# sourceMappingURL=stage2.js.map

package/dist/validation/stage2.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare function readPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAOA,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C"}

package/dist/version.js

@@ -0,0 +1,17 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+// Read the agent's version from the published package.json. Resolves
+// relative to the compiled module (dist/version.js → ../package.json),
+// so it works under `npx`, global installs, and local dev alike.
+export function readPackageVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(resolve(here, "..", "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,qEAAqE;AACrE,uEAAuE;AACvE,iEAAiE;AACjE,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAClF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC"}