@darkiceinteractive/mcp-conductor 2.0.0-alpha.1 → 3.0.0-beta.2

package/dist/registry/snapshot.js

@@ -0,0 +1,71 @@
+/**
+ * Disk persistence for the tool catalog.
+ *
+ * Snapshot format (JSON):
+ * {
+ *   "version": "1",
+ *   "savedAt": 1714816000000,   // epoch ms
+ *   "catalog": [ ...ToolDefinition[] ]
+ * }
+ *
+ * On load, if the `version` field is missing or does not match SNAPSHOT_VERSION,
+ * the snapshot is rejected and the caller must fall back to a live refresh.
+ *
+ * @module registry/snapshot
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/** Bump this when the ToolDefinition shape changes in a breaking way. */
+export const SNAPSHOT_VERSION = '1';
+/**
+ * Persist `catalog` to `path` as a formatted JSON file.
+ * Creates intermediate directories if needed.
+ * Throws on I/O error — callers should handle gracefully.
+ */
+export async function saveSnapshot(path, catalog) {
+    await mkdir(dirname(path), { recursive: true });
+    const file = {
+        version: SNAPSHOT_VERSION,
+        savedAt: Date.now(),
+        catalog,
+    };
+    await writeFile(path, JSON.stringify(file, null, 2), 'utf8');
+}
+/**
+ * Load a previously saved snapshot from `path`.
+ *
+ * Returns the catalog if the file exists and the version matches.
+ * Returns `null` if:
+ * - The file does not exist
+ * - The file is not valid JSON
+ * - The version field is missing or does not match SNAPSHOT_VERSION
+ *
+ * Never throws — callers fall back to a live refresh on null.
+ */
+export async function loadSnapshot(path) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch {
+        // File not found or not readable — expected on first run.
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !('version' in parsed) ||
+        parsed.version !== SNAPSHOT_VERSION ||
+        !Array.isArray(parsed.catalog)) {
+        // Version mismatch or malformed — force a live refresh.
+        return null;
+    }
+    return parsed.catalog;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/registry/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/registry/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAQpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAyB;IACxE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAiB;QACzB,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,OAAO;KACR,CAAC;IAEF,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC;QACrB,MAAuB,CAAC,OAAO,KAAK,gBAAgB;QACrD,CAAC,KAAK,CAAC,OAAO,CAAE,MAAuB,CAAC,OAAO,CAAC,EAChD,CAAC;QACD,wDAAwD;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAQ,MAAuB,CAAC,OAAO,CAAC;AAC1C,CAAC"}

package/dist/registry/typegen.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Type generation — converts the tool registry catalog into TypeScript
+ * declaration files for sandbox preload.
+ *
+ * Output layout (written to `typesDir`):
+ *   <server>.d.ts         — per-server namespace with Input/Output interfaces
+ *   <server>.routing.json — per-tool routing decisions for X1 adapter (Agent H)
+ *   _index.d.ts           — combined ambient `declare global { namespace mcp.tools }` block
+ *
+ * Plan amendments (consolidated plan §3 Part B):
+ *   1. Emit `@example` JSDoc blocks from `ToolDefinition.examples[]`
+ *   2. Write `<server>.routing.json` capturing per-tool routing decisions
+ *      so Agent H (X1 passthrough adapter) can read it without re-parsing types
+ *
+ * @module registry/typegen
+ */
+import type { ToolDefinition } from './index.js';
+export interface RoutingManifest {
+    /** Server name */
+    server: string;
+    /** Epoch ms when this manifest was generated */
+    generatedAt: number;
+    /** Per-tool routing decisions (defaults to execute_code when unset) */
+    tools: Record<string, 'passthrough' | 'execute_code' | 'hidden'>;
+}
+/**
+ * Generate the TypeScript declaration string for a single server's tools.
+ * Returns a string suitable for writing to `<server>.d.ts`.
+ */
+export declare function generateServerTypes(serverName: string, tools: ToolDefinition[]): Promise<string>;
+/**
+ * Generate the combined `_index.d.ts` that exposes `mcp.tools` as a global
+ * ambient namespace, referencing each per-server namespace.
+ */
+export declare function generateIndexTypes(serverNames: string[]): string;
+/**
+ * Build the routing manifest for a server (plan amendment #2).
+ * Defaults to `execute_code` when `tool.routing` is not set, preserving
+ * current behaviour for all existing tools.
+ */
+export declare function buildRoutingManifest(serverName: string, tools: ToolDefinition[]): RoutingManifest;
+/**
+ * Write all type and routing files to `typesDir`.
+ * Creates the directory if it does not exist.
+ * Returns the list of written file paths.
+ */
+export declare function writeTypesToDir(typesDir: string, toolsByServer: Map<string, ToolDefinition[]>): Promise<string[]>;
+//# sourceMappingURL=typegen.d.ts.map

