@tangle-network/agent-app 0.60.181 → 0.60.183

package/dist/toolbelt/index.d.ts

@@ -0,0 +1,80 @@
+/** One authored tool in the product's manifest — the ONE source of truth the
+ *  generated program and every derived surface (allowlists, prompt tool
+ *  tables, dashboards) must agree with. */
+export interface ToolbeltManifestTool {
+    readonly name: string;
+    /** AAA-standard description (what / example / when NOT). Parity requires the
+     *  program to serve it byte-identical — truncation at a bundle boundary is
+     *  drift, not formatting. */
+    readonly description: string;
+    /** JSON Schema for the tool's input. Compared structurally (key order
+     *  insensitive) when either side declares one. */
+    readonly inputSchema?: unknown;
+    /** MCP tool annotations (readOnlyHint, …). Compared structurally when the
+     *  manifest declares them. */
+    readonly annotations?: unknown;
+    /** Product-defined transport tag (`pure` | `http` | …). Not part of the
+     *  wire surface; carried so derived surfaces can key off the manifest. */
+    readonly transport?: string;
+}
+/** A tool as the spawned program actually listed it. */
+export interface ProbedTool {
+    readonly name: string;
+    readonly description?: string;
+    readonly inputSchema?: unknown;
+    readonly annotations?: unknown;
+}
+/** What `probeStdioToolProgram` saw. `serverInfo`/`raw` are included so a
+ *  failed probe can name the layer (the diagnosability rule: never swallow). */
+export interface ToolProgramProbe {
+    readonly tools: readonly ProbedTool[];
+    readonly initializeReply: Record<string, unknown> | null;
+}
+export interface ProbeStdioToolProgramOptions {
+    /** Path to the program to spawn. Spawned with the current Node executable. */
+    readonly program: string;
+    /** Extra argv after the program path. */
+    readonly args?: readonly string[];
+    /** Environment for the child. Defaults to `process.env`. */
+    readonly env?: NodeJS.ProcessEnv;
+    /** Working directory for the child. */
+    readonly cwd?: string;
+    /** Wall-clock ceiling for the whole probe. Default 15s. */
+    readonly timeoutMs?: number;
+}
+/** Spawn the embedded tool program and read its REAL tool surface. */
+export declare function probeStdioToolProgram(options: ProbeStdioToolProgramOptions): Promise<ToolProgramProbe>;
+/** Field-level drift between the manifest and the program's real surface. */
+export interface ToolbeltFieldDrift {
+    readonly name: string;
+    readonly manifest: unknown;
+    readonly program: unknown;
+}
+/** The named diff. Every array is sorted; empty arrays mean agreement. */
+export interface ToolbeltParityDiff {
+    readonly ok: boolean;
+    /** Manifest tools the program did not list (the #10155 class: the verb
+     *  exists in the manifest, absent from the running surface). */
+    readonly missingFromProgram: readonly string[];
+    /** Tools the program listed that no manifest entry owns. */
+    readonly unknownToManifest: readonly string[];
+    /** Tools whose served description is not byte-identical to the manifest. */
+    readonly descriptionDrift: readonly ToolbeltFieldDrift[];
+    /** Tools whose served input schema differs structurally from the manifest. */
+    readonly schemaDrift: readonly ToolbeltFieldDrift[];
+    /** Tools whose served annotations differ structurally from the manifest. */
+    readonly annotationDrift: readonly ToolbeltFieldDrift[];
+}
+/** Diff a spawned program's real surface against the authored manifest. */
+export declare function toolbeltParityDiff(manifest: readonly ToolbeltManifestTool[], listed: readonly ProbedTool[]): ToolbeltParityDiff;
+/** Render a diff as one actionable report — every drift named, never a bare count. */
+export declare function formatToolbeltParityDiff(diff: ToolbeltParityDiff): string;
+/** Thrown by {@link assertToolbeltParity} with the full formatted diff. */
+export declare class ToolbeltParityError extends Error {
+    readonly diff: ToolbeltParityDiff;
+    constructor(diff: ToolbeltParityDiff);
+}
+/** Assert parity: same names, byte-identical descriptions, structurally equal
+ *  schemas and annotations. Throws {@link ToolbeltParityError} with every
+ *  disagreement named — a red build, not a production silence. */
+export declare function assertToolbeltParity(manifest: readonly ToolbeltManifestTool[], listed: readonly ProbedTool[]): void;

