cairn-engine 0.1.0

package/dist/adapters/drivers/self-heal.js.map

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

package/dist/adapters/llm/anthropic.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LlmClient backed by the Anthropic Messages API (ANTHROPIC_API_KEY) — the standalone
+ * default once a user supplies a key. Uses fetch to avoid an SDK dependency.
+ */
+import type { CompleteOptions, LlmClient } from "../../core/ports.js";
+export interface AnthropicOptions {
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+}
+export declare class AnthropicLlmClient implements LlmClient {
+    readonly id: string;
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(opts?: AnthropicOptions);
+    complete(prompt: string, opts?: CompleteOptions): Promise<string>;
+}

package/dist/adapters/llm/anthropic.js

@@ -0,0 +1,41 @@
+export class AnthropicLlmClient {
+    id;
+    apiKey;
+    model;
+    baseUrl;
+    constructor(opts = {}) {
+        const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+        if (!apiKey)
+            throw new Error("AnthropicLlmClient requires ANTHROPIC_API_KEY");
+        this.apiKey = apiKey;
+        this.model = opts.model ?? "claude-sonnet-4-6";
+        this.baseUrl = opts.baseUrl ?? "https://api.anthropic.com";
+        this.id = `anthropic:${this.model}`;
+    }
+    async complete(prompt, opts = {}) {
+        const res = await fetch(`${this.baseUrl}/v1/messages`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "x-api-key": this.apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: opts.maxTokens ?? 1024,
+                ...(opts.system ? { system: opts.system } : {}),
+                messages: [{ role: "user", content: prompt }],
+            }),
+        });
+        if (!res.ok) {
+            throw new Error(`Anthropic API ${res.status}: ${await res.text()}`);
+        }
+        const data = (await res.json());
+        return (data.content ?? [])
+            .filter((c) => c.type === "text" && typeof c.text === "string")
+            .map((c) => c.text)
+            .join("")
+            .trim();
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/adapters/llm/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/adapters/llm/anthropic.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,kBAAkB;IACpB,EAAE,CAAS;IACH,MAAM,CAAS;IACf,KAAK,CAAS;IACd,OAAO,CAAS;IAEjC,YAAY,OAAyB,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC5D,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,mBAAmB,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,2BAA2B,CAAC;QAC3D,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAwB,EAAE;QACvD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,cAAc,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM;gBACxB,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;gBAClC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAC9C,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqB,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,EAAE,CAAC;aACR,IAAI,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/adapters/llm/claude-code.d.ts

@@ -0,0 +1,14 @@
+import type { CompleteOptions, LlmClient } from "../../core/ports.js";
+export interface ClaudeCodeOptions {
+    model?: string;
+    bin?: string;
+    timeoutMs?: number;
+}
+export declare class ClaudeCodeLlmClient implements LlmClient {
+    readonly id: string;
+    private readonly model;
+    private readonly bin;
+    private readonly timeoutMs;
+    constructor(opts?: ClaudeCodeOptions);
+    complete(prompt: string, opts?: CompleteOptions): Promise<string>;
+}

package/dist/adapters/llm/claude-code.js

