retell-cli 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -5,6 +5,65 @@ All notable changes to the Retell AI CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2026-01-27
+
+### Added
+
+#### Agent CRUD Commands
+- **`retell agents create`** - Create new agents with configurable response engines
+  - `--voice` - Voice ID for the agent (required)
+  - `--name` - Agent name
+  - `--llm-id` - Retell LLM ID (creates retell-llm response engine)
+  - `--flow-id` - Conversation Flow ID (creates conversation-flow response engine)
+  - `--custom-llm` - Custom LLM WebSocket URL
+  - `--file` - Full agent config from JSON file
+  - `--fields` - Filter output fields
+  - Validates exactly one response engine type is specified
+
+- **`retell agents delete <agent_id>`** - Delete an agent
+  - Returns success confirmation with deleted agent ID
+
+- **`retell agents versions <agent_id>`** - List all versions of an agent
+  - Shows version number, publish status, agent name, and timestamp
+  - `--fields` - Filter output fields
+
+#### Phone Number Commands
+- **`retell phone-numbers list`** - List all phone numbers
+  - Shows phone number, pretty format, type, nickname, and agent IDs
+  - `--fields` - Filter output fields
+
+- **`retell phone-numbers get <phone_number>`** - Get phone number details
+  - Retrieves full phone number configuration
+  - `--fields` - Filter output fields
+
+- **`retell phone-numbers import`** - Import phone number from custom telephony
+  - `--number` - Phone number in E.164 format (required)
+  - `--termination-uri` - SIP trunk termination URI (required)
+  - `--nickname` - Friendly name for reference
+  - `--inbound-agent` - Agent ID for inbound calls
+  - `--outbound-agent` - Agent ID for outbound calls
+  - `--sip-username` - SIP trunk auth username
+  - `--sip-password` - SIP trunk auth password
+  - `--fields` - Filter output fields
+
+#### Testing
+- Added 32 new unit tests for all new commands
+  - 11 tests for `agents create` (validation, response engines, file loading)
+  - 3 tests for `agents delete` (success, error handling)
+  - 4 tests for `agents versions` (listing, filtering, errors)
+  - 4 tests for `phone-numbers list` (listing, filtering, errors)
+  - 4 tests for `phone-numbers get` (retrieval, filtering, errors)
+  - 6 tests for `phone-numbers import` (options, filtering, errors)
+
+**Total: 138 tests passing** ✅
+
+#### Documentation
+- Updated README.md with complete command documentation
+- Added examples for all new commands
+- Updated features list to include phone number management
+
+---
+
 ## [Unreleased] - v1.0.1
 
 ### Added - Phase 1: Foundation & Utilities

package/README.md

@@ -8,7 +8,8 @@ Community-built command-line tool for Retell AI - designed to give AI assistants
 ## Features
 
 - **Transcript Management** - List, retrieve, and analyze call transcripts
-- **Agent Management** - View and configure Retell AI agents
+- **Agent Management** - Full CRUD for Retell AI agents (create, list, update, delete, versions)
+- **Phone Number Management** - List, retrieve, and import phone numbers
 - **Prompt Engineering** - Pull, edit, and update agent prompts
 - **Tool Management** - Full CRUD for agent tools (webhooks, custom functions, etc.)
 - **Multi-format Support** - Works with Retell LLM and Conversation Flows
