state-scenarios-cli 0.3.0 → 0.5.0

package/dist/mcp-HRQIWAIR.js

@@ -0,0 +1,342 @@
+import {
+  checkServer,
+  contextOptions,
+  launchChromium,
+  scenarioLink
+} from "./chunk-O6QTNAAZ.js";
+import {
+  CliError
+} from "./chunk-GCYOLAFU.js";
+import {
+  inspectScenario,
+  watchErrors
+} from "./chunk-YFNROT3R.js";
+
+// src/mcp.ts
+import { existsSync, writeFileSync } from "fs";
+import { dirname, join, relative } from "path";
+import { parseScenario } from "state-scenarios";
+import { unhandledRequests } from "state-scenarios/playwright";
+import { z as z2 } from "zod";
+
+// src/mcp-protocol.ts
+import { createInterface } from "readline";
+import { parseJson } from "state-scenarios";
+import { z } from "zod";
+function tool(def) {
+  return {
+    name: def.name,
+    description: def.description,
+    inputSchema: z.toJSONSchema(def.input, { io: "input" }),
+    call: async (args) => def.run(def.input.parse(args))
+  };
+}
+var Message = z.object({
+  id: z.union([z.string(), z.number()]).optional(),
+  method: z.string(),
+  params: z.looseObject({}).optional()
+});
+var CallParams = z.object({ name: z.string(), arguments: z.json().optional() });
+var ok = (id, result) => ({ jsonrpc: "2.0", id, result });
+function createMcpHandler(tools, info) {
+  const byName = new Map(tools.map((t) => [t.name, t]));
+  let queue = Promise.resolve();
+  const serial = (work) => {
+    const run = queue.then(work);
+    queue = run.then(() => {
+    }, () => {
+    });
+    return run;
+  };
+  return async (raw) => {
+    const parsed = Message.safeParse(raw);
+    if (!parsed.success) {
+      return { jsonrpc: "2.0", id: null, error: { code: -32600, message: "Invalid request" } };
+    }
+    const { id, method, params } = parsed.data;
+    if (id === void 0) return null;
+    switch (method) {
+      case "initialize":
+        return ok(id, {
+          // Answer with the client's version: the subset used here is the same in all of them.
+          protocolVersion: z.string().catch("2025-06-18").parse(params?.protocolVersion),
+          capabilities: { tools: {} },
+          serverInfo: info
+        });
+      case "ping":
+        return ok(id, {});
+      case "tools/list":
+        return ok(id, {
+          tools: tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema }))
+        });
+      case "tools/call": {
+        const call = CallParams.safeParse(params);
+        const found = call.success ? byName.get(call.data.name) : void 0;
+        if (!call.success || !found) {
+          return { jsonrpc: "2.0", id, error: { code: -32602, message: "Unknown tool" } };
+        }
+        try {
+          return ok(id, { content: await serial(() => found.call(call.data.arguments ?? {})) });
+        } catch (err) {
+          const code = err instanceof CliError ? `[${err.code}] ` : "";
+          const message = err instanceof z.ZodError ? z.prettifyError(err) : err instanceof Error ? err.message : String(err);
+          return ok(id, { content: [{ type: "text", text: `${code}${message}` }], isError: true });
+        }
+      }
+      default:
+        return { jsonrpc: "2.0", id, error: { code: -32601, message: `Method not found: ${method}` } };
+    }
+  };
+}
+function serveStdio(handle) {
+  const lines = createInterface({ input: process.stdin });
+  lines.on("line", (line) => {
+    if (!line.trim()) return;
+    let message;
+    try {
+      message = parseJson(line);
+    } catch {
+      process.stdout.write(
+        `${JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } })}
+`
+      );
+      return;
+    }
+    void handle(message).then((response) => {
+      if (response) process.stdout.write(`${JSON.stringify(response)}
+`);
+    });
+  });
+  return new Promise((resolve) => lines.on("close", resolve));
+}
+
+// src/mcp.ts
+var MAX_SNAPSHOT = 2e4;
+var text = (value) => ({ type: "text", text: value });
+var json = (value) => text(JSON.stringify(value, null, 2));
+function mcpTools({ dir, baseURL, loadCatalog, flags }) {
+  let browser;
+  let page;
+  let errors = { pageErrors: [], consoleErrors: [] };
+  const getPage = async () => {
+    if (page && !page.isClosed()) return page;
+    await checkServer(baseURL);
+    browser ??= await launchChromium();
+    const context = await browser.newContext({ baseURL, ...contextOptions(void 0, flags) });
+    page = await context.newPage();
+    page.setDefaultTimeout(1e4);
+    await page.addInitScript(() => {
+      addEventListener("DOMContentLoaded", () => {
+        const style = document.createElement("style");
+        style.textContent = "scenario-panel { display: none !important; }";
+        document.head.append(style);
+      });
+    });
+    errors = watchErrors(page);
+    return page;
+  };
+  const status = async (p) => ({
+    url: p.url(),
+    scenario: await p.evaluate(() => globalThis.stateScenariosPage?.scenario() ?? null).catch(() => null),
+    unhandled: await unhandledRequests(p).catch(() => []),
+    pageErrors: errors.pageErrors,
+    consoleErrors: errors.consoleErrors
+  });
+  const observe = async (p) => {
+    const snapshot = await p.locator("body").ariaSnapshot();
+    const cut = snapshot.length > MAX_SNAPSHOT ? `${snapshot.slice(0, MAX_SNAPSHOT)}
+\u2026 (cut)` : snapshot;
+    return [json(await status(p)), text(cut)];
+  };
+  const screenshot = async (p, selector) => ({
+    type: "image",
+    mimeType: "image/png",
+    data: (await (selector ? p.locator(selector).first().screenshot() : p.screenshot())).toString("base64")
+  });
+  const Selector = z2.string().min(1).describe(
+    'Playwright selector: text="Save", role=button[name="Save"], css, or [data-testid=x]'
+  );
+  const tools = [
+    tool({
+      name: "list_scenarios",
+      description: "Every scenario in the catalog: name, description, ready selector and the link that opens it.",
+      input: z2.object({}),
+      run: async () => {
+        const catalog = loadCatalog();
+        return [json(catalog.list.map((s) => ({
+          name: s.name,
+          description: s.description ?? "",
+          ready: s.ready ?? null,
+          link: scenarioLink(baseURL, catalog.resolve(s))
+        })))];
+      }
+    }),
+    tool({
+      name: "validate",
+      description: "Check every scenario parses, resolves its extends and passes the rules. Empty list means valid.",
+      input: z2.object({}),
+      run: async () => [json(loadCatalog().check())]
+    }),
+    tool({
+      name: "open_scenario",
+      description: "Open the app in a scenario (strict: unmocked requests get 501) and wait for its ready selector. Returns what went wrong, if anything, with a screenshot.",
+      input: z2.object({ name: z2.string().describe("Scenario name, or several joined with commas") }),
+      run: async ({ name }) => {
+        const catalog = loadCatalog();
+        const names = name.split(",").map((n) => n.trim());
+        const found = names.every((n) => catalog.get(n));
+        if (!found) {
+          throw new CliError(
+            "UNKNOWN_SCENARIO",
+            `Unknown scenario "${name}". Known: ${catalog.list.map((s) => s.name).join(", ")}`
+          );
+        }
+        const scenario = catalog.resolve(
+          catalog.get(names.join(",")) ?? { name: names.join(","), extends: names }
+        );
+        const p = await getPage();
+        errors.pageErrors.length = errors.consoleErrors.length = 0;
+        const result = await inspectScenario(p, scenario, { link: scenarioLink(baseURL, scenario) });
+        return [json(result), await screenshot(p)];
+      }
+    }),
+    tool({
+      name: "open_app",
+      description: "Open the app at a path without a scenario. record: true lets requests reach the real backend and records their JSON responses, so save_scenario can replay them offline.",
+      input: z2.object({ path: z2.string().startsWith("/").default("/"), record: z2.boolean().default(false) }),
+      run: async ({ path, record }) => {
+        const p = await getPage();
+        errors.pageErrors.length = errors.consoleErrors.length = 0;
+        const url = new URL(path, baseURL);
+        if (url.origin !== new URL(baseURL).origin) {
+          throw new CliError("INVALID_ARGUMENT", `path must stay on ${baseURL}, not "${path}"`);
+        }
+        url.searchParams.set("scenario", "");
+        if (record) url.searchParams.set("scenario-record", "");
+        await p.goto(url.toString());
+        return observe(p);
+      }
+    }),
+    tool({
+      name: "observe",
+      description: "The page as an accessibility tree (roles, names, text), plus URL, active scenario, unmocked requests and errors.",
+      input: z2.object({}),
+      run: async () => observe(await getPage())
+    }),
+    tool({
+      name: "screenshot",
+      description: "A PNG of the page, or of the first element matching selector.",
+      input: z2.object({ selector: Selector.optional() }),
+      run: async ({ selector }) => [await screenshot(await getPage(), selector)]
+    }),
+    tool({
+      name: "click",
+      description: "Click the first element matching selector.",
+      input: z2.object({ selector: Selector }),
+      run: async ({ selector }) => {
+        const p = await getPage();
+        await p.locator(selector).first().click();
+        return [json(await status(p))];
+      }
+    }),
+    tool({
+      name: "fill",
+      description: "Type a value into the input matching selector, replacing what it holds.",
+      input: z2.object({ selector: Selector, value: z2.string() }),
+      run: async ({ selector, value }) => {
+        const p = await getPage();
+        await p.locator(selector).first().fill(value);
+        return [json(await status(p))];
+      }
+    }),
+    tool({
+      name: "press",
+      description: "Press a key on the focused element, e.g. Enter, Escape, Tab, ArrowDown.",
+      input: z2.object({ key: z2.string().min(1) }),
+      run: async ({ key }) => {
+        const p = await getPage();
+        await p.keyboard.press(key);
+        return [json(await status(p))];
+      }
+    }),
+    tool({
+      name: "check_ready",
+      description: "Check a ready selector against the page now: whether it matches and is visible, plus distinctive selectors that would work. Use before save_scenario.",
+      input: z2.object({ selector: Selector }),
+      run: async ({ selector }) => {
+        const p = await getPage();
+        const report = await p.evaluate((s) => globalThis.stateScenariosPage?.checkReady(s), selector);
+        if (!report) {
+          throw new CliError(
+            "SESSION_NOT_STARTED",
+            "No scenario session on this page: is startScenarios running?"
+          );
+        }
+        return [json(report)];
+      }
+    }),
+    tool({
+      name: "save_scenario",
+      description: "Save what the app shows now (route, URL params, mocked and recorded responses, adapter state) as <dir>/<name>.json. extends writes only the differences from that scenario. Recorded secrets are redacted.",
+      input: z2.object({
+        name: z2.string().regex(/^[a-z0-9][a-z0-9-]*$/, "kebab-case, e.g. orders-empty"),
+        description: z2.string().optional(),
+        ready: Selector.optional().describe(
+          "Selector visible once this state shows; check it with check_ready first"
+        ),
+        extends: z2.string().optional().describe('Base scenario, usually "default"'),
+        replace: z2.boolean().default(false).describe("Overwrite an existing file")
+      }),
+      run: async ({ replace, ...options }) => {
+        const p = await getPage();
+        const file = join(dir, `${options.name}.json`);
+        if (existsSync(file) && !replace) {
+          throw new CliError(
+            "INVALID_ARGUMENT",
+            `${file} already exists; pass replace: true to overwrite it`
+          );
+        }
+        const captured = await p.evaluate(
+          (o) => globalThis.stateScenariosPage?.capture(o),
+          options
+        );
+        if (!captured) {
+          throw new CliError(
+            "SESSION_NOT_STARTED",
+            "No scenario session on this page: is startScenarios running?"
+          );
+        }
+        parseScenario(captured);
+        const schema = join(dirname(dir), "scenario.schema.json");
+        const $schema = existsSync(schema) ? relative(dir, schema).replaceAll("\\", "/") : void 0;
+        writeFileSync(file, `${JSON.stringify({ $schema, ...captured }, null, 2)}
+`);
+        const problems = loadCatalog().check().filter((m) => m.includes(`"${options.name}"`));
+        return [json({
+          saved: file,
+          problems,
+          extends: captured.extends ?? null,
+          path: captured.path ?? null,
+          url: captured.url ?? {},
+          network: (captured.network ?? []).map(
+            (e) => `${e.method ?? "GET"} ${e.path}${e.remove ? " (removed)" : ""}`
+          ),
+          handlers: captured.handlers ?? [],
+          state: Object.keys(captured.state ?? {}),
+          ready: captured.ready ?? null
+        })];
+      }
+    })
+  ];
+  return { tools, close: async () => browser?.close() };
+}
+async function serveMcp(options) {
+  const { tools, close } = mcpTools(options);
+  await serveStdio(createMcpHandler(tools, { name: "state-scenarios", version: options.version }));
+  await close();
+}
+export {
+  mcpTools,
+  serveMcp
+};
+//# sourceMappingURL=mcp-HRQIWAIR.js.map