@@ -0,0 +1,48 @@
+/**
+ * LlmClient backed by the local Claude Code CLI (`claude -p`) — the default when no API key
+ * is set: it reuses an installed Claude Code's auth, no extra credentials. Swappable for
+ * AnthropicLlmClient via `createLlmClient` (invariant #5).
+ */
+import { spawn } from "node:child_process";
+export class ClaudeCodeLlmClient {
+    id;
+    model;
+    bin;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.model = opts.model ?? "sonnet";
+        this.bin = opts.bin ?? "claude";
+        this.timeoutMs = opts.timeoutMs ?? 120_000;
+        this.id = `claude-code:${this.model}`;
+    }
+    async complete(prompt, opts = {}) {
+        const args = ["-p", "--model", this.model];
+        if (opts.system)
+            args.push("--append-system-prompt", opts.system);
+        return new Promise((resolve, reject) => {
+            const child = spawn(this.bin, args, { stdio: ["pipe", "pipe", "pipe"] });
+            let stdout = "";
+            let stderr = "";
+            const timer = setTimeout(() => {
+                child.kill("SIGKILL");
+                reject(new Error(`claude -p timed out after ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            child.stdout.on("data", (d) => (stdout += d));
+            child.stderr.on("data", (d) => (stderr += d));
+            child.on("error", (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            child.on("close", (code) => {
+                clearTimeout(timer);
+                if (code === 0)
+                    resolve(stdout.trim());
+                else
+                    reject(new Error(`claude -p exited ${code}: ${stderr.trim()}`));
+            });
+            child.stdin.write(prompt);
+            child.stdin.end();
+        });
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/llm/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/adapters/llm/claude-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAS3C,MAAM,OAAO,mBAAmB;IACrB,EAAE,CAAS;IACH,KAAK,CAAS;IACd,GAAG,CAAS;IACZ,SAAS,CAAS;IAEnC,YAAY,OAA0B,EAAE;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;QAC3C,IAAI,CAAC,EAAE,GAAG,eAAe,IAAI,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAwB,EAAE;QACvD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAElE,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACzE,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;YACrE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEnB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;;oBAClC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/llm/factory.d.ts

@@ -0,0 +1,8 @@
+/** Picks the LLM backend (invariant #5): the API if ANTHROPIC_API_KEY is set, else local Claude Code. */
+import type { LlmClient } from "../../core/ports.js";
+export interface LlmFactoryOptions {
+    /** Force a backend regardless of environment. */
+    backend?: "anthropic" | "claude-code";
+    model?: string;
+}
+export declare function createLlmClient(opts?: LlmFactoryOptions): LlmClient;

package/dist/adapters/llm/factory.js

@@ -0,0 +1,9 @@
+import { AnthropicLlmClient } from "./anthropic.js";
+import { ClaudeCodeLlmClient } from "./claude-code.js";
+export function createLlmClient(opts = {}) {
+    const backend = opts.backend ?? (process.env.ANTHROPIC_API_KEY ? "anthropic" : "claude-code");
+    return backend === "anthropic"
+        ? new AnthropicLlmClient({ model: opts.model })
+        : new ClaudeCodeLlmClient({ model: opts.model });
+}
+//# sourceMappingURL=factory.js.map

package/dist/adapters/llm/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/adapters/llm/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQvD,MAAM,UAAU,eAAe,CAAC,OAA0B,EAAE;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC9F,OAAO,OAAO,KAAK,WAAW;QAC5B,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/adapters/planners/static.d.ts

@@ -0,0 +1,8 @@
+/** Deterministic Planner — returns a fixed scenario. The replay path's planner, no LLM (invariant #4). */
+import type { Planner } from "../../core/ports.js";
+import type { Context, Scenario } from "../../core/types.js";
+export declare class StaticPlanner implements Planner {
+    private readonly scenario;
+    constructor(scenario: Scenario);
+    plan(_ctx: Context): Promise<Scenario>;
+}

package/dist/adapters/planners/static.js

@@ -0,0 +1,10 @@
+export class StaticPlanner {
+    scenario;
+    constructor(scenario) {
+        this.scenario = scenario;
+    }
+    async plan(_ctx) {
+        return this.scenario;
+    }
+}
+//# sourceMappingURL=static.js.map

package/dist/adapters/planners/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../src/adapters/planners/static.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,KAAK,CAAC,IAAI,CAAC,IAAa;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/adapters/reporters/console.d.ts

@@ -0,0 +1,6 @@
+/** Human-readable Reporter for CLI/CI. Mirrors the report sketch in docs/design.md §7. */
+import type { Reporter } from "../../core/ports.js";
+import type { Result } from "../../core/types.js";
+export declare class ConsoleReporter implements Reporter {
+    emit(result: Result): Promise<void>;
+}

package/dist/adapters/reporters/console.js

@@ -0,0 +1,17 @@
+export class ConsoleReporter {
+    async emit(result) {
+        const { scenario, evidence, verdict } = result;
+        const mark = (ok) => (ok ? "✓" : "✗");
+        console.log(`\n${scenario}`);
+        console.log(`  ${mark(evidence.execution.navigated)} navigated → ${evidence.execution.finalUrl ?? "(none)"}`);
+        console.log(`  · ${evidence.execution.actions.length} actions · ${evidence.logic.requests.length} requests · ${evidence.logic.console.length} console msgs`);
+        for (const r of verdict.results) {
+            console.log(`  ${mark(r.passed)} ${r.assertion.kind}${r.detail ? ` — ${r.detail}` : ""}`);
+        }
+        const failed = verdict.results.filter((r) => !r.passed).length;
+        console.log(verdict.passed
+            ? `\n${mark(true)} pass — ${verdict.results.length} assertion(s)`
+            : `\n${mark(false)} ${failed} issue(s) — evidence captured`);
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/adapters/reporters/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/adapters/reporters/console.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,eAAe;IAC1B,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC/C,MAAM,IAAI,GAAG,CAAC,EAAW,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAE/C,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,QAAQ,CAAC,SAAS,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC9G,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,cAAc,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,eAAe,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,eAAe,CAAC,CAAC;QAE7J,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QAC/D,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,MAAM;YACZ,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,OAAO,CAAC,MAAM,eAAe;YACjE,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,+BAA+B,CAC9D,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/reporters/json.d.ts

@@ -0,0 +1,7 @@
+import type { Reporter } from "../../core/ports.js";
+import type { Result } from "../../core/types.js";
+export declare class JsonReporter implements Reporter {
+    private readonly path;
+    constructor(path: string);
+    emit(result: Result): Promise<void>;
+}

package/dist/adapters/reporters/json.js

@@ -0,0 +1,12 @@
+/** Structured Reporter — writes the full result as JSON for CI consumption. */
+import { writeFile } from "node:fs/promises";
+export class JsonReporter {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async emit(result) {
+        await writeFile(this.path, JSON.stringify(result, null, 2), "utf8");
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/adapters/reporters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/adapters/reporters/json.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/adapters/skills/file-store.d.ts

@@ -0,0 +1,11 @@
+import type { SkillStore, Skill } from "../../core/ports.js";
+import type { Scenario } from "../../core/types.js";
+export declare class FileSkillStore implements SkillStore {
+    private readonly dir;
+    constructor(dir: string);
+    private pathFor;
+    resolve(name: string): Promise<Skill | undefined>;
+    freeze(name: string, scenario: Scenario): Promise<string>;
+}
+/** Load a frozen skill by path, accepting either a full `{name,scenario}` or a bare scenario. */
+export declare function loadSkillFile(path: string): Promise<Skill>;

package/dist/adapters/skills/file-store.js

@@ -0,0 +1,43 @@
+/**
+ * File-backed SkillStore. A frozen skill is plain JSON `{ name, scenario }`; freezing turns
+ * an expensive LLM discovery into a cheap, repeatable, LLM-free replay (invariant #4).
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export class FileSkillStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    pathFor(name) {
+        return join(this.dir, `${name}.json`);
+    }
+    async resolve(name) {
+        try {
+            const raw = await readFile(this.pathFor(name), "utf8");
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return undefined;
+            throw err;
+        }
+    }
+    async freeze(name, scenario) {
+        const path = this.pathFor(name);
+        await mkdir(dirname(path), { recursive: true });
+        const skill = { name, scenario };
+        await writeFile(path, JSON.stringify(skill, null, 2), "utf8");
+        return path;
+    }
+}
+/** Load a frozen skill by path, accepting either a full `{name,scenario}` or a bare scenario. */
+export async function loadSkillFile(path) {
+    const raw = await readFile(path, "utf8");
+    const parsed = JSON.parse(raw);
+    if ("scenario" in parsed)
+        return parsed;
+    const scenario = parsed;
+    return { name: scenario.name, scenario };
+}
+//# sourceMappingURL=file-store.js.map

package/dist/adapters/skills/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../../src/adapters/skills/file-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEpC,OAAO,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAU,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,QAAkB;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;IACnD,IAAI,UAAU,IAAI,MAAM;QAAE,OAAO,MAAe,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAkB,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * cairn CLI — a thin consumer of the cairn-engine library.
+ *
+ *   cairn run --dogfood                       built-in example.com → first link → network
+ *   cairn run --scenario s.json [--json out]  run a scenario file (deterministic)
+ *   cairn replay <skill.json> [--json out]    replay a frozen skill (deterministic, no LLM)
+ *   cairn replay <skill.json> --heal [--freeze f]   repair broken steps via LLM, re-freeze
+ *   cairn discover "<intent>" --url <u>        LLM discover a scenario [--freeze f] [--model m]
+ *
+ * All orchestration lives in the library (`runScenario` / `discover`). This file only
+ * parses args, composes reporters, and maps the verdict to an exit code (1 = fail → CI
+ * gate). A desktop app or CI job imports the same library functions instead of this CLI.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { runScenario, needsLlmCritic } from "./run.js";
+import { discover } from "./core/discover.js";
+import { ConsoleReporter } from "./adapters/reporters/console.js";
+import { JsonReporter } from "./adapters/reporters/json.js";
+import { ChromeDevToolsDriver } from "./adapters/drivers/chrome.js";
+import { loadSkillFile } from "./adapters/skills/file-store.js";
+import { createLlmClient } from "./adapters/llm/factory.js";
+/** Reproduces the manual MCP verification: example.com → "Learn more" → observe network. */
+const DOGFOOD = {
+    name: "example.com → first link → network",
+    steps: [
+        { kind: "goto", url: "https://example.com" },
+        { kind: "click", target: { text: "Learn more" } },
+    ],
+    assertions: [{ kind: "navigated" }, { kind: "no-failed-requests" }],
+};
+function parseArgs(argv) {
+    const positionals = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith("--")) {
+            const key = a.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("--")) {
+                flags.set(key, next);
+                i++;
+            }
+            else {
+                flags.set(key, true);
+            }
+        }
+        else {
+            positionals.push(a);
+        }
+    }
+    return { positionals, flags };
+}
+const flagStr = (flags, key) => {
+    const v = flags.get(key);
+    return typeof v === "string" ? v : undefined;
+};
+function reporterFor(flags) {
+    const reporters = [new ConsoleReporter()];
+    const jsonOut = flagStr(flags, "json");
+    if (jsonOut)
+        reporters.push(new JsonReporter(jsonOut));
+    return { emit: async (r) => void (await Promise.all(reporters.map((rep) => rep.emit(r)))) };
+}
+/** Run a scenario through the library and surface CLI-specific output (heal log, freeze). */
+async function runScenarioCli(scenario, flags) {
+    if (needsLlmCritic(scenario))
+        console.log("scenario has 'expect' criteria → judging with LlmCritic");
+    const { result, heals, healedScenario } = await runScenario(scenario, {
+        reporter: reporterFor(flags),
+        model: flagStr(flags, "model"),
+        heal: Boolean(flags.get("heal")),
+    });
+    if (heals.length) {
+        console.log(`\nself-healed ${heals.length} step(s):`);
+        for (const h of heals)
+            console.log(`  · "${h.original.text}" → "${h.healedText}"`);
+        const freeze = flagStr(flags, "freeze");
+        if (freeze && healedScenario) {
+            await writeFile(freeze, JSON.stringify({ name: healedScenario.name, scenario: healedScenario }, null, 2), "utf8");
+            console.log(`  re-frozen → ${freeze}`);
+        }
+    }
+    return result.verdict.passed ? 0 : 1;
+}
+async function cmdRun(flags) {
+    let scenario;
+    if (flags.get("dogfood")) {
+        scenario = DOGFOOD;
+    }
+    else {
+        const path = flagStr(flags, "scenario");
+        if (!path)
+            throw new Error("provide --scenario <file.json> or --dogfood");
+        scenario = JSON.parse(await readFile(path, "utf8"));
+    }
+    return runScenarioCli(scenario, flags);
+}
+async function cmdReplay(positionals, flags) {
+    const file = positionals[0];
+    if (!file)
+        throw new Error("usage: cairn replay <skill.json> [--heal] [--json out]");
+    const skill = await loadSkillFile(file);
+    const mode = flags.get("heal") ? "self-heal on" : "deterministic, no LLM";
+    console.log(`replaying frozen skill "${skill.name}" — ${mode}`);
+    return runScenarioCli(skill.scenario, flags);
+}
+async function cmdDiscover(positionals, flags) {
+    const intent = positionals[0];
+    if (!intent)
+        throw new Error('usage: cairn discover "<intent>" --url <u> [--freeze f] [--model m]');
+    const url = flagStr(flags, "url");
+    const model = flagStr(flags, "model");
+    const driver = new ChromeDevToolsDriver();
+    const llm = createLlmClient(model ? { model } : {});
+    console.log(`discovering with ${llm.id} …`);
+    let scenario;
+    try {
+        scenario = await discover(intent, { driver, llm, baseUrl: url });
+    }
+    finally {
+        await driver.close();
+    }
+    console.log(`\ndiscovered scenario "${scenario.name}" — ${scenario.steps.length} steps:`);
+    for (const step of scenario.steps)
+        console.log(`  · ${JSON.stringify(step)}`);
+    const freeze = flagStr(flags, "freeze");
+    if (freeze) {
+        await writeFile(freeze, JSON.stringify({ name: scenario.name, scenario }, null, 2), "utf8");
+        console.log(`\nfrozen → ${freeze}  (replay with: cairn replay ${freeze})`);
+    }
+    return 0;
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    const { positionals, flags } = parseArgs(rest);
+    let code;
+    switch (cmd) {
+        case "run":
+            code = await cmdRun(flags);
+            break;
+        case "replay":
+            code = await cmdReplay(positionals, flags);
+            break;
+        case "discover":
+            code = await cmdDiscover(positionals, flags);
+            break;
+        default:
+            console.error("usage: cairn <run|replay|discover> …");
+            code = 2;
+    }
+    process.exit(code);
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.stack ?? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,4FAA4F;AAC5F,MAAM,OAAO,GAAa;IACxB,IAAI,EAAE,oCAAoC;IAC1C,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE;QAC5C,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE;KAClD;IACD,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;CACpE,CAAC;AAIF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,KAAK,GAAU,IAAI,GAAG,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACrB,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,GAAW,EAAsB,EAAE;IAChE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC,CAAC;AAEF,SAAS,WAAW,CAAC,KAAY;IAC/B,MAAM,SAAS,GAAe,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO;QAAE,SAAS,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,cAAc,CAAC,QAAkB,EAAE,KAAY;IAC5D,IAAI,cAAc,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IAErG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE;QACpE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;KACjC,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QACnF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,IAAI,cAAc,EAAE,CAAC;YAC7B,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAClH,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,KAAY;IAChC,IAAI,QAAkB,CAAC;IACvB,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC1E,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;IAClE,CAAC;IACD,OAAO,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,WAAqB,EAAE,KAAY;IAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,uBAAuB,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,CAAC,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,WAAqB,EAAE,KAAY;IAC5D,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACpG,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAE5C,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0BAA0B,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;IAC1F,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5F,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,gCAAgC,MAAM,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,IAAY,CAAC;IACjB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,UAAU;YACb,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACtD,IAAI,GAAG,CAAC,CAAC;IACb,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/core/discover.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The discover loop — the only place the agent loops (invariant #3). It observes the page,
+ * asks the LLM for the next action, acts, and repeats until done, emitting a Scenario that
+ * later replays with no LLM (invariant #4). LLM is behind the LlmClient seam (invariant #5).
+ */
+import type { Driver, LlmClient } from "./ports.js";
+import type { Assertion, Scenario, Step } from "./types.js";
+export interface DiscoverOptions {
+    driver: Driver;
+    llm: LlmClient;
+    baseUrl?: string;
+    maxSteps?: number;
+    onStep?: (decision: Decision, step?: Step) => void;
+}
+export interface Decision {
+    action: "click" | "type" | "goto" | "done";
+    text?: string;
+    value?: string;
+    url?: string;
+    reason?: string;
+    assertions?: Assertion[];
+}
+/** First JSON object in a model reply, tolerating code fences and surrounding prose. */
+export declare function parseDecision(text: string): Decision;
+export declare function discover(intent: string, opts: DiscoverOptions): Promise<Scenario>;

package/dist/core/discover.js

@@ -0,0 +1,93 @@
+const SYSTEM = "You are a QA agent driving a web browser to satisfy a natural-language intent. " +
+    "At each turn you see the page's interactive elements and the actions taken so far. " +
+    "Respond with ONE next action as strict JSON, no prose, no code fences. " +
+    'Schema: {"action":"click|type|goto|done","text":"<element name>","value":"<text to type>","url":"<url>","reason":"<short>"}. ' +
+    'Use "click"/"type" with the exact element name shown. Use "done" when the intent is achieved; ' +
+    'with "done" you may include "assertions": an array of {"kind":"navigated"} | {"kind":"no-failed-requests"} | ' +
+    '{"kind":"no-console-errors"} | {"kind":"request-status","urlIncludes":"...","status":200}.';
+function buildPrompt(intent, elements, steps) {
+    const els = elements
+        .slice(0, 60)
+        .map((e) => `- [${e.role}] ${e.name}`)
+        .join("\n");
+    const history = steps.length
+        ? steps.map((s, i) => `${i + 1}. ${JSON.stringify(s)}`).join("\n")
+        : "(none yet)";
+    return [
+        `Intent: ${intent}`,
+        ``,
+        `Actions taken so far:`,
+        history,
+        ``,
+        `Interactive elements now on the page:`,
+        els || "(none)",
+        ``,
+        `What is the single next action? Respond with JSON only.`,
+    ].join("\n");
+}
+/** First JSON object in a model reply, tolerating code fences and surrounding prose. */
+export function parseDecision(text) {
+    let s = text.trim();
+    s = s.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "");
+    const start = s.indexOf("{");
+    const end = s.lastIndexOf("}");
+    if (start === -1 || end === -1 || end < start) {
+        throw new Error(`no JSON object in model reply: ${text.slice(0, 200)}`);
+    }
+    const obj = JSON.parse(s.slice(start, end + 1));
+    if (!obj.action)
+        throw new Error(`decision missing "action": ${s.slice(0, 200)}`);
+    return obj;
+}
+const KNOWN_KINDS = new Set(["navigated", "no-failed-requests", "no-console-errors", "request-status"]);
+/** Drop assertions the deterministic critic can't evaluate; fall back to a safe default. */
+function sanitizeAssertions(input) {
+    const valid = (input ?? []).filter((a) => a && KNOWN_KINDS.has(a.kind));
+    return valid.length ? valid : [{ kind: "no-failed-requests" }];
+}
+export async function discover(intent, opts) {
+    const { driver, llm, baseUrl, maxSteps = 8, onStep } = opts;
+    const steps = [];
+    if (baseUrl) {
+        await driver.goto(baseUrl);
+        steps.push({ kind: "goto", url: baseUrl });
+    }
+    for (let i = 0; i < maxSteps; i++) {
+        await driver.settle();
+        const elements = await driver.snapshot();
+        const reply = await llm.complete(buildPrompt(intent, elements, steps), { system: SYSTEM });
+        const decision = parseDecision(reply);
+        if (decision.action === "done") {
+            onStep?.(decision);
+            return { name: intent, steps, assertions: sanitizeAssertions(decision.assertions) };
+        }
+        let step;
+        switch (decision.action) {
+            case "click":
+                if (!decision.text)
+                    throw new Error('click decision missing "text"');
+                await driver.click({ text: decision.text });
+                step = { kind: "click", target: { text: decision.text } };
+                break;
+            case "type":
+                if (!decision.text)
+                    throw new Error('type decision missing "text"');
+                await driver.type({ text: decision.text }, decision.value ?? "");
+                step = { kind: "type", target: { text: decision.text }, text: decision.value ?? "" };
+                break;
+            case "goto":
+                if (!decision.url)
+                    throw new Error('goto decision missing "url"');
+                await driver.goto(decision.url);
+                step = { kind: "goto", url: decision.url };
+                break;
+            default:
+                throw new Error(`unknown action: ${decision.action}`);
+        }
+        steps.push(step);
+        onStep?.(decision, step);
+    }
+    // Safety cap reached without an explicit "done".
+    return { name: intent, steps, assertions: [{ kind: "no-failed-requests" }] };
+}
+//# sourceMappingURL=discover.js.map

package/dist/core/discover.js.map

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

package/dist/core/pipeline.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The execution body: Context → Plan → Execute → Judge → Report. Every variable behavior
+ * is injected (invariant #2); with a fixed-scenario Planner + deterministic Critic, no LLM
+ * runs (invariant #4).
+ */
+import type { Harness } from "./ports.js";
+import type { Result } from "./types.js";
+export declare function runHarness(harness: Harness, task: string): Promise<Result>;