phonic 0.32.23 → 0.32.25

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

@@ -4,7 +4,7 @@ export declare namespace ConversationsSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Phonic.ReadyToStartConversationPayload | Phonic.ConversationCreatedPayload | Phonic.InputTextPayload | Phonic.InputCancelledPayload | Phonic.AudioChunkResponsePayload | Phonic.UserStartedSpeakingPayload | Phonic.UserFinishedSpeakingPayload | Phonic.AssistantStartedSpeakingPayload | Phonic.AssistantFinishedSpeakingPayload | Phonic.DtmfPayload | Phonic.ToolCallPayload | Phonic.ToolCallOutputProcessedPayload | Phonic.ToolCallInterruptedPayload | Phonic.AssistantChoseNotToRespondPayload | Phonic.AssistantEndedConversationPayload | Phonic.ErrorPayload | Phonic.WarningPayload;
+    type Response = Phonic.ReadyToStartConversationPayload | Phonic.ConversationCreatedPayload | Phonic.InputTextPayload | Phonic.InputCancelledPayload | Phonic.AudioChunkResponsePayload | Phonic.UserStartedSpeakingPayload | Phonic.UserFinishedSpeakingPayload | Phonic.AssistantStartedSpeakingPayload | Phonic.AssistantFinishedSpeakingPayload | Phonic.InterruptedResponsePayload | Phonic.DtmfPayload | Phonic.ToolCallPayload | Phonic.ToolCallOutputProcessedPayload | Phonic.ToolCallInterruptedPayload | Phonic.AssistantChoseNotToRespondPayload | Phonic.AssistantEndedConversationPayload | Phonic.ErrorPayload | Phonic.WarningPayload;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;

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

@@ -16,13 +16,26 @@ export declare class ResponsesClient {
      *
      * This endpoint is stateless, so it does not create a new conversation or
      * store anything. The request carries the system prompt, a conversation so
-     * far as `input`, and the tools the assistant may call as
-     * `tool_definitions`.
+     * far as `input`, and the tools the assistant may call.
+     *
+     * There are two different types of tool configurations:
+     *
+     * - `tool_definitions`: defined inline. Typically if you use LiveKit, this
+     *   is where you can pass in your tool definitions.
+     * - `tools`: predefined tools configured in Phonic, referenced by name, in
+     *   the same shape as the STS WebSocket `config` message. Today this covers
+     *   built-in tools such as `choose_not_to_respond` and transfer tools stored
+     *   in `project`. Your context, webhook, MCP and WebSocket tools cannot be
+     *   referenced here yet; define those inline as `tool_definitions`.
      *
      * Each item in `input` is a user message, an assistant message (with
-     * optional `tool_calls`), or a `tool_call_output`. Every assistant tool
-     * call must be followed immediately by the `tool_call_output` item that
-     * carries its result.
+     * optional `tool_calls` or an `action`), or a `tool_call_output`. Every
+     * assistant tool call must be followed immediately by the
+     * `tool_call_output` item that carries its result.
+     *
+     * A tool referenced in `tools` resolves to an `action` on the generated
+     * response rather than a tool call - the event a live conversation would
+     * have emitted, without the effect actually being carried out.
      *
      * This is an experimental feature and must be enabled for your workspace;
      * otherwise, it returns `404`. Please contact our team if you would like
@@ -66,6 +79,23 @@ export declare class ResponsesClient {
      *             }],
      *         num_responses: 2
      *     })
+     *
+     * @example
+     *     await client.responses.create({
+     *         system_prompt: "You route callers to the right team. Be friendly and concise.",
+     *         project: "main",
+     *         input: [{
+     *                 role: "user",
+     *                 text: "I have a problem with my bill."
+     *             }],
+     *         tools: ["transfer_to_support", {
+     *                 type: "built_in",
+     *                 name: "natural_conversation_ending",
+     *                 tool_config: {
+     *                     speech_before_tool_call: "required"
+     *                 }
+     *             }]
+     *     })
      */
     create(request: Phonic.GenerateResponsesRequest, requestOptions?: ResponsesClient.RequestOptions): core.HttpResponsePromise<Phonic.GenerateResponsesResponse>;
     private __create;

package/dist/esm/api/resources/responses/client/Client.mjs

