@arnilo/prism-supervisor 0.0.96 → 0.1.0

package/dist/a2a-client.js

@@ -1,7 +1,7 @@
 import { createA2AAgentCard } from "./a2a-card.js";
 import { resolveA2ALimits } from "./a2a-parts.js";
+import { A2A_PROTOCOL_VERSION, } from "./a2a-types.js";
 import { A2AError } from "./errors.js";
-import { A2A_PROTOCOL_VERSION } from "./a2a-types.js";
 export function createA2AClient(options) {
     const endpoint = requireAllowedHttpsUrl(options.endpoint, options.allowedOrigins);
     const cardUrl = requireAllowedHttpsUrl(options.cardUrl ?? `${endpoint.origin}/.well-known/agent-card.json`, options.allowedOrigins);
@@ -24,7 +24,12 @@ export function createA2AClient(options) {
     }
     async function getCard(call = {}) {
         return withRequest(call.signal, async (signal) => {
-            const response = await fetcher(cardUrl, { method: "GET", signal, redirect: "error", headers: { accept: "application/a2a+json, application/json" } });
+            const response = await fetcher(cardUrl, {
+                method: "GET",
+                signal,
+                redirect: "error",
+                headers: { accept: "application/a2a+json, application/json" },
+            });
             if (!response.ok)
                 throw new A2AError("A2A card request failed", response.status, "ERR_PRISM_A2A_REMOTE");
             const value = await readBoundedJson(response, limits.maxCardBytes, signal);
@@ -45,7 +50,18 @@ export function createA2AClient(options) {
             if (new TextEncoder().encode(body).byteLength > limits.maxRequestBytes)
                 throw new A2AError("A2A request exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT");
             const authHeaders = await abortable(Promise.resolve(options.authorize?.({ endpoint: endpoint.href, signal }) ?? {}), signal);
-            const response = await fetcher(endpoint, { method: "POST", signal, redirect: "error", headers: { ...headersObject(authHeaders), "content-type": "application/a2a+json", accept: "application/a2a+json", "a2a-version": "1.0" }, body });
+            const response = await fetcher(endpoint, {
+                method: "POST",
+                signal,
+                redirect: "error",
+                headers: {
+                    ...headersObject(authHeaders),
+                    "content-type": "application/a2a+json",
+                    accept: "application/a2a+json",
+                    "a2a-version": "1.0",
+                },
+                body,
+            });
             if (!response.ok)
                 throw new A2AError("A2A remote request failed", response.status, "ERR_PRISM_A2A_REMOTE");
             const rpc = parseRpcResponse(await readBoundedJson(response, limits.maxResponseBytes, signal), id);
@@ -54,25 +70,37 @@ export function createA2AClient(options) {
             return taskResult(parseTaskResult(rpc.result), options);
         });
     }
-    async function* stream(input, call = {}) {
+    async function* streamMessage(message, call = {}) {
         if (active >= limits.maxConcurrentRequests)
             throw new A2AError("A2A client concurrency exceeded", 429, "ERR_PRISM_A2A_CONCURRENCY");
         active += 1;
         const owned = ownedSignal(call.signal, limits.timeoutMs);
         let reader;
         try {
-            assertInput(input, limits.maxRequestBytes);
+            assertMessage(message, limits.maxRequestBytes);
             await getCardWithin(owned.signal);
             const id = ++requestId;
-            const body = JSON.stringify(requestBody(id, "SendStreamingMessage", input));
+            const body = JSON.stringify({ jsonrpc: "2.0", id, method: "SendStreamingMessage", params: { message } });
             if (new TextEncoder().encode(body).byteLength > limits.maxRequestBytes)
                 throw new A2AError("A2A request exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT");
             const authHeaders = await abortable(Promise.resolve(options.authorize?.({ endpoint: endpoint.href, signal: owned.signal }) ?? {}), owned.signal);
-            const response = await fetcher(endpoint, { method: "POST", signal: owned.signal, redirect: "error", headers: { ...headersObject(authHeaders), "content-type": "application/a2a+json", accept: "text/event-stream", "a2a-version": "1.0" }, body });
+            const response = await fetcher(endpoint, {
+                method: "POST",
+                signal: owned.signal,
+                redirect: "error",
+                headers: {
+                    ...headersObject(authHeaders),
+                    "content-type": "application/a2a+json",
+                    accept: "text/event-stream",
+                    "a2a-version": "1.0",
+                },
+                body,
+            });
             if (!response.ok || !response.body || !response.headers.get("content-type")?.startsWith("text/event-stream"))
                 throw new A2AError("A2A stream request failed", response.status, "ERR_PRISM_A2A_REMOTE");
             reader = response.body.getReader();
             let terminal = false;
+            let count = 0;
             for await (const data of readA2AStreamData(reader, limits, owned.signal)) {
                 if (terminal)
                     throw new A2AError("A2A stream continued after terminal task state", 502, "ERR_PRISM_A2A_REMOTE");
@@ -88,17 +116,17 @@ export function createA2AClient(options) {
                 const rpc = parseRpcResponse(parsed, id);
                 if (rpc.error)
                     throw new A2AError(safeRemote(rpc.error.message, options), 502, "ERR_PRISM_A2A_REMOTE");
-                const task = parseTaskResult(rpc.result);
-                if (task.status.state === "TASK_STATE_FAILED" || task.status.state === "TASK_STATE_CANCELED" || task.status.state === "TASK_STATE_REJECTED")
-                    throw new A2AError("Remote A2A stream task failed", 502, "ERR_PRISM_A2A_REMOTE");
-                if (task.status.state === "TASK_STATE_INPUT_REQUIRED" || task.status.state === "TASK_STATE_AUTH_REQUIRED")
-                    throw new A2AError(`Remote A2A task interrupted: ${task.status.state}`, 409, "ERR_PRISM_A2A_INTERRUPTED");
-                if (task.status.state === "TASK_STATE_COMPLETED")
+                const event = parseA2AStreamEvent(rpc.result, `stream-${++count}`);
+                const status = eventStatus(event);
+                if (status === "TASK_STATE_FAILED" ||
+                    status === "TASK_STATE_CANCELED" ||
+                    status === "TASK_STATE_REJECTED" ||
+                    status === "TASK_STATE_INPUT_REQUIRED" ||
+                    status === "TASK_STATE_AUTH_REQUIRED")
+                    terminal = true;
+                if (status === "TASK_STATE_COMPLETED")
                     terminal = true;
-                for (const artifact of task.artifacts ?? [])
-                    for (const part of artifact.parts)
-                        if (typeof part.text === "string")
-                            yield options.redactor?.redact(part.text) ?? part.text;
+                yield event;
             }
             if (!terminal)
                 throw new A2AError("A2A stream ended before terminal task state", 502, "ERR_PRISM_A2A_REMOTE");
@@ -109,8 +137,25 @@ export function createA2AClient(options) {
             active -= 1;
         }
     }
+    async function* stream(input, call = {}) {
+        assertInput(input, limits.maxRequestBytes);
+        for await (const event of streamMessage({ role: "user", messageId: "stream-input", parts: [{ text: input }] }, call)) {
+            const status = eventStatus(event);
+            if (status === "TASK_STATE_FAILED" || status === "TASK_STATE_CANCELED" || status === "TASK_STATE_REJECTED")
+                throw new A2AError("Remote A2A stream task failed", 502, "ERR_PRISM_A2A_REMOTE");
+            if (status === "TASK_STATE_INPUT_REQUIRED" || status === "TASK_STATE_AUTH_REQUIRED")
+                throw new A2AError(`Remote A2A task interrupted: ${status}`, 409, "ERR_PRISM_A2A_INTERRUPTED");
+            for (const text of streamEventText(event))
+                yield options.redactor?.redact(text) ?? text;
+        }
+    }
     async function getCardWithin(signal) {
-        const response = await fetcher(cardUrl, { method: "GET", signal, redirect: "error", headers: { accept: "application/a2a+json, application/json" } });
+        const response = await fetcher(cardUrl, {
+            method: "GET",
+            signal,
+            redirect: "error",
+            headers: { accept: "application/a2a+json, application/json" },
+        });
         if (!response.ok)
             throw new A2AError("A2A card request failed", response.status, "ERR_PRISM_A2A_REMOTE");
         const card = parseCard(await readBoundedJson(response, limits.maxCardBytes, signal));
@@ -128,7 +173,18 @@ export function createA2AClient(options) {
             if (Buffer.byteLength(body) > limits.maxRequestBytes)
                 throw new A2AError("A2A request exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT");
             const authHeaders = await abortable(Promise.resolve(options.authorize?.({ endpoint: endpoint.href, signal: owned }) ?? {}), owned);
-            const response = await fetcher(endpoint, { method: "POST", signal: owned, redirect: "error", headers: { ...headersObject(authHeaders), "content-type": "application/a2a+json", accept: "application/a2a+json", "a2a-version": "1.0" }, body });
+            const response = await fetcher(endpoint, {
+                method: "POST",
+                signal: owned,
+                redirect: "error",
+                headers: {
+                    ...headersObject(authHeaders),
+                    "content-type": "application/a2a+json",
+                    accept: "application/a2a+json",
+                    "a2a-version": "1.0",
+                },
+                body,
+            });
             if (!response.ok)
                 throw new A2AError("A2A remote request failed", response.status, "ERR_PRISM_A2A_REMOTE");
             const rpc = parseRpcResponse(await readBoundedJson(response, limits.maxResponseBytes, owned), id);
@@ -140,14 +196,22 @@ export function createA2AClient(options) {
     async function sendMessage(message, call = {}) {
         return parseTaskResult(await invoke("SendMessage", { message, configuration: { returnImmediately: call.returnImmediately ?? false } }, call.signal));
     }
-    async function getTask(id, call = {}) { return parseTaskResult(await invoke("GetTask", { id, historyLength: call.historyLength ?? 0 }, call.signal)); }
+    async function getTask(id, call = {}) {
+        return parseTaskResult(await invoke("GetTask", { id, historyLength: call.historyLength ?? 0 }, call.signal));
+    }
     async function listTasks(call = {}) {
         const value = await invoke("ListTasks", { pageSize: call.pageSize ?? 50, pageToken: call.pageToken, contextId: call.contextId }, call.signal);
         if (!isRecord(value) || !Array.isArray(value.tasks) || value.tasks.length > limits.maxPageSize)
             throw new A2AError("Malformed A2A task page", 502, "ERR_PRISM_A2A_REMOTE");
-        return { tasks: value.tasks.map((task) => parseTaskResult(task)), nextPageToken: typeof value.nextPageToken === "string" ? value.nextPageToken : undefined, totalSize: typeof value.totalSize === "number" ? value.totalSize : undefined };
+        return {
+            tasks: value.tasks.map((task) => parseTaskResult(task)),
+            nextPageToken: typeof value.nextPageToken === "string" ? value.nextPageToken : undefined,
+            totalSize: typeof value.totalSize === "number" ? value.totalSize : undefined,
+        };
+    }
+    async function cancelTask(id, call = {}) {
+        return parseTaskResult(await invoke("CancelTask", { id }, call.signal));
     }
-    async function cancelTask(id, call = {}) { return parseTaskResult(await invoke("CancelTask", { id }, call.signal)); }
     async function* subscribeToTask(id, call = {}) {
         if (active >= limits.maxConcurrentRequests)
             throw new A2AError("A2A client concurrency exceeded", 429, "ERR_PRISM_A2A_CONCURRENCY");
@@ -158,19 +222,31 @@ export function createA2AClient(options) {
             await getCardWithin(owned.signal);
             const request = ++requestId;
             const authHeaders = await abortable(Promise.resolve(options.authorize?.({ endpoint: endpoint.href, signal: owned.signal }) ?? {}), owned.signal);
-            const response = await fetcher(endpoint, { method: "POST", signal: owned.signal, redirect: "error", headers: { ...headersObject(authHeaders), "content-type": "application/a2a+json", accept: "text/event-stream", "a2a-version": "1.0" }, body: JSON.stringify({ jsonrpc: "2.0", id: request, method: "SubscribeToTask", params: { id, afterEventId: call.afterEventId } }) });
+            const response = await fetcher(endpoint, {
+                method: "POST",
+                signal: owned.signal,
+                redirect: "error",
+                headers: {
+                    ...headersObject(authHeaders),
+                    "content-type": "application/a2a+json",
+                    accept: "text/event-stream",
+                    "a2a-version": "1.0",
+                },
+                body: JSON.stringify({ jsonrpc: "2.0", id: request, method: "SubscribeToTask", params: { id, afterEventId: call.afterEventId } }),
+            });
             if (!response.ok || !response.body || !response.headers.get("content-type")?.startsWith("text/event-stream"))
                 throw new A2AError("A2A subscribe request failed", response.status, "ERR_PRISM_A2A_REMOTE");
             reader = response.body.getReader();
-            let previous = "", count = 0;
+            const seen = new Set();
+            let count = 0;
             for await (const data of readA2AStreamData(reader, limits, owned.signal)) {
                 const rpc = parseRpcResponse(JSON.parse(data), request);
                 if (rpc.error)
                     throw remoteProtocolError(rpc.error.code, rpc.error.message, options);
                 const event = parseTaskEvent(rpc.result);
-                if (event.eventId === previous)
+                if (seen.has(event.eventId))
                     continue;
-                previous = event.eventId;
+                seen.add(event.eventId);
                 if (++count > limits.maxReplayEvents)
                     throw new A2AError("A2A replay exceeds event limit", 507, "ERR_PRISM_A2A_STREAM_LIMIT");
                 yield event;
@@ -182,12 +258,39 @@ export function createA2AClient(options) {
             active -= 1;
         }
     }
-    async function createPushConfig(config, call = {}) { return parsePushConfig(await invoke("CreateTaskPushNotificationConfig", { ...config }, call.signal)); }
-    async function getPushConfig(taskId, id, call = {}) { return parsePushConfig(await invoke("GetTaskPushNotificationConfig", { taskId, id }, call.signal)); }
-    async function listPushConfigs(taskId, call = {}) { const value = await invoke("ListTaskPushNotificationConfigs", { taskId, pageSize: call.pageSize, pageToken: call.pageToken }, call.signal); if (!isRecord(value) || !Array.isArray(value.configs))
-        throw new A2AError("Malformed A2A push config page", 502, "ERR_PRISM_A2A_REMOTE"); return { configs: value.configs.map(parsePushConfig), nextPageToken: typeof value.nextPageToken === "string" ? value.nextPageToken : undefined }; }
-    async function deletePushConfig(taskId, id, call = {}) { await invoke("DeleteTaskPushNotificationConfig", { taskId, id }, call.signal); }
-    return { getCard, send, sendMessage, stream, getTask, listTasks, cancelTask, subscribeToTask, createPushConfig, getPushConfig, listPushConfigs, deletePushConfig };
+    async function createPushConfig(config, call = {}) {
+        return parsePushConfig(await invoke("CreateTaskPushNotificationConfig", { ...config }, call.signal));
+    }
+    async function getPushConfig(taskId, id, call = {}) {
+        return parsePushConfig(await invoke("GetTaskPushNotificationConfig", { taskId, id }, call.signal));
+    }
+    async function listPushConfigs(taskId, call = {}) {
+        const value = await invoke("ListTaskPushNotificationConfigs", { taskId, pageSize: call.pageSize, pageToken: call.pageToken }, call.signal);
+        if (!isRecord(value) || !Array.isArray(value.configs))
+            throw new A2AError("Malformed A2A push config page", 502, "ERR_PRISM_A2A_REMOTE");
+        return {
+            configs: value.configs.map(parsePushConfig),
+            nextPageToken: typeof value.nextPageToken === "string" ? value.nextPageToken : undefined,
+        };
+    }
+    async function deletePushConfig(taskId, id, call = {}) {
+        await invoke("DeleteTaskPushNotificationConfig", { taskId, id }, call.signal);
+    }
+    return {
+        getCard,
+        send,
+        sendMessage,
+        stream,
+        streamMessage,
+        getTask,
+        listTasks,
+        cancelTask,
+        subscribeToTask,
+        createPushConfig,
+        getPushConfig,
+        listPushConfigs,
+        deletePushConfig,
+    };
 }
 async function* readA2AStreamData(reader, limits, signal) {
     const decoder = new TextDecoder("utf-8", { fatal: true });
@@ -295,12 +398,21 @@ function taskResult(task, options) {
         throw new A2AError("A2A response task is not terminal", 502, "ERR_PRISM_A2A_REMOTE");
     if (task.status.state === "TASK_STATE_INPUT_REQUIRED" || task.status.state === "TASK_STATE_AUTH_REQUIRED")
         throw new A2AError(`Remote A2A task interrupted: ${task.status.state}`, 409, "ERR_PRISM_A2A_INTERRUPTED");
-    const text = (task.artifacts ?? []).flatMap((artifact) => artifact.parts.flatMap((part) => "text" in part ? [part.text] : [])).join("");
+    const text = (task.artifacts ?? []).flatMap((artifact) => artifact.parts.flatMap((part) => ("text" in part ? [part.text] : []))).join("");
     const safeText = options.redactor?.redact(text) ?? text;
     const status = task.status.state === "TASK_STATE_COMPLETED" ? "succeeded" : task.status.state === "TASK_STATE_CANCELED" ? "aborted" : "failed";
     const content = safeText ? [{ type: "text", text: safeText }] : [];
     const message = safeText ? { role: "assistant", content } : undefined;
-    return Object.freeze({ sessionId: task.contextId, runId: task.id, status, text: safeText, content, message, error: status === "failed" ? { message: "Remote A2A task failed" } : undefined, abortReason: status === "aborted" ? "Remote A2A task canceled" : undefined });
+    return Object.freeze({
+        sessionId: task.contextId,
+        runId: task.id,
+        status,
+        text: safeText,
+        content,
+        message,
+        error: status === "failed" ? { message: "Remote A2A task failed" } : undefined,
+        abortReason: status === "aborted" ? "Remote A2A task canceled" : undefined,
+    });
 }
 function parseTaskResult(value) {
     if (!isRecord(value))
@@ -308,12 +420,37 @@ function parseTaskResult(value) {
     const task = isRecord(value.task) ? value.task : value;
     if (typeof task.id !== "string" || typeof task.contextId !== "string" || !isRecord(task.status) || typeof task.status.state !== "string")
         throw new A2AError("Malformed A2A task", 502, "ERR_PRISM_A2A_REMOTE");
-    const states = new Set(["TASK_STATE_SUBMITTED", "TASK_STATE_WORKING", "TASK_STATE_COMPLETED", "TASK_STATE_FAILED", "TASK_STATE_CANCELED", "TASK_STATE_INPUT_REQUIRED", "TASK_STATE_REJECTED", "TASK_STATE_AUTH_REQUIRED"]);
+    const states = new Set([
+        "TASK_STATE_SUBMITTED",
+        "TASK_STATE_WORKING",
+        "TASK_STATE_COMPLETED",
+        "TASK_STATE_FAILED",
+        "TASK_STATE_CANCELED",
+        "TASK_STATE_INPUT_REQUIRED",
+        "TASK_STATE_REJECTED",
+        "TASK_STATE_AUTH_REQUIRED",
+    ]);
     if (!states.has(task.status.state))
         throw new A2AError("Unknown A2A task state", 502, "ERR_PRISM_A2A_REMOTE");
     const artifacts = task.artifacts === undefined ? undefined : parseArtifacts(task.artifacts);
-    const history = task.history === undefined ? undefined : Array.isArray(task.history) ? task.history.map(parseRemoteMessage) : (() => { throw new A2AError("Malformed A2A task history", 502, "ERR_PRISM_A2A_REMOTE"); })();
-    return { id: task.id, contextId: task.contextId, status: { state: task.status.state, timestamp: typeof task.status.timestamp === "string" ? task.status.timestamp : new Date(0).toISOString() }, artifacts, history };
+    const history = task.history === undefined
+        ? undefined
+        : Array.isArray(task.history)
+            ? task.history.map(parseRemoteMessage)
+            : (() => {
+                throw new A2AError("Malformed A2A task history", 502, "ERR_PRISM_A2A_REMOTE");
+            })();
+    return {
+        id: task.id,
+        contextId: task.contextId,
+        status: {
+            state: task.status.state,
+            timestamp: typeof task.status.timestamp === "string" ? task.status.timestamp : new Date(0).toISOString(),
+            ...(task.status.message === undefined ? {} : { message: parseRemoteMessage(task.status.message) }),
+        },
+        artifacts,
+        history,
+    };
 }
 function parseArtifacts(value) {
     if (!Array.isArray(value) || value.length > 32)
@@ -330,10 +467,15 @@ function parseRemotePart(value) {
     const keys = ["text", "raw", "url", "data"].filter((key) => Object.hasOwn(value, key));
     if (keys.length !== 1)
         throw new A2AError("Malformed A2A part union", 502, "ERR_PRISM_A2A_REMOTE");
-    const base = { mediaType: typeof value.mediaType === "string" ? value.mediaType : undefined, filename: typeof value.filename === "string" ? value.filename : undefined };
+    const base = {
+        mediaType: typeof value.mediaType === "string" ? value.mediaType : undefined,
+        filename: typeof value.filename === "string" ? value.filename : undefined,
+    };
     if (keys[0] === "text" && typeof value.text === "string")
         return { ...base, text: value.text };
-    if (keys[0] === "raw" && typeof value.raw === "string" && /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u.test(value.raw))
+    if (keys[0] === "raw" &&
+        typeof value.raw === "string" &&
+        /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u.test(value.raw))
         return { ...base, raw: value.raw };
     if (keys[0] === "url" && typeof value.url === "string") {
         const url = new URL(value.url);
@@ -345,25 +487,99 @@ function parseRemotePart(value) {
         return { ...base, data: structuredClone(value.data) };
     throw new A2AError("Malformed A2A part", 502, "ERR_PRISM_A2A_REMOTE");
 }
-function parseRemoteMessage(value) { if (!isRecord(value) || typeof value.messageId !== "string" || !Array.isArray(value.parts) || (value.role !== "ROLE_USER" && value.role !== "ROLE_AGENT" && value.role !== "user" && value.role !== "agent"))
-    throw new A2AError("Malformed A2A message", 502, "ERR_PRISM_A2A_REMOTE"); return { role: value.role, messageId: value.messageId, parts: value.parts.map(parseRemotePart), contextId: typeof value.contextId === "string" ? value.contextId : undefined, taskId: typeof value.taskId === "string" ? value.taskId : undefined }; }
+function parseRemoteMessage(value) {
+    if (!isRecord(value) ||
+        typeof value.messageId !== "string" ||
+        !Array.isArray(value.parts) ||
+        (value.role !== "ROLE_USER" && value.role !== "ROLE_AGENT" && value.role !== "user" && value.role !== "agent"))
+        throw new A2AError("Malformed A2A message", 502, "ERR_PRISM_A2A_REMOTE");
+    return {
+        role: value.role,
+        messageId: value.messageId,
+        parts: value.parts.map(parseRemotePart),
+        contextId: typeof value.contextId === "string" ? value.contextId : undefined,
+        taskId: typeof value.taskId === "string" ? value.taskId : undefined,
+    };
+}
+function parseA2AStreamEvent(value, fallbackEventId) {
+    if (isRecord(value) && isRecord(value.message))
+        return { eventId: fallbackEventId, message: parseRemoteMessage(value.message) };
+    if (isRecord(value) && !Object.hasOwn(value, "eventId") && (isRecord(value.task) || typeof value.id === "string")) {
+        return { eventId: fallbackEventId, task: parseTaskResult(value) };
+    }
+    return parseTaskEvent(value);
+}
+function eventStatus(event) {
+    if ("task" in event)
+        return event.task.status.state;
+    if ("statusUpdate" in event)
+        return event.statusUpdate.status.state;
+    return undefined;
+}
+function streamEventText(event) {
+    const parts = "message" in event
+        ? event.message.parts
+        : "task" in event
+            ? (event.task.artifacts?.flatMap((artifact) => artifact.parts) ?? [])
+            : "artifactUpdate" in event
+                ? event.artifactUpdate.artifact.parts
+                : [];
+    return parts.flatMap((part) => (typeof part.text === "string" ? [part.text] : []));
+}
 function parseTaskEvent(value) {
     if (!isRecord(value) || typeof value.eventId !== "string" || !value.eventId)
         throw new A2AError("Malformed A2A task event", 502, "ERR_PRISM_A2A_REMOTE");
     if (isRecord(value.task))
         return { eventId: value.eventId, task: parseTaskResult(value.task) };
-    if (isRecord(value.statusUpdate) && typeof value.statusUpdate.taskId === "string" && typeof value.statusUpdate.contextId === "string" && isRecord(value.statusUpdate.status)) {
-        const parsed = parseTaskResult({ id: value.statusUpdate.taskId, contextId: value.statusUpdate.contextId, status: value.statusUpdate.status });
+    if (isRecord(value.statusUpdate) &&
+        typeof value.statusUpdate.taskId === "string" &&
+        typeof value.statusUpdate.contextId === "string" &&
+        isRecord(value.statusUpdate.status)) {
+        const parsed = parseTaskResult({
+            id: value.statusUpdate.taskId,
+            contextId: value.statusUpdate.contextId,
+            status: value.statusUpdate.status,
+        });
         return { eventId: value.eventId, statusUpdate: { taskId: parsed.id, contextId: parsed.contextId, status: parsed.status } };
     }
-    if (isRecord(value.artifactUpdate) && typeof value.artifactUpdate.taskId === "string" && typeof value.artifactUpdate.contextId === "string" && isRecord(value.artifactUpdate.artifact))
-        return { eventId: value.eventId, artifactUpdate: { taskId: value.artifactUpdate.taskId, contextId: value.artifactUpdate.contextId, artifact: parseArtifacts([value.artifactUpdate.artifact])[0], append: value.artifactUpdate.append === true, lastChunk: value.artifactUpdate.lastChunk === true } };
+    if (isRecord(value.artifactUpdate) &&
+        typeof value.artifactUpdate.taskId === "string" &&
+        typeof value.artifactUpdate.contextId === "string" &&
+        isRecord(value.artifactUpdate.artifact))
+        return {
+            eventId: value.eventId,
+            artifactUpdate: {
+                taskId: value.artifactUpdate.taskId,
+                contextId: value.artifactUpdate.contextId,
+                artifact: parseArtifacts([value.artifactUpdate.artifact])[0],
+                append: value.artifactUpdate.append === true,
+                lastChunk: value.artifactUpdate.lastChunk === true,
+            },
+        };
     throw new A2AError("Malformed A2A task event", 502, "ERR_PRISM_A2A_REMOTE");
 }
-function parsePushConfig(value) { if (!isRecord(value) || typeof value.id !== "string" || typeof value.taskId !== "string" || typeof value.url !== "string")
-    throw new A2AError("Malformed A2A push config", 502, "ERR_PRISM_A2A_REMOTE"); const url = new URL(value.url); if (url.protocol !== "https:" || url.username || url.password || url.hash)
-    throw new A2AError("Unsafe A2A push URL", 502, "ERR_PRISM_A2A_REMOTE"); return { id: value.id, taskId: value.taskId, url: url.href, token: typeof value.token === "string" ? value.token : undefined, authentication: isRecord(value.authentication) && typeof value.authentication.scheme === "string" ? { scheme: value.authentication.scheme, credentials: typeof value.authentication.credentials === "string" ? value.authentication.credentials : undefined } : undefined }; }
-function remoteProtocolError(code, message, options) { return new A2AError(safeRemote(message, options), code === -32001 ? 404 : code === -32004 ? 501 : 502, code === -32001 ? "ERR_PRISM_A2A_TASK_NOT_FOUND" : code === -32004 ? "ERR_PRISM_A2A_UNSUPPORTED" : "ERR_PRISM_A2A_REMOTE"); }
+function parsePushConfig(value) {
+    if (!isRecord(value) || typeof value.id !== "string" || typeof value.taskId !== "string" || typeof value.url !== "string")
+        throw new A2AError("Malformed A2A push config", 502, "ERR_PRISM_A2A_REMOTE");
+    const url = new URL(value.url);
+    if (url.protocol !== "https:" || url.username || url.password || url.hash)
+        throw new A2AError("Unsafe A2A push URL", 502, "ERR_PRISM_A2A_REMOTE");
+    return {
+        id: value.id,
+        taskId: value.taskId,
+        url: url.href,
+        token: typeof value.token === "string" ? value.token : undefined,
+        authentication: isRecord(value.authentication) && typeof value.authentication.scheme === "string"
+            ? {
+                scheme: value.authentication.scheme,
+                credentials: typeof value.authentication.credentials === "string" ? value.authentication.credentials : undefined,
+            }
+            : undefined,
+    };
+}
+function remoteProtocolError(code, message, options) {
+    return new A2AError(safeRemote(message, options), code === -32001 ? 404 : code === -32004 ? 501 : 502, code === -32001 ? "ERR_PRISM_A2A_TASK_NOT_FOUND" : code === -32004 ? "ERR_PRISM_A2A_UNSUPPORTED" : "ERR_PRISM_A2A_REMOTE");
+}
 function parseRpcResponse(value, id) {
     if (!isRecord(value) || value.jsonrpc !== "2.0" || value.id !== id)
         throw new A2AError("Malformed A2A JSON-RPC response", 502, "ERR_PRISM_A2A_REMOTE");
@@ -373,7 +589,16 @@ function parseRpcResponse(value, id) {
     return { jsonrpc: "2.0", id, result: value.result, error: error };
 }
 function parseCard(value) {
-    if (!isRecord(value) || typeof value.name !== "string" || typeof value.description !== "string" || typeof value.version !== "string" || !Array.isArray(value.supportedInterfaces) || !Array.isArray(value.skills) || !stringArray(value.defaultInputModes) || !stringArray(value.defaultOutputModes) || !isRecord(value.capabilities) || typeof value.capabilities.streaming !== "boolean")
+    if (!isRecord(value) ||
+        typeof value.name !== "string" ||
+        typeof value.description !== "string" ||
+        typeof value.version !== "string" ||
+        !Array.isArray(value.supportedInterfaces) ||
+        !Array.isArray(value.skills) ||
+        !stringArray(value.defaultInputModes) ||
+        !stringArray(value.defaultOutputModes) ||
+        !isRecord(value.capabilities) ||
+        typeof value.capabilities.streaming !== "boolean")
         throw new A2AError("Malformed A2A agent card", 502, "ERR_PRISM_A2A_CARD");
     const supportedInterfaces = value.supportedInterfaces.map((item) => {
         if (!isRecord(item) || typeof item.url !== "string" || item.protocolBinding !== "JSONRPC" || item.protocolVersion !== "1.0")
@@ -381,21 +606,47 @@ function parseCard(value) {
         return { url: item.url, protocolBinding: "JSONRPC", protocolVersion: "1.0" };
     });
     const skills = value.skills.map((skill) => {
-        if (!isRecord(skill) || typeof skill.id !== "string" || typeof skill.name !== "string" || typeof skill.description !== "string" || !stringArray(skill.tags))
+        if (!isRecord(skill) ||
+            typeof skill.id !== "string" ||
+            typeof skill.name !== "string" ||
+            typeof skill.description !== "string" ||
+            !stringArray(skill.tags))
             throw new A2AError("Malformed A2A agent skill", 502, "ERR_PRISM_A2A_CARD");
-        return { id: skill.id, name: skill.name, description: skill.description, tags: skill.tags, examples: stringArray(skill.examples) ? skill.examples : undefined, inputModes: stringArray(skill.inputModes) ? skill.inputModes : undefined, outputModes: stringArray(skill.outputModes) ? skill.outputModes : undefined };
+        return {
+            id: skill.id,
+            name: skill.name,
+            description: skill.description,
+            tags: skill.tags,
+            examples: stringArray(skill.examples) ? skill.examples : undefined,
+            inputModes: stringArray(skill.inputModes) ? skill.inputModes : undefined,
+            outputModes: stringArray(skill.outputModes) ? skill.outputModes : undefined,
+        };
     });
-    const signatures = value.signatures === undefined ? undefined : Array.isArray(value.signatures) ? value.signatures.map((signature) => {
-        if (!isRecord(signature) || typeof signature.protected !== "string" || typeof signature.signature !== "string")
-            throw new A2AError("Malformed A2A card signature", 502, "ERR_PRISM_A2A_CARD");
-        return { protected: signature.protected, signature: signature.signature, header: isRecord(signature.header) ? signature.header : undefined };
-    }) : (() => { throw new A2AError("Malformed A2A card signatures", 502, "ERR_PRISM_A2A_CARD"); })();
+    const signatures = value.signatures === undefined
+        ? undefined
+        : Array.isArray(value.signatures)
+            ? value.signatures.map((signature) => {
+                if (!isRecord(signature) || typeof signature.protected !== "string" || typeof signature.signature !== "string")
+                    throw new A2AError("Malformed A2A card signature", 502, "ERR_PRISM_A2A_CARD");
+                return {
+                    protected: signature.protected,
+                    signature: signature.signature,
+                    header: isRecord(signature.header) ? signature.header : undefined,
+                };
+            })
+            : (() => {
+                throw new A2AError("Malformed A2A card signatures", 502, "ERR_PRISM_A2A_CARD");
+            })();
     return createA2AAgentCard({
         name: value.name,
         description: value.description,
         version: value.version,
         supportedInterfaces,
-        capabilities: { streaming: value.capabilities.streaming, pushNotifications: typeof value.capabilities.pushNotifications === "boolean" ? value.capabilities.pushNotifications : undefined, extendedAgentCard: typeof value.capabilities.extendedAgentCard === "boolean" ? value.capabilities.extendedAgentCard : undefined },
+        capabilities: {
+            streaming: value.capabilities.streaming,
+            pushNotifications: typeof value.capabilities.pushNotifications === "boolean" ? value.capabilities.pushNotifications : undefined,
+            extendedAgentCard: typeof value.capabilities.extendedAgentCard === "boolean" ? value.capabilities.extendedAgentCard : undefined,
+        },
         defaultInputModes: value.defaultInputModes,
         defaultOutputModes: value.defaultOutputModes,
         skills,
@@ -455,7 +706,13 @@ function ownedSignal(parent, timeoutMs) {
     else
         parent?.addEventListener("abort", abort, { once: true });
     const timer = setTimeout(() => controller.abort(new DOMException("A2A request timed out", "AbortError")), timeoutMs);
-    return { signal: controller.signal, dispose: () => { clearTimeout(timer); parent?.removeEventListener("abort", abort); } };
+    return {
+        signal: controller.signal,
+        dispose: () => {
+            clearTimeout(timer);
+            parent?.removeEventListener("abort", abort);
+        },
+    };
 }
 function abortable(promise, signal) {
     if (signal.aborted)
@@ -466,11 +723,32 @@ function abortable(promise, signal) {
         promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
     });
 }
-function assertInput(input, maxBytes) { if (new TextEncoder().encode(input).byteLength > maxBytes)
-    throw new A2AError("A2A input exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT"); }
-function headersObject(headers) { return Object.fromEntries(new Headers(headers).entries()); }
-function isRecord(value) { return !!value && typeof value === "object" && !Array.isArray(value); }
-function stringArray(value) { return Array.isArray(value) && value.every((item) => typeof item === "string"); }
+function assertInput(input, maxBytes) {
+    if (new TextEncoder().encode(input).byteLength > maxBytes)
+        throw new A2AError("A2A input exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT");
+}
+function assertMessage(message, maxBytes) {
+    if (!message.messageId || !Array.isArray(message.parts) || message.parts.length === 0)
+        throw new A2AError("Invalid A2A outbound message", 400, "ERR_PRISM_A2A_MESSAGE");
+    let encoded;
+    try {
+        encoded = JSON.stringify(message);
+    }
+    catch {
+        throw new A2AError("Invalid A2A outbound message", 400, "ERR_PRISM_A2A_MESSAGE");
+    }
+    if (Buffer.byteLength(encoded, "utf8") > maxBytes)
+        throw new A2AError("A2A input exceeds max bytes", 413, "ERR_PRISM_A2A_REQUEST_LIMIT");
+}
+function headersObject(headers) {
+    return Object.fromEntries(new Headers(headers).entries());
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
 function parseSecurity(value) {
     if (value === undefined)
         return undefined;
@@ -482,5 +760,7 @@ function parseSecurity(value) {
         return entry;
     });
 }
-function safeRemote(message, options) { return options.redactor?.redact(message.slice(0, 1024)) ?? message.slice(0, 1024); }
+function safeRemote(message, options) {
+    return options.redactor?.redact(message.slice(0, 1024)) ?? message.slice(0, 1024);
+}
 //# sourceMappingURL=a2a-client.js.map

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

@@ -0,0 +1,42 @@
+import type { AgentEventSource, AgentRunRef, DurableAgentEventRecord } from "@arnilo/prism";
+import type { A2AAuthorization, A2ATask, A2ATaskEvent } from "./a2a-types.js";
+export type A2ATaskEventPayload = {
+    readonly task: A2ATask;
+} | {
+    readonly statusUpdate: Extract<A2ATaskEvent, {
+        readonly statusUpdate: unknown;
+    }>["statusUpdate"];
+} | {
+    readonly artifactUpdate: Extract<A2ATaskEvent, {
+        readonly artifactUpdate: unknown;
+    }>["artifactUpdate"];
+};
+export interface A2AAgentEventTask {
+    readonly task: A2ATask;
+    readonly run: AgentRunRef;
+}
+export interface A2AAgentEventSourceOptions {
+    readonly source: AgentEventSource;
+    /** Resolves only host-owned task state and its exact Prism run. */
+    readonly resolveTask: (input: {
+        readonly id: string;
+        readonly authorization: A2AAuthorization;
+        readonly signal: AbortSignal;
+    }) => A2AAgentEventTask | undefined | Promise<A2AAgentEventTask | undefined>;
+    /** Maps at most one durable Prism record to one A2A update. Event IDs stay source-owned cursors. */
+    readonly map: (input: {
+        readonly record: DurableAgentEventRecord;
+        readonly task: A2ATask;
+        readonly authorization: A2AAuthorization;
+    }) => A2ATaskEventPayload | undefined | Promise<A2ATaskEventPayload | undefined>;
+}
+export interface A2AAgentEventSource {
+    subscribe(input: {
+        readonly id: string;
+        readonly afterEventId?: string;
+        readonly authorization: A2AAuthorization;
+        readonly signal: AbortSignal;
+    }): AsyncIterable<A2ATaskEvent>;
+}
+/** Host-selected durable task stream over AgentEventSource; owns no task database or worker. */
+export declare function createA2AAgentEventSource(options: A2AAgentEventSourceOptions): A2AAgentEventSource;