agentphone 1.0.14 → 1.0.16

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

@@ -67,24 +67,32 @@ class SubAccountsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
+     * @param {AgentPhone.ListSubAccountsV1SubAccountsGetRequest} request
      * @param {SubAccountsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
      * @example
      *     await client.subAccounts.listSubAccounts()
      */
-    listSubAccounts(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__listSubAccounts(requestOptions));
+    listSubAccounts(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listSubAccounts(request, requestOptions));
     }
-    __listSubAccounts(requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __listSubAccounts() {
+        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.Production, "v1/sub-accounts"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                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,
@@ -95,11 +103,16 @@ class SubAccountsClient {
                 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,
-                });
+                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/sub-accounts");
         });

package/dist/cjs/api/resources/subAccounts/client/requests/ListSubAccountsV1SubAccountsGetRequest.d.ts

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

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

@@ -1,3 +1,4 @@
 export type { CreateSubAccountRequest } from "./CreateSubAccountRequest.js";
 export type { DeleteSubAccountV1SubAccountsSubAccountIdDeleteRequest } from "./DeleteSubAccountV1SubAccountsSubAccountIdDeleteRequest.js";
+export type { ListSubAccountsV1SubAccountsGetRequest } from "./ListSubAccountsV1SubAccountsGetRequest.js";
 export type { UpdateSubAccountRequest } from "./UpdateSubAccountRequest.js";

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

