agentphone 1.0.2 → 1.0.4

package/reference.md

@@ -1,5 +1,60 @@
 # Reference
 ## Agents
+<details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">listVoices</a>() -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Return available voices from the call provider (Retell).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.listVoices();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">listAgents</a>({ ...params }) -> AgentPhone.AgentListResponse</code></summary>
 <dl>
 <dd>
@@ -12,7 +67,7 @@
 <dl>
 <dd>
 
-List all agents for this project.
+List all agents for this account.
 </dd>
 </dl>
 </dd>
@@ -349,7 +404,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 +454,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 +669,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 +941,7 @@ await client.numbers.deleteNumber({
 <dl>
 <dd>
 
-Get the master webhook configuration for this project.
+Get the master webhook configuration for this account.
 </dd>
 </dl>
 </dd>
@@ -873,7 +996,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 +1067,7 @@ await client.webhooks.createOrUpdateWebhook({
 <dl>
 <dd>
 
-Remove the master webhook for this project.
+Remove the master webhook for this account.
 </dd>
 </dl>
 </dd>
@@ -999,7 +1122,7 @@ await client.webhooks.deleteWebhook();
 <dl>
 <dd>
 
-Get paginated webhook delivery attempts for all project webhooks.
+Get paginated webhook delivery attempts for all account webhooks.
 </dd>
 </dl>
 </dd>
@@ -1062,7 +1185,7 @@ await client.webhooks.listDeliveries();
 <dl>
 <dd>
 
-Aggregated delivery stats for the project's webhooks over the last N hours.
+Aggregated delivery stats for the account's webhooks over the last N hours.
 </dd>
 </dl>
 </dd>
@@ -1184,7 +1307,7 @@ Send a test webhook to verify the endpoint is working.
 
 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 project is used.
+otherwise the first agent in the account is used.
 </dd>
 </dl>
 </dd>
@@ -1315,7 +1438,7 @@ await client.agentWebhooks.getAgentWebhook({
 
 Register or update a webhook URL for a specific agent.
 
-When set, this agent's events are delivered here instead of the project default webhook.
+When set, this agent's events are delivered here instead of the account default webhook.
 </dd>
 </dl>
 </dd>
@@ -1566,8 +1689,8 @@ await client.agentWebhooks.testAgentWebhook({
 </dl>
 </details>
 
-## Conversations
-<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">listConversations</a>({ ...params }) -> AgentPhone.AppRoutesConversationsConversationListResponse</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>
 
@@ -1579,9 +1702,9 @@ await client.agentWebhooks.testAgentWebhook({
 <dl>
 <dd>
 
-List all conversations for this project.
+List all contacts for this account.
 
-Sorted by most recent activity (lastMessageAt desc).
+Optional `search` query filters by name or phone number (case-insensitive contains).
 </dd>
 </dl>
 </dd>
@@ -1596,7 +1719,7 @@ Sorted by most recent activity (lastMessageAt desc).
 <dd>
 
 ```typescript
-await client.conversations.listConversations();
+await client.contacts.listContacts();
 
 ```
 </dd>
@@ -1612,7 +1735,7 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListConversationsV1ConversationsGetRequest` 
+**request:** `AgentPhone.ListContactsV1ContactsGetRequest` 
     
 </dd>
 </dl>
@@ -1620,7 +1743,7 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1632,7 +1755,7 @@ 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>
+<details><summary><code>client.contacts.<a href="/src/api/resources/contacts/client/Client.ts">createContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -1644,7 +1767,10 @@ await client.conversations.listConversations();
 <dl>
 <dd>
 
-Get a conversation with its recent messages.
+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>
@@ -1659,8 +1785,9 @@ Get a conversation with its recent messages.
 <dd>
 
 ```typescript
-await client.conversations.getConversation({
-    conversation_id: "conversation_id"
+await client.contacts.createContact({
+    phoneNumber: "phoneNumber",
+    name: "name"
 });
 
 ```
@@ -1677,7 +1804,7 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetConversationV1ConversationsConversationIdGetRequest` 
+**request:** `AgentPhone.CreateContactRequest` 
     
 </dd>
 </dl>
@@ -1685,7 +1812,7 @@ await client.conversations.getConversation({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1697,7 +1824,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.contacts.<a href="/src/api/resources/contacts/client/Client.ts">getContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -1709,14 +1836,7 @@ 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)
-
-The metadata is included in webhook payloads as `conversationState`.
+Get a single contact by ID.
 </dd>
 </dl>
 </dd>
@@ -1731,8 +1851,8 @@ The metadata is included in webhook payloads as `conversationState`.
 <dd>
 
 ```typescript
-await client.conversations.updateConversation({
-    conversation_id: "conversation_id"
+await client.contacts.getContact({
+    contact_id: "contact_id"
 });
 
 ```
@@ -1749,7 +1869,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-**request:** `AgentPhone.UpdateConversationRequest` 
+**request:** `AgentPhone.GetContactV1ContactsContactIdGetRequest` 
     
 </dd>
 </dl>
@@ -1757,7 +1877,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1769,7 +1889,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.contacts.<a href="/src/api/resources/contacts/client/Client.ts">deleteContact</a>({ ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1781,9 +1901,7 @@ await client.conversations.updateConversation({
 <dl>
 <dd>
 
-Get paginated messages for a conversation.
-
-Use before/after for cursor-based pagination.
+Delete a contact.
 </dd>
 </dl>
 </dd>
@@ -1798,8 +1916,8 @@ Use before/after for cursor-based pagination.
 <dd>
 
 ```typescript
-await client.conversations.getConversationMessages({
-    conversation_id: "conversation_id"
+await client.contacts.deleteContact({
+    contact_id: "contact_id"
 });
 
 ```
@@ -1816,7 +1934,7 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest` 
+**request:** `AgentPhone.DeleteContactV1ContactsContactIdDeleteRequest` 
     
 </dd>
 </dl>
@@ -1824,7 +1942,7 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-**requestOptions:** `ConversationsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1836,8 +1954,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.contacts.<a href="/src/api/resources/contacts/client/Client.ts">updateContact</a>({ ...params }) -> AgentPhone.ContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -1849,7 +1966,9 @@ await client.conversations.getConversationMessages({
 <dl>
 <dd>
 
-List all calls for this project.
+Update a contact's fields.
+
+If phoneNumber is updated, it's re-normalized and checked for uniqueness (409 on conflict).
 </dd>
 </dl>
 </dd>
@@ -1864,7 +1983,9 @@ List all calls for this project.
 <dd>
 
 ```typescript
-await client.calls.listCalls();
+await client.contacts.updateContact({
+    contact_id: "contact_id"
+});
 
 ```
 </dd>
@@ -1880,7 +2001,7 @@ await client.calls.listCalls();
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListCallsV1CallsGetRequest` 
+**request:** `AgentPhone.UpdateContactRequest` 
     
 </dd>
 </dl>
@@ -1888,7 +2009,7 @@ await client.calls.listCalls();
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1900,7 +2021,8 @@ 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>
+## Conversations
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">listConversations</a>({ ...params }) -> AgentPhone.AppRoutesConversationsConversationListResponse</code></summary>
 <dl>
 <dd>
 
@@ -1912,18 +2034,9 @@ 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. Use `fromNumberId` to pick which of the agent's numbers
-to use as caller ID; if omitted, the first assigned number is used.
+List all conversations for this account.
 
-Flow:
-1. Validates the agent belongs to your project 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
+Sorted by most recent activity (lastMessageAt desc).
 </dd>
 </dl>
 </dd>
@@ -1938,10 +2051,7 @@ Flow:
 <dd>
 
 ```typescript
-await client.calls.createOutboundCall({
-    agentId: "agentId",
-    toNumber: "toNumber"
-});
+await client.conversations.listConversations();
 
 ```
 </dd>
@@ -1957,7 +2067,7 @@ await client.calls.createOutboundCall({
 <dl>
 <dd>
 
-**request:** `AgentPhone.CreateOutboundCallRequest` 
+**request:** `AgentPhone.ListConversationsV1ConversationsGetRequest` 
     
 </dd>
 </dl>
@@ -1965,7 +2075,7 @@ await client.calls.createOutboundCall({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ConversationsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1977,7 +2087,7 @@ await client.calls.createOutboundCall({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">createWebCall</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
 <dl>
 <dd>
 
@@ -1989,17 +2099,7 @@ await client.calls.createOutboundCall({
 <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 project
-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
+Get a conversation with its recent messages.
 </dd>
 </dl>
 </dd>
@@ -2014,8 +2114,8 @@ Flow:
 <dd>
 
 ```typescript
-await client.calls.createWebCall({
-    agentId: "agentId"
+await client.conversations.getConversation({
+    conversation_id: "conversation_id"
 });
 
 ```
@@ -2032,7 +2132,7 @@ await client.calls.createWebCall({
 <dl>
 <dd>
 
-**request:** `AgentPhone.CreateWebCallRequest` 
+**request:** `AgentPhone.GetConversationV1ConversationsConversationIdGetRequest` 
     
 </dd>
 </dl>
@@ -2040,7 +2140,7 @@ await client.calls.createWebCall({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ConversationsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2052,7 +2152,7 @@ await client.calls.createWebCall({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">getCall</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">updateConversation</a>({ ...params }) -> AgentPhone.ConversationDetail</code></summary>
 <dl>
 <dd>
 
@@ -2064,7 +2164,14 @@ await client.calls.createWebCall({
 <dl>
 <dd>
 
-Get a specific call with its transcripts.
+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>
@@ -2079,8 +2186,8 @@ Get a specific call with its transcripts.
 <dd>
 
 ```typescript
-await client.calls.getCall({
-    call_id: "call_id"
+await client.conversations.updateConversation({
+    conversation_id: "conversation_id"
 });
 
 ```
@@ -2097,7 +2204,7 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetCallV1CallsCallIdGetRequest` 
+**request:** `AgentPhone.UpdateConversationRequest` 
     
 </dd>
 </dl>
@@ -2105,7 +2212,7 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ConversationsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2117,7 +2224,7 @@ await client.calls.getCall({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">getCallTranscript</a>({ ...params }) -> unknown</code></summary>
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">getConversationMessages</a>({ ...params }) -> AgentPhone.MessagesListResponse</code></summary>
 <dl>
 <dd>
 
@@ -2129,11 +2236,9 @@ await client.calls.getCall({
 <dl>
 <dd>
 
-Get the full transcript for a call.
+Get paginated messages for a conversation.
 
-Returns the complete, ordered transcript regardless of the webhook
-contextLimit setting.  Each entry contains the user utterance and
-the corresponding agent response (when available).
+Use before/after for cursor-based pagination.
 </dd>
 </dl>
 </dd>
@@ -2148,8 +2253,8 @@ the corresponding agent response (when available).
 <dd>
 
 ```typescript
-await client.calls.getCallTranscript({
-    call_id: "call_id"
+await client.conversations.getConversationMessages({
+    conversation_id: "conversation_id"
 });
 
 ```
@@ -2166,7 +2271,7 @@ await client.calls.getCallTranscript({
 <dl>
 <dd>
 
-**request:** `AgentPhone.GetCallTranscriptV1CallsCallIdTranscriptGetRequest` 
+**request:** `AgentPhone.GetConversationMessagesV1ConversationsConversationIdMessagesGetRequest` 
     
 </dd>
 </dl>
@@ -2174,7 +2279,7 @@ await client.calls.getCallTranscript({
 <dl>
 <dd>
 
-**requestOptions:** `CallsClient.RequestOptions` 
+**requestOptions:** `ConversationsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2186,7 +2291,8 @@ await client.calls.getCallTranscript({
 </dl>
 </details>
 
-<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCallsForNumber</a>({ ...params }) -> unknown</code></summary>
+## Calls
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">listCalls</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -2198,7 +2304,7 @@ await client.calls.getCallTranscript({
 <dl>
 <dd>
 
-List all calls for a specific phone number.
+List all calls for this account.
 </dd>
 </dl>
 </dd>
@@ -2213,9 +2319,7 @@ List all calls for a specific phone number.
 <dd>
 
 ```typescript
-await client.calls.listCallsForNumber({
-    number_id: "number_id"
-});
+await client.calls.listCalls();
 
 ```
 </dd>
@@ -2231,7 +2335,7 @@ await client.calls.listCallsForNumber({
 <dl>
 <dd>
 
-**request:** `AgentPhone.ListCallsForNumberV1NumbersNumberIdCallsGetRequest` 
+**request:** `AgentPhone.ListCallsV1CallsGetRequest` 
     
 </dd>
 </dl>
@@ -2251,8 +2355,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.calls.<a href="/src/api/resources/calls/client/Client.ts">createOutboundCall</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -2264,14 +2367,440 @@ await client.calls.listCallsForNumber({
 <dl>
 <dd>
 
-Get usage statistics for the current project.
+Initiate an outbound call.
 
-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>
+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>
@@ -2437,6 +2966,143 @@ await client.usage.getMonthlyUsage();
 </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>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>