agentphone 1.0.0 → 1.0.2

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

@@ -0,0 +1,53 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webhooks = exports.usage = exports.numbers = exports.conversations = exports.calls = exports.agentWebhooks = exports.agents = void 0;
+__exportStar(require("./agents/client/requests/index.js"), exports);
+exports.agents = __importStar(require("./agents/index.js"));
+__exportStar(require("./agentWebhooks/client/requests/index.js"), exports);
+exports.agentWebhooks = __importStar(require("./agentWebhooks/index.js"));
+__exportStar(require("./calls/client/requests/index.js"), exports);
+exports.calls = __importStar(require("./calls/index.js"));
+__exportStar(require("./conversations/client/requests/index.js"), exports);
+exports.conversations = __importStar(require("./conversations/index.js"));
+__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("./webhooks/client/requests/index.js"), exports);
+exports.webhooks = __importStar(require("./webhooks/index.js"));

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

@@ -0,0 +1,84 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as AgentPhone from "../../../index.js";
+export declare namespace NumbersClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class NumbersClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<NumbersClient.Options>;
+    constructor(options: NumbersClient.Options);
+    /**
+     * List all phone numbers for this project.
+     *
+     * @param {AgentPhone.ListNumbersV1NumbersGetRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.listNumbers()
+     */
+    listNumbers(request?: AgentPhone.ListNumbersV1NumbersGetRequest, requestOptions?: NumbersClient.RequestOptions): core.HttpResponsePromise<AgentPhone.PhoneNumberListResponse>;
+    private __listNumbers;
+    /**
+     * Provision a new SMS-enabled phone number.
+     *
+     * 1. Check number limit (lifetime limit)
+     * 2. Search Twilio for available numbers
+     * 3. Purchase the first available one
+     * 4. Configure webhook URL
+     * 5. Store in our database
+     *
+     * @param {AgentPhone.CreateNumberRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.createNumber()
+     */
+    createNumber(request?: AgentPhone.CreateNumberRequest, requestOptions?: NumbersClient.RequestOptions): core.HttpResponsePromise<AgentPhone.PhoneNumberResponse>;
+    private __createNumber;
+    /**
+     * Get messages for a specific phone number.
+     *
+     * Supports cursor-based pagination via before/after timestamps.
+     *
+     * @param {AgentPhone.GetMessagesV1NumbersNumberIdMessagesGetRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.getMessages({
+     *         number_id: "number_id"
+     *     })
+     */
+    getMessages(request: AgentPhone.GetMessagesV1NumbersNumberIdMessagesGetRequest, requestOptions?: NumbersClient.RequestOptions): core.HttpResponsePromise<AgentPhone.MessageListResponse>;
+    private __getMessages;
+    /**
+     * Release (delete) a phone number.
+     *
+     * This will:
+     * 1. Release the number from Twilio (number goes back to Twilio's pool)
+     * 2. Mark the number as "released" in the database
+     * 3. Keep all messages and conversation history (for audit purposes)
+     *
+     * WARNING: This action is irreversible! The number cannot be recovered.
+     *
+     * @param {AgentPhone.DeleteNumberV1NumbersNumberIdDeleteRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.deleteNumber({
+     *         number_id: "number_id"
+     *     })
+     */
+    deleteNumber(request: AgentPhone.DeleteNumberV1NumbersNumberIdDeleteRequest, requestOptions?: NumbersClient.RequestOptions): core.HttpResponsePromise<unknown>;
+    private __deleteNumber;
+}

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

@@ -0,0 +1,285 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumbersClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const AgentPhone = __importStar(require("../../../index.js"));
+class NumbersClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * List all phone numbers for this project.
+     *
+     * @param {AgentPhone.ListNumbersV1NumbersGetRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.listNumbers()
+     */
+    listNumbers(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listNumbers(request, requestOptions));
+    }
+    __listNumbers() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { limit, offset } = request;
+            const _queryParams = {
+                limit,
+                offset,
+            };
+            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.Default, "v1/numbers"),
+                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/numbers");
+        });
+    }
+    /**
+     * Provision a new SMS-enabled phone number.
+     *
+     * 1. Check number limit (lifetime limit)
+     * 2. Search Twilio for available numbers
+     * 3. Purchase the first available one
+     * 4. Configure webhook URL
+     * 5. Store in our database
+     *
+     * @param {AgentPhone.CreateNumberRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.createNumber()
+     */
+    createNumber(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createNumber(request, requestOptions));
+    }
+    __createNumber() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            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.Default, "v1/numbers"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                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/numbers");
+        });
+    }
+    /**
+     * Get messages for a specific phone number.
+     *
+     * Supports cursor-based pagination via before/after timestamps.
+     *
+     * @param {AgentPhone.GetMessagesV1NumbersNumberIdMessagesGetRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.getMessages({
+     *         number_id: "number_id"
+     *     })
+     */
+    getMessages(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getMessages(request, requestOptions));
+    }
+    __getMessages(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { number_id: numberId, limit, before, after } = request;
+            const _queryParams = {
+                limit,
+                before: before !== undefined ? before : undefined,
+                after: after !== undefined ? after : undefined,
+            };
+            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.Default, `v1/numbers/${core.url.encodePathParam(numberId)}/messages`),
+                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/numbers/{number_id}/messages");
+        });
+    }
+    /**
+     * Release (delete) a phone number.
+     *
+     * This will:
+     * 1. Release the number from Twilio (number goes back to Twilio's pool)
+     * 2. Mark the number as "released" in the database
+     * 3. Keep all messages and conversation history (for audit purposes)
+     *
+     * WARNING: This action is irreversible! The number cannot be recovered.
+     *
+     * @param {AgentPhone.DeleteNumberV1NumbersNumberIdDeleteRequest} request
+     * @param {NumbersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.numbers.deleteNumber({
+     *         number_id: "number_id"
+     *     })
+     */
+    deleteNumber(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteNumber(request, requestOptions));
+    }
+    __deleteNumber(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { number_id: numberId } = 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.Default, `v1/numbers/${core.url.encodePathParam(numberId)}`),
+                method: "DELETE",
+                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, "DELETE", "/v1/numbers/{number_id}");
+        });
+    }
+}
+exports.NumbersClient = NumbersClient;

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

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

