@superdurable/dex-agents 0.0.0-stage → 0.2.0

package/dist/src/agent-framework-runner.js

@@ -0,0 +1,82 @@
+// 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
+/**
+ * Returns the effective policy of one tool.
+ *
+ * Runners normally call {@link AgentTurnContext.resolveToolPolicy}. Call this function when an adapter
+ * classifies tools outside a turn, for example while building framework tool wrappers. Precedence: the
+ * tool's {@link ToolPolicy}, then `frameworkEffect`, then `defaultToolEffect`.
+ *
+ * @example
+ * ```ts
+ * const policy = resolveToolPolicy("refund_order", flow.options.toolPolicies, flow.options.defaultToolEffect);
+ * const label = policy.requiresApproval ? "needs approval" : "runs without approval";
+ * ```
+ * @param toolName - Tool name as the model calls it.
+ * @param toolPolicies - Explicit policies by tool name.
+ * @param defaultToolEffect - Effect of a tool without a policy or framework metadata.
+ * @param frameworkEffect - Effect declared by framework metadata, or `undefined`.
+ * @returns The effective policy.
+ */
+export function resolveToolPolicy(toolName, toolPolicies, defaultToolEffect, frameworkEffect) {
+    const policy = Object.hasOwn(toolPolicies, toolName) ? toolPolicies[toolName] : undefined;
+    const effect = policy?.effect ?? frameworkEffect ?? defaultToolEffect;
+    const requiresApproval = policy?.requiresApproval ?? (effect === "non_idempotent_write" || effect === "unclassified");
+    return { effect, requiresApproval };
+}
+/**
+ * Tool failure that the model should see, thrown from {@link AgentFrameworkRunner.executeDeferredToolCall}.
+ *
+ * The session records the call as `failed` with this error's message and does not retry it. Throw any
+ * other error for an unexpected failure: `CallTool` retries it and, once its attempts run out, records
+ * `failed` for a `read` tool and `outcome_unknown` for a write; `CallSingleAttemptTool` records
+ * `outcome_unknown` at once, because the write may have taken effect.
+ *
+ * @example
+ * ```ts
+ * if (response.status === 404) {
+ *   throw new ToolExecutionError(`order ${orderId} does not exist`);
+ * }
+ * ```
+ */
+export class ToolExecutionError extends Error {
+    /**
+     * Creates a tool failure.
+     * @param message - Error text recorded on the call and shown to the model.
+     * @param options - Standard error options, such as `cause`.
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ToolExecutionError";
+    }
+}
+/**
+ * Maps MCP tool annotations to a framework effect for {@link AgentTurnContext.resolveToolPolicy}.
+ *
+ * Annotations are hints from the tool server. Pass the result only for servers the application
+ * trusts; otherwise leave the effect to policies and the session default.
+ *
+ * @example
+ * ```ts
+ * const policy = turn.resolveToolPolicy(tool.name, toolEffectFromMcpToolAnnotations(tool.annotations ?? {}));
+ * ```
+ * @param annotations - The tool's MCP annotations.
+ * @returns `read` when `readOnlyHint` is `true`; otherwise `idempotent_write` when `idempotentHint` is
+ * `true`, whatever `destructiveHint` says, as in the Python core; otherwise `undefined`, so the session
+ * default applies.
+ */
+export function toolEffectFromMcpToolAnnotations(annotations) {
+    if (annotations.readOnlyHint === true) {
+        return "read";
+    }
+    if (annotations.idempotentHint === true) {
+        return "idempotent_write";
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-framework-runner.js.map

package/dist/src/agent-framework-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-framework-runner.js","sourceRoot":"","sources":["../../src/agent-framework-runner.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAmD1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,YAAkD,EAClD,iBAA6B,EAC7B,eAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,eAAe,IAAI,iBAAiB,CAAC;IACtE,MAAM,gBAAgB,GACpB,MAAM,EAAE,gBAAgB,IAAI,CAAC,MAAM,KAAK,sBAAsB,IAAI,MAAM,KAAK,cAAc,CAAC,CAAC;IAC/F,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AACtC,CAAC;AAogBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;;;;OAIG;IACH,YAAmB,OAAe,EAAE,OAAsB;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AA+ND;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gCAAgC,CAC9C,WAA+B;IAE/B,IAAI,WAAW,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,WAAW,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/agent-plans.d.ts

@@ -0,0 +1,48 @@
+import type { AgentPlan, AgentPlanTask, InteractionMode, PlanStatus } from "./agent-session-values.js";
+/**
+ * Rejection message of a call to any tool other than `write_todos` in a `planning` turn; the same text as
+ * the Python core.
+ */
+export declare const planningTurnToolRejection = "The tool call was not run: a planning turn can only call write_todos.";
+/** First line of the plan note while no plan exists; the same text as the Python core. */
+export declare const noPlanNote = "[Dex] There is no plan yet.";
+/** Last line of the plan note in a `planning` turn; the same text as the Python core. */
+export declare const planningTurnInstruction: string;
+/**
+ * Returns the user message text of a turn that `execute_plan` started.
+ *
+ * @param revision - The approved {@link AgentPlan.revision}.
+ * @returns `[Dex] The user approved plan revision <n>. Execute it and keep the task statuses current with
+ * write_todos.`, the same text as the Python core.
+ */
+export declare function buildPlanExecutionMessage(revision: number): string;
+/**
+ * Returns the text that shows the model the current plan, or `undefined` for none.
+ *
+ * A runner that honors plan mode adds it to the model input of every model call, after the context summary
+ * and before the turn's messages, as user text. It is not stored as a message, so it always shows the
+ * latest plan. The text is the same as the Python core's `build_plan_note`:
+ *
+ * ```text
+ * [Dex] The current plan, revision 2, is draft:
+ * - [completed] Look up the order
+ * - [pending] Refund the order
+ * This turn only plans: write or revise the plan with write_todos, ...
+ * ```
+ *
+ * @param plan - The {@link AgentPlan}, or `null` or `undefined` when there is none.
+ * @param interactionMode - The turn's mode; `undefined` means `chat`.
+ * @returns One line for the plan and one per task, then {@link planningTurnInstruction} in a `planning`
+ * turn, joined with newlines. {@link noPlanNote} stands for a missing or cleared plan in a `planning` turn.
+ * `undefined` when there is no plan to show outside a `planning` turn.
+ */
+export declare function buildPlanNote(plan: AgentPlan | null | undefined, interactionMode: InteractionMode | undefined): string | undefined;
+/**
+ * Returns the status of the plan that `write_todos` writes.
+ *
+ * @param tasks - The tasks written.
+ * @param interactionMode - The mode of the turn that wrote them.
+ * @returns `cleared` for no tasks, `draft` in a `planning` turn, `completed` when every task is completed,
+ * and `active` otherwise.
+ */
+export declare function planStatusAfterWrite(tasks: readonly AgentPlanTask[], interactionMode: InteractionMode | undefined): PlanStatus;

package/dist/src/agent-plans.js

@@ -0,0 +1,86 @@
+// 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
+/**
+ * Rejection message of a call to any tool other than `write_todos` in a `planning` turn; the same text as
+ * the Python core.
+ */
+export const planningTurnToolRejection = "The tool call was not run: a planning turn can only call write_todos.";
+/** First line of the plan note while no plan exists; the same text as the Python core. */
+export const noPlanNote = "[Dex] There is no plan yet.";
+/** Last line of the plan note in a `planning` turn; the same text as the Python core. */
+export const planningTurnInstruction = "This turn only plans: write or revise the plan with write_todos, and do not do or claim any of its " +
+    "tasks. The user reviews the plan before it runs.";
+/**
+ * Returns the user message text of a turn that `execute_plan` started.
+ *
+ * @param revision - The approved {@link AgentPlan.revision}.
+ * @returns `[Dex] The user approved plan revision <n>. Execute it and keep the task statuses current with
+ * write_todos.`, the same text as the Python core.
+ */
+export function buildPlanExecutionMessage(revision) {
+    return (`[Dex] The user approved plan revision ${revision}. ` +
+        "Execute it and keep the task statuses current with write_todos.");
+}
+/**
+ * Returns the text that shows the model the current plan, or `undefined` for none.
+ *
+ * A runner that honors plan mode adds it to the model input of every model call, after the context summary
+ * and before the turn's messages, as user text. It is not stored as a message, so it always shows the
+ * latest plan. The text is the same as the Python core's `build_plan_note`:
+ *
+ * ```text
+ * [Dex] The current plan, revision 2, is draft:
+ * - [completed] Look up the order
+ * - [pending] Refund the order
+ * This turn only plans: write or revise the plan with write_todos, ...
+ * ```
+ *
+ * @param plan - The {@link AgentPlan}, or `null` or `undefined` when there is none.
+ * @param interactionMode - The turn's mode; `undefined` means `chat`.
+ * @returns One line for the plan and one per task, then {@link planningTurnInstruction} in a `planning`
+ * turn, joined with newlines. {@link noPlanNote} stands for a missing or cleared plan in a `planning` turn.
+ * `undefined` when there is no plan to show outside a `planning` turn.
+ */
+export function buildPlanNote(plan, interactionMode) {
+    const isPlanning = interactionMode === "planning";
+    let lines;
+    if (plan == null || plan.status === "cleared") {
+        if (!isPlanning) {
+            return undefined;
+        }
+        lines = [noPlanNote];
+    }
+    else {
+        lines = [
+            `[Dex] The current plan, revision ${plan.revision}, is ${plan.status}:`,
+            ...plan.tasks.map((task) => `- [${task.status}] ${task.content}`),
+        ];
+    }
+    if (isPlanning) {
+        lines.push(planningTurnInstruction);
+    }
+    return lines.join("\n");
+}
+/**
+ * Returns the status of the plan that `write_todos` writes.
+ *
+ * @param tasks - The tasks written.
+ * @param interactionMode - The mode of the turn that wrote them.
+ * @returns `cleared` for no tasks, `draft` in a `planning` turn, `completed` when every task is completed,
+ * and `active` otherwise.
+ */
+export function planStatusAfterWrite(tasks, interactionMode) {
+    if (tasks.length === 0) {
+        return "cleared";
+    }
+    if (interactionMode === "planning") {
+        return "draft";
+    }
+    return tasks.every((task) => task.status === "completed") ? "completed" : "active";
+}
+//# sourceMappingURL=agent-plans.js.map

package/dist/src/agent-plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plans.js","sourceRoot":"","sources":["../../src/agent-plans.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAI1D;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,uEAAuE,CAAC;AAEjH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAExD,yFAAyF;AACzF,MAAM,CAAC,MAAM,uBAAuB,GAClC,qGAAqG;IACrG,kDAAkD,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,CACL,yCAAyC,QAAQ,IAAI;QACrD,iEAAiE,CAClE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAkC,EAClC,eAA4C;IAE5C,MAAM,UAAU,GAAG,eAAe,KAAK,UAAU,CAAC;IAClD,IAAI,KAAe,CAAC;IACpB,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG;YACN,oCAAoC,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,MAAM,GAAG;YACvE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;SAClE,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA+B,EAC/B,eAA4C;IAE5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrF,CAAC"}

package/dist/src/agent-session-cancellation-steps.d.ts

@@ -0,0 +1,28 @@
+import { type AsyncContext, type Context, type Step, type StepDecision, type StepOptions } from "@superdurable/dex";
+import { type AgentSessionTransitions } from "./agent-session-transitions.js";
+/**
+ * Finishes a turn that `cancel_turn` stopped, from the state that committed.
+ *
+ * `cancel_turn` cancels the Steps that call a model or wait, then moves here with the turn ID. When the model
+ * call or compaction was cancelled, it moves to `ApplyTurnControl`. Otherwise `ResumeTurn` still waits: this
+ * Step records each call whose wait was cancelled, hands each abandoned task to `CancelToolTask`, and ends, so
+ * `ResumeTurn` ends the turn once every started tool Step finishes.
+ */
+export declare class FinishTurnCancellationStep implements Step<string> {
+    private readonly transitions;
+    readonly inputCodec: import("@superdurable/dex").Codec<string>;
+    constructor(transitions: AgentSessionTransitions);
+    getStepType(): string;
+    getStepOptions(): StepOptions;
+    execute(context: Context, turnId: string): StepDecision;
+    private finishWaitingToolCalls;
+}
+/** Asks the runner to cancel one task that `cancel_turn` abandoned, then records it `outcome_unknown`. */
+export declare class CancelToolTaskStep implements Step<string> {
+    private readonly transitions;
+    readonly inputCodec: import("@superdurable/dex").Codec<string>;
+    constructor(transitions: AgentSessionTransitions);
+    getStepType(): string;
+    getStepOptions(): StepOptions;
+    execute(context: AsyncContext, toolCallId: string): Promise<StepDecision>;
+}

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

@@ -0,0 +1,154 @@
+// 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 { deadEnd, goToMany, stringCodec, } from "@superdurable/dex";
+import { noPendingToolQuestion, questionAnswerMovement, questionInterruptId, toolStepMovement, toolStepOptions, } from "./agent-session-steps.js";
+import { agentSessionStepTypes, cancelledToolCall, isAbandonedToolTask, isCancellableByTurnControl, } from "./agent-session-transitions.js";
+import { isFinalToolCallStatus, toolTaskAbandonedError } from "./agent-session-values.js";
+// Recovery Steps must eventually run; cap their backoff so a returning Worker picks them up quickly.
+const recoveryRetry = { maximumIntervalMs: 5_000 };
+/**
+ * Finishes a turn that `cancel_turn` stopped, from the state that committed.
+ *
+ * `cancel_turn` cancels the Steps that call a model or wait, then moves here with the turn ID. When the model
+ * call or compaction was cancelled, it moves to `ApplyTurnControl`. Otherwise `ResumeTurn` still waits: this
+ * Step records each call whose wait was cancelled, hands each abandoned task to `CancelToolTask`, and ends, so
+ * `ResumeTurn` ends the turn once every started tool Step finishes.
+ */
+export class FinishTurnCancellationStep {
+    transitions;
+    inputCodec = stringCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.finishTurnCancellation;
+    }
+    getStepOptions() {
+        const persistence = this.transitions.persistence;
+        // The cancel_turn RPC holds both locks, so this Step reads the state that RPC committed.
+        return {
+            waitForDurability: "sync",
+            executeDurability: "sync",
+            executeRetry: recoveryRetry,
+            executeLoadAttributeMaps: [persistence.agentToolCalls],
+            executeLockAttributes: [persistence.turnCancellationRequest.lock(), persistence.pendingInterrupts.lock()],
+        };
+    }
+    execute(context, turnId) {
+        const transitions = this.transitions;
+        const state = transitions.readOptionalAgentState(context);
+        if (state === null || state.activeTurnId !== turnId || !transitions.isTurnCancelled(context, turnId)) {
+            // The turn ended before the cancellation applied.
+            return deadEnd();
+        }
+        if (state.status !== "running_tools") {
+            // cancel_turn cancelled the model call or compaction, so no other Step ends the turn.
+            return transitions.goToApplyTurnControl(context);
+        }
+        // ResumeTurn waits for every result and ends the turn; started tool Steps still finish.
+        return this.finishWaitingToolCalls(context, turnId);
+    }
+    finishWaitingToolCalls(context, turnId) {
+        const transitions = this.transitions;
+        const persistence = transitions.persistence;
+        const interrupts = transitions.readPendingInterrupts(context);
+        const cancelledInterruptIds = new Set();
+        const movements = [];
+        for (const toolCall of transitions.readTurnToolCalls(context, turnId)) {
+            const interrupt = waitingInterrupt(toolCall);
+            if (interrupt !== null) {
+                if (context.channelSize(persistence.interruptResolutions, interrupt.interruptId) > 0) {
+                    // The answer committed first; a new wait applies it, and its next Step decides.
+                    if ((toolCall.cancellationReason ?? null) === null) {
+                        // The mark keeps a later FinishTurnCancellation from starting a second wait.
+                        const handedBack = { ...toolCall, cancellationReason: "turn_cancelled" };
+                        transitions.writeToolCall(context, handedBack);
+                        movements.push(handedBack.status === "awaiting_approval"
+                            ? toolStepMovement(persistence, agentSessionStepTypes.awaitToolApproval, handedBack.toolCallId)
+                            : questionAnswerMovement(persistence, handedBack));
+                    }
+                    continue;
+                }
+                if (interrupts.some((pending) => pending.interruptId === interrupt.interruptId)) {
+                    cancelledInterruptIds.add(interrupt.interruptId);
+                    transitions.writeInterruptCancelled(context, turnId, interrupt.interruptId, interrupt.kind, "turn_cancelled");
+                }
+            }
+            if (isAbandonedToolTask(toolCall)) {
+                if ((toolCall.cancellationReason ?? null) === null) {
+                    const abandoned = {
+                        ...toolCall,
+                        status: "waiting_for_task",
+                        cancellationReason: "turn_cancelled",
+                        taskAnswerPending: false,
+                        ...noPendingToolQuestion,
+                    };
+                    transitions.writeToolCall(context, abandoned);
+                    movements.push(toolStepMovement(persistence, agentSessionStepTypes.cancelToolTask, toolCall.toolCallId));
+                }
+                continue;
+            }
+            if (isCancellableByTurnControl(toolCall)) {
+                transitions.finishToolCall(context, cancelledToolCall(toolCall, "turn_cancelled"));
+            }
+        }
+        if (cancelledInterruptIds.size > 0) {
+            persistence.pendingInterrupts.set(context, interrupts.filter((pending) => !cancelledInterruptIds.has(pending.interruptId)));
+        }
+        return movements.length > 0 ? goToMany(...movements) : deadEnd();
+    }
+}
+/** Asks the runner to cancel one task that `cancel_turn` abandoned, then records it `outcome_unknown`. */
+export class CancelToolTaskStep {
+    transitions;
+    inputCodec = stringCodec;
+    constructor(transitions) {
+        this.transitions = transitions;
+    }
+    getStepType() {
+        return agentSessionStepTypes.cancelToolTask;
+    }
+    getStepOptions() {
+        return toolStepOptions(this.transitions.persistence, agentSessionStepTypes.cancelToolTask);
+    }
+    async execute(context, toolCallId) {
+        const transitions = this.transitions;
+        const toolCall = transitions.readToolCall(context, toolCallId);
+        if (isFinalToolCallStatus(toolCall.status)) {
+            return deadEnd();
+        }
+        if ((toolCall.taskId ?? null) === null || (toolCall.cancellationReason ?? null) === null) {
+            throw new Error(`tool call ${toolCallId} has no abandoned task`);
+        }
+        const cancelToolTask = transitions.runner.cancelToolTask;
+        if (cancelToolTask !== undefined) {
+            const cancellation = {
+                flowId: context.flowId,
+                toolCall,
+                idempotencyKey: `${context.flowId}/${toolCall.turnId}/${toolCall.toolCallId}`,
+                attempt: context.attempt,
+                cancellationSignal: context.cancellationSignal,
+                heartbeat: () => transitions.recordHeartbeat(context),
+            };
+            await transitions.runWithHeartbeats(context, () => cancelToolTask.call(transitions.runner, cancellation));
+        }
+        transitions.finishToolCall(context, { ...toolCall, status: "outcome_unknown", error: toolTaskAbandonedError });
+        return deadEnd();
+    }
+}
+/** Returns the interrupt a waiting record's Step waits on, or `null`. */
+function waitingInterrupt(toolCall) {
+    if (toolCall.status === "awaiting_approval") {
+        return { interruptId: toolCall.toolCallId, kind: "tool_approval" };
+    }
+    if (toolCall.status === "awaiting_answer") {
+        return { interruptId: questionInterruptId(toolCall), kind: "question" };
+    }
+    return null;
+}
+//# sourceMappingURL=agent-session-cancellation-steps.js.map

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

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

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

@@ -0,0 +1,105 @@
+import { type Codec } from "@superdurable/dex";
+import type { AgentEvent, AgentInterrupt, AgentInterruptResolution, AgentMessage, AgentMessageChunk, AgentMessageChunkRange, AgentMessageIndex, AgentMessagesPage, AgentPlan, AgentPlanTask, AgentSessionStartInput, AgentSnapshot, AgentState, AgentToolCallRecord, AgentUsage, AgentUserMessage, AnswerQuestionRequest, CancelTurnRequest, DeleteQueuedMessageRequest, ExecutePlanRequest, CompactContextInput, ContextSummary, ListAgentMessagesInput, PendingUserMessage, PlanExecutionRequest, QuestionAnswer, ResolveInterruptInput, SteerUserMessageRequest, ToolCallCancellation, ToolCallCompleted, TurnCancellationRequest, TurnControlRequest, SessionSettings, TurnReplySequence, TurnSessionSettings, UpdateSessionSettingsRequest } from "./agent-session-values.js";
+export declare function encodeAgentSessionStartInput(value: AgentSessionStartInput): unknown;
+export declare function decodeAgentSessionStartInput(value: unknown): AgentSessionStartInput;
+export declare function encodeSessionSettings(value: SessionSettings): unknown;
+export declare function decodeSessionSettings(value: unknown): SessionSettings;
+export declare function encodeUpdateSessionSettingsRequest(value: UpdateSessionSettingsRequest): unknown;
+export declare function decodeUpdateSessionSettingsRequest(value: unknown): UpdateSessionSettingsRequest;
+export declare function encodeTurnSessionSettings(value: TurnSessionSettings): unknown;
+export declare function decodeTurnSessionSettings(value: unknown): TurnSessionSettings;
+export declare function encodeAgentState(value: AgentState): unknown;
+export declare function decodeAgentState(value: unknown): AgentState;
+export declare function encodeAgentMessage(value: AgentMessage): unknown;
+export declare function decodeAgentMessage(value: unknown): AgentMessage;
+export declare function encodeAgentToolCall(value: AgentToolCallRecord): unknown;
+export declare function decodeAgentToolCall(value: unknown): AgentToolCallRecord;
+export declare function encodeQuestionAnswer(value: QuestionAnswer): unknown;
+export declare function decodeQuestionAnswer(value: unknown): QuestionAnswer;
+export declare function encodeAgentInterrupt(value: AgentInterrupt): unknown;
+export declare function decodeAgentInterrupt(value: unknown): AgentInterrupt;
+export declare function encodeAgentInterruptResolution(value: AgentInterruptResolution): unknown;
+export declare function decodeAgentInterruptResolution(value: unknown): AgentInterruptResolution;
+export declare function encodeAnswerQuestionRequest(value: AnswerQuestionRequest): unknown;
+export declare function decodeAnswerQuestionRequest(value: unknown): AnswerQuestionRequest;
+export declare function encodeAgentUsage(value: AgentUsage): unknown;
+export declare function decodeAgentUsage(value: unknown): AgentUsage;
+export declare function encodeAgentUserMessage(value: AgentUserMessage): unknown;
+export declare function decodeAgentUserMessage(value: unknown): AgentUserMessage;
+export declare function encodeAgentPlan(value: AgentPlan): unknown;
+export declare function decodeAgentPlan(value: unknown): AgentPlan;
+export declare function encodeAgentPlanTask(value: AgentPlanTask): unknown;
+export declare function decodeAgentPlanTask(value: unknown): AgentPlanTask;
+export declare function encodePlanRevisionRequest(value: ExecutePlanRequest | PlanExecutionRequest): unknown;
+export declare function decodePlanRevisionRequest(value: unknown): PlanExecutionRequest;
+export declare function encodePendingUserMessage(value: PendingUserMessage): unknown;
+export declare function decodePendingUserMessage(value: unknown): PendingUserMessage;
+export declare function encodeSteerUserMessageRequest(value: SteerUserMessageRequest): unknown;
+export declare function decodeSteerUserMessageRequest(value: unknown): SteerUserMessageRequest;
+export declare function encodeDeleteQueuedMessageRequest(value: DeleteQueuedMessageRequest): unknown;
+export declare function decodeDeleteQueuedMessageRequest(value: unknown): DeleteQueuedMessageRequest;
+export declare function encodeCancelTurnRequest(value: CancelTurnRequest): unknown;
+export declare function decodeCancelTurnRequest(value: unknown): CancelTurnRequest;
+export declare function encodeTurnControlRequest(value: TurnControlRequest): unknown;
+export declare function decodeTurnControlRequest(value: unknown): TurnControlRequest;
+export declare function encodeTurnCancellationRequest(value: TurnCancellationRequest): unknown;
+export declare function decodeTurnCancellationRequest(value: unknown): TurnCancellationRequest;
+export declare function encodeToolCallCancellation(value: ToolCallCancellation): unknown;
+export declare function decodeToolCallCancellation(value: unknown): ToolCallCancellation;
+export declare function encodeToolCallCompleted(value: ToolCallCompleted): unknown;
+export declare function decodeToolCallCompleted(value: unknown): ToolCallCompleted;
+export declare function encodeAgentEvent(value: AgentEvent): unknown;
+export declare function decodeAgentEvent(value: unknown): AgentEvent;
+export declare function encodeResolveInterruptInput(value: ResolveInterruptInput): unknown;
+export declare function decodeResolveInterruptInput(value: unknown): ResolveInterruptInput;
+export declare function encodeContextSummary(value: ContextSummary): unknown;
+export declare function decodeContextSummary(value: unknown): ContextSummary;
+export declare function encodeAgentMessageChunk(value: AgentMessageChunk): unknown;
+export declare function decodeAgentMessageChunk(value: unknown): AgentMessageChunk;
+export declare function encodeAgentMessageChunkRange(value: AgentMessageChunkRange): unknown;
+export declare function decodeAgentMessageChunkRange(value: unknown): AgentMessageChunkRange;
+export declare function encodeAgentMessageIndex(value: AgentMessageIndex): unknown;
+export declare function decodeAgentMessageIndex(value: unknown): AgentMessageIndex;
+export declare function encodeTurnReplySequence(value: TurnReplySequence): unknown;
+export declare function decodeTurnReplySequence(value: unknown): TurnReplySequence;
+export declare function encodeCompactContextInput(value: CompactContextInput): unknown;
+export declare function decodeCompactContextInput(value: unknown): CompactContextInput;
+export declare function encodeAgentSnapshot(value: AgentSnapshot): unknown;
+export declare function decodeAgentSnapshot(value: unknown): AgentSnapshot;
+export declare function encodeListAgentMessagesInput(value: ListAgentMessagesInput): unknown;
+export declare function decodeListAgentMessagesInput(value: unknown): ListAgentMessagesInput;
+export declare function encodeAgentMessagesPage(value: AgentMessagesPage): unknown;
+export declare function decodeAgentMessagesPage(value: unknown): AgentMessagesPage;
+export declare const agentSessionStartInputCodec: Codec<AgentSessionStartInput>;
+export declare const agentStateCodec: Codec<AgentState>;
+export declare const agentMessageCodec: Codec<AgentMessage>;
+export declare const agentToolCallCodec: Codec<AgentToolCallRecord>;
+export declare const agentInterruptListCodec: Codec<readonly AgentInterrupt[]>;
+export declare const agentInterruptResolutionCodec: Codec<AgentInterruptResolution>;
+export declare const agentUsageCodec: Codec<AgentUsage>;
+export declare const agentUserMessageCodec: Codec<AgentUserMessage>;
+export declare const agentPlanCodec: Codec<AgentPlan>;
+export declare const planExecutionRequestCodec: Codec<PlanExecutionRequest>;
+export declare const executePlanRequestCodec: Codec<ExecutePlanRequest>;
+export declare const toolCallCompletedCodec: Codec<ToolCallCompleted>;
+export declare const agentEventCodec: Codec<AgentEvent>;
+export declare const resolveInterruptInputCodec: Codec<ResolveInterruptInput>;
+export declare const answerQuestionRequestCodec: Codec<AnswerQuestionRequest>;
+export declare const steerUserMessageRequestCodec: Codec<SteerUserMessageRequest>;
+export declare const deleteQueuedMessageRequestCodec: Codec<DeleteQueuedMessageRequest>;
+export declare const cancelTurnRequestCodec: Codec<CancelTurnRequest>;
+export declare const turnControlRequestCodec: Codec<TurnControlRequest>;
+export declare const turnCancellationRequestCodec: Codec<TurnCancellationRequest>;
+export declare const toolCallCancellationCodec: Codec<ToolCallCancellation>;
+export declare const agentSnapshotCodec: Codec<AgentSnapshot>;
+export declare const listAgentMessagesInputCodec: Codec<ListAgentMessagesInput>;
+export declare const agentMessagesPageCodec: Codec<AgentMessagesPage>;
+export declare const sessionSettingsCodec: Codec<Readonly<Record<string, unknown>>>;
+export declare const turnSessionSettingsCodec: Codec<TurnSessionSettings>;
+export declare const updateSessionSettingsRequestCodec: Codec<UpdateSessionSettingsRequest>;
+export declare const agentMessageChunkCodec: Codec<AgentMessageChunk>;
+export declare const agentMessageIndexCodec: Codec<AgentMessageIndex>;
+export declare const turnReplySequenceCodec: Codec<TurnReplySequence>;
+export declare const contextSummaryCodec: Codec<ContextSummary>;
+/** Input of `CompactContext` and `RecordTurnFailure`: a `CompactContextInput`, or `RunModel`'s JSON `null` as `undefined`. */
+export declare const turnFailureRouteInputCodec: Codec<CompactContextInput | undefined>;