@agent-surface/cli 0.8.0

package/dist/inspect-3AXX3VVK.js

@@ -0,0 +1,202 @@
+import {
+  renderSurfacePlain
+} from "./chunk-KZUR4CAU.js";
+import {
+  createSurfaceRunner,
+  isPlain,
+  loadInk,
+  paint,
+  transient,
+  write
+} from "./chunk-S2LM3N6D.js";
+import "./chunk-ODUIFFPM.js";
+
+// src/render/model.ts
+function leafOf(capabilityId) {
+  const withoutPlane = capabilityId.replace(/^(view|domain):/, "");
+  const dot = withoutPlane.lastIndexOf(".");
+  return dot === -1 ? withoutPlane : withoutPlane.slice(dot + 1);
+}
+function observationTags() {
+  return ["observation"];
+}
+function actionTags(action) {
+  const tags = [action.effect];
+  if (action.idempotent) tags.push("idempotent");
+  if (action.reversible) tags.push("reversible");
+  if (action.confirmation !== "never") tags.push(`confirmation:${action.confirmation}`);
+  return tags;
+}
+function procedureTags(procedure) {
+  const tags = [procedure.effect];
+  if (procedure.confirmation !== "never") tags.push(`confirmation:${procedure.confirmation}`);
+  for (const field of procedure.boundFields) {
+    tags.push(`${field.path} bound${field.locked ? "+locked" : ""}`);
+  }
+  return tags;
+}
+function explanationIndex(explanation) {
+  const index = /* @__PURE__ */ new Map();
+  for (const capability of explanation.capabilities) {
+    index.set(`${capability.capabilityId}\0${capability.registrationId}`, capability);
+  }
+  return index;
+}
+function buildView(result, options = {}) {
+  const { snapshot, explanation } = result;
+  const index = explanationIndex(explanation);
+  const groups = [];
+  const counts = { callable: 0, disabled: 0, hidden: 0 };
+  const enrich = (row, capabilityId, registrationId) => {
+    const explained = index.get(`${capabilityId}\0${registrationId}`);
+    if (options.explain && explained) {
+      row.policies = explained.policies;
+      row.availability = explained.availability;
+    }
+    return row;
+  };
+  for (const component of snapshot.components) {
+    const rows = [];
+    for (const observation of component.observations) {
+      rows.push(
+        enrich(
+          rowFor(observation, "observation", observationTags(), options, {
+            input: void 0,
+            output: observation.outputSchema
+          }),
+          observation.capabilityId,
+          component.registrationId
+        )
+      );
+    }
+    for (const action of component.actions) {
+      rows.push(
+        enrich(
+          rowFor(action, "action", actionTags(action), options, {
+            input: action.inputSchema,
+            output: action.outputSchema
+          }),
+          action.capabilityId,
+          component.registrationId
+        )
+      );
+    }
+    groups.push({
+      heading: component.instanceId === "default" ? component.type : `${component.type}@${component.instanceId}`,
+      rows
+    });
+  }
+  if (snapshot.procedures.length > 0) {
+    groups.push({
+      heading: "authoritative (domain)",
+      rows: snapshot.procedures.map(
+        (procedure) => enrich(
+          {
+            capabilityId: procedure.procedureId,
+            name: procedure.procedureId.replace(/^domain:/, ""),
+            kind: "procedure",
+            plane: "domain",
+            outcome: procedure.available ? "expose" : "disable",
+            description: procedure.description,
+            ...procedure.unavailableReason ? { reason: procedure.unavailableReason } : {},
+            tags: procedureTags(procedure),
+            ...options.schemas ? { schemas: { input: procedure.inputSchema, output: procedure.outputSchema } } : {}
+          },
+          procedure.procedureId,
+          procedure.registrationId
+        )
+      )
+    });
+  }
+  if (options.explain) {
+    const hidden = explanation.capabilities.filter((c) => c.outcome === "hide");
+    if (hidden.length > 0) {
+      groups.push({
+        heading: "hidden by policy (absent from the snapshot)",
+        rows: hidden.map((capability) => ({
+          capabilityId: capability.capabilityId,
+          name: leafOf(capability.capabilityId),
+          kind: capability.kind,
+          plane: capability.plane,
+          outcome: "hide",
+          description: capability.description,
+          tags: [`${capability.component.type}@${capability.component.instanceId}`],
+          policies: capability.policies,
+          availability: capability.availability
+        }))
+      });
+    }
+  }
+  for (const capability of explanation.capabilities) {
+    if (capability.outcome === "expose") counts.callable += 1;
+    else if (capability.outcome === "disable") counts.disabled += 1;
+    else counts.hidden += 1;
+  }
+  return {
+    scenario: result.scenario,
+    ...snapshot.route?.path ? { route: snapshot.route.path } : {},
+    groups,
+    counts,
+    explained: options.explain === true
+  };
+}
+function rowFor(descriptor, kind, tags, options, schemas) {
+  return {
+    capabilityId: descriptor.capabilityId,
+    name: descriptor.name,
+    kind,
+    plane: "view",
+    outcome: descriptor.available ? "expose" : "disable",
+    description: descriptor.description,
+    ...descriptor.unavailableReason ? { reason: descriptor.unavailableReason } : {},
+    tags,
+    ...options.schemas ? { schemas } : {}
+  };
+}
+
+// src/commands/inspect.tsx
+import { jsx } from "react/jsx-runtime";
+async function runInspect(options) {
+  const runner = await createSurfaceRunner(options.configPath);
+  const ink = isPlain(options) ? null : await loadInk();
+  try {
+    const scenario = options.scenario ?? runner.scenarioNames[0];
+    const stop = ink ? await transient(/* @__PURE__ */ jsx(ink.Loading, { label: `mounting ${scenario}\u2026` })) : void 0;
+    let result;
+    try {
+      result = await runner.collect({
+        scenario,
+        ...options.scope ? { scope: options.scope } : {}
+      });
+    } finally {
+      stop?.();
+    }
+    if (options.json) {
+      write(
+        JSON.stringify(
+          {
+            scenario: result.scenario,
+            snapshot: result.snapshot,
+            ...options.explain ? { explanation: result.explanation } : {}
+          },
+          null,
+          2
+        )
+      );
+      return 0;
+    }
+    const view = buildView(result, {
+      ...options.explain ? { explain: true } : {},
+      ...options.schemas ? { schemas: true } : {}
+    });
+    if (ink) await paint(/* @__PURE__ */ jsx(ink.Surface, { view }));
+    else write(renderSurfacePlain(view));
+    return 0;
+  } finally {
+    await runner.close();
+  }
+}
+export {
+  runInspect
+};
+//# sourceMappingURL=inspect-3AXX3VVK.js.map

