@zapier/zapier-sdk-cli 0.69.0 → 0.71.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @zapier/zapier-sdk-cli
 
+## 0.71.0
+
+### Minor Changes
+
+- d700196: Added `createActionRun` and `getActionRun`, the two halves of `runAction` as separately callable methods:
+  - `createActionRun({ app, actionType, action, connection?, inputs?, page?, callbackUrl? })` — starts an action run and returns `{ id, implementation_id }` right away, without waiting for it to finish. `implementation_id` is the versioned implementation the run was started against, matching `implementation_id` on an app from `getApp` / `listApps`.
+  - `getActionRun({ run })` — returns that run's state: `{ id, status, results, errors, next_page? }`. It is a point-in-time read that answers immediately, so a run that is still executing comes back with `status: "waiting"` and it is up to the caller to check again. Unlike `runAction`, a failed run is reported as `status: "error"` with the details in `errors` rather than thrown.
+
+  To page a bulk read, pass the `next_page` from `getActionRun` back as the `page` for the next `createActionRun`. The pair uses the same page terminology in both directions, and `next_page` is always a string so it can be handed straight back. `runAction` is a paginated list method, so it keeps the SDK's usual `cursor` / `nextCursor` pair.
+
+  Pass `callbackUrl` to `createActionRun` to skip polling altogether: Zapier posts the finished run to that URL. It must use HTTPS and resolve to a public host. The delivered body matches what `getActionRun` returns, and carries a `Zapier-Callback-Signature` header holding an RS256 JWT you can verify against `https://zapier.com/.well-known/jwks.json`. Delivery is retried, so the same run can arrive more than once.
+
+  `runAction` is unchanged and is still the right call for most cases — it starts a run and waits for the result in one step. Reach for the pair when you don't want to block on the result: fan out many runs and collect them later, hand a run ID to another process, or pick a run back up after a restart. Run results are retained for seven days.
+
+### Patch Changes
+
+- Updated dependencies [d700196]
+  - @zapier/zapier-sdk@0.94.0
+  - @zapier/zapier-sdk-mcp@0.19.0
+
+## 0.70.0
+
+### Minor Changes
+
+- af89cf8: Boolean CLI flags are now strict presence toggles, and list-taking positional arguments now collect every operand:
+  - `--flag` enables; omitting the flag uses the default. Passing a value (`--flag false` or `--flag=false`) is rejected with an error pointing at the correct spelling, instead of being silently ignored (which previously left the flag enabled). A positional argument whose literal value looks boolean can still be passed after a `--` terminator.
+  - Flags where disabling differs from omitting get an explicit disable form: `publish-workflow-version <id> --disabled` and `publish-workflow-draft <workflow> <draft> --disabled` publish without enabling. Generated CLI docs show the disable form wherever one exists.
+  - Commands reject unexpected extra positional arguments rather than ignoring them.
+  - Commands whose first argument is a list (`add`, `build-manifest`, `generate-app-types`, the `create-`/`update-`/`delete-table-records` and `-fields` commands) now collect every operand into the list: `npx zapier-sdk add slack google-sheets` adds both apps. Previously only the first value was used and the rest were silently ignored.
+
+### Patch Changes
+
+- Updated dependencies [bc7405e]
+  - @zapier/zapier-sdk@0.93.0
+  - @zapier/zapier-sdk-mcp@0.18.23
+
 ## 0.69.0
 
 ### Minor Changes

package/README.md

