phonic 0.32.13 → 0.32.15

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.13",
-        "User-Agent": "phonic/0.32.13",
+        "X-Fern-SDK-Version": "0.32.15",
+        "User-Agent": "phonic/0.32.15",
         "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/api/resources/agents/client/requests/UpdateAgentRequest.d.ts

@@ -178,7 +178,7 @@ export declare namespace UpdateAgentRequest {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -217,6 +217,8 @@ export interface CreateToolRequest {
     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;
+    /** For built_in_choose_not_to_respond tools. Number of seconds to wait after the tool fires before the agent speaks a follow-up if the user stays silent. When null, the agent stays silent (default). Not used by other tool types. */
+    respond_after_sec?: number | null;
     /** 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. */

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

@@ -57,6 +57,8 @@ export interface UpdateToolRequest {
     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;
+    /** For built_in_choose_not_to_respond tools. Number of seconds to wait after the tool fires before the agent speaks a follow-up if the user stays silent. When null, the agent stays silent (default). Not used by other tool types. */
+    respond_after_sec?: number | null;
     /** 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. */

package/dist/cjs/api/resources/tts/client/requests/StreamTtsRequest.d.ts

@@ -1,3 +1,4 @@
+import type * as Phonic from "../../../../index.js";
 /**
  * @example
  *     {
@@ -15,6 +16,11 @@ export interface StreamTtsRequest {
     voice_id?: string;
     /** The audio format to stream. */
     output_format?: StreamTtsRequest.OutputFormat;
+    /**
+     * Candidate languages for synthesis. An empty array defaults to English, one language
+     * selects it directly, and multiple languages let Phonic detect among those candidates.
+     */
+    languages?: Phonic.LanguageCode[];
 }
 export declare namespace StreamTtsRequest {
     /** The audio format to stream. */

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

@@ -127,7 +127,7 @@ export declare namespace Agent {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -1,5 +1,5 @@
 /**
- * Configuration for a simple built-in tool (`keypad_input`, `natural_conversation_ending`, or `choose_not_to_respond`).
+ * Configuration for a simple built-in tool (`keypad_input` or `natural_conversation_ending`).
  */
 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). */

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

@@ -1,5 +1,8 @@
 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.
+ * Per-tool configuration overrides for built-in tools, keyed by built-in tool ID. The value's shape depends on the tool: `tool_keypad_input` and `tool_natural_conversation_ending` take a `speech_before_tool_call` config; `tool_choose_not_to_respond` takes a `respond_after_sec` config. A built-in tool referenced in `tools` but absent from this map uses its default configuration.
  */
-export type BuiltInToolConfigs = Record<string, Phonic.BuiltInToolConfig>;
+export type BuiltInToolConfigs = Record<string, BuiltInToolConfigs.Value>;
+export declare namespace BuiltInToolConfigs {
+    type Value = Phonic.BuiltInToolConfig | Phonic.ChooseNotToRespondToolConfig;
+}

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

@@ -1,18 +1,24 @@
 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.
+ * A built-in tool with an explicit configuration, as an alternative to referencing it by bare name (which uses the tool's default configuration). `keypad_input` and `natural_conversation_ending` take a `speech_before_tool_call` config; `choose_not_to_respond` takes a `respond_after_sec` config.
  */
 export interface BuiltInToolDefinition {
     type: "built_in";
     /** The name of the built-in tool. */
     name: BuiltInToolDefinition.Name;
-    tool_config: Phonic.BuiltInToolConfig;
+    /** The tool's configuration. Use `BuiltInToolConfig` for `keypad_input` and `natural_conversation_ending`, or `ChooseNotToRespondToolConfig` for `choose_not_to_respond`. */
+    tool_config: BuiltInToolDefinition.ToolConfig;
 }
 export declare namespace BuiltInToolDefinition {
     /** The name of the built-in tool. */
     const Name: {
         readonly KeypadInput: "keypad_input";
         readonly NaturalConversationEnding: "natural_conversation_ending";
+        readonly ChooseNotToRespond: "choose_not_to_respond";
     };
     type Name = (typeof Name)[keyof typeof Name];
+    /**
+     * The tool's configuration. Use `BuiltInToolConfig` for `keypad_input` and `natural_conversation_ending`, or `ChooseNotToRespondToolConfig` for `choose_not_to_respond`.
+     */
+    type ToolConfig = Phonic.BuiltInToolConfig | Phonic.ChooseNotToRespondToolConfig;
 }

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

@@ -8,5 +8,6 @@ var BuiltInToolDefinition;
     BuiltInToolDefinition.Name = {
         KeypadInput: "keypad_input",
         NaturalConversationEnding: "natural_conversation_ending",
+        ChooseNotToRespond: "choose_not_to_respond",
     };
 })(BuiltInToolDefinition || (exports.BuiltInToolDefinition = BuiltInToolDefinition = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Configuration for the `choose_not_to_respond` built-in tool.
+ */
+export interface ChooseNotToRespondToolConfig {
+    /** Number of seconds to wait after the tool fires before the assistant speaks a follow-up if the user stays silent. When null, the assistant stays silent (default). */
+    respond_after_sec?: (number | null) | undefined;
+}

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

@@ -125,7 +125,7 @@ export declare namespace CreateAgentRequest {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -97,7 +97,7 @@ export declare namespace OutboundCallConfig {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -48,6 +48,8 @@ export interface 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;
+    /** For built_in_choose_not_to_respond tools. Number of seconds to wait after the tool fires before the agent speaks a follow-up if the user stays silent. When null, the agent stays silent (default). Not used by other tool types. */
+    respond_after_sec?: (number | null) | 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. */

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

@@ -13,6 +13,7 @@ export * from "./BasicError.js";
 export * from "./BuiltInToolConfig.js";
 export * from "./BuiltInToolConfigs.js";
 export * from "./BuiltInToolDefinition.js";
+export * from "./ChooseNotToRespondToolConfig.js";
 export * from "./ConfigOptions.js";
 export * from "./ConfigPayload.js";
 export * from "./Conversation.js";

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

@@ -29,6 +29,7 @@ __exportStar(require("./BasicError.js"), exports);
 __exportStar(require("./BuiltInToolConfig.js"), exports);
 __exportStar(require("./BuiltInToolConfigs.js"), exports);
 __exportStar(require("./BuiltInToolDefinition.js"), exports);
+__exportStar(require("./ChooseNotToRespondToolConfig.js"), exports);
 __exportStar(require("./ConfigOptions.js"), exports);
 __exportStar(require("./ConfigPayload.js"), exports);
 __exportStar(require("./Conversation.js"), exports);

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

@@ -27,6 +27,11 @@ type EventHandlers = {
  * with a terminal close code (4800 session expired, 4801 invalid state),
  * the safety cap is reached, or the user calls close().
  *
+ * A reconnectable close is not surfaced to the user's close handler while the
+ * reconnect is in flight. The close is emitted only when reconnection has
+ * failed, meaning the conversation is closing. Closes that are not
+ * reconnectable (1000, 4000, etc) are not affected and will pass through.
+ *
  * Uses composition rather than inheritance to avoid coupling to the parent's
  * private event handler registration or ReconnectingWebSocket internals.
  */
@@ -41,6 +46,8 @@ export declare class ReconnectableConversationsSocket {
     private _cleanupWireListeners;
     private _pendingReconnect;
     private _pendingReplacement;
+    private _lastSuppressedClose;
+    private _gaveUp;
     constructor(args: ReconnectableConversationsSocketArgs);
     /** The conversation ID captured from the server's conversation_created message. */
     get conversationId(): string | null;
@@ -67,9 +74,18 @@ export declare class ReconnectableConversationsSocket {
     connect(): never;
     close(): void;
     waitForOpen(): Promise<core.ReconnectingWebSocket>;
+    private _willReconnectAfter;
+    private _giveUp;
     private _getReconnectDelay;
     /** Schedule a reconnection attempt after backoff delay. */
     private _scheduleReconnect;
+    /** Settle as soon as the abort signal fires rather than waiting on the
+     *  factory, whose promise is caller-supplied (it awaits fresh auth) and
+     *  may never settle — the suppressed close would stay hidden forever.
+     *  Resolves null when aborted; a socket arriving afterwards is closed
+     *  rather than leaked. The listener is removed once the factory settles,
+     *  so a long-lived conversation does not accumulate them on the signal. */
+    private _createSocketOrAbort;
     /** Perform the actual reconnection attempt. */
     private _doReconnect;
     private _wireInner;

package/dist/cjs/custom/ReconnectableConversationsSocket.js

@@ -80,6 +80,11 @@ const MAX_RECONNECT_ATTEMPTS = 10;
  * with a terminal close code (4800 session expired, 4801 invalid state),
  * the safety cap is reached, or the user calls close().
  *
+ * A reconnectable close is not surfaced to the user's close handler while the
+ * reconnect is in flight. The close is emitted only when reconnection has
+ * failed, meaning the conversation is closing. Closes that are not
+ * reconnectable (1000, 4000, etc) are not affected and will pass through.
+ *
  * Uses composition rather than inheritance to avoid coupling to the parent's
  * private event handler registration or ReconnectingWebSocket internals.
  */
@@ -92,6 +97,8 @@ class ReconnectableConversationsSocket {
         this._cleanupWireListeners = null;
         this._pendingReconnect = null;
         this._pendingReplacement = false;
+        this._lastSuppressedClose = null;
+        this._gaveUp = false;
         this._createReconnectSocket = args.createReconnectSocket;
         this._abortSignal = args.abortSignal != undefined ? args.abortSignal : null;
         this._inner = new Socket_js_1.ConversationsSocket({ socket: args.socket });
@@ -170,15 +177,36 @@ class ReconnectableConversationsSocket {
             clearTimeout(this._pendingReconnect);
             this._pendingReconnect = null;
         }
+        // Close before detaching: ConversationsSocket.close() synthesizes a
+        // 1000 close event, and a user-initiated close should still surface one.
+        this._inner.close();
         (_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();
         });
     }
+    _willReconnectAfter(event) {
+        return (!this._isClosed
+            && !this._gaveUp
+            && this._conversationId !== null
+            && isReconnectableClose(event.code, event.reason));
+    }
+    _giveUp() {
+        var _a, _b;
+        this._pendingReplacement = false;
+        if (this._gaveUp || this._isClosed) {
+            return;
+        }
+        this._gaveUp = true;
+        const suppressed = this._lastSuppressedClose;
+        this._lastSuppressedClose = null;
+        if (suppressed !== null) {
+            (_b = (_a = this._handlers).close) === null || _b === void 0 ? void 0 : _b.call(_a, suppressed);
+        }
+    }
     _getReconnectDelay() {
         // Exponential backoff: 500ms, 1s, 2s, 4s, capped at 5s
         const delay = BASE_RECONNECT_DELAY_MS * Math.pow(2, this._reconnectAttempts - 1);
@@ -187,12 +215,18 @@ class ReconnectableConversationsSocket {
     /** 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)) {
+        // With no conversation the close was never suppressed, so unlike the
+        // branches below there is nothing to emit.
+        if (this._isClosed || this._conversationId === null) {
+            return;
+        }
+        if ((_a = this._abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+            this._giveUp();
             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"));
+            this._giveUp();
             return;
         }
         // Clear any existing timer to prevent orphaned timeouts
@@ -203,24 +237,70 @@ class ReconnectableConversationsSocket {
         const delay = this._getReconnectDelay();
         this._pendingReplacement = true;
         this._pendingReconnect = setTimeout(() => {
+            var _a;
             this._pendingReconnect = null;
             if (this._isClosed) {
                 this._pendingReplacement = false;
                 return;
             }
+            if ((_a = this._abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                this._giveUp();
+                return;
+            }
             void this._doReconnect();
         }, delay);
     }
+    /** Settle as soon as the abort signal fires rather than waiting on the
+     *  factory, whose promise is caller-supplied (it awaits fresh auth) and
+     *  may never settle — the suppressed close would stay hidden forever.
+     *  Resolves null when aborted; a socket arriving afterwards is closed
+     *  rather than leaked. The listener is removed once the factory settles,
+     *  so a long-lived conversation does not accumulate them on the signal. */
+    _createSocketOrAbort(created) {
+        const signal = this._abortSignal;
+        if (signal === null) {
+            return created;
+        }
+        const discardLate = () => {
+            void created.then((socket) => socket.close()).catch(() => undefined);
+        };
+        if (signal.aborted) {
+            discardLate();
+            return Promise.resolve(null);
+        }
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                discardLate();
+                resolve(null);
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            created.then((socket) => {
+                signal.removeEventListener("abort", onAbort);
+                resolve(socket);
+            }, (error) => {
+                signal.removeEventListener("abort", onAbort);
+                reject(error);
+            });
+        });
+    }
     /** 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;
+                const newRawSocket = created instanceof Promise ? yield this._createSocketOrAbort(created) : created;
+                if (newRawSocket === null) {
+                    // Aborted while the factory was still in flight.
+                    this._giveUp();
+                    return;
+                }
                 if (this._isClosed || ((_a = this._abortSignal) === null || _a === void 0 ? void 0 : _a.aborted)) {
                     this._pendingReplacement = false;
                     newRawSocket.close();
+                    if (!this._isClosed) {
+                        this._giveUp();
+                    }
                     return;
                 }
                 // Clean up the old socket: remove our custom listeners and close
@@ -233,7 +313,7 @@ class ReconnectableConversationsSocket {
                 catch ( /* already closed from 1006 */_c) { /* already closed from 1006 */ }
                 const newInner = new Socket_js_1.ConversationsSocket({ socket: newRawSocket });
                 this._inner = newInner;
-                this._wireInner(newInner, newRawSocket);
+                this._wireInner(newInner, newRawSocket, true);
             }
             catch (_d) {
                 this._pendingReplacement = false;
@@ -244,17 +324,41 @@ class ReconnectableConversationsSocket {
             }
         });
     }
-    _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.
+    _wireInner(inner, rawSocket, isReplacement = false) {
+        // A replacement that closes before ever opening failed at the transport
+        // level, and its code says nothing about why: ReconnectingWebSocket
+        // synthesizes 1000 for connect errors and timeouts (_handleError ->
+        // _disconnect). Read it as a failed attempt rather than as a close.
+        // _isClosed excluded: close() also reaches this via the synthesized
+        // 1000, and a user-initiated close is a close, not a failed attempt.
+        let opened = false;
+        const isFailedAttempt = () => isReplacement && !opened && !this._isClosed;
+        // Clearing _pendingReplacement before the user's open handler keeps
+        // sends made inside that handler from being dropped.
         inner.on("open", () => {
             var _a, _b;
+            opened = true;
             this._pendingReplacement = false;
+            this._lastSuppressedClose = null;
             (_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); });
+        // ConversationsSocket registers this in its constructor, so it runs
+        // before the rawSocket close listener below that schedules the
+        // reconnect — the decision cannot be read off reconnect state here.
+        inner.on("close", (ev) => {
+            var _a, _b;
+            // Leave _lastSuppressedClose holding the original drop, so _giveUp
+            // reports what went wrong rather than this attempt's code.
+            if (isFailedAttempt()) {
+                return;
+            }
+            if (this._willReconnectAfter(ev)) {
+                this._lastSuppressedClose = ev;
+                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) => {
@@ -274,8 +378,15 @@ class ReconnectableConversationsSocket {
                 // ignore — inner socket handles parse errors
             }
         };
+        // After giving up this is a plain pass-through: the close was already
+        // forwarded above, and retrying would repeat the give-up error.
         const onClose = (event) => {
-            if (this._isClosed) {
+            if (this._isClosed || this._gaveUp) {
+                return;
+            }
+            if (isFailedAttempt()) {
+                rawSocket.close();
+                this._scheduleReconnect();
                 return;
             }
             if (isReconnectableClose(event.code, event.reason) && this._conversationId !== null) {
@@ -294,6 +405,11 @@ class ReconnectableConversationsSocket {
         rawSocket.addEventListener("message", onMessage);
         rawSocket.addEventListener("close", onClose);
         this._cleanupWireListeners = () => {
+            // ConversationsSocket.close() synthesizes a 1000 close event, so a
+            // discarded socket would otherwise report a spurious normal closure.
+            for (const event of ["open", "message", "close", "error"]) {
+                inner.on(event, undefined);
+            }
             rawSocket.removeEventListener("message", onMessage);
             rawSocket.removeEventListener("close", onClose);
         };

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.32.13";
+export declare const SDK_VERSION = "0.32.15";

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.13";
+exports.SDK_VERSION = "0.32.15";

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.13",
-        "User-Agent": "phonic/0.32.13",
+        "X-Fern-SDK-Version": "0.32.15",
+        "User-Agent": "phonic/0.32.15",
         "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/api/resources/agents/client/requests/UpdateAgentRequest.d.mts

@@ -178,7 +178,7 @@ export declare namespace UpdateAgentRequest {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -217,6 +217,8 @@ export interface CreateToolRequest {
     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;
+    /** For built_in_choose_not_to_respond tools. Number of seconds to wait after the tool fires before the agent speaks a follow-up if the user stays silent. When null, the agent stays silent (default). Not used by other tool types. */
+    respond_after_sec?: number | null;
     /** 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. */

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

@@ -57,6 +57,8 @@ export interface UpdateToolRequest {
     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;
+    /** For built_in_choose_not_to_respond tools. Number of seconds to wait after the tool fires before the agent speaks a follow-up if the user stays silent. When null, the agent stays silent (default). Not used by other tool types. */
+    respond_after_sec?: number | null;
     /** 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. */

package/dist/esm/api/resources/tts/client/requests/StreamTtsRequest.d.mts

@@ -1,3 +1,4 @@
+import type * as Phonic from "../../../../index.mjs";
 /**
  * @example
  *     {
@@ -15,6 +16,11 @@ export interface StreamTtsRequest {
     voice_id?: string;
     /** The audio format to stream. */
     output_format?: StreamTtsRequest.OutputFormat;
+    /**
+     * Candidate languages for synthesis. An empty array defaults to English, one language
+     * selects it directly, and multiple languages let Phonic detect among those candidates.
+     */
+    languages?: Phonic.LanguageCode[];
 }
 export declare namespace StreamTtsRequest {
     /** The audio format to stream. */

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

@@ -127,7 +127,7 @@ export declare namespace Agent {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;

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

@@ -1,5 +1,5 @@
 /**
- * Configuration for a simple built-in tool (`keypad_input`, `natural_conversation_ending`, or `choose_not_to_respond`).
+ * Configuration for a simple built-in tool (`keypad_input` or `natural_conversation_ending`).
  */
 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). */

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

@@ -1,5 +1,8 @@
 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.
+ * Per-tool configuration overrides for built-in tools, keyed by built-in tool ID. The value's shape depends on the tool: `tool_keypad_input` and `tool_natural_conversation_ending` take a `speech_before_tool_call` config; `tool_choose_not_to_respond` takes a `respond_after_sec` config. A built-in tool referenced in `tools` but absent from this map uses its default configuration.
  */
-export type BuiltInToolConfigs = Record<string, Phonic.BuiltInToolConfig>;
+export type BuiltInToolConfigs = Record<string, BuiltInToolConfigs.Value>;
+export declare namespace BuiltInToolConfigs {
+    type Value = Phonic.BuiltInToolConfig | Phonic.ChooseNotToRespondToolConfig;
+}

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

@@ -1,18 +1,24 @@
 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.
+ * A built-in tool with an explicit configuration, as an alternative to referencing it by bare name (which uses the tool's default configuration). `keypad_input` and `natural_conversation_ending` take a `speech_before_tool_call` config; `choose_not_to_respond` takes a `respond_after_sec` config.
  */
 export interface BuiltInToolDefinition {
     type: "built_in";
     /** The name of the built-in tool. */
     name: BuiltInToolDefinition.Name;
-    tool_config: Phonic.BuiltInToolConfig;
+    /** The tool's configuration. Use `BuiltInToolConfig` for `keypad_input` and `natural_conversation_ending`, or `ChooseNotToRespondToolConfig` for `choose_not_to_respond`. */
+    tool_config: BuiltInToolDefinition.ToolConfig;
 }
 export declare namespace BuiltInToolDefinition {
     /** The name of the built-in tool. */
     const Name: {
         readonly KeypadInput: "keypad_input";
         readonly NaturalConversationEnding: "natural_conversation_ending";
+        readonly ChooseNotToRespond: "choose_not_to_respond";
     };
     type Name = (typeof Name)[keyof typeof Name];
+    /**
+     * The tool's configuration. Use `BuiltInToolConfig` for `keypad_input` and `natural_conversation_ending`, or `ChooseNotToRespondToolConfig` for `choose_not_to_respond`.
+     */
+    type ToolConfig = Phonic.BuiltInToolConfig | Phonic.ChooseNotToRespondToolConfig;
 }

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

@@ -5,5 +5,6 @@ export var BuiltInToolDefinition;
     BuiltInToolDefinition.Name = {
         KeypadInput: "keypad_input",
         NaturalConversationEnding: "natural_conversation_ending",
+        ChooseNotToRespond: "choose_not_to_respond",
     };
 })(BuiltInToolDefinition || (BuiltInToolDefinition = {}));

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

@@ -0,0 +1,7 @@
+/**
+ * Configuration for the `choose_not_to_respond` built-in tool.
+ */
+export interface ChooseNotToRespondToolConfig {
+    /** Number of seconds to wait after the tool fires before the assistant speaks a follow-up if the user stays silent. When null, the assistant stays silent (default). */
+    respond_after_sec?: (number | null) | undefined;
+}

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

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

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

@@ -125,7 +125,7 @@ export declare namespace CreateAgentRequest {
     }
     type Tools = Tools.Item[];
     namespace Tools {
-        type Item = "keypad_input" | "natural_conversation_ending"
+        type Item = "keypad_input" | "natural_conversation_ending" | "choose_not_to_respond"
         /**
          * Custom tool */
          | string;