@trigger.dev/sdk 4.5.16 → 4.6.0

package/dist/esm/imports/ai-runtime.js

@@ -10,7 +10,7 @@
 // VALUES only — type-only imports from `ai` erase and don't trip TS1479, so
 // they stay as direct `import type { … } from "ai"` at their use sites.
 // @ts-ignore
-import { convertToModelMessages, dynamicTool, generateId, getToolName, isToolUIPart, jsonSchema, readUIMessageStream, stepCountIs, tool, zodSchema, } from "ai";
+import { convertToModelMessages, dynamicTool, generateId, getToolName, isToolUIPart, jsonSchema, readUIMessageStream, stepCountIs, streamText, tool, zodSchema, } from "ai";
 // @ts-ignore
-export { convertToModelMessages, dynamicTool, generateId, getToolName, isToolUIPart, jsonSchema, readUIMessageStream, stepCountIs, tool, zodSchema, };
+export { convertToModelMessages, dynamicTool, generateId, getToolName, isToolUIPart, jsonSchema, readUIMessageStream, stepCountIs, streamText, tool, zodSchema, };
 //# sourceMappingURL=ai-runtime.js.map

package/dist/esm/imports/ai-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-runtime.js","sourceRoot":"","sources":["../../../src/imports/ai-runtime.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AAExE,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,IAAI,EACJ,SAAS,GACV,MAAM,IAAI,CAAC;AAEZ,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,IAAI,EACJ,SAAS,GACV,CAAC"}
+{"version":3,"file":"ai-runtime.js","sourceRoot":"","sources":["../../../src/imports/ai-runtime.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AAExE,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,IAAI,EACJ,SAAS,GACV,MAAM,IAAI,CAAC;AAEZ,aAAa;AACb,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,IAAI,EACJ,SAAS,GACV,CAAC"}

package/dist/esm/v3/ai-shared.d.ts

@@ -139,3 +139,18 @@ export declare function slimSubmitMessageForWire<TMsg extends UIMessage | undefi
  * long ID degrades to "not filterable by chat" rather than failing to start.
  */
 export declare function chatRunTags(chatId: string, userTags?: string[]): string[];
+/**
+ * A session body that ends without a turn-complete is only terminal when the
+ * server says the session settled — otherwise the turn is still running and
+ * the connection was lost (long-poll window closed, proxy restarted). Both
+ * transports resubscribe from the last event id, bounded so a permanently
+ * empty stream can't spin.
+ */
+export declare const MAX_EOF_RESUBSCRIBES = 5;
+/**
+ * Backoff before the nth (1-based) EOF resubscribe, jittered so many clients
+ * dropped by the same window don't reconnect in lockstep. Resolves early on
+ * abort — otherwise a stop landing mid-backoff leaves the stream open for the
+ * rest of it.
+ */
+export declare function waitBeforeEofResubscribe(attempt: number, signal: AbortSignal): Promise<void>;

package/dist/esm/v3/ai-shared.js

@@ -172,4 +172,37 @@ export function chatRunTags(chatId, userTags = []) {
     const tags = chatTag.length <= MAX_RUN_TAG_LENGTH ? [chatTag, ...userTags] : [...userTags];
     return tags.slice(0, MAX_RUN_TAGS);
 }
+/**
+ * A session body that ends without a turn-complete is only terminal when the
+ * server says the session settled — otherwise the turn is still running and
+ * the connection was lost (long-poll window closed, proxy restarted). Both
+ * transports resubscribe from the last event id, bounded so a permanently
+ * empty stream can't spin.
+ */
+export const MAX_EOF_RESUBSCRIBES = 5;
+/**
+ * Backoff before the nth (1-based) EOF resubscribe, jittered so many clients
+ * dropped by the same window don't reconnect in lockstep. Resolves early on
+ * abort — otherwise a stop landing mid-backoff leaves the stream open for the
+ * rest of it.
+ */
+export function waitBeforeEofResubscribe(attempt, signal) {
+    // An already-aborted signal never fires `abort` again, so a listener added
+    // here would wait out the whole backoff.
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        let timer;
+        const done = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", done);
+            resolve();
+        };
+        const backoff = Math.min(100 * 2 ** (attempt - 1), 5_000);
+        timer = setTimeout(done, backoff * (0.5 + Math.random() * 0.5));
+        signal.addEventListener("abort", done);
+        if (signal.aborted)
+            done();
+    });
+}
 //# sourceMappingURL=ai-shared.js.map

