@trigger.dev/core 0.0.0-buffer-fix-20231206151546 → 0.0.0-bun-prerelease-20260909132648

package/dist/esm/v3/serverOnly/shutdownManager.js

@@ -0,0 +1,88 @@
+import { isTest } from "std-env";
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+import { singleton } from "./singleton.js";
+export class ShutdownManager {
+    disableForTesting;
+    isShuttingDown = false;
+    signalNumbers = {
+        SIGINT: 2,
+        SIGTERM: 15,
+    };
+    logger = new SimpleStructuredLogger("shutdownManager");
+    handlers = new Map();
+    constructor(disableForTesting = true) {
+        this.disableForTesting = disableForTesting;
+        if (disableForTesting)
+            return;
+        process.on("SIGTERM", () => this.shutdown("SIGTERM"));
+        process.on("SIGINT", () => this.shutdown("SIGINT"));
+    }
+    register(name, handler, signals = ["SIGTERM", "SIGINT"]) {
+        if (!this.isEnabled())
+            return;
+        if (this.handlers.has(name)) {
+            throw new Error(`Shutdown handler "${name}" already registered`);
+        }
+        this.handlers.set(name, { handler, signals });
+    }
+    unregister(name) {
+        if (!this.isEnabled())
+            return;
+        if (!this.handlers.has(name)) {
+            throw new Error(`Shutdown handler "${name}" not registered`);
+        }
+        this.handlers.delete(name);
+    }
+    async shutdown(signal) {
+        if (!this.isEnabled())
+            return;
+        if (this.isShuttingDown)
+            return;
+        this.isShuttingDown = true;
+        this.logger.info(`Received ${signal}. Starting graceful shutdown...`);
+        // Get handlers that are registered for this signal
+        const handlersToRun = Array.from(this.handlers.entries()).filter(([_, { signals }]) => signals.includes(signal));
+        try {
+            const results = await Promise.allSettled(handlersToRun.map(async ([name, { handler }]) => {
+                try {
+                    this.logger.info(`Running shutdown handler: ${name}`);
+                    await handler(signal);
+                    this.logger.info(`Shutdown handler completed: ${name}`);
+                }
+                catch (error) {
+                    this.logger.error(`Shutdown handler failed: ${name}`, { error });
+                    throw error;
+                }
+            }));
+            // Log any failures
+            results.forEach((result, index) => {
+                if (result.status === "rejected") {
+                    const handlerEntry = handlersToRun[index];
+                    if (handlerEntry) {
+                        const [name] = handlerEntry;
+                        this.logger.error(`Shutdown handler "${name}" failed:`, { reason: result.reason });
+                    }
+                }
+            });
+        }
+        catch (error) {
+            this.logger.error("Error during shutdown:", { error });
+        }
+        finally {
+            // Exit with the correct signal number
+            process.exit(128 + this.signalNumbers[signal]);
+        }
+    }
+    isEnabled() {
+        if (!this.disableForTesting) {
+            return true;
+        }
+        return !isTest;
+    }
+    // Only for testing
+    _getHandlersForTesting() {
+        return new Map(this.handlers);
+    }
+}
+export const shutdownManager = singleton("shutdownManager", () => new ShutdownManager());
+//# sourceMappingURL=shutdownManager.js.map

package/dist/esm/v3/serverOnly/shutdownManager.js.map

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

package/dist/esm/v3/serverOnly/singleton.d.ts

@@ -0,0 +1 @@
+export declare function singleton<T>(name: string, getValue: () => T): T;

package/dist/esm/v3/serverOnly/singleton.js

@@ -0,0 +1,7 @@
+export function singleton(name, getValue) {
+    const thusly = globalThis;
+    thusly.__trigger_singletons ??= {};
+    thusly.__trigger_singletons[name] ??= getValue();
+    return thusly.__trigger_singletons[name];
+}
+//# sourceMappingURL=singleton.js.map

package/dist/esm/v3/serverOnly/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/singleton.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAI,IAAY,EAAE,QAAiB;IAC1D,MAAM,MAAM,GAAG,UAEd,CAAC;IACF,MAAM,CAAC,oBAAoB,KAAK,EAAE,CAAC;IACnC,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;IACjD,OAAO,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/esm/v3/session-streams-api.d.ts