@@ -25,13 +25,26 @@ export class ResponsesClient {
      *
      * This endpoint is stateless, so it does not create a new conversation or
      * store anything. The request carries the system prompt, a conversation so
-     * far as `input`, and the tools the assistant may call as
-     * `tool_definitions`.
+     * far as `input`, and the tools the assistant may call.
+     *
+     * There are two different types of tool configurations:
+     *
+     * - `tool_definitions`: defined inline. Typically if you use LiveKit, this
+     *   is where you can pass in your tool definitions.
+     * - `tools`: predefined tools configured in Phonic, referenced by name, in
+     *   the same shape as the STS WebSocket `config` message. Today this covers
+     *   built-in tools such as `choose_not_to_respond` and transfer tools stored
+     *   in `project`. Your context, webhook, MCP and WebSocket tools cannot be
+     *   referenced here yet; define those inline as `tool_definitions`.
      *
      * Each item in `input` is a user message, an assistant message (with
-     * optional `tool_calls`), or a `tool_call_output`. Every assistant tool
-     * call must be followed immediately by the `tool_call_output` item that
-     * carries its result.
+     * optional `tool_calls` or an `action`), or a `tool_call_output`. Every
+     * assistant tool call must be followed immediately by the
+     * `tool_call_output` item that carries its result.
+     *
+     * A tool referenced in `tools` resolves to an `action` on the generated
+     * response rather than a tool call - the event a live conversation would
+     * have emitted, without the effect actually being carried out.
      *
      * This is an experimental feature and must be enabled for your workspace;
      * otherwise, it returns `404`. Please contact our team if you would like
@@ -75,6 +88,23 @@ export class ResponsesClient {
      *             }],
      *         num_responses: 2
      *     })
+     *
+     * @example
+     *     await client.responses.create({
+     *         system_prompt: "You route callers to the right team. Be friendly and concise.",
+     *         project: "main",
+     *         input: [{
+     *                 role: "user",
+     *                 text: "I have a problem with my bill."
+     *             }],
+     *         tools: ["transfer_to_support", {
+     *                 type: "built_in",
+     *                 name: "natural_conversation_ending",
+     *                 tool_config: {
+     *                     speech_before_tool_call: "required"
+     *                 }
+     *             }]
+     *     })
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));

package/dist/esm/api/resources/responses/client/requests/GenerateResponsesRequest.d.mts

@@ -27,6 +27,23 @@ import type * as Phonic from "../../../../index.mjs";
  *             }],
  *         num_responses: 2
  *     }
