eve 0.51.0 → 0.52.0

package/dist/src/execution/tasks/parent/subagent-task-projection.d.ts

@@ -0,0 +1,26 @@
+import type { loadContext } from "#context/container.js";
+import { createSubagentReceiptIdentity } from "#execution/tools/subagent/receipt-identity.js";
+import type { JsonObject } from "#shared/json.js";
+export interface SubagentTaskProjection {
+    readonly identity?: ReturnType<typeof createSubagentReceiptIdentity>;
+    readonly metadata: {
+        readonly agentId: string;
+        readonly kind: "subagent";
+        readonly mode: "local" | "remote";
+        readonly name: string;
+    };
+    readonly receipt: {
+        readonly agentId: string;
+    };
+}
+export declare function projectSubagentTask(input: {
+    readonly ctx: ReturnType<typeof loadContext>;
+    readonly input: JsonObject;
+    readonly name: string;
+    readonly nodeId: string;
+    readonly taskInput: {
+        readonly callId: string;
+        readonly parentSessionId: string;
+        readonly parentTurnId: string;
+    };
+}): SubagentTaskProjection;

package/dist/src/execution/tasks/parent/subagent-task-projection.js

@@ -0,0 +1 @@
+import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{createSubagentReceiptIdentity}from"#execution/tools/subagent/receipt-identity.js";function projectSubagentTask(e){let t=e.input.agentId;if(typeof t==`string`&&t.trim()!==``)return{metadata:{agentId:t,kind:`subagent`,mode:readSubagentTaskMode(e.ctx,e.nodeId),name:e.name},receipt:{agentId:t}};let r=createSubagentReceiptIdentity({callId:e.taskInput.callId,nodeId:e.nodeId,parentSessionId:e.taskInput.parentSessionId,parentTurnId:e.taskInput.parentTurnId,subagentName:e.name});return{identity:r,metadata:{agentId:r.identity.id,kind:`subagent`,mode:readSubagentTaskMode(e.ctx,e.nodeId),name:e.name},receipt:{agentId:r.identity.id}}}function readSubagentTaskMode(n,r){let i=getDynamicSubagentSelection(n,r);return i===void 0?(n.get(BundleKey)?.subagentRegistry.subagentsByNodeId.get(r))?.definition.kind===`remote`?`remote`:`local`:i.kind===`remote`?`remote`:`local`}export{projectSubagentTask};

package/dist/src/execution/tasks/parent/tool-execution.js

