@botbotgo/agent-harness 0.0.465 → 0.0.467

package/dist/contracts/workspace.d.ts

@@ -211,6 +211,10 @@ export type CompiledBuiltinToolsConfig = {
 };
 export type CompiledExecutionContract = {
     requiresPlan?: boolean;
+    recoveryEvidenceTool?: {
+        name: string;
+        args?: Record<string, unknown>;
+    };
 };
 export type LangChainAgentParams = {
     model: CompiledModel;

package/dist/package-version.d.ts

@@ -1,2 +1,2 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.465";
+export declare const AGENT_HARNESS_VERSION = "0.0.467";
 export declare const AGENT_HARNESS_RELEASE_DATE = "2026-05-04";

package/dist/package-version.js

@@ -1,2 +1,2 @@
-export const AGENT_HARNESS_VERSION = "0.0.465";
+export const AGENT_HARNESS_VERSION = "0.0.467";
 export const AGENT_HARNESS_RELEASE_DATE = "2026-05-04";

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

@@ -25,8 +25,8 @@ const RUN_EVIDENCE_AFTER_PREMATURE_PLAN_CLOSE_INSTRUCTION = [
     "The required todo board was closed before any non-TODO evidence tool returned.",
     "Do not call write_todos again yet.",
     "Your next action must be exactly one non-TODO evidence tool call selected from the available tool descriptions and schemas.",
-    "If the current request or todo board explicitly names one available non-TODO tool, call that named tool.",
-    "Do not substitute a neighboring, broader, narrower, or similarly named tool when an exact available tool name is present.",
+    "Honor any structured workspace or runtime evidence-tool contract already supplied in this turn.",
+    "Do not choose tools by matching free-form request or TODO text.",
     "After that evidence tool returns, update the todo board and then provide the final answer required by the agent response format.",
 ].join("\n");
 function readPrimaryToolName(tool) {

package/dist/runtime/adapter/model/model-providers.js

@@ -770,8 +770,8 @@ function withPromptedJsonToolPrompt(input, tools, options = {}) {
             ? [
                 "Required evidence tool call:",
                 "A todo board already exists. Your next action must be exactly one non-planning tool call chosen from the available tool descriptions and schemas.",
-                "If the current request or todo board explicitly names one available non-planning tool, call that named tool.",
-                "Do not substitute a neighboring, broader, narrower, or similarly named tool when an exact available tool name is present.",
+                "Honor any structured workspace or runtime evidence-tool contract already supplied in this turn.",
+                "Do not choose tools by matching free-form request or TODO text.",
                 "Do not call write_todos or read_todos now.",
                 "Do not write prose, markdown, analysis, or a plain-text plan.",
             ].join("\n")

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

@@ -396,26 +396,16 @@ function buildDelegatedPlanEvidenceRecoveryOptions(binding, baseOptions, request
     const nonPlanningTools = binding
         ? getBindingPrimaryTools(binding).filter((tool) => !isPlanToolName(tool.name))
         : [];
-    const explicitlyRequestedTools = resolveExplicitlyRequestedToolNames(requestText, nonPlanningTools.map((tool) => tool.name));
-    const externalPlanEvidenceTools = explicitlyRequestedTools.length === 1
-        ? [{
-                name: explicitlyRequestedTools[0],
-                args: buildExternalPlanEvidenceArgs(nonPlanningTools.find((tool) => tool.name === explicitlyRequestedTools[0]), requestText),
-                id: "delegated-plan-evidence-tool-1",
-            }]
+    const configuredRecoveryTool = resolveConfiguredRecoveryEvidenceTool(binding, nonPlanningTools, requestText);
+    const externalPlanEvidenceTools = configuredRecoveryTool
+        ? [configuredRecoveryTool]
         : nonPlanningTools.length === 1
             ? [{
                     name: nonPlanningTools[0].name,
                     args: buildExternalPlanEvidenceArgs(nonPlanningTools[0], requestText),
                     id: "delegated-plan-evidence-tool-1",
                 }]
-            : nonPlanningTools.length > 1
-                ? [{
-                        name: nonPlanningTools[0].name,
-                        args: buildExternalPlanEvidenceArgs(nonPlanningTools[0], requestText),
-                        id: "delegated-plan-evidence-tool-1",
-                    }]
-                : undefined;
+            : undefined;
     return {
         ...baseOptions,
         suppressInitialRequiredPlanInstruction: true,
@@ -427,6 +417,22 @@ function buildDelegatedPlanEvidenceRecoveryOptions(binding, baseOptions, request
         },
     };
 }
+function resolveConfiguredRecoveryEvidenceTool(binding, nonPlanningTools, requestText) {
+    const configured = binding?.harnessRuntime.executionContract?.recoveryEvidenceTool;
+    const configuredName = typeof configured?.name === "string" ? configured.name.trim() : "";
+    if (!configuredName) {
+        return undefined;
+    }
+    const tool = nonPlanningTools.find((candidate) => candidate.name === configuredName);
+    if (!tool) {
+        return undefined;
+    }
+    return {
+        name: tool.name,
+        args: configured?.args ?? buildExternalPlanEvidenceArgs(tool, requestText),
+        id: "delegated-plan-evidence-tool-1",
+    };
+}
 function buildExternalPlanEvidenceArgs(tool, requestText) {
     const properties = tool?.modelSchema && typeof tool.modelSchema === "object"
         && tool.modelSchema !== null
@@ -453,21 +459,6 @@ function buildExternalPlanEvidenceArgs(tool, requestText) {
     }
     return args;
 }
-function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
-function resolveExplicitlyRequestedToolNames(text, availableToolNames) {
-    if (!text.trim() || availableToolNames.length === 0) {
-        return [];
-    }
-    return availableToolNames.filter((toolName) => {
-        const trimmed = toolName.trim();
-        if (!trimmed) {
-            return false;
-        }
-        return new RegExp(`(^|[^A-Za-z0-9_])${escapeRegExp(trimmed)}([^A-Za-z0-9_]|$)`, "u").test(text);
-    });
-}
 function looksLikeRawCommandTranscript(value) {
     const normalized = value.trim();
     return /^(?:stdout|stderr)\s*:/iu.test(normalized)

package/dist/workspace/agent-binding-compiler.js

@@ -282,8 +282,30 @@ function resolveExecutionContract(agent) {
     if (!value) {
         return undefined;
     }
+    const recoveryEvidenceTool = typeof value.recoveryEvidenceTool === "string" && value.recoveryEvidenceTool.trim().length > 0
+        ? { name: value.recoveryEvidenceTool.trim() }
+        : typeof value.recoveryEvidenceTool === "object" && value.recoveryEvidenceTool && !Array.isArray(value.recoveryEvidenceTool)
+            ? value.recoveryEvidenceTool
+            : undefined;
+    const recoveryEvidenceToolName = recoveryEvidenceTool && typeof recoveryEvidenceTool.name === "string" && recoveryEvidenceTool.name.trim().length > 0
+        ? recoveryEvidenceTool.name.trim()
+        : undefined;
+    const recoveryEvidenceToolArgs = recoveryEvidenceTool
+        && typeof recoveryEvidenceTool.args === "object"
+        && recoveryEvidenceTool.args
+        && !Array.isArray(recoveryEvidenceTool.args)
+        ? recoveryEvidenceTool.args
+        : undefined;
     return {
         ...(value.requiresPlan === true ? { requiresPlan: true } : {}),
+        ...(recoveryEvidenceToolName
+            ? {
+                recoveryEvidenceTool: {
+                    name: recoveryEvidenceToolName,
+                    ...(recoveryEvidenceToolArgs ? { args: recoveryEvidenceToolArgs } : {}),
+                },
+            }
+            : {}),
     };
 }
 function resolveCompiledMiddleware(agent, models) {

package/dist/workspace/framework-contract-validation.js

@@ -50,6 +50,16 @@ function readExecutionContractConfig(agent) {
         ? value
         : undefined;
 }
+function readRecoveryEvidenceToolName(value) {
+    if (typeof value === "string") {
+        return value.trim();
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return "";
+    }
+    const name = value.name;
+    return typeof name === "string" ? name.trim() : "";
+}
 function collectAgentToolNames(agent, tools, ownsDelegation) {
     const names = new Set(FRAMEWORK_EXECUTION_TOOL_NAMES);
     if (ownsDelegation) {
@@ -208,6 +218,13 @@ function validateAgentContract(agent, referencedSubagentIds, tools, refs, issues
     if (executionContract?.requiresPlan === true && builtinTools?.todos === false) {
         addIssue(issues, "agent.execution_contract.plan_without_todos", `Agent ${agent.id} requires plan evidence but disables todo tools. Enable todo tools or remove config.executionContract.requiresPlan.`);
     }
+    const recoveryEvidenceToolName = readRecoveryEvidenceToolName(executionContract?.recoveryEvidenceTool);
+    if (recoveryEvidenceToolName) {
+        const toolNames = collectAgentToolNames(agent, tools, ownsDelegation);
+        if (FRAMEWORK_EXECUTION_TOOL_NAMES.has(recoveryEvidenceToolName) || !toolNames.has(recoveryEvidenceToolName)) {
+            addIssue(issues, "agent.execution_contract.invalid_recovery_evidence_tool", `Agent ${agent.id} config.executionContract.recoveryEvidenceTool must name one declared non-planning tool.`);
+        }
+    }
     if (ownsDelegation) {
         if (hasTools) {
             addIssue(issues, "agent.orchestrator.mixed_tool_surface", `Delegating agent ${agent.id} defines both subagents and direct tools. Keep routing agents focused on delegation, and move execution tools to specialist agents.`);

package/package.json

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