@trigger.dev/sdk 4.5.16 → 4.6.0

package/dist/esm/v3/test/transcript-storage-tests.js

@@ -0,0 +1,255 @@
+import { emptyTranscriptState, reduceTranscriptChanges, } from "../transcriptStorage.js";
+function message(id, text, role = "user") {
+    return { id, role, parts: [{ type: "text", text }] };
+}
+/**
+ * The contract every `TranscriptStorage` has to meet, as a test suite. Point
+ * it at a factory for your storage and run it under vitest or jest:
+ *
+ * ```ts
+ * import { runTranscriptStorageTests } from "@trigger.dev/sdk/ai/test";
+ * runTranscriptStorageTests(() => myTranscriptStorage(testDatabaseUrl));
+ * ```
+ *
+ * The factory runs once per test. Return a fresh, empty storage, or one
+ * whose chats are isolated by the `chatId` option.
+ */
+export function runTranscriptStorageTests(makeStorage, options = {}) {
+    const globals = globalThis;
+    const api = options.api ?? {
+        describe: globals.describe,
+        it: globals.it,
+        expect: globals.expect,
+    };
+    if (!api.describe || !api.it || !api.expect) {
+        throw new Error("runTranscriptStorageTests: no test API found. Enable `globals: true` in your test " +
+            "config or pass `{ api: { describe, it, expect } }`.");
+    }
+    const { describe, it, expect } = api;
+    const baseChatId = options.chatId ?? "transcript-conformance";
+    const clientData = options.clientData;
+    const ctx = (chatId, turn = 0) => ({
+        chatId,
+        clientData,
+        turn,
+        trigger: "submit-message",
+        runId: "run_conformance",
+        ctx: {},
+    });
+    const scope = (chatId) => ({ chatId, clientData });
+    const ids = (messages) => messages.map((m) => m.id);
+    const expected = new WeakMap();
+    const save = async (storage, context, changeset) => {
+        let perChat = expected.get(storage);
+        if (!perChat) {
+            perChat = new Map();
+            expected.set(storage, perChat);
+        }
+        const transcript = reduceTranscriptChanges(perChat.get(context.chatId) ?? emptyTranscriptState(), changeset.changes);
+        perChat.set(context.chatId, transcript);
+        await storage.save(context, { ...changeset, transcript });
+    };
+    describe("TranscriptStorage conformance", () => {
+        it("loads an unknown chat as an empty transcript", async () => {
+            const storage = await makeStorage();
+            const loaded = await storage.load(scope(`${baseChatId}-empty`));
+            expect(loaded.messages).toEqual([]);
+            expect(loaded.state).toBeNull();
+            expect(loaded.nextCursor).toBeUndefined();
+        });
+        it("appends puts in changeset order and replaces a known id in place", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-put`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: [
+                    { op: "put", message: message("u1", "one") },
+                    { op: "put", message: message("a1", "two", "assistant") },
+                    { op: "put", message: message("u2", "three") },
+                ],
+            });
+            await save(storage, ctx(chatId, 1), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("a1", "two, edited", "assistant") }],
+            });
+            const loaded = await storage.load(scope(chatId));
+            expect(ids(loaded.messages)).toEqual(["u1", "a1", "u2"]);
+            expect(loaded.messages[1]).toEqual(message("a1", "two, edited", "assistant"));
+        });
+        it("removes by id and ignores an unknown id", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-remove`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: [
+                    { op: "put", message: message("u1", "one") },
+                    { op: "put", message: message("a1", "two", "assistant") },
+                    { op: "put", message: message("u2", "three") },
+                ],
+            });
+            await save(storage, ctx(chatId, 1), {
+                reason: "action",
+                changes: [
+                    { op: "remove", id: "a1" },
+                    { op: "remove", id: "never-existed" },
+                ],
+            });
+            expect(ids((await storage.load(scope(chatId))).messages)).toEqual(["u1", "u2"]);
+        });
+        it("truncates after an id and ignores an unknown id", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-truncate`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: ["u1", "a1", "u2", "a2"].map((id) => ({
+                    op: "put",
+                    message: message(id, id),
+                })),
+            });
+            await save(storage, ctx(chatId, 1), {
+                reason: "action",
+                changes: [{ op: "truncateAfter", afterId: "never-existed" }],
+            });
+            expect((await storage.load(scope(chatId))).messages).toHaveLength(4);
+            await save(storage, ctx(chatId, 1), {
+                reason: "action",
+                changes: [{ op: "truncateAfter", afterId: "a1" }],
+            });
+            expect(ids((await storage.load(scope(chatId))).messages)).toEqual(["u1", "a1"]);
+        });
+        it("appends after a truncate at the end of the transcript", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-truncate-append`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: ["u1", "a1", "u2", "a2"].map((id) => ({
+                    op: "put",
+                    message: message(id, id),
+                })),
+            });
+            await save(storage, ctx(chatId, 1), {
+                reason: "action",
+                changes: [
+                    { op: "truncateAfter", afterId: "u2" },
+                    { op: "put", message: message("a2b", "regenerated", "assistant") },
+                ],
+            });
+            expect(ids((await storage.load(scope(chatId))).messages)).toEqual(["u1", "a1", "u2", "a2b"]);
+        });
+        it("round-trips state and clears it with null", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-state`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: [
+                    { op: "put", message: message("u1", "one") },
+                    { op: "state", value: { v: 1, summary: "so far" } },
+                ],
+            });
+            expect((await storage.load(scope(chatId))).state).toEqual({ v: 1, summary: "so far" });
+            await save(storage, ctx(chatId, 1), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("u2", "two") }],
+            });
+            expect((await storage.load(scope(chatId))).state).toEqual({ v: 1, summary: "so far" });
+            await save(storage, ctx(chatId, 2), {
+                reason: "action",
+                changes: [{ op: "state", value: null }],
+            });
+            expect((await storage.load(scope(chatId))).state).toBeNull();
+        });
+        it("keeps the latest cursors it was given", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-cursors`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("u1", "one") }],
+                cursors: { lastOutEventId: "10", lastInEventId: "2" },
+            });
+            await save(storage, ctx(chatId, 1), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("u2", "two") }],
+                cursors: { lastOutEventId: "20", lastInEventId: "4" },
+            });
+            const loaded = await storage.load(scope(chatId));
+            expect(loaded.cursors?.lastOutEventId).toBe("20");
+            expect(loaded.cursors?.lastInEventId).toBe("4");
+        });
+        it("keeps a partial answer's non-final status when the storage reports it", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-final`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-error",
+                changes: [
+                    { op: "put", message: message("u1", "one") },
+                    { op: "put", message: message("a1", "partial", "assistant"), final: false },
+                ],
+            });
+            const partial = await storage.load(scope(chatId));
+            if (partial.nonFinalIds !== undefined) {
+                expect(partial.nonFinalIds).toEqual(["a1"]);
+            }
+            await save(storage, ctx(chatId, 1), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("a1", "the finished answer", "assistant") }],
+            });
+            const finalized = await storage.load(scope(chatId));
+            expect(ids(finalized.messages)).toEqual(["u1", "a1"]);
+            if (finalized.nonFinalIds !== undefined) {
+                expect(finalized.nonFinalIds).toEqual([]);
+            }
+        });
+        it("converges when the same changeset is saved twice", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-replay`;
+            const changeset = {
+                reason: "turn-complete",
+                changes: [
+                    { op: "put", message: message("u1", "one") },
+                    { op: "put", message: message("a1", "two", "assistant") },
+                    { op: "state", value: { v: 1 } },
+                ],
+                cursors: { lastOutEventId: "7" },
+            };
+            await save(storage, ctx(chatId), changeset);
+            await save(storage, ctx(chatId), changeset);
+            const loaded = await storage.load(scope(chatId));
+            expect(ids(loaded.messages)).toEqual(["u1", "a1"]);
+            expect(loaded.state).toEqual({ v: 1 });
+        });
+        it("pages from the most recent message backwards with limit and before", async () => {
+            const storage = await makeStorage();
+            const chatId = `${baseChatId}-paging`;
+            await save(storage, ctx(chatId), {
+                reason: "turn-complete",
+                changes: ["m1", "m2", "m3", "m4", "m5"].map((id) => ({
+                    op: "put",
+                    message: message(id, id),
+                })),
+            });
+            const last = await storage.load(scope(chatId), { limit: 2 });
+            expect(ids(last.messages)).toEqual(["m4", "m5"]);
+            expect(last.nextCursor).toBe("m4");
+            const middle = await storage.load(scope(chatId), { limit: 2, before: last.nextCursor });
+            expect(ids(middle.messages)).toEqual(["m2", "m3"]);
+            expect(middle.nextCursor).toBe("m2");
+            const first = await storage.load(scope(chatId), { limit: 2, before: middle.nextCursor });
+            expect(ids(first.messages)).toEqual(["m1"]);
+            expect(first.nextCursor).toBeUndefined();
+        });
+        it("keeps chats apart", async () => {
+            const storage = await makeStorage();
+            await save(storage, ctx(`${baseChatId}-a`), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("u1", "in a") }],
+            });
+            await save(storage, ctx(`${baseChatId}-b`), {
+                reason: "turn-complete",
+                changes: [{ op: "put", message: message("u1", "in b") }],
+            });
+            expect((await storage.load(scope(`${baseChatId}-a`))).messages[0]).toEqual(message("u1", "in a"));
+            expect((await storage.load(scope(`${baseChatId}-b`))).messages[0]).toEqual(message("u1", "in b"));
+        });
+    });
+}
+//# sourceMappingURL=transcript-storage-tests.js.map

