@zapier/zapier-sdk-cli 0.84.5 → 0.85.0

package/dist/experimental.cjs

@@ -3033,9 +3033,9 @@ 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 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)")
@@ -3044,11 +3044,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"],
@@ -3058,7 +3054,7 @@ var mcpPlugin = zapierSdk.defineMethod({
       debug: imports.sdkOptions?.debug,
       maxConcurrentRequests: imports.sdkOptions?.maxConcurrentRequests,
       extensions: imports.extensions,
-      experimental: imports.experimental
+      stability: imports.stability
     });
   }
 });
@@ -7197,7 +7193,7 @@ var createWorkflowCliPlugin = experimental.defineMethod({
   type: "create",
   itemType: "Workflow",
   categories: ["code-workflow"],
-  experimental: true,
+  stability: "experimental",
   inputSchema: CreateWorkflowCliOptionsSchema,
   outputSchema: experimental.CreateWorkflowResponseSchema,
   skipOutputValidation: true,
@@ -7208,6 +7204,17 @@ var createWorkflowCliPlugin = experimental.defineMethod({
     creationAccessMethod: "sdk_cli"
   })
 });
+function warningBlock({
+  banner,
+  message,
+  detail
+}) {
+  console.warn();
+  console.warn(chalk5__default.default.yellow.bold(banner) + chalk5__default.default.yellow(message));
+  if (detail) console.warn(chalk5__default.default.yellow(`   ${detail}`));
+  console.warn();
+}
+var DEPRECATION_BANNER = "\u26A0\uFE0F  DEPRECATION WARNING";
 var activeNotices = /* @__PURE__ */ new Map();
 function collectDeprecationNotice(event) {
   if (event.type !== zapierSdk.DEPRECATION_NOTICE_EVENT) return;
@@ -7224,21 +7231,33 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.84.5"};
+  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(
-      chalk5__default.default.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk5__default.default.yellow(` - \`${toKebabCase(methodName)}\` is deprecated.`)
-    );
-    console.warn(chalk5__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);
@@ -7321,7 +7340,7 @@ function createZapierCliSdk(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);

package/dist/experimental.d.mts

@@ -10,15 +10,17 @@ import 'zod/v4/core';
  *
  * Mirror of `./sdk.ts`, but built on top of
  * `@zapier/zapier-sdk/experimental` so the underlying SDK has every
- * `meta.experimental: true` plugin registered. The CLI's runtime
- * entry point (`cli.ts`) chooses between this and the stable factory
- * based on three equivalent triggers detected before Commander parses:
- * the `zapier-sdk-experimental` bin name (via `argv[1]`), the
- * `--experimental` flag, or the `ZAPIER_EXPERIMENTAL=1` env var.
+ * non-stable plugin registered (the experimental aggregate composes the
+ * beta one). The CLI's runtime entry point (`cli.ts`) chooses between
+ * this, the beta, and the stable factory based on equivalent triggers
+ * detected before Commander parses: `--stability experimental` /
+ * `ZAPIER_STABILITY=experimental`, or the released deprecated
+ * equivalents — the `zapier-sdk-experimental` bin, the `--experimental`
+ * flag, and the `ZAPIER_EXPERIMENTAL=1` env var.
  *
  * Plugin chain matches `./sdk.ts` literally, with future CLI-only
- * experimental plugins inserted at appropriate positions. Both
- * factories are kept in sync by shape tests.
+ * experimental plugins inserted at appropriate positions. All factories
+ * are kept in sync by the stability-ladder shape tests.
  */
 
 interface ZapierCliSdkOptions extends ZapierSdkOptions {

package/dist/experimental.d.ts

@@ -10,15 +10,17 @@ import 'zod/v4/core';
  *
  * Mirror of `./sdk.ts`, but built on top of
  * `@zapier/zapier-sdk/experimental` so the underlying SDK has every
- * `meta.experimental: true` plugin registered. The CLI's runtime
- * entry point (`cli.ts`) chooses between this and the stable factory
- * based on three equivalent triggers detected before Commander parses:
- * the `zapier-sdk-experimental` bin name (via `argv[1]`), the
- * `--experimental` flag, or the `ZAPIER_EXPERIMENTAL=1` env var.
+ * non-stable plugin registered (the experimental aggregate composes the
+ * beta one). The CLI's runtime entry point (`cli.ts`) chooses between
+ * this, the beta, and the stable factory based on equivalent triggers
+ * detected before Commander parses: `--stability experimental` /
+ * `ZAPIER_STABILITY=experimental`, or the released deprecated
+ * equivalents — the `zapier-sdk-experimental` bin, the `--experimental`
+ * flag, and the `ZAPIER_EXPERIMENTAL=1` env var.
  *
  * Plugin chain matches `./sdk.ts` literally, with future CLI-only
- * experimental plugins inserted at appropriate positions. Both
- * factories are kept in sync by shape tests.
+ * experimental plugins inserted at appropriate positions. All factories
+ * are kept in sync by the stability-ladder shape tests.
  */
 
 interface ZapierCliSdkOptions extends ZapierSdkOptions {

package/dist/experimental.mjs

@@ -7,7 +7,7 @@ import crypto, { createHash } from 'crypto';
 import * as path from 'path';
 import { resolve, join, dirname, basename, relative, extname } from 'path';
 import * as lockfile from 'proper-lockfile';
-import { 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, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, createSdk, SDK_OPTIONS_ID, resolvePlugin, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, isCoreCancelledSignal, ZapierAuthenticationError, DEPRECATION_NOTICE_EVENT } from '@zapier/zapier-sdk';
+import { 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, invalidateCachedToken, batch, toSnakeCase, ZapierError, isZapierReleaseTriggerMessageSignal, createSdk, SDK_OPTIONS_ID, resolvePlugin, isCredentialsObject, getRegistryPlugin, createController, ZapierAbortDrainSignal, ZapierReleaseTriggerMessageSignal, buildApplicationLifecycleEvent, AuthMechanism, isCoreCancelledSignal, ZapierAuthenticationError, STABILITY_DEFINITIONS, DEPRECATION_NOTICE_EVENT } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 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 as createSdk$1, CORE_OPTIONS_ID, SDK_OPTIONS_ID as SDK_OPTIONS_ID$1, addPlugin, formatExtensionPluginFailure } from '@zapier/zapier-sdk/experimental';
 import { hostname } from 'os';
@@ -2992,9 +2992,9 @@ 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 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)")
@@ -3003,11 +3003,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"],
@@ -3017,7 +3013,7 @@ var mcpPlugin = defineMethod({
       debug: imports.sdkOptions?.debug,
       maxConcurrentRequests: imports.sdkOptions?.maxConcurrentRequests,
       extensions: imports.extensions,
-      experimental: imports.experimental
+      stability: imports.stability
     });
   }
 });