@@ -10,7 +10,10 @@ export interface AgentResponse {
     beginMessage?: string | null;
     voice: string;
     transferNumber?: string | null;
+    customTools?: Record<string, unknown>[] | null;
     voicemailMessage?: string | null;
+    callScreeningIdentity?: string | null;
+    callScreeningPurpose?: 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. */

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

@@ -0,0 +1,7 @@
+export declare const CampaignInclude: {
+    readonly Links: "links";
+    readonly PhoneNumbers: "phone_numbers";
+    readonly AgeGated: "age_gated";
+    readonly DirectLending: "direct_lending";
+};
+export type CampaignInclude = (typeof CampaignInclude)[keyof typeof CampaignInclude];

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

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CampaignInclude = void 0;
+exports.CampaignInclude = {
+    Links: "links",
+    PhoneNumbers: "phone_numbers",
+    AgeGated: "age_gated",
+    DirectLending: "direct_lending",
+};

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

@@ -0,0 +1,4 @@
+export interface CampaignStatusResponse {
+    campaign_status: string;
+    message: string;
+}

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

@@ -0,0 +1,6 @@
+import type * as AgentPhone from "../index.js";
+export interface ContactCapabilitiesResponse {
+    phoneNumber: string;
+    capabilities: AgentPhone.ContactCapabilityFlags;
+    checkedAt: string;
+}

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

@@ -0,0 +1,4 @@
+export interface ContactCapabilityFlags {
+    imessage: boolean;
+    sms: boolean;
+}

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

@@ -0,0 +1,11 @@
+export declare const ContactTitle: {
+    readonly Ceo: "ceo";
+    readonly Cfo: "cfo";
+    readonly Cto: "cto";
+    readonly Coo: "coo";
+    readonly Vp: "vp";
+    readonly Gm: "gm";
+    readonly Director: "director";
+    readonly Other: "other";
+};
+export type ContactTitle = (typeof ContactTitle)[keyof typeof ContactTitle];

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

@@ -0,0 +1,14 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactTitle = void 0;
+exports.ContactTitle = {
+    Ceo: "ceo",
+    Cfo: "cfo",
+    Cto: "cto",
+    Coo: "coo",
+    Vp: "vp",
+    Gm: "gm",
+    Director: "director",
+    Other: "other",
+};

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

@@ -0,0 +1,28 @@
+export interface CustomToolParam {
+    /** Function name the agent calls. Letters, numbers, underscores, hyphens; max 64 chars. Must be unique and not a reserved built-in name. */
+    name: string;
+    /** What the tool does and when to use it. The agent relies on this to decide when to call it. */
+    description: string;
+    /** HTTPS endpoint the voice provider calls when the agent invokes this tool. */
+    url: string;
+    /** HTTP method. Defaults to POST. */
+    method?: CustomToolParam.Method;
+    /** Optional HTTP headers sent with the request (e.g. an Authorization token for your endpoint). */
+    headers?: Record<string, string | null> | null;
+    /** JSON Schema object describing the arguments the agent fills in. Omit for a no-argument tool. */
+    parameters?: Record<string, unknown> | null;
+    /** How long to wait for your endpoint before giving up. Range 1000-120000 ms. */
+    timeoutMs?: number | null;
+    /** When true, the agent speaks executionMessage while the tool runs. */
+    speakDuringExecution?: boolean | null;
+    /** What the agent says while the tool runs (used when speakDuringExecution is true). */
+    executionMessage?: string | null;
+}
+export declare namespace CustomToolParam {
+    /** HTTP method. Defaults to POST. */
+    const Method: {
+        readonly Get: "GET";
+        readonly Post: "POST";
+    };
+    type Method = (typeof Method)[keyof typeof Method];
+}

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

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomToolParam = void 0;
+var CustomToolParam;
+(function (CustomToolParam) {
+    /** HTTP method. Defaults to POST. */
+    CustomToolParam.Method = {
+        Get: "GET",
+        Post: "POST",
+    };
+})(CustomToolParam || (exports.CustomToolParam = CustomToolParam = {}));

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

@@ -11,4 +11,5 @@ export interface MessageInConversation {
     mediaUrls?: string[];
     receivedAt: string;
     reactions?: AgentPhone.ReactionInConversation[];
+    replyTo?: AgentPhone.ReplyToInConversation | null;
 }

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

@@ -0,0 +1,11 @@
+export declare const OrganizationType: {
+    readonly SoleProprietor: "sole_proprietor";
+    readonly PrivateCorporation: "private_corporation";
+    readonly PublicCorporation: "public_corporation";
+    readonly Llc: "llc";
+    readonly Partnership: "partnership";
+    readonly NonProfit: "non_profit";
+    readonly CoOp: "co_op";
+    readonly Government: "government";
+};
+export type OrganizationType = (typeof OrganizationType)[keyof typeof OrganizationType];

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

@@ -0,0 +1,14 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganizationType = void 0;
+exports.OrganizationType = {
+    SoleProprietor: "sole_proprietor",
+    PrivateCorporation: "private_corporation",
+    PublicCorporation: "public_corporation",
+    Llc: "llc",
+    Partnership: "partnership",
+    NonProfit: "non_profit",
+    CoOp: "co_op",
+    Government: "government",
+};

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

@@ -1,8 +1,7 @@
-import type * as AgentPhone from "../index.js";
 export interface RegistrationResponse {
     ok: boolean;
     message: string;
-    payment_url: string;
     campaign_status: string;
-    warnings?: AgentPhone.FieldWarning[];
+    sub_account_id?: string | null;
+    fee_cents?: number;
 }

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

@@ -0,0 +1,5 @@
+export interface ReplyToInConversation {
+    messageId: string;
+    message: string;
+    mediaUrls?: string[];
+}

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

@@ -4,6 +4,7 @@ export interface SendMessageResponse {
     channel: string;
     from_number: string;
     to_number: string;
+    conversation_id?: string | null;
     media_urls?: string[];
     reply_to_message_id?: string | null;
     reply_parent_unresolved?: boolean | null;

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

@@ -0,0 +1,13 @@
+export declare const UseCase: {
+    readonly AccountNotification: "account_notification";
+    readonly CustomerCare: "customer_care";
+    readonly DeliveryNotification: "delivery_notification";
+    readonly FraudAlert: "fraud_alert";
+    readonly HigherEducation: "higher_education";
+    readonly Marketing: "marketing";
+    readonly PollingVoting: "polling_voting";
+    readonly PublicServiceAnnouncement: "public_service_announcement";
+    readonly SecurityAlert: "security_alert";
+    readonly TwoFactorAuthentication: "two_factor_authentication";
+};
+export type UseCase = (typeof UseCase)[keyof typeof UseCase];

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

@@ -0,0 +1,16 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseCase = void 0;
+exports.UseCase = {
+    AccountNotification: "account_notification",
+    CustomerCare: "customer_care",
+    DeliveryNotification: "delivery_notification",
+    FraudAlert: "fraud_alert",
+    HigherEducation: "higher_education",
+    Marketing: "marketing",
+    PollingVoting: "polling_voting",
+    PublicServiceAnnouncement: "public_service_announcement",
+    SecurityAlert: "security_alert",
+    TwoFactorAuthentication: "two_factor_authentication",
+};

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

@@ -0,0 +1,5 @@
+export declare const Volume: {
+    readonly Low: "low";
+    readonly High: "high";
+};
+export type Volume = (typeof Volume)[keyof typeof Volume];

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

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Volume = void 0;
+exports.Volume = {
+    Low: "low",
+    High: "high",
+};

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

@@ -13,14 +13,19 @@ export * from "./AppRoutesConversationsConversationSummary.js";
 export * from "./AttachNumberResponse.js";
 export * from "./CallListResponse.js";
 export * from "./CallSummary.js";
+export * from "./CampaignInclude.js";
+export * from "./CampaignStatusResponse.js";
+export * from "./ContactCapabilitiesResponse.js";
+export * from "./ContactCapabilityFlags.js";
 export * from "./ContactCardResponse.js";
 export * from "./ContactListResponse.js";
 export * from "./ContactResponse.js";
+export * from "./ContactTitle.js";
 export * from "./ConversationDetail.js";
+export * from "./CustomToolParam.js";
 export * from "./DailyUsagePoint.js";
 export * from "./DailyUsageResponse.js";
 export * from "./DeleteAgentResponse.js";
-export * from "./FieldWarning.js";
 export * from "./GroupParticipant.js";
 export * from "./HttpValidationError.js";
 export * from "./LocationRefreshResponse.js";
@@ -34,6 +39,7 @@ export * from "./MonthlyUsageResponse.js";
 export * from "./NumberLimits.js";
 export * from "./NumberUsageItem.js";
 export * from "./NumberUsageResponse.js";
+export * from "./OrganizationType.js";
 export * from "./PaginatedDeliveriesResponse.js";
 export * from "./PhoneNumberListResponse.js";
 export * from "./PhoneNumberResponse.js";
@@ -41,13 +47,16 @@ export * from "./PlanInfo.js";
 export * from "./PlanLimits.js";
 export * from "./ReactionInConversation.js";
 export * from "./RegistrationResponse.js";
+export * from "./ReplyToInConversation.js";
 export * from "./SendMessageResponse.js";
 export * from "./SendReactionResponse.js";
 export * from "./SendTypingResponse.js";
 export * from "./SetBackgroundResponse.js";
 export * from "./UsageResponse.js";
 export * from "./UsageStats.js";
+export * from "./UseCase.js";
 export * from "./ValidationError.js";
+export * from "./Volume.js";
 export * from "./WebhookCreateRequest.js";
 export * from "./WebhookDeliveryResponse.js";
 export * from "./WebhookDeliveryStatsResponse.js";

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

@@ -29,14 +29,19 @@ __exportStar(require("./AppRoutesConversationsConversationSummary.js"), exports)
 __exportStar(require("./AttachNumberResponse.js"), exports);
 __exportStar(require("./CallListResponse.js"), exports);
 __exportStar(require("./CallSummary.js"), exports);
+__exportStar(require("./CampaignInclude.js"), exports);
+__exportStar(require("./CampaignStatusResponse.js"), exports);
+__exportStar(require("./ContactCapabilitiesResponse.js"), exports);
+__exportStar(require("./ContactCapabilityFlags.js"), exports);
 __exportStar(require("./ContactCardResponse.js"), exports);
 __exportStar(require("./ContactListResponse.js"), exports);
 __exportStar(require("./ContactResponse.js"), exports);
+__exportStar(require("./ContactTitle.js"), exports);
 __exportStar(require("./ConversationDetail.js"), exports);
+__exportStar(require("./CustomToolParam.js"), exports);
 __exportStar(require("./DailyUsagePoint.js"), exports);
 __exportStar(require("./DailyUsageResponse.js"), exports);
 __exportStar(require("./DeleteAgentResponse.js"), exports);
-__exportStar(require("./FieldWarning.js"), exports);
 __exportStar(require("./GroupParticipant.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);
 __exportStar(require("./LocationRefreshResponse.js"), exports);
@@ -50,6 +55,7 @@ __exportStar(require("./MonthlyUsageResponse.js"), exports);
 __exportStar(require("./NumberLimits.js"), exports);
 __exportStar(require("./NumberUsageItem.js"), exports);
 __exportStar(require("./NumberUsageResponse.js"), exports);
+__exportStar(require("./OrganizationType.js"), exports);
 __exportStar(require("./PaginatedDeliveriesResponse.js"), exports);
 __exportStar(require("./PhoneNumberListResponse.js"), exports);
 __exportStar(require("./PhoneNumberResponse.js"), exports);
@@ -57,13 +63,16 @@ __exportStar(require("./PlanInfo.js"), exports);
 __exportStar(require("./PlanLimits.js"), exports);
 __exportStar(require("./ReactionInConversation.js"), exports);
 __exportStar(require("./RegistrationResponse.js"), exports);
+__exportStar(require("./ReplyToInConversation.js"), exports);
 __exportStar(require("./SendMessageResponse.js"), exports);
 __exportStar(require("./SendReactionResponse.js"), exports);
 __exportStar(require("./SendTypingResponse.js"), exports);
 __exportStar(require("./SetBackgroundResponse.js"), exports);
 __exportStar(require("./UsageResponse.js"), exports);
 __exportStar(require("./UsageStats.js"), exports);
+__exportStar(require("./UseCase.js"), exports);
 __exportStar(require("./ValidationError.js"), exports);
+__exportStar(require("./Volume.js"), exports);
 __exportStar(require("./WebhookCreateRequest.js"), exports);
 __exportStar(require("./WebhookDeliveryResponse.js"), exports);
 __exportStar(require("./WebhookDeliveryStatsResponse.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.0.14";
+export declare const SDK_VERSION = "1.0.16";

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.14";
+exports.SDK_VERSION = "1.0.16";

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.14",
-        "User-Agent": "agentphone/1.0.14",
+        "X-Fern-SDK-Version": "1.0.16",
+        "User-Agent": "agentphone/1.0.16",
         "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/requests/CreateAgentRequest.d.mts

@@ -1,3 +1,4 @@
+import type * as AgentPhone from "../../../../index.mjs";
 /**
  * @example
  *     {
@@ -17,7 +18,11 @@ export interface CreateAgentRequest {
     beginMessage?: string | null;
     voice?: string | null;
     transferNumber?: string | null;
+    /** Hosted-mode only. User-defined function tools the agent can call during a call (look up a record, save call notes, etc.). Each points at your HTTPS endpoint; the voice provider invokes it and feeds the JSON response back to the agent. Ignored in webhook mode. Maximum 20 tools. */
+    customTools?: AgentPhone.CustomToolParam[] | null;
     voicemailMessage?: string | null;
+    callScreeningIdentity?: string | null;
+    callScreeningPurpose?: string | null;
     /** Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency). */
     sttMode?: CreateAgentRequest.SttMode;
     /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */

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

@@ -1,3 +1,4 @@
+import type * as AgentPhone from "../../../../index.mjs";
 /**
  * @example
  *     {
@@ -18,7 +19,11 @@ export interface UpdateAgentRequest {
     beginMessage?: string | null;
     voice?: string | null;
     transferNumber?: string | null;
+    /** Hosted-mode only. User-defined function tools the agent can call during a call. Replaces the full set on each update; send [] to clear all tools, or omit to leave unchanged. Ignored in webhook mode. Maximum 20 tools. */
+    customTools?: AgentPhone.CustomToolParam[] | null;
     voicemailMessage?: string | null;
+    callScreeningIdentity?: string | null;
+    callScreeningPurpose?: string | null;
     /** Speech-to-text mode. 'fast' optimizes for latency, 'accurate' optimizes for transcription accuracy (~200ms additional latency). */
     sttMode?: UpdateAgentRequest.SttMode;
     /** Background ambience to mask synthetic silence between turns. 'none' disables; 'office', 'coffee-shop', 'outdoor' enable a quiet bed. */

package/dist/esm/api/resources/calls/client/requests/CreateOutboundCallRequest.d.mts

@@ -22,4 +22,8 @@ export interface CreateOutboundCallRequest {
     systemPrompt?: string | null;
     /** Optional per-call dynamic variables. Values are substituted into ``{{var_name}}`` placeholders in the agent's system prompt and initial greeting at call time. Requires either ``systemPrompt`` or a hosted-mode agent. */
     variables?: Record<string, string | null> | null;
+    /** For outbound calls that hit an automated call screener (e.g. iOS 26 Call Screening or Android Call Screen): the identity the agent gives when asked who is calling. Overrides the agent's stored default for this call. Both identity and purpose are required to enable screening; if only a purpose is set, the agent's name is used. */
+    callScreeningIdentity?: string | null;
+    /** For outbound calls that hit an automated call screener: the purpose the agent gives when asked why it is calling. Overrides the agent's stored default for this call. */
+    callScreeningPurpose?: string | null;
 }

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

@@ -44,6 +44,26 @@ export declare class ContactsClient {
      */
     createContact(request: AgentPhone.CreateContactRequest, requestOptions?: ContactsClient.RequestOptions): core.HttpResponsePromise<AgentPhone.ContactResponse>;
     private __createContact;
+    /**
+     * Check which messaging channels a phone number supports, without sending
+     * a message.
+     *
+     * Runs a live check (typically 1-2 seconds), so the result reflects the
+     * number right now. Capabilities can still change by the time you send.
+     * Requires at least one active iMessage-capable number on the account.
+     *
+     * @param {AgentPhone.GetContactCapabilitiesV1ContactsCapabilitiesGetRequest} request
+     * @param {ContactsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.contacts.getContactCapabilities({
+     *         phone_number: "phone_number"
+     *     })
+     */
+    getContactCapabilities(request: AgentPhone.GetContactCapabilitiesV1ContactsCapabilitiesGetRequest, requestOptions?: ContactsClient.RequestOptions): core.HttpResponsePromise<AgentPhone.ContactCapabilitiesResponse>;
+    private __getContactCapabilities;
     /**
      * Get a single contact by ID.
      *

package/dist/esm/api/resources/contacts/client/Client.mjs

@@ -142,6 +142,68 @@ export class ContactsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v1/contacts");
         });
     }
+    /**
+     * Check which messaging channels a phone number supports, without sending
+     * a message.
+     *
+     * Runs a live check (typically 1-2 seconds), so the result reflects the
+     * number right now. Capabilities can still change by the time you send.
+     * Requires at least one active iMessage-capable number on the account.
+     *
+     * @param {AgentPhone.GetContactCapabilitiesV1ContactsCapabilitiesGetRequest} request
+     * @param {ContactsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentPhone.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.contacts.getContactCapabilities({
+     *         phone_number: "phone_number"
+     *     })
+     */
+    getContactCapabilities(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getContactCapabilities(request, requestOptions));
+    }
+    __getContactCapabilities(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { phone_number: phoneNumber } = request;
+            const _queryParams = {
+                phone_number: phoneNumber,
+            };
+            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/contacts/capabilities"),
+                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/contacts/capabilities");
+        });
+    }
     /**
      * Get a single contact by ID.
      *

package/dist/esm/api/resources/contacts/client/requests/GetContactCapabilitiesV1ContactsCapabilitiesGetRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         phone_number: "phone_number"
+ *     }
+ */
+export interface GetContactCapabilitiesV1ContactsCapabilitiesGetRequest {
+    /** Phone number to check (E.164 preferred; URL-encode + as %2B) */
+    phone_number: string;
+}

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

@@ -1,5 +1,6 @@
 export type { CreateContactRequest } from "./CreateContactRequest.mjs";
 export type { DeleteContactV1ContactsContactIdDeleteRequest } from "./DeleteContactV1ContactsContactIdDeleteRequest.mjs";
+export type { GetContactCapabilitiesV1ContactsCapabilitiesGetRequest } from "./GetContactCapabilitiesV1ContactsCapabilitiesGetRequest.mjs";
 export type { GetContactV1ContactsContactIdGetRequest } from "./GetContactV1ContactsContactIdGetRequest.mjs";
 export type { ListContactsV1ContactsGetRequest } from "./ListContactsV1ContactsGetRequest.mjs";
 export type { UpdateContactRequest } from "./UpdateContactRequest.mjs";