@epilot/cli 0.1.5 → 0.1.7

package/dist/{chunk-6RBLA5YE.js → chunk-7ZQ666ZQ.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/lib/utils.ts
+import { spawnSync } from "child_process";
 var isValidJson = (str) => {
   try {
     JSON.parse(str);
@@ -51,6 +52,29 @@ var methodColor = (method) => {
       return "\x1B[37m";
   }
 };
+var pager = (content) => {
+  if (!process.stdout.isTTY) {
+    process.stdout.write(content);
+    return;
+  }
+  const lines = content.split("\n").length;
+  const rows = process.stdout.rows || 24;
+  if (lines <= rows) {
+    process.stdout.write(content);
+    return;
+  }
+  try {
+    const result = spawnSync("less", ["-R", "-F", "-X"], {
+      input: content,
+      stdio: ["pipe", "inherit", "inherit"]
+    });
+    if (result.status !== 0 && result.status !== null) {
+      process.stdout.write(content);
+    }
+  } catch {
+    process.stdout.write(content);
+  }
+};
 var RESET = "\x1B[0m";
 var BOLD = "\x1B[1m";
 var DIM = "\x1B[2m";
@@ -58,17 +82,36 @@ var GREEN = "\x1B[32m";
 var RED = "\x1B[31m";
 var YELLOW = "\x1B[33m";
 var CYAN = "\x1B[36m";
+var WHITE = "\x1B[37m";
+var BG_GREEN = "\x1B[42m";
+var BG_RED = "\x1B[41m";
+var MAGENTA = "\x1B[35m";
+var highlightJson = (jsonStr) => jsonStr.replace(
+  /("(?:\\.|[^"\\])*")\s*(:)?|(\b(?:true|false|null)\b)|(-?\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b)/g,
+  (match, str, colon, bool, num) => {
+    if (str && colon) return `${CYAN}${str}${RESET}${colon}`;
+    if (str) return `${GREEN}${str}${RESET}`;
+    if (bool) return `${MAGENTA}${bool}${RESET}`;
+    if (num) return `${YELLOW}${num}${RESET}`;
+    return match;
+  }
+);
 
 export {
   isValidJson,
   parseKeyValue,
   parseParamValue,
   methodColor,
+  pager,
   RESET,
   BOLD,
   DIM,
   GREEN,
   RED,
   YELLOW,
-  CYAN
+  CYAN,
+  WHITE,
+  BG_GREEN,
+  BG_RED,
+  highlightJson
 };

package/dist/{chunk-HN4QDJOJ.js → chunk-AMOFZJ5W.js}

@@ -2,7 +2,7 @@
 import {
   DIM,
   RESET
-} from "./chunk-6RBLA5YE.js";
+} from "./chunk-7ZQ666ZQ.js";
 
 // src/lib/interactive.ts
 var isInteractive = (flags) => {
@@ -21,9 +21,7 @@ var pickOperation = async (operations) => {
     source: (input) => {
       if (!input) return choices;
       const term = input.toLowerCase();
-      return choices.filter(
-        (c) => c.value.toLowerCase().includes(term) || c.name.toLowerCase().includes(term)
-      );
+      return choices.filter((c) => c.value.toLowerCase().includes(term) || c.name.toLowerCase().includes(term));
     },
     pageSize: 20
   });
@@ -57,15 +55,16 @@ var promptToken = async () => {
   });
   return token || null;
 };
