agentphone 1.0.14 → 1.0.16

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

@@ -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/esm/api/types/CustomToolParam.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+export var CustomToolParam;
+(function (CustomToolParam) {
+    /** HTTP method. Defaults to POST. */
+    CustomToolParam.Method = {
+        Get: "GET",
+        Post: "POST",
+    };
+})(CustomToolParam || (CustomToolParam = {}));

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

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

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

@@ -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/esm/api/types/OrganizationType.mjs

@@ -0,0 +1,11 @@
+// This file was auto-generated by Fern from our API Definition.
+export const OrganizationType = {
+    SoleProprietor: "sole_proprietor",
+    PrivateCorporation: "private_corporation",
+    PublicCorporation: "public_corporation",
+    Llc: "llc",
+    Partnership: "partnership",
+    NonProfit: "non_profit",
+    CoOp: "co_op",
+    Government: "government",
+};

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

@@ -1,8 +1,7 @@
-import type * as AgentPhone from "../index.mjs";
 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/esm/api/types/ReplyToInConversation.d.mts

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

package/dist/esm/api/types/ReplyToInConversation.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,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/esm/api/types/UseCase.d.mts

@@ -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/esm/api/types/UseCase.mjs

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+export const 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/esm/api/types/Volume.d.mts

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

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

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+export const Volume = {
+    Low: "low",
+    High: "high",
+};

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

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

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

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

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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

package/reference.md

@@ -1902,6 +1902,76 @@ await client.contacts.createContact({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">getContactCapabilities</a>({ ...params }) -> AgentPhone.ContactCapabilitiesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contacts.getContactCapabilities({
+    phone_number: "phone_number"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetContactCapabilitiesV1ContactsCapabilitiesGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2247,14 +2317,16 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-Update conversation metadata (state).
+Update a conversation.
 
-Use this to store custom context for AI agents:
-- Customer information (name, account ID)
-- Business context (order ID, ticket number)
-- Session state (current topic, preferences)
+- `metadata`: store custom context for AI agents (customer info, order/ticket
+  ids, session state). Replaces the stored object; surfaced in webhook
+  payloads as `conversationState`.
+- `group_name`: rename a group conversation (iMessage groups only). Also
+  renames the underlying iMessage thread.
 
-The metadata is included in webhook payloads as `conversationState`.
+Only the fields you include are changed: a rename-only PATCH leaves metadata
+untouched, and vice versa.
 </dd>
 </dl>
 </dd>
@@ -3575,7 +3647,6 @@ To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requir
 
 ```typescript
 await client.messages.sendMessage({
-    to_number: "to_number",
     body: "body"
 });
 
@@ -3880,6 +3951,79 @@ await client.contactCards.deleteContactCard({
 </details>
 
 ## Registration
+<details><summary><code>client.registration.<a href="/src/api/resources/registration/client/Client.ts">getRegistrationStatus</a>({ ...params }) -> AgentPhone.CampaignStatusResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Check the status of your A2P 10DLC registration.
+
+### Sub-account status
+
+To check the registration status of a sub-account, pass the `X-Sub-Account-Id` header with the sub-account ID returned from `POST /v1/register`.
+
+### Possible statuses
+
+- `none` -- No registration submitted.
+- `pending` -- Registration is under review.
+- `approved` -- Registration approved. Your account is ready to send messages.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.registration.getRegistrationStatus();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetRegistrationStatusV1RegisterStatusGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `RegistrationClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.registration.<a href="/src/api/resources/registration/client/Client.ts">registerA2P</a>({ ...params }) -> AgentPhone.RegistrationResponse</code></summary>
 <dl>
 <dd>
@@ -3899,15 +4043,18 @@ US carriers require 10DLC registration before your AI agent can send text messag
 ### How it works
 
 1. Submit your registration details via this endpoint
-2. We validate your submission and flag any issues (RED = blocked, YELLOW = warning)
-3. On success, you receive a Stripe payment URL to pay the one-time registration fee
-4. After payment, we submit your registration to the carriers on your behalf
-5. Carrier approval typically takes 7-10 business days
+2. A one-time $25 registration fee is deducted from your account balance
+3. We submit your registration to the carriers on your behalf
+4. Carrier approval typically takes 7-10 business days
 
 ### Registration types
 
-- **`sole_proprietor`** — For individuals or small businesses. Simpler requirements, fewer fields.
-- **`standard_brand`** — For established businesses. Requires `business_name`, `privacy_policy_url`, `terms_of_service_url`, `sample_message_1`, and `sample_message_2`.
+- **`sole_proprietor`** -- For individuals or small businesses. Simpler requirements, fewer fields.
+- **`standard_brand`** -- For established businesses. Requires `business_name`, `organization_type`, `ein`, `privacy_policy_url`, `terms_of_service_url`.
+
+### Sub-accounts
+
+Parent accounts can set `create_sub_account: true` (the default) to create a dedicated sub-account for each registration. This lets you manage multiple campaigns independently. The $25 fee is always charged to the parent account.
 
 ### Opt-in image
 
@@ -3915,7 +4062,7 @@ US carriers require 10DLC registration before your AI agent can send text messag
 
 ### Re-submitting
 
-If you've already submitted but haven't completed payment, calling this endpoint again returns the payment URL without re-sending the registration email.
+If your previous registration was rejected, you can call this endpoint again to re-register.
 </dd>
 </dl>
 </dd>
@@ -3931,7 +4078,7 @@ If you've already submitted but haven't completed payment, calling this endpoint
 
 ```typescript
 await client.registration.registerA2P({
-    registration_type: "registration_type",
+    registration_type: "sole_proprietor",
     first_name: "first_name",
     last_name: "last_name",
     email: "email",
@@ -3940,7 +4087,10 @@ await client.registration.registerA2P({
     city: "city",
     state: "state",
     zip_code: "zip_code",
-    use_case_description: "use_case_description",
+    description: "description",
+    use_cases: ["account_notification"],
+    message_samples: ["message_samples"],
+    consent_flow: "consent_flow",
     opt_in_image_url: "opt_in_image_url"
 });
 
@@ -3979,7 +4129,7 @@ await client.registration.registerA2P({
 </details>
 
 ## SubAccounts
-<details><summary><code>client.subAccounts.<a href="/src/api/resources/subAccounts/client/Client.ts">listSubAccounts</a>() -> unknown</code></summary>
+<details><summary><code>client.subAccounts.<a href="/src/api/resources/subAccounts/client/Client.ts">listSubAccounts</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -4008,6 +4158,14 @@ await client.subAccounts.listSubAccounts();
 <dl>
 <dd>
 
+**request:** `AgentPhone.ListSubAccountsV1SubAccountsGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `SubAccountsClient.RequestOptions` 
     
 </dd>

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

@@ -1,6 +0,0 @@
-export interface FieldWarning {
-    field: string;
-    tier: string;
-    message: string;
-    suggestion: string;
-}

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

@@ -1,6 +0,0 @@
-export interface FieldWarning {
-    field: string;
-    tier: string;
-    message: string;
-    suggestion: string;
-}