@trigger.dev/sdk 4.6.4 → 4.7.0

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

@@ -0,0 +1,21 @@
+import { type SessionChannelRouter, type SessionStreamRecord } from "@trigger.dev/core/v3";
+type ChatRouteWakeResult = {
+    ok: true;
+    waitpointId: string;
+} | {
+    ok: false;
+    error: Error;
+};
+export declare function waitForChatRouteAfterIdle(router: SessionChannelRouter, route: string, options: {
+    timeout?: string;
+    postWakeTimeoutMs?: number;
+    now?: () => number;
+    wake: (timeout: string | undefined, lastSeqNum: number | undefined) => Promise<ChatRouteWakeResult>;
+}): Promise<{
+    ok: true;
+    record: SessionStreamRecord;
+} | {
+    ok: false;
+    error: Error;
+}>;
+export {};

package/dist/commonjs/v3/chatRouteWait.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForChatRouteAfterIdle = waitForChatRouteAfterIdle;
+const v3_1 = require("@trigger.dev/core/v3");
+const isomorphic_1 = require("@trigger.dev/core/v3/isomorphic");
+const POST_WAKE_TIMEOUT_MS = 5_000;
+async function waitForChatRouteAfterIdle(router, route, options) {
+    const now = options.now ?? Date.now;
+    const timeoutMs = options.timeout ? (0, isomorphic_1.parseNaturalLanguageDurationInMs)(options.timeout) : undefined;
+    const parsedDeadline = timeoutMs !== undefined
+        ? now() + timeoutMs
+        : options.timeout === undefined
+            ? undefined
+            : Date.parse(options.timeout);
+    const deadline = parsedDeadline !== undefined && Number.isFinite(parsedDeadline) ? parsedDeadline : undefined;
+    const postWakeTimeoutMs = options.postWakeTimeoutMs ?? POST_WAKE_TIMEOUT_MS;
+    while (true) {
+        const remainingMs = deadline === undefined ? undefined : deadline - now();
+        if (remainingMs !== undefined && remainingMs <= 0) {
+            return { ok: false, error: new v3_1.WaitpointTimeoutError("Timed out") };
+        }
+        const wakeTimeout = remainingMs === undefined
+            ? options.timeout
+            : `${Math.max(1, Math.ceil(remainingMs / 1000))}s`;
+        // A queued record holds the replay floor back, but should not wake this
+        // waitpoint again after we have already seen it. Snapshot before checking
+        // the route so a record arriving during registration still wakes us.
+        const wakeFrom = router.appliedThrough();
+        const buffered = await router.next(route, { timeoutMs: 0 });
+        if (buffered)
+            return { ok: true, record: buffered };
+        const wake = await options.wake(wakeTimeout, wakeFrom);
+        if (!wake.ok)
+            return wake;
+        const deliveryBudget = deadline === undefined
+            ? postWakeTimeoutMs
+            : Math.max(0, Math.min(postWakeTimeoutMs, deadline - now()));
+        const record = await router.next(route, { timeoutMs: deliveryBudget });
+        if (record)
+            return { ok: true, record };
+    }
+}
+//# sourceMappingURL=chatRouteWait.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatRouteWait.js","sourceRoot":"","sources":["../../../src/v3/chatRouteWait.ts"],"names":[],"mappings":";;;AAAA,6CAI8B;AAC9B,gEAAmF;AAEnF,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAI5B,KAAK,oCACV,MAA4B,EAC5B,KAAa,EACb,OAQC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,6CAAgC,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,cAAc,GAClB,SAAS,KAAK,SAAS;QACrB,CAAC,CAAC,GAAG,EAAE,GAAG,SAAS;QACnB,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;YAC7B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GACZ,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,oBAAoB,CAAC;IAE5E,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;QAC1E,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,0BAAqB,CAAC,WAAW,CAAC,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,WAAW,GACf,WAAW,KAAK,SAAS;YACvB,CAAC,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC;QACvD,wEAAwE;QACxE,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAEpD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,cAAc,GAClB,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QACvE,IAAI,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/commonjs/v3/compactionResponse.js

@@ -27,6 +27,11 @@ function responseAfterCompaction(response, compactedSteps, originalResponse) {
             break;
         }
     }
