agentphone 1.0.5 → 1.0.7

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentphone",
-        "X-Fern-SDK-Version": "1.0.5",
-        "User-Agent": "agentphone/1.0.5",
+        "X-Fern-SDK-Version": "1.0.7",
+        "User-Agent": "agentphone/1.0.7",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -11,7 +11,7 @@ export declare class AgentsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AgentsClient.Options>;
     constructor(options?: AgentsClient.Options);
     /**
-     * Return available voices from the call provider (Retell).
+     * Return available voices for voice calls.
      *
      * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/agents/client/Client.js

@@ -67,7 +67,7 @@ class AgentsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Return available voices from the call provider (Retell).
+     * Return available voices for voice calls.
      *
      * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/agents/client/requests/CreateAgentRequest.d.ts

@@ -16,6 +16,12 @@ export interface CreateAgentRequest {
     voicemailMessage?: string | null;
     /** Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency). */
     sttMode?: CreateAgentRequest.SttMode;
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    ambientSound?: CreateAgentRequest.AmbientSound;
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    denoisingMode?: CreateAgentRequest.DenoisingMode;
+    /** Hang up the call after this many milliseconds of caller silence. Default 600000 (10 min). Raise for IVR/hold-music workflows; lower to fail fast on dead lines. Range 10000 (10s) to 3600000 (1 hour). */
+    maxSilenceMs?: number | null;
 }
 export declare namespace CreateAgentRequest {
     const VoiceMode: {
@@ -35,4 +41,18 @@ export declare namespace CreateAgentRequest {
         readonly Accurate: "accurate";
     };
     type SttMode = (typeof SttMode)[keyof typeof SttMode];
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    const AmbientSound: {
+        readonly None: "none";
+        readonly Office: "office";
+        readonly CoffeeShop: "coffee-shop";
+        readonly Outdoor: "outdoor";
+    };
+    type AmbientSound = (typeof AmbientSound)[keyof typeof AmbientSound];
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    const DenoisingMode: {
+        readonly NoiseCancellation: "noise-cancellation";
+        readonly NoiseAndBackgroundSpeechCancellation: "noise-and-background-speech-cancellation";
+    };
+    type DenoisingMode = (typeof DenoisingMode)[keyof typeof DenoisingMode];
 }

package/dist/cjs/api/resources/agents/client/requests/CreateAgentRequest.js

@@ -18,4 +18,16 @@ var CreateAgentRequest;
         Fast: "fast",
         Accurate: "accurate",
     };
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    CreateAgentRequest.AmbientSound = {
+        None: "none",
+        Office: "office",
+        CoffeeShop: "coffee-shop",
+        Outdoor: "outdoor",
+    };
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    CreateAgentRequest.DenoisingMode = {
+        NoiseCancellation: "noise-cancellation",
+        NoiseAndBackgroundSpeechCancellation: "noise-and-background-speech-cancellation",
+    };
 })(CreateAgentRequest || (exports.CreateAgentRequest = CreateAgentRequest = {}));

package/dist/cjs/api/resources/agents/client/requests/UpdateAgentRequest.d.ts

