retell-cli 1.4.2 → 1.6.0

package/dist/index.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/index.ts
 var import_commander = require("commander");
-var import_fs17 = require("fs");
+var import_fs19 = require("fs");
 var import_path6 = require("path");
 
 // src/commands/login.ts
@@ -383,13 +383,13 @@ function getRetellClient() {
 async function listTranscriptsCommand(options) {
   try {
     const client = getRetellClient();
-    const calls = await client.call.list({
+    const calls2 = await client.call.list({
       limit: options.limit || 50
     });
     const output = options.fields ? filterFields(
-      calls,
+      calls2,
       options.fields.split(",").map((f) => f.trim())
-    ) : calls;
+    ) : calls2;
     outputJson(output);
   } catch (error) {
     handleSdkError(error);
@@ -3640,10 +3640,9 @@ async function addKnowledgeBaseSourcesCommand(knowledgeBaseId, options) {
 async function deleteKnowledgeBaseSourceCommand(knowledgeBaseId, sourceId) {
   try {
     const client = getRetellClient();
-    const knowledgeBase = await client.knowledgeBase.deleteSource(
-      knowledgeBaseId,
-      sourceId
-    );
+    const knowledgeBase = await client.knowledgeBase.deleteSource(sourceId, {
+      knowledge_base_id: knowledgeBaseId
+    });
     const output = {
       message: "Source deleted successfully",
       knowledge_base_id: knowledgeBase.knowledge_base_id,
@@ -3818,8 +3817,8 @@ async function listPhoneNumbersCommand(options = {}) {
       phone_number_pretty: pn.phone_number_pretty,
       phone_number_type: pn.phone_number_type,
       nickname: pn.nickname,
-      inbound_agent_id: pn.inbound_agent_id,
-      outbound_agent_id: pn.outbound_agent_id
+      inbound_agents: pn.inbound_agents ?? [],
+      outbound_agents: pn.outbound_agents ?? []
     }));
     const output = options.fields ? filterFields(
       formatted,
@@ -3846,29 +3845,146 @@ async function getPhoneNumberCommand(phoneNumber, options = {}) {
   }
 }
 
+// src/services/weighted-agents.ts
+function parseWeightedAgents(spec) {
+  const entries = spec.split(",").map((s) => s.trim()).filter(Boolean);
+  if (entries.length === 0) {
+    throwValidation("Empty agent spec. Provide at least one agent ID.");
+  }
+  const agents2 = entries.map((entry) => {
+    const parts = entry.split(":");
+    if (parts.length > 2) {
+      throwValidation(
+        `Invalid agent spec "${entry}". Expected format: agent_id or agent_id:weight`
+      );
+    }
+    const agentId = parts[0].trim();
+    if (!agentId) {
+      throwValidation(`Invalid agent spec "${entry}". Agent ID is empty.`);
+    }
+    if (parts.length === 1) {
+      return { agent_id: agentId, weight: -1 };
+    }
+    const weight = Number(parts[1]);
+    if (isNaN(weight) || weight <= 0 || weight > 1) {
+      throwValidation(
+        `Invalid weight "${parts[1]}" for agent "${agentId}". Weight must be a number between 0 (exclusive) and 1 (inclusive).`
+      );
+    }
+    return { agent_id: agentId, weight };
+  });
+  const allDefault = agents2.every((a) => a.weight === -1);
+  if (allDefault) {
+    const w = 1 / agents2.length;
+    for (const a of agents2) a.weight = w;
+  } else if (agents2.some((a) => a.weight === -1)) {
+    throwValidation(
+      "Cannot mix agents with and without weights. Either specify weights for all agents or none."
+    );
+  }
+  const sum = agents2.reduce((s, a) => s + a.weight, 0);
+  if (Math.abs(sum - 1) > 1e-3) {
+    throwValidation(
+      `Agent weights must sum to 1.0, but got ${sum.toFixed(4)}.`
+    );
+  }
+  return agents2;
+}
+function applyWeightedAgents(params, flags, options = { allowSms: true }) {
+  for (const [flagName, val] of [
+    ["--inbound-agent", flags.inboundAgent],
+    ["--outbound-agent", flags.outboundAgent],
+    ["--inbound-agents", flags.inboundAgents],
+    ["--outbound-agents", flags.outboundAgents],
+    ["--inbound-sms-agents", flags.inboundSmsAgents],
+    ["--outbound-sms-agents", flags.outboundSmsAgents]
+  ]) {
+    if (val !== void 0 && val.trim() === "") {
+      throwValidation(`${flagName} must not be empty`);
+    }
+  }
+  if (flags.inboundAgent && flags.inboundAgents) {
+    throwValidation(
+      "--inbound-agent and --inbound-agents are mutually exclusive. Use one or the other."
+    );
+  }
+  if (flags.outboundAgent && flags.outboundAgents) {
+    throwValidation(
+      "--outbound-agent and --outbound-agents are mutually exclusive. Use one or the other."
+    );
+  }
+  if (!options.allowSms && (flags.inboundSmsAgents || flags.outboundSmsAgents)) {
+    throwValidation("SMS agent flags are not supported for this command.");
+  }
+  if (flags.inboundAgent) {
+    params.inbound_agents = [{ agent_id: flags.inboundAgent, weight: 1 }];
+  } else if (flags.inboundAgents) {
+    params.inbound_agents = parseWeightedAgents(flags.inboundAgents);
+  }
+  if (flags.outboundAgent) {
+    params.outbound_agents = [{ agent_id: flags.outboundAgent, weight: 1 }];
+  } else if (flags.outboundAgents) {
+    params.outbound_agents = parseWeightedAgents(flags.outboundAgents);
+  }
+  if (flags.inboundSmsAgents) {
+    params.inbound_sms_agents = parseWeightedAgents(flags.inboundSmsAgents);
+  }
+  if (flags.outboundSmsAgents) {
+    params.outbound_sms_agents = parseWeightedAgents(flags.outboundSmsAgents);
+  }
+}
+function throwValidation(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/services/flag-guards.ts
+function requireNonEmpty(value, flagName) {
+  if (value.trim() === "") {
+    throwValidation2(`${flagName} must not be empty`);
+  }
+  return value;
+}
+function throwValidation2(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
 // src/commands/phone-numbers/import.ts
 async function importPhoneNumberCommand(options) {
   try {
-    const client = getRetellClient();
     const importParams = {
-      phone_number: options.number,
-      termination_uri: options.terminationUri
+      phone_number: requireNonEmpty(options.number, "--number"),
+      termination_uri: requireNonEmpty(
+        options.terminationUri,
+        "--termination-uri"
+      )
     };
     if (options.nickname) {
       importParams.nickname = options.nickname;
     }
-    if (options.inboundAgent) {
-      importParams.inbound_agent_id = options.inboundAgent;
-    }
-    if (options.outboundAgent) {
-      importParams.outbound_agent_id = options.outboundAgent;
-    }
+    const weightedFlags = options;
+    applyWeightedAgents(
+      importParams,
+      {
+        inboundAgent: weightedFlags.inboundAgent,
+        outboundAgent: weightedFlags.outboundAgent,
+        inboundAgents: weightedFlags.inboundAgents,
+        outboundAgents: weightedFlags.outboundAgents,
+        inboundSmsAgents: weightedFlags.inboundSmsAgents,
+        outboundSmsAgents: weightedFlags.outboundSmsAgents
+      },
+      { allowSms: false }
+    );
     if (options.sipUsername) {
       importParams.sip_trunk_auth_username = options.sipUsername;
     }
     if (options.sipPassword) {
       importParams.sip_trunk_auth_password = options.sipPassword;
     }
+    const client = getRetellClient();
     const pn = await client.phoneNumber.import(importParams);
     const output = options.fields ? filterFields(
       pn,
@@ -3880,235 +3996,1531 @@ async function importPhoneNumberCommand(options) {
   }
 }
 
-// src/index.ts
-var packageJson = JSON.parse(
-  (0, import_fs17.readFileSync)((0, import_path6.join)(__dirname, "../package.json"), "utf-8")
-);
-var program = new import_commander.Command();
-program.name("retell").description("Retell AI CLI - Manage transcripts and agent prompts").version(packageJson.version, "-v, --version", "Display version number").helpOption("-h, --help", "Display help for command").option("--json", "Output as JSON (default)", true);
-program.command("login").description("Authenticate with Retell AI").addHelpText(
-  "after",
-  `
-Examples:
-  $ retell login
-  # Enter your API key when prompted
-  # Creates .retellrc.json in current directory
-  `
-).action(async () => {
-  await loginCommand();
-});
-var transcripts = program.command("transcripts").description("Manage call transcripts");
-transcripts.command("list").description("List all call transcripts").option(
-  "-l, --limit <number>",
-  "Maximum number of calls to return (default: 50)",
-  "50"
-).option(
-  "--fields <fields>",
-  "Comma-separated list of fields to return (e.g., call_id,call_status,metadata.duration)"
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell transcripts list
-  $ retell transcripts list --limit 100
-  $ retell transcripts list --fields call_id,call_status
-  $ retell transcripts list | jq '.[] | select(.call_status == "error")'
-  `
-).action(async (options) => {
-  const limit = parseInt(options.limit, 10);
-  if (isNaN(limit) || limit < 1) {
-    console.error("Error: limit must be a positive number");
-    process.exit(1);
+// src/services/numeric-flag.ts
+function parseNumericFlag(value, flagName) {
+  if (value.trim() === "") {
+    throwValidation3(`${flagName} must be a number`);
   }
-  await listTranscriptsCommand({
-    limit,
-    fields: options.fields
-  });
-});
-transcripts.command("get <call_id>").description("Get a specific call transcript").option(
-  "--fields <fields>",
-  "Comma-separated list of fields to return (e.g., call_id,metadata.duration,analysis)"
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell transcripts get call_abc123
-  $ retell transcripts get call_abc123 --fields call_id,metadata.duration
-  $ retell transcripts get call_abc123 | jq '.transcript_object'
-  `
-).action(async (callId, options) => {
-  await getTranscriptCommand(callId, {
-    fields: options.fields
-  });
-});
-transcripts.command("analyze <call_id>").description(
-  "Analyze a call transcript with performance metrics and insights"
-).option(
-  "--fields <fields>",
-  "Comma-separated list of fields to return (e.g., call_id,performance,analysis.summary)"
-).option(
-  "--raw",
-  "Return unmodified API response instead of enriched analysis"
-).option(
-  "--hotspots-only",
-  "Return only conversation hotspots/issues for troubleshooting"
-).option(
-  "--latency-threshold <ms>",
-  `Latency threshold in ms for hotspot detection (default: ${DEFAULT_LATENCY_THRESHOLD})`,
-  String(DEFAULT_LATENCY_THRESHOLD)
-).option(
-  "--silence-threshold <ms>",
-  `Silence threshold in ms for hotspot detection (default: ${DEFAULT_SILENCE_THRESHOLD})`,
-  String(DEFAULT_SILENCE_THRESHOLD)
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell transcripts analyze call_abc123
-  $ retell transcripts analyze call_abc123 --fields call_id,performance
-  $ retell transcripts analyze call_abc123 --raw
-  $ retell transcripts analyze call_abc123 --raw --fields call_id,transcript_object
-  $ retell transcripts analyze call_abc123 --hotspots-only
-  $ retell transcripts analyze call_abc123 --hotspots-only --latency-threshold 1500
-  $ retell transcripts analyze call_abc123 --hotspots-only --fields hotspots
-  $ retell transcripts analyze call_abc123 | jq '.performance.latency_p50_ms'
-  `
-).action(async (callId, options) => {
-  await analyzeTranscriptCommand(callId, {
-    fields: options.fields,
-    raw: options.raw,
-    hotspotsOnly: options.hotspotsOnly,
-    latencyThreshold: options.latencyThreshold ? parseInt(options.latencyThreshold) : void 0,
-    silenceThreshold: options.silenceThreshold ? parseInt(options.silenceThreshold) : void 0
-  });
-});
-transcripts.command("search").description("Search transcripts with advanced filtering").option("--status <status>", "Filter by call status (error, ended, ongoing)").option("--agent-id <id>", "Filter by agent ID").option(
-  "--since <date>",
-  "Filter calls after this date (YYYY-MM-DD or ISO format)"
-).option(
-  "--until <date>",
-  "Filter calls before this date (YYYY-MM-DD or ISO format)"
-).option("--limit <number>", "Maximum number of results (default: 50)", "50").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
-  "after",
-  `
-Examples:
-  $ retell transcripts search --status error
-  $ retell transcripts search --agent-id agent_123 --since 2025-11-01
-  $ retell transcripts search --status error --limit 10
-  $ retell transcripts search --status error --fields call_id,agent_id,call_status
-  $ retell transcripts search --since 2025-11-01 --until 2025-11-15
-  `
-).action(async (options) => {
-  await searchTranscriptsCommand({
-    status: options.status,
-    agentId: options.agentId,
-    since: options.since,
-    until: options.until,
-    limit: options.limit ? Number(options.limit) : void 0,
-    fields: options.fields
-  });
-});
-var agents = program.command("agents").description("Manage agents");
-agents.command("list").description("List all agents").option(
-  "-l, --limit <number>",
-  "Maximum number of agents to return (default: 100)",
-  "100"
-).option(
-  "--fields <fields>",
-  "Comma-separated list of fields to return (e.g., agent_id,agent_name,response_engine_type)"
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell agents list
-  $ retell agents list --limit 10
-  $ retell agents list --fields agent_id,agent_name
-  $ retell agents list | jq '.[] | select(.response_engine.type == "retell-llm")'
-  `
-).action(async (options) => {
-  const limit = parseInt(options.limit, 10);
-  if (isNaN(limit) || limit < 1) {
-    console.error("Error: limit must be a positive number");
-    process.exit(1);
+  const v = Number(value);
+  if (!Number.isFinite(v)) {
+    throwValidation3(`${flagName} must be a number`);
   }
-  await listAgentsCommand({
-    limit,
-    fields: options.fields
-  });
-});
-agents.command("info <agent_id>").description("Get detailed agent information").option(
-  "--fields <fields>",
-  "Comma-separated list of fields to return (e.g., agent_name,response_engine.type,voice_config)"
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell agents info agent_123abc
-  $ retell agents info agent_123abc --fields agent_name,response_engine.type
-  $ retell agents info agent_123abc | jq '.response_engine.type'
-  `
-).action(async (agentId, options) => {
-  await agentInfoCommand(agentId, {
-    fields: options.fields
-  });
-});
-agents.command("create").description("Create a new agent").requiredOption("--voice <voice_id>", "Voice ID for the agent").option("--name <name>", "Agent name").option("--llm-id <id>", "Retell LLM ID (creates retell-llm response engine)").option(
-  "--flow-id <id>",
-  "Conversation Flow ID (creates conversation-flow response engine)"
-).option("--custom-llm <url>", "Custom LLM WebSocket URL").option(
-  "-f, --file <path>",
-  "Full agent config from JSON file (overrides other options)"
-).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
-  "after",
-  `
-Examples:
-  $ retell agents create --voice 11labs-Adrian --llm-id llm_xxx --name "Test Agent"
-  $ retell agents create --voice 11labs-Adrian --flow-id cf_xxx
-  $ retell agents create --file agent-config.json
-  `
-).action(async (options) => {
-  await createAgentCommand(options);
-});
-agents.command("delete <agent_id>").description("Delete an agent").addHelpText(
-  "after",
-  `
-Examples:
-  $ retell agents delete agent_123abc
-  `
-).action(async (agentId) => {
-  await deleteAgentCommand(agentId);
-});
-agents.command("versions <agent_id>").description("List all versions of an agent").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
-  "after",
-  `
-Examples:
-  $ retell agents versions agent_123abc
-  $ retell agents versions agent_123abc --fields version,is_published
-  `
-).action(async (agentId, options) => {
-  await agentVersionsCommand(agentId, options);
-});
-var prompts = program.command("prompts").description("Manage agent prompts");
-prompts.command("pull <agent_id>").description("Download agent prompts to a local file").option(
-  "-o, --output <path>",
-  "Output file path (default: .retell-prompts/<agent_id>.json)",
-  ".retell-prompts"
-).addHelpText(
-  "after",
-  `
-Examples:
-  $ retell prompts pull agent_123abc
-  $ retell prompts pull agent_123abc --output my-prompts.json
-  `
-).action(async (agentId, options) => {
-  await pullPromptsCommand(agentId, options);
-});
-prompts.command("diff <agent_id>").description("Show differences between local and remote prompts").option(
-  "-s, --source <path>",
-  "Source directory path (default: .retell-prompts)",
-  ".retell-prompts"
-).option("-f, --fields <fields>", "Comma-separated list of fields to return").addHelpText(
-  "after",
+  return v;
+}
+function throwValidation3(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/phone-numbers/create.ts
+var VALID_COUNTRIES = ["US", "CA"];
+var VALID_PROVIDERS = ["twilio", "telnyx"];
+var VALID_TRANSPORTS = ["TLS", "TCP", "UDP"];
+async function createPhoneNumberCommand(options = {}) {
+  try {
+    if (options.countryCode && !VALID_COUNTRIES.includes(options.countryCode)) {
+      throwValidation4(
+        `--country-code must be one of: ${VALID_COUNTRIES.join(", ")}`
+      );
+    }
+    if (options.numberProvider && !VALID_PROVIDERS.includes(options.numberProvider)) {
+      throwValidation4(
+        `--number-provider must be one of: ${VALID_PROVIDERS.join(", ")}`
+      );
+    }
+    if (options.transport && !VALID_TRANSPORTS.includes(options.transport)) {
+      throwValidation4(
+        `--transport must be one of: ${VALID_TRANSPORTS.join(", ")}`
+      );
+    }
+    const params = {};
+    if (options.countryCode)
+      params.country_code = options.countryCode;
+    if (options.areaCode !== void 0) {
+      params.area_code = parseNumericFlag(options.areaCode, "--area-code");
+    }
+    if (options.numberProvider)
+      params.number_provider = options.numberProvider;
+    if (options.tollFree !== void 0) params.toll_free = options.tollFree;
+    if (options.nickname) params.nickname = options.nickname;
+    if (options.phoneNumber) params.phone_number = options.phoneNumber;
+    if (options.fallbackNumber) params.fallback_number = options.fallbackNumber;
+    if (options.inboundWebhookUrl)
+      params.inbound_webhook_url = options.inboundWebhookUrl;
+    if (options.transport) params.transport = options.transport;
+    if (options.allowedInboundCountryList)
+      params.allowed_inbound_country_list = options.allowedInboundCountryList.split(",").map((s) => s.trim()).filter(Boolean);
+    if (options.allowedOutboundCountryList)
+      params.allowed_outbound_country_list = options.allowedOutboundCountryList.split(",").map((s) => s.trim()).filter(Boolean);
+    applyWeightedAgents(
+      params,
+      {
+        inboundAgent: options.inboundAgent,
+        outboundAgent: options.outboundAgent,
+        inboundAgents: options.inboundAgents,
+        outboundAgents: options.outboundAgents,
+        inboundSmsAgents: options.inboundSmsAgents,
+        outboundSmsAgents: options.outboundSmsAgents
+      },
+      { allowSms: false }
+    );
+    const client = getRetellClient();
+    const pn = await client.phoneNumber.create(params);
+    const output = options.fields ? filterFields(
+      pn,
+      options.fields.split(",").map((f) => f.trim())
+    ) : pn;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation4(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/phone-numbers/update.ts
+var VALID_TRANSPORTS2 = ["TLS", "TCP", "UDP"];
+async function updatePhoneNumberCommand(phoneNumber, options) {
+  try {
+    if (options.transport !== void 0 && options.transport !== "" && !VALID_TRANSPORTS2.includes(options.transport)) {
+      throwValidation5(
+        `--transport must be one of: ${VALID_TRANSPORTS2.join(", ")}`
+      );
+    }
+    const params = {};
+    if (options.nickname !== void 0)
+      params.nickname = options.nickname === "" ? null : options.nickname;
+    if (options.terminationUri !== void 0)
+      params.termination_uri = requireNonEmpty(
+        options.terminationUri,
+        "--termination-uri"
+      );
+    if (options.sipUsername !== void 0)
+      params.auth_username = requireNonEmpty(
+        options.sipUsername,
+        "--sip-username"
+      );
+    if (options.sipPassword !== void 0)
+      params.auth_password = requireNonEmpty(
+        options.sipPassword,
+        "--sip-password"
+      );
+    if (options.transport !== void 0)
+      params.transport = options.transport === "" ? null : options.transport;
+    if (options.inboundWebhookUrl !== void 0)
+      params.inbound_webhook_url = options.inboundWebhookUrl === "" ? null : options.inboundWebhookUrl;
+    if (options.inboundSmsWebhookUrl !== void 0)
+      params.inbound_sms_webhook_url = options.inboundSmsWebhookUrl === "" ? null : options.inboundSmsWebhookUrl;
+    if (options.fallbackNumber !== void 0)
+      params.fallback_number = options.fallbackNumber === "" ? null : options.fallbackNumber;
+    if (options.allowedInboundCountryList !== void 0)
+      params.allowed_inbound_country_list = options.allowedInboundCountryList === "" ? null : options.allowedInboundCountryList.split(",").map((s) => s.trim()).filter(Boolean);
+    if (options.allowedOutboundCountryList !== void 0)
+      params.allowed_outbound_country_list = options.allowedOutboundCountryList === "" ? null : options.allowedOutboundCountryList.split(",").map((s) => s.trim()).filter(Boolean);
+    applyWeightedAgents(
+      params,
+      {
+        inboundAgent: options.inboundAgent,
+        outboundAgent: options.outboundAgent,
+        inboundAgents: options.inboundAgents,
+        outboundAgents: options.outboundAgents,
+        inboundSmsAgents: options.inboundSmsAgents,
+        outboundSmsAgents: options.outboundSmsAgents
+      },
+      { allowSms: true }
+    );
+    if (Object.keys(params).length === 0) {
+      throwValidation5(
+        "No mutation flags provided. Pass at least one flag such as --nickname, --inbound-agent, --termination-uri, etc."
+      );
+    }
+    const client = getRetellClient();
+    const pn = await client.phoneNumber.update(phoneNumber, params);
+    const output = options.fields ? filterFields(
+      pn,
+      options.fields.split(",").map((f) => f.trim())
+    ) : pn;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation5(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/phone-numbers/delete.ts
+async function deletePhoneNumberCommand(phoneNumber) {
+  try {
+    const client = getRetellClient();
+    await client.phoneNumber.delete(phoneNumber);
+    outputJson({
+      message: "Phone number deleted successfully",
+      phone_number: phoneNumber,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/services/json-arg.ts
+var import_fs17 = require("fs");
+function loadJsonArg(value, flagName) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  if (value.startsWith("@")) {
+    const path = value.slice(1);
+    if (path === "") {
+      throwValidation6(`${flagName}: empty path after @`);
+    }
+    if (!(0, import_fs17.existsSync)(path)) {
+      throwValidation6(`${flagName}: file not found: ${path}`);
+    }
+    let content;
+    try {
+      content = (0, import_fs17.readFileSync)(path, "utf-8");
+    } catch (err) {
+      throwValidation6(
+        `${flagName}: failed to read ${path}: ${err.message}`
+      );
+    }
+    try {
+      return JSON.parse(content);
+    } catch (err) {
+      throwValidation6(
+        `${flagName}: invalid JSON in ${path}: ${err.message}`
+      );
+    }
+  }
+  try {
+    return JSON.parse(value);
+  } catch (err) {
+    throwValidation6(`${flagName}: invalid JSON: ${err.message}`);
+  }
+}
+function readJsonFile(path, flagName) {
+  if (!(0, import_fs17.existsSync)(path)) {
+    throwValidation6(`${flagName}: file not found: ${path}`);
+  }
+  let content;
+  try {
+    content = (0, import_fs17.readFileSync)(path, "utf-8");
+  } catch (err) {
+    throwValidation6(
+      `${flagName}: failed to read ${path}: ${err.message}`
+    );
+  }
+  try {
+    return JSON.parse(content);
+  } catch (err) {
+    throwValidation6(
+      `${flagName}: invalid JSON in ${path}: ${err.message}`
+    );
+  }
+}
+function readJsonObjectFile(path, flagName) {
+  const parsed = readJsonFile(path, flagName);
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throwValidation6(
+      `${flagName}: ${path} must contain a JSON object, not ${jsonKind(parsed)}`
+    );
+  }
+  return parsed;
+}
+function jsonKind(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "an array";
+  return `a ${typeof value}`;
+}
+function throwValidation6(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/calls/create-phone.ts
+async function createPhoneCallCommand(options) {
+  try {
+    const params = {
+      from_number: requireNonEmpty(options.fromNumber, "--from-number"),
+      to_number: requireNonEmpty(options.toNumber, "--to-number")
+    };
+    if (options.overrideAgentId)
+      params.override_agent_id = options.overrideAgentId;
+    if (options.overrideAgentVersion !== void 0) {
+      params.override_agent_version = parseNumericFlag(
+        options.overrideAgentVersion,
+        "--override-agent-version"
+      );
+    }
+    if (options.ignoreE164Validation) params.ignore_e164_validation = true;
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.retell_llm_dynamic_variables = dv;
+    const headers = loadJsonArg(
+      options.customSipHeaders,
+      "--custom-sip-headers"
+    );
+    if (headers !== void 0)
+      params.custom_sip_headers = headers;
+    if (options.agentOverride) {
+      const override = readJsonObjectFile(
+        options.agentOverride,
+        "--agent-override"
+      );
+      params.agent_override = override;
+    }
+    const client = getRetellClient();
+    const result = await client.call.createPhoneCall(params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/calls/create-web.ts
+async function createWebCallCommand(options) {
+  try {
+    const params = {
+      agent_id: requireNonEmpty(options.agentId, "--agent-id")
+    };
+    if (options.agentVersion !== void 0) {
+      params.agent_version = parseNumericFlag(
+        options.agentVersion,
+        "--agent-version"
+      );
+    }
+    if (options.currentNodeId !== void 0)
+      params.current_node_id = options.currentNodeId;
+    if (options.currentState !== void 0)
+      params.current_state = options.currentState;
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.retell_llm_dynamic_variables = dv;
+    if (options.agentOverride) {
+      const override = readJsonObjectFile(
+        options.agentOverride,
+        "--agent-override"
+      );
+      params.agent_override = override;
+    }
+    const client = getRetellClient();
+    const result = await client.call.createWebCall(params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/calls/register-phone.ts
+async function registerPhoneCallCommand(options) {
+  try {
+    if (options.direction && !["inbound", "outbound"].includes(options.direction)) {
+      throwValidation7("--direction must be 'inbound' or 'outbound'");
+    }
+    const params = {
+      agent_id: requireNonEmpty(options.agentId, "--agent-id")
+    };
+    if (options.agentVersion !== void 0) {
+      params.agent_version = parseNumericFlag(
+        options.agentVersion,
+        "--agent-version"
+      );
+    }
+    if (options.direction)
+      params.direction = options.direction;
+    if (options.fromNumber !== void 0) {
+      params.from_number = requireNonEmpty(options.fromNumber, "--from-number");
+    }
+    if (options.toNumber !== void 0) {
+      params.to_number = requireNonEmpty(options.toNumber, "--to-number");
+    }
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.retell_llm_dynamic_variables = dv;
+    const client = getRetellClient();
+    const result = await client.call.registerPhoneCall(params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation7(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/calls/update.ts
+var DATA_STORAGE_SETTINGS = [
+  "everything",
+  "everything_except_pii",
+  "basic_attributes_only"
+];
+async function updateCallCommand(callId, options) {
+  try {
+    const params = {};
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const attrs = loadJsonArg(options.customAttributes, "--custom-attributes");
+    if (attrs !== void 0)
+      params.custom_attributes = attrs;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.override_dynamic_variables = dv;
+    if (options.dataStorageSetting) {
+      if (!DATA_STORAGE_SETTINGS.includes(options.dataStorageSetting)) {
+        throwValidation8(
+          `--data-storage-setting must be one of: ${DATA_STORAGE_SETTINGS.join(", ")}`
+        );
+      }
+      params.data_storage_setting = options.dataStorageSetting;
+    }
+    if (Object.keys(params).length === 0) {
+      throwValidation8(
+        "No mutation flags provided. Pass at least one of --metadata, --custom-attributes, --dynamic-variables, --data-storage-setting."
+      );
+    }
+    const client = getRetellClient();
+    const result = await client.call.update(callId, params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation8(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/calls/delete.ts
+async function deleteCallCommand(callId) {
+  try {
+    const client = getRetellClient();
+    await client.call.delete(callId);
+    outputJson({
+      message: "Call deleted successfully",
+      call_id: callId,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/batch-calls/create.ts
+async function createBatchCallCommand(options) {
+  try {
+    const tasks = readJsonFile(options.tasks, "--tasks");
+    if (!Array.isArray(tasks)) {
+      throwValidation9("--tasks file must contain a JSON array of task objects");
+    }
+    const params = {
+      from_number: requireNonEmpty(options.fromNumber, "--from-number"),
+      tasks
+    };
+    if (options.name) params.name = options.name;
+    if (options.reservedConcurrency !== void 0) {
+      params.reserved_concurrency = parseNumericFlag(
+        options.reservedConcurrency,
+        "--reserved-concurrency"
+      );
+    }
+    if (options.triggerTimestamp !== void 0) {
+      params.trigger_timestamp = parseNumericFlag(
+        options.triggerTimestamp,
+        "--trigger-timestamp"
+      );
+    }
+    if (options.callTimeWindow) {
+      const window = readJsonObjectFile(
+        options.callTimeWindow,
+        "--call-time-window"
+      );
+      params.call_time_window = window;
+    }
+    const client = getRetellClient();
+    const result = await client.batchCall.createBatchCall(params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation9(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/llms/list.ts
+async function listLlmsCommand(options = {}) {
+  try {
+    const query = {};
+    if (options.limit !== void 0) {
+      query.limit = parseNumericFlag(options.limit, "--limit");
+    }
+    if (options.paginationKey) query.pagination_key = options.paginationKey;
+    if (options.paginationKeyVersion !== void 0) {
+      query.pagination_key_version = parseNumericFlag(
+        options.paginationKeyVersion,
+        "--pagination-key-version"
+      );
+    }
+    const client = getRetellClient();
+    const llms2 = await client.llm.list(query);
+    const output = options.fields ? filterFields(
+      llms2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : llms2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/llms/get.ts
+async function getLlmCommand(llmId, options = {}) {
+  try {
+    const query = {};
+    if (options.version !== void 0) {
+      query.version = parseNumericFlag(options.version, "--version");
+    }
+    const client = getRetellClient();
+    const llm = await client.llm.retrieve(llmId, query);
+    const output = options.fields ? filterFields(
+      llm,
+      options.fields.split(",").map((f) => f.trim())
+    ) : llm;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/llms/create.ts
+async function createLlmCommand(options = {}) {
+  try {
+    let params;
+    if (options.file) {
+      const simpleFlags = [
+        options.generalPrompt !== void 0 && "--general-prompt",
+        options.model !== void 0 && "--model",
+        options.s2sModel !== void 0 && "--s2s-model",
+        options.startSpeaker !== void 0 && "--start-speaker",
+        options.beginMessage !== void 0 && "--begin-message"
+      ].filter(Boolean);
+      if (simpleFlags.length > 0) {
+        throwValidation10(
+          `--file is mutually exclusive with ${simpleFlags.join(", ")}. Put all fields in the JSON body.`
+        );
+      }
+      params = readJsonObjectFile(
+        options.file,
+        "--file"
+      );
+    } else {
+      params = {};
+      if (options.generalPrompt !== void 0)
+        params.general_prompt = options.generalPrompt;
+      if (options.model)
+        params.model = options.model;
+      if (options.s2sModel)
+        params.s2s_model = options.s2sModel;
+      if (options.startSpeaker) {
+        if (!["user", "agent"].includes(options.startSpeaker))
+          throwValidation10("--start-speaker must be 'user' or 'agent'");
+        params.start_speaker = options.startSpeaker;
+      }
+      if (options.beginMessage !== void 0)
+        params.begin_message = options.beginMessage;
+    }
+    const client = getRetellClient();
+    const llm = await client.llm.create(params);
+    const output = options.fields ? filterFields(
+      llm,
+      options.fields.split(",").map((f) => f.trim())
+    ) : llm;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation10(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/llms/update.ts
+async function updateLlmCommand(llmId, options) {
+  try {
+    const rawBody = readJsonObjectFile(options.file, "--file");
+    if (Object.keys(rawBody).length === 0) {
+      const err = new Error(
+        "--file body is empty. Pass at least one mutation field (e.g. general_prompt, model)."
+      );
+      err.name = "ValidationError";
+      throw err;
+    }
+    const body = rawBody;
+    if (options.version !== void 0) {
+      body.query_version = parseNumericFlag(options.version, "--version");
+    }
+    const client = getRetellClient();
+    const llm = await client.llm.update(llmId, body);
+    const output = options.fields ? filterFields(
+      llm,
+      options.fields.split(",").map((f) => f.trim())
+    ) : llm;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/llms/delete.ts
+async function deleteLlmCommand(llmId) {
+  try {
+    const client = getRetellClient();
+    await client.llm.delete(llmId);
+    outputJson({
+      message: "LLM deleted successfully",
+      llm_id: llmId,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/voices/list.ts
+async function listVoicesCommand(options = {}) {
+  try {
+    const client = getRetellClient();
+    const voices2 = await client.voice.list();
+    const output = options.fields ? filterFields(
+      voices2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : voices2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/voices/get.ts
+async function getVoiceCommand(voiceId, options = {}) {
+  try {
+    const client = getRetellClient();
+    const voice = await client.voice.retrieve(voiceId);
+    const output = options.fields ? filterFields(
+      voice,
+      options.fields.split(",").map((f) => f.trim())
+    ) : voice;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/voices/add-resource.ts
+var VALID_PROVIDERS2 = [
+  "elevenlabs",
+  "cartesia",
+  "minimax",
+  "fish_audio"
+];
+async function addVoiceResourceCommand(options) {
+  try {
+    if (options.voiceProvider && !VALID_PROVIDERS2.includes(options.voiceProvider)) {
+      throwValidation11(
+        `--voice-provider must be one of: ${VALID_PROVIDERS2.join(", ")}`
+      );
+    }
+    const params = {
+      provider_voice_id: requireNonEmpty(
+        options.providerVoiceId,
+        "--provider-voice-id"
+      ),
+      voice_name: requireNonEmpty(options.voiceName, "--voice-name")
+    };
+    if (options.voiceProvider)
+      params.voice_provider = options.voiceProvider;
+    if (options.publicUserId) params.public_user_id = options.publicUserId;
+    const client = getRetellClient();
+    const voice = await client.voice.addResource(params);
+    const output = options.fields ? filterFields(
+      voice,
+      options.fields.split(",").map((f) => f.trim())
+    ) : voice;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation11(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/voices/clone.ts
+var import_fs18 = require("fs");
+var VALID_PROVIDERS3 = [
+  "elevenlabs",
+  "cartesia",
+  "minimax",
+  "fish_audio",
+  "platform"
+];
+async function cloneVoiceCommand(options) {
+  try {
+    if (!VALID_PROVIDERS3.includes(options.voiceProvider)) {
+      throwValidation12(
+        `--voice-provider must be one of: ${VALID_PROVIDERS3.join(", ")}`
+      );
+    }
+    const files = options.file ?? [];
+    if (files.length === 0) {
+      throwValidation12("at least one --file is required");
+    }
+    for (const path of files) {
+      if (!(0, import_fs18.existsSync)(path)) {
+        throwValidation12(`--file: not found: ${path}`);
+      }
+    }
+    const params = {
+      voice_name: requireNonEmpty(options.voiceName, "--voice-name"),
+      voice_provider: options.voiceProvider,
+      files: files.map((p) => (0, import_fs18.createReadStream)(p))
+    };
+    const client = getRetellClient();
+    const voice = await client.voice.clone(params);
+    const output = options.fields ? filterFields(
+      voice,
+      options.fields.split(",").map((f) => f.trim())
+    ) : voice;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation12(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/voices/search.ts
+var VALID_PROVIDERS4 = [
+  "elevenlabs",
+  "cartesia",
+  "minimax",
+  "fish_audio"
+];
+async function searchVoicesCommand(options) {
+  try {
+    if (options.voiceProvider && !VALID_PROVIDERS4.includes(options.voiceProvider)) {
+      throwValidation13(
+        `--voice-provider must be one of: ${VALID_PROVIDERS4.join(", ")}`
+      );
+    }
+    const params = {
+      search_query: requireNonEmpty(options.searchQuery, "--search-query")
+    };
+    if (options.voiceProvider) {
+      params.voice_provider = options.voiceProvider;
+    }
+    const client = getRetellClient();
+    const result = await client.voice.search(params);
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation13(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/chats/create.ts
+async function createChatCommand(options) {
+  try {
+    const params = {
+      agent_id: requireNonEmpty(options.agentId, "--agent-id")
+    };
+    if (options.agentVersion !== void 0) {
+      params.agent_version = parseNumericFlag(
+        options.agentVersion,
+        "--agent-version"
+      );
+    }
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.retell_llm_dynamic_variables = dv;
+    const client = getRetellClient();
+    const chat = await client.chat.create(params);
+    const output = options.fields ? filterFields(
+      chat,
+      options.fields.split(",").map((f) => f.trim())
+    ) : chat;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chats/get.ts
+async function getChatCommand(chatId, options = {}) {
+  try {
+    const client = getRetellClient();
+    const chat = await client.chat.retrieve(chatId);
+    const output = options.fields ? filterFields(
+      chat,
+      options.fields.split(",").map((f) => f.trim())
+    ) : chat;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chats/list.ts
+async function listChatsCommand(options = {}) {
+  try {
+    const query = {};
+    if (options.limit !== void 0) {
+      query.limit = parseNumericFlag(options.limit, "--limit");
+    }
+    if (options.paginationKey) query.pagination_key = options.paginationKey;
+    if (options.sortOrder) {
+      if (!["ascending", "descending"].includes(options.sortOrder))
+        throwValidation14("--sort-order must be 'ascending' or 'descending'");
+      query.sort_order = options.sortOrder;
+    }
+    const client = getRetellClient();
+    const chats2 = await client.chat.list(query);
+    const output = options.fields ? filterFields(
+      chats2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : chats2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation14(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/chats/update.ts
+var DATA_STORAGE_SETTINGS2 = ["everything", "basic_attributes_only"];
+async function updateChatCommand(chatId, options) {
+  try {
+    const params = {};
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const attrs = loadJsonArg(options.customAttributes, "--custom-attributes");
+    if (attrs !== void 0)
+      params.custom_attributes = attrs;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.override_dynamic_variables = dv;
+    if (options.dataStorageSetting) {
+      if (!DATA_STORAGE_SETTINGS2.includes(options.dataStorageSetting)) {
+        throwValidation15(
+          `--data-storage-setting must be one of: ${DATA_STORAGE_SETTINGS2.join(", ")}`
+        );
+      }
+      params.data_storage_setting = options.dataStorageSetting;
+    }
+    if (Object.keys(params).length === 0) {
+      throwValidation15(
+        "No mutation flags provided. Pass at least one of --metadata, --custom-attributes, --dynamic-variables, --data-storage-setting."
+      );
+    }
+    const client = getRetellClient();
+    const chat = await client.chat.update(chatId, params);
+    const output = options.fields ? filterFields(
+      chat,
+      options.fields.split(",").map((f) => f.trim())
+    ) : chat;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation15(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/chats/complete.ts
+async function chatCompleteCommand(options) {
+  try {
+    const client = getRetellClient();
+    const result = await client.chat.createChatCompletion({
+      chat_id: requireNonEmpty(options.chatId, "--chat-id"),
+      content: requireNonEmpty(options.content, "--content")
+    });
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chats/sms.ts
+async function createSmsChatCommand(options) {
+  try {
+    const params = {
+      from_number: requireNonEmpty(options.fromNumber, "--from-number"),
+      to_number: requireNonEmpty(options.toNumber, "--to-number")
+    };
+    if (options.overrideAgentId)
+      params.override_agent_id = options.overrideAgentId;
+    if (options.overrideAgentVersion !== void 0) {
+      params.override_agent_version = parseNumericFlag(
+        options.overrideAgentVersion,
+        "--override-agent-version"
+      );
+    }
+    const metadata = loadJsonArg(options.metadata, "--metadata");
+    if (metadata !== void 0) params.metadata = metadata;
+    const dv = loadJsonArg(options.dynamicVariables, "--dynamic-variables");
+    if (dv !== void 0)
+      params.retell_llm_dynamic_variables = dv;
+    const client = getRetellClient();
+    const chat = await client.chat.createSMSChat(params);
+    const output = options.fields ? filterFields(
+      chat,
+      options.fields.split(",").map((f) => f.trim())
+    ) : chat;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chats/end.ts
+async function endChatCommand(chatId) {
+  try {
+    const client = getRetellClient();
+    await client.chat.end(chatId);
+    outputJson({
+      message: "Chat ended successfully",
+      chat_id: chatId,
+      operation: "end"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/create.ts
+async function createChatAgentCommand(options = {}) {
+  try {
+    let params;
+    if (options.file) {
+      const simpleFlags = [
+        options.name !== void 0 && "--name",
+        options.llmId !== void 0 && "--llm-id",
+        options.flowId !== void 0 && "--flow-id",
+        options.customLlm !== void 0 && "--custom-llm"
+      ].filter(Boolean);
+      if (simpleFlags.length > 0) {
+        throwValidation16(
+          `--file is mutually exclusive with ${simpleFlags.join(", ")}. Put all fields in the JSON body.`
+        );
+      }
+      params = readJsonObjectFile(
+        options.file,
+        "--file"
+      );
+    } else {
+      const engineCount = [
+        options.llmId,
+        options.flowId,
+        options.customLlm
+      ].filter(Boolean).length;
+      if (engineCount === 0) {
+        throwValidation16(
+          "Must specify one of: --llm-id, --flow-id, or --custom-llm (or use --file)"
+        );
+      }
+      if (engineCount > 1) {
+        throwValidation16(
+          "Only one of --llm-id, --flow-id, or --custom-llm can be specified"
+        );
+      }
+      let responseEngine;
+      if (options.llmId) {
+        responseEngine = { type: "retell-llm", llm_id: options.llmId };
+      } else if (options.flowId) {
+        responseEngine = {
+          type: "conversation-flow",
+          conversation_flow_id: options.flowId
+        };
+      } else {
+        responseEngine = {
+          type: "custom-llm",
+          llm_websocket_url: options.customLlm
+        };
+      }
+      params = { response_engine: responseEngine };
+      if (options.name) params.agent_name = options.name;
+    }
+    const client = getRetellClient();
+    const agent2 = await client.chatAgent.create(params);
+    const output = options.fields ? filterFields(
+      agent2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : agent2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+function throwValidation16(message) {
+  const err = new Error(message);
+  err.name = "ValidationError";
+  throw err;
+}
+
+// src/commands/chat-agents/get.ts
+async function getChatAgentCommand(agentId, options = {}) {
+  try {
+    const query = {};
+    if (options.version !== void 0) {
+      query.version = parseNumericFlag(options.version, "--version");
+    }
+    const client = getRetellClient();
+    const agent2 = await client.chatAgent.retrieve(agentId, query);
+    const output = options.fields ? filterFields(
+      agent2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : agent2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/update.ts
+async function updateChatAgentCommand(agentId, options) {
+  try {
+    const rawBody = readJsonObjectFile(options.file, "--file");
+    if (Object.keys(rawBody).length === 0) {
+      const err = new Error(
+        "--file body is empty. Pass at least one mutation field (e.g. agent_name, response_engine)."
+      );
+      err.name = "ValidationError";
+      throw err;
+    }
+    const body = rawBody;
+    const client = getRetellClient();
+    const agent2 = await client.chatAgent.update(agentId, body);
+    const output = options.fields ? filterFields(
+      agent2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : agent2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/list.ts
+async function listChatAgentsCommand(options = {}) {
+  try {
+    const query = {};
+    if (options.limit !== void 0) {
+      query.limit = parseNumericFlag(options.limit, "--limit");
+    }
+    if (options.paginationKey) query.pagination_key = options.paginationKey;
+    if (options.paginationKeyVersion !== void 0) {
+      query.pagination_key_version = parseNumericFlag(
+        options.paginationKeyVersion,
+        "--pagination-key-version"
+      );
+    }
+    const client = getRetellClient();
+    const agents2 = await client.chatAgent.list(query);
+    const output = options.fields ? filterFields(
+      agents2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : agents2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/delete.ts
+async function deleteChatAgentCommand(agentId) {
+  try {
+    const client = getRetellClient();
+    await client.chatAgent.delete(agentId);
+    outputJson({
+      message: "Chat agent deleted successfully",
+      agent_id: agentId,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/versions.ts
+async function chatAgentVersionsCommand(agentId, options = {}) {
+  try {
+    const client = getRetellClient();
+    const versions = await client.chatAgent.getVersions(agentId);
+    const output = options.fields ? filterFields(
+      versions,
+      options.fields.split(",").map((f) => f.trim())
+    ) : versions;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/chat-agents/publish.ts
+async function publishChatAgentCommand(agentId) {
+  try {
+    const client = getRetellClient();
+    await client.chatAgent.publish(agentId);
+    outputJson({
+      message: "Chat agent published successfully",
+      agent_id: agentId,
+      operation: "publish"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/flow-components/list.ts
+async function listFlowComponentsCommand(options = {}) {
+  try {
+    const client = getRetellClient();
+    const items = await client.conversationFlowComponent.list();
+    const output = options.fields ? filterFields(
+      items,
+      options.fields.split(",").map((f) => f.trim())
+    ) : items;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/flow-components/get.ts
+async function getFlowComponentCommand(componentId, options = {}) {
+  try {
+    const client = getRetellClient();
+    const component = await client.conversationFlowComponent.retrieve(componentId);
+    const output = options.fields ? filterFields(
+      component,
+      options.fields.split(",").map((f) => f.trim())
+    ) : component;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/flow-components/create.ts
+async function createFlowComponentCommand(options) {
+  try {
+    const body = readJsonObjectFile(
+      options.file,
+      "--file"
+    );
+    const client = getRetellClient();
+    const component = await client.conversationFlowComponent.create(body);
+    const output = options.fields ? filterFields(
+      component,
+      options.fields.split(",").map((f) => f.trim())
+    ) : component;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/flow-components/update.ts
+async function updateFlowComponentCommand(componentId, options) {
+  try {
+    const rawBody = readJsonObjectFile(options.file, "--file");
+    if (Object.keys(rawBody).length === 0) {
+      const err = new Error(
+        "--file body is empty. Pass at least one mutation field."
+      );
+      err.name = "ValidationError";
+      throw err;
+    }
+    const body = rawBody;
+    const client = getRetellClient();
+    const component = await client.conversationFlowComponent.update(
+      componentId,
+      body
+    );
+    const output = options.fields ? filterFields(
+      component,
+      options.fields.split(",").map((f) => f.trim())
+    ) : component;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/flow-components/delete.ts
+async function deleteFlowComponentCommand(componentId) {
+  try {
+    const client = getRetellClient();
+    await client.conversationFlowComponent.delete(componentId);
+    outputJson({
+      message: "Flow component deleted successfully",
+      conversation_flow_component_id: componentId,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/concurrency/get.ts
+async function getConcurrencyCommand(options = {}) {
+  try {
+    const client = getRetellClient();
+    const result = await client.concurrency.retrieve();
+    const output = options.fields ? filterFields(
+      result,
+      options.fields.split(",").map((f) => f.trim())
+    ) : result;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/agents/mcp-tools.ts
+async function agentMcpToolsCommand(agentId, options) {
+  try {
+    const query = {
+      mcp_id: requireNonEmpty(options.mcpId, "--mcp-id")
+    };
+    if (options.componentId) query.component_id = options.componentId;
+    if (options.version !== void 0) {
+      query.version = parseNumericFlag(options.version, "--version");
+    }
+    const client = getRetellClient();
+    const tools2 = await client.mcpTool.getMcpTools(agentId, query);
+    const output = options.fields ? filterFields(
+      tools2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : tools2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/index.ts
+var packageJson = JSON.parse(
+  (0, import_fs19.readFileSync)((0, import_path6.join)(__dirname, "../package.json"), "utf-8")
+);
+function parseFlagOrExit(value, flagName) {
+  if (value === void 0) return void 0;
+  try {
+    return parseNumericFlag(value, flagName);
+  } catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+}
+var program = new import_commander.Command();
+program.name("retell").description("Retell AI CLI - Manage transcripts and agent prompts").version(packageJson.version, "-v, --version", "Display version number").helpOption("-h, --help", "Display help for command").option("--json", "Output as JSON (default)", true);
+program.command("login").description("Authenticate with Retell AI").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell login
+  # Enter your API key when prompted
+  # Creates .retellrc.json in current directory
+  `
+).action(async () => {
+  await loginCommand();
+});
+var transcripts = program.command("transcripts").description("Manage call transcripts");
+transcripts.command("list").description("List all call transcripts").option(
+  "-l, --limit <number>",
+  "Maximum number of calls to return (default: 50)",
+  "50"
+).option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., call_id,call_status,metadata.duration)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell transcripts list
+  $ retell transcripts list --limit 100
+  $ retell transcripts list --fields call_id,call_status
+  $ retell transcripts list | jq '.[] | select(.call_status == "error")'
+  `
+).action(async (options) => {
+  const limit = parseFlagOrExit(options.limit, "--limit") ?? 50;
+  if (limit < 1) {
+    console.error("Error: --limit must be a positive number");
+    process.exit(1);
+  }
+  await listTranscriptsCommand({
+    limit,
+    fields: options.fields
+  });
+});
+transcripts.command("get <call_id>").description("Get a specific call transcript").option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., call_id,metadata.duration,analysis)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell transcripts get call_abc123
+  $ retell transcripts get call_abc123 --fields call_id,metadata.duration
+  $ retell transcripts get call_abc123 | jq '.transcript_object'
+  `
+).action(async (callId, options) => {
+  await getTranscriptCommand(callId, {
+    fields: options.fields
+  });
+});
+transcripts.command("analyze <call_id>").description(
+  "Analyze a call transcript with performance metrics and insights"
+).option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., call_id,performance,analysis.summary)"
+).option(
+  "--raw",
+  "Return unmodified API response instead of enriched analysis"
+).option(
+  "--hotspots-only",
+  "Return only conversation hotspots/issues for troubleshooting"
+).option(
+  "--latency-threshold <ms>",
+  `Latency threshold in ms for hotspot detection (default: ${DEFAULT_LATENCY_THRESHOLD})`,
+  String(DEFAULT_LATENCY_THRESHOLD)
+).option(
+  "--silence-threshold <ms>",
+  `Silence threshold in ms for hotspot detection (default: ${DEFAULT_SILENCE_THRESHOLD})`,
+  String(DEFAULT_SILENCE_THRESHOLD)
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell transcripts analyze call_abc123
+  $ retell transcripts analyze call_abc123 --fields call_id,performance
+  $ retell transcripts analyze call_abc123 --raw
+  $ retell transcripts analyze call_abc123 --raw --fields call_id,transcript_object
+  $ retell transcripts analyze call_abc123 --hotspots-only
+  $ retell transcripts analyze call_abc123 --hotspots-only --latency-threshold 1500
+  $ retell transcripts analyze call_abc123 --hotspots-only --fields hotspots
+  $ retell transcripts analyze call_abc123 | jq '.performance.latency_p50_ms'
+  `
+).action(async (callId, options) => {
+  await analyzeTranscriptCommand(callId, {
+    fields: options.fields,
+    raw: options.raw,
+    hotspotsOnly: options.hotspotsOnly,
+    latencyThreshold: parseFlagOrExit(
+      options.latencyThreshold,
+      "--latency-threshold"
+    ),
+    silenceThreshold: parseFlagOrExit(
+      options.silenceThreshold,
+      "--silence-threshold"
+    )
+  });
+});
+transcripts.command("search").description("Search transcripts with advanced filtering").option("--status <status>", "Filter by call status (error, ended, ongoing)").option("--agent-id <id>", "Filter by agent ID").option(
+  "--since <date>",
+  "Filter calls after this date (YYYY-MM-DD or ISO format)"
+).option(
+  "--until <date>",
+  "Filter calls before this date (YYYY-MM-DD or ISO format)"
+).option("--limit <number>", "Maximum number of results (default: 50)", "50").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell transcripts search --status error
+  $ retell transcripts search --agent-id agent_123 --since 2025-11-01
+  $ retell transcripts search --status error --limit 10
+  $ retell transcripts search --status error --fields call_id,agent_id,call_status
+  $ retell transcripts search --since 2025-11-01 --until 2025-11-15
+  `
+).action(async (options) => {
+  await searchTranscriptsCommand({
+    status: options.status,
+    agentId: options.agentId,
+    since: options.since,
+    until: options.until,
+    limit: parseFlagOrExit(options.limit, "--limit"),
+    fields: options.fields
+  });
+});
+var agents = program.command("agents").description("Manage agents");
+agents.command("list").description("List all agents").option(
+  "-l, --limit <number>",
+  "Maximum number of agents to return (default: 100)",
+  "100"
+).option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., agent_id,agent_name,response_engine_type)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agents list
+  $ retell agents list --limit 10
+  $ retell agents list --fields agent_id,agent_name
+  $ retell agents list | jq '.[] | select(.response_engine.type == "retell-llm")'
+  `
+).action(async (options) => {
+  const limit = parseFlagOrExit(options.limit, "--limit") ?? 50;
+  if (limit < 1) {
+    console.error("Error: --limit must be a positive number");
+    process.exit(1);
+  }
+  await listAgentsCommand({
+    limit,
+    fields: options.fields
+  });
+});
+agents.command("info <agent_id>").description("Get detailed agent information").option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., agent_name,response_engine.type,voice_config)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agents info agent_123abc
+  $ retell agents info agent_123abc --fields agent_name,response_engine.type
+  $ retell agents info agent_123abc | jq '.response_engine.type'
+  `
+).action(async (agentId, options) => {
+  await agentInfoCommand(agentId, {
+    fields: options.fields
+  });
+});
+agents.command("create").description("Create a new agent").requiredOption("--voice <voice_id>", "Voice ID for the agent").option("--name <name>", "Agent name").option("--llm-id <id>", "Retell LLM ID (creates retell-llm response engine)").option(
+  "--flow-id <id>",
+  "Conversation Flow ID (creates conversation-flow response engine)"
+).option("--custom-llm <url>", "Custom LLM WebSocket URL").option(
+  "-f, --file <path>",
+  "Full agent config from JSON file (overrides other options)"
+).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agents create --voice 11labs-Adrian --llm-id llm_xxx --name "Test Agent"
+  $ retell agents create --voice 11labs-Adrian --flow-id cf_xxx
+  $ retell agents create --file agent-config.json
+  `
+).action(async (options) => {
+  await createAgentCommand(options);
+});
+agents.command("delete <agent_id>").description("Delete an agent").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agents delete agent_123abc
+  `
+).action(async (agentId) => {
+  await deleteAgentCommand(agentId);
+});
+agents.command("versions <agent_id>").description("List all versions of an agent").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agents versions agent_123abc
+  $ retell agents versions agent_123abc --fields version,is_published
+  `
+).action(async (agentId, options) => {
+  await agentVersionsCommand(agentId, options);
+});
+var prompts = program.command("prompts").description("Manage agent prompts");
+prompts.command("pull <agent_id>").description("Download agent prompts to a local file").option(
+  "-o, --output <path>",
+  "Output file path (default: .retell-prompts/<agent_id>.json)",
+  ".retell-prompts"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell prompts pull agent_123abc
+  $ retell prompts pull agent_123abc --output my-prompts.json
+  `
+).action(async (agentId, options) => {
+  await pullPromptsCommand(agentId, options);
+});
+prompts.command("diff <agent_id>").description("Show differences between local and remote prompts").option(
+  "-s, --source <path>",
+  "Source directory path (default: .retell-prompts)",
+  ".retell-prompts"
+).option("-f, --fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
   `
 Examples:
   $ retell prompts diff agent_123abc
@@ -4163,7 +5575,7 @@ Examples:
   `
 ).action(async (agentId, options) => {
   await getAgentCommand(agentId, {
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0,
+    version: parseFlagOrExit(options.engineVersion, "--engine-version"),
     fields: options.fields
   });
 });
@@ -4202,7 +5614,7 @@ Note: Run 'retell agent-publish <agent_id>' after updating to publish changes.
   await updateAgentCommand(agentId, {
     file: options.file,
     dryRun: options.dryRun,
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0
+    version: parseFlagOrExit(options.engineVersion, "--engine-version")
   });
 });
 var tools = program.command("tools").description("Manage agent tools (custom functions, webhooks, etc.)");
@@ -4399,7 +5811,7 @@ Test case JSON format:
     file: options.file,
     llmId: options.llmId,
     flowId: options.flowId,
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0
+    version: parseFlagOrExit(options.engineVersion, "--engine-version")
   });
 });
 testsCases.command("update <test_case_definition_id>").description("Update an existing test case definition from a JSON file").requiredOption(
@@ -4477,7 +5889,7 @@ Examples:
     llmId: options.llmId,
     flowId: options.flowId,
     cases: options.cases,
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0
+    version: parseFlagOrExit(options.engineVersion, "--engine-version")
   });
 });
 var testsRuns = tests.command("runs").description("View test run results");