+    // Injection/data events following the last summarized step precede the
+    // next step-start. They happened after compaction and belong to the suffix,
+    // including a stop before that next step ever started.
+    while (start > 0 && response.parts[start - 1]?.type.startsWith("data-"))
+        start--;
     return { ...response, parts: response.parts.slice(start) };
 }
 //# sourceMappingURL=compactionResponse.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"compactionResponse.js","sourceRoot":"","sources":["../../../src/v3/compactionResponse.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,iCACE,QAAW,EACX,cAAuB,EACvB,gBAA4B;IAE5B,IAAI,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC;IAErC,yEAAyE;IACzE,0EAA0E;IAC1E,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,aAAa,GACjB,gBAAgB,EAAE,EAAE,KAAK,QAAQ,CAAC,EAAE;QAClC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,MAAM;QAC5E,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACnD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,YAAY,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE,CAAC;YACrE,KAAK,GAAG,CAAC,CAAC;YACV,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"compactionResponse.js","sourceRoot":"","sources":["../../../src/v3/compactionResponse.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,iCACE,QAAW,EACX,cAAuB,EACvB,gBAA4B;IAE5B,IAAI,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC;IAErC,yEAAyE;IACzE,0EAA0E;IAC1E,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,aAAa,GACjB,gBAAgB,EAAE,EAAE,KAAK,QAAQ,CAAC,EAAE;QAClC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,MAAM;QAC5E,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACnD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,YAAY,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE,CAAC;YACrE,KAAK,GAAG,CAAC,CAAC;YACV,MAAM;QACR,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,4EAA4E;IAC5E,uDAAuD;IACvD,OAAO,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC;IACjF,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Concurrency helpers with no runtime dependencies, importable from the lean
+ * browser and route-handler entrypoints (chat-client, chat-server) without
+ * pulling the task runtime's module graph into those bundles.
+ */
+/**
+ * Trigger-time named limits: strings only, like `queue`. They replace the task's
+ * declared named limits for this run; the server resolves names to the run's gates.
+ */
+export declare function triggerConcurrencyBody(concurrency: string | string[] | undefined): {
+    concurrency?: string[];
+};
+export declare function validateConcurrencyLimitName(name: string): void;

package/dist/commonjs/v3/concurrency-shared.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Concurrency helpers with no runtime dependencies, importable from the lean
+ * browser and route-handler entrypoints (chat-client, chat-server) without
+ * pulling the task runtime's module graph into those bundles.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerConcurrencyBody = triggerConcurrencyBody;
+exports.validateConcurrencyLimitName = validateConcurrencyLimitName;
+/**
+ * Trigger-time named limits: strings only, like `queue`. They replace the task's
+ * declared named limits for this run; the server resolves names to the run's gates.
+ */
+function triggerConcurrencyBody(concurrency) {
+    if (concurrency === undefined) {
+        return {};
+    }
+    const limits = Array.isArray(concurrency) ? concurrency : [concurrency];
+    if (limits.length > 2) {
+        throw new Error("The concurrency option accepts at most two named limits.");
+    }
+    if (limits.some((name) => typeof name !== "string" || name.length === 0)) {
+        throw new Error("The concurrency option takes limit names: non-empty strings.");
+    }
+    for (const name of limits) {
+        validateConcurrencyLimitName(name);
+    }
+    return { concurrency: limits };
+}
+function validateConcurrencyLimitName(name) {
+    if (!/^[a-zA-Z0-9_-]{1,122}$/.test(name)) {
+        throw new Error(`Concurrency limit "${name}": names are 1-122 characters using only letters, numbers, underscores and hyphens.`);
+    }
+}
+//# sourceMappingURL=concurrency-shared.js.map

package/dist/commonjs/v3/concurrency-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-shared.js","sourceRoot":"","sources":["../../../src/v3/concurrency-shared.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH;;;GAGG;AACH,gCAAuC,WAA0C;IAG/E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,sCAA6C,IAAY;IACvD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,qFAAqF,CAChH,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,73 @@
+import type { ApiPromise, ApiRequestOptions, ConcurrencyLimitItem, ListConcurrencyLimitOptions, OffsetLimitPagePromise, OverrideConcurrencyLimitRequestBody } from "@trigger.dev/core/v3";
+/**
+ * Lists the environment's named concurrency limits (anonymous inline limits appear
+ * under their derived `task/<taskId>` names).
+ *
+ * @param options - The list options
+ * @param options.page - The page number
+ * @param options.perPage - The number of limits per page
+ * @returns The list of concurrency limits
+ */
+export declare function list(options?: ListConcurrencyLimitOptions, requestOptions?: ApiRequestOptions): OffsetLimitPagePromise<typeof ConcurrencyLimitItem>;
+/**
+ * Retrieves a concurrency limit by name.
+ *
+ * @example
+ *
+ * ```ts
+ * const limit = await concurrencyLimits.retrieve("openai");
+ * console.log(limit.running, limit.queued, limit.total.current);
+ * ```
+ * @param name - The limit's name, as declared with `concurrencyLimit()`
+ * @returns The concurrency limit
+ */
+export declare function retrieve(name: string, requestOptions?: ApiRequestOptions): ApiPromise<ConcurrencyLimitItem>;
+/**
+ * Overrides a concurrency limit's bounds. Only the given fields change; the
+ * declared values are kept as the base and restored by `reset`. To stop runs
+ * holding a limit, prefer `pause` (it keeps the configured bounds); overriding
+ * `total` to `0` also blocks every run holding the limit.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.override("openai", { total: 50 });
+ * ```
+ * @param name - The limit's name
+ * @param override - The bounds to change (`perKey` and/or `total`)
+ * @returns The updated concurrency limit
+ */
+export declare function override(name: string, override: OverrideConcurrencyLimitRequestBody, requestOptions?: ApiRequestOptions): ApiPromise<ConcurrencyLimitItem>;
+/**
+ * Resets a concurrency limit back to its declared values, clearing any override.
+ *
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+export declare function reset(name: string, requestOptions?: ApiRequestOptions): ApiPromise<ConcurrencyLimitItem>;
+/**
+ * Pauses a concurrency limit. Nothing holding the limit is admitted until it is
+ * resumed; runs already executing continue. The configured bounds are kept.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.pause("openai");
+ * ```
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+export declare function pause(name: string, requestOptions?: ApiRequestOptions): ApiPromise<ConcurrencyLimitItem>;
+/**
+ * Resumes a paused concurrency limit, so runs holding it can be admitted again
+ * under its configured bounds.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.resume("openai");
+ * ```
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+export declare function resume(name: string, requestOptions?: ApiRequestOptions): ApiPromise<ConcurrencyLimitItem>;

package/dist/commonjs/v3/concurrencyLimits.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list = list;
+exports.retrieve = retrieve;
+exports.override = override;
+exports.reset = reset;
+exports.pause = pause;
+exports.resume = resume;
+const v3_1 = require("@trigger.dev/core/v3");
+const tracer_js_1 = require("./tracer.js");
+/**
+ * Lists the environment's named concurrency limits (anonymous inline limits appear
+ * under their derived `task/<taskId>` names).
+ *
+ * @param options - The list options
+ * @param options.page - The page number
+ * @param options.perPage - The number of limits per page
+ * @returns The list of concurrency limits
+ */
+function list(options, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.list()",
+        icon: "queue",
+    }, requestOptions);
+    return apiClient.listConcurrencyLimits(options, $requestOptions);
+}
+/**
+ * Retrieves a concurrency limit by name.
+ *
+ * @example
+ *
+ * ```ts
+ * const limit = await concurrencyLimits.retrieve("openai");
+ * console.log(limit.running, limit.queued, limit.total.current);
+ * ```
+ * @param name - The limit's name, as declared with `concurrencyLimit()`
+ * @returns The concurrency limit
+ */
+function retrieve(name, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.retrieve()",
+        icon: "queue",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)({ name }),
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: name, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.retrieveConcurrencyLimit(name, $requestOptions);
+}
+/**
+ * Overrides a concurrency limit's bounds. Only the given fields change; the
+ * declared values are kept as the base and restored by `reset`. To stop runs
+ * holding a limit, prefer `pause` (it keeps the configured bounds); overriding
+ * `total` to `0` also blocks every run holding the limit.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.override("openai", { total: 50 });
+ * ```
+ * @param name - The limit's name
+ * @param override - The bounds to change (`perKey` and/or `total`)
+ * @returns The updated concurrency limit
+ */
+function override(name, override, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.override()",
+        icon: "queue",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)({ name, override }),
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: name, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.overrideConcurrencyLimit(name, override, $requestOptions);
+}
+/**
+ * Resets a concurrency limit back to its declared values, clearing any override.
+ *
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+function reset(name, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.reset()",
+        icon: "queue",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)({ name }),
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: name, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.resetConcurrencyLimit(name, $requestOptions);
+}
+/**
+ * Pauses a concurrency limit. Nothing holding the limit is admitted until it is
+ * resumed; runs already executing continue. The configured bounds are kept.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.pause("openai");
+ * ```
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+function pause(name, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.pause()",
+        icon: "queue",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)({ name }),
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: name, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.pauseConcurrencyLimit(name, "pause", $requestOptions);
+}
+/**
+ * Resumes a paused concurrency limit, so runs holding it can be admitted again
+ * under its configured bounds.
+ *
+ * @example
+ *
+ * ```ts
+ * await concurrencyLimits.resume("openai");
+ * ```
+ * @param name - The limit's name
+ * @returns The updated concurrency limit
+ */
+function resume(name, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "concurrencyLimits.resume()",
+        icon: "queue",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)({ name }),
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: name, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.pauseConcurrencyLimit(name, "resume", $requestOptions);
+}
+//# sourceMappingURL=concurrencyLimits.js.map

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

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

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

