agentphone 1.0.0 → 1.0.3

package/reference.md

@@ -12,7 +12,7 @@
 <dl>
 <dd>
 
-List all agents for this project.
+List all agents for this account.
 </dd>
 </dl>
 </dd>
@@ -282,7 +282,7 @@ await client.agents.deleteAgent({
 Update an agent's configuration.
 
 Use this to change voice mode, system prompt, greeting, or voice.
-Switching voiceMode to "hosted" re-provisions the Retell agent with built-in LLM.
+Switching voiceMode to "hosted" re-provisions the voice agent with built-in LLM.
 </dd>
 </dl>
 </dd>
@@ -349,7 +349,7 @@ await client.agents.updateAgent({
 
 Attach an existing phone number to an agent.
 
-The number must belong to the same project and not be released.
+The number must belong to the same account and not be released.
 </dd>
 </dl>
 </dd>
@@ -399,6 +399,74 @@ await client.agents.attachNumberToAgent({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">detachNumberFromAgent</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Detach a phone number from an agent (sets agentId to null).
+
+The number remains active and can be re-attached to any agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.detachNumberFromAgent({
+    agent_id: "agent_id",
+    number_id: "number_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.DetachNumberFromAgentV1AgentsAgentIdNumbersNumberIdDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -546,7 +614,7 @@ await client.agents.listAgentCalls({
 <dl>
 <dd>
 
-List all phone numbers for this project.
+List all phone numbers for this account.
 </dd>
 </dl>
 </dd>
@@ -818,7 +886,7 @@ await client.numbers.deleteNumber({
 <dl>
 <dd>
 
-Get the webhook configuration for this project.
+Get the master webhook configuration for this account.
 </dd>
 </dl>
 </dd>
@@ -873,7 +941,7 @@ await client.webhooks.getWebhook();
 <dl>
 <dd>
 
-Register or update the webhook URL for this project.
+Register or update the webhook URL for this account.
 
 If a webhook already exists, it will be updated.
 A new secret is generated each time.
@@ -944,7 +1012,7 @@ await client.webhooks.createOrUpdateWebhook({
 <dl>
 <dd>
 
-Remove the webhook for this project.
+Remove the master webhook for this account.
 </dd>
 </dl>
 </dd>
@@ -987,7 +1055,7 @@ await client.webhooks.deleteWebhook();
 </dl>
 </details>
 
-<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">listDeliveries</a>({ ...params }) -> AgentPhone.WebhookDeliveryResponse[]</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">listDeliveries</a>({ ...params }) -> AgentPhone.PaginatedDeliveriesResponse</code></summary>
 <dl>
 <dd>
 
@@ -999,7 +1067,7 @@ await client.webhooks.deleteWebhook();
 <dl>
 <dd>
 
-Get recent webhook delivery attempts.
+Get paginated webhook delivery attempts for all account webhooks.
 </dd>
 </dl>
 </dd>
@@ -1050,7 +1118,7 @@ await client.webhooks.listDeliveries();
 </dl>
 </details>
 
-<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">testWebhook</a>() -> unknown</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">deliveryStats</a>({ ...params }) -> AgentPhone.WebhookDeliveryStatsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1062,9 +1130,70 @@ await client.webhooks.listDeliveries();
 <dl>
 <dd>
 
-Send a test webhook to verify the endpoint is working.
+Aggregated delivery stats for the account's webhooks over the last N hours.
+</dd>
+</dl>
+</dd>
+</dl>
 
-Sends a fake message payload to the configured URL.
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.webhooks.deliveryStats();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.DeliveryStatsV1WebhooksDeliveriesStatsGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">allTimeStats</a>() -> AgentPhone.AllTimeStatsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lightweight all-time delivery counts using indexed COUNT queries.
 </dd>
 </dl>
 </dd>
@@ -1079,7 +1208,7 @@ Sends a fake message payload to the configured URL.
 <dd>
 
 ```typescript
-await client.webhooks.testWebhook();
+await client.webhooks.allTimeStats();
 
 ```
 </dd>
@@ -1107,8 +1236,7 @@ await client.webhooks.testWebhook();
 </dl>
 </details>
 
-## Conversations
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">listConversations</a>({ ...params }) -> AgentPhone.AppRoutesConversationsConversationListResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">testWebhook</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -1120,9 +1248,11 @@ await client.webhooks.testWebhook();
 <dl>
 <dd>
 
-List all conversations for this project.
+Send a test webhook to verify the endpoint is working.
 
-Sorted by most recent activity (lastMessageAt desc).
+Sends a fake message payload to the configured URL.
+Pass ?agentId=... to control which agent appears in the payload;
+otherwise the first agent in the account is used.
 </dd>
 </dl>
 </dd>
@@ -1137,7 +1267,7 @@ Sorted by most recent activity (lastMessageAt desc).
 <dd>
 
 ```typescript
-await client.conversations.listConversations();
+await client.webhooks.testWebhook();
 
 ```
 </dd>
@@ -1153,7 +1283,7 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListConversationsV1ConversationsGetRequest` 
+**request:** `AgentPhone.TestWebhookV1WebhooksTestPostRequest` 
     
 </dd>
 </dl>
@@ -1161,7 +1291,7 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1173,7 +1303,8 @@ await client.conversations.listConversations();
 </dl>
 </details>
 
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
+## AgentWebhooks
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">getAgentWebhook</a>({ ...params }) -> AgentPhone.WebhookResponse | null</code></summary>
 <dl>
 <dd>
 
@@ -1185,7 +1316,7 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-Get a conversation with its recent messages.
+Get the webhook configuration for a specific agent.
 </dd>
 </dl>
 </dd>
@@ -1200,8 +1331,8 @@ Get a conversation with its recent messages.
 <dd>
 
 ```typescript
-await client.conversations.getConversation({
-    conversation_id: "conversation_id"
+await client.agentWebhooks.getAgentWebhook({
+    agent_id: "agent_id"
 });
 
 ```
@@ -1218,7 +1349,7 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetConversationV1ConversationsConversationIdGetRequest` 
+**request:** `AgentPhone.GetAgentWebhookV1AgentsAgentIdWebhookGetRequest` 
     
 </dd>
 </dl>
@@ -1226,7 +1357,7 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1238,7 +1369,7 @@ await client.conversations.getConversation({
 </dl>
 </details>
 
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">updateConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">createOrUpdateAgentWebhook</a>({ ...params }) -> AgentPhone.WebhookResponse</code></summary>
 <dl>
 <dd>
 
@@ -1250,14 +1381,9 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-Update conversation metadata (state).
-
-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)
+Register or update a webhook URL for a specific agent.
 
-The metadata is included in webhook payloads as `conversationState`.
+When set, this agent's events are delivered here instead of the account default webhook.
 </dd>
 </dl>
 </dd>
@@ -1272,8 +1398,11 @@ The metadata is included in webhook payloads as `conversationState`.
 <dd>
 
 ```typescript
-await client.conversations.updateConversation({
-    conversation_id: "conversation_id"
+await client.agentWebhooks.createOrUpdateAgentWebhook({
+    agent_id: "agent_id",
+    body: {
+        url: "url"
+    }
 });
 
 ```
@@ -1290,7 +1419,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-**request:** `AgentPhone.UpdateConversationRequest` 
+**request:** `AgentPhone.CreateOrUpdateAgentWebhookV1AgentsAgentIdWebhookPostRequest` 
     
 </dd>
 </dl>
@@ -1298,7 +1427,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1310,7 +1439,7 @@ await client.conversations.updateConversation({
 </dl>
 </details>
 
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversationMessages</a>({ ...params }) -> AgentPhone.MessagesListResponse</code></summary>
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">deleteAgentWebhook</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -1322,9 +1451,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-Get paginated messages for a conversation.
-
-Use before/after for cursor-based pagination.
+Remove the webhook for a specific agent.
 </dd>
 </dl>
 </dd>
@@ -1339,8 +1466,8 @@ Use before/after for cursor-based pagination.
 <dd>
 
 ```typescript
-await client.conversations.getConversationMessages({
-    conversation_id: "conversation_id"
+await client.agentWebhooks.deleteAgentWebhook({
+    agent_id: "agent_id"
 });
 
 ```
@@ -1357,7 +1484,7 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest` 
+**request:** `AgentPhone.DeleteAgentWebhookV1AgentsAgentIdWebhookDeleteRequest` 
     
 </dd>
 </dl>
@@ -1365,7 +1492,7 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1377,8 +1504,7 @@ await client.conversations.getConversationMessages({
 </dl>
 </details>
 
-## Calls
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCalls</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">listAgentDeliveries</a>({ ...params }) -> AgentPhone.WebhookDeliveryResponse[]</code></summary>
 <dl>
 <dd>
 
@@ -1390,7 +1516,7 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-List all calls for this project.
+Get recent webhook delivery attempts for a specific agent's webhook.
 </dd>
 </dl>
 </dd>
@@ -1405,7 +1531,9 @@ List all calls for this project.
 <dd>
 
 ```typescript
-await client.calls.listCalls();
+await client.agentWebhooks.listAgentDeliveries({
+    agent_id: "agent_id"
+});
 
 ```
 </dd>
@@ -1421,7 +1549,7 @@ await client.calls.listCalls();
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListCallsV1CallsGetRequest` 
+**request:** `AgentPhone.ListAgentDeliveriesV1AgentsAgentIdWebhookDeliveriesGetRequest` 
     
 </dd>
 </dl>
@@ -1429,7 +1557,7 @@ await client.calls.listCalls();
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1441,7 +1569,7 @@ await client.calls.listCalls();
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">createOutboundCall</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">testAgentWebhook</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -1453,18 +1581,7 @@ await client.calls.listCalls();
 <dl>
 <dd>
 
-Initiate an outbound call.
-
-This endpoint allows you to programmatically make phone calls from your agent
-to any phone number. The call will use the agent's assigned phone number as the
-caller ID.
-
-Flow:
-1. Validates the agent belongs to your project and has a phone number
-2. Initiates a call via Twilio from the agent's number to the destination
-3. When recipient answers, speaks the initial greeting (if provided)
-4. Listens for recipient's speech and sends to your webhook
-5. Continues conversation using your webhook responses
+Send a test webhook to the agent's webhook endpoint.
 </dd>
 </dl>
 </dd>
@@ -1479,9 +1596,8 @@ Flow:
 <dd>
 
 ```typescript
-await client.calls.createOutboundCall({
-    agentId: "agentId",
-    toNumber: "toNumber"
+await client.agentWebhooks.testAgentWebhook({
+    agent_id: "agent_id"
 });
 
 ```
@@ -1498,7 +1614,7 @@ await client.calls.createOutboundCall({
 <dl>
 <dd>
 
-**request:** `AgentPhone.CreateOutboundCallRequest` 
+**request:** `AgentPhone.TestAgentWebhookV1AgentsAgentIdWebhookTestPostRequest` 
     
 </dd>
 </dl>
@@ -1506,7 +1622,7 @@ await client.calls.createOutboundCall({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1518,7 +1634,8 @@ await client.calls.createOutboundCall({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">getCall</a>({ ...params }) -> unknown</code></summary>
+## Contacts
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">listContacts</a>({ ...params }) -> AgentPhone.ContactListResponse</code></summary>
 <dl>
 <dd>
 
@@ -1530,7 +1647,9 @@ await client.calls.createOutboundCall({
 <dl>
 <dd>
 
-Get a specific call with its transcripts.
+List all contacts for this account.
+
+Optional `search` query filters by name or phone number (case-insensitive contains).
 </dd>
 </dl>
 </dd>
@@ -1545,9 +1664,7 @@ Get a specific call with its transcripts.
 <dd>
 
 ```typescript
-await client.calls.getCall({
-    call_id: "call_id"
-});
+await client.contacts.listContacts();
 
 ```
 </dd>
@@ -1563,7 +1680,7 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetCallV1CallsCallIdGetRequest` 
+**request:** `AgentPhone.ListContactsV1ContactsGetRequest` 
     
 </dd>
 </dl>
@@ -1571,7 +1688,7 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1583,7 +1700,7 @@ await client.calls.getCall({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCallsForNumber</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">createContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -1595,7 +1712,10 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-List all calls for a specific phone number.
+Create a new contact.
+
+Phone number is normalized to E.164 format. Returns 409 if a contact
+with this phone number already exists for the project.
 </dd>
 </dl>
 </dd>
@@ -1610,8 +1730,9 @@ List all calls for a specific phone number.
 <dd>
 
 ```typescript
-await client.calls.listCallsForNumber({
-    number_id: "number_id"
+await client.contacts.createContact({
+    phoneNumber: "phoneNumber",
+    name: "name"
 });
 
 ```
@@ -1628,7 +1749,7 @@ await client.calls.listCallsForNumber({
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListCallsForNumberV1NumbersNumberIdCallsGetRequest` 
+**request:** `AgentPhone.CreateContactRequest` 
     
 </dd>
 </dl>
@@ -1636,7 +1757,7 @@ await client.calls.listCallsForNumber({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1648,8 +1769,7 @@ await client.calls.listCallsForNumber({
 </dl>
 </details>
 
-## Usage
-<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">getUsage</a>() -> AgentPhone.UsageResponse</code></summary>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">getContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -1661,13 +1781,7 @@ await client.calls.listCallsForNumber({
 <dl>
 <dd>
 
-Get usage statistics for the current project.
-
-Returns:
-- Phone number limits (used/limit/remaining)
-- Message statistics (total, last 24h, last 7 days)
-- Call statistics (total, last 24h, last 7 days)
-- Webhook delivery statistics
+Get a single contact by ID.
 </dd>
 </dl>
 </dd>
@@ -1682,7 +1796,9 @@ Returns:
 <dd>
 
 ```typescript
-await client.usage.getUsage();
+await client.contacts.getContact({
+    contact_id: "contact_id"
+});
 
 ```
 </dd>
@@ -1698,7 +1814,1233 @@ await client.usage.getUsage();
 <dl>
 <dd>
 
-**requestOptions:** `UsageClient.RequestOptions` 
+**request:** `AgentPhone.GetContactV1ContactsContactIdGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">deleteContact</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Delete a contact.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contacts.deleteContact({
+    contact_id: "contact_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.DeleteContactV1ContactsContactIdDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">updateContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Update a contact's fields.
+
+If phoneNumber is updated, it's re-normalized and checked for uniqueness (409 on conflict).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contacts.updateContact({
+    contact_id: "contact_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.UpdateContactRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Conversations
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">listConversations</a>({ ...params }) -> AgentPhone.AppRoutesConversationsConversationListResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List all conversations for this account.
+
+Sorted by most recent activity (lastMessageAt desc).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.listConversations();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.ListConversationsV1ConversationsGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get a conversation with its recent messages.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.getConversation({
+    conversation_id: "conversation_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetConversationV1ConversationsConversationIdGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">updateConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Update conversation metadata (state).
+
+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)
+
+The metadata is included in webhook payloads as `conversationState`.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.updateConversation({
+    conversation_id: "conversation_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.UpdateConversationRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversationMessages</a>({ ...params }) -> AgentPhone.MessagesListResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get paginated messages for a conversation.
+
+Use before/after for cursor-based pagination.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.getConversationMessages({
+    conversation_id: "conversation_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Calls
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCalls</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List all calls for this account.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.listCalls();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.ListCallsV1CallsGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">createOutboundCall</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Initiate an outbound call.
+
+This endpoint allows you to programmatically make phone calls from your agent
+to any phone number. Use `fromNumberId` to pick which of the agent's numbers
+to use as caller ID; if omitted, the first assigned number is used.
+
+Flow:
+1. Validates the agent belongs to your account and has a phone number
+2. Initiates a call from the agent's number to the destination
+3. When recipient answers, speaks the initial greeting (if provided)
+4. Listens for recipient's speech and sends to your webhook
+5. Continues conversation using your webhook responses
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.createOutboundCall({
+    agentId: "agentId",
+    toNumber: "toNumber"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.CreateOutboundCallRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">createWebCall</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Create a browser-based web call.
+
+Returns an access token that your frontend passes to the AgentPhone Web SDK
+(`agentphone-web-sdk`) to start the call in the browser. The token
+expires 30 seconds after creation.
+
+Flow:
+1. Validates the agent belongs to your account
+2. Creates a web call and returns an access token
+3. Your client calls `webClient.startCall({ accessToken })` to connect
+4. Call lifecycle (transcripts, webhooks) works the same as phone calls
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.createWebCall({
+    agentId: "agentId"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.CreateWebCallRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">getCall</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get a specific call with its transcripts.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.getCall({
+    call_id: "call_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetCallV1CallsCallIdGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">getCallTranscript</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get the full transcript for a call.
+
+Returns the complete, ordered transcript regardless of the webhook
+contextLimit setting.  Each entry contains the user utterance and
+the corresponding agent response (when available).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.getCallTranscript({
+    call_id: "call_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetCallTranscriptV1CallsCallIdTranscriptGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">streamCallTranscript</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Stream a call's transcript via Server-Sent Events.
+
+On connect the server replays all existing transcript turns from the
+database, then streams new turns in real time as they arrive from the
+voice provider.  A ``: heartbeat`` comment is sent every 15 s to keep
+proxies alive.  The stream closes after sending an ``ended`` event
+when the call completes (or immediately after replay if the call has
+already ended).
+
+Works for both live and completed calls — same URL either way.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.streamCallTranscript({
+    call_id: "call_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.StreamCallTranscriptV1CallsCallIdTranscriptStreamGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCallsForNumber</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List all calls for a specific phone number.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.listCallsForNumber({
+    number_id: "number_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.ListCallsForNumberV1NumbersNumberIdCallsGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Usage
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">getUsage</a>() -> AgentPhone.UsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get usage statistics for the current account.
+
+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
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.usage.getUsage();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsageClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">getDailyUsage</a>({ ...params }) -> AgentPhone.DailyUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get daily usage breakdown for the last N days (up to 365).
+Returns per-day counts of messages, calls, and webhook deliveries.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.usage.getDailyUsage();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetDailyUsageV1UsageDailyGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsageClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.usage.<a href="/src/api/resources/usage/client/Client.ts">getMonthlyUsage</a>({ ...params }) -> AgentPhone.MonthlyUsageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get monthly usage aggregation for the last N months.
+Returns per-month totals of messages, calls, and webhook deliveries.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.usage.getMonthlyUsage();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetMonthlyUsageV1UsageMonthlyGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsageClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Messages
+<details><summary><code>client.messages.<a href="/src/api/resources/messages/client/Client.ts">sendMessage</a>({ ...params }) -> AgentPhone.SendMessageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Send an outbound message (SMS or iMessage) via the provider assigned to the number.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.messages.sendMessage({
+    agent_id: "agent_id",
+    to_number: "to_number",
+    body: "body"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.SendMessageRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.messages.<a href="/src/api/resources/messages/client/Client.ts">sendReaction</a>({ ...params }) -> AgentPhone.SendReactionResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Send a tapback reaction to a message (iMessage only).
+
+Reactions are an iMessage feature. Attempting to react to a message
+sent via an SMS/Twilio number will return a clear error.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.messages.sendReaction({
+    message_id: "message_id",
+    reaction: "reaction"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.SendReactionRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `MessagesClient.RequestOptions` 
     
 </dd>
 </dl>