@zapier/zapier-sdk-cli 0.43.4 → 0.44.0

package/dist/cli.mjs

@@ -135,14 +135,14 @@ var SchemaParameterResolver = class {
       this.spinner = null;
     }
   }
-  async resolveParameters(schema, providedParams, sdk2, functionName, options) {
+  async resolveParameters(schema, providedParams, sdk, functionName, options) {
     return runWithTelemetryContext(async () => {
       this.debug = options?.debug ?? false;
       const interactiveMode = (options?.interactiveMode ?? true) && !!process.stdin.isTTY;
       const parseResult = schema.safeParse(providedParams);
       const allParams = this.extractParametersFromSchema(schema);
       const resolvableParams = allParams.filter(
-        (param) => this.hasResolver(param.name, sdk2, functionName)
+        (param) => this.hasResolver(param.name, sdk, functionName)
       );
       const missingResolvable = resolvableParams.filter((param) => {
         const hasValue = this.getNestedValue(providedParams, param.path) !== void 0;
@@ -167,12 +167,12 @@ var SchemaParameterResolver = class {
       }
       const resolvedParams = { ...providedParams };
       const context = {
-        sdk: sdk2,
+        sdk,
         currentParams: providedParams,
         resolvedParams,
         functionName
       };
-      const localResolvers = this.getLocalResolvers(sdk2, functionName);
+      const localResolvers = this.getLocalResolvers(sdk, functionName);
       if (required.length > 0) {
         const requiredParamNames = required.map((p) => p.name);
         const requiredResolutionOrder = getLocalResolutionOrderForParams(
@@ -1006,9 +1006,9 @@ Optional fields${pathContext}:`));
     const errorObj = error;
     return errorObj?.name === "ExitPromptError" || errorObj?.message?.includes("User force closed") || errorObj?.isTTYError === true;
   }
-  hasResolver(paramName, sdk2, functionName) {
-    if (functionName && typeof sdk2.getRegistry === "function") {
-      const registry = sdk2.getRegistry({ package: "cli" });
+  hasResolver(paramName, sdk, functionName) {
+    if (functionName && typeof sdk.getRegistry === "function") {
+      const registry = sdk.getRegistry({ package: "cli" });
       const functionInfo = registry.functions.find(
         (f) => f.name === functionName
       );
@@ -1018,9 +1018,9 @@ Optional fields${pathContext}:`));
     }
     return false;
   }
-  getResolver(paramName, sdk2, functionName) {
-    if (functionName && typeof sdk2.getRegistry === "function") {
-      const registry = sdk2.getRegistry({ package: "cli" });
+  getResolver(paramName, sdk, functionName) {
+    if (functionName && typeof sdk.getRegistry === "function") {
+      const registry = sdk.getRegistry({ package: "cli" });
       const functionInfo = registry.functions.find(
         (f) => f.name === functionName
       );
@@ -1030,11 +1030,11 @@ Optional fields${pathContext}:`));
     }
     return null;
   }
-  getLocalResolvers(sdk2, functionName) {
-    if (!functionName || typeof sdk2.getRegistry !== "function") {
+  getLocalResolvers(sdk, functionName) {
+    if (!functionName || typeof sdk.getRegistry !== "function") {
       return {};
     }
-    const registry = sdk2.getRegistry();
+    const registry = sdk.getRegistry();
     const functionInfo = registry.functions.find(
       (f) => f.name === functionName
     );
@@ -1072,7 +1072,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1790,19 +1790,19 @@ function reconstructPositionalArgs(inputParameters, flatParams) {
 function methodNameToCliCommand(methodName) {
   return toKebabCase(methodName);
 }
-function generateCliCommands(program2, sdk2) {
-  if (typeof sdk2.getRegistry !== "function") {
+function generateCliCommands(program2, sdk) {
+  if (typeof sdk.getRegistry !== "function") {
     console.error("SDK registry not available");
     return;
   }
-  const registry = sdk2.getRegistry({ package: "cli" });
+  const registry = sdk.getRegistry({ package: "cli" });
   registry.functions.forEach((fnInfo) => {
     if (!fnInfo.inputSchema && !fnInfo.inputParameters) {
       console.warn(`Schema not found for ${fnInfo.name}`);
       return;
     }
     const cliCommandName = methodNameToCliCommand(fnInfo.name);
-    const config2 = createCommandConfig(cliCommandName, fnInfo, sdk2);
+    const config2 = createCommandConfig(cliCommandName, fnInfo, sdk);
     addCommand(program2, cliCommandName, config2);
   });
   program2.configureHelp({
@@ -1866,7 +1866,7 @@ function generateCliCommands(program2, sdk2) {
     }
   });
 }
-function createCommandConfig(cliCommandName, functionInfo, sdk2) {
+function createCommandConfig(cliCommandName, functionInfo, sdk) {
   const usesInputParameters = !functionInfo.inputSchema && !!functionInfo.inputParameters;
   const schema = functionInfo.inputSchema;
   const parameters = usesInputParameters ? analyzeInputParameters(functionInfo.inputParameters, functionInfo) : analyzeZodSchema(schema, functionInfo);
@@ -1924,7 +1924,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         resolvedParams = await resolver.resolveParameters(
           schema,
           rawParams,
-          sdk2,
+          sdk,
           functionInfo.name,
           {
             interactiveMode,
@@ -1947,7 +1947,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         }
         confirmMessageAfter = confirmResult.messageAfter;
       }
-      const sdkMethod = sdk2[functionInfo.name];
+      const sdkMethod = sdk[functionInfo.name];
       switch (outputMode) {
         case "paginate": {
           const source = sdkMethod(resolvedParams);
@@ -2039,7 +2039,7 @@ ${confirmMessageAfter}`));
             selected_api: resolvedParams.app ?? null
           }
         });
-        sdk2.context.eventEmission.emit(
+        sdk.context.eventEmission.emit(
           CLI_COMMAND_EXECUTED_EVENT_SUBJECT,
           event
         );
@@ -3058,24 +3058,24 @@ function toPkceCredentials(credentials2) {
   return void 0;
 }
 var loginPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "login",
     categories: ["account"],
     inputSchema: LoginSchema,
     supportsJsonOutput: false,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const timeoutSeconds = options.timeout ? parseInt(options.timeout, 10) : 300;
       if (isNaN(timeoutSeconds) || timeoutSeconds <= 0) {
         throw new Error("Timeout must be a positive number");
       }
-      const resolvedCredentials = await sdk3.context.resolveCredentials();
+      const resolvedCredentials = await sdk2.context.resolveCredentials();
       const pkceCredentials = toPkceCredentials(resolvedCredentials);
       await login_default({
         timeoutMs: timeoutSeconds * 1e3,
         credentials: pkceCredentials
       });
       const user = await getLoggedInUser();
-      sdk3.context.eventEmission.emit(
+      sdk2.context.eventEmission.emit(
         "platform.sdk.ApplicationLifecycleEvent",
         buildApplicationLifecycleEvent(
           { lifecycle_event_type: "login_success" },
@@ -3090,7 +3090,7 @@ var LogoutSchema = z.object({}).describe("Log out of your Zapier account");
 
 // src/plugins/logout/index.ts
 var logoutPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "logout",
     categories: ["account"],
     inputSchema: LogoutSchema,
@@ -3107,12 +3107,16 @@ var McpSchema = z.object({
 
 // src/plugins/mcp/index.ts
 var mcpPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "mcp",
     categories: ["utility"],
     inputSchema: McpSchema,
-    handler: async ({ sdk: sdk3, options }) => {
-      await startMcpServer({ ...options, debug: sdk3.context.options?.debug });
+    handler: async ({ sdk: sdk2, options }) => {
+      await startMcpServer({
+        ...options,
+        debug: sdk2.context.options?.debug,
+        extensions: sdk2.context.extensions
+      });
     }
   })
 );
@@ -3127,7 +3131,7 @@ var BundleCodeSchema = z.object({
   cjs: z.boolean().optional().describe("Output CommonJS format instead of ESM")
 }).describe("Bundle TypeScript code into executable JavaScript");
 var bundleCodePlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "bundleCode",
     categories: ["utility", "deprecated"],
     inputSchema: BundleCodeSchema,
@@ -3201,7 +3205,7 @@ async function bundleCode(options) {
 }
 var GetLoginConfigPathSchema = z.object({}).describe("Show the path to the login configuration file");
 var getLoginConfigPathPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "getLoginConfigPath",
     categories: ["utility"],
     inputSchema: GetLoginConfigPathSchema,
@@ -3236,11 +3240,11 @@ async function detectTypesOutputDirectory() {
   return "./zapier/apps/";
 }
 var addPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "add",
     categories: ["utility"],
     inputSchema: AddSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         connections: connectionIds,
@@ -3311,13 +3315,13 @@ var addPlugin = definePlugin(
             break;
         }
       };
-      const manifestResult = await sdk3.buildManifest({
+      const manifestResult = await sdk2.buildManifest({
         apps: appKeys,
         skipWrite: false,
         configPath,
         onProgress: handleManifestProgress
       });
-      const typesResult = await sdk3.generateAppTypes({
+      const typesResult = await sdk2.generateAppTypes({
         apps: appKeys,
         connections: connectionIds,
         skipWrite: false,
@@ -3363,14 +3367,14 @@ var AstTypeGenerator = class {
    * Generate TypeScript types using AST for a specific app
    */
   async generateTypes(options) {
-    const { app, connectionId, sdk: sdk2 } = options;
-    const actionsResult = await sdk2.listActions({
+    const { app, connectionId, sdk } = options;
+    const actionsResult = await sdk.listActions({
       appKey: app.implementation_id
     });
     const actions = actionsResult.data;
     const actionsWithFields = [];
     const inputFieldsTasks = actions.map(
-      (action) => () => sdk2.listInputFields({
+      (action) => () => sdk.listInputFields({
         appKey: app.implementation_id,
         actionKey: action.key,
         actionType: action.action_type,
@@ -3941,13 +3945,13 @@ function createManifestEntry(app) {
   };
 }
 var generateAppTypesPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "generateAppTypes",
     categories: ["utility"],
     // Cast: schema validates JSON fields only; GenerateAppTypesOptions adds
     // the runtime-only `onProgress` callback (passthrough via createFunction).
     inputSchema: GenerateAppTypesSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         connections: connectionIds,
@@ -3958,7 +3962,7 @@ var generateAppTypesPlugin = definePlugin(
       const resolvedTypesOutput = resolve(typesOutputDirectory);
       const result = { typeDefinitions: {} };
       onProgress?.({ type: "apps_lookup_start", count: appKeys.length });
-      const appsIterable = sdk3.listApps({ apps: appKeys }).items();
+      const appsIterable = sdk2.listApps({ apps: appKeys }).items();
       const apps = [];
       for await (const app of appsIterable) {
         apps.push(app);
@@ -3974,7 +3978,7 @@ var generateAppTypesPlugin = definePlugin(
           type: "connections_lookup_start",
           count: connectionIds.length
         });
-        const connectionsIterable = sdk3.listConnections({ connections: connectionIds }).items();
+        const connectionsIterable = sdk2.listConnections({ connections: connectionIds }).items();
         for await (const connection of connectionsIterable) {
           connections.push(connection);
         }
@@ -4035,7 +4039,7 @@ var generateAppTypesPlugin = definePlugin(
           const typeDefinitionString = await generator.generateTypes({
             app,
             connectionId,
-            sdk: sdk3
+            sdk: sdk2
           });
           result.typeDefinitions[manifestKey] = typeDefinitionString;
           onProgress?.({
@@ -4083,7 +4087,7 @@ var BuildManifestSchema = z.object({
 
 // src/plugins/buildManifest/index.ts
 var buildManifestPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "buildManifest",
     categories: ["utility"],
     // Cast: BuildManifestSchema validates JSON-serializable fields only.
@@ -4091,7 +4095,7 @@ var buildManifestPlugin = definePlugin(
     // `createFunction`'s passthrough spread at runtime; this widens TInput
     // so the handler can read it.
     inputSchema: BuildManifestSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         skipWrite = false,
@@ -4099,7 +4103,7 @@ var buildManifestPlugin = definePlugin(
         onProgress
       } = options;
       onProgress?.({ type: "apps_lookup_start", count: appKeys.length });
-      const appsIterable = sdk3.listApps({ apps: appKeys }).items();
+      const appsIterable = sdk2.listApps({ apps: appKeys }).items();
       const apps = [];
       for await (const app of appsIterable) {
         apps.push(app);
@@ -4124,7 +4128,7 @@ var buildManifestPlugin = definePlugin(
             manifestKey: manifestEntry.implementationName,
             version: manifestEntry.version || ""
           });
-          const { key: updatedManifestKey, manifest } = await sdk3.context.updateManifestEntry({
+          const { key: updatedManifestKey, manifest } = await sdk2.context.updateManifestEntry({
             appKey: app.key,
             entry: manifestEntry,
             configPath,
@@ -4190,12 +4194,12 @@ async function postWithRetry({
   return response;
 }
 var feedbackPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "feedback",
     categories: ["utility"],
     inputSchema: FeedbackSchema,
     resolvers: { feedback: feedbackResolver },
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const user = await getLoggedInUser();
       const body = JSON.stringify({
         email: user.email,
@@ -4206,7 +4210,7 @@ var feedbackPlugin = definePlugin(
         body,
         attemptsLeft: MAX_RETRIES
       });
-      if (sdk3.context.options?.debug) {
+      if (sdk2.context.options?.debug) {
         const text = await response.text();
         console.error("[debug] Webhook response:", text);
       }
@@ -4389,7 +4393,7 @@ async function buildFormData(formArgs, formStringArgs) {
 }
 
 // src/plugins/curl/index.ts
-var curlPlugin = definePlugin((sdk2) => {
+var curlPlugin = definePlugin((sdk) => {
   async function curl(options) {
     const {
       url: rawUrl,
@@ -4522,7 +4526,7 @@ var curlPlugin = definePlugin((sdk2) => {
       process.stderr.write(">\n");
     }
     const start = performance.now();
-    const response = await sdk2.fetch(effectiveUrl.toString(), {
+    const response = await sdk.fetch(effectiveUrl.toString(), {
       method,
       headers,
       body,
@@ -4634,13 +4638,13 @@ ${Array.from(
   };
 });
 var cliOverridesPlugin = definePlugin(
-  (sdk2) => {
+  (sdk) => {
     const meta = {};
-    if (sdk2.context.meta.fetch) {
+    if (sdk.context.meta.fetch) {
       meta.fetch = {
-        ...sdk2.context.meta.fetch,
+        ...sdk.context.meta.fetch,
         categories: [
-          ...sdk2.context.meta.fetch.categories || [],
+          ...sdk.context.meta.fetch.categories || [],
           "deprecated"
         ],
         deprecation: {
@@ -5090,7 +5094,7 @@ function displaySummaryAndNextSteps({
 
 // src/plugins/init/index.ts
 var initPlugin = definePlugin(
-  (sdk2) => createPluginMethod(sdk2, {
+  (sdk) => createPluginMethod(sdk, {
     name: "init",
     categories: ["utility"],
     inputSchema: InitSchema,
@@ -5147,16 +5151,78 @@ var initPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
 function createZapierCliSdk(options = {}) {
-  return createZapierSdk({
-    ...options,
-    eventEmission: { ...options.eventEmission, callContext: "cli" },
+  const { extensions = [], ...sdkOptions } = options;
+  const extensionsContextPlugin = () => ({
+    context: { extensions }
+  });
+  let chain = createZapierSdk({
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default2.name, version: package_default2.version }
-  }).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).addPlugin(extensionsContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  for (const ext of extensions) {
+    try {
+      chain = chain.addPlugin(ext);
+    } catch (err) {
+      console.warn(
+        `Extension plugin failed to construct: ${err.message}; skipping.`
+      );
+    }
+  }
+  return chain;
+}
+
+// src/utils/extensions.ts
+var ENV_VAR = "ZAPIER_SDK_EXTENSIONS";
+async function resolveExtensions() {
+  const seen = /* @__PURE__ */ new Set();
+  const specs = readEnvSpecs().filter((spec) => {
+    if (seen.has(spec)) return false;
+    seen.add(spec);
+    return true;
+  });
+  const plugins = [];
+  for (const spec of specs) {
+    try {
+      const mod = await import(spec);
+      const exported = mod.default ?? mod;
+      const got = normalizeExtension(exported);
+      if (got) {
+        plugins.push(...got);
+      } else {
+        console.warn(
+          `Extension '${spec}': unrecognized default export shape; skipping.`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        `Extension '${spec}' failed to load: ${err.message}`
+      );
+    }
+  }
+  return plugins;
+}
+function normalizeExtension(exported) {
+  if (typeof exported === "function") {
+    return [exported];
+  }
+  if (Array.isArray(exported)) {
+    if (exported.every((e) => typeof e === "function")) {
+      return exported;
+    }
+    return null;
+  }
+  return null;
+}
+function readEnvSpecs() {
+  const raw = process.env[ENV_VAR];
+  if (!raw) return [];
+  return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 }
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 var CACHE_RESET_INTERVAL_MS = (() => {
@@ -5387,19 +5453,21 @@ for (const { camelName, kebabFlag } of booleanFlags) {
     flagOverrides[camelName] = true;
   }
 }
-var sdk = createZapierCliSdk({
-  debug: isDebugMode,
-  credentials,
-  baseUrl,
-  trackingBaseUrl,
-  maxNetworkRetries,
-  maxNetworkRetryDelayMs,
-  ...flagOverrides
-});
-generateCliCommands(program, sdk);
 program.exitOverride();
 (async () => {
   let exitCode = 0;
+  const extensions = await resolveExtensions();
+  const sdk = createZapierCliSdk({
+    debug: isDebugMode,
+    credentials,
+    baseUrl,
+    trackingBaseUrl,
+    maxNetworkRetries,
+    maxNetworkRetryDelayMs,
+    ...flagOverrides,
+    extensions
+  });
+  generateCliCommands(program, sdk);
   const versionCheckPromise = checkAndNotifyUpdates({
     packageName: package_default2.name,
     currentVersion: package_default2.version

package/dist/index.cjs

@@ -993,7 +993,11 @@ var mcpPlugin = zapierSdk.definePlugin(
     categories: ["utility"],
     inputSchema: McpSchema,
     handler: async ({ sdk: sdk2, options }) => {
-      await zapierSdkMcp.startMcpServer({ ...options, debug: sdk2.context.options?.debug });
+      await zapierSdkMcp.startMcpServer({
+        ...options,
+        debug: sdk2.context.options?.debug,
+        extensions: sdk2.context.extensions
+      });
     }
   })
 );
@@ -3001,21 +3005,35 @@ var initPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
 function createZapierCliSdk(options = {}) {
-  return zapierSdk.createZapierSdk({
-    ...options,
-    eventEmission: { ...options.eventEmission, callContext: "cli" },
+  const { extensions = [], ...sdkOptions } = options;
+  const extensionsContextPlugin = () => ({
+    context: { extensions }
+  });
+  let chain = zapierSdk.createZapierSdk({
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default.name, version: package_default.version }
-  }).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).addPlugin(extensionsContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  for (const ext of extensions) {
+    try {
+      chain = chain.addPlugin(ext);
+    } catch (err) {
+      console.warn(
+        `Extension plugin failed to construct: ${err.message}; skipping.`
+      );
+    }
+  }
+  return chain;
 }
 
 // package.json
 var package_default2 = {
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _zapier_zapier_sdk from '@zapier/zapier-sdk';
-import { AppItem, Manifest, ZapierSdk, ZapierSdkOptions, BaseEvent } from '@zapier/zapier-sdk';
+import { AppItem, Manifest, ZapierSdk, ZapierSdkOptions, Plugin, PluginProvides, BaseEvent } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 
 declare const BuildManifestSchema: z.ZodObject<{
@@ -514,6 +514,14 @@ type GenerateAppTypesPluginProvides = ReturnType<typeof generateAppTypesPlugin>;
 type ZapierSdkCli = ZapierSdk & BuildManifestPluginProvides & FeedbackPluginProvides & GenerateAppTypesPluginProvides;
 
 interface ZapierCliSdkOptions extends ZapierSdkOptions {
+    /**
+     * Extra plugins discovered from `@zapier/zapier-sdk` extension packages.
+     * Pre-resolved by `cli.ts` (`utils/extensions.ts`) so this factory stays
+     * synchronous. Each plugin is layered onto the chain after all built-in
+     * CLI plugins, so its functions appear in `getRegistry({ package: "cli" })`
+     * automatically.
+     */
+    extensions?: Plugin<unknown, PluginProvides>[];
 }
 /**
  * Create a Zapier SDK instance configured specifically for the CLI

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _zapier_zapier_sdk from '@zapier/zapier-sdk';
-import { AppItem, Manifest, ZapierSdk, ZapierSdkOptions, BaseEvent } from '@zapier/zapier-sdk';
+import { AppItem, Manifest, ZapierSdk, ZapierSdkOptions, Plugin, PluginProvides, BaseEvent } from '@zapier/zapier-sdk';
 import { z } from 'zod';
 
 declare const BuildManifestSchema: z.ZodObject<{
@@ -514,6 +514,14 @@ type GenerateAppTypesPluginProvides = ReturnType<typeof generateAppTypesPlugin>;
 type ZapierSdkCli = ZapierSdk & BuildManifestPluginProvides & FeedbackPluginProvides & GenerateAppTypesPluginProvides;
 
 interface ZapierCliSdkOptions extends ZapierSdkOptions {
+    /**
+     * Extra plugins discovered from `@zapier/zapier-sdk` extension packages.
+     * Pre-resolved by `cli.ts` (`utils/extensions.ts`) so this factory stays
+     * synchronous. Each plugin is layered onto the chain after all built-in
+     * CLI plugins, so its functions appear in `getRegistry({ package: "cli" })`
+     * automatically.
+     */
+    extensions?: Plugin<unknown, PluginProvides>[];
 }
 /**
  * Create a Zapier SDK instance configured specifically for the CLI

package/dist/index.mjs

@@ -957,7 +957,11 @@ var mcpPlugin = definePlugin(
     categories: ["utility"],
     inputSchema: McpSchema,
     handler: async ({ sdk: sdk2, options }) => {
-      await startMcpServer({ ...options, debug: sdk2.context.options?.debug });
+      await startMcpServer({
+        ...options,
+        debug: sdk2.context.options?.debug,
+        extensions: sdk2.context.extensions
+      });
     }
   })
 );
@@ -2965,21 +2969,35 @@ var initPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
 function createZapierCliSdk(options = {}) {
-  return createZapierSdk({
-    ...options,
-    eventEmission: { ...options.eventEmission, callContext: "cli" },
+  const { extensions = [], ...sdkOptions } = options;
+  const extensionsContextPlugin = () => ({
+    context: { extensions }
+  });
+  let chain = createZapierSdk({
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default.name, version: package_default.version }
-  }).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).addPlugin(extensionsContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  for (const ext of extensions) {
+    try {
+      chain = chain.addPlugin(ext);
+    } catch (err) {
+      console.warn(
+        `Extension plugin failed to construct: ${err.message}; skipping.`
+      );
+    }
+  }
+  return chain;
 }
 
 // package.json
 var package_default2 = {
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {