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

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

@@ -1,6 +1,5 @@
-import type { AnyRetrieveRunResult, AnyRunShape, ApiRequestOptions, InferRunTypes, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody, RetrieveRunResult, RunShape, RealtimeRun, AnyRealtimeRun, RunSubscription, TaskRunShape, AnyBatchedRunHandle, AsyncIterableStream, ApiPromise } from "@trigger.dev/core/v3";
-import { CanceledRunResponse, CursorPagePromise, ListRunResponseItem, ReplayRunResponse, RetrieveRunResponse } from "@trigger.dev/core/v3";
-import { AnyRunHandle, AnyTask } from "./shared.js";
+import type { AnyRetrieveRunResult, AnyRunShape, ApiRequestOptions, CreateBulkCancelActionOptions, CreateBulkReplayActionOptions, InferRunTypes, ListBulkActionsQueryParams, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody, RetrieveRunResult, RunShape, RealtimeRun, AnyRealtimeRun, RunSubscription, TaskRunShape, AnyBatchedRunHandle, AsyncIterableStream, ApiPromise, RealtimeRunSkipColumns, AbortBulkActionResponseBody, BulkActionObject, CanceledRunResponse, CreateBulkActionResponseBody, CursorPagePromise, IdempotencyKey, ListRunResponseItem, ReplayRunResponse, RetrieveRunResponse, TriggerOptions } from "@trigger.dev/core/v3";
+import type { AnyRunHandle, AnyTask } from "./shared.js";
 export type { AnyRetrieveRunResult, AnyRunShape, RetrieveRunResult, RunShape, TaskRunShape, RealtimeRun, AnyRealtimeRun, };
 export declare const runs: {
     replay: typeof replayRun;
@@ -8,177 +7,215 @@ export declare const runs: {
     retrieve: typeof retrieveRun;
     list: typeof listRuns;
     reschedule: typeof rescheduleRun;
+    bulk: {
+        cancel: typeof bulkCancelRuns;
+        replay: typeof bulkReplayRuns;
+        retrieve: typeof retrieveBulkAction;
+        abort: typeof abortBulkAction;
+        list: typeof listBulkActions;
+        poll: typeof pollBulkAction;
+    };
     poll: typeof poll;
     subscribeToRun: typeof subscribeToRun;
     subscribeToRunsWithTag: typeof subscribeToRunsWithTag;
     subscribeToBatch: typeof subscribeToRunsInBatch;
     fetchStream: typeof fetchStream;
 };
-export type ListRunsItem = ListRunResponseItem;
+export type BulkAction = BulkActionObject;
 declare function listRuns(projectRef: string, params?: ListProjectRunsQueryParams, requestOptions?: ApiRequestOptions): CursorPagePromise<typeof ListRunResponseItem>;
 declare function listRuns(params?: ListRunsQueryParams, requestOptions?: ApiRequestOptions): CursorPagePromise<typeof ListRunResponseItem>;
 type RunId<TRunId> = TRunId extends AnyRunHandle | AnyBatchedRunHandle ? TRunId : TRunId extends AnyTask ? string : TRunId extends string ? TRunId : never;
 declare function retrieveRun<TRunId extends AnyRunHandle | AnyBatchedRunHandle | AnyTask | string>(runId: RunId<TRunId>, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResult<TRunId>>;
+export type ReplayRunOptions = Pick<TriggerOptions, "metadata" | "tags" | "queue" | "concurrencyKey" | "machine" | "version" | "region" | "delay" | "ttl" | "idempotencyKeyTTL" | "maxAttempts" | "maxDuration" | "priority"> & {
+    /**
+     * The payload for the new run. Omit it to reuse the original run's payload.
+     */
+    payload?: unknown;
+    /**
+     * An idempotency key for the new run. A plain string is used as-is: unlike `trigger()`, it is
+     * not scoped to the current run. Use `idempotencyKeys.create()` for a scoped key.
+     */
+    idempotencyKey?: IdempotencyKey | string;
+};
+/**
+ * Replays a run: creates a new run of the same task from the original run's payload and options.
+ * Pass `options` to override any of them for the new run.
+ *
+ * @example
+ * ```ts
+ * const { id } = await runs.replay("run_1234", { payload: { userId: "123" }, delay: "1h" });
+ * ```
+ */
+declare function replayRun(runId: string, options?: ReplayRunOptions, requestOptions?: ApiRequestOptions): ApiPromise<ReplayRunResponse>;
 declare function replayRun(runId: string, requestOptions?: ApiRequestOptions): ApiPromise<ReplayRunResponse>;
 declare function cancelRun(runId: string, requestOptions?: ApiRequestOptions): ApiPromise<CanceledRunResponse>;
-declare function rescheduleRun(runId: string, body: RescheduleRunRequestBody, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResponse>;
-export type PollOptions = {
+declare function bulkCancelRuns(options: CreateBulkCancelActionOptions, requestOptions?: ApiRequestOptions): ApiPromise<CreateBulkActionResponseBody>;
+declare function bulkReplayRuns(options: CreateBulkReplayActionOptions, requestOptions?: ApiRequestOptions): ApiPromise<CreateBulkActionResponseBody>;
+declare function retrieveBulkAction(bulkActionId: string, requestOptions?: ApiRequestOptions): ApiPromise<BulkActionObject>;
+declare function abortBulkAction(bulkActionId: string, requestOptions?: ApiRequestOptions): ApiPromise<AbortBulkActionResponseBody>;
+declare function listBulkActions(params?: ListBulkActionsQueryParams, requestOptions?: ApiRequestOptions): CursorPagePromise<typeof BulkActionObject>;
+declare function pollBulkAction(bulkActionId: string, options?: {
     pollIntervalMs?: number;
-};
+}, requestOptions?: ApiRequestOptions): Promise<BulkActionObject>;
+declare function rescheduleRun(runId: string, body: RescheduleRunRequestBody, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResponse>;
 declare function poll<TRunId extends AnyRunHandle | AnyTask | string>(runId: RunId<TRunId>, options?: {
     pollIntervalMs?: number;
 }, requestOptions?: ApiRequestOptions): Promise<{
-    tags: string[];
-    version?: string | undefined;
-    status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
+    id: string;
+    status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
     taskIdentifier: string;
+    idempotencyKey?: string | undefined;
+    version?: string | undefined;
+    isQueued: boolean;
+    isExecuting: boolean;
+    isWaiting: boolean;
+    isCompleted: boolean;
+    isSuccess: boolean;
+    isFailed: boolean;
+    isCancelled: boolean;
+    isTest: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    startedAt?: Date | undefined;
+    finishedAt?: Date | undefined;
+    delayedUntil?: Date | undefined;
+    ttl?: string | undefined;
+    expiredAt?: Date | undefined;
+    tags: string[];
+    costInCents: number;
+    baseCostInCents: number;
+    durationMs: number;
+    metadata?: Record<string, any> | undefined;
+    taskKind?: string | undefined;
+    region?: string | undefined;
+    depth: number;
+    triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+    batchId?: string | undefined;
+    payloadPresignedUrl?: string | undefined;
+    outputPresignedUrl?: string | undefined;
+    error?: {
+        message: string;
+        name?: string | undefined;
+        stackTrace?: string | undefined;
+        causes?: {
+            name?: string | undefined;
+            message: string;
+            stackTrace?: string | undefined;
+        }[] | undefined;
+    } | undefined;
     schedule?: {
         id: string;
+        externalId?: string | undefined;
+        deduplicationKey?: string | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
     } | undefined;
-    isTest: boolean;
-    id: string;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
-    attemptCount: number;
     relatedRuns: {
         root?: {
-            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
+            status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
             taskIdentifier: string;
-            depth: number;
-            triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+            idempotencyKey?: string | undefined;
+            version?: string | undefined;
             isQueued: boolean;
             isExecuting: boolean;
+            isWaiting: boolean;
             isCompleted: boolean;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
+            isTest: boolean;
+            createdAt: Date;
             updatedAt: Date;
             startedAt?: Date | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            metadata?: Record<string, any> | undefined;
-            ttl?: string | undefined;
-            batchId?: string | undefined;
             finishedAt?: Date | undefined;
             delayedUntil?: Date | undefined;
+            ttl?: string | undefined;
             expiredAt?: Date | undefined;
-        } | undefined;
-        parent?: {
-            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-            id: string;
             tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
             costInCents: number;
             baseCostInCents: number;
-            taskIdentifier: string;
+            durationMs: number;
+            metadata?: Record<string, any> | undefined;
+            taskKind?: string | undefined;
+            region?: string | undefined;
             depth: number;
-            triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+            triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+            batchId?: string | undefined;
+        } | undefined;
+        parent?: {
+            id: string;
+            status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+            taskIdentifier: string;
+            idempotencyKey?: string | undefined;
+            version?: string | undefined;
             isQueued: boolean;
             isExecuting: boolean;
+            isWaiting: boolean;
             isCompleted: boolean;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
+            isTest: boolean;
+            createdAt: Date;
             updatedAt: Date;
             startedAt?: Date | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            metadata?: Record<string, any> | undefined;
-            ttl?: string | undefined;
-            batchId?: string | undefined;
             finishedAt?: Date | undefined;
             delayedUntil?: Date | undefined;
+            ttl?: string | undefined;
             expiredAt?: Date | undefined;
-        } | undefined;
-        children?: {
-            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-            id: string;
             tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
             costInCents: number;
             baseCostInCents: number;
-            taskIdentifier: string;
+            durationMs: number;
+            metadata?: Record<string, any> | undefined;
+            taskKind?: string | undefined;
+            region?: string | undefined;
             depth: number;
-            triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+            triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+            batchId?: string | undefined;
+        } | undefined;
+        children?: {
+            id: string;
+            status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+            taskIdentifier: string;
+            idempotencyKey?: string | undefined;
+            version?: string | undefined;
             isQueued: boolean;
             isExecuting: boolean;
+            isWaiting: boolean;
             isCompleted: boolean;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
+            isTest: boolean;
+            createdAt: Date;
             updatedAt: Date;
             startedAt?: Date | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            metadata?: Record<string, any> | undefined;
-            ttl?: string | undefined;
-            batchId?: string | undefined;
             finishedAt?: Date | undefined;
             delayedUntil?: Date | undefined;
+            ttl?: string | undefined;
             expiredAt?: Date | undefined;
+            tags: string[];
+            costInCents: number;
+            baseCostInCents: number;
+            durationMs: number;
+            metadata?: Record<string, any> | undefined;
+            taskKind?: string | undefined;
+            region?: string | undefined;
+            depth: number;
+            triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+            batchId?: string | undefined;
         }[] | undefined;
     };
-    depth: number;
-    triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
-    attempts: ({
-        status: "EXECUTING" | "COMPLETED" | "CANCELED" | "FAILED" | "PENDING" | "PAUSED";
-        id: string;
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-        completedAt?: Date | undefined;
-    } | undefined)[];
-    startedAt?: Date | undefined;
-    idempotencyKey?: string | undefined;
-    metadata?: Record<string, any> | undefined;
-    error?: {
-        message: string;
-        name?: string | undefined;
-        stackTrace?: string | undefined;
-    } | undefined;
-    ttl?: string | undefined;
-    payloadPresignedUrl?: string | undefined;
-    outputPresignedUrl?: string | undefined;
-    batchId?: string | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    expiredAt?: Date | undefined;
+    attemptCount: number;
     output?: InferRunTypes<TRunId>["output"] | undefined;
     payload?: InferRunTypes<TRunId>["payload"] | undefined;
 }>;
-export type SubscribeToRunOptions = {
+type SubscribeToRunOptions = {
     /**
      * Whether to close the subscription when the run completes
      *
@@ -187,6 +224,24 @@ export type SubscribeToRunOptions = {
      * Set this to false if you are making updates to the run metadata after completion through child runs
      */
     stopOnCompletion?: boolean;
+    /**
+     * Skip columns from the subscription.
+     *
+     * @default []
+     *
+     * @example
+     * ```ts
+     * runs.subscribeToRun("123", { skipColumns: ["payload", "output"] });
+     * ```
+     */
+    skipColumns?: RealtimeRunSkipColumns;
+    /**
+     * An AbortSignal to cancel the subscription.
+     *
+     * When the signal is aborted, the underlying SSE connection is closed
+     * and the async iterator completes.
+     */
+    signal?: AbortSignal;
 };
 /**
  * Subscribes to real-time updates for a specific run.
@@ -220,6 +275,30 @@ export type SubscribeToRunOptions = {
  * ```
  */
 declare function subscribeToRun<TRunId extends AnyRunHandle | AnyTask | string>(runId: RunId<TRunId>, options?: SubscribeToRunOptions): RunSubscription<InferRunTypes<TRunId>>;
+type SubscribeToRunsFilterOptions = {
+    /**
+     * Filter runs by the time they were created. You must specify the duration string like "1h", "10s", "30m", etc.
+     *
+     * @example
+     * "1h" - 1 hour ago
+     * "10s" - 10 seconds ago
+     * "30m" - 30 minutes ago
+     * "1d" - 1 day ago
+     * "1w" - 1 week ago
+     *
+     * The maximum duration is 1 week
+     *
+     * @note The timestamp will be calculated on the server side when you first subscribe to the runs.
+     *
+     */
+    createdAt?: string;
+    /**
+     * Skip columns from the subscription.
+     *
+     * @default []
+     */
+    skipColumns?: RealtimeRunSkipColumns;
+};
 /**
  * Subscribes to real-time updates for all runs that have specific tags.
  *
@@ -250,7 +329,9 @@ declare function subscribeToRun<TRunId extends AnyRunHandle | AnyTask | string>(
  * }
  * ```
  */
-declare function subscribeToRunsWithTag<TTasks extends AnyTask>(tag: string | string[]): RunSubscription<InferRunTypes<TTasks>>;
+declare function subscribeToRunsWithTag<TTasks extends AnyTask>(tag: string | string[], filters?: SubscribeToRunsFilterOptions, options?: {
+    signal?: AbortSignal;
+}): RunSubscription<InferRunTypes<TTasks>>;
 /**
  * Subscribes to real-time updates for all runs within a specific batch.
  *

package/dist/commonjs/v3/runs.js

@@ -10,6 +10,14 @@ exports.runs = {
     retrieve: retrieveRun,
     list: listRuns,
     reschedule: rescheduleRun,
+    bulk: {
+        cancel: bulkCancelRuns,
+        replay: bulkReplayRuns,
+        retrieve: retrieveBulkAction,
+        abort: abortBulkAction,
+        list: listBulkActions,
+        poll: pollBulkAction,
+    },
     poll,
     subscribeToRun,
     subscribeToRunsWithTag,
@@ -121,8 +129,11 @@ async function resolvePayloadAndOutputUrls(run) {
     }
     return resolvedRun;
 }
-function replayRun(runId, requestOptions) {
+function replayRun(runId, optionsOrRequestOptions, requestOptions) {
     const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const options = (0, v3_1.isRequestOptions)(optionsOrRequestOptions)
+        ? undefined
+        : optionsOrRequestOptions;
     const $requestOptions = (0, v3_1.mergeRequestOptions)({
         tracer: tracer_js_1.tracer,
         name: "runs.replay()",
@@ -139,8 +150,8 @@ function replayRun(runId, requestOptions) {
                 style: "codepath",
             }),
         },
-    }, requestOptions);
-    return apiClient.replayRun(runId, $requestOptions);
+    }, (0, v3_1.isRequestOptions)(optionsOrRequestOptions) ? optionsOrRequestOptions : requestOptions);
+    return apiClient.replayRun(runId, options, $requestOptions);
 }
 function cancelRun(runId, requestOptions) {
     const apiClient = v3_1.apiClientManager.clientOrThrow();
@@ -163,6 +174,85 @@ function cancelRun(runId, requestOptions) {
     }, requestOptions);
     return apiClient.cancelRun(runId, $requestOptions);
 }
+function bulkCancelRuns(options, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "runs.bulk.cancel()",
+        icon: "runs",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)(options, "bulkAction"),
+        },
+    }, requestOptions);
+    return apiClient.createBulkAction({ ...options, action: "cancel" }, $requestOptions);
+}
+function bulkReplayRuns(options, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "runs.bulk.replay()",
+        icon: "runs",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)(options, "bulkAction"),
+        },
+    }, requestOptions);
+    return apiClient.createBulkAction({ ...options, action: "replay" }, $requestOptions);
+}
+function retrieveBulkAction(bulkActionId, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "runs.bulk.retrieve()",
+        icon: "runs",
+        attributes: {
+            bulkActionId,
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: bulkActionId, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.retrieveBulkAction(bulkActionId, $requestOptions);
+}
+function abortBulkAction(bulkActionId, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "runs.bulk.abort()",
+        icon: "runs",
+        attributes: {
+            bulkActionId,
+            ...(0, v3_1.accessoryAttributes)({
+                items: [{ text: bulkActionId, variant: "normal" }],
+                style: "codepath",
+            }),
+        },
+    }, requestOptions);
+    return apiClient.abortBulkAction(bulkActionId, $requestOptions);
+}
+function listBulkActions(params, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "runs.bulk.list()",
+        icon: "runs",
+        attributes: {
+            ...(0, v3_1.flattenAttributes)(params, "queryParams"),
+        },
+    }, requestOptions);
+    return apiClient.listBulkActions(params, $requestOptions);
+}
+async function pollBulkAction(bulkActionId, options, requestOptions) {
+    let attempts = 0;
+    while (attempts++ < MAX_POLL_ATTEMPTS) {
+        const bulkAction = await retrieveBulkAction(bulkActionId, requestOptions);
+        if (bulkAction.status !== "PENDING") {
+            return bulkAction;
+        }
+        await new Promise((resolve) => setTimeout(resolve, options?.pollIntervalMs ?? 1000));
+    }
+    throw new Error(`Bulk action ${bulkActionId} did not finish after ${MAX_POLL_ATTEMPTS} attempts`);
+}
 function rescheduleRun(runId, body, requestOptions) {
     const apiClient = v3_1.apiClientManager.clientOrThrow();
     const $requestOptions = (0, v3_1.mergeRequestOptions)({
@@ -232,6 +322,8 @@ function subscribeToRun(runId, options) {
     const apiClient = v3_1.apiClientManager.clientOrThrow();
     return apiClient.subscribeToRun($runId, {
         closeOnComplete: typeof options?.stopOnCompletion === "boolean" ? options.stopOnCompletion : true,
+        skipColumns: options?.skipColumns,
+        signal: options?.signal,
     });
 }
 /**
@@ -264,9 +356,11 @@ function subscribeToRun(runId, options) {
  * }
  * ```
  */
-function subscribeToRunsWithTag(tag) {
+function subscribeToRunsWithTag(tag, filters, options) {
     const apiClient = v3_1.apiClientManager.clientOrThrow();
-    return apiClient.subscribeToRunsWithTag(tag);
+    return apiClient.subscribeToRunsWithTag(tag, filters, {
+        ...(options ? { signal: options.signal } : {}),
+    });
 }
 /**
  * Subscribes to real-time updates for all runs within a specific batch.

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

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

package/dist/commonjs/v3/schedules/api.d.ts

@@ -1 +1,8 @@
-export type { CreateScheduleOptions, ScheduledTaskPayload, ListScheduleOptions, UpdateScheduleOptions, } from "@trigger.dev/core/v3";
+import type { CreateScheduleOptions as CoreCreateScheduleOptions, ListScheduleOptions, ScheduledTaskPayload, UpdateScheduleOptions as CoreUpdateScheduleOptions, ValidatedScheduleWindow } from "@trigger.dev/core/v3";
+export type { ListScheduleOptions, ScheduledTaskPayload };
+export type CreateScheduleOptions<Window extends string | undefined = string | undefined> = Omit<CoreCreateScheduleOptions, "window"> & {
+    window?: ValidatedScheduleWindow<Window>;
+};
+export type UpdateScheduleOptions<Window extends string | undefined = string | undefined> = Omit<CoreUpdateScheduleOptions, "window"> & {
+    window?: ValidatedScheduleWindow<Window>;
+};

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

@@ -1,7 +1,7 @@
-import { ApiPromise, ApiRequestOptions, DeletedScheduleObject, InitOutput, OffsetLimitPagePromise, ScheduleObject } from "@trigger.dev/core/v3";
-import { Task, TaskOptions } from "../shared.js";
-import * as SchedulesAPI from "./api.js";
-export type ScheduleOptions<TIdentifier extends string, TOutput, TInitOutput extends InitOutput> = TaskOptions<TIdentifier, SchedulesAPI.ScheduledTaskPayload, TOutput, TInitOutput> & {
+import type { ApiPromise, ApiRequestOptions, DeletedScheduleObject, InitOutput, OffsetLimitPagePromise, ScheduleObject, ValidatedScheduleWindow } from "@trigger.dev/core/v3";
+import type { Task, TaskOptions } from "../shared.js";
+import type * as SchedulesAPI from "./api.js";
+export type ScheduleOptions<TIdentifier extends string, TOutput, TInitOutput extends InitOutput, TWindow extends string | undefined = string | undefined> = TaskOptions<TIdentifier, SchedulesAPI.ScheduledTaskPayload, TOutput, TInitOutput> & {
     /** You can optionally specify a CRON schedule on your task. You can also dynamically add a schedule in the dashboard or using the SDK functions.
      *
      * 1. Pass a CRON pattern string
@@ -9,11 +9,13 @@ export type ScheduleOptions<TIdentifier extends string, TOutput, TInitOutput ext
      * "0 0 * * *"
      * ```
      *
-     * 2. Or an object with a pattern and an optional timezone (default is "UTC")
+     * 2. Or an object with a pattern, optional timezone, window, and environments
      * ```ts
      * {
      *   pattern: "0 0 * * *",
-     *   timezone: "America/Los_Angeles"
+     *   timezone: "America/Los_Angeles",
+     *   window: "30m",
+     *   environments: ["PRODUCTION", "STAGING"]
      * }
      * ```
      *
@@ -22,9 +24,27 @@ export type ScheduleOptions<TIdentifier extends string, TOutput, TInitOutput ext
     cron?: string | {
         pattern: string;
         timezone?: string;
+        /** Optionally assign each run a stable time after its CRON time.
+         * Use a whole duration such as `"30m"` or `"2h"`, or a percentage such as `"30%"`.
+         */
+        window?: ValidatedScheduleWindow<TWindow>;
+        /** You can optionally specify which environments this schedule should run in.
+         * When not specified, the schedule will run in all environments.
+         *
+         * @example
+         * ```ts
+         * environments: ["PRODUCTION", "STAGING"]
+         * ```
+         *
+         * @example
+         * ```ts
+         * environments: ["PRODUCTION"] // Only run in production
+         * ```
+         */
+        environments?: Array<"DEVELOPMENT" | "STAGING" | "PRODUCTION" | "PREVIEW">;
     };
 };
-export declare function task<TIdentifier extends string, TOutput, TInitOutput extends InitOutput>(params: ScheduleOptions<TIdentifier, TOutput, TInitOutput>): Task<TIdentifier, SchedulesAPI.ScheduledTaskPayload, TOutput>;
+export declare function task<TIdentifier extends string, TOutput, TInitOutput extends InitOutput, const TWindow extends string | undefined = undefined>(params: ScheduleOptions<TIdentifier, TOutput, TInitOutput, TWindow>): Task<TIdentifier, SchedulesAPI.ScheduledTaskPayload, TOutput>;
 /**
  * Creates a new schedule
  * @param options
@@ -35,7 +55,7 @@ export declare function task<TIdentifier extends string, TOutput, TInitOutput ex
  * @param options.deduplicationKey - An optional deduplication key for the schedule
  * @returns The created schedule
  */
-export declare function create(options: SchedulesAPI.CreateScheduleOptions, requestOptions?: ApiRequestOptions): ApiPromise<ScheduleObject>;
+export declare function create<const TWindow extends string | undefined = undefined>(options: SchedulesAPI.CreateScheduleOptions<TWindow>, requestOptions?: ApiRequestOptions): ApiPromise<ScheduleObject>;
 /**
  * Retrieves a schedule
  * @param scheduleId - The ID of the schedule to retrieve
@@ -52,7 +72,7 @@ export declare function retrieve(scheduleId: string, requestOptions?: ApiRequest
  * @param options.externalId - An optional external identifier for the schedule
  * @returns The updated schedule
  */
-export declare function update(scheduleId: string, options: SchedulesAPI.UpdateScheduleOptions, requestOptions?: ApiRequestOptions): ApiPromise<ScheduleObject>;
+export declare function update<const TWindow extends string | undefined = undefined>(scheduleId: string, options: SchedulesAPI.UpdateScheduleOptions<TWindow>, requestOptions?: ApiRequestOptions): ApiPromise<ScheduleObject>;
 /**
  * Deletes a schedule
  * @param scheduleId - The ID of the schedule to delete