package/dist/mcp-HRQIWAIR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts","../src/mcp-protocol.ts"],"sourcesContent":["import type { Browser, Page } from '@playwright/test';\nimport { existsSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative } from 'node:path';\nimport { type Catalog, parseScenario, type ScenarioInput } from 'state-scenarios';\nimport { unhandledRequests } from 'state-scenarios/playwright';\nimport { z } from 'zod';\nimport { type BrowserFlags, checkServer, contextOptions, launchChromium, scenarioLink } from './browser.js';\nimport { CliError } from './errors.js';\nimport { inspectScenario, watchErrors } from './inspect.js';\nimport { type Content, createMcpHandler, serveStdio, tool } from './mcp-protocol.js';\n\nconst MAX_SNAPSHOT = 20_000;\n\nexport interface McpOptions {\n  dir: string;\n  baseURL: string;\n  /** Reads the scenarios folder again, so files saved during the session show up. */\n  loadCatalog: () => Catalog;\n  flags: BrowserFlags;\n  version: string;\n}\n\nconst text = (value: string): Content => ({ type: 'text', text: value });\n\nconst json = (value: Parameters<typeof JSON.stringify>[0]): Content => text(JSON.stringify(value, null, 2));\n\n/**\n * Tools that let a coding agent open the app in any scenario, look at it, drive it, and save\n * what it shows as a new scenario. One browser page per server; each agent starts its own server.\n */\nexport function mcpTools({ dir, baseURL, loadCatalog, flags }: McpOptions) {\n  let browser: Browser | undefined;\n  let page: Page | undefined;\n  let errors: ReturnType<typeof watchErrors> = { pageErrors: [], consoleErrors: [] };\n\n  const getPage = async () => {\n    if (page && !page.isClosed()) return page;\n    await checkServer(baseURL);\n    browser ??= await launchChromium();\n    const context = await browser.newContext({ baseURL, ...contextOptions(undefined, flags) });\n    page = await context.newPage();\n    page.setDefaultTimeout(10_000);\n    // Agents read the page through the accessibility tree; the dev panel would only add noise.\n    await page.addInitScript(() => {\n      addEventListener('DOMContentLoaded', () => {\n        const style = document.createElement('style');\n        style.textContent = 'scenario-panel { display: none !important; }';\n        document.head.append(style);\n      });\n    });\n    errors = watchErrors(page);\n\n    return page;\n  };\n\n  const status = async (p: Page) => ({\n    url: p.url(),\n    scenario: await p.evaluate(() => globalThis.stateScenariosPage?.scenario() ?? null).catch(() => null),\n    unhandled: await unhandledRequests(p).catch(() => []),\n    pageErrors: errors.pageErrors,\n    consoleErrors: errors.consoleErrors,\n  });\n\n  const observe = async (p: Page): Promise<Content[]> => {\n    const snapshot = await p.locator('body').ariaSnapshot();\n    const cut = snapshot.length > MAX_SNAPSHOT ? `${snapshot.slice(0, MAX_SNAPSHOT)}\\n… (cut)` : snapshot;\n\n    return [json(await status(p)), text(cut)];\n  };\n\n  const screenshot = async (p: Page, selector?: string): Promise<Content> => ({\n    type: 'image',\n    mimeType: 'image/png',\n    data: (await (selector ? p.locator(selector).first().screenshot() : p.screenshot())).toString('base64'),\n  });\n\n  const Selector = z.string().min(1).describe(\n    'Playwright selector: text=\"Save\", role=button[name=\"Save\"], css, or [data-testid=x]',\n  );\n\n  const tools = [\n    tool({\n      name: 'list_scenarios',\n      description:\n        'Every scenario in the catalog: name, description, ready selector and the link that opens it.',\n      input: z.object({}),\n      run: async () => {\n        const catalog = loadCatalog();\n\n        return [json(catalog.list.map((s) => ({\n          name: s.name,\n          description: s.description ?? '',\n          ready: s.ready ?? null,\n          link: scenarioLink(baseURL, catalog.resolve(s)),\n        })))];\n      },\n    }),\n    tool({\n      name: 'validate',\n      description:\n        'Check every scenario parses, resolves its extends and passes the rules. Empty list means valid.',\n      input: z.object({}),\n      run: async () => [json(loadCatalog().check())],\n    }),\n    tool({\n      name: 'open_scenario',\n      description:\n        'Open the app in a scenario (strict: unmocked requests get 501) and wait for its ready selector. Returns what went wrong, if anything, with a screenshot.',\n      input: z.object({ name: z.string().describe('Scenario name, or several joined with commas') }),\n      run: async ({ name }) => {\n        const catalog = loadCatalog();\n        const names = name.split(',').map((n) => n.trim());\n        const found = names.every((n) => catalog.get(n));\n\n        if (!found) {\n          throw new CliError(\n            'UNKNOWN_SCENARIO',\n            `Unknown scenario \"${name}\". Known: ${catalog.list.map((s) => s.name).join(', ')}`,\n          );\n        }\n\n        const scenario = catalog.resolve(\n          catalog.get(names.join(',')) ?? { name: names.join(','), extends: names },\n        );\n\n        const p = await getPage();\n        errors.pageErrors.length = errors.consoleErrors.length = 0;\n        const result = await inspectScenario(p, scenario, { link: scenarioLink(baseURL, scenario) });\n\n        return [json(result), await screenshot(p)];\n      },\n    }),\n    tool({\n      name: 'open_app',\n      description:\n        'Open the app at a path without a scenario. record: true lets requests reach the real backend and records their JSON responses, so save_scenario can replay them offline.',\n      input: z.object({ path: z.string().startsWith('/').default('/'), record: z.boolean().default(false) }),\n      run: async ({ path, record }) => {\n        const p = await getPage();\n        errors.pageErrors.length = errors.consoleErrors.length = 0;\n        const url = new URL(path, baseURL);\n\n        // `//host/...` is a path to URL parsing but leaves the app.\n        if (url.origin !== new URL(baseURL).origin) {\n          throw new CliError('INVALID_ARGUMENT', `path must stay on ${baseURL}, not \"${path}\"`);\n        }\n\n        url.searchParams.set('scenario', '');\n\n        if (record) url.searchParams.set('scenario-record', '');\n        await p.goto(url.toString());\n\n        return observe(p);\n      },\n    }),\n    tool({\n      name: 'observe',\n      description:\n        'The page as an accessibility tree (roles, names, text), plus URL, active scenario, unmocked requests and errors.',\n      input: z.object({}),\n      run: async () => observe(await getPage()),\n    }),\n    tool({\n      name: 'screenshot',\n      description: 'A PNG of the page, or of the first element matching selector.',\n      input: z.object({ selector: Selector.optional() }),\n      run: async ({ selector }) => [await screenshot(await getPage(), selector)],\n    }),\n    tool({\n      name: 'click',\n      description: 'Click the first element matching selector.',\n      input: z.object({ selector: Selector }),\n      run: async ({ selector }) => {\n        const p = await getPage();\n        await p.locator(selector).first().click();\n\n        return [json(await status(p))];\n      },\n    }),\n    tool({\n      name: 'fill',\n      description: 'Type a value into the input matching selector, replacing what it holds.',\n      input: z.object({ selector: Selector, value: z.string() }),\n      run: async ({ selector, value }) => {\n        const p = await getPage();\n        await p.locator(selector).first().fill(value);\n\n        return [json(await status(p))];\n      },\n    }),\n    tool({\n      name: 'press',\n      description: 'Press a key on the focused element, e.g. Enter, Escape, Tab, ArrowDown.',\n      input: z.object({ key: z.string().min(1) }),\n      run: async ({ key }) => {\n        const p = await getPage();\n        await p.keyboard.press(key);\n\n        return [json(await status(p))];\n      },\n    }),\n    tool({\n      name: 'check_ready',\n      description:\n        'Check a ready selector against the page now: whether it matches and is visible, plus distinctive selectors that would work. Use before save_scenario.',\n      input: z.object({ selector: Selector }),\n      run: async ({ selector }) => {\n        const p = await getPage();\n        const report = await p.evaluate((s) => globalThis.stateScenariosPage?.checkReady(s), selector);\n\n        if (!report) {\n          throw new CliError(\n            'SESSION_NOT_STARTED',\n            'No scenario session on this page: is startScenarios running?',\n          );\n        }\n\n        return [json(report)];\n      },\n    }),\n    tool({\n      name: 'save_scenario',\n      description:\n        'Save what the app shows now (route, URL params, mocked and recorded responses, adapter state) as <dir>/<name>.json. extends writes only the differences from that scenario. Recorded secrets are redacted.',\n      input: z.object({\n        name: z.string().regex(/^[a-z0-9][a-z0-9-]*$/, 'kebab-case, e.g. orders-empty'),\n        description: z.string().optional(),\n        ready: Selector.optional().describe(\n          'Selector visible once this state shows; check it with check_ready first',\n        ),\n        extends: z.string().optional().describe('Base scenario, usually \"default\"'),\n        replace: z.boolean().default(false).describe('Overwrite an existing file'),\n      }),\n      run: async ({ replace, ...options }) => {\n        const p = await getPage();\n        const file = join(dir, `${options.name}.json`);\n\n        if (existsSync(file) && !replace) {\n          throw new CliError(\n            'INVALID_ARGUMENT',\n            `${file} already exists; pass replace: true to overwrite it`,\n          );\n        }\n\n        const captured: ScenarioInput | undefined = await p.evaluate(\n          (o) => globalThis.stateScenariosPage?.capture(o),\n          options,\n        );\n\n        if (!captured) {\n          throw new CliError(\n            'SESSION_NOT_STARTED',\n            'No scenario session on this page: is startScenarios running?',\n          );\n        }\n\n        parseScenario(captured);\n        const schema = join(dirname(dir), 'scenario.schema.json');\n        const $schema = existsSync(schema) ? relative(dir, schema).replaceAll('\\\\', '/') : undefined;\n        writeFileSync(file, `${JSON.stringify({ $schema, ...captured }, null, 2)}\\n`);\n        // Resolve with the catalog on disk, so a bad extends or rule shows now, not later.\n        const problems = loadCatalog().check().filter((m) => m.includes(`\"${options.name}\"`));\n\n        // A summary: captured state can be megabytes, too much for an agent's context. The file has it all.\n        return [json({\n          saved: file,\n          problems,\n          extends: captured.extends ?? null,\n          path: captured.path ?? null,\n          url: captured.url ?? {},\n          network: (captured.network ?? []).map((e) =>\n            `${e.method ?? 'GET'} ${e.path}${e.remove ? ' (removed)' : ''}`\n          ),\n          handlers: captured.handlers ?? [],\n          state: Object.keys(captured.state ?? {}),\n          ready: captured.ready ?? null,\n        })];\n      },\n    }),\n  ];\n\n  return { tools, close: async () => browser?.close() };\n}\n\nexport async function serveMcp(options: McpOptions) {\n  const { tools, close } = mcpTools(options);\n  await serveStdio(createMcpHandler(tools, { name: 'state-scenarios', version: options.version }));\n  await close();\n}\n","import { createInterface } from 'node:readline';\nimport { type Json, parseJson } from 'state-scenarios';\nimport { z } from 'zod';\nimport { CliError } from './errors.js';\n\nexport type Content = { type: 'text'; text: string; } | { type: 'image'; data: string; mimeType: string; };\n\nexport interface McpTool {\n  name: string;\n  description: string;\n  inputSchema: z.core.JSONSchema.BaseSchema;\n  call(args: Json): Promise<Content[]>;\n}\n\n/** Define a tool whose arguments are checked against `input` before `run` sees them. */\nexport function tool<S extends z.ZodObject>(\n  def: { name: string; description: string; input: S; run(args: z.output<S>): Promise<Content[]>; },\n): McpTool {\n  return {\n    name: def.name,\n    description: def.description,\n    inputSchema: z.toJSONSchema(def.input, { io: 'input' }),\n    call: async (args) => def.run(def.input.parse(args)),\n  };\n}\n\nconst Message = z.object({\n  id: z.union([z.string(), z.number()]).optional(),\n  method: z.string(),\n  params: z.looseObject({}).optional(),\n});\n\nconst CallParams = z.object({ name: z.string(), arguments: z.json().optional() });\n\nconst ok = <T>(id: string | number, result: T) => ({ jsonrpc: '2.0', id, result });\n\n/**\n * Minimal MCP over JSON-RPC: initialize, ping, tools/list and tools/call. Returns the\n * response to send, or null for notifications.\n */\nexport function createMcpHandler(tools: McpTool[], info: { name: string; version: string; }) {\n  const byName = new Map(tools.map((t) => [t.name, t]));\n  // Tools share one browser page: run calls one at a time, in arrival order, so an overlapping\n  // navigation or click can't land in the middle of another call.\n  let queue: Promise<void> = Promise.resolve();\n\n  const serial = <T>(work: () => Promise<T>) => {\n    const run = queue.then(work);\n    queue = run.then(() => {}, () => {});\n\n    return run;\n  };\n\n  return async (raw: Json) => {\n    const parsed = Message.safeParse(raw);\n\n    if (!parsed.success) {\n      return { jsonrpc: '2.0', id: null, error: { code: -32600, message: 'Invalid request' } };\n    }\n\n    const { id, method, params } = parsed.data;\n\n    if (id === undefined) return null; // a notification, e.g. notifications/initialized\n\n    switch (method) {\n      case 'initialize':\n        return ok(id, {\n          // Answer with the client's version: the subset used here is the same in all of them.\n          protocolVersion: z.string().catch('2025-06-18').parse(params?.protocolVersion),\n          capabilities: { tools: {} },\n          serverInfo: info,\n        });\n      case 'ping':\n        return ok(id, {});\n      case 'tools/list':\n        return ok(id, {\n          tools: tools.map(({ name, description, inputSchema }) => ({ name, description, inputSchema })),\n        });\n      case 'tools/call': {\n        const call = CallParams.safeParse(params);\n        const found = call.success ? byName.get(call.data.name) : undefined;\n\n        if (!call.success || !found) {\n          return { jsonrpc: '2.0', id, error: { code: -32602, message: 'Unknown tool' } };\n        }\n\n        try {\n          return ok(id, { content: await serial(() => found.call(call.data.arguments ?? {})) });\n        } catch (err) {\n          const code = err instanceof CliError ? `[${err.code}] ` : '';\n\n          const message = err instanceof z.ZodError\n            ? z.prettifyError(err)\n            : err instanceof Error\n            ? err.message\n            : String(err);\n\n          return ok(id, { content: [{ type: 'text', text: `${code}${message}` }], isError: true });\n        }\n      }\n\n      default:\n        return { jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${method}` } };\n    }\n  };\n}\n\n/** Serve newline-delimited JSON-RPC on stdin/stdout. Logs must go to stderr. */\nexport function serveStdio(handle: ReturnType<typeof createMcpHandler>) {\n  const lines = createInterface({ input: process.stdin });\n\n  lines.on('line', (line) => {\n    if (!line.trim()) return;\n    let message: Json;\n\n    try {\n      message = parseJson(line);\n    } catch {\n      process.stdout.write(\n        `${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } })}\\n`,\n      );\n\n      return;\n    }\n\n    void handle(message).then((response) => {\n      if (response) process.stdout.write(`${JSON.stringify(response)}\\n`);\n    });\n  });\n\n  return new Promise<void>((resolve) => lines.on('close', resolve));\n}\n"],"mappings":"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","names":["z","z"]}

package/dist/mcp-protocol.d.ts

@@ -0,0 +1,51 @@
+import { type Json } from 'state-scenarios';
+import { z } from 'zod';
+export type Content = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+};
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: z.core.JSONSchema.BaseSchema;
+    call(args: Json): Promise<Content[]>;
+}
+/** Define a tool whose arguments are checked against `input` before `run` sees them. */
+export declare function tool<S extends z.ZodObject>(def: {
+    name: string;
+    description: string;
+    input: S;
+    run(args: z.output<S>): Promise<Content[]>;
+}): McpTool;
+/**
+ * Minimal MCP over JSON-RPC: initialize, ping, tools/list and tools/call. Returns the
+ * response to send, or null for notifications.
+ */
+export declare function createMcpHandler(tools: McpTool[], info: {
+    name: string;
+    version: string;
+}): (raw: Json) => Promise<{
+    jsonrpc: string;
+    id: string | number;
+    result: {};
+} | {
+    jsonrpc: string;
+    id: null;
+    error: {
+        code: number;
+        message: string;
+    };
+} | {
+    jsonrpc: string;
+    id: string | number;
+    error: {
+        code: number;
+        message: string;
+    };
+} | null>;
+/** Serve newline-delimited JSON-RPC on stdin/stdout. Logs must go to stderr. */
+export declare function serveStdio(handle: ReturnType<typeof createMcpHandler>): Promise<void>;

