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

package/dist/commonjs/v3/serverOnly/k8s.d.ts

@@ -0,0 +1 @@
+export declare function isKubernetesEnvironment(override?: boolean): boolean;

package/dist/commonjs/v3/serverOnly/k8s.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKubernetesEnvironment = isKubernetesEnvironment;
+const std_env_1 = require("std-env");
+function isKubernetesEnvironment(override) {
+    if (override !== undefined) {
+        return override;
+    }
+    // Then check for common Kubernetes environment variables
+    const k8sIndicators = [
+        std_env_1.env.KUBERNETES_PORT,
+        std_env_1.env.KUBERNETES_SERVICE_HOST,
+        std_env_1.env.KUBERNETES_SERVICE_PORT,
+    ];
+    console.debug("k8sIndicators", { k8sIndicators });
+    return k8sIndicators.some(Boolean);
+}
+//# sourceMappingURL=k8s.js.map

package/dist/commonjs/v3/serverOnly/k8s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/k8s.ts"],"names":[],"mappings":";;;AAAA,qCAA8B;AAE9B,iCAAwC,QAAkB;IACxD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,yDAAyD;IACzD,MAAM,aAAa,GAAG;QACpB,aAAG,CAAC,eAAe;QACnB,aAAG,CAAC,uBAAuB;QAC3B,aAAG,CAAC,uBAAuB;KAC5B,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAElD,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/commonjs/v3/serverOnly/placementTags.d.ts

@@ -0,0 +1,20 @@
+import { type PlacementTag } from "../schemas/index.js";
+export interface PlacementConfig {
+    enabled: boolean;
+    prefix: string;
+}
+export declare class PlacementTagProcessor {
+    private readonly config;
+    private readonly logger;
+    constructor(config: PlacementConfig);
+    /**
+     * Converts placement tags to Kubernetes nodeSelector labels
+     */
+    convertToNodeSelector(placementTags?: PlacementTag[], existingNodeSelector?: Record<string, string>): Record<string, string>;
+    private printTagWarnings;
+}
+/**
+ * Helper function to create a placement tag. In the future this will be able to support multiple values and operators.
+ * For now it's just a single value.
+ */
+export declare function placementTag(key: string, value: string): PlacementTag;

package/dist/commonjs/v3/serverOnly/placementTags.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlacementTagProcessor = void 0;
+exports.placementTag = placementTag;
+const structuredLogger_js_1 = require("../utils/structuredLogger.js");
+class PlacementTagProcessor {
+    config;
+    logger = new structuredLogger_js_1.SimpleStructuredLogger("placement-tag-processor");
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Converts placement tags to Kubernetes nodeSelector labels
+     */
+    convertToNodeSelector(placementTags, existingNodeSelector) {
+        if (!this.config.enabled || !placementTags || placementTags.length === 0) {
+            return existingNodeSelector ?? {};
+        }
+        const nodeSelector = { ...existingNodeSelector };
+        // Convert placement tags to nodeSelector labels
+        for (const tag of placementTags) {
+            const labelKey = `${this.config.prefix}/${tag.key}`;
+            // Print warnings (if any)
+            this.printTagWarnings(tag);
+            // For now we only support single values via nodeSelector
+            nodeSelector[labelKey] = tag.values?.[0] ?? "";
+        }
+        return nodeSelector;
+    }
+    printTagWarnings(tag) {
+        if (!tag.values || tag.values.length === 0) {
+            // No values provided
+            this.logger.warn("Placement tag has no values, using empty string", tag);
+        }
+        else if (tag.values.length > 1) {
+            // Multiple values provided
+            this.logger.warn("Placement tag has multiple values, only using first one", tag);
+        }
+    }
+}
+exports.PlacementTagProcessor = PlacementTagProcessor;
+/**
+ * Helper function to create a placement tag. In the future this will be able to support multiple values and operators.
+ * For now it's just a single value.
+ */
+function placementTag(key, value) {
+    return { key, values: [value] };
+}
+//# sourceMappingURL=placementTags.js.map

