@retell-ai/retell-cli 0.13.0 → 0.15.0

package/dist/src/generated/operations.js

@@ -3,8 +3,8 @@ export const catalogMetadata = {
     "title": "Retell SDK",
     "apiVersion": "3.0.0",
     "server": "https://api.retellai.com",
-    "sourceSha256": "e5ba6d79ac33fe8e8d94854960ece761b18972d4af076252e1e09eb6ceb86f12",
-    "operationCount": 108
+    "sourceSha256": "1cc0ff5e4dbcde6c0e9d2c4cfa9678d589e9858e1edb82f8b21e0defba28baa0",
+    "operationCount": 111
 };
 export const schemaDefinitions = {
     "AgentFilter": {
@@ -7571,7 +7571,7 @@ export const operations = [
                 }
             ]
         },
-        "responseContractHash": "782083514cbfa16c7ac6734973289b4e959f2587b966212f779251715707d24d"
+        "responseContractHash": "62531dcc54900399151590ff19b8da06601726af27bd2530283f063efdf04742"
     },
     {
         "operationId": "createChatAgent",
@@ -8932,7 +8932,7 @@ export const operations = [
                     "flag": "--inbound-webhook-url",
                     "required": false,
                     "type": "string",
-                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call.",
+                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call. Includes call_inbound.call_id for deduplication across HTTP retries. Early setup failures may not create a call history record.",
                     "example": "https://example.com/inbound-webhook",
                     "array": false,
                     "nullable": true,
@@ -9456,7 +9456,7 @@ export const operations = [
                 }
             ]
         },
