@trigger.dev/core 0.0.0-prerelease-20240603154820 → 0.0.0-prerelease-20240723165848

package/dist/v3/workers/index.mjs

@@ -9,10 +9,9 @@ import { LoggerProvider, BatchLogRecordProcessor, SimpleLogRecordProcessor } fro
 import { NodeTracerProvider, BatchSpanProcessor, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-node';
 import { SemanticResourceAttributes } from '@opentelemetry/semantic-conventions';
 import { fromZodError } from 'zod-validation-error';
-import { FormDataEncoder } from 'form-data-encoder';
-import { Readable } from 'node:stream';
 import { PreciseDate } from '@google-cloud/precise-date';
 import util from 'node:util';
+import { setInterval } from 'node:timers/promises';
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -71,6 +70,39 @@ var SerializedError = z.object({
   name: z.string().optional(),
   stackTrace: z.string().optional()
 });
+function sanitizeError(error) {
+  switch (error.type) {
+    case "BUILT_IN_ERROR": {
+      return {
+        type: "BUILT_IN_ERROR",
+        message: error.message?.replace(/\0/g, ""),
+        name: error.name?.replace(/\0/g, ""),
+        stackTrace: error.stackTrace?.replace(/\0/g, "")
+      };
+    }
+    case "STRING_ERROR": {
+      return {
+        type: "STRING_ERROR",
+        raw: error.raw.replace(/\0/g, "")
+      };
+    }
+    case "CUSTOM_ERROR": {
+      return {
+        type: "CUSTOM_ERROR",
+        raw: error.raw.replace(/\0/g, "")
+      };
+    }
+    case "INTERNAL_ERROR": {
+      return {
+        type: "INTERNAL_ERROR",
+        code: error.code,
+        message: error.message?.replace(/\0/g, ""),
+        stackTrace: error.stackTrace?.replace(/\0/g, "")
+      };
+    }
+  }
+}
+__name(sanitizeError, "sanitizeError");
 
 // src/v3/limits.ts
 var OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = 256;
@@ -104,6 +136,10 @@ var SemanticInternalAttributes = {
   TASK_EXPORT_NAME: "ctx.task.exportName",
   QUEUE_NAME: "ctx.queue.name",
   QUEUE_ID: "ctx.queue.id",
+  MACHINE_PRESET_NAME: "ctx.machine.name",
+  MACHINE_PRESET_CPU: "ctx.machine.cpu",
+  MACHINE_PRESET_MEMORY: "ctx.machine.memory",
+  MACHINE_PRESET_CENTS_PER_MS: "ctx.machine.centsPerMs",
   SPAN_PARTIAL: "$span.partial",
   SPAN_ID: "$span.span_id",
   OUTPUT: "$output",
@@ -127,7 +163,12 @@ var SemanticInternalAttributes = {
   RETRY_DELAY: "retry.delay",
   RETRY_COUNT: "retry.count",
   LINK_TITLE: "$link.title",
-  IDEMPOTENCY_KEY: "ctx.run.idempotencyKey"
+  IDEMPOTENCY_KEY: "ctx.run.idempotencyKey",
+  USAGE_DURATION_MS: "$usage.durationMs",
+  USAGE_COST_IN_CENTS: "$usage.costInCents",
+  RATE_LIMIT_LIMIT: "response.rateLimit.limit",
+  RATE_LIMIT_REMAINING: "response.rateLimit.remaining",
+  RATE_LIMIT_RESET: "response.rateLimit.reset"
 };
 
 // src/v3/utils/flattenAttributes.ts
@@ -273,7 +314,11 @@ var _TaskContextAPI = class _TaskContextAPI {
         [SemanticInternalAttributes.ORGANIZATION_SLUG]: this.ctx.organization.slug,
         [SemanticInternalAttributes.ORGANIZATION_NAME]: this.ctx.organization.name,
         [SemanticInternalAttributes.BATCH_ID]: this.ctx.batch?.id,
-        [SemanticInternalAttributes.IDEMPOTENCY_KEY]: this.ctx.run.idempotencyKey
+        [SemanticInternalAttributes.IDEMPOTENCY_KEY]: this.ctx.run.idempotencyKey,
+        [SemanticInternalAttributes.MACHINE_PRESET_NAME]: this.ctx.machine?.name,
+        [SemanticInternalAttributes.MACHINE_PRESET_CPU]: this.ctx.machine?.cpu,
+        [SemanticInternalAttributes.MACHINE_PRESET_MEMORY]: this.ctx.machine?.memory,
+        [SemanticInternalAttributes.MACHINE_PRESET_CENTS_PER_MS]: this.ctx.machine?.centsPerMs
       };
     }
     return {};
@@ -355,7 +400,7 @@ function getEnvVar(name) {
 __name(getEnvVar, "getEnvVar");
 
 // package.json
-var version = "0.0.0-prerelease-20240603154820";
+var version = "0.0.0-prerelease-20240723165848";
 
 // src/v3/otel/tracingSDK.ts
 var _a;
@@ -398,7 +443,7 @@ var _TracingSDK = class _TracingSDK {
       [SemanticInternalAttributes.CLI_VERSION]: version
     })).merge(config.resource ?? new Resource({})).merge(new Resource(envResourceAttributes));
     const traceProvider = new NodeTracerProvider({
-      forceFlushTimeoutMillis: config.forceFlushTimeoutMillis ?? 500,
+      forceFlushTimeoutMillis: config.forceFlushTimeoutMillis,
       resource: commonResources,
       spanLimits: {
         attributeCountLimit: OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT,
@@ -411,7 +456,7 @@ var _TracingSDK = class _TracingSDK {
     });
     const spanExporter = new OTLPTraceExporter({
       url: `${config.url}/v1/traces`,
-      timeoutMillis: config.forceFlushTimeoutMillis ?? 1e3
+      timeoutMillis: config.forceFlushTimeoutMillis
     });
     traceProvider.addSpanProcessor(new TaskContextSpanProcessor(getEnvVar("OTEL_BATCH_PROCESSING_ENABLED") === "1" ? new BatchSpanProcessor(spanExporter, {
       maxExportBatchSize: parseInt(getEnvVar("OTEL_SPAN_MAX_EXPORT_BATCH_SIZE") ?? "64"),
@@ -448,12 +493,16 @@ var _TracingSDK = class _TracingSDK {
     this.getTracer = traceProvider.getTracer.bind(traceProvider);
   }
   async flush() {
-    await this._traceProvider.forceFlush();
-    await this._logProvider.forceFlush();
+    await Promise.all([
+      this._traceProvider.forceFlush(),
+      this._logProvider.forceFlush()
+    ]);
   }
   async shutdown() {
-    await this._traceProvider.shutdown();
-    await this._logProvider.shutdown();
+    await Promise.all([
+      this._traceProvider.shutdown(),
+      this._logProvider.shutdown()
+    ]);
   }
 };
 __name(_TracingSDK, "TracingSDK");
@@ -492,17 +541,59 @@ __name(setLogLevel, "setLogLevel");
 // src/v3/otel/index.ts
 function recordSpanException(span, error) {
   if (error instanceof Error) {
-    span.recordException(error);
+    span.recordException(sanitizeSpanError(error));
   } else if (typeof error === "string") {
-    span.recordException(new Error(error));
+    span.recordException(error.replace(/\0/g, ""));
   } else {
-    span.recordException(new Error(JSON.stringify(error)));
+    span.recordException(JSON.stringify(error).replace(/\0/g, ""));
   }
   span.setStatus({
     code: SpanStatusCode.ERROR
   });
 }
 __name(recordSpanException, "recordSpanException");
+function sanitizeSpanError(error) {
+  const sanitizedError = new Error(error.message.replace(/\0/g, ""));
+  sanitizedError.name = error.name.replace(/\0/g, "");
+  sanitizedError.stack = error.stack?.replace(/\0/g, "");
+  return sanitizedError;
+}
+__name(sanitizeSpanError, "sanitizeSpanError");
+var MachineCpu = z.union([
+  z.literal(0.25),
+  z.literal(0.5),
+  z.literal(1),
+  z.literal(2),
+  z.literal(4)
+]);
+var MachineMemory = z.union([
+  z.literal(0.25),
+  z.literal(0.5),
+  z.literal(1),
+  z.literal(2),
+  z.literal(4),
+  z.literal(8)
+]);
+var MachinePresetName = z.enum([
+  "micro",
+  "small-1x",
+  "small-2x",
+  "medium-1x",
+  "medium-2x",
+  "large-1x",
+  "large-2x"
+]);
+var MachineConfig = z.object({
+  cpu: MachineCpu.optional(),
+  memory: MachineMemory.optional(),
+  preset: MachinePresetName.optional()
+});
+var MachinePreset = z.object({
+  name: MachinePresetName,
+  cpu: z.number(),
+  memory: z.number(),
+  centsPerMs: z.number()
+});
 var TaskRunBuiltInError = z.object({
   type: z.literal("BUILT_IN_ERROR"),
   name: z.string(),
@@ -548,7 +639,8 @@ var TaskRunInternalError = z.object({
     "GRACEFUL_EXIT_TIMEOUT",
     "TASK_RUN_HEARTBEAT_TIMEOUT"
   ]),
-  message: z.string().optional()
+  message: z.string().optional(),
+  stackTrace: z.string().optional()
 });
 var TaskRunError = z.discriminatedUnion("type", [
   TaskRunBuiltInError,
@@ -564,7 +656,12 @@ var TaskRun = z.object({
   tags: z.array(z.string()),
   isTest: z.boolean().default(false),
   createdAt: z.coerce.date(),
-  idempotencyKey: z.string().optional()
+  startedAt: z.coerce.date().default(() => /* @__PURE__ */ new Date()),
+  idempotencyKey: z.string().optional(),
+  maxAttempts: z.number().optional(),
+  durationMs: z.number().default(0),
+  costInCents: z.number().default(0),
+  baseCostInCents: z.number().default(0)
 });
 var TaskRunExecutionTask = z.object({
   id: z.string(),
@@ -615,7 +712,8 @@ var TaskRunExecution = z.object({
   environment: TaskRunExecutionEnvironment,
   organization: TaskRunExecutionOrganization,
   project: TaskRunExecutionProject,
-  batch: TaskRunExecutionBatch.optional()
+  batch: TaskRunExecutionBatch.optional(),
+  machine: MachinePreset.optional()
 });
 var TaskRunContext = z.object({
   task: TaskRunExecutionTask,
@@ -631,25 +729,31 @@ var TaskRunContext = z.object({
   environment: TaskRunExecutionEnvironment,
   organization: TaskRunExecutionOrganization,
   project: TaskRunExecutionProject,
-  batch: TaskRunExecutionBatch.optional()
+  batch: TaskRunExecutionBatch.optional(),
+  machine: MachinePreset.optional()
 });
 var TaskRunExecutionRetry = z.object({
   timestamp: z.number(),
   delay: z.number(),
   error: z.unknown().optional()
 });
+var TaskRunExecutionUsage = z.object({
+  durationMs: z.number()
+});
 var TaskRunFailedExecutionResult = z.object({
   ok: z.literal(false),
   id: z.string(),
   error: TaskRunError,
   retry: TaskRunExecutionRetry.optional(),
-  skippedRetrying: z.boolean().optional()
+  skippedRetrying: z.boolean().optional(),
+  usage: TaskRunExecutionUsage.optional()
 });
 var TaskRunSuccessfulExecutionResult = z.object({
   ok: z.literal(true),
   id: z.string(),
   output: z.string().optional(),
-  outputType: z.string()
+  outputType: z.string(),
+  usage: TaskRunExecutionUsage.optional()
 });
 var TaskRunExecutionResult = z.discriminatedUnion("ok", [
   TaskRunSuccessfulExecutionResult,
@@ -667,26 +771,6 @@ z.enum([
   "DEVELOPMENT",
   "PREVIEW"
 ]);
-var MachineCpu = z.union([
-  z.literal(0.25),
-  z.literal(0.5),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4)
-]).default(0.5);
-var MachineMemory = z.union([
-  z.literal(0.25),
-  z.literal(0.5),
-  z.literal(1),
-  z.literal(2),
-  z.literal(4),
-  z.literal(8)
-]).default(1);
-var Machine = z.object({
-  version: z.literal("v1").default("v1"),
-  cpu: MachineCpu,
-  memory: MachineMemory
-});
 z.object({
   execution: TaskRunExecution,
   traceContext: z.record(z.unknown()),
@@ -697,6 +781,12 @@ var ProdTaskRunExecution = TaskRunExecution.extend({
     id: z.string(),
     contentHash: z.string(),
     version: z.string()
+  }),
+  machine: MachinePreset.default({
+    name: "small-1x",
+    cpu: 1,
+    memory: 1,
+    centsPerMs: 0
   })
 });
 z.object({
@@ -796,13 +886,18 @@ var QueueOptions = z.object({
   /** @deprecated This feature is coming soon */
   rateLimit: RateLimitOptions.optional()
 });
+var ScheduleMetadata = z.object({
+  cron: z.string(),
+  timezone: z.string()
+});
 z.object({
   id: z.string(),
   packageVersion: z.string(),
   queue: QueueOptions.optional(),
   retry: RetryOptions.optional(),
-  machine: Machine.partial().optional(),
-  triggerSource: z.string().optional()
+  machine: MachineConfig.optional(),
+  triggerSource: z.string().optional(),
+  schedule: ScheduleMetadata.optional()
 });
 z.object({
   filePath: z.string(),
@@ -813,8 +908,9 @@ z.object({
   packageVersion: z.string(),
   queue: QueueOptions.optional(),
   retry: RetryOptions.optional(),
-  machine: Machine.partial().optional(),
+  machine: MachineConfig.optional(),
   triggerSource: z.string().optional(),
+  schedule: ScheduleMetadata.optional(),
   filePath: z.string(),
   exportName: z.string()
 });
@@ -851,7 +947,8 @@ z.object({
   ])).optional(),
   logLevel: z.string().optional(),
   enableConsoleLogging: z.boolean().optional(),
-  postInstall: z.string().optional()
+  postInstall: z.string().optional(),
+  extraCACerts: z.string().optional()
 });
 z.enum([
   "WAIT_FOR_DURATION",
@@ -860,6 +957,7 @@ z.enum([
 ]);
 z.object({
   runId: z.string(),
+  attemptCount: z.number().optional(),
   messageId: z.string(),
   isTest: z.boolean(),
   traceContext: z.record(z.unknown()),
@@ -873,8 +971,9 @@ var TaskResource = z.object({
   exportName: z.string(),
   queue: QueueOptions.optional(),
   retry: RetryOptions.optional(),
-  machine: Machine.partial().optional(),
-  triggerSource: z.string().optional()
+  machine: MachineConfig.optional(),
+  triggerSource: z.string().optional(),
+  schedule: ScheduleMetadata.optional()
 });
 var BackgroundWorkerMetadata = z.object({
   packageVersion: z.string(),
@@ -922,6 +1021,22 @@ z.object({
   version: z.string(),
   contentHash: z.string()
 });
+var RunTag = z.string().max(64, "Tags must be less than 64 characters");
+var RunTags = z.union([
+  RunTag,
+  z.tuple([
+    RunTag
+  ]),
+  z.tuple([
+    RunTag,
+    RunTag
+  ]),
+  z.tuple([
+    RunTag,
+    RunTag,
+    RunTag
+  ])
+]);
 var TriggerTaskRequestBody = z.object({
   payload: z.any(),
   context: z.any(),
@@ -933,7 +1048,11 @@ var TriggerTaskRequestBody = z.object({
     concurrencyKey: z.string().optional(),
     idempotencyKey: z.string().optional(),
     test: z.boolean().optional(),
-    payloadType: z.string().optional()
+    payloadType: z.string().optional(),
+    delay: z.string().or(z.coerce.date()).optional(),
+    ttl: z.string().or(z.number().nonnegative().int()).optional(),
+    tags: RunTags.optional(),
+    maxAttempts: z.number().int().optional()
   }).optional()
 });
 var TriggerTaskResponse = z.object({
@@ -960,6 +1079,12 @@ z.object({
     ])
   }))
 });
+z.object({
+  tags: RunTags
+});
+z.object({
+  delay: z.string().or(z.coerce.date())
+});
 z.object({
   variables: z.record(z.string())
 });
@@ -992,7 +1117,8 @@ z.object({
 var DeploymentErrorData = z.object({
   name: z.string(),
   message: z.string(),
-  stack: z.string().optional()
+  stack: z.string().optional(),
+  stderr: z.string().optional()
 });
 z.object({
   id: z.string(),
@@ -1030,24 +1156,46 @@ var ReplayRunResponse = z.object({
 var CanceledRunResponse = z.object({
   id: z.string()
 });
+var ScheduleType = z.union([
+  z.literal("DECLARATIVE"),
+  z.literal("IMPERATIVE")
+]);
 z.object({
   /** The schedule id associated with this run (you can have many schedules for the same task).
   You can use this to remove the schedule, update it, etc */
   scheduleId: z.string(),
+  /** The type of schedule – `"DECLARATIVE"` or `"IMPERATIVE"`.
+  *
+  * **DECLARATIVE** – defined inline on your `schedules.task` using the `cron` property. They can only be created, updated or deleted by modifying the `cron` property on your task.
+  *
+  * **IMPERATIVE** – created using the `schedules.create` functions or in the dashboard.
+  */
+  type: ScheduleType,
   /** When the task was scheduled to run.
-  * Note this will be slightly different from `new Date()` because it takes a few ms to run the task. */
+  * Note this will be slightly different from `new Date()` because it takes a few ms to run the task.
+  * 
+  * This date is UTC. To output it as a string with a timezone you would do this: 
+  * ```ts
+  * const formatted = payload.timestamp.toLocaleString("en-US", {
+       timeZone: payload.timezone,
+   });
+   ```  */
   timestamp: z.date(),
   /** When the task was last run (it has been).
-  This can be undefined if it's never been run */
+  This can be undefined if it's never been run. This date is UTC. */
   lastTimestamp: z.date().optional(),
   /** You can optionally provide an external id when creating the schedule.
   Usually you would use a userId or some other unique identifier.
   This defaults to undefined if you didn't provide one. */
   externalId: z.string().optional(),
+  /** The IANA timezone the schedule is set to. The default is UTC.
+  * You can see the full list of supported timezones here: https://cloud.trigger.dev/timezones
+  */
+  timezone: z.string(),
   /** The next 5 dates this task is scheduled to run */
   upcoming: z.array(z.date())
 });
-z.object({
+var CreateScheduleOptions = z.object({
   /** The id of the task you want to attach to. */
   task: z.string(),
   /**  The schedule in CRON format.
@@ -1067,15 +1215,29 @@ z.object({
   
      */
   cron: z.string(),
-  /** (Optional) You can only create one schedule with this key. If you use it twice, the second call will update the schedule.
+  /** You can only create one schedule with this key. If you use it twice, the second call will update the schedule.
   *
-  * This is useful if you don't want to create duplicate schedules for a user. */
-  deduplicationKey: z.string().optional(),
+  * This is required to prevent you from creating duplicate schedules. */
+  deduplicationKey: z.string(),
   /** Optionally, you can specify your own IDs (like a user ID) and then use it inside the run function of your task.
   *
   * This allows you to have per-user CRON tasks.
   */
-  externalId: z.string().optional()
+  externalId: z.string().optional(),
+  /** Optionally, you can specify a timezone in the IANA format. If unset it will use UTC.
+  * If specified then the CRON will be evaluated in that timezone and will respect daylight savings.
+  *
+  * If you set the CRON to `0 0 * * *` and the timezone to `America/New_York` then the task will run at midnight in New York time, no matter whether it's daylight savings or not.
+  *
+  * You can see the full list of supported timezones here: https://cloud.trigger.dev/timezones
+  *
+  * @example "America/New_York", "Europe/London", "Asia/Tokyo", "Africa/Cairo"
+  *
+  */
+  timezone: z.string().optional()
+});
+CreateScheduleOptions.omit({
+  deduplicationKey: true
 });
 var ScheduleGenerator = z.object({
   type: z.literal("CRON"),
@@ -1084,11 +1246,13 @@ var ScheduleGenerator = z.object({
 });
 var ScheduleObject = z.object({
   id: z.string(),
+  type: ScheduleType,
   task: z.string(),
   active: z.boolean(),
   deduplicationKey: z.string().nullish(),
   externalId: z.string().nullish(),
   generator: ScheduleGenerator,
+  timezone: z.string(),
   nextRun: z.coerce.date().nullish(),
   environments: z.array(z.object({
     id: z.string(),
@@ -1111,6 +1275,9 @@ z.object({
   page: z.number().optional(),
   perPage: z.number().optional()
 });
+z.object({
+  timezones: z.array(z.string())
+});
 var RunStatus = z.enum([
   /// Task hasn't been deployed yet but is waiting to be executed
   "WAITING_FOR_DEPLOY",
@@ -1133,7 +1300,11 @@ var RunStatus = z.enum([
   /// 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"
+  "SYSTEM_FAILURE",
+  /// Task has been scheduled to run at a specific time
+  "DELAYED",
+  /// Task has expired and won't be executed
+  "EXPIRED"
 ]);
 var AttemptStatus = z.enum([
   "PENDING",
@@ -1170,12 +1341,21 @@ var CommonRunFields = {
   createdAt: z.coerce.date(),
   updatedAt: z.coerce.date(),
   startedAt: z.coerce.date().optional(),
-  finishedAt: z.coerce.date().optional()
+  finishedAt: z.coerce.date().optional(),
+  delayedUntil: z.coerce.date().optional(),
+  ttl: z.string().optional(),
+  expiredAt: z.coerce.date().optional(),
+  tags: z.string().array(),
+  costInCents: z.number(),
+  baseCostInCents: z.number(),
+  durationMs: z.number()
 };
 var RetrieveRunResponse = z.object({
   ...CommonRunFields,
   payload: z.any().optional(),
+  payloadPresignedUrl: z.string().optional(),
   output: z.any().optional(),
+  outputPresignedUrl: z.string().optional(),
   schedule: RunScheduleDetails.optional(),
   attempts: z.array(z.object({
     id: z.string(),
@@ -1221,10 +1401,34 @@ var EnvironmentVariable = z.object({
 });
 var EnvironmentVariables = z.array(EnvironmentVariable);
 
+// src/v3/utils/retries.ts
+var defaultRetryOptions = {
+  maxAttempts: 3,
+  factor: 2,
+  minTimeoutInMs: 1e3,
+  maxTimeoutInMs: 6e4,
+  randomize: true
+};
+function calculateNextRetryDelay(options, attempt) {
+  const opts = {
+    ...defaultRetryOptions,
+    ...options
+  };
+  if (attempt >= opts.maxAttempts) {
+    return;
+  }
+  const { factor, minTimeoutInMs, maxTimeoutInMs, randomize } = opts;
+  const random = randomize ? Math.random() + 1 : 1;
+  const timeout = Math.min(maxTimeoutInMs, random * minTimeoutInMs * Math.pow(factor, attempt - 1));
+  return Math.round(timeout);
+}
+__name(calculateNextRetryDelay, "calculateNextRetryDelay");
+
 // src/v3/apiClient/errors.ts
 var _ApiError = class _ApiError extends Error {
   constructor(status, error, message, headers) {
     super(`${_ApiError.makeMessage(status, error, message)}`);
+    this.name = "TriggerApiError";
     this.status = status;
     this.headers = headers;
     const data = error;
@@ -1345,6 +1549,16 @@ var _RateLimitError = class _RateLimitError extends ApiError {
     super(...arguments);
     __publicField(this, "status", 429);
   }
+  get millisecondsUntilReset() {
+    const resetAtUnixEpochMs = (this.headers ?? {})["x-ratelimit-reset"];
+    if (typeof resetAtUnixEpochMs === "string") {
+      const resetAtUnixEpoch = parseInt(resetAtUnixEpochMs, 10);
+      if (isNaN(resetAtUnixEpoch)) {
+        return;
+      }
+      return Math.max(resetAtUnixEpoch - Date.now() + Math.floor(Math.random() * 2e3), 0);
+    }
+  }
 };
 __name(_RateLimitError, "RateLimitError");
 var RateLimitError = _RateLimitError;
@@ -1359,28 +1573,11 @@ function castToError(err) {
 }
 __name(castToError, "castToError");
 
-// src/v3/utils/retries.ts
-var defaultRetryOptions = {
-  maxAttempts: 3,
-  factor: 2,
-  minTimeoutInMs: 1e3,
-  maxTimeoutInMs: 6e4,
-  randomize: true
-};
-function calculateNextRetryDelay(options, attempt) {
-  const opts = {
-    ...defaultRetryOptions,
-    ...options
-  };
-  if (attempt >= opts.maxAttempts) {
-    return;
-  }
-  const { factor, minTimeoutInMs, maxTimeoutInMs, randomize } = opts;
-  const random = randomize ? Math.random() + 1 : 1;
-  const timeout = Math.min(maxTimeoutInMs, random * minTimeoutInMs * Math.pow(factor, attempt - 1));
-  return Math.round(timeout);
+// src/v3/utils/styleAttributes.ts
+function accessoryAttributes(accessory) {
+  return flattenAttributes(accessory, SemanticInternalAttributes.STYLE_ACCESSORY);
 }
-__name(calculateNextRetryDelay, "calculateNextRetryDelay");
+__name(accessoryAttributes, "accessoryAttributes");
 
 // src/v3/apiClient/pagination.ts
 var _CursorPage = class _CursorPage {
@@ -1540,47 +1737,47 @@ function zodfetchOffsetLimitPage(schema, url, params, 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));
+async function traceZodFetch(params, callback) {
+  if (!params.options?.tracer) {
+    return callback();
+  }
+  const url = new URL(params.url);
+  const method = params.requestInit?.method ?? "GET";
+  const name = params.options.name ?? `${method} ${url.pathname}`;
+  return await params.options.tracer.startActiveSpan(name, async (span) => {
+    return await callback(span);
+  }, {
+    attributes: {
+      [SemanticInternalAttributes.STYLE_ICON]: params.options?.icon ?? "api",
+      ...params.options.attributes
+    }
+  });
 }
-__name(zodupload, "zodupload");
-async function createMultipartFormRequestInit(body, requestInit) {
-  const form = await createForm(body);
-  const encoder = new FormDataEncoder(form);
-  const finalHeaders = {};
-  for (const [key, value] of Object.entries(requestInit?.headers || {})) {
-    finalHeaders[key] = value;
-  }
-  for (const [key, value] of Object.entries(encoder.headers)) {
-    finalHeaders[key] = value;
-  }
-  finalHeaders["Content-Length"] = String(encoder.contentLength);
-  const finalRequestInit = {
-    ...requestInit,
-    headers: finalHeaders,
-    body: Readable.from(encoder),
-    // @ts-expect-error
-    duplex: "half"
-  };
-  return finalRequestInit;
+__name(traceZodFetch, "traceZodFetch");
+async function _doZodFetch(schema, url, requestInit, options) {
+  const $requestInit = await requestInit;
+  return traceZodFetch({
+    url,
+    requestInit: $requestInit,
+    options
+  }, async (span) => {
+    const result = await _doZodFetchWithRetries(schema, url, $requestInit, options);
+    if (options?.onResponseBody && span) {
+      options.onResponseBody(result.data, span);
+    }
+    return result;
+  });
 }
-__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)));
-  return form;
-}, "createForm");
-async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
+__name(_doZodFetch, "_doZodFetch");
+async function _doZodFetchWithRetries(schema, url, requestInit, options, attempt = 1) {
   try {
-    const $requestInit = await requestInit;
-    const response = await fetch(url, requestInitWithCache($requestInit));
+    const response = await fetch(url, requestInitWithCache(requestInit));
     const responseHeaders = createResponseHeaders(response.headers);
     if (!response.ok) {
       const retryResult = shouldRetry(response, attempt, options?.retry);
       if (retryResult.retry) {
-        await new Promise((resolve) => setTimeout(resolve, retryResult.delay));
-        return await _doZodFetch(schema, url, requestInit, options, attempt + 1);
+        await waitForRetry(url, attempt + 1, retryResult.delay, options, requestInit, response);
+        return await _doZodFetchWithRetries(schema, url, requestInit, options, attempt + 1);
       } else {
         const errText = await response.text().catch((e) => castToError2(e).message);
         const errJSON = safeJsonParse(errText);
@@ -1608,8 +1805,8 @@ async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
       };
       const delay = calculateNextRetryDelay(retry, attempt);
       if (delay) {
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        return await _doZodFetch(schema, url, requestInit, options, attempt + 1);
+        await waitForRetry(url, attempt + 1, delay, options, requestInit);
+        return await _doZodFetchWithRetries(schema, url, requestInit, options, attempt + 1);
       }
     }
     throw new ApiConnectionError({
@@ -1617,7 +1814,7 @@ async function _doZodFetch(schema, url, requestInit, options, attempt = 1) {
     });
   }
 }
-__name(_doZodFetch, "_doZodFetch");
+__name(_doZodFetchWithRetries, "_doZodFetchWithRetries");
 function castToError2(err) {
   if (err instanceof Error)
     return err;
@@ -1654,8 +1851,25 @@ function shouldRetry(response, attempt, retryOptions) {
     return shouldRetryForOptions();
   if (response.status === 409)
     return shouldRetryForOptions();
-  if (response.status === 429)
+  if (response.status === 429) {
+    if (attempt >= (typeof retryOptions?.maxAttempts === "number" ? retryOptions?.maxAttempts : 3)) {
+      return {
+        retry: false
+      };
+    }
+    const resetAtUnixEpochMs = response.headers.get("x-ratelimit-reset");
+    if (resetAtUnixEpochMs) {
+      const resetAtUnixEpoch = parseInt(resetAtUnixEpochMs, 10);
+      const delay = resetAtUnixEpoch - Date.now() + Math.floor(Math.random() * 1e3);
+      if (delay > 0) {
+        return {
+          retry: true,
+          delay
+        };
+      }
+    }
     return shouldRetryForOptions();
+  }
   if (response.status >= 500)
     return shouldRetryForOptions();
   return {
@@ -1696,95 +1910,6 @@ function requestInitWithCache(requestInit) {
   }
 }
 __name(requestInitWithCache, "requestInitWithCache");
-var addFormValue = /* @__PURE__ */ __name(async (form, key, value) => {
-  if (value === void 0)
-    return;
-  if (value == null) {
-    throw new TypeError(`Received null for "${key}"; to pass null in FormData, you must use the string 'null'`);
-  }
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
-    form.append(key, String(value));
-  } else if (isUploadable(value) || isBlobLike(value) || value instanceof Buffer || value instanceof ArrayBuffer) {
-    const file = await toFile(value);
-    form.append(key, file);
-  } else if (Array.isArray(value)) {
-    await Promise.all(value.map((entry) => addFormValue(form, key + "[]", entry)));
-  } else if (typeof value === "object") {
-    await Promise.all(Object.entries(value).map(([name, prop]) => addFormValue(form, `${key}[${name}]`, prop)));
-  } else {
-    throw new TypeError(`Invalid value given to form, expected a string, number, boolean, object, Array, File or Blob but got ${value} instead`);
-  }
-}, "addFormValue");
-async function toFile(value, name, options) {
-  value = await value;
-  options ??= isFileLike(value) ? {
-    lastModified: value.lastModified,
-    type: value.type
-  } : {};
-  if (isResponseLike(value)) {
-    const blob = await value.blob();
-    name ||= new URL(value.url).pathname.split(/[\\/]/).pop() ?? "unknown_file";
-    return new File([
-      blob
-    ], name, options);
-  }
-  const bits = await getBytes(value);
-  name ||= getName(value) ?? "unknown_file";
-  if (!options.type) {
-    const type = bits[0]?.type;
-    if (typeof type === "string") {
-      options = {
-        ...options,
-        type
-      };
-    }
-  }
-  return new File(bits, name, options);
-}
-__name(toFile, "toFile");
-function getName(value) {
-  return getStringFromMaybeBuffer(value.name) || getStringFromMaybeBuffer(value.filename) || // For fs.ReadStream
-  getStringFromMaybeBuffer(value.path)?.split(/[\\/]/).pop();
-}
-__name(getName, "getName");
-var getStringFromMaybeBuffer = /* @__PURE__ */ __name((x) => {
-  if (typeof x === "string")
-    return x;
-  if (typeof Buffer !== "undefined" && x instanceof Buffer)
-    return String(x);
-  return void 0;
-}, "getStringFromMaybeBuffer");
-async function getBytes(value) {
-  let parts = [];
-  if (typeof value === "string" || ArrayBuffer.isView(value) || // includes Uint8Array, Buffer, etc.
-  value instanceof ArrayBuffer) {
-    parts.push(value);
-  } else if (isBlobLike(value)) {
-    parts.push(await value.arrayBuffer());
-  } else if (isAsyncIterableIterator(value)) {
-    for await (const chunk of value) {
-      parts.push(chunk);
-    }
-  } else {
-    throw new Error(`Unexpected data type: ${typeof value}; constructor: ${value?.constructor?.name}; props: ${propsForError(value)}`);
-  }
-  return parts;
-}
-__name(getBytes, "getBytes");
-function propsForError(value) {
-  const props = Object.getOwnPropertyNames(value);
-  return `[${props.map((p) => `"${p}"`).join(", ")}]`;
-}
-__name(propsForError, "propsForError");
-var isAsyncIterableIterator = /* @__PURE__ */ __name((value) => value != null && typeof value === "object" && typeof value[Symbol.asyncIterator] === "function", "isAsyncIterableIterator");
-var isResponseLike = /* @__PURE__ */ __name((value) => value != null && typeof value === "object" && typeof value.url === "string" && typeof value.blob === "function", "isResponseLike");
-var isFileLike = /* @__PURE__ */ __name((value) => value != null && typeof value === "object" && typeof value.name === "string" && typeof value.lastModified === "number" && isBlobLike(value), "isFileLike");
-var isBlobLike = /* @__PURE__ */ __name((value) => value != null && typeof value === "object" && typeof value.size === "number" && typeof value.type === "string" && typeof value.text === "function" && typeof value.slice === "function" && typeof value.arrayBuffer === "function", "isBlobLike");
-var isFsReadStream = /* @__PURE__ */ __name((value) => value instanceof Readable, "isFsReadStream");
-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) => {
@@ -1907,9 +2032,32 @@ fetchPage_fn2 = /* @__PURE__ */ __name(function(params1) {
 }, "#fetchPage");
 __name(_OffsetLimitPagePromise, "OffsetLimitPagePromise");
 var OffsetLimitPagePromise = _OffsetLimitPagePromise;
+async function waitForRetry(url, attempt, delay, options, requestInit, response) {
+  if (options?.tracer) {
+    const method = requestInit?.method ?? "GET";
+    return options.tracer.startActiveSpan(response ? `wait after ${response.status}` : `wait after error`, async (span) => {
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }, {
+      attributes: {
+        [SemanticInternalAttributes.STYLE_ICON]: "wait",
+        ...accessoryAttributes({
+          items: [
+            {
+              text: `retrying ${options?.name ?? method.toUpperCase()} in ${delay}ms`,
+              variant: "normal"
+            }
+          ],
+          style: "codepath"
+        })
+      }
+    });
+  }
+  await new Promise((resolve) => setTimeout(resolve, delay));
+}
+__name(waitForRetry, "waitForRetry");
 
 // src/v3/apiClient/index.ts
-var zodFetchOptions = {
+var DEFAULT_ZOD_FETCH_OPTIONS = {
   retry: {
     maxAttempts: 3,
     minTimeoutInMs: 1e3,
@@ -1920,17 +2068,18 @@ var zodFetchOptions = {
 };
 var _getHeaders, getHeaders_fn;
 var _ApiClient = class _ApiClient {
-  constructor(baseUrl, accessToken) {
+  constructor(baseUrl, accessToken, requestOptions = {}) {
     __privateAdd(this, _getHeaders);
     this.accessToken = accessToken;
     this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.defaultRequestOptions = mergeRequestOptions(DEFAULT_ZOD_FETCH_OPTIONS, requestOptions);
   }
-  async getRunResult(runId) {
+  async getRunResult(runId, requestOptions) {
     try {
       return await zodfetch(TaskRunExecutionResult, `${this.baseUrl}/api/v1/runs/${runId}/result`, {
         method: "GET",
         headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-      }, zodFetchOptions);
+      }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     } catch (error) {
       if (error instanceof ApiError) {
         if (error.status === 404) {
@@ -1940,47 +2089,47 @@ var _ApiClient = class _ApiClient {
       throw error;
     }
   }
-  async getBatchResults(batchId) {
+  async getBatchResults(batchId, requestOptions) {
     return await zodfetch(BatchTaskRunExecutionResult, `${this.baseUrl}/api/v1/batches/${batchId}/results`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  triggerTask(taskId, body, options) {
+  triggerTask(taskId, body, options, requestOptions) {
     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);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  batchTriggerTask(taskId, body, options) {
+  batchTriggerTask(taskId, body, options, requestOptions) {
     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)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  createUploadPayloadUrl(filename) {
+  createUploadPayloadUrl(filename, requestOptions) {
     return zodfetch(CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/packets/${filename}`, {
       method: "PUT",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  getPayloadUrl(filename) {
+  getPayloadUrl(filename, requestOptions) {
     return zodfetch(CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/packets/${filename}`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  retrieveRun(runId) {
+  retrieveRun(runId, requestOptions) {
     return zodfetch(RetrieveRunResponse, `${this.baseUrl}/api/v3/runs/${runId}`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  listRuns(query) {
+  listRuns(query, requestOptions) {
     const searchParams = createSearchQueryForListRuns(query);
     return zodfetchCursorPage(ListRunResponseItem, `${this.baseUrl}/api/v1/runs`, {
       query: searchParams,
@@ -1990,9 +2139,9 @@ var _ApiClient = class _ApiClient {
     }, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  listProjectRuns(projectRef, query) {
+  listProjectRuns(projectRef, query, requestOptions) {
     const searchParams = createSearchQueryForListRuns(query);
     if (query?.env) {
       searchParams.append("filter[env]", Array.isArray(query.env) ? query.env.join(",") : query.env);
@@ -2005,28 +2154,44 @@ var _ApiClient = class _ApiClient {
     }, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  replayRun(runId) {
+  replayRun(runId, requestOptions) {
     return zodfetch(ReplayRunResponse, `${this.baseUrl}/api/v1/runs/${runId}/replay`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  cancelRun(runId) {
+  cancelRun(runId, requestOptions) {
     return zodfetch(CanceledRunResponse, `${this.baseUrl}/api/v2/runs/${runId}/cancel`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    }, zodFetchOptions);
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  createSchedule(options) {
+  rescheduleRun(runId, body, requestOptions) {
+    return zodfetch(RetrieveRunResponse, `${this.baseUrl}/api/v1/runs/${runId}/reschedule`, {
+      method: "POST",
+      headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
+      body: JSON.stringify(body)
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+  }
+  addTags(runId, body, requestOptions) {
+    return zodfetch(z.object({
+      message: z.string()
+    }), `${this.baseUrl}/api/v1/runs/${runId}/tags`, {
+      method: "POST",
+      headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
+      body: JSON.stringify(body)
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+  }
+  createSchedule(options, requestOptions) {
     return zodfetch(ScheduleObject, `${this.baseUrl}/api/v1/schedules`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
       body: JSON.stringify(options)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  listSchedules(options) {
+  listSchedules(options, requestOptions) {
     const searchParams = new URLSearchParams();
     if (options?.page) {
       searchParams.append("page", options.page.toString());
@@ -2040,84 +2205,77 @@ var _ApiClient = class _ApiClient {
     }, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  retrieveSchedule(scheduleId) {
+  retrieveSchedule(scheduleId, requestOptions) {
     return zodfetch(ScheduleObject, `${this.baseUrl}/api/v1/schedules/${scheduleId}`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  updateSchedule(scheduleId, options) {
+  updateSchedule(scheduleId, options, requestOptions) {
     return zodfetch(ScheduleObject, `${this.baseUrl}/api/v1/schedules/${scheduleId}`, {
       method: "PUT",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
       body: JSON.stringify(options)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  deactivateSchedule(scheduleId) {
+  deactivateSchedule(scheduleId, requestOptions) {
     return zodfetch(ScheduleObject, `${this.baseUrl}/api/v1/schedules/${scheduleId}/deactivate`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  activateSchedule(scheduleId) {
+  activateSchedule(scheduleId, requestOptions) {
     return zodfetch(ScheduleObject, `${this.baseUrl}/api/v1/schedules/${scheduleId}/activate`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  deleteSchedule(scheduleId) {
+  deleteSchedule(scheduleId, requestOptions) {
     return zodfetch(DeletedScheduleObject, `${this.baseUrl}/api/v1/schedules/${scheduleId}`, {
       method: "DELETE",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  listEnvVars(projectRef, slug) {
+  listEnvVars(projectRef, slug, requestOptions) {
     return zodfetch(EnvironmentVariables, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  importEnvVars(projectRef, slug, body) {
-    if (isRecordLike(body.variables)) {
-      return zodfetch(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/import`, {
-        method: "POST",
-        headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
-        body: JSON.stringify(body)
-      });
-    } else {
-      return zodupload(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/import`, body, {
-        method: "POST",
-        headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-      });
-    }
+  importEnvVars(projectRef, slug, body, requestOptions) {
+    return zodfetch(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/import`, {
+      method: "POST",
+      headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
+      body: JSON.stringify(body)
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  retrieveEnvVar(projectRef, slug, key) {
+  retrieveEnvVar(projectRef, slug, key, requestOptions) {
     return zodfetch(EnvironmentVariableValue, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/${key}`, {
       method: "GET",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  createEnvVar(projectRef, slug, body) {
+  createEnvVar(projectRef, slug, body, requestOptions) {
     return zodfetch(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}`, {
       method: "POST",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
       body: JSON.stringify(body)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  updateEnvVar(projectRef, slug, key, body) {
+  updateEnvVar(projectRef, slug, key, body, requestOptions) {
     return zodfetch(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/${key}`, {
       method: "PUT",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false),
       body: JSON.stringify(body)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
-  deleteEnvVar(projectRef, slug, key) {
+  deleteEnvVar(projectRef, slug, key, requestOptions) {
     return zodfetch(EnvironmentVariableResponseBody, `${this.baseUrl}/api/v1/projects/${projectRef}/envvars/${slug}/${key}`, {
       method: "DELETE",
       headers: __privateMethod(this, _getHeaders, getHeaders_fn).call(this, false)
-    });
+    }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
   }
 };
 _getHeaders = new WeakSet();
@@ -2153,6 +2311,9 @@ function createSearchQueryForListRuns(query) {
     if (query.bulkAction) {
       searchParams.append("filter[bulkAction]", query.bulkAction);
     }
+    if (query.tag) {
+      searchParams.append("filter[tag]", Array.isArray(query.tag) ? query.tag.join(",") : query.tag);
+    }
     if (query.schedule) {
       searchParams.append("filter[schedule]", query.schedule);
     }
@@ -2172,6 +2333,20 @@ function createSearchQueryForListRuns(query) {
   return searchParams;
 }
 __name(createSearchQueryForListRuns, "createSearchQueryForListRuns");
+function mergeRequestOptions(defaultOptions, options) {
+  if (!options) {
+    return defaultOptions;
+  }
+  return {
+    ...defaultOptions,
+    ...options,
+    retry: {
+      ...defaultOptions.retry,
+      ...options.retry
+    }
+  };
+}
+__name(mergeRequestOptions, "mergeRequestOptions");
 
 // src/v3/apiClientManager/index.ts
 var API_NAME2 = "api-client";
@@ -2286,7 +2461,7 @@ async function conditionallyExportPacket(packet, pathPrefix, tracer) {
   return packet;
 }
 __name(conditionallyExportPacket, "conditionallyExportPacket");
-function packetRequiresOffloading(packet) {
+function packetRequiresOffloading(packet, lengthLimit) {
   if (!packet.data) {
     return {
       needsOffloading: false,
@@ -2295,7 +2470,7 @@ function packetRequiresOffloading(packet) {
   }
   const byteSize = Buffer.byteLength(packet.data, "utf8");
   return {
-    needsOffloading: byteSize >= OFFLOAD_IO_PACKET_LENGTH_LIMIT,
+    needsOffloading: byteSize >= (lengthLimit ?? OFFLOAD_IO_PACKET_LENGTH_LIMIT),
     size: byteSize
   };
 }
@@ -2436,12 +2611,6 @@ async function loadSuperJSON() {
 }
 __name(loadSuperJSON, "loadSuperJSON");
 
-// src/v3/utils/styleAttributes.ts
-function accessoryAttributes(accessory) {
-  return flattenAttributes(accessory, SemanticInternalAttributes.STYLE_ACCESSORY);
-}
-__name(accessoryAttributes, "accessoryAttributes");
-
 // src/v3/workers/taskExecutor.ts
 var _callRun, callRun_fn, _callInitFunctions, callInitFunctions_fn, _callConfigInit, callConfigInit_fn, _callOnSuccessFunctions, callOnSuccessFunctions_fn, _callOnSuccessFunction, callOnSuccessFunction_fn, _callOnFailureFunctions, callOnFailureFunctions_fn, _callOnFailureFunction, callOnFailureFunction_fn, _callOnStartFunctions, callOnStartFunctions_fn, _callOnStartFunction, callOnStartFunction_fn, _callTaskCleanup, callTaskCleanup_fn, _handleError, handleError_fn;
 var _TaskExecutor = class _TaskExecutor {
@@ -2465,7 +2634,7 @@ var _TaskExecutor = class _TaskExecutor {
     this._importedConfig = options.importedConfig;
     this._handleErrorFn = options.handleErrorFn;
   }
-  async execute(execution, worker, traceContext) {
+  async execute(execution, worker, traceContext, usage2) {
     const ctx = TaskRunContext.parse(execution);
     const attemptMessage = `Attempt ${execution.attempt.number}`;
     const originalPacket = {
@@ -2529,7 +2698,7 @@ var _TaskExecutor = class _TaskExecutor {
             return {
               id: execution.run.id,
               ok: false,
-              error: handleErrorResult.error ? parseError(handleErrorResult.error) : parseError(runError),
+              error: sanitizeError(handleErrorResult.error ? parseError(handleErrorResult.error) : parseError(runError)),
               retry: handleErrorResult.status === "retry" ? handleErrorResult.retry : void 0,
               skippedRetrying: handleErrorResult.status === "skipped"
             };
@@ -2566,7 +2735,9 @@ var _TaskExecutor = class _TaskExecutor {
         })
       }
     }, this._tracer.extractContext(traceContext));
-    return result;
+    return {
+      result
+    };
   }
 };
 _callRun = new WeakSet();
@@ -2578,7 +2749,8 @@ callRun_fn = /* @__PURE__ */ __name(async function(payload, ctx, init) {
   }
   if (!middlewareFn) {
     return runFn(payload, {
-      ctx
+      ctx,
+      init
     });
   }
   return middlewareFn(payload, {
@@ -2715,7 +2887,19 @@ handleError_fn = /* @__PURE__ */ __name(async function(execution, error2, payloa
       status: "noop"
     };
   }
-  const delay = calculateNextRetryDelay(retry, execution.attempt.number);
+  if (error2 instanceof Error && error2.name === "AbortTaskRunError") {
+    return {
+      status: "skipped"
+    };
+  }
+  if (execution.run.maxAttempts) {
+    retry.maxAttempts = Math.max(execution.run.maxAttempts, 1);
+  }
+  let delay = calculateNextRetryDelay(retry, execution.attempt.number);
+  if (delay && error2 instanceof Error && error2.name === "TriggerApiError" && error2.status === 429) {
+    const rateLimitError = error2;
+    delay = rateLimitError.millisecondsUntilReset;
+  }
   if (execution.environment.type === "DEVELOPMENT" && typeof retriesConfig?.enabledInDev === "boolean" && !retriesConfig.enabledInDev) {
     return {
       status: "skipped"
@@ -3222,6 +3406,295 @@ var _StandardTaskCatalog = class _StandardTaskCatalog {
 __name(_StandardTaskCatalog, "StandardTaskCatalog");
 var StandardTaskCatalog = _StandardTaskCatalog;
 
-export { ConsoleInterceptor, PreciseWallClock as DurableClock, OtelTaskLogger, StandardTaskCatalog, TaskContextLogProcessor, TaskContextSpanProcessor, TaskExecutor, TracingSDK, getEnvVar, logLevels, recordSpanException };
+// src/v3/usage/noopUsageManager.ts
+var _NoopUsageManager = class _NoopUsageManager {
+  disable() {
+  }
+  start() {
+    return {
+      sample: () => ({
+        cpuTime: 0,
+        wallTime: 0
+      })
+    };
+  }
+  stop(measurement) {
+    return measurement.sample();
+  }
+  pauseAsync(cb) {
+    return cb();
+  }
+  sample() {
+    return void 0;
+  }
+};
+__name(_NoopUsageManager, "NoopUsageManager");
+var NoopUsageManager = _NoopUsageManager;
+
+// src/v3/usage/api.ts
+var API_NAME4 = "usage";
+var NOOP_USAGE_MANAGER = new NoopUsageManager();
+var _getUsageManager, getUsageManager_fn;
+var _UsageAPI = class _UsageAPI {
+  constructor() {
+    __privateAdd(this, _getUsageManager);
+  }
+  static getInstance() {
+    if (!this._instance) {
+      this._instance = new _UsageAPI();
+    }
+    return this._instance;
+  }
+  setGlobalUsageManager(manager) {
+    return registerGlobal(API_NAME4, manager);
+  }
+  disable() {
+    __privateMethod(this, _getUsageManager, getUsageManager_fn).call(this).disable();
+    unregisterGlobal(API_NAME4);
+  }
+  start() {
+    return __privateMethod(this, _getUsageManager, getUsageManager_fn).call(this).start();
+  }
+  stop(measurement) {
+    return __privateMethod(this, _getUsageManager, getUsageManager_fn).call(this).stop(measurement);
+  }
+  pauseAsync(cb) {
+    return __privateMethod(this, _getUsageManager, getUsageManager_fn).call(this).pauseAsync(cb);
+  }
+  sample() {
+    return __privateMethod(this, _getUsageManager, getUsageManager_fn).call(this).sample();
+  }
+};
+_getUsageManager = new WeakSet();
+getUsageManager_fn = /* @__PURE__ */ __name(function() {
+  return getGlobal(API_NAME4) ?? NOOP_USAGE_MANAGER;
+}, "#getUsageManager");
+__name(_UsageAPI, "UsageAPI");
+var UsageAPI = _UsageAPI;
+
+// src/v3/usage-api.ts
+var usage = UsageAPI.getInstance();
+
+// src/v3/clock/clock.ts
+function calculateDurationInMs(start, end) {
+  const [startSeconds, startNanoseconds] = start;
+  const [endSeconds, endNanoseconds] = end;
+  const seconds = endSeconds - startSeconds;
+  const nanoseconds = endNanoseconds - startNanoseconds;
+  return Math.floor(seconds * 1e3 + nanoseconds / 1e6);
+}
+__name(calculateDurationInMs, "calculateDurationInMs");
+
+// src/v3/usage/devUsageManager.ts
+var _a2;
+var DevUsageMeasurement = (_a2 = class {
+  constructor(id, startedAt = clock.preciseNow()) {
+    this.id = id;
+    this.startedAt = startedAt;
+    this._pauses = /* @__PURE__ */ new Map();
+  }
+  stop() {
+    this._endedAt = clock.preciseNow();
+  }
+  sample() {
+    const endedAt = this._endedAt ?? clock.preciseNow();
+    const wallTime = this.startedAt ? calculateDurationInMs(this.startedAt, endedAt) : 0;
+    if (wallTime === 0) {
+      return {
+        cpuTime: 0,
+        wallTime: 0
+      };
+    }
+    const totalPauses = Array.from(this._pauses.values()).reduce((total, pause) => {
+      return total + calculateDurationInMs(pause.start, pause.end ?? endedAt);
+    }, 0);
+    const cpuTime = wallTime - totalPauses;
+    return {
+      wallTime,
+      cpuTime
+    };
+  }
+  registerPause(pauseId, start, end) {
+    this._pauses.set(pauseId, {
+      start,
+      end
+    });
+  }
+}, __name(_a2, "DevUsageMeasurement"), _a2);
+var _DevUsageManager = class _DevUsageManager {
+  constructor() {
+    __publicField(this, "_currentMeasurements", /* @__PURE__ */ new Map());
+    __publicField(this, "_pauses", /* @__PURE__ */ new Map());
+  }
+  disable() {
+  }
+  sample() {
+    return this._firstMeasurement?.sample();
+  }
+  start() {
+    const id = generateRandomString();
+    const measurement = new DevUsageMeasurement(id);
+    if (!this._firstMeasurement) {
+      this._firstMeasurement = measurement;
+    }
+    this._currentMeasurements.set(id, measurement);
+    return measurement;
+  }
+  stop(measurement) {
+    measurement.stop();
+    const sample = measurement.sample();
+    this._currentMeasurements.delete(measurement.id);
+    return sample;
+  }
+  async pauseAsync(cb) {
+    const pauseId = generateRandomString();
+    const pauseStart = clock.preciseNow();
+    try {
+      this._pauses.set(pauseId, {
+        start: pauseStart
+      });
+      for (const measurement of this._currentMeasurements.values()) {
+        measurement.registerPause(pauseId, pauseStart);
+      }
+      return await cb();
+    } finally {
+      const pauseEnd = clock.preciseNow();
+      this._pauses.set(pauseId, {
+        start: pauseStart,
+        end: pauseEnd
+      });
+      for (const measurement of this._currentMeasurements.values()) {
+        measurement.registerPause(pauseId, pauseStart, pauseEnd);
+      }
+    }
+  }
+};
+__name(_DevUsageManager, "DevUsageManager");
+var DevUsageManager = _DevUsageManager;
+function generateRandomString() {
+  let result = "";
+  const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  const charactersLength = characters.length;
+  for (var i = 0; i < 16; i++) {
+    result += characters.charAt(Math.floor(Math.random() * charactersLength));
+  }
+  return result;
+}
+__name(generateRandomString, "generateRandomString");
+
+// src/v3/usage/usageClient.ts
+var _UsageClient = class _UsageClient {
+  constructor(url, jwt) {
+    this.url = url;
+    this.jwt = jwt;
+  }
+  async sendUsageEvent(event) {
+    try {
+      const response = await fetch(this.url, {
+        method: "POST",
+        body: JSON.stringify(event),
+        headers: {
+          "content-type": "application/json",
+          "x-trigger-jwt": this.jwt,
+          accept: "application/json",
+          authorization: `Bearer ${apiClientManager.accessToken}`
+        }
+      });
+      if (response.ok) {
+        const renewedJwt = response.headers.get("x-trigger-jwt");
+        if (renewedJwt) {
+          this.jwt = renewedJwt;
+        }
+      }
+    } catch (error) {
+      console.error(`Failed to send usage event: ${error}`);
+    }
+  }
+};
+__name(_UsageClient, "UsageClient");
+var UsageClient = _UsageClient;
+
+// src/v3/usage/prodUsageManager.ts
+var _startReportingHeartbeat, startReportingHeartbeat_fn, _reportUsage, reportUsage_fn;
+var _ProdUsageManager = class _ProdUsageManager {
+  constructor(delegageUsageManager, options) {
+    __privateAdd(this, _startReportingHeartbeat);
+    __privateAdd(this, _reportUsage);
+    this.delegageUsageManager = delegageUsageManager;
+    this.options = options;
+    if (this.options.url && this.options.jwt) {
+      this._usageClient = new UsageClient(this.options.url, this.options.jwt);
+    }
+  }
+  get isReportingEnabled() {
+    return typeof this._usageClient !== "undefined";
+  }
+  disable() {
+    this.delegageUsageManager.disable();
+    this._abortController?.abort();
+  }
+  sample() {
+    return this._measurement?.sample();
+  }
+  start() {
+    if (!this.isReportingEnabled || !this.options.heartbeatIntervalMs) {
+      return this.delegageUsageManager.start();
+    }
+    if (!this._measurement) {
+      this._measurement = this.delegageUsageManager.start();
+      __privateMethod(this, _startReportingHeartbeat, startReportingHeartbeat_fn).call(this).catch(console.error);
+      return this._measurement;
+    }
+    return this.delegageUsageManager.start();
+  }
+  stop(measurement) {
+    return this.delegageUsageManager.stop(measurement);
+  }
+  async pauseAsync(cb) {
+    return this.delegageUsageManager.pauseAsync(cb);
+  }
+  async flush() {
+    return await __privateMethod(this, _reportUsage, reportUsage_fn).call(this);
+  }
+};
+_startReportingHeartbeat = new WeakSet();
+startReportingHeartbeat_fn = /* @__PURE__ */ __name(async function() {
+  if (!this._measurement || !this.isReportingEnabled || !this.options.heartbeatIntervalMs) {
+    return;
+  }
+  this._abortController = new AbortController();
+  for await (const _ of setInterval(this.options.heartbeatIntervalMs)) {
+    if (this._abortController.signal.aborted) {
+      break;
+    }
+    await __privateMethod(this, _reportUsage, reportUsage_fn).call(this);
+  }
+}, "#startReportingHeartbeat");
+_reportUsage = new WeakSet();
+reportUsage_fn = /* @__PURE__ */ __name(async function() {
+  if (!this._measurement) {
+    return;
+  }
+  if (!this.isReportingEnabled) {
+    return;
+  }
+  const client = this._usageClient;
+  if (!client) {
+    return;
+  }
+  const sample = this._measurement.sample();
+  const cpuTimeSinceLastSample = this._lastSample ? sample.cpuTime - this._lastSample.cpuTime : sample.cpuTime;
+  this._lastSample = sample;
+  if (cpuTimeSinceLastSample <= 0) {
+    return;
+  }
+  await client.sendUsageEvent({
+    durationMs: cpuTimeSinceLastSample
+  });
+}, "#reportUsage");
+__name(_ProdUsageManager, "ProdUsageManager");
+var ProdUsageManager = _ProdUsageManager;
+
+export { ConsoleInterceptor, DevUsageManager, PreciseWallClock as DurableClock, OtelTaskLogger, ProdUsageManager, StandardTaskCatalog, TaskContextLogProcessor, TaskContextSpanProcessor, TaskExecutor, TracingSDK, getEnvVar, logLevels, recordSpanException, usage };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map