retell-utils 0.3.3 → 0.4.1

package/dist/flow.js

@@ -1,15 +1,152 @@
 import { z } from "zod";
-/**
- * Zod schema for a conversation flow response. Validates structural fields and
- * passes through the rest (nodes, components, etc.) for forward compatibility.
- */
-export const ConversationFlowResponseSchema = z
-    .object({
+import { KbConfigSchema, McpConfigSchema } from "./agent.js";
+import { EquationCombinatorSchema, EquationOperatorSchema, FlowInstructionTypeSchema, FlowNodeTypeSchema, FlowTransitionConditionTypeSchema, LlmModelSchema, StartSpeakerSchema, } from "./enums.js";
+import { LlmToolSchema, TransferDestinationSchema, TransferOptionSchema, } from "./llm.js";
+// ---------------------------------------------------------------------------
+// Shared sub-schemas
+// ---------------------------------------------------------------------------
+/** Display position in the visual editor. */
+const DisplayPositionSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Flow nodes & edges
+// ---------------------------------------------------------------------------
+/** A single equation within an equation-type transition condition. */
+export const FlowEquationSchema = z.object({
+    left: z.string(),
+    operator: EquationOperatorSchema,
+    /** Right side is not required for "exists" and "not_exist" operators. */
+    right: z.string().optional(),
+});
+/** Transition condition on a flow edge. */
+export const FlowTransitionConditionSchema = z.object({
+    type: FlowTransitionConditionTypeSchema.optional(),
+    prompt: z.string().optional(),
+    equations: z.array(FlowEquationSchema).optional(),
+    operator: EquationCombinatorSchema.optional(),
+});
+/** Schema for a flow edge (transition between nodes). */
+export const FlowEdgeSchema = z.object({
+    id: z.string().optional(),
+    destination_node_id: z.string().optional(),
+    transition_condition: FlowTransitionConditionSchema.optional(),
+});
+/** A single turn in a fine-tune example transcript. */
+const FinetuneTranscriptTurnSchema = z.object({
+    role: z.string(),
+    content: z.string().optional(),
+});
+/** Fine-tune example for conversation or transition behavior. */
+const FinetuneExampleSchema = z.object({
+    id: z.string().optional(),
+    destination_node_id: z.string().optional(),
+    transcript: z.array(FinetuneTranscriptTurnSchema).optional(),
+});
+/** Global node setting (when this node should be entered). */
+const GlobalNodeSettingSchema = z.object({
+    condition: z.string().optional(),
+    positive_finetune_examples: z.array(FinetuneExampleSchema).optional(),
+    negative_finetune_examples: z.array(FinetuneExampleSchema).optional(),
+});
+/** Schema for a conversation flow node with all known fields explicit. */
+export const FlowNodeSchema = z.object({
+    // Common
+    id: z.string().optional(),
+    name: z.string().optional(),
+    type: FlowNodeTypeSchema.optional(),
+    instruction: z
+        .object({
+        type: FlowInstructionTypeSchema.optional(),
+        text: z.string().optional(),
+    })
+        .optional(),
+    display_position: DisplayPositionSchema.nullable().optional(),
+    // Edges
+    edges: z.array(FlowEdgeSchema).optional(),
+    edge: FlowEdgeSchema.optional(),
+    else_edge: FlowEdgeSchema.optional(),
+    skip_response_edge: FlowEdgeSchema.optional(),
+    // Conversation node fields
+    start_speaker: StartSpeakerSchema.optional(),
+    global_node_setting: GlobalNodeSettingSchema.optional(),
+    finetune_transition_examples: z
+        .array(FinetuneExampleSchema)
+        .nullable()
+        .optional(),
+    finetune_conversation_examples: z
+        .array(FinetuneExampleSchema)
+        .nullable()
+        .optional(),
+    // Function node fields
+    tool_id: z.string().optional(),
+    tool_type: z.string().optional(),
+    speak_during_execution: z.boolean().optional(),
+    wait_for_result: z.boolean().optional(),
+    // Transfer node fields
+    transfer_destination: TransferDestinationSchema.optional(),
+    transfer_option: TransferOptionSchema.optional(),
+});
+// ---------------------------------------------------------------------------
+// Flow components
+// ---------------------------------------------------------------------------
+/** A local component embedded within a conversation flow. */
+export const FlowComponentSchema = z.object({
+    name: z.string().optional(),
+    nodes: z.array(FlowNodeSchema).optional(),
+    tools: z.array(LlmToolSchema).nullable().optional(),
+    mcps: z.array(McpConfigSchema).nullable().optional(),
+    start_node_id: z.string().optional(),
+    begin_tag_display_position: DisplayPositionSchema.nullable().optional(),
+});
+// ---------------------------------------------------------------------------
+// Model choice
+// ---------------------------------------------------------------------------
+/** Model selection configuration for conversation flows. */
+const FlowModelChoiceSchema = z.object({
+    type: z.literal("cascading"),
+    model: LlmModelSchema,
+    high_priority: z.boolean().optional(),
+});
+// ---------------------------------------------------------------------------
+// Conversation flow response
+// ---------------------------------------------------------------------------
+/** Zod schema for a conversation flow response from the Retell API. */
+export const ConversationFlowResponseSchema = z.object({
+    // Required
     conversation_flow_id: z.string(),
     version: z.number(),
-    /** SDK types omit this, but the API returns it. */
-    is_published: z.boolean().optional(),
+    // Model
+    model_choice: FlowModelChoiceSchema.optional(),
+    model_temperature: z.number().nullable().optional(),
+    tool_call_strict_mode: z.boolean().nullable().optional(),
+    // Knowledge base
+    knowledge_base_ids: z.array(z.string()).nullable().optional(),
+    kb_config: KbConfigSchema.optional(),
+    // Conversation
+    start_speaker: StartSpeakerSchema.optional(),
+    begin_after_user_silence_ms: z.number().nullable().optional(),
     global_prompt: z.string().nullable().optional(),
-    nodes: z.array(z.looseObject({})).nullable().optional(),
-})
-    .passthrough();
+    is_published: z.boolean().optional(),
+    // Tools
+    tools: z.array(LlmToolSchema).nullable().optional(),
+    // Components
+    components: z.array(FlowComponentSchema).nullable().optional(),
+    // Nodes
+    nodes: z.array(FlowNodeSchema).nullable().optional(),
+    start_node_id: z.string().nullable().optional(),
+    // Dynamic variables
+    default_dynamic_variables: z
+        .record(z.string(), z.string())
+        .nullable()
+        .optional(),
+    // Layout
+    begin_tag_display_position: DisplayPositionSchema.nullable().optional(),
+    // MCP
+    mcps: z.array(McpConfigSchema).nullable().optional(),
+    // Transfer
+    is_transfer_llm: z.boolean().nullable().optional(),
+    // Undocumented but returned by the API
+    flex_mode: z.boolean().optional(),
+});

