@botbotgo/agent-harness 0.0.219 → 0.0.221

package/README.md

@@ -1024,7 +1024,7 @@ ACP transport notes:
 - `serveAcpHttp(runtime)` exposes JSON-RPC over HTTP plus SSE runtime events so remote operator surfaces can connect without importing the runtime in-process.
 - ACP transport validation now covers the reference-client core flow: capability discovery, request submit, session lookup, request lookup, invalid-JSON handling, notification calls without response ids, stdio JSON-RPC, and HTTP plus SSE runtime notifications.
 - For the thinnest editor or CLI starter, begin with `agent-harness acp serve --workspace . --transport stdio` and mirror the `examples/protocol-hello-world/app/acp-stdio-hello-world.mjs` wire shape. Applications that want an in-process reference client can use `createAcpStdioClient(...)` to issue JSON-RPC requests and route runtime notifications without hand-rolling line parsing.
-- `serveA2aHttp(runtime)` exposes an A2A-compatible HTTP JSON-RPC bridge plus agent card discovery, mapping both existing methods such as `message/send` and A2A v1.0 PascalCase methods such as `SendMessage`, `GetTask`, `ListTasks`, `CancelTask`, `SubscribeToTask`, and `GetExtendedAgentCard` onto the existing session/request runtime surface. The bridge now advertises both `1.0` and `0.3` JSON-RPC interfaces, validates `A2A-Version`, records `A2A-Extensions` into runtime invocation metadata, publishes `TASK_STATE_*` statuses plus the `{ task }` `SendMessage` wrapper, and still returns explicit unsupported errors for streaming or push notifications.
+- `serveA2aHttp(runtime)` exposes an A2A-compatible HTTP JSON-RPC bridge plus agent card discovery, mapping both existing methods such as `message/send` and A2A v1.0 PascalCase methods such as `SendMessage`, `SendStreamingMessage`, `GetTask`, `ListTasks`, `CancelTask`, `SubscribeToTask`, and `GetExtendedAgentCard` onto the existing session/request runtime surface. The bridge now advertises both `1.0` and `0.3` JSON-RPC interfaces, sets `capabilities.streaming = true`, validates `A2A-Version`, records `A2A-Extensions` into runtime invocation metadata, publishes `TASK_STATE_*` statuses plus the `{ task }` `SendMessage` wrapper, streams task snapshots over SSE for streaming methods, and still returns explicit unsupported errors for push notifications.
 - `serveAgUiHttp(runtime)` exposes an AG-UI-compatible HTTP SSE bridge that projects runtime lifecycle, text output, upstream thinking, step progress, and tool calls onto `RUN_*`, `TEXT_MESSAGE_*`, `THINKING_TEXT_MESSAGE_*`, `STEP_*`, and `TOOL_CALL_*` events for UI clients.
 - `createRuntimeMcpServer(runtime)` and `serveRuntimeMcpOverStdio(runtime)` expose the persisted runtime control surface itself as MCP tools, including sessions, requests, approvals, artifacts, events, and package export helpers.
 - `listRequestEvents(...)` and `exportRequestPackage(...)` are the request-first inspection helpers.

package/README.zh.md

@@ -982,7 +982,7 @@ ACP transport 说明：
 - `serveAcpHttp(runtime)` 提供基于 HTTP 的 JSON-RPC 与 SSE runtime events，适合远程界面或独立控制面接入。
 - ACP transport 现已覆盖核心参考客户端流程验证：capability discovery、request submit、session lookup、request lookup、invalid JSON 处理、无 id notification 不返回响应，以及 stdio JSON-RPC 与 HTTP + SSE runtime notifications。
 - 如果要从最薄的一层 editor / CLI starter 开始，优先用 `agent-harness acp serve --workspace . --transport stdio`，并直接参考 `examples/protocol-hello-world/app/acp-stdio-hello-world.mjs` 的 wire shape。需要在应用内使用 reference client 时，可直接用 `createAcpStdioClient(...)` 发起 JSON-RPC 请求并分流 runtime notifications，避免每个 sidecar 自己重写 line parsing。
