retell-cli 1.2.0 → 1.3.0

package/README.md

@@ -305,6 +305,81 @@ Publish a draft agent to make changes live.
 retell agent-publish agent_123abc
 ```
 
+### Agent Configuration
+
+Manage agent-level settings that aren't part of prompts (voice, webhooks, post-call analysis, etc.).
+
+#### `retell agent get <agent_id> [options]`
+
+Get agent configuration including all agent-level settings.
+
+**Options:**
+- `--version <number>` - Specific version to retrieve (defaults to latest)
+- `--fields <fields>` - Comma-separated list of fields to return
+
+**Examples:**
+```bash
+# Get full agent config
+retell agent get agent_123abc
+
+# Get specific version
+retell agent get agent_123abc --version 2
+
+# Get specific fields only
+retell agent get agent_123abc --fields agent_name,post_call_analysis_data
+
+# Save config to file for editing
+retell agent get agent_123abc > config.json
+```
+
+#### `retell agent update <agent_id> [options]`
+
+Update agent configuration from a JSON file. This is useful for updating agent-level fields that aren't accessible through `prompts update`, such as:
+- `post_call_analysis_data` - Custom data extraction from calls
+- `post_call_analysis_model` - Model for analysis
+- `analysis_successful_prompt` - Success criteria prompt
+- `analysis_summary_prompt` - Summary generation prompt
+- Voice settings, language, webhooks, and more
+
+**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)
+
+**Example JSON for post-call analysis:**
+```json
+{
+  "post_call_analysis_model": "claude-4.5-sonnet",
+  "post_call_analysis_data": [
+    {
+      "name": "call_outcome",
+      "type": "enum",
+      "description": "Result of the call",
+      "choices": ["successful", "unsuccessful", "callback_needed"]
+    },
+    {
+      "name": "customer_sentiment",
+      "type": "string",
+      "description": "Overall customer sentiment"
+    }
+  ],
+  "analysis_successful_prompt": "Determine if the issue was resolved.",
+  "analysis_summary_prompt": "Summarize the call in 2 sentences."
+}
+```
+
+**Examples:**
+```bash
+# Preview changes first (recommended)
+retell agent update agent_123abc --file config.json --dry-run
+
+# Apply changes
+retell agent update agent_123abc --file config.json
+
+# Remember to publish after updating
+retell agent-publish agent_123abc
+```
+
 ### Tools
 
 Manage agent tools (custom functions, webhooks, etc.). Tools are embedded within Retell LLM and Conversation Flow configurations.

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_fs15 = require("fs");
+var import_fs16 = require("fs");
 var import_path6 = require("path");
 
 // src/commands/login.ts
@@ -751,27 +751,27 @@ async function listAgentsCommand(options = {}) {
     const agents2 = await client.agent.list({
       limit: options.limit || 100
     });
-    const formatted = agents2.map((agent) => {
+    const formatted = agents2.map((agent2) => {
       let response_engine_id;
-      switch (agent.response_engine.type) {
+      switch (agent2.response_engine.type) {
         case "retell-llm":
-          response_engine_id = agent.response_engine.llm_id || "unknown";
+          response_engine_id = agent2.response_engine.llm_id || "unknown";
           break;
         case "conversation-flow":
-          response_engine_id = agent.response_engine.conversation_flow_id || "unknown";
+          response_engine_id = agent2.response_engine.conversation_flow_id || "unknown";
           break;
         case "custom-llm":
-          response_engine_id = agent.response_engine.llm_websocket_url || "unknown";
+          response_engine_id = agent2.response_engine.llm_websocket_url || "unknown";
           break;
         default:
           response_engine_id = "unknown";
       }
       return {
-        agent_id: agent.agent_id,
-        agent_name: agent.agent_name,
-        version: agent.version,
-        is_published: agent.is_published,
-        response_engine_type: agent.response_engine.type,
+        agent_id: agent2.agent_id,
+        agent_name: agent2.agent_name,
+        version: agent2.version,
+        is_published: agent2.is_published,
+        response_engine_type: agent2.response_engine.type,
         response_engine_id
       };
     });
@@ -789,11 +789,11 @@ async function listAgentsCommand(options = {}) {
 async function agentInfoCommand(agentId, options = {}) {
   try {
     const client = getRetellClient();
-    const agent = await client.agent.retrieve(agentId);
+    const agent2 = await client.agent.retrieve(agentId);
     const output = options.fields ? filterFields(
-      agent,
+      agent2,
       options.fields.split(",").map((f) => f.trim())
-    ) : agent;
+    ) : agent2;
     outputJson(output);
   } catch (error) {
     handleSdkError(error);
@@ -807,13 +807,13 @@ var import_path2 = require("path");
 // src/services/prompt-resolver.ts
 async function resolvePromptSource(agentId) {
   const client = getRetellClient();
-  const agent = await client.agent.retrieve(agentId);
-  if (agent.response_engine.type === "retell-llm") {
-    const llm = await client.llm.retrieve(agent.response_engine.llm_id);
+  const agent2 = await client.agent.retrieve(agentId);
+  if (agent2.response_engine.type === "retell-llm") {
+    const llm = await client.llm.retrieve(agent2.response_engine.llm_id);
     return {
       type: "retell-llm",
       llmId: llm.llm_id,
-      agentName: agent.agent_name,
+      agentName: agent2.agent_name,
       prompts: {
         llm_id: llm.llm_id,
         version: llm.version,
@@ -823,14 +823,14 @@ async function resolvePromptSource(agentId) {
       }
     };
   }
-  if (agent.response_engine.type === "conversation-flow") {
+  if (agent2.response_engine.type === "conversation-flow") {
     const flow = await client.conversationFlow.retrieve(
-      agent.response_engine.conversation_flow_id
+      agent2.response_engine.conversation_flow_id
     );
     return {
       type: "conversation-flow",
       flowId: flow.conversation_flow_id,
-      agentName: agent.agent_name,
+      agentName: agent2.agent_name,
       prompts: {
         conversation_flow_id: flow.conversation_flow_id,
         version: flow.version,
@@ -1454,13 +1454,13 @@ async function publishAgentCommand(agentId) {
     }
   }
   try {
-    const agent = await client.agent.retrieve(agentId);
+    const agent2 = await client.agent.retrieve(agentId);
     outputJson({
       message: "Agent published successfully",
-      agent_id: agent.agent_id,
-      agent_name: agent.agent_name || "Unknown",
-      version: agent.version || "Unknown",
-      is_published: agent.is_published ?? true,
+      agent_id: agent2.agent_id,
+      agent_name: agent2.agent_name || "Unknown",
+      version: agent2.version || "Unknown",
+      is_published: agent2.is_published ?? true,
       note: "Draft version incremented and ready for new changes"
     });
   } catch (error) {
@@ -1468,12 +1468,109 @@ async function publishAgentCommand(agentId) {
   }
 }
 
+// src/commands/agent/get.ts
+async function getAgentCommand(agentId, options) {
+  const client = getRetellClient();
+  try {
+    const agent2 = await client.agent.retrieve(agentId, {
+      version: options.version
+    });
+    if (options.fields) {
+      const fields = options.fields.split(",").map((f) => f.trim());
+      const filtered = filterFields(agent2, fields);
+      outputJson(filtered);
+    } else {
+      outputJson(agent2);
+    }
+  } catch (error) {
+    handleSdkError(error);
+  }
+}
+
+// src/commands/agent/update.ts
+var import_fs5 = require("fs");
+function validateFilePath(filePath) {
+  if (filePath.includes("\0")) {
+    throw new Error("Invalid file path: contains null bytes");
+  }
+}
+async function updateAgentCommand(agentId, options) {
+  const client = getRetellClient();
+  try {
+    validateFilePath(options.file);
+    if (!(0, import_fs5.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");
+      updateParams = JSON.parse(fileContent);
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        outputError(`Invalid JSON in file: ${error.message}`, "INVALID_JSON");
+        return;
+      }
+      throw error;
+    }
+    if (typeof updateParams !== "object" || updateParams === null || Array.isArray(updateParams)) {
+      outputError(
+        "File must contain a JSON object with agent configuration fields",
+        "INVALID_FORMAT"
+      );
+      return;
+    }
+    if (options.dryRun) {
+      const currentAgent = await client.agent.retrieve(agentId, {
+        version: options.version
+      });
+      const changes = {};
+      for (const [key, newValue] of Object.entries(updateParams)) {
+        const currentValue = currentAgent[key];
+        if (JSON.stringify(currentValue) !== JSON.stringify(newValue)) {
+          changes[key] = {
+            current: currentValue,
+            new: newValue
+          };
+        }
+      }
+      outputJson({
+        message: "Dry run - no changes applied",
+        agent_id: agentId,
+        agent_name: currentAgent.agent_name || "Unknown",
+        fields_to_update: Object.keys(updateParams),
+        changes: Object.keys(changes).length > 0 ? changes : "No changes detected (values are identical)",
+        note: `Run without --dry-run to apply changes`
+      });
+      return;
+    }
+    const updatedAgent = await client.agent.update(
+      agentId,
+      updateParams
+    );
+    outputJson({
+      message: "Agent updated successfully (draft version)",
+      agent_id: updatedAgent.agent_id,
+      agent_name: updatedAgent.agent_name || "Unknown",
+      version: updatedAgent.version,
+      fields_updated: Object.keys(updateParams),
+      note: `Run 'retell agent-publish ${agentId}' to publish changes to production`
+    });
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      outputError(`Invalid JSON in file: ${error.message}`, "INVALID_JSON");
+      return;
+    }
+    handleSdkError(error);
+  }
+}
+
 // src/services/tool-resolver.ts
 async function resolveToolsSource(agentId) {
   const client = getRetellClient();
-  const agent = await client.agent.retrieve(agentId);
-  if (agent.response_engine.type === "retell-llm") {
-    const llm = await client.llm.retrieve(agent.response_engine.llm_id);
+  const agent2 = await client.agent.retrieve(agentId);
+  if (agent2.response_engine.type === "retell-llm") {
+    const llm = await client.llm.retrieve(agent2.response_engine.llm_id);
     const generalTools = llm.general_tools ?? [];
     const stateTools = {};
     if (llm.states) {
@@ -1492,16 +1589,16 @@ async function resolveToolsSource(agentId) {
     return {
       type: "retell-llm",
       agentId,
-      agentName: agent.agent_name ?? "Unknown",
+      agentName: agent2.agent_name ?? "Unknown",
       llmId: llm.llm_id,
       generalTools,
       stateTools,
       totalCount
     };
   }
-  if (agent.response_engine.type === "conversation-flow") {
+  if (agent2.response_engine.type === "conversation-flow") {
     const flow = await client.conversationFlow.retrieve(
-      agent.response_engine.conversation_flow_id
+      agent2.response_engine.conversation_flow_id
     );
     const flowTools = flow.tools ?? [];
     const componentTools = {};
@@ -1521,7 +1618,7 @@ async function resolveToolsSource(agentId) {
     return {
       type: "conversation-flow",
       agentId,
-      agentName: agent.agent_name ?? "Unknown",
+      agentName: agent2.agent_name ?? "Unknown",
       flowId: flow.conversation_flow_id,
       flowTools,
       componentTools,
@@ -1796,16 +1893,16 @@ async function getToolCommand(agentId, toolName, options) {
 }
 
 // src/commands/tools/add.ts
-var import_fs5 = require("fs");
+var import_fs6 = require("fs");
 async function addToolCommand(agentId, options) {
   try {
-    if (!(0, import_fs5.existsSync)(options.file)) {
+    if (!(0, import_fs6.existsSync)(options.file)) {
       outputError(`Tool file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let tool;
     try {
-      const content = (0, import_fs5.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs6.readFileSync)(options.file, "utf-8");
       tool = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -1980,16 +2077,16 @@ async function addToolCommand(agentId, options) {
 }
 
 // src/commands/tools/update.ts
-var import_fs6 = require("fs");
+var import_fs7 = require("fs");
 async function updateToolCommand(agentId, toolName, 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 newTool;
     try {
-      const content = (0, import_fs6.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs7.readFileSync)(options.file, "utf-8");
       newTool = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2373,7 +2470,7 @@ async function removeToolCommand(agentId, toolName, options) {
 }
 
 // src/commands/tools/export.ts
-var import_fs7 = require("fs");
+var import_fs8 = require("fs");
 async function exportToolsCommand(agentId, options) {
   try {
     const source = await resolveToolsSource(agentId);
@@ -2421,7 +2518,7 @@ async function exportToolsCommand(agentId, options) {
     }
     if (options.output) {
       try {
-        (0, import_fs7.writeFileSync)(
+        (0, import_fs8.writeFileSync)(
           options.output,
           JSON.stringify(exportData, null, 2),
           "utf-8"
@@ -2455,16 +2552,16 @@ async function exportToolsCommand(agentId, options) {
 }
 
 // src/commands/tools/import.ts
-var import_fs8 = require("fs");
+var import_fs9 = require("fs");
 async function importToolsCommand(agentId, options) {
   try {
-    if (!(0, import_fs8.existsSync)(options.file)) {
+    if (!(0, import_fs9.existsSync)(options.file)) {
       outputError(`Import file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let importData;
     try {
-      const content = (0, import_fs8.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs9.readFileSync)(options.file, "utf-8");
       importData = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2864,7 +2961,7 @@ async function getTestCaseCommand(testCaseDefinitionId, options) {
 }
 
 // src/commands/tests/cases/create.ts
-var import_fs9 = require("fs");
+var import_fs10 = require("fs");
 function buildResponseEngine2(options) {
   if (options.llmId && options.flowId) {
     outputError(
@@ -2902,7 +2999,7 @@ function buildResponseEngine2(options) {
 }
 async function createTestCaseCommand(options) {
   try {
-    if (!(0, import_fs9.existsSync)(options.file)) {
+    if (!(0, import_fs10.existsSync)(options.file)) {
       outputError(
         `Test case file not found: ${options.file}`,
         "FILE_NOT_FOUND"
@@ -2911,7 +3008,7 @@ async function createTestCaseCommand(options) {
     }
     let input;
     try {
-      const content = (0, import_fs9.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs10.readFileSync)(options.file, "utf-8");
       input = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -2961,10 +3058,10 @@ async function createTestCaseCommand(options) {
 }
 
 // src/commands/tests/cases/update.ts
-var import_fs10 = require("fs");
+var import_fs11 = require("fs");
 async function updateTestCaseCommand(testCaseDefinitionId, 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"
@@ -2973,7 +3070,7 @@ async function updateTestCaseCommand(testCaseDefinitionId, 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) {
@@ -3230,7 +3327,7 @@ async function getKnowledgeBaseCommand(knowledgeBaseId, options) {
 }
 
 // src/commands/kb/create.ts
-var import_fs11 = require("fs");
+var import_fs12 = require("fs");
 async function createKnowledgeBaseCommand(options) {
   try {
     if (options.name.length > 40) {
@@ -3253,12 +3350,12 @@ async function createKnowledgeBaseCommand(options) {
       }
     }
     if (options.texts) {
-      if (!(0, import_fs11.existsSync)(options.texts)) {
+      if (!(0, import_fs12.existsSync)(options.texts)) {
         outputError(`Texts file not found: ${options.texts}`, "FILE_NOT_FOUND");
         return;
       }
       try {
-        const content = (0, import_fs11.readFileSync)(options.texts, "utf-8");
+        const content = (0, import_fs12.readFileSync)(options.texts, "utf-8");
         const textsData = JSON.parse(content);
         if (!Array.isArray(textsData)) {
           outputError(
@@ -3334,7 +3431,7 @@ async function deleteKnowledgeBaseCommand(knowledgeBaseId) {
 }
 
 // src/commands/kb/sources/add.ts
-var import_fs12 = require("fs");
+var import_fs13 = require("fs");
 async function addKnowledgeBaseSourcesCommand(knowledgeBaseId, options) {
   try {
     if (!options.urls && !options.texts) {
@@ -3352,12 +3449,12 @@ async function addKnowledgeBaseSourcesCommand(knowledgeBaseId, 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(
@@ -3483,16 +3580,16 @@ async function getFlowCommand(conversationFlowId, options) {
 }
 
 // src/commands/flows/create.ts
-var import_fs13 = require("fs");
+var import_fs14 = require("fs");
 async function createFlowCommand(options) {
   try {
-    if (!(0, import_fs13.existsSync)(options.file)) {
+    if (!(0, import_fs14.existsSync)(options.file)) {
       outputError(`Flow file not found: ${options.file}`, "FILE_NOT_FOUND");
       return;
     }
     let flowConfig;
     try {
-      const content = (0, import_fs13.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs14.readFileSync)(options.file, "utf-8");
       flowConfig = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3530,16 +3627,16 @@ async function createFlowCommand(options) {
 }
 
 // src/commands/flows/update.ts
-var import_fs14 = require("fs");
+var import_fs15 = require("fs");
 async function updateFlowCommand(conversationFlowId, 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 flowUpdates;
     try {
-      const content = (0, import_fs14.readFileSync)(options.file, "utf-8");
+      const content = (0, import_fs15.readFileSync)(options.file, "utf-8");
       flowUpdates = JSON.parse(content);
     } catch (error) {
       if (error instanceof SyntaxError) {
@@ -3593,7 +3690,7 @@ async function deleteFlowCommand(conversationFlowId) {
 
 // src/index.ts
 var packageJson = JSON.parse(
-  (0, import_fs15.readFileSync)((0, import_path6.join)(__dirname, "../package.json"), "utf-8")
+  (0, import_fs16.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);
@@ -3818,6 +3915,68 @@ Examples:
 ).action(async (agentId) => {
   await publishAgentCommand(agentId);
 });
+var agent = program.command("agent").description(
+  "Manage agent-level configuration (voice, webhooks, post-call analysis, etc.)"
+);
+agent.command("get <agent_id>").description("Get agent configuration").option(
+  "--version <number>",
+  "Specific version to retrieve (defaults to latest)"
+).option(
+  "--fields <fields>",
+  "Comma-separated list of fields to return (e.g., agent_name,post_call_analysis_data)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agent get agent_123abc
+  $ retell agent get agent_123abc --version 2
+  $ retell agent get agent_123abc --fields agent_name,post_call_analysis_data
+  $ retell agent get agent_123abc > config.json
+  `
+).action(async (agentId, options) => {
+  await getAgentCommand(agentId, {
+    version: options.version ? parseInt(options.version, 10) : void 0,
+    fields: options.fields
+  });
+});
+agent.command("update <agent_id>").description("Update agent configuration from a JSON file").requiredOption(
+  "-f, --file <path>",
+  "Path to JSON file containing agent configuration updates"
+).option("--dry-run", "Preview changes without applying them").option(
+  "--version <number>",
+  "Specific version to update (defaults to latest draft)"
+).addHelpText(
+  "after",
+  `
+Examples:
+  $ retell agent update agent_123abc --file config.json
+  $ retell agent update agent_123abc --file config.json --dry-run
+  $ retell agent update agent_123abc --file analysis.json --version 2
+
+Example JSON for post-call analysis:
+  {
+    "post_call_analysis_model": "claude-4.5-sonnet",
+    "post_call_analysis_data": [
+      {
+        "name": "call_outcome",
+        "type": "enum",
+        "description": "Result of the call",
+        "choices": ["successful", "unsuccessful", "callback_needed"]
+      }
+    ],
+    "analysis_successful_prompt": "Determine if the issue was resolved.",
+    "analysis_summary_prompt": "Summarize the call in 2 sentences."
+  }
+
+Note: Run 'retell agent-publish <agent_id>' after updating to publish changes.
+  `
+).action(async (agentId, options) => {
+  await updateAgentCommand(agentId, {
+    file: options.file,
+    dryRun: options.dryRun,
+    version: options.version ? parseInt(options.version, 10) : void 0
+  });
+});
 var tools = program.command("tools").description("Manage agent tools (custom functions, webhooks, etc.)");
 tools.command("list <agent_id>").description("List all tools configured for an agent").option("--state <name>", "Filter by state name (Retell LLM only)").option("--component <id>", "Filter by component ID (Conversation Flow only)").option("--fields <fields>", "Comma-separated list of fields to return").addHelpText(
   "after",

package/package.json

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