phonic 0.31.9 → 0.31.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Phonic.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phonic",
-        "X-Fern-SDK-Version": "0.31.9",
-        "User-Agent": "phonic/0.31.9",
+        "X-Fern-SDK-Version": "0.31.11",
+        "User-Agent": "phonic/0.31.11",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -9,7 +9,15 @@ import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
 import * as core from "./core/index.js";
 export declare namespace PhonicClient {
-    type Options = BaseClientOptions;
+    type Options = BaseClientOptions & {
+        /**
+         * When `true`, conversation WebSockets automatically reconnect after an
+         * abnormal disconnect (WebSocket close code 1006) using `reconnect_conv_id`.
+         * Defaults to `false` until the behavior is broadly validated in production;
+         * set to `true` to opt in early.
+         */
+        reconnectConversationOnAbnormalDisconnect?: boolean;
+    };
     interface RequestOptions extends BaseRequestOptions {
     }
 }

package/dist/cjs/Client.js

@@ -1,5 +1,5 @@
 "use strict";
-// This file was auto-generated by Fern from our API Definition.
+// Maintained manually (listed in .fernignore). Fern does not overwrite this file.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/cjs/api/resources/conversations/client/Client.d.ts

@@ -4,7 +4,14 @@ import * as core from "../../../../core/index.js";
 import * as Phonic from "../../../index.js";
 import { ConversationsSocket } from "./Socket.js";
 export declare namespace ConversationsClient {
-    type Options = BaseClientOptions;
+    type Options = BaseClientOptions & {
+        /**
+         * When `true`, `connect()` uses session-aware reconnection on abnormal
+         * disconnect (1006). Set via `PhonicClient` options as
+         * `reconnectConversationOnAbnormalDisconnect`.
+         */
+        reconnectConversationOnAbnormalDisconnect?: boolean;
+    };
     interface RequestOptions extends BaseRequestOptions {
     }
     interface ConnectArgs {

package/dist/cjs/api/resources/conversations/client/Client.js

@@ -62,6 +62,7 @@ const environments = __importStar(require("../../../../environments.js"));
 const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 const Phonic = __importStar(require("../../../index.js"));
+const ReconnectableConversationsSocket_js_1 = require("../../../../custom/ReconnectableConversationsSocket.js");
 const Socket_js_1 = require("./Socket.js");
 class ConversationsClient {
     constructor(options = {}) {
@@ -750,11 +751,44 @@ 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_js_1.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/cjs/api/resources/conversations/client/Socket.d.ts

@@ -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/cjs/api/resources/conversations/client/Socket.js

@@ -122,6 +122,10 @@ 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/cjs/api/types/ConfigOptions.d.ts

@@ -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/cjs/api/types/ConfigOptions.js

@@ -0,0 +1,32 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigOptions = void 0;
+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 || (exports.ConfigOptions = ConfigOptions = {}));

package/dist/cjs/api/types/ConfigPayload.d.ts

@@ -1,92 +1,4 @@
-export interface ConfigPayload {
+import type * as Phonic from "../index.js";
+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;
-    /** 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?: 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/cjs/api/types/ConfigPayload.js

@@ -1,32 +1,3 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigPayload = void 0;
-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 || (exports.ConfigPayload = ConfigPayload = {}));

package/dist/cjs/api/types/ResetPayload.d.ts

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

package/dist/cjs/api/types/ResetPayload.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -8,6 +8,7 @@ export * from "./AudioChunkPayload.js";
 export * from "./AudioChunkResponsePayload.js";
 export * from "./BadRequestErrorBody.js";
 export * from "./BasicError.js";
+export * from "./ConfigOptions.js";
 export * from "./ConfigPayload.js";
 export * from "./Conversation.js";
 export * from "./ConversationAnalysis.js";
@@ -33,6 +34,7 @@ export * from "./OutboundCallInitiatedResponse.js";
 export * from "./OutboundDryRunResponse.js";
 export * from "./Project.js";
 export * from "./ReadyToStartConversationPayload.js";
+export * from "./ResetPayload.js";
 export * from "./SayPayload.js";
 export * from "./SetExternalIdPayload.js";
 export * from "./SipOutboundCallInitiatedResponse.js";

package/dist/cjs/api/types/index.js

@@ -24,6 +24,7 @@ __exportStar(require("./AudioChunkPayload.js"), exports);
 __exportStar(require("./AudioChunkResponsePayload.js"), exports);
 __exportStar(require("./BadRequestErrorBody.js"), exports);
 __exportStar(require("./BasicError.js"), exports);
+__exportStar(require("./ConfigOptions.js"), exports);
 __exportStar(require("./ConfigPayload.js"), exports);
 __exportStar(require("./Conversation.js"), exports);
 __exportStar(require("./ConversationAnalysis.js"), exports);
@@ -49,6 +50,7 @@ __exportStar(require("./OutboundCallInitiatedResponse.js"), exports);
 __exportStar(require("./OutboundDryRunResponse.js"), exports);
 __exportStar(require("./Project.js"), exports);
 __exportStar(require("./ReadyToStartConversationPayload.js"), exports);
+__exportStar(require("./ResetPayload.js"), exports);
 __exportStar(require("./SayPayload.js"), exports);
 __exportStar(require("./SetExternalIdPayload.js"), exports);
 __exportStar(require("./SipOutboundCallInitiatedResponse.js"), exports);

package/dist/cjs/custom/ReconnectableConversationsSocket.d.ts

@@ -0,0 +1,74 @@
+import * as core from "../core/index.js";
+import type * as Phonic from "../api/index.js";
+import { ConversationsSocket } from "../api/resources/conversations/client/Socket.js";
+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 {};