@agent-surface/cli 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wiseair S.r.l.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @agent-surface/cli
+
+Inspect and check the agent surface your app exposes — from a terminal, and in CI. Part of [agent-surface](https://github.com/Wiseair-srl/agent-surface).
+
+Docs: https://agent-surface-docs.vercel.app/20-cli
+
+## Install
+
+```bash
+pnpm add -D @agent-surface/cli
+```
+
+## Configure
+
+A presentation surface only exists once components mount — it is a projection of *what is mounted × route × host context × consumer × policy × live `when()`*. So there is nothing static to read, and the CLI mounts your app. It does not re-implement it: the config points at the composition root you already have.
+
+```tsx
+// agent-surface.config.tsx
+import { defineSurface } from "@agent-surface/cli";
+import { createApp } from "./src/agent/setup.js";   // already exists
+import { App } from "./src/app/App.js";             // already exists
+
+export default defineSurface({
+  mount: ({ user }) => {
+    const app = createApp({ environment: "test", user });
+    return { registry: app.registry, ui: <App app={app} />, app };
+  },
+  scenarios: {
+    admin:     { user: { id: "u_admin", permissions: ["devices:write"] } },
+    anonymous: { user: null },
+  },
+});
+```
+
+Loading goes through vite-node on your own `vite.config.*`, so your aliases, plugins and TSX resolve exactly as they do in dev.
+
+## Use
+
+```bash
+agent-surface inspect [scenario]    # what an agent can see right now
+agent-surface snapshot [scenario]   # write/refresh the committed baseline
+agent-surface check [scenario]      # exit non-zero when the surface drifts
+```
+
+```text
+scenario admin  route /devices
+9 callable, 2 visible-disabled
+
+devices.drawer  (3)
+  + open   [local-state, reversible]
+       Open the detail drawer for a device
+  ~ close  [local-state, reversible]
+       Close the detail drawer
+       reason: The drawer is not open
+
+authoritative (domain)  (1)
+  ~ devices.disable  [destructive, confirmation:required, deviceIds bound+locked]
+       Disable the given devices
+       reason: Select at least one device first
+```
+
+### Why is my capability missing?
+
+`snapshot()` bakes policy outcomes: a `hide` removes the capability *and* the reason, because the existence of a hidden capability is itself information. Correct at the agent boundary, useless when you are the developer. `--explain` answers it:
+
+```bash
+agent-surface inspect anonymous --explain
+```
+
+```text
+0 callable, 0 visible-disabled, 11 hidden
+
+hidden by policy (absent from the snapshot)  (11)
+  - set  [devices.filters@default]
+       Update one or both filters; omitted fields are unchanged.
+       policy authenticated (registry, discovery/authorize): hide
+```
+
+Every policy in the chain, in the order it runs, with its own vote, the layer it came from, and whether its `onDiscovery` threw. Availability is reported apart from the policy votes — *authority hides, state discloses*, and the two failures must never look alike.
+
+### The scenarios are not a fixture
+
+The same definitions drive your test suite, so "admin on /devices" exists once rather than twice:
+
+```ts
+import config from "../agent-surface.config.js";
+import { mountScenario } from "@agent-surface/cli/vitest";
+
+const { surface, app } = await mountScenario(config, "admin");
+expect(surface).toExpose("view:devices.filters.set");
+```
+
+## Notes
+
+Requires `@testing-library/react` and `react-dom` (peers) — it mounts your real tree in jsdom. Anything needing a real browser is out of reach by construction. Output falls back to plain text when piped, or under `--plain`, `CI` and `NO_COLOR`.
+
+Full specification: [docs/20](https://github.com/Wiseair-srl/agent-surface/blob/main/docs/20-cli.md).
+
+MIT © Wiseair S.r.l.

package/dist/bin.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import {
+  findConfig,
+  write,
+  writeError
+} from "./chunk-S2LM3N6D.js";
+
+// src/bin.ts
+import { realpathSync } from "fs";
+import { fileURLToPath } from "url";
+import { parseArgs } from "util";
+
+// src/dom.ts
+import { JSDOM } from "jsdom";
+function installDom(url = "http://localhost/") {
+  const globals = globalThis;
+  if (typeof globals["document"] !== "undefined") return noop;
+  const dom = new JSDOM("<!doctype html><html><body></body></html>", {
+    url,
+    pretendToBeVisual: true
+  });
+  const { window } = dom;
+  for (const key of Object.getOwnPropertyNames(window)) {
+    if (key.startsWith("_")) continue;
+    if (key in globals) continue;
+    const descriptor = Object.getOwnPropertyDescriptor(window, key);
+    if (!descriptor) continue;
+    Object.defineProperty(globals, key, descriptor);
+  }
+  for (const key of ["window", "document", "navigator"]) {
+    if (!(key in globals)) {
+      Object.defineProperty(globals, key, { value: window[key], configurable: true });
+    }
+  }
+  return noop;
+}
+function noop() {
+}
+
+// src/bin.ts
+var USAGE = `agent-surface \u2014 inspect and check the agent surface your app exposes
+
+Usage
+  agent-surface inspect  [scenario]   what an agent can see right now
+  agent-surface snapshot [scenario]   write/refresh the committed baseline
+  agent-surface check    [scenario]   fail if the surface drifted from the baseline
+
+Options
+  --config <path>   path to agent-surface.config.* (default: nearest, searching upward)
+  --baseline-dir    where baselines live (default: .agent-surface next to the config)
+  --scope <prefix>  restrict to a component-type prefix (repeatable)
+  --explain         name the policies behind every decision, hidden ones included
+  --schemas         include input/output JSON Schemas
+  --json            emit data instead of a rendered view
+  --plain           force plain text (implied when piped, or under CI / NO_COLOR)
+  -h, --help        show this
+  -v, --version     print the version
+`;
+async function main(argv = process.argv.slice(2)) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: argv,
+      allowPositionals: true,
+      options: {
+        config: { type: "string" },
+        "baseline-dir": { type: "string" },
+        scope: { type: "string", multiple: true },
+        explain: { type: "boolean", default: false },
+        schemas: { type: "boolean", default: false },
+        json: { type: "boolean", default: false },
+        plain: { type: "boolean", default: false },
+        help: { type: "boolean", short: "h", default: false },
+        version: { type: "boolean", short: "v", default: false }
+      }
+    });
+  } catch (error) {
+    writeError(error instanceof Error ? error.message : String(error));
+    writeError(USAGE);
+    return 2;
+  }
+  const { values, positionals } = parsed;
+  if (values.help) {
+    write(USAGE);
+    return 0;
+  }
+  if (values.version) {
+    write(await readVersion());
+    return 0;
+  }
+  const [command, scenario] = positionals;
+  if (!command) {
+    write(USAGE);
+    return 2;
+  }
+  if (!["inspect", "snapshot", "check"].includes(command)) {
+    writeError(`unknown command "${command}"`);
+    writeError(USAGE);
+    return 2;
+  }
+  const configPath = values.config ?? findConfig();
+  if (!configPath) {
+    writeError(
+      "no agent-surface.config.* found (searched upward from the working directory).\nCreate one that points at your app's composition root \u2014 see https://agent-surface-docs.vercel.app/20-cli"
+    );
+    return 2;
+  }
+  const uninstallDom = installDom();
+  try {
+    const shared = {
+      configPath,
+      ...scenario ? { scenario } : {},
+      ...values.scope ? { scope: values.scope } : {},
+      ...values.json ? { json: true } : {},
+      ...values.plain ? { plain: true } : {},
+      ...values["baseline-dir"] ? { baselineDir: values["baseline-dir"] } : {}
+    };
+    if (command === "inspect") {
+      const { runInspect } = await import("./inspect-3AXX3VVK.js");
+      return await runInspect({
+        ...shared,
+        ...values.explain ? { explain: true } : {},
+        ...values.schemas ? { schemas: true } : {}
+      });
+    }
+    if (command === "snapshot") {
+      const { runSnapshot } = await import("./snapshot-3D55FL63.js");
+      return await runSnapshot(shared);
+    }
+    const { runCheck } = await import("./check-7Z2VNN5R.js");
+    return await runCheck(shared);
+  } catch (error) {
+    writeError(error instanceof Error ? error.message : String(error));
+    if (error instanceof Error && error.stack && process.env["AGENT_SURFACE_DEBUG"]) {
+      writeError(error.stack);
+    }
+    return 1;
+  } finally {
+    uninstallDom();
+  }
+}
+async function readVersion() {
+  try {
+    const { readFileSync } = await import("fs");
+    const path = fileURLToPath(new URL("../package.json", import.meta.url));
+    return JSON.parse(readFileSync(path, "utf8")).version;
+  } catch {
+    return "unknown";
+  }
+}
+function invokedAsBinary() {
+  const entry = process.argv[1];
+  if (!entry) return false;
+  try {
+    return fileURLToPath(import.meta.url) === realpathSync(entry);
+  } catch {
+    return false;
+  }
+}
+if (invokedAsBinary()) {
+  main().then(
+    (code) => {
+      process.exitCode = code;
+    },
+    (error) => {
+      writeError(error instanceof Error ? error.message : String(error));
+      process.exitCode = 1;
+    }
+  );
+}
+export {
+  main
+};
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts","../src/dom.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseArgs } from \"node:util\";\nimport { installDom } from \"./dom.js\";\nimport { findConfig } from \"./load.js\";\nimport { writeError, write } from \"./output.js\";\n\nconst USAGE = `agent-surface — inspect and check the agent surface your app exposes\n\nUsage\n  agent-surface inspect  [scenario]   what an agent can see right now\n  agent-surface snapshot [scenario]   write/refresh the committed baseline\n  agent-surface check    [scenario]   fail if the surface drifted from the baseline\n\nOptions\n  --config <path>   path to agent-surface.config.* (default: nearest, searching upward)\n  --baseline-dir    where baselines live (default: .agent-surface next to the config)\n  --scope <prefix>  restrict to a component-type prefix (repeatable)\n  --explain         name the policies behind every decision, hidden ones included\n  --schemas         include input/output JSON Schemas\n  --json            emit data instead of a rendered view\n  --plain           force plain text (implied when piped, or under CI / NO_COLOR)\n  -h, --help        show this\n  -v, --version     print the version\n`;\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<number> {\n  let parsed;\n  try {\n    parsed = parseArgs({\n      args: argv,\n      allowPositionals: true,\n      options: {\n        config: { type: \"string\" },\n        \"baseline-dir\": { type: \"string\" },\n        scope: { type: \"string\", multiple: true },\n        explain: { type: \"boolean\", default: false },\n        schemas: { type: \"boolean\", default: false },\n        json: { type: \"boolean\", default: false },\n        plain: { type: \"boolean\", default: false },\n        help: { type: \"boolean\", short: \"h\", default: false },\n        version: { type: \"boolean\", short: \"v\", default: false },\n      },\n    });\n  } catch (error) {\n    writeError(error instanceof Error ? error.message : String(error));\n    writeError(USAGE);\n    return 2;\n  }\n\n  const { values, positionals } = parsed;\n  if (values.help) {\n    write(USAGE);\n    return 0;\n  }\n  if (values.version) {\n    write(await readVersion());\n    return 0;\n  }\n\n  const [command, scenario] = positionals;\n  if (!command) {\n    write(USAGE);\n    return 2;\n  }\n  if (![\"inspect\", \"snapshot\", \"check\"].includes(command)) {\n    writeError(`unknown command \"${command}\"`);\n    writeError(USAGE);\n    return 2;\n  }\n\n  const configPath = values.config ?? findConfig();\n  if (!configPath) {\n    writeError(\n      \"no agent-surface.config.* found (searched upward from the working directory).\\n\" +\n        \"Create one that points at your app's composition root — see https://agent-surface-docs.vercel.app/20-cli\",\n    );\n    return 2;\n  }\n\n  // A presentation surface needs a DOM to mount into, and react-dom reads these\n  // globals at import time — so this must happen before any app module loads.\n  const uninstallDom = installDom();\n  try {\n    const shared = {\n      configPath,\n      ...(scenario ? { scenario } : {}),\n      ...(values.scope ? { scope: values.scope } : {}),\n      ...(values.json ? { json: true } : {}),\n      ...(values.plain ? { plain: true } : {}),\n      ...(values[\"baseline-dir\"] ? { baselineDir: values[\"baseline-dir\"] } : {}),\n    };\n\n    if (command === \"inspect\") {\n      const { runInspect } = await import(\"./commands/inspect.js\");\n      return await runInspect({\n        ...shared,\n        ...(values.explain ? { explain: true } : {}),\n        ...(values.schemas ? { schemas: true } : {}),\n      });\n    }\n    if (command === \"snapshot\") {\n      const { runSnapshot } = await import(\"./commands/snapshot.js\");\n      return await runSnapshot(shared);\n    }\n    const { runCheck } = await import(\"./commands/check.js\");\n    return await runCheck(shared);\n  } catch (error) {\n    writeError(error instanceof Error ? error.message : String(error));\n    if (error instanceof Error && error.stack && process.env[\"AGENT_SURFACE_DEBUG\"]) {\n      writeError(error.stack);\n    }\n    return 1;\n  } finally {\n    uninstallDom();\n  }\n}\n\nasync function readVersion(): Promise<string> {\n  try {\n    const { readFileSync } = await import(\"node:fs\");\n    const path = fileURLToPath(new URL(\"../package.json\", import.meta.url));\n    return (JSON.parse(readFileSync(path, \"utf8\")) as { version: string }).version;\n  } catch {\n    return \"unknown\";\n  }\n}\n\n/**\n * Self-execute only as a binary; importing this module (tests) must not run it.\n * `argv[1]` is compared through `realpathSync` because package managers install\n * the bin as a symlink — comparing the raw path silently never matches, and the\n * CLI exits 0 having done nothing.\n */\nfunction invokedAsBinary(): boolean {\n  const entry = process.argv[1];\n  if (!entry) return false;\n  try {\n    return fileURLToPath(import.meta.url) === realpathSync(entry);\n  } catch {\n    return false;\n  }\n}\n\nif (invokedAsBinary()) {\n  main().then(\n    (code) => {\n      process.exitCode = code;\n    },\n    (error: unknown) => {\n      writeError(error instanceof Error ? error.message : String(error));\n      process.exitCode = 1;\n    },\n  );\n}\n","import { JSDOM } from \"jsdom\";\n\n/**\n * A presentation surface only exists once components mount, and mounting needs\n * a DOM. Vitest gets one from its `jsdom` environment; a plain Node process has\n * to install one itself — *before* anything imports `react-dom`, which reads\n * these globals at module scope.\n *\n * Process-wide on purpose: the app tree runs inside the vite-node graph, which\n * shares this realm's globals.\n */\nexport function installDom(url = \"http://localhost/\"): () => void {\n  const globals = globalThis as Record<string, unknown>;\n  if (typeof globals[\"document\"] !== \"undefined\") return noop;\n\n  const dom = new JSDOM(\"<!doctype html><html><body></body></html>\", {\n    url,\n    pretendToBeVisual: true,\n  });\n  const { window } = dom;\n\n  // Everything jsdom's window defines that this realm does not already have.\n  // Skipping existing keys matters: Node's own `fetch`, `URL` and timers are\n  // more capable than jsdom's shims, and clobbering them breaks app code.\n  for (const key of Object.getOwnPropertyNames(window)) {\n    if (key.startsWith(\"_\")) continue;\n    if (key in globals) continue;\n    const descriptor = Object.getOwnPropertyDescriptor(window, key);\n    if (!descriptor) continue;\n    Object.defineProperty(globals, key, descriptor);\n  }\n\n  for (const key of [\"window\", \"document\", \"navigator\"] as const) {\n    if (!(key in globals)) {\n      Object.defineProperty(globals, key, { value: window[key], configurable: true });\n    }\n  }\n\n  return noop;\n}\n\n/**\n * Teardown is deliberately a no-op, and the DOM is deliberately process-wide.\n *\n * `react-dom` captures `window`/`document` when it is first imported. Removing\n * the globals — or worse, calling `window.close()` — leaves that captured\n * reference pointing at a dead realm, so the *next* mount in the same process\n * fails in a way that looks nothing like its cause. A CLI invocation ends by\n * exiting, so there is nothing to reclaim; only in-process callers (the test\n * suite) run more than one command, and those are exactly the ones this\n * protects.\n */\nfunction noop(): void {}\n"],"mappings":"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","names":[]}

