@zapier/zapier-sdk 0.73.0 → 0.74.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.74.0
+
+### Minor Changes
+
+- 571f90d: Add zapier-sdk-package-operation header to identify the caller operation
+
+## 0.73.1
+
+### Patch Changes
+
+- 6c7627c: CamelCase the input params on `runDurable` and `publishWorkflowVersion` (`sourceFiles`, `zapierDurableVersion`, `appVersions`, and the nested connection / app-version / trigger fields), keeping the old snake_case names as deprecated aliases. Handlers map them back to the snake_case wire body; output fields are unchanged.
+
 ## 0.73.0
 
 ### Minor Changes

package/README.md

@@ -1658,21 +1658,21 @@ Publish a new version of a durable workflow. Enables the workflow by default.
 
 **Parameters:**
 
-| Name                         | Type      | Required | Default | Possible Values | Description                                                                                                          |
-| ---------------------------- | --------- | -------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `options`                    | `object`  | ✅       | —       | —               |                                                                                                                      |
-| ​ ↳ `workflow`               | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                                  |
-| ​ ↳ `source_files`           | `object`  | ✅       | —       | —               | Source files keyed by filename → contents                                                                            |
-| ​ ↳ `dependencies`           | `object`  | ❌       | —       | —               | Optional npm package dependencies                                                                                    |
-| ​ ↳ `zapier_durable_version` | `string`  | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.      |
-| ​ ↳ `enabled`                | `boolean` | ❌       | —       | —               | Enable the workflow after publishing. Defaults to true; pass false to publish without enabling.                      |
-| ​ ↳ `connections`            | `object`  | ❌       | —       | —               | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding.      |
-| ​ ↳ `app_versions`           | `object`  | ❌       | —       | —               | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding. |
-| ​ ↳ `trigger`                | `object`  | ❌       | —       | —               | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows.  |
-| ​   ↳ `selected_api`         | `string`  | ✅       | —       | —               | Zapier app/API identifier (e.g. 'GoogleSheetsAPI')                                                                   |
-| ​   ↳ `action`               | `string`  | ✅       | —       | —               | Trigger action key (e.g. 'new_row')                                                                                  |
-| ​   ↳ `authentication_id`    | `string`  | ❌       | —       | —               | Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier).              |
-| ​   ↳ `params`               | `object`  | ❌       | —       | —               | Trigger parameters as a JSON object                                                                                  |
+| Name                       | Type      | Required | Default | Possible Values | Description                                                                                                          |
+| -------------------------- | --------- | -------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `options`                  | `object`  | ✅       | —       | —               |                                                                                                                      |
+| ​ ↳ `workflow`             | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                                  |
+| ​ ↳ `sourceFiles`          | `object`  | ✅       | —       | —               | Source files keyed by filename → contents                                                                            |
+| ​ ↳ `dependencies`         | `object`  | ❌       | —       | —               | Optional npm package dependencies                                                                                    |
+| ​ ↳ `zapierDurableVersion` | `string`  | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.      |
+| ​ ↳ `enabled`              | `boolean` | ❌       | —       | —               | Enable the workflow after publishing. Defaults to true; pass false to publish without enabling.                      |
+| ​ ↳ `connections`          | `object`  | ❌       | —       | —               | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding.      |
+| ​ ↳ `appVersions`          | `object`  | ❌       | —       | —               | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding. |
+| ​ ↳ `trigger`              | `object`  | ❌       | —       | —               | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows.  |
+| ​   ↳ `selectedApi`        | `string`  | ❌       | —       | —               | Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured.                           |
+| ​   ↳ `action`             | `string`  | ✅       | —       | —               | Trigger action key (e.g. 'new_row')                                                                                  |
+| ​   ↳ `authenticationId`   | `string`  | ❌       | —       | —               | Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier).              |
+| ​   ↳ `params`             | `object`  | ❌       | —       | —               | Trigger parameters as a JSON object                                                                                  |
 
 **Returns:** `Promise<WorkflowVersionItem>`
 
@@ -1695,7 +1695,7 @@ Publish a new version of a durable workflow. Enables the workflow by default.
 ```typescript
 const result = await zapier.publishWorkflowVersion({
   workflow: "example-workflow",
-  source_files: {},
+  sourceFiles: {},
 });
 ```
 
