@zapier/zapier-sdk 0.103.0 → 0.105.0

package/dist/{chunk-RHL6GGME.cjs → chunk-Y2OATBGZ.cjs}

@@ -13,6 +13,12 @@ var ZAPIER_BASE_URL = globalThis.process?.env?.ZAPIER_BASE_URL || "https://zapie
 function getZapierSdkService() {
   return globalThis.process?.env?.ZAPIER_SDK_SERVICE;
 }
+function getZapierCorrelationId() {
+  return globalThis.process?.env?.ZAPIER_CORRELATION_ID || void 0;
+}
+function getZapierCausationId() {
+  return globalThis.process?.env?.ZAPIER_CAUSATION_ID || void 0;
+}
 var MAX_PAGE_LIMIT = 1e4;
 var DEFAULT_PAGE_SIZE = 100;
 var DEFAULT_ACTION_TIMEOUT_MILLISECONDS = 18e4;
@@ -706,7 +712,6 @@ function createDebugFetch(options) {
 // src/utils/retry-utils.ts
 var MAX_CONSECUTIVE_ERRORS = 3;
 var BASE_ERROR_BACKOFF_MILLISECONDS = 1e3;
-var BASE_EXPONENTIAL_BACKOFF_MILLISECONDS = 1e3;
 var JITTER_FACTOR = 0.5;
 function calculateErrorBackoffMs(baseInterval, errorCount) {
   const jitter = Math.random() * JITTER_FACTOR * baseInterval;
@@ -717,11 +722,6 @@ function calculateErrorBackoffMs(baseInterval, errorCount) {
   );
   return Math.floor(baseInterval + jitter + errorBackoff);
 }
-function calculateExponentialBackoffMs(attempt, baseDelayMs = BASE_EXPONENTIAL_BACKOFF_MILLISECONDS) {
-  const baseDelay = baseDelayMs * Math.pow(2, attempt - 1);
-  const jitter = Math.random() * JITTER_FACTOR * baseDelay;
-  return Math.floor(baseDelay + jitter);
-}
 function sleep(ms, signal) {
   if (!signal) {
     return new Promise((resolve2) => setTimeout(resolve2, ms));
@@ -1076,7 +1076,114 @@ var sdkOptionsPluginRef = kitcore.declareOptionalProperty({
   id: SDK_OPTIONS_ID
 });
 
+// src/api/rate-limit.ts
+var EPOCH_THRESHOLD_SECONDS = 1e9;
+function parseRateLimitHeaders(response) {
+  const info = {};
+  const retryAfter = response.headers.get("retry-after");
+  if (retryAfter) {
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+      info.retryAfterMs = Math.max(0, seconds * 1e3);
+    } else {
+      const date = Date.parse(retryAfter);
+      if (!isNaN(date)) {
+        info.retryAfterMs = Math.max(0, date - Date.now());
+      }
+    }
+  }
+  const reset = response.headers.get("x-ratelimit-reset");
+  if (reset) {
+    const resetValue = parseInt(reset, 10);
+    if (!isNaN(resetValue)) {
+      const isEpoch = resetValue >= EPOCH_THRESHOLD_SECONDS;
+      info.resetMs = isEpoch ? resetValue * 1e3 : Date.now() + resetValue * 1e3;
+      if (info.retryAfterMs === void 0) {
+        info.retryAfterMs = isEpoch ? Math.max(0, info.resetMs - Date.now()) : Math.max(0, resetValue * 1e3);
+      }
+    }
+  }
+  const limit = response.headers.get("x-ratelimit-limit");
+  if (limit) {
+    const limitNum = parseInt(limit, 10);
+    if (!isNaN(limitNum)) {
+      info.limit = limitNum;
+    }
+  }
+  const remaining = response.headers.get("x-ratelimit-remaining");
+  if (remaining) {
+    const remainingNum = parseInt(remaining, 10);
+    if (!isNaN(remainingNum)) {
+      info.remaining = remainingNum;
+    }
+  }
+  return info;
+}
+
+// src/utils/type-guard-utils.ts
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function isPromiseLike(value) {
+  return (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
+}
+
+// src/plugins/transport/retry-events.ts
+var retryCounts = /* @__PURE__ */ new WeakMap();
+function retriesFor(request) {
+  return retryCounts.get(request) ?? 0;
+}
+function createRetryObserver({
+  onEvent,
+  maxNetworkRetries
+}) {
+  return ({ request, attemptNumber, delayMilliseconds, response }) => {
+    retryCounts.set(request, attemptNumber);
+    if (!onEvent || response?.status !== 429) return;
+    const observed = onEvent({
+      type: "api:rate_limit_retry",
+      payload: {
+        retry: attemptNumber,
+        maxNetworkRetries,
+        delayMs: delayMilliseconds,
+        path: request.url,
+        method: request.method ?? "GET",
+        rateLimit: parseRateLimitHeaders(response)
+      },
+      timestamp: Date.now()
+    });
+    if (isPromiseLike(observed)) {
+      void Promise.resolve(observed).catch(() => {
+      });
+    }
+  };
+}
+
 // src/plugins/transport/options.ts
+var RETRYABLE_STATUSES = [429, 500, 502, 503, 504];
+var NON_IDEMPOTENT_RETRYABLE_STATUSES = [429];
+function resolveRetryHttpRequestOptions({
+  maxNetworkRetries,
+  maxNetworkRetryDelayMilliseconds,
+  onEvent
+}) {
+  const retries = maxNetworkRetries ?? ZAPIER_MAX_NETWORK_RETRIES;
+  return {
+    maxAttempts: retries + 1,
+    maxDelayMilliseconds: maxNetworkRetryDelayMilliseconds ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS,
+    retryStatuses: RETRYABLE_STATUSES,
+    nonIdempotentRetryStatuses: NON_IDEMPOTENT_RETRYABLE_STATUSES,
+    onRetry: createRetryObserver({ onEvent, maxNetworkRetries: retries })
+  };
+}
+function resolveNetworkRetryDelayMilliseconds({
+  maxNetworkRetryDelaySeconds,
+  maxNetworkRetryDelayMs
+}) {
+  return maxNetworkRetryDelaySeconds != null ? maxNetworkRetryDelaySeconds * 1e3 : maxNetworkRetryDelayMs;
+}
 function resolveTransportFetch({
   fetch: customFetch,
   debug = false
@@ -1104,15 +1211,29 @@ var httpFetchPlugin = kitcore.defineProperty({
 // src/plugins/transport/standalone.ts
 function createZapierSendHttpRequest({
   fetch: customFetch,
-  debug
+  debug,
+  maxNetworkRetries,
+  maxNetworkRetryDelayMilliseconds,
+  onEvent
 }) {
   const sdk = kitcore.createSdk(
     kitcore.definePlugin({
       name: "zapierStandaloneHttpTransport",
-      imports: [kitcore.sendHttpRequestPlugin, httpFetchPlugin],
+      imports: [kitcore.sendHttpRequestPlugin, kitcore.retryHttpRequestPlugin, httpFetchPlugin],
       exports: [kitcore.sendHttpRequestPlugin]
     }),
-    { configuration: { [SDK_OPTIONS_ID]: { fetch: customFetch, debug } } }
+    {
+      configuration: {
+        [SDK_OPTIONS_ID]: { fetch: customFetch, debug },
+        // Filled by configuration rather than the graph's property plugin: the
+        // caller here holds client-shaped ms options, not SDK options.
+        [kitcore.RETRY_HTTP_REQUEST_OPTIONS_ID]: resolveRetryHttpRequestOptions({
+          maxNetworkRetries,
+          maxNetworkRetryDelayMilliseconds,
+          onEvent
+        })
+      }
+    }
   );
   return sdk.sendHttpRequest;
 }
@@ -1121,6 +1242,17 @@ function createZapierSendHttpRequest({
 var CORRELATION_CALL_ID = Symbol(
   "zapier.correlationCallId"
 );
+function resolveCorrelationId({
+  options,
+  callId
+}) {
+  return options?.correlationId || getZapierCorrelationId() || callId || void 0;
+}
+function resolveCausationId({
+  options
+}) {
+  return options?.causationId || getZapierCausationId();
+}
 var ClientCredentialsObjectSchema = zod.z.object({
   type: zod.z.enum(["client_credentials"]).optional().meta({ internal: true }),
   clientId: zod.z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
@@ -1770,13 +1902,6 @@ async function invalidateCredentialsToken(options) {
     });
   }
 }
-
-// src/utils/type-guard-utils.ts
-function isPlainObject(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
 var callerContext = kitcore.createAsyncContext();
 function runWithCallerContext(context, fn) {
   let parent;
@@ -2022,9 +2147,6 @@ function sniffDeprecationNotice({
     }
   }
 }
-function isPromiseLike(value) {
-  return (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
-}
 function parseDeprecationDate(value) {
   if (!value) return void 0;
   const match = /^@(-?\d+)$/.exec(value.trim());
@@ -2553,7 +2675,7 @@ function logRouteOverride({
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.103.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.105.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -2669,7 +2791,6 @@ var PollApprovalResponseSchema = zod.z.object({
   approval_url: zod.z.string().optional()
 });
 var APPROVAL_MAX_POLLING_INTERVAL_MILLISECONDS = 5e3;
-var EPOCH_THRESHOLD_SECONDS = 1e9;
 function validateSdkPath(path) {
   if (!path.startsWith("/") || path.startsWith("//")) {
     throw new ZapierValidationError(
@@ -2677,57 +2798,17 @@ function validateSdkPath(path) {
     );
   }
 }
-function parseRateLimitHeaders(response) {
-  const info = {};
-  const retryAfter = response.headers.get("retry-after");
-  if (retryAfter) {
-    const seconds = parseInt(retryAfter, 10);
-    if (!isNaN(seconds)) {
-      info.retryAfterMs = seconds * 1e3;
-    } else {
-      const date = Date.parse(retryAfter);
-      if (!isNaN(date)) {
-        info.retryAfterMs = Math.max(0, date - Date.now());
-      }
-    }
-  }
-  const reset = response.headers.get("x-ratelimit-reset");
-  if (reset) {
-    const resetValue = parseInt(reset, 10);
-    if (!isNaN(resetValue)) {
-      const isEpoch = resetValue >= EPOCH_THRESHOLD_SECONDS;
-      info.resetMs = isEpoch ? resetValue * 1e3 : Date.now() + resetValue * 1e3;
-      if (info.retryAfterMs === void 0) {
-        info.retryAfterMs = isEpoch ? Math.max(0, info.resetMs - Date.now()) : Math.max(0, resetValue * 1e3);
-      }
-    }
-  }
-  const limit = response.headers.get("x-ratelimit-limit");
-  if (limit) {
-    const limitNum = parseInt(limit, 10);
-    if (!isNaN(limitNum)) {
-      info.limit = limitNum;
-    }
-  }
-  const remaining = response.headers.get("x-ratelimit-remaining");
-  if (remaining) {
-    const remainingNum = parseInt(remaining, 10);
-    if (!isNaN(remainingNum)) {
-      info.remaining = remainingNum;
-    }
-  }
-  return info;
-}
 var ZapierApiClient = class {
   constructor(options) {
     this.options = options;
     /**
      * Perform a request against an already-resolved URL.
      *
-     * Does auth, header merging, and 429 retry — all the cross-cutting
-     * concerns that every Zapier-bound HTTP call needs. Callers that have a
-     * path (e.g. `/relay/...`) should use `rawFetch` instead, which does
-     * path → URL resolution and delegates here.
+     * Does auth and header merging, and converts a terminal 429 into
+     * `ZapierRateLimitError` — the cross-cutting concerns that every
+     * Zapier-bound HTTP call needs and that the transport does not own. Callers
+     * that have a path (e.g. `/relay/...`) should use `rawFetch` instead, which
+     * does path → URL resolution and delegates here.
      *
      * Exposed as a separate helper so call sites with a server-supplied
      * absolute URL (e.g. an approval poll URL) can still share the same
@@ -2761,47 +2842,30 @@ var ZapierApiClient = class {
         resource: _resource,
         ...wireInit
       } = fetchInit;
-      let retries = 0;
-      while (true) {
-        const response = await this.options.sendHttpRequest({
-          ...wireInit,
-          // Set the resolved URL and merged headers after the spread so caller
-          // values cannot override them.
-          url,
-          headers: Object.fromEntries(mergedHeaders)
-        });
-        if (response.status !== 429) {
-          return response;
-        }
-        const rateLimitInfo = parseRateLimitHeaders(response);
-        const delayMs = rateLimitInfo.retryAfterMs ?? calculateExponentialBackoffMs(retries + 1);
-        if (delayMs > this.maxNetworkRetryDelayMilliseconds || retries >= this.maxNetworkRetries) {
-          throw new ZapierRateLimitError(
-            await this.readRateLimitErrorMessage(response),
-            {
-              statusCode: 429,
-              rateLimit: rateLimitInfo,
-              retries
-            }
-          );
-        }
-        retries++;
-        this.emitEvent("api:rate_limit_retry", {
-          retry: retries,
-          maxNetworkRetries: this.maxNetworkRetries,
-          delayMs,
-          path: url,
-          method: init?.method ?? "GET",
-          rateLimit: rateLimitInfo
-        });
-        await sleep(delayMs, init?.signal ?? void 0);
+      const request = {
+        ...wireInit,
+        url,
+        headers: Object.fromEntries(mergedHeaders)
+      };
+      const response = await this.options.sendHttpRequest(request);
+      if (response.status !== 429) {
+        return response;
       }
+      throw new ZapierRateLimitError(
+        await this.readRateLimitErrorMessage(response),
+        {
+          statusCode: 429,
+          rateLimit: parseRateLimitHeaders(response),
+          retries: retriesFor(request)
+        }
+      );
     };
     /**
      * Wrap an outbound HTTP call with the concurrency semaphore. Used by both
      * `rawFetch` (path-based) and the approval-poll path (absolute URL); each
-     * caller acquires per-attempt, so 429 retry sleep is held but the gap
-     * between approval polls and the human-approval wait are not.
+     * caller acquires per request, so the transport's retry sleeps are held
+     * inside the permit but the gap between approval polls and the
+     * human-approval wait are not.
      *
      * The release is registered in a finally that wraps the entire post-
      * acquire flow — including the `wait_end` event emission — so a throwing
@@ -3051,8 +3115,6 @@ var ZapierApiClient = class {
         signal: options.signal
       });
     };
-    this.maxNetworkRetries = options.maxNetworkRetries ?? ZAPIER_MAX_NETWORK_RETRIES;
-    this.maxNetworkRetryDelayMilliseconds = options.maxNetworkRetryDelayMilliseconds ?? options.maxNetworkRetryDelayMs ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS;
     const requested = options.maxConcurrentRequests;
     const limit = requested === void 0 || Number.isNaN(requested) ? ZAPIER_MAX_CONCURRENT_REQUESTS : requested;
     if (limit !== Infinity && (!Number.isInteger(limit) || limit < 1 || limit > MAX_CONCURRENCY_LIMIT)) {
@@ -3342,11 +3404,21 @@ var ZapierApiClient = class {
         headers.set("zapier-sdk-package-operation", packageOperation);
       }
     }
-    if (callId) {
-      headers.set("zapier-correlation-id", callId);
+    const correlationId = resolveCorrelationId({
+      options: this.options,
+      callId
+    });
+    if (correlationId) {
+      headers.set("zapier-correlation-id", correlationId);
     } else {
       headers.delete("zapier-correlation-id");
     }
+    const causationId = resolveCausationId({ options: this.options });
+    if (causationId) {
+      headers.set("zapier-causation-id", causationId);
+    } else {
+      headers.delete("zapier-causation-id");
+    }
   }
   // Helper to perform HTTP requests with JSON handling
   async fetchJson(method, path, data, options = {}) {
@@ -3808,7 +3880,13 @@ var createZapierApi = (options) => {
     fetch: debugFetch,
     // Built from the caller's own `fetch`, not `debugFetch`: the pipeline wraps
     // for debug itself, and passing the wrapped one would log twice.
-    sendHttpRequest: options.sendHttpRequest ?? createZapierSendHttpRequest({ fetch: options.fetch, debug }),
+    sendHttpRequest: options.sendHttpRequest ?? createZapierSendHttpRequest({
+      fetch: options.fetch,
+      debug,
+      onEvent: options.onEvent,
+      maxNetworkRetries: options.maxNetworkRetries,
+      maxNetworkRetryDelayMilliseconds: options.maxNetworkRetryDelayMilliseconds ?? options.maxNetworkRetryDelayMs
+    }),
     debugLog,
     routingOptions
   });
@@ -3847,10 +3925,30 @@ function getOrCreateApiClient(config) {
     callerPackage
   });
 }
+var retryHttpRequestOptionsPlugin = kitcore.defineProperty({
+  namespace: "kitcore",
+  name: "retryHttpRequestOptions",
+  imports: [sdkOptionsPluginRef],
+  setup: ({ imports }) => resolveRetryHttpRequestOptions({
+    maxNetworkRetries: imports.sdkOptions?.maxNetworkRetries,
+    maxNetworkRetryDelayMilliseconds: resolveNetworkRetryDelayMilliseconds(
+      imports.sdkOptions ?? {}
+    ),
+    onEvent: imports.sdkOptions?.onEvent
+  }),
+  get: ({ state }) => state
+});
+
+// src/plugins/transport/index.ts
 var zapierHttpTransportPlugin = kitcore.definePlugin({
   namespace: "zapier",
   name: "httpTransport",
-  imports: [kitcore.sendHttpRequestPlugin, httpFetchPlugin],
+  imports: [
+    kitcore.sendHttpRequestPlugin,
+    kitcore.retryHttpRequestPlugin,
+    retryHttpRequestOptionsPlugin,
+    httpFetchPlugin
+  ],
   exports: [kitcore.sendHttpRequestPlugin]
 });
 
@@ -3900,7 +3998,9 @@ var apiPlugin = kitcore.defineProperty({
       approvalMode,
       openAutoModeApprovalsInBrowser,
       callerPackage,
-      routeOverrides
+      routeOverrides,
+      correlationId,
+      causationId
     } = imports.sdkOptions ?? {};
     return createZapierApi({
       baseUrl,
@@ -3910,7 +4010,10 @@ var apiPlugin = kitcore.defineProperty({
       fetch: customFetch,
       onEvent,
       maxNetworkRetries,
-      maxNetworkRetryDelayMilliseconds: (maxNetworkRetryDelaySeconds != null ? maxNetworkRetryDelaySeconds * 1e3 : maxNetworkRetryDelayMs) ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS,
+      maxNetworkRetryDelayMilliseconds: resolveNetworkRetryDelayMilliseconds({
+        maxNetworkRetryDelaySeconds,
+        maxNetworkRetryDelayMs
+      }) ?? ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS,
       maxConcurrentRequests,
       approvalTimeoutMilliseconds: approvalTimeoutSeconds != null ? approvalTimeoutSeconds * 1e3 : approvalTimeoutMs,
       maxApprovalRetries,
@@ -3920,7 +4023,12 @@ var apiPlugin = kitcore.defineProperty({
       routeOverrides,
       // Inject the graph-composed transport so host `dispatchHttpRequest` wraps
       // apply.
-      sendHttpRequest: imports.sendHttpRequest
+      sendHttpRequest: imports.sendHttpRequest,
+      // Pass through unresolved so `resolveCorrelationId` / `resolveCausationId`
+      // do the option-then-env-var chain at request time — the same helper the
+      // event-emission hook calls, so header and MethodCalledEvent stay aligned.
+      correlationId,
+      causationId
     });
   },
   get: ({ state, callContext }) => callContext?.callId ? withCorrelationId({ client: state, callId: callContext.callId }) : state
@@ -11679,7 +11787,7 @@ function computeArgumentCount(args) {
   }
   return args.filter((a) => a !== void 0).length;
 }
-function makeMethodEndHook(emitMethodCalled) {
+function makeMethodEndHook(emitMethodCalled, { sdkOptions } = {}) {
   return ({
     methodName,
     args,
@@ -11695,9 +11803,9 @@ function makeMethodEndHook(emitMethodCalled) {
     const metadata = readMethodMetadata(annotations);
     emitMethodCalled({
       method_name: methodName,
-      // The per-call correlation id (also the `zapier-correlation-id` header on
-      // this call's requests). Not the `call_context` surface label.
-      correlation_id: callId ?? null,
+      // Same resolution as the `zapier-correlation-id` header: SDK option >
+      // env var > per-call kitcore id. Not the `call_context` surface label.
+      correlation_id: resolveCorrelationId({ options: sdkOptions, callId }) ?? null,
       execution_duration_ms: durationMs,
       success_flag: !error,
       error_message: error?.message ?? null,
@@ -12091,17 +12199,20 @@ var eventEmissionPlugin = kitcore.defineProperty({
 var eventEmissionHookPlugin = kitcore.defineHook({
   namespace: "zapier",
   name: "eventEmissionHook",
-  imports: [eventEmissionPlugin],
+  imports: [eventEmissionPlugin, sdkOptionsPluginRef],
   observe: {
     onMethodEnd: ({ imports, input }) => {
       if (input.methodName === "getRegistry") return;
-      const emitter = imports.eventEmission;
-      makeMethodEndHook((data) => {
-        emitter.emit(METHOD_CALLED_EVENT_SUBJECT, {
-          ...buildMethodCalledEvent(data),
-          call_context: emitter.config.callContext ?? "sdk"
-        });
-      })(input);
+      const { eventEmission: emitter, sdkOptions } = imports;
+      makeMethodEndHook(
+        (data) => {
+          emitter.emit(METHOD_CALLED_EVENT_SUBJECT, {
+            ...buildMethodCalledEvent(data),
+            call_context: emitter.config.callContext ?? "sdk"
+          });
+        },
+        { sdkOptions }
+      )(input);
     }
   }
 });
@@ -12315,17 +12426,20 @@ var BaseSdkOptionsSchema = zod.z.object({
   routeOverrides: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Maps SDK route prefixes to direct origins.").meta({ internal: true }),
   trackingBaseUrl: zod.z.string().optional().describe("Base URL for Zapier tracking endpoints.").meta({ valueHint: "url" }),
   /**
-   * Maximum number of retries for rate-limited requests (429 responses).
+   * Maximum number of retries for rate-limited requests (429 responses) and,
+   * on idempotent methods, retryable server errors (500, 502, 503, 504).
    * Set to 0 to disable retries. Default is 3.
    */
-  maxNetworkRetries: zod.z.number().optional().describe("Max retries for rate-limited requests (default: 3).").meta({ valueHint: "count" }),
+  maxNetworkRetries: zod.z.number().optional().describe(
+    "Max retries for rate-limited and server-error responses (default: 3)."
+  ).meta({ valueHint: "count" }),
   /**
-   * Maximum delay in seconds to wait for a rate-limit retry.
+   * Maximum delay in seconds to wait between network retries.
    * If the server requests a longer delay, the request fails immediately.
    * Default is 60 (60 seconds).
    */
   maxNetworkRetryDelaySeconds: zod.z.number().optional().describe(
-    "Max delay in seconds to wait for a rate-limit retry (default: 60)."
+    "Max delay in seconds to wait between network retries (default: 60)."
   ).meta({ valueHint: "seconds" }),
   /** @deprecated Use `maxNetworkRetryDelaySeconds` instead. */
   maxNetworkRetryDelayMs: zod.z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms", deprecated: true }),
@@ -12359,6 +12473,12 @@ var BaseSdkOptionsSchema = zod.z.object({
   openAutoModeApprovalsInBrowser: zod.z.boolean().optional().describe(
     "By default, auto-mode approvals do not open in a browser. Enable this option to open the approval URL and watch the approval process. Resolution order is: explicit option, then ZAPIER_OPEN_AUTO_MODE_APPROVALS_IN_BROWSER, then false."
   ),
+  correlationId: zod.z.string().optional().describe(
+    "Correlation ID for request tracing. When set, emitted as the `zapier-correlation-id` header on every outbound request. Falls back to the ZAPIER_CORRELATION_ID environment variable."
+  ).meta({ valueHint: "id" }),
+  causationId: zod.z.string().optional().describe(
+    "Causation ID for request tracing. When set, emitted as the `zapier-causation-id` header on every outbound request. Falls back to the ZAPIER_CAUSATION_ID environment variable."
+  ).meta({ valueHint: "id" }),
   // Internal
   manifestPath: zod.z.string().optional().describe("Path to a .zapierrc manifest file for app version locking.").meta({ internal: true }),
   manifest: zod.z.custom().optional().describe("Manifest for app version locking.").meta({ internal: true }),
@@ -12728,6 +12848,8 @@ exports.getTableRecordPlugin = getTableRecordPlugin;
 exports.getTokenFromCliLogin = getTokenFromCliLogin;
 exports.getTtyContext = getTtyContext;
 exports.getZapierApprovalMode = getZapierApprovalMode;
+exports.getZapierCausationId = getZapierCausationId;
+exports.getZapierCorrelationId = getZapierCorrelationId;
 exports.getZapierDefaultApprovalMode = getZapierDefaultApprovalMode;
 exports.getZapierOpenAutoModeApprovalsInBrowser = getZapierOpenAutoModeApprovalsInBrowser;
 exports.getZapierSdkService = getZapierSdkService;