package/dist/esm/v3/ai-shared.js.map

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

package/dist/esm/v3/ai.d.ts

@@ -1,5 +1,6 @@
-import { type AnyTask, type Task, type ChatSnapshotV1, type ApiClientConfiguration, type inferSchemaIn, type inferSchemaOut, type MachinePresetName, type RealtimeDefinedInputStream, type RealtimeDefinedStream, type SessionTriggerConfig, type TaskIdentifier, type TaskOptions, type TaskRunContext, type TaskSchema, type TaskWithSchema, type AnySessionChannel, type SessionChannelName } from "@trigger.dev/core/v3";
-import type { FinishReason, LanguageModelUsage, ModelMessage, ProviderMetadata, Tool, ToolSet, UIMessage, UIMessageChunk, UIMessageStreamOptions } from "ai";
+import { type AnyTask, type Task, type ApiClientConfiguration, type inferSchemaIn, type inferSchemaOut, type MachinePresetName, type RealtimeDefinedInputStream, type RealtimeDefinedStream, type TaskIdentifier, type TaskOptions, type TaskRunContext, type TaskSchema, type TaskWithSchema, type AnySessionChannel, type SessionChannelName } from "@trigger.dev/core/v3";
+import type { streamText as aiStreamTextSignature, FinishReason, LanguageModelUsage, ModelMessage, SystemModelMessage, ProviderMetadata, Tool, ToolSet, UIMessage, UIMessageChunk, UIMessageStreamOptions } from "ai";
+import { type TranscriptLoadResult, type TranscriptStorage } from "./transcriptStorage.js";
 import { type ChatInputChunk, type ChatTaskWirePayload, type InferChatClientData, type InferChatUIMessage, type InferChatUIMessageFromTools, PENDING_MESSAGE_INJECTED_TYPE, upsertIncomingMessage } from "./ai-shared.js";
 import { locals } from "./locals.js";
 import type { ResolvedPrompt } from "./prompt.js";
@@ -11,7 +12,8 @@ type ToolCallOptions = {
     experimental_context?: unknown;
     context?: unknown;
 };
