@botbotgo/agent-harness 0.0.359 → 0.0.361

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.359";
+export declare const AGENT_HARNESS_VERSION = "0.0.361";
 export declare const AGENT_HARNESS_RELEASE_DATE = "2026-04-25";

package/dist/package-version.js

@@ -1,2 +1,2 @@
-export const AGENT_HARNESS_VERSION = "0.0.359";
+export const AGENT_HARNESS_VERSION = "0.0.361";
 export const AGENT_HARNESS_RELEASE_DATE = "2026-04-25";

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

@@ -7,7 +7,7 @@ import { UPSTREAM_REQUEST_CONFIG_KEY, UPSTREAM_SESSION_CONFIG_KEY } from "../ups
 import { appendToolRecoveryInstruction, extractVisibleOutput, tryParseJson } from "../../parsing/output-parsing.js";
 import { salvageJsonToolCalls } from "../../parsing/output-tool-args.js";
 import { isEmptyFinalAiMessageError } from "../resilience.js";
-import { AUTONOMOUS_INVESTIGATION_RECOVERY_INSTRUCTION } from "../../prompts/runtime-prompts.js";
+import { AUTONOMOUS_INVESTIGATION_RECOVERY_INSTRUCTION, EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION, } from "../../prompts/runtime-prompts.js";
 function readBindingExecutionParams(binding) {
     const params = binding.execution?.params ?? binding.deepAgentParams ?? binding.langchainAgentParams;
     return {
@@ -76,6 +76,17 @@ function hasNativeTaskDelegationIntent(value) {
     }
     return hasNativeTaskDelegationIntent(typed.tool_calls) || hasNativeTaskDelegationIntent(typed.messages);
 }
+function looksLikeCapabilityRefusalWithoutEvidence(value) {
+    const text = extractVisibleOutput(value).trim();
+    if (!text) {
+        return false;
+    }
+    const refusalSignal = /(?:cannot|can't|unable to|do not have|don't have|not support|does not support|missing capabilities|tool limitation|skill limitation|capability limitation|out of scope|无法|不能|不支持|缺少能力|能力不足|超出范围)/iu.test(text);
+    if (!refusalSignal) {
+        return false;
+    }
+    return /(?:tool|tools|skill|skills|capabilit|scope|工具|技能|能力|范围)/iu.test(text);
+}
 function readStructuredToolCall(value) {
     const salvaged = salvageJsonToolCalls(value)[0];
     if (salvaged) {
@@ -344,6 +355,20 @@ export async function executeRequestInvocation(options) {
         result = recoveredInvocation.result;
         executedToolResults.splice(0, executedToolResults.length, ...recoveredInvocation.executedToolResults);
     }
+    if (options.resumePayload === undefined
+        && primaryTools.length > 0
+        && executedToolResults.length === 0
+        && looksLikeCapabilityRefusalWithoutEvidence(result)) {
+        const messages = Array.isArray(result.messages)
+            ? result.messages
+            : undefined;
+        const recoveryBase = messages ? { messages } : request;
+        const recoveredRequest = appendToolRecoveryInstruction(recoveryBase, EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION);
+        const recoveredInvocation = await invokeOnce(recoveredRequest);
+        localOrUpstreamInvocation = recoveredInvocation;
+        result = recoveredInvocation.result;
+        executedToolResults.splice(0, executedToolResults.length, ...recoveredInvocation.executedToolResults);
+    }
     try {
         return finalizeRequestResult({
             bindingAgentId: options.binding.agent.id,

package/dist/runtime/adapter/invocation-result.js

@@ -242,6 +242,17 @@ function looksLikeNonEvidenceApology(value) {
         || /(?:system limitation|technical limitation|internal limitation|recursion limit)/iu.test(normalized)
         || /(?:抱歉|对不起)[\s\S]*(?:无法|不能|未能)(?:完成|继续|处理)/u.test(normalized);
 }
+function looksLikeContradictedToolExecutionFailure(value) {
+    const normalized = sanitizeVisibleText(value).trim();
+    if (!normalized) {
+        return false;
+    }
+    const mentionsToolExecution = /(?:\btool\b|\bfunction\b|\bexecute\b|\binvoke\b|\bcall\b|工具|函数|调用|执行)/iu.test(normalized);
+    if (!mentionsToolExecution) {
+        return false;
+    }
+    return /(?:cancelled|canceled|timeout|timed out|race condition|cannot execute|can't execute|unable to execute|could not execute|failed to execute|被取消|超时|无法执行|不能执行|未能执行)/iu.test(normalized);
+}
 function extractDeterministicToolFailureReport(executedToolResults) {
     const hasSuccessfulSubstantiveTool = executedToolResults.some((toolResult) => (toolResult.isError !== true
         && toolResult.toolName !== "write_todos"
@@ -311,6 +322,9 @@ export function resolveDeterministicFinalOutput(params) {
         && (looksLikeClarificationQuestion(sanitizedVisibleOutput) || looksLikeNonEvidenceApology(sanitizedVisibleOutput))) {
         return deterministicFailureReport || delegatedTaskOutput || successfulToolOutput || sanitizedVisibleOutput;
     }
+    if (sanitizedVisibleOutput && successfulToolOutput && looksLikeContradictedToolExecutionFailure(sanitizedVisibleOutput)) {
+        return delegatedTaskOutput || successfulToolOutput;
+    }
     if (sanitizedVisibleOutput && !isLowSignalStructuredCompletion(sanitizedVisibleOutput)) {
         return sanitizedVisibleOutput;
     }
@@ -383,6 +397,7 @@ export function finalizeRequestResult(params) {
     const hasMissingRequiredFinalAnswer = binding?.harnessRuntime?.executionContract?.requiresPlan === true
         && !visibleOutput
         && !preliminaryTerminalStatus
+        && !output.trim()
         && allExecutedToolResults.some((toolResult) => toolResult.isError !== true && toolResult.toolName !== "write_todos" && toolResult.toolName !== "read_todos");
     if (hasMissingRequiredPlanEvidence) {
         output = "runtime_error=Agent ended before producing required plan evidence.";

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

@@ -10,6 +10,7 @@ import { EXECUTION_WITH_TOOL_EVIDENCE_RETRY_INSTRUCTION } from "./prompts/runtim
 import { buildToolNameMapping, } from "./adapter/tool/tool-name-mapping.js";
 import { executeRequestInvocation } from "./adapter/flow/invocation-flow.js";
 import { streamRuntimeExecution } from "./adapter/flow/stream-runtime.js";
+import { resolveDeterministicFinalOutput } from "./adapter/invocation-result.js";
 import { applyToolRecoveryInstruction as applyToolRecoveryInstructionHelper, applyStrictToolJsonInstruction as applyStrictToolJsonInstructionHelper, callRuntimeWithToolParseRecovery as callRuntimeWithToolParseRecoveryHelper, createModelFallbackRunnable as createModelFallbackRunnableHelper, invokeWithProviderRetry as invokeWithProviderRetryHelper, iterateWithTimeout as iterateWithTimeoutHelper, materializeModelStream as materializeModelStreamHelper, RuntimeOperationTimeoutError, withRuntimeTimeout, } from "./adapter/runtime-shell.js";
 import { extractSubagentRequestText, invokeBuiltinTaskTool as invokeBuiltinTaskToolHelper, materializeAutomaticSummarizationMiddleware as materializeAutomaticSummarizationMiddlewareHelper, resolveBuiltinMiddlewareBackend as resolveBuiltinMiddlewareBackendHelper, resolveBuiltinMiddlewareTools as resolveBuiltinMiddlewareToolsHelper, resolveLangChainRuntimeExtensionMiddleware as resolveLangChainRuntimeExtensionMiddlewareHelper, resolveMiddleware as resolveMiddlewareHelper, resolveSubagents as resolveSubagentsHelper, wrapRequestResultAsSubagentResponse, } from "./adapter/middleware-assembly.js";
 import { isEmptyFinalAiMessageError, resolveBindingTimeout, resolveStreamIdleTimeout, } from "./adapter/resilience.js";
@@ -154,6 +155,29 @@ function hasDelegatedPlanEvidence(result) {
     return Array.isArray(toolResults)
         && toolResults.some((item) => item.toolName === "write_todos" || item.toolName === "read_todos");
 }
+function resolveDelegatedResultOutput(result) {
+    const executedToolResults = Array.isArray(result.metadata?.executedToolResults)
+        ? result.metadata.executedToolResults
+        : [];
+    const deterministicOutput = resolveDeterministicFinalOutput({
+        visibleOutput: typeof result.output === "string" ? result.output : "",
+        executedToolResults,
+    });
+    return deterministicOutput || result.output;
+}
+function selectDelegatedToolResultsForVisibleProgress(result) {
+    const executedToolResults = Array.isArray(result?.metadata?.executedToolResults)
+        ? result.metadata.executedToolResults
+        : [];
+    const hasSuccessfulExecutionEvidence = executedToolResults.some((toolResult) => (toolResult.isError !== true
+        && toolResult.toolName !== "write_todos"
+        && toolResult.toolName !== "read_todos"));
+    return hasSuccessfulExecutionEvidence
+        ? executedToolResults.filter((toolResult) => (toolResult.isError !== true
+            && toolResult.toolName !== "write_todos"
+            && toolResult.toolName !== "read_todos"))
+        : executedToolResults;
+}
 export class AgentRuntimeAdapter {
     options;
     modelCache = new Map();
@@ -806,7 +830,7 @@ export class AgentRuntimeAdapter {
         if (typeof model.invoke !== "function") {
             return null;
         }
-        const raw = await this.invokeWithProviderRetry(binding, () => this.withTimeout(() => model.invoke(prompt, resolveLangChainInvocationConfig(binding, {
+        const invokeRouter = async (activePrompt, operationName) => this.invokeWithProviderRetry(binding, () => this.withTimeout(() => model.invoke(activePrompt, resolveLangChainInvocationConfig(binding, {
             sessionId,
             requestId,
             context: options.context,
@@ -815,28 +839,44 @@ export class AgentRuntimeAdapter {
                 sessionId,
                 requestId,
             }),
-        })), resolveBindingTimeout(binding), "delegation router invoke", "invoke"));
-        const rawText = readModelText(raw);
-        let selection = parseCompactRouterSelection(rawText, subagentNames);
-        if (!selection) {
-            const retryPrompt = [
+        })), resolveBindingTimeout(binding), operationName, "invoke"));
+        const routerPrompts = [
+            prompt,
+            [
                 prompt,
                 "Your previous router output was invalid.",
-                "Previous output:",
-                rawText,
                 "Return only one JSON object now. Do not include prose, markdown, labels, or tool-call wrappers.",
-            ].join("\n\n");
-            const retryRaw = await this.invokeWithProviderRetry(binding, () => this.withTimeout(() => model.invoke(retryPrompt, resolveLangChainInvocationConfig(binding, {
-                sessionId,
-                requestId,
-                context: options.context,
-                toolRuntimeContext: this.buildFunctionToolRuntimeContext(binding, {
-                    ...options,
-                    sessionId,
-                    requestId,
-                }),
-            })), resolveBindingTimeout(binding), "delegation router retry invoke", "invoke"));
-            selection = parseCompactRouterSelection(readModelText(retryRaw), subagentNames);
+            ].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 {
@@ -896,7 +936,7 @@ export class AgentRuntimeAdapter {
                 },
             };
         }
-        return { toolOutput: delegatedResult.output, delegatedResult };
+        return { toolOutput: resolveDelegatedResultOutput(delegatedResult), delegatedResult };
     }
     async *stream(binding, input, sessionId, history = [], options = {}) {
         const directListing = await this.tryHandleDirectWorkspaceListing(binding, input, {
@@ -916,17 +956,32 @@ export class AgentRuntimeAdapter {
             };
             return;
         }
+        if (isDelegationOnlyDeepAgentBinding(binding)) {
+            yield {
+                kind: "commentary",
+                content: "Selecting a specialist for delegated execution.",
+            };
+        }
         const compactDelegation = await this.tryDelegateWithCompactRouter(binding, input, sessionId, options.requestId ?? sessionId, {
             ...options,
             sessionId,
             requestId: options.requestId,
         });
         if (compactDelegation) {
+            const delegatedToolResults = selectDelegatedToolResultsForVisibleProgress(compactDelegation.delegatedResult);
             yield {
                 kind: "tool-result",
                 toolName: "task",
                 output: compactDelegation.toolOutput,
             };
+            for (const toolResult of delegatedToolResults) {
+                yield {
+                    kind: "tool-result",
+                    toolName: toolResult.toolName,
+                    output: toolResult.output,
+                    isError: toolResult.isError,
+                };
+            }
             yield {
                 kind: "content",
                 content: typeof compactDelegation.toolOutput === "string"

package/package.json

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