@botbotgo/agent-harness 0.0.327 → 0.0.328

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

@@ -1,5 +1,38 @@
-import { EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION, INTERNAL_RUNTIME_SPILL_PATH_INSTRUCTION, STRICT_TOOL_JSON_INSTRUCTION, WORKSPACE_RELATIVE_PATH_INSTRUCTION, WRITE_TODOS_DESCRIPTIVE_CONTENT_INSTRUCTION, WRITE_TODOS_FULL_ENTRY_INSTRUCTION, WRITE_TODOS_NON_EMPTY_INITIAL_LIST_INSTRUCTION, } from "../prompts/runtime-prompts.js";
+import { AUTONOMOUS_INVESTIGATION_RECOVERY_INSTRUCTION, EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION, INTERNAL_RUNTIME_SPILL_PATH_INSTRUCTION, STRICT_TOOL_JSON_INSTRUCTION, WORKSPACE_RELATIVE_PATH_INSTRUCTION, WRITE_TODOS_DESCRIPTIVE_CONTENT_INSTRUCTION, WRITE_TODOS_FULL_ENTRY_INSTRUCTION, WRITE_TODOS_NON_EMPTY_INITIAL_LIST_INSTRUCTION, } from "../prompts/runtime-prompts.js";
 import { wrapNormalizedMessage, readTextContent } from "./output-content.js";
+function collectRequestMessages(request) {
+    if (typeof request !== "object" || !request || Array.isArray(request)) {
+        return [];
+    }
+    const typed = request;
+    return Array.isArray(typed.messages)
+        ? typed.messages.filter((message) => typeof message === "object" && !!message && !Array.isArray(message))
+        : [];
+}
+function readMessageRole(message) {
+    return typeof message.role === "string" ? message.role.trim().toLowerCase() : "";
+}
+function readLatestUserRequestText(request) {
+    const messages = collectRequestMessages(request);
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (readMessageRole(message) !== "user") {
+            continue;
+        }
+        const content = readTextContent(message.content).trim();
+        if (content) {
+            return content;
+        }
+    }
+    return "";
+}
+function readSystemInstructionText(request) {
+    return collectRequestMessages(request)
+        .filter((message) => readMessageRole(message) === "system")
+        .map((message) => readTextContent(message.content).trim())
+        .filter(Boolean)
+        .join("\n\n");
+}
 function isToolCallParseFailure(error) {
     return error instanceof Error && /error parsing tool call:/i.test(error.message);
 }
