agentphone 1.0.5 → 1.0.7

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

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

@@ -171,4 +171,101 @@ export class UsageClient {
             return 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 = 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 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

@@ -12,6 +12,12 @@ export interface AgentResponse {
     voicemailMessage?: string | null;
     /** Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency). */
     sttMode?: AgentResponse.SttMode;
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    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;
 }
@@ -33,4 +39,18 @@ export declare namespace AgentResponse {
         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/esm/api/types/AgentResponse.mjs

@@ -15,4 +15,16 @@ export var AgentResponse;
         Fast: "fast",
         Accurate: "accurate",
     };
+    /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */
+    AgentResponse.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). */
+    AgentResponse.DenoisingMode = {
+        NoiseCancellation: "noise-cancellation",
+        NoiseAndBackgroundSpeechCancellation: "noise-and-background-speech-cancellation",
+    };
 })(AgentResponse || (AgentResponse = {}));

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/NumberUsageItem.d.mts

@@ -0,0 +1,10 @@
+export interface NumberUsageItem {
+    numberId: string;
+    phoneNumber: string;
+    country: string;
+    status: string;
+    agentId?: string | null;
+    agentName?: string | null;
+    messages: number;
+    calls: number;
+}

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

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

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

@@ -0,0 +1,4 @@
+import type * as AgentPhone from "../index.mjs";
+export interface NumberUsageResponse {
+    data: AgentPhone.NumberUsageItem[];
+}

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

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

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/SendTypingResponse.d.mts

@@ -0,0 +1,5 @@
+export interface SendTypingResponse {
+    conversationId: string;
+    channel: string;
+    status: string;
+}

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

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

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";
@@ -23,6 +25,8 @@ export * from "./MessagesListResponse.mjs";
 export * from "./MonthlyUsagePoint.mjs";
 export * from "./MonthlyUsageResponse.mjs";
 export * from "./NumberLimits.mjs";
+export * from "./NumberUsageItem.mjs";
+export * from "./NumberUsageResponse.mjs";
 export * from "./PaginatedDeliveriesResponse.mjs";
 export * from "./PhoneNumberListResponse.mjs";
 export * from "./PhoneNumberResponse.mjs";
@@ -31,6 +35,7 @@ export * from "./PlanLimits.mjs";
 export * from "./ReactionInConversation.mjs";
 export * from "./SendMessageResponse.mjs";
 export * from "./SendReactionResponse.mjs";
+export * from "./SendTypingResponse.mjs";
 export * from "./UsageResponse.mjs";
 export * from "./UsageStats.mjs";
 export * from "./ValidationError.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";
@@ -23,6 +25,8 @@ export * from "./MessagesListResponse.mjs";
 export * from "./MonthlyUsagePoint.mjs";
 export * from "./MonthlyUsageResponse.mjs";
 export * from "./NumberLimits.mjs";
+export * from "./NumberUsageItem.mjs";
+export * from "./NumberUsageResponse.mjs";
 export * from "./PaginatedDeliveriesResponse.mjs";
 export * from "./PhoneNumberListResponse.mjs";
 export * from "./PhoneNumberResponse.mjs";
@@ -31,6 +35,7 @@ export * from "./PlanLimits.mjs";
 export * from "./ReactionInConversation.mjs";
 export * from "./SendMessageResponse.mjs";
 export * from "./SendReactionResponse.mjs";
+export * from "./SendTypingResponse.mjs";
 export * from "./UsageResponse.mjs";
 export * from "./UsageStats.mjs";
 export * from "./ValidationError.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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