@teaflask/assistant 0.0.0 → 0.3.0

package/dist/transport/stream-resume.d.ts

@@ -0,0 +1,128 @@
+import type { AgentSubscriber } from "@ag-ui/client";
+import type { Message } from "@ag-ui/core";
+import { type MemoryUpdated } from "../core/memory-provenance-anchors.js";
+import type { BlockTiming } from "../core/segment-timing.js";
+import { type TurnUsage } from "../core/turn-usage-anchors.js";
+import type { ToolCallDisplay } from "../core/tool-call-display.js";
+import type { ToolCallSchemas } from "../core/tool-schema-anchors.js";
+import { type ToolDenialLedger, type ToolDenialMarker } from "../core/tool-denial-anchors.js";
+import { type DeliveredResult } from "../core/subagent-delivery-anchors.js";
+import { type AnchoredTurnFailReceipts } from "../core/turn-failed-anchors.js";
+export interface ResumeSnapshot {
+    afterId: string;
+    messages: Message[];
+}
+/**
+ * A conversation's resume state, held above the Transcript remount
+ * boundary: reconnect works by remounting a fresh agent, so anything the
+ * next connection needs must outlive the current one.
+ *
+ * A snapshot is a consistent pair — the applied message list and the
+ * cursor of the newest received frame — recorded at any BLOCK-COMPLETE,
+ * non-failed close that committed a cursor: a settled terminal, or the
+ * parked contract's quiet close (a background attach seeds its
+ * fresh agent from this pair, and a parked page whose close recorded
+ * nothing would re-seed an EMPTY transcript). A snapshot is never proof
+ * the run settled — only that the pair is consistent. A mid-BLOCK
+ * interruption keeps the previous pair; the server re-delivers the
+ * unsettled run in full from its boundary, and the seeded agent de-dupes
+ * by the contract's stable ids.
+ */
+export declare class StreamResumeStore {
+    snapshot: ResumeSnapshot | null;
+    readonly resumeAnchors: Map<string, unknown>;
+    turnFailedAnchors: ReadonlyMap<string, AnchoredTurnFailReceipts>;
+    toolErrorAnchors: ReadonlyMap<string, string>;
+    toolRefusalAnchors: ReadonlyMap<string, string>;
+    toolCancelAnchors: ReadonlySet<string>;
+    toolOffloadAnchors: ReadonlySet<string>;
+    toolDecisionAnchors: ReadonlySet<string>;
+    toolDenialLedger: ToolDenialLedger;
+    toolCallDisplayAnchors: ReadonlyMap<string, ToolCallDisplay>;
+    toolSchemaAnchors: ReadonlyMap<string, ToolCallSchemas>;
+    subagentDeliveryAnchors: ReadonlyMap<string, DeliveredResult[]>;
+    blockTimingRevision: number;
+    private readonly _blockTimingAnchors;
+    get blockTimingAnchors(): ReadonlyMap<string, BlockTiming>;
+    turnUsageAnchors: ReadonlyMap<string, TurnUsage>;
+    memoryProvenanceAnchors: ReadonlyMap<string, MemoryUpdated>;
+    memoryAttributionAnchors: ReadonlyMap<string, string>;
+    private readonly anchoredResumptions;
+    private readonly anchoredFailedRuns;
+    private readonly anchoredDeliveryRuns;
+    /** Returns false when this resumption already anchored. Keyed by run id
+     *  plus the payload's own (round, attempt) — a round-less legacy row by the
+     *  marker's stamped timestamp; premises: docs/stream-resume.md. */
+    recordResumeAnchor(runId: string | null, messageId: string, markerValue: unknown, markerTimestamp: number | null): boolean;
+    /** Returns false when this failed run's receipt already anchored. */
+    recordTurnFailedReceipts(failedRunId: string, messageId: string, position: keyof AnchoredTurnFailReceipts, receipts: string[]): boolean;
+    /** Returns false when this delivery run's receipt already anchored. */
+    recordSubagentDelivery(deliveryRunId: string, messageId: string, results: DeliveredResult[]): boolean;
+    recordToolError(toolCallId: string, errorText: string): void;
+    recordToolRefusal(toolCallId: string, sentence: string): void;
+    recordToolCancel(toolCallId: string): void;
+    recordToolDecision(toolCallId: string): void;
+    recordToolDenialMarker(marker: ToolDenialMarker): void;
+    recordToolOffload(toolCallId: string): void;
+    recordToolCallDisplay(toolCallId: string, display: ToolCallDisplay): void;
+    recordToolSchemas(toolCallId: string, schemas: ToolCallSchemas): void;
+    recordBlockTiming(blockId: string, observedAtMs: number): void;
+    recordTurnUsage(usage: TurnUsage): void;
+    recordMemoryUpdate(update: MemoryUpdated): void;
+    recordMemoryAttribution(memoryId: string, messageId: string): void;
+    /** Records the resume pair. Named for what it records — a consistent
+     *  (messages, cursor) PAIR, at any block-complete close, terminal or
+     *  quiet — never an assertion that the run settled (the recording
+     *  rule lives at resumeSnapshotRecorder). */
+    recordPair(afterId: string, messages: readonly Readonly<Message>[]): void;
+}
+/**
+ * A run_resumed CUSTOM event never becomes a message, so it cannot be
+ * read from the message list alone. This subscriber anchors each marker
+ * to the first message that appears after it; the transcript's
+ * severance scan reads the anchor to mark the prior attempt's
+ * open calls as interrupted.
+ */
+export declare function resumeMarkerRecorder(onResumeAnchored: (runId: string | null, messageId: string, markerValue: unknown, markerTimestamp: number | null) => void): AgentSubscriber;
+/**
+ * The subscriber that records a resume pair: at any close that is
+ * BLOCK-COMPLETE (every block START this connection applied has its END),
+ * non-failed, and committed a cursor — terminal or quiet. The
+ * premises, and what breaks if the gate is wrong: docs/stream-resume.md.
+ *
+ * A resumed stream that closed silently applied nothing and committed
+ * no cursor — the cursor guard keeps the previous pair. The state
+ * resets per run: one agent can be connected more than once, and a
+ * stale failure must not veto (or stale completeness approve) a later
+ * run's recording.
+ *
+ * Subscribe this through the component tree, never on a bare agent: only
+ * the mounted agent's message list carries the injector's spliced user
+ * messages, and an orphaned connection recording its bare list would
+ * poison the store.
+ */
+export declare function resumeSnapshotRecorder(cursorOf: () => string | null, store: StreamResumeStore): AgentSubscriber;
+type AuthorizedFetch = (url: string, requestInit: RequestInit) => Promise<Response>;
+/**
+ * Reads the SSE `id:` lines off the raw response bytes. `@ag-ui/client`'s
+ * parser surfaces only `data:` lines, so the cursor is captured by teeing
+ * the body through a pass-through transform — bytes reach the parser
+ * untouched. An id is committed only at its frame's terminating blank
+ * line: an `id:` whose frame never completed was never dispatched by the
+ * parser either, and must not advance the cursor.
+ */
+export declare class SseFrameIdScanner {
+    lastEventId: string | null;
+    bodyBytesSeen: boolean;
+    private buffer;
+    private pendingId;
+    private frameHasData;
+    private decoder;
+    wrap(fetchFn: AuthorizedFetch): AuthorizedFetch;
+    private _scannedCopyOf;
+    private _resetConnectionState;
+    private _scan;
+    private _scanLine;
+}
+export {};
+//# sourceMappingURL=stream-resume.d.ts.map