+ *
+ * @example
+ *     {
+ *         system_prompt: "You route callers to the right team. Be friendly and concise.",
+ *         project: "main",
+ *         input: [{
+ *                 role: "user",
+ *                 text: "I have a problem with my bill."
+ *             }],
+ *         tools: ["transfer_to_support", {
+ *                 type: "built_in",
+ *                 name: "natural_conversation_ending",
+ *                 tool_config: {
+ *                     speech_before_tool_call: "required"
+ *                 }
+ *             }]
+ *     }
  */
 export interface GenerateResponsesRequest {
     /** The system prompt the assistant should follow. */
@@ -39,8 +56,12 @@ export interface GenerateResponsesRequest {
     additional_languages?: Phonic.LanguageCode[];
     /** The conversation so far, in order. Must contain at least one item. */
     input: Phonic.ResponsesInputItem[];
-    /** The tools the assistant may call, defined inline. Names must be unique and cannot be one of the names Phonic reserves for its built-in tools. */
+    /** Tools defined inline for this request only. Typically if you use LiveKit, this is where you can pass in your tool definitions. Names must be unique, must not repeat a name in `tools`, and cannot be one of the names Phonic reserves for its built-in tools. */
     tool_definitions?: Phonic.ResponsesToolDefinition[];
+    /** Name of the project the tools referenced by name in `tools` belong to. Required whenever `tools` names a tool stored in your workspace; built-in tools can be referenced without it. */
+    project?: string;
+    /** Tools the assistant may call that already exist - a built-in tool, or a transfer tool stored in `project`, referenced by name. Names must be unique and must not repeat a name in `tool_definitions`. Stored tools that are not transfer tools cannot be referenced here yet; define them inline as `tool_definitions` instead. */
+    tools?: Phonic.ResponsesTool[];
     /** Number of alternative responses to generate. */
     num_responses?: number;
 }

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

@@ -233,6 +233,8 @@ export interface CreateToolRequest {
     allow_tool_chaining?: boolean;
     /** The agent doesn't typically wait for the response of async tools. When true, makes the agent wait for a response, not call other tools and inform the user of the result. Only available for async custom_webhook and custom_websocket tools, and cannot be combined with allow_tool_chaining set to true. */
     wait_for_response?: boolean;
+    /** When true, the user cannot interrupt the agent while the tool call is in flight; the agent's turn is held open until the tool returns. Only available for sync custom_webhook and custom_websocket tools. */
+    uninterruptible?: boolean;
     /** The static context returned to the agent. Required for custom_context tools. */
     context?: string;
 }

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

@@ -73,6 +73,8 @@ export interface UpdateToolRequest {
     allow_tool_chaining?: boolean;
     /** The agent doesn't typically wait for the response of async tools. When true, makes the agent wait for a response, not call other tools and inform the user of the result. Only available for async custom_webhook and custom_websocket tools, and cannot be combined with allow_tool_chaining set to true. */
     wait_for_response?: boolean;
+    /** When true, the user cannot interrupt the agent while the tool call is in flight; the agent's turn is held open until the tool returns. Only available for sync custom_webhook and custom_websocket tools, so the resulting execution_mode must be sync. */
+    uninterruptible?: boolean;
 }
 export declare namespace UpdateToolRequest {
     /** Mode of operation. */

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

@@ -28,6 +28,10 @@ export interface Agent {
     is_welcome_message_interruptible: boolean;
     /** Number of seconds of inactivity before the conversation WebSocket is closed. */
     websocket_timeout_sec?: number | undefined;
+    /** Play an uninterruptible welcome message on incoming calls, then transcribe the caller without responding. Silence timeout and call duration limits still apply. */
+    listen_only_inbound_enabled: boolean;
+    /** Welcome message for listen-only incoming calls. Can contain template variables like `{{customer_name}}`. Must be nonempty when `listen_only_inbound_enabled` is `true`. Replaces `welcome_message` for these calls, regardless of `generate_welcome_message`. */
+    listen_only_inbound_message: string | null;
     /** Message to play when the conversation starts. Ignored when `generate_welcome_message` is `true`. */
     welcome_message: string | null;
     /** Instructions for the conversation. */

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

@@ -18,6 +18,8 @@ export interface Conversation {
     generate_welcome_message: boolean;
     /** When `false`, the welcome message will not be interruptible by the user. */
     is_welcome_message_interruptible: boolean;
+    /** Whether this conversation used listen-only mode. The resolved greeting is stored in `welcome_message`. */
+    listen_only: boolean;
     /** Welcome message played at start. Will be `null` when `generate_welcome_message` is `true`. */
     welcome_message: string | null;
     /** Template variables used in the conversation. */
@@ -181,7 +183,7 @@ export declare namespace Conversation {
      * Phone call metadata. `null` for non-phone call conversations.
      */
     interface CallInfo {
-        /** Caller phone number in E.164 format. */
+        /** Caller phone number in E.164 format. `"anonymous"` for inbound calls whose caller withheld their number. */
         from_phone_number: string;
         /** Callee phone number in E.164 format. */
         to_phone_number: string;

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

@@ -28,6 +28,10 @@ export interface CreateAgentRequest {
     is_welcome_message_interruptible?: boolean | undefined;
     /** Number of seconds of inactivity before the conversation WebSocket is closed. */
     websocket_timeout_sec?: number | undefined;
+    /** Play an uninterruptible welcome message on incoming calls, then transcribe the caller without responding. Silence timeout and call duration limits still apply. */
+    listen_only_inbound_enabled?: boolean | undefined;
+    /** Welcome message for listen-only incoming calls. Can contain template variables like `{{customer_name}}`. Must be nonempty when `listen_only_inbound_enabled` is `true`. Replaces `welcome_message` for these calls, regardless of `generate_welcome_message`. */
+    listen_only_inbound_message?: (string | null) | undefined;
     /** Message to play when the conversation starts. Can contain template variables like `{{customer_name}}`. Ignored when `generate_welcome_message` is `true`. */
     welcome_message?: (string | null) | undefined;
     /** Instructions for the conversation. Can contain template variables like `{{subject}}`. */

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

@@ -1,7 +1,9 @@
 import type * as Phonic from "../index.mjs";
 export interface GeneratedResponse {
-    /** The text the assistant would say. Empty when the response only makes tool calls. */
+    /** The text the assistant would say. Empty when the response only makes tool calls or only takes an action. */
     text: string;
     /** Tool calls the assistant would make - note that the tools are not actually called. */
     tool_calls: Phonic.GeneratedToolCall[];
+    /** The action the assistant would take, when the response calls one of the tools referenced in `tools`. Note that the action is not actually carried out. */
+    action?: Phonic.ResponsesAction | undefined;
 }

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

@@ -21,6 +21,8 @@ export interface InlineWebSocketTool {
     allow_tool_chaining?: boolean | undefined;
     /** For async tools, when true, the assistant waits for the response and speaks when it arrives. */
     wait_for_response?: boolean | undefined;
+    /** For sync tools, when true, the user cannot interrupt the assistant while the tool call is in flight; the assistant's turn is held open until the tool returns. */
+    uninterruptible?: boolean | undefined;
 }
 export declare namespace InlineWebSocketTool {
     /** Whether the assistant waits for the tool output before continuing. */

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

@@ -0,0 +1,5 @@
+export interface InterruptedResponsePayload {
+    type: "interrupted_response";
+    /** The part of the assistant's turn that was spoken before the user interrupted. */
+    text: string;
+}

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

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

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

@@ -0,0 +1,22 @@
+import type * as Phonic from "../index.mjs";
+/**
+ * The action the assistant takes on a turn - the event a live Phonic conversation would have emitted over the STS WebSocket, without the effect actually being carried out.
+ */
+export type ResponsesAction = Phonic.ResponsesAction.AssistantChoseNotToRespond | Phonic.ResponsesAction.AssistantEndedConversation | Phonic.ResponsesAction.Dtmf | Phonic.ResponsesAction.TransferToPhoneNumber | Phonic.ResponsesAction.TransferToAgent;
+export declare namespace ResponsesAction {
+    interface AssistantChoseNotToRespond extends Phonic.ResponsesChoseNotToRespondAction {
+        type: "assistant_chose_not_to_respond";
+    }
+    interface AssistantEndedConversation extends Phonic.ResponsesEndedConversationAction {
+        type: "assistant_ended_conversation";
+    }
+    interface Dtmf extends Phonic.ResponsesDtmfAction {
+        type: "dtmf";
+    }
+    interface TransferToPhoneNumber extends Phonic.ResponsesTransferToPhoneNumberAction {
+        type: "transfer_to_phone_number";
+    }
+    interface TransferToAgent extends Phonic.ResponsesTransferToAgentAction {
+        type: "transfer_to_agent";
+    }
+}

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

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

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

@@ -1,11 +1,13 @@
 import type * as Phonic from "../index.mjs";
 /**
- * An assistant turn. Must carry `text`, `tool_calls`, or both.
+ * An assistant turn. Must carry at least one of `text`, `tool_calls`, or `action`. `tool_calls` and `action` cannot both be present.
  */
 export interface ResponsesAssistantMessage {
     role: "assistant";
-    /** What the assistant said. Empty when the turn only made tool calls. */
+    /** What the assistant said. Empty when the turn only made tool calls or only took an action. */
     text: string;
     /** Tool calls the assistant made on this turn. Each one must be followed immediately by its matching `tool_call_output` item. */
     tool_calls?: Phonic.ResponsesToolCall[] | undefined;
+    /** The action the assistant took on this turn. Cannot be combined with `tool_calls`. */
+    action?: Phonic.ResponsesAction | undefined;
 }

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

@@ -0,0 +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). `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 ResponsesBuiltInTool {
+    type: "built_in";
+    /** The name of the built-in tool. */
+    name: ResponsesBuiltInTool.Name;
+    /** The tool's configuration. Use `BuiltInToolConfig` for `keypad_input` and `natural_conversation_ending`, or `ChooseNotToRespondToolConfig` for `choose_not_to_respond`. */
+    tool_config: ResponsesBuiltInTool.ToolConfig;
+}
+export declare namespace ResponsesBuiltInTool {
+    /** 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/ResponsesBuiltInTool.mjs

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

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

@@ -0,0 +1,7 @@
+/**
+ * The assistant stayed silent instead of responding (the `choose_not_to_respond` built-in tool).
+ */
+export interface ResponsesChoseNotToRespondAction {
+    /** Number of seconds the assistant would wait before speaking a follow-up if the user stays silent, echoed from the tool's configuration. When null, the assistant stays silent. */
+    respond_after_sec?: (number | null) | undefined;
+}

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * The assistant pressed keypad digits (the `keypad_input` built-in tool).
+ */
+export interface ResponsesDtmfAction {
+    /** The digits the assistant pressed. */
+    digits: string;
+}

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

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

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

@@ -0,0 +1,4 @@
+/**
+ * The assistant ended the conversation (the `natural_conversation_ending` built-in tool).
+ */
+export type ResponsesEndedConversationAction = {};

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

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

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

@@ -0,0 +1,5 @@
+import type * as Phonic from "../index.mjs";
+/**
+ * A tool that already exists, referenced by name - either a built-in tool or a transfer tool stored in `project`. Use the object form to configure a built-in tool explicitly; a bare name uses the tool's default configuration.
+ */
+export type ResponsesTool = Phonic.ResponsesToolName | Phonic.ResponsesBuiltInTool;

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

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

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

@@ -8,4 +8,8 @@ export interface ResponsesToolDefinition {
     /** What the tool does. The model uses this to decide when to call it. */
     description: string;
     parameters: Phonic.ToolParametersJsonSchema;
+    /** When true, forces the agent to speak before executing the tool. Note this defaults to true here, unlike on the tools API, so a simulated turn matches the default a custom tool runs with in a live call. */
+    require_speech_before_tool_call?: boolean | undefined;
+    /** When true, forbids the agent from calling the tool right after it has spoken. The call is dropped and the speech is kept. */
+    forbid_tool_call_after_speech?: boolean | undefined;
 }

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

@@ -0,0 +1,4 @@
+/**
+ * Name of a built-in tool, or of a transfer tool stored in `project`. Must be snake_case.
+ */
+export type ResponsesToolName = string;

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * The assistant transferred the conversation to another agent (a `built_in_transfer_to_agent` tool).
+ */
+export interface ResponsesTransferToAgentAction {
+    /** Name of the agent the conversation would be transferred to. */
+    agent: string;
+}

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * The assistant transferred the call to a phone number (a `built_in_transfer_to_phone_number` tool).
+ */
+export interface ResponsesTransferToPhoneNumberAction {
+    /** The phone number the call would be transferred to, in E.164 format. */
+    phone_number: string;
+    /** Whether Phonic would detect whether the transfer reached a voicemail. */
+    detect_voicemail: boolean;
+    /** Whether the transfer would be placed from the agent's phone number. */
+    use_agent_phone_number: boolean;
+    /** Whether Phonic would keep transcribing the call after the transfer. */
+    keep_listening: boolean;
+    /** Digits to dial after the transfer connects, for navigating a phone menu. Null when there are none. */
+    dtmf?: (string | null) | undefined;
+}

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

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

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

@@ -1,7 +1,7 @@
 /**
  * A tool's parameters expressed as a raw JSON Schema object, for parameters that the flat `ToolParameter` list cannot express: nested objects, arrays of objects, `anyOf` variants, `null`, and non-string enums.
  * Each entry in `properties` is a JSON Schema value supporting `type` (`"string"`, `"integer"`, `"number"`, `"boolean"`, `"null"`, `"array"`, `"object"`), `description`, `enum` (string parameters only), `items` (for arrays), `properties`/`required`/`additionalProperties` (for objects) and `anyOf`. Values may be nested up to 5 levels deep.
- * Parameter names cannot be any of the reserved names that Phonic injects into every tool call: `call_info`, `conversation_id`, `from_phone_number`, `to_phone_number`, `twilio_call_sid`.
+ * Parameter names cannot be any of the reserved names that Phonic injects into every tool call: `call_info`, `conversation_id`, `from_phone_number`, `pre_tool_text`, `to_phone_number`, `twilio_call_sid`.
  * For `custom_webhook` tools, parameter placement is supplied separately in `parameter_locations` rather than inline on the schema.
  */
 export interface ToolParametersJsonSchema {

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

@@ -46,6 +46,7 @@ export * from "./GenerateResponsesResponse.mjs";
 export * from "./InlineWebSocketTool.mjs";
 export * from "./InputCancelledPayload.mjs";
 export * from "./InputTextPayload.mjs";
+export * from "./InterruptedResponsePayload.mjs";
 export * from "./LanguageCode.mjs";
 export * from "./MutePayload.mjs";
 export * from "./OpenAiFunction.mjs";
@@ -60,12 +61,21 @@ export * from "./ReadyToStartConversationPayload.mjs";
 export * from "./ReplayConversationItemResponse.mjs";
 export * from "./ReplayToolCall.mjs";
 export * from "./ResetPayload.mjs";
+export * from "./ResponsesAction.mjs";
 export * from "./ResponsesAssistantMessage.mjs";
+export * from "./ResponsesBuiltInTool.mjs";
+export * from "./ResponsesChoseNotToRespondAction.mjs";
+export * from "./ResponsesDtmfAction.mjs";
+export * from "./ResponsesEndedConversationAction.mjs";
 export * from "./ResponsesInputItem.mjs";
+export * from "./ResponsesTool.mjs";
 export * from "./ResponsesToolCall.mjs";
 export * from "./ResponsesToolCallOutput.mjs";
 export * from "./ResponsesToolDefinition.mjs";
+export * from "./ResponsesToolName.mjs";
 export * from "./ResponsesToolReference.mjs";
+export * from "./ResponsesTransferToAgentAction.mjs";
+export * from "./ResponsesTransferToPhoneNumberAction.mjs";
 export * from "./ResponsesUserMessage.mjs";
 export * from "./SayPayload.mjs";
 export * from "./SetExternalIdPayload.mjs";

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

@@ -46,6 +46,7 @@ export * from "./GenerateResponsesResponse.mjs";
 export * from "./InlineWebSocketTool.mjs";
 export * from "./InputCancelledPayload.mjs";
 export * from "./InputTextPayload.mjs";
+export * from "./InterruptedResponsePayload.mjs";
 export * from "./LanguageCode.mjs";
 export * from "./MutePayload.mjs";
 export * from "./OpenAiFunction.mjs";
@@ -60,12 +61,21 @@ export * from "./ReadyToStartConversationPayload.mjs";
 export * from "./ReplayConversationItemResponse.mjs";
 export * from "./ReplayToolCall.mjs";
 export * from "./ResetPayload.mjs";
+export * from "./ResponsesAction.mjs";
 export * from "./ResponsesAssistantMessage.mjs";
+export * from "./ResponsesBuiltInTool.mjs";
+export * from "./ResponsesChoseNotToRespondAction.mjs";
+export * from "./ResponsesDtmfAction.mjs";
+export * from "./ResponsesEndedConversationAction.mjs";
 export * from "./ResponsesInputItem.mjs";
+export * from "./ResponsesTool.mjs";
 export * from "./ResponsesToolCall.mjs";
 export * from "./ResponsesToolCallOutput.mjs";
 export * from "./ResponsesToolDefinition.mjs";
+export * from "./ResponsesToolName.mjs";
 export * from "./ResponsesToolReference.mjs";
+export * from "./ResponsesTransferToAgentAction.mjs";
+export * from "./ResponsesTransferToPhoneNumberAction.mjs";
 export * from "./ResponsesUserMessage.mjs";
 export * from "./SayPayload.mjs";
 export * from "./SetExternalIdPayload.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.32.23";
+export declare const SDK_VERSION = "0.32.25";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.32.23";
+export const SDK_VERSION = "0.32.25";

package/package.json

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

package/reference.md

@@ -4038,13 +4038,26 @@ you supply inline to simulate Phonic agent behavior.
 
 This endpoint is stateless, so it does not create a new conversation or
 store anything. The request carries the system prompt, a conversation so
-far as `input`, and the tools the assistant may call as
-`tool_definitions`.
+far as `input`, and the tools the assistant may call.
+
+There are two different types of tool configurations:
+
+- `tool_definitions`: defined inline. Typically if you use LiveKit, this
+  is where you can pass in your tool definitions.
+- `tools`: predefined tools configured in Phonic, referenced by name, in
+  the same shape as the STS WebSocket `config` message. Today this covers
+  built-in tools such as `choose_not_to_respond` and transfer tools stored
+  in `project`. Your context, webhook, MCP and WebSocket tools cannot be
+  referenced here yet; define those inline as `tool_definitions`.
 
 Each item in `input` is a user message, an assistant message (with
-optional `tool_calls`), or a `tool_call_output`. Every assistant tool
-call must be followed immediately by the `tool_call_output` item that
-carries its result.
+optional `tool_calls` or an `action`), or a `tool_call_output`. Every
+assistant tool call must be followed immediately by the
+`tool_call_output` item that carries its result.
+
+A tool referenced in `tools` resolves to an `action` on the generated
+response rather than a tool call - the event a live conversation would
+have emitted, without the effect actually being carried out.
 
 This is an experimental feature and must be enabled for your workspace;
 otherwise, it returns `404`. Please contact our team if you would like