@zapier/zapier-sdk-cli 0.55.6 → 0.55.7

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Command, CommanderError, Option } from 'commander';
 import { z } from 'zod';
-import { definePlugin, createPluginMethod, OutputPropertySchema, ZapierBundleError, DEFAULT_CONFIG_PATH, ZapierValidationError, ZapierUnknownError, ZapierReleaseTriggerMessageSignal, injectCliLogin, BaseSdkOptionsSchema, getOrCreateApiClient, isPermanentHttpError, invalidateCachedToken, batch, toSnakeCase, ZapierAbortDrainSignal, createZapierSdkStack as createZapierSdkStack$1, addPlugin as addPlugin$1, ZapierError, isCredentialsObject, buildApplicationLifecycleEvent, ZapierAuthenticationError, isPositional, runWithTelemetryContext, buildCapabilityMessage, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, getReleaseId, getCurrentTimestamp, generateEventId } from '@zapier/zapier-sdk';
+import { definePlugin, createPluginMethod, OutputPropertySchema, ZapierBundleError, DEFAULT_CONFIG_PATH, ZapierValidationError, ZapierUnknownError, ZapierReleaseTriggerMessageSignal, injectCliLogin, BaseSdkOptionsSchema, getOrCreateApiClient, isPermanentHttpError, invalidateCachedToken, batch, toSnakeCase, ZapierAbortDrainSignal, createZapierSdkStack as createZapierSdkStack$1, addPlugin as addPlugin$1, ZapierError, isCredentialsObject, buildApplicationLifecycleEvent, ZapierAuthenticationError, isPositional, runWithTelemetryContext, buildCapabilityMessage, formatErrorMessage, getOsInfo, getPlatformVersions, getAgent, getTtyContext, getCiPlatform, isCi, getReleaseId, getCurrentTimestamp, generateEventId, ZapierApprovalError } from '@zapier/zapier-sdk';
 import inquirer from 'inquirer';
 import search from '@inquirer/search';
 import chalk from 'chalk';
@@ -33,6 +33,8 @@ import { fileURLToPath } from 'url';
 import { injectCliLogin as injectCliLogin$1, createZapierSdkStack, addPlugin } from '@zapier/zapier-sdk/experimental';
 import packageJsonLib, { VersionNotFoundError } from 'package-json';
 import semver from 'semver';
+import React from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -1531,7 +1533,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1587,6 +1589,11 @@ function buildCliCommandExecutedEvent({
     subprocess_count: data.subprocess_count ?? null
   };
 }
