@trigger.dev/core 4.5.12 → 4.5.13

package/dist/esm/v3/sessionStreams/manager.test.js

@@ -1,5 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { StandardSessionStreamManager } from "./manager.js";
+import { InputStreamTimeoutError } from "../inputStreams/types.js";
 // Single-shot mock that mimics S2's long-poll: delivers `records` once via
 // `onPart` on the first subscribe call, then keeps the returned async
 // iterable OPEN until the abort signal fires. Real S2 keeps the SSE
@@ -35,6 +36,22 @@ function singleShotApiClient(records) {
         },
     };
 }
+function repeatingApiClient(record) {
+    return {
+        async subscribeToSessionStream(_sessionIdOrExternalId, _io, options) {
+            options?.onPart?.(record);
+            const signal = options?.signal;
+            // eslint-disable-next-line require-yield
+            return (async function* () {
+                if (signal?.aborted)
+                    return;
+                await new Promise((resolve) => {
+                    signal?.addEventListener("abort", () => resolve(), { once: true });
+                });
+            })();
+        },
+    };
+}
 describe("StandardSessionStreamManager — minTimestamp filter", () => {
     const sessionId = "session-1";
     const io = "in";
@@ -117,4 +134,240 @@ describe("StandardSessionStreamManager — minTimestamp filter", () => {
         manager.disconnect();
     });
 });
