@botbotgo/agent-harness 0.0.216 → 0.0.218

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`, and `SubscribeToTask` onto the existing session/request runtime surface. The v1.0 path publishes `supportedInterfaces`, `TASK_STATE_*` statuses, the `{ task }` `SendMessage` wrapper, and 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`, `GetTask`, `ListTasks`, `CancelTask`, `SubscribeToTask`, and `GetExtendedAgentCard` onto the existing session/request runtime surface. The v1.0 path publishes `supportedInterfaces`, `TASK_STATE_*` statuses, the `{ task }` `SendMessage` wrapper, an extended agent card with runtime discovery metadata, and explicit unsupported errors for streaming or 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` 这类 A2A v1.0 PascalCase 方法，并统一映射到现有 session/request 运行记录。v1.0 路径会发布 `supportedInterfaces`、`TASK_STATE_*` 状态、`SendMessage` 的 `{ task }` wrapper，并对 streaming 或 push notification 返回明确 unsupported error。
+- `serveA2aHttp(runtime)` 提供 A2A HTTP JSON-RPC bridge 与 agent card discovery，同时兼容 `message/send` 这类旧方法，以及 `SendMessage`、`GetTask`、`ListTasks`、`CancelTask`、`SubscribeToTask`、`GetExtendedAgentCard` 这类 A2A v1.0 PascalCase 方法，并统一映射到现有 session/request 运行记录。v1.0 路径会发布 `supportedInterfaces`、`TASK_STATE_*` 状态、`SendMessage` 的 `{ task }` wrapper、带 runtime discovery metadata 的 extended agent card，并对 streaming 或 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.215";
+export declare const AGENT_HARNESS_VERSION = "0.0.217";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.215";
+export const AGENT_HARNESS_VERSION = "0.0.217";

package/dist/protocol/a2a/http.d.ts

@@ -46,6 +46,28 @@ export type A2aAgentCard = {
         examples: string[];
     }>;
 };
+export type A2aExtendedAgentCard = A2aAgentCard & {
+    metadata: {
+        agentHarness: {
+            runtime: {
+                product: "agent-harness";
+                protocolSurface: "a2a-http";
+                defaultAgentId?: string;
+            };
+            protocolSurfaces: string[];
+            inventory: {
+                agentCount: number;
+                subagentCount: number;
+            };
+            agents: Array<{
+                id: string;
+                name: string;
+                description: string;
+                kind: "agent" | "subagent";
+            }>;
+        };
+    };
+};
 export type A2aTaskState = "TASK_STATE_SUBMITTED" | "TASK_STATE_WORKING" | "TASK_STATE_INPUT_REQUIRED" | "TASK_STATE_COMPLETED" | "TASK_STATE_FAILED" | "TASK_STATE_CANCELED";
 type A2aTaskStatus = {
     state: A2aTaskState;

package/dist/protocol/a2a/http.js

@@ -357,11 +357,41 @@ function buildAgentCard(runtime, options) {
         capabilities: {
             streaming: false,
             pushNotifications: false,
-            extendedAgentCard: false,
+            extendedAgentCard: true,
         },
         defaultInputModes: ["text/plain"],
         defaultOutputModes: ["text/plain"],
         skills,
+        ...(options.documentationUrl ? { documentationUrl: options.documentationUrl } : {}),
+        ...(options.provider ? { provider: options.provider } : {}),
+        ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
+    };
+}
+function buildExtendedAgentCard(runtime, options) {
+    const inventory = runtime.describeWorkspaceInventory();
+    const card = buildAgentCard(runtime, options);
+    return {
+        ...card,
+        metadata: {
+            agentHarness: {
+                runtime: {
+                    product: "agent-harness",
+                    protocolSurface: "a2a-http",
+                    ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
+                },
+                protocolSurfaces: ["A2A", "ACP", "AG-UI", "runtime MCP"],
+                inventory: {
+                    agentCount: inventory.agents.length,
+                    subagentCount: inventory.agents.filter((agent) => Boolean(agent.parentAgentId)).length,
+                },
+                agents: inventory.agents.map((agent) => ({
+                    id: agent.id,
+                    name: agent.id,
+                    description: agent.description || `Agent ${agent.id}`,
+                    kind: agent.parentAgentId ? "subagent" : "agent",
+                })),
+            },
+        },
     };
 }
 function isV1Method(method) {
@@ -378,22 +408,19 @@ export async function serveA2aOverHttp(runtime, options = {}) {
     const port = typeof options.port === "number" && Number.isFinite(options.port) ? options.port : 0;
     const rpcPath = normalizePath(options.rpcPath, "/a2a");
     const agentCardPath = normalizePath(options.agentCardPath, "/.well-known/agent-card.json");
+    const buildCardOptions = () => ({
+        agentName: options.agentName ?? "agent-harness-runtime",
+        agentDescription: options.agentDescription ?? "Agent-harness A2A bridge over the persisted runtime surface.",
+        rpcUrl: `http://${hostname}:${resolvedPort}${rpcPath}`,
+        ...(options.documentationUrl ? { documentationUrl: options.documentationUrl } : {}),
+        ...(options.provider ? { provider: options.provider } : {}),
+        ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
+    });
     const httpServer = createServer(async (request, response) => {
         try {
             const requestUrl = new URL(request.url ?? "/", `http://${hostname}`);
             if (request.method === "GET" && (requestUrl.pathname === agentCardPath || requestUrl.pathname === "/.well-known/agent.json")) {
-                const card = buildAgentCard(runtime, {
-                    agentName: options.agentName ?? "agent-harness-runtime",
-                    agentDescription: options.agentDescription ?? "Agent-harness A2A bridge over the persisted runtime surface.",
-                    cardUrl: `http://${hostname}:${resolvedPort}${agentCardPath}`,
-                    rpcUrl: `http://${hostname}:${resolvedPort}${rpcPath}`,
-                });
-                writeJson(response, 200, {
-                    ...card,
-                    ...(options.documentationUrl ? { documentationUrl: options.documentationUrl } : {}),
-                    ...(options.provider ? { provider: options.provider } : {}),
-                    ...(options.defaultAgentId ? { defaultAgentId: options.defaultAgentId } : {}),
-                });
+                writeJson(response, 200, buildAgentCard(runtime, buildCardOptions()));
                 return;
             }
             if (request.method === "POST" && (requestUrl.pathname === rpcPath || requestUrl.pathname === agentCardPath)) {
@@ -480,7 +507,7 @@ export async function serveA2aOverHttp(runtime, options = {}) {
                         return;
                     }
                     if (payload.method === "GetExtendedAgentCard") {
-                        writeJson(response, 200, toError(payload.id ?? null, -32004, "A2A extended agent cards are not supported by this bridge."));
+                        writeJson(response, 200, toSuccess(payload.id ?? null, buildExtendedAgentCard(runtime, buildCardOptions())));
                         return;
                     }
                     writeJson(response, 200, toError(payload.id ?? null, -32601, `Unknown A2A method: ${payload.method}`));

package/package.json

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