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

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,211 @@
+/**
+ * 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, 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.
+ */
+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;
+/**
+ * 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.
+ */
+export declare const 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.
+ */
+export declare const TRANSCRIPT_BLOB_CONTENT_TYPE = "application/vnd.trigger.transcript+ndjson";
+/**
+ * Entry index at the end of a version 2 blob. Carries the stream cursors too,
+ * so serving a transcript page never has to fetch the header — which is where
+ * the private runtime state lives. `offsets` holds `ids.length + 1`
+ * byte offsets: entry `i` occupies `[offsets[i], offsets[i + 1] - 1)`, and the
+ * final sentinel is where the footer line itself begins. Carrying the sentinel
+ * means a reader can bound every entry, including the last, without knowing the
+ * object's total size.
+ */
+export type TranscriptFooter = {
+    ids: string[];
+    offsets: number[];
+    savedAt?: number;
+    lastOutEventId?: string;
+    lastInEventId?: string;
+};
+/**
+ * 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.
+ */
+export declare function serializeTranscriptSnapshot<TUIMessage extends UIMessage>(snapshot: TranscriptSnapshotV2<TUIMessage>): string;
+/**
+ * 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).
+ */
+export declare function readTranscriptTrailer(trailer: string): {
+    footerLength: number;
+} | undefined;
+/** Parse a version 2 footer line into its entry index. */
+export declare function parseTranscriptFooter(line: string): TranscriptFooter | undefined;
+/**
+ * Byte window covering one page of entries within a single object, computed
+ * from its footer alone. Mirrors {@link pageTranscriptEntries}: newest last,
+ * `before` excludes that id and everything after it, `limit` keeps the last
+ * that many.
+ *
+ * `undefined` means the page is empty: the transcript is empty, `before` names
+ * its first entry, or `before` names an entry the transcript no longer holds
+ * (history trimmed since the caller last read it). Returning the newest entries
+ * for a cursor that cannot be found would present recent messages as older ones.
+ */
+export type TranscriptPagePlan = {
+    start: number;
+    end: number;
+    ids: string[];
+    /** Set when the transcript still holds entries before the page. */
+    nextCursor: string | undefined;
+    /** Position of the page's first entry in the whole transcript. */
+    startIndex: number;
+    /** Entries in the whole transcript, so a caller can order pages against each other. */
+    totalEntries: number;
+};
+export declare function planTranscriptPage(footer: TranscriptFooter, opts: {
+    limit?: number;
+    before?: string;
+} | undefined): TranscriptPagePlan | undefined;
+/**
+ * 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.
+ */
+export declare function parseTranscriptEntryLines<TUIMessage extends UIMessage = UIMessage>(text: string): TranscriptSnapshotEntry<TUIMessage>[];
+/**
+ * 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.
+ */
+export declare function parseTranscriptBlob<TUIMessage extends UIMessage = UIMessage>(text: string): TranscriptSnapshotV2<TUIMessage> | undefined;

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

@@ -0,0 +1,356 @@
+/**
+ * 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, 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.
+ */
+export 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}/`.
+ */
+export 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.
+ */
+export const 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.
+ */
+export const 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.
+ */
+export 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).
+ */
+export function readTranscriptTrailer(trailer) {
+    if (!trailer.startsWith(TRAILER_PREFIX) || trailer.length !== TRANSCRIPT_TRAILER_BYTES) {
+        return undefined;
+    }
+    const digits = trailer.slice(TRAILER_PREFIX.length, 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. */
+export 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,
+    };
+}
+export 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.
+ */
+export 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.
+ */
+export 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 - 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/esm/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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"}