+describe("StandardSessionStreamManager — record metadata", () => {
+    const sessionId = "session-records";
+    const io = "in";
+    const records = [
+        {
+            id: "41",
+            recordId: "part-stable-1",
+            chunk: { kind: "message", payload: { id: "u1" } },
+            timestamp: 1000,
+        },
+        {
+            id: "42",
+            recordId: "part-stable-2",
+            chunk: { kind: "message", payload: { id: "u2" } },
+            timestamp: 2000,
+        },
+    ];
+    it("consumes one record at a time with stable id and sequence metadata", async () => {
+        const manager = new StandardSessionStreamManager(singleShotApiClient(records), "http://localhost");
+        const first = await manager.onceRecord(sessionId, io);
+        expect(first).toEqual({
+            ok: true,
+            output: {
+                id: "part-stable-1",
+                seqNum: 41,
+                data: { kind: "message", payload: { id: "u1" } },
+            },
+        });
+        expect(manager.peekRecord(sessionId, io)).toEqual({
+            id: "part-stable-2",
+            seqNum: 42,
+            data: { kind: "message", payload: { id: "u2" } },
+        });
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(41);
+        const second = await manager.onceRecord(sessionId, io);
+        expect(second.ok && second.output.id).toBe("part-stable-2");
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(42);
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    it("returns the same envelope when a record is redelivered", async () => {
+        const manager = new StandardSessionStreamManager(repeatingApiClient(records[0]), "http://localhost");
+        const first = await manager.onceRecord(sessionId, io);
+        manager.disconnectStream(sessionId, io);
+        const replayed = await manager.onceRecord(sessionId, io);
+        expect(first).toEqual(replayed);
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    it("returns immediately when the timeout is zero", async () => {
+        const manager = new StandardSessionStreamManager({
+            subscribeToSessionStream: () => {
+                throw new Error("zero-timeout reads must not subscribe");
+            },
+        }, "http://localhost");
+        const result = await manager.onceRecord(sessionId, io, { timeoutMs: 0 });
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.error).toBeInstanceOf(InputStreamTimeoutError);
+        }
+        manager.disconnect();
+    });
+    it("does not consume a matching record past an earlier unmatched record", async () => {
+        const manager = new StandardSessionStreamManager(singleShotApiClient([
+            {
+                id: "50",
+                recordId: "handover-1",
+                chunk: { kind: "handover" },
+                timestamp: 1000,
+            },
+            {
+                id: "51",
+                recordId: "message-1",
+                chunk: { kind: "message", payload: { id: "u1" } },
+                timestamp: 2000,
+            },
+        ]), "http://localhost");
+        const pendingMessage = manager.onceRecordWhere(sessionId, io, (record) => record.data.kind === "message", { timeoutMs: 200 });
+        expect(manager.peekRecord(sessionId, io)).toEqual({
+            id: "handover-1",
+            seqNum: 50,
+            data: { kind: "handover" },
+        });
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBeUndefined();
+        const handover = await manager.onceRecord(sessionId, io);
+        expect(handover).toEqual({
+            ok: true,
+            output: { id: "handover-1", seqNum: 50, data: { kind: "handover" } },
+        });
+        await expect(pendingMessage).resolves.toEqual({
+            ok: true,
+            output: {
+                id: "message-1",
+                seqNum: 51,
+                data: { kind: "message", payload: { id: "u1" } },
+            },
+        });
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(51);
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    it("keeps the persisted cursor behind each earlier buffered record", async () => {
+        const manager = new StandardSessionStreamManager(singleShotApiClient([
+            {
+                id: "50",
+                recordId: "message-1",
+                chunk: { kind: "message", payload: { id: "u1" } },
+                timestamp: 1000,
+            },
+            {
+                id: "51",
+                recordId: "stop-1",
+                chunk: { kind: "stop" },
+                timestamp: 2000,
+            },
+            {
+                id: "52",
+                recordId: "message-2",
+                chunk: { kind: "message", payload: { id: "u2" } },
+                timestamp: 3000,
+            },
+            {
+                id: "53",
+                recordId: "stop-2",
+                chunk: { kind: "stop" },
+                timestamp: 4000,
+            },
+        ]), "http://localhost");
+        let resolveStop;
+        let remainingStops = 2;
+        const stopConsumed = new Promise((resolve) => {
+            resolveStop = resolve;
+        });
+        manager.on(sessionId, io, (data) => {
+            if (data.kind !== "stop")
+                return;
+            remainingStops--;
+            if (remainingStops === 0)
+                resolveStop();
+            return true;
+        });
+        await stopConsumed;
+        expect(manager.peekRecord(sessionId, io)).toEqual({
+            id: "message-1",
+            seqNum: 50,
+            data: { kind: "message", payload: { id: "u1" } },
+        });
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(49);
+        const firstMessage = await manager.onceRecord(sessionId, io);
+        expect(firstMessage.ok && firstMessage.output.id).toBe("message-1");
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(51);
+        const secondMessage = await manager.onceRecord(sessionId, io);
+        expect(secondMessage.ok && secondMessage.output.id).toBe("message-2");
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(53);
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    it("preserves buffered records across disconnect and consumes only the exact sequence", async () => {
+        const manager = new StandardSessionStreamManager(singleShotApiClient([
+            {
+                id: "50",
+                recordId: "message-1",
+                chunk: { kind: "message", payload: { id: "u1" } },
+                timestamp: 1000,
+            },
+            {
+                id: "51",
+                recordId: "stop-1",
+                chunk: { kind: "stop" },
+                timestamp: 2000,
+            },
+            {
+                id: "52",
+                recordId: "message-2",
+                chunk: { kind: "message", payload: { id: "u2" } },
+                timestamp: 3000,
+            },
+        ]), "http://localhost");
+        let resolveStop;
+        const stopConsumed = new Promise((resolve) => {
+            resolveStop = resolve;
+        });
+        manager.on(sessionId, io, (data) => {
+            if (data.kind !== "stop")
+                return;
+            resolveStop();
+            return true;
+        });
+        await stopConsumed;
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(49);
+        manager.disconnectStream(sessionId, io);
+        expect(manager.peekRecord(sessionId, io)?.seqNum).toBe(50);
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(49);
+        manager.consumeRecord(sessionId, io, 50);
+        expect(manager.peekRecord(sessionId, io)?.seqNum).toBe(52);
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(51);
+        manager.consumeRecord(sessionId, io, 52);
+        expect(manager.peekRecord(sessionId, io)).toBeUndefined();
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(52);
+        manager.reset();
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBeUndefined();
+    });
+    it("does not expose a negative cursor when sequence zero is buffered", async () => {
+        const manager = new StandardSessionStreamManager(singleShotApiClient([
+            {
+                id: "0",
+                recordId: "message-0",
+                chunk: { kind: "message", payload: { id: "u0" } },
+                timestamp: 1000,
+            },
+            {
+                id: "1",
+                recordId: "stop-1",
+                chunk: { kind: "stop" },
+                timestamp: 2000,
+            },
+        ]), "http://localhost");
+        let resolveStop;
+        const stopConsumed = new Promise((resolve) => {
+            resolveStop = resolve;
+        });
+        manager.on(sessionId, io, (data) => {
+            if (data.kind !== "stop")
+                return;
+            resolveStop();
+            return true;
+        });
+        await stopConsumed;
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBeUndefined();
+        const message = await manager.onceRecord(sessionId, io);
+        expect(message.ok && message.output.id).toBe("message-0");
+        expect(manager.lastDispatchedSeqNum(sessionId, io)).toBe(1);
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+});
 //# sourceMappingURL=manager.test.js.map

package/dist/esm/v3/sessionStreams/manager.test.js.map

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

package/dist/esm/v3/sessionStreams/noopManager.d.ts

@@ -1,19 +1,27 @@
 import type { InputStreamOnceOptions } from "../realtimeStreams/types.js";
 import { InputStreamOncePromise } from "../inputStreams/types.js";
-import type { SessionChannelIO, SessionStreamManager } from "./types.js";
+import type { SessionChannelIO, SessionStreamManager, SessionStreamRecord, SessionStreamRecordPredicate } from "./types.js";
 export declare class NoopSessionStreamManager implements SessionStreamManager {
     on(_sessionId: string, _io: SessionChannelIO, _handler: (data: unknown) => void | boolean | Promise<void>): {
         off: () => void;
     };
+    onRecord(_sessionId: string, _io: SessionChannelIO, _handler: (record: SessionStreamRecord) => void | boolean | Promise<void>): {
+        off: () => void;
+    };
     once(_sessionId: string, _io: SessionChannelIO, _options?: InputStreamOnceOptions): InputStreamOncePromise<unknown>;
+    onceRecord(_sessionId: string, _io: SessionChannelIO, _options?: InputStreamOnceOptions): InputStreamOncePromise<SessionStreamRecord>;
+    onceRecordWhere(_sessionId: string, _io: SessionChannelIO, _predicate: SessionStreamRecordPredicate, _options?: InputStreamOnceOptions): InputStreamOncePromise<SessionStreamRecord>;
     peek(_sessionId: string, _io: SessionChannelIO): unknown | undefined;
+    peekRecord(_sessionId: string, _io: SessionChannelIO): SessionStreamRecord | undefined;
     lastSeqNum(_sessionId: string, _io: SessionChannelIO): number | undefined;
     setLastSeqNum(_sessionId: string, _io: SessionChannelIO, _seqNum: number): void;
+    consumeRecord(_sessionId: string, _io: SessionChannelIO, _seqNum: number): void;
     lastDispatchedSeqNum(_sessionId: string, _io: SessionChannelIO): number | undefined;
     setLastDispatchedSeqNum(_sessionId: string, _io: SessionChannelIO, _seqNum: number): void;
     setMinTimestamp(_sessionId: string, _io: SessionChannelIO, _minTimestamp: number | undefined): void;
     shiftBuffer(_sessionId: string, _io: SessionChannelIO): boolean;
     disconnectStream(_sessionId: string, _io: SessionChannelIO): void;
+    reconnectStream(_sessionId: string, _io: SessionChannelIO): void;
     clearHandlers(): void;
     reset(): void;
     disconnect(): void;

package/dist/esm/v3/sessionStreams/noopManager.js

@@ -3,18 +3,35 @@ export class NoopSessionStreamManager {
     on(_sessionId, _io, _handler) {
         return { off: () => { } };
     }
+    onRecord(_sessionId, _io, _handler) {
+        return { off: () => { } };
+    }
     once(_sessionId, _io, _options) {
         return new InputStreamOncePromise(() => {
             // Never resolves in noop mode.
         });
     }
+    onceRecord(_sessionId, _io, _options) {
+        return new InputStreamOncePromise(() => {
+            // Never resolves in noop mode.
+        });
+    }
+    onceRecordWhere(_sessionId, _io, _predicate, _options) {
+        return new InputStreamOncePromise(() => {
+            // Never resolves in noop mode.
+        });
+    }
     peek(_sessionId, _io) {
         return undefined;
     }
+    peekRecord(_sessionId, _io) {
+        return undefined;
+    }
     lastSeqNum(_sessionId, _io) {
         return undefined;
     }
     setLastSeqNum(_sessionId, _io, _seqNum) { }
+    consumeRecord(_sessionId, _io, _seqNum) { }
     lastDispatchedSeqNum(_sessionId, _io) {
         return undefined;
     }
@@ -24,6 +41,7 @@ export class NoopSessionStreamManager {
         return false;
     }
     disconnectStream(_sessionId, _io) { }
+    reconnectStream(_sessionId, _io) { }
     clearHandlers() { }
     reset() { }
     disconnect() { }

package/dist/esm/v3/sessionStreams/noopManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/noopManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,OAAO,wBAAwB;IACnC,EAAE,CACA,UAAkB,EAClB,GAAqB,EACrB,QAA2D;QAE3D,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CACF,UAAkB,EAClB,GAAqB,EACrB,QAAiC;QAEjC,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,UAAkB,EAAE,GAAqB;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,GAAqB;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAElF,oBAAoB,CAAC,UAAkB,EAAE,GAAqB;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uBAAuB,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAE5F,eAAe,CACb,UAAkB,EAClB,GAAqB,EACrB,aAAiC,IAC1B,CAAC;IAEV,WAAW,CAAC,UAAkB,EAAE,GAAqB;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CAAC,UAAkB,EAAE,GAAqB,IAAS,CAAC;IAEpE,aAAa,KAAU,CAAC;IAExB,KAAK,KAAU,CAAC;IAEhB,UAAU,KAAU,CAAC;CACtB"}
+{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/noopManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAQlE,MAAM,OAAO,wBAAwB;IACnC,EAAE,CACA,UAAkB,EAClB,GAAqB,EACrB,QAA2D;QAE3D,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,QAAQ,CACN,UAAkB,EAClB,GAAqB,EACrB,QAAyE;QAEzE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CACF,UAAkB,EAClB,GAAqB,EACrB,QAAiC;QAEjC,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CACR,UAAkB,EAClB,GAAqB,EACrB,QAAiC;QAEjC,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CACb,UAAkB,EAClB,GAAqB,EACrB,UAAwC,EACxC,QAAiC;QAEjC,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE;YACrC,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,UAAkB,EAAE,GAAqB;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,GAAqB;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,GAAqB;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAElF,aAAa,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAElF,oBAAoB,CAAC,UAAkB,EAAE,GAAqB;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uBAAuB,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAE5F,eAAe,CACb,UAAkB,EAClB,GAAqB,EACrB,aAAiC,IAC1B,CAAC;IAEV,WAAW,CAAC,UAAkB,EAAE,GAAqB;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CAAC,UAAkB,EAAE,GAAqB,IAAS,CAAC;IAEpE,eAAe,CAAC,UAAkB,EAAE,GAAqB,IAAS,CAAC;IAEnE,aAAa,KAAU,CAAC;IAExB,KAAK,KAAU,CAAC;IAEhB,UAAU,KAAU,CAAC;CACtB"}

package/dist/esm/v3/sessionStreams/router.d.ts

@@ -0,0 +1,241 @@
+import type { SessionStreamRecord } from "./types.js";
+/**
+ * What happens to a record when no consumer is ready for it *right now*.
+ *
+ * - `queue`: it waits in the route's own queue until a consumer takes it.
+ * - `at-arrival`: it goes to a live handler or nowhere. A record that only
+ *   means something to the turn that is live when it lands (a stop) is this.
+ */
+export type RouteDelivery = "queue" | "at-arrival";
+/**
+ * One route: which kinds it owns, whether it waits for a consumer, and whether
+ * a record it never handled has to survive into the next boot.
+ *
+ * The two properties are independent, and that is the point. Three of the four
+ * combinations are meaningful and cover everything `session.in` carries:
+ *
+ * | delivery | replayable | example |
+ * | --- | --- | --- |
+ * | `queue` | `true` | a user message: waits for a turn, and a crash must not lose it |
+ * | `at-arrival` | `false` | a stop: only the live turn cares, and a replayed one would abort the wrong turn |
+ * | `queue` | `false` | a handover signal: can arrive before its consumer is ready, but is meaningless to a later boot |
+ *
+ * The fourth is a contradiction (discard it when nobody is listening, yet
+ * recover it later) and the table rejects it.
+ */
+export type SessionRoute = {
+    /** Unique within a table. */
+    name: string;
+    delivery: RouteDelivery;
+    /**
+     * Whether a record this route never handled must be recovered by the next
+     * boot. Only `true` holds the resume floor back.
+     */
+    replayable: boolean;
+    /** Record kinds this route owns. Every kind belongs to at most one route. */
+    kinds: readonly string[];
+};
+/**
+ * The complete statement of what a channel carries and who owns each kind.
+ * Intended to be a literal at the point of use, so "which kinds exist and what
+ * happens to each" is answerable by reading one object.
+ */
+export type SessionRouteTable = {
+    /** Extract a record's kind. Returning `undefined` marks it malformed. */
+    kindOf: (data: unknown) => string | undefined;
+    routes: readonly SessionRoute[];
+};
+export type RouterDropReason = 
+/** No route claims this kind: nothing on this boot can consume it. */
+"unroutable"
+/** No usable kind on the record at all. */
+ | "malformed"
+/**
+ * A non-replayable record inside the replay window. It was already observed
+ * by a previous run, and its route has declared that a later boot has no use
+ * for it.
+ */
+ | "replayed"
+/** An `at-arrival` record with no handler attached right now. */
+ | "no-handler";
+export type RouterDecision = 
+/** Handed to a consumer that was already waiting, or to a live handler. */
+{
+    action: "deliver";
+    route: string;
+}
+/** Parked in the route's queue for a future consumer. */
+ | {
+    action: "queue";
+    route: string;
+} | {
+    action: "drop";
+    route?: string;
+    reason: RouterDropReason;
+};
+/**
+ * The two numbers a turn boundary publishes, and that a boot reads back.
+ *
+ * `resumeFrom` is the floor: every record at or below it was terminally
+ * handled, so a boot subscribes from just past it. `appliedThrough` is the end
+ * of the replay window: the highest sequence a previous run observed. Records
+ * at or below it are being re-read rather than arriving live.
+ */
+export type RouterCheckpoint = {
+    resumeFrom?: number;
+    appliedThrough?: number;
+};
+type RouteHandler = (record: SessionStreamRecord) => void;
+/**
+ * Reads one session channel and gives every record exactly one destination.
+ *
+ * The channel carries records for several independent consumers whose delivery
+ * needs differ: a message must be delivered eventually and so can lag
+ * arbitrarily far behind the newest record, while a stop only means anything to
+ * the turn that is live when it lands. Tracking that with a single scalar
+ * cursor is not possible — the true state is always "control applied through
+ * X, message Y still owed" — so the router tracks it per route and derives the
+ * published numbers from route state:
+ *
+ * - the resume floor is held back only by records a later boot would still have
+ *   to recover, which is exactly the queued records on replayable routes;
+ * - a record whose route has declared it not replayable is never re-applied
+ *   after a resume, because the route said a later boot has no use for it;
+ * - a record with no route is terminal by classification, so it never enters a
+ *   queue and cannot park at the head of one.
+ *
+ * Those three properties are what previously needed a cursor-barrier
+ * predicate, a drop predicate with a second published header, and a
+ * discard-the-unclaimed drain respectively.
+ */
+export declare class SessionChannelRouter {
+    #private;
+    private table;
+    constructor(table: SessionRouteTable, options?: {
+        /** Called for every dropped record. Reporting only; never load-bearing. */
+        onDrop?: (record: SessionStreamRecord, reason: RouterDropReason, route?: string) => void;
+    });
+    /**
+     * Seed the router from a previous run's turn boundary.
+     *
+     * An absent `appliedThrough` falls back to the floor, which leaves anything
+     * above the floor treated as live. A caller resuming a boundary that predates
+     * the published replay window should resolve the window from the channel
+     * instead, so it covers everything already there at boot: a missed stop is
+     * recoverable, while a stop applied to the wrong turn kills a live answer.
+     */
+    restore(checkpoint: RouterCheckpoint): void;
+    /** Where a boot should subscribe from: just past this sequence. */
+    resumeFrom(): number | undefined;
+    /**
+     * Classify one record and act on it. The record's destination is decided
+     * here, once, and never by whichever consumer happens to be waiting.
+     *
+     * Queued routes serve a waiting consumer before a push handler, so a handler
+     * can never take a record out from under a consumer that is actively awaiting
+     * one. A record handed straight to either never enters the queue, so it never
+     * holds the floor back.
+     */
+    ingest(record: SessionStreamRecord): RouterDecision;
+    /**
+     * The highest sequence that can be resumed past without losing anything.
+     *
+     * Held back below the earliest record still queued anywhere, because those
+     * are exactly the records a replay has to recover. Everything else the
+     * router has seen was terminally decided, so the floor is free to sit at the
+     * high water when every queue is empty.
+     */
+    resumeFloor(): number | undefined;
+    /**
+     * The high water: highest sequence observed, never held back. Published as
+     * the end of the replay window so the next boot can tell a re-read
+     * `at-arrival` record from one arriving live.
+     */
+    appliedThrough(): number | undefined;
+    /** Both published numbers for a turn boundary. */
+    checkpoint(): RouterCheckpoint;
+    /**
+     * Attach a push handler. A `queued` route with a handler attached delivers
+     * straight to it instead of queueing; an `at-arrival` route discards records
+     * whenever no handler is attached.
+     *
+     * Attaching re-offers anything already queued, so a consumer that attaches
+     * after records have piled up still sees them in order.
+     */
+    on(name: string, handler: RouteHandler): {
+        off: () => void;
+    };
+    /**
+     * Watch a route without consuming from it.
+     *
+     * Notification and consumption are separate concerns: an observer is told
+     * that a record arrived and the record still queues, so the resume floor
+     * stays held behind it until something actually takes it. A push handler
+     * registered with {@link on} is the opposite, and a record handed to one
+     * counts as terminally decided.
+     *
+     * Only meaningful on a replayable route. On an `at-arrival` route an observer
+     * would either have to count as a listener, which would stop an unconsumed
+     * record being discarded, or watch records it cannot affect, so it is
+     * rejected rather than given one of those two meanings.
+     *
+     * Records already queued are not re-offered: an observer reports arrivals
+     * from the moment it attaches, so re-offering would fire twice for a record
+     * that arrived before a later consumer attached.
+     */
+    observe(name: string, observer: RouteHandler): {
+        off: () => void;
+    };
+    /**
+     * Remove one queued record, identified by sequence.
+     *
+     * For a consumer that decided to take a record it had only observed. Returns
+     * whether it was still queued, so a caller can tell a real take from a record
+     * something else had already consumed.
+     */
+    take(name: string, seqNum: number): SessionStreamRecord | undefined;
+    /**
+     * Put a taken record back, in sequence order.
+     *
+     * For a consumer that claimed a record and then could not use it. Returning
+     * it leaves the route as though the claim never happened, so the record is
+     * delivered later and goes back to holding the resume floor. Without this a
+     * failed claim-then-use is indistinguishable from a delivery, and the record
+     * is lost.
+     */
+    untake(name: string, record: SessionStreamRecord): void;
+    /** Whether an `at-arrival` route currently has anywhere to deliver. */
+    hasHandler(name: string): boolean;
+    /**
+     * Take the next record on a route.
+     *
+     * `timeoutMs: 0` is a non-blocking take. Omitted means wait indefinitely.
+     * Resolves `undefined` on timeout. An `at-arrival` route delivers to a
+     * waiting caller when one is already parked here, which is what makes a pull
+     * consumer possible on such a route without weakening the discard rule.
+     */
+    next(name: string, options?: {
+        timeoutMs?: number;
+    }): Promise<SessionStreamRecord | undefined>;
+    /** Head of a route's queue without consuming it. */
+    peek(name: string): SessionStreamRecord | undefined;
+    /**
+     * Whether a route has anything queued. Exact, because it reads that route's
+     * own queue rather than the head of a buffer shared with every other kind on
+     * the channel.
+     */
+    hasPending(name: string): boolean;
+    /** Number of records queued on a route. Diagnostic use. */
+    pendingCount(name: string): number;
+    /**
+     * Discard whatever one route has queued and wake its waiters empty.
+     *
+     * Closes a consumer window: a route that is not replayable has nothing owed
+     * to a later boot, so once its window is over anything still queued on it is
+     * dead and must not sit at the head of the queue for the rest of the run.
+     */
+    clearRoute(name: string): void;
+    /** Drop every waiter and queue. Called between task executions. */
+    reset(): void;
+}
+export {};