@botbotgo/agent-harness 0.0.225 → 0.0.227

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`, `SendStreamingMessage`, `GetTask`, `ListTasks`, `CancelTask`, `SubscribeToTask`, `GetExtendedAgentCard`, and task push-notification config methods onto the existing session/request runtime surface. The bridge now advertises both `1.0` and `0.3` JSON-RPC interfaces, sets `capabilities.streaming = true` plus `capabilities.pushNotifications = 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 can send best-effort webhook task snapshots for configured push notification receivers.
+- `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`, `GetExtendedAgentCard`, and task push-notification config methods onto the existing session/request runtime surface. The bridge now advertises both `1.0` and `0.3` JSON-RPC interfaces, sets `capabilities.streaming = true` plus `capabilities.pushNotifications = true`, validates `A2A-Version`, records `A2A-Extensions` into runtime invocation metadata, publishes `TASK_STATE_*` statuses plus the `{ task }` `SendMessage` wrapper, streams an initial `{ task }` snapshot plus later `{ statusUpdate }` payloads over SSE for v1 streaming methods, and can send best-effort webhook task snapshots for configured push notification receivers.
 - `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`、`SendStreamingMessage`、`GetTask`、`ListTasks`、`CancelTask`、`SubscribeToTask`、`GetExtendedAgentCard` 与 task push-notification config 这类 A2A v1.0 方法，并统一映射到现有 session/request 运行记录。bridge 现在会同时声明 `1.0` 与 `0.3` 两个 JSON-RPC interface、把 `capabilities.streaming` 和 `capabilities.pushNotifications` 都设为 `true`、校验 `A2A-Version`、把 `A2A-Extensions` 记录进 runtime invocation metadata、发布 `TASK_STATE_*` 状态与 `SendMessage` 的 `{ task }` wrapper、在 streaming 方法上通过 SSE 输出 task snapshots，并可向已配置的 webhook receiver 发送 best-effort task push notifications。
