@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/commonjs/v3/sessionStreams/chatSnapshot.js

@@ -0,0 +1,368 @@
+"use strict";
+/**
+ * Persisted chat-snapshot blob. Written by `chat.agent` to S3 after every
+ * turn completes (when no `hydrateMessages` hook is registered) and read
+ * back at the start of the next run to seed the accumulator. Also read by
+ * the Sessions dashboard to render the full conversation transcript
+ * without re-streaming `session.out` from `seq_num=0`.
+ *
+ * S3 key suffix: `sessions/{sessionId}/snapshot.json`. The webapp's
+ * presigned-URL service prefixes this with `packets/{projectRef}/{envSlug}/`.
+ *
+ * `lastOutEventId` is the S2 seq_num (as a string) of the snapshot's
+ * final `turn-complete` control record. Used to resume `session.out`
+ * replay from precisely after the snapshot, and as the trim-chain seed
+ * for the agent's next turn.
+ *
+ * The `version` field is a forward-compat lever: readers that don't
+ * recognise a version silently fall back to no-snapshot behaviour.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSCRIPT_BLOB_CONTENT_TYPE = exports.TRANSCRIPT_TRAILER_BYTES = exports.TranscriptSnapshotV2Schema = exports.ChatSnapshotV1Schema = void 0;
+exports.parseTranscriptSnapshot = parseTranscriptSnapshot;
+exports.pageTranscriptEntries = pageTranscriptEntries;
+exports.chatSnapshotKeySuffix = chatSnapshotKeySuffix;
+exports.serializeTranscriptSnapshot = serializeTranscriptSnapshot;
+exports.readTranscriptTrailer = readTranscriptTrailer;
+exports.parseTranscriptFooter = parseTranscriptFooter;
+exports.planTranscriptPage = planTranscriptPage;
+exports.parseTranscriptEntryLines = parseTranscriptEntryLines;
+exports.parseTranscriptBlob = parseTranscriptBlob;
+const v4_1 = require("zod/v4");
+/**
+ * Zod schema for `ChatSnapshotV1` with the message shape kept opaque
+ * (`unknown[]`). The agent runtime types messages strictly via the
+ * generic parameter; readers that need stricter validation can layer
+ * their own UIMessage parser on top.
+ */
+exports.ChatSnapshotV1Schema = v4_1.z.object({
+    version: v4_1.z.literal(1),
+    savedAt: v4_1.z.number().optional(),
+    messages: v4_1.z.array(v4_1.z.unknown()),
+    lastOutEventId: v4_1.z.string().optional(),
+    lastInEventId: v4_1.z.string().optional(),
+});
+exports.TranscriptSnapshotV2Schema = v4_1.z.object({
+    version: v4_1.z.literal(2),
+    savedAt: v4_1.z.number().optional(),
+    messages: v4_1.z.array(v4_1.z.object({
+        id: v4_1.z.string(),
+        final: v4_1.z.boolean(),
+        message: v4_1.z.unknown(),
+    })),
+    state: v4_1.z.unknown().nullable(),
+    lastOutEventId: v4_1.z.string().optional(),
+    lastInEventId: v4_1.z.string().optional(),
+});
+/**
+ * Parse a fetched snapshot blob of any known version into the version 2
+ * shape. A version 1 blob is upgraded in memory: every message becomes a
+ * `final: true` entry keyed by its `id` and `state` is `null`. In both
+ * versions, entries without a non-empty string `id` or a non-null object
+ * `message` are dropped; a version 2 entry whose `message.id` disagrees with
+ * the envelope `id` is dropped too, since a reader keys by one and renders by
+ * the other. A caller never sees an entry it would crash on or mis-order.
+ * A missing `savedAt` defaults to `0` rather than rejecting the whole blob:
+ * the field only orders snapshot history before live chunks, and dropping a
+ * whole conversation over an absent timestamp is the wrong failure mode.
+ * Returns `undefined` for an unknown version or a body that is not a
+ * snapshot; callers treat that as "no snapshot".
+ */
+function parseTranscriptSnapshot(input) {
+    const v2 = exports.TranscriptSnapshotV2Schema.safeParse(input);
+    if (v2.success) {
+        const messages = [];
+        for (const entry of v2.data.messages) {
+            if (entry.id.length === 0)
+                continue;
+            if (typeof entry.message !== "object" || entry.message === null)
+                continue;
+            if (entry.message.id !== entry.id)
+                continue;
+            messages.push({ id: entry.id, final: entry.final, message: entry.message });
+        }
+        return {
+            version: 2,
+            savedAt: v2.data.savedAt ?? 0,
+            messages,
+            state: v2.data.state ?? null,
+            lastOutEventId: v2.data.lastOutEventId,
+            lastInEventId: v2.data.lastInEventId,
+        };
+    }
+    const v1 = exports.ChatSnapshotV1Schema.safeParse(input);
+    if (v1.success) {
+        const messages = [];
+        for (const raw of v1.data.messages) {
+            const id = raw?.id;
+            if (typeof id !== "string" || id.length === 0)
+                continue;
+            messages.push({ id, final: true, message: raw });
+        }
+        return {
+            version: 2,
+            savedAt: v1.data.savedAt ?? 0,
+            messages,
+            state: null,
+            lastOutEventId: v1.data.lastOutEventId,
+            lastInEventId: v1.data.lastInEventId,
+        };
+    }
+    return undefined;
+}
+/**
+ * Select one page of transcript entries, newest last. `before` keeps only the
+ * entries ordered before that id, and yields an empty page when the transcript
+ * no longer holds that id; `limit` keeps the last that many. A
+ * non-positive `limit` is treated as no limit (every entry, no cursor), so a
+ * caller cannot mistake an empty page for the end of the transcript. The
+ * returned `nextCursor` is the id to pass as `before` for the previous page,
+ * absent when there is no earlier page.
+ */
+function pageTranscriptEntries(all, opts) {
+    let entries = all;
+    if (opts?.before !== undefined) {
+        const idx = entries.findIndex((e) => e.id === opts.before);
+        if (idx === -1)
+            return { entries: [], nextCursor: undefined };
+        entries = entries.slice(0, idx);
+    }
+    let nextCursor;
+    if (opts?.limit !== undefined && opts.limit > 0 && entries.length > opts.limit) {
+        entries = entries.slice(entries.length - opts.limit);
+        nextCursor = entries[0]?.id;
+    }
+    return { entries, nextCursor };
+}
+/**
+ * S3 key suffix for a session's snapshot blob. The webapp's presigned
+ * URL routes prefix this with `packets/{projectRef}/{envSlug}/`.
+ */
+function chatSnapshotKeySuffix(sessionId) {
+    return `sessions/${sessionId}/snapshot.json`;
+}
+/**
+ * Byte length of the fixed trailer that ends a version 2 blob:
+ * `#tt2:` + 16 zero-padded digits + `\n`. Fixed width so a reader can fetch
+ * exactly this many bytes from the end of the object and learn where the
+ * footer starts without a second guess.
+ */
+exports.TRANSCRIPT_TRAILER_BYTES = 22;
+/**
+ * Media type a version 2 blob is stored under. Object stores return this on a
+ * ranged read, so a reader learns the format from the response it already made
+ * instead of inferring it from the bytes.
+ */
+exports.TRANSCRIPT_BLOB_CONTENT_TYPE = "application/vnd.trigger.transcript+ndjson";
+const TRAILER_PREFIX = "#tt2:";
+const V2_LINE_PREFIX = '{"v":2';
+function utf8Length(value) {
+    return new TextEncoder().encode(value).length;
+}
+/**
+ * Serialize a snapshot to the version 2 blob format: a header line carrying
+ * the cursors and the private runtime `state`, one JSON entry per line, an
+ * entry-index footer line, and the fixed trailer.
+ *
+ * The header holds `state`, so a reader that fetches only the end of the
+ * object to serve a transcript page cannot receive the model lane even by
+ * accident.
+ */
+function serializeTranscriptSnapshot(snapshot) {
+    const header = JSON.stringify({
+        v: 2,
+        savedAt: snapshot.savedAt,
+        lastOutEventId: snapshot.lastOutEventId,
+        lastInEventId: snapshot.lastInEventId,
+        state: snapshot.state ?? null,
+    });
+    const ids = [];
+    const offsets = [];
+    const lines = [];
+    let cursor = utf8Length(header) + 1;
+    for (const entry of snapshot.messages) {
+        const line = JSON.stringify({ id: entry.id, final: entry.final, message: entry.message });
+        ids.push(entry.id);
+        offsets.push(cursor);
+        lines.push(line);
+        cursor += utf8Length(line) + 1;
+    }
+    offsets.push(cursor);
+    const footer = JSON.stringify({
+        ids,
+        offsets,
+        savedAt: snapshot.savedAt,
+        lastOutEventId: snapshot.lastOutEventId,
+        lastInEventId: snapshot.lastInEventId,
+    });
+    const trailer = `${TRAILER_PREFIX}${String(utf8Length(footer)).padStart(16, "0")}\n`;
+    return `${header}\n${lines.map((line) => `${line}\n`).join("")}${footer}\n${trailer}`;
+}
+/**
+ * Read the fixed trailer from the last {@link TRANSCRIPT_TRAILER_BYTES} bytes
+ * of a version 2 blob. Returns the footer line's byte length, or `undefined`
+ * when the bytes are not a trailer (a version 1 blob, or a truncated write).
+ */
+function readTranscriptTrailer(trailer) {
+    if (!trailer.startsWith(TRAILER_PREFIX) || trailer.length !== exports.TRANSCRIPT_TRAILER_BYTES) {
+        return undefined;
+    }
+    const digits = trailer.slice(TRAILER_PREFIX.length, exports.TRANSCRIPT_TRAILER_BYTES - 1);
+    if (!/^\d{16}$/.test(digits))
+        return undefined;
+    const footerLength = Number(digits);
+    return Number.isSafeInteger(footerLength) && footerLength >= 0 ? { footerLength } : undefined;
+}
+/** Parse a version 2 footer line into its entry index. */
+function parseTranscriptFooter(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const { ids, offsets } = parsed;
+    if (!Array.isArray(ids) || !Array.isArray(offsets))
+        return undefined;
+    if (offsets.length !== ids.length + 1)
+        return undefined;
+    if (!ids.every((id) => typeof id === "string"))
+        return undefined;
+    if (!offsets.every((offset) => typeof offset === "number" && Number.isSafeInteger(offset))) {
+        return undefined;
+    }
+    // Offsets must strictly increase. Every entry is a non-empty JSON line plus a
+    // newline, so consecutive offsets always differ; equal or descending ones mean
+    // corrupt metadata. Accepting equality would hand the reader a zero-length
+    // window, which decodes to no entry at all and drops a message from the page
+    // while the cursor advances past it, instead of declining here so the caller
+    // takes the whole-object fallback.
+    const numeric = offsets;
+    if (numeric[0] < 0)
+        return undefined;
+    for (let i = 1; i < numeric.length; i++) {
+        if (numeric[i] <= numeric[i - 1])
+            return undefined;
+    }
+    const { savedAt, lastOutEventId, lastInEventId } = parsed;
+    return {
+        ids: ids,
+        offsets: offsets,
+        savedAt: typeof savedAt === "number" ? savedAt : undefined,
+        lastOutEventId: typeof lastOutEventId === "string" ? lastOutEventId : undefined,
+        lastInEventId: typeof lastInEventId === "string" ? lastInEventId : undefined,
+    };
+}
+function planTranscriptPage(footer, opts) {
+    let endIndex = footer.ids.length;
+    if (opts?.before !== undefined) {
+        const idx = footer.ids.indexOf(opts.before);
+        if (idx === -1)
+            return undefined;
+        endIndex = idx;
+    }
+    const limit = opts?.limit !== undefined && opts.limit > 0 ? opts.limit : undefined;
+    let startIndex = 0;
+    let nextCursor;
+    if (limit !== undefined && endIndex > limit) {
+        startIndex = endIndex - limit;
+        nextCursor = footer.ids[startIndex];
+    }
+    if (endIndex <= startIndex)
+        return undefined;
+    return {
+        start: footer.offsets[startIndex],
+        end: footer.offsets[endIndex],
+        ids: footer.ids.slice(startIndex, endIndex),
+        nextCursor,
+        startIndex,
+        totalEntries: footer.ids.length,
+    };
+}
+function parseEntryLine(line) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const { id, final, message } = parsed;
+    if (typeof id !== "string" || id.length === 0)
+        return undefined;
+    if (typeof message !== "object" || message === null)
+        return undefined;
+    if (message.id !== id)
+        return undefined;
+    return { id, final: final === true, message: message };
+}
+/**
+ * Parse a run of whole entry lines, e.g. the byte window
+ * {@link planTranscriptPage} selected. Malformed lines are dropped, matching
+ * {@link parseTranscriptSnapshot}: a caller never sees an entry it would crash
+ * on or mis-order.
+ */
+function parseTranscriptEntryLines(text) {
+    const entries = [];
+    for (const line of text.split("\n")) {
+        if (line.length === 0)
+            continue;
+        const entry = parseEntryLine(line);
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
+}
+/**
+ * Parse a whole fetched blob of any known format. Version 2 is the line-based
+ * format {@link serializeTranscriptSnapshot} writes; anything else is handed to
+ * {@link parseTranscriptSnapshot}, which still reads the version 1 blobs
+ * written by released SDKs.
+ */
+function parseTranscriptBlob(text) {
+    if (!text.startsWith(V2_LINE_PREFIX)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return undefined;
+        }
+        return parseTranscriptSnapshot(parsed);
+    }
+    const newline = text.indexOf("\n");
+    if (newline === -1)
+        return undefined;
+    let header;
+    try {
+        header = JSON.parse(text.slice(0, newline));
+    }
+    catch {
+        return undefined;
+    }
+    const { savedAt, lastOutEventId, lastInEventId, state } = (header ?? {});
+    const trailerStart = text.length - exports.TRANSCRIPT_TRAILER_BYTES;
+    const trailer = trailerStart >= 0 ? readTranscriptTrailer(text.slice(trailerStart)) : undefined;
+    let body = text.slice(newline + 1);
+    if (trailer) {
+        // Drop the footer line and the trailer; the entries are everything between
+        // the header and them.
+        const footerLine = text.lastIndexOf("\n", trailerStart - 2);
+        if (footerLine > newline)
+            body = text.slice(newline + 1, footerLine + 1);
+    }
+    return {
+        version: 2,
+        savedAt: typeof savedAt === "number" ? savedAt : 0,
+        messages: parseTranscriptEntryLines(body),
+        state: state ?? null,
+        lastOutEventId: typeof lastOutEventId === "string" ? lastOutEventId : undefined,
+        lastInEventId: typeof lastInEventId === "string" ? lastInEventId : undefined,
+    };
+}
+//# sourceMappingURL=chatSnapshot.js.map