@@ -17,6 +17,12 @@ export interface UpdateAgentRequest {
     voicemailMessage?: string | null;
     /** Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency). */
     sttMode?: UpdateAgentRequest.SttMode;
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    ambientSound?: UpdateAgentRequest.AmbientSound;
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    denoisingMode?: UpdateAgentRequest.DenoisingMode;
+    /** Hang up the call after this many milliseconds of caller silence. Default 600000 (10 min). Raise for IVR/hold-music workflows; lower to fail fast on dead lines. Range 10000 (10s) to 3600000 (1 hour). */
+    maxSilenceMs?: number | null;
 }
 export declare namespace UpdateAgentRequest {
     const VoiceMode: {
@@ -36,4 +42,18 @@ export declare namespace UpdateAgentRequest {
         readonly Accurate: "accurate";
     };
     type SttMode = (typeof SttMode)[keyof typeof SttMode];
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    const AmbientSound: {
+        readonly None: "none";
+        readonly Office: "office";
+        readonly CoffeeShop: "coffee-shop";
+        readonly Outdoor: "outdoor";
+    };
+    type AmbientSound = (typeof AmbientSound)[keyof typeof AmbientSound];
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    const DenoisingMode: {
+        readonly NoiseCancellation: "noise-cancellation";
+        readonly NoiseAndBackgroundSpeechCancellation: "noise-and-background-speech-cancellation";
+    };
+    type DenoisingMode = (typeof DenoisingMode)[keyof typeof DenoisingMode];
 }

package/dist/cjs/api/resources/agents/client/requests/UpdateAgentRequest.js

@@ -18,4 +18,16 @@ var UpdateAgentRequest;
         Fast: "fast",
         Accurate: "accurate",
     };
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    UpdateAgentRequest.AmbientSound = {
+        None: "none",
+        Office: "office",
+        CoffeeShop: "coffee-shop",
+        Outdoor: "outdoor",
+    };
+    /** Audio denoising. 'noise-cancellation' (default) handles general noise. 'noise-and-background-speech-cancellation' is more aggressive for callers in cars, cafes, or near TVs ($0.005/min surcharge). */
+    UpdateAgentRequest.DenoisingMode = {
+        NoiseCancellation: "noise-cancellation",
+        NoiseAndBackgroundSpeechCancellation: "noise-and-background-speech-cancellation",
+    };
 })(UpdateAgentRequest || (exports.UpdateAgentRequest = UpdateAgentRequest = {}));

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

@@ -90,6 +90,32 @@ export declare class CallsClient {
      */
     getCall(request: AgentPhone.GetCallV1CallsCallIdGetRequest, requestOptions?: CallsClient.RequestOptions): core.HttpResponsePromise<unknown>;
     private __getCall;
+    /**
+     * Returns the audio file (WAV format) for a completed call.
+     *
+     * This is a public endpoint -- no authentication is required. The call ID acts as the access token. The `recordingUrl` field in the call response already contains this URL when recording is enabled.
+     *
+     * Recording must be enabled on your account via `POST /credits/recording/enable` ($5/mo add-on). Returns `404` if the call doesn't exist or has no recording.
+     *
+     * **Response:** Binary audio file (`audio/wav`), auto-downloads with filename `recording-{call_id}.wav`.
+     *
+     * **Notes:**
+     * - Recording is available shortly after a call completes
+     * - Check `recordingAvailable: true` in the call response before fetching
+     * - The URL can be shared or embedded directly since it requires no authentication
+     *
+     * @param {AgentPhone.GetCallRecordingV1CallsCallIdRecordingGetRequest} request
+     * @param {CallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.calls.getCallRecording({
+     *         call_id: "call_id"
+     *     })
+     */
+    getCallRecording(request: AgentPhone.GetCallRecordingV1CallsCallIdRecordingGetRequest, requestOptions?: CallsClient.RequestOptions): core.HttpResponsePromise<unknown>;
+    private __getCallRecording;
     /**
      * Get the full transcript for a call.
      *

package/dist/cjs/api/resources/calls/client/Client.js

@@ -291,6 +291,67 @@ class CallsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/calls/{call_id}");
         });
     }
+    /**
+     * Returns the audio file (WAV format) for a completed call.
+     *
+     * This is a public endpoint -- no authentication is required. The call ID acts as the access token. The `recordingUrl` field in the call response already contains this URL when recording is enabled.
+     *
+     * Recording must be enabled on your account via `POST /credits/recording/enable` ($5/mo add-on). Returns `404` if the call doesn't exist or has no recording.
+     *
+     * **Response:** Binary audio file (`audio/wav`), auto-downloads with filename `recording-{call_id}.wav`.
+     *
+     * **Notes:**
+     * - Recording is available shortly after a call completes
+     * - Check `recordingAvailable: true` in the call response before fetching
+     * - The URL can be shared or embedded directly since it requires no authentication
+     *
+     * @param {AgentPhone.GetCallRecordingV1CallsCallIdRecordingGetRequest} request
+     * @param {CallsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.calls.getCallRecording({
+     *         call_id: "call_id"
+     *     })
+     */
+    getCallRecording(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getCallRecording(request, requestOptions));
+    }
+    __getCallRecording(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { call_id: callId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, `v1/calls/${core.url.encodePathParam(callId)}/recording`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new AgentPhone.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AgentPhoneError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/calls/{call_id}/recording");
+        });
+    }
     /**
      * Get the full transcript for a call.
      *

package/dist/cjs/api/resources/calls/client/requests/CreateOutboundCallRequest.d.ts

@@ -18,4 +18,6 @@ export interface CreateOutboundCallRequest {
     voice?: string | null;
     /** When provided, uses a built-in LLM for the conversation instead of forwarding to a webhook. The prompt defines the AI's personality and conversation topic. */
     systemPrompt?: string | null;