package/dist/toolbelt/index.js

@@ -0,0 +1,178 @@
+// src/toolbelt/index.ts
+import { spawn } from "child_process";
+function probeStdioToolProgram(options) {
+  const timeoutMs = options.timeoutMs ?? 15e3;
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [options.program, ...options.args ?? []], {
+      env: options.env ?? process.env,
+      cwd: options.cwd,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    let initializeReply = null;
+    const lines = [];
+    const finish = (run) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      try {
+        child.kill();
+      } catch {
+      }
+      run();
+    };
+    const timer = setTimeout(
+      () => finish(() => reject(new Error(
+        `tool program probe timed out after ${timeoutMs}ms waiting for tools/list. stderr so far: ${stderr.trim().slice(0, 2e3) || "(empty)"}; stdout so far: ${stdout.trim().slice(0, 2e3) || "(empty)"}`
+      ))),
+      timeoutMs
+    );
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk;
+      let index;
+      while ((index = stdout.indexOf("\n")) >= 0) {
+        const line = stdout.slice(0, index).trim();
+        stdout = stdout.slice(index + 1);
+        if (!line) continue;
+        lines.push(line);
+        let message;
+        try {
+          message = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        if (message.method !== void 0) continue;
+        if (message.id === 1) initializeReply = message.result ?? null;
+        if (message.id === 2 && message.result !== void 0 && message.error === void 0) {
+          const rawTools = message.result.tools;
+          const tools = Array.isArray(rawTools) ? rawTools.filter((t) => !!t && typeof t === "object" && typeof t.name === "string").map((t) => {
+            const tool = t;
+            return {
+              name: tool.name,
+              ...tool.description !== void 0 ? { description: tool.description } : {},
+              ...tool.inputSchema !== void 0 ? { inputSchema: tool.inputSchema } : {},
+              ...tool.annotations !== void 0 ? { annotations: tool.annotations } : {}
+            };
+          }) : [];
+          finish(() => resolve({ tools, initializeReply }));
+        } else if (message.id === 2 && message.error !== void 0) {
+          finish(() => reject(new Error(
+            `tool program refused tools/list: ${JSON.stringify(message.error)}`
+          )));
+        }
+      }
+    });
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+    child.on("error", (error) => finish(() => reject(new Error(
+      `tool program probe failed to spawn ${options.program}: ${error.message}`
+    ))));
+    child.on("exit", (code, signal) => finish(() => reject(new Error(
+      `tool program exited before answering tools/list (code ${code}${signal ? `, signal ${signal}` : ""}). stderr: ${stderr.trim().slice(0, 2e3) || "(empty)"}`
+    ))));
+    const send = (payload) => {
+      try {
+        child.stdin.write(JSON.stringify(payload) + "\n");
+      } catch {
+      }
+    };
+    send({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "toolbelt-parity", version: "0.0.0" } } });
+    send({ jsonrpc: "2.0", method: "notifications/initialized" });
+    send({ jsonrpc: "2.0", id: 2, method: "tools/list" });
+  });
+}
+function stableStringify(value) {
+  if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
+  if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
+  const entries = Object.entries(value).filter(([, v]) => v !== void 0).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(",")}}`;
+}
+function toolbeltParityDiff(manifest, listed) {
+  const byName = new Map(manifest.map((tool) => [tool.name, tool]));
+  const listedByName = new Map(listed.map((tool) => [tool.name, tool]));
+  const missingFromProgram = manifest.filter((tool) => !listedByName.has(tool.name)).map((tool) => tool.name).sort();
+  const unknownToManifest = listed.filter((tool) => !byName.has(tool.name)).map((tool) => tool.name).sort();
+  const descriptionDrift = [];
+  const schemaDrift = [];
+  const annotationDrift = [];
+  for (const tool of manifest) {
+    const served = listedByName.get(tool.name);
+    if (!served) continue;
+    if (served.description !== tool.description) {
+      descriptionDrift.push({ name: tool.name, manifest: tool.description, program: served.description ?? null });
+    }
+    const manifestSchema = tool.inputSchema;
+    if (manifestSchema !== void 0 || served.inputSchema !== void 0) {
+      if (stableStringify(manifestSchema) !== stableStringify(served.inputSchema)) {
+        schemaDrift.push({ name: tool.name, manifest: manifestSchema ?? null, program: served.inputSchema ?? null });
+      }
+    }
+    const manifestAnnotations = tool.annotations;
+    if (manifestAnnotations !== void 0 || served.annotations !== void 0) {
+      if (stableStringify(manifestAnnotations) !== stableStringify(served.annotations)) {
+        annotationDrift.push({ name: tool.name, manifest: manifestAnnotations ?? null, program: served.annotations ?? null });
+      }
+    }
+  }
+  const ok = missingFromProgram.length === 0 && unknownToManifest.length === 0 && descriptionDrift.length === 0 && schemaDrift.length === 0 && annotationDrift.length === 0;
+  return {
+    ok,
+    missingFromProgram,
+    unknownToManifest,
+    descriptionDrift,
+    schemaDrift,
+    annotationDrift
+  };
+}
+function formatToolbeltParityDiff(diff) {
+  if (diff.ok) return "toolbelt parity: the program is the manifest";
+  const lines = ["toolbelt parity FAILED \u2014 the program and the manifest disagree:"];
+  if (diff.missingFromProgram.length > 0) {
+    lines.push(`  missing from the program (in the manifest, NOT served): ${diff.missingFromProgram.join(", ")}`);
+  }
+  if (diff.unknownToManifest.length > 0) {
+    lines.push(`  unknown to the manifest (served, NOT authored): ${diff.unknownToManifest.join(", ")}`);
+  }
+  for (const drift of diff.descriptionDrift) {
+    lines.push(`  description drift on "${drift.name}":`);
+    lines.push(`    manifest: ${JSON.stringify(drift.manifest)}`);
+    lines.push(`    program:  ${JSON.stringify(drift.program)}`);
+  }
+  for (const drift of diff.schemaDrift) {
+    lines.push(`  input-schema drift on "${drift.name}":`);
+    lines.push(`    manifest: ${stableStringify(drift.manifest)}`);
+    lines.push(`    program:  ${stableStringify(drift.program)}`);
+  }
+  for (const drift of diff.annotationDrift) {
+    lines.push(`  annotation drift on "${drift.name}":`);
+    lines.push(`    manifest: ${stableStringify(drift.manifest)}`);
+    lines.push(`    program:  ${stableStringify(drift.program)}`);
+  }
+  lines.push("  Fix the ONE manifest (or the generator that derives the program from it) \u2014 never patch a second list.");
+  return lines.join("\n");
+}
+var ToolbeltParityError = class extends Error {
+  diff;
+  constructor(diff) {
+    super(formatToolbeltParityDiff(diff));
+    this.name = "ToolbeltParityError";
+    this.diff = diff;
+  }
+};
+function assertToolbeltParity(manifest, listed) {
+  const diff = toolbeltParityDiff(manifest, listed);
+  if (!diff.ok) throw new ToolbeltParityError(diff);
+}
+export {
+  ToolbeltParityError,
+  assertToolbeltParity,
+  formatToolbeltParityDiff,
+  probeStdioToolProgram,
+  toolbeltParityDiff
+};
+//# sourceMappingURL=index.js.map

package/dist/toolbelt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/toolbelt/index.ts"],"sourcesContent":["/**\n * The toolbelt parity gate — one manifest, every target, enforced at build time.\n *\n * A product with an embedded tool program (a stdio MCP the sandbox spawns)\n * has two representations of its tool surface: the manifest it authors and\n * the program that actually answers `tools/list`. Every hour of pain in the\n * fleet's toolbelt history was those two lists disagreeing — a verb present\n * in one target and absent from the other shipped green and failed in\n * production (hardware-agent #10155 class). This module turns that drift\n * class into a red test: spawn the program, read its real surface, diff it\n * against the manifest, and name every disagreement.\n *\n * Substrate-free by design: Node builtins only, no test-framework\n * dependency, no MCP SDK. `probeStdioToolProgram` speaks just enough\n * JSON-RPC (initialize → initialized → tools/list, replies matched by id,\n * notifications ignored) for a zero-dependency embedded program; the diff\n * and the assert are pure functions any runner (vitest, node:test, a tsx\n * script) can call.\n *\n * Canonical consumer shape:\n *\n * ```ts\n * import { assertToolbeltParity, probeStdioToolProgram } from '@tangle-network/agent-app/toolbelt'\n *\n * const probed = await probeStdioToolProgram({ program: programPath, env })\n * assertToolbeltParity(TOOLBELT, probed.tools) // throws with the named diff\n * ```\n */\nimport { spawn } from 'node:child_process'\n\n/** One authored tool in the product's manifest — the ONE source of truth the\n *  generated program and every derived surface (allowlists, prompt tool\n *  tables, dashboards) must agree with. */\nexport interface ToolbeltManifestTool {\n  readonly name: string\n  /** AAA-standard description (what / example / when NOT). Parity requires the\n   *  program to serve it byte-identical — truncation at a bundle boundary is\n   *  drift, not formatting. */\n  readonly description: string\n  /** JSON Schema for the tool's input. Compared structurally (key order\n   *  insensitive) when either side declares one. */\n  readonly inputSchema?: unknown\n  /** MCP tool annotations (readOnlyHint, …). Compared structurally when the\n   *  manifest declares them. */\n  readonly annotations?: unknown\n  /** Product-defined transport tag (`pure` | `http` | …). Not part of the\n   *  wire surface; carried so derived surfaces can key off the manifest. */\n  readonly transport?: string\n}\n\n/** A tool as the spawned program actually listed it. */\nexport interface ProbedTool {\n  readonly name: string\n  readonly description?: string\n  readonly inputSchema?: unknown\n  readonly annotations?: unknown\n}\n\n/** What `probeStdioToolProgram` saw. `serverInfo`/`raw` are included so a\n *  failed probe can name the layer (the diagnosability rule: never swallow). */\nexport interface ToolProgramProbe {\n  readonly tools: readonly ProbedTool[]\n  readonly initializeReply: Record<string, unknown> | null\n}\n\nexport interface ProbeStdioToolProgramOptions {\n  /** Path to the program to spawn. Spawned with the current Node executable. */\n  readonly program: string\n  /** Extra argv after the program path. */\n  readonly args?: readonly string[]\n  /** Environment for the child. Defaults to `process.env`. */\n  readonly env?: NodeJS.ProcessEnv\n  /** Working directory for the child. */\n  readonly cwd?: string\n  /** Wall-clock ceiling for the whole probe. Default 15s. */\n  readonly timeoutMs?: number\n}\n\n/** Spawn the embedded tool program and read its REAL tool surface. */\nexport function probeStdioToolProgram(options: ProbeStdioToolProgramOptions): Promise<ToolProgramProbe> {\n  const timeoutMs = options.timeoutMs ?? 15_000\n  return new Promise<ToolProgramProbe>((resolve, reject) => {\n    const child = spawn(process.execPath, [options.program, ...(options.args ?? [])], {\n      env: options.env ?? process.env,\n      cwd: options.cwd,\n      stdio: ['pipe', 'pipe', 'pipe'],\n    })\n    let stdout = ''\n    let stderr = ''\n    let settled = false\n    let initializeReply: Record<string, unknown> | null = null\n    const lines: string[] = []\n\n    const finish = (run: () => void) => {\n      if (settled) return\n      settled = true\n      clearTimeout(timer)\n      try { child.kill() } catch { /* already gone */ }\n      run()\n    }\n\n    const timer = setTimeout(\n      () => finish(() => reject(new Error(\n        `tool program probe timed out after ${timeoutMs}ms waiting for tools/list. ` +\n        `stderr so far: ${stderr.trim().slice(0, 2000) || '(empty)'}; ` +\n        `stdout so far: ${stdout.trim().slice(0, 2000) || '(empty)'}`,\n      ))),\n      timeoutMs,\n    )\n\n    child.stdout.setEncoding('utf8')\n    child.stdout.on('data', (chunk: string) => {\n      stdout += chunk\n      let index: number\n      while ((index = stdout.indexOf('\\n')) >= 0) {\n        const line = stdout.slice(0, index).trim()\n        stdout = stdout.slice(index + 1)\n        if (!line) continue\n        lines.push(line)\n        let message: Record<string, unknown>\n        try {\n          message = JSON.parse(line) as Record<string, unknown>\n        } catch {\n          continue // a banner line, not JSON-RPC\n        }\n        if (message.method !== undefined) continue // notification from server\n        if (message.id === 1) initializeReply = message.result as Record<string, unknown> ?? null\n        if (message.id === 2 && message.result !== undefined && message.error === undefined) {\n          const rawTools = (message.result as { tools?: unknown }).tools\n          const tools: ProbedTool[] = Array.isArray(rawTools)\n            ? rawTools.filter((t): t is Record<string, unknown> => !!t && typeof t === 'object' && typeof (t as { name?: unknown }).name === 'string')\n              .map((t) => {\n                const tool = t as unknown as { name: string; description?: string; inputSchema?: unknown; annotations?: unknown }\n                return {\n                  name: tool.name,\n                  ...(tool.description !== undefined ? { description: tool.description } : {}),\n                  ...(tool.inputSchema !== undefined ? { inputSchema: tool.inputSchema } : {}),\n                  ...(tool.annotations !== undefined ? { annotations: tool.annotations } : {}),\n                }\n              })\n            : []\n          finish(() => resolve({ tools, initializeReply }))\n        } else if (message.id === 2 && message.error !== undefined) {\n          finish(() => reject(new Error(\n            `tool program refused tools/list: ${JSON.stringify(message.error)}`,\n          )))\n        }\n      }\n    })\n    child.stderr.setEncoding('utf8')\n    child.stderr.on('data', (chunk: string) => { stderr += chunk })\n    child.on('error', (error) => finish(() => reject(new Error(\n      `tool program probe failed to spawn ${options.program}: ${error.message}`,\n    ))))\n    child.on('exit', (code, signal) => finish(() => reject(new Error(\n      `tool program exited before answering tools/list (code ${code}${signal ? `, signal ${signal}` : ''}). ` +\n      `stderr: ${stderr.trim().slice(0, 2000) || '(empty)'}`,\n    ))))\n\n    // Minimal MCP handshake: initialize → initialized → tools/list. Replies\n    // are matched by id; a program that never replies to initialize still\n    // resolves the probe when its tools/list reply arrives.\n    const send = (payload: unknown) => { try { child.stdin.write(JSON.stringify(payload) + '\\n') } catch { /* closed; exit handler reports */ } }\n    send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2024-11-05', capabilities: {}, clientInfo: { name: 'toolbelt-parity', version: '0.0.0' } } })\n    send({ jsonrpc: '2.0', method: 'notifications/initialized' })\n    send({ jsonrpc: '2.0', id: 2, method: 'tools/list' })\n  })\n}\n\n/** Structural equality with sorted keys — two JSON schemas are the same\n *  contract regardless of key order. */\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value) ?? 'null'\n  if (Array.isArray(value)) return `[${value.map(stableStringify).join(',')}]`\n  const entries = Object.entries(value as Record<string, unknown>)\n    .filter(([, v]) => v !== undefined)\n    .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n  return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(',')}}`\n}\n\n/** Field-level drift between the manifest and the program's real surface. */\nexport interface ToolbeltFieldDrift {\n  readonly name: string\n  readonly manifest: unknown\n  readonly program: unknown\n}\n\n/** The named diff. Every array is sorted; empty arrays mean agreement. */\nexport interface ToolbeltParityDiff {\n  readonly ok: boolean\n  /** Manifest tools the program did not list (the #10155 class: the verb\n   *  exists in the manifest, absent from the running surface). */\n  readonly missingFromProgram: readonly string[]\n  /** Tools the program listed that no manifest entry owns. */\n  readonly unknownToManifest: readonly string[]\n  /** Tools whose served description is not byte-identical to the manifest. */\n  readonly descriptionDrift: readonly ToolbeltFieldDrift[]\n  /** Tools whose served input schema differs structurally from the manifest. */\n  readonly schemaDrift: readonly ToolbeltFieldDrift[]\n  /** Tools whose served annotations differ structurally from the manifest. */\n  readonly annotationDrift: readonly ToolbeltFieldDrift[]\n}\n\n/** Diff a spawned program's real surface against the authored manifest. */\nexport function toolbeltParityDiff(\n  manifest: readonly ToolbeltManifestTool[],\n  listed: readonly ProbedTool[],\n): ToolbeltParityDiff {\n  const byName = new Map(manifest.map((tool) => [tool.name, tool]))\n  const listedByName = new Map(listed.map((tool) => [tool.name, tool]))\n  const missingFromProgram = manifest\n    .filter((tool) => !listedByName.has(tool.name))\n    .map((tool) => tool.name)\n    .sort()\n  const unknownToManifest = listed\n    .filter((tool) => !byName.has(tool.name))\n    .map((tool) => tool.name)\n    .sort()\n  const descriptionDrift: ToolbeltFieldDrift[] = []\n  const schemaDrift: ToolbeltFieldDrift[] = []\n  const annotationDrift: ToolbeltFieldDrift[] = []\n  for (const tool of manifest) {\n    const served = listedByName.get(tool.name)\n    if (!served) continue\n    if (served.description !== tool.description) {\n      descriptionDrift.push({ name: tool.name, manifest: tool.description, program: served.description ?? null })\n    }\n    const manifestSchema = tool.inputSchema\n    if (manifestSchema !== undefined || served.inputSchema !== undefined) {\n      if (stableStringify(manifestSchema) !== stableStringify(served.inputSchema)) {\n        schemaDrift.push({ name: tool.name, manifest: manifestSchema ?? null, program: served.inputSchema ?? null })\n      }\n    }\n    const manifestAnnotations = tool.annotations\n    if (manifestAnnotations !== undefined || served.annotations !== undefined) {\n      if (stableStringify(manifestAnnotations) !== stableStringify(served.annotations)) {\n        annotationDrift.push({ name: tool.name, manifest: manifestAnnotations ?? null, program: served.annotations ?? null })\n      }\n    }\n  }\n  const ok = missingFromProgram.length === 0\n    && unknownToManifest.length === 0\n    && descriptionDrift.length === 0\n    && schemaDrift.length === 0\n    && annotationDrift.length === 0\n  return {\n    ok,\n    missingFromProgram,\n    unknownToManifest,\n    descriptionDrift,\n    schemaDrift,\n    annotationDrift,\n  }\n}\n\n/** Render a diff as one actionable report — every drift named, never a bare count. */\nexport function formatToolbeltParityDiff(diff: ToolbeltParityDiff): string {\n  if (diff.ok) return 'toolbelt parity: the program is the manifest'\n  const lines = ['toolbelt parity FAILED — the program and the manifest disagree:']\n  if (diff.missingFromProgram.length > 0) {\n    lines.push(`  missing from the program (in the manifest, NOT served): ${diff.missingFromProgram.join(', ')}`)\n  }\n  if (diff.unknownToManifest.length > 0) {\n    lines.push(`  unknown to the manifest (served, NOT authored): ${diff.unknownToManifest.join(', ')}`)\n  }\n  for (const drift of diff.descriptionDrift) {\n    lines.push(`  description drift on \"${drift.name}\":`)\n    lines.push(`    manifest: ${JSON.stringify(drift.manifest)}`)\n    lines.push(`    program:  ${JSON.stringify(drift.program)}`)\n  }\n  for (const drift of diff.schemaDrift) {\n    lines.push(`  input-schema drift on \"${drift.name}\":`)\n    lines.push(`    manifest: ${stableStringify(drift.manifest)}`)\n    lines.push(`    program:  ${stableStringify(drift.program)}`)\n  }\n  for (const drift of diff.annotationDrift) {\n    lines.push(`  annotation drift on \"${drift.name}\":`)\n    lines.push(`    manifest: ${stableStringify(drift.manifest)}`)\n    lines.push(`    program:  ${stableStringify(drift.program)}`)\n  }\n  lines.push('  Fix the ONE manifest (or the generator that derives the program from it) — never patch a second list.')\n  return lines.join('\\n')\n}\n\n/** Thrown by {@link assertToolbeltParity} with the full formatted diff. */\nexport class ToolbeltParityError extends Error {\n  readonly diff: ToolbeltParityDiff\n  constructor(diff: ToolbeltParityDiff) {\n    super(formatToolbeltParityDiff(diff))\n    this.name = 'ToolbeltParityError'\n    this.diff = diff\n  }\n}\n\n/** Assert parity: same names, byte-identical descriptions, structurally equal\n *  schemas and annotations. Throws {@link ToolbeltParityError} with every\n *  disagreement named — a red build, not a production silence. */\nexport function assertToolbeltParity(\n  manifest: readonly ToolbeltManifestTool[],\n  listed: readonly ProbedTool[],\n): void {\n  const diff = toolbeltParityDiff(manifest, listed)\n  if (!diff.ok) throw new ToolbeltParityError(diff)\n}\n"],"mappings":"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","names":[]}