package/dist/commonjs/v3/sessionStreams/chatSnapshot.js.map

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

package/dist/commonjs/v3/sessionStreams/index.d.ts

@@ -0,0 +1,32 @@
+import type { InputStreamOncePromise, SessionChannelIO, SessionStreamManager, SessionStreamRecord, SessionStreamRecordPredicate } from "./types.js";
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+export declare class SessionStreamsAPI implements SessionStreamManager {
+    #private;
+    private static _instance?;
+    private constructor();
+    static getInstance(): SessionStreamsAPI;
+    setGlobalManager(manager: SessionStreamManager): boolean;
+    on(sessionId: string, io: SessionChannelIO, handler: (data: unknown) => void | boolean | Promise<void>, channel?: string): {
+        off: () => void;
+    };
+    onRecord(sessionId: string, io: SessionChannelIO, handler: (record: SessionStreamRecord) => void | boolean | Promise<void>, channel?: string): {
+        off: () => void;
+    };
+    once(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<unknown>;
+    onceRecord(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    onceRecordWhere(sessionId: string, io: SessionChannelIO, predicate: SessionStreamRecordPredicate, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    peek(sessionId: string, io: SessionChannelIO, channel?: string): unknown | undefined;
+    peekRecord(sessionId: string, io: SessionChannelIO, channel?: string): SessionStreamRecord | undefined;
+    lastSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    consumeRecord(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    lastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    setMinTimestamp(sessionId: string, io: SessionChannelIO, minTimestamp: number | undefined, channel?: string): void;
+    shiftBuffer(sessionId: string, io: SessionChannelIO, channel?: string): boolean;
+    reconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    disconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    clearHandlers(): void;
+    reset(): void;
+    disconnect(): void;
+}

package/dist/commonjs/v3/sessionStreams/index.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStreamsAPI = void 0;
+const globals_js_1 = require("../utils/globals.js");
+const noopManager_js_1 = require("./noopManager.js");
+const API_NAME = "session-streams";
+const NOOP_MANAGER = new noopManager_js_1.NoopSessionStreamManager();
+class SessionStreamsAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new SessionStreamsAPI();
+        }
+        return this._instance;
+    }
+    setGlobalManager(manager) {
+        return (0, globals_js_1.registerGlobal)(API_NAME, manager);
+    }
+    #getManager() {
+        return (0, globals_js_1.getGlobal)(API_NAME) ?? NOOP_MANAGER;
+    }
+    on(sessionId, io, handler, channel) {
+        return this.#getManager().on(sessionId, io, handler, channel);
+    }
+    onRecord(sessionId, io, handler, channel) {
+        const manager = this.#getManager();
+        if (!manager.onRecord) {
+            throw new Error("The configured Session stream manager does not support record handlers");
+        }
+        return manager.onRecord(sessionId, io, handler, channel);
+    }
+    once(sessionId, io, options, channel) {
+        return this.#getManager().once(sessionId, io, options, channel);
+    }
+    onceRecord(sessionId, io, options, channel) {
+        const manager = this.#getManager();
+        if (!manager.onceRecord) {
+            throw new Error("The configured Session stream manager does not support record metadata");
+        }
+        return manager.onceRecord(sessionId, io, options, channel);
+    }
+    onceRecordWhere(sessionId, io, predicate, options, channel) {
+        const manager = this.#getManager();
+        if (!manager.onceRecordWhere) {
+            throw new Error("The configured Session stream manager does not support selective records");
+        }
+        return manager.onceRecordWhere(sessionId, io, predicate, options, channel);
+    }
+    peek(sessionId, io, channel) {
+        return this.#getManager().peek(sessionId, io, channel);
+    }
+    peekRecord(sessionId, io, channel) {
+        const manager = this.#getManager();
+        if (!manager.peekRecord) {
+            throw new Error("The configured Session stream manager does not support record metadata");
+        }
+        return manager.peekRecord(sessionId, io, channel);
+    }
+    lastSeqNum(sessionId, io, channel) {
+        return this.#getManager().lastSeqNum(sessionId, io, channel);
+    }
+    setLastSeqNum(sessionId, io, seqNum, channel) {
+        this.#getManager().setLastSeqNum(sessionId, io, seqNum, channel);
+    }
+    consumeRecord(sessionId, io, seqNum, channel) {
+        const manager = this.#getManager();
+        if (!manager.consumeRecord) {
+            throw new Error("The configured Session stream manager does not support exact consumption");
+        }
+        manager.consumeRecord(sessionId, io, seqNum, channel);
+    }
+    lastDispatchedSeqNum(sessionId, io, channel) {
+        return this.#getManager().lastDispatchedSeqNum(sessionId, io, channel);
+    }
+    setLastDispatchedSeqNum(sessionId, io, seqNum, channel) {
+        this.#getManager().setLastDispatchedSeqNum(sessionId, io, seqNum, channel);
+    }
+    setMinTimestamp(sessionId, io, minTimestamp, channel) {
+        this.#getManager().setMinTimestamp(sessionId, io, minTimestamp, channel);
+    }
+    shiftBuffer(sessionId, io, channel) {
+        return this.#getManager().shiftBuffer(sessionId, io, channel);
+    }
+    reconnectStream(sessionId, io, channel) {
+        this.#getManager().reconnectStream?.(sessionId, io, channel);
+    }
+    disconnectStream(sessionId, io, channel) {
+        this.#getManager().disconnectStream(sessionId, io, channel);
+    }
+    clearHandlers() {
+        this.#getManager().clearHandlers();
+    }
+    reset() {
+        this.#getManager().reset();
+    }
+    disconnect() {
+        this.#getManager().disconnect();
+    }
+}
+exports.SessionStreamsAPI = SessionStreamsAPI;
+//# sourceMappingURL=index.js.map

