@botbotgo/agent-harness 0.0.368 → 0.0.371

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.368";
+export declare const AGENT_HARNESS_VERSION = "0.0.371";
 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.368";
+export const AGENT_HARNESS_VERSION = "0.0.371";
 export const AGENT_HARNESS_RELEASE_DATE = "2026-04-30";

package/dist/runtime/adapter/flow/stream-runtime.js

@@ -12,6 +12,13 @@ export class ExecutionReconciliationError extends Error {
         this.name = "ExecutionReconciliationError";
     }
 }
+const CLOSE_REQUIRED_PLAN_RECOVERY_INSTRUCTION = [
+    "The current required todo board still has unfinished work.",
+    "Do not broaden the investigation, restart planning, or ask the user what to do next.",
+    "Use the existing tool evidence already available in this run.",
+    "Your next action must be write_todos: update every remaining pending or in_progress item to completed if evidence was gathered, or failed if it cannot be completed with the available tools.",
+    "After that write_todos call, provide the final answer required by the agent response format.",
+].join("\n");
 function toVisibleContent(value) {
     const extracted = extractVisibleOutput(value);
     return extracted ? sanitizeVisibleText(extracted) : "";
@@ -528,10 +535,15 @@ export async function* streamRuntimeExecution(options) {
             const streamedExecutionEvidence = buildExecutionRecoveryEvidence({ projectionState });
             const streamedDelegatedRecoveryInstruction = resolveDelegatedExecutionRecoveryInstruction(streamedExecutionEvidence);
             const streamedDelegationOnlyRecoveryInstruction = resolveDelegationOnlyRecoveryInstruction(options.binding, streamedExecutionEvidence);
+            const streamedIncompletePlanRecoveryInstruction = requiresPlanEvidence(options.binding) && streamedExecutionEvidence.hasIncompletePlanState
+                ? CLOSE_REQUIRED_PLAN_RECOVERY_INSTRUCTION
+                : null;
             const delegatedExecutionRecoveryInstruction = !emittedUnsafeStreamSideEffects || streamedDelegatedRecoveryInstruction
                 ? streamedDelegatedRecoveryInstruction
                 : null;
-            if (hasUnresolvedExecution(streamedExecutionEvidence) && !delegatedExecutionRecoveryInstruction) {
+            if (hasUnresolvedExecution(streamedExecutionEvidence)
+                && !delegatedExecutionRecoveryInstruction
+                && !streamedIncompletePlanRecoveryInstruction) {
                 throw createUnresolvedExecutionError(streamedExecutionEvidence);
             }
             const executionWithoutToolEvidenceInstruction = projectionState.emittedOutput
@@ -557,6 +569,7 @@ export async function* streamRuntimeExecution(options) {
             const retryInstruction = !emittedUnsafeStreamSideEffects && sawRetrySafeInvalidToolSelectionError
                 ? INVALID_TOOL_SELECTION_RECOVERY_INSTRUCTION
                 : delegatedExecutionRecoveryInstruction
+                    ?? streamedIncompletePlanRecoveryInstruction
                     ?? streamedRuntimeFailureRecoveryInstruction
                     ?? missingPlanRecoveryInstruction
                     ?? streamedDelegationOnlyRecoveryInstruction
@@ -776,7 +789,11 @@ export async function* streamRuntimeExecution(options) {
             })
             : null;
         const invokeFallbackDelegationOnlyRecoveryInstruction = resolveDelegationOnlyRecoveryInstruction(options.binding, invokeExecutionEvidence);
-        const effectiveInvokeFallbackRecoveryInstruction = invokeFallbackMissingPlanRecoveryInstruction
+        const invokeFallbackIncompletePlanRecoveryInstruction = requiresPlanEvidence(options.binding) && invokeExecutionEvidence.hasIncompletePlanState
+            ? CLOSE_REQUIRED_PLAN_RECOVERY_INSTRUCTION
+            : null;
+        const effectiveInvokeFallbackRecoveryInstruction = invokeFallbackIncompletePlanRecoveryInstruction
+            ?? invokeFallbackMissingPlanRecoveryInstruction
             ?? invokeFallbackDelegationOnlyRecoveryInstruction
             ?? invokeFallbackRecoveryInstruction;
         if (effectiveInvokeFallbackRecoveryInstruction) {

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

@@ -59,6 +59,7 @@ 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>;

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

@@ -1139,6 +1139,39 @@ 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;
@@ -1263,18 +1296,38 @@ export class AgentRuntimeAdapter {
             agentId: selectedBinding.agent.id,
         };
         const childRequestId = `${requestId}:${subagentType}`;
-        let delegatedResult;
-        const runDelegatedRequest = (text, requestSuffix = "") => this.invoke(selectedBinding, text, sessionId, `${childRequestId}${requestSuffix}`, undefined, [], {
-            context: options.context,
-            state: options.state,
-            files: options.files,
-            memoryContext: options.memoryContext,
-        });
+        const executedToolResults = [];
+        let output = "";
         try {
-            delegatedResult = await runDelegatedRequest(requestText);
+            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) {
-            const output = error instanceof Error ? error.message : String(error);
+            output = error instanceof Error ? error.message : String(error);
             return {
                 toolOutput: output,
                 delegatedSubagentType: subagentType,
@@ -1285,24 +1338,19 @@ export class AgentRuntimeAdapter {
                     state: "failed",
                     output,
                     finalMessageText: output,
+                    metadata: { executedToolResults },
                 },
             };
         }
-        const delegatedToolResults = Array.isArray(delegatedResult.metadata?.executedToolResults)
-            ? delegatedResult.metadata.executedToolResults
-            : [];
-        for (const toolResult of delegatedToolResults) {
-            if (!toolResult?.toolName) {
-                continue;
-            }
-            yield {
-                kind: "tool-result",
-                toolName: toolResult.toolName,
-                output: toolResult.output,
-                ...(toolResult.isError !== undefined ? { isError: toolResult.isError } : {}),
-                agentId: selectedBinding.agent.id,
-            };
-        }
+        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,
@@ -1343,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.368",
+  "version": "0.0.371",
   "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"