@@ -4609,10 +6021,10 @@ Examples:
   $ retell flows list --fields conversation_flow_id,version,start_speaker
   `
 ).action(async (options) => {
-  const limit = parseInt(options.limit, 10);
-  if (isNaN(limit) || limit < 1 || limit > 1e3) {
+  const limit = parseFlagOrExit(options.limit, "--limit") ?? 50;
+  if (limit < 1 || limit > 1e3) {
     console.error(
-      "Error: limit must be a positive number between 1 and 1000"
+      "Error: --limit must be a positive number between 1 and 1000"
     );
     process.exit(1);
   }
@@ -4634,7 +6046,7 @@ Examples:
   `
 ).action(async (conversationFlowId, options) => {
   await getFlowCommand(conversationFlowId, {
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0,
+    version: parseFlagOrExit(options.engineVersion, "--engine-version"),
     fields: options.fields
   });
 });
@@ -4676,7 +6088,7 @@ Examples:
 ).action(async (conversationFlowId, options) => {
   await updateFlowCommand(conversationFlowId, {
     file: options.file,
-    version: options.engineVersion ? parseInt(options.engineVersion, 10) : void 0
+    version: parseFlagOrExit(options.engineVersion, "--engine-version")
   });
 });
 flows.command("delete <conversation_flow_id>").description("Delete a conversation flow").addHelpText(
@@ -4694,7 +6106,7 @@ phoneNumbers.command("list").description("List all phone numbers").option("--fie
   `
 Examples:
   $ retell phone-numbers list
-  $ retell phone-numbers list --fields phone_number,nickname,inbound_agent_id
+  $ retell phone-numbers list --fields phone_number,nickname,inbound_agents
   `
 ).action(async (options) => {
   await listPhoneNumbersCommand(options);
@@ -4704,22 +6116,353 @@ phoneNumbers.command("get <phone_number>").description("Get phone number details
   `
 Examples:
   $ retell phone-numbers get +14157774444
-  $ retell phone-numbers get +14157774444 --fields phone_number,inbound_agent_id
+  $ retell phone-numbers get +14157774444 --fields phone_number,inbound_agents
   `
 ).action(async (phoneNumber, options) => {
   await getPhoneNumberCommand(phoneNumber, options);
 });
-phoneNumbers.command("import").description("Import a phone number from custom telephony").requiredOption("--number <number>", "Phone number in E.164 format").requiredOption("--termination-uri <uri>", "SIP trunk termination URI").option("--nickname <name>", "Friendly name for reference").option("--inbound-agent <id>", "Agent ID for inbound calls").option("--outbound-agent <id>", "Agent ID for outbound calls").option("--sip-username <user>", "SIP trunk auth username").option("--sip-password <pass>", "SIP trunk auth password").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+phoneNumbers.command("import").description("Import a phone number from custom telephony").requiredOption("--number <number>", "Phone number in E.164 format").requiredOption("--termination-uri <uri>", "SIP trunk termination URI").option("--nickname <name>", "Friendly name for reference").option(
+  "--inbound-agent <id>",
+  "Single agent for inbound calls (shorthand for weight 1)"
+).option(
+  "--outbound-agent <id>",
+  "Single agent for outbound calls (shorthand for weight 1)"
+).option(
+  "--inbound-agents <spec>",
+  "Weighted inbound agents (format: id:weight,id:weight)"
+).option(
+  "--outbound-agents <spec>",
+  "Weighted outbound agents (format: id:weight,id:weight)"
+).option("--sip-username <user>", "SIP trunk auth username").option("--sip-password <pass>", "SIP trunk auth password").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
   "after",
   `
 Examples:
   $ retell phone-numbers import --number +14157774444 --termination-uri someuri.pstn.twilio.com
   $ retell phone-numbers import --number +14157774444 --termination-uri someuri.pstn.twilio.com --nickname "Support Line"
   $ retell phone-numbers import --number +14157774444 --termination-uri someuri.pstn.twilio.com --inbound-agent agent_xxx
+  $ retell phone-numbers import --number +14157774444 --termination-uri someuri.pstn.twilio.com --inbound-agents "agent_1:0.6,agent_2:0.4"
+
+SMS agent bindings are not supported on import. Use \`phone-numbers update\` after import to bind SMS agents.
   `
 ).action(async (options) => {
   await importPhoneNumberCommand(options);
 });
+phoneNumbers.command("create").description("Purchase a new phone number and bind agents").option("--country-code <code>", "Country code: US or CA").option("--area-code <code>", "3-digit US area code").option("--number-provider <provider>", "twilio or telnyx").option("--toll-free", "Purchase a toll-free number").option("--nickname <name>", "Friendly name for reference").option("--phone-number <number>", "Specific E.164 number to purchase").option(
+  "--fallback-number <number>",
+  "Enterprise: fallback destination during outage"
+).option("--inbound-webhook-url <url>", "Inbound call webhook URL").option("--transport <proto>", "SIP transport: TLS, TCP, or UDP").option(
+  "--inbound-agent <id>",
+  "Single inbound agent (shorthand for weight 1)"
+).option(
+  "--outbound-agent <id>",
+  "Single outbound agent (shorthand for weight 1)"
+).option(
+  "--inbound-agents <spec>",
+  "Weighted inbound agents (format: id:weight,id:weight)"
+).option(
+  "--outbound-agents <spec>",
+  "Weighted outbound agents (format: id:weight,id:weight)"
+).option(
+  "--allowed-inbound-country-list <csv>",
+  "Comma-separated ISO-2 country codes"
+).option(
+  "--allowed-outbound-country-list <csv>",
+  "Comma-separated ISO-2 country codes"
+).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell phone-numbers create --area-code 415 --nickname "Frontdesk"
+  $ retell phone-numbers create --country-code US --toll-free --inbound-agent agent_xxx
+    `
+).action(async (options) => {
+  await createPhoneNumberCommand(options);
+});
+phoneNumbers.command("update <phone_number>").description("Update agents and settings bound to a phone number").option(
+  "--nickname <name>",
+  "Friendly name for reference (use empty string to clear)"
+).option(
+  "--termination-uri <uri>",
+  "SIP trunk termination URI (custom telephony)"
+).option("--sip-username <user>", "SIP trunk auth username").option("--sip-password <pass>", "SIP trunk auth password").option(
+  "--transport <proto>",
+  "SIP transport: TLS, TCP, or UDP (use empty string to clear)"
+).option(
+  "--inbound-webhook-url <url>",
+  "Inbound call webhook URL (use empty string to clear)"
+).option(
+  "--inbound-sms-webhook-url <url>",
+  "Inbound SMS webhook URL (use empty string to clear)"
+).option(
+  "--fallback-number <number>",
+  "Enterprise: fallback destination during outage (use empty string to clear)"
+).option(
+  "--allowed-inbound-country-list <csv>",
+  "Comma-separated ISO-2 country codes (use empty string to clear)"
+).option(
+  "--allowed-outbound-country-list <csv>",
+  "Comma-separated ISO-2 country codes (use empty string to clear)"
+).option(
+  "--inbound-agent <id>",
+  "Single inbound agent (shorthand for weight 1)"
+).option(
+  "--outbound-agent <id>",
+  "Single outbound agent (shorthand for weight 1)"
+).option(
+  "--inbound-agents <spec>",
+  "Weighted inbound agents (format: id:weight,id:weight)"
+).option(
+  "--outbound-agents <spec>",
+  "Weighted outbound agents (format: id:weight,id:weight)"
+).option("--inbound-sms-agents <spec>", "Weighted inbound SMS agents").option("--outbound-sms-agents <spec>", "Weighted outbound SMS agents").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell phone-numbers update +14157774444 --inbound-agent agent_new
+  $ retell phone-numbers update +14157774444 --inbound-agents "a:0.7,b:0.3" --nickname Support
+  $ retell phone-numbers update +14157774444 --fallback-number "" (clear)
+    `
+).action(async (phoneNumber, options) => {
+  await updatePhoneNumberCommand(phoneNumber, options);
+});
+phoneNumbers.command("delete <phone_number>").description("Release an existing phone number").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell phone-numbers delete +14157774444
+    `
+).action(async (phoneNumber) => {
+  await deletePhoneNumberCommand(phoneNumber);
+});
+var calls = program.command("calls").description("Create and manage calls (list/get are under `transcripts`)");
+calls.command("create-phone").description("Create a new outbound phone call").requiredOption("--from-number <number>", "Caller number in E.164 format").requiredOption("--to-number <number>", "Callee number in E.164 format").option("--override-agent-id <id>", "One-time agent override for this call").option(
+  "--override-agent-version <n>",
+  "Override agent version for this call"
+).option("--metadata <json>", "Inline JSON or @path for call metadata").option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path for dynamic variables"
+).option(
+  "--custom-sip-headers <json>",
+  "Inline JSON or @path for custom SIP headers"
+).option(
+  "--agent-override <path>",
+  "Path to JSON file with agent_override block"
+).option(
+  "--ignore-e164-validation",
+  "Skip E.164 validation for from-number (custom telephony)"
+).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell calls create-phone --from-number +14157774444 --to-number +12137774445
+  $ retell calls create-phone --from-number +1 --to-number +1 --metadata '{"customer_id":"c_1"}'
+    `
+).action(async (options) => {
+  await createPhoneCallCommand(options);
+});
+calls.command("create-web").description("Create a new web call for a browser-based agent").requiredOption("--agent-id <id>", "Agent to use for this web call").option("--agent-version <n>", "Specific agent version").option("--metadata <json>", "Inline JSON or @path for call metadata").option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path for dynamic variables"
+).option(
+  "--agent-override <path>",
+  "Path to JSON file with agent_override block"
+).option("--current-node-id <id>", "Start at this conversation-flow node").option("--current-state <name>", "Start at this Retell-LLM state").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createWebCallCommand(options);
+});
+calls.command("register-phone").description("Register a phone call for custom telephony (you dial)").requiredOption("--agent-id <id>", "Agent to use for this call").option("--agent-version <n>", "Specific agent version").option("--direction <dir>", "inbound or outbound").option("--from-number <n>", "Tracking from-number").option("--to-number <n>", "Tracking to-number").option("--metadata <json>", "Inline JSON or @path for call metadata").option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path for dynamic variables"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await registerPhoneCallCommand(options);
+});
+calls.command("update <call_id>").description("Update metadata and storage settings on an existing call").option("--metadata <json>", "Inline JSON or @path for call metadata").option(
+  "--custom-attributes <json>",
+  "Inline JSON or @path for custom attributes"
+).option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path overriding dynamic variables"
+).option(
+  "--data-storage-setting <value>",
+  "everything | everything_except_pii | basic_attributes_only"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (callId, options) => {
+  await updateCallCommand(callId, options);
+});
+calls.command("delete <call_id>").description("Delete a call and its associated data").action(async (callId) => {
+  await deleteCallCommand(callId);
+});
+var batchCalls = program.command("batch-calls").description("Schedule bulk outbound calls");
+batchCalls.command("create").description("Create a new batch call").requiredOption("--from-number <number>", "Caller number in E.164 format").requiredOption(
+  "--tasks <path>",
+  "Path to JSON array of task objects ({to_number, ...})"
+).option("--name <name>", "Friendly name for your reference").option(
+  "--reserved-concurrency <n>",
+  "Concurrency reserved for non-batch calls"
+).option("--trigger-timestamp <ms>", "Scheduled send time (unix ms)").option(
+  "--call-time-window <path>",
+  "Path to JSON file with call_time_window object"
+).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell batch-calls create --from-number +14157774444 --tasks tasks.json
+  $ retell batch-calls create --from-number +1 --tasks tasks.json --name "Outreach Apr"
+    `
+).action(async (options) => {
+  await createBatchCallCommand(options);
+});
+var llms = program.command("llms").description("Manage Retell LLM response engines");
+llms.command("list").description("List Retell LLMs").option("-l, --limit <n>", "Maximum number to return").option("--pagination-key <key>", "LLM id to start from").option(
+  "--pagination-key-version <n>",
+  "Version paired with --pagination-key"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await listLlmsCommand(options);
+});
+llms.command("get <llm_id>").description("Get a specific Retell LLM").option("--version <n>", "Specific version to retrieve (defaults to latest)").option("--fields <fields>", "Comma-separated list of fields to return").action(async (llmId, options) => {
+  await getLlmCommand(llmId, options);
+});
+llms.command("create").description("Create a new Retell LLM (simple flags or full --file)").option("-f, --file <path>", "Path to JSON file with the full LLM body").option("--general-prompt <text>", "General system prompt").option("--model <model>", "Text LLM model (e.g. gpt-4.1)").option("--s2s-model <model>", "Speech-to-speech model").option("--start-speaker <who>", "'user' or 'agent'").option("--begin-message <msg>", "First agent utterance").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createLlmCommand(options);
+});
+llms.command("update <llm_id>").description("Update a Retell LLM (body via --file)").requiredOption("-f, --file <path>", "Path to JSON file with LLM update body").option("--version <n>", "Specific version to update").option("--fields <fields>", "Comma-separated list of fields to return").action(async (llmId, options) => {
+  await updateLlmCommand(llmId, options);
+});
+llms.command("delete <llm_id>").description("Delete a Retell LLM").action(async (llmId) => {
+  await deleteLlmCommand(llmId);
+});
+var voices = program.command("voices").description("Manage and search voice resources");
+voices.command("list").description("List all voices available to this account").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await listVoicesCommand(options);
+});
+voices.command("get <voice_id>").description("Get a specific voice").option("--fields <fields>", "Comma-separated list of fields to return").action(async (voiceId, options) => {
+  await getVoiceCommand(voiceId, options);
+});
+voices.command("add-resource").description("Add a community voice to the account's library").requiredOption(
+  "--provider-voice-id <id>",
+  "Voice id assigned by the provider"
+).requiredOption("--voice-name <name>", "Custom name for the voice").option(
+  "--voice-provider <p>",
+  "elevenlabs, cartesia, minimax, or fish_audio"
+).option(
+  "--public-user-id <id>",
+  "ElevenLabs only: public user id of the owner"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await addVoiceResourceCommand(options);
+});
+voices.command("clone").description("Clone a voice from one or more audio files").requiredOption("--voice-name <name>", "Name for the cloned voice").requiredOption(
+  "--voice-provider <p>",
+  "elevenlabs, cartesia, minimax, fish_audio, or platform"
+).option(
+  "--file <path>",
+  "Audio file to use for cloning (repeat for multiple files)",
+  (value, previous = []) => [...previous, value],
+  []
+).option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell voices clone --voice-name "Dev Clone" --voice-provider elevenlabs --file sample.wav
+  $ retell voices clone --voice-name "Multi" --voice-provider elevenlabs --file one.wav --file two.wav
+    `
+).action(async (options) => {
+  await cloneVoiceCommand(options);
+});
+voices.command("search").description("Search community voices from a provider").requiredOption(
+  "--search-query <query>",
+  "Search query (name, description, or id)"
+).option(
+  "--voice-provider <p>",
+  "elevenlabs, cartesia, minimax, or fish_audio"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await searchVoicesCommand(options);
+});
+var chats = program.command("chats").description("Manage chat sessions with chat agents");
+chats.command("create").description("Start a new chat session").requiredOption("--agent-id <id>", "Chat agent id").option("--agent-version <n>", "Specific chat agent version").option("--metadata <json>", "Inline JSON or @path for chat metadata").option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path for dynamic variables"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createChatCommand(options);
+});
+chats.command("get <chat_id>").description("Get a chat by id").option("--fields <fields>", "Comma-separated list of fields to return").action(async (chatId, options) => {
+  await getChatCommand(chatId, options);
+});
+chats.command("list").description("List chats").option("-l, --limit <n>", "Maximum number to return").option("--pagination-key <key>", "Chat id to start from").option("--sort-order <order>", "ascending or descending").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await listChatsCommand(options);
+});
+chats.command("update <chat_id>").description("Update metadata and storage settings on a chat").option("--metadata <json>", "Inline JSON or @path for chat metadata").option(
+  "--custom-attributes <json>",
+  "Inline JSON or @path for custom attributes"
+).option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path overriding dynamic variables"
+).option(
+  "--data-storage-setting <value>",
+  "everything | basic_attributes_only"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (chatId, options) => {
+  await updateChatCommand(chatId, options);
+});
+chats.command("complete").description("Send a user message and get the agent's completion").requiredOption("--chat-id <id>", "Chat id").requiredOption("--content <text>", "User message content").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await chatCompleteCommand(options);
+});
+chats.command("sms").description("Create an SMS-backed chat session").requiredOption(
+  "--from-number <number>",
+  "Sender number (must be SMS-capable)"
+).requiredOption("--to-number <number>", "Recipient number").option("--override-agent-id <id>", "One-time agent override").option("--override-agent-version <n>", "Override agent version").option("--metadata <json>", "Inline JSON or @path for chat metadata").option(
+  "--dynamic-variables <json>",
+  "Inline JSON or @path for dynamic variables"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createSmsChatCommand(options);
+});
+chats.command("end <chat_id>").description("End an active chat session").action(async (chatId) => {
+  await endChatCommand(chatId);
+});
+var chatAgents = program.command("chat-agents").description("Manage chat agents (text/SMS mode)");
+chatAgents.command("list").description("List chat agents").option("-l, --limit <n>", "Maximum number to return").option("--pagination-key <key>", "Chat agent id to start from").option(
+  "--pagination-key-version <n>",
+  "Version paired with --pagination-key"
+).option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await listChatAgentsCommand(options);
+});
+chatAgents.command("get <agent_id>").description("Get a chat agent").option("--version <n>", "Specific version to retrieve").option("--fields <fields>", "Comma-separated list of fields to return").action(async (agentId, options) => {
+  await getChatAgentCommand(agentId, options);
+});
+chatAgents.command("create").description("Create a new chat agent").option("-f, --file <path>", "Path to JSON file with full agent body").option("--name <name>", "Agent name").option("--llm-id <id>", "Attach a retell-llm response engine").option("--flow-id <id>", "Attach a conversation-flow response engine").option("--custom-llm <url>", "Custom-LLM websocket URL").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createChatAgentCommand(options);
+});
+chatAgents.command("update <agent_id>").description("Update a chat agent (body via --file)").requiredOption("-f, --file <path>", "Path to JSON file with update body").option("--fields <fields>", "Comma-separated list of fields to return").action(async (agentId, options) => {
+  await updateChatAgentCommand(agentId, options);
+});
+chatAgents.command("delete <agent_id>").description("Delete a chat agent").action(async (agentId) => {
+  await deleteChatAgentCommand(agentId);
+});
+chatAgents.command("versions <agent_id>").description("List all versions of a chat agent").option("--fields <fields>", "Comma-separated list of fields to return").action(async (agentId, options) => {
+  await chatAgentVersionsCommand(agentId, options);
+});
+chatAgents.command("publish <agent_id>").description("Publish the draft configuration of a chat agent").action(async (agentId) => {
+  await publishChatAgentCommand(agentId);
+});
+var flowComponents = program.command("flow-components").description("Manage reusable conversation-flow components");
+flowComponents.command("list").description("List flow components").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await listFlowComponentsCommand(options);
+});
+flowComponents.command("get <component_id>").description("Get a flow component").option("--fields <fields>", "Comma-separated list of fields to return").action(async (componentId, options) => {
+  await getFlowComponentCommand(componentId, options);
+});
+flowComponents.command("create").description("Create a new flow component (body via --file)").requiredOption("-f, --file <path>", "Path to JSON file with the full body").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await createFlowComponentCommand(options);
+});
+flowComponents.command("update <component_id>").description("Update a flow component (body via --file)").requiredOption("-f, --file <path>", "Path to JSON file with update body").option("--fields <fields>", "Comma-separated list of fields to return").action(async (componentId, options) => {
+  await updateFlowComponentCommand(componentId, options);
+});
+flowComponents.command("delete <component_id>").description("Delete a flow component").action(async (componentId) => {
+  await deleteFlowComponentCommand(componentId);
+});
+var concurrency = program.command("concurrency").description("View the org's call concurrency and limits");
+concurrency.command("get").description("Get current call concurrency and limits").option("--fields <fields>", "Comma-separated list of fields to return").action(async (options) => {
+  await getConcurrencyCommand(options);
+});
+program.commands.find((c) => c.name() === "agents").command("mcp-tools <agent_id>").description("List the MCP tools available to an agent").requiredOption("--mcp-id <id>", "ID of the MCP server").option("--component-id <id>", "Component id (if MCP is under a component)").option("--version <n>", "Agent version (defaults to latest)").option("--fields <fields>", "Comma-separated list of fields to return").action(async (agentId, options) => {
+  await agentMcpToolsCommand(agentId, options);
+});
 program.parse(process.argv);
 if (!process.argv.slice(2).length) {
   program.outputHelp();