@zapier/zapier-sdk-cli 0.52.8 → 0.52.10

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @zapier/zapier-sdk-cli
 
+## 0.52.10
+
+### Patch Changes
+
+- 9138968: Add the workflow-run experimental code-substrate plugins: `listWorkflowRuns`, `getWorkflowRun`, and `getTriggerRun`. All three live behind `@zapier/zapier-sdk/experimental` only — the stable subpath does not surface them. `listWorkflowRuns` is paginated against the backend's cursor + limit contract; `getWorkflowRun` looks up a run by id; `getTriggerRun` walks from a trigger id to its associated run, useful immediately after firing a trigger when the caller has the trigger id but not yet the run id. All ID inputs are UUID-validated at the schema boundary. Handlers pass the API response through verbatim — schemas stay as `outputSchema` for docs and types, but consumers see any richer fields the server adds without an SDK release. Adds `workflowRunIdResolver` — a dependent resolver scoped to the parent workflow — so CLI commands taking a run id present an interactive picker via `sdk.listWorkflowRuns({ workflow })`. `getTriggerRun` does not register a picker for `trigger`; users typically have the trigger id from a recent fire and pass it directly.
+- Updated dependencies [9138968]
+  - @zapier/zapier-sdk@0.65.0
+  - @zapier/zapier-sdk-mcp@0.13.19
+
+## 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

package/README.md

@@ -32,9 +32,15 @@
   - [`disable-workflow`](#disable-workflow--experimental)
   - [`enable-workflow`](#enable-workflow--experimental)
   - [`get-durable-run`](#get-durable-run--experimental)
+  - [`get-trigger-run`](#get-trigger-run--experimental)
   - [`get-workflow`](#get-workflow--experimental)
+  - [`get-workflow-run`](#get-workflow-run--experimental)
+  - [`get-workflow-version`](#get-workflow-version--experimental)
   - [`list-durable-runs`](#list-durable-runs--experimental)
+  - [`list-workflow-runs`](#list-workflow-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)
@@ -536,6 +542,22 @@ Get the full state of a run-once durable run, including its operations journal
 npx zapier-sdk get-durable-run <run>
 ```
 
+#### `get-trigger-run` 🧪 _experimental_
+
+Get the workflow run associated with a deployed workflow's trigger. Useful immediately after firing a trigger, when you have the trigger ID but not yet the run ID.
+
+**Options:**
+
+| Option      | Type     | Required | Default | Possible Values | Description         |
+| ----------- | -------- | -------- | ------- | --------------- | ------------------- |
+| `<trigger>` | `string` | ✅       | —       | —               | Workflow trigger ID |
+
+**Usage:**
+
+```bash
+npx zapier-sdk get-trigger-run <trigger>
+```
+
 #### `get-workflow` 🧪 _experimental_
 
 Get a durable workflow with its current version details and trigger claim status
@@ -552,6 +574,40 @@ Get a durable workflow with its current version details and trigger claim status
 npx zapier-sdk get-workflow <workflow>
 ```
 
+#### `get-workflow-run` 🧪 _experimental_
+
+Get the current state of a workflow run (a triggered execution of a deployed workflow)
+
+**Options:**
+
+| Option       | Type     | Required | Default | Possible Values | Description                                                                             |
+| ------------ | -------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------- |
+| `<run>`      | `string` | ✅       | —       | —               | Workflow run ID                                                                         |
+| `--workflow` | `string` | ❌       | —       | —               | Parent workflow ID — used only to scope the CLI run-id picker; ignored by the API call. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk get-workflow-run <run> [--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
@@ -570,6 +626,44 @@ List run-once durable runs for the authenticated account, newest first
 npx zapier-sdk list-durable-runs [--page-size] [--cursor] [--max-items]
 ```
 
+#### `list-workflow-runs` 🧪 _experimental_
+
+List workflow runs (triggered executions) for a specific deployed workflow, newest first
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                   |
+| ------------- | -------- | -------- | ------- | --------------- | --------------------------------------------- |
+| `<workflow>`  | `string` | ✅       | —       | —               | Durable workflow ID                           |
+| `--page-size` | `number` | ❌       | —       | —               | Number of runs per page (max 100)             |
+| `--cursor`    | `string` | ❌       | —       | —               | Pagination cursor                             |
+| `--max-items` | `number` | ❌       | —       | —               | Maximum total runs to return across all pages |
+
+**Usage:**
+
+```bash
+npx zapier-sdk list-workflow-runs <workflow> [--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
@@ -588,6 +682,26 @@ 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.

package/dist/cli.cjs

@@ -1572,7 +1572,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.52.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -4040,7 +4040,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.8"};
+  version: "0.52.10"};
 
 // 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.8"};
+  version: "0.52.10"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
@@ -4004,7 +4004,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.52.8"};
+  version: "0.52.10"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

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