@trigger.dev/sdk 0.0.0-prerelease-20241023140846 → 0.0.0-prerelease-20241119135607

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

@@ -1,11 +1,7 @@
-import type { ApiRequestOptions, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody } from "@trigger.dev/core/v3";
+import type { AnyRetrieveRunResult, AnyRunShape, ApiRequestOptions, InferRunTypes, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody, RetrieveRunResult, RunShape, RealtimeRun, RunSubscription, TaskRunShape } from "@trigger.dev/core/v3";
 import { ApiPromise, CanceledRunResponse, CursorPagePromise, ListRunResponseItem, ReplayRunResponse, RetrieveRunResponse } from "@trigger.dev/core/v3";
-import { AnyTask, Prettify, RunHandle, Task } from "./shared.js";
-export type RetrieveRunResult<TRunId> = Prettify<TRunId extends RunHandle<infer TOutput> ? Omit<RetrieveRunResponse, "output"> & {
-    output?: TOutput;
-} : TRunId extends Task<string, any, infer TTaskOutput> ? Omit<RetrieveRunResponse, "output"> & {
-    output?: TTaskOutput;
-} : TRunId extends string ? RetrieveRunResponse : never>;
+import { AnyRunHandle, AnyTask } from "./shared.js";
+export type { AnyRetrieveRunResult, AnyRunShape, RetrieveRunResult, RunShape, TaskRunShape, RealtimeRun, };
 export declare const runs: {
     replay: typeof replayRun;
     cancel: typeof cancelRun;
@@ -13,634 +9,61 @@ export declare const runs: {
     list: typeof listRuns;
     reschedule: typeof rescheduleRun;
     poll: typeof poll;
+    subscribeToRun: typeof subscribeToRun;
+    subscribeToRunsWithTag: typeof subscribeToRunsWithTag;
 };
 export type ListRunsItem = ListRunResponseItem;
 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 RunHandle<any> ? TRunId : TRunId extends AnyTask ? string : TRunId extends string ? TRunId : never;
-declare function retrieveRun<TRunId extends RunHandle<any> | AnyTask | string>(runId: RunId<TRunId>, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResult<TRunId>>;
+type RunId<TRunId> = TRunId extends AnyRunHandle ? TRunId : TRunId extends AnyTask ? string : TRunId extends string ? TRunId : never;
+declare function retrieveRun<TRunId extends AnyRunHandle | AnyTask | string>(runId: RunId<TRunId>, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResult<TRunId>>;
 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 = {
     pollIntervalMs?: number;
 };
-declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: RunId<TRunId>, options?: {
+declare function poll<TRunId extends AnyRunHandle | AnyTask | string>(runId: RunId<TRunId>, options?: {
     pollIntervalMs?: number;
-}, requestOptions?: ApiRequestOptions): Promise<(TRunId extends RunHandle<infer TOutput> ? Omit<{
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
-    isTest: boolean;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
-    relatedRuns: {
-        root?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        parent?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        children?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        }[] | undefined;
-    };
-    attempts: ({
-        id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        completedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-    } | undefined)[];
-    payload?: any;
-    payloadPresignedUrl?: string | undefined;
-    output?: any;
-    outputPresignedUrl?: string | undefined;
-    schedule?: {
-        id: string;
-        generator: {
-            type: "CRON";
-            expression: string;
-            description: string;
-        };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
-    } | undefined;
-    batchId?: string | undefined;
-    idempotencyKey?: string | undefined;
-    version?: string | undefined;
-    startedAt?: Date | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    ttl?: string | undefined;
-    expiredAt?: Date | undefined;
-    metadata?: Record<string, any> | undefined;
-}, "output"> & {
-    output?: TOutput;
-} : TRunId extends Task<string, any, infer TTaskOutput> ? Omit<{
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
-    isTest: boolean;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
-    relatedRuns: {
-        root?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        parent?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        children?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        }[] | undefined;
-    };
-    attempts: ({
-        id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        completedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-    } | undefined)[];
-    payload?: any;
-    payloadPresignedUrl?: string | undefined;
-    output?: any;
-    outputPresignedUrl?: string | undefined;
-    schedule?: {
-        id: string;
-        generator: {
-            type: "CRON";
-            expression: string;
-            description: string;
-        };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
-    } | undefined;
-    batchId?: string | undefined;
-    idempotencyKey?: string | undefined;
-    version?: string | undefined;
-    startedAt?: Date | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    ttl?: string | undefined;
-    expiredAt?: Date | undefined;
-    metadata?: Record<string, any> | undefined;
-}, "output"> & {
-    output?: TTaskOutput;
-} : TRunId extends string ? {
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
-    isTest: boolean;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
-    relatedRuns: {
-        root?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        parent?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        children?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        }[] | undefined;
-    };
-    attempts: ({
-        id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        completedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-    } | undefined)[];
-    payload?: any;
-    payloadPresignedUrl?: string | undefined;
-    output?: any;
-    outputPresignedUrl?: string | undefined;
-    schedule?: {
-        id: string;
-        generator: {
-            type: "CRON";
-            expression: string;
-            description: string;
-        };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
-    } | undefined;
-    batchId?: string | undefined;
-    idempotencyKey?: string | undefined;
-    version?: string | undefined;
-    startedAt?: Date | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    ttl?: string | undefined;
-    expiredAt?: Date | undefined;
-    metadata?: Record<string, any> | undefined;
-} : never) extends infer T ? { [K in keyof T]: (TRunId extends RunHandle<infer TOutput> ? Omit<{
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
-    isTest: boolean;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
-    relatedRuns: {
-        root?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        parent?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        children?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        }[] | undefined;
-    };
-    attempts: ({
-        id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        completedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-    } | undefined)[];
-    payload?: any;
-    payloadPresignedUrl?: string | undefined;
-    output?: any;
-    outputPresignedUrl?: string | undefined;
+}, requestOptions?: ApiRequestOptions): Promise<{
+    tags: string[];
+    version?: string | undefined;
+    error?: {
+        message: string;
+        name?: string | undefined;
+        stackTrace?: string | undefined;
+    } | undefined;
+    status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
+    taskIdentifier: string;
     schedule?: {
         id: string;
         generator: {
+            description: string;
             type: "CRON";
             expression: string;
-            description: string;
         };
         externalId?: string | undefined;
         deduplicationKey?: string | undefined;
     } | undefined;
-    batchId?: string | undefined;
-    idempotencyKey?: string | undefined;
-    version?: string | undefined;
-    startedAt?: Date | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    ttl?: string | undefined;
-    expiredAt?: Date | undefined;
-    metadata?: Record<string, any> | undefined;
-}, "output"> & {
-    output?: TOutput;
-} : TRunId extends Task<string, any, infer TTaskOutput> ? Omit<{
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
     isTest: boolean;
+    id: string;
     createdAt: Date;
     durationMs: number;
     costInCents: number;
     baseCostInCents: number;
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    updatedAt: Date;
     relatedRuns: {
         root?: {
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
             tags: string[];
             isTest: boolean;
             createdAt: Date;
             durationMs: number;
             costInCents: number;
             baseCostInCents: number;
+            taskIdentifier: string;
             depth: number;
             triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
             isQueued: boolean;
             isExecuting: boolean;
             isCompleted: boolean;
@@ -659,17 +82,17 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         } | undefined;
         parent?: {
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
             tags: string[];
             isTest: boolean;
             createdAt: Date;
             durationMs: number;
             costInCents: number;
             baseCostInCents: number;
+            taskIdentifier: string;
             depth: number;
             triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
             isQueued: boolean;
             isExecuting: boolean;
             isCompleted: boolean;
@@ -688,17 +111,17 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         } | undefined;
         children?: {
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
             tags: string[];
             isTest: boolean;
             createdAt: Date;
             durationMs: number;
             costInCents: number;
             baseCostInCents: number;
+            taskIdentifier: string;
             depth: number;
             triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
             isQueued: boolean;
             isExecuting: boolean;
             isCompleted: boolean;
@@ -717,56 +140,8 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         }[] | undefined;
     };
-    attempts: ({
-        id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        createdAt: Date;
-        updatedAt: Date;
-        startedAt?: Date | undefined;
-        completedAt?: Date | undefined;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-    } | undefined)[];
-    payload?: any;
-    payloadPresignedUrl?: string | undefined;
-    output?: any;
-    outputPresignedUrl?: string | undefined;
-    schedule?: {
-        id: string;
-        generator: {
-            type: "CRON";
-            expression: string;
-            description: string;
-        };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
-    } | undefined;
-    batchId?: string | undefined;
-    idempotencyKey?: string | undefined;
-    version?: string | undefined;
-    startedAt?: Date | undefined;
-    finishedAt?: Date | undefined;
-    delayedUntil?: Date | undefined;
-    ttl?: string | undefined;
-    expiredAt?: Date | undefined;
-    metadata?: Record<string, any> | undefined;
-}, "output"> & {
-    output?: TTaskOutput;
-} : TRunId extends string ? {
-    id: string;
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    tags: string[];
-    isTest: boolean;
-    createdAt: Date;
-    durationMs: number;
-    costInCents: number;
-    baseCostInCents: number;
     depth: number;
     triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
     isQueued: boolean;
     isExecuting: boolean;
     isCompleted: boolean;
@@ -774,98 +149,9 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
     isFailed: boolean;
     isCancelled: boolean;
     updatedAt: Date;
-    relatedRuns: {
-        root?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        parent?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        } | undefined;
-        children?: {
-            id: string;
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            tags: string[];
-            isTest: boolean;
-            createdAt: Date;
-            durationMs: number;
-            costInCents: number;
-            baseCostInCents: number;
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            updatedAt: Date;
-            batchId?: string | undefined;
-            idempotencyKey?: string | undefined;
-            version?: string | undefined;
-            startedAt?: Date | undefined;
-            finishedAt?: Date | undefined;
-            delayedUntil?: Date | undefined;
-            ttl?: string | undefined;
-            expiredAt?: Date | undefined;
-            metadata?: Record<string, any> | undefined;
-        }[] | undefined;
-    };
     attempts: ({
+        status: "EXECUTING" | "COMPLETED" | "CANCELED" | "FAILED" | "PENDING" | "PAUSED";
         id: string;
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
         createdAt: Date;
         updatedAt: Date;
         startedAt?: Date | undefined;
@@ -876,28 +162,19 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             stackTrace?: string | undefined;
         } | undefined;
     } | undefined)[];
