eve 0.56.0 → 0.57.0

package/dist/src/execution/legacy-session/interrupt-step.d.ts

@@ -0,0 +1,3 @@
+import type { PreparedLegacySession } from "./prepare-step.js";
+/** Only the elected importer may stop work or append cancellation events. */
+export declare function interruptLegacySessionStep(prepared: PreparedLegacySession): Promise<import("#execution/settle-cancelled-turn-step.js").CancelledTurnSettleResult>;

package/dist/src/execution/legacy-session/interrupt-step.js

@@ -0,0 +1 @@
+import{createLogger,logError}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{walkCauseChain}from"#shared/errors.js";import{cancelRun,getWorld}from"#internal/workflow/runtime.js";import{getWorkflowToolRuns}from"#harness/workflow-tool-runs.js";import{EntityConflictError,RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{terminateChildSessionsStep}from"#execution/terminate-child-sessions-step.js";import{settleCancelledTurnStep}from"#execution/settle-cancelled-turn-step.js";async function interruptLegacySessionStep(e){"use step";let t={...e.sessionState,snapshot:{session:{...e.originalSession,history:e.sessionState.snapshot.session.history}}};try{await terminateChildSessionsStep({sessionState:t,serializedContext:e.serializedContext})}catch(e){logError(createLogger(`execution.legacy-session`),`could not cooperatively stop legacy children`,e)}let n=await getWorld(),r=e.originalSession.state,i=new Set(getWorkflowToolRuns(r).map(e=>e.runId)),a=r?.[`eve.agent.handles`];if(isObject(a)&&Array.isArray(a.handles))for(let e of a.handles)isObject(e)&&isObject(e.address)&&(e.address.kind===`agent/local`||e.address.kind===`agent/self`)&&typeof e.address.sessionId==`string`&&i.add(e.address.sessionId);let o=r?.[`eve.tasks`];if(isObject(o)&&Array.isArray(o.tasks))for(let e of o.tasks)isObject(e)&&typeof e.taskRunId==`string`&&i.add(e.taskRunId);for(let t of i)if(t&&t!==e.sessionState.sessionId)try{await cancelRun(n,t,{cancelReason:`Session upgraded`})}catch(e){if(![...walkCauseChain(e)].some(e=>EntityConflictError.is(e)||RunExpiredError.is(e)||WorkflowRunNotFoundError.is(e)))throw e}return e.input.inputCommitted||e.sessionState.emissionState.turnId===``?{sessionState:e.sessionState,serializedContext:e.serializedContext}:await settleCancelledTurnStep({sessionWritable:e.input.sessionWritable,serializedContext:e.serializedContext,sessionState:e.sessionState})}export{interruptLegacySessionStep};

package/dist/src/execution/legacy-session/prepare-step.d.ts

@@ -0,0 +1,24 @@
+import { type LegacyTurnInput } from "./input.js";
+/** Persist the import before publishing its current-generation inbox. */
+export declare function prepareLegacySessionStep(rawInput: unknown): Promise<{
+    input: {
+        completionToken: string;
+        capabilities?: import("../../channel/types.ts").SessionCapabilities;
+        mode: import("../../shared/run-mode.ts").RunMode;
+        sessionWritable: WritableStream<Uint8Array>;
+        serializedContext: Record<string, unknown>;
+        sessionState: Record<string, unknown> & {
+            sessionId: string;
+        };
+        delivery: import("../../channel/types.ts").DeliverHookPayload | undefined;
+        inputCommitted: boolean;
+        retention: "default" | 0 | undefined;
+    };
+    originalSession: import("./snapshot.js").LegacySession;
+    sessionState: import("../durable-session-store.ts").DurableSessionState;
+    serializedContext: Record<string, unknown>;
+    sessionTimeoutMs: number | false;
+    deploymentId: string;
+}>;
+export type PreparedLegacySession = Awaited<ReturnType<typeof prepareLegacySessionStep>>;
+export type { LegacyTurnInput };

package/dist/src/execution/legacy-session/prepare-step.js

@@ -0,0 +1 @@
+import{readLegacyTurnInput}from"./input.js";import{importConversation,readLegacySnapshot}from"./snapshot.js";import{isObject}from"#shared/guards.js";import{SESSION_INBOX_CONTEXT_KEY}from"#execution/session-inbox/address.js";import{getWorld,resolveRunEncryptionKey}from"#internal/workflow/runtime.js";import{hydrateWorkflowArguments}from"#compiled/@workflow/core/serialization.js";import{DEFAULT_SESSION_TIMEOUT_MS}from"#execution/session/timeout.js";async function prepareLegacySessionStep(e){"use step";let t=readLegacyTurnInput(e),n=readLegacySnapshot(t.sessionState),r=importConversation(n),i=await getWorld(),a=await i.runs.get(r.sessionId),o=await hydrateWorkflowArguments(a.input,a.runId,await resolveRunEncryptionKey(i,a)),s=Array.isArray(o)&&isObject(o[0])?o[0]:void 0;if(s===void 0)throw Error(`Cannot read the original session timeout.`);let c=s.sessionTimeoutMs;if(c!==void 0&&c!==!1&&(typeof c!=`number`||!Number.isFinite(c)||c<0))throw Error(`Invalid original session timeout.`);let l=c??DEFAULT_SESSION_TIMEOUT_MS,u={...t.serializedContext,"eve.sessionId":r.sessionId,[SESSION_INBOX_CONTEXT_KEY]:{sessionId:r.sessionId}};delete u[`eve.sessionCallback`];let d=u[`eve.channel`];return isObject(d)&&d.kind===`subagent`&&isObject(d.state)&&(u[`eve.channel`]={...d,state:{...d.state,parentContinuationToken:``}}),{input:{...t,retention:t.retention??s.retention},originalSession:n,sessionState:r,serializedContext:u,sessionTimeoutMs:l,deploymentId:process.env.VERCEL_DEPLOYMENT_ID?.trim()||await i.getDeploymentId()}}export{prepareLegacySessionStep};

package/dist/src/execution/legacy-session/snapshot.d.ts

@@ -0,0 +1,12 @@
+import type { ModelMessage } from "ai";
+import type { DurableSession, DurableSessionState } from "#execution/durable-session-store.js";
+export type LegacySession = Omit<DurableSession, "history"> & {
+    readonly history: ModelMessage[];
+};
+/** Reads the driver's embedded snapshot; every supported driver carries one. */
+export declare function readLegacySnapshot(state: Record<string, unknown> & {
+    sessionId: string;
+}): LegacySession;
+/** Keep committed conversation data, but no pre-cutover execution registries. */
+export declare function importConversation(session: LegacySession): DurableSessionState;
+export declare function normalizeHistory(messages: readonly ModelMessage[]): import("#harness/messages.js").HarnessModelMessage[];

package/dist/src/execution/legacy-session/snapshot.js

@@ -0,0 +1 @@
+import{isObject}from"#shared/guards.js";import{isUserMessageKind,validateHarnessModelMessages}from"#harness/messages.js";import{getHarnessEmissionState}from"#harness/emission.js";const PRESERVED_FRAMEWORK_STATE=new Set([`eve.harness.emission`,`eve.harness.turnUsage`,`eve.harness.reportedSessionUsage`,`eve.harness.sessionRuntimeTokenLimit`]);function readLegacySnapshot(e){let t=e.snapshot;if(!isObject(t)||t.version!==1||!isObject(t.session)||t.session.sessionId!==e.sessionId||!Array.isArray(t.session.history))throw Error(`Unsupported legacy session snapshot.`);return t.session}function importConversation(e){let t=Object.fromEntries(Object.entries(e.state??{}).filter(([e])=>!e.startsWith(`eve.`)||PRESERVED_FRAMEWORK_STATE.has(e))),n=normalizeHistory(e.history),r=getHarnessEmissionState(t),i={...e,history:n,state:t};return{version:1,sessionId:e.sessionId,continuationToken:e.continuationToken,hasProxyInputRequests:!1,emissionState:r,snapshot:{session:i}}}function normalizeHistory(e){let t=[],n=new Map,settle=()=>{n.size!==0&&(t.push({role:`tool`,content:[...n].map(([e,t])=>({type:`tool-result`,toolCallId:e,toolName:t,output:{type:`error-text`,value:`Interrupted by the session upgrade. Start this work again if it is still needed.`}}))}),n.clear())};for(let r of e){let e=r;if(e.role===`assistant`&&Array.isArray(e.content))e={...e,content:e.content.filter(e=>e.type!==`tool-approval-request`)};else if(e.role===`tool`&&(e={...e,content:e.content.filter(e=>e.type!==`tool-approval-response`)},e.content.length===0))continue;if(e.role!==`tool`&&settle(),e.role===`assistant`&&Array.isArray(e.content))for(let t of e.content)t.type===`tool-call`&&n.set(t.toolCallId,t.toolName);if(e.role===`tool`)for(let t of e.content)t.type===`tool-result`&&n.delete(t.toolCallId);let i=e.kind;t.push(e.role===`user`&&!isUserMessageKind(i)?{...e,kind:`user`}:e)}return settle(),validateHarnessModelMessages(t)}export{importConversation,normalizeHistory,readLegacySnapshot};

package/dist/src/execution/legacy-session/turn-workflow.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Historical dispatch name. Drivers from the former driver/turn execution
+ * model start this workflow for each turn. It imports the session once —
+ * persisting the conversation, claiming the current-generation inbox, and
+ * interrupting pending work — then runs the current owner program. The old
+ * driver stays parked as the stream anchor and hears the final result.
+ */
+export declare function turnWorkflow(rawInput: unknown): Promise<void>;

package/dist/src/execution/legacy-session/turn-workflow.js

@@ -0,0 +1 @@
+import{completeLegacyDriverStep}from"./completion-step.js";import{interruptLegacySessionStep}from"./interrupt-step.js";import{prepareLegacySessionStep}from"./prepare-step.js";import{sessionCommandHookToken}from"#execution/session-inbox/address.js";import{isHookConflictError}from"#execution/hook-ownership.js";import{sessionTimeoutDeadline}from"#execution/session/timeout.js";import{sessionHookTokens}from"#execution/session/hook-tokens.js";import{createSessionInbox}from"#execution/session-inbox/inbox.js";import{failSession,runPreparedSession}from"#execution/session/program.js";async function turnWorkflow(e){"use workflow";let t=await prepareLegacySessionStep(e),{sessionId:n}=t.sessionState,r=createSessionInbox(n);try{await r.claimSessionHook(sessionCommandHookToken(n))}catch(e){if(isHookConflictError(e))return;throw e}let{mode:i,sessionWritable:a}=t.input,o;try{await r.claimSessionHooks(sessionHookTokens(t)),o=await interruptLegacySessionStep(t)}catch(e){return await r.dispose(),await failSession({error:e,mode:i,serializedContext:t.serializedContext,sessionId:n,sessionState:t.sessionState,sessionWritable:a})}await runPreparedSession({anchor:{kind:`self`,notify:e=>completeLegacyDriverStep({completionToken:t.input.completionToken,result:e,serializedContext:t.serializedContext,sessionState:t.sessionState,sessionWritable:a})},caller:void 0,capabilities:t.input.capabilities,deploymentId:t.deploymentId,initialInput:t.input.delivery===void 0?void 0:{...t.input.delivery,caller:void 0},mode:i,retention:t.input.retention,serializedContext:o.serializedContext,sessionId:n,sessionState:o.sessionState,sessionTimeoutMs:t.sessionTimeoutMs,sessionTimeoutDeadline:sessionTimeoutDeadline(t.sessionTimeoutMs,Date.now()),sessionWritable:a},r)}turnWorkflow.workflowId=`workflow//eve//turnWorkflow`;export{turnWorkflow};

package/dist/src/execution/model-call-batching.d.ts

@@ -1,5 +1,6 @@
 import type { HarnessSession, StepInput, StepResult } from "#harness/types.js";
 export declare function runModelCallBatch(input: {
+    readonly steeringSignal?: AbortSignal;
     readonly initialInput: StepInput | undefined;
     readonly initialSession: HarnessSession;
     readonly modelCallsPerStep: number;

package/dist/src/execution/model-call-batching.js

@@ -1 +1 @@
-import{derivePendingState}from"#execution/pending-turn-state.js";async function runModelCallBatch(e){let t=e.initialSession,n=e.initialInput,r=0;for(;;){let i=await e.runStep({firstCall:r===0,session:t,stepInput:n});if(r++,!shouldRunAnotherModelCall({completedModelCalls:r,modelCallsPerStep:e.modelCallsPerStep,result:i}))return i;t=i.session,n=void 0}}function shouldRunAnotherModelCall(e){if(e.completedModelCalls>=e.modelCallsPerStep||typeof e.result.next!=`function`||e.result.backgroundTaskSession!==void 0||e.result.backgroundTasks!==void 0)return!1;let t=derivePendingState(e.result.session);return!t.hasPendingAuthorization&&!t.hasPendingInputBatch&&(t.pendingCoordinationCallIds?.length??0)===0}export{runModelCallBatch};
+import{derivePendingState}from"#execution/session/pending-turn-state.js";async function runModelCallBatch(e){let t=e.initialSession,n=e.initialInput,r=0;for(;;){let i=await e.runStep({firstCall:r===0,session:t,stepInput:n});if(r++,e.steeringSignal?.aborted===!0||i.steered===!0||!shouldRunAnotherModelCall({completedModelCalls:r,modelCallsPerStep:e.modelCallsPerStep,result:i}))return i;t=i.session,n=void 0}}function shouldRunAnotherModelCall(e){if(e.completedModelCalls>=e.modelCallsPerStep||typeof e.result.next!=`function`||e.result.backgroundTaskSession!==void 0||e.result.backgroundTasks!==void 0)return!1;let t=derivePendingState(e.result.session);return!t.hasPendingAuthorization&&!t.hasPendingInputBatch&&(t.pendingCoordinationCallIds?.length??0)===0}export{runModelCallBatch};

package/dist/src/execution/node-step.d.ts

@@ -21,6 +21,7 @@ export type CreateRuntime = (config: {
  * Input for building a harness step for one resolved runtime node.
  */
 export interface CreateExecutionNodeStepInput {
+    readonly steeringSignal?: AbortSignal;
     /** Cancellation signal forwarded to the tool-loop harness. */
     readonly abortSignal?: AbortSignal;
     /**

package/dist/src/execution/node-step.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{UNSPECIFIED_INPUT_SCHEMA}from"#tools/schema.js";import{createToolExecuteWithAuth}from"#execution/tool-auth.js";import{resolveRuntimeModelReference}from"#runtime/agent/resolve-model.js";import{createPreparedWorkflowToolHarnessDefinition,createWorkflowToolHarnessDefinition}from"#execution/tools/workflow/background.js";import{LOAD_SKILL_TOOL_NAME}from"#runtime/skills/fragment-context.js";import{dispatchDynamicModelEvent}from"#context/dynamic-model-lifecycle.js";import{preparePersistedStepDynamicToolMetadata}from"#context/dynamic-tool-lifecycle.js";import{createToolLoopHarness}from"#harness/tool-loop.js";import{createTaskToolHarnessDefinitions}from"#execution/tools/tasks.js";import{findRegisteredRuntimeTool}from"#runtime/tools/registry.js";import{preserveFrameworkStateOnCompaction}from"#execution/compaction.js";import{ASK_QUESTION_TOOL_NAME}from"#harness/request-input-tool.js";import{WEB_SEARCH_TOOL_NAME,resolveWebSearchActivityLabel}from"#harness/provider-tool-schemas.js";const log=createLogger(`execution.node-step`);function createExecutionNodeStep(e){let t=createRuntimeModelResolver(e.modelResolutionScope),n=e.node.turnAgent.dynamicModel===void 0?void 0:createRuntimeDynamicModelEventDispatcher(e.modelResolutionScope,e.node.turnAgent.dynamicModel),r=createNodeHarnessTools({node:e.node}),i=e.instrumentation,a=i?.prepareExecution(),o=createToolLoopHarness({abortSignal:e.abortSignal,capabilities:e.capabilities,clearOnly:e.clearOnly,compactOnly:e.compactOnly,handleEvent:e.handleEvent,historyProjector:e.historyProjector,historyView:e.historyView,instrumentation:a,mode:e.mode,onCompaction:preserveFrameworkStateOnCompaction,resolveStepDynamicTools:t=>preparePersistedStepDynamicToolMetadata({...t,resolvers:e.node.agent.dynamicToolResolvers??[]}),dispatchDynamicModelEvent:n,resolveModel:t,runtimeIdentity:buildRuntimeIdentity(e.node),tools:r});return i===void 0?o:async(e,t)=>{try{return await o(e,t)}finally{await i.flush()}}}function buildRuntimeIdentity(e){let t=resolveInstalledPackageInfo(),n={agentId:e.turnAgent.id,agentName:e.agent.config?.name,eveVersion:t.version},r=process.env.VERCEL_GIT_COMMIT_SHA?.trim(),i=process.env.VERCEL_GIT_COMMIT_REF?.trim(),a=process.env.VERCEL_DEPLOYMENT_CREATED_AT?.trim();return r||i||a?{...n,build:{deployedAt:a||void 0,gitBranch:i||void 0,gitSha:r||void 0}}:n}function createRuntimeModelResolver(e){return t=>resolveRuntimeModelReference(t,e)}function createRuntimeDynamicModelEventDispatcher(e,t){return n=>dispatchDynamicModelEvent({ctx:n.ctx,dynamicModel:t,event:n.event,messages:n.messages,scope:e})}function createNodeHarnessTools(e){let t=new Map;for(let n of e.node.turnAgent.tools){let r=resolveHarnessToolDefinition({node:e.node,tool:n});r!==null&&t.set(n.name,r)}return t}function resolveHarnessToolDefinition(e){let t=findRegisteredRuntimeTool(e.node.toolRegistry,e.tool.name);return isPreparedRuntimeWorkflowTool(e.tool)?t===null?createPreparedWorkflowToolHarnessDefinition(e.tool):createWorkflowToolHarnessDefinition({executeInput:t.definition.executeInput,definition:createRegisteredHarnessToolDefinition({behavior:e.tool.behavior,definition:t.definition,rootOnly:e.tool.rootOnly}),nodeId:e.tool.task.nodeId,resultKind:e.tool.task.resultKind,workflowId:e.tool.task.workflowId}):t===null?(log.warn(`declared tool is not registered — omitting from toolset`,{toolName:e.tool.name,nodeId:e.node.nodeId}),null):createRegisteredHarnessToolDefinition({behavior:e.tool.behavior,definition:t.definition,rootOnly:e.tool.rootOnly})}function isPreparedRuntimeWorkflowTool(e){return e.task!==void 0}function createRegisteredHarnessToolDefinition(e){let t=e.definition;if(t.owner.kind===`framework`){let n=createTaskToolHarnessDefinitions().find(e=>e.name===t.name);if(n!==void 0)return{...n,behavior:e.behavior}}let n=t.execute,r=t.owner.kind===`framework`&&t.name===ASK_QUESTION_TOOL_NAME;return{label:t.label??(t.owner.kind===`framework`&&t.name===WEB_SEARCH_TOOL_NAME?{start:resolveWebSearchActivityLabel}:void 0),approvalKey:t.approvalKey,behavior:e.behavior,description:t.description,execution:t.execution,executeInput:t.executeInput,execute:r?void 0:resolveAuthoredExecute({rawExecute:n,scope:t.name}),frameworkAction:t.owner.kind===`framework`&&t.name===LOAD_SKILL_TOOL_NAME?`load-skill`:void 0,inputSchema:t.inputSchema??UNSPECIFIED_INPUT_SCHEMA,name:t.name,approval:t.approval,outputSchema:t.outputSchema,rootOnly:e.rootOnly,toModelOutput:t.toModelOutput}}function resolveAuthoredExecute(e){let{rawExecute:t,scope:n}=e;return t===void 0?void 0:createToolExecuteWithAuth({execute:t,scope:n})}export{buildRuntimeIdentity,createExecutionNodeStep,createNodeHarnessTools};
+import{createLogger}from"#internal/logging.js";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{UNSPECIFIED_INPUT_SCHEMA}from"#tools/schema.js";import{createToolExecuteWithAuth}from"#execution/tool-auth.js";import{resolveRuntimeModelReference}from"#runtime/agent/resolve-model.js";import{createPreparedWorkflowToolHarnessDefinition,createWorkflowToolHarnessDefinition}from"#execution/tools/workflow/background.js";import{LOAD_SKILL_TOOL_NAME}from"#runtime/skills/fragment-context.js";import{dispatchDynamicModelEvent}from"#context/dynamic-model-lifecycle.js";import{preparePersistedStepDynamicToolMetadata}from"#context/dynamic-tool-lifecycle.js";import{createToolLoopHarness}from"#harness/tool-loop.js";import{createTaskToolHarnessDefinitions}from"#execution/tools/tasks.js";import{findRegisteredRuntimeTool}from"#runtime/tools/registry.js";import{preserveFrameworkStateOnCompaction}from"#execution/compaction.js";import{ASK_QUESTION_TOOL_NAME}from"#harness/request-input-tool.js";import{WEB_SEARCH_TOOL_NAME,resolveWebSearchActivityLabel}from"#harness/provider-tool-schemas.js";const log=createLogger(`execution.node-step`);function createExecutionNodeStep(e){let t=createRuntimeModelResolver(e.modelResolutionScope),n=e.node.turnAgent.dynamicModel===void 0?void 0:createRuntimeDynamicModelEventDispatcher(e.modelResolutionScope,e.node.turnAgent.dynamicModel),r=createNodeHarnessTools({node:e.node}),i=e.instrumentation,a=i?.prepareExecution(),o=createToolLoopHarness({steeringSignal:e.steeringSignal,abortSignal:e.abortSignal,capabilities:e.capabilities,clearOnly:e.clearOnly,compactOnly:e.compactOnly,handleEvent:e.handleEvent,historyProjector:e.historyProjector,historyView:e.historyView,instrumentation:a,mode:e.mode,onCompaction:preserveFrameworkStateOnCompaction,resolveStepDynamicTools:t=>preparePersistedStepDynamicToolMetadata({...t,resolvers:e.node.agent.dynamicToolResolvers??[]}),dispatchDynamicModelEvent:n,resolveModel:t,runtimeIdentity:buildRuntimeIdentity(e.node),tools:r});return i===void 0?o:async(e,t)=>{try{return await o(e,t)}finally{await i.flush()}}}function buildRuntimeIdentity(e){let t=resolveInstalledPackageInfo(),n={agentId:e.turnAgent.id,agentName:e.agent.config?.name,eveVersion:t.version},r=process.env.VERCEL_GIT_COMMIT_SHA?.trim(),i=process.env.VERCEL_GIT_COMMIT_REF?.trim(),a=process.env.VERCEL_DEPLOYMENT_CREATED_AT?.trim();return r||i||a?{...n,build:{deployedAt:a||void 0,gitBranch:i||void 0,gitSha:r||void 0}}:n}function createRuntimeModelResolver(e){return t=>resolveRuntimeModelReference(t,e)}function createRuntimeDynamicModelEventDispatcher(e,t){return n=>dispatchDynamicModelEvent({ctx:n.ctx,dynamicModel:t,event:n.event,messages:n.messages,scope:e})}function createNodeHarnessTools(e){let t=new Map;for(let n of e.node.turnAgent.tools){let r=resolveHarnessToolDefinition({node:e.node,tool:n});r!==null&&t.set(n.name,r)}return t}function resolveHarnessToolDefinition(e){let t=findRegisteredRuntimeTool(e.node.toolRegistry,e.tool.name);return isPreparedRuntimeWorkflowTool(e.tool)?t===null?createPreparedWorkflowToolHarnessDefinition(e.tool):createWorkflowToolHarnessDefinition({executeInput:t.definition.executeInput,definition:createRegisteredHarnessToolDefinition({behavior:e.tool.behavior,definition:t.definition,rootOnly:e.tool.rootOnly}),nodeId:e.tool.task.nodeId,resultKind:e.tool.task.resultKind,workflowId:e.tool.task.workflowId}):t===null?(log.warn(`declared tool is not registered — omitting from toolset`,{toolName:e.tool.name,nodeId:e.node.nodeId}),null):createRegisteredHarnessToolDefinition({behavior:e.tool.behavior,definition:t.definition,rootOnly:e.tool.rootOnly})}function isPreparedRuntimeWorkflowTool(e){return e.task!==void 0}function createRegisteredHarnessToolDefinition(e){let t=e.definition;if(t.owner.kind===`framework`){let n=createTaskToolHarnessDefinitions().find(e=>e.name===t.name);if(n!==void 0)return{...n,behavior:e.behavior}}let n=t.execute,r=t.owner.kind===`framework`&&t.name===ASK_QUESTION_TOOL_NAME;return{label:t.label??(t.owner.kind===`framework`&&t.name===WEB_SEARCH_TOOL_NAME?{start:resolveWebSearchActivityLabel}:void 0),approvalKey:t.approvalKey,behavior:e.behavior,description:t.description,execution:t.execution,executeInput:t.executeInput,execute:r?void 0:resolveAuthoredExecute({rawExecute:n,scope:t.name}),frameworkAction:t.owner.kind===`framework`&&t.name===LOAD_SKILL_TOOL_NAME?`load-skill`:void 0,inputSchema:t.inputSchema??UNSPECIFIED_INPUT_SCHEMA,name:t.name,approval:t.approval,outputSchema:t.outputSchema,rootOnly:e.rootOnly,toModelOutput:t.toModelOutput}}function resolveAuthoredExecute(e){let{rawExecute:t,scope:n}=e;return t===void 0?void 0:createToolExecuteWithAuth({execute:t,scope:n})}export{buildRuntimeIdentity,createExecutionNodeStep,createNodeHarnessTools};

package/dist/src/execution/proxied-deliver-step.d.ts

@@ -1,4 +1,4 @@
-import type { DeliverHookPayload, DeliverPayload, SessionAuthContext } from "#channel/types.js";
+import type { DeliverHookPayload } from "#channel/types.js";
 import { type DurableSessionState } from "#execution/durable-session-store.js";
 export type RoutedDeliverResult = {
     readonly kind: "cancel-turn";
@@ -10,28 +10,10 @@ export type RoutedDeliverResult = {
     readonly serializedContext: Record<string, unknown>;
     readonly sessionState: DurableSessionState;
 };
-type LegacyRoutedDeliverResult = {
-    readonly kind: "cancel-turn";
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-} | {
-    readonly kind: "continue";
-    readonly remainder: DeliverPayload | undefined;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-};
 /** Splits an envelope and validates task routes before forwarding descendant input. */
 export declare function routeProxiedDeliverStep(input: {
     readonly delivery: DeliverHookPayload;
-    readonly parentWritable: WritableStream<Uint8Array>;
+    readonly sessionWritable: WritableStream<Uint8Array>;
     readonly serializedContext?: Record<string, unknown>;
     readonly sessionState: DurableSessionState;
 }): Promise<RoutedDeliverResult>;
-export declare function routeProxiedDeliverStep(input: {
-    readonly auth?: SessionAuthContext | null;
-    readonly parentWritable: WritableStream<Uint8Array>;
-    readonly payload: DeliverPayload;
-    readonly serializedContext?: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}): Promise<LegacyRoutedDeliverResult>;
-export {};

package/dist/src/execution/proxied-deliver-step.js

@@ -1 +1 @@
-import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{resumeSessionInbox}from"#execution/wire/session-inbox-resume.js";import{createTaskInputRequestId,retireProxyInputRequests}from"#harness/proxy-input-requests.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{routeDeliverPayload}from"#subagents/hitl-proxy.js";import{sendTaskInboundPayload}from"#execution/tasks/parent/run-parent.js";import{resumeWorkflowToolRunAnswers}from"#execution/tools/workflow/answer.js";async function routeProxiedDeliverStep(e){"use step";let t=await readDurableSession(e.sessionState),n=!(`delivery`in e),r=`delivery`in e?e.delivery:{auth:e.auth,kind:`deliver`,payloads:[e.payload]},i=new Map,a=new Map,o;for(let[e,n]of r.payloads.entries()){let s=routeDeliverPayload({allowRoute:(e,n)=>n.taskId===void 0||findSessionTaskEntry(t.state,n.taskId)!==void 0,payload:n,state:t.state});o??=s.parentAction,s.forSelf!==void 0&&i.set(e,s.forSelf);for(let[t,n]of s.forChildren.entries()){let i=[n.childContinuationToken,n.childSessionInbox?.sessionId??``,n.childResponseUrl??``,n.taskId??``].join(`\0`),o=a.get(i)??{answerHook:n.answerHook,childContinuationToken:n.childContinuationToken,childSessionInbox:n.childSessionInbox,childResponseUrl:n.childResponseUrl,metadata:[],payloads:[],retireRequestIds:[],sourcePayloadIndexes:[],taskId:n.taskId},c=o.payloads.length;if(o.payloads.push(n.payload),o.retireRequestIds.push(...n.retireRequestIds),o.sourcePayloadIndexes.push(e),s.forSelf===void 0&&t===0)for(let t of r.deliveryMetadata??[])t.payloadIndex===e&&o.metadata.push({...t,payloadIndex:c});a.set(i,o)}}let s=!1;for(let e of a.values()){let n=e.taskId;if(n!==void 0){let a=findSessionTaskEntry(t.state,n);if(a===void 0){mergeStrandedResponses(i,e,n);continue}if(await sendTaskInboundPayload({taskInboxToken:a.taskInboxToken,payload:{auth:r.auth,childContinuationToken:e.childContinuationToken,childSessionInbox:e.childSessionInbox,childResponseUrl:e.childResponseUrl,inputResponses:coalesceDeliverPayloads(e.payloads).inputResponses??[],kind:`input-response`,taskId:n}})===`unreachable`){mergeStrandedResponses(i,e,n);continue}t=retireProxyInputRequests(t,e.retireRequestIds),s=!0;continue}if(e.answerHook!==void 0){await resumeWorkflowToolRunAnswers(e.childContinuationToken,coalesceDeliverPayloads(e.payloads).inputResponses),t=retireProxyInputRequests(t,e.retireRequestIds),s=!0;continue}let a={...r,deliveryMetadata:e.metadata.length===0?void 0:e.metadata,payloads:e.payloads};await resumeSessionInbox(e.childSessionInbox??e.childContinuationToken,a),t=retireProxyInputRequests(t,e.retireRequestIds),s=!0}let c={serializedContext:e.serializedContext??{},sessionState:s?replaceDurableSessionSnapshot({session:t,state:e.sessionState}):e.sessionState};if(o!==void 0)return{...c,...o};let l=[...i].sort(([e],[t])=>e-t),u=l.flatMap(([e],t)=>(r.deliveryMetadata??[]).filter(t=>t.payloadIndex===e).map(e=>({...e,payloadIndex:t}))),d=l.length===0?void 0:n?coalesceDeliverPayloads(l.map(([,e])=>e)):{...r,deliveryMetadata:u.length===0?void 0:u,payloads:l.map(([,e])=>e)};return{...c,kind:`continue`,remainder:d}}function mergeStrandedResponses(e,t,n){for(let[r,i]of t.payloads.entries()){let a=t.sourcePayloadIndexes[r];if(a===void 0)continue;let o=(i.inputResponses??[]).map(e=>({...e,requestId:createTaskInputRequestId(n,e.requestId)}));if(o.length===0)continue;let s=e.get(a);e.set(a,{...s,inputResponses:[...s?.inputResponses??[],...o]})}}export{routeProxiedDeliverStep};
+import{readDurableSession,replaceDurableSessionSnapshot}from"#execution/durable-session-store.js";import{findSessionTaskEntry}from"#tasks/session-index.js";import{resumeSessionInbox}from"#execution/session-inbox/resume.js";import{createTaskInputRequestId,retireProxyInputRequests}from"#harness/proxy-input-requests.js";import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{routeDeliverPayload}from"#subagents/hitl-proxy.js";import{sendTaskInboundPayload}from"#execution/tasks/parent/run-parent.js";import{resumeWorkflowToolRunAnswers}from"#execution/tools/workflow/answer.js";async function routeProxiedDeliverStep(e){"use step";let t=readDurableSession(e.sessionState),n=e.delivery,r=new Map,i=new Map,a;for(let[e,o]of n.payloads.entries()){let s=routeDeliverPayload({allowRoute:(e,n)=>n.taskId===void 0||findSessionTaskEntry(t.state,n.taskId)!==void 0,payload:o,state:t.state});a??=s.parentAction,s.forSelf!==void 0&&r.set(e,s.forSelf);for(let[t,r]of s.forChildren.entries()){let a=[r.childContinuationToken,r.childSessionInbox?.sessionId??``,r.childResponseUrl??``,r.taskId??``].join(`\0`),o=i.get(a)??{answerHook:r.answerHook,childContinuationToken:r.childContinuationToken,childSessionInbox:r.childSessionInbox,childResponseUrl:r.childResponseUrl,metadata:[],payloads:[],retireRequestIds:[],sourcePayloadIndexes:[],taskId:r.taskId},c=o.payloads.length;if(o.payloads.push(r.payload),o.retireRequestIds.push(...r.retireRequestIds),o.sourcePayloadIndexes.push(e),s.forSelf===void 0&&t===0)for(let t of n.deliveryMetadata??[])t.payloadIndex===e&&o.metadata.push({...t,payloadIndex:c});i.set(a,o)}}let o=!1;for(let e of i.values()){let i=e.taskId;if(i!==void 0){let a=findSessionTaskEntry(t.state,i);if(a===void 0){mergeStrandedResponses(r,e,i);continue}if(await sendTaskInboundPayload({taskInboxToken:a.taskInboxToken,payload:{auth:n.auth,childContinuationToken:e.childContinuationToken,childSessionInbox:e.childSessionInbox,childResponseUrl:e.childResponseUrl,inputResponses:coalesceDeliverPayloads(e.payloads).inputResponses??[],kind:`input-response`,taskId:i}})===`unreachable`){mergeStrandedResponses(r,e,i);continue}t=retireProxyInputRequests(t,e.retireRequestIds),o=!0;continue}if(e.answerHook!==void 0){await resumeWorkflowToolRunAnswers(e.childContinuationToken,coalesceDeliverPayloads(e.payloads).inputResponses),t=retireProxyInputRequests(t,e.retireRequestIds),o=!0;continue}let a={...n,deliveryMetadata:e.metadata.length===0?void 0:e.metadata,payloads:e.payloads};await resumeSessionInbox(e.childSessionInbox??e.childContinuationToken,a),t=retireProxyInputRequests(t,e.retireRequestIds),o=!0}let s={serializedContext:e.serializedContext??{},sessionState:o?replaceDurableSessionSnapshot({session:t,state:e.sessionState}):e.sessionState};if(a!==void 0)return{...s,...a};let c=[...r].sort(([e],[t])=>e-t),l=c.flatMap(([e],t)=>(n.deliveryMetadata??[]).filter(t=>t.payloadIndex===e).map(e=>({...e,payloadIndex:t}))),u=c.length===0?void 0:{...n,deliveryMetadata:l.length===0?void 0:l,payloads:c.map(([,e])=>e)};return{...s,kind:`continue`,remainder:u}}function mergeStrandedResponses(e,t,n){for(let[r,i]of t.payloads.entries()){let a=t.sourcePayloadIndexes[r];if(a===void 0)continue;let o=(i.inputResponses??[]).map(e=>({...e,requestId:createTaskInputRequestId(n,e.requestId)}));if(o.length===0)continue;let s=e.get(a);e.set(a,{...s,inputResponses:[...s?.inputResponses??[],...o]})}}export{routeProxiedDeliverStep};

package/dist/src/execution/reconcile-session-continuation-token.d.ts

@@ -1,4 +1,4 @@
 import type { ContextAccessor } from "#context/key.js";
 import type { HarnessSession } from "#harness/types.js";
-/** Re-stamps a session after a channel handler changes its continuation token. */
+/** Re-stamps a session after a channel handler selects a new current continuation address. */
 export declare function reconcileSessionContinuationToken(ctx: ContextAccessor, session: HarnessSession): HarnessSession;

package/dist/src/execution/report-dropped-wire-payload-step.d.ts

@@ -2,7 +2,7 @@
  * Surfaces a durable payload dropped by a wire codec's decode.
  *
  * Workflow-context consumers cannot log directly — the logging module pulls
- * Node builtins the workflow driver bundle must not contain — so the report
+ * Node builtins the session owner bundle must not contain — so the report
  * crosses a step boundary. The recorded step also leaves a durable trace in
  * the run's event log, which is the operator-visible half of the "drop
  * loudly, never reinterpret" wire contract.

package/dist/src/execution/route-child-delivery.d.ts

@@ -8,12 +8,12 @@ import { type RoutedDeliverResult } from "#execution/proxied-deliver-step.js";
  *
  * Short-circuits via `hasProxyInputRequests` so the common no-active-descendant
  * path skips a durable step boundary. Lives in its own non-step module so both
- * the driver and the active turn can share it (a `"use step"` module cannot
+ * the owner and the active turn can share it (a `"use step"` module cannot
  * re-export plain helpers into a workflow body).
  */
 export declare function routeDeliverToChildren(input: {
     readonly delivery: DeliverHookPayload;
-    readonly parentWritable: WritableStream<Uint8Array>;
+    readonly sessionWritable: WritableStream<Uint8Array>;
     readonly sessionState: DurableSessionState;
     readonly serializedContext: Record<string, unknown>;
 }): Promise<RoutedDeliverResult>;

package/dist/src/execution/route-child-delivery.js

@@ -1 +1 @@
-import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{routeProxiedDeliverStep}from"#execution/proxied-deliver-step.js";import{emitRecordedTaskInputRequestStep,runProxySubagentEventStep}from"#subagents/event-proxy-step.js";import{recordTaskInputRequestStep,recordTerminalTaskViewsStep}from"#execution/tasks/parent/hitl-proxy-steps.js";import{acceptTaskAuthorizationEventStep}from"#execution/tools/subagent/accept-event-step.js";import{applyTaskAgentRequest}from"#execution/tools/subagent/task-agent-requests.js";async function routeDeliverToChildren(e){let t=coalesceDeliverPayloads(e.delivery.payloads),n=e.serializedContext,r=e.sessionState;for(let i of t.task?.inputRequests??[]){let t=await recordTaskInputRequestStep({request:i,sessionState:r});if(r=t.sessionState,!t.accepted)continue;let a=await emitRecordedTaskInputRequestStep({parentWritable:e.parentWritable,request:t.request,serializedContext:n,sessionState:r});n=a.serializedContext,r=a.sessionState}for(let i of t.task?.agentRequests??[]){let t=await applyTaskAgentRequest({...i,ownerId:i.taskId},{parentWritable:e.parentWritable,serializedContext:n,sessionState:r});n=t.serializedContext,r=t.sessionState}for(let i of t.task?.authorizationEvents??[]){if(!await acceptTaskAuthorizationEventStep({delivery:i,sessionState:r}))continue;let t=await runProxySubagentEventStep({hookPayload:i.hookPayload,parentWritable:e.parentWritable,serializedContext:n,sessionState:r});n=t.serializedContext,r=t.sessionState}if((t.task?.views?.length??0)>0){let e=await recordTerminalTaskViewsStep({serializedContext:n,sessionState:r,views:t.task?.views??[]});n=e.serializedContext,r=e.sessionState}let i=[],a=[];for(let[t,n]of e.delivery.payloads.entries()){let r={...n};if(delete r.task,Object.keys(r).length===0)continue;let o=i.length;i.push(r);for(let n of e.delivery.deliveryMetadata??[])n.payloadIndex===t&&a.push({...n,payloadIndex:o})}let o=i.length===0?void 0:{...e.delivery,deliveryMetadata:a.length===0?void 0:a,payloads:i};return o===void 0?{kind:`continue`,remainder:void 0,serializedContext:n,sessionState:r}:r.hasProxyInputRequests?await routeProxiedDeliverStep({delivery:o,parentWritable:e.parentWritable,serializedContext:n,sessionState:r}):{kind:`continue`,remainder:o,serializedContext:n,sessionState:r}}export{routeDeliverToChildren};
+import{coalesceDeliverPayloads}from"#execution/deliver-payloads.js";import{routeProxiedDeliverStep}from"#execution/proxied-deliver-step.js";import{emitRecordedTaskInputRequestStep,runProxySubagentEventStep}from"#subagents/event-proxy-step.js";import{recordTaskInputRequestStep,recordTerminalTaskViewsStep}from"#execution/tasks/parent/hitl-proxy-steps.js";import{acceptTaskAuthorizationEventStep}from"#execution/tools/subagent/accept-event-step.js";import{applyTaskAgentRequest}from"#execution/tools/subagent/task-agent-requests.js";async function routeDeliverToChildren(e){let t=coalesceDeliverPayloads(e.delivery.payloads),n=e.serializedContext,r=e.sessionState;for(let i of t.task?.inputRequests??[]){let t=await recordTaskInputRequestStep({request:i,sessionState:r});if(r=t.sessionState,!t.accepted)continue;let a=await emitRecordedTaskInputRequestStep({sessionWritable:e.sessionWritable,request:t.request,serializedContext:n,sessionState:r});n=a.serializedContext,r=a.sessionState}for(let i of t.task?.agentRequests??[]){let t=await applyTaskAgentRequest({...i,ownerId:i.taskId},{sessionWritable:e.sessionWritable,serializedContext:n,sessionState:r});n=t.serializedContext,r=t.sessionState}for(let i of t.task?.authorizationEvents??[]){if(!await acceptTaskAuthorizationEventStep({delivery:i,sessionState:r}))continue;let t=await runProxySubagentEventStep({hookPayload:i.hookPayload,sessionWritable:e.sessionWritable,serializedContext:n,sessionState:r});n=t.serializedContext,r=t.sessionState}if((t.task?.views?.length??0)>0){let e=await recordTerminalTaskViewsStep({serializedContext:n,sessionState:r,views:t.task?.views??[]});n=e.serializedContext,r=e.sessionState}let i=[],a=[];for(let[t,n]of e.delivery.payloads.entries()){let r={...n};if(delete r.task,Object.keys(r).length===0)continue;let o=i.length;i.push(r);for(let n of e.delivery.deliveryMetadata??[])n.payloadIndex===t&&a.push({...n,payloadIndex:o})}let o=i.length===0?void 0:{...e.delivery,deliveryMetadata:a.length===0?void 0:a,payloads:i};return o===void 0?{kind:`continue`,remainder:void 0,serializedContext:n,sessionState:r}:r.hasProxyInputRequests?await routeProxiedDeliverStep({delivery:o,sessionWritable:e.sessionWritable,serializedContext:n,sessionState:r}):{kind:`continue`,remainder:o,serializedContext:n,sessionState:r}}export{routeDeliverToChildren};

package/dist/src/execution/runtime-context.js

@@ -1 +1 @@
-import{ConversationContextKey}from"#shared/conversation-context.js";import{ContextContainer,contextStorage}from"#context/container.js";import{ActivityObserverKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationTokenKey,ConversationIdKey,DynamicSubagentAgentConfigKey,InitiatorAuthKey,ModeKey,ParentSessionKey,ParentTraceContextKey,ScheduleIdKey,SessionCallbackKey,SessionTitleKey}from"#context/keys.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{readConversationId}from"#tracing/conversation-context.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{setChannelContext}from"#execution/channel-context.js";import{buildConversationContext}from"#channel/conversation-context.js";function buildRunContext(e){let{bundle:t,run:n}=e,r=new ContextContainer,i=n.auth,a=readConversationId(n.conversationId);if(a!==void 0&&r.set(ConversationIdKey,a),r.set(BundleKey,t),setChannelContext(r,n.adapter,{channelName:n.channelName}),r.set(ConversationContextKey,buildConversationContext(n,resolveInstrumentationEnvironment())),n.parent===void 0){let e=deriveSessionTitle(n.title??n.input.message);e!==void 0&&r.set(SessionTitleKey,e)}if(n.channelMetadata!==void 0){let e=r.get(ChannelInstrumentationKey);r.set(ChannelInstrumentationKey,{channelType:e?.channelType??n.channelMetadata.channelType,kind:e?.kind??n.channelMetadata.kind,metadata:n.channelMetadata.metadata})}n.continuationToken!==void 0&&r.set(ContinuationTokenKey,n.continuationToken),r.set(ModeKey,n.mode),r.set(AuthKey,i),r.set(InitiatorAuthKey,n.initiatorAuth??i),e.dynamicSubagentAgentConfig!==void 0&&r.set(DynamicSubagentAgentConfigKey,e.dynamicSubagentAgentConfig),n.capabilities!==void 0&&r.set(CapabilitiesKey,n.capabilities),n.requestId!==void 0&&r.set(ChannelRequestIdKey,n.requestId);let o=contextStorage.getStore()?.get(ScheduleIdKey);return o!==void 0&&r.set(ScheduleIdKey,o),n.delivery!==void 0&&r.set(ChannelDeliveryKey,n.delivery),n.callback!==void 0&&r.set(SessionCallbackKey,n.callback),n.activityObserver!==void 0&&r.set(ActivityObserverKey,n.activityObserver),n.parent!==void 0&&r.set(ParentSessionKey,n.parent),n.parentTraceContext!==void 0&&r.set(ParentTraceContextKey,n.parentTraceContext),r}export{buildRunContext};
+import{ConversationContextKey}from"#shared/conversation-context.js";import{ContextContainer,contextStorage}from"#context/container.js";import{ActivityObserverKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationHookTokensKey,ContinuationTokenKey,ConversationIdKey,DynamicSubagentAgentConfigKey,InitiatorAuthKey,ModeKey,ParentSessionKey,ParentTraceContextKey,ScheduleIdKey,SessionCallbackKey,SessionTitleKey}from"#context/keys.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{resolveInstrumentationEnvironment}from"#internal/application/dev-environment.js";import{readConversationId}from"#tracing/conversation-context.js";import{setChannelContext}from"#execution/channel-context.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{buildConversationContext}from"#channel/conversation-context.js";function buildRunContext(e){let{bundle:t,run:n}=e,r=new ContextContainer,i=n.auth,a=readConversationId(n.conversationId);if(a!==void 0&&r.set(ConversationIdKey,a),r.set(BundleKey,t),setChannelContext(r,n.adapter,{channelName:n.channelName}),r.set(ConversationContextKey,buildConversationContext(n,resolveInstrumentationEnvironment())),n.parent===void 0){let e=deriveSessionTitle(n.title??n.input.message);e!==void 0&&r.set(SessionTitleKey,e)}if(n.channelMetadata!==void 0){let e=r.get(ChannelInstrumentationKey);r.set(ChannelInstrumentationKey,{channelType:e?.channelType??n.channelMetadata.channelType,kind:e?.kind??n.channelMetadata.kind,metadata:n.channelMetadata.metadata})}n.continuationToken!==void 0&&(r.set(ContinuationTokenKey,n.continuationToken),r.set(ContinuationHookTokensKey,[n.continuationToken])),r.set(ModeKey,n.mode),r.set(AuthKey,i),r.set(InitiatorAuthKey,n.initiatorAuth??i),e.dynamicSubagentAgentConfig!==void 0&&r.set(DynamicSubagentAgentConfigKey,e.dynamicSubagentAgentConfig),n.capabilities!==void 0&&r.set(CapabilitiesKey,n.capabilities),n.requestId!==void 0&&r.set(ChannelRequestIdKey,n.requestId);let o=contextStorage.getStore()?.get(ScheduleIdKey);return o!==void 0&&r.set(ScheduleIdKey,o),n.delivery!==void 0&&r.set(ChannelDeliveryKey,n.delivery),n.callback!==void 0&&r.set(SessionCallbackKey,n.callback),n.activityObserver!==void 0&&r.set(ActivityObserverKey,n.activityObserver),n.parent!==void 0&&r.set(ParentSessionKey,n.parent),n.parentTraceContext!==void 0&&r.set(ParentTraceContextKey,n.parentTraceContext),r}export{buildRunContext};

package/dist/src/execution/sandbox/bindings/eve-image.js

@@ -1 +1 @@
-import{resolveInstalledPackageInfo}from"#internal/application/package.js";function resolveEveSandboxImage(){return`ghcr.io/vercel/eve:${resolveEveSandboxImageTag()}`}function resolveVercelEveSandboxImage(){return`vcr.vercel.com/vercel/eve/base:${resolveEveSandboxImageTag()}`}function resolveEveSandboxImageTag(){let e=process.env.EVE_SANDBOX_IMAGE_TAG?.trim();return e!==void 0&&e.length>0?e:resolveInstalledPackageInfo().version}const DEFAULT_EVE_SANDBOX_IMAGE=resolveEveSandboxImage(),VERCEL_EVE_SANDBOX_IMAGE=resolveVercelEveSandboxImage();export{DEFAULT_EVE_SANDBOX_IMAGE,VERCEL_EVE_SANDBOX_IMAGE,resolveEveSandboxImage,resolveVercelEveSandboxImage};
+import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{stripVersionBuildMetadata}from"#shared/package-version.js";function resolveEveSandboxImage(){return`ghcr.io/vercel/eve:${resolveEveSandboxImageTag()}`}function resolveVercelEveSandboxImage(){return`vcr.vercel.com/vercel/eve/base:${resolveEveSandboxImageTag()}`}function resolveEveSandboxImageTag(){let e=process.env.EVE_SANDBOX_IMAGE_TAG?.trim();return e!==void 0&&e.length>0?e:stripVersionBuildMetadata(resolveInstalledPackageInfo().version)}const DEFAULT_EVE_SANDBOX_IMAGE=resolveEveSandboxImage(),VERCEL_EVE_SANDBOX_IMAGE=resolveVercelEveSandboxImage();export{DEFAULT_EVE_SANDBOX_IMAGE,VERCEL_EVE_SANDBOX_IMAGE,resolveEveSandboxImage,resolveVercelEveSandboxImage};

package/dist/src/execution/session/accepted-deployment.d.ts

@@ -0,0 +1,3 @@
+import type { DeliverHookPayload } from "#channel/types.js";
+/** Exact trusted deployment shared by every payload in a delivery. */
+export declare function readAcceptedDeploymentId(delivery: DeliverHookPayload): string | undefined;

package/dist/src/execution/session/accepted-deployment.js

@@ -0,0 +1 @@
+function readAcceptedDeploymentId(e){let t=e.deliveryMetadata?.[0]?.acceptedDeploymentId;if(t!==void 0&&t.length!==0&&t!==`latest`)return e.deliveryMetadata?.every(e=>e.acceptedDeploymentId===t)?t:void 0}export{readAcceptedDeploymentId};

package/dist/src/execution/session/admission.d.ts

@@ -0,0 +1,38 @@
+import type { RuntimeActionResultHookPayload, SessionCommand } from "#channel/types.js";
+import type { DeliveryAdmission, SessionInputQueue } from "#execution/session/input-queue.js";
+import { type SessionInboxPayload } from "#execution/session-inbox/inbox.js";
+import type { SessionStateCursor } from "#execution/session/state-cursor.js";
+import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
+export type SessionCancellation = Extract<SessionCommand, {
+    readonly kind: "cancel";
+}>;
+/** One canonical admission result, after wire decoding but before turn policy. */
+export type SessionAdmission = {
+    readonly admission: DeliveryAdmission;
+    readonly kind: "delivery";
+} | {
+    readonly command: SessionCancellation;
+    readonly kind: "cancel";
+} | {
+    readonly kind: "consumed";
+} | {
+    readonly kind: "runtime-action-result";
+    readonly payload: RuntimeActionResultHookPayload;
+} | {
+    readonly kind: "workflow";
+    readonly message: WorkflowToolRunMessage;
+};
+/**
+ * Decodes and admits one inbox payload. This boundary never decides whether a
+ * delivery steers, starts a turn, or routes to a child; those are selection
+ * and delivery-routing policies owned by their respective layers.
+ */
+export declare function admitSessionInboxPayload(value: SessionInboxPayload, input: {
+    readonly cursor: SessionStateCursor;
+    readonly queue: SessionInputQueue;
+}): Promise<SessionAdmission>;
+/** Applies accepted cancellation effects after the active-turn guard passes. */
+export declare function applySessionCancellation(command: SessionCancellation, input: {
+    readonly cursor: SessionStateCursor;
+    readonly queue: SessionInputQueue;
+}): Promise<void>;

package/dist/src/execution/session/admission.js

@@ -0,0 +1 @@
+import{getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{isWorkflowMessage}from"#execution/session-inbox/inbox.js";import{runProxySubagentEventStep}from"#subagents/event-proxy-step.js";import{cancelAllIndexedSessionTasksStep}from"#execution/cancel-indexed-session-tasks-step.js";import{SessionInboxPayloadError,decodeSessionInboxPayload}from"#execution/session-inbox/protocol.js";import{reportDroppedWirePayloadStep}from"#execution/report-dropped-wire-payload-step.js";import{findRunningAgentHandle}from"#subagents/handles/query.js";async function admitSessionInboxPayload(e,t){if(e.kind===`runtime-action-result`)return{kind:`runtime-action-result`,payload:e};if(isWorkflowMessage(e))return{kind:`workflow`,message:e};if(e.kind===`authorization-callback`)return t.queue.enqueueAuthorization(e.payloads),{kind:`consumed`};if(e.kind===`subagent-input-request`||e.kind===`subagent-authorization-event`){let n=findRunningAgentHandle(t.cursor.sessionState.snapshot.session.state,{callId:e.callId});return n?.identity.name===e.subagentName&&n.address.sessionId===e.childSessionId&&await t.cursor.apply(await runProxySubagentEventStep({hookPayload:e,sessionWritable:t.cursor.sessionWritable,serializedContext:t.cursor.serializedContext,sessionState:t.cursor.sessionState})),{kind:`consumed`}}let n;try{n=decodeSessionInboxPayload(e)}catch(e){if(!(e instanceof SessionInboxPayloadError))throw e;return await reportDroppedWirePayloadStep({detail:e.message,family:`session-inbox`}),{kind:`consumed`}}switch(n.kind){case`deliver`:{let e=t.queue.enqueueDelivery(n);return e===void 0?{kind:`consumed`}:{admission:e,kind:`delivery`}}case`clear`:case`compact`:return t.queue.enqueueControl(n.kind),{kind:`consumed`};case`session-timeout`:return n.ownerRunId===getWorkflowMetadata().workflowRunId&&t.queue.enqueueControl(`expired`),{kind:`consumed`};case`reset`:return t.queue.enqueueControl(`reset`),{command:{kind:`cancel`},kind:`cancel`};case`cancel`:return{command:n,kind:`cancel`}}}async function applySessionCancellation(e,t){e.tasks===!0&&await cancelAllIndexedSessionTasksStep({serializedContext:t.cursor.serializedContext,sessionState:t.cursor.sessionState}),e.taskId!==void 0&&t.queue.cancelTask(e.taskId)}export{admitSessionInboxPayload,applySessionCancellation};

package/dist/src/execution/session/entry-input.d.ts

@@ -0,0 +1,42 @@
+import type { TokenUsage } from "#shared/token-usage.js";
+import type { DeliverHookPayload, RunInput, SessionCommand } from "#channel/types.js";
+import type { SessionCheckpoint } from "#execution/session/handoff.js";
+import type { AgentWorkflowRetentionDefinition } from "#shared/agent-definition.js";
+/**
+ * Serializable workflow-entry input. All runtime state travels via
+ * `serializedContext`, which is produced by `serializeContext(ctx)`
+ * and deserialized at each `"use step"` boundary.
+ */
+export interface InitialWorkflowEntryInput {
+    readonly activityCollectorRunId?: string;
+    readonly continuationConflictCommand?: Extract<SessionCommand, {
+        readonly kind: "send";
+    }>;
+    readonly input: RunInput["input"];
+    readonly kind: "initial";
+    readonly limits?: RunInput["limits"];
+    readonly ownerDeploymentId: string;
+    readonly retention?: AgentWorkflowRetentionDefinition;
+    readonly sessionTimeoutMs?: number | false;
+    readonly serializedContext: Record<string, unknown>;
+    readonly taskId?: string;
+}
+/** A successor owner started by a previous owner during a deployment handoff. */
+export interface HandoffWorkflowEntryInput {
+    readonly activationToken: string;
+    readonly checkpoint: SessionCheckpoint;
+    /** The one delivery that triggered the handoff; processed before any later arrival. */
+    readonly delivery: DeliverHookPayload;
+    readonly kind: "handoff";
+    readonly ownerDeploymentId: string;
+    readonly sessionWritable: WritableStream<Uint8Array>;
+    /** Stable public identity; also the original run that anchors the stream. */
+    readonly sessionId: string;
+}
+export type WorkflowEntryInput = InitialWorkflowEntryInput | HandoffWorkflowEntryInput;
+export interface WorkflowEntryResult {
+    readonly isError?: boolean;
+    readonly usage?: TokenUsage;
+    readonly usageDelta?: TokenUsage;
+    readonly output: unknown;
+}

package/dist/src/execution/session/entry-input.js

@@ -0,0 +1 @@
+export{};

package/dist/src/execution/session/entry.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowEntryInput, WorkflowEntryResult } from "#execution/session/entry-input.js";
+/**
+ * Long-lived workflow entrypoint. Handles both root sessions and
+ * delegated child sessions: root sessions expose only parent
+ * control-plane events; delegated children publish their full progress
+ * on a child stream and resume the parked parent with a
+ * `subagent-result` on completion.
+ *
+ * The current owner directly executes every turn. An idle owner can transfer
+ * its settled checkpoint and hooks to an exact successor deployment while the
+ * original run remains parked as the public stream anchor.
+ */
+export declare function workflowEntry(input: WorkflowEntryInput): Promise<WorkflowEntryResult>;

package/dist/src/execution/session/entry.js

@@ -0,0 +1 @@
+import{attachClientContext,readClientContext}from"#internal/client-context.js";import{SESSION_INBOX_CONTEXT_KEY,sessionCommandHookToken}from"#execution/session-inbox/address.js";import{getWorkflowMetadata,getWritable}from"#compiled/@workflow/core/index.js";import{isHookConflictError}from"#execution/hook-ownership.js";import{DEFAULT_SESSION_TIMEOUT_MS,sessionTimeoutDeadline}from"#execution/session/timeout.js";import{sessionHookTokens}from"#execution/session/hook-tokens.js";import{createSessionInbox}from"#execution/session-inbox/inbox.js";import{failSession,runPreparedSession}from"#execution/session/program.js";import{readChannelRequestId,readRootSessionId}from"#execution/eve-workflow-attributes.js";import{resolveInitialTurnCallerStep}from"#subagents/parent-notification.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{createSessionStep}from"#execution/create-session-step.js";import{settleContinuationConflictStep}from"#execution/continuation-conflict-step.js";import{signalSessionOwnerActivationStep,validateSessionCheckpointStep}from"#execution/session/handoff-steps.js";async function workflowEntry(e){"use workflow";let t=e.kind===`initial`?await bootInitialOwner(e,getWorkflowMetadata().workflowRunId):await bootHandoffOwner(e);return t===void 0?{output:``}:{output:(await runPreparedSession(t.session,t.inbox)).output}}function stampSessionIdentity(e,t){return{...e,"eve.sessionId":t,[SESSION_INBOX_CONTEXT_KEY]:{sessionId:t}}}async function bootInitialOwner(e,t){let n=stampSessionIdentity(e.serializedContext,t),r=getWritable(),i=n[`eve.mode`],a=createSessionInbox(t),{workflowStartedAt:o}=getWorkflowMetadata(),s=e.sessionTimeoutMs??DEFAULT_SESSION_TIMEOUT_MS,c=n[`eve.continuationToken`]||``,l=n[`eve.bundle`];try{let[u,d,f]=await Promise.allSettled([createSessionStep({compiledArtifactsSource:l.source,continuationToken:c,dynamicSubagentAgentConfig:n[`eve.dynamicSubagentAgentConfig`],inheritedLimits:e.limits,nodeId:l.nodeId,outputSchema:e.input.outputSchema,rootSessionId:readRootSessionId(n),sessionId:t,taskId:e.taskId}),a.claimSessionHook(sessionCommandHookToken(t)),c===``?Promise.resolve():a.claimSessionHook(c)]);if(u.status===`rejected`)throw u.reason;if(d.status===`rejected`)throw d.reason;if(f.status===`rejected`){if(!isHookConflictError(f.reason))throw f.reason;(e.activityCollectorRunId!==void 0||e.continuationConflictCommand!==void 0)&&await settleContinuationConflictStep({activityCollectorRunId:e.activityCollectorRunId,command:e.continuationConflictCommand,continuationToken:c}),await a.dispose();return}return{inbox:a,session:{anchor:{kind:`self`},caller:hasDelegatedCallerContext(n)?await resolveInitialTurnCallerStep({serializedContext:n}):void 0,capabilities:n[`eve.capabilities`],deploymentId:e.ownerDeploymentId,initialInput:createInitialDelivery(e,n),mode:i,retention:e.retention,serializedContext:n,sessionId:t,sessionState:u.value.state,sessionTimeoutMs:s,sessionTimeoutDeadline:sessionTimeoutDeadline(s,o.getTime()),sessionWritable:r}}}catch(e){return await a.dispose(),await failSession({error:e,mode:i,serializedContext:n,sessionId:t,sessionState:void 0,sessionWritable:r})}}async function bootHandoffOwner(e){let{checkpoint:t,sessionId:n}=e,r=stampSessionIdentity(t.serializedContext,n),i=createSessionInbox(n);try{await validateSessionCheckpointStep({checkpoint:t}),await i.claimSessionHooks(sessionHookTokens({serializedContext:r,sessionState:t.sessionState})),await signalSessionOwnerActivationStep({activation:{kind:`active`},token:e.activationToken})}catch(t){let n=await i.release();await signalSessionOwnerActivationStep({activation:{error:normalizeSerializableError(t),kind:`failed`,payloads:n},token:e.activationToken});return}return{inbox:i,session:{anchor:{kind:`successor`},caller:e.delivery.caller,capabilities:t.capabilities,deploymentId:e.ownerDeploymentId,initialInput:e.delivery,mode:t.mode,retention:t.retention,serializedContext:r,sessionId:n,sessionState:t.sessionState,sessionTimeoutMs:t.sessionTimeoutMs,sessionTimeoutDeadline:sessionTimeoutDeadline(t.sessionTimeoutMs,Date.now()),sessionWritable:e.sessionWritable}}}function hasDelegatedCallerContext(e){if(e[`eve.sessionCallback`]!==void 0)return!0;let t=e[`eve.channel`];return typeof t==`object`&&!!t&&Reflect.get(t,`kind`)===`subagent`}function createInitialDelivery(e,t){return{deliveryMetadata:t[`eve.channelDelivery`]===void 0?void 0:[{...t[`eve.channelDelivery`],payloadIndex:0}],kind:`deliver`,payloads:[attachClientContext({message:e.input.message,context:e.input.context,outputSchema:e.input.outputSchema},readClientContext(e.input))],requestId:readChannelRequestId(t)}}workflowEntry.workflowId=`workflow//eve//workflowEntry`;export{workflowEntry};

package/dist/src/execution/session/event-sink.d.ts

@@ -0,0 +1,31 @@
+import { buildAdapterContext } from "#channel/adapter-context.js";
+import { type ChannelAdapter } from "#channel/adapter.js";
+import type { ContextContainer } from "#context/container.js";
+import { bindDynamicConnections } from "#execution/dynamic-connections.js";
+import type { resolveEffectiveAgentRuntime } from "#execution/effective-agent-config.js";
+import type { HandleEventFn } from "#harness/types.js";
+import type { ExecutionInstrumentation } from "#instrumentation/runtime.js";
+import type { CompiledBundle } from "#runtime/sessions/runtime-context-keys.js";
+export interface SessionEventSinkInput {
+    readonly abortSignal: AbortSignal | undefined;
+    readonly adapter: ChannelAdapter;
+    readonly bundle: CompiledBundle;
+    readonly ctx: ContextContainer;
+    readonly effectiveAgent: ReturnType<typeof resolveEffectiveAgentRuntime>;
+    readonly instrumentation: ExecutionInstrumentation | undefined;
+    readonly isFirstTurn: boolean;
+    readonly sessionWritable: WritableStream<Uint8Array>;
+    readonly sessionId: string;
+}
+export interface SessionEventSink {
+    readonly adapterCtx: ReturnType<typeof buildAdapterContext>;
+    readonly dynamicConnections: ReturnType<typeof bindDynamicConnections>;
+    readonly effectiveNode: CompiledBundle["graph"]["root"];
+    readonly handleEvent: HandleEventFn;
+    /** Closes the parent stream; only a terminal `done` step does this. */
+    close(): Promise<void>;
+    /** Releases the writer lock so the next step can acquire it. Safe after `close()`. */
+    release(): void;
+}
+/** Binds adapter context, dynamic connections, and event fan-out to one step's stream writer. */
+export declare function createSessionEventSink(input: SessionEventSinkInput): SessionEventSink;

package/dist/src/execution/session/event-sink.js

@@ -0,0 +1 @@
+import{callAdapterEventHandler}from"#channel/adapter.js";import{ScheduleIdKey,TurnDeliveryIdsKey,TurnTaskDeliveryKey}from"#context/keys.js";import{encodeMessageStreamEvent,stampMessageStreamEvent}from"#protocol/message.js";import{dispatchDynamicSubagentEvent}from"#context/dynamic-subagent-lifecycle.js";import{buildAdapterContext}from"#channel/adapter-context.js";import{dispatchDynamicModelEvent}from"#context/dynamic-model-lifecycle.js";import{dispatchDynamicToolEvent}from"#context/dynamic-tool-lifecycle.js";import{setChannelContext}from"#execution/channel-context.js";import{dispatchDynamicInstructionEvent}from"#context/dynamic-instruction-lifecycle.js";import{dispatchDynamicSkillEvent}from"#context/dynamic-skill-lifecycle.js";import{dispatchStreamEventHooks}from"#context/hook-lifecycle.js";import{dispatchMemoryLifecycleEvent}from"#context/memory-event-lifecycle.js";import*as activityCohort from"#execution/activity-cohort.js";import{bindDynamicConnections}from"#execution/dynamic-connections.js";import{observeSessionActivity}from"#execution/session-activity-projection.js";import{scheduledLaunchDeliveryEvent}from"#execution/scheduled-launch-delivery.js";import{forwardTaskEventToSessionCallback}from"#execution/task-event-callback.js";function createSessionEventSink(e){let{adapter:t,bundle:n,ctx:r,effectiveAgent:i,instrumentation:a}=e,o=buildAdapterContext(t,r),s=bindDynamicConnections(r,n.resolvedAgent),c={...n.graph.root,turnAgent:i.turnAgent},l=e.sessionWritable.getWriter(),emit=async n=>{let i=scheduledLaunchDeliveryEvent(n,{isFirstTurn:e.isFirstTurn,isScheduled:r.get(ScheduleIdKey)!==void 0,taskPhase:r.get(TurnTaskDeliveryKey)});if(i===void 0)return{event:stampMessageStreamEvent(n,r.get(TurnDeliveryIdsKey)),suppressed:!0};let a=await callAdapterEventHandler(t,i,o);setChannelContext(r,{...t,state:{...o.state}});let s=stampMessageStreamEvent(a,r.get(TurnDeliveryIdsKey));return await l.write(encodeMessageStreamEvent(s)),{event:s,suppressed:!1}},handleEvent=async(t,o)=>{activityCohort.updateActivityBlockers(r,t);let l=await forwardTaskEventToSessionCallback(r,t)?{event:stampMessageStreamEvent(t,r.get(TurnDeliveryIdsKey)),suppressed:!1}:await emit(t),u=await dispatchMemoryLifecycleEvent({abortSignal:e.abortSignal,appRoot:c.agent?.metadata?.appRoot??``,ctx:r,event:t,instrumentation:a?.memory,memories:c.agent?.memories??[],messages:o,nodeId:n.nodeId??`__root__`});observeSessionActivity({ctx:r,event:l.event,sessionId:e.sessionId}),l.suppressed||await dispatchStreamEventHooks({ctx:r,registry:n.hookRegistry,event:l.event}),l.event.type!==`step.started`&&await dispatchDynamicModelEvent({ctx:r,dynamicModel:i.turnAgent.dynamicModel,event:l.event,messages:u,scope:{moduleMap:n.moduleMap,nodeId:n.nodeId}}),await s.dispatch(l.event),await dispatchDynamicSubagentEvent({ctx:r,resolvers:n.subagentRegistry.dynamicResolvers??[],event:l.event,messages:u}),await dispatchDynamicToolEvent({ctx:r,resolvers:n.resolvedAgent.dynamicToolResolvers??[],event:l.event,messages:u}),await dispatchDynamicSkillEvent({ctx:r,resolvers:n.resolvedAgent.dynamicSkillResolvers??[],event:l.event,messages:u}),await dispatchDynamicInstructionEvent({ctx:r,resolvers:n.resolvedAgent.dynamicInstructionsResolvers??[],event:l.event,messages:u})},u=!1,release=()=>{u||(u=!0,l.releaseLock())};return{adapterCtx:o,close:async()=>{await l.close(),release()},dynamicConnections:s,effectiveNode:c,handleEvent,release}}export{createSessionEventSink};

package/dist/src/execution/session/finalization.d.ts

@@ -0,0 +1,33 @@
+import type { TurnCaller } from "#channel/types.js";
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+import type { TurnOutcome } from "#execution/session/turn-step-types.js";
+import type { WorkflowEntryResult } from "#execution/session/entry-input.js";
+import type { RunMode } from "#shared/run-mode.js";
+/** The three ways a session ends. `done` already emitted its terminal event inside the turn. */
+export type SessionTerminalOutcome = {
+    readonly kind: "done";
+    readonly action: TurnOutcome & {
+        readonly kind: "done";
+    };
+} | {
+    readonly kind: "expired";
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+    readonly turnId?: string;
+};
+export interface SessionFinalizationContext {
+    readonly caller: TurnCaller | undefined;
+    readonly cursor: {
+        readonly serializedContext: Record<string, unknown>;
+        readonly sessionState: DurableSessionState | undefined;
+    };
+    readonly mode: RunMode;
+    readonly sessionWritable: WritableStream<Uint8Array>;
+}
+/**
+ * Terminates descendants, emits the terminal protocol event when the turn has
+ * not already done so, then settles whoever is waiting on this session: the
+ * task callback and delegated parent in task mode, or the parked caller.
+ */
+export declare function finalizeSession(outcome: SessionTerminalOutcome, context: SessionFinalizationContext): Promise<WorkflowEntryResult>;

package/dist/src/execution/session/finalization.js

@@ -0,0 +1 @@
+import{terminateChildSessionsStep}from"#execution/terminate-child-sessions-step.js";import{notifyDelegatedParentStep,notifyTurnCallerStep}from"#subagents/parent-notification.js";import{normalizeSerializableError}from"#execution/workflow-errors.js";import{emitTerminalSessionCompletionStep}from"#execution/terminal-session-completion-step.js";import{emitTerminalSessionFailureStep}from"#execution/terminal-session-failure-step.js";import{fireSessionCallbackStep}from"#subagents/callback-step.js";import{createDelegatedSubagentErrorResult,createDelegatedSubagentSuccessResult}from"#subagents/parent-result.js";async function finalizeSession(e,t){let{serializedContext:n,sessionState:r}=t.cursor;r!==void 0&&await terminateChildSessionsStep({serializedContext:n,sessionState:r}),e.kind===`expired`?await emitTerminalSessionCompletionStep({sessionWritable:t.sessionWritable,serializedContext:n}):e.kind===`failed`&&await emitTerminalSessionFailureStep({error:normalizeSerializableError(e.error),sessionWritable:t.sessionWritable,serializedContext:n,turnId:e.turnId});let i=settledResult(e);if(t.mode===`task`)await fireSessionCallbackStep({error:i.isError?i.output:void 0,output:i.isError?void 0:i.output,serializedContext:n,status:i.isError?`failed`:`completed`,usage:i.sessionUsage}),await notifyDelegatedParentStep({result:i.isError?createDelegatedSubagentErrorResult(n,i.output):createDelegatedSubagentSuccessResult(n,i.output),serializedContext:n,usage:i.sessionUsage});else if(t.caller!==void 0){let e={output:i.output,usage:i.turnUsage};i.isError&&(e.isError=!0),await notifyTurnCallerStep({caller:t.caller,lifecycle:`terminal`,sessionId:r?.sessionId??n[`eve.sessionId`],settled:e})}return e.kind===`done`?{isError:e.action.isError,output:e.action.output,usage:e.action.usage,usageDelta:e.action.usageDelta}:{isError:i.isError,output:i.output}}function settledResult(e){switch(e.kind){case`done`:return{isError:e.action.isError===!0,output:e.action.output,sessionUsage:e.action.usage,turnUsage:e.action.usageDelta};case`expired`:return{isError:!1,output:``};case`failed`:return{isError:!0,output:normalizeSerializableError(e.error)}}}export{finalizeSession};

package/dist/src/execution/session/handoff-steps.d.ts

@@ -0,0 +1,22 @@
+import { type DurableSessionState } from "#execution/durable-session-store.js";
+import { type SessionCheckpoint, type SessionOwnerActivation } from "#execution/session/handoff.js";
+/** Parses retained work with this deployment's code before deciding whether it can move. */
+export declare function isSessionStateIdleForHandoff(sessionState: DurableSessionState): boolean;
+/** Reads durable work using the source deployment's handoff contract. */
+export declare function isSessionIdleForHandoffStep(input: {
+    readonly sessionState: DurableSessionState;
+}): Promise<boolean>;
+/** Validates a checkpoint and resolves the target deployment's compiled bundle. */
+export declare function validateSessionCheckpointStep(input: {
+    readonly checkpoint: SessionCheckpoint;
+}): Promise<void>;
+export declare function signalSessionOwnerActivationStep(input: {
+    readonly activation: SessionOwnerActivation;
+    readonly token: string;
+}): Promise<void>;
+export declare function signalSessionAnchorStep(input: {
+    readonly result: {
+        readonly output: unknown;
+    };
+    readonly token: string;
+}): Promise<void>;

package/dist/src/execution/session/handoff-steps.js

@@ -0,0 +1 @@
+import{isObject}from"#shared/guards.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{resumeHook}from"#internal/workflow/runtime.js";import{deserializeContext}from"#context/serialize.js";import{readDurableSession}from"#execution/durable-session-store.js";import{getAgentHandleStore}from"#subagents/handles/store.js";import{getSessionTaskIndex}from"#tasks/session-index.js";import{SESSION_CHECKPOINT_VERSION}from"#execution/session/handoff.js";function isSessionStateIdleForHandoff(e){let{state:t}=readDurableSession(e),n=getSessionTaskIndex(t),r=getAgentHandleStore(t);if([`eve.runtime.pendingAuthorization`,`eve.runtime.pendingInputBatch`,`eve.runtime.pendingCoordinationBatch`,`eve.runtime.deferredStepInput`,`eve.harness.pendingWorkflowInterrupt`].some(e=>t?.[e]!==void 0))return!1;for(let e of[`eve.runtime.pendingInputBatches`,`eve.runtime.workflowToolRuns`]){let n=t?.[e];if(n!==void 0&&(!Array.isArray(n)||n.length>0))return!1}let i=t?.[`eve.runtime.proxyInputRequests`];return i!==void 0&&(!isObject(i)||Object.keys(i).length>0)?!1:(r?.handles.length??0)===0&&n.every(e=>e.terminalView!==void 0)}async function isSessionIdleForHandoffStep(e){"use step";return isSessionStateIdleForHandoff(e.sessionState)}async function validateSessionCheckpointStep(e){"use step";let{checkpoint:t}=e;if(t.version!==SESSION_CHECKPOINT_VERSION)throw Error(`Unsupported session checkpoint version ${JSON.stringify(t.version)}; this deployment reads version ${SESSION_CHECKPOINT_VERSION}. Start a new session on this deployment.`);let n=t.sessionTimeoutMs;if(n!==!1&&(typeof n!=`number`||!Number.isFinite(n)||n<0))throw Error(`Session checkpoint contains an invalid timeout duration.`);if((await deserializeContext(t.serializedContext)).require(BundleKey),!isSessionStateIdleForHandoff(t.sessionState))throw Error(`Session checkpoint contains pending work and cannot be handed off.`)}async function signalSessionOwnerActivationStep(e){"use step";await resumeHook(e.token,e.activation)}async function signalSessionAnchorStep(e){"use step";await resumeHook(e.token,e.result)}export{isSessionIdleForHandoffStep,isSessionStateIdleForHandoff,signalSessionAnchorStep,signalSessionOwnerActivationStep,validateSessionCheckpointStep};

package/dist/src/execution/session/handoff.d.ts

@@ -0,0 +1,69 @@
+import type { SessionCapabilities } from "#channel/types.js";
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+import type { SessionInboxHandle, SessionInboxPayload } from "#execution/session-inbox/inbox.js";
+import type { TurnSelection } from "#execution/session/input-queue.js";
+import type { WorkflowEntryResult } from "#execution/session/entry-input.js";
+import type { AgentWorkflowRetentionDefinition } from "#shared/agent-definition.js";
+import type { RunMode } from "#shared/run-mode.js";
+/**
+ * Cross-deployment checkpoint contract. The successor may run a different eve
+ * build than the owner that produced it; bump when any field changes shape so
+ * an incompatible successor rejects the handoff instead of misreading state.
+ */
+export declare const SESSION_CHECKPOINT_VERSION = 4;
+/** Everything a successor needs to continue an idle session. Hooks are derived from the state. */
+export interface SessionCheckpoint {
+    readonly version: typeof SESSION_CHECKPOINT_VERSION;
+    readonly capabilities?: SessionCapabilities;
+    readonly mode: RunMode;
+    readonly retention?: AgentWorkflowRetentionDefinition;
+    readonly serializedContext: Record<string, unknown>;
+    readonly sessionState: DurableSessionState;
+    readonly sessionTimeoutMs: number | false;
+}
+export type SessionOwnerActivation = {
+    readonly kind: "active";
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+    /** Commands accepted by partial successor claims before startup failed. */
+    readonly payloads: readonly SessionInboxPayload[];
+};
+export type SessionTransferOutcome = {
+    readonly kind: "transferred";
+} | {
+    readonly kind: "retained";
+    readonly reason: "same-deployment" | "missing-deployment" | "not-idle" | "busy" | "accepted-during-release" | "activation-failed";
+};
+export interface SessionHandoffInput {
+    readonly checkpoint: Omit<SessionCheckpoint, "serializedContext" | "sessionState" | "version">;
+    readonly deploymentId: string;
+    readonly inbox: SessionInboxHandle;
+    readonly isInitialOwner: boolean;
+    readonly sessionId: string;
+}
+export declare function sessionAnchorToken(sessionId: string): string;
+/**
+ * The sole boundary for moving an idle session to another exact deployment.
+ * Constructed once per owner; `tryTransfer()` is attempted per eligible selection.
+ * When the upstream atomic hook-handoff primitive lands, only this class changes.
+ */
+export declare class SessionHandoff {
+    private readonly input;
+    private anchor;
+    constructor(input: SessionHandoffInput);
+    /**
+     * Attempts to move the session to the selected delivery's deployment. The
+     * outcome states whether the successor activated or this owner retained the
+     * session. Candidate failures recover locally rather than escaping.
+     */
+    tryTransfer(selection: TurnSelection, state: Pick<SessionCheckpoint, "serializedContext" | "sessionState">): Promise<SessionTransferOutcome>;
+    /** After a transfer, the original run parks until the final owner reports the session result. */
+    awaitAnchoredResult(): Promise<WorkflowEntryResult>;
+    disposeAnchor(): Promise<void>;
+    /** Starts the candidate and waits for it to activate or fail. */
+    private startAndActivate;
+    /** Reclaims the exact hook set and replays payloads accepted while it was released. */
+    private recover;
+    private ensureAnchor;
+}

package/dist/src/execution/session/handoff.js

@@ -0,0 +1 @@
+import{sessionHandoffMarkerToken}from"#execution/session-inbox/address.js";import{startSessionOwnerStep}from"#execution/workflow-runtime.js";import{createHook,getWorkflowMetadata}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook}from"#execution/hook-ownership.js";import{sessionHookTokens}from"#execution/session/hook-tokens.js";import{isSessionIdleForHandoffStep}from"#execution/session/handoff-steps.js";import{readAcceptedDeploymentId}from"#execution/session/accepted-deployment.js";const SESSION_CHECKPOINT_VERSION=4;function sessionAnchorToken(e){return`${e}:anchor`}var SessionHandoff=class{input;anchor;constructor(e){this.input=e}async tryTransfer(e,t){let{deploymentId:n,inbox:r}=this.input,i=readAcceptedDeploymentId(e.delivery);if(i===void 0)return{kind:`retained`,reason:`missing-deployment`};if(i===n)return{kind:`retained`,reason:`same-deployment`};if(!e.handoffEligible)return{kind:`retained`,reason:`busy`};if(!await isSessionIdleForHandoffStep(t))return{kind:`retained`,reason:`not-idle`};let a={...this.input.checkpoint,...t,version:4},o=sessionHookTokens(t);await this.ensureAnchor();let s=o.map(e=>createHook({token:sessionHandoffMarkerToken(e)}));await Promise.all(s.map(e=>claimHookOwnership(e)));try{let t=await r.release();if(t.length>0)return await this.recover(o,t),{kind:`retained`,reason:`accepted-during-release`};let n=[];try{let t=await this.startAndActivate(a,e.delivery,i);if(t.kind===`active`)return{kind:`transferred`};n=t.payloads}catch{}return await this.recover(o,n),{kind:`retained`,reason:`activation-failed`}}finally{await Promise.all(s.map(e=>disposeHook(e)))}}async awaitAnchoredResult(){if(this.anchor===void 0)throw Error(`Session anchor was never claimed.`);try{return await this.anchor}finally{await this.disposeAnchor()}}async disposeAnchor(){if(this.anchor===void 0)return;let e=this.anchor;this.anchor=void 0,await disposeHook(e)}async startAndActivate(e,t,n){let r=createHook({token:`${getWorkflowMetadata().workflowRunId}:handoff`});await claimHookOwnership(r);try{return await startSessionOwnerStep({activationToken:r.token,anchorRunId:this.input.sessionId,checkpoint:e,delivery:t,targetDeploymentId:n}),await r}finally{await disposeHook(r)}}async recover(e,t){await this.input.inbox.claimSessionHooks(e),this.input.inbox.restore(t)}async ensureAnchor(){this.input.isInitialOwner&&this.anchor===void 0&&(this.anchor=createHook({token:sessionAnchorToken(this.input.sessionId)}),await claimHookOwnership(this.anchor))}};export{SESSION_CHECKPOINT_VERSION,SessionHandoff,sessionAnchorToken};

package/dist/src/execution/session/hook-tokens.d.ts

@@ -0,0 +1,11 @@
+import type { DurableSessionState } from "#execution/durable-session-store.js";
+/**
+ * Every hook a session answers to, derived from its committed state: the
+ * stable command inbox plus each continuation alias a channel handler
+ * selected. This is the one source of truth for claims at boot, at every
+ * state transition, and across a deployment handoff.
+ */
+export declare function sessionHookTokens(input: {
+    readonly serializedContext: Record<string, unknown>;
+    readonly sessionState: Pick<DurableSessionState, "continuationToken" | "sessionId">;
+}): readonly string[];

package/dist/src/execution/session/hook-tokens.js

@@ -0,0 +1 @@
+import{sessionCommandHookToken}from"#execution/session-inbox/address.js";import{ContinuationHookTokensKey}from"#context/keys.js";function sessionHookTokens(e){let t=e.serializedContext[ContinuationHookTokensKey.name],n=new Set([sessionCommandHookToken(e.sessionState.sessionId)]);if(Array.isArray(t))for(let e of t)typeof e==`string`&&e.length>0&&n.add(e);return e.sessionState.continuationToken!==``&&n.add(e.sessionState.continuationToken),[...n]}export{sessionHookTokens};