package/dist/check-7Z2VNN5R.js

@@ -0,0 +1,79 @@
+import {
+  renderDiffPlain
+} from "./chunk-KZUR4CAU.js";
+import {
+  createSurfaceRunner,
+  isPlain,
+  loadInk,
+  paint,
+  write,
+  writeError
+} from "./chunk-S2LM3N6D.js";
+import {
+  annotate,
+  baselineDirFor,
+  baselinePath,
+  diff,
+  normalize,
+  readBaseline
+} from "./chunk-ODUIFFPM.js";
+
+// src/commands/check.tsx
+import { relative } from "path";
+import { jsx } from "react/jsx-runtime";
+async function runCheck(options) {
+  const runner = await createSurfaceRunner(options.configPath);
+  try {
+    const scenarios = options.scenario ? [options.scenario] : runner.scenarioNames;
+    const dir = baselineDirFor(options.configPath, options.baselineDir ?? runner.config.baselineDir);
+    const drifted = [];
+    for (const scenario of scenarios) {
+      const result = await runner.collect({
+        scenario,
+        ...options.scope ? { scope: options.scope } : {}
+      });
+      const path = baselinePath(dir, scenario);
+      const expected = readBaseline(path);
+      if (expected === void 0) {
+        drifted.push({ scenario, missingBaseline: true, entries: [] });
+        continue;
+      }
+      const actual = normalize(result.snapshot);
+      const entries = annotate(diff(expected, actual), actual, expected);
+      if (entries.length > 0) drifted.push({ scenario, entries });
+    }
+    if (options.json) {
+      write(JSON.stringify({ ok: drifted.length === 0, drifted }, null, 2));
+      return drifted.length === 0 ? 0 : 1;
+    }
+    if (drifted.length === 0) {
+      write(`surface matches the baseline (${scenarios.length} scenario${scenarios.length === 1 ? "" : "s"})`);
+      return 0;
+    }
+    const ink = isPlain(options) ? null : await loadInk();
+    for (const entry of drifted) {
+      if (entry.missingBaseline) {
+        writeError(
+          `${entry.scenario}: no baseline at ${relative(
+            process.cwd(),
+            baselinePath(dir, entry.scenario)
+          )} \u2014 run \`agent-surface snapshot\` and commit it`
+        );
+        continue;
+      }
+      if (ink) await paint(/* @__PURE__ */ jsx(ink.Drift, { scenario: entry.scenario, entries: entry.entries }));
+      else write(renderDiffPlain(entry.scenario, entry.entries));
+    }
+    writeError(
+      `
+surface drift in ${drifted.length} scenario${drifted.length === 1 ? "" : "s"} \u2014 review the change, then \`agent-surface snapshot\` to accept it`
+    );
+    return 1;
+  } finally {
+    await runner.close();
+  }
+}
+export {
+  runCheck
+};
+//# sourceMappingURL=check-7Z2VNN5R.js.map