package/dist/mcp.d.ts

@@ -0,0 +1,19 @@
+import { type Catalog } from 'state-scenarios';
+import { type BrowserFlags } from './browser.js';
+export interface McpOptions {
+    dir: string;
+    baseURL: string;
+    /** Reads the scenarios folder again, so files saved during the session show up. */
+    loadCatalog: () => Catalog;
+    flags: BrowserFlags;
+    version: string;
+}
+/**
+ * Tools that let a coding agent open the app in any scenario, look at it, drive it, and save
+ * what it shows as a new scenario. One browser page per server; each agent starts its own server.
+ */
+export declare function mcpTools({ dir, baseURL, loadCatalog, flags }: McpOptions): {
+    tools: import("./mcp-protocol.js").McpTool[];
+    close: () => Promise<void | undefined>;
+};
+export declare function serveMcp(options: McpOptions): Promise<void>;

package/dist/record-HXIYGMWA.js

@@ -0,0 +1,65 @@
+import {
+  CliError
+} from "./chunk-GCYOLAFU.js";
+
+// src/record.ts
+import { spawnSync } from "child_process";
+import { copyFileSync } from "fs";
+function visibleCrop(box, viewport) {
+  const x = Math.max(0, box.x);
+  const y = Math.max(0, box.y);
+  const width = Math.min(viewport.width, box.x + box.width) - x;
+  const height = Math.min(viewport.height, box.y + box.height) - y;
+  if (width < 2 || height < 2) return void 0;
+  return { crop: { x, y, width, height }, clipped: width < box.width || height < box.height };
+}
+var even = (n) => Math.max(2, Math.floor(n / 2) * 2);
+function ffmpegArgs({ input, output, format, start, crop, fps, width }) {
+  const rate = fps ?? (format === "gif" ? 12 : void 0);
+  const filters = [
+    crop && `crop=${even(crop.width)}:${even(crop.height)}:${Math.round(crop.x)}:${Math.round(crop.y)}`,
+    rate && `fps=${rate}`,
+    // Quoted so the comma in min() isn't read as a filter separator.
+    width && `scale='trunc(min(${width},iw)/2)*2':-2:flags=lanczos`
+  ].filter(Boolean);
+  const codec = {
+    mp4: ["-c:v", "libx264", "-pix_fmt", "yuv420p", "-crf", "23", "-movflags", "+faststart"],
+    webm: ["-c:v", "libvpx-vp9", "-b:v", "0", "-crf", "32"],
+    gif: []
+  }[format];
+  const vf = format === "gif" ? `${filters.join(",")},split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer` : filters.join(",");
+  return [
+    "-y",
+    "-loglevel",
+    "error",
+    "-i",
+    input,
+    "-ss",
+    start.toFixed(2),
+    ...vf ? ["-vf", vf] : [],
+    "-an",
+    ...codec,
+    output
+  ];
+}
+function encodeVideo(options) {
+  if (options.format === "webm" && !options.crop && !options.fps && !options.width) {
+    copyFileSync(options.input, options.output);
+    return;
+  }
+  const ffmpeg = process.env.FFMPEG_PATH || "ffmpeg";
+  const result = spawnSync(ffmpeg, ffmpegArgs(options), { encoding: "utf8" });
+  if (result.error) {
+    throw new CliError(
+      "FFMPEG_MISSING",
+      `record needs ffmpeg for ${options.format}${options.format === "webm" ? " with --element, --fps or --width" : ""}: install it (https://ffmpeg.org/download.html) or set FFMPEG_PATH`
+    );
+  }
+  if (result.status !== 0) throw new Error(`ffmpeg failed: ${result.stderr.trim()}`);
+}
+export {
+  encodeVideo,
+  ffmpegArgs,
+  visibleCrop
+};
+//# sourceMappingURL=record-HXIYGMWA.js.map