-        "responseContractHash": "1ad9ad9fc690ece6be02832d8ff70174f7e6fcc560e03aa0d0b029d60ed269b6"
+        "responseContractHash": "b14d904a975892f99c9dfb613d0f2d3b905f974c6a31bc34ad8b3fb12b061683"
     },
     {
         "operationId": "createTestCaseDefinition",
@@ -9599,7 +9599,7 @@ export const operations = [
         "method": "POST",
         "path": "/v2/create-web-call",
         "description": "Create a new web call",
-        "deprecated": false,
+        "deprecated": true,
         "authenticated": true,
         "parameters": [],
         "requestBody": {
@@ -9725,6 +9725,138 @@ export const operations = [
         },
         "responseContractHash": "41fb8734cceb8c5d24a3dbb3024a881746d7ceea15a22814299ba9b174adacd2"
     },
+    {
+        "operationId": "createWebCallV3",
+        "command": "create-web-call-v3",
+        "method": "POST",
+        "path": "/v3/create-web-call",
+        "description": "Create a new web call and return browser connection details.",
+        "deprecated": false,
+        "authenticated": true,
+        "parameters": [],
+        "requestBody": {
+            "required": true,
+            "contentType": "application/json",
+            "propertyCount": 7,
+            "requiredFields": [
+                "agent_id"
+            ],
+            "validationSchema": {
+                "type": "object",
+                "required": [
+                    "agent_id"
+                ],
+                "properties": {
+                    "agent_id": {
+                        "type": "string",
+                        "minLength": 1
+                    },
+                    "agent_version": {
+                        "$ref": "#/components/schemas/AgentVersionReference"
+                    },
+                    "agent_override": {
+                        "$ref": "#/components/schemas/AgentOverrideRequest"
+                    },
+                    "metadata": {
+                        "type": "object"
+                    },
+                    "retell_llm_dynamic_variables": {
+                        "type": "object",
+                        "additionalProperties": {
+                            "type": "string"
+                        }
+                    },
+                    "current_node_id": {
+                        "type": "string",
+                        "nullable": true
+                    },
+                    "current_state": {
+                        "type": "string",
+                        "nullable": true
+                    }
+                }
+            },
+            "fields": [
+                {
+                    "name": "agent_id",
+                    "flag": "--agent-id",
+                    "required": true,
+                    "type": "string",
+                    "description": "Unique id of agent used for the call. Your agent would contain the LLM Websocket url used for this call.",
+                    "example": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "9ac136edb99a2063b3091602181c8d2022fdccb5b514991319d58544c2e57e95"
+                },
+                {
+                    "name": "agent_version",
+                    "flag": "--agent-version",
+                    "required": false,
+                    "type": "oneOf",
+                    "description": "The version of the agent to use for the call.",
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "684cd44f848f81e904b8973188277a469c18a3514b8094f3817829afc286f07b"
+                },
+                {
+                    "name": "agent_override",
+                    "flag": "--agent-override",
+                    "required": false,
+                    "type": "object",
+                    "description": "For this particular call, override agent configuration with these settings. This allows you to customize agent behavior for individual calls without modifying the base agent.",
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "bf6fddff97fd4506afe9c37c0eac1edae28af369c56826673701f2ee8d8d1b89"
+                },
+                {
+                    "name": "metadata",
+                    "flag": "--metadata",
+                    "required": false,
+                    "type": "object",
+                    "description": "An arbitrary object for storage purpose only. You can put anything here like your internal customer id associated with the call. Not used for processing. You can later get this field from the call object.",
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "a2c799262a3ce3c19ef5cdd983bf3d12b43ab3c426227091b909dcb7054738c0"
+                },
+                {
+                    "name": "retell_llm_dynamic_variables",
+                    "flag": "--retell-llm-dynamic-variables",
+                    "required": false,
+                    "type": "object",
+                    "description": "Add optional dynamic variables in key value pairs of string that injects into your Response Engine prompt and tool description. Only applicable for Response Engine.",
+                    "example": {
+                        "customer_name": "John Doe"
+                    },
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "3f161562db4a7237942681ccf41abd9a699b0260591ddd0d154bfca063f449bf"
+                },
+                {
+                    "name": "current_node_id",
+                    "flag": "--current-node-id",
+                    "required": false,
+                    "type": "string",
+                    "description": "Start the call at this conversation flow node (stage). Must be a valid node id in the agent's conversation flow. Only applicable when the agent uses conversation flow as the response engine. Ignored for retell-llm agents.",
+                    "example": "collect_info",
+                    "array": false,
+                    "nullable": true,
+                    "contractHash": "e16b0c0d0cdce6a489ad1ac5bbb7534eb3cca67b3ad23818a640e2bce397a142"
+                },
+                {
+                    "name": "current_state",
+                    "flag": "--current-state",
+                    "required": false,
+                    "type": "string",
+                    "description": "Start the conversation in this state (stage). Must be a valid state name in the agent's Retell LLM. Only applicable when the agent uses Retell LLM with states. Ignored for conversation-flow agents.",
+                    "example": "information_collection",
+                    "array": false,
+                    "nullable": true,
+                    "contractHash": "e16b0c0d0cdce6a489ad1ac5bbb7534eb3cca67b3ad23818a640e2bce397a142"
+                }
+            ]
+        },
+        "responseContractHash": "45482a8f3e81d244ac5ed30eacac1fd2625bbd309f642637dea271d4c57fa860"
+    },
     {
         "operationId": "deleteAgent",
         "command": "delete-agent",
@@ -10433,7 +10565,7 @@ export const operations = [
                 }
             }
         ],
-        "responseContractHash": "1ad9ad9fc690ece6be02832d8ff70174f7e6fcc560e03aa0d0b029d60ed269b6"
+        "responseContractHash": "b14d904a975892f99c9dfb613d0f2d3b905f974c6a31bc34ad8b3fb12b061683"
     },
     {
         "operationId": "getChatAgent",
@@ -11143,7 +11275,7 @@ export const operations = [
                     "flag": "--inbound-webhook-url",
                     "required": false,
                     "type": "string",
-                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call.",
+                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call. Includes call_inbound.call_id for deduplication across HTTP retries. Early setup failures may not create a call history record.",
                     "example": "https://example.com/inbound-webhook",
                     "array": false,
                     "nullable": true,
@@ -11868,7 +12000,7 @@ export const operations = [
             "cursorField": "pagination_key",
             "hasMoreField": "has_more"
         },
-        "responseContractHash": "4304fe85343b4bbae6c61b7914cf6bf5eb9e54523a6be923a3f2a5e7eda7b0e3"
+        "responseContractHash": "36347cc7ec1f8e8a8a60283fc1ecc1b2bae30fb9501073d0acb650f3f320e1c4"
     },
     {
         "operationId": "listContactConversations",
@@ -12607,6 +12739,34 @@ export const operations = [
         "parameters": [],
         "responseContractHash": "11c25fb87d1be09b1f4d4de37012b2ae0741a611981c7fcee58da1c360a8ed10"
     },
+    {
+        "operationId": "listenLiveCall",
+        "command": "listen-live-call",
+        "method": "POST",
+        "path": "/v2/listen-live-call/{call_id}",
+        "description": "Mint a subscribe-only access token for an in-progress call so a client can listen to live audio. The returned token grants join + subscribe on the call's existing audio room; it cannot publish. The call must be in ONGOING status.",
+        "deprecated": false,
+        "authenticated": true,
+        "parameters": [
+            {
+                "name": "call_id",
+                "flag": "--call-id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "The call id to listen to.",
+                "array": false,
+                "style": "simple",
+                "explode": false,
+                "allowReserved": false,
+                "contractHash": "00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96",
+                "validationSchema": {
+                    "type": "string"
+                }
+            }
+        ],
+        "responseContractHash": "00a883c0c0f21e01478bbeb424748b225c9fcd29e3393909f81791ff5ec7e5d6"
+    },
     {
         "operationId": "publishAgentVersion",
         "command": "publish-agent-version",
@@ -12934,7 +13094,7 @@ export const operations = [
                 }
             }
         ],
-        "responseContractHash": "782083514cbfa16c7ac6734973289b4e959f2587b966212f779251715707d24d"
+        "responseContractHash": "62531dcc54900399151590ff19b8da06601726af27bd2530283f063efdf04742"
     },
     {
         "operationId": "runSyncJob",
@@ -13044,6 +13204,67 @@ export const operations = [
         ],
         "responseContractHash": "ca4902eb8a38d2da414fd61c103fdd9de69102c27704882bdc4cd6c8ad769346"
     },
