@zapier/zapier-sdk-cli 0.84.6 → 0.85.0

package/dist/cli.cjs

@@ -5,7 +5,7 @@ var commander = require('commander');
 var zapierSdk = require('@zapier/zapier-sdk');
 var zod = require('zod');
 var inquirer = require('inquirer');
-var chalk9 = require('chalk');
+var chalk10 = require('chalk');
 var core = require('@inquirer/core');
 var ora = require('ora');
 var fs = require('fs');
@@ -35,6 +35,7 @@ var semver = require('semver');
 var crossSpawn = require('cross-spawn');
 var Table = require('cli-table3');
 var experimental = require('@zapier/zapier-sdk/experimental');
+var beta = require('@zapier/zapier-sdk/beta');
 var readline = require('readline');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -59,7 +60,7 @@ function _interopNamespace(e) {
 }
 
 var inquirer__default = /*#__PURE__*/_interopDefault(inquirer);
-var chalk9__default = /*#__PURE__*/_interopDefault(chalk9);
+var chalk10__default = /*#__PURE__*/_interopDefault(chalk10);
 var ora__default = /*#__PURE__*/_interopDefault(ora);
 var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
 var path__namespace = /*#__PURE__*/_interopNamespace(path);
@@ -104,9 +105,9 @@ function normalizeChoices(choices) {
 var theme = core.makeTheme({
   icon: { cursor: "\u276F" },
   style: {
-    disabled: (text) => chalk9__default.default.dim(`- ${text}`),
-    searchTerm: (text) => chalk9__default.default.cyan(text),
-    keysHelpTip: (keys) => keys.map(([key, action]) => `${chalk9__default.default.bold(key)} ${chalk9__default.default.dim(action)}`).join(chalk9__default.default.dim(" \u2022 "))
+    disabled: (text) => chalk10__default.default.dim(`- ${text}`),
+    searchTerm: (text) => chalk10__default.default.cyan(text),
+    keysHelpTip: (keys) => keys.map(([key, action]) => `${chalk10__default.default.bold(key)} ${chalk10__default.default.dim(action)}`).join(chalk10__default.default.dim(" \u2022 "))
   }
 });
 var searchSelect = core.createPrompt(
@@ -249,10 +250,10 @@ async function promptText({
   ]);
   return value;
 }
-var display = (c) => c.hint ? `${c.label} ${chalk9__default.default.dim(`(${c.hint})`)}` : c.label;
+var display = (c) => c.hint ? `${c.label} ${chalk10__default.default.dim(`(${c.hint})`)}` : c.label;
 var HIGH_CONTRAST_PROMPT_THEME = {
   style: {
-    answer: (text) => chalk9__default.default.inverse.bold(` ${text} `)
+    answer: (text) => chalk10__default.default.inverse.bold(` ${text} `)
   }
 };
 function buildSelectRows(question, term) {
@@ -268,8 +269,8 @@ function buildSelectRows(question, term) {
     name: display(c),
     value: c.value
   }));
-  const skipRow = offers(question, "skip") ? [row(chalk9__default.default.dim("Skip (optional)"), "skip")] : [];
-  const customRow = offers(question, "custom") ? [row(chalk9__default.default.dim("Enter a value manually\u2026"), "custom")] : [];
+  const skipRow = offers(question, "skip") ? [row(chalk10__default.default.dim("Skip (optional)"), "skip")] : [];
+  const customRow = offers(question, "custom") ? [row(chalk10__default.default.dim("Enter a value manually\u2026"), "custom")] : [];
   const committed = !!t || question.search !== void 0;
   let rows;
   if (!committed) {
@@ -280,13 +281,13 @@ function buildSelectRows(question, term) {
     rows = [...customRow, ...skipRow];
   }
   if (offers(question, "search"))
-    rows.push(row(chalk9__default.default.cyan("Search again\u2026"), "search"));
+    rows.push(row(chalk10__default.default.cyan("Search again\u2026"), "search"));
   if (offers(question, "next_page"))
-    rows.push(row(chalk9__default.default.dim("Load more\u2026"), "next_page"));
-  if (offers(question, "retry")) rows.push(row(chalk9__default.default.yellow("Retry"), "retry"));
-  if (offers(question, "cancel")) rows.push(row(chalk9__default.default.dim("Cancel"), "cancel"));
+    rows.push(row(chalk10__default.default.dim("Load more\u2026"), "next_page"));
+  if (offers(question, "retry")) rows.push(row(chalk10__default.default.yellow("Retry"), "retry"));
+  if (offers(question, "cancel")) rows.push(row(chalk10__default.default.dim("Cancel"), "cancel"));
   for (const note of question.notes ?? [])
-    rows.push({ name: chalk9__default.default.dim(note), value: note, disabled: true });
+    rows.push({ name: chalk10__default.default.dim(note), value: note, disabled: true });
   return rows;
 }
 function foldPage(acc, question, field) {
@@ -366,12 +367,12 @@ async function answerSelect(question, field, box, failed, mode) {
       })),
       ...offers(question, "next_page") ? [
         {
-          name: chalk9__default.default.dim("Load more\u2026"),
+          name: chalk10__default.default.dim("Load more\u2026"),
           value: { action: "next_page" }
         }
       ] : [],
       ...(question.notes ?? []).map((note) => ({
-        name: chalk9__default.default.dim(note),
+        name: chalk10__default.default.dim(note),
         value: note,
         disabled: true
       }))
