fakeplane 0.0.0-stage → 0.1.0

package/dist/cli.js

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { agentEnv } from "./agent.js";
+import { evaluateAssertions } from "./assertions.js";
+import { createWorld } from "./backends/index.js";
+import { McpHandler, serveStdio } from "./mcp.js";
+import { color, formatScenario, formatSummary, toJUnit, toMarkdown } from "./report.js";
+import { buildWorld, injectTurn, runScenarios } from "./runner.js";
+import { AssertionSchema, loadConfig, loadScenarioFile, loadScenarios, normalizeScenario, ScenarioError } from "./scenario.js";
+import { FakeServer } from "./server.js";
+import { parseTrace, traceToScenario } from "./trace.js";
+import { asArray } from "./util.js";
+import { VERSION } from "./version.js";
+const HELP = `fakeplane ${VERSION}: stateful fake backends for testing AI agents
+
+Usage:
+  fakeplane run [paths...]        Run scenarios against your agent (default: ./scenarios)
+      --agent <cmd>               Agent command; gets each turn as JSON on stdin
+      --agent-url <url>           Or POST each turn to this URL
+      --agent-module <file>       Or call this JS module's default export
+      --junit <file>              Write JUnit XML (for CI test reports)
+      --json <file>               Write the full JSON report (calls, effects, state)
+      --markdown <file>           Write a Markdown summary (e.g. $GITHUB_STEP_SUMMARY)
+      --repeat <n>                Run each scenario n times (agents are non-deterministic)
+      --filter <text>             Only scenarios whose name or path contains text
+      --bail                      Stop at the first failing scenario
+      --verbose                   Show passing assertions too
+      --config <file>             Config file (default: ./fakeplane.config.yaml if present)
+  fakeplane up [--scenario f] [--port 4010] [--host 127.0.0.1] [--record f]
+                                  Serve the fakes (HTTP + MCP) for manual or external runs
+  fakeplane mcp [--scenario f] [--record f]
+                                  Serve the fakes as an MCP server over stdio
+  fakeplane report [--url u] [--assert scenario.yaml] [--json]
+                                  Show what a running 'up' server recorded; optionally assert
+  fakeplane from-trace <trace.json> [-o out.yaml] [--name n] [--no-redact]
+                                  Turn a production trace (OTLP JSON or chat transcript) into a scenario
+  fakeplane validate [paths...]   Check scenario files without running them
+  fakeplane demo                  Run the bundled demo: a naive agent fails, a careful one passes
+  fakeplane init [dir]            Write a starter scenario, config and example agent
+
+Exit codes: 0 all passed, 1 a scenario failed, 2 usage or config error.
+Docs: https://github.com/shmindmaster/fakeplane`;
+const here = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(here, "..");
+function fail(message) {
+    process.stderr.write(`${color.red("error")} ${message}\n`);
+    process.exit(2);
+}
+function quote(p) {
+    return /[\s"]/.test(p) ? `"${p.replace(/"/g, '\\"')}"` : p;
+}
+function agentFromFlags(v) {
+    if (typeof v.agent === "string")
+        return { command: v.agent };
+    if (typeof v["agent-url"] === "string")
+        return { url: v["agent-url"] };
+    if (typeof v["agent-module"] === "string")
+        return { module: resolve(v["agent-module"]) };
+    return undefined;
+}
+function writeOut(file, content) {
+    mkdirSync(dirname(resolve(file)), { recursive: true });
+    writeFileSync(file, content);
+}
+async function cmdRun(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            agent: { type: "string" },
+            "agent-url": { type: "string" },
+            "agent-module": { type: "string" },
+            junit: { type: "string" },
+            json: { type: "string" },
+            markdown: { type: "string" },
+            repeat: { type: "string" },
+            filter: { type: "string" },
+            bail: { type: "boolean" },
+            verbose: { type: "boolean" },
+            config: { type: "string" },
+            quiet: { type: "boolean" },
+        },
+    });
+    const config = loadConfig(values.config);
+    const paths = positionals.length ? positionals : config?.scenarios ? asArray(config.scenarios).map((p) => resolve(config.dir, p)) : ["scenarios"];
+    const list = loadScenarios(paths);
+    if (list.length === 0)
+        fail(`no scenario files found in ${paths.join(", ")}`);
+    const repeat = values.repeat ? Number(values.repeat) : config?.repeat;
+    if (repeat !== undefined && (!Number.isInteger(repeat) || repeat < 1))
+        fail("--repeat must be a positive integer");
+    const options = {
+        agent: agentFromFlags(values),
+        defaultAgent: config?.agent,
+        defaultAgentDir: config?.dir,
+        extraAssertions: config?.assert,
+        repeat,
+        filter: values.filter,
+        bail: values.bail,
+        onScenarioDone: (r) => {
+            if (!values.quiet)
+                process.stdout.write(formatScenario(r, values.verbose) + "\n");
+        },
+    };
+    if (!values.quiet)
+        process.stdout.write(color.dim(`fakeplane ${VERSION}: ${list.length} scenario(s)\n\n`));
+    const report = await runScenarios(list, options);
+    process.stdout.write(formatSummary(report) + "\n");
+    if (values.junit)
+        writeOut(values.junit, toJUnit(report));
+    if (values.json)
+        writeOut(values.json, JSON.stringify(report, null, 2));
+    if (values.markdown)
+        writeOut(values.markdown, toMarkdown(report));
+    return report.failed + report.errored === 0 ? 0 : 1;
+}
+function scenarioOrEmpty(file) {
+    if (!file)
+        return { build: () => createWorld({ scenario: "default" }) };
+    const [loaded] = loadScenarioFile(file);
+    if (!loaded)
+        fail(`${file} contains no scenario`);
+    return { loaded, build: () => buildWorld(loaded.scenario) };
+}
+async function cmdUp(args) {
+    const { values } = parseArgs({ args, options: { scenario: { type: "string" }, port: { type: "string" }, host: { type: "string" }, record: { type: "string" } } });
+    const { loaded, build } = scenarioOrEmpty(values.scenario);
+    const server = new FakeServer(build(), {
+        host: values.host ?? "127.0.0.1",
+        port: Number(values.port ?? 4010),
+        hooks: {
+            reset: build,
+            assert: async (world, raw) => {
+                const parsed = raw.map((a) => AssertionSchema.parse(a));
+                const results = await evaluateAssertions(parsed, { world, turns: [], dir: loaded?.dir ?? process.cwd() });
+                return { ok: results.every((r) => r.ok), results };
+            },
+            injectTurn: (world, raw) => {
+                const s = normalizeScenario({ seed: loaded?.scenario.seed, turns: [raw] }, "turn");
+                return injectTurn(world, s.turns[0], `evt_manual_${world.calls.length + 1}`);
+            },
+        },
+    });
+    const urls = await server.start();
+    const out = process.stdout;
+    out.write(`${color.bold("fakeplane up")} ${color.dim(loaded ? `scenario: ${loaded.scenario.name}` : "empty world (all backends)")}\n\n`);
+    out.write(`  HTTP    ${urls.base}\n  MCP     ${urls.mcp}  (Streamable HTTP)\n  Control ${urls.base}/_fakeplane/{state,calls,effects,report,reset}\n\n`);
+    out.write(color.dim("Point your agent at it:\n"));
+    for (const [k, v] of Object.entries(agentEnv(urls, loaded?.scenario.name ?? "default")))
+        out.write(`  ${k}=${v}\n`);
+    out.write(color.dim(`\nThen: fakeplane report --url ${urls.base}\nCtrl+C to stop.\n`));
+    await new Promise((resolveStop) => {
+        const stop = () => resolveStop();
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+    });
+    if (values.record)
+        writeOut(values.record, JSON.stringify({ calls: server.world.calls, effects: server.world.effects, state: server.world.snapshot() }, null, 2));
+    await server.stop();
+    return 0;
+}
+async function cmdMcp(args) {
+    const { values } = parseArgs({ args, options: { scenario: { type: "string" }, record: { type: "string" } } });
+    const { loaded, build } = scenarioOrEmpty(values.scenario);
+    const world = build();
+    process.stderr.write(`fakeplane mcp: ${world.tools().length} tools${loaded ? ` (scenario: ${loaded.scenario.name})` : ""}\n`);
+    await serveStdio(new McpHandler(() => world));
+    if (values.record)
+        writeOut(values.record, JSON.stringify({ calls: world.calls, effects: world.effects, state: world.snapshot() }, null, 2));
+    return 0;
+}
+async function cmdReport(args) {
+    const { values } = parseArgs({ args, options: { url: { type: "string" }, assert: { type: "string" }, json: { type: "boolean" } } });
+    const base = (values.url ?? process.env.FAKEPLANE_URL ?? "http://127.0.0.1:4010").replace(/\/+$/, "");
+    let report;
+    try {
+        const res = await fetch(`${base}/_fakeplane/report`);
+        report = await res.json();
+    }
+    catch {
+        fail(`could not reach a fakeplane server at ${base}. Start one with: fakeplane up`);
+    }
+    if (values.json) {
+        process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(`${color.bold(`Scenario: ${report.scenario}`)}  ${report.calls.length} calls, ${report.effects.length} side effects\n\n`);
+        for (const c of report.calls) {
+            const mark = c.ok ? color.green(String(c.status)) : color.red(String(c.status));
+            process.stdout.write(`  #${String(c.seq).padEnd(3)} ${mark} ${c.transport.padEnd(4)} ${c.tool ?? c.op}${c.fault ? color.yellow(` [fault: ${c.fault}${c.committed ? ", committed" : ""}]`) : ""}${c.replayed ? color.dim(" [idempotent replay]") : ""}\n`);
+        }
+        if (report.effects.length)
+            process.stdout.write(`\n${color.bold("Side effects (what the real systems would have seen):")}\n`);
+        for (const e of report.effects)
+            process.stdout.write(`  #${String(e.seq).padEnd(3)} ${e.kind} ${color.dim(e.target ?? "")} ${JSON.stringify(e.data).slice(0, 140)}\n`);
+    }
+    if (!values.assert)
+        return 0;
+    const [loaded] = loadScenarioFile(values.assert);
+    const res = await fetch(`${base}/_fakeplane/assert`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ assert: loaded.scenario.assert }) });
+    const body = await res.json();
+    if (!res.ok)
+        fail(body?.error?.message ?? `assert failed with HTTP ${res.status}`);
+    process.stdout.write(`\n${color.bold("Assertions:")}\n`);
+    for (const r of body.results)
+        process.stdout.write(r.ok ? `  ${color.green("✓")} ${r.name}\n` : `  ${color.red("✗")} ${r.name}\n    ${color.dim(r.message)}\n`);
+    return body.ok ? 0 : 1;
+}
+function readTrace(file) {
+    const text = readFileSync(file, "utf8");
+    if (file.endsWith(".jsonl") || file.endsWith(".ndjson")) {
+        const lines = text
+            .split(/\r?\n/)
+            .filter((l) => l.trim())
+            .map((l) => JSON.parse(l));
+        if (lines.every((l) => Array.isArray(l?.resourceSpans)))
+            return { resourceSpans: lines.flatMap((l) => l.resourceSpans) };
+        return lines;
+    }
+    return JSON.parse(text);
+}
+async function cmdFromTrace(args) {
+    const { values, positionals } = parseArgs({ args, allowPositionals: true, options: { output: { type: "string", short: "o" }, name: { type: "string" }, "no-redact": { type: "boolean" } } });
+    const file = positionals[0];
+    if (!file)
+        fail("usage: fakeplane from-trace <trace.json> [-o scenario.yaml]");
+    let doc;
+    try {
+        doc = readTrace(file);
+    }
+    catch (err) {
+        fail(`could not read ${file}: ${err.message}`);
+    }
+    const parsed = parseTrace(doc);
+    const result = traceToScenario(parsed, { name: values.name, source: file.replace(/\\/g, "/").split("/").pop(), redact: !values["no-redact"] });
+    normalizeScenario(result.scenario, values.output ?? "generated scenario");
+    if (values.output) {
+        writeOut(values.output, result.yaml);
+        process.stderr.write(`${color.green("wrote")} ${values.output} (${parsed.format}: ${parsed.events.length} events)\n`);
+    }
+    else {
+        process.stdout.write(result.yaml);
+    }
+    for (const n of result.notes)
+        process.stderr.write(`${color.dim("note:")} ${n}\n`);
+    return 0;
+}
+function cmdValidate(args) {
+    const { positionals } = parseArgs({ args, allowPositionals: true, options: {} });
+    const list = loadScenarios(positionals.length ? positionals : ["scenarios"]);
+    for (const s of list)
+        process.stdout.write(`${color.green("ok")} ${s.scenario.name} ${color.dim(`(${s.scenario.turns.length} turns, ${s.scenario.faults.length} faults, ${s.scenario.assert.length} assertions)`)}\n`);
+    process.stdout.write(`${list.length} scenario(s) valid\n`);
+    return 0;
+}
+async function cmdDemo() {
+    const scenarios = loadScenarios([join(packageRoot, "demo", "scenarios")]);
+    const node = quote(process.execPath);
+    const out = process.stdout;
+    out.write(`${color.bold("fakeplane demo")}: the same scenarios against two support agents.\n`);
+    out.write(color.dim("Both agents resolve a refund ticket over the fake Zendesk + order API + Slack.\nThe scenarios inject an ambiguous timeout, a duplicate webhook and a large refund.\n\n"));
+    out.write(`${color.bold("1. naive agent")} ${color.dim("(retries blindly, no idempotency keys, pastes customer details into Slack)")}\n\n`);
+    const naive = await runScenarios(scenarios, { agent: { command: `${node} ${quote(join(packageRoot, "demo", "agents", "naive.mjs"))}` }, onScenarioDone: (r) => out.write(formatScenario(r) + "\n") });
+    out.write(formatSummary(naive) + "\n\n");
+    out.write(`${color.bold("2. careful agent")} ${color.dim("(reads back before retrying, idempotency keys, redacts, escalates large refunds)")}\n\n`);
+    const careful = await runScenarios(scenarios, { agent: { command: `${node} ${quote(join(packageRoot, "demo", "agents", "careful.mjs"))}` }, onScenarioDone: (r) => out.write(formatScenario(r) + "\n") });
+    out.write(formatSummary(careful) + "\n\n");
+    const shown = naive.failed > 0 && careful.failed + careful.errored === 0;
+    out.write(shown ? `${color.green("fakeplane caught the naive agent's bugs before any customer saw them.")}\nNext: fakeplane init, then point the scenario at your agent.\n` : color.red("Unexpected demo result.\n"));
+    return shown ? 0 : 1;
+}
+function cmdInit(args) {
+    const { positionals } = parseArgs({ args, allowPositionals: true, options: {} });
+    const dir = resolve(positionals[0] ?? ".");
+    const files = [
+        [join(packageRoot, "demo", "scenarios", "refund-ambiguous-timeout.yaml"), join(dir, "scenarios", "refund-ambiguous-timeout.yaml")],
+        [join(packageRoot, "demo", "agents", "careful.mjs"), join(dir, "example-agent.mjs")],
+    ];
+    for (const [from, to] of files) {
+        if (existsSync(to)) {
+            process.stdout.write(`${color.dim("exists")} ${to}\n`);
+            continue;
+        }
+        mkdirSync(dirname(to), { recursive: true });
+        copyFileSync(from, to);
+        process.stdout.write(`${color.green("created")} ${to}\n`);
+    }
+    const config = join(dir, "fakeplane.config.yaml");
+    if (!existsSync(config)) {
+        writeFileSync(config, `# fakeplane config: applies to every scenario under scenarios/\nscenarios: scenarios\nagent:\n  # Replace with your agent. It receives each turn as JSON on stdin and\n  # finds the fakes through FAKEPLANE_* environment variables.\n  command: node example-agent.mjs\n# Assertions added to every scenario\nassert:\n  - no_duplicate_effects: true\n  - no_pii: true\n`);
+        process.stdout.write(`${color.green("created")} ${config}\n`);
+    }
+    process.stdout.write(`\nNext: ${color.bold("npx fakeplane run")}\n`);
+    return 0;
+}
+async function main(argv) {
+    const [command, ...rest] = argv;
+    switch (command) {
+        case "run":
+            return cmdRun(rest);
+        case "up":
+            return cmdUp(rest);
+        case "mcp":
+            return cmdMcp(rest);
+        case "report":
+            return cmdReport(rest);
+        case "from-trace":
+            return cmdFromTrace(rest);
+        case "validate":
+            return cmdValidate(rest);
+        case "demo":
+            return cmdDemo();
+        case "init":
+            return cmdInit(rest);
+        case "--version":
+        case "-v":
+        case "version":
+            process.stdout.write(VERSION + "\n");
+            return 0;
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            process.stdout.write(HELP + "\n");
+            return 0;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${HELP}\n`);
+            return 2;
+    }
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    if (err instanceof ScenarioError || err?.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION" || err?.code === "ERR_PARSE_ARGS_INVALID_OPTION_VALUE")
+        fail(err.message);
+    process.stderr.write(`${color.red("error")} ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+    process.exit(2);
+});
+//# 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,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAuC,MAAM,eAAe,CAAC;AACpK,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,IAAI,GAAG,aAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA4Be,CAAC;AAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAExC,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,cAAc,CAAC,CAA0B;IAChD,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,IAAI,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;IACvE,IAAI,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;IACzF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAe;IAC7C,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAc;IAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI;QACJ,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC3B;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAClJ,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,8BAA8B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;IACtE,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;QAAE,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACnH,MAAM,OAAO,GAAe;QAC1B,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,EAAE,KAAK;QAC3B,eAAe,EAAE,MAAM,EAAE,GAAG;QAC5B,eAAe,EAAE,MAAM,EAAE,MAAM;QAC/B,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,KAAK,IAAI,CAAC,MAAM,kBAAkB,CAAC,CAAC,CAAC;IAC3G,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,KAAK;QAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,IAAI;QAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,QAAQ;QAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,eAAe,CAAC,IAAwB;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACxE,MAAM,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,GAAG,IAAI,uBAAuB,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAc;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAClK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE;QACrC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,WAAW;QAChC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QACjC,KAAK,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1G,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;YACrD,CAAC;YACD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACzB,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBACnF,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;SACF;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACzI,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,GAAG,kCAAkC,IAAI,CAAC,IAAI,oDAAoD,CAAC,CAAC;IACxJ,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;QAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpH,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,IAAI,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;IACvF,MAAM,IAAI,OAAO,CAAO,CAAC,WAAW,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM;QAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClK,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAc;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9G,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,SAAS,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9H,MAAM,UAAU,CAAC,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM;QAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7I,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACpI,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtG,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;QACrD,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,yCAAyC,IAAI,gCAAgC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,WAAW,MAAM,CAAC,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;QAC/I,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC5P,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,IAAI,CAAC,CAAC;QAC9H,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACzK,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACpL,MAAM,IAAI,GAAQ,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChK,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI;aACf,KAAK,CAAC,OAAO,CAAC;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;QACzH,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAc;IACxC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7L,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC/E,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,kBAAkB,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/I,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,oBAAoB,CAAC,CAAC;IAC1E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;IACxH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IACvN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,oDAAoD,CAAC,CAAC;IAC/F,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,wKAAwK,CAAC,CAAC,CAAC;IAC/L,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,4EAA4E,CAAC,MAAM,CAAC,CAAC;IAC5I,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACtM,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC;IACzC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,kFAAkF,CAAC,MAAM,CAAC,CAAC;IACpJ,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1M,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC;IACzE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,uEAAuE,CAAC,kEAAkE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACtN,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,IAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAuB;QAChC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,+BAA+B,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,+BAA+B,CAAC,CAAC;QAClI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;KACrF,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,aAAa,CACX,MAAM,EACN,6WAA6W,CAC9W,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,OAAO,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,IAAI,IAAI,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;IACN,IAAI,GAAG,YAAY,aAAa,IAAK,GAAW,EAAE,IAAI,KAAK,+BAA+B,IAAK,GAAW,EAAE,IAAI,KAAK,qCAAqC;QAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9K,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { createWorld, BACKEND_NAMES, type BackendName, type CreateWorldOptions, type Seed } from "./backends/index.js";
+export { ZendeskBackend, SlackBackend, LinearBackend, GenericBackend } from "./backends/index.js";
+export { World, type Backend, type Operation, type FaultSpec, type FaultKind, type DispatchResult } from "./world.js";
+export { FakeServer, type ServerUrls, type FakeServerOptions } from "./server.js";
+export { McpHandler, serveStdio, MCP_PROTOCOL_VERSIONS } from "./mcp.js";
+export { evaluateAssertions, evaluateAssertion, type AssertionResult, type AssertionContext } from "./assertions.js";
+export { loadScenarios, loadScenarioFile, loadConfig, normalizeScenario, ScenarioError, type Scenario, type Assertion, type AgentSpec, type LoadedScenario } from "./scenario.js";
+export { runScenarios, runScenario, runAttempt, buildWorld, injectTurn, type RunReport, type ScenarioResult, type AttemptResult, type RunOptions } from "./runner.js";
+export { invokeAgent, agentEnv, type TurnPayload } from "./agent.js";
+export { toJUnit, toMarkdown, formatScenario, formatSummary } from "./report.js";
+export { parseTrace, traceToScenario, type ParsedTrace, type TimelineEvent } from "./trace.js";
+export { matchValue } from "./matchers.js";
+export { scanText, scanValue, type PiiFinding } from "./pii.js";
+export { ApiError, type CallRecord, type Effect, type TurnRecord } from "./types.js";
+export { VERSION } from "./version.js";