+- `serveA2aHttp(runtime)` 提供 A2A HTTP JSON-RPC bridge 与 agent card discovery，同时兼容 `message/send` 这类旧方法，以及 `SendMessage`、`SendStreamingMessage`、`GetTask`、`ListTasks`、`CancelTask`、`SubscribeToTask`、`GetExtendedAgentCard` 与 task push-notification config 这类 A2A v1.0 方法，并统一映射到现有 session/request 运行记录。bridge 现在会同时声明 `1.0` 与 `0.3` 两个 JSON-RPC interface、把 `capabilities.streaming` 和 `capabilities.pushNotifications` 都设为 `true`、校验 `A2A-Version`、把 `A2A-Extensions` 记录进 runtime invocation metadata、发布 `TASK_STATE_*` 状态与 `SendMessage` 的 `{ task }` wrapper、在 v1 streaming 方法上先通过 SSE 输出 `{ task }` 初始快照，再输出 `{ statusUpdate }` 增量状态，并可向已配置的 webhook receiver 发送 best-effort task push notifications。
 - `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.224";
+export declare const AGENT_HARNESS_VERSION = "0.0.226";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.224";
+export const AGENT_HARNESS_VERSION = "0.0.226";

package/dist/protocol/a2a/http.js

@@ -593,6 +593,30 @@ function toSendMessageResult(method, task) {
     }
     return { task };
 }
+function toStatusUpdate(task) {
+    return {
+        taskId: task.id,
+        contextId: task.contextId,
+        kind: "status-update",
+        status: task.status,
+        final: isTerminalTaskState(task.status.state),
+        metadata: task.metadata,
+    };
+}
+function toStreamingResult(method, task, mode) {
+    if (!task) {
+        return null;
+    }
+    if (!isV1Method(method)) {
+        return task;
+    }
+    if (mode === "status-update") {
+        return {
+            statusUpdate: toStatusUpdate(task),
+        };
+    }
+    return { task };
+}
 function withStreamingStatusText(task, text) {
     if (!task || typeof text !== "string" || text.length === 0) {
         return task;
@@ -680,13 +704,14 @@ async function streamTaskUpdates(response, id, method, iterator) {
         if (!item.task) {
             continue;
         }
-        await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, item.task)));
+        await writeSseEvent(response, "task-update", toSuccess(id, toStreamingResult(method, item.task, item.mode)));
     }
     response.end();
 }
 async function* streamSendMessageTaskUpdates(runtime, options, method) {
     let runId;
     let streamedText = "";
+    let emittedInitialTask = false;
     for await (const item of runtime.streamEvents(options)) {
         if (item.type === "event") {
             runId = runId ?? item.event.runId;
@@ -696,7 +721,8 @@ async function* streamSendMessageTaskUpdates(runtime, options, method) {
             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 };
+                    yield { task, mode: emittedInitialTask ? "status-update" : "task" };
+                    emittedInitialTask = true;
                 }
             }
             continue;
@@ -704,13 +730,14 @@ async function* streamSendMessageTaskUpdates(runtime, options, method) {
         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 };
+            yield { task, mode: emittedInitialTask ? "status-update" : "task" };
             return;
         }
         if (item.type === "upstream-event" && runId) {
             const task = withStreamingStatusText(await buildTaskFromRuntime(runtime, runId), streamedText || undefined);
             if (task) {
-                yield { task };
+                yield { task, mode: emittedInitialTask ? "status-update" : "task" };
+                emittedInitialTask = true;
             }
         }
     }
@@ -723,7 +750,7 @@ async function streamExistingTaskUpdates(runtime, response, id, method, taskId)
         response.end();
         return;
     }
-    await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, currentTask)));
+    await writeSseEvent(response, "task-update", toSuccess(id, toStreamingResult(method, currentTask, "task")));
     if (isTerminalTaskState(currentTask.status.state)) {
         response.end();
         return;
@@ -770,7 +797,7 @@ async function streamExistingTaskUpdates(runtime, response, id, method, taskId)
             });
             if (fingerprint !== lastFingerprint) {
                 lastFingerprint = fingerprint;
-                await writeSseEvent(response, "task-update", toSuccess(id, toSendMessageResult(method, currentTask)));
+                await writeSseEvent(response, "task-update", toSuccess(id, toStreamingResult(method, currentTask, isV1Method(method) ? "status-update" : "task")));
                 armIdleTimer();
             }
             if (isTerminalTaskState(currentTask.status.state)) {

package/dist/resource/resource-impl.js

@@ -105,8 +105,8 @@ class CompatibleCompositeBackend {
                     : (command) => this.composite.execute(command);
         }
     }
-    lsInfo(filePath) {
-        return this.composite.lsInfo(filePath);
+    ls(filePath) {
+        return this.composite.ls(filePath);
     }
     read(filePath, offset, limit) {
         return this.composite.read(filePath, offset, limit);
@@ -114,11 +114,11 @@ class CompatibleCompositeBackend {
     readRaw(filePath) {
         return this.composite.readRaw(filePath);
     }
-    grepRaw(pattern, filePath, glob) {
-        return this.composite.grepRaw(pattern, filePath ?? undefined, glob ?? undefined);
+    grep(pattern, filePath, glob) {
+        return this.composite.grep(pattern, filePath ?? undefined, glob ?? undefined);
     }
-    globInfo(pattern, filePath) {
-        return this.composite.globInfo(pattern, filePath);
+    glob(pattern, filePath) {
+        return this.composite.glob(pattern, filePath);
     }
     write(filePath, content) {
         return this.composite.write(filePath, content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.225",
+  "version": "0.0.227",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",
@@ -54,8 +54,8 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@qdrant/js-client-rest": "^1.17.0",
     "better-sqlite3": "^12.8.0",
-    "deepagents": "1.8.4",
-    "langchain": "^1.2.36",
+    "deepagents": "^1.9.0",
+    "langchain": "^1.3.1",
     "llamaindex": "^0.12.1",
     "mem0ai": "^2.4.6",
     "mustache": "^4.2.0",