-var printOperationsTable = (apiName, operations) => {
+var formatOperationsTable = (apiName, operations) => {
+  const lines = [];
   for (const op of operations) {
     const desc = op.description ? ` \u2013 ${op.description}` : "";
-    process.stdout.write(`  ${op.operationId} ${DIM}${op.method.toUpperCase()} ${op.path}${desc}${RESET}
-`);
+    lines.push(`  ${op.operationId} ${DIM}${op.method.toUpperCase()} ${op.path}${desc}${RESET}`);
   }
-  process.stdout.write(`
+  lines.push(`
 Run \`epilot ${apiName} <operationId> --help\` for details.
 `);
+  return lines.join("\n");
 };
 
 export {
@@ -73,5 +72,5 @@ export {
   pickOperation,
   promptParam,
   promptToken,
-  printOperationsTable
+  formatOperationsTable
 };

package/dist/{chunk-BJOXXFMA.js → chunk-EU2A2ORP.js}

@@ -6,23 +6,28 @@ import {
   getResolvedProfile
 } from "./chunk-PDMWUCWD.js";
 import {
+  formatOperationsTable,
   isInteractive,
   pickOperation,
-  printOperationsTable,
   promptParam
-} from "./chunk-HN4QDJOJ.js";
+} from "./chunk-AMOFZJ5W.js";
 import {
+  BG_GREEN,
+  BG_RED,
   BOLD,
   DIM,
   GREEN,
   RED,
   RESET,
+  WHITE,
   YELLOW,
+  highlightJson,
   isValidJson,
   methodColor,
+  pager,
   parseKeyValue,
   parseParamValue
-} from "./chunk-6RBLA5YE.js";
+} from "./chunk-7ZQ666ZQ.js";
 
 // src/lib/call.ts
 import OpenAPIClientAxiosModule from "openapi-client-axios";
@@ -253,40 +258,73 @@ var readStdin = () => {
 };
 
 // src/lib/response-formatter.ts