package/dist/index.d.ts

@@ -1,15 +1,17 @@
-export { CallStatusSchema, ChatStatusSchema, ChatTypeSchema, DataStorageSettingSchema, DisconnectionReasonSchema, UserSentimentSchema, } from "./enums.js";
+export { AgentLanguageSchema, AmbientSoundSchema, CallStatusSchema, ChatStatusSchema, ChatTypeSchema, DataStorageSettingSchema, DenoisingModeSchema, DisconnectionReasonSchema, EquationCombinatorSchema, EquationOperatorSchema, FlowInstructionTypeSchema, FlowNodeTypeSchema, FlowTransitionConditionTypeSchema, LlmModelSchema, LlmToolTypeSchema, ToolHttpMethodSchema, ToolParameterTypeSchema, PiiCategorySchema, PronunciationAlphabetSchema, S2sModelSchema, StartSpeakerSchema, SttModeSchema, UserSentimentSchema, VocabSpecializationSchema, VoiceEmotionSchema, VoicemailActionTypeSchema, VoiceModelSchema, WebhookEventSchema, } from "./enums.js";
 export { CallLatencySchema, LatencyMetricSchema } from "./latency.js";
 export { CallCostSchema, ChatCostSchema, LlmTokenUsageSchema, ProductCostSchema, } from "./cost.js";
 export { DTMFSchema, NodeTransitionSchema, TimestampedUtteranceSchema, ToolCallInvocationSchema, ToolCallResultSchema, TranscriptEntrySchema, UtteranceSchema, WordTimestampSchema, } from "./transcript.js";
 export { ChatMessageEntrySchema, ChatMessageSchema, ChatNodeTransitionSchema, ChatStateTransitionSchema, ChatToolCallInvocationSchema, ChatToolCallResultSchema, } from "./chat-messages.js";