package/dist/transport/stream-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-resume.d.ts","sourceRoot":"","sources":["../../src/transport/stream-resume.ts"],"names":[],"mappings":"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"}

package/dist/transport/stream-resume.js

@@ -0,0 +1,454 @@
+import { EventType } from "@ag-ui/core";
+import { RUN_RESUMED_EVENT_NAME } from "../contract/events.js";
+import { foldBlockTimingObserved } from "../core/block-timing-anchors.js";
+import { EMPTY_MEMORY_ATTRIBUTION_ANCHORS, EMPTY_MEMORY_PROVENANCE_ANCHORS, withMemoryAttributed, withMemoryUpdateAnchored, } from "../core/memory-provenance-anchors.js";
+import { EMPTY_TURN_USAGE_ANCHORS, withTurnUsageAnchored, } from "../core/turn-usage-anchors.js";
+import { EMPTY_TOOL_SCHEMA_ANCHORS, withToolSchemasAnchored, } from "../core/tool-schema-anchors.js";
+import { EMPTY_TOOL_CALL_DISPLAY_ANCHORS, withToolCallDisplayAnchored, } from "../core/tool-call-display-anchors.js";
+import { EMPTY_TOOL_CANCEL_ANCHORS, withToolCancelAnchored, } from "../core/tool-cancel-anchors.js";
+import { EMPTY_TOOL_DECISION_ANCHORS, withToolDecisionAnchored, } from "../core/tool-decision-anchors.js";
+import { EMPTY_TOOL_DENIAL_LEDGER, withToolDenialMarkerFolded, } from "../core/tool-denial-anchors.js";
+import { EMPTY_TOOL_ERROR_ANCHORS, withToolErrorAnchored, } from "../core/tool-error-anchors.js";
+import { EMPTY_TOOL_REFUSAL_ANCHORS, withToolRefusalAnchored, } from "../core/tool-refusal-anchors.js";
+import { EMPTY_TOOL_OFFLOAD_ANCHORS, withToolOffloadAnchored, } from "../core/tool-offload-anchors.js";
+import { EMPTY_SUBAGENT_DELIVERY_ANCHORS, withSubagentDeliveryAnchored, } from "../core/subagent-delivery-anchors.js";
+import { EMPTY_TURN_FAILED_ANCHORS, withTurnFailedAnchored, } from "../core/turn-failed-anchors.js";
+/**
+ * A conversation's resume state, held above the Transcript remount
+ * boundary: reconnect works by remounting a fresh agent, so anything the
+ * next connection needs must outlive the current one.
+ *
+ * A snapshot is a consistent pair — the applied message list and the
+ * cursor of the newest received frame — recorded at any BLOCK-COMPLETE,
+ * non-failed close that committed a cursor: a settled terminal, or the
+ * parked contract's quiet close (a background attach seeds its
+ * fresh agent from this pair, and a parked page whose close recorded
+ * nothing would re-seed an EMPTY transcript). A snapshot is never proof
+ * the run settled — only that the pair is consistent. A mid-BLOCK
+ * interruption keeps the previous pair; the server re-delivers the
+ * unsettled run in full from its boundary, and the seeded agent de-dupes
+ * by the contract's stable ids.
+ */
+export class StreamResumeStore {
+    snapshot = null;
+    // Resume anchors survive remounts here: a resumed stream never replays
+    // the historical run_resumed markers the severance scan reads.
+    // Each anchor keeps its marker's raw payload as provenance — the wire
+    // (round, attempt) the arbitration key was derived from.
+    resumeAnchors = new Map();
+    // Failure-receipt anchors survive remounts for a sharper reason than
+    // their siblings: a failed run's recorded RUN_ERROR demotes to
+    // RUN_FINISHED on replay, but the turn_failed marker replays verbatim,
+    // so a reconnect re-anchors it idempotently. Same degrade seam.
+    turnFailedAnchors = EMPTY_TURN_FAILED_ANCHORS;
+    // The four tool-outcome anchor families below survive remounts for the
+    // same reason: the transport lifts the wire's TOOL_CALL_RESULT extras
+    // into event metadata (core/tool-outcome.ts) and the 1.0 client carries
+    // that metadata onto the tool message it mints, but a snapshot-seeded
+    // reconnect replays only past the cursor — so these maps and sets are
+    // what re-anchors historical calls, and the read path the projection
+    // consults for every call.
+    toolErrorAnchors = EMPTY_TOOL_ERROR_ANCHORS;
+    toolRefusalAnchors = EMPTY_TOOL_REFUSAL_ANCHORS;
+    toolCancelAnchors = EMPTY_TOOL_CANCEL_ANCHORS;
+    toolOffloadAnchors = EMPTY_TOOL_OFFLOAD_ANCHORS;
+    // Tool-decision anchors: the durable "a member decision rode
+    // this call" record the placement hold reads. The card stores prune at
+    // the gated call's result and the turn's settle by design, and a
+    // snapshot-seeded reconnect replays only past the cursor, so this set
+    // is the decision-bearing calls' only durable home.
+    toolDecisionAnchors = EMPTY_TOOL_DECISION_ANCHORS;
+    // The tool-denial ledger: the durable "a member declined this
+    // call's approval" record the state ladder reads, joined from the two
+    // approval markers. The inbox card that knew the same fact dies to the
+    // gated call's cancelled result by design, and a snapshot-seeded
+    // reconnect replays only past the cursor — so this ledger is the
+    // denied calls' only durable home, and its ask map is what lets a
+    // resolution streamed after the cursor still find its call.
+    toolDenialLedger = EMPTY_TOOL_DENIAL_LEDGER;
+    // Display anchors survive remounts for the same reason: the
+    // tool_call_annotated marker never becomes a message, and a
+    // snapshot-seeded reconnect replays only past the cursor, so this map
+    // is historical rows' only source of backend-authored copy.
+    toolCallDisplayAnchors = EMPTY_TOOL_CALL_DISPLAY_ANCHORS;
+    // Schema anchors survive remounts for the same reason: the
+    // schemas ride the same marker's siblings (and the approval card's
+    // fields), never a message, so this map is the calls' only client home
+    // for argsSchema / resultSchema.
+    toolSchemaAnchors = EMPTY_TOOL_SCHEMA_ANCHORS;
+    // Delivery-receipt anchors survive remounts for the same reason: a
+    // snapshot-seeded reconnect replays only past the cursor, so the
+    // historical subagent_results_delivered markers the dividers were
+    // derived from never re-arrive on the wire. Same degrade seam: the
+    // transcript re-validates on seed, so a malformed entry becomes a
+    // missing row, never a wedged resume.
+    subagentDeliveryAnchors = EMPTY_SUBAGENT_DELIVERY_ANCHORS;
+    // Block-timing anchors survive remounts for the same reason:
+    // the client carries no per-event server timestamp onto the messages it
+    // builds, and a snapshot-seeded reconnect replays only past the cursor,
+    // so this map is historical blocks' only timing home.
+    // Unlike every sibling anchor, the backing map MUTATES: timing moves
+    // on every block boundary, and a copy-per-write would cost O(N) per
+    // event — O(N²) over an N-block replay — so blockTimingRevision, not
+    // map identity, is the change signal (entries stay immutable; the
+    // snapshot derivation copies before publishing).
+    blockTimingRevision = 0;
+    _blockTimingAnchors = new Map();
+    get blockTimingAnchors() {
+        return this._blockTimingAnchors;
+    }
+    // Turn-usage anchors survive remounts for the same reason:
+    // the turn_usage_recorded marker never becomes a message. Absence
+    // means usage unknown — the number hides, never estimates.
+    turnUsageAnchors = EMPTY_TURN_USAGE_ANCHORS;
+    // Memory-provenance anchors survive remounts for the same
+    // reason: the memory_updated marker never becomes a message. Keyed by
+    // the durable memory id, so re-deliveries reconcile, never duplicate.
+    memoryProvenanceAnchors = EMPTY_MEMORY_PROVENANCE_ANCHORS;
+    // Memory-attribution anchors: memory id → the assistant
+    // prose message its footer renders under. Survives remounts with its
+    // provenance sibling; first attribution wins (the anchor family's
+    // drifted-message arbitration), so a re-delivery never moves a footer.
+    memoryAttributionAnchors = EMPTY_MEMORY_ATTRIBUTION_ANCHORS;
+    // One anchor per RESUMPTION, ever: the parked snapshot's
+    // cursor sits inside an unsettled run, so a background attach's
+    // boundary-snap re-delivers that run in full — content filtered,
+    // CUSTOM markers passed by design — and an unarbitrated run_resumed
+    // would flush under a drifted message id (the first post-attach
+    // message). Keyed by run id plus the payload's own (round, attempt)
+    // — round-less legacy rows by their event's stamped timestamp — wire
+    // data either way, no client-side counting; the premise
+    // lives at recordResumeAnchor.
+    anchoredResumptions = new Set();
+    // One receipt row per failed run, ever: re-deliveries (StrictMode's
+    // double connection, every reconnect's replay) flush against whatever
+    // the message list holds at that moment, so the same receipt can try
+    // to anchor under a different message id. First anchor wins.
+    anchoredFailedRuns = new Set();
+    // One divider per delivery run, ever: a re-delivery flushes against
+    // whatever the message list holds at that moment, so the same divider
+    // can try to anchor under a drifted message id — the run's own id
+    // arbitrates, first anchor wins.
+    anchoredDeliveryRuns = new Set();
+    /** Returns false when this resumption already anchored. Keyed by run id
+     *  plus the payload's own (round, attempt) — a round-less legacy row by the
+     *  marker's stamped timestamp; premises: docs/stream-resume.md. */
+    // markerTimestamp is REQUIRED, not defaulted: the untimed collapse
+    // branch is a documented degradation, and a caller must say null out
+    // loud to land on it — never arrive there by omitting an argument.
+    recordResumeAnchor(runId, messageId, markerValue, markerTimestamp) {
+        const attempt = _wireCounterOf(markerValue, "attempt");
+        const carriesRound = typeof markerValue === "object" &&
+            markerValue !== null &&
+            typeof markerValue.round === "number";
+        const key = carriesRound
+            ? `${runId ?? "unknown-run"}#${String(_wireCounterOf(markerValue, "round"))}#${String(attempt)}`
+            : `${runId ?? "unknown-run"}#legacy:${markerTimestamp === null ? "untimed" : String(markerTimestamp)}#${String(attempt)}`;
+        if (this.anchoredResumptions.has(key)) {
+            return false;
+        }
+        this.anchoredResumptions.add(key);
+        // Null, never undefined: consumers read presence with .get(), and a
+        // payload-less legacy marker must still read as anchored.
+        this.resumeAnchors.set(messageId, markerValue ?? null);
+        return true;
+    }
+    /** Returns false when this failed run's receipt already anchored. */
+    recordTurnFailedReceipts(failedRunId, messageId, position, receipts) {
+        if (this.anchoredFailedRuns.has(failedRunId)) {
+            return false;
+        }
+        this.anchoredFailedRuns.add(failedRunId);
+        this.turnFailedAnchors = withTurnFailedAnchored(this.turnFailedAnchors, messageId, position, receipts);
+        return true;
+    }
+    /** Returns false when this delivery run's receipt already anchored. */
+    recordSubagentDelivery(deliveryRunId, messageId, results) {
+        if (this.anchoredDeliveryRuns.has(deliveryRunId)) {
+            return false;
+        }
+        this.anchoredDeliveryRuns.add(deliveryRunId);
+        this.subagentDeliveryAnchors = withSubagentDeliveryAnchored(this.subagentDeliveryAnchors, messageId, results);
+        return true;
+    }
+    recordToolError(toolCallId, errorText) {
+        this.toolErrorAnchors = withToolErrorAnchored(this.toolErrorAnchors, toolCallId, errorText);
+    }
+    recordToolRefusal(toolCallId, sentence) {
+        this.toolRefusalAnchors = withToolRefusalAnchored(this.toolRefusalAnchors, toolCallId, sentence);
+    }
+    recordToolCancel(toolCallId) {
+        this.toolCancelAnchors = withToolCancelAnchored(this.toolCancelAnchors, toolCallId);
+    }
+    recordToolDecision(toolCallId) {
+        this.toolDecisionAnchors = withToolDecisionAnchored(this.toolDecisionAnchors, toolCallId);
+    }
+    recordToolDenialMarker(marker) {
+        this.toolDenialLedger = withToolDenialMarkerFolded(this.toolDenialLedger, marker);
+    }
+    recordToolOffload(toolCallId) {
+        this.toolOffloadAnchors = withToolOffloadAnchored(this.toolOffloadAnchors, toolCallId);
+    }
+    recordToolCallDisplay(toolCallId, display) {
+        this.toolCallDisplayAnchors = withToolCallDisplayAnchored(this.toolCallDisplayAnchors, toolCallId, display);
+    }
+    recordToolSchemas(toolCallId, schemas) {
+        this.toolSchemaAnchors = withToolSchemasAnchored(this.toolSchemaAnchors, toolCallId, schemas);
+    }
+    recordBlockTiming(blockId, observedAtMs) {
+        if (foldBlockTimingObserved(this._blockTimingAnchors, blockId, observedAtMs)) {
+            this.blockTimingRevision += 1;
+        }
+    }
+    recordTurnUsage(usage) {
+        this.turnUsageAnchors = withTurnUsageAnchored(this.turnUsageAnchors, usage);
+    }
+    recordMemoryUpdate(update) {
+        this.memoryProvenanceAnchors = withMemoryUpdateAnchored(this.memoryProvenanceAnchors, update);
+    }
+    recordMemoryAttribution(memoryId, messageId) {
+        this.memoryAttributionAnchors = withMemoryAttributed(this.memoryAttributionAnchors, memoryId, messageId);
+    }
+    /** Records the resume pair. Named for what it records — a consistent
+     *  (messages, cursor) PAIR, at any block-complete close, terminal or
+     *  quiet — never an assertion that the run settled (the recording
+     *  rule lives at resumeSnapshotRecorder). */
+    recordPair(afterId, messages) {
+        this.snapshot = { afterId, messages: structuredClone([...messages]) };
+    }
+}
+/** The tolerant wire read behind the resume arbitration key (the
+ *  approval-inbox idiom): legacy markers may carry no payload at all,
+ *  so a missing or non-numeric field reads as 0. Round-less rows never
+ *  reach the round read — the key's legacy branch uses the event's
+ *  stamped timestamp instead (see recordResumeAnchor). */
+function _wireCounterOf(payload, field) {
+    if (typeof payload !== "object" || payload === null) {
+        return 0;
+    }
+    const value = payload[field];
+    return typeof value === "number" ? value : 0;
+}
+/**
+ * A run_resumed CUSTOM event never becomes a message, so it cannot be
+ * read from the message list alone. This subscriber anchors each marker
+ * to the first message that appears after it; the transcript's
+ * severance scan reads the anchor to mark the prior attempt's
+ * open calls as interrupted.
+ */
+export function resumeMarkerRecorder(onResumeAnchored) {
+    // Null (never undefined) doubles as both "no marker pending" reset and
+    // a payload-less legacy marker; pendingMarker tracks presence itself.
+    // The marker remembers the run it rode in on, plus the event's own
+    // stamped timestamp (read off the raw event, because the apply pipeline
+    // drops it); the store derives the arbitration key from the run id and the
+    // payload's own (round, attempt), falling back to the timestamp for
+    // round-less legacy rows — no ordinal is counted here.
+    let pendingMarker = null;
+    let currentRunId = null;
+    return {
+        onRunStartedEvent({ event }) {
+            currentRunId = event.runId;
+        },
+        onCustomEvent({ event }) {
+            if (event.name === RUN_RESUMED_EVENT_NAME) {
+                pendingMarker = {
+                    runId: currentRunId,
+                    value: event.value,
+                    timestamp: typeof event.timestamp === "number" ? event.timestamp : null,
+                };
+            }
+        },
+        onMessagesChanged({ messages }) {
+            const newestMessage = messages.at(-1);
+            if (pendingMarker === null || newestMessage === undefined) {
+                return;
+            }
+            const marker = pendingMarker;
+            pendingMarker = null;
+            onResumeAnchored(marker.runId, newestMessage.id, marker.value, marker.timestamp);
+        },
+    };
+}
+/**
+ * The subscriber that records a resume pair: at any close that is
+ * BLOCK-COMPLETE (every block START this connection applied has its END),
+ * non-failed, and committed a cursor — terminal or quiet. The
+ * premises, and what breaks if the gate is wrong: docs/stream-resume.md.
+ *
+ * A resumed stream that closed silently applied nothing and committed
+ * no cursor — the cursor guard keeps the previous pair. The state
+ * resets per run: one agent can be connected more than once, and a
+ * stale failure must not veto (or stale completeness approve) a later
+ * run's recording.
+ *
+ * Subscribe this through the component tree, never on a bare agent: only
+ * the mounted agent's message list carries the injector's spliced user
+ * messages, and an orphaned connection recording its bare list would
+ * poison the store.
+ */
+export function resumeSnapshotRecorder(cursorOf, store) {
+    let failed = false;
+    const openBlocks = new Set();
+    return {
+        onRunInitialized() {
+            failed = false;
+            openBlocks.clear();
+        },
+        // The pipeline routes run lifecycle to the dedicated handlers and
+        // everything else (content, markers) through onEvent — where the
+        // block ledger tracks every START against its END.
+        onEvent({ event }) {
+            const edge = _blockEdgeOf(event);
+            if (edge === null) {
+                return;
+            }
+            if (edge.opens) {
+                openBlocks.add(edge.key);
+            }
+            else {
+                openBlocks.delete(edge.key);
+            }
+        },
+        onRunFailed() {
+            failed = true;
+        },
+        onRunFinalized({ messages }) {
+            // By finalize the scanner has seen every byte the parser
+            // dispatched, so the cursor and the applied messages agree.
+            const cursor = cursorOf();
+            if (!failed && openBlocks.size === 0 && cursor !== null) {
+                store.recordPair(cursor, messages);
+            }
+        },
+    };
+}
+/** The block ledger's edges: which events open a content block and which
+ *  close it, keyed so unrelated block families cannot cancel each other.
+ *  Atomic events (TOOL_CALL_RESULT, markers, lifecycle) hold no open
+ *  state and return null. */
+function _blockEdgeOf(event) {
+    const messageKey = () => `message:${event.messageId}`;
+    const toolKey = () => `tool:${event.toolCallId}`;
+    switch (event.type) {
+        case EventType.TEXT_MESSAGE_START:
+            return { key: messageKey(), opens: true };
+        case EventType.TEXT_MESSAGE_END:
+            return { key: messageKey(), opens: false };
+        case EventType.TOOL_CALL_START:
+            return { key: toolKey(), opens: true };
+        case EventType.TOOL_CALL_END:
+            return { key: toolKey(), opens: false };
+        case EventType.REASONING_START:
+            return { key: `reasoning:${messageKey()}`, opens: true };
+        case EventType.REASONING_END:
+            return { key: `reasoning:${messageKey()}`, opens: false };
+        case EventType.REASONING_MESSAGE_START:
+            return { key: `reasoning-message:${messageKey()}`, opens: true };
+        case EventType.REASONING_MESSAGE_END:
+            return { key: `reasoning-message:${messageKey()}`, opens: false };
+        default:
+            return null;
+    }
+}
+// The id: line carries a decimal integer by contract; anything else on
+// the wire is not a cursor and must not be echoed back.
+const DECIMAL_ID = /^\d+$/;
+/**
+ * Reads the SSE `id:` lines off the raw response bytes. `@ag-ui/client`'s
+ * parser surfaces only `data:` lines, so the cursor is captured by teeing
+ * the body through a pass-through transform — bytes reach the parser
+ * untouched. An id is committed only at its frame's terminating blank
+ * line: an `id:` whose frame never completed was never dispatched by the
+ * parser either, and must not advance the cursor.
+ */
+export class SseFrameIdScanner {
+    lastEventId = null;
+    // Whether THIS connection's SSE body has delivered any bytes at all —
+    // keepalive comment frames included, since they never commit a cursor
+    // but do prove the wire was alive past the headers. The liveness fact
+    // for failure classification, kept apart from lastEventId on
+    // purpose: the replay cursor answers "what do we replay past", not
+    // "did bytes flow", and overloading it misread keepalive-only
+    // connections as never-responded.
+    bodyBytesSeen = false;
+    buffer = "";
+    pendingId = null;
+    frameHasData = false;
+    decoder = new TextDecoder();
+    wrap(fetchFn) {
+        return async (url, requestInit) => {
+            const response = await fetchFn(url, requestInit);
+            if (!response.ok || response.body === null || !_isEventStream(response)) {
+                return response;
+            }
+            this._resetConnectionState();
+            return new Response(this._scannedCopyOf(response.body), {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+            });
+        };
+    }
+    // A hand-rolled pump instead of pipeThrough(TransformStream): the pipe's
+    // internal promise surfaces source errors as unhandled rejections (Node),
+    // while a rejecting pull() errors the stream through a handled path.
+    _scannedCopyOf(body) {
+        const reader = body.getReader();
+        return new ReadableStream({
+            pull: async (controller) => {
+                const { done, value } = await reader.read();
+                if (done) {
+                    controller.close();
+                    return;
+                }
+                this._scan(value);
+                controller.enqueue(value);
+            },
+            // Cancelling an already-errored source rejects; the stream is being
+            // abandoned either way, so that rejection must not escape.
+            cancel: (reason) => reader.cancel(reason).catch(() => undefined),
+        });
+    }
+    // A retried connection must not inherit the previous body's partial
+    // line or frame — nor its liveness fact; the committed cursor survives
+    // on purpose.
+    _resetConnectionState() {
+        this.buffer = "";
+        this.pendingId = null;
+        this.frameHasData = false;
+        this.bodyBytesSeen = false;
+        this.decoder = new TextDecoder();
+    }
+    _scan(chunk) {
+        this.bodyBytesSeen = true;
+        this.buffer += this.decoder.decode(chunk, { stream: true });
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            this._scanLine(line);
+        }
+    }
+    _scanLine(line) {
+        if (line === "") {
+            if (this.pendingId !== null && this.frameHasData) {
+                this.lastEventId = this.pendingId;
+            }
+            this.pendingId = null;
+            this.frameHasData = false;
+            return;
+        }
+        if (line.startsWith("id:")) {
+            const value = line.slice("id:".length).replace(/^ /, "");
+            this.pendingId = DECIMAL_ID.test(value) ? value : null;
+        }
+        else if (line.startsWith("data:")) {
+            this.frameHasData = true;
+        }
+    }
+}
+function _isEventStream(response) {
+    const contentType = response.headers.get("content-type") ?? "";
+    return contentType.startsWith("text/event-stream");
+}
+//# sourceMappingURL=stream-resume.js.map

