@zapier/zapier-sdk-cli 0.52.7 → 0.52.9

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @zapier/zapier-sdk-cli
 
+## 0.52.9
+
+### Patch 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.
+- Updated dependencies [913aa6b]
+  - @zapier/zapier-sdk@0.64.0
+  - @zapier/zapier-sdk-mcp@0.13.18
+
+## 0.52.8
+
+### Patch 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.
+- Updated dependencies [dfa3cea]
+  - @zapier/zapier-sdk@0.63.0
+  - @zapier/zapier-sdk-mcp@0.13.17
+
 ## 0.52.7
 
 ### Patch Changes

package/README.md

@@ -26,14 +26,19 @@
   - [`delete-client-credentials`](#delete-client-credentials)
   - [`list-client-credentials`](#list-client-credentials)
 - [Code Workflows (Experimental)](#code-workflows-experimental)
+  - [`cancel-durable-run`](#cancel-durable-run--experimental)
   - [`create-workflow`](#create-workflow--experimental)
   - [`delete-workflow`](#delete-workflow--experimental)
   - [`disable-workflow`](#disable-workflow--experimental)
   - [`enable-workflow`](#enable-workflow--experimental)
   - [`get-durable-run`](#get-durable-run--experimental)
   - [`get-workflow`](#get-workflow--experimental)
+  - [`get-workflow-version`](#get-workflow-version--experimental)
   - [`list-durable-runs`](#list-durable-runs--experimental)
+  - [`list-workflow-versions`](#list-workflow-versions--experimental)
   - [`list-workflows`](#list-workflows--experimental)
+  - [`publish-workflow-version`](#publish-workflow-version--experimental)
+  - [`run-durable`](#run-durable--experimental)
   - [`update-workflow`](#update-workflow--experimental)
 - [Connections](#connections)
   - [`find-first-connection`](#find-first-connection)
@@ -437,6 +442,22 @@ npx zapier-sdk list-client-credentials [--page-size] [--max-items] [--cursor]
 
 > ℹ️ **Experimental.** Run commands via the `zapier-sdk-experimental` binary, pass `--experimental` to `zapier-sdk`, or set `ZAPIER_EXPERIMENTAL=true` in the environment. Flags and behavior may change between versions.
 
+#### `cancel-durable-run` 🧪 _experimental_
+
+Cancel a run-once durable run in initialized or started status. Returns 409 if the run is already terminal.
+
+**Options:**
+
+| Option  | Type     | Required | Default | Possible Values | Description    |
+| ------- | -------- | -------- | ------- | --------------- | -------------- |
+| `<run>` | `string` | ✅       | —       | —               | Durable run ID |
+
+**Usage:**
+
+```bash
+npx zapier-sdk cancel-durable-run <run>
+```
+
 #### `create-workflow` 🧪 _experimental_
 
 Create a durable workflow container. Starts disabled with no version; publish a version to add code.
@@ -534,6 +555,23 @@ Get a durable workflow with its current version details and trigger claim status
 npx zapier-sdk get-workflow <workflow>
 ```
 
+#### `get-workflow-version` 🧪 _experimental_
+
+Get full details of a workflow version including source files
+
+**Options:**
+
+| Option       | Type     | Required | Default | Possible Values | Description         |
+| ------------ | -------- | -------- | ------- | --------------- | ------------------- |
+| `<workflow>` | `string` | ✅       | —       | —               | Durable workflow ID |
+| `<version>`  | `string` | ✅       | —       | —               | Workflow version ID |
+
+**Usage:**
+
+```bash
+npx zapier-sdk get-workflow-version <workflow> <version>
+```
+
 #### `list-durable-runs` 🧪 _experimental_
 
 List run-once durable runs for the authenticated account, newest first
@@ -552,6 +590,25 @@ List run-once durable runs for the authenticated account, newest first
 npx zapier-sdk list-durable-runs [--page-size] [--cursor] [--max-items]
 ```
 
+#### `list-workflow-versions` 🧪 _experimental_
+
+List published versions for a workflow, newest first
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                       |
+| ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------- |
+| `<workflow>`  | `string` | ✅       | —       | —               | Durable workflow ID                               |
+| `--page-size` | `number` | ❌       | —       | —               | Number of versions per page (max 100)             |
+| `--cursor`    | `string` | ❌       | —       | —               | Pagination cursor                                 |
+| `--max-items` | `number` | ❌       | —       | —               | Maximum total versions to return across all pages |
+
+**Usage:**
+
+```bash
+npx zapier-sdk list-workflow-versions <workflow> [--page-size] [--cursor] [--max-items]
+```
+
 #### `list-workflows` 🧪 _experimental_
 
 List all active durable workflows for the authenticated account
@@ -570,6 +627,48 @@ List all active durable workflows for the authenticated account
 npx zapier-sdk list-workflows [--page-size] [--max-items] [--cursor]
 ```
 
+#### `publish-workflow-version` 🧪 _experimental_
+
+Publish a new version of a durable workflow. Enables the workflow by default.
+
+**Options:**
+
+| Option                     | Type      | Required | Default | Possible Values | Description                                                                                                     |
+| -------------------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
+| `<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.                 |
+
+**Usage:**
+
+```bash
+npx zapier-sdk publish-workflow-version <workflow> <source_files> [--dependencies] [--zapier_durable_version] [--enabled]
+```
+
+#### `run-durable` 🧪 _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.
+
+**Options:**
+
+| Option                     | Type      | Required | Default | Possible Values | Description                                                                                                     |
+| -------------------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
+| `<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)                                                          |
+
+**Usage:**
+
+```bash
+npx zapier-sdk run-durable <source_files> [--input] [--dependencies] [--zapier_durable_version] [--connections] [--app_versions] [--private]
+```
+
 #### `update-workflow` 🧪 _experimental_
 
 Update a durable workflow's name and/or description

package/dist/cli.cjs

@@ -1572,7 +1572,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -6653,7 +6653,7 @@ var watchTriggerInboxCliPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);

package/dist/cli.mjs

@@ -1530,7 +1530,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -6611,7 +6611,7 @@ var watchTriggerInboxCliPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);

package/dist/experimental.cjs

@@ -4013,7 +4013,7 @@ var watchTriggerInboxCliPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/experimental.ts
 experimental.injectCliLogin(login_exports);

package/dist/experimental.mjs

@@ -3977,7 +3977,7 @@ var watchTriggerInboxCliPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/experimental.ts
 injectCliLogin(login_exports);

package/dist/index.cjs

@@ -4012,7 +4012,7 @@ zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -4040,7 +4040,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -3976,7 +3976,7 @@ definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
@@ -4004,7 +4004,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.7"};
+  version: "0.52.9"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zapier/zapier-sdk-cli",
-    "version": "0.52.7",
+    "version": "0.52.9",
     "description": "Command line interface for Zapier SDK",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",