@@ -1705,21 +1705,21 @@ Run a workflow source file as a run-once durable run on sdkdurableapi (no deploy
 
 **Parameters:**
 
-| Name                         | Type       | Required | Default | Possible Values | Description                                                                                                                              |
-| ---------------------------- | ---------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `options`                    | `object`   | ✅       | —       | —               |                                                                                                                                          |
-| ​ ↳ `source_files`           | `object`   | ✅       | —       | —               | Source files keyed by filename → contents                                                                                                |
-| ​ ↳ `input`                  | `unknown`  | ❌       | —       | —               | Input data passed to the run                                                                                                             |
-| ​ ↳ `dependencies`           | `object`   | ❌       | —       | —               | Optional npm package dependencies                                                                                                        |
-| ​ ↳ `zapier_durable_version` | `string`   | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.                          |
-| ​ ↳ `connections`            | `object`   | ❌       | —       | —               | Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connection_id": "123" } }`. |
-| ​ ↳ `app_versions`           | `object`   | ❌       | —       | —               | Pinned app versions. Maps app keys (slugs) to implementation names and versions.                                                         |
-| ​ ↳ `private`                | `boolean`  | ❌       | —       | —               | Only the creating user can see the run (default false)                                                                                   |
-| ​ ↳ `notifications[]`        | `object[]` | ❌       | —       | —               | Webhook subscribers for run lifecycle events. Each entry specifies a URL and the events it subscribes to.                                |
-| ​   ↳ `type`                 | `string`   | ❌       | —       | `webhook`       | Notification transport. Webhook is the only supported type.                                                                              |
-| ​   ↳ `url`                  | `string`   | ✅       | —       | —               | URL to POST event notifications to. Payload is `{run_id, event}`.                                                                        |
-| ​   ↳ `max_retries`          | `number`   | ❌       | —       | —               | Max delivery attempts with exponential backoff. Defaults to 3 server-side.                                                               |
-| ​   ↳ `events`               | `array`    | ✅       | —       | —               | One or more lifecycle events to subscribe this URL to.                                                                                   |
+| Name                       | Type       | Required | Default | Possible Values | Description                                                                                                                             |
+| -------------------------- | ---------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`                  | `object`   | ✅       | —       | —               |                                                                                                                                         |
+| ​ ↳ `sourceFiles`          | `object`   | ✅       | —       | —               | Source files keyed by filename → contents                                                                                               |
+| ​ ↳ `input`                | `unknown`  | ❌       | —       | —               | Input data passed to the run                                                                                                            |
+| ​ ↳ `dependencies`         | `object`   | ❌       | —       | —               | Optional npm package dependencies                                                                                                       |
+| ​ ↳ `zapierDurableVersion` | `string`   | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.                         |
+| ​ ↳ `connections`          | `object`   | ❌       | —       | —               | Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connectionId": "123" } }`. |
+| ​ ↳ `appVersions`          | `object`   | ❌       | —       | —               | Pinned app versions. Maps app keys (slugs) to implementation names and versions.                                                        |
+| ​ ↳ `private`              | `boolean`  | ❌       | —       | —               | Only the creating user can see the run (default false)                                                                                  |
+| ​ ↳ `notifications[]`      | `object[]` | ❌       | —       | —               | Webhook subscribers for run lifecycle events. Each entry specifies a URL and the events it subscribes to.                               |
+| ​   ↳ `type`               | `string`   | ❌       | —       | `webhook`       | Notification transport. Webhook is the only supported type.                                                                             |
+| ​   ↳ `url`                | `string`   | ✅       | —       | —               | URL to POST event notifications to. Payload is `{run_id, event}`.                                                                       |
+| ​   ↳ `max_retries`        | `number`   | ❌       | —       | —               | Max delivery attempts with exponential backoff. Defaults to 3 server-side.                                                              |
+| ​   ↳ `events`             | `array`    | ✅       | —       | —               | One or more lifecycle events to subscribe this URL to.                                                                                  |
 
 **Returns:** `Promise<DurableRunItem>`
 
@@ -1735,7 +1735,7 @@ Run a workflow source file as a run-once durable run on sdkdurableapi (no deploy
 
 ```typescript
 const result = await zapier.runDurable({
-  source_files: {},
+  sourceFiles: {},
 });
 ```
 

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAokDjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AA0kDjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}

package/dist/api/client.js

@@ -13,6 +13,7 @@ import { getZapierBaseUrl, isLocalhostBaseUrl } from "../utils/url-utils";
 import { sleep, calculateExponentialBackoffMs } from "../utils/retry-utils";
 import { isPlainObject } from "../utils/type-guard-utils";
 import { isAbortError } from "../utils/abort-utils";
+import { getCallerContext } from "../utils/caller-context";
 import { createSseParserStream, jsonFrames, } from "./sse-parser";
 import { consumeApprovalReviewStream } from "./approval-review-stream";
 import { ZapierApiError, ZapierApprovalError, ZapierAuthenticationError, ZapierConfigurationError, ZapierTimeoutError, ZapierValidationError, ZapierResourceNotFoundError, ZapierRateLimitError, } from "../types/errors";
@@ -771,6 +772,10 @@ class ZapierApiClient {
             headers.set("x-zapier-sdk-package", callerPackage.name);
             headers.set("zapier-sdk-package-version", callerPackage.version);
             headers.set("x-zapier-sdk-package-version", callerPackage.version);
+            const { packageOperation } = getCallerContext();
+            if (packageOperation) {
+                headers.set("zapier-sdk-package-operation", packageOperation);
+            }
         }
     }
     // Helper to perform HTTP requests with JSON handling

