@mcpmesh/sdk 1.4.1 → 2.0.0-beta.1

package/dist/a2a/a2a-client.js

@@ -0,0 +1,405 @@
+/**
+ * Thin A2A v1.0 client — sync `tasks/send` + non-blocking `submit` +
+ * SSE `subscribe` (issue #917).
+ *
+ * One instance per (url, skillId, auth, timeout) tuple — the framework
+ * caches and re-uses clients across tool invocations so the underlying
+ * undici connection pool is amortised. Mirrors
+ * `mesh._a2a_consumer.A2AClient` (Python) and
+ * `io.mcpmesh.a2a.A2AClient` (Java) — same JSON-RPC envelope shape +
+ * polling backoff + auth header semantics.
+ */
+import { randomUUID } from "node:crypto";
+import { getDispatcher } from "../http-pool.js";
+import { resolveBearer, } from "./a2a-bearer.js";
+import { A2AAuthError, A2AError, A2ATimeoutError, } from "./errors.js";
+import { A2AJob } from "./a2a-job.js";
+import { A2AStream } from "./a2a-stream.js";
+/** Default per-call deadline for `send`. */
+export const DEFAULT_TIMEOUT_MS = 30_000;
+/** Initial poll interval for `tasks/get` (ms). */
+export const DEFAULT_POLL_INTERVAL_MS = 500;
+/** Capped poll interval for `tasks/get` (ms). */
+export const DEFAULT_POLL_INTERVAL_MAX_MS = 2_000;
+/** Multiplier applied between consecutive polls. */
+export const POLL_BACKOFF_FACTOR = 1.5;
+const _TERMINAL_STATES = new Set([
+    "completed",
+    "failed",
+    "canceled",
+    // A2A v1.0 uses US "canceled"; mesh JobController uses UK "cancelled".
+    // Accept both so a heterogeneous deployment doesn't get stuck polling.
+    "cancelled",
+]);
+export function isTerminalState(state) {
+    return state != null && _TERMINAL_STATES.has(state.toLowerCase());
+}
+export class A2AClient {
+    url;
+    skillId;
+    auth;
+    timeoutMs;
+    pollIntervalMs;
+    pollIntervalMaxMs;
+    closed = false;
+    // JSON-RPC requires a unique id per request — a per-instance monotonic
+    // counter is the spec-conforming choice. Some servers/middleware
+    // enforce this, so don't reuse `2` across every tasks/get poll.
+    nextRpcId = 1;
+    constructor(config) {
+        if (!config.url || config.url.trim() === "") {
+            throw new A2AError("A2AClient: url must be non-empty");
+        }
+        if (config.timeoutMs !== undefined && config.timeoutMs <= 0) {
+            throw new A2AError("A2AClient: timeoutMs must be > 0");
+        }
+        // Trim trailing slashes to match Python's url.rstrip("/") and Java's
+        // trim loop — keeps the on-the-wire URL stable regardless of how
+        // the user wrote the constructor argument.
+        let trimmed = config.url;
+        while (trimmed.endsWith("/")) {
+            trimmed = trimmed.slice(0, -1);
+        }
+        this.url = trimmed;
+        this.skillId = config.skillId;
+        this.auth = resolveBearer(config.auth);
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.pollIntervalMs = config.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.pollIntervalMaxMs =
+            config.pollIntervalMaxMs ?? DEFAULT_POLL_INTERVAL_MAX_MS;
+    }
+    /**
+     * POST `tasks/send` and poll `tasks/get` until terminal.
+     *
+     * `message` is the A2A v1.0 request message dict — typically
+     * `{ role: "user", parts: [{ type: "text", text: "..." }] }`.
+     * Returns an `A2AResponse` whose `artifactText` carries the
+     * producer-side handler's return value (JSON-stringified for
+     * non-string returns; consumers `JSON.parse` when the upstream
+     * returns a dict).
+     */
+    async send(message, options) {
+        this._ensureOpen();
+        if (message == null) {
+            throw new A2AError("A2AClient.send: message must be non-null");
+        }
+        const timeoutMs = options?.timeoutMs ?? this.timeoutMs;
+        if (timeoutMs <= 0) {
+            throw new A2AError("A2AClient.send: timeoutMs must be > 0");
+        }
+        const taskId = options?.taskId ?? this._newTaskId();
+        const deadline = Date.now() + timeoutMs;
+        let result = await this._postJsonRpc("tasks/send", { id: taskId, message }, Math.max(1, deadline - Date.now()));
+        let state = readState(result);
+        if (isTerminalState(state)) {
+            return this._buildResponse(taskId, result);
+        }
+        let intervalMs = this.pollIntervalMs;
+        while (Date.now() < deadline) {
+            await sleep(Math.min(intervalMs, Math.max(1, deadline - Date.now())));
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                break;
+            result = await this._postJsonRpc("tasks/get", { id: taskId }, remaining);
+            state = readState(result);
+            if (isTerminalState(state)) {
+                return this._buildResponse(taskId, result);
+            }
+            intervalMs = Math.min(this.pollIntervalMaxMs, Math.floor(intervalMs * POLL_BACKOFF_FACTOR));
+        }
+        throw new A2ATimeoutError(`A2A task '${taskId}' on ${this.url} did not reach terminal state ` +
+            `within ${timeoutMs}ms (last state='${state}')`);
+    }
+    /**
+     * POST `tasks/send` and return an `A2AJob` handle WITHOUT polling.
+     *
+     * Use this when the surrounding `addTool({ task: true, ... })` body
+     * wants explicit control over when to poll — typically via
+     * `A2AJob.bridge(jobController)` which mirrors progress into the
+     * framework-injected `JobController`.
+     */
+    async submit(message, options) {
+        this._ensureOpen();
+        if (message == null) {
+            throw new A2AError("A2AClient.submit: message must be non-null");
+        }
+        const taskId = options?.taskId ?? this._newTaskId();
+        const result = await this._postJsonRpc("tasks/send", { id: taskId, message }, this.timeoutMs);
+        const state = readState(result);
+        return new A2AJob(this, taskId, state, result);
+    }
+    /**
+     * POST `tasks/sendSubscribe` and return an `A2AStream` of parsed events.
+     *
+     * The returned stream MUST be either iterated to completion (the
+     * terminal `final=true` frame closes it) OR explicitly closed via
+     * `await using` / `await stream.aclose()` to release the underlying
+     * connection.
+     */
+    async subscribe(message, options) {
+        this._ensureOpen();
+        if (message == null) {
+            throw new A2AError("A2AClient.subscribe: message must be non-null");
+        }
+        const taskId = options?.taskId ?? this._newTaskId();
+        const envelope = {
+            jsonrpc: "2.0",
+            id: this.nextRpcId++,
+            method: "tasks/sendSubscribe",
+            params: { id: taskId, message },
+        };
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "text/event-stream",
+        };
+        if (this.auth) {
+            headers["Authorization"] = this.auth.authorizationHeader();
+        }
+        let response;
+        try {
+            // No request timeout on the SSE call — the stream lifetime is
+            // dictated by the producer, not a per-request deadline. The
+            // dispatcher's keep-alive still applies to the initial handshake.
+            response = await fetch(this.url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(envelope),
+                // undici extension: dispatcher is honoured for connection pooling.
+                dispatcher: getDispatcher(this.url),
+            });
+        }
+        catch (err) {
+            throw new A2AError(`A2A tasks/sendSubscribe ${this.url} transport failure: ` +
+                `${err?.message ?? String(err)}`, err);
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new A2AError(`A2A tasks/sendSubscribe ${this.url} HTTP ${response.status}: ` +
+                truncate(body, 256));
+        }
+        if (!response.body) {
+            throw new A2AError(`A2A tasks/sendSubscribe ${this.url} returned no response body`);
+        }
+        return new A2AStream(response, taskId);
+    }
+    /**
+     * Lifecycle marker (forward-compat).
+     *
+     * The undici Agent pool is shared process-wide via `closeHttpPool()`
+     * — there's no per-client connection state to tear down. We mark
+     * `closed = true` so subsequent `send`/`submit`/`subscribe` raise
+     * cleanly (matches Python's `_closed` flag behaviour).
+     */
+    async close() {
+        this.closed = true;
+    }
+    // --- internal API used by A2AJob / A2AStream -----------------------------
+    /** Internal: POST `tasks/get` for the supplied task ID. */
+    async tasksGet(taskId) {
+        this._ensureOpen();
+        return this._postJsonRpc("tasks/get", { id: taskId }, this.timeoutMs);
+    }
+    /** Internal: POST `tasks/cancel`. Best-effort; transport errors swallowed by caller. */
+    async tasksCancel(taskId, reason) {
+        this._ensureOpen();
+        const params = { id: taskId };
+        if (reason !== undefined)
+            params.reason = reason;
+        // A2A spec-conforming producers may return `{jsonrpc:"2.0",id:N}` for
+        // tasks/cancel (no result, no error) — accept that envelope shape so
+        // we don't false-fail the cancel on producers that don't echo a Task
+        // body back.
+        await this._postJsonRpc("tasks/cancel", params, this.timeoutMs, "result-or-error");
+    }
+    /** Internal: build an `A2AResponse` from a Task envelope. */
+    buildResponse(taskId, result) {
+        return this._buildResponse(taskId, result);
+    }
+    // --- helpers -------------------------------------------------------------
+    _newTaskId() {
+        return `c-${randomUUID().replace(/-/g, "")}`;
+    }
+    _ensureOpen() {
+        if (this.closed) {
+            throw new A2AError(`A2AClient(url=${this.url}) is closed; create a new instance instead.`);
+        }
+    }
+    async _postJsonRpc(method, params, timeoutMs, accept = "result-required") {
+        const envelope = {
+            jsonrpc: "2.0",
+            id: this.nextRpcId++,
+            method,
+            params,
+        };
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.auth) {
+            try {
+                headers["Authorization"] = this.auth.authorizationHeader();
+            }
+            catch (err) {
+                if (err instanceof A2AAuthError)
+                    throw err;
+                throw new A2AAuthError(`A2A ${method} ${this.url}: failed to resolve bearer header: ` +
+                    `${err?.message ?? String(err)}`, err);
+            }
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await fetch(this.url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(envelope),
+                signal: controller.signal,
+                // undici extension: dispatcher is honoured for connection pooling.
+                dispatcher: getDispatcher(this.url),
+            });
+        }
+        catch (err) {
+            if (err?.name === "AbortError") {
+                throw new A2ATimeoutError(`A2A ${method} ${this.url} timed out after ${timeoutMs}ms`, err);
+            }
+            throw new A2AError(`A2A ${method} ${this.url} transport failure: ` +
+                `${err?.message ?? String(err)}`, err);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const body = await response.text();
+        if (!response.ok) {
+            throw new A2AError(`A2A ${method} ${this.url} HTTP ${response.status}: ` +
+                truncate(body, 256));
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch (err) {
+            throw new A2AError(`A2A ${method} ${this.url} returned malformed JSON: ` +
+                truncate(body, 256), err);
+        }
+        if (parsed == null || typeof parsed !== "object") {
+            throw new A2AError(`A2A ${method} ${this.url} returned empty body`);
+        }
+        const obj = parsed;
+        if (obj.error != null) {
+            const err = obj.error;
+            const code = err.code !== undefined ? String(err.code) : "?";
+            const msg = err.message !== undefined ? String(err.message) : "<no message>";
+            throw new A2AError(`A2A error from ${this.url}: ${code} ${msg}`);
+        }
+        if (obj.result === undefined || obj.result === null) {
+            if (accept === "result-or-error") {
+                return {};
+            }
+            // A producer that returns {"jsonrpc":"2.0","id":1} (no result and
+            // no error) is malformed JSON-RPC. Coercing this to an empty
+            // object would make `readState()` return "unknown" and the
+            // polling loop spin until the user-supplied deadline. Fail fast
+            // with a clear message instead — matches Java parity.
+            throw new A2AError(`A2A ${method} ${this.url} response has neither 'result' nor 'error' ` +
+                `field — malformed JSON-RPC envelope: ${truncate(body, 256)}`);
+        }
+        return obj.result;
+    }
+    _buildResponse(taskId, result) {
+        return {
+            artifactText: extractArtifactText(result),
+            state: readState(result),
+            taskId,
+            rawTask: result,
+        };
+    }
+}
+// --- exported helpers (used by A2AJob + A2AStream) ----------------------------
+export function readState(result) {
+    if (!result || typeof result !== "object")
+        return "unknown";
+    const status = result.status;
+    if (!status || typeof status !== "object")
+        return "unknown";
+    const state = status.state;
+    if (typeof state !== "string")
+        return "unknown";
+    return state;
+}
+export function extractArtifactText(result) {
+    const artifacts = result.artifacts;
+    if (!Array.isArray(artifacts) || artifacts.length === 0)
+        return "";
+    const first = artifacts[0];
+    if (!first || typeof first !== "object")
+        return "";
+    const parts = first.parts;
+    if (!Array.isArray(parts) || parts.length === 0)
+        return "";
+    const firstPart = parts[0];
+    if (!firstPart || typeof firstPart !== "object")
+        return "";
+    const text = firstPart.text;
+    return typeof text === "string" ? text : "";
+}
+export function readStatusMessage(result) {
+    const status = result.status;
+    if (!status || typeof status !== "object")
+        return undefined;
+    const msg = status.message;
+    if (!msg || typeof msg !== "object")
+        return undefined;
+    const parts = msg.parts;
+    if (!Array.isArray(parts) || parts.length === 0)
+        return undefined;
+    const firstPart = parts[0];
+    if (!firstPart || typeof firstPart !== "object")
+        return undefined;
+    const text = firstPart.text;
+    return typeof text === "string" ? text : undefined;
+}
+export function readProgress(result) {
+    const metadata = result.metadata;
+    if (!metadata || typeof metadata !== "object")
+        return undefined;
+    const progress = metadata.progress;
+    if (progress === undefined || progress === null)
+        return undefined;
+    if (typeof progress === "number" && Number.isFinite(progress)) {
+        return progress;
+    }
+    // Tolerate stringified numerics — some producers JSON-encode metadata
+    // fields as strings.
+    if (typeof progress === "string") {
+        const n = Number.parseFloat(progress);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+export function maybeJsonParse(text) {
+    if (!text)
+        return text;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export function isCanceledState(state) {
+    if (!state)
+        return false;
+    const s = state.toLowerCase();
+    return s === "canceled" || s === "cancelled";
+}
+function truncate(s, max) {
+    if (s == null)
+        return "";
+    return s.length <= max ? s : s.slice(0, max) + "...";
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/a2a/a2a-client.js.map

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

package/dist/a2a/a2a-event.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parsed A2A v1.0 SSE event surface (issue #917).
+ *
+ * One event per `tasks/sendSubscribe` SSE frame after the JSON-RPC
+ * envelope is decoded. Mirrors `mesh._a2a_consumer.A2AEvent` (Python)
+ * and `io.mcpmesh.a2a.A2AEvent` (Java).
+ */
+export type A2AEventKind = "status" | "artifact";
+export interface A2AEvent {
+    /** "status" for TaskStatusUpdateEvent frames; "artifact" for TaskArtifactUpdateEvent frames. */
+    kind: A2AEventKind;
+    /** Lifecycle state (status frames only). */
+    state?: string;
+    /** Normalized progress in [0, 1] (status frames only, when present). */
+    progress?: number;
+    /** Status message text (status frames only, when present). */
+    message?: string;
+    /** Artifact text (artifact frames only). */
+    artifactText?: string;
+    /** True on the terminal status frame. */
+    final: boolean;
+    /** Full JSON-RPC envelope for advanced consumers. */
+    raw: unknown;
+}
+//# sourceMappingURL=a2a-event.d.ts.map

package/dist/a2a/a2a-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-event.d.ts","sourceRoot":"","sources":["../../src/a2a/a2a-event.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,gGAAgG;IAChG,IAAI,EAAE,YAAY,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,GAAG,EAAE,OAAO,CAAC;CACd"}

package/dist/a2a/a2a-event.js

@@ -0,0 +1,9 @@
+/**
+ * Parsed A2A v1.0 SSE event surface (issue #917).
+ *
+ * One event per `tasks/sendSubscribe` SSE frame after the JSON-RPC
+ * envelope is decoded. Mirrors `mesh._a2a_consumer.A2AEvent` (Python)
+ * and `io.mcpmesh.a2a.A2AEvent` (Java).
+ */
+export {};
+//# sourceMappingURL=a2a-event.js.map

package/dist/a2a/a2a-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-event.js","sourceRoot":"","sources":["../../src/a2a/a2a-event.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/a2a/a2a-job.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Handle to a long-running A2A task — returned by `A2AClient.submit`
+ * (issue #917).
+ *
+ * Provides direct task lifecycle methods (`status`, `wait`, `cancel`)
+ * AND a convenience `bridge(jobController)` that mirrors A2A polling
+ * state into a mesh `JobController` for the typical
+ * `addTool({ task: true, a2aConfig: { ... } })` consumer pattern.
+ *
+ * Mirrors `mesh._a2a_consumer.A2AJob` (Python) and
+ * `io.mcpmesh.a2a.A2AJob` (Java).
+ */
+import { JobController } from "@mcpmesh/core";
+import { A2AClient, type A2AResponse, type A2ATaskEnvelope } from "./a2a-client.js";
+export declare class A2AJob {
+    private readonly client;
+    readonly taskId: string;
+    readonly initialState: string;
+    private readonly initialResult;
+    constructor(client: A2AClient, taskId: string, initialState: string, initialResult: A2ATaskEnvelope);
+    /** POST `tasks/get` once and return the raw `result` envelope. */
+    status(): Promise<A2ATaskEnvelope>;
+    /**
+     * POST `tasks/cancel`. Idempotent — already-terminal tasks should
+     * return cleanly per A2A v1.0; transport-level errors are logged
+     * and swallowed so callers can still raise `A2AJobCanceledError`
+     * or similar.
+     */
+    cancel(reason?: string): Promise<void>;
+    /**
+     * Poll `tasks/get` until terminal; return `A2AResponse` on completed.
+     *
+     * Throws `A2AJobFailedError` on `state=failed`,
+     * `A2AJobCanceledError` on `state=canceled`, `A2ATimeoutError` if
+     * the deadline elapses.
+     */
+    wait(timeoutMs?: number): Promise<A2AResponse>;
+    /**
+     * Mirror A2A polling into the supplied `JobController` until terminal.
+     * Returns the final artifact value: parsed JSON when the artifact
+     * text is valid JSON, otherwise the raw text. Empty artifacts return
+     * an empty string.
+     *
+     * Cancel handling: races each iteration's sleep against
+     * `awaitJobCancel(jobId)` so a mesh-side cancel arriving DURING a
+     * sleep wakes us immediately instead of waiting for the next poll
+     * boundary. On detection POSTs `tasks/cancel` upstream so the
+     * producer stops billing for the work, then throws
+     * `A2AJobCanceledError` so the framework's `task: true` wrapper
+     * records a canceled outcome.
+     */
+    bridge(controller: JobController): Promise<unknown>;
+    private _mirrorProgress;
+    private _propagateCancelUpstream;
+    private _terminalToResponseOrThrow;
+    private _terminalToArtifactOrThrow;
+}
+//# sourceMappingURL=a2a-job.d.ts.map

package/dist/a2a/a2a-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-job.d.ts","sourceRoot":"","sources":["../../src/a2a/a2a-job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAkB,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,eAAe,EASrB,MAAM,iBAAiB,CAAC;AAOzB,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBAG9C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,eAAe;IAQhC,kEAAkE;IAC5D,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAIxC;;;;;OAKG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgCpD;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;YAwF3C,eAAe;YAyCf,wBAAwB;IAWtC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,0BAA0B;CAcnC"}