@zapier/zapier-sdk-cli 0.44.1 → 0.46.0

package/dist/cli.cjs

@@ -27,6 +27,7 @@ var isInstalledGlobally = require('is-installed-globally');
 var child_process = require('child_process');
 var Handlebars = require('handlebars');
 var url = require('url');
+var experimental = require('@zapier/zapier-sdk/experimental');
 var packageJsonLib = require('package-json');
 var semver = require('semver');
 
@@ -123,7 +124,7 @@ function formatZodError(error) {
 }
 function getLocalResolutionOrder(paramName, resolvers, resolved = /* @__PURE__ */ new Set()) {
   const resolver = resolvers[paramName];
-  if (!resolver || resolver.type === "static") {
+  if (!resolver || resolver.type === "static" || resolver.type === "constant") {
     return [paramName];
   }
   const order = [];
@@ -206,7 +207,11 @@ var SchemaParameterResolver = class {
         }
         return parseResult.data;
       }
-      const resolvedParams = { ...providedParams };
+      const resolverConstants = this.getResolverConstants(sdk, functionName);
+      const resolvedParams = {
+        ...resolverConstants,
+        ...providedParams
+      };
       const context = {
         sdk,
         currentParams: providedParams,
@@ -367,12 +372,22 @@ var SchemaParameterResolver = class {
     const missingParams = [];
     for (const param of params) {
       const resolver = this.getResolver(param.name, context.sdk, functionName);
-      const autoResolution = resolver?.type === "dynamic" ? await this.tryAutoResolve(resolver, context) : null;
-      if (autoResolution != null) {
+      let autoResolved = null;
+      if (resolver?.type === "constant") {
+        autoResolved = {
+          resolvedValue: resolver.value
+        };
+      } else if (resolver?.type === "dynamic") {
+        autoResolved = await this.tryAutoResolve(
+          resolver,
+          context
+        );
+      }
+      if (autoResolved != null) {
         this.setNestedValue(
           resolvedParams,
           param.path,
-          autoResolution.resolvedValue
+          autoResolved.resolvedValue
         );
         context.resolvedParams = resolvedParams;
       } else {
@@ -406,7 +421,11 @@ var SchemaParameterResolver = class {
     const promptLabel = inArrayContext ? `${param.name}[${arrayIndex}]` : param.name;
     const promptName = inArrayContext ? "value" : param.name;
     this.debugLog(`Resolving ${promptLabel}${isOptional ? " (optional)" : ""}`);
-    if (resolver.type === "static") {
+    if (resolver.type === "constant") {
+      const constantResolver = resolver;
+      this.stopSpinner();
+      return constantResolver.value;
+    } else if (resolver.type === "static") {
       const staticResolver = resolver;
       const promptConfig = {
         type: staticResolver.inputType === "password" ? "password" : "input",
@@ -466,6 +485,7 @@ var SchemaParameterResolver = class {
       }
       const LOAD_MORE_SENTINEL = Symbol("LOAD_MORE");
       const SKIP_SENTINEL = Symbol("SKIP");
+      const CUSTOM_VALUE_SENTINEL = Symbol("CUSTOM_VALUE");
       let newItemsStartIndex = -1;
       this.stopSpinner();
       while (true) {
@@ -474,12 +494,27 @@ var SchemaParameterResolver = class {
           context.resolvedParams
         );
         promptConfig.name = promptName;
+        const hasSelectableChoice = promptConfig.choices?.some(
+          (c) => !c.disabled
+        );
+        if (!hasSelectableChoice && !hasMore) {
+          throw new ZapierCliValidationError(
+            `No ${promptLabel} available to select.`
+          );
+        }
         if (isOptional && promptConfig.choices) {
           promptConfig.choices.unshift({
             name: chalk7__default.default.dim("(Skip)"),
             value: SKIP_SENTINEL
           });
         }
+        if (promptConfig.choices && promptConfig.type === "list") {
+          const insertAt = isOptional ? 1 : 0;
+          promptConfig.choices.splice(insertAt, 0, {
+            name: chalk7__default.default.dim("(Enter custom value)"),
+            value: CUSTOM_VALUE_SENTINEL
+          });
+        }
         if (hasMore && pageIterator && promptConfig.choices) {
           promptConfig.choices.push({
             name: chalk7__default.default.dim("(Load more...)"),
@@ -502,7 +537,7 @@ var SchemaParameterResolver = class {
           }
         }
         if (newItemsStartIndex >= 0 && promptConfig.choices) {
-          const injectedBefore = isOptional ? 1 : 0;
+          const injectedBefore = (isOptional ? 1 : 0) + (promptConfig.type === "list" ? 1 : 0);
           const adjustedIndex = newItemsStartIndex + injectedBefore;
           if (promptConfig.choices[adjustedIndex]) {
             promptConfig.default = promptConfig.choices[adjustedIndex].value;
@@ -514,6 +549,20 @@ var SchemaParameterResolver = class {
         if (selected === SKIP_SENTINEL) {
           return void 0;
         }
+        if (selected === CUSTOM_VALUE_SENTINEL) {
+          const customAnswer = await inquirer__default.default.prompt([
+            {
+              type: "input",
+              name: promptName,
+              message: `Enter ${promptLabel}${isOptional ? " (optional)" : ""}:`
+            }
+          ]);
+          const value = customAnswer[promptName];
+          if (isOptional && (value === void 0 || value === "")) {
+            return void 0;
+          }
+          return value;
+        }
         const wantsMore = Array.isArray(selected) ? selected.includes(LOAD_MORE_SENTINEL) : selected === LOAD_MORE_SENTINEL;
         if (wantsMore && pageIterator) {
           if (Array.isArray(selected)) {
@@ -844,7 +893,7 @@ Optional fields${pathContext}:`));
         cursor ? `Fetching more choices for ${fieldMeta.title}` : `Fetching choices for ${fieldMeta.title}`
       );
       this.startSpinner();
-      const page = await context.sdk.listInputFieldChoices({
+      const page = await context.sdk.listActionInputFieldChoices({
         app: context.resolvedParams.app,
         action: context.resolvedParams.action,
         actionType: context.resolvedParams.actionType,
@@ -1081,6 +1130,23 @@ Optional fields${pathContext}:`));
     );
     return functionInfo?.resolvers || {};
   }
+  getResolverConstants(sdk, functionName) {
+    if (!functionName || typeof sdk.getRegistry !== "function") {
+      return {};
+    }
+    const registry = sdk.getRegistry();
+    const functionInfo = registry.functions.find(
+      (f) => f.name === functionName
+    );
+    const resolvers = functionInfo?.resolvers ?? {};
+    const constants = {};
+    for (const [key, resolver] of Object.entries(resolvers)) {
+      if (resolver && typeof resolver === "object" && resolver.type === "constant") {
+        constants[key] = resolver.value;
+      }
+    }
+    return constants;
+  }
 };
 
 // src/utils/cli-options.ts
@@ -1113,7 +1179,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.44.1"};
+  version: "0.46.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1324,8 +1390,18 @@ async function unwrapHttpResponse(response) {
     );
   }
 }
+function jsonReplacer(_key, value) {
+  if (value instanceof Error) {
+    return {
+      name: value.name,
+      message: value.message,
+      ...value.stack ? { stack: value.stack } : {}
+    };
+  }
+  return value;
+}
 function outputJson(envelope) {
-  console.log(JSON.stringify(envelope, null, 2));
+  console.log(JSON.stringify(envelope, jsonReplacer, 2));
 }
 function createJsonRenderer() {
   return {
@@ -1726,6 +1802,10 @@ function analyzeZodField(name, schema, functionInfo) {
       break;
     }
   }
+  const baseSchemaDef = baseSchema._zod?.def;
+  if (baseSchema instanceof zod.z.ZodFunction || baseSchemaDef?.type === "custom") {
+    return null;
+  }
   let paramType = "string";
   let elementType;
   let choices;
@@ -1920,7 +2000,8 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
       }
     }
   }
-  const description = functionInfo.description || schema?.description || `${cliCommandName} command`;
+  const baseDescription = functionInfo.description || schema?.description || `${cliCommandName} command`;
+  const description = functionInfo.experimental ? `${baseDescription} (experimental)` : baseDescription;
   const handler = async (...args) => {
     const startTime = Date.now();
     let success = true;
@@ -3156,7 +3237,8 @@ var mcpPlugin = zapierSdk.definePlugin(
       await zapierSdkMcp.startMcpServer({
         ...options,
         debug: sdk2.context.options?.debug,
-        extensions: sdk2.context.extensions
+        extensions: sdk2.context.extensions,
+        experimental: sdk2.context.experimental
       });
     }
   })
@@ -3179,15 +3261,6 @@ var bundleCodePlugin = zapierSdk.definePlugin(
     handler: async ({ options }) => bundleCode(options)
   })
 );
-var ZapierBundleError = class extends Error {
-  constructor(message, details, originalError) {
-    super(message);
-    this.code = "ZAPIER_BUNDLE_ERROR";
-    this.name = "ZapierBundleError";
-    this.details = details;
-    this.originalError = originalError;
-  }
-};
 async function bundleCode(options) {
   const {
     input,
@@ -3215,14 +3288,14 @@ async function bundleCode(options) {
     });
     if (result.errors.length > 0) {
       const errorMessages = result.errors.map((e) => e.text);
-      throw new ZapierBundleError(
+      throw new zapierSdk.ZapierBundleError(
         `Bundle failed: ${errorMessages.join(", ")}`,
-        errorMessages
+        { buildErrors: errorMessages }
       );
     }
     const bundledCode = result.outputFiles?.[0]?.text;
     if (!bundledCode) {
-      throw new ZapierBundleError("No output generated");
+      throw new zapierSdk.ZapierBundleError("No output generated");
     }
     let finalOutput = bundledCode;
     if (returnString) {
@@ -3234,13 +3307,12 @@ async function bundleCode(options) {
     }
     return finalOutput;
   } catch (error) {
-    if (error instanceof ZapierBundleError) {
+    if (error instanceof zapierSdk.ZapierBundleError) {
       throw error;
     }
-    throw new ZapierBundleError(
+    throw new zapierSdk.ZapierBundleError(
       `Bundle failed: ${error instanceof Error ? error.message : "Unknown error"}`,
-      void 0,
-      error instanceof Error ? error : void 0
+      { cause: error instanceof Error ? error : void 0 }
     );
   }
 }
@@ -3415,7 +3487,7 @@ var AstTypeGenerator = class {
     const actions = actionsResult.data;
     const actionsWithFields = [];
     const inputFieldsTasks = actions.map(
-      (action) => () => sdk.listInputFields({
+      (action) => () => sdk.listActionInputFields({
         appKey: app.implementation_id,
         actionKey: action.key,
         actionType: action.action_type,
@@ -4292,11 +4364,12 @@ var CurlSchema = zod.z.object({
   /** @deprecated Use `connection` instead. */
   connectionId: zod.z.union([zod.z.string(), zod.z.number()]).optional().meta({ deprecated: true })
 }).describe("Make HTTP requests through Zapier Relay with curl-like options");
-var CurlExitError = class extends Error {
+var ZapierCurlExitError = class extends zapierSdk.ZapierError {
   constructor(message, exitCode) {
     super(message);
+    this.name = "ZapierCurlExitError";
+    this.code = "ZAPIER_CURL_EXIT_ERROR";
     this.exitCode = exitCode;
-    this.name = "CurlExitError";
   }
 };
 function parseHeaderLine(input) {
@@ -4388,7 +4461,7 @@ async function resolveDataArgBinary(raw) {
 }
 async function buildFormData(formArgs, formStringArgs) {
   if (typeof FormData === "undefined") {
-    throw new CurlExitError(
+    throw new ZapierCurlExitError(
       "FormData is not available in this runtime; cannot use --form.",
       2
     );
@@ -4397,7 +4470,7 @@ async function buildFormData(formArgs, formStringArgs) {
   const addField = async (item, forceString) => {
     const idx = item.indexOf("=");
     if (idx === -1) {
-      throw new CurlExitError(
+      throw new ZapierCurlExitError(
         `Invalid form field: '${item}'. Expected 'name=value' or 'name=@file'.`,
         2
       );
@@ -4405,7 +4478,7 @@ async function buildFormData(formArgs, formStringArgs) {
     const name = item.slice(0, idx);
     const value = item.slice(idx + 1);
     if (!name) {
-      throw new CurlExitError(
+      throw new ZapierCurlExitError(
         `Invalid form field: '${item}'. Field name cannot be empty.`,
         2
       );
@@ -4642,7 +4715,7 @@ ${Array.from(
 `
         );
       }
-      throw new CurlExitError("HTTP request failed", 22);
+      throw new ZapierCurlExitError("HTTP request failed", 22);
     }
     return void 0;
   }
@@ -5188,11 +5261,481 @@ var initPlugin = zapierSdk.definePlugin(
     }
   })
 );
+var CliSkipLeaseExpireError = class extends Error {
+  constructor() {
+    super("user skipped (let lease expire)");
+    this.name = "CliSkipLeaseExpireError";
+  }
+};
+function createInteractiveCallback() {
+  let messageNumber = 0;
+  return async (message) => {
+    messageNumber++;
+    const attrs = message.message_attributes;
+    console.log(
+      `
+${chalk7__default.default.bold(`Message #${messageNumber}`)} ${chalk7__default.default.dim(message.id)} ${chalk7__default.default.dim(`(lease #${attrs.lease_count})`)}`
+    );
+    if (attrs.error_message) {
+      console.log(chalk7__default.default.yellow(`  upstream error: ${attrs.error_message}`));
+    }
+    if (attrs.possible_duplicate_data) {
+      console.log(chalk7__default.default.yellow("  possible duplicate data"));
+    }
+    while (true) {
+      let action;
+      try {
+        const answer = await inquirer__default.default.prompt([
+          {
+            type: "list",
+            name: "action",
+            message: "Action?",
+            choices: [
+              { name: "Ack (remove from inbox)", value: "ack" },
+              {
+                name: "Skip (release after draining)",
+                value: "skip-release"
+              },
+              { name: "Skip (let lease expire)", value: "skip-expire" },
+              { name: "View payload", value: "view" },
+              { name: "Quit", value: "quit" }
+            ]
+          }
+        ]);
+        action = answer.action;
+      } catch (error) {
+        if (error instanceof Error && error.name === "ExitPromptError") {
+          throw new zapierSdk.ZapierAbortDrainSignal("user pressed Ctrl-C");
+        }
+        throw error;
+      }
+      if (action === "view") {
+        console.log(chalk7__default.default.dim(JSON.stringify(message.payload, null, 2)));
+        continue;
+      }
+      if (action === "ack") {
+        return;
+      }
+      if (action === "skip-release") {
+        throw new zapierSdk.ZapierReleaseTriggerMessageSignal("user skipped (release)");
+      }
+      if (action === "skip-expire") {
+        throw new CliSkipLeaseExpireError();
+      }
+      if (action === "quit") {
+        throw new zapierSdk.ZapierAbortDrainSignal("user requested quit");
+      }
+    }
+  };
+}
+function createNdjsonCallback() {
+  return (message) => new Promise((resolve4, reject) => {
+    process.stdout.write(JSON.stringify(message) + "\n", (err) => {
+      if (err) reject(err);
+      else resolve4();
+    });
+  });
+}
+function runSubprocess(options) {
+  const { command, args, shell, label, message, signal } = options;
+  return new Promise((resolve4, reject) => {
+    const child = child_process.spawn(command, args, {
+      shell,
+      stdio: ["pipe", "inherit", "inherit"]
+    });
+    let abortListener;
+    if (signal) {
+      if (signal.aborted) {
+        child.kill();
+      } else {
+        abortListener = () => {
+          child.kill();
+        };
+        signal.addEventListener("abort", abortListener, { once: true });
+      }
+    }
+    child.on("error", (err) => {
+      if (signal && abortListener) {
+        signal.removeEventListener("abort", abortListener);
+      }
+      reject(err);
+    });
+    child.on("close", (code) => {
+      if (signal && abortListener) {
+        signal.removeEventListener("abort", abortListener);
+      }
+      if (signal?.aborted) {
+        reject(new zapierSdk.ZapierAbortDrainSignal(`${label} aborted`));
+        return;
+      }
+      if (code === 0) resolve4();
+      else
+        reject(
+          new Error(
+            `${label} exited with code ${code} for message ${message.id}`
+          )
+        );
+    });
+    child.stdin.on("error", (err) => {
+      if (err.code !== "EPIPE") reject(err);
+    });
+    child.stdin.end(JSON.stringify(message) + "\n");
+  });
+}
+function runShellCommand(command, message, signal) {
+  return runSubprocess({
+    command,
+    args: [],
+    shell: true,
+    label: "exec-shell",
+    message,
+    signal
+  });
+}
+function runExecCommand(argv, message, signal) {
+  if (argv.length === 0) {
+    return Promise.reject(
+      new Error("exec requires at least one element (the binary)")
+    );
+  }
+  const [command, ...args] = argv;
+  return runSubprocess({
+    command,
+    args,
+    shell: false,
+    label: "exec",
+    message,
+    signal
+  });
+}
+function describeReason(reason) {
+  return reason instanceof Error ? reason.message : String(reason);
+}
+function printDrainError(reason, message) {
+  console.error(
+    chalk7__default.default.red(`Error processing ${message.id}: ${describeReason(reason)}`)
+  );
+}
+function printDrainSummary(counts) {
+  const skipped = counts.skipped ?? 0;
+  const total = counts.fulfilled + counts.rejected + skipped;
+  const parts = [`${counts.fulfilled} fulfilled`];
+  if (skipped > 0) parts.push(`${skipped} skipped`);
+  parts.push(`${counts.rejected} rejected`);
+  console.log(
+    chalk7__default.default.dim(
+      `
+Processed ${total} message${total === 1 ? "" : "s"} (${parts.join(", ")}).`
+    )
+  );
+}
+function warnInteractiveContinueOnErrorOverride() {
+  console.warn(
+    chalk7__default.default.yellow(
+      'Note: continueOnError=false is overridden to true in interactive mode (the "Skip (let lease expire)" choice would otherwise terminate the drain).'
+    )
+  );
+}
+function requireInteractiveTty(commandName) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new ZapierCliValidationError(
+      `${commandName} needs an interactive terminal by default. Pass --exec '<bin>' (with optional \`-- args...\`) or --exec-shell '<cmd>' to run a script per message, or --json for non-interactive output.`
+    );
+  }
+}
+function rejectExecJsonMutex(opts) {
+  const picked = [
+    opts.exec ? "--exec" : null,
+    opts.execShell ? "--exec-shell" : null,
+    opts.json ? "--json" : null
+  ].filter((x) => x !== null);
+  if (picked.length > 1) {
+    throw new ZapierCliValidationError(
+      `${picked.join(", ")} are mutually exclusive. Pick one.`
+    );
+  }
+}
+function getPostDashArgs(argv = process.argv) {
+  const idx = argv.indexOf("--");
+  if (idx === -1) return [];
+  return argv.slice(idx + 1);
+}
+function combineSignals(a, b) {
+  if (!a) {
+    return { signal: b, dispose: () => void 0 };
+  }
+  const controller = new AbortController();
+  const onAbort = () => controller.abort();
+  if (a.aborted || b.aborted) controller.abort();
+  else {
+    a.addEventListener("abort", onAbort, { once: true });
+    b.addEventListener("abort", onAbort, { once: true });
+  }
+  return {
+    signal: controller.signal,
+    dispose: () => {
+      a.removeEventListener("abort", onAbort);
+      b.removeEventListener("abort", onAbort);
+    }
+  };
+}
+
+// src/plugins/drainTriggerInbox/index.ts
+var JsonProperty = zod.z.boolean().optional().describe(
+  "Format the drained result as a JSON object on stdout: { data, errors }. Use for scripts or piping. Mutually exclusive with --exec / --exec-shell and the interactive default."
+);
+var ExecCliProperty = zod.z.string().optional().describe(
+  "Run a binary per message with no shell interpretation. Message JSON is piped to stdin; exit code 0 acks, non-zero records the error per the same rules as a thrown handler. Pass extra argv after `--` (e.g. `--exec ./handler -- --verbose`). Mutually exclusive with --exec-shell and --json."
+);
+var ExecShellCliProperty = zod.z.string().optional().describe(
+  "Run a shell command per message. Message JSON is piped to the subprocess on stdin; exit code 0 acks, non-zero records the error per the same rules as a thrown handler. Interpreted by the platform's default shell (sh on POSIX, cmd.exe on Windows). Mutually exclusive with --exec and --json."
+);
+var drainTriggerInboxCliPlugin = zapierSdk.definePlugin(
+  (sdk) => {
+    const original = sdk.drainTriggerInbox;
+    const existingMeta = sdk.context.meta.drainTriggerInbox;
+    const baseInputSchema = existingMeta.inputSchema;
+    const extendedInputSchema = baseInputSchema ? baseInputSchema.extend({
+      exec: ExecCliProperty,
+      execShell: ExecShellCliProperty,
+      json: JsonProperty
+    }) : zod.z.object({
+      exec: ExecCliProperty,
+      execShell: ExecShellCliProperty,
+      json: JsonProperty
+    });
+    return {
+      drainTriggerInbox: async (options) => {
+        const { json, exec, execShell, ...sdkArgs } = options;
+        rejectExecJsonMutex({ exec, execShell, json });
+        if (!exec && !execShell && !json) {
+          requireInteractiveTty("drain-trigger-inbox");
+        }
+        const sigintController = new AbortController();
+        const onSigint = () => sigintController.abort();
+        process.on("SIGINT", onSigint);
+        const combined = combineSignals(
+          sdkArgs.signal,
+          sigintController.signal
+        );
+        let fulfilled = 0;
+        let rejected = 0;
+        let skipped = 0;
+        const liveOnError = (reason, message) => {
+          rejected++;
+          printDrainError(reason, message);
+        };
+        try {
+          if (exec) {
+            const execArgv = [exec, ...getPostDashArgs()];
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              onMessage: async (message) => {
+                await runExecCommand(execArgv, message, combined.signal);
+                fulfilled++;
+              },
+              onError: liveOnError
+            });
+            return;
+          }
+          if (execShell) {
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              onMessage: async (message) => {
+                await runShellCommand(execShell, message, combined.signal);
+                fulfilled++;
+              },
+              onError: liveOnError
+            });
+            return;
+          }
+          if (json) {
+            const data = [];
+            const errors = [];
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              continueOnError: true,
+              onMessage: (message) => {
+                data.push(message);
+              },
+              onError: (reason, message) => {
+                errors.push({ reason, message });
+              }
+            });
+            process.stdout.write(
+              JSON.stringify({ data, errors }, jsonReplacer, 2) + "\n"
+            );
+            return;
+          }
+          if (sdkArgs.continueOnError === false) {
+            warnInteractiveContinueOnErrorOverride();
+          }
+          const interactive = createInteractiveCallback();
+          await original({
+            ...sdkArgs,
+            signal: combined.signal,
+            concurrency: 1,
+            continueOnError: true,
+            onMessage: async (message) => {
+              try {
+                await interactive(message);
+                fulfilled++;
+              } catch (err) {
+                if (err instanceof zapierSdk.ZapierReleaseTriggerMessageSignal || err instanceof CliSkipLeaseExpireError) {
+                  skipped++;
+                }
+                throw err;
+              }
+            }
+          });
+        } finally {
+          process.off("SIGINT", onSigint);
+          combined.dispose();
+          if (!json) {
+            printDrainSummary({ fulfilled, rejected, skipped });
+          }
+        }
+      },
+      context: {
+        meta: {
+          drainTriggerInbox: {
+            ...existingMeta,
+            inputSchema: extendedInputSchema,
+            packages: void 0
+          }
+        }
+      }
+    };
+  }
+);
+var JsonProperty2 = zod.z.boolean().optional().describe(
+  "Stream each message as JSON to stdout (one record per line, NDJSON), acking as each write completes. Use for piping to other tools. Mutually exclusive with --exec / --exec-shell and the interactive default."
+);
+var ExecCliProperty2 = zod.z.string().optional().describe(
+  "Run a binary per message with no shell interpretation. Message JSON is piped to stdin; exit code 0 acks, non-zero records the error per the same rules as a thrown handler. Pass extra argv after `--` (e.g. `--exec ./handler -- --verbose`). Mutually exclusive with --exec-shell and --json."
+);
+var ExecShellCliProperty2 = zod.z.string().optional().describe(
+  "Run a shell command per message. Message JSON is piped to the subprocess on stdin; exit code 0 acks, non-zero records the error per the same rules as a thrown handler. Interpreted by the platform's default shell (sh on POSIX, cmd.exe on Windows). Mutually exclusive with --exec and --json."
+);
+var watchTriggerInboxCliPlugin = zapierSdk.definePlugin(
+  (sdk) => {
+    const original = sdk.watchTriggerInbox;
+    const existingMeta = sdk.context.meta.watchTriggerInbox;
+    const baseInputSchema = existingMeta.inputSchema;
+    const extendedInputSchema = baseInputSchema ? baseInputSchema.extend({
+      exec: ExecCliProperty2,
+      execShell: ExecShellCliProperty2,
+      json: JsonProperty2
+    }) : zod.z.object({
+      exec: ExecCliProperty2,
+      execShell: ExecShellCliProperty2,
+      json: JsonProperty2
+    });
+    return {
+      watchTriggerInbox: async (options) => {
+        const { json, exec, execShell, ...sdkArgs } = options;
+        rejectExecJsonMutex({ exec, execShell, json });
+        if (!exec && !execShell && !json) {
+          requireInteractiveTty("watch-trigger-inbox");
+        }
+        const sigintController = new AbortController();
+        const onSigint = () => sigintController.abort();
+        process.on("SIGINT", onSigint);
+        const combined = combineSignals(
+          sdkArgs.signal,
+          sigintController.signal
+        );
+        let fulfilled = 0;
+        let rejected = 0;
+        let skipped = 0;
+        const liveOnError = (reason, message) => {
+          rejected++;
+          printDrainError(reason, message);
+        };
+        try {
+          if (exec) {
+            const execArgv = [exec, ...getPostDashArgs()];
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              onMessage: async (message) => {
+                await runExecCommand(execArgv, message, combined.signal);
+                fulfilled++;
+              },
+              onError: liveOnError
+            });
+          } else if (execShell) {
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              onMessage: async (message) => {
+                await runShellCommand(execShell, message, combined.signal);
+                fulfilled++;
+              },
+              onError: liveOnError
+            });
+          } else if (json) {
+            const ndjson = createNdjsonCallback();
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              onMessage: async (message) => {
+                await ndjson(message);
+                fulfilled++;
+              },
+              onError: liveOnError
+            });
+          } else {
+            if (sdkArgs.continueOnError === false) {
+              warnInteractiveContinueOnErrorOverride();
+            }
+            const interactive = createInteractiveCallback();
+            await original({
+              ...sdkArgs,
+              signal: combined.signal,
+              concurrency: 1,
+              continueOnError: true,
+              onMessage: async (message) => {
+                try {
+                  await interactive(message);
+                  fulfilled++;
+                } catch (err) {
+                  if (err instanceof zapierSdk.ZapierReleaseTriggerMessageSignal || err instanceof CliSkipLeaseExpireError) {
+                    skipped++;
+                  }
+                  throw err;
+                }
+              }
+            });
+          }
+        } finally {
+          process.off("SIGINT", onSigint);
+          combined.dispose();
+          if (!json) {
+            printDrainSummary({ fulfilled, rejected, skipped });
+          }
+        }
+      },
+      context: {
+        meta: {
+          watchTriggerInbox: {
+            ...existingMeta,
+            inputSchema: extendedInputSchema,
+            packages: void 0
+          }
+        }
+      }
+    };
+  }
+);
 
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.44.1"};
+  version: "0.46.0"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -5217,6 +5760,31 @@ function createZapierCliSdk(options = {}) {
   }
   return chain;
 }
+experimental.injectCliLogin(login_exports);
+function createZapierCliSdk2(options = {}) {
+  const { extensions = [], ...sdkOptions } = options;
+  const extensionsContextPlugin = () => ({
+    context: { extensions }
+  });
+  const experimentalContextPlugin = () => ({
+    context: { experimental: true }
+  });
+  let chain = experimental.createZapierSdk({
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
+    callerPackage: { name: package_default2.name, version: package_default2.version }
+  }).addPlugin(extensionsContextPlugin).addPlugin(experimentalContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(drainTriggerInboxCliPlugin, { override: true }).addPlugin(watchTriggerInboxCliPlugin, { override: true }).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  for (const ext of extensions) {
+    try {
+      chain = chain.addPlugin(ext);
+    } catch (err) {
+      console.warn(
+        `Extension plugin failed to construct: ${err.message}; skipping.`
+      );
+    }
+  }
+  return chain;
+}
 
 // src/utils/extensions.ts
 var ENV_VAR = "ZAPIER_SDK_EXTENSIONS";
@@ -5429,7 +5997,7 @@ program.name("zapier-sdk").description("CLI for Zapier SDK").version(
 ).option(
   "--max-network-retry-delay-ms <ms>",
   "Max delay in ms to wait for rate limit retry (default: 60000)"
-);
+).option("--experimental", "Use the experimental SDK / CLI surface");
 var booleanFlags = [];
 for (const [key, fieldSchema] of Object.entries(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -5494,11 +6062,13 @@ for (const { camelName, kebabFlag } of booleanFlags) {
     flagOverrides[camelName] = true;
   }
 }
+var useExperimental = process.argv.includes("--experimental") || process.env.ZAPIER_EXPERIMENTAL === "1" || process.env.ZAPIER_EXPERIMENTAL === "true";
+var createZapierCliSdk3 = useExperimental ? createZapierCliSdk2 : createZapierCliSdk;
 program.exitOverride();
 (async () => {
   let exitCode = 0;
   const extensions = await resolveExtensions();
-  const sdk = createZapierCliSdk({
+  const sdk = createZapierCliSdk3({
     debug: isDebugMode,
     credentials,
     baseUrl,