@@ -220,6 +221,55 @@ Get detailed information about a specific agent.
 retell agents info agent_123abc
 ```
 
+#### `retell agents create [options]`
+
+Create a new agent with the specified configuration.
+
+**Options:**
+- `--voice <voice_id>` - Voice ID for the agent (required)
+- `--name <name>` - Agent name
+- `--llm-id <id>` - Retell LLM ID (creates retell-llm response engine)
+- `--flow-id <id>` - Conversation Flow ID (creates conversation-flow response engine)
+- `--custom-llm <url>` - Custom LLM WebSocket URL
+- `-f, --file <path>` - Full agent config from JSON file (overrides other options)
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Note:** You must specify exactly one of `--llm-id`, `--flow-id`, `--custom-llm`, or `--file`.
+
+**Examples:**
+```bash
+# Create agent with Retell LLM
+retell agents create --voice 11labs-Adrian --llm-id llm_xxx --name "Support Agent"
+
+# Create agent with Conversation Flow
+retell agents create --voice 11labs-Adrian --flow-id cf_xxx
+
+# Create agent from JSON config file
+retell agents create --file agent-config.json
+```
+
+#### `retell agents delete <agent_id>`
+
+Delete an agent.
+
+**Example:**
+```bash
+retell agents delete agent_123abc
+```
+
+#### `retell agents versions <agent_id> [options]`
+
+List all versions of an agent.
+
+**Options:**
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Example:**
+```bash
+retell agents versions agent_123abc
+retell agents versions agent_123abc --fields version,is_published
+```
+
 ### Prompts
 
 #### `retell prompts pull <agent_id> [options]`
@@ -538,6 +588,70 @@ retell tools import agent_123abc --file tools.json --replace
 retell agent-publish agent_123abc
 ```
 
+### Phone Numbers
+
+Manage phone numbers for your Retell AI agents.
+
+#### `retell phone-numbers list [options]`
+
+List all phone numbers in your account.
+
+**Options:**
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Example:**
+```bash
+retell phone-numbers list
+retell phone-numbers list --fields phone_number,nickname,inbound_agent_id
+```
+
+#### `retell phone-numbers get <phone_number> [options]`
+
+Get details of a specific phone number.
+
+**Options:**
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Example:**
+```bash
+retell phone-numbers get +14157774444
+retell phone-numbers get +14157774444 --fields phone_number,inbound_agent_id
+```
+
+#### `retell phone-numbers import [options]`
+
+Import a phone number from custom telephony (e.g., Twilio, Vonage).
+
+**Options:**
+- `--number <number>` - Phone number in E.164 format (required)
+- `--termination-uri <uri>` - SIP trunk termination URI (required)
+- `--nickname <name>` - Friendly name for reference
+- `--inbound-agent <id>` - Agent ID for inbound calls
+- `--outbound-agent <id>` - Agent ID for outbound calls
+- `--sip-username <user>` - SIP trunk auth username
+- `--sip-password <pass>` - SIP trunk auth password
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Examples:**
+```bash
+# Basic import
+retell phone-numbers import --number +14157774444 --termination-uri someuri.pstn.twilio.com
+
+# Import with nickname and agent assignment
+retell phone-numbers import \
+  --number +14157774444 \
+  --termination-uri someuri.pstn.twilio.com \
+  --nickname "Support Line" \
+  --inbound-agent agent_123abc
+
+# Import with SIP authentication
+retell phone-numbers import \
+  --number +14157774444 \
+  --termination-uri someuri.pstn.twilio.com \
+  --sip-username myuser \
+  --sip-password mypass
+```
+
 ### Field Selection
 
 Reduce output size and token usage by selecting specific fields:

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_fs16 = require("fs");
+var import_fs17 = require("fs");
 var import_path6 = require("path");
 
 // src/commands/login.ts
@@ -800,8 +800,128 @@ async function agentInfoCommand(agentId, options = {}) {
   }
 }
 
-// src/commands/prompts/pull.ts
+// src/commands/agents/create.ts
 var import_fs2 = require("fs");
