@superdurable/dex-agents 0.1.0 → 0.2.0

package/dist/src/ui-stream/agent-ui-message-stream-responses.js

@@ -0,0 +1,440 @@
+// 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 { setTimeout as delay } from "node:timers/promises";
+import { RpcLockConflictError } from "@superdurable/dex";
+import { describeToolCallOutcome, isFinalToolCallStatus, } from "../agent-session-values.js";
+import { findAgentEventResumeTokenBeforeTurn, parseTurnNumber, probeAgentEventResumeToken, readAgentEventsTailResumeToken, requireAgentEventPollTimeoutMs, } from "./agent-event-stream-positions.js";
+import { AgentSessionRecordReader } from "./agent-session-record-reader.js";
+import { prepareAgentUIStreamStart, readAgentUIMessageChunkBatches, } from "./agent-ui-message-stream.js";
+import { agentResumeTokenDataPartType, agentUIMessageStreamHeaders, } from "./agent-ui-message-types.js";
+import { createAgentUIStreamCursor, decodeAgentUIStreamCursor, encodeAgentUIStreamCursor, toolCallUIStateOfRecord, } from "./agent-ui-stream-cursor.js";
+import { createServerSentEventResponse, mergeHeaders, serverSentEventKeepAliveFrame, } from "./server-sent-event-responses.js";
+const lockConflictRetryTimeoutMs = 5_000;
+const lockConflictRetryIntervalMs = 50;
+const maximumApprovalsPerRequest = 100;
+const maximumToolCallIdLength = 512;
+const staleApprovalText = "The approval is no longer pending.";
+const assistantMessageIdPattern = /^(turn-[0-9]+)-assistant$/;
+/**
+ * Request header name for a UI stream resume token.
+ *
+ * Send the token in this header rather than the URL: a token can reach 64 KiB, beyond many URL limits.
+ */
+export const agentResumeTokenHeaderName = "x-agent-resume-token";
+/**
+ * Returns a streaming AI SDK UI message stream Response for one agent turn, or 204 when there is none.
+ *
+ * Mount it as the reconnect endpoint of `useChat`, `GET <api>/<chatId>/stream` by default, with the chat ID
+ * as the session ID; the route must check that the caller may read that session. It writes
+ * {@link streamAgentUIMessageChunks} as Server-Sent Events with the protocol headers, a keep-alive
+ * comment after each empty long poll, and `data: [DONE]` at the end. It stops reading when the browser
+ * closes the response.
+ *
+ * Use the default `DefaultChatTransport`, whose resumed streams count as replays. A stream started with a
+ * token replays the token's turn, and one started without a token replays the active turn; either way
+ * its `start` part makes the browser reset the message and rebuild it, whatever it held. With
+ * `continueAfterResumeToken`, a stream continues exactly after the last part the browser received and
+ * sends no `start` part; use it only while the browser still holds that message. Before it answers 200,
+ * the helper reads once to check the token's Dex position; a position Dex rejects restarts the turn from
+ * its first retained event.
+ *
+ * @example
+ * ```ts
+ * // Server: GET /api/chat/:id/stream
+ * export async function GET(request: Request, sessionId: string): Promise<Response> {
+ *   await authorizeSession(request, sessionId);
+ *   return createAgentUIMessageStreamResponse({
+ *     client, flow, flowId: sessionId,
+ *     resumeToken: request.headers.get(agentResumeTokenHeaderName) ?? undefined,
+ *     signal: request.signal,
+ *   });
+ * }
+ *
+ * // Browser
+ * let resumeToken: string | undefined = initial.resumeToken ?? undefined;
+ * const chat = useChat({
+ *   id: sessionId,
+ *   messages: initial.messages,
+ *   resume: resumeToken !== undefined,
+ *   onData: (part) => {
+ *     if (part.type === "data-agent-resume-token") resumeToken = part.data as string;
+ *   },
+ *   transport: new DefaultChatTransport({
+ *     api: "/api/chat",
+ *     prepareReconnectToStreamRequest: ({ id }) => ({
+ *       api: `/api/chat/${id}/stream`,
+ *       headers: resumeToken === undefined ? {} : { "x-agent-resume-token": resumeToken },
+ *     }),
+ *   }),
+ *   sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithApprovalResponses,
+ * });
+ * ```
+ * @param options - Session, start position, polling, and extra headers.
+ * @returns 200 with the stream; 204 when the token's turn already finished, or when the turn to replay is
+ * not active or not on the Stream; 400 with a text body when `resumeToken` is invalid.
+ * @throws {RangeError} When `pollTimeoutMs` is not a positive whole number of seconds.
+ * @throws {DexServiceError} When reading the start position fails.
+ */
+export async function createAgentUIMessageStreamResponse(options) {
+    const pollTimeoutMs = requireAgentEventPollTimeoutMs(options.pollTimeoutMs);
+    if (options.resumeToken !== undefined && decodeResumeTokenOrUndefined(options.resumeToken) === undefined) {
+        return createInvalidResumeTokenResponse(options.headers);
+    }
+    const start = await prepareAgentUIStreamStart(options);
+    if (start === undefined) {
+        return new Response(null, { status: 204, headers: mergeHeaders({}, options.headers) });
+    }
+    return createAgentUIMessageSseResponse(options, start, pollTimeoutMs, []);
+}
+/**
+ * Queues a user message and returns the AI SDK UI message stream Response of the turn it starts.
+ *
+ * Mount it as the send endpoint of `useChat`, `POST <api>` by default, when the last message in the
+ * request body is a user message. The chat ID in the body comes from the browser, so the route must check
+ * that the caller may write to that session. The helper reads the session's turn count and the Stream
+ * position first and then calls `send_user_message`, so the stream follows the next turn that starts
+ * after the message was queued. When an earlier turn is still running, the stream waits for it to end.
+ * When other messages were queued before this one, the stream follows the turn of the oldest of them.
+ *
+ * The session's committed state ends the stream even when no event of the turn reaches the Stream, such
+ * as with the Server's Stream Store disabled: once that turn ended, the stream finishes with reason
+ * `other`, and the application reloads the stored messages. The RPC needs a running Worker.
+ *
+ * @example
+ * ```ts
+ * // POST /api/chat
+ * export async function POST(request: Request): Promise<Response> {
+ *   const { id, messages } = await request.json();
+ *   await authorizeSession(request, id);
+ *   const lastMessage = messages.at(-1);
+ *   if (lastMessage.role === "assistant") {
+ *     return resolveAgentToolApprovalsWithUIMessageStream({
+ *       client, flow, flowId: id, approvals: readAgentToolApprovalResponses(lastMessage) });
+ *   }
+ *   const text = lastMessage.parts.filter((part) => part.type === "text").map((part) => part.text).join("");
+ *   return sendAgentUserMessageWithUIMessageStream({ client, flow, flowId: id, text, signal: request.signal });
+ * }
+ * ```
+ * @param options - Session, message text, polling, and extra headers.
+ * @returns 200 with the stream; 400 with a text body when the text is blank.
+ * @throws {RangeError} When `pollTimeoutMs` is not a positive whole number of seconds.
+ * @throws {FlowNotActiveOrNotFoundError} When the session is not running.
+ * @throws {DexServiceError} When a read or the RPC fails.
+ */
+export async function sendAgentUserMessageWithUIMessageStream(options) {
+    const pollTimeoutMs = requireAgentEventPollTimeoutMs(options.pollTimeoutMs);
+    const { client, flow, flowId } = options;
+    const [state] = await client.getAttributes(flowId, flow.agentState);
+    const eventResumeToken = await readAgentEventsTailResumeToken(client, flow, flowId);
+    const isQueued = await client.invokeRPC(flow.sendUserMessage, flowId, { text: options.text });
+    if (!isQueued) {
+        return new Response("the user message text is blank", {
+            status: 400,
+            headers: mergeHeaders({ "content-type": "text/plain; charset=utf-8" }, options.headers),
+        });
+    }
+    const cursor = createAgentUIStreamCursor(eventResumeToken, null, false);
+    // The message's turn starts after every turn that already started.
+    const activeTurnNumber = state?.activeTurnId == null ? 0 : (parseTurnNumber(state.activeTurnId) ?? 0);
+    cursor.afterTurnNumber = Math.max(state?.turnCount ?? 0, activeTurnNumber);
+    return createAgentUIMessageSseResponse(options, { cursor, firstMessage: undefined }, pollTimeoutMs, []);
+}
+/**
+ * Sends one tool approval decision to the session's `resolve_interrupt` RPC.
+ *
+ * Call it with each AI SDK `tool-approval-response`: its `approvalId` is the `interrupt_id`, and its
+ * `reason` becomes the rejection message the model sees. It retries `RpcLockConflictError`, which a call
+ * that races the approval Step can raise, for up to 5 seconds. It resolves any pending interrupt of the
+ * session, so the route must check that the caller may decide for that session. The RPC needs a running
+ * Worker.
+ *
+ * @example
+ * ```ts
+ * const isResolved = await resolveAgentToolApproval({
+ *   client, flow, flowId: sessionId,
+ *   approval: { approvalId: "call_42", approved: false, reason: "Use the sandbox account" },
+ * });
+ * ```
+ * @param options - Session and decision.
+ * @returns `true` when the interrupt was pending and is now resolved; `false` when it is unknown, already
+ * resolved, or past its deadline.
+ * @throws {RpcLockConflictError} When the lock stays busy for 5 seconds.
+ * @throws {FlowNotActiveOrNotFoundError} When the session is not running.
+ */
+export async function resolveAgentToolApproval(options) {
+    const { approval } = options;
+    const deadline = Date.now() + lockConflictRetryTimeoutMs;
+    for (;;) {
+        try {
+            return await options.client.invokeRPC(options.flow.resolveInterrupt, options.flowId, {
+                interruptId: approval.approvalId,
+                approved: approval.approved,
+                rejectionMessage: approval.approved ? null : (approval.reason ?? null),
+            });
+        }
+        catch (error) {
+            if (!(error instanceof RpcLockConflictError) || Date.now() >= deadline) {
+                throw error;
+            }
+        }
+        await delay(lockConflictRetryIntervalMs);
+    }
+}
+/**
+ * Returns the tool approval decisions recorded on an AI SDK assistant message.
+ *
+ * `useChat` sets a tool part to `approval-responded` when the application calls
+ * `addToolApprovalResponse`, then sends the message list with `sendAutomaticallyWhen`. Pass the last
+ * message of that request body. The message comes from the browser, so every field is checked; parts
+ * that are not well-formed responded approvals are skipped.
+ *
+ * Each decision is bound to the message's turn when the message ID is `<turnId>-assistant`, as the agent UI
+ * streams and snapshots name assistant messages; a message with another ID gives unbound decisions.
+ *
+ * @param message - An AI SDK `UIMessage`, typically the last message of a `useChat` request body.
+ * @returns One decision per `approval-responded` tool part, in part order; empty for anything else.
+ */
+export function readAgentToolApprovalResponses(message) {
+    if (!isRecord(message) || !Array.isArray(message["parts"])) {
+        return [];
+    }
+    const messageId = message["id"];
+    const turnId = typeof messageId === "string" ? assistantMessageIdPattern.exec(messageId)?.[1] : undefined;
+    const approvals = [];
+    for (const part of message["parts"]) {
+        if (!isRecord(part) || part["state"] !== "approval-responded" || !isToolPartType(part["type"])) {
+            continue;
+        }
+        const approval = part["approval"];
+        if (!isRecord(approval) || typeof approval["id"] !== "string" || typeof approval["approved"] !== "boolean") {
+            continue;
+        }
+        const reason = approval["reason"];
+        approvals.push({
+            approvalId: approval["id"],
+            approved: approval["approved"],
+            ...(typeof reason === "string" ? { reason } : {}),
+            ...(turnId === undefined ? {} : { turnId }),
+        });
+    }
+    return approvals;
+}
+/**
+ * Sends tool approval decisions and returns the AI SDK UI message stream Response that continues the turn.
+ *
+ * Mount it in the send endpoint of `useChat` for requests whose last message is an assistant message,
+ * which `sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithApprovalResponses` sends after the
+ * application answered every approval. The decisions and the chat ID come from the browser, so the route
+ * must check that the caller may decide for that session. Only interrupts that are pending in the
+ * session's active turn are resolved.
+ *
+ * The stream continues the same assistant message. A decision that is no longer pending, because another
+ * client or a deadline settled the call or its turn ended, gets the call's known outcome, or an error
+ * part when none is known, so the browser leaves `approval-responded` and does not send the decision
+ * again. Decisions bound to another turn than the active one, such as from a stale browser tab, are all
+ * stale, and the stream then ends after their outcomes. With `resumeToken`, the latest `data-agent-resume-token`, the stream continues exactly after the
+ * paused stream. Without one it reads the Stream position and the active turn's tool calls before
+ * sending the decisions. The RPCs need a running Worker.
+ *
+ * @example
+ * ```ts
+ * return resolveAgentToolApprovalsWithUIMessageStream({
+ *   client, flow, flowId: id, approvals: readAgentToolApprovalResponses(messages.at(-1)) });
+ * ```
+ * @param options - Session, decisions, optional resume token, polling, and extra headers.
+ * @returns 200 with the stream, which holds only the stale decisions' outcomes and a `finish` part when
+ * no turn is active; 400 with a text body when `resumeToken` is invalid.
+ * @throws {RangeError} When `pollTimeoutMs` is not a positive whole number of seconds.
+ * @throws {RpcLockConflictError} When a decision's lock stays busy for 5 seconds.
+ * @throws {DexServiceError} When a read or an RPC fails.
+ */
+export async function resolveAgentToolApprovalsWithUIMessageStream(options) {
+    const pollTimeoutMs = requireAgentEventPollTimeoutMs(options.pollTimeoutMs);
+    const { client, flow, flowId } = options;
+    let clientCursor;
+    if (options.resumeToken !== undefined) {
+        clientCursor = decodeResumeTokenOrUndefined(options.resumeToken);
+        if (clientCursor === undefined) {
+            return createInvalidResumeTokenResponse(options.headers);
+        }
+    }
+    // Position before snapshot: events may repeat the snapshot, but none goes missing.
+    const tailResumeToken = await readAgentEventsTailResumeToken(client, flow, flowId);
+    const snapshot = await client.invokeRPC(flow.getAgentSnapshot, flowId);
+    const activeTurnId = snapshot.state?.activeTurnId ?? null;
+    // Decisions from an older turn's message settle that message only; the active turn goes elsewhere.
+    const isActiveTurnRequest = options.approvals.every((approval) => approval.turnId === undefined || approval.turnId === activeTurnId);
+    let start;
+    if (!isActiveTurnRequest) {
+        const finishedCursor = createAgentUIStreamCursor(tailResumeToken, null, true);
+        finishedCursor.isTurnFinished = true;
+        start = { cursor: finishedCursor, firstMessage: undefined };
+    }
+    else if (clientCursor !== undefined && clientCursor.turnId === activeTurnId && activeTurnId !== null) {
+        // The browser keeps its message here, so a rejected position falls back to the tail, never a replay.
+        const probe = await probeAgentEventResumeToken(client, flow, flowId, clientCursor.eventResumeToken);
+        if (probe.isAccepted) {
+            start = { cursor: clientCursor, firstMessage: probe.firstMessage };
+        }
+    }
+    start ??= {
+        cursor: await createActiveTurnContinuationCursor(client, flow, flowId, tailResumeToken, activeTurnId, snapshot.toolCalls),
+        firstMessage: undefined,
+    };
+    const cursor = start.cursor;
+    const pendingInterruptIds = new Set(snapshot.pendingInterrupts
+        .filter((interrupt) => snapshot.toolCalls.some((toolCall) => toolCall.toolCallId === interrupt.toolCallId &&
+        toolCall.turnId === activeTurnId &&
+        toolCall.status === "awaiting_approval"))
+        .map((interrupt) => interrupt.interruptId));
+    const staleApprovals = [];
+    for (const approval of selectUniqueApprovals(options.approvals)) {
+        const isResolved = isActiveTurnRequest &&
+            pendingInterruptIds.has(approval.approvalId) &&
+            (await resolveAgentToolApproval({ client, flow, flowId, approval }));
+        if (isResolved) {
+            // The interrupt_resolved event follows; until then the call must not count as waiting.
+            cursor.toolCalls.set(approval.approvalId, "approval_resolved");
+        }
+        else {
+            staleApprovals.push(approval);
+        }
+    }
+    const staleOutcomeChunks = await readStaleApprovalOutcomes(new AgentSessionRecordReader(client, flow, flowId), activeTurnId, snapshot.toolCalls, staleApprovals, cursor);
+    return createAgentUIMessageSseResponse(options, start, pollTimeoutMs, staleOutcomeChunks);
+}
+/** Keeps the first well-formed decision per approval ID, up to the per-request limit. */
+function selectUniqueApprovals(approvals) {
+    const selected = new Map();
+    for (const approval of approvals.slice(0, maximumApprovalsPerRequest)) {
+        const approvalId = approval.approvalId;
+        if (typeof approvalId !== "string" ||
+            approvalId === "" ||
+            approvalId.length > maximumToolCallIdLength ||
+            approvalId.includes("/") ||
+            typeof approval.approved !== "boolean" ||
+            selected.has(approvalId)) {
+            continue;
+        }
+        selected.set(approvalId, approval);
+    }
+    return [...selected.values()];
+}
+/**
+ * Returns the parts that settle the decisions `resolve_interrupt` did not accept, and records them in the
+ * cursor. A call still open in the active turn gets none: its own events follow.
+ */
+async function readStaleApprovalOutcomes(records, activeTurnId, activeTurnToolCalls, staleApprovals, cursor) {
+    const chunks = [];
+    let storedToolResults;
+    for (const approval of staleApprovals) {
+        // A tool approval's interrupt ID is its tool call ID.
+        const toolCallId = approval.approvalId;
+        const isActiveTurnToolCall = cursor.turnId === activeTurnId && activeTurnToolCalls.some((toolCall) => toolCall.toolCallId === toolCallId);
+        const record = activeTurnId !== null && isActiveTurnToolCall
+            ? await records.readToolCall(activeTurnId, toolCallId)
+            : undefined;
+        if (record !== undefined && !isFinalToolCallStatus(record.status)) {
+            cursor.toolCalls.set(toolCallId, "approval_resolved");
+            continue;
+        }
+        cursor.toolCalls.set(toolCallId, "finished");
+        if (record !== undefined) {
+            if (record.status === "succeeded") {
+                chunks.push({ type: "tool-output-available", toolCallId, output: record.output ?? null, dynamic: true });
+            }
+            else if (record.status === "rejected") {
+                chunks.push({ type: "tool-output-denied", toolCallId });
+            }
+            else {
+                chunks.push({ type: "tool-output-error", toolCallId, errorText: describeToolCallOutcome(record), dynamic: true });
+            }
+            continue;
+        }
+        storedToolResults ??= await records.readRecentStoredToolResults();
+        const storedToolOutput = [...storedToolResults]
+            .reverse()
+            .find((result) => result.toolCallId === toolCallId && (approval.turnId === undefined || result.turnId === approval.turnId))?.toolOutput;
+        chunks.push(storedToolOutput === undefined
+            ? { type: "tool-output-error", toolCallId, errorText: staleApprovalText, dynamic: true }
+            : { type: "tool-output-available", toolCallId, output: storedToolOutput, dynamic: true });
+    }
+    return chunks;
+}
+/**
+ * Returns a cursor at the Stream tail that continues the active turn the browser already shows. It records
+ * where the turn started, so a reconnect with its token replays the whole turn.
+ */
+async function createActiveTurnContinuationCursor(client, flow, flowId, tailResumeToken, activeTurnId, toolCalls) {
+    const cursor = createAgentUIStreamCursor(tailResumeToken, activeTurnId, true);
+    if (activeTurnId === null) {
+        cursor.isTurnFinished = true;
+        return cursor;
+    }
+    cursor.turnStartResumeToken =
+        (await findAgentEventResumeTokenBeforeTurn(client, flow, flowId, activeTurnId)) ?? null;
+    for (const toolCall of toolCalls) {
+        cursor.toolCalls.set(toolCall.toolCallId, toolCallUIStateOfRecord(toolCall));
+    }
+    return cursor;
+}
+function createAgentUIMessageSseResponse(options, start, pollTimeoutMs, leadingChunks) {
+    return createServerSentEventResponse(formatAgentUIMessageSseFrames(options, start, pollTimeoutMs, leadingChunks), agentUIMessageStreamHeaders, options.headers);
+}
+async function* formatAgentUIMessageSseFrames(options, start, pollTimeoutMs, leadingChunks) {
+    const cursor = start.cursor;
+    if (leadingChunks.length > 0) {
+        const resumeTokenChunk = {
+            type: agentResumeTokenDataPartType,
+            data: encodeAgentUIStreamCursor(cursor),
+            transient: true,
+        };
+        yield [...leadingChunks, resumeTokenChunk].map(formatUIMessageChunkFrame).join("");
+    }
+    if (cursor.isTurnFinished) {
+        yield formatUIMessageChunkFrame({ type: "finish", finishReason: "other" });
+    }
+    else {
+        for await (const chunks of readAgentUIMessageChunkBatches(options, start, pollTimeoutMs)) {
+            if (chunks === undefined) {
+                yield serverSentEventKeepAliveFrame;
+            }
+            else if (chunks.length > 0) {
+                yield chunks.map(formatUIMessageChunkFrame).join("");
+            }
+        }
+    }
+    yield "data: [DONE]\n\n";
+}
+function formatUIMessageChunkFrame(chunk) {
+    return `data: ${JSON.stringify(chunk)}\n\n`;
+}
+function decodeResumeTokenOrUndefined(resumeToken) {
+    try {
+        return decodeAgentUIStreamCursor(resumeToken);
+    }
+    catch (error) {
+        if (error instanceof TypeError) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function createInvalidResumeTokenResponse(headers) {
+    return new Response("the agent UI stream resume token is invalid", {
+        status: 400,
+        headers: mergeHeaders({ "content-type": "text/plain; charset=utf-8" }, headers),
+    });
+}
+function isToolPartType(type) {
+    return type === "dynamic-tool" || (typeof type === "string" && type.startsWith("tool-"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=agent-ui-message-stream-responses.js.map

package/dist/src/ui-stream/agent-ui-message-stream-responses.js.map

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

package/dist/src/ui-stream/agent-ui-message-stream.d.ts

@@ -0,0 +1,138 @@
+import type { Client, StreamMessage } from "@superdurable/dex";
+import type { AgentFrameworkRunner, DeferredToolOutcome } from "../agent-framework-runner.js";
+import type { AgentSessionFlow } from "../agent-session-flow.js";
+import { type AgentEvent } from "../agent-session-values.js";
+import { type AgentUIMessageChunk } from "./agent-ui-message-types.js";
+import { type AgentUIStreamCursor } from "./agent-ui-stream-cursor.js";
+/**
+ * Selects the agent session and Stream position of an AI SDK UI message stream.
+ *
+ * Pass it to {@link streamAgentUIMessageChunks} or {@link createAgentUIMessageStreamResponse}. The Client's
+ * Registry must contain `flow`, the same object the Worker registered.
+ */
+export interface AgentUIMessageStreamOptions {
+    /** Client used for every Stream read, Attribute read, and RPC. The caller keeps ownership. */
+    readonly client: Client;
+    /** The agent session Flow, such as the value an adapter factory returns. */
+    readonly flow: AgentSessionFlow<AgentFrameworkRunner<DeferredToolOutcome>>;
+    /**
+     * Session ID: the Flow ID of the agent session. The value usually comes from the browser, so the route
+     * must check that the caller may read this session before it streams.
+     */
+    readonly flowId: string;
+    /**
+     * UI stream resume token from the latest `data-agent-resume-token` part, or from
+     * {@link readAgentSessionUIMessages}. It is not a Dex Stream resume token; pass it back unchanged.
+     *
+     * By default the stream replays the token's turn from its first retained event, starting with a `start`
+     * part. Omit the token to replay the session's active turn instead.
+     */
+    readonly resumeToken?: string | undefined;
+    /**
+     * Whether a stream started with `resumeToken` continues exactly after the last part the browser received,
+     * without a `start` part, instead of replaying the turn. Defaults to `false`.
+     *
+     * Pass `true` only while the browser still holds the parts the token continues: with `useChat`, while
+     * `status` is `"error"` after a dropped connection. After a clean close or a page reload the browser
+     * starts from an empty message, so a continuation would show only the rest of the turn.
+     */
+    readonly continueAfterResumeToken?: boolean;
+    /**
+     * Long-poll duration of one `AgentEvents` read, in milliseconds. It must be a whole number of seconds.
+     * After each empty poll the stream checks whether the turn ended without its end event, whether the
+     * session Flow closed, and whether the turn waits only for approvals. Defaults to 10,000.
+     */
+    readonly pollTimeoutMs?: number;
+    /**
+     * Whether the stream finishes with reason `tool-calls` when the turn can only continue after
+     * `resolve_interrupt`. `useChat` sends tool approvals only after its response stream ended, so keep the
+     * default `true` with `sendAutomaticallyWhen`. Pass `false` when the application resolves approvals
+     * through its own endpoint and keeps one stream open for the whole turn.
+     */
+    readonly finishWhenAwaitingApproval?: boolean;
+    /** Ends the stream before its next Stream read once aborted, such as the request's `signal`. */
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+ * Translates one agent turn from the session's `AgentEvents` Stream into AI SDK UI message stream parts.
+ *
+ * The parts follow one turn. Without a resume token they replay the session's active turn from its start.
+ * With one they replay the token's turn, or continue it exactly with `continueAfterResumeToken`. The
+ * generator returns after the turn completes (`finish` with `stop`), fails (`error`, then `finish` with
+ * `error`), ends through steering or `cancel_turn` (the `turn_steered` or `turn_cancelled` event data part, then
+ * `finish` with `other`), or waits only for tool approvals (`finish` with `tool-calls`). It also returns when the turn
+ * ended without its end event on the Stream, or the session Flow closed (`finish` with `other`); the
+ * session's committed state decides this, so the stream ends even when the Stream lost every event. On
+ * `other`, reload the stored messages with {@link readAgentSessionUIMessages}.
+ *
+ * Every `RunModel` Step execution is one AI SDK step. When a new attempt of the same Step execution starts,
+ * for example after a Worker crash, the generator emits `reset-step`, so the browser drops the partial
+ * text of the interrupted attempt. Tool calls become dynamic tool parts. A tool call that needs approval
+ * gets a `tool-approval-request` whose `approvalId` is the `interrupt_id` for `resolve_interrupt`. A
+ * `question` interrupt is not an approval: its `interrupt_raised` and `interrupt_resolved` events arrive as
+ * agent event data parts, and the browser answers it with `answer_question`. A
+ * transient `data-agent-resume-token` part follows every part; send the latest one back to resume.
+ *
+ * The generator reads tool arguments and results from the committed `AgentToolCalls` records, waiting up
+ * to 3 seconds for the commit that follows each event, and from the stored messages once the turn deleted
+ * its records. It also waits up to 3 seconds for a turn's end to commit before it finishes. Events are
+ * best effort: a part whose event the Stream lost or trimmed is missing until the stored messages replace
+ * the streamed message.
+ *
+ * Stop in the browser only closes the HTTP response, and the turn keeps running in Dex. To stop the turn
+ * durably, the application's stop route calls the session's `cancel_turn` RPC.
+ *
+ * @example
+ * ```ts
+ * import { createUIMessageStreamResponse } from "ai";
+ * import { streamAgentUIMessageChunks } from "@superdurable/dex-agents/ui-stream";
+ *
+ * export async function GET(request: Request, sessionId: string): Promise<Response> {
+ *   const chunks = streamAgentUIMessageChunks({
+ *     client, flow, flowId: sessionId,
+ *     resumeToken: request.headers.get("x-agent-resume-token") ?? undefined, signal: request.signal,
+ *   });
+ *   return createUIMessageStreamResponse({ stream: ReadableStream.from(chunks) });
+ * }
+ * ```
+ * @param options - Session, start position, and polling.
+ * @returns An async generator of UI message stream parts. It yields nothing when the token's turn already
+ * finished, or when the stream would replay a turn that is not active or not on the Stream.
+ * @throws {TypeError} When `resumeToken` is not a UI stream resume token.
+ * @throws {RangeError} When `pollTimeoutMs` is not a positive whole number of seconds.
+ * @throws {DexServiceError} When a Stream read, Attribute read, or RPC fails.
+ */
+export declare function streamAgentUIMessageChunks(options: AgentUIMessageStreamOptions): AsyncGenerator<AgentUIMessageChunk, void, undefined>;
+/** Where a stream starts, with the first event already read when one was waiting. */
+export interface AgentUIStreamStart {
+    readonly cursor: AgentUIStreamCursor;
+    readonly firstMessage: StreamMessage<AgentEvent> | undefined;
+}
+/**
+ * Resolves where a stream starts and checks the Dex resume token with one short read.
+ *
+ * A token that Dex rejects, such as a forged one, restarts the stream from the turn's first retained
+ * event, which the Server lists itself.
+ * @returns The start, or `undefined` when there is nothing to stream.
+ * @throws {TypeError} When the resume token is invalid.
+ */
+export declare function prepareAgentUIStreamStart(options: AgentUIMessageStreamOptions): Promise<AgentUIStreamStart | undefined>;
+/** Checks a cursor's Dex resume token, replacing a rejected one with the turn's listed start. */
+export declare function probeAgentUIStreamStart(client: Client, flow: AgentSessionFlow<AgentFrameworkRunner<DeferredToolOutcome>>, flowId: string, cursor: AgentUIStreamCursor): Promise<AgentUIStreamStart | undefined>;
+/**
+ * Returns the cursor where a stream starts, or `undefined` when there is nothing to stream.
+ * @throws {TypeError} When the resume token is invalid.
+ */
+export declare function resolveAgentUIStreamStartCursor(options: AgentUIMessageStreamOptions): Promise<AgentUIStreamCursor | undefined>;
+/**
+ * Returns a cursor that replays a turn from its first retained event, or `undefined` when none is retained.
+ * @param knownTurnStartResumeToken - The turn's start position recorded in a cursor, or `null` to search.
+ */
+export declare function createTurnReplayCursor(client: Client, flow: AgentSessionFlow<AgentFrameworkRunner<DeferredToolOutcome>>, flowId: string, turnId: string, knownTurnStartResumeToken: string | null): Promise<AgentUIStreamCursor | undefined>;
+/**
+ * Reads events from the cursor and yields the parts of each one.
+ * Yields `undefined` after an empty long poll, so a response can send a keep-alive comment.
+ */
+export declare function readAgentUIMessageChunkBatches(options: AgentUIMessageStreamOptions, start: AgentUIStreamStart, pollTimeoutMs: number): AsyncGenerator<AgentUIMessageChunk[] | undefined, void, undefined>;
+/** Parses tool arguments JSON text; text that is not JSON stays a string. */
+export declare function parseToolArguments(toolArguments: string | null | undefined): unknown;