@zapier/zapier-sdk 0.62.0 → 0.64.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.64.0
+
+### Minor Changes
+
+- 913aa6b: Add the workflow-version experimental code-substrate plugins: `publishWorkflowVersion`, `listWorkflowVersions`, and `getWorkflowVersion`. All three are registered only in `@zapier/zapier-sdk/experimental`; the stable subpath does not expose them. `listWorkflowVersions` is paginated (cursor + pageSize); `publishWorkflowVersion` POSTs `source_files` (filename → contents) plus optional `dependencies`, `zapier_durable_version`, and `enabled` (defaults to true) to publish a new version; `getWorkflowVersion` returns the full version state including source files. Handlers pass API responses through verbatim (no client-side `.parse()` re-emission) so callers see any richer fields the server adds later without an SDK release. Adds `workflowVersionIdResolver` — a dependent resolver scoped to a parent workflow, mirrored on `tableRecordIdResolver`'s shape — so commands that take a version id present an interactive picker via `sdk.listWorkflowVersions({ workflow })` in the CLI. All ID inputs are UUID-validated at the boundary so non-UUID strings fail with a clear schema error instead of an opaque 500 from the backend's `::uuid` cast.
+
+## 0.63.0
+
+### Minor Changes
+
+- dfa3cea: Add the durable-run-write experimental code-substrate plugins: `runDurable` and `cancelDurableRun`. Both are registered only in `@zapier/zapier-sdk/experimental`; the stable subpath does not expose them. `runDurable` POSTs to sdkdurableapi `/api/v0/runs` with `source_files` (filename → contents), optional `input`/`dependencies`/`zapier_durable_version`/`connections`/`app_versions`, and a `private` input that maps to `is_private` on the wire. Returns the run ID immediately in `initialized` status — callers that need terminal status poll via `getDurableRun`; no built-in polling. `cancelDurableRun` POSTs to `/api/v0/runs/:id/cancel`, returns `{ id, status: "cancelled" }` on success, and propagates `ZapierNotFoundError` (404) and `ZapierConflictError` (409 — run already terminal) so callers can distinguish those outcomes. `runDurable` passes the API response through verbatim (no client-side `.parse()` re-emission) so callers see any richer fields the server adds later without an SDK release. Input field naming follows the in-tree convention (`run` rather than `runId`); UUID-validated at the input boundary. `cancelDurableRun` reuses `durableRunIdResolver` from the reads MR for ID pickers.
+
 ## 0.62.0
 
 ### Minor Changes

package/README.md