package/dist/experimental.cjs

@@ -475,22 +475,34 @@ function createValidator(schema, { adaptError } = {}) {
   };
 }
 var validateOptions = (schema, options, { adaptError } = {}) => parseOrThrow(schema, options, { adaptError });
-var scopeStore = null;
-try {
-  scopeStore = new async_hooks.AsyncLocalStorage();
-} catch {
+function createAsyncContext() {
+  let store = null;
+  try {
+    store = new async_hooks.AsyncLocalStorage();
+  } catch {
+    store = null;
+  }
+  return {
+    available: store !== null,
+    run(value, fn) {
+      return store ? store.run(value, fn) : fn();
+    },
+    get() {
+      return store?.getStore();
+    }
+  };
 }
+var scope = createAsyncContext();
 function getCurrentScope() {
-  if (!scopeStore) return void 0;
-  return scopeStore.getStore();
+  return scope.get();
 }
 function getCurrentDepth() {
   return getCurrentScope()?.depth ?? 0;
 }
 function runInMethodScope(fn) {
-  if (!scopeStore) return fn();
-  const currentDepth = scopeStore.getStore()?.depth ?? -1;
-  return scopeStore.run({ depth: currentDepth + 1 }, fn);
+  if (!scope.available) return fn();
+  const currentDepth = scope.get()?.depth ?? -1;
+  return scope.run({ depth: currentDepth + 1 }, fn);
 }
 var runWithTelemetryContext = runInMethodScope;
 function normalizeError(error, adaptError) {
@@ -2868,10 +2880,10 @@ function mergeScopes(credentialsScope, requiredScopes) {
   return [...scopeSet].sort();
 }
 async function exchangeClientCredentials(options) {
-  const { clientId, clientSecret, baseUrl, scope, requiredScopes, onEvent } = options;
+  const { clientId, clientSecret, baseUrl, scope: scope2, requiredScopes, onEvent } = options;
   const fetchFn = options.fetch || globalThis.fetch;
   const tokenUrl = getTokenEndpointUrl(baseUrl);
-  const mergedScopes = mergeScopes(scope, requiredScopes);
+  const mergedScopes = mergeScopes(scope2, requiredScopes);
   const scopeString = mergedScopes.join(" ");
   onEvent?.({
     type: "auth_exchanging",
@@ -3136,6 +3148,25 @@ async function invalidateCredentialsToken(options) {
   }
 }
 
+// src/utils/caller-context.ts
+var callerContext = createAsyncContext();
+function runWithCallerContext(context, fn) {
+  let parent;
+  try {
+    parent = callerContext.get() ?? {};
+  } catch {
+    return fn();
+  }
+  return callerContext.run({ ...parent, ...context }, fn);
+}
+function getCallerContext() {
+  try {
+    return callerContext.get() ?? {};
+  } catch {
+    return {};
+  }
+}
+
 // src/api/sse-parser.ts
 async function* jsonFrames(source) {
   for await (const { data } of source) {
@@ -3287,7 +3318,7 @@ function parseApprovalReviewStreamPayload(parsed, toolNames) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.73.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.74.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -4011,6 +4042,10 @@ var ZapierApiClient = class {
       headers.set("x-zapier-sdk-package", callerPackage.name);
       headers.set("zapier-sdk-package-version", callerPackage.version);
       headers.set("x-zapier-sdk-package-version", callerPackage.version);
+      const { packageOperation } = getCallerContext();
+      if (packageOperation) {
+        headers.set("zapier-sdk-package-operation", packageOperation);
+      }
     }
   }
   // Helper to perform HTTP requests with JSON handling
@@ -6086,10 +6121,10 @@ var actionItemFormatter = {
 // src/plugins/eventEmission/method-metadata.ts
 var SCOPE_KEY = "methodMetadata";
 function setMethodMetadata(metadata) {
-  const scope = getCurrentScope();
-  if (!scope) return;
-  const existing = scope[SCOPE_KEY];
-  scope[SCOPE_KEY] = { ...existing, ...metadata };
+  const scope2 = getCurrentScope();
+  if (!scope2) return;
+  const existing = scope2[SCOPE_KEY];
+  scope2[SCOPE_KEY] = { ...existing, ...metadata };
 }
 function getMethodMetadata() {
   return getCurrentScope()?.[SCOPE_KEY];
@@ -11756,13 +11791,62 @@ var getTriggerInputFieldsSchemaPlugin = definePlugin(
     }
   })
 );
-
-// src/plugins/codeSubstrate/shared.ts
 var codeSubstrateDefaults = {
   categories: ["code-workflow"],
   experimental: true
 };
+var SourceFilesSchema = zod.z.record(zod.z.string(), zod.z.string()).refine((files) => Object.keys(files).length > 0, {
+  message: "sourceFiles must contain at least one file"
+}).describe("Source files keyed by filename \u2192 contents");
+var UUID_PATTERN = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+var ConnectionIdValueSchema = zod.z.union([
+  zod.z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
+  zod.z.string().regex(UUID_PATTERN, "must be a UUID"),
+  zod.z.number().int().positive()
+]).describe(
+  "Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections)."
+);
 var ConnectionBindingSchema = zod.z.object({
+  connectionId: ConnectionIdValueSchema.optional(),
+  /** @deprecated Use `connectionId` instead. */
+  connection_id: ConnectionIdValueSchema.optional().meta({ deprecated: true })
+});
+var AppVersionBindingSchema = zod.z.object({
+  implementationName: zod.z.string().min(1).optional().describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
+  /** @deprecated Use `implementationName` instead. */
+  implementation_name: zod.z.string().min(1).optional().meta({ deprecated: true }),
+  version: zod.z.string().optional().describe("Pinned app version (e.g. `1.27.1`). Latest if omitted.")
+});
+function toWireConnections(connections) {
+  const wire = {};
+  for (const [alias, entry] of Object.entries(connections)) {
+    const connectionId = entry.connectionId ?? entry.connection_id;
+    if (connectionId === void 0) {
+      throw new ZapierValidationError(
+        `connections["${alias}"] is missing connectionId`
+      );
+    }
+    wire[alias] = { connection_id: connectionId };
+  }
+  return wire;
+}
+function toWireAppVersions(appVersions) {
+  const wire = {};
+  for (const [key, entry] of Object.entries(appVersions)) {
+    const implementationName = entry.implementationName ?? entry.implementation_name;
+    if (implementationName === void 0) {
+      throw new ZapierValidationError(
+        `appVersions["${key}"] is missing implementationName`
+      );
+    }
+    wire[key] = {
+      implementation_name: implementationName,
+      ...entry.version !== void 0 ? { version: entry.version } : {}
+    };
+  }
+  return wire;
+}
+var ConnectionBindingSchema2 = zod.z.object({
   connection_id: zod.z.union([
     zod.z.number().int().positive(),
     zod.z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
@@ -11773,7 +11857,7 @@ var ConnectionBindingSchema = zod.z.object({
 }).describe(
   "Connection binding: maps a single alias to a concrete connection."
 );
-var AppVersionBindingSchema = zod.z.object({
+var AppVersionBindingSchema2 = zod.z.object({
   implementation_name: zod.z.string().describe("App implementation identifier (e.g. 'SlackCLIAPI')"),
   version: zod.z.string().optional().describe("App implementation version (e.g. '1.27.1')")
 }).describe("App-version binding: maps a single alias to an app version.");
@@ -11891,8 +11975,8 @@ var WorkflowVersionSchema = zod.z.object({
   trigger: WorkflowVersionTriggerConfigSchema.nullable().describe(
     "Trigger configuration persisted on this version, or null for webhook-only workflows."
   ),
-  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).nullable().describe("Connection aliases bound on this version (or null)."),
-  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullable().describe("App-version pins bound on this version (or null).")
+  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema2).nullable().describe("Connection aliases bound on this version (or null)."),
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema2).nullable().describe("App-version pins bound on this version (or null).")
 });
 var GetWorkflowOptionsSchema = zod.z.object({
   workflow: zod.z.string().uuid().describe("Durable workflow ID")
@@ -12343,19 +12427,6 @@ var getDurableRunPlugin = definePlugin(
     }
   })
 );
-var ConnectionMapEntrySchema = zod.z.object({
-  connection_id: zod.z.union([
-    zod.z.string().regex(/^[1-9][0-9]*$/, "must be a positive integer string"),
-    zod.z.string().uuid("must be a UUID"),
-    zod.z.number().int().positive()
-  ]).describe(
-    "Zapier connection ID. Accepts a positive integer (legacy) or a UUID string (newer connections)."
-  )
-});
-var AppVersionMapEntrySchema = zod.z.object({
-  implementation_name: zod.z.string().min(1).describe("Zapier app implementation name (e.g. `SlackCLIAPI`)"),
-  version: zod.z.string().optional().describe("Pinned app version (e.g. `1.27.1`). Latest if omitted.")
-});
 var RunNotificationEventSchema = zod.z.enum(["started", "progress", "completed", "error", "cancelled"]).describe("Run lifecycle event this notification subscribes to");
 var RunNotificationSchema = zod.z.object({
   type: zod.z.literal("webhook").optional().describe("Notification transport. Webhook is the only supported type."),
@@ -12369,28 +12440,37 @@ var RunNotificationSchema = zod.z.object({
 }).describe(
   "Webhook subscriber for run lifecycle events. Server POSTs `{run_id, event}` on each subscribed transition."
 );
-var RunDurableOptionsSchema = zod.z.object({
-  source_files: zod.z.record(zod.z.string(), zod.z.string()).refine((files) => Object.keys(files).length > 0, {
-    message: "source_files must contain at least one file"
-  }).describe("Source files keyed by filename \u2192 contents"),
+var RunDurableBaseSchema = zod.z.object({
   input: zod.z.unknown().optional().describe("Input data passed to the run"),
   dependencies: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Optional npm package dependencies"),
-  zapier_durable_version: zod.z.string().optional().describe(
+  zapierDurableVersion: zod.z.string().optional().describe(
     'Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.'
   ),
-  connections: zod.z.record(zod.z.string(), ConnectionMapEntrySchema).optional().describe(
-    'Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connection_id": "123" } }`.'
+  /** @deprecated Use `zapierDurableVersion` instead. */
+  zapier_durable_version: zod.z.string().optional().meta({ deprecated: true }),
+  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).optional().describe(
+    'Named connection aliases. Maps each alias to an object holding its Zapier connection ID, e.g. `{ "slack": { "connectionId": "123" } }`.'
   ),
-  app_versions: zod.z.record(zod.z.string(), AppVersionMapEntrySchema).optional().describe(
+  appVersions: zod.z.record(zod.z.string(), AppVersionBindingSchema).optional().describe(
     "Pinned app versions. Maps app keys (slugs) to implementation names and versions."
   ),
+  /** @deprecated Use `appVersions` instead. */
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).optional().meta({ deprecated: true }),
   private: zod.z.boolean().optional().describe("Only the creating user can see the run (default false)"),
   notifications: zod.z.array(RunNotificationSchema).optional().describe(
     "Webhook subscribers for run lifecycle events. Each entry specifies a URL and the events it subscribes to."
   )
-}).describe(
-  "Run a workflow source file as a run-once durable run on sdkdurableapi (no deployed workflow required). Returns the run ID immediately; poll via getDurableRun for terminal status."
-);
+});
+var RunDurableDescription = "Run a workflow source file as a run-once durable run on sdkdurableapi (no deployed workflow required). Returns the run ID immediately; poll via getDurableRun for terminal status.";
+var RunDurableSchema = zod.z.object({ sourceFiles: SourceFilesSchema }).merge(RunDurableBaseSchema).describe(RunDurableDescription).meta({
+  aliases: {
+    source_files: "sourceFiles",
+    zapier_durable_version: "zapierDurableVersion",
+    app_versions: "appVersions"
+  }
+});
+var RunDurableSchemaDeprecated = zod.z.object({ source_files: SourceFilesSchema }).merge(RunDurableBaseSchema);
+var RunDurableOptionsSchema = zod.z.union([RunDurableSchema, RunDurableSchemaDeprecated]).describe(RunDurableDescription);
 var RunDurableResponseSchema = zod.z.object({
   id: zod.z.string().describe("Run ID (UUID) \u2014 server-generated, time-sortable"),
   status: zod.z.literal("initialized").describe(
@@ -12412,23 +12492,24 @@ var runDurablePlugin = definePlugin(
     inputSchema: RunDurableOptionsSchema,
     outputSchema: RunDurableResponseSchema,
     handler: async ({ sdk: sdk2, options }) => {
-      const body = {
-        source_files: options.source_files
-      };
+      const sourceFiles = "sourceFiles" in options ? options.sourceFiles : options.source_files;
+      const zapierDurableVersion = options.zapierDurableVersion ?? options.zapier_durable_version;
+      const appVersions = options.appVersions ?? options.app_versions;
+      const body = { source_files: sourceFiles };
       if (options.input !== void 0) {
         body.input = options.input;
       }
       if (options.dependencies !== void 0) {
         body.dependencies = options.dependencies;
       }
-      if (options.zapier_durable_version !== void 0) {
-        body.zapier_durable_version = options.zapier_durable_version;
+      if (zapierDurableVersion !== void 0) {
+        body.zapier_durable_version = zapierDurableVersion;
       }
       if (options.connections !== void 0) {
-        body.connections = options.connections;
+        body.connections = toWireConnections(options.connections);
       }
-      if (options.app_versions !== void 0) {
-        body.app_versions = options.app_versions;
+      if (appVersions !== void 0) {
+        body.app_versions = toWireAppVersions(appVersions);
       }
       if (options.private !== void 0) {
         body.is_private = options.private;
@@ -12483,30 +12564,61 @@ var cancelDurableRunPlugin = definePlugin(
     }
   })
 );
-var PublishWorkflowVersionOptionsSchema = zod.z.object({
-  workflow: zod.z.string().uuid().describe("Durable workflow ID"),
-  source_files: zod.z.record(zod.z.string(), zod.z.string()).refine((files) => Object.keys(files).length > 0, {
-    message: "source_files must contain at least one file"
-  }).describe("Source files keyed by filename \u2192 contents"),
+var TriggerConfigSchema = zod.z.object({
+  selectedApi: zod.z.string().optional().describe(
+    "Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured."
+  ),
+  /** @deprecated Use `selectedApi` instead. */
+  selected_api: zod.z.string().optional().meta({ deprecated: true }),
+  action: zod.z.string().describe("Trigger action key (e.g. 'new_row')"),
+  authenticationId: zod.z.string().nullish().describe(
+    "Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier)."
+  ),
+  /** @deprecated Use `authenticationId` instead. */
+  authentication_id: zod.z.string().nullish().meta({ deprecated: true }),
+  params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Trigger parameters as a JSON object")
+}).describe(
+  "Zapier trigger configuration. When set, the workflow subscribes to trigger events."
+);
+var PublishWorkflowVersionDescription = "Publish a new version of a durable workflow. Enables the workflow by default.";
+var PublishWorkflowVersionBaseSchema = zod.z.object({
   dependencies: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Optional npm package dependencies"),
-  zapier_durable_version: zod.z.string().optional().describe(
+  zapierDurableVersion: zod.z.string().optional().describe(
     'Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted.'
   ),
+  /** @deprecated Use `zapierDurableVersion` instead. */
+  zapier_durable_version: zod.z.string().optional().meta({ deprecated: true }),
   enabled: zod.z.boolean().optional().describe(
     "Enable the workflow after publishing. Defaults to true; pass false to publish without enabling."
   ),
   connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).nullish().describe(
     "Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding."
   ),
-  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullish().describe(
+  appVersions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullish().describe(
     "Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding."
   ),
-  trigger: WorkflowVersionTriggerConfigSchema.optional().describe(
+  /** @deprecated Use `appVersions` instead. */
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullish().meta({ deprecated: true }),
+  trigger: TriggerConfigSchema.optional().describe(
     "Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows."
   )
-}).describe(
-  "Publish a new version of a durable workflow. Enables the workflow by default."
-);
+});
+var WorkflowPropertySchema = zod.z.string().uuid().describe("Durable workflow ID");
+var PublishWorkflowVersionSchema = zod.z.object({
+  workflow: WorkflowPropertySchema,
+  sourceFiles: SourceFilesSchema
+}).merge(PublishWorkflowVersionBaseSchema).describe(PublishWorkflowVersionDescription).meta({
+  aliases: {
+    source_files: "sourceFiles",
+    zapier_durable_version: "zapierDurableVersion",
+    app_versions: "appVersions"
+  }
+});
+var PublishWorkflowVersionSchemaDeprecated = zod.z.object({
+  workflow: WorkflowPropertySchema,
+  source_files: SourceFilesSchema
+}).merge(PublishWorkflowVersionBaseSchema);
+var PublishWorkflowVersionOptionsSchema = zod.z.union([PublishWorkflowVersionSchema, PublishWorkflowVersionSchemaDeprecated]).describe(PublishWorkflowVersionDescription);
 var PublishWorkflowVersionResponseSchema = zod.z.object({
   id: zod.z.string().describe("Workflow version ID (UUID)"),
   workflow_id: zod.z.string().describe("Parent workflow ID (UUID)"),
@@ -12520,11 +12632,30 @@ var PublishWorkflowVersionResponseSchema = zod.z.object({
   trigger: WorkflowVersionTriggerConfigSchema.nullable().describe(
     "Trigger configuration persisted on this version, or null for webhook-only workflows."
   ),
-  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).nullable().describe("Connection aliases bound on this version (or null)."),
-  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullable().describe("App-version pins bound on this version (or null).")
+  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema2).nullable().describe("Connection aliases bound on this version (or null)."),
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema2).nullable().describe("App-version pins bound on this version (or null).")
 });
 
 // src/plugins/codeSubstrate/publishWorkflowVersion/index.ts
+function toWireTrigger(trigger) {
+  const selectedApi = trigger.selectedApi ?? trigger.selected_api;
+  if (selectedApi === void 0) {
+    throw new ZapierValidationError("trigger is missing selectedApi");
+  }
+  const wire = {
+    selected_api: selectedApi,
+    action: trigger.action
+  };
+  if ("authenticationId" in trigger) {
+    wire.authentication_id = trigger.authenticationId;
+  } else if ("authentication_id" in trigger) {
+    wire.authentication_id = trigger.authentication_id;
+  }
+  if (trigger.params !== void 0) {
+    wire.params = trigger.params;
+  }
+  return wire;
+}
 var publishWorkflowVersionPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {
     ...codeSubstrateDefaults,
@@ -12535,26 +12666,31 @@ var publishWorkflowVersionPlugin = definePlugin(
     outputSchema: PublishWorkflowVersionResponseSchema,
     resolvers: { workflow: workflowIdResolver },
     handler: async ({ sdk: sdk2, options }) => {
-      const body = {
-        source_files: options.source_files
-      };
+      const sourceFiles = "sourceFiles" in options ? options.sourceFiles : options.source_files;
+      const zapierDurableVersion = options.zapierDurableVersion ?? options.zapier_durable_version;
+      const appVersions = "appVersions" in options ? options.appVersions : options.app_versions;
+      const body = { source_files: sourceFiles };
       if (options.dependencies !== void 0) {
         body.dependencies = options.dependencies;
       }
-      if (options.zapier_durable_version !== void 0) {
-        body.zapier_durable_version = options.zapier_durable_version;
+      if (zapierDurableVersion !== void 0) {
+        body.zapier_durable_version = zapierDurableVersion;
       }
       if (options.enabled !== void 0) {
         body.enabled = options.enabled;
       }
-      if (options.connections !== void 0) {
-        body.connections = options.connections;
+      if (options.connections === null) {
+        body.connections = null;
+      } else if (options.connections !== void 0) {
+        body.connections = toWireConnections(options.connections);
       }
-      if (options.app_versions !== void 0) {
-        body.app_versions = options.app_versions;
+      if (appVersions === null) {
+        body.app_versions = null;
+      } else if (appVersions !== void 0) {
+        body.app_versions = toWireAppVersions(appVersions);
       }
       if (options.trigger !== void 0) {
-        body.trigger = options.trigger;
+        body.trigger = toWireTrigger(options.trigger);
       }
       const raw = await sdk2.context.api.post(
         `/durableworkflowzaps/api/v0/workflows/${encodeURIComponent(options.workflow)}/versions`,
@@ -12581,8 +12717,8 @@ var WorkflowVersionListItemSchema = zod.z.object({
   trigger: WorkflowVersionTriggerConfigSchema.nullable().describe(
     "Trigger configuration persisted on this version, or null for webhook-only workflows."
   ),
-  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).nullable().describe("Connection aliases bound on this version (or null)."),
-  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullable().describe("App-version pins bound on this version (or null).")
+  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema2).nullable().describe("Connection aliases bound on this version (or null)."),
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema2).nullable().describe("App-version pins bound on this version (or null).")
 });
 var ListWorkflowVersionsOptionsSchema = zod.z.object({
   workflow: zod.z.string().uuid().describe("Durable workflow ID"),
@@ -12654,8 +12790,8 @@ var GetWorkflowVersionResponseSchema = zod.z.object({
   trigger: WorkflowVersionTriggerConfigSchema.nullable().describe(
     "Trigger configuration persisted on this version, or null for webhook-only workflows."
   ),
-  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema).nullable().describe("Connection aliases bound on this version (or null)."),
-  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema).nullable().describe("App-version pins bound on this version (or null).")
+  connections: zod.z.record(zod.z.string(), ConnectionBindingSchema2).nullable().describe("Connection aliases bound on this version (or null)."),
+  app_versions: zod.z.record(zod.z.string(), AppVersionBindingSchema2).nullable().describe("App-version pins bound on this version (or null).")
 });
 
 // src/plugins/codeSubstrate/getWorkflowVersion/index.ts
@@ -13226,6 +13362,7 @@ exports.getActionPlugin = getActionPlugin;
 exports.getAgent = getAgent;
 exports.getAppPlugin = getAppPlugin;
 exports.getBaseUrlFromCredentials = getBaseUrlFromCredentials;
+exports.getCallerContext = getCallerContext;
 exports.getCiPlatform = getCiPlatform;
 exports.getClientIdFromCredentials = getClientIdFromCredentials;
 exports.getConnectionPlugin = getConnectionPlugin;
@@ -13284,6 +13421,7 @@ exports.resolveCredentials = resolveCredentials;
 exports.resolveCredentialsFromEnv = resolveCredentialsFromEnv;
 exports.runActionPlugin = runActionPlugin;
 exports.runInMethodScope = runInMethodScope;
+exports.runWithCallerContext = runWithCallerContext;
 exports.runWithTelemetryContext = runWithTelemetryContext;
 exports.tableFieldIdsResolver = tableFieldIdsResolver;
 exports.tableFieldsResolver = tableFieldsResolver;