-import { type SessionChannelHandleFor } from "./sessions.js";
+import { type ChatVersionSkewPolicy } from "./chatVersionSkew.js";
+import { type SessionChannelHandleFor, type SessionTriggerConfigInput } from "./sessions.js";
 /** Re-export for typing `ctx` in `chat.agent` hooks without importing `@trigger.dev/core`. */
 export type { TaskRunContext } from "@trigger.dev/core/v3";
 export type ToolCallExecutionOptions = {
@@ -32,8 +34,8 @@ type ChatTurnContext<TClientData = unknown> = {
     continuation: boolean;
     clientData?: TClientData;
 };
-export declare function __setReadChatSnapshotImplForTests(impl: ReadChatSnapshotImpl | undefined): void;
-export declare function __setWriteChatSnapshotImplForTests(impl: WriteChatSnapshotImpl | undefined): void;
+export { __readChatSnapshotProductionPathForTests, __setReadChatSnapshotImplForTests, __setWriteChatSnapshotImplForTests, __writeChatSnapshotProductionPathForTests, } from "./chatSnapshotIo.js";
+export { defaultStorage, memoryTranscriptStorage, reduceTranscriptChanges, snapshotTranscriptStorage, type LoadContextEvent, type MemoryTranscriptStorage, type TranscriptChange, type TranscriptChangeReason, type TranscriptChangeset, type TranscriptCursors, type TranscriptLoadOptions, type TranscriptLoadResult, type TranscriptScope, type TranscriptState, type TranscriptStorage, type TranscriptStorageContext, } from "./transcriptStorage.js";
 type ReplaySessionOutTailImpl = <TUIMessage extends UIMessage>(sessionId: string, options?: {
     lastEventId?: string;
 }) => Promise<ReplaySessionOutTailResult<TUIMessage>>;
@@ -147,6 +149,41 @@ export declare const ai: {
  * ```
  */
 declare function createChatAccessToken<TTask extends AnyTask>(taskId: TaskIdentifier<TTask>): Promise<string>;
+/**
+ * Register work that must land before anything from this turn reaches the
+ * frontend.
+ *
+ * Like {@link chatDefer} the work starts immediately and is never awaited by
+ * the hook that registered it, so it runs alongside the model and costs no
+ * time to first token. Unlike `chat.defer`, the output stream waits for it:
+ * no chunk of the answer is written to the session until it settles. That
+ * makes it the right home for a write the next page load has to see (a
+ * conversation row, a message insert), because a reader that can see the
+ * answer can also see what the write persisted.
+ *
+ * Reach for `chat.defer` instead when the timing does not matter for a
+ * reload: analytics, audit logs, search-index updates.
+ *
+ * This is not a consistency barrier for the turn. The work is still in flight
+ * while the model runs, so a tool, a `prepareStep`, or anything else executing
+ * during the turn can still read the state as it was before the write. It
+ * orders the write against what the frontend can see, nothing more. When the
+ * turn's own code has to read the write back, `await` it instead and accept
+ * the cost.
+ *
+ * A write registered here that fails, or outlasts the internal timeout, lets
+ * the stream through rather than stalling the conversation.
+ *
+ * @example
+ * ```ts
+ * onTurnStart: async ({ chatId, uiMessages }) => {
+ *   chat.deferBeforeOutput(
+ *     db.chat.update({ where: { id: chatId }, data: { messages: uiMessages } })
+ *   );
+ * },
+ * ```
+ */
+declare function chatDeferBeforeOutput(promiseOrFn: Promise<unknown> | (() => Promise<unknown>)): void;
 /**
  * A stream writer passed to chat lifecycle callbacks (`onPreload`, `onChatStart`,
  * `onTurnStart`, `onTurnComplete`, `onCompacted`).
@@ -201,7 +238,7 @@ export type ChatTaskPayload<TClientData = unknown> = {
      *   to short-circuit the LLM call when an action doesn't need a response.
      * - `"close"`: The chat session is being closed (internal; `run()` is not called).
      */
-    trigger: "submit-message" | "regenerate-message" | "preload" | "action" | "close";
+    trigger: "submit-message" | "regenerate-message" | "preload" | "action" | "action-turn" | "close";
     /** The ID of the message to regenerate (only for `"regenerate-message"`) */
     messageId?: string;
     /** Custom data from the frontend (passed via `metadata` on `sendMessage()` or the transport). */
@@ -242,6 +279,16 @@ export type ChatTaskRunPayload<TClientData = unknown, TTools extends ToolSet = T
      * Use for tags, metadata, parent run links, or any API that needs the full run record.
      */
     ctx: TaskRunContext;
+    /**
+     * `streamText` with this agent's managed options already applied: the
+     * prompt from `chat.prompt.set()`, the skill tools, telemetry, and the
+     * `prepareStep` that delivers steering, compaction and injected context.
+     *
+     * Prefer it over importing `streamText` from `ai`. The imported one takes
+     * none of that unless you spread `chat.toStreamTextOptions()` yourself, and
+     * forgetting the spread fails silently.
+     */
+    streamText: AiStreamTextFn;
     /** Token usage from the previous turn. Undefined on turn 0. */
     previousTurnUsage?: LanguageModelUsage;
     /** Cumulative token usage across all completed turns so far. */
@@ -838,6 +885,12 @@ export declare function buildSkillTools(skills: ResolvedSkill[]): Record<string,
  * Options for {@link toStreamTextOptions}.
  */
 export type ToStreamTextOptionsOptions = {
+    /**
+     * A base system prompt, used when `chat.prompt.set()` has not supplied one.
+     * `chat.agent({ system })` and a `system` passed to the managed `streamText`
+     * both arrive here.
+     */
+    system?: string | SystemModelMessage;
     /** Additional telemetry metadata merged into `experimental_telemetry.metadata`. */
     telemetry?: Record<string, string>;
     /**
@@ -908,6 +961,23 @@ export type SystemCacheControl = {
  *
  * If no prompt has been set, returns `{}` (no-op spread).
  */
+/**
+ * The AI SDK's own `streamText` signature, borrowed rather than restated.
+ *
+ * The peer range spans `ai` v5, v6 and v7, whose `streamText` options differ.
+ * Describing the shape here would drift against all three; `typeof` resolves to
+ * whichever version the user installed, so generics, overloads and tool
+ * inference are exactly theirs.
+ */
+type AiStreamTextFn = typeof aiStreamTextSignature;
+/**
+ * The `streamText` handed to a `chat.agent` `run()`, carrying the agent's
+ * managed options.
+ *
+ * Exported so a loop factored out of `run` can take it as a parameter and keep
+ * them: `function loop(messages: ModelMessage[], streamText: ChatStreamText)`.
+ */
+export type ChatStreamText = AiStreamTextFn;
 declare function toStreamTextOptions(options?: ToStreamTextOptionsOptions): Record<string, unknown>;
 /**
  * Options for `pipeChat`.
@@ -953,6 +1023,37 @@ export type ChatUIMessageStreamOptions<TUIM extends UIMessage = UIMessage> = Omi
 type UIMessageStreamable = {
     toUIMessageStream: (...args: any[]) => AsyncIterable<unknown> | ReadableStream<unknown>;
 };
+declare const actionTurnBrand: unique symbol;
+/**
+ * The marker `onAction` returns to have a turn run on the history it just
+ * edited. Produce it with {@link chat.turn}.
+ */
+export type ActionTurn = {
+    readonly [actionTurnBrand]: true;
+};
+/**
+ * Turn the current action into a turn.
+ *
+ * Return it from `onAction` after editing history. The action's own work is
+ * finished first (the edit is applied and snapshotted), then a turn runs on the
+ * result exactly as a message turn does: `onTurnStart`, `run()` with the edited
+ * history, `onBeforeTurnComplete`, `onTurnComplete`, and the turn counter
+ * advances. That gives the answer everything a turn has, the system prompt,
+ * tools, steering, compaction, injected instructions and persistence, with no
+ * action-specific handling.
+ *
+ * @example
+ * ```ts
+ * onAction: async ({ action }) => {
+ *   if (action.type === "regenerate") {
+ *     chat.history.slice(0, -1);
+ *     return chat.turn();
+ *   }
+ *   if (action.type === "undo") chat.history.slice(0, -2); // no turn
+ * },
+ * ```
+ */
+declare function chatTurn(): ActionTurn;
 /**
  * Pipes a chat stream to the realtime stream, making it available to the
  * `TriggerChatTransport` on the frontend.
@@ -1097,8 +1198,9 @@ export type RecoveryPendingToolCall = {
  * `chat.endRun()` with no buffered user messages, fresh chat, OOM retry
  * after a successful turn-complete with no in-flight tail).
  *
- * Does NOT fire when `hydrateMessages` is registered (the customer owns
- * persistence; recovery decisions live in their own DB query).
+ * Fires regardless of who owns the model's context. With `hydrateMessages`
+ * or a storage `loadContext`, the recovered tail reaches that hook in
+ * `previousMessages` on the next turn.
  */
 export type RecoveryBootEvent<TUIM extends UIMessage = UIMessage> = {
     /** Task run context — same as `task({ run })` second-argument `ctx`. */
@@ -1167,8 +1269,9 @@ export type RecoveryBootResult<TUIM extends UIMessage = UIMessage> = {
      * context, mutate its tool parts to inject synthesized results,
      * collapse history, etc.
      *
-     * Ignored when `hydrateMessages` is registered (the hydrate hook
-     * runs per-turn and overwrites the chain).
+     * With `hydrateMessages` or a storage `loadContext`, this chain is what
+     * the hook receives as `previousMessages` on the next turn; the hook's
+     * return value is the chain the model sees.
      */
     chain?: TUIM[];
     /**
@@ -1545,6 +1648,17 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * ```
      */
     oomMachine?: MachinePresetName;
+    /**
+     * What to do when the session's `externalDeploymentId` no longer names the deployment
+     * this run is on — after a redeploy re-pins the session, say.
+     *
+     * - `"follow"` (default) hands the conversation to the pinned deployment at the next
+     *   turn boundary, so no `chat.requestUpgrade()` of your own is needed.
+     * - `"hold"` stays put until you ask to move. Manual `chat.requestUpgrade()` works either way.
+     *
+     * Ignored for sessions with no pin, and for sessions using `lockToVersion`.
+     */
+    versionSkew?: ChatVersionSkewPolicy;
     /**
      * Schema for validating `clientData` from the frontend.
      * Accepts Zod, ArkType, Valibot, or any supported schema library.
@@ -1599,13 +1713,14 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * `onBeforeTurnComplete` / `onTurnComplete`, no `run()`. Use
      * `chat.history.*` inside `onAction` to mutate state.
      *
-     * To produce a model response from an action, return a
-     * `StreamTextResult` (auto-piped), `string`, or `UIMessage`. Returning
-     * `void` or nothing is the side-effect-only default.
+     * To answer after the edit, return `chat.turn()`: the edit is applied and
+     * snapshotted, then a turn runs on the result with every turn guarantee. An
+     * action that returns nothing is a state edit only. Returning anything else
+     * is an error; a response can no longer be returned directly.
      */
     onAction?: (event: ActionEvent<[
         TActionSchema
-    ] extends [TaskSchema] ? inferSchemaOut<TActionSchema> : unknown, inferSchemaOut<TClientDataSchema>, TUIMessage>) => Promise<unknown> | unknown;
+    ] extends [TaskSchema] ? inferSchemaOut<TActionSchema> : unknown, inferSchemaOut<TClientDataSchema>, TUIMessage>) => Promise<void | ActionTurn> | void | ActionTurn;
     /**
      * The tools available to this agent.
      *
@@ -1691,9 +1806,9 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * continuation after `chat.endRun()` with no buffered user, a fresh
      * chat, or an OOM retry on top of a complete snapshot.
      *
-     * Does NOT fire when `hydrateMessages` is registered — that hook owns
-     * the per-turn chain and overlapping recovery decisions belong in the
-     * customer's DB.
+     * Fires regardless of who owns the model's context; a `hydrateMessages`
+     * hook or a storage `loadContext` receives the recovered tail in
+     * `previousMessages` on the next turn.
      *
      * Defaults (returned when the hook is omitted or returns no field):
      *   - With two or more in-flight users, the partial and the user it
@@ -1823,6 +1938,32 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * ```
      */
     hydrateMessages?: (event: HydrateMessagesEvent<inferSchemaOut<TClientDataSchema>, TUIMessage>) => TUIMessage[] | Promise<TUIMessage[]>;