package/dist/inspect-3AXX3VVK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render/model.ts","../src/commands/inspect.tsx"],"sourcesContent":["import type {\n  AgentActionDescriptor,\n  AgentObservationDescriptor,\n  AgentProcedureDescriptor,\n  AgentSurfaceSnapshot,\n} from \"@agent-surface/core\";\nimport type { CapabilityExplanation, SurfaceExplanation } from \"@agent-surface/core/explain\";\nimport type { CollectResult } from \"../collect.js\";\n\n/**\n * One view model, two renderers. The Ink UI and the plain-text fallback both\n * consume this, so `--plain` can never drift into showing something different\n * from what a TTY shows.\n */\nexport interface CapabilityRow {\n  capabilityId: string;\n  /** Leaf name — the group heading already carries the rest of the id. */\n  name: string;\n  kind: \"observation\" | \"action\" | \"procedure\";\n  plane: \"view\" | \"domain\";\n  outcome: \"expose\" | \"disable\" | \"hide\";\n  description: string;\n  reason?: string;\n  tags: string[];\n  policies?: CapabilityExplanation[\"policies\"];\n  availability?: CapabilityExplanation[\"availability\"];\n  schemas?: { input?: unknown; output?: unknown };\n}\n\nexport interface CapabilityGroup {\n  heading: string;\n  rows: CapabilityRow[];\n}\n\nexport interface SurfaceView {\n  scenario: string;\n  route?: string;\n  groups: CapabilityGroup[];\n  counts: { callable: number; disabled: number; hidden: number };\n  explained: boolean;\n}\n\nexport interface ViewOptions {\n  explain?: boolean;\n  schemas?: boolean;\n}\n\nfunction leafOf(capabilityId: string): string {\n  const withoutPlane = capabilityId.replace(/^(view|domain):/, \"\");\n  const dot = withoutPlane.lastIndexOf(\".\");\n  return dot === -1 ? withoutPlane : withoutPlane.slice(dot + 1);\n}\n\nfunction observationTags(): string[] {\n  return [\"observation\"];\n}\n\nfunction actionTags(action: AgentActionDescriptor): string[] {\n  const tags: string[] = [action.effect];\n  if (action.idempotent) tags.push(\"idempotent\");\n  if (action.reversible) tags.push(\"reversible\");\n  if (action.confirmation !== \"never\") tags.push(`confirmation:${action.confirmation}`);\n  return tags;\n}\n\nfunction procedureTags(procedure: AgentProcedureDescriptor): string[] {\n  const tags: string[] = [procedure.effect];\n  if (procedure.confirmation !== \"never\") tags.push(`confirmation:${procedure.confirmation}`);\n  for (const field of procedure.boundFields) {\n    tags.push(`${field.path} bound${field.locked ? \"+locked\" : \"\"}`);\n  }\n  return tags;\n}\n\nfunction explanationIndex(explanation: SurfaceExplanation): Map<string, CapabilityExplanation> {\n  const index = new Map<string, CapabilityExplanation>();\n  for (const capability of explanation.capabilities) {\n    // Keyed by id + registration so two instances of one component stay apart.\n    index.set(`${capability.capabilityId}\u0000${capability.registrationId}`, capability);\n  }\n  return index;\n}\n\nexport function buildView(result: CollectResult, options: ViewOptions = {}): SurfaceView {\n  const { snapshot, explanation } = result;\n  const index = explanationIndex(explanation);\n  const groups: CapabilityGroup[] = [];\n  const counts = { callable: 0, disabled: 0, hidden: 0 };\n\n  const enrich = (\n    row: CapabilityRow,\n    capabilityId: string,\n    registrationId: string,\n  ): CapabilityRow => {\n    const explained = index.get(`${capabilityId}\u0000${registrationId}`);\n    if (options.explain && explained) {\n      row.policies = explained.policies;\n      row.availability = explained.availability;\n    }\n    return row;\n  };\n\n  for (const component of snapshot.components) {\n    const rows: CapabilityRow[] = [];\n\n    for (const observation of component.observations) {\n      rows.push(\n        enrich(\n          rowFor(observation, \"observation\", observationTags(), options, {\n            input: undefined,\n            output: observation.outputSchema,\n          }),\n          observation.capabilityId,\n          component.registrationId,\n        ),\n      );\n    }\n    for (const action of component.actions) {\n      rows.push(\n        enrich(\n          rowFor(action, \"action\", actionTags(action), options, {\n            input: action.inputSchema,\n            output: action.outputSchema,\n          }),\n          action.capabilityId,\n          component.registrationId,\n        ),\n      );\n    }\n\n    groups.push({\n      heading:\n        component.instanceId === \"default\"\n          ? component.type\n          : `${component.type}@${component.instanceId}`,\n      rows,\n    });\n  }\n\n  if (snapshot.procedures.length > 0) {\n    groups.push({\n      heading: \"authoritative (domain)\",\n      rows: snapshot.procedures.map((procedure) =>\n        enrich(\n          {\n            capabilityId: procedure.procedureId,\n            name: procedure.procedureId.replace(/^domain:/, \"\"),\n            kind: \"procedure\",\n            plane: \"domain\",\n            outcome: procedure.available ? \"expose\" : \"disable\",\n            description: procedure.description,\n            ...(procedure.unavailableReason ? { reason: procedure.unavailableReason } : {}),\n            tags: procedureTags(procedure),\n            ...(options.schemas\n              ? { schemas: { input: procedure.inputSchema, output: procedure.outputSchema } }\n              : {}),\n          },\n          procedure.procedureId,\n          procedure.registrationId,\n        ),\n      ),\n    });\n  }\n\n  // Hidden capabilities exist only in the explanation — that is the whole point\n  // of it. They get their own group so nobody mistakes them for callable.\n  if (options.explain) {\n    const hidden = explanation.capabilities.filter((c) => c.outcome === \"hide\");\n    if (hidden.length > 0) {\n      groups.push({\n        heading: \"hidden by policy (absent from the snapshot)\",\n        rows: hidden.map((capability) => ({\n          capabilityId: capability.capabilityId,\n          name: leafOf(capability.capabilityId),\n          kind: capability.kind,\n          plane: capability.plane,\n          outcome: \"hide\" as const,\n          description: capability.description,\n          tags: [`${capability.component.type}@${capability.component.instanceId}`],\n          policies: capability.policies,\n          availability: capability.availability,\n        })),\n      });\n    }\n  }\n\n  for (const capability of explanation.capabilities) {\n    if (capability.outcome === \"expose\") counts.callable += 1;\n    else if (capability.outcome === \"disable\") counts.disabled += 1;\n    else counts.hidden += 1;\n  }\n\n  return {\n    scenario: result.scenario,\n    ...(snapshot.route?.path ? { route: snapshot.route.path } : {}),\n    groups,\n    counts,\n    explained: options.explain === true,\n  };\n}\n\nfunction rowFor(\n  descriptor: AgentObservationDescriptor | AgentActionDescriptor,\n  kind: \"observation\" | \"action\",\n  tags: string[],\n  options: ViewOptions,\n  schemas: { input?: unknown; output?: unknown },\n): CapabilityRow {\n  return {\n    capabilityId: descriptor.capabilityId,\n    name: descriptor.name,\n    kind,\n    plane: \"view\",\n    outcome: descriptor.available ? \"expose\" : \"disable\",\n    description: descriptor.description,\n    ...(descriptor.unavailableReason ? { reason: descriptor.unavailableReason } : {}),\n    tags,\n    ...(options.schemas ? { schemas } : {}),\n  };\n}\n","import { createSurfaceRunner } from \"../load.js\";\nimport { buildView } from \"../render/model.js\";\nimport { renderSurfacePlain } from \"../render/plain.js\";\nimport { isPlain, loadInk, paint, transient, write } from \"../output.js\";\n\nexport interface InspectOptions {\n  configPath: string;\n  scenario?: string;\n  scope?: string[];\n  explain?: boolean;\n  schemas?: boolean;\n  json?: boolean;\n  plain?: boolean;\n}\n\nexport async function runInspect(options: InspectOptions): Promise<number> {\n  const runner = await createSurfaceRunner(options.configPath);\n  // `null` when Ink cannot run here (React 18 host), which is a fallback to\n  // plain text rather than a failed command — see loadInk().\n  const ink = isPlain(options) ? null : await loadInk();\n  try {\n    const scenario = options.scenario ?? runner.scenarioNames[0]!;\n    const stop = ink ? await transient(<ink.Loading label={`mounting ${scenario}…`} />) : undefined;\n\n    let result;\n    try {\n      result = await runner.collect({\n        scenario,\n        ...(options.scope ? { scope: options.scope } : {}),\n      });\n    } finally {\n      stop?.();\n    }\n\n    if (options.json) {\n      write(\n        JSON.stringify(\n          {\n            scenario: result.scenario,\n            snapshot: result.snapshot,\n            ...(options.explain ? { explanation: result.explanation } : {}),\n          },\n          null,\n          2,\n        ),\n      );\n      return 0;\n    }\n\n    const view = buildView(result, {\n      ...(options.explain ? { explain: true } : {}),\n      ...(options.schemas ? { schemas: true } : {}),\n    });\n\n    if (ink) await paint(<ink.Surface view={view} />);\n    else write(renderSurfacePlain(view));\n    return 0;\n  } finally {\n    await runner.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AA+CA,SAAS,OAAO,cAA8B;AAC5C,QAAM,eAAe,aAAa,QAAQ,mBAAmB,EAAE;AAC/D,QAAM,MAAM,aAAa,YAAY,GAAG;AACxC,SAAO,QAAQ,KAAK,eAAe,aAAa,MAAM,MAAM,CAAC;AAC/D;AAEA,SAAS,kBAA4B;AACnC,SAAO,CAAC,aAAa;AACvB;AAEA,SAAS,WAAW,QAAyC;AAC3D,QAAM,OAAiB,CAAC,OAAO,MAAM;AACrC,MAAI,OAAO,WAAY,MAAK,KAAK,YAAY;AAC7C,MAAI,OAAO,WAAY,MAAK,KAAK,YAAY;AAC7C,MAAI,OAAO,iBAAiB,QAAS,MAAK,KAAK,gBAAgB,OAAO,YAAY,EAAE;AACpF,SAAO;AACT;AAEA,SAAS,cAAc,WAA+C;AACpE,QAAM,OAAiB,CAAC,UAAU,MAAM;AACxC,MAAI,UAAU,iBAAiB,QAAS,MAAK,KAAK,gBAAgB,UAAU,YAAY,EAAE;AAC1F,aAAW,SAAS,UAAU,aAAa;AACzC,SAAK,KAAK,GAAG,MAAM,IAAI,SAAS,MAAM,SAAS,YAAY,EAAE,EAAE;AAAA,EACjE;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,aAAqE;AAC7F,QAAM,QAAQ,oBAAI,IAAmC;AACrD,aAAW,cAAc,YAAY,cAAc;AAEjD,UAAM,IAAI,GAAG,WAAW,YAAY,KAAI,WAAW,cAAc,IAAI,UAAU;AAAA,EACjF;AACA,SAAO;AACT;AAEO,SAAS,UAAU,QAAuB,UAAuB,CAAC,GAAgB;AACvF,QAAM,EAAE,UAAU,YAAY,IAAI;AAClC,QAAM,QAAQ,iBAAiB,WAAW;AAC1C,QAAM,SAA4B,CAAC;AACnC,QAAM,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,EAAE;AAErD,QAAM,SAAS,CACb,KACA,cACA,mBACkB;AAClB,UAAM,YAAY,MAAM,IAAI,GAAG,YAAY,KAAI,cAAc,EAAE;AAC/D,QAAI,QAAQ,WAAW,WAAW;AAChC,UAAI,WAAW,UAAU;AACzB,UAAI,eAAe,UAAU;AAAA,IAC/B;AACA,WAAO;AAAA,EACT;AAEA,aAAW,aAAa,SAAS,YAAY;AAC3C,UAAM,OAAwB,CAAC;AAE/B,eAAW,eAAe,UAAU,cAAc;AAChD,WAAK;AAAA,QACH;AAAA,UACE,OAAO,aAAa,eAAe,gBAAgB,GAAG,SAAS;AAAA,YAC7D,OAAO;AAAA,YACP,QAAQ,YAAY;AAAA,UACtB,CAAC;AAAA,UACD,YAAY;AAAA,UACZ,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AACA,eAAW,UAAU,UAAU,SAAS;AACtC,WAAK;AAAA,QACH;AAAA,UACE,OAAO,QAAQ,UAAU,WAAW,MAAM,GAAG,SAAS;AAAA,YACpD,OAAO,OAAO;AAAA,YACd,QAAQ,OAAO;AAAA,UACjB,CAAC;AAAA,UACD,OAAO;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF;AAEA,WAAO,KAAK;AAAA,MACV,SACE,UAAU,eAAe,YACrB,UAAU,OACV,GAAG,UAAU,IAAI,IAAI,UAAU,UAAU;AAAA,MAC/C;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,WAAW,SAAS,GAAG;AAClC,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT,MAAM,SAAS,WAAW;AAAA,QAAI,CAAC,cAC7B;AAAA,UACE;AAAA,YACE,cAAc,UAAU;AAAA,YACxB,MAAM,UAAU,YAAY,QAAQ,YAAY,EAAE;AAAA,YAClD,MAAM;AAAA,YACN,OAAO;AAAA,YACP,SAAS,UAAU,YAAY,WAAW;AAAA,YAC1C,aAAa,UAAU;AAAA,YACvB,GAAI,UAAU,oBAAoB,EAAE,QAAQ,UAAU,kBAAkB,IAAI,CAAC;AAAA,YAC7E,MAAM,cAAc,SAAS;AAAA,YAC7B,GAAI,QAAQ,UACR,EAAE,SAAS,EAAE,OAAO,UAAU,aAAa,QAAQ,UAAU,aAAa,EAAE,IAC5E,CAAC;AAAA,UACP;AAAA,UACA,UAAU;AAAA,UACV,UAAU;AAAA,QACZ;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAIA,MAAI,QAAQ,SAAS;AACnB,UAAM,SAAS,YAAY,aAAa,OAAO,CAAC,MAAM,EAAE,YAAY,MAAM;AAC1E,QAAI,OAAO,SAAS,GAAG;AACrB,aAAO,KAAK;AAAA,QACV,SAAS;AAAA,QACT,MAAM,OAAO,IAAI,CAAC,gBAAgB;AAAA,UAChC,cAAc,WAAW;AAAA,UACzB,MAAM,OAAO,WAAW,YAAY;AAAA,UACpC,MAAM,WAAW;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,SAAS;AAAA,UACT,aAAa,WAAW;AAAA,UACxB,MAAM,CAAC,GAAG,WAAW,UAAU,IAAI,IAAI,WAAW,UAAU,UAAU,EAAE;AAAA,UACxE,UAAU,WAAW;AAAA,UACrB,cAAc,WAAW;AAAA,QAC3B,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF;AAEA,aAAW,cAAc,YAAY,cAAc;AACjD,QAAI,WAAW,YAAY,SAAU,QAAO,YAAY;AAAA,aAC/C,WAAW,YAAY,UAAW,QAAO,YAAY;AAAA,QACzD,QAAO,UAAU;AAAA,EACxB;AAEA,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,GAAI,SAAS,OAAO,OAAO,EAAE,OAAO,SAAS,MAAM,KAAK,IAAI,CAAC;AAAA,IAC7D;AAAA,IACA;AAAA,IACA,WAAW,QAAQ,YAAY;AAAA,EACjC;AACF;AAEA,SAAS,OACP,YACA,MACA,MACA,SACA,SACe;AACf,SAAO;AAAA,IACL,cAAc,WAAW;AAAA,IACzB,MAAM,WAAW;AAAA,IACjB;AAAA,IACA,OAAO;AAAA,IACP,SAAS,WAAW,YAAY,WAAW;AAAA,IAC3C,aAAa,WAAW;AAAA,IACxB,GAAI,WAAW,oBAAoB,EAAE,QAAQ,WAAW,kBAAkB,IAAI,CAAC;AAAA,IAC/E;AAAA,IACA,GAAI,QAAQ,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,EACvC;AACF;;;ACrMuC;AAPvC,eAAsB,WAAW,SAA0C;AACzE,QAAM,SAAS,MAAM,oBAAoB,QAAQ,UAAU;AAG3D,QAAM,MAAM,QAAQ,OAAO,IAAI,OAAO,MAAM,QAAQ;AACpD,MAAI;AACF,UAAM,WAAW,QAAQ,YAAY,OAAO,cAAc,CAAC;AAC3D,UAAM,OAAO,MAAM,MAAM,UAAU,oBAAC,IAAI,SAAJ,EAAY,OAAO,YAAY,QAAQ,UAAK,CAAE,IAAI;AAEtF,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,OAAO,QAAQ;AAAA,QAC5B;AAAA,QACA,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MAClD,CAAC;AAAA,IACH,UAAE;AACA,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ,MAAM;AAChB;AAAA,QACE,KAAK;AAAA,UACH;AAAA,YACE,UAAU,OAAO;AAAA,YACjB,UAAU,OAAO;AAAA,YACjB,GAAI,QAAQ,UAAU,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;AAAA,UAC/D;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,UAAU,QAAQ;AAAA,MAC7B,GAAI,QAAQ,UAAU,EAAE,SAAS,KAAK,IAAI,CAAC;AAAA,MAC3C,GAAI,QAAQ,UAAU,EAAE,SAAS,KAAK,IAAI,CAAC;AAAA,IAC7C,CAAC;AAED,QAAI,IAAK,OAAM,MAAM,oBAAC,IAAI,SAAJ,EAAY,MAAY,CAAE;AAAA,QAC3C,OAAM,mBAAmB,IAAI,CAAC;AACnC,WAAO;AAAA,EACT,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AACF;","names":[]}