-- `serveA2aHttp(runtime)` 提供 A2A HTTP JSON-RPC bridge 与 agent card discovery，同时兼容 `message/send` 这类旧方法，以及 `SendMessage`、`GetTask`、`ListTasks`、`CancelTask`、`SubscribeToTask`、`GetExtendedAgentCard` 这类 A2A v1.0 PascalCase 方法，并统一映射到现有 session/request 运行记录。bridge 现在会同时声明 `1.0` 与 `0.3` 两个 JSON-RPC interface、校验 `A2A-Version`、把 `A2A-Extensions` 记录进 runtime invocation metadata、发布 `TASK_STATE_*` 状态与 `SendMessage` 的 `{ task }` wrapper，并继续对 streaming 或 push notification 返回明确 unsupported error。
+- `serveA2aHttp(runtime)` 提供 A2A HTTP JSON-RPC bridge 与 agent card discovery，同时兼容 `message/send` 这类旧方法，以及 `SendMessage`、`SendStreamingMessage`、`GetTask`、`ListTasks`、`CancelTask`、`SubscribeToTask`、`GetExtendedAgentCard` 这类 A2A v1.0 PascalCase 方法，并统一映射到现有 session/request 运行记录。bridge 现在会同时声明 `1.0` 与 `0.3` 两个 JSON-RPC interface、把 `capabilities.streaming` 设为 `true`、校验 `A2A-Version`、把 `A2A-Extensions` 记录进 runtime invocation metadata、发布 `TASK_STATE_*` 状态与 `SendMessage` 的 `{ task }` wrapper，并在 streaming 方法上通过 SSE 输出 task snapshots；push notification 仍返回明确 unsupported error。
 - `serveAgUiHttp(runtime)` 提供 AG-UI HTTP SSE bridge，把 runtime 生命周期、文本输出、upstream thinking、step 进度与 tool call 投影成 `RUN_*`、`TEXT_MESSAGE_*`、`THINKING_TEXT_MESSAGE_*`、`STEP_*` 与 `TOOL_CALL_*` 事件，便于 UI 客户端直接接入。
 - `createRuntimeMcpServer(runtime)` 与 `serveRuntimeMcpOverStdio(runtime)` 会把持久化 runtime 控制面本身暴露成 MCP tools，包括 sessions、requests、approvals、artifacts、events 与 package export helpers。
 - `listRequestEvents(...)` 与 `exportRequestPackage(...)` 是 request-first 的检查 helper。

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.218";
+export declare const AGENT_HARNESS_VERSION = "0.0.220";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.218";
+export const AGENT_HARNESS_VERSION = "0.0.220";

package/dist/protocol/a2a/http.js

@@ -9,6 +9,23 @@ function writeJson(response, statusCode, payload) {
     response.setHeader("content-type", "application/json; charset=utf-8");
     response.end(JSON.stringify(payload));
 }
