phonic 0.32.11 → 0.32.13

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

@@ -0,0 +1,30 @@
+/**
+ * An S3-compatible destination that conversation artifacts are delivered to.
+ */
+export interface ExternalStoragePolicy {
+    /** The ID of the external storage policy. */
+    id: string;
+    /** The name of the external storage policy. Agents reference the policy by this name. */
+    name: string;
+    /** The S3-compatible endpoint URL that artifacts are uploaded to. */
+    endpoint_url: string;
+    /** The bucket that artifacts are uploaded to. */
+    bucket: string;
+    /** The region of the bucket. `null` when the endpoint doesn't require a region. */
+    region: string | null;
+    /** Prefix prepended to every object key. `null` when objects are written at the bucket root. */
+    key_prefix: string | null;
+    /** How bucket names are addressed in requests to the endpoint. */
+    addressing_style: ExternalStoragePolicy.AddressingStyle;
+    /** Number of agents currently referencing this external storage policy. */
+    agent_count: number;
+}
+export declare namespace ExternalStoragePolicy {
+    /** How bucket names are addressed in requests to the endpoint. */
+    const AddressingStyle: {
+        readonly Auto: "auto";
+        readonly Virtual: "virtual";
+        readonly Path: "path";
+    };
+    type AddressingStyle = (typeof AddressingStyle)[keyof typeof AddressingStyle];
+}

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

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalStoragePolicy = void 0;
+var ExternalStoragePolicy;
+(function (ExternalStoragePolicy) {
+    /** How bucket names are addressed in requests to the endpoint. */
+    ExternalStoragePolicy.AddressingStyle = {
+        Auto: "auto",
+        Virtual: "virtual",
+        Path: "path",
+    };
+})(ExternalStoragePolicy || (exports.ExternalStoragePolicy = ExternalStoragePolicy = {}));

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

