phonic 0.31.8 → 0.31.10

package/dist/esm/api/resources/conversations/client/Client.mjs

@@ -26,6 +26,7 @@ import * as environments from "../../../../environments.mjs";
 import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
 import * as errors from "../../../../errors/index.mjs";
 import * as Phonic from "../../../index.mjs";
+import { ReconnectableConversationsSocket } from "../../../../custom/ReconnectableConversationsSocket.mjs";
 import { ConversationsSocket } from "./Socket.mjs";
 export class ConversationsClient {
     constructor(options = {}) {
@@ -714,11 +715,44 @@ export class ConversationsClient {
             const _queryParams = {
                 downstream_websocket_url: downstreamWebsocketUrl,
             };
+            const baseWsUrl = core.url.join((_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.PhonicEnvironment.Default)
+                .production, "/v1/sts/ws");
+            if (this._options.reconnectConversationOnAbnormalDisconnect) {
+                const connectionTimeoutMs = connectionTimeoutInSeconds != null ? connectionTimeoutInSeconds * 1000 : undefined;
+                const createSocket = (reconnectConvId) => __awaiter(this, void 0, void 0, function* () {
+                    var _a, _b, _c;
+                    const freshAuth = yield this._options.authProvider.getAuthRequest();
+                    const mergedHeaders = Object.assign(Object.assign(Object.assign({}, ((_a = freshAuth.headers) !== null && _a !== void 0 ? _a : {})), ((_c = (_b = this._options) === null || _b === void 0 ? void 0 : _b.headers) !== null && _c !== void 0 ? _c : {})), headers);
+                    const isSessionReconnect = reconnectConvId != null;
+                    return new core.ReconnectingWebSocket({
+                        url: baseWsUrl,
+                        protocols: protocols !== null && protocols !== void 0 ? protocols : [],
+                        queryParameters: Object.assign(Object.assign(Object.assign({}, _queryParams), queryParams), (reconnectConvId ? { reconnect_conv_id: reconnectConvId } : {})),
+                        headers: mergedHeaders,
+                        options: {
+                            debug: debug !== null && debug !== void 0 ? debug : false,
+                            // Initial connection keeps transport retries; replacement sockets use 0 so only
+                            // ReconnectableConversationsSocket performs session-level reconnect.
+                            maxRetries: isSessionReconnect ? 0 : reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
+                            connectionTimeout: connectionTimeoutMs,
+                        },
+                        // Only pass abortSignal to the initial socket. Reconnect sockets
+                        // don't get it — each would register a new listener on the signal
+                        // that's never removed, leaking memory over many reconnects.
+                        abortSignal: isSessionReconnect ? undefined : abortSignal,
+                    });
+                });
+                const initialSocket = yield createSocket();
+                return new ReconnectableConversationsSocket({
+                    socket: initialSocket,
+                    createReconnectSocket: (conversationId) => createSocket(conversationId),
+                    abortSignal,
+                });
+            }
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = Object.assign(Object.assign(Object.assign({}, ((_a = _authRequest.headers) !== null && _a !== void 0 ? _a : {})), ((_c = (_b = this._options) === null || _b === void 0 ? void 0 : _b.headers) !== null && _c !== void 0 ? _c : {})), headers);
+            const _headers = Object.assign(Object.assign(Object.assign({}, ((_c = _authRequest.headers) !== null && _c !== void 0 ? _c : {})), ((_e = (_d = this._options) === null || _d === void 0 ? void 0 : _d.headers) !== null && _e !== void 0 ? _e : {})), headers);
             const socket = new core.ReconnectingWebSocket({
-                url: core.url.join((_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : ((_e = (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.PhonicEnvironment.Default)
-                    .production, "/v1/sts/ws"),
+                url: baseWsUrl,
                 protocols: protocols !== null && protocols !== void 0 ? protocols : [],
                 queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,

package/dist/esm/api/resources/conversations/client/Socket.d.mts

@@ -41,6 +41,7 @@ export declare class ConversationsSocket {
     sendToolCallOutput(message: Phonic.ToolCallOutputPayload): void;
     sendGenerateReply(message: Phonic.GenerateReplyPayload): void;
     sendSay(message: Phonic.SayPayload): void;
+    sendReset(message: Phonic.ResetPayload): void;
     /** Connect to the websocket and register event handlers. */
     connect(): ConversationsSocket;
     /** Close the websocket and unregister event handlers. */
@@ -52,5 +53,5 @@ export declare class ConversationsSocket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBuffer | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Phonic.ConfigPayload | Phonic.AudioChunkPayload | Phonic.UpdateSystemPromptPayload | Phonic.AddSystemMessagePayload | Phonic.SetExternalIdPayload | Phonic.ToolCallOutputPayload | Phonic.GenerateReplyPayload | Phonic.SayPayload): void;
+    protected sendJson(payload: Phonic.ConfigPayload | Phonic.AudioChunkPayload | Phonic.UpdateSystemPromptPayload | Phonic.AddSystemMessagePayload | Phonic.SetExternalIdPayload | Phonic.ToolCallOutputPayload | Phonic.GenerateReplyPayload | Phonic.SayPayload | Phonic.ResetPayload): void;
 }

package/dist/esm/api/resources/conversations/client/Socket.mjs

@@ -86,6 +86,10 @@ export class ConversationsSocket {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
+    sendReset(message) {
+        this.assertSocketIsOpen();
+        this.sendJson(message);
+    }
     /** Connect to the websocket and register event handlers. */
     connect() {
         this.socket.reconnect();

package/dist/esm/api/resources/conversations/client/requests/ConversationsSipOutboundCallRequest.d.mts

@@ -19,4 +19,6 @@ export interface ConversationsSipOutboundCallRequest {
     /** Destination phone number in E.164 format. */
     to_phone_number: string;
     config?: Phonic.OutboundCallConfig;
+    /** If true, validates the outbound call setup without placing a call. Returns HTTP 200 with `conversation_id` and `twilio_call_sid` set to null. */
+    dry_run?: boolean;
 }

package/dist/esm/api/resources/conversations/client/requests/OutboundCallRequest.d.mts

@@ -20,12 +20,16 @@ import type * as Phonic from "../../../../index.mjs";
  *             additional_languages: ["es"],
  *             multilingual_mode: "request",
  *             boosted_keywords: ["Load ID", "dispatch"],
+ *             min_words_to_interrupt: 1,
  *             tools: ["keypad_input"]
- *         }
+ *         },
+ *         dry_run: false
  *     }
  */
 export interface OutboundCallRequest {
     /** The phone number to call in E.164 format. */
     to_phone_number: string;
     config?: Phonic.OutboundCallConfig;
+    /** If true, validates the outbound call setup without placing a call. Returns HTTP 200 with `conversation_id` set to null. */
+    dry_run?: boolean;
 }

package/dist/esm/api/resources/conversations/types/ConversationsOutboundCallResponse.d.mts

@@ -1,4 +1,2 @@
-export interface ConversationsOutboundCallResponse {
-    /** The ID of the created conversation. */
-    conversation_id: string;
-}
+import type * as Phonic from "../../../index.mjs";
+export type ConversationsOutboundCallResponse = Phonic.OutboundDryRunResponse | Phonic.OutboundCallInitiatedResponse;

package/dist/esm/api/resources/conversations/types/ConversationsSipOutboundCallResponse.d.mts

@@ -1,6 +1,2 @@
-export interface ConversationsSipOutboundCallResponse {
-    /** The ID of the created conversation. */
-    conversation_id: string;
-    /** The Twilio Call SID. */
-    twilio_call_sid: string;
-}
+import type * as Phonic from "../../../index.mjs";
+export type ConversationsSipOutboundCallResponse = Phonic.SipOutboundDryRunResponse | Phonic.SipOutboundCallInitiatedResponse;

package/dist/esm/api/types/Agent.d.mts

@@ -52,6 +52,8 @@ export interface Agent {
     multilingual_mode: Agent.MultilingualMode;
     /** These words, or short phrases, will be more accurately recognized by the agent. */
     boosted_keywords: string[];
+    /** Minimum number of words required to interrupt the assistant. */
+    min_words_to_interrupt: number;
     /** When not `null`, the agent will call this endpoint to get configuration options. */
     configuration_endpoint: Agent.ConfigurationEndpoint | null;
     /** Float between 0.0 and 1.0 representing the percentage of inbound calls handled by Agent. Requires `phone_number` to be set when less than 1.0. */

package/dist/esm/api/types/ConfigOptions.d.mts

@@ -0,0 +1,94 @@
+/**
+ * Configuration fields for the initial `config` message.
+ */
+export interface ConfigOptions {
+    /** Agent name to use for conversation */
+    agent?: string | undefined;
+    /** Project name */
+    project?: string | undefined;
+    /** STS model to use */
+    model?: "merritt" | undefined;
+    /** System prompt for AI assistant */
+    system_prompt?: string | undefined;
+    /** Audio playback speed */
+    audio_speed?: number | undefined;
+    /** Background noise level for the conversation */
+    background_noise_level?: number | undefined;
+    /** Background noise type for the conversation */
+    background_noise?: (ConfigOptions.BackgroundNoise | null) | undefined;
+    /** When `true`, the welcome message will be automatically generated and the `welcome_message` field will be ignored. */
+    generate_welcome_message?: boolean | undefined;
+    /** Message to play when conversation starts. Ignored when `generate_welcome_message` is `true`. */
+    welcome_message?: (string | null) | undefined;
+    /** Voice ID to use for speech synthesis */
+    voice_id?: string | undefined;
+    /** Audio input format */
+    input_format?: ConfigOptions.InputFormat | undefined;
+    /** Audio output format */
+    output_format?: ConfigOptions.OutputFormat | undefined;
+    /** Voice activity detection prebuffer duration */
+    vad_prebuffer_duration_ms?: number | undefined;
+    /** Minimum speech duration for VAD */
+    vad_min_speech_duration_ms?: number | undefined;
+    /** Minimum silence duration for VAD */
+    vad_min_silence_duration_ms?: number | undefined;
+    /** Voice activity detection threshold */
+    vad_threshold?: number | undefined;
+    /** Minimum number of words required to interrupt the assistant. */
+    min_words_to_interrupt?: number | undefined;
+    /** Whether to have the no-input poke text be generated by AI */
+    generate_no_input_poke_text?: boolean | undefined;
+    /** Seconds of silence before poke message */
+    no_input_poke_sec?: (number | null) | undefined;
+    /** Poke message text. Ignored when generate_no_input_poke_text is true. */
+    no_input_poke_text?: string | undefined;
+    /** Seconds of silence before ending conversation */
+    no_input_end_conversation_sec?: number | undefined;
+    /** ISO 639-1 language code that sets the agent's default language to recognize and speak. Welcome message and no input poke text should be in this language. */
+    default_language?: string | undefined;
+    /** Array of additional ISO 639-1 language codes that the agent should be able to recognize and speak. Should not include `default_language`. */
+    additional_languages?: string[] | undefined;
+    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
+    multilingual_mode?: ConfigOptions.MultilingualMode | undefined;
+    /** Keywords to boost in speech recognition */
+    boosted_keywords?: string[] | undefined;
+    /** Names of tools available to the assistant. */
+    tools?: ConfigOptions.Tools.Item[] | undefined;
+    /** Template variables for system prompt and welcome message */
+    template_variables?: Record<string, string> | undefined;
+}
+export declare namespace ConfigOptions {
+    /** Background noise type for the conversation */
+    const BackgroundNoise: {
+        readonly Office: "office";
+        readonly CallCenter: "call-center";
+        readonly CoffeeShop: "coffee-shop";
+    };
+    type BackgroundNoise = (typeof BackgroundNoise)[keyof typeof BackgroundNoise];
+    /** Audio input format */
+    const InputFormat: {
+        readonly Pcm44100: "pcm_44100";
+        readonly Pcm16000: "pcm_16000";
+        readonly Pcm8000: "pcm_8000";
+        readonly Mulaw8000: "mulaw_8000";
+    };
+    type InputFormat = (typeof InputFormat)[keyof typeof InputFormat];
+    /** Audio output format */
+    const OutputFormat: {
+        readonly Pcm44100: "pcm_44100";
+        readonly Pcm16000: "pcm_16000";
+        readonly Pcm8000: "pcm_8000";
+        readonly Mulaw8000: "mulaw_8000";
+    };
+    type OutputFormat = (typeof OutputFormat)[keyof typeof OutputFormat];
+    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
+    const MultilingualMode: {
+        readonly Auto: "auto";
+        readonly Request: "request";
+    };
+    type MultilingualMode = (typeof MultilingualMode)[keyof typeof MultilingualMode];
+    type Tools = Tools.Item[];
+    namespace Tools {
+        type Item = string | Record<string, unknown>;
+    }
+}

package/dist/esm/api/types/ConfigOptions.mjs

@@ -0,0 +1,29 @@
+// This file was auto-generated by Fern from our API Definition.
+export var ConfigOptions;
+(function (ConfigOptions) {
+    /** Background noise type for the conversation */
+    ConfigOptions.BackgroundNoise = {
+        Office: "office",
+        CallCenter: "call-center",
+        CoffeeShop: "coffee-shop",
+    };
+    /** Audio input format */
+    ConfigOptions.InputFormat = {
+        Pcm44100: "pcm_44100",
+        Pcm16000: "pcm_16000",
+        Pcm8000: "pcm_8000",
+        Mulaw8000: "mulaw_8000",
+    };
+    /** Audio output format */
+    ConfigOptions.OutputFormat = {
+        Pcm44100: "pcm_44100",
+        Pcm16000: "pcm_16000",
+        Pcm8000: "pcm_8000",
+        Mulaw8000: "mulaw_8000",
+    };
+    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
+    ConfigOptions.MultilingualMode = {
+        Auto: "auto",
+        Request: "request",
+    };
+})(ConfigOptions || (ConfigOptions = {}));

package/dist/esm/api/types/ConfigPayload.d.mts

@@ -1,90 +1,4 @@
-export interface ConfigPayload {
+import type * as Phonic from "../index.mjs";
+export interface ConfigPayload extends Phonic.ConfigOptions {
     type: "config";
-    /** Agent name to use for conversation */
-    agent?: string | undefined;
-    /** Project name */
-    project?: string | undefined;
-    /** STS model to use */
-    model?: "merritt" | undefined;
-    /** System prompt for AI assistant */
-    system_prompt?: string | undefined;
-    /** Audio playback speed */
-    audio_speed?: number | undefined;
-    /** Background noise level for the conversation */
-    background_noise_level?: number | undefined;
-    /** Background noise type for the conversation */
-    background_noise?: (ConfigPayload.BackgroundNoise | null) | undefined;
-    /** When `true`, the welcome message will be automatically generated and the `welcome_message` field will be ignored. */
-    generate_welcome_message?: boolean | undefined;
-    /** Message to play when conversation starts. Ignored when `generate_welcome_message` is `true`. */
-    welcome_message?: (string | null) | undefined;
-    /** Voice ID to use for speech synthesis */
-    voice_id?: string | undefined;
-    /** Audio input format */
-    input_format?: ConfigPayload.InputFormat | undefined;
-    /** Audio output format */
-    output_format?: ConfigPayload.OutputFormat | undefined;
-    /** Voice activity detection prebuffer duration */
-    vad_prebuffer_duration_ms?: number | undefined;
-    /** Minimum speech duration for VAD */
-    vad_min_speech_duration_ms?: number | undefined;
-    /** Minimum silence duration for VAD */
-    vad_min_silence_duration_ms?: number | undefined;
-    /** Voice activity detection threshold */
-    vad_threshold?: number | undefined;
-    /** Whether to have the no-input poke text be generated by AI */
-    generate_no_input_poke_text?: boolean | undefined;
-    /** Seconds of silence before poke message */
-    no_input_poke_sec?: (number | null) | undefined;
-    /** Poke message text. Ignored when generate_no_input_poke_text is true. */
-    no_input_poke_text?: string | undefined;
-    /** Seconds of silence before ending conversation */
-    no_input_end_conversation_sec?: number | undefined;
-    /** ISO 639-1 language code that sets the agent's default language to recognize and speak. Welcome message and no input poke text should be in this language. */
-    default_language?: string | undefined;
-    /** Array of additional ISO 639-1 language codes that the agent should be able to recognize and speak. Should not include `default_language`. */
-    additional_languages?: string[] | undefined;
-    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
-    multilingual_mode?: ConfigPayload.MultilingualMode | undefined;
-    /** Keywords to boost in speech recognition */
-    boosted_keywords?: string[] | undefined;
-    /** Names of tools available to the assistant. */
-    tools?: ConfigPayload.Tools.Item[] | undefined;
-    /** Template variables for system prompt and welcome message */
-    template_variables?: Record<string, string> | undefined;
-}
-export declare namespace ConfigPayload {
-    /** Background noise type for the conversation */
-    const BackgroundNoise: {
-        readonly Office: "office";
-        readonly CallCenter: "call-center";
-        readonly CoffeeShop: "coffee-shop";
-    };
-    type BackgroundNoise = (typeof BackgroundNoise)[keyof typeof BackgroundNoise];
-    /** Audio input format */
-    const InputFormat: {
-        readonly Pcm44100: "pcm_44100";
-        readonly Pcm16000: "pcm_16000";
-        readonly Pcm8000: "pcm_8000";
-        readonly Mulaw8000: "mulaw_8000";
-    };
-    type InputFormat = (typeof InputFormat)[keyof typeof InputFormat];
-    /** Audio output format */
-    const OutputFormat: {
-        readonly Pcm44100: "pcm_44100";
-        readonly Pcm16000: "pcm_16000";
-        readonly Pcm8000: "pcm_8000";
-        readonly Mulaw8000: "mulaw_8000";
-    };
-    type OutputFormat = (typeof OutputFormat)[keyof typeof OutputFormat];
-    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
-    const MultilingualMode: {
-        readonly Auto: "auto";
-        readonly Request: "request";
-    };
-    type MultilingualMode = (typeof MultilingualMode)[keyof typeof MultilingualMode];
-    type Tools = Tools.Item[];
-    namespace Tools {
-        type Item = string | Record<string, unknown>;
-    }
 }

package/dist/esm/api/types/ConfigPayload.mjs

@@ -1,29 +1,2 @@
 // This file was auto-generated by Fern from our API Definition.
-export var ConfigPayload;
-(function (ConfigPayload) {
-    /** Background noise type for the conversation */
-    ConfigPayload.BackgroundNoise = {
-        Office: "office",
-        CallCenter: "call-center",
-        CoffeeShop: "coffee-shop",
-    };
-    /** Audio input format */
-    ConfigPayload.InputFormat = {
-        Pcm44100: "pcm_44100",
-        Pcm16000: "pcm_16000",
-        Pcm8000: "pcm_8000",
-        Mulaw8000: "mulaw_8000",
-    };
-    /** Audio output format */
-    ConfigPayload.OutputFormat = {
-        Pcm44100: "pcm_44100",
-        Pcm16000: "pcm_16000",
-        Pcm8000: "pcm_8000",
-        Mulaw8000: "mulaw_8000",
-    };
-    /** If `"auto"`, each user audio is automatically identified for the language to respond in. If `"request"`, user must request to change language (recommended). */
-    ConfigPayload.MultilingualMode = {
-        Auto: "auto",
-        Request: "request",
-    };
-})(ConfigPayload || (ConfigPayload = {}));
+export {};

package/dist/esm/api/types/Conversation.d.mts

@@ -46,6 +46,8 @@ export interface Conversation {
     ended_by: Conversation.EndedBy | null;
     /** These words, or short phrases, are more accurately recognized by the model. */
     boosted_keywords: string[] | null;
+    /** Minimum number of words required to interrupt the assistant. */
+    min_words_to_interrupt: number;
     /** ISO 639-1 language code that sets the agent's default language to recognize and speak. Welcome message and no input poke text should be in this language. */
     default_language: string;
     /** Array of additional ISO 639-1 language codes that the agent should be able to recognize and speak. Should not include `default_language`. */

package/dist/esm/api/types/CreateAgentRequest.d.mts

@@ -50,6 +50,8 @@ export interface CreateAgentRequest {
     multilingual_mode?: CreateAgentRequest.MultilingualMode | undefined;
     /** These words, or short phrases, will be more accurately recognized by the agent. */
     boosted_keywords?: string[] | undefined;
+    /** Minimum number of words required to interrupt the assistant. */
+    min_words_to_interrupt?: number | undefined;
     /** When not `null`, at the beginning of the conversation the agent will make a POST request to this endpoint to get configuration options. */
     configuration_endpoint?: (CreateAgentRequest.ConfigurationEndpoint | null) | undefined;
     /** Float between 0.0 and 1.0 representing the percentage of inbound calls handled by Agent. Defaults to `1.0`. Requires `phone_number` to be set when less than 1.0. */

package/dist/esm/api/types/OutboundCallConfig.d.mts

@@ -33,6 +33,8 @@ export interface OutboundCallConfig {
     multilingual_mode?: OutboundCallConfig.MultilingualMode | undefined;
     /** These words, or short phrases, will be more accurately recognized by the agent. */
     boosted_keywords?: string[] | undefined;
+    /** Minimum number of words required to interrupt the assistant. */
+    min_words_to_interrupt?: number | undefined;
     /** Array of built-in or custom tool names to use. */
     tools?: OutboundCallConfig.Tools.Item[] | undefined;
 }

package/dist/esm/api/types/OutboundCallInitiatedResponse.d.mts

@@ -0,0 +1,6 @@
+export interface OutboundCallInitiatedResponse {
+    /** The ID of the created conversation. */
+    conversation_id: string;
+    /** Always false when a call was placed. */
+    dry_run: false;
+}

package/dist/esm/api/types/OutboundCallInitiatedResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/OutboundDryRunResponse.d.mts

@@ -0,0 +1,6 @@
+export interface OutboundDryRunResponse {
+    /** Always null when `dry_run` is true. */
+    conversation_id: unknown | null;
+    /** Always true for this response. */
+    dry_run: true;
+}

package/dist/esm/api/types/OutboundDryRunResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/ResetPayload.d.mts

@@ -0,0 +1,5 @@
+import type * as Phonic from "../index.mjs";
+export interface ResetPayload {
+    type: "reset";
+    config: Phonic.ConfigOptions;
+}

package/dist/esm/api/types/ResetPayload.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SipOutboundCallInitiatedResponse.d.mts

@@ -0,0 +1,8 @@
+export interface SipOutboundCallInitiatedResponse {
+    /** The ID of the created conversation. */
+    conversation_id: string;
+    /** The Twilio Call SID. */
+    twilio_call_sid: string;
+    /** Always false when a call was placed. */
+    dry_run: false;
+}

package/dist/esm/api/types/SipOutboundCallInitiatedResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SipOutboundDryRunResponse.d.mts

@@ -0,0 +1,8 @@
+export interface SipOutboundDryRunResponse {
+    /** Always null when `dry_run` is true. */
+    conversation_id: unknown | null;
+    /** Always null when `dry_run` is true. */
+    twilio_call_sid: unknown | null;
+    /** Always true for this response. */
+    dry_run: true;
+}

package/dist/esm/api/types/SipOutboundDryRunResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -8,6 +8,7 @@ export * from "./AudioChunkPayload.mjs";
 export * from "./AudioChunkResponsePayload.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BasicError.mjs";
+export * from "./ConfigOptions.mjs";
 export * from "./ConfigPayload.mjs";
 export * from "./Conversation.mjs";
 export * from "./ConversationAnalysis.mjs";
@@ -29,10 +30,15 @@ export * from "./InputCancelledPayload.mjs";
 export * from "./InputTextPayload.mjs";
 export * from "./LanguageCode.mjs";
 export * from "./OutboundCallConfig.mjs";
+export * from "./OutboundCallInitiatedResponse.mjs";
+export * from "./OutboundDryRunResponse.mjs";
 export * from "./Project.mjs";
 export * from "./ReadyToStartConversationPayload.mjs";
+export * from "./ResetPayload.mjs";
 export * from "./SayPayload.mjs";
 export * from "./SetExternalIdPayload.mjs";
+export * from "./SipOutboundCallInitiatedResponse.mjs";
+export * from "./SipOutboundDryRunResponse.mjs";
 export * from "./Task.mjs";
 export * from "./Tool.mjs";
 export * from "./ToolCallInterruptedPayload.mjs";

package/dist/esm/api/types/index.mjs

@@ -8,6 +8,7 @@ export * from "./AudioChunkPayload.mjs";
 export * from "./AudioChunkResponsePayload.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BasicError.mjs";
+export * from "./ConfigOptions.mjs";
 export * from "./ConfigPayload.mjs";
 export * from "./Conversation.mjs";
 export * from "./ConversationAnalysis.mjs";
@@ -29,10 +30,15 @@ export * from "./InputCancelledPayload.mjs";
 export * from "./InputTextPayload.mjs";
 export * from "./LanguageCode.mjs";
 export * from "./OutboundCallConfig.mjs";
+export * from "./OutboundCallInitiatedResponse.mjs";
+export * from "./OutboundDryRunResponse.mjs";
 export * from "./Project.mjs";
 export * from "./ReadyToStartConversationPayload.mjs";
+export * from "./ResetPayload.mjs";
 export * from "./SayPayload.mjs";
 export * from "./SetExternalIdPayload.mjs";
+export * from "./SipOutboundCallInitiatedResponse.mjs";
+export * from "./SipOutboundDryRunResponse.mjs";
 export * from "./Task.mjs";
 export * from "./Tool.mjs";
 export * from "./ToolCallInterruptedPayload.mjs";

package/dist/esm/custom/ReconnectableConversationsSocket.d.mts

@@ -0,0 +1,74 @@
+import * as core from "../core/index.mjs";
+import type * as Phonic from "../api/index.mjs";
+import { ConversationsSocket } from "../api/resources/conversations/client/Socket.mjs";
+export interface ReconnectableConversationsSocketArgs {
+    /** Called on 1006 to create a new socket with reconnect_conv_id. May be async (e.g. fresh auth). */
+    createReconnectSocket: (conversationId: string) => core.ReconnectingWebSocket | Promise<core.ReconnectingWebSocket>;
+    /** Initial socket for the first connection. */
+    socket: core.ReconnectingWebSocket;
+    /** If provided, reconnection stops when the signal is aborted. */
+    abortSignal?: AbortSignal;
+}
+type EventHandlers = {
+    open?: () => void;
+    message?: (message: ConversationsSocket.Response) => void;
+    close?: (event: core.CloseEvent) => void;
+    error?: (error: Error) => void;
+};
+/**
+ * Wraps ConversationsSocket with automatic reconnection on 1006.
+ *
+ * On abnormal closure, creates a brand new ReconnectingWebSocket (via the
+ * createReconnectSocket factory) and wraps it in a fresh ConversationsSocket,
+ * forwarding all events to user-registered handlers.
+ *
+ * Retries reconnection with exponential backoff until the server responds
+ * with a terminal close code (4800 session expired, 4801 invalid state),
+ * the safety cap is reached, or the user calls close().
+ *
+ * Uses composition rather than inheritance to avoid coupling to the parent's
+ * private event handler registration or ReconnectingWebSocket internals.
+ */
+export declare class ReconnectableConversationsSocket {
+    private _conversationId;
+    private _inner;
+    private readonly _createReconnectSocket;
+    private readonly _handlers;
+    private _reconnectAttempts;
+    private _isClosed;
+    private readonly _abortSignal;
+    private _cleanupWireListeners;
+    private _pendingReconnect;
+    private _pendingReplacement;
+    constructor(args: ReconnectableConversationsSocketArgs);
+    /** The conversation ID captured from the server's conversation_created message. */
+    get conversationId(): string | null;
+    get socket(): core.ReconnectingWebSocket;
+    get readyState(): number;
+    on<T extends keyof EventHandlers>(event: T, callback: EventHandlers[T]): void;
+    /** Drop outbound sends when we cannot talk to a live socket (no queue). */
+    private _safeSend;
+    sendConfig(message: Phonic.ConfigPayload): void;
+    sendAudioChunk(message: Phonic.AudioChunkPayload): void;
+    sendToolCallOutput(message: Phonic.ToolCallOutputPayload): void;
+    sendUpdateSystemPrompt(message: Phonic.UpdateSystemPromptPayload): void;
+    sendAddSystemMessage(message: Phonic.AddSystemMessagePayload): void;
+    sendSetExternalId(message: Phonic.SetExternalIdPayload): void;
+    sendGenerateReply(message: Phonic.GenerateReplyPayload): void;
+    sendSay(message: Phonic.SayPayload): void;
+    sendReset(message: Phonic.ResetPayload): void;
+    /**
+     * Not supported — reconnection after 1006 is handled automatically.
+     * To start a new conversation, create a new socket via client.conversations.connect().
+     */
+    connect(): never;
+    close(): void;
+    waitForOpen(): Promise<core.ReconnectingWebSocket>;
+    private _getReconnectDelay;
+    /** Schedule a reconnection attempt after backoff delay. */
+    private _scheduleReconnect;
+    /** Perform the actual reconnection attempt. */
+    private _doReconnect;
+    private _wireInner;
+}
+export {};