phonic 0.31.9 → 0.31.11

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

@@ -1,92 +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;
-    /** 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/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/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/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";
@@ -33,6 +34,7 @@ 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";

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";
@@ -33,6 +34,7 @@ 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";

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 {};

package/dist/esm/custom/ReconnectableConversationsSocket.mjs

@@ -0,0 +1,246 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as core from "../core/index.mjs";
+import { ConversationsSocket } from "../api/resources/conversations/client/Socket.mjs";
+import { fromJson } from "../core/json.mjs";
+/** 1006 is the only close code that indicates an unexpected disconnect
+ *  worth reconnecting for. All other codes (1000, 4000, 4800, etc.)
+ *  are intentional server-side closes. */
+const ABNORMAL_CLOSURE = 1006;
+const BASE_RECONNECT_DELAY_MS = 500;
+const MAX_RECONNECT_DELAY_MS = 5000;
+/** Safety cap: stop retrying if the server is completely unreachable.
+ *  In normal operation the server's terminal codes (4800/4801) stop
+ *  retries much sooner (within the 10s grace period). */
+const MAX_RECONNECT_ATTEMPTS = 10;
+/**
+ * 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 class ReconnectableConversationsSocket {
+    constructor(args) {
+        this._conversationId = null;
+        this._handlers = {};
+        this._reconnectAttempts = 0;
+        this._isClosed = false;
+        this._cleanupWireListeners = null;
+        this._pendingReconnect = null;
+        this._pendingReplacement = false;
+        this._createReconnectSocket = args.createReconnectSocket;
+        this._abortSignal = args.abortSignal != undefined ? args.abortSignal : null;
+        this._inner = new ConversationsSocket({ socket: args.socket });
+        this._wireInner(this._inner, args.socket);
+    }
+    /** The conversation ID captured from the server's conversation_created message. */
+    get conversationId() {
+        return this._conversationId;
+    }
+    get socket() {
+        return this._inner.socket;
+    }
+    get readyState() {
+        return this._inner.readyState;
+    }
+    on(event, callback) {
+        this._handlers[event] = callback;
+    }
+    /** Drop outbound sends when we cannot talk to a live socket (no queue). */
+    _safeSend(op) {
+        if (this._isClosed || this._pendingReplacement) {
+            return;
+        }
+        if (this._inner.readyState !== core.ReconnectingWebSocket.ReadyState.OPEN) {
+            return;
+        }
+        op(this._inner);
+    }
+    sendConfig(message) {
+        this._safeSend((inner) => inner.sendConfig(message));
+    }
+    sendAudioChunk(message) {
+        this._safeSend((inner) => inner.sendAudioChunk(message));
+    }
+    sendToolCallOutput(message) {
+        this._safeSend((inner) => inner.sendToolCallOutput(message));
+    }
+    sendUpdateSystemPrompt(message) {
+        this._safeSend((inner) => inner.sendUpdateSystemPrompt(message));
+    }
+    sendAddSystemMessage(message) {
+        this._safeSend((inner) => inner.sendAddSystemMessage(message));
+    }
+    sendSetExternalId(message) {
+        this._safeSend((inner) => inner.sendSetExternalId(message));
+    }
+    sendGenerateReply(message) {
+        this._safeSend((inner) => inner.sendGenerateReply(message));
+    }
+    sendSay(message) {
+        this._safeSend((inner) => inner.sendSay(message));
+    }
+    sendReset(message) {
+        this._safeSend((inner) => inner.sendReset(message));
+    }
+    /**
+     * Not supported — reconnection after 1006 is handled automatically.
+     * To start a new conversation, create a new socket via client.conversations.connect().
+     */
+    connect() {
+        throw new Error("connect() is not supported on ReconnectableConversationsSocket. "
+            + "Reconnection after 1006 is automatic. To start a new conversation, "
+            + "call client.conversations.connect() again.");
+    }
+    close() {
+        var _a;
+        this._isClosed = true;
+        this._pendingReplacement = false;
+        if (this._pendingReconnect != null) {
+            clearTimeout(this._pendingReconnect);
+            this._pendingReconnect = null;
+        }
+        (_a = this._cleanupWireListeners) === null || _a === void 0 ? void 0 : _a.call(this);
+        this._cleanupWireListeners = null;
+        this._inner.close();
+    }
+    waitForOpen() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._inner.waitForOpen();
+        });
+    }
+    _getReconnectDelay() {
+        // Exponential backoff: 500ms, 1s, 2s, 4s, capped at 5s
+        const delay = BASE_RECONNECT_DELAY_MS * Math.pow(2, this._reconnectAttempts - 1);
+        return Math.min(delay, MAX_RECONNECT_DELAY_MS);
+    }
+    /** Schedule a reconnection attempt after backoff delay. */
+    _scheduleReconnect() {
+        var _a, _b, _c;
+        if (this._isClosed || this._conversationId === null || ((_a = this._abortSignal) === null || _a === void 0 ? void 0 : _a.aborted)) {
+            return;
+        }
+        if (this._reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+            this._pendingReplacement = false;
+            (_c = (_b = this._handlers).error) === null || _c === void 0 ? void 0 : _c.call(_b, new Error("Max reconnect attempts reached"));
+            return;
+        }
+        // Clear any existing timer to prevent orphaned timeouts
+        if (this._pendingReconnect != null) {
+            clearTimeout(this._pendingReconnect);
+        }
+        this._reconnectAttempts++;
+        const delay = this._getReconnectDelay();
+        this._pendingReplacement = true;
+        this._pendingReconnect = setTimeout(() => {
+            this._pendingReconnect = null;
+            if (this._isClosed) {
+                this._pendingReplacement = false;
+                return;
+            }
+            void this._doReconnect();
+        }, delay);
+    }
+    /** Perform the actual reconnection attempt. */
+    _doReconnect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                const created = this._createReconnectSocket(this._conversationId);
+                const newRawSocket = created instanceof Promise ? yield created : created;
+                if (this._isClosed || ((_a = this._abortSignal) === null || _a === void 0 ? void 0 : _a.aborted)) {
+                    this._pendingReplacement = false;
+                    newRawSocket.close();
+                    return;
+                }
+                // Clean up the old socket: remove our custom listeners and close
+                // the ConversationsSocket wrapper (which removes its own listeners).
+                (_b = this._cleanupWireListeners) === null || _b === void 0 ? void 0 : _b.call(this);
+                this._cleanupWireListeners = null;
+                try {
+                    this._inner.close();
+                }
+                catch ( /* already closed from 1006 */_c) { /* already closed from 1006 */ }
+                const newInner = new ConversationsSocket({ socket: newRawSocket });
+                this._inner = newInner;
+                this._wireInner(newInner, newRawSocket);
+            }
+            catch (_d) {
+                this._pendingReplacement = false;
+                // Connection failed — schedule another attempt.
+                // The server's grace period (10s) is the natural limit;
+                // once it expires, the next attempt will get 4800 and stop.
+                this._scheduleReconnect();
+            }
+        });
+    }
+    _wireInner(inner, rawSocket) {
+        // Forward events from the inner ConversationsSocket to user handlers.
+        // Clear _pendingReplacement before calling the user's open handler
+        // so that sends inside the handler are not silently dropped.
+        inner.on("open", () => {
+            var _a, _b;
+            this._pendingReplacement = false;
+            (_b = (_a = this._handlers).open) === null || _b === void 0 ? void 0 : _b.call(_a);
+        });
+        inner.on("message", (msg) => { var _a, _b; return (_b = (_a = this._handlers).message) === null || _b === void 0 ? void 0 : _b.call(_a, msg); });
+        inner.on("close", (ev) => { var _a, _b; return (_b = (_a = this._handlers).close) === null || _b === void 0 ? void 0 : _b.call(_a, ev); });
+        inner.on("error", (err) => { var _a, _b; return (_b = (_a = this._handlers).error) === null || _b === void 0 ? void 0 : _b.call(_a, err); });
+        // Intercept raw messages to capture conversation_id and reset reconnect counter
+        const onMessage = (event) => {
+            try {
+                const data = fromJson(event.data);
+                if (data && typeof data === "object" && "type" in data) {
+                    const type = data.type;
+                    if (type === "conversation_created") {
+                        this._conversationId = data.conversation_id;
+                    }
+                    if (type === "conversation_reconnected") {
+                        this._reconnectAttempts = 0;
+                    }
+                }
+            }
+            catch (_a) {
+                // ignore — inner socket handles parse errors
+            }
+        };
+        const onClose = (event) => {
+            if (this._isClosed) {
+                return;
+            }
+            if (event.code === ABNORMAL_CLOSURE && this._conversationId !== null) {
+                // We have a conversation to resume — cancel RWS's built-in
+                // auto-reconnect and handle it ourselves with reconnect_conv_id.
+                // _handleClose calls _connect() before notifying listeners,
+                // but _connect() awaits _wait() which is async. Calling
+                // close() synchronously sets _closeCalled = true, which
+                // _connect() checks before opening the new socket.
+                rawSocket.close();
+                this._scheduleReconnect();
+            }
+            // 1006 without conversationId: let RWS handle transport-level
+            // reconnect normally (starts a fresh conversation).
+        };
+        rawSocket.addEventListener("message", onMessage);
+        rawSocket.addEventListener("close", onClose);
+        this._cleanupWireListeners = () => {
+            rawSocket.removeEventListener("message", onMessage);
+            rawSocket.removeEventListener("close", onClose);
+        };
+    }
+}

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