package/dist/commonjs/v3/sessionStreams/index.js.map

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

package/dist/commonjs/v3/sessionStreams/manager.d.ts

@@ -0,0 +1,79 @@
+import type { ApiClient } from "../apiClient/index.js";
+import { InputStreamOncePromise } from "../inputStreams/types.js";
+import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+import type { SessionChannelIO, SessionStreamManager, SessionStreamRecord, SessionStreamRecordPredicate } from "./types.js";
+type SessionStreamHandler = (data: unknown) => void | boolean | Promise<void>;
+/**
+ * A handler that sees the whole record rather than just its payload. Consumers
+ * that route by sequence number need the metadata, the same reason
+ * `onceRecord` exists alongside `once`.
+ */
+type SessionStreamRecordHandler = (record: SessionStreamRecord) => void | boolean | Promise<void>;
+/**
+ * Session-scoped parallel to {@link StandardInputStreamManager}. Keeps the
+ * same buffer / once-waiter / tail lifecycle, but keyed on
+ * `(sessionId, io)` and subscribing via
+ * {@link ApiClient.subscribeToSessionStream} instead of the run input
+ * stream SSE.
+ */
+export declare class StandardSessionStreamManager implements SessionStreamManager {
+    #private;
+    private apiClient;
+    private baseUrl;
+    private debug;
+    private handlers;
+    private onceWaiters;
+    private buffer;
+    private tails;
+    private minTimestamps;
+    private explicitlyDisconnected;
+    private seqNums;
+    private unconsumedSeqNums;
+    private lastDispatchedSeqNums;
+    private reconnectAttempts;
+    constructor(apiClient: ApiClient, baseUrl: string, debug?: boolean);
+    on(sessionId: string, io: SessionChannelIO, handler: SessionStreamHandler, channel?: string): {
+        off: () => void;
+    };
+    /**
+     * Register a handler that receives the full record, including its sequence
+     * number. Same consume semantics as {@link on}: returning `true` consumes.
+     */
+    onRecord(sessionId: string, io: SessionChannelIO, handler: SessionStreamRecordHandler, channel?: string): {
+        off: () => void;
+    };
+    once(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<unknown>;
+    onceRecord(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    onceRecordWhere(sessionId: string, io: SessionChannelIO, predicate: SessionStreamRecordPredicate, options?: InputStreamOnceOptions, channel?: string): InputStreamOncePromise<SessionStreamRecord>;
+    peek(sessionId: string, io: SessionChannelIO, channel?: string): unknown | undefined;
+    peekRecord(sessionId: string, io: SessionChannelIO, channel?: string): SessionStreamRecord | undefined;
+    lastSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    consumeRecord(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    lastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, channel?: string): number | undefined;
+    setLastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number, channel?: string): void;
+    setMinTimestamp(sessionId: string, io: SessionChannelIO, minTimestamp: number | undefined, channel?: string): void;
+    shiftBuffer(sessionId: string, io: SessionChannelIO, channel?: string): boolean;
+    disconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    /**
+     * Re-open a channel that `disconnectStream` closed, without registering a
+     * new consumer. A single long-lived reader (the session channel router) has
+     * to be able to bring its own tail back after a suspend, and re-attaching
+     * its handler just to clear the suppression flag would replay the buffer at
+     * it.
+     */
+    reconnectStream(sessionId: string, io: SessionChannelIO, channel?: string): void;
+    clearHandlers(): void;
+    /**
+     * Tear down all active tails. Does NOT clear handlers or `onceWaiters`,
+     * so any registered listener will trigger an auto-reconnect (with
+     * backoff) the moment it sees no live tail — by design, so a transient
+     * network blip recovers without the caller re-subscribing. Use
+     * `reset()` if you want a full clean state with no resurrection, or
+     * `disconnectStream(sessionId, io)` for a single channel that should
+     * stay down until a fresh `on()` / `once()` attaches.
+     */
+    disconnect(): void;
+    reset(): void;
+}
+export {};