@@ -1,7 +1,7 @@
 export * from "./cache.js";
 export * from "./config.js";
 export { retry, type RetryOptions } from "./retry.js";
-export { queue, BatchTriggerError } from "./shared.js";
+export { queue, concurrencyLimit, BatchTriggerError } from "./shared.js";
 export * from "./tasks.js";
 export * from "./batch.js";
 export * from "./wait.js";
@@ -29,6 +29,7 @@ export * as schedules from "./schedules/index.js";
 export { deployments, type RetrieveCurrentDeploymentResponseBody, type ApiDeploymentListResponseItem, } from "./deployments.js";
 export * as envvars from "./envvars.js";
 export * as queues from "./queues.js";
+export * as concurrencyLimits from "./concurrencyLimits.js";
 export type { ImportEnvironmentVariablesParams } from "./envvars.js";
 export { configure, auth } from "./auth.js";
 export { TriggerClient, type TriggerClientConfig } from "./triggerClient.js";

package/dist/commonjs/v3/index.js

@@ -36,13 +36,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.skills = exports.prompts = exports.TriggerClient = exports.auth = exports.configure = exports.queues = exports.envvars = exports.deployments = exports.schedules = exports.runs = exports.logger = exports.isChatChunkTooLargeError = exports.ChatChunkTooLargeError = exports.CompleteTaskWithOutput = exports.OutOfMemoryError = exports.AbortTaskRunError = exports.UnprocessableEntityError = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.ConflictError = exports.BadRequestError = exports.AuthenticationError = exports.ApiError = exports.BatchTriggerError = exports.queue = exports.retry = void 0;
+exports.skills = exports.prompts = exports.TriggerClient = exports.auth = exports.configure = exports.concurrencyLimits = exports.queues = exports.envvars = exports.deployments = exports.schedules = exports.runs = exports.logger = exports.isChatChunkTooLargeError = exports.ChatChunkTooLargeError = exports.CompleteTaskWithOutput = exports.OutOfMemoryError = exports.AbortTaskRunError = exports.UnprocessableEntityError = exports.RateLimitError = exports.PermissionDeniedError = exports.NotFoundError = exports.InternalServerError = exports.ConflictError = exports.BadRequestError = exports.AuthenticationError = exports.ApiError = exports.BatchTriggerError = exports.concurrencyLimit = exports.queue = exports.retry = void 0;
 __exportStar(require("./cache.js"), exports);
 __exportStar(require("./config.js"), exports);
 var retry_js_1 = require("./retry.js");
 Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_js_1.retry; } });
 var shared_js_1 = require("./shared.js");
 Object.defineProperty(exports, "queue", { enumerable: true, get: function () { return shared_js_1.queue; } });
+Object.defineProperty(exports, "concurrencyLimit", { enumerable: true, get: function () { return shared_js_1.concurrencyLimit; } });
 Object.defineProperty(exports, "BatchTriggerError", { enumerable: true, get: function () { return shared_js_1.BatchTriggerError; } });
 __exportStar(require("./tasks.js"), exports);
 __exportStar(require("./batch.js"), exports);
