retell-cli 1.4.1 → 1.5.0

package/README.md

@@ -364,7 +364,7 @@ Manage agent-level settings that aren't part of prompts (voice, webhooks, post-c
 Get agent configuration including all agent-level settings.
 
 **Options:**
-- `--version <number>` - Specific version to retrieve (defaults to latest)
+- `--engine-version <number>` - Specific version to retrieve (defaults to latest)
 - `--fields <fields>` - Comma-separated list of fields to return
 
 **Examples:**
@@ -373,7 +373,7 @@ Get agent configuration including all agent-level settings.
 retell agent get agent_123abc
 
 # Get specific version
-retell agent get agent_123abc --version 2
+retell agent get agent_123abc --engine-version 2
 
 # Get specific fields only
 retell agent get agent_123abc --fields agent_name,post_call_analysis_data
@@ -394,7 +394,7 @@ Update agent configuration from a JSON file. This is useful for updating agent-l
 **Options:**
 - `-f, --file <path>` - Path to JSON file containing agent configuration updates (required)
 - `--dry-run` - Preview changes without applying them
-- `--version <number>` - Specific version to update (defaults to latest draft)
+- `--engine-version <number>` - Specific version to update (defaults to latest draft)
 
 **Example JSON for post-call analysis:**
 ```json

package/dist/index.js

@@ -3641,8 +3641,8 @@ async function deleteKnowledgeBaseSourceCommand(knowledgeBaseId, sourceId) {
   try {
     const client = getRetellClient();
     const knowledgeBase = await client.knowledgeBase.deleteSource(
-      knowledgeBaseId,
-      sourceId
+      sourceId,
+      { knowledge_base_id: knowledgeBaseId }
     );
     const output = {
       message: "Source deleted successfully",
@@ -3818,8 +3818,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,
@@ -3847,7 +3847,59 @@ async function getPhoneNumberCommand(phoneNumber, options = {}) {
 }
 
 // src/commands/phone-numbers/import.ts
+function parseWeightedAgents(spec) {
+  const entries = spec.split(",").map((s) => s.trim()).filter(Boolean);
+  if (entries.length === 0) {
+    throw new Error("Empty agent spec. Provide at least one agent ID.");
+  }
+  const agents2 = entries.map((entry) => {
+    const parts = entry.split(":");
+    if (parts.length === 1) {
+      return { agent_id: parts[0], weight: -1 };
+    }
+    if (parts.length === 2) {
+      const weight = Number(parts[1]);
+      if (isNaN(weight) || weight <= 0 || weight > 1) {
+        throw new Error(
+          `Invalid weight "${parts[1]}" for agent "${parts[0]}". Weight must be a number between 0 (exclusive) and 1 (inclusive).`
+        );
+      }
+      return { agent_id: parts[0], weight };
+    }
+    throw new Error(`Invalid agent spec "${entry}". Expected format: agent_id or agent_id: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)) {
+    throw new Error(
+      "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) {
+    throw new Error(
+      `Agent weights must sum to 1.0, but got ${sum.toFixed(4)}.`
+    );
+  }
+  return agents2;
+}
 async function importPhoneNumberCommand(options) {
+  if (options.inboundAgent && options.inboundAgents) {
+    process.stderr.write(
+      "Error: --inbound-agent and --inbound-agents are mutually exclusive. Use one or the other.\n"
+    );
+    process.exit(1);
+    return;
+  }
+  if (options.outboundAgent && options.outboundAgents) {
+    process.stderr.write(
+      "Error: --outbound-agent and --outbound-agents are mutually exclusive. Use one or the other.\n"
+    );
+    process.exit(1);
+    return;
+  }
   try {
     const client = getRetellClient();
     const importParams = {
@@ -3858,10 +3910,26 @@ async function importPhoneNumberCommand(options) {
       importParams.nickname = options.nickname;
     }
     if (options.inboundAgent) {
-      importParams.inbound_agent_id = options.inboundAgent;
+      importParams.inbound_agents = [
+        { agent_id: options.inboundAgent, weight: 1 }
+      ];
+    } else if (options.inboundAgents) {
+      importParams.inbound_agents = parseWeightedAgents(options.inboundAgents);
     }
     if (options.outboundAgent) {
-      importParams.outbound_agent_id = options.outboundAgent;
+      importParams.outbound_agents = [
+        { agent_id: options.outboundAgent, weight: 1 }
+      ];
+    } else if (options.outboundAgents) {
+      importParams.outbound_agents = parseWeightedAgents(
+        options.outboundAgents
+      );
+    }
+    if (options.inboundSmsAgents) {
+      importParams.inbound_sms_agents = parseWeightedAgents(options.inboundSmsAgents);
+    }
+    if (options.outboundSmsAgents) {
+      importParams.outbound_sms_agents = parseWeightedAgents(options.outboundSmsAgents);
     }
     if (options.sipUsername) {
       importParams.sip_trunk_auth_username = options.sipUsername;
@@ -4694,7 +4762,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,18 +4772,19 @@ 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("--inbound-sms-agents <spec>", "Weighted inbound SMS agents (format: id:weight,id:weight)").option("--outbound-sms-agents <spec>", "Weighted outbound SMS 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"
   `
 ).action(async (options) => {
   await importPhoneNumberCommand(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retell-cli",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Community CLI for Retell AI - efficient access to transcripts, agents, and prompts for AI assistants without MCP overhead",
   "main": "dist/index.js",
   "bin": {
@@ -54,7 +54,7 @@
     "commander": "^14.0.0",
     "dotenv": "^17.0.0",
     "microdiff": "^1.5.0",
-    "retell-sdk": "^4.66.0",
+    "retell-sdk": "^5.10.3",
     "zod": "^3.25.0"
   },
   "devDependencies": {