+var statusBg = (code) => {
+  if (code >= 400) return BG_RED;
+  return BG_GREEN;
+};
 var formatResponse = async (response, options) => {
-  const { json, include, verbose, jsonata } = options;
+  const { json, include, verbose, jsonata, interactive, operationId } = options;
+  const isTTY = process.stdout.isTTY && process.stderr.isTTY;
+  const usePager = !json && isTTY && interactive !== false;
+  let buf = "";
+  const meta = (text) => {
+    if (usePager) {
+      buf += text;
+    } else {
+      process.stderr.write(text);
+    }
+  };
+  const req = response.config;
+  const method = (req.method || "GET").toUpperCase();
+  const baseURL = req.baseURL || "";
+  const reqUrl = req.url || "";
+  const url = reqUrl.startsWith("http") ? reqUrl : `${baseURL.replace(/\/$/, "")}${reqUrl.startsWith("/") ? "" : "/"}${reqUrl}`;
   if (verbose) {
-    const req = response.config;
-    process.stderr.write(`${DIM}${req.method?.toUpperCase()} ${req.url}${RESET}
-`);
+    meta(`${DIM}REQUEST META:${RESET}
+`);
+    const requestMeta = {
+      operationId,
+      method,
+      url
+    };
+    if (req.params && Object.keys(req.params).length > 0) {
+      requestMeta.params = req.params;
+    }
     if (req.headers) {
+      const headers = {};
       for (const [key, value] of Object.entries(req.headers)) {
-        if (typeof value === "string" && key.toLowerCase() !== "authorization") {
-          process.stderr.write(`${DIM}> ${key}: ${value}${RESET}
-`);
-        } else if (key.toLowerCase() === "authorization") {
-          process.stderr.write(`${DIM}> ${key}: Bearer ***${RESET}
-`);
+        if (key.toLowerCase() === "authorization") {
+          headers[key] = "Bearer ***";
+        } else if (typeof value === "string") {
+          headers[key] = value;
         }
       }
+      requestMeta.headers = headers;
     }
-    process.stderr.write("\n");
-  }
-  if (!json && !include && process.stdout.isTTY && process.stderr.isTTY) {
-    const statusColor = response.status >= 200 && response.status < 300 ? GREEN : response.status >= 400 ? RED : YELLOW;
-    process.stderr.write(
-      `${statusColor}${BOLD}${response.status}${RESET} ${statusColor}${response.statusText}${RESET}
-`
-    );
-  }
-  if (include) {
-    process.stderr.write(`${DIM}HTTP/${response.status} ${response.statusText}${RESET}
+    meta(`${DIM}${JSON.stringify(requestMeta, null, 2)}${RESET}
+
 `);
-    for (const [key, value] of Object.entries(response.headers)) {
-      process.stderr.write(`${DIM}${key}: ${value}${RESET}
+  }
+  if (verbose || include) {
+    meta(`${DIM}RESPONSE META:${RESET}
 `);
+    const responseMeta = {
+      code: response.status,
+      status: response.statusText
+    };
+    if (include) {
+      responseMeta.headers = response.headers;
     }
-    process.stderr.write("\n");
+    meta(`${DIM}${JSON.stringify(responseMeta, null, 2)}${RESET}
+
+`);
+  } else if (!json && isTTY) {
+    const mColor = methodColor(method);
+    meta(`${mColor}${BOLD}${method}${RESET} ${url}
+`);
+    const bg = statusBg(response.status);
+    meta(`${bg}${WHITE}${BOLD} ${response.status} ${RESET} ${response.statusText}
+`);
   }
   let data = response.data;
   if (jsonata && data) {
@@ -301,13 +339,33 @@ var formatResponse = async (response, options) => {
     }
   }
   if (data !== void 0 && data !== null) {
-    if (typeof data === "string") {
-      process.stdout.write(`${data}
+    if (verbose || include) {
+      meta(`${DIM}RESPONSE BODY:${RESET}
 `);
+    }
+    let body;
+    if (typeof data === "string") {
+      body = `${data}
+`;
+    } else if (json) {
+      body = `${JSON.stringify(data)}
+`;
     } else {
-      const indent = json ? 0 : 2;
-      process.stdout.write(`${JSON.stringify(data, null, indent)}
+      const pretty = JSON.stringify(data, null, 2);
+      body = isTTY ? `${highlightJson(pretty)}
+` : `${pretty}
+`;
+    }
+    if (usePager) {
+      pager(buf + body);
+    } else {
+      process.stdout.write(body);
+    }
+  } else {
+    meta(`${DIM}(empty response)${RESET}
 `);
+    if (usePager && buf) {
+      pager(buf);
     }
   }
 };
@@ -363,7 +421,6 @@ var mockFromSchema = (schema) => {
   return mock(schema);
 };
 var { dereferenceSync } = dereferenceJsonSchema;
-var w = (text) => process.stdout.write(text);
 var getBodySchema = (spec, operationId) => {
   const paths = spec.paths ?? {};
   for (const methods of Object.values(paths)) {
@@ -379,7 +436,11 @@ var getBodySchema = (spec, operationId) => {
   }
   return void 0;
 };
-var printOperationHelp = (apiName, operationId, spec) => {
+var formatOperationHelp = (apiName, operationId, spec) => {
+  let out = "";
+  const w = (text) => {
+    out += text;
+  };
   for (const [path, methods] of Object.entries(spec.paths ?? {})) {
     if (!methods) continue;
     for (const method of ["get", "post", "put", "patch", "delete", "head", "options"]) {
@@ -432,15 +493,15 @@ ${BOLD}epilot ${apiName} ${operationId}${RESET}`);
         if (bodySchema) {
           try {
             const mockBody = truncateJson(mockFromSchema(bodySchema));
-            const bodyStr = JSON.stringify(mockBody, null, 2);
+            const bodyStr = highlightJson(JSON.stringify(mockBody, null, 2));
             const lines = bodyStr.split("\n");
             w(`
 `);
             if (lines.length <= MAX_BODY_LINES) {
-              for (const line of lines) w(`  ${DIM}${line}${RESET}
+              for (const line of lines) w(`  ${line}
 `);
             } else {
-              for (const line of lines.slice(0, MAX_BODY_LINES)) w(`  ${DIM}${line}${RESET}
+              for (const line of lines.slice(0, MAX_BODY_LINES)) w(`  ${line}
 `);
               w(`  ${DIM}  ...${RESET}
 `);
@@ -451,6 +512,35 @@ ${BOLD}epilot ${apiName} ${operationId}${RESET}`);
         w(`
 `);
       }
+      w(`${BOLD}FLAGS${RESET}
+
+`);
+      w(`  ${GREEN}-p${RESET} key=value             Set a named parameter
+`);
+      w(`  ${GREEN}-d${RESET} '{...}'               Request body JSON
+`);
+      w(`  ${GREEN}-H${RESET} 'Key: Value'          Custom header
+`);
+      w(`  ${GREEN}-t, --token${RESET} <token>     Bearer token for authentication
+`);
+      w(`  ${GREEN}--profile${RESET} <name>        Use a named profile
+`);
+      w(`  ${GREEN}-s, --server${RESET} <url>      Override server base URL
+`);
+      w(`  ${GREEN}-i, --include${RESET}           Include response headers in output
+`);
+      w(`  ${GREEN}--json${RESET}                  Output raw JSON (no formatting)
+`);
+      w(`  ${GREEN}-v, --verbose${RESET}           Verbose output (show request details)
+`);
+      w(`  ${GREEN}--jsonata${RESET} <expr>        JSONata expression to transform response
+`);
+      w(`  ${GREEN}--definition${RESET} <file>     Override OpenAPI spec file/URL
+`);
+      w(`  ${GREEN}--no-interactive${RESET}        Disable interactive prompts
+`);
+      w(`
+`);
       w(`${BOLD}EXAMPLES${RESET}
 
 `);
@@ -544,7 +634,8 @@ ${BOLD}epilot ${apiName} ${operationId}${RESET}`);
 `);
             const limit = 40;
             const shown = lines.length <= limit ? lines : lines.slice(0, limit);
-            for (const line of shown) w(`  ${DIM}${line}${RESET}
+            const highlighted = highlightJson(shown.join("\n"));
+            for (const hLine of highlighted.split("\n")) w(`  ${hLine}
 `);
             if (lines.length > limit) w(`  ${DIM}  ... (${lines.length - limit} more lines)${RESET}
 `);
@@ -554,12 +645,10 @@ ${BOLD}epilot ${apiName} ${operationId}${RESET}`);
           }
         }
       }
-      return;
+      return out;
     }
   }
-  process.stderr.write(`${RED}Operation "${operationId}" not found.${RESET}
-`);
-  process.exit(1);
+  return null;
 };
 var guessJsonataExpr = (op) => {
   const successResp = op.responses?.["200"] || op.responses?.["201"];
@@ -583,25 +672,38 @@ var callApi = async (apiName, args) => {
   const spec = dereferenceSync(rawSpec);
   const operations = extractOperations(spec);
   if (!args.operation) {
-    process.stdout.write(
-      `
+    const header = `
 ${BOLD}epilot ${apiName}${RESET} - ${spec.info?.title || apiName}
 
-`
-    );
-    process.stdout.write(`${BOLD}Available operations:${RESET}
+${BOLD}Available operations:${RESET}
 
-`);
-    if (isInteractive({ interactive: args.interactive })) {
+`;
+    if (!args._apihelp && isInteractive({ interactive: args.interactive })) {
+      process.stdout.write(header);
       const operationId2 = await pickOperation(operations);
       return callApi(apiName, { ...args, operation: operationId2 });
     }
-    printOperationsTable(apiName, operations);
+    if (args.interactive === false) {
+      process.stdout.write(header + formatOperationsTable(apiName, operations));
+    } else {
+      pager(header + formatOperationsTable(apiName, operations));
+    }
     return;
   }
   const operationId = args.operation;
   if (args.help) {
-    printOperationHelp(apiName, operationId, spec);
+    const helpText = formatOperationHelp(apiName, operationId, spec);
+    if (helpText) {
+      if (args.interactive === false) {
+        process.stdout.write(helpText);
+      } else {
+        pager(helpText);
+      }
+    } else {
+      process.stderr.write(`${RED}Operation "${operationId}" not found.${RESET}
+`);
+      process.exit(1);
+    }
     return;
   }
   const opExists = operations.some((op) => op.operationId === operationId);
@@ -616,7 +718,7 @@ ${BOLD}epilot ${apiName}${RESET} - ${spec.info?.title || apiName}
   let token = resolveToken(args.token, args.profile);
   if (!token) {
     if (isInteractive({ interactive: args.interactive })) {
-      const { promptToken } = await import("./interactive-XXYFAJEI.js");
+      const { promptToken } = await import("./interactive-CD3I3Q5X.js");
       token = await promptToken();
     }
     if (!token) {
@@ -702,7 +804,9 @@ ${BOLD}epilot ${apiName}${RESET} - ${spec.info?.title || apiName}
       json: args.json,
       include: args.include,
       verbose: args.verbose,
-      jsonata: args.jsonata
+      jsonata: args.jsonata,
+      interactive: args.interactive,
+      operationId
     });
     if (response.status >= 400) {
       process.exit(1);

package/dist/{completion-RCVUCEMM.js → completion-EKFXGPNK.js}

@@ -8,7 +8,7 @@ import {
   RED,
   RESET,
   YELLOW
-} from "./chunk-6RBLA5YE.js";
+} from "./chunk-7ZQ666ZQ.js";
 
 // src/commands/completion.ts
 import { defineCommand } from "citty";

package/dist/{consent-OJBGOI54.js → consent-HZ7EVD4I.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/consent.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var consent_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var consent_default = defineCommand({
     return callApi("consent", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }

package/dist/{customer-portal-BDKNWKHA.js → customer-portal-XHM7X235.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/customer-portal.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var customer_portal_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var customer_portal_default = defineCommand({
     return callApi("customer-portal", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }

package/dist/{dashboard-IAEU3JFY.js → dashboard-NVP6FMOH.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/dashboard.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var dashboard_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var dashboard_default = defineCommand({
     return callApi("dashboard", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }

package/dist/{data-management-UEDSGAKB.js → data-management-JGDAGO75.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/data-management.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var data_management_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var data_management_default = defineCommand({
     return callApi("data-management", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }

package/dist/{deduplication-JJS3TOJ2.js → deduplication-DTY4VICH.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/deduplication.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var deduplication_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var deduplication_default = defineCommand({
     return callApi("deduplication", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }

package/dist/{design-WKSDZFBJ.js → design-72XM3PQR.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-BJOXXFMA.js";
+} from "./chunk-EU2A2ORP.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
-import "./chunk-HN4QDJOJ.js";
-import "./chunk-6RBLA5YE.js";
+import "./chunk-AMOFZJ5W.js";
+import "./chunk-7ZQ666ZQ.js";
 
 // src/commands/apis/design.ts
 import { defineCommand } from "citty";
@@ -25,7 +25,8 @@ var design_default = defineCommand({
     verbose: { type: "boolean", alias: "v", description: "Verbose output" },
     interactive: { type: "boolean", description: "Interactive mode" },
     jsonata: { type: "string", description: "JSONata expression to transform response" },
-    _ophelp: { type: "boolean", description: "Show operation help", required: false }
+    _ophelp: { type: "boolean", description: "Show operation help", required: false },
+    _apihelp: { type: "boolean", description: "Show API help", required: false }
   },
   run: ({ args, rawArgs }) => {
     const positionalArgs = [];
@@ -42,6 +43,7 @@ var design_default = defineCommand({
     return callApi("design", {
       ...args,
       help: !!args._ophelp,
+      _apihelp: !!args._apihelp,
       _args: positionalArgs
     });
   }