eve 0.83.3 → 0.84.1

package/dist/src/execution/session/settle-control-delivery-step.d.ts

@@ -0,0 +1,8 @@
+import { type SessionStepState } from "#execution/publish-session-events.js";
+import { type ControlSettlement } from "#harness/facts.js";
+/** Records a control that finishes without a step of its own, at an owner's committed boundary. */
+export declare function settleControlDeliveryStep(input: SessionStepState & {
+    readonly settlement: ControlSettlement;
+}): Promise<Omit<import("#execution/publish-session-events.js").PublishedSessionEvents & {
+    readonly cancelled: boolean;
+}, keyof import("./state-delta.ts").SessionStateValues> & import("./state-delta.ts").SessionStateTransition>;

package/dist/src/execution/session/settle-control-delivery-step.js

@@ -0,0 +1 @@
+import{publishSessionEvents}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{controlSettled}from"#harness/facts.js";async function settleControlDeliveryStep(e){"use step";return await withSessionStateDelta(e,t=>publishSessionEvents(t,controlSettled(e.settlement)))}export{settleControlDeliveryStep};

package/dist/src/execution/session/settle-duplicate-delivery-step.d.ts

@@ -0,0 +1,8 @@
+import type { DeliverHookPayload } from "#channel/types.js";
+import { type SessionStepState } from "#execution/publish-session-events.js";
+/** A duplicate starts no work, but its distinct receipt must still settle. */
+export declare function settleDuplicateDeliveryStep(input: SessionStepState & {
+    readonly delivery: DeliverHookPayload;
+}): Promise<Omit<import("#execution/publish-session-events.js").PublishedSessionEvents & {
+    readonly cancelled: boolean;
+}, keyof import("./state-delta.ts").SessionStateValues> & import("./state-delta.ts").SessionStateTransition>;

package/dist/src/execution/session/settle-duplicate-delivery-step.js

@@ -0,0 +1 @@
+import{storedProjection}from"#harness/session-machine/view.js";import{readDurableSession}from"#execution/durable-session-store.js";import{publishSessionEvents}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{admitDeliveries}from"#execution/session/delivery-facts.js";async function settleDuplicateDeliveryStep(e){"use step";return await withSessionStateDelta(e,t=>{let n=storedProjection(readDurableSession(t.sessionState).state).view,{facts:r}=admitDeliveries({channelKind:`http`,delivery:e.delivery,payloads:e.delivery.payloads.flatMap((t,r)=>{let i=e.delivery.deliveryMetadata?.find(e=>e.payloadIndex===r);return i!==void 0&&n.deliveries[i.deliveryId]!==void 0?[]:[{payload:t,input:void 0}]})});return publishSessionEvents(t,r.map(e=>e.type===`delivery.settled`?{...e,data:{...e.data,reason:`duplicate idempotency key`}}:e))})}export{settleDuplicateDeliveryStep};

package/dist/src/execution/session/state-delta.d.ts

