agentphone 1.0.9 → 1.0.11

package/reference.md

@@ -82,7 +82,7 @@ await client.agentSignup.agentSignUp({
 
 Verify the OTP and atomically provision everything.
 
-Creates: User + Project (+ mirrored Account) + starter hosted Agent + Twilio number
+Creates: User + Project (+ mirrored Account) + starter hosted Agent + phone number
 + first-month charge + API key. Returns the key once — agents must save it.
 </dd>
 </dl>
@@ -150,7 +150,7 @@ await client.agentSignup.agentVerify({
 <dl>
 <dd>
 
-Return available voices for voice calls.
+Return available voices from the configured voice provider.
 </dd>
 </dl>
 </dd>
@@ -873,10 +873,10 @@ await client.numbers.listNumbers();
 Provision a new SMS-enabled phone number.
 
 1. Check number limit (lifetime limit)
-2. Search Twilio for available numbers
+2. Search the account's configured SMS provider for available numbers
 3. Purchase the first available one
-4. Configure webhook URL
-5. Store in our database
+4. Configure messaging and voice routing
+5. Store the number in our database
 </dd>
 </dl>
 </dd>
@@ -1009,7 +1009,7 @@ await client.numbers.getMessages({
 Release (delete) a phone number.
 
 This will:
-1. Release the number from Twilio (number goes back to Twilio's pool)
+1. Release the number from its upstream provider when supported
 2. Mark the number as "released" in the database
 3. Keep all messages and conversation history (for audit purposes)
 
@@ -2175,6 +2175,7 @@ await client.contacts.updateContact({
 List all conversations for this account.
 
 Sorted by most recent activity (lastMessageAt desc).
+Sorted by most recent activity.
 </dd>
 </dl>
 </dd>
@@ -2494,6 +2495,144 @@ await client.conversations.sendTypingIndicator({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.conversations.<a href="/src/api/resources/conversations/client/Client.ts">setChatBackground</a>({ ...params }) -> AgentPhone.SetBackgroundResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Set a custom wallpaper for the chat (iMessage only).
+
+Customer sends `image_url`; we fetch (≤10MB, JPEG/PNG/GIF/WebP/HEIC),
+validate, and forward as multipart to the iMessage provider. Idempotent —
+re-setting replaces. Recipients on iOS < 18 fall back to the default
+silently.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.setChatBackground({
+    conversation_id: "conversation_id",
+    image_url: "https://example.com/wallpaper.jpg"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.SetBackgroundRequest` 
+    
+</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">removeChatBackground</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Clear the custom wallpaper for the chat (iMessage only).
+
+Idempotent: deleting a default-background chat returns 204 (no-op).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.conversations.removeChatBackground({
+    conversation_id: "conversation_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.RemoveChatBackgroundV1ConversationsConversationIdBackgroundDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ConversationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2775,6 +2914,76 @@ await client.calls.getCall({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.calls.<a href="/src/api/resources/calls/client/Client.ts">endCall</a>({ ...params }) -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Terminate an ongoing call.
+
+Works for both hosted-mode and webhook-mode calls. The call_ended
+webhook from the voice provider updates status/endedAt asynchronously,
+so this endpoint returns the current call as soon as the stop request
+is accepted upstream.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.calls.endCall({
+    call_id: "call_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.EndCallV1CallsCallIdEndPostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `CallsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -3375,8 +3584,8 @@ await client.usage.getUsageByAgent({
 </dl>
 </details>
 
-## Messages
-<details><summary><code>client.messages.<a href="/src/api/resources/messages/client/Client.ts">sendMessage</a>({ ...params }) -> AgentPhone.SendMessageResponse</code></summary>
+## Integrations
+<details><summary><code>client.integrations.<a href="/src/api/resources/integrations/client/Client.ts">supabaseConnect</a>({ ...params }) -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -3388,25 +3597,7 @@ await client.usage.getUsageByAgent({
 <dl>
 <dd>
 
-Send an outbound message (SMS or iMessage) via the provider assigned to the number.
-
-Supports single attachments via `media_url` or multiple attachments via `media_urls`. You may use one or the other, but not both.
-
-### Carousel / multi-image (iMessage)
-
-To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requirements:
-- Each URL must be a **publicly accessible HTTPS link** to an image (JPEG, PNG, GIF, etc.)
-- Minimum 2 URLs, maximum 20
-- `body` must be omitted or empty (text cannot be sent alongside a carousel)
-- Only supported on iMessage-capable lines
-
-### Single attachment
-
-Pass a single URL in `media_url`. The URL must be publicly accessible. Works across all channels.
-
-### Multi-attachment (iMessage)
-
-Some iMessage lines support multiple attachments (images and other file types) via `media_urls`. No minimum count; `body` can be included alongside attachments.
+Exchange a one-time connect code and redirect to Supabase OAuth.
 </dd>
 </dl>
 </dd>
@@ -3421,10 +3612,8 @@ Some iMessage lines support multiple attachments (images and other file types) v
 <dd>
 
 ```typescript
-await client.messages.sendMessage({
-    agent_id: "agent_id",
-    to_number: "to_number",
-    body: "body"
+await client.integrations.supabaseConnect({
+    code: "code"
 });
 
 ```
@@ -3441,7 +3630,7 @@ await client.messages.sendMessage({
 <dl>
 <dd>
 
-**request:** `AgentPhone.SendMessageRequest` 
+**request:** `AgentPhone.SupabaseConnectIntegrationsSupabaseConnectGetRequest` 
     
 </dd>
 </dl>
@@ -3449,7 +3638,7 @@ await client.messages.sendMessage({
 <dl>
 <dd>
 
-**requestOptions:** `MessagesClient.RequestOptions` 
+**requestOptions:** `IntegrationsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3461,7 +3650,7 @@ await client.messages.sendMessage({
 </dl>
 </details>
 
-<details><summary><code>client.messages.<a href="/src/api/resources/messages/client/Client.ts">sendReaction</a>({ ...params }) -> AgentPhone.SendReactionResponse</code></summary>
+<details><summary><code>client.integrations.<a href="/src/api/resources/integrations/client/Client.ts">supabaseConnectCode</a>() -> unknown</code></summary>
 <dl>
 <dd>
 
@@ -3473,10 +3662,7 @@ await client.messages.sendMessage({
 <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.
+Create a short-lived one-time code for initiating the Supabase OAuth flow.
 </dd>
 </dl>
 </dd>
@@ -3491,10 +3677,7 @@ sent via an SMS/Twilio number will return a clear error.
 <dd>
 
 ```typescript
-await client.messages.sendReaction({
-    message_id: "message_id",
-    reaction: "reaction"
-});
+await client.integrations.supabaseConnectCode();
 
 ```
 </dd>
@@ -3510,15 +3693,497 @@ await client.messages.sendReaction({
 <dl>
 <dd>
 
-**request:** `AgentPhone.SendReactionRequest` 
+**requestOptions:** `IntegrationsClient.RequestOptions` 
     
 </dd>
 </dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
 
+<details><summary><code>client.integrations.<a href="/src/api/resources/integrations/client/Client.ts">supabaseStatus</a>() -> unknown</code></summary>
 <dl>
 <dd>
 
-**requestOptions:** `MessagesClient.RequestOptions` 
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.integrations.supabaseStatus();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `IntegrationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.integrations.<a href="/src/api/resources/integrations/client/Client.ts">supabaseToken</a>() -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Get a valid Supabase access token, auto-refreshing if expired.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.integrations.supabaseToken();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `IntegrationsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.integrations.<a href="/src/api/resources/integrations/client/Client.ts">supabaseDisconnect</a>() -> unknown</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.integrations.supabaseDisconnect();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `IntegrationsClient.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.
+
+Attach media by passing public HTTPS URLs in `media_urls`.
+
+### Single attachment
+
+Pass a single-item array in `media_urls`. The URL must be publicly accessible.
+
+### Carousel / multi-image (iMessage)
+
+To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requirements:
+- Each URL must be a **publicly accessible HTTPS link** to an image (JPEG, PNG, GIF, etc.)
+- Minimum 2 URLs, maximum 20
+- `body` must be omitted or empty (text cannot be sent alongside a carousel)
+- Only supported on iMessage-capable lines
+
+> **Deprecation notice:** The `media_url` field (singular) is deprecated and will be removed in a future version. Use `media_urls` (array) instead — even for a single attachment, pass it as `media_urls: ["https://..."]`.
+</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 available only for iMessage messages. Attempting to react
+to an SMS message or another channel that does not support tapbacks
+returns a clear error.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.messages.sendReaction({
+    message_id: "message_id",
+    reaction: "love"
+});
+
+```
+</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>
+
+## ContactCards
+<details><summary><code>client.contactCards.<a href="/src/api/resources/contactCards/client/Client.ts">getContactCard</a>({ ...params }) -> AgentPhone.ContactCardResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Fetch the iMessage contact card set on this number.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contactCards.getContactCard({
+    number_id: "number_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.GetContactCardV1NumbersNumberIdContactCardGetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactCardsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.contactCards.<a href="/src/api/resources/contactCards/client/Client.ts">putContactCard</a>({ ...params }) -> AgentPhone.ContactCardResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Create or replace the iMessage contact card on this number.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contactCards.putContactCard({
+    number_id: "number_id",
+    firstName: "firstName",
+    lastName: "lastName",
+    avatarUrl: "avatarUrl"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.ContactCardWriteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactCardsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.contactCards.<a href="/src/api/resources/contactCards/client/Client.ts">deleteContactCard</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Remove the iMessage contact card from this number.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.contactCards.deleteContactCard({
+    number_id: "number_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AgentPhone.DeleteContactCardV1NumbersNumberIdContactCardDeleteRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ContactCardsClient.RequestOptions` 
     
 </dd>
 </dl>