+    /** Optional per-call dynamic variables. Values are substituted into ``{{var_name}}`` placeholders in the agent's system prompt and initial greeting at call time. Requires either ``systemPrompt`` or a hosted-mode agent. */
+    variables?: Record<string, string | null> | null;
 }

package/dist/cjs/api/resources/calls/client/requests/CreateWebCallRequest.d.ts

@@ -9,4 +9,6 @@ export interface CreateWebCallRequest {
     agentId: string;
     /** Optional metadata to attach to the call */
     metadata?: Record<string, unknown> | null;
+    /** Optional per-call dynamic variables. Values are substituted into ``{{var_name}}`` placeholders in the agent's system prompt and begin message at call time. Requires a hosted-mode agent. */
+    variables?: Record<string, string | null> | null;
 }

package/dist/cjs/api/resources/calls/client/requests/GetCallRecordingV1CallsCallIdRecordingGetRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         call_id: "call_id"
+ *     }
+ */
+export interface GetCallRecordingV1CallsCallIdRecordingGetRequest {
+    call_id: string;
+}

package/dist/cjs/api/resources/calls/client/requests/GetCallRecordingV1CallsCallIdRecordingGetRequest.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/calls/client/requests/index.d.ts

@@ -1,5 +1,6 @@
 export type { CreateOutboundCallRequest } from "./CreateOutboundCallRequest.js";
 export type { CreateWebCallRequest } from "./CreateWebCallRequest.js";
+export type { GetCallRecordingV1CallsCallIdRecordingGetRequest } from "./GetCallRecordingV1CallsCallIdRecordingGetRequest.js";
 export type { GetCallTranscriptV1CallsCallIdTranscriptGetRequest } from "./GetCallTranscriptV1CallsCallIdTranscriptGetRequest.js";
 export type { GetCallV1CallsCallIdGetRequest } from "./GetCallV1CallsCallIdGetRequest.js";
 export type { ListCallsForNumberV1NumbersNumberIdCallsGetRequest } from "./ListCallsForNumberV1NumbersNumberIdCallsGetRequest.js";

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

@@ -79,4 +79,23 @@ export declare class ConversationsClient {
      */
     getConversationMessages(request: AgentPhone.GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest, requestOptions?: ConversationsClient.RequestOptions): core.HttpResponsePromise<AgentPhone.MessagesListResponse>;
     private __getConversationMessages;
+    /**
+     * Show a typing indicator in the conversation (iMessage only).
+     *
+     * Best-effort: providers may silently drop the indicator if the chat hasn't
+     * had recent activity, the recipient isn't on iMessage, or it's a group chat.
+     * Indicators auto-expire after a few seconds — no "stop typing" call needed.
+     *
+     * @param {AgentPhone.SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest} request
+     * @param {ConversationsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.conversations.sendTypingIndicator({
+     *         conversation_id: "conversation_id"
+     *     })
+     */
+    sendTypingIndicator(request: AgentPhone.SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest, requestOptions?: ConversationsClient.RequestOptions): core.HttpResponsePromise<AgentPhone.SendTypingResponse>;
+    private __sendTypingIndicator;
 }

package/dist/cjs/api/resources/conversations/client/Client.js

@@ -297,5 +297,60 @@ class ConversationsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/conversations/{conversation_id}/messages");
         });
     }