-export { E164PhoneSchema, e164OrNullSchema } from "./phone.js";
+export { e164PhoneSchema as E164PhoneSchema, e164OrNullSchema } from "./phone.js";
+export { PhoneNumberAgentEntrySchema, PhoneNumberResponseSchema, } from "./phone-number.js";
 export { createCallAnalysisSchema, createChatAnalysisSchema } from "./analysis.js";
 export { type CallSchemaConfig, CallSchemas, callSchemaDefaults, createCallSchemas, } from "./call.js";
 export { type ChatSchemaConfig, ChatSchemas, chatSchemaDefaults, createChatSchemas, } from "./chat.js";
 export { WebhookSchemas, createWebhookSchemas } from "./webhook.js";
-export { ChatAgentResponseSchema, ResponseEngineConversationFlowSchema, ResponseEngineCustomLlmSchema, ResponseEngineRetellLlmSchema, ResponseEngineSchema, VoiceAgentResponseSchema, } from "./agent.js";
-export { LlmResponseSchema } from "./llm.js";
-export { ConversationFlowResponseSchema } from "./flow.js";
+export { ChatAgentResponseSchema, GuardrailConfigSchema, KbConfigSchema, McpConfigSchema, PiiConfigSchema, PostAnalysisFieldSchema, PronunciationEntrySchema, ResponseEngineConversationFlowSchema, ResponseEngineCustomLlmSchema, ResponseEngineRetellLlmSchema, ResponseEngineSchema, VoiceAgentResponseSchema, } from "./agent.js";
+export { LlmResponseSchema, LlmStateEdgeSchema, LlmStateSchema, LlmToolSchema, TransferDestinationSchema, TransferOptionSchema, } from "./llm.js";
+export { ConversationFlowResponseSchema, FlowComponentSchema, FlowEdgeSchema, FlowEquationSchema, FlowNodeSchema, FlowTransitionConditionSchema, } from "./flow.js";
 export { InputMatchRuleSchema, TestCaseDefinitionSchema, TestCaseResponseEngineSchema, ToolMockSchema, } from "./test-case.js";
 export { retellPagination } from "./pagination.js";
+export { pluralize, resolveFilePlaceholders, toSnakeCase } from "./utils.js";

package/dist/index.js

@@ -1,5 +1,5 @@
 // Enums
-export { CallStatusSchema, ChatStatusSchema, ChatTypeSchema, DataStorageSettingSchema, DisconnectionReasonSchema, UserSentimentSchema, } from "./enums.js";
+export { AgentLanguageSchema, AmbientSoundSchema, CallStatusSchema, ChatStatusSchema, ChatTypeSchema, DataStorageSettingSchema, DenoisingModeSchema, DisconnectionReasonSchema, EquationCombinatorSchema, EquationOperatorSchema, FlowInstructionTypeSchema, FlowNodeTypeSchema, FlowTransitionConditionTypeSchema, LlmModelSchema, LlmToolTypeSchema, ToolHttpMethodSchema, ToolParameterTypeSchema, PiiCategorySchema, PronunciationAlphabetSchema, S2sModelSchema, StartSpeakerSchema, SttModeSchema, UserSentimentSchema, VocabSpecializationSchema, VoiceEmotionSchema, VoicemailActionTypeSchema, VoiceModelSchema, WebhookEventSchema, } from "./enums.js";
 // Latency
 export { CallLatencySchema, LatencyMetricSchema } from "./latency.js";
 // Cost