@@ -13,8 +13,10 @@
   - [`logout`](#logout)
   - [`signup`](#signup)
 - [Actions](#actions)
+  - [`create-action-run`](#create-action-run)
   - [`get-action`](#get-action)
   - [`get-action-input-fields-schema`](#get-action-input-fields-schema)
+  - [`get-action-run`](#get-action-run)
   - [`list-action-input-field-choices`](#list-action-input-field-choices)
   - [`list-action-input-fields`](#list-action-input-fields)
   - [`list-actions`](#list-actions)
@@ -197,6 +199,8 @@ These options are available for all commands:
 
 The CLI automatically generates commands from the SDK registry. All SDK functions are available as CLI commands using kebab-case naming.
 
+Boolean flags are presence toggles and take no value: pass `--flag` to enable it, or omit the flag to use the default. Flags where disabling differs from omitting document a separate disable flag (e.g. `--disabled`). A value after a boolean flag (`--flag false`) is rejected as an extra argument.
+
 ### Accounts
 
 #### `get-profile`
@@ -262,6 +266,28 @@ npx zapier-sdk signup [--timeout] [--use-approvals] [--non-interactive] [--headl
 
 ### Actions
 
+#### `create-action-run`
+
+Start an action run and return its ID without waiting for the result. Running an action is asynchronous: this hands back a run ID immediately, and `getActionRun` fetches the outcome. Reach for this pair when you want to start work and collect it later (fan out many runs, hand the ID to another process, survive a restart). `runAction` is the one-call form that starts a run and waits for its result.
+
+**Options:**
+
+| Option           | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                                                                                                                                                                                                              |
+| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<app>`          | `string`         | ✅       | —       | —                                                                                              | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3')                                                                                                                                                                                             |
+| `<action-type>`  | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                                                                                                                                                                                                       |
+| `<action>`       | `string`         | ✅       | —       | —                                                                                              | Action key (e.g., 'send_message' or 'find_row')                                                                                                                                                                                                                                                          |
+| `--connection`   | `string, number` | ❌       | —       | —                                                                                              | Connection alias or connection ID (UUID or positive integer). Required if the action needs a connection to authenticate and interact with the service. Strings that match a key in the connections map are resolved against it; otherwise the value is used as a connection ID directly.                 |
+| `--inputs`       | `object`         | ❌       | —       | —                                                                                              | Input parameters for the action                                                                                                                                                                                                                                                                          |
+| `--page`         | `string`         | ❌       | —       | —                                                                                              | Page to fetch for bulk read actions. Pass the `next_page` a previous run returned to fetch the following page.                                                                                                                                                                                           |
+| `--callback-url` | `string`         | ❌       | —       | —                                                                                              | URL Zapier posts the finished run to, so you do not have to poll for it. Must use HTTPS and resolve to a public host, so a local receiver needs a tunnel. The body matches what `getActionRun` returns. Verify the `Zapier-Callback-Signature` header, and expect the same run to arrive more than once. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk create-action-run <app> <action-type> <action> [--connection] [--inputs] [--page] [--callback-url]
+```
+
 #### `get-action`
 
 Get detailed information about a specific action
@@ -300,6 +326,22 @@ Get the JSON Schema representation of input fields for an action. Returns a JSON
 npx zapier-sdk get-action-input-fields-schema <app> <action-type> <action> [--connection] [--inputs]
 ```
 
+#### `get-action-run`
+
+Fetch the current state of an action run started by `createActionRun`. This is a point-in-time read that returns immediately: a run Zapier has not finished executing comes back with status `waiting`, so call again to check for a result. `runAction` starts a run and waits for its result in one call. Results are stored for seven days after the run was created.
+
+**Options:**
+
+| Option  | Type     | Required | Default | Possible Values | Description                                 |
+| ------- | -------- | -------- | ------- | --------------- | ------------------------------------------- |
+| `<run>` | `string` | ✅       | —       | —               | Action run ID returned by `createActionRun` |
+
+**Usage:**
+
+```bash
+npx zapier-sdk get-action-run <run>
+```
+
 #### `list-action-input-field-choices`
 
 Get the available choices for a dynamic dropdown input field
@@ -803,12 +845,12 @@ Publish an open draft as a new immutable workflow version. Advances the workflow
 
 **Options:**
 
-| Option             | Type      | Required | Default | Possible Values | Description                                                                                                                                                                                      |
-| ------------------ | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `<workflow>`       | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                                                                                                              |
-| `<draft>`          | `string`  | ✅       | —       | —               | Workflow draft ID                                                                                                                                                                                |
-| `--enabled`        | `boolean` | ❌       | —       | —               | Set the workflow's enabled state as part of the publish. If omitted, the current enabled state is preserved.                                                                                     |
-| `--draft-revision` | `number`  | ❌       | —       | —               | Expected draft revision for optimistic concurrency. Pass the revision from the last read; the server rejects the publish with a conflict if the draft has changed since. Omit to skip the check. |
+| Option                     | Type      | Required | Default | Possible Values | Description                                                                                                                                                                                      |
+| -------------------------- | --------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `<workflow>`               | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                                                                                                              |
+| `<draft>`                  | `string`  | ✅       | —       | —               | Workflow draft ID                                                                                                                                                                                |
+| `--enabled` / `--disabled` | `boolean` | ❌       | —       | —               | Set the workflow's enabled state as part of the publish. If omitted, the current enabled state is preserved.                                                                                     |
+| `--draft-revision`         | `number`  | ❌       | —       | —               | Expected draft revision for optimistic concurrency. Pass the revision from the last read; the server rejects the publish with a conflict if the draft has changed since. Omit to skip the check. |
 
 **Usage:**
 
@@ -828,7 +870,7 @@ Publish a new version of a durable workflow. Enables the workflow by default.
 | `<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.                                                                                                                         |
+| `--enabled` / `--disabled` | `boolean` | ❌       | —       | —               | Enable the workflow after publishing. Defaults to true if omitted; pass false to publish without enabling.                                                                                                              |
 | `--ignore-open-drafts`     | `boolean` | ❌       | —       | —               | Publish even though the workflow has open draft(s). Without this, the API rejects a direct publish with a 409 while any draft is open, since publishing the draft later would ship its stale content over this version. |
 | `--connections`            | `object`  | ❌       | —       | —               | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding.                                                                                                         |
 | `--app-versions`           | `object`  | ❌       | —       | —               | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding.                                                                                                    |

package/dist/cli.cjs

@@ -602,7 +602,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.69.0"};
+  version: "0.71.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -866,6 +866,9 @@ function formatItemsGeneric(items, startingNumber = 0) {
 function toKebabCase(str) {
   return str.replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase();
 }
+function kebabToCamelCase(str) {
+  return str.replace(/-([a-z])/g, (match) => match[1].toUpperCase());
+}
 function formatMissingParamsError(error) {
   return [
     "Missing required parameters:",
@@ -1261,6 +1264,18 @@ function resolveOutputMode({
   if (hasUserSpecifiedMaxItems) return "collect";
   return "paginate";
 }
+function negationKebabName(param) {
+  if (param.negatable === true) return `no-${toKebabCase(param.name)}`;
+  if (typeof param.negatable === "string") return toKebabCase(param.negatable);
+  return void 0;
+}
+function antonymAttributeName(param) {
+  const negationKebab = negationKebabName(param);
+  if (negationKebab === void 0 || negationKebab.startsWith("no-")) {
+    return void 0;
+  }
+  return kebabToCamelCase(negationKebab);
+}
 function takesPositionalSlot(param) {
   return param.required || !!param.isPositional && !param.isDeprecated && !param.isAlias;
 }
@@ -1373,7 +1388,8 @@ function analyzeZodField(name, schema) {
     isPositional: zapierSdk.isPositional(schema),
     elementType,
     deprecationMessage,
-    isDeprecated
+    isDeprecated,
+    negatable: zapierSdk.getNegatable(schema)
   };
 }
 function positionalProjection(schema, positional) {
@@ -1758,15 +1774,25 @@ function collect(value, previous = []) {
   return previous;
 }
 function addCommand(program2, commandName, config2) {
-  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description);
+  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description).allowExcessArguments(false);
   let hasPositionalArray = false;
+  const lastPositionalParamName = [...config2.parameters].reverse().find(takesPositionalSlot)?.name;
+  const booleanFlags2 = [];
   config2.parameters.forEach((param) => {
     const kebabName = toKebabCase(param.name);
     if (param.promptable && param.required) {
-      command.argument(
-        `[${kebabName}]`,
-        param.description || `${kebabName} parameter`
-      );
+      if (param.type === "array" && !hasPositionalArray && param.name === lastPositionalParamName) {
+        hasPositionalArray = true;
+        command.argument(
+          `[${kebabName}...]`,
+          param.description || `${kebabName} parameter`
+        );
+      } else {
+        command.argument(
+          `[${kebabName}]`,
+          param.description || `${kebabName} parameter`
+        );
+      }
     } else if (param.required && param.type === "array" && !hasPositionalArray) {
       hasPositionalArray = true;
       command.argument(
@@ -1803,6 +1829,24 @@ function addCommand(program2, commandName, config2) {
         const opt = new commander.Option(flags.join(", "), param.description);
         if (param.isDeprecated) opt.hideHelp();
         command.addOption(opt);
+        const negationKebab = negationKebabName(param);
+        if (negationKebab !== void 0) {
+          const negation = new commander.Option(
+            `--${negationKebab}`,
+            `Disable --${kebabName}`
+          );
+          if (!negationKebab.startsWith("no-")) {
+            negation.conflicts(param.name);
+          }
+          if (param.isDeprecated) negation.hideHelp();
+          command.addOption(negation);
+        }
+        booleanFlags2.push({
+          kebabName,
+          attributeName: param.name,
+          negationKebab,
+          shortAlias: alias && alias.length === 1 ? alias : void 0
+        });
       } else if (param.type === "array") {
         const flagSignature = flags.join(", ") + ` <value>`;
         const opt = new commander.Option(flagSignature, param.description || "");
@@ -1832,24 +1876,128 @@ function addCommand(program2, commandName, config2) {
     if (config2.supportsJsonOutput === false && opt.name === "json") return;
     command.option(opt.flag, opt.description);
   });
+  if (booleanFlags2.length > 0) {
+    addBooleanFlagErrorHints({ command, booleanFlags: booleanFlags2 });
+    rejectBooleanFlagValues({ command, booleanFlags: booleanFlags2 });
+  }
   command.action(config2.handler);
 }
+function booleanFlagUsageHint(flag) {
+  return flag.negationKebab !== void 0 ? `use --${flag.kebabName} to enable or --${flag.negationKebab} to disable` : `pass --${flag.kebabName} to enable or omit it`;
+}
+function addBooleanFlagErrorHints({
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  const originalError = command.error.bind(command);
+  command.error = (message, errorOptions) => originalError(
+    appendBooleanFlagHint({
+      message,
+      code: errorOptions?.code,
+      command,
+      booleanFlags: booleanFlags2
+    }),
+    errorOptions
+  );
+}
+function rejectBooleanFlagValues({
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  command.hook("preAction", (_thisCommand, actionCommand) => {
+    let root = actionCommand;
+    while (root.parent) root = root.parent;
+    const { rawArgs } = root;
+    const terminatorIndex = rawArgs.indexOf("--");
+    const tokens = terminatorIndex === -1 ? rawArgs : rawArgs.slice(0, terminatorIndex);
+    for (const flag of booleanFlags2) {
+      const spellings = new Set(
+        [
+          `--${flag.kebabName}`,
+          flag.negationKebab === void 0 ? void 0 : `--${flag.negationKebab}`,
+          flag.shortAlias === void 0 ? void 0 : `-${flag.shortAlias}`
+        ].filter((spelling) => spelling !== void 0)
+      );
+      for (let i = 0; i < tokens.length - 1; i++) {
+        if (!spellings.has(tokens[i])) continue;
+        const next = tokens[i + 1].trim().toLowerCase();
+        if (!BOOLEAN_TRUE_TOKENS.has(next) && !BOOLEAN_FALSE_TOKENS.has(next)) {
+          continue;
+        }
+        actionCommand.error(
+          `error: ${tokens[i]} is a boolean flag and takes no value, but was followed by '${tokens[i + 1]}': ${booleanFlagUsageHint(flag)}.`,
+          { code: "zapierSdk.booleanFlagValue" }
+        );
+      }
+    }
+  });
+}
+function appendBooleanFlagHint({
+  message,
+  code,
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  if (code === "commander.unknownOption") {
+    const flagWithValue = message.match(/'--([^=']+)=/);
+    if (!flagWithValue) return message;
+    const typedName = flagWithValue[1];
+    const flag = booleanFlags2.find(
+      (candidate) => candidate.kebabName === typedName || candidate.negationKebab === typedName
+    );
+    if (flag === void 0) return message;
+    return `${message}
+(--${typedName} is a boolean flag and takes no value: ${booleanFlagUsageHint(flag)}.)`;
+  }
+  if (code === "commander.excessArguments") {
+    const excessOperands = command.args.slice(
+      command.registeredArguments.length
+    );
+    const strayBooleanToken = excessOperands.find((token) => {
+      const normalized = token.trim().toLowerCase();
+      return BOOLEAN_TRUE_TOKENS.has(normalized) || BOOLEAN_FALSE_TOKENS.has(normalized);
+    });
+    if (strayBooleanToken === void 0) return message;
+    const usedBooleanFlag = booleanFlags2.find(
+      (flag) => [flag.attributeName, flag.negationKebab].filter((name) => name !== void 0).some(
+        (name) => command.getOptionValueSource(kebabToCamelCase(name)) === "cli"
+      )
+    );
+    if (usedBooleanFlag === void 0) return message;
+    return `${message}
+(Boolean flags take no value, so '${strayBooleanToken}' was read as an extra argument: ${booleanFlagUsageHint(usedBooleanFlag)}.)`;
+  }
+  return message;
+}
 function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
   const sdkParams = {};
   let argIndex = 0;
   parameters.forEach((param) => {
     if (takesPositionalSlot(param) && argIndex < positionalArgs.length) {
+      const positionalValue = positionalArgs[argIndex];
+      argIndex++;
+      if (Array.isArray(positionalValue) && positionalValue.length === 0) {
+        return;
+      }
       sdkParams[param.name] = convertValue(
-        positionalArgs[argIndex],
+        positionalValue,
         param.type,
         param.elementType
       );
-      argIndex++;
     }
   });
   Object.entries(options).forEach(([key, value]) => {
     const camelKey = key.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
     const param = parameters.find((p) => p.name === camelKey);
+    if (param === void 0 && value === true) {
+      const antonymTarget = parameters.find(
+        (p) => antonymAttributeName(p) === camelKey
+      );
+      if (antonymTarget && sdkParams[antonymTarget.name] === void 0) {
+        sdkParams[antonymTarget.name] = false;
+      }
+      return;
+    }
     if (param && value !== void 0) {
       if (sdkParams[camelKey] !== void 0) {
         return;
@@ -1862,6 +2010,16 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
   });
   return sdkParams;
 }
+var BOOLEAN_TRUE_TOKENS = /* @__PURE__ */ new Set(["true", "1", "yes", "y", "on"]);
+var BOOLEAN_FALSE_TOKENS = /* @__PURE__ */ new Set(["false", "0", "no", "n", "off"]);
+function parseCliBoolean(value) {
+  const normalized = value.trim().toLowerCase();
+  if (BOOLEAN_TRUE_TOKENS.has(normalized)) return true;
+  if (BOOLEAN_FALSE_TOKENS.has(normalized)) return false;
+  throw new commander.InvalidArgumentError(
+    `Expected a boolean (true or false), received "${value}".`
+  );
+}
 function convertValue(value, type, elementType) {
   if (value === void 0) {
     return void 0;
@@ -1870,7 +2028,7 @@ function convertValue(value, type, elementType) {
     case "number":
       return Number(value);
     case "boolean":
-      return Boolean(value);
+      return typeof value === "string" ? parseCliBoolean(value) : Boolean(value);
     case "array": {
       const arr = Array.isArray(value) ? value : [value];
       if (elementType !== "object") return arr;
@@ -8183,7 +8341,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { Command, CommanderError, Option } from 'commander';
-import { getConnectionPlugin, defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineMethodOverride, zapierCoreOptions, injectCliLogin, definePlugin, omitExports, zapierSdkPlugin, BaseSdkOptionsSchema, disposeSdk, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, createSdk as createSdk$1, CORE_OPTIONS_ID as CORE_OPTIONS_ID$1, SDK_OPTIONS_ID as SDK_OPTIONS_ID$1, addPlugin as addPlugin$1, getOrCreateApiClient, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, DEPRECATION_NOTICE_EVENT, runWithCallerContext, isCoreCancelledSignal, isPositional, resolvePlugin, isZapierError, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, isZapierConflictError, getReleaseId, getCurrentTimestamp, generateEventId, isZapierApprovalError, ZapierAuthenticationError } from '@zapier/zapier-sdk';
+import { Command, CommanderError, Option, InvalidArgumentError } from 'commander';
+import { getConnectionPlugin, defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineMethodOverride, zapierCoreOptions, injectCliLogin, definePlugin, omitExports, zapierSdkPlugin, BaseSdkOptionsSchema, disposeSdk, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, createSdk as createSdk$1, CORE_OPTIONS_ID as CORE_OPTIONS_ID$1, SDK_OPTIONS_ID as SDK_OPTIONS_ID$1, addPlugin as addPlugin$1, getOrCreateApiClient, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, DEPRECATION_NOTICE_EVENT, runWithCallerContext, isCoreCancelledSignal, getNegatable, isPositional, resolvePlugin, isZapierError, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, isZapierConflictError, getReleaseId, getCurrentTimestamp, generateEventId, isZapierApprovalError, ZapierAuthenticationError } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 import inquirer from 'inquirer';
 import chalk8 from 'chalk';
@@ -558,7 +558,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.69.0"};
+  version: "0.71.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -822,6 +822,9 @@ function formatItemsGeneric(items, startingNumber = 0) {
 function toKebabCase(str) {
   return str.replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase();
 }
+function kebabToCamelCase(str) {
+  return str.replace(/-([a-z])/g, (match) => match[1].toUpperCase());
+}
 function formatMissingParamsError(error) {
   return [
     "Missing required parameters:",
@@ -1217,6 +1220,18 @@ function resolveOutputMode({
   if (hasUserSpecifiedMaxItems) return "collect";
   return "paginate";
 }
+function negationKebabName(param) {
+  if (param.negatable === true) return `no-${toKebabCase(param.name)}`;
+  if (typeof param.negatable === "string") return toKebabCase(param.negatable);
+  return void 0;
+}
+function antonymAttributeName(param) {
+  const negationKebab = negationKebabName(param);
+  if (negationKebab === void 0 || negationKebab.startsWith("no-")) {
+    return void 0;
+  }
+  return kebabToCamelCase(negationKebab);
+}
 function takesPositionalSlot(param) {
   return param.required || !!param.isPositional && !param.isDeprecated && !param.isAlias;
 }
@@ -1329,7 +1344,8 @@ function analyzeZodField(name, schema) {
     isPositional: isPositional(schema),
     elementType,
     deprecationMessage,
-    isDeprecated
+    isDeprecated,
+    negatable: getNegatable(schema)
   };
 }
 function positionalProjection(schema, positional) {
@@ -1714,15 +1730,25 @@ function collect(value, previous = []) {
   return previous;
 }
 function addCommand(program2, commandName, config2) {
-  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description);
+  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description).allowExcessArguments(false);
   let hasPositionalArray = false;
+  const lastPositionalParamName = [...config2.parameters].reverse().find(takesPositionalSlot)?.name;
+  const booleanFlags2 = [];
   config2.parameters.forEach((param) => {
     const kebabName = toKebabCase(param.name);
     if (param.promptable && param.required) {
-      command.argument(
-        `[${kebabName}]`,
-        param.description || `${kebabName} parameter`
-      );
+      if (param.type === "array" && !hasPositionalArray && param.name === lastPositionalParamName) {
+        hasPositionalArray = true;
+        command.argument(
+          `[${kebabName}...]`,
+          param.description || `${kebabName} parameter`
+        );
+      } else {
+        command.argument(
+          `[${kebabName}]`,
+          param.description || `${kebabName} parameter`
+        );
+      }
     } else if (param.required && param.type === "array" && !hasPositionalArray) {
       hasPositionalArray = true;
       command.argument(
@@ -1759,6 +1785,24 @@ function addCommand(program2, commandName, config2) {
         const opt = new Option(flags.join(", "), param.description);
         if (param.isDeprecated) opt.hideHelp();
         command.addOption(opt);
+        const negationKebab = negationKebabName(param);
+        if (negationKebab !== void 0) {
+          const negation = new Option(
+            `--${negationKebab}`,
+            `Disable --${kebabName}`
+          );
+          if (!negationKebab.startsWith("no-")) {
+            negation.conflicts(param.name);
+          }
+          if (param.isDeprecated) negation.hideHelp();
+          command.addOption(negation);
+        }
+        booleanFlags2.push({
+          kebabName,
+          attributeName: param.name,
+          negationKebab,
+          shortAlias: alias && alias.length === 1 ? alias : void 0
+        });
       } else if (param.type === "array") {
         const flagSignature = flags.join(", ") + ` <value>`;
         const opt = new Option(flagSignature, param.description || "");
@@ -1788,24 +1832,128 @@ function addCommand(program2, commandName, config2) {
     if (config2.supportsJsonOutput === false && opt.name === "json") return;
     command.option(opt.flag, opt.description);
   });
+  if (booleanFlags2.length > 0) {
+    addBooleanFlagErrorHints({ command, booleanFlags: booleanFlags2 });
+    rejectBooleanFlagValues({ command, booleanFlags: booleanFlags2 });
+  }
   command.action(config2.handler);
 }
+function booleanFlagUsageHint(flag) {
+  return flag.negationKebab !== void 0 ? `use --${flag.kebabName} to enable or --${flag.negationKebab} to disable` : `pass --${flag.kebabName} to enable or omit it`;
+}
+function addBooleanFlagErrorHints({
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  const originalError = command.error.bind(command);
+  command.error = (message, errorOptions) => originalError(
+    appendBooleanFlagHint({
+      message,
+      code: errorOptions?.code,
+      command,
+      booleanFlags: booleanFlags2
+    }),
+    errorOptions
+  );
+}
+function rejectBooleanFlagValues({
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  command.hook("preAction", (_thisCommand, actionCommand) => {
+    let root = actionCommand;
+    while (root.parent) root = root.parent;
+    const { rawArgs } = root;
+    const terminatorIndex = rawArgs.indexOf("--");
+    const tokens = terminatorIndex === -1 ? rawArgs : rawArgs.slice(0, terminatorIndex);
+    for (const flag of booleanFlags2) {
+      const spellings = new Set(
+        [
+          `--${flag.kebabName}`,
+          flag.negationKebab === void 0 ? void 0 : `--${flag.negationKebab}`,
+          flag.shortAlias === void 0 ? void 0 : `-${flag.shortAlias}`
+        ].filter((spelling) => spelling !== void 0)
+      );
+      for (let i = 0; i < tokens.length - 1; i++) {
+        if (!spellings.has(tokens[i])) continue;
+        const next = tokens[i + 1].trim().toLowerCase();
+        if (!BOOLEAN_TRUE_TOKENS.has(next) && !BOOLEAN_FALSE_TOKENS.has(next)) {
+          continue;
+        }
+        actionCommand.error(
+          `error: ${tokens[i]} is a boolean flag and takes no value, but was followed by '${tokens[i + 1]}': ${booleanFlagUsageHint(flag)}.`,
+          { code: "zapierSdk.booleanFlagValue" }
+        );
+      }
+    }
+  });
+}
+function appendBooleanFlagHint({
+  message,
+  code,
+  command,
+  booleanFlags: booleanFlags2
+}) {
+  if (code === "commander.unknownOption") {
+    const flagWithValue = message.match(/'--([^=']+)=/);
+    if (!flagWithValue) return message;
+    const typedName = flagWithValue[1];
+    const flag = booleanFlags2.find(
+      (candidate) => candidate.kebabName === typedName || candidate.negationKebab === typedName
+    );
+    if (flag === void 0) return message;
+    return `${message}
+(--${typedName} is a boolean flag and takes no value: ${booleanFlagUsageHint(flag)}.)`;
+  }
+  if (code === "commander.excessArguments") {
+    const excessOperands = command.args.slice(
+      command.registeredArguments.length
+    );
+    const strayBooleanToken = excessOperands.find((token) => {
+      const normalized = token.trim().toLowerCase();
+      return BOOLEAN_TRUE_TOKENS.has(normalized) || BOOLEAN_FALSE_TOKENS.has(normalized);
+    });
+    if (strayBooleanToken === void 0) return message;
+    const usedBooleanFlag = booleanFlags2.find(
+      (flag) => [flag.attributeName, flag.negationKebab].filter((name) => name !== void 0).some(
+        (name) => command.getOptionValueSource(kebabToCamelCase(name)) === "cli"
+      )
+    );
+    if (usedBooleanFlag === void 0) return message;
+    return `${message}
+(Boolean flags take no value, so '${strayBooleanToken}' was read as an extra argument: ${booleanFlagUsageHint(usedBooleanFlag)}.)`;
+  }
+  return message;
+}
 function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
   const sdkParams = {};
   let argIndex = 0;
   parameters.forEach((param) => {
     if (takesPositionalSlot(param) && argIndex < positionalArgs.length) {
+      const positionalValue = positionalArgs[argIndex];
+      argIndex++;
+      if (Array.isArray(positionalValue) && positionalValue.length === 0) {
+        return;
+      }
       sdkParams[param.name] = convertValue(
-        positionalArgs[argIndex],
+        positionalValue,
         param.type,
         param.elementType
       );
-      argIndex++;
     }
   });
   Object.entries(options).forEach(([key, value]) => {
     const camelKey = key.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
     const param = parameters.find((p) => p.name === camelKey);
+    if (param === void 0 && value === true) {
+      const antonymTarget = parameters.find(
+        (p) => antonymAttributeName(p) === camelKey
+      );
+      if (antonymTarget && sdkParams[antonymTarget.name] === void 0) {
+        sdkParams[antonymTarget.name] = false;
+      }
+      return;
+    }
     if (param && value !== void 0) {
       if (sdkParams[camelKey] !== void 0) {
         return;
@@ -1818,6 +1966,16 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
   });
   return sdkParams;
 }
+var BOOLEAN_TRUE_TOKENS = /* @__PURE__ */ new Set(["true", "1", "yes", "y", "on"]);
+var BOOLEAN_FALSE_TOKENS = /* @__PURE__ */ new Set(["false", "0", "no", "n", "off"]);
+function parseCliBoolean(value) {
+  const normalized = value.trim().toLowerCase();
+  if (BOOLEAN_TRUE_TOKENS.has(normalized)) return true;
+  if (BOOLEAN_FALSE_TOKENS.has(normalized)) return false;
+  throw new InvalidArgumentError(
+    `Expected a boolean (true or false), received "${value}".`
+  );
+}
 function convertValue(value, type, elementType) {
   if (value === void 0) {
     return void 0;
@@ -1826,7 +1984,7 @@ function convertValue(value, type, elementType) {
     case "number":
       return Number(value);
     case "boolean":
-      return Boolean(value);
+      return typeof value === "string" ? parseCliBoolean(value) : Boolean(value);
     case "array": {
       const arr = Array.isArray(value) ? value : [value];
       if (elementType !== "object") return arr;
@@ -8139,7 +8297,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.cjs

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

package/dist/experimental.mjs

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

package/dist/index.cjs

@@ -32,6 +32,7 @@ var crossSpawn = require('cross-spawn');
 var wrapAnsi = require('wrap-ansi');
 var Table = require('cli-table3');
 var experimental = require('@zapier/zapier-sdk/experimental');
+require('commander');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -6861,7 +6862,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -6945,7 +6946,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -7037,6 +7038,14 @@ var SHARED_COMMAND_CLI_OPTIONS = [
     description: "Output raw JSON instead of formatted results"
   }
 ];
+function negationKebabName(param) {
+  if (param.negatable === true) return `no-${toKebabCase(param.name)}`;
+  if (typeof param.negatable === "string") return toKebabCase(param.negatable);
+  return void 0;
+}
+({
+  [zapierSdk.getConnectionPlugin.name]: /* @__PURE__ */ new Set(["connection"])
+});
 
 exports.RESERVED_CLI_OPTIONS = RESERVED_CLI_OPTIONS;
 exports.ReservedCliParameter = ReservedCliParameter;
@@ -7044,3 +7053,4 @@ exports.SHARED_COMMAND_CLI_OPTIONS = SHARED_COMMAND_CLI_OPTIONS;
 exports.buildCliCommandExecutedEvent = buildCliCommandExecutedEvent;
 exports.createZapierCliSdk = createZapierCliSdk;
 exports.getReservedCliOption = getReservedCliOption;
+exports.negationKebabName = negationKebabName;

package/dist/index.d.mts

@@ -125,4 +125,15 @@ declare function getReservedCliOption(name: ReservedCliParameter): Readonly<CliO
 /** CLI options automatically added to every SDK-generated command. */
 declare const SHARED_COMMAND_CLI_OPTIONS: readonly Readonly<CliOption>[];
 
-export { type CliCommandExecutedEvent, type CliCommandExecutedEventData, type CliEventContext, RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, type ZapierCliSdkOptions, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption };
+/**
+ * The kebab-case flag name (without leading dashes) of a boolean param's
+ * disable spelling, or undefined when the param's schema doesn't declare
+ * `negatable` metadata. Exported for the docs generator, so the CLI's
+ * rendering of the metadata lives in one place.
+ */
+declare function negationKebabName(param: {
+    name: string;
+    negatable?: true | string;
+}): string | undefined;
+
+export { type CliCommandExecutedEvent, type CliCommandExecutedEventData, type CliEventContext, RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, type ZapierCliSdkOptions, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption, negationKebabName };

package/dist/index.d.ts

@@ -125,4 +125,15 @@ declare function getReservedCliOption(name: ReservedCliParameter): Readonly<CliO
 /** CLI options automatically added to every SDK-generated command. */
 declare const SHARED_COMMAND_CLI_OPTIONS: readonly Readonly<CliOption>[];
 
-export { type CliCommandExecutedEvent, type CliCommandExecutedEventData, type CliEventContext, RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, type ZapierCliSdkOptions, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption };
+/**
+ * The kebab-case flag name (without leading dashes) of a boolean param's
+ * disable spelling, or undefined when the param's schema doesn't declare
+ * `negatable` metadata. Exported for the docs generator, so the CLI's
+ * rendering of the metadata lives in one place.
+ */
+declare function negationKebabName(param: {
+    name: string;
+    negatable?: true | string;
+}): string | undefined;
+
+export { type CliCommandExecutedEvent, type CliCommandExecutedEventData, type CliEventContext, RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, type ZapierCliSdkOptions, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption, negationKebabName };

package/dist/index.mjs

@@ -7,7 +7,7 @@ import crypto, { createHash } from 'crypto';
 import * as path from 'path';
 import { resolve, join, dirname, basename, relative, extname } from 'path';
 import * as lockfile from 'proper-lockfile';
-import { defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineMethodOverride, zapierCoreOptions, injectCliLogin, definePlugin, omitExports, zapierSdkPlugin, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, getOrCreateApiClient, isCredentialsObject, createSdk, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, isCoreCancelledSignal, ZapierAuthenticationError, CORE_OPTIONS_ID, SDK_OPTIONS_ID, addPlugin, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, getReleaseId, getCurrentTimestamp, generateEventId, DEPRECATION_NOTICE_EVENT } from '@zapier/zapier-sdk';
+import { defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineMethodOverride, zapierCoreOptions, injectCliLogin, definePlugin, omitExports, zapierSdkPlugin, getConnectionPlugin, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, getOrCreateApiClient, isCredentialsObject, createSdk, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, isCoreCancelledSignal, ZapierAuthenticationError, CORE_OPTIONS_ID, SDK_OPTIONS_ID, addPlugin, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, getReleaseId, getCurrentTimestamp, generateEventId, DEPRECATION_NOTICE_EVENT } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 import chalk3 from 'chalk';
 import { hostname } from 'os';
@@ -32,6 +32,7 @@ import crossSpawn from 'cross-spawn';
 import wrapAnsi from 'wrap-ansi';
 import Table from 'cli-table3';
 import { triggerInboxResolver, DrainTriggerInboxSchema, WatchTriggerInboxSchema } from '@zapier/zapier-sdk/experimental';
+import 'commander';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -6820,7 +6821,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -6904,7 +6905,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.69.0"};
+  version: "0.71.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -6996,5 +6997,13 @@ var SHARED_COMMAND_CLI_OPTIONS = [
     description: "Output raw JSON instead of formatted results"
   }
 ];
+function negationKebabName(param) {
+  if (param.negatable === true) return `no-${toKebabCase(param.name)}`;
+  if (typeof param.negatable === "string") return toKebabCase(param.negatable);
+  return void 0;
+}
+({
+  [getConnectionPlugin.name]: /* @__PURE__ */ new Set(["connection"])
+});
 
-export { RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption };
+export { RESERVED_CLI_OPTIONS, ReservedCliParameter, SHARED_COMMAND_CLI_OPTIONS, buildCliCommandExecutedEvent, createZapierCliSdk, getReservedCliOption, negationKebabName };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk-cli",
-  "version": "0.69.0",
+  "version": "0.71.0",
   "description": "Command line interface for Zapier SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -95,8 +95,8 @@
     "typescript": "^5.8.3",
     "wrap-ansi": "^10.0.0",
     "zod": "4.3.6",
-    "@zapier/zapier-sdk": "0.92.1",
-    "@zapier/zapier-sdk-mcp": "0.18.22"
+    "@zapier/zapier-sdk": "0.94.0",
+    "@zapier/zapier-sdk-mcp": "0.19.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",