+function writeSseHeaders(response) {
+    response.statusCode = 200;
+    response.setHeader("content-type", "text/event-stream; charset=utf-8");
+    response.setHeader("cache-control", "no-cache, no-transform");
+    response.setHeader("connection", "keep-alive");
+}
+function writeSseEvent(response, event, payload) {
+    return new Promise((resolve, reject) => {
+        response.write(`event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`, (error) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        });
+    });
+}
 function readRequestBody(request) {
     return new Promise((resolve, reject) => {
         const chunks = [];
@@ -62,6 +79,14 @@ function parseA2aServiceParameters(requestUrl, request) {
             .filter((entry) => entry.length > 0),
     };
 }
+function acceptsSse(request) {
+    const accept = request.headers.accept;
+    if (accept === undefined) {
+        return false;
+    }
+    const values = Array.isArray(accept) ? accept : [accept];
+    return values.some((value) => value.includes("text/event-stream"));
+}
 function parseTextPart(part) {
     if (!part || typeof part !== "object" || Array.isArray(part)) {
         return null;
@@ -350,6 +375,28 @@ async function buildTaskFromRuntime(runtime, requestId) {
     const approvals = await runtime.listApprovals({ threadId: request.threadId, runId: request.runId });
     return buildTaskFromSessionAndRequest(toSessionRecord(session), toRequestRecord(request), approvals);
 }
+async function hydrateTaskStateFromEvents(runtime, task) {
+    if (!task) {
+        return null;
+    }
+    const events = await runtime.listRunEvents(task.contextId, task.id);
+    const lastStateChange = [...events].reverse().find((event) => event.eventType === "run.state.changed");
+    const observedState = typeof lastStateChange?.payload?.state === "string" ? lastStateChange.payload.state : undefined;
+    if (!observedState) {
+        return task;
+    }
+    return {
+        ...task,
+        status: {
+            ...task.status,
+            state: mapRunState(observedState),
+        },
+        metadata: {
+            ...task.metadata,
+            state: observedState,
+        },
+    };
+}
 async function listTasksFromRuntime(runtime, params) {
     const runState = mapTaskStatusToRunState(params.state);
     const runs = await runtime.listRuns({
@@ -400,7 +447,7 @@ function buildAgentCard(runtime, options) {
             },
         ],
         capabilities: {
-            streaming: false,
+            streaming: true,
             pushNotifications: false,
             extendedAgentCard: true,
         },
@@ -448,6 +495,174 @@ function toSendMessageResult(method, task) {
     }
     return { task };
 }
+function withStreamingStatusText(task, text) {
+    if (!task || typeof text !== "string" || text.length === 0) {
+        return task;
+    }
+    return {
+        ...task,
+        status: {
+            ...task.status,
+            message: {
+                role: "ROLE_AGENT",
+                messageId: `${task.id}:status`,
+                parts: toTextParts(text),
+            },
+        },
+    };
+}
+function withRunResult(task, result, streamedText) {
+    if (!task) {
+        return null;
+    }
+    const statusText = streamedText || result.output;
+    return {
+        ...task,
+        status: {
+            ...task.status,
+            state: mapRunState(result.state),
+            ...(statusText
+                ? {
+                    message: {
+                        role: "ROLE_AGENT",
+                        messageId: `${task.id}:status`,
+                        parts: toTextParts(statusText),
+                    },
+                }
+                : {}),
+        },
+        metadata: {
+            ...task.metadata,
+            state: result.state,
+        },
+    };
+}
+function isTerminalTaskState(state) {
+    return state === "TASK_STATE_COMPLETED" || state === "TASK_STATE_FAILED" || state === "TASK_STATE_CANCELED";
+}
+async function streamTaskUpdates(response, id, method, iterator) {
+    writeSseHeaders(response);
+    for await (const item of iterator) {
+        if (!item.task) {
+            continue;
+        }
+        await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, item.task)));
+    }
+    response.end();
+}
+async function* streamSendMessageTaskUpdates(runtime, options, method) {
+    let runId;
+    let streamedText = "";
+    for await (const item of runtime.streamEvents(options)) {
+        if (item.type === "event") {
+            runId = runId ?? item.event.runId;
+            if (item.event.eventType === "output.delta" && typeof item.event.payload.content === "string") {
+                streamedText += item.event.payload.content;
+            }
+            if (item.event.eventType === "run.created" || item.event.eventType === "run.state.changed" || item.event.eventType === "output.delta" || item.event.eventType === "approval.requested") {
+                const task = withStreamingStatusText(await buildTaskFromRuntime(runtime, item.event.runId), streamedText || undefined);
+                if (task) {
+                    yield { task };
+                }
+            }
+            continue;
+        }
+        if (item.type === "result") {
+            runId = item.result.runId;
+            const task = withRunResult(await buildTaskFromRuntime(runtime, item.result.runId), item.result, streamedText || item.result.output);
+            yield { task };
+            return;
+        }
+        if (item.type === "upstream-event" && runId) {
+            const task = withStreamingStatusText(await buildTaskFromRuntime(runtime, runId), streamedText || undefined);
+            if (task) {
+                yield { task };
+            }
+        }
+    }
+}
+async function streamExistingTaskUpdates(runtime, response, id, method, taskId) {
+    writeSseHeaders(response);
+    let currentTask = await hydrateTaskStateFromEvents(runtime, await buildTaskFromRuntime(runtime, taskId));
+    if (!currentTask) {
+        await writeSseEvent(response, "error", toError(id, -32001, "Task not found."));
+        response.end();
+        return;
+    }
+    await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, currentTask)));
+    if (isTerminalTaskState(currentTask.status.state)) {
+        response.end();
+        return;
+    }
+    await new Promise((resolve) => {
+        let closed = false;
+        let idleTimer;
+        let lastFingerprint = JSON.stringify({
+            state: currentTask?.status.state,
+            message: currentTask?.status.message,
+        });
+        const armIdleTimer = () => {
+            if (idleTimer) {
+                clearTimeout(idleTimer);
+            }
+            idleTimer = setTimeout(() => {
+                response.end();
+                finish();
+            }, 1_000);
+        };
+        const finish = () => {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            unsubscribe();
+            clearInterval(pollTimer);
+            if (idleTimer) {
+                clearTimeout(idleTimer);
+            }
+            resolve();
+        };
+        const emitLatestTask = async () => {
+            currentTask = await hydrateTaskStateFromEvents(runtime, await buildTaskFromRuntime(runtime, taskId));
+            if (!currentTask) {
+                await writeSseEvent(response, "error", toError(id, -32001, "Task not found."));
+                response.end();
+                finish();
+                return;
+            }
+            const fingerprint = JSON.stringify({
+                state: currentTask.status.state,
+                message: currentTask.status.message,
+            });
+            if (fingerprint !== lastFingerprint) {
+                lastFingerprint = fingerprint;
+                await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, currentTask)));
+                armIdleTimer();
+            }
+            if (isTerminalTaskState(currentTask.status.state)) {
+                response.end();
+                finish();
+            }
+        };
+        const unsubscribe = runtime.subscribe((event) => {
+            if (event.runId !== taskId) {
+                return;
+            }
+            if (event.eventType !== "run.state.changed"
+                && event.eventType !== "output.delta"
+                && event.eventType !== "approval.requested"
+                && event.eventType !== "approval.resolved") {
+                return;
+            }
+            void emitLatestTask();
+        });
+        const pollTimer = setInterval(() => {
+            void emitLatestTask();
+        }, 250);
+        armIdleTimer();
+        response.on("close", finish);
+    });
+}
 export async function serveA2aOverHttp(runtime, options = {}) {
     const hostname = options.hostname?.trim() || "127.0.0.1";
     const port = typeof options.port === "number" && Number.isFinite(options.port) ? options.port : 0;
@@ -507,8 +722,18 @@ export async function serveA2aOverHttp(runtime, options = {}) {
                         writeJson(response, 200, toSuccess(payload.id ?? null, toSendMessageResult(payload.method, task)));
                         return;
                     }
-                    if (payload.method === "SendStreamingMessage") {
-                        writeJson(response, 200, toError(payload.id ?? null, -32004, "A2A streaming is not supported by this bridge."));
+                    if (payload.method === "message/stream" || payload.method === "SendStreamingMessage") {
+                        if (!acceptsSse(request)) {
+                            writeJson(response, 406, toError(payload.id ?? null, -32004, "A2A streaming requires `Accept: text/event-stream`."));
+                            return;
+                        }
+                        const parsed = parseMessageSendParams(payload.params);
+                        await streamTaskUpdates(response, payload.id ?? null, payload.method, streamSendMessageTaskUpdates(runtime, {
+                            agentId: parsed.agentId ?? options.defaultAgentId,
+                            input: parsed.input,
+                            ...(parsed.sessionId ? { threadId: parsed.sessionId } : {}),
+                            invocation: attachServiceParameters(parsed.invocation, serviceParameters),
+                        }, payload.method));
                         return;
                     }
                     if (payload.method === "tasks/get" || payload.method === "GetTask") {
@@ -541,7 +766,11 @@ export async function serveA2aOverHttp(runtime, options = {}) {
                             return;
                         }
                         if (payload.method === "SubscribeToTask") {
-                            writeJson(response, 200, toError(payload.id ?? null, -32004, "A2A streaming subscriptions are not supported by this bridge."));
+                            if (!acceptsSse(request)) {
+                                writeJson(response, 406, toError(payload.id ?? null, -32004, "A2A streaming subscriptions require `Accept: text/event-stream`."));
+                                return;
+                            }
+                            await streamExistingTaskUpdates(runtime, response, payload.id ?? null, payload.method, taskId);
                             return;
                         }
                         writeJson(response, 200, toSuccess(payload.id ?? null, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.219",
+  "version": "0.0.221",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",