@mcpmesh/sdk 1.4.1 → 2.0.0-beta.1

package/dist/__tests__/llm-agent-stream.test.js

@@ -0,0 +1,341 @@
+/**
+ * Unit tests for MeshLlmAgent.stream() — Stage 3 of issue #854.
+ *
+ * Covers:
+ * - Mesh-delegate path: chunks come through from a mocked process_chat_stream
+ * - The {request: <MeshLlmRequest>} body shape is preserved
+ * - Calling stream() without a meshProvider throws a clear error
+ * - The createCallable's .stream() exposes the same iterable
+ * - Tag-based discrimination: provider tags (including ai.mcpmesh.stream) are
+ *   forwarded verbatim to buildLlmAgentSpecs() so the registry resolver can
+ *   pick the streaming variant.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+vi.mock("@mcpmesh/core", () => ({
+    generateTraceId: () => "trace-mock",
+    generateSpanId: () => "span-mock",
+    injectTraceContext: (argsJson) => argsJson,
+    publishSpan: vi.fn(async () => false),
+    parseSseResponse: (s) => s,
+    parseSseResponseToObject: (s) => JSON.parse(s),
+}));
+vi.mock("../http-pool.js", () => ({
+    getDispatcher: () => undefined,
+}));
+import { MeshLlmAgent, MeshDelegatedProvider, } from "../llm-agent.js";
+import { LlmToolRegistry, buildLlmAgentSpecs } from "../llm.js";
+import { z } from "zod";
+function makeSseStream(blocks) {
+    const encoder = new TextEncoder();
+    let i = 0;
+    return new ReadableStream({
+        pull(controller) {
+            if (i < blocks.length) {
+                controller.enqueue(encoder.encode(blocks[i]));
+                i += 1;
+            }
+            else {
+                controller.close();
+            }
+        },
+    });
+}
+function sseEvent(payload) {
+    return `event: message\ndata: ${JSON.stringify(payload)}\n\n`;
+}
+function makeMockResponse(blocks) {
+    return {
+        ok: true,
+        status: 200,
+        statusText: "OK",
+        body: makeSseStream(blocks),
+        headers: {
+            get: (name) => name.toLowerCase() === "content-type" ? "text/event-stream" : null,
+        },
+    };
+}
+const ENDPOINT = "http://provider.local:9001";
+const STREAM_TOOL = "process_chat_stream";
+describe("MeshDelegatedProvider.streamComplete()", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    it("yields each progress chunk and wraps args in {request: <MeshLlmRequest>}", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            const body = JSON.parse(capturedBody);
+            const token = body.params._meta.progressToken;
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 1, message: "Hello" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 2, message: ", " },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 3, message: "world!" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    id: reqId,
+                    result: { content: [{ type: "text", text: "Hello, world!" }] },
+                }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, STREAM_TOOL, false);
+        const messages = [{ role: "user", content: "say hi" }];
+        const chunks = [];
+        for await (const c of provider.streamComplete("anthropic/claude-sonnet-4-5", messages, undefined, {
+            maxOutputTokens: 256,
+            temperature: 0.7,
+        })) {
+            chunks.push(c);
+        }
+        expect(chunks).toEqual(["Hello", ", ", "world!"]);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // Wire-format check: body should be tools/call -> process_chat_stream
+        // with a {request: {messages, model_params}} arguments object.
+        const body = JSON.parse(capturedBody);
+        expect(body.method).toBe("tools/call");
+        expect(body.params.name).toBe(STREAM_TOOL);
+        expect(typeof body.params._meta.progressToken).toBe("string");
+        const args = body.params.arguments;
+        expect(args.request).toBeDefined();
+        const request = args.request;
+        expect(request.messages).toEqual(messages);
+        const modelParams = request.model_params;
+        expect(modelParams.model).toBe("anthropic/claude-sonnet-4-5");
+        expect(modelParams.max_tokens).toBe(256);
+        expect(modelParams.temperature).toBe(0.7);
+    });
+    it("does not emit model_params when no model/options provided", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            const body = JSON.parse(capturedBody);
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({ jsonrpc: "2.0", id: reqId, result: { content: [{ type: "text", text: "" }] } }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, STREAM_TOOL, false);
+        const messages = [{ role: "user", content: "hi" }];
+        const out = [];
+        for await (const c of provider.streamComplete("default", messages)) {
+            out.push(c);
+        }
+        expect(out).toEqual([]);
+        const body = JSON.parse(capturedBody);
+        const args = body.params.arguments;
+        const request = args.request;
+        // model="default" + no options -> no model_params at all
+        expect(request.model_params).toBeUndefined();
+    });
+    it("forwards tools when present and includes parallel_tool_calls when enabled", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            const body = JSON.parse(capturedBody);
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({ jsonrpc: "2.0", id: reqId, result: { content: [{ type: "text", text: "" }] } }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, STREAM_TOOL, true);
+        const messages = [{ role: "user", content: "hi" }];
+        const tools = [
+            {
+                type: "function",
+                function: { name: "calc", description: "calc", parameters: { type: "object", properties: {} } },
+            },
+        ];
+        const out = [];
+        for await (const c of provider.streamComplete("anthropic/claude-sonnet-4-5", messages, tools)) {
+            out.push(c);
+        }
+        const body = JSON.parse(capturedBody);
+        const request = body.params.arguments.request;
+        expect(request.tools).toEqual(tools);
+        expect(request.model_params.parallel_tool_calls).toBe(true);
+    });
+});
+describe("MeshLlmAgent.stream()", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    it("streams chunks from a mesh-delegated provider", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            const token = body.params._meta.progressToken;
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 1, message: "alpha " },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 2, message: "beta" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    id: reqId,
+                    result: { content: [{ type: "text", text: "alpha beta" }] },
+                }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const agent = new MeshLlmAgent({
+            functionId: "test.stream",
+            provider: { capability: "llm", tags: ["ai.mcpmesh.stream"] },
+            maxIterations: 1,
+        });
+        const chunks = [];
+        for await (const c of agent.stream("hi", {
+            tools: [],
+            meshProvider: { endpoint: ENDPOINT, functionName: STREAM_TOOL },
+        })) {
+            chunks.push(c);
+        }
+        expect(chunks).toEqual(["alpha ", "beta"]);
+    });
+    it("throws when called without a meshProvider (provider not yet resolved)", async () => {
+        const agent = new MeshLlmAgent({
+            functionId: "test.unresolved",
+            provider: { capability: "llm", tags: ["+claude", "ai.mcpmesh.stream"] },
+            maxIterations: 1,
+        });
+        const collect = async () => {
+            const out = [];
+            for await (const c of agent.stream("hi", { tools: [] })) {
+                out.push(c);
+            }
+            return out;
+        };
+        await expect(collect()).rejects.toThrow(/MeshLlmAgent\.stream\(\) requires a mesh-delegated provider/);
+        await expect(collect()).rejects.toThrow(/ai\.mcpmesh\.stream/);
+    });
+    it("createCallable exposes a stream() method that delegates correctly", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            const token = body.params._meta.progressToken;
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 1, message: "x" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 2, message: "y" },
+                }),
+                sseEvent({ jsonrpc: "2.0", id: reqId, result: {} }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const agent = new MeshLlmAgent({
+            functionId: "test.callable",
+            provider: { capability: "llm", tags: ["ai.mcpmesh.stream"] },
+            maxIterations: 1,
+        });
+        const callable = agent.createCallable({
+            tools: [],
+            meshProvider: { endpoint: ENDPOINT, functionName: STREAM_TOOL },
+        });
+        expect(typeof callable.stream).toBe("function");
+        const out = [];
+        for await (const c of callable.stream("ping")) {
+            out.push(c);
+        }
+        expect(out).toEqual(["x", "y"]);
+    });
+    it("system prompt template is rendered and pushed as the first message", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            const body = JSON.parse(capturedBody);
+            const reqId = body.id;
+            return makeMockResponse([
+                sseEvent({ jsonrpc: "2.0", id: reqId, result: { content: [{ type: "text", text: "" }] } }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const agent = new MeshLlmAgent({
+            functionId: "test.sys",
+            provider: { capability: "llm", tags: ["ai.mcpmesh.stream"] },
+            maxIterations: 1,
+            systemPrompt: "You are {{role}}.",
+        });
+        const out = [];
+        for await (const c of agent.stream("hi", {
+            tools: [],
+            meshProvider: { endpoint: ENDPOINT, functionName: STREAM_TOOL },
+            templateContext: { role: "concise" },
+        })) {
+            out.push(c);
+        }
+        expect(out).toEqual([]);
+        const body = JSON.parse(capturedBody);
+        const request = body.params.arguments.request;
+        const messages = request.messages;
+        expect(messages[0]).toEqual({ role: "system", content: "You are concise." });
+        expect(messages[1]).toEqual({ role: "user", content: "hi" });
+    });
+});
+describe("Tag-based discrimination flows through to buildLlmAgentSpecs", () => {
+    beforeEach(() => {
+        LlmToolRegistry.reset();
+    });
+    it("forwards provider.tags (including ai.mcpmesh.stream) verbatim in the agent spec", () => {
+        const registry = LlmToolRegistry.getInstance();
+        registry.register("user.chat_stream", {
+            functionId: "user.chat_stream",
+            name: "chat_stream",
+            capability: "chat_stream",
+            description: "stream test",
+            version: "1.0.0",
+            tags: [],
+            provider: { capability: "llm", tags: ["+claude", "ai.mcpmesh.stream"] },
+            maxIterations: 1,
+            filterMode: "all",
+            inputSchema: JSON.stringify({ type: "object" }),
+            outputMode: "hint",
+            parallelToolCalls: false,
+            execute: async () => "ok",
+        });
+        const specs = buildLlmAgentSpecs();
+        expect(specs).toHaveLength(1);
+        const parsed = JSON.parse(specs[0].provider);
+        // Mesh-delegate object spec is serialized as-is
+        expect(parsed.capability).toBe("llm");
+        expect(parsed.tags).toEqual(["+claude", "ai.mcpmesh.stream"]);
+    });
+});
+// Small helper so the unused-import lint doesn't trigger if z grows unused
+void z;
+//# sourceMappingURL=llm-agent-stream.test.js.map

package/dist/__tests__/llm-agent-stream.test.js.map

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

package/dist/__tests__/mesh-job-submitter.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mesh-job-submitter.spec.d.ts.map

package/dist/__tests__/mesh-job-submitter.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-job-submitter.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/mesh-job-submitter.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/mesh-job-submitter.spec.js

@@ -0,0 +1,110 @@
+/**
+ * Tests for MeshJobSubmitter (Phase 1 — MeshJob substrate).
+ *
+ * We don't bind to a real registry here — the napi `submitJob` is
+ * mocked via vitest. The tests exercise:
+ *
+ *   - The retry policy (3 attempts on transient errors with 200ms then
+ *     1s of backoff between attempts — 2 gaps for 3 attempts).
+ *   - Fail-fast on non-transient errors (404 / 4xx / serialization).
+ *   - Date → unix-epoch-seconds conversion for `totalDeadline`.
+ *   - Number → unix-epoch-seconds normalisation (heuristic for
+ *     callers that pass milliseconds).
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { MeshJobSubmitter } from "../mesh-job-submitter.js";
+// Mock napi-rs core's submit_job. Vitest hoists the factory above
+// imports so the SDK reads the mock regardless of import order.
+vi.mock("@mcpmesh/core", async () => {
+    const actual = await vi.importActual("@mcpmesh/core");
+    return {
+        ...actual,
+        submitJob: vi.fn(),
+    };
+});
+import { submitJob } from "@mcpmesh/core";
+const submitJobMock = submitJob;
+describe("MeshJobSubmitter", () => {
+    beforeEach(() => {
+        submitJobMock.mockReset();
+    });
+    it("calls napi submitJob with the bound capability + payload", async () => {
+        submitJobMock.mockResolvedValueOnce({ jobId: "job-123" });
+        const sub = new MeshJobSubmitter("generate_report", "consumer-abc", "http://localhost:8000");
+        const proxy = await sub.submit({ user_id: "u1", sections: ["a"] });
+        expect(proxy).toEqual({ jobId: "job-123" });
+        expect(submitJobMock).toHaveBeenCalledOnce();
+        expect(submitJobMock).toHaveBeenCalledWith({
+            registryUrl: "http://localhost:8000",
+            capability: "generate_report",
+            payload: { user_id: "u1", sections: ["a"] },
+            submittedBy: "consumer-abc",
+            ownerInstanceId: undefined,
+            maxDuration: undefined,
+            maxRetries: undefined,
+            totalDeadline: undefined,
+        });
+    });
+    it("forwards optional knobs to napi submit", async () => {
+        submitJobMock.mockResolvedValueOnce({ jobId: "j" });
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        const deadlineMs = 1735689600 * 1000; // 2025-01-01T00:00:00Z
+        await sub.submit({ foo: 1 }, {
+            maxDuration: 60,
+            maxRetries: 3,
+            totalDeadline: new Date(deadlineMs),
+        });
+        const call = submitJobMock.mock.calls[0][0];
+        expect(call.maxDuration).toBe(60);
+        expect(call.maxRetries).toBe(3);
+        expect(call.totalDeadline).toBe(1735689600);
+    });
+    it("normalises a millisecond-shaped number to seconds for totalDeadline", async () => {
+        submitJobMock.mockResolvedValueOnce({});
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await sub.submit({}, { totalDeadline: 1735689600_000 });
+        expect(submitJobMock.mock.calls[0][0].totalDeadline).toBe(1735689600);
+    });
+    it("passes seconds-shaped number through unchanged", async () => {
+        submitJobMock.mockResolvedValueOnce({});
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await sub.submit({}, { totalDeadline: 1735689600 });
+        expect(submitJobMock.mock.calls[0][0].totalDeadline).toBe(1735689600);
+    });
+    it("retries up to 3 times on a network error then succeeds", async () => {
+        submitJobMock
+            .mockRejectedValueOnce(new Error("backend error: network error: ECONNREFUSED"))
+            .mockRejectedValueOnce(new Error("backend error: network error: ECONNREFUSED"))
+            .mockResolvedValueOnce({ jobId: "ok" });
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        const proxy = await sub.submit({});
+        expect(proxy).toEqual({ jobId: "ok" });
+        expect(submitJobMock).toHaveBeenCalledTimes(3);
+    });
+    it("fails-fast on a 4xx error (not transient)", async () => {
+        submitJobMock.mockRejectedValueOnce(new Error("backend error: backend error: HTTP 400: bad payload"));
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await expect(sub.submit({})).rejects.toThrow(/HTTP 400/);
+        expect(submitJobMock).toHaveBeenCalledOnce();
+    });
+    it("fails-fast on job-not-found (404)", async () => {
+        submitJobMock.mockRejectedValueOnce(new Error("backend error: job not found: abc"));
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await expect(sub.submit({})).rejects.toThrow(/not found/);
+        expect(submitJobMock).toHaveBeenCalledOnce();
+    });
+    it("propagates the last transient error after exhausting retries", async () => {
+        submitJobMock.mockRejectedValue(new Error("backend error: backend unavailable: 503"));
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await expect(sub.submit({})).rejects.toThrow(/backend unavailable/);
+        // 3 attempts total per the policy.
+        expect(submitJobMock).toHaveBeenCalledTimes(3);
+    }, 10_000);
+    it("rejects an invalid totalDeadline shape with a TypeError", async () => {
+        const sub = new MeshJobSubmitter("c", "by", "http://r");
+        await expect(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        sub.submit({}, { totalDeadline: "not-a-date" })).rejects.toThrow(TypeError);
+    });
+});
+//# sourceMappingURL=mesh-job-submitter.spec.js.map

package/dist/__tests__/mesh-job-submitter.spec.js.map

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

package/dist/__tests__/proxy-stream.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for streamMcpTool / proxy.stream() in proxy.ts
+ *
+ * Mocks ``fetch`` to return a Response whose body is a ReadableStream emitting
+ * hand-crafted SSE events (``notifications/progress`` followed by a final
+ * ``result``). Verifies the wire-protocol contract documented in #854.
+ */
+export {};
+//# sourceMappingURL=proxy-stream.test.d.ts.map

package/dist/__tests__/proxy-stream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-stream.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/proxy-stream.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}