phonic 0.32.10 → 0.32.12

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

@@ -83,6 +83,8 @@ export interface AgentsCreateRequest {
     template_variables?: Record<string, Phonic.CreateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: Phonic.CreateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */
@@ -137,4 +139,6 @@ export interface AgentsCreateRequest {
     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

@@ -83,6 +83,8 @@ export interface UpdateAgentRequest {
     template_variables?: Record<string, UpdateAgentRequest.TemplateVariables.Value>;
     /** Array of built-in or custom tool names to use. */
     tools?: UpdateAgentRequest.Tools.Item[];
+    /** Configuration overrides for built-in tools, keyed by built-in tool ID. Built-in tools not listed here use their default configuration. */
+    built_in_tool_configs?: Phonic.BuiltInToolConfigs;
     /** Array of task objects with `name` and `description` fields. */
     tasks?: Phonic.Task[];
     /** Whether to have the no-input poke text be generated by AI. */
@@ -143,6 +145,8 @@ export interface UpdateAgentRequest {
     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: {
@@ -203,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;
+}