package/dist/index.js

@@ -0,0 +1,16 @@
+export { createWorld, BACKEND_NAMES } from "./backends/index.js";
+export { ZendeskBackend, SlackBackend, LinearBackend, GenericBackend } from "./backends/index.js";
+export { World } from "./world.js";
+export { FakeServer } from "./server.js";
+export { McpHandler, serveStdio, MCP_PROTOCOL_VERSIONS } from "./mcp.js";
+export { evaluateAssertions, evaluateAssertion } from "./assertions.js";
+export { loadScenarios, loadScenarioFile, loadConfig, normalizeScenario, ScenarioError } from "./scenario.js";
+export { runScenarios, runScenario, runAttempt, buildWorld, injectTurn } from "./runner.js";
+export { invokeAgent, agentEnv } from "./agent.js";
+export { toJUnit, toMarkdown, formatScenario, formatSummary } from "./report.js";
+export { parseTrace, traceToScenario } from "./trace.js";
+export { matchValue } from "./matchers.js";
+export { scanText, scanValue } from "./pii.js";
+export { ApiError } from "./types.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAwD,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,KAAK,EAAqF,MAAM,YAAY,CAAC;AACtH,OAAO,EAAE,UAAU,EAA2C,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAA+C,MAAM,iBAAiB,CAAC;AACrH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAsE,MAAM,eAAe,CAAC;AAClL,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAA4E,MAAM,aAAa,CAAC;AACtK,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAwC,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAiD,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/matchers.d.ts

