@botbotgo/agent-harness 0.0.340 → 0.0.341

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

@@ -7,11 +7,20 @@ export declare function isRepairableWriteTodosEmptyFailure(error: unknown): bool
 export declare function isToolCallRecoveryFailure(error: unknown): boolean;
 export declare function isRetrySafeInvalidToolSelectionError(value: unknown): boolean;
 export declare function shouldValidateExecutionWithoutToolEvidence(request: unknown): boolean;
+export declare function shouldRequireVisibleTodoPlan(request: unknown): boolean;
+export declare function resolveMissingPlanRecoveryInstruction(params: {
+    request: unknown;
+    assistantText?: string;
+    hasPlanStateEvidence?: boolean;
+    hasWriteTodosEvidence?: boolean;
+    hasToolResultEvidence?: boolean;
+}): string | null;
 export declare function resolveExecutionWithoutToolEvidenceInstruction(request: unknown, result: unknown): string | null;
 export declare function resolveExecutionWithoutToolEvidenceTextInstruction(request: unknown, assistantText: string, toolCallEvidence?: boolean, resultEvidence?: {
     hasWriteTodosEvidence?: boolean;
     hasToolResultEvidence?: boolean;
     hasIncompletePlanState?: boolean;
+    hasPlanStateEvidence?: boolean;
     hasOpenTaskDelegation?: boolean;
     hasMissingDelegatedExecutionEvidence?: boolean;
 }): string | null;

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

