agentphone 1.0.0 → 1.0.2

package/reference.md

@@ -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>
@@ -818,7 +818,7 @@ await client.numbers.deleteNumber({
 <dl>
 <dd>
 
-Get the webhook configuration for this project.
+Get the master webhook configuration for this project.
 </dd>
 </dl>
 </dd>
@@ -944,7 +944,7 @@ await client.webhooks.createOrUpdateWebhook({
 <dl>
 <dd>
 
-Remove the webhook for this project.
+Remove the master webhook for this project.
 </dd>
 </dl>
 </dd>
@@ -987,7 +987,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 +999,7 @@ await client.webhooks.deleteWebhook();
 <dl>
 <dd>
 
-Get recent webhook delivery attempts.
+Get paginated webhook delivery attempts for all project webhooks.
 </dd>
 </dl>
 </dd>
@@ -1050,7 +1050,125 @@ 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>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Aggregated delivery stats for the project's webhooks over the last N hours.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 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>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.webhooks.allTimeStats();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<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">testWebhook</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -1064,7 +1182,338 @@ await client.webhooks.listDeliveries();
 
 Send a test webhook to verify the endpoint is working.
 
-Sends a fake message payload to the configured URL.
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.webhooks.testWebhook();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.TestWebhookV1WebhooksTestPostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## 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>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get the webhook configuration for a specific agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentWebhooks.getAgentWebhook({
+    agent_id: "agent_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetAgentWebhookV1AgentsAgentIdWebhookGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">createOrUpdateAgentWebhook</a>({ ...params }) -> AgentPhone.WebhookResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentWebhooks.createOrUpdateAgentWebhook({
+    agent_id: "agent_id",
+    body: {
+        url: "url"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.CreateOrUpdateAgentWebhookV1AgentsAgentIdWebhookPostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">deleteAgentWebhook</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Remove the webhook for a specific agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentWebhooks.deleteAgentWebhook({
+    agent_id: "agent_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.DeleteAgentWebhookV1AgentsAgentIdWebhookDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">listAgentDeliveries</a>({ ...params }) -> AgentPhone.WebhookDeliveryResponse[]</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get recent webhook delivery attempts for a specific agent's webhook.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentWebhooks.listAgentDeliveries({
+    agent_id: "agent_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.ListAgentDeliveriesV1AgentsAgentIdWebhookDeliveriesGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentWebhooks.<a href="/src/api/resources/agentWebhooks/client/Client.ts">testAgentWebhook</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Send a test webhook to the agent's webhook endpoint.
 </dd>
 </dl>
 </dd>
@@ -1079,7 +1528,9 @@ Sends a fake message payload to the configured URL.
 <dd>
 
 ```typescript
-await client.webhooks.testWebhook();
+await client.agentWebhooks.testAgentWebhook({
+    agent_id: "agent_id"
+});
 
 ```
 </dd>
@@ -1095,7 +1546,15 @@ await client.webhooks.testWebhook();
 <dl>
 <dd>
 
-**requestOptions:** `WebhooksClient.RequestOptions` 
+**request:** `AgentPhone.TestAgentWebhookV1AgentsAgentIdWebhookTestPostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentWebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1456,12 +1915,12 @@ await client.calls.listCalls();
 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.
+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 project and has a phone number
-2. Initiates a call via Twilio from the agent's number to the destination
+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
@@ -1514,6 +1973,81 @@ await client.calls.createOutboundCall({
 </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 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
+</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>
@@ -1579,6 +2113,75 @@ await client.calls.getCall({
 </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>
@@ -1665,8 +2268,8 @@ 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)
+- 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>
@@ -1706,6 +2309,134 @@ await client.usage.getUsage();
 </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>