@@ -7156,7 +7152,7 @@ var createWorkflowCliPlugin = defineMethod$1({
   type: "create",
   itemType: "Workflow",
   categories: ["code-workflow"],
-  experimental: true,
+  stability: "experimental",
   inputSchema: CreateWorkflowCliOptionsSchema,
   outputSchema: CreateWorkflowResponseSchema,
   skipOutputValidation: true,
@@ -7167,6 +7163,17 @@ var createWorkflowCliPlugin = defineMethod$1({
     creationAccessMethod: "sdk_cli"
   })
 });
+function warningBlock({
+  banner,
+  message,
+  detail
+}) {
+  console.warn();
+  console.warn(chalk5.yellow.bold(banner) + chalk5.yellow(message));
+  if (detail) console.warn(chalk5.yellow(`   ${detail}`));
+  console.warn();
+}
+var DEPRECATION_BANNER = "\u26A0\uFE0F  DEPRECATION WARNING";
 var activeNotices = /* @__PURE__ */ new Map();
 function collectDeprecationNotice(event) {
   if (event.type !== DEPRECATION_NOTICE_EVENT) return;
@@ -7183,21 +7190,33 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.84.5"};
+  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(
-      chalk5.yellow.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk5.yellow(` - \`${toKebabCase(methodName)}\` is deprecated.`)
-    );
-    console.warn(chalk5.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);
@@ -7280,7 +7299,7 @@ function createZapierCliSdk(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);