package/dist/record-HXIYGMWA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/record.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process';\nimport { copyFileSync } from 'node:fs';\nimport { CliError } from './errors.js';\n\nexport type VideoFormat = 'mp4' | 'gif' | 'webm';\n\nexport interface Crop {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/**\n * The part of an element's box the video shows. Video holds only the viewport, so a crop must\n * stay inside it; `clipped` says the element was larger than the visible area.\n */\nexport function visibleCrop(box: Crop, viewport: { width: number; height: number; }) {\n  const x = Math.max(0, box.x);\n  const y = Math.max(0, box.y);\n  const width = Math.min(viewport.width, box.x + box.width) - x;\n  const height = Math.min(viewport.height, box.y + box.height) - y;\n\n  if (width < 2 || height < 2) return undefined;\n\n  return { crop: { x, y, width, height }, clipped: width < box.width || height < box.height };\n}\n\nconst even = (n: number) => Math.max(2, Math.floor(n / 2) * 2);\n\n/**\n * ffmpeg arguments that trim the page load off the start, crop to an element, and encode.\n * MP4 is H.264 in yuv420p so it plays everywhere, including Safari and phones; GIF uses a\n * generated palette, which keeps it sharp at a fraction of the naive size.\n */\nexport function ffmpegArgs(\n  { input, output, format, start, crop, fps, width }: {\n    input: string;\n    output: string;\n    format: VideoFormat;\n    /** Seconds to skip, e.g. the page loading before the steps begin. */\n    start: number;\n    crop?: Crop;\n    /** Frames per second; GIFs default to 12. */\n    fps?: number;\n    /** Maximum output width in pixels, never upscaled; height follows the aspect ratio. */\n    width?: number;\n  },\n): string[] {\n  const rate = fps ?? (format === 'gif' ? 12 : undefined);\n\n  // yuv420p needs even sizes.\n  const filters = [\n    crop && `crop=${even(crop.width)}:${even(crop.height)}:${Math.round(crop.x)}:${Math.round(crop.y)}`,\n    rate && `fps=${rate}`,\n    // Quoted so the comma in min() isn't read as a filter separator.\n    width && `scale='trunc(min(${width},iw)/2)*2':-2:flags=lanczos`,\n  ].filter(Boolean);\n\n  const codec = {\n    mp4: ['-c:v', 'libx264', '-pix_fmt', 'yuv420p', '-crf', '23', '-movflags', '+faststart'],\n    webm: ['-c:v', 'libvpx-vp9', '-b:v', '0', '-crf', '32'],\n    gif: [],\n  }[format];\n\n  const vf = format === 'gif'\n    ? `${filters.join(',')},split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=bayer`\n    : filters.join(',');\n\n  return [\n    '-y',\n    '-loglevel',\n    'error',\n    '-i',\n    input,\n    '-ss',\n    start.toFixed(2),\n    ...(vf ? ['-vf', vf] : []),\n    '-an',\n    ...codec,\n    output,\n  ];\n}\n\n/**\n * Convert Playwright's WebM into the requested format. WebM without a crop, --fps or --width is\n * copied as recorded (page load included), so it works without ffmpeg.\n */\nexport function encodeVideo(options: Parameters<typeof ffmpegArgs>[0]) {\n  if (options.format === 'webm' && !options.crop && !options.fps && !options.width) {\n    copyFileSync(options.input, options.output);\n\n    return;\n  }\n\n  // FFMPEG_PATH is the usual override when ffmpeg isn't on PATH (common on Windows).\n  const ffmpeg = process.env.FFMPEG_PATH || 'ffmpeg';\n  const result = spawnSync(ffmpeg, ffmpegArgs(options), { encoding: 'utf8' });\n\n  if (result.error) {\n    throw new CliError(\n      'FFMPEG_MISSING',\n      `record needs ffmpeg for ${options.format}${\n        options.format === 'webm' ? ' with --element, --fps or --width' : ''\n      }: install it (https://ffmpeg.org/download.html) or set FFMPEG_PATH`,\n    );\n  }\n\n  if (result.status !== 0) throw new Error(`ffmpeg failed: ${result.stderr.trim()}`);\n}\n"],"mappings":";;;;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,oBAAoB;AAgBtB,SAAS,YAAY,KAAW,UAA8C;AACnF,QAAM,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;AAC3B,QAAM,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;AAC3B,QAAM,QAAQ,KAAK,IAAI,SAAS,OAAO,IAAI,IAAI,IAAI,KAAK,IAAI;AAC5D,QAAM,SAAS,KAAK,IAAI,SAAS,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI;AAE/D,MAAI,QAAQ,KAAK,SAAS,EAAG,QAAO;AAEpC,SAAO,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,OAAO,GAAG,SAAS,QAAQ,IAAI,SAAS,SAAS,IAAI,OAAO;AAC5F;AAEA,IAAM,OAAO,CAAC,MAAc,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC;AAOtD,SAAS,WACd,EAAE,OAAO,QAAQ,QAAQ,OAAO,MAAM,KAAK,MAAM,GAYvC;AACV,QAAM,OAAO,QAAQ,WAAW,QAAQ,KAAK;AAG7C,QAAM,UAAU;AAAA,IACd,QAAQ,QAAQ,KAAK,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC;AAAA,IACjG,QAAQ,OAAO,IAAI;AAAA;AAAA,IAEnB,SAAS,oBAAoB,KAAK;AAAA,EACpC,EAAE,OAAO,OAAO;AAEhB,QAAM,QAAQ;AAAA,IACZ,KAAK,CAAC,QAAQ,WAAW,YAAY,WAAW,QAAQ,MAAM,aAAa,YAAY;AAAA,IACvF,MAAM,CAAC,QAAQ,cAAc,QAAQ,KAAK,QAAQ,IAAI;AAAA,IACtD,KAAK,CAAC;AAAA,EACR,EAAE,MAAM;AAER,QAAM,KAAK,WAAW,QAClB,GAAG,QAAQ,KAAK,GAAG,CAAC,gFACpB,QAAQ,KAAK,GAAG;AAEpB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,MAAM,QAAQ,CAAC;AAAA,IACf,GAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;AAAA,IACxB;AAAA,IACA,GAAG;AAAA,IACH;AAAA,EACF;AACF;AAMO,SAAS,YAAY,SAA2C;AACrE,MAAI,QAAQ,WAAW,UAAU,CAAC,QAAQ,QAAQ,CAAC,QAAQ,OAAO,CAAC,QAAQ,OAAO;AAChF,iBAAa,QAAQ,OAAO,QAAQ,MAAM;AAE1C;AAAA,EACF;AAGA,QAAM,SAAS,QAAQ,IAAI,eAAe;AAC1C,QAAM,SAAS,UAAU,QAAQ,WAAW,OAAO,GAAG,EAAE,UAAU,OAAO,CAAC;AAE1E,MAAI,OAAO,OAAO;AAChB,UAAM,IAAI;AAAA,MACR;AAAA,MACA,2BAA2B,QAAQ,MAAM,GACvC,QAAQ,WAAW,SAAS,sCAAsC,EACpE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,OAAO,WAAW,EAAG,OAAM,IAAI,MAAM,kBAAkB,OAAO,OAAO,KAAK,CAAC,EAAE;AACnF;","names":[]}

package/dist/record.d.ts

@@ -0,0 +1,45 @@
+export type VideoFormat = 'mp4' | 'gif' | 'webm';
+export interface Crop {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The part of an element's box the video shows. Video holds only the viewport, so a crop must
+ * stay inside it; `clipped` says the element was larger than the visible area.
+ */
+export declare function visibleCrop(box: Crop, viewport: {
+    width: number;
+    height: number;
+}): {
+    crop: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    clipped: boolean;
+} | undefined;
+/**
+ * ffmpeg arguments that trim the page load off the start, crop to an element, and encode.
+ * MP4 is H.264 in yuv420p so it plays everywhere, including Safari and phones; GIF uses a
+ * generated palette, which keeps it sharp at a fraction of the naive size.
+ */
+export declare function ffmpegArgs({ input, output, format, start, crop, fps, width }: {
+    input: string;
+    output: string;
+    format: VideoFormat;
+    /** Seconds to skip, e.g. the page loading before the steps begin. */
+    start: number;
+    crop?: Crop;
+    /** Frames per second; GIFs default to 12. */
+    fps?: number;
+    /** Maximum output width in pixels, never upscaled; height follows the aspect ratio. */
+    width?: number;
+}): string[];
+/**
+ * Convert Playwright's WebM into the requested format. WebM without a crop, --fps or --width is
+ * copied as recorded (page load included), so it works without ffmpeg.
+ */
+export declare function encodeVideo(options: Parameters<typeof ffmpegArgs>[0]): void;