package/dist/cjs/api/resources/numbers/client/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("./requests/index.js"), exports);

package/dist/cjs/api/resources/numbers/client/requests/CreateNumberRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {}
+ */
+export interface CreateNumberRequest {
+    country?: string;
+    areaCode?: string | null;
+    agentId?: string | null;
+}

package/dist/cjs/api/resources/numbers/client/requests/CreateNumberRequest.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/numbers/client/requests/DeleteNumberV1NumbersNumberIdDeleteRequest.d.ts

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

package/dist/cjs/api/resources/numbers/client/requests/DeleteNumberV1NumbersNumberIdDeleteRequest.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/numbers/client/requests/GetMessagesV1NumbersNumberIdMessagesGetRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         number_id: "number_id"
+ *     }
+ */
+export interface GetMessagesV1NumbersNumberIdMessagesGetRequest {
+    number_id: string;
+    limit?: number;
+    before?: string | null;
+    after?: string | null;
+}

package/dist/cjs/api/resources/numbers/client/requests/GetMessagesV1NumbersNumberIdMessagesGetRequest.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/numbers/client/requests/ListNumbersV1NumbersGetRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ListNumbersV1NumbersGetRequest {
+    limit?: number;
+    offset?: number;
+}

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

@@ -0,0 +1,4 @@
+export type { CreateNumberRequest } from "./CreateNumberRequest.js";
+export type { DeleteNumberV1NumbersNumberIdDeleteRequest } from "./DeleteNumberV1NumbersNumberIdDeleteRequest.js";
+export type { GetMessagesV1NumbersNumberIdMessagesGetRequest } from "./GetMessagesV1NumbersNumberIdMessagesGetRequest.js";
+export type { ListNumbersV1NumbersGetRequest } from "./ListNumbersV1NumbersGetRequest.js";

package/dist/cjs/api/resources/numbers/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

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

package/dist/cjs/api/resources/numbers/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("./client/index.js"), exports);

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

@@ -0,0 +1,57 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as AgentPhone from "../../../index.js";
+export declare namespace UsageClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class UsageClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<UsageClient.Options>;
+    constructor(options: UsageClient.Options);
+    /**
+     * Get usage statistics for the current project.
+     *
+     * Returns:
+     * - Phone number limits (used/limit/remaining)
+     * - Message statistics (total, last 24h, last 7 days, last 30 days)
+     * - Call statistics (total, last 24h, last 7 days, last 30 days)
+     * - Webhook delivery statistics
+     *
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.usage.getUsage()
+     */
+    getUsage(requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.UsageResponse>;
+    private __getUsage;
+    /**
+     * Get daily usage breakdown for the last N days (up to 365).
+     * Returns per-day counts of messages, calls, and webhook deliveries.
+     *
+     * @param {AgentPhone.GetDailyUsageV1UsageDailyGetRequest} request
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.usage.getDailyUsage()
+     */
+    getDailyUsage(request?: AgentPhone.GetDailyUsageV1UsageDailyGetRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.DailyUsageResponse>;
+    private __getDailyUsage;
+    /**
+     * Get monthly usage aggregation for the last N months.
+     * Returns per-month totals of messages, calls, and webhook deliveries.
+     *
+     * @param {AgentPhone.GetMonthlyUsageV1UsageMonthlyGetRequest} request
+     * @param {UsageClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.usage.getMonthlyUsage()
+     */
+    getMonthlyUsage(request?: AgentPhone.GetMonthlyUsageV1UsageMonthlyGetRequest, requestOptions?: UsageClient.RequestOptions): core.HttpResponsePromise<AgentPhone.MonthlyUsageResponse>;
+    private __getMonthlyUsage;
+}