+    /**
+     * Where the conversation is persisted. The runtime calls `save` after
+     * every turn, failed turn and history-changing action with the changes
+     * since the last save, and `load` once when a new run boots to continue
+     * the conversation.
+     *
+     * Defaults to `defaultStorage`, the platform's snapshot in object storage
+     * that the Sessions dashboard renders. Bring your own to write each change
+     * to your database; `memoryTranscriptStorage()` is the reference
+     * implementation and `runTranscriptStorageTests` from
+     * `@trigger.dev/sdk/ai/test` checks yours against the contract.
+     *
+     * A storage with `loadContext` also owns the model's context on every
+     * turn, which is what `hydrateMessages` did. The two cannot be combined.
+     *
+     * @example
+     * ```ts
+     * chat.agent({
+     *   id: "my-chat",
+     *   storage: myPostgresTranscriptStorage,
+     *   run: async ({ messages, signal, streamText }) =>
+     *     streamText({ model, messages, abortSignal: signal }),
+     * });
+     * ```
+     */
+    storage?: TranscriptStorage<inferSchemaOut<TClientDataSchema>>;
     /**
      * Called at the start of every turn, after message accumulation and `onChatStart` (turn 0),
      * but before the `run` function executes.
@@ -1897,6 +2038,31 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * });
      * ```
      */
