@mcpmesh/sdk 1.4.1 → 2.0.0-beta.1

package/dist/__tests__/inbound-job-dispatch.spec.js

@@ -0,0 +1,185 @@
+/**
+ * Tests for the inbound MeshJob dispatch wrapper (Phase 1).
+ *
+ * Mirrors the behavioural envelope of Python's
+ * `tests/test_job_dispatch.py`. We don't bind to the napi-rs
+ * `JobController` here — those are exercised by the cross-FFI test
+ * suite. Instead we verify:
+ *
+ *   - `readJobHeaders` returns the right shape on the standard
+ *     headers + on absent / malformed inputs;
+ *   - `runWithJobContext` runs the thunk inside `CURRENT_JOB.run`
+ *     when a controller is present, and bypasses the wrap when
+ *     either jobId or controller is null;
+ *   - the auto-complete path fires only when the controller hadn't
+ *     already gone terminal, and propagates user exceptions verbatim.
+ */
+import { describe, it, expect, vi } from "vitest";
+import { readJobHeaders, runWithJobContext, } from "../inbound-job-dispatch.js";
+import { currentJob } from "../job-context.js";
+describe("readJobHeaders", () => {
+    it("returns [null, null] when headers is null/undefined", () => {
+        expect(readJobHeaders(null)).toEqual([null, null]);
+        expect(readJobHeaders(undefined)).toEqual([null, null]);
+        expect(readJobHeaders({})).toEqual([null, null]);
+    });
+    it("extracts job id only when X-Mesh-Timeout is absent", () => {
+        expect(readJobHeaders({ "x-mesh-job-id": "job-123" })).toEqual([
+            "job-123",
+            null,
+        ]);
+    });
+    it("extracts both headers and parses timeout as float", () => {
+        expect(readJobHeaders({
+            "x-mesh-job-id": "job-456",
+            "x-mesh-timeout": "12.5",
+        })).toEqual(["job-456", 12.5]);
+    });
+    it("ignores malformed timeout (non-numeric / non-positive)", () => {
+        expect(readJobHeaders({
+            "x-mesh-job-id": "j1",
+            "x-mesh-timeout": "abc",
+        })).toEqual(["j1", null]);
+        expect(readJobHeaders({
+            "x-mesh-job-id": "j2",
+            "x-mesh-timeout": "0",
+        })).toEqual(["j2", null]);
+        expect(readJobHeaders({
+            "x-mesh-job-id": "j3",
+            "x-mesh-timeout": "-1.5",
+        })).toEqual(["j3", null]);
+    });
+});
+describe("runWithJobContext", () => {
+    it("runs the thunk directly when jobId or controller is null", async () => {
+        const result = await runWithJobContext(null, null, null, async () => {
+            // No active job inside the thunk.
+            expect(currentJob()).toBeNull();
+            return "ran";
+        });
+        expect(result).toBe("ran");
+    });
+    it("sets CURRENT_JOB inside the scope when controller is provided", async () => {
+        // Build a stub that mimics the JobController surface readWithJobContext
+        // touches: isTerminal() and complete(). The napi binding's actual
+        // behaviour is exercised in the Rust test suite.
+        const stub = {
+            isTerminal: vi.fn().mockResolvedValue(true), // already terminal → no auto-complete
+            complete: vi.fn().mockResolvedValue(undefined),
+            fail: vi.fn().mockResolvedValue(undefined),
+        };
+        const result = await runWithJobContext("job-abc", 30, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        stub, async () => {
+            const cur = currentJob();
+            expect(cur?.jobId).toBe("job-abc");
+            expect(cur?.deadlineSecsRemaining).toBe(30);
+            return 42;
+        });
+        expect(result).toBe(42);
+        // Already-terminal probe → no auto-complete.
+        expect(stub.complete).not.toHaveBeenCalled();
+        // Outside the scope CURRENT_JOB is gone again.
+        expect(currentJob()).toBeNull();
+    });
+    it("auto-completes when the controller is not yet terminal", async () => {
+        const stub = {
+            isTerminal: vi.fn().mockResolvedValue(false),
+            complete: vi.fn().mockResolvedValue(undefined),
+            fail: vi.fn().mockResolvedValue(undefined),
+        };
+        const userValue = { ok: true, n: 42 };
+        const result = await runWithJobContext("job-auto", null, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        stub, async () => userValue);
+        // The user's value is captured in a closure and returned directly
+        // (no napi serde round-trip), so the same reference is preserved.
+        expect(result).toBe(userValue);
+        expect(stub.complete).toHaveBeenCalledOnce();
+        expect(stub.complete).toHaveBeenCalledWith(userValue);
+    });
+    it("returns non-JSON-safe values to the caller and wraps for auto-complete", async () => {
+        // Map / Set / class instance / Symbol — any of these would have
+        // tripped the napi serde-json round-trip with a cryptic Rust error
+        // before the fix. Now they pass through to the caller untouched
+        // (Rust never sees them) and the auto-complete wraps them as
+        // `{ value: String(...) }` for the registry.
+        const cases = [
+            { name: "Map", build: () => new Map([["k", 1]]) },
+            { name: "Set", build: () => new Set([1, 2, 3]) },
+            {
+                name: "class instance",
+                build: () => {
+                    class Foo {
+                        x = 1;
+                        describe() {
+                            return "foo";
+                        }
+                    }
+                    return new Foo();
+                },
+            },
+            { name: "BigInt", build: () => BigInt(123) },
+            { name: "undefined", build: () => undefined },
+        ];
+        for (const c of cases) {
+            const stub = {
+                isTerminal: vi.fn().mockResolvedValue(false),
+                complete: vi.fn().mockResolvedValue(undefined),
+                fail: vi.fn().mockResolvedValue(undefined),
+            };
+            const value = c.build();
+            const result = await runWithJobContext(`job-${c.name}`, null, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            stub, async () => value);
+            // The user value is preserved verbatim — it never crosses napi.
+            expect(result, `case=${c.name} return value`).toBe(value);
+            // And the registry sees a JSON-safe wrap.
+            expect(stub.complete, `case=${c.name} complete called`).toHaveBeenCalledOnce();
+            const completedWith = stub.complete.mock.calls[0][0];
+            expect(completedWith, `case=${c.name} complete payload is wrapped`).toMatchObject({ value: expect.any(String) });
+        }
+    });
+    it("auto-completes nested JSON-safe arrays/objects verbatim", async () => {
+        const stub = {
+            isTerminal: vi.fn().mockResolvedValue(false),
+            complete: vi.fn().mockResolvedValue(undefined),
+            fail: vi.fn().mockResolvedValue(undefined),
+        };
+        const userValue = { items: [1, 2, { nested: "ok" }], count: 3 };
+        await runWithJobContext("job-deep", null, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        stub, async () => userValue);
+        // Nested-but-JSON-safe → forwarded verbatim, no { value: ... } wrap.
+        expect(stub.complete).toHaveBeenCalledWith(userValue);
+    });
+    it("calls fail() on user exception when not yet terminal", async () => {
+        const stub = {
+            isTerminal: vi.fn().mockResolvedValue(false),
+            complete: vi.fn().mockResolvedValue(undefined),
+            fail: vi.fn().mockResolvedValue(undefined),
+        };
+        await expect(runWithJobContext("job-fail", null, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        stub, async () => {
+            throw new Error("boom");
+        })).rejects.toThrow("boom");
+        expect(stub.fail).toHaveBeenCalledOnce();
+        expect(stub.fail).toHaveBeenCalledWith("boom");
+        expect(stub.complete).not.toHaveBeenCalled();
+    });
+    it("does not call fail() when the controller is already terminal", async () => {
+        const stub = {
+            isTerminal: vi.fn().mockResolvedValue(true),
+            complete: vi.fn().mockResolvedValue(undefined),
+            fail: vi.fn().mockResolvedValue(undefined),
+        };
+        await expect(runWithJobContext("job-already", null, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        stub, async () => {
+            throw new Error("ignored-fail");
+        })).rejects.toThrow("ignored-fail");
+        expect(stub.fail).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=inbound-job-dispatch.spec.js.map

package/dist/__tests__/inbound-job-dispatch.spec.js.map

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

package/dist/__tests__/job-controller-progress.spec.d.ts

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

package/dist/__tests__/job-controller-progress.spec.d.ts.map

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

package/dist/__tests__/job-controller-progress.spec.js

@@ -0,0 +1,85 @@
+/**
+ * Regression test for the napi `JobController` constructor's batching tick.
+ *
+ * The `#[napi(constructor)]` is invoked synchronously from JS context with
+ * NO ambient Tokio runtime — `Handle::try_current()` returns Err there,
+ * so an earlier implementation silently skipped `spawn_batching_tick` and
+ * mid-flight `updateProgress` calls accumulated in the coalescing queue
+ * forever (only `complete()`/`fail()` flushed because those are async napi
+ * methods that run inside napi-rs's Tokio runtime).
+ *
+ * The fix uses `napi::bindgen_prelude::within_runtime_if_available` so
+ * the tick spawns inside napi-rs's shared runtime regardless of whether
+ * the caller is sync or async — mirroring Python's pattern of entering
+ * `pyo3_async_runtimes::tokio::get_runtime()`.
+ *
+ * This test spins up a tiny HTTP server playing the role of the registry,
+ * constructs a real `JobController` against it, calls `updateProgress`,
+ * and asserts that the batching tick eventually POSTs to `/jobs/batch`
+ * with the queued delta — proving the tick actually runs.
+ */
+import { describe, it, expect } from "vitest";
+import { JobController } from "@mcpmesh/core";
+import http from "node:http";
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (c) => chunks.push(c));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        req.on("error", reject);
+    });
+}
+describe("JobController batching tick", () => {
+    it("flushes updateProgress via the batching tick on a fake registry", async () => {
+        const recorded = [];
+        // Tiny registry mock: accept POST /jobs/batch, record body, return 200.
+        const server = http.createServer((req, res) => {
+            if (req.method === "POST" && req.url === "/jobs/batch") {
+                readBody(req)
+                    .then((body) => {
+                    recorded.push(JSON.parse(body));
+                    res.statusCode = 200;
+                    res.setHeader("content-type", "application/json");
+                    res.end(JSON.stringify({ accepted: 1, rejected: [] }));
+                })
+                    .catch(() => {
+                    res.statusCode = 500;
+                    res.end();
+                });
+                return;
+            }
+            res.statusCode = 404;
+            res.end();
+        });
+        await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+        const port = server.address().port;
+        const registryUrl = `http://127.0.0.1:${port}`;
+        try {
+            // Construct a real napi JobController — this is the exact code path
+            // that was broken: the constructor must spawn the batching tick on
+            // napi-rs's runtime, not on `Handle::try_current()` (which returns
+            // Err from a synchronous JS context).
+            const ctrl = new JobController("job-batch-test", "inst-1", registryUrl);
+            await ctrl.updateProgress(0.5, "halfway");
+            // Default batching interval is 2s. Wait long enough for at least one
+            // tick to fire. If the tick wasn't spawned, recorded stays empty.
+            // Use 5s of slack so this isn't flaky on slow CI runners — 500ms
+            // of headroom over a 2s tick was too tight, the cost of ~2.5s
+            // extra wall time is acceptable for a single test.
+            await new Promise((r) => setTimeout(r, 5000));
+            expect(recorded.length, "batching tick must POST at least one batch with the queued progress delta").toBeGreaterThanOrEqual(1);
+            const seen = recorded[0];
+            expect(seen.instance_id).toBe("inst-1");
+            expect(seen.deltas.length).toBe(1);
+            expect(seen.deltas[0].id).toBe("job-batch-test");
+            expect(seen.deltas[0].progress).toBeCloseTo(0.5, 5);
+            expect(seen.deltas[0].progress_message).toBe("halfway");
+            // Mid-flight delta — no terminal status.
+            expect(seen.deltas[0].status ?? null).toBeNull();
+        }
+        finally {
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=job-controller-progress.spec.js.map

package/dist/__tests__/job-controller-progress.spec.js.map

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

package/dist/__tests__/jobs-cancel-route.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jobs-cancel-route.spec.d.ts.map

package/dist/__tests__/jobs-cancel-route.spec.d.ts.map

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

package/dist/__tests__/jobs-cancel-route.spec.js

@@ -0,0 +1,88 @@
+/**
+ * Cancel-route registration visibility tests (W5 — PR review finding).
+ *
+ * Cancel-mid-flight is a primary control-plane signal for long-running
+ * jobs. Before the fix, registration failures landed at `console.warn`
+ * — operators who only watched `error`-level logs would never see the
+ * regression and the agent would silently degrade to lease-expiry
+ * cancellation.
+ *
+ * This file verifies the escalation:
+ *   - failures land at `console.error`;
+ *   - the message includes the underlying reason so the failure mode
+ *     is debuggable from logs alone.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { registerCancelRoute } from "../jobs-cancel-route.js";
+describe("registerCancelRoute — visibility", () => {
+    let errorSpy;
+    let warnSpy;
+    beforeEach(() => {
+        errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        warnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+    });
+    afterEach(() => {
+        errorSpy.mockRestore();
+        warnSpy.mockRestore();
+    });
+    it("logs at console.error (not warn) when getApp() throws, including the reason", () => {
+        const stubServer = {
+            getApp: () => {
+                throw new Error("FastMCP server not started");
+            },
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        };
+        const ok = registerCancelRoute(stubServer);
+        expect(ok).toBe(false);
+        // Escalated to error, NOT warn.
+        expect(errorSpy).toHaveBeenCalledOnce();
+        expect(warnSpy).not.toHaveBeenCalled();
+        // Reason is included so operators can debug from logs alone.
+        const msg = errorSpy.mock.calls[0][0];
+        expect(msg).toContain("cancel route NOT registered");
+        expect(msg).toContain("FastMCP server not started");
+    });
+    it("logs at console.error when getApp() returns null", () => {
+        const stubServer = {
+            getApp: () => null,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        };
+        const ok = registerCancelRoute(stubServer);
+        expect(ok).toBe(false);
+        expect(errorSpy).toHaveBeenCalledOnce();
+        expect(warnSpy).not.toHaveBeenCalled();
+        const msg = errorSpy.mock.calls[0][0];
+        expect(msg).toContain("cancel route NOT registered");
+        expect(msg).toContain("returned null");
+    });
+    it("logs at console.error when app.post() raises, including the reason", () => {
+        const stubServer = {
+            getApp: () => ({
+                post: () => {
+                    throw new Error("hono internal: route conflict");
+                },
+            }),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        };
+        const ok = registerCancelRoute(stubServer);
+        expect(ok).toBe(false);
+        expect(errorSpy).toHaveBeenCalledOnce();
+        expect(warnSpy).not.toHaveBeenCalled();
+        const msg = errorSpy.mock.calls[0][0];
+        expect(msg).toContain("cancel route NOT registered");
+        expect(msg).toContain("hono internal: route conflict");
+    });
+    it("returns true and does not log anything when registration succeeds", () => {
+        const postSpy = vi.fn();
+        const stubServer = {
+            getApp: () => ({ post: postSpy }),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        };
+        const ok = registerCancelRoute(stubServer);
+        expect(ok).toBe(true);
+        expect(postSpy).toHaveBeenCalledWith("/jobs/:job_id/cancel", expect.any(Function));
+        expect(errorSpy).not.toHaveBeenCalled();
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=jobs-cancel-route.spec.js.map

package/dist/__tests__/jobs-cancel-route.spec.js.map

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

package/dist/__tests__/llm-agent-stream.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=llm-agent-stream.test.d.ts.map

package/dist/__tests__/llm-agent-stream.test.d.ts.map

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