@@ -0,0 +1,7 @@
+import { SessionStreamsAPI } from "./sessionStreams/index.js";
+export declare const sessionStreams: SessionStreamsAPI;
+export * from "./sessionStreams/types.js";
+export * from "./sessionStreams/channels.js";
+export * from "./sessionStreams/wireProtocol.js";
+export * from "./sessionStreams/chatSnapshot.js";
+export * from "./sessionStreams/router.js";

package/dist/esm/v3/session-streams-api.js

@@ -0,0 +1,10 @@
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+import { SessionStreamsAPI } from "./sessionStreams/index.js";
+export const sessionStreams = SessionStreamsAPI.getInstance();
+export * from "./sessionStreams/types.js";
+export * from "./sessionStreams/channels.js";
+export * from "./sessionStreams/wireProtocol.js";
+export * from "./sessionStreams/chatSnapshot.js";
+export * from "./sessionStreams/router.js";
+//# sourceMappingURL=session-streams-api.js.map

package/dist/esm/v3/session-streams-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-streams-api.js","sourceRoot":"","sources":["../../../src/v3/session-streams-api.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC;AAE9D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC"}

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

@@ -0,0 +1,25 @@
+export type SessionChannelShape = {
+    in?: unknown;
+    out?: unknown;
+};
+/**
+ * A typed declaration of a named Session channel. The channel analogue of
+ * `Task<TId, TIn, TOut>`: `TName` captures the channel's literal name and
+ * `TShape` its per-direction record types. `__shape` is a phantom carrier
+ * for `TShape` and is never read at runtime.
+ */
+export type SessionChannel<TName extends string = string, TShape extends SessionChannelShape = SessionChannelShape> = {
+    readonly name: TName;
+    readonly __shape?: TShape;
+};
+export type AnySessionChannel = SessionChannel<string, SessionChannelShape>;
+/** Extract a channel's literal name, the analogue of `TaskIdentifier`. */
+export type SessionChannelName<C extends AnySessionChannel> = C extends SessionChannel<infer N, any> ? N : never;
+/** Extract the `.out` record type, the analogue of `TaskOutput`. */
+export type SessionChannelOut<C extends AnySessionChannel> = C extends SessionChannel<any, infer S> ? (S extends {
+    out: infer O;
+} ? O : unknown) : never;
+/** Extract the `.in` record type, the analogue of `TaskPayload`. */
+export type SessionChannelIn<C extends AnySessionChannel> = C extends SessionChannel<any, infer S> ? (S extends {
+    in: infer I;
+} ? I : unknown) : never;

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/channels.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,121 @@
+/**
+ * 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.
+ */
+import { z } from "zod/v4";
+import type { UIMessage } from "ai";
+export type ChatSnapshotV1<TUIMessage = unknown> = {
+    version: 1;
+    savedAt: number;
+    messages: TUIMessage[];
+    lastOutEventId?: string;
+    /**
+     * Committed `.in` consume cursor (S2 seq_num, stringified) as of this
+     * snapshot's turn-complete. Lets the next boot seed the `.in` resume
+     * cursor without scanning `session.out` for the latest turn-complete
+     * header. Absent on snapshots written before this field existed —
+     * readers fall back to the scan.
+     */
+    lastInEventId?: string;
+};
+/**
+ * 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.
+ */
+export declare const ChatSnapshotV1Schema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    savedAt: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodArray<z.ZodUnknown>;
+    lastOutEventId: z.ZodOptional<z.ZodString>;
+    lastInEventId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * One transcript entry in a version 2 snapshot. `id` duplicates
+ * `message.id` so a reader can address entries without inspecting the
+ * message body; `final` is false for a partial assistant message captured
+ * by an errored or stopped turn.
+ */
+export type TranscriptSnapshotEntry<TUIMessage extends UIMessage = UIMessage> = {
+    id: string;
+    final: boolean;
+    message: TUIMessage;
+};
+/**
+ * Version 2 of the persisted transcript blob. Entries are ordered by array
+ * position. `state` is an opaque record the runtime uses for compaction and
+ * other cross-run bookkeeping; `null` when nothing has been recorded.
+ *
+ * Readers must accept version 1 as well; writers only emit version 2. Use
+ * {@link parseTranscriptSnapshot} to read either.
+ */
+export type TranscriptSnapshotV2<TUIMessage extends UIMessage = UIMessage> = {
+    version: 2;
+    savedAt: number;
+    messages: TranscriptSnapshotEntry<TUIMessage>[];
+    state: unknown | null;
+    lastOutEventId?: string;
+    lastInEventId?: string;
+};
+export declare const TranscriptSnapshotV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    savedAt: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        final: z.ZodBoolean;
+        message: z.ZodUnknown;
+    }, z.core.$strip>>;
+    state: z.ZodNullable<z.ZodUnknown>;
+    lastOutEventId: z.ZodOptional<z.ZodString>;
+    lastInEventId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * 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".
+ */
+export declare function parseTranscriptSnapshot<TUIMessage extends UIMessage = UIMessage>(input: unknown): TranscriptSnapshotV2<TUIMessage> | undefined;
+/**
+ * Select one page of transcript entries, newest last. `before` keeps only the
+ * entries ordered before 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.
+ */
+export declare function pageTranscriptEntries<TUIMessage extends UIMessage = UIMessage>(all: TranscriptSnapshotEntry<TUIMessage>[], opts: {
+    limit?: number;
+    before?: string;
+} | undefined): {
+    entries: TranscriptSnapshotEntry<TUIMessage>[];
+    nextCursor: string | undefined;
+};
+/**
+ * S3 key suffix for a session's snapshot blob. The webapp's presigned
+ * URL routes prefix this with `packets/{projectRef}/{envSlug}/`.
+ */
+export declare function chatSnapshotKeySuffix(sessionId: string): string;

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

