@agent-surface/cli 0.8.0

package/dist/chunk-ODUIFFPM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/baseline.ts"],"sourcesContent":["import { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { serializeSurfaceSnapshot } from \"@agent-surface/testing\";\nimport type { AgentSurfaceSnapshot } from \"@agent-surface/core\";\n\nexport const DEFAULT_BASELINE_DIR = \".agent-surface\";\n\nexport function baselineDirFor(configPath: string, configured?: string): string {\n  return resolve(dirname(configPath), configured ?? DEFAULT_BASELINE_DIR);\n}\n\nexport function baselinePath(dir: string, scenario: string): string {\n  return join(dir, `${scenario}.json`);\n}\n\n/**\n * The committed form. `serializeSurfaceSnapshot` is the same normalizer the\n * Vitest matcher uses: registration ids become stable placeholders and the\n * volatile fields (surfaceId, capturedAt, version) drop out, so a baseline\n * diff is a diff of *what agents can see* and nothing else.\n */\nexport function normalize(snapshot: AgentSurfaceSnapshot): unknown {\n  return serializeSurfaceSnapshot(snapshot);\n}\n\nexport function readBaseline(path: string): unknown | undefined {\n  try {\n    return JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function writeBaseline(path: string, value: unknown): void {\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, `${JSON.stringify(value, null, 2)}\\n`, \"utf8\");\n}\n\nexport interface DiffEntry {\n  path: string;\n  kind: \"added\" | \"removed\" | \"changed\";\n  before?: unknown;\n  after?: unknown;\n  /**\n   * The capability the change belongs to. A reviewer needs to know that\n   * `view:devices.table.sort` changed — `components[3].actions[1]` is the same\n   * fact in a form nobody can act on.\n   */\n  subject?: string;\n}\n\nconst PATH_SEGMENT = /([^.[\\]]+)|\\[(\\d+)\\]/g;\n\n/** Nearest enclosing capability id for a diff path, if the path sits inside one. */\nfunction subjectFor(document: unknown, path: string): string | undefined {\n  let node: unknown = document;\n  let subject: string | undefined;\n  for (const match of path.matchAll(PATH_SEGMENT)) {\n    if (typeof node !== \"object\" || node === null) return subject;\n    const record = node as Record<string, unknown>;\n    const candidate = record[\"capabilityId\"] ?? record[\"procedureId\"];\n    if (typeof candidate === \"string\") subject = candidate;\n    const key = match[1] ?? match[2];\n    if (key === undefined) return subject;\n    node = record[key];\n  }\n  if (typeof node === \"object\" && node !== null) {\n    const record = node as Record<string, unknown>;\n    const candidate = record[\"capabilityId\"] ?? record[\"procedureId\"];\n    if (typeof candidate === \"string\") subject = candidate;\n  }\n  return subject;\n}\n\n/** Labels each entry with the capability it belongs to, when there is one. */\nexport function annotate(entries: DiffEntry[], after: unknown, before: unknown): DiffEntry[] {\n  return entries.map((entry) => {\n    const subject = subjectFor(after, entry.path) ?? subjectFor(before, entry.path);\n    return subject ? { ...entry, subject } : entry;\n  });\n}\n\n/**\n * Structural diff, deliberately total: every difference is drift, including a\n * changed description. Descriptions are the provider's cached prompt prefix\n * (D28) — a silent edit re-bills every conversation, so it is exactly the kind\n * of change a reviewer should see.\n */\nexport function diff(before: unknown, after: unknown, path = \"\"): DiffEntry[] {\n  if (Object.is(before, after)) return [];\n\n  const bothArrays = Array.isArray(before) && Array.isArray(after);\n  const bothObjects =\n    !bothArrays &&\n    typeof before === \"object\" &&\n    typeof after === \"object\" &&\n    before !== null &&\n    after !== null;\n\n  if (bothArrays) {\n    const entries: DiffEntry[] = [];\n    const max = Math.max(before.length, after.length);\n    for (let i = 0; i < max; i++) {\n      const at = `${path}[${i}]`;\n      if (i >= before.length) entries.push({ path: at, kind: \"added\", after: after[i] });\n      else if (i >= after.length) entries.push({ path: at, kind: \"removed\", before: before[i] });\n      else entries.push(...diff(before[i], after[i], at));\n    }\n    return entries;\n  }\n\n  if (bothObjects) {\n    const entries: DiffEntry[] = [];\n    const beforeRecord = before as Record<string, unknown>;\n    const afterRecord = after as Record<string, unknown>;\n    const keys = new Set([...Object.keys(beforeRecord), ...Object.keys(afterRecord)]);\n    for (const key of [...keys].sort()) {\n      const at = path ? `${path}.${key}` : key;\n      if (!(key in beforeRecord)) {\n        entries.push({ path: at, kind: \"added\", after: afterRecord[key] });\n      } else if (!(key in afterRecord)) {\n        entries.push({ path: at, kind: \"removed\", before: beforeRecord[key] });\n      } else {\n        entries.push(...diff(beforeRecord[key], afterRecord[key], at));\n      }\n    }\n    return entries;\n  }\n\n  if (JSON.stringify(before) === JSON.stringify(after)) return [];\n  return [{ path: path || \"<root>\", kind: \"changed\", before, after }];\n}\n\nexport function formatValue(value: unknown): string {\n  if (value === undefined) return \"—\";\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  return text.length > 120 ? `${text.slice(0, 117)}…` : text;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-S2LM3N6D.js

@@ -0,0 +1,167 @@
+// src/load.ts
+import { existsSync } from "fs";
+import { dirname, isAbsolute, join, resolve } from "path";
+import { fileURLToPath } from "url";
+import { createServer } from "vite";
+import { ViteNodeServer } from "vite-node/server";
+import { ViteNodeRunner } from "vite-node/client";
+import { installSourcemapsSupport } from "vite-node/source-map";
+var CONFIG_NAMES = [
+  "agent-surface.config.tsx",
+  "agent-surface.config.ts",
+  "agent-surface.config.mjs",
+  "agent-surface.config.js"
+];
+function findConfig(from = process.cwd()) {
+  let dir = resolve(from);
+  for (; ; ) {
+    for (const name of CONFIG_NAMES) {
+      const candidate = join(dir, name);
+      if (existsSync(candidate)) return candidate;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function collectorPath() {
+  for (const ext of ["js", "ts"]) {
+    const candidate = fileURLToPath(new URL(`./collect.${ext}`, import.meta.url));
+    if (existsSync(candidate)) return candidate;
+  }
+  throw new Error("could not locate the agent-surface collector module");
+}
+async function createSurfaceRunner(configPath) {
+  const absoluteConfig = isAbsolute(configPath) ? configPath : resolve(configPath);
+  if (!existsSync(absoluteConfig)) {
+    throw new Error(`config not found: ${absoluteConfig}`);
+  }
+  const root = dirname(absoluteConfig);
+  let server;
+  try {
+    server = await createServer({
+      root,
+      logLevel: "error",
+      // `serve` so plugins behave as they do in dev; nothing is ever served.
+      server: { middlewareMode: true, watch: null, fs: { strict: false } },
+      optimizeDeps: { noDiscovery: true, include: [] },
+      resolve: {
+        // Both halves of the graph must agree on these. React because two
+        // copies break hooks; core because `explainSurface` finds the registry
+        // through a Symbol, which is per-module-instance (see collect.ts).
+        dedupe: [
+          "react",
+          "react-dom",
+          "@agent-surface/core",
+          "@agent-surface/react",
+          "@agent-surface/testing"
+        ]
+      }
+    });
+  } catch (error) {
+    throw new Error(
+      `could not start Vite for ${root}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  try {
+    await server.pluginContainer.buildStart({});
+  } catch {
+  }
+  const nodeServer = new ViteNodeServer(server);
+  installSourcemapsSupport({ getSourceMap: (source) => nodeServer.getSourceMap(source) });
+  const runner = new ViteNodeRunner({
+    root: server.config.root,
+    base: server.config.base,
+    fetchModule: (id) => nodeServer.fetchModule(id),
+    resolveId: (id, importer) => nodeServer.resolveId(id, importer)
+  });
+  const close = async () => {
+    await server.close();
+  };
+  try {
+    const configModule = await runner.executeFile(absoluteConfig);
+    const config = configModule.default;
+    if (!config || typeof config.mount !== "function") {
+      throw new Error(
+        `${absoluteConfig} must \`export default defineSurface({ mount, scenarios })\``
+      );
+    }
+    const scenarioNames = Object.keys(config.scenarios ?? {});
+    if (scenarioNames.length === 0) {
+      throw new Error(`${absoluteConfig} defines no scenarios`);
+    }
+    const collector = await runner.executeFile(collectorPath());
+    return {
+      config,
+      scenarioNames,
+      collect: async (options) => {
+        const globals = globalThis;
+        const previous = globals["IS_REACT_ACT_ENVIRONMENT"];
+        globals["IS_REACT_ACT_ENVIRONMENT"] = true;
+        try {
+          return await collector.collect(config, options);
+        } finally {
+          globals["IS_REACT_ACT_ENVIRONMENT"] = previous;
+        }
+      },
+      close
+    };
+  } catch (error) {
+    await close();
+    throw error;
+  }
+}
+
+// src/output.ts
+function isPlain(flags) {
+  if (flags.json) return true;
+  if (flags.plain) return true;
+  if (process.env["CI"]) return true;
+  if (process.env["NO_COLOR"]) return true;
+  if (process.stdout.isTTY !== true) return true;
+  return !process.stdout.columns;
+}
+function write(text) {
+  process.stdout.write(`${text}
+`);
+}
+function writeError(text) {
+  process.stderr.write(`${text}
+`);
+}
+var cached;
+async function loadInk() {
+  if (cached !== void 0) return cached;
+  try {
+    cached = await import("./ink-GCWDO4ML.js");
+  } catch {
+    cached = null;
+  }
+  return cached;
+}
+async function paint(element) {
+  const { render } = await import("ink");
+  const instance = render(element);
+  instance.unmount();
+  await instance.waitUntilExit();
+}
+async function transient(element) {
+  const { render } = await import("ink");
+  const instance = render(element);
+  return () => {
+    instance.clear();
+    instance.unmount();
+  };
+}
+
+export {
+  findConfig,
+  createSurfaceRunner,
+  isPlain,
+  write,
+  writeError,
+  loadInk,
+  paint,
+  transient
+};
+//# sourceMappingURL=chunk-S2LM3N6D.js.map

package/dist/chunk-S2LM3N6D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/load.ts","../src/output.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createServer, type ViteDevServer } from \"vite\";\nimport { ViteNodeServer } from \"vite-node/server\";\nimport { ViteNodeRunner } from \"vite-node/client\";\nimport { installSourcemapsSupport } from \"vite-node/source-map\";\nimport type { CollectOptions, CollectResult } from \"./collect.js\";\nimport type { SurfaceConfig } from \"./config.js\";\n\nconst CONFIG_NAMES = [\n  \"agent-surface.config.tsx\",\n  \"agent-surface.config.ts\",\n  \"agent-surface.config.mjs\",\n  \"agent-surface.config.js\",\n];\n\n/** Walks up from `from` looking for an `agent-surface.config.*`. */\nexport function findConfig(from: string = process.cwd()): string | undefined {\n  let dir = resolve(from);\n  for (;;) {\n    for (const name of CONFIG_NAMES) {\n      const candidate = join(dir, name);\n      if (existsSync(candidate)) return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) return undefined;\n    dir = parent;\n  }\n}\n\n/** `dist/collect.js` when installed; `src/collect.ts` when run from source. */\nfunction collectorPath(): string {\n  for (const ext of [\"js\", \"ts\"]) {\n    const candidate = fileURLToPath(new URL(`./collect.${ext}`, import.meta.url));\n    if (existsSync(candidate)) return candidate;\n  }\n  throw new Error(\"could not locate the agent-surface collector module\");\n}\n\nexport interface SurfaceRunner {\n  config: SurfaceConfig;\n  scenarioNames: string[];\n  collect(options: CollectOptions): Promise<CollectResult>;\n  close(): Promise<void>;\n}\n\n/**\n * Boots a Vite dev server on the app's own config, so the config file and the\n * app modules it imports are transformed and resolved exactly as the app\n * resolves them — its aliases, its plugins, its TSX.\n */\nexport async function createSurfaceRunner(configPath: string): Promise<SurfaceRunner> {\n  const absoluteConfig = isAbsolute(configPath) ? configPath : resolve(configPath);\n  if (!existsSync(absoluteConfig)) {\n    throw new Error(`config not found: ${absoluteConfig}`);\n  }\n  const root = dirname(absoluteConfig);\n\n  let server: ViteDevServer;\n  try {\n    server = await createServer({\n      root,\n      logLevel: \"error\",\n      // `serve` so plugins behave as they do in dev; nothing is ever served.\n      server: { middlewareMode: true, watch: null, fs: { strict: false } },\n      optimizeDeps: { noDiscovery: true, include: [] },\n      resolve: {\n        // Both halves of the graph must agree on these. React because two\n        // copies break hooks; core because `explainSurface` finds the registry\n        // through a Symbol, which is per-module-instance (see collect.ts).\n        dedupe: [\n          \"react\",\n          \"react-dom\",\n          \"@agent-surface/core\",\n          \"@agent-surface/react\",\n          \"@agent-surface/testing\",\n        ],\n      },\n    });\n  } catch (error) {\n    throw new Error(\n      `could not start Vite for ${root}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  try {\n    await server.pluginContainer.buildStart({});\n  } catch {\n    // Vite keeps moving this; a plugin that needs buildStart will say so itself.\n  }\n\n  const nodeServer = new ViteNodeServer(server);\n  installSourcemapsSupport({ getSourceMap: (source) => nodeServer.getSourceMap(source) });\n\n  const runner = new ViteNodeRunner({\n    root: server.config.root,\n    base: server.config.base,\n    fetchModule: (id) => nodeServer.fetchModule(id),\n    resolveId: (id, importer) => nodeServer.resolveId(id, importer),\n  });\n\n  const close = async (): Promise<void> => {\n    await server.close();\n  };\n\n  try {\n    const configModule = (await runner.executeFile(absoluteConfig)) as {\n      default?: SurfaceConfig;\n    };\n    const config = configModule.default;\n    if (!config || typeof config.mount !== \"function\") {\n      throw new Error(\n        `${absoluteConfig} must \\`export default defineSurface({ mount, scenarios })\\``,\n      );\n    }\n    const scenarioNames = Object.keys(config.scenarios ?? {});\n    if (scenarioNames.length === 0) {\n      throw new Error(`${absoluteConfig} defines no scenarios`);\n    }\n\n    // Same runner ⇒ same module graph ⇒ the collector shares React and core\n    // with the app tree it is about to mount.\n    const collector = (await runner.executeFile(collectorPath())) as {\n      collect(config: SurfaceConfig, options: CollectOptions): Promise<CollectResult>;\n    };\n\n    return {\n      config,\n      scenarioNames,\n      collect: async (options) => {\n        // Scoped to the mount, never process-wide: `act()` needs it, and Ink\n        // renders its own React tree afterwards — with the flag still set,\n        // every frame of the CLI's own UI prints React's \"not wrapped in\n        // act(...)\" warning at the user.\n        const globals = globalThis as Record<string, unknown>;\n        const previous = globals[\"IS_REACT_ACT_ENVIRONMENT\"];\n        globals[\"IS_REACT_ACT_ENVIRONMENT\"] = true;\n        try {\n          return await collector.collect(config, options);\n        } finally {\n          globals[\"IS_REACT_ACT_ENVIRONMENT\"] = previous;\n        }\n      },\n      close,\n    };\n  } catch (error) {\n    await close();\n    throw error;\n  }\n}\n","import type { ReactElement } from \"react\";\n\nexport interface OutputFlags {\n  plain?: boolean;\n  json?: boolean;\n}\n\n/**\n * Terminal-aware only when there is a terminal. Piped output, `--plain`, `CI`\n * and `NO_COLOR` all fall back to plain text — a CLI whose output changes shape\n * when redirected is unusable in a build log.\n */\nexport function isPlain(flags: OutputFlags): boolean {\n  if (flags.json) return true;\n  if (flags.plain) return true;\n  if (process.env[\"CI\"]) return true;\n  if (process.env[\"NO_COLOR\"]) return true;\n  if (process.stdout.isTTY !== true) return true;\n  // A TTY that cannot report its width (some CI ptys, `script` on macOS) makes\n  // Ink lay out at zero columns and emit one character per line. Plain text is\n  // the only honest rendering for a terminal whose size is unknown.\n  return !process.stdout.columns;\n}\n\nexport function write(text: string): void {\n  process.stdout.write(`${text}\\n`);\n}\n\nexport function writeError(text: string): void {\n  process.stderr.write(`${text}\\n`);\n}\n\ntype InkModule = typeof import(\"./render/ink.js\");\n\nlet cached: InkModule | null | undefined;\n\n/**\n * Loads the Ink renderer, or returns `null` when it cannot run here.\n *\n * Two reasons this is lazy rather than a top-level import. It keeps `--plain`\n * and `--json` from paying for a terminal UI they never draw — and Ink drives\n * React through `react-reconciler`, which reads React 19 internals, so a host\n * that pins React 18 globally cannot load it at all. Neither is a reason to\n * fail a command that was about to print text.\n */\nexport async function loadInk(): Promise<InkModule | null> {\n  if (cached !== undefined) return cached;\n  try {\n    cached = await import(\"./render/ink.js\");\n  } catch {\n    cached = null;\n  }\n  return cached;\n}\n\n/** Paints an Ink element once and returns when the frame has been flushed. */\nexport async function paint(element: ReactElement): Promise<void> {\n  const { render } = await import(\"ink\");\n  const instance = render(element);\n  instance.unmount();\n  await instance.waitUntilExit();\n}\n\n/** A live Ink frame (spinner) that is cleared before the real output lands. */\nexport async function transient(element: ReactElement): Promise<() => void> {\n  const { render } = await import(\"ink\");\n  const instance = render(element);\n  return () => {\n    instance.clear();\n    instance.unmount();\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/collect.js

@@ -0,0 +1,35 @@
+import {
+  mountScenario
+} from "./chunk-A2G4QLX5.js";
+
+// src/collect.ts
+import { explainSurface } from "@agent-surface/core/explain";
+async function collect(config, options) {
+  const mount = await mountScenario(config, options.scenario, {
+    ...options.consumer ? { consumer: options.consumer } : {}
+  });
+  const scope = options.scope ?? config.scope;
+  const ctx = {
+    consumer: mount.consumer,
+    includeUnavailable: true,
+    ...scope ? { scope } : {}
+  };
+  try {
+    return {
+      scenario: options.scenario,
+      // Inert copies: the live objects are frozen and graph-local, and only
+      // plain JSON may cross back into the CLI process.
+      snapshot: jsonify(mount.mounted.registry.snapshot(ctx)),
+      explanation: jsonify(explainSurface(mount.mounted.registry, ctx))
+    };
+  } finally {
+    mount.surface.dispose();
+  }
+}
+function jsonify(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+export {
+  collect
+};
+//# sourceMappingURL=collect.js.map

package/dist/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/collect.ts"],"sourcesContent":["/**\n * The collector — the *only* module the CLI executes inside the vite-node\n * graph, and the reason that boundary exists.\n *\n * Two things force it:\n *\n * 1. **One React.** The app's component tree resolves React through the app's\n *    own Vite config. If the mount ran in the CLI's Node graph instead, a\n *    second React copy would render it and every hook would throw.\n *\n * 2. **One `@agent-surface/core`.** `explainSurface()` reaches the registry\n *    through a plain `Symbol` seam, and a symbol is only equal to itself within\n *    one module instance. Load core twice and the seam silently misses. So the\n *    explanation is computed *here*, beside the registry that owns it.\n *\n * Everything crosses back as plain JSON. Nothing live — no registry, no React\n * element, no policy function — escapes into the CLI process.\n */\nimport { explainSurface, type SurfaceExplanation } from \"@agent-surface/core/explain\";\nimport type { AgentConsumer, AgentSurfaceSnapshot, SnapshotContext } from \"@agent-surface/core\";\nimport type { SurfaceConfig } from \"./config.js\";\nimport { mountScenario } from \"./mount.js\";\n\nexport interface CollectOptions {\n  scenario: string;\n  consumer?: AgentConsumer;\n  scope?: string[];\n}\n\nexport interface CollectResult {\n  scenario: string;\n  snapshot: AgentSurfaceSnapshot;\n  explanation: SurfaceExplanation;\n}\n\nexport async function collect(\n  config: SurfaceConfig,\n  options: CollectOptions,\n): Promise<CollectResult> {\n  const mount = await mountScenario(config, options.scenario, {\n    ...(options.consumer ? { consumer: options.consumer } : {}),\n  });\n  const scope = options.scope ?? config.scope;\n  const ctx: SnapshotContext = {\n    consumer: mount.consumer,\n    includeUnavailable: true,\n    ...(scope ? { scope } : {}),\n  };\n\n  try {\n    return {\n      scenario: options.scenario,\n      // Inert copies: the live objects are frozen and graph-local, and only\n      // plain JSON may cross back into the CLI process.\n      snapshot: jsonify(mount.mounted.registry.snapshot(ctx)),\n      explanation: jsonify(explainSurface(mount.mounted.registry, ctx)),\n    };\n  } finally {\n    mount.surface.dispose();\n  }\n}\n\nfunction jsonify<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":";;;;;AAkBA,SAAS,sBAA+C;AAiBxD,eAAsB,QACpB,QACA,SACwB;AACxB,QAAM,QAAQ,MAAM,cAAc,QAAQ,QAAQ,UAAU;AAAA,IAC1D,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,EAC3D,CAAC;AACD,QAAM,QAAQ,QAAQ,SAAS,OAAO;AACtC,QAAM,MAAuB;AAAA,IAC3B,UAAU,MAAM;AAAA,IAChB,oBAAoB;AAAA,IACpB,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,EAC3B;AAEA,MAAI;AACF,WAAO;AAAA,MACL,UAAU,QAAQ;AAAA;AAAA;AAAA,MAGlB,UAAU,QAAQ,MAAM,QAAQ,SAAS,SAAS,GAAG,CAAC;AAAA,MACtD,aAAa,QAAQ,eAAe,MAAM,QAAQ,UAAU,GAAG,CAAC;AAAA,IAClE;AAAA,EACF,UAAE;AACA,UAAM,QAAQ,QAAQ;AAAA,EACxB;AACF;AAEA,SAAS,QAAW,OAAa;AAC/B,SAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC;","names":[]}

package/dist/config-DqK8YqyQ.d.ts

@@ -0,0 +1,52 @@
+import { ReactElement } from 'react';
+import { AgentSurfaceRegistry, AgentConsumer } from '@agent-surface/core';
+
+/** What `mount()` hands back: the app's own registry and its rendered tree. */
+interface MountResult<TApp = unknown> {
+    registry: AgentSurfaceRegistry;
+    ui: ReactElement;
+    /**
+     * Anything else your tests need back — the app wiring, a backend double, a
+     * router handle. The CLI ignores it entirely; it exists so the same scenario
+     * can drive `agent-surface inspect` and a Vitest suite without the suite
+     * having to rebuild the app a second way.
+     */
+    app?: TApp;
+}
+/**
+ * Scenario properties are whatever your `mount()` needs — a user, a route, a
+ * feature flag. The CLI never interprets them; it just hands them back, plus
+ * `scenario` (the key it was listed under).
+ */
+type ScenarioProps = Record<string, unknown>;
+interface SurfaceConfig<TScenario extends ScenarioProps = ScenarioProps, TApp = unknown> {
+    /**
+     * Build the app the way the app builds itself. This should point at your
+     * existing composition root, not restate it — whatever `main.tsx` calls.
+     */
+    mount(props: TScenario & {
+        scenario: string;
+    }): MountResult<TApp> | Promise<MountResult<TApp>>;
+    /**
+     * Optional extra settling after mount effects flush, for anything the first
+     * render kicks off asynchronously (an initial fetch, a router resolve).
+     * The CLI already flushes React effects and pending microtasks for you.
+     */
+    settle?: (mounted: MountResult<TApp>) => void | Promise<void>;
+    /** Named surfaces to inspect and check. At least one is required. */
+    scenarios: Record<string, TScenario>;
+    /** Consumer identity snapshots are computed for. Default `{id:"cli",kind:"test"}`. */
+    consumer?: AgentConsumer;
+    /** Component-type prefixes to restrict to, same meaning as `SnapshotContext.scope`. */
+    scope?: string[];
+    /** Where `snapshot`/`check` keep baselines. Default `.agent-surface`, relative to the config. */
+    baselineDir?: string;
+}
+/**
+ * Identity function that exists purely for type inference — the same shape as
+ * Vite's `defineConfig`. Your scenario props stay strongly typed inside
+ * `mount()` without you annotating them.
+ */
+declare function defineSurface<TScenario extends ScenarioProps, TApp = unknown>(config: SurfaceConfig<TScenario, TApp>): SurfaceConfig<TScenario, TApp>;
+
+export { type MountResult as M, type ScenarioProps as S, type SurfaceConfig as a, defineSurface as d };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { M as MountResult, S as ScenarioProps, a as SurfaceConfig, d as defineSurface } from './config-DqK8YqyQ.js';
+import { SurfaceExplanation } from '@agent-surface/core/explain';
+import { AgentSurfaceSnapshot } from '@agent-surface/core';
+import 'react';
+
+/**
+ * The collector — the *only* module the CLI executes inside the vite-node
+ * graph, and the reason that boundary exists.
+ *
+ * Two things force it:
+ *
+ * 1. **One React.** The app's component tree resolves React through the app's
+ *    own Vite config. If the mount ran in the CLI's Node graph instead, a
+ *    second React copy would render it and every hook would throw.
+ *
+ * 2. **One `@agent-surface/core`.** `explainSurface()` reaches the registry
+ *    through a plain `Symbol` seam, and a symbol is only equal to itself within
+ *    one module instance. Load core twice and the seam silently misses. So the
+ *    explanation is computed *here*, beside the registry that owns it.
+ *
+ * Everything crosses back as plain JSON. Nothing live — no registry, no React
+ * element, no policy function — escapes into the CLI process.
+ */
+
+interface CollectResult {
+    scenario: string;
+    snapshot: AgentSurfaceSnapshot;
+    explanation: SurfaceExplanation;
+}
+
+export type { CollectResult };

package/dist/index.js

@@ -0,0 +1,8 @@
+// src/config.ts
+function defineSurface(config) {
+  return config;
+}
+export {
+  defineSurface
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import type { ReactElement } from \"react\";\nimport type { AgentConsumer, AgentSurfaceRegistry } from \"@agent-surface/core\";\n\n/** What `mount()` hands back: the app's own registry and its rendered tree. */\nexport interface MountResult<TApp = unknown> {\n  registry: AgentSurfaceRegistry;\n  ui: ReactElement;\n  /**\n   * Anything else your tests need back — the app wiring, a backend double, a\n   * router handle. The CLI ignores it entirely; it exists so the same scenario\n   * can drive `agent-surface inspect` and a Vitest suite without the suite\n   * having to rebuild the app a second way.\n   */\n  app?: TApp;\n}\n\n/**\n * Scenario properties are whatever your `mount()` needs — a user, a route, a\n * feature flag. The CLI never interprets them; it just hands them back, plus\n * `scenario` (the key it was listed under).\n */\nexport type ScenarioProps = Record<string, unknown>;\n\nexport interface SurfaceConfig<TScenario extends ScenarioProps = ScenarioProps, TApp = unknown> {\n  /**\n   * Build the app the way the app builds itself. This should point at your\n   * existing composition root, not restate it — whatever `main.tsx` calls.\n   */\n  mount(\n    props: TScenario & { scenario: string },\n  ): MountResult<TApp> | Promise<MountResult<TApp>>;\n\n  /**\n   * Optional extra settling after mount effects flush, for anything the first\n   * render kicks off asynchronously (an initial fetch, a router resolve).\n   * The CLI already flushes React effects and pending microtasks for you.\n   */\n  settle?: (mounted: MountResult<TApp>) => void | Promise<void>;\n\n  /** Named surfaces to inspect and check. At least one is required. */\n  scenarios: Record<string, TScenario>;\n\n  /** Consumer identity snapshots are computed for. Default `{id:\"cli\",kind:\"test\"}`. */\n  consumer?: AgentConsumer;\n\n  /** Component-type prefixes to restrict to, same meaning as `SnapshotContext.scope`. */\n  scope?: string[];\n\n  /** Where `snapshot`/`check` keep baselines. Default `.agent-surface`, relative to the config. */\n  baselineDir?: string;\n}\n\n/**\n * Identity function that exists purely for type inference — the same shape as\n * Vite's `defineConfig`. Your scenario props stay strongly typed inside\n * `mount()` without you annotating them.\n */\nexport function defineSurface<TScenario extends ScenarioProps, TApp = unknown>(\n  config: SurfaceConfig<TScenario, TApp>,\n): SurfaceConfig<TScenario, TApp> {\n  return config;\n}\n"],"mappings":";AAyDO,SAAS,cACd,QACgC;AAChC,SAAO;AACT;","names":[]}

package/dist/ink-GCWDO4ML.js

@@ -0,0 +1,122 @@
+import {
+  formatValue
+} from "./chunk-ODUIFFPM.js";
+
+// src/render/ink.tsx
+import { Box, Static, Text } from "ink";
+import Spinner from "ink-spinner";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var OUTCOME = {
+  expose: { mark: "\u25CF", color: "green" },
+  disable: { mark: "\u25D0", color: "yellow" },
+  hide: { mark: "\u25CB", color: "red" }
+};
+function Loading({ label }) {
+  return /* @__PURE__ */ jsxs(Text, { children: [
+    /* @__PURE__ */ jsx(Text, { color: "cyan", children: /* @__PURE__ */ jsx(Spinner, { type: "dots" }) }),
+    ` ${label}`
+  ] });
+}
+function PolicyLine({
+  policy
+}) {
+  const vote = policy.discovery?.decision;
+  const color = vote === "hide" ? "red" : vote === "disable" ? "yellow" : "green";
+  return /* @__PURE__ */ jsxs(Box, { paddingLeft: 6, children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "policy " }),
+    /* @__PURE__ */ jsx(Text, { bold: true, children: policy.name }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: ` (${policy.scope}${policy.phases.length ? `, ${policy.phases.join("/")}` : ""}) ` }),
+    vote ? /* @__PURE__ */ jsxs(Text, { color, children: [
+      vote,
+      policy.discovery?.decision === "disable" ? ` \u2014 ${policy.discovery.reason}` : ""
+    ] }) : /* @__PURE__ */ jsx(Text, { dimColor: true, children: "no discovery hook" }),
+    policy.threw ? /* @__PURE__ */ jsx(Text, { color: "red", bold: true, children: " THREW" }) : null,
+    policy.confirmationEscalation ? /* @__PURE__ */ jsx(Text, { color: "magenta", children: " escalates-confirmation" }) : null
+  ] });
+}
+function Capability({ row }) {
+  const outcome = OUTCOME[row.outcome];
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { color: outcome.color, children: `  ${outcome.mark} ` }),
+      /* @__PURE__ */ jsx(Text, { bold: true, children: row.name }),
+      row.tags.length > 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${row.tags.join(" \xB7 ")}` }) : null
+    ] }),
+    /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: row.description }) }),
+    row.reason ? /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { color: "yellow", wrap: "wrap", children: `\u2937 ${row.reason}` }) }) : null,
+    row.policies ? row.policies.length > 0 ? row.policies.map((policy, index) => /* @__PURE__ */ jsx(PolicyLine, { policy }, `${policy.name}-${index}`)) : [
+      /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: "policies: none" }) }, "none")
+    ] : null,
+    row.policies && row.availability && !row.availability.available ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: `availability: unavailable${row.availability.reason ? ` \u2014 ${row.availability.reason}` : ""}` }) }) : null,
+    row.schemas?.input !== void 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: `input: ${JSON.stringify(row.schemas.input)}` }) }) : null,
+    row.schemas?.output !== void 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: `output: ${JSON.stringify(row.schemas.output)}` }) }) : null
+  ] });
+}
+function Group({ group }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { backgroundColor: "blueBright", color: "black", bold: true, children: ` ${group.heading} ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${group.rows.length}` })
+    ] }),
+    group.rows.map((row) => /* @__PURE__ */ jsx(Capability, { row }, `${row.capabilityId}-${row.name}`))
+  ] });
+}
+function Header({ view }) {
+  return /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: view.scenario }),
+    view.route ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${view.route}` }) : null,
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  \xB7  " }),
+    /* @__PURE__ */ jsx(Text, { color: "green", children: `${view.counts.callable} callable` }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: ", " }),
+    /* @__PURE__ */ jsx(Text, { color: "yellow", children: `${view.counts.disabled} visible-disabled` }),
+    view.explained ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: ", " }),
+      /* @__PURE__ */ jsx(Text, { color: "red", children: `${view.counts.hidden} hidden` })
+    ] }) : null
+  ] });
+}
+function Empty({ view }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: "Nothing is registered for this scenario \u2014 the agent has no surface here. That is the default: capabilities exist only where they were explicitly annotated." }),
+    view.explained ? null : /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Re-run with --explain to see whether a policy hid it." })
+  ] });
+}
+function Surface({ view }) {
+  const populated = view.groups.filter((group) => group.rows.length > 0);
+  const blocks = [
+    { key: "__header" },
+    ...populated.map((group) => ({ key: group.heading, group }))
+  ];
+  return /* @__PURE__ */ jsx(Static, { items: blocks, children: (block) => block.group ? /* @__PURE__ */ jsx(Group, { group: block.group }, block.key) : /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(Header, { view }),
+    populated.length === 0 ? /* @__PURE__ */ jsx(Empty, { view }) : null
+  ] }, block.key) });
+}
+function Drift({
+  scenario,
+  entries
+}) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { backgroundColor: "yellow", color: "black", bold: true, children: ` ${scenario} ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${entries.length} change${entries.length === 1 ? "" : "s"}` })
+    ] }),
+    entries.map((entry) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [
+      entry.subject ? /* @__PURE__ */ jsxs(Text, { bold: true, children: [
+        entry.subject,
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${entry.path}` })
+      ] }) : null,
+      entry.kind === "added" ? /* @__PURE__ */ jsx(Text, { color: "green", wrap: "wrap", children: `+ ${entry.path}  ${formatValue(entry.after)}` }) : entry.kind === "removed" ? /* @__PURE__ */ jsx(Text, { color: "red", wrap: "wrap", children: `- ${entry.path}  ${formatValue(entry.before)}` }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Text, { color: "yellow", children: `~ ${entry.path}` }),
+        /* @__PURE__ */ jsx(Text, { color: "red", wrap: "wrap", children: `    before: ${formatValue(entry.before)}` }),
+        /* @__PURE__ */ jsx(Text, { color: "green", wrap: "wrap", children: `    after:  ${formatValue(entry.after)}` })
+      ] })
+    ] }, `${entry.kind}-${entry.path}`))
+  ] });
+}
+export {
+  Drift,
+  Loading,
+  Surface
+};
+//# sourceMappingURL=ink-GCWDO4ML.js.map

package/dist/ink-GCWDO4ML.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render/ink.tsx"],"sourcesContent":["import type { ReactElement } from \"react\";\nimport { Box, Static, Text } from \"ink\";\nimport Spinner from \"ink-spinner\";\nimport type { CapabilityRow, CapabilityGroup, SurfaceView } from \"./model.js\";\nimport type { DiffEntry } from \"../baseline.js\";\nimport { formatValue } from \"../baseline.js\";\n\nconst OUTCOME = {\n  expose: { mark: \"●\", color: \"green\" as const },\n  disable: { mark: \"◐\", color: \"yellow\" as const },\n  hide: { mark: \"○\", color: \"red\" as const },\n};\n\nexport function Loading({ label }: { label: string }): ReactElement {\n  return (\n    <Text>\n      <Text color=\"cyan\">\n        <Spinner type=\"dots\" />\n      </Text>\n      {` ${label}`}\n    </Text>\n  );\n}\n\nfunction PolicyLine({\n  policy,\n}: {\n  policy: NonNullable<CapabilityRow[\"policies\"]>[number];\n}): ReactElement {\n  const vote = policy.discovery?.decision;\n  const color = vote === \"hide\" ? \"red\" : vote === \"disable\" ? \"yellow\" : \"green\";\n  return (\n    <Box paddingLeft={6}>\n      <Text dimColor>policy </Text>\n      <Text bold>{policy.name}</Text>\n      <Text dimColor>{` (${policy.scope}${policy.phases.length ? `, ${policy.phases.join(\"/\")}` : \"\"}) `}</Text>\n      {vote ? (\n        <Text color={color}>\n          {vote}\n          {policy.discovery?.decision === \"disable\" ? ` — ${policy.discovery.reason}` : \"\"}\n        </Text>\n      ) : (\n        <Text dimColor>no discovery hook</Text>\n      )}\n      {policy.threw ? <Text color=\"red\" bold>{\" THREW\"}</Text> : null}\n      {policy.confirmationEscalation ? (\n        <Text color=\"magenta\">{\" escalates-confirmation\"}</Text>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction Capability({ row }: { row: CapabilityRow }): ReactElement {\n  const outcome = OUTCOME[row.outcome];\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text color={outcome.color}>{`  ${outcome.mark} `}</Text>\n        <Text bold>{row.name}</Text>\n        {row.tags.length > 0 ? <Text dimColor>{`  ${row.tags.join(\" · \")}`}</Text> : null}\n      </Box>\n      <Box paddingLeft={4}>\n        <Text dimColor wrap=\"wrap\">\n          {row.description}\n        </Text>\n      </Box>\n      {row.reason ? (\n        <Box paddingLeft={4}>\n          <Text color=\"yellow\" wrap=\"wrap\">{`⤷ ${row.reason}`}</Text>\n        </Box>\n      ) : null}\n      {row.policies\n        ? row.policies.length > 0\n          ? row.policies.map((policy, index) => (\n              <PolicyLine key={`${policy.name}-${index}`} policy={policy} />\n            ))\n          : [\n              <Box key=\"none\" paddingLeft={6}>\n                <Text dimColor>policies: none</Text>\n              </Box>,\n            ]\n        : null}\n      {row.policies && row.availability && !row.availability.available ? (\n        <Box paddingLeft={6}>\n          <Text dimColor>{`availability: unavailable${\n            row.availability.reason ? ` — ${row.availability.reason}` : \"\"\n          }`}</Text>\n        </Box>\n      ) : null}\n      {row.schemas?.input !== undefined ? (\n        <Box paddingLeft={6}>\n          <Text dimColor wrap=\"wrap\">{`input: ${JSON.stringify(row.schemas.input)}`}</Text>\n        </Box>\n      ) : null}\n      {row.schemas?.output !== undefined ? (\n        <Box paddingLeft={6}>\n          <Text dimColor wrap=\"wrap\">{`output: ${JSON.stringify(row.schemas.output)}`}</Text>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction Group({ group }: { group: CapabilityGroup }): ReactElement {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text backgroundColor=\"blueBright\" color=\"black\" bold>{` ${group.heading} `}</Text>\n        <Text dimColor>{`  ${group.rows.length}`}</Text>\n      </Box>\n      {group.rows.map((row) => (\n        <Capability key={`${row.capabilityId}-${row.name}`} row={row} />\n      ))}\n    </Box>\n  );\n}\n\nfunction Header({ view }: { view: SurfaceView }): ReactElement {\n  return (\n    <Box>\n      <Text bold>{view.scenario}</Text>\n      {view.route ? <Text dimColor>{`  ${view.route}`}</Text> : null}\n      <Text dimColor>{\"  ·  \"}</Text>\n      <Text color=\"green\">{`${view.counts.callable} callable`}</Text>\n      <Text dimColor>{\", \"}</Text>\n      <Text color=\"yellow\">{`${view.counts.disabled} visible-disabled`}</Text>\n      {view.explained ? (\n        <>\n          <Text dimColor>{\", \"}</Text>\n          <Text color=\"red\">{`${view.counts.hidden} hidden`}</Text>\n        </>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction Empty({ view }: { view: SurfaceView }): ReactElement {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Text dimColor wrap=\"wrap\">\n        Nothing is registered for this scenario — the agent has no surface here. That is the\n        default: capabilities exist only where they were explicitly annotated.\n      </Text>\n      {view.explained ? null : (\n        <Text dimColor>Re-run with --explain to see whether a policy hid it.</Text>\n      )}\n    </Box>\n  );\n}\n\ntype Block = { key: string; group?: CapabilityGroup };\n\nexport function Surface({ view }: { view: SurfaceView }): ReactElement {\n  const populated = view.groups.filter((group) => group.rows.length > 0);\n\n  // Everything goes through <Static>, header included. Ink paints static output\n  // once, permanently, above the live frame — and erases the live frame on\n  // unmount. A one-shot render that leaves anything outside <Static> therefore\n  // prints it and then wipes it, which is exactly what happened to this header.\n  const blocks: Block[] = [\n    { key: \"__header\" },\n    ...populated.map((group) => ({ key: group.heading, group })),\n  ];\n\n  return (\n    <Static items={blocks}>\n      {(block) =>\n        block.group ? (\n          <Group key={block.key} group={block.group} />\n        ) : (\n          <Box key={block.key} flexDirection=\"column\">\n            <Header view={view} />\n            {populated.length === 0 ? <Empty view={view} /> : null}\n          </Box>\n        )\n      }\n    </Static>\n  );\n}\n\nexport function Drift({\n  scenario,\n  entries,\n}: {\n  scenario: string;\n  entries: DiffEntry[];\n}): ReactElement {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text backgroundColor=\"yellow\" color=\"black\" bold>{` ${scenario} `}</Text>\n        <Text dimColor>{`  ${entries.length} change${entries.length === 1 ? \"\" : \"s\"}`}</Text>\n      </Box>\n      {entries.map((entry) => (\n        <Box key={`${entry.kind}-${entry.path}`} flexDirection=\"column\" paddingLeft={2}>\n          {entry.subject ? (\n            <Text bold>\n              {entry.subject}\n              <Text dimColor>{`  ${entry.path}`}</Text>\n            </Text>\n          ) : null}\n          {entry.kind === \"added\" ? (\n            <Text color=\"green\" wrap=\"wrap\">{`+ ${entry.path}  ${formatValue(entry.after)}`}</Text>\n          ) : entry.kind === \"removed\" ? (\n            <Text color=\"red\" wrap=\"wrap\">{`- ${entry.path}  ${formatValue(entry.before)}`}</Text>\n          ) : (\n            <>\n              <Text color=\"yellow\">{`~ ${entry.path}`}</Text>\n              <Text color=\"red\" wrap=\"wrap\">{`    before: ${formatValue(entry.before)}`}</Text>\n              <Text color=\"green\" wrap=\"wrap\">{`    after:  ${formatValue(entry.after)}`}</Text>\n            </>\n          )}\n        </Box>\n      ))}\n    </Box>\n  );\n}\n"],"mappings":"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","names":[]}