retell-sdk 6.2.6 → 6.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/package.json +1 -1
  3. package/resources/agent.d.mts +30 -3
  4. package/resources/agent.d.mts.map +1 -1
  5. package/resources/agent.d.ts +30 -3
  6. package/resources/agent.d.ts.map +1 -1
  7. package/resources/batch-call.d.mts +24 -7
  8. package/resources/batch-call.d.mts.map +1 -1
  9. package/resources/batch-call.d.ts +24 -7
  10. package/resources/batch-call.d.ts.map +1 -1
  11. package/resources/call.d.mts +74 -22
  12. package/resources/call.d.mts.map +1 -1
  13. package/resources/call.d.ts +74 -22
  14. package/resources/call.d.ts.map +1 -1
  15. package/resources/call.js +2 -1
  16. package/resources/call.js.map +1 -1
  17. package/resources/call.mjs +2 -1
  18. package/resources/call.mjs.map +1 -1
  19. package/resources/chat-agent.d.mts +19 -3
  20. package/resources/chat-agent.d.mts.map +1 -1
  21. package/resources/chat-agent.d.ts +19 -3
  22. package/resources/chat-agent.d.ts.map +1 -1
  23. package/resources/conversation-flow-component.d.mts +294 -42
  24. package/resources/conversation-flow-component.d.mts.map +1 -1
  25. package/resources/conversation-flow-component.d.ts +294 -42
  26. package/resources/conversation-flow-component.d.ts.map +1 -1
  27. package/resources/conversation-flow.d.mts +609 -87
  28. package/resources/conversation-flow.d.mts.map +1 -1
  29. package/resources/conversation-flow.d.ts +609 -87
  30. package/resources/conversation-flow.d.ts.map +1 -1
  31. package/resources/llm.d.mts +24 -3
  32. package/resources/llm.d.mts.map +1 -1
  33. package/resources/llm.d.ts +24 -3
  34. package/resources/llm.d.ts.map +1 -1
  35. package/resources/tests.d.mts +3 -3
  36. package/resources/tests.d.mts.map +1 -1
  37. package/resources/tests.d.ts +3 -3
  38. package/resources/tests.d.ts.map +1 -1
  39. package/src/resources/agent.ts +37 -0
  40. package/src/resources/batch-call.ts +27 -5
  41. package/src/resources/call.ts +83 -16
  42. package/src/resources/chat-agent.ts +24 -0
  43. package/src/resources/conversation-flow-component.ts +378 -42
  44. package/src/resources/conversation-flow.ts +783 -87
  45. package/src/resources/llm.ts +27 -0
  46. package/src/resources/tests.ts +6 -3
  47. package/src/version.ts +1 -1
  48. package/version.d.mts +1 -1
  49. package/version.d.ts +1 -1
  50. package/version.js +1 -1
  51. package/version.mjs +1 -1