package/dist/check-7Z2VNN5R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/check.tsx"],"sourcesContent":["import { relative } from \"node:path\";\nimport { createSurfaceRunner } from \"../load.js\";\nimport {\n  annotate,\n  baselineDirFor,\n  baselinePath,\n  diff,\n  normalize,\n  readBaseline,\n  type DiffEntry,\n} from \"../baseline.js\";\nimport { renderDiffPlain } from \"../render/plain.js\";\nimport { isPlain, loadInk, paint, write, writeError } from \"../output.js\";\n\nexport interface CheckOptions {\n  configPath: string;\n  scenario?: string;\n  scope?: string[];\n  baselineDir?: string;\n  json?: boolean;\n  plain?: boolean;\n}\n\ninterface ScenarioDrift {\n  scenario: string;\n  missingBaseline?: boolean;\n  entries: DiffEntry[];\n}\n\n/**\n * Compares every scenario against its committed baseline. Exit code is the\n * point: 0 when the surface is what the repo says it is, 1 when it drifted —\n * so CI fails on an unreviewed change to what agents can see.\n */\nexport async function runCheck(options: CheckOptions): Promise<number> {\n  const runner = await createSurfaceRunner(options.configPath);\n  try {\n    const scenarios = options.scenario ? [options.scenario] : runner.scenarioNames;\n    const dir = baselineDirFor(options.configPath, options.baselineDir ?? runner.config.baselineDir);\n    const drifted: ScenarioDrift[] = [];\n\n    for (const scenario of scenarios) {\n      const result = await runner.collect({\n        scenario,\n        ...(options.scope ? { scope: options.scope } : {}),\n      });\n      const path = baselinePath(dir, scenario);\n      const expected = readBaseline(path);\n\n      if (expected === undefined) {\n        drifted.push({ scenario, missingBaseline: true, entries: [] });\n        continue;\n      }\n      const actual = normalize(result.snapshot);\n      const entries = annotate(diff(expected, actual), actual, expected);\n      if (entries.length > 0) drifted.push({ scenario, entries });\n    }\n\n    if (options.json) {\n      write(JSON.stringify({ ok: drifted.length === 0, drifted }, null, 2));\n      return drifted.length === 0 ? 0 : 1;\n    }\n\n    if (drifted.length === 0) {\n      write(`surface matches the baseline (${scenarios.length} scenario${scenarios.length === 1 ? \"\" : \"s\"})`);\n      return 0;\n    }\n\n    const ink = isPlain(options) ? null : await loadInk();\n    for (const entry of drifted) {\n      if (entry.missingBaseline) {\n        writeError(\n          `${entry.scenario}: no baseline at ${relative(\n            process.cwd(),\n            baselinePath(dir, entry.scenario),\n          )} — run \\`agent-surface snapshot\\` and commit it`,\n        );\n        continue;\n      }\n      if (ink) await paint(<ink.Drift scenario={entry.scenario} entries={entry.entries} />);\n      else write(renderDiffPlain(entry.scenario, entry.entries));\n    }\n    writeError(\n      `\\nsurface drift in ${drifted.length} scenario${drifted.length === 1 ? \"\" : \"s\"} — review the change, then \\`agent-surface snapshot\\` to accept it`,\n    );\n    return 1;\n  } finally {\n    await runner.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AA+EE;AA7C3B,eAAsB,SAAS,SAAwC;AACrE,QAAM,SAAS,MAAM,oBAAoB,QAAQ,UAAU;AAC3D,MAAI;AACF,UAAM,YAAY,QAAQ,WAAW,CAAC,QAAQ,QAAQ,IAAI,OAAO;AACjE,UAAM,MAAM,eAAe,QAAQ,YAAY,QAAQ,eAAe,OAAO,OAAO,WAAW;AAC/F,UAAM,UAA2B,CAAC;AAElC,eAAW,YAAY,WAAW;AAChC,YAAM,SAAS,MAAM,OAAO,QAAQ;AAAA,QAClC;AAAA,QACA,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MAClD,CAAC;AACD,YAAM,OAAO,aAAa,KAAK,QAAQ;AACvC,YAAM,WAAW,aAAa,IAAI;AAElC,UAAI,aAAa,QAAW;AAC1B,gBAAQ,KAAK,EAAE,UAAU,iBAAiB,MAAM,SAAS,CAAC,EAAE,CAAC;AAC7D;AAAA,MACF;AACA,YAAM,SAAS,UAAU,OAAO,QAAQ;AACxC,YAAM,UAAU,SAAS,KAAK,UAAU,MAAM,GAAG,QAAQ,QAAQ;AACjE,UAAI,QAAQ,SAAS,EAAG,SAAQ,KAAK,EAAE,UAAU,QAAQ,CAAC;AAAA,IAC5D;AAEA,QAAI,QAAQ,MAAM;AAChB,YAAM,KAAK,UAAU,EAAE,IAAI,QAAQ,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;AACpE,aAAO,QAAQ,WAAW,IAAI,IAAI;AAAA,IACpC;AAEA,QAAI,QAAQ,WAAW,GAAG;AACxB,YAAM,iCAAiC,UAAU,MAAM,YAAY,UAAU,WAAW,IAAI,KAAK,GAAG,GAAG;AACvG,aAAO;AAAA,IACT;AAEA,UAAM,MAAM,QAAQ,OAAO,IAAI,OAAO,MAAM,QAAQ;AACpD,eAAW,SAAS,SAAS;AAC3B,UAAI,MAAM,iBAAiB;AACzB;AAAA,UACE,GAAG,MAAM,QAAQ,oBAAoB;AAAA,YACnC,QAAQ,IAAI;AAAA,YACZ,aAAa,KAAK,MAAM,QAAQ;AAAA,UAClC,CAAC;AAAA,QACH;AACA;AAAA,MACF;AACA,UAAI,IAAK,OAAM,MAAM,oBAAC,IAAI,OAAJ,EAAU,UAAU,MAAM,UAAU,SAAS,MAAM,SAAS,CAAE;AAAA,UAC/E,OAAM,gBAAgB,MAAM,UAAU,MAAM,OAAO,CAAC;AAAA,IAC3D;AACA;AAAA,MACE;AAAA,mBAAsB,QAAQ,MAAM,YAAY,QAAQ,WAAW,IAAI,KAAK,GAAG;AAAA,IACjF;AACA,WAAO;AAAA,EACT,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-A2G4QLX5.js

