@mcpmesh/sdk 2.0.1 → 2.2.0

package/dist/__tests__/llm-agent-model-params.test.js

@@ -0,0 +1,229 @@
+/**
+ * Unit tests for the `modelParams` escape-hatch — issue #1019.
+ *
+ * The TS SDK exposes a typed option surface (`maxOutputTokens`, `temperature`,
+ * `topP`, `stop`) that maps to wire `model_params` keys. For vendor-specific
+ * kwargs that the typed surface doesn't expose (e.g., Gemini `thinking_config`,
+ * Anthropic `output_config`, OpenAI `reasoning_effort`) callers can pass an
+ * arbitrary dict via `options.modelParams`. The dict is merged into the wire
+ * `model_params` BEFORE typed fields, so typed options always win on collision
+ * (keeping the typed surface authoritative).
+ *
+ * Covers both the buffered (`complete()`) and the streaming (`streamComplete()`)
+ * paths since both build `model_params` independently.
+ */
+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 { MeshDelegatedProvider } from "../llm-agent.js";
+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 FN_BUFFERED = "process_chat";
+const FN_STREAM = "process_chat_stream";
+// ----------------------------------------------------------------------------
+// complete() — buffered path
+// ----------------------------------------------------------------------------
+describe("MeshDelegatedProvider.complete() — modelParams escape hatch", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    function mockJsonResponse(body) {
+        return {
+            ok: true,
+            status: 200,
+            statusText: "OK",
+            headers: {
+                get: (name) => name.toLowerCase() === "content-type" ? "application/json" : null,
+            },
+            text: async () => JSON.stringify(body),
+            json: async () => body,
+        };
+    }
+    function mcpToolResponse(payload) {
+        return {
+            jsonrpc: "2.0",
+            id: 1,
+            result: {
+                content: [{ type: "text", text: JSON.stringify(payload) }],
+            },
+        };
+    }
+    // complete() expects the MCP content[0].text payload to be the
+    // mesh-provider shape: { role, content, tool_calls?, _mesh_usage? }
+    const STUB_COMPLETION = { role: "assistant", content: "ok" };
+    it("merges modelParams keys into the wire request's model_params", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            return mockJsonResponse(mcpToolResponse(STUB_COMPLETION));
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, FN_BUFFERED, false);
+        const messages = [{ role: "user", content: "hi" }];
+        await provider.complete("anthropic/claude-sonnet-4-5", messages, undefined, {
+            maxOutputTokens: 256,
+            modelParams: {
+                thinking_config: { thinking_budget: 0 },
+                reasoning_effort: "high",
+            },
+        });
+        const body = JSON.parse(capturedBody);
+        const request = body.params.arguments.request;
+        const modelParams = request.model_params;
+        expect(modelParams.thinking_config).toEqual({ thinking_budget: 0 });
+        expect(modelParams.reasoning_effort).toBe("high");
+        // Typed fields still flow through
+        expect(modelParams.max_tokens).toBe(256);
+        expect(modelParams.model).toBe("anthropic/claude-sonnet-4-5");
+    });
+    it("typed options win over modelParams on collision", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            return mockJsonResponse(mcpToolResponse(STUB_COMPLETION));
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, FN_BUFFERED, false);
+        const messages = [{ role: "user", content: "hi" }];
+        await provider.complete("anthropic/claude-sonnet-4-5", messages, undefined, {
+            temperature: 0.5,
+            maxOutputTokens: 200,
+            modelParams: {
+                temperature: 0.9, // caller tried to set via escape hatch — typed wins
+                max_tokens: 999, // caller used the wire-name; typed maxOutputTokens wins
+                thinking_config: { thinking_budget: 0 },
+            },
+        });
+        const body = JSON.parse(capturedBody);
+        const modelParams = body.params.arguments.request.model_params;
+        expect(modelParams.temperature).toBe(0.5);
+        expect(modelParams.max_tokens).toBe(200);
+        // Untouched vendor-specific keys flow through
+        expect(modelParams.thinking_config).toEqual({ thinking_budget: 0 });
+    });
+    it("vendor-specific keys flow through untouched (no key translation)", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            return mockJsonResponse(mcpToolResponse(STUB_COMPLETION));
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, FN_BUFFERED, false);
+        const messages = [{ role: "user", content: "hi" }];
+        await provider.complete("anthropic/claude-sonnet-4-5", messages, undefined, {
+            modelParams: {
+                output_config: { format: { type: "json_schema", schema: { type: "object" } } },
+                extra_headers: { "x-vendor-flag": "1" },
+            },
+        });
+        const body = JSON.parse(capturedBody);
+        const modelParams = body.params.arguments.request.model_params;
+        expect(modelParams.output_config).toEqual({
+            format: { type: "json_schema", schema: { type: "object" } },
+        });
+        expect(modelParams.extra_headers).toEqual({ "x-vendor-flag": "1" });
+    });
+    it("absent modelParams → behavior unchanged (no model_params keys leak)", async () => {
+        let capturedBody;
+        const fetchMock = vi.fn(async (_url, init) => {
+            capturedBody = init.body;
+            return mockJsonResponse(mcpToolResponse(STUB_COMPLETION));
+        });
+        globalThis.fetch = fetchMock;
+        const provider = new MeshDelegatedProvider(ENDPOINT, FN_BUFFERED, false);
+        const messages = [{ role: "user", content: "hi" }];
+        // No options at all; model="default" so no model_params should be emitted.
+        await provider.complete("default", messages);
+        const body = JSON.parse(capturedBody);
+        const request = body.params.arguments.request;
+        expect(request.model_params).toBeUndefined();
+    });
+});
+// ----------------------------------------------------------------------------
+// streamComplete() — streaming path
+// ----------------------------------------------------------------------------
+describe("MeshDelegatedProvider.streamComplete() — modelParams escape hatch", () => {
+    let originalFetch;
+    beforeEach(() => {
+        originalFetch = globalThis.fetch;
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        vi.restoreAllMocks();
+    });
+    async function drain(gen) {
+        const out = [];
+        for await (const c of gen)
+            out.push(c);
+        return out;
+    }
+    it("merges modelParams into the streaming request and lets typed options win", 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, FN_STREAM, false);
+        const messages = [{ role: "user", content: "hi" }];
+        await drain(provider.streamComplete("anthropic/claude-sonnet-4-5", messages, undefined, {
+            temperature: 0.4,
+            modelParams: {
+                temperature: 0.9, // typed wins
+                thinking_config: { thinking_budget: 0 }, // flows through
+            },
+        }));
+        const body = JSON.parse(capturedBody);
+        const modelParams = body.params.arguments.request.model_params;
+        expect(modelParams.temperature).toBe(0.4);
+        expect(modelParams.thinking_config).toEqual({ thinking_budget: 0 });
+        expect(modelParams.model).toBe("anthropic/claude-sonnet-4-5");
+    });
+});
+//# sourceMappingURL=llm-agent-model-params.test.js.map

