phonic 0.32.10 → 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.10",
-        "User-Agent": "phonic/0.32.10",
+        "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/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/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/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.32.10";
+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.10";
+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.10",
-        "User-Agent": "phonic/0.32.10",
+        "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/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/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/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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