@@ -1,4 +1,4 @@
-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 { 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, WRITE_TODOS_REQUIRED_PLAN_INSTRUCTION, } from "../prompts/runtime-prompts.js";
 import { wrapNormalizedMessage, readTextContent } from "./output-content.js";
 function collectRequestMessages(request) {
     if (typeof request !== "object" || !request || Array.isArray(request)) {
@@ -111,6 +111,41 @@ export function shouldValidateExecutionWithoutToolEvidence(request) {
     }
     return readSystemInstructionText(request).length > 0;
 }
+export function shouldRequireVisibleTodoPlan(request) {
+    const userText = readLatestUserRequestText(request).toLowerCase();
+    if (!userText) {
+        return false;
+    }
+    return [
+        "investigate",
+        "investigation",
+        "issue",
+        "issues",
+        "rca",
+        "root cause",
+        "go deeper",
+        "deep research",
+        "debug",
+        "排查",
+        "调查",
+        "问题",
+        "根因",
+        "故障",
+        "集群",
+        "cluster",
+    ].some((keyword) => userText.includes(keyword));
+}
+export function resolveMissingPlanRecoveryInstruction(params) {
+    const hasPlanEvidence = params.hasWriteTodosEvidence === true
+        || params.hasPlanStateEvidence === true;
+    if (!shouldRequireVisibleTodoPlan(params.request) || hasPlanEvidence) {
+        return null;
+    }
+    if (params.hasToolResultEvidence === true) {
+        return WRITE_TODOS_REQUIRED_PLAN_INSTRUCTION;
+    }
+    return null;
+}
 export function resolveExecutionWithoutToolEvidenceInstruction(request, result) {
     const assistantText = readTextContent(result).trim();
     return resolveExecutionWithoutToolEvidenceTextInstruction(request, assistantText, false, {});
@@ -120,6 +155,16 @@ export function resolveExecutionWithoutToolEvidenceTextInstruction(request, assi
         return null;
     }
     const normalizedText = assistantText.trim();
+    const missingPlanRecoveryInstruction = resolveMissingPlanRecoveryInstruction({
+        request,
+        assistantText: normalizedText,
+        hasWriteTodosEvidence: resultEvidence.hasWriteTodosEvidence,
+        hasPlanStateEvidence: resultEvidence.hasIncompletePlanState === true || resultEvidence.hasPlanStateEvidence === true,
+        hasToolResultEvidence: resultEvidence.hasToolResultEvidence,
+    });
+    if (missingPlanRecoveryInstruction) {
+        return missingPlanRecoveryInstruction;
+    }
     const hasUnfinishedExecution = resultEvidence.hasIncompletePlanState === true
         || resultEvidence.hasOpenTaskDelegation === true
         || resultEvidence.hasMissingDelegatedExecutionEvidence === true;

package/dist/runtime/support/compiled-binding.d.ts

@@ -31,6 +31,11 @@ export declare function getBindingDeepAgentSubagents(binding: CompiledAgentBindi
 export declare function getBindingGeneralPurposeAgent(binding: CompiledAgentBinding): boolean | undefined;
 export declare function getBindingTaskDescription(binding: CompiledAgentBinding): string | undefined;
 export declare function getBindingBackendConfig(binding: CompiledAgentBinding): Record<string, unknown> | undefined;
+export declare function getBindingInteractionMode(binding: CompiledAgentBinding): "stream" | "invoke" | undefined;
+export declare function getBindingBuiltinToolsConfig(binding: CompiledAgentBinding): {
+    filesystem?: boolean;
+    todos?: boolean;
+} | undefined;
 export declare function getBindingFilesystemConfig(binding: CompiledAgentBinding): Record<string, unknown> | undefined;
 export declare function isLangChainBinding(binding: CompiledAgentBinding): boolean;
 export declare function isDeepAgentBinding(binding: CompiledAgentBinding): boolean;

package/dist/runtime/support/compiled-binding.js

@@ -229,6 +229,18 @@ export function getBindingBackendConfig(binding) {
     const backend = execution?.backend;
     return typeof backend === "object" && backend ? backend : undefined;
 }
+export function getBindingInteractionMode(binding) {
+    const execution = getBindingExecutionParams(binding);
+    const mode = execution?.interactionMode;
+    return mode === "invoke" || mode === "stream" ? mode : undefined;
+}
+export function getBindingBuiltinToolsConfig(binding) {
+    const execution = getBindingExecutionParams(binding);
+    const builtinTools = execution?.builtinTools;
+    return typeof builtinTools === "object" && builtinTools
+        ? builtinTools
+        : undefined;
+}
 export function getBindingFilesystemConfig(binding) {
     const langchainFilesystem = binding.harnessRuntime?.langchain?.filesystem;
     if (typeof langchainFilesystem === "object" && langchainFilesystem) {

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

@@ -169,6 +169,7 @@ export function requireTools(tools, bindings, ownerId) {
 function buildSubagent(agent, workspaceRoot, models, tools, parentSkills, parentModel) {
     const execution = compileExecutionCore(agent, workspaceRoot, models, tools);
     return {
+        agentId: agent.id,
         name: resolveAgentRuntimeName(agent),
         description: agent.description,
         systemPrompt: execution.systemPrompt ?? WORKSPACE_BOUNDARY_GUIDANCE,
@@ -178,6 +179,7 @@ function buildSubagent(agent, workspaceRoot, models, tools, parentSkills, parent
         skills: compileAgentSkills(workspaceRoot, agent, parentSkills),
         responseFormat: execution.responseFormat,
         middleware: execution.middleware,
+        builtinTools: getAgentExecutionObject(agent, "builtinTools"),
     };
 }
 function resolveSystemPrompt(agent, workspaceRoot) {
@@ -484,6 +486,12 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
             name: resolveAgentRuntimeName(agent),
             memory: compiledAgentMemory,
             skills: compiledAgentSkills,
+            interactionMode: getAgentExecutionConfigValue(agent, "interactionMode", { executionMode: "deepagent" }) === "invoke"
+                ? "invoke"
+                : getAgentExecutionConfigValue(agent, "interactionMode", { executionMode: "deepagent" }) === "stream"
+                    ? "stream"
+                    : undefined,
+            builtinTools: getAgentExecutionObject(agent, "builtinTools"),
         },
     };
     return attachLegacyExecutionAliases({

package/dist/workspace/object-loader.js

@@ -27,6 +27,8 @@ const CONSUMED_AGENT_CONFIG_KEYS = [
     "taskDescription",
     "generalPurposeAgent",
     "filesystem",
+    "builtinTools",
+    "interactionMode",
 ];
 const NON_AGENT_CONFIG_ITEM_KEYS = [
     "id",
@@ -61,6 +63,8 @@ const MIGRATED_AGENT_CONFIG_KEYS = [
     "taskDescription",
     "generalPurposeAgent",
     "filesystem",
+    "builtinTools",
+    "interactionMode",
 ];
 function normalizeAgentItemForMerge(item) {
     const normalized = { ...item };
@@ -223,6 +227,7 @@ function resolveExecutionBackend(item, current) {
 function readSharedAgentConfigFields(config, options = {}) {
     return {
         ...(typeof config.store === "object" && config.store ? { store: config.store } : {}),
+        ...(typeof config.builtinTools === "object" && config.builtinTools ? { builtinTools: cloneConfigValue(config.builtinTools) } : {}),
         ...(options.includeDelegationControls && typeof config.taskDescription === "string" && config.taskDescription.trim()
             ? { taskDescription: config.taskDescription }
             : {}),
@@ -258,6 +263,7 @@ function readSharedAgentConfig(config) {
         ...(config.stateSchema !== undefined ? { stateSchema: config.stateSchema } : {}),
         ...(config.responseFormat !== undefined ? { responseFormat: config.responseFormat } : {}),
         ...(config.contextSchema !== undefined ? { contextSchema: config.contextSchema } : {}),
+        ...(config.interactionMode === "stream" || config.interactionMode === "invoke" ? { interactionMode: config.interactionMode } : {}),
         ...(config.includeAgentName === "inline" ? { includeAgentName: "inline" } : {}),
         ...(config.version === "v1" || config.version === "v2" ? { version: config.version } : {}),
         ...(typeof config.filesystem === "object" && config.filesystem ? { filesystem: config.filesystem } : {}),

package/package.json

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