phonic 0.32.8 → 0.32.10

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.8",
-        "User-Agent": "phonic/0.32.8",
+        "X-Fern-SDK-Version": "0.32.10",
+        "User-Agent": "phonic/0.32.10",
         "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/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/types/ConfigOptions.d.ts

@@ -85,6 +85,8 @@ export interface ConfigOptions {
     assistant_backchannel_aggressiveness?: number | undefined;
     /** When not `null`, the agent will call this endpoint to get configuration options for the conversation. */
     configuration_endpoint?: (ConfigOptions.ConfigurationEndpoint | null) | undefined;
+    /** Additional runtime parameters. */
+    additional_params?: Record<string, unknown> | undefined;
     /**
      * Policy controlling how long transcripts and audio recordings are retained before being deleted.
      * When `zero_data_retention` is `true`, nothing is retained and `transcripts`/`audio_recordings` are omitted.

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

@@ -69,6 +69,8 @@ export interface OutboundCallConfig {
     assistant_backchannel_aggressiveness?: number | undefined;
     /** When not `null`, at the beginning of the conversation the agent will make a POST request to this endpoint to get configuration options. */
     configuration_endpoint?: (OutboundCallConfig.ConfigurationEndpoint | null) | undefined;
+    /** Additional runtime parameters. */
+    additional_params?: Record<string, unknown> | undefined;
     /** Controls how long transcripts and audio recordings are retained before deletion. */
     data_retention_policy?: Phonic.DataRetentionPolicy | undefined;
 }

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.8";
+export declare const SDK_VERSION = "0.32.10";

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.8";
+exports.SDK_VERSION = "0.32.10";

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.8",
-        "User-Agent": "phonic/0.32.8",
+        "X-Fern-SDK-Version": "0.32.10",
+        "User-Agent": "phonic/0.32.10",
         "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/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/types/ConfigOptions.d.mts

@@ -85,6 +85,8 @@ export interface ConfigOptions {
     assistant_backchannel_aggressiveness?: number | undefined;
     /** When not `null`, the agent will call this endpoint to get configuration options for the conversation. */
     configuration_endpoint?: (ConfigOptions.ConfigurationEndpoint | null) | undefined;
+    /** Additional runtime parameters. */
+    additional_params?: Record<string, unknown> | undefined;
     /**
      * Policy controlling how long transcripts and audio recordings are retained before being deleted.
      * When `zero_data_retention` is `true`, nothing is retained and `transcripts`/`audio_recordings` are omitted.

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

@@ -69,6 +69,8 @@ export interface OutboundCallConfig {
     assistant_backchannel_aggressiveness?: number | undefined;
     /** When not `null`, at the beginning of the conversation the agent will make a POST request to this endpoint to get configuration options. */
     configuration_endpoint?: (OutboundCallConfig.ConfigurationEndpoint | null) | undefined;
+    /** Additional runtime parameters. */
+    additional_params?: Record<string, unknown> | undefined;
     /** Controls how long transcripts and audio recordings are retained before deletion. */
     data_retention_policy?: Phonic.DataRetentionPolicy | undefined;
 }

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.8";
+export declare const SDK_VERSION = "0.32.10";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.32.8";
+export const SDK_VERSION = "0.32.10";

package/package.json

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