package/dist/registry/typegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.d.ts","sourceRoot":"","sources":["../../src/registry/typegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,YAAY,CAAC;AAM7D,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,GAAG,QAAQ,CAAC,CAAC;CAClE;AAuED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,CAsDjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA4BhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,cAAc,EAAE,GACtB,eAAe,CAYjB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,GAC3C,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB"}

package/dist/registry/typegen.js

@@ -0,0 +1,200 @@
+/**
+ * Type generation — converts the tool registry catalog into TypeScript
+ * declaration files for sandbox preload.
+ *
+ * Output layout (written to `typesDir`):
+ *   <server>.d.ts         — per-server namespace with Input/Output interfaces
+ *   <server>.routing.json — per-tool routing decisions for X1 adapter (Agent H)
+ *   _index.d.ts           — combined ambient `declare global { namespace mcp.tools }` block
+ *
+ * Plan amendments (consolidated plan §3 Part B):
+ *   1. Emit `@example` JSDoc blocks from `ToolDefinition.examples[]`
+ *   2. Write `<server>.routing.json` capturing per-tool routing decisions
+ *      so Agent H (X1 passthrough adapter) can read it without re-parsing types
+ *
+ * @module registry/typegen
+ */
+import { compile } from 'json-schema-to-typescript';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/** Sanitise a name so it can be used as a TypeScript identifier. */
+function toIdentifier(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, '_');
+}
+/** Escape text for safe embedding inside a JSDoc comment block. */
+function escapeJsDoc(text) {
+    return text.replace(/\*\//g, '* /');
+}
+/**
+ * Build a JSDoc comment block from a description and optional examples array.
+ * Follows the Anthropic Tool Use Examples pattern (plan amendment).
+ */
+function buildJsDoc(description, examples) {
+    const lines = ['/**'];
+    if (description) {
+        for (const line of description.split('\n')) {
+            lines.push(` * ${escapeJsDoc(line)}`);
+        }
+    }
+    if (examples && examples.length > 0) {
+        lines.push(' *');
+        for (const ex of examples) {
+            if (ex.description) {
+                lines.push(` * @example ${escapeJsDoc(ex.description)}`);
+            }
+            else {
+                lines.push(' * @example');
+            }
+            lines.push(` * args: ${escapeJsDoc(JSON.stringify(ex.args))}`);
+            lines.push(` * result: ${escapeJsDoc(JSON.stringify(ex.result))}`);
+        }
+    }
+    lines.push(' */');
+    return lines.join('\n');
+}
+/**
+ * Attempt to compile a JSON Schema to a TypeScript type string via
+ * json-schema-to-typescript.  On failure (e.g. recursive schema) falls
+ * back to `type <Name> = unknown` — never crashes the generation run.
+ * Per the kickoff doc: "if json-schema-to-typescript chokes on a recursive
+ * schema, accept whatever it emits and move on".
+ */
+async function schemaToTs(schema, name) {
+    try {
+        const result = await compile(schema, name, {
+            bannerComment: '',
+            unknownAny: false,
+            strictIndexSignatures: false,
+        });
+        return result.trim();
+    }
+    catch {
+        // Recursive or malformed schema — safe fallback
+        return `export type ${toIdentifier(name)} = unknown; // schema could not be compiled`;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Generate the TypeScript declaration string for a single server's tools.
+ * Returns a string suitable for writing to `<server>.d.ts`.
+ */
+export async function generateServerTypes(serverName, tools) {
+    const id = toIdentifier(serverName);
+    const lines = [
+        '// Auto-generated by MCP Conductor. Do not edit.',
+        `// Source: ${serverName} tool catalog`,
+        '',
+        `export namespace ${id} {`,
+    ];
+    for (const tool of tools) {
+        const toolId = toIdentifier(tool.name);
+        // Input interface
+        const inputSchema = tool.inputSchema && Object.keys(tool.inputSchema).length > 0
+            ? tool.inputSchema
+            : { type: 'object' };
+        const inputTypeName = `${toolId}_Input`;
+        const inputTs = await schemaToTs(inputSchema, inputTypeName);
+        lines.push('');
+        // Emit JSDoc with @example blocks (plan amendment #1)
+        lines.push(buildJsDoc(tool.description, tool.examples)
+            .split('\n')
+            .map((l) => `  ${l}`)
+            .join('\n'));
+        lines.push(inputTs
+            .split('\n')
+            .map((l) => `  ${l}`)
+            .join('\n'));
+        // Output interface (optional)
+        if (tool.outputSchema && Object.keys(tool.outputSchema).length > 0) {
+            const outputTypeName = `${toolId}_Output`;
+            const outputTs = await schemaToTs(tool.outputSchema, outputTypeName);
+            lines.push('');
+            lines.push(outputTs
+                .split('\n')
+                .map((l) => `  ${l}`)
+                .join('\n'));
+        }
+    }
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Generate the combined `_index.d.ts` that exposes `mcp.tools` as a global
+ * ambient namespace, referencing each per-server namespace.
+ */
+export function generateIndexTypes(serverNames) {
+    const lines = ['// Auto-generated by MCP Conductor. Do not edit.', ''];
+    for (const name of serverNames) {
+        const id = toIdentifier(name);
+        lines.push(`import type { ${id} } from './${name}.js';`);
+    }
+    lines.push('');
+    lines.push('declare global {');
+    lines.push('  namespace mcp {');
+    lines.push('    namespace tools {');
+    for (const name of serverNames) {
+        const id = toIdentifier(name);
+        lines.push(`      const ${id}: {`);
+        lines.push(`        [tool: string]: (args: unknown) => Promise<unknown>;`);
+        lines.push(`      } & typeof import('./${name}.js').${id};`);
+    }
+    lines.push('    }');
+    lines.push('  }');
+    lines.push('}');
+    lines.push('');
+    lines.push('export {};');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Build the routing manifest for a server (plan amendment #2).
+ * Defaults to `execute_code` when `tool.routing` is not set, preserving
+ * current behaviour for all existing tools.
+ */
+export function buildRoutingManifest(serverName, tools) {
+    const toolRoutes = {};
+    for (const tool of tools) {
+        toolRoutes[tool.name] = tool.routing ?? 'execute_code';
+    }
+    return {
+        server: serverName,
+        generatedAt: Date.now(),
+        tools: toolRoutes,
+    };
+}
+/**
+ * Write all type and routing files to `typesDir`.
+ * Creates the directory if it does not exist.
+ * Returns the list of written file paths.
+ */
+export async function writeTypesToDir(typesDir, toolsByServer) {
+    await mkdir(typesDir, { recursive: true });
+    const written = [];
+    const serverNames = [];
+    for (const [serverName, tools] of toolsByServer) {
+        serverNames.push(serverName);
+        // <server>.d.ts
+        const dtsContent = await generateServerTypes(serverName, tools);
+        const dtsPath = join(typesDir, `${serverName}.d.ts`);
+        await writeFile(dtsPath, dtsContent, 'utf8');
+        written.push(dtsPath);
+        // <server>.routing.json  (plan amendment for X1 adapter — Agent H)
+        const manifest = buildRoutingManifest(serverName, tools);
+        const routingPath = join(typesDir, `${serverName}.routing.json`);
+        await writeFile(routingPath, JSON.stringify(manifest, null, 2), 'utf8');
+        written.push(routingPath);
+    }
+    // _index.d.ts
+    const indexContent = generateIndexTypes(serverNames);
+    const indexPath = join(typesDir, '_index.d.ts');
+    await writeFile(indexPath, indexContent, 'utf8');
+    written.push(indexPath);
+    return written;
+}
+//# sourceMappingURL=typegen.js.map

package/dist/registry/typegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.js","sourceRoot":"","sources":["../../src/registry/typegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAgBjC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,oEAAoE;AACpE,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AACnE,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,WAAmB,EAAE,QAAqC;IAC5E,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,UAAU,CAAC,MAAkB,EAAE,IAAY;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAgB,EAAE,IAAI,EAAE;YACnD,aAAa,EAAE,EAAE;YACjB,UAAU,EAAE,KAAK;YACjB,qBAAqB,EAAE,KAAK;SAC7B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;QAChD,OAAO,eAAe,YAAY,CAAC,IAAI,CAAC,6CAA6C,CAAC;IACxF,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,KAAuB;IAEvB,MAAM,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,KAAK,GAAa;QACtB,kDAAkD;QAClD,cAAc,UAAU,eAAe;QACvC,EAAE;QACF,oBAAoB,EAAE,IAAI;KAC3B,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,kBAAkB;QAClB,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1D,CAAC,CAAC,IAAI,CAAC,WAAW;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAEzB,MAAM,aAAa,GAAG,GAAG,MAAM,QAAQ,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAE7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,sDAAsD;QACtD,KAAK,CAAC,IAAI,CACR,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;aACxC,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACF,KAAK,CAAC,IAAI,CACR,OAAO;aACJ,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QAEF,8BAA8B;QAC9B,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,cAAc,GAAG,GAAG,MAAM,SAAS,CAAC;YAC1C,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;YACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CACR,QAAQ;iBACL,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;iBACpB,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAqB;IACtD,MAAM,KAAK,GAAa,CAAC,kDAAkD,EAAE,EAAE,CAAC,CAAC;IAEjF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,cAAc,IAAI,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,8BAA8B,IAAI,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,KAAuB;IAEvB,MAAM,UAAU,GAA8D,EAAE,CAAC;IAEjF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IACzD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,KAAK,EAAE,UAAU;KAClB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,aAA4C;IAE5C,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;QAChD,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE7B,gBAAgB;QAChB,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;QACrD,MAAM,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtB,mEAAmE;QACnE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,UAAU,eAAe,CAAC,CAAC;QACjE,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc;IACd,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/registry/validator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Input validation using ajv (JSON Schema draft 7).
+ * Validates tool call arguments before they hit the backend — eliminating
+ * unnecessary round-trips for bad params.
+ *
+ * Performance target: <1ms p99 for typical schemas (ajv compiles schemas
+ * once and caches the resulting validate function).
+ *
+ * @module registry/validator
+ */
+import type { JsonSchema, ToolDefinition, ValidationResult } from './index.js';
+/**
+ * Validate `args` against a raw JSON Schema.
+ * Returns a `ValidationResult` — never throws.
+ */
+export declare function validateAgainstSchema(schema: JsonSchema, args: unknown): ValidationResult;
+/**
+ * Validate `args` against a specific tool's inputSchema.
+ * Returns `{ valid: true }` when the tool is unknown (fail-open — the
+ * backend will surface its own error) or when no schema is present.
+ */
+export declare function validateToolInput(tool: ToolDefinition | null | undefined, args: unknown): ValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/registry/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/registry/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAM/E;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ,gBAAgB,CAalB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACvC,IAAI,EAAE,OAAO,GACZ,gBAAgB,CAYlB"}

package/dist/registry/validator.js

@@ -0,0 +1,50 @@
+/**
+ * Input validation using ajv (JSON Schema draft 7).
+ * Validates tool call arguments before they hit the backend — eliminating
+ * unnecessary round-trips for bad params.
+ *
+ * Performance target: <1ms p99 for typical schemas (ajv compiles schemas
+ * once and caches the resulting validate function).
+ *
+ * @module registry/validator
+ */
+// ajv v8 ships a named export AND a default export that both point to the
+// class. TypeScript's ESM interop with CJS packages sometimes resolves the
+// module-level value as the namespace rather than the default; importing the
+// named export is the most portable form.
+import { Ajv } from 'ajv';
+// One shared Ajv instance — compiled validators are cached internally.
+// allErrors:true collects all violations rather than stopping at the first.
+const ajv = new Ajv({ allErrors: true, strict: false });
+/**
+ * Validate `args` against a raw JSON Schema.
+ * Returns a `ValidationResult` — never throws.
+ */
+export function validateAgainstSchema(schema, args) {
+    const valid = ajv.validate(schema, args);
+    if (valid) {
+        return { valid: true };
+    }
+    const errors = (ajv.errors ?? []).map((e) => ({
+        path: e.instancePath || '/',
+        message: e.message ?? 'validation error',
+    }));
+    return { valid: false, errors };
+}
+/**
+ * Validate `args` against a specific tool's inputSchema.
+ * Returns `{ valid: true }` when the tool is unknown (fail-open — the
+ * backend will surface its own error) or when no schema is present.
+ */
+export function validateToolInput(tool, args) {
+    if (!tool) {
+        // Unknown tool — fail open; backend handles the error.
+        return { valid: true };
+    }
+    if (!tool.inputSchema || Object.keys(tool.inputSchema).length === 0) {
+        // No schema to validate against — treat as valid.
+        return { valid: true };
+    }
+    return validateAgainstSchema(tool.inputSchema, args);
+}
+//# sourceMappingURL=validator.js.map

package/dist/registry/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/registry/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,0CAA0C;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAI1B,uEAAuE;AACvE,4EAA4E;AAC5E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB,EAClB,IAAa;IAEb,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAgB,EAAE,IAAI,CAAC,CAAC;IAEnD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,CAAC,YAAY,IAAI,GAAG;QAC3B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,kBAAkB;KACzC,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuC,EACvC,IAAa;IAEb,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,uDAAuD;QACvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,kDAAkD;QAClD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/reliability/breaker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Circuit breaker — closed/open/half-open state machine with rolling failure window.
+ *
+ * Tracks success/failure ratio within a configurable time window. When the ratio
+ * drops below the threshold AND the minimum call count is met, the circuit trips
+ * OPEN. After halfOpenProbeIntervalMs the circuit moves to HALF-OPEN allowing
+ * exactly one probe call. A successful probe closes the circuit; a failed probe
+ * re-opens it.
+ */
+import { CircuitState, type ReliabilityProfile } from './profile.js';
+export interface BreakerStats {
+    state: CircuitState;
+    totalCalls: number;
+    successes: number;
+    failures: number;
+    /** Timestamp when circuit last tripped OPEN (ms since epoch), if ever */
+    lastTrip?: number;
+}
+export declare class CircuitBreaker {
+    private state;
+    private window;
+    private lastTrip?;
+    /** When in HALF-OPEN, true if a probe is already in flight */
+    private probeInFlight;
+    private readonly threshold;
+    private readonly windowMs;
+    private readonly minCalls;
+    private readonly halfOpenIntervalMs;
+    private readonly server;
+    constructor(server: string, profile?: Partial<ReliabilityProfile>);
+    /** Current circuit state. */
+    getState(): CircuitState;
+    /**
+     * Check whether a call should be allowed through.
+     * Throws CircuitOpenError if the circuit is OPEN (fast-fail).
+     * In HALF-OPEN allows exactly one concurrent probe call.
+     */
+    allowCall(tool: string): void;
+    /**
+     * Record a successful call outcome.
+     * If in HALF-OPEN, close the circuit.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed call outcome.
+     * Re-evaluates the failure ratio; may trip or re-trip the circuit.
+     */
+    recordFailure(): void;
+    /** Reset the circuit to CLOSED, clearing the window. */
+    reset(): void;
+    /** Snapshot of current statistics (window-based). */
+    getStats(): BreakerStats;
+    private _pruneWindow;
+    private _maybeTrip;
+    private _maybeTransitionToHalfOpen;
+}
+//# sourceMappingURL=breaker.d.ts.map

package/dist/reliability/breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaker.d.ts","sourceRoot":"","sources":["../../src/reliability/breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAmB,MAAM,cAAc,CAAC;AAStF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,8DAA8D;IAC9D,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM;IASrE,6BAA6B;IAC7B,QAAQ,IAAI,YAAY;IAKxB;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAgB7B;;;OAGG;IACH,aAAa,IAAI,IAAI;IAWrB;;;OAGG;IACH,aAAa,IAAI,IAAI;IAiBrB,wDAAwD;IACxD,KAAK,IAAI,IAAI;IAOb,qDAAqD;IACrD,QAAQ,IAAI,YAAY;IAexB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,0BAA0B;CASnC"}

package/dist/reliability/breaker.js

@@ -0,0 +1,130 @@
+/**
+ * Circuit breaker — closed/open/half-open state machine with rolling failure window.
+ *
+ * Tracks success/failure ratio within a configurable time window. When the ratio
+ * drops below the threshold AND the minimum call count is met, the circuit trips
+ * OPEN. After halfOpenProbeIntervalMs the circuit moves to HALF-OPEN allowing
+ * exactly one probe call. A successful probe closes the circuit; a failed probe
+ * re-opens it.
+ */
+import { CircuitOpenError } from './errors.js';
+import { DEFAULT_PROFILE } from './profile.js';
+export class CircuitBreaker {
+    state = 'closed';
+    window = [];
+    lastTrip;
+    /** When in HALF-OPEN, true if a probe is already in flight */
+    probeInFlight = false;
+    threshold;
+    windowMs;
+    minCalls;
+    halfOpenIntervalMs;
+    server;
+    constructor(server, profile = {}) {
+        this.server = server;
+        this.threshold = profile.circuitBreakerThreshold ?? DEFAULT_PROFILE.circuitBreakerThreshold;
+        this.windowMs = profile.circuitBreakerWindowMs ?? DEFAULT_PROFILE.circuitBreakerWindowMs;
+        this.minCalls = profile.circuitBreakerMinCalls ?? DEFAULT_PROFILE.circuitBreakerMinCalls;
+        this.halfOpenIntervalMs =
+            profile.halfOpenProbeIntervalMs ?? DEFAULT_PROFILE.halfOpenProbeIntervalMs;
+    }
+    /** Current circuit state. */
+    getState() {
+        this._maybeTransitionToHalfOpen();
+        return this.state;
+    }
+    /**
+     * Check whether a call should be allowed through.
+     * Throws CircuitOpenError if the circuit is OPEN (fast-fail).
+     * In HALF-OPEN allows exactly one concurrent probe call.
+     */
+    allowCall(tool) {
+        this._maybeTransitionToHalfOpen();
+        if (this.state === 'open') {
+            throw new CircuitOpenError(this.server, tool);
+        }
+        if (this.state === 'half-open') {
+            if (this.probeInFlight) {
+                // Another probe is already in flight — fail fast for subsequent calls
+                throw new CircuitOpenError(this.server, tool);
+            }
+            this.probeInFlight = true;
+        }
+    }
+    /**
+     * Record a successful call outcome.
+     * If in HALF-OPEN, close the circuit.
+     */
+    recordSuccess() {
+        this._pruneWindow();
+        this.window.push({ ts: Date.now(), success: true });
+        if (this.state === 'half-open') {
+            this.probeInFlight = false;
+            this.state = 'closed';
+            this.window = []; // reset window on recovery
+        }
+    }
+    /**
+     * Record a failed call outcome.
+     * Re-evaluates the failure ratio; may trip or re-trip the circuit.
+     */
+    recordFailure() {
+        this._pruneWindow();
+        this.window.push({ ts: Date.now(), success: false });
+        if (this.state === 'half-open') {
+            // Probe failed — return to OPEN
+            this.probeInFlight = false;
+            this.state = 'open';
+            this.lastTrip = Date.now();
+            return;
+        }
+        if (this.state === 'closed') {
+            this._maybeTrip();
+        }
+    }
+    /** Reset the circuit to CLOSED, clearing the window. */
+    reset() {
+        this.state = 'closed';
+        this.window = [];
+        this.lastTrip = undefined;
+        this.probeInFlight = false;
+    }
+    /** Snapshot of current statistics (window-based). */
+    getStats() {
+        this._pruneWindow();
+        const successes = this.window.filter((r) => r.success).length;
+        const failures = this.window.filter((r) => !r.success).length;
+        return {
+            state: this.getState(),
+            totalCalls: this.window.length,
+            successes,
+            failures,
+            lastTrip: this.lastTrip,
+        };
+    }
+    // ─── Private helpers ────────────────────────────────────────────────────────
+    _pruneWindow() {
+        const cutoff = Date.now() - this.windowMs;
+        this.window = this.window.filter((r) => r.ts >= cutoff);
+    }
+    _maybeTrip() {
+        if (this.window.length < this.minCalls)
+            return;
+        const failures = this.window.filter((r) => !r.success).length;
+        const ratio = failures / this.window.length;
+        if (ratio > this.threshold) {
+            this.state = 'open';
+            this.lastTrip = Date.now();
+        }
+    }
+    _maybeTransitionToHalfOpen() {
+        if (this.state === 'open' && this.lastTrip !== undefined) {
+            const elapsed = Date.now() - this.lastTrip;
+            if (elapsed >= this.halfOpenIntervalMs) {
+                this.state = 'half-open';
+                this.probeInFlight = false;
+            }
+        }
+    }
+}
+//# sourceMappingURL=breaker.js.map

package/dist/reliability/breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaker.js","sourceRoot":"","sources":["../../src/reliability/breaker.ts"],"names":[],"mappings":"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"}