+    /**
+     * Show a typing indicator in the conversation (iMessage only).
+     *
+     * Best-effort: providers may silently drop the indicator if the chat hasn't
+     * had recent activity, the recipient isn't on iMessage, or it's a group chat.
+     * Indicators auto-expire after a few seconds — no "stop typing" call needed.
+     *
+     * @param {AgentPhone.SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest} request
+     * @param {ConversationsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.conversations.sendTypingIndicator({
+     *         conversation_id: "conversation_id"
+     *     })
+     */
+    sendTypingIndicator(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sendTypingIndicator(request, requestOptions));
+    }
+    __sendTypingIndicator(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { conversation_id: conversationId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, `v1/conversations/${core.url.encodePathParam(conversationId)}/typing`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new AgentPhone.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AgentPhoneError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v1/conversations/{conversation_id}/typing");
+        });
+    }
 }
 exports.ConversationsClient = ConversationsClient;

package/dist/cjs/api/resources/conversations/client/requests/SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         conversation_id: "conversation_id"
+ *     }
+ */
+export interface SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest {
+    conversation_id: string;
+}

package/dist/cjs/api/resources/conversations/client/requests/SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest.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/conversations/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest } from "./GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest.js";
 export type { GetConversationV1ConversationsConversationIdGetRequest } from "./GetConversationV1ConversationsConversationIdGetRequest.js";
 export type { ListConversationsV1ConversationsGetRequest } from "./ListConversationsV1ConversationsGetRequest.js";
+export type { SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest } from "./SendTypingIndicatorV1ConversationsConversationIdTypingPostRequest.js";
 export type { UpdateConversationRequest } from "./UpdateConversationRequest.js";

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

@@ -16,5 +16,6 @@ export * from "./numbers/client/requests/index.js";
 export * as numbers from "./numbers/index.js";
 export * from "./usage/client/requests/index.js";
 export * as usage from "./usage/index.js";
+export * from "./usage/types/index.js";
 export * from "./webhooks/client/requests/index.js";
 export * as webhooks from "./webhooks/index.js";

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

@@ -55,5 +55,6 @@ __exportStar(require("./numbers/client/requests/index.js"), exports);
 exports.numbers = __importStar(require("./numbers/index.js"));
 __exportStar(require("./usage/client/requests/index.js"), exports);
 exports.usage = __importStar(require("./usage/index.js"));
+__exportStar(require("./usage/types/index.js"), exports);
 __exportStar(require("./webhooks/client/requests/index.js"), exports);
 exports.webhooks = __importStar(require("./webhooks/index.js"));

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