@@ -448,14 +449,14 @@ async function answerSelect(question, field, box, failed, mode) {
     case "retry":
       return { type: "retry" };
     case "skip":
-      printAnswered(view.message, chalk9__default.default.dim("(skipped)"));
+      printAnswered(view.message, chalk10__default.default.dim("(skipped)"));
       return { type: "skip" };
     case "cancel":
       return { type: "cancel" };
   }
 }
 function printAnswered(message, label) {
-  console.log(`${chalk9__default.default.green("\u2714")} ${message} ${chalk9__default.default.cyan(label)}`);
+  console.log(`${chalk10__default.default.green("\u2714")} ${message} ${chalk10__default.default.cyan(label)}`);
 }
 async function answerInput(question) {
   const message = question.placeholder ? question.message.replace(/:?\s*$/, ` (${question.placeholder}):`) : question.message;
@@ -502,7 +503,7 @@ function createCliAnswer({
     try {
       if (result.error !== void 0) {
         const message = typeof result.error === "string" ? result.error : result.error.message;
-        console.log(chalk9__default.default.yellow(`! ${message}`));
+        console.log(chalk10__default.default.yellow(`! ${message}`));
       }
       const question = result.question;
       const field = question.path.length ? question.path.join(".") : "value";
@@ -571,8 +572,6 @@ var ZapierCliMissingParametersError = class extends ZapierCliError {
     this.params = params;
   }
 };
-
-// src/utils/cli-options.ts
 var RESERVED_CLI_OPTIONS = [
   {
     name: "version" /* Version */,
@@ -585,6 +584,11 @@ var RESERVED_CLI_OPTIONS = [
     flag: "--help",
     short: "-h",
     description: "Display help for command"
+  },
+  {
+    name: "stability" /* Stability */,
+    flag: "--stability <level>",
+    description: `Which stability tier of the SDK / CLI surface to use: ${zapierSdk.STABILITY_LEVELS.join(", ")}. Can also be set with the ZAPIER_STABILITY environment variable (default: stable).`
   }
 ];
 function getReservedCliOption(name) {
@@ -602,7 +606,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.84.6"};
+  version: "0.85.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -767,7 +771,7 @@ async function formatItemsFromSchema(_functionInfo, items, startingNumber = 0, o
   formatItemsGeneric(items, startingNumber);
 }
 function formatSingleItem(formatted, itemNumber) {
-  let titleLine = `${chalk9__default.default.gray(`${itemNumber + 1}.`)} ${chalk9__default.default.cyan(formatted.title)}`;
+  let titleLine = `${chalk10__default.default.gray(`${itemNumber + 1}.`)} ${chalk10__default.default.cyan(formatted.title)}`;
   const subtitleParts = [];
   if (formatted.hint !== void 0) {
     subtitleParts.push(
@@ -785,11 +789,11 @@ function formatSingleItem(formatted, itemNumber) {
   }
   const uniqueParts = [...new Set(subtitleParts)];
   if (uniqueParts.length > 0) {
-    titleLine += ` ${chalk9__default.default.gray(`(${uniqueParts.join(", ")})`)}`;
+    titleLine += ` ${chalk10__default.default.gray(`(${uniqueParts.join(", ")})`)}`;
   }
   console.log(titleLine);
   if (formatted.description) {
-    console.log(`   ${chalk9__default.default.dim(formatted.description)}`);
+    console.log(`   ${chalk10__default.default.dim(formatted.description)}`);
   }
   if (formatted.raw !== void 0) {
     formatJsonOutput(formatted.raw);
@@ -800,7 +804,7 @@ function formatSingleItem(formatted, itemNumber) {
     if (detail.label) {
       const isMultiline = detail.text.includes("\n");
       if (isMultiline) {
-        console.log(`   ${chalk9__default.default.gray(detail.label + ":")}`);
+        console.log(`   ${chalk10__default.default.gray(detail.label + ":")}`);
         const displayText = formatDetailText(
           detail.text,
           DETAIL_INDENT + "   "
@@ -809,7 +813,7 @@ function formatSingleItem(formatted, itemNumber) {
         console.log(`${DETAIL_INDENT}   ${styledText}`);
       } else {
         const styledValue = applyStyle(detail.text, detail.style);
-        console.log(`   ${chalk9__default.default.gray(detail.label + ":")} ${styledValue}`);
+        console.log(`   ${chalk10__default.default.gray(detail.label + ":")} ${styledValue}`);
       }
     } else {
       const displayText = formatDetailText(detail.text, DETAIL_INDENT);
@@ -833,16 +837,16 @@ function formatDetailText(text, indent = DETAIL_INDENT) {
 function applyStyle(value, style) {
   switch (style) {
     case "dim":
-      return chalk9__default.default.dim(value);
+      return chalk10__default.default.dim(value);
     case "accent":
-      return chalk9__default.default.magenta(value);
+      return chalk10__default.default.magenta(value);
     case "warning":
-      return chalk9__default.default.red(value);
+      return chalk10__default.default.red(value);
     case "success":
-      return chalk9__default.default.green(value);
+      return chalk10__default.default.green(value);
     case "normal":
     default:
-      return chalk9__default.default.blue(value);
+      return chalk10__default.default.blue(value);
   }
 }
 function convertGenericItemToFormattedItem(item) {
@@ -991,10 +995,10 @@ function createInteractiveRenderer(context = {}) {
         const obj = item;
         const name = obj?.name || obj?.key || obj?.id || "Item";
         console.log(
-          `${chalk9__default.default.gray(`${startingNumber + index + 1}.`)} ${chalk9__default.default.cyan(String(name))}`
+          `${chalk10__default.default.gray(`${startingNumber + index + 1}.`)} ${chalk10__default.default.cyan(String(name))}`
         );
         if (obj?.description)
-          console.log(`   ${chalk9__default.default.dim(String(obj.description))}`);
+          console.log(`   ${chalk10__default.default.dim(String(obj.description))}`);
         console.log();
       });
     }
@@ -1005,35 +1009,35 @@ function createInteractiveRenderer(context = {}) {
       if (!(Symbol.asyncIterator in Object(source))) {
         const items = source?.data;
         if (!Array.isArray(items) || items.length === 0) {
-          console.log(chalk9__default.default.yellow(`No ${itemName} found.`));
+          console.log(chalk10__default.default.yellow(`No ${itemName} found.`));
           return;
         }
         await renderItemsForDisplay(items, functionInfo, 0);
-        console.log(chalk9__default.default.green(`
+        console.log(chalk10__default.default.green(`
 \u2705 Showing ${items.length} ${itemName}`));
         return;
       }
       let totalShown = 0;
       let pageCount = 0;
-      console.log(chalk9__default.default.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
+      console.log(chalk10__default.default.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
 `));
       for await (const page of source) {
         const items = page.data ?? [];
         pageCount++;
         if (items.length === 0 && pageCount === 1) {
-          console.log(chalk9__default.default.yellow(`No ${itemName} found.`));
+          console.log(chalk10__default.default.yellow(`No ${itemName} found.`));
           return;
         }
         if (items.length === 0) break;
         if (pageCount > 1) {
           console.clear();
-          console.log(chalk9__default.default.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
+          console.log(chalk10__default.default.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
 `));
         }
         await renderItemsForDisplay(items, functionInfo, totalShown);
         totalShown += items.length;
         console.log(
-          chalk9__default.default.green(
+          chalk10__default.default.green(
             `
 \u2705 Showing ${totalShown} ${itemName} (page ${pageCount})`
           )
@@ -1052,7 +1056,7 @@ function createInteractiveRenderer(context = {}) {
           break;
         }
       }
-      console.log(chalk9__default.default.gray(`
+      console.log(chalk10__default.default.gray(`
 \u{1F4C4} Finished browsing ${itemName}`));
     },
     async renderCollectedList(items, { maxItems, userSpecifiedMaxItems, functionInfo } = {}) {
@@ -1062,30 +1066,30 @@ function createInteractiveRenderer(context = {}) {
       }
       const itemName = getItemName(functionInfo);
       if (items.length === 0) {
-        console.log(chalk9__default.default.yellow(`No ${itemName} found.`));
+        console.log(chalk10__default.default.yellow(`No ${itemName} found.`));
         return;
       }
-      console.log(chalk9__default.default.green(`
+      console.log(chalk10__default.default.green(`
 \u2705 Found ${items.length} ${itemName}:
 `));
       await renderItemsForDisplay(items, functionInfo);
       if (userSpecifiedMaxItems && maxItems) {
         console.log(
-          chalk9__default.default.gray(
+          chalk10__default.default.gray(
             `
 \u{1F4C4} Showing up to ${maxItems} ${itemName} (--max-items ${maxItems})`
           )
         );
       } else {
-        console.log(chalk9__default.default.gray(`
+        console.log(chalk10__default.default.gray(`
 \u{1F4C4} All available ${itemName} shown`));
       }
     },
     renderItem(value, options) {
       if (options?.outputFile) {
         const label = options.commandName ? `\u2705 ${options.commandName} completed successfully!` : "\u2705 Done!";
-        console.log(chalk9__default.default.green(label));
-        console.log(chalk9__default.default.gray(`Output written to: ${options.outputFile}`));
+        console.log(chalk10__default.default.green(label));
+        console.log(chalk10__default.default.gray(`Output written to: ${options.outputFile}`));
       } else {
         formatJsonOutput(value);
       }
@@ -1095,17 +1099,17 @@ function createInteractiveRenderer(context = {}) {
     },
     renderError(error) {
       if (error instanceof ZapierCliMissingParametersError) {
-        console.error(chalk9__default.default.red("\u274C " + formatMissingParamsError(error)));
-        console.error("\n" + chalk9__default.default.dim("Use --help to see available options"));
+        console.error(chalk10__default.default.red("\u274C " + formatMissingParamsError(error)));
+        console.error("\n" + chalk10__default.default.dim("Use --help to see available options"));
         throw new ZapierCliExitError(error.message, 1);
       }
       if (zapierSdk.isZapierError(error)) {
         const formattedMessage = zapierSdk.formatErrorMessage(error);
-        console.error(chalk9__default.default.red("\u274C Error:"), formattedMessage);
+        console.error(chalk10__default.default.red("\u274C Error:"), formattedMessage);
         throw new ZapierCliExitError(formattedMessage, 1);
       }
       const msg = error instanceof Error ? error.message : "Unknown error";
-      console.error(chalk9__default.default.red("\u274C Error:"), msg);
+      console.error(chalk10__default.default.red("\u274C Error:"), msg);
       throw new ZapierCliExitError(msg, 1);
     }
   };
@@ -1148,6 +1152,17 @@ function sanitizeCliArguments(args) {
 function resolveNonInteractive(options) {
   return options.nonInteractive === true || options.skipPrompts === true || !process.stdin.isTTY || !process.stdout.isTTY;
 }
+function warningBlock({
+  banner,
+  message,
+  detail
+}) {
+  console.warn();
+  console.warn(chalk10__default.default.yellow.bold(banner) + chalk10__default.default.yellow(message));
+  if (detail) console.warn(chalk10__default.default.yellow(`   ${detail}`));
+  console.warn();
+}
+var DEPRECATION_BANNER = "\u26A0\uFE0F  DEPRECATION WARNING";
 var CLI_COMMAND_EXECUTED_EVENT_SUBJECT = "platform.sdk.CliCommandExecutedEvent";
 var PAGINATION_PARAM_NAMES = /* @__PURE__ */ new Set(["maxItems", "pageSize", "cursor"]);
 function getNormalizedResult(result, { isListCommand }) {
@@ -1221,7 +1236,7 @@ async function promptConfirm(confirmType, itemType) {
   }
   const configOrFn = CONFIRM_MESSAGES[confirmType];
   const { messageBefore, messageAfter } = typeof configOrFn === "function" ? configOrFn(itemType) : configOrFn;
-  console.log(chalk9__default.default.yellow(`
+  console.log(chalk10__default.default.yellow(`
 ${messageBefore}
 `));
   const { confirmed } = await inquirer__default.default.prompt([
@@ -1243,16 +1258,11 @@ function emitParamDeprecationWarnings({
     const value = options[param.name];
     if (value === void 0) continue;
     if (Array.isArray(value) && value.length === 0) continue;
-    console.warn();
-    console.warn(
-      chalk9__default.default.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9__default.default.yellow(
-        ` - \`${toKebabCase(param.name)}\` is deprecated and may be removed in a future release.`
-      )
-    );
-    if (param.deprecationMessage) {
-      console.warn(chalk9__default.default.yellow(`   ${param.deprecationMessage}`));
-    }
-    console.warn();
+    warningBlock({
+      banner: DEPRECATION_BANNER,
+      message: ` - \`${toKebabCase(param.name)}\` is deprecated and may be removed in a future release.`,
+      detail: param.deprecationMessage
+    });
   }
 }
 function resolveOutputMode({
@@ -1467,6 +1477,12 @@ function readCliRegistry(sdk) {
 function generateCliCommands(program2, sdk) {
   const registry = readCliRegistry(sdk);
   if (!registry) return;
+  const stabilityByCommandName = new Map(
+    registry.functions.map((fn) => [
+      methodNameToCliCommand(fn.name),
+      fn.stability
+    ])
+  );
   registry.functions.forEach((fnInfo) => {
     if (!fnInfo.inputSchema) {
       console.warn(`Schema not found for ${fnInfo.name}`);
@@ -1501,6 +1517,15 @@ function generateCliCommands(program2, sdk) {
       const commands = helper.visibleCommands(cmd);
       if (commands.length > 0) {
         output += "\nCommands:\n";
+        const labeledSubcommandTerm = (command) => {
+          const term = helper.subcommandTerm(command);
+          const name = command.name();
+          const labeledName = zapierSdk.applyStabilityLabel({
+            description: name,
+            stability: stabilityByCommandName.get(name)
+          });
+          return labeledName !== name && term.startsWith(name) ? labeledName + term.slice(name.length) : term;
+        };
         const categorizedCommands = /* @__PURE__ */ new Set();
         registry.categories.forEach((category) => {
           const categoryCommands = commands.filter(
@@ -1514,7 +1539,7 @@ function generateCliCommands(program2, sdk) {
   ${category.titlePlural}:
 `;
             categoryCommands.forEach((command) => {
-              output += `    ${helper.subcommandTerm(command)}
+              output += `    ${labeledSubcommandTerm(command)}
 `;
               categorizedCommands.add(command.name());
             });
@@ -1528,7 +1553,7 @@ function generateCliCommands(program2, sdk) {
   Other:
 `;
           otherCommands.forEach((command) => {
-            output += `    ${helper.subcommandTerm(command)}
+            output += `    ${labeledSubcommandTerm(command)}
 `;
           });
         }
@@ -1553,7 +1578,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
     }
   }
   const baseDescription = functionInfo.description || schema?.description || `${cliCommandName} command`;
-  const description = functionInfo.experimental ? `${baseDescription} (experimental)` : baseDescription;
+  const description = zapierSdk.applyStabilityLabel({
+    description: baseDescription,
+    stability: functionInfo.stability
+  });
   const handler = async (...args) => {
     const startTime = Date.now();
     let success = true;
@@ -1649,7 +1677,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
           functionInfo.itemType
         );
         if (!confirmResult.confirmed) {
-          console.log(chalk9__default.default.yellow("Operation cancelled."));
+          console.log(chalk10__default.default.yellow("Operation cancelled."));
           return;
         }
         confirmMessageAfter = confirmResult.messageAfter;
@@ -1710,7 +1738,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
             renderer.renderItem(normalizedResult.value);
           }
           if (confirmMessageAfter) {
-            console.log(chalk9__default.default.yellow(`
+            console.log(chalk10__default.default.yellow(`
 ${confirmMessageAfter}`));
           }
           break;
@@ -3129,14 +3157,14 @@ function formatCredentialsChoice({
   credentials: credentials2,
   current
 }) {
-  const currentLabel = current ? chalk9__default.default.cyan(" (current)") : "";
+  const currentLabel = current ? chalk10__default.default.cyan(" (current)") : "";
   const details = [
     credentials2.clientId,
     credentials2.scopes.join(", "),
     `created ${createdAtIso(credentials2).slice(0, 10)}`
   ].join(" \xB7 ");
   return {
-    name: `${credentials2.name}${currentLabel} ${chalk9__default.default.dim(`\xB7 ${details}`)}`,
+    name: `${credentials2.name}${currentLabel} ${chalk10__default.default.dim(`\xB7 ${details}`)}`,
     short: credentials2.name,
     value: { action: "switch", credentials: credentials2 }
   };
@@ -3312,20 +3340,20 @@ var getCallablePromise = () => {
 var getCallablePromise_default = getCallablePromise;
 var log = {
   info: (message, ...args) => {
-    console.error(chalk9__default.default.blue("\u2139"), message, ...args);
+    console.error(chalk10__default.default.blue("\u2139"), message, ...args);
   },
   error: (message, ...args) => {
-    console.error(chalk9__default.default.red("\u2716"), message, ...args);
+    console.error(chalk10__default.default.red("\u2716"), message, ...args);
   },
   success: (message, ...args) => {
-    console.error(chalk9__default.default.green("\u2713"), message, ...args);
+    console.error(chalk10__default.default.green("\u2713"), message, ...args);
   },
   warn: (message, ...args) => {
-    console.error(chalk9__default.default.yellow("\u26A0"), message, ...args);
+    console.error(chalk10__default.default.yellow("\u26A0"), message, ...args);
   },
   debug: (message, ...args) => {
     if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
-      console.error(chalk9__default.default.gray("\u{1F41B}"), message, ...args);
+      console.error(chalk10__default.default.gray("\u{1F41B}"), message, ...args);
     }
   }
 };
@@ -4837,9 +4865,10 @@ var CLI_EXTENSIONS_ID = "cli/extensions";
 var cliExtensionsPluginRef = zapierSdk.declareOptionalProperty({
   id: CLI_EXTENSIONS_ID
 });
-var CLI_EXPERIMENTAL_ID = "cli/experimental";
-var cliExperimentalPluginRef = zapierSdk.declareOptionalProperty({
-  id: CLI_EXPERIMENTAL_ID
+var EXPERIMENTAL_BIN_ENV = "ZAPIER_SDK_EXPERIMENTAL_BIN";
+var CLI_STABILITY_ID = "cli/stability";
+var cliStabilityPluginRef = zapierSdk.declareOptionalProperty({
+  id: CLI_STABILITY_ID
 });
 var McpSchema = zod.z.object({
   port: zod.z.string().optional().describe("Port to listen on (for future HTTP transport)")
@@ -4848,11 +4877,7 @@ var McpSchema = zod.z.object({
 // src/plugins/mcp/index.ts
 var mcpPlugin = zapierSdk.defineMethod({
   name: "mcp",
-  imports: [
-    zapierSdk.sdkOptionsPluginRef,
-    cliExtensionsPluginRef,
-    cliExperimentalPluginRef
-  ],
+  imports: [zapierSdk.sdkOptionsPluginRef, cliExtensionsPluginRef, cliStabilityPluginRef],
   output: "raw",
   inputSchema: McpSchema,
   categories: ["utility"],
@@ -4862,7 +4887,7 @@ var mcpPlugin = zapierSdk.defineMethod({
       debug: imports.sdkOptions?.debug,
       maxConcurrentRequests: imports.sdkOptions?.maxConcurrentRequests,
       extensions: imports.extensions,
-      experimental: imports.experimental
+      stability: imports.stability
     });
   }
 });
@@ -6493,7 +6518,7 @@ function buildTemplateVariables({
   };
 }
 function cleanupProject({ projectDir }) {
-  console.log("\n" + chalk9__default.default.yellow("!") + "  Cleaning up...");
+  console.log("\n" + chalk10__default.default.yellow("!") + "  Cleaning up...");
   fs.rmSync(projectDir, { recursive: true, force: true });
 }
 async function withInterruptCleanup(cleanup, fn) {
@@ -6703,8 +6728,8 @@ function buildNextSteps({
 }
 function createConsoleDisplayHooks() {
   return {
-    onItemComplete: (message) => console.log("   " + chalk9__default.default.green("\u2713") + "  " + chalk9__default.default.dim(message)),
-    onWarn: (message) => console.warn(chalk9__default.default.yellow("!") + "  " + message),
+    onItemComplete: (message) => console.log("   " + chalk10__default.default.green("\u2713") + "  " + chalk10__default.default.dim(message)),
+    onWarn: (message) => console.warn(chalk10__default.default.yellow("!") + "  " + message),
     onStepStart: ({
       description,
       stepNumber,
@@ -6713,31 +6738,31 @@ function createConsoleDisplayHooks() {
       nonInteractive
     }) => {
       const progressMessage = `${description}...`;
-      const stepCounter = chalk9__default.default.dim(`${stepNumber}/${totalSteps}`);
+      const stepCounter = chalk10__default.default.dim(`${stepNumber}/${totalSteps}`);
       if (nonInteractive) {
         console.log(
-          "\n" + chalk9__default.default.bold(`\u276F  ${progressMessage}`) + "  " + stepCounter + "\n"
+          "\n" + chalk10__default.default.bold(`\u276F  ${progressMessage}`) + "  " + stepCounter + "\n"
         );
       } else {
         console.log(
-          chalk9__default.default.dim("\u2192") + "  " + progressMessage + "  " + stepCounter
+          chalk10__default.default.dim("\u2192") + "  " + progressMessage + "  " + stepCounter
         );
       }
       if (command) {
-        console.log("   " + chalk9__default.default.cyan(`$ ${command}`));
+        console.log("   " + chalk10__default.default.cyan(`$ ${command}`));
       }
     },
     onStepSuccess: ({ stepNumber, totalSteps }) => console.log(
-      "\n" + chalk9__default.default.green("\u2713") + "  " + chalk9__default.default.dim(`Step ${stepNumber}/${totalSteps} complete`) + "\n"
+      "\n" + chalk10__default.default.green("\u2713") + "  " + chalk10__default.default.dim(`Step ${stepNumber}/${totalSteps} complete`) + "\n"
     ),
     onStepError: ({ description, command, err }) => {
       const detail = err instanceof Error && err.message ? `
-   ${chalk9__default.default.dim(err.message)}` : "";
+   ${chalk10__default.default.dim(err.message)}` : "";
       const hint = command ? `
-   ${chalk9__default.default.dim("run manually:")} ${chalk9__default.default.cyan(`$ ${command}`)}` : "";
+   ${chalk10__default.default.dim("run manually:")} ${chalk10__default.default.cyan(`$ ${command}`)}` : "";
       console.error(
         `
-${chalk9__default.default.red("\u2716")}  ${chalk9__default.default.bold(description)}${chalk9__default.default.dim(" failed")}${detail}${hint}`
+${chalk10__default.default.red("\u2716")}  ${chalk10__default.default.bold(description)}${chalk10__default.default.dim(" failed")}${detail}${hint}`
       );
     }
   };
@@ -6749,22 +6774,22 @@ function displaySummaryAndNextSteps({
   packageManager
 }) {
   const formatStatus = (complete) => ({
-    icon: complete ? chalk9__default.default.green("\u2713") : chalk9__default.default.yellow("!"),
-    text: complete ? chalk9__default.default.green("Setup complete") : chalk9__default.default.yellow("Setup interrupted")
+    icon: complete ? chalk10__default.default.green("\u2713") : chalk10__default.default.yellow("!"),
+    text: complete ? chalk10__default.default.green("Setup complete") : chalk10__default.default.yellow("Setup interrupted")
   });
-  const formatNextStep = (step, i) => "   " + chalk9__default.default.dim(`${i + 1}.`) + "  " + chalk9__default.default.bold(step.description);
-  const formatCommand = (cmd) => "       " + chalk9__default.default.cyan(`$ ${cmd}`);
-  const formatCompletedStep = (step) => "   " + chalk9__default.default.green("\u2713") + "  " + step.description;
+  const formatNextStep = (step, i) => "   " + chalk10__default.default.dim(`${i + 1}.`) + "  " + chalk10__default.default.bold(step.description);
+  const formatCommand = (cmd) => "       " + chalk10__default.default.cyan(`$ ${cmd}`);
+  const formatCompletedStep = (step) => "   " + chalk10__default.default.green("\u2713") + "  " + step.description;
   const { execCmd } = getPackageManagerCommands({ packageManager });
   const leftoverSteps = steps.filter(
     (s) => !completedSetupStepIds.includes(s.id)
   );
   const isComplete = leftoverSteps.length === 0;
   const status = formatStatus(isComplete);
-  console.log("\n" + chalk9__default.default.bold("\u276F  Summary") + "\n");
-  console.log("   " + chalk9__default.default.dim("Project") + "   " + chalk9__default.default.bold(projectName));
+  console.log("\n" + chalk10__default.default.bold("\u276F  Summary") + "\n");
+  console.log("   " + chalk10__default.default.dim("Project") + "   " + chalk10__default.default.bold(projectName));
   console.log(
-    "   " + chalk9__default.default.dim("Status") + "    " + status.icon + "  " + status.text
+    "   " + chalk10__default.default.dim("Status") + "    " + status.icon + "  " + status.text
   );
   const completedSteps = steps.filter(
     (s) => completedSetupStepIds.includes(s.id)
@@ -6774,7 +6799,7 @@ function displaySummaryAndNextSteps({
     for (const step of completedSteps) console.log(formatCompletedStep(step));
   }
   const nextSteps = buildNextSteps({ projectName, leftoverSteps, execCmd });
-  console.log("\n" + chalk9__default.default.bold("\u276F  Next Steps") + "\n");
+  console.log("\n" + chalk10__default.default.bold("\u276F  Next Steps") + "\n");
   nextSteps.forEach((step, i) => {
     console.log(formatNextStep(step, i));
     if (step.command) console.log(formatCommand(step.command));
@@ -6959,26 +6984,26 @@ function displayUpdateNotification(versionInfo, packageName) {
   if (versionInfo.isDeprecated) {
     console.error();
     console.error(
-      chalk9__default.default.red.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9__default.default.red(
+      chalk10__default.default.red.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk10__default.default.red(
         ` - ${packageName} v${versionInfo.currentVersion} is deprecated.`
       )
     );
     if (versionInfo.deprecationMessage) {
-      console.error(chalk9__default.default.red(`   ${versionInfo.deprecationMessage}`));
+      console.error(chalk10__default.default.red(`   ${versionInfo.deprecationMessage}`));
     }
-    console.error(chalk9__default.default.red(`   Please update to the latest version.`));
+    console.error(chalk10__default.default.red(`   Please update to the latest version.`));
     console.error();
   }
   if (versionInfo.hasUpdate) {
     console.error();
     console.error(
-      chalk9__default.default.yellow.bold("\u{1F4E6} Update available!") + chalk9__default.default.yellow(
+      chalk10__default.default.yellow.bold("\u{1F4E6} Update available!") + chalk10__default.default.yellow(
         ` ${packageName} v${versionInfo.currentVersion} \u2192 v${versionInfo.latestVersion}`
       )
     );
     console.error(
-      chalk9__default.default.yellow(
-        `   Run ${chalk9__default.default.bold(getUpdateCommand(packageName))} to update.`
+      chalk10__default.default.yellow(
+        `   Run ${chalk10__default.default.bold(getUpdateCommand(packageName))} to update.`
       )
     );
     console.error();
@@ -7019,7 +7044,7 @@ var boltFillRanks = new Map(
 );
 var STATUS_ROW_INDEX = Math.floor(boltRows.length / 2);
 function formatPhase({ label, detail }) {
-  return detail ? `${chalk9__default.default.bold(label)}  ${chalk9__default.default.dim(detail)}` : chalk9__default.default.bold(label);
+  return detail ? `${chalk10__default.default.bold(label)}  ${chalk10__default.default.dim(detail)}` : chalk10__default.default.bold(label);
 }
 function formatLoaderFrame({
   phase,
@@ -7031,7 +7056,7 @@ function formatLoaderFrame({
       const cellIndex = rowIndex * row.length + columnIndex;
       const fillRank = boltFillRanks.get(cellIndex);
       const isFilled = fillRank !== void 0 && fillRank < fillStage;
-      return isFilled ? chalk9__default.default.bold.yellow(cell) : chalk9__default.default.dim.yellow(cell);
+      return isFilled ? chalk10__default.default.bold.yellow(cell) : chalk10__default.default.dim.yellow(cell);
     }).join("");
     const status = rowIndex === STATUS_ROW_INDEX ? `   ${formatPhase(phase)}` : "";
     return `${bolt}${status}`;
@@ -7063,12 +7088,12 @@ async function runWithSetupLoader({
     const result = await promise;
     clearInterval(animationTimer);
     const elapsedSeconds = ((Date.now() - startedAt) / 1e3).toFixed(1);
-    loader.succeed(`${formatPhase(phase)}  ${chalk9__default.default.dim(`${elapsedSeconds}s`)}`);
+    loader.succeed(`${formatPhase(phase)}  ${chalk10__default.default.dim(`${elapsedSeconds}s`)}`);
     return result;
   } catch (error) {
     clearInterval(animationTimer);
     const elapsedSeconds = ((Date.now() - startedAt) / 1e3).toFixed(1);
-    loader.fail(`${formatPhase(phase)}  ${chalk9__default.default.dim(`${elapsedSeconds}s`)}`);
+    loader.fail(`${formatPhase(phase)}  ${chalk10__default.default.dim(`${elapsedSeconds}s`)}`);
     throw error;
   }
 }
@@ -7559,7 +7584,7 @@ async function runCommand({
         detail: commandLabel
       });
     }
-    console.log(chalk9__default.default.dim(commandLabel));
+    console.log(chalk10__default.default.dim(commandLabel));
     return await execute;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -7826,7 +7851,7 @@ function printAgentPrompt({
   message
 }) {
   console.log();
-  console.log(chalk9__default.default.bgYellow.black.bold(message));
+  console.log(chalk10__default.default.bgYellow.black.bold(message));
   console.log();
   console.log(buildAgentPrompt({ context }));
 }
@@ -8111,7 +8136,7 @@ var MINIMUM_MESSAGE_WIDTH = 20;
 var MAXIMUM_MESSAGE_WIDTH = 88;
 function showPhase({ number, title }) {
   console.log();
-  console.log(chalk9__default.default.bgCyan.black.bold(` ${number}/${PHASE_COUNT}  ${title} `));
+  console.log(chalk10__default.default.bgCyan.black.bold(` ${number}/${PHASE_COUNT}  ${title} `));
 }
 function printWrapped(text) {
   const width = Math.max(
@@ -8125,7 +8150,7 @@ function printWrapped(text) {
 }
 function showReadyMessage() {
   console.log();
-  console.log(chalk9__default.default.bgGreen.black.bold(" \u2713 Zapier SDK setup complete "));
+  console.log(chalk10__default.default.bgGreen.black.bold(" \u2713 Zapier SDK setup complete "));
   console.log();
   printWrapped(
     "Use active Zapier connections to access 9,000+ app connectors without managing each app's OAuth, token refresh, or retries."
@@ -8137,7 +8162,7 @@ function showReadyMessage() {
   console.log();
 }
 async function runWizard(context) {
-  console.log(chalk9__default.default.bold("Zapier SDK setup"));
+  console.log(chalk10__default.default.bold("Zapier SDK setup"));
   showPhase({ number: 1, title: "Project directory" });
   await chooseDirectory(context);
   showPhase({ number: 2, title: "Node.js" });
@@ -8152,7 +8177,7 @@ async function runWizard(context) {
   showPhase({ number: 6, title: "Slack demo" });
   await offerSlackTest(context);
   showReadyMessage();
-  console.log(chalk9__default.default.bgCyan.black.bold(" Next steps "));
+  console.log(chalk10__default.default.bgCyan.black.bold(" Next steps "));
   await openAgentHandoff(context);
 }
 
@@ -8201,13 +8226,13 @@ function createInteractiveCallback() {
     const attrs = message.message_attributes;
     console.log(
       `
-${chalk9__default.default.bold(`Message #${messageNumber}`)} ${chalk9__default.default.dim(message.id)} ${chalk9__default.default.dim(`(lease #${attrs.lease_count})`)}`
+${chalk10__default.default.bold(`Message #${messageNumber}`)} ${chalk10__default.default.dim(message.id)} ${chalk10__default.default.dim(`(lease #${attrs.lease_count})`)}`
     );
     if (attrs.error_message) {
-      console.log(chalk9__default.default.yellow(`  upstream error: ${attrs.error_message}`));
+      console.log(chalk10__default.default.yellow(`  upstream error: ${attrs.error_message}`));
     }
     if (attrs.possible_duplicate_data) {
-      console.log(chalk9__default.default.yellow("  possible duplicate data"));
+      console.log(chalk10__default.default.yellow("  possible duplicate data"));
     }
     while (true) {
       let action;
@@ -8237,7 +8262,7 @@ ${chalk9__default.default.bold(`Message #${messageNumber}`)} ${chalk9__default.d
         throw error;
       }
       if (action === "view") {
-        console.log(chalk9__default.default.dim(JSON.stringify(message.payload, null, 2)));
+        console.log(chalk10__default.default.dim(JSON.stringify(message.payload, null, 2)));
         continue;
       }
       if (action === "ack") {
@@ -8340,7 +8365,7 @@ function describeReason(reason) {
 }
 function printDrainError(reason, message) {
   console.error(
-    chalk9__default.default.red(`Error processing ${message.id}: ${describeReason(reason)}`)
+    chalk10__default.default.red(`Error processing ${message.id}: ${describeReason(reason)}`)
   );
 }
 function printDrainSummary(counts) {
@@ -8350,7 +8375,7 @@ function printDrainSummary(counts) {
   if (skipped > 0) parts.push(`${skipped} skipped`);
   parts.push(`${counts.rejected} rejected`);
   console.log(
-    chalk9__default.default.dim(
+    chalk10__default.default.dim(
       `
 Processed ${total} message${total === 1 ? "" : "s"} (${parts.join(", ")}).`
     )
@@ -8358,7 +8383,7 @@ Processed ${total} message${total === 1 ? "" : "s"} (${parts.join(", ")}).`
 }
 function warnInteractiveContinueOnErrorOverride() {
   console.warn(
-    chalk9__default.default.yellow(
+    chalk10__default.default.yellow(
       'Note: continueOnError=false is overridden to true in interactive mode (the "Skip (let lease expire)" choice would otherwise terminate the drain).'
     )
   );
@@ -8684,7 +8709,7 @@ var createWorkflowCliPlugin = experimental.defineMethod({
   type: "create",
   itemType: "Workflow",
   categories: ["code-workflow"],
-  experimental: true,
+  stability: "experimental",
   inputSchema: CreateWorkflowCliOptionsSchema,
   outputSchema: experimental.CreateWorkflowResponseSchema,
   skipOutputValidation: true,
@@ -8716,7 +8741,7 @@ function renderDeprecationNotices() {
   console.error();
   for (const message of messages) {
     for (const line of buildBoxLines(message)) {
-      console.error(chalk9__default.default.red.bold(line));
+      console.error(chalk10__default.default.red.bold(line));
     }
     console.error();
   }
@@ -8737,21 +8762,33 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.84.6"};
+  version: "0.85.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
+var warnedStabilityMethods = /* @__PURE__ */ new Set();
 var cliCoreOptions = {
   ...zapierSdk.zapierCoreOptions,
   logDeprecation: ({ methodName, deprecation }) => {
     if (warnedDeprecatedMethods.has(methodName)) return;
     warnedDeprecatedMethods.add(methodName);
-    console.warn();
-    console.warn(
-      chalk9__default.default.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9__default.default.yellow(` - \`${toKebabCase(methodName)}\` is deprecated.`)
-    );
-    console.warn(chalk9__default.default.yellow(`   ${deprecation.message}`));
-    console.warn();
+    warningBlock({
+      banner: DEPRECATION_BANNER,
+      message: ` - \`${toKebabCase(methodName)}\` is deprecated.`,
+      detail: deprecation.message
+    });
+  },
+  logStabilityNotice: ({ methodName, stability }) => {
+    if (stability === "stable") return;
+    if (warnedStabilityMethods.has(methodName)) return;
+    warnedStabilityMethods.add(methodName);
+    warningBlock({
+      banner: `\u26A0\uFE0F  ${stability.toUpperCase()} COMMAND`,
+      message: ` - \`${toKebabCase(methodName)}\` is marked ${stability}.`,
+      // The detail line is the tier's consumer contract, so the CLI says the
+      // same thing as the SDK's runtime notice and the generated docs.
+      detail: zapierSdk.STABILITY_DEFINITIONS[stability]
+    });
   }
 };
 zapierSdk.injectCliLogin(login_exports);
@@ -8816,8 +8853,65 @@ function createZapierCliSdk(options = {}) {
   }
   return sdk;
 }
-experimental.injectCliLogin(login_exports);
+beta.injectCliLogin(login_exports);
 function createZapierCliSdk2(options = {}) {
+  const { extensions = [], ...sdkOptions } = options;
+  const stackOptions = {
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
+    callerPackage: { name: package_default2.name, version: package_default2.version },
+    // Collected for the boxed stderr warning rendered in the exit path. The
+    // box is additive: the SDK's own inline warn still fires, so the notice
+    // cannot be hidden by any rendering path.
+    onEvent: (event) => collectDeprecationNoticeAndForward(event, sdkOptions.onEvent)
+  };
+  const cliBetaSdkPlugin = beta.definePlugin({
+    namespace: "zapier",
+    name: "cli-beta-sdk",
+    exports: [
+      beta.omitExports(beta.zapierBetaSdkPlugin, [
+        "drainTriggerInbox",
+        "watchTriggerInbox"
+      ]),
+      drainTriggerInboxCliPlugin,
+      watchTriggerInboxCliPlugin,
+      loginPlugin,
+      signupPlugin,
+      logoutPlugin,
+      mcpPlugin,
+      getLoginConfigPathPlugin,
+      initPlugin,
+      setupPlugin,
+      bundleCodePlugin,
+      feedbackPlugin,
+      curlPlugin,
+      addAppsPlugin,
+      buildManifestPlugin,
+      generateAppTypesPlugin
+    ]
+  });
+  const sdk = beta.createSdk(cliBetaSdkPlugin, {
+    configuration: {
+      [beta.SDK_OPTIONS_ID]: stackOptions,
+      [beta.CORE_OPTIONS_ID]: cliCoreOptions,
+      [CLI_EXTENSIONS_ID]: extensions,
+      // Built by the beta factory: `mcp` reads this to launch the beta MCP
+      // server so the surfaces stay aligned.
+      [CLI_STABILITY_ID]: "beta"
+    }
+  });
+  beta.addPlugin(sdk, cliFetchOverride);
+  for (const ext of extensions) {
+    try {
+      beta.addPlugin(sdk, ext);
+    } catch (err) {
+      console.warn(beta.formatExtensionPluginFailure(err));
+    }
+  }
+  return sdk;
+}
+experimental.injectCliLogin(login_exports);
+function createZapierCliSdk3(options = {}) {
   const { extensions = [], ...sdkOptions } = options;
   const stackOptions = {
     ...sdkOptions,
@@ -8862,7 +8956,7 @@ function createZapierCliSdk2(options = {}) {
       [CLI_EXTENSIONS_ID]: extensions,
       // Built by the experimental factory: `mcp` reads this to launch the
       // experimental MCP server so the surfaces stay aligned.
-      [CLI_EXPERIMENTAL_ID]: true
+      [CLI_STABILITY_ID]: "experimental"
     }
   });
   experimental.addPlugin(sdk, cliFetchOverride);
@@ -9003,11 +9097,11 @@ function buildFrameLines(state, frameIndex) {
   const bodyWidth = width - 2;
   const bodyTextWidth = innerWidth - 2;
   const content = [];
-  content.push(chalk9__default.default.bold.cyan("Approval review"));
+  content.push(chalk10__default.default.bold.cyan("Approval review"));
   content.push("");
   if (!state.verdict) {
     content.push(
-      chalk9__default.default.yellow(`${SPINNER_FRAMES[frameIndex]} Checking approval...`)
+      chalk10__default.default.yellow(`${SPINNER_FRAMES[frameIndex]} Checking approval...`)
     );
   }
   const recentMessages = state.messages.slice(-5);
@@ -9018,13 +9112,13 @@ function buildFrameLines(state, frameIndex) {
       "\n"
     );
     segments.forEach((segment, segmentIndex) => {
-      const prefix = segmentIndex === 0 ? chalk9__default.default.cyan("> ") : "  ";
-      content.push(`${prefix}${dimmed ? chalk9__default.default.dim(segment) : segment}`);
+      const prefix = segmentIndex === 0 ? chalk10__default.default.cyan("> ") : "  ";
+      content.push(`${prefix}${dimmed ? chalk10__default.default.dim(segment) : segment}`);
     });
   });
   if (state.streamError) {
     if (hasMessages || !state.verdict) content.push("");
-    content.push(chalk9__default.default.bold.red("Approval stream error"));
+    content.push(chalk10__default.default.bold.red("Approval stream error"));
     for (const segment of wrapAnsi4__default.default(state.streamError, bodyTextWidth, {
       hard: true
     }).split("\n")) {
@@ -9034,7 +9128,7 @@ function buildFrameLines(state, frameIndex) {
   if (state.verdict) {
     if (hasMessages || state.streamError) content.push("");
     content.push(
-      chalk9__default.default.bold.green(`${state.verdict.icon} ${state.verdict.label}`)
+      chalk10__default.default.bold.green(`${state.verdict.icon} ${state.verdict.label}`)
     );
     if (state.verdict.reason) {
       for (const segment of wrapAnsi4__default.default(state.verdict.reason, bodyTextWidth, {
@@ -9046,12 +9140,12 @@ function buildFrameLines(state, frameIndex) {
   }
   const pad = (line) => {
     const padding = " ".repeat(Math.max(0, innerWidth - displayWidth(line)));
-    return `${chalk9__default.default.cyan("\u2502")} ${line}${padding} ${chalk9__default.default.cyan("\u2502")}`;
+    return `${chalk10__default.default.cyan("\u2502")} ${line}${padding} ${chalk10__default.default.cyan("\u2502")}`;
   };
   return [
-    chalk9__default.default.cyan(`\u256D${"\u2500".repeat(bodyWidth)}\u256E`),
+    chalk10__default.default.cyan(`\u256D${"\u2500".repeat(bodyWidth)}\u256E`),
     ...content.map(pad),
-    chalk9__default.default.cyan(`\u2570${"\u2500".repeat(bodyWidth)}\u256F`)
+    chalk10__default.default.cyan(`\u2570${"\u2500".repeat(bodyWidth)}\u256F`)
   ];
 }
 function createApprovalProgressRenderer({
@@ -9251,6 +9345,7 @@ var EXIT_GRACE_PERIOD_MILLISECONDS = 500;
 var program = new commander.Command();
 var versionOption = getReservedCliOption("version" /* Version */);
 var helpOption = getReservedCliOption("help" /* Help */);
+var stabilityOption = getReservedCliOption("stability" /* Stability */);
 program.name("zapier-sdk").description("CLI for Zapier SDK").version(
   package_default2.version,
   `${versionOption.short}, ${versionOption.flag}`,
@@ -9279,7 +9374,10 @@ program.name("zapier-sdk").description("CLI for Zapier SDK").version(
 ).option(
   "--causation-id <id>",
   "Causation ID emitted as the zapier-causation-id header on every outbound request. Falls back to ZAPIER_CAUSATION_ID."
-).option("--experimental", "Use the experimental SDK / CLI surface");
+).option(stabilityOption.flag, stabilityOption.description).option(
+  "--experimental",
+  "Deprecated. Use --stability experimental instead."
+);
 var booleanFlags = [];
 for (const [key, fieldSchema] of Object.entries(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -9365,8 +9463,57 @@ 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;
+function parseStabilityLevel(value, source) {
+  if (value === void 0) return void 0;
+  if (zapierSdk.STABILITY_LEVELS.includes(value)) {
+    return value;
+  }
+  console.error(
+    `Invalid ${source} value "${value}". Valid stability levels: ${zapierSdk.STABILITY_LEVELS.join(", ")}.`
+  );
+  process.exit(1);
+}
+function warnDeprecatedOptIn(used, replacement) {
+  warningBlock({
+    banner: DEPRECATION_BANNER,
+    message: ` - \`${used}\` is deprecated.`,
+    detail: `Use \`${replacement}\` instead.`
+  });
+}
+function resolveCliStability() {
+  const flagLevel = parseStabilityLevel(
+    getFlagValue("--stability"),
+    "--stability"
+  );
+  if (flagLevel) return flagLevel;
+  if (process.argv.includes("--experimental")) {
+    if (process.env[EXPERIMENTAL_BIN_ENV] === "1") {
+      warnDeprecatedOptIn(
+        "zapier-sdk-experimental",
+        "zapier-sdk --stability experimental"
+      );
+    } else {
+      warnDeprecatedOptIn("--experimental", "--stability experimental");
+    }
+    return "experimental";
+  }
+  const envLevel = parseStabilityLevel(
+    process.env.ZAPIER_STABILITY || void 0,
+    "ZAPIER_STABILITY"
+  );
+  if (envLevel) return envLevel;
+  if (process.env.ZAPIER_EXPERIMENTAL === "1" || process.env.ZAPIER_EXPERIMENTAL === "true") {
+    warnDeprecatedOptIn("ZAPIER_EXPERIMENTAL", "ZAPIER_STABILITY=experimental");
+    return "experimental";
+  }
+  return "stable";
+}
+var cliStability = resolveCliStability();
+var createZapierCliSdk4 = {
+  stable: createZapierCliSdk,
+  beta: createZapierCliSdk2,
+  experimental: createZapierCliSdk3
+}[cliStability];
 var approvalProgress = createApprovalProgressRenderer({
   enabled: process.stderr.isTTY === true
 });
@@ -9374,7 +9521,7 @@ program.exitOverride();
 (async () => {
   let exitCode = 0;
   const extensions = await resolveExtensions();
-  const sdk = createZapierCliSdk3({
+  const sdk = createZapierCliSdk4({
     debug: isDebugMode,
     credentials,
     baseUrl,