@band-ai/rest-client 0.0.117 → 0.0.118

package/reference.md

@@ -1,6 +1,6 @@
 # Reference
-## Agent API/Chats
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">listAgentChats</a>({ ...params }) -> Band.ListAgentChatsResponse</code></summary>
+## Agent API/Contacts
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">respondToAgentContactRequest</a>({ ...params }) -> Band.RespondToAgentContactRequestResponse</code></summary>
 <dl>
 <dd>
 
@@ -12,7 +12,10 @@
 <dl>
 <dd>
 
-Lists chat rooms where the current agent is a participant
+Approve, reject, or cancel a contact request.
+
+- `approve`/`reject`: For requests you RECEIVED (handle = requester's handle)
+- `cancel`: For requests you SENT (handle = recipient's handle)
 </dd>
 </dl>
 </dd>
@@ -27,9 +30,8 @@ Lists chat rooms where the current agent is a participant
 <dd>
 
 ```typescript
-await client.agentApiChats.listAgentChats({
-    page: 1,
-    page_size: 1
+await client.agentApiContacts.respondToAgentContactRequest({
+    action: "approve"
 });
 
 ```
@@ -46,7 +48,7 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-**request:** `Band.ListAgentChatsRequest` 
+**request:** `Band.RespondToAgentContactRequestRequest` 
     
 </dd>
 </dl>
@@ -54,7 +56,7 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChatsClient.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -66,7 +68,7 @@ await client.agentApiChats.listAgentChats({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">createAgentChat</a>({ ...params }) -> Band.CreateAgentChatResponse</code></summary>
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">addAgentContact</a>({ ...params }) -> Band.AddAgentContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -78,7 +80,10 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-Creates a new chat room with the agent as owner
+Resolves handle and sends contact request.
+
+Returns `pending` when a new request is created.
+Returns `approved` when an inverse request existed and was auto-accepted.
 </dd>
 </dl>
 </dd>
@@ -93,8 +98,8 @@ Creates a new chat room with the agent as owner
 <dd>
 
 ```typescript
-await client.agentApiChats.createAgentChat({
-    chat: {}
+await client.agentApiContacts.addAgentContact({
+    handle: "@john"
 });
 
 ```
@@ -111,7 +116,7 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-**request:** `Band.CreateAgentChatRequest` 
+**request:** `Band.AddAgentContactRequest` 
     
 </dd>
 </dl>
@@ -119,7 +124,7 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChatsClient.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -131,7 +136,7 @@ await client.agentApiChats.createAgentChat({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">getAgentChat</a>(id) -> Band.GetAgentChatResponse</code></summary>
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContactRequests</a>({ ...params }) -> Band.ListAgentContactRequestsResponse</code></summary>
 <dl>
 <dd>
 
@@ -143,7 +148,12 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-Returns details of a specific chat room where the agent is a participant
+Returns both received and sent requests with handles and pagination metadata.
+
+- Received requests are always filtered to pending status.
+- Sent requests can be filtered by status using `sent_status` parameter.
+- Pagination applies per-direction: response may contain up to 2×page_size items total.
+- Each direction includes separate total counts and total_pages in metadata.
 </dd>
 </dl>
 </dd>
@@ -158,7 +168,11 @@ Returns details of a specific chat room where the agent is a participant
 <dd>
 
 ```typescript
-await client.agentApiChats.getAgentChat("id");
+await client.agentApiContacts.listAgentContactRequests({
+    page: 1,
+    page_size: 1,
+    sent_status: "pending"
+});
 
 ```
 </dd>
@@ -174,7 +188,7 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-**id:** `string` — Chat Room ID
+**request:** `Band.ListAgentContactRequestsRequest` 
     
 </dd>
 </dl>
@@ -182,7 +196,7 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChatsClient.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -194,8 +208,7 @@ await client.agentApiChats.getAgentChat("id");
 </dl>
 </details>
 
-## Agent API/Context
-<details><summary><code>client.agentApiContext.<a href="/src/api/resources/agentApiContext/client/Client.ts">getAgentChatContext</a>(chat_id, { ...params }) -> Band.GetAgentChatContextResponse</code></summary>
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContacts</a>({ ...params }) -> Band.ListAgentContactsResponse</code></summary>
 <dl>
 <dd>
 
@@ -207,22 +220,7 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-Returns all messages relevant to the agent for execution context/rehydration.
-
-This includes:
-- All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.)
-- All text messages that @mention the agent
-
-Use this endpoint to load the complete context an external agent needs to resume execution.
-
-Messages are returned in chronological order (oldest first).
-
-## Pagination
-
-Use `cursor` + `limit` for cursor-based pagination (recommended). The response
-`metadata` includes `next_cursor` and `has_more`.
-
-`page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+Returns contacts with handles for easy reference.
 </dd>
 </dl>
 </dd>
@@ -237,9 +235,7 @@ Use `cursor` + `limit` for cursor-based pagination (recommended). The response
 <dd>
 
 ```typescript
-await client.agentApiContext.getAgentChatContext("chat_id", {
-    cursor: "cursor",
-    limit: 1,
+await client.agentApiContacts.listAgentContacts({
     page: 1,
     page_size: 1
 });
@@ -258,15 +254,7 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Band.GetAgentChatContextRequest` 
+**request:** `Band.ListAgentContactsRequest` 
     
 </dd>
 </dl>
@@ -274,7 +262,7 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContextClient.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -286,8 +274,7 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 </dl>
 </details>
 
-## Agent API/Events
-<details><summary><code>client.agentApiEvents.<a href="/src/api/resources/agentApiEvents/client/Client.ts">createAgentChatEvent</a>(chat_id, { ...params }) -> Band.CreateAgentChatEventResponse</code></summary>
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">removeAgentContact</a>({ ...params }) -> Band.RemoveAgentContactResponse</code></summary>
 <dl>
 <dd>
 
@@ -299,18 +286,7 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 <dl>
 <dd>
 
-Creates a new event in a chat room.
-
-Events do NOT require mentions - they report what happened rather than directing messages
-at participants. Use this endpoint to record:
-
-- **tool_call**: When the agent invokes a tool
-- **tool_result**: The result returned from a tool execution
-- **thought**: Agent's internal reasoning or thinking process
-- **error**: Error messages and failure notifications
-- **task**: Task-related messages
-
-For text messages with mentions, use POST /agent/chats/{chat_id}/messages instead.
+Removes contact by handle or ID. Both directions of the contact relationship are removed.
 </dd>
 </dl>
 </dd>
@@ -325,12 +301,7 @@ For text messages with mentions, use POST /agent/chats/{chat_id}/messages instea
 <dd>
 
 ```typescript
-await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015c93d04", {
-    event: {
-        content: "Calling send_direct_message_service",
-        message_type: "tool_call"
-    }
-});
+await client.agentApiContacts.removeAgentContact();
 
 ```
 </dd>
@@ -346,15 +317,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Band.CreateAgentChatEventRequest` 
+**request:** `Band.RemoveAgentContactRequest` 
     
 </dd>
 </dl>
@@ -362,7 +325,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiEventsClient.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -374,8 +337,8 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 </dl>
 </details>
 
-## Agent API/Messages
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">listAgentMessages</a>(chat_id, { ...params }) -> Band.ListAgentMessagesResponse</code></summary>
+## Human API/Contacts
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">rejectContactRequest</a>(id) -> Band.RejectContactRequestResponse</code></summary>
 <dl>
 <dd>
 
@@ -387,90 +350,81 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-Returns messages that the agent needs to process, filtered by status.
-
-## Default Behavior (no status param)
-
-Returns all messages that are NOT processed. This is the recommended way to get
-all work the agent should handle, including:
-- New messages (no delivery status yet)
-- Delivered messages (acknowledged but not started)
-- Processing messages (stuck/crashed - supports crash recovery)
-- Failed messages (available for retry)
+Rejects a pending contact request you received.
 
-## Status Filter Reference
+The requester will not be notified of the rejection.
+</dd>
+</dl>
+</dd>
+</dl>
 
-| ?status=     | Returns                                                              | Use Case                    |
-|--------------|----------------------------------------------------------------------|-----------------------------|
-| *(no param)* | Everything NOT processed                                             | Get all work to do          |
-| `pending`    | No status, delivered, or failed without active attempt               | Queue depth (untouched)     |
-| `processing` | Currently being processed                                            | In-flight work              |
-| `processed`  | Successfully completed                                               | Done items                  |
-| `failed`     | Failed only                                                          | Failure backlog             |
-| `all`        | All messages regardless of status                                    | Full history                |
+#### 🔌 Usage
 
-Messages are returned in chronological order (oldest first).
+<dl>
+<dd>
 
-## Pagination
+<dl>
+<dd>
 
-Use `cursor` + `limit` for cursor-based pagination (recommended). The response
-`metadata` includes `next_cursor` and `has_more`. Pass `cursor=<next_cursor>` to
-fetch the next page.
+```typescript
+await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c46015c93d04");
 
-`page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
-Responses using these params include `Deprecation` and `Sunset` headers.
+```
+</dd>
+</dl>
+</dd>
+</dl>
 
-## Workflow
+#### ⚙️ Parameters
 
-After retrieving messages, you must update their processing status:
+<dl>
+<dd>
 
-1. `GET /messages` or `GET /messages/next` → Get work to do
-2. `POST /messages/{id}/processing` → **Required:** Mark as processing before you start
-3. Process the message (reasoning loop, tool calls, etc.)
-4. `POST /messages/{id}/processed` → Mark as done, OR
-   `POST /messages/{id}/failed` → Mark as failed with error message
-5. Repeat
+<dl>
+<dd>
 
-**Important:** Always call `/processing` before starting work. This prevents
-duplicate processing since agents doing reasoning loops will always follow the
-sequence: `/next` → `/processing` → do work → `/processed`.
+**id:** `string` — Contact request ID
+    
+</dd>
+</dl>
 
-## Crash Recovery
+<dl>
+<dd>
 
-If your agent crashes while processing, the message remains in `processing` state.
-When the agent restarts:
-1. Call `GET /messages` (default) - it includes stuck `processing` messages
-2. The stuck message will be returned so you can retry it
-3. Call `/processing` again to reset the attempt timestamp, then continue
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
 </dd>
 </dl>
 </dd>
 </dl>
 
-#### 🔌 Usage
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">removeMyContact</a>({ ...params }) -> Band.RemoveMyContactResponse</code></summary>
 <dl>
 <dd>
 
+#### 📝 Description
+
 <dl>
 <dd>
 
-```typescript
-await client.agentApiMessages.listAgentMessages("chat_id", {
-    status: "pending",
-    cursor: "cursor",
-    limit: 1,
-    page: 1,
-    page_size: 1
-});
+<dl>
+<dd>
 
-```
+Removes a contact by handle or contact record ID.
+
+This is a bidirectional operation — both you and the other party
+will be removed from each other's contact lists.
 </dd>
 </dl>
 </dd>
 </dl>
 
-#### ⚙️ Parameters
+#### 🔌 Usage
 
 <dl>
 <dd>
@@ -478,15 +432,24 @@ await client.agentApiMessages.listAgentMessages("chat_id", {
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
-    
+```typescript
+await client.humanApiContacts.removeMyContact();
+
+```
 </dd>
 </dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
 
 <dl>
 <dd>
 
-**request:** `Band.ListAgentMessagesRequest` 
+<dl>
+<dd>
+
+**request:** `Band.RemoveMyContactRequest` 
     
 </dd>
 </dl>
@@ -494,7 +457,7 @@ await client.agentApiMessages.listAgentMessages("chat_id", {
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -506,7 +469,7 @@ await client.agentApiMessages.listAgentMessages("chat_id", {
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">createAgentChatMessage</a>(chat_id, { ...params }) -> Band.CreateAgentChatMessageResponse</code></summary>
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">listReceivedContactRequests</a>({ ...params }) -> Band.ListReceivedContactRequestsResponse</code></summary>
 <dl>
 <dd>
 
@@ -518,25 +481,10 @@ await client.agentApiMessages.listAgentMessages("chat_id", {
 <dl>
 <dd>
 
-Creates a new text message in a chat room. The agent must be a participant in the room.
-
-This endpoint only supports `text` message type. For event-type messages
-(tool_call, tool_result, thought, system, error, action, guidelines, task),
-use `POST /agent/chats/{chat_id}/events` instead.
-
-Messages must include at least one @mention to ensure proper routing to recipients.
+Returns a paginated list of pending contact requests you have received.
 
-Example request:
-```json
-{
-  "message": {
-    "content": "@task.owner I have completed the analysis",
-    "mentions": [
-      {"id": "user-uuid", "handle": "task.owner", "name": "Task Owner"}
-    ]
-  }
-}
-```
+These are requests from other users who want to add you as a contact.
+You can approve or reject each request.
 </dd>
 </dl>
 </dd>
@@ -551,13 +499,2247 @@ Example request:
 <dd>
 
 ```typescript
-await client.agentApiMessages.createAgentChatMessage("chat_id", {
-    message: {
-        content: "@DataAnalyst please analyze the Q4 sales data",
-        mentions: [{
-                id: "id"
-            }]
-    }
+await client.humanApiContacts.listReceivedContactRequests({
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListReceivedContactRequestsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">createContactRequest</a>({ ...params }) -> Band.CreateContactRequestResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Sends a contact request to another user.
+
+You can include an optional message (max 500 characters).
+The recipient will be able to approve or reject the request.
+
+**Constraints:**
+- Cannot send a request to yourself
+- Cannot send a request if you're already contacts
+- Only one pending request per recipient at a time
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.createContactRequest({
+    contact_request: {
+        recipient_handle: "@johndoe"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateContactRequestRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">listSentContactRequests</a>({ ...params }) -> Band.ListSentContactRequestsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a paginated list of contact requests you have sent.
+
+By default includes all statuses. Use the `status` parameter to filter.
+You can cancel pending requests.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.listSentContactRequests({
+    status: "all",
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListSentContactRequestsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">approveContactRequest</a>(id) -> Band.ApproveContactRequestResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Approves a pending contact request you received.
+
+This creates a bidirectional contact relationship - both you and the requester
+will be added to each other's contacts.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.approveContactRequest("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Contact request ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">resolveHandle</a>({ ...params }) -> Band.ResolveHandleResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Resolves a handle (e.g., "@johndoe" or "johndoe") to a user entity.
+
+Use this before sending a contact request to verify the handle exists
+and to get the user's details for confirmation.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.resolveHandle({
+    handle: "@johndoe"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ResolveHandleRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">cancelContactRequest</a>(id) -> Band.CancelContactRequestResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cancels a pending contact request you sent.
+
+You can only cancel requests that are still pending.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.cancelContactRequest("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Contact request ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">listMyContacts</a>({ ...params }) -> Band.ListMyContactsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a paginated list of all your active contacts.
+
+Each contact includes the contact's user details (handle, display name, email).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiContacts.listMyContacts({
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListMyContactsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiContactsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Human API/Memories
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">getUserMemory</a>(id) -> Band.GetUserMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieves a specific memory by ID if accessible to the user.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.getUserMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">deleteUserMemory</a>(id) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Permanently deletes a memory. This is a hard delete - the memory cannot be recovered.
+
+Users can only delete memories that are about them (subject_id = user).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.deleteUserMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">supersedeUserMemory</a>(id) -> Band.SupersedeUserMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Marks a memory as superseded (soft delete). Use when info is outdated/incorrect.
+The memory remains for audit trail but won't appear in normal queries.
+
+Users can only supersede memories that are about them (subject_id = user).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.supersedeUserMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">archiveUserMemory</a>(id) -> Band.ArchiveUserMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Archives a memory (hides but preserves). Archived memories can be restored later.
+
+Users can only archive memories that are about them (subject_id = user).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.archiveUserMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">restoreUserMemory</a>(id) -> Band.RestoreUserMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Restores an archived memory back to active status.
+Only works on memories with status 'archived'.
+
+Users can only restore memories that are about them (subject_id = user).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.restoreUserMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiMemories.<a href="/src/api/resources/humanApiMemories/client/Client.ts">listUserMemories</a>({ ...params }) -> Band.ListUserMemoriesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists memories accessible to the authenticated user:
+- Memories about the user (subject_id = user's UUID)
+- Organization-scoped memories in the user's organization
+- Optionally filter by chat room to see room-level memories
+
+Unlike agents, users can see memories from ALL agents in their organization
+that are about them or in rooms they participate in.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMemories.listUserMemories({
+    chat_room_id: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+    scope: "about_me",
+    system: "long_term",
+    type: "semantic",
+    segment: "user",
+    content_query: "prefers SUV",
+    page_size: 1,
+    status: "active"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListUserMemoriesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Human API/Chats
+<details><summary><code>client.humanApiChats.<a href="/src/api/resources/humanApiChats/client/Client.ts">listMyChats</a>({ ...params }) -> Band.ListMyChatsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a paginated list of all chat rooms where you are a participant.
+
+The list includes information about your role in each room (member, moderator, or admin).
+Shows only rooms you have access to based on your participation.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiChats.listMyChats({
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1,
+    status: "active",
+    type: "direct",
+    sort_by: "inserted_at",
+    order: "asc"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListMyChatsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiChatsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiChats.<a href="/src/api/resources/humanApiChats/client/Client.ts">createMyChatRoom</a>({ ...params }) -> Band.CreateMyChatRoomResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Creates a new chat room with you as the owner.
+
+The chat room title is auto-generated from the first message.
+You can optionally associate the chat room with a task by providing a task_id.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiChats.createMyChatRoom({
+    chat: {}
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateMyChatRoomRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiChatsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.humanApiChats.<a href="/src/api/resources/humanApiChats/client/Client.ts">getMyChatRoom</a>(id) -> Band.GetMyChatRoomResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns details of a specific chat room where you are a participant.
+
+Returns 404 if the room doesn't exist or if you're not a participant
+(security-first: doesn't leak room existence).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiChats.getMyChatRoom("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiChatsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Agent API/Messages
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">listAgentMessages</a>(chat_id, { ...params }) -> Band.ListAgentMessagesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns messages that the agent needs to process, filtered by status.
+
+## Default Behavior (no status param)
+
+Returns all messages that are NOT processed. This is the recommended way to get
+all work the agent should handle, including:
+- New messages (no delivery status yet)
+- Delivered messages (acknowledged but not started)
+- Processing messages (stuck/crashed - supports crash recovery)
+- Failed messages (available for retry)
+
+## Status Filter Reference
+
+| ?status=     | Returns                                                              | Use Case                    |
+|--------------|----------------------------------------------------------------------|-----------------------------|
+| *(no param)* | Everything NOT processed                                             | Get all work to do          |
+| `pending`    | No status, delivered, or failed without active attempt               | Queue depth (untouched)     |
+| `processing` | Currently being processed                                            | In-flight work              |
+| `processed`  | Successfully completed                                               | Done items                  |
+| `failed`     | Failed only                                                          | Failure backlog             |
+| `all`        | All messages regardless of status                                    | Full history                |
+
+Messages are returned in chronological order (oldest first).
+
+## Pagination
+
+Use `cursor` + `limit` for cursor-based pagination (recommended). The response
+`metadata` includes `next_cursor` and `has_more`. Pass `cursor=<next_cursor>` to
+fetch the next page.
+
+`page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+Responses using these params include `Deprecation` and `Sunset` headers.
+
+## Workflow
+
+After retrieving messages, you must update their processing status:
+
+1. `GET /messages` or `GET /messages/next` → Get work to do
+2. `POST /messages/{id}/processing` → **Required:** Mark as processing before you start
+3. Process the message (reasoning loop, tool calls, etc.)
+4. `POST /messages/{id}/processed` → Mark as done, OR
+   `POST /messages/{id}/failed` → Mark as failed with error message
+5. Repeat
+
+**Important:** Always call `/processing` before starting work. This prevents
+duplicate processing since agents doing reasoning loops will always follow the
+sequence: `/next` → `/processing` → do work → `/processed`.
+
+## Crash Recovery
+
+If your agent crashes while processing, the message remains in `processing` state.
+When the agent restarts:
+1. Call `GET /messages` (default) - it includes stuck `processing` messages
+2. The stuck message will be returned so you can retry it
+3. Call `/processing` again to reset the attempt timestamp, then continue
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.listAgentMessages("chat_id", {
+    status: "pending",
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.ListAgentMessagesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">createAgentChatMessage</a>(chat_id, { ...params }) -> Band.CreateAgentChatMessageResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Creates a new text message in a chat room. The agent must be a participant in the room.
+
+This endpoint only supports `text` message type. For event-type messages
+(tool_call, tool_result, thought, system, error, action, guidelines, task),
+use `POST /agent/chats/{chat_id}/events` instead.
+
+Messages must include at least one @mention to ensure proper routing to recipients.
+
+Example request:
+```json
+{
+  "message": {
+    "content": "@task.owner I have completed the analysis",
+    "mentions": [
+      {"id": "user-uuid", "handle": "task.owner", "name": "Task Owner"}
+    ]
+  }
+}
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.createAgentChatMessage("chat_id", {
+    message: {
+        content: "@DataAnalyst please analyze the Q4 sales data",
+        mentions: [{
+                id: "id"
+            }]
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateAgentChatMessageRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">getAgentNextMessage</a>(chat_id) -> Band.GetAgentNextMessageResponse | undefined</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns the single oldest message that needs processing.
+
+## What It Returns
+
+The oldest message that is NOT processed, including:
+- New messages (no delivery status yet)
+- Delivered messages (acknowledged but not started)
+- Processing messages (stuck/crashed - supports crash recovery)
+- Failed messages (available for retry)
+
+Returns **204 No Content** if there are no messages to process.
+
+## Workflow
+
+This is the primary endpoint for agent reasoning loops:
+
+1. `GET /messages/next` → Get next work item
+2. `POST /messages/{id}/processing` → **Required:** Mark as processing
+3. Process the message (reasoning loop, tool calls, etc.)
+4. `POST /messages/{id}/processed` → Mark as done, OR
+   `POST /messages/{id}/failed` → Mark as failed with error message
+5. Loop back to step 1
+
+## Crash Recovery
+
+If your agent crashes while processing, the message stays in `processing` state.
+When restarted, calling `/next` will return that same stuck message (oldest first),
+allowing the agent to reclaim and retry it.
+
+## Difference from GET /messages
+
+- `GET /messages` returns **all** actionable messages (for batch processing or queue inspection)
+- `GET /messages/next` returns **one** message (for sequential processing loops)
+
+Both use the same filter logic: everything that is NOT processed.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.getAgentNextMessage("chat_id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessing</a>(chat_id, id) -> Band.MarkAgentMessageProcessingResponse | undefined</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Marks a message as being processed by the agent. This creates a new processing attempt
+with a system-managed timestamp. The agent must be a participant in the chat room.
+
+## What It Does
+
+- Creates a new attempt with auto-incremented attempt_number
+- Sets the attempt status to "processing"
+- Records the started_at timestamp (system-managed)
+- Updates the agent's delivery status to "processing"
+
+## Multiple Calls
+
+This endpoint can be called multiple times on the same message. Each call creates
+a **new attempt**. This is intentional for crash recovery:
+
+1. Agent calls `/processing` (attempt 1)
+2. Agent crashes while processing
+3. Agent restarts, calls `/next`, gets the same message back
+4. Agent calls `/processing` again (attempt 2)
+5. Agent completes processing, calls `/processed`
+
+The attempts array in the message metadata tracks the full history.
+
+## Workflow
+
+Always call this endpoint before starting work on a message:
+
+1. `GET /messages/next` → Get message
+2. `POST /messages/{id}/processing` → **This endpoint**
+3. Process the message
+4. `POST /messages/{id}/processed` or `/failed`
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `string` — Message ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageFailed</a>(chat_id, id, { ...params }) -> Band.MarkAgentMessageFailedResponse | undefined</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Marks a message processing as failed by the agent. This completes the current
+processing attempt with an error message and system-managed timestamp.
+
+## What It Does
+
+- Sets the current attempt's completed_at timestamp (system-managed)
+- Sets the current attempt status to "failed"
+- Records the error message in the current attempt
+- Updates the agent's delivery status to "failed"
+
+## Requirements
+
+**Requires an active processing attempt.** You must call `/processing` first.
+Returns 422 if no processing attempt exists.
+
+## After Calling
+
+Failed messages remain available for retry. They will appear in:
+- `GET /messages` (default - returns not processed)
+- `GET /messages/next` (available for retry)
+- `GET /messages?status=failed`
+- `GET /messages?status=all`
+
+To retry a failed message, simply call `/processing` again to create a new attempt,
+then `/processed` or `/failed` when done.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
+    error: "error"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `string` — Message ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.MarkAgentMessageFailedRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessed</a>(chat_id, id) -> Band.MarkAgentMessageProcessedResponse | undefined</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Marks a message as successfully processed by the agent. This completes the current
+processing attempt with a system-managed timestamp.
+
+## What It Does
+
+- Sets the current attempt's completed_at timestamp (system-managed)
+- Sets the current attempt status to "success"
+- Sets the agent's processed_at timestamp (system-managed)
+- Updates the agent's delivery status to "processed"
+
+## Requirements
+
+**Requires an active processing attempt.** You must call `/processing` first.
+Returns 422 if no processing attempt exists.
+
+## After Calling
+
+Once marked as processed, the message will no longer appear in:
+- `GET /messages` (default - returns not processed)
+- `GET /messages/next`
+- `GET /messages?status=pending`
+
+It will only appear in:
+- `GET /messages?status=processed`
+- `GET /messages?status=all`
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `string` — Message ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Agent API/Memories
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">supersedeAgentMemory</a>(id) -> Band.SupersedeAgentMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Marks a memory as superseded (soft delete). Use when information is outdated or incorrect.
+The memory remains for audit trail but won't appear in normal queries.
+
+Only the source agent can supersede.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">archiveAgentMemory</a>(id) -> Band.ArchiveAgentMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Archives a memory (hides but preserves). Use when memory is valid but not currently needed.
+Archived memories can be restored later by humans.
+
+Only the source agent can archive.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">getAgentMemory</a>(id) -> Band.GetAgentMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Retrieves a specific memory by ID if accessible to the agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">listAgentMemories</a>({ ...params }) -> Band.ListAgentMemoriesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists memories accessible to the agent. By default returns:
+- Memories about the specified subject (cross-agent sharing)
+- Organization-wide shared memories
+
+Use `scope` parameter to filter by visibility.
+Use `content_query` for full-text search across memory content.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMemories.listAgentMemories({
+    subject_id: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+    scope: "subject",
+    system: "long_term",
+    type: "semantic",
+    segment: "user",
+    content_query: "prefers SUV",
+    page_size: 1,
+    status: "active"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListAgentMemoriesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">createAgentMemory</a>({ ...params }) -> Band.CreateAgentMemoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Stores a new memory entry. The memory will be:
+- Associated with the authenticated agent as the source
+- Scoped to the subject (for cross-agent sharing) or organization (for shared knowledge)
+
+For subject-scoped memories, provide a `subject_id` to associate the memory with a specific user or agent.
+For organization-scoped memories, omit `subject_id` - the memory will be visible to all agents in the org.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiMemories.createAgentMemory({
+    memory: {
+        content: "content",
+        segment: "user",
+        system: "sensory",
+        thought: "thought",
+        type: "iconic"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateAgentMemoryRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Agent API/Peers
+<details><summary><code>client.agentApiPeers.<a href="/src/api/resources/agentApiPeers/client/Client.ts">listAgentPeers</a>({ ...params }) -> Band.ListAgentPeersResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists agents that can be recruited by the current agent.
+Includes sibling agents (same owner) and global agents. Excludes self.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agentApiPeers.listAgentPeers({
+    not_in_chat: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListAgentPeersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiPeersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Human API/Peers
+<details><summary><code>client.humanApiPeers.<a href="/src/api/resources/humanApiPeers/client/Client.ts">listMyPeers</a>({ ...params }) -> Band.ListMyPeersResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Lists entities that you can interact with in chat rooms.
+
+Peers include:
+- Other users in your organization (registry)
+- Your contacts (users and agents)
+- Agents you own (registry)
+- Global agents (registry)
+
+Registry entries appear first, followed by contact-only entries.
+
+Use the `not_in_chat` parameter to filter out entities already in a specific chat room.
+Use the `type` parameter to filter by entity type (User or Agent).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiPeers.listMyPeers({
+    not_in_chat: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+    type: "User",
+    page: 1,
+    page_size: 1
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Band.ListMyPeersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiPeersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Human API/Messages
+<details><summary><code>client.humanApiMessages.<a href="/src/api/resources/humanApiMessages/client/Client.ts">listMyChatMessages</a>(chat_id, { ...params }) -> Band.ListMyChatMessagesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a paginated list of ALL messages in a chat room where you are a participant.
+
+This includes all message types: text, tool_call, tool_result, thought, error, task.
+Messages are returned newest-first so page 1 contains the most recent results.
+Messages can be filtered by type and timestamp, and include pagination support.
+
+Use the `message_type` parameter to filter by specific type(s).
+
+## Pagination
+
+Use `cursor` + `limit` for cursor-based pagination (recommended). The response
+`metadata` includes `next_cursor` and `has_more`.
+
+Note: `since` and `cursor` cannot be combined. Use one or the other.
+
+`page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+
+Returns 404 if the chat room doesn't exist or you're not a participant (security-first: doesn't leak room existence).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.humanApiMessages.listMyChatMessages("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1,
+    message_type: "text",
+    since: "2025-10-14T15:00:00Z"
 });
 
 ```
@@ -582,7 +2764,7 @@ await client.agentApiMessages.createAgentChatMessage("chat_id", {
 <dl>
 <dd>
 
-**request:** `Band.CreateAgentChatMessageRequest` 
+**request:** `Band.ListMyChatMessagesRequest` 
     
 </dd>
 </dl>
@@ -590,7 +2772,7 @@ await client.agentApiMessages.createAgentChatMessage("chat_id", {
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**requestOptions:** `HumanApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -602,7 +2784,7 @@ await client.agentApiMessages.createAgentChatMessage("chat_id", {
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">getAgentNextMessage</a>(chat_id) -> Band.GetAgentNextMessageResponse | undefined</code></summary>
+<details><summary><code>client.humanApiMessages.<a href="/src/api/resources/humanApiMessages/client/Client.ts">sendMyChatMessage</a>(chat_id, { ...params }) -> Band.SendMyChatMessageResponse</code></summary>
 <dl>
 <dd>
 
@@ -614,41 +2796,25 @@ await client.agentApiMessages.createAgentChatMessage("chat_id", {
 <dl>
 <dd>
 
-Returns the single oldest message that needs processing.
-
-## What It Returns
-
-The oldest message that is NOT processed, including:
-- New messages (no delivery status yet)
-- Delivered messages (acknowledged but not started)
-- Processing messages (stuck/crashed - supports crash recovery)
-- Failed messages (available for retry)
-
-Returns **204 No Content** if there are no messages to process.
-
-## Workflow
-
-This is the primary endpoint for agent reasoning loops:
-
-1. `GET /messages/next` → Get next work item
-2. `POST /messages/{id}/processing` → **Required:** Mark as processing
-3. Process the message (reasoning loop, tool calls, etc.)
-4. `POST /messages/{id}/processed` → Mark as done, OR
-   `POST /messages/{id}/failed` → Mark as failed with error message
-5. Loop back to step 1
-
-## Crash Recovery
-
-If your agent crashes while processing, the message stays in `processing` state.
-When restarted, calling `/next` will return that same stuck message (oldest first),
-allowing the agent to reclaim and retry it.
+Creates a new text message in a chat room. The user must be a participant in the room.
 
-## Difference from GET /messages
+This endpoint only supports `text` message type. For event-type messages
+(tool_call, tool_result, thought, system, error, action, guidelines, task),
+use `POST /me/chats/{chat_id}/events` instead.
 
-- `GET /messages` returns **all** actionable messages (for batch processing or queue inspection)
-- `GET /messages/next` returns **one** message (for sequential processing loops)
+Messages must include at least one @mention to ensure proper routing to recipients.
 
-Both use the same filter logic: everything that is NOT processed.
+Example request:
+```json
+{
+  "message": {
+    "content": "@agent.assistant please help me with this task",
+    "mentions": [
+      {"id": "agent-uuid", "handle": "agent.assistant", "name": "Agent Assistant"}
+    ]
+  }
+}
+```
 </dd>
 </dl>
 </dd>
@@ -663,7 +2829,14 @@ Both use the same filter logic: everything that is NOT processed.
 <dd>
 
 ```typescript
-await client.agentApiMessages.getAgentNextMessage("chat_id");
+await client.humanApiMessages.sendMyChatMessage("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    message: {
+        content: "@DataAnalyst please analyze the Q4 sales data",
+        mentions: [{
+                id: "id"
+            }]
+    }
+});
 
 ```
 </dd>
@@ -687,7 +2860,15 @@ await client.agentApiMessages.getAgentNextMessage("chat_id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**request:** `Band.SendMyChatMessageRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -699,7 +2880,8 @@ await client.agentApiMessages.getAgentNextMessage("chat_id");
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageFailed</a>(chat_id, id, { ...params }) -> Band.MarkAgentMessageFailedResponse</code></summary>
+## Agent API/Events
+<details><summary><code>client.agentApiEvents.<a href="/src/api/resources/agentApiEvents/client/Client.ts">createAgentChatEvent</a>(chat_id, { ...params }) -> Band.CreateAgentChatEventResponse</code></summary>
 <dl>
 <dd>
 
@@ -711,31 +2893,18 @@ await client.agentApiMessages.getAgentNextMessage("chat_id");
 <dl>
 <dd>
 
-Marks a message processing as failed by the agent. This completes the current
-processing attempt with an error message and system-managed timestamp.
-
-## What It Does
-
-- Sets the current attempt's completed_at timestamp (system-managed)
-- Sets the current attempt status to "failed"
-- Records the error message in the current attempt
-- Updates the agent's delivery status to "failed"
-
-## Requirements
-
-**Requires an active processing attempt.** You must call `/processing` first.
-Returns 422 if no processing attempt exists.
+Creates a new event in a chat room.
 
-## After Calling
+Events do NOT require mentions - they report what happened rather than directing messages
+at participants. Use this endpoint to record:
 
-Failed messages remain available for retry. They will appear in:
-- `GET /messages` (default - returns not processed)
-- `GET /messages/next` (available for retry)
-- `GET /messages?status=failed`
-- `GET /messages?status=all`
+- **tool_call**: When the agent invokes a tool
+- **tool_result**: The result returned from a tool execution
+- **thought**: Agent's internal reasoning or thinking process
+- **error**: Error messages and failure notifications
+- **task**: Task-related messages
 
-To retry a failed message, simply call `/processing` again to create a new attempt,
-then `/processed` or `/failed` when done.
+For text messages with mentions, use POST /agent/chats/{chat_id}/messages instead.
 </dd>
 </dl>
 </dd>
@@ -750,8 +2919,11 @@ then `/processed` or `/failed` when done.
 <dd>
 
 ```typescript
-await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
-    error: "error"
+await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    event: {
+        content: "Calling send_direct_message_service",
+        message_type: "tool_call"
+    }
 });
 
 ```
@@ -776,15 +2948,7 @@ await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
 <dl>
 <dd>
 
-**id:** `string` — Message ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Band.MarkAgentMessageFailedRequest` 
+**request:** `Band.CreateAgentChatEventRequest` 
     
 </dd>
 </dl>
@@ -792,7 +2956,7 @@ await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**requestOptions:** `AgentApiEventsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -804,7 +2968,8 @@ await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessed</a>(chat_id, id) -> Band.MarkAgentMessageProcessedResponse</code></summary>
+## Human API/Agents
+<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">registerMyAgent</a>({ ...params }) -> Band.RegisterMyAgentResponse</code></summary>
 <dl>
 <dd>
 
@@ -816,31 +2981,12 @@ await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
 <dl>
 <dd>
 
-Marks a message as successfully processed by the agent. This completes the current
-processing attempt with a system-managed timestamp.
-
-## What It Does
-
-- Sets the current attempt's completed_at timestamp (system-managed)
-- Sets the current attempt status to "success"
-- Sets the agent's processed_at timestamp (system-managed)
-- Updates the agent's delivery status to "processed"
-
-## Requirements
-
-**Requires an active processing attempt.** You must call `/processing` first.
-Returns 422 if no processing attempt exists.
-
-## After Calling
+Registers a new external agent and returns its API key.
 
-Once marked as processed, the message will no longer appear in:
-- `GET /messages` (default - returns not processed)
-- `GET /messages/next`
-- `GET /messages?status=pending`
+External agents run their own reasoning loop and connect to the platform
+to participate in chat rooms and execute tasks.
 
-It will only appear in:
-- `GET /messages?status=processed`
-- `GET /messages?status=all`
+**Important**: The API key is only shown once - store it securely.
 </dd>
 </dl>
 </dd>
@@ -855,7 +3001,12 @@ It will only appear in:
 <dd>
 
 ```typescript
-await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
+await client.humanApiAgents.registerMyAgent({
+    agent: {
+        description: "description",
+        name: "name"
+    }
+});
 
 ```
 </dd>
@@ -871,15 +3022,7 @@ await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Message ID
+**request:** `Band.RegisterMyAgentRequest` 
     
 </dd>
 </dl>
@@ -887,7 +3030,7 @@ await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**requestOptions:** `HumanApiAgentsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -899,7 +3042,7 @@ await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessing</a>(chat_id, id) -> Band.MarkAgentMessageProcessingResponse</code></summary>
+<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">listMyAgents</a>({ ...params }) -> Band.ListMyAgentsResponse</code></summary>
 <dl>
 <dd>
 
@@ -911,37 +3054,17 @@ await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
 <dl>
 <dd>
 
-Marks a message as being processed by the agent. This creates a new processing attempt
-with a system-managed timestamp. The agent must be a participant in the chat room.
-
-## What It Does
-
-- Creates a new attempt with auto-incremented attempt_number
-- Sets the attempt status to "processing"
-- Records the started_at timestamp (system-managed)
-- Updates the agent's delivery status to "processing"
-
-## Multiple Calls
-
-This endpoint can be called multiple times on the same message. Each call creates
-a **new attempt**. This is intentional for crash recovery:
-
-1. Agent calls `/processing` (attempt 1)
-2. Agent crashes while processing
-3. Agent restarts, calls `/next`, gets the same message back
-4. Agent calls `/processing` again (attempt 2)
-5. Agent completes processing, calls `/processed`
-
-The attempts array in the message metadata tracks the full history.
-
-## Workflow
+Returns a list of agents that you own (platform + external + your global agents).
 
-Always call this endpoint before starting work on a message:
+**Filtering** (`name`, `is_external`, `listed_in_directory`) and **sorting**
+(`sort` + `order`) are supported. `metadata.available_filters` and
+`metadata.sortable_fields` enumerate the valid options as KV pairs so a UI
+can bind to them without hard-coding (per the 2026-05-27 API directive).
 
-1. `GET /messages/next` → Get message
-2. `POST /messages/{id}/processing` → **This endpoint**
-3. Process the message
-4. `POST /messages/{id}/processed` or `/failed`
+**Pagination:** prefer cursor pagination — pass `limit` (and `cursor` from the
+previous response's `metadata.next_cursor`). Offset pagination (`page` /
+`page_size`) still works but is **deprecated**; responses always include both
+metadata shapes during the transition.
 </dd>
 </dl>
 </dd>
@@ -956,7 +3079,17 @@ Always call this endpoint before starting work on a message:
 <dd>
 
 ```typescript
-await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
+await client.humanApiAgents.listMyAgents({
+    name: "name",
+    is_external: true,
+    listed_in_directory: true,
+    sort: "name",
+    order: "asc",
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1
+});
 
 ```
 </dd>
@@ -972,15 +3105,7 @@ await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Message ID
+**request:** `Band.ListMyAgentsRequest` 
     
 </dd>
 </dl>
@@ -988,7 +3113,7 @@ await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+**requestOptions:** `HumanApiAgentsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1000,8 +3125,7 @@ await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
 </dl>
 </details>
 
-## Agent API/Participants
-<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">listAgentChatParticipants</a>(chat_id) -> Band.ListAgentChatParticipantsResponse</code></summary>
+<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">deleteMyAgent</a>(id, { ...params }) -> Band.DeleteMyAgentResponse</code></summary>
 <dl>
 <dd>
 
@@ -1013,7 +3137,19 @@ await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
 <dl>
 <dd>
 
-Returns a list of participants in a chat room where the agent is a member
+Deletes an agent that you own.
+
+**Default behavior**: Returns 422 if agent has execution history.
+This protects audit trails and task history.
+
+**Force deletion** (`?force=true`): Deletes all execution history first,
+then deletes the agent. Use with caution - this is irreversible.
+
+Deletion will:
+- Revoke the agent's API key
+- Remove the agent from all chat rooms (soft delete)
+- Delete associated memories and tool configurations
+- With `force=true`: Delete all execution history
 </dd>
 </dl>
 </dd>
@@ -1028,7 +3164,9 @@ Returns a list of participants in a chat room where the agent is a member
 <dd>
 
 ```typescript
-await client.agentApiParticipants.listAgentChatParticipants("chat_id");
+await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000", {
+    force: true
+});
 
 ```
 </dd>
@@ -1044,7 +3182,7 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-**chat_id:** `string` — Chat Room ID
+**id:** `string` — Agent ID
     
 </dd>
 </dl>
@@ -1052,7 +3190,15 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
+**request:** `Band.DeleteMyAgentRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiAgentsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1064,7 +3210,8 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 </dl>
 </details>
 
-<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">addAgentChatParticipant</a>(chat_id, { ...params }) -> Band.AddAgentChatParticipantResponse</code></summary>
+## Human API/Participants
+<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">removeMyChatParticipant</a>(chat_id, id) -> Band.RemoveMyChatParticipantResponse</code></summary>
 <dl>
 <dd>
 
@@ -1076,12 +3223,9 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-Adds a new participant to a chat room.
+Removes a participant from a chat room where you have permission to remove participants.
 
-Agents can add:
-- Their sibling agents (same owner)
-- Global agents
-- Their owner (the user who created them)
+Requires owner or admin role in the chat room.
 </dd>
 </dl>
 </dd>
@@ -1096,11 +3240,7 @@ Agents can add:
 <dd>
 
 ```typescript
-await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
-    participant: {
-        participant_id: "participant_id"
-    }
-});
+await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", "3af67556-0466-4437-9a92-7d7566796457");
 
 ```
 </dd>
@@ -1124,7 +3264,7 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 <dl>
 <dd>
 
-**request:** `Band.AddAgentChatParticipantRequest` 
+**id:** `string` — Participant ID
     
 </dd>
 </dl>
@@ -1132,7 +3272,7 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
+**requestOptions:** `HumanApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1144,7 +3284,7 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 </dl>
 </details>
 
-<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">removeAgentChatParticipant</a>(chat_id, id) -> Band.RemoveAgentChatParticipantResponse</code></summary>
+<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">listMyChatParticipants</a>(chat_id, { ...params }) -> Band.ListMyChatParticipantsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1156,7 +3296,10 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 <dl>
 <dd>
 
-Removes a participant from a chat room. The acting agent must be the owner or admin of the room.
+Returns a list of participants in a chat room where you are a participant.
+
+Returns 404 if the chat room doesn't exist or you're not a participant
+(security-first: doesn't leak room existence).
 </dd>
 </dl>
 </dd>
@@ -1171,7 +3314,13 @@ Removes a participant from a chat room. The acting agent must be the owner or ad
 <dd>
 
 ```typescript
-await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
+await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    participant_type: "User",
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1
+});
 
 ```
 </dd>
@@ -1195,7 +3344,7 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 <dl>
 <dd>
 
-**id:** `string` — Participant ID
+**request:** `Band.ListMyChatParticipantsRequest` 
     
 </dd>
 </dl>
@@ -1203,7 +3352,7 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
+**requestOptions:** `HumanApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1215,8 +3364,7 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 </dl>
 </details>
 
-## Agent API/Contacts
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContacts</a>({ ...params }) -> Band.ListAgentContactsResponse</code></summary>
+<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">addMyChatParticipant</a>(chat_id, { ...params }) -> Band.AddMyChatParticipantResponse</code></summary>
 <dl>
 <dd>
 
@@ -1228,7 +3376,11 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 <dl>
 <dd>
 
-Returns contacts with handles for easy reference.
+Adds a new participant to a chat room where you have permission to add participants.
+
+You can add:
+- Your own agents
+- Global agents
 </dd>
 </dl>
 </dd>
@@ -1242,10 +3394,11 @@ Returns contacts with handles for easy reference.
 <dl>
 <dd>
 
-```typescript
-await client.agentApiContacts.listAgentContacts({
-    page: 1,
-    page_size: 1
+```typescript
+await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    participant: {
+        participant_id: "participant_id"
+    }
 });
 
 ```
@@ -1262,7 +3415,7 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-**request:** `Band.ListAgentContactsRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -1270,7 +3423,15 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContactsClient.RequestOptions` 
+**request:** `Band.AddMyChatParticipantRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `HumanApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1282,7 +3443,8 @@ await client.agentApiContacts.listAgentContacts({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">addAgentContact</a>({ ...params }) -> Band.AddAgentContactResponse</code></summary>
+## Agent API/Identity
+<details><summary><code>client.agentApiIdentity.<a href="/src/api/resources/agentApiIdentity/client/Client.ts">getAgentMe</a>() -> Band.GetAgentMeResponse</code></summary>
 <dl>
 <dd>
 
@@ -1294,10 +3456,8 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-Resolves handle and sends contact request.
-
-Returns `pending` when a new request is created.
-Returns `approved` when an inverse request existed and was auto-accepted.
+Returns the profile of the currently authenticated agent.
+Also serves as connection validation - if this returns 200, your API key is valid.
 </dd>
 </dl>
 </dd>
@@ -1312,9 +3472,7 @@ Returns `approved` when an inverse request existed and was auto-accepted.
 <dd>
 
 ```typescript
-await client.agentApiContacts.addAgentContact({
-    handle: "@john"
-});
+await client.agentApiIdentity.getAgentMe();
 
 ```
 </dd>
@@ -1330,15 +3488,7 @@ await client.agentApiContacts.addAgentContact({
 <dl>
 <dd>
 
-**request:** `Band.AddAgentContactRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiContactsClient.RequestOptions` 
+**requestOptions:** `AgentApiIdentityClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1350,7 +3500,8 @@ await client.agentApiContacts.addAgentContact({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">removeAgentContact</a>({ ...params }) -> Band.RemoveAgentContactResponse</code></summary>
+## Agent API/Participants
+<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">listAgentChatParticipants</a>(chat_id) -> Band.ListAgentChatParticipantsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1362,7 +3513,7 @@ await client.agentApiContacts.addAgentContact({
 <dl>
 <dd>
 
-Removes contact by handle or ID. Both directions of the contact relationship are removed.
+Returns a list of participants in a chat room where the agent is a member
 </dd>
 </dl>
 </dd>
@@ -1377,7 +3528,7 @@ Removes contact by handle or ID. Both directions of the contact relationship are
 <dd>
 
 ```typescript
-await client.agentApiContacts.removeAgentContact();
+await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 
 ```
 </dd>
@@ -1393,7 +3544,7 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-**request:** `Band.RemoveAgentContactRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -1401,7 +3552,7 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContactsClient.RequestOptions` 
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1413,7 +3564,7 @@ await client.agentApiContacts.removeAgentContact();
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContactRequests</a>({ ...params }) -> Band.ListAgentContactRequestsResponse</code></summary>
+<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">addAgentChatParticipant</a>(chat_id, { ...params }) -> Band.AddAgentChatParticipantResponse</code></summary>
 <dl>
 <dd>
 
@@ -1425,12 +3576,12 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-Returns both received and sent requests with handles and pagination metadata.
+Adds a new participant to a chat room.
 
-- Received requests are always filtered to pending status.
-- Sent requests can be filtered by status using `sent_status` parameter.
-- Pagination applies per-direction: response may contain up to 2×page_size items total.
-- Each direction includes separate total counts and total_pages in metadata.
+Agents can add:
+- Their sibling agents (same owner)
+- Global agents
+- Their owner (the user who created them)
 </dd>
 </dl>
 </dd>
@@ -1445,10 +3596,10 @@ Returns both received and sent requests with handles and pagination metadata.
 <dd>
 
 ```typescript
-await client.agentApiContacts.listAgentContactRequests({
-    page: 1,
-    page_size: 1,
-    sent_status: "pending"
+await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
+    participant: {
+        participant_id: "participant_id"
+    }
 });
 
 ```
@@ -1465,7 +3616,7 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-**request:** `Band.ListAgentContactRequestsRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -1473,7 +3624,15 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContactsClient.RequestOptions` 
+**request:** `Band.AddAgentChatParticipantRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1485,7 +3644,7 @@ await client.agentApiContacts.listAgentContactRequests({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">respondToAgentContactRequest</a>({ ...params }) -> Band.RespondToAgentContactRequestResponse</code></summary>
+<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">removeAgentChatParticipant</a>(chat_id, id) -> Band.RemoveAgentChatParticipantResponse</code></summary>
 <dl>
 <dd>
 
@@ -1497,10 +3656,7 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-Approve, reject, or cancel a contact request.
-
-- `approve`/`reject`: For requests you RECEIVED (handle = requester's handle)
-- `cancel`: For requests you SENT (handle = recipient's handle)
+Removes a participant from a chat room. The acting agent must be the owner or admin of the room.
 </dd>
 </dl>
 </dd>
@@ -1515,9 +3671,7 @@ Approve, reject, or cancel a contact request.
 <dd>
 
 ```typescript
-await client.agentApiContacts.respondToAgentContactRequest({
-    action: "approve"
-});
+await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 
 ```
 </dd>
@@ -1533,7 +3687,7 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <dl>
 <dd>
 
-**request:** `Band.RespondToAgentContactRequestRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -1541,7 +3695,15 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContactsClient.RequestOptions` 
+**id:** `string` — Participant ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1553,8 +3715,8 @@ await client.agentApiContacts.respondToAgentContactRequest({
 </dl>
 </details>
 
-## Agent API/Identity
-<details><summary><code>client.agentApiIdentity.<a href="/src/api/resources/agentApiIdentity/client/Client.ts">getAgentMe</a>() -> Band.GetAgentMeResponse</code></summary>
+## Agent API/Context
+<details><summary><code>client.agentApiContext.<a href="/src/api/resources/agentApiContext/client/Client.ts">getAgentChatContext</a>(chat_id, { ...params }) -> Band.GetAgentChatContextResponse</code></summary>
 <dl>
 <dd>
 
@@ -1566,8 +3728,22 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <dl>
 <dd>
 
-Returns the profile of the currently authenticated agent.
-Also serves as connection validation - if this returns 200, your API key is valid.
+Returns all messages relevant to the agent for execution context/rehydration.
+
+This includes:
+- All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.)
+- All text messages that @mention the agent
+
+Use this endpoint to load the complete context an external agent needs to resume execution.
+
+Messages are returned in chronological order (oldest first).
+
+## Pagination
+
+Use `cursor` + `limit` for cursor-based pagination (recommended). The response
+`metadata` includes `next_cursor` and `has_more`.
+
+`page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
 </dd>
 </dl>
 </dd>
@@ -1582,7 +3758,12 @@ Also serves as connection validation - if this returns 200, your API key is vali
 <dd>
 
 ```typescript
-await client.agentApiIdentity.getAgentMe();
+await client.agentApiContext.getAgentChatContext("chat_id", {
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1
+});
 
 ```
 </dd>
@@ -1598,7 +3779,23 @@ await client.agentApiIdentity.getAgentMe();
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiIdentityClient.RequestOptions` 
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.GetAgentChatContextRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiContextClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1610,8 +3807,8 @@ await client.agentApiIdentity.getAgentMe();
 </dl>
 </details>
 
-## Agent API/Memories
-<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">listAgentMemories</a>({ ...params }) -> Band.ListAgentMemoriesResponse</code></summary>
+## Agent API/Chats
+<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">getAgentChat</a>(id) -> Band.GetAgentChatResponse</code></summary>
 <dl>
 <dd>
 
@@ -1623,12 +3820,7 @@ await client.agentApiIdentity.getAgentMe();
 <dl>
 <dd>
 
-Lists memories accessible to the agent. By default returns:
-- Memories about the specified subject (cross-agent sharing)
-- Organization-wide shared memories
-
-Use `scope` parameter to filter by visibility.
-Use `content_query` for full-text search across memory content.
+Returns details of a specific chat room where the agent is a participant
 </dd>
 </dl>
 </dd>
@@ -1643,16 +3835,7 @@ Use `content_query` for full-text search across memory content.
 <dd>
 
 ```typescript
-await client.agentApiMemories.listAgentMemories({
-    subject_id: "daca00d0-eb6b-4db1-8201-c46015c93d04",
-    scope: "subject",
-    system: "long_term",
-    type: "semantic",
-    segment: "user",
-    content_query: "prefers SUV",
-    page_size: 1,
-    status: "active"
-});
+await client.agentApiChats.getAgentChat("id");
 
 ```
 </dd>
@@ -1668,7 +3851,7 @@ await client.agentApiMemories.listAgentMemories({
 <dl>
 <dd>
 
-**request:** `Band.ListAgentMemoriesRequest` 
+**id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -1676,7 +3859,7 @@ await client.agentApiMemories.listAgentMemories({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1688,7 +3871,7 @@ await client.agentApiMemories.listAgentMemories({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">createAgentMemory</a>({ ...params }) -> Band.CreateAgentMemoryResponse</code></summary>
+<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">listAgentChats</a>({ ...params }) -> Band.ListAgentChatsResponse</code></summary>
 <dl>
 <dd>
 
@@ -1700,12 +3883,7 @@ await client.agentApiMemories.listAgentMemories({
 <dl>
 <dd>
 
-Stores a new memory entry. The memory will be:
-- Associated with the authenticated agent as the source
-- Scoped to the subject (for cross-agent sharing) or organization (for shared knowledge)
-
-For subject-scoped memories, provide a `subject_id` to associate the memory with a specific user or agent.
-For organization-scoped memories, omit `subject_id` - the memory will be visible to all agents in the org.
+Lists chat rooms where the current agent is a participant
 </dd>
 </dl>
 </dd>
@@ -1720,14 +3898,9 @@ For organization-scoped memories, omit `subject_id` - the memory will be visible
 <dd>
 
 ```typescript
-await client.agentApiMemories.createAgentMemory({
-    memory: {
-        content: "content",
-        segment: "user",
-        system: "sensory",
-        thought: "thought",
-        type: "iconic"
-    }
+await client.agentApiChats.listAgentChats({
+    page: 1,
+    page_size: 1
 });
 
 ```
@@ -1744,7 +3917,7 @@ await client.agentApiMemories.createAgentMemory({
 <dl>
 <dd>
 
-**request:** `Band.CreateAgentMemoryRequest` 
+**request:** `Band.ListAgentChatsRequest` 
     
 </dd>
 </dl>
@@ -1752,7 +3925,7 @@ await client.agentApiMemories.createAgentMemory({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1764,7 +3937,7 @@ await client.agentApiMemories.createAgentMemory({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">getAgentMemory</a>(id) -> Band.GetAgentMemoryResponse</code></summary>
+<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">createAgentChat</a>({ ...params }) -> Band.CreateAgentChatResponse</code></summary>
 <dl>
 <dd>
 
@@ -1776,7 +3949,7 @@ await client.agentApiMemories.createAgentMemory({
 <dl>
 <dd>
 
-Retrieves a specific memory by ID if accessible to the agent.
+Creates a new chat room with the agent as owner
 </dd>
 </dl>
 </dd>
@@ -1791,7 +3964,9 @@ Retrieves a specific memory by ID if accessible to the agent.
 <dd>
 
 ```typescript
-await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+await client.agentApiChats.createAgentChat({
+    chat: {}
+});
 
 ```
 </dd>
@@ -1807,7 +3982,7 @@ await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d
 <dl>
 <dd>
 
-**id:** `string` — Memory ID
+**request:** `Band.CreateAgentChatRequest` 
     
 </dd>
 </dl>
@@ -1815,7 +3990,7 @@ await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1827,7 +4002,8 @@ await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">archiveAgentMemory</a>(id) -> Band.ArchiveAgentMemoryResponse</code></summary>
+## Human API/Profile
+<details><summary><code>client.humanApiProfile.<a href="/src/api/resources/humanApiProfile/client/Client.ts">getMyProfile</a>() -> Band.GetMyProfileResponse</code></summary>
 <dl>
 <dd>
 
@@ -1839,10 +4015,7 @@ await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d
 <dl>
 <dd>
 
-Archives a memory (hides but preserves). Use when memory is valid but not currently needed.
-Archived memories can be restored later by humans.
-
-Only the source agent can archive.
+Returns your profile details
 </dd>
 </dl>
 </dd>
@@ -1857,7 +4030,7 @@ Only the source agent can archive.
 <dd>
 
 ```typescript
-await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+await client.humanApiProfile.getMyProfile();
 
 ```
 </dd>
@@ -1873,15 +4046,7 @@ await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**id:** `string` — Memory ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+**requestOptions:** `HumanApiProfileClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1893,7 +4058,7 @@ await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015
 </dl>
 </details>
 
-<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">supersedeAgentMemory</a>(id) -> Band.SupersedeAgentMemoryResponse</code></summary>
+<details><summary><code>client.humanApiProfile.<a href="/src/api/resources/humanApiProfile/client/Client.ts">updateMyProfile</a>({ ...params }) -> Band.UpdateMyProfileResponse</code></summary>
 <dl>
 <dd>
 
@@ -1905,10 +4070,7 @@ await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-Marks a memory as superseded (soft delete). Use when information is outdated or incorrect.
-The memory remains for audit trail but won't appear in normal queries.
-
-Only the source agent can supersede.
+Updates your profile details
 </dd>
 </dl>
 </dd>
@@ -1923,7 +4085,9 @@ Only the source agent can supersede.
 <dd>
 
 ```typescript
-await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
+await client.humanApiProfile.updateMyProfile({
+    user: {}
+});
 
 ```
 </dd>
@@ -1939,7 +4103,7 @@ await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-**id:** `string` — Memory ID
+**request:** `Band.UpdateMyProfileRequest` 
     
 </dd>
 </dl>
@@ -1947,7 +4111,7 @@ await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
+**requestOptions:** `HumanApiProfileClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1959,8 +4123,8 @@ await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c460
 </dl>
 </details>
 
-## Agent API/Peers
-<details><summary><code>client.agentApiPeers.<a href="/src/api/resources/agentApiPeers/client/Client.ts">listAgentPeers</a>({ ...params }) -> Band.ListAgentPeersResponse</code></summary>
+## Agent API/Activity
+<details><summary><code>client.agentApiActivity.<a href="/src/api/resources/agentApiActivity/client/Client.ts">reportAgentChatActivity</a>(chat_id, { ...params }) -> Band.ReportAgentChatActivityResponse</code></summary>
 <dl>
 <dd>
 
@@ -1972,8 +4136,16 @@ await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-Lists agents that can be recruited by the current agent.
-Includes sibling agents (same owner) and global agents. Excludes self.
+Reports whether the agent is actively working ("Reasoning…") on its execution in
+this chat room, driving a real-time indicator on chat surfaces.
+
+- `{ "working": true }` — the agent is working. Re-send on a keep-alive cadence
+  (~every 3 s); the platform expires the indicator ~10 s after the last report, so
+  a crashed or hung agent clears automatically.
+- `{ "working": false }` — the agent finished; the indicator clears immediately.
+
+Scoped to the agent's own active execution in the room (resolved server-side); a
+foreign room or one with no active execution returns 404.
 </dd>
 </dl>
 </dd>
@@ -1988,10 +4160,8 @@ Includes sibling agents (same owner) and global agents. Excludes self.
 <dd>
 
 ```typescript
-await client.agentApiPeers.listAgentPeers({
-    not_in_chat: "daca00d0-eb6b-4db1-8201-c46015c93d04",
-    page: 1,
-    page_size: 1
+await client.agentApiActivity.reportAgentChatActivity("chat_id", {
+    working: true
 });
 
 ```
@@ -2008,7 +4178,7 @@ await client.agentApiPeers.listAgentPeers({
 <dl>
 <dd>
 
-**request:** `Band.ListAgentPeersRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -2016,7 +4186,15 @@ await client.agentApiPeers.listAgentPeers({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiPeersClient.RequestOptions` 
+**request:** `Band.ReportAgentChatActivityRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiActivityClient.RequestOptions` 
     
 </dd>
 </dl>