@@ -0,0 +1 @@
+export { ReconnectableConversationsSocket } from "./ReconnectableConversationsSocket.mjs";

package/dist/esm/custom/index.mjs

@@ -0,0 +1 @@
+export { ReconnectableConversationsSocket } from "./ReconnectableConversationsSocket.mjs";

package/dist/esm/index.d.mts

@@ -4,3 +4,4 @@ export { PhonicClient } from "./Client.mjs";
 export { PhonicEnvironment, type PhonicEnvironmentUrls } from "./environments.mjs";
 export { PhonicError, PhonicTimeoutError } from "./errors/index.mjs";
 export * from "./exports.mjs";
+export { ReconnectableConversationsSocket } from "./custom/index.mjs";

package/dist/esm/index.mjs

@@ -3,3 +3,4 @@ export { PhonicClient } from "./Client.mjs";
 export { PhonicEnvironment } from "./environments.mjs";
 export { PhonicError, PhonicTimeoutError } from "./errors/index.mjs";
 export * from "./exports.mjs";
+export { ReconnectableConversationsSocket } from "./custom/index.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.31.9";
+export declare const SDK_VERSION = "0.31.11";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.31.9";
+export const SDK_VERSION = "0.31.11";

package/package.json

@@ -1,11 +1,12 @@
 {
     "name": "phonic",
-    "version": "0.31.9",
+    "version": "0.31.11",
     "private": false,
     "repository": {
         "type": "git",
         "url": "git+https://github.com/Phonic-Co/phonic-node.git"
     },
+    "license": "MIT",
     "type": "commonjs",
     "main": "./dist/cjs/index.js",
     "module": "./dist/esm/index.mjs",