@trigger.dev/sdk 4.6.4 → 4.7.1

package/dist/commonjs/v3/managedChatResponse.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManagedChatResponse = void 0;
+exports.createOrderedChatWriter = createOrderedChatWriter;
+const ai_runtime_js_1 = require("../imports/ai-runtime.js");
+/** One ordered output channel for a turn's managed model and data chunks. */
+class ManagedChatResponse {
+    publish;
+    controller;
+    completion;
+    failure;
+    closed = false;
+    chunks = [];
+    original;
+    fallbackId = (0, ai_runtime_js_1.generateId)();
+    completedSteps = 0;
+    dataBoundary = 0;
+    generationOffset = 0;
+    orderedSteps = true;
+    pendingData = [];
+    constructor(publish) {
+        this.publish = publish;
+    }
+    seed(messages) {
+        // Never mutate the caller's history while processing a continuation.
+        const last = messages?.at(-1);
+        this.original = last?.role === "assistant" ? structuredClone(last) : undefined;
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    get revision() {
+        return this.chunks.length;
+    }
+    continues(id) {
+        return this.original?.id === id;
+    }
+    beginGeneration() {
+        this.generationOffset = this.completedSteps;
+        this.dataBoundary = this.completedSteps;
+    }
+    afterStep(completedSteps) {
+        this.dataBoundary = this.orderedSteps ? this.generationOffset + completedSteps : 0;
+    }
+    /** Raw pipes own their output ordering and do not feed this capture. */
+    useRawPipe() {
+        this.orderedSteps = false;
+        this.dataBoundary = 0;
+        this.flushPendingData();
+    }
+    flushPendingData() {
+        this.dataBoundary = this.completedSteps;
+        for (const next of this.pendingData.splice(0))
+            this.write(next.chunk, next.capture);
+    }
+    writeData(chunk) {
+        const capture = chunk.type.startsWith("data-") && !("transient" in chunk && chunk.transient);
+        if (this.closed)
+            throw new Error("The managed chat response is closed");
+        if (this.dataBoundary > this.completedSteps) {
+            this.pendingData.push({ chunk, capture, after: this.dataBoundary });
+        }
+        else
+            this.write(chunk, capture);
+    }
+    write(chunk, capture = true) {
+        if (this.closed)
+            throw new Error("The managed chat response is closed");
+        if (this.failure)
+            throw this.failure;
+        if (!this.controller) {
+            const stream = new ReadableStream({
+                start: (controller) => {
+                    this.controller = controller;
+                },
+            });
+            this.completion = this.publish(stream);
+            // Transport errors are observed by pipe/close; never leave an unhandled
+            // rejection when a fire-and-forget custom write opened the response.
+            this.completion.catch((error) => {
+                this.failure = error;
+            });
+        }
+        if (capture)
+            this.chunks.push(chunk);
+        this.controller.enqueue(chunk);
+        if (capture && chunk.type === "finish-step") {
+            this.completedSteps++;
+            while (this.pendingData[0] && this.pendingData[0].after <= this.completedSteps) {
+                const next = this.pendingData.shift();
+                this.write(next.chunk, next.capture);
+            }
+        }
+    }
+    async pipe(source, signal) {
+        const reader = source instanceof ReadableStream ? source.getReader() : undefined;
+        const iterator = reader
+            ? undefined
+            : source[Symbol.asyncIterator]();
+        let rejectAbort;
+        const aborted = new Promise((_, reject) => {
+            rejectAbort = reject;
+        });
+        // A pre-aborted signal or a synchronously throwing iterator can leave this
+        // promise outside the read race; observe its rejection in either case.
+        aborted.catch(() => { });
+        const cancel = () => rejectAbort(signal?.reason);
+        signal?.addEventListener("abort", cancel, { once: true });
+        try {
+            while (true) {
+                signal?.throwIfAborted();
+                if (this.failure)
+                    throw this.failure;
+                const next = reader ? reader.read() : iterator.next();
+                const result = signal ? await Promise.race([next, aborted]) : await next;
+                signal?.throwIfAborted();
+                if (result.done)
+                    break;
+                this.write(result.value);
+            }
+        }
+        finally {
+            signal?.removeEventListener("abort", cancel);
+            try {
+                if (signal?.aborted) {
+                    // Async generators can queue return() behind a blocked next(). Stop
+                    // the turn without waiting for provider cleanup, and observe failures.
+                    try {
+                        void Promise.resolve(reader ? reader.cancel(signal.reason) : iterator?.return?.()).catch(() => { });
+                    }
+                    catch {
+                        // A synchronous cleanup failure must not replace the abort reason.
+                    }
+                }
+                else if (iterator)
+                    await iterator.return?.();
+            }
+            finally {
+                reader?.releaseLock();
+                // No further finish-step can arrive from this source. Preserve accepted
+                // data at the end of the available partial before callers snapshot it.
+                this.flushPendingData();
+            }
+        }
+    }
+    /** Native reduction of the exact admitted chunks, including same-ID updates. */
+    async snapshot(options) {
+        if (!this.chunks.length)
+            return options?.message;
+        const chunks = this.chunks.slice(options?.from ?? 0);
+        let message = options?.message;
+        const original = options?.message ?? this.original;
+        const stream = new ReadableStream({
+            start(controller) {
+                for (const chunk of chunks)
+                    controller.enqueue(chunk);
+                controller.close();
+            },
+        });
+        for await (const update of (0, ai_runtime_js_1.readUIMessageStream)({
+            stream,
+            ...(original ? { message: structuredClone(original) } : {}),
+            // An error chunk must leave previously streamed content recoverable.
+            terminateOnError: false,
+        }))
+            message = update;
+        return message ? { ...message, id: message.id || this.fallbackId } : undefined;
+    }
+    async close() {
+        if (!this.closed) {
+            this.flushPendingData();
+            // A data-only response still needs the same server ID on both sides.
+            if (!this.original &&
+                this.chunks.length &&
+                !this.chunks.some((chunk) => chunk.type === "start")) {
+                this.write({ type: "start", messageId: this.fallbackId });
+            }
+            this.closed = true;
+            this.controller?.close();
+        }
+        await this.completion;
+    }
+}
+exports.ManagedChatResponse = ManagedChatResponse;
+/** Hook streams share a publisher; only persistent data joins managed capture. */
+function createOrderedChatWriter(activeResponse, publish) {
+    const raw = new ManagedChatResponse(publish);
+    const merging = [];
+    const writer = {
+        write(part) {
+            const managed = activeResponse();
+            if (managed)
+                managed.writeData(part);
+            else
+                raw.write(part, false);
+        },
+        merge(stream) {
+            const work = (async () => {
+                const reader = stream.getReader();
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        writer.write(value);
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            })();
+            work.catch(() => { });
+            merging.push(work);
+        },
+    };
+    return {
+        writer,
+        async flush() {
+            try {
+                let cursor = 0;
+                while (cursor < merging.length) {
+                    const batch = merging.slice(cursor);
+                    cursor = merging.length;
+                    await Promise.all(batch);
+                }
+            }
+            finally {
+                await raw.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=managedChatResponse.js.map

package/dist/commonjs/v3/managedChatResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managedChatResponse.js","sourceRoot":"","sources":["../../../src/v3/managedChatResponse.ts"],"names":[],"mappings":";;;;AACA,4DAA2E;AAE3E,6EAA6E;AAC7E;IAeqB,OAAO;IAdlB,UAAU,CAAmD;IAC7D,UAAU,CAAoB;IAC9B,OAAO,CAAW;IAClB,MAAM,GAAG,KAAK,CAAC;IACf,MAAM,GAAqB,EAAE,CAAC;IAC9B,QAAQ,CAAa;IACrB,UAAU,GAAG,IAAA,0BAAU,GAAE,CAAC;IAC1B,cAAc,GAAG,CAAC,CAAC;IACnB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,YAAY,GAAG,IAAI,CAAC;IACpB,WAAW,GAAsE,EAAE,CAAC;IAE5F,YACmB,OAAqE;uBAArE,OAAO;IACvB,CAAC;IAEJ,IAAI,CAAC,QAA0C;QAC7C,qEAAqE;QACrE,MAAM,IAAI,GAAG,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,eAAe;QACb,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;IAC1C,CAAC;IAED,SAAS,CAAC,cAAsB;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,wEAAwE;IACxE,UAAU;QACR,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtF,CAAC;IAED,SAAS,CAAC,KAAqB;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACtE,CAAC;;YAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAqB,EAAE,OAAO,GAAG,IAAI;QACzC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACxE,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAiB;gBAChD,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;oBACpB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC/B,CAAC;aACF,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvC,wEAAwE;YACxE,qEAAqE;YACrE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC9B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,UAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAG,CAAC;gBACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAsE,EACtE,MAAoB;QAEpB,MAAM,MAAM,GAAG,MAAM,YAAY,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,MAAM,QAAQ,GAAG,MAAM;YACrB,CAAC,CAAC,SAAS;YACX,CAAC,CAAE,MAAwC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACtE,IAAI,WAAuC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YAC/C,WAAW,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,2EAA2E;QAC3E,uEAAuE;QACvE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,cAAc,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,CAAC,OAAO,CAAC;gBACrC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAS,CAAC,IAAI,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC;gBACzE,MAAM,EAAE,cAAc,EAAE,CAAC;gBACzB,IAAI,MAAM,CAAC,IAAI;oBAAE,MAAM;gBACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACH,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,oEAAoE;oBACpE,uEAAuE;oBACvE,IAAI,CAAC;wBACH,KAAK,OAAO,CAAC,OAAO,CAClB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAC7D,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACpB,CAAC;oBAAC,MAAM,CAAC;wBACP,mEAAmE;oBACrE,CAAC;gBACH,CAAC;qBAAM,IAAI,QAAQ;oBAAE,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,WAAW,EAAE,CAAC;gBACtB,wEAAwE;gBACxE,uEAAuE;gBACvE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,QAAQ,CAAC,OAA8C;QAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,OAAO,EAAE,OAAO,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,OAAO,GAA0B,OAAO,EAAE,OAAO,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAiB;YAChD,KAAK,CAAC,UAAU;gBACd,KAAK,MAAM,KAAK,IAAI,MAAM;oBAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACtD,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;SACF,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,IAAA,mCAAmB,EAAC;YAC7C,MAAM;YACN,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,qEAAqE;YACrE,gBAAgB,EAAE,KAAK;SACxB,CAAC;YACA,OAAO,GAAG,MAAM,CAAC;QACnB,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,qEAAqE;YACrE,IACE,CAAC,IAAI,CAAC,QAAQ;gBACd,IAAI,CAAC,MAAM,CAAC,MAAM;gBAClB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,EACpD,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;CACF;;AAED,kFAAkF;AAClF,iCACE,cAAqD,EACrD,OAAqE;IAErE,MAAM,GAAG,GAAG,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG;QACb,KAAK,CAAC,IAAoB;YACxB,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,IAAI,OAAO;gBAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;;gBAChC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,MAAsC;YAC1C,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,OAAO,IAAI,EAAE,CAAC;wBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;wBAC5C,IAAI,IAAI;4BAAE,MAAM;wBAChB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;IACF,OAAO;QACL,MAAM;QACN,KAAK,CAAC,KAAK;YACT,IAAI,CAAC;gBACH,IAAI,MAAM,GAAG,CAAC,CAAC;gBACf,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACpC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;oBACxB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commonjs/v3/queues.d.ts

@@ -47,6 +47,28 @@ export declare function pause(queue: RetrieveQueueParam, requestOptions?: ApiReq
 /**
  * Overrides the concurrency limit of a queue.
  *
+ * @deprecated Queue-level concurrency is the legacy model: a modern queue is only the
+ * ordered line runs wait in, and concurrency is declared on the task and managed
+ * through `concurrencyLimits`. The server rejects this call for queues on the new
+ * model. Migrate by declaring the limit and overriding it by name:
+ *
+ * ```ts
+ * export const myTask = task({
+ *   id: "my-task",
+ *   concurrency: { total: 5 },
+ *   run: async (payload) => {
+ *     // ...
+ *   },
+ * });
+ *
+ * await concurrencyLimits.override("task/my-task", { total: 10 });
+ * ```
+ *
+ * For workloads that pass a `concurrencyKey` at trigger time, declare `concurrency: { perKey: n }`
+ * instead (`total` caps all keys together). For a limit shared by several tasks, declare a named
+ * limit with `concurrencyLimit({ name, ... })`, making the same choice between `total` and
+ * `perKey`, pass it to each task's `concurrency` option, and override it by that name.
+ *
  * @param queue - The ID of the queue to override the concurrency limit, or the type and name
  * @param concurrencyLimit - The concurrency limit to override
  * @returns The updated queue state
@@ -55,6 +77,15 @@ export declare function overrideConcurrencyLimit(queue: RetrieveQueueParam, conc
 /**
  * Resets the concurrency limit of a queue to the base value.
  *
+ * @deprecated Queue-level concurrency is the legacy model: a modern queue is only the
+ * ordered line runs wait in, and concurrency is declared on the task and managed
+ * through `concurrencyLimits`. The server rejects this call for queues on the new
+ * model. Migrate by resetting the limit by name:
+ *
+ * ```ts
+ * await concurrencyLimits.reset("task/my-task");
+ * ```
+ *
  * @param queue - The ID of the queue to reset the concurrency limit, or the type and name
  * @returns The updated queue state
  */

package/dist/commonjs/v3/queues.js

@@ -104,6 +104,28 @@ function pause(queue, requestOptions) {
 /**
  * Overrides the concurrency limit of a queue.
  *
+ * @deprecated Queue-level concurrency is the legacy model: a modern queue is only the
+ * ordered line runs wait in, and concurrency is declared on the task and managed
+ * through `concurrencyLimits`. The server rejects this call for queues on the new
+ * model. Migrate by declaring the limit and overriding it by name:
+ *
+ * ```ts
+ * export const myTask = task({
+ *   id: "my-task",
+ *   concurrency: { total: 5 },
+ *   run: async (payload) => {
+ *     // ...
+ *   },
+ * });
+ *
+ * await concurrencyLimits.override("task/my-task", { total: 10 });
+ * ```
+ *
+ * For workloads that pass a `concurrencyKey` at trigger time, declare `concurrency: { perKey: n }`
+ * instead (`total` caps all keys together). For a limit shared by several tasks, declare a named
+ * limit with `concurrencyLimit({ name, ... })`, making the same choice between `total` and
+ * `perKey`, pass it to each task's `concurrency` option, and override it by that name.
+ *
  * @param queue - The ID of the queue to override the concurrency limit, or the type and name
  * @param concurrencyLimit - The concurrency limit to override
  * @returns The updated queue state
@@ -132,6 +154,15 @@ function overrideConcurrencyLimit(queue, concurrencyLimit, requestOptions) {
 /**
  * Resets the concurrency limit of a queue to the base value.
  *
+ * @deprecated Queue-level concurrency is the legacy model: a modern queue is only the
+ * ordered line runs wait in, and concurrency is declared on the task and managed
+ * through `concurrencyLimits`. The server rejects this call for queues on the new
+ * model. Migrate by resetting the limit by name:
+ *
+ * ```ts
+ * await concurrencyLimits.reset("task/my-task");
+ * ```
+ *
  * @param queue - The ID of the queue to reset the concurrency limit, or the type and name
  * @returns The updated queue state
  */

package/dist/commonjs/v3/queues.js.map

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

package/dist/commonjs/v3/shared.d.ts

@@ -1,8 +1,25 @@
-import { type ApiRequestOptions, type InitOutput, type Queue, type QueueOptions, type TaskFromIdentifier, type TaskRunContext, ApiError, SubtaskUnwrapError, TaskRunPromise, type AnyRunHandle, type AnyTask, type BatchByIdAndWaitItem, type BatchByIdItem, type BatchByIdResult, type BatchByTaskAndWaitItem, type BatchByTaskItem, type BatchByTaskResult, type BatchItem, type BatchItemNDJSON, type BatchResult, type BatchRunHandle, type BatchRunHandleFromTypes, type BatchTasksRunHandleFromTypes, type BatchTriggerAndWaitOptions, type BatchTriggerOptions, type InferRunTypes, type RunHandle, type RunHandleFromTypes, type Task, type TaskIdentifier, type TaskOptions, type TaskOptionsWithSchema, type TaskOutput, type TaskPayload, type TaskRunResult, type TaskSchema, type TaskWithSchema, type TaskWithSchemaOptions, type TaskWithToolOptions, type ToolTask, type ToolTaskParameters, type TriggerAndSubscribeOptions, type TriggerAndWaitOptions, type TriggerApiRequestOptions, type TriggerOptions } from "@trigger.dev/core/v3";
+import { type ApiRequestOptions, type InitOutput, type Queue, type QueueOptions, type TaskFromIdentifier, type TaskRunContext, ApiError, SubtaskUnwrapError, TaskRunPromise, type AnyRunHandle, type AnyTask, type BatchByIdAndWaitItem, type BatchByIdItem, type BatchByIdResult, type BatchByTaskAndWaitItem, type BatchByTaskItem, type BatchByTaskResult, type BatchItem, type BatchItemNDJSON, type BatchResult, type BatchRunHandle, type BatchRunHandleFromTypes, type BatchTasksRunHandleFromTypes, type BatchTriggerAndWaitOptions, type BatchTriggerOptions, type InferRunTypes, type RunHandle, type RunHandleFromTypes, type Task, type TaskIdentifier, type TaskOptions, type TaskOptionsWithSchema, type TaskOutput, type TaskPayload, type TaskRunResult, type TaskSchema, type TaskWithSchema, type TaskWithSchemaOptions, type TaskWithToolOptions, type ToolTask, type ToolTaskParameters, type TriggerAndSubscribeOptions, type TriggerAndWaitOptions, type TriggerApiRequestOptions, type TriggerOptions, type ConcurrencyLimitOptions, type ConcurrencyLimit } from "@trigger.dev/core/v3";
 export type { AnyRunHandle, AnyTask, BatchItem, BatchResult, BatchRunHandle, BatchTriggerOptions, Queue, RunHandle, Task, TaskFromIdentifier, TaskIdentifier, TaskOptions, TaskOptionsWithSchema, TaskOutput, TaskPayload, TaskRunResult, TaskSchema, TaskWithSchema, TaskWithSchemaOptions, TriggerOptions, };
 export { SubtaskUnwrapError, TaskRunPromise };
 export type Context = TaskRunContext;
 export declare function queue(options: QueueOptions): Queue;
+/**
+ * Declares a named, shareable concurrency limit. Tasks hold it via their `concurrency`
+ * option; every task holding the same limit draws from the same pools.
+ *
+ * @example
+ *
+ * ```ts
+ * export const openaiLimit = concurrencyLimit({ name: "openai", total: 25 });
+ *
+ * export const generateSummary = task({
+ *   id: "generate-summary",
+ *   concurrency: [{ total: 5 }, openaiLimit],
+ *   run: async (payload) => {},
+ * });
+ * ```
+ */
+export declare function concurrencyLimit(options: ConcurrencyLimitOptions): ConcurrencyLimit;
 export declare function createTask<TIdentifier extends string, TOutput = unknown, TInitOutput extends InitOutput = any>(params: TaskOptionsWithSchema<TIdentifier, TOutput, TInitOutput>): Task<TIdentifier, any, TOutput>;
 export declare function createTask<TIdentifier extends string, TInput = void, TOutput = unknown, TInitOutput extends InitOutput = any>(params: TaskOptions<TIdentifier, TInput, TOutput, TInitOutput>): Task<TIdentifier, TInput, TOutput>;
 /**