@zapier/zapier-sdk-cli 0.84.6 → 0.85.0

package/dist/cli.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { Command, CommanderError, Option, InvalidArgumentError } from 'commander';
-import { getConnectionPlugin, definePlugin, apiPlugin, defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineOverride, fetchPlugin, zapierCoreOptions, injectCliLogin, 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, formatExtensionPluginFailure as formatExtensionPluginFailure$1, resolvePlugin, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, getRegistry, getCoreErrorCode, CoreErrorCode, buildApplicationLifecycleEvent, AuthMechanism, DEPRECATION_NOTICE_EVENT, runWithCallerContext, isCoreCancelledSignal, getNegatable, isPositional, isZapierError, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent as getAgent$1, getTtyContext, getCiPlatform, isCi, isZapierConflictError, getReleaseId, getCurrentTimestamp, generateEventId, isZapierApprovalError, ZapierAuthenticationError } from '@zapier/zapier-sdk';
+import { STABILITY_LEVELS, getConnectionPlugin, definePlugin, apiPlugin, defineMethod, apiPluginRef, resolveCredentialsPluginRef, eventEmissionPluginRef, sdkOptionsPluginRef, declareOptionalProperty, OutputPropertySchema, ZapierBundleError, isZapierBundleError, DEFAULT_CONFIG_PATH, declareMethod, ZapierValidationError, isZapierValidationError, ZapierUnknownError, manifestPluginRef, defineResolver, isPermanentHttpError, isZapierAuthenticationError, ZapierApiError, defineOverride, fetchPlugin, zapierCoreOptions, injectCliLogin, omitExports, zapierSdkPlugin, BaseSdkOptionsSchema, disposeSdk, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, createSdk as createSdk$2, CORE_OPTIONS_ID as CORE_OPTIONS_ID$2, SDK_OPTIONS_ID as SDK_OPTIONS_ID$2, addPlugin as addPlugin$2, formatExtensionPluginFailure as formatExtensionPluginFailure$2, resolvePlugin, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, STABILITY_DEFINITIONS, getRegistry, getCoreErrorCode, CoreErrorCode, applyStabilityLabel, buildApplicationLifecycleEvent, AuthMechanism, DEPRECATION_NOTICE_EVENT, runWithCallerContext, isCoreCancelledSignal, getNegatable, isPositional, isZapierError, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent as getAgent$1, getTtyContext, getCiPlatform, isCi, isZapierConflictError, getReleaseId, getCurrentTimestamp, generateEventId, isZapierApprovalError, ZapierAuthenticationError } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 import inquirer from 'inquirer';
-import chalk9 from 'chalk';
+import chalk10 from 'chalk';
 import { makeTheme, createPrompt, useState, usePrefix, useMemo, useEffect, useKeypress, isEnterKey, isTabKey, isUpKey, isDownKey, usePagination, Separator } from '@inquirer/core';
 import ora from 'ora';
 import * as fs from 'fs';
@@ -34,7 +34,8 @@ import packageJsonLib, { VersionNotFoundError } from 'package-json';
 import semver from 'semver';
 import crossSpawn from 'cross-spawn';
 import Table from 'cli-table3';
-import { triggerInboxResolver, DrainTriggerInboxSchema, WatchTriggerInboxSchema, declareMethod as declareMethod$1, defineMethod as defineMethod$1, CreateWorkflowResponseSchema, getAgent, injectCliLogin as injectCliLogin$1, INTERNAL_CREATE_WORKFLOW_FIELDS, CreateWorkflowOptionsSchema, definePlugin as definePlugin$1, omitExports as omitExports$1, zapierExperimentalSdkPlugin, createSdk, CORE_OPTIONS_ID, SDK_OPTIONS_ID, addPlugin, formatExtensionPluginFailure } from '@zapier/zapier-sdk/experimental';
+import { triggerInboxResolver, DrainTriggerInboxSchema, WatchTriggerInboxSchema, declareMethod as declareMethod$1, defineMethod as defineMethod$1, CreateWorkflowResponseSchema, getAgent, injectCliLogin as injectCliLogin$2, INTERNAL_CREATE_WORKFLOW_FIELDS, CreateWorkflowOptionsSchema, definePlugin as definePlugin$1, omitExports as omitExports$1, zapierExperimentalSdkPlugin, createSdk, CORE_OPTIONS_ID, SDK_OPTIONS_ID, addPlugin, formatExtensionPluginFailure } from '@zapier/zapier-sdk/experimental';
+import { injectCliLogin as injectCliLogin$1, definePlugin as definePlugin$2, omitExports as omitExports$2, zapierBetaSdkPlugin, createSdk as createSdk$1, CORE_OPTIONS_ID as CORE_OPTIONS_ID$1, SDK_OPTIONS_ID as SDK_OPTIONS_ID$1, addPlugin as addPlugin$1, formatExtensionPluginFailure as formatExtensionPluginFailure$1 } from '@zapier/zapier-sdk/beta';
 import * as readline from 'readline';
 
 var __defProp = Object.defineProperty;
@@ -60,9 +61,9 @@ function normalizeChoices(choices) {
 var theme = makeTheme({
   icon: { cursor: "\u276F" },
   style: {
-    disabled: (text) => chalk9.dim(`- ${text}`),
-    searchTerm: (text) => chalk9.cyan(text),
-    keysHelpTip: (keys) => keys.map(([key, action]) => `${chalk9.bold(key)} ${chalk9.dim(action)}`).join(chalk9.dim(" \u2022 "))
+    disabled: (text) => chalk10.dim(`- ${text}`),
+    searchTerm: (text) => chalk10.cyan(text),
+    keysHelpTip: (keys) => keys.map(([key, action]) => `${chalk10.bold(key)} ${chalk10.dim(action)}`).join(chalk10.dim(" \u2022 "))
   }
 });
 var searchSelect = createPrompt(
@@ -205,10 +206,10 @@ async function promptText({
   ]);
   return value;
 }
-var display = (c) => c.hint ? `${c.label} ${chalk9.dim(`(${c.hint})`)}` : c.label;
+var display = (c) => c.hint ? `${c.label} ${chalk10.dim(`(${c.hint})`)}` : c.label;
 var HIGH_CONTRAST_PROMPT_THEME = {
   style: {
-    answer: (text) => chalk9.inverse.bold(` ${text} `)
+    answer: (text) => chalk10.inverse.bold(` ${text} `)
   }
 };
 function buildSelectRows(question, term) {
@@ -224,8 +225,8 @@ function buildSelectRows(question, term) {
     name: display(c),
     value: c.value
   }));