@@ -9,7 +9,9 @@ export { DTMFSchema, NodeTransitionSchema, TimestampedUtteranceSchema, ToolCallI
 // Chat message entries
 export { ChatMessageEntrySchema, ChatMessageSchema, ChatNodeTransitionSchema, ChatStateTransitionSchema, ChatToolCallInvocationSchema, ChatToolCallResultSchema, } from "./chat-messages.js";
 // Phone number validation
-export { E164PhoneSchema, e164OrNullSchema } from "./phone.js";
+export { e164PhoneSchema as E164PhoneSchema, e164OrNullSchema } from "./phone.js";
+// Phone number API response
+export { PhoneNumberAgentEntrySchema, PhoneNumberResponseSchema, } from "./phone-number.js";
 // Analysis
 export { createCallAnalysisSchema, createChatAnalysisSchema } from "./analysis.js";
 // Call schemas + factory
@@ -19,12 +21,14 @@ export { ChatSchemas, chatSchemaDefaults, createChatSchemas, } from "./chat.js";
 // Webhook schemas + factory
 export { WebhookSchemas, createWebhookSchemas } from "./webhook.js";
 // Agent config schemas
-export { ChatAgentResponseSchema, ResponseEngineConversationFlowSchema, ResponseEngineCustomLlmSchema, ResponseEngineRetellLlmSchema, ResponseEngineSchema, VoiceAgentResponseSchema, } from "./agent.js";
+export { ChatAgentResponseSchema, GuardrailConfigSchema, KbConfigSchema, McpConfigSchema, PiiConfigSchema, PostAnalysisFieldSchema, PronunciationEntrySchema, ResponseEngineConversationFlowSchema, ResponseEngineCustomLlmSchema, ResponseEngineRetellLlmSchema, ResponseEngineSchema, VoiceAgentResponseSchema, } from "./agent.js";
 // LLM config schemas
-export { LlmResponseSchema } from "./llm.js";
+export { LlmResponseSchema, LlmStateEdgeSchema, LlmStateSchema, LlmToolSchema, TransferDestinationSchema, TransferOptionSchema, } from "./llm.js";
 // Conversation flow config schemas
-export { ConversationFlowResponseSchema } from "./flow.js";
+export { ConversationFlowResponseSchema, FlowComponentSchema, FlowEdgeSchema, FlowEquationSchema, FlowNodeSchema, FlowTransitionConditionSchema, } from "./flow.js";
 // Test case schemas
 export { InputMatchRuleSchema, TestCaseDefinitionSchema, TestCaseResponseEngineSchema, ToolMockSchema, } from "./test-case.js";
 // Pagination utility
 export { retellPagination } from "./pagination.js";
+// General utilities
+export { pluralize, resolveFilePlaceholders, toSnakeCase } from "./utils.js";

package/dist/llm.d.ts

@@ -1,13 +1,388 @@
 import { z } from "zod";
+/** Transfer destination configuration. */
+export declare const TransferDestinationSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    number: z.ZodOptional<z.ZodString>;
+    extension: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Transfer option configuration (warm/cold transfer behavior). */
+export declare const TransferOptionSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    option: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    public_handoff_option: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    private_handoff_option: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    on_hold_music: z.ZodOptional<z.ZodString>;
+    opt_out_initial_message: z.ZodOptional<z.ZodBoolean>;
+    opt_out_human_detection: z.ZodOptional<z.ZodBoolean>;
+    agent_detection_timeout_ms: z.ZodOptional<z.ZodNumber>;
+    show_transferee_as_caller: z.ZodOptional<z.ZodBoolean>;
+    enable_bridge_audio_cue: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 /**
- * Zod schema for a Retell LLM response. Validates structural fields and passes
- * through all other fields (tools, states, etc.) for forward compatibility.
+ * Schema for an LLM tool. Tools are highly polymorphic (end_call,
+ * transfer_call, custom, cal, etc.) so we explicitly declare all known fields
+ * and use catchall to preserve any we haven't seen yet.
  */
+export declare const LlmToolSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        transfer_call: "transfer_call";
+        press_digit: "press_digit";
+        agent_swap: "agent_swap";
+        mcp: "mcp";
+        end_call: "end_call";
+        check_availability_cal: "check_availability_cal";
+        book_appointment_cal: "book_appointment_cal";
+        custom: "custom";
+        extract_dynamic_variable: "extract_dynamic_variable";
+        send_sms: "send_sms";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tool_id: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PATCH: "PATCH";
+        PUT: "PUT";
+        DELETE: "DELETE";
+    }>>;
+    parameter_type: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        form: "form";
+    }>>;
+    parameters: z.ZodOptional<z.ZodUnknown>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    query_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    args_at_root: z.ZodOptional<z.ZodBoolean>;
+    timeout_ms: z.ZodOptional<z.ZodNumber>;
+    response_variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    speak_during_execution: z.ZodOptional<z.ZodBoolean>;
+    speak_after_execution: z.ZodOptional<z.ZodBoolean>;
+    execution_message_description: z.ZodOptional<z.ZodString>;
+    transfer_destination: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodString>;
+        extension: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    transfer_option: z.ZodOptional<z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        option: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        public_handoff_option: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        private_handoff_option: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        on_hold_music: z.ZodOptional<z.ZodString>;
+        opt_out_initial_message: z.ZodOptional<z.ZodBoolean>;
+        opt_out_human_detection: z.ZodOptional<z.ZodBoolean>;
+        agent_detection_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        show_transferee_as_caller: z.ZodOptional<z.ZodBoolean>;
+        enable_bridge_audio_cue: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    custom_sip_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cal_api_key: z.ZodOptional<z.ZodString>;
+    event_type_id: z.ZodOptional<z.ZodNumber>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** State transition edge within multi-prompt LLM. */
+export declare const LlmStateEdgeSchema: z.ZodObject<{
+    destination_state_name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+/** A state within a multi-prompt LLM. */
+export declare const LlmStateSchema: z.ZodObject<{
+    name: z.ZodString;
+    state_prompt: z.ZodOptional<z.ZodString>;
+    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        destination_state_name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>>;
+    tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            transfer_call: "transfer_call";
+            press_digit: "press_digit";
+            agent_swap: "agent_swap";
+            mcp: "mcp";
+            end_call: "end_call";
+            check_availability_cal: "check_availability_cal";
+            book_appointment_cal: "book_appointment_cal";
+            custom: "custom";
+            extract_dynamic_variable: "extract_dynamic_variable";
+            send_sms: "send_sms";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        tool_id: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        method: z.ZodOptional<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PATCH: "PATCH";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        parameter_type: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            form: "form";
+        }>>;
+        parameters: z.ZodOptional<z.ZodUnknown>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        query_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        args_at_root: z.ZodOptional<z.ZodBoolean>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        response_variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        speak_during_execution: z.ZodOptional<z.ZodBoolean>;
+        speak_after_execution: z.ZodOptional<z.ZodBoolean>;
+        execution_message_description: z.ZodOptional<z.ZodString>;
+        transfer_destination: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+            number: z.ZodOptional<z.ZodString>;
+            extension: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        transfer_option: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            public_handoff_option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            private_handoff_option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            on_hold_music: z.ZodOptional<z.ZodString>;
+            opt_out_initial_message: z.ZodOptional<z.ZodBoolean>;
+            opt_out_human_detection: z.ZodOptional<z.ZodBoolean>;
+            agent_detection_timeout_ms: z.ZodOptional<z.ZodNumber>;
+            show_transferee_as_caller: z.ZodOptional<z.ZodBoolean>;
+            enable_bridge_audio_cue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        custom_sip_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cal_api_key: z.ZodOptional<z.ZodString>;
+        event_type_id: z.ZodOptional<z.ZodNumber>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/** Zod schema for a Retell LLM response from the API. */
 export declare const LlmResponseSchema: z.ZodObject<{
     llm_id: z.ZodString;
     last_modification_timestamp: z.ZodNumber;
     version: z.ZodOptional<z.ZodNumber>;
     is_published: z.ZodOptional<z.ZodBoolean>;
-    general_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        "gpt-4.1": "gpt-4.1";
+        "gpt-4.1-mini": "gpt-4.1-mini";
+        "gpt-4.1-nano": "gpt-4.1-nano";
+        "gpt-5": "gpt-5";
+        "gpt-5.1": "gpt-5.1";
+        "gpt-5.2": "gpt-5.2";
+        "gpt-5-mini": "gpt-5-mini";
+        "gpt-5-nano": "gpt-5-nano";
+        "claude-4.5-sonnet": "claude-4.5-sonnet";
+        "claude-4.5-haiku": "claude-4.5-haiku";
+        "gemini-2.5-flash": "gemini-2.5-flash";
+        "gemini-2.5-flash-lite": "gemini-2.5-flash-lite";
+        "gemini-3.0-flash": "gemini-3.0-flash";
+    }>>>;
+    s2s_model: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        "gpt-4o-realtime": "gpt-4o-realtime";
+        "gpt-4o-mini-realtime": "gpt-4o-mini-realtime";
+        "gpt-realtime": "gpt-realtime";
+        "gpt-realtime-mini": "gpt-realtime-mini";
+    }>>>;
+    model_temperature: z.ZodOptional<z.ZodNumber>;
+    model_high_priority: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    tool_call_strict_mode: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    knowledge_base_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    kb_config: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        top_k: z.ZodOptional<z.ZodNumber>;
+        filter_score: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    start_speaker: z.ZodOptional<z.ZodEnum<{
+        user: "user";
+        agent: "agent";
+    }>>;
+    begin_after_user_silence_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     begin_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$loose>;
+    general_prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    general_tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            transfer_call: "transfer_call";
+            press_digit: "press_digit";
+            agent_swap: "agent_swap";
+            mcp: "mcp";
+            end_call: "end_call";
+            check_availability_cal: "check_availability_cal";
+            book_appointment_cal: "book_appointment_cal";
+            custom: "custom";
+            extract_dynamic_variable: "extract_dynamic_variable";
+            send_sms: "send_sms";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        tool_id: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        method: z.ZodOptional<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PATCH: "PATCH";
+            PUT: "PUT";
+            DELETE: "DELETE";
+        }>>;
+        parameter_type: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            form: "form";
+        }>>;
+        parameters: z.ZodOptional<z.ZodUnknown>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        query_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        args_at_root: z.ZodOptional<z.ZodBoolean>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        response_variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        speak_during_execution: z.ZodOptional<z.ZodBoolean>;
+        speak_after_execution: z.ZodOptional<z.ZodBoolean>;
+        execution_message_description: z.ZodOptional<z.ZodString>;
+        transfer_destination: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+            number: z.ZodOptional<z.ZodString>;
+            extension: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        transfer_option: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            public_handoff_option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            private_handoff_option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            on_hold_music: z.ZodOptional<z.ZodString>;
+            opt_out_initial_message: z.ZodOptional<z.ZodBoolean>;
+            opt_out_human_detection: z.ZodOptional<z.ZodBoolean>;
+            agent_detection_timeout_ms: z.ZodOptional<z.ZodNumber>;
+            show_transferee_as_caller: z.ZodOptional<z.ZodBoolean>;
+            enable_bridge_audio_cue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        custom_sip_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cal_api_key: z.ZodOptional<z.ZodString>;
+        event_type_id: z.ZodOptional<z.ZodNumber>;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    states: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        state_prompt: z.ZodOptional<z.ZodString>;
+        edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            destination_state_name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        tools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                transfer_call: "transfer_call";
+                press_digit: "press_digit";
+                agent_swap: "agent_swap";
+                mcp: "mcp";
+                end_call: "end_call";
+                check_availability_cal: "check_availability_cal";
+                book_appointment_cal: "book_appointment_cal";
+                custom: "custom";
+                extract_dynamic_variable: "extract_dynamic_variable";
+                send_sms: "send_sms";
+            }>;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tool_id: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            method: z.ZodOptional<z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+                PATCH: "PATCH";
+                PUT: "PUT";
+                DELETE: "DELETE";
+            }>>;
+            parameter_type: z.ZodOptional<z.ZodEnum<{
+                json: "json";
+                form: "form";
+            }>>;
+            parameters: z.ZodOptional<z.ZodUnknown>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            query_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            args_at_root: z.ZodOptional<z.ZodBoolean>;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
+            response_variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            speak_during_execution: z.ZodOptional<z.ZodBoolean>;
+            speak_after_execution: z.ZodOptional<z.ZodBoolean>;
+            execution_message_description: z.ZodOptional<z.ZodString>;
+            transfer_destination: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodOptional<z.ZodString>;
+                number: z.ZodOptional<z.ZodString>;
+                extension: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            transfer_option: z.ZodOptional<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                option: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    prompt: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                public_handoff_option: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    prompt: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                private_handoff_option: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodOptional<z.ZodString>;
+                    prompt: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                on_hold_music: z.ZodOptional<z.ZodString>;
+                opt_out_initial_message: z.ZodOptional<z.ZodBoolean>;
+                opt_out_human_detection: z.ZodOptional<z.ZodBoolean>;
+                agent_detection_timeout_ms: z.ZodOptional<z.ZodNumber>;
+                show_transferee_as_caller: z.ZodOptional<z.ZodBoolean>;
+                enable_bridge_audio_cue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            custom_sip_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cal_api_key: z.ZodOptional<z.ZodString>;
+            event_type_id: z.ZodOptional<z.ZodNumber>;
+            timezone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+    }, z.core.$strip>>>>;
+    starting_state: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    default_dynamic_variables: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    mcps: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        query_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;