package/dist/__tests__/llm-agent-model-params.test.js.map

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

package/dist/index.d.ts

@@ -56,6 +56,7 @@ import { llm } from "./llm.js";
 import { llmProvider } from "./llm-provider.js";
 import { sseStream } from "./sse-stream.js";
 import { mount as a2aMount } from "./a2a/producer/index.js";
+import { postEvent as jobsPostEvent, subscribeEvents as jobsSubscribeEvents } from "./jobs.js";
 /**
  * `mesh.a2a` namespace — A2A v1.0 producer surface (issue #933).
  *
@@ -71,6 +72,18 @@ interface MeshA2ANamespace {
      */
     mount: typeof a2aMount;
 }
+/**
+ * `mesh.jobs` namespace — MeshJob event-injection convenience helpers
+ * (mirrors Python's `mesh.jobs` submodule shipped via PR #1041 for
+ * issue #1032). The `postEvent` helper lets MCP tool bodies push an
+ * event into a running job by id without holding a `JobProxy` reference
+ * in scope (the SDK resolves the registry URL from
+ * `MCP_MESH_REGISTRY_URL` and reuses a process-cached `JobProxy`).
+ */
+interface MeshJobsNamespace {
+    postEvent: typeof jobsPostEvent;
+    subscribeEvents: typeof jobsSubscribeEvents;
+}
 interface MeshNamespace {
     (server: import("fastmcp").FastMCP, config: import("./types.js").AgentConfig): MeshAgent;
     route: typeof route;
@@ -85,6 +98,8 @@ interface MeshNamespace {
     sseStream: typeof sseStream;
     /** A2A v1.0 producer surface (issue #933). */
     a2a: MeshA2ANamespace;
+    /** MeshJob event-injection helpers (mirrors Python `mesh.jobs`). */
+    jobs: MeshJobsNamespace;
 }
 /**
  * Main mesh function with route and llm helpers attached.
@@ -128,6 +143,7 @@ export { readJobHeaders, runWithJobContext, makeJobController, } from "./inbound
 export { ClaimDispatcher, type ClaimHandler, } from "./claim-dispatcher.js";
 export { registerJobHelperTools } from "./jobs-helper-tools.js";
 export { registerCancelRoute } from "./jobs-cancel-route.js";
+export { postEvent, subscribeEvents, JobNotFoundError, JobTerminalError, type JobEvent, type JobEventReceipt, type SubscribeEventsOptions, } from "./jobs.js";
 export { JobController, JobProxy } from "@mcpmesh/core";
 export { A2AClient, A2AJob, A2AStream, A2ABearer, A2AError, A2ATimeoutError, A2AAuthError, A2AJobError, A2AJobFailedError, A2AJobCanceledError, type A2AClientConfig, type A2ABearerConfig, type A2AMessage, type A2AResponse, type A2ATaskEnvelope, type A2AEvent, type A2AEventKind, } from "./a2a/index.js";
 export { A2AProducerRegistry, A2ATaskStore, buildAgentCard, buildBearerAuthMiddleware, buildCompletedTask, buildDispatcherMiddleware, buildFailedTask, buildWorkingTask, stringifyResult, TERMINAL_EVICTION_MS, DEFAULT_INPUT_MODES as A2A_DEFAULT_INPUT_MODES, DEFAULT_OUTPUT_MODES as A2A_DEFAULT_OUTPUT_MODES, JSONRPC_AUTH_ERROR as A2A_JSONRPC_AUTH_ERROR, JSONRPC_PARSE_ERROR as A2A_JSONRPC_PARSE_ERROR, JSONRPC_INVALID_REQUEST as A2A_JSONRPC_INVALID_REQUEST, JSONRPC_METHOD_NOT_FOUND as A2A_JSONRPC_METHOD_NOT_FOUND, JSONRPC_INVALID_PARAMS as A2A_JSONRPC_INVALID_PARAMS, type A2AMountConfig, type A2ASurfaceMetadata, type A2ADependencies, type A2AHandler, type CardRenderContext as A2ACardRenderContext, type TaskRecord as A2ATaskRecord, } from "./a2a/producer/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;GAOG;AACH,UAAU,gBAAgB;IACxB;;;OAGG;IACH,KAAK,EAAE,OAAO,QAAQ,CAAC;CACxB;AAKD,UAAU,aAAa;IACrB,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACzF,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,kGAAkG;IAClG,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,2DAA2D;IAC3D,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,2CAA2C;IAC3C,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,gFAAgF;IAChF,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,8CAA8C;IAC9C,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,IAAI,EAAE,aAQV,CAAC;AAGH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAK3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGhF,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,EACL,eAAe,EACf,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGnJ,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,GAAG,EACH,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,IAAI,qBAAqB,EAC3C,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,4BAA4B,EAC5B,cAAc,GACf,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EACf,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAMxD,OAAO,EACL,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,IAAI,uBAAuB,EAC9C,oBAAoB,IAAI,wBAAwB,EAChD,kBAAkB,IAAI,sBAAsB,EAC5C,mBAAmB,IAAI,uBAAuB,EAC9C,uBAAuB,IAAI,2BAA2B,EACtD,wBAAwB,IAAI,4BAA4B,EACxD,sBAAsB,IAAI,0BAA0B,EACpD,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,IAAI,oBAAoB,EAC9C,KAAK,UAAU,IAAI,aAAa,GACjC,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,YAAY,EAAE,8BAA8B;AAC5C,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAiB,EAEjB,eAAe,EACf,aAAa,EACb,aAAa,EACb,OAAO,EACP,WAAW,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACR,cAAc,EACd,YAAY,EAEZ,eAAe,EACf,cAAc,EACd,aAAa,EAEb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,iBAAiB,EAEjB,cAAc,EAEd,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,eAAe,IAAI,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -56,7 +56,12 @@ import { llm } from "./llm.js";
 import { llmProvider } from "./llm-provider.js";
 import { sseStream } from "./sse-stream.js";
 import { mount as a2aMount } from "./a2a/producer/index.js";
+import { postEvent as jobsPostEvent, subscribeEvents as jobsSubscribeEvents, } from "./jobs.js";
 const a2a = { mount: a2aMount };
+const jobs = {
+    postEvent: jobsPostEvent,
+    subscribeEvents: jobsSubscribeEvents,
+};
 /**
  * Main mesh function with route and llm helpers attached.
  *
@@ -75,6 +80,7 @@ const mesh = Object.assign(meshFn, {
     llmProvider,
     sseStream,
     a2a,
+    jobs,
 });
 // Main API
 export { mesh, MeshAgent };
@@ -132,6 +138,12 @@ export { readJobHeaders, runWithJobContext, makeJobController, } from "./inbound
 export { ClaimDispatcher, } from "./claim-dispatcher.js";
 export { registerJobHelperTools } from "./jobs-helper-tools.js";
 export { registerCancelRoute } from "./jobs-cancel-route.js";
+// MeshJob event-injection helpers + typed errors (mirrors Python
+// `mesh.jobs` shipped via PR #1041 for issue #1032). The
+// `mesh.jobs.postEvent` helper is the primary surface; the error
+// classes are exported so consumers can `instanceof`-discriminate
+// against the napi binding's generic Error.
+export { postEvent, subscribeEvents, JobNotFoundError, JobTerminalError, } from "./jobs.js";
 // Re-export napi-rs job primitives for users who want to drop down
 // to the underlying handles directly (e.g. constructing a JobProxy
 // from a known job_id).

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAkB5D,MAAM,GAAG,GAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAmBlD;;;;;;;;;GASG;AACH,MAAM,IAAI,GAAkB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;IAChD,KAAK;IACL,eAAe;IACf,IAAI,EAAE,aAAa;IACnB,GAAG;IACH,WAAW;IACX,SAAS;IACT,GAAG;CACJ,CAAC,CAAC;AAEH,WAAW;AACX,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAE3B,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,qEAAqE;AACrE,kEAAkE;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,uEAAuE;AACvE,wEAAwE;AACxE,8BAA8B;AAC9B,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3E,mFAAmF;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,WAAW,EAA0B,MAAM,cAAc,CAAC;AAEhF,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,KAAK,EACL,eAAe,EACf,aAAa,GAMd,MAAM,YAAY,CAAC;AAEpB,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,cAAc,EAAE,aAAa,EAA2B,MAAM,YAAY,CAAC;AAEnJ,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AAEtB,gBAAgB;AAChB,OAAO,EACL,GAAG,EACH,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,SAAS,GAIV,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,GAInB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,8BAA8B;AAC9B,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,aAAa,GAQd,MAAM,8BAA8B,CAAC;AAEtC,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAIhB,MAAM,kBAAkB,CAAC;AAE1B,oEAAoE;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,IAAI,qBAAqB,EAC3C,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,kBAAkB;AAClB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,4BAA4B,EAC5B,cAAc,GACf,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,aAAa,GAId,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,mEAAmE;AACnE,mEAAmE;AACnE,wBAAwB;AACxB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExD,wEAAwE;AACxE,uEAAuE;AACvE,sEAAsE;AACtE,qEAAqE;AACrE,OAAO,EACL,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GAQpB,MAAM,gBAAgB,CAAC;AAExB,4EAA4E;AAC5E,wEAAwE;AACxE,0DAA0D;AAC1D,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,IAAI,uBAAuB,EAC9C,oBAAoB,IAAI,wBAAwB,EAChD,kBAAkB,IAAI,sBAAsB,EAC5C,mBAAmB,IAAI,uBAAuB,EAC9C,uBAAuB,IAAI,2BAA2B,EACtD,wBAAwB,IAAI,4BAA4B,EACxD,sBAAsB,IAAI,0BAA0B,GAOrD,MAAM,yBAAyB,CAAC;AAqDjC,iCAAiC;AACjC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/jobs.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Public `mesh.jobs` namespace — convenience helpers for the MeshJob
+ * event-injection primitive (Phase 1, MeshJob substrate; event-channel
+ * extension landed in v2.2).
+ *
+ * The primary surfaces are:
+ *
+ *   - {@link postEvent} — fire-and-forget helper to push an event into a
+ *     running job by id, without holding a `JobProxy` reference. Intended
+ *     for MCP tool bodies that receive a `jobId` in their request payload
+ *     (e.g. a "submit_user_input" tool exposed by an orchestrator agent).
+ *
+ *   - {@link JobNotFoundError} / {@link JobTerminalError} — typed `Error`
+ *     subclasses translated from the Rust core's `JobError` variants. The
+ *     napi binding surfaces all `JobError` variants as a plain `Error`
+ *     today (see `src/runtime/core/src/jobs_napi.rs::job_error_to_napi`),
+ *     so we re-classify on the TypeScript side via stable
+ *     error-message substrings ("job is terminal" / "job not found").
+ *
+ * The `JobController` / `JobProxy` napi-rs classes from `@mcpmesh/core`
+ * already expose `recvEvent` / `sendEvent` methods directly — application
+ * code calls them via the `MeshJob`-typed parameter the framework
+ * injects. This module just adds the helper + error classes around that
+ * surface, mirroring Python's `mesh.jobs.post_event` API one-for-one.
+ */
+import { JobProxy } from "@mcpmesh/core";
+/**
+ * Event posted into a running job's event log. Matches the OpenAPI
+ * `JobEvent` schema field-for-field (and the Rust `JobEvent` /
+ * Python `job_event_to_pydict` shape). Returned by `JobController.recvEvent`.
+ */
+export interface JobEvent {
+    /** Server-assigned job UUID this event belongs to. */
+    job_id: string;
+    /** Per-job monotonic sequence number assigned by the registry. */
+    seq: number;
+    /** User-supplied event type tag (e.g. "signal", "user_input"). */
+    type: string;
+    /** Arbitrary JSON-shaped payload carried with the event (or `null`). */
+    payload: unknown;
+    /** W3C trace context propagated by the poster (or `null`). */
+    trace_context: unknown;
+    /** Identifier of the agent that posted the event (or `null`). */
+    posted_by: string | null;
+    /** Unix epoch seconds at which the registry created the row. */
+    created_at: number;
+}
+/**
+ * Receipt returned by `JobProxy.sendEvent` / `postEvent`. Matches the
+ * OpenAPI `JobEventPostResponse` schema field-for-field.
+ */
+export interface JobEventReceipt {
+    /** Server-assigned job UUID the event was posted into. */
+    job_id: string;
+    /** Per-job monotonic sequence number assigned by the registry. */
+    seq: number;
+    /** Unix epoch seconds at which the registry created the row. */
+    created_at: number;
+}
+/**
+ * The targeted job does not exist (or has been swept) in the registry.
+ *
+ * Translated from the Rust `JobError::Other(BackendError::NotFound)`
+ * path (`GET/POST /jobs/{id}/events` → HTTP 404).
+ */
+export declare class JobNotFoundError extends Error {
+    readonly name = "JobNotFoundError";
+    constructor(message: string);
+}
+/**
+ * The targeted job is in a terminal state (completed / failed /
+ * cancelled) and no longer accepts events.
+ *
+ * Translated from the Rust `JobError::JobTerminal` variant — the
+ * registry returns HTTP 409 once the job row is terminal and the Rust
+ * layer maps that to `JobTerminal`.
+ */
+export declare class JobTerminalError extends Error {
+    readonly name = "JobTerminalError";
+    constructor(message: string);
+}
+/**
+ * Re-classify a generic `Error` raised by the napi layer into one of the
+ * typed subclasses, if the message matches. Returns the original error
+ * (or a typed clone) — callers should `throw` the returned value.
+ *
+ * Exported so tests can exercise the substring contract without a real
+ * napi failure path.
+ */
+export declare function translateJobError(err: unknown): unknown;
+/**
+ * Return a process-cached `JobProxy` for the given
+ * `(registryUrl, jobId)` pair, constructing one on first miss.
+ *
+ * Cache is a bounded LRU: hits bump the entry to the most-recent end of
+ * the insertion-order map, misses on a full cache evict the
+ * least-recent entry before inserting. Exported only for tests; not
+ * part of the public API.
+ */
+export declare function _getOrCreateProxy(registryUrl: string, jobId: string): JobProxy;
+/**
+ * Clear the JobProxy cache. Exposed for tests — not part of the public
+ * API. Equivalent to dropping all entries; the underlying napi handles
+ * are released when JS GC runs.
+ */
+export declare function _clearProxyCache(): void;
+/**
+ * Post an event to a running job by ID.
+ *
+ * Convenience helper for tool bodies that hold a `jobId` (e.g. from a
+ * request body, a token lookup, or a stashed reference) but do NOT
+ * have a `JobProxy` reference in scope. Constructs (or reuses, via the
+ * LRU cache) a `JobProxy` bound to the current agent's registry URL
+ * and forwards the call.
+ *
+ * Mirrors Python's `mesh.jobs.post_event` API one-for-one.
+ *
+ * @param jobId - Target job's server-assigned id.
+ * @param eventType - Event type tag (e.g. `"extend_deadline"`,
+ *   `"user_input"`, or any user-defined string). The running handler
+ *   can filter via `await job.recvEvent(["..."])`.
+ * @param payload - Optional JSON-serializable payload carried with the
+ *   event. `undefined`/`null` is normalized to an empty object before
+ *   forwarding — the Rust layer accepts either.
+ * @returns Receipt `{ job_id, seq, created_at }`. `seq` is the
+ *   server-assigned sequence number useful for stitching follow-up
+ *   `recvEvent` calls.
+ *
+ * @throws {@link JobNotFoundError} If the registry doesn't know the
+ *   job (sweep already removed it, or wrong id).
+ * @throws {@link JobTerminalError} If the job has already reached a
+ *   terminal state — no more events accepted.
+ * @throws Error For transport errors (registry unreachable, 5xx after
+ *   retries, malformed payload, etc.) — the underlying error message
+ *   is preserved.
+ *
+ * @example
+ * Inside an MCP tool body that holds a job id:
+ * ```ts
+ * agent.addTool({
+ *   name: "submit_user_input",
+ *   capability: "submit_user_input",
+ *   parameters: z.object({ jobId: z.string(), text: z.string() }),
+ *   execute: async ({ jobId, text }) => {
+ *     const receipt = await mesh.jobs.postEvent(
+ *       jobId,
+ *       "user_input",
+ *       { text },
+ *     );
+ *     return { posted_seq: receipt.seq };
+ *   },
+ * });
+ * ```
+ */
+export declare function postEvent(jobId: string, eventType: string, payload?: unknown): Promise<JobEventReceipt>;
+/**
+ * Options for {@link subscribeEvents}. All fields are optional —
+ * defaults match Python's `mesh.jobs.subscribe_events` keyword args.
+ */
+export interface SubscribeEventsOptions {
+    /**
+     * Optional event-type filter applied server-side. Only events whose
+     * `type` matches one of these is yielded. Omit for all types.
+     */
+    types?: string[];
+    /**
+     * Initial cursor (default `0` ≡ from the beginning of the event log).
+     * Pass a higher value to skip historical events. Accepts both
+     * `number` and `bigint` for callers stitching from an `i64`-sourced
+     * cursor.
+     */
+    after?: number | bigint;
+    /**
+     * Long-poll wait budget per registry call (in seconds). Default `30`.
+     * Capped at `60` by the registry. Pass `null` to skip the long-poll
+     * entirely (single immediate read; rarely needed — tight-poll callers
+     * should pass `0` instead).
+     */
+    longPollSecs?: number | null;
+}
+/**
+ * Subscribe to events posted to a running job by ID.
+ *
+ * Long-lived async iterator. Each call manages its own cursor —
+ * multiple subscribers can observe the same job's events independently
+ * without affecting the producer's `recvEvent` consumption (the
+ * producer's cursor is per-controller; this observer's cursor is
+ * per-call).
+ *
+ * The iterator runs indefinitely until the caller breaks out of the
+ * `for await` loop or the underlying registry returns
+ * {@link JobNotFoundError}. There is no automatic terminal-state
+ * detection — use a synthetic event type (e.g. `{ type: "ended" }`)
+ * posted by your application to signal iteration end.
+ *
+ * Mirrors Python's `mesh.jobs.subscribe_events` one-for-one.
+ *
+ * @param jobId - Target job's server-assigned id.
+ * @param options - Optional filter / cursor / long-poll knobs.
+ * @yields Event objects: `{ seq, type, payload, trace_context,
+ *   posted_by, created_at, job_id }`.
+ *
+ * @throws {@link JobNotFoundError} If the job has been reaped from the
+ *   registry (404 on the `GET /jobs/{id}/events` endpoint).
+ * @throws Error For transport errors (registry unreachable, 5xx after
+ *   retries, malformed payload, etc.) — the underlying error message
+ *   is preserved.
+ *
+ * @example
+ * Mirror events from a running job into a downstream system:
+ * ```ts
+ * for await (const event of mesh.jobs.subscribeEvents(jobId, {
+ *   types: ["progress", "result"],
+ * })) {
+ *   await downstream.publish(event);
+ *   if (event.type === "result") break; // caller-defined termination
+ * }
+ * ```
+ */
+export declare function subscribeEvents(jobId: string, options?: SubscribeEventsOptions): AsyncGenerator<JobEvent, void, unknown>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAoBD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,sBAAsB;gBACvB,OAAO,EAAE,MAAM;CAG5B;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,sBAAsB;gBACvB,OAAO,EAAE,MAAM;CAG5B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAwBvD;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAuB9E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,eAAe,CAAC,CAc1B;AAMD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAuB,eAAe,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,sBAA2B,GACnC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAmEzC"}