@@ -0,0 +1,130 @@
+/**
+ * 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.
+ */
+import { z } from "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.
+ */
+export const ChatSnapshotV1Schema = z.object({
+    version: z.literal(1),
+    savedAt: z.number().optional(),
+    messages: z.array(z.unknown()),
+    lastOutEventId: z.string().optional(),
+    lastInEventId: z.string().optional(),
+});
+export const TranscriptSnapshotV2Schema = z.object({
+    version: z.literal(2),
+    savedAt: z.number().optional(),
+    messages: z.array(z.object({
+        id: z.string(),
+        final: z.boolean(),
+        message: z.unknown(),
+    })),
+    state: z.unknown().nullable(),
+    lastOutEventId: z.string().optional(),
+    lastInEventId: 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".
+ */
+export function parseTranscriptSnapshot(input) {
+    const v2 = 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 = 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; `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.
+ */
+export function pageTranscriptEntries(all, opts) {
+    let entries = all;
+    if (opts?.before !== undefined) {
+        const idx = entries.findIndex((e) => e.id === opts.before);
+        if (idx !== -1)
+            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}/`.
+ */
+export function chatSnapshotKeySuffix(sessionId) {
+    return `sessions/${sessionId}/snapshot.json`;
+}
+//# sourceMappingURL=chatSnapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatSnapshot.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/chatSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAmB3B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AA+BH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;KACrB,CAAC,CACH;IACD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,MAAM,EAAE,GAAG,0BAA0B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAA0C,EAAE,CAAC;QAC3D,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACpC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,SAAS;YAC1E,IAAK,KAAK,CAAC,OAA4B,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE;gBAAE,SAAS;YAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAqB,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;YAC7B,QAAQ;YACR,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI;YAC5B,cAAc,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc;YACtC,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAA0C,EAAE,CAAC;QAC3D,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,GAAI,GAA+B,EAAE,EAAE,CAAC;YAChD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAiB,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;YAC7B,QAAQ;YACR,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc;YACtC,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAA0C,EAC1C,IAAqD;IAErD,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,UAA8B,CAAC;IACnC,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC/E,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,YAAY,SAAS,gBAAgB,CAAC;AAC/C,CAAC"}

package/dist/esm/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/esm/v3/sessionStreams/index.js

@@ -0,0 +1,98 @@
+import { getGlobal, registerGlobal } from "../utils/globals.js";
+import { NoopSessionStreamManager } from "./noopManager.js";
+const API_NAME = "session-streams";
+const NOOP_MANAGER = new NoopSessionStreamManager();
+export class SessionStreamsAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new SessionStreamsAPI();
+        }
+        return this._instance;
+    }
+    setGlobalManager(manager) {
+        return registerGlobal(API_NAME, manager);
+    }
+    #getManager() {
+        return 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();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/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/esm/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 {};