package/dist/snapshot-3D55FL63.js

@@ -0,0 +1,36 @@
+import {
+  createSurfaceRunner,
+  write
+} from "./chunk-S2LM3N6D.js";
+import {
+  baselineDirFor,
+  baselinePath,
+  normalize,
+  writeBaseline
+} from "./chunk-ODUIFFPM.js";
+
+// src/commands/snapshot.ts
+import { relative } from "path";
+async function runSnapshot(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);
+    for (const scenario of scenarios) {
+      const result = await runner.collect({
+        scenario,
+        ...options.scope ? { scope: options.scope } : {}
+      });
+      const path = baselinePath(dir, scenario);
+      writeBaseline(path, normalize(result.snapshot));
+      write(`wrote ${relative(process.cwd(), path)}`);
+    }
+    return 0;
+  } finally {
+    await runner.close();
+  }
+}
+export {
+  runSnapshot
+};
+//# sourceMappingURL=snapshot-3D55FL63.js.map

package/dist/snapshot-3D55FL63.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/snapshot.ts"],"sourcesContent":["import { relative } from \"node:path\";\nimport { createSurfaceRunner } from \"../load.js\";\nimport { baselineDirFor, baselinePath, normalize, writeBaseline } from \"../baseline.js\";\nimport { write } from \"../output.js\";\n\nexport interface SnapshotOptions {\n  configPath: string;\n  scenario?: string;\n  scope?: string[];\n  baselineDir?: string;\n}\n\n/** Writes (or refreshes) the committed baseline `check` compares against. */\nexport async function runSnapshot(options: SnapshotOptions): 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\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      writeBaseline(path, normalize(result.snapshot));\n      write(`wrote ${relative(process.cwd(), path)}`);\n    }\n    return 0;\n  } finally {\n    await runner.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,gBAAgB;AAazB,eAAsB,YAAY,SAA2C;AAC3E,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;AAE/F,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,oBAAc,MAAM,UAAU,OAAO,QAAQ,CAAC;AAC9C,YAAM,SAAS,SAAS,QAAQ,IAAI,GAAG,IAAI,CAAC,EAAE;AAAA,IAChD;AACA,WAAO;AAAA,EACT,UAAE;AACA,UAAM,OAAO,MAAM;AAAA,EACrB;AACF;","names":[]}