@@ -13,6 +13,24 @@ export declare class MessagesClient {
     /**
      * Send an outbound message (SMS or iMessage) via the provider assigned to the number.
      *
+     * Supports single attachments via `media_url` or multiple attachments via `media_urls`. You may use one or the other, but not both.
+     *
+     * ### Carousel / multi-image (iMessage)
+     *
+     * To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requirements:
+     * - Each URL must be a **publicly accessible HTTPS link** to an image (JPEG, PNG, GIF, etc.)
+     * - Minimum 2 URLs, maximum 20
+     * - `body` must be omitted or empty (text cannot be sent alongside a carousel)
+     * - Only supported on iMessage-capable lines
+     *
+     * ### Single attachment
+     *
+     * Pass a single URL in `media_url`. The URL must be publicly accessible. Works across all channels.
+     *
+     * ### Multi-attachment (iMessage)
+     *
+     * Some iMessage lines support multiple attachments (images and other file types) via `media_urls`. No minimum count; `body` can be included alongside attachments.
+     *
      * @param {AgentPhone.SendMessageRequest} request
      * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/messages/client/Client.js

@@ -69,6 +69,24 @@ class MessagesClient {
     /**
      * Send an outbound message (SMS or iMessage) via the provider assigned to the number.
      *
+     * Supports single attachments via `media_url` or multiple attachments via `media_urls`. You may use one or the other, but not both.
+     *
+     * ### Carousel / multi-image (iMessage)
+     *
+     * To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requirements:
+     * - Each URL must be a **publicly accessible HTTPS link** to an image (JPEG, PNG, GIF, etc.)
+     * - Minimum 2 URLs, maximum 20
+     * - `body` must be omitted or empty (text cannot be sent alongside a carousel)
+     * - Only supported on iMessage-capable lines
+     *
+     * ### Single attachment
+     *
+     * Pass a single URL in `media_url`. The URL must be publicly accessible. Works across all channels.
+     *
+     * ### Multi-attachment (iMessage)
+     *
+     * Some iMessage lines support multiple attachments (images and other file types) via `media_urls`. No minimum count; `body` can be included alongside attachments.
+     *
      * @param {AgentPhone.SendMessageRequest} request
      * @param {MessagesClient.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/messages/client/requests/SendMessageRequest.d.ts

@@ -11,5 +11,6 @@ export interface SendMessageRequest {
     to_number: string;
     body: string;
     media_url?: string | null;
+    media_urls?: string[] | null;
     number_id?: string | null;
 }

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

@@ -54,4 +54,31 @@ export declare class UsageClient {
      */
     getMonthlyUsage(request?: AgentPhone.GetMonthlyUsageV1UsageMonthlyGetRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.MonthlyUsageResponse>;
     private __getMonthlyUsage;
+    /**
+     * Get usage statistics broken down by phone number, with linked agent info.
+     *
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.usage.getUsageByNumber()
+     */
+    getUsageByNumber(requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.NumberUsageResponse>;
+    private __getUsageByNumber;
+    /**
+     * Get usage broken down by agent for the current calendar week, month, or year.
+     * Includes message count, completed call count, and total call seconds per agent.
+     * Calls/messages with no agent attached are bucketed as "Unassigned".
+     *
+     * @param {AgentPhone.GetUsageByAgentV1UsageByAgentGetRequest} request
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.usage.getUsageByAgent({
+     *         period: "week"
+     *     })
+     */
+    getUsageByAgent(request: AgentPhone.GetUsageByAgentV1UsageByAgentGetRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.AgentUsageResponse>;
+    private __getUsageByAgent;
 }

package/dist/cjs/api/resources/usage/client/Client.js

@@ -207,5 +207,102 @@ class UsageClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/usage/monthly");
         });
     }
+    /**
+     * Get usage statistics broken down by phone number, with linked agent info.
+     *
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.usage.getUsageByNumber()
+     */
+    getUsageByNumber(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUsageByNumber(requestOptions));
+    }
+    __getUsageByNumber(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, "v1/usage/by-number"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.AgentPhoneError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/usage/by-number");
+        });
+    }
+    /**
+     * Get usage broken down by agent for the current calendar week, month, or year.
+     * Includes message count, completed call count, and total call seconds per agent.
+     * Calls/messages with no agent attached are bucketed as "Unassigned".
+     *
+     * @param {AgentPhone.GetUsageByAgentV1UsageByAgentGetRequest} request
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.usage.getUsageByAgent({
+     *         period: "week"
+     *     })
+     */
+    getUsageByAgent(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUsageByAgent(request, requestOptions));
+    }
+    __getUsageByAgent(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { period, tz } = request;
+            const _queryParams = {
+                period,
+                tz,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentPhoneEnvironment.Production, "v1/usage/by-agent"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new AgentPhone.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AgentPhoneError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v1/usage/by-agent");
+        });
+    }
 }
 exports.UsageClient = UsageClient;

package/dist/cjs/api/resources/usage/client/requests/GetUsageByAgentV1UsageByAgentGetRequest.d.ts

@@ -0,0 +1,12 @@
+import type * as AgentPhone from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         period: "week"
+ *     }
+ */
+export interface GetUsageByAgentV1UsageByAgentGetRequest {
+    period: AgentPhone.GetUsageByAgentV1UsageByAgentGetRequestPeriod;
+    /** IANA timezone, e.g. America/New_York */
+    tz?: string | null;
+}

package/dist/cjs/api/resources/usage/client/requests/GetUsageByAgentV1UsageByAgentGetRequest.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/usage/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export type { GetDailyUsageV1UsageDailyGetRequest } from "./GetDailyUsageV1UsageDailyGetRequest.js";
 export type { GetMonthlyUsageV1UsageMonthlyGetRequest } from "./GetMonthlyUsageV1UsageMonthlyGetRequest.js";
+export type { GetUsageByAgentV1UsageByAgentGetRequest } from "./GetUsageByAgentV1UsageByAgentGetRequest.js";

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

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

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

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);