@trigger.dev/core 4.4.6 → 4.5.0-rc.0

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

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const manager_js_1 = require("./manager.js");
+// Single-shot mock that mimics S2's long-poll: delivers `records` once via
+// `onPart` on the first subscribe call, then keeps the returned async
+// iterable OPEN until the abort signal fires. Real S2 keeps the SSE
+// connection alive on a long-poll; the manager's `runTail` finally /
+// reconnect path only fires when the connection actually closes. Returning
+// an empty stream synchronously triggers a tight reconnect loop, so the
+// mock parks indefinitely instead.
+function singleShotApiClient(records) {
+    let delivered = false;
+    return {
+        async subscribeToSessionStream(_sessionIdOrExternalId, _io, options) {
+            if (!delivered) {
+                delivered = true;
+                for (const record of records) {
+                    options?.onPart?.(record);
+                }
+            }
+            const signal = options?.signal;
+            return (async function* () {
+                if (signal?.aborted)
+                    return;
+                await new Promise((resolve) => {
+                    if (!signal) {
+                        // No signal — block the stream forever; tests must
+                        // explicitly call `disconnectStream` / `disconnect` to
+                        // unblock.
+                        return;
+                    }
+                    signal.addEventListener("abort", () => resolve(), { once: true });
+                });
+            })();
+        },
+    };
+}
+(0, vitest_1.describe)("StandardSessionStreamManager — minTimestamp filter", () => {
+    const sessionId = "session-1";
+    const io = "in";
+    (0, vitest_1.it)("dispatches records when no filter is set", async () => {
+        const records = [
+            { id: "0", chunk: { kind: "message", payload: { id: "u1" } }, timestamp: 1000 },
+            { id: "1", chunk: { kind: "message", payload: { id: "u2" } }, timestamp: 2000 },
+        ];
+        const manager = new manager_js_1.StandardSessionStreamManager(singleShotApiClient(records), "http://localhost");
+        const first = await manager.once(sessionId, io);
+        (0, vitest_1.expect)(first).toEqual({ ok: true, output: { kind: "message", payload: { id: "u1" } } });
+        const second = await manager.once(sessionId, io);
+        (0, vitest_1.expect)(second).toEqual({ ok: true, output: { kind: "message", payload: { id: "u2" } } });
+        manager.disconnectStream(sessionId, io); // stop reconnect loop
+        manager.disconnect();
+    });
+    (0, vitest_1.it)("drops records whose timestamp is <= minTimestamp", async () => {
+        const records = [
+            { id: "0", chunk: { kind: "message", payload: { id: "u1" } }, timestamp: 1000 },
+            { id: "1", chunk: { kind: "message", payload: { id: "u2" } }, timestamp: 2000 },
+            { id: "2", chunk: { kind: "message", payload: { id: "u3" } }, timestamp: 3000 },
+        ];
+        const manager = new manager_js_1.StandardSessionStreamManager(singleShotApiClient(records), "http://localhost");
+        // Cutoff at 2000 (inclusive: `<=` is dropped). Only u3 should pass.
+        manager.setMinTimestamp(sessionId, io, 2000);
+        const passed = await manager.once(sessionId, io, { timeoutMs: 200 });
+        (0, vitest_1.expect)(passed).toEqual({ ok: true, output: { kind: "message", payload: { id: "u3" } } });
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    (0, vitest_1.it)("clears the filter when set to undefined", async () => {
+        const records = [
+            { id: "0", chunk: { kind: "message", payload: { id: "u1" } }, timestamp: 1000 },
+        ];
+        const manager = new manager_js_1.StandardSessionStreamManager(singleShotApiClient(records), "http://localhost");
+        manager.setMinTimestamp(sessionId, io, 5000);
+        manager.setMinTimestamp(sessionId, io, undefined);
+        const passed = await manager.once(sessionId, io, { timeoutMs: 200 });
+        (0, vitest_1.expect)(passed).toEqual({ ok: true, output: { kind: "message", payload: { id: "u1" } } });
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+    (0, vitest_1.it)("filter is per-(sessionId, io) and doesn't bleed across streams", async () => {
+        const inApi = singleShotApiClient([
+            { id: "0", chunk: { kind: "in-record" }, timestamp: 1000 },
+        ]);
+        const manager = new manager_js_1.StandardSessionStreamManager(inApi, "http://localhost");
+        manager.setMinTimestamp(sessionId, "in", 5000);
+        // The "out" stream uses the same singleShotApiClient instance — its
+        // single-shot delivers the same fixture, but the filter doesn't apply
+        // to "out" so the record passes.
+        const outResult = await manager.once(sessionId, "out", { timeoutMs: 200 });
+        (0, vitest_1.expect)(outResult).toEqual({ ok: true, output: { kind: "in-record" } });
+        // The "in" stream is filtered (minTimestamp=5000, record ts=1000): the
+        // once() call should idle-timeout instead of resolving with the record.
+        // But the singleShot instance has already delivered to the "out" tail,
+        // so the "in" tail will get nothing on first connect anyway. Use a
+        // separate manager+api to keep the assertion crisp.
+        const inApi2 = singleShotApiClient([
+            { id: "0", chunk: { kind: "in-record-2" }, timestamp: 1000 },
+        ]);
+        const manager2 = new manager_js_1.StandardSessionStreamManager(inApi2, "http://localhost");
+        manager2.setMinTimestamp(sessionId, "in", 5000);
+        const inResult = await manager2.once(sessionId, "in", { timeoutMs: 100 });
+        (0, vitest_1.expect)(inResult.ok).toBe(false); // filter-dropped → idle timeout
+        manager.disconnectStream(sessionId, "in");
+        manager.disconnectStream(sessionId, "out");
+        manager.disconnect();
+        manager2.disconnectStream(sessionId, "in");
+        manager2.disconnect();
+    });
+    (0, vitest_1.it)("reset() clears all per-stream timestamp filters", async () => {
+        const records = [
+            { id: "0", chunk: { kind: "message", payload: { id: "u1" } }, timestamp: 1000 },
+        ];
+        const manager = new manager_js_1.StandardSessionStreamManager(singleShotApiClient(records), "http://localhost");
+        manager.setMinTimestamp(sessionId, io, 5000);
+        manager.reset();
+        const passed = await manager.once(sessionId, io, { timeoutMs: 200 });
+        (0, vitest_1.expect)(passed).toEqual({ ok: true, output: { kind: "message", payload: { id: "u1" } } });
+        manager.disconnectStream(sessionId, io);
+        manager.disconnect();
+    });
+});
+//# sourceMappingURL=manager.test.js.map

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

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

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

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

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

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopSessionStreamManager = void 0;
+const types_js_1 = require("../inputStreams/types.js");
+class NoopSessionStreamManager {
+    on(_sessionId, _io, _handler) {
+        return { off: () => { } };
+    }
+    once(_sessionId, _io, _options) {
+        return new types_js_1.InputStreamOncePromise(() => {
+            // Never resolves in noop mode.
+        });
+    }
+    peek(_sessionId, _io) {
+        return undefined;
+    }
+    lastSeqNum(_sessionId, _io) {
+        return undefined;
+    }
+    setLastSeqNum(_sessionId, _io, _seqNum) { }
+    lastDispatchedSeqNum(_sessionId, _io) {
+        return undefined;
+    }
+    setLastDispatchedSeqNum(_sessionId, _io, _seqNum) { }
+    setMinTimestamp(_sessionId, _io, _minTimestamp) { }
+    shiftBuffer(_sessionId, _io) {
+        return false;
+    }
+    disconnectStream(_sessionId, _io) { }
+    clearHandlers() { }
+    reset() { }
+    disconnect() { }
+}
+exports.NoopSessionStreamManager = NoopSessionStreamManager;
+//# sourceMappingURL=noopManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noopManager.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/noopManager.ts"],"names":[],"mappings":";;;AACA,uDAAkE;AAGlE,MAAa,wBAAwB;IACnC,EAAE,CACA,UAAkB,EAClB,GAAqB,EACrB,QAAiD;QAEjD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CACF,UAAkB,EAClB,GAAqB,EACrB,QAAiC;QAEjC,OAAO,IAAI,iCAAsB,CAAC,GAAG,EAAE;YACrC,+BAA+B;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,UAAkB,EAAE,GAAqB;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,GAAqB;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,UAAkB,EAAE,GAAqB,EAAE,OAAe,IAAS,CAAC;IAElF,oBAAoB,CAAC,UAAkB,EAAE,GAAqB;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uBAAuB,CACrB,UAAkB,EAClB,GAAqB,EACrB,OAAe,IACR,CAAC;IAEV,eAAe,CACb,UAAkB,EAClB,GAAqB,EACrB,aAAiC,IAC1B,CAAC;IAEV,WAAW,CAAC,UAAkB,EAAE,GAAqB;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CAAC,UAAkB,EAAE,GAAqB,IAAS,CAAC;IAEpE,aAAa,KAAU,CAAC;IAExB,KAAK,KAAU,CAAC;IAEhB,UAAU,KAAU,CAAC;CACtB;AAxDD,4DAwDC"}

package/dist/commonjs/v3/sessionStreams/types.d.ts

@@ -0,0 +1,65 @@
+import { InputStreamOnceOptions } from "../realtimeStreams/types.js";
+import { InputStreamOncePromise, InputStreamOnceResult, InputStreamTimeoutError } from "../inputStreams/types.js";
+/**
+ * Re-export the run-scoped input stream once-promise machinery so callers
+ * depending on sessionStreams don't also need to import from inputStreams.
+ * Both APIs return the same shape.
+ */
+export { InputStreamOncePromise, InputStreamTimeoutError };
+export type { InputStreamOnceResult };
+export type SessionChannelIO = "out" | "in";
+/**
+ * Manager for Session channel reads: a session-scoped parallel to
+ * {@link InputStreamManager} keyed on `(sessionId, io)` instead of
+ * `(runId, streamId)`. Used by {@link SessionChannel} to implement
+ * `.on` / `.once` / `.peek` / `.wait` / `.waitWithIdleTimeout`.
+ */
+export interface SessionStreamManager {
+    /** Register a handler that fires every time data arrives on the given channel. */
+    on(sessionId: string, io: SessionChannelIO, handler: (data: unknown) => void | Promise<void>): {
+        off: () => void;
+    };
+    /** Wait for the next record on the given channel (buffered or live). */
+    once(sessionId: string, io: SessionChannelIO, options?: InputStreamOnceOptions): InputStreamOncePromise<unknown>;
+    /** Non-blocking peek at the head of the channel buffer. */
+    peek(sessionId: string, io: SessionChannelIO): unknown | undefined;
+    /** Last S2 sequence number seen on the given channel. */
+    lastSeqNum(sessionId: string, io: SessionChannelIO): number | undefined;
+    /** Advance the last-seen sequence number (prevents SSE replay after `.wait` resume). */
+    setLastSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number): void;
+    /**
+     * Highest sequence number that has been *consumed* on the channel —
+     * delivered to a `once()` waiter or shifted off the buffer into one.
+     * Distinct from {@link lastSeqNum}, which advances on every received
+     * record regardless of whether anything consumed it. Used by
+     * `chat.agent` to persist the `.in` resume cursor on each
+     * `turn-complete` control record so the next worker boot can resume
+     * the channel from this point without replaying processed messages.
+     */
+    lastDispatchedSeqNum(sessionId: string, io: SessionChannelIO): number | undefined;
+    /**
+     * Seed the committed-consume cursor at worker boot — e.g. from the
+     * `session-in-event-id` header on the latest `turn-complete` on
+     * `.out`. Monotonic: only ever advances forward, never backwards.
+     */
+    setLastDispatchedSeqNum(sessionId: string, io: SessionChannelIO, seqNum: number): void;
+    /**
+     * Set a per-stream lower-bound SSE timestamp. Records whose timestamp
+     * is `<= minTimestamp` are dropped before dispatch. Used by chat.agent
+     * on OOM-retry boot to skip session.in records belonging to turns
+     * that already completed on the prior attempt.
+     *
+     * Pass `undefined` to clear the filter.
+     */
+    setMinTimestamp(sessionId: string, io: SessionChannelIO, minTimestamp: number | undefined): void;
+    /** Remove and discard the first buffered record. Returns true if one was removed. */
+    shiftBuffer(sessionId: string, io: SessionChannelIO): boolean;
+    /** Abort the SSE tail and clear the buffer. Called before `.wait` suspends. */
+    disconnectStream(sessionId: string, io: SessionChannelIO): void;
+    /** Clear all `.on` handlers; abort tails without pending once-waiters. */
+    clearHandlers(): void;
+    /** Reset state between task executions. */
+    reset(): void;
+    /** Disconnect every tail. */
+    disconnect(): void;
+}

package/dist/commonjs/v3/sessionStreams/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputStreamTimeoutError = exports.InputStreamOncePromise = void 0;
+const types_js_1 = require("../inputStreams/types.js");
+Object.defineProperty(exports, "InputStreamOncePromise", { enumerable: true, get: function () { return types_js_1.InputStreamOncePromise; } });
+Object.defineProperty(exports, "InputStreamTimeoutError", { enumerable: true, get: function () { return types_js_1.InputStreamTimeoutError; } });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/types.ts"],"names":[],"mappings":";;;AACA,uDAIkC;AAOzB,uGAVP,iCAAsB,OAUO;AAAE,wGAR/B,kCAAuB,OAQ+B"}

package/dist/commonjs/v3/sessionStreams/wireProtocol.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Wire-format constants for records on `session.out` / `session.in`.
+ *
+ * Three kinds of records can appear on a Session stream:
+ *
+ * 1. **Data records** — JSON body shaped as `{data: <UIMessageChunk>, id:
+ *    <partId>}`, no special headers. The substance of the conversation.
+ *
+ * 2. **Trigger control records** — empty body, `headers` carry `[
+ *    ["trigger-control", <subtype>], ...]` plus any subtype-specific sibling
+ *    headers (e.g. `public-access-token` on `turn-complete`). Routed to a
+ *    consumer's `onControl` callback; never surfaced as data chunks.
+ *
+ * 3. **S2 command records** — opaque body, `headers` first entry has an
+ *    empty name (only valid for S2-interpreted directives like `trim` and
+ *    `fence`). Filtered out at the SSE parser; consumers never see them.
+ *
+ * See `docs/ai-chat/client-protocol.mdx#records-on-session-out` for the
+ * customer-facing contract.
+ */
+/** Header name carrying the Trigger control subtype on control records. */
+export declare const TRIGGER_CONTROL_HEADER: "trigger-control";
+/** Header name carrying the refreshed `publicAccessToken` on `turn-complete`. */
+export declare const PUBLIC_ACCESS_TOKEN_HEADER: "public-access-token";
+/** Header name carrying the agent's last S2 event id on a handover bridge. */
+export declare const SESSION_STATE_LAST_EVENT_ID_HEADER: "last-event-id";
+/**
+ * Header on `turn-complete` records carrying the highest `session.in`
+ * seq_num the agent committed to processing during this turn. Read on
+ * the next worker boot to seed `.in`'s resume cursor — anything past
+ * this seq is new and gets delivered; anything at-or-before was already
+ * processed and is skipped. Decimal-string form of the seq_num.
+ *
+ * Omitted when no `.in` records have been consumed yet (first turn of a
+ * fresh chat triggered via the wire payload).
+ */
+export declare const SESSION_IN_EVENT_ID_HEADER: "session-in-event-id";
+export declare const TRIGGER_CONTROL_SUBTYPE: {
+    readonly TURN_COMPLETE: "turn-complete";
+    readonly UPGRADE_REQUIRED: "upgrade-required";
+};
+export type TriggerControlSubtype = (typeof TRIGGER_CONTROL_SUBTYPE)[keyof typeof TRIGGER_CONTROL_SUBTYPE];
+/** Read a single header value by name. Returns the first match. */
+export declare function headerValue(headers: ReadonlyArray<readonly [string, string]> | undefined, name: string): string | undefined;
+/**
+ * Return the Trigger control subtype carried by a record's headers, if any.
+ * Returns `undefined` for data records and S2 command records.
+ */
+export declare function controlSubtype(headers: ReadonlyArray<readonly [string, string]> | undefined): string | undefined;
+/**
+ * Is this record an S2 command record? Detected via the empty-name first
+ * header, which S2 permits only for command records (trim/fence).
+ */
+export declare function isS2CommandRecord(headers: ReadonlyArray<readonly [string, string]> | undefined): boolean;
+/** Event payload delivered to a Session-stream `onControl` callback. */
+export type ControlEvent = {
+    /** Subtype value from the `trigger-control` header (e.g. `turn-complete`). */
+    subtype: string;
+    /** All headers on the underlying record. Read additional metadata here. */
+    headers: ReadonlyArray<readonly [string, string]>;
+    /** S2 sequence number of the control record. */
+    seqNum: number;
+    /** S2 arrival timestamp of the control record (ms since epoch). */
+    timestamp: number;
+};

package/dist/commonjs/v3/sessionStreams/wireProtocol.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Wire-format constants for records on `session.out` / `session.in`.
+ *
+ * Three kinds of records can appear on a Session stream:
+ *
+ * 1. **Data records** — JSON body shaped as `{data: <UIMessageChunk>, id:
+ *    <partId>}`, no special headers. The substance of the conversation.
+ *
+ * 2. **Trigger control records** — empty body, `headers` carry `[
+ *    ["trigger-control", <subtype>], ...]` plus any subtype-specific sibling
+ *    headers (e.g. `public-access-token` on `turn-complete`). Routed to a
+ *    consumer's `onControl` callback; never surfaced as data chunks.
+ *
+ * 3. **S2 command records** — opaque body, `headers` first entry has an
+ *    empty name (only valid for S2-interpreted directives like `trim` and
+ *    `fence`). Filtered out at the SSE parser; consumers never see them.
+ *
+ * See `docs/ai-chat/client-protocol.mdx#records-on-session-out` for the
+ * customer-facing contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRIGGER_CONTROL_SUBTYPE = exports.SESSION_IN_EVENT_ID_HEADER = exports.SESSION_STATE_LAST_EVENT_ID_HEADER = exports.PUBLIC_ACCESS_TOKEN_HEADER = exports.TRIGGER_CONTROL_HEADER = void 0;
+exports.headerValue = headerValue;
+exports.controlSubtype = controlSubtype;
+exports.isS2CommandRecord = isS2CommandRecord;
+/** Header name carrying the Trigger control subtype on control records. */
+exports.TRIGGER_CONTROL_HEADER = "trigger-control";
+/** Header name carrying the refreshed `publicAccessToken` on `turn-complete`. */
+exports.PUBLIC_ACCESS_TOKEN_HEADER = "public-access-token";
+/** Header name carrying the agent's last S2 event id on a handover bridge. */
+exports.SESSION_STATE_LAST_EVENT_ID_HEADER = "last-event-id";
+/**
+ * Header on `turn-complete` records carrying the highest `session.in`
+ * seq_num the agent committed to processing during this turn. Read on
+ * the next worker boot to seed `.in`'s resume cursor — anything past
+ * this seq is new and gets delivered; anything at-or-before was already
+ * processed and is skipped. Decimal-string form of the seq_num.
+ *
+ * Omitted when no `.in` records have been consumed yet (first turn of a
+ * fresh chat triggered via the wire payload).
+ */
+exports.SESSION_IN_EVENT_ID_HEADER = "session-in-event-id";
+exports.TRIGGER_CONTROL_SUBTYPE = {
+    TURN_COMPLETE: "turn-complete",
+    UPGRADE_REQUIRED: "upgrade-required",
+};
+/** Read a single header value by name. Returns the first match. */
+function headerValue(headers, name) {
+    if (!headers)
+        return undefined;
+    for (const entry of headers) {
+        if (entry?.[0] === name)
+            return entry[1];
+    }
+    return undefined;
+}
+/**
+ * Return the Trigger control subtype carried by a record's headers, if any.
+ * Returns `undefined` for data records and S2 command records.
+ */
+function controlSubtype(headers) {
+    return headerValue(headers, exports.TRIGGER_CONTROL_HEADER);
+}
+/**
+ * Is this record an S2 command record? Detected via the empty-name first
+ * header, which S2 permits only for command records (trim/fence).
+ */
+function isS2CommandRecord(headers) {
+    return headers?.[0]?.[0] === "";
+}
+//# sourceMappingURL=wireProtocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wireProtocol.js","sourceRoot":"","sources":["../../../../src/v3/sessionStreams/wireProtocol.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAgCH,kCASC;AAMD,wCAIC;AAMD,8CAIC;AA3DD,2EAA2E;AAC9D,QAAA,sBAAsB,GAAG,iBAA0B,CAAC;AAEjE,iFAAiF;AACpE,QAAA,0BAA0B,GAAG,qBAA8B,CAAC;AAEzE,8EAA8E;AACjE,QAAA,kCAAkC,GAAG,eAAwB,CAAC;AAE3E;;;;;;;;;GASG;AACU,QAAA,0BAA0B,GAAG,qBAA8B,CAAC;AAE5D,QAAA,uBAAuB,GAAG;IACrC,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC;AAKX,mEAAmE;AACnE,SAAgB,WAAW,CACzB,OAA6D,EAC7D,IAAY;IAEZ,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA6D;IAE7D,OAAO,WAAW,CAAC,OAAO,EAAE,8BAAsB,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,OAA6D;IAE7D,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC"}

package/dist/commonjs/v3/taskContext/index.d.ts

@@ -5,6 +5,7 @@ export declare class TaskContextAPI {
     #private;
     private static _instance?;
     private _runDisabled;
+    private _conversationId?;
     private constructor();
     static getInstance(): TaskContextAPI;
     get isInsideTask(): boolean;
@@ -13,6 +14,9 @@ export declare class TaskContextAPI {
     get worker(): ServerBackgroundWorker | undefined;
     get isWarmStart(): boolean | undefined;
     get attributes(): Attributes;
+    get conversationAttributes(): Attributes;
+    get conversationId(): string | undefined;
+    setConversationId(conversationId: string | undefined): void;
     get resourceAttributes(): Attributes;
     get workerAttributes(): Attributes;
     get contextAttributes(): Attributes;

package/dist/commonjs/v3/taskContext/index.js

@@ -7,6 +7,7 @@ const API_NAME = "task-context";
 class TaskContextAPI {
     static _instance;
     _runDisabled = false;
+    _conversationId;
     constructor() { }
     static getInstance() {
         if (!this._instance) {
@@ -34,11 +35,23 @@ class TaskContextAPI {
             return {
                 ...this.contextAttributes,
                 ...this.workerAttributes,
+                ...this.conversationAttributes,
                 [semanticInternalAttributes_js_1.SemanticInternalAttributes.WARM_START]: !!this.isWarmStart,
             };
         }
         return {};
     }
+    get conversationAttributes() {
+        if (!this._conversationId)
+            return {};
+        return { [semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID]: this._conversationId };
+    }
+    get conversationId() {
+        return this._conversationId;
+    }
+    setConversationId(conversationId) {
+        this._conversationId = conversationId || undefined;
+    }
     get resourceAttributes() {
         if (this.ctx) {
             return {
@@ -89,6 +102,11 @@ class TaskContextAPI {
     }
     setGlobalTaskContext(taskContext) {
         this._runDisabled = false;
+        // Each run boot re-registers the global; clear any conversation id
+        // left over from a previous run on this warm-restarted process so
+        // attributes don't bleed across runs that don't call
+        // `setConversationId` themselves.
+        this._conversationId = undefined;
         return (0, globals_js_1.registerGlobal)(API_NAME, taskContext, true);
     }
     #getTaskContext() {

package/dist/commonjs/v3/taskContext/index.js.map

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

package/dist/commonjs/v3/taskContext/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/taskContext/index.test.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const globals_js_1 = require("../utils/globals.js");
+const semanticInternalAttributes_js_1 = require("../semanticInternalAttributes.js");
+const index_js_1 = require("./index.js");
+const FAKE_CTX = {
+    attempt: { id: "attempt_1", number: 1, startedAt: new Date(), status: "EXECUTING" },
+    run: {
+        id: "run_1",
+        payload: undefined,
+        payloadType: "application/json",
+        context: undefined,
+        createdAt: new Date(),
+        tags: [],
+        isTest: false,
+        isReplay: false,
+        startedAt: new Date(),
+        durationMs: 0,
+        costInCents: 0,
+        baseCostInCents: 0,
+    },
+    task: { id: "my-task", filePath: "src/trigger/task.ts", exportName: "myTask" },
+    queue: { id: "queue_1", name: "default" },
+    environment: { id: "env_1", slug: "dev", type: "DEVELOPMENT" },
+    organization: { id: "org_1", slug: "acme", name: "Acme" },
+    project: { id: "proj_1", ref: "proj_xyz", slug: "demo", name: "Demo" },
+    machine: {
+        name: "small-1x",
+        cpu: 0.5,
+        memory: 0.5,
+        centsPerMs: 0.0001,
+    },
+};
+const FAKE_WORKER = { id: "worker_1", version: "1.0.0", contentHash: "abc" };
+(0, vitest_1.describe)("TaskContextAPI conversation id", () => {
+    (0, vitest_1.afterEach)(() => {
+        (0, globals_js_1.unregisterGlobal)("task-context");
+        index_js_1.TaskContextAPI.getInstance().setConversationId(undefined);
+    });
+    (0, vitest_1.it)("returns no conversation attribute when setConversationId was never called", () => {
+        const api = index_js_1.TaskContextAPI.getInstance();
+        api.setGlobalTaskContext({ ctx: FAKE_CTX, worker: FAKE_WORKER });
+        (0, vitest_1.expect)(api.attributes[semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID]).toBeUndefined();
+    });
+    (0, vitest_1.it)("includes gen_ai.conversation.id after setConversationId", () => {
+        const api = index_js_1.TaskContextAPI.getInstance();
+        api.setGlobalTaskContext({ ctx: FAKE_CTX, worker: FAKE_WORKER });
+        api.setConversationId("chat_123");
+        (0, vitest_1.expect)(api.attributes[semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID]).toBe("chat_123");
+    });
+    (0, vitest_1.it)("clears the conversation attribute when called with undefined", () => {
+        const api = index_js_1.TaskContextAPI.getInstance();
+        api.setGlobalTaskContext({ ctx: FAKE_CTX, worker: FAKE_WORKER });
+        api.setConversationId("chat_123");
+        api.setConversationId(undefined);
+        (0, vitest_1.expect)(api.attributes[semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID]).toBeUndefined();
+        (0, vitest_1.expect)(api.conversationId).toBeUndefined();
+    });
+    (0, vitest_1.it)("returns no attributes when there is no task context", () => {
+        const api = index_js_1.TaskContextAPI.getInstance();
+        api.setConversationId("chat_123");
+        (0, vitest_1.expect)(api.attributes).toEqual({});
+    });
+    (0, vitest_1.it)("clears conversation id when a new task context is registered (warm restart)", () => {
+        const api = index_js_1.TaskContextAPI.getInstance();
+        api.setGlobalTaskContext({ ctx: FAKE_CTX, worker: FAKE_WORKER });
+        api.setConversationId("chat_old");
+        api.setGlobalTaskContext({ ctx: FAKE_CTX, worker: FAKE_WORKER });
+        (0, vitest_1.expect)(api.attributes[semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID]).toBeUndefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commonjs/v3/taskContext/index.test.js.map

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

package/dist/commonjs/v3/taskContext/otelProcessors.js

@@ -22,6 +22,13 @@ class TaskContextSpanProcessor {
             if (!task_context_api_js_1.taskContext.isRunDisabled && task_context_api_js_1.taskContext.ctx.run.tags?.length) {
                 span.setAttribute(semanticInternalAttributes_js_1.SemanticInternalAttributes.RUN_TAGS, task_context_api_js_1.taskContext.ctx.run.tags);
             }
+            // Stamp `gen_ai.conversation.id` (OTel GenAI semantic convention)
+            // directly on every span so it survives the OTLP ingest's `ctx.*`
+            // strip and lands in the stored attributes column without a schema
+            // migration.
+            if (task_context_api_js_1.taskContext.conversationId) {
+                span.setAttribute(semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID, task_context_api_js_1.taskContext.conversationId);
+            }
         }
         if (!isPartialSpan(span) && !skipPartialSpan(span)) {
             const partialSpan = createPartialSpan(this._tracer, span, parentContext);
@@ -137,6 +144,10 @@ class TaskContextMetricExporter {
         if (!task_context_api_js_1.taskContext.isRunDisabled && ctx.run.tags?.length) {
             contextAttrs[semanticInternalAttributes_js_1.SemanticInternalAttributes.RUN_TAGS] = ctx.run.tags;
         }
+        if (task_context_api_js_1.taskContext.conversationId) {
+            contextAttrs[semanticInternalAttributes_js_1.SemanticInternalAttributes.GEN_AI_CONVERSATION_ID] =
+                task_context_api_js_1.taskContext.conversationId;
+        }
         const modified = {
             resource: metrics.resource,
             scopeMetrics: metrics.scopeMetrics.map((scope) => ({