package/dist/vitest.d.ts

@@ -0,0 +1,30 @@
+import { RenderedAgentSurface } from '@agent-surface/testing/react';
+import { AgentConsumer } from '@agent-surface/core';
+import { M as MountResult, S as ScenarioProps, a as SurfaceConfig } from './config-DqK8YqyQ.js';
+import 'react';
+
+declare const DEFAULT_CLI_CONSUMER: AgentConsumer;
+interface MountScenarioOptions {
+    consumer?: AgentConsumer;
+}
+interface MountedScenario<TApp> {
+    scenario: string;
+    surface: RenderedAgentSurface;
+    mounted: MountResult<TApp>;
+    /**
+     * Whatever `mount()` returned as `app`. Typed as `TApp` rather than
+     * `TApp | undefined` because a config that never sets it infers `TApp` as
+     * `unknown`, and forcing a `!` on every test that *does* set it is worse
+     * than trusting the config's own return type.
+     */
+    app: TApp;
+    consumer: AgentConsumer;
+}
+/**
+ * The one mounting path. `agent-surface inspect` and the Vitest helper both
+ * come through here, so a scenario cannot behave one way in CI and another in
+ * the terminal — which is the entire reason scenarios live in one file.
+ */
+declare function mountScenario<TScenario extends ScenarioProps, TApp>(config: SurfaceConfig<TScenario, TApp>, scenario: string, options?: MountScenarioOptions): Promise<MountedScenario<TApp>>;
+
+export { DEFAULT_CLI_CONSUMER, MountResult, type MountScenarioOptions, type MountedScenario, ScenarioProps, SurfaceConfig, mountScenario };