package/dist/esm/v3/test/transcript-storage-tests.js.map

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

package/dist/esm/v3/transcriptStorage.d.ts

@@ -0,0 +1,261 @@
+import { type TaskRunContext, type TranscriptSnapshotEntry } from "@trigger.dev/core/v3";
+import type { ModelMessage, UIMessage } from "ai";
+/**
+ * One change to a transcript. Ops address messages by id; position is the
+ * storage's own concern.
+ *
+ * - `put` upserts by `message.id`: an unknown id appends, a known id is
+ *   replaced in place. `final` is false when the runtime captured a partial
+ *   assistant message from an errored or stopped turn; it defaults to true.
+ * - `remove` deletes by id and is a no-op for an unknown id.
+ * - `truncateAfter` drops every message ordered after `afterId` (a rollback)
+ *   and is a no-op when `afterId` is unknown.
+ * - `state` replaces the opaque runtime record; `null` clears it.
+ */
+export type TranscriptChange = {
+    op: "put";
+    message: UIMessage;
+    final?: boolean;
+} | {
+    op: "remove";
+    id: string;
+} | {
+    op: "truncateAfter";
+    afterId: string;
+} | {
+    op: "state";
+    value: unknown | null;
+};
+export type TranscriptChangeReason = "turn-start" | "turn-complete" | "turn-error" | "action" | "compaction" | "recovery";
+export type TranscriptCursors = {
+    lastOutEventId?: string;
+    lastInEventId?: string;
+};
+/**
+ * What the runtime hands to `save`: the ordered changes since the last save
+ * (one transaction where the backend supports it), the whole transcript as
+ * it stands after those changes, and the stream cursors the next boot should
+ * resume from. A row-per-message store applies `changes`; a store that keeps
+ * the conversation as one document writes `transcript` as-is and needs no
+ * state of its own. Cursors are runtime-computed and persisted opaquely; a
+ * storage never interprets them.
+ */
+export type TranscriptChangeset = {
+    reason: TranscriptChangeReason;
+    changes: TranscriptChange[];
+    transcript: TranscriptState;
+    cursors?: TranscriptCursors;
+};
+/** The tenant scope of a read. A render read has no run, so this is all `load` gets. */
+export type TranscriptScope<TClientData = unknown> = {
+    chatId: string;
+    clientData: TClientData;
+};
+/** The run context of a write. Supplied by the runtime; always in-run. */
+export type TranscriptStorageContext<TClientData = unknown> = TranscriptScope<TClientData> & {
+    turn: number;
+    trigger: "submit-message" | "regenerate-message" | "action";
+    runId: string;
+    ctx: TaskRunContext;
+};
+export type TranscriptLoadOptions = {
+    /** Return at most this many messages, the most recent ones. */
+    limit?: number;
+    /** Return messages ordered before this message id (a `nextCursor` from a previous page). */
+    before?: string;
+};
+export type TranscriptLoadResult<TUIMessage extends UIMessage = UIMessage> = {
+    messages: TUIMessage[];
+    state: unknown | null;
+    cursors?: TranscriptCursors;
+    /** The id to pass as `before` for the previous page; absent on the last page. */
+    nextCursor?: string;
+    /**
+     * Ids among `messages` that were saved with `final: false` (a partial
+     * answer). A storage that keeps `final` returns them so a partial stays
+     * partial when a continuation saves it again unchanged; a storage that
+     * does not keep `final` may leave this out.
+     */
+    nonFinalIds?: string[];
+};
+/** What `loadContext` receives on every turn and action. */
+export type LoadContextEvent<TClientData = unknown, TUIMessage extends UIMessage = UIMessage> = {
+    chatId: string;
+    /** The turn number (0-indexed). */
+    turn: number;
+    trigger: "submit-message" | "regenerate-message" | "action";
+    /** The messages the frontend sent for this turn. Empty for actions. */
+    incomingMessages: TUIMessage[];
+    /** The runtime's transcript before this turn, including any tail it recovered. */
+    previousMessages: TUIMessage[];
+    clientData?: TClientData;
+    continuation: boolean;
+    previousRunId?: string;
+};
+/**
+ * A persistence adapter for a `chat.agent` transcript. The runtime calls
+ * `load` once at a continuation boot and `save` after every change to the
+ * conversation. Both are best-effort from the runtime's point of view: an
+ * error is logged and the turn continues.
+ *
+ * `loadContext` is optional. Its presence declares that the application
+ * owns the model's context: the runtime calls it on every turn and action
+ * and uses what it returns as the conversation, instead of the transcript
+ * it accumulated. Tail recovery still runs and `save` is still called.
+ */
+export type TranscriptStorage<TClientData = unknown> = {
+    load<TUIMessage extends UIMessage = UIMessage>(scope: TranscriptScope<TClientData>, opts?: TranscriptLoadOptions): Promise<TranscriptLoadResult<TUIMessage>>;
+    save(ctx: TranscriptStorageContext<TClientData>, changeset: TranscriptChangeset): Promise<void>;
+    loadContext?<TUIMessage extends UIMessage = UIMessage>(scope: TranscriptScope<TClientData>, event: LoadContextEvent<TClientData, TUIMessage>): Promise<TUIMessage[]> | TUIMessage[];
+};
+/** An in-memory transcript: ordered entries plus the opaque state record. */
+export type TranscriptState<TUIMessage extends UIMessage = UIMessage> = {
+    entries: TranscriptSnapshotEntry<TUIMessage>[];
+    state: unknown | null;
+};
+export declare function emptyTranscriptState<TUIMessage extends UIMessage = UIMessage>(): TranscriptState<TUIMessage>;
+/**
+ * Apply changes to a transcript, in order. Pure: returns a new state and
+ * never mutates the input. Replaying the same changes converges, which is
+ * what lets a storage retry a failed write without checking what landed.
+ */
+export declare function reduceTranscriptChanges<TUIMessage extends UIMessage = UIMessage>(prev: TranscriptState<TUIMessage>, changes: readonly TranscriptChange[]): TranscriptState<TUIMessage>;
+/**
+ * What the runtime remembers about the transcript it last handed to
+ * `save`: the ids in order and a fingerprint per message, so the next
+ * changeset can be derived from the accumulator without asking the storage.
+ */
+export type TranscriptShadow = {
+    ids: string[];
+    fingerprints: Map<string, string>;
+    /** Ids last saved with `final: false`. Everything else was saved final. */
+    nonFinal: Set<string>;
+};
+/**
+ * Build the shadow for `messages`. An id is non-final when this save says so
+ * (`nonFinalIds`) or when it was non-final before and its content has not
+ * changed: a partial answer stays partial until the message itself changes.
+ */
+export declare function createTranscriptShadow(messages: readonly UIMessage[], nonFinalIds?: ReadonlySet<string>, previous?: TranscriptShadow): TranscriptShadow;
+/**
+ * Derive the changes that take `shadow` to `next`.
+ *
+ * The common prefix (by id) is compared message by message and a changed
+ * message becomes an in-place `put`. Past the prefix, everything the shadow
+ * still had is dropped with one `truncateAfter` on the last common id (or
+ * one `remove` per message when there is no common prefix) and everything
+ * `next` has is appended with `put`, in order. Applying the result with
+ * {@link reduceTranscriptChanges} reproduces `next` exactly, including
+ * order, for any two lists.
+ */
+export declare function diffTranscript(shadow: TranscriptShadow, next: readonly UIMessage[], options?: {
+    nonFinalIds?: ReadonlySet<string>;
+}): {
+    changes: TranscriptChange[];
+    shadow: TranscriptShadow;
+};
+/**
+ * The built-in storage: the transcript in the platform's object store, read by
+ * the Sessions dashboard and the transcript API.
+ *
+ * One object per conversation, rewritten each turn, holding the transcript plus
+ * the runtime state. Once a conversation has been compacted, it keeps roughly
+ * the last hundred messages rather than all of them, so the object stops
+ * growing with the conversation. An app that needs the full history keeps its
+ * own transcript storage.
+ */
+export declare function snapshotTranscriptStorage(): TranscriptStorage<unknown>;
+/** The storage `chat.agent` uses when none is configured: {@link snapshotTranscriptStorage}. */
+export declare const defaultStorage: TranscriptStorage<unknown>;
+export type MemoryTranscriptStorage = TranscriptStorage<unknown> & {
+    /** The stored transcript for a chat, or `undefined` when nothing has been saved. */
+    transcript(chatId: string): (TranscriptState & {
+        cursors?: TranscriptCursors;
+    }) | undefined;
+    /** Every changeset `save` received, in order. */
+    readonly changesets: Array<{
+        ctx: TranscriptStorageContext<unknown>;
+        changeset: TranscriptChangeset;
+    }>;
+};
+/**
+ * A storage that keeps every transcript in process memory. The reference
+ * implementation for the conformance tests, and a way to inspect exactly
+ * what the runtime hands a storage.
+ */
+export declare function memoryTranscriptStorage(): MemoryTranscriptStorage;
+type ModelLaneInjection = {
+    afterId: string;
+    messages: ModelMessage[];
+};
+/**
+ * What the runtime keeps in the storage's `state` slot: the parts of the
+ * model's context that cannot be rebuilt from the transcript. Opaque to a
+ * storage; only the runtime reads it.
+ *
+ * `compaction` is the whole model lane after a compaction, covering the
+ * transcript prefix ending at `throughId`. It is used as long as `throughId`
+ * still exists in the transcript, so a rollback or truncation that removes it
+ * rebuilds the lane from the transcript instead. Editing a message before
+ * `throughId` in place is unsupported and does not invalidate the lane.
+ * `injections` are conversational messages `chat.inject` added, anchored
+ * after the transcript message they followed.
+ */
+export type TranscriptRuntimeState = {
+    v: 1;
+    compaction?: {
+        modelMessages: ModelMessage[];
+        throughId: string;
+    };
+    injections?: ModelLaneInjection[];
+    /** `chat.inject` messages queued but not yet drained into a turn when the save happened. */
+    queued?: ModelMessage[];
+};
+/**
+ * The slice of a transcript worth storing, which is the last `keep` messages
+ * once a conversation has compacted, and all of it before that.
+ *
+ * Expressed relative to the compaction watermark rather than as a plain tail,
+ * because everything after the watermark is live context that the next boot
+ * converts and must never be dropped. The runtime stamps the watermark at the
+ * newest message on each compacted save, so in practice the two coincide and
+ * this keeps the last `keep`; the watermark-relative form is what keeps it
+ * correct if a watermark ever lands earlier in the transcript.
+ *
+ * Without a watermark nothing is dropped: every entry is still context.
+ *
+ * This is what stops the object rewritten each turn from growing with the
+ * conversation. An app that needs the whole history keeps its own transcript
+ * storage.
+ */
+export declare function trimTranscriptForSnapshot<TEntry extends {
+    id: string;
+}>(entries: TEntry[], state: unknown, opts: {
+    keep: number;
+}): TEntry[];
+/**
+ * Rewrite runtime state so it still describes the transcript window being
+ * persisted.
+ *
+ * A compaction watermark that has moved out of the window becomes `""`, which
+ * is how a restored lane says "the compacted messages cover everything before
+ * this window". Left as-is, the watermark would name an entry the window does
+ * not contain, and restoring the lane would discard the compacted messages and
+ * re-convert the window from scratch — an agent that has silently forgotten the
+ * conversation. Injections anchored outside the window go too: the span they
+ * belonged to is already inside the compacted lane.
+ */
+export declare function normalizeRuntimeStateForWindow(state: unknown, windowIds: Iterable<string>): unknown;
+export declare function parseTranscriptRuntimeState(value: unknown): TranscriptRuntimeState | undefined;
+/**
+ * Rebuild the model lane for a transcript at boot. Uses the persisted
+ * compacted lane while the transcript still contains its `throughId`
+ * boundary, then converts the rest of the transcript, re-inserting persisted
+ * injections after the messages they followed.
+ */
+export declare function restoreModelLane<TUIMessage extends UIMessage>(messages: TUIMessage[], state: TranscriptRuntimeState | undefined, convert: (messages: TUIMessage[]) => Promise<ModelMessage[]>): Promise<{
+    messages: ModelMessage[];
+    compacted: boolean;
+    injections: ModelLaneInjection[];
+}>;
+export {};