@trigger.dev/core 0.0.0-v3-prerelease-20240523152756 → 0.0.0-v3-prerelease-20240612084127

package/dist/v3/index.js

@@ -35,7 +35,7 @@ var __privateMethod = (obj, member, method) => {
 };
 
 // package.json
-var version = "0.0.0-v3-prerelease-20240523152756";
+var version = "0.0.0-v3-prerelease-20240612084127";
 var dependencies = {
   "@google-cloud/precise-date": "^4.0.0",
   "@opentelemetry/api": "^1.8.0",
@@ -58,144 +58,6 @@ var dependencies = {
   "zod-error": "1.5.0",
   "zod-validation-error": "^1.5.0"
 };
-
-// src/v3/apiErrors.ts
-var _APIError = class _APIError extends Error {
-  constructor(status, error, message, headers) {
-    super(`${_APIError.makeMessage(status, error, message)}`);
-    this.status = status;
-    this.headers = headers;
-    const data = error;
-    this.error = data;
-    this.code = data?.["code"];
-    this.param = data?.["param"];
-    this.type = data?.["type"];
-  }
-  static makeMessage(status, error, message) {
-    const msg = error?.message ? typeof error.message === "string" ? error.message : JSON.stringify(error.message) : error ? JSON.stringify(error) : message;
-    if (status && msg) {
-      return `${status} ${msg}`;
-    }
-    if (status) {
-      return `${status} status code (no body)`;
-    }
-    if (msg) {
-      return msg;
-    }
-    return "(no status code or body)";
-  }
-  static generate(status, errorResponse, message, headers) {
-    if (!status) {
-      return new APIConnectionError({
-        cause: castToError(errorResponse)
-      });
-    }
-    const error = errorResponse?.["error"];
-    if (status === 400) {
-      return new BadRequestError(status, error, message, headers);
-    }
-    if (status === 401) {
-      return new AuthenticationError(status, error, message, headers);
-    }
-    if (status === 403) {
-      return new PermissionDeniedError(status, error, message, headers);
-    }
-    if (status === 404) {
-      return new NotFoundError(status, error, message, headers);
-    }
-    if (status === 409) {
-      return new ConflictError(status, error, message, headers);
-    }
-    if (status === 422) {
-      return new UnprocessableEntityError(status, error, message, headers);
-    }
-    if (status === 429) {
-      return new RateLimitError(status, error, message, headers);
-    }
-    if (status >= 500) {
-      return new InternalServerError(status, error, message, headers);
-    }
-    return new _APIError(status, error, message, headers);
-  }
-};
-__name(_APIError, "APIError");
-var APIError = _APIError;
-var _APIConnectionError = class _APIConnectionError extends APIError {
-  constructor({ message, cause }) {
-    super(void 0, void 0, message || "Connection error.", void 0);
-    __publicField(this, "status");
-    if (cause)
-      this.cause = cause;
-  }
-};
-__name(_APIConnectionError, "APIConnectionError");
-var APIConnectionError = _APIConnectionError;
-var _BadRequestError = class _BadRequestError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 400);
-  }
-};
-__name(_BadRequestError, "BadRequestError");
-var BadRequestError = _BadRequestError;
-var _AuthenticationError = class _AuthenticationError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 401);
-  }
-};
-__name(_AuthenticationError, "AuthenticationError");
-var AuthenticationError = _AuthenticationError;
-var _PermissionDeniedError = class _PermissionDeniedError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 403);
-  }
-};
-__name(_PermissionDeniedError, "PermissionDeniedError");
-var PermissionDeniedError = _PermissionDeniedError;
-var _NotFoundError = class _NotFoundError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 404);
-  }
-};
-__name(_NotFoundError, "NotFoundError");
-var NotFoundError = _NotFoundError;
-var _ConflictError = class _ConflictError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 409);
-  }
-};
-__name(_ConflictError, "ConflictError");
-var ConflictError = _ConflictError;
-var _UnprocessableEntityError = class _UnprocessableEntityError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 422);
-  }
-};
-__name(_UnprocessableEntityError, "UnprocessableEntityError");
-var UnprocessableEntityError = _UnprocessableEntityError;
-var _RateLimitError = class _RateLimitError extends APIError {
-  constructor() {
-    super(...arguments);
-    __publicField(this, "status", 429);
-  }
-};
-__name(_RateLimitError, "RateLimitError");
-var RateLimitError = _RateLimitError;
-var _InternalServerError = class _InternalServerError extends APIError {
-};
-__name(_InternalServerError, "InternalServerError");
-var InternalServerError = _InternalServerError;
-function castToError(err) {
-  if (err instanceof Error)
-    return err;
-  return new Error(err);
-}
-__name(castToError, "castToError");
 var CreateAuthorizationCodeResponseSchema = zod.z.object({
   url: zod.z.string().url(),
   authorizationCode: zod.z.string()
@@ -231,6 +93,7 @@ var TaskRunErrorCodes = {
   TASK_EXECUTION_FAILED: "TASK_EXECUTION_FAILED",
   TASK_EXECUTION_ABORTED: "TASK_EXECUTION_ABORTED",
   TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE: "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE",
+  TASK_PROCESS_SIGKILL_TIMEOUT: "TASK_PROCESS_SIGKILL_TIMEOUT",
   TASK_RUN_CANCELLED: "TASK_RUN_CANCELLED",
   TASK_OUTPUT_ERROR: "TASK_OUTPUT_ERROR",
   HANDLE_ERROR_ERROR: "HANDLE_ERROR_ERROR",
@@ -246,10 +109,12 @@ var TaskRunInternalError = zod.z.object({
     "TASK_EXECUTION_FAILED",
     "TASK_EXECUTION_ABORTED",
     "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE",
+    "TASK_PROCESS_SIGKILL_TIMEOUT",
     "TASK_RUN_CANCELLED",
     "TASK_OUTPUT_ERROR",
     "HANDLE_ERROR_ERROR",
-    "GRACEFUL_EXIT_TIMEOUT"
+    "GRACEFUL_EXIT_TIMEOUT",
+    "TASK_RUN_HEARTBEAT_TIMEOUT"
   ]),
   message: zod.z.string().optional()
 });
@@ -511,7 +376,16 @@ var TaskFileMetadata = zod.z.object({
   filePath: zod.z.string(),
   exportName: zod.z.string()
 });
-var TaskMetadataWithFilePath = TaskMetadata.merge(TaskFileMetadata);
+var TaskMetadataWithFilePath = zod.z.object({
+  id: zod.z.string(),
+  packageVersion: zod.z.string(),
+  queue: QueueOptions.optional(),
+  retry: RetryOptions.optional(),
+  machine: Machine.partial().optional(),
+  triggerSource: zod.z.string().optional(),
+  filePath: zod.z.string(),
+  exportName: zod.z.string()
+});
 var PostStartCauses = zod.z.enum([
   "index",
   "create",
@@ -552,6 +426,13 @@ var WaitReason = zod.z.enum([
   "WAIT_FOR_TASK",
   "WAIT_FOR_BATCH"
 ]);
+var TaskRunExecutionLazyAttemptPayload = zod.z.object({
+  runId: zod.z.string(),
+  messageId: zod.z.string(),
+  isTest: zod.z.boolean(),
+  traceContext: zod.z.record(zod.z.unknown()),
+  environment: zod.z.record(zod.z.string()).optional()
+});
 
 // src/v3/schemas/resources.ts
 var TaskResource = zod.z.object({
@@ -573,6 +454,152 @@ var ImageDetailsMetadata = zod.z.object({
   contentHash: zod.z.string(),
   imageTag: zod.z.string()
 });
+function parseError(error) {
+  if (error instanceof Error) {
+    return {
+      type: "BUILT_IN_ERROR",
+      name: error.name,
+      message: error.message,
+      stackTrace: error.stack ?? ""
+    };
+  }
+  if (typeof error === "string") {
+    return {
+      type: "STRING_ERROR",
+      raw: error
+    };
+  }
+  try {
+    return {
+      type: "CUSTOM_ERROR",
+      raw: JSON.stringify(error)
+    };
+  } catch (e) {
+    return {
+      type: "CUSTOM_ERROR",
+      raw: String(error)
+    };
+  }
+}
+__name(parseError, "parseError");
+function createErrorTaskError(error) {
+  switch (error.type) {
+    case "BUILT_IN_ERROR": {
+      const e = new Error(error.message);
+      e.name = error.name;
+      e.stack = error.stackTrace;
+      return e;
+    }
+    case "STRING_ERROR": {
+      return error.raw;
+    }
+    case "CUSTOM_ERROR": {
+      return JSON.parse(error.raw);
+    }
+    case "INTERNAL_ERROR": {
+      return new Error(`trigger.dev internal error (${error.code})`);
+    }
+  }
+}
+__name(createErrorTaskError, "createErrorTaskError");
+var SerializedError = zod.z.object({
+  message: zod.z.string(),
+  name: zod.z.string().optional(),
+  stackTrace: zod.z.string().optional()
+});
+function createJsonErrorObject(error) {
+  switch (error.type) {
+    case "BUILT_IN_ERROR": {
+      return {
+        name: error.name,
+        message: error.message,
+        stackTrace: error.stackTrace
+      };
+    }
+    case "STRING_ERROR": {
+      return {
+        message: error.raw
+      };
+    }
+    case "CUSTOM_ERROR": {
+      return {
+        message: error.raw
+      };
+    }
+    case "INTERNAL_ERROR": {
+      return {
+        message: `trigger.dev internal error (${error.code})`
+      };
+    }
+  }
+}
+__name(createJsonErrorObject, "createJsonErrorObject");
+function correctErrorStackTrace(stackTrace, projectDir, options) {
+  const [errorLine, ...traceLines] = stackTrace.split("\n");
+  return [
+    options?.removeFirstLine ? void 0 : errorLine,
+    ...traceLines.map((line) => correctStackTraceLine(line, projectDir, options?.isDev))
+  ].filter(Boolean).join("\n");
+}
+__name(correctErrorStackTrace, "correctErrorStackTrace");
+var LINES_TO_IGNORE = [
+  /ConsoleInterceptor/,
+  /TriggerTracer/,
+  /TaskExecutor/,
+  /EXECUTE_TASK_RUN/,
+  /@trigger.dev\/core/,
+  /packages\/core\/src\/v3/,
+  /safeJsonProcess/,
+  /__entryPoint.ts/,
+  /ZodIpc/,
+  /startActiveSpan/,
+  /processTicksAndRejections/
+];
+function correctStackTraceLine(line, projectDir, isDev) {
+  if (LINES_TO_IGNORE.some((regex) => regex.test(line))) {
+    return;
+  }
+  if (isDev && projectDir && !line.includes(projectDir)) {
+    return;
+  }
+  return line.trim();
+}
+__name(correctStackTraceLine, "correctStackTraceLine");
+function groupTaskMetadataIssuesByTask(tasks, issues) {
+  return issues.reduce((acc, issue) => {
+    if (issue.path.length === 0) {
+      return acc;
+    }
+    const taskIndex = issue.path[1];
+    if (typeof taskIndex !== "number") {
+      return acc;
+    }
+    const task = tasks[taskIndex];
+    if (!task) {
+      return acc;
+    }
+    const restOfPath = issue.path.slice(2);
+    const taskId = task.id;
+    const taskName = task.exportName;
+    const filePath = task.filePath;
+    const key = taskIndex;
+    const existing = acc[key] ?? {
+      id: taskId,
+      exportName: taskName,
+      filePath,
+      issues: []
+    };
+    existing.issues.push({
+      message: issue.message,
+      path: restOfPath.length === 0 ? void 0 : restOfPath.join(".")
+    });
+    return {
+      ...acc,
+      [key]: existing
+    };
+  }, {});
+}
+__name(groupTaskMetadataIssuesByTask, "groupTaskMetadataIssuesByTask");
 
 // src/v3/schemas/api.ts
 var WhoAmIResponseSchema = zod.z.object({
@@ -601,7 +628,8 @@ var GetProjectEnvResponse = zod.z.object({
 });
 var CreateBackgroundWorkerRequestBody = zod.z.object({
   localOnly: zod.z.boolean(),
-  metadata: BackgroundWorkerMetadata
+  metadata: BackgroundWorkerMetadata,
+  supportsLazyAttempts: zod.z.boolean().optional()
 });
 var CreateBackgroundWorkerResponse = zod.z.object({
   id: zod.z.string(),
@@ -678,7 +706,8 @@ var InitializeDeploymentRequestBody = zod.z.object({
 var DeploymentErrorData = zod.z.object({
   name: zod.z.string(),
   message: zod.z.string(),
-  stack: zod.z.string().optional()
+  stack: zod.z.string().optional(),
+  stderr: zod.z.string().optional()
 });
 var GetDeploymentResponseBody = zod.z.object({
   id: zod.z.string(),
@@ -714,7 +743,7 @@ var ReplayRunResponse = zod.z.object({
   id: zod.z.string()
 });
 var CanceledRunResponse = zod.z.object({
-  message: zod.z.string()
+  id: zod.z.string()
 });
 var ScheduledTaskPayload = zod.z.object({
   /** The schedule id associated with this run (you can have many schedules for the same task).
@@ -764,17 +793,18 @@ var CreateScheduleOptions = zod.z.object({
   externalId: zod.z.string().optional()
 });
 var UpdateScheduleOptions = CreateScheduleOptions;
+var ScheduleGenerator = zod.z.object({
+  type: zod.z.literal("CRON"),
+  expression: zod.z.string(),
+  description: zod.z.string()
+});
 var ScheduleObject = zod.z.object({
   id: zod.z.string(),
   task: zod.z.string(),
   active: zod.z.boolean(),
   deduplicationKey: zod.z.string().nullish(),
   externalId: zod.z.string().nullish(),
-  generator: zod.z.object({
-    type: zod.z.literal("CRON"),
-    expression: zod.z.string(),
-    description: zod.z.string()
-  }),
+  generator: ScheduleGenerator,
   nextRun: zod.z.coerce.date().nullish(),
   environments: zod.z.array(zod.z.object({
     id: zod.z.string(),
@@ -798,12 +828,28 @@ var ListScheduleOptions = zod.z.object({
   perPage: zod.z.number().optional()
 });
 var RunStatus = zod.z.enum([
-  "PENDING",
+  /// Task hasn't been deployed yet but is waiting to be executed
+  "WAITING_FOR_DEPLOY",
+  /// Task is waiting to be executed by a worker
+  "QUEUED",
+  /// Task is currently being executed by a worker
   "EXECUTING",
-  "PAUSED",
+  /// Task has failed and is waiting to be retried
+  "REATTEMPTING",
+  /// Task has been paused by the system, and will be resumed by the system
+  "FROZEN",
+  /// Task has been completed successfully
   "COMPLETED",
+  /// Task has been canceled by the user
+  "CANCELED",
+  /// Task has been completed with errors
   "FAILED",
-  "CANCELED"
+  /// Task has crashed and won't be retried, most likely the worker ran out of resources, e.g. memory or storage
+  "CRASHED",
+  /// Task was interrupted during execution, mostly this happens in development environments
+  "INTERRUPTED",
+  /// Task has failed to complete, due to an error in the system
+  "SYSTEM_FAILURE"
 ]);
 var AttemptStatus = zod.z.enum([
   "PENDING",
@@ -813,23 +859,61 @@ var AttemptStatus = zod.z.enum([
   "FAILED",
   "CANCELED"
 ]);
-var RetrieveRunResponse = zod.z.object({
+var RunEnvironmentDetails = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  user: zod.z.string().optional()
+});
+var RunScheduleDetails = zod.z.object({
+  id: zod.z.string(),
+  externalId: zod.z.string().optional(),
+  deduplicationKey: zod.z.string().optional(),
+  generator: ScheduleGenerator
+});
+var CommonRunFields = {
   id: zod.z.string(),
   status: RunStatus,
   taskIdentifier: zod.z.string(),
   idempotencyKey: zod.z.string().optional(),
   version: zod.z.string().optional(),
+  isQueued: zod.z.boolean(),
+  isExecuting: zod.z.boolean(),
+  isCompleted: zod.z.boolean(),
+  isSuccess: zod.z.boolean(),
+  isFailed: zod.z.boolean(),
+  isCancelled: zod.z.boolean(),
+  isTest: zod.z.boolean(),
   createdAt: zod.z.coerce.date(),
   updatedAt: zod.z.coerce.date(),
+  startedAt: zod.z.coerce.date().optional(),
+  finishedAt: zod.z.coerce.date().optional()
+};
+var RetrieveRunResponse = zod.z.object({
+  ...CommonRunFields,
+  payload: zod.z.any().optional(),
+  output: zod.z.any().optional(),
+  schedule: RunScheduleDetails.optional(),
   attempts: zod.z.array(zod.z.object({
     id: zod.z.string(),
     status: AttemptStatus,
     createdAt: zod.z.coerce.date(),
     updatedAt: zod.z.coerce.date(),
     startedAt: zod.z.coerce.date().optional(),
-    completedAt: zod.z.coerce.date().optional()
+    completedAt: zod.z.coerce.date().optional(),
+    error: SerializedError.optional()
   }).optional())
 });
+var ListRunResponseItem = zod.z.object({
+  ...CommonRunFields,
+  env: RunEnvironmentDetails
+});
+var ListRunResponse = zod.z.object({
+  data: zod.z.array(ListRunResponseItem),
+  pagination: zod.z.object({
+    next: zod.z.string().optional(),
+    previous: zod.z.string().optional()
+  })
+});
 var CreateEnvironmentVariableRequestBody = zod.z.object({
   name: zod.z.string(),
   value: zod.z.string()
@@ -868,12 +952,16 @@ var BackgroundWorkerServerMessages = zod.z.discriminatedUnion("type", [
     version: zod.z.string(),
     machine: Machine,
     // identifiers
-    id: zod.z.string(),
+    id: zod.z.string().optional(),
     envId: zod.z.string(),
     envType: EnvironmentType,
     orgId: zod.z.string(),
     projectId: zod.z.string(),
     runId: zod.z.string()
+  }),
+  zod.z.object({
+    type: zod.z.literal("EXECUTE_RUN_LAZY_ATTEMPT"),
+    payload: TaskRunExecutionLazyAttemptPayload
   })
 ]);
 var serverWebsocketMessages = {
@@ -894,10 +982,20 @@ var BackgroundWorkerClientMessages = zod.z.discriminatedUnion("type", [
     completion: TaskRunExecutionResult,
     execution: TaskRunExecution
   }),
+  zod.z.object({
+    version: zod.z.literal("v1").default("v1"),
+    type: zod.z.literal("TASK_RUN_FAILED_TO_RUN"),
+    completion: TaskRunFailedExecutionResult
+  }),
   zod.z.object({
     version: zod.z.literal("v1").default("v1"),
     type: zod.z.literal("TASK_HEARTBEAT"),
     id: zod.z.string()
+  }),
+  zod.z.object({
+    version: zod.z.literal("v1").default("v1"),
+    type: zod.z.literal("TASK_RUN_HEARTBEAT"),
+    id: zod.z.string()
   })
 ]);
 var BackgroundWorkerProperties = zod.z.object({
@@ -908,7 +1006,8 @@ var BackgroundWorkerProperties = zod.z.object({
 var clientWebsocketMessages = {
   READY_FOR_TASKS: zod.z.object({
     version: zod.z.literal("v1").default("v1"),
-    backgroundWorkerId: zod.z.string()
+    backgroundWorkerId: zod.z.string(),
+    inProgressRuns: zod.z.string().array().optional()
   }),
   BACKGROUND_WORKER_DEPRECATED: zod.z.object({
     version: zod.z.literal("v1").default("v1"),
@@ -927,11 +1026,17 @@ var workerToChildMessages = {
     traceContext: zod.z.record(zod.z.unknown()),
     metadata: BackgroundWorkerProperties
   }),
-  TASK_RUN_COMPLETED_NOTIFICATION: zod.z.object({
-    version: zod.z.literal("v1").default("v1"),
-    completion: TaskRunExecutionResult,
-    execution: TaskRunExecution
-  }),
+  TASK_RUN_COMPLETED_NOTIFICATION: zod.z.discriminatedUnion("version", [
+    zod.z.object({
+      version: zod.z.literal("v1"),
+      completion: TaskRunExecutionResult,
+      execution: TaskRunExecution
+    }),
+    zod.z.object({
+      version: zod.z.literal("v2"),
+      completion: TaskRunExecutionResult
+    })
+  ]),
   CLEANUP: zod.z.object({
     version: zod.z.literal("v1").default("v1"),
     flush: zod.z.boolean().default(false),
@@ -972,6 +1077,10 @@ var childToWorkerMessages = {
     version: zod.z.literal("v1").default("v1"),
     id: zod.z.string()
   }),
+  TASK_RUN_HEARTBEAT: zod.z.object({
+    version: zod.z.literal("v1").default("v1"),
+    id: zod.z.string()
+  }),
   READY_TO_DISPOSE: zod.z.undefined(),
   WAIT_FOR_DURATION: zod.z.object({
     version: zod.z.literal("v1").default("v1"),
@@ -1011,6 +1120,12 @@ var ProdChildToWorkerMessages = {
       id: zod.z.string()
     })
   },
+  TASK_RUN_HEARTBEAT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      id: zod.z.string()
+    })
+  },
   READY_TO_DISPOSE: {
     message: zod.z.undefined()
   },
@@ -1075,11 +1190,17 @@ var ProdWorkerToChildMessages = {
     })
   },
   TASK_RUN_COMPLETED_NOTIFICATION: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1"),
-      completion: TaskRunExecutionResult,
-      execution: TaskRunExecution
-    })
+    message: zod.z.discriminatedUnion("version", [
+      zod.z.object({
+        version: zod.z.literal("v1"),
+        completion: TaskRunExecutionResult,
+        execution: TaskRunExecution
+      }),
+      zod.z.object({
+        version: zod.z.literal("v2"),
+        completion: TaskRunExecutionResult
+      })
+    ])
   },
   CLEANUP: {
     message: zod.z.object({
@@ -1127,21 +1248,14 @@ var ProviderToPlatformMessages = {
       deploymentId: zod.z.string(),
       error: zod.z.object({
         name: zod.z.string(),
-        message: zod.z.string(),
-        stack: zod.z.string().optional()
-      })
-    })
-  }
-};
-var PlatformToProviderMessages = {
-  HEALTH: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1")
-    }),
-    callback: zod.z.object({
-      status: zod.z.literal("ok")
+        message: zod.z.string(),
+        stack: zod.z.string().optional(),
+        stderr: zod.z.string().optional()
+      })
     })
-  },
+  }
+};
+var PlatformToProviderMessages = {
   INDEX: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1162,7 +1276,8 @@ var PlatformToProviderMessages = {
         error: zod.z.object({
           name: zod.z.string(),
           message: zod.z.string(),
-          stack: zod.z.string().optional()
+          stack: zod.z.string().optional(),
+          stderr: zod.z.string().optional()
         })
       }),
       zod.z.object({
@@ -1170,7 +1285,6 @@ var PlatformToProviderMessages = {
       })
     ])
   },
-  // TODO: this should be a shared queue message instead
   RESTORE: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1190,23 +1304,19 @@ var PlatformToProviderMessages = {
       projectId: zod.z.string(),
       runId: zod.z.string()
     })
-  },
-  DELETE: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1"),
-      name: zod.z.string()
-    }),
-    callback: zod.z.object({
-      message: zod.z.string()
-    })
-  },
-  GET: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1"),
-      name: zod.z.string()
-    })
   }
 };
+var CreateWorkerMessage = zod.z.object({
+  projectRef: zod.z.string(),
+  envId: zod.z.string(),
+  deploymentId: zod.z.string(),
+  metadata: zod.z.object({
+    cliPackageVersion: zod.z.string().optional(),
+    contentHash: zod.z.string(),
+    packageVersion: zod.z.string(),
+    tasks: TaskResource.array()
+  })
+});
 var CoordinatorToPlatformMessages = {
   LOG: {
     message: zod.z.object({
@@ -1216,18 +1326,15 @@ var CoordinatorToPlatformMessages = {
     })
   },
   CREATE_WORKER: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1"),
-      projectRef: zod.z.string(),
-      envId: zod.z.string(),
-      deploymentId: zod.z.string(),
-      metadata: zod.z.object({
-        cliPackageVersion: zod.z.string().optional(),
-        contentHash: zod.z.string(),
-        packageVersion: zod.z.string(),
-        tasks: TaskResource.array()
+    message: zod.z.discriminatedUnion("version", [
+      CreateWorkerMessage.extend({
+        version: zod.z.literal("v1")
+      }),
+      CreateWorkerMessage.extend({
+        version: zod.z.literal("v2"),
+        supportsLazyAttempts: zod.z.boolean()
       })
-    }),
+    ]),
     callback: zod.z.discriminatedUnion("success", [
       zod.z.object({
         success: zod.z.literal(false)
@@ -1237,6 +1344,23 @@ var CoordinatorToPlatformMessages = {
       })
     ])
   },
+  CREATE_TASK_RUN_ATTEMPT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string(),
+      envId: zod.z.string()
+    }),
+    callback: zod.z.discriminatedUnion("success", [
+      zod.z.object({
+        success: zod.z.literal(false),
+        reason: zod.z.string().optional()
+      }),
+      zod.z.object({
+        success: zod.z.literal(true),
+        executionPayload: ProdTaskRunExecutionPayload
+      })
+    ])
+  },
   READY_FOR_EXECUTION: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1253,6 +1377,24 @@ var CoordinatorToPlatformMessages = {
       })
     ])
   },
+  READY_FOR_LAZY_ATTEMPT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string(),
+      envId: zod.z.string(),
+      totalCompletions: zod.z.number()
+    }),
+    callback: zod.z.discriminatedUnion("success", [
+      zod.z.object({
+        success: zod.z.literal(false),
+        reason: zod.z.string().optional()
+      }),
+      zod.z.object({
+        success: zod.z.literal(true),
+        lazyPayload: TaskRunExecutionLazyAttemptPayload
+      })
+    ])
+  },
   READY_FOR_RESUME: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1271,12 +1413,24 @@ var CoordinatorToPlatformMessages = {
       }).optional()
     })
   },
+  TASK_RUN_FAILED_TO_RUN: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      completion: TaskRunFailedExecutionResult
+    })
+  },
   TASK_HEARTBEAT: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
       attemptFriendlyId: zod.z.string()
     })
   },
+  TASK_RUN_HEARTBEAT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string()
+    })
+  },
   CHECKPOINT_CREATED: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1309,6 +1463,18 @@ var CoordinatorToPlatformMessages = {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
       deploymentId: zod.z.string(),
+      error: zod.z.object({
+        name: zod.z.string(),
+        message: zod.z.string(),
+        stack: zod.z.string().optional(),
+        stderr: zod.z.string().optional()
+      })
+    })
+  },
+  RUN_CRASHED: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string(),
       error: zod.z.object({
         name: zod.z.string(),
         message: zod.z.string(),
@@ -1342,6 +1508,13 @@ var PlatformToCoordinatorMessages = {
       attemptFriendlyId: zod.z.string()
     })
   },
+  REQUEST_RUN_CANCELLATION: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string(),
+      delayInMs: zod.z.number().optional()
+    })
+  },
   READY_FOR_RETRY: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1385,6 +1558,12 @@ var SharedQueueToClientMessages = {
     })
   }
 };
+var IndexTasksMessage = zod.z.object({
+  version: zod.z.literal("v1"),
+  deploymentId: zod.z.string(),
+  tasks: TaskResource.array(),
+  packageVersion: zod.z.string()
+});
 var ProdWorkerToCoordinatorMessages = {
   LOG: {
     message: zod.z.object({
@@ -1394,12 +1573,15 @@ var ProdWorkerToCoordinatorMessages = {
     callback: zod.z.void()
   },
   INDEX_TASKS: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1"),
-      deploymentId: zod.z.string(),
-      tasks: TaskResource.array(),
-      packageVersion: zod.z.string()
-    }),
+    message: zod.z.discriminatedUnion("version", [
+      IndexTasksMessage.extend({
+        version: zod.z.literal("v1")
+      }),
+      IndexTasksMessage.extend({
+        version: zod.z.literal("v2"),
+        supportsLazyAttempts: zod.z.boolean()
+      })
+    ]),
     callback: zod.z.discriminatedUnion("success", [
       zod.z.object({
         success: zod.z.literal(false)
@@ -1416,6 +1598,13 @@ var ProdWorkerToCoordinatorMessages = {
       totalCompletions: zod.z.number()
     })
   },
+  READY_FOR_LAZY_ATTEMPT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string(),
+      totalCompletions: zod.z.number()
+    })
+  },
   READY_FOR_RESUME: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1452,6 +1641,12 @@ var ProdWorkerToCoordinatorMessages = {
       attemptFriendlyId: zod.z.string()
     })
   },
+  TASK_RUN_HEARTBEAT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string()
+    })
+  },
   TASK_RUN_COMPLETED: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1463,6 +1658,12 @@ var ProdWorkerToCoordinatorMessages = {
       shouldExit: zod.z.boolean()
     })
   },
+  TASK_RUN_FAILED_TO_RUN: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      completion: TaskRunFailedExecutionResult
+    })
+  },
   WAIT_FOR_DURATION: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1501,6 +1702,33 @@ var ProdWorkerToCoordinatorMessages = {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
       deploymentId: zod.z.string(),
+      error: zod.z.object({
+        name: zod.z.string(),
+        message: zod.z.string(),
+        stack: zod.z.string().optional(),
+        stderr: zod.z.string().optional()
+      })
+    })
+  },
+  CREATE_TASK_RUN_ATTEMPT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      runId: zod.z.string()
+    }),
+    callback: zod.z.discriminatedUnion("success", [
+      zod.z.object({
+        success: zod.z.literal(false),
+        reason: zod.z.string().optional()
+      }),
+      zod.z.object({
+        success: zod.z.literal(true),
+        executionPayload: ProdTaskRunExecutionPayload
+      })
+    ])
+  },
+  UNRECOVERABLE_ERROR: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
       error: zod.z.object({
         name: zod.z.string(),
         message: zod.z.string(),
@@ -1530,6 +1758,12 @@ var CoordinatorToProdWorkerMessages = {
       executionPayload: ProdTaskRunExecutionPayload
     })
   },
+  EXECUTE_TASK_RUN_LAZY_ATTEMPT: {
+    message: zod.z.object({
+      version: zod.z.literal("v1").default("v1"),
+      lazyPayload: TaskRunExecutionLazyAttemptPayload
+    })
+  },
   REQUEST_ATTEMPT_CANCELLATION: {
     message: zod.z.object({
       version: zod.z.literal("v1").default("v1"),
@@ -1537,9 +1771,15 @@ var CoordinatorToProdWorkerMessages = {
     })
   },
   REQUEST_EXIT: {
-    message: zod.z.object({
-      version: zod.z.literal("v1").default("v1")
-    })
+    message: zod.z.discriminatedUnion("version", [
+      zod.z.object({
+        version: zod.z.literal("v1")
+      }),
+      zod.z.object({
+        version: zod.z.literal("v2"),
+        delayInMs: zod.z.number().optional()
+      })
+    ])
   },
   READY_FOR_RETRY: {
     message: zod.z.object({
@@ -1904,15 +2144,153 @@ var _TaskContextAPI = class _TaskContextAPI {
     return registerGlobal(API_NAME, taskContext2);
   }
 };
-_getTaskContext = new WeakSet();
-getTaskContext_fn = /* @__PURE__ */ __name(function() {
-  return getGlobal(API_NAME);
-}, "#getTaskContext");
-__name(_TaskContextAPI, "TaskContextAPI");
-var TaskContextAPI = _TaskContextAPI;
-
-// src/v3/task-context-api.ts
-var taskContext = TaskContextAPI.getInstance();
+_getTaskContext = new WeakSet();
+getTaskContext_fn = /* @__PURE__ */ __name(function() {
+  return getGlobal(API_NAME);
+}, "#getTaskContext");
+__name(_TaskContextAPI, "TaskContextAPI");
+var TaskContextAPI = _TaskContextAPI;
+
+// src/v3/task-context-api.ts
+var taskContext = TaskContextAPI.getInstance();
+
+// src/v3/apiClient/errors.ts
+var _ApiError = class _ApiError extends Error {
+  constructor(status, error, message, headers) {
+    super(`${_ApiError.makeMessage(status, error, message)}`);
+    this.status = status;
+    this.headers = headers;
+    const data = error;
+    this.error = data;
+    this.code = data?.["code"];
+    this.param = data?.["param"];
+    this.type = data?.["type"];
+  }
+  static makeMessage(status, error, message) {
+    const msg = error?.message ? typeof error.message === "string" ? error.message : JSON.stringify(error.message) : error ? JSON.stringify(error) : message;
+    if (status && msg) {
+      return `${status} ${msg}`;
+    }
+    if (status) {
+      return `${status} status code (no body)`;
+    }
+    if (msg) {
+      return msg;
+    }
+    return "(no status code or body)";
+  }
+  static generate(status, errorResponse, message, headers) {
+    if (!status) {
+      return new ApiConnectionError({
+        cause: castToError(errorResponse)
+      });
+    }
+    const error = errorResponse?.["error"];
+    if (status === 400) {
+      return new BadRequestError(status, error, message, headers);
+    }
+    if (status === 401) {
+      return new AuthenticationError(status, error, message, headers);
+    }
+    if (status === 403) {
+      return new PermissionDeniedError(status, error, message, headers);
+    }
+    if (status === 404) {
+      return new NotFoundError(status, error, message, headers);
+    }
+    if (status === 409) {
+      return new ConflictError(status, error, message, headers);
+    }
+    if (status === 422) {
+      return new UnprocessableEntityError(status, error, message, headers);
+    }
+    if (status === 429) {
+      return new RateLimitError(status, error, message, headers);
+    }
+    if (status >= 500) {
+      return new InternalServerError(status, error, message, headers);
+    }
+    return new _ApiError(status, error, message, headers);
+  }
+};
+__name(_ApiError, "ApiError");
+var ApiError = _ApiError;
+var _ApiConnectionError = class _ApiConnectionError extends ApiError {
+  constructor({ message, cause }) {
+    super(void 0, void 0, message || "Connection error.", void 0);
+    __publicField(this, "status");
+    if (cause)
+      this.cause = cause;
+  }
+};
+__name(_ApiConnectionError, "ApiConnectionError");
+var ApiConnectionError = _ApiConnectionError;
+var _BadRequestError = class _BadRequestError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 400);
+  }
+};
+__name(_BadRequestError, "BadRequestError");
+var BadRequestError = _BadRequestError;
+var _AuthenticationError = class _AuthenticationError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 401);
+  }
+};
+__name(_AuthenticationError, "AuthenticationError");
+var AuthenticationError = _AuthenticationError;
+var _PermissionDeniedError = class _PermissionDeniedError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 403);
+  }
+};
+__name(_PermissionDeniedError, "PermissionDeniedError");
+var PermissionDeniedError = _PermissionDeniedError;
+var _NotFoundError = class _NotFoundError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 404);
+  }
+};
+__name(_NotFoundError, "NotFoundError");
+var NotFoundError = _NotFoundError;
+var _ConflictError = class _ConflictError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 409);
+  }
+};
+__name(_ConflictError, "ConflictError");
+var ConflictError = _ConflictError;
+var _UnprocessableEntityError = class _UnprocessableEntityError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 422);
+  }
+};
+__name(_UnprocessableEntityError, "UnprocessableEntityError");
+var UnprocessableEntityError = _UnprocessableEntityError;
+var _RateLimitError = class _RateLimitError extends ApiError {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "status", 429);
+  }
+};
+__name(_RateLimitError, "RateLimitError");
+var RateLimitError = _RateLimitError;
+var _InternalServerError = class _InternalServerError extends ApiError {
+};
+__name(_InternalServerError, "InternalServerError");
+var InternalServerError = _InternalServerError;
+function castToError(err) {
+  if (err instanceof Error)
+    return err;
+  return new Error(err);
+}
+__name(castToError, "castToError");
 
 // src/retry.ts
 function calculateResetAt(resets, format, now = /* @__PURE__ */ new Date()) {
@@ -2020,6 +2398,108 @@ function calculateResetAt2(resets, format, now = Date.now()) {
   return resetAt?.getTime();
 }
 __name(calculateResetAt2, "calculateResetAt");
+
+// src/v3/apiClient/pagination.ts
+var _CursorPage = class _CursorPage {
+  constructor(data, pagination, pageFetcher) {
+    this.pageFetcher = pageFetcher;
+    this.data = data;
+    this.pagination = pagination;
+  }
+  getPaginatedItems() {
+    return this.data ?? [];
+  }
+  hasNextPage() {
+    return !!this.pagination.next;
+  }
+  hasPreviousPage() {
+    return !!this.pagination.previous;
+  }
+  getNextPage() {
+    if (!this.pagination.next) {
+      throw new Error("No next page available");
+    }
+    return this.pageFetcher({
+      after: this.pagination.next
+    });
+  }
+  getPreviousPage() {
+    if (!this.pagination.previous) {
+      throw new Error("No previous page available");
+    }
+    return this.pageFetcher({
+      before: this.pagination.previous
+    });
+  }
+  async *iterPages() {
+    let page = this;
+    yield page;
+    while (page.hasNextPage()) {
+      page = await page.getNextPage();
+      yield page;
+    }
+  }
+  async *[Symbol.asyncIterator]() {
+    for await (const page of this.iterPages()) {
+      for (const item of page.getPaginatedItems()) {
+        yield item;
+      }
+    }
+  }
+};
+__name(_CursorPage, "CursorPage");
+var CursorPage = _CursorPage;
+var _OffsetLimitPage = class _OffsetLimitPage {
+  constructor(data, pagination, pageFetcher) {
+    this.pageFetcher = pageFetcher;
+    this.data = data;
+    this.pagination = pagination;
+  }
+  getPaginatedItems() {
+    return this.data ?? [];
+  }
+  hasNextPage() {
+    return this.pagination.currentPage < this.pagination.totalPages;
+  }
+  hasPreviousPage() {
+    return this.pagination.currentPage > 1;
+  }
+  getNextPage() {
+    if (!this.hasNextPage()) {
+      throw new Error("No next page available");
+    }
+    return this.pageFetcher({
+      page: this.pagination.currentPage + 1
+    });
+  }
+  getPreviousPage() {
+    if (!this.hasPreviousPage()) {
+      throw new Error("No previous page available");
+    }
+    return this.pageFetcher({
+      page: this.pagination.currentPage - 1
+    });
+  }
+  async *iterPages() {
+    let page = this;
+    yield page;
+    while (page.hasNextPage()) {
+      page = await page.getNextPage();
+      yield page;
+    }
+  }
+  async *[Symbol.asyncIterator]() {
+    for await (const page of this.iterPages()) {
+      for (const item of page.getPaginatedItems()) {
+        yield item;
+      }
+    }
+  }
+};
+__name(_OffsetLimitPage, "OffsetLimitPage");
+var OffsetLimitPage = _OffsetLimitPage;
+
+// src/v3/apiClient/core.ts
 var defaultRetryOptions2 = {
   maxAttempts: 3,
   factor: 2,
@@ -2027,11 +2507,62 @@ var defaultRetryOptions2 = {
   maxTimeoutInMs: 6e4,
   randomize: false
 };
-async function zodfetch(schema, url, requestInit, options) {
-  return await _doZodFetch(schema, url, requestInit, options);
+function zodfetch(schema, url, requestInit, options) {
+  return new ApiPromise(_doZodFetch(schema, url, requestInit, options));
 }
 __name(zodfetch, "zodfetch");
-async function zodupload(schema, url, body, requestInit, options) {
+function zodfetchCursorPage(schema, url, params, requestInit, options) {
+  const query = new URLSearchParams(params.query);
+  if (params.limit) {
+    query.set("page[size]", String(params.limit));
+  }
+  if (params.after) {
+    query.set("page[after]", params.after);
+  }
+  if (params.before) {
+    query.set("page[before]", params.before);
+  }
+  const cursorPageSchema = zod.z.object({
+    data: zod.z.array(schema),
+    pagination: zod.z.object({
+      next: zod.z.string().optional(),
+      previous: zod.z.string().optional()
+    })
+  });
+  const $url = new URL(url);
+  $url.search = query.toString();
+  const fetchResult = _doZodFetch(cursorPageSchema, $url.href, requestInit, options);
+  return new CursorPagePromise(fetchResult, schema, url, params, requestInit, options);
+}
+__name(zodfetchCursorPage, "zodfetchCursorPage");
+function zodfetchOffsetLimitPage(schema, url, params, requestInit, options) {
+  const query = new URLSearchParams(params.query);
+  if (params.limit) {
+    query.set("perPage", String(params.limit));
+  }
+  if (params.page) {
+    query.set("page", String(params.page));
+  }
+  const offsetLimitPageSchema = zod.z.object({
+    data: zod.z.array(schema),
+    pagination: zod.z.object({
+      currentPage: zod.z.coerce.number(),
+      totalPages: zod.z.coerce.number(),
+      count: zod.z.coerce.number()
+    })
+  });
+  const $url = new URL(url);
+  $url.search = query.toString();
+  const fetchResult = _doZodFetch(offsetLimitPageSchema, $url.href, requestInit, options);
+  return new OffsetLimitPagePromise(fetchResult, schema, url, params, requestInit, options);
+}
+__name(zodfetchOffsetLimitPage, "zodfetchOffsetLimitPage");
+function zodupload(schema, url, body, requestInit, options) {
+  const finalRequestInit = createMultipartFormRequestInit(body, requestInit);
+  return new ApiPromise(_doZodFetch(schema, url, finalRequestInit, options));
+}
+__name(zodupload, "zodupload");
+async function createMultipartFormRequestInit(body, requestInit) {
   const form = await createForm(body);
   const encoder = new formDataEncoder.FormDataEncoder(form);
   const finalHeaders = {};
@@ -2049,9 +2580,9 @@ async function zodupload(schema, url, body, requestInit, options) {
     // @ts-expect-error
     duplex: "half"
   };
-  return await _doZodFetch(schema, url, finalRequestInit, options);
+  return finalRequestInit;
 }
-__name(zodupload, "zodupload");
+__name(createMultipartFormRequestInit, "createMultipartFormRequestInit");
 var createForm = /* @__PURE__ */ __name(async (body) => {
   const form = new FormData();
   await Promise.all(Object.entries(body || {}).map(([key, value]) => addFormValue(form, key, value)));
@@ -2059,7 +2590,8 @@ var createForm = /* @__PURE__ */ __name(async (body) => {
 }, "createForm");
 async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
   try {
-    const response = await fetch(url, requestInitWithCache(requestInit));
+    const $requestInit = await requestInit;
+    const response = await fetch(url, requestInitWithCache($requestInit));
     const responseHeaders = createResponseHeaders(response.headers);
     if (!response.ok) {
       const retryResult = shouldRetry(response, attempt, options?.retry);
@@ -2070,17 +2602,20 @@ async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
         const errText = await response.text().catch((e) => castToError2(e).message);
         const errJSON = safeJsonParse(errText);
         const errMessage = errJSON ? void 0 : errText;
-        throw APIError.generate(response.status, errJSON, errMessage, responseHeaders);
+        throw ApiError.generate(response.status, errJSON, errMessage, responseHeaders);
       }
     }
     const jsonBody = await response.json();
     const parsedResult = schema.safeParse(jsonBody);
     if (parsedResult.success) {
-      return parsedResult.data;
+      return {
+        data: parsedResult.data,
+        response
+      };
     }
     throw zodValidationError.fromZodError(parsedResult.error);
   } catch (error) {
-    if (error instanceof APIError) {
+    if (error instanceof ApiError) {
       throw error;
     }
     if (options?.retry) {
@@ -2094,7 +2629,7 @@ async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
         return await _doZodFetch(schema, url, requestInit, options, attempt + 1);
       }
     }
-    throw new APIConnectionError({
+    throw new ApiConnectionError({
       cause: castToError2(error)
     });
   }
@@ -2267,6 +2802,128 @@ var isUploadable = /* @__PURE__ */ __name((value) => {
   return isFileLike(value) || isResponseLike(value) || isFsReadStream(value);
 }, "isUploadable");
 var isRecordLike = /* @__PURE__ */ __name((value) => value != null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length > 0 && Object.keys(value).every((key) => typeof key === "string" && typeof value[key] === "string"), "isRecordLike");
+var _ApiPromise = class _ApiPromise extends Promise {
+  constructor(responsePromise) {
+    super((resolve) => {
+      resolve(null);
+    });
+    this.responsePromise = responsePromise;
+  }
+  /**
+  * Gets the raw `Response` instance instead of parsing the response
+  * data.
+  *
+  * If you want to parse the response body but still get the `Response`
+  * instance, you can use {@link withResponse()}.
+  */
+  asResponse() {
+    return this.responsePromise.then((p) => p.response);
+  }
+  /**
+  * Gets the parsed response data and the raw `Response` instance.
+  *
+  * If you just want to get the raw `Response` instance without parsing it,
+  * you can use {@link asResponse()}.
+  */
+  async withResponse() {
+    const [data, response] = await Promise.all([
+      this.parse(),
+      this.asResponse()
+    ]);
+    return {
+      data,
+      response
+    };
+  }
+  parse() {
+    return this.responsePromise.then((result) => result.data);
+  }
+  then(onfulfilled, onrejected) {
+    return this.parse().then(onfulfilled, onrejected);
+  }
+  catch(onrejected) {
+    return this.parse().catch(onrejected);
+  }
+  finally(onfinally) {
+    return this.parse().finally(onfinally);
+  }
+};
+__name(_ApiPromise, "ApiPromise");
+var ApiPromise = _ApiPromise;
+var _fetchPage, fetchPage_fn;
+var _CursorPagePromise = class _CursorPagePromise extends ApiPromise {
+  constructor(result, schema, url, params, requestInit, options) {
+    super(result.then((result2) => ({
+      data: new CursorPage(result2.data.data, result2.data.pagination, __privateMethod(this, _fetchPage, fetchPage_fn).bind(this)),
+      response: result2.response
+    })));
+    __privateAdd(this, _fetchPage);
+    this.schema = schema;
+    this.url = url;
+    this.params = params;
+    this.requestInit = requestInit;
+    this.options = options;
+  }
+  /**
+  * Allow auto-paginating iteration on an unawaited list call, eg:
+  *
+  *    for await (const item of client.items.list()) {
+  *      console.log(item)
+  *    }
+  */
+  async *[Symbol.asyncIterator]() {
+    const page = await this;
+    for await (const item of page) {
+      yield item;
+    }
+  }
+};
+_fetchPage = new WeakSet();
+fetchPage_fn = /* @__PURE__ */ __name(function(params) {
+  return zodfetchCursorPage(this.schema, this.url, {
+    ...this.params,
+    ...params
+  }, this.requestInit, this.options);
+}, "#fetchPage");
+__name(_CursorPagePromise, "CursorPagePromise");
+var CursorPagePromise = _CursorPagePromise;
+var _fetchPage2, fetchPage_fn2;
+var _OffsetLimitPagePromise = class _OffsetLimitPagePromise extends ApiPromise {
+  constructor(result, schema, url, params, requestInit, options) {
+    super(result.then((result2) => ({
+      data: new OffsetLimitPage(result2.data.data, result2.data.pagination, __privateMethod(this, _fetchPage2, fetchPage_fn2).bind(this)),
+      response: result2.response
+    })));
+    __privateAdd(this, _fetchPage2);
+    this.schema = schema;
+    this.url = url;
+    this.params = params;
+    this.requestInit = requestInit;
+    this.options = options;
+  }
+  /**
+  * Allow auto-paginating iteration on an unawaited list call, eg:
+  *
+  *    for await (const item of client.items.list()) {
+  *      console.log(item)
+  *    }
+  */
+  async *[Symbol.asyncIterator]() {
+    const page = await this;
+    for await (const item of page) {
+      yield item;
+    }
+  }
+};
+_fetchPage2 = new WeakSet();
+fetchPage_fn2 = /* @__PURE__ */ __name(function(params1) {
+  return zodfetchOffsetLimitPage(this.schema, this.url, {
+    ...this.params,
+    ...params1
+  }, this.requestInit, this.options);
+}, "#fetchPage");
+__name(_OffsetLimitPagePromise, "OffsetLimitPagePromise");
+var OffsetLimitPagePromise = _OffsetLimitPagePromise;
 
 // src/v3/apiClient/index.ts
 var zodFetchOptions = {
@@ -2292,7 +2949,7 @@ var _ApiClient = class _ApiClient {
         headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
       }, zodFetchOptions);
     } catch (error) {
-      if (error instanceof APIError) {
+      if (error instanceof ApiError) {
         if (error.status === 404) {
           return void 0;
         }
@@ -2307,14 +2964,16 @@ var _ApiClient = class _ApiClient {
     }, zodFetchOptions);
   }
   triggerTask(taskId, body, options) {
-    return zodfetch(TriggerTaskResponse, `${this.baseUrl}/api/v1/tasks/${taskId}/trigger`, {
+    const encodedTaskId = encodeURIComponent(taskId);
+    return zodfetch(TriggerTaskResponse, `${this.baseUrl}/api/v1/tasks/${encodedTaskId}/trigger`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, options?.spanParentAsLink ?? false),
       body: JSON.stringify(body)
     }, zodFetchOptions);
   }
   batchTriggerTask(taskId, body, options) {
-    return zodfetch(BatchTriggerTaskResponse, `${this.baseUrl}/api/v1/tasks/${taskId}/batch`, {
+    const encodedTaskId = encodeURIComponent(taskId);
+    return zodfetch(BatchTriggerTaskResponse, `${this.baseUrl}/api/v1/tasks/${encodedTaskId}/batch`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, options?.spanParentAsLink ?? false),
       body: JSON.stringify(body)
@@ -2338,6 +2997,33 @@ var _ApiClient = class _ApiClient {
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
     }, zodFetchOptions);
   }
+  listRuns(query) {
+    const searchParams = createSearchQueryForListRuns(query);
+    return zodfetchCursorPage(ListRunResponseItem, `${this.baseUrl}/api/v1/runs`, {
+      query: searchParams,
+      limit: query?.limit,
+      after: query?.after,
+      before: query?.before
+    }, {
+      method: "GET",
+      headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
+    }, zodFetchOptions);
+  }
+  listProjectRuns(projectRef, query) {
+    const searchParams = createSearchQueryForListRuns(query);
+    if (query?.env) {
+      searchParams.append("filter[env]", Array.isArray(query.env) ? query.env.join(",") : query.env);
+    }
+    return zodfetchCursorPage(ListRunResponseItem, `${this.baseUrl}/api/v1/projects/${projectRef}/runs`, {
+      query: searchParams,
+      limit: query?.limit,
+      after: query?.after,
+      before: query?.before
+    }, {
+      method: "GET",
+      headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
+    }, zodFetchOptions);
+  }
   replayRun(runId) {
     return zodfetch(ReplayRunResponse, `${this.baseUrl}/api/v1/runs/${runId}/replay`, {
       method: "POST",
@@ -2365,7 +3051,10 @@ var _ApiClient = class _ApiClient {
     if (options?.perPage) {
       searchParams.append("perPage", options.perPage.toString());
     }
-    return zodfetch(ListSchedulesResult, `${this.baseUrl}/api/v1/schedules${searchParams.size > 0 ? `?${searchParams}` : ""}`, {
+    return zodfetchOffsetLimitPage(ScheduleObject, `${this.baseUrl}/api/v1/schedules`, {
+      page: options?.page,
+      limit: options?.perPage
+    }, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
     });
@@ -2466,6 +3155,40 @@ getHeaders_fn = /* @__PURE__ */ __name(function(spanParentAsLink) {
 }, "#getHeaders");
 __name(_ApiClient, "ApiClient");
 var ApiClient = _ApiClient;
+function createSearchQueryForListRuns(query) {
+  const searchParams = new URLSearchParams();
+  if (query) {
+    if (query.status) {
+      searchParams.append("filter[status]", Array.isArray(query.status) ? query.status.join(",") : query.status);
+    }
+    if (query.taskIdentifier) {
+      searchParams.append("filter[taskIdentifier]", Array.isArray(query.taskIdentifier) ? query.taskIdentifier.join(",") : query.taskIdentifier);
+    }
+    if (query.version) {
+      searchParams.append("filter[version]", Array.isArray(query.version) ? query.version.join(",") : query.version);
+    }
+    if (query.bulkAction) {
+      searchParams.append("filter[bulkAction]", query.bulkAction);
+    }
+    if (query.schedule) {
+      searchParams.append("filter[schedule]", query.schedule);
+    }
+    if (typeof query.isTest === "boolean") {
+      searchParams.append("filter[isTest]", String(query.isTest));
+    }
+    if (query.from) {
+      searchParams.append("filter[createdAt][from]", query.from instanceof Date ? query.from.getTime().toString() : query.from.toString());
+    }
+    if (query.to) {
+      searchParams.append("filter[createdAt][to]", query.to instanceof Date ? query.to.getTime().toString() : query.to.toString());
+    }
+    if (query.period) {
+      searchParams.append("filter[createdAt][period]", query.period);
+    }
+  }
+  return searchParams;
+}
+__name(createSearchQueryForListRuns, "createSearchQueryForListRuns");
 var _SimpleClock = class _SimpleClock {
   preciseNow() {
     const now = new preciseDate.PreciseDate();
@@ -2515,145 +3238,6 @@ var ClockAPI = _ClockAPI;
 // src/v3/clock-api.ts
 var clock = ClockAPI.getInstance();
 
-// src/v3/errors.ts
-function parseError(error) {
-  if (error instanceof Error) {
-    return {
-      type: "BUILT_IN_ERROR",
-      name: error.name,
-      message: error.message,
-      stackTrace: error.stack ?? ""
-    };
-  }
-  if (typeof error === "string") {
-    return {
-      type: "STRING_ERROR",
-      raw: error
-    };
-  }
-  try {
-    return {
-      type: "CUSTOM_ERROR",
-      raw: JSON.stringify(error)
-    };
-  } catch (e) {
-    return {
-      type: "CUSTOM_ERROR",
-      raw: String(error)
-    };
-  }
-}
-__name(parseError, "parseError");
-function createErrorTaskError(error) {
-  switch (error.type) {
-    case "BUILT_IN_ERROR": {
-      const e = new Error(error.message);
-      e.name = error.name;
-      e.stack = error.stackTrace;
-      return e;
-    }
-    case "STRING_ERROR": {
-      return error.raw;
-    }
-    case "CUSTOM_ERROR": {
-      return JSON.parse(error.raw);
-    }
-    case "INTERNAL_ERROR": {
-      return new Error(`trigger.dev internal error (${error.code})`);
-    }
-  }
-}
-__name(createErrorTaskError, "createErrorTaskError");
-function createJsonErrorObject(error) {
-  switch (error.type) {
-    case "BUILT_IN_ERROR": {
-      return {
-        name: error.name,
-        message: error.message,
-        stackTrace: error.stackTrace
-      };
-    }
-    case "STRING_ERROR": {
-      return {
-        message: error.raw
-      };
-    }
-    case "CUSTOM_ERROR": {
-      return {
-        message: error.raw
-      };
-    }
-    case "INTERNAL_ERROR": {
-      return {
-        message: `trigger.dev internal error (${error.code})`
-      };
-    }
-  }
-}
-__name(createJsonErrorObject, "createJsonErrorObject");
-function correctErrorStackTrace(stackTrace, projectDir, options) {
-  const [errorLine, ...traceLines] = stackTrace.split("\n");
-  return [
-    options?.removeFirstLine ? void 0 : errorLine,
-    ...traceLines.map((line) => correctStackTraceLine(line, projectDir))
-  ].filter(Boolean).join("\n");
-}
-__name(correctErrorStackTrace, "correctErrorStackTrace");
-var LINES_TO_IGNORE = [
-  /ConsoleInterceptor/,
-  /TriggerTracer/,
-  /TaskExecutor/,
-  /EXECUTE_TASK_RUN/,
-  /@trigger.dev\/core/,
-  /safeJsonProcess/,
-  /__entryPoint.ts/
-];
-function correctStackTraceLine(line, projectDir) {
-  if (LINES_TO_IGNORE.some((regex) => regex.test(line))) {
-    return;
-  }
-  if (projectDir && !line.includes(projectDir)) {
-    return;
-  }
-  return line.trim();
-}
-__name(correctStackTraceLine, "correctStackTraceLine");
-function groupTaskMetadataIssuesByTask(tasks, issues) {
-  return issues.reduce((acc, issue) => {
-    if (issue.path.length === 0) {
-      return acc;
-    }
-    const taskIndex = issue.path[1];
-    if (typeof taskIndex !== "number") {
-      return acc;
-    }
-    const task = tasks[taskIndex];
-    if (!task) {
-      return acc;
-    }
-    const restOfPath = issue.path.slice(2);
-    const taskId = task.id;
-    const taskName = task.exportName;
-    const filePath = task.filePath;
-    const key = taskIndex;
-    const existing = acc[key] ?? {
-      id: taskId,
-      exportName: taskName,
-      filePath,
-      issues: []
-    };
-    existing.issues.push({
-      message: issue.message,
-      path: restOfPath.length === 0 ? void 0 : restOfPath.join(".")
-    });
-    return {
-      ...acc,
-      [key]: existing
-    };
-  }, {});
-}
-__name(groupTaskMetadataIssuesByTask, "groupTaskMetadataIssuesByTask");
-
 // src/v3/limits.ts
 var OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = 256;
 var OTEL_LOG_ATTRIBUTE_COUNT_LIMIT = 256;
@@ -3685,9 +4269,9 @@ function safeJsonParse2(value) {
 }
 __name(safeJsonParse2, "safeJsonParse");
 
-exports.APIConnectionError = APIConnectionError;
-exports.APIError = APIError;
 exports.ApiClient = ApiClient;
+exports.ApiConnectionError = ApiConnectionError;
+exports.ApiError = ApiError;
 exports.AttemptStatus = AttemptStatus;
 exports.AuthenticationError = AuthenticationError;
 exports.BackgroundWorkerClientMessages = BackgroundWorkerClientMessages;
@@ -3711,6 +4295,7 @@ exports.CreateBackgroundWorkerResponse = CreateBackgroundWorkerResponse;
 exports.CreateEnvironmentVariableRequestBody = CreateEnvironmentVariableRequestBody;
 exports.CreateScheduleOptions = CreateScheduleOptions;
 exports.CreateUploadPayloadUrlResponseBody = CreateUploadPayloadUrlResponseBody;
+exports.CursorPage = CursorPage;
 exports.DeletedScheduleObject = DeletedScheduleObject;
 exports.DeploymentErrorData = DeploymentErrorData;
 exports.EnvironmentType = EnvironmentType;
@@ -3742,6 +4327,8 @@ exports.ImportEnvironmentVariablesRequestBody = ImportEnvironmentVariablesReques
 exports.InitializeDeploymentRequestBody = InitializeDeploymentRequestBody;
 exports.InitializeDeploymentResponseBody = InitializeDeploymentResponseBody;
 exports.InternalServerError = InternalServerError;
+exports.ListRunResponse = ListRunResponse;
+exports.ListRunResponseItem = ListRunResponseItem;
 exports.ListScheduleOptions = ListScheduleOptions;
 exports.ListSchedulesResult = ListSchedulesResult;
 exports.Machine = Machine;
@@ -3758,6 +4345,7 @@ exports.OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT = OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_
 exports.OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT;
 exports.OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT = OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT;
 exports.OTEL_SPAN_EVENT_COUNT_LIMIT = OTEL_SPAN_EVENT_COUNT_LIMIT;
+exports.OffsetLimitPage = OffsetLimitPage;
 exports.OtherSpanEvent = OtherSpanEvent;
 exports.PRIMARY_VARIANT = PRIMARY_VARIANT;
 exports.PermissionDeniedError = PermissionDeniedError;
@@ -3778,10 +4366,14 @@ exports.RateLimitOptions = RateLimitOptions;
 exports.ReplayRunResponse = ReplayRunResponse;
 exports.RetrieveRunResponse = RetrieveRunResponse;
 exports.RetryOptions = RetryOptions;
+exports.RunEnvironmentDetails = RunEnvironmentDetails;
+exports.RunScheduleDetails = RunScheduleDetails;
 exports.RunStatus = RunStatus;
+exports.ScheduleGenerator = ScheduleGenerator;
 exports.ScheduleObject = ScheduleObject;
 exports.ScheduledTaskPayload = ScheduledTaskPayload;
 exports.SemanticInternalAttributes = SemanticInternalAttributes;
+exports.SerializedError = SerializedError;
 exports.SharedQueueToClientMessages = SharedQueueToClientMessages;
 exports.SlidingWindowRateLimit = SlidingWindowRateLimit;
 exports.SpanEvent = SpanEvent;
@@ -3805,6 +4397,7 @@ exports.TaskRunExecution = TaskRunExecution;
 exports.TaskRunExecutionAttempt = TaskRunExecutionAttempt;
 exports.TaskRunExecutionBatch = TaskRunExecutionBatch;
 exports.TaskRunExecutionEnvironment = TaskRunExecutionEnvironment;
+exports.TaskRunExecutionLazyAttemptPayload = TaskRunExecutionLazyAttemptPayload;
 exports.TaskRunExecutionOrganization = TaskRunExecutionOrganization;
 exports.TaskRunExecutionPayload = TaskRunExecutionPayload;
 exports.TaskRunExecutionProject = TaskRunExecutionProject;