-    payload?: any;
+    attemptCount: number;
     payloadPresignedUrl?: string | undefined;
-    output?: any;
     outputPresignedUrl?: string | undefined;
-    schedule?: {
-        id: string;
-        generator: {
-            type: "CRON";
-            expression: string;
-            description: string;
-        };
-        externalId?: string | undefined;
-        deduplicationKey?: string | undefined;
-    } | undefined;
     batchId?: string | undefined;
     idempotencyKey?: string | undefined;
-    version?: string | undefined;
     startedAt?: Date | undefined;
     finishedAt?: Date | undefined;
     delayedUntil?: Date | undefined;
     ttl?: string | undefined;
     expiredAt?: Date | undefined;
     metadata?: Record<string, any> | undefined;
-} : never)[K]; } : never>;
-export {};
+    output?: InferRunTypes<TRunId>["output"] | undefined;
+    payload?: InferRunTypes<TRunId>["payload"] | undefined;
+}>;
+declare function subscribeToRun<TRunId extends AnyRunHandle | AnyTask | string>(runId: RunId<TRunId>): RunSubscription<InferRunTypes<TRunId>>;
+declare function subscribeToRunsWithTag<TTasks extends AnyTask>(tag: string | string[]): RunSubscription<InferRunTypes<TTasks>>;