eve 0.83.2 → 0.84.0

package/dist/src/execution/tasks/steps.js

@@ -1 +1 @@
-import{resumeHook}from"#internal/workflow/runtime.js";import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import{commitSessionStep}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{cancelTask,findTask,finishTaskRun,markTaskRunStarted,readTaskTable,recordTaskRunUsage,settleRemainingTaskCalls,settleTaskCalls,writeTaskTable}from"#execution/tasks/table.js";import{finishRun,settleTask}from"#harness/session-machine/transitions.js";import{countRunUsage}from"#execution/agent-sessions/usage.js";import{workflowToolRunFailureOutput}from"#execution/tools/workflow/owner-inbox.js";import{ignoreGoneTarget}from"#execution/tasks/workflow-target.js";async function applyTaskRunMessage(e){let{message:t}=e,n=t.from.taskId,r=readDurableSession(e.sessionState);if(n===void 0)return{serializedContext:e.serializedContext,sessionState:e.sessionState};let i=readTaskTable(r.state),a=[],o=[];switch(t.kind){case`started`:{let e=markTaskRunStarted(i,n,t.from.runId);i=e.table,e.held!==void 0&&await sendTaskRunCommands(e.held);break}case`reply`:{({session:r,table:i}=countTaskRunUsage(r,i,n,t));let e={output:t.output,status:`completed`},o=findTask(i,n),s=settleTaskCalls(i,{callIds:t.callIds,outcome:e,taskId:n});i=s.table,a.push(...taskSettled(o,s.settled,e));break}case`usage`:({session:r,table:i}=countTaskRunUsage(r,i,n,t));break;case`outcome`:{({session:r,table:i}=countTaskRunUsage(r,i,n,t));let e=toOutcome(t),s=findTask(i,n),c=settleRemainingTaskCalls(i,n,e);a.push(...taskSettled(s,c.settled,e)),i=finishTaskRun(c.table,n,t.from.runId);let l=runRequestIds(r,t.from.runId);o.push(e=>finishRun(e,{requestIds:l,taskId:n}));break}}return await commitTaskDecisions(e,saveTable(e.sessionState,r,i),{settles:a,withdraws:o})}async function cancelTasksStep(e){"use step";return await withSessionStateDelta(e,cancelTasks)}async function cancelTasks(e){let t=readDurableSession(e.sessionState),n=readTaskTable(t.state),r=[],i=[],a={reason:e.reason,status:`cancelled`};for(let o of e.taskIds){let e=findTask(n,o),s=cancelTask(n,o);if(n=s.table,r.push(...taskSettled(e,s.settled,a)),s.send!==void 0){if(e?.resumable===!1){let e=runRequestIds(t,s.send.run.runId);i.push(t=>finishRun(t,{requestIds:e,taskId:o}))}await sendTaskRunCommands(s.send)}}return await commitTaskDecisions(e,saveTable(e.sessionState,t,n),{settles:r,withdraws:i})}async function commitTaskDecisions(e,t,n){let r=await commitSessionStep({...e,sessionState:t},e=>n.withdraws.map(t=>t(e)),{origin:`relayed`});return await commitSessionStep({...e,...r},e=>n.settles.map(t=>t(e)),{origin:`own`})}function taskSettled(e,t,n){return e===void 0?[]:[r=>settleTask(r,{calls:t,outcome:n,task:e})]}async function sendTaskRunCommands(e){for(let t of e.commands)await ignoreGoneTarget(resumeHook(e.run.hookToken,toControlMessage(t)))}function toControlMessage(e){switch(e.kind){case`cancel`:return{kind:`cancel`,reason:`The task was cancelled.`};case`call`:return{call:e.call,kind:`call`}}}function toOutcome(e){switch(e.result.status){case`completed`:return{output:e.result.output,status:`completed`};case`failed`:return{error:failureMessage(e),status:`failed`};case`cancelled`:return{status:`cancelled`}}}function failureMessage(e){let t=workflowToolRunFailureOutput(e);if(typeof t==`string`)return t;let n=typeof t==`object`&&t?Reflect.get(t,`message`):void 0;return typeof n==`string`?n:JSON.stringify(t)}function countTaskRunUsage(e,t,n,r){let i=findTask(t,n)?.run;return r.usage===void 0||i?.runId!==r.from.runId?{session:e,table:t}:{session:countRunUsage(e,r.usage,i.usage),table:recordTaskRunUsage(t,n,r.usage)}}function runRequestIds(e,t){return[...readHitlState(e.state).relays].filter(([,e])=>e.runId===t).map(([e])=>e)}function saveTable(e,t,n){return replaceDurableSessionSnapshot({session:writeTaskTable(t,n),state:e})}export{applyTaskRunMessage,cancelTasksStep,sendTaskRunCommands};
+import{storedProjection}from"#harness/session-machine/view.js";import{usageSince}from"#shared/token-usage-math.js";import{resumeHook}from"#internal/workflow/runtime.js";import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import{commitSessionStep}from"#execution/publish-session-events.js";import"#execution/session/state-delta.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{cancelTask,findTask,finishTaskRun,isActiveTaskRun,isCancelledTaskRun,markTaskRunStarted,readTaskTable,recordTaskRunUsage,settleRemainingTaskCalls,settleTaskCalls,writeTaskTable}from"#execution/tasks/table.js";import{endTask,finishRun,settleTask}from"#harness/session-machine/transitions.js";import{delegatedUsageFact}from"#harness/facts.js";import{workflowToolRunFailureOutput}from"#execution/tools/workflow/owner-inbox.js";import{ignoreGoneTarget}from"#execution/tasks/workflow-target.js";import{stopRuns,waitedCallRuns}from"#execution/stop-runs.js";const TASK_CANCEL_REASON=`The task was cancelled.`;async function applyTaskRunMessage(e){let{message:t}=e,n=t.from.taskId,r=readDurableSession(e.sessionState);if(n===void 0)return{serializedContext:e.serializedContext,sessionState:e.sessionState};let i=readTaskTable(r.state),a=isCancelledTaskRun(i,n,t.from.runId),o=storedProjection(r.state).view?.tasks[n]?.status===`ended`;if(a&&(t.kind===`usage`||t.kind===`outcome`)){let a=countTaskRunUsage(i,n,t);return i=t.kind===`outcome`?finishTaskRun(a.table,n,t.from.runId):a.table,await commitSessionStep({...e,sessionState:saveTable(e.sessionState,r,i)},e=>[{turn:e.turn,events:a.spend===void 0?[]:[delegatedUsageFact(void 0,a.spend)]}],{origin:`own`})}if(a&&t.kind===`started`)return await ignoreGoneTarget(resumeHook(findTask(i,n).run.hookToken,{kind:`end`,reason:TASK_CANCEL_REASON})),{serializedContext:e.serializedContext,sessionState:e.sessionState};if(o||!isActiveTaskRun(i,n,t.from.runId))return{serializedContext:e.serializedContext,sessionState:e.sessionState};let s=[],c=[],l;switch(t.kind){case`started`:{let e=markTaskRunStarted(i,n,t.from.runId);i=e.table,e.held!==void 0&&await sendTaskRunCommands(e.held);break}case`reply`:{if(findTask(i,n)?.run?.runId!==t.from.runId)break;({table:i,spend:l}=countTaskRunUsage(i,n,t));let e={output:t.output,status:`completed`},r=findTask(i,n),a=settleTaskCalls(i,{callIds:t.callIds,outcome:e,taskId:n});i=a.table,s.push(...taskSettled(r,a.settled,e));break}case`usage`:({table:i,spend:l}=countTaskRunUsage(i,n,t));break;case`outcome`:{if(findTask(i,n)?.run?.runId!==t.from.runId)break;({table:i,spend:l}=countTaskRunUsage(i,n,t));let e=toOutcome(t),a=findTask(i,n),o=settleRemainingTaskCalls(i,n,e);s.push(...taskSettled(a,o.settled,e)),l!==void 0&&s.push(spent([...s],t.from.callId,l,n)),l=void 0;let u=runRequestIds(r,t.from.runId);c.push(e=>finishRun(e,{requestIds:u,taskId:n})),s.push(t=>endTask(t,{outcome:e,taskId:n})),i=finishTaskRun(o.table,n,t.from.runId);break}}return await commitTaskDecisions(e,saveTable(e.sessionState,r,i),{settles:l===void 0?s:[...s,spent(s,t.from.callId,l,n)],withdraws:c})}function spendFact(e,t,n,r){let i=e.filter(e=>e.type===`call.settled`),a=i.find(e=>e.data.callId===t)??i[0];return a===void 0?{...delegatedUsageFact(void 0,n),scope:{taskId:r}}:delegatedUsageFact(a.data.callId,n)}async function cancelTasksStep(e){"use step";return await withSessionStateDelta(e,cancelTasks)}async function cancelTasks(e){let t=readDurableSession(e.sessionState),n=readTaskTable(t.state),r=[],i=[],a={reason:e.reason,status:`cancelled`},o=[],s=e.turnCalls===!0?waitedCallRuns(t):[];for(let s of e.taskIds){let e=findTask(n,s),c=cancelTask(n,s);if(n=c.table,r.push(...taskSettled(e,c.settled,a)),(e?.resumable===!1||e?.kind===`agent`)&&r.push(e=>endTask(e,{outcome:a,taskId:s})),c.send!==void 0){if(e?.resumable===!1||e?.kind===`agent`){let e=runRequestIds(t,c.send.run.runId);i.push(t=>finishRun(t,{requestIds:e,taskId:s}))}o.push({ends:e?.resumable===!1||e?.kind===`agent`,run:c.send.run})}}let c=await commitTaskDecisions(e,saveTable(e.sessionState,t,n),{settles:r,withdraws:i}),[l]=await Promise.all([stopRuns(o.filter(e=>e.ends),{kind:`end`,reason:TASK_CANCEL_REASON},{waitForEnd:!1}),stopRuns(o.filter(e=>!e.ends),{kind:`cancel`,reason:TASK_CANCEL_REASON},{waitForEnd:!1}),stopRuns(s,{kind:`cancel`,reason:`The turn that called the tool was cancelled.`})]);if(l.length===0)return c;let u=readDurableSession(c.sessionState),d=readTaskTable(u.state),f=new Set(l);for(let e of d.tasks)e.run!==void 0&&f.has(e.run.runId)&&(d=finishTaskRun(d,e.id,e.run.runId));return{...c,sessionState:saveTable(c.sessionState,u,d)}}async function commitTaskDecisions(e,t,n){let r=await commitSessionStep({...e,sessionState:t},e=>n.withdraws.map(t=>t(e)),{origin:`relayed`});return await commitSessionStep({...e,...r},e=>n.settles.map(t=>t(e)),{origin:`own`})}function spent(e,t,n,r){return i=>({events:[spendFact(e.flatMap(e=>e(i).events),t,n,r)],turn:i.turn})}function taskSettled(e,t,n){return e===void 0?[]:[e=>settleTask(e,{calls:t,outcome:n})]}async function sendTaskRunCommands(e){for(let t of e.commands)await ignoreGoneTarget(resumeHook(e.run.hookToken,toControlMessage(t)))}function toControlMessage(e){switch(e.kind){case`cancel`:return{kind:`cancel`,reason:TASK_CANCEL_REASON};case`call`:return{call:e.call,kind:`call`}}}function toOutcome(e){switch(e.result.status){case`completed`:return{output:e.result.output,status:`completed`};case`failed`:return{error:failureMessage(e),status:`failed`};case`cancelled`:return{status:`cancelled`}}}function failureMessage(e){let t=workflowToolRunFailureOutput(e);if(typeof t==`string`)return t;let n=typeof t==`object`&&t?Reflect.get(t,`message`):void 0;return typeof n==`string`?n:JSON.stringify(t)}function countTaskRunUsage(e,t,n){let r=findTask(e,t)?.run;if(n.usage===void 0||r?.runId!==n.from.runId)return{table:e};let i=usageSince(n.usage,r.usage),a=i.inputTokens!==0||i.outputTokens!==0||i.cacheReadTokens!==0||i.cacheWriteTokens!==0||i.costUsd!==void 0&&(i.costUsd!==0||r.usage?.costUsd===void 0);return{table:recordTaskRunUsage(e,t,n.usage),spend:a?i:void 0}}function runRequestIds(e,t){return[...readHitlState(e.state).relays].filter(([,e])=>e.runId===t).map(([e])=>e)}function saveTable(e,t,n){return replaceDurableSessionSnapshot({session:writeTaskTable(t,n),state:e})}export{applyTaskRunMessage,cancelTasksStep,sendTaskRunCommands};

package/dist/src/execution/tasks/table.d.ts

