@mcpmesh/sdk 1.3.4 → 2.0.0-beta.1

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"}

package/dist/__tests__/proxy-stream.test.js

@@ -0,0 +1,347 @@
+/**
+ * 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.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { createProxy, streamMcpTool, DEFAULT_CALL_OPTIONS } from "../proxy.js";
+// Mock @mcpmesh/core so trace injection / dispatcher pieces don't need a Rust build
+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,
+}));
+/**
+ * Build a ReadableStream<Uint8Array> that emits the given SSE event blocks
+ * one chunk at a time. Each block should already include the trailing blank
+ * line per SSE spec.
+ */
+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, opts = {}) {
+    return {
+        ok: opts.ok ?? true,
+        status: opts.status ?? 200,
+        statusText: "OK",
+        body: makeSseStream(blocks),
+        headers: {
+            get: (name) => (name.toLowerCase() === "content-type" ? "text/event-stream" : null),
+        },
+    };
+}
+const ENDPOINT = "http://producer.local:9000";
+const TOOL = "stream_chunks";
+const CAPABILITY = "streamer";
+describe("streamMcpTool", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    it("yields each progress chunk in order", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            const reqId = JSON.parse(capturedBody).id;
+            const token = JSON.parse(capturedBody).params._meta.progressToken;
+            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",
+                    method: "notifications/progress",
+                    params: { progressToken: token, progress: 3, message: "gamma" },
+                }),
+                sseEvent({ jsonrpc: "2.0", id: reqId, result: { content: [{ type: "text", text: "alphabetagamma" }] } }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const chunks = [];
+        for await (const chunk of streamMcpTool(ENDPOINT, TOOL, { foo: 1 }, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+            chunks.push(chunk);
+        }
+        expect(chunks).toEqual(["alpha", "beta", "gamma"]);
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        // Verify the request body has _meta.progressToken
+        const body = JSON.parse(capturedBody);
+        expect(body.method).toBe("tools/call");
+        expect(body.params.name).toBe(TOOL);
+        expect(typeof body.params._meta.progressToken).toBe("string");
+        expect(body.params._meta.progressToken.length).toBeGreaterThan(0);
+        // Verify Accept header
+        const headers = fetchMock.mock.calls[0][1].headers;
+        // FastMCP requires both content types in Accept (or it returns 406)
+        expect(headers["Accept"]).toBe("application/json, text/event-stream");
+    });
+    it("does not yield the final result message content", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: body.params._meta.progressToken, progress: 1, message: "only-chunk" },
+                }),
+                // Final result with content that must NOT be yielded
+                sseEvent({
+                    jsonrpc: "2.0",
+                    id: body.id,
+                    result: { content: [{ type: "text", text: "FINAL-RESULT-DO-NOT-YIELD" }] },
+                }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const chunks = [];
+        for await (const chunk of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+            chunks.push(chunk);
+        }
+        expect(chunks).toEqual(["only-chunk"]);
+        expect(chunks).not.toContain("FINAL-RESULT-DO-NOT-YIELD");
+    });
+    it("ignores progress notifications with a mismatched progressToken", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            return makeMockResponse([
+                // Notification from a DIFFERENT in-flight call (unlikely but defensive)
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: "some-other-token", progress: 1, message: "ignored" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: body.params._meta.progressToken, progress: 1, message: "kept" },
+                }),
+                sseEvent({ jsonrpc: "2.0", id: body.id, result: {} }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const chunks = [];
+        for await (const chunk of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+            chunks.push(chunk);
+        }
+        expect(chunks).toEqual(["kept"]);
+    });
+    it("throws when the JSON-RPC final message contains an error", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: body.params._meta.progressToken, progress: 1, message: "partial" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    id: body.id,
+                    error: { code: -32000, message: "tool blew up" },
+                }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const collect = async () => {
+            const out = [];
+            for await (const chunk of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+                out.push(chunk);
+            }
+            return out;
+        };
+        await expect(collect()).rejects.toThrow(/tool blew up/);
+    });
+    it("throws on non-2xx HTTP response", async () => {
+        const fetchMock = vi.fn(async () => {
+            return {
+                ok: false,
+                status: 503,
+                statusText: "Service Unavailable",
+                body: makeSseStream([]),
+                headers: { get: () => null },
+            };
+        });
+        globalThis.fetch = fetchMock;
+        const collect = async () => {
+            for await (const _ of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+                // no-op
+            }
+        };
+        await expect(collect()).rejects.toThrow(/503 Service Unavailable/);
+    });
+    it("releases the underlying reader when the consumer breaks early", async () => {
+        let reader;
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            const stream = makeSseStream([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: body.params._meta.progressToken, progress: 1, message: "first" },
+                }),
+                sseEvent({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: { progressToken: body.params._meta.progressToken, progress: 2, message: "second" },
+                }),
+                sseEvent({ jsonrpc: "2.0", id: body.id, result: {} }),
+            ]);
+            // Wrap stream so we can spy on the reader after getReader is called
+            const origGetReader = stream.getReader.bind(stream);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            stream.getReader = function (...rargs) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                reader = origGetReader(...rargs);
+                return reader;
+            };
+            return {
+                ok: true,
+                status: 200,
+                statusText: "OK",
+                body: stream,
+                headers: { get: () => "text/event-stream" },
+            };
+        });
+        globalThis.fetch = fetchMock;
+        const iter = streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY);
+        const out = [];
+        for await (const chunk of iter) {
+            out.push(chunk);
+            // Break on first chunk
+            break;
+        }
+        expect(out).toEqual(["first"]);
+        // Wait a tick so finally{} can run
+        await new Promise((r) => setTimeout(r, 0));
+        expect(reader).toBeDefined();
+        // After cancel(), reads should resolve with done:true
+        const post = await reader.read();
+        expect(post.done).toBe(true);
+    });
+    it("yields nothing when the producer emits no progress notifications (TS soft-fallback skipped)", async () => {
+        // Per #854: TS Stage 1 does NOT implement Python's soft-fallback. If the
+        // producer didn't emit progress, the iterable yields nothing.
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            return makeMockResponse([
+                sseEvent({
+                    jsonrpc: "2.0",
+                    id: body.id,
+                    result: { content: [{ type: "text", text: "buffered final" }] },
+                }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const out = [];
+        for await (const chunk of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+            out.push(chunk);
+        }
+        expect(out).toEqual([]);
+    });
+    it("handles SSE events split across multiple network chunks", async () => {
+        // Split a single SSE event in the middle of its payload to verify the
+        // \n\n boundary parser correctly buffers partial reads.
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            const ev1 = sseEvent({
+                jsonrpc: "2.0",
+                method: "notifications/progress",
+                params: { progressToken: body.params._meta.progressToken, progress: 1, message: "one" },
+            });
+            const ev2 = sseEvent({
+                jsonrpc: "2.0",
+                method: "notifications/progress",
+                params: { progressToken: body.params._meta.progressToken, progress: 2, message: "two" },
+            });
+            const final = sseEvent({ jsonrpc: "2.0", id: body.id, result: {} });
+            const all = ev1 + ev2 + final;
+            const mid = Math.floor(all.length / 2);
+            return makeMockResponse([all.slice(0, mid), all.slice(mid)]);
+        });
+        globalThis.fetch = fetchMock;
+        const out = [];
+        for await (const chunk of streamMcpTool(ENDPOINT, TOOL, undefined, DEFAULT_CALL_OPTIONS, CAPABILITY)) {
+            out.push(chunk);
+        }
+        expect(out).toEqual(["one", "two"]);
+    });
+});
+describe("createProxy.stream() integration", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    it("attaches a non-enumerable stream method that yields progress chunks", async () => {
+        const fetchMock = vi.fn(async (_url, init) => {
+            const body = JSON.parse(init.body);
+            const token = body.params._meta.progressToken;
+            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: body.id, result: {} }),
+            ]);
+        });
+        globalThis.fetch = fetchMock;
+        const proxy = createProxy(ENDPOINT, CAPABILITY, TOOL);
+        expect(typeof proxy.stream).toBe("function");
+        // Non-enumerable: JSON.stringify on a function returns undefined entirely,
+        // which is the strongest possible guarantee that no internal field leaks.
+        // Also verify the property descriptor is non-enumerable explicitly.
+        const json = JSON.stringify(proxy);
+        expect(json).toBeUndefined();
+        const desc = Object.getOwnPropertyDescriptor(proxy, "stream");
+        expect(desc).toBeDefined();
+        expect(desc?.enumerable).toBe(false);
+        const chunks = [];
+        for await (const chunk of proxy.stream({ foo: "bar" })) {
+            chunks.push(chunk);
+        }
+        expect(chunks).toEqual(["x", "y"]);
+    });
+});
+//# sourceMappingURL=proxy-stream.test.js.map

