@mcpmesh/sdk 1.4.1 → 2.0.0-beta.1

package/dist/a2a/producer/sse-emitter.js

@@ -0,0 +1,405 @@
+import { buildArtifactUpdateFrame, buildResubscribeStream, buildSendSubscribeStream, buildStatusUpdateFrame, buildTaskFromStatus, JSONRPC_PARSE_ERROR, } from "./dispatcher.js";
+import { A2A_COMPLETED, A2A_FAILED, A2A_CANCELED, A2A_WORKING, fromMesh, isMeshTerminal, meshStatusOf, } from "./state-translator.js";
+/** Poll cadence for the long-running stream (spec §4.6 sequence diagram: 1s). */
+export const POLL_INTERVAL_MILLIS = 1000;
+/** Keepalive interval — SSE comment frame after this much inactivity (spec §5.1: 15s). */
+export const KEEPALIVE_MILLIS = 15_000;
+/** Maximum total stream duration as a defensive cap (1 hour, matches Java). */
+export const MAX_STREAM_MILLIS = 60 * 60_000;
+/**
+ * Consecutive `proxy.status()` failures to tolerate during the SSE poll
+ * loop before giving up. Spec §4.4: transient unreachability is NOT
+ * authoritative evidence the job is dead, so we keep emitting
+ * `state=working` status frames and continue polling until this cap.
+ * Once reached we close the SSE stream WITHOUT marking the task store
+ * record terminal — subsequent `tasks/get` resumes polling normally.
+ *
+ * Matches Java's `MAX_CONSECUTIVE_STATUS_FAILURES`.
+ */
+export const MAX_CONSECUTIVE_STATUS_FAILURES = 5;
+/**
+ * Build the SSE dispatcher middleware. Mounted in front of the JSON-RPC
+ * dispatcher: when the request body's `method` is `tasks/sendSubscribe`
+ * or `tasks/resubscribe`, this middleware consumes the request and
+ * streams an SSE response. Otherwise it calls `next()` and execution
+ * falls through to the JSON-RPC dispatcher.
+ *
+ * The middleware peeks at the parsed body (`req.body.method`) rather
+ * than `Accept` header — even when the client sends both, we want to
+ * route by JSON-RPC method to keep the dispatch deterministic.
+ */
+export function buildSseDispatcherMiddleware(deps) {
+    return async function a2aSseDispatcher(req, res, next) {
+        const body = req.body;
+        if (!body || typeof body !== "object" || Array.isArray(body)) {
+            // Let the JSON-RPC dispatcher emit the canonical parse error.
+            next();
+            return;
+        }
+        const envelope = body;
+        const method = envelope["method"];
+        if (method !== "tasks/sendSubscribe" && method !== "tasks/resubscribe") {
+            next();
+            return;
+        }
+        const reqId = Object.prototype.hasOwnProperty.call(envelope, "id")
+            ? envelope["id"]
+            : null;
+        const params = readParams(envelope["params"]);
+        let plan;
+        try {
+            if (method === "tasks/sendSubscribe") {
+                plan = await buildSendSubscribeStream(reqId, params, deps);
+            }
+            else {
+                plan = buildResubscribeStream(reqId, params, deps.taskStore);
+            }
+        }
+        catch (err) {
+            // Unexpected dispatcher error — surface as a JSON-RPC parse
+            // error (HTTP 400) so the client can distinguish it from an SSE
+            // mid-stream failure.
+            res.status(400).type("application/json").send(JSON.stringify({
+                jsonrpc: "2.0",
+                error: {
+                    code: JSONRPC_PARSE_ERROR,
+                    message: `Dispatcher error: ${err?.message ?? String(err)}`,
+                },
+                id: reqId ?? null,
+            }));
+            return;
+        }
+        await renderSsePlan(req, res, plan, deps.taskStore);
+    };
+}
+/**
+ * Materialise an SSE stream-plan as an Express response. Exposed for
+ * advanced wiring / tests; the public mount API calls this via the
+ * middleware above.
+ */
+export async function renderSsePlan(req, res, plan, taskStore) {
+    switch (plan.kind) {
+        case "error": {
+            res
+                .status(plan.httpStatus)
+                .type("application/json")
+                .send(JSON.stringify(plan.errorBody));
+            return;
+        }
+        case "single-frame": {
+            writeSseHeaders(res);
+            writeDataFrame(res, plan.frame);
+            endSse(res);
+            return;
+        }
+        case "sync-completed": {
+            writeSseHeaders(res);
+            writeDataFrame(res, plan.artifactFrame);
+            writeDataFrame(res, plan.terminalFrame);
+            endSse(res);
+            return;
+        }
+        case "long-running": {
+            writeSseHeaders(res);
+            await runLongRunningStream(req, res, plan.reqId, plan.taskId, plan.proxy, taskStore);
+            endSse(res);
+            return;
+        }
+        default: {
+            const exhaustive = plan;
+            throw new Error(`Unknown SSE plan kind: ${JSON.stringify(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Run the long-running poll loop (spec §5.3 long-running case):
+ *
+ *  1. Emit an initial `state=working, final=false` frame so the client
+ *     confirms subscription liveness.
+ *  2. Poll `proxy.status()` every {@link POLL_INTERVAL_MILLIS} ms.
+ *  3. Emit a `state=working` frame only when `progress` or
+ *     `progress_message` changed — suppresses redundant updates
+ *     (Python `a2a.py:1057-1070`, Java's equivalent).
+ *  4. Emit a `: keepalive\n\n` SSE comment after {@link KEEPALIVE_MILLIS}
+ *     of inactivity.
+ *  5. On terminal mesh state: attempt `proxy.wait(1.0)` for the completed
+ *     branch, emit the artifact frame, then the terminal status frame
+ *     (`final=true`), mark the task store record terminal, return.
+ */
+async function runLongRunningStream(req, res, reqId, taskId, proxy, taskStore) {
+    const started = Date.now();
+    let disconnected = false;
+    const onClose = () => {
+        disconnected = true;
+    };
+    req.on("close", onClose);
+    res.on("close", onClose);
+    try {
+        // 1. Initial state=working frame.
+        if (!writeDataFrame(res, buildStatusUpdateFrame(reqId, taskId, A2A_WORKING, null, false, null))) {
+            return;
+        }
+        let lastProgress = undefined;
+        let lastMessage = undefined;
+        let lastEventTime = Date.now();
+        let consecutiveStatusFailures = 0;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            if (disconnected || res.writableEnded || res.destroyed) {
+                return;
+            }
+            // Stream-level cap — preserves task state in the store so callers
+            // can resume via tasks/resubscribe or check status via tasks/get.
+            // The cap protects the worker from a stuck job; it is NOT a
+            // job-death signal, so we emit a non-terminal status frame and
+            // do NOT mark the task terminal (spec §4.4: producer-side resource
+            // limits must not poison the task store).
+            if (Date.now() - started > MAX_STREAM_MILLIS) {
+                writeDataFrame(res, buildStatusUpdateFrame(reqId, taskId, A2A_WORKING, "stream closed: producer-side cap exceeded " +
+                    "(task still running; reconnect via tasks/resubscribe)", 
+                // final=false: the task is NOT terminal; we are only closing
+                // the SSE transport. `final=true` would signal task death to
+                // A2A clients.
+                false, null));
+                return;
+            }
+            let status;
+            try {
+                const raw = (await proxy.status());
+                status = (raw && typeof raw === "object" && !Array.isArray(raw))
+                    ? raw
+                    : {};
+                consecutiveStatusFailures = 0;
+            }
+            catch (err) {
+                consecutiveStatusFailures++;
+                // Spec §4.4 conformance: transient unreachability is NOT
+                // authoritative evidence the job is dead. Emit state=working
+                // carrying the error in status.message and CONTINUE polling.
+                // Do NOT mark the task store terminal.
+                if (!writeDataFrame(res, buildStatusUpdateFrame(reqId, taskId, A2A_WORKING, `status unavailable: ${errorTextOf(err)}`, false, null))) {
+                    return;
+                }
+                // Transient-failure frame counts as activity — refresh
+                // `lastEventTime` so the keepalive branch doesn't fire a
+                // redundant `: keepalive\n\n` right after a data frame.
+                lastEventTime = Date.now();
+                if (consecutiveStatusFailures >= MAX_CONSECUTIVE_STATUS_FAILURES) {
+                    // Cap hit — close the stream WITHOUT marking terminal so the
+                    // client can retry via tasks/get / tasks/resubscribe.
+                    return;
+                }
+                if (!(await sleepIfConnected(POLL_INTERVAL_MILLIS, req, res))) {
+                    return;
+                }
+                continue;
+            }
+            const meshState = meshStatusOf(status);
+            if (isMeshTerminal(meshState)) {
+                const a2aState = fromMesh(meshState);
+                let finalResult = null;
+                let hasFinalResult = false;
+                if (a2aState === A2A_COMPLETED) {
+                    try {
+                        finalResult = await proxy.wait(1.0);
+                        hasFinalResult = true;
+                        // Emit artifact frame BEFORE the terminal status — spec
+                        // §5.3 ordering.
+                        if (!writeDataFrame(res, buildArtifactUpdateFrame(reqId, taskId, finalResult))) {
+                            return;
+                        }
+                    }
+                    catch {
+                        // Best-effort: if wait() throws we skip the artifact and
+                        // emit only the terminal status frame.
+                    }
+                }
+                let finalMessage = null;
+                if (a2aState === A2A_FAILED) {
+                    const err = status["error"];
+                    finalMessage = (err !== null && err !== undefined && String(err).length > 0)
+                        ? String(err)
+                        : null;
+                    if (!finalMessage) {
+                        const pm = status["progress_message"];
+                        finalMessage = (pm !== null && pm !== undefined && String(pm).length > 0)
+                            ? String(pm)
+                            : null;
+                    }
+                }
+                else if (a2aState === A2A_CANCELED) {
+                    const pm = status["progress_message"];
+                    finalMessage = (pm !== null && pm !== undefined && String(pm).length > 0)
+                        ? String(pm)
+                        : null;
+                }
+                writeDataFrame(res, buildStatusUpdateFrame(reqId, taskId, a2aState, finalMessage, true, null));
+                // Cache the terminal envelope so subsequent tasks/get returns
+                // the same view as this stream's terminal frame.
+                const terminalEnvelope = buildTaskFromStatus(taskId, taskId, undefined, a2aState, status, finalResult, hasFinalResult);
+                taskStore.markTerminal(taskId, terminalEnvelope);
+                return;
+            }
+            const progress = status["progress"];
+            const progressMessage = status["progress_message"];
+            const now = Date.now();
+            const progressChanged = !primitiveOrNullishEqual(progress, lastProgress);
+            const messageChanged = !primitiveOrNullishEqual(progressMessage, lastMessage);
+            if (progressChanged || messageChanged) {
+                const msgText = (progressMessage !== null && progressMessage !== undefined)
+                    ? String(progressMessage)
+                    : null;
+                const progressNum = typeof progress === "number" ? progress : null;
+                if (!writeDataFrame(res, buildStatusUpdateFrame(reqId, taskId, A2A_WORKING, msgText, false, progressNum))) {
+                    return;
+                }
+                lastProgress = progress;
+                lastMessage = progressMessage;
+                lastEventTime = now;
+            }
+            else if (now - lastEventTime > KEEPALIVE_MILLIS) {
+                // Spec §5.1: SSE comment line, ignored by parsers but resets
+                // proxy idle timers.
+                if (!writeKeepalive(res)) {
+                    return;
+                }
+                lastEventTime = now;
+            }
+            if (!(await sleepIfConnected(POLL_INTERVAL_MILLIS, req, res))) {
+                return;
+            }
+        }
+    }
+    finally {
+        req.removeListener("close", onClose);
+        res.removeListener("close", onClose);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Low-level SSE write helpers
+// ─────────────────────────────────────────────────────────────────────────
+function writeSseHeaders(res) {
+    // Spec §4.6 / §5.1.
+    res.status(200);
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    // Defeats nginx response buffering.
+    res.setHeader("X-Accel-Buffering", "no");
+    // Flush headers so the client confirms subscription liveness before
+    // the first frame arrives.
+    if (typeof res.flushHeaders === "function") {
+        res.flushHeaders();
+    }
+}
+/**
+ * Write one JSON-RPC envelope as an SSE `data:` frame. Returns `false`
+ * when the response is no longer writable (client disconnected) so
+ * callers can exit the loop without calling `JobProxy.cancel()` per spec
+ * §7.3.
+ */
+function writeDataFrame(res, envelope) {
+    if (res.writableEnded || res.destroyed) {
+        return false;
+    }
+    try {
+        const json = JSON.stringify(envelope);
+        const written = res.write(`data: ${json}\n\n`);
+        return written !== false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write a raw SSE comment line (`: keepalive\n\n`). Spec §5.1 keepalive
+ * contract. Returns `false` on client disconnect.
+ */
+function writeKeepalive(res) {
+    if (res.writableEnded || res.destroyed) {
+        return false;
+    }
+    try {
+        const written = res.write(": keepalive\n\n");
+        return written !== false;
+    }
+    catch {
+        return false;
+    }
+}
+function endSse(res) {
+    if (res.writableEnded || res.destroyed)
+        return;
+    try {
+        res.end();
+    }
+    catch {
+        // best-effort
+    }
+}
+/**
+ * Sleep for `ms` milliseconds, returning `false` if the client
+ * disconnected during the wait. Resolves early on `req`/`res` close so
+ * the poll loop exits promptly.
+ */
+function sleepIfConnected(ms, req, res) {
+    return new Promise((resolve) => {
+        if (res.writableEnded || res.destroyed) {
+            resolve(false);
+            return;
+        }
+        let resolved = false;
+        const done = (ok) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timer);
+            req.removeListener("close", onClose);
+            res.removeListener("close", onClose);
+            resolve(ok);
+        };
+        const onClose = () => done(false);
+        const timer = setTimeout(() => done(true), ms);
+        req.on("close", onClose);
+        res.on("close", onClose);
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────
+// Misc helpers
+// ─────────────────────────────────────────────────────────────────────────
+function readParams(params) {
+    if (params === null || params === undefined)
+        return {};
+    if (typeof params !== "object" || Array.isArray(params))
+        return {};
+    return params;
+}
+function errorTextOf(err) {
+    if (err instanceof Error) {
+        return err.message || err.name || "Error";
+    }
+    if (typeof err === "string")
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+/**
+ * Cheap equality for primitives + the few non-primitive shapes the
+ * status payload can hold (we only ever compare `progress` (number or
+ * undefined) and `progress_message` (string or undefined). A full deep
+ * equal would be overkill.
+ */
+function primitiveOrNullishEqual(a, b) {
+    if (a === b)
+        return true;
+    // Treat null == undefined for the change-detect heuristic so
+    // toggling between absent and null doesn't spam frames.
+    if (a == null && b == null)
+        return true;
+    return false;
+}
+//# sourceMappingURL=sse-emitter.js.map

package/dist/a2a/producer/sse-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-emitter.js","sourceRoot":"","sources":["../../../src/a2a/producer/sse-emitter.ts"],"names":[],"mappings":"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"}

package/dist/a2a/producer/state-translator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Mesh job lifecycle ↔ A2A v1.0 state translation (spec §7.2).
+ *
+ * The mesh job substrate emits these internal statuses:
+ * - `working`, `completed`, `failed`, `cancelled` (UK spelling)
+ *
+ * A2A v1.0 uses:
+ * - `working`, `completed`, `failed`, `canceled` (US spelling)
+ *
+ * The UK ↔ US spelling boundary is the most error-prone part of the
+ * translation (spec Appendix B item flagged). Consumers accept both
+ * spellings; producers MUST emit the US form.
+ *
+ * Unknown / unset mesh statuses fall back to `working` — preserves the
+ * invariant that we never emit an A2A state outside the spec's enumerated
+ * set, even when the registry reports a status we haven't mapped. Mirrors
+ * Java's `MeshA2AStateTranslator.fromMesh` exactly.
+ */
+/** A2A v1.0 state: task submitted (conceptual — never actually emitted by the producer). */
+export declare const A2A_SUBMITTED = "submitted";
+/** A2A v1.0 state: long-running task in flight. */
+export declare const A2A_WORKING = "working";
+/** A2A v1.0 terminal state: task finished successfully. */
+export declare const A2A_COMPLETED = "completed";
+/** A2A v1.0 terminal state: handler raised or job failed. */
+export declare const A2A_FAILED = "failed";
+/** A2A v1.0 terminal state: task canceled (US spelling). */
+export declare const A2A_CANCELED = "canceled";
+/**
+ * Translate a mesh job status string to its A2A v1.0 equivalent.
+ *
+ * Mapping table:
+ * - `pending` → `submitted` (conceptual; mesh produces it briefly before claim)
+ * - `working` / `running` → `working`
+ * - `completed` → `completed`
+ * - `failed` → `failed`
+ * - `cancelled` (UK) / `canceled` (US) → `canceled` (US — A2A spelling)
+ * - `cancelling` → `working` (still in progress; cancel signal in flight)
+ * - anything else / null / empty → `working` (fallback)
+ *
+ * @param meshStatus the mesh-side status string (may be `null`/`undefined`)
+ * @returns one of the four A2A v1.0 enumerated states; never `null`
+ */
+export declare function fromMesh(meshStatus: string | null | undefined): string;
+/**
+ * @returns `true` when the A2A state is one of the three terminal values
+ *     (`completed` / `failed` / `canceled`).
+ */
+export declare function isTerminal(a2aState: string | null | undefined): boolean;
+/**
+ * @returns `true` when the mesh status string represents a terminal state.
+ *     Accepts both UK and US `canceled` spellings (the mesh substrate emits
+ *     `cancelled` but a normalizer upstream may have already translated).
+ */
+export declare function isMeshTerminal(meshStatus: string | null | undefined): boolean;
+/**
+ * Extract the mesh-side status string from a `proxy.status()` payload.
+ *
+ * Returns `null` when the payload lacks a recognisable status field —
+ * callers default to `working` via {@link fromMesh}.
+ */
+export declare function meshStatusOf(statusPayload: Record<string, unknown> | null | undefined): string | null;
+//# sourceMappingURL=state-translator.d.ts.map

package/dist/a2a/producer/state-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-translator.d.ts","sourceRoot":"","sources":["../../../src/a2a/producer/state-translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,mDAAmD;AACnD,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,2DAA2D;AAC3D,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,6DAA6D;AAC7D,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,4DAA4D;AAC5D,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CA0BtE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxD,MAAM,GAAG,IAAI,CAOf"}

package/dist/a2a/producer/state-translator.js

@@ -0,0 +1,108 @@
+/**
+ * Mesh job lifecycle ↔ A2A v1.0 state translation (spec §7.2).
+ *
+ * The mesh job substrate emits these internal statuses:
+ * - `working`, `completed`, `failed`, `cancelled` (UK spelling)
+ *
+ * A2A v1.0 uses:
+ * - `working`, `completed`, `failed`, `canceled` (US spelling)
+ *
+ * The UK ↔ US spelling boundary is the most error-prone part of the
+ * translation (spec Appendix B item flagged). Consumers accept both
+ * spellings; producers MUST emit the US form.
+ *
+ * Unknown / unset mesh statuses fall back to `working` — preserves the
+ * invariant that we never emit an A2A state outside the spec's enumerated
+ * set, even when the registry reports a status we haven't mapped. Mirrors
+ * Java's `MeshA2AStateTranslator.fromMesh` exactly.
+ */
+/** A2A v1.0 state: task submitted (conceptual — never actually emitted by the producer). */
+export const A2A_SUBMITTED = "submitted";
+/** A2A v1.0 state: long-running task in flight. */
+export const A2A_WORKING = "working";
+/** A2A v1.0 terminal state: task finished successfully. */
+export const A2A_COMPLETED = "completed";
+/** A2A v1.0 terminal state: handler raised or job failed. */
+export const A2A_FAILED = "failed";
+/** A2A v1.0 terminal state: task canceled (US spelling). */
+export const A2A_CANCELED = "canceled";
+/**
+ * Translate a mesh job status string to its A2A v1.0 equivalent.
+ *
+ * Mapping table:
+ * - `pending` → `submitted` (conceptual; mesh produces it briefly before claim)
+ * - `working` / `running` → `working`
+ * - `completed` → `completed`
+ * - `failed` → `failed`
+ * - `cancelled` (UK) / `canceled` (US) → `canceled` (US — A2A spelling)
+ * - `cancelling` → `working` (still in progress; cancel signal in flight)
+ * - anything else / null / empty → `working` (fallback)
+ *
+ * @param meshStatus the mesh-side status string (may be `null`/`undefined`)
+ * @returns one of the four A2A v1.0 enumerated states; never `null`
+ */
+export function fromMesh(meshStatus) {
+    if (!meshStatus) {
+        return A2A_WORKING;
+    }
+    switch (meshStatus) {
+        case "pending":
+            return A2A_SUBMITTED;
+        case "working":
+        case "running":
+            return A2A_WORKING;
+        case "completed":
+            return A2A_COMPLETED;
+        case "failed":
+            return A2A_FAILED;
+        case "cancelled":
+        case "canceled":
+            return A2A_CANCELED;
+        case "cancelling":
+        case "canceling":
+            // Still in progress; cancel signal in flight but the job has not
+            // yet observed the cancel. Surfaces as `working` so clients keep
+            // polling — they'll see `canceled` once the job acknowledges.
+            return A2A_WORKING;
+        default:
+            return A2A_WORKING;
+    }
+}
+/**
+ * @returns `true` when the A2A state is one of the three terminal values
+ *     (`completed` / `failed` / `canceled`).
+ */
+export function isTerminal(a2aState) {
+    return (a2aState === A2A_COMPLETED ||
+        a2aState === A2A_FAILED ||
+        a2aState === A2A_CANCELED);
+}
+/**
+ * @returns `true` when the mesh status string represents a terminal state.
+ *     Accepts both UK and US `canceled` spellings (the mesh substrate emits
+ *     `cancelled` but a normalizer upstream may have already translated).
+ */
+export function isMeshTerminal(meshStatus) {
+    if (!meshStatus)
+        return false;
+    return (meshStatus === "completed" ||
+        meshStatus === "failed" ||
+        meshStatus === "cancelled" ||
+        meshStatus === "canceled");
+}
+/**
+ * Extract the mesh-side status string from a `proxy.status()` payload.
+ *
+ * Returns `null` when the payload lacks a recognisable status field —
+ * callers default to `working` via {@link fromMesh}.
+ */
+export function meshStatusOf(statusPayload) {
+    if (!statusPayload || typeof statusPayload !== "object") {
+        return null;
+    }
+    const s = statusPayload["status"];
+    if (s === null || s === undefined)
+        return null;
+    return typeof s === "string" ? s : String(s);
+}
+//# sourceMappingURL=state-translator.js.map

package/dist/a2a/producer/state-translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-translator.js","sourceRoot":"","sources":["../../../src/a2a/producer/state-translator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AACnC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAqC;IAC5D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,aAAa,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;QACpB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,YAAY,CAAC;QACtB,KAAK,YAAY,CAAC;QAClB,KAAK,WAAW;YACd,iEAAiE;YACjE,iEAAiE;YACjE,8DAA8D;YAC9D,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAmC;IAC5D,OAAO,CACL,QAAQ,KAAK,aAAa;QAC1B,QAAQ,KAAK,UAAU;QACvB,QAAQ,KAAK,YAAY,CAC1B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAqC;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,CACL,UAAU,KAAK,WAAW;QAC1B,UAAU,KAAK,QAAQ;QACvB,UAAU,KAAK,WAAW;QAC1B,UAAU,KAAK,UAAU,CAC1B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,aAAyD;IAEzD,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAI,aAAyC,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}