@superdurable/dex-agents 0.0.0-stage → 0.1.0

package/dist/src/agent-session-steps.js

@@ -0,0 +1,533 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { ExecuteFailure, StepMovement, int64Codec, StepRef, Timer, Wait, deadEnd, goTo, goToMany, stringCodec, voidCodec, } from "@superdurable/dex";
+import { ToolExecutionError, } from "./agent-framework-runner.js";
+import { agentSessionStartInputCodec } from "./agent-session-codecs.js";
+import { agentSessionStepTypes, readRecoveryDetail, toolStepTypeForEffect, } from "./agent-session-transitions.js";
+import { approvalDeadlinePassed, buildTurnFailureNote, emptyAgentUsage, isFinalToolCallStatus, } from "./agent-session-values.js";
+const minuteMs = 60_000;
+// Recovery Steps must eventually run; cap their backoff so a returning Worker picks them up quickly.
+const recoveryRetry = { maximumIntervalMs: 5_000 };
+// An ASYNC FlowConfig could replay a committed result after a Server failover, re-running a write.
+const syncDurability = { waitForDurability: "sync", executeDurability: "sync" };
+// An int64 Value, as the Python core's Step[int] encodes it.
+const expectedResultCountCodec = {
+    typeName: "ExpectedResultCount",
+    wireKind: "int64",
+    encode: (value) => int64Codec.encode(BigInt(requirePositiveResultCount(value))),
+    decode: (value) => requirePositiveResultCount(Number(int64Codec.decode(value))),
+};
+export class StartAgentSessionStep {
+    transitions;
+    inputCodec = agentSessionStartInputCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.startAgentSession;
+    }
+    getStepOptions() {
+        return syncDurability;
+    }
+    execute(context, input) {
+        const persistence = this.transitions.persistence;
+        const state = {
+            status: "waiting_for_user_message",
+            turnCount: 0,
+            activeTurnId: null,
+            nextMessageSequence: 1,
+            lastTurnError: null,
+        };
+        this.transitions.writeAgentState(context, state);
+        persistence.agentUsage.set(context, emptyAgentUsage());
+        persistence.pendingInterrupts.set(context, []);
+        const initialMessage = input.initialMessage;
+        if (initialMessage === null || initialMessage.trim() === "") {
+            return this.transitions.goToAwaitUserMessage();
+        }
+        return this.transitions.beginTurn(context, state, initialMessage);
+    }
+}
+export class AwaitUserMessageStep {
+    transitions;
+    inputCodec = voidCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.awaitUserMessage;
+    }
+    getStepOptions() {
+        return syncDurability;
+    }
+    waitFor() {
+        return Wait.until(this.transitions.persistence.queuedUserMessages.forOne());
+    }
+    execute(context) {
+        const [message] = context.channelResults(this.transitions.persistence.queuedUserMessages);
+        if (message === undefined || message.text.trim() === "") {
+            return this.transitions.goToAwaitUserMessage();
+        }
+        return this.transitions.beginTurn(context, this.transitions.readAgentState(context), message.text);
+    }
+}
+/** Makes the turn's next model call and fans the requested tool calls out to parallel Steps. */
+export class RunModelStep {
+    transitions;
+    inputCodec = voidCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.runModel;
+    }
+    getStepOptions() {
+        const persistence = this.transitions.persistence;
+        return {
+            ...syncDurability,
+            executeMethodTimeoutMs: 15 * minuteMs,
+            heartbeatTimeoutMs: 2 * minuteMs,
+            executeRetry: { maximumAttempts: 3, totalDurationMs: 30 * minuteMs },
+            executeFailure: ExecuteFailure.proceedTo(new StepRef(agentSessionStepTypes.recordTurnFailure)),
+            executeLoadAttributeMaps: [persistence.agentMessages, persistence.agentToolCalls],
+        };
+    }
+    async execute(context) {
+        const transitions = this.transitions;
+        const state = transitions.readAgentState(context);
+        const turnId = state.activeTurnId;
+        if (turnId === null) {
+            throw new Error(`the agent session ${context.flowId} has no active turn`);
+        }
+        const toolCalls = transitions.readTurnToolCalls(context, turnId);
+        const openToolCall = toolCalls.find((toolCall) => !isFinalToolCallStatus(toolCall.status));
+        if (openToolCall !== undefined) {
+            throw new Error(`RunModel for ${turnId} started before tool call ${openToolCall.toolCallId} finished`);
+        }
+        const toolCallsById = new Map(toolCalls.map((toolCall) => [toolCall.toolCallId, toolCall]));
+        const frameworkRunState = transitions.readFrameworkRunState(context);
+        const events = transitions.createEventWriter(context, turnId);
+        try {
+            const turnContext = {
+                flowId: context.flowId,
+                turnId,
+                attempt: context.attempt,
+                messages: transitions.readMessages(context, 1, state.nextMessageSequence),
+                frameworkRunState,
+                isResuming: frameworkRunState !== null,
+                toolCalls,
+                events,
+                cancellationSignal: context.cancellationSignal,
+                deadline: context.deadline,
+                resolveToolPolicy: (toolName, frameworkEffect) => transitions.resolveToolPolicy(toolName, frameworkEffect),
+                recordedToolCall: (toolCallId) => toolCallsById.get(toolCallId),
+                heartbeat: () => transitions.recordHeartbeat(context),
+            };
+            const outcome = await transitions.runWithHeartbeats(context, () => transitions.runner.runModelStep(turnContext));
+            switch (outcome?.kind) {
+                case "completed":
+                    return this.completeTurn(context, state, turnId, toolCalls, outcome, events);
+                case "tool_calls_requested":
+                    return this.requestToolCalls(context, state, turnId, toolCalls, outcome, events);
+                default:
+                    throw new TypeError("runModelStep must return a TurnCompleted or ToolCallsRequested outcome");
+            }
+        }
+        finally {
+            events.close();
+        }
+    }
+    completeTurn(context, state, turnId, toolCalls, outcome, events) {
+        const transitions = this.transitions;
+        const persistence = transitions.persistence;
+        const stateWithMessages = transitions.appendMessages(context, state, turnId, outcome.newMessages);
+        for (const toolCall of toolCalls) {
+            persistence.agentToolCalls.delete(context, toolCall.toolCallId);
+        }
+        persistence.frameworkRunState.delete(context);
+        transitions.recordUsage(context, outcome.usage, events);
+        transitions.writeAgentState(context, {
+            ...stateWithMessages,
+            status: "waiting_for_user_message",
+            turnCount: state.turnCount + 1,
+            activeTurnId: null,
+            lastTurnError: null,
+        });
+        events.writeEvent("turn_completed", { message_count: outcome.newMessages.length });
+        return transitions.goToAwaitUserMessage();
+    }
+    requestToolCalls(context, state, turnId, toolCalls, outcome, events) {
+        validateToolCallsRequested(turnId, toolCalls, outcome);
+        const transitions = this.transitions;
+        transitions.persistence.frameworkRunState.set(context, outcome.frameworkRunState);
+        const createdAt = new Date();
+        const deadline = transitions.config.interruptDeadlineMs === undefined
+            ? null
+            : new Date(createdAt.getTime() + transitions.config.interruptDeadlineMs).toISOString();
+        const interrupts = [];
+        // goToMany takes movements of mixed input types, which the SDK types as StepMovement<any>.
+        const movements = [];
+        for (const [index, requestedToolCall] of outcome.toolCalls.entries()) {
+            const requiresApproval = requestedToolCall.policy.requiresApproval;
+            const effect = requestedToolCall.policy.effect;
+            transitions.writeToolCall(context, {
+                toolCallId: requestedToolCall.toolCallId,
+                turnId,
+                toolName: requestedToolCall.toolName,
+                arguments: requestedToolCall.arguments,
+                effect,
+                requiresApproval,
+                status: requiresApproval ? "awaiting_approval" : "approved",
+                output: null,
+                error: null,
+                rejectionMessage: null,
+                deferralOrder: toolCalls.length + index,
+            });
+            events.writeEvent("tool_call_deferred", {
+                tool_call_id: requestedToolCall.toolCallId,
+                tool_name: requestedToolCall.toolName,
+                effect,
+                requires_approval: requiresApproval,
+            });
+            const nextStepType = requiresApproval
+                ? agentSessionStepTypes.awaitToolApproval
+                : toolStepTypeForEffect(effect);
+            movements.push(toolStepMovement(transitions.persistence, nextStepType, requestedToolCall.toolCallId));
+            if (!requiresApproval) {
+                continue;
+            }
+            const interrupt = {
+                interruptId: requestedToolCall.toolCallId,
+                kind: "tool_approval",
+                toolCallId: requestedToolCall.toolCallId,
+                toolName: requestedToolCall.toolName,
+                arguments: requestedToolCall.arguments,
+                createdAt: createdAt.toISOString(),
+                deadline,
+            };
+            interrupts.push(interrupt);
+            events.writeEvent("interrupt_raised", {
+                interrupt_id: interrupt.interruptId,
+                tool_call_id: interrupt.toolCallId,
+                tool_name: interrupt.toolName,
+                deadline: interrupt.deadline,
+            });
+        }
+        transitions.persistence.pendingInterrupts.set(context, interrupts);
+        transitions.recordUsage(context, outcome.usage, events);
+        transitions.writeAgentState(context, { ...state, status: "running_tools" });
+        movements.push(StepMovement.of(new StepRef(agentSessionStepTypes.resumeTurn), outcome.toolCalls.length));
+        return goToMany(...movements);
+    }
+}
+/** Waits for one tool call's approval or its deadline, then runs or rejects the call. */
+export class AwaitToolApprovalStep {
+    transitions;
+    inputCodec = stringCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.awaitToolApproval;
+    }
+    getStepOptions() {
+        return toolStepOptions(this.transitions.persistence, agentSessionStepTypes.awaitToolApproval);
+    }
+    waitFor(context, toolCallId) {
+        const transitions = this.transitions;
+        const conditions = [transitions.persistence.interruptResolutions.forOne(toolCallId)];
+        // A resolved interrupt left PendingInterrupts, so its deadline no longer applies.
+        const interrupt = transitions
+            .readPendingInterrupts(context)
+            .find((pendingInterrupt) => pendingInterrupt.interruptId === toolCallId);
+        if (interrupt?.deadline != null) {
+            // Dex Timers take whole seconds; rounding up can only fire late, never early.
+            const remainingMs = Math.max(0, Date.parse(interrupt.deadline) - Date.now());
+            conditions.push(Timer.byDuration(Math.ceil(remainingMs / 1_000) * 1_000));
+        }
+        return Wait.anyOf(...conditions);
+    }
+    execute(context, toolCallId) {
+        const transitions = this.transitions;
+        const persistence = transitions.persistence;
+        const toolCall = transitions.readToolCall(context, toolCallId);
+        if (toolCall.status !== "awaiting_approval") {
+            return deadEnd();
+        }
+        const [resolution] = context.channelResults(persistence.interruptResolutions, toolCallId);
+        if (resolution === undefined) {
+            if (!context.hasTimerFired()) {
+                throw new Error(`the approval wait for ${toolCallId} completed without an answer`);
+            }
+            const pendingInterrupts = transitions.readPendingInterrupts(context);
+            const interrupt = pendingInterrupts.find((pending) => pending.interruptId === toolCallId);
+            // resolve_interrupt answered first, or the Timer fired early; wait again.
+            if (interrupt?.deadline == null || Date.parse(interrupt.deadline) > Date.now()) {
+                return goToMany(toolStepMovement(persistence, agentSessionStepTypes.awaitToolApproval, toolCallId));
+            }
+            persistence.pendingInterrupts.set(context, pendingInterrupts.filter((interrupt) => interrupt.interruptId !== toolCallId));
+            return this.rejectToolCall(context, toolCall, approvalDeadlinePassed);
+        }
+        if (!resolution.approved) {
+            return this.rejectToolCall(context, toolCall, resolution.rejectionMessage);
+        }
+        transitions.writeToolCall(context, { ...toolCall, status: "approved" });
+        this.writeInterruptResolved(context, toolCall, true, null);
+        return goToMany(toolStepMovement(persistence, toolStepTypeForEffect(toolCall.effect), toolCallId));
+    }
+    rejectToolCall(context, toolCall, rejectionMessage) {
+        this.transitions.writeToolCall(context, { ...toolCall, status: "rejected", rejectionMessage });
+        this.writeInterruptResolved(context, toolCall, false, rejectionMessage);
+        this.transitions.writeEvents(context, toolCall.turnId, (events) => events.writeToolCallFinished(toolCall.toolCallId, toolCall.toolName, "rejected"));
+        this.transitions.publishToolCallResult(context, toolCall.toolCallId);
+        return deadEnd();
+    }
+    writeInterruptResolved(context, toolCall, isApproved, rejectionMessage) {
+        this.transitions.writeEvents(context, toolCall.turnId, (events) => events.writeEvent("interrupt_resolved", {
+            interrupt_id: toolCall.toolCallId,
+            approved: isApproved,
+            rejection_message: rejectionMessage,
+        }));
+    }
+}
+/** Runs one tool call; one class serves `CallTool` and `CallSingleAttemptTool`. */
+export class ToolCallStep {
+    transitions;
+    stepType;
+    inputCodec = stringCodec;
+    constructor(transitions, stepType) {
+        this.transitions = transitions;
+        this.stepType = stepType;
+    }
+    getStepType() {
+        return this.stepType;
+    }
+    getStepOptions() {
+        return toolStepOptions(this.transitions.persistence, this.stepType);
+    }
+    async execute(context, toolCallId) {
+        const transitions = this.transitions;
+        const toolCall = transitions.readToolCall(context, toolCallId);
+        if (isFinalToolCallStatus(toolCall.status)) {
+            return deadEnd();
+        }
+        if (toolCall.status !== "approved" || toolStepTypeForEffect(toolCall.effect) !== this.stepType) {
+            throw new Error(`tool call ${toolCallId} cannot run in ${this.stepType}`);
+        }
+        const events = transitions.createEventWriter(context, toolCall.turnId);
+        try {
+            events.writeToolCallStarted(toolCall.toolCallId, toolCall.toolName);
+            // Dex re-delivers an attempt whose Worker vanished before any output, so emit output first.
+            await transitions.recordHeartbeat(context);
+            const execution = {
+                flowId: context.flowId,
+                toolCall,
+                idempotencyKey: `${context.flowId}/${toolCall.turnId}/${toolCall.toolCallId}`,
+                attempt: context.attempt,
+                events,
+                cancellationSignal: context.cancellationSignal,
+                deadline: context.deadline,
+                heartbeat: () => transitions.recordHeartbeat(context),
+            };
+            let finishedToolCall;
+            try {
+                const result = await transitions.runWithHeartbeats(context, () => transitions.runner.executeDeferredToolCall(execution));
+                if (typeof result?.output !== "string") {
+                    throw new TypeError(`executeDeferredToolCall returned no output for ${toolCallId}`);
+                }
+                finishedToolCall = { ...toolCall, status: "succeeded", output: result.output };
+            }
+            catch (error) {
+                if (!(error instanceof ToolExecutionError)) {
+                    throw error;
+                }
+                finishedToolCall = { ...toolCall, status: "failed", error: error.message };
+            }
+            transitions.writeToolCall(context, finishedToolCall);
+            events.writeToolCallFinished(toolCall.toolCallId, toolCall.toolName, finishedToolCall.status);
+            transitions.publishToolCallResult(context, toolCallId);
+            return deadEnd();
+        }
+        finally {
+            events.close();
+        }
+    }
+}
+/**
+ * Failure route of a tool Step; it receives the failed Step's input, the tool call ID.
+ * `RecordToolFailure` records `failed` for a `read` call and `outcome_unknown` for a write;
+ * `RecordToolOutcomeUnknown` always records `outcome_unknown`.
+ */
+export class ToolCallFailureRecordingStep {
+    transitions;
+    stepType;
+    isReadFailureRecorded;
+    inputCodec = stringCodec;
+    constructor(transitions, stepType, isReadFailureRecorded) {
+        this.transitions = transitions;
+        this.stepType = stepType;
+        this.isReadFailureRecorded = isReadFailureRecorded;
+    }
+    getStepType() {
+        return this.stepType;
+    }
+    getStepOptions() {
+        return toolStepOptions(this.transitions.persistence, this.stepType);
+    }
+    execute(context, toolCallId) {
+        const transitions = this.transitions;
+        const toolCall = transitions.readToolCall(context, toolCallId);
+        if (isFinalToolCallStatus(toolCall.status)) {
+            return deadEnd();
+        }
+        const status = this.isReadFailureRecorded && toolCall.effect === "read" ? "failed" : "outcome_unknown";
+        transitions.writeToolCall(context, { ...toolCall, status, error: readRecoveryDetail(context) });
+        transitions.writeEvents(context, toolCall.turnId, (events) => events.writeToolCallFinished(toolCall.toolCallId, toolCall.toolName, status));
+        transitions.publishToolCallResult(context, toolCallId);
+        return deadEnd();
+    }
+}
+/** Waits until every tool call of the batch has a final record, then makes the next model call. */
+export class ResumeTurnStep {
+    transitions;
+    inputCodec = expectedResultCountCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.resumeTurn;
+    }
+    getStepOptions() {
+        return { ...syncDurability, executeLoadAttributeMaps: [this.transitions.persistence.agentToolCalls] };
+    }
+    waitFor(_context, expectedResultCount) {
+        return Wait.until(this.transitions.persistence.toolCallResults.forN(expectedResultCount));
+    }
+    execute(context) {
+        const transitions = this.transitions;
+        const state = transitions.readAgentState(context);
+        const unfinishedCount = transitions
+            .readTurnToolCalls(context, state.activeTurnId)
+            .filter((toolCall) => !isFinalToolCallStatus(toolCall.status)).length;
+        if (unfinishedCount > 0) {
+            // A consumed result from an earlier turn must not resume this one early.
+            return goTo(new StepRef(agentSessionStepTypes.resumeTurn), unfinishedCount);
+        }
+        transitions.writeAgentState(context, { ...state, status: "running_model" });
+        return goTo(new StepRef(agentSessionStepTypes.runModel), undefined);
+    }
+}
+export class RecordTurnFailureStep {
+    transitions;
+    inputCodec = voidCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.recordTurnFailure;
+    }
+    getStepOptions() {
+        return {
+            ...syncDurability,
+            executeRetry: recoveryRetry,
+            executeLoadAttributeMaps: [this.transitions.persistence.agentToolCalls],
+        };
+    }
+    execute(context) {
+        const transitions = this.transitions;
+        const persistence = transitions.persistence;
+        let state = transitions.readAgentState(context);
+        const turnError = readRecoveryDetail(context);
+        const toolCalls = transitions.readTurnToolCalls(context, state.activeTurnId);
+        const finalToolCalls = toolCalls.filter((toolCall) => isFinalToolCallStatus(toolCall.status));
+        // The records are deleted below; the note keeps the next model from repeating writes.
+        if (state.activeTurnId !== null && finalToolCalls.length > 0) {
+            const note = transitions.runner.buildUserMessage(buildTurnFailureNote(finalToolCalls));
+            if (note.role !== "user") {
+                throw new TypeError("buildUserMessage must return a message with role user");
+            }
+            state = transitions.appendMessages(context, state, state.activeTurnId, [note]);
+        }
+        for (const toolCall of toolCalls) {
+            persistence.agentToolCalls.delete(context, toolCall.toolCallId);
+        }
+        persistence.frameworkRunState.delete(context);
+        persistence.pendingInterrupts.set(context, []);
+        transitions.writeAgentState(context, {
+            ...state,
+            status: "waiting_for_user_message",
+            turnCount: state.turnCount + 1,
+            activeTurnId: null,
+            lastTurnError: turnError,
+        });
+        transitions.writeEvents(context, state.activeTurnId, (events) => events.writeEvent("turn_failed", { error: turnError }));
+        return transitions.goToAwaitUserMessage();
+    }
+}
+function validateToolCallsRequested(turnId, existingToolCalls, outcome) {
+    if (typeof outcome.frameworkRunState !== "string" || outcome.frameworkRunState === "") {
+        throw new TypeError(`ToolCallsRequested for ${turnId} needs a non-empty frameworkRunState`);
+    }
+    if (outcome.toolCalls.length === 0) {
+        throw new TypeError(`ToolCallsRequested for ${turnId} needs at least one tool call`);
+    }
+    const seenIds = new Set(existingToolCalls.map((toolCall) => toolCall.toolCallId));
+    for (const requestedToolCall of outcome.toolCalls) {
+        const toolCallId = requestedToolCall.toolCallId;
+        if (toolCallId.trim() === "" || toolCallId.includes("/")) {
+            throw new TypeError(`tool call ID ${JSON.stringify(toolCallId)} is empty or contains '/'`);
+        }
+        if (seenIds.has(toolCallId)) {
+            throw new TypeError(`tool call ${toolCallId} was already requested in ${turnId}`);
+        }
+        seenIds.add(toolCallId);
+    }
+}
+/**
+ * Returns the full options of a tool Step type. With a tool call ID, the Step loads only that call's
+ * record; a movement's options replace the Step's static options, so every option is repeated here.
+ */
+function toolStepOptions(persistence, stepType, toolCallId) {
+    const loads = toolCallId === undefined
+        ? { executeLoadAttributeMaps: [persistence.agentToolCalls] }
+        : { executeLoadAttributeMapInstances: [persistence.agentToolCalls.load(toolCallId)] };
+    switch (stepType) {
+        case agentSessionStepTypes.awaitToolApproval:
+            // The deadline path rewrites PendingInterrupts, which resolve_interrupt and sibling Steps also write.
+            return { ...syncDurability, ...loads, executeLockAttributes: [persistence.pendingInterrupts.lock()] };
+        case agentSessionStepTypes.callTool:
+            return {
+                ...syncDurability,
+                ...loads,
+                executeRetry: { maximumAttempts: 3 },
+                executeFailure: ExecuteFailure.proceedTo(new StepRef(agentSessionStepTypes.recordToolFailure), toolStepOptions(persistence, agentSessionStepTypes.recordToolFailure, toolCallId)),
+            };
+        case agentSessionStepTypes.callSingleAttemptTool:
+            return {
+                ...syncDurability,
+                ...loads,
+                executeRetry: { maximumAttempts: 1 },
+                executeFailure: ExecuteFailure.proceedTo(new StepRef(agentSessionStepTypes.recordToolOutcomeUnknown), toolStepOptions(persistence, agentSessionStepTypes.recordToolOutcomeUnknown, toolCallId)),
+            };
+        case agentSessionStepTypes.recordToolFailure:
+        case agentSessionStepTypes.recordToolOutcomeUnknown:
+            return { ...syncDurability, ...loads, executeRetry: recoveryRetry };
+        default:
+            throw new TypeError(`${stepType} is not a tool Step type`);
+    }
+}
+function toolStepMovement(persistence, stepType, toolCallId) {
+    return StepMovement.of(new StepRef(stepType), toolCallId, toolStepOptions(persistence, stepType, toolCallId));
+}
+function requirePositiveResultCount(value) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new TypeError(`ResumeTurn input must be a positive integer: ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=agent-session-steps.js.map

package/dist/src/agent-session-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-steps.js","sourceRoot":"","sources":["../../src/agent-session-steps.ts"],"names":[],"mappings":"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"}

package/dist/src/agent-session-transitions.d.ts

@@ -0,0 +1,61 @@
+import { type AsyncContext, type Context, type StepDecision } from "@superdurable/dex";
+import { StreamAgentEventWriter } from "./agent-event-writer.js";
+import { type AgentFrameworkRunner, type ResolvedToolPolicy, type ToolPolicy } from "./agent-framework-runner.js";
+import { type AgentSessionPersistence } from "./agent-session-persistence.js";
+import { type AgentInterrupt, type AgentMessage, type AgentState, type AgentToolCall, type AgentUsage, type FrameworkMessage, type ToolEffect } from "./agent-session-values.js";
+export declare const agentSessionStepTypes: {
+    readonly startAgentSession: "StartAgentSession";
+    readonly awaitUserMessage: "AwaitUserMessage";
+    readonly runModel: "RunModel";
+    readonly awaitToolApproval: "AwaitToolApproval";
+    readonly callTool: "CallTool";
+    readonly callSingleAttemptTool: "CallSingleAttemptTool";
+    readonly recordToolFailure: "RecordToolFailure";
+    readonly recordToolOutcomeUnknown: "RecordToolOutcomeUnknown";
+    readonly resumeTurn: "ResumeTurn";
+    readonly recordTurnFailure: "RecordTurnFailure";
+};
+export interface AgentSessionConfig {
+    readonly flowType: string;
+    readonly toolPolicies: Readonly<Record<string, ToolPolicy>>;
+    readonly defaultToolEffect: ToolEffect;
+    readonly eventStreamCapacityBytes: number;
+    readonly interruptDeadlineMs: number | undefined;
+}
+/** Shared state reads, writes, and routing used by every session Step. */
+export declare class AgentSessionTransitions {
+    readonly persistence: AgentSessionPersistence;
+    readonly runner: AgentFrameworkRunner;
+    readonly config: AgentSessionConfig;
+    constructor(persistence: AgentSessionPersistence, runner: AgentFrameworkRunner, config: AgentSessionConfig);
+    readOptionalAgentState(context: Context): AgentState | null;
+    readAgentState(context: Context): AgentState;
+    writeAgentState(context: Context, state: AgentState): void;
+    readPendingInterrupts(context: Context): readonly AgentInterrupt[];
+    readAgentUsage(context: Context): AgentUsage;
+    readFrameworkRunState(context: Context): string | null;
+    /** Returns messages with sequences in [start, end); requires the AgentMessages load. */
+    readMessages(context: Context, start: number, end: number): AgentMessage[];
+    /** Returns the turn's tool call records in deferral order; requires the AgentToolCalls load. */
+    readTurnToolCalls(context: Context, turnId: string | null): AgentToolCall[];
+    /** Returns one tool call record; requires the AgentToolCalls load. */
+    readToolCall(context: Context, toolCallId: string): AgentToolCall;
+    /** Tells `ResumeTurn` that one tool call of the batch has a final record. */
+    publishToolCallResult(context: Context, toolCallId: string): void;
+    writeToolCall(context: Context, toolCall: AgentToolCall): void;
+    /** Appends messages, writes the advanced AgentState, and returns it. */
+    appendMessages(context: Context, state: AgentState, turnId: string, frameworkMessages: readonly FrameworkMessage[]): AgentState;
+    /** Appends the user message, opens the next turn, and moves to RunModel. */
+    beginTurn(context: Context, state: AgentState, text: string): StepDecision;
+    goToAwaitUserMessage(): StepDecision;
+    resolveToolPolicy(toolName: string, frameworkEffect?: ToolEffect): ResolvedToolPolicy;
+    recordUsage(context: Context, usage: AgentUsage, events: StreamAgentEventWriter): void;
+    createEventWriter(context: Context, turnId: string | null): StreamAgentEventWriter;
+    writeEvents(context: Context, turnId: string | null, write: (events: StreamAgentEventWriter) => void): void;
+    /** Runs an operation while recording a heartbeat every 20 seconds. */
+    runWithHeartbeats<Result>(context: AsyncContext, operation: () => Promise<Result>): Promise<Result>;
+    recordHeartbeat(context: AsyncContext): Promise<void>;
+}
+export declare function toolStepTypeForEffect(effect: ToolEffect): string;
+/** Returns the text of the failure that selected a recovery Step. */
+export declare function readRecoveryDetail(context: Context): string;