@@ -3,7 +3,6 @@ import type { WorkflowToolRunCall } from "#execution/tools/workflow/messages.js"
 import type { SessionStateMap } from "#harness/types.js";
 import type { JsonValue } from "#shared/json.js";
 import type { TokenUsage } from "#shared/token-usage.js";
-import type { TaskCancelReason, TaskStartedStreamEvent } from "#protocol/message.js";
 /** At most this many tasks work at once in one session: a backstop normal use shouldn't reach. */
 export declare const MAX_WORKING_TASKS = 32;
 export interface TaskRunAddress {
@@ -36,7 +35,7 @@ export interface TaskRunCommands {
     readonly commands: readonly TaskRunCommand[];
     readonly run: TaskRunAddress;
 }
-/** How a task call ended, as `task.settled` reports it. */
+/** How a task call ended, as `call.settled` reports it. */
 export type TaskOutcome = {
     readonly output: JsonValue;
     readonly status: "completed";
@@ -63,7 +62,7 @@ export type TaskResult = Exclude<TaskOutcome, {
 export interface TaskRecord {
     readonly id: string;
     /** Whether the tool is an agent's, as `task.started` reports it. */
-    readonly kind: TaskStartedStreamEvent["data"]["kind"];
+    readonly kind: "agent" | "tool";
     /** The tool whose call started the task. */
     readonly name: string;
     /** A `serve` tool's task: it takes more calls by its id, and is idle between results. */
@@ -72,6 +71,8 @@ export interface TaskRecord {
     readonly calls: readonly TaskCall[];
     /** Results not yet delivered to the model. */
     readonly results: readonly TaskResult[];
+    /** A one-shot task cancelled while its run may still report messages. */
+    readonly cancelled?: boolean;
     /** The task's run, from its start until it finishes. */
     readonly run?: TaskRun;
     /** Commands issued before the run could take them, sent in order once it reports started. */
@@ -85,6 +86,10 @@ export declare function writeTaskTable<T extends {
     readonly state?: SessionStateMap;
 }>(session: T, table: TaskTable): T;
 export declare function findTask(table: TaskTable, taskId: string): TaskRecord | undefined;
+/** A task message belongs to a live, uncancelled run of this session. */
+export declare function isActiveTaskRun(table: TaskTable, taskId: string, runId: string): boolean;
+/** Only the recorded cancelled run can confirm its outcome and relinquish ownership. */
+export declare function isCancelledTaskRun(table: TaskTable, taskId: string, runId: string): boolean;
 export declare function isTaskWorking(record: TaskRecord): boolean;
 export declare function workingTasks(table: TaskTable): readonly TaskRecord[];
 /**
@@ -115,6 +120,11 @@ export declare function taskWaitResult(table: TaskTable, wake: {
  * `cancelled` means the caller cancels the working task.
  */
 export declare function taskCancelResult(table: TaskTable, taskId: string): TaskCancelResult | undefined;
+/**
+ * Every run the session started and hasn't seen finish: the calls a turn waits on, and every
+ * task's run, including cancelled runs that haven't confirmed yet.
+ */
+export declare function liveRuns(state: SessionStateMap | undefined): readonly TaskRunAddress[];
 /** Runs that may still be doing work, including cancelled runs that haven't confirmed yet. */
 export declare function liveTaskRuns(table: TaskTable): readonly TaskRunAddress[];
 /** Records a task for a call the model just made, with a new id. */
@@ -151,7 +161,7 @@ export declare function recordTaskCall(table: TaskTable, taskId: string, call: W
 };
 /**
  * Settles calls that share one outcome, as one reply does, in one step. Each
- * call settles once, with its own `task.settled`; the first outcome wins, so a
+ * call settles once, with its own `call.settled`; the first outcome wins, so a
  * call already settled, including one its owner cancelled, is dropped. The
  * model receives the outcome once, since every call it settles would repeat it.
  */
@@ -185,7 +195,8 @@ export interface TaskCancellation {
 /**
  * Cancels a task's current work: its calls settle as cancelled and never
  * report back, and a live run is told to stop. A run that hasn't started
- * holds the cancel. A resumable task stays available and becomes idle.
+ * holds the cancel only for a non-agent resumable task. Cancelling an agent or
+ * one-shot task ends it; another resumable task stays available and becomes idle.
  */
 export declare function cancelTask(table: TaskTable, taskId: string): TaskCancellation;
 /**
@@ -196,3 +207,5 @@ export declare function takeTaskResults(table: TaskTable): {
     readonly taken: readonly TaskRecord[];
     readonly table: TaskTable;
 };
+/** Why a task's current work was cancelled. */
+export type TaskCancelReason = "task-cancel" | "turn-cancelled" | "turn-ended";

package/dist/src/execution/tasks/table.js

@@ -1 +1 @@
-import{isNonEmptyString,isObject}from"#shared/guards.js";import{UNREADABLE_TASK_ERROR}from"#execution/tasks/render.js";const TASK_TABLE_STATE_KEY=`eve.taskTable`,MAX_WORKING_TASKS=32,EMPTY_TABLE={tasks:[]};function readTaskTable(e){let t=e?.[TASK_TABLE_STATE_KEY];return!isObject(t)||t.version!==1||!Array.isArray(t.tasks)?EMPTY_TABLE:{tasks:Array.from(t.tasks).flatMap(e=>{let t=decodeTaskRecord(e);return t===void 0?[]:[t]})}}function writeTaskTable(e,t){let n=pruneFinishedRecords(t.tasks);if(n.length===0){let t={...e.state};return delete t[TASK_TABLE_STATE_KEY],{...e,state:Object.keys(t).length===0?void 0:t}}let r={tasks:n,version:1};return{...e,state:{...e.state,[TASK_TABLE_STATE_KEY]:r}}}function findTask(e,t){return e.tasks.find(e=>e.id===t)}function isTaskWorking(e){return e.calls.length>0}function workingTasks(e){return e.tasks.filter(isTaskWorking)}function idleTasks(e){return e.tasks.filter(isResumableTaskIdle).slice(-10)}function isTaskAvailable(e,t){return e!==void 0&&e.resumable&&e.run!==void 0&&e.name===t}function tasksWithResults(e){return e.tasks.filter(e=>e.results.length>0)}function taskWaitResult(e,t){let n=tasksWithResults(e).map(e=>({id:e.id,status:e.results.at(-1).status})),r=workingTasks(e).map(e=>e.id);if(n.length>0||r.length===0)return{settled:n,status:`settled`,working:r};if(t.interrupted)return{status:`interrupt`,working:r};if(t.timedOut)return{status:`timeout`,working:r}}function taskCancelResult(e,t){let n=findTask(e,t);if(n!==void 0)return{resumable:n.resumable,status:isTaskWorking(n)?`cancelled`:`already_finished`,tool:n.name}}function liveTaskRuns(e){return e.tasks.flatMap(e=>e.run===void 0?[]:[toRunAddress(e.run)])}function createTask(e,t){let n=createTaskId(e,t.name),r={calls:[{callId:t.callId,turnId:t.turnId}],id:n,kind:t.kind,name:t.name,results:[],resumable:t.resumable};return{table:{...e,tasks:[...e.tasks,r]},taskId:n}}function removeTask(e,t){return{...e,tasks:e.tasks.filter(e=>e.id!==t)}}function recordTaskRun(e,t,n){return updateTask(e,t,e=>({...e,run:{...n,started:!1}}))}function markTaskRunStarted(e,t,n){let r=findTask(e,t);if(r?.run===void 0||r.run.runId!==n||r.run.started)return{table:e};let i={...r.run,started:!0},a=updateTask(e,t,e=>{let{held:t,...n}=e;return{...n,run:i}});return r.held===void 0?{table:a}:{held:{commands:r.held,run:toRunAddress(i)},table:a}}function recordTaskCall(e,t,n){let r=findTask(e,t);if(r?.run===void 0)return{table:e};let i={call:n,kind:`call`},a=r.run,o={callId:n.callId,turnId:n.turnId},s={...r,calls:[...r.calls,o]};a.started||(s={...s,held:[...r.held??[],i]});let c={...e,tasks:[...removeTask(e,t).tasks,s]};return a.started?{send:{commands:[i],run:toRunAddress(a)},table:c}:{table:c}}function settleTaskCalls(e,t){let n=new Set(t.callIds),r=(findTask(e,t.taskId)?.calls??[]).filter(e=>n.has(e.callId));if(r.length===0)return{settled:r,table:e};let{outcome:i}=t;return{settled:r,table:updateTask(e,t.taskId,e=>({...e,calls:e.calls.filter(e=>!n.has(e.callId)),results:i.status===`cancelled`?e.results:[...e.results,{...i,calls:r}]}))}}function settleRemainingTaskCalls(e,t,n){return settleTaskCalls(e,{callIds:findTask(e,t)?.calls.map(e=>e.callId)??[],outcome:n,taskId:t})}function recordTaskRunUsage(e,t,n){return updateTask(e,t,e=>e.run===void 0?e:{...e,run:{...e.run,usage:n}})}function finishTaskRun(e,t,n){return updateTask(e,t,e=>{if(e.run?.runId!==n)return e;let{held:t,run:r,...i}=e;return i})}function cancelTask(e,t){let n=findTask(e,t);if(n===void 0)return{settled:[],table:e};if(n.resumable)return cancelResumableTask(e,n);let r=cancelledCalls(n),i=n.run,a=updateTask(e,t,e=>{let t={...e,calls:[]};return i===void 0||i.started?t:{...t,held:[{kind:`cancel`}]}});return i===void 0||!i.started?{settled:r,table:a}:{send:cancelCommand(i),settled:r,table:a}}function cancelResumableTask(e,t){let n=t.run;if(n===void 0||!isTaskWorking(t))return{settled:[],table:e};let r=cancelledCalls(t),i=updateTask(e,t.id,e=>{let t={...e,calls:[]};return n.started?t:{...t,held:[{kind:`cancel`}]}});return n.started?{send:cancelCommand(n),settled:r,table:i}:{settled:r,table:i}}function cancelCommand(e){return{commands:[{kind:`cancel`}],run:toRunAddress(e)}}function takeTaskResults(e){let t=tasksWithResults(e),n=e.tasks.map(e=>t.includes(e)?{...e,results:[]}:e);return{table:{...e,tasks:n},taken:t}}function updateTask(e,t,n){return{...e,tasks:e.tasks.map(e=>e.id===t?n(e):e)}}function cancelledCalls(e){return e.run===void 0?[]:e.calls}function toRunAddress(e){return{hookToken:e.hookToken,runId:e.runId}}function createTaskId(e,t){for(;;){let n=crypto.getRandomValues(new Uint8Array(6)),r=`${t}-${Array.from(n,e=>`0123456789abcdefghjkmnpqrstvwxyz`[e%32]).join(``)}`;if(findTask(e,r)===void 0)return r}}function isResumableTaskIdle(e){return e.resumable&&e.run!==void 0&&!isTaskWorking(e)}function isFinishedRecord(e){return e.calls.length===0&&e.results.length===0&&e.run===void 0}function pruneFinishedRecords(e){let t=e.filter(isFinishedRecord),n=t.length-100;if(n<=0)return e;let r=new Set(t.slice(0,n));return e.filter(e=>!r.has(e))}function decodeTaskRecord(e){if(isTaskRecord(e))return e;if(isObject(e)&&isNonEmptyString(e.id)&&isNonEmptyString(e.name))return{calls:[],id:e.id,kind:e.kind===`agent`?`agent`:`tool`,name:e.name,results:[{error:UNREADABLE_TASK_ERROR,status:`failed`}],resumable:!1}}function isTaskRecord(e){return isObject(e)&&isNonEmptyString(e.id)&&isNonEmptyString(e.name)&&(e.kind===`agent`||e.kind===`tool`)&&typeof e.resumable==`boolean`&&Array.isArray(e.calls)&&Array.from(e.calls).every(isTaskCall)&&Array.isArray(e.results)&&Array.from(e.results).every(isTaskResult)&&(e.run===void 0||isTaskRun(e.run))&&(e.held===void 0||Array.isArray(e.held)&&Array.from(e.held).every(isTaskRunCommand))}function isTaskRunCommand(e){return isObject(e)?e.kind===`cancel`||e.kind===`call`&&isObject(e.call)&&isNonEmptyString(e.call.callId):!1}function isTaskResult(e){return!isObject(e)||e.calls!==void 0&&(!Array.isArray(e.calls)||!Array.from(e.calls).every(isTaskCall))?!1:e.status===`completed`?`output`in e:e.status===`failed`&&typeof e.error==`string`}function isTaskRun(e){return isObject(e)&&isNonEmptyString(e.runId)&&isNonEmptyString(e.hookToken)&&typeof e.started==`boolean`&&(e.usage===void 0||isObject(e.usage))}function isTaskCall(e){return isObject(e)&&isNonEmptyString(e.callId)&&typeof e.turnId==`string`}export{MAX_WORKING_TASKS,cancelTask,createTask,findTask,finishTaskRun,idleTasks,isTaskAvailable,isTaskWorking,liveTaskRuns,markTaskRunStarted,readTaskTable,recordTaskCall,recordTaskRun,recordTaskRunUsage,removeTask,settleRemainingTaskCalls,settleTaskCalls,takeTaskResults,taskCancelResult,taskWaitResult,tasksWithResults,workingTasks,writeTaskTable};
+import{isNonEmptyString,isObject}from"#shared/guards.js";import{UNREADABLE_TASK_ERROR}from"#execution/tasks/render.js";import{getBlockingWorkflowToolRuns}from"#harness/workflow-tool-runs.js";import{readRunningWork,writeRunningWork}from"#harness/running-work.js";const MAX_WORKING_TASKS=32,EMPTY_TABLE={tasks:[]};function readTaskTable(e){let t=readRunningWork(e).tasks;return t.length===0?EMPTY_TABLE:{tasks:t.flatMap(e=>{let t=decodeTaskRecord(e);return t===void 0?[]:[t]})}}function writeTaskTable(e,t){return{...e,state:writeRunningWork(e.state,{tasks:pruneFinishedRecords(t.tasks)})}}function findTask(e,t){return e.tasks.find(e=>e.id===t)}function isActiveTaskRun(e,t,n){let r=findTask(e,t);return r?.cancelled!==!0&&r?.run?.runId===n}function isCancelledTaskRun(e,t,n){let r=findTask(e,t);return r?.cancelled===!0&&r.run?.runId===n}function isTaskWorking(e){return e.calls.length>0}function workingTasks(e){return e.tasks.filter(isTaskWorking)}function idleTasks(e){return e.tasks.filter(isResumableTaskIdle).slice(-10)}function isTaskAvailable(e,t){return e!==void 0&&e.resumable&&!e.cancelled&&e.run!==void 0&&e.name===t}function tasksWithResults(e){return e.tasks.filter(e=>e.results.length>0)}function taskWaitResult(e,t){let n=tasksWithResults(e).map(e=>({id:e.id,status:e.results.at(-1).status})),r=workingTasks(e).map(e=>e.id);if(n.length>0||r.length===0)return{settled:n,status:`settled`,working:r};if(t.interrupted)return{status:`interrupt`,working:r};if(t.timedOut)return{status:`timeout`,working:r}}function taskCancelResult(e,t){let n=findTask(e,t);if(n!==void 0)return{resumable:n.resumable&&n.kind!==`agent`,status:isTaskWorking(n)?`cancelled`:`already_finished`,tool:n.name}}function liveRuns(e){return[...getBlockingWorkflowToolRuns(e).map(e=>e.address),...liveTaskRuns(readTaskTable(e))]}function liveTaskRuns(e){return e.tasks.flatMap(e=>e.run===void 0?[]:[toRunAddress(e.run)])}function createTask(e,t){let n=createTaskId(e,t.name),r={calls:[{callId:t.callId,turnId:t.turnId}],id:n,kind:t.kind,name:t.name,results:[],resumable:t.resumable};return{table:{...e,tasks:[...e.tasks,r]},taskId:n}}function removeTask(e,t){return{...e,tasks:e.tasks.filter(e=>e.id!==t)}}function recordTaskRun(e,t,n){return updateTask(e,t,e=>({...e,run:{...n,started:!1}}))}function markTaskRunStarted(e,t,n){let r=findTask(e,t);if(r?.run===void 0||r.run.runId!==n||r.run.started)return{table:e};let i={...r.run,started:!0},a=updateTask(e,t,e=>{let{held:t,...n}=e;return{...n,run:i}});return r.held===void 0?{table:a}:{held:{commands:r.held,run:toRunAddress(i)},table:a}}function recordTaskCall(e,t,n){let r=findTask(e,t);if(r?.run===void 0)return{table:e};let i={call:n,kind:`call`},a=r.run,o={callId:n.callId,turnId:n.turnId},s={...r,calls:[...r.calls,o]};a.started||(s={...s,held:[...r.held??[],i]});let c={...e,tasks:[...removeTask(e,t).tasks,s]};return a.started?{send:{commands:[i],run:toRunAddress(a)},table:c}:{table:c}}function settleTaskCalls(e,t){let n=new Set(t.callIds),r=(findTask(e,t.taskId)?.calls??[]).filter(e=>n.has(e.callId));if(r.length===0)return{settled:r,table:e};let{outcome:i}=t;return{settled:r,table:updateTask(e,t.taskId,e=>({...e,calls:e.calls.filter(e=>!n.has(e.callId)),results:i.status===`cancelled`?e.results:[...e.results,{...i,calls:r}]}))}}function settleRemainingTaskCalls(e,t,n){return settleTaskCalls(e,{callIds:findTask(e,t)?.calls.map(e=>e.callId)??[],outcome:n,taskId:t})}function recordTaskRunUsage(e,t,n){return updateTask(e,t,e=>e.run===void 0?e:{...e,run:{...e.run,usage:n}})}function finishTaskRun(e,t,n){return updateTask(e,t,e=>{if(e.run?.runId!==n)return e;let{held:t,run:r,...i}=e;return i})}function cancelTask(e,t){let n=findTask(e,t);if(n===void 0)return{settled:[],table:e};if(n.resumable&&n.kind!==`agent`)return cancelResumableTask(e,n);let r=cancelledCalls(n),i=n.run,a=updateTask(e,t,e=>({...e,calls:[],cancelled:!0,held:void 0}));return i===void 0||n.cancelled?{settled:r,table:a}:{send:cancelCommand(i),settled:r,table:a}}function cancelResumableTask(e,t){let n=t.run;if(n===void 0||!isTaskWorking(t))return{settled:[],table:e};let r=cancelledCalls(t),i=updateTask(e,t.id,e=>{let t={...e,calls:[]};return n.started?t:{...t,held:[{kind:`cancel`}]}});return n.started?{send:cancelCommand(n),settled:r,table:i}:{settled:r,table:i}}function cancelCommand(e){return{commands:[{kind:`cancel`}],run:toRunAddress(e)}}function takeTaskResults(e){let t=tasksWithResults(e),n=e.tasks.map(e=>t.includes(e)?{...e,results:[]}:e);return{table:{...e,tasks:n},taken:t}}function updateTask(e,t,n){return{...e,tasks:e.tasks.map(e=>e.id===t?n(e):e)}}function cancelledCalls(e){return e.run===void 0?[]:e.calls}function toRunAddress(e){return{hookToken:e.hookToken,runId:e.runId}}function createTaskId(e,t){for(;;){let n=crypto.getRandomValues(new Uint8Array(6)),r=`${t}-${Array.from(n,e=>`0123456789abcdefghjkmnpqrstvwxyz`[e%32]).join(``)}`;if(findTask(e,r)===void 0)return r}}function isResumableTaskIdle(e){return e.resumable&&!e.cancelled&&e.run!==void 0&&!isTaskWorking(e)}function isFinishedRecord(e){return e.calls.length===0&&e.results.length===0&&e.run===void 0}function pruneFinishedRecords(e){let t=e.filter(isFinishedRecord),n=t.length-100;if(n<=0)return e;let r=new Set(t.slice(0,n));return e.filter(e=>!r.has(e))}function decodeTaskRecord(e){if(isTaskRecord(e))return e;if(isObject(e)&&isNonEmptyString(e.id)&&isNonEmptyString(e.name))return{calls:[],id:e.id,kind:e.kind===`agent`?`agent`:`tool`,name:e.name,results:[{error:UNREADABLE_TASK_ERROR,status:`failed`}],resumable:!1}}function isTaskRecord(e){return isObject(e)&&isNonEmptyString(e.id)&&isNonEmptyString(e.name)&&(e.kind===`agent`||e.kind===`tool`)&&typeof e.resumable==`boolean`&&Array.isArray(e.calls)&&Array.from(e.calls).every(isTaskCall)&&Array.isArray(e.results)&&Array.from(e.results).every(isTaskResult)&&(e.run===void 0||isTaskRun(e.run))&&(e.held===void 0||Array.isArray(e.held)&&Array.from(e.held).every(isTaskRunCommand))}function isTaskRunCommand(e){return isObject(e)?e.kind===`cancel`||e.kind===`call`&&isObject(e.call)&&isNonEmptyString(e.call.callId):!1}function isTaskResult(e){return!isObject(e)||e.calls!==void 0&&(!Array.isArray(e.calls)||!Array.from(e.calls).every(isTaskCall))?!1:e.status===`completed`?`output`in e:e.status===`failed`&&typeof e.error==`string`}function isTaskRun(e){return isObject(e)&&isNonEmptyString(e.runId)&&isNonEmptyString(e.hookToken)&&typeof e.started==`boolean`&&(e.usage===void 0||isObject(e.usage))}function isTaskCall(e){return isObject(e)&&isNonEmptyString(e.callId)&&typeof e.turnId==`string`}export{MAX_WORKING_TASKS,cancelTask,createTask,findTask,finishTaskRun,idleTasks,isActiveTaskRun,isCancelledTaskRun,isTaskAvailable,isTaskWorking,liveRuns,liveTaskRuns,markTaskRunStarted,readTaskTable,recordTaskCall,recordTaskRun,recordTaskRunUsage,removeTask,settleRemainingTaskCalls,settleTaskCalls,takeTaskResults,taskCancelResult,taskWaitResult,tasksWithResults,workingTasks,writeTaskTable};

package/dist/src/execution/tasks/task-id-input.js

@@ -1 +1 @@
-import{displayTitle}from"#shared/display-name.js";import{firstSentence}from"#shared/presentation-text.js";import{isToolSchema,withOptionalStringProperty}from"#tools/schema.js";import{AGENT_SERVE_TOOL_DESCRIPTION,SERVE_TOOL_DESCRIPTION,TASK_ID_INPUT_DESCRIPTION}from"#execution/tasks/render.js";import{AGENT_TOOL_NAME}from"#tools/framework/agent-contract.js";import{isAgentTool}from"#execution/tasks/tool-entry-point.js";const TASK_ID_INPUT=`taskId`;function withTaskIdSchema(e){return withOptionalStringProperty(e,{description:TASK_ID_INPUT_DESCRIPTION,name:TASK_ID_INPUT})}function withTaskIdInput(e){let t=e.inputSchema;if(!isToolSchema(t))throw Error(`Tool "${e.name}" has no input schema eve can add taskId to.`);let n=isAgentTool(e),r={...e,description:appendSentence(e.description,n?AGENT_SERVE_TOOL_DESCRIPTION:SERVE_TOOL_DESCRIPTION),inputSchema:withTaskIdSchema(t)};return!n||e.label?.start!==void 0?r:{...r,label:{...e.label,start:t=>agentCallLabel(e.name,t)}}}function agentCallLabel(e,t){let n=typeof t==`object`&&t?t.message:void 0,r=typeof n==`string`?firstSentence(n):void 0;return r===void 0?displayTitle(e):e===AGENT_TOOL_NAME?r:`${displayTitle(e)}: ${r}`}function splitTaskIdInput(e){let{[TASK_ID_INPUT]:t,...n}=e;return typeof t!=`string`||t===``?{input:n}:{input:n,taskId:t}}function appendSentence(e,t){let n=e.trimEnd();return n===``?t:`${n} ${t}`}export{TASK_ID_INPUT,splitTaskIdInput,withTaskIdInput,withTaskIdSchema};
+import{displayTitle}from"#protocol/session-projection/display-name.js";import{isToolSchema,withOptionalStringProperty}from"#tools/schema.js";import{AGENT_SERVE_TOOL_DESCRIPTION,SERVE_TOOL_DESCRIPTION,TASK_ID_INPUT_DESCRIPTION}from"#execution/tasks/render.js";import{AGENT_TOOL_NAME}from"#tools/framework/agent-contract.js";import{isAgentTool}from"#execution/tasks/tool-entry-point.js";import{firstSentence}from"#shared/presentation-text.js";const TASK_ID_INPUT=`taskId`;function withTaskIdSchema(e){return withOptionalStringProperty(e,{description:TASK_ID_INPUT_DESCRIPTION,name:TASK_ID_INPUT})}function withTaskIdInput(e){let t=e.inputSchema;if(!isToolSchema(t))throw Error(`Tool "${e.name}" has no input schema eve can add taskId to.`);let n=isAgentTool(e),r={...e,description:appendSentence(e.description,n?AGENT_SERVE_TOOL_DESCRIPTION:SERVE_TOOL_DESCRIPTION),inputSchema:withTaskIdSchema(t)};return!n||e.label?.start!==void 0?r:{...r,label:{...e.label,start:t=>agentCallLabel(e.name,t)}}}function agentCallLabel(e,t){let n=typeof t==`object`&&t?t.message:void 0,r=typeof n==`string`?firstSentence(n):void 0;return r===void 0?displayTitle(e):e===AGENT_TOOL_NAME?r:`${displayTitle(e)}: ${r}`}function splitTaskIdInput(e){let{[TASK_ID_INPUT]:t,...n}=e;return typeof t!=`string`||t===``?{input:n}:{input:n,taskId:t}}function appendSentence(e,t){let n=e.trimEnd();return n===``?t:`${n} ${t}`}export{TASK_ID_INPUT,splitTaskIdInput,withTaskIdInput,withTaskIdSchema};

package/dist/src/execution/terminal-session-completion-step.d.ts

@@ -2,13 +2,23 @@ type HarnessTurnRef = {
     readonly id: string;
     readonly sequence: number;
 };
+import type { ControlDelivery } from "#harness/types.js";
+import type { ControlSettlement } from "#harness/facts.js";
 import type { TokenUsage } from "#shared/token-usage.js";
-/** Emits a terminal `session.completed` outside a turn. */
+import type { SessionProjection } from "#protocol/session-projection.js";
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+/** Emits a terminal `session.ended` outside a turn. */
 export declare function emitTerminalSessionCompletionStep(input: {
     readonly sessionWritable: WritableStream<Uint8Array>;
     readonly serializedContext: Record<string, unknown>;
     /** The session's last turn, reported to channel handlers as `ctx.session.turn`. */
     readonly turn?: HarnessTurnRef;
     readonly usage: TokenUsage | undefined;
+    /** The session's last checkpointed projection. */
+    readonly projection?: SessionProjection;
+    readonly sessionState?: DurableSessionState;
+    /** The reset control that ends the session, when it named its delivery. */
+    readonly control?: ControlDelivery;
+    readonly settles?: readonly ControlSettlement[];
 }): Promise<void>;
 export {};

package/dist/src/execution/terminal-session-completion-step.js

@@ -1 +1 @@
-import{publishTerminalSessionEvent}from"#execution/publish-session-events.js";import{sessionCompleted}from"#harness/session-machine/transitions.js";async function emitTerminalSessionCompletionStep(e){"use step";await publishTerminalSessionEvent({...e,event:sessionCompleted(e.usage)})}export{emitTerminalSessionCompletionStep};
+import{publishTerminalSessionEvent}from"#execution/publish-session-events.js";async function emitTerminalSessionCompletionStep(e){"use step";let{control:t,settles:n,...r}=e;await publishTerminalSessionEvent({...r,ending:{control:t,settles:n,outcome:`completed`}})}export{emitTerminalSessionCompletionStep};

package/dist/src/execution/terminal-session-failure-step.d.ts

@@ -1,9 +1,14 @@
 import type { TokenUsage } from "#shared/token-usage.js";
-/** Emits a terminal `session.failed` to the adapter and durable stream. */
+import type { SessionProjection } from "#protocol/session-projection.js";
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+/** Emits a terminal `session.ended` to the adapter and durable stream. */
 export declare function emitTerminalSessionFailureStep(input: {
     readonly error: unknown;
     readonly sessionWritable: WritableStream<Uint8Array>;
     readonly serializedContext: Record<string, unknown>;
     readonly turnId?: string;
     readonly usage: TokenUsage | undefined;
+    /** The session's last checkpointed projection. */
+    readonly projection?: SessionProjection;
+    readonly sessionState?: DurableSessionState;
 }): Promise<void>;

package/dist/src/execution/terminal-session-failure-step.js

@@ -1 +1 @@
-import{createLogger,formatError}from"#internal/logging.js";import{publishTerminalSessionEvent}from"#execution/publish-session-events.js";import{sessionFailed}from"#harness/session-machine/transitions.js";import{summarizeKnownError}from"#harness/semantic-errors/index.js";const log=createLogger(`execution.workflow-entry`);async function emitTerminalSessionFailureStep(e){"use step";let t=formatError(e.error),n=summarizeKnownError(e.error),r=t;if(n!==null){let e={...t,message:n.message,name:n.name,semanticErrorId:n.id};r=n.hint===void 0?e:{...e,hint:n.hint}}let i=typeof r.name==`string`?r.name:`WORKFLOW_EXECUTION_FAILED`,a=typeof r.message==`string`?r.message:String(e.error),o=e.serializedContext[`eve.sessionId`]??``;log.error(`workflow loop threw — emitting terminal session.failed`,{sessionId:o,errorId:typeof r.errorId==`string`?r.errorId:void 0,code:i}),await publishTerminalSessionEvent({errorId:typeof r.errorId==`string`?r.errorId:void 0,event:sessionFailed({code:i,details:r,message:a,sessionId:o,usage:e.usage}),sessionWritable:e.sessionWritable,serializedContext:e.serializedContext,turnId:e.turnId})}export{emitTerminalSessionFailureStep};
+import{createLogger}from"#internal/logging.js";import{publishTerminalSessionEvent}from"#execution/publish-session-events.js";import{errorInfoOf}from"#harness/facts.js";import{summarizeFailure}from"#execution/failure-summary.js";const log=createLogger(`execution.workflow-entry`);async function emitTerminalSessionFailureStep(e){"use step";let{code:t,details:n,message:r}=summarizeFailure(e.error,`WORKFLOW_EXECUTION_FAILED`),i=e.serializedContext[`eve.sessionId`]??``;log.error(`workflow loop threw — ending the session failed`,{sessionId:i,errorId:typeof n.errorId==`string`?n.errorId:void 0,code:t}),await publishTerminalSessionEvent({ending:{cause:e.turnId===void 0?void 0:{turnId:e.turnId},error:errorInfoOf({code:t,details:n,message:r}),outcome:`failed`},errorId:typeof n.errorId==`string`?n.errorId:void 0,projection:e.projection,sessionState:e.sessionState,serializedContext:e.serializedContext,sessionWritable:e.sessionWritable,turnId:e.turnId})}export{emitTerminalSessionFailureStep};

package/dist/src/execution/terminate-child-sessions-step.d.ts

@@ -1,8 +1,12 @@
 import { type DurableSessionState } from "#execution/durable-session-store.js";
 /**
- * Session end ends every task, including cancelled runs that haven't
+ * Session end ends every run the session started, including cancelled runs that haven't
  * confirmed yet. Each run ends the agent sessions it opened.
  */
 export declare function terminateChildSessionsStep(input: {
     readonly sessionState: DurableSessionState;
 }): Promise<void>;
+export declare function reportChildSessionTeardownFailureStep(input: {
+    readonly error: unknown;
+    readonly parentSessionId: string;
+}): Promise<void>;

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

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{readDurableSession}from"#execution/durable-session-store.js";import{cancelWorkflowToolRun}from"#execution/tools/workflow/cancel.js";import{liveTaskRuns,readTaskTable}from"#execution/tasks/table.js";const log=createLogger(`execution.terminate-child-sessions`);async function terminateChildSessionsStep(e){"use step";let t;try{t=readDurableSession(e.sessionState)}catch(t){logError(log,`failed to read child sessions for termination`,t,{parentSessionId:e.sessionState.sessionId});return}await stopTaskRuns(t)}async function stopTaskRuns(e){let t=liveTaskRuns(readTaskTable(e.state));await Promise.all(t.map(e=>cancelWorkflowToolRun(e,{kind:`end`,reason:`The session ended.`})))}export{terminateChildSessionsStep};
+import{createLogger,logError}from"#internal/logging.js";import{readDurableSession}from"#execution/durable-session-store.js";import{liveRuns}from"#execution/tasks/table.js";import{stopRuns}from"#execution/stop-runs.js";const log=createLogger(`execution.terminate-child-sessions`);async function terminateChildSessionsStep(e){"use step";let t;try{t=liveRuns(readDurableSession(e.sessionState).state)}catch(t){logError(log,`failed to read child sessions for termination`,t,{parentSessionId:e.sessionState.sessionId});return}await stopRuns(t.map(e=>({ends:!0,run:e})),{kind:`end`,reason:`The session ended.`})}async function reportChildSessionTeardownFailureStep(e){"use step";logError(log,`failed to terminate child sessions`,e.error,{parentSessionId:e.parentSessionId})}export{reportChildSessionTeardownFailureStep,terminateChildSessionsStep};

package/dist/src/execution/tools/agent-router-workflow.js

@@ -1 +1 @@
-import{decide}from"#ai/decide.js";async function runAgentRouterTask(e,t){"use workflow";let n=await chooseTarget(e.message,descriptions(t),t.abortSignal),{message:r,status:i}=await(await t.agent(n).send(e.message,{signal:t.abortSignal})).result();if(i===`failed`)throw Error(`Agent "${n}" failed to handle the task.`);return r??null}async function chooseTarget(e,t,n){"use step";let r=Object.keys(t);if(r.length===0)throw Error(`agentRouter requires at least one available agent with a description.`);return r.length===1?r[0]:(await decide({abortSignal:n,state:{message:e},questions:{route:{type:`choice`,instructions:`Which subagent should handle this task?`,criteria:t}}})).answers.route.choice}function descriptions(e){return Object.fromEntries(Object.entries(e.agents).flatMap(([e,t])=>{let n=t.description.trim();return n.length===0?[]:[[e,n]]}))}runAgentRouterTask.workflowId=`workflow//eve@0.83.2//runAgentRouterTask`;export{runAgentRouterTask};
+import{decide}from"#ai/decide.js";async function runAgentRouterTask(e,t){"use workflow";let n=await chooseTarget(e.message,descriptions(t),t.abortSignal),{reply:r,status:i}=await(await t.agent(n).send(e.message,{signal:t.abortSignal})).result();if(i===`failed`)throw Error(`Agent "${n}" failed to handle the task.`);return r??null}async function chooseTarget(e,t,n){"use step";let r=Object.keys(t);if(r.length===0)throw Error(`agentRouter requires at least one available agent with a description.`);return r.length===1?r[0]:(await decide({signal:n,state:{message:e},questions:{route:{type:`choice`,instructions:`Which subagent should handle this task?`,criteria:t}}})).answers.route.choice}function descriptions(e){return Object.fromEntries(Object.entries(e.agents).flatMap(([e,t])=>{let n=t.description.trim();return n.length===0?[]:[[e,n]]}))}runAgentRouterTask.workflowId=`workflow//eve@0.84.0//runAgentRouterTask`;export{runAgentRouterTask};

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

@@ -1,11 +1,10 @@
-import type { SessionAuthContext } from "#channel/types.js";
 import type { WorkflowAskRoute } from "#harness/hitl/relays.js";
-import type { InputResponse } from "#shared/input.js";
-import type { ToolInputResponseResponder } from "#tools/definition.js";
-export declare function toToolInputResponseResponder(auth: SessionAuthContext | null | undefined): ToolInputResponseResponder | undefined;
+import type { Answer } from "#shared/input.js";
+import type { Principal } from "#protocol/session-events/envelope.js";
+export { principalOf } from "#execution/session/delivery-facts.js";
 /**
  * Sends the answers the session accepted to the asking run's control hook,
  * the same ordered inbox its commands use, so an answer the session accepted
  * before an interrupt or cancel reaches the body before them.
  */
-export declare function sendWorkflowAskAnswers(route: WorkflowAskRoute, responses: readonly InputResponse[] | undefined, responder?: ToolInputResponseResponder): Promise<void>;
+export declare function sendWorkflowAskAnswers(route: WorkflowAskRoute, responses: readonly Answer[] | undefined, responder?: Principal): Promise<void>;

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

@@ -1 +1 @@
-import{resumeHook}from"#internal/workflow/runtime.js";function toToolInputResponseResponder(e){return e==null?void 0:{authenticator:e.authenticator,principalId:e.principalId,principalType:e.principalType}}async function sendWorkflowAskAnswers(e,t,n){for(let r of t??[]){let{optionId:t,text:i}=r,a=n===void 0?{optionId:t,status:`answered`,text:i}:{optionId:t,responder:n,status:`answered`,text:i},o={kind:`answer`,requestId:r.requestId,response:a};await resumeHook(e.control,o)}}export{sendWorkflowAskAnswers,toToolInputResponseResponder};
+import{resumeHook}from"#internal/workflow/runtime.js";import{principalOf}from"#execution/session/delivery-facts.js";async function sendWorkflowAskAnswers(e,t,n){for(let r of t??[]){let{optionId:t,text:i}=r,a=n===void 0?{optionId:t,status:`answered`,text:i}:{optionId:t,responder:n,status:`answered`,text:i},o={kind:`answer`,requestId:r.interactionId,response:a};await resumeHook(e.control,o)}}export{principalOf,sendWorkflowAskAnswers};

package/dist/src/execution/tools/workflow/apply-run-messages-step.d.ts

@@ -4,7 +4,7 @@ import { type TaskRunMessage } from "#execution/tasks/steps.js";
 import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
 /** A run's message the session applies as it reads it, which answers no call a turn waits on. */
 export type AppliedRunMessage = Extract<WorkflowToolRunMessage, {
-    readonly kind: "agent-started" | "report";
+    readonly kind: "agent-started" | "agent-sent" | "report";
 }> | (TaskRunMessage & {
     readonly from: {
         readonly taskId: string;

package/dist/src/execution/tools/workflow/apply-run-messages-step.js

@@ -1 +1 @@
-import{createActionPartialEvent,createAgentStartedEvent}from"#protocol/message.js";import{publishSessionEvents}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{applyTaskRunMessage}from"#execution/tasks/steps.js";import{createRuntimeToolResultFromValue}from"#harness/action-result-helpers.js";function workflowToolRunReportEvent(e,t){return createActionPartialEvent({result:createRuntimeToolResultFromValue({callId:e.callId,output:t,toolName:e.toolName}),sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId})}function agentStartedEvent(e,{from:t,session:n}){return createAgentStartedEvent({callId:t.callId,name:n.name,parentSessionId:e,remote:n.kind===`remote`?{url:n.url,...n.resolverId!==void 0&&{resolverId:n.resolverId}}:void 0,sessionId:n.sessionId,...t.taskId!==void 0&&{taskId:t.taskId},turnId:t.turnId})}async function applyRunMessagesStep(e){"use step";return await withSessionStateDelta(e,async({canCancelTurn:e,messages:t,...n})=>{let r=n,i=!1,a=[],publish=async()=>{if(a.length===0)return;let t=await publishSessionEvents(r,a,{canCancelTurn:e});r={...r,serializedContext:t.serializedContext,sessionState:t.sessionState},i||=t.cancelled,a=[]};for(let e of t)e.kind===`agent-started`?a.push(agentStartedEvent(r.sessionState.sessionId,e)):e.kind===`report`?a.push(workflowToolRunReportEvent(e.from,e.update)):(await publish(),r={...r,...await applyTaskRunMessage({...r,message:e})});return await publish(),{cancelled:i,serializedContext:r.serializedContext,sessionState:r.sessionState}})}export{applyRunMessagesStep};
+import{createEveSessionStreamRoutePath,createEveSubagentStreamRoutePath}from"#protocol/routes.js";import{parseJsonValue}from"#shared/json.js";import{storedProjection}from"#harness/session-machine/view.js";import{stopLateAgentSessionStep}from"#execution/agent-sessions/steps.js";import{readDurableSession}from"#execution/durable-session-store.js";import{publishSessionEvents}from"#execution/publish-session-events.js";import"#execution/session/state-delta.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{isActiveTaskRun,readTaskTable}from"#execution/tasks/table.js";import{callProgress}from"#harness/call-facts.js";import{applyTaskRunMessage}from"#execution/tasks/steps.js";import{recordRemoteChildBinding}from"#execution/child-binding.js";function workflowToolRunReportEvents(e,t,n){let{view:r}=storedProjection(readDurableSession(e.sessionState).state),i=r?.calls[t.callId];return r!==void 0&&(i===void 0||i.status===`settled`)?[]:[callProgress(t.callId,n)]}async function childOpenedEvent(e,{from:t,session:n}){let r=n.kind===`remote`?createEveSubagentStreamRoutePath({callId:t.callId,childSessionId:n.sessionId,parentSessionId:e}):createEveSessionStreamRoutePath(n.sessionId);if(n.kind===`remote`){let i={callId:t.callId,childSessionId:n.sessionId,name:n.name,streamPath:r,url:n.url};n.resolverId!==void 0&&(i.resolverId=n.resolverId),n.dynamicBinding!==void 0&&(i.dynamicBinding=parseJsonValue(n.dynamicBinding)),n.earlierProtocol!==void 0&&(i.earlierProtocol=n.earlierProtocol),await recordRemoteChildBinding(e,i)}let i={turnId:t.turnId};return t.taskId!==void 0&&(i.taskId=t.taskId),{data:{name:n.name,owner:{callId:t.callId},sessionId:n.sessionId,stream:r},scope:i,type:`child.opened`}}function childSentEvent({deliveryId:e,from:t,sessionId:n}){let r={turnId:t.turnId};return t.taskId!==void 0&&(r.taskId=t.taskId),{data:{callId:t.callId,childDeliveryId:e,sessionId:n},scope:r,type:`child.sent`}}async function applyRunMessagesStep(e){"use step";return await withSessionStateDelta(e,async({canCancelTurn:e,messages:t,...n})=>{let r=n,i=!1,a=[],publish=async()=>{if(a.length===0)return;let t=await publishSessionEvents(r,a,{canCancelTurn:e});r={...r,serializedContext:t.serializedContext,sessionState:t.sessionState},i||=t.cancelled,a=[]};for(let e of t){let t=e.from.taskId,n=readDurableSession(r.sessionState).state,i=t!==void 0&&(!isActiveTaskRun(readTaskTable(n),t,e.from.runId)||storedProjection(n).view?.tasks[t]?.status===`ended`);e.kind===`agent-started`?i?await stopLateAgentSessionStep({address:e.session,context:e.context,key:e.from.runId}):a.push(await childOpenedEvent(r.sessionState.sessionId,e)):e.kind===`agent-sent`?i||a.push(childSentEvent(e)):e.kind===`report`?i||a.push(...workflowToolRunReportEvents(r,e.from,e.update)):(await publish(),r={...r,...await applyTaskRunMessage({...r,message:e})})}return await publish(),{cancelled:i,serializedContext:r.serializedContext,sessionState:r.sessionState}})}export{applyRunMessagesStep};

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

@@ -2,7 +2,7 @@ import type { SessionAuth } from "#context/session-context.js";
 import type { AgentSessionContext } from "#execution/agent-sessions/context.js";
 import type { WorkflowToolRunAskDecision, WorkflowToolRunRef } from "#execution/tools/workflow/messages.js";
 import type { WorkflowToolRunInbox } from "#execution/tools/workflow/owner.js";
-import type { ToolContext, ToolInputRequest, ToolInputRequestOptions, ToolInputResponse } from "#tools/definition.js";
+import type { ToolContext, ToolQuestion, ToolAskOptions, ToolAnswer } from "#tools/definition.js";
 /**
  * The run a workflow body belongs to. Members that describe a call describe
  * the one the run serves now, which a `serve` task changes with each call, so
@@ -45,7 +45,7 @@ export declare class WorkflowToolRunAsks {
      * the run. `send` sends the request and returns how to send its withdrawal.
      */
     open(send: (requestId: string) => () => Promise<void>): {
-        readonly answer: Promise<ToolInputResponse>;
+        readonly answer: Promise<ToolAnswer>;
         readonly requestId: string;
     };
     /**
@@ -73,4 +73,4 @@ export declare class WorkflowToolRunAsks {
  * asks the session to withdraw the question. The answer is `cancelled` only if
  * the session withdrew it before it accepted a person's answer.
  */
-export declare function ask(ctx: Pick<ToolContext, "abortSignal">, request: ToolInputRequest, options?: ToolInputRequestOptions): Promise<ToolInputResponse>;
+export declare function ask(ctx: Pick<ToolContext, "abortSignal">, request: ToolQuestion, options?: ToolAskOptions): Promise<ToolAnswer>;

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

@@ -1 +1 @@
-import{parseJsonValue}from"#shared/json.js";import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";import{withToolOutputSerializationError}from"#harness/tool-output-serialization.js";const INTERRUPTED_OUTPUT={interrupted:!0};var WorkflowCallSignals=class{body=new AbortController;run=new AbortController;asks;constructor(e){this.asks=e}get abortSignal(){return this.body.signal}get runSignal(){return this.run.signal}get interrupted(){return this.body.signal.aborted&&!this.run.signal.aborted}get unwinding(){return this.run.signal.aborted}apply(e){switch(e.kind){case`cancel`:case`end`:this.asks.cancelAll(),this.run.abort(new WorkflowToolRunCancelledError(e.reason)),this.body.abort(this.run.signal.reason);return;case`interrupt`:this.body.abort(new WorkflowToolRunInterruptedError);return;case`call`:return}}};function startCallBody(e){let t=createWorkflowBodyRef(e),n=new WorkflowToolRunAsks(t.runId),r=new WorkflowCallSignals(n),i={agentContext:e.agentContext,asks:n,auth:e.session.auth,control:e.hookToken,from:t,owner:e.owner},a=createRunUsageTally(),o=createAgentSessions(i,a),s=createCallContext(e,r,o.open);return attachWorkflowToolRunContext(s,i),{asks:n,close:o.close,control:r,outcome:executeCallBody(e,s,r,t),usage:a}}async function executeCallBody(e,t,n,r){try{let n=findStubTarget(e.agentContext.toolStubs,e.toolName);if(n!==void 0){let t=await callToolStubStep(n.scope,{callId:stubCallId(e.session.id,e.session.turn.id,e.callId),tool:n.tool,input:e.input});if(t.kind===`error`)throw Error(t.error);if(t.kind===`stub`)return{output:toolStubOutput(t.outcome),status:`completed`}}let i=resolveWorkflowEntryPoint(e)(e.executeInput??e.input,t),a;if(!isAsyncIterable(i))a=await i;else{let t=i[Symbol.asyncIterator](),n,o=await t.next();for(;o.done!==!0;)n=o.value,await e.owner.send({from:r,kind:`report`,update:o.value}),o=await t.next();a=o.value??n}return{output:toWorkflowOutput(e,a),status:`completed`}}catch(e){return n.interrupted?{output:INTERRUPTED_OUTPUT,status:`completed`}:toFailedOutcome(e,n.runSignal)}}function toWorkflowOutput(e,t){return withToolOutputSerializationError({boundary:`execute`,toolCallId:e.callId,toolName:e.toolName},()=>parseJsonValue(t??null))}function toFailedOutcome(e,t){if(t.aborted){let{reason:e}=t;return{reason:e instanceof Error?e.message:String(e??``),status:`cancelled`}}return{error:normalizeSerializableError(e),status:`failed`}}function createWorkflowBodyRef(e){let t={callId:e.callId,input:e.input,runId:e.runId??getWorkflowMetadata().workflowRunId,sequence:e.session.turn.sequence,stepIndex:e.stepIndex,toolName:e.toolName,turnId:e.session.turn.id};return e.entry.entryPoint===`execute`?t:{...t,taskId:e.entry.taskId}}function resolveWorkflowEntryPoint(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 createSharedContext(e,t,n){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{agent:t,ask:n,getSandbox:()=>unavailable(`getSandbox()`,`pass ctx directly to a "use step" helper to open the session's sandbox`),getToken:()=>unavailable(`getToken()`,`pass ctx directly to a "use step" helper to resolve credentials`),requireAuth:()=>unavailable(`requireAuth()`,`pass ctx directly to a "use step" helper to request authorization`),toolName:e.toolName}}function createAgentsView(e){return Object.freeze(Object.fromEntries(Object.entries(e.agents).map(([e,t])=>[e,Object.freeze({...t})])))}function createCallContext(e,t,n){let r={...createSharedContext(e,n,(e,t)=>ask(r,e,t)),abortSignal:t.abortSignal,agents:createAgentsView(e.agentContext),callId:e.callId,session:e.session};return r}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}},WorkflowToolRunInterruptedError=class extends Error{constructor(){super(`A new message arrived while the turn waited on this call.`),this.name=`WorkflowToolRunInterruptedError`}};export{WorkflowToolRunCancelledError,WorkflowToolRunInterruptedError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,startCallBody,toFailedOutcome,toWorkflowOutput};
+import{parseJsonValue}from"#shared/json.js";import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{readRegisteredWorkflow}from"#execution/workflow-registry.js";import{withToolOutputSerializationError}from"#harness/tool-output-serialization.js";const INTERRUPTED_OUTPUT={interrupted:!0};var WorkflowCallSignals=class{body=new AbortController;run=new AbortController;asks;constructor(e){this.asks=e}get abortSignal(){return this.body.signal}get runSignal(){return this.run.signal}get interrupted(){return this.body.signal.aborted&&!this.run.signal.aborted}get unwinding(){return this.run.signal.aborted}apply(e){switch(e.kind){case`cancel`:case`end`:this.asks.cancelAll(),this.run.abort(new WorkflowToolRunCancelledError(e.reason)),this.body.abort(this.run.signal.reason);return;case`interrupt`:this.body.abort(new WorkflowToolRunInterruptedError);return;case`call`:return}}};function startCallBody(e){let t=createWorkflowBodyRef(e),n=new WorkflowToolRunAsks(t.runId),r=new WorkflowCallSignals(n),i={agentContext:e.agentContext,asks:n,auth:e.session.auth,control:e.hookToken,from:t,owner:e.owner},a=createRunUsageTally(),o=createAgentSessions(i,a),s=createCallContext(e,r,o.open);return attachWorkflowToolRunContext(s,i),{asks:n,close:o.close,control:r,outcome:executeCallBody(e,s,r,t),usage:a}}async function executeCallBody(e,t,n,r){try{let n=findStubTarget(e.agentContext.toolStubs,e.toolName);if(n!==void 0){let t=await callToolStubStep(n.scope,{callId:stubCallId(e.session.id,e.session.turn.id,e.callId),tool:n.tool,input:e.input});if(t.kind===`error`)throw Error(t.error);if(t.kind===`stub`)return{output:toolStubOutput(t.outcome),status:`completed`}}let i=resolveWorkflowEntryPoint(e)(e.executeInput??e.input,t),a;if(!isAsyncIterable(i))a=await i;else{let t=i[Symbol.asyncIterator](),n,o=await t.next();for(;o.done!==!0;)n=o.value,await e.owner.send({from:r,kind:`report`,update:o.value}),o=await t.next();a=o.value??n}return{output:toWorkflowOutput(e,a),status:`completed`}}catch(e){return n.interrupted?{output:INTERRUPTED_OUTPUT,status:`completed`}:toFailedOutcome(e,n.runSignal)}}function toWorkflowOutput(e,t){return withToolOutputSerializationError({boundary:`execute`,toolCallId:e.callId,toolName:e.toolName},()=>parseJsonValue(t??null))}function toFailedOutcome(e,t){if(t.aborted){let{reason:e}=t;return{reason:e instanceof Error?e.message:String(e??``),status:`cancelled`}}return{error:normalizeSerializableError(e),status:`failed`}}function createWorkflowBodyRef(e){let t={callId:e.callId,input:e.input,runId:e.runId??getWorkflowMetadata().workflowRunId,sequence:e.session.turn.sequence,stepIndex:e.stepIndex,toolName:e.toolName,turnId:e.session.turn.id};return e.entry.entryPoint===`execute`?t:{...t,taskId:e.entry.taskId}}function resolveWorkflowEntryPoint(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 createSharedContext(e,t,n){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{agent:t,ask:n,getSandbox:()=>unavailable(`getSandbox()`,`pass ctx directly to a "use step" helper to open the session's sandbox`),getToken:()=>unavailable(`getToken()`,`pass ctx directly to a "use step" helper to resolve credentials`),requireAuth:()=>unavailable(`requireAuth()`,`pass ctx directly to a "use step" helper to request authorization`),toolName:e.toolName}}function createAgentsView(e){return Object.freeze(Object.fromEntries(Object.entries(e.agents).map(([e,t])=>[e,Object.freeze({...t})])))}function createCallContext(e,t,n){let r={...createSharedContext(e,n,(e,t)=>ask(r,e,t)),abortSignal:t.abortSignal,agents:createAgentsView(e.agentContext),callId:e.callId,session:e.session};return r}function isAsyncIterable(e){return typeof e==`object`&&!!e&&typeof e[Symbol.asyncIterator]==`function`}var WorkflowToolRunCancelledError=class extends Error{constructor(e){super(e),this.name=`WorkflowToolRunCancelledError`}},WorkflowToolRunInterruptedError=class extends Error{constructor(){super(`A new message arrived while the turn waited on this call.`),this.name=`WorkflowToolRunInterruptedError`}};export{WorkflowToolRunCancelledError,WorkflowToolRunInterruptedError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,startCallBody,toFailedOutcome,toWorkflowOutput};

package/dist/src/execution/tools/workflow/harness-definition.js

@@ -1 +1 @@
-import{UNSPECIFIED_INPUT_SCHEMA,toInputSchema,toOutputSchema}from"#tools/schema.js";import{workflowIdForHandling}from"#runtime/subagents/workflow-reference.js";import{entryPointOf}from"#execution/tasks/tool-entry-point.js";import{withTaskIdInput}from"#execution/tasks/task-id-input.js";function createWorkflowToolHarnessDefinition(e){return{...entryPointOf(e.definition)===`serve`?withTaskIdInput(e.definition):e.definition,execute:void 0,executeInput:e.executeInput,workflowId:e.workflowId}}function createPreparedWorkflowToolHarnessDefinition(e){let t=workflowIdForHandling(e.behavior?.handling);if(t===void 0)throw Error(`Prepared tool "${e.name}" is not backed by a workflow.`);return createWorkflowToolHarnessDefinition({definition:{frameworkTool:e.kind!==`authored-tool`||e.owner.kind===`framework`,behavior:e.behavior,deferred:e.deferred,description:e.description,inputSchema:toInputSchema(e.inputSchema)??UNSPECIFIED_INPUT_SCHEMA,name:e.name,outputSchema:toOutputSchema(e.outputSchema),rootOnly:e.rootOnly},workflowId:t})}export{createPreparedWorkflowToolHarnessDefinition,createWorkflowToolHarnessDefinition};
+import{UNSPECIFIED_INPUT_SCHEMA,toInputSchema,toOutputSchema}from"#tools/schema.js";import{entryPointOf}from"#execution/tasks/tool-entry-point.js";import{workflowIdForHandling}from"#runtime/subagents/workflow-reference.js";import{withTaskIdInput}from"#execution/tasks/task-id-input.js";function createWorkflowToolHarnessDefinition(e){return{...entryPointOf(e.definition)===`serve`?withTaskIdInput(e.definition):e.definition,execute:void 0,executeInput:e.executeInput,workflowId:e.workflowId}}function createPreparedWorkflowToolHarnessDefinition(e){let t=workflowIdForHandling(e.behavior?.handling);if(t===void 0)throw Error(`Prepared tool "${e.name}" is not backed by a workflow.`);return createWorkflowToolHarnessDefinition({definition:{frameworkTool:e.kind!==`authored-tool`||e.owner.kind===`framework`,behavior:e.behavior,deferred:e.deferred,description:e.description,inputSchema:toInputSchema(e.inputSchema)??UNSPECIFIED_INPUT_SCHEMA,name:e.name,outputSchema:toOutputSchema(e.outputSchema),rootOnly:e.rootOnly},workflowId:t})}export{createPreparedWorkflowToolHarnessDefinition,createWorkflowToolHarnessDefinition};

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

@@ -1,41 +1,29 @@
-import type { SubagentAuthorizationEventHookPayload } from "#channel/types.js";
-import type { SessionInboxAddress } from "#execution/session-inbox/address.js";
-import type { RemoteAgentBinding } from "#eve-channel/support.js";
+import type { SubagentInteractionHookPayload } from "#channel/types.js";
 import type { SessionAuth } from "#context/session-context.js";
 import type { AgentSessionContext } from "#execution/agent-sessions/context.js";
 import type { AgentSessionAddress } from "#execution/agent-sessions/steps.js";
-import type { InputRequest } from "#shared/input.js";
 import type { JsonObject, JsonValue } from "#shared/json.js";
 import type { TokenUsage } from "#shared/token-usage.js";
-import type { ToolInputRequest, ToolInputResponse } from "#tools/definition.js";
+import type { ToolQuestion, ToolAnswer } from "#tools/definition.js";
 export interface WorkflowToolRunOwner {
     readonly inbox: string;
 }
 /**
- * A child authorization event the owner should display. Unlike input requests
- * it has no answer: the authorization callback completes against the child
- * directly, so the owner only re-emits it.
+ * An interaction fact the run relays: one a session it opened with `ctx.agent` published, or the
+ * run's own sign-in. The session that owns the run mirrors it.
  */
-export interface WorkflowToolAuthorizationRequest {
-    readonly event: SubagentAuthorizationEventHookPayload;
-    readonly kind: "authorization-request";
+export interface WorkflowToolRelay {
+    readonly event: SubagentInteractionHookPayload;
+    readonly kind: "relay";
 }
 /** A question authored with `ask()` from `eve/workflow`, before owner normalization. */
 export interface WorkflowToolAskRequest {
     /** The run's control hook, where the session sends its decision on the question. */
     readonly control: string;
     readonly kind: "ask";
-    readonly request: ToolInputRequest;
+    readonly request: ToolQuestion;
 }
-/**
- * A child subagent's pending input requests for one step, forwarded as a unit
- * so the owner resolves them against the same child step they came from.
- */
-export interface WorkflowToolInputRequestBatch {
-    readonly kind: "input-batch";
-    readonly requests: readonly InputRequest[];
-}
-export type WorkflowToolRequest = WorkflowToolAuthorizationRequest | WorkflowToolAskRequest | InputRequest | WorkflowToolInputRequestBatch;
+export type WorkflowToolRequest = WorkflowToolRelay | WorkflowToolAskRequest;
 /** Identifies the sending workflow tool run to an owner shared by many runs. */
 export interface WorkflowToolRunRef {
     readonly callId: string;
@@ -63,19 +51,9 @@ export interface WorkflowToolRunReport {
     readonly update: JsonValue;
 }
 export interface WorkflowToolRunRequestMessage {
-    readonly childSessionInbox?: SessionInboxAddress;
-    readonly remote?: RemoteAgentBinding & {
-        readonly sessionId: string;
-    };
     readonly from: WorkflowToolRunRef;
-    readonly inputSource?: string;
     readonly replyTo: string;
     readonly request: WorkflowToolRequest;
-    readonly requestCoordinates?: {
-        readonly sequence: number;
-        readonly stepIndex: number;
-        readonly turnId: string;
-    };
 }
 export interface WorkflowToolRunOutcomeMessage {
     readonly from: WorkflowToolRunRef;
@@ -93,10 +71,18 @@ export interface WorkflowToolRunWithdrawMessage {
     readonly from: WorkflowToolRunRef;
     readonly replyTo: string;
 }
-/** The run opened a session with `ctx.agent`, which its session announces as `agent.started`. */
+/** The run opened a session with `ctx.agent`, which its session announces as `child.opened`. */
 export interface WorkflowToolRunAgentStartedMessage {
     readonly from: WorkflowToolRunRef;
     readonly session: AgentSessionAddress;
+    readonly context: AgentSessionContext;
+}
+/** A delivery a session the run opened accepted, sent for the call the run serves. */
+export interface WorkflowToolRunAgentSentMessage {
+    readonly from: WorkflowToolRunRef;
+    /** The session that accepted the delivery. */
+    readonly sessionId: string;
+    readonly deliveryId: string;
 }
 /**
  * A `serve` body's reply, sent once for each `ctx.reply()`. It settles every
@@ -132,6 +118,8 @@ export interface WorkflowToolRunStartedMessage {
 export type WorkflowToolRunMessage = ({
     readonly kind: "agent-started";
 } & WorkflowToolRunAgentStartedMessage) | ({
+    readonly kind: "agent-sent";
+} & WorkflowToolRunAgentSentMessage) | ({
     readonly kind: "started";
 } & WorkflowToolRunStartedMessage) | ({
     readonly kind: "report";
@@ -146,6 +134,10 @@ export type WorkflowToolRunMessage = ({
 } & WorkflowToolRunUsageMessage) | ({
     readonly kind: "outcome";
 } & WorkflowToolRunOutcomeMessage);
+/** A run's report of a session it opened or a delivery that session accepted. */
+export declare function isAgentSessionMessage(message: WorkflowToolRunMessage): message is Extract<WorkflowToolRunMessage, {
+    readonly kind: "agent-started" | "agent-sent";
+}>;
 /**
  * Messages a run relays to its session in one delivery, in the order its body
  * sent them. The session's inbox reads them as separate messages.
@@ -178,7 +170,7 @@ export interface WorkflowToolRunCall extends Pick<WorkflowToolRunRef, "callId" |
     readonly input: JsonObject;
 }
 /** A person's answer to a `ctx.ask()` question, as the session accepted it. */
-export type WorkflowToolRunAnswer = Extract<ToolInputResponse, {
+export type WorkflowToolRunAnswer = Extract<ToolAnswer, {
     readonly status: "answered";
 }>;
 /**

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

@@ -1 +1 @@
-function runMessageBatchBudget(){let e=0,t=!1;return n=>{let r=serializedLength(n);return t&&e+r>64e3?!1:(e+=r,t=!0,!0)}}function serializedLength(e){try{return JSON.stringify(e)?.length??0}catch{return 1/0}}function isWorkflowToolRunControlMessage(e){if(typeof e!=`object`||!e)return!1;let{call:t,kind:n,reason:r,requestId:i,response:a}=e;switch(n){case`interrupt`:return!0;case`cancel`:case`end`:return typeof r==`string`;case`call`:return isWorkflowToolRunCall(t);case`answer`:return typeof i==`string`&&isWorkflowToolRunAnswer(a);case`withdrawn`:return typeof i==`string`;default:return!1}}function isWorkflowToolRunAskDecision(e){return e.kind===`answer`||e.kind===`withdrawn`}function isWorkflowToolRunAnswer(e){if(typeof e!=`object`||!e)return!1;let{optionId:t,responder:n,status:r,text:i}=e;return r===`answered`&&(t===void 0||typeof t==`string`)&&(n===void 0||isToolInputResponseResponder(n))&&(i===void 0||typeof i==`string`)}function isToolInputResponseResponder(e){if(typeof e!=`object`||!e)return!1;let{authenticator:t,principalId:n,principalType:r}=e;return typeof t==`string`&&typeof n==`string`&&typeof r==`string`}function isWorkflowToolRunCall(e){if(typeof e!=`object`||!e)return!1;let{agentContext:t,auth:n,callId:r,input:i,sequence:a,stepIndex:o,turnId:s}=e;return typeof t==`object`&&!!t&&typeof n==`object`&&!!n&&typeof r==`string`&&typeof i==`object`&&!!i&&typeof a==`number`&&typeof o==`number`&&typeof s==`string`}export{isWorkflowToolRunAskDecision,isWorkflowToolRunControlMessage,runMessageBatchBudget};
+function isAgentSessionMessage(e){return e.kind===`agent-started`||e.kind===`agent-sent`}function runMessageBatchBudget(){let e=0,t=!1;return n=>{let r=serializedLength(n);return t&&e+r>64e3?!1:(e+=r,t=!0,!0)}}function serializedLength(e){try{return JSON.stringify(e)?.length??0}catch{return 1/0}}function isWorkflowToolRunControlMessage(e){if(typeof e!=`object`||!e)return!1;let{call:t,kind:n,reason:r,requestId:i,response:a}=e;switch(n){case`interrupt`:return!0;case`cancel`:case`end`:return typeof r==`string`;case`call`:return isWorkflowToolRunCall(t);case`answer`:return typeof i==`string`&&isWorkflowToolRunAnswer(a);case`withdrawn`:return typeof i==`string`;default:return!1}}function isWorkflowToolRunAskDecision(e){return e.kind===`answer`||e.kind===`withdrawn`}function isWorkflowToolRunAnswer(e){if(typeof e!=`object`||!e)return!1;let{optionId:t,responder:n,status:r,text:i}=e;return r===`answered`&&(t===void 0||typeof t==`string`)&&(n===void 0||isPrincipal(n))&&(i===void 0||typeof i==`string`)}function isPrincipal(e){if(typeof e!=`object`||!e)return!1;let{id:t,type:n,issuer:r}=e;return typeof t==`string`&&typeof n==`string`&&(r===void 0||typeof r==`string`)}function isWorkflowToolRunCall(e){if(typeof e!=`object`||!e)return!1;let{agentContext:t,auth:n,callId:r,input:i,sequence:a,stepIndex:o,turnId:s}=e;return typeof t==`object`&&!!t&&typeof n==`object`&&!!n&&typeof r==`string`&&typeof i==`object`&&!!i&&typeof a==`number`&&typeof o==`number`&&typeof s==`string`}export{isAgentSessionMessage,isWorkflowToolRunAskDecision,isWorkflowToolRunControlMessage,runMessageBatchBudget};

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

@@ -1,9 +1,13 @@
-import type { SubagentInputRequestHookPayload } from "#channel/types.js";
-import type { WorkflowToolRunOutcomeMessage, WorkflowToolRunRequestMessage } from "#execution/tools/workflow/messages.js";
+import type { SubagentInteractionHookPayload } from "#channel/types.js";
+import type { WorkflowToolAskRequest, WorkflowToolRunOutcomeMessage, WorkflowToolRunRequestMessage } from "#execution/tools/workflow/messages.js";
 import type { RuntimeToolResultActionResult } from "#shared/action-types.js";
-import type { InputRequest } from "#shared/input.js";
 import { type JsonValue } from "#shared/json.js";
 export declare function workflowToolRunOutcomeToToolResult(message: WorkflowToolRunOutcomeMessage): RuntimeToolResultActionResult;
 export declare function workflowToolRunFailureOutput(message: WorkflowToolRunOutcomeMessage): JsonValue;
-export declare function workflowToolRunRequestToInputRequestPayload(message: WorkflowToolRunRequestMessage): SubagentInputRequestHookPayload;
-export declare function workflowToolRunInputRequests(message: WorkflowToolRunRequestMessage): readonly InputRequest[];
+/**
+ * A run's `ctx.ask()` question, relayed like any request: an interaction the run opens, about
+ * the call it serves. The run is the asker, so its question names the run as its origin.
+ */
+export declare function workflowAskPayload(message: WorkflowToolRunRequestMessage & {
+    readonly request: WorkflowToolAskRequest;
+}): SubagentInteractionHookPayload;

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

@@ -1 +1 @@
-import{parseJsonValue}from"#shared/json.js";import{rebuildSerializableError}from"#execution/workflow-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}:n.status===`failed`?{callId:t.callId,errorName:rebuildSerializableError(n.error).name,isError:!0,kind:`tool-result`,output:workflowToolRunFailureOutput(e),toolName:t.toolName}:{callId:t.callId,isError:!0,kind:`tool-result`,output:n.reason??`The workflow tool run was cancelled.`,toolName:t.toolName}}function workflowToolRunFailureOutput(e){if(e.result.status!==`failed`)throw TypeError(`Expected a failed workflow outcome.`);let t=parseJsonValueOrUndefined(e.result.error);return t!==void 0&&typeof t==`object`&&t&&!Array.isArray(t)&&typeof Reflect.get(t,`code`)==`string`?t:errorMessage(e.result.error)}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(e){try{return parseJsonValue(e)}catch{return}}function workflowToolRunRequestToInputRequestPayload(e){let{from:t,replyTo:n,requestCoordinates:r}=e;return{callId:t.callId,childContinuationToken:n,childSessionId:t.runId,childSessionInbox:e.childSessionInbox,remote:e.remote,inputSource:e.inputSource,event:{requests:workflowToolRunInputRequests(e),sequence:r?.sequence??t.sequence,stepIndex:r?.stepIndex??t.stepIndex,taskId:t.taskId,turnId:r?.turnId??t.turnId},kind:`subagent-input-request`,subagentName:t.toolName}}function workflowToolRunInputRequests(e){return e.request.kind===`input-batch`?e.request.requests:[normalizeInputRequest(e.request,e.from,e.replyTo)]}function normalizeInputRequest(e,t,n){switch(e.kind){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{workflowToolRunFailureOutput,workflowToolRunInputRequests,workflowToolRunOutcomeToToolResult,workflowToolRunRequestToInputRequestPayload};
+import{parseJsonValue}from"#shared/json.js";import{rebuildSerializableError}from"#execution/workflow-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,...n.status===`failed`&&{errorName:rebuildSerializableError(n.error).name},isError:!0,kind:`tool-result`,output:n.status===`failed`?workflowToolRunFailureOutput(e):n.reason??`The workflow tool run was cancelled.`,toolName:t.toolName}}function workflowToolRunFailureOutput(e){if(e.result.status!==`failed`)throw TypeError(`Expected a failed workflow outcome.`);let t=parseJsonValueOrUndefined(e.result.error);return t!==void 0&&typeof t==`object`&&t&&!Array.isArray(t)&&typeof Reflect.get(t,`code`)==`string`?t:errorMessage(e.result.error)}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(e){try{return parseJsonValue(e)}catch{return}}function workflowAskPayload(e){let{from:t,replyTo:n}=e,r=e.request.request;if(typeof r.prompt!=`string`||r.prompt.length===0)throw TypeError("A workflow tool run request needs a non-empty `prompt`.");let i={kind:`question`,prompt:r.prompt};return r.allowFreeform!==void 0&&(i.allowFreeform=r.allowFreeform),r.display!==void 0&&(i.display=r.display),r.title!==void 0&&(i.title=r.title),r.options!==void 0&&(i.options=[...r.options]),{callId:t.callId,childSessionId:t.runId,events:[{data:{interactionId:n,origin:{call:{callId:t.callId,input:t.input,name:t.toolName},interactionId:n,sessionId:t.runId},request:i,subject:{callId:t.callId}},type:`interaction.opened`}],kind:`subagent-interaction`,route:{childContinuationToken:n},subagentName:t.toolName}}export{workflowAskPayload,workflowToolRunFailureOutput,workflowToolRunOutcomeToToolResult};

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

@@ -1,4 +1,4 @@
-import { type WorkflowToolRunMessage, type WorkflowToolRunRequestMessage, type WorkflowToolAuthorizationRequest } from "#execution/tools/workflow/messages.js";
+import { type WorkflowToolRunMessage, type WorkflowToolRunRequestMessage, type WorkflowToolRelay } from "#execution/tools/workflow/messages.js";
 import { type ChannelReader } from "#execution/tools/workflow/owner-channels.js";
 /**
  * The run's inbox as its body sees it. Everything the body sends its session,
@@ -30,7 +30,7 @@ export interface WorkflowToolRunOwnerInbox {
  */
 export declare function openWorkflowToolRunOwnerInbox(): WorkflowToolRunOwnerInbox;
 /** Acknowledge only step-owned events, after delivery or deliberate discard. */
-export declare function deliverWorkflowAuthorization(message: WorkflowToolRunRequestMessage & {
-    readonly request: WorkflowToolAuthorizationRequest;
+export declare function deliverWorkflowRelay(message: WorkflowToolRunRequestMessage & {
+    readonly request: WorkflowToolRelay;
 }, deliver: () => Promise<void>): Promise<void>;
 export {};

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

@@ -1 +1 @@
-import{runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{createChannelReader}from"#execution/tools/workflow/owner-channels.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";function openWorkflowToolRunOwnerInbox(){let e=[],t,n=0;async function*read(){for(;;){if(e.length>0){let t=runMessageBatchBudget(),n=e.findIndex(e=>!t(e));yield e.splice(0,n===-1?e.length:n);continue}await new Promise(e=>{t=e})}}return{owner:{get sent(){return n},async send(r){e.push(r),n+=1;let i=t;t=void 0,i?.()}},reader:createChannelReader(`workflow`,read())}}async function deliverWorkflowAuthorization(e,t){await t(),e.request.event.childSessionId===e.from.runId&&await resumeHookStep(e.replyTo,null,{ifPresent:!0})}export{deliverWorkflowAuthorization,openWorkflowToolRunOwnerInbox};
+import{runMessageBatchBudget}from"#execution/tools/workflow/messages.js";import{createChannelReader}from"#execution/tools/workflow/owner-channels.js";import{resumeHookStep}from"#execution/tools/workflow/resume-hook-step.js";function openWorkflowToolRunOwnerInbox(){let e=[],t,n=0;async function*read(){for(;;){if(e.length>0){let t=runMessageBatchBudget(),n=e.findIndex(e=>!t(e));yield e.splice(0,n===-1?e.length:n);continue}await new Promise(e=>{t=e})}}return{owner:{get sent(){return n},async send(r){e.push(r),n+=1;let i=t;t=void 0,i?.()}},reader:createChannelReader(`workflow`,read())}}async function deliverWorkflowRelay(e,t){await t(),e.request.event.childSessionId===e.from.runId&&await resumeHookStep(e.replyTo,null,{ifPresent:!0})}export{deliverWorkflowRelay,openWorkflowToolRunOwnerInbox};

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

@@ -1 +1 @@
-import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{WorkflowToolRunCancelledError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,toFailedOutcome,toWorkflowOutput}from"#execution/tools/workflow/body.js";var WorkflowServeCalls=class{asks;run=new AbortController;first;runRef;runSession;owner;usage=createRunUsageTally(()=>this.sendUncarriedUsage());carriedUsage;toolName;seenCallIds;firstReceived=!1;arrived=[];waiting;latest;pendingReceive;stretch;unwindingCancel=!1;endedBy;replies=Promise.resolve();constructor(e){this.runRef=createWorkflowBodyRef(e),this.asks=new WorkflowToolRunAsks(this.runRef.runId),this.runSession=e.session,this.owner=e.owner,this.toolName=e.toolName,this.seenCallIds=new Set([e.callId]),this.first=this.serve({agentContext:e.agentContext,auth:e.session.auth,callId:this.runRef.callId,executeInput:e.executeInput,input:this.runRef.input,sequence:this.runRef.sequence,stepIndex:this.runRef.stepIndex,turnId:this.runRef.turnId}),this.waiting=[this.first],this.latest=this.first}get runSignal(){return this.run.signal}get unwinding(){return this.run.signal.aborted||this.unwindingCancel}get currentSignal(){return this.stretch?.signal??this.run.signal}get current(){return this.latest}apply(e){switch(e.kind){case`call`:this.accept(e.call);return;case`cancel`:this.cancel(new WorkflowToolRunCancelledError(e.reason));return;case`end`:this.end(new WorkflowToolRunCancelledError(e.reason));return;case`interrupt`:return}}receive(){if(!this.firstReceived)return this.firstReceived=!0,Promise.resolve(this.first.call);if(this.unwindingCancel=!1,this.pendingReceive!==void 0)return this.pendingReceive.promise;if(this.endedBy!==void 0)return Promise.reject(this.endedBy);let e=this.arrived.shift();return e===void 0?(this.pendingReceive=createPendingReceive(),this.pendingReceive.promise):(this.take(e),Promise.resolve(e.call))}reply(e){let t=this.waiting;if(t.length===0)return;this.waiting=[],this.arrived.length===0&&(this.stretch=void 0),this.asks.withdrawAll();let n=this.replies;this.replies=n.then(()=>this.deliverReply(t,e))}assertWaiting(){if(!(this.waiting.length>0))throw Error(`ctx.ask() needs a call waiting for a result, but tool "${this.toolName}" already replied to every call it received.`)}async flush(){await this.asks.flush(),await this.replies}sendUncarriedUsage(){if(this.waiting.length>0||this.endedBy!==void 0)return;let{from:e}=this.latest;this.replies=this.replies.then(async()=>{let t=this.usage.total();t===void 0||isSameUsage(t,this.carriedUsage)||(this.carriedUsage=t,await this.owner.send({from:e,kind:`usage`,usage:t}))})}accept(e){if(this.endedBy!==void 0||this.seenCallIds.has(e.callId))return;this.seenCallIds.add(e.callId);let t=this.serve(e),n=this.pendingReceive;if(n===void 0){this.arrived.push(t);return}this.pendingReceive=void 0,this.take(t),n.resolve(t.call)}take(e){this.waiting.push(e),this.latest=e}cancel(e){this.pendingReceive===void 0&&(this.unwindingCancel=!0),this.stretch?.abort(e),this.stretch=void 0,this.waiting=[],this.arrived=[]}end(e){this.asks.cancelAll(),this.endedBy=e,this.run.abort(e),this.stretch?.abort(e);let t=this.pendingReceive;this.pendingReceive=void 0,t?.reject(e)}serve(e){return this.stretch??=new AbortController,{agentContext:e.agentContext,agents:createAgentsView(e.agentContext),call:{abortSignal:this.stretch.signal,callId:e.callId,input:e.executeInput??e.input},from:{...this.runRef,callId:e.callId,input:e.input,sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId},session:{...this.runSession,auth:e.auth,turn:{id:e.turnId,sequence:e.sequence}}}}async deliverReply(e,t){let n=e.at(-1);if(n===void 0)return;let r=e.map(e=>e.from.callId),i=this.usage.total();this.carriedUsage=i,await this.owner.send({callIds:r,from:n.from,kind:`reply`,output:t,...i!==void 0&&{usage:i}})}};function isSameUsage(e,t){return t!==void 0&&e.inputTokens===t.inputTokens&&e.outputTokens===t.outputTokens&&e.cacheReadTokens===t.cacheReadTokens&&e.cacheWriteTokens===t.cacheWriteTokens&&e.costUsd===t.costUsd}function startServeBody(e){let t=new WorkflowServeCalls(e),n={get agentContext(){return t.current.agentContext},asks:t.asks,get auth(){return t.current.session.auth},control:e.hookToken,get from(){return t.current.from},owner:e.owner},r=createAgentSessions(n,t.usage),i=createServeContext(e,t,r.open);return attachWorkflowToolRunContext(i,n),{asks:t.asks,close:r.close,control:t,outcome:executeServeBody(e,t,i),usage:t.usage}}async function executeServeBody(e,t,n){let r;try{let i=findStubTarget(e.agentContext.toolStubs,e.toolName),receive=()=>t.receive(),a=i===void 0?await resolveWorkflowEntryPoint(e)(receive,n):await serveStub(i.scope,i.tool,receive,n);r={output:toWorkflowOutput(e,a),status:`completed`}}catch(e){r=toFailedOutcome(e,t.runSignal)}return await t.flush(),r}function createServeContext(e,t,n){let r={...createSharedContext(e,n,(e,n)=>(t.assertWaiting(),ask(r,e,n))),get abortSignal(){return t.currentSignal},get agents(){return t.current.agents},get callId(){return t.current.from.callId},get session(){return t.current.session},reply:n=>t.reply(toWorkflowOutput({callId:r.callId,toolName:e.toolName},n))};return r}function createPendingReceive(){let e,t;return{promise:new Promise((n,r)=>{e=n,t=r}),reject:t,resolve:e}}async function serveStub(e,t,n,r){for(;;){let i=await n();if(i.abortSignal.aborted)continue;let a=await callToolStubStep(e,{callId:stubCallId(r.session.id,r.session.turn.id,i.callId),input:i.input,tool:t,persistent:!0});if(a.kind!==`stub`)throw Error(a.kind===`error`?a.error:`Persistent stub configuration changed.`);r.reply(toolStubOutput(a.outcome))}}export{startServeBody};
+import{callToolStubStep}from"#execution/tool-stubs/steps.js";import{findStubTarget,stubCallId}from"#tool-stubs/target.js";import{toolStubOutput}from"#tool-stubs/output.js";import{createAgentSessions}from"#execution/agent-sessions/session.js";import{createRunUsageTally}from"#execution/agent-sessions/usage.js";import{WorkflowToolRunAsks,ask,attachWorkflowToolRunContext}from"#execution/tools/workflow/ask.js";import{WorkflowToolRunCancelledError,createAgentsView,createSharedContext,createWorkflowBodyRef,resolveWorkflowEntryPoint,toFailedOutcome,toWorkflowOutput}from"#execution/tools/workflow/body.js";var WorkflowServeCalls=class{asks;run=new AbortController;first;runRef;runSession;owner;usage=createRunUsageTally(()=>this.sendUncarriedUsage());carriedUsage;toolName;seenCallIds;firstReceived=!1;arrived=[];waiting;latest;pendingReceive;stretch;unwindingCancel=!1;endedBy;replies=Promise.resolve();constructor(e){this.runRef=createWorkflowBodyRef(e),this.asks=new WorkflowToolRunAsks(this.runRef.runId),this.runSession=e.session,this.owner=e.owner,this.toolName=e.toolName,this.seenCallIds=new Set([e.callId]),this.first=this.serve({agentContext:e.agentContext,auth:e.session.auth,callId:this.runRef.callId,executeInput:e.executeInput,input:this.runRef.input,sequence:this.runRef.sequence,stepIndex:this.runRef.stepIndex,turnId:this.runRef.turnId}),this.waiting=[this.first],this.latest=this.first}get runSignal(){return this.run.signal}get unwinding(){return this.run.signal.aborted||this.unwindingCancel}get currentSignal(){return this.stretch?.signal??this.run.signal}get current(){return this.latest}apply(e){switch(e.kind){case`call`:this.accept(e.call);return;case`cancel`:this.cancel(new WorkflowToolRunCancelledError(e.reason));return;case`end`:this.end(new WorkflowToolRunCancelledError(e.reason));return;case`interrupt`:return}}receive(){if(!this.firstReceived)return this.firstReceived=!0,Promise.resolve(this.first.call);if(this.unwindingCancel=!1,this.pendingReceive!==void 0)return this.pendingReceive.promise;if(this.endedBy!==void 0)return Promise.reject(this.endedBy);let e=this.arrived.shift();return e===void 0?(this.pendingReceive=createPendingReceive(),this.pendingReceive.promise):(this.take(e),Promise.resolve(e.call))}reply(e){let t=this.waiting;if(t.length===0)return;this.waiting=[],this.arrived.length===0&&(this.stretch=void 0),this.asks.withdrawAll();let n=this.replies;this.replies=n.then(()=>this.deliverReply(t,e))}assertWaiting(){if(!(this.waiting.length>0))throw Error(`ctx.ask() needs a call waiting for a result, but tool "${this.toolName}" already replied to every call it received.`)}async flush(){await this.asks.flush(),await this.replies}sendUncarriedUsage(){if(this.waiting.length>0||this.endedBy!==void 0)return;let{from:e}=this.latest;this.replies=this.replies.then(async()=>{let t=this.usage.total();t===void 0||isSameUsage(t,this.carriedUsage)||(this.carriedUsage=t,await this.owner.send({from:e,kind:`usage`,usage:t}))})}accept(e){if(this.endedBy!==void 0||this.seenCallIds.has(e.callId))return;this.seenCallIds.add(e.callId);let t=this.serve(e),n=this.pendingReceive;if(n===void 0){this.arrived.push(t);return}this.pendingReceive=void 0,this.take(t),n.resolve(t.call)}take(e){this.waiting.push(e),this.latest=e}cancel(e){this.pendingReceive===void 0&&(this.unwindingCancel=!0),this.stretch?.abort(e),this.stretch=void 0,this.waiting=[],this.arrived=[]}end(e){this.asks.cancelAll(),this.endedBy=e,this.run.abort(e),this.stretch?.abort(e);let t=this.pendingReceive;this.pendingReceive=void 0,t?.reject(e)}serve(e){return this.stretch??=new AbortController,{agentContext:e.agentContext,agents:createAgentsView(e.agentContext),call:{abortSignal:this.stretch.signal,callId:e.callId,input:e.executeInput??e.input},from:{...this.runRef,callId:e.callId,input:e.input,sequence:e.sequence,stepIndex:e.stepIndex,turnId:e.turnId},session:{...this.runSession,auth:e.auth,turn:{id:e.turnId,sequence:e.sequence}}}}async deliverReply(e,t){let n=e.at(-1);if(n===void 0)return;let r=e.map(e=>e.from.callId),i=this.usage.total();this.carriedUsage=i,await this.owner.send({callIds:r,from:n.from,kind:`reply`,output:t,...i!==void 0&&{usage:i}})}};function isSameUsage(e,t){return t!==void 0&&e.inputTokens===t.inputTokens&&e.outputTokens===t.outputTokens&&e.cacheReadTokens===t.cacheReadTokens&&e.cacheWriteTokens===t.cacheWriteTokens&&e.costUsd===t.costUsd}function startServeBody(e){let t=new WorkflowServeCalls(e),n={get agentContext(){return t.current.agentContext},asks:t.asks,get auth(){return t.current.session.auth},control:e.hookToken,get from(){return t.current.from},owner:e.owner},r=createAgentSessions(n,t.usage),i=createServeContext(e,t,r.open);return attachWorkflowToolRunContext(i,n),{asks:t.asks,close:r.close,control:t,outcome:executeServeBody(e,t,i),usage:t.usage}}async function executeServeBody(e,t,n){let r;try{let i=findStubTarget(e.agentContext.toolStubs,e.toolName),receive=()=>t.receive(),a=i===void 0?await resolveWorkflowEntryPoint(e)(receive,n):await serveStub(i.scope,i.tool,receive,n);r={output:toWorkflowOutput(e,a),status:`completed`}}catch(e){r=toFailedOutcome(e,t.runSignal)}return await t.flush(),r}function createServeContext(e,t,n){let r={...createSharedContext(e,n,(e,n)=>(t.assertWaiting(),ask(r,e,n))),get abortSignal(){return t.currentSignal},get agents(){return t.current.agents},get callId(){return t.current.from.callId},get session(){return t.current.session},reply:n=>t.reply(toWorkflowOutput({callId:r.callId,toolName:e.toolName},n))};return r}function createPendingReceive(){let e,t;return{promise:new Promise((n,r)=>{e=n,t=r}),reject:t,resolve:e}}async function serveStub(e,t,n,r){for(;;){let i=await n();if(i.abortSignal.aborted)continue;let a=await callToolStubStep(e,{callId:stubCallId(r.session.id,r.session.turn.id,i.callId),input:i.input,tool:t,persistent:!0});if(a.kind!==`stub`)throw Error(a.kind===`error`?a.error:`Persistent stub configuration changed.`);r.reply(toolStubOutput(a.outcome))}}export{startServeBody};