@@ -72,20 +105,33 @@ export function isRetrySafeInvalidToolSelectionError(value) {
     return !!text && /is not a valid tool, try one of \[/i.test(text);
 }
 export function shouldValidateExecutionWithoutToolEvidence(request) {
-    void request;
-    return false;
+    const userText = readLatestUserRequestText(request);
+    if (userText) {
+        return true;
+    }
+    return readSystemInstructionText(request).length > 0;
 }
 export function resolveExecutionWithoutToolEvidenceInstruction(request, result) {
-    void request;
-    void result;
-    return null;
+    const assistantText = readTextContent(result).trim();
+    return resolveExecutionWithoutToolEvidenceTextInstruction(request, assistantText, false, {});
 }
 export function resolveExecutionWithoutToolEvidenceTextInstruction(request, assistantText, toolCallEvidence = false, resultEvidence = {}) {
-    void request;
-    void assistantText;
-    void toolCallEvidence;
-    void resultEvidence;
-    return null;
+    if (!shouldValidateExecutionWithoutToolEvidence(request)) {
+        return null;
+    }
+    const normalizedText = assistantText.trim();
+    const hasUnfinishedExecution = resultEvidence.hasIncompletePlanState === true
+        || resultEvidence.hasOpenTaskDelegation === true
+        || resultEvidence.hasMissingDelegatedExecutionEvidence === true;
+    if (!normalizedText || !hasUnfinishedExecution) {
+        return null;
+    }
+    const hasExecutionEvidence = toolCallEvidence
+        || resultEvidence.hasWriteTodosEvidence === true
+        || resultEvidence.hasToolResultEvidence === true;
+    return hasExecutionEvidence
+        ? AUTONOMOUS_INVESTIGATION_RECOVERY_INSTRUCTION
+        : EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION;
 }
 export function resolveToolCallRecoveryInstruction(error) {
     if (isRepairableWriteTodosEmptyFailure(error))

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

@@ -1,4 +1,8 @@
 export declare function tryParseJson(value: string): unknown | null;
+export declare function salvageFunctionLikeToolCall(value: unknown): {
+    name: string;
+    args: Record<string, unknown>;
+} | null;
 export declare function salvageToolArgs(value: unknown): Record<string, unknown> | null;
 export declare function normalizeKnownToolArgs(toolName: unknown, args: Record<string, unknown>): Record<string, unknown>;
 export declare function isLikelyToolArgsObject(value: unknown): boolean;

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

@@ -6,6 +6,112 @@ export function tryParseJson(value) {
         return null;
     }
 }
+function splitTopLevelDelimited(value, delimiter) {
+    const parts = [];
+    let depthParen = 0;
+    let depthBracket = 0;
+    let depthBrace = 0;
+    let inString = false;
+    let quoteChar = "";
+    let escaping = false;
+    let start = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (inString) {
+            if (escaping) {
+                escaping = false;
+                continue;
+            }
+            if (char === "\\") {
+                escaping = true;
+                continue;
+            }
+            if (char === quoteChar) {
+                inString = false;
+                quoteChar = "";
+            }
+            continue;
+        }
+        if (char === "\"" || char === "'") {
+            inString = true;
+            quoteChar = char;
+            continue;
+        }
+        if (char === "(")
+            depthParen += 1;
+        else if (char === ")")
+            depthParen -= 1;
+        else if (char === "[")
+            depthBracket += 1;
+        else if (char === "]")
+            depthBracket -= 1;
+        else if (char === "{")
+            depthBrace += 1;
+        else if (char === "}")
+            depthBrace -= 1;
+        else if (char === delimiter && depthParen === 0 && depthBracket === 0 && depthBrace === 0) {
+            parts.push(value.slice(start, index).trim());
+            start = index + 1;
+        }
+    }
+    parts.push(value.slice(start).trim());
+    return parts.filter(Boolean);
+}
+function parseFunctionLikeScalar(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return "";
+    if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        try {
+            return JSON.parse(trimmed.startsWith("'")
+                ? `"${trimmed.slice(1, -1).replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`
+                : trimmed);
+        }
+        catch {
+            return trimmed.slice(1, -1);
+        }
+    }
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (trimmed === "null")
+        return null;
+    if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+        return Number(trimmed);
+    }
+    const directJson = tryParseJson(trimmed);
+    if (directJson !== null) {
+        return directJson;
+    }
+    return trimmed;
+}
+export function salvageFunctionLikeToolCall(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    const match = /^([A-Za-z_][A-Za-z0-9_]*)\(([\s\S]*)\)$/.exec(trimmed);
+    if (!match) {
+        return null;
+    }
+    const [, name, rawArgList] = match;
+    const entries = splitTopLevelDelimited(rawArgList, ",");
+    const args = {};
+    for (const entry of entries) {
+        const eqIndex = entry.indexOf("=");
+        if (eqIndex <= 0) {
+            return null;
+        }
+        const key = entry.slice(0, eqIndex).trim();
+        const rawValue = entry.slice(eqIndex + 1).trim();
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
+            return null;
+        }
+        args[key] = parseFunctionLikeScalar(rawValue);
+    }
+    return { name, args: normalizeKnownToolArgs(name, args) };
+}
 function extractBalancedJsonObject(value) {
     const start = value.indexOf("{");
     if (start < 0)
@@ -93,10 +199,26 @@ function normalizeWriteTodosArgs(args) {
         }),
     };
 }
