@trigger.dev/core 4.7.3 → 4.7.5

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

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 import type { ApiClientConfiguration } from "../apiClientManager-api.js";
-import { type AddTagsRequestBody, type ApiDeploymentListOptions, type BatchItemNDJSON, type BatchTriggerTaskV3RequestBody, type CloseSessionRequestBody, type CompleteWaitpointTokenRequestBody, type CreateBatchRequestBody, type CreateEnvironmentVariableRequestBody, type CreateInputStreamWaitpointRequestBody, type CreatePromptOverrideRequestBody, type ListWebhookDeliveriesQuery, type SetWebhookEndpointSecretRequestBody, type CreateScheduleOptions, type CreateSessionRequestBody, type CreateSessionStreamWaitpointRequestBody, type CreateWaitpointTokenRequestBody, type EndAndContinueSessionRequestBody, type ListQueueOptions, type ListConcurrencyLimitOptions, type OverrideConcurrencyLimitRequestBody, type ListScheduleOptions, type ListSessionsOptions, type PromotePromptVersionRequestBody, type ReactivatePromptOverrideRequestBody, type RescheduleRunRequestBody, type ResolvePromptRequestBody, type RetrieveQueueParam, type TriggerTaskRequestBody, type UpdateEnvironmentVariableRequestBody, type UpdateMetadataRequestBody, type UpdatePromptOverrideRequestBody, type UpdateScheduleOptions, type UpdateSessionRequestBody, type WaitForDurationRequestBody, BulkActionObject, BatchTaskRunExecutionResult, CreateBatchResponse, CreateWaitpointTokenResponseBody, ListDashboardsResponseBody, ListRunResponseItem, ListedSessionItem, QueryExecuteResponseBody, QuerySchemaResponseBody, type ReportViewModel, StreamBatchItemsResponse, TaskRunExecutionResult, WaitpointTokenItem } from "../schemas/index.js";
+import { type AddTagsRequestBody, type ApiDeploymentListOptions, type BatchItemNDJSON, type BatchTriggerTaskV3RequestBody, type CloseSessionRequestBody, type CompleteWaitpointTokenRequestBody, type CreateBatchRequestBody, type CreateEnvironmentVariableRequestBody, type CreateInputStreamWaitpointRequestBody, type CreatePromptOverrideRequestBody, type ListWebhookDeliveriesQuery, type SetWebhookEndpointSecretRequestBody, type CreateScheduleOptions, type CreateSessionRequestBody, type CreateSessionStreamWaitpointRequestBody, type CreateWaitpointTokenRequestBody, type EndAndContinueSessionRequestBody, type ListQueueOptions, type ListConcurrencyLimitOptions, type OverrideConcurrencyLimitBoundsBody, type OverrideConcurrencyLimitKeyBody, type ResetConcurrencyLimitRequestBody, type ListScheduleOptions, type ListSessionsOptions, type PromotePromptVersionRequestBody, type ReactivatePromptOverrideRequestBody, ReplayRunRequestBody, type RescheduleRunRequestBody, type ResolvePromptRequestBody, type RetrieveQueueParam, type TriggerTaskRequestBody, type UpdateEnvironmentVariableRequestBody, type UpdateMetadataRequestBody, type UpdatePromptOverrideRequestBody, type UpdateScheduleOptions, type UpdateSessionRequestBody, type WaitForDurationRequestBody, BulkActionObject, BatchTaskRunExecutionResult, CreateBatchResponse, CreateWaitpointTokenResponseBody, ListDashboardsResponseBody, type AddDashboardWidgetRequestBody, type CreateDashboardRequestBody, type ReplaceDashboardRequestBody, type UpdateDashboardRequestBody, type UpdateDashboardWidgetRequestBody, ListRunResponseItem, ListedSessionItem, QueryExecuteResponseBody, QuerySchemaResponseBody, ReplayRunResponse, type ReportViewModel, StreamBatchItemsResponse, TaskRunExecutionResult, WaitpointTokenItem } from "../schemas/index.js";
 import { type ControlEvent } from "../sessionStreams/wireProtocol.js";
 import type { AsyncIterableStream } from "../streams/asyncIterableStream.js";
 import type { AnyRunTypes, TriggerJwtOptions } from "../types/tasks.js";