+    /**
+     * A provider registry, so the runtime can resolve the managed prompt's model
+     * for the `streamText` it hands to `run()`. Only needed when you set a model
+     * through `chat.prompt.set()` and want the bound `streamText` to honour it.
+     */
+    registry?: ToStreamTextOptionsOptions["registry"];
+    /**
+     * The agent's system prompt. Injected instructions append to it, and the
+     * `streamText` handed to `run()` carries it without a spread.
+     *
+     * Set it here, at the call site, or through `chat.prompt.set()` for versioned
+     * config, but only in one of them.
+     */
+    system?: ToStreamTextOptionsOptions["system"];
+    /**
+     * Mark the system prompt for provider-side caching, the same sugar
+     * `chat.toStreamTextOptions({ cacheControl })` takes. See
+     * [prompt caching](/ai-chat/prompt-caching).
+     */
+    cacheControl?: ToStreamTextOptionsOptions["cacheControl"];
+    /**
+     * Provider options for the system block, when `cacheControl` is not enough.
+     * Takes precedence over `cacheControl`.
+     */
+    systemProviderOptions?: ToStreamTextOptionsOptions["systemProviderOptions"];
     compaction?: ChatAgentCompactionOptions<TUIMessage>;
     /**
      * Configure how messages that arrive during streaming are handled.
@@ -2390,15 +2556,22 @@ declare function setUIMessageStreamOptions(options: ChatUIMessageStreamOptions<U
  */
 declare function isStopped(): boolean;
 /**
- * Request that the current run exits so the next message starts on the latest
- * deployed version (via the standard continuation mechanism).
+ * Hand the conversation over to another deployment.
+ *
+ * The handover happens immediately and server-side: a successor run is created
+ * and picks the conversation up from `session.in`. The transport keeps reading
+ * the same session output, so no client action is needed and nothing waits for
+ * the next message.
+ *
+ * Without a target the session's pin is cleared, so the successor lands on the
+ * latest deployed version; with `externalDeploymentId` the session is re-pinned
+ * to that deployment.
  *
  * When called from `onTurnStart` or `onValidateMessages`, `run()` is skipped
- * entirely — the run exits immediately and the transport re-triggers the
- * same message on the new version.
+ * entirely and the successor answers the message that opened the turn.
  *
  * When called from `run()` or `chat.defer()`, the current turn completes
- * normally and the run exits afterward instead of waiting for the next message.
+ * normally and the handover happens afterward.
  *
  * Call from `onTurnStart`, `onValidateMessages`, `onChatResume`, `run()`,
  * or inside `chat.defer()`.
@@ -2418,7 +2591,9 @@ declare function isStopped(): boolean;
  * });
  * ```
  */