@@ -15,6 +15,8 @@ export interface InlineWebSocketTool {
     wait_for_speech_before_tool_call?: boolean | undefined;
     /** When true, prevents the assistant from speaking after executing the tool. */
     forbid_speech_after_tool_call?: boolean | undefined;
+    /** When true, prevents the assistant from calling the tool right after it has spoken. */
+    forbid_tool_call_after_speech?: boolean | undefined;
     /** When true, allows the assistant to call another tool after this tool. */
     allow_tool_chaining?: boolean | undefined;
     /** For async tools, when true, the assistant waits for the response and speaks when it arrives. */

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

@@ -47,7 +47,7 @@ export interface OutboundCallConfig {
     min_words_to_interrupt?: number | undefined;
     /** Array of built-in or custom tool names to use. */
     tools?: OutboundCallConfig.Tools.Item[] | 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 speech-to-speech model to use. */
     model?: "merritt" | undefined;
@@ -113,7 +113,7 @@ export declare namespace OutboundCallConfig {
      * 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;

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

@@ -11,8 +11,17 @@ export interface Tool {
     type: Tool.Type;
     /** Mode of operation - sync waits for response, async continues without waiting. */
     execution_mode?: Tool.ExecutionMode | undefined;
-    /** Array of parameter definitions for the tool. */
-    parameters: Phonic.ToolParameter[];
+    /**
+     * The tool's parameters, returned in the same form they were defined in.
+     * Tools defined with a flat list of parameters return an array of parameter definitions (with `location` included inline for `custom_webhook` tools).
+     * Tools defined with a raw JSON Schema object return that object; for `custom_webhook` tools the parameter placement is then returned separately in `parameter_locations`.
+     */
+    parameters: Tool.Parameters;
+    /**
+     * Where each top-level parameter is sent in the webhook request, as a map from parameter name to location.
+     * Only returned for `custom_webhook` tools whose `parameters` are a raw JSON Schema object. Tools defined with a flat list of parameters carry `location` inline on each parameter instead.
+     */
+    parameter_locations?: Record<string, Tool.ParameterLocations.Value> | undefined;
     /** HTTP method for webhook tools. */
     endpoint_method?: Tool.EndpointMethod | undefined;
     /** URL for webhook tools. */
@@ -43,6 +52,8 @@ export interface Tool {
     wait_for_speech_before_tool_call?: boolean | undefined;
     /** When true, forbids the agent from speaking after executing the tool. Available for custom_context, custom_webhook and custom_websocket tools. */
     forbid_speech_after_tool_call?: boolean | undefined;
+    /** 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 | undefined;
     /** 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 | undefined;
     /** 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. */
@@ -73,6 +84,19 @@ export declare namespace Tool {
         readonly Async: "async";
     };
     type ExecutionMode = (typeof ExecutionMode)[keyof typeof ExecutionMode];
+    /**
+     * The tool's parameters, returned in the same form they were defined in.
+     * Tools defined with a flat list of parameters return an array of parameter definitions (with `location` included inline for `custom_webhook` tools).
+     * Tools defined with a raw JSON Schema object return that object; for `custom_webhook` tools the parameter placement is then returned separately in `parameter_locations`.
+     */
+    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. */
     const EndpointMethod: {
         readonly Get: "GET";

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

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

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

@@ -3,6 +3,8 @@ export interface ToolParameter {
     type: ToolParameter.Type;
     /** Required only when type is "array". The type of items in the array. */
     item_type?: ToolParameter.ItemType | undefined;
+    /** Required only when type is "enum". The fixed set of allowed string values for the parameter. Values must be unique and non-empty. */
+    enum_values?: string[] | undefined;
     /** The parameter name. */
     name: string;
     /** Description of the parameter. */
@@ -14,7 +16,7 @@ export interface ToolParameter {
      * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
      * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
      * - Not allowed for `custom_websocket`, `built_in_transfer_to_phone_number`, or `built_in_transfer_to_agent` tools.
-     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     * When switching a webhook tool's `endpoint_method` from POST to GET, its request body parameters must be re-sent with `"query_string"` locations.
      */
     location?: ToolParameter.Location | undefined;
 }
@@ -26,6 +28,7 @@ export declare namespace ToolParameter {
         readonly Number: "number";
         readonly Boolean: "boolean";
         readonly Array: "array";
+        readonly Enum: "enum";
     };
     type Type = (typeof Type)[keyof typeof Type];
     /** Required only when type is "array". The type of items in the array. */
@@ -41,7 +44,7 @@ export declare namespace ToolParameter {
      * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
      * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
      * - Not allowed for `custom_websocket`, `built_in_transfer_to_phone_number`, or `built_in_transfer_to_agent` tools.
-     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     * When switching a webhook tool's `endpoint_method` from POST to GET, its request body parameters must be re-sent with `"query_string"` locations.
      */
     const Location: {
         readonly RequestBody: "request_body";

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

@@ -11,6 +11,7 @@ var ToolParameter;
         Number: "number",
         Boolean: "boolean",
         Array: "array",
+        Enum: "enum",
     };
     /** Required only when type is "array". The type of items in the array. */
     ToolParameter.ItemType = {
@@ -24,7 +25,7 @@ var ToolParameter;
      * - For GET webhooks: defaults to `"query_string"` and `"request_body"` is not allowed.
      * - For POST webhooks: required, can be either `"request_body"` or `"query_string"`.
      * - Not allowed for `custom_websocket`, `built_in_transfer_to_phone_number`, or `built_in_transfer_to_agent` tools.
-     * When updating a tool's type or endpoint_method, all parameters must include explicit `location` values.
+     * When switching a webhook tool's `endpoint_method` from POST to GET, its request body parameters must be re-sent with `"query_string"` locations.
      */
     ToolParameter.Location = {
         RequestBody: "request_body",

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

@@ -0,0 +1,15 @@
+/**
+ * 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`.
+ * For `custom_webhook` tools, parameter placement is supplied separately in `parameter_locations` rather than inline on the schema.
+ */
+export interface ToolParametersJsonSchema {
+    type: "object";
+    /** The tool's top-level parameters, as a map from parameter name to its JSON Schema. */
+    properties: Record<string, unknown>;
+    /** The names of the required top-level parameters. Every name must be defined in `properties`. */
+    required?: string[] | undefined;
+    /** Must be `false`. Tool parameter schemas do not allow properties beyond the ones declared. */
+    additionalProperties?: false | undefined;
+}

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

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -33,6 +33,7 @@ export * from "./DataRetentionPolicy.js";
 export * from "./DtmfPayload.js";
 export * from "./Error_.js";
 export * from "./ErrorPayload.js";
+export * from "./ExternalStoragePolicy.js";
 export * from "./ExtractionField.js";
 export * from "./ExtractionSchema.js";
 export * from "./GenerateReplyPayload.js";
@@ -67,6 +68,7 @@ export * from "./ToolCallPayload.js";
 export * from "./ToolDefinition.js";
 export * from "./ToolName.js";
 export * from "./ToolParameter.js";
+export * from "./ToolParametersJsonSchema.js";
 export * from "./UnmutePayload.js";
 export * from "./UpdateSystemPromptPayload.js";
 export * from "./UpdateToolsSubsetPayload.js";

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

@@ -49,6 +49,7 @@ __exportStar(require("./DataRetentionPolicy.js"), exports);
 __exportStar(require("./DtmfPayload.js"), exports);
 __exportStar(require("./Error_.js"), exports);
 __exportStar(require("./ErrorPayload.js"), exports);
+__exportStar(require("./ExternalStoragePolicy.js"), exports);
 __exportStar(require("./ExtractionField.js"), exports);
 __exportStar(require("./ExtractionSchema.js"), exports);
 __exportStar(require("./GenerateReplyPayload.js"), exports);
@@ -83,6 +84,7 @@ __exportStar(require("./ToolCallPayload.js"), exports);
 __exportStar(require("./ToolDefinition.js"), exports);
 __exportStar(require("./ToolName.js"), exports);
 __exportStar(require("./ToolParameter.js"), exports);
+__exportStar(require("./ToolParametersJsonSchema.js"), exports);
 __exportStar(require("./UnmutePayload.js"), exports);
 __exportStar(require("./UpdateSystemPromptPayload.js"), exports);
 __exportStar(require("./UpdateToolsSubsetPayload.js"), exports);

package/dist/cjs/version.d.ts

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

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.11";
+exports.SDK_VERSION = "0.32.13";

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.11",
-        "User-Agent": "phonic/0.32.11",
+        "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/Client.d.mts

@@ -3,6 +3,7 @@ import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
 import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { ConversationItemsClient } from "./api/resources/conversationItems/client/Client.mjs";
 import { ConversationsClient } from "./api/resources/conversations/client/Client.mjs";
+import { ExternalStoragePoliciesClient } from "./api/resources/externalStoragePolicies/client/Client.mjs";
 import { ExtractionSchemasClient } from "./api/resources/extractionSchemas/client/Client.mjs";
 import { ProjectsClient } from "./api/resources/projects/client/Client.mjs";
 import { ToolsClient } from "./api/resources/tools/client/Client.mjs";
@@ -39,6 +40,7 @@ export declare class PhonicClient {
     protected _auth: AuthClient | undefined;
     protected _projects: ProjectsClient | undefined;
     protected _workspace: WorkspaceClient | undefined;
+    protected _externalStoragePolicies: ExternalStoragePoliciesClient | undefined;
     constructor(options?: PhonicClient.Options);
     get agents(): AgentsClient;
     get apiKeys(): ApiKeysClient;
@@ -51,6 +53,7 @@ export declare class PhonicClient {
     get auth(): AuthClient;
     get projects(): ProjectsClient;
     get workspace(): WorkspaceClient;
+    get externalStoragePolicies(): ExternalStoragePoliciesClient;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/esm/Client.mjs

@@ -13,6 +13,7 @@ import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
 import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { ConversationItemsClient } from "./api/resources/conversationItems/client/Client.mjs";
 import { ConversationsClient } from "./api/resources/conversations/client/Client.mjs";
+import { ExternalStoragePoliciesClient } from "./api/resources/externalStoragePolicies/client/Client.mjs";
 import { ExtractionSchemasClient } from "./api/resources/extractionSchemas/client/Client.mjs";
 import { ProjectsClient } from "./api/resources/projects/client/Client.mjs";
 import { ToolsClient } from "./api/resources/tools/client/Client.mjs";
@@ -70,6 +71,10 @@ export class PhonicClient {
         var _a;
         return ((_a = this._workspace) !== null && _a !== void 0 ? _a : (this._workspace = new WorkspaceClient(this._options)));
     }
+    get externalStoragePolicies() {
+        var _a;
+        return ((_a = this._externalStoragePolicies) !== null && _a !== void 0 ? _a : (this._externalStoragePolicies = new ExternalStoragePoliciesClient(this._options)));
+    }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

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

@@ -242,6 +242,9 @@ export declare class AgentsClient {
      *
      * @example
      *     await client.agents.addCustomPhoneNumber("nameOrId", {
+     *         "X-Sip-Address": "X-Sip-Address",
+     *         "X-Sip-Auth-Username": "X-Sip-Auth-Username",
+     *         "X-Sip-Auth-Password": "X-Sip-Auth-Password",
      *         project: "main",
      *         phone_number: "+15551234567",
      *         configuration_endpoint: {

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

@@ -529,6 +529,9 @@ export class AgentsClient {
      *
      * @example
      *     await client.agents.addCustomPhoneNumber("nameOrId", {
+     *         "X-Sip-Address": "X-Sip-Address",
+     *         "X-Sip-Auth-Username": "X-Sip-Auth-Username",
+     *         "X-Sip-Auth-Password": "X-Sip-Auth-Password",
      *         project: "main",
      *         phone_number: "+15551234567",
      *         configuration_endpoint: {

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

@@ -1,6 +1,9 @@
 /**
  * @example
  *     {
+ *         "X-Sip-Address": "X-Sip-Address",
+ *         "X-Sip-Auth-Username": "X-Sip-Auth-Username",
+ *         "X-Sip-Auth-Password": "X-Sip-Auth-Password",
  *         project: "main",
  *         phone_number: "+15551234567",
  *         configuration_endpoint: {
@@ -15,12 +18,12 @@
 export interface AgentsAddCustomPhoneNumberRequest {
     /** The name of the project containing the agent. Only used when `nameOrId` is a name. */
     project?: string;
-    /** SIP address of the user's SIP trunk. Optional, but if provided, all three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. When these headers are provided, call transfers from the agent will use the provided SIP details. */
-    "X-Sip-Address"?: string;
-    /** SIP auth username. Optional, but if provided, all three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. When these headers are provided, call transfers from the agent will use the provided SIP details. */
-    "X-Sip-Auth-Username"?: string;
-    /** SIP auth password. Optional, but if provided, all three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. When these headers are provided, call transfers from the agent will use the provided SIP details. */
-    "X-Sip-Auth-Password"?: string;
+    /** SIP address of the user's SIP trunk. Required. All three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. They are used for outbound calls and call transfers from the agent. */
+    "X-Sip-Address": string;
+    /** SIP auth username. Required. All three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. They are used for outbound calls and call transfers from the agent. */
+    "X-Sip-Auth-Username": string;
+    /** SIP auth password. Required. All three SIP headers (X-Sip-Address, X-Sip-Auth-Username, X-Sip-Auth-Password) must be provided. They are used for outbound calls and call transfers from the agent. */
+    "X-Sip-Auth-Password": string;
     /** The E.164 formatted phone number to add (e.g., "+15551234567"). */
     phone_number: string;
     /** When not `null`, the agent will call this endpoint to get configuration options for calls on this phone number. */
@@ -31,7 +34,7 @@ export declare namespace AgentsAddCustomPhoneNumberRequest {
      * When not `null`, the agent will call this endpoint to get configuration options for calls on this phone number.
      */
     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;

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

@@ -133,10 +133,12 @@ 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[];
     /** Names of observability integrations to enable for the agent. Each must be one of the supported providers. */
     observability_integrations?: "braintrust"[];
+    /** 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;
 }

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

@@ -25,7 +25,7 @@ export declare namespace AgentsUpdatePhoneNumberRequest {
      * When not `null`, the agent will call this endpoint to get configuration options for calls on this phone number.
      */
     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;

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

@@ -139,12 +139,14 @@ 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[];
     /** Names of observability integrations to enable for the agent. Each must be one of the supported providers. */
     observability_integrations?: "braintrust"[];
+    /** Name of an external storage policy in the same project that conversation artifacts are delivered to. Set to `null` to stop delivering artifacts. Requires zero data retention and cannot be combined with `enable_redaction`. */
+    external_storage_policy?: string | null;
 }
 export declare namespace UpdateAgentRequest {
     const PhoneNumber: {
@@ -205,7 +207,7 @@ export declare namespace UpdateAgentRequest {
      * 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;

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

@@ -0,0 +1,117 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Phonic from "../../../index.mjs";
+export declare namespace ExternalStoragePoliciesClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class ExternalStoragePoliciesClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ExternalStoragePoliciesClient.Options>;
+    constructor(options?: ExternalStoragePoliciesClient.Options);
+    /**
+     * Returns all external storage policies in a project.
+     *
+     * @param {Phonic.ExternalStoragePoliciesListRequest} request
+     * @param {ExternalStoragePoliciesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Phonic.NotFoundError}
+     * @throws {@link Phonic.InternalServerError}
+     *
+     * @example
+     *     await client.externalStoragePolicies.list({
+     *         project: "main"
+     *     })
+     */
+    list(request?: Phonic.ExternalStoragePoliciesListRequest, requestOptions?: ExternalStoragePoliciesClient.RequestOptions): core.HttpResponsePromise<Phonic.ExternalStoragePoliciesListResponse>;
+    private __list;
+    /**
+     * Creates a new external storage policy in a project. Agents referencing the policy deliver their conversation artifacts to the configured S3-compatible bucket.
+     *
+     * @param {Phonic.CreateExternalStoragePolicyRequest} request
+     * @param {ExternalStoragePoliciesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Phonic.BadRequestError}
+     * @throws {@link Phonic.UnauthorizedError}
+     * @throws {@link Phonic.NotFoundError}
+     * @throws {@link Phonic.ConflictError}
+     * @throws {@link Phonic.InternalServerError}
+     *
+     * @example
+     *     await client.externalStoragePolicies.create({
+     *         project: "main",
+     *         name: "conversation_archive",
+     *         endpoint_url: "https://storage.example.com",
+     *         bucket: "conversation-audio",
+     *         region: "us-east-1",
+     *         key_prefix: "phonic/conversations",
+     *         addressing_style: "auto",
+     *         access_key_id: "AKIAIOSFODNN7EXAMPLE",
+     *         secret_access_key: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
+     *     })
+     */
+    create(request: Phonic.CreateExternalStoragePolicyRequest, requestOptions?: ExternalStoragePoliciesClient.RequestOptions): core.HttpResponsePromise<Phonic.ExternalStoragePoliciesCreateResponse>;
+    private __create;
+    /**
+     * Returns an external storage policy by name or ID.
+     *
+     * @param {string} nameOrId - The name or the ID of the external storage policy to get.
+     * @param {Phonic.ExternalStoragePoliciesGetRequest} request
+     * @param {ExternalStoragePoliciesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Phonic.ForbiddenError}
+     * @throws {@link Phonic.NotFoundError}
+     * @throws {@link Phonic.InternalServerError}
+     *
+     * @example
+     *     await client.externalStoragePolicies.get("nameOrId", {
+     *         project: "main"
+     *     })
+     */
+    get(nameOrId: string, request?: Phonic.ExternalStoragePoliciesGetRequest, requestOptions?: ExternalStoragePoliciesClient.RequestOptions): core.HttpResponsePromise<Phonic.ExternalStoragePoliciesGetResponse>;
+    private __get;
+    /**
+     * Deletes an external storage policy by name or ID. The policy must not be referenced by any agent.
+     *
+     * @param {string} nameOrId - The name or the ID of the external storage policy to delete.
+     * @param {Phonic.ExternalStoragePoliciesDeleteRequest} request
+     * @param {ExternalStoragePoliciesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Phonic.UnauthorizedError}
+     * @throws {@link Phonic.ForbiddenError}
+     * @throws {@link Phonic.NotFoundError}
+     * @throws {@link Phonic.ConflictError}
+     * @throws {@link Phonic.InternalServerError}
+     *
+     * @example
+     *     await client.externalStoragePolicies.delete("nameOrId", {
+     *         project: "main"
+     *     })
+     */
+    delete(nameOrId: string, request?: Phonic.ExternalStoragePoliciesDeleteRequest, requestOptions?: ExternalStoragePoliciesClient.RequestOptions): core.HttpResponsePromise<Phonic.ExternalStoragePoliciesDeleteResponse>;
+    private __delete;
+    /**
+     * Updates an external storage policy by name or ID. Credentials can only be rotated by providing both `access_key_id` and `secret_access_key`.
+     *
+     * @param {string} nameOrId - The name or the ID of the external storage policy to update.
+     * @param {Phonic.UpdateExternalStoragePolicyRequest} request
+     * @param {ExternalStoragePoliciesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Phonic.BadRequestError}
+     * @throws {@link Phonic.UnauthorizedError}
+     * @throws {@link Phonic.ForbiddenError}
+     * @throws {@link Phonic.NotFoundError}
+     * @throws {@link Phonic.ConflictError}
+     * @throws {@link Phonic.InternalServerError}
+     *
+     * @example
+     *     await client.externalStoragePolicies.update("nameOrId", {
+     *         project: "main",
+     *         bucket: "conversation-audio-archive",
+     *         key_prefix: "phonic/archive"
+     *     })
+     */
+    update(nameOrId: string, request?: Phonic.UpdateExternalStoragePolicyRequest, requestOptions?: ExternalStoragePoliciesClient.RequestOptions): core.HttpResponsePromise<Phonic.ExternalStoragePoliciesUpdateResponse>;
+    private __update;
+}