phonic 0.32.11 → 0.32.13

package/dist/cjs/api/resources/externalStoragePolicies/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalStoragePoliciesClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "ExternalStoragePoliciesClient", { enumerable: true, get: function () { return Client_js_1.ExternalStoragePoliciesClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/externalStoragePolicies/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/cjs/api/resources/externalStoragePolicies/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesCreateResponse.d.ts

@@ -0,0 +1,6 @@
+export interface ExternalStoragePoliciesCreateResponse {
+    /** The ID of the created external storage policy. */
+    id: string;
+    /** The name of the created external storage policy. */
+    name: string;
+}

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesCreateResponse.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/resources/externalStoragePolicies/types/ExternalStoragePoliciesDeleteResponse.d.ts

@@ -0,0 +1,4 @@
+export interface ExternalStoragePoliciesDeleteResponse {
+    /** Whether the external storage policy was deleted successfully. */
+    success: boolean;
+}

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesDeleteResponse.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/resources/externalStoragePolicies/types/ExternalStoragePoliciesGetResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as Phonic from "../../../index.js";
+export interface ExternalStoragePoliciesGetResponse {
+    external_storage_policy: Phonic.ExternalStoragePolicy;
+}

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesGetResponse.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/resources/externalStoragePolicies/types/ExternalStoragePoliciesListResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as Phonic from "../../../index.js";
+export interface ExternalStoragePoliciesListResponse {
+    external_storage_policies: Phonic.ExternalStoragePolicy[];
+}

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesListResponse.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/resources/externalStoragePolicies/types/ExternalStoragePoliciesUpdateResponse.d.ts

@@ -0,0 +1,4 @@
+export interface ExternalStoragePoliciesUpdateResponse {
+    /** Whether the external storage policy was updated successfully. */
+    success: boolean;
+}

package/dist/cjs/api/resources/externalStoragePolicies/types/ExternalStoragePoliciesUpdateResponse.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/resources/externalStoragePolicies/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./ExternalStoragePoliciesCreateResponse.js";
+export * from "./ExternalStoragePoliciesDeleteResponse.js";
+export * from "./ExternalStoragePoliciesGetResponse.js";
+export * from "./ExternalStoragePoliciesListResponse.js";
+export * from "./ExternalStoragePoliciesUpdateResponse.js";

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

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ExternalStoragePoliciesCreateResponse.js"), exports);
+__exportStar(require("./ExternalStoragePoliciesDeleteResponse.js"), exports);
+__exportStar(require("./ExternalStoragePoliciesGetResponse.js"), exports);
+__exportStar(require("./ExternalStoragePoliciesListResponse.js"), exports);
+__exportStar(require("./ExternalStoragePoliciesUpdateResponse.js"), exports);

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

@@ -12,6 +12,9 @@ export * as conversationItems from "./conversationItems/index.js";
 export * from "./conversations/client/requests/index.js";
 export * as conversations from "./conversations/index.js";
 export * from "./conversations/types/index.js";
+export * from "./externalStoragePolicies/client/requests/index.js";
+export * as externalStoragePolicies from "./externalStoragePolicies/index.js";
+export * from "./externalStoragePolicies/types/index.js";
 export * from "./extractionSchemas/client/requests/index.js";
 export * as extractionSchemas from "./extractionSchemas/index.js";
 export * from "./extractionSchemas/types/index.js";

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

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.workspace = exports.voices = exports.tts = exports.tools = exports.projects = exports.extractionSchemas = exports.conversations = exports.conversationItems = exports.auth = exports.apiKeys = exports.agents = void 0;
+exports.workspace = exports.voices = exports.tts = exports.tools = exports.projects = exports.extractionSchemas = exports.externalStoragePolicies = exports.conversations = exports.conversationItems = exports.auth = exports.apiKeys = exports.agents = void 0;
 __exportStar(require("./agents/client/requests/index.js"), exports);
 exports.agents = __importStar(require("./agents/index.js"));
 __exportStar(require("./agents/types/index.js"), exports);
@@ -51,6 +51,9 @@ exports.conversationItems = __importStar(require("./conversationItems/index.js")
 __exportStar(require("./conversations/client/requests/index.js"), exports);
 exports.conversations = __importStar(require("./conversations/index.js"));
 __exportStar(require("./conversations/types/index.js"), exports);
+__exportStar(require("./externalStoragePolicies/client/requests/index.js"), exports);
+exports.externalStoragePolicies = __importStar(require("./externalStoragePolicies/index.js"));
+__exportStar(require("./externalStoragePolicies/types/index.js"), exports);
 __exportStar(require("./extractionSchemas/client/requests/index.js"), exports);
 exports.extractionSchemas = __importStar(require("./extractionSchemas/index.js"));
 __exportStar(require("./extractionSchemas/types/index.js"), exports);

package/dist/cjs/api/resources/tools/client/Client.d.ts

@@ -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/cjs/api/resources/tools/client/Client.js

@@ -186,6 +186,71 @@ 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/cjs/api/resources/tools/client/requests/CreateToolRequest.d.ts

@@ -55,6 +55,71 @@ import type * as Phonic from "../../../../index.js";
  * @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,15 +176,24 @@ 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. */
+    /** Required for webhook tools. Must be a publicly routable HTTPS URL without embedded credentials. */
     endpoint_url?: string;
     /** Optional headers for webhook tools. */
     endpoint_headers?: Record<string, string>;
@@ -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/cjs/api/resources/tools/client/requests/CreateToolRequest.js

@@ -20,6 +20,13 @@ 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",

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

@@ -22,14 +22,20 @@ export interface UpdateToolRequest {
     /** The static context returned to the agent. Only applicable to custom_context tools. */
     context?: string;
     /**
-     * Array of parameter definitions.
-     * When updating `endpoint_method`, all parameters must include explicit `location` values.
-     * For `custom_webhook` tools: `location` is required for POST, defaults to `"query_string"` for GET.
+     * 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). Replaces the tool's existing parameters, including the form they are stored in.
+     * For `custom_webhook` tools: when sending an array, `location` is required for POST and defaults to `"query_string"` for GET, and `parameter_locations` must not be sent; when sending a JSON Schema object, placement is supplied in `parameter_locations`.
      * For `custom_websocket`, `built_in_transfer_to_phone_number`, and `built_in_transfer_to_agent` tools: `location` must not be specified.
      */
-    parameters?: Phonic.ToolParameter[];
-    /** HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values. */
+    parameters?: UpdateToolRequest.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.
+     * Can be sent on its own to move existing parameters without resending `parameters`; entries are merged over the tool's current placement, so parameters left out keep where they were.
+     * Every key must name a top-level parameter. For POST webhooks, every parameter needs a placement. For GET webhooks, unplaced parameters default to `"query_string"` and `"request_body"` is not allowed.
+     */
+    parameter_locations?: Record<string, UpdateToolRequest.ParameterLocations.Value>;
+    /** HTTP method for webhook tools. When switching from POST to GET, a tool with request body parameters must also send new `parameters` (or `parameter_locations`) placing them in the query string. */
     endpoint_method?: UpdateToolRequest.EndpointMethod;
+    /** URL for webhook tools. Must be a publicly routable HTTPS URL without embedded credentials. */
     endpoint_url?: string;
     /** Headers for webhook tools. Set to null to clear existing headers. */
     endpoint_headers?: Record<string, string | null> | null;
@@ -55,6 +61,8 @@ export interface UpdateToolRequest {
     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. */
@@ -67,7 +75,20 @@ export declare namespace UpdateToolRequest {
         readonly Async: "async";
     };
     type ExecutionMode = (typeof ExecutionMode)[keyof typeof ExecutionMode];
-    /** HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values. */
+    /**
+     * 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). Replaces the tool's existing parameters, including the form they are stored in.
+     * For `custom_webhook` tools: when sending an array, `location` is required for POST and defaults to `"query_string"` for GET, and `parameter_locations` must not be sent; when sending a JSON Schema object, placement is supplied in `parameter_locations`.
+     * For `custom_websocket`, `built_in_transfer_to_phone_number`, and `built_in_transfer_to_agent` tools: `location` must not be specified.
+     */
+    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];
+    }
+    /** HTTP method for webhook tools. When switching from POST to GET, a tool with request body parameters must also send new `parameters` (or `parameter_locations`) placing them in the query string. */
     const EndpointMethod: {
         readonly Get: "GET";
         readonly Post: "POST";

package/dist/cjs/api/resources/tools/client/requests/UpdateToolRequest.js

@@ -9,7 +9,14 @@ var UpdateToolRequest;
         Sync: "sync",
         Async: "async",
     };
-    /** HTTP method for webhook tools. When changing this value, all parameters must include explicit `location` values. */
+    let ParameterLocations;
+    (function (ParameterLocations) {
+        ParameterLocations.Value = {
+            RequestBody: "request_body",
+            QueryString: "query_string",
+        };
+    })(ParameterLocations = UpdateToolRequest.ParameterLocations || (UpdateToolRequest.ParameterLocations = {}));
+    /** HTTP method for webhook tools. When switching from POST to GET, a tool with request body parameters must also send new `parameters` (or `parameter_locations`) placing them in the query string. */
     UpdateToolRequest.EndpointMethod = {
         Get: "GET",
         Post: "POST",

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

@@ -64,6 +64,8 @@ export interface Agent {
     boosted_keywords: string[];
     /** Names of observability integrations enabled for the agent. Each must be one of the supported providers. */
     observability_integrations?: "braintrust"[] | undefined;
+    /** Name of the external storage policy that conversation artifacts are delivered to. `null` when the agent doesn't deliver artifacts to external storage. */
+    external_storage_policy?: (string | null) | undefined;
     /** Array of `{ word, pronunciation }` entries. Words must be unique. */
     pronunciation_dictionary: Agent.PronunciationDictionary.Item[];
     /** Minimum number of words required to interrupt the assistant. */
@@ -82,7 +84,7 @@ export interface Agent {
     vad_min_silence_duration_ms?: number | undefined;
     /** Voice activity detection threshold. */
     vad_threshold?: number | undefined;
-    /** 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 | undefined;
     /** The URL-friendly slug of the agent. */
     slug?: string | undefined;

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

@@ -69,12 +69,14 @@ export interface ConfigOptions {
     tools?: Phonic.ToolDefinition[] | undefined;
     /** Template variables for system prompt and welcome message */
     template_variables?: Record<string, string> | undefined;
-    /** 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 | undefined;
     /** Names of pre-configured MCP servers to make available to the assistant. Names must be unique. */
     mcp_servers?: string[] | undefined;
     /** Names of observability integrations to enable for the conversation. Each must be one of the supported providers. */
     observability_integrations?: "braintrust"[] | undefined;
+    /** Name of an external storage policy in the same project that conversation artifacts are delivered to. Requires `data_retention_policy.zero_data_retention` to be `true` and cannot be combined with `enable_redaction`. Set to `null` to disable external delivery. */
+    external_storage_policy?: (string | null) | undefined;
     /** Tasks the assistant should accomplish during the conversation. */
     tasks?: ConfigOptions.Tasks.Item[] | undefined;
     /** Pool of phone numbers to use as the caller ID for outbound calls. */
@@ -161,7 +163,7 @@ export declare namespace ConfigOptions {
      * When not `null`, the agent will call this endpoint to get configuration options for the conversation.
      */
     interface ConfigurationEndpoint {
-        /** URL to call. */
+        /** URL to call. Must be a publicly routable HTTPS URL without embedded credentials. */
         url: string;
         /** Object of key-value pairs sent as headers when calling the endpoint. */
         headers?: Record<string, string> | undefined;

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

@@ -86,12 +86,14 @@ export interface CreateAgentRequest {
     vad_min_silence_duration_ms?: number | undefined;
     /** Voice activity detection threshold. */
     vad_threshold?: number | undefined;
-    /** 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 | undefined;
     /** Array of MCP server IDs to make available to the agent. */
     mcp_server_ids?: string[] | undefined;
     /** Names of observability integrations to enable for the agent. Each must be one of the supported providers. */
     observability_integrations?: "braintrust"[] | undefined;
+    /** Name of an external storage policy in the same project that conversation artifacts are delivered to. Requires zero data retention and cannot be combined with `enable_redaction`. */
+    external_storage_policy?: (string | null) | undefined;
 }
 export declare namespace CreateAgentRequest {
     const PhoneNumber: {
@@ -152,7 +154,7 @@ export declare namespace CreateAgentRequest {
      * When not `null`, at the beginning of the conversation the agent will make a POST request to this endpoint to get configuration options.
      */
     interface ConfigurationEndpoint {
-        /** URL to call */
+        /** URL to call. Must be a publicly routable HTTPS URL without embedded credentials. */
         url: string;
         /** Object of key-value pairs. */
         headers?: Record<string, string> | undefined;