@@ -1 +1 @@
-import{createEveCallbackRoutePath}from"#protocol/routes.js";import{sessionCommandHookToken}from"#execution/session-command-token.js";import{loadContext}from"#context/container.js";import{parseJsonValue}from"#shared/json.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{parseWorkflowToolInput}from"#execution/tools/workflow/background.js";import{getHarnessEmissionState}from"#harness/emission.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{runStep}from"#context/run-step.js";import{activeTurnId}from"#harness/active-turn-id.js";import{AGENT_BUSY,AGENT_MISMATCH,AGENT_UNREACHABLE,formatAgentBusyMessage}from"#subagents/agent-handle-errors.js";import{isTurnCancellation}from"#harness/turn-cancellation.js";import{CallbackBaseUrlKey,isAuthorizationSignal}from"#harness/authorization.js";import{sendTaskCommand,sendTaskInboundPayload,startTaskRun,waitForTaskCommandOwner}from"#execution/tasks/parent/run-parent.js";import{recordSessionTask}from"#tasks/session-index.js";import{applyTaskAgentHandleCommand}from"#subagents/handles/transitions.js";import{createWorkflowCallbackUrl}from"#execution/workflow-callback-url.js";import{BackgroundToolExecutorKey}from"#harness/background-tools.js";import{isAsyncIterable}from"#shared/async-iterable.js";import{createTaskDelegated,isTaskDelegated}from"#tools/task.js";import{beginBackgroundTask,prepareBackgroundTask,rejectDelegatedDispatch}from"#execution/tasks/parent/delegate.js";import{createSubagentReceiptIdentity}from"#execution/tools/subagent/receipt-identity.js";const IN_PROCESS_WORKFLOW_EXECUTOR={data:{},kind:`workflow-task`};function runBackgroundStep(e,t,n){return runStep(e,t,n,[backgroundToolExecutionProvider])}const backgroundToolExecutionProvider={key:BackgroundToolExecutorKey,create(e,t){return{value:new BackgroundToolExecutionScope(t)}},async commit(e,t){return await requireExecutionScope(e).commit(t)},async rollback(e,t){await requireExecutionScope(e).rollback(t)},decorateStepResult(e,t){return requireExecutionScope(e).decorate(t)}};function readRetainedBackgroundToolResult(e){let t=e.get(BackgroundToolExecutorKey);return t instanceof BackgroundToolExecutionScope?t.retainedResult():void 0}var BackgroundToolExecutionScope=class{executions=new Map;records=[];agentHandleSession;agentHandlesChanged=!1;retained=!1;initialSession;constructor(e){this.initialSession=e,this.agentHandleSession=e}execute(e){let t=this.executions.get(e.options.toolCallId);if(t!==void 0)return t;if(!e.batch.calls.some(t=>t.callId===e.options.toolCallId))throw Error(`Background tool call "${e.options.toolCallId}" was not registered before execution.`);let n=this.start(e);return this.executions.set(e.options.toolCallId,n),n}async readAgentViews(){return(getAgentHandleStore(this.agentHandleSession.state)?.handles??[]).flatMap(e=>e.phase===`reserved`?[]:e.phase===`available`?[{availability:`available`,id:e.identity.id,name:e.identity.name}]:e.phase===`claimed`?[{availability:`busy`,id:e.identity.id,name:e.identity.name,taskId:e.ownerId,taskStatus:`working`}]:[])}async commit(e){let t=this.records.filter(e=>!e.settled);return t.length>0&&await this.compensate(t,Error(`Background tool execution did not delegate or complete its task.`)),this.apply(e)}decorate(e){let t=this.resultFields();return t===void 0?e:{...e,...t}}async rollback(e){let t=this.records.filter(e=>e.settled),n=this.records.filter(e=>!e.settled);if(n.length>0&&await this.compensate(n,e),t.length!==0){if(isTurnCancellation(e)){this.retained=!0;return}await this.compensate(t,e)}}retainedResult(){return this.retained?this.resultFields():void 0}apply(e){let t=e;for(let e of this.records)!e.settled||e.task===void 0||(t=recordSessionTask(t,e.task));return this.agentHandlesChanged&&(t=writeHandles(t,getAgentHandleStore(this.agentHandleSession.state)?.handles??[])),t}resultFields(){let e=this.records.flatMap(e=>e.settled&&e.task!==void 0?[e.task]:[]);if(e.length!==0)return{backgroundTaskSession:this.apply(this.initialSession),backgroundTasks:e.map(({taskInboxToken:e,taskId:t,taskRunId:n})=>({taskInboxToken:e,taskId:t,taskRunId:n}))}}async start(t){let i={settled:!1};this.records.push(i);let a=getHarnessEmissionState(this.initialSession.state),o=loadContext(),c=await this.startTask({ctx:o,emission:a,input:t,record:i}),l=c.task;i.task=l;let u=o.get(CallbackBaseUrlKey),d={taskId:l.taskId,token:l.taskInboxToken,...u===void 0?{}:{url:createWorkflowCallbackUrl(u,createEveCallbackRoutePath(l.taskInboxToken))}},f={batch:t.batch.calls,binding:d,delegated:({executor:e,receipt:t})=>createTaskDelegated({binding:d,executor:e,receipt:t}),send:createTaskSender(l,t.options.toolCallId),session:this.initialSession,task:l};if(t.definition.workflowId!==void 0)return i.settled=!0,{...c.receipt,status:`working`,taskId:l.taskId};let p=t.definition.execute(t.toolInput,t.options,f);if(isAsyncIterable(p))throw Error(`Background tools cannot return AsyncIterable output.`);let m=await p;return isAuthorizationSignal(m)?m:isTaskDelegated(m)?(m.executor!==void 0&&(await deliverTaskCommand(l,{executor:m.executor,kind:`bind`}),i.task={...l,executor:m.executor}),i.settled=!0,c.receipt===void 0?m.receipt:{...m.receipt,...c.receipt}):(await deliverTaskCommand(l,{data:parseJsonValue(m),kind:`complete`}),i.settled=!0,m)}async startTask(e){let n=e.input.definition.workflowId===void 0?void 0:{...e.input.definition,workflowId:e.input.definition.workflowId},r=n===void 0?void 0:parseWorkflowToolInput(e.input.toolInput,e.input.definition.name),a=activeTurnId(e.emission),s=n?.resultKind===`subagent`&&r!==void 0?projectSubagentTask({ctx:e.ctx,input:r,name:e.input.definition.name,nodeId:n.nodeId??e.input.definition.name,taskInput:{callId:e.input.options.toolCallId,parentSessionId:this.initialSession.sessionId,parentTurnId:a}}):void 0;if(s!==void 0&&s.identity===void 0&&!hasAgentHandle(this.agentHandleSession,s.metadata.agentId)){let{agentId:t,...i}=r;r=i,s=projectSubagentTask({ctx:e.ctx,input:i,name:e.input.definition.name,nodeId:n.nodeId??e.input.definition.name,taskInput:{callId:e.input.options.toolCallId,parentSessionId:this.initialSession.sessionId,parentTurnId:a}})}let l={callId:e.input.options.toolCallId,metadata:s?.metadata??{kind:`tool`,name:e.input.definition.name},parentSessionId:this.initialSession.sessionId,parentStepIndex:e.emission.stepIndex,parentTurnId:a,session:this.initialSession};if(n===void 0)return{task:await beginBackgroundTask({callId:l.callId,metadata:l.metadata,parentSessionId:l.parentSessionId,parentStepIndex:l.parentStepIndex,parentTurnId:l.parentTurnId,session:l.session})};if(r===void 0)throw Error(`Background workflow tool "${e.input.definition.name}" has no input.`);let u=prepareBackgroundTask(l);if(n.resultKind===`subagent`&&s!==void 0&&s.identity!==void 0){let t=s.identity;if(this.applyAgentHandleCommand({identity:t.identity,callId:l.callId,kind:`reserve`,operationId:t.operation.id,ownerId:u.taskId}).kind!==`ready`)throw Error(`Agent handle store rejected start operation "${t.operation.id}".`);e.record.reservation={agentId:t.identity.id,operationId:t.operation.id}}if(n.resultKind===`subagent`&&s!==void 0&&s.identity===void 0){let t=deriveAgentOperationId({callId:l.callId,parentSessionId:l.parentSessionId,parentTurnId:a}),n=this.applyAgentHandleCommand({agentId:s.metadata.agentId,callId:l.callId,expectedTarget:s.metadata.mode,invokedName:s.metadata.name,kind:`claim`,operationId:t,ownerId:u.taskId});readClaimedHandle(n)?e.record.claim={operationId:t,taskId:u.taskId}:throwAgentClaimError(s.metadata.agentId,n)}await startTaskRun({initialView:{metadata:u.metadata,status:`working`,taskId:u.taskId},parentContinuationToken:sessionCommandHookToken(this.initialSession.sessionId),taskInboxToken:u.taskInboxToken,workflow:{callId:l.callId,executeInput:n.executeInput?.(r),input:r,resultKind:n.resultKind,session:buildCallbackContext().session,stepIndex:e.emission.stepIndex,toolName:e.input.definition.name,workflowId:n.workflowId}});let d=await waitForTaskCommandOwner({taskInboxToken:u.taskInboxToken}),f={...u,executor:IN_PROCESS_WORKFLOW_EXECUTOR,taskRunId:d.runId};return e.record.task=f,n.resultKind!==`subagent`||s===void 0?{task:f}:(s.identity,{receipt:s.receipt,task:f})}applyAgentHandleCommand(e){let t=applyTaskAgentHandleCommand(this.agentHandleSession,e);return t.session!==this.agentHandleSession&&(this.agentHandleSession=t.session,this.agentHandlesChanged=!0),t.result}async compensate(e,t){let n=[];for(let r of e.toReversed()){if(r.task!==void 0)try{await rejectDelegatedDispatch({error:{code:`PARENT_STEP_FAILED`,message:t instanceof Error?t.message:String(t)},task:r.task})}catch(e){n.push(e)}r.claim!==void 0&&this.applyAgentHandleCommand({kind:`release-owner`,ownerId:r.claim.taskId}),r.reservation!==void 0&&r.task!==void 0&&this.applyAgentHandleCommand({agentId:r.reservation.agentId,kind:`remove`,ownerId:r.task.taskId})}if(n.length>0)throw AggregateError([t,...n],`Background tool execution failed and its tasks could not all be rejected.`,{cause:t})}};function hasAgentHandle(e,t){return getAgentHandleStore(e.state)?.handles.some(e=>e.identity.id===t)===!0}function projectSubagentTask(e){let t=e.input.agentId;if(typeof t==`string`&&t.trim()!==``)return{metadata:{agentId:t,kind:`subagent`,mode:readSubagentTaskMode(e.ctx,e.nodeId),name:e.name},receipt:{agentId:t}};let n=createSubagentReceiptIdentity({callId:e.taskInput.callId,nodeId:e.nodeId,parentSessionId:e.taskInput.parentSessionId,parentTurnId:e.taskInput.parentTurnId,subagentName:e.name});return{identity:n,metadata:{agentId:n.identity.id,kind:`subagent`,mode:readSubagentTaskMode(e.ctx,e.nodeId),name:e.name},receipt:{agentId:n.identity.id}}}function readSubagentTaskMode(e,t){let n=getDynamicSubagentSelection(e,t);return n===void 0?(e.get(BundleKey)?.subagentRegistry.subagentsByNodeId.get(t))?.definition.kind===`remote`?`remote`:`local`:n.kind===`remote`?`remote`:`local`}function requireExecutionScope(e){if(!(e instanceof BackgroundToolExecutionScope))throw Error(`The background tool executor is not owned by the task runtime.`);return e}async function deliverTaskCommand(e,t){if(await sendTaskCommand({command:t,taskInboxToken:e.taskInboxToken})!==`delivered`)throw Error(`Task run "${e.taskId}" did not accept "${t.kind}".`)}function createTaskSender(e,t){let n=0;return async r=>{if(r.kind!==`update`){await deliverTaskCommand(e,r);return}if(await sendTaskInboundPayload({payload:{callId:t,kind:`task-update`,message:r.message,updateEpoch:e.taskId,updateIndex:n++},taskInboxToken:e.taskInboxToken})!==`delivered`)throw Error(`Task run "${e.taskId}" did not accept "${r.kind}".`)}}function readClaimedHandle(e){return e.kind===`ready`&&e.handle?.phase===`claimed`}function throwAgentClaimError(e,t){throw t.kind===`mismatch`?Error(JSON.stringify({code:AGENT_MISMATCH,message:`Agent "${e}" no longer matches this subagent definition. Start a new agent instead.`})):t.kind===`busy`?Error(JSON.stringify({code:AGENT_BUSY,message:formatAgentBusyMessage({agentId:e,agentName:t.handle.identity.name,ownerId:`ownerId`in t.handle?t.handle.ownerId:void 0})})):Error(JSON.stringify({code:AGENT_UNREACHABLE,message:`Agent with id "${e}" is no longer reachable.`}))}export{backgroundToolExecutionProvider,readRetainedBackgroundToolResult,runBackgroundStep};
+import{sessionCommandHookToken}from"#execution/session-command-token.js";import{loadContext}from"#context/container.js";import{ActivityObserverKey}from"#context/keys.js";import{parseJsonValue}from"#shared/json.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{parseWorkflowToolInput}from"#execution/tools/workflow/background.js";import{getHarnessEmissionState}from"#harness/emission.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";import{recordSessionTask}from"#tasks/session-index.js";import{runStep}from"#context/run-step.js";import{activeTurnId}from"#harness/active-turn-id.js";import{AGENT_BUSY,AGENT_MISMATCH,AGENT_UNREACHABLE,formatAgentBusyMessage}from"#subagents/agent-handle-errors.js";import{isTurnCancellation}from"#harness/turn-cancellation.js";import{isAuthorizationSignal}from"#harness/authorization.js";import{sendTaskCommand,sendTaskInboundPayload,startTaskRun,waitForTaskCommandOwner}from"#execution/tasks/parent/run-parent.js";import{applyTaskAgentHandleCommand}from"#subagents/handles/transitions.js";import{BackgroundToolExecutorKey}from"#harness/background-tools.js";import{deriveBackgroundTaskActivityObserver}from"#execution/activity-work.js";import{isAsyncIterable}from"#shared/async-iterable.js";import{createTaskMessage,isTaskMessage}from"#tools/task.js";import{beginBackgroundTask,prepareBackgroundTask,rejectDelegatedDispatch}from"#execution/tasks/parent/delegate.js";import{projectSubagentTask}from"#execution/tasks/parent/subagent-task-projection.js";const IN_PROCESS_WORKFLOW_EXECUTOR={data:{},kind:`workflow-task`};function runBackgroundStep(e,t,n){return runStep(e,t,n,[backgroundToolExecutionProvider])}const backgroundToolExecutionProvider={key:BackgroundToolExecutorKey,create(e,t){return{value:new BackgroundToolExecutionScope(t)}},async commit(e,t){return await requireExecutionScope(e).commit(t)},async rollback(e,t){await requireExecutionScope(e).rollback(t)},decorateStepResult(e,t){return requireExecutionScope(e).decorate(t)}};function readRetainedBackgroundToolResult(e){let t=e.get(BackgroundToolExecutorKey);return t instanceof BackgroundToolExecutionScope?t.retainedResult():void 0}var BackgroundToolExecutionScope=class{executions=new Map;records=[];agentHandleSession;agentHandlesChanged=!1;retained=!1;initialSession;constructor(e){this.initialSession=e,this.agentHandleSession=e}execute(e){let t=this.executions.get(e.options.toolCallId);if(t!==void 0)return t;if(!e.batch.calls.some(t=>t.callId===e.options.toolCallId))throw Error(`Background tool call "${e.options.toolCallId}" was not registered before execution.`);let n=this.start(e);return this.executions.set(e.options.toolCallId,n),n}async readAgentViews(){return(getAgentHandleStore(this.agentHandleSession.state)?.handles??[]).flatMap(e=>e.phase===`reserved`?[]:e.phase===`available`?[{availability:`available`,id:e.identity.id,name:e.identity.name}]:e.phase===`claimed`?[{availability:`busy`,id:e.identity.id,name:e.identity.name,taskId:e.ownerId,taskStatus:`working`}]:[])}async commit(e){let t=this.records.filter(e=>!e.settled);return t.length>0&&await this.compensate(t,Error(`Background tool execution did not delegate or complete its task.`)),this.apply(e)}decorate(e){let t=this.resultFields();return t===void 0?e:{...e,...t}}async rollback(e){let t=this.records.filter(e=>e.settled),n=this.records.filter(e=>!e.settled);if(n.length>0&&await this.compensate(n,e),t.length!==0){if(isTurnCancellation(e)){this.retained=!0;return}await this.compensate(t,e)}}retainedResult(){return this.retained?this.resultFields():void 0}apply(e){let t=e;for(let e of this.records)!e.settled||e.task===void 0||(t=recordSessionTask(t,e.task));return this.agentHandlesChanged&&(t=writeHandles(t,getAgentHandleStore(this.agentHandleSession.state)?.handles??[])),t}resultFields(){let e=this.records.flatMap(e=>e.settled&&e.task!==void 0?[e.task]:[]);if(e.length!==0)return{backgroundTaskSession:this.apply(this.initialSession),backgroundTasks:e.map(({taskInboxToken:e,taskId:t,taskRunId:n})=>({taskInboxToken:e,taskId:t,taskRunId:n}))}}async start(e){let n={settled:!1};this.records.push(n);let i=getHarnessEmissionState(this.initialSession.state),a=loadContext(),s=await this.startTask({ctx:a,emission:i,input:e,record:n}),c=s.task;n.task=c;let l={binding:{taskId:c.taskId,token:c.taskInboxToken},postMessage:createTaskMessage,send(){throw Error(`task.send() was replaced by yielded task descriptors.`)},session:this.initialSession,task:c,taskId:c.taskId};if(e.definition.workflowId!==void 0)return n.settled=!0,{...s.receipt,status:`working`,taskId:c.taskId};let u=e.definition.execute(e.toolInput,e.options,l),d=isAsyncIterable(u)?await executeBackgroundIterable({callId:e.options.toolCallId,output:u,task:c}):await u;return isAuthorizationSignal(d)?d:(await deliverTaskCommand(c,{data:parseJsonValue(d),kind:`complete`}),n.settled=!0,{status:`working`,taskId:c.taskId})}async startTask(t){let r=t.input.definition.workflowId===void 0?void 0:{...t.input.definition,workflowId:t.input.definition.workflowId},o=r===void 0?void 0:parseWorkflowToolInput(t.input.toolInput,t.input.definition.name),c=activeTurnId(t.emission),l=r?.resultKind===`subagent`&&o!==void 0?projectSubagentTask({ctx:t.ctx,input:o,name:t.input.definition.name,nodeId:r.nodeId??t.input.definition.name,taskInput:{callId:t.input.options.toolCallId,parentSessionId:this.initialSession.sessionId,parentTurnId:c}}):void 0;if(l!==void 0&&l.identity===void 0&&!hasAgentHandle(this.agentHandleSession,l.metadata.agentId)){let{agentId:e,...n}=o;o=n,l=projectSubagentTask({ctx:t.ctx,input:n,name:t.input.definition.name,nodeId:r.nodeId??t.input.definition.name,taskInput:{callId:t.input.options.toolCallId,parentSessionId:this.initialSession.sessionId,parentTurnId:c}})}let u=l?.metadata??{kind:`tool`,name:t.input.definition.name},d={activityObserver:deriveBackgroundTaskActivityObserver({activityObserver:t.ctx.get(ActivityObserverKey),callId:t.input.options.toolCallId,name:u.name,parentSessionId:this.initialSession.sessionId,parentTurnId:c,rootSessionId:this.initialSession.rootSessionId??this.initialSession.sessionId}),callId:t.input.options.toolCallId,metadata:u,parentSessionId:this.initialSession.sessionId,parentStepIndex:t.emission.stepIndex,parentTurnId:c,session:this.initialSession};if(r===void 0)return{task:await beginBackgroundTask({activityObserver:d.activityObserver,callId:d.callId,metadata:d.metadata,parentSessionId:d.parentSessionId,parentStepIndex:d.parentStepIndex,parentTurnId:d.parentTurnId,session:d.session})};if(o===void 0)throw Error(`Background workflow tool "${t.input.definition.name}" has no input.`);let f=prepareBackgroundTask(d);if(r.resultKind===`subagent`&&l!==void 0&&l.identity!==void 0){let e=l.identity;if(this.applyAgentHandleCommand({identity:e.identity,callId:d.callId,kind:`reserve`,operationId:e.operation.id,ownerId:f.taskId}).kind!==`ready`)throw Error(`Agent handle store rejected start operation "${e.operation.id}".`);t.record.reservation={agentId:e.identity.id,operationId:e.operation.id}}if(r.resultKind===`subagent`&&l!==void 0&&l.identity===void 0){let e=deriveAgentOperationId({callId:d.callId,parentSessionId:d.parentSessionId,parentTurnId:c}),n=this.applyAgentHandleCommand({agentId:l.metadata.agentId,callId:d.callId,expectedTarget:l.metadata.mode,invokedName:l.metadata.name,kind:`claim`,operationId:e,ownerId:f.taskId});readClaimedHandle(n)?t.record.claim={operationId:e,taskId:f.taskId}:throwAgentClaimError(l.metadata.agentId,n)}await startTaskRun({activityObserver:d.activityObserver,initialView:{metadata:f.metadata,status:`working`,taskId:f.taskId},parentContinuationToken:sessionCommandHookToken(this.initialSession.sessionId),taskInboxToken:f.taskInboxToken,workflow:{callId:d.callId,executeInput:r.executeInput?.(o),input:o,resultKind:r.resultKind,session:buildCallbackContext().session,stepIndex:t.emission.stepIndex,toolName:t.input.definition.name,taskId:f.taskId,workflowId:r.workflowId}});let p=await waitForTaskCommandOwner({taskInboxToken:f.taskInboxToken}),m={...f,executor:IN_PROCESS_WORKFLOW_EXECUTOR,taskRunId:p.runId};return t.record.task=m,r.resultKind!==`subagent`||l===void 0?{task:m}:(l.identity,{receipt:l.receipt,task:m})}applyAgentHandleCommand(e){let t=applyTaskAgentHandleCommand(this.agentHandleSession,e);return t.session!==this.agentHandleSession&&(this.agentHandleSession=t.session,this.agentHandlesChanged=!0),t.result}async compensate(e,t){let n=[];for(let r of e.toReversed()){if(r.task!==void 0)try{await rejectDelegatedDispatch({error:{code:`PARENT_STEP_FAILED`,message:t instanceof Error?t.message:String(t)},task:r.task})}catch(e){n.push(e)}r.claim!==void 0&&this.applyAgentHandleCommand({kind:`release-owner`,ownerId:r.claim.taskId}),r.reservation!==void 0&&r.task!==void 0&&this.applyAgentHandleCommand({agentId:r.reservation.agentId,kind:`remove`,ownerId:r.task.taskId})}if(n.length>0)throw AggregateError([t,...n],`Background tool execution failed and its tasks could not all be rejected.`,{cause:t})}};async function executeBackgroundIterable(e){let t=e.output[Symbol.asyncIterator](),n=0,r=await t.next();for(;!r.done;){let i=isTaskMessage(r.value)?{callId:e.callId,kind:`task-message`,message:r.value.message,messageEpoch:e.task.taskId,messageIndex:n++}:{callId:e.callId,kind:`task-update`,message:typeof r.value==`string`?r.value:JSON.stringify(r.value),updateEpoch:e.task.taskId,updateIndex:n++};if(await sendTaskInboundPayload({payload:i,taskInboxToken:e.task.taskInboxToken})!==`delivered`)throw Error(`Task run "${e.task.taskId}" did not accept "${i.kind}".`);r=await t.next()}return r.value??null}function hasAgentHandle(e,t){return getAgentHandleStore(e.state)?.handles.some(e=>e.identity.id===t)===!0}function requireExecutionScope(e){if(!(e instanceof BackgroundToolExecutionScope))throw Error(`The background tool executor is not owned by the task runtime.`);return e}async function deliverTaskCommand(e,t){if(await sendTaskCommand({command:t,taskInboxToken:e.taskInboxToken})!==`delivered`)throw Error(`Task run "${e.taskId}" did not accept "${t.kind}".`)}function readClaimedHandle(e){return e.kind===`ready`&&e.handle?.phase===`claimed`}function throwAgentClaimError(e,t){throw t.kind===`mismatch`?Error(JSON.stringify({code:AGENT_MISMATCH,message:`Agent "${e}" no longer matches this subagent definition. Start a new agent instead.`})):t.kind===`busy`?Error(JSON.stringify({code:AGENT_BUSY,message:formatAgentBusyMessage({agentId:e,agentName:t.handle.identity.name,ownerId:`ownerId`in t.handle?t.handle.ownerId:void 0})})):Error(JSON.stringify({code:AGENT_UNREACHABLE,message:`Agent with id "${e}" is no longer reachable.`}))}export{backgroundToolExecutionProvider,readRetainedBackgroundToolResult,runBackgroundStep};

