@aroha-sdk/mcp-bridge 1.0.0 → 1.2.0

package/dist/bridge.test.d.ts

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

package/dist/bridge.test.d.ts.map

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

package/dist/bridge.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect, vi } from "vitest";
+import { mcpToolsToArohaCapabilities, arohaAgentToMcpTools } from "./index.js";
+import * as ed from "@noble/ed25519";
+import { sha512 } from "@noble/hashes/sha512";
+ed.etc.sha512Sync = (...m) => sha512(...m);
+function makeMcpTool(name, description = "A test tool") {
+    return {
+        name,
+        description,
+        inputSchema: {
+            type: "object",
+            properties: { query: { type: "string" } },
+            required: ["query"],
+        },
+    };
+}
+function makeDiscoveredAgent() {
+    return {
+        record: {
+            didHash: "0xtest-provider",
+            ownerAddress: "0xOwner",
+            manifestCID: "Qm123",
+            publicKeyB64: Buffer.alloc(32).toString("base64url"),
+            stakedWei: 1000000000000000000n,
+            reputationScore: 8000,
+            active: true,
+            registeredAt: Date.now() - 86400_000,
+            lastUpdatedAt: Date.now(),
+        },
+        manifest: {
+            aroha: "1.0",
+            did: "did:aroha:test-provider",
+            name: "Test Provider",
+            version: "1.0.0",
+            endpoint: "https://provider.example.com/aroha",
+            capabilities: [
+                {
+                    id: "search-flights",
+                    version: "1.0.0",
+                    description: "Search for flights",
+                    inputSchema: { type: "object", properties: { origin: { type: "string" } } },
+                    outputSchema: { type: "object", properties: { flights: { type: "array" } } },
+                    async: false,
+                    maxResponseMs: 5000,
+                    requiredTrustLevel: 1,
+                    pricing: { model: "free" },
+                    sagaRole: "none",
+                },
+                {
+                    id: "book-flight",
+                    version: "1.0.0",
+                    description: "Book a flight",
+                    inputSchema: { type: "object", properties: { flightId: { type: "string" } } },
+                    outputSchema: { type: "object", properties: { booking: { type: "string" } } },
+                    async: false,
+                    maxResponseMs: 10000,
+                    requiredTrustLevel: 2,
+                    pricing: { model: "per-transaction", fee: "10.00" },
+                    sagaRole: "participant",
+                },
+            ],
+            protocols: ["aroha/1.0"],
+            createdAt: new Date().toISOString(),
+            signature: "dummy-sig",
+        },
+        endpoint: "https://provider.example.com/aroha",
+        publicKey: new Uint8Array(32),
+    };
+}
+describe("mcpToolsToArohaCapabilities", () => {
+    it("converts MCP tools to Aroha capability definitions", () => {
+        const tools = [makeMcpTool("aroha_search_flights"), makeMcpTool("aroha_book_hotel")];
+        const caps = mcpToolsToArohaCapabilities(tools);
+        expect(caps).toHaveLength(2);
+        expect(caps[0].id).toBe("search-flights");
+        expect(caps[1].id).toBe("book-hotel");
+    });
+    it("sets correct default fields", () => {
+        const caps = mcpToolsToArohaCapabilities([makeMcpTool("aroha_do_thing", "Does the thing")]);
+        const cap = caps[0];
+        expect(cap.version).toBe("1.0.0");
+        expect(cap.async).toBe(false);
+        expect(cap.requiredTrustLevel).toBe(1);
+        expect(cap.pricing.model).toBe("free");
+        expect(cap.sagaRole).toBe("none");
+        expect(cap.description).toBe("Does the thing");
+    });
+    it("preserves the inputSchema", () => {
+        const tool = makeMcpTool("aroha_test");
+        const caps = mcpToolsToArohaCapabilities([tool]);
+        expect(caps[0].inputSchema).toEqual(tool.inputSchema);
+    });
+});
+describe("arohaAgentToMcpTools", () => {
+    it("produces one MCP tool per capability", async () => {
+        const priv = ed.utils.randomPrivateKey();
+        const agent = makeDiscoveredAgent();
+        const mockClient = { send: vi.fn(), stream: vi.fn(), fetchDIDDocument: vi.fn() };
+        const { tools } = arohaAgentToMcpTools(agent, "did:aroha:orchestrator", priv, mockClient, "saga-test");
+        expect(tools).toHaveLength(2);
+        expect(tools[0].name).toBe("aroha_search_flights");
+        expect(tools[1].name).toBe("aroha_book_flight");
+    });
+    it("tool definitions include _aroha metadata", async () => {
+        const priv = ed.utils.randomPrivateKey();
+        const agent = makeDiscoveredAgent();
+        const mockClient = { send: vi.fn(), stream: vi.fn(), fetchDIDDocument: vi.fn() };
+        const { tools } = arohaAgentToMcpTools(agent, "did:aroha:orchestrator", priv, mockClient, "saga-test");
+        expect(tools[0]._aroha?.agentDID).toBe("did:aroha:test-provider");
+        expect(tools[0]._aroha?.capabilityId).toBe("search-flights");
+    });
+    it("handleToolCall returns error for unknown tool", async () => {
+        const priv = ed.utils.randomPrivateKey();
+        const agent = makeDiscoveredAgent();
+        const mockClient = { send: vi.fn(), stream: vi.fn(), fetchDIDDocument: vi.fn() };
+        const { handleToolCall } = arohaAgentToMcpTools(agent, "did:aroha:orchestrator", priv, mockClient, "saga-test");
+        const result = await handleToolCall("aroha_nonexistent", {});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/Unknown tool/);
+    });
+    it("handleToolCall calls client.send and returns result", async () => {
+        const priv = ed.utils.randomPrivateKey();
+        const agent = makeDiscoveredAgent();
+        const mockResponse = {
+            type: "ArohaResponse",
+            body: { capability: "search-flights", result: { flights: ["AA100"] } },
+        };
+        const mockClient = {
+            send: vi.fn().mockResolvedValue(mockResponse),
+            stream: vi.fn(),
+            fetchDIDDocument: vi.fn(),
+        };
+        const { handleToolCall } = arohaAgentToMcpTools(agent, "did:aroha:orchestrator", priv, mockClient, "saga-test");
+        const result = await handleToolCall("aroha_search_flights", { origin: "JFK" });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("AA100");
+        expect(mockClient.send).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=bridge.test.js.map

package/dist/bridge.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Aroha ↔ MCP Bridge
+ *
+ * Two directions:
+ *
+ *   toMcp()    — Wrap a discovered Aroha agent's capabilities as MCP tool definitions.
+ *                Claude Desktop / any MCP client can call them as normal tools.
+ *                The bridge transparently sends ArohaRequest messages under the hood.
+ *
+ *   fromMcp()  — Expose an MCP server's tools as a Aroha capability manifest.
+ *                Any Aroha orchestrator can discover and call the MCP server
+ *                without knowing it's MCP-backed.
+ *
+ * The bridge is purely an adapter — it translates formats.
+ * It adds no business logic and changes no message semantics.
+ */
+import { ArohaClient } from "@aroha-sdk/core";
+import { type DiscoveredAgent, type CapabilityDefinition } from "@aroha-sdk/registry";
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    /** Aroha metadata — carried as an extension field */
+    _aroha?: {
+        agentDID: string;
+        capabilityId: string;
+        sagaRole: "none" | "participant";
+    };
+}
+export type McpToolCallResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+/**
+ * Convert a discovered Aroha agent's capabilities into MCP tool definitions.
+ * Returns both the definitions (for registering with MCP) and a handler
+ * function that executes the tool call via Aroha.
+ */
+export declare function arohaAgentToMcpTools(agent: DiscoveredAgent, orchestratorDID: string, orchestratorPrivateKey: Uint8Array, client: ArohaClient, correlationId: string): {
+    tools: McpToolDefinition[];
+    handleToolCall: (toolName: string, args: Record<string, unknown>) => Promise<McpToolCallResult>;
+};
+/**
+ * Convert MCP tool definitions into a Aroha capability manifest fragment.
+ * Use this to register an MCP server as a Aroha agent.
+ */
+export declare function mcpToolsToArohaCapabilities(tools: McpToolDefinition[]): CapabilityDefinition[];
+//# 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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAItF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,qDAAqD;IACrD,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;KAClC,CAAC;CACH;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,sBAAsB,EAAE,UAAU,EAClC,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,GACpB;IACD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjG,CA6CA;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,iBAAiB,EAAE,GACzB,oBAAoB,EAAE,CAaxB"}

package/dist/index.js

@@ -0,0 +1,95 @@
+/**
+ * Aroha ↔ MCP Bridge
+ *
+ * Two directions:
+ *
+ *   toMcp()    — Wrap a discovered Aroha agent's capabilities as MCP tool definitions.
+ *                Claude Desktop / any MCP client can call them as normal tools.
+ *                The bridge transparently sends ArohaRequest messages under the hood.
+ *
+ *   fromMcp()  — Expose an MCP server's tools as a Aroha capability manifest.
+ *                Any Aroha orchestrator can discover and call the MCP server
+ *                without knowing it's MCP-backed.
+ *
+ * The bridge is purely an adapter — it translates formats.
+ * It adds no business logic and changes no message semantics.
+ */
+import { buildEnvelope, } from "@aroha-sdk/core";
+// ─── Aroha → MCP ───────────────────────────────────────────────────────────────
+/**
+ * Convert a discovered Aroha agent's capabilities into MCP tool definitions.
+ * Returns both the definitions (for registering with MCP) and a handler
+ * function that executes the tool call via Aroha.
+ */
+export function arohaAgentToMcpTools(agent, orchestratorDID, orchestratorPrivateKey, client, correlationId) {
+    const tools = agent.manifest.capabilities.map((cap) => capabilityToMcpTool(cap, agent.manifest.did));
+    const handleToolCall = async (toolName, args) => {
+        const cap = agent.manifest.capabilities.find((c) => mcpToolName(c.id) === toolName);
+        if (!cap) {
+            return { content: [{ type: "text", text: `Unknown tool: ${toolName}` }], isError: true };
+        }
+        try {
+            const body = { capability: cap.id, params: args };
+            const envelope = await buildEnvelope("ArohaRequest", orchestratorDID, agent.manifest.did, body, correlationId, orchestratorPrivateKey);
+            const response = await client.send(agent.endpoint, envelope);
+            if (!response) {
+                return { content: [{ type: "text", text: "Agent returned no response (async)" }] };
+            }
+            if (response.type === "ArohaError") {
+                const err = response.body;
+                return { content: [{ type: "text", text: err.message }], isError: true };
+            }
+            const result = response.body.result;
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: String(err) }], isError: true };
+        }
+    };
+    return { tools, handleToolCall };
+}
+// ─── MCP → Aroha ───────────────────────────────────────────────────────────────
+/**
+ * Convert MCP tool definitions into a Aroha capability manifest fragment.
+ * Use this to register an MCP server as a Aroha agent.
+ */
+export function mcpToolsToArohaCapabilities(tools) {
+    return tools.map((tool) => ({
+        id: arohaCapabilityId(tool.name),
+        version: "1.0.0",
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        outputSchema: { type: "object", properties: { result: { type: "object" } } },
+        async: false,
+        maxResponseMs: 30_000,
+        requiredTrustLevel: 1,
+        pricing: { model: "free" },
+        sagaRole: "none",
+    }));
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function capabilityToMcpTool(cap, agentDID) {
+    return {
+        name: mcpToolName(cap.id),
+        description: cap.description ?? cap.id,
+        inputSchema: {
+            type: "object",
+            properties: cap.inputSchema?.properties ?? {},
+            required: cap.inputSchema?.required,
+        },
+        _aroha: {
+            agentDID,
+            capabilityId: cap.id,
+            sagaRole: cap.sagaRole,
+        },
+    };
+}
+/** Convert a Aroha capability ID to a valid MCP tool name (snake_case). */
+function mcpToolName(capabilityId) {
+    return `aroha_${capabilityId.replace(/-/g, "_")}`;
+}
+/** Convert an MCP tool name back to a Aroha capability ID. */
+function arohaCapabilityId(mcpName) {
+    return mcpName.replace(/^aroha_/, "").replace(/_/g, "-");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@aroha-sdk/mcp-bridge",
-  "version": "1.0.0",
-  "description": "Aroha ↔ MCP (Model Context Protocol) adapter",
+  "version": "1.2.0",
+  "description": "Aroha ↔ MCP (Model Context Protocol) adapter",
+  "files": [
+    "dist",
+    "src"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": { "composite": true, "outDir": "./dist", "rootDir": "./src" },
-  "references": [{ "path": "../aroha-core" }, { "path": "../aroha-registry" }],
-  "include": ["src/**/*"],
-  "exclude": ["dist", "node_modules"]
-}