@zapier/zapier-sdk 0.104.0 → 0.105.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @zapier/zapier-sdk
 
+## 0.105.0
+
+### Minor Changes
+
+- ef3540d: Added `correlationId` and `causationId` options on `createZapierSdk`, matching
+  `--correlation-id` and `--causation-id` CLI flags, and the `ZAPIER_CORRELATION_ID`
+  and `ZAPIER_CAUSATION_ID` environment variables. When set, they are emitted as
+  `zapier-correlation-id` and `zapier-causation-id` headers on every outbound
+  Zapier API request. Precedence for both ids is: explicit option, then
+  environment variable, and for correlation the SDK falls back to its per-call
+  id so requests still carry a trace identifier. Precedence is: explicit option,
+  then environment variable. Empty strings at either layer are treated as unset.
+
 ## 0.104.0
 
 ### Minor Changes

package/README.md

@@ -383,6 +383,8 @@ The `createZapierSdk(...)` factory function is the main entry point for the SDK.
 | `maxApprovalRetries`             | `number`                   | ❌       | —       | —                           | Maximum number of sequential approval rounds per request (one per gating policy) before giving up. Default: 2.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `approvalMode`                   | `string`                   | ❌       | —       | `disabled`, `poll`, `throw` | Approval flow behavior for manual approvals. "poll" creates the approval, opens it in a browser, polls until resolved, and retries the original request. "throw" creates the manual approval and throws a ZapierApprovalError with the approval URL so the caller can surface it. Server-created auto-mode approvals always poll until they reach a terminal status and retry the original request on approval, even when this option is "throw". "disabled" throws a ZapierApprovalError on approval-required responses without creating an approval. Resolution order is: explicit option, then ZAPIER_APPROVAL_MODE, then the default behavior (poll for interactive TTY, throw otherwise). |
 | `openAutoModeApprovalsInBrowser` | `boolean`                  | ❌       | —       | —                           | 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`                  | `string`                   | ❌       | —       | —                           | 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `causationId`                    | `string`                   | ❌       | —       | —                           | 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `canIncludeSharedConnections`    | `boolean`                  | ❌       | —       | —                           | Allow listing shared connections.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `canIncludeSharedTables`         | `boolean`                  | ❌       | —       | —                           | Allow listing shared tables.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `canDeleteTables`                | `boolean`                  | ❌       | —       | —                           | Allow deleting tables.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

package/dist/{chunk-CJKNVBRZ.mjs → chunk-NF7CPRHH.mjs}

@@ -12,6 +12,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;
@@ -1235,6 +1241,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 = z.object({
   type: z.enum(["client_credentials"]).optional().meta({ internal: true }),
   clientId: z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
@@ -2657,7 +2674,7 @@ function logRouteOverride({
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.104.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:";
@@ -3386,11 +3403,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 = {}) {
@@ -3970,7 +3997,9 @@ var apiPlugin = defineProperty({
       approvalMode,
       openAutoModeApprovalsInBrowser,
       callerPackage,
-      routeOverrides
+      routeOverrides,
+      correlationId,
+      causationId
     } = imports.sdkOptions ?? {};
     return createZapierApi({
       baseUrl,
@@ -3993,7 +4022,12 @@ var apiPlugin = 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
@@ -11752,7 +11786,7 @@ function computeArgumentCount(args) {
   }
   return args.filter((a) => a !== void 0).length;
 }
-function makeMethodEndHook(emitMethodCalled) {
+function makeMethodEndHook(emitMethodCalled, { sdkOptions } = {}) {
   return ({
     methodName,
     args,
@@ -11768,9 +11802,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,
@@ -12164,17 +12198,20 @@ var eventEmissionPlugin = defineProperty({
 var eventEmissionHookPlugin = 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);
     }
   }
 });
@@ -12435,6 +12472,12 @@ var BaseSdkOptionsSchema = z.object({
   openAutoModeApprovalsInBrowser: 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: 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: 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: z.string().optional().describe("Path to a .zapierrc manifest file for app version locking.").meta({ internal: true }),
   manifest: z.custom().optional().describe("Manifest for app version locking.").meta({ internal: true }),
@@ -12459,4 +12502,4 @@ var registryPlugin = (_sdk) => {
   return {};
 };
 
-export { ACTION_RUNS_PATH, API_ID, ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMillisecondsPropertySchema, ActionTimeoutSecondsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthMechanism, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONNECTIONS_ID, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MILLISECONDS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MILLISECONDS, DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DEPRECATION_NOTICE_EVENT, DebugPropertySchema, DrainTriggerInboxSchema, EVENT_EMISSION_ID, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MANIFEST_ID, MAX_CONCURRENCY_LIMIT, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RESOLVE_CREDENTIALS_ID, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, SDK_OPTIONS_ID, TablePropertySchema, TablesPropertySchema, TriggerInboxKeyPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, WatchTriggerInboxSchema, ZAPIER_BASE_URL, ZAPIER_MAX_CONCURRENT_REQUESTS, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, apiPluginRef, appKeyResolver, appsPlugin, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, cleanupEventListeners, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, connectionsPluginRef, createActionRunPlugin, createBaseEvent, createClientCredentialsPlugin, createMemoryCache, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, durableRunIdResolver, eventEmissionHookPlugin, eventEmissionPlugin, eventEmissionPluginRef, extractErrorDetail, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getActionRunPlugin, getAgent, getAppPlugin, getBaseUrlFromCredentials, getCallerContext, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getTtyContext, getZapierApprovalMode, getZapierDefaultApprovalMode, getZapierOpenAutoModeApprovalsInBrowser, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPermanentHttpError, isPkceCredentials, isZapierAbortDrainSignal, isZapierActionError, isZapierAppNotFoundError, isZapierApprovalError, isZapierAuthenticationError, isZapierBundleError, isZapierConflictError, isZapierError, isZapierNotFoundError, isZapierRateLimitError, isZapierReleaseTriggerMessageSignal, isZapierResourceNotFoundError, isZapierSignal, isZapierTimeoutError, isZapierValidationError, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, manifestPluginRef, operationAnnotatorPlugin, parseConcurrencyEnvVar, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuth, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, resolveCredentialsPlugin, resolveCredentialsPluginRef, runActionPlugin, runWithCallerContext, sdkOptionsPluginRef, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, triggerInboxResolver, triggerMessagesResolver, updateTableRecordsPlugin, workflowDraftIdResolver, workflowIdResolver, workflowRunIdResolver, workflowVersionIdResolver, zapierAdaptError, zapierCoreOptions, zapierSdkPlugin };
+export { ACTION_RUNS_PATH, API_ID, ActionKeyPropertySchema, ActionPropertySchema, ActionTimeoutMillisecondsPropertySchema, ActionTimeoutSecondsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AppPropertySchema, AppsPropertySchema, AuthMechanism, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, CONNECTIONS_ID, CONTEXT_CACHE_MAX_SIZE, CONTEXT_CACHE_TTL_MILLISECONDS, ClientCredentialsObjectSchema, ConnectionEntrySchema, ConnectionIdPropertySchema, ConnectionPropertySchema, ConnectionsMapSchema, ConnectionsPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MILLISECONDS, DEFAULT_APPROVAL_TIMEOUT_MILLISECONDS, DEFAULT_CONFIG_PATH, DEFAULT_MAX_APPROVAL_RETRIES, DEFAULT_PAGE_SIZE, DEPRECATION_NOTICE_EVENT, DebugPropertySchema, DrainTriggerInboxSchema, EVENT_EMISSION_ID, FieldsPropertySchema, InputFieldPropertySchema, InputsPropertySchema, LeaseLimitPropertySchema, LeasePropertySchema, LeaseSecondsPropertySchema, LimitPropertySchema, MANIFEST_ID, MAX_CONCURRENCY_LIMIT, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RESOLVE_CREDENTIALS_ID, RecordPropertySchema, RecordsPropertySchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, SDK_OPTIONS_ID, TablePropertySchema, TablesPropertySchema, TriggerInboxKeyPropertySchema, TriggerInboxNamePropertySchema, TriggerInboxPropertySchema, WatchTriggerInboxSchema, ZAPIER_BASE_URL, ZAPIER_MAX_CONCURRENT_REQUESTS, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MILLISECONDS, ZapierAbortDrainSignal, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierApprovalError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierConflictError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierReleaseTriggerMessageSignal, ZapierResourceNotFoundError, ZapierSignal, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, apiPluginRef, appKeyResolver, appsPlugin, batch, buildApplicationLifecycleEvent, buildCapabilityMessage, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, cleanupEventListeners, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, connectionsPlugin, connectionsPluginRef, createActionRunPlugin, createBaseEvent, createClientCredentialsPlugin, createMemoryCache, createTableFieldsPlugin, createTablePlugin, createTableRecordsPlugin, createZapierApi, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, deleteTableFieldsPlugin, deleteTablePlugin, deleteTableRecordsPlugin, durableRunIdResolver, eventEmissionHookPlugin, eventEmissionPlugin, eventEmissionPluginRef, extractErrorDetail, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionInputFieldsSchemaPlugin, getActionPlugin, getActionRunPlugin, getAgent, getAppPlugin, getBaseUrlFromCredentials, getCallerContext, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOrCreateApiClient, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTablePlugin, getTableRecordPlugin, getTokenFromCliLogin, getTtyContext, getZapierApprovalMode, getZapierCausationId, getZapierCorrelationId, getZapierDefaultApprovalMode, getZapierOpenAutoModeApprovalsInBrowser, getZapierSdkService, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPermanentHttpError, isPkceCredentials, isZapierAbortDrainSignal, isZapierActionError, isZapierAppNotFoundError, isZapierApprovalError, isZapierAuthenticationError, isZapierBundleError, isZapierConflictError, isZapierError, isZapierNotFoundError, isZapierRateLimitError, isZapierReleaseTriggerMessageSignal, isZapierResourceNotFoundError, isZapierSignal, isZapierTimeoutError, isZapierValidationError, listActionInputFieldChoicesPlugin, listActionInputFieldsPlugin, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listTableFieldsPlugin, listTableRecordsPlugin, listTablesPlugin, logDeprecation, manifestPlugin, manifestPluginRef, operationAnnotatorPlugin, parseConcurrencyEnvVar, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuth, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, resolveCredentialsPlugin, resolveCredentialsPluginRef, runActionPlugin, runWithCallerContext, sdkOptionsPluginRef, tableFieldIdsResolver, tableFieldsResolver, tableFiltersResolver, tableIdResolver, tableNameResolver, tableRecordIdResolver, tableRecordIdsResolver, tableRecordsResolver, tableSortResolver, tableUpdateRecordsResolver, triggerInboxResolver, triggerMessagesResolver, updateTableRecordsPlugin, workflowDraftIdResolver, workflowIdResolver, workflowRunIdResolver, workflowVersionIdResolver, zapierAdaptError, zapierCoreOptions, zapierSdkPlugin };

package/dist/{chunk-ZEZNG44W.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;
@@ -1236,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" }),
@@ -2658,7 +2675,7 @@ function logRouteOverride({
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.104.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:";
@@ -3387,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 = {}) {
@@ -3971,7 +3998,9 @@ var apiPlugin = kitcore.defineProperty({
       approvalMode,
       openAutoModeApprovalsInBrowser,
       callerPackage,
-      routeOverrides
+      routeOverrides,
+      correlationId,
+      causationId
     } = imports.sdkOptions ?? {};
     return createZapierApi({
       baseUrl,
@@ -3994,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
@@ -11753,7 +11787,7 @@ function computeArgumentCount(args) {
   }
   return args.filter((a) => a !== void 0).length;
 }
-function makeMethodEndHook(emitMethodCalled) {
+function makeMethodEndHook(emitMethodCalled, { sdkOptions } = {}) {
   return ({
     methodName,
     args,
@@ -11769,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,
@@ -12165,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);
     }
   }
 });
@@ -12436,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 }),
@@ -12805,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;