@@ -310,6 +310,39 @@ export declare class ApiClient {
             rootSpan: import("../schemas/api.js").RetrieveRunTraceSpan;
         };
     }>;
+    /**
+     * Retrieves one page of a root run's trace as flat spans. Omit `after` for the first
+     * page, then pass back `pagination.next` until it's missing. Use `assembleRunTracePages`
+     * to rebuild the tree. Spans are lean: fetch a span's events and properties with
+     * `retrieveSpan`.
+     */
+    retrieveRunTracePage(runId: string, options?: {
+        limit?: number;
+        after?: string;
+    }, requestOptions?: ZodFetchOptions): ApiPromise<{
+        data: {
+            id: string;
+            parentId?: string | undefined;
+            runId: string;
+            message: string;
+            startTime: Date;
+            duration: number;
+            isError: boolean;
+            isPartial: boolean;
+            isCancelled: boolean;
+            level: string;
+            attemptNumber?: number | undefined;
+        }[];
+        attemptFailures: {
+            spanId: string;
+            attemptNumber: number;
+            runId: string;
+        }[];
+        pagination: {
+            next?: string | undefined;
+            truncated?: boolean | undefined;
+        };
+    }>;
     retrieveSpan(runId: string, spanId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         spanId: string;
         parentId: string | null;
@@ -353,9 +386,8 @@ export declare class ApiClient {
     }>;
     listRuns(query?: ListRunsQueryParams, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof ListRunResponseItem>;
     listProjectRuns(projectRef: string, query?: ListProjectRunsQueryParams, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof ListRunResponseItem>;
-    replayRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        id: string;
-    }>;
+    replayRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<ReplayRunResponse>;
+    replayRun(runId: string, body?: ReplayRunRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<ReplayRunResponse>;
     cancelRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
     }>;
@@ -1149,7 +1181,19 @@ export declare class ApiClient {
         queued: number;
         paused: boolean;
     }>;
-    overrideConcurrencyLimit(name: string, override: OverrideConcurrencyLimitRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+    retrieveConcurrencyLimitKey(name: string, concurrencyKey: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        name: string;
+        concurrencyKey: string;
+        perKey: {
+            current: number | null;
+            base: number | null;
+            override: number | null;
+            expiresAt: Date | null;
+        };
+        running: number;
+        paused: boolean;
+    }>;
+    overrideConcurrencyLimit(name: string, override: OverrideConcurrencyLimitBoundsBody, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
         name: string;
         perKey: {
@@ -1168,6 +1212,18 @@ export declare class ApiClient {
         queued: number;
         paused: boolean;
     }>;
+    overrideConcurrencyLimitKey(name: string, override: OverrideConcurrencyLimitKeyBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        name: string;
+        concurrencyKey: string;
+        perKey: {
+            current: number | null;
+            base: number | null;
+            override: number | null;
+            expiresAt: Date | null;
+        };
+        running: number;
+        paused: boolean;
+    }>;
     pauseConcurrencyLimit(name: string, action: "pause" | "resume", requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
         name: string;
@@ -1206,11 +1262,26 @@ export declare class ApiClient {
         queued: number;
         paused: boolean;
     }>;
+    resetConcurrencyLimitKey(name: string, body: ResetConcurrencyLimitRequestBody & {
+        concurrencyKey: string;
+    }, requestOptions?: ZodFetchOptions): ApiPromise<{
+        name: string;
+        concurrencyKey: string;
+        perKey: {
+            current: number | null;
+            base: number | null;
+            override: number | null;
+            expiresAt: Date | null;
+        };
+        running: number;
+        paused: boolean;
+    }>;
     subscribeToRun<TRunTypes extends AnyRunTypes>(runId: string, options?: {
         signal?: AbortSignal;
         closeOnComplete?: boolean;
         onFetchError?: (error: Error) => void;
         skipColumns?: string[];
+        fetchClient?: typeof fetch;
     }): RunSubscription<TRunTypes>;
     subscribeToRunsWithTag<TRunTypes extends AnyRunTypes>(tag: string | string[], filters?: {
         createdAt?: string;
@@ -1218,11 +1289,13 @@ export declare class ApiClient {
     }, options?: {
         signal?: AbortSignal;
         onFetchError?: (error: Error) => void;
+        fetchClient?: typeof fetch;
     }): RunSubscription<TRunTypes>;
     subscribeToBatch<TRunTypes extends AnyRunTypes>(batchId: string, options?: {
         signal?: AbortSignal;
         onFetchError?: (error: Error) => void;
         skipColumns?: string[];
+        fetchClient?: typeof fetch;
     }): RunSubscription<TRunTypes>;
     listDeployments(options?: ApiDeploymentListOptions, requestOptions?: ZodFetchOptions): CursorPagePromise<z.ZodObject<{
         id: z.ZodString;
@@ -1336,6 +1409,357 @@ export declare class ApiClient {
     }, requestOptions?: ZodFetchOptions): Promise<QueryExecuteResponseBody>;
     getQuerySchema(requestOptions?: ZodFetchOptions): Promise<QuerySchemaResponseBody>;
     listDashboards(requestOptions?: ZodFetchOptions): Promise<ListDashboardsResponseBody>;
+    retrieveDashboard(dashboardId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
+    createDashboard(body: CreateDashboardRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
+    updateDashboard(dashboardId: string, body: UpdateDashboardRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
+    replaceDashboard(dashboardId: string, body: ReplaceDashboardRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
+    deleteDashboard(dashboardId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+    }>;
+    addDashboardWidget(dashboardId: string, body: AddDashboardWidgetRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        widgetId: string;
+        dashboard: {
+            id: string;
+            title: string;
+            description: string;
+            revision: string;
+            createdAt: Date;
+            updatedAt: Date;
+            widgets: {
+                id: string;
+                title: string;
+                query: string;
+                display: {
+                    type: "table";
+                    prettyFormatting: boolean;
+                    sorting: {
+                        desc: boolean;
+                        id: string;
+                    }[];
+                } | {
+                    chartType: "bar" | "line";
+                    xAxisColumn: string | null;
+                    yAxisColumns: string[];
+                    groupByColumn: string | null;
+                    stacked: boolean;
+                    sortByColumn: string | null;
+                    sortDirection: "asc" | "desc";
+                    aggregation: "avg" | "count" | "max" | "min" | "sum";
+                    seriesColors?: Record<string, string> | undefined;
+                    type: "chart";
+                } | {
+                    column: string;
+                    aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                    sortDirection?: "asc" | "desc" | undefined;
+                    abbreviate: boolean;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    type: "bignumber";
+                } | {
+                    type: "title";
+                };
+                fillGaps?: boolean | undefined;
+                position: {
+                    x: number;
+                    y: number;
+                    w: number;
+                    h: number;
+                };
+            }[];
+        };
+    }>;
+    updateDashboardWidget(dashboardId: string, widgetId: string, body: UpdateDashboardWidgetRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
+    deleteDashboardWidget(dashboardId: string, widgetId: string, options?: {
+        revision?: string;
+    }, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        title: string;
+        description: string;
+        revision: string;
+        createdAt: Date;
+        updatedAt: Date;
+        widgets: {
+            id: string;
+            title: string;
+            query: string;
+            display: {
+                type: "table";
+                prettyFormatting: boolean;
+                sorting: {
+                    desc: boolean;
+                    id: string;
+                }[];
+            } | {
+                chartType: "bar" | "line";
+                xAxisColumn: string | null;
+                yAxisColumns: string[];
+                groupByColumn: string | null;
+                stacked: boolean;
+                sortByColumn: string | null;
+                sortDirection: "asc" | "desc";
+                aggregation: "avg" | "count" | "max" | "min" | "sum";
+                seriesColors?: Record<string, string> | undefined;
+                type: "chart";
+            } | {
+                column: string;
+                aggregation: "avg" | "count" | "first" | "last" | "max" | "min" | "sum";
+                sortDirection?: "asc" | "desc" | undefined;
+                abbreviate: boolean;
+                prefix?: string | undefined;
+                suffix?: string | undefined;
+                type: "bignumber";
+            } | {
+                type: "title";
+            };
+            fillGaps?: boolean | undefined;
+            position: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+        }[];
+    }>;
     /**
      * `format: "json"` returns a `ReportViewModel`; "markdown" (default) and "ansi" return a rendered
      * string. `period` is a shorthand like "1h" or "7d", capped at 90d. Seconds are not accepted.