-  const skipRow = offers(question, "skip") ? [row(chalk9.dim("Skip (optional)"), "skip")] : [];
-  const customRow = offers(question, "custom") ? [row(chalk9.dim("Enter a value manually\u2026"), "custom")] : [];
+  const skipRow = offers(question, "skip") ? [row(chalk10.dim("Skip (optional)"), "skip")] : [];
+  const customRow = offers(question, "custom") ? [row(chalk10.dim("Enter a value manually\u2026"), "custom")] : [];
   const committed = !!t || question.search !== void 0;
   let rows;
   if (!committed) {
@@ -236,13 +237,13 @@ function buildSelectRows(question, term) {
     rows = [...customRow, ...skipRow];
   }
   if (offers(question, "search"))
-    rows.push(row(chalk9.cyan("Search again\u2026"), "search"));
+    rows.push(row(chalk10.cyan("Search again\u2026"), "search"));
   if (offers(question, "next_page"))
-    rows.push(row(chalk9.dim("Load more\u2026"), "next_page"));
-  if (offers(question, "retry")) rows.push(row(chalk9.yellow("Retry"), "retry"));
-  if (offers(question, "cancel")) rows.push(row(chalk9.dim("Cancel"), "cancel"));
+    rows.push(row(chalk10.dim("Load more\u2026"), "next_page"));
+  if (offers(question, "retry")) rows.push(row(chalk10.yellow("Retry"), "retry"));
+  if (offers(question, "cancel")) rows.push(row(chalk10.dim("Cancel"), "cancel"));
   for (const note of question.notes ?? [])
-    rows.push({ name: chalk9.dim(note), value: note, disabled: true });
+    rows.push({ name: chalk10.dim(note), value: note, disabled: true });
   return rows;
 }
 function foldPage(acc, question, field) {
@@ -322,12 +323,12 @@ async function answerSelect(question, field, box, failed, mode) {
       })),
       ...offers(question, "next_page") ? [
         {
-          name: chalk9.dim("Load more\u2026"),
+          name: chalk10.dim("Load more\u2026"),
           value: { action: "next_page" }
         }
       ] : [],
       ...(question.notes ?? []).map((note) => ({
-        name: chalk9.dim(note),
+        name: chalk10.dim(note),
         value: note,
         disabled: true
       }))
