eve 0.55.0 → 0.57.0

package/dist/src/execution/durable-session-migrations/turn-workflow.js

@@ -1 +0,0 @@
-import{runMigrationChain}from"./chain.js";import{turnWorkflowInputV0ToV1}from"./turn-workflow-v0-to-v1.js";import{turnWorkflowInputV1ToV2}from"./turn-workflow-v1-to-v2.js";const TURN_WORKFLOW_INPUT_VERSION=2,turnWorkflowInputMigrations=[turnWorkflowInputV0ToV1,turnWorkflowInputV1ToV2];function createTurnWorkflowInput(e){return{capabilities:e.capabilities,completionToken:e.completionToken,driverCapabilities:{cancelledTurnSettle:!0,turnInbox:!0},initialCancellation:e.initialCancellation,initialStep:e.initialStep,mode:e.mode,stepInput:{input:e.delivery,parentWritable:e.parentWritable,serializedContext:e.serializedContext,sessionState:e.sessionState},version:2}}function migrateTurnWorkflowInput(e){return runMigrationChain({initialVersion:0,label:`turn workflow input`,migrations:turnWorkflowInputMigrations,targetVersion:2,value:e})}export{TURN_WORKFLOW_INPUT_VERSION,createTurnWorkflowInput,migrateTurnWorkflowInput};

package/dist/src/execution/forward-turn-cancellation-step.d.ts

@@ -1,6 +0,0 @@
-import type { TurnCancelPayload } from "#execution/turn-cancellation-token.js";
-/** Forwards an inbox cancellation command to one private active-turn hook. */
-export declare function forwardTurnCancellationStep(input: {
-    readonly payload: TurnCancelPayload;
-    readonly token: string;
-}): Promise<boolean>;

package/dist/src/execution/forward-turn-cancellation-step.js

