phonic 0.32.12 → 0.32.14

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

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.12";
+exports.SDK_VERSION = "0.32.14";

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.12",
-        "User-Agent": "phonic/0.32.12",
+        "X-Fern-SDK-Version": "0.32.13",
+        "User-Agent": "phonic/0.32.13",
         "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

@@ -133,7 +133,7 @@ export interface AgentsCreateRequest {
     vad_min_silence_duration_ms?: number;
     /** Voice activity detection threshold. */
     vad_threshold?: number;
-    /** When `true`, PII and PHI are redacted from text transcripts (e.g. replaced with tags like `[PHONE NUMBER]`) and bleeped from audio recordings after the conversation ends. */
+    /** When `true`, PII and PHI are redacted from text transcripts (e.g. replaced with tags like `[PHONE]`) and bleeped from audio recordings after the conversation ends. */
     enable_redaction?: boolean;
     /** Array of MCP server IDs to make available to the agent. */
     mcp_server_ids?: string[];

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

@@ -139,7 +139,7 @@ export interface UpdateAgentRequest {
     vad_min_silence_duration_ms?: number;
     /** Voice activity detection threshold. */
     vad_threshold?: number;
-    /** When `true`, PII and PHI are redacted from text transcripts (e.g. replaced with tags like `[PHONE NUMBER]`) and bleeped from audio recordings after the conversation ends. */
+    /** When `true`, PII and PHI are redacted from text transcripts (e.g. replaced with tags like `[PHONE]`) and bleeped from audio recordings after the conversation ends. */
     enable_redaction?: boolean;
     /** Array of MCP server IDs to make available to the agent. */
     mcp_server_ids?: string[];

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

@@ -90,6 +90,71 @@ export declare class ToolsClient {
      * @example
      *     await client.tools.create({
      *         project: "main",
+     *         name: "create_order",
+     *         description: "Creates an order in the fulfillment system",
+     *         type: "custom_webhook",
+     *         execution_mode: "sync",
+     *         parameters: {
+     *             type: "object",
+     *             properties: {
+     *                 "customer": {
+     *                     "type": "object",
+     *                     "description": "The customer placing the order",
+     *                     "properties": {
+     *                         "name": {
+     *                             "type": "string",
+     *                             "description": "The customer's full name"
+     *                         },
+     *                         "tier": {
+     *                             "type": "string",
+     *                             "enum": [
+     *                                 "free",
+     *                                 "pro"
+     *                             ],
+     *                             "description": "The customer's subscription tier"
+     *                         }
+     *                     },
+     *                     "required": [
+     *                         "name"
+     *                     ]
+     *                 },
+     *                 "items": {
+     *                     "type": "array",
+     *                     "description": "The items being ordered",
+     *                     "items": {
+     *                         "type": "object",
+     *                         "properties": {
+     *                             "sku": {
+     *                                 "type": "string",
+     *                                 "description": "The item's SKU"
+     *                             },
+     *                             "quantity": {
+     *                                 "type": "integer",
+     *                                 "description": "How many of the item to order"
+     *                             }
+     *                         },
+     *                         "required": [
+     *                             "sku",
+     *                             "quantity"
+     *                         ]
+     *                     }
+     *                 }
+     *             },
+     *             required: ["customer", "items"],
+     *             additionalProperties: false
+     *         },
+     *         parameter_locations: {
+     *             "customer": "request_body",
+     *             "items": "request_body"
+     *         },
+     *         endpoint_method: "POST",
+     *         endpoint_url: "https://api.example.com/orders",
+     *         endpoint_timeout_ms: 5000
+     *     })
+     *
+     * @example
+     *     await client.tools.create({
+     *         project: "main",
      *         name: "check_inventory",
      *         description: "Checks product inventory levels",
      *         type: "custom_websocket",

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

@@ -150,6 +150,71 @@ export class ToolsClient {
      * @example
      *     await client.tools.create({
      *         project: "main",
+     *         name: "create_order",
+     *         description: "Creates an order in the fulfillment system",
+     *         type: "custom_webhook",
+     *         execution_mode: "sync",
+     *         parameters: {
+     *             type: "object",
+     *             properties: {
+     *                 "customer": {
+     *                     "type": "object",
+     *                     "description": "The customer placing the order",
+     *                     "properties": {
+     *                         "name": {
+     *                             "type": "string",
+     *                             "description": "The customer's full name"
+     *                         },
+     *                         "tier": {
+     *                             "type": "string",
+     *                             "enum": [
+     *                                 "free",
+     *                                 "pro"
+     *                             ],
+     *                             "description": "The customer's subscription tier"
+     *                         }
+     *                     },
+     *                     "required": [
+     *                         "name"
+     *                     ]
+     *                 },
+     *                 "items": {
+     *                     "type": "array",
+     *                     "description": "The items being ordered",
+     *                     "items": {
+     *                         "type": "object",
+     *                         "properties": {
+     *                             "sku": {
+     *                                 "type": "string",
+     *                                 "description": "The item's SKU"
+     *                             },
+     *                             "quantity": {
+     *                                 "type": "integer",
+     *                                 "description": "How many of the item to order"
+     *                             }
+     *                         },
+     *                         "required": [
+     *                             "sku",
+     *                             "quantity"
+     *                         ]
+     *                     }
+     *                 }
+     *             },
+     *             required: ["customer", "items"],
+     *             additionalProperties: false
+     *         },
+     *         parameter_locations: {
+     *             "customer": "request_body",
+     *             "items": "request_body"
+     *         },
+     *         endpoint_method: "POST",
+     *         endpoint_url: "https://api.example.com/orders",
+     *         endpoint_timeout_ms: 5000
+     *     })
+     *
+     * @example
+     *     await client.tools.create({
+     *         project: "main",
      *         name: "check_inventory",
      *         description: "Checks product inventory levels",
      *         type: "custom_websocket",

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

@@ -55,6 +55,71 @@ import type * as Phonic from "../../../../index.mjs";
  * @example
  *     {
  *         project: "main",
+ *         name: "create_order",
+ *         description: "Creates an order in the fulfillment system",
+ *         type: "custom_webhook",
+ *         execution_mode: "sync",
+ *         parameters: {
+ *             type: "object",
+ *             properties: {
+ *                 "customer": {
+ *                     "type": "object",
+ *                     "description": "The customer placing the order",
+ *                     "properties": {
+ *                         "name": {
+ *                             "type": "string",
+ *                             "description": "The customer's full name"
+ *                         },
+ *                         "tier": {
+ *                             "type": "string",
+ *                             "enum": [
+ *                                 "free",
+ *                                 "pro"
+ *                             ],
+ *                             "description": "The customer's subscription tier"
+ *                         }
+ *                     },
+ *                     "required": [
+ *                         "name"
+ *                     ]
+ *                 },
+ *                 "items": {
+ *                     "type": "array",
+ *                     "description": "The items being ordered",
+ *                     "items": {
+ *                         "type": "object",
+ *                         "properties": {
+ *                             "sku": {
+ *                                 "type": "string",
+ *                                 "description": "The item's SKU"
+ *                             },
+ *                             "quantity": {
+ *                                 "type": "integer",
+ *                                 "description": "How many of the item to order"
+ *                             }
+ *                         },
+ *                         "required": [
+ *                             "sku",
+ *                             "quantity"
+ *                         ]
+ *                     }
+ *                 }
+ *             },
+ *             required: ["customer", "items"],
+ *             additionalProperties: false
+ *         },
+ *         parameter_locations: {
+ *             "customer": "request_body",
+ *             "items": "request_body"
+ *         },
+ *         endpoint_method: "POST",
+ *         endpoint_url: "https://api.example.com/orders",
+ *         endpoint_timeout_ms: 5000
+ *     }
+ *
+ * @example
+ *     {
+ *         project: "main",
  *         name: "check_inventory",
  *         description: "Checks product inventory levels",
  *         type: "custom_websocket",
@@ -111,12 +176,21 @@ export interface CreateToolRequest {
     /** Mode of operation. */
     execution_mode: CreateToolRequest.ExecutionMode;
     /**
-     * Array of parameter definitions.
-     * For `custom_webhook` tools with POST method, each parameter must include a `location` field.
-     * For `custom_webhook` tools with GET method, `location` defaults to `"query_string"` if not specified.
-     * For `custom_websocket`, `built_in_transfer_to_phone_number`, and `built_in_transfer_to_agent` tools, `location` must not be specified.
+     * The tool's parameters, either as a flat array of parameter definitions or as a raw JSON Schema object (use the object form for nested parameters).
+     * When sending an array:
+     * - For `custom_webhook` tools with POST method, each parameter must include a `location` field.
+     * - For `custom_webhook` tools with GET method, `location` defaults to `"query_string"` if not specified.
+     * - For `custom_websocket`, `built_in_transfer_to_phone_number`, and `built_in_transfer_to_agent` tools, `location` must not be specified.
+     * - `parameter_locations` must not be sent, since placement is carried inline on each parameter.
+     * When sending a JSON Schema object, `custom_webhook` tools supply parameter placement in `parameter_locations` instead.
+     * Tools that cannot have parameters (`custom_context` and the `built_in_*` types) must send an empty array or omit the field.
      */
-    parameters?: Phonic.ToolParameter[];
+    parameters?: CreateToolRequest.Parameters;
+    /**
+     * Where each top-level parameter is sent in the webhook request, as a map from parameter name to location. Only for `custom_webhook` tools whose `parameters` are a raw JSON Schema object.
+     * Every key must name a top-level parameter. For POST webhooks, every parameter needs an entry. For GET webhooks, entries default to `"query_string"` and `"request_body"` is not allowed.
+     */
+    parameter_locations?: Record<string, CreateToolRequest.ParameterLocations.Value>;
     /** Required for webhook tools. HTTP method for the webhook endpoint. */
     endpoint_method?: CreateToolRequest.EndpointMethod;
     /** Required for webhook tools. Must be a publicly routable HTTPS URL without embedded credentials. */
@@ -147,6 +221,8 @@ export interface CreateToolRequest {
     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. */
     forbid_speech_after_tool_call?: boolean;
+    /** When true, forbids the agent from calling the tool right after it has spoken. Available for custom_webhook and custom_websocket tools. */
+    forbid_tool_call_after_speech?: boolean;
     /** When true, allows the agent to chain and execute other tools after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
     allow_tool_chaining?: boolean;
     /** The agent doesn't typically wait for the response of async custom_websocket 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_websocket tools. */
@@ -173,6 +249,24 @@ export declare namespace CreateToolRequest {
         readonly Async: "async";
     };
     type ExecutionMode = (typeof ExecutionMode)[keyof typeof ExecutionMode];
+    /**
+     * The tool's parameters, either as a flat array of parameter definitions or as a raw JSON Schema object (use the object form for nested parameters).
+     * When sending an array:
+     * - For `custom_webhook` tools with POST method, each parameter must include a `location` field.
+     * - For `custom_webhook` tools with GET method, `location` defaults to `"query_string"` if not specified.
+     * - For `custom_websocket`, `built_in_transfer_to_phone_number`, and `built_in_transfer_to_agent` tools, `location` must not be specified.
+     * - `parameter_locations` must not be sent, since placement is carried inline on each parameter.
+     * When sending a JSON Schema object, `custom_webhook` tools supply parameter placement in `parameter_locations` instead.
+     * Tools that cannot have parameters (`custom_context` and the `built_in_*` types) must send an empty array or omit the field.
+     */
+    type Parameters = Phonic.ToolParameter[] | Phonic.ToolParametersJsonSchema;
+    namespace ParameterLocations {
+        const Value: {
+            readonly RequestBody: "request_body";
+            readonly QueryString: "query_string";
+        };
+        type Value = (typeof Value)[keyof typeof Value];
+    }
     /** Required for webhook tools. HTTP method for the webhook endpoint. */
     const EndpointMethod: {
         readonly Get: "GET";

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

@@ -17,6 +17,13 @@ export var CreateToolRequest;
         Sync: "sync",
         Async: "async",
     };
+    let ParameterLocations;
+    (function (ParameterLocations) {
+        ParameterLocations.Value = {
+            RequestBody: "request_body",
+            QueryString: "query_string",
+        };
+    })(ParameterLocations = CreateToolRequest.ParameterLocations || (CreateToolRequest.ParameterLocations = {}));
     /** Required for webhook tools. HTTP method for the webhook endpoint. */
     CreateToolRequest.EndpointMethod = {
         Get: "GET",