@trigger.dev/sdk 0.0.0-dev-20231004120419 → 0.0.0-invoke-trigger-20231103104037

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as _trigger_dev_core from '@trigger.dev/core';
-import { RunTaskBodyInput, CompleteTaskBodyInput, FailTaskBodyInput, SendEvent, SendEventOptions, StatusUpdate, UpdateTriggerSourceBodyV2, TriggerSource, RegisterTriggerBodyV2, RegisterSourceEventV2, ScheduleMetadata, GetRunOptionsWithTaskDetails, GetRunsOptions, LogLevel, RuntimeEnvironmentType, DisplayProperty, TriggerMetadata, EventFilter, Prettify, HandleTriggerSource, Logger, RegisterTriggerSource, SerializableJson, ConnectionAuth, NormalizedResponse, HttpSourceResponseMetadata, IntervalOptions, CronOptions, ScheduledPayload, DeserializedJson, ServerTask, CachedTask, InitialStatusUpdate, FetchRequestInit, FetchRetryOptions, RunTaskOptions, IntegrationMetadata, QueueOptions, IntegrationConfig, JobMetadata, MissingConnectionNotificationPayload, MissingConnectionResolvedNotificationPayload, ErrorWithStack, ApiEventLog, RedactString } from '@trigger.dev/core';
+import { RunTaskBodyInput, CompleteTaskBodyV2Input, FailTaskBodyInput, SendEvent, SendEventOptions, StatusUpdate, UpdateTriggerSourceBodyV2, TriggerSource, RegisterTriggerBodyV2, RegisterSourceEventV2, ScheduleMetadata, GetRunOptionsWithTaskDetails, GetRunsOptions, InvokeOptions, LogLevel, RuntimeEnvironmentType, DisplayProperty, TriggerMetadata, EventFilter, Prettify, HandleTriggerSource, Logger, RegisterTriggerSource, SerializableJson, ConnectionAuth, NormalizedResponse, HttpSourceResponseMetadata, IntervalOptions, CronOptions, ScheduledPayload, DeserializedJson, ServerTask, CachedTask, InitialStatusUpdate, FetchRequestInit, FetchRetryOptions, FetchTimeoutOptions, RunTaskOptions, IntegrationMetadata, QueueOptions, IntegrationConfig, JobMetadata, RunNotification, MissingConnectionNotificationPayload, MissingConnectionResolvedNotificationPayload, ErrorWithStack, ApiEventLog, RedactString } from '@trigger.dev/core';
 export { ConnectionAuth, DisplayProperty, EventFilter, Logger, NormalizedRequest, OverridableRunTaskOptions, Prettify, RedactString, RegisteredOptionsDiff, RunTaskOptions, SourceEventOption } from '@trigger.dev/core';
 import * as zod from 'zod';