@@ -84,6 +85,7 @@ var deployments_js_1 = require("./deployments.js");
 Object.defineProperty(exports, "deployments", { enumerable: true, get: function () { return deployments_js_1.deployments; } });
 exports.envvars = __importStar(require("./envvars.js"));
 exports.queues = __importStar(require("./queues.js"));
+exports.concurrencyLimits = __importStar(require("./concurrencyLimits.js"));
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return auth_js_1.configure; } });
 Object.defineProperty(exports, "auth", { enumerable: true, get: function () { return auth_js_1.auth; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAuD;AAA9C,kGAAA,KAAK,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACjC,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,gDAA8B;AAC9B,6CAA2B;AAS3B,2CAiB8B;AAhB5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4GAAA,sBAAsB,OAAA;AACtB,8GAAA,wBAAwB,OAAA;AACxB,4FAAA,MAAM,OAAA;AAIR,qCAUmB;AATjB,+FAAA,IAAI,OAAA;AAUN,QAAY,SAAS,iDAA6B;AAClD,mDAI0B;AAHxB,6GAAA,WAAW,OAAA;AAIb,QAAY,OAAO,yCAAqB;AACxC,QAAY,MAAM,wCAAoB;AAGtC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA;AACxB,uDAA6E;AAApE,iHAAA,aAAa,OAAA;AACtB,QAAY,OAAO,yCAAqB;AACxC,QAAY,MAAM,wCAAoB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAyE;AAAhE,kGAAA,KAAK,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACnD,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,gDAA8B;AAC9B,6CAA2B;AAS3B,2CAiB8B;AAhB5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4GAAA,sBAAsB,OAAA;AACtB,8GAAA,wBAAwB,OAAA;AACxB,4FAAA,MAAM,OAAA;AAIR,qCAUmB;AATjB,+FAAA,IAAI,OAAA;AAUN,QAAY,SAAS,iDAA6B;AAClD,mDAI0B;AAHxB,6GAAA,WAAW,OAAA;AAIb,QAAY,OAAO,yCAAqB;AACxC,QAAY,MAAM,wCAAoB;AACtC,QAAY,iBAAiB,mDAA+B;AAG5D,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA;AACxB,uDAA6E;AAApE,iHAAA,aAAa,OAAA;AACtB,QAAY,OAAO,yCAAqB;AACxC,QAAY,MAAM,wCAAoB"}

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

@@ -0,0 +1,44 @@
+import type { UIMessage, UIMessageChunk } from "ai";
+/** One ordered output channel for a turn's managed model and data chunks. */
+export declare class ManagedChatResponse {
+    private readonly publish;
+    private controller?;
+    private completion?;
+    private failure?;
+    private closed;
+    private chunks;
+    private original?;
+    private fallbackId;
+    private completedSteps;
+    private dataBoundary;
+    private generationOffset;
+    private orderedSteps;
+    private pendingData;
+    constructor(publish: (stream: ReadableStream<UIMessageChunk>) => Promise<unknown>);
+    seed(messages: readonly UIMessage[] | undefined): void;
+    get isClosed(): boolean;
+    get revision(): number;
+    continues(id: string): boolean;
+    beginGeneration(): void;
+    afterStep(completedSteps: number): void;
+    /** Raw pipes own their output ordering and do not feed this capture. */
+    useRawPipe(): void;
+    private flushPendingData;
+    writeData(chunk: UIMessageChunk): void;
+    write(chunk: UIMessageChunk, capture?: boolean): void;
+    pipe(source: AsyncIterable<UIMessageChunk> | ReadableStream<UIMessageChunk>, signal?: AbortSignal): Promise<void>;
+    /** Native reduction of the exact admitted chunks, including same-ID updates. */
+    snapshot(options?: {
+        message: UIMessage;
+        from: number;
+    }): Promise<UIMessage | undefined>;
+    close(): Promise<void>;
+}
+/** Hook streams share a publisher; only persistent data joins managed capture. */
+export declare function createOrderedChatWriter(activeResponse: () => ManagedChatResponse | undefined, publish: (stream: ReadableStream<UIMessageChunk>) => Promise<unknown>): {
+    writer: {
+        write(part: UIMessageChunk): void;
+        merge(stream: ReadableStream<UIMessageChunk>): void;
+    };
+    flush(): Promise<void>;
+};