@a5c-ai/tool-mux 5.0.1-staging.016f0b0e8119

package/dist/__tests__/registry.test.js

@@ -0,0 +1,162 @@
+import { describe, expect, it, beforeEach } from 'vitest';
+import { ToolRegistry } from '../registry.js';
+/* -------------------------------------------------------------------------- */
+/*  Helpers                                                                   */
+/* -------------------------------------------------------------------------- */
+function makeTool(overrides = {}) {
+    return {
+        name: 'test_tool',
+        description: 'A test tool',
+        parameters: { type: 'object', properties: {} },
+        source: 'builtin',
+        ...overrides,
+    };
+}
+function makeServer(id, tools, overrides = {}) {
+    return {
+        id,
+        name: `Server ${id}`,
+        type: 'native',
+        tools,
+        ...overrides,
+    };
+}
+/* ========================================================================== */
+/*  ToolRegistry                                                              */
+/* ========================================================================== */
+describe('ToolRegistry', () => {
+    let registry;
+    beforeEach(() => {
+        registry = new ToolRegistry();
+    });
+    /* ---------------------------------------------------------------------- */
+    /*  Tool-level operations                                                  */
+    /* ---------------------------------------------------------------------- */
+    it('registers a tool and retrieves it by name', () => {
+        const tool = makeTool({ name: 'file_read' });
+        registry.register(tool);
+        const result = registry.get('file_read');
+        expect(result).toBeDefined();
+        expect(result.name).toBe('file_read');
+        expect(result.source).toBe('builtin');
+    });
+    it('registers multiple tools and lists all of them', () => {
+        registry.register(makeTool({ name: 'tool_a' }));
+        registry.register(makeTool({ name: 'tool_b' }));
+        registry.register(makeTool({ name: 'tool_c' }));
+        const all = registry.list();
+        expect(all).toHaveLength(3);
+        expect(all.map((t) => t.name).sort()).toEqual(['tool_a', 'tool_b', 'tool_c']);
+    });
+    it('registerAll registers an array of tools at once', () => {
+        registry.registerAll([
+            makeTool({ name: 'batch_a' }),
+            makeTool({ name: 'batch_b' }),
+        ]);
+        expect(registry.size).toBe(2);
+        expect(registry.has('batch_a')).toBe(true);
+        expect(registry.has('batch_b')).toBe(true);
+    });
+    it('unregisters a tool and returns true when it existed', () => {
+        registry.register(makeTool({ name: 'doomed' }));
+        expect(registry.has('doomed')).toBe(true);
+        const removed = registry.unregister('doomed');
+        expect(removed).toBe(true);
+        expect(registry.has('doomed')).toBe(false);
+        expect(registry.get('doomed')).toBeUndefined();
+    });
+    it('unregister returns false for a non-existent tool', () => {
+        expect(registry.unregister('ghost')).toBe(false);
+    });
+    it('returns undefined for an unknown tool name', () => {
+        expect(registry.get('does_not_exist')).toBeUndefined();
+    });
+    it('has() returns false for missing tools', () => {
+        expect(registry.has('missing')).toBe(false);
+    });
+    it('listByServer filters tools by server id', () => {
+        registry.register(makeTool({ name: 'mcp_a', server: 'srv-1', source: 'mcp' }));
+        registry.register(makeTool({ name: 'mcp_b', server: 'srv-1', source: 'mcp' }));
+        registry.register(makeTool({ name: 'local_a', server: 'srv-2', source: 'builtin' }));
+        registry.register(makeTool({ name: 'no_server', source: 'custom' }));
+        const srv1Tools = registry.listByServer('srv-1');
+        expect(srv1Tools).toHaveLength(2);
+        expect(srv1Tools.map((t) => t.name).sort()).toEqual(['mcp_a', 'mcp_b']);
+        const srv2Tools = registry.listByServer('srv-2');
+        expect(srv2Tools).toHaveLength(1);
+        expect(srv2Tools[0].name).toBe('local_a');
+        expect(registry.listByServer('unknown')).toHaveLength(0);
+    });
+    it('duplicate name overwrites the previous descriptor', () => {
+        registry.register(makeTool({ name: 'dup', description: 'original' }));
+        expect(registry.get('dup').description).toBe('original');
+        registry.register(makeTool({ name: 'dup', description: 'replaced' }));
+        expect(registry.get('dup').description).toBe('replaced');
+        expect(registry.size).toBe(1);
+    });
+    it('size reflects the current tool count', () => {
+        expect(registry.size).toBe(0);
+        registry.register(makeTool({ name: 'a' }));
+        expect(registry.size).toBe(1);
+        registry.register(makeTool({ name: 'b' }));
+        expect(registry.size).toBe(2);
+        registry.unregister('a');
+        expect(registry.size).toBe(1);
+    });
+    /* ---------------------------------------------------------------------- */
+    /*  Server-level operations                                                */
+    /* ---------------------------------------------------------------------- */
+    it('registerServer adds server entry and all its tools', () => {
+        const tools = [
+            makeTool({ name: 'srv_tool_a', source: 'mcp' }),
+            makeTool({ name: 'srv_tool_b', source: 'mcp' }),
+        ];
+        const server = makeServer('s1', tools);
+        registry.registerServer(server);
+        // Server is retrievable
+        expect(registry.getServer('s1')).toBeDefined();
+        expect(registry.getServer('s1').name).toBe('Server s1');
+        // All tools are registered with server association
+        expect(registry.has('srv_tool_a')).toBe(true);
+        expect(registry.has('srv_tool_b')).toBe(true);
+        expect(registry.get('srv_tool_a').server).toBe('s1');
+        expect(registry.get('srv_tool_b').server).toBe('s1');
+    });
+    it('unregisterServer removes server and all its tools by default', () => {
+        const tools = [
+            makeTool({ name: 'remove_a', source: 'mcp' }),
+            makeTool({ name: 'remove_b', source: 'mcp' }),
+        ];
+        registry.registerServer(makeServer('s2', tools));
+        expect(registry.has('remove_a')).toBe(true);
+        expect(registry.has('remove_b')).toBe(true);
+        const removed = registry.unregisterServer('s2');
+        expect(removed).toBe(true);
+        expect(registry.getServer('s2')).toBeUndefined();
+        expect(registry.has('remove_a')).toBe(false);
+        expect(registry.has('remove_b')).toBe(false);
+    });
+    it('unregisterServer with removeTools=false keeps tools', () => {
+        const tools = [makeTool({ name: 'keep_me', source: 'mcp' })];
+        registry.registerServer(makeServer('s3', tools));
+        registry.unregisterServer('s3', false);
+        expect(registry.getServer('s3')).toBeUndefined();
+        expect(registry.has('keep_me')).toBe(true);
+    });
+    it('listServers returns all registered servers', () => {
+        registry.registerServer(makeServer('a', []));
+        registry.registerServer(makeServer('b', []));
+        const servers = registry.listServers();
+        expect(servers).toHaveLength(2);
+        expect(servers.map((s) => s.id).sort()).toEqual(['a', 'b']);
+    });
+    it('clear removes all tools and servers', () => {
+        registry.register(makeTool({ name: 'solo' }));
+        registry.registerServer(makeServer('x', [makeTool({ name: 'grouped' })]));
+        registry.clear();
+        expect(registry.size).toBe(0);
+        expect(registry.list()).toHaveLength(0);
+        expect(registry.listServers()).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/__tests__/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../src/__tests__/registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,SAAS,QAAQ,CAAC,YAAqC,EAAE;IACvD,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,aAAa;QAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9C,MAAM,EAAE,SAAS;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,EAAU,EACV,KAAuB,EACvB,YAAiC,EAAE;IAEnC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,UAAU,EAAE,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,KAAK;QACL,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,QAAsB,CAAC;IAE3B,UAAU,CAAC,GAAG,EAAE;QACd,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAE5E,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7C,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAExB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAEhD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,QAAQ,CAAC,WAAW,CAAC;YACnB,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SAC9B,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/E,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/E,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACrF,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAErE,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAExE,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1C,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAE5E,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG;YACZ,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC/C,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;SAChD,CAAC;QACF,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEvC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAEhC,wBAAwB;QACxB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEzD,mDAAmD;QACnD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,KAAK,GAAG;YACZ,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YAC7C,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;SAC9C,CAAC;QACF,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAEjD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7D,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAEjD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACjD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7C,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAE7C,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9C,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1E,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEjB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/schema-translation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-translation.test.d.ts.map

package/dist/__tests__/schema-translation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-translation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-translation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schema-translation.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, it } from 'vitest';
+import { toToolDescriptor, fromToolDescriptor, translateTools, } from '../schema-translation.js';
+/* -------------------------------------------------------------------------- */
+/*  Helpers                                                                   */
+/* -------------------------------------------------------------------------- */
+function makeNormalized(overrides = {}) {
+    return {
+        name: 'test_tool',
+        description: 'A test tool',
+        parameters: { type: 'object', properties: { x: { type: 'string' } } },
+        ...overrides,
+    };
+}
+function makeDescriptor(overrides = {}) {
+    return {
+        name: 'test_tool',
+        description: 'A test tool',
+        parameters: { type: 'object', properties: { x: { type: 'string' } } },
+        source: 'builtin',
+        ...overrides,
+    };
+}
+/* ========================================================================== */
+/*  Schema Translation                                                        */
+/* ========================================================================== */
+describe('schema-translation', () => {
+    /* ---------------------------------------------------------------------- */
+    /*  toToolDescriptor                                                       */
+    /* ---------------------------------------------------------------------- */
+    describe('toToolDescriptor', () => {
+        it('creates a ToolDescriptor from a NormalizedToolDefinition', () => {
+            const normalized = makeNormalized({ name: 'my_fn', description: 'Does stuff' });
+            const descriptor = toToolDescriptor(normalized, 'mcp');
+            expect(descriptor.name).toBe('my_fn');
+            expect(descriptor.description).toBe('Does stuff');
+            expect(descriptor.source).toBe('mcp');
+            expect(descriptor.parameters).toEqual(normalized.parameters);
+        });
+        it('attaches optional server, permissions, and metadata', () => {
+            const normalized = makeNormalized();
+            const descriptor = toToolDescriptor(normalized, 'plugin', {
+                server: 'srv-1',
+                permissions: ['read', 'write'],
+                metadata: { version: 2 },
+            });
+            expect(descriptor.server).toBe('srv-1');
+            expect(descriptor.permissions).toEqual(['read', 'write']);
+            expect(descriptor.metadata).toEqual({ version: 2 });
+        });
+        it('omits optional fields when extras are not provided', () => {
+            const descriptor = toToolDescriptor(makeNormalized(), 'builtin');
+            expect(descriptor.server).toBeUndefined();
+            expect(descriptor.permissions).toBeUndefined();
+            expect(descriptor.metadata).toBeUndefined();
+        });
+    });
+    /* ---------------------------------------------------------------------- */
+    /*  fromToolDescriptor                                                     */
+    /* ---------------------------------------------------------------------- */
+    describe('fromToolDescriptor', () => {
+        it('strips lifecycle metadata and returns NormalizedToolDefinition', () => {
+            const descriptor = makeDescriptor({
+                name: 'stripped',
+                description: 'keep me',
+                server: 'srv-x',
+                permissions: ['admin'],
+                metadata: { extra: true },
+            });
+            const normalized = fromToolDescriptor(descriptor);
+            expect(normalized.name).toBe('stripped');
+            expect(normalized.description).toBe('keep me');
+            expect(normalized.parameters).toEqual(descriptor.parameters);
+            // Lifecycle fields should not be present
+            expect(normalized.source).toBeUndefined();
+            expect(normalized.server).toBeUndefined();
+            expect(normalized.permissions).toBeUndefined();
+        });
+        it('omits description when not present on descriptor', () => {
+            const descriptor = makeDescriptor({ description: undefined });
+            const normalized = fromToolDescriptor(descriptor);
+            expect(normalized).not.toHaveProperty('description');
+        });
+        it('omits parameters when not present on descriptor', () => {
+            const descriptor = makeDescriptor({ parameters: undefined });
+            const normalized = fromToolDescriptor(descriptor);
+            expect(normalized).not.toHaveProperty('parameters');
+        });
+    });
+    /* ---------------------------------------------------------------------- */
+    /*  Round-trip                                                             */
+    /* ---------------------------------------------------------------------- */
+    describe('round-trip', () => {
+        it('toToolDescriptor -> fromToolDescriptor preserves core data', () => {
+            const original = makeNormalized({
+                name: 'round_trip',
+                description: 'survives the trip',
+                parameters: { type: 'object', properties: { q: { type: 'number' } } },
+            });
+            const descriptor = toToolDescriptor(original, 'custom', { server: 'srv' });
+            const backToNormalized = fromToolDescriptor(descriptor);
+            expect(backToNormalized.name).toBe(original.name);
+            expect(backToNormalized.description).toBe(original.description);
+            expect(backToNormalized.parameters).toEqual(original.parameters);
+        });
+    });
+    /* ---------------------------------------------------------------------- */
+    /*  translateTools                                                         */
+    /* ---------------------------------------------------------------------- */
+    describe('translateTools', () => {
+        it('produces an array for a valid target format', () => {
+            const descriptors = [
+                makeDescriptor({ name: 'tool_a' }),
+                makeDescriptor({ name: 'tool_b' }),
+            ];
+            const result = translateTools(descriptors, 'anthropic');
+            expect(Array.isArray(result)).toBe(true);
+            expect(result.length).toBeGreaterThan(0);
+        });
+        it('returns empty array for target format "none"', () => {
+            const descriptors = [makeDescriptor({ name: 'tool_a' })];
+            const result = translateTools(descriptors, 'none');
+            expect(result).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=schema-translation.test.js.map

package/dist/__tests__/schema-translation.test.js.map

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

package/dist/dispatch.d.ts

@@ -0,0 +1,40 @@
+import type { ToolCallContext, ToolCallResult, ToolDescriptor, ToolDispatchPolicy, ToolDispatchRule } from './types.js';
+import type { ToolHookBridge } from './hooks.js';
+import type { ToolRegistry } from './registry.js';
+export type ToolExecutor = (tool: ToolDescriptor, context: ToolCallContext) => Promise<unknown>;
+export interface ToolDispatcherOptions {
+    registry: ToolRegistry;
+    policy?: ToolDispatchPolicy;
+    hooks?: ToolHookBridge;
+}
+/**
+ * Resolves a tool call to the correct server using policy rules,
+ * runs before/after hooks, and delegates actual execution to a
+ * caller-supplied executor.
+ */
+export declare class ToolDispatcher {
+    private readonly registry;
+    private readonly policy;
+    private readonly hooks;
+    constructor(options: ToolDispatcherOptions);
+    /** Set or replace the full dispatch policy. */
+    setPolicy(policy: ToolDispatchPolicy): void;
+    /** Add a single dispatch rule. */
+    addRule(rule: ToolDispatchRule): void;
+    /**
+     * Walk the policy rules (already sorted by priority) and return the
+     * first matching server id, falling back to the tool's own server
+     * field, then the policy default.
+     */
+    resolveServer(toolName: string): string | undefined;
+    /**
+     * Full dispatch lifecycle:
+     *   1. Resolve descriptor + server
+     *   2. beforeToolUse hook
+     *   3. Execute via supplied executor
+     *   4. afterToolUse hook
+     *   5. Return result
+     */
+    dispatch(context: ToolCallContext, executor: ToolExecutor): Promise<ToolCallResult>;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAyBlD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAEvC,OAAO,EAAE,qBAAqB;IAU1C,+CAA+C;IAC/C,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAK3C,kCAAkC;IAClC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAUrC;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBnD;;;;;;;OAOG;IACG,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC;CA2C3B"}

package/dist/dispatch.js

@@ -0,0 +1,117 @@
+/* ------------------------------------------------------------------ */
+/*  Minimal glob matcher (no external deps)                            */
+/* ------------------------------------------------------------------ */
+/**
+ * Convert a simple glob pattern (supporting `*` and `?`) into a RegExp.
+ *
+ * This intentionally does NOT support `**`, brace expansion, or
+ * character classes — tool names are flat identifiers, so `*` for
+ * "any chars" and `?` for "single char" is sufficient.
+ */
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Resolves a tool call to the correct server using policy rules,
+ * runs before/after hooks, and delegates actual execution to a
+ * caller-supplied executor.
+ */
+export class ToolDispatcher {
+    registry;
+    policy;
+    hooks;
+    constructor(options) {
+        this.registry = options.registry;
+        this.policy = options.policy ?? { rules: [] };
+        this.hooks = options.hooks;
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Policy helpers                                                   */
+    /* ---------------------------------------------------------------- */
+    /** Set or replace the full dispatch policy. */
+    setPolicy(policy) {
+        this.policy.rules = policy.rules;
+        this.policy.defaultServer = policy.defaultServer;
+    }
+    /** Add a single dispatch rule. */
+    addRule(rule) {
+        this.policy.rules.push(rule);
+        // Keep rules sorted by descending priority so resolution is stable.
+        this.policy.rules.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Resolution                                                       */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Walk the policy rules (already sorted by priority) and return the
+     * first matching server id, falling back to the tool's own server
+     * field, then the policy default.
+     */
+    resolveServer(toolName) {
+        for (const rule of this.policy.rules) {
+            if (globToRegex(rule.match).test(toolName)) {
+                return rule.server;
+            }
+        }
+        // Fall back to the descriptor's own server association.
+        const descriptor = this.registry.get(toolName);
+        if (descriptor?.server) {
+            return descriptor.server;
+        }
+        return this.policy.defaultServer;
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Dispatch                                                         */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Full dispatch lifecycle:
+     *   1. Resolve descriptor + server
+     *   2. beforeToolUse hook
+     *   3. Execute via supplied executor
+     *   4. afterToolUse hook
+     *   5. Return result
+     */
+    async dispatch(context, executor) {
+        const descriptor = this.registry.get(context.toolName);
+        if (!descriptor) {
+            return {
+                output: null,
+                durationMs: 0,
+                error: `Tool not found: ${context.toolName}`,
+            };
+        }
+        // --- before hook ---
+        if (this.hooks) {
+            const hookResult = await this.hooks.beforeToolUse(context, descriptor);
+            if (hookResult?.decision === 'deny') {
+                return {
+                    output: null,
+                    durationMs: 0,
+                    error: hookResult.reason ?? 'Tool use denied by hook',
+                };
+            }
+        }
+        // --- execute ---
+        const start = Date.now();
+        let output;
+        let error;
+        try {
+            output = await executor(descriptor, context);
+        }
+        catch (err) {
+            error = err instanceof Error ? err.message : String(err);
+        }
+        const durationMs = Date.now() - start;
+        const result = { output, durationMs, error };
+        // --- after hook ---
+        if (this.hooks) {
+            await this.hooks.afterToolUse(context, descriptor, result);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Tool hook bridge — interface and no-op implementation.
+ *
+ * This module defines the contract that integrates tool-mux dispatch
+ * with the hooks-mux lifecycle (PreToolUse / PostToolUse).  The
+ * production implementation will delegate to the hooks-mux engine;
+ * for now a no-op bridge is provided so the rest of tool-mux can
+ * develop and test without a hard runtime dependency on hooks-mux.
+ */
+import type { ToolCallContext, ToolCallResult, ToolDescriptor } from './types.js';
+export interface ToolHookResult {
+    decision?: 'allow' | 'deny' | 'ask' | 'continue' | 'noop';
+    reason?: string;
+    toolMutation?: {
+        mode: 'replace' | 'patch';
+        value: unknown;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface ToolHookBridge {
+    /**
+     * Invoked immediately before a tool is executed.
+     * Returning a result with `decision: 'deny'` will short-circuit
+     * execution and surface the denial reason to the caller.
+     */
+    beforeToolUse(context: ToolCallContext, descriptor: ToolDescriptor): Promise<ToolHookResult | undefined>;
+    /**
+     * Invoked immediately after a tool finishes (success or failure).
+     * The result is informational — the hook cannot retroactively
+     * block the call, but it can record telemetry, mutate state, etc.
+     */
+    afterToolUse(context: ToolCallContext, descriptor: ToolDescriptor, result: ToolCallResult): Promise<ToolHookResult | undefined>;
+}
+/**
+ * A bridge that does nothing — hooks are allowed to be absent.
+ * Swap this out for a real hooks-mux adapter when integrating.
+ */
+export declare class NoopToolHookBridge implements ToolHookBridge {
+    beforeToolUse(_context: ToolCallContext, _descriptor: ToolDescriptor): Promise<ToolHookResult | undefined>;
+    afterToolUse(_context: ToolCallContext, _descriptor: ToolDescriptor, _result: ToolCallResult): Promise<ToolHookResult | undefined>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMlF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAC1B,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,aAAa,CACX,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAEvC;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACxC;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACjD,aAAa,CACjB,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAIhC,YAAY,CAChB,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;CAGvC"}

package/dist/hooks.js

@@ -0,0 +1,25 @@
+/**
+ * Tool hook bridge — interface and no-op implementation.
+ *
+ * This module defines the contract that integrates tool-mux dispatch
+ * with the hooks-mux lifecycle (PreToolUse / PostToolUse).  The
+ * production implementation will delegate to the hooks-mux engine;
+ * for now a no-op bridge is provided so the rest of tool-mux can
+ * develop and test without a hard runtime dependency on hooks-mux.
+ */
+/* ------------------------------------------------------------------ */
+/*  No-op implementation                                               */
+/* ------------------------------------------------------------------ */
+/**
+ * A bridge that does nothing — hooks are allowed to be absent.
+ * Swap this out for a real hooks-mux adapter when integrating.
+ */
+export class NoopToolHookBridge {
+    async beforeToolUse(_context, _descriptor) {
+        return undefined;
+    }
+    async afterToolUse(_context, _descriptor, _result) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6CH,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,aAAa,CACjB,QAAyB,EACzB,WAA2B;QAE3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,QAAyB,EACzB,WAA2B,EAC3B,OAAuB;QAEvB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { ToolSource, ToolDescriptor, ToolServer, ToolDispatchRule, ToolDispatchPolicy, ToolCallContext, ToolCallResult, } from './types.js';
+export { ToolRegistry } from './registry.js';
+export { ToolDispatcher } from './dispatch.js';
+export type { ToolExecutor, ToolDispatcherOptions } from './dispatch.js';
+export { convertTools, toToolDescriptor, fromToolDescriptor, translateTools, } from './schema-translation.js';
+export type { NormalizedToolDefinition, CodecCapabilities } from './schema-translation.js';
+export { NoopToolHookBridge } from './hooks.js';
+export type { ToolHookBridge, ToolHookResult } from './hooks.js';
+export { McpBridge } from './mcp-bridge.js';
+export type { McpTransport, McpServerConfig, McpToolDefinition } from './mcp-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAM7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAMzE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/* ------------------------------------------------------------------ */
+/*  Types                                                              */
+/* ------------------------------------------------------------------ */
+/* ------------------------------------------------------------------ */
+/*  Registry                                                           */
+/* ------------------------------------------------------------------ */
+export { ToolRegistry } from './registry.js';
+/* ------------------------------------------------------------------ */
+/*  Dispatch                                                           */
+/* ------------------------------------------------------------------ */
+export { ToolDispatcher } from './dispatch.js';
+/* ------------------------------------------------------------------ */
+/*  Schema translation (re-exports from transport-mux + adapters)      */
+/* ------------------------------------------------------------------ */
+export { convertTools, toToolDescriptor, fromToolDescriptor, translateTools, } from './schema-translation.js';
+/* ------------------------------------------------------------------ */
+/*  Hooks bridge                                                       */
+/* ------------------------------------------------------------------ */
+export { NoopToolHookBridge } from './hooks.js';
+/* ------------------------------------------------------------------ */
+/*  MCP bridge                                                         */
+/* ------------------------------------------------------------------ */
+export { McpBridge } from './mcp-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAYxE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAGjC,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}