@@ -24,17 +24,7 @@ export interface SessionStateTransition {
 /** `T` with its session values replaced by the delta that produces them. */
 export type WithSessionStateDelta<T> = T extends unknown ? Omit<T, keyof SessionStateValues> & SessionStateTransition : never;
 /**
- * Runs a session step's work and returns its result with the session values
- * it produced replaced by their delta from the values the step was given.
- *
- * Workflow replay reads every step's output but no step's input, so a step
- * that returns only what changed keeps both replay and storage from carrying
- * the whole session once per step. The workflow body applies the delta to the
- * values it passed in; see {@link applySessionStateDelta}.
- *
- * The input is snapshotted before `work` runs because step code may edit it
- * in place, as a channel adapter does with its state.
+ * Applies a step's delta to the values that step was given. The workflow body runs this; steps
+ * produce the delta with `withSessionStateDelta` (`step-state-delta.ts`).
  */
-export declare function withSessionStateDelta<I extends Partial<SessionStateValues>, R extends Partial<SessionStateValues>>(input: I, work: (input: I) => Promise<R>): Promise<WithSessionStateDelta<R>>;
-/** Applies a step's delta to the values that step was given. */
 export declare function applySessionStateDelta(values: SessionStateValues, delta: SessionStateDelta): SessionStateValues;

package/dist/src/execution/session/state-delta.js

@@ -1 +1 @@
-import{applyValueDelta,diffValue,snapshotValue}from"#shared/value-delta.js";const SESSION_VALUE_KEYS=[`serializedContext`,`sessionState`,`history`];async function withSessionStateDelta(e,t){let n=Object.fromEntries(SESSION_VALUE_KEYS.map(t=>[t,snapshotValue(e[t])])),{serializedContext:r,sessionState:i,history:a,...o}=await t(e),s={serializedContext:r,sessionState:i,history:a},c={};for(let e of SESSION_VALUE_KEYS){let t=s[e]===void 0?void 0:diffValue(n[e],s[e]);t!==void 0&&(c[e]=t)}return{...o,stateDelta:c}}function applySessionStateDelta(e,t){return{serializedContext:applyValueDelta(e.serializedContext,t.serializedContext),sessionState:applyValueDelta(e.sessionState,t.sessionState),history:applyValueDelta(e.history,t.history)}}export{applySessionStateDelta,withSessionStateDelta};
+import{applyValueDelta}from"#shared/value-delta.js";function applySessionStateDelta(e,t){return{serializedContext:applyValueDelta(e.serializedContext,t.serializedContext),sessionState:applyValueDelta(e.sessionState,t.sessionState),history:applyValueDelta(e.history,t.history)}}export{applySessionStateDelta};

package/dist/src/execution/session/step-decision-check.d.ts

@@ -0,0 +1,9 @@
+import type { DurableStepResult } from "#execution/session/turn-step-types.js";
+import type { SessionView } from "#protocol/session-projection/tables.js";
+/**
+ * How a turn step's decision disagrees with what the tables say the turn waits on, if it does. A
+ * step that pauses on calls only requested, which the next durable step dispatches or, for task
+ * tool calls, answers, is the one known disagreement, `dispatch-deferred`: the tables say the
+ * session has work, and it does.
+ */
+export declare function stepDisagreement(result: DurableStepResult, view: SessionView): string | undefined;

package/dist/src/execution/session/step-decision-check.js

@@ -0,0 +1 @@
+import{activeTurn,waiting}from"#protocol/session-projection/selectors.js";function stepDisagreement(e,t){if(e.action===`done`||e.action===`cancelled`)return;let n=activeTurn(t)?.turnId,r=n===void 0?`no-turn`:waiting(t,n)?.on??`session`,i=e.action===`paused`?e.on===`interaction`?`interaction`:`work`:e.action;if(!(i===`interaction`&&r===`interaction`||i===`work`&&r===`work`||i===`continue`&&r===`session`||i===`parked`&&(r===`no-turn`||r===`interaction`)))return e.action===`paused`&&e.on===`calls`&&(e.dispatch||e.taskToolCalls.length>0)&&r===`session`?`dispatch-deferred`:`${i}-but-${r}`}export{stepDisagreement};

package/dist/src/execution/session/step-state-delta.d.ts

@@ -0,0 +1,16 @@
+import type { SessionStateValues, WithSessionStateDelta } from "#execution/session/state-delta.js";
+/**
+ * Runs a session step's work and returns its result with the session values
+ * it produced replaced by their delta from the values the step was given.
+ *
+ * Workflow replay reads every step's output but no step's input, so a step
+ * that returns only what changed keeps both replay and storage from carrying
+ * the whole session once per step. The workflow body applies the delta to the
+ * values it passed in; see `applySessionStateDelta`.
+ *
+ * The input is snapshotted before `work` runs because step code may edit it
+ * in place, as a channel adapter does with its state. A retried step's state
+ * follows every line its interrupted attempt wrote; see
+ * {@link followInterruptedAttempt}.
+ */
+export declare function withSessionStateDelta<I extends Partial<SessionStateValues>, R extends Partial<SessionStateValues>>(input: I, work: (input: I) => Promise<R>): Promise<WithSessionStateDelta<R>>;

package/dist/src/execution/session/step-state-delta.js

@@ -0,0 +1 @@
+import{storedProjection}from"#harness/session-machine/view.js";import{readDurableSession}from"#execution/durable-session-store.js";import{followInterruptedAttempt,readOrphanedLines}from"#execution/publish-session-events.js";import{diffValue,snapshotValue}from"#shared/value-delta.js";const SESSION_VALUE_KEYS=[`serializedContext`,`sessionState`,`history`];async function withSessionStateDelta(e,t){let n=Object.fromEntries(SESSION_VALUE_KEYS.map(t=>[t,snapshotValue(e[t])])),{sessionWritable:r}=e;if(r!==void 0&&n.sessionState!==void 0){let e=n.sessionState,t=readDurableSession(e);await readOrphanedLines({sessionId:e.sessionId,position:storedProjection(t.state).view.position,sessionWritable:r})}let{serializedContext:i,sessionState:a,history:o,...s}=await t(e),c=a??n.sessionState,l={serializedContext:i,sessionState:c===void 0||r===void 0?a:followInterruptedAttempt(r,c),history:o},u={};for(let e of SESSION_VALUE_KEYS){let t=l[e]===void 0?void 0:diffValue(n[e],l[e]);t!==void 0&&(u[e]=t)}return{...s,stateDelta:u}}export{withSessionStateDelta};

package/dist/src/execution/session/task-tool-tracing-step.d.ts

@@ -1,5 +1,2 @@
-import { type SessionStepState } from "#execution/publish-session-events.js";
-import { type ExecutionInstrumentation } from "#instrumentation/runtime.js";
 /** The step output preserves the start time when the workflow resumes in another worker. */
 export declare function startTaskToolCallsStep(): Promise<number>;
-export declare function traceTaskToolCallStep(target: SessionStepState, call: Parameters<ExecutionInstrumentation["instrumentTaskToolCall"]>[0]): Promise<Omit<import("#execution/publish-session-events.js").PublishedSessionEvents, keyof import("#execution/session/state-delta.js").SessionStateValues> & import("#execution/session/state-delta.js").SessionStateTransition>;

package/dist/src/execution/session/task-tool-tracing-step.js

@@ -1 +1 @@
-import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{resolveEffectiveAgentRuntime}from"#execution/effective-agent-config.js";import{publishFromSessionStep,restoreSessionStep}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";async function startTaskToolCallsStep(){"use step";return Date.now()}async function traceTaskToolCallStep(e,t){"use step";return await withSessionStateDelta(e,async e=>{let n=await restoreSessionStep(e),{published:r}=await publishFromSessionStep(n,{origin:`own`,async publish(e,r){await bindSessionInstrumentation({ctx:n.ctx,agentName:resolveEffectiveAgentRuntime(n.ctx.require(BundleKey),n.ctx).turnAgent.id,rootSessionId:r.rootSessionId??r.sessionId,sessionId:r.sessionId})?.instrumentTaskToolCall(t)}});return r})}export{startTaskToolCallsStep,traceTaskToolCallStep};
+async function startTaskToolCallsStep(){"use step";return Date.now()}export{startTaskToolCallsStep};

package/dist/src/execution/session/turn-event-handler.d.ts

@@ -1,27 +1,17 @@
-import type { ContextContainer } from "#context/container.js";
-import type { bindDynamicConnections } from "#execution/dynamic-connections.js";
-import type { resolveEffectiveAgentRuntime } from "#execution/effective-agent-config.js";
+import type { ModelMessage } from "ai";
 import type { SessionEventPublisher } from "#execution/publish-session-events.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";
-/** True when a hook on this event type may cancel the running turn. */
-export declare function isHookCancellableEvent(type: string): boolean;
 /**
- * Publishes one turn event, then runs memory, hooks, and model preparation for it.
- * A hook's `ctx.cancel()` aborts the turn signal at once; the event's remaining
- * hooks still run, then the handler stops the turn before the next model call.
+ * Publishes one turn event or commit, then runs the session's reactions with the conversation as
+ * of the commit. A hook's `cancel()` aborts the turn signal; the commit's remaining reactions still
+ * run, then the turn stops before its next model call.
  */
 export declare function createTurnEventHandler(input: {
     readonly abortSignal: AbortSignal;
-    readonly bundle: CompiledBundle;
     /** False for clear and compact requests, which run outside any turn. */
     readonly canCancelTurn: boolean;
+    /** The conversation the step starts from, until a commit hands a newer one. */
+    readonly conversation: readonly ModelMessage[];
     readonly hookCancellation: AbortController;
-    readonly ctx: ContextContainer;
-    readonly dynamicConnections: ReturnType<typeof bindDynamicConnections>;
-    readonly effectiveAgent: ReturnType<typeof resolveEffectiveAgentRuntime>;
-    readonly effectiveNode: CompiledBundle["graph"]["root"];
-    readonly instrumentation: ExecutionInstrumentation | undefined;
     readonly publisher: SessionEventPublisher;
 }): HandleEventFn;

package/dist/src/execution/session/turn-event-handler.js

@@ -1 +1 @@
-import{dispatchDynamicSubagentEvent}from"#context/dynamic-subagent-lifecycle.js";import{dispatchDynamicModelEvent}from"#context/dynamic-model-lifecycle.js";import{dispatchDynamicToolEvent}from"#context/dynamic-tool-lifecycle.js";import{TurnCancelledError,throwIfTurnAborted}from"#harness/turn-cancellation.js";import{dispatchDynamicInstructionEvent}from"#context/dynamic-instruction-lifecycle.js";import{dispatchDynamicSkillEvent}from"#context/dynamic-skill-lifecycle.js";import{dispatchMemoryLifecycleEvent}from"#context/memory-event-lifecycle.js";const HOOK_CANCELLABLE_EVENTS={"action.input.appended":!0,"action.partial":!0,"action.result":!0,"actions.requested":!0,"agent.started":!1,"approval.candidate":!0,"approval.settled":!0,"authorization.completed":!0,"authorization.required":!0,"compaction.completed":!0,"compaction.requested":!0,"context.cleared":!1,"history.imported":!1,"input.requested":!0,"input.resolved":!0,"message.appended":!0,"message.completed":!0,"message.received":!0,"reasoning.appended":!0,"reasoning.completed":!0,"result.completed":!0,"session.completed":!1,"session.failed":!1,"session.started":!0,"session.waiting":!1,"step.completed":!0,"step.failed":!1,"step.started":!0,"task.settled":!1,"task.started":!1,"turn.cancelled":!1,"turn.completed":!1,"turn.failed":!1,"turn.started":!0,"turn.waiting":!1};function isHookCancellableEvent(e){return HOOK_CANCELLABLE_EVENTS[e]===!0}function createTurnEventHandler(e){let{abortSignal:t,bundle:n,ctx:r,effectiveAgent:i,effectiveNode:a}=e,{publisher:o}=e;return async(s,c)=>{let l=await o.emit(s),u=await dispatchMemoryLifecycleEvent({abortSignal:t,appRoot:a.agent?.metadata?.appRoot??``,ctx:r,event:s,instrumentation:e.instrumentation?.memory,memories:a.agent?.memories??[],messages:c,nodeId:n.nodeId??`__root__`}),d=e.canCancelTurn&&isHookCancellableEvent(l.type)?()=>e.hookCancellation.abort(new TurnCancelledError):void 0;await o.dispatcher.runHooks(l,d),l.type!==`step.started`&&await dispatchDynamicModelEvent({abortSignal:t,ctx:r,dynamicModel:i.turnAgent.dynamicModel,event:l,messages:u,scope:{moduleMap:n.moduleMap,nodeId:n.nodeId}}),await e.dynamicConnections.dispatch(l),await dispatchDynamicSubagentEvent({ctx:r,resolvers:n.subagentRegistry.dynamicResolvers??[],event:l,messages:u}),await dispatchDynamicToolEvent({ctx:r,resolvers:n.resolvedAgent.dynamicToolResolvers??[],event:l,messages:u}),await dispatchDynamicSkillEvent({ctx:r,resolvers:n.resolvedAgent.dynamicSkillResolvers??[],event:l,messages:u}),await dispatchDynamicInstructionEvent({ctx:r,resolvers:n.resolvedAgent.dynamicInstructionsResolvers??[],event:l,messages:u}),d!==void 0&&throwIfTurnAborted(e.hookCancellation.signal)}}export{createTurnEventHandler,isHookCancellableEvent};
+import{TurnCancelledError,throwIfTurnAborted}from"#harness/turn-cancellation.js";function createTurnEventHandler(e){let{publisher:t}=e,n=e.conversation;return async(r,i)=>{i!==void 0&&(n=i);let a=await t.emit(r),o=a.some(({event:e})=>e.type===`turn.settled`||e.type===`session.ended`),s=e.canCancelTurn&&!o?({reason:t})=>e.hookCancellation.abort(new TurnCancelledError(t)):void 0;await t.dispatcher.react(a,{abortSignal:e.abortSignal,conversation:n,cancelTurn:s,cancelBeforeTurn:s}),throwIfTurnAborted(e.hookCancellation.signal)}}export{createTurnEventHandler};

package/dist/src/execution/session/turn-step-result.d.ts

@@ -1,3 +1,8 @@
-import type { DurableStepResult } from "#execution/session/turn-step-types.js";
-import type { StepResult } from "#harness/types.js";
+import type { DurableStepResult, DurableStepResultFields } from "#execution/session/turn-step-types.js";
+import type { HarnessSession, SettledTurn, StepResult } from "#harness/types.js";
 export declare function resolveSessionStepResult(stepResult: StepResult, nextSerializedContext: Record<string, unknown>): DurableStepResult;
+/**
+ * The turn pauses on the calls the runtime runs for it, or, with none, parks the session.
+ * `settled` is a settled turn's answer to its delegated caller.
+ */
+export declare function pausedOrParked(session: HarnessSession, fields: DurableStepResultFields, settled?: SettledTurn): DurableStepResult;

package/dist/src/execution/session/turn-step-result.js

@@ -1 +1 @@
-import{storedProjection}from"#harness/session-machine/view.js";import{getTurnUsageState,takeSessionUsageDelta,toUsage}from"#harness/turn-tag-state.js";import{createDurableSessionValues}from"#execution/durable-session-store.js";import{ownOpenRequestIds}from"#harness/session-machine/transitions.js";import{sessionView}from"#harness/session-machine/commit.js";import{derivePendingState}from"#execution/session/pending-turn-state.js";function resolveSessionStepResult(e,t){let n={serializedContext:t,...createDurableSessionValues(e.session)};if(e.steered)return{action:`steered`,...n};if(e.next!==null&&typeof e.next==`object`&&`done`in e.next){let t=getTurnUsageState(e.session.state)?.session;return{action:`done`,output:e.next.output,isError:e.next.isError,...n,usage:t===void 0?void 0:toUsage(t),usageDelta:takeSessionUsageDelta(e.session).delta}}if(e.held?.kind===`tasks`)return{action:`held`,hold:`tasks`,...n,taskIds:e.held.taskIds};if(e.held?.kind===`request`){let t=storedProjection(e.session.state),r=derivePendingState(e.session,t);return{action:`held`,authorizationAttemptIds:r.authorizationAttemptIds??[],hasPendingInputBatch:r.hasPendingInputBatch,hold:`request`,inputRequestIds:[...ownOpenRequestIds(sessionView(t,e.session.state))],...n}}if(e.next===null){let{hasRunsToDispatch:r,pendingCoordinationCallIds:i,pendingTaskToolCalls:a}=derivePendingState(e.session,storedProjection(e.session.state)),o={hasRunsToDispatch:r,pendingCoordinationCallIds:i,pendingTaskToolCalls:a};if(e.settledTurn!==void 0){let{delta:n,session:r}=takeSessionUsageDelta(e.session);return{action:`park`,...o,serializedContext:t,...createDurableSessionValues(r),settled:{output:e.settledTurn.output,isError:e.settledTurn.isError,usage:n}}}return{action:`park`,...o,...n}}return{action:`continue`,...n}}export{resolveSessionStepResult};
+import{storedProjection}from"#harness/session-machine/view.js";import{createDurableSessionValues}from"#execution/durable-session-store.js";import{sessionUsage,takeSessionUsageDelta}from"#harness/session-usage.js";import{pausedOnCalls,pausedOnInteraction,pausedOnTasks}from"#execution/session/pending-turn-state.js";function resolveSessionStepResult(e,t){let n={serializedContext:t,...createDurableSessionValues(e.session)};if(e.steered)return{action:`continue`,...n};if(e.next!==null&&typeof e.next==`object`&&`done`in e.next)return{action:`done`,output:e.next.output,isError:e.next.isError,...n,usage:sessionUsage(e.session),usageDelta:takeSessionUsageDelta(e.session).delta};if(e.held?.kind===`tasks`)return{action:`paused`,...pausedOnTasks(e.held.taskIds),...n};if(e.held?.kind===`request`){let t=storedProjection(e.session.state);return{action:`paused`,...pausedOnInteraction(e.session,t),...n}}if(e.next!==null)return{action:`continue`,...n};let r=e.settledTurn===void 0?void 0:takeSessionUsageDelta(e.session),i=r===void 0?n:{serializedContext:t,...createDurableSessionValues(r.session)};return pausedOrParked(e.session,i,e.settledTurn===void 0?void 0:{output:e.settledTurn.output,isError:e.settledTurn.isError,usage:r?.delta})}function pausedOrParked(e,t,n){let r=pausedOnCalls(e);return r===void 0?{action:`parked`,...n!==void 0&&{settled:n},...t}:{action:`paused`,...r,...t}}export{pausedOrParked,resolveSessionStepResult};

package/dist/src/execution/session/turn-step-types.d.ts

@@ -1,7 +1,8 @@
+import type { ControlDelivery } from "#harness/types.js";
 import type { DeliverHookPayload, TurnCaller } from "#channel/types.js";
 import type { DurableSessionState } from "#execution/durable-session-store.js";
 import type { WithSessionStateDelta } from "#execution/session/state-delta.js";
-import type { TaskToolCall } from "#execution/tasks/calls.js";
+import type { TurnPause } from "#execution/session/pending-turn-state.js";
 import type { HarnessModelMessage } from "#harness/messages.js";
 import type { SettledTurn } from "#harness/types.js";
 import type { RuntimeActionResult } from "#shared/action-types.js";
@@ -10,8 +11,8 @@ import type { SessionHandoverObservation } from "#execution/session-inbox/inbox.
 /** Trusted runtime-action results collected by the session owner. */
 export interface RuntimeActionResultStepInput {
     readonly acceptedAtMsByCallId?: Readonly<Record<string, number>>;
-    /** What the `ctx.agent` sessions of the `execute` runs behind these results spent. */
-    readonly delegatedUsage?: readonly TokenUsage[];
+    /** What the `ctx.agent` sessions of the `execute` runs behind these results spent, by call. */
+    readonly delegatedUsage?: Readonly<Record<string, TokenUsage>>;
     readonly results: readonly RuntimeActionResult[];
 }
 /**
@@ -21,6 +22,8 @@ export interface RuntimeActionResultStepInput {
  */
 export interface TurnStepPayload {
     readonly control?: "clear" | "compact";
+    /** The delivery the control arrived as. */
+    readonly controlDelivery?: ControlDelivery;
     readonly delivery?: DeliverHookPayload;
     readonly runtimeResults?: RuntimeActionResultStepInput;
 }
@@ -36,46 +39,44 @@ export interface TurnStepInput {
     readonly serializedContext: Record<string, unknown>;
     readonly sessionState: DurableSessionState;
     readonly history: HarnessModelMessage[];
+    /**
+     * Every attempt of this step failed, the last with `error`: recover what they published and
+     * fail the turn with that error.
+     */
+    readonly recover?: {
+        readonly error: unknown;
+    };
 }
-interface DurableStepResultFields {
+/** The session state every step result carries. */
+export interface DurableStepResultFields {
     readonly serializedContext: Record<string, unknown>;
     readonly sessionState: DurableSessionState;
     readonly history: HarnessModelMessage[];
 }
 /** What one turn step's work produces, with the session state it leaves. */
-export type DurableStepResult = ({
-    readonly action: "continue" | "done";
-    readonly output?: unknown;
-    readonly isError?: boolean;
-    readonly usage?: TokenUsage;
-    readonly usageDelta?: TokenUsage;
-} | {
-    readonly action: "cancelled" | "steered";
+export type DurableStepResult = 
+/** The turn goes on with its next step. */
+({
+    readonly action: "continue";
 }
-/** The model ended the turn while tasks work; the turn waits for them. */
+/** The turn waits on what it paused on, then goes on. */
+ | ({
+    readonly action: "paused";
+} & TurnPause)
+/** The turn ended and the session parks. `settled` is its answer to a delegated caller. */
  | {
-    readonly action: "held";
-    readonly hold: "tasks";
-    readonly taskIds: readonly string[];
+    readonly action: "parked";
+    readonly settled?: SettledTurn;
 }
-/** The turn waits on a sign-in or tool approval it raised. */
+/** The session ended. */
  | {
-    readonly action: "held";
-    readonly authorizationAttemptIds: readonly string[];
-    readonly hasPendingInputBatch: boolean;
-    readonly hold: "request";
-    /** Pending input request ids an answer can resolve. */
-    readonly inputRequestIds: readonly string[];
+    readonly action: "done";
+    readonly output?: unknown;
+    readonly isError?: boolean;
+    readonly usage?: TokenUsage;
+    readonly usageDelta?: TokenUsage;
 } | {
-    readonly action: "park";
-    /**
-     * `false` when every pending call is a task tool call the session answers
-     * itself, so the dispatch step can be skipped. Absent, the step runs.
-     */
-    readonly hasRunsToDispatch?: boolean;
-    readonly pendingCoordinationCallIds?: readonly string[];
-    readonly pendingTaskToolCalls?: readonly TaskToolCall[];
-    readonly settled?: SettledTurn;
+    readonly action: "cancelled";
 }) & DurableStepResultFields & {
     /** The step compacted the history. */
     readonly compacted?: true;
@@ -99,7 +100,8 @@ export type TurnOutcome = {
     readonly usageDelta?: TokenUsage;
 } | {
     readonly cancelled?: true;
+    /** The cancel control that stopped the turn, when it named its delivery. */
+    readonly cancelledBy?: ControlDelivery;
     readonly kind: "park";
     readonly settled?: SettledTurn;
 });
-export {};

package/dist/src/execution/session/turn-step.js

@@ -1 +1 @@
-import{resolveRuntimeCompiledArtifactsVersionedCacheKey}from"#runtime/cache-key.js";import{defaultDeliverResult}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{currentProjection,enterSessionProjection,recordAppliedSession,saveSessionProjection}from"#harness/session-machine/current.js";import{AuthKey,CapabilitiesKey,ChannelDeliveryKey,HandleEventKey,InitiatorAuthKey,OccurrenceIdKey,ParentSessionKey,ScheduleIdKey,ScheduleInstanceKey,SessionDynamicSubagentRuntimeRevisionKey,SessionDynamicToolRuntimeRevisionKey,SessionTitleKey,StaticModelReferenceKey,TurnDeliveryIdsKey}from"#context/keys.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{coalesceTurnInputs,validateHarnessModelMessages}from"#harness/messages.js";import{activeTurnId,isBetweenTurns,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{createDurableSessionValues,readDurableSession}from"#execution/durable-session-store.js";import{runStep}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{readHitlState}from"#harness/hitl/index.js";import*as agentTraceState from"#tracing/eve/agent-trace-context-store.js";import{CallbackBaseUrlKey,PendingAuthorizationResultKey}from"#harness/authorization.js";import{refreshDynamicSessionSubagentsForRuntimeRevision}from"#context/dynamic-subagent-lifecycle.js";import{hydrateDurableSession,refreshSessionFromTurnAgent}from"#execution/session.js";import{resolveEffectiveAgentRuntime,resolveSessionUsageLimit}from"#execution/effective-agent-config.js";import{openSessionEventPublisher}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/state-delta.js";import{matchSignIns}from"#harness/session-machine/transitions.js";import{readPendingHistory,withoutPendingHistory}from"#execution/session/pending-history.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{sessionStartedForResolvers,turnStartedForResolvers}from"#harness/session-machine/resolver-events.js";import{derivePendingState}from"#execution/session/pending-turn-state.js";import{rebindMissingCompiledDynamicToolCallbacks,refreshDynamicSessionToolsForRuntimeRevision}from"#context/dynamic-tool-lifecycle.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{setChannelContext}from"#execution/channel-context.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{createTurnEventHandler}from"#execution/session/turn-event-handler.js";import{isTurnCancellation,throwIfTurnAborted}from"#harness/turn-cancellation.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{bindTurnCallerContext}from"#subagents/parent-notification.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";import{startSessionPrewarmers}from"#context/prewarm.js";import{bindDynamicConnections}from"#execution/dynamic-connections.js";import{recoverDynamicConnectionRehydration}from"#execution/dynamic-connection-recovery.js";import{setEveAttributes}from"#runtime/attributes/emit.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{matchAuthorizationCallbacks}from"#execution/authorization-callback-match.js";import{attributeAnswers}from"#execution/session/answer-caller.js";import{resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{countRunUsage}from"#execution/agent-sessions/usage.js";import{buildRuntimeIdentity,createExecutionNodeStep}from"#execution/node-step.js";import{createExecutionHistoryView}from"#execution/history-view.js";import{runModelCallBatch}from"#execution/model-call-batching.js";import{createCancelledModelCallBatchResult}from"#execution/cancelled-model-call-batch.js";function channelDeliveryErrorCode(e){if(typeof e==`object`&&e&&`code`in e){let t=e.code;if(typeof t==`string`&&t.length>0)return t}return`CHANNEL_DELIVERY_FAILED`}async function turnStep(e){"use step";return e.handover!==void 0&&traceSessionHandover(`inbox_unblocked`,e.sessionState.sessionId,e.handover.attemptKey,{"eve.handoff.buffered_payload_count":e.handover.payloadCount,"eve.handoff.applied_at_ms":e.handover.appliedAtMs,"eve.handoff.applied_at_clock":`workflow`}),await withSessionStateDelta(e,e=>runSessionStep({...e,serializedContext:bindTurnCallerContext(e.caller,e.serializedContext)}))}async function runSessionStep(e){let t={};try{return await runSessionStepBody(e,t)}finally{await t.title}}async function runSessionStepBody(e,t){let n=e.input?.delivery,r=n,i=e.input?.runtimeResults,a=readDurableSession(e.sessionState);for(let e of i?.delegatedUsage??[])a=countRunUsage(a,e);let o=await deserializeContext(e.serializedContext);enterSessionProjection(o,a.state);let s=o.require(ChannelKey),c=o.require(BundleKey),l=resolveEffectiveAgentRuntime(c,o);try{let{getWorkflowMetadata:e}=await import(`#compiled/@workflow/core/index.js`),t=e();typeof t.url==`string`&&o.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(t.url))}catch{}let{signIns:u}=readHitlState(a.state),d;if(u.length>0&&r!==void 0){let{matches:e,remainingPayloads:t}=matchAuthorizationCallbacks(u,r.payloads);if(r={...r,payloads:t},e.length>0){let n=e.map(e=>e.result.attemptId),i=e.map(e=>e.result);o.set(PendingAuthorizationResultKey,i);let s=sessionView(storedProjection(a.state),a.state),c=matchSignIns(s,{attemptIds:n});if(c.events.length!==0)throw Error(`matchSignIns must not emit events.`);a=saveTransition(a,c),d=e,t.length===0&&(r=void 0)}}r?.payloads.some(e=>e.message!==void 0)&&(o.delete(ScheduleIdKey),o.delete(ScheduleInstanceKey),o.delete(OccurrenceIdKey),r.schedule!==void 0&&(o.set(ScheduleIdKey,r.schedule.definition),r.schedule.instance!==void 0&&o.set(ScheduleInstanceKey,r.schedule.instance),r.schedule.occurrenceId!==void 0&&o.set(OccurrenceIdKey,r.schedule.occurrenceId)));let f=o.get(AuthKey),p=o.has(InitiatorAuthKey);r?.auth!==void 0&&(o.set(AuthKey,r.auth??null),o.has(InitiatorAuthKey)||o.set(InitiatorAuthKey,r.auth??null));let m=r===void 0?d?.find(({challenge:e})=>e.candidateId===void 0)?.challenge.requester:void 0;m!==void 0&&o.set(AuthKey,m);let h=r?.payloads.some(e=>e.message!==void 0)===!0?readPendingHistory(a.state):[],g={...hydrateDurableSession({compactionOverrides:{thresholdPercent:l.thresholdPercent},durable:a,turnAgent:l.turnAgent}),history:validateHarnessModelMessages(e.history)},_=createExecutionHistoryView(g),v=bindSessionInstrumentation({agentName:l.turnAgent.id,ctx:o,rootSessionId:g.rootSessionId??g.sessionId,sessionId:g.sessionId}),y=turnPosition(currentProjection(o)),b=isBetweenTurns(currentProjection(o));if(!y.sessionStarted&&!o.has(SessionTitleKey)&&!o.has(ParentSessionKey)){let e=n?.payloads.find(e=>e.message!==void 0)?.message,r=deriveSessionTitle(n?.title??e);r!==void 0&&(o.set(SessionTitleKey,r),t.title=setEveAttributes({"$eve.title":r}))}n!==void 0&&(await contextStorage.run(o,()=>v?.preparePreamble({sequence:y.sequence,sessionStarted:y.sessionStarted})),await contextStorage.run(o,()=>v?.instrumentChannelDelivery({agentName:c.turnAgent.id,ctx:o,delivery:n,rootSessionId:g.rootSessionId??g.sessionId,sequence:y.sequence,sessionId:g.sessionId,turnId:activeTurnId(y)})));let failChannelDeliveries=async e=>{await contextStorage.run(o,()=>v?.instrumentChannelDelivery({ctx:o,error:e,errorCode:channelDeliveryErrorCode(e),includeTurn:!1,outcome:`failed`})),await v?.flush()},x=openSessionEventPublisher({ctx:o,origin:`own`,sessionWritable:e.sessionWritable}),{adapterCtx:S}=x.dispatcher,C=new AbortController,w=e.abortSignal===void 0?C.signal:AbortSignal.any([e.abortSignal,C.signal]);try{let u=bindDynamicConnections(o,c.resolvedAgent),m={...c.graph.root,turnAgent:l.turnAgent},T=resolveSessionUsageLimit(c),E=!1,D=createTurnEventHandler({abortSignal:w,bundle:c,canCancelTurn:e.input?.control===void 0,hookCancellation:C,ctx:o,dynamicConnections:u,effectiveAgent:l,effectiveNode:m,instrumentation:v,publisher:x}),handleEvent=async(e,t)=>{e.type===`compaction.completed`&&(E=!0),await D(e,t)},O=r!==void 0&&!b?structuredClone(S.state):void 0,k;if(r!==void 0){let e=[];try{for(let t of r.payloads){let n=s.deliver?await s.deliver(t,S):defaultDeliverResult(t);if(n!=null){let r=[...e.length===0?h:[],...t.history??[]];e.push(r.length===0?n:{...n,history:r})}}}catch(e){throw await failChannelDeliveries(e),e}e.length>0&&h.length>0&&(g={...g,state:withoutPendingHistory(g.state)}),k=e.length===0?void 0:e.reduce(coalesceTurnInputs)}let A=r?.auth===void 0?void 0:attributeAnswers({responder:r.auth,state:a.state,stepInput:k});if(A!==void 0&&(k=A,f===void 0?o.delete(AuthKey):o.set(AuthKey,f),p||o.delete(InitiatorAuthKey)),r!==void 0&&k===void 0&&!b)f===void 0?o.delete(AuthKey):o.set(AuthKey,f),S.state=O;else if(n?.payloads.some(e=>e.message!==void 0)){let e=n.deliveryMetadata?.map(e=>e.deliveryId)??[];o.set(TurnDeliveryIdsKey,y.turnId?[...new Set([...o.get(TurnDeliveryIdsKey)??[],...e])]:e)}else!y.sessionStarted&&o.get(ChannelDeliveryKey)!==void 0&&o.set(TurnDeliveryIdsKey,[o.require(ChannelDeliveryKey).deliveryId]);if(i!==void 0&&(i.acceptedAtMsByCallId!==void 0&&o.set(RuntimeActionSettlementTimesKey,i.acceptedAtMsByCallId),k={...k,runtimeActionResults:i.results}),n!==void 0){let e={...s,state:{...S.state}};setChannelContext(o,e)}if(r!==void 0&&k===void 0&&b){await contextStorage.run(o,()=>v?.instrumentChannelDelivery({ctx:o,includeTurn:!1,outcome:`completed`})),await v?.flush();let t=saveSessionProjection(reconcileSessionContinuationToken(o,g),o),n=serializeContext(o),r=t===g?{history:e.history,sessionState:e.sessionState}:createDurableSessionValues(t);return{action:`park`,...derivePendingState(t,currentProjection(o)),serializedContext:n,...r}}let j=c.subagentRegistry.dynamicResolvers??[],M=c.resolvedAgent.dynamicToolResolvers??[],N=buildRuntimeIdentity(m);try{let e=process.env.VERCEL_DEPLOYMENT_ID?.trim(),t=e?`deployment:${e}`:await resolveRuntimeCompiledArtifactsVersionedCacheKey(c.compiledArtifactsSource),n=y.sessionStarted;if(o.setVirtualContext(StaticModelReferenceKey,l.turnAgent.model??null),!n)o.set(SessionDynamicSubagentRuntimeRevisionKey,t),o.set(SessionDynamicToolRuntimeRevisionKey,t);else{let e=sessionStartedForResolvers(N);await Promise.all([refreshDynamicSessionSubagentsForRuntimeRevision({ctx:o,resolvers:j,event:e,messages:_.initial.messages,runtimeRevision:t}),contextStorage.run(o,async()=>await refreshDynamicSessionToolsForRuntimeRevision({ctx:o,resolvers:M,event:e,messages:_.initial.messages,runtimeRevision:t}))]),b||await rebindMissingCompiledDynamicToolCallbacks({ctx:o,event:turnStartedForResolvers({sequence:y.sequence,turnId:activeTurnId(y)}),messages:_.initial.messages,resolvers:M})}}catch(e){throw await failChannelDeliveries(e),e}let P=c.resolvedAgent.config?.experimental?.workflow?.modelCallsPerStep??1,F=o.get(CapabilitiesKey),runHarnessStep=async(n,r,i)=>{let a=refreshSessionFromTurnAgent({compactionOverrides:{thresholdPercent:l.thresholdPercent},session:n,turnAgent:l.turnAgent});return createExecutionNodeStep({steeringSignal:e.steeringSignal,abortSignal:w,capabilities:F,clearOnly:e.input?.control===`clear`,compactOnly:e.input?.control===`compact`,createRuntime:createWorkflowRuntime,handleEvent,prepareApprovalTurn:e=>u.dispatch(turnStartedForResolvers(e)),signInCompletions:i,typedAnswers:!hasDelegatedSessionContext(e.serializedContext),historyProjector:_.projector,historyView:_.prepare(a),instrumentation:v,modelResolutionScope:{moduleMap:c.moduleMap,nodeId:c.nodeId},node:m,sessionUsageLimit:T,titleAttributeWrite:t.title})(a,r)},I,L;try{throwIfTurnAborted(w),L=await runModelCallBatch({steeringSignal:e.steeringSignal,initialInput:k,initialSession:g,modelCallsPerStep:P,runStep:async({firstCall:t,session:n,stepInput:r})=>{let i=await runStep(o,n,async n=>{t&&e.input?.control===void 0&&startSessionPrewarmers(o,`turn`),o.setVirtualContext(HandleEventKey,handleEvent),o.setVirtualContext(StaticModelReferenceKey,l.turnAgent.model??null);let i=t&&k?.outputSchema!==void 0?{...n,outputSchema:k.outputSchema}:n,a=turnPosition(currentProjection(o));try{await u.rehydrate(a,N,isBetweenTurns(currentProjection(o))?void 0:{sequence:a.sequence,turnId:activeTurnId(a)})}catch(e){let t=await recoverDynamicConnectionRehydration({emit:handleEvent,error:e,projection:currentProjection(o),session:i});if(t!==void 0)return t;throw e}let s=t&&d!==void 0?d.map(({challenge:e})=>e):void 0;return runHarnessStep(i,r,s)});i.settledTurn===void 0&&throwIfTurnAborted(w);let a={...i,session:saveSessionProjection(i.session,o)};return recordAppliedSession(o,a.session),I={result:a,serializedContext:serializeContext(o)},a}})}catch(t){if(!isTurnCancellation(t)&&!w.aborted)throw await failChannelDeliveries(t),t;return createCancelledModelCallBatchResult({beforeBatchContext:e.serializedContext,checkpoint:I,ctx:o,initialSession:g,stepInput:k})}let R=saveSessionProjection(dropClosedRecords(reconcileSessionContinuationToken(o,L.session),currentProjection(o)),o);agentTraceState.pruneAgentTraceState(o,R.sessionId,R.state);let z=serializeContext(o);L={...L,session:R};let B=resolveSessionStepResult(L,z);return B.action===`done`&&await x.writer.close(),E?{...B,compacted:!0}:B}finally{x.writer.release()}}export{turnStep};
+import{createLogger}from"#internal/logging.js";import{resolveRuntimeCompiledArtifactsVersionedCacheKey}from"#runtime/cache-key.js";import{defaultDeliverResult,getAdapterKind}from"#channel/adapter.js";import{contextStorage}from"#context/container.js";import{AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,HandleEventKey,InitiatorAuthKey,OccurrenceIdKey,ParentSessionKey,SandboxKey,ScheduleIdKey,ScheduleInstanceKey,SessionKey,SessionPredecessorKey,SessionTitleKey,StaticModelReferenceKey,TurnDeliveryIdsKey}from"#context/keys.js";import{bindMemoryInstrumentation}from"#reactions/kinds/memory.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{sandboxProvider}from"#context/providers/sandbox.js";import{isBetweenTurns,storedProjection,turnPosition}from"#harness/session-machine/view.js";import{currentProjection,enterSessionProjection,enterSessionProjectionAt,nextLinePosition,recordAppliedSession,saveSessionProjection}from"#harness/session-machine/current.js";import{ConnectionRegistryKey,connectionProvider}from"#context/providers/connection.js";import{sessionProvider}from"#context/providers/session.js";import{createWorkflowRuntime}from"#execution/workflow-runtime.js";import{resolveWorkflowCallbackBaseUrl}from"#execution/workflow-callback-url.js";import{runStep,withContextScope}from"#context/run-step.js";import{deserializeContext,serializeContext}from"#context/serialize.js";import{createDurableSessionValues,readDurableSession}from"#execution/durable-session-store.js";import{readHitlState}from"#harness/hitl/index.js";import*as agentTraceState from"#tracing/eve/agent-trace-context-store.js";import{coalesceTurnInputs,validateHarnessModelMessages}from"#harness/messages.js";import{CallbackBaseUrlKey,PendingAuthorizationResultKey}from"#harness/authorization.js";import{hydrateDurableSession,refreshSessionFromTurnAgent}from"#execution/session.js";import{resolveEffectiveAgentRuntime,resolveSessionUsageLimit}from"#execution/effective-agent-config.js";import{checksSessionEvents,foldOrphanedLines,openSessionEventPublisher,readOrphanedLines}from"#execution/publish-session-events.js";import{withSessionStateDelta}from"#execution/session/step-state-delta.js";import{dropClosedRecords,saveTransition,sessionView}from"#harness/session-machine/commit.js";import{matchSignIns,receive}from"#harness/session-machine/transitions.js";import{readPendingHistory,withoutPendingHistory}from"#execution/session/pending-history.js";import{fact}from"#harness/facts.js";import{admitDeliveries}from"#execution/session/delivery-facts.js";import{hasDelegatedSessionContext}from"#execution/delegated-session-context.js";import{setChannelContext}from"#execution/channel-context.js";import{applyReactionEffects,restoreReactions}from"#reactions/runner.js";import{reconcileSessionContinuationToken}from"#execution/reconcile-session-continuation-token.js";import{eventsOf}from"#harness/publication.js";import{bindSessionInstrumentation}from"#instrumentation/runtime.js";import{deriveSessionTitle}from"#execution/eve-workflow-attributes.js";import{isTurnCancellation,throwIfTurnAborted}from"#harness/turn-cancellation.js";import{bindTurnCallerContext}from"#subagents/parent-notification.js";import{traceSessionHandover}from"#execution/session/handover-tracing.js";import{createCancelledModelCallBatchResult}from"#execution/cancelled-model-call-batch.js";import{pausedOrParked,resolveSessionStepResult}from"#execution/session/turn-step-result.js";import{startSessionPrewarmers}from"#context/prewarm.js";import{setEveAttributes}from"#runtime/attributes/emit.js";import{RuntimeActionSettlementTimesKey}from"#harness/runtime-action-settlement-state.js";import{matchAuthorizationCallbacks}from"#execution/authorization-callback-match.js";import{attributeAnswers}from"#execution/session/answer-caller.js";import{readInterruptedAttempt,recoverInterruptedStep}from"#execution/session/interrupted-step.js";import{stepDisagreement}from"#execution/session/step-decision-check.js";import{createTurnEventHandler}from"#execution/session/turn-event-handler.js";import{buildRuntimeIdentity,createExecutionNodeStep}from"#execution/node-step.js";import{runModelCallBatch}from"#execution/model-call-batching.js";const log=createLogger(`execution.turn-step`);async function turnStep(e){"use step";return e.handover!==void 0&&traceSessionHandover(`inbox_unblocked`,e.sessionState.sessionId,e.handover.attemptKey,{"eve.handoff.buffered_payload_count":e.handover.payloadCount,"eve.handoff.applied_at_ms":e.handover.appliedAtMs,"eve.handoff.applied_at_clock":`workflow`}),await withSessionStateDelta(e,e=>runSessionStep({...e,serializedContext:bindTurnCallerContext(e.caller,e.serializedContext)}))}async function runSessionStep(e){let t={};try{return await runSessionStepBody(e,t)}finally{await t.title}}async function runSessionStepBody(e,t){let n=e.input?.delivery,r=n,i=e.input?.runtimeResults,a=readDurableSession(e.sessionState),o=await deserializeContext(e.serializedContext);enterSessionProjection(o,a.state);let s=await readOrphanedLines({sessionId:a.sessionId,position:nextLinePosition(o),sessionWritable:e.sessionWritable,always:e.recover!==void 0}),c=s.length>0||e.recover!==void 0?readInterruptedAttempt(nextLinePosition(o),s):void 0;s.length>0&&enterSessionProjectionAt(o,foldOrphanedLines(currentProjection(o),s));let l=o.require(ChannelKey),u=o.require(BundleKey),d=resolveEffectiveAgentRuntime(u,o);try{let{getWorkflowMetadata:e}=await import(`#compiled/@workflow/core/index.js`),t=e();typeof t.url==`string`&&o.set(CallbackBaseUrlKey,resolveWorkflowCallbackBaseUrl(t.url))}catch{}let{signIns:f}=readHitlState(a.state),p;if(f.length>0&&r!==void 0){let{matches:e,remainingPayloads:t}=matchAuthorizationCallbacks(f,r.payloads);if(r={...r,payloads:t},e.length>0){let n=e.map(e=>e.result.attemptId),i=e.map(e=>e.result);o.set(PendingAuthorizationResultKey,i);let s=sessionView(storedProjection(a.state),a.state),c=matchSignIns(s,{attemptIds:n});if(c.events.length!==0)throw Error(`matchSignIns must not emit events.`);a=saveTransition(a,c),p=e,t.length===0&&(r=void 0)}}r?.payloads.some(e=>e.message!==void 0)&&(o.delete(ScheduleIdKey),o.delete(ScheduleInstanceKey),o.delete(OccurrenceIdKey),r.schedule!==void 0&&(o.set(ScheduleIdKey,r.schedule.definition),r.schedule.instance!==void 0&&o.set(ScheduleInstanceKey,r.schedule.instance),r.schedule.occurrenceId!==void 0&&o.set(OccurrenceIdKey,r.schedule.occurrenceId)));let m=o.get(AuthKey),h=o.has(InitiatorAuthKey);r?.auth!==void 0&&(o.set(AuthKey,r.auth??null),o.has(InitiatorAuthKey)||o.set(InitiatorAuthKey,r.auth??null));let g=r===void 0?p?.find(({challenge:e})=>e.candidateId===void 0)?.challenge.requester:void 0;g!==void 0&&o.set(AuthKey,g);let _={...hydrateDurableSession({compactionOverrides:{thresholdPercent:d.thresholdPercent},durable:a,turnAgent:d.turnAgent}),history:validateHarnessModelMessages(e.history)},v=bindSessionInstrumentation({agentName:d.turnAgent.id,ctx:o,rootSessionId:_.rootSessionId??_.sessionId,sessionId:_.sessionId});bindMemoryInstrumentation(o,v?.memory);let y=turnPosition(currentProjection(o)),b=isBetweenTurns(currentProjection(o));if(!y.sessionStarted&&!o.has(SessionTitleKey)&&!o.has(ParentSessionKey)){let e=n?.payloads.find(e=>e.message!==void 0)?.message,r=deriveSessionTitle(n?.title??e);r!==void 0&&(o.set(SessionTitleKey,r),t.title=setEveAttributes({"$eve.title":r}))}n!==void 0&&(await contextStorage.run(o,()=>v?.preparePreamble({sequence:y.sequence,sessionStarted:y.sessionStarted})),v?.prepareDelivery(n));let x=openSessionEventPublisher({ctx:o,origin:`own`,sessionWritable:e.sessionWritable}),{adapterCtx:S}=x.dispatcher,C=new AbortController,w=e.abortSignal===void 0?C.signal:AbortSignal.any([e.abortSignal,C.signal]);try{let s={...u.graph.root,turnAgent:d.turnAgent},f=resolveSessionUsageLimit(u),g=!1,T=createTurnEventHandler({abortSignal:w,canCancelTurn:e.input?.control===void 0,conversation:_.history,hookCancellation:C,publisher:x}),handleEvent=async(e,t)=>{eventsOf(e).some(e=>e.type===`context.settled`&&e.data.kind===`compaction`&&e.data.outcome===`completed`)&&(g=!0),await T(e,t)},E=r!==void 0&&!b?structuredClone(S.state):void 0,D,O;if(r!==void 0){let e=[],t=r.payloads.some(e=>e.message!==void 0)?readPendingHistory(a.state):[],i=0;try{for(let n of r.payloads){let r=l.deliver?await l.deliver(n,S):defaultDeliverResult(n);if(r==null){e.push({input:void 0,payload:n});continue}let a=[...i===0?t:[],...n.history??[]];i+=1,e.push({input:a.length===0?r:{...r,history:a},payload:n})}}catch(e){throw await v?.flush(),e}O=admitDeliveries({channelKind:o.get(ChannelInstrumentationKey)?.kind??getAdapterKind(l),delivery:n??r,status:e=>currentProjection(o).view.deliveries[e]?.status,payloads:e}),i>0&&t.length>0&&(_={..._,state:withoutPendingHistory(_.state)}),D=O.inputs.length===0?void 0:O.inputs.reduce(coalesceTurnInputs)}let k=r?.auth===void 0?void 0:attributeAnswers({responder:r.auth,state:a.state,stepInput:D});if(k!==void 0&&(D=k,m===void 0?o.delete(AuthKey):o.set(AuthKey,m),h||o.delete(InitiatorAuthKey)),r!==void 0&&D===void 0&&!b)m===void 0?o.delete(AuthKey):o.set(AuthKey,m),S.state=E;else if(n?.payloads.some(e=>e.message!==void 0)){let e=n.deliveryMetadata?.map(e=>e.deliveryId)??[];o.set(TurnDeliveryIdsKey,y.turnId?[...new Set([...o.get(TurnDeliveryIdsKey)??[],...e])]:e)}else!y.sessionStarted&&o.get(ChannelDeliveryKey)!==void 0&&o.set(TurnDeliveryIdsKey,[o.require(ChannelDeliveryKey).deliveryId]);if(i!==void 0&&(i.acceptedAtMsByCallId!==void 0&&o.set(RuntimeActionSettlementTimesKey,i.acceptedAtMsByCallId),D={...D,delegatedUsage:i.delegatedUsage,runtimeActionResults:i.results}),n!==void 0){let e={...l,state:{...S.state}};setChannelContext(o,e)}let A=!1,admissionFacts=e=>{if(O===void 0||O.facts.length===0)return[];let t=[];if(!turnPosition(currentProjection(o)).sessionStarted){let n=o.get(ParentSessionKey),r=o.get(SessionPredecessorKey);t.push(fact(`session.started`,{parent:n===void 0?void 0:{callId:n.callId,sessionId:n.sessionId},predecessor:r,runtime:e}))}return[...t,...O.facts]},publishAdmission=async e=>{let t=admissionFacts(e);if(t.length===0)return;let n=sessionProvider.create(o,_);o.setVirtualContext(SessionKey,n.value);let r=await connectionProvider.create(o,_);r!==void 0&&o.setVirtualContext(ConnectionRegistryKey,r.value);let i=await sandboxProvider.create(o,_);i!==void 0&&o.setVirtualContext(SandboxKey,i.value);let a=v?.createHandleEvent({handleEvent})??handleEvent;try{await contextStorage.run(o,()=>a(t))}finally{if(i!==void 0){let e=await i.value.captureState();JSON.stringify(e)!==JSON.stringify(_.sandboxState??null)&&(A=!0,_={..._,sandboxState:e})}}},consumeCancelledInput=async()=>{let e=currentProjection(o),t=(D?.deliveries??[]).filter(({deliveryId:t})=>e.view.deliveries[t]?.status===`admitted`);if(t.length===0)return;let{events:n}=receive(sessionView(e,_.state),{deliveries:t}),r=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:_.history,hookCancellation:new AbortController,publisher:x}),i=v?.createHandleEvent({handleEvent:r})??r;await contextStorage.run(o,()=>i(n))};if(r!==void 0&&D===void 0&&b){await publishAdmission(buildRuntimeIdentity(s)).catch(ignoreTurnCancellation),await v?.flush();let t=saveSessionProjection(reconcileSessionContinuationToken(o,_),o),n=serializeContext(o),r=t===_&&!A?{history:e.history,sessionState:e.sessionState}:createDurableSessionValues(t);return pausedOrParked(t,{serializedContext:n,...r})}let j=buildRuntimeIdentity(s),M,prepareReactions=e=>(o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null),M??=(async()=>{try{let t=process.env.VERCEL_DEPLOYMENT_ID?.trim(),n=t?`deployment:${t}`:await resolveRuntimeCompiledArtifactsVersionedCacheKey(u.compiledArtifactsSource);await contextStorage.run(o,()=>restoreReactions(o,{abortSignal:w,conversation:e.history,revision:n}))}catch(e){throw await v?.flush(),e}})());if(c!==void 0){let t=await recoverInterruptedStep({admission:admissionFacts(j),attempt:c,control:e.input?.control===void 0?void 0:{delivery:e.input.controlDelivery,kind:e.input.control},ctx:o,failed:e.recover,publish:async(e,t)=>(await withContextScope(o,t,async t=>{await prepareReactions(t);let n=createTurnEventHandler({abortSignal:w,canCancelTurn:!1,conversation:t.history,hookCancellation:new AbortController,publisher:x});return await(v?.createHandleEvent({handleEvent:n})??n)(e),{result:void 0,session:t}})).session,session:_,stepInput:D}).catch(async e=>{throw await v?.flush(),e});if(`result`in t)return await v?.flush(),t.result.action===`done`&&await x.writer.close().catch(()=>{}),t.result;_=t.session,D=t.stepInput}await prepareReactions(_);try{await publishAdmission(j)}catch(e){if(!isTurnCancellation(e))throw await v?.flush(),e}let N=u.resolvedAgent.config?.experimental?.workflow?.modelCallsPerStep??1,P=o.get(CapabilitiesKey),runHarnessStep=async(n,r,i)=>{let a=refreshSessionFromTurnAgent({compactionOverrides:{thresholdPercent:d.thresholdPercent},session:n,turnAgent:d.turnAgent});return createExecutionNodeStep({steeringSignal:e.steeringSignal,abortSignal:w,capabilities:P,clearOnly:e.input?.control===`clear`,compactOnly:e.input?.control===`compact`,controlDelivery:e.input?.controlDelivery,createRuntime:createWorkflowRuntime,handleEvent,signInCompletions:i,typedAnswers:!hasDelegatedSessionContext(e.serializedContext),instrumentation:v,modelResolutionScope:{moduleMap:u.moduleMap,nodeId:u.nodeId},node:s,sessionUsageLimit:f,titleAttributeWrite:t.title})(a,r)},F,I;try{throwIfTurnAborted(w),I=await runModelCallBatch({steeringSignal:e.steeringSignal,initialInput:D,initialSession:_,modelCallsPerStep:N,runStep:async({firstCall:t,session:n,stepInput:r})=>{let i=await runStep(o,n,async n=>{t&&e.input?.control===void 0&&startSessionPrewarmers(o,`turn`),o.setVirtualContext(HandleEventKey,handleEvent),o.setVirtualContext(StaticModelReferenceKey,d.turnAgent.model??null);let i=t&&D?.outputSchema!==void 0?{...n,outputSchema:D.outputSchema}:n;await applyReactionEffects(o);let a=t&&p!==void 0?p.map(({challenge:e})=>e):void 0,s=await runHarnessStep(i,r,a);return await x.finish({announce:stoppedForPerson(s)}),s});i.settledTurn===void 0&&throwIfTurnAborted(w);let a={...i,session:saveSessionProjection(i.session,o)};return recordAppliedSession(o,a.session),F={result:a,serializedContext:serializeContext(o)},a}})}catch(t){if(!isTurnCancellation(t)&&!w.aborted)throw await v?.flush(),t;return F===void 0&&await consumeCancelledInput(),createCancelledModelCallBatchResult({beforeBatchContext:e.serializedContext,checkpoint:F,ctx:o,initialSession:_,stepInput:D})}let L=saveSessionProjection(dropClosedRecords(reconcileSessionContinuationToken(o,I.session),currentProjection(o)),o);agentTraceState.pruneAgentTraceState(o,L.sessionId,L.state);let R=serializeContext(o);I={...I,session:L};let z=resolveSessionStepResult(I,R);if(checksSessionEvents()){let e=stepDisagreement(z,currentProjection(o).view);e!==void 0&&e!==`dispatch-deferred`&&log.warn(`a turn step's decision disagrees with the session's tables`,{disagreement:e})}return z.action===`done`&&await x.writer.close(),g?{...z,compacted:!0}:z}finally{x.writer.release()}}function stoppedForPerson(e){return e.held===void 0?e.next===null&&e.settledTurn===void 0:e.held.kind===`request`}function ignoreTurnCancellation(e){if(!isTurnCancellation(e))throw e}export{turnStep};

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

@@ -2,7 +2,7 @@ import type { SessionCapabilities, TurnCaller } from "#channel/types.js";
 import type { SessionInputQueue } from "#execution/session/input-queue.js";
 import type { SessionInboxReader } from "#execution/session-inbox/inbox.js";
 import type { SessionStateCursor } from "#execution/session/state-cursor.js";
-import type { WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
+import { type WorkflowToolRunMessage } from "#execution/tools/workflow/messages.js";
 import type { TurnOutcome, TurnStepPayload } from "#execution/session/turn-step-types.js";
 import { ActiveTurn } from "#execution/session/active-turn.js";
 import type { TurnControl } from "#execution/session/turn-control.js";
@@ -37,13 +37,29 @@ export declare class SessionExecution {
     /**
      * Applies what runs reported while the model step ran, so the next step sees
      * it. Consecutive messages the session applies as it reads them, such as a
-     * fan-out's, share one step. An ending session drops `agent-started`: its
-     * stream is closed, and finalizing the session terminates the children.
+     * fan-out's, share one step. An ending session drops its runs' agent session
+     * messages: its stream is closed, and finalizing the session terminates the
+     * children.
      */
     private handleBoundaryMessages;
     /** Hooks on the messages' events may cancel `turn`, the turn that is running. */
     private applyRunMessages;
     private runTurnSteps;
+    /** The next step's input: what resumed the turn, behind any steering admitted meanwhile. */
+    private withSteering;
+    /**
+     * Waits for what a paused turn awaits, and returns the input its next step reads:
+     *
+     * - an interaction's answer, a sign-in callback, or the turn's own requester steering it, for the
+     *   requests and sign-ins it raised. Anyone else's message queues behind the turn, as does a
+     *   message admitted before the step that raised the request (`heldSince`): it was sent
+     *   before the request existed;
+     * - one of its tasks settling. Steering interrupts that wait;
+     * - every call's result. Steering interrupts the workflow tool calls, which still report.
+     */
+    private resume;
+    /** Starts the runs a paused step asked for, answers its task tool calls, and tracks the rest. */
+    private startCallWait;
     /**
      * Starts the workflow tool runs a parked step requested, and returns the
      * results of any that settled at once. Task tool calls need no dispatch: the
@@ -64,33 +80,4 @@ export declare class SessionExecution {
     cancelTurnWork(): Promise<void>;
     /** `session.cancel()` stops the turn, the calls it waits on, and every working task. */
     private finishCancelledTurn;
-    /**
-     * The model tried to end the turn while its tasks work. The turn parks as
-     * `eve__task_wait` would, until one of them settles or the turn is steered.
-     */
-    private waitForHeldTurn;
-    /**
-     * The turn waits on a sign-in or tool approval it raised. It wakes with the
-     * delivery its next step reads: the sign-in callback, an approval answer
-     * from any responder, or a message from the turn's own person, which steers
-     * the turn and cancels the request. Anyone else's message queues behind it,
-     * as does a queued message admitted before the step that raised the request
-     * (`heldSince`): it was sent before the request existed, so it must not
-     * answer it.
-     */
-    private waitForHeldRequest;
-    private waitForRuntimeActionResults;
-    /** Answers every `eve__task_wait` that can return now; returns the ones still waiting. */
-    private resolveTaskWaits;
-    /**
-     * `eve__task_cancel` is answered at once, and so is each `eve__task_wait` that can
-     * return now: a timeout of 0, a result already waiting, or nothing working.
-     * Any other `eve__task_wait` parks the open turn, reported once as
-     * `turn.waiting`, and the turn resolves it alongside the step's other
-     * workflow tool calls.
-     */
-    private answerTaskToolCalls;
-    private traceTaskWait;
-    /** Aborts the `abortSignal` of every workflow tool call the wait has no result for yet. */
-    private interruptWaitedWorkflowCalls;
 }

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

@@ -1 +1 @@
-import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{renderTaskWaitResult}from"#execution/tasks/render.js";import{sleep}from"#compiled/@workflow/core/index.js";import{findBlockingWorkflowToolRun,getBlockingWorkflowToolRuns,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{taskWaitResult}from"#execution/tasks/table.js";import{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{resolveTurnPrincipal}from"#execution/session/principal.js";import{answerTaskCancel,cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{cancelDescendantTurnsStep}from"#execution/cancel-descendant-turns-step.js";import{dispatchCoordinationStep,publishTaskStartedStep}from"#execution/coordination-dispatch-step.js";import{taskToolResult}from"#execution/tasks/calls.js";import{publishTurnWaitingStep}from"#execution/session/turn-waiting-step.js";import{applyRunMessagesStep}from"#execution/tools/workflow/apply-run-messages-step.js";import{interruptWorkflowToolRun}from"#execution/tools/workflow/interrupt.js";import{turnStep}from"#execution/session/turn-step.js";import{ActiveTurn}from"#execution/session/active-turn.js";import{resolveRuntimeActionResultsForCallIds}from"#runtime/actions/results.js";import{startTaskToolCallsStep,traceTaskToolCallStep}from"#execution/session/task-tool-tracing-step.js";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`}var SessionExecution=class{input;observedHandoverAttemptKey;constructor(e){this.input=e}get cursor(){return this.input.cursor}async runTurn(e,t={}){let n=new ActiveTurn(this.input,{caller:t.caller,principal:resolveTurnPrincipal(e,this.input.cursor.serializedContext)},t.control);try{let t=await this.runTurnSteps(n,e);return await this.handleBoundaryMessages(n.takeBoundaryMessages(),t.kind===`done`),t.kind===`park`&&t.settled!==void 0&&await cancelWorkingTasks(this.input.cursor,`turn_ended`),{...t,...n.caller!==void 0&&{caller:n.caller},...n.compacted&&{compacted:!0}}}finally{n.dispose()}}async handleBoundaryMessages(e,t=!1,n){let r=[];for(let i of e)isAppliedRunMessage(i)?(!t||i.kind!==`agent-started`)&&r.push(i):(await this.applyRunMessages(r,n),r=[],await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:i}));await this.applyRunMessages(r,n)}async applyRunMessages(e,t){if(e.length===0)return;let{cancelled:n}=await this.input.cursor.advance(n=>applyRunMessagesStep({...n,canCancelTurn:t!==void 0,messages:e}));n&&t?.abort()}async runTurnSteps(e,t){let n=t,r=e.caller;for(;;){let{cursor:t}=this.input,i=r;r=void 0;let a=this.input.inbox.handoverObservation,o=a?.attemptKey===this.observedHandoverAttemptKey?void 0:a,s=await t.advanceWithHistory(t=>turnStep({...t,handover:o,abortSignal:e.signal,caller:i,input:n,steeringSignal:e.steeringSignal}));o!==void 0&&(this.observedHandoverAttemptKey=o.attemptKey),s.compacted===!0&&(e.compacted=!0);let c=s.action===`park`?s.pendingCoordinationCallIds:void 0,l=s.action===`park`&&s.settled!==void 0,u=this.input.queue.nextAdmission;await e.admitBoundary();let d=s.action===`done`;if(await this.handleBoundaryMessages(e.takeBoundaryMessages(),d,d?void 0:e),s.action===`cancelled`||!l&&e.signal.aborted&&c===void 0)return await this.finishCancelledTurn(e);if(s.action===`done`)return{isError:s.isError,kind:`done`,output:s.output??``,usage:s.usage,usageDelta:s.usageDelta};if(s.action===`held`&&s.hold===`request`){if(s.hasPendingInputBatch&&this.input.capabilities?.requestInput!==!0&&!hasDelegatedCallerContext(this.input.cursor.serializedContext))throw Error(`This session cannot request human input, so it cannot wait for a tool approval or question. Configure unattended tools with an approval policy that does not require human input.`);let t=await this.waitForHeldRequest(e,s,u);if(t===`cancelled`)return await this.finishCancelledTurn(e);n={delivery:t};continue}if(s.action===`held`){if(await this.waitForHeldTurn(e)===`cancelled`)return await this.finishCancelledTurn(e);let t=await e.takeSteering();n=t===void 0?void 0:{delivery:t};continue}if(c!==void 0&&s.action===`park`){let t=s.hasRunsToDispatch===!1?[]:await this.dispatchRuns(),r=t.length===0?void 0:Date.now(),i=await this.waitForRuntimeActionResults({initialAcceptedAtMs:r,initialResults:t,taskToolCalls:s.pendingTaskToolCalls??[],pendingCallIds:c,turn:e});if(i===`cancelled`)return await this.finishCancelledTurn(e);n={delivery:await e.takeSteering(),runtimeResults:i};continue}if(s.action===`park`)return{kind:`park`,settled:s.settled};let f=await e.takeSteering();n=f===void 0?void 0:{delivery:f}}}async dispatchRuns(){let{cursor:e}=this.input,t=await e.advance(({serializedContext:e,sessionState:t})=>dispatchCoordinationStep({action:`park`,serializedContext:e,sessionState:t,workflowToolRunOwner:{inbox:sessionInboxHookToken(sessionCommandHookToken(this.input.sessionId))}}));return t.started.length>0&&await e.advance(e=>publishTaskStartedStep({...e,started:t.started})),t.results}async handleWorkflowMessage(e,t){if(isAppliedRunMessage(e)){let n=t?.takeAppliedRunMessages()??takeLeadingAppliedRunMessages(this.input.inbox);await this.applyRunMessages([e,...n],t);return}return await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:e})}async cancelTurnWork(){let{cursor:e}=this.input;mayWaitOnWorkflowToolRuns(e.sessionState)&&await cancelDescendantTurnsStep({serializedContext:e.serializedContext,sessionState:e.sessionState}),await cancelWorkingTasks(e,`turn_cancelled`)}async finishCancelledTurn(e){return await this.handleBoundaryMessages(e.takeBoundaryMessages(`agent-started`)),await this.cancelTurnWork(),{cancelled:!0,kind:`park`}}async waitForHeldTurn(e){let t=!1;for(;;){let n={interrupted:t,timedOut:!1};if(taskWaitResult(sessionTaskTable(this.input.cursor),n)!==void 0)return`woke`;let r=await e.nextRuntimeEvent([]);if(r===`cancelled`)return r;switch(r.kind){case`steering`:t=!0;continue;case`workflow`:await this.handleWorkflowMessage(r.message,e);continue;case`input`:case`runtime-action-result`:case`timeout`:continue}}}async waitForHeldRequest(e,t,n){let r=new Set(t.authorizationAttemptIds),i=new Set(t.inputRequestIds);for(;;){let t=this.input.queue.takeAuthorizations(r);if(t!==void 0)return{kind:`deliver`,payloads:t};let a=await e.takeInputResponses(i);if(a!==void 0)return a;let o=await e.takeSteering({heldSince:n});if(o!==void 0)return o;let s=await e.nextRuntimeEvent([]);if(s===`cancelled`)return s;s.kind===`workflow`&&await this.handleWorkflowMessage(s.message,e)}}async waitForRuntimeActionResults(e){let t=[...e.initialResults],n=!1,r=new Map,i=new Map;if(e.initialAcceptedAtMs!==void 0)for(let n of t)r.set(n.callId,e.initialAcceptedAtMs);let accept=e=>{t.push(e),r.set(e.callId,Date.now())},a=await this.answerTaskToolCalls(e.taskToolCalls,accept);try{for(;;){a=await this.resolveTaskWaits(a,n,accept);let o=resolveRuntimeActionResultsForCallIds({pendingCallIds:e.pendingCallIds,results:t});if(o!==void 0){let e=o.flatMap(e=>{let t=i.get(e.callId);return t===void 0?[]:[t]});return{acceptedAtMsByCallId:Object.fromEntries(o.map(e=>[e.callId,r.get(e.callId)])),...e.length>0&&{delegatedUsage:e},results:o}}let s=a.flatMap(e=>e.timer===void 0?[]:[e.timer]),c=await e.turn.nextRuntimeEvent(s);if(c===`cancelled`)return c;if(c.kind===`timeout`){for(let e of a)e.callId===c.callId&&(e.timedOut=!0);continue}if(c.kind===`input`)continue;if(c.kind===`steering`){n||await this.interruptWaitedWorkflowCalls(e.pendingCallIds,t),n=!0;continue}if(c.kind===`runtime-action-result`){let e=this.input.cursor.sessionState.snapshot.session.state,n=c.results.filter(t=>t.kind===`tool-result`&&isInboxToolResultFromRecordedWorkflowToolRun(e,t));if(n.length>0){let e=Date.now();t.push(...n);for(let t of n)r.set(t.callId,e)}continue}let l=await this.handleWorkflowMessage(c.message,e.turn);l!==void 0&&(accept(l),c.message.kind===`outcome`&&c.message.usage!==void 0&&i.set(l.callId,c.message.usage))}}finally{for(let e of a)await this.traceTaskWait(e,void 0,!0)}}async resolveTaskWaits(e,t,n){let r=sessionTaskTable(this.input.cursor),i=[];for(let a of e){let e=taskWaitResult(r,{interrupted:t,timedOut:a.timedOut});if(e===void 0){i.push(a);continue}let o=renderTaskWaitResult(e,Date.now()-a.startedAtMs);await this.traceTaskWait(a,o,t),n(taskToolResult(a.callId,TASK_WAIT_TOOL_NAME,o))}return i}async answerTaskToolCalls(e,t){let n=[],r=e.length===0?0:await startTaskToolCallsStep();for(let i of e)if(i.kind===TASK_WAIT_TOOL_NAME)n.push(startTaskWait(i,r));else{let e;try{e=await answerTaskCancel(this.input.cursor,i)}catch(e){throw await this.input.cursor.advance(e=>traceTaskToolCallStep(e,{callId:i.callId,toolName:i.kind,startedAtMs:r,completedAtMs:Date.now(),input:{taskId:i.taskId},failed:!0})),e}await this.input.cursor.advance(t=>traceTaskToolCallStep(t,{callId:i.callId,toolName:i.kind,startedAtMs:r,completedAtMs:Date.now(),input:{taskId:i.taskId},output:e.output})),t(e)}let i=await this.resolveTaskWaits(n,!1,t);return i.length>0&&await this.input.cursor.advance(publishTurnWaitingStep),i}async traceTaskWait(e,t,n=!1){await this.input.cursor.advance(r=>traceTaskToolCallStep(r,{callId:e.callId,toolName:TASK_WAIT_TOOL_NAME,startedAtMs:e.startedAtMs,completedAtMs:Date.now(),input:e.input,output:t,failed:n}))}async interruptWaitedWorkflowCalls(e,t){let n=this.input.cursor.sessionState.snapshot.session.state,r=new Set(t.map(e=>e.callId)),i=e.filter(e=>!r.has(e)).flatMap(e=>{let t=findBlockingWorkflowToolRun(n,e);return t===void 0?[]:[t.address]});await Promise.all(i.map(e=>interruptWorkflowToolRun(e)))}};function startTaskWait(e,t){let{callId:n,timeoutMs:r}=e,i=r===void 0?void 0:sleep(r).then(()=>n);return{callId:n,startedAtMs:t,input:r===void 0?{}:{timeoutSeconds:r/1e3},timedOut:r===0,timer:i}}function mayWaitOnWorkflowToolRuns(e){try{return getBlockingWorkflowToolRuns(e.snapshot?.session?.state).length>0}catch{return!0}}export{SessionExecution,hasDelegatedCallerContext};
+import{sessionCommandHookToken,sessionInboxHookToken}from"#execution/session-inbox/address.js";import{TASK_WAIT_TOOL_NAME}from"#protocol/task-tools.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME}from"#context/key-names.js";import{renderTaskWaitResult}from"#execution/tasks/render.js";import{formatEarlierRemoteCallerInputError}from"#protocol/remote-agent-protocol.js";import{sleep}from"#compiled/@workflow/core/index.js";import{taskWaitResult}from"#execution/tasks/table.js";import{controlDeliveryOf}from"#execution/session/control-delivery.js";import{isAgentSessionMessage}from"#execution/tools/workflow/messages.js";import{handleWorkflowToolRunMessage,isAppliedRunMessage,takeLeadingAppliedRunMessages}from"#execution/session-workflow-tool-run.js";import{exhaustedStepError,normalizeSerializableError}from"#execution/workflow-errors.js";import{findBlockingWorkflowToolRun,isInboxToolResultFromRecordedWorkflowToolRun}from"#harness/workflow-tool-runs.js";import{resolveTurnPrincipal}from"#execution/session/principal.js";import{answerTaskCancel,cancelWorkingTasks,sessionTaskTable}from"#execution/tasks/session.js";import{dispatchCoordinationStep,publishDispatchedCallsStep}from"#execution/coordination-dispatch-step.js";import{taskToolResult}from"#execution/tasks/calls.js";import{applyRunMessagesStep}from"#execution/tools/workflow/apply-run-messages-step.js";import{interruptWorkflowToolRun}from"#execution/tools/workflow/interrupt.js";import{turnStep}from"#execution/session/turn-step.js";import{ActiveTurn}from"#execution/session/active-turn.js";import{resolveRuntimeActionResultsForCallIds}from"#runtime/actions/results.js";import{startTaskToolCallsStep}from"#execution/session/task-tool-tracing-step.js";function hasDelegatedCallerContext(e){if(earlierRemoteCaller(e)!==void 0)return!1;if(e[`eve.sessionCallback`]!==void 0)return!0;let t=e[`eve.channel`];return typeof t==`object`&&!!t&&Reflect.get(t,`kind`)===`subagent`}function earlierRemoteCaller(e){let t=e[EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME];return typeof t==`number`?t:void 0}var SessionExecution=class{input;observedHandoverAttemptKey;constructor(e){this.input=e}get cursor(){return this.input.cursor}async runTurn(e,t={}){let n=new ActiveTurn(this.input,{caller:t.caller,control:e?.control!==void 0,principal:resolveTurnPrincipal(e,this.input.cursor.serializedContext)},t.control);try{let t=await this.runTurnSteps(n,e);return await this.handleBoundaryMessages(n.takeBoundaryMessages(),t.kind===`done`),t.kind===`park`&&t.settled!==void 0&&await cancelWorkingTasks(this.input.cursor,`turn-ended`),{...t,...n.caller!==void 0&&{caller:n.caller},...n.compacted&&{compacted:!0}}}finally{n.dispose()}}async handleBoundaryMessages(e,t=!1,n){let r=[];for(let i of e)isAppliedRunMessage(i)?(!t||!isAgentSessionMessage(i))&&r.push(i):(await this.applyRunMessages(r,n),r=[],await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:i}));await this.applyRunMessages(r,n)}async applyRunMessages(e,t){if(e.length===0)return;let{cancelled:n}=await this.input.cursor.advance(n=>applyRunMessagesStep({...n,canCancelTurn:t!==void 0,messages:e}));n&&t?.abort()}async runTurnSteps(e,t){let n=t,r=e.caller;for(;;){let{cursor:t}=this.input,i=r;r=void 0;let a=this.input.inbox.handoverObservation,o=a?.attemptKey===this.observedHandoverAttemptKey?void 0:a,s=await t.advanceWithHistory(t=>{let run=r=>turnStep({...t,handover:o,abortSignal:e.signal,caller:i,input:n,recover:r,steeringSignal:e.steeringSignal});return run().catch(e=>run({error:normalizeSerializableError(exhaustedStepError(e))}))});o!==void 0&&(this.observedHandoverAttemptKey=o.attemptKey),s.compacted===!0&&(e.compacted=!0);let c=this.input.queue.nextAdmission,l=s.action===`parked`&&s.settled!==void 0;await e.admitBoundary(l);let u=s.action===`done`;if(await this.handleBoundaryMessages(e.takeBoundaryMessages(),u,u?void 0:e),s.action===`cancelled`)return await this.finishCancelledTurn(e);let d=s.action===`paused`&&s.on===`calls`;if(!l&&!d&&e.signal.aborted)return await this.finishCancelledTurn(e);switch(s.action){case`done`:return{isError:s.isError,kind:`done`,output:s.output??``,usage:s.usage,usageDelta:s.usageDelta};case`parked`:return{kind:`park`,settled:s.settled};case`paused`:{let t=await this.resume(e,s,c);if(t===`cancelled`)return await this.finishCancelledTurn(e);n=t;continue}case`continue`:n=await this.withSteering(e,{});continue}}}async withSteering(e,t){let n=await e.takeSteering();if(n!==void 0||t.runtimeResults!==void 0)return{...t,...n!==void 0&&{delivery:n}}}async resume(e,t,n){let r=earlierRemoteCaller(this.input.cursor.serializedContext);if(t.on===`interaction`&&r!==void 0)throw Error(formatEarlierRemoteCallerInputError(r));if(t.on===`interaction`&&t.requestIds.length>0&&this.input.capabilities?.requestInput!==!0&&!hasDelegatedCallerContext(this.input.cursor.serializedContext))throw Error(`This session cannot request human input, so it cannot wait for a tool approval or question. Configure unattended tools with an approval policy that does not require human input.`);let i=t.on===`interaction`?{attemptIds:new Set(t.attemptIds),requestIds:new Set(t.requestIds)}:void 0,a=t.on===`calls`?await this.startCallWait(t):void 0,o=!1;for(;;){if(i!==void 0){let t=this.input.queue.takeAuthorizations(i.attemptIds);if(t!==void 0)return{delivery:{kind:`deliver`,payloads:t}};let r=await e.takeAnswers(i.requestIds);if(r!==void 0)return{delivery:r};let a=await e.takeSteering({heldSince:n});if(a!==void 0)return{delivery:a}}if(t.on===`tasks`&&taskWaitResult(sessionTaskTable(this.input.cursor),{interrupted:o,timedOut:!1})!==void 0)return await this.withSteering(e,{});let r=await a?.ready(o);if(r!==void 0)return await this.withSteering(e,{runtimeResults:r});let s=await e.nextRuntimeEvent(a?.timers()??[]);if(s===`cancelled`)return s;switch(s.kind){case`steering`:o||await a?.interrupt(),o=!0;continue;case`timeout`:a?.timedOut(s.callId);continue;case`runtime-action-result`:a?.acceptInbox(s.results);continue;case`workflow`:{let t=await this.handleWorkflowMessage(s.message,e);t!==void 0&&a?.acceptRun(t,s.message);continue}case`input`:continue}}}async startCallWait(e){let t=e.dispatch?await this.dispatchRuns():[],n=new CallWait(this.input.cursor,e.callIds,t);return await n.answerTaskToolCalls(e.taskToolCalls),n}async dispatchRuns(){let{cursor:e}=this.input,t=await e.advance(({serializedContext:e,sessionState:t})=>dispatchCoordinationStep({serializedContext:e,sessionState:t,workflowToolRunOwner:{inbox:sessionInboxHookToken(sessionCommandHookToken(this.input.sessionId))}})),{executing:n,refused:r,started:i}=t.pending;return(n.length>0||i.length>0||r.length>0)&&await e.advance(e=>publishDispatchedCallsStep({...e,pending:t.pending})),t.results}async handleWorkflowMessage(e,t){if(isAppliedRunMessage(e)){let n=t?.takeAppliedRunMessages()??takeLeadingAppliedRunMessages(this.input.inbox);await this.applyRunMessages([e,...n],t);return}return await handleWorkflowToolRunMessage({cursor:this.input.cursor,message:e})}async cancelTurnWork(){await cancelWorkingTasks(this.input.cursor,`turn-cancelled`,{turnCalls:!0})}async finishCancelledTurn(e){await this.handleBoundaryMessages(e.takeBoundaryMessages(isAgentSessionMessage)),await this.cancelTurnWork();let t=e.cancelledBy;return t===void 0?{cancelled:!0,kind:`park`}:{cancelled:!0,cancelledBy:controlDeliveryOf(t),kind:`park`}}},CallWait=class{cursor;callIds;results=[];acceptedAtMs=new Map;delegatedUsage=new Map;taskWaits=[];constructor(e,t,n){this.cursor=e,this.callIds=t;let r=Date.now();for(let e of n)this.accept(e,r)}async ready(e){this.taskWaits=await this.resolveTaskWaits(e);let t=resolveRuntimeActionResultsForCallIds({pendingCallIds:this.callIds,results:this.results});if(t===void 0)return;let n=t.flatMap(e=>{let t=this.delegatedUsage.get(e.callId);return t===void 0?[]:[[e.callId,t]]});return{acceptedAtMsByCallId:Object.fromEntries(t.map(e=>[e.callId,this.acceptedAtMs.get(e.callId)])),...n.length>0&&{delegatedUsage:Object.fromEntries(n)},results:t}}timers(){return this.taskWaits.flatMap(e=>e.timer===void 0?[]:[e.timer])}timedOut(e){for(let t of this.taskWaits)t.callId===e&&(t.timedOut=!0)}acceptInbox(e){let t=this.cursor.sessionState.snapshot.session.state,n=Date.now();for(let r of e)r.kind===`tool-result`&&isInboxToolResultFromRecordedWorkflowToolRun(t,r)&&this.accept(r,n)}acceptRun(e,t){this.accept(e),t.kind===`outcome`&&t.usage!==void 0&&this.delegatedUsage.set(e.callId,t.usage)}async interrupt(){let e=this.cursor.sessionState.snapshot.session.state,t=this.callIds.flatMap(t=>{if(this.acceptedAtMs.has(t))return[];let n=findBlockingWorkflowToolRun(e,t);return n===void 0?[]:[n.address]});await Promise.all(t.map(e=>interruptWorkflowToolRun(e)))}async answerTaskToolCalls(e){let t=[],n=e.length===0?0:await startTaskToolCallsStep();for(let r of e){if(r.kind===TASK_WAIT_TOOL_NAME){t.push(startTaskWait(r,n));continue}this.accept(await answerTaskCancel(this.cursor,r))}this.taskWaits=t,this.taskWaits=await this.resolveTaskWaits(!1)}accept(e,t=Date.now()){this.results.push(e),this.acceptedAtMs.set(e.callId,t)}async resolveTaskWaits(e){let t=sessionTaskTable(this.cursor),n=[];for(let r of this.taskWaits){let i=taskWaitResult(t,{interrupted:e,timedOut:r.timedOut});if(i===void 0){n.push(r);continue}let a=renderTaskWaitResult(i,Date.now()-r.startedAtMs);this.accept(taskToolResult(r.callId,TASK_WAIT_TOOL_NAME,a))}return n}};function startTaskWait(e,t){let{callId:n,timeoutMs:r}=e,i=r===void 0?void 0:sleep(r).then(()=>n);return{callId:n,startedAtMs:t,timedOut:r===0,timer:i}}export{SessionExecution,hasDelegatedCallerContext};

package/dist/src/execution/session-callback-request.d.ts

@@ -1,4 +1,10 @@
-/** Posts one framework callback payload with the shared callback transport policy. */
+/**
+ * Posts one framework callback payload with the shared callback transport policy.
+ *
+ * Callback URLs are caller-supplied, so delivery only connects to public
+ * addresses (loopback is also allowed on local development servers), checked
+ * against every resolved address at connect time.
+ */
 export declare function postSessionCallbackRequest(input: {
     readonly body: unknown;
     /** Set false when the caller owns failure logging, such as best-effort activity. */

package/dist/src/execution/session-callback-request.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";const log=createLogger(`execution.session-callback`),VERCEL_CALLBACK_HOST_ENVS=[`VERCEL_URL`,`VERCEL_BRANCH_URL`,`VERCEL_PROJECT_PRODUCTION_URL`],VERCEL_REQUEST_CONTEXT=Symbol.for(`@vercel/request-context`);async function postSessionCallbackRequest(e){let t=e.timeoutMs??3e4,n=AbortSignal.timeout(t),r;try{r=await fetch(e.url,{body:JSON.stringify(e.body),headers:await resolveSessionCallbackHeaders(e.url),method:`POST`,redirect:`error`,signal:n})}catch(r){throw e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:n.aborted?`timeout`:`transport`,timeoutMs:t,error:Error(`Callback request failed before receiving a response.`)}),r}return!r.ok&&e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`http`,statusCode:r.status,error:Error(`Callback request failed with HTTP ${r.status}.`)}),r}function callbackLogFields(e){let t=URL.parse(e.url),n=t?.pathname.match(/^(.*?\/(?:callback|activity))\//)?.[1],r={callbackOrigin:t?.origin,callbackPath:n===void 0?`[redacted]`:`${n}/[redacted]`};if(isObject(e.body)){for(let t of[`kind`,`callId`,`sessionId`,`childSessionId`,`subagentName`,`updateEpoch`])typeof e.body[t]==`string`&&(r[t]=e.body[t]);typeof e.body.updateIndex==`number`&&(r.updateIndex=e.body.updateIndex)}return r}async function resolveSessionCallbackHeaders(e){let t={"content-type":`application/json`};if(process.env.VERCEL!==`1`)return t;let n;try{n=new URL(e)}catch{return t}let r=VERCEL_CALLBACK_HOST_ENVS.some(e=>process.env[e]?.trim().toLowerCase()===n.hostname.toLowerCase());if(n.protocol!==`https:`||!r)return t;let i=readAmbientVercelOidcToken();return i!==void 0&&(t[`x-vercel-trusted-oidc-idp-token`]=i),t}function readAmbientVercelOidcToken(){let e=(globalThis[VERCEL_REQUEST_CONTEXT]?.get?.().headers?.[`x-vercel-oidc-token`]??process.env.VERCEL_OIDC_TOKEN)?.trim();return e===``?void 0:e}export{postSessionCallbackRequest};
+import{createLogger}from"#internal/logging.js";import{isObject}from"#shared/guards.js";import{isLocalDevelopmentServer}from"#internal/application/dev-environment.js";import{FatalError}from"#compiled/@workflow/core/index.js";import{UnsafeDestinationError,assertPublicHostname,createPublicDispatcher,fetchWithDispatcher,findUnsafeDestinationError,readBoundedResponse}from"#execution/public-destination.js";const log=createLogger(`execution.session-callback`),VERCEL_CALLBACK_HOST_ENVS=[`VERCEL_URL`,`VERCEL_BRANCH_URL`,`VERCEL_PROJECT_PRODUCTION_URL`],VERCEL_REQUEST_CONTEXT=Symbol.for(`@vercel/request-context`);async function postSessionCallbackRequest(e){let t=e.timeoutMs??3e4,n=AbortSignal.timeout(t),r;try{r=await requestCallback(e.url,{body:JSON.stringify(e.body),headers:await resolveSessionCallbackHeaders(e.url),signal:n})}catch(r){let i=findUnsafeDestinationError(r);throw i===void 0?(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:n.aborted?`timeout`:`transport`,timeoutMs:t,error:Error(`Callback request failed before receiving a response.`)}),r):(e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`blocked-destination`,error:Error(i.message)}),new FatalError(`Callback delivery refused: ${i.message}`))}return!r.ok&&e.logFailures!==!1&&log.error(`callback delivery failed`,{...callbackLogFields(e),failure:`http`,statusCode:r.status,error:Error(`Callback request failed with HTTP ${r.status}.`)}),r}async function requestCallback(e,t){let n=new URL(e);if(n.protocol!==`http:`&&n.protocol!==`https:`)throw new UnsafeDestinationError(`Callback URL must use http or https.`);let r={allowLoopback:isLocalDevelopmentServer()};assertPublicHostname(n.hostname,r);let i=await createPublicDispatcher(r);try{let n=await fetchWithDispatcher(e,{...t,dispatcher:i,method:`POST`,redirect:`error`});return await readBoundedResponse(n,65536)}finally{await i.close()}}function callbackLogFields(e){let t=URL.parse(e.url),n=t?.pathname.match(/^(.*?\/(?:callback|activity))\//)?.[1],r={callbackOrigin:t?.origin,callbackPath:n===void 0?`[redacted]`:`${n}/[redacted]`};if(isObject(e.body)){for(let t of[`kind`,`callId`,`sessionId`,`childSessionId`,`subagentName`,`updateEpoch`])typeof e.body[t]==`string`&&(r[t]=e.body[t]);typeof e.body.updateIndex==`number`&&(r.updateIndex=e.body.updateIndex)}return r}async function resolveSessionCallbackHeaders(e){let t={"content-type":`application/json`};if(process.env.VERCEL!==`1`)return t;let n;try{n=new URL(e)}catch{return t}let r=VERCEL_CALLBACK_HOST_ENVS.some(e=>process.env[e]?.trim().toLowerCase()===n.hostname.toLowerCase());if(n.protocol!==`https:`||!r)return t;let i=readAmbientVercelOidcToken();return i!==void 0&&(t[`x-vercel-trusted-oidc-idp-token`]=i),t}function readAmbientVercelOidcToken(){let e=(globalThis[VERCEL_REQUEST_CONTEXT]?.get?.().headers?.[`x-vercel-oidc-token`]??process.env.VERCEL_OIDC_TOKEN)?.trim();return e===``?void 0:e}export{postSessionCallbackRequest};

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

@@ -1,13 +1,14 @@
-import type { MessageStreamEvent } from "#protocol/message.js";
+import type { SessionStreamEvent } from "#protocol/session-event.js";
+import { type StoredLine } from "#protocol/session-events/envelope.js";
 /** Options for {@link streamSessionEvents}. */
 export interface SessionEventStreamOptions {
     /**
-     * Zero-based index of the first event to read. Negative values count back
-     * from the durable tail (`-1` is the latest event). Defaults to `0`.
+     * Position of the first line to read. Negative values count back from the
+     * durable tail (`-1` is the latest line). Defaults to `0`.
      */
     readonly startIndex?: number;
     /**
-     * Whether to keep following events recorded after the read opens. When
+     * Whether to keep following lines recorded after the read opens. When
      * `false`, the read ends at the durable tail observed when it opens.
      * Defaults to `true`.
      */
@@ -15,18 +16,35 @@ export interface SessionEventStreamOptions {
     /** Stops the read and releases the underlying stream reader. */
     readonly signal?: AbortSignal;
 }
+/** One stored line and its position. A line this version can't read has `line: undefined`. */
+export interface PositionedLine {
+    readonly position: number;
+    readonly line: StoredLine | undefined;
+    /** The line as stored, parsed. */
+    readonly record: unknown;
+}
+/**
+ * Reads one session's stored records from `startIndex`, one per line, as parsed JSON. Negative
+ * `startIndex` values count back from the tail. Callers count positions: one per record.
+ */
+export declare function readSessionRecords(sessionId: string, startIndex?: number): ReadableStream<unknown>;
 /**
- * Reads one session's durable event stream. Negative `startIndex` values count
- * back from the tail.
+ * Reads one session's events, following new lines as they're written. Records of types this
+ * version doesn't know, including a pre-v27 session's, are skipped.
  */
-export declare function readSessionEventStream(sessionId: string, startIndex?: number): ReadableStream<MessageStreamEvent>;
+export declare function readSessionEventStream(sessionId: string, startIndex?: number, signal?: AbortSignal): ReadableStream<SessionStreamEvent>;
 /**
  * Reads one session's recorded events up to the durable tail observed when
  * the read opens, then ends. Negative `startIndex` values count back from
  * that tail.
  */
-export declare function readSessionEventHistory(sessionId: string, startIndex?: number): ReadableStream<MessageStreamEvent>;
-/** Returns the index of the last durably recorded event, or `-1` before the first. */
+export declare function readSessionEventHistory(sessionId: string, startIndex?: number, signal?: AbortSignal): ReadableStream<SessionStreamEvent>;
+/**
+ * Reads one session's stored records up to the durable tail observed when the read opens, then
+ * ends. Negative `startIndex` values count back from that tail.
+ */
+export declare function readSessionRecordHistory(sessionId: string, startIndex?: number): ReadableStream<unknown>;
+/** Returns the position of the last durably recorded line, or `-1` before the first. */
 export declare function readSessionStreamTailIndex(sessionId: string): Promise<number>;
 /**
  * Throws when the session's run does not exist or its recorded history has
@@ -35,11 +53,14 @@ export declare function readSessionStreamTailIndex(sessionId: string): Promise<n
  */
 export declare function assertSessionHistoryReadable(sessionId: string): Promise<void>;
 /**
- * Iterates one session's durable events in process, without the HTTP stream
- * route.
- *
- * A bounded read counts events up from `startIndex` to find the tail. That
- * holds because the writer persists exactly one chunk per event (see
- * `createOrderedStreamEmitter`).
+ * Iterates one session's stored lines in process, without the HTTP stream route, with each
+ * line's position. A bounded read stops at the tail it observed when it opened: the writer
+ * stores one chunk per line, so positions are chunk indexes.
+ */
+export declare function streamSessionLines(sessionId: string, options?: SessionEventStreamOptions): AsyncGenerator<PositionedLine, void, undefined>;
+/**
+ * Iterates one session's events in process, from the lines {@link streamSessionLines} reads.
+ * A session an eve before v27 recorded reads as the v27 commits its v26 lines record; see
+ * `#execution/v26-history.js`.
  */
-export declare function streamSessionEvents(sessionId: string, options?: SessionEventStreamOptions): AsyncGenerator<MessageStreamEvent, void, undefined>;
+export declare function streamSessionEvents(sessionId: string, options?: SessionEventStreamOptions): AsyncGenerator<SessionStreamEvent, void, undefined>;