package/dist/web-react/index.js

@@ -143,7 +143,7 @@ import {
   withoutRecordGridCreated,
   withoutRecordGridRemoved,
   withoutRecordGridUpdate
-} from "../chunk-6ZUVYAKB.js";
+} from "../chunk-6O2NQ7WD.js";
 import {
   SessionHistoryPanel,
   formatSessionTimestamp,
@@ -155,20 +155,6 @@ import {
   MENTION_PILL_CLASS
 } from "../chunk-3HUFJ5LO.js";
 import "../chunk-FBVLEGEG.js";
-import {
-  WorkspaceInitial,
-  WorkspaceSwitcher
-} from "../chunk-UDLA3NGY.js";
-import "../chunk-A2GG4D4A.js";
-import {
-  tabTerminalConnectionId,
-  useSandboxTerminalConnection
-} from "../chunk-E4AY62T2.js";
-import {
-  AGENT_PROFILE_EDITOR_SECTIONS,
-  AgentProfileEditor,
-  AgentProfileRegistryError
-} from "../chunk-3RHAF2P5.js";
 import {
   EvidenceLineageTable,
   ExceptionList,
@@ -182,9 +168,6 @@ import {
   workProductStatusLabel,
   workProductStatusTone
 } from "../chunk-Y6PRDUFJ.js";
-import {
-  parseReviewQueueItem
-} from "../chunk-GEYACSFW.js";
 import {
   ChatComposer,
   ComposerModeControls,
@@ -199,7 +182,21 @@ import {
   useDictation
 } from "../chunk-BBHVV37T.js";
 import "../chunk-L7MB2LLM.js";
+import {
+  WorkspaceInitial,
+  WorkspaceSwitcher
+} from "../chunk-UDLA3NGY.js";
+import "../chunk-A2GG4D4A.js";
+import {
+  tabTerminalConnectionId,
+  useSandboxTerminalConnection
+} from "../chunk-E4AY62T2.js";
 import "../chunk-SJWIZT7B.js";
+import {
+  AGENT_PROFILE_EDITOR_SECTIONS,
+  AgentProfileEditor,
+  AgentProfileRegistryError
+} from "../chunk-3RHAF2P5.js";
 import {
   AgentSessionControls,
   AgentSettingsPopover,
@@ -230,13 +227,16 @@ import {
   usePopover
 } from "../chunk-TJ4DYKF2.js";
 import {
-  ProviderLogo
-} from "../chunk-RASGKEAL.js";
-import "../chunk-LN5RBVGP.js";
+  parseReviewQueueItem
+} from "../chunk-GEYACSFW.js";
 import {
   ReviewFeedbackForm
 } from "../chunk-ATQQCG4I.js";
 import "../chunk-WSEXFTN4.js";
+import {
+  ProviderLogo
+} from "../chunk-RASGKEAL.js";
+import "../chunk-LN5RBVGP.js";
 import "../chunk-FQYAJYPW.js";
 import {
   ATTACHMENT_ACCEPT
@@ -252,8 +252,7 @@ import {
   isChatAttachmentPart,
   mentionInputToPart,
   mentionPartsFromMessageParts
-} from "../chunk-YR6TZ777.js";
-import "../chunk-ZVEEWGDK.js";
+} from "../chunk-TNWDYAFX.js";
 import {
   DISPATCH_MAX_MEDIA_PARTS,
   DISPATCH_MAX_PARTS,
@@ -277,11 +276,11 @@ import {
   mentionKindForPath,
   settleTurnResponse
 } from "../chunk-YHRWZZJN.js";
+import "../chunk-ZVEEWGDK.js";
 import "../chunk-TXD5HXLE.js";
 import {
   attachmentPartKey
-} from "../chunk-XNKLQG26.js";
-import "../chunk-LQYIBL3G.js";
+} from "../chunk-ZGUXI5SI.js";
 import {
   INTERACTION_CANCEL_EVENT,
   INTERACTION_EVENT,
@@ -307,6 +306,7 @@ import {
   questionInteractionContentSignature,
   stampInteractionAnswers
 } from "../chunk-6VQCFJWP.js";
+import "../chunk-LQYIBL3G.js";
 export {
   AGENT_PROFILE_EDITOR_SECTIONS,
   ATTACHMENT_ACCEPT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-app",
-  "version": "0.60.181",
+  "version": "0.60.183",
   "packageManager": "pnpm@11.24.0",
   "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
   "keywords": [
@@ -124,11 +124,21 @@
       "import": "./dist/skills/index.js",
       "default": "./dist/skills/index.js"
     },
+    "./skills/marketplace-drizzle": {
+      "types": "./dist/skills/marketplace-drizzle.d.ts",
+      "import": "./dist/skills/marketplace-drizzle.js",
+      "default": "./dist/skills/marketplace-drizzle.js"
+    },
     "./skills-placement": {
       "types": "./dist/skills-placement/index.d.ts",
       "import": "./dist/skills-placement/index.js",
       "default": "./dist/skills-placement/index.js"
     },
+    "./toolbelt": {
+      "types": "./dist/toolbelt/index.d.ts",
+      "import": "./dist/toolbelt/index.js",
+      "default": "./dist/toolbelt/index.js"
+    },
     "./profile": {
       "types": "./dist/profile/index.d.ts",
       "import": "./dist/profile/index.js",