+    {
+        "operationId": "takeOverLiveCall",
+        "command": "take-over-live-call",
+        "method": "POST",
+        "path": "/v2/take-over-live-call/{call_id}",
+        "description": "Take over an in-progress call from the AI agent. The agent stops responding and the specified live-listen participant is allowed to speak directly to the caller. The call must be in ONGOING status.",
+        "deprecated": false,
+        "authenticated": true,
+        "parameters": [
+            {
+                "name": "call_id",
+                "flag": "--call-id",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "The call id to take over.",
+                "array": false,
+                "style": "simple",
+                "explode": false,
+                "allowReserved": false,
+                "contractHash": "00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96",
+                "validationSchema": {
+                    "type": "string"
+                }
+            }
+        ],
+        "requestBody": {
+            "required": true,
+            "contentType": "application/json",
+            "propertyCount": 1,
+            "requiredFields": [
+                "participant_id"
+            ],
+            "validationSchema": {
+                "type": "object",
+                "required": [
+                    "participant_id"
+                ],
+                "properties": {
+                    "participant_id": {
+                        "type": "string"
+                    }
+                },
+                "additionalProperties": false
+            },
+            "fields": [
+                {
+                    "name": "participant_id",
+                    "flag": "--participant-id",
+                    "required": true,
+                    "type": "string",
+                    "description": "The id of the live-listen participant to upgrade, obtained when joining via /v2/listen-live-call.",
+                    "example": "listener_a1b2c3d4e5f6g7h8i9j0",
+                    "array": false,
+                    "nullable": false,
+                    "contractHash": "00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96"
+                }
+            ]
+        },
+        "responseContractHash": "a6ff74906d3096dbdef3f9a65e712f7bab7359b1c944eb8c6b2e9122ad071680"
+    },
     {
         "operationId": "testAppAuth",
         "command": "test-app-auth",
@@ -14471,7 +14692,7 @@ export const operations = [
                 }
             ]
         },
-        "responseContractHash": "1ad9ad9fc690ece6be02832d8ff70174f7e6fcc560e03aa0d0b029d60ed269b6"
+        "responseContractHash": "b14d904a975892f99c9dfb613d0f2d3b905f974c6a31bc34ad8b3fb12b061683"
     },
     {
         "operationId": "updateContact",
@@ -15364,7 +15585,7 @@ export const operations = [
                     "flag": "--inbound-webhook-url",
                     "required": false,
                     "type": "string",
-                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call.",
+                    "description": "If set, Retell will send a webhook for inbound calls, where you can override the agent ID, set dynamic variables, reject the call, and configure other fields specific to that call. Includes call_inbound.call_id for deduplication across HTTP retries. Early setup failures may not create a call history record.",
                     "example": "https://example.com/inbound-webhook",
                     "array": false,
                     "nullable": true,
@@ -15375,7 +15596,7 @@ export const operations = [
                     "flag": "--inbound-sms-webhook-url",
                     "required": false,
                     "type": "string",
-                    "description": "If set, Retell will send a webhook for inbound SMS, where you can override the agent ID, set dynamic variables, reject the SMS, and configure other fields specific to that chat.",
+                    "description": "If set, Retell will send a webhook for inbound SMS, where you can override the agent ID, set dynamic variables, reject the SMS, and configure other fields specific to that chat. Includes chat_inbound.chat_id for deduplication across HTTP retries. Early setup failures may not create a chat history record.",
                     "example": "https://example.com/inbound-sms-webhook",
                     "array": false,
                     "nullable": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retell-ai/retell-cli",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Generated command line interface for the Retell API",
   "license": "Apache-2.0",
   "repository": {