+async function createAgentCommand(options) {
+  try {
+    const client = getRetellClient();
+    let config;
+    if (options.file) {
+      if (!(0, import_fs2.existsSync)(options.file)) {
+        outputError(`Config file not found: ${options.file}`, "FILE_NOT_FOUND");
+        return;
+      }
+      try {
+        const content = (0, import_fs2.readFileSync)(options.file, "utf-8");
+        config = JSON.parse(content);
+      } catch (error) {
+        if (error instanceof SyntaxError) {
+          outputError(
+            `Invalid JSON in config file: ${error.message}`,
+            "INVALID_JSON"
+          );
+        } else if (error instanceof Error) {
+          outputError(
+            `Error reading config file: ${error.message}`,
+            "FILE_ERROR"
+          );
+        }
+        return;
+      }
+    } else {
+      const engineCount = [
+        options.llmId,
+        options.flowId,
+        options.customLlm
+      ].filter(Boolean).length;
+      if (engineCount === 0) {
+        outputError(
+          "Must specify one of: --llm-id, --flow-id, or --custom-llm",
+          "MISSING_RESPONSE_ENGINE"
+        );
+        return;
+      }
+      if (engineCount > 1) {
+        outputError(
+          "Only one of --llm-id, --flow-id, or --custom-llm can be specified",
+          "MULTIPLE_RESPONSE_ENGINES"
+        );
+        return;
+      }
+      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
+        };
+      }
+      config = {
+        voice_id: options.voice,
+        response_engine: responseEngine
+      };
+      if (options.name) {
+        config.agent_name = options.name;
+      }
+    }
+    const agent2 = await client.agent.create(config);
+    const output = options.fields ? filterFields(
+      agent2,
+      options.fields.split(",").map((f) => f.trim())
+    ) : agent2;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/agents/delete.ts
+async function deleteAgentCommand(agentId) {
+  try {
+    const client = getRetellClient();
+    await client.agent.delete(agentId);
+    outputJson({
+      message: "Agent deleted successfully",
+      agent_id: agentId,
+      operation: "delete"
+    });
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/agents/versions.ts
+async function agentVersionsCommand(agentId, options = {}) {
+  try {
+    const client = getRetellClient();
+    const versions = await client.agent.getVersions(agentId);
+    const formatted = versions.map((v) => ({
+      version: v.version,
+      is_published: v.is_published,
+      agent_name: v.agent_name,
+      last_modification_timestamp: v.last_modification_timestamp
+    }));
+    const output = options.fields ? filterFields(
+      formatted,
+      options.fields.split(",").map((f) => f.trim())
+    ) : formatted;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/prompts/pull.ts
+var import_fs3 = require("fs");
 var import_path2 = require("path");
 
 // src/services/prompt-resolver.ts
@@ -864,7 +984,7 @@ async function pullPromptsCommand(agentId, options) {
     const baseDir = options.output || ".retell-prompts";
     const agentDir = (0, import_path2.join)(baseDir, agentId);
     try {
-      (0, import_fs2.mkdirSync)(agentDir, { recursive: true });
+      (0, import_fs3.mkdirSync)(agentDir, { recursive: true });
     } catch (error) {
       if (error.code === "EACCES") {
         outputError(
@@ -921,26 +1041,26 @@ function saveRetellLlmPrompts(agentDir, promptSource) {
     version: prompts2.version,
     pulled_at: (/* @__PURE__ */ new Date()).toISOString()
   };
-  (0, import_fs2.writeFileSync)(
+  (0, import_fs3.writeFileSync)(
     (0, import_path2.join)(agentDir, "metadata.json"),
     JSON.stringify(metadata, null, 2)
   );
-  (0, import_fs2.writeFileSync)(
+  (0, import_fs3.writeFileSync)(
     (0, import_path2.join)(agentDir, "general_prompt.md"),
     prompts2.general_prompt || ""
   );
   if (prompts2.begin_message) {
-    (0, import_fs2.writeFileSync)((0, import_path2.join)(agentDir, "begin_message.txt"), prompts2.begin_message);
+    (0, import_fs3.writeFileSync)((0, import_path2.join)(agentDir, "begin_message.txt"), prompts2.begin_message);
   }
   if (prompts2.states && prompts2.states.length > 0) {
     const statesDir = (0, import_path2.join)(agentDir, "states");
-    (0, import_fs2.mkdirSync)(statesDir, { recursive: true });
+    (0, import_fs3.mkdirSync)(statesDir, { recursive: true });
     prompts2.states.forEach((state) => {
       const filename = `${state.name}.md`;
       const content = `# State: ${state.name}
 
 ${state.state_prompt}`;
-      (0, import_fs2.writeFileSync)((0, import_path2.join)(statesDir, filename), content);
+      (0, import_fs3.writeFileSync)((0, import_path2.join)(statesDir, filename), content);
     });
   }
 }
@@ -953,15 +1073,15 @@ function saveConversationFlowPrompts(agentDir, promptSource) {
     version: prompts2.version,
     pulled_at: (/* @__PURE__ */ new Date()).toISOString()
   };
-  (0, import_fs2.writeFileSync)(
+  (0, import_fs3.writeFileSync)(
     (0, import_path2.join)(agentDir, "metadata.json"),
     JSON.stringify(metadata, null, 2)
   );
-  (0, import_fs2.writeFileSync)(
+  (0, import_fs3.writeFileSync)(
     (0, import_path2.join)(agentDir, "global_prompt.md"),
     prompts2.global_prompt || ""
   );
-  (0, import_fs2.writeFileSync)(
+  (0, import_fs3.writeFileSync)(
     (0, import_path2.join)(agentDir, "nodes.json"),
     JSON.stringify(prompts2.nodes, null, 2)
   );
@@ -984,27 +1104,27 @@ function getFilesCreated(type, promptSource) {
 }
 
 // src/commands/prompts/update.ts
-var import_fs4 = require("fs");
+var import_fs5 = require("fs");
 var import_path4 = require("path");
 
 // src/services/prompt-loader.ts
-var import_fs3 = require("fs");
+var import_fs4 = require("fs");
 var import_path3 = require("path");
 function loadLocalPrompts(agentId, agentDir) {
-  if (!(0, import_fs3.existsSync)(agentDir)) {
+  if (!(0, import_fs4.existsSync)(agentDir)) {
     throw new Error(
       `Prompts directory not found: ${agentDir}. Run 'retell prompts pull ${agentId}' first.`
     );
   }
   const metadataPath = (0, import_path3.join)(agentDir, "metadata.json");
-  if (!(0, import_fs3.existsSync)(metadataPath)) {
+  if (!(0, import_fs4.existsSync)(metadataPath)) {
     throw new Error(
       `metadata.json not found in ${agentDir}. Directory may be corrupted.`
     );
   }
   let metadata;
   try {
-    metadata = JSON.parse((0, import_fs3.readFileSync)(metadataPath, "utf-8"));
+    metadata = JSON.parse((0, import_fs4.readFileSync)(metadataPath, "utf-8"));
   } catch (error) {
     if (error instanceof SyntaxError) {
       throw new Error(`Invalid JSON in metadata.json: ${error.message}`);
@@ -1034,18 +1154,18 @@ function loadLocalPrompts(agentId, agentDir) {
 function loadRetellLlmPrompts(agentDir) {
   const prompts2 = {};
   const generalPromptPath = (0, import_path3.join)(agentDir, "general_prompt.md");
-  if (!(0, import_fs3.existsSync)(generalPromptPath)) {
+  if (!(0, import_fs4.existsSync)(generalPromptPath)) {
     throw new Error("general_prompt.md not found");
   }
   try {
-    prompts2.general_prompt = (0, import_fs3.readFileSync)(generalPromptPath, "utf-8");
+    prompts2.general_prompt = (0, import_fs4.readFileSync)(generalPromptPath, "utf-8");
   } catch (error) {
     throw new Error(`Failed to read general_prompt.md: ${error.message}`);
   }
   const beginMessagePath = (0, import_path3.join)(agentDir, "begin_message.txt");
-  if ((0, import_fs3.existsSync)(beginMessagePath)) {
+  if ((0, import_fs4.existsSync)(beginMessagePath)) {
     try {
-      const beginMessage = (0, import_fs3.readFileSync)(beginMessagePath, "utf-8");
+      const beginMessage = (0, import_fs4.readFileSync)(beginMessagePath, "utf-8");
       if (beginMessage) {
         prompts2.begin_message = beginMessage;
       }
@@ -1054,9 +1174,9 @@ function loadRetellLlmPrompts(agentDir) {
     }
   }
   const statesDir = (0, import_path3.join)(agentDir, "states");
-  if ((0, import_fs3.existsSync)(statesDir)) {
+  if ((0, import_fs4.existsSync)(statesDir)) {
     try {
-      const stateFiles = (0, import_fs3.readdirSync)(statesDir).filter(
+      const stateFiles = (0, import_fs4.readdirSync)(statesDir).filter(
         (f) => f.endsWith(".md")
       );
       if (stateFiles.length > 0) {
@@ -1064,7 +1184,7 @@ function loadRetellLlmPrompts(agentDir) {
           const stateName = file.replace(".md", "");
           let content;
           try {
-            content = (0, import_fs3.readFileSync)((0, import_path3.join)(statesDir, file), "utf-8");
+            content = (0, import_fs4.readFileSync)((0, import_path3.join)(statesDir, file), "utf-8");
           } catch (error) {
             throw new Error(
               `Failed to read state file ${file}: ${error.message}`
@@ -1096,20 +1216,20 @@ function loadRetellLlmPrompts(agentDir) {
 function loadConversationFlowPrompts(agentDir) {
   const prompts2 = {};
   const globalPromptPath = (0, import_path3.join)(agentDir, "global_prompt.md");
-  if (!(0, import_fs3.existsSync)(globalPromptPath)) {
+  if (!(0, import_fs4.existsSync)(globalPromptPath)) {
     throw new Error("global_prompt.md not found");
   }
   try {
-    prompts2.global_prompt = (0, import_fs3.readFileSync)(globalPromptPath, "utf-8");
+    prompts2.global_prompt = (0, import_fs4.readFileSync)(globalPromptPath, "utf-8");
   } catch (error) {
     throw new Error(`Failed to read global_prompt.md: ${error.message}`);
   }
   const nodesPath = (0, import_path3.join)(agentDir, "nodes.json");
-  if (!(0, import_fs3.existsSync)(nodesPath)) {
+  if (!(0, import_fs4.existsSync)(nodesPath)) {
     throw new Error("nodes.json not found");
   }
   try {
-    const nodesContent = JSON.parse((0, import_fs3.readFileSync)(nodesPath, "utf-8"));
+    const nodesContent = JSON.parse((0, import_fs4.readFileSync)(nodesPath, "utf-8"));
     if (!Array.isArray(nodesContent)) {
       throw new Error("nodes.json must contain an array");
     }
@@ -1313,7 +1433,7 @@ async function updatePromptsCommand(agentId, options) {
     validateAgentId2(agentId);
     const baseDir = options.source || ".retell-prompts";
     const agentDir = (0, import_path4.join)(baseDir, agentId);
-    if (!(0, import_fs4.existsSync)(agentDir)) {
+    if (!(0, import_fs5.existsSync)(agentDir)) {
       outputError(
         `Prompts directory not found: ${agentDir}. Run 'retell prompts pull ${agentId}' first.`,
         "DIRECTORY_NOT_FOUND"
@@ -1321,7 +1441,7 @@ async function updatePromptsCommand(agentId, options) {
       return;
     }
     const metadataPath = (0, import_path4.join)(agentDir, "metadata.json");
-    if (!(0, import_fs4.existsSync)(metadataPath)) {
+    if (!(0, import_fs5.existsSync)(metadataPath)) {
       outputError(
         `metadata.json not found in ${agentDir}. Directory may be corrupted.`,
         "METADATA_NOT_FOUND"
@@ -1329,7 +1449,7 @@ async function updatePromptsCommand(agentId, options) {
       return;
     }
     const metadata = JSON.parse(
-      (0, import_fs4.readFileSync)(metadataPath, "utf-8")
+      (0, import_fs5.readFileSync)(metadataPath, "utf-8")
     );
     const promptSource = await resolvePromptSource(agentId);
     if (promptSource.type === "custom-llm") {
@@ -1488,7 +1608,7 @@ async function getAgentCommand(agentId, options) {
 }
 
 // src/commands/agent/update.ts
-var import_fs5 = require("fs");
+var import_fs6 = require("fs");
 function validateFilePath(filePath) {
   if (filePath.includes("\0")) {
     throw new Error("Invalid file path: contains null bytes");
@@ -1498,13 +1618,13 @@ async function updateAgentCommand(agentId, options) {
   const client = getRetellClient();
   try {
     validateFilePath(options.file);
-    if (!(0, import_fs5.existsSync)(options.file)) {
+    if (!(0, import_fs6.existsSync)(options.file)) {
       outputError(`File not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let updateParams;
     try {
-      const fileContent = (0, import_fs5.readFileSync)(options.file, "utf-8");
+      const fileContent = (0, import_fs6.readFileSync)(options.file, "utf-8");
       updateParams = JSON.parse(fileContent);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -1893,16 +2013,16 @@ async function getToolCommand(agentId, toolName, options) {
 }
 
 // src/commands/tools/add.ts
-var import_fs6 = require("fs");
+var import_fs7 = require("fs");
 async function addToolCommand(agentId, options) {
   try {
-    if (!(0, import_fs6.existsSync)(options.file)) {
+    if (!(0, import_fs7.existsSync)(options.file)) {
       outputError(`Tool file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let tool;
     try {
-      const content = (0, import_fs6.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs7.readFileSync)(options.file, "utf-8");
       tool = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2077,16 +2197,16 @@ async function addToolCommand(agentId, options) {
 }
 
 // src/commands/tools/update.ts
-var import_fs7 = require("fs");
+var import_fs8 = require("fs");
 async function updateToolCommand(agentId, toolName, options) {
   try {
-    if (!(0, import_fs7.existsSync)(options.file)) {
+    if (!(0, import_fs8.existsSync)(options.file)) {
       outputError(`Tool file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let newTool;
     try {
-      const content = (0, import_fs7.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs8.readFileSync)(options.file, "utf-8");
       newTool = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2470,7 +2590,7 @@ async function removeToolCommand(agentId, toolName, options) {
 }
 
 // src/commands/tools/export.ts
-var import_fs8 = require("fs");
+var import_fs9 = require("fs");
 async function exportToolsCommand(agentId, options) {
   try {
     const source = await resolveToolsSource(agentId);
@@ -2518,7 +2638,7 @@ async function exportToolsCommand(agentId, options) {
     }
     if (options.output) {
       try {
-        (0, import_fs8.writeFileSync)(
+        (0, import_fs9.writeFileSync)(
           options.output,
           JSON.stringify(exportData, null, 2),
           "utf-8"
@@ -2552,16 +2672,16 @@ async function exportToolsCommand(agentId, options) {
 }
 
 // src/commands/tools/import.ts
-var import_fs9 = require("fs");
+var import_fs10 = require("fs");
 async function importToolsCommand(agentId, options) {
   try {
-    if (!(0, import_fs9.existsSync)(options.file)) {
+    if (!(0, import_fs10.existsSync)(options.file)) {
       outputError(`Import file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let importData;
     try {
-      const content = (0, import_fs9.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs10.readFileSync)(options.file, "utf-8");
       importData = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2961,7 +3081,7 @@ async function getTestCaseCommand(testCaseDefinitionId, options) {
 }
 
 // src/commands/tests/cases/create.ts
-var import_fs10 = require("fs");
+var import_fs11 = require("fs");
 function buildResponseEngine2(options) {
   if (options.llmId && options.flowId) {
     outputError(
@@ -2999,7 +3119,7 @@ function buildResponseEngine2(options) {
 }
 async function createTestCaseCommand(options) {
   try {
-    if (!(0, import_fs10.existsSync)(options.file)) {
+    if (!(0, import_fs11.existsSync)(options.file)) {
       outputError(
         `Test case file not found: ${options.file}`,
         "FILE_NOT_FOUND"
@@ -3008,7 +3128,7 @@ async function createTestCaseCommand(options) {
     }
     let input;
     try {
-      const content = (0, import_fs10.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs11.readFileSync)(options.file, "utf-8");
       input = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3058,10 +3178,10 @@ async function createTestCaseCommand(options) {
 }
 
 // src/commands/tests/cases/update.ts
-var import_fs11 = require("fs");
+var import_fs12 = require("fs");
 async function updateTestCaseCommand(testCaseDefinitionId, options) {
   try {
-    if (!(0, import_fs11.existsSync)(options.file)) {
+    if (!(0, import_fs12.existsSync)(options.file)) {
       outputError(
         `Test case file not found: ${options.file}`,
         "FILE_NOT_FOUND"
@@ -3070,7 +3190,7 @@ async function updateTestCaseCommand(testCaseDefinitionId, options) {
     }
     let input;
     try {
-      const content = (0, import_fs11.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs12.readFileSync)(options.file, "utf-8");
       input = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3327,7 +3447,7 @@ async function getKnowledgeBaseCommand(knowledgeBaseId, options) {
 }
 
 // src/commands/kb/create.ts
-var import_fs12 = require("fs");
+var import_fs13 = require("fs");
 async function createKnowledgeBaseCommand(options) {
   try {
     if (options.name.length > 40) {
@@ -3350,12 +3470,12 @@ async function createKnowledgeBaseCommand(options) {
       }
     }
     if (options.texts) {
-      if (!(0, import_fs12.existsSync)(options.texts)) {
+      if (!(0, import_fs13.existsSync)(options.texts)) {
         outputError(`Texts file not found: ${options.texts}`, "FILE_NOT_FOUND");
         return;
       }
       try {
-        const content = (0, import_fs12.readFileSync)(options.texts, "utf-8");
+        const content = (0, import_fs13.readFileSync)(options.texts, "utf-8");
         const textsData = JSON.parse(content);
         if (!Array.isArray(textsData)) {
           outputError(
@@ -3431,7 +3551,7 @@ async function deleteKnowledgeBaseCommand(knowledgeBaseId) {
 }
 
 // src/commands/kb/sources/add.ts
-var import_fs13 = require("fs");
+var import_fs14 = require("fs");
 async function addKnowledgeBaseSourcesCommand(knowledgeBaseId, options) {
   try {
     if (!options.urls && !options.texts) {
@@ -3449,12 +3569,12 @@ async function addKnowledgeBaseSourcesCommand(knowledgeBaseId, options) {
       }
     }
     if (options.texts) {
-      if (!(0, import_fs13.existsSync)(options.texts)) {
+      if (!(0, import_fs14.existsSync)(options.texts)) {
         outputError(`Texts file not found: ${options.texts}`, "FILE_NOT_FOUND");
         return;
       }
       try {
-        const content = (0, import_fs13.readFileSync)(options.texts, "utf-8");
+        const content = (0, import_fs14.readFileSync)(options.texts, "utf-8");
         const textsData = JSON.parse(content);
         if (!Array.isArray(textsData)) {
           outputError(
@@ -3580,16 +3700,16 @@ async function getFlowCommand(conversationFlowId, options) {
 }
 
 // src/commands/flows/create.ts
-var import_fs14 = require("fs");
+var import_fs15 = require("fs");
 async function createFlowCommand(options) {
   try {
-    if (!(0, import_fs14.existsSync)(options.file)) {
+    if (!(0, import_fs15.existsSync)(options.file)) {
       outputError(`Flow file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let flowConfig;
     try {
-      const content = (0, import_fs14.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs15.readFileSync)(options.file, "utf-8");
       flowConfig = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3627,16 +3747,16 @@ async function createFlowCommand(options) {
 }
 
 // src/commands/flows/update.ts
-var import_fs15 = require("fs");
+var import_fs16 = require("fs");
 async function updateFlowCommand(conversationFlowId, options) {
   try {
-    if (!(0, import_fs15.existsSync)(options.file)) {
+    if (!(0, import_fs16.existsSync)(options.file)) {
       outputError(`Flow file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let flowUpdates;
     try {
-      const content = (0, import_fs15.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs16.readFileSync)(options.file, "utf-8");
       flowUpdates = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3688,9 +3808,81 @@ async function deleteFlowCommand(conversationFlowId) {
   }
 }
 
+// src/commands/phone-numbers/list.ts
+async function listPhoneNumbersCommand(options = {}) {
+  try {
+    const client = getRetellClient();
+    const phoneNumbers2 = await client.phoneNumber.list();
+    const formatted = phoneNumbers2.map((pn) => ({
+      phone_number: pn.phone_number,
+      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
+    }));
+    const output = options.fields ? filterFields(
+      formatted,
+      options.fields.split(",").map((f) => f.trim())
+    ) : formatted;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/phone-numbers/get.ts
+async function getPhoneNumberCommand(phoneNumber, options = {}) {
+  try {
+    const client = getRetellClient();
+    const pn = await client.phoneNumber.retrieve(phoneNumber);
+    const output = options.fields ? filterFields(
+      pn,
+      options.fields.split(",").map((f) => f.trim())
+    ) : pn;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/phone-numbers/import.ts
+async function importPhoneNumberCommand(options) {
+  try {
+    const client = getRetellClient();
+    const importParams = {
+      phone_number: options.number,
+      termination_uri: options.terminationUri
+    };
+    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;
+    }
+    if (options.sipUsername) {
+      importParams.sip_trunk_auth_username = options.sipUsername;
+    }
+    if (options.sipPassword) {
+      importParams.sip_trunk_auth_password = options.sipPassword;
+    }
+    const pn = await client.phoneNumber.import(importParams);
+    const output = options.fields ? filterFields(
+      pn,
+      options.fields.split(",").map((f) => f.trim())
+    ) : pn;
+    outputJson(output);
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
 // src/index.ts
 var packageJson = JSON.parse(
-  (0, import_fs16.readFileSync)((0, import_path6.join)(__dirname, "../package.json"), "utf-8")
+  (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);
@@ -3860,6 +4052,42 @@ Examples:
     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>",
@@ -4460,6 +4688,38 @@ Examples:
 ).action(async (conversationFlowId) => {
   await deleteFlowCommand(conversationFlowId);
 });
+var phoneNumbers = program.command("phone-numbers").description("Manage phone numbers");
+phoneNumbers.command("list").description("List all phone numbers").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell phone-numbers list
+  $ retell phone-numbers list --fields phone_number,nickname,inbound_agent_id
+  `
+).action(async (options) => {
+  await listPhoneNumbersCommand(options);
+});
+phoneNumbers.command("get <phone_number>").description("Get phone number details").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
+  "after",
+  `
+Examples:
+  $ retell phone-numbers get +14157774444
+  $ retell phone-numbers get +14157774444 --fields phone_number,inbound_agent_id
+  `
+).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(
+  "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
+  `
+).action(async (options) => {
+  await importPhoneNumberCommand(options);
+});
 program.parse(process.argv);
 if (!process.argv.slice(2).length) {
   program.outputHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retell-cli",
-  "version": "1.3.0",
+  "version": "1.4.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": {