agentphone 1.0.6 → 1.0.8

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.6",
-        "User-Agent": "agentphone/1.0.6",
+        "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

@@ -20,6 +20,8 @@ export interface CreateAgentRequest {
     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: {

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

@@ -21,6 +21,8 @@ export interface UpdateAgentRequest {
     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: {

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

@@ -64,4 +64,21 @@ export declare class UsageClient {
      */
     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

@@ -247,5 +247,62 @@ class UsageClient {
             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);

package/dist/cjs/api/resources/usage/types/GetUsageByAgentV1UsageByAgentGetRequestPeriod.d.ts

@@ -0,0 +1,6 @@
+export declare const GetUsageByAgentV1UsageByAgentGetRequestPeriod: {
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+export type GetUsageByAgentV1UsageByAgentGetRequestPeriod = (typeof GetUsageByAgentV1UsageByAgentGetRequestPeriod)[keyof typeof GetUsageByAgentV1UsageByAgentGetRequestPeriod];

package/dist/cjs/api/resources/usage/types/GetUsageByAgentV1UsageByAgentGetRequestPeriod.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetUsageByAgentV1UsageByAgentGetRequestPeriod = void 0;
+exports.GetUsageByAgentV1UsageByAgentGetRequestPeriod = {
+    Week: "week",
+    Month: "month",
+    Year: "year",
+};

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

@@ -0,0 +1 @@
+export * from "./GetUsageByAgentV1UsageByAgentGetRequestPeriod.js";

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

@@ -0,0 +1,17 @@
+"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("./GetUsageByAgentV1UsageByAgentGetRequestPeriod.js"), exports);

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

@@ -16,6 +16,8 @@ export interface AgentResponse {
     ambientSound?: AgentResponse.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?: AgentResponse.DenoisingMode;
+    /** Hang up the call after this many milliseconds of caller silence. Range 10000 (10s) to 3600000 (1 hour). Default 600000 (10 min). */
+    maxSilenceMs?: number;
     createdAt: string;
     numbers?: AgentPhone.AgentNumberResponse[] | null;
 }

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

@@ -0,0 +1,8 @@
+export interface AgentUsageItem {
+    agentId: string | null;
+    agentName: string;
+    messages: number;
+    calls: number;
+    totalSeconds: number;
+    isOrphan?: boolean;
+}

package/dist/cjs/api/types/AgentUsageItem.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/AgentUsageResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentPhone from "../index.js";
+export interface AgentUsageResponse {
+    data: AgentPhone.AgentUsageItem[];
+    period: string;
+    periodStart: string;
+    periodEnd: string;
+}

package/dist/cjs/api/types/AgentUsageResponse.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/MessageInConversation.d.ts

@@ -7,6 +7,7 @@ export interface MessageInConversation {
     direction: string;
     channel?: string | null;
     mediaUrl?: string | null;
+    mediaUrls?: string[];
     receivedAt: string;
     reactions?: AgentPhone.ReactionInConversation[];
 }

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

@@ -4,4 +4,5 @@ export interface SendMessageResponse {
     channel: string;
     from_number: string;
     to_number: string;
+    media_urls?: string[];
 }

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

@@ -1,6 +1,8 @@
 export * from "./AgentListResponse.js";
 export * from "./AgentNumberResponse.js";
 export * from "./AgentResponse.js";
+export * from "./AgentUsageItem.js";
+export * from "./AgentUsageResponse.js";
 export * from "./AllTimeStatsResponse.js";
 export * from "./AppRoutesAgentsConversationListResponse.js";
 export * from "./AppRoutesAgentsConversationSummary.js";

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

@@ -17,6 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AgentListResponse.js"), exports);
 __exportStar(require("./AgentNumberResponse.js"), exports);
 __exportStar(require("./AgentResponse.js"), exports);
+__exportStar(require("./AgentUsageItem.js"), exports);
+__exportStar(require("./AgentUsageResponse.js"), exports);
 __exportStar(require("./AllTimeStatsResponse.js"), exports);
 __exportStar(require("./AppRoutesAgentsConversationListResponse.js"), exports);
 __exportStar(require("./AppRoutesAgentsConversationSummary.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.6";
+export declare const SDK_VERSION = "1.0.7";

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 = "1.0.6";
+exports.SDK_VERSION = "1.0.7";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "agentphone",
-        "X-Fern-SDK-Version": "1.0.6",
-        "User-Agent": "agentphone/1.0.6",
+        "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/esm/api/resources/agents/client/Client.d.mts

@@ -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/esm/api/resources/agents/client/Client.mjs

@@ -31,7 +31,7 @@ export class AgentsClient {
         this._options = 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/esm/api/resources/agents/client/requests/CreateAgentRequest.d.mts

@@ -20,6 +20,8 @@ export interface CreateAgentRequest {
     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: {

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

@@ -21,6 +21,8 @@ export interface UpdateAgentRequest {
     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: {

package/dist/esm/api/resources/index.d.mts

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

package/dist/esm/api/resources/index.mjs

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

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

@@ -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/esm/api/resources/messages/client/Client.mjs

@@ -33,6 +33,24 @@ export 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/esm/api/resources/messages/client/requests/SendMessageRequest.d.mts

@@ -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/esm/api/resources/usage/client/Client.d.mts

@@ -64,4 +64,21 @@ export declare class UsageClient {
      */
     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/esm/api/resources/usage/client/Client.mjs

@@ -211,4 +211,61 @@ export class UsageClient {
             return 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 = 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/usage/by-agent");
+        });
+    }
 }

package/dist/esm/api/resources/usage/client/requests/GetUsageByAgentV1UsageByAgentGetRequest.d.mts

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

package/dist/esm/api/resources/usage/client/requests/GetUsageByAgentV1UsageByAgentGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/usage/client/requests/index.d.mts

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

package/dist/esm/api/resources/usage/index.d.mts

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

package/dist/esm/api/resources/usage/index.mjs

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

package/dist/esm/api/resources/usage/types/GetUsageByAgentV1UsageByAgentGetRequestPeriod.d.mts

@@ -0,0 +1,6 @@
+export declare const GetUsageByAgentV1UsageByAgentGetRequestPeriod: {
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+export type GetUsageByAgentV1UsageByAgentGetRequestPeriod = (typeof GetUsageByAgentV1UsageByAgentGetRequestPeriod)[keyof typeof GetUsageByAgentV1UsageByAgentGetRequestPeriod];

package/dist/esm/api/resources/usage/types/GetUsageByAgentV1UsageByAgentGetRequestPeriod.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetUsageByAgentV1UsageByAgentGetRequestPeriod = {
+    Week: "week",
+    Month: "month",
+    Year: "year",
+};

package/dist/esm/api/resources/usage/types/index.d.mts

@@ -0,0 +1 @@
+export * from "./GetUsageByAgentV1UsageByAgentGetRequestPeriod.mjs";

package/dist/esm/api/resources/usage/types/index.mjs

@@ -0,0 +1 @@
+export * from "./GetUsageByAgentV1UsageByAgentGetRequestPeriod.mjs";

package/dist/esm/api/types/AgentResponse.d.mts

@@ -16,6 +16,8 @@ export interface AgentResponse {
     ambientSound?: AgentResponse.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?: AgentResponse.DenoisingMode;
+    /** Hang up the call after this many milliseconds of caller silence. Range 10000 (10s) to 3600000 (1 hour). Default 600000 (10 min). */
+    maxSilenceMs?: number;
     createdAt: string;
     numbers?: AgentPhone.AgentNumberResponse[] | null;
 }

package/dist/esm/api/types/AgentUsageItem.d.mts

@@ -0,0 +1,8 @@
+export interface AgentUsageItem {
+    agentId: string | null;
+    agentName: string;
+    messages: number;
+    calls: number;
+    totalSeconds: number;
+    isOrphan?: boolean;
+}

package/dist/esm/api/types/AgentUsageItem.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/AgentUsageResponse.d.mts

@@ -0,0 +1,7 @@
+import type * as AgentPhone from "../index.mjs";
+export interface AgentUsageResponse {
+    data: AgentPhone.AgentUsageItem[];
+    period: string;
+    periodStart: string;
+    periodEnd: string;
+}

package/dist/esm/api/types/AgentUsageResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/MessageInConversation.d.mts

@@ -7,6 +7,7 @@ export interface MessageInConversation {
     direction: string;
     channel?: string | null;
     mediaUrl?: string | null;
+    mediaUrls?: string[];
     receivedAt: string;
     reactions?: AgentPhone.ReactionInConversation[];
 }

package/dist/esm/api/types/SendMessageResponse.d.mts

@@ -4,4 +4,5 @@ export interface SendMessageResponse {
     channel: string;
     from_number: string;
     to_number: string;
+    media_urls?: string[];
 }

package/dist/esm/api/types/index.d.mts

@@ -1,6 +1,8 @@
 export * from "./AgentListResponse.mjs";
 export * from "./AgentNumberResponse.mjs";
 export * from "./AgentResponse.mjs";
+export * from "./AgentUsageItem.mjs";
+export * from "./AgentUsageResponse.mjs";
 export * from "./AllTimeStatsResponse.mjs";
 export * from "./AppRoutesAgentsConversationListResponse.mjs";
 export * from "./AppRoutesAgentsConversationSummary.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,6 +1,8 @@
 export * from "./AgentListResponse.mjs";
 export * from "./AgentNumberResponse.mjs";
 export * from "./AgentResponse.mjs";
+export * from "./AgentUsageItem.mjs";
+export * from "./AgentUsageResponse.mjs";
 export * from "./AllTimeStatsResponse.mjs";
 export * from "./AppRoutesAgentsConversationListResponse.mjs";
 export * from "./AppRoutesAgentsConversationSummary.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.6";
+export declare const SDK_VERSION = "1.0.7";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.0.6";
+export const SDK_VERSION = "1.0.7";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "agentphone",
-    "version": "1.0.6",
+    "version": "1.0.8",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -150,7 +150,7 @@ await client.agentSignup.agentVerify({
 <dl>
 <dd>
 
-Return available voices from the call provider (Retell).
+Return available voices for voice calls.
 </dd>
 </dl>
 </dd>
@@ -3304,6 +3304,73 @@ await client.usage.getUsageByNumber();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">getUsageByAgent</a>({ ...params }) -> AgentPhone.AgentUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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".
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.usage.getUsageByAgent({
+    period: "week"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetUsageByAgentV1UsageByAgentGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsageClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -3322,6 +3389,24 @@ await client.usage.getUsageByNumber();
 <dd>
 
 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.
 </dd>
 </dl>
 </dd>