@botbotgo/agent-harness 0.0.273 → 0.0.274

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.272";
+export declare const AGENT_HARNESS_VERSION = "0.0.273";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.272";
+export const AGENT_HARNESS_VERSION = "0.0.273";

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

@@ -21,6 +21,7 @@ export declare function createModelFallbackRunnable(model: {
     stream: (input: unknown, config?: Record<string, unknown>) => Promise<AsyncIterable<unknown>>;
 };
 export declare function applyStrictToolJsonInstruction(binding: CompiledAgentBinding): CompiledAgentBinding;
+export declare function applyToolRecoveryInstruction(binding: CompiledAgentBinding, instruction: string): CompiledAgentBinding;
 export declare function callRuntimeWithToolParseRecovery(input: {
     binding: CompiledAgentBinding;
     request: unknown;

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

@@ -1,5 +1,5 @@
 import { setTimeout as sleep } from "node:timers/promises";
-import { extractVisibleOutput, isToolCallRecoveryFailure, STRICT_TOOL_JSON_INSTRUCTION } from "../parsing/output-parsing.js";
+import { appendToolRecoveryInstruction, extractVisibleOutput, isToolCallRecoveryFailure, resolveToolCallRecoveryInstruction, STRICT_TOOL_JSON_INSTRUCTION, } from "../parsing/output-parsing.js";
 import { readStreamDelta } from "../parsing/stream-event-parsing.js";
 import { computeRemainingTimeoutMs, isRetryableProviderError, resolveProviderRetryPolicy } from "./resilience.js";
 import { isDeepAgentBinding, isLangChainBinding, withUpdatedBindingExecutionParams, } from "../support/compiled-binding.js";
@@ -134,16 +134,19 @@ export function createModelFallbackRunnable(model) {
     };
 }
 export function applyStrictToolJsonInstruction(binding) {
+    return applyToolRecoveryInstruction(binding, STRICT_TOOL_JSON_INSTRUCTION);
+}
+export function applyToolRecoveryInstruction(binding, instruction) {
     if (isLangChainBinding(binding)) {
         return withUpdatedBindingExecutionParams(binding, (params) => ({
             ...params,
-            systemPrompt: [params.systemPrompt, STRICT_TOOL_JSON_INSTRUCTION].filter(Boolean).join("\n\n"),
+            systemPrompt: [params.systemPrompt, instruction].filter(Boolean).join("\n\n"),
         }));
     }
     if (isDeepAgentBinding(binding)) {
         return withUpdatedBindingExecutionParams(binding, (params) => ({
             ...params,
-            systemPrompt: [params.systemPrompt, STRICT_TOOL_JSON_INSTRUCTION].filter(Boolean).join("\n\n"),
+            systemPrompt: [params.systemPrompt, instruction].filter(Boolean).join("\n\n"),
         }));
     }
     return binding;
@@ -153,9 +156,10 @@ export async function callRuntimeWithToolParseRecovery(input) {
         return await input.callRuntime(input.binding, input.request);
     }
     catch (error) {
-        if (input.resumePayload !== undefined || !isToolCallRecoveryFailure(error)) {
+        const recoveryInstruction = resolveToolCallRecoveryInstruction(error);
+        if (input.resumePayload !== undefined || !recoveryInstruction || !isToolCallRecoveryFailure(error)) {
             throw error;
         }
-        return input.callRuntime(applyStrictToolJsonInstruction(input.binding), input.request);
+        return input.callRuntime(applyToolRecoveryInstruction(input.binding, recoveryInstruction), appendToolRecoveryInstruction(input.request, recoveryInstruction));
     }
 }

package/dist/runtime/parsing/output-parsing.d.ts

@@ -13,5 +13,9 @@ export declare function isToolCallParseFailure(error: unknown): boolean;
 export declare function isToolCallValidationFailure(error: unknown): boolean;
 export declare function isToolCallRecoveryFailure(error: unknown): boolean;
 export declare const STRICT_TOOL_JSON_INSTRUCTION = "When calling tools, return only the tool call itself. The arguments must be a pure JSON object with no explanatory text before or after it.";
+export declare const WRITE_TODOS_FULL_ENTRY_INSTRUCTION = "When calling write_todos, every todo item must include both content and status. Do not send status-only updates. Retry by resending the full todo entry with the original content preserved.";
+export declare function isRepairableWriteTodosContentFailure(error: unknown): boolean;
+export declare function resolveToolCallRecoveryInstruction(error: unknown): string | null;
+export declare function appendToolRecoveryInstruction(input: unknown, instruction: string): unknown;
 export declare function wrapResolvedModel<T>(value: T): T;
 export declare function extractReasoningText(value: unknown): string;

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

@@ -509,20 +509,41 @@ export function isToolCallValidationFailure(error) {
     if (Array.isArray(direct) && direct.length > 0 && direct.every((issue) => isStructuredValidationIssue(issue) && issue.path.length > 0)) {
         return true;
     }
-    return /Invalid input:\s*expected .* received undefined/i.test(message) && /"path"\s*:\s*\[/.test(message);
+    if (/Invalid input:\s*expected .* received undefined/i.test(message) && /"path"\s*:\s*\[/.test(message)) {
+        return true;
+    }
+    return /Received tool input did not match expected schema/i.test(message) && /(?:→\s*at|at)\s+[\w[\].]+/i.test(message);
 }
 export function isToolCallRecoveryFailure(error) {
     return isToolCallParseFailure(error) || isToolCallValidationFailure(error);
 }
 export const STRICT_TOOL_JSON_INSTRUCTION = "When calling tools, return only the tool call itself. The arguments must be a pure JSON object with no explanatory text before or after it.";
-function appendStrictToolInstruction(input) {
+export const WRITE_TODOS_FULL_ENTRY_INSTRUCTION = "When calling write_todos, every todo item must include both content and status. Do not send status-only updates. Retry by resending the full todo entry with the original content preserved.";
+export function isRepairableWriteTodosContentFailure(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.trim();
+    if (!message)
+        return false;
+    return /write_todos/i.test(message) && /todos\[\d+\]\.content/i.test(message);
+}
+export function resolveToolCallRecoveryInstruction(error) {
+    if (isRepairableWriteTodosContentFailure(error)) {
+        return WRITE_TODOS_FULL_ENTRY_INSTRUCTION;
+    }
+    if (isToolCallRecoveryFailure(error)) {
+        return STRICT_TOOL_JSON_INSTRUCTION;
+    }
+    return null;
+}
+export function appendToolRecoveryInstruction(input, instruction) {
     if (Array.isArray(input)) {
-        return [...input, { role: "system", content: STRICT_TOOL_JSON_INSTRUCTION }];
+        return [...input, { role: "system", content: instruction }];
     }
     if (typeof input === "object" && input && Array.isArray(input.messages)) {
         return {
             ...input,
-            messages: [...(input.messages), { role: "system", content: STRICT_TOOL_JSON_INSTRUCTION }],
+            messages: [...(input.messages), { role: "system", content: instruction }],
         };
     }
     return input;
@@ -540,11 +561,12 @@ export function wrapResolvedModel(value) {
                         return normalizeAgentMessage(await member.apply(currentTarget, args));
                     }
                     catch (error) {
-                        if (!isToolCallRecoveryFailure(error)) {
+                        const recoveryInstruction = resolveToolCallRecoveryInstruction(error);
+                        if (!recoveryInstruction) {
                             throw error;
                         }
                         const retryArgs = [...args];
-                        retryArgs[0] = appendStrictToolInstruction(retryArgs[0]);
+                        retryArgs[0] = appendToolRecoveryInstruction(retryArgs[0], recoveryInstruction);
                         return normalizeAgentMessage(await member.apply(currentTarget, retryArgs));
                     }
                 };

package/package.json

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