-declare function requestUpgrade(): void;
+declare function requestUpgrade(options?: {
+    externalDeploymentId?: string;
+}): void;
 /**
  * Hand off the current custom agent Session to a fresh run.
  *
@@ -2477,6 +2652,50 @@ declare function endAndContinue(): Promise<void>;
  * ```
  */
 declare function endRun(): void;
+/**
+ * End the whole conversation, permanently. The session row is closed, further
+ * appends are refused, and the run exits without scheduling a continuation.
+ *
+ * This is the session-level stop. {@link endRun} ends the current run and lets
+ * the next message start a fresh one; `chat.close()` ends the session itself,
+ * so there is no next message. Use it for a budget cap, a completed goal,
+ * abuse detection, or a user signing out.
+ *
+ * In a `chat.agent`, call it from `run()`, `prepareStep`, or
+ * `onBeforeTurnComplete`. Called mid-step, it aborts the in-flight
+ * `streamText` the same way the stop signal does, so the partial response is
+ * still captured and streamed. The turn then completes normally, a terminal
+ * `session-closed` record carrying `reason` is written to the response stream,
+ * and the loop exits.
+ *
+ * Prefer `onBeforeTurnComplete` over `onTurnComplete`. It carries the same
+ * fields but still runs while the stream is open, so the closed state rides
+ * out on the turn's final record. `onTurnComplete` runs after that record, so
+ * a close decided there does not reach a reader that has already finished the
+ * turn, and the user only finds out when their next message is refused.
+ *
+ * In a `chat.customAgent`, call it anywhere in your own loop. The close is
+ * performed when `run()` returns, so it lands whether you break out of a
+ * `chat.createSession` loop, return early, or hand-roll the loop entirely.
+ *
+ * Closing is one-way: a closed session cannot be reopened. Its transcript
+ * stays readable.
+ *
+ * @example
+ * ```ts
+ * chat.agent({
+ *   id: "budgeted-agent",
+ *   onBeforeTurnComplete: async ({ usage }) => {
+ *     if (await overBudget(usage)) {
+ *       chat.close({ reason: "Monthly budget reached" });
+ *     }
+ *   },
+ * });
+ * ```
+ */
+declare function close(options?: {
+    reason?: string;
+}): void;
 /**
  * Register a promise that runs in the background during the current turn.
  *
@@ -2746,6 +2965,20 @@ declare class ChatMessageAccumulator {
      * Queue a message for injection, converting to model messages automatically.
      */
     steerAsync(message: UIMessage): Promise<void>;