@@ -404,14 +405,14 @@ async function answerSelect(question, field, box, failed, mode) {
     case "retry":
       return { type: "retry" };
     case "skip":
-      printAnswered(view.message, chalk9.dim("(skipped)"));
+      printAnswered(view.message, chalk10.dim("(skipped)"));
       return { type: "skip" };
     case "cancel":
       return { type: "cancel" };
   }
 }
 function printAnswered(message, label) {
-  console.log(`${chalk9.green("\u2714")} ${message} ${chalk9.cyan(label)}`);
+  console.log(`${chalk10.green("\u2714")} ${message} ${chalk10.cyan(label)}`);
 }
 async function answerInput(question) {
   const message = question.placeholder ? question.message.replace(/:?\s*$/, ` (${question.placeholder}):`) : question.message;
@@ -458,7 +459,7 @@ function createCliAnswer({
     try {
       if (result.error !== void 0) {
         const message = typeof result.error === "string" ? result.error : result.error.message;
-        console.log(chalk9.yellow(`! ${message}`));
+        console.log(chalk10.yellow(`! ${message}`));
       }
       const question = result.question;
       const field = question.path.length ? question.path.join(".") : "value";
@@ -527,8 +528,6 @@ var ZapierCliMissingParametersError = class extends ZapierCliError {
     this.params = params;
   }
 };
-
-// src/utils/cli-options.ts
 var RESERVED_CLI_OPTIONS = [
   {
     name: "version" /* Version */,
@@ -541,6 +540,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: ${STABILITY_LEVELS.join(", ")}. Can also be set with the ZAPIER_STABILITY environment variable (default: stable).`
   }
 ];
 function getReservedCliOption(name) {
@@ -558,7 +562,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"],
@@ -723,7 +727,7 @@ async function formatItemsFromSchema(_functionInfo, items, startingNumber = 0, o
   formatItemsGeneric(items, startingNumber);
 }
 function formatSingleItem(formatted, itemNumber) {
-  let titleLine = `${chalk9.gray(`${itemNumber + 1}.`)} ${chalk9.cyan(formatted.title)}`;
+  let titleLine = `${chalk10.gray(`${itemNumber + 1}.`)} ${chalk10.cyan(formatted.title)}`;
   const subtitleParts = [];
   if (formatted.hint !== void 0) {
     subtitleParts.push(
@@ -741,11 +745,11 @@ function formatSingleItem(formatted, itemNumber) {
   }
   const uniqueParts = [...new Set(subtitleParts)];
   if (uniqueParts.length > 0) {
-    titleLine += ` ${chalk9.gray(`(${uniqueParts.join(", ")})`)}`;
+    titleLine += ` ${chalk10.gray(`(${uniqueParts.join(", ")})`)}`;
   }
   console.log(titleLine);
   if (formatted.description) {
-    console.log(`   ${chalk9.dim(formatted.description)}`);
+    console.log(`   ${chalk10.dim(formatted.description)}`);
   }
   if (formatted.raw !== void 0) {
     formatJsonOutput(formatted.raw);
@@ -756,7 +760,7 @@ function formatSingleItem(formatted, itemNumber) {
     if (detail.label) {
       const isMultiline = detail.text.includes("\n");
       if (isMultiline) {
-        console.log(`   ${chalk9.gray(detail.label + ":")}`);
+        console.log(`   ${chalk10.gray(detail.label + ":")}`);
         const displayText = formatDetailText(
           detail.text,
           DETAIL_INDENT + "   "
@@ -765,7 +769,7 @@ function formatSingleItem(formatted, itemNumber) {
         console.log(`${DETAIL_INDENT}   ${styledText}`);
       } else {
         const styledValue = applyStyle(detail.text, detail.style);
-        console.log(`   ${chalk9.gray(detail.label + ":")} ${styledValue}`);
+        console.log(`   ${chalk10.gray(detail.label + ":")} ${styledValue}`);
       }
     } else {
       const displayText = formatDetailText(detail.text, DETAIL_INDENT);
@@ -789,16 +793,16 @@ function formatDetailText(text, indent = DETAIL_INDENT) {
 function applyStyle(value, style) {
   switch (style) {
     case "dim":
-      return chalk9.dim(value);
+      return chalk10.dim(value);
     case "accent":
-      return chalk9.magenta(value);
+      return chalk10.magenta(value);
     case "warning":
-      return chalk9.red(value);
+      return chalk10.red(value);
     case "success":
-      return chalk9.green(value);
+      return chalk10.green(value);
     case "normal":
     default:
-      return chalk9.blue(value);
+      return chalk10.blue(value);
   }
 }
 function convertGenericItemToFormattedItem(item) {
@@ -947,10 +951,10 @@ function createInteractiveRenderer(context = {}) {
         const obj = item;
         const name = obj?.name || obj?.key || obj?.id || "Item";
         console.log(
-          `${chalk9.gray(`${startingNumber + index + 1}.`)} ${chalk9.cyan(String(name))}`
+          `${chalk10.gray(`${startingNumber + index + 1}.`)} ${chalk10.cyan(String(name))}`
         );
         if (obj?.description)
-          console.log(`   ${chalk9.dim(String(obj.description))}`);
+          console.log(`   ${chalk10.dim(String(obj.description))}`);
         console.log();
       });
     }
@@ -961,35 +965,35 @@ function createInteractiveRenderer(context = {}) {
       if (!(Symbol.asyncIterator in Object(source))) {
         const items = source?.data;
         if (!Array.isArray(items) || items.length === 0) {
-          console.log(chalk9.yellow(`No ${itemName} found.`));
+          console.log(chalk10.yellow(`No ${itemName} found.`));
           return;
         }
         await renderItemsForDisplay(items, functionInfo, 0);
-        console.log(chalk9.green(`
+        console.log(chalk10.green(`
 \u2705 Showing ${items.length} ${itemName}`));
         return;
       }
       let totalShown = 0;
       let pageCount = 0;
-      console.log(chalk9.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
+      console.log(chalk10.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.yellow(`No ${itemName} found.`));
+          console.log(chalk10.yellow(`No ${itemName} found.`));
           return;
         }
         if (items.length === 0) break;
         if (pageCount > 1) {
           console.clear();
-          console.log(chalk9.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
+          console.log(chalk10.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
 `));
         }
         await renderItemsForDisplay(items, functionInfo, totalShown);
         totalShown += items.length;
         console.log(
-          chalk9.green(
+          chalk10.green(
             `
 \u2705 Showing ${totalShown} ${itemName} (page ${pageCount})`
           )
@@ -1008,7 +1012,7 @@ function createInteractiveRenderer(context = {}) {
           break;
         }
       }
-      console.log(chalk9.gray(`
+      console.log(chalk10.gray(`
 \u{1F4C4} Finished browsing ${itemName}`));
     },
     async renderCollectedList(items, { maxItems, userSpecifiedMaxItems, functionInfo } = {}) {
@@ -1018,30 +1022,30 @@ function createInteractiveRenderer(context = {}) {
       }
       const itemName = getItemName(functionInfo);
       if (items.length === 0) {
-        console.log(chalk9.yellow(`No ${itemName} found.`));
+        console.log(chalk10.yellow(`No ${itemName} found.`));
         return;
       }
-      console.log(chalk9.green(`
+      console.log(chalk10.green(`
 \u2705 Found ${items.length} ${itemName}:
 `));
       await renderItemsForDisplay(items, functionInfo);
       if (userSpecifiedMaxItems && maxItems) {
         console.log(
-          chalk9.gray(
+          chalk10.gray(
             `
 \u{1F4C4} Showing up to ${maxItems} ${itemName} (--max-items ${maxItems})`
           )
         );
       } else {
-        console.log(chalk9.gray(`
+        console.log(chalk10.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.green(label));
-        console.log(chalk9.gray(`Output written to: ${options.outputFile}`));
+        console.log(chalk10.green(label));
+        console.log(chalk10.gray(`Output written to: ${options.outputFile}`));
       } else {
         formatJsonOutput(value);
       }
@@ -1051,17 +1055,17 @@ function createInteractiveRenderer(context = {}) {
     },
     renderError(error) {
       if (error instanceof ZapierCliMissingParametersError) {
-        console.error(chalk9.red("\u274C " + formatMissingParamsError(error)));
-        console.error("\n" + chalk9.dim("Use --help to see available options"));
+        console.error(chalk10.red("\u274C " + formatMissingParamsError(error)));
+        console.error("\n" + chalk10.dim("Use --help to see available options"));
         throw new ZapierCliExitError(error.message, 1);
       }
       if (isZapierError(error)) {
         const formattedMessage = formatErrorMessage(error);
-        console.error(chalk9.red("\u274C Error:"), formattedMessage);
+        console.error(chalk10.red("\u274C Error:"), formattedMessage);
         throw new ZapierCliExitError(formattedMessage, 1);
       }
       const msg = error instanceof Error ? error.message : "Unknown error";
-      console.error(chalk9.red("\u274C Error:"), msg);
+      console.error(chalk10.red("\u274C Error:"), msg);
       throw new ZapierCliExitError(msg, 1);
     }
   };
@@ -1104,6 +1108,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.yellow.bold(banner) + chalk10.yellow(message));
+  if (detail) console.warn(chalk10.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 }) {
@@ -1177,7 +1192,7 @@ async function promptConfirm(confirmType, itemType) {
   }
   const configOrFn = CONFIRM_MESSAGES[confirmType];
   const { messageBefore, messageAfter } = typeof configOrFn === "function" ? configOrFn(itemType) : configOrFn;
-  console.log(chalk9.yellow(`
+  console.log(chalk10.yellow(`
 ${messageBefore}
 `));
   const { confirmed } = await inquirer.prompt([
@@ -1199,16 +1214,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.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9.yellow(
-        ` - \`${toKebabCase(param.name)}\` is deprecated and may be removed in a future release.`
-      )
-    );
-    if (param.deprecationMessage) {
-      console.warn(chalk9.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({
@@ -1423,6 +1433,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}`);
@@ -1457,6 +1473,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 = 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(
@@ -1470,7 +1495,7 @@ function generateCliCommands(program2, sdk) {
   ${category.titlePlural}:
 `;
             categoryCommands.forEach((command) => {
-              output += `    ${helper.subcommandTerm(command)}
+              output += `    ${labeledSubcommandTerm(command)}
 `;
               categorizedCommands.add(command.name());
             });
@@ -1484,7 +1509,7 @@ function generateCliCommands(program2, sdk) {
   Other:
 `;
           otherCommands.forEach((command) => {
-            output += `    ${helper.subcommandTerm(command)}
+            output += `    ${labeledSubcommandTerm(command)}
 `;
           });
         }
@@ -1509,7 +1534,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
     }
   }
   const baseDescription = functionInfo.description || schema?.description || `${cliCommandName} command`;
-  const description = functionInfo.experimental ? `${baseDescription} (experimental)` : baseDescription;
+  const description = applyStabilityLabel({
+    description: baseDescription,
+    stability: functionInfo.stability
+  });
   const handler = async (...args) => {
     const startTime = Date.now();
     let success = true;
@@ -1605,7 +1633,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
           functionInfo.itemType
         );
         if (!confirmResult.confirmed) {
-          console.log(chalk9.yellow("Operation cancelled."));
+          console.log(chalk10.yellow("Operation cancelled."));
           return;
         }
         confirmMessageAfter = confirmResult.messageAfter;
@@ -1666,7 +1694,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
             renderer.renderItem(normalizedResult.value);
           }
           if (confirmMessageAfter) {
-            console.log(chalk9.yellow(`
+            console.log(chalk10.yellow(`
 ${confirmMessageAfter}`));
           }
           break;
@@ -3085,14 +3113,14 @@ function formatCredentialsChoice({
   credentials: credentials2,
   current
 }) {
-  const currentLabel = current ? chalk9.cyan(" (current)") : "";
+  const currentLabel = current ? chalk10.cyan(" (current)") : "";
   const details = [
     credentials2.clientId,
     credentials2.scopes.join(", "),
     `created ${createdAtIso(credentials2).slice(0, 10)}`
   ].join(" \xB7 ");
   return {
-    name: `${credentials2.name}${currentLabel} ${chalk9.dim(`\xB7 ${details}`)}`,
+    name: `${credentials2.name}${currentLabel} ${chalk10.dim(`\xB7 ${details}`)}`,
     short: credentials2.name,
     value: { action: "switch", credentials: credentials2 }
   };
@@ -3268,20 +3296,20 @@ var getCallablePromise = () => {
 var getCallablePromise_default = getCallablePromise;
 var log = {
   info: (message, ...args) => {
-    console.error(chalk9.blue("\u2139"), message, ...args);
+    console.error(chalk10.blue("\u2139"), message, ...args);
   },
   error: (message, ...args) => {
-    console.error(chalk9.red("\u2716"), message, ...args);
+    console.error(chalk10.red("\u2716"), message, ...args);
   },
   success: (message, ...args) => {
-    console.error(chalk9.green("\u2713"), message, ...args);
+    console.error(chalk10.green("\u2713"), message, ...args);
   },
   warn: (message, ...args) => {
-    console.error(chalk9.yellow("\u26A0"), message, ...args);
+    console.error(chalk10.yellow("\u26A0"), message, ...args);
   },
   debug: (message, ...args) => {
     if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
-      console.error(chalk9.gray("\u{1F41B}"), message, ...args);
+      console.error(chalk10.gray("\u{1F41B}"), message, ...args);
     }
   }
 };
@@ -4439,9 +4467,9 @@ async function provisionAccountCredentials({
   isNonInteractive,
   isHeadless
 }) {
-  const scopedSdk = createSdk$1(accountCredentialsApiPlugin, {
+  const scopedSdk = createSdk$2(accountCredentialsApiPlugin, {
     configuration: {
-      [SDK_OPTIONS_ID$1]: {
+      [SDK_OPTIONS_ID$2]: {
         credentials: accessToken,
         baseUrl: credentialsBaseUrl2,
         callerPackage: imports.sdkOptions?.callerPackage,
@@ -4793,9 +4821,10 @@ var CLI_EXTENSIONS_ID = "cli/extensions";
 var cliExtensionsPluginRef = declareOptionalProperty({
   id: CLI_EXTENSIONS_ID
 });
-var CLI_EXPERIMENTAL_ID = "cli/experimental";
-var cliExperimentalPluginRef = declareOptionalProperty({
-  id: CLI_EXPERIMENTAL_ID
+var EXPERIMENTAL_BIN_ENV = "ZAPIER_SDK_EXPERIMENTAL_BIN";
+var CLI_STABILITY_ID = "cli/stability";
+var cliStabilityPluginRef = declareOptionalProperty({
+  id: CLI_STABILITY_ID
 });
 var McpSchema = z.object({
   port: z.string().optional().describe("Port to listen on (for future HTTP transport)")
@@ -4804,11 +4833,7 @@ var McpSchema = z.object({
 // src/plugins/mcp/index.ts
 var mcpPlugin = defineMethod({
   name: "mcp",
-  imports: [
-    sdkOptionsPluginRef,
-    cliExtensionsPluginRef,
-    cliExperimentalPluginRef
-  ],
+  imports: [sdkOptionsPluginRef, cliExtensionsPluginRef, cliStabilityPluginRef],
   output: "raw",
   inputSchema: McpSchema,
   categories: ["utility"],
@@ -4818,7 +4843,7 @@ var mcpPlugin = defineMethod({
       debug: imports.sdkOptions?.debug,
       maxConcurrentRequests: imports.sdkOptions?.maxConcurrentRequests,
       extensions: imports.extensions,
-      experimental: imports.experimental
+      stability: imports.stability
     });
   }
 });
@@ -6449,7 +6474,7 @@ function buildTemplateVariables({
   };
 }
 function cleanupProject({ projectDir }) {
-  console.log("\n" + chalk9.yellow("!") + "  Cleaning up...");
+  console.log("\n" + chalk10.yellow("!") + "  Cleaning up...");
   rmSync(projectDir, { recursive: true, force: true });
 }
 async function withInterruptCleanup(cleanup, fn) {
@@ -6659,8 +6684,8 @@ function buildNextSteps({
 }
 function createConsoleDisplayHooks() {
   return {
-    onItemComplete: (message) => console.log("   " + chalk9.green("\u2713") + "  " + chalk9.dim(message)),
-    onWarn: (message) => console.warn(chalk9.yellow("!") + "  " + message),
+    onItemComplete: (message) => console.log("   " + chalk10.green("\u2713") + "  " + chalk10.dim(message)),
+    onWarn: (message) => console.warn(chalk10.yellow("!") + "  " + message),
     onStepStart: ({
       description,
       stepNumber,
@@ -6669,31 +6694,31 @@ function createConsoleDisplayHooks() {
       nonInteractive
     }) => {
       const progressMessage = `${description}...`;
-      const stepCounter = chalk9.dim(`${stepNumber}/${totalSteps}`);
+      const stepCounter = chalk10.dim(`${stepNumber}/${totalSteps}`);
       if (nonInteractive) {
         console.log(
-          "\n" + chalk9.bold(`\u276F  ${progressMessage}`) + "  " + stepCounter + "\n"
+          "\n" + chalk10.bold(`\u276F  ${progressMessage}`) + "  " + stepCounter + "\n"
         );
       } else {
         console.log(
-          chalk9.dim("\u2192") + "  " + progressMessage + "  " + stepCounter
+          chalk10.dim("\u2192") + "  " + progressMessage + "  " + stepCounter
         );
       }
       if (command) {
-        console.log("   " + chalk9.cyan(`$ ${command}`));
+        console.log("   " + chalk10.cyan(`$ ${command}`));
       }
     },
     onStepSuccess: ({ stepNumber, totalSteps }) => console.log(
-      "\n" + chalk9.green("\u2713") + "  " + chalk9.dim(`Step ${stepNumber}/${totalSteps} complete`) + "\n"
+      "\n" + chalk10.green("\u2713") + "  " + chalk10.dim(`Step ${stepNumber}/${totalSteps} complete`) + "\n"
     ),
     onStepError: ({ description, command, err }) => {
       const detail = err instanceof Error && err.message ? `
-   ${chalk9.dim(err.message)}` : "";
+   ${chalk10.dim(err.message)}` : "";
       const hint = command ? `
-   ${chalk9.dim("run manually:")} ${chalk9.cyan(`$ ${command}`)}` : "";
+   ${chalk10.dim("run manually:")} ${chalk10.cyan(`$ ${command}`)}` : "";
       console.error(
         `
-${chalk9.red("\u2716")}  ${chalk9.bold(description)}${chalk9.dim(" failed")}${detail}${hint}`
+${chalk10.red("\u2716")}  ${chalk10.bold(description)}${chalk10.dim(" failed")}${detail}${hint}`
       );
     }
   };
@@ -6705,22 +6730,22 @@ function displaySummaryAndNextSteps({
   packageManager
 }) {
   const formatStatus = (complete) => ({
-    icon: complete ? chalk9.green("\u2713") : chalk9.yellow("!"),
-    text: complete ? chalk9.green("Setup complete") : chalk9.yellow("Setup interrupted")
+    icon: complete ? chalk10.green("\u2713") : chalk10.yellow("!"),
+    text: complete ? chalk10.green("Setup complete") : chalk10.yellow("Setup interrupted")
   });
-  const formatNextStep = (step, i) => "   " + chalk9.dim(`${i + 1}.`) + "  " + chalk9.bold(step.description);
-  const formatCommand = (cmd) => "       " + chalk9.cyan(`$ ${cmd}`);
-  const formatCompletedStep = (step) => "   " + chalk9.green("\u2713") + "  " + step.description;
+  const formatNextStep = (step, i) => "   " + chalk10.dim(`${i + 1}.`) + "  " + chalk10.bold(step.description);
+  const formatCommand = (cmd) => "       " + chalk10.cyan(`$ ${cmd}`);
+  const formatCompletedStep = (step) => "   " + chalk10.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.bold("\u276F  Summary") + "\n");
-  console.log("   " + chalk9.dim("Project") + "   " + chalk9.bold(projectName));
+  console.log("\n" + chalk10.bold("\u276F  Summary") + "\n");
+  console.log("   " + chalk10.dim("Project") + "   " + chalk10.bold(projectName));
   console.log(
-    "   " + chalk9.dim("Status") + "    " + status.icon + "  " + status.text
+    "   " + chalk10.dim("Status") + "    " + status.icon + "  " + status.text
   );
   const completedSteps = steps.filter(
     (s) => completedSetupStepIds.includes(s.id)
@@ -6730,7 +6755,7 @@ function displaySummaryAndNextSteps({
     for (const step of completedSteps) console.log(formatCompletedStep(step));
   }
   const nextSteps = buildNextSteps({ projectName, leftoverSteps, execCmd });
-  console.log("\n" + chalk9.bold("\u276F  Next Steps") + "\n");
+  console.log("\n" + chalk10.bold("\u276F  Next Steps") + "\n");
   nextSteps.forEach((step, i) => {
     console.log(formatNextStep(step, i));
     if (step.command) console.log(formatCommand(step.command));
@@ -6915,26 +6940,26 @@ function displayUpdateNotification(versionInfo, packageName) {
   if (versionInfo.isDeprecated) {
     console.error();
     console.error(
-      chalk9.red.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9.red(
+      chalk10.red.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk10.red(
         ` - ${packageName} v${versionInfo.currentVersion} is deprecated.`
       )
     );
     if (versionInfo.deprecationMessage) {
-      console.error(chalk9.red(`   ${versionInfo.deprecationMessage}`));
+      console.error(chalk10.red(`   ${versionInfo.deprecationMessage}`));
     }
-    console.error(chalk9.red(`   Please update to the latest version.`));
+    console.error(chalk10.red(`   Please update to the latest version.`));
     console.error();
   }
   if (versionInfo.hasUpdate) {
     console.error();
     console.error(
-      chalk9.yellow.bold("\u{1F4E6} Update available!") + chalk9.yellow(
+      chalk10.yellow.bold("\u{1F4E6} Update available!") + chalk10.yellow(
         ` ${packageName} v${versionInfo.currentVersion} \u2192 v${versionInfo.latestVersion}`
       )
     );
     console.error(
-      chalk9.yellow(
-        `   Run ${chalk9.bold(getUpdateCommand(packageName))} to update.`
+      chalk10.yellow(
+        `   Run ${chalk10.bold(getUpdateCommand(packageName))} to update.`
       )
     );
     console.error();
@@ -6975,7 +7000,7 @@ var boltFillRanks = new Map(
 );
 var STATUS_ROW_INDEX = Math.floor(boltRows.length / 2);
 function formatPhase({ label, detail }) {
-  return detail ? `${chalk9.bold(label)}  ${chalk9.dim(detail)}` : chalk9.bold(label);
+  return detail ? `${chalk10.bold(label)}  ${chalk10.dim(detail)}` : chalk10.bold(label);
 }
 function formatLoaderFrame({
   phase,
@@ -6987,7 +7012,7 @@ function formatLoaderFrame({
       const cellIndex = rowIndex * row.length + columnIndex;
       const fillRank = boltFillRanks.get(cellIndex);
       const isFilled = fillRank !== void 0 && fillRank < fillStage;
-      return isFilled ? chalk9.bold.yellow(cell) : chalk9.dim.yellow(cell);
+      return isFilled ? chalk10.bold.yellow(cell) : chalk10.dim.yellow(cell);
     }).join("");
     const status = rowIndex === STATUS_ROW_INDEX ? `   ${formatPhase(phase)}` : "";
     return `${bolt}${status}`;
@@ -7019,12 +7044,12 @@ async function runWithSetupLoader({
     const result = await promise;
     clearInterval(animationTimer);
     const elapsedSeconds = ((Date.now() - startedAt) / 1e3).toFixed(1);
-    loader.succeed(`${formatPhase(phase)}  ${chalk9.dim(`${elapsedSeconds}s`)}`);
+    loader.succeed(`${formatPhase(phase)}  ${chalk10.dim(`${elapsedSeconds}s`)}`);
     return result;
   } catch (error) {
     clearInterval(animationTimer);
     const elapsedSeconds = ((Date.now() - startedAt) / 1e3).toFixed(1);
-    loader.fail(`${formatPhase(phase)}  ${chalk9.dim(`${elapsedSeconds}s`)}`);
+    loader.fail(`${formatPhase(phase)}  ${chalk10.dim(`${elapsedSeconds}s`)}`);
     throw error;
   }
 }
@@ -7090,7 +7115,7 @@ var resolveSetupInputPlugin = defineMethod({
   run: ({ input }) => input
 });
 function createSetupController() {
-  const setupResolutionSdk = createSdk$1(
+  const setupResolutionSdk = createSdk$2(
     definePlugin({
       name: "setup-resolution",
       exports: [
@@ -7515,7 +7540,7 @@ async function runCommand({
         detail: commandLabel
       });
     }
-    console.log(chalk9.dim(commandLabel));
+    console.log(chalk10.dim(commandLabel));
     return await execute;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -7782,7 +7807,7 @@ function printAgentPrompt({
   message
 }) {
   console.log();
-  console.log(chalk9.bgYellow.black.bold(message));
+  console.log(chalk10.bgYellow.black.bold(message));
   console.log();
   console.log(buildAgentPrompt({ context }));
 }
@@ -8067,7 +8092,7 @@ var MINIMUM_MESSAGE_WIDTH = 20;
 var MAXIMUM_MESSAGE_WIDTH = 88;
 function showPhase({ number, title }) {
   console.log();
-  console.log(chalk9.bgCyan.black.bold(` ${number}/${PHASE_COUNT}  ${title} `));
+  console.log(chalk10.bgCyan.black.bold(` ${number}/${PHASE_COUNT}  ${title} `));
 }
 function printWrapped(text) {
   const width = Math.max(
@@ -8081,7 +8106,7 @@ function printWrapped(text) {
 }
 function showReadyMessage() {
   console.log();
-  console.log(chalk9.bgGreen.black.bold(" \u2713 Zapier SDK setup complete "));
+  console.log(chalk10.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."
@@ -8093,7 +8118,7 @@ function showReadyMessage() {
   console.log();
 }
 async function runWizard(context) {
-  console.log(chalk9.bold("Zapier SDK setup"));
+  console.log(chalk10.bold("Zapier SDK setup"));
   showPhase({ number: 1, title: "Project directory" });
   await chooseDirectory(context);
   showPhase({ number: 2, title: "Node.js" });
@@ -8108,7 +8133,7 @@ async function runWizard(context) {
   showPhase({ number: 6, title: "Slack demo" });
   await offerSlackTest(context);
   showReadyMessage();
-  console.log(chalk9.bgCyan.black.bold(" Next steps "));
+  console.log(chalk10.bgCyan.black.bold(" Next steps "));
   await openAgentHandoff(context);
 }
 
@@ -8157,13 +8182,13 @@ function createInteractiveCallback() {
     const attrs = message.message_attributes;
     console.log(
       `
-${chalk9.bold(`Message #${messageNumber}`)} ${chalk9.dim(message.id)} ${chalk9.dim(`(lease #${attrs.lease_count})`)}`
+${chalk10.bold(`Message #${messageNumber}`)} ${chalk10.dim(message.id)} ${chalk10.dim(`(lease #${attrs.lease_count})`)}`
     );
     if (attrs.error_message) {
-      console.log(chalk9.yellow(`  upstream error: ${attrs.error_message}`));
+      console.log(chalk10.yellow(`  upstream error: ${attrs.error_message}`));
     }
     if (attrs.possible_duplicate_data) {
-      console.log(chalk9.yellow("  possible duplicate data"));
+      console.log(chalk10.yellow("  possible duplicate data"));
     }
     while (true) {
       let action;
@@ -8193,7 +8218,7 @@ ${chalk9.bold(`Message #${messageNumber}`)} ${chalk9.dim(message.id)} ${chalk9.d
         throw error;
       }
       if (action === "view") {
-        console.log(chalk9.dim(JSON.stringify(message.payload, null, 2)));
+        console.log(chalk10.dim(JSON.stringify(message.payload, null, 2)));
         continue;
       }
       if (action === "ack") {
@@ -8296,7 +8321,7 @@ function describeReason(reason) {
 }
 function printDrainError(reason, message) {
   console.error(
-    chalk9.red(`Error processing ${message.id}: ${describeReason(reason)}`)
+    chalk10.red(`Error processing ${message.id}: ${describeReason(reason)}`)
   );
 }
 function printDrainSummary(counts) {
@@ -8306,7 +8331,7 @@ function printDrainSummary(counts) {
   if (skipped > 0) parts.push(`${skipped} skipped`);
   parts.push(`${counts.rejected} rejected`);
   console.log(
-    chalk9.dim(
+    chalk10.dim(
       `
 Processed ${total} message${total === 1 ? "" : "s"} (${parts.join(", ")}).`
     )
@@ -8314,7 +8339,7 @@ Processed ${total} message${total === 1 ? "" : "s"} (${parts.join(", ")}).`
 }
 function warnInteractiveContinueOnErrorOverride() {
   console.warn(
-    chalk9.yellow(
+    chalk10.yellow(
       'Note: continueOnError=false is overridden to true in interactive mode (the "Skip (let lease expire)" choice would otherwise terminate the drain).'
     )
   );
@@ -8640,7 +8665,7 @@ var createWorkflowCliPlugin = defineMethod$1({
   type: "create",
   itemType: "Workflow",
   categories: ["code-workflow"],
-  experimental: true,
+  stability: "experimental",
   inputSchema: CreateWorkflowCliOptionsSchema,
   outputSchema: CreateWorkflowResponseSchema,
   skipOutputValidation: true,
@@ -8672,7 +8697,7 @@ function renderDeprecationNotices() {
   console.error();
   for (const message of messages) {
     for (const line of buildBoxLines(message)) {
-      console.error(chalk9.red.bold(line));
+      console.error(chalk10.red.bold(line));
     }
     console.error();
   }
@@ -8693,21 +8718,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 = {
   ...zapierCoreOptions,
   logDeprecation: ({ methodName, deprecation }) => {
     if (warnedDeprecatedMethods.has(methodName)) return;
     warnedDeprecatedMethods.add(methodName);
-    console.warn();
-    console.warn(
-      chalk9.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk9.yellow(` - \`${toKebabCase(methodName)}\` is deprecated.`)
-    );
-    console.warn(chalk9.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: STABILITY_DEFINITIONS[stability]
+    });
   }
 };
 injectCliLogin(login_exports);
@@ -8753,15 +8790,72 @@ function createZapierCliSdk(options = {}) {
     // cannot be hidden by any rendering path.
     onEvent: (event) => collectDeprecationNoticeAndForward(event, sdkOptions.onEvent)
   };
-  const sdk = createSdk$1(cliSdkPlugin, {
+  const sdk = createSdk$2(cliSdkPlugin, {
     configuration: {
-      [SDK_OPTIONS_ID$1]: stackOptions,
-      [CORE_OPTIONS_ID$1]: cliCoreOptions,
+      [SDK_OPTIONS_ID$2]: stackOptions,
+      [CORE_OPTIONS_ID$2]: cliCoreOptions,
       // Resolved extensions, forwarded to `mcp` (imported by ref there) so
       // the MCP server's SDK matches the CLI surface.
       [CLI_EXTENSIONS_ID]: extensions
     }
   });
+  addPlugin$2(sdk, cliFetchOverride);
+  for (const ext of extensions) {
+    try {
+      addPlugin$2(sdk, ext);
+    } catch (err) {
+      console.warn(formatExtensionPluginFailure$2(err));
+    }
+  }
+  return sdk;
+}
+injectCliLogin$1(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 = definePlugin$2({
+    namespace: "zapier",
+    name: "cli-beta-sdk",
+    exports: [
+      omitExports$2(zapierBetaSdkPlugin, [
+        "drainTriggerInbox",
+        "watchTriggerInbox"
+      ]),
+      drainTriggerInboxCliPlugin,
+      watchTriggerInboxCliPlugin,
+      loginPlugin,
+      signupPlugin,
+      logoutPlugin,
+      mcpPlugin,
+      getLoginConfigPathPlugin,
+      initPlugin,
+      setupPlugin,
+      bundleCodePlugin,
+      feedbackPlugin,
+      curlPlugin,
+      addAppsPlugin,
+      buildManifestPlugin,
+      generateAppTypesPlugin
+    ]
+  });
+  const sdk = createSdk$1(cliBetaSdkPlugin, {
+    configuration: {
+      [SDK_OPTIONS_ID$1]: stackOptions,
+      [CORE_OPTIONS_ID$1]: 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"
+    }
+  });
   addPlugin$1(sdk, cliFetchOverride);
   for (const ext of extensions) {
     try {
@@ -8772,8 +8866,8 @@ function createZapierCliSdk(options = {}) {
   }
   return sdk;
 }
-injectCliLogin$1(login_exports);
-function createZapierCliSdk2(options = {}) {
+injectCliLogin$2(login_exports);
+function createZapierCliSdk3(options = {}) {
   const { extensions = [], ...sdkOptions } = options;
   const stackOptions = {
     ...sdkOptions,
@@ -8818,7 +8912,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"
     }
   });
   addPlugin(sdk, cliFetchOverride);
@@ -8959,11 +9053,11 @@ function buildFrameLines(state, frameIndex) {
   const bodyWidth = width - 2;
   const bodyTextWidth = innerWidth - 2;
   const content = [];
-  content.push(chalk9.bold.cyan("Approval review"));
+  content.push(chalk10.bold.cyan("Approval review"));
   content.push("");
   if (!state.verdict) {
     content.push(
-      chalk9.yellow(`${SPINNER_FRAMES[frameIndex]} Checking approval...`)
+      chalk10.yellow(`${SPINNER_FRAMES[frameIndex]} Checking approval...`)
     );
   }
   const recentMessages = state.messages.slice(-5);
@@ -8974,13 +9068,13 @@ function buildFrameLines(state, frameIndex) {
       "\n"
     );
     segments.forEach((segment, segmentIndex) => {
-      const prefix = segmentIndex === 0 ? chalk9.cyan("> ") : "  ";
-      content.push(`${prefix}${dimmed ? chalk9.dim(segment) : segment}`);
+      const prefix = segmentIndex === 0 ? chalk10.cyan("> ") : "  ";
+      content.push(`${prefix}${dimmed ? chalk10.dim(segment) : segment}`);
     });
   });
   if (state.streamError) {
     if (hasMessages || !state.verdict) content.push("");
-    content.push(chalk9.bold.red("Approval stream error"));
+    content.push(chalk10.bold.red("Approval stream error"));
     for (const segment of wrapAnsi4(state.streamError, bodyTextWidth, {
       hard: true
     }).split("\n")) {
@@ -8990,7 +9084,7 @@ function buildFrameLines(state, frameIndex) {
   if (state.verdict) {
     if (hasMessages || state.streamError) content.push("");
     content.push(
-      chalk9.bold.green(`${state.verdict.icon} ${state.verdict.label}`)
+      chalk10.bold.green(`${state.verdict.icon} ${state.verdict.label}`)
     );
     if (state.verdict.reason) {
       for (const segment of wrapAnsi4(state.verdict.reason, bodyTextWidth, {
@@ -9002,12 +9096,12 @@ function buildFrameLines(state, frameIndex) {
   }
   const pad = (line) => {
     const padding = " ".repeat(Math.max(0, innerWidth - displayWidth(line)));
-    return `${chalk9.cyan("\u2502")} ${line}${padding} ${chalk9.cyan("\u2502")}`;
+    return `${chalk10.cyan("\u2502")} ${line}${padding} ${chalk10.cyan("\u2502")}`;
   };
   return [
-    chalk9.cyan(`\u256D${"\u2500".repeat(bodyWidth)}\u256E`),
+    chalk10.cyan(`\u256D${"\u2500".repeat(bodyWidth)}\u256E`),
     ...content.map(pad),
-    chalk9.cyan(`\u2570${"\u2500".repeat(bodyWidth)}\u256F`)
+    chalk10.cyan(`\u2570${"\u2500".repeat(bodyWidth)}\u256F`)
   ];
 }
 function createApprovalProgressRenderer({
@@ -9207,6 +9301,7 @@ var EXIT_GRACE_PERIOD_MILLISECONDS = 500;
 var program = new 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}`,
@@ -9235,7 +9330,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
@@ -9321,8 +9419,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 (STABILITY_LEVELS.includes(value)) {
+    return value;
+  }
+  console.error(
+    `Invalid ${source} value "${value}". Valid stability levels: ${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
 });
@@ -9330,7 +9477,7 @@ program.exitOverride();
 (async () => {
   let exitCode = 0;
   const extensions = await resolveExtensions();
-  const sdk = createZapierCliSdk3({
+  const sdk = createZapierCliSdk4({
     debug: isDebugMode,
     credentials,
     baseUrl,