@eidra-umain/greenlight 0.1.0

package/dist/pilot/providers/index.d.ts

@@ -0,0 +1,10 @@
+import type { Provider } from "../../types.js";
+import type { LLMProvider } from "./types.js";
+export type { ChatMessage, ProviderConfig, LLMProvider } from "./types.js";
+/**
+ * Factory: create an LLMProvider by name.
+ * @param name - The provider identifier.
+ * @param baseUrlOverride - Optional override for the provider's base URL.
+ */
+export declare function createProvider(name: Provider, baseUrlOverride?: string): LLMProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/pilot/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pilot/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAK7C,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1E;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,QAAQ,EACd,eAAe,CAAC,EAAE,MAAM,GACtB,WAAW,CAqBb"}

package/dist/pilot/providers/index.js

@@ -0,0 +1,25 @@
+import { createOpenAICompatibleProvider } from "./openai-compatible.js";
+import { createAnthropicProvider } from "./anthropic.js";
+import { createGeminiProvider } from "./gemini.js";
+/**
+ * Factory: create an LLMProvider by name.
+ * @param name - The provider identifier.
+ * @param baseUrlOverride - Optional override for the provider's base URL.
+ */
+export function createProvider(name, baseUrlOverride) {
+    switch (name) {
+        case "openrouter":
+            return createOpenAICompatibleProvider(baseUrlOverride ?? "https://openrouter.ai/api/v1");
+        case "openai":
+            return createOpenAICompatibleProvider(baseUrlOverride ?? "https://api.openai.com/v1");
+        case "claude":
+            return createAnthropicProvider(baseUrlOverride ?? "https://api.anthropic.com");
+        case "gemini":
+            return createGeminiProvider(baseUrlOverride);
+        default: {
+            const _exhaustive = name;
+            throw new Error(`Unknown provider: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/pilot/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pilot/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAIlD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC7B,IAAc,EACd,eAAwB;IAExB,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,YAAY;YAChB,OAAO,8BAA8B,CACpC,eAAe,IAAI,8BAA8B,CACjD,CAAA;QACF,KAAK,QAAQ;YACZ,OAAO,8BAA8B,CACpC,eAAe,IAAI,2BAA2B,CAC9C,CAAA;QACF,KAAK,QAAQ;YACZ,OAAO,uBAAuB,CAC7B,eAAe,IAAI,2BAA2B,CAC9C,CAAA;QACF,KAAK,QAAQ;YACZ,OAAO,oBAAoB,CAAC,eAAe,CAAC,CAAA;QAC7C,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,IAAI,CAAA;YAC/B,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAC5D,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/pilot/providers/openai-compatible.d.ts

@@ -0,0 +1,7 @@
+import type { LLMProvider } from "./types.js";
+/**
+ * OpenAI-compatible chat completions provider.
+ * Works with OpenRouter, OpenAI, and any API that follows the same format.
+ */
+export declare function createOpenAICompatibleProvider(baseUrl: string): LLMProvider;
+//# sourceMappingURL=openai-compatible.d.ts.map

package/dist/pilot/providers/openai-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../../src/pilot/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,WAAW,EAAkB,MAAM,YAAY,CAAA;AAE1E;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAwC3E"}

package/dist/pilot/providers/openai-compatible.js

@@ -0,0 +1,34 @@
+/**
+ * OpenAI-compatible chat completions provider.
+ * Works with OpenRouter, OpenAI, and any API that follows the same format.
+ */
+export function createOpenAICompatibleProvider(baseUrl) {
+    const endpoint = `${baseUrl.replace(/\/+$/, "")}/chat/completions`;
+    return {
+        async chatCompletion(messages, config) {
+            const response = await fetch(endpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: config.model,
+                    messages,
+                    temperature: 0,
+                }),
+            });
+            if (!response.ok) {
+                const body = await response.text();
+                throw new Error(`LLM API error ${String(response.status)}: ${body}`);
+            }
+            const data = (await response.json());
+            const content = data.choices[0]?.message?.content;
+            if (!content) {
+                throw new Error("LLM returned empty response");
+            }
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/pilot/providers/openai-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.js","sourceRoot":"","sources":["../../../src/pilot/providers/openai-compatible.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC7D,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,CAAA;IAElE,OAAO;QACN,KAAK,CAAC,cAAc,CACnB,QAAuB,EACvB,MAAsB;YAEtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;gBACtC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACR,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;iBACxC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACpB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,QAAQ;oBACR,WAAW,EAAE,CAAC;iBACd,CAAC;aACF,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;gBAClC,MAAM,IAAI,KAAK,CACd,iBAAiB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CACnD,CAAA;YACF,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAA;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAA;YACjD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;YAC/C,CAAC;YAED,OAAO,OAAO,CAAA;QACf,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/pilot/providers/types.d.ts

@@ -0,0 +1,12 @@
+export interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ProviderConfig {
+    apiKey: string;
+    model: string;
+}
+export interface LLMProvider {
+    chatCompletion(messages: ChatMessage[], config: ProviderConfig): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pilot/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pilot/providers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC3B,cAAc,CACb,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAAA;CAClB"}

package/dist/pilot/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pilot/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/pilot/providers/types.ts"],"names":[],"mappings":""}

package/dist/pilot/response-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Parsing and validation for LLM responses.
+ */
+import type { Action } from "../reporter/types.js";
+/** A single planned step: the display label and either a pre-resolved action or null. */
+export interface PlannedStep {
+    step: string;
+    action: Action | null;
+    /** If true, this step needs runtime expansion into multiple sub-actions (e.g. form filling). */
+    needsExpansion?: boolean;
+    /** For REMEMBER steps: the variable name to store the captured value under. */
+    rememberAs?: string;
+    /** For COMPARE steps: the comparison metadata (variable + operator). Resolved at runtime. */
+    compare?: {
+        variable: string;
+        operator: string;
+    };
+}
+/** Parse a JSON string from the LLM into a validated Action. */
+export declare function parseActionResponse(raw: string): Action;
+/**
+ * Parse the planning LLM response (line-based format) into a flat list of PlannedSteps.
+ * One line per action — compound input steps produce multiple lines.
+ */
+export declare function parsePlanResponse(raw: string): PlannedStep[];
+/**
+ * Validate that every COMPARE in the plan references a REMEMBER that
+ * appears earlier. Returns an array of error messages (empty if valid).
+ */
+export declare function validatePlanReferences(plan: PlannedStep[]): string[];
+//# sourceMappingURL=response-parser.d.ts.map

package/dist/pilot/response-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parser.d.ts","sourceRoot":"","sources":["../../src/pilot/response-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6FAA6F;IAC7F,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAChD;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA+EvD;AAyFD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAgB5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAoBpE"}

package/dist/pilot/response-parser.js

@@ -0,0 +1,188 @@
+/**
+ * Parsing and validation for LLM responses.
+ */
+/** Parse a JSON string from the LLM into a validated Action. */
+export function parseActionResponse(raw) {
+    // Strip markdown code fences if the LLM wraps in ```json
+    let cleaned = raw.trim();
+    if (cleaned.startsWith("```")) {
+        cleaned = cleaned.replace(/^```(?:json)?\s*/, "").replace(/\s*```$/, "");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        throw new Error(`LLM returned invalid JSON: ${raw}`);
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        throw new Error(`LLM returned non-object JSON: ${raw}`);
+    }
+    const obj = parsed;
+    if (typeof obj.action !== "string" || obj.action.length === 0) {
+        throw new Error(`LLM response missing "action" field: ${raw}`);
+    }
+    const VALID_ACTIONS = [
+        "click",
+        "check",
+        "uncheck",
+        "type",
+        "select",
+        "autocomplete",
+        "scroll",
+        "navigate",
+        "press",
+        "wait",
+        "assert",
+        "remember",
+    ];
+    if (!VALID_ACTIONS.includes(obj.action)) {
+        throw new Error(`LLM returned unknown action "${obj.action}". Valid: ${VALID_ACTIONS.join(", ")}`);
+    }
+    const action = { action: obj.action };
+    if (typeof obj.ref === "string") {
+        action.ref = obj.ref;
+    }
+    if (typeof obj.text === "string") {
+        action.text = obj.text;
+    }
+    if (typeof obj.value === "string") {
+        action.value = obj.value;
+    }
+    if (typeof obj.option === "string") {
+        action.option = obj.option;
+    }
+    if (typeof obj.rememberAs === "string") {
+        action.rememberAs = obj.rememberAs;
+    }
+    if (typeof obj.compare === "object" && obj.compare !== null) {
+        const c = obj.compare;
+        if (typeof c.variable === "string" && typeof c.operator === "string") {
+            action.compare = {
+                variable: c.variable,
+                operator: c.operator,
+            };
+        }
+    }
+    if (typeof obj.assertion === "object" && obj.assertion !== null) {
+        const a = obj.assertion;
+        if (typeof a.type === "string" && typeof a.expected === "string") {
+            action.assertion = { type: a.type, expected: a.expected };
+        }
+    }
+    return action;
+}
+/**
+ * Parse a single action token from the plan response line format.
+ * Returns the action (or null for PAGE) and an optional description.
+ */
+function parsePlanAction(token) {
+    const t = token.trim();
+    // REMEMBER "description" as "variable_name"
+    const rememberMatch = /^remember\s+"([^"]+)"\s+as\s+"([^"]+)"$/i.exec(t);
+    if (rememberMatch) {
+        return {
+            action: null,
+            description: rememberMatch[1],
+            rememberAs: rememberMatch[2],
+        };
+    }
+    // COMPARE "description" "operator" remembered "variable_name"
+    // Returns action: null so it goes through resolveStep at runtime
+    // (needs the live page to find the element containing the current value).
+    // The compare metadata is stored on the PlannedStep for the pilot to use.
+    const compareMatch = /^compare\s+"([^"]+)"\s+"([^"]+)"\s+remembered\s+"([^"]+)"$/i.exec(t);
+    if (compareMatch) {
+        return {
+            action: null,
+            description: compareMatch[1],
+            compare: {
+                variable: compareMatch[3],
+                operator: compareMatch[2],
+            },
+        };
+    }
+    // EXPAND "description" — compound step needing runtime expansion
+    if (/^expand(?:\s|$)/i.test(t)) {
+        const after = t.slice(6).trim();
+        const description = after.replace(/^"(.*)"$/, "$1") || undefined;
+        return { action: null, description, needsExpansion: true };
+    }
+    // PAGE "description", PAGE description, or bare PAGE
+    if (/^page(?:\s|$)/i.test(t)) {
+        const after = t.slice(4).trim();
+        // Strip surrounding quotes if present
+        const description = after.replace(/^"(.*)"$/, "$1") || undefined;
+        return { action: null, description };
+    }
+    // assert <type> "<expected>"
+    const assertMatch = /^assert\s+(\S+)\s+"([^"]*)"$/i.exec(t);
+    if (assertMatch) {
+        return {
+            action: {
+                action: "assert",
+                assertion: { type: assertMatch[1], expected: assertMatch[2] },
+            },
+        };
+    }
+    // navigate "<url>"
+    const navMatch = /^navigate\s+"([^"]*)"$/i.exec(t);
+    if (navMatch) {
+        return { action: { action: "navigate", value: navMatch[1] } };
+    }
+    // press "<key>"
+    const pressMatch = /^press\s+"([^"]*)"$/i.exec(t);
+    if (pressMatch) {
+        return { action: { action: "press", value: pressMatch[1] } };
+    }
+    // scroll "<direction>"
+    const scrollMatch = /^scroll\s+"([^"]*)"$/i.exec(t);
+    if (scrollMatch) {
+        return { action: { action: "scroll", value: scrollMatch[1].toLowerCase() } };
+    }
+    // Unknown token — treat as page-dependent
+    return { action: null };
+}
+/**
+ * Parse the planning LLM response (line-based format) into a flat list of PlannedSteps.
+ * One line per action — compound input steps produce multiple lines.
+ */
+export function parsePlanResponse(raw) {
+    return raw
+        .trim()
+        .split("\n")
+        .filter((l) => l.trim().length > 0)
+        .map((line) => {
+        const { action, description, needsExpansion, rememberAs, compare } = parsePlanAction(line);
+        const step = description ?? line.trim();
+        return {
+            step,
+            action,
+            ...(needsExpansion ? { needsExpansion: true } : {}),
+            ...(rememberAs ? { rememberAs } : {}),
+            ...(compare ? { compare } : {}),
+        };
+    });
+}
+/**
+ * Validate that every COMPARE in the plan references a REMEMBER that
+ * appears earlier. Returns an array of error messages (empty if valid).
+ */
+export function validatePlanReferences(plan) {
+    const errors = [];
+    const remembered = new Set();
+    for (const step of plan) {
+        if (step.rememberAs) {
+            remembered.add(step.rememberAs);
+        }
+        const compare = step.compare ?? step.action?.compare;
+        if (compare) {
+            const varName = compare.variable;
+            if (!remembered.has(varName)) {
+                errors.push(`COMPARE references "${varName}" but no REMEMBER "${varName}" appears before it`);
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=response-parser.js.map

package/dist/pilot/response-parser.js.map

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

package/dist/pilot/state.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Page state capture: accessibility tree snapshots, screenshots, and console logs.
+ *
+ * Sub-modules:
+ *   - ./network.ts       — network idle tracking, console collector
+ *   - ./a11y-parser.ts   — a11y snapshot parsing with stable refs
+ *   - ./form-fields.ts   — form field capture and formatting
+ */
+import type { Page } from "playwright";
+import type { ConsoleEntry, PageState } from "../reporter/types.js";
+/**
+ * Capture the page state: a11y tree, URL, title, console logs.
+ * Screenshots are optional — skip them on pre-action captures to avoid
+ * triggering lazy-loaded elements (e.g. IntersectionObserver-based maps).
+ */
+export declare function capturePageState(page: Page, consoleDrain: () => ConsoleEntry[], options?: {
+    screenshot?: boolean;
+}): Promise<PageState>;
+//# sourceMappingURL=state.d.ts.map

package/dist/pilot/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/pilot/state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAKnE;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,MAAM,YAAY,EAAE,EAClC,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAAC,SAAS,CAAC,CAoDpB"}

package/dist/pilot/state.js

@@ -0,0 +1,67 @@
+/**
+ * Page state capture: accessibility tree snapshots, screenshots, and console logs.
+ *
+ * Sub-modules:
+ *   - ./network.ts       — network idle tracking, console collector
+ *   - ./a11y-parser.ts   — a11y snapshot parsing with stable refs
+ *   - ./form-fields.ts   — form field capture and formatting
+ */
+import { parseA11ySnapshot } from "./a11y-parser.js";
+// ── Orchestrator ──────────────────────────────────────────────────────
+/**
+ * Capture the page state: a11y tree, URL, title, console logs.
+ * Screenshots are optional — skip them on pre-action captures to avoid
+ * triggering lazy-loaded elements (e.g. IntersectionObserver-based maps).
+ */
+export async function capturePageState(page, consoleDrain, options) {
+    const takeScreenshot = options?.screenshot ?? false;
+    const [a11yRaw, screenshotBuffer, url, title] = await Promise.all([
+        page.locator("body").ariaSnapshot(),
+        takeScreenshot ? page.screenshot({ type: "png" }) : Promise.resolve(null),
+        Promise.resolve(page.url()),
+        page.title(),
+    ]);
+    const a11yTree = parseA11ySnapshot(a11yRaw);
+    // Capture all text content on the page. This supplements the a11y tree
+    // which can miss content rendered with non-semantic markup.
+    // We use textContent (not innerText) because innerText skips elements
+    // hidden by CSS transitions/animations that are still interactive.
+    // Script and style content is excluded.
+    let visibleText;
+    try {
+        const raw = await page.evaluate(() => {
+            function walk(node) {
+                if (node.nodeType === 3)
+                    return node.textContent ?? ""; // TEXT_NODE
+                if (node.nodeType !== 1)
+                    return ""; // Only process ELEMENT_NODE
+                const el = node;
+                const tag = el.tagName;
+                if (tag === "SCRIPT" || tag === "STYLE" || tag === "NOSCRIPT")
+                    return "";
+                const parts = [];
+                for (const child of el.childNodes) {
+                    parts.push(walk(child));
+                }
+                return parts.join("");
+            }
+            return walk(document.body);
+        });
+        // Collapse whitespace runs into single spaces, trim blank lines
+        visibleText =
+            raw
+                .split("\n")
+                .map((l) => l.replace(/\s+/g, " ").trim())
+                .filter((l) => l.length > 0)
+                .join("\n") || undefined;
+    }
+    catch {
+        // Skip if page is mid-navigation
+    }
+    const screenshot = screenshotBuffer
+        ? screenshotBuffer.toString("base64")
+        : undefined;
+    const consoleLogs = consoleDrain();
+    return { a11yTree, a11yRaw, visibleText, screenshot, url, title, consoleLogs };
+}
+//# sourceMappingURL=state.js.map

package/dist/pilot/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/pilot/state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,IAAU,EACV,YAAkC,EAClC,OAAkC;IAElC,MAAM,cAAc,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAA;IAEnD,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE;QACnC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACzE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE;KACZ,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAE3C,uEAAuE;IACvE,4DAA4D;IAC5D,sEAAsE;IACtE,mEAAmE;IACnE,wCAAwC;IACxC,IAAI,WAA+B,CAAA;IACnC,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACpC,SAAS,IAAI,CAAC,IAAU;gBACvB,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA,CAAC,YAAY;gBACnE,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAA,CAAC,4BAA4B;gBAC/D,MAAM,EAAE,GAAG,IAAe,CAAA;gBAC1B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAA;gBACtB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,UAAU;oBAC5D,OAAO,EAAE,CAAA;gBACV,MAAM,KAAK,GAAa,EAAE,CAAA;gBAC1B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;oBACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;gBACxB,CAAC;gBACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACtB,CAAC;YACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;QACF,gEAAgE;QAChE,WAAW;YACV,GAAG;iBACD,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;iBACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACR,iCAAiC;IAClC,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB;QAClC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACrC,CAAC,CAAC,SAAS,CAAA;IACZ,MAAM,WAAW,GAAG,YAAY,EAAE,CAAA;IAElC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;AAC/E,CAAC"}

package/dist/pilot/trace.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Trace logger — logs timestamped browser and pilot events for performance analysis.
+ * Enabled with --trace. Attaches to Playwright page events and provides
+ * a log() function for manual instrumentation.
+ */
+import type { Page } from "playwright";
+export interface TraceLogger {
+    log(event: string, detail?: string): void;
+    attachToPage(page: Page): void;
+    detachFromPage(page: Page): void;
+}
+/**
+ * Create a trace logger. If enabled is false, returns a no-op logger.
+ */
+export declare function createTraceLogger(enabled: boolean): TraceLogger;
+//# sourceMappingURL=trace.d.ts.map

package/dist/pilot/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/pilot/trace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,WAAW;IAC3B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAC9B,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAChC;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CA8H/D"}

package/dist/pilot/trace.js

@@ -0,0 +1,117 @@
+/**
+ * Trace logger — logs timestamped browser and pilot events for performance analysis.
+ * Enabled with --trace. Attaches to Playwright page events and provides
+ * a log() function for manual instrumentation.
+ */
+const GREY = "\x1b[90m";
+const RESET = "\x1b[0m";
+/**
+ * Create a trace logger. If enabled is false, returns a no-op logger.
+ */
+export function createTraceLogger(enabled) {
+    if (!enabled) {
+        return {
+            log() {
+                // no-op
+            },
+            attachToPage() {
+                // no-op
+            },
+            detachFromPage() {
+                // no-op
+            },
+        };
+    }
+    const startTime = performance.now();
+    function ts() {
+        return String(Math.round(performance.now() - startTime)).padStart(7, " ");
+    }
+    function log(event, detail) {
+        const d = detail ? ` ${detail}` : "";
+        console.log(`${GREY}[${ts()}ms] ${event}${d}${RESET}`);
+    }
+    /** URL patterns for media/third-party resources to exclude from trace. */
+    const NOISE_PATTERNS = [
+        /\.pmtiles/,
+        /\.pbf$/,
+        /\.png$/,
+        /\.jpg$/,
+        /\.jpeg$/,
+        /\.gif$/,
+        /\.svg$/,
+        /\.webp$/,
+        /\.woff2?$/,
+        /\.ttf$/,
+        /\.mp4$/,
+        /\.webm$/,
+        /googlesyndication\.com/,
+        /googletagmanager\.com/,
+        /google-analytics\.com/,
+        /cookiebot\.com/,
+        /protomaps\.github\.io/,
+    ];
+    function isNoise(url) {
+        return NOISE_PATTERNS.some((p) => p.test(url));
+    }
+    // Store bound handlers so we can remove them
+    const handlers = new WeakMap();
+    function attachToPage(page) {
+        const h = {
+            framenavigated: (frame) => {
+                const f = frame;
+                if (!f.parentFrame()) {
+                    log("navigation", f.url());
+                }
+            },
+            load: () => {
+                log("page:load");
+            },
+            domcontentloaded: () => {
+                log("page:domcontentloaded");
+            },
+            request: (req) => {
+                const r = req;
+                const type = r.resourceType();
+                if ((type === "document" || type === "xhr" || type === "fetch") &&
+                    !isNoise(r.url())) {
+                    log(`request:${type}`, r.url());
+                }
+            },
+            response: (res) => {
+                const r = res;
+                const type = r.request().resourceType();
+                if ((type === "document" || type === "xhr" || type === "fetch") &&
+                    !isNoise(r.url())) {
+                    log(`response:${type}`, `${String(r.status())} ${r.url()}`);
+                }
+            },
+            console: (msg) => {
+                const m = msg;
+                if (m.type() === "error") {
+                    log("console:error", m.text());
+                }
+            },
+        };
+        handlers.set(page, h);
+        page.on("framenavigated", h.framenavigated);
+        page.on("load", h.load);
+        page.on("domcontentloaded", h.domcontentloaded);
+        page.on("request", h.request);
+        page.on("response", h.response);
+        page.on("console", h.console);
+    }
+    function detachFromPage(page) {
+        const h = handlers.get(page);
+        if (!h)
+            return;
+        page.off("framenavigated", h.framenavigated);
+        page.off("load", h.load);
+        page.off("domcontentloaded", h.domcontentloaded);
+        page.off("request", h.request);
+        page.off("response", h.response);
+        page.off("console", h.console);
+        handlers.delete(page);
+    }
+    return { log, attachToPage, detachFromPage };
+}
+//# sourceMappingURL=trace.js.map

package/dist/pilot/trace.js.map

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

package/dist/planner/hasher.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hashing and slug utilities for cached test plans.
+ */
+/**
+ * Compute a SHA-256 hash of a test case's effective definition.
+ * The input should be the fully resolved test case (after variable
+ * interpolation and reusable step expansion).
+ */
+export declare function computeTestHash(testCase: {
+    steps: string[];
+}): string;
+/** Convert a name to a URL/filesystem-safe kebab-case slug. */
+export declare function slugify(name: string): string;
+//# sourceMappingURL=hasher.d.ts.map

package/dist/planner/hasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/planner/hasher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAGrE;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C"}

package/dist/planner/hasher.js

@@ -0,0 +1,21 @@
+/**
+ * Hashing and slug utilities for cached test plans.
+ */
+import { createHash } from "node:crypto";
+/**
+ * Compute a SHA-256 hash of a test case's effective definition.
+ * The input should be the fully resolved test case (after variable
+ * interpolation and reusable step expansion).
+ */
+export function computeTestHash(testCase) {
+    const content = JSON.stringify(testCase.steps);
+    return createHash("sha256").update(content).digest("hex");
+}
+/** Convert a name to a URL/filesystem-safe kebab-case slug. */
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+//# sourceMappingURL=hasher.js.map