@@ -27,14 +27,19 @@
   - [`deleteClientCredentials`](#deleteclientcredentials)
   - [`listClientCredentials`](#listclientcredentials)
 - [Code Workflows (Experimental)](#code-workflows-experimental)
+  - [`cancelDurableRun`](#canceldurablerun--experimental)
   - [`createWorkflow`](#createworkflow--experimental)
   - [`deleteWorkflow`](#deleteworkflow--experimental)
   - [`disableWorkflow`](#disableworkflow--experimental)
   - [`enableWorkflow`](#enableworkflow--experimental)
   - [`getDurableRun`](#getdurablerun--experimental)
   - [`getWorkflow`](#getworkflow--experimental)
+  - [`getWorkflowVersion`](#getworkflowversion--experimental)
   - [`listDurableRuns`](#listdurableruns--experimental)
+  - [`listWorkflowVersions`](#listworkflowversions--experimental)
   - [`listWorkflows`](#listworkflows--experimental)
+  - [`publishWorkflowVersion`](#publishworkflowversion--experimental)
+  - [`runDurable`](#rundurable--experimental)
   - [`updateWorkflow`](#updateworkflow--experimental)
 - [Connections](#connections)
   - [`findFirstConnection`](#findfirstconnection)
@@ -1094,6 +1099,27 @@ for await (const clientCredentials of zapier.listClientCredentials().items()) {
 
 > ℹ️ **Experimental.** Import from `"@zapier/zapier-sdk/experimental"` to use these methods. Methods and behavior may change.
 
+#### `cancelDurableRun` 🧪 _experimental_
+
+Cancel a run-once durable run in initialized or started status. Returns 409 if the run is already terminal.
+
+**Parameters:**
+
+| Name      | Type     | Required | Default | Possible Values | Description    |
+| --------- | -------- | -------- | ------- | --------------- | -------------- |
+| `options` | `object` | ✅       | —       | —               |                |
+| ​ ↳ `run` | `string` | ✅       | —       | —               | Durable run ID |
+
+**Returns:** `Promise<DurableRunItem>`
+
+**Example:**
+
+```typescript
+const result = await zapier.cancelDurableRun({
+  run: "example-run",
+});
+```
+
 #### `createWorkflow` 🧪 _experimental_
 
 Create a durable workflow container. Starts disabled with no version; publish a version to add code.
@@ -1275,6 +1301,40 @@ const { data: workflow } = await zapier.getWorkflow({
 });
 ```
 
+#### `getWorkflowVersion` 🧪 _experimental_
+
+Get full details of a workflow version including source files
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description         |
+| -------------- | -------- | -------- | ------- | --------------- | ------------------- |
+| `options`      | `object` | ✅       | —       | —               |                     |
+| ​ ↳ `workflow` | `string` | ✅       | —       | —               | Durable workflow ID |
+| ​ ↳ `version`  | `string` | ✅       | —       | —               | Workflow version ID |
+
+**Returns:** `Promise<WorkflowVersionItem>`
+
+| Name                         | Type     | Required | Possible Values | Description                                                         |
+| ---------------------------- | -------- | -------- | --------------- | ------------------------------------------------------------------- |
+| `data`                       | `object` | ✅       | —               |                                                                     |
+| ​ ↳ `id`                     | `string` | ✅       | —               | Workflow version ID (UUID)                                          |
+| ​ ↳ `workflow_id`            | `string` | ✅       | —               | Parent workflow ID (UUID)                                           |
+| ​ ↳ `source_files`           | `object` | ✅       | —               | Source files keyed by filename → contents                           |
+| ​ ↳ `zapier_durable_version` | `string` | ✅       | —               | Pinned semver of @zapier/zapier-durable used by this version's runs |
+| ​ ↳ `dependencies`           | `object` | ✅       | —               | Additional npm dependencies pinned for this version (or null)       |
+| ​ ↳ `created_by_user_id`     | `string` | ✅       | —               | ID of the user who published this version                           |
+| ​ ↳ `created_at`             | `string` | ✅       | —               | When the version was published (ISO-8601)                           |
+
+**Example:**
+
+```typescript
+const { data: workflowVersion } = await zapier.getWorkflowVersion({
+  workflow: "example-workflow",
+  version: "example-version",
+});
+```
+
 #### `listDurableRuns` 🧪 _experimental_
 
 List run-once durable runs for the authenticated account, newest first
@@ -1321,6 +1381,59 @@ for await (const durableRun of zapier.listDurableRuns().items()) {
 }
 ```
 
+#### `listWorkflowVersions` 🧪 _experimental_
+
+List published versions for a workflow, newest first
+
+**Parameters:**
+
+| Name           | Type     | Required | Default | Possible Values | Description                                       |
+| -------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------- |
+| `options`      | `object` | ✅       | —       | —               |                                                   |
+| ​ ↳ `workflow` | `string` | ✅       | —       | —               | Durable workflow ID                               |
+| ​ ↳ `pageSize` | `number` | ❌       | —       | —               | Number of versions per page (max 100)             |
+| ​ ↳ `cursor`   | `string` | ❌       | —       | —               | Pagination cursor                                 |
+| ​ ↳ `maxItems` | `number` | ❌       | —       | —               | Maximum total versions to return across all pages |
+
+**Returns:** `Promise<PaginatedResult<WorkflowVersionItem>>`
+
+| Name                         | Type       | Required | Possible Values | Description                                                         |
+| ---------------------------- | ---------- | -------- | --------------- | ------------------------------------------------------------------- |
+| `data[]`                     | `object[]` | ✅       | —               |                                                                     |
+| ​ ↳ `id`                     | `string`   | ✅       | —               | Workflow version ID (UUID)                                          |
+| ​ ↳ `workflow_id`            | `string`   | ✅       | —               | Parent workflow ID (UUID)                                           |
+| ​ ↳ `zapier_durable_version` | `string`   | ✅       | —               | Pinned semver of @zapier/zapier-durable used by this version's runs |
+| ​ ↳ `dependencies`           | `object`   | ✅       | —               | Additional npm dependencies pinned for this version (or null)       |
+| ​ ↳ `created_by_user_id`     | `string`   | ✅       | —               | ID of the user who published this version                           |
+| ​ ↳ `created_at`             | `string`   | ✅       | —               | When the version was published (ISO-8601)                           |
+| `nextCursor`                 | `string`   | ❌       | —               | Cursor for the next page; omitted when there are no more pages      |
+
+**Example:**
+
+```typescript
+// Get first page and a cursor for the second page
+const { data: workflowVersions, nextCursor } =
+  await zapier.listWorkflowVersions({
+    workflow: "example-workflow",
+  });
+
+// Or iterate over all pages
+for await (const page of zapier.listWorkflowVersions({
+  workflow: "example-workflow",
+})) {
+  // Do something with each page
+}
+
+// Or iterate over individual items across all pages
+for await (const workflowVersion of zapier
+  .listWorkflowVersions({
+    workflow: "example-workflow",
+  })
+  .items()) {
+  // Do something with each workflowVersion
+}
+```
+
 #### `listWorkflows` 🧪 _experimental_
 
 List all active durable workflows for the authenticated account
@@ -1366,6 +1479,78 @@ for await (const workflow of zapier.listWorkflows().items()) {
 }
 ```
 
+#### `publishWorkflowVersion` 🧪 _experimental_
+
+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.                 |
+
+**Returns:** `Promise<WorkflowVersionItem>`
+
+| Name                         | Type     | Required | Possible Values | Description                                                         |
+| ---------------------------- | -------- | -------- | --------------- | ------------------------------------------------------------------- |
+| `data`                       | `object` | ✅       | —               |                                                                     |
+| ​ ↳ `id`                     | `string` | ✅       | —               | Workflow version ID (UUID)                                          |
+| ​ ↳ `workflow_id`            | `string` | ✅       | —               | Parent workflow ID (UUID)                                           |
+| ​ ↳ `source_files`           | `object` | ✅       | —               | Source files keyed by filename → contents                           |
+| ​ ↳ `zapier_durable_version` | `string` | ✅       | —               | Pinned semver of @zapier/zapier-durable used by this version's runs |
+| ​ ↳ `dependencies`           | `object` | ✅       | —               | Additional npm dependencies pinned for this version (or null)       |
+| ​ ↳ `created_by_user_id`     | `string` | ✅       | —               | ID of the user who published this version                           |
+| ​ ↳ `created_at`             | `string` | ✅       | —               | When the version was published (ISO-8601)                           |
+
+**Example:**
+
+```typescript
+const result = await zapier.publishWorkflowVersion({
+  workflow: "example-workflow",
+  source_files: {},
+});
+```
+
+#### `runDurable` 🧪 _experimental_
+
+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.
+
+**Parameters:**
+
+| Name                         | Type      | Required | Default | Possible Values | Description                                                                                                     |
+| ---------------------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
+| `options`                    | `object`  | ✅       | —       | —               |                                                                                                                 |
+| ​ ↳ `source_files`           | `object`  | ✅       | —       | —               | Source files keyed by filename → contents                                                                       |
+| ​ ↳ `input`                  | `string`  | ❌       | —       | —               | 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 alias names to Zapier connection IDs.                                            |
+| ​ ↳ `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)                                                          |
+
+**Returns:** `Promise<DurableRunItem>`
+
+| Name             | Type      | Required | Possible Values | Description                                                                                                                               |
+| ---------------- | --------- | -------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `data`           | `object`  | ✅       | —               |                                                                                                                                           |
+| ​ ↳ `id`         | `string`  | ✅       | —               | Run ID (UUID) — server-generated, time-sortable                                                                                           |
+| ​ ↳ `status`     | `string`  | ✅       | `initialized`   | Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`. |
+| ​ ↳ `is_private` | `boolean` | ✅       | —               | When true, the run is visible only to the creating user; otherwise visible across the account.                                            |
+| ​ ↳ `created_at` | `string`  | ✅       | —               | When the run was created (ISO-8601)                                                                                                       |
+
+**Example:**
+
+```typescript
+const result = await zapier.runDurable({
+  source_files: {},
+});
+```
+
 #### `updateWorkflow` 🧪 _experimental_
 
 Update a durable workflow's name and/or description

package/dist/experimental.cjs

@@ -2889,7 +2889,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.62.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.64.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -4301,6 +4301,26 @@ var durableRunIdResolver = {
   })
 };
 
+// src/resolvers/workflowVersionId.ts
+var workflowVersionIdResolver = {
+  type: "dynamic",
+  depends: ["workflow"],
+  fetch: async (sdk, params) => toIterable(
+    sdk.listWorkflowVersions({
+      workflow: params.workflow
+    })
+  ),
+  prompt: (versions) => ({
+    type: "list",
+    name: "version",
+    message: "Select a workflow version:",
+    choices: versions.map((v) => ({
+      name: `${v.id} \u2014 ${v.zapier_durable_version}`,
+      value: v.id
+    }))
+  })
+};
+
 // src/resolvers/triggerMessages.ts
 var triggerMessagesResolver = {
   type: "dynamic",
@@ -11019,6 +11039,293 @@ 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 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"),
+  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(
+    '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 alias names to Zapier connection IDs."
+  ),
+  app_versions: zod.z.record(zod.z.string(), AppVersionMapEntrySchema).optional().describe(
+    "Pinned app versions. Maps app keys (slugs) to implementation names and versions."
+  ),
+  private: zod.z.boolean().optional().describe("Only the creating user can see the run (default false)")
+}).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 RunDurableResponseSchema = zod.z.object({
+  id: zod.z.string().describe("Run ID (UUID) \u2014 server-generated, time-sortable"),
+  status: zod.z.literal("initialized").describe(
+    "Always `initialized` on creation. Poll via getDurableRun to observe the run advancing to `started` / `finished` / `failed` / `cancelled`."
+  ),
+  is_private: zod.z.boolean().describe(
+    "When true, the run is visible only to the creating user; otherwise visible across the account."
+  ),
+  created_at: zod.z.string().describe("When the run was created (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/runDurable/index.ts
+var runDurablePlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "runDurable",
+    type: "create",
+    itemType: "DurableRun",
+    inputSchema: RunDurableOptionsSchema,
+    outputSchema: RunDurableResponseSchema,
+    handler: async ({ sdk: sdk2, options }) => {
+      const body = {
+        source_files: options.source_files
+      };
+      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 (options.connections !== void 0) {
+        body.connections = options.connections;
+      }
+      if (options.app_versions !== void 0) {
+        body.app_versions = options.app_versions;
+      }
+      if (options.private !== void 0) {
+        body.is_private = options.private;
+      }
+      const data = await sdk2.context.api.post(
+        "/sdkdurableapi/api/v0/runs",
+        body,
+        { authRequired: true }
+      );
+      return { data };
+    }
+  })
+);
+var CancelDurableRunOptionsSchema = zod.z.object({
+  run: zod.z.string().uuid().describe("Durable run ID")
+}).describe(
+  "Cancel a run-once durable run in initialized or started status. Returns 409 if the run is already terminal."
+);
+zod.z.object({
+  id: zod.z.string().describe("Run ID that was targeted"),
+  status: zod.z.literal("cancelled").describe(
+    "Always `cancelled` on a successful call. Synthesized client-side \u2014 the backend returns 204; callers needing the run's full state should follow up with getDurableRun."
+  )
+});
+
+// src/plugins/codeSubstrate/cancelDurableRun/index.ts
+var cancelDurableRunPlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "cancelDurableRun",
+    type: "update",
+    itemType: "DurableRun",
+    inputSchema: CancelDurableRunOptionsSchema,
+    resolvers: { run: durableRunIdResolver },
+    handler: async ({ sdk: sdk2, options }) => {
+      await sdk2.context.api.post(
+        `/sdkdurableapi/api/v0/runs/${encodeURIComponent(options.run)}/cancel`,
+        void 0,
+        {
+          authRequired: true,
+          resource: { type: "run", id: options.run }
+        }
+      );
+      return {
+        data: { id: options.run, status: "cancelled" }
+      };
+    }
+  })
+);
+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"),
+  dependencies: zod.z.record(zod.z.string(), zod.z.string()).optional().describe("Optional npm package dependencies"),
+  zapier_durable_version: 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.'
+  ),
+  enabled: zod.z.boolean().optional().describe(
+    "Enable the workflow after publishing. Defaults to true; pass false to publish without enabling."
+  )
+}).describe(
+  "Publish a new version of a durable workflow. Enables the workflow by default."
+);
+var PublishWorkflowVersionResponseSchema = zod.z.object({
+  id: zod.z.string().describe("Workflow version ID (UUID)"),
+  workflow_id: zod.z.string().describe("Parent workflow ID (UUID)"),
+  source_files: zod.z.record(zod.z.string(), zod.z.string()).describe("Source files keyed by filename \u2192 contents"),
+  zapier_durable_version: zod.z.string().describe(
+    "Pinned semver of @zapier/zapier-durable used by this version's runs"
+  ),
+  dependencies: zod.z.record(zod.z.string(), zod.z.string()).nullable().describe("Additional npm dependencies pinned for this version (or null)"),
+  created_by_user_id: zod.z.string().describe("ID of the user who published this version"),
+  created_at: zod.z.string().describe("When the version was published (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/publishWorkflowVersion/index.ts
+var publishWorkflowVersionPlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "publishWorkflowVersion",
+    type: "create",
+    itemType: "WorkflowVersion",
+    inputSchema: PublishWorkflowVersionOptionsSchema,
+    outputSchema: PublishWorkflowVersionResponseSchema,
+    resolvers: { workflow: workflowIdResolver },
+    handler: async ({ sdk: sdk2, options }) => {
+      const body = {
+        source_files: options.source_files
+      };
+      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 (options.enabled !== void 0) {
+        body.enabled = options.enabled;
+      }
+      const raw = await sdk2.context.api.post(
+        `/durableworkflowzaps/api/v0/workflows/${encodeURIComponent(options.workflow)}/versions`,
+        body,
+        {
+          authRequired: true,
+          resource: { type: "workflow", id: options.workflow }
+        }
+      );
+      const data = PublishWorkflowVersionResponseSchema.parse(raw);
+      return { data };
+    }
+  })
+);
+var WorkflowVersionListItemSchema = zod.z.object({
+  id: zod.z.string().describe("Workflow version ID (UUID)"),
+  workflow_id: zod.z.string().describe("Parent workflow ID (UUID)"),
+  zapier_durable_version: zod.z.string().describe(
+    "Pinned semver of @zapier/zapier-durable used by this version's runs"
+  ),
+  dependencies: zod.z.record(zod.z.string(), zod.z.string()).nullable().describe("Additional npm dependencies pinned for this version (or null)"),
+  created_by_user_id: zod.z.string().describe("ID of the user who published this version"),
+  created_at: zod.z.string().describe("When the version was published (ISO-8601)")
+});
+var ListWorkflowVersionsOptionsSchema = zod.z.object({
+  workflow: zod.z.string().uuid().describe("Durable workflow ID"),
+  pageSize: zod.z.number().int().min(1).max(100).optional().describe("Number of versions per page (max 100)"),
+  cursor: zod.z.string().optional().describe("Pagination cursor"),
+  maxItems: zod.z.number().int().min(1).optional().describe("Maximum total versions to return across all pages")
+}).describe("List published versions for a workflow, newest first");
+var ListWorkflowVersionsApiResponseSchema = zod.z.object({
+  results: zod.z.array(WorkflowVersionListItemSchema),
+  meta: zod.z.object({
+    limit: zod.z.number(),
+    cursor: zod.z.string().nullable().optional(),
+    next_cursor: zod.z.string().nullable().optional()
+  }),
+  links: zod.z.object({
+    next: zod.z.string().nullable().optional()
+  }).optional()
+});
+
+// src/plugins/codeSubstrate/listWorkflowVersions/index.ts
+var listWorkflowVersionsPlugin = definePlugin(
+  (sdk) => createPaginatedPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "listWorkflowVersions",
+    type: "list",
+    itemType: "WorkflowVersion",
+    inputSchema: ListWorkflowVersionsOptionsSchema,
+    outputSchema: WorkflowVersionListItemSchema,
+    defaultPageSize: DEFAULT_PAGE_SIZE,
+    resolvers: { workflow: workflowIdResolver },
+    handler: async ({ sdk: sdk2, options }) => {
+      const searchParams = {};
+      if (options.pageSize !== void 0) {
+        searchParams.limit = options.pageSize.toString();
+      }
+      if (options.cursor) {
+        searchParams.cursor = options.cursor;
+      }
+      const raw = await sdk2.context.api.get(
+        `/durableworkflowzaps/api/v0/workflows/${encodeURIComponent(options.workflow)}/versions`,
+        {
+          searchParams,
+          authRequired: true,
+          resource: { type: "workflow", id: options.workflow }
+        }
+      );
+      const response = ListWorkflowVersionsApiResponseSchema.parse(raw);
+      return {
+        data: response.results,
+        nextCursor: response.meta.next_cursor ?? void 0
+      };
+    }
+  })
+);
+var GetWorkflowVersionOptionsSchema = zod.z.object({
+  workflow: zod.z.string().uuid().describe("Durable workflow ID"),
+  version: zod.z.string().uuid().describe("Workflow version ID")
+}).describe("Get full details of a workflow version including source files");
+var GetWorkflowVersionResponseSchema = zod.z.object({
+  id: zod.z.string().describe("Workflow version ID (UUID)"),
+  workflow_id: zod.z.string().describe("Parent workflow ID (UUID)"),
+  source_files: zod.z.record(zod.z.string(), zod.z.string()).describe("Source files keyed by filename \u2192 contents"),
+  zapier_durable_version: zod.z.string().describe(
+    "Pinned semver of @zapier/zapier-durable used by this version's runs"
+  ),
+  dependencies: zod.z.record(zod.z.string(), zod.z.string()).nullable().describe("Additional npm dependencies pinned for this version (or null)"),
+  created_by_user_id: zod.z.string().describe("ID of the user who published this version"),
+  created_at: zod.z.string().describe("When the version was published (ISO-8601)")
+});
+
+// src/plugins/codeSubstrate/getWorkflowVersion/index.ts
+var getWorkflowVersionPlugin = definePlugin(
+  (sdk) => createPluginMethod(sdk, {
+    ...codeSubstrateDefaults,
+    name: "getWorkflowVersion",
+    type: "item",
+    itemType: "WorkflowVersion",
+    inputSchema: GetWorkflowVersionOptionsSchema,
+    outputSchema: GetWorkflowVersionResponseSchema,
+    resolvers: {
+      workflow: workflowIdResolver,
+      version: workflowVersionIdResolver
+    },
+    handler: async ({ sdk: sdk2, options }) => {
+      const raw = await sdk2.context.api.get(
+        `/durableworkflowzaps/api/v0/workflows/${encodeURIComponent(options.workflow)}/versions/${encodeURIComponent(options.version)}`,
+        {
+          authRequired: true,
+          resource: { type: "workflow-version", id: options.version }
+        }
+      );
+      const data = GetWorkflowVersionResponseSchema.parse(raw);
+      return { data };
+    }
+  })
+);
 
 // src/utils/batch-utils.ts
 var DEFAULT_CONCURRENCY = 10;
@@ -11178,7 +11485,7 @@ var registryPlugin = definePlugin((_sdk) => {
 
 // src/experimental.ts
 function createZapierSdk2(options = {}) {
-  return createSdk().addPlugin(createOptionsPlugin(options)).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listActionInputFieldsPlugin).addPlugin(getActionInputFieldsSchemaPlugin).addPlugin(listActionInputFieldChoicesPlugin).addPlugin(listInputFieldsDeprecatedPlugin).addPlugin(getInputFieldsSchemaDeprecatedPlugin).addPlugin(listInputFieldChoicesDeprecatedPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(createTriggerInboxPlugin).addPlugin(ensureTriggerInboxPlugin).addPlugin(listTriggerInboxesPlugin).addPlugin(getTriggerInboxPlugin).addPlugin(updateTriggerInboxPlugin).addPlugin(deleteTriggerInboxPlugin).addPlugin(pauseTriggerInboxPlugin).addPlugin(resumeTriggerInboxPlugin).addPlugin(listTriggerInboxMessagesPlugin).addPlugin(leaseTriggerInboxMessagesPlugin).addPlugin(ackTriggerInboxMessagesPlugin).addPlugin(releaseTriggerInboxMessagesPlugin).addPlugin(drainTriggerInboxPlugin).addPlugin(watchTriggerInboxPlugin).addPlugin(listTriggersPlugin).addPlugin(listTriggerInputFieldsPlugin).addPlugin(listTriggerInputFieldChoicesPlugin).addPlugin(getTriggerInputFieldsSchemaPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(listWorkflowsPlugin).addPlugin(getWorkflowPlugin).addPlugin(createWorkflowPlugin).addPlugin(updateWorkflowPlugin).addPlugin(enableWorkflowPlugin).addPlugin(disableWorkflowPlugin).addPlugin(deleteWorkflowPlugin).addPlugin(listDurableRunsPlugin).addPlugin(getDurableRunPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
+  return createSdk().addPlugin(createOptionsPlugin(options)).addPlugin(eventEmissionPlugin).addPlugin(apiPlugin).addPlugin(manifestPlugin).addPlugin(capabilitiesPlugin).addPlugin(connectionsPlugin).addPlugin(listAppsPlugin).addPlugin(getAppPlugin).addPlugin(listActionsPlugin).addPlugin(getActionPlugin).addPlugin(listActionInputFieldsPlugin).addPlugin(getActionInputFieldsSchemaPlugin).addPlugin(listActionInputFieldChoicesPlugin).addPlugin(listInputFieldsDeprecatedPlugin).addPlugin(getInputFieldsSchemaDeprecatedPlugin).addPlugin(listInputFieldChoicesDeprecatedPlugin).addPlugin(runActionPlugin).addPlugin(listConnectionsPlugin).addPlugin(getConnectionPlugin).addPlugin(findFirstConnectionPlugin).addPlugin(findUniqueConnectionPlugin).addPlugin(listAuthenticationsPlugin).addPlugin(getAuthenticationPlugin).addPlugin(findFirstAuthenticationPlugin).addPlugin(findUniqueAuthenticationPlugin).addPlugin(listClientCredentialsPlugin).addPlugin(createClientCredentialsPlugin).addPlugin(deleteClientCredentialsPlugin).addPlugin(fetchPlugin).addPlugin(requestPlugin).addPlugin(createTriggerInboxPlugin).addPlugin(ensureTriggerInboxPlugin).addPlugin(listTriggerInboxesPlugin).addPlugin(getTriggerInboxPlugin).addPlugin(updateTriggerInboxPlugin).addPlugin(deleteTriggerInboxPlugin).addPlugin(pauseTriggerInboxPlugin).addPlugin(resumeTriggerInboxPlugin).addPlugin(listTriggerInboxMessagesPlugin).addPlugin(leaseTriggerInboxMessagesPlugin).addPlugin(ackTriggerInboxMessagesPlugin).addPlugin(releaseTriggerInboxMessagesPlugin).addPlugin(drainTriggerInboxPlugin).addPlugin(watchTriggerInboxPlugin).addPlugin(listTriggersPlugin).addPlugin(listTriggerInputFieldsPlugin).addPlugin(listTriggerInputFieldChoicesPlugin).addPlugin(getTriggerInputFieldsSchemaPlugin).addPlugin(listTablesPlugin).addPlugin(getTablePlugin).addPlugin(deleteTablePlugin).addPlugin(createTablePlugin).addPlugin(listTableFieldsPlugin).addPlugin(createTableFieldsPlugin).addPlugin(deleteTableFieldsPlugin).addPlugin(getTableRecordPlugin).addPlugin(listTableRecordsPlugin).addPlugin(createTableRecordsPlugin).addPlugin(deleteTableRecordsPlugin).addPlugin(updateTableRecordsPlugin).addPlugin(listWorkflowsPlugin).addPlugin(getWorkflowPlugin).addPlugin(createWorkflowPlugin).addPlugin(updateWorkflowPlugin).addPlugin(enableWorkflowPlugin).addPlugin(disableWorkflowPlugin).addPlugin(deleteWorkflowPlugin).addPlugin(listDurableRunsPlugin).addPlugin(getDurableRunPlugin).addPlugin(runDurablePlugin).addPlugin(cancelDurableRunPlugin).addPlugin(publishWorkflowVersionPlugin).addPlugin(listWorkflowVersionsPlugin).addPlugin(getWorkflowVersionPlugin).addPlugin(appsPlugin).addPlugin(getProfilePlugin);
 }
 
 exports.ActionKeyPropertySchema = ActionKeyPropertySchema;
@@ -11372,3 +11679,4 @@ exports.triggerInboxResolver = triggerInboxResolver;
 exports.triggerMessagesResolver = triggerMessagesResolver;
 exports.updateTableRecordsPlugin = updateTableRecordsPlugin;
 exports.workflowIdResolver = workflowIdResolver;
+exports.workflowVersionIdResolver = workflowVersionIdResolver;