@botbotgo/agent-harness 0.0.326 → 0.0.328

package/dist/runtime/adapter/tool/builtin-middleware-tools.js

@@ -4,6 +4,28 @@ import { isSandboxBackend } from "deepagents";
 import { isRecord } from "../../../utils/object.js";
 import { formatBuiltinTodoSnapshot, isLowSignalTodoContent, summarizeBuiltinWriteTodosArgs, truncateLines } from "../runtime-adapter-support.js";
 import { maybePersistLargeToolOutput, resolveToolRuntimeContext } from "./tool-output-artifacts.js";
+const taskToolSchema = z.preprocess((value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return value;
+    }
+    return normalizeTaskToolInput(value);
+}, z.object({
+    description: z.string(),
+    subagent_type: z.string(),
+}).passthrough());
+function normalizeTaskToolInput(typed) {
+    const description = typeof typed.description === "string" && typed.description.trim().length > 0
+        ? typed.description
+        : undefined;
+    const subagentType = typeof typed.subagent_type === "string" && typed.subagent_type.trim().length > 0
+        ? typed.subagent_type
+        : undefined;
+    return {
+        ...typed,
+        ...(description !== undefined ? { description } : {}),
+        ...(subagentType !== undefined ? { subagent_type: subagentType } : {}),
+    };
+}
 export const BUILTIN_MIDDLEWARE_TOOL_DESCRIPTORS = [
     { name: "write_todos", description: "Create and update the runtime todo board for multi-step work." },
     { name: "read_todos", description: "Read the current runtime todo board." },
@@ -23,7 +45,6 @@ export const BUILTIN_MIDDLEWARE_TOOL_DESCRIPTORS = [
     { name: "request_approval", description: "Request an approval decision from the runtime." },
     { name: "schedule_task", description: "Create, inspect, update, list, and delete system-level scheduled tasks." },
     { name: "task", description: "Delegate a bounded task to a subagent." },
-    { name: "delegate_task", description: "Delegate a bounded task to a subagent." },
 ];
 function toDisplayContent(content) {
     if (typeof content === "string") {
@@ -181,7 +202,6 @@ export async function createBuiltinMiddlewareTools(backend, options) {
             completed: 0,
             failed: 0,
             cancelled: 0,
-            blocked: 0,
         },
     };
     const finalizeOutput = async (toolName, output, toolConfig) => maybePersistLargeToolOutput({
@@ -193,7 +213,17 @@ export async function createBuiltinMiddlewareTools(backend, options) {
         name: "write_todos",
         description: "Create and update the runtime todo board for multi-step work.",
         schema: z.object({
-            todos: z.array(z.object({}).passthrough()).optional(),
+            todos: z.array(z.object({
+                id: z.string().optional(),
+                content: z.string().optional(),
+                description: z.string().optional(),
+                status: z.enum(["pending", "in_progress", "completed", "failed", "cancelled"]).optional(),
+                ownerAgentId: z.string().optional(),
+                startedAt: z.string().optional(),
+                endedAt: z.string().optional(),
+                result: z.unknown().optional(),
+                metadata: z.record(z.string(), z.unknown()).optional(),
+            }).passthrough()).optional(),
         }).passthrough(),
         invoke: async (input) => {
             const args = isRecord(input) ? input : {};
@@ -584,20 +614,10 @@ export async function createBuiltinMiddlewareTools(backend, options) {
         tools.set("task", {
             name: "task",
             description: "Delegate a bounded task to a subagent.",
-            schema: z.object({
-                description: z.string(),
-                subagent_type: z.string(),
-            }).passthrough(),
-            invoke: options.invokeTaskTool,
-        });
-        tools.set("delegate_task", {
-            name: "delegate_task",
-            description: "Delegate a bounded task to a subagent.",
-            schema: z.object({
-                description: z.string(),
-                subagent_type: z.string(),
-            }).passthrough(),
-            invoke: async (input) => tools.get("task").invoke(input),
+            schema: taskToolSchema,
+            invoke: async (input, config) => options.invokeTaskTool(typeof input === "object" && input !== null && !Array.isArray(input)
+                ? normalizeTaskToolInput(input)
+                : {}),
         });
     }
     return tools;

package/dist/runtime/adapter/tool/resolved-tool.js

@@ -19,6 +19,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;
     }
@@ -32,7 +35,21 @@ 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 getZodLikeObjectShape(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
@@ -58,7 +75,13 @@ function isZodLikeOptional(value) {
     if (!typeName) {
         return false;
     }
-    return typeName === "optional" || typeName === "default" || typeName === "catch";
+    if (typeName === "optional" || typeName === "default" || typeName === "catch") {
+        return true;
+    }
+    if (typeName === "effects" || typeName === "pipeline" || typeName === "pipe" || typeName === "transform") {
+        return isZodLikeOptional(getZodLikeInnerSchema(value));
+    }
+    return false;
 }
 function buildBestEffortJsonSchema(value) {
     const shape = isZodRawShape(value) ? value : getZodLikeObjectShape(value);
@@ -70,7 +93,7 @@ function buildBestEffortJsonSchema(value) {
         return {
             type: "object",
             properties,
-            ...(required.length > 0 ? { required } : {}),
+            required,
         };
     }
     const typeName = getZodLikeTypeName(value);
@@ -101,6 +124,9 @@ function buildBestEffortJsonSchema(value) {
             additionalProperties: buildBestEffortJsonSchema(getZodLikeInnerSchema(value)) ?? {},
         };
     }
+    if (typeName === "effects" || typeName === "pipeline" || typeName === "pipe" || typeName === "transform") {
+        return buildBestEffortJsonSchema(getZodLikeInnerSchema(value)) ?? {};
+    }
     return {};
 }
 function jsonSchemaPreservesShape(schema, expectedKeys) {

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

@@ -1,8 +1,8 @@
 import type { CompiledAgentBinding, MessageContent, RequestResult, RuntimeAdapterOptions, TranscriptMessage } from "../contracts/types.js";
 import { type RuntimeStreamChunk } from "./parsing/stream-event-parsing.js";
-import { AGENT_INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, buildMinimalDeepAgentCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, shouldUseMinimalDeepAgentAssembly } from "./agent-runtime-assembly.js";
+import { AGENT_INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn } from "./agent-runtime-assembly.js";
 import { RuntimeOperationTimeoutError } from "./adapter/runtime-shell.js";
-export { applyDeepAgentDelegationPromptCompatibility, materializeDeepAgentSkillSourcePaths, resolveDeepAgentSkillSourcePaths, relativizeDeepAgentSkillSourcePaths, shouldRelaxDeepAgentDelegationPrompt, } from "./adapter/compat/deepagent-compat.js";
+export { materializeDeepAgentSkillSourcePaths, resolveDeepAgentSkillSourcePaths, relativizeDeepAgentSkillSourcePaths, } from "./adapter/compat/deepagent-compat.js";
 export { buildAuthOmittingFetch, normalizeOpenAICompatibleInit } from "./adapter/compat/openai-compatible.js";
 export { buildToolNameMapping, createModelFacingToolNameCandidates, createModelFacingToolNameLookupCandidates, resolveModelFacingToolName, sanitizeToolNameForModel, } from "./adapter/tool/tool-name-mapping.js";
 export { computeRemainingTimeoutMs, isRetryableProviderError, resolveBindingTimeout, resolveProviderRetryPolicy, resolveStreamIdleTimeout, resolveTimeoutMs, } from "./adapter/resilience.js";
@@ -66,4 +66,4 @@ export declare class AgentRuntimeAdapter {
         toolRuntimeContext?: Record<string, unknown>;
     }): AsyncGenerator<RuntimeStreamChunk | string>;
 }
-export { AgentRuntimeAdapter as RuntimeAdapter, AGENT_INTERRUPT_SENTINEL_PREFIX, AGENT_INTERRUPT_SENTINEL_PREFIX as INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, buildMinimalDeepAgentCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, shouldUseMinimalDeepAgentAssembly, RuntimeOperationTimeoutError, };
+export { AgentRuntimeAdapter as RuntimeAdapter, AGENT_INTERRUPT_SENTINEL_PREFIX, AGENT_INTERRUPT_SENTINEL_PREFIX as INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, RuntimeOperationTimeoutError, };

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

@@ -2,7 +2,7 @@ import path from "node:path";
 import { createDeepAgent, FilesystemBackend, } from "deepagents";
 import { createAgent } from "langchain";
 import { wrapResolvedModel, } from "./parsing/output-parsing.js";
-import { AGENT_INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, buildMinimalDeepAgentCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, shouldAttachMinimalDeepAgentBackend, shouldAttachMinimalDeepAgentCheckpointer, shouldAttachMinimalDeepAgentStore, shouldUseMinimalDeepAgentAssembly, } from "./agent-runtime-assembly.js";
+import { AGENT_INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, shouldAttachDeepAgentBackend, shouldAttachDeepAgentCheckpointer, shouldAttachDeepAgentStore, } from "./agent-runtime-assembly.js";
 import { resolveDeepAgentSkillSourcePaths, } from "./adapter/compat/deepagent-compat.js";
 import { buildToolNameMapping, } from "./adapter/tool/tool-name-mapping.js";
 import { executeRequestInvocation } from "./adapter/flow/invocation-flow.js";
@@ -15,7 +15,7 @@ import { renderDirectWorkspaceListing, shouldDirectlyListWorkspaceFiles } from "
 import { resolveAdapterTools } from "./adapter/tool-resolution.js";
 import { resolveRuntimeStreamExecutionContext, } from "./adapter/flow/execution-context.js";
 import { isRetryableProviderError } from "./adapter/resilience.js";
-export { applyDeepAgentDelegationPromptCompatibility, materializeDeepAgentSkillSourcePaths, resolveDeepAgentSkillSourcePaths, relativizeDeepAgentSkillSourcePaths, shouldRelaxDeepAgentDelegationPrompt, } from "./adapter/compat/deepagent-compat.js";
+export { materializeDeepAgentSkillSourcePaths, resolveDeepAgentSkillSourcePaths, relativizeDeepAgentSkillSourcePaths, } from "./adapter/compat/deepagent-compat.js";
 export { buildAuthOmittingFetch, normalizeOpenAICompatibleInit } from "./adapter/compat/openai-compatible.js";
 export { buildToolNameMapping, createModelFacingToolNameCandidates, createModelFacingToolNameLookupCandidates, resolveModelFacingToolName, sanitizeToolNameForModel, } from "./adapter/tool/tool-name-mapping.js";
 export { computeRemainingTimeoutMs, isRetryableProviderError, resolveBindingTimeout, resolveProviderRetryPolicy, resolveStreamIdleTimeout, resolveTimeoutMs, } from "./adapter/resilience.js";
@@ -354,18 +354,11 @@ export class AgentRuntimeAdapter {
         const resolvedMiddleware = await this.resolveMiddleware(binding);
         const resolvedSubagents = await this.resolveDeepAgentSubagents(getBindingDeepAgentSubagents(binding), binding);
         const resolvedInterruptOn = resolveRunnableInterruptOn(binding);
-        const substrateMode = this.options.deepAgentUpstreamSubstrateMode ?? "minimal";
-        const resolvedCheckpointer = substrateMode === "minimal"
-            ? (shouldAttachMinimalDeepAgentCheckpointer(binding, resolvedInterruptOn)
-                ? resolveRunnableCheckpointer(this.options, binding)
-                : undefined)
-            : resolveRunnableCheckpointer(this.options, binding);
-        const resolvedStore = substrateMode === "minimal"
-            ? (shouldAttachMinimalDeepAgentStore(binding) ? this.options.storeResolver?.(binding) : undefined)
-            : this.options.storeResolver?.(binding);
-        const resolvedBackend = substrateMode === "minimal"
-            ? (shouldAttachMinimalDeepAgentBackend(binding) ? this.options.backendResolver?.(binding) : undefined)
-            : this.options.backendResolver?.(binding);
+        const resolvedCheckpointer = shouldAttachDeepAgentCheckpointer(binding, resolvedInterruptOn)
+            ? resolveRunnableCheckpointer(this.options, binding)
+            : undefined;
+        const resolvedStore = shouldAttachDeepAgentStore(binding) ? this.options.storeResolver?.(binding) : undefined;
+        const resolvedBackend = shouldAttachDeepAgentBackend(binding) ? this.options.backendResolver?.(binding) : undefined;
         const resolvedSkills = resolveDeepAgentSkillSourcePaths({
             workspaceRoot: binding.harnessRuntime.workspaceRoot,
             runtimeRoot: binding.harnessRuntime.runtimeRoot,
@@ -384,24 +377,6 @@ export class AgentRuntimeAdapter {
             resolvedInterruptOn,
             resolvedSkills,
         });
-        if (shouldUseMinimalDeepAgentAssembly({
-            binding,
-            resolvedMiddleware,
-            resolvedSubagents,
-            resolvedInterruptOn,
-            resolvedSkills,
-            resolvedBackend,
-        })) {
-            const minimalDeepAgentConfig = buildMinimalDeepAgentCreateParams({
-                binding,
-                resolvedModel,
-                resolvedTools: [...resolvedTools, ...builtinMiddlewareTools],
-                resolvedCheckpointer,
-                resolvedStore,
-                resolvedBackend,
-            });
-            return createAgent(minimalDeepAgentConfig);
-        }
         return createDeepAgent(deepAgentConfig);
     }
     buildRunnableCacheKey(binding, sessionId) {
@@ -559,7 +534,11 @@ export class AgentRuntimeAdapter {
             isLangChainBinding,
             isDeepAgentBinding,
             countConfiguredTools: getBindingToolCount,
+            countConfiguredToolsForAgentId: (agentId) => {
+                const resolved = this.options.bindingResolver?.(agentId);
+                return resolved ? getBindingToolCount(resolved) : 0;
+            },
         });
     }
 }
-export { AgentRuntimeAdapter as RuntimeAdapter, AGENT_INTERRUPT_SENTINEL_PREFIX, AGENT_INTERRUPT_SENTINEL_PREFIX as INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, buildMinimalDeepAgentCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, shouldUseMinimalDeepAgentAssembly, RuntimeOperationTimeoutError, };
+export { AgentRuntimeAdapter as RuntimeAdapter, AGENT_INTERRUPT_SENTINEL_PREFIX, AGENT_INTERRUPT_SENTINEL_PREFIX as INTERRUPT_SENTINEL_PREFIX, buildDeepAgentCreateParams, buildLangChainCreateParams, materializeModelExposedBuiltinMiddlewareTools, resolveLangChainInvocationConfig, resolveRunnableCheckpointer, resolveRunnableInterruptOn, RuntimeOperationTimeoutError, };

package/dist/runtime/agent-runtime-assembly.d.ts

@@ -42,26 +42,8 @@ export declare function buildDeepAgentCreateParams(input: {
     }>;
     resolvedSkills: string[];
 }): Record<string, unknown>;
-export declare function shouldUseMinimalDeepAgentAssembly(input: {
-    binding: CompiledAgentBinding;
-    resolvedMiddleware: unknown[];
-    resolvedSubagents: Array<UpstreamSubagentConfig | CompiledAsyncSubAgent>;
-    resolvedInterruptOn?: Record<string, {
-        allowedDecisions: Array<"approve" | "edit" | "reject">;
-    }>;
-    resolvedSkills: string[];
-    resolvedBackend?: unknown;
-}): boolean;
-export declare function buildMinimalDeepAgentCreateParams(input: {
-    binding: CompiledAgentBinding;
-    resolvedModel: unknown;
-    resolvedTools: unknown[];
-    resolvedCheckpointer?: unknown;
-    resolvedStore?: unknown;
-    resolvedBackend: unknown;
-}): Record<string, unknown>;
-export declare function shouldAttachMinimalDeepAgentCheckpointer(binding: CompiledAgentBinding, resolvedInterruptOn?: Record<string, {
+export declare function shouldAttachDeepAgentCheckpointer(binding: CompiledAgentBinding, resolvedInterruptOn?: Record<string, {
     allowedDecisions: Array<"approve" | "edit" | "reject">;
 }>): boolean;
-export declare function shouldAttachMinimalDeepAgentStore(binding: CompiledAgentBinding): boolean;
-export declare function shouldAttachMinimalDeepAgentBackend(binding: CompiledAgentBinding): boolean;
+export declare function shouldAttachDeepAgentStore(binding: CompiledAgentBinding): boolean;
+export declare function shouldAttachDeepAgentBackend(binding: CompiledAgentBinding): boolean;

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

@@ -1,16 +1,13 @@
 import { MemorySaver } from "@langchain/langgraph";
-import { createFilesystemMiddleware, createPatchToolCallsMiddleware } from "deepagents";
-import { todoListMiddleware } from "langchain";
 import { UPSTREAM_REQUEST_CONFIG_KEY, UPSTREAM_SESSION_CONFIG_KEY } from "./adapter/upstream-configurable-keys.js";
 import { asStructuredExecutableTool } from "./adapter/tool/resolved-tool.js";
 import { compileInterruptOn } from "./adapter/tool/interrupt-policy.js";
-import { getBindingBackendConfig, getBindingDeepAgentSubagents, getBindingExecutionKind, getBindingExecutionParams, getBindingInterruptCompatibilityRules, getBindingMemorySources, getBindingMiddlewareConfigs, getBindingPrimaryTools, getBindingSkills, getBindingStoreConfig, } from "./support/compiled-binding.js";
+import { getBindingBackendConfig, getBindingExecutionKind, getBindingExecutionParams, getBindingInterruptCompatibilityRules, getBindingMemorySources, getBindingMiddlewareConfigs, getBindingPrimaryTools, getBindingSkills, getBindingStoreConfig, } from "./support/compiled-binding.js";
 export const AGENT_INTERRUPT_SENTINEL_PREFIX = "__agent_harness_interrupt__:";
 const BUILTIN_MIDDLEWARE_ALIAS_TOOL_NAMES = new Set([
     "list_files",
     "search_files",
     "run_command",
-    "delegate_task",
 ]);
 const MODEL_EXPOSED_BUILTIN_MIDDLEWARE_TOOL_NAMES = new Set([
     "fetch_url",
@@ -145,65 +142,16 @@ export function buildDeepAgentCreateParams(input) {
         ...(input.resolvedBackend !== undefined ? { backend: input.resolvedBackend } : {}),
     };
 }
-export function shouldUseMinimalDeepAgentAssembly(input) {
-    const executionKind = getBindingExecutionKind(input.binding);
-    if (executionKind !== "deepagent") {
-        return false;
-    }
-    if (input.resolvedBackend === undefined) {
-        return false;
-    }
-    if (input.resolvedSkills.length > 0) {
-        return false;
-    }
-    if (input.resolvedSubagents.length > 0 || getBindingDeepAgentSubagents(input.binding).length > 0) {
-        return false;
-    }
-    if (getBindingMemorySources(input.binding).length > 0) {
-        return false;
-    }
-    if (input.resolvedMiddleware.length > 0 || (getBindingMiddlewareConfigs(input.binding)?.length ?? 0) > 0) {
-        return false;
-    }
-    return input.resolvedInterruptOn === undefined || Object.keys(input.resolvedInterruptOn).length === 0;
-}
-export function buildMinimalDeepAgentCreateParams(input) {
-    const executionKind = getBindingExecutionKind(input.binding);
-    if (executionKind !== "deepagent" || !getBindingExecutionParams(input.binding)) {
-        throw new Error(`Agent ${input.binding.agent.id} has no runnable params`);
-    }
-    const upstreamParams = buildUpstreamCreateBaseParams(input.binding, [
-        "systemPrompt",
-        "contextSchema",
-        "responseFormat",
-        "name",
-        "description",
-        "includeAgentName",
-        "version",
-    ]);
-    return {
-        ...upstreamParams,
-        model: input.resolvedModel,
-        tools: input.resolvedTools,
-        middleware: [
-            todoListMiddleware(),
-            createFilesystemMiddleware({ backend: input.resolvedBackend }),
-            createPatchToolCallsMiddleware(),
-        ],
-        ...(input.resolvedCheckpointer !== undefined ? { checkpointer: input.resolvedCheckpointer } : {}),
-        ...(input.resolvedStore !== undefined ? { store: input.resolvedStore } : {}),
-    };
-}
-export function shouldAttachMinimalDeepAgentCheckpointer(binding, resolvedInterruptOn) {
+export function shouldAttachDeepAgentCheckpointer(binding, resolvedInterruptOn) {
     if (binding.harnessRuntime.checkpointer !== undefined) {
         return true;
     }
     return resolvedInterruptOn !== undefined && Object.keys(resolvedInterruptOn).length > 0;
 }
-export function shouldAttachMinimalDeepAgentStore(binding) {
+export function shouldAttachDeepAgentStore(binding) {
     return getBindingStoreConfig(binding) !== undefined || getBindingMemorySources(binding).length > 0;
 }
-export function shouldAttachMinimalDeepAgentBackend(binding) {
+export function shouldAttachDeepAgentBackend(binding) {
     return (getBindingBackendConfig(binding) !== undefined ||
         getBindingMemorySources(binding).length > 0 ||
         getBindingSkills(binding).length > 0 ||

package/dist/runtime/harness/run/inspection.js

@@ -26,6 +26,16 @@ function isTaskDelegationCompletionEvent(event) {
     return ((eventName === "on_tool_end" && name === "task")
         || (eventName === "on_chain_end" && runType === "tool" && name === "task"));
 }
+function isTaskDelegationFailureEvent(event) {
+    const eventName = typeof event.event === "string" ? event.event : "";
+    const name = typeof event.name === "string" ? event.name : "";
+    const runType = typeof event.run_type === "string" ? event.run_type : "";
+    return ((eventName === "on_tool_error" && name === "task")
+        || (eventName === "on_chain_error" && runType === "tool" && name === "task"));
+}
+function isTaskDelegationTerminalEvent(event) {
+    return isTaskDelegationCompletionEvent(event) || isTaskDelegationFailureEvent(event);
+}
 function readTracingConfig(binding) {
     const deepAgentTracing = asObject(binding.harnessRuntime?.deepagent?.passthrough)?.tracing;
     const langchainTracing = asObject(binding.harnessRuntime?.langchain?.passthrough)?.tracing;
@@ -152,9 +162,7 @@ function extractSubagentFromTaskToolEvent(event) {
     const input = asObject(data?.input);
     const subagentType = typeof input?.subagent_type === "string"
         ? input.subagent_type
-        : typeof input?.subagentType === "string"
-            ? input.subagentType
-            : null;
+        : null;
     return subagentType && subagentType.trim().length > 0 ? subagentType.trim() : null;
 }
 function extractKnownSubagentFromEvent(event, knownSubagentIds) {
@@ -175,6 +183,14 @@ export function consumeRunInspectionUpstreamEvent(input) {
     }
     const knownSubagentIds = new Set(getBindingSubagents(input.binding).map((subagent) => subagent.name));
     const delegatedAgentId = extractSubagentFromTaskToolEvent(typed) ?? extractKnownSubagentFromEvent(typed, knownSubagentIds);
+    if (isTaskDelegationTerminalEvent(typed) && input.delegationChain.length > 1) {
+        const nextDelegationChain = input.delegationChain.slice(0, -1);
+        const nextAgentId = nextDelegationChain.at(-1) ?? input.currentAgentId;
+        return {
+            currentAgentId: nextAgentId,
+            delegationChain: nextDelegationChain,
+        };
+    }
     if (!delegatedAgentId) {
         return {
             currentAgentId: input.currentAgentId,
@@ -299,7 +315,7 @@ export function projectRuntimeSurfaceFromSingleUpstreamEvent(input) {
                 },
             });
         }
-        if (isTaskDelegationCompletionEvent(typed) && previousDelegationChain.length > 1) {
+        if (isTaskDelegationTerminalEvent(typed) && previousDelegationChain.length > 1) {
             const delegatedAgentId = previousDelegationChain.at(-1);
             const ownerAgentId = previousDelegationChain.at(-2);
             const delegatedAgentName = formatAgentName(delegatedAgentId);
@@ -308,7 +324,7 @@ export function projectRuntimeSurfaceFromSingleUpstreamEvent(input) {
                 id: buildSurfaceId("agent", delegatedAgentId),
                 name: delegatedAgentName,
                 action: "handoff",
-                status: "completed",
+                status: isTaskDelegationFailureEvent(typed) ? "failed" : "completed",
                 agentId: delegatedAgentId,
                 agentName: delegatedAgentName,
                 ...(ownerAgentId ? { ownerAgentId, ownerAgentName: formatAgentName(ownerAgentId) } : {}),

package/dist/runtime/harness/run/run-operations.js

@@ -1,3 +1,4 @@
+import { describeRuntimeError } from "../../support/harness-support.js";
 import { isTerminalRequestState } from "./helpers.js";
 async function finalizeIfCancellationRequested(input) {
     const cancellation = await input.getRequestCancellation(input.requestId);
@@ -200,7 +201,7 @@ export async function executeQueuedRequestOperation(runtime, input) {
         await runtime.emitSyntheticFallback(sessionId, requestId, agentId, error);
         await runtime.setRequestStateAndEmit(sessionId, requestId, 104, "failed", {
             previousState: continuationState,
-            error: error instanceof Error ? error.message : String(error),
+            error: describeRuntimeError(error),
         });
         return {
             sessionId: sessionId,

package/dist/runtime/harness/run/stream-run.d.ts

@@ -1,4 +1,4 @@
-import type { CompiledAgentBinding, HarnessEvent, MemoryRecord, MessageContent, RequestResult, RequestExecutionStep, RuntimeSnapshot, TranscriptMessage } from "../../../contracts/types.js";
+import type { CompiledAgentBinding, HarnessEvent, MemoryRecord, MessageContent, RequestPlanState, RequestResult, RequestExecutionStep, RuntimeSnapshot, TranscriptMessage } from "../../../contracts/types.js";
 import { type InternalHarnessStreamItem } from "../events/streaming.js";
 type RuntimeStreamChunk = {
     kind: "commentary";
@@ -65,6 +65,8 @@ type StreamRunOptions = {
         runtimeSnapshot?: RuntimeSnapshot | null;
     }) => Promise<void>;
     appendRequestTraceItem: (sessionId: string, requestId: string, item: unknown) => Promise<void>;
+    loadRequestPlanState?: (sessionId: string, requestId: string) => Promise<RequestPlanState | null>;
+    saveRequestPlanState?: (sessionId: string, requestId: string, planState: RequestPlanState) => Promise<void>;
     emitSyntheticFallback: (sessionId: string, requestId: string, selectedAgentId: string, error: unknown) => Promise<void>;
 };
 export declare function streamHarnessRun(options: StreamRunOptions): AsyncGenerator<InternalHarnessStreamItem>;