@botbotgo/agent-harness 0.0.367 → 0.0.370

package/dist/cli/chat-stream.js

@@ -371,6 +371,16 @@ export async function streamChatMessage(input) {
                 renderContentBlocks(delta.contentBlocks, delta.agentId);
                 return;
             }
+            if (delta.type === "plan.step") {
+                latestAgentId = delta.agentId || latestAgentId;
+                const item = delta.item;
+                const status = typeof item?.status === "string" ? item.status : "unknown";
+                const content = typeof item?.content === "string" ? item.content : "";
+                if ((input.showToolResults ?? true) && !input.requestEvents && content.trim().length > 0) {
+                    writeChatStderr(`\n[${formatPerfClock(Date.now())} +${formatElapsed(Date.now())}]${formatAgentProgressLabel(delta.agentId)} [todo:${status}] ${content}\n`);
+                }
+                return;
+            }
             if (delta.type === "tool.result") {
                 latestAgentId = delta.agentId || latestAgentId;
                 if ((input.showToolResults ?? true) && !input.requestEvents) {

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.367";
+export declare const AGENT_HARNESS_VERSION = "0.0.370";
 export declare const AGENT_HARNESS_RELEASE_DATE = "2026-04-30";

package/dist/package-version.js

@@ -1,2 +1,2 @@
-export const AGENT_HARNESS_VERSION = "0.0.367";
+export const AGENT_HARNESS_VERSION = "0.0.370";
 export const AGENT_HARNESS_RELEASE_DATE = "2026-04-30";

package/dist/runtime/agent-runtime-adapter.d.ts

@@ -59,6 +59,8 @@ export declare class AgentRuntimeAdapter {
     }): Promise<RequestResult>;
     private tryDelegateWithCompactRouter;
     private buildCompactDelegationReport;
+    private formatCompactDelegationReportForDisplay;
+    private streamDelegateWithCompactRouter;
     stream(binding: CompiledAgentBinding, input: MessageContent, sessionId: string, history?: TranscriptMessage[], options?: {
         context?: Record<string, unknown>;
         state?: Record<string, unknown>;

package/dist/runtime/agent-runtime-adapter.js

@@ -1139,6 +1139,224 @@ export class AgentRuntimeAdapter {
             report,
         };
     }
+    formatCompactDelegationReportForDisplay(report) {
+        const readStringArray = (key) => {
+            const value = report[key];
+            return Array.isArray(value)
+                ? value.filter((item) => typeof item === "string" && item.trim().length > 0)
+                : [];
+        };
+        const lines = [];
+        const reportText = typeof report.report === "string" ? report.report.trim() : "";
+        if (reportText) {
+            lines.push(reportText);
+        }
+        const sections = [
+            ["Routing", readStringArray("routing")],
+            ["TODO Trace", readStringArray("todoTrace")],
+            ["Step Results", readStringArray("stepResults")],
+            ["Summary", readStringArray("summary")],
+            ["Findings", readStringArray("findings")],
+            ["Blockers", readStringArray("blockers")],
+            ["Next Actions", readStringArray("nextActions")],
+        ];
+        for (const [title, items] of sections) {
+            if (items.length === 0 || (items.length === 1 && items[0]?.toLowerCase() === "none")) {
+                continue;
+            }
+            if (lines.length > 0) {
+                lines.push("");
+            }
+            lines.push(`## ${title}`);
+            lines.push(...items.map((item) => `- ${item}`));
+        }
+        return lines.join("\n");
+    }
+    async *streamDelegateWithCompactRouter(binding, input, sessionId, requestId, options = {}) {
+        if (!isDelegationOnlyDeepAgentBinding(binding) || !this.options.bindingResolver) {
+            return null;
+        }
+        const primaryModel = getBindingPrimaryModel(binding);
+        if (!primaryModel) {
+            return null;
+        }
+        const requestText = extractMessageText(input).trim();
+        if (!requestText) {
+            return null;
+        }
+        const subagents = getBindingSubagents(binding);
+        const subagentNames = new Set(subagents.map((subagent) => subagent.name));
+        const subagentCatalog = subagents
+            .map((subagent) => `- ${subagent.name}: ${subagent.description}`)
+            .join("\n");
+        const routingPolicy = getBindingSystemPrompt(binding);
+        const prompt = [
+            primaryModel.init?.think === false ? "/no_think" : "",
+            "You are selecting a subagent for a delegation-only agent.",
+            "Choose exactly one listed subagent when it can responsibly handle the request.",
+            routingPolicy ? "Agent routing policy:" : "",
+            routingPolicy ?? "",
+            "Return only JSON with this shape:",
+            "{\"subagent_type\":\"<listed subagent name>\"}",
+            "If no listed subagent can handle the request, return only:",
+            "{\"status\":\"refused\",\"reason\":\"No configured subagent can handle the request.\"}",
+            "Available subagents:",
+            subagentCatalog,
+            "User request:",
+            requestText,
+        ].filter(Boolean).join("\n\n");
+        const model = await this.resolveModel(primaryModel);
+        if (typeof model.invoke !== "function") {
+            return null;
+        }
+        const invokeRouter = async (activePrompt, operationName) => this.invokeWithProviderRetry(binding, () => this.withTimeout(() => model.invoke(activePrompt, resolveLangChainInvocationConfig(binding, {
+            sessionId,
+            requestId,
+            context: options.context,
+            toolRuntimeContext: this.buildFunctionToolRuntimeContext(binding, {
+                ...options,
+                sessionId,
+                requestId,
+            }),
+        })), resolveBindingTimeout(binding), operationName, "invoke"));
+        const routerPrompts = [
+            prompt,
+            [
+                prompt,
+                "Your previous router output was invalid.",
+                "Return only one JSON object now. Do not include prose, markdown, labels, or tool-call wrappers.",
+            ].join("\n\n"),
+            [
+                primaryModel.init?.think === false ? "/no_think" : "",
+                "Select one subagent from this exact list:",
+                Array.from(subagentNames).join(", "),
+                "Return JSON only:",
+                "{\"subagent_type\":\"<one exact listed name>\"}",
+                "User request:",
+                requestText,
+            ].filter(Boolean).join("\n\n"),
+            [
+                primaryModel.init?.think === false ? "/no_think" : "",
+                "JSON only. Pick a listed subagent or refuse.",
+                "Listed subagents:",
+                Array.from(subagentNames).join(", "),
+                "Allowed outputs:",
+                "{\"subagent_type\":\"<listed name>\"}",
+                "{\"status\":\"refused\",\"reason\":\"No configured subagent can handle the request.\"}",
+                "Request:",
+                requestText,
+            ].filter(Boolean).join("\n\n"),
+        ];
+        let selection = null;
+        let previousRawText = "";
+        for (let index = 0; index < routerPrompts.length && !selection; index += 1) {
+            const activePrompt = index <= 1 || !previousRawText
+                ? routerPrompts[index]
+                : [routerPrompts[index], "Previous output:", previousRawText].join("\n\n");
+            const raw = await invokeRouter(activePrompt, index === 0 ? "delegation router invoke" : `delegation router retry invoke ${index}`);
+            previousRawText = readModelText(raw);
+            selection = parseCompactRouterSelection(previousRawText, subagentNames);
+        }
+        if (selection?.refusedReason) {
+            return {
+                toolOutput: selection.refusedReason,
+                delegatedSubagentType: null,
+                delegatedResult: {
+                    sessionId,
+                    requestId,
+                    agentId: binding.agent.id,
+                    state: "failed",
+                    output: selection.refusedReason,
+                    finalMessageText: selection.refusedReason,
+                },
+            };
+        }
+        let subagentType = selection?.subagentType ?? "";
+        if (!subagentNames.has(subagentType)) {
+            const fallbackSubagent = subagentNames.values().next().value;
+            if (typeof fallbackSubagent === "string" && fallbackSubagent) {
+                subagentType = fallbackSubagent;
+            }
+            else {
+                return null;
+            }
+        }
+        const selectedBinding = this.options.bindingResolver(subagentType);
+        if (!selectedBinding) {
+            return null;
+        }
+        yield {
+            kind: "commentary",
+            content: `Delegating to ${subagentType}.`,
+            agentId: binding.agent.id,
+        };
+        yield {
+            kind: "commentary",
+            content: "Starting delegated execution.",
+            agentId: selectedBinding.agent.id,
+        };
+        const childRequestId = `${requestId}:${subagentType}`;
+        const executedToolResults = [];
+        let output = "";
+        try {
+            for await (const chunk of this.stream(selectedBinding, requestText, sessionId, [], {
+                context: options.context,
+                state: options.state,
+                files: options.files,
+                requestId: childRequestId,
+                memoryContext: options.memoryContext,
+                profiling: options.profiling,
+                toolRuntimeContext: options.toolRuntimeContext,
+            })) {
+                if (typeof chunk === "string") {
+                    output += chunk;
+                    continue;
+                }
+                if (chunk.kind === "content") {
+                    output += chunk.content ?? "";
+                    continue;
+                }
+                if (chunk.kind === "tool-result") {
+                    executedToolResults.push({
+                        toolName: chunk.toolName,
+                        output: chunk.output,
+                        ...(chunk.isError !== undefined ? { isError: chunk.isError } : {}),
+                    });
+                }
+                yield { ...chunk, agentId: chunk.agentId ?? selectedBinding.agent.id };
+            }
+        }
+        catch (error) {
+            output = error instanceof Error ? error.message : String(error);
+            return {
+                toolOutput: output,
+                delegatedSubagentType: subagentType,
+                delegatedResult: {
+                    sessionId,
+                    requestId: childRequestId,
+                    agentId: selectedBinding.agent.id,
+                    state: "failed",
+                    output,
+                    finalMessageText: output,
+                    metadata: { executedToolResults },
+                },
+            };
+        }
+        const delegatedResult = {
+            sessionId,
+            requestId: childRequestId,
+            agentId: selectedBinding.agent.id,
+            state: "completed",
+            output: sanitizeVisibleText(output),
+            finalMessageText: sanitizeVisibleText(output),
+            metadata: { executedToolResults },
+        };
+        return {
+            toolOutput: resolveDelegatedResultOutput(delegatedResult),
+            delegatedSubagentType: subagentType,
+            delegatedResult,
+        };
+    }
     async *stream(binding, input, sessionId, history = [], options = {}) {
         const directListing = await this.tryHandleDirectWorkspaceListing(binding, input, {
             ...options,
@@ -1163,11 +1381,7 @@ export class AgentRuntimeAdapter {
                 content: "Selecting a specialist for delegated execution.",
             };
         }
-        const compactDelegation = await this.tryDelegateWithCompactRouter(binding, input, sessionId, options.requestId ?? sessionId, {
-            ...options,
-            sessionId,
-            requestId: options.requestId,
-        });
+        const compactDelegation = yield* this.streamDelegateWithCompactRouter(binding, input, sessionId, options.requestId ?? sessionId, options);
         if (compactDelegation) {
             const compactReport = this.buildCompactDelegationReport(compactDelegation);
             yield {
@@ -1177,9 +1391,9 @@ export class AgentRuntimeAdapter {
             };
             yield {
                 kind: "content",
-                content: JSON.stringify(compactDelegation.delegatedSubagentType === null
-                    ? compactDelegation.toolOutput
-                    : compactReport),
+                content: compactDelegation.delegatedSubagentType === null
+                    ? String(compactDelegation.toolOutput ?? "")
+                    : this.formatCompactDelegationReportForDisplay(compactReport),
             };
             return;
         }

package/dist/runtime/harness/run/stream-run.d.ts

@@ -3,6 +3,7 @@ import { type InternalHarnessStreamItem } from "../events/streaming.js";
 type RuntimeStreamChunk = {
     kind: "commentary";
     content: string;
+    agentId?: string;
 } | string | {
     kind: "content" | "interrupt" | "reasoning" | "tool-result" | "upstream-event";
     content?: string;
@@ -10,9 +11,11 @@ type RuntimeStreamChunk = {
     output?: unknown;
     isError?: boolean;
     event?: unknown;
+    agentId?: string;
 } | {
     kind: "profile";
     step: RequestExecutionStep;
+    agentId?: string;
 };
 type StreamRunOptions = {
     binding: CompiledAgentBinding;

package/dist/runtime/harness/run/stream-run.js

@@ -284,16 +284,16 @@ function normalizeStreamChunk(chunk) {
         return { kind: "content", content: chunk };
     }
     if (chunk.kind === "commentary") {
-        return { kind: "commentary", content: chunk.content ?? "" };
+        return { kind: "commentary", content: chunk.content ?? "", agentId: chunk.agentId };
     }
     if (chunk.kind === "upstream-event") {
-        return { kind: "upstream-event", event: (chunk.event ?? {}) };
+        return { kind: "upstream-event", event: (chunk.event ?? {}), agentId: chunk.agentId };
     }
     if (chunk.kind === "interrupt") {
-        return { kind: "interrupt", content: chunk.content };
+        return { kind: "interrupt", content: chunk.content, agentId: chunk.agentId };
     }
     if (chunk.kind === "reasoning") {
-        return { kind: "reasoning", content: chunk.content ?? "" };
+        return { kind: "reasoning", content: chunk.content ?? "", agentId: chunk.agentId };
     }
     if (chunk.kind === "tool-result") {
         return {
@@ -301,15 +301,17 @@ function normalizeStreamChunk(chunk) {
             toolName: chunk.toolName ?? "unknown_tool",
             output: chunk.output,
             isError: chunk.isError,
+            agentId: chunk.agentId,
         };
     }
     if (chunk.kind === "profile") {
         return {
             kind: "profile",
             step: chunk.step,
+            agentId: chunk.agentId,
         };
     }
-    return { kind: "content", content: chunk.content ?? "" };
+    return { kind: "content", content: chunk.content ?? "", agentId: chunk.agentId };
 }
 function normalizeCommentaryText(value) {
     return value
@@ -645,7 +647,7 @@ export async function* streamHarnessRun(options) {
     let lastToolResultKey = null;
     const executedToolResults = [];
     const emittedCommentary = new Set();
-    const emitCommentary = function* (content) {
+    const emitCommentary = function* (content, agentIdOverride) {
         const normalized = normalizeCommentaryText(content);
         if (!normalized || emittedCommentary.has(normalized)) {
             return;
@@ -655,7 +657,7 @@ export async function* streamHarnessRun(options) {
             type: "commentary",
             sessionId: options.sessionId,
             requestId: options.requestId,
-            agentId: currentAgentId,
+            agentId: agentIdOverride ?? currentAgentId,
             content: normalized,
         };
     };
@@ -804,7 +806,7 @@ export async function* streamHarnessRun(options) {
                 return;
             }
             if (normalizedChunk.kind === "commentary") {
-                yield* emitCommentary(normalizedChunk.content);
+                yield* emitCommentary(normalizedChunk.content, normalizedChunk.agentId);
                 continue;
             }
             if (normalizedChunk.kind === "reasoning") {
@@ -824,6 +826,7 @@ export async function* streamHarnessRun(options) {
                 continue;
             }
             if (normalizedChunk.kind === "tool-result") {
+                const chunkAgentId = normalizedChunk.agentId ?? currentAgentId;
                 const toolResultKey = createToolResultKey(normalizedChunk.toolName, normalizedChunk.output, normalizedChunk.isError);
                 if (toolResultKey === lastToolResultKey) {
                     continue;
@@ -844,7 +847,7 @@ export async function* streamHarnessRun(options) {
                     type: "tool-result",
                     sessionId: options.sessionId,
                     requestId: options.requestId,
-                    agentId: currentAgentId,
+                    agentId: chunkAgentId,
                     toolName: normalizedChunk.toolName,
                     output: normalizedChunk.output,
                     isError: normalizedChunk.isError,
@@ -873,16 +876,16 @@ export async function* streamHarnessRun(options) {
                         currentPlanState = mergedPlanState;
                         const progression = buildPlanStateProgression(previousPlanState, currentPlanState);
                         for (const progressionStep of progression) {
-                            for (const item of await emitPlanStateUpdate(options, currentAgentId, progressionStep.planState)) {
+                            for (const item of await emitPlanStateUpdate(options, chunkAgentId, progressionStep.planState)) {
                                 yield item;
                             }
                             if (progressionStep.commentary) {
-                                yield* emitCommentary(progressionStep.commentary);
+                                yield* emitCommentary(progressionStep.commentary, chunkAgentId);
                             }
                         }
                         const commentary = summarizePlanState(currentPlanState);
                         if (commentary) {
-                            yield* emitCommentary(commentary);
+                            yield* emitCommentary(commentary, chunkAgentId);
                         }
                     }
                 }
@@ -899,16 +902,16 @@ export async function* streamHarnessRun(options) {
                         currentPlanState = reconciledPlanState;
                         const progression = buildPlanStateProgression(previousPlanState, currentPlanState);
                         for (const progressionStep of progression) {
-                            for (const item of await emitPlanStateUpdate(options, currentAgentId, progressionStep.planState)) {
+                            for (const item of await emitPlanStateUpdate(options, chunkAgentId, progressionStep.planState)) {
                                 yield item;
                             }
                             if (progressionStep.commentary) {
-                                yield* emitCommentary(progressionStep.commentary);
+                                yield* emitCommentary(progressionStep.commentary, chunkAgentId);
                             }
                         }
                         const commentary = summarizePlanState(currentPlanState);
                         if (commentary) {
-                            yield* emitCommentary(commentary);
+                            yield* emitCommentary(commentary, chunkAgentId);
                         }
                     }
                 }

package/dist/runtime/parsing/output-tool-args.js

@@ -396,6 +396,16 @@ export function salvageJsonToolCalls(value) {
         .filter((item) => item !== null);
 }
 function normalizeWriteTodosArgs(args) {
+    if (typeof args.name === "string" &&
+        args.name === "write_todos" &&
+        typeof args.arguments === "object" &&
+        args.arguments !== null &&
+        !Array.isArray(args.arguments)) {
+        return normalizeWriteTodosArgs(args.arguments);
+    }
+    if (Array.isArray(args.items) && !Array.isArray(args.todos)) {
+        return normalizeWriteTodosArgs({ ...args, todos: args.items });
+    }
     if (!Array.isArray(args.todos)) {
         return args;
     }

package/dist/runtime/parsing/stream-event-parsing.d.ts

@@ -2,26 +2,33 @@ import type { RequestExecutionStep } from "../../contracts/types.js";
 export type RuntimeStreamChunk = {
     kind: "upstream-event";
     event: unknown;
+    agentId?: string;
 } | {
     kind: "commentary";
     content: string;
+    agentId?: string;
 } | {
     kind: "content";
     content: string;
+    agentId?: string;
 } | {
     kind: "reasoning";
     content: string;
+    agentId?: string;
 } | {
     kind: "interrupt";
     content: string;
+    agentId?: string;
 } | {
     kind: "tool-result";
     toolName: string;
     output: unknown;
     isError?: boolean;
+    agentId?: string;
 } | {
     kind: "profile";
     step: RequestExecutionStep;
+    agentId?: string;
 };
 export declare function sanitizeStreamPayload(value: unknown): unknown;
 export declare function sanitizeRetainedUpstreamEvent(event: unknown): unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.367",
+  "version": "0.0.370",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
     "@libsql/client": "^0.17.0",
     "@llamaindex/ollama": "^0.1.23",
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "@qdrant/js-client-rest": "1.13.0",
+    "@qdrant/js-client-rest": "1.17.0",
     "deepagents": "^1.9.0",
     "langchain": "^1.3.4",
     "llamaindex": "^0.12.1",
@@ -82,7 +82,7 @@
     "docs:sync-dev-nav": "node ./scripts/sync-developer-docs-nav.mjs",
     "docs:sync-release-notes": "node ./scripts/sync-release-notes-html.mjs",
     "docs:sync-docs-html": "node ./scripts/sync-release-notes-html.mjs && node ./scripts/sync-developer-docs-nav.mjs",
-    "release:prepare": "npm version patch --no-git-tag-version && node ./scripts/sync-example-version.mjs && node ./scripts/archive-release-notes.mjs && node ./scripts/sync-release-notes-html.mjs",
+    "release:prepare": "node ./scripts/prepare-release-version.mjs && node ./scripts/sync-example-version.mjs && node ./scripts/archive-release-notes.mjs && node ./scripts/sync-release-notes-html.mjs",
     "release:pack": "npm pack --dry-run",
     "release:publish": "npm publish --access public --registry https://registry.npmjs.org/"
   },
@@ -99,7 +99,7 @@
     "hono": "^4.12.14",
     "langsmith": "^0.5.20",
     "undici": "^6.24.0",
-    "@qdrant/js-client-rest": "1.13.0",
+    "@qdrant/js-client-rest": "1.17.0",
     "vite": "^7.3.2",
     "openai": "6.33.0",
     "protobufjs": "^7.5.5"