@mcpmesh/sdk 1.4.1 → 2.0.0-beta.1

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

package/dist/__tests__/resolver-meshjob.spec.js

@@ -0,0 +1,201 @@
+/**
+ * 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.
+ */
+import { describe, it, expect } from "vitest";
+import { resolveMeshJobSignature, ResolverError, } from "../resolver-meshjob.js";
+// ===========================================================================
+// Contract scenarios 1-5 (must mirror across all three SDK test seams)
+// ===========================================================================
+describe("Resolver contract scenarios", () => {
+    it("scenario 1: MeshTool only — unchanged behaviour", () => {
+        // Python equivalent: fn(name, dep_a: McpMeshTool, dep_b: McpMeshTool)
+        // → mesh_tool_positions == [1, 2], no MeshJob.
+        //
+        // TS declarative form: dependencies ["dep_a", "dep_b"], no
+        // meshJobParamIndex. `args` lives at signature position 0; deps
+        // start at position 1.
+        const result = resolveMeshJobSignature({
+            dependencies: ["dep_a", "dep_b"],
+        });
+        expect(result.meshToolDeps).toEqual([
+            { depIndex: 0, signaturePosition: 1 },
+            { depIndex: 1, signaturePosition: 2 },
+        ]);
+        expect(result.meshJobParamIndex).toBeUndefined();
+    });
+    it("scenario 2: MeshJob only — no tools, MeshJob index recorded", () => {
+        // Python: fn(user_id, job: MeshJob) → mesh_tool_positions == [],
+        // mesh_job_param_index == 1.
+        const result = resolveMeshJobSignature({
+            dependencies: [],
+            meshJobParamIndex: 1,
+        });
+        expect(result.meshToolDeps).toEqual([]);
+        expect(result.meshJobParamIndex).toBe(1);
+    });
+    it("scenario 3: both, MeshJob in middle — MeshTool positions skip MeshJob", () => {
+        // Python: plan_trip(
+        //   user_id: str,                      # pos 0
+        //   weather_lookup: McpMeshTool,       # pos 1 — MeshTool[0]
+        //   job: MeshJob,                      # pos 2 — orthogonal
+        //   flight_search: McpMeshTool,        # pos 3 — MeshTool[1]
+        // )
+        // → mesh_tool_positions == [1, 3] (NOT [1, 2]); the resolver MUST
+        // NOT renumber tool slots when MeshJob is interleaved.
+        const result = resolveMeshJobSignature({
+            dependencies: ["weather_lookup", "flight_search"],
+            meshJobParamIndex: 2,
+        });
+        expect(result.meshToolDeps).toEqual([
+            { depIndex: 0, signaturePosition: 1 },
+            { depIndex: 1, signaturePosition: 3 }, // 3, not 2 — MeshJob skipped
+        ]);
+        expect(result.meshJobParamIndex).toBe(2);
+    });
+    it("scenario 4: neither — no DDDI metadata", () => {
+        // Python: fn(a, b) → empty resolution.
+        const result = resolveMeshJobSignature({ dependencies: [] });
+        expect(result.meshToolDeps).toEqual([]);
+        expect(result.meshJobParamIndex).toBeUndefined();
+    });
+    it("scenario 5: MeshJob trailing — index = last signature position", () => {
+        // Python: fn(a, b, tool: McpMeshTool, job: MeshJob)
+        // → mesh_tool_positions == [2], mesh_job_param_index == 3.
+        //
+        // TS form: one dep, MeshJob at the end. Note: in TS the user-arg
+        // shape is a single `args` object, so positions a/b are inside
+        // args (signature pos 0). The MeshTool dep takes pos 1 and the
+        // MeshJob takes pos 2 (the last slot).
+        const result = resolveMeshJobSignature({
+            dependencies: ["tool"],
+            meshJobParamIndex: 2,
+        });
+        expect(result.meshToolDeps).toEqual([
+            { depIndex: 0, signaturePosition: 1 },
+        ]);
+        expect(result.meshJobParamIndex).toBe(2);
+    });
+});
+// ===========================================================================
+// Contract edge cases — "Edge cases (REQUIRED)" in MESHJOB_DDDI_CONTRACT.md
+// ===========================================================================
+describe("Resolver edge cases", () => {
+    it("multiple MeshJob params raises ResolverError with the contract wording", () => {
+        // Phase 1: a tool function may declare at most one MeshJob param.
+        // The resolver MUST reject with the exact wording the contract
+        // specifies so the developer sees the misuse at registration time.
+        expect(() => resolveMeshJobSignature({
+            dependencies: [],
+            meshJobParamIndex: 1,
+            meshJobParamNames: ["firstJob", "secondJob"],
+        })).toThrow(ResolverError);
+        try {
+            resolveMeshJobSignature({
+                dependencies: [],
+                meshJobParamIndex: 1,
+                meshJobParamNames: ["firstJob", "secondJob"],
+            });
+        }
+        catch (err) {
+            const msg = err.message.toLowerCase();
+            // Contract wording: "a tool function may declare at most one MeshJob parameter"
+            expect(msg).toContain("at most one");
+            expect(msg).toContain("meshjob");
+            // Both offending names should appear so the developer can fix it.
+            expect(msg).toContain("firstjob");
+            expect(msg).toContain("secondjob");
+        }
+    });
+    it("MeshJob first position — orthogonal at any signature index", () => {
+        // Per contract: "MeshJob mixed with MeshTool at any position —
+        // permitted". The resolver MUST NOT enforce a trailing-position
+        // rule.
+        const result = resolveMeshJobSignature({
+            dependencies: ["dep_a"],
+            meshJobParamIndex: 1, // MeshJob at sig pos 1, dep slides to pos 2
+        });
+        expect(result.meshToolDeps).toEqual([
+            { depIndex: 0, signaturePosition: 2 },
+        ]);
+        expect(result.meshJobParamIndex).toBe(1);
+    });
+    it("explicit meshToolPositions — collision with MeshJob throws", () => {
+        // Defensive: if the caller supplies both meshToolPositions and
+        // meshJobParamIndex and they overlap, that's a contract violation
+        // — fail loudly rather than silently overwrite.
+        expect(() => resolveMeshJobSignature({
+            dependencies: ["x"],
+            meshToolPositions: [2],
+            meshJobParamIndex: 2,
+        })).toThrow(ResolverError);
+    });
+    it("explicit meshToolPositions — length mismatch throws", () => {
+        expect(() => resolveMeshJobSignature({
+            dependencies: ["a", "b"],
+            meshToolPositions: [1], // length 1 vs deps length 2
+        })).toThrow(ResolverError);
+    });
+});
+// ===========================================================================
+// Surface tests — the public exports + JS-side contextvar (job-context.ts)
+// ===========================================================================
+describe("MeshJob public surface", () => {
+    it("MeshJob type marker is importable from the package types module", async () => {
+        // Smoke test the export so a typo doesn't silently break the
+        // public API. We dynamic-import to assert it parses; the
+        // type-only import at the top of this file would be erased by
+        // tsc and not fail at runtime if the export disappeared.
+        const types = await import("../types.js");
+        // MeshJob is an interface (erased at runtime) — verify it's at
+        // least a key on the module type so consumers can `import type`
+        // it. The runtime presence we care about is the resolver +
+        // job-context, exercised by the other suites.
+        expect(types).toBeDefined();
+    });
+    it("currentJob() returns null outside any active job scope", async () => {
+        const { currentJob, remainingSeconds } = await import("../job-context.js");
+        expect(currentJob()).toBeNull();
+        expect(remainingSeconds()).toBeNull();
+    });
+    it("withJobAsync sets CURRENT_JOB visible to currentJob() inside the scope", async () => {
+        const { currentJob, remainingSeconds, withJobAsync } = await import("../job-context.js");
+        const inside = await withJobAsync({ jobId: "job-set", deadlineSecsRemaining: 12.5 }, async () => {
+            const cur = currentJob();
+            expect(cur).not.toBeNull();
+            expect(cur?.jobId).toBe("job-set");
+            expect(remainingSeconds()).toBe(12.5);
+            return "done";
+        });
+        expect(inside).toBe("done");
+        // Outside the scope: gone again.
+        expect(currentJob()).toBeNull();
+    });
+    it("snapshot with no deadline returns null remainingSeconds", async () => {
+        const { remainingSeconds, withJobAsync } = await import("../job-context.js");
+        await withJobAsync({ jobId: "job-no-deadline", deadlineSecsRemaining: null }, async () => {
+            expect(remainingSeconds()).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=resolver-meshjob.spec.js.map

package/dist/__tests__/resolver-meshjob.spec.js.map

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

package/dist/__tests__/schema-verdict-policy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Issue #547 Phase 4: unit tests for the schema verdict policy helpers in
+ * `schema-normalize.ts`.
+ */
+export {};
+//# sourceMappingURL=schema-verdict-policy.test.d.ts.map

package/dist/__tests__/schema-verdict-policy.test.d.ts.map

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