phonic 0.32.9 → 0.32.11

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.32.9",
-        "User-Agent": "phonic/0.32.9",
+        "X-Fern-SDK-Version": "0.32.11",
+        "User-Agent": "phonic/0.32.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

@@ -15,8 +15,9 @@ import * as core from "./core/index.js";
 export declare namespace PhonicClient {
     type Options = BaseClientOptions & {
         /**
-         * When `true`, conversation WebSockets automatically reconnect after an
-         * abnormal disconnect (WebSocket close code 1006) using `reconnect_conv_id`.
+         * **Experimental.** When `true`, conversation WebSockets automatically
+         * reconnect and resume after a non-deliberate disconnect (WebSocket close
+         * codes 1006, 1012, or 1001/"restarting") using `reconnect_conv_id`.
          * Defaults to `false` until the behavior is broadly validated in production;
          * set to `true` to opt in early.
          */

package/dist/cjs/api/resources/agents/client/requests/AgentsCreateRequest.d.ts

@@ -83,6 +83,8 @@ export interface AgentsCreateRequest {
     template_variables?: Record<string, Phonic.CreateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: Phonic.CreateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

package/dist/cjs/api/resources/agents/client/requests/UpdateAgentRequest.d.ts

@@ -83,6 +83,8 @@ export interface UpdateAgentRequest {
     template_variables?: Record<string, UpdateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: UpdateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -6,9 +6,9 @@ import { ConversationsSocket } from "./Socket.js";
 export declare namespace ConversationsClient {
     type Options = BaseClientOptions & {
         /**
-         * When `true`, `connect()` uses session-aware reconnection on abnormal
-         * disconnect (1006). Set via `PhonicClient` options as
-         * `reconnectConversationOnAbnormalDisconnect`.
+         * **Experimental.** When `true`, `connect()` uses session-aware reconnection
+         * on a non-deliberate disconnect (close codes 1006, 1012, or 1001/"restarting").
+         * Set via `PhonicClient` options as `reconnectConversationOnAbnormalDisconnect`.
          */
         reconnectConversationOnAbnormalDisconnect?: boolean;
     };

package/dist/cjs/api/resources/tools/client/requests/CreateToolRequest.d.ts

@@ -141,6 +141,8 @@ export interface CreateToolRequest {
     agents_to_transfer_to?: string[];
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: CreateToolRequest.SpeechBeforeToolCall;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -160,6 +162,9 @@ export declare namespace CreateToolRequest {
         readonly CustomWebsocket: "custom_websocket";
         readonly BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number";
         readonly BuiltInTransferToAgent: "built_in_transfer_to_agent";
+        readonly BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending";
+        readonly BuiltInKeypadInput: "built_in_keypad_input";
+        readonly BuiltInChooseNotToRespond: "built_in_choose_not_to_respond";
     };
     type Type = (typeof Type)[keyof typeof Type];
     /** Mode of operation. */
@@ -174,4 +179,11 @@ export declare namespace CreateToolRequest {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

package/dist/cjs/api/resources/tools/client/requests/CreateToolRequest.js

@@ -11,6 +11,9 @@ var CreateToolRequest;
         CustomWebsocket: "custom_websocket",
         BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number",
         BuiltInTransferToAgent: "built_in_transfer_to_agent",
+        BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending",
+        BuiltInKeypadInput: "built_in_keypad_input",
+        BuiltInChooseNotToRespond: "built_in_choose_not_to_respond",
     };
     /** Mode of operation. */
     CreateToolRequest.ExecutionMode = {
@@ -22,4 +25,10 @@ var CreateToolRequest;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    CreateToolRequest.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(CreateToolRequest || (exports.CreateToolRequest = CreateToolRequest = {}));

package/dist/cjs/api/resources/tools/client/requests/UpdateToolRequest.d.ts

@@ -49,6 +49,8 @@ export interface UpdateToolRequest {
     agents_to_transfer_to?: string[];
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: UpdateToolRequest.SpeechBeforeToolCall;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -71,4 +73,11 @@ export declare namespace UpdateToolRequest {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

package/dist/cjs/api/resources/tools/client/requests/UpdateToolRequest.js

@@ -14,4 +14,10 @@ var UpdateToolRequest;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    UpdateToolRequest.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(UpdateToolRequest || (exports.UpdateToolRequest = UpdateToolRequest = {}));

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

@@ -36,6 +36,8 @@ export interface Agent {
     template_variables: Record<string, Agent.TemplateVariables.Value>;
     /** List of tools available to the agent. */
     tools: Agent.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. */
+    built_in_tool_configs: Phonic.BuiltInToolConfigs;
     /** Tasks for the agent to complete during the conversation. */
     tasks: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -1,6 +1,6 @@
 export interface AudioChunkPayload {
     type: "audio_chunk";
-    /** Base64-encoded audio data (Int16Array for PCM, Uint8Array for mulaw) */
+    /** Base64-encoded audio data (Int16Array for PCM, Uint8Array for mulaw). Each chunk may contain at most 40 ms of audio — longer chunks are rejected with an error. Batch ~20 ms frames for headroom. */
     audio: string;
     /** ISO 8601 timestamp (required for first chunk only) */
     iso_date_time?: string | undefined;

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

@@ -0,0 +1,16 @@
+/**
+ * Configuration for a simple built-in tool (`keypad_input`, `natural_conversation_ending`, or `choose_not_to_respond`).
+ */
+export interface BuiltInToolConfig {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    speech_before_tool_call: BuiltInToolConfig.SpeechBeforeToolCall;
+}
+export declare namespace BuiltInToolConfig {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
+}

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

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltInToolConfig = void 0;
+var BuiltInToolConfig;
+(function (BuiltInToolConfig) {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    BuiltInToolConfig.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
+})(BuiltInToolConfig || (exports.BuiltInToolConfig = BuiltInToolConfig = {}));

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

@@ -0,0 +1,5 @@
+import type * as Phonic from "../index.js";
+/**
+ * Per-tool configuration overrides for built-in tools, keyed by built-in tool ID (e.g. `tool_natural_conversation_ending`). A built-in tool referenced in `tools` but absent from this map uses its default configuration.
+ */
+export type BuiltInToolConfigs = Record<string, Phonic.BuiltInToolConfig>;

package/dist/cjs/api/types/BuiltInToolConfigs.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/BuiltInToolDefinition.d.ts

@@ -0,0 +1,18 @@
+import type * as Phonic from "../index.js";
+/**
+ * A built-in tool with an explicit configuration, as an alternative to referencing it by bare name (which uses the tool's default configuration). Only `keypad_input` and `natural_conversation_ending` accept configuration this way.
+ */
+export interface BuiltInToolDefinition {
+    type: "built_in";
+    /** The name of the built-in tool. */
+    name: BuiltInToolDefinition.Name;
+    tool_config: Phonic.BuiltInToolConfig;
+}
+export declare namespace BuiltInToolDefinition {
+    /** The name of the built-in tool. */
+    const Name: {
+        readonly KeypadInput: "keypad_input";
+        readonly NaturalConversationEnding: "natural_conversation_ending";
+    };
+    type Name = (typeof Name)[keyof typeof Name];
+}

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

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuiltInToolDefinition = void 0;
+var BuiltInToolDefinition;
+(function (BuiltInToolDefinition) {
+    /** The name of the built-in tool. */
+    BuiltInToolDefinition.Name = {
+        KeypadInput: "keypad_input",
+        NaturalConversationEnding: "natural_conversation_ending",
+    };
+})(BuiltInToolDefinition || (exports.BuiltInToolDefinition = BuiltInToolDefinition = {}));

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

@@ -65,7 +65,7 @@ export interface ConfigOptions {
     boosted_keywords?: string[] | undefined;
     /** Array of `{ word, pronunciation }` entries. Words must be unique. */
     pronunciation_dictionary?: ConfigOptions.PronunciationDictionary.Item[] | undefined;
-    /** Tools available to the assistant. Use a string to reference a pre-defined tool by name, or define an inline WebSocket tool for this conversation. */
+    /** Tools available to the assistant. Use a string to reference a pre-defined tool by name, provide a built-in tool object to override its default configuration, or define an inline WebSocket tool for this conversation. */
     tools?: Phonic.ToolDefinition[] | undefined;
     /** Template variables for system prompt and welcome message */
     template_variables?: Record<string, string> | undefined;

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

@@ -36,6 +36,8 @@ export interface CreateAgentRequest {
     template_variables?: Record<string, CreateAgentRequest.TemplateVariables.Value> | undefined;
     /** Array of built-in or custom tool names to use. */
     tools?: CreateAgentRequest.Tools.Item[] | undefined;
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs | undefined;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[] | undefined;
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -2,4 +2,6 @@ export interface GenerateReplyPayload {
     type: "generate_reply";
     /** Optional system message to guide the assistant's reply */
     system_message?: (string | null) | undefined;
+    /** Optional user message for the assistant to reply to */
+    user_message?: (string | null) | undefined;
 }

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

@@ -37,6 +37,8 @@ export interface Tool {
     agents_to_transfer_to?: string[] | undefined;
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean | undefined;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: Tool.SpeechBeforeToolCall | undefined;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean | undefined;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -60,6 +62,9 @@ export declare namespace Tool {
         readonly CustomWebsocket: "custom_websocket";
         readonly BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number";
         readonly BuiltInTransferToAgent: "built_in_transfer_to_agent";
+        readonly BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending";
+        readonly BuiltInKeypadInput: "built_in_keypad_input";
+        readonly BuiltInChooseNotToRespond: "built_in_choose_not_to_respond";
     };
     type Type = (typeof Type)[keyof typeof Type];
     /** Mode of operation - sync waits for response, async continues without waiting. */
@@ -74,4 +79,11 @@ export declare namespace Tool {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

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

@@ -11,6 +11,9 @@ var Tool;
         CustomWebsocket: "custom_websocket",
         BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number",
         BuiltInTransferToAgent: "built_in_transfer_to_agent",
+        BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending",
+        BuiltInKeypadInput: "built_in_keypad_input",
+        BuiltInChooseNotToRespond: "built_in_choose_not_to_respond",
     };
     /** Mode of operation - sync waits for response, async continues without waiting. */
     Tool.ExecutionMode = {
@@ -22,4 +25,10 @@ var Tool;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    Tool.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(Tool || (exports.Tool = Tool = {}));

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

@@ -1,2 +1,2 @@
 import type * as Phonic from "../index.js";
-export type ToolDefinition = Phonic.ToolName | Phonic.InlineWebSocketTool;
+export type ToolDefinition = Phonic.ToolName | Phonic.BuiltInToolDefinition | Phonic.InlineWebSocketTool;

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

@@ -10,6 +10,9 @@ export * from "./AudioChunkPayload.js";
 export * from "./AudioChunkResponsePayload.js";
 export * from "./BadRequestErrorBody.js";
 export * from "./BasicError.js";
+export * from "./BuiltInToolConfig.js";
+export * from "./BuiltInToolConfigs.js";
+export * from "./BuiltInToolDefinition.js";
 export * from "./ConfigOptions.js";
 export * from "./ConfigPayload.js";
 export * from "./Conversation.js";

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

@@ -26,6 +26,9 @@ __exportStar(require("./AudioChunkPayload.js"), exports);
 __exportStar(require("./AudioChunkResponsePayload.js"), exports);
 __exportStar(require("./BadRequestErrorBody.js"), exports);
 __exportStar(require("./BasicError.js"), exports);
+__exportStar(require("./BuiltInToolConfig.js"), exports);
+__exportStar(require("./BuiltInToolConfigs.js"), exports);
+__exportStar(require("./BuiltInToolDefinition.js"), exports);
 __exportStar(require("./ConfigOptions.js"), exports);
 __exportStar(require("./ConfigPayload.js"), exports);
 __exportStar(require("./Conversation.js"), exports);

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

@@ -2,7 +2,7 @@ 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). */
+    /** Called on a reconnectable close 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;
@@ -16,9 +16,10 @@ type EventHandlers = {
     error?: (error: Error) => void;
 };
 /**
- * Wraps ConversationsSocket with automatic reconnection on 1006.
+ * Wraps ConversationsSocket with automatic reconnection on a reconnectable
+ * close (1006, 1012, or 1001/"restarting" — see isReconnectableClose).
  *
- * On abnormal closure, creates a brand new ReconnectingWebSocket (via the
+ * On such a close, creates a brand new ReconnectingWebSocket (via the
  * createReconnectSocket factory) and wraps it in a fresh ConversationsSocket,
  * forwarding all events to user-registered handlers.
  *
@@ -60,7 +61,7 @@ export declare class ReconnectableConversationsSocket {
     sendMute(message: Phonic.MutePayload): void;
     sendUnmute(message: Phonic.UnmutePayload): void;
     /**
-     * Not supported — reconnection after 1006 is handled automatically.
+     * Not supported — reconnection after a dropped connection is handled automatically.
      * To start a new conversation, create a new socket via client.conversations.connect().
      */
     connect(): never;

package/dist/cjs/custom/ReconnectableConversationsSocket.js

@@ -46,20 +46,33 @@ exports.ReconnectableConversationsSocket = void 0;
 const core = __importStar(require("../core/index.js"));
 const Socket_js_1 = require("../api/resources/conversations/client/Socket.js");
 const json_js_1 = require("../core/json.js");
-/** 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 SERVICE_RESTART = 1012;
+const GOING_AWAY = 1001;
+/** Whether a close means the disconnect was NOT a deliberate end of the
+ *  conversation, so the SDK should transparently reconnect and resume it:
+ *   - 1006 abnormal closure (socket died with no close frame)
+ *   - 1012 service restart — an edge proxy/load-balancer restart closes the
+ *     client with 1012/"restarting"; the conversation is still alive
+ *     server-side within the grace window
+ *   - 1001 "going away" ONLY when the reason is "restarting" — a proxy drain
+ *     can surface to the client as 1001/"restarting" instead of 1012. A bare
+ *     1001 (empty/other reason) is a deliberate close (the caller ended the
+ *     conversation, tab closed/suspended) and must NOT reconnect.
+ *  Matches the server's reconnect policy. All other codes (1000, 4000,
+ *  4800, ...) are intentional closes. */
+const isReconnectableClose = (code, reason) => code === ABNORMAL_CLOSURE || code === SERVICE_RESTART || (code === GOING_AWAY && reason === "restarting");
 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). */
+ *  retries much sooner (within the 30s grace period). */
 const MAX_RECONNECT_ATTEMPTS = 10;
 /**
- * Wraps ConversationsSocket with automatic reconnection on 1006.
+ * Wraps ConversationsSocket with automatic reconnection on a reconnectable
+ * close (1006, 1012, or 1001/"restarting" — see isReconnectableClose).
  *
- * On abnormal closure, creates a brand new ReconnectingWebSocket (via the
+ * On such a close, creates a brand new ReconnectingWebSocket (via the
  * createReconnectSocket factory) and wraps it in a fresh ConversationsSocket,
  * forwarding all events to user-registered handlers.
  *
@@ -141,12 +154,12 @@ class ReconnectableConversationsSocket {
         this._safeSend((inner) => inner.sendUnmute(message));
     }
     /**
-     * Not supported — reconnection after 1006 is handled automatically.
+     * Not supported — reconnection after a dropped connection 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, "
+            + "Reconnection after an abnormal close is automatic. To start a new conversation, "
             + "call client.conversations.connect() again.");
     }
     close() {
@@ -225,7 +238,7 @@ class ReconnectableConversationsSocket {
             catch (_d) {
                 this._pendingReplacement = false;
                 // Connection failed — schedule another attempt.
-                // The server's grace period (10s) is the natural limit;
+                // The server's grace period (30s) is the natural limit;
                 // once it expires, the next attempt will get 4800 and stop.
                 this._scheduleReconnect();
             }
@@ -265,7 +278,7 @@ class ReconnectableConversationsSocket {
             if (this._isClosed) {
                 return;
             }
-            if (event.code === ABNORMAL_CLOSURE && this._conversationId !== null) {
+            if (isReconnectableClose(event.code, event.reason) && 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,
@@ -275,8 +288,8 @@ class ReconnectableConversationsSocket {
                 rawSocket.close();
                 this._scheduleReconnect();
             }
-            // 1006 without conversationId: let RWS handle transport-level
-            // reconnect normally (starts a fresh conversation).
+            // Reconnectable close without conversationId: let RWS handle
+            // transport-level reconnect normally (starts a fresh conversation).
         };
         rawSocket.addEventListener("message", onMessage);
         rawSocket.addEventListener("close", onClose);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.32.9";
+export declare const SDK_VERSION = "0.32.11";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.32.9";
+exports.SDK_VERSION = "0.32.11";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phonic",
-        "X-Fern-SDK-Version": "0.32.9",
-        "User-Agent": "phonic/0.32.9",
+        "X-Fern-SDK-Version": "0.32.11",
+        "User-Agent": "phonic/0.32.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/esm/Client.d.mts

@@ -15,8 +15,9 @@ import * as core from "./core/index.mjs";
 export declare namespace PhonicClient {
     type Options = BaseClientOptions & {
         /**
-         * When `true`, conversation WebSockets automatically reconnect after an
-         * abnormal disconnect (WebSocket close code 1006) using `reconnect_conv_id`.
+         * **Experimental.** When `true`, conversation WebSockets automatically
+         * reconnect and resume after a non-deliberate disconnect (WebSocket close
+         * codes 1006, 1012, or 1001/"restarting") using `reconnect_conv_id`.
          * Defaults to `false` until the behavior is broadly validated in production;
          * set to `true` to opt in early.
          */

package/dist/esm/api/resources/agents/client/requests/AgentsCreateRequest.d.mts

@@ -83,6 +83,8 @@ export interface AgentsCreateRequest {
     template_variables?: Record<string, Phonic.CreateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: Phonic.CreateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

package/dist/esm/api/resources/agents/client/requests/UpdateAgentRequest.d.mts

@@ -83,6 +83,8 @@ export interface UpdateAgentRequest {
     template_variables?: Record<string, UpdateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: UpdateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -6,9 +6,9 @@ import { ConversationsSocket } from "./Socket.mjs";
 export declare namespace ConversationsClient {
     type Options = BaseClientOptions & {
         /**
-         * When `true`, `connect()` uses session-aware reconnection on abnormal
-         * disconnect (1006). Set via `PhonicClient` options as
-         * `reconnectConversationOnAbnormalDisconnect`.
+         * **Experimental.** When `true`, `connect()` uses session-aware reconnection
+         * on a non-deliberate disconnect (close codes 1006, 1012, or 1001/"restarting").
+         * Set via `PhonicClient` options as `reconnectConversationOnAbnormalDisconnect`.
          */
         reconnectConversationOnAbnormalDisconnect?: boolean;
     };

package/dist/esm/api/resources/tools/client/requests/CreateToolRequest.d.mts

@@ -141,6 +141,8 @@ export interface CreateToolRequest {
     agents_to_transfer_to?: string[];
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: CreateToolRequest.SpeechBeforeToolCall;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -160,6 +162,9 @@ export declare namespace CreateToolRequest {
         readonly CustomWebsocket: "custom_websocket";
         readonly BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number";
         readonly BuiltInTransferToAgent: "built_in_transfer_to_agent";
+        readonly BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending";
+        readonly BuiltInKeypadInput: "built_in_keypad_input";
+        readonly BuiltInChooseNotToRespond: "built_in_choose_not_to_respond";
     };
     type Type = (typeof Type)[keyof typeof Type];
     /** Mode of operation. */
@@ -174,4 +179,11 @@ export declare namespace CreateToolRequest {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

package/dist/esm/api/resources/tools/client/requests/CreateToolRequest.mjs

@@ -8,6 +8,9 @@ export var CreateToolRequest;
         CustomWebsocket: "custom_websocket",
         BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number",
         BuiltInTransferToAgent: "built_in_transfer_to_agent",
+        BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending",
+        BuiltInKeypadInput: "built_in_keypad_input",
+        BuiltInChooseNotToRespond: "built_in_choose_not_to_respond",
     };
     /** Mode of operation. */
     CreateToolRequest.ExecutionMode = {
@@ -19,4 +22,10 @@ export var CreateToolRequest;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    CreateToolRequest.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(CreateToolRequest || (CreateToolRequest = {}));

package/dist/esm/api/resources/tools/client/requests/UpdateToolRequest.d.mts

@@ -49,6 +49,8 @@ export interface UpdateToolRequest {
     agents_to_transfer_to?: string[];
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: UpdateToolRequest.SpeechBeforeToolCall;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -71,4 +73,11 @@ export declare namespace UpdateToolRequest {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

package/dist/esm/api/resources/tools/client/requests/UpdateToolRequest.mjs

@@ -11,4 +11,10 @@ export var UpdateToolRequest;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    UpdateToolRequest.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(UpdateToolRequest || (UpdateToolRequest = {}));

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

@@ -36,6 +36,8 @@ export interface Agent {
     template_variables: Record<string, Agent.TemplateVariables.Value>;
     /** List of tools available to the agent. */
     tools: Agent.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. */
+    built_in_tool_configs: Phonic.BuiltInToolConfigs;
     /** Tasks for the agent to complete during the conversation. */
     tasks: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -1,6 +1,6 @@
 export interface AudioChunkPayload {
     type: "audio_chunk";
-    /** Base64-encoded audio data (Int16Array for PCM, Uint8Array for mulaw) */
+    /** Base64-encoded audio data (Int16Array for PCM, Uint8Array for mulaw). Each chunk may contain at most 40 ms of audio — longer chunks are rejected with an error. Batch ~20 ms frames for headroom. */
     audio: string;
     /** ISO 8601 timestamp (required for first chunk only) */
     iso_date_time?: string | undefined;

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

@@ -0,0 +1,16 @@
+/**
+ * Configuration for a simple built-in tool (`keypad_input`, `natural_conversation_ending`, or `choose_not_to_respond`).
+ */
+export interface BuiltInToolConfig {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    speech_before_tool_call: BuiltInToolConfig.SpeechBeforeToolCall;
+}
+export declare namespace BuiltInToolConfig {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
+}

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

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var BuiltInToolConfig;
+(function (BuiltInToolConfig) {
+    /** Controls whether the assistant speaks before the tool is called. `required`: the assistant must speak first. `optional`: the model decides. `suppressed`: the assistant is strongly instructed to stay silent before the call (best effort). */
+    BuiltInToolConfig.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
+})(BuiltInToolConfig || (BuiltInToolConfig = {}));

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

@@ -0,0 +1,5 @@
+import type * as Phonic from "../index.mjs";
+/**
+ * Per-tool configuration overrides for built-in tools, keyed by built-in tool ID (e.g. `tool_natural_conversation_ending`). A built-in tool referenced in `tools` but absent from this map uses its default configuration.
+ */
+export type BuiltInToolConfigs = Record<string, Phonic.BuiltInToolConfig>;

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

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

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

@@ -0,0 +1,18 @@
+import type * as Phonic from "../index.mjs";
+/**
+ * A built-in tool with an explicit configuration, as an alternative to referencing it by bare name (which uses the tool's default configuration). Only `keypad_input` and `natural_conversation_ending` accept configuration this way.
+ */
+export interface BuiltInToolDefinition {
+    type: "built_in";
+    /** The name of the built-in tool. */
+    name: BuiltInToolDefinition.Name;
+    tool_config: Phonic.BuiltInToolConfig;
+}
+export declare namespace BuiltInToolDefinition {
+    /** The name of the built-in tool. */
+    const Name: {
+        readonly KeypadInput: "keypad_input";
+        readonly NaturalConversationEnding: "natural_conversation_ending";
+    };
+    type Name = (typeof Name)[keyof typeof Name];
+}

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

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export var BuiltInToolDefinition;
+(function (BuiltInToolDefinition) {
+    /** The name of the built-in tool. */
+    BuiltInToolDefinition.Name = {
+        KeypadInput: "keypad_input",
+        NaturalConversationEnding: "natural_conversation_ending",
+    };
+})(BuiltInToolDefinition || (BuiltInToolDefinition = {}));

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

@@ -65,7 +65,7 @@ export interface ConfigOptions {
     boosted_keywords?: string[] | undefined;
     /** Array of `{ word, pronunciation }` entries. Words must be unique. */
     pronunciation_dictionary?: ConfigOptions.PronunciationDictionary.Item[] | undefined;
-    /** Tools available to the assistant. Use a string to reference a pre-defined tool by name, or define an inline WebSocket tool for this conversation. */
+    /** Tools available to the assistant. Use a string to reference a pre-defined tool by name, provide a built-in tool object to override its default configuration, or define an inline WebSocket tool for this conversation. */
     tools?: Phonic.ToolDefinition[] | undefined;
     /** Template variables for system prompt and welcome message */
     template_variables?: Record<string, string> | undefined;

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

@@ -36,6 +36,8 @@ export interface CreateAgentRequest {
     template_variables?: Record<string, CreateAgentRequest.TemplateVariables.Value> | undefined;
     /** Array of built-in or custom tool names to use. */
     tools?: CreateAgentRequest.Tools.Item[] | undefined;
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs | undefined;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[] | undefined;
     /** Whether to have the no-input poke text be generated by AI. */

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

@@ -2,4 +2,6 @@ export interface GenerateReplyPayload {
     type: "generate_reply";
     /** Optional system message to guide the assistant's reply */
     system_message?: (string | null) | undefined;
+    /** Optional user message for the assistant to reply to */
+    user_message?: (string | null) | undefined;
 }

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

@@ -37,6 +37,8 @@ export interface Tool {
     agents_to_transfer_to?: string[] | undefined;
     /** When true, forces the agent to speak before executing the tool. */
     require_speech_before_tool_call?: boolean | undefined;
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    speech_before_tool_call?: Tool.SpeechBeforeToolCall | undefined;
     /** If true, the agent will wait to finish speaking before executing the tool. This is only available for custom_webhook and custom_websocket tools. */
     wait_for_speech_before_tool_call?: boolean | undefined;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
@@ -60,6 +62,9 @@ export declare namespace Tool {
         readonly CustomWebsocket: "custom_websocket";
         readonly BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number";
         readonly BuiltInTransferToAgent: "built_in_transfer_to_agent";
+        readonly BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending";
+        readonly BuiltInKeypadInput: "built_in_keypad_input";
+        readonly BuiltInChooseNotToRespond: "built_in_choose_not_to_respond";
     };
     type Type = (typeof Type)[keyof typeof Type];
     /** Mode of operation - sync waits for response, async continues without waiting. */
@@ -74,4 +79,11 @@ export declare namespace Tool {
         readonly Post: "POST";
     };
     type EndpointMethod = (typeof EndpointMethod)[keyof typeof EndpointMethod];
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    const SpeechBeforeToolCall: {
+        readonly Required: "required";
+        readonly Optional: "optional";
+        readonly Suppressed: "suppressed";
+    };
+    type SpeechBeforeToolCall = (typeof SpeechBeforeToolCall)[keyof typeof SpeechBeforeToolCall];
 }

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

@@ -8,6 +8,9 @@ export var Tool;
         CustomWebsocket: "custom_websocket",
         BuiltInTransferToPhoneNumber: "built_in_transfer_to_phone_number",
         BuiltInTransferToAgent: "built_in_transfer_to_agent",
+        BuiltInNaturalConversationEnding: "built_in_natural_conversation_ending",
+        BuiltInKeypadInput: "built_in_keypad_input",
+        BuiltInChooseNotToRespond: "built_in_choose_not_to_respond",
     };
     /** Mode of operation - sync waits for response, async continues without waiting. */
     Tool.ExecutionMode = {
@@ -19,4 +22,10 @@ export var Tool;
         Get: "GET",
         Post: "POST",
     };
+    /** For built_in_natural_conversation_ending and built_in_keypad_input tools. Whether the agent must speak before calling the tool ("required"), the model decides ("optional"), or the agent must stay silent ("suppressed"). Not used by other tool types. */
+    Tool.SpeechBeforeToolCall = {
+        Required: "required",
+        Optional: "optional",
+        Suppressed: "suppressed",
+    };
 })(Tool || (Tool = {}));

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

@@ -1,2 +1,2 @@
 import type * as Phonic from "../index.mjs";
-export type ToolDefinition = Phonic.ToolName | Phonic.InlineWebSocketTool;
+export type ToolDefinition = Phonic.ToolName | Phonic.BuiltInToolDefinition | Phonic.InlineWebSocketTool;

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

@@ -10,6 +10,9 @@ export * from "./AudioChunkPayload.mjs";
 export * from "./AudioChunkResponsePayload.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BasicError.mjs";
+export * from "./BuiltInToolConfig.mjs";
+export * from "./BuiltInToolConfigs.mjs";
+export * from "./BuiltInToolDefinition.mjs";
 export * from "./ConfigOptions.mjs";
 export * from "./ConfigPayload.mjs";
 export * from "./Conversation.mjs";

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

@@ -10,6 +10,9 @@ export * from "./AudioChunkPayload.mjs";
 export * from "./AudioChunkResponsePayload.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BasicError.mjs";
+export * from "./BuiltInToolConfig.mjs";
+export * from "./BuiltInToolConfigs.mjs";
+export * from "./BuiltInToolDefinition.mjs";
 export * from "./ConfigOptions.mjs";
 export * from "./ConfigPayload.mjs";
 export * from "./Conversation.mjs";

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

@@ -2,7 +2,7 @@ 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). */
+    /** Called on a reconnectable close 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;
@@ -16,9 +16,10 @@ type EventHandlers = {
     error?: (error: Error) => void;
 };
 /**
- * Wraps ConversationsSocket with automatic reconnection on 1006.
+ * Wraps ConversationsSocket with automatic reconnection on a reconnectable
+ * close (1006, 1012, or 1001/"restarting" — see isReconnectableClose).
  *
- * On abnormal closure, creates a brand new ReconnectingWebSocket (via the
+ * On such a close, creates a brand new ReconnectingWebSocket (via the
  * createReconnectSocket factory) and wraps it in a fresh ConversationsSocket,
  * forwarding all events to user-registered handlers.
  *
@@ -60,7 +61,7 @@ export declare class ReconnectableConversationsSocket {
     sendMute(message: Phonic.MutePayload): void;
     sendUnmute(message: Phonic.UnmutePayload): void;
     /**
-     * Not supported — reconnection after 1006 is handled automatically.
+     * Not supported — reconnection after a dropped connection is handled automatically.
      * To start a new conversation, create a new socket via client.conversations.connect().
      */
     connect(): never;

package/dist/esm/custom/ReconnectableConversationsSocket.mjs

@@ -10,20 +10,33 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 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 SERVICE_RESTART = 1012;
+const GOING_AWAY = 1001;
+/** Whether a close means the disconnect was NOT a deliberate end of the
+ *  conversation, so the SDK should transparently reconnect and resume it:
+ *   - 1006 abnormal closure (socket died with no close frame)
+ *   - 1012 service restart — an edge proxy/load-balancer restart closes the
+ *     client with 1012/"restarting"; the conversation is still alive
+ *     server-side within the grace window
+ *   - 1001 "going away" ONLY when the reason is "restarting" — a proxy drain
+ *     can surface to the client as 1001/"restarting" instead of 1012. A bare
+ *     1001 (empty/other reason) is a deliberate close (the caller ended the
+ *     conversation, tab closed/suspended) and must NOT reconnect.
+ *  Matches the server's reconnect policy. All other codes (1000, 4000,
+ *  4800, ...) are intentional closes. */
+const isReconnectableClose = (code, reason) => code === ABNORMAL_CLOSURE || code === SERVICE_RESTART || (code === GOING_AWAY && reason === "restarting");
 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). */
+ *  retries much sooner (within the 30s grace period). */
 const MAX_RECONNECT_ATTEMPTS = 10;
 /**
- * Wraps ConversationsSocket with automatic reconnection on 1006.
+ * Wraps ConversationsSocket with automatic reconnection on a reconnectable
+ * close (1006, 1012, or 1001/"restarting" — see isReconnectableClose).
  *
- * On abnormal closure, creates a brand new ReconnectingWebSocket (via the
+ * On such a close, creates a brand new ReconnectingWebSocket (via the
  * createReconnectSocket factory) and wraps it in a fresh ConversationsSocket,
  * forwarding all events to user-registered handlers.
  *
@@ -105,12 +118,12 @@ export class ReconnectableConversationsSocket {
         this._safeSend((inner) => inner.sendUnmute(message));
     }
     /**
-     * Not supported — reconnection after 1006 is handled automatically.
+     * Not supported — reconnection after a dropped connection 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, "
+            + "Reconnection after an abnormal close is automatic. To start a new conversation, "
             + "call client.conversations.connect() again.");
     }
     close() {
@@ -189,7 +202,7 @@ export class ReconnectableConversationsSocket {
             catch (_d) {
                 this._pendingReplacement = false;
                 // Connection failed — schedule another attempt.
-                // The server's grace period (10s) is the natural limit;
+                // The server's grace period (30s) is the natural limit;
                 // once it expires, the next attempt will get 4800 and stop.
                 this._scheduleReconnect();
             }
@@ -229,7 +242,7 @@ export class ReconnectableConversationsSocket {
             if (this._isClosed) {
                 return;
             }
-            if (event.code === ABNORMAL_CLOSURE && this._conversationId !== null) {
+            if (isReconnectableClose(event.code, event.reason) && 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,
@@ -239,8 +252,8 @@ export class ReconnectableConversationsSocket {
                 rawSocket.close();
                 this._scheduleReconnect();
             }
-            // 1006 without conversationId: let RWS handle transport-level
-            // reconnect normally (starts a fresh conversation).
+            // Reconnectable close without conversationId: let RWS handle
+            // transport-level reconnect normally (starts a fresh conversation).
         };
         rawSocket.addEventListener("message", onMessage);
         rawSocket.addEventListener("close", onClose);

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.32.9";
+export declare const SDK_VERSION = "0.32.11";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.32.9";
+export const SDK_VERSION = "0.32.11";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "phonic",
-    "version": "0.32.9",
+    "version": "0.32.11",
     "private": false,
     "repository": {
         "type": "git",