package/dist/transport/stream-resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-resume.js","sourceRoot":"","sources":["../../src/transport/stream-resume.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,oBAAoB,EACpB,wBAAwB,GAEzB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAG3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,GAE7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,gCAAgC,CAAC;AAYxC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iBAAiB;IAC5B,QAAQ,GAA0B,IAAI,CAAC;IACvC,uEAAuE;IACvE,+DAA+D;IAC/D,sEAAsE;IACtE,yDAAyD;IAChD,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IACpD,qEAAqE;IACrE,+DAA+D;IAC/D,uEAAuE;IACvE,gEAAgE;IAChE,iBAAiB,GACf,yBAAyB,CAAC;IAC5B,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,sEAAsE;IACtE,sEAAsE;IACtE,qEAAqE;IACrE,2BAA2B;IAC3B,gBAAgB,GAAgC,wBAAwB,CAAC;IACzE,kBAAkB,GAAgC,0BAA0B,CAAC;IAC7E,iBAAiB,GAAwB,yBAAyB,CAAC;IACnE,kBAAkB,GAAwB,0BAA0B,CAAC;IACrE,6DAA6D;IAC7D,uEAAuE;IACvE,iEAAiE;IACjE,sEAAsE;IACtE,oDAAoD;IACpD,mBAAmB,GAAwB,2BAA2B,CAAC;IACvE,8DAA8D;IAC9D,sEAAsE;IACtE,uEAAuE;IACvE,iEAAiE;IACjE,iEAAiE;IACjE,kEAAkE;IAClE,4DAA4D;IAC5D,gBAAgB,GAAqB,wBAAwB,CAAC;IAC9D,4DAA4D;IAC5D,4DAA4D;IAC5D,sEAAsE;IACtE,4DAA4D;IAC5D,sBAAsB,GACpB,+BAA+B,CAAC;IAClC,2DAA2D;IAC3D,mEAAmE;IACnE,uEAAuE;IACvE,iCAAiC;IACjC,iBAAiB,GACf,yBAAyB,CAAC;IAC5B,mEAAmE;IACnE,iEAAiE;IACjE,kEAAkE;IAClE,mEAAmE;IACnE,kEAAkE;IAClE,sCAAsC;IACtC,uBAAuB,GACrB,+BAA+B,CAAC;IAClC,6DAA6D;IAC7D,wEAAwE;IACxE,wEAAwE;IACxE,sDAAsD;IACtD,qEAAqE;IACrE,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,iDAAiD;IACjD,mBAAmB,GAAG,CAAC,CAAC;IACP,mBAAmB,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEtE,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IACD,2DAA2D;IAC3D,kEAAkE;IAClE,2DAA2D;IAC3D,gBAAgB,GAAmC,wBAAwB,CAAC;IAC5E,0DAA0D;IAC1D,sEAAsE;IACtE,sEAAsE;IACtE,uBAAuB,GACrB,+BAA+B,CAAC;IAClC,wDAAwD;IACxD,qEAAqE;IACrE,kEAAkE;IAClE,uEAAuE;IACvE,wBAAwB,GACtB,gCAAgC,CAAC;IACnC,yDAAyD;IACzD,gEAAgE;IAChE,iEAAiE;IACjE,oEAAoE;IACpE,gEAAgE;IAChE,oEAAoE;IACpE,qEAAqE;IACrE,wDAAwD;IACxD,+BAA+B;IACd,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IACzD,oEAAoE;IACpE,sEAAsE;IACtE,qEAAqE;IACrE,6DAA6D;IAC5C,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IACxD,oEAAoE;IACpE,sEAAsE;IACtE,kEAAkE;IAClE,iCAAiC;IAChB,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1D;;uEAEmE;IACnE,mEAAmE;IACnE,qEAAqE;IACrE,mEAAmE;IACnE,kBAAkB,CAChB,KAAoB,EACpB,SAAiB,EACjB,WAAoB,EACpB,eAA8B;QAE9B,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,YAAY,GAChB,OAAO,WAAW,KAAK,QAAQ;YAC/B,WAAW,KAAK,IAAI;YACpB,OAAQ,WAAuC,CAAC,KAAK,KAAK,QAAQ,CAAC;QACrE,MAAM,GAAG,GAAG,YAAY;YACtB,CAAC,CAAC,GAAG,KAAK,IAAI,aAAa,IAAI,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE;YAChG,CAAC,CAAC,GAAG,KAAK,IAAI,aAAa,WAAW,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5H,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,oEAAoE;QACpE,0DAA0D;QAC1D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IACrE,wBAAwB,CACtB,WAAmB,EACnB,SAAiB,EACjB,QAAwC,EACxC,QAAkB;QAElB,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,iBAAiB,GAAG,sBAAsB,CAC7C,IAAI,CAAC,iBAAiB,EACtB,SAAS,EACT,QAAQ,EACR,QAAQ,CACT,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CACpB,aAAqB,EACrB,SAAiB,EACjB,OAA0B;QAE1B,IAAI,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,uBAAuB,GAAG,4BAA4B,CACzD,IAAI,CAAC,uBAAuB,EAC5B,SAAS,EACT,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,eAAe,CAAC,UAAkB,EAAE,SAAiB;QACnD,IAAI,CAAC,gBAAgB,GAAG,qBAAqB,CAC3C,IAAI,CAAC,gBAAgB,EACrB,UAAU,EACV,SAAS,CACV,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,UAAkB,EAAE,QAAgB;QACpD,IAAI,CAAC,kBAAkB,GAAG,uBAAuB,CAC/C,IAAI,CAAC,kBAAkB,EACvB,UAAU,EACV,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,UAAkB;QACjC,IAAI,CAAC,iBAAiB,GAAG,sBAAsB,CAC7C,IAAI,CAAC,iBAAiB,EACtB,UAAU,CACX,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,mBAAmB,GAAG,wBAAwB,CACjD,IAAI,CAAC,mBAAmB,EACxB,UAAU,CACX,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,MAAwB;QAC7C,IAAI,CAAC,gBAAgB,GAAG,0BAA0B,CAChD,IAAI,CAAC,gBAAgB,EACrB,MAAM,CACP,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,IAAI,CAAC,kBAAkB,GAAG,uBAAuB,CAC/C,IAAI,CAAC,kBAAkB,EACvB,UAAU,CACX,CAAC;IACJ,CAAC;IAED,qBAAqB,CAAC,UAAkB,EAAE,OAAwB;QAChE,IAAI,CAAC,sBAAsB,GAAG,2BAA2B,CACvD,IAAI,CAAC,sBAAsB,EAC3B,UAAU,EACV,OAAO,CACR,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,UAAkB,EAAE,OAAwB;QAC5D,IAAI,CAAC,iBAAiB,GAAG,uBAAuB,CAC9C,IAAI,CAAC,iBAAiB,EACtB,UAAU,EACV,OAAO,CACR,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,OAAe,EAAE,YAAoB;QACrD,IACE,uBAAuB,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,EAAE,YAAY,CAAC,EACxE,CAAC;YACD,IAAI,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,eAAe,CAAC,KAAgB;QAC9B,IAAI,CAAC,gBAAgB,GAAG,qBAAqB,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IAED,kBAAkB,CAAC,MAAqB;QACtC,IAAI,CAAC,uBAAuB,GAAG,wBAAwB,CACrD,IAAI,CAAC,uBAAuB,EAC5B,MAAM,CACP,CAAC;IACJ,CAAC;IAED,uBAAuB,CAAC,QAAgB,EAAE,SAAiB;QACzD,IAAI,CAAC,wBAAwB,GAAG,oBAAoB,CAClD,IAAI,CAAC,wBAAwB,EAC7B,QAAQ,EACR,SAAS,CACV,CAAC;IACJ,CAAC;IAED;;;iDAG6C;IAC7C,UAAU,CAAC,OAAe,EAAE,QAAsC;QAChE,IAAI,CAAC,QAAQ,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;CACF;AAED;;;;0DAI0D;AAC1D,SAAS,cAAc,CAAC,OAAgB,EAAE,KAA0B;IAClE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAI,OAAmC,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAKS;IAET,uEAAuE;IACvE,sEAAsE;IACtE,mEAAmE;IACnE,wEAAwE;IACxE,2EAA2E;IAC3E,oEAAoE;IACpE,uDAAuD;IACvD,IAAI,aAAa,GAIN,IAAI,CAAC;IAChB,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,OAAO;QACL,iBAAiB,CAAC,EAAE,KAAK,EAAE;YACzB,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7B,CAAC;QACD,aAAa,CAAC,EAAE,KAAK,EAAE;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,aAAa,GAAG;oBACd,KAAK,EAAE,YAAY;oBACnB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,SAAS,EACP,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;iBAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QACD,iBAAiB,CAAC,EAAE,QAAQ,EAAE;YAC5B,MAAM,aAAa,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAC1D,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC;YAC7B,aAAa,GAAG,IAAI,CAAC;YACrB,gBAAgB,CACd,MAAM,CAAC,KAAK,EACZ,aAAa,CAAC,EAAE,EAChB,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,SAAS,CACjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA6B,EAC7B,KAAwB;IAExB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,OAAO;QACL,gBAAgB;YACd,MAAM,GAAG,KAAK,CAAC;YACf,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,kEAAkE;QAClE,iEAAiE;QACjE,mDAAmD;QACnD,OAAO,CAAC,EAAE,KAAK,EAAE;YACf,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,WAAW;YACT,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,cAAc,CAAC,EAAE,QAAQ,EAAE;YACzB,yDAAyD;YACzD,4DAA4D;YAC5D,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACxD,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;6BAG6B;AAC7B,SAAS,YAAY,CACnB,KAAgB;IAEhB,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,WAAY,KAA2C,CAAC,SAAS,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,GAAG,EAAE,CACnB,QAAS,KAA4C,CAAC,UAAU,EAAE,CAAC;IACrE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC,kBAAkB;YAC/B,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC5C,KAAK,SAAS,CAAC,gBAAgB;YAC7B,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC7C,KAAK,SAAS,CAAC,eAAe;YAC5B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,KAAK,SAAS,CAAC,aAAa;YAC1B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1C,KAAK,SAAS,CAAC,eAAe;YAC5B,OAAO,EAAE,GAAG,EAAE,aAAa,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3D,KAAK,SAAS,CAAC,aAAa;YAC1B,OAAO,EAAE,GAAG,EAAE,aAAa,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC5D,KAAK,SAAS,CAAC,uBAAuB;YACpC,OAAO,EAAE,GAAG,EAAE,qBAAqB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnE,KAAK,SAAS,CAAC,qBAAqB;YAClC,OAAO,EAAE,GAAG,EAAE,qBAAqB,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpE;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAOD,uEAAuE;AACvE,wDAAwD;AACxD,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IAC5B,WAAW,GAAkB,IAAI,CAAC;IAClC,sEAAsE;IACtE,sEAAsE;IACtE,sEAAsE;IACtE,6DAA6D;IAC7D,mEAAmE;IACnE,8DAA8D;IAC9D,kCAAkC;IAClC,aAAa,GAAG,KAAK,CAAC;IACd,MAAM,GAAG,EAAE,CAAC;IACZ,SAAS,GAAkB,IAAI,CAAC;IAChC,YAAY,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAEpC,IAAI,CAAC,OAAwB;QAC3B,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxE,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;gBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,qEAAqE;IAC7D,cAAc,CAAC,IAAgC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,IAAI,cAAc,CAAa;YACpC,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;gBACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,EAAE,CAAC;oBACT,UAAU,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAClB,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,oEAAoE;YACpE,2DAA2D;YAC3D,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,uEAAuE;IACvE,cAAc;IACN,qBAAqB;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,KAAiB;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,IAAY;QAC5B,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED,SAAS,cAAc,CAAC,QAAkB;IACxC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/D,OAAO,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACrD,CAAC"}