+function getApprovalReason(error) {
+  if (!(error instanceof ZapierApprovalError)) return void 0;
+  const { reason } = error;
+  return typeof reason === "string" && reason.trim().length > 0 ? reason.trim() : void 0;
+}
 function formatJsonOutput(data) {
   if (data === void 0) {
     return;
@@ -1727,7 +1734,14 @@ function buildJsonErrors(error) {
   }
   const code = error instanceof ZapierError ? error.code : "UNKNOWN_ERROR";
   const message = error instanceof Error ? error.message : String(error);
-  return [{ code, message }];
+  const reason = getApprovalReason(error);
+  return [
+    {
+      code,
+      message,
+      ...reason ? { reason } : {}
+    }
+  ];
 }
 async function unwrapHttpResponse(response) {
   const text = await response.text().catch(() => "[unable to read body]");
@@ -2368,7 +2382,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
     const commandObj = args[args.length - 1];
     const options = commandObj.opts();
     const interactiveMode = !options.json;
-    const renderer = interactiveMode ? createInteractiveRenderer({ sdk, params: resolvedParams }) : createJsonRenderer();
+    const renderer = interactiveMode ? createInteractiveRenderer({
+      sdk,
+      params: resolvedParams
+    }) : createJsonRenderer();
     try {
       emitDeprecationWarning({
         cliCommandName,
@@ -7195,7 +7212,7 @@ var watchTriggerInboxCliPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
@@ -7439,6 +7456,232 @@ async function checkAndNotifyUpdates({
   const versionInfo = await checkForUpdates({ packageName, currentVersion });
   displayUpdateNotification(versionInfo, packageName);
 }
+var FALLBACK_PANEL_WIDTH = 72;
+var MIN_PANEL_WIDTH = 36;
+var MAX_PANEL_WIDTH = 88;
+var SPINNER_INTERVAL_MS = 80;
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var inkImportPromise;
+function loadInk() {
+  inkImportPromise ?? (inkImportPromise = import('ink'));
+  return inkImportPromise;
+}
+function createInitialState() {
+  return {
+    messages: [],
+    active: false
+  };
+}
+function getPanelWidth() {
+  const terminalColumns = process.stderr.columns;
+  if (!terminalColumns) return FALLBACK_PANEL_WIDTH;
+  return Math.min(
+    Math.max(terminalColumns - 4, MIN_PANEL_WIDTH),
+    MAX_PANEL_WIDTH
+  );
+}
+function getPayloadString(event, key) {
+  const value = event.payload?.[key];
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function getApprovedVerdict(decision, reason) {
+  if (decision !== "approved") return void 0;
+  return {
+    icon: "\u2713",
+    label: "Approved",
+    color: "green",
+    reason
+  };
+}
+function Spinner({ text }) {
+  const [frameIndex, setFrameIndex] = React.useState(0);
+  const InkText = text;
+  React.useEffect(() => {
+    const timer = setInterval(() => {
+      setFrameIndex((index) => (index + 1) % SPINNER_FRAMES.length);
+    }, SPINNER_INTERVAL_MS);
+    return () => clearInterval(timer);
+  }, []);
+  return /* @__PURE__ */ jsx(InkText, { color: "yellow", children: `${SPINNER_FRAMES[frameIndex]} Checking approval...` });
+}
+function ApprovalProgressView({
+  state,
+  box,
+  text
+}) {
+  if (!state.active) return null;
+  const InkBox = box;
+  const InkText = text;
+  const recentMessages = state.messages.slice(-5);
+  const hasMessages = recentMessages.length > 0;
+  return /* @__PURE__ */ jsxs(
+    InkBox,
+    {
+      borderColor: "cyan",
+      borderStyle: "round",
+      flexDirection: "column",
+      paddingX: 1,
+      width: getPanelWidth(),
+      children: [
+        /* @__PURE__ */ jsx(InkText, { bold: true, color: "cyan", children: "Approval review" }),
+        /* @__PURE__ */ jsxs(InkBox, { flexDirection: "column", marginTop: 1, children: [
+          !state.verdict && /* @__PURE__ */ jsx(Spinner, { text }),
+          recentMessages.map((message, index) => /* @__PURE__ */ jsxs(InkBox, { flexDirection: "row", children: [
+            /* @__PURE__ */ jsx(InkText, { color: "cyan", children: "> " }),
+            /* @__PURE__ */ jsx(
+              InkText,
+              {
+                dimColor: Boolean(state.verdict) || index < recentMessages.length - 1,
+                wrap: "wrap",
+                children: message
+              }
+            )
+          ] }, `${index}-${message}`)),
+          state.streamError && /* @__PURE__ */ jsxs(
+            InkBox,
+            {
+              flexDirection: "column",
+              marginTop: hasMessages || !state.verdict ? 1 : 0,
+              children: [
+                /* @__PURE__ */ jsx(InkText, { bold: true, color: "red", children: "Approval stream error" }),
+                /* @__PURE__ */ jsx(InkText, { wrap: "wrap", children: `  ${state.streamError}` })
+              ]
+            }
+          ),
+          state.verdict && /* @__PURE__ */ jsxs(
+            InkBox,
+            {
+              flexDirection: "column",
+              marginTop: hasMessages || state.streamError ? 1 : 0,
+              children: [
+                /* @__PURE__ */ jsx(InkText, { bold: true, color: state.verdict.color, children: `${state.verdict.icon} ${state.verdict.label}` }),
+                state.verdict.reason && /* @__PURE__ */ jsx(InkText, { wrap: "wrap", children: `  ${state.verdict.reason}` })
+              ]
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
+function createApprovalProgressRenderer({
+  enabled,
+  onEvent
+}) {
+  let instance;
+  let currentState = createInitialState();
+  let renderQueue = Promise.resolve();
+  let renderGeneration = 0;
+  let renderEnabled = enabled;
+  let renderErrorReported = false;
+  function update(nextState, { complete = false } = {}) {
+    const generation = renderGeneration;
+    currentState = complete ? createInitialState() : nextState;
+    renderQueue = renderQueue.then(async () => {
+      if (generation !== renderGeneration) return;
+      const { Box, Text, render } = await loadInk();
+      if (generation !== renderGeneration) return;
+      const element = /* @__PURE__ */ jsx(ApprovalProgressView, { state: nextState, box: Box, text: Text });
+      if (!instance) {
+        instance = render(element, {
+          stdout: process.stderr,
+          stderr: process.stderr
+        });
+      } else {
+        instance.rerender(element);
+      }
+      if (complete) {
+        instance.unmount();
+        instance = void 0;
+      }
+    }).catch((error) => {
+      if (generation !== renderGeneration) return;
+      renderEnabled = false;
+      currentState = createInitialState();
+      if (renderErrorReported) return;
+      renderErrorReported = true;
+      const message = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`Approval progress unavailable: ${message}
+`);
+    });
+  }
+  function dismiss() {
+    renderGeneration++;
+    currentState = createInitialState();
+    instance?.unmount();
+    instance = void 0;
+  }
+  return {
+    onEvent(event) {
+      onEvent?.(event);
+      if (!renderEnabled) return;
+      if (event.type === "approval:required") {
+        if (event.payload?.mode !== "auto") return;
+        update({
+          approvalId: getPayloadString(event, "approvalId"),
+          messages: [],
+          active: true
+        });
+        return;
+      }
+      if (event.type === "approval:review_message") {
+        if (!currentState.active) return;
+        const message = getPayloadString(event, "message");
+        if (!message) return;
+        update({
+          ...currentState,
+          messages: [...currentState.messages, message]
+        });
+        return;
+      }
+      if (event.type === "approval:review_decision") {
+        if (!currentState.active) return;
+        const verdict = getApprovedVerdict(
+          event.payload?.decision,
+          getPayloadString(event, "reason")
+        );
+        if (!verdict) return;
+        update(
+          {
+            ...currentState,
+            verdict
+          },
+          { complete: true }
+        );
+        return;
+      }
+      if (event.type === "approval:review_stream_error") {
+        if (!currentState.active) return;
+        update({
+          ...currentState,
+          streamError: getPayloadString(event, "message") ?? "Approval review stream failed"
+        });
+        return;
+      }
+      if (!currentState.active) return;
+      if (event.type === "approval:approved") {
+        update(
+          {
+            ...currentState,
+            verdict: getApprovedVerdict(
+              "approved",
+              getPayloadString(event, "reason")
+            )
+          },
+          { complete: true }
+        );
+        return;
+      }
+      if (event.type === "approval:denied" || event.type === "approval:failed" || event.type === "approval:timeout" || event.type === "approval:error") {
+        dismiss();
+      }
+    }
+  };
+}
+
+// src/cli.ts
 var EXIT_GRACE_PERIOD_MS = 500;
 var program = new Command();
 var versionOption = getReservedCliOption("version" /* Version */);
@@ -7474,7 +7717,7 @@ for (const [key, fieldSchema] of Object.entries(
   }
   if (inner instanceof z.ZodBoolean && key !== "debug") {
     const kebab = key.replace(/([A-Z])/g, "-$1").toLowerCase();
-    const description = fieldSchema._zod?.def?.description ?? "";
+    const description = fieldSchema.description ?? inner.description ?? "";
     booleanFlags.push({ camelName: key, kebabFlag: `--${kebab}` });
     program.option(`--${kebab}`, description);
   }
@@ -7544,6 +7787,9 @@ for (const { camelName, kebabFlag } of booleanFlags) {
 }
 var useExperimental = process.argv.includes("--experimental") || process.env.ZAPIER_EXPERIMENTAL === "1" || process.env.ZAPIER_EXPERIMENTAL === "true";
 var createZapierCliSdk3 = useExperimental ? createZapierCliSdk2 : createZapierCliSdk;
+var approvalProgress = createApprovalProgressRenderer({
+  enabled: process.stderr.isTTY === true
+});
 program.exitOverride();
 (async () => {
   let exitCode = 0;
@@ -7556,6 +7802,7 @@ program.exitOverride();
     maxNetworkRetries,
     maxNetworkRetryDelayMs,
     maxConcurrentRequests,
+    onEvent: approvalProgress.onEvent,
     ...flagOverrides,
     extensions
   });

package/dist/experimental.cjs

@@ -4590,7 +4590,7 @@ var watchTriggerInboxCliPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/experimental.ts
 experimental.injectCliLogin(login_exports);

package/dist/experimental.mjs

@@ -4554,7 +4554,7 @@ var watchTriggerInboxCliPlugin = definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/experimental.ts
 injectCliLogin(login_exports);

package/dist/index.cjs

@@ -4589,7 +4589,7 @@ zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -4617,7 +4617,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -4553,7 +4553,7 @@ definePlugin(
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/sdk.ts
 injectCliLogin(login_exports);
@@ -4581,7 +4581,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.55.6"};
+  version: "0.55.7"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zapier/zapier-sdk-cli",
-    "version": "0.55.6",
+    "version": "0.55.7",
     "description": "Command line interface for Zapier SDK",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",
@@ -80,8 +80,8 @@
         "access": "public"
     },
     "dependencies": {
-        "@zapier/policy-schema": "0.11.0",
         "@inquirer/search": "^3.2.2",
+        "@zapier/policy-schema": "0.11.0",
         "@zapier/zapier-sdk": "workspace:*",
         "@zapier/zapier-sdk-mcp": "workspace:*",
         "chalk": "^5.3.0",
@@ -92,6 +92,7 @@
         "esbuild": "^0.25.5",
         "express": "^5.1.0",
         "handlebars": "^4.7.8",
+        "ink": "7.0.5",
         "inquirer": "^12.6.3",
         "is-installed-globally": "^1.0.0",
         "jsonwebtoken": "^9.0.2",
@@ -100,6 +101,7 @@
         "package-json": "^10.0.1",
         "pkce-challenge": "^5.0.0",
         "proper-lockfile": "^4.1.2",
+        "react": "19.2.6",
         "semver": "^7.7.3",
         "typescript": "^5.8.3",
         "wrap-ansi": "^10.0.0",
@@ -111,6 +113,7 @@
         "@types/jsonwebtoken": "^9.0.10",
         "@types/node": "^24.0.1",
         "@types/proper-lockfile": "^4.1.4",
+        "@types/react": "19.2.15",
         "@types/semver": "^7.7.1",
         "tsup": "^8.5.0",
         "vitest": "^4.1.4"

package/dist/src/cli.js

@@ -10,6 +10,7 @@ import { checkAndNotifyUpdates } from "./utils/version-checker";
 import { BaseSdkOptionsSchema } from "@zapier/zapier-sdk";
 import { z } from "zod";
 import { ReservedCliParameter, getReservedCliOption, } from "./utils/cli-options";
+import { createApprovalProgressRenderer } from "./utils/approval-progress";
 const EXIT_GRACE_PERIOD_MS = 500;
 const program = new Command();
 const versionOption = getReservedCliOption(ReservedCliParameter.Version);
@@ -44,7 +45,7 @@ BaseSdkOptionsSchema.shape)) {
     }
     if (inner instanceof z.ZodBoolean && key !== "debug") {
         const kebab = key.replace(/([A-Z])/g, "-$1").toLowerCase();
-        const description = fieldSchema._zod?.def?.description ?? "";
+        const description = fieldSchema.description ?? inner.description ?? "";
         booleanFlags.push({ camelName: key, kebabFlag: `--${kebab}` });
         program.option(`--${kebab}`, description);
     }
@@ -155,6 +156,9 @@ const useExperimental = process.argv.includes("--experimental") ||
 const createZapierCliSdk = useExperimental
     ? createExperimentalCliSdk
     : createStableCliSdk;
+const approvalProgress = createApprovalProgressRenderer({
+    enabled: process.stderr.isTTY === true,
+});
 // Override Commander's default exit behavior to handle our custom errors
 program.exitOverride();
 (async () => {
@@ -172,6 +176,7 @@ program.exitOverride();
         maxNetworkRetries,
         maxNetworkRetryDelayMs,
         maxConcurrentRequests,
+        onEvent: approvalProgress.onEvent,
         ...flagOverrides,
         extensions,
     });

package/dist/src/utils/approval-errors.d.ts

@@ -0,0 +1 @@
+export declare function getApprovalReason(error: unknown): string | undefined;

package/dist/src/utils/approval-errors.js

@@ -0,0 +1,9 @@
+import { ZapierApprovalError } from "@zapier/zapier-sdk";
+export function getApprovalReason(error) {
+    if (!(error instanceof ZapierApprovalError))
+        return undefined;
+    const { reason } = error;
+    return typeof reason === "string" && reason.trim().length > 0
+        ? reason.trim()
+        : undefined;
+}

package/dist/src/utils/approval-progress.d.ts

@@ -0,0 +1,12 @@
+export interface ApprovalProgressEvent {
+    type: string;
+    payload?: Record<string, unknown>;
+    timestamp?: number;
+}
+export interface ApprovalProgressRenderer {
+    onEvent(event: ApprovalProgressEvent): void;
+}
+export declare function createApprovalProgressRenderer({ enabled, onEvent, }: {
+    enabled: boolean;
+    onEvent?: (event: ApprovalProgressEvent) => void;
+}): ApprovalProgressRenderer;

package/dist/src/utils/approval-progress.js

@@ -0,0 +1,179 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+const FALLBACK_PANEL_WIDTH = 72;
+const MIN_PANEL_WIDTH = 36;
+const MAX_PANEL_WIDTH = 88;
+const MAX_VISIBLE_MESSAGES = 5;
+const SPINNER_INTERVAL_MS = 80;
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+let inkImportPromise;
+function loadInk() {
+    inkImportPromise ?? (inkImportPromise = import("ink"));
+    return inkImportPromise;
+}
+function createInitialState() {
+    return {
+        messages: [],
+        active: false,
+    };
+}
+function getPanelWidth() {
+    const terminalColumns = process.stderr.columns;
+    if (!terminalColumns)
+        return FALLBACK_PANEL_WIDTH;
+    return Math.min(Math.max(terminalColumns - 4, MIN_PANEL_WIDTH), MAX_PANEL_WIDTH);
+}
+function getPayloadString(event, key) {
+    const value = event.payload?.[key];
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function getApprovedVerdict(decision, reason) {
+    if (decision !== "approved")
+        return undefined;
+    return {
+        icon: "✓",
+        label: "Approved",
+        color: "green",
+        reason,
+    };
+}
+function Spinner({ text }) {
+    const [frameIndex, setFrameIndex] = React.useState(0);
+    const InkText = text;
+    React.useEffect(() => {
+        const timer = setInterval(() => {
+            setFrameIndex((index) => (index + 1) % SPINNER_FRAMES.length);
+        }, SPINNER_INTERVAL_MS);
+        return () => clearInterval(timer);
+    }, []);
+    return (_jsx(InkText, { color: "yellow", children: `${SPINNER_FRAMES[frameIndex]} Checking approval...` }));
+}
+function ApprovalProgressView({ state, box, text, }) {
+    if (!state.active)
+        return null;
+    const InkBox = box;
+    const InkText = text;
+    const recentMessages = state.messages.slice(-MAX_VISIBLE_MESSAGES);
+    const hasMessages = recentMessages.length > 0;
+    return (_jsxs(InkBox, { borderColor: "cyan", borderStyle: "round", flexDirection: "column", paddingX: 1, width: getPanelWidth(), children: [_jsx(InkText, { bold: true, color: "cyan", children: "Approval review" }), _jsxs(InkBox, { flexDirection: "column", marginTop: 1, children: [!state.verdict && _jsx(Spinner, { text: text }), recentMessages.map((message, index) => (_jsxs(InkBox, { flexDirection: "row", children: [_jsx(InkText, { color: "cyan", children: "> " }), _jsx(InkText, { dimColor: Boolean(state.verdict) || index < recentMessages.length - 1, wrap: "wrap", children: message })] }, `${index}-${message}`))), state.streamError && (_jsxs(InkBox, { flexDirection: "column", marginTop: hasMessages || !state.verdict ? 1 : 0, children: [_jsx(InkText, { bold: true, color: "red", children: "Approval stream error" }), _jsx(InkText, { wrap: "wrap", children: `  ${state.streamError}` })] })), state.verdict && (_jsxs(InkBox, { flexDirection: "column", marginTop: hasMessages || state.streamError ? 1 : 0, children: [_jsx(InkText, { bold: true, color: state.verdict.color, children: `${state.verdict.icon} ${state.verdict.label}` }), state.verdict.reason && (_jsx(InkText, { wrap: "wrap", children: `  ${state.verdict.reason}` }))] }))] })] }));
+}
+export function createApprovalProgressRenderer({ enabled, onEvent, }) {
+    let instance;
+    let currentState = createInitialState();
+    let renderQueue = Promise.resolve();
+    let renderGeneration = 0;
+    let renderEnabled = enabled;
+    let renderErrorReported = false;
+    function update(nextState, { complete = false } = {}) {
+        const generation = renderGeneration;
+        currentState = complete ? createInitialState() : nextState;
+        renderQueue = renderQueue
+            .then(async () => {
+            if (generation !== renderGeneration)
+                return;
+            const { Box, Text, render } = await loadInk();
+            if (generation !== renderGeneration)
+                return;
+            const element = (_jsx(ApprovalProgressView, { state: nextState, box: Box, text: Text }));
+            if (!instance) {
+                instance = render(element, {
+                    stdout: process.stderr,
+                    stderr: process.stderr,
+                });
+            }
+            else {
+                instance.rerender(element);
+            }
+            if (complete) {
+                instance.unmount();
+                instance = undefined;
+            }
+        })
+            .catch((error) => {
+            if (generation !== renderGeneration)
+                return;
+            renderEnabled = false;
+            currentState = createInitialState();
+            if (renderErrorReported)
+                return;
+            renderErrorReported = true;
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`Approval progress unavailable: ${message}\n`);
+        });
+    }
+    function dismiss() {
+        renderGeneration++;
+        currentState = createInitialState();
+        instance?.unmount();
+        instance = undefined;
+    }
+    return {
+        onEvent(event) {
+            onEvent?.(event);
+            if (!renderEnabled)
+                return;
+            if (event.type === "approval:required") {
+                if (event.payload?.mode !== "auto")
+                    return;
+                update({
+                    approvalId: getPayloadString(event, "approvalId"),
+                    messages: [],
+                    active: true,
+                });
+                return;
+            }
+            if (event.type === "approval:review_message") {
+                if (!currentState.active)
+                    return;
+                const message = getPayloadString(event, "message");
+                if (!message)
+                    return;
+                update({
+                    ...currentState,
+                    messages: [...currentState.messages, message],
+                });
+                return;
+            }
+            if (event.type === "approval:review_decision") {
+                if (!currentState.active)
+                    return;
+                const verdict = getApprovedVerdict(event.payload?.decision, getPayloadString(event, "reason"));
+                if (!verdict)
+                    return;
+                update({
+                    ...currentState,
+                    verdict,
+                }, { complete: true });
+                return;
+            }
+            if (event.type === "approval:review_stream_error") {
+                if (!currentState.active)
+                    return;
+                update({
+                    ...currentState,
+                    streamError: getPayloadString(event, "message") ??
+                        "Approval review stream failed",
+                });
+                return;
+            }
+            if (!currentState.active)
+                return;
+            if (event.type === "approval:approved") {
+                update({
+                    ...currentState,
+                    verdict: getApprovedVerdict("approved", getPayloadString(event, "reason")),
+                }, { complete: true });
+                return;
+            }
+            if (event.type === "approval:denied" ||
+                event.type === "approval:failed" ||
+                event.type === "approval:timeout" ||
+                event.type === "approval:error") {
+                dismiss();
+            }
+        },
+    };
+}

package/dist/src/utils/cli-generator.js

@@ -485,7 +485,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
         // interactiveMode is true by default; --json disables it
         const interactiveMode = !options.json;
         const renderer = interactiveMode
-            ? createInteractiveRenderer({ sdk, params: resolvedParams })
+            ? createInteractiveRenderer({
+                sdk,
+                params: resolvedParams,
+            })
             : createJsonRenderer();
         try {
             emitDeprecationWarning({