-import { z } from 'zod';
+import { z, ZodType, TypeOf } from 'zod';
 
 type ApiClientOptions = {
     apiKey?: string;
@@ -77,8 +77,10 @@ declare class ApiClient {
                 }>>>;
                 operation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
                 callbackUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                childExecutionMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["SEQUENTIAL", "PARALLEL"]>>>;
                 idempotencyKey: z.ZodString;
                 attempts: z.ZodNumber;
+                forceYield: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
             }, "strip", z.ZodTypeAny, {
                 id: string;
                 name: string;
@@ -111,6 +113,8 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+                forceYield?: boolean | null | undefined;
             }, {
                 id: string;
                 name: string;
@@ -143,6 +147,8 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+                forceYield?: boolean | null | undefined;
             }>;
             cachedTasks: z.ZodOptional<z.ZodObject<{
                 tasks: z.ZodArray<z.ZodObject<{
@@ -222,6 +228,8 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+                forceYield?: boolean | null | undefined;
             };
             cachedTasks?: {
                 tasks: {
@@ -267,6 +275,8 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+                forceYield?: boolean | null | undefined;
             };
             cachedTasks?: {
                 tasks: {
@@ -332,8 +342,10 @@ declare class ApiClient {
         }>>>;
         operation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         callbackUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        childExecutionMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["SEQUENTIAL", "PARALLEL"]>>>;
         idempotencyKey: z.ZodString;
         attempts: z.ZodNumber;
+        forceYield: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         name: string;
@@ -366,6 +378,8 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+        forceYield?: boolean | null | undefined;
     }, {
         id: string;
         name: string;
@@ -398,8 +412,10 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+        forceYield?: boolean | null | undefined;
     }>>>;
-    completeTask(runId: string, id: string, task: CompleteTaskBodyInput): Promise<{
+    completeTask(runId: string, id: string, task: CompleteTaskBodyV2Input): Promise<{
         id: string;
         name: string;
         noop: boolean;
@@ -431,6 +447,8 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+        forceYield?: boolean | null | undefined;
     }>;
     failTask(runId: string, id: string, body: FailTaskBodyInput): Promise<{
         id: string;
@@ -464,6 +482,8 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
+        forceYield?: boolean | null | undefined;
     }>;
     sendEvent(event: SendEvent, options?: SendEventOptions): Promise<{
         id: string;
@@ -493,6 +513,10 @@ declare class ApiClient {
         deliveredAt?: Date | null | undefined;
         cancelledAt?: Date | null | undefined;
     }>;
+    cancelRunsForEvent(eventId: string): Promise<{
+        cancelledRunIds: string[];
+        failedToCancelRunIds: string[];
+    }>;
     updateStatus(runId: string, id: string, status: StatusUpdate): Promise<{
         label: string;
         key: string;
@@ -505,7 +529,7 @@ declare class ApiClient {
         state?: "loading" | "success" | "failure" | undefined;
     }>;
     updateSource(client: string, key: string, source: UpdateTriggerSourceBodyV2): Promise<TriggerSource>;
-    registerTrigger(client: string, id: string, key: string, payload: RegisterTriggerBodyV2): Promise<RegisterSourceEventV2>;
+    registerTrigger(client: string, id: string, key: string, payload: RegisterTriggerBodyV2, idempotencyKey?: string): Promise<RegisterSourceEventV2>;
     registerSchedule(client: string, id: string, key: string, payload: ScheduleMetadata): Promise<{
         id: string;
         schedule: {
@@ -568,6 +592,27 @@ declare class ApiClient {
         output?: any;
         nextCursor?: string | undefined;
     }>;
+    cancelRun(runId: string): Promise<{
+        id: string;
+        startedAt: Date | null;
+        completedAt: Date | null;
+        status: "PENDING" | "CANCELED" | "QUEUED" | "WAITING_ON_CONNECTIONS" | "PREPROCESSING" | "STARTED" | "SUCCESS" | "FAILURE" | "TIMED_OUT" | "ABORTED" | "UNRESOLVED_AUTH" | "INVALID_PAYLOAD";
+        updatedAt: Date | null;
+        tasks: _trigger_dev_core.RunTaskWithSubtasks[];
+        statuses: {
+            label: string;
+            key: string;
+            history: {
+                label?: string | undefined;
+                state?: "loading" | "success" | "failure" | undefined;
+                data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+            }[];
+            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+            state?: "loading" | "success" | "failure" | undefined;
+        }[];
+        output?: any;
+        nextCursor?: string | undefined;
+    }>;
     getRunStatuses(runId: string): Promise<{
         statuses: {
             label: string;
@@ -596,6 +641,9 @@ declare class ApiClient {
         }[];
         nextCursor?: string | undefined;
     }>;
+    invokeJob(jobId: string, payload: any, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
 }
 type VersionedResponseBodyMap = {
     [key: string]: z.ZodTypeAny;
@@ -610,6 +658,23 @@ type VersionedResponseBody<TVersions extends VersionedResponseBodyMap, TUnversio
     body: z.infer<TUnversioned>;
 };
 
+declare class TriggerStatus {
+    private id;
+    private io;
+    constructor(id: string, io: IO);
+    update(key: IntegrationTaskKey, status: StatusUpdate): Promise<{
+        label: string;
+        key: string;
+        history: {
+            label?: string | undefined;
+            state?: "loading" | "success" | "failure" | undefined;
+            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+        }[];
+        data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+        state?: "loading" | "success" | "failure" | undefined;
+    }>;
+}
+
 interface TriggerContext {
     /** Job metadata */
     job: {
@@ -628,6 +693,12 @@ interface TriggerContext {
         id: string;
         title: string;
     };
+    /** Project metadata */
+    project: {
+        slug: string;
+        id: string;
+        name: string;
+    };
     /** Run metadata */
     run: {
         id: string;
@@ -694,6 +765,7 @@ type PreprocessResults = {
     properties: DisplayProperty[];
 };
 type TriggerEventType<TTrigger extends Trigger<any>> = TTrigger extends Trigger<infer TEventSpec> ? ReturnType<TEventSpec["parsePayload"]> : never;
+type TriggerInvokeType<TTrigger extends Trigger<any>> = TTrigger extends Trigger<infer TEventSpec> ? TEventSpec["parseInvokePayload"] extends (payload: unknown) => infer TInvoke ? TInvoke : any : never;
 interface Trigger<TEventSpec extends EventSpecification<any>> {
     event: TEventSpec;
     toJSON(): TriggerMetadata;
@@ -707,7 +779,7 @@ type EventSpecificationExample = {
     icon?: string;
     payload: any;
 };
-interface EventSpecification<TEvent extends any> {
+interface EventSpecification<TEvent extends any, TInvoke extends any = TEvent> {
     name: string | string[];
     title: string;
     source: string;
@@ -717,6 +789,7 @@ interface EventSpecification<TEvent extends any> {
     examples?: Array<EventSpecificationExample>;
     filter?: EventFilter;
     parsePayload: (payload: unknown) => TEvent;
+    parseInvokePayload?: (payload: unknown) => TInvoke;
     runProperties?: (payload: TEvent) => DisplayProperty[];
 }
 type EventTypeFromSpecification<TEventSpec extends EventSpecification<any>> = TEventSpec extends EventSpecification<infer TEvent> ? TEvent : never;
@@ -1095,8 +1168,8 @@ declare class TriggerClient {
     #private;
     id: string;
     constructor(options: Prettify<TriggerClientOptions>);
-    handleRequest(request: Request): Promise<NormalizedResponse>;
-    defineJob<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}>(options: JobOptions<TTrigger, TIntegrations>): Job<TTrigger, TIntegrations>;
+    handleRequest(request: Request, timeOrigin?: number): Promise<NormalizedResponse>;
+    defineJob<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any>(options: JobOptions<TTrigger, TIntegrations, TOutput>): Job<TTrigger, TIntegrations, TOutput>;
     defineAuthResolver(integration: TriggerIntegration, resolver: TriggerAuthResolver): TriggerClient;
     defineDynamicSchedule(options: DynamicIntervalOptions): DynamicSchedule;
     defineDynamicTrigger<TEventSpec extends EventSpecification<any>, TExternalSource extends ExternalSource<any, any, any>>(options: DynamicTriggerOptions<TEventSpec, TExternalSource>): DynamicTrigger<TEventSpec, TExternalSource>;
@@ -1112,7 +1185,7 @@ declare class TriggerClient {
     }): void;
     attachDynamicSchedule(key: string): void;
     attachDynamicScheduleToJob(key: string, job: Job<Trigger<any>, any>): void;
-    registerTrigger(id: string, key: string, options: RegisterTriggerBodyV2): Promise<{
+    registerTrigger(id: string, key: string, options: RegisterTriggerBodyV2, idempotencyKey?: string): Promise<{
         id: string;
         options: {
             event: {
@@ -1182,6 +1255,10 @@ declare class TriggerClient {
         deliveredAt?: Date | null | undefined;
         cancelledAt?: Date | null | undefined;
     }>;
+    cancelRunsForEvent(eventId: string): Promise<{
+        cancelledRunIds: string[];
+        failedToCancelRunIds: string[];
+    }>;
     updateStatus(runId: string, id: string, status: StatusUpdate): Promise<{
         label: string;
         key: string;
@@ -1249,6 +1326,27 @@ declare class TriggerClient {
         output?: any;
         nextCursor?: string | undefined;
     }>;
+    cancelRun(runId: string): Promise<{
+        id: string;
+        startedAt: Date | null;
+        completedAt: Date | null;
+        status: "PENDING" | "CANCELED" | "QUEUED" | "WAITING_ON_CONNECTIONS" | "PREPROCESSING" | "STARTED" | "SUCCESS" | "FAILURE" | "TIMED_OUT" | "ABORTED" | "UNRESOLVED_AUTH" | "INVALID_PAYLOAD";
+        updatedAt: Date | null;
+        tasks: _trigger_dev_core.RunTaskWithSubtasks[];
+        statuses: {
+            label: string;
+            key: string;
+            history: {
+                label?: string | undefined;
+                state?: "loading" | "success" | "failure" | undefined;
+                data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+            }[];
+            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+            state?: "loading" | "success" | "failure" | undefined;
+        }[];
+        output?: any;
+        nextCursor?: string | undefined;
+    }>;
     getRuns(jobSlug: string, options?: GetRunsOptions): Promise<{
         runs: {
             id: string;
@@ -1277,33 +1375,20 @@ declare class TriggerClient {
             output?: any;
         };
     }>;
+    invokeJob(jobId: string, payload: any, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
     authorized(apiKey?: string | null): "authorized" | "unauthorized" | "missing-client" | "missing-header";
     apiKey(): string | undefined;
 }
 
-declare class TriggerStatus {
-    private id;
-    private io;
-    constructor(id: string, io: IO);
-    update(key: IntegrationTaskKey, status: StatusUpdate): Promise<{
-        label: string;
-        key: string;
-        history: {
-            label?: string | undefined;
-            state?: "loading" | "success" | "failure" | undefined;
-            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
-        }[];
-        data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
-        state?: "loading" | "success" | "failure" | undefined;
-    }>;
-}
-
 type IOTask = ServerTask;
 type IOOptions = {
     id: string;
     apiClient: ApiClient;
     client: TriggerClient;
     context: TriggerContext;
+    timeOrigin: number;
     logger?: Logger;
     logLevel?: LogLevel;
     jobLogger?: Logger;
@@ -1313,6 +1398,7 @@ type IOOptions = {
     yieldedExecutions?: Array<string>;
     noopTasksSet?: string;
     serverVersion?: string | null;
+    executionTimeout?: number;
 };
 type JsonPrimitive = string | number | boolean | null | undefined | Date | symbol;
 type JsonArray = Json[];
@@ -1335,6 +1421,14 @@ type IOStats = {
     noopCachedTaskHits: number;
     noopCachedTaskMisses: number;
 };
+interface OutputSerializer {
+    serialize(value: any): string;
+    deserialize<T>(value: string): T;
+}
+declare class JSONOutputSerializer implements OutputSerializer {
+    serialize(value: any): string;
+    deserialize(value?: string): any;
+}
 declare class IO {
     #private;
     private _id;
@@ -1351,17 +1445,21 @@ declare class IO {
     private _noopTasksBloomFilter;
     private _stats;
     private _serverVersion;
+    private _timeOrigin;
+    private _executionTimeout?;
+    private _outputSerializer;
+    private _visitedCacheKeys;
     get stats(): IOStats;
     constructor(options: IOOptions);
     /** Used to send log messages to the [Run log](https://trigger.dev/docs/documentation/guides/viewing-runs). */
     get logger(): IOLogger;
     /** `io.wait()` waits for the specified amount of time before continuing the Job. Delays work even if you're on a serverless platform with timeouts, or if your server goes down. They utilize [resumability](https://trigger.dev/docs/documentation/concepts/resumability) to ensure that the Run can be resumed after the delay.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param seconds The number of seconds to wait. This can be very long, serverless timeouts are not an issue.
      */
-    wait(key: string | any[], seconds: number): Promise<void>;
+    wait(cacheKey: string | any[], seconds: number): Promise<void>;
     /** `io.createStatus()` allows you to set a status with associated data during the Run. Statuses can be used by your UI using the react package
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param initialStatus The initial status you want this status to have. You can update it during the rub using the returned object.
      * @returns a TriggerStatus object that you can call `update()` on, to update the status.
      * @example
@@ -1392,9 +1490,9 @@ declare class IO {
     });
      * ```
     */
-    createStatus(key: IntegrationTaskKey, initialStatus: InitialStatusUpdate): Promise<TriggerStatus>;
+    createStatus(cacheKey: IntegrationTaskKey, initialStatus: InitialStatusUpdate): Promise<TriggerStatus>;
     /** `io.backgroundFetch()` fetches data from a URL that can take longer that the serverless timeout. The actual `fetch` request is performed on the Trigger.dev platform, and the response is sent back to you.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param url The URL to fetch from.
      * @param requestInit The options for the request
      * @param retry The options for retrying the request if it fails
@@ -1404,13 +1502,13 @@ declare class IO {
      * - Ranges: 500-599
      * - Wildcards: 2xx, 3xx, 4xx, 5xx
      */
-    backgroundFetch<TResponseData>(key: string | any[], url: string, requestInit?: FetchRequestInit, retry?: FetchRetryOptions): Promise<TResponseData>;
+    backgroundFetch<TResponseData>(cacheKey: string | any[], url: string, requestInit?: FetchRequestInit, retry?: FetchRetryOptions, timeout?: FetchTimeoutOptions): Promise<TResponseData>;
     /** `io.sendEvent()` allows you to send an event from inside a Job run. The sent even will trigger any Jobs that are listening for that event (based on the name).
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param event The event to send. The event name must match the name of the event that your Jobs are listening for.
      * @param options Options for sending the event.
      */
-    sendEvent(key: string | any[], event: SendEvent, options?: SendEventOptions): Promise<{
+    sendEvent(cacheKey: string | any[], event: SendEvent, options?: SendEventOptions): Promise<{
         id: string;
         name: string;
         payload: ((string | number | boolean | {
@@ -1424,7 +1522,7 @@ declare class IO {
         deliveredAt?: Date | null | undefined;
         cancelledAt?: Date | null | undefined;
     }>;
-    getEvent(key: string | any[], id: string): Promise<{
+    getEvent(cacheKey: string | any[], id: string): Promise<{
         id: string;
         name: string;
         updatedAt: Date;
@@ -1437,11 +1535,11 @@ declare class IO {
         createdAt: Date;
     }>;
     /** `io.cancelEvent()` allows you to cancel an event that was previously sent with `io.sendEvent()`. This will prevent any Jobs from running that are listening for that event if the event was sent with a delay
-     * @param key
+     * @param cacheKey
      * @param eventId
      * @returns
      */
-    cancelEvent(key: string | any[], eventId: string): Promise<{
+    cancelEvent(cacheKey: string | any[], eventId: string): Promise<{
         id: string;
         name: string;
         payload: ((string | number | boolean | {
@@ -1455,21 +1553,21 @@ declare class IO {
         deliveredAt?: Date | null | undefined;
         cancelledAt?: Date | null | undefined;
     }>;
-    updateSource(key: string | any[], options: {
+    updateSource(cacheKey: string | any[], options: {
         key: string;
     } & UpdateTriggerSourceBodyV2): Promise<{
         id: string;
         key: string;
     }>;
     /** `io.registerInterval()` allows you to register a [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) that will trigger any jobs it's attached to on a regular interval.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param dynamicSchedule The [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) to register a new schedule on.
      * @param id A unique id for the interval. This is used to identify and unregister the interval later.
      * @param options The options for the interval.
      * @returns A promise that has information about the interval.
      * @deprecated Use `DynamicSchedule.register` instead.
      */
-    registerInterval(key: string | any[], dynamicSchedule: DynamicSchedule, id: string, options: IntervalOptions): Promise<{
+    registerInterval(cacheKey: string | any[], dynamicSchedule: DynamicSchedule, id: string, options: IntervalOptions): Promise<{
         id: string;
         schedule: {
             options: {
@@ -1490,22 +1588,22 @@ declare class IO {
         metadata?: any;
     }>;
     /** `io.unregisterInterval()` allows you to unregister a [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) that was previously registered with `io.registerInterval()`.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param dynamicSchedule The [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) to unregister a schedule on.
      * @param id A unique id for the interval. This is used to identify and unregister the interval later.
      * @deprecated Use `DynamicSchedule.unregister` instead.
      */
-    unregisterInterval(key: string | any[], dynamicSchedule: DynamicSchedule, id: string): Promise<{
+    unregisterInterval(cacheKey: string | any[], dynamicSchedule: DynamicSchedule, id: string): Promise<{
         ok: boolean;
     }>;
     /** `io.registerCron()` allows you to register a [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) that will trigger any jobs it's attached to on a regular CRON schedule.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param dynamicSchedule The [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) to register a new schedule on.
      * @param id A unique id for the schedule. This is used to identify and unregister the schedule later.
      * @param options The options for the CRON schedule.
      * @deprecated Use `DynamicSchedule.register` instead.
      */
-    registerCron(key: string | any[], dynamicSchedule: DynamicSchedule, id: string, options: CronOptions): Promise<{
+    registerCron(cacheKey: string | any[], dynamicSchedule: DynamicSchedule, id: string, options: CronOptions): Promise<{
         id: string;
         schedule: {
             options: {
@@ -1526,43 +1624,44 @@ declare class IO {
         metadata?: any;
     }>;
     /** `io.unregisterCron()` allows you to unregister a [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) that was previously registered with `io.registerCron()`.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param dynamicSchedule The [DynamicSchedule](https://trigger.dev/docs/sdk/dynamicschedule) to unregister a schedule on.
      * @param id A unique id for the interval. This is used to identify and unregister the interval later.
      * @deprecated Use `DynamicSchedule.unregister` instead.
      */
-    unregisterCron(key: string | any[], dynamicSchedule: DynamicSchedule, id: string): Promise<{
+    unregisterCron(cacheKey: string | any[], dynamicSchedule: DynamicSchedule, id: string): Promise<{
         ok: boolean;
     }>;
     /** `io.registerTrigger()` allows you to register a [DynamicTrigger](https://trigger.dev/docs/sdk/dynamictrigger) with the specified trigger params.
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param trigger The [DynamicTrigger](https://trigger.dev/docs/sdk/dynamictrigger) to register.
      * @param id A unique id for the trigger. This is used to identify and unregister the trigger later.
      * @param params The params for the trigger.
      * @deprecated Use `DynamicTrigger.register` instead.
      */
-    registerTrigger<TTrigger extends DynamicTrigger<EventSpecification<any>, ExternalSource<any, any, any>>>(key: string | any[], trigger: TTrigger, id: string, params: ExternalSourceParams<TTrigger["source"]>): Promise<{
+    registerTrigger<TTrigger extends DynamicTrigger<EventSpecification<any>, ExternalSource<any, any, any>>>(cacheKey: string | any[], trigger: TTrigger, id: string, params: ExternalSourceParams<TTrigger["source"]>): Promise<{
         id: string;
         key: string;
     } | undefined>;
-    getAuth(key: string | any[], clientId?: string): Promise<ConnectionAuth | undefined>;
+    getAuth(cacheKey: string | any[], clientId?: string): Promise<ConnectionAuth | undefined>;
+    parallel<T extends Json<T> | void, TItem>(cacheKey: string | any[], items: Array<TItem>, callback: (item: TItem, index: number) => Promise<T>, options?: Pick<RunTaskOptions, "name" | "properties">): Promise<Array<T>>;
     /** `io.runTask()` allows you to run a [Task](https://trigger.dev/docs/documentation/concepts/tasks) from inside a Job run. A Task is a resumable unit of a Run that can be retried, resumed and is logged. [Integrations](https://trigger.dev/docs/integrations) use Tasks internally to perform their actions.
      *
-     * @param key Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param callback The callback that will be called when the Task is run. The callback receives the Task and the IO as parameters.
      * @param options The options of how you'd like to run and log the Task.
      * @param onError The callback that will be called when the Task fails. The callback receives the error, the Task and the IO as parameters. If you wish to retry then return an object with a `retryAt` property.
      * @returns A Promise that resolves with the returned value of the callback.
      */
-    runTask<T extends Json<T> | void>(key: string | any[], callback: (task: ServerTask, io: IO) => Promise<T>, options?: RunTaskOptions, onError?: RunTaskErrorCallback): Promise<T>;
+    runTask<T extends Json<T> | void>(cacheKey: string | any[], callback: (task: ServerTask, io: IO) => Promise<T>, options?: RunTaskOptions, onError?: RunTaskErrorCallback): Promise<T>;
     /**
      * `io.yield()` allows you to yield execution of the current run and resume it in a new function execution. Similar to `io.wait()` but does not create a task and resumes execution immediately.
      */
-    yield(key: string): void;
+    yield(cacheKey: string): void;
     /**
      * `io.brb()` is an alias of `io.yield()`
      */
-    brb: (key: string) => void;
+    brb: (cacheKey: string) => void;
     /** `io.try()` allows you to run Tasks and catch any errors that are thrown, it's similar to a normal `try/catch` block but works with [io.runTask()](/sdk/io/runtask).
      * A regular `try/catch` block on its own won't work as expected with Tasks. Internally `runTask()` throws some special errors to control flow execution. This is necessary to deal with resumability, serverless timeouts, and retrying Tasks.
      * @param tryCallback The code you wish to run
@@ -1596,7 +1695,7 @@ interface TriggerIntegration {
 type IOWithIntegrations<TIntegrations extends Record<string, TriggerIntegration>> = IO & TIntegrations;
 type IntegrationTaskKey = string | any[];
 
-type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}> = {
+type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any> = {
     /** The `id` property is used to uniquely identify the Job. Only change this if you want to create a new Job. */
     id: string;
     /** The `name` of the Job that you want to appear in the dashboard and logs. You can change this without creating a new Job. */
@@ -1642,19 +1741,19 @@ type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations
      * @param io An object that contains the integrations that you specified in the `integrations` property and other useful functions like delays and running Tasks.
      * @param context An object that contains information about the Organization, Job, Run and more.
      */
-    run: (payload: TriggerEventType<TTrigger>, io: IOWithIntegrations<TIntegrations>, context: TriggerContext) => Promise<any>;
+    run: (payload: TriggerEventType<TTrigger>, io: IOWithIntegrations<TIntegrations>, context: TriggerContext) => Promise<TOutput>;
 };
 type JobPayload<TJob> = TJob extends Job<Trigger<EventSpecification<infer TEvent>>, any> ? TEvent : never;
 type JobIO<TJob> = TJob extends Job<any, infer TIntegrations> ? IOWithIntegrations<TIntegrations> : never;
 /** A [Job](https://trigger.dev/docs/documentation/concepts/jobs) is used to define the [Trigger](https://trigger.dev/docs/documentation/concepts/triggers), metadata, and what happens when it runs. */
-declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}> {
+declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any> {
     #private;
-    readonly options: JobOptions<TTrigger, TIntegrations>;
+    readonly options: JobOptions<TTrigger, TIntegrations, TOutput>;
     client: TriggerClient;
     constructor(
     /** An instance of [TriggerClient](/sdk/triggerclient) that is used to send events
   to the Trigger API. */
-    client: TriggerClient, options: JobOptions<TTrigger, TIntegrations>);
+    client: TriggerClient, options: JobOptions<TTrigger, TIntegrations, TOutput>);
     get id(): string;
     get enabled(): boolean;
     get name(): string;
@@ -1663,6 +1762,19 @@ declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegratio
     get logLevel(): LogLevel | undefined;
     get integrations(): Record<string, IntegrationConfig>;
     toJSON(): JobMetadata;
+    invoke(cacheKey: string, payload: TriggerInvokeType<TTrigger>, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
+    invoke(payload: TriggerInvokeType<TTrigger>, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
+    invokeAndWaitForCompletion(cacheKey: string | string[], payload: TriggerInvokeType<TTrigger>, timeoutInSeconds?: number, // 1 hour
+    options?: Prettify<Pick<InvokeOptions, "accountId" | "context">>): Promise<RunNotification<TOutput>>;
+    batchInvokeAndWaitForCompletion(cacheKey: string | string[], batch: Array<{
+        payload: TriggerInvokeType<TTrigger>;
+        timeoutInSeconds?: number;
+        options?: Prettify<Pick<InvokeOptions, "accountId" | "context">>;
+    }>): Promise<Array<RunNotification<TOutput>>>;
 }
 
 type EventTriggerOptions<TEventSpecification extends EventSpecification<any>> = {
@@ -1816,10 +1928,41 @@ declare class MissingConnectionResolvedNotification implements Trigger<MissingCo
     toJSON(): TriggerMetadata;
 }
 
+/** Configuration options for an InvokeTrigger */
+type InvokeTriggerOptions<TSchema extends ZodType = z.ZodTypeAny> = {
+    /** A [Zod](https://trigger.dev/docs/documentation/guides/zod) schema that defines the shape of the event payload.
+     * The default is `z.any()` which is `any`.
+     * */
+    schema?: TSchema;
+    examples?: EventSpecificationExample[];
+};
+declare class InvokeTrigger<TSchema extends ZodType = z.ZodTypeAny> implements Trigger<EventSpecification<TypeOf<TSchema>, z.input<TSchema>>> {
+    #private;
+    constructor(options: InvokeTriggerOptions<TSchema>);
+    toJSON(): TriggerMetadata;
+    get event(): {
+        name: string;
+        title: string;
+        source: string;
+        examples: EventSpecificationExample[];
+        icon: string;
+        parsePayload: (rawPayload: unknown) => any;
+        parseInvokePayload: (rawPayload: unknown) => any;
+    };
+    attachToJob(triggerClient: TriggerClient, job: Job<Trigger<EventSpecification<ZodType<TSchema>>>, any>): void;
+    get preprocessRuns(): boolean;
+}
+declare function invokeTrigger<TSchema extends ZodType = z.ZodTypeAny>(options?: InvokeTriggerOptions<TSchema>): Trigger<EventSpecification<TypeOf<TSchema>, z.input<TSchema>>>;
+
 declare class ResumeWithTaskError {
     task: ServerTask;
     constructor(task: ServerTask);
 }
+declare class ResumeWithParallelTaskError {
+    task: ServerTask;
+    childErrors: Array<TriggerInternalError>;
+    constructor(task: ServerTask, childErrors: Array<TriggerInternalError>);
+}
 declare class RetryWithTaskError {
     cause: ErrorWithStack;
     task: ServerTask;
@@ -1830,13 +1973,39 @@ declare class CanceledWithTaskError {
     task: ServerTask;
     constructor(task: ServerTask);
 }
+declare class YieldExecutionError {
+    key: string;
+    constructor(key: string);
+}
+declare class AutoYieldExecutionError {
+    location: string;
+    timeRemaining: number;
+    timeElapsed: number;
+    constructor(location: string, timeRemaining: number, timeElapsed: number);
+}
+declare class AutoYieldWithCompletedTaskExecutionError {
+    id: string;
+    properties: DisplayProperty[] | undefined;
+    data: {
+        location: string;
+        timeRemaining: number;
+        timeElapsed: number;
+    };
+    output?: string | undefined;
+    constructor(id: string, properties: DisplayProperty[] | undefined, data: {
+        location: string;
+        timeRemaining: number;
+        timeElapsed: number;
+    }, output?: string | undefined);
+}
+type TriggerInternalError = ResumeWithTaskError | RetryWithTaskError | CanceledWithTaskError | YieldExecutionError | AutoYieldExecutionError | AutoYieldWithCompletedTaskExecutionError | ResumeWithParallelTaskError;
 /** Use this function if you're using a `try/catch` block to catch errors.
  * It checks if a thrown error is a special internal error that you should ignore.
  * If this returns `true` then you must rethrow the error: `throw err;`
  * @param err The error to check
  * @returns `true` if the error is a Trigger Error, `false` otherwise.
  */
-declare function isTriggerError(err: unknown): err is ResumeWithTaskError | RetryWithTaskError | CanceledWithTaskError;
+declare function isTriggerError(err: unknown): err is TriggerInternalError;
 
 declare const retry: {
     readonly standardBackoff: {
@@ -1853,4 +2022,4 @@ type Task = ServerTask;
 type SentEvent = ApiEventLog;
 declare function redactString(strings: TemplateStringsArray, ...interpolations: string[]): RedactString;
 
-export { AuthResolverResult, CronTrigger, DynamicIntervalOptions, DynamicSchedule, DynamicTrigger, DynamicTriggerOptions, EventSpecification, EventSpecificationExample, EventTrigger, EventTypeFromSpecification, ExternalSource, ExternalSourceParams, ExternalSourceTrigger, ExternalSourceTriggerOptions, HandlerEvent, HttpSourceEvent, IO, IOLogger, IOOptions, IOStats, IOTask, IOWithIntegrations, IntegrationTaskKey, IntervalTrigger, Job, JobIO, JobOptions, JobPayload, Json, MissingConnectionNotification, MissingConnectionResolvedNotification, PreprocessResults, RunTaskErrorCallback, SchemaParser, SchemaParserIssue, SchemaParserResult, SentEvent, Task, TaskLogger, Trigger, TriggerAuthResolver, TriggerClient, TriggerClientOptions, TriggerContext, TriggerEventType, TriggerIntegration, TriggerOptionRecord, TriggerPayload, TriggerPreprocessContext, cronTrigger, eventTrigger, intervalTrigger, isTriggerError, missingConnectionNotification, missingConnectionResolvedNotification, omit, redactString, retry };
+export { AuthResolverResult, CronTrigger, DynamicIntervalOptions, DynamicSchedule, DynamicTrigger, DynamicTriggerOptions, EventSpecification, EventSpecificationExample, EventTrigger, EventTypeFromSpecification, ExternalSource, ExternalSourceParams, ExternalSourceTrigger, ExternalSourceTriggerOptions, HandlerEvent, HttpSourceEvent, IO, IOLogger, IOOptions, IOStats, IOTask, IOWithIntegrations, IntegrationTaskKey, IntervalTrigger, InvokeTrigger, JSONOutputSerializer, Job, JobIO, JobOptions, JobPayload, Json, MissingConnectionNotification, MissingConnectionResolvedNotification, OutputSerializer, PreprocessResults, RunTaskErrorCallback, SchemaParser, SchemaParserIssue, SchemaParserResult, SentEvent, Task, TaskLogger, Trigger, TriggerAuthResolver, TriggerClient, TriggerClientOptions, TriggerContext, TriggerEventType, TriggerIntegration, TriggerInvokeType, TriggerOptionRecord, TriggerPayload, TriggerPreprocessContext, cronTrigger, eventTrigger, intervalTrigger, invokeTrigger, isTriggerError, missingConnectionNotification, missingConnectionResolvedNotification, omit, redactString, retry };