package/dist/transport/token-session.d.ts

@@ -0,0 +1,38 @@
+import type { MintVisitorTokenResponse } from "../contract/identity.js";
+import { ServingApiError } from "./serving-error.js";
+export interface TokenSessionConfig {
+    publishableKey: string;
+    baseUrl: string;
+    getEndUserToken?: () => string | null | Promise<string | null>;
+    claimThreadId?: () => string | null;
+    onMinted?: (response: MintVisitorTokenResponse) => void;
+    onMintFailed?: (error: ServingApiError) => void;
+}
+/**
+ * The visitor-token lifecycle in one place: mint on first need, re-mint
+ * proactively before expiry, retry any 401 exactly once after a forced
+ * re-mint, and retry the sign-in-required 403 exactly once when the
+ * forced re-mint comes back identified (the visitor signed in after the
+ * cached token was minted; without this the widget would keep serving
+ * the stale anonymous token until the proactive re-mint). Every other
+ * transport call goes through `authorizedFetch`, so streams and REST
+ * calls share the same lifecycle.
+ */
+export declare class TokenSession {
+    readonly baseUrl: string;
+    private readonly config;
+    private visitorToken;
+    private mintInFlight;
+    private remintTimer;
+    constructor(config: TokenSessionConfig);
+    readonly authorizedFetch: (url: string, requestInit?: RequestInit) => Promise<Response>;
+    dispose(): void;
+    private _currentToken;
+    private _remintAfterRejection;
+    private _mintSingleFlight;
+    private _mint;
+    private _buildMintRequest;
+    private _scheduleProactiveRemint;
+    private _clearRemintTimer;
+}
+//# sourceMappingURL=token-session.d.ts.map

package/dist/transport/token-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-session.d.ts","sourceRoot":"","sources":["../../src/transport/token-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAqB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMxE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAIhB,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAG/D,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAGxD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACjD;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,WAAW,CAA8C;gBAErD,MAAM,EAAE,kBAAkB;IAMtC,QAAQ,CAAC,eAAe,GACtB,KAAK,MAAM,EACX,cAAa,WAAgB,KAC5B,OAAO,CAAC,QAAQ,CAAC,CAwClB;IAEF,OAAO,IAAI,IAAI;YAID,aAAa;YAcb,qBAAqB;IAOnC,OAAO,CAAC,iBAAiB;YASX,KAAK;YAqBL,iBAAiB;IAkB/B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,iBAAiB;CAM1B"}