package/dist/__tests__/proxy-stream.test.js.map

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

package/dist/__tests__/resolver-meshjob.spec.d.ts

@@ -0,0 +1,26 @@
+/**
+ * DDDI resolver tests for the `MeshJob` injectable (Phase 1).
+ *
+ * These tests are the TypeScript instance of the cross-runtime test
+ * seam specified in `MESHJOB_DDDI_CONTRACT.md` → "Equivalence across
+ * SDKs". The same scenarios MUST be covered by the Python and Java
+ * SDKs in their corresponding files
+ * (`tests/test_resolver_meshjob.py` and `MeshJobResolverTest.java`).
+ *
+ * If any behaviour here changes, update the contract first, then
+ * mirror across both other SDK test files. Each numbered scenario maps
+ * to the checklist in the contract document.
+ *
+ * # TS-shape note
+ *
+ * Python's resolver classifies parameters by reflection on
+ * `inspect.signature` + `typing.get_type_hints`. TypeScript erases
+ * types at runtime, so the TS resolver's input is the explicit
+ * `addTool({ dependencies, meshJobParamIndex })` declaration. The
+ * scenarios below translate the contract's signature-shape examples
+ * into the equivalent declarative form, then assert the same
+ * `meshToolDeps[*].signaturePosition` and `meshJobParamIndex` outputs
+ * the contract requires.
+ */
+export {};
+//# sourceMappingURL=resolver-meshjob.spec.d.ts.map

package/dist/__tests__/resolver-meshjob.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver-meshjob.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/resolver-meshjob.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}