package/dist/src/execution/terminate-child-sessions-step.js

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{cancelRun,getWorld}from"#internal/workflow/runtime.js";import{deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{resetRemoteAgentSession,resolveRemoteAgentForAction,resolveRemoteAgentStreamHeaders}from"#subagents/remote-dispatch.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{hydrateDurableSession}from"#execution/session.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{cancelOwnedTask}from"#execution/tasks/parent/dispatch.js";import{cancelBackgroundAgentTask}from"#execution/tools/subagent/task-cancel.js";import{getSessionTaskIndex}from"#tasks/session-index.js";const log=createLogger(`execution.terminate-child-sessions`);async function terminateChildSessionsStep(e){"use step";let o;try{o=await readDurableSession(e.sessionState)}catch(n){logError(log,`failed to read child sessions for termination`,n,{parentSessionId:e.sessionState.sessionId});return}let s=readSessionTaskIndex(o.state,o.sessionId),c=getAgentHandleStore(o.state)?.handles??[],l=c.some(e=>`address`in e&&e.address.kind===`agent/remote`),u;if(s.length>0||l){if(e.serializedContext===void 0)throw Error(`Child finalization requires serialized runtime context.`);let t=await deserializeContext(e.serializedContext);u={bundle:t.require(BundleKey),ctx:t}}if(s.length>0){let{bundle:n,ctx:r}=u,i=resolveEffectiveAgentRuntime(n,r),a=hydrateDurableSession({durable:o,turnAgent:i.turnAgent});for(let n of s)try{await cancelOwnedTask({cancelOwnedWork:cancelBackgroundAgentTask,entry:n,serializedContext:e.serializedContext,session:a})}catch(e){logError(log,`failed to cancel task during parent finalization`,e,{parentSessionId:o.sessionId,taskId:n.taskId})}}if(c.length!==0)for(let e of c){if(!(`address`in e)){log.debug(`skipping unaddressed child`,{agentId:e.identity.id,parentSessionId:o.sessionId});continue}try{if(e.address.kind===`agent/remote`)if(e.address.credentialResolver!==void 0){let t=e.address.credentialResolver.resolverId;await resetRemoteAgentSession({headers:t===void 0?{}:await resolveRemoteAgentStreamHeaders({bundle:u.bundle,name:e.identity.name,resolverId:t,url:e.address.url}),remote:{name:e.identity.name,url:e.address.url},sessionId:e.address.sessionId})}else{let t=getDynamicSubagentSelection(u.ctx,e.identity.nodeId),n=resolveRemoteAgentForAction({dynamicRemoteAgent:t?.kind===`remote`?t.remoteAgent:void 0,nodeId:e.identity.nodeId,registry:u.bundle.subagentRegistry.subagentsByNodeId,remoteAgentName:e.identity.name});n.url===e.address.url?await resetRemoteAgentSession({remote:n,sessionId:e.address.sessionId}):await resetRemoteAgentSession({headers:{},remote:{name:e.identity.name,url:e.address.url},sessionId:e.address.sessionId})}else await cancelRun(await getWorld(),e.address.sessionId,{cancelReason:`Parent session ended`})}catch(n){logError(log,`failed to terminate child session`,n,{agentId:e.identity.id,childSessionId:e.address.sessionId,kind:e.address.kind,parentSessionId:o.sessionId})}}}function readSessionTaskIndex(e,n){try{return getSessionTaskIndex(e)}catch(e){return logError(log,`failed to read the task index during parent finalization`,e,{parentSessionId:n}),[]}}export{terminateChildSessionsStep};
+import{createLogger,logError}from"#internal/logging.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{cancelRun,getWorld}from"#internal/workflow/runtime.js";import{deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{resetRemoteAgentSession,resolveRemoteAgentForAction,resolveRemoteAgentStreamHeaders}from"#subagents/remote-dispatch.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{getDynamicSubagentSelection}from"#context/dynamic-subagent-lifecycle.js";import{cancelAllIndexedSessionTasksStep}from"#execution/cancel-indexed-session-tasks-step.js";const log=createLogger(`execution.terminate-child-sessions`);async function terminateChildSessionsStep(e){"use step";let r;try{r=await readDurableSession(e.sessionState)}catch(n){logError(log,`failed to read child sessions for termination`,n,{parentSessionId:e.sessionState.sessionId});return}let i=getAgentHandleStore(r.state)?.handles??[],a=i.some(e=>`address`in e&&e.address.kind===`agent/remote`),o;if(await cancelAllIndexedSessionTasksStep({serializedContext:e.serializedContext,sessionState:e.sessionState}),a){if(e.serializedContext===void 0)throw Error(`Child finalization requires serialized runtime context.`);let t=await deserializeContext(e.serializedContext);o={bundle:t.require(BundleKey),ctx:t}}if(i.length!==0)for(let e of i){if(!(`address`in e)){log.debug(`skipping unaddressed child`,{agentId:e.identity.id,parentSessionId:r.sessionId});continue}try{if(e.address.kind===`agent/remote`)if(e.address.credentialResolver!==void 0){let t=e.address.credentialResolver.resolverId;await resetRemoteAgentSession({headers:t===void 0?{}:await resolveRemoteAgentStreamHeaders({bundle:o.bundle,name:e.identity.name,resolverId:t,url:e.address.url}),remote:{name:e.identity.name,url:e.address.url},sessionId:e.address.sessionId})}else{let t=getDynamicSubagentSelection(o.ctx,e.identity.nodeId),n=resolveRemoteAgentForAction({dynamicRemoteAgent:t?.kind===`remote`?t.remoteAgent:void 0,nodeId:e.identity.nodeId,registry:o.bundle.subagentRegistry.subagentsByNodeId,remoteAgentName:e.identity.name});n.url===e.address.url?await resetRemoteAgentSession({remote:n,sessionId:e.address.sessionId}):await resetRemoteAgentSession({headers:{},remote:{name:e.identity.name,url:e.address.url},sessionId:e.address.sessionId})}else await cancelRun(await getWorld(),e.address.sessionId,{cancelReason:`Parent session ended`})}catch(n){logError(log,`failed to terminate child session`,n,{agentId:e.identity.id,childSessionId:e.address.sessionId,kind:e.address.kind,parentSessionId:r.sessionId})}}}export{terminateChildSessionsStep};

package/dist/src/execution/tools/sleep-workflow.d.ts

@@ -0,0 +1,3 @@
+import type { SleepToolInput, SleepToolOutput } from "#execution/tools/sleep.js";
+/** Waits durably in a workflow dedicated to this tool call. */
+export declare function executeSleepTool(input: SleepToolInput): Promise<SleepToolOutput>;

package/dist/src/execution/tools/sleep-workflow.js

@@ -0,0 +1 @@
+import{sleep}from"#compiled/@workflow/core/index.js";async function executeSleepTool(e){"use workflow";return await sleep(Math.ceil(e.seconds*1e3)),{waitedSeconds:e.seconds}}executeSleepTool.workflowId=`workflow//eve@0.52.0//executeSleepTool`;export{executeSleepTool};

package/dist/src/execution/tools/sleep.d.ts

@@ -1,4 +1,5 @@
 import { z } from "#compiled/zod/index.js";
+export { executeSleepTool } from "#execution/tools/sleep-workflow.js";
 export declare const SLEEP_TOOL_DESCRIPTION = "Wait for a specified amount of time before continuing. Use this when a process or condition needs time to change before it is useful to check its progress or status again.";
 export declare const SLEEP_INPUT_SCHEMA: z.ZodObject<{
     seconds: z.ZodNumber;
@@ -8,8 +9,3 @@ export declare const SLEEP_OUTPUT_SCHEMA: z.ZodObject<{
 }, z.core.$strict>;
 export type SleepToolInput = z.infer<typeof SLEEP_INPUT_SCHEMA>;
 export type SleepToolOutput = z.infer<typeof SLEEP_OUTPUT_SCHEMA>;
-/**
- * Records a durable wait for the owning turn workflow to fulfill after the
- * current atomic step finishes.
- */
-export declare function executeSleepTool(input: SleepToolInput): SleepToolOutput;

package/dist/src/execution/tools/sleep.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{requestTurnSleep}from"#harness/turn-sleep.js";const MAX_SLEEP_SECONDS=Math.floor((2**53-1)/1e3),SLEEP_TOOL_DESCRIPTION=`Wait for a specified amount of time before continuing. Use this when a process or condition needs time to change before it is useful to check its progress or status again.`,SLEEP_INPUT_SCHEMA=z.strictObject({seconds:z.number().positive().max(MAX_SLEEP_SECONDS).describe(`How long to wait, in seconds.`)}),SLEEP_OUTPUT_SCHEMA=z.strictObject({waitedSeconds:z.number().positive()});function executeSleepTool(e){return requestTurnSleep(Math.ceil(e.seconds*1e3)),{waitedSeconds:e.seconds}}export{SLEEP_INPUT_SCHEMA,SLEEP_OUTPUT_SCHEMA,SLEEP_TOOL_DESCRIPTION,executeSleepTool};
+import{z}from"#compiled/zod/index.js";import{executeSleepTool}from"#execution/tools/sleep-workflow.js";const MAX_SLEEP_SECONDS=Math.floor((2**53-1)/1e3),SLEEP_TOOL_DESCRIPTION=`Wait for a specified amount of time before continuing. Use this when a process or condition needs time to change before it is useful to check its progress or status again.`,SLEEP_INPUT_SCHEMA=z.strictObject({seconds:z.number().positive().max(MAX_SLEEP_SECONDS).describe(`How long to wait, in seconds.`)}),SLEEP_OUTPUT_SCHEMA=z.strictObject({waitedSeconds:z.number().positive()});export{SLEEP_INPUT_SCHEMA,SLEEP_OUTPUT_SCHEMA,SLEEP_TOOL_DESCRIPTION,executeSleepTool};

package/dist/src/execution/tools/subagent/accept-event-step.js

@@ -1 +1 @@
-import{readDurableSession}from"#execution/durable-session-store.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{readLatestTaskView}from"#execution/tasks/parent/run-parent.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{isTerminalTaskStatus}from"#tasks/types.js";async function acceptTaskAuthorizationEventStep(t){"use step";let{hookPayload:n,taskId:r}=t.delivery,i=await readDurableSession(t.sessionState),a=findSessionTaskEntry(i.state,r);if(a===void 0)return!1;let o=getAgentHandleStore(i.state)?.handles??[],s=o.find(e=>e.phase===`claimed`&&e.ownerId===r&&e.identity.name===n.subagentName&&e.address.sessionId===n.childSessionId),c=o.filter(e=>e.phase===`reserved`&&e.ownerId===r&&e.identity.name===n.subagentName);if(s===void 0&&c.length!==1)return!1;let l=await readLatestTaskView({taskRunId:a.taskRunId});return l!==void 0&&!isTerminalTaskStatus(l.status)}export{acceptTaskAuthorizationEventStep};
+import{readDurableSession}from"#execution/durable-session-store.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{readLatestTaskView}from"#execution/tasks/parent/run-parent.js";import{isTerminalTaskStatus}from"#tasks/types.js";async function acceptTaskAuthorizationEventStep(t){"use step";let{hookPayload:n,taskId:r}=t.delivery,i=await readDurableSession(t.sessionState),a=findSessionTaskEntry(i.state,r);if(a===void 0)return!1;let o=getAgentHandleStore(i.state)?.handles??[],s=o.find(e=>e.phase===`claimed`&&e.ownerId===r&&e.identity.name===n.subagentName&&e.address.sessionId===n.childSessionId),c=o.filter(e=>e.phase===`reserved`&&e.ownerId===r&&e.identity.name===n.subagentName);if(s===void 0&&c.length!==1)return!1;let l=await readLatestTaskView({taskRunId:a.taskRunId});return l!==void 0&&!isTerminalTaskStatus(l.status)}export{acceptTaskAuthorizationEventStep};

package/dist/src/execution/tools/subagent/invoke-agent.d.ts

@@ -2,6 +2,7 @@ import type { RuntimeActionResultHookPayload, SubagentAuthorizationEventHookPayl
 import type { RuntimeSubagentChildResult, RuntimeSubagentResult } from "#shared/action-types.js";
 import type { JsonValue } from "#shared/json.js";
 import type { JsonObject } from "#shared/json.js";
+import type { AgentInput } from "#tools/workflow-definition.js";
 import type { ToolContext } from "#tools/definition.js";
 import type { TaskInboundUpdate } from "#tasks/types.js";
 export type InternalAgentInput = {
@@ -10,13 +11,6 @@ export type InternalAgentInput = {
     readonly outputSchema?: JsonObject;
     readonly target: string;
 };
-export interface AgentInput {
-    readonly agentId?: string;
-    readonly key: string;
-    readonly message: string;
-    readonly outputSchema?: JsonObject;
-    readonly target: string;
-}
 /**
  * Asks the owning session to spawn an agent for a workflow tool run. Spawning
  * needs owner-held material (auth, capabilities, admission, the agent handle

package/dist/src/execution/tools/subagent/invoke-agent.js

@@ -1 +1 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook}from"#execution/hook-ownership.js";import{readWorkflowToolRunAdmission,readWorkflowToolRunOwner,readWorkflowToolRunRef}from"#execution/tools/workflow/ask.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";const AGENT_INVOCATION_IDS=Symbol.for(`eve.workflow-tool-run.agent-invocation-ids`);async function agent(e,t){return validateAgentInput(t,!0),await invokeAgent(e,{agentId:t.agentId,message:t.message,outputSchema:t.outputSchema,target:t.target},{invocationId:`${e.callId}:${t.key}`})}async function invokeAgent(i,a,o){validateAgentInput(a,!1);let s=readWorkflowToolRunRef(i),c=readWorkflowToolRunOwner(i),l=readWorkflowToolRunAdmission(i);claimInvocationId(i,o.invocationId);let u=createHook(),d=!1;try{if(await claimHookOwnership(u),d=!0,l!==void 0){let e=await l;if(e.status===`rejected`)throw Error(e.reason)}await resumeHookStep(c.request,{from:s,replyTo:u.token,request:{input:a,invocationId:o.invocationId,kind:`agent-invoke`}});let e=u[Symbol.asyncIterator]();for(;;){let t=await nextAgentReply(e,i.abortSignal);if(t.done)break;let n=t.value;if(n.kind===`runtime-action-result`){let e=n.results.find(e=>e.kind===`subagent-result`&&e.callId===o.invocationId);if(e!==void 0){if(e.origin===`child`&&await resumeHookStep(c.request,{from:s,replyTo:u.token,request:{kind:`agent-settled`,result:e}}),o.returnResult===!0&&s.execution===`blocking`)return e;if(e.isError===!0)throw e.output;return e.output}continue}if(n.kind===`subagent-input-request`){await resumeHookStep(c.request,{from:s,replyTo:n.childContinuationToken,request:{kind:`input-batch`,requests:n.event.requests},requestCoordinates:{sequence:n.event.sequence,stepIndex:n.event.stepIndex,turnId:n.event.turnId}});continue}if(n.kind===`task-update`){await resumeHookStep(c.report,{from:s,update:n.message});continue}await resumeHookStep(c.request,{from:s,replyTo:u.token,request:{event:n,kind:`authorization-request`}})}}finally{if(d)try{await disposeHook(u)}catch{}}throw Error(`Agent "${a.target}" closed without a result.`)}async function nextAgentReply(e,t){if(t===void 0)return await e.next();if(t.aborted)throw t.reason;let n,r=new Promise((e,t)=>{n=t}),abort=()=>n?.(t.reason);t.addEventListener(`abort`,abort,{once:!0});try{return await Promise.race([e.next(),r])}finally{t.removeEventListener(`abort`,abort)}}function validateAgentInput(e,t){if(t&&(typeof e.key!=`string`||e.key.trim()===``))throw TypeError("agent() requires a non-empty `key`.");if(typeof e.target!=`string`||e.target.trim()===``)throw TypeError("agent() requires a non-empty `target`.");if(typeof e.message!=`string`||e.message.trim()===``)throw TypeError("agent() requires a non-empty `message`.")}function claimInvocationId(e,t){let n=e,r=n[AGENT_INVOCATION_IDS]??new Set;if(r.has(t)){let e=t.lastIndexOf(`:`),n=e<0?t:t.slice(e+1);throw TypeError(`agent() invocation key "${n}" was already used in this run; keys must be unique per run.`)}r.add(t),n[AGENT_INVOCATION_IDS]===void 0&&Object.defineProperty(n,AGENT_INVOCATION_IDS,{enumerable:!1,value:r})}export{agent,invokeAgent,validateAgentInput};
+import{createHook}from"#compiled/@workflow/core/index.js";import{disposeHook}from"#execution/hook-ownership.js";import{readWorkflowToolRunAdmission,readWorkflowToolRunOwner,readWorkflowToolRunRef}from"#execution/tools/workflow/ask.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";const AGENT_INVOCATION_IDS=Symbol.for(`eve.workflow-tool-run.agent-invocation-ids`);async function agent(e,t){return validateAgentInput(t,!0),readWorkflowToolRunRef(e),await invokeAgent(e,{agentId:t.agentId,message:t.message,outputSchema:t.outputSchema,target:t.target},{invocationId:`${e.callId}:${t.key}`})}async function invokeAgent(i,a,o){validateAgentInput(a,!1);let s=readWorkflowToolRunRef(i),c=readWorkflowToolRunOwner(i),l=readWorkflowToolRunAdmission(i);if(claimInvocationId(i,o.invocationId),l!==void 0){let e=await l;if(e.status===`rejected`)throw Error(e.reason)}let u=createHook();try{await resumeHookStep(c.inbox,{kind:`request`,from:s,replyTo:u.token,request:{input:a,invocationId:o.invocationId,kind:`agent-invoke`}});let e=u[Symbol.asyncIterator]();for(;;){let t=await nextAgentReply(e,i.abortSignal);if(t.done)break;let n=t.value;if(n.kind===`runtime-action-result`){let e=n.results.find(e=>e.kind===`subagent-result`&&e.callId===o.invocationId);if(e!==void 0){if(e.origin===`child`&&await resumeHookStep(c.inbox,{kind:`request`,from:s,replyTo:u.token,request:{kind:`agent-settled`,result:e}}),o.returnResult===!0&&s.execution===`blocking`)return e;if(e.isError===!0)throw e.output;return e.output}continue}if(n.kind===`subagent-input-request`){await resumeHookStep(c.inbox,{kind:`request`,from:s,replyTo:n.childContinuationToken,request:{kind:`input-batch`,requests:n.event.requests},requestCoordinates:{sequence:n.event.sequence,stepIndex:n.event.stepIndex,turnId:n.event.turnId}});continue}if(n.kind===`task-update`){await resumeHookStep(c.inbox,{kind:`report`,from:s,update:n.message});continue}await resumeHookStep(c.inbox,{kind:`request`,from:s,replyTo:u.token,request:{event:n,kind:`authorization-request`}})}}finally{try{await disposeHook(u)}catch{}}throw Error(`Agent "${a.target}" closed without a result.`)}async function nextAgentReply(e,t){if(t===void 0)return await e.next();if(t.aborted)throw t.reason;let n,r=new Promise((e,t)=>{n=t}),abort=()=>n?.(t.reason);t.addEventListener(`abort`,abort,{once:!0});try{return await Promise.race([e.next(),r])}finally{t.removeEventListener(`abort`,abort)}}function validateAgentInput(e,t){if(t&&(typeof e.key!=`string`||e.key.trim()===``))throw TypeError("agent() requires a non-empty `key`.");if(typeof e.target!=`string`||e.target.trim()===``)throw TypeError("agent() requires a non-empty `target`.");if(typeof e.message!=`string`||e.message.trim()===``)throw TypeError("agent() requires a non-empty `message`.")}function claimInvocationId(e,t){let n=e,r=n[AGENT_INVOCATION_IDS]??new Set;if(r.has(t)){let e=t.lastIndexOf(`:`),n=e<0?t:t.slice(e+1);throw TypeError(`agent() invocation key "${n}" was already used in this run; keys must be unique per run.`)}r.add(t),n[AGENT_INVOCATION_IDS]===void 0&&Object.defineProperty(n,AGENT_INVOCATION_IDS,{enumerable:!1,value:r})}export{agent,invokeAgent,validateAgentInput};

package/dist/src/execution/tools/subagent/invoke-step.js

@@ -1 +1 @@
-import{createSubagentCalledEvent}from"#protocol/message.js";import{workflowEntryReference}from"#execution/workflow-runtime.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";import{projectToDurableSession}from"#execution/session.js";import{AGENT_BUSY,AGENT_MISMATCH,AGENT_UNREACHABLE,formatAgentBusyMessage}from"#subagents/agent-handle-errors.js";import{clearProxyInputRequestsForChild,clearProxyInputRequestsForTask}from"#harness/proxy-input-requests.js";import{readLatestTaskView}from"#execution/tasks/parent/run-parent.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{abandonAgentInvocationOwners,applyTaskAgentHandleCommand}from"#subagents/handles/transitions.js";import{accumulateSessionUsage,getTurnUsageState,setTurnUsageState}from"#harness/turn-tag-state.js";import{isTerminalTaskStatus}from"#tasks/types.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{createSubagentReceiptIdentity}from"#execution/tools/subagent/receipt-identity.js";import{createAgentErrorResult,dispatchToClaimedAgentAddress}from"#subagents/handle-dispatch.js";import{createAgentContinuationBundle}from"#subagents/continuation-bundle.js";import{startSubagent}from"#execution/tools/subagent/start.js";import{prepareOwnerAgentInvocation}from"#execution/tools/subagent/invoke-preparation.js";async function dispatchAgentInvocation(n){let a=getAgentHandleStore((await readDurableSession(n.sessionState)).state)?.handles??[],s=await prepareOwnerAgentInvocation({invocation:n.request.input,invocationId:n.request.invocationId,knownAgentIds:a.map(e=>e.identity.id),serializedContext:n.serializedContext,sessionState:n.sessionState}),c=s.plan[0];if(c===void 0)throw Error(`Agent invocation produced no executable plan entry.`);let l=s.session,currentAgentHandles=()=>getAgentHandleStore(l.state)?.handles??[],sessionState=()=>replaceDurableSessionSnapshot({session:projectToDurableSession(l),state:n.sessionState}),applyHandleCommand=e=>{let t=applyTaskAgentHandleCommand(l,e);return l=t.session,t.result};if(c.kind===`reject`)return{kind:`failed`,result:c.result,sessionState:sessionState()};let u,d;if(c.kind===`resume`){let e=currentAgentHandles().filter(e=>e.phase===`claimed`&&e.ownerId===n.ownerId&&e.callId===c.action.callId&&e.identity.id===c.agentId);if(e.length>1)throw Error(`Invocation owner "${n.ownerId}" has multiple claims for "${c.action.callId}".`);let t=e[0];if(t===void 0){let e=deriveAgentOperationId({callId:c.action.callId,parentSessionId:s.session.sessionId,parentTurnId:s.batch.event.turnId}),i=applyHandleCommand({agentId:c.agentId,callId:c.action.callId,expectedTarget:c.action.kind===`remote-agent-call`?`remote`:`local`,invokedName:c.action.kind===`remote-agent-call`?c.action.remoteAgentName:c.action.subagentName,kind:`claim`,operationId:e,ownerId:n.ownerId});if(t=readClaimedHandle(i),t===void 0)return{kind:`failed`,result:createTaskClaimError(c.action,c.agentId,i),sessionState:sessionState()}}let i=createAgentContinuationBundle({action:c.action,bundle:s.bundle,dynamicRemoteAgent:c.dynamicRemoteAgent});u=await dispatchToClaimedAgentAddress({action:c.action,auth:s.auth,bundle:i,currentSession:l,parentToken:n.replyTo,handle:t,taskId:n.taskId}),u.kind===`error`&&u.deliveryPermanent===!0&&applyHandleCommand({agentId:c.agentId,kind:`remove`,ownerId:n.ownerId}),d=t.identity.id}else{let e=c.target.action,t=currentAgentHandles().filter(t=>t.phase===`reserved`&&t.ownerId===n.ownerId&&t.callId===e.callId&&t.identity.name===e.name&&t.identity.nodeId===e.nodeId),r=t.length===1?{identity:t[0].identity,operation:{id:t[0].operationId}}:createSubagentReceiptIdentity({callId:e.callId,subagentName:e.kind===`remote-agent-call`?e.remoteAgentName:e.subagentName,nodeId:e.nodeId,parentSessionId:s.session.sessionId,parentTurnId:s.batch.event.turnId});if(t.length>1)throw Error(`Invocation owner "${n.ownerId}" has multiple reservations for "${e.callId}".`);if(t.length===0&&applyHandleCommand({identity:r.identity,callId:e.callId,kind:`reserve`,operationId:r.operation.id,ownerId:n.ownerId}).kind!==`ready`)throw Error(`Agent handle store rejected start operation "${r.operation.id}".`);if(u=await startSubagent({auth:s.auth,batchEvent:s.batch.event,bundle:s.bundle,callbackBaseUrl:n.callbackBaseUrl,capabilities:s.capabilities,channelMetadata:s.channelMetadata,currentSession:l,fanoutSize:s.fanoutSize,initiatorAuth:s.initiatorAuth,localDevRequest:s.localDevRequest,parentContinuationToken:n.replyTo,parentTraceContext:s.parentTraceContext,sandboxSessionId:s.sandboxSessionId,serializedContext:s.serializedContext,session:l,taskId:n.taskId,target:c.target}),d=r.identity.id,u.kind===`error`)applyHandleCommand({agentId:d,kind:`remove`,ownerId:n.ownerId});else if(readClaimedHandle(applyHandleCommand({address:u.address,kind:`confirm`,operationId:r.operation.id,ownerId:n.ownerId}))===void 0)throw Error(`Agent handle store could not confirm start operation "${r.operation.id}".`)}if(u.kind===`error`)return{kind:`failed`,result:u.result,sessionState:sessionState()};let f=c.kind===`resume`?c.action:c.target.action,p=c.kind===`resume`?c.dynamicRemoteAgent:c.target.kind===`remote`?c.target.dynamicRemoteAgent:void 0,m=createSubagentCalledEvent({agentId:d,callId:u.callId,childSessionId:u.address.sessionId,name:u.name,remote:u.address.kind===`agent/remote`?{resolverId:p===void 0?f.nodeId:p.credentialsStepId,url:u.address.url}:void 0,sequence:s.batch.event.sequence,sessionId:s.session.sessionId,toolName:u.toolName,turnId:s.batch.event.turnId,workflowId:workflowEntryReference.workflowId});return n.emit!==void 0&&await n.emit(m),{kind:`dispatched`,agentId:d,event:m,sessionState:sessionState()}}async function dispatchTaskAgentInvocationStep(e){"use step";if(e.taskId!==void 0){let t=findSessionTaskEntry((await readDurableSession(e.sessionState)).state,e.taskId);if(t===void 0)return{kind:`not-admitted`,sessionState:e.sessionState};let n=await readLatestTaskView({taskRunId:t.taskRunId});if(n===void 0||isTerminalTaskStatus(n.status))return{kind:`not-admitted`,sessionState:e.sessionState}}return await dispatchAgentInvocation({...e,callbackBaseUrl:resolveWorkflowCallbackBaseUrl(getWorkflowMetadata().url)})}async function settleTaskAgentInvocationStep(e){"use step";let t=await readDurableSession(e.sessionState),n=getAgentHandleStore(t.state)?.handles??[],r=n.filter(t=>t.phase===`claimed`&&t.ownerId===e.ownerId),o=r.find(t=>t.phase===`claimed`&&t.callId===e.result.callId)??(r.length===1?r[0]:void 0);if(o?.phase!==`claimed`)return{sessionState:e.sessionState};let s=writeHandles(t,e.result.outcome.kind===`terminal`?n.filter(e=>e!==o):n.map(t=>t===o?e.result.outcome.result.kind===`cancelled`?{address:o.address,identity:o.identity,lastStatus:`(cancelled)`,phase:`parked`}:{address:o.address,identity:o.identity,phase:`available`}:t));return e.result.outcome.kind===`terminal`&&(s=e.taskId===void 0?`continuationToken`in o.address?clearProxyInputRequestsForChild(s,o.address.continuationToken):s:clearProxyInputRequestsForTask(s,e.taskId)),e.accumulateUsage!==!1&&(s=setTurnUsageState(s,accumulateSessionUsage({previous:getTurnUsageState(s.state),usage:e.result.outcome.usageDelta}))),{sessionState:replaceDurableSessionSnapshot({session:s,state:e.sessionState})}}async function releaseAgentInvocationOwnerStep(e){"use step";let t=await readDurableSession(e.sessionState),n=e.cancelled?abandonAgentInvocationOwners(t,new Set([e.ownerId])):applyTaskAgentHandleCommand(t,{kind:`release-owner`,ownerId:e.ownerId}).session;return{sessionState:n===t?e.sessionState:replaceDurableSessionSnapshot({session:n,state:e.sessionState})}}function readClaimedHandle(e){let t=e.kind===`ready`?e.handle:void 0;return t?.phase===`claimed`?t:void 0}function createTaskClaimError(e,t,n){return n.kind===`mismatch`?createAgentErrorResult({action:e,code:AGENT_MISMATCH,message:`Agent "${t}" no longer matches this subagent definition. Start a new agent instead.`}):n.kind===`busy`?createAgentErrorResult({action:e,code:AGENT_BUSY,message:formatAgentBusyMessage({agentId:t,agentName:n.handle.identity.name,ownerId:`ownerId`in n.handle?n.handle.ownerId:void 0})}):createAgentErrorResult({action:e,code:AGENT_UNREACHABLE,message:`Agent with id "${t}" is no longer reachable.`})}export{dispatchAgentInvocation,dispatchTaskAgentInvocationStep,releaseAgentInvocationOwnerStep,settleTaskAgentInvocationStep};
+import{createSubagentCalledEvent}from"#protocol/message.js";import{workflowEntryReference}from"#execution/workflow-runtime.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{getAgentHandleStore,writeHandles}from"#subagents/handles/store.js";import{projectToDurableSession}from"#execution/session.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{AGENT_BUSY,AGENT_MISMATCH,AGENT_UNREACHABLE,formatAgentBusyMessage}from"#subagents/agent-handle-errors.js";import{clearProxyInputRequestsForChild,clearProxyInputRequestsForTask}from"#harness/proxy-input-requests.js";import{readLatestTaskView}from"#execution/tasks/parent/run-parent.js";import{abandonAgentInvocationOwners,applyTaskAgentHandleCommand}from"#subagents/handles/transitions.js";import{accumulateSessionUsage,getTurnUsageState,setTurnUsageState}from"#harness/turn-tag-state.js";import{isTerminalTaskStatus}from"#tasks/types.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{createSubagentReceiptIdentity}from"#execution/tools/subagent/receipt-identity.js";import{createAgentErrorResult,dispatchToClaimedAgentAddress}from"#subagents/handle-dispatch.js";import{createAgentContinuationBundle}from"#subagents/continuation-bundle.js";import{startSubagent}from"#execution/tools/subagent/start.js";import{prepareOwnerAgentInvocation}from"#execution/tools/subagent/invoke-preparation.js";async function dispatchAgentInvocation(n){let a=getAgentHandleStore((await readDurableSession(n.sessionState)).state)?.handles??[],s=await prepareOwnerAgentInvocation({invocation:n.request.input,invocationId:n.request.invocationId,knownAgentIds:a.map(e=>e.identity.id),serializedContext:n.serializedContext,sessionState:n.sessionState}),c=s.plan[0];if(c===void 0)throw Error(`Agent invocation produced no executable plan entry.`);let l=s.session,currentAgentHandles=()=>getAgentHandleStore(l.state)?.handles??[],sessionState=()=>replaceDurableSessionSnapshot({session:projectToDurableSession(l),state:n.sessionState}),applyHandleCommand=e=>{let t=applyTaskAgentHandleCommand(l,e);return l=t.session,t.result};if(c.kind===`reject`)return{kind:`failed`,result:c.result,sessionState:sessionState()};let u,d;if(c.kind===`resume`){let e=currentAgentHandles().filter(e=>e.phase===`claimed`&&e.ownerId===n.ownerId&&e.callId===c.action.callId&&e.identity.id===c.agentId);if(e.length>1)throw Error(`Invocation owner "${n.ownerId}" has multiple claims for "${c.action.callId}".`);let t=e[0];if(t===void 0){let e=deriveAgentOperationId({callId:c.action.callId,parentSessionId:s.session.sessionId,parentTurnId:s.batch.event.turnId}),i=applyHandleCommand({agentId:c.agentId,callId:c.action.callId,expectedTarget:c.action.kind===`remote-agent-call`?`remote`:`local`,invokedName:c.action.kind===`remote-agent-call`?c.action.remoteAgentName:c.action.subagentName,kind:`claim`,operationId:e,ownerId:n.ownerId});if(t=readClaimedHandle(i),t===void 0)return{kind:`failed`,result:createTaskClaimError(c.action,c.agentId,i),sessionState:sessionState()}}let i=createAgentContinuationBundle({action:c.action,bundle:s.bundle,dynamicRemoteAgent:c.dynamicRemoteAgent});u=await dispatchToClaimedAgentAddress({action:c.action,auth:s.auth,bundle:i,currentSession:l,parentToken:n.replyTo,handle:t,taskId:n.taskId}),u.kind===`error`&&u.deliveryPermanent===!0&&applyHandleCommand({agentId:c.agentId,kind:`remove`,ownerId:n.ownerId}),d=t.identity.id}else{let e=c.target.action,t=currentAgentHandles().filter(t=>t.phase===`reserved`&&t.ownerId===n.ownerId&&t.callId===e.callId&&t.identity.name===e.name&&t.identity.nodeId===e.nodeId),r=t.length===1?{identity:t[0].identity,operation:{id:t[0].operationId}}:createSubagentReceiptIdentity({callId:e.callId,subagentName:e.kind===`remote-agent-call`?e.remoteAgentName:e.subagentName,nodeId:e.nodeId,parentSessionId:s.session.sessionId,parentTurnId:s.batch.event.turnId});if(t.length>1)throw Error(`Invocation owner "${n.ownerId}" has multiple reservations for "${e.callId}".`);if(t.length===0&&applyHandleCommand({identity:r.identity,callId:e.callId,kind:`reserve`,operationId:r.operation.id,ownerId:n.ownerId}).kind!==`ready`)throw Error(`Agent handle store rejected start operation "${r.operation.id}".`);if(u=await startSubagent({auth:s.auth,batchEvent:s.batch.event,bundle:s.bundle,callbackBaseUrl:n.callbackBaseUrl,capabilities:s.capabilities,channelMetadata:s.channelMetadata,currentSession:l,fanoutSize:s.fanoutSize,initiatorAuth:s.initiatorAuth,localDevRequest:s.localDevRequest,parentContinuationToken:n.replyTo,parentTraceContext:s.parentTraceContext,sandboxSessionId:s.sandboxSessionId,serializedContext:s.serializedContext,session:l,taskId:n.taskId,target:c.target}),d=r.identity.id,u.kind===`error`)applyHandleCommand({agentId:d,kind:`remove`,ownerId:n.ownerId});else if(readClaimedHandle(applyHandleCommand({address:u.address,kind:`confirm`,operationId:r.operation.id,ownerId:n.ownerId}))===void 0)throw Error(`Agent handle store could not confirm start operation "${r.operation.id}".`)}if(u.kind===`error`)return{kind:`failed`,result:u.result,sessionState:sessionState()};let f=c.kind===`resume`?c.action:c.target.action,p=c.kind===`resume`?c.dynamicRemoteAgent:c.target.kind===`remote`?c.target.dynamicRemoteAgent:void 0,m=createSubagentCalledEvent({agentId:d,callId:u.callId,childSessionId:u.address.sessionId,name:u.name,remote:u.address.kind===`agent/remote`?{resolverId:p===void 0?f.nodeId:p.credentialsStepId,url:u.address.url}:void 0,sequence:s.batch.event.sequence,sessionId:s.session.sessionId,toolName:u.toolName,turnId:s.batch.event.turnId,workflowId:workflowEntryReference.workflowId});return n.emit!==void 0&&await n.emit(m),{kind:`dispatched`,agentId:d,event:m,sessionState:sessionState()}}async function dispatchTaskAgentInvocationStep(e){"use step";if(e.taskId!==void 0){let t=findSessionTaskEntry((await readDurableSession(e.sessionState)).state,e.taskId);if(t===void 0)return{kind:`not-admitted`,sessionState:e.sessionState};let n=await readLatestTaskView({taskRunId:t.taskRunId});if(n===void 0||isTerminalTaskStatus(n.status))return{kind:`not-admitted`,sessionState:e.sessionState}}return await dispatchAgentInvocation({...e,callbackBaseUrl:resolveWorkflowCallbackBaseUrl(getWorkflowMetadata().url)})}async function settleTaskAgentInvocationStep(e){"use step";let t=await readDurableSession(e.sessionState),n=getAgentHandleStore(t.state)?.handles??[],r=n.filter(t=>t.phase===`claimed`&&t.ownerId===e.ownerId),o=r.find(t=>t.phase===`claimed`&&t.callId===e.result.callId)??(r.length===1?r[0]:void 0);if(o?.phase!==`claimed`)return{sessionState:e.sessionState};let s=writeHandles(t,e.result.outcome.kind===`terminal`?n.filter(e=>e!==o):n.map(t=>t===o?e.result.outcome.result.kind===`cancelled`?{address:o.address,identity:o.identity,lastStatus:`(cancelled)`,phase:`parked`}:{address:o.address,identity:o.identity,phase:`available`}:t));return e.result.outcome.kind===`terminal`&&(s=e.taskId===void 0?`continuationToken`in o.address?clearProxyInputRequestsForChild(s,o.address.continuationToken):s:clearProxyInputRequestsForTask(s,e.taskId)),e.accumulateUsage!==!1&&(s=setTurnUsageState(s,accumulateSessionUsage({previous:getTurnUsageState(s.state),usage:e.result.outcome.usageDelta}))),{sessionState:replaceDurableSessionSnapshot({session:s,state:e.sessionState})}}async function releaseAgentInvocationOwnerStep(e){"use step";let t=await readDurableSession(e.sessionState),n=e.cancelled?abandonAgentInvocationOwners(t,new Set([e.ownerId])):applyTaskAgentHandleCommand(t,{kind:`release-owner`,ownerId:e.ownerId}).session;return{sessionState:n===t?e.sessionState:replaceDurableSessionSnapshot({session:n,state:e.sessionState})}}function readClaimedHandle(e){let t=e.kind===`ready`?e.handle:void 0;return t?.phase===`claimed`?t:void 0}function createTaskClaimError(e,t,n){return n.kind===`mismatch`?createAgentErrorResult({action:e,code:AGENT_MISMATCH,message:`Agent "${t}" no longer matches this subagent definition. Start a new agent instead.`}):n.kind===`busy`?createAgentErrorResult({action:e,code:AGENT_BUSY,message:formatAgentBusyMessage({agentId:t,agentName:n.handle.identity.name,ownerId:`ownerId`in n.handle?n.handle.ownerId:void 0})}):createAgentErrorResult({action:e,code:AGENT_UNREACHABLE,message:`Agent with id "${t}" is no longer reachable.`})}export{dispatchAgentInvocation,dispatchTaskAgentInvocationStep,releaseAgentInvocationOwnerStep,settleTaskAgentInvocationStep};

package/dist/src/execution/tools/workflow/ask.d.ts

@@ -9,11 +9,10 @@ interface WorkflowToolRunContext {
         readonly status: "rejected";
         readonly reason: string;
     }>;
-    answerSeq: number;
     readonly from: WorkflowToolRunRef;
     readonly owner: WorkflowToolRunOwner;
 }
-export declare function attachWorkflowToolRunContext(ctx: ToolContext, context: Omit<WorkflowToolRunContext, "answerSeq">): void;
+export declare function attachWorkflowToolRunContext(ctx: ToolContext, context: WorkflowToolRunContext): void;
 export declare function readWorkflowToolRunRef(ctx: ToolContext): WorkflowToolRunRef;
 export declare function readWorkflowToolRunOwner(ctx: ToolContext): WorkflowToolRunOwner;
 export declare function readWorkflowToolRunAdmission(ctx: ToolContext): WorkflowToolRunContext["admission"];

package/dist/src/execution/tools/workflow/ask.js

@@ -1 +1 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{workflowToolRunAnswerToken}from"#harness/workflow-tool-runs.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";const WORKFLOW_TOOL_RUN_CONTEXT=Symbol.for(`eve.workflow-tool-run.context`);function attachWorkflowToolRunContext(e,t){Object.defineProperty(e,WORKFLOW_TOOL_RUN_CONTEXT,{enumerable:!1,value:{...t,answerSeq:0}})}function readWorkflowToolRunContext(e){let t=e[WORKFLOW_TOOL_RUN_CONTEXT];if(t===void 0)throw Error(`This function must be called with the context of a workflow tool body ("use workflow").`);return t}function readWorkflowToolRunRef(e){return readWorkflowToolRunContext(e).from}function readWorkflowToolRunOwner(e){return readWorkflowToolRunContext(e).owner}function readWorkflowToolRunAdmission(e){return readWorkflowToolRunContext(e).admission}function ask(n,r){let i=readWorkflowToolRunContext(n),a=createHook({token:workflowToolRunAnswerToken(i.from.runId,i.answerSeq++)});return resumeHookStep(i.owner.request,{from:i.from,replyTo:a.token,request:{kind:`ask`,request:r}}),a}export{ask,attachWorkflowToolRunContext,readWorkflowToolRunAdmission,readWorkflowToolRunOwner,readWorkflowToolRunRef};
+import{workflowToolContextErrorMessage}from"#shared/workflow-tool-context.js";import{createHook}from"#compiled/@workflow/core/index.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";const WORKFLOW_TOOL_RUN_CONTEXT=Symbol.for(`eve.workflow-tool-run.context`);function attachWorkflowToolRunContext(e,t){Object.defineProperty(e,WORKFLOW_TOOL_RUN_CONTEXT,{enumerable:!1,value:t})}function readWorkflowToolRunContext(t,n){let i=t?.[WORKFLOW_TOOL_RUN_CONTEXT];if(i===void 0)throw Error(workflowToolContextErrorMessage(n));return i}function readWorkflowToolRunRef(e){return readWorkflowToolRunContext(e,`agent`).from}function readWorkflowToolRunOwner(e){return readWorkflowToolRunContext(e,`agent`).owner}function readWorkflowToolRunAdmission(e){return readWorkflowToolRunContext(e,`agent`).admission}function ask(e,r){let i=readWorkflowToolRunContext(e,`ask`),a=createHook();return resumeHookStep(i.owner.inbox,{kind:`request`,from:i.from,replyTo:a.token,request:{kind:`ask`,request:r}}),a}export{ask,attachWorkflowToolRunContext,readWorkflowToolRunAdmission,readWorkflowToolRunOwner,readWorkflowToolRunRef};

package/dist/src/execution/tools/workflow/body.d.ts

@@ -8,17 +8,22 @@ export interface WorkflowBodyDefinition {
     readonly resultKind?: "subagent" | "tool";
     readonly session: SessionContext["session"];
     readonly stepIndex: number;
+    readonly taskId?: string;
     readonly toolName: string;
     readonly workflowId: string;
 }
 export interface WorkflowBodyInput extends WorkflowBodyDefinition {
     readonly owner: WorkflowToolRunOwner;
 }
+export interface WorkflowBodyResult {
+    readonly outcome: WorkflowToolRunOutcome;
+    readonly reportCount: number;
+}
 /** Executes one registered workflow body and reports progress to its owner. */
 export declare function executeWorkflowBody(input: WorkflowBodyInput & {
     readonly execution: "background" | "blocking";
     readonly runId?: string;
-}, signal: AbortSignal): Promise<WorkflowToolRunOutcome>;
+}, signal: AbortSignal): Promise<WorkflowBodyResult>;
 export declare function createWorkflowBodyRef(input: WorkflowBodyDefinition & {
     readonly execution: "background" | "blocking";
     readonly runId?: string;

package/dist/src/execution/tools/workflow/body.js

@@ -1 +1 @@
-import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import"#execution/tools/workflow/messages.js";import{attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";async function executeWorkflowBody(e,i){let a=createWorkflowBodyRef(e),o=createWorkflowBodyContext(e,i);attachWorkflowToolRunContext(o,{from:a,owner:e.owner});try{let t=resolveWorkflowToolExecute(e)(e.executeInput??e.input,o),r;if(!isAsyncIterable(t))r=await t;else{let i=t[Symbol.asyncIterator](),o,s=await i.next();for(;s.done!==!0;){o=s.value;let t={from:a,update:s.value};await resumeHookStep(e.owner.report,t),s=await i.next()}r=s.value??o??null}return{output:r,status:`completed`}}catch(e){return i.aborted?{reason:i.reason instanceof Error?i.reason.message:String(i.reason??``),status:`cancelled`}:{error:normalizeSerializableError(e),status:`failed`}}}function createWorkflowBodyRef(t){return{callId:t.callId,execution:t.execution,input:t.input,resultKind:t.resultKind,runId:t.runId??getWorkflowMetadata().workflowRunId,sequence:t.session.turn.sequence,stepIndex:t.stepIndex,toolName:t.toolName,turnId:t.session.turn.id}}function resolveWorkflowToolExecute(e){let t=readRegisteredWorkflow(e.workflowId);if(typeof t!=`function`)throw Error(`Tool "${e.toolName}" is not registered as a workflow in this deployment (${e.workflowId}). The tool was renamed or removed after this run started.`);return t}function createWorkflowBodyContext(e,t){let unavailable=(t,n)=>{throw Error(`ctx.${t} is not available inside a workflow tool; ${n}. Tool "${e.toolName}" runs as a durable workflow body, which only replays deterministic code.`)};return{abortSignal:t,callId:e.callId,getSandbox:()=>unavailable(`getSandbox()`,`the session sandbox belongs to the turn`),getSkill:()=>unavailable(`getSkill()`,`skills are read through the session sandbox`),getToken:()=>unavailable(`getToken()`,`read credentials from the environment inside a "use step" helper`),requireAuth:()=>unavailable(`requireAuth()`,`a workflow body cannot park on authorization`),session:e.session,toolName:e.toolName}}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}export{createWorkflowBodyRef,executeWorkflowBody};
+import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{createTaskMessage}from"#tools/task.js";import{ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";import{agent}from"#execution/tools/subagent/invoke-agent.js";import"#execution/tools/workflow/messages.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";async function executeWorkflowBody(e,t){let n=createWorkflowBodyRef(e),i=createWorkflowBodyContext(e,t);attachWorkflowToolRunContext(i,{from:n,owner:e.owner});let o=0;try{let t=resolveWorkflowToolExecute(e),r=e.execution===`background`?createWorkflowTaskExec(e):void 0,a=t(e.executeInput??e.input,i,r),s;if(!isAsyncIterable(a))s=await a;else{let t=a[Symbol.asyncIterator](),r,i=await t.next();for(;i.done!==!0;){r=i.value;let a={from:n,update:i.value};await resumeHookStep(e.owner.inbox,{kind:`report`,...a}),o+=1,i=await t.next()}s=i.value??(e.execution===`blocking`?r:void 0)??null}return{outcome:{output:s,status:`completed`},reportCount:o}}catch(e){return t.aborted?{outcome:{reason:t.reason instanceof Error?t.reason.message:String(t.reason??``),status:`cancelled`},reportCount:o}:{outcome:{error:normalizeSerializableError(e),status:`failed`},reportCount:o}}}function createWorkflowBodyRef(t){return{callId:t.callId,execution:t.execution,input:t.input,resultKind:t.resultKind,runId:t.runId??getWorkflowMetadata().workflowRunId,sequence:t.session.turn.sequence,stepIndex:t.stepIndex,toolName:t.toolName,turnId:t.session.turn.id}}function resolveWorkflowToolExecute(e){let t=readRegisteredWorkflow(e.workflowId);if(typeof t!=`function`)throw Error(`Tool "${e.toolName}" is not registered as a workflow in this deployment (${e.workflowId}). The tool was renamed or removed after this run started.`);return t}function createWorkflowBodyContext(e,t){let unavailable=(t,n)=>{throw Error(`ctx.${t} is not available inside a workflow tool; ${n}. Tool "${e.toolName}" runs as a durable workflow body, which only replays deterministic code.`)},r={agent:e=>agent(r,e),ask:e=>ask(r,e),abortSignal:t,callId:e.callId,getSandbox:()=>unavailable(`getSandbox()`,`the session sandbox belongs to the turn`),getSkill:()=>unavailable(`getSkill()`,`skills are read through the session sandbox`),getToken:()=>unavailable(`getToken()`,`read credentials from the environment inside a "use step" helper`),requireAuth:()=>unavailable(`requireAuth()`,`a workflow body cannot park on authorization`),session:e.session,toolName:e.toolName};return r}function createWorkflowTaskExec(e){if(e.taskId===void 0)throw Error(`Background workflow tool "${e.toolName}" has no task id.`);return{binding:{taskId:e.taskId,token:e.taskId},postMessage:createTaskMessage,send(){throw Error(`task.send() was replaced by yielded task descriptors.`)},session:void 0,task:void 0,taskId:e.taskId}}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}export{createWorkflowBodyRef,executeWorkflowBody};

package/dist/src/execution/tools/workflow/cancel.js

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{cancelRun,getWorld,resumeHook}from"#internal/workflow/runtime.js";import{isTaskWorkflowTargetGone}from"#execution/tasks/workflow-target.js";const log=createLogger(`execution.workflow-tool-run`);async function cancelWorkflowToolRun(e,n){let r={kind:`cancel`,reason:n};try{await resumeHook(e.hookToken,r);return}catch(t){if(isTaskWorkflowTargetGone(t))return;logError(log,`failed to signal a workflow tool run to cancel; cancelling it outright`,t,{runId:e.runId})}try{await cancelRun(await getWorld(),e.runId,{cancelReason:n})}catch(t){if(isTaskWorkflowTargetGone(t))return;logError(log,`failed to cancel workflow tool run; it may run to completion`,t,{runId:e.runId})}}async function cancelWorkflowToolRunStep(e){"use step";await cancelWorkflowToolRun(e.run,e.reason)}export{cancelWorkflowToolRun,cancelWorkflowToolRunStep};
+import{createLogger,logError}from"#internal/logging.js";import{cancelRun,getWorld,resumeHook}from"#internal/workflow/runtime.js";import{isTaskWorkflowTargetGone}from"#execution/tasks/workflow-target.js";const log=createLogger(`execution.workflow-tool-run`);async function cancelWorkflowToolRun(e,n){let r={kind:`cancel`,reason:n};try{await resumeHook(e.hookToken,r);return}catch(t){isTaskWorkflowTargetGone(t)||logError(log,`failed to signal a workflow tool run to cancel; cancelling it outright`,t,{runId:e.runId})}try{await cancelRun(await getWorld(),e.runId,{cancelReason:n})}catch(t){if(isTaskWorkflowTargetGone(t))return;logError(log,`failed to cancel workflow tool run; it may run to completion`,t,{runId:e.runId})}}async function cancelWorkflowToolRunStep(e){"use step";await cancelWorkflowToolRun(e.run,e.reason)}export{cancelWorkflowToolRun,cancelWorkflowToolRunStep};

package/dist/src/execution/tools/workflow/messages.d.ts

@@ -4,10 +4,7 @@ import type { InputRequest } from "#shared/input.js";
 import type { JsonObject, JsonValue } from "#shared/json.js";
 import type { ToolInputRequest } from "#tools/definition.js";
 export interface WorkflowToolRunOwner {
-    readonly admission: string;
-    readonly outcome: string;
-    readonly report: string;
-    readonly request: string;
+    readonly inbox: string;
 }
 /**
  * Requests the owner must apply on the run's behalf because they touch
@@ -77,10 +74,14 @@ export interface WorkflowToolRunOutcomeMessage {
     readonly from: WorkflowToolRunRef;
     readonly result: WorkflowToolRunOutcome;
 }
-export declare const workflowToolRunReportHook: import("#compiled/@workflow/core/index.js").TypedHook<WorkflowToolRunReport, WorkflowToolRunReport>;
-export declare const workflowToolRunRequestHook: import("#compiled/@workflow/core/index.js").TypedHook<WorkflowToolRunRequestMessage, WorkflowToolRunRequestMessage>;
-export declare const workflowToolRunOutcomeHook: import("#compiled/@workflow/core/index.js").TypedHook<WorkflowToolRunOutcomeMessage, WorkflowToolRunOutcomeMessage>;
-export declare function deriveWorkflowToolRunOwner(inboxToken: string): WorkflowToolRunOwner;
+export type WorkflowToolRunMessage = ({
+    readonly kind: "report";
+} & WorkflowToolRunReport) | ({
+    readonly kind: "request";
+} & WorkflowToolRunRequestMessage) | ({
+    readonly kind: "outcome";
+} & WorkflowToolRunOutcomeMessage);
+export declare const workflowToolRunHook: import("#compiled/@workflow/core/index.js").TypedHook<WorkflowToolRunMessage, WorkflowToolRunMessage>;
 export type WorkflowToolRunControlMessage = {
     readonly kind: "cancel";
     readonly reason: string;

package/dist/src/execution/tools/workflow/messages.js

@@ -1 +1 @@
-import{defineHook}from"#compiled/@workflow/core/index.js";const workflowToolRunReportHook=defineHook(),workflowToolRunRequestHook=defineHook(),workflowToolRunOutcomeHook=defineHook();function deriveWorkflowToolRunOwner(e){return{admission:`${e}:admission`,outcome:`${e}:outcome`,report:`${e}:report`,request:`${e}:request`}}function isWorkflowToolRunControlMessage(e){if(typeof e!=`object`||!e)return!1;let{kind:t,reason:n}=e;return t===`cancel`&&typeof n==`string`}export{deriveWorkflowToolRunOwner,isWorkflowToolRunControlMessage,workflowToolRunOutcomeHook,workflowToolRunReportHook,workflowToolRunRequestHook};
+import{defineHook}from"#compiled/@workflow/core/index.js";const workflowToolRunHook=defineHook();function isWorkflowToolRunControlMessage(e){if(typeof e!=`object`||!e)return!1;let{kind:t,reason:n}=e;return t===`cancel`&&typeof n==`string`}export{isWorkflowToolRunControlMessage,workflowToolRunHook};

package/dist/src/execution/tools/workflow/owner-inbox.d.ts

@@ -3,11 +3,11 @@ import type { WorkflowToolRunOutcomeMessage, WorkflowToolRunReport, WorkflowTool
 import type { RuntimeToolResultActionResult } from "#shared/action-types.js";
 import type { RuntimeSubagentResult } from "#shared/action-types.js";
 import type { WorkflowToolRunTaskInputRequest } from "#execution/tasks/child/workflow.js";
-import type { TaskCommand, TaskInboundUpdate } from "#tasks/types.js";
+import type { TaskCommand, TaskInboundMessage, TaskInboundUpdate } from "#tasks/types.js";
 export declare function workflowToolRunOutcomeToToolResult(message: WorkflowToolRunOutcomeMessage): RuntimeToolResultActionResult;
 /** Reads a blocking agent result returned through an ordinary run outcome. */
 export declare function workflowToolRunOutcomeToSubagentResult(message: WorkflowToolRunOutcomeMessage): RuntimeSubagentResult;
 export declare function workflowToolRunOutcomeToTaskCommand(message: WorkflowToolRunOutcomeMessage): TaskCommand;
-export declare function workflowToolRunReportToTaskUpdate(report: WorkflowToolRunReport, taskId: string, updateIndex: number): TaskInboundUpdate;
+export declare function workflowToolRunReportToTaskPayload(report: WorkflowToolRunReport, taskId: string, updateIndex: number): TaskInboundMessage | TaskInboundUpdate;
 export declare function workflowToolRunRequestToInputRequestPayload(message: WorkflowToolRunRequestMessage): SubagentInputRequestHookPayload;
 export declare function workflowToolRunRequestToTaskInputRequest(message: WorkflowToolRunRequestMessage): WorkflowToolRunTaskInputRequest;

package/dist/src/execution/tools/workflow/owner-inbox.js

@@ -1 +1 @@
-import{parseJsonValue}from"#shared/json.js";import{SUBAGENT_EXECUTION_FAILED}from"#subagents/agent-handle-errors.js";function workflowToolRunOutcomeToToolResult(e){let{from:t,result:n}=e;return n.status===`completed`?{callId:t.callId,kind:`tool-result`,output:n.output,toolName:t.toolName}:{callId:t.callId,isError:!0,kind:`tool-result`,output:n.status===`failed`?errorMessage(n.error):n.reason??`The workflow tool run was cancelled.`,toolName:t.toolName}}function workflowToolRunOutcomeToSubagentResult(e){if(e.result.status===`completed`&&isRuntimeSubagentResult(e.result.output))return e.result.output;let t=e.result.status===`failed`?errorMessage(e.result.error):e.result.status===`cancelled`?e.result.reason??`The agent invocation was cancelled.`:`The agent invocation returned an invalid result.`;return{callId:e.from.callId,isError:!0,kind:`subagent-result`,origin:`dispatch`,output:t,subagentName:e.from.toolName}}function workflowToolRunOutcomeToTaskCommand(e){return e.result.status===`completed`?{data:e.result.output,kind:`complete`}:e.result.status===`failed`?{data:e.from.resultKind===`subagent`?subagentFailureOutput(e.result.error):errorMessage(e.result.error),kind:`fail`}:{kind:`cancel`}}function subagentFailureOutput(e){let n=parseJsonValueOrUndefined(e);return n!==void 0&&typeof n==`object`&&n&&!Array.isArray(n)&&typeof Reflect.get(n,`code`)==`string`?n:{code:SUBAGENT_EXECUTION_FAILED,message:errorMessage(e)}}function workflowToolRunReportToTaskUpdate(e,t,n){return{callId:e.from.callId,kind:`task-update`,message:typeof e.update==`string`?e.update:JSON.stringify(e.update),updateEpoch:t,updateIndex:n}}function isRuntimeSubagentResult(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`origin`);return Reflect.get(e,`kind`)===`subagent-result`&&(t===`child`||t===`dispatch`)}function errorMessage(e){if(typeof e==`object`&&e&&`message`in e){let t=e.message;if(typeof t==`string`)return t}return String(e)}function parseJsonValueOrUndefined(t){try{return parseJsonValue(t)}catch{return}}function workflowToolRunRequestToInputRequestPayload(e){let{from:t,replyTo:n,request:r,requestCoordinates:i}=e;return{callId:t.callId,childContinuationToken:n,childSessionId:t.runId,event:{requests:r.kind===`input-batch`?r.requests:[normalizeInputRequest(r,t,n)],sequence:i?.sequence??t.sequence,stepIndex:i?.stepIndex??t.stepIndex,turnId:i?.turnId??t.turnId},kind:`subagent-input-request`,subagentName:t.toolName}}function workflowToolRunRequestToTaskInputRequest(e){let{from:t,replyTo:n,request:r,requestCoordinates:i}=e,a={kind:`task-input-request`,replyTo:n,sequence:i?.sequence??t.sequence,stepIndex:i?.stepIndex??t.stepIndex,turnId:i?.turnId??t.turnId};return r.kind===`input-batch`?{...a,requests:r.requests}:{...a,request:normalizeInputRequest(r,t,n)}}function normalizeInputRequest(e,t,n){switch(e.kind){case`agent-invoke`:case`agent-settled`:throw TypeError(`A workflow agent request cannot be normalized as human input.`);case`authorization-request`:throw TypeError(`A workflow authorization event cannot be normalized as human input.`);case`ask`:return normalizeAskRequest(e.request,t,n);default:return e}}function normalizeAskRequest(e,t,n){if(typeof e.prompt!=`string`||e.prompt.length===0)throw TypeError("A workflow tool run request needs a non-empty `prompt`.");let r={action:{callId:t.callId,input:t.input,kind:`tool-call`,toolName:t.toolName},kind:`question`,prompt:e.prompt,requestId:n};return e.allowFreeform!==void 0&&(r.allowFreeform=e.allowFreeform),e.display!==void 0&&(r.display=e.display),e.options!==void 0&&(r.options=[...e.options]),r}export{workflowToolRunOutcomeToSubagentResult,workflowToolRunOutcomeToTaskCommand,workflowToolRunOutcomeToToolResult,workflowToolRunReportToTaskUpdate,workflowToolRunRequestToInputRequestPayload,workflowToolRunRequestToTaskInputRequest};
+import{parseJsonValue}from"#shared/json.js";import{SUBAGENT_EXECUTION_FAILED}from"#subagents/agent-handle-errors.js";import{isTaskMessage}from"#tools/task.js";function workflowToolRunOutcomeToToolResult(e){let{from:t,result:n}=e;return n.status===`completed`?{callId:t.callId,kind:`tool-result`,output:n.output,toolName:t.toolName}:{callId:t.callId,isError:!0,kind:`tool-result`,output:n.status===`failed`?errorMessage(n.error):n.reason??`The workflow tool run was cancelled.`,toolName:t.toolName}}function workflowToolRunOutcomeToSubagentResult(e){if(e.result.status===`completed`&&isRuntimeSubagentResult(e.result.output))return e.result.output;let t=e.result.status===`failed`?errorMessage(e.result.error):e.result.status===`cancelled`?e.result.reason??`The agent invocation was cancelled.`:`The agent invocation returned an invalid result.`;return{callId:e.from.callId,isError:!0,kind:`subagent-result`,origin:`dispatch`,output:t,subagentName:e.from.toolName}}function workflowToolRunOutcomeToTaskCommand(e){return e.result.status===`completed`?{data:e.result.output,kind:`complete`}:e.result.status===`failed`?{data:e.from.resultKind===`subagent`?subagentFailureOutput(e.result.error):errorMessage(e.result.error),kind:`fail`}:{kind:`cancel`}}function subagentFailureOutput(e){let n=parseJsonValueOrUndefined(e);return n!==void 0&&typeof n==`object`&&n&&!Array.isArray(n)&&typeof Reflect.get(n,`code`)==`string`?n:{code:SUBAGENT_EXECUTION_FAILED,message:errorMessage(e)}}function workflowToolRunReportToTaskPayload(e,t,r){return isTaskMessage(e.update)?{callId:e.from.callId,kind:`task-message`,message:e.update.message,messageEpoch:t,messageIndex:r}:{callId:e.from.callId,kind:`task-update`,message:typeof e.update==`string`?e.update:JSON.stringify(e.update),updateEpoch:t,updateIndex:r}}function isRuntimeSubagentResult(e){if(typeof e!=`object`||!e)return!1;let t=Reflect.get(e,`origin`);return Reflect.get(e,`kind`)===`subagent-result`&&(t===`child`||t===`dispatch`)}function errorMessage(e){if(typeof e==`object`&&e&&`message`in e){let t=e.message;if(typeof t==`string`)return t}return String(e)}function parseJsonValueOrUndefined(t){try{return parseJsonValue(t)}catch{return}}function workflowToolRunRequestToInputRequestPayload(e){let{from:t,replyTo:n,request:r,requestCoordinates:i}=e;return{callId:t.callId,childContinuationToken:n,childSessionId:t.runId,event:{requests:r.kind===`input-batch`?r.requests:[normalizeInputRequest(r,t,n)],sequence:i?.sequence??t.sequence,stepIndex:i?.stepIndex??t.stepIndex,turnId:i?.turnId??t.turnId},kind:`subagent-input-request`,subagentName:t.toolName}}function workflowToolRunRequestToTaskInputRequest(e){let{from:t,replyTo:n,request:r,requestCoordinates:i}=e,a={kind:`task-input-request`,replyTo:n,sequence:i?.sequence??t.sequence,stepIndex:i?.stepIndex??t.stepIndex,turnId:i?.turnId??t.turnId};return r.kind===`input-batch`?{...a,requests:r.requests}:{...a,request:normalizeInputRequest(r,t,n)}}function normalizeInputRequest(e,t,n){switch(e.kind){case`agent-invoke`:case`agent-settled`:throw TypeError(`A workflow agent request cannot be normalized as human input.`);case`authorization-request`:throw TypeError(`A workflow authorization event cannot be normalized as human input.`);case`ask`:return normalizeAskRequest(e.request,t,n);default:return e}}function normalizeAskRequest(e,t,n){if(typeof e.prompt!=`string`||e.prompt.length===0)throw TypeError("A workflow tool run request needs a non-empty `prompt`.");let r={action:{callId:t.callId,input:t.input,kind:`tool-call`,toolName:t.toolName},kind:`question`,prompt:e.prompt,requestId:n};return e.allowFreeform!==void 0&&(r.allowFreeform=e.allowFreeform),e.display!==void 0&&(r.display=e.display),e.options!==void 0&&(r.options=[...e.options]),r}export{workflowToolRunOutcomeToSubagentResult,workflowToolRunOutcomeToTaskCommand,workflowToolRunOutcomeToToolResult,workflowToolRunReportToTaskPayload,workflowToolRunRequestToInputRequestPayload,workflowToolRunRequestToTaskInputRequest};

package/dist/src/execution/tools/workflow/owner.d.ts

@@ -1,13 +1,7 @@
-import { type WorkflowToolRunOutcomeMessage, type WorkflowToolRunReport, type WorkflowToolRunRequestMessage } from "#execution/tools/workflow/messages.js";
+import { type WorkflowToolRunMessage, type WorkflowToolRunOwner } from "#execution/tools/workflow/messages.js";
 import { type ChannelReader } from "#execution/tools/workflow/owner-channels.js";
-/** In read priority: what a workflow tool run said before its outcome lands first. */
-export type WorkflowToolRunOwnerReaders = readonly [
-    ChannelReader<"report", WorkflowToolRunReport>,
-    ChannelReader<"request", WorkflowToolRunRequestMessage>,
-    ChannelReader<"outcome", WorkflowToolRunOutcomeMessage>
-];
-export interface WorkflowToolRunOwnerChannels {
-    readonly readers: WorkflowToolRunOwnerReaders;
-    dispose(): Promise<void>;
+export interface WorkflowToolRunOwnerInbox {
+    readonly owner: WorkflowToolRunOwner;
+    readonly reader: ChannelReader<"workflow", WorkflowToolRunMessage>;
 }
-export declare function openWorkflowToolRunOwnerChannels(inboxToken: string): WorkflowToolRunOwnerChannels;
+export declare function openWorkflowToolRunOwnerInbox(): WorkflowToolRunOwnerInbox;

package/dist/src/execution/tools/workflow/owner.js

@@ -1 +1 @@
-import{disposeHook}from"#execution/hook-ownership.js";import{deriveWorkflowToolRunOwner,workflowToolRunOutcomeHook,workflowToolRunReportHook,workflowToolRunRequestHook}from"#execution/tools/workflow/messages.js";import{createChannelReader}from"#execution/tools/workflow/owner-channels.js";function openWorkflowToolRunOwnerChannels(e){let t=deriveWorkflowToolRunOwner(e),n=workflowToolRunReportHook.create({token:t.report}),r=workflowToolRunRequestHook.create({token:t.request}),i=workflowToolRunOutcomeHook.create({token:t.outcome});return{readers:[createChannelReader(`report`,n),createChannelReader(`request`,r),createChannelReader(`outcome`,i)],async dispose(){await disposeHook(n),await disposeHook(r),await disposeHook(i)}}}export{openWorkflowToolRunOwnerChannels};
+import{createChannelReader}from"#execution/tools/workflow/owner-channels.js";import{workflowToolRunHook}from"#execution/tools/workflow/messages.js";function openWorkflowToolRunOwnerInbox(){let e=workflowToolRunHook.create();return{owner:{inbox:e.token},reader:createChannelReader(`workflow`,e)}}export{openWorkflowToolRunOwnerInbox};

package/dist/src/execution/tools/workflow/run-control.d.ts

@@ -1,17 +1,13 @@
-import { type Hook } from "#compiled/@workflow/core/index.js";
-import { type WorkflowToolRunControlMessage } from "#execution/tools/workflow/messages.js";
 /**
  * The run's control inbox. An unawaited hook read is not scheduled under
  * replay, so `cancelled` must be raced for a cancel to be observed at all.
  */
 export interface WorkflowToolRunControlInbox {
-    readonly hook: Hook<WorkflowToolRunControlMessage>;
     readonly signal: AbortSignal;
     /** Rejects with {@link WorkflowToolRunCancelledError} when a cancel message arrives; never resolves. */
     readonly cancelled: Promise<never>;
     reason(): string | undefined;
 }
-/** Opens without claiming, so a losing duplicate start never trips the signal. */
 export declare function openWorkflowToolRunControlInbox(hookToken: string): WorkflowToolRunControlInbox;
 export declare class WorkflowToolRunCancelledError extends Error {
     constructor(reason: string);

package/dist/src/execution/tools/workflow/run-control.js

@@ -1 +1 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{isWorkflowToolRunControlMessage}from"#execution/tools/workflow/messages.js";function openWorkflowToolRunControlInbox(t){let n=createHook({token:t}),r=n[Symbol.asyncIterator](),i=new AbortController,a,o=consumeCancel(r,e=>{a=e,i.abort(new WorkflowToolRunCancelledError(e))});return o.catch(()=>{}),{cancelled:o,hook:n,reason:()=>a,signal:i.signal}}async function consumeCancel(e,n){for(;;){let r;try{r=await e.next()}catch{return await new Promise(()=>{})}if(r.done===!0)return await new Promise(()=>{});if(isWorkflowToolRunControlMessage(r.value))throw n(r.value.reason),new WorkflowToolRunCancelledError(r.value.reason)}}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}};export{WorkflowToolRunCancelledError,openWorkflowToolRunControlInbox};
+import{createHook}from"#compiled/@workflow/core/index.js";import{isWorkflowToolRunControlMessage}from"#execution/tools/workflow/messages.js";function openWorkflowToolRunControlInbox(t){let n=createHook({token:t})[Symbol.asyncIterator](),r=new AbortController,i,a=consumeCancel(n,e=>{i=e,r.abort(new WorkflowToolRunCancelledError(e))});return a.catch(()=>{}),{cancelled:a,reason:()=>i,signal:r.signal}}async function consumeCancel(e,n){for(;;){let r=await e.next();if(r.done===!0)return await new Promise(()=>{});if(isWorkflowToolRunControlMessage(r.value))throw n(r.value.reason),new WorkflowToolRunCancelledError(r.value.reason)}}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}};export{WorkflowToolRunCancelledError,openWorkflowToolRunControlInbox};

package/dist/src/execution/tools/workflow/start.d.ts

@@ -1,19 +1,10 @@
 import type { SessionAuth, SessionParent } from "#context/session-context.js";
 import type { RuntimeSession } from "#subagents/handle-dispatch.js";
 import type { RuntimeToolResultActionResult, RuntimeWorkflowTaskRequest } from "#shared/action-types.js";
-import type { WorkflowToolRunInput } from "#execution/tools/workflow/types.js";
-export declare function deriveWorkflowToolRunHookToken(input: {
-    readonly callId: string;
-    readonly parentSessionId: string;
-    readonly parentTurnId: string;
-}): string;
-/** Resolves once the workflow tool run owns its hook. Call from a `"use step"` body. */
-export declare function startWorkflowToolRun(input: Omit<WorkflowToolRunInput, "hookToken"> & {
-    readonly hookToken?: string;
-}): Promise<{
-    readonly hookToken: string;
-    readonly runId: string;
-}>;
+import type { WorkflowToolRunAddress, WorkflowToolRunInput } from "#execution/tools/workflow/types.js";
+import type { WorkflowToolRunOwner } from "#execution/tools/workflow/messages.js";
+/** Starts a new run for each dispatch attempt. Call from a `"use step"` body. */
+export declare function startWorkflowToolRun(input: Omit<WorkflowToolRunInput, "hookToken">): Promise<WorkflowToolRunAddress>;
 /** Starts one durable workflow task and records it on the owning session. */
 export declare function startWorkflowTask(input: {
     readonly auth: SessionAuth["current"];
@@ -23,7 +14,7 @@ export declare function startWorkflowTask(input: {
         readonly turnId: string;
     };
     readonly initiatorAuth: SessionAuth["initiator"];
-    readonly parentContinuationToken: string;
+    readonly owner: WorkflowToolRunOwner;
     readonly parentSession: SessionParent | undefined;
     readonly session: RuntimeSession;
     readonly task: RuntimeWorkflowTaskRequest;

package/dist/src/execution/tools/workflow/start.js

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{toError}from"#shared/errors.js";import{startWorkflowOnCurrentDeployment,waitForCommandHookOwner,workflowToolRunWorkflowReference}from"#execution/workflow-runtime.js";import{deriveAgentOperationId}from"#subagents/handles/operation-id.js";import{recordWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{deriveWorkflowToolRunOwner}from"#execution/tools/workflow/messages.js";import{createRuntimeToolResultFromValue}from"#harness/action-result-helpers.js";const log=createLogger(`execution.workflow-tool-run`);function deriveWorkflowToolRunHookToken(e){return`eve:workflow-tool-run:${deriveAgentOperationId(e)}`}async function startWorkflowToolRun(e){let t=e.hookToken??deriveWorkflowToolRunHookToken({callId:e.callId,parentSessionId:e.session.id,parentTurnId:e.session.turn.id});return await startWorkflowOnCurrentDeployment(workflowToolRunWorkflowReference,[{...e,hookToken:t}]),{hookToken:t,runId:(await waitForCommandHookOwner(t)).runId}}async function startWorkflowTask(e){let{task:n,batchEvent:r,session:i}=e;try{let t=await startWorkflowToolRun({callId:n.callId,executeInput:n.executeInput,input:n.input,owner:deriveWorkflowToolRunOwner(e.parentContinuationToken),resultKind:n.resultKind,session:{auth:{current:e.auth,initiator:e.initiatorAuth},id:i.sessionId,parent:e.parentSession,turn:{id:r.turnId,sequence:r.sequence}},stepIndex:r.stepIndex,toolName:n.toolName,workflowId:n.workflowId});return{session:recordWorkflowToolRun(i,{callId:n.callId,hookToken:t.hookToken,resultKind:n.resultKind??`tool`,runId:t.runId,toolName:n.toolName})}}catch(e){return logError(log,`workflow tool run failed to start`,e,{callId:n.callId,toolName:n.toolName}),{result:createRuntimeToolResultFromValue({callId:n.callId,isError:!0,output:toError(e),toolName:n.toolName}),session:i}}}export{deriveWorkflowToolRunHookToken,startWorkflowTask,startWorkflowToolRun};
+import{createLogger,logError}from"#internal/logging.js";import{toError}from"#shared/errors.js";import{startWorkflowOnCurrentDeployment,workflowToolRunWorkflowReference}from"#execution/workflow-runtime.js";import{recordWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{createRuntimeToolResultFromValue}from"#harness/action-result-helpers.js";const log=createLogger(`execution.workflow-tool-run`);async function startWorkflowToolRun(e){let t=crypto.randomUUID();return{hookToken:t,runId:(await startWorkflowOnCurrentDeployment(workflowToolRunWorkflowReference,[{...e,hookToken:t}])).runId}}async function startWorkflowTask(e){let{task:n,batchEvent:r,session:i}=e;try{let t=await startWorkflowToolRun({callId:n.callId,executeInput:n.executeInput,input:n.input,owner:e.owner,resultKind:n.resultKind,session:{auth:{current:e.auth,initiator:e.initiatorAuth},id:i.sessionId,parent:e.parentSession,turn:{id:r.turnId,sequence:r.sequence}},stepIndex:r.stepIndex,toolName:n.toolName,workflowId:n.workflowId});return{session:recordWorkflowToolRun(i,{callId:n.callId,hookToken:t.hookToken,resultKind:n.resultKind??`tool`,runId:t.runId,toolName:n.toolName})}}catch(e){return logError(log,`workflow tool run failed to start`,e,{callId:n.callId,toolName:n.toolName}),{result:createRuntimeToolResultFromValue({callId:n.callId,isError:!0,output:toError(e),toolName:n.toolName}),session:i}}}export{startWorkflowTask,startWorkflowToolRun};

package/dist/src/execution/tools/workflow/workflow.d.ts

@@ -1,3 +1,3 @@
 import type { WorkflowToolRunInput } from "#execution/tools/workflow/types.js";
-/** Runs one authored workflow tool call and reports to its declared owner hooks. */
+/** Runs one authored workflow tool call and reports to its declared owner hook. */
 export declare function workflowToolRunWorkflow(input: WorkflowToolRunInput): Promise<void>;

package/dist/src/execution/tools/workflow/workflow.js

@@ -1 +1 @@
-import{sleep}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook,isHookConflictError}from"#execution/hook-ownership.js";import{createWorkflowBodyRef,executeWorkflowBody}from"#execution/tools/workflow/body.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{openWorkflowToolRunControlInbox}from"#execution/tools/workflow/run-control.js";async function workflowToolRunWorkflow(i){"use workflow";let a=openWorkflowToolRunControlInbox(i.hookToken),o=!1;try{try{await claimHookOwnership(a.hook),o=!0}catch(e){if(isHookConflictError(e))return;throw e}let n={...i,execution:i.execution??`blocking`},r=createWorkflowBodyRef(n),s=executeWorkflowBody(n,a.signal).then(e=>{if(e.status===`completed`)return e.output;throw e.status===`failed`?e.error:a.signal.reason??Error(e.reason??`Workflow tool run cancelled.`)}),c=s.catch(()=>{}),l;try{l={output:await Promise.race([s,a.cancelled]),status:`completed`}}catch(t){a.signal.aborted?(await Promise.race([c,sleep(`30s`)]),l={reason:a.reason(),status:`cancelled`}):l={error:normalizeSerializableError(t),status:`failed`}}let u={from:r,result:l};await resumeHookStep(i.owner.outcome,u,{ifPresent:l.status===`cancelled`})}finally{o&&await disposeHook(a.hook)}}export{workflowToolRunWorkflow};
+import{sleep}from"#compiled/@workflow/core/index.js";import{createWorkflowBodyRef,executeWorkflowBody}from"#execution/tools/workflow/body.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{openWorkflowToolRunControlInbox}from"#execution/tools/workflow/run-control.js";async function workflowToolRunWorkflow(n){"use workflow";let r=openWorkflowToolRunControlInbox(n.hookToken),i={...n,execution:n.execution??`blocking`},a=createWorkflowBodyRef(i),o=executeWorkflowBody(i,r.signal).then(({outcome:e})=>{if(e.status===`completed`)return e.output;throw e.status===`failed`?e.error:r.signal.reason??Error(e.reason??`Workflow tool run cancelled.`)}),s=o.catch(()=>{}),c;try{c={output:await Promise.race([o,r.cancelled]),status:`completed`}}catch(t){r.signal.aborted?(await Promise.race([s,sleep(`30s`)]),c={reason:r.reason(),status:`cancelled`}):c={error:normalizeSerializableError(t),status:`failed`}}let l={from:a,result:c};await resumeHookStep(n.owner.inbox,{kind:`outcome`,...l},{ifPresent:c.status===`cancelled`})}workflowToolRunWorkflow.workflowId=`workflow//eve//workflowToolRunWorkflow`;export{workflowToolRunWorkflow};

package/dist/src/execution/turn-cancellation-control.d.ts

@@ -13,6 +13,7 @@ export interface TurnCancellationControl {
      * the signal aborted. Race it against turn-owned awaits — never
      * `await` it alone.
      */
+    readonly payload: Promise<TurnCancelPayload>;
     readonly requested: Promise<"cancel">;
     /** Disposes the hook, abandoning any outstanding read. Idempotent. */
     dispose(): Promise<void>;

package/dist/src/execution/turn-cancellation-control.js

@@ -1 +1 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook,isHookConflictError}from"#execution/hook-ownership.js";import{TurnCancelledError}from"#harness/turn-cancellation.js";import{turnCancellationHookToken}from"#execution/turn-cancellation-token.js";async function createTurnCancellationControl(i){let a=createHook({token:turnCancellationHookToken(i.controlToken)}),o=a[Symbol.asyncIterator]();try{await claimHookOwnership(a)}catch(e){if(isHookConflictError(e))return;throw e}let s=new AbortController,abort=()=>s.abort(new TurnCancelledError),c=i.initialPayload!==void 0&&matchesActiveTurn(i.initialPayload,i.expectedTurnId);c&&abort();let l=c?Promise.resolve(`cancel`):consumeMatchingCancel(o,i.expectedTurnId,abort).then(()=>`cancel`),u=!1;return{signal:s.signal,requested:l,async dispose(){u||(u=!0,await disposeHook(a))}}}async function consumeMatchingCancel(e,t,n){for(;;){let r=await e.next();if(r.done)return await new Promise(()=>{});if(matchesActiveTurn(r.value,t)){n();return}}}function matchesActiveTurn(e,t){if(typeof e!=`object`||!e)return!0;let n=e.turnId;return n===void 0||n===t}export{createTurnCancellationControl};
+import{createHook}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook,isHookConflictError}from"#execution/hook-ownership.js";import{TurnCancelledError}from"#harness/turn-cancellation.js";import{turnCancellationHookToken}from"#execution/turn-cancellation-token.js";async function createTurnCancellationControl(i){let a=createHook({token:turnCancellationHookToken(i.controlToken)}),o=a[Symbol.asyncIterator]();try{await claimHookOwnership(a)}catch(e){if(isHookConflictError(e))return;throw e}let s=new AbortController,abort=()=>s.abort(new TurnCancelledError),c=i.initialPayload!==void 0&&matchesActiveTurn(i.initialPayload,i.expectedTurnId);c&&abort();let l=c?Promise.resolve(i.initialPayload):consumeMatchingCancel(o,i.expectedTurnId,abort),u=!1;return{payload:l,signal:s.signal,requested:l.then(()=>`cancel`),async dispose(){u||(u=!0,await disposeHook(a))}}}async function consumeMatchingCancel(e,t,n){for(;;){let r=await e.next();if(r.done)return await new Promise(()=>{});if(matchesActiveTurn(r.value,t))return n(),r.value}}function matchesActiveTurn(e,t){if(typeof e!=`object`||!e)return!0;let n=e.turnId;return n===void 0||n===t}export{createTurnCancellationControl};

package/dist/src/execution/turn-cancellation-token.d.ts

@@ -5,5 +5,6 @@ export declare function turnCancellationHookToken(controlToken: string): string;
  * benign no-op; omitting it targets whichever turn owns the hook.
  */
 export interface TurnCancelPayload {
+    readonly tasks?: boolean;
     readonly turnId?: string;
 }

package/dist/src/execution/turn-control-receiver.d.ts

@@ -1,6 +1,7 @@
 import type { DeliverHookPayload } from "#channel/types.js";
 import type { NextDriverAction } from "#execution/next-driver-action.js";
 import type { SessionCommandInbox } from "#execution/session-command-inbox.js";
+import type { SessionStateCursor } from "#execution/session-state-cursor.js";
 export type TurnDriverAction = NextDriverAction;
 /** Owns one turn's driver-side control hook and public-delivery relay state. */
 export declare class TurnControlReceiver {
@@ -12,6 +13,7 @@ export declare class TurnControlReceiver {
     private readonly expectedTurnId;
     private readonly cancelledTaskIds;
     private readonly seenTaskDeliveries;
+    private readonly stateCursor;
     private pendingControl;
     constructor(input: {
         readonly bufferedDeliveries: DeliverHookPayload[];
@@ -20,6 +22,7 @@ export declare class TurnControlReceiver {
         readonly commandInbox: SessionCommandInbox;
         readonly expectedTurnId: string;
         readonly seenTaskDeliveries?: Set<string>;
+        readonly stateCursor: SessionStateCursor;
         readonly token: string;
     });
     /** Token passed to the turn workflow so it can publish control messages. */