+function normalizeTaskArgs(args) {
+    const description = typeof args.description === "string" && args.description.trim().length > 0
+        ? args.description
+        : undefined;
+    const subagentType = typeof args.subagent_type === "string" && args.subagent_type.trim().length > 0
+        ? args.subagent_type
+        : undefined;
+    return {
+        ...args,
+        ...(description !== undefined ? { description } : {}),
+        ...(subagentType !== undefined ? { subagent_type: subagentType } : {}),
+    };
+}
 export function normalizeKnownToolArgs(toolName, args) {
     if (toolName === "write_todos") {
         return normalizeWriteTodosArgs(args);
     }
+    if (toolName === "task") {
+        return normalizeTaskArgs(args);
+    }
     return args;
 }
 export function isLikelyToolArgsObject(value) {

package/dist/runtime/parsing/stream-event-parsing.js

@@ -118,9 +118,7 @@ function sanitizeRetainedEventDataField(key, value) {
             const typed = value;
             const taskSubagentType = typeof typed.subagent_type === "string"
                 ? typed.subagent_type
-                : typeof typed.subagentType === "string"
-                    ? typed.subagentType
-                    : undefined;
+                : undefined;
             if (taskSubagentType) {
                 return { subagent_type: taskSubagentType };
             }
@@ -232,6 +230,38 @@ function hasLowSignalInitialWriteTodos(value) {
             : [];
     return items.length > 0 && items.every((item) => typeof item?.content === "string" && isLowSignalTodoContent(item.content));
 }
+function isToolMessageLike(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const typed = value;
+    if (typed.type === "tool" || typed.lc_direct_tool_output === true || typeof typed.tool_call_id === "string") {
+        return true;
+    }
+    if (typeof typed.lc_kwargs === "object" && typed.lc_kwargs !== null) {
+        const lcKwargs = typed.lc_kwargs;
+        return lcKwargs.type === "tool" || lcKwargs.lc_direct_tool_output === true || typeof lcKwargs.tool_call_id === "string";
+    }
+    return false;
+}
+function isDirectToolOutputPayload(value) {
+    if (Array.isArray(value)) {
+        return value.some((item) => isDirectToolOutputPayload(item));
+    }
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const typed = value;
+    if (typed.lc_direct_tool_output === true) {
+        return true;
+    }
+    if (Array.isArray(typed.messages) && typed.messages.length > 0 && typed.messages.every((message) => isToolMessageLike(message))) {
+        return true;
+    }
+    return (isDirectToolOutputPayload(typed.update)
+        || isDirectToolOutputPayload(typed.output)
+        || isDirectToolOutputPayload(typed.data));
+}
 export function extractTerminalStreamOutput(event) {
     if (typeof event !== "object" || !event)
         return "";
@@ -242,6 +272,10 @@ export function extractTerminalStreamOutput(event) {
         return extractVisibleOutput(typed.data?.output);
     }
     if (typed.event === "on_chain_end") {
+        if (typed.run_type === "tool")
+            return "";
+        if (isDirectToolOutputPayload(typed.data?.output))
+            return "";
         const name = typeof typed.name === "string" ? typed.name : "";
         if (/middleware|after_model/i.test(name))
             return "";

package/dist/runtime/support/harness-support.d.ts

@@ -1,4 +1,5 @@
 import type { HarnessEvent, InternalApprovalRecord, WorkspaceBundle } from "../../contracts/types.js";
+export declare function describeRuntimeError(error: unknown): string;
 export declare function renderRuntimeFailure(error: unknown): string;
 export declare function renderToolFailure(toolName: string, output: unknown): string;
 export declare function parseInterruptContent(content: string): {

package/dist/runtime/support/harness-support.js

@@ -1,9 +1,51 @@
 import { createPersistentId } from "../../utils/id.js";
 import { isDelegationCapableBinding } from "../../workspace/support/agent-capabilities.js";
 import { isDeepAgentBinding } from "./compiled-binding.js";
+function collectRuntimeErrorMessages(error, seen = new Set()) {
+    if (error == null || seen.has(error)) {
+        return [];
+    }
+    if (typeof error === "object" || typeof error === "function") {
+        seen.add(error);
+    }
+    if (typeof error === "string") {
+        const trimmed = error.trim();
+        return trimmed ? [trimmed] : [];
+    }
+    if (!(error instanceof Error)) {
+        const message = String(error).trim();
+        return message ? [message] : [];
+    }
+    const messages = [];
+    const primary = error.message.trim();
+    if (primary) {
+        messages.push(primary);
+    }
+    const composite = error;
+    if (Array.isArray(composite.errors)) {
+        for (const nested of composite.errors) {
+            messages.push(...collectRuntimeErrorMessages(nested, seen));
+        }
+    }
+    if (composite.cause !== undefined) {
+        messages.push(...collectRuntimeErrorMessages(composite.cause, seen));
+    }
+    return messages;
+}
+export function describeRuntimeError(error) {
+    const uniqueMessages = Array.from(new Set(collectRuntimeErrorMessages(error)));
+    if (uniqueMessages.length === 0) {
+        return String(error).trim();
+    }
+    if (uniqueMessages.length === 1) {
+        return uniqueMessages[0];
+    }
+    const nested = uniqueMessages.slice(1, 6);
+    const suffix = uniqueMessages.length > 6 ? `\n...and ${uniqueMessages.length - 6} more` : "";
+    return `${uniqueMessages[0]}\ncauses:\n${nested.map((message, index) => `${index + 1}. ${message}`).join("\n")}${suffix}`;
+}
 export function renderRuntimeFailure(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return `runtime_error=${message}`.trim();
+    return `runtime_error=${describeRuntimeError(error)}`.trim();
 }
 function readToolErrorMessage(output) {
     if (typeof output === "string" && output.trim()) {

package/dist/tools.js

@@ -10,6 +10,9 @@ function getZodLikeTypeName(value) {
         return undefined;
     }
     const typed = value;
+    if (typeof typed.def?.type === "string") {
+        return typed.def.type;
+    }
     if (typeof typed._zod?.def?.type === "string") {
         return typed._zod.def.type;
     }
@@ -42,7 +45,30 @@ function getZodLikeInnerSchema(value) {
         return undefined;
     }
     const typed = value;
-    return typed._zod?.def?.innerType ?? typed._zod?.def?.element ?? typed._zod?.def?.valueType ?? typed._def?.innerType ?? typed._def?.type ?? typed._def?.valueType;
+    return typed.def?.innerType
+        ?? typed.def?.element
+        ?? typed.def?.valueType
+        ?? typed.def?.schema
+        ?? typed.def?.out
+        ?? typed.def?.in
+        ?? typed._zod?.def?.innerType
+        ?? typed._zod?.def?.element
+        ?? typed._zod?.def?.valueType
+        ?? typed._def?.innerType
+        ?? typed._def?.schema
+        ?? typed._def?.type
+        ?? typed._def?.valueType
+        ?? typed._def?.in
+        ?? typed._def?.out;
+}
+function isEffectWrappedOptional(value) {
+    const typeName = getZodLikeTypeName(value);
+    if (typeName !== "effects" && typeName !== "pipeline" && typeName !== "pipe" && typeName !== "transform") {
+        return false;
+    }
+    const inner = getZodLikeInnerSchema(value);
+    const innerTypeName = getZodLikeTypeName(inner);
+    return innerTypeName === "optional" || innerTypeName === "default" || innerTypeName === "catch";
 }
 function buildJsonSchemaFromZodLike(value) {
     const shape = getZodLikeObjectShape(value);
@@ -51,13 +77,13 @@ function buildJsonSchemaFromZodLike(value) {
         const required = Object.entries(shape)
             .filter(([, entry]) => {
             const typeName = getZodLikeTypeName(entry);
-            return typeName !== "optional" && typeName !== "default" && typeName !== "catch";
+            return typeName !== "optional" && typeName !== "default" && typeName !== "catch" && !isEffectWrappedOptional(entry);
         })
             .map(([key]) => key);
         return {
             type: "object",
             properties,
-            ...(required.length > 0 ? { required } : {}),
+            required,
         };
     }
     const typeName = getZodLikeTypeName(value);
@@ -88,6 +114,10 @@ function buildJsonSchemaFromZodLike(value) {
         case "nullable":
         case "default":
         case "catch":
+        case "effects":
+        case "pipeline":
+        case "pipe":
+        case "transform":
             return buildJsonSchemaFromZodLike(getZodLikeInnerSchema(value)) ?? {};
         default:
             return undefined;
@@ -106,7 +136,7 @@ export function buildToolJsonSchema(schema) {
         required: Object.entries(schema)
             .filter(([, value]) => {
             const typeName = getZodLikeTypeName(value);
-            return typeName !== "optional" && typeName !== "default" && typeName !== "catch";
+            return typeName !== "optional" && typeName !== "default" && typeName !== "catch" && !isEffectWrappedOptional(value);
         })
             .map(([key]) => key),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.327",
+  "version": "0.0.328",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",
@@ -47,19 +47,19 @@
     }
   },
   "dependencies": {
-    "@langchain/anthropic": "^1.1.0",
-    "@langchain/community": "^1.1.24",
-    "@langchain/core": "^1.1.33",
-    "@langchain/google": "^0.1.7",
-    "@langchain/langgraph": "^1.2.6",
+    "@langchain/anthropic": "^1.3.27",
+    "@langchain/community": "^1.1.27",
+    "@langchain/core": "^1.1.41",
+    "@langchain/google": "^0.1.10",
+    "@langchain/langgraph": "^1.2.9",
     "@langchain/ollama": "^1.2.6",
-    "@langchain/openai": "^1.1.0",
+    "@langchain/openai": "^1.4.4",
     "@libsql/client": "^0.17.0",
     "@llamaindex/ollama": "^0.1.23",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@qdrant/js-client-rest": "^1.17.0",
     "deepagents": "^1.9.0",
-    "langchain": "^1.3.1",
+    "langchain": "^1.3.4",
     "llamaindex": "^0.12.1",
     "mem0ai": "^2.4.6",
     "mustache": "^4.2.0",