@@ -0,0 +1,11 @@
+export interface MatchResult {
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Match `actual` against an expectation.
+ * - Operator objects (`{ gt: 100 }`, `{ contains: "x" }`) apply each operator.
+ * - Plain objects match as a subset; keys may be dotted paths.
+ * - Everything else uses loose equality (`1` equals `"1"`).
+ */
+export declare function matchValue(actual: unknown, expected: unknown): MatchResult;

package/dist/matchers.js

@@ -0,0 +1,156 @@
+import { getPath, isPlainObject, stableStringify } from "./util.js";
+const OPERATORS = new Set([
+    "eq",
+    "ne",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "contains",
+    "icontains",
+    "not_contains",
+    "matches",
+    "in",
+    "not_in",
+    "exists",
+    "length",
+    "not",
+]);
+const OK = { ok: true };
+function isOperatorObject(value) {
+    if (!isPlainObject(value))
+        return false;
+    const keys = Object.keys(value);
+    return keys.length > 0 && keys.every((k) => OPERATORS.has(k));
+}
+function looseEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a === "number" && typeof b === "string" && b.trim() !== "" && Number(b) === a)
+        return true;
+    if (typeof b === "number" && typeof a === "string" && a.trim() !== "" && Number(a) === b)
+        return true;
+    if (typeof a === "object" && typeof b === "object" && a !== null && b !== null) {
+        return stableStringify(a) === stableStringify(b);
+    }
+    return false;
+}
+function toRegExp(pattern) {
+    const m = /^\/(.*)\/([a-z]*)$/s.exec(pattern);
+    return m ? new RegExp(m[1], m[2]) : new RegExp(pattern);
+}
+function show(value) {
+    const s = JSON.stringify(value);
+    if (s === undefined)
+        return String(value);
+    return s.length > 120 ? s.slice(0, 117) + "..." : s;
+}
+function compareNumbers(actual, expected, op) {
+    const a = typeof actual === "string" && actual.trim() !== "" ? Number(actual) : actual;
+    const e = Number(expected);
+    if (typeof a !== "number" || Number.isNaN(a))
+        return { ok: false, reason: `expected a number ${op} ${show(expected)}, got ${show(actual)}` };
+    const ok = op === "gt" ? a > e : op === "gte" ? a >= e : op === "lt" ? a < e : a <= e;
+    return ok ? OK : { ok: false, reason: `expected ${show(actual)} ${op} ${show(expected)}` };
+}
+function applyOperator(actual, op, expected) {
+    switch (op) {
+        case "eq":
+            return looseEqual(actual, expected) ? OK : { ok: false, reason: `expected ${show(expected)}, got ${show(actual)}` };
+        case "ne":
+            return !looseEqual(actual, expected) ? OK : { ok: false, reason: `expected anything but ${show(expected)}` };
+        case "gt":
+        case "gte":
+        case "lt":
+        case "lte":
+            return compareNumbers(actual, expected, op);
+        case "contains":
+        case "icontains": {
+            if (typeof actual === "string") {
+                const hay = op === "icontains" ? actual.toLowerCase() : actual;
+                const needle = op === "icontains" ? String(expected).toLowerCase() : String(expected);
+                return hay.includes(needle) ? OK : { ok: false, reason: `expected text to contain ${show(expected)}, got ${show(actual)}` };
+            }
+            if (Array.isArray(actual)) {
+                return actual.some((item) => matchValue(item, expected).ok)
+                    ? OK
+                    : { ok: false, reason: `expected list to contain ${show(expected)}, got ${show(actual)}` };
+            }
+            return { ok: false, reason: `expected text or list containing ${show(expected)}, got ${show(actual)}` };
+        }
+        case "not_contains": {
+            const r = applyOperator(actual, "contains", expected);
+            if (actual === undefined || actual === null)
+                return OK;
+            return r.ok ? { ok: false, reason: `expected not to contain ${show(expected)}, got ${show(actual)}` } : OK;
+        }
+        case "matches":
+            return typeof actual === "string" && toRegExp(String(expected)).test(actual)
+                ? OK
+                : { ok: false, reason: `expected ${show(actual)} to match ${String(expected)}` };
+        case "in":
+            return Array.isArray(expected) && expected.some((e) => looseEqual(actual, e))
+                ? OK
+                : { ok: false, reason: `expected one of ${show(expected)}, got ${show(actual)}` };
+        case "not_in":
+            return Array.isArray(expected) && expected.some((e) => looseEqual(actual, e))
+                ? { ok: false, reason: `expected none of ${show(expected)}, got ${show(actual)}` }
+                : OK;
+        case "exists": {
+            const present = actual !== undefined && actual !== null;
+            return present === Boolean(expected) ? OK : { ok: false, reason: expected ? "expected value to exist" : `expected no value, got ${show(actual)}` };
+        }
+        case "length": {
+            const len = typeof actual === "string" || Array.isArray(actual) ? actual.length : undefined;
+            if (len === undefined)
+                return { ok: false, reason: `expected text or list, got ${show(actual)}` };
+            const r = matchValue(len, expected);
+            return r.ok ? OK : { ok: false, reason: `length ${len}: ${r.reason}` };
+        }
+        case "not": {
+            const r = matchValue(actual, expected);
+            return r.ok ? { ok: false, reason: `expected not to match ${show(expected)}` } : OK;
+        }
+        default:
+            return { ok: false, reason: `unknown operator ${op}` };
+    }
+}
+/**
+ * Match `actual` against an expectation.
+ * - Operator objects (`{ gt: 100 }`, `{ contains: "x" }`) apply each operator.
+ * - Plain objects match as a subset; keys may be dotted paths.
+ * - Everything else uses loose equality (`1` equals `"1"`).
+ */
+export function matchValue(actual, expected) {
+    if (isOperatorObject(expected)) {
+        for (const [op, arg] of Object.entries(expected)) {
+            const r = applyOperator(actual, op, arg);
+            if (!r.ok)
+                return r;
+        }
+        return OK;
+    }
+    if (isPlainObject(expected)) {
+        if (!isPlainObject(actual))
+            return { ok: false, reason: `expected an object, got ${show(actual)}` };
+        for (const [key, exp] of Object.entries(expected)) {
+            const r = matchValue(getPath(actual, key), exp);
+            if (!r.ok)
+                return { ok: false, reason: `${key}: ${r.reason}` };
+        }
+        return OK;
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual) || actual.length !== expected.length) {
+            return { ok: false, reason: `expected ${show(expected)}, got ${show(actual)}` };
+        }
+        for (let i = 0; i < expected.length; i++) {
+            const r = matchValue(actual[i], expected[i]);
+            if (!r.ok)
+                return { ok: false, reason: `[${i}]: ${r.reason}` };
+        }
+        return OK;
+    }
+    return looseEqual(actual, expected) ? OK : { ok: false, reason: `expected ${show(expected)}, got ${show(actual)}` };
+}
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,43 @@
+import type { World } from "./world.js";
+export declare const MCP_PROTOCOL_VERSIONS: string[];
+type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result: unknown;
+} | {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+};
+/** Minimal MCP server exposing every fake operation that has a tool spec. Tools only; no resources or prompts. */
+export declare class McpHandler {
+    private readonly getWorld;
+    constructor(getWorld: () => World);
+    listTools(): {
+        name: string;
+        description: string;
+        inputSchema: import("./types.js").JsonSchema;
+        annotations: {
+            readOnlyHint: boolean;
+            idempotentHint: boolean;
+            openWorldHint: boolean;
+        };
+    }[];
+    callTool(name: string, args?: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | undefined>;
+    /** Handle one JSON-RPC message or a batch. Returns undefined when nothing should be sent back. */
+    handle(payload: unknown): Promise<JsonRpcResponse | JsonRpcResponse[] | undefined>;
+    private handleOne;
+}
+/** Serve MCP over stdio (newline-delimited JSON-RPC). Resolves when stdin closes. */
+export declare function serveStdio(handler: McpHandler, input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream): Promise<void>;
+export {};