package/dist/vitest.js

@@ -0,0 +1,9 @@
+import {
+  DEFAULT_CLI_CONSUMER,
+  mountScenario
+} from "./chunk-A2G4QLX5.js";
+export {
+  DEFAULT_CLI_CONSUMER,
+  mountScenario
+};
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@agent-surface/cli",
+  "version": "0.8.0",
+  "description": "Inspect and check the agent surface your app exposes — in the terminal and in CI",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "agent-surface": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "import": "./dist/vitest.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "ink": "^6.3.1",
+    "ink-spinner": "^5.0.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.1.1",
+    "vite": "^7.1.3",
+    "vite-node": "^3.2.4",
+    "@agent-surface/core": "^0.8.0",
+    "@agent-surface/react": "^0.8.0",
+    "@agent-surface/testing": "^0.8.0"
+  },
+  "peerDependencies": {
+    "@testing-library/react": ">=14",
+    "react-dom": ">=18.2"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^20.19.0",
+    "@types/react": "^19.1.9",
+    "react-dom": "^19.1.1"
+  },
+  "author": "Paolo Barbato",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Wiseair-srl/agent-surface.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://agent-surface-docs.vercel.app",
+  "bugs": {
+    "url": "https://github.com/Wiseair-srl/agent-surface/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agent-surface",
+    "cli",
+    "agent",
+    "ai",
+    "llm",
+    "frontend",
+    "capabilities",
+    "inspect",
+    "policies"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}