@zapier/zapier-sdk-cli 0.52.6 → 0.52.8

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @zapier/zapier-sdk-cli
 
+## 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
+
+- eb9b408: Add the durable-run-read experimental code-substrate plugins: `listDurableRuns` and `getDurableRun`. Both are registered only in `@zapier/zapier-sdk/experimental`; the stable subpath does not expose them. `listDurableRuns` is paginated (cursor + pageSize) per the sdkdurableapi `/api/v0/runs` contract; `getDurableRun` returns the full run state with nested execution and operations journal. 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. Also adds `durableRunIdResolver` in `src/resolvers/durableRunId.ts` so commands that take a run id present an interactive picker via `sdk.listDurableRuns()` in the CLI (uses `toIterable` to pull across pages). Input field naming follows the in-tree convention (`run` rather than the fork's `runId`); input is validated as a UUID 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 [eb9b408]
+  - @zapier/zapier-sdk@0.62.0
+  - @zapier/zapier-sdk-mcp@0.13.16
+
 ## 0.52.6
 
 ### Patch Changes

package/README.md

@@ -26,12 +26,16 @@
   - [`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)
+  - [`list-durable-runs`](#list-durable-runs--experimental)
   - [`list-workflows`](#list-workflows--experimental)
+  - [`run-durable`](#run-durable--experimental)
   - [`update-workflow`](#update-workflow--experimental)
 - [Connections](#connections)
   - [`find-first-connection`](#find-first-connection)
@@ -435,6 +439,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.
@@ -500,6 +520,22 @@ Enable a durable workflow so it accepts triggers
 npx zapier-sdk enable-workflow <workflow>
 ```
 
+#### `get-durable-run` 🧪 _experimental_
+
+Get the full state of a run-once durable run, including its operations journal
+
+**Options:**
+
+| Option  | Type     | Required | Default | Possible Values | Description    |
+| ------- | -------- | -------- | ------- | --------------- | -------------- |
+| `<run>` | `string` | ✅       | —       | —               | Durable run ID |
+
+**Usage:**
+
+```bash
+npx zapier-sdk get-durable-run <run>
+```
+
 #### `get-workflow` 🧪 _experimental_
 
 Get a durable workflow with its current version details and trigger claim status
@@ -516,6 +552,24 @@ Get a durable workflow with its current version details and trigger claim status
 npx zapier-sdk get-workflow <workflow>
 ```
 
+#### `list-durable-runs` 🧪 _experimental_
+
+List run-once durable runs for the authenticated account, newest first
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                    |
+| ------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------- |
+| `--page-size` | `number` | ❌       | —       | —               | Number of runs per page (max 100)              |
+| `--cursor`    | `string` | ❌       | —       | —               | Pagination cursor                              |
+| `--max-items` | `number` | ❌       | —       | —               | Maximum total items to return across all pages |
+
+**Usage:**
+
+```bash
+npx zapier-sdk list-durable-runs [--page-size] [--cursor] [--max-items]
+```
+
 #### `list-workflows` 🧪 _experimental_
 
 List all active durable workflows for the authenticated account
@@ -534,6 +588,28 @@ List all active durable workflows for the authenticated account
 npx zapier-sdk list-workflows [--page-size] [--max-items] [--cursor]
 ```
 
+#### `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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -4040,7 +4040,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.6"};
+  version: "0.52.8"};
 
 // 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.6"};
+  version: "0.52.8"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
@@ -4004,7 +4004,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.6"};
+  version: "0.52.8"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

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