@trigger.dev/sdk 0.0.0-prerelease-20241003205750 → 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,641 +9,68 @@ 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<{
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    id: string;
-    createdAt: Date;
-    tags: string[];
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    isTest: boolean;
-    updatedAt: Date;
-    costInCents: number;
-    baseCostInCents: number;
-    durationMs: number;
-    relatedRuns: {
-        root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        id: string;
-        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<{
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    id: string;
-    createdAt: Date;
-    tags: string[];
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    isTest: boolean;
-    updatedAt: Date;
-    costInCents: number;
-    baseCostInCents: number;
-    durationMs: number;
-    relatedRuns: {
-        root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        id: string;
-        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 ? {
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    id: string;
-    createdAt: Date;
-    tags: string[];
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    isTest: boolean;
-    updatedAt: Date;
-    costInCents: number;
-    baseCostInCents: number;
-    durationMs: number;
-    relatedRuns: {
-        root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        id: string;
-        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<{
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    id: string;
-    createdAt: Date;
-    tags: string[];
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    isTest: boolean;
-    updatedAt: Date;
-    costInCents: number;
-    baseCostInCents: number;
-    durationMs: number;
-    relatedRuns: {
-        root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        id: string;
-        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<{
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
+    isTest: boolean;
     id: string;
     createdAt: Date;
-    tags: string[];
-    depth: number;
-    triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
-    isQueued: boolean;
-    isExecuting: boolean;
-    isCompleted: boolean;
-    isSuccess: boolean;
-    isFailed: boolean;
-    isCancelled: boolean;
-    isTest: boolean;
-    updatedAt: Date;
+    durationMs: number;
     costInCents: number;
     baseCostInCents: number;
-    durationMs: number;
     relatedRuns: {
         root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            createdAt: Date;
             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;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
-            isTest: boolean;
             updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
             batchId?: string | undefined;
             idempotencyKey?: string | undefined;
             version?: string | undefined;
@@ -659,24 +82,24 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         } | undefined;
         parent?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            createdAt: Date;
             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;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
-            isTest: boolean;
             updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
             batchId?: string | undefined;
             idempotencyKey?: string | undefined;
             version?: string | undefined;
@@ -688,24 +111,24 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         } | undefined;
         children?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
+            status: "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
             id: string;
-            createdAt: Date;
             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;
             isSuccess: boolean;
             isFailed: boolean;
             isCancelled: boolean;
-            isTest: boolean;
             updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
             batchId?: string | undefined;
             idempotencyKey?: string | undefined;
             version?: string | undefined;
@@ -717,154 +140,17 @@ declare function poll<TRunId extends RunHandle<any> | AnyTask | string>(runId: R
             metadata?: Record<string, any> | undefined;
         }[] | undefined;
     };
-    attempts: ({
-        status: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
-        id: string;
-        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 ? {
-    status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-    id: string;
-    createdAt: Date;
-    tags: string[];
     depth: number;
     triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-    taskIdentifier: string;
     isQueued: boolean;
     isExecuting: boolean;
     isCompleted: boolean;
     isSuccess: boolean;
     isFailed: boolean;
     isCancelled: boolean;
-    isTest: boolean;
     updatedAt: Date;
-    costInCents: number;
-    baseCostInCents: number;
-    durationMs: number;
-    relatedRuns: {
-        root?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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?: {
-            status: "CANCELED" | "COMPLETED" | "FAILED" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "QUEUED" | "EXECUTING" | "REATTEMPTING" | "FROZEN" | "CRASHED" | "INTERRUPTED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED";
-            id: string;
-            createdAt: Date;
-            tags: string[];
-            depth: number;
-            triggerFunction: "triggerAndWait" | "trigger" | "batchTriggerAndWait" | "batchTrigger";
-            taskIdentifier: string;
-            isQueued: boolean;
-            isExecuting: boolean;
-            isCompleted: boolean;
-            isSuccess: boolean;
-            isFailed: boolean;
-            isCancelled: boolean;
-            isTest: boolean;
-            updatedAt: Date;
-            costInCents: number;
-            baseCostInCents: number;
-            durationMs: number;
-            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: "PENDING" | "CANCELED" | "COMPLETED" | "FAILED" | "EXECUTING" | "PAUSED";
+        status: "EXECUTING" | "COMPLETED" | "CANCELED" | "FAILED" | "PENDING" | "PAUSED";
         id: string;
         createdAt: Date;
         updatedAt: Date;
@@ -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>>;