package/dist/commonjs/v3/serverOnly/placementTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placementTags.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/placementTags.ts"],"names":[],"mappings":";;;;AACA,sEAAsE;AAOtE;IAG+B,MAAM;IAFlB,MAAM,GAAG,IAAI,4CAAsB,CAAC,yBAAyB,CAAC,CAAC;IAEhF,YAA6B,MAAuB;sBAAvB,MAAM;IAAoB,CAAC;IAExD;;OAEG;IACH,qBAAqB,CACnB,aAA8B,EAC9B,oBAA6C;QAE7C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,OAAO,oBAAoB,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,MAAM,YAAY,GAA2B,EAAE,GAAG,oBAAoB,EAAE,CAAC;QAEzE,gDAAgD;QAChD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YAEpD,0BAA0B;YAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAE3B,yDAAyD;YACzD,YAAY,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,gBAAgB,CAAC,GAAiB;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,qBAAqB;YACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,2BAA2B;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yDAAyD,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;CACF;;AAED;;;GAGG;AACH,sBAA6B,GAAW,EAAE,KAAa;IACrD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/commonjs/v3/serverOnly/shutdownManager.d.ts

@@ -0,0 +1,20 @@
+type ShutdownHandler = NodeJS.SignalsListener;
+type ShutdownSignal = Extract<NodeJS.Signals, "SIGTERM" | "SIGINT">;
+export declare class ShutdownManager {
+    private disableForTesting;
+    private isShuttingDown;
+    private signalNumbers;
+    private logger;
+    private handlers;
+    constructor(disableForTesting?: boolean);
+    register(name: string, handler: ShutdownHandler, signals?: ShutdownSignal[]): void;
+    unregister(name: string): void;
+    shutdown(signal: ShutdownSignal): Promise<void>;
+    private isEnabled;
+    _getHandlersForTesting(): ReadonlyMap<string, {
+        handler: ShutdownHandler;
+        signals: ShutdownSignal[];
+    }>;
+}
+export declare const shutdownManager: ShutdownManager;
+export {};

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownManager = exports.ShutdownManager = void 0;
+const std_env_1 = require("std-env");
+const structuredLogger_js_1 = require("../utils/structuredLogger.js");
+const singleton_js_1 = require("./singleton.js");
+class ShutdownManager {
+    disableForTesting;
+    isShuttingDown = false;
+    signalNumbers = {
+        SIGINT: 2,
+        SIGTERM: 15,
+    };
+    logger = new structuredLogger_js_1.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 !std_env_1.isTest;
+    }
+    // Only for testing
+    _getHandlersForTesting() {
+        return new Map(this.handlers);
+    }
+}
+exports.ShutdownManager = ShutdownManager;
+exports.shutdownManager = (0, singleton_js_1.singleton)("shutdownManager", () => new ShutdownManager());
+//# sourceMappingURL=shutdownManager.js.map

package/dist/commonjs/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/commonjs/v3/serverOnly/singleton.d.ts

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleton = singleton;
+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/commonjs/v3/serverOnly/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../../../src/v3/serverOnly/singleton.ts"],"names":[],"mappings":";;;AAAA,mBAA6B,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/commonjs/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/commonjs/v3/session-streams-api.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionStreams = void 0;
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+const index_js_1 = require("./sessionStreams/index.js");
+exports.sessionStreams = index_js_1.SessionStreamsAPI.getInstance();
+__exportStar(require("./sessionStreams/types.js"), exports);
+__exportStar(require("./sessionStreams/channels.js"), exports);
+__exportStar(require("./sessionStreams/wireProtocol.js"), exports);
+__exportStar(require("./sessionStreams/chatSnapshot.js"), exports);
+__exportStar(require("./sessionStreams/router.js"), exports);
+//# sourceMappingURL=session-streams-api.js.map

package/dist/commonjs/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,wDAA8D;AAEjD,QAAA,cAAc,GAAG,4BAAiB,CAAC,WAAW,EAAE,CAAC;AAE9D,4DAA0C;AAC1C,+DAA6C;AAC7C,mEAAiD;AACjD,mEAAiD;AACjD,6DAA2C"}

package/dist/commonjs/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/commonjs/v3/sessionStreams/channels.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=channels.js.map

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

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

package/dist/commonjs/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;