+    /**
+     * Record the messages a steering drain consumed.
+     *
+     * The drain only puts them in this step's prompt, so without this they
+     * shape one answer and then exist in neither lane: not in `uiMessages`,
+     * which is what an app persists from, and not in `modelMessages`, which is
+     * what every later turn sends.
+     *
+     * Both lanes are appended to. The model lane is never reconverted from the
+     * UI lane, because `compactIfNeeded` replaces it with a summary and leaves
+     * the UI lane whole: a reconversion would restore everything the summary
+     * replaced.
+     */
+    absorbSteering(claimed: UIMessage[], injected?: ModelMessage[]): Promise<void>;
     /**
      * Get and clear unconsumed steering messages.
      */
@@ -2783,6 +3016,11 @@ export type ChatSessionOptions = {
     timeout?: string;
     /** Max turns before ending. @default 100 */
     maxTurns?: number;
+    /**
+     * What to do when the session's `externalDeploymentId` no longer names this deployment.
+     * `"follow"` (default) hands over at the next turn boundary; `"hold"` stays put.
+     */
+    versionSkew?: ChatVersionSkewPolicy;
     /** Automatic context compaction — same options as `chat.agent({ compaction })`. */
     compaction?: ChatAgentCompactionOptions;
     /** Configure mid-execution message injection — same options as `chat.agent({ pendingMessages })`. */
@@ -2994,7 +3232,7 @@ export type CreateChatStartSessionActionOptions = {
      * Default trigger config used when starting a new session for a chat.
      * Per-call `params.triggerConfig` shallow-merges on top.
      */
-    triggerConfig?: Partial<SessionTriggerConfig>;
+    triggerConfig?: Partial<SessionTriggerConfigInput>;
     /**
      * Override the Trigger.dev API base URL. String applies to both
      * `/api/v1/sessions` and `/api/v1/auth/jwt/claims`; function picks per
@@ -3037,7 +3275,7 @@ export type ChatStartSessionParams<TChat extends AnyTask = AnyTask> = {
      * `chat.agent`: anything beyond `chatId`/`messages`/`trigger`/`metadata`,
      * which the runtime injects automatically).
      */
-    triggerConfig?: Partial<SessionTriggerConfig>;
+    triggerConfig?: Partial<SessionTriggerConfigInput>;
     /**
      * Opaque session-level metadata stored on the Session row. Separate from
      * the per-turn `clientData` above. Use this when you want to attach
@@ -3059,6 +3297,11 @@ export type ChatStartSessionResult = {
     runId: string;
     /** Session friendlyId — informational. */
     sessionId: string;
+    /**
+     * The session's run is parked waiting for its deployment. Messages sent meanwhile are durable
+     * and delivered once it lands; surface this so the wait reads as a deploy in progress.
+     */
+    pendingVersion?: boolean;
 };
 /**
  * Creates a server-side helper that starts (or resumes) a Session for a
@@ -3095,6 +3338,42 @@ export type ChatStartSessionResult = {
  * ```
  */
 declare function createChatStartSessionAction<TChat extends AnyTask = AnyTask>(taskId: string, options?: CreateChatStartSessionActionOptions): (params: ChatStartSessionParams<TChat>) => Promise<ChatStartSessionResult>;
+export type CreateChatLoadTranscriptActionOptions = {
+    /**
+     * Scope the action to a specific API client configuration (secret key,
+     * base URL) instead of the process-wide one. The default storage reads
+     * through this client.
+     */
+    apiClient?: ApiClientConfiguration;
+    /** Page size when the caller passes none. */
+    limit?: number;
+};
+export type ChatLoadTranscriptParams<TClientData = unknown> = {
+    chatId: string;
+    clientData?: TClientData;
+    limit?: number;
+    before?: string;
+};
+/**
+ * Creates a server-side helper that reads a conversation from a transcript
+ * storage, for rendering history before the chat connects. Works the same
+ * for every storage, the platform default included, so the browser never
+ * reads a store directly and the secret key stays on the server.
+ *
+ * Wrap it in a Next.js server action (or any server-side handler), scope it
+ * to the authenticated user through `clientData`, and pass the result to
+ * `useLoadTranscript` in the browser.
+ *
+ * @example
+ * ```ts
+ * // actions.ts
+ * "use server";
+ * import { chat, defaultStorage } from "@trigger.dev/sdk/ai";
+ *
+ * export const loadTranscript = chat.createLoadTranscriptAction(defaultStorage, { limit: 50 });
+ * ```
+ */
+declare function createChatLoadTranscriptAction<TClientData = unknown>(storage: TranscriptStorage<TClientData>, options?: CreateChatLoadTranscriptActionOptions): (params: ChatLoadTranscriptParams<TClientData>) => Promise<TranscriptLoadResult>;
 export declare const chat: {
     /** Create a chat agent. See {@link chatAgent}. */
     agent: typeof chatAgent;
@@ -3106,8 +3385,12 @@ export declare const chat: {
     withClientData: typeof withClientData;
     /** Create a server-side helper for starting (or resuming) a Session for a chatId. See {@link createChatStartSessionAction}. */
     createStartSessionAction: typeof createChatStartSessionAction;
+    /** Returns a server-side helper that reads a conversation from a transcript storage. */
+    createLoadTranscriptAction: typeof createChatLoadTranscriptAction;
     /** Pipe a stream to the chat transport. See {@link pipeChat}. */
     pipe: typeof pipeChat;
+    /** Return from `onAction` to run a turn on the edited history. See {@link chatTurn}. */
+    turn: typeof chatTurn;
     /** Create a per-run typed local. See {@link chatLocal}. */
     local: typeof chatLocal;
     /** Create a public access token for a chat task. See {@link createChatAccessToken}. */
@@ -3128,10 +3411,13 @@ export declare const chat: {
     endAndContinue: typeof endAndContinue;
     /** Exit the run after the current turn completes, without any upgrade signal. See {@link endRun}. */
     endRun: typeof endRun;
+    /** End the conversation permanently: close the session and exit the run. See {@link close}. */
+    close: typeof close;
     /** Clean up aborted parts from a UIMessage. See {@link cleanupAbortedParts}. */
     cleanupAbortedParts: typeof cleanupAbortedParts;
     /** Register background work that runs in parallel with streaming. See {@link chatDefer}. */
     defer: typeof chatDefer;
+    deferBeforeOutput: typeof chatDeferBeforeOutput;
     /** Queue model messages for injection at the next `prepareStep` boundary. See {@link injectBackgroundContext}. */
     inject: typeof injectBackgroundContext;
     /** Typed chat output stream for writing custom chunks or piping from subtasks. */