@zapier/zapier-sdk-cli 0.81.3 → 0.82.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @zapier/zapier-sdk-cli
 
+## 0.82.0
+
+### Minor Changes
+
+- f8637ed: Added `runWorkflowDraft` (experimental), exposed in the CLI as `run-workflow-draft`. Launches a draft test run: executes a workflow draft's current source without publishing it.
+  - Pass `workflow`, `draft`, and `draftRevision` (from the last read of the draft). The run is rejected with a conflict error if the draft changed since. In interactive CLI use, `draftRevision` resolves via a picker that reads the draft's current revision, so it never has to be typed by hand.
+  - Optionally pass `input` for workflows that take input.
+  - Draft runs are free (not task-charged) and rate limited per user.
+  - The run is accepted asynchronously and returned with `kind: "draft"` and status `initialized`; follow it with `getWorkflowRun`, or list draft runs via `listWorkflowRuns` with `kind: "draft"`.
+
+- f8637ed: Workflow runs now carry a `kind` discriminator (`"live"` or `"draft"`), and `listWorkflowRuns` (CLI: `list-workflow-runs`) accepts a `kind` filter — omit it for both kinds interleaved by recency. The `getWorkflowRun` and `listWorkflowRuns` response schemas are discriminated unions on `kind`, so TypeScript narrows kind-specific fields after a `run.kind === "draft"` check, and each kind carries only its own fields:
+
+  | Kind    | Fields                                                      |
+  | ------- | ----------------------------------------------------------- |
+  | `live`  | `trigger_id`, `workflow_version_id` (absent on draft runs)  |
+  | `draft` | `workflow_draft_id`, `draft_revision` (absent on live runs) |
+
+  This also fixes `listWorkflowRuns` rejecting responses for workflows that have draft runs: draft rows omit the live-only fields, which the previous response schema treated as required.
+
+  `getWorkflowRun` responses now also include `workflow_id` (always returned by the API, previously stripped by the SDK's response schema).
+
+### Patch Changes
+
+- Updated dependencies [f8637ed]
+- Updated dependencies [f8637ed]
+  - @zapier/zapier-sdk@0.110.0
+  - @zapier/zapier-sdk-mcp@0.24.0
+
 ## 0.81.3
 
 ### Patch Changes

package/README.md

@@ -55,6 +55,7 @@
   - [`publish-workflow-draft`](#publish-workflow-draft--experimental)
   - [`publish-workflow-version`](#publish-workflow-version--experimental)
   - [`run-durable`](#run-durable--experimental)
+  - [`run-workflow-draft`](#run-workflow-draft--experimental)
   - [`trigger-workflow`](#trigger-workflow--experimental)
   - [`update-agentic-management-config`](#update-agentic-management-config--experimental)
   - [`update-agentic-management-intent`](#update-agentic-management-intent--experimental)
@@ -801,7 +802,7 @@ npx zapier-sdk get-workflow-draft <workflow> <draft>
 
 #### `get-workflow-run` 🧪 _experimental_
 
-Get the current state of a workflow run (a triggered execution of a deployed workflow)
+Get the current state of a workflow run — a live run of a published workflow version, or a draft run launched via `runWorkflowDraft` (the `kind` field says which)
 
 **Options:**
 
@@ -892,21 +893,22 @@ npx zapier-sdk list-workflow-drafts <workflow> [--status] [--slug] [--page-size]
 
 #### `list-workflow-runs` 🧪 _experimental_
 
-List workflow runs (triggered executions) for a specific deployed workflow, newest first
+List workflow runs for a specific workflow, newest first. Live runs (of published versions) and draft runs share the one list; pass `kind` to narrow it to one.
 
 **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 |
+| Option        | Type     | Required | Default | Possible Values | Description                                                           |
+| ------------- | -------- | -------- | ------- | --------------- | --------------------------------------------------------------------- |
+| `<workflow>`  | `string` | ✅       | —       | —               | Durable workflow ID                                                   |
+| `--page-size` | `number` | ❌       | —       | —               | Number of runs per page (max 100)                                     |
+| `--kind`      | `string` | ❌       | —       | `live`, `draft` | Return only runs of this kind. Omit for both, interleaved by recency. |
+| `--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]
+npx zapier-sdk list-workflow-runs <workflow> [--page-size] [--kind] [--cursor] [--max-items]
 ```
 
 #### `list-workflow-versions` 🧪 _experimental_
@@ -1018,6 +1020,25 @@ Run a workflow source file as a run-once durable run on code-substrate-runner (n
 npx zapier-sdk run-durable <source-files> [--input] [--dependencies] [--zapier-durable-version] [--connections] [--app-versions] [--private] [--notifications]
 ```
 
+#### `run-workflow-draft` 🧪 _experimental_
+
+Launch a draft test run: execute the draft's current source without publishing it. The draft's payload is snapshotted onto the run at creation, so later edits (or discarding the draft) never change what the run executed. Draft runs are free (not task-charged) and rate limited per user. The run is accepted asynchronously — it comes back `initialized`; follow it with `getWorkflowRun`, or list it via `listWorkflowRuns` with `kind: "draft"`.
+
+**Options:**
+
+| Option             | Type      | Required | Default | Possible Values | Description                                                                                                                                                                                                                                                                                            |
+| ------------------ | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `<workflow>`       | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                                                                                                                                                                                                                    |
+| `<draft>`          | `string`  | ✅       | —       | —               | Workflow draft ID                                                                                                                                                                                                                                                                                      |
+| `<draft-revision>` | `number`  | ✅       | —       | —               | The draft revision you intend to run, from the last read of the draft. The server rejects the run with a conflict if the draft has changed since. The upstream API treats this check as optional; the SDK requires it so a test run can never silently execute source the caller has already replaced. |
+| `--input`          | `unknown` | ❌       | —       | —               | Input data passed to the workflow. Accepts any JSON value, or its JSON-string encoding. Omit for a workflow that takes no input.                                                                                                                                                                       |
+
+**Usage:**
+
+```bash
+npx zapier-sdk run-workflow-draft <workflow> <draft> <draft-revision> [--input]
+```
+
 #### `trigger-workflow` 🧪 _experimental_
 
 Look up a workflow's trigger URL and fire it manually, as the authenticated account.

package/dist/cli.cjs

@@ -602,7 +602,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.81.3"};
+  version: "0.82.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -8699,7 +8699,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/cli.mjs

@@ -558,7 +558,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.81.3"};
+  version: "0.82.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -8655,7 +8655,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.cjs

@@ -7192,7 +7192,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.mjs

@@ -7151,7 +7151,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/index.cjs

@@ -7193,7 +7193,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -7277,7 +7277,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -7152,7 +7152,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -7236,7 +7236,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.81.3"};
+  version: "0.82.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk-cli",
-  "version": "0.81.3",
+  "version": "0.82.0",
   "description": "Command line interface for Zapier SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -95,9 +95,9 @@
     "typescript": "^5.8.3",
     "wrap-ansi": "^10.0.0",
     "zod": "4.3.6",
-    "@zapier/kitcore": "0.20.0",
-    "@zapier/zapier-sdk-mcp": "0.23.3",
-    "@zapier/zapier-sdk": "0.109.1"
+    "@zapier/zapier-sdk": "0.110.0",
+    "@zapier/zapier-sdk-mcp": "0.24.0",
+    "@zapier/kitcore": "0.20.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",