@@ -1 +0,0 @@
-import{resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";async function forwardTurnCancellationStep(e){"use step";for(let t=0;t<50;t+=1)try{return await resumeHook(e.token,e.payload),!0}catch(e){if(!HookNotFoundError.is(e))throw e;if(t===49)return!1;await new Promise(e=>setTimeout(e,20))}return!1}export{forwardTurnCancellationStep};

package/dist/src/execution/forward-turn-delivery-step.d.ts

@@ -1,6 +0,0 @@
-import type { TurnInboxPayload } from "#execution/turn-control-protocol.js";
-/** Forwards one accepted public delivery to the private inbox of its requesting turn. */
-export declare function forwardTurnDeliveryStep(input: {
-    readonly inboxToken: string;
-    readonly payload: TurnInboxPayload;
-}): Promise<void>;

package/dist/src/execution/forward-turn-delivery-step.js

@@ -1 +0,0 @@
-import{resumeHook}from"#internal/workflow/runtime.js";async function forwardTurnDeliveryStep(e){"use step";await resumeHook(e.inboxToken,e.payload)}export{forwardTurnDeliveryStep};

package/dist/src/execution/inline-turn.d.ts

@@ -1,31 +0,0 @@
-import type { DeliverHookPayload, HookPayload, SessionCapabilities } from "#channel/types.js";
-import type { InitialTurnStep } from "#execution/durable-session-migrations/turn-workflow.js";
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-import type { NextDriverAction } from "#execution/next-driver-action.js";
-import type { SessionCommandInbox } from "#execution/session-command-inbox.js";
-import { SessionStateCursor } from "#execution/session-state-cursor.js";
-import type { TurnCancelPayload } from "#execution/turn-cancellation-token.js";
-import type { RunMode } from "#shared/run-mode.js";
-export type InlineTurnOutcome = {
-    readonly initialCancellation?: TurnCancelPayload;
-    readonly initialStep?: InitialTurnStep;
-    readonly kind: "child" | "continue";
-} | {
-    readonly action: NextDriverAction;
-    readonly kind: "result";
-};
-/** Runs same-deployment steps directly until they need the shared turn runner. */
-export declare function runInlineTurn(input: {
-    readonly bufferedDeliveries: DeliverHookPayload[];
-    readonly bufferedSessionControls: Array<"clear" | "compact" | "expired" | "reset">;
-    readonly cancelledTaskIds?: Set<string>;
-    readonly capabilities?: SessionCapabilities;
-    readonly commandInbox: SessionCommandInbox;
-    readonly delivery: HookPayload;
-    readonly mode: RunMode;
-    readonly parentWritable: WritableStream<Uint8Array>;
-    readonly seenTaskDeliveries?: Set<string>;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-    readonly stateCursor?: SessionStateCursor;
-}): Promise<InlineTurnOutcome>;

package/dist/src/execution/inline-turn.js

@@ -1 +0,0 @@
-import{activeTurnId}from"#harness/active-turn-id.js";import{readAcceptedDeploymentId}from"#execution/accepted-delivery-deployment.js";import{cancelAllIndexedSessionTasksStep}from"#execution/cancel-indexed-session-tasks-step.js";import{reportDroppedWirePayloadStep}from"#execution/report-dropped-wire-payload-step.js";import{SessionStateCursor}from"#execution/session-state-cursor.js";import{SessionInboxWireError,sessionInboxWire}from"#execution/wire/session-inbox-wire.js";import{turnStep}from"#execution/workflow-steps.js";import{TurnCancelledError}from"#harness/turn-cancellation.js";async function runInlineTurn(e){let t=readAcceptedDeploymentId(e.delivery);if(t===void 0)return{kind:`child`};let n=e.stateCursor??new SessionStateCursor({serializedContext:e.serializedContext,sessionState:e.sessionState}),r=new InlineTurnControl({bufferedDeliveries:e.bufferedDeliveries,bufferedSessionControls:e.bufferedSessionControls,cancelledTaskIds:e.cancelledTaskIds,commandInbox:e.commandInbox,expectedTurnId:activeTurnId(e.sessionState.emissionState),seenTaskDeliveries:e.seenTaskDeliveries,stateCursor:n}),i=e.delivery;for(;;){let a={serializedContext:n.serializedContext,sessionState:n.sessionState},o=await r.waitForStep(turnStep({abortSignal:r.signal,acceptedDeploymentId:t,input:i,parentWritable:e.parentWritable,serializedContext:n.serializedContext,sessionState:n.sessionState}));if(o.requiresChildDispatch===!0)return{initialCancellation:r.initialCancellation,kind:`child`};let s={beforeStep:a,result:o};if(r.initialCancellation!==void 0||o.action===`cancelled`||(o.backgroundTasks?.length??0)>0)return continueOutcome(r,s);if(o.action===`done`)return{action:{isError:o.isError,kind:`done`,output:o.output??``,serializedContext:o.serializedContext,sessionState:o.sessionState,usage:o.usage,usageDelta:o.usageDelta},kind:`result`};if(o.action===`dispatch-workflow-tasks`||o.action===`park`&&o.pendingCoordinationCallIds!==void 0)return continueOutcome(r,s);if(o.action===`park`)return o.hasPendingAuthorization||o.hasPendingInputBatch&&e.capabilities?.requestInput===!0||e.mode===`conversation`?{action:{authorizationAttemptIds:o.authorizationAttemptIds,authorizationNames:o.authorizationNames,kind:`park`,serializedContext:o.serializedContext,sessionState:o.sessionState,settled:o.settled},kind:`result`}:continueOutcome(r,s);let c=n.sessionState.continuationToken;n.adoptState(o),n.sessionState.continuationToken!==``&&n.sessionState.continuationToken!==c&&await e.commandInbox.rekeyContinuation(n.sessionState.continuationToken),i=void 0}}function continueOutcome(e,t){return{initialCancellation:e.initialCancellation,initialStep:t,kind:`continue`}}var InlineTurnControl=class{bufferedDeliveries;bufferedSessionControls;cancelledTaskIds;commandInbox;controller=new AbortController;expectedTurnId;seenTaskDeliveries;stateCursor;cancellation;constructor(e){this.bufferedDeliveries=e.bufferedDeliveries,this.bufferedSessionControls=e.bufferedSessionControls,this.cancelledTaskIds=e.cancelledTaskIds??new Set,this.commandInbox=e.commandInbox,this.expectedTurnId=e.expectedTurnId,this.seenTaskDeliveries=e.seenTaskDeliveries??new Set,this.stateCursor=e.stateCursor}get initialCancellation(){return this.cancellation}get signal(){return this.controller.signal}async waitForStep(e){let t=e.then(e=>({kind:`step`,result:e}));for(;;){let e=await Promise.race([t,this.commandInbox.next().then(e=>({kind:`command`,result:e}))]);if(e.kind===`step`)return e.result;if(e.result.done)throw Error(`Session command inbox closed before the inline turn step settled.`);this.commandInbox.consumeNext(),await this.handle(e.result.value)}}abort(e){this.controller.signal.aborted||(this.cancellation=e,this.controller.abort(new TurnCancelledError))}acceptTaskDelivery(e){let t=e.taskDeliveryId??e.caller?.taskId;return t===void 0?!0:this.originatesFromCancelledTask(t)||this.seenTaskDeliveries.has(t)?!1:(this.seenTaskDeliveries.add(t),!0)}async handle(e){if(e.kind===`runtime-action-result`)return;let t;try{t=sessionInboxWire.decode(e)}catch(e){if(!(e instanceof SessionInboxWireError))throw e;await reportDroppedWirePayloadStep({detail:e.message,family:`session-inbox`});return}if(t.kind===`deliver`){if(!this.acceptTaskDelivery(t))return;this.bufferedDeliveries.push(t),t.turnPolicy===`steer`&&deliveryHasMessage(t)&&this.abort({});return}if(t.kind===`clear`||t.kind===`compact`){this.bufferedSessionControls.push(t.kind);return}if(t.kind===`session-timeout`){this.bufferedSessionControls.push(`expired`);return}if(t.kind===`reset`){this.bufferedSessionControls.push(`reset`),this.abort({});return}if(t.kind===`cancel`){`tasks`in t&&t.tasks===!0&&await cancelAllIndexedSessionTasksStep({serializedContext:this.stateCursor.serializedContext,sessionState:this.stateCursor.sessionState}),t.taskId!==void 0&&this.discardTaskDeliveries(t.taskId);let e=t.taskId!==void 0&&t.turnId!==void 0&&t.turnId!==this.expectedTurnId?void 0:t.turnId;if(e===void 0||e===this.expectedTurnId){let n=e===void 0?{tasks:t.tasks}:{tasks:t.tasks,turnId:e};this.abort(n)}}}discardTaskDeliveries(e){this.cancelledTaskIds.add(e);let t=this.bufferedDeliveries.filter(e=>!this.shouldDiscard(e));this.bufferedDeliveries.splice(0,this.bufferedDeliveries.length,...t)}originatesFromCancelledTask(e){return[...this.cancelledTaskIds].some(t=>e===t||e.startsWith(`${t}:`))}shouldDiscard(e){let t=e.taskDeliveryId??e.caller?.taskId;return t!==void 0&&this.originatesFromCancelledTask(t)}};function deliveryHasMessage(e){return e.payloads.some(e=>e.message!==void 0)}export{runInlineTurn};

package/dist/src/execution/next-driver-action.d.ts

@@ -1,93 +0,0 @@
-/**
- * Closed-contract dispatch surface between session-mutating step bodies
- * (the accepting deployment when stamped, otherwise the driver's deployment)
- * and the durable driver workflow (pinned to whichever deployment called
- * `start()`).
- *
- * The driver matches on `kind` and follows a fixed playbook per arm.
- * Adding a new arm is breaking (pinned drivers can't dispatch an
- * unknown `kind`); adding optional fields inside an existing arm is
- * forward-compatible because the driver passes the action through by
- * reference and devalue preserves unknown POJO fields. Do not
- * destructure-and-rebuild a `NextDriverAction` — full destructuring
- * strips unknown fields.
- */
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-import type { SettledTurn, StepResult } from "#harness/types.js";
-import type { TokenUsage } from "#shared/token-usage.js";
-interface DurableStepResultFields {
-    /** Pre-step context plus only the observability continuation owned by background tasks. */
-    readonly backgroundTaskContext?: Record<string, unknown>;
-    readonly backgroundTaskState?: DurableSessionState;
-    readonly backgroundTasks?: StepResult["backgroundTasks"];
-    /** The guarded inline step deferred before mutating state. */
-    readonly requiresChildDispatch?: true;
-    readonly serializedContext: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}
-/** Result returned by a turn step to its durable driver workflow. */
-export type DurableStepResult = ({
-    readonly action: "continue" | "done";
-    readonly output?: unknown;
-    readonly isError?: boolean;
-    readonly usage?: TokenUsage;
-    readonly usageDelta?: TokenUsage;
-} | {
-    readonly action: "cancelled";
-} | {
-    readonly action: "park";
-    readonly authorizationAttemptIds?: readonly string[];
-    readonly authorizationNames?: readonly string[];
-    readonly hasPendingAuthorization: boolean;
-    readonly hasPendingInputBatch: boolean;
-    readonly pendingCoordinationCallIds?: readonly string[];
-    readonly settled?: SettledTurn;
-} | {
-    readonly action: "dispatch-workflow-tasks";
-    readonly pendingTaskCallIds: readonly string[];
-}) & DurableStepResultFields;
-/** Discriminated union the driver workflow body dispatches on. */
-export type NextDriverAction = {
-    readonly kind: "done";
-    readonly output: unknown;
-    readonly isError?: boolean;
-    readonly sessionState: DurableSessionState;
-    readonly serializedContext: Record<string, unknown>;
-    /** Session-total token usage spent by the completed session. */
-    readonly usage?: TokenUsage;
-    /**
-     * Usage the final turn added beyond what earlier settled turns already
-     * reported; forwarded through the same pinned-driver-safe
-     * optional-field pattern as `cancelled`.
-     */
-    readonly usageDelta?: TokenUsage;
-} | {
-    readonly kind: "park";
-    readonly sessionState: DurableSessionState;
-    readonly serializedContext: Record<string, unknown>;
-    readonly authorizationAttemptIds?: readonly string[];
-    readonly authorizationNames?: readonly string[];
-    /**
-     * Set when the parked turn was cancelled: the driver runs
-     * `settleCancelledTurnStep` before the normal park playbook. An
-     * optional field rather than a new arm so pinned drivers keep
-     * working.
-     */
-    readonly cancelled?: true;
-    /**
-     * Settled user-facing answer forwarded through the same pinned-driver-safe
-     * optional-field pattern as `cancelled`.
-     */
-    readonly settled?: SettledTurn;
-} | {
-    readonly kind: "dispatch-coordination";
-    readonly pendingCallIds: readonly string[];
-    readonly sessionState: DurableSessionState;
-    readonly serializedContext: Record<string, unknown>;
-} | {
-    readonly kind: "dispatch-workflow-tasks";
-    readonly pendingCallIds: readonly string[];
-    readonly sessionState: DurableSessionState;
-    readonly serializedContext: Record<string, unknown>;
-};
-export {};

package/dist/src/execution/parked-delivery-wait.d.ts

@@ -1,54 +0,0 @@
-import type { DeliverHookPayload, DeliverPayload } from "#channel/types.js";
-import type { SessionCommandInbox } from "#execution/session-command-inbox.js";
-import type { SessionStateCursor } from "#execution/session-state-cursor.js";
-/** One authorization-callback read surfaced during a parked wait. */
-export interface AuthorizationCallbackInstruction {
-    readonly kind: "authorization";
-    /** True when the authorization hook closed; no further callbacks can arrive. */
-    readonly closed: boolean;
-    readonly payloads: readonly DeliverPayload[];
-}
-/** What the parked driver should do with the next session activity. */
-export type NextTurnInstruction = {
-    readonly kind: "clear";
-} | {
-    readonly kind: "compact";
-} | {
-    readonly kind: "expired";
-} | {
-    readonly kind: "reset";
-} | {
-    readonly kind: "closed";
-} | {
-    readonly kind: "cancel-turn";
-} | AuthorizationCallbackInstruction | {
-    readonly kind: "turn";
-    readonly delivery: DeliverHookPayload;
-};
-/**
- * Awaits the next delivery that requires driver action while the session
- * is parked. Deliveries fully routed to a descendant leave the parent with
- * no turn to run, so this keeps waiting until a delivery produces a parent
- * turn, a cancellation, expiry, or hook closure. The wait is unbounded by
- * design: a parked session lives until something addresses it.
- *
- * With `awaitAuthorizationCallbacks`, the inbox's authorization window stays
- * open for the whole wait — including iterations that consume activity
- * without producing a parent turn (no-op cancels, fully-routed descendant
- * deliveries) — so an open challenge's callback surfaces as an
- * `"authorization"` instruction no matter when it arrives.
- *
- * Routing steps mutate durable state; each transition is adopted into the
- * caller-owned `stateCursor`, so returns carry only the instruction kind.
- */
-export declare function nextTurnDelivery(input: {
-    readonly awaitAuthorizationCallbacks?: boolean;
-    readonly bufferedDeliveries: DeliverHookPayload[];
-    readonly bufferedSessionControls: Array<"clear" | "compact" | "expired" | "reset">;
-    readonly cancelledTaskIds?: Set<string>;
-    readonly commandInbox: SessionCommandInbox;
-    readonly deferDeliveries?: boolean;
-    readonly driverWritable: WritableStream<Uint8Array>;
-    readonly seenTaskDeliveries?: Set<string>;
-    readonly stateCursor: SessionStateCursor;
-}): Promise<NextTurnInstruction>;

package/dist/src/execution/parked-delivery-wait.js

@@ -1 +0,0 @@
-import{jsonValuesEqual}from"#shared/json.js";import{coalesceDeliveries}from"#harness/messages.js";import{cancelAllIndexedSessionTasksStep}from"#execution/cancel-indexed-session-tasks-step.js";import{reportDroppedWirePayloadStep}from"#execution/report-dropped-wire-payload-step.js";import{SessionInboxWireError,sessionInboxWire}from"#execution/wire/session-inbox-wire.js";import{routeDeliverToChildren}from"#execution/route-child-delivery.js";import{getSessionTaskCohorts}from"#tasks/session-task-cohorts.js";async function nextTurnDelivery(e){if(e.awaitAuthorizationCallbacks!==!0)return await awaitNextTurnDelivery(e);e.commandInbox.setAuthorizationWindow(!0);try{return await awaitNextTurnDelivery(e)}finally{e.commandInbox.setAuthorizationWindow(!1)}}async function awaitNextTurnDelivery(e){let t=e.cancelledTaskIds??new Set,n=e.seenTaskDeliveries??new Set;for(;;){let r=await waitForNextSessionAction({bufferedDeliveries:e.bufferedDeliveries,bufferedSessionControls:e.bufferedSessionControls,cancelledTaskIds:t,commandInbox:e.commandInbox,deferDeliveries:e.deferDeliveries,seenTaskDeliveries:n,stateCursor:e.stateCursor});if(r.kind===`authorization`)return r;if(r.kind!==`delivery`)return{kind:r.kind};let i=r.delivery;if(i===null)return{kind:`closed`};let a=await routeDeliverToChildren({delivery:i,parentWritable:e.driverWritable,serializedContext:e.stateCursor.serializedContext,sessionState:e.stateCursor.sessionState});if(e.stateCursor.adoptState(a),a.kind===`cancel-turn`)return{kind:`cancel-turn`};if(a.remainder!==void 0)return{delivery:a.remainder,kind:`turn`}}}async function waitForNextSessionAction(e){let t=e.bufferedSessionControls.shift();if(t!==void 0)return{kind:t};for(;;){if(e.deferDeliveries!==!0&&!e.commandInbox.hasReadyAuthorization()){let t=takeBufferedTurnDelivery(e.bufferedDeliveries,getSessionTaskCohorts(e.stateCursor.sessionState.snapshot?.session.state),e.cancelledTaskIds);if(t!==void 0)return{delivery:t,kind:`delivery`}}let{result:t,source:n}=await e.commandInbox.nextWithSource();if(e.commandInbox.consumeNext(),n===`authorization`)return t.done?{closed:!0,kind:`authorization`,payloads:[]}:{closed:!1,kind:`authorization`,payloads:t.value.kind===`deliver`?t.value.payloads:[]};if(t.done)return{delivery:null,kind:`delivery`};if(t.value.kind===`runtime-action-result`)continue;let r;try{r=sessionInboxWire.decode(t.value)}catch(e){if(!(e instanceof SessionInboxWireError))throw e;await reportDroppedWirePayloadStep({detail:e.message,family:`session-inbox`});continue}if(r.kind===`session-timeout`)return{kind:`expired`};if(r.kind===`clear`||r.kind===`compact`||r.kind===`reset`)return{kind:r.kind};if(r.kind===`cancel`){if(`tasks`in r&&r.tasks===!0&&await cancelAllIndexedSessionTasksStep({serializedContext:e.stateCursor.serializedContext,sessionState:e.stateCursor.sessionState}),r.taskId!==void 0){e.cancelledTaskIds.add(r.taskId);let t=e.bufferedDeliveries.filter(t=>!isCancelledTaskDelivery(t,e.cancelledTaskIds));e.bufferedDeliveries.splice(0,e.bufferedDeliveries.length,...t)}continue}let i=r.taskDeliveryId??r.caller?.taskId;if(!(i!==void 0&&isCancelledTaskDeliveryId(i,e.cancelledTaskIds))){if(i!==void 0){if(e.seenTaskDeliveries.has(i))continue;e.seenTaskDeliveries.add(i)}e.bufferedDeliveries.push(r)}}}function isCancelledTaskDelivery(e,t){let n=e.taskDeliveryId??e.caller?.taskId;return n!==void 0&&isCancelledTaskDeliveryId(n,t)}function isCancelledTaskDeliveryId(e,t){return[...t].some(t=>e===t||e.startsWith(`${t}:`))}function takeBufferedTurnDelivery(e,t,n){let r=e.filter(e=>!isCancelledTaskDelivery(e,n));e.splice(0,e.length,...r);let i=new Set(e.flatMap(e=>{let t=completionTaskId(e);return t===void 0?[]:[t]})),a=new Set;for(let[e,r]of t)!r.settled&&!i.has(e)&&!n.has(e)&&a.add(r.cohortId);let o=e.findIndex(e=>{let n=completionCohort(e,t);return n===void 0||!a.has(n)});if(o<0)return;let s=completionCohort(e[o],t);if(s!==void 0){let n=e.findLastIndex(e=>completionCohort(e,t)===s),r=e.findIndex((e,r)=>r>o&&r<n&&completionCohort(e,t)===void 0);r>=0&&(o=r)}let c=e.splice(o,1)[0],l=completionCohort(c,t);if(l!==void 0){let n=e.filter(e=>completionCohort(e,t)===l),r=e.filter(e=>completionCohort(e,t)!==l);return e.splice(0,e.length,...r),coalesceDeliveries([c,...n])}let u=c.auth!=null&&c.auth.principalType!==`anonymous`,d=[c],f=c.caller;for(;e.length>o;){let t=e[o];if(t===void 0||c.taskDeliveryId!==void 0||t.taskDeliveryId!==void 0||!u||!jsonValuesEqual(c.auth,t.auth)||f!==void 0&&t.caller!==void 0)break;let n=e.splice(o,1)[0];if(n===void 0)throw Error(`Buffered turn delivery disappeared while partitioning.`);d.push(n),f??=n.caller}return coalesceDeliveries(d)}function completionCohort(e,t){let n=completionTaskId(e);return n===void 0?void 0:t.get(n)?.cohortId}function completionTaskId(e){if(e.caller===void 0&&e.taskDeliveryId?.endsWith(`:ready:completed`))return e.taskDeliveryId.slice(0,-16)}export{nextTurnDelivery};

package/dist/src/execution/session-command-inbox.d.ts

@@ -1,52 +0,0 @@
-import type { DeliverHookPayload, RuntimeActionResultHookPayload, SessionCommand, SessionTimeoutHookPayload } from "#channel/types.js";
-/**
- * Payloads accepted by a session driver's stable and channel aliases.
- *
- * This union is the hook's transport typing only. The driver routes payloads
- * after the inbox surfaces them; the inbox owns no command semantics.
- */
-export type SessionInboxPayload = DeliverHookPayload | RuntimeActionResultHookPayload | SessionCommand | SessionTimeoutHookPayload;
-/** Which hook family produced an inbox read. */
-export type SessionInboxSource = "authorization" | "session";
-/**
- * Multiplexes one stable session hook, one rekeyable channel alias, and one
- * window-gated authorization-callback hook.
- */
-export interface SessionCommandInbox {
-    /**
-     * Claims the session's authorization-callback hook as an inbox source.
-     * Its reads stay stashed until {@link setAuthorizationWindow} opens, so
-     * callbacks never surface as ordinary session activity.
-     */
-    claimAuthorization(token: string): Promise<void>;
-    claimStable(token: string): Promise<void>;
-    consumeNext(): void;
-    /** Whether an authorization read is already eligible to be consumed. */
-    hasReadyAuthorization(): boolean;
-    next(): Promise<IteratorResult<SessionInboxPayload>>;
-    /**
-     * Like {@link next} but reports which hook family produced the read.
-     * Reads surface in one arrival order across every source, which keeps
-     * waits that interleave authorization callbacks with ordinary session
-     * activity deterministic under workflow replay.
-     */
-    nextWithSource(): Promise<{
-        result: IteratorResult<SessionInboxPayload>;
-        source: SessionInboxSource;
-    }>;
-    rekeyContinuation(token: string): Promise<void>;
-    /** Opens or closes the surfacing window for authorization-callback reads. */
-    setAuthorizationWindow(open: boolean): void;
-}
-/** Adds workflow-entry lifecycle ownership to a session command inbox. */
-export interface SessionCommandInboxHandle extends SessionCommandInbox {
-    dispose(): Promise<void>;
-}
-/**
- * Creates the command inbox owned by one session driver.
- *
- * The stable hook is retained for the session's lifetime. Rekeying replaces
- * only the channel alias. Reads already committed to a retired alias remain in
- * the multiplexed queue and are consumed exactly once.
- */
-export declare function createSessionCommandInbox(): SessionCommandInboxHandle;

package/dist/src/execution/session-command-inbox.js

@@ -1 +0,0 @@
-import{SESSION_INBOX_WIRE_VERSION,SESSION_INBOX_WIRE_VERSION_METADATA_KEY,WORKFLOW_TASK_AUTHORIZATION_METADATA_KEY}from"#execution/wire/session-inbox-contract.js";import{createHook}from"#compiled/@workflow/core/index.js";import{claimHookOwnership,disposeHook}from"#execution/hook-ownership.js";function createSessionCommandInbox(){let e,t,n,r=[],i=[],a=0,o=null,s,c,enqueue=e=>{i.push(e),i.sort((e,t)=>e.order-t.order),c?.(),c=void 0},arm=e=>{e.closed||e.pending||(e.pending=!0,e.resolved=void 0,(e.retired?Promise.resolve(e.hook).then(e=>({done:!1,value:e})):e.iterator.next()).then(t=>{let n={order:a++,result:t,state:e};e.resolved=n,e.enabled&&enqueue(n)},()=>{}))},enable=e=>{e.enabled=!0,e.resolved!==void 0&&enqueue(e.resolved)},createState=e=>{let t=createHook({metadata:{[SESSION_INBOX_WIRE_VERSION_METADATA_KEY]:SESSION_INBOX_WIRE_VERSION,[WORKFLOW_TASK_AUTHORIZATION_METADATA_KEY]:!0},token:e});return{closed:!1,enabled:!1,hook:t,iterator:t[Symbol.asyncIterator](),pending:!1,retired:!1}},states=()=>[e,t,n,...r].filter(e=>e!==void 0),nextRead=()=>{if(e===void 0)throw Error(`Cannot wait for session commands before claiming the stable inbox.`);if(o!==null)return o;let t=states();for(let e of t)arm(e);return t.every(e=>e.closed)?(s={order:a++,result:{done:!0,value:void 0},state:e},o=Promise.resolve(s.result),o):(o=(async()=>{for(;i.length===0;)await new Promise(e=>{c=e});let e=i.shift();return s=e,e.result})(),o)};return{async claimAuthorization(e){if(n!==void 0){if(n.hook.token===e)return;throw Error(`A session command inbox cannot change its authorization token.`)}let t=createState(e);await claimHookOwnership(t.hook),n=t},async claimStable(t){if(e!==void 0){if(e.hook.token===t)return;throw Error(`A session command inbox cannot change its stable token.`)}let n=createState(t);await claimHookOwnership(n.hook),enable(n),e=n},consumeNext(){if(s===void 0)throw Error(`Cannot consume a session command before it resolves.`);s.state.pending=!1,s.state.resolved=void 0,s.result.done&&(s.state.closed=!0),s=void 0,o=null},async dispose(){let r=[t,e,n].filter(e=>e!==void 0);t=void 0,e=void 0,n=void 0,await Promise.all(r.map(async e=>await disposeHook(e.hook)))},hasReadyAuthorization(){return n?.enabled!==!0||n.resolved===void 0?!1:s===void 0?i[0]?.state===n:s.state===n},next:nextRead,async nextWithSource(){return{result:await nextRead(),source:s!==void 0&&s.state===n?`authorization`:`session`}},setAuthorizationWindow(e){if(n===void 0){if(e)throw Error(`Cannot open the authorization window before claiming its hook.`);return}if(e){n.enabled||enable(n),s!==void 0&&s.state!==n&&n.resolved!==void 0&&n.resolved.order<s.order&&(enqueue(s),s=void 0,o=null),o!==null&&arm(n);return}n.enabled=!1;let t=i.findIndex(e=>e.state===n);t!==-1&&i.splice(t,1)},async rekeyContinuation(e){if(!e||t?.hook.token===e)return;let n=createState(e);if(t===void 0){await claimHookOwnership(n.hook),enable(n),t=n,o!==null&&arm(n);return}arm(n),await claimHookOwnership(n.hook),enable(n);let i=t;t=n,arm(i);try{await disposeHook(i.hook)}catch(e){t=void 0;try{await disposeHook(n.hook)}catch{}throw e}i.retired=!0,r.push(i)}}}export{createSessionCommandInbox};

package/dist/src/execution/session-command-token.d.ts

@@ -1,6 +0,0 @@
-/** Returns whether a token belongs to eve's framework-reserved session command namespace. */
-export declare function isReservedSessionCommandToken(token: string): boolean;
-/** Returns whether a token is the stable command inbox for one workflow run. */
-export declare function isSessionCommandHookToken(token: string): boolean;
-/** Derives the framework-reserved stable command inbox token for a session. */
-export declare function sessionCommandHookToken(sessionId: string): string;

package/dist/src/execution/session-command-token.js

@@ -1 +0,0 @@
-const SESSION_COMMAND_NAMESPACE=`eve:session`;function isReservedSessionCommandToken(e){return e.startsWith(`${SESSION_COMMAND_NAMESPACE}:`)}function isSessionCommandHookToken(e){let t=`${SESSION_COMMAND_NAMESPACE}:`;return!e.startsWith(t)||!e.endsWith(`:inbox`)?!1:!e.slice(t.length,-6).includes(`:`)}function sessionCommandHookToken(e){return`${SESSION_COMMAND_NAMESPACE}:${e}:inbox`}export{isReservedSessionCommandToken,isSessionCommandHookToken,sessionCommandHookToken};

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

@@ -1,25 +0,0 @@
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-/** A durable-state transition; absent fields keep the cursor's current value. */
-export interface SessionStateTransition {
-    readonly serializedContext?: Record<string, unknown>;
-    readonly sessionState?: DurableSessionState;
-}
-/**
- * Owns the mutable serialized-context / session-state pair that durable
- * steps thread through a run. Holders adopt each step's transition instead
- * of rebinding both values by hand at every callsite.
- */
-export declare class SessionStateCursor {
-    private currentSerializedContext;
-    private currentSessionState;
-    constructor(input: {
-        readonly serializedContext: Record<string, unknown>;
-        readonly sessionState: DurableSessionState;
-    });
-    /** Latest adopted serialized runtime context. */
-    get serializedContext(): Record<string, unknown>;
-    /** Latest adopted durable session state. */
-    get sessionState(): DurableSessionState;
-    /** Adopts a state transition; fields a step did not change carry forward. */
-    adoptState(transition: SessionStateTransition): void;
-}

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

@@ -1 +0,0 @@
-var SessionStateCursor=class{currentSerializedContext;currentSessionState;constructor(e){this.currentSerializedContext=e.serializedContext,this.currentSessionState=e.sessionState}get serializedContext(){return this.currentSerializedContext}get sessionState(){return this.currentSessionState}adoptState(e){this.currentSerializedContext=e.serializedContext??this.currentSerializedContext,this.currentSessionState=e.sessionState??this.currentSessionState}};export{SessionStateCursor};

package/dist/src/execution/session-timeout-control.js

@@ -1 +0,0 @@
-import{cancelSessionTimeoutStep,startSessionTimeoutStep}from"#execution/session-timeout-steps.js";function createSessionTimeoutControl(e){let t;return{async dispose(){if(t===void 0)return;let e=t;t=void 0,await cancelSessionTimeoutStep({runId:e.runId})},async start(){t===void 0&&(t=await startSessionTimeoutStep(e))}}}export{createSessionTimeoutControl};

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

@@ -1 +0,0 @@
-import{walkCauseChain}from"#shared/errors.js";import{sessionTimeoutWorkflowReference,startWorkflowOnCurrentDeployment}from"#execution/workflow-runtime.js";import{cancelRun,getWorld}from"#internal/workflow/runtime.js";import{EntityConflictError,HookNotFoundError,RunExpiredError,WorkflowRunNotFoundError}from"#compiled/@workflow/errors/index.js";import{resumeSessionInbox}from"#execution/wire/session-inbox-resume.js";async function startSessionTimeoutStep(e){"use step";return{runId:(await startWorkflowOnCurrentDeployment(sessionTimeoutWorkflowReference,[e])).runId}}async function signalSessionTimeoutStep(e){"use step";try{await resumeSessionInbox(e.token,{kind:`session-timeout`})}catch(e){if(!isInactiveTimeoutTarget(e))throw e}}async function cancelSessionTimeoutStep(e){"use step";try{await cancelRun(await getWorld(),e.runId,{cancelReason:`Session ended before its timeout`})}catch(e){if(!isInactiveTimeoutTarget(e))throw e}}function isInactiveTimeoutTarget(e){for(let t of walkCauseChain(e))if(HookNotFoundError.is(t)||WorkflowRunNotFoundError.is(t)||RunExpiredError.is(t)||EntityConflictError.is(t))return!0;return!1}export{cancelSessionTimeoutStep,signalSessionTimeoutStep,startSessionTimeoutStep};

package/dist/src/execution/session-timeout-workflow.js

@@ -1 +0,0 @@
-import{sleep}from"#compiled/@workflow/core/index.js";import{signalSessionTimeoutStep}from"#execution/session-timeout-steps.js";async function sessionTimeoutWorkflow(e){"use workflow";await sleep(e.deadline),await signalSessionTimeoutStep({token:e.token})}sessionTimeoutWorkflow.workflowId=`workflow//eve//sessionTimeoutWorkflow`;export{sessionTimeoutWorkflow};

package/dist/src/execution/session-timeout.d.ts

@@ -1,2 +0,0 @@
-/** Default absolute lifetime of one durable session. */
-export declare const DEFAULT_SESSION_TIMEOUT_MS: number;

package/dist/src/execution/session-timeout.js

@@ -1 +0,0 @@
-const DEFAULT_SESSION_TIMEOUT_MS=2592e6;export{DEFAULT_SESSION_TIMEOUT_MS};

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

@@ -1,30 +0,0 @@
-import { type TurnCancelPayload } from "#execution/turn-cancellation-token.js";
-/**
- * Owns one turn's cancellation surface inside the turn workflow: the
- * turn-private cancel hook and the durable `AbortController` whose
- * signal is serialized into every `turnStep`. Must be created inside a
- * `"use workflow"` body.
- */
-export interface TurnCancellationControl {
-    /** Turn signal to serialize into each `turnStep` input. */
-    readonly signal: AbortSignal;
-    /**
-     * Resolves `"cancel"` once a matching cancel payload is consumed and
-     * the signal aborted. Race it against turn-owned awaits — never
-     * `await` it alone.
-     */
-    readonly payload: Promise<TurnCancelPayload>;
-    readonly requested: Promise<"cancel">;
-    /** Disposes the hook, abandoning any outstanding read. Idempotent. */
-    dispose(): Promise<void>;
-}
-/**
- * Creates and claims the private cancel hook for one turn workflow run.
- * Returns `undefined` when the token is still claimed by a crashed prior
- * run — the turn then runs uncancellable rather than failing.
- */
-export declare function createTurnCancellationControl(input: {
-    readonly controlToken: string;
-    readonly expectedTurnId: string;
-    readonly initialPayload?: TurnCancelPayload;
-}): Promise<TurnCancellationControl | undefined>;

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

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

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

@@ -1,10 +0,0 @@
-/** Derives the private cancellation hook token for one dispatched turn. */
-export declare function turnCancellationHookToken(controlToken: string): string;
-/**
- * Payload accepted by the private turn cancel hook. A mismatched `turnId` is a
- * benign no-op; omitting it targets whichever turn owns the hook.
- */
-export interface TurnCancelPayload {
-    readonly tasks?: boolean;
-    readonly turnId?: string;
-}

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

@@ -1 +0,0 @@
-function turnCancellationHookToken(e){return`${e}:cancel`}export{turnCancellationHookToken};

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

@@ -1,36 +0,0 @@
-import type { DeliverHookPayload, HookPayload } from "#channel/types.js";
-import type { NextDriverAction } from "#execution/next-driver-action.js";
-/** Payloads delivered to the private inbox owned by one active turn. */
-export type TurnInboxPayload = Exclude<HookPayload, DeliverHookPayload> | {
-    readonly delivery: DeliverHookPayload;
-    readonly kind: "driver-delivery";
-    readonly requestId: string;
-};
-/** Control payloads emitted from an active turn to its session driver. */
-export type TurnControlPayload = {
-    readonly action: NextDriverAction;
-    readonly bufferedDeliveries?: readonly DeliverHookPayload[];
-    readonly kind: "turn-result";
-} | {
-    readonly kind: "turn-error";
-    readonly error: unknown;
-} | {
-    readonly continuationToken: string;
-    readonly kind: "turn-continuation-token";
-} | {
-    readonly continuationToken: string;
-    readonly inboxToken: string;
-    readonly kind: "turn-delivery-request";
-    readonly requestId: string;
-} | {
-    readonly kind: "turn-delivery-accepted";
-    readonly requestId: string;
-} | {
-    readonly kind: "turn-delivery-cancelled";
-    readonly requestId: string;
-};
-/** Sends one lifecycle payload to the session driver's control hook. */
-export declare function sendTurnControlStep(input: {
-    readonly controlToken: string;
-    readonly payload: TurnControlPayload;
-}): Promise<void>;

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

@@ -1 +0,0 @@
-import{resumeHook}from"#internal/workflow/runtime.js";import{HookNotFoundError}from"#compiled/@workflow/errors/index.js";async function sendTurnControlStep(e){"use step";try{await resumeHook(e.controlToken,e.payload)}catch(e){if(!HookNotFoundError.is(e))throw e}}export{sendTurnControlStep};

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

@@ -1,54 +0,0 @@
-import type { DeliverHookPayload } from "#channel/types.js";
-import type { NextDriverAction } from "#execution/next-driver-action.js";
-import type { SessionCommandInbox } from "#execution/session-command-inbox.js";
-import type { SessionStateCursor } from "#execution/session-state-cursor.js";
-export type TurnDriverAction = NextDriverAction;
-/** Owns one turn's driver-side control hook and public-delivery relay state. */
-export declare class TurnControlReceiver {
-    private readonly bufferedDeliveries;
-    private readonly bufferedSessionControls;
-    private readonly commandInbox;
-    private readonly control;
-    private readonly controlIterator;
-    private readonly expectedTurnId;
-    private readonly cancelledTaskIds;
-    private readonly seenTaskDeliveries;
-    private readonly stateCursor;
-    private pendingControl;
-    constructor(input: {
-        readonly bufferedDeliveries: DeliverHookPayload[];
-        readonly bufferedSessionControls: Array<"clear" | "compact" | "expired" | "reset">;
-        readonly cancelledTaskIds?: Set<string>;
-        readonly commandInbox: SessionCommandInbox;
-        readonly expectedTurnId: string;
-        readonly seenTaskDeliveries?: Set<string>;
-        readonly stateCursor: SessionStateCursor;
-        readonly token: string;
-    });
-    /** Token passed to the turn workflow so it can publish control messages. */
-    get token(): string;
-    /** Releases the turn control hook and its iterator. */
-    dispose(): Promise<void>;
-    /** Services control messages until the active turn returns its terminal driver action. */
-    waitForAction(): Promise<TurnDriverAction>;
-    private handleSessionCommand;
-    private bufferDelivery;
-    private bufferTurnDeliveries;
-    private consumeControl;
-    private getControlPromise;
-    private nextControlOrCommand;
-    private readTerminalControl;
-    private serviceDeliveryRequest;
-    private takeInputResponseDelivery;
-    /**
-     * Waits for the active turn to resolve a forwarded delivery. The turn either
-     * accepts it (consumed) or releases it on cancellation or termination, in
-     * which case the delivery returns behind remainders from earlier deliveries
-     * accepted by the turn and ahead of deliveries that arrived later.
-     */
-    private awaitForwardedDelivery;
-    private acceptTaskDelivery;
-    private discardTaskDeliveries;
-    private originatesFromCancelledTask;
-    private shouldDiscard;
-}

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

@@ -1 +0,0 @@
-import{createHook}from"#compiled/@workflow/core/index.js";import{closeHookIterator,disposeHook}from"#execution/hook-ownership.js";import{cancelAllIndexedSessionTasksStep}from"#execution/cancel-indexed-session-tasks-step.js";import{reportDroppedWirePayloadStep}from"#execution/report-dropped-wire-payload-step.js";import{SessionInboxWireError,sessionInboxWire}from"#execution/wire/session-inbox-wire.js";import{rebuildSerializableError}from"#execution/workflow-errors.js";import{turnCancellationHookToken}from"#execution/turn-cancellation-token.js";import{forwardTurnCancellationStep}from"#execution/forward-turn-cancellation-step.js";import{forwardTurnDeliveryStep}from"#execution/forward-turn-delivery-step.js";var TurnControlReceiver=class{bufferedDeliveries;bufferedSessionControls;commandInbox;control;controlIterator;expectedTurnId;cancelledTaskIds;seenTaskDeliveries;stateCursor;pendingControl=null;constructor(e){this.bufferedDeliveries=e.bufferedDeliveries,this.bufferedSessionControls=e.bufferedSessionControls,this.cancelledTaskIds=e.cancelledTaskIds??new Set,this.commandInbox=e.commandInbox,this.seenTaskDeliveries=e.seenTaskDeliveries??new Set,this.stateCursor=e.stateCursor,this.control=createHook({token:e.token}),this.controlIterator=this.control[Symbol.asyncIterator](),this.expectedTurnId=e.expectedTurnId}get token(){return this.control.token}async dispose(){await closeHookIterator(this.controlIterator),await disposeHook(this.control)}async waitForAction(){for(;;){let e=await this.nextControlOrCommand();if(e.kind===`command`){let t=await this.handleSessionCommand(e.command);if(t!==void 0)return t;continue}let t=e.payload,n=this.readTerminalControl(t);if(n!==void 0)return n;if(t.kind===`turn-delivery-request`){let e=await this.serviceDeliveryRequest(t);if(e!==void 0)return e}}}async handleSessionCommand(e){if(e.kind===`deliver`){if(!this.acceptTaskDelivery(e))return;await this.bufferDelivery(e);return}if(e.kind===`clear`||e.kind===`compact`){this.bufferedSessionControls.push(e.kind);return}if(e.kind===`session-timeout`){this.bufferedSessionControls.push(`expired`);return}if(e.kind===`cancel`){`tasks`in e&&e.tasks===!0&&await cancelAllIndexedSessionTasksStep({serializedContext:this.stateCursor.serializedContext,sessionState:this.stateCursor.sessionState}),e.taskId!==void 0&&this.discardTaskDeliveries(e.taskId);let t=e.taskId!==void 0&&e.turnId!==void 0&&e.turnId!==this.expectedTurnId?void 0:e.turnId,n={tasks:e.tasks};t!==void 0&&(n.turnId=t),await forwardTurnCancellationStep({payload:n,token:turnCancellationHookToken(this.control.token)});return}if(e.kind===`reset`){await forwardTurnCancellationStep({payload:{},token:turnCancellationHookToken(this.control.token)}),this.bufferedSessionControls.push(`reset`);return}return unsupportedSessionCommand(e)}async bufferDelivery(e){this.bufferedDeliveries.push(e),e.turnPolicy===`steer`&&deliveryHasMessage(e)&&await forwardTurnCancellationStep({payload:{},token:turnCancellationHookToken(this.control.token)})}bufferTurnDeliveries(e){e.bufferedDeliveries!==void 0&&this.bufferedDeliveries.unshift(...e.bufferedDeliveries.filter(e=>!this.shouldDiscard(e)))}consumeControl(){this.pendingControl=null}getControlPromise(){return this.pendingControl??=this.controlIterator.next(),this.pendingControl}async nextControlOrCommand(){let e=await Promise.race([this.getControlPromise().then(e=>({kind:`control`,value:e})),this.commandInbox.next().then(e=>({kind:`command`,value:e}))]);if(e.kind===`command`){if(e.value.done)throw Error(`Session command inbox closed before the active turn settled.`);if(this.commandInbox.consumeNext(),e.value.value.kind===`runtime-action-result`)return await this.nextControlOrCommand();try{return{command:sessionInboxWire.decode(e.value.value),kind:`command`}}catch(e){if(!(e instanceof SessionInboxWireError))throw e;return await reportDroppedWirePayloadStep({detail:e.message,family:`session-inbox`}),await this.nextControlOrCommand()}}if(this.consumeControl(),e.value.done)throw Error(`Turn control hook closed before delivering a result.`);let t=e.value.value;if(t.kind===`turn-error`)throw rebuildSerializableError(t.error);return t.kind===`turn-continuation-token`?(await this.commandInbox.rekeyContinuation(t.continuationToken),await this.nextControlOrCommand()):{kind:`control`,payload:t}}readTerminalControl(e){if(e.kind===`turn-error`)throw rebuildSerializableError(e.error);if(e.kind===`turn-result`)return this.bufferTurnDeliveries(e),e.action}async serviceDeliveryRequest(e){await this.commandInbox.rekeyContinuation(e.continuationToken);let t=this.takeInputResponseDelivery();for(;t===void 0;){let n=await Promise.race([this.getControlPromise().then(e=>({kind:`control`,value:e})),this.commandInbox.next().then(e=>({kind:`command`,value:e}))]);if(n.kind===`control`){if(this.consumeControl(),n.value.done)throw Error(`Turn control hook closed during a delivery request.`);if(n.value.value.kind===`turn-continuation-token`){await this.commandInbox.rekeyContinuation(n.value.value.continuationToken);continue}let t=this.readTerminalControl(n.value.value);if(t!==void 0)return t;if(n.value.value.kind===`turn-delivery-cancelled`&&n.value.value.requestId===e.requestId)return;continue}if(n.value.done)throw Error(`Session command inbox closed during a turn delivery request.`);if(this.commandInbox.consumeNext(),n.value.value.kind===`runtime-action-result`)continue;let r;try{r=sessionInboxWire.decode(n.value.value)}catch(e){if(!(e instanceof SessionInboxWireError))throw e;await reportDroppedWirePayloadStep({detail:e.message,family:`session-inbox`});continue}if(r.kind===`deliver`){if(!this.acceptTaskDelivery(r))continue;deliveryHasMessage(r)?await this.bufferDelivery(r):t=r;continue}let i=await this.handleSessionCommand(r);if(i!==void 0)return i}try{await forwardTurnDeliveryStep({inboxToken:e.inboxToken,payload:{delivery:t,kind:`driver-delivery`,requestId:e.requestId}})}catch(e){if(!(e instanceof Error&&e.name===`HookNotFoundError`))throw e}return await this.awaitForwardedDelivery(e.requestId,t)}takeInputResponseDelivery(){let e=this.bufferedDeliveries.findIndex(e=>!deliveryHasMessage(e));if(e!==-1)return this.bufferedDeliveries.splice(e,1)[0]}async awaitForwardedDelivery(e,t){for(;;){let n=await this.nextControlOrCommand();if(n.kind===`command`){let e=await this.handleSessionCommand(n.command);if(e!==void 0)return this.shouldDiscard(t)||this.bufferedDeliveries.unshift(t),e;continue}let r=n.payload;if(r.kind===`turn-delivery-accepted`){if(r.requestId===e)return;continue}if(r.kind===`turn-delivery-cancelled`&&r.requestId===e){this.shouldDiscard(t)||this.bufferedDeliveries.unshift(t);return}r.kind===`turn-result`&&(this.shouldDiscard(t)||this.bufferedDeliveries.unshift(t));let i=this.readTerminalControl(r);if(i!==void 0)return i}}acceptTaskDelivery(e){let t=e.taskDeliveryId??e.caller?.taskId;return t===void 0?!0:this.originatesFromCancelledTask(t)||this.seenTaskDeliveries.has(t)?!1:(this.seenTaskDeliveries.add(t),!0)}discardTaskDeliveries(e){this.cancelledTaskIds.add(e);let t=this.bufferedDeliveries.filter(e=>!this.shouldDiscard(e));this.bufferedDeliveries.splice(0,this.bufferedDeliveries.length,...t)}originatesFromCancelledTask(e){return[...this.cancelledTaskIds].some(t=>deliveryOriginatesFromTask(e,t))}shouldDiscard(e){let t=e.taskDeliveryId??e.caller?.taskId;return t!==void 0&&this.originatesFromCancelledTask(t)}};function deliveryOriginatesFromTask(e,t){return e===t||e.startsWith(`${t}:`)}function deliveryHasMessage(e){return e.payloads.some(e=>e.message!==void 0)}function unsupportedSessionCommand(e){throw Error(`Unsupported session command: ${JSON.stringify(e)}`)}export{TurnControlReceiver};

package/dist/src/execution/turn-dispatch.d.ts

@@ -1,39 +0,0 @@
-import type { DeliverHookPayload, HookPayload, SessionCapabilities } from "#channel/types.js";
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-import type { SessionCommandInbox } from "#execution/session-command-inbox.js";
-import { SessionStateCursor } from "#execution/session-state-cursor.js";
-import type { TurnDriverAction } from "#execution/turn-control-receiver.js";
-import type { AgentWorkflowRetentionDefinition } from "#shared/agent-definition.js";
-import type { RunMode } from "#shared/run-mode.js";
-/** One settled turn: its terminal driver action plus deferred hook cleanup. */
-export interface DispatchedTurn {
-    readonly action: TurnDriverAction;
-    /**
-     * Disposes the turn's control hook. Deferred until the *next* turn
-     * settles (or the session ends): the turn run's final control send is
-     * at-least-once, and `sendTurnControlStep` does not treat
-     * `HookNotFoundError` as benign, so a late duplicate resume must land
-     * on a live hook. By the next settle, the previous run has completed
-     * and can no longer re-send.
-     */
-    dispose(): Promise<void>;
-}
-/** Dispatches one turn and services its private-inbox control protocol until it terminates. */
-interface TurnDispatchInput {
-    readonly bufferedDeliveries: DeliverHookPayload[];
-    readonly bufferedSessionControls: Array<"clear" | "compact" | "expired" | "reset">;
-    readonly capabilities?: SessionCapabilities;
-    readonly cancelledTaskIds?: Set<string>;
-    readonly controlToken: string;
-    readonly delivery: HookPayload;
-    readonly commandInbox: SessionCommandInbox;
-    readonly mode: RunMode;
-    readonly parentWritable: WritableStream<Uint8Array>;
-    readonly retention?: AgentWorkflowRetentionDefinition;
-    readonly serializedContext: Record<string, unknown>;
-    readonly seenTaskDeliveries?: Set<string>;
-    readonly sessionState: DurableSessionState;
-    readonly stateCursor?: SessionStateCursor;
-}
-export declare function dispatchAndAwaitTurn(input: TurnDispatchInput): Promise<DispatchedTurn>;
-export {};

package/dist/src/execution/turn-dispatch.js

@@ -1 +0,0 @@
-import{activeTurnId}from"#harness/active-turn-id.js";import{createTurnWorkflowInput}from"#execution/durable-session-migrations/turn-workflow.js";import{SessionStateCursor}from"#execution/session-state-cursor.js";import{dispatchTurnStep}from"#execution/dispatch-turn-step.js";import{TurnControlReceiver}from"#execution/turn-control-receiver.js";import{runInlineTurn}from"#execution/inline-turn.js";import{runTurnOwnedWorkflow}from"#execution/turn-workflow.js";async function dispatchAndAwaitTurn(e){let t=e.stateCursor??new SessionStateCursor({serializedContext:e.serializedContext,sessionState:e.sessionState}),n=await runInlineTurn({...e,stateCursor:t});return n.kind===`result`?{action:n.action,async dispose(){}}:await runAndAwaitTurn({...e,inline:n.kind===`continue`,initialCancellation:n.initialCancellation,stateCursor:t,initialStep:n.initialStep})}async function runAndAwaitTurn(e){let t=new TurnControlReceiver({bufferedDeliveries:e.bufferedDeliveries,bufferedSessionControls:e.bufferedSessionControls,cancelledTaskIds:e.cancelledTaskIds,commandInbox:e.commandInbox,expectedTurnId:activeTurnId(e.sessionState.emissionState),seenTaskDeliveries:e.seenTaskDeliveries??new Set,stateCursor:e.stateCursor,token:e.controlToken});try{let n={capabilities:e.capabilities,completionToken:t.token,delivery:e.delivery,initialCancellation:e.initialCancellation,initialStep:e.initialStep,mode:e.mode,parentWritable:e.parentWritable,retention:e.retention,serializedContext:e.serializedContext,sessionState:e.sessionState},r;if(e.inline){let e=Promise.withResolvers();[r]=await Promise.all([e.promise.then(()=>t.waitForAction()),runTurnOwnedWorkflow(createTurnWorkflowInput(n),e.resolve)])}else await dispatchTurnStep(n),r=await t.waitForAction();return{action:r,dispose:()=>t.dispose()}}catch(e){throw await t.dispose(),e}}export{dispatchAndAwaitTurn};

package/dist/src/execution/turn-execution-cursor.d.ts

@@ -1,49 +0,0 @@
-import type { DeliverHookPayload } from "#channel/types.js";
-import type { TurnControlPayload } from "#execution/turn-control-protocol.js";
-import type { DurableSessionState } from "#execution/durable-session-store.js";
-import type { TurnStepInput, TurnStepPayload } from "#execution/durable-session-migrations/turn-workflow.js";
-import { SessionStateCursor } from "#execution/session-state-cursor.js";
-import type { SettledTurn } from "#harness/types.js";
-import type { TokenUsage } from "#shared/token-usage.js";
-interface TurnTransition {
-    readonly serializedContext?: Record<string, unknown>;
-    readonly sessionState: DurableSessionState;
-}
-type TurnTerminalAction = {
-    readonly isError?: boolean;
-    readonly kind: "done";
-    readonly output: unknown;
-    readonly usage?: TokenUsage;
-    readonly usageDelta?: TokenUsage;
-} | {
-    readonly authorizationAttemptIds?: readonly string[];
-    readonly authorizationNames?: readonly string[];
-    readonly cancelled?: true;
-    readonly kind: "park";
-    readonly settled?: SettledTurn;
-};
-/** Owns the mutable durable state cursor for one active turn workflow. */
-export declare class TurnExecutionCursor extends SessionStateCursor {
-    readonly controlToken: string;
-    readonly parentWritable: WritableStream<Uint8Array>;
-    private lastReportedContinuationToken;
-    constructor(input: {
-        readonly controlToken: string;
-        readonly parentWritable: WritableStream<Uint8Array>;
-        readonly serializedContext: Record<string, unknown>;
-        readonly sessionState: DurableSessionState;
-    });
-    /** Adopts a state transition and reports any continuation-token change once. */
-    adopt(transition: TurnTransition): Promise<void>;
-    /** Builds the next atomic turn-step input from the cursor's current state. */
-    createStepInput(input: TurnStepPayload | undefined, abortSignal?: AbortSignal): TurnStepInput;
-    /**
-     * Adopts a terminal turn transition and publishes it as the turn result.
-     * The result already carries the final session state, so no separate
-     * continuation-token update is sent.
-     */
-    finish(transition: TurnTransition, action: TurnTerminalAction, bufferedDeliveries: readonly DeliverHookPayload[]): Promise<void>;
-    /** Sends one control payload to the session driver. */
-    send(payload: TurnControlPayload): Promise<void>;
-}
-export {};

package/dist/src/execution/turn-execution-cursor.js

@@ -1 +0,0 @@
-import{SessionStateCursor}from"#execution/session-state-cursor.js";import{sendTurnControlStep}from"#execution/turn-control-protocol.js";var TurnExecutionCursor=class extends SessionStateCursor{controlToken;parentWritable;lastReportedContinuationToken;constructor(e){super({serializedContext:e.serializedContext,sessionState:e.sessionState}),this.controlToken=e.controlToken,this.lastReportedContinuationToken=e.sessionState.continuationToken,this.parentWritable=e.parentWritable}async adopt(e){this.adoptState(e);let t=e.sessionState.continuationToken;t!==``&&t!==this.lastReportedContinuationToken&&(this.lastReportedContinuationToken=t,await this.send({continuationToken:t,kind:`turn-continuation-token`}))}createStepInput(e,t){return{abortSignal:t,input:e,parentWritable:this.parentWritable,serializedContext:this.serializedContext,sessionState:this.sessionState}}async finish(e,t,n){this.adoptState(e),await this.send({action:{...t,serializedContext:this.serializedContext,sessionState:this.sessionState},bufferedDeliveries:n.length===0?void 0:[...n],kind:`turn-result`})}async send(e){await sendTurnControlStep({controlToken:this.controlToken,payload:e})}};export{TurnExecutionCursor};