@@ -0,0 +1,29 @@
+// src/mount.ts
+import { act } from "@testing-library/react";
+import { renderAgentSurface } from "@agent-surface/testing/react";
+var DEFAULT_CLI_CONSUMER = { id: "cli", kind: "test" };
+async function mountScenario(config, scenario, options = {}) {
+  const props = config.scenarios[scenario];
+  if (!props) {
+    const known = Object.keys(config.scenarios);
+    throw new Error(
+      `unknown scenario "${scenario}" \u2014 this config defines ${known.length > 0 ? known.map((name) => `"${name}"`).join(", ") : "none"}`
+    );
+  }
+  const consumer = options.consumer ?? config.consumer ?? DEFAULT_CLI_CONSUMER;
+  const mounted = await config.mount({ ...props, scenario });
+  const surface = await renderAgentSurface(mounted.ui, {
+    registry: mounted.registry,
+    consumer
+  });
+  await act(async () => {
+  });
+  await config.settle?.(mounted);
+  return { scenario, surface, mounted, app: mounted.app, consumer };
+}
+
+export {
+  DEFAULT_CLI_CONSUMER,
+  mountScenario
+};
+//# sourceMappingURL=chunk-A2G4QLX5.js.map

package/dist/chunk-A2G4QLX5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mount.ts"],"sourcesContent":["import { act } from \"@testing-library/react\";\nimport { renderAgentSurface, type RenderedAgentSurface } from \"@agent-surface/testing/react\";\nimport type { AgentConsumer } from \"@agent-surface/core\";\nimport type { MountResult, ScenarioProps, SurfaceConfig } from \"./config.js\";\n\nexport const DEFAULT_CLI_CONSUMER: AgentConsumer = { id: \"cli\", kind: \"test\" };\n\nexport interface MountScenarioOptions {\n  consumer?: AgentConsumer;\n}\n\nexport interface MountedScenario<TApp> {\n  scenario: string;\n  surface: RenderedAgentSurface;\n  mounted: MountResult<TApp>;\n  /**\n   * Whatever `mount()` returned as `app`. Typed as `TApp` rather than\n   * `TApp | undefined` because a config that never sets it infers `TApp` as\n   * `unknown`, and forcing a `!` on every test that *does* set it is worse\n   * than trusting the config's own return type.\n   */\n  app: TApp;\n  consumer: AgentConsumer;\n}\n\n/**\n * The one mounting path. `agent-surface inspect` and the Vitest helper both\n * come through here, so a scenario cannot behave one way in CI and another in\n * the terminal — which is the entire reason scenarios live in one file.\n */\nexport async function mountScenario<TScenario extends ScenarioProps, TApp>(\n  config: SurfaceConfig<TScenario, TApp>,\n  scenario: string,\n  options: MountScenarioOptions = {},\n): Promise<MountedScenario<TApp>> {\n  const props = config.scenarios[scenario];\n  if (!props) {\n    const known = Object.keys(config.scenarios);\n    throw new Error(\n      `unknown scenario \"${scenario}\" — this config defines ${\n        known.length > 0 ? known.map((name) => `\"${name}\"`).join(\", \") : \"none\"\n      }`,\n    );\n  }\n\n  const consumer = options.consumer ?? config.consumer ?? DEFAULT_CLI_CONSUMER;\n  const mounted = await config.mount({ ...props, scenario });\n  const surface = await renderAgentSurface(mounted.ui, {\n    registry: mounted.registry,\n    consumer,\n  });\n\n  // Mount effects have flushed, but whatever the first render *started* has\n  // not settled — the initial fetch that fills a table, typically. This flush\n  // drains pending microtasks; `settle` covers anything slower.\n  await act(async () => {});\n  await config.settle?.(mounted);\n\n  return { scenario, surface, mounted, app: mounted.app as TApp, consumer };\n}\n"],"mappings":";AAAA,SAAS,WAAW;AACpB,SAAS,0BAAqD;AAIvD,IAAM,uBAAsC,EAAE,IAAI,OAAO,MAAM,OAAO;AAyB7E,eAAsB,cACpB,QACA,UACA,UAAgC,CAAC,GACD;AAChC,QAAM,QAAQ,OAAO,UAAU,QAAQ;AACvC,MAAI,CAAC,OAAO;AACV,UAAM,QAAQ,OAAO,KAAK,OAAO,SAAS;AAC1C,UAAM,IAAI;AAAA,MACR,qBAAqB,QAAQ,gCAC3B,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG,EAAE,KAAK,IAAI,IAAI,MACnE;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAW,QAAQ,YAAY,OAAO,YAAY;AACxD,QAAM,UAAU,MAAM,OAAO,MAAM,EAAE,GAAG,OAAO,SAAS,CAAC;AACzD,QAAM,UAAU,MAAM,mBAAmB,QAAQ,IAAI;AAAA,IACnD,UAAU,QAAQ;AAAA,IAClB;AAAA,EACF,CAAC;AAKD,QAAM,IAAI,YAAY;AAAA,EAAC,CAAC;AACxB,QAAM,OAAO,SAAS,OAAO;AAE7B,SAAO,EAAE,UAAU,SAAS,SAAS,KAAK,QAAQ,KAAa,SAAS;AAC1E;","names":[]}