@@ -199,7 +199,9 @@ export namespace BatchCallCreateBatchCallParams {
199
199
  export interface AgentOverride {
200
200
  /**
201
201
  * Override agent configuration settings. Any properties specified here will
202
- * override the base agent configuration for this call.
202
+ * override the base agent configuration for this call. If a Retell LLM or
203
+ * Conversation Flow response engine is specified without a version, it uses the
204
+ * latest version.
203
205
  */
204
206
  agent?: AgentOverride.Agent;
205
207
 
@@ -214,7 +216,7 @@ export namespace BatchCallCreateBatchCallParams {
214
216
  /**
215
217
  * Override Retell LLM configuration settings. Only applicable when using Retell
216
218
  * LLM as the response engine. Supported attributes - model, s2s_model,
217
- * model_temperature, model_high_priority, tool_call_strict_mode,
219
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
218
220
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
219
221
  * begin_message.
220
222
  */
@@ -224,7 +226,9 @@ export namespace BatchCallCreateBatchCallParams {
224
226
  export namespace AgentOverride {
225
227
  /**
226
228
  * Override agent configuration settings. Any properties specified here will
227
- * override the base agent configuration for this call.
229
+ * override the base agent configuration for this call. If a Retell LLM or
230
+ * Conversation Flow response engine is specified without a version, it uses the
231
+ * latest version.
228
232
  */
229
233
  export interface Agent {
230
234
  /**
@@ -680,6 +684,7 @@ export namespace BatchCallCreateBatchCallParams {
680
684
  | 'gemini-3.6-flash'
681
685
  | 'gemini-3.7-flash'
682
686
  | 'gemini-3.8-flash'
687
+ | 'gemini-4-argon'
683
688
  | null;
684
689
 
685
690
  /**
@@ -2515,7 +2520,8 @@ export namespace BatchCallCreateBatchCallParams {
2515
2520
  | 'gemini-3.5-flash-lite'
2516
2521
  | 'gemini-3.6-flash'
2517
2522
  | 'gemini-3.7-flash'
2518
- | 'gemini-3.8-flash';
2523
+ | 'gemini-3.8-flash'
2524
+ | 'gemini-4-argon';
2519
2525
 
2520
2526
  /**
2521
2527
  * Type of model choice
@@ -2526,6 +2532,13 @@ export namespace BatchCallCreateBatchCallParams {
2526
2532
  * Whether to use high priority pool with more dedicated resource, default false
2527
2533
  */
2528
2534
  high_priority?: boolean;
2535
+
2536
+ /**
2537
+ * Whether to use the ultrafast tier for much faster response generation, default
2538
+ * false. Only supported by gpt-6.1-sol on voice agents; ignored otherwise. Takes
2539
+ * precedence over high_priority.
2540
+ */
2541
+ ultrafast?: boolean;
2529
2542
  }
2530
2543
 
2531
2544
  export interface ModelChoiceS2S {
@@ -2550,7 +2563,7 @@ export namespace BatchCallCreateBatchCallParams {
2550
2563
  /**
2551
2564
  * Override Retell LLM configuration settings. Only applicable when using Retell
2552
2565
  * LLM as the response engine. Supported attributes - model, s2s_model,
2553
- * model_temperature, model_high_priority, tool_call_strict_mode,
2566
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
2554
2567
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
2555
2568
  * begin_message.
2556
2569
  */
@@ -2614,6 +2627,7 @@ export namespace BatchCallCreateBatchCallParams {
2614
2627
  | 'gemini-3.6-flash'
2615
2628
  | 'gemini-3.7-flash'
2616
2629
  | 'gemini-3.8-flash'
2630
+ | 'gemini-4-argon'
2617
2631
  | null;
2618
2632
 
2619
2633
  /**
@@ -2631,6 +2645,14 @@ export namespace BatchCallCreateBatchCallParams {
2631
2645
  */
2632
2646
  model_temperature?: number;
2633
2647
 
2648
+ /**
2649
+ * If set to true, will use the ultrafast tier for much faster response generation,
2650
+ * default to false. Only supported by gpt-6.1-sol on voice agents; ignored
2651
+ * otherwise. Takes precedence over model_high_priority. This feature comes with a
2652
+ * higher cost.
2653
+ */
2654
+ model_ultrafast?: boolean | null;
2655
+
2634
2656
  /**
2635
2657
  * Select the underlying speech to speech model. Can only set this or model, not
2636
2658
  * both.
@@ -177,7 +177,8 @@ export class Call extends APIResource {
177
177
  /**
178
178
  * Take over an in-progress call from the AI agent. The agent stops responding and
179
179
  * the specified live-listen participant is allowed to speak directly to the
180
- * caller. The call must be in ONGOING status.
180
+ * caller. The call must be in ONGOING status. Gateway calls cannot be taken over
181
+ * while a PCI session is active.
181
182
  *
182
183
  * @example
183
184
  * ```ts
@@ -7122,7 +7123,9 @@ export namespace CallCreatePhoneCallParams {
7122
7123
  export interface AgentOverride {
7123
7124
  /**
7124
7125
  * Override agent configuration settings. Any properties specified here will
7125
- * override the base agent configuration for this call.
7126
+ * override the base agent configuration for this call. If a Retell LLM or
7127
+ * Conversation Flow response engine is specified without a version, it uses the
7128
+ * latest version.
7126
7129
  */
7127
7130
  agent?: AgentOverride.Agent;
7128
7131
 
@@ -7137,7 +7140,7 @@ export namespace CallCreatePhoneCallParams {
7137
7140
  /**
7138
7141
  * Override Retell LLM configuration settings. Only applicable when using Retell
7139
7142
  * LLM as the response engine. Supported attributes - model, s2s_model,
7140
- * model_temperature, model_high_priority, tool_call_strict_mode,
7143
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
7141
7144
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
7142
7145
  * begin_message.
7143
7146
  */
@@ -7147,7 +7150,9 @@ export namespace CallCreatePhoneCallParams {
7147
7150
  export namespace AgentOverride {
7148
7151
  /**
7149
7152
  * Override agent configuration settings. Any properties specified here will
7150
- * override the base agent configuration for this call.
7153
+ * override the base agent configuration for this call. If a Retell LLM or
7154
+ * Conversation Flow response engine is specified without a version, it uses the
7155
+ * latest version.
7151
7156
  */
7152
7157
  export interface Agent {
7153
7158
  /**
@@ -7603,6 +7608,7 @@ export namespace CallCreatePhoneCallParams {
7603
7608
  | 'gemini-3.6-flash'
7604
7609
  | 'gemini-3.7-flash'
7605
7610
  | 'gemini-3.8-flash'
7611
+ | 'gemini-4-argon'
7606
7612
  | null;
7607
7613
 
7608
7614
  /**
@@ -9438,7 +9444,8 @@ export namespace CallCreatePhoneCallParams {
9438
9444
  | 'gemini-3.5-flash-lite'
9439
9445
  | 'gemini-3.6-flash'
9440
9446
  | 'gemini-3.7-flash'
9441
- | 'gemini-3.8-flash';
9447
+ | 'gemini-3.8-flash'
9448
+ | 'gemini-4-argon';
9442
9449
 
9443
9450
  /**
9444
9451
  * Type of model choice
@@ -9449,6 +9456,13 @@ export namespace CallCreatePhoneCallParams {
9449
9456
  * Whether to use high priority pool with more dedicated resource, default false
9450
9457
  */
9451
9458
  high_priority?: boolean;
9459
+
9460
+ /**
9461
+ * Whether to use the ultrafast tier for much faster response generation, default
9462
+ * false. Only supported by gpt-6.1-sol on voice agents; ignored otherwise. Takes
9463
+ * precedence over high_priority.
9464
+ */
9465
+ ultrafast?: boolean;
9452
9466
  }
9453
9467
 
9454
9468
  export interface ModelChoiceS2S {
@@ -9473,7 +9487,7 @@ export namespace CallCreatePhoneCallParams {
9473
9487
  /**
9474
9488
  * Override Retell LLM configuration settings. Only applicable when using Retell
9475
9489
  * LLM as the response engine. Supported attributes - model, s2s_model,
9476
- * model_temperature, model_high_priority, tool_call_strict_mode,
9490
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
9477
9491
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
9478
9492
  * begin_message.
9479
9493
  */
@@ -9537,6 +9551,7 @@ export namespace CallCreatePhoneCallParams {
9537
9551
  | 'gemini-3.6-flash'
9538
9552
  | 'gemini-3.7-flash'
9539
9553
  | 'gemini-3.8-flash'
9554
+ | 'gemini-4-argon'
9540
9555
  | null;
9541
9556
 
9542
9557
  /**
@@ -9554,6 +9569,14 @@ export namespace CallCreatePhoneCallParams {
9554
9569
  */
9555
9570
  model_temperature?: number;
9556
9571
 
9572
+ /**
9573
+ * If set to true, will use the ultrafast tier for much faster response generation,
9574
+ * default to false. Only supported by gpt-6.1-sol on voice agents; ignored
9575
+ * otherwise. Takes precedence over model_high_priority. This feature comes with a
9576
+ * higher cost.
9577
+ */
9578
+ model_ultrafast?: boolean | null;
9579
+
9557
9580
  /**
9558
9581
  * Select the underlying speech to speech model. Can only set this or model, not
9559
9582
  * both.
@@ -9656,7 +9679,9 @@ export namespace CallCreateWebCallParams {
9656
9679
  export interface AgentOverride {
9657
9680
  /**
9658
9681
  * Override agent configuration settings. Any properties specified here will
9659
- * override the base agent configuration for this call.
9682
+ * override the base agent configuration for this call. If a Retell LLM or
9683
+ * Conversation Flow response engine is specified without a version, it uses the
9684
+ * latest version.
9660
9685
  */
9661
9686
  agent?: AgentOverride.Agent;
9662
9687
 
@@ -9671,7 +9696,7 @@ export namespace CallCreateWebCallParams {
9671
9696
  /**
9672
9697
  * Override Retell LLM configuration settings. Only applicable when using Retell
9673
9698
  * LLM as the response engine. Supported attributes - model, s2s_model,
9674
- * model_temperature, model_high_priority, tool_call_strict_mode,
9699
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
9675
9700
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
9676
9701
  * begin_message.
9677
9702
  */
@@ -9681,7 +9706,9 @@ export namespace CallCreateWebCallParams {
9681
9706
  export namespace AgentOverride {
9682
9707
  /**
9683
9708
  * Override agent configuration settings. Any properties specified here will
9684
- * override the base agent configuration for this call.
9709
+ * override the base agent configuration for this call. If a Retell LLM or
9710
+ * Conversation Flow response engine is specified without a version, it uses the
9711
+ * latest version.
9685
9712
  */
9686
9713
  export interface Agent {
9687
9714
  /**
@@ -10137,6 +10164,7 @@ export namespace CallCreateWebCallParams {
10137
10164
  | 'gemini-3.6-flash'
10138
10165
  | 'gemini-3.7-flash'
10139
10166
  | 'gemini-3.8-flash'
10167
+ | 'gemini-4-argon'
10140
10168
  | null;
10141
10169
 
10142
10170
  /**
@@ -11972,7 +12000,8 @@ export namespace CallCreateWebCallParams {
11972
12000
  | 'gemini-3.5-flash-lite'
11973
12001
  | 'gemini-3.6-flash'
11974
12002
  | 'gemini-3.7-flash'
11975
- | 'gemini-3.8-flash';
12003
+ | 'gemini-3.8-flash'
12004
+ | 'gemini-4-argon';
11976
12005
 
11977
12006
  /**
11978
12007
  * Type of model choice
@@ -11983,6 +12012,13 @@ export namespace CallCreateWebCallParams {
11983
12012
  * Whether to use high priority pool with more dedicated resource, default false
11984
12013
  */
11985
12014
  high_priority?: boolean;
12015
+
12016
+ /**
12017
+ * Whether to use the ultrafast tier for much faster response generation, default
12018
+ * false. Only supported by gpt-6.1-sol on voice agents; ignored otherwise. Takes
12019
+ * precedence over high_priority.
12020
+ */
12021
+ ultrafast?: boolean;
11986
12022
  }
11987
12023
 
11988
12024
  export interface ModelChoiceS2S {
@@ -12007,7 +12043,7 @@ export namespace CallCreateWebCallParams {
12007
12043
  /**
12008
12044
  * Override Retell LLM configuration settings. Only applicable when using Retell
12009
12045
  * LLM as the response engine. Supported attributes - model, s2s_model,
12010
- * model_temperature, model_high_priority, tool_call_strict_mode,
12046
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
12011
12047
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
12012
12048
  * begin_message.
12013
12049
  */
@@ -12071,6 +12107,7 @@ export namespace CallCreateWebCallParams {
12071
12107
  | 'gemini-3.6-flash'
12072
12108
  | 'gemini-3.7-flash'
12073
12109
  | 'gemini-3.8-flash'
12110
+ | 'gemini-4-argon'
12074
12111
  | null;
12075
12112
 
12076
12113
  /**
@@ -12088,6 +12125,14 @@ export namespace CallCreateWebCallParams {
12088
12125
  */
12089
12126
  model_temperature?: number;
12090
12127
 
12128
+ /**
12129
+ * If set to true, will use the ultrafast tier for much faster response generation,
12130
+ * default to false. Only supported by gpt-6.1-sol on voice agents; ignored
12131
+ * otherwise. Takes precedence over model_high_priority. This feature comes with a
12132
+ * higher cost.
12133
+ */
12134
+ model_ultrafast?: boolean | null;
12135
+
12091
12136
  /**
12092
12137
  * Select the underlying speech to speech model. Can only set this or model, not
12093
12138
  * both.
@@ -12190,7 +12235,9 @@ export namespace CallRegisterPhoneCallParams {
12190
12235
  export interface AgentOverride {
12191
12236
  /**
12192
12237
  * Override agent configuration settings. Any properties specified here will
12193
- * override the base agent configuration for this call.
12238
+ * override the base agent configuration for this call. If a Retell LLM or
12239
+ * Conversation Flow response engine is specified without a version, it uses the
12240
+ * latest version.
12194
12241
  */
12195
12242
  agent?: AgentOverride.Agent;
12196
12243
 
@@ -12205,7 +12252,7 @@ export namespace CallRegisterPhoneCallParams {
12205
12252
  /**
12206
12253
  * Override Retell LLM configuration settings. Only applicable when using Retell
12207
12254
  * LLM as the response engine. Supported attributes - model, s2s_model,
12208
- * model_temperature, model_high_priority, tool_call_strict_mode,
12255
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
12209
12256
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
12210
12257
  * begin_message.
12211
12258
  */
@@ -12215,7 +12262,9 @@ export namespace CallRegisterPhoneCallParams {
12215
12262
  export namespace AgentOverride {
12216
12263
  /**
12217
12264
  * Override agent configuration settings. Any properties specified here will
12218
- * override the base agent configuration for this call.
12265
+ * override the base agent configuration for this call. If a Retell LLM or
12266
+ * Conversation Flow response engine is specified without a version, it uses the
12267
+ * latest version.
12219
12268
  */
12220
12269
  export interface Agent {
12221
12270
  /**
@@ -12671,6 +12720,7 @@ export namespace CallRegisterPhoneCallParams {
12671
12720
  | 'gemini-3.6-flash'
12672
12721
  | 'gemini-3.7-flash'
12673
12722
  | 'gemini-3.8-flash'
12723
+ | 'gemini-4-argon'
12674
12724
  | null;
12675
12725
 
12676
12726
  /**
@@ -14506,7 +14556,8 @@ export namespace CallRegisterPhoneCallParams {
14506
14556
  | 'gemini-3.5-flash-lite'
14507
14557
  | 'gemini-3.6-flash'
14508
14558
  | 'gemini-3.7-flash'
14509
- | 'gemini-3.8-flash';
14559
+ | 'gemini-3.8-flash'
14560
+ | 'gemini-4-argon';
14510
14561
 
14511
14562
  /**
14512
14563
  * Type of model choice
@@ -14517,6 +14568,13 @@ export namespace CallRegisterPhoneCallParams {
14517
14568
  * Whether to use high priority pool with more dedicated resource, default false
14518
14569
  */
14519
14570
  high_priority?: boolean;
14571
+
14572
+ /**
14573
+ * Whether to use the ultrafast tier for much faster response generation, default
14574
+ * false. Only supported by gpt-6.1-sol on voice agents; ignored otherwise. Takes
14575
+ * precedence over high_priority.
14576
+ */
14577
+ ultrafast?: boolean;
14520
14578
  }
14521
14579
 
14522
14580
  export interface ModelChoiceS2S {
@@ -14541,7 +14599,7 @@ export namespace CallRegisterPhoneCallParams {
14541
14599
  /**
14542
14600
  * Override Retell LLM configuration settings. Only applicable when using Retell
14543
14601
  * LLM as the response engine. Supported attributes - model, s2s_model,
14544
- * model_temperature, model_high_priority, tool_call_strict_mode,
14602
+ * model_temperature, model_high_priority, model_ultrafast, tool_call_strict_mode,
14545
14603
  * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
14546
14604
  * begin_message.
14547
14605
  */
@@ -14605,6 +14663,7 @@ export namespace CallRegisterPhoneCallParams {
14605
14663
  | 'gemini-3.6-flash'
14606
14664
  | 'gemini-3.7-flash'
14607
14665
  | 'gemini-3.8-flash'
14666
+ | 'gemini-4-argon'
14608
14667
  | null;
14609
14668
 
14610
14669
  /**
@@ -14622,6 +14681,14 @@ export namespace CallRegisterPhoneCallParams {
14622
14681
  */
14623
14682
  model_temperature?: number;
14624
14683
 
14684
+ /**
14685
+ * If set to true, will use the ultrafast tier for much faster response generation,
14686
+ * default to false. Only supported by gpt-6.1-sol on voice agents; ignored
14687
+ * otherwise. Takes precedence over model_high_priority. This feature comes with a
14688
+ * higher cost.
14689
+ */
14690
+ model_ultrafast?: boolean | null;
14691
+
14625
14692
  /**
14626
14693
  * Select the underlying speech to speech model. Can only set this or model, not
14627
14694
  * both.
@@ -456,6 +456,7 @@ export interface ChatAgentResponse {
456
456
  | 'gemini-3.6-flash'
457
457
  | 'gemini-3.7-flash'
458
458
  | 'gemini-3.8-flash'
459
+ | 'gemini-4-argon'
459
460
  | null;
460
461
 
461
462
  /**
@@ -1912,6 +1913,11 @@ export namespace ChatAgentListResponse {
1912
1913
  * update or creation if no updates available.
1913
1914
  */
1914
1915
  user_modified_timestamp: number;
1916
+
1917
+ /**
1918
+ * Whether the agent is a transfer agent used for agentic warm transfer.
1919
+ */
1920
+ is_transfer_agent?: boolean;
1915
1921
  }
1916
1922
 
1917
1923
  export namespace Item {
@@ -2187,6 +2193,7 @@ export interface ChatAgentCreateParams {
2187
2193
  | 'gemini-3.6-flash'
2188
2194
  | 'gemini-3.7-flash'
2189
2195
  | 'gemini-3.8-flash'
2196
+ | 'gemini-4-argon'
2190
2197
  | null;
2191
2198
 
2192
2199
  /**
@@ -3867,6 +3874,7 @@ export interface ChatAgentUpdateParams {
3867
3874
  | 'gemini-3.6-flash'
3868
3875
  | 'gemini-3.7-flash'
3869
3876
  | 'gemini-3.8-flash'
3877
+ | 'gemini-4-argon'
3870
3878
  | null;
3871
3879
 
3872
3880
  /**
@@ -5323,6 +5331,11 @@ export namespace ChatAgentListParams {
5323
5331
  export interface FilterCriteria {
5324
5332
  channel?: FilterCriteria.Channel;
5325
5333
 
5334
+ /**
5335
+ * Filter by whether the agent is a transfer agent.
5336
+ */
5337
+ is_transfer_agent?: FilterCriteria.IsTransferAgent;
5338
+
5326
5339
  /**
5327
5340
  * Case-insensitive substring search over agent name, plus substring search over
5328
5341
  * agent id.
@@ -5341,6 +5354,17 @@ export namespace ChatAgentListParams {
5341
5354
 
5342
5355
  value: 'voice' | 'chat';
5343
5356
  }
5357
+
5358
+ /**
5359
+ * Filter by whether the agent is a transfer agent.
5360
+ */
5361
+ export interface IsTransferAgent {
5362
+ op: 'eq';
5363
+
5364
+ type: 'boolean';
5365
+
5366
+ value: boolean;
5367
+ }
5344
5368
  }
5345
5369
  }
5346
5370