package/dist/chunk-KZUR4CAU.js

@@ -0,0 +1,84 @@
+import {
+  formatValue
+} from "./chunk-ODUIFFPM.js";
+
+// src/render/plain.ts
+var MARK = { expose: "+", disable: "~", hide: "-" };
+function renderRow(row, lines) {
+  const tags = row.tags.length > 0 ? `  [${row.tags.join(", ")}]` : "";
+  lines.push(`  ${MARK[row.outcome]} ${row.name}${tags}`);
+  lines.push(`      ${row.description}`);
+  if (row.reason) lines.push(`      reason: ${row.reason}`);
+  if (row.policies) {
+    if (row.policies.length === 0) {
+      lines.push("      policies: none");
+    } else {
+      for (const policy of row.policies) {
+        const vote = policy.discovery ? policy.discovery.decision === "disable" ? `disable \u2014 ${policy.discovery.reason}` : policy.discovery.decision : "no discovery hook";
+        const phases = policy.phases.length > 0 ? policy.phases.join("/") : "\u2014";
+        const flags = [
+          policy.threw ? "THREW" : "",
+          policy.confirmationEscalation ? "escalates-confirmation" : ""
+        ].filter(Boolean).join(", ");
+        lines.push(
+          `      policy ${policy.name} (${policy.scope}, ${phases}): ${vote}${flags ? ` [${flags}]` : ""}`
+        );
+      }
+    }
+    if (row.availability && !row.availability.available) {
+      lines.push(
+        `      availability: unavailable${row.availability.reason ? ` \u2014 ${row.availability.reason}` : ""}`
+      );
+    }
+  }
+  if (row.schemas) {
+    if (row.schemas.input !== void 0) {
+      lines.push(`      input: ${JSON.stringify(row.schemas.input)}`);
+    }
+    if (row.schemas.output !== void 0) {
+      lines.push(`      output: ${JSON.stringify(row.schemas.output)}`);
+    }
+  }
+}
+function renderSurfacePlain(view) {
+  const lines = [];
+  lines.push(`scenario ${view.scenario}${view.route ? `  route ${view.route}` : ""}`);
+  lines.push(
+    `${view.counts.callable} callable, ${view.counts.disabled} visible-disabled${view.explained ? `, ${view.counts.hidden} hidden` : ""}`
+  );
+  const populated = view.groups.filter((group) => group.rows.length > 0);
+  if (populated.length === 0) {
+    lines.push("");
+    lines.push("Nothing is registered for this scenario \u2014 the agent has no surface here.");
+    if (!view.explained) {
+      lines.push("Re-run with --explain to see whether a policy hid it.");
+    }
+    return lines.join("\n");
+  }
+  for (const group of populated) {
+    lines.push("");
+    lines.push(`${group.heading}  (${group.rows.length})`);
+    for (const row of group.rows) renderRow(row, lines);
+  }
+  return lines.join("\n");
+}
+function renderDiffPlain(scenario, entries) {
+  const lines = [`${scenario}: ${entries.length} change${entries.length === 1 ? "" : "s"}`];
+  for (const entry of entries) {
+    const where = entry.subject ? `${entry.subject}  (${entry.path})` : entry.path;
+    if (entry.kind === "added") lines.push(`  + ${where}  ${formatValue(entry.after)}`);
+    else if (entry.kind === "removed") lines.push(`  - ${where}  ${formatValue(entry.before)}`);
+    else {
+      lines.push(`  ~ ${where}`);
+      lines.push(`      before: ${formatValue(entry.before)}`);
+      lines.push(`      after:  ${formatValue(entry.after)}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+export {
+  renderSurfacePlain,
+  renderDiffPlain
+};
+//# sourceMappingURL=chunk-KZUR4CAU.js.map

package/dist/chunk-KZUR4CAU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render/plain.ts"],"sourcesContent":["import type { CapabilityRow, SurfaceView } from \"./model.js\";\nimport type { DiffEntry } from \"../baseline.js\";\nimport { formatValue } from \"../baseline.js\";\n\n/**\n * The no-colour, no-cursor rendering used when stdout is piped or when\n * `--plain`, `CI` or `NO_COLOR` is set. Same view model as the Ink UI, so the\n * two cannot disagree about what the surface contains.\n */\n\nconst MARK = { expose: \"+\", disable: \"~\", hide: \"-\" } as const;\n\nfunction renderRow(row: CapabilityRow, lines: string[]): void {\n  const tags = row.tags.length > 0 ? `  [${row.tags.join(\", \")}]` : \"\";\n  lines.push(`  ${MARK[row.outcome]} ${row.name}${tags}`);\n  lines.push(`      ${row.description}`);\n  if (row.reason) lines.push(`      reason: ${row.reason}`);\n\n  if (row.policies) {\n    if (row.policies.length === 0) {\n      lines.push(\"      policies: none\");\n    } else {\n      for (const policy of row.policies) {\n        const vote = policy.discovery\n          ? policy.discovery.decision === \"disable\"\n            ? `disable — ${policy.discovery.reason}`\n            : policy.discovery.decision\n          : \"no discovery hook\";\n        const phases = policy.phases.length > 0 ? policy.phases.join(\"/\") : \"—\";\n        const flags = [\n          policy.threw ? \"THREW\" : \"\",\n          policy.confirmationEscalation ? \"escalates-confirmation\" : \"\",\n        ]\n          .filter(Boolean)\n          .join(\", \");\n        lines.push(\n          `      policy ${policy.name} (${policy.scope}, ${phases}): ${vote}${\n            flags ? ` [${flags}]` : \"\"\n          }`,\n        );\n      }\n    }\n    if (row.availability && !row.availability.available) {\n      lines.push(\n        `      availability: unavailable${\n          row.availability.reason ? ` — ${row.availability.reason}` : \"\"\n        }`,\n      );\n    }\n  }\n\n  if (row.schemas) {\n    if (row.schemas.input !== undefined) {\n      lines.push(`      input: ${JSON.stringify(row.schemas.input)}`);\n    }\n    if (row.schemas.output !== undefined) {\n      lines.push(`      output: ${JSON.stringify(row.schemas.output)}`);\n    }\n  }\n}\n\nexport function renderSurfacePlain(view: SurfaceView): string {\n  const lines: string[] = [];\n  lines.push(`scenario ${view.scenario}${view.route ? `  route ${view.route}` : \"\"}`);\n  lines.push(\n    `${view.counts.callable} callable, ${view.counts.disabled} visible-disabled${\n      view.explained ? `, ${view.counts.hidden} hidden` : \"\"\n    }`,\n  );\n\n  const populated = view.groups.filter((group) => group.rows.length > 0);\n  if (populated.length === 0) {\n    lines.push(\"\");\n    lines.push(\"Nothing is registered for this scenario — the agent has no surface here.\");\n    if (!view.explained) {\n      lines.push(\"Re-run with --explain to see whether a policy hid it.\");\n    }\n    return lines.join(\"\\n\");\n  }\n\n  for (const group of populated) {\n    lines.push(\"\");\n    lines.push(`${group.heading}  (${group.rows.length})`);\n    for (const row of group.rows) renderRow(row, lines);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function renderDiffPlain(scenario: string, entries: DiffEntry[]): string {\n  const lines = [`${scenario}: ${entries.length} change${entries.length === 1 ? \"\" : \"s\"}`];\n  for (const entry of entries) {\n    const where = entry.subject ? `${entry.subject}  (${entry.path})` : entry.path;\n    if (entry.kind === \"added\") lines.push(`  + ${where}  ${formatValue(entry.after)}`);\n    else if (entry.kind === \"removed\") lines.push(`  - ${where}  ${formatValue(entry.before)}`);\n    else {\n      lines.push(`  ~ ${where}`);\n      lines.push(`      before: ${formatValue(entry.before)}`);\n      lines.push(`      after:  ${formatValue(entry.after)}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ODUIFFPM.js

@@ -0,0 +1,104 @@
+// src/baseline.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { serializeSurfaceSnapshot } from "@agent-surface/testing";
+var DEFAULT_BASELINE_DIR = ".agent-surface";
+function baselineDirFor(configPath, configured) {
+  return resolve(dirname(configPath), configured ?? DEFAULT_BASELINE_DIR);
+}
+function baselinePath(dir, scenario) {
+  return join(dir, `${scenario}.json`);
+}
+function normalize(snapshot) {
+  return serializeSurfaceSnapshot(snapshot);
+}
+function readBaseline(path) {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function writeBaseline(path, value) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, "utf8");
+}
+var PATH_SEGMENT = /([^.[\]]+)|\[(\d+)\]/g;
+function subjectFor(document, path) {
+  let node = document;
+  let subject;
+  for (const match of path.matchAll(PATH_SEGMENT)) {
+    if (typeof node !== "object" || node === null) return subject;
+    const record = node;
+    const candidate = record["capabilityId"] ?? record["procedureId"];
+    if (typeof candidate === "string") subject = candidate;
+    const key = match[1] ?? match[2];
+    if (key === void 0) return subject;
+    node = record[key];
+  }
+  if (typeof node === "object" && node !== null) {
+    const record = node;
+    const candidate = record["capabilityId"] ?? record["procedureId"];
+    if (typeof candidate === "string") subject = candidate;
+  }
+  return subject;
+}
+function annotate(entries, after, before) {
+  return entries.map((entry) => {
+    const subject = subjectFor(after, entry.path) ?? subjectFor(before, entry.path);
+    return subject ? { ...entry, subject } : entry;
+  });
+}
+function diff(before, after, path = "") {
+  if (Object.is(before, after)) return [];
+  const bothArrays = Array.isArray(before) && Array.isArray(after);
+  const bothObjects = !bothArrays && typeof before === "object" && typeof after === "object" && before !== null && after !== null;
+  if (bothArrays) {
+    const entries = [];
+    const max = Math.max(before.length, after.length);
+    for (let i = 0; i < max; i++) {
+      const at = `${path}[${i}]`;
+      if (i >= before.length) entries.push({ path: at, kind: "added", after: after[i] });
+      else if (i >= after.length) entries.push({ path: at, kind: "removed", before: before[i] });
+      else entries.push(...diff(before[i], after[i], at));
+    }
+    return entries;
+  }
+  if (bothObjects) {
+    const entries = [];
+    const beforeRecord = before;
+    const afterRecord = after;
+    const keys = /* @__PURE__ */ new Set([...Object.keys(beforeRecord), ...Object.keys(afterRecord)]);
+    for (const key of [...keys].sort()) {
+      const at = path ? `${path}.${key}` : key;
+      if (!(key in beforeRecord)) {
+        entries.push({ path: at, kind: "added", after: afterRecord[key] });
+      } else if (!(key in afterRecord)) {
+        entries.push({ path: at, kind: "removed", before: beforeRecord[key] });
+      } else {
+        entries.push(...diff(beforeRecord[key], afterRecord[key], at));
+      }
+    }
+    return entries;
+  }
+  if (JSON.stringify(before) === JSON.stringify(after)) return [];
+  return [{ path: path || "<root>", kind: "changed", before, after }];
+}
+function formatValue(value) {
+  if (value === void 0) return "\u2014";
+  const text = typeof value === "string" ? value : JSON.stringify(value);
+  return text.length > 120 ? `${text.slice(0, 117)}\u2026` : text;
+}
+
+export {
+  baselineDirFor,
+  baselinePath,
+  normalize,
+  readBaseline,
+  writeBaseline,
+  annotate,
+  diff,
+  formatValue
+};
+//# sourceMappingURL=chunk-ODUIFFPM.js.map