@band-ai/rest-client 0.0.113 → 0.0.117

package/reference.md

@@ -1,6 +1,6 @@
 # Reference
-## Agent API/Contacts
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">respondToAgentContactRequest</a>({ ...params }) -> Thenvoi.RespondToAgentContactRequestResponse</code></summary>
+## Agent API/Chats
+<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">listAgentChats</a>({ ...params }) -> Band.ListAgentChatsResponse</code></summary>
 <dl>
 <dd>
 
@@ -12,10 +12,7 @@
 <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)
+Lists chat rooms where the current agent is a participant
 </dd>
 </dl>
 </dd>
@@ -30,8 +27,9 @@ Approve, reject, or cancel a contact request.
 <dd>
 
 ```typescript
-await client.agentApiContacts.respondToAgentContactRequest({
-    action: "approve"
+await client.agentApiChats.listAgentChats({
+    page: 1,
+    page_size: 1
 });
 
 ```
@@ -48,7 +46,7 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <dl>
 <dd>
 
-**request:** `Thenvoi.RespondToAgentContactRequestRequest` 
+**request:** `Band.ListAgentChatsRequest` 
     
 </dd>
 </dl>
@@ -56,7 +54,7 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -68,7 +66,7 @@ await client.agentApiContacts.respondToAgentContactRequest({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">addAgentContact</a>({ ...params }) -> Thenvoi.AddAgentContactResponse</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>
 
@@ -80,10 +78,7 @@ await client.agentApiContacts.respondToAgentContactRequest({
 <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.
+Creates a new chat room with the agent as owner
 </dd>
 </dl>
 </dd>
@@ -98,8 +93,8 @@ Returns `approved` when an inverse request existed and was auto-accepted.
 <dd>
 
 ```typescript
-await client.agentApiContacts.addAgentContact({
-    handle: "@john"
+await client.agentApiChats.createAgentChat({
+    chat: {}
 });
 
 ```
@@ -116,7 +111,7 @@ await client.agentApiContacts.addAgentContact({
 <dl>
 <dd>
 
-**request:** `Thenvoi.AddAgentContactRequest` 
+**request:** `Band.CreateAgentChatRequest` 
     
 </dd>
 </dl>
@@ -124,7 +119,7 @@ await client.agentApiContacts.addAgentContact({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -136,7 +131,7 @@ await client.agentApiContacts.addAgentContact({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContactRequests</a>({ ...params }) -> Thenvoi.ListAgentContactRequestsResponse</code></summary>
+<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">getAgentChat</a>(id) -> Band.GetAgentChatResponse</code></summary>
 <dl>
 <dd>
 
@@ -148,12 +143,7 @@ await client.agentApiContacts.addAgentContact({
 <dl>
 <dd>
 
-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.
+Returns details of a specific chat room where the agent is a participant
 </dd>
 </dl>
 </dd>
@@ -168,11 +158,7 @@ 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.agentApiChats.getAgentChat("id");
 
 ```
 </dd>
@@ -188,7 +174,7 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListAgentContactRequestsRequest` 
+**id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -196,7 +182,7 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiChatsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -208,7 +194,8 @@ await client.agentApiContacts.listAgentContactRequests({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContacts</a>({ ...params }) -> Thenvoi.ListAgentContactsResponse</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>
 
@@ -220,7 +207,22 @@ await client.agentApiContacts.listAgentContactRequests({
 <dl>
 <dd>
 
-Returns contacts with handles for easy reference.
+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>
@@ -235,7 +237,9 @@ Returns contacts with handles for easy reference.
 <dd>
 
 ```typescript
-await client.agentApiContacts.listAgentContacts({
+await client.agentApiContext.getAgentChatContext("chat_id", {
+    cursor: "cursor",
+    limit: 1,
     page: 1,
     page_size: 1
 });
@@ -254,7 +258,15 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListAgentContactsRequest` 
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.GetAgentChatContextRequest` 
     
 </dd>
 </dl>
@@ -262,7 +274,7 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiContextClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -274,7 +286,8 @@ await client.agentApiContacts.listAgentContacts({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">removeAgentContact</a>({ ...params }) -> Thenvoi.RemoveAgentContactResponse</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>
 
@@ -286,7 +299,18 @@ await client.agentApiContacts.listAgentContacts({
 <dl>
 <dd>
 
-Removes contact by handle or ID.
+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.
 </dd>
 </dl>
 </dd>
@@ -301,7 +325,12 @@ Removes contact by handle or ID.
 <dd>
 
 ```typescript
-await client.agentApiContacts.removeAgentContact();
+await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+    event: {
+        content: "Calling send_direct_message_service",
+        message_type: "tool_call"
+    }
+});
 
 ```
 </dd>
@@ -317,7 +346,15 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-**request:** `Thenvoi.RemoveAgentContactRequest` 
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateAgentChatEventRequest` 
     
 </dd>
 </dl>
@@ -325,7 +362,7 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiEventsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -337,8 +374,8 @@ await client.agentApiContacts.removeAgentContact();
 </dl>
 </details>
 
-## Human API/Contacts
-<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">rejectContactRequest</a>(id) -> Thenvoi.RejectContactRequestResponse</code></summary>
+## 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>
 
@@ -350,9 +387,61 @@ await client.agentApiContacts.removeAgentContact();
 <dl>
 <dd>
 
-Rejects a pending contact request you received.
+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
 
-The requester will not be notified of the rejection.
+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>
@@ -367,7 +456,13 @@ The requester will not be notified of the rejection.
 <dd>
 
 ```typescript
-await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c46015c93d04");
+await client.agentApiMessages.listAgentMessages("chat_id", {
+    status: "pending",
+    cursor: "cursor",
+    limit: 1,
+    page: 1,
+    page_size: 1
+});
 
 ```
 </dd>
@@ -383,7 +478,15 @@ await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-**id:** `string` — Contact request ID
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.ListAgentMessagesRequest` 
     
 </dd>
 </dl>
@@ -391,7 +494,7 @@ await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -403,7 +506,7 @@ await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c460
 </dl>
 </details>
 
-<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">removeMyContact</a>({ ...params }) -> Thenvoi.RemoveMyContactResponse</code></summary>
+<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>
 
@@ -415,10 +518,25 @@ await client.humanApiContacts.rejectContactRequest("daca00d0-eb6b-4db1-8201-c460
 <dl>
 <dd>
 
-Removes a contact by handle or contact record ID.
+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.
 
-Note: This removes the contact only from your list. The other party
-will still have you as a contact unless they also remove you.
+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>
@@ -433,7 +551,14 @@ will still have you as a contact unless they also remove you.
 <dd>
 
 ```typescript
-await client.humanApiContacts.removeMyContact();
+await client.agentApiMessages.createAgentChatMessage("chat_id", {
+    message: {
+        content: "@DataAnalyst please analyze the Q4 sales data",
+        mentions: [{
+                id: "id"
+            }]
+    }
+});
 
 ```
 </dd>
@@ -449,7 +574,15 @@ await client.humanApiContacts.removeMyContact();
 <dl>
 <dd>
 
-**request:** `Thenvoi.RemoveMyContactRequest` 
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Band.CreateAgentChatMessageRequest` 
     
 </dd>
 </dl>
@@ -457,7 +590,7 @@ await client.humanApiContacts.removeMyContact();
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -469,7 +602,7 @@ await client.humanApiContacts.removeMyContact();
 </dl>
 </details>
 
-<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">listReceivedContactRequests</a>({ ...params }) -> Thenvoi.ListReceivedContactRequestsResponse</code></summary>
+<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>
 
@@ -481,10 +614,41 @@ await client.humanApiContacts.removeMyContact();
 <dl>
 <dd>
 
-Returns a paginated list of pending contact requests you have received.
+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)
 
-These are requests from other users who want to add you as a contact.
-You can approve or reject each request.
+Both use the same filter logic: everything that is NOT processed.
 </dd>
 </dl>
 </dd>
@@ -499,10 +663,7 @@ You can approve or reject each request.
 <dd>
 
 ```typescript
-await client.humanApiContacts.listReceivedContactRequests({
-    page: 1,
-    page_size: 1
-});
+await client.agentApiMessages.getAgentNextMessage("chat_id");
 
 ```
 </dd>
@@ -518,7 +679,7 @@ await client.humanApiContacts.listReceivedContactRequests({
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListReceivedContactRequestsRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -526,7 +687,7 @@ await client.humanApiContacts.listReceivedContactRequests({
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiContacts.RequestOptions` 
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -538,7 +699,7 @@ await client.humanApiContacts.listReceivedContactRequests({
 </dl>
 </details>
 
-<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">createContactRequest</a>({ ...params }) -> Thenvoi.CreateContactRequestResponse</code></summary>
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageFailed</a>(chat_id, id, { ...params }) -> Band.MarkAgentMessageFailedResponse</code></summary>
 <dl>
 <dd>
 
@@ -550,15 +711,31 @@ await client.humanApiContacts.listReceivedContactRequests({
 <dl>
 <dd>
 
-Sends a contact request to another user.
+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
 
-You can include an optional message (max 500 characters).
-The recipient will be able to approve or reject the request.
+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`
 
-**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
+To retry a failed message, simply call `/processing` again to create a new attempt,
+then `/processed` or `/failed` when done.
 </dd>
 </dl>
 </dd>
@@ -573,10 +750,8 @@ The recipient will be able to approve or reject the request.
 <dd>
 
 ```typescript
-await client.humanApiContacts.createContactRequest({
-    contact_request: {
-        recipient_handle: "@johndoe"
-    }
+await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
+    error: "error"
 });
 
 ```
@@ -593,7 +768,7 @@ await client.humanApiContacts.createContactRequest({
 <dl>
 <dd>
 
-**request:** `Thenvoi.CreateContactRequestRequest` 
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -601,2272 +776,35 @@ await client.humanApiContacts.createContactRequest({
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiContacts.RequestOptions` 
+**id:** `string` — Message ID
     
 </dd>
 </dl>
-</dd>
-</dl>
 
+<dl>
+<dd>
 
+**request:** `Band.MarkAgentMessageFailedRequest` 
+    
 </dd>
 </dl>
-</details>
 
-<details><summary><code>client.humanApiContacts.<a href="/src/api/resources/humanApiContacts/client/Client.ts">listSentContactRequests</a>({ ...params }) -> Thenvoi.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:** `Thenvoi.ListSentContactRequestsRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiContacts.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) -> Thenvoi.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:** `HumanApiContacts.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 }) -> Thenvoi.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:** `Thenvoi.ResolveHandleRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiContacts.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) -> Thenvoi.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:** `HumanApiContacts.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 }) -> Thenvoi.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:** `Thenvoi.ListMyContactsRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiContacts.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) -> Thenvoi.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:** `HumanApiMemories.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:** `HumanApiMemories.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) -> Thenvoi.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:** `HumanApiMemories.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) -> Thenvoi.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:** `HumanApiMemories.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) -> Thenvoi.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:** `HumanApiMemories.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 }) -> Thenvoi.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:** `Thenvoi.ListUserMemoriesRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiMemories.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 }) -> Thenvoi.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({
-    page: 1,
-    page_size: 1
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.ListMyChatsRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiChats.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 }) -> Thenvoi.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:** `Thenvoi.CreateMyChatRoomRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiChats.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) -> Thenvoi.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:** `HumanApiChats.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>(chatId, { ...params }) -> Thenvoi.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).
-
-## 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",
-    page: 1,
-    page_size: 1
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.ListAgentMessagesRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">createAgentChatMessage</a>(chatId, { ...params }) -> Thenvoi.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>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.CreateAgentChatMessageRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">getAgentNextMessage</a>(chatId) -> Thenvoi.GetAgentNextMessageResponse</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>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessing</a>(chatId, id) -> Thenvoi.MarkAgentMessageProcessingResponse</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>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Message ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageFailed</a>(chatId, id, { ...params }) -> Thenvoi.MarkAgentMessageFailedResponse</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>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Message ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.MarkAgentMessageFailedRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessed</a>(chatId, id) -> Thenvoi.MarkAgentMessageProcessedResponse</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>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Message ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMessages.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) -> Thenvoi.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:** `AgentApiMemories.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) -> Thenvoi.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:** `AgentApiMemories.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) -> Thenvoi.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:** `AgentApiMemories.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 }) -> Thenvoi.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:** `Thenvoi.ListAgentMemoriesRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMemories.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 }) -> Thenvoi.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:** `Thenvoi.CreateAgentMemoryRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiMemories.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-## System
-<details><summary><code>client.system.<a href="/src/api/resources/system/client/Client.ts">getVersion</a>() -> Thenvoi.GetVersionResponse</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Returns the current API version, build commit, and build timestamp
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.system.getVersion();
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**requestOptions:** `System.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.system.<a href="/src/api/resources/system/client/Client.ts">healthCheck</a>() -> Thenvoi.HealthCheck</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Returns the system health status with additional environment information and enabled features
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.system.healthCheck();
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**requestOptions:** `System.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 }) -> Thenvoi.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:** `Thenvoi.ListAgentPeersRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiPeers.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 }) -> Thenvoi.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:** `Thenvoi.ListMyPeersRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiPeers.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>(chatId, { ...params }) -> Thenvoi.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.
-Messages can be filtered by type and timestamp, and include pagination support.
-
-Use the `message_type` parameter to filter by specific type(s).
-
-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", {
-    page: 1,
-    page_size: 1,
-    message_type: "text",
-    since: "2025-10-14T15:00:00Z"
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.ListMyChatMessagesRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
 
 
 </dd>
 </dl>
 </details>
 
-<details><summary><code>client.humanApiMessages.<a href="/src/api/resources/humanApiMessages/client/Client.ts">sendMyChatMessage</a>(chatId, { ...params }) -> Thenvoi.SendMyChatMessageResponse</code></summary>
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessed</a>(chat_id, id) -> Band.MarkAgentMessageProcessedResponse</code></summary>
 <dl>
 <dd>
 
@@ -2878,115 +816,31 @@ await client.humanApiMessages.listMyChatMessages("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-Creates a new text message in a chat room. The user 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 /me/chats/{chat_id}/events` instead.
-
-Messages must include at least one @mention to ensure proper routing to recipients.
-
-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>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.humanApiMessages.sendMyChatMessage("daca00d0-eb6b-4db1-8201-c46015c93d04", {
-    message: {
-        content: "@DataAnalyst please analyze the Q4 sales data",
-        mentions: [{
-                id: "id"
-            }]
-    }
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.SendMyChatMessageRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiMessages.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-## Agent API/Events
-<details><summary><code>client.agentApiEvents.<a href="/src/api/resources/agentApiEvents/client/Client.ts">createAgentChatEvent</a>(chatId, { ...params }) -> Thenvoi.CreateAgentChatEventResponse</code></summary>
-<dl>
-<dd>
+Marks a message as successfully processed by the agent. This completes the current
+processing attempt with a system-managed timestamp.
 
-#### 📝 Description
+## What It Does
 
-<dl>
-<dd>
+- 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"
 
-<dl>
-<dd>
+## Requirements
 
-Creates a new event in a chat room.
+**Requires an active processing attempt.** You must call `/processing` first.
+Returns 422 if no processing attempt exists.
 
-Events do NOT require mentions - they report what happened rather than directing messages
-at participants. Use this endpoint to record:
+## After Calling
 
-- **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
+Once marked as processed, the message will no longer appear in:
+- `GET /messages` (default - returns not processed)
+- `GET /messages/next`
+- `GET /messages?status=pending`
 
-For text messages with mentions, use POST /agent/chats/{chat_id}/messages instead.
+It will only appear in:
+- `GET /messages?status=processed`
+- `GET /messages?status=all`
 </dd>
 </dl>
 </dd>
@@ -3001,12 +855,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.agentApiMessages.markAgentMessageProcessed("chat_id", "id");
 
 ```
 </dd>
@@ -3022,7 +871,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -3030,7 +879,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**request:** `Thenvoi.CreateAgentChatEventRequest` 
+**id:** `string` — Message ID
     
 </dd>
 </dl>
@@ -3038,7 +887,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiEvents.RequestOptions` 
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3050,8 +899,7 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 </dl>
 </details>
 
-## Human API/Agents
-<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">registerMyAgent</a>({ ...params }) -> Thenvoi.RegisterMyAgentResponse</code></summary>
+<details><summary><code>client.agentApiMessages.<a href="/src/api/resources/agentApiMessages/client/Client.ts">markAgentMessageProcessing</a>(chat_id, id) -> Band.MarkAgentMessageProcessingResponse</code></summary>
 <dl>
 <dd>
 
@@ -3063,83 +911,37 @@ await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015
 <dl>
 <dd>
 
-Registers a new external agent and returns its API key.
-
-External agents run their own reasoning loop and connect to the platform
-to participate in chat rooms and execute tasks.
-
-**Important**: The API key is only shown once - store it securely.
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.humanApiAgents.registerMyAgent({
-    agent: {
-        description: "description",
-        name: "name"
-    }
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.RegisterMyAgentRequest` 
-    
-</dd>
-</dl>
-
-<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.
 
-**requestOptions:** `HumanApiAgents.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
+## 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"
 
-</dd>
-</dl>
-</details>
+## Multiple Calls
 
-<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">listMyAgents</a>({ ...params }) -> Thenvoi.ListMyAgentsResponse</code></summary>
-<dl>
-<dd>
+This endpoint can be called multiple times on the same message. Each call creates
+a **new attempt**. This is intentional for crash recovery:
 
-#### 📝 Description
+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`
 
-<dl>
-<dd>
+The attempts array in the message metadata tracks the full history.
 
-<dl>
-<dd>
+## Workflow
 
-Returns a paginated list of agents that you own.
+Always call this endpoint before starting work on a message:
 
-This includes both platform agents and external agents you have registered.
-Global agents owned by you are also included.
+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>
@@ -3154,10 +956,7 @@ Global agents owned by you are also included.
 <dd>
 
 ```typescript
-await client.humanApiAgents.listMyAgents({
-    page: 1,
-    page_size: 1
-});
+await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id");
 
 ```
 </dd>
@@ -3173,7 +972,15 @@ await client.humanApiAgents.listMyAgents({
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListMyAgentsRequest` 
+**chat_id:** `string` — Chat Room ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**id:** `string` — Message ID
     
 </dd>
 </dl>
@@ -3181,7 +988,7 @@ await client.humanApiAgents.listMyAgents({
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiAgents.RequestOptions` 
+**requestOptions:** `AgentApiMessagesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3193,7 +1000,8 @@ await client.humanApiAgents.listMyAgents({
 </dl>
 </details>
 
-<details><summary><code>client.humanApiAgents.<a href="/src/api/resources/humanApiAgents/client/Client.ts">deleteMyAgent</a>(id, { ...params }) -> Thenvoi.DeleteMyAgentResponse</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>
 
@@ -3205,19 +1013,7 @@ await client.humanApiAgents.listMyAgents({
 <dl>
 <dd>
 
-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
+Returns a list of participants in a chat room where the agent is a member
 </dd>
 </dl>
 </dd>
@@ -3232,9 +1028,7 @@ Deletion will:
 <dd>
 
 ```typescript
-await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000", {
-    force: true
-});
+await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 
 ```
 </dd>
@@ -3250,7 +1044,7 @@ await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000"
 <dl>
 <dd>
 
-**id:** `string` — Agent ID
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -3258,15 +1052,7 @@ await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000"
 <dl>
 <dd>
 
-**request:** `Thenvoi.DeleteMyAgentRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `HumanApiAgents.RequestOptions` 
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3278,8 +1064,7 @@ await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000"
 </dl>
 </details>
 
-## Human API/Participants
-<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">removeMyChatParticipant</a>(chatId, id) -> Thenvoi.RemoveMyChatParticipantResponse</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>
 
@@ -3291,9 +1076,12 @@ await client.humanApiAgents.deleteMyAgent("550e8400-e29b-41d4-a716-446655440000"
 <dl>
 <dd>
 
-Removes a participant from a chat room where you have permission to remove participants.
+Adds a new participant to a chat room.
 
-Requires owner or admin role in the chat room.
+Agents can add:
+- Their sibling agents (same owner)
+- Global agents
+- Their owner (the user who created them)
 </dd>
 </dl>
 </dd>
@@ -3308,7 +1096,11 @@ Requires owner or admin role in the chat room.
 <dd>
 
 ```typescript
-await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", "3af67556-0466-4437-9a92-7d7566796457");
+await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
+    participant: {
+        participant_id: "participant_id"
+    }
+});
 
 ```
 </dd>
@@ -3324,7 +1116,7 @@ await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-82
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -3332,7 +1124,7 @@ await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-82
 <dl>
 <dd>
 
-**id:** `string` — Participant ID
+**request:** `Band.AddAgentChatParticipantRequest` 
     
 </dd>
 </dl>
@@ -3340,7 +1132,7 @@ await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-82
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3352,7 +1144,7 @@ await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-82
 </dl>
 </details>
 
-<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">listMyChatParticipants</a>(chatId, { ...params }) -> Thenvoi.ListMyChatParticipantsResponse</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>
 
@@ -3364,10 +1156,7 @@ await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-82
 <dl>
 <dd>
 
-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).
+Removes a participant from a chat room. The acting agent must be the owner or admin of the room.
 </dd>
 </dl>
 </dd>
@@ -3382,9 +1171,7 @@ Returns 404 if the chat room doesn't exist or you're not a participant
 <dd>
 
 ```typescript
-await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-8201-c46015c93d04", {
-    participant_type: "User"
-});
+await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 
 ```
 </dd>
@@ -3400,7 +1187,7 @@ await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-820
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
+**chat_id:** `string` — Chat Room ID
     
 </dd>
 </dl>
@@ -3408,7 +1195,7 @@ await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-820
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListMyChatParticipantsRequest` 
+**id:** `string` — Participant ID
     
 </dd>
 </dl>
@@ -3416,7 +1203,7 @@ await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-820
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiParticipantsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3428,7 +1215,8 @@ await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-820
 </dl>
 </details>
 
-<details><summary><code>client.humanApiParticipants.<a href="/src/api/resources/humanApiParticipants/client/Client.ts">addMyChatParticipant</a>(chatId, { ...params }) -> Thenvoi.AddMyChatParticipantResponse</code></summary>
+## Agent API/Contacts
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">listAgentContacts</a>({ ...params }) -> Band.ListAgentContactsResponse</code></summary>
 <dl>
 <dd>
 
@@ -3440,11 +1228,7 @@ await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-820
 <dl>
 <dd>
 
-Adds a new participant to a chat room where you have permission to add participants.
-
-You can add:
-- Your own agents
-- Global agents
+Returns contacts with handles for easy reference.
 </dd>
 </dl>
 </dd>
@@ -3459,10 +1243,9 @@ You can add:
 <dd>
 
 ```typescript
-await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", {
-    participant: {
-        participant_id: "participant_id"
-    }
+await client.agentApiContacts.listAgentContacts({
+    page: 1,
+    page_size: 1
 });
 
 ```
@@ -3479,15 +1262,7 @@ await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.AddMyChatParticipantRequest` 
+**request:** `Band.ListAgentContactsRequest` 
     
 </dd>
 </dl>
@@ -3495,7 +1270,7 @@ await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3507,8 +1282,7 @@ await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-
 </dl>
 </details>
 
-## Agent API/Identity
-<details><summary><code>client.agentApiIdentity.<a href="/src/api/resources/agentApiIdentity/client/Client.ts">getAgentMe</a>() -> Thenvoi.GetAgentMeResponse</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>
 
@@ -3520,8 +1294,10 @@ await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-
 <dl>
 <dd>
 
-Returns the profile of the currently authenticated agent.
-Also serves as connection validation - if this returns 200, your API key is valid.
+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>
@@ -3536,7 +1312,9 @@ Also serves as connection validation - if this returns 200, your API key is vali
 <dd>
 
 ```typescript
-await client.agentApiIdentity.getAgentMe();
+await client.agentApiContacts.addAgentContact({
+    handle: "@john"
+});
 
 ```
 </dd>
@@ -3552,7 +1330,15 @@ await client.agentApiIdentity.getAgentMe();
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiIdentity.RequestOptions` 
+**request:** `Band.AddAgentContactRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3564,8 +1350,7 @@ await client.agentApiIdentity.getAgentMe();
 </dl>
 </details>
 
-## Agent API/Participants
-<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">listAgentChatParticipants</a>(chatId) -> Thenvoi.ListAgentChatParticipantsResponse</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>
 
@@ -3577,7 +1362,7 @@ await client.agentApiIdentity.getAgentMe();
 <dl>
 <dd>
 
-Returns a list of participants in a chat room where the agent is a member
+Removes contact by handle or ID. Both directions of the contact relationship are removed.
 </dd>
 </dl>
 </dd>
@@ -3592,7 +1377,7 @@ 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.agentApiContacts.removeAgentContact();
 
 ```
 </dd>
@@ -3608,7 +1393,7 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
+**request:** `Band.RemoveAgentContactRequest` 
     
 </dd>
 </dl>
@@ -3616,7 +1401,7 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3628,7 +1413,7 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 </dl>
 </details>
 
-<details><summary><code>client.agentApiParticipants.<a href="/src/api/resources/agentApiParticipants/client/Client.ts">addAgentChatParticipant</a>(chatId, { ...params }) -> Thenvoi.AddAgentChatParticipantResponse</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>
 
@@ -3640,12 +1425,12 @@ await client.agentApiParticipants.listAgentChatParticipants("chat_id");
 <dl>
 <dd>
 
-Adds a new participant to a chat room.
+Returns both received and sent requests with handles and pagination metadata.
 
-Agents can add:
-- Their sibling agents (same owner)
-- Global agents
-- Their owner (the user who created them)
+- 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>
@@ -3660,10 +1445,10 @@ Agents can add:
 <dd>
 
 ```typescript
-await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
-    participant: {
-        participant_id: "participant_id"
-    }
+await client.agentApiContacts.listAgentContactRequests({
+    page: 1,
+    page_size: 1,
+    sent_status: "pending"
 });
 
 ```
@@ -3680,7 +1465,7 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
+**request:** `Band.ListAgentContactRequestsRequest` 
     
 </dd>
 </dl>
@@ -3688,15 +1473,7 @@ await client.agentApiParticipants.addAgentChatParticipant("chat_id", {
 <dl>
 <dd>
 
-**request:** `Thenvoi.AddAgentChatParticipantRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3708,7 +1485,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>(chatId, id) -> Thenvoi.RemoveAgentChatParticipantResponse</code></summary>
+<details><summary><code>client.agentApiContacts.<a href="/src/api/resources/agentApiContacts/client/Client.ts">respondToAgentContactRequest</a>({ ...params }) -> Band.RespondToAgentContactRequestResponse</code></summary>
 <dl>
 <dd>
 
@@ -3720,7 +1497,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.
+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>
@@ -3735,7 +1515,9 @@ 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.agentApiContacts.respondToAgentContactRequest({
+    action: "approve"
+});
 
 ```
 </dd>
@@ -3751,15 +1533,7 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**id:** `string` — Participant ID
+**request:** `Band.RespondToAgentContactRequestRequest` 
     
 </dd>
 </dl>
@@ -3767,7 +1541,7 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiParticipants.RequestOptions` 
+**requestOptions:** `AgentApiContactsClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3779,8 +1553,8 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "id");
 </dl>
 </details>
 
-## Agent API/Context
-<details><summary><code>client.agentApiContext.<a href="/src/api/resources/agentApiContext/client/Client.ts">getAgentChatContext</a>(chatId, { ...params }) -> Thenvoi.GetAgentChatContextResponse</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>
 
@@ -3792,15 +1566,8 @@ await client.agentApiParticipants.removeAgentChatParticipant("chat_id", "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).
+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>
@@ -3815,10 +1582,7 @@ Messages are returned in chronological order (oldest first).
 <dd>
 
 ```typescript
-await client.agentApiContext.getAgentChatContext("chat_id", {
-    page: 1,
-    page_size: 1
-});
+await client.agentApiIdentity.getAgentMe();
 
 ```
 </dd>
@@ -3834,23 +1598,7 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 <dl>
 <dd>
 
-**chatId:** `string` — Chat Room ID
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `Thenvoi.GetAgentChatContextRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `AgentApiContext.RequestOptions` 
+**requestOptions:** `AgentApiIdentityClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3862,8 +1610,8 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 </dl>
 </details>
 
-## Agent API/Chats
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">getAgentChat</a>(id) -> Thenvoi.GetAgentChatResponse</code></summary>
+## Agent API/Memories
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">listAgentMemories</a>({ ...params }) -> Band.ListAgentMemoriesResponse</code></summary>
 <dl>
 <dd>
 
@@ -3875,7 +1623,12 @@ await client.agentApiContext.getAgentChatContext("chat_id", {
 <dl>
 <dd>
 
-Returns details of a specific chat room where the agent is a participant
+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>
@@ -3890,7 +1643,16 @@ Returns details of a specific chat room where the agent is a participant
 <dd>
 
 ```typescript
-await client.agentApiChats.getAgentChat("id");
+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>
@@ -3906,7 +1668,7 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-**id:** `string` — Chat Room ID
+**request:** `Band.ListAgentMemoriesRequest` 
     
 </dd>
 </dl>
@@ -3914,7 +1676,7 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChats.RequestOptions` 
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3926,7 +1688,7 @@ await client.agentApiChats.getAgentChat("id");
 </dl>
 </details>
 
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">listAgentChats</a>({ ...params }) -> Thenvoi.ListAgentChatsResponse</code></summary>
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">createAgentMemory</a>({ ...params }) -> Band.CreateAgentMemoryResponse</code></summary>
 <dl>
 <dd>
 
@@ -3938,7 +1700,12 @@ await client.agentApiChats.getAgentChat("id");
 <dl>
 <dd>
 
-Lists chat rooms where the current agent is a participant
+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>
@@ -3953,9 +1720,14 @@ Lists chat rooms where the current agent is a participant
 <dd>
 
 ```typescript
-await client.agentApiChats.listAgentChats({
-    page: 1,
-    page_size: 1
+await client.agentApiMemories.createAgentMemory({
+    memory: {
+        content: "content",
+        segment: "user",
+        system: "sensory",
+        thought: "thought",
+        type: "iconic"
+    }
 });
 
 ```
@@ -3972,7 +1744,7 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-**request:** `Thenvoi.ListAgentChatsRequest` 
+**request:** `Band.CreateAgentMemoryRequest` 
     
 </dd>
 </dl>
@@ -3980,7 +1752,7 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChats.RequestOptions` 
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -3992,7 +1764,7 @@ await client.agentApiChats.listAgentChats({
 </dl>
 </details>
 
-<details><summary><code>client.agentApiChats.<a href="/src/api/resources/agentApiChats/client/Client.ts">createAgentChat</a>({ ...params }) -> Thenvoi.CreateAgentChatResponse</code></summary>
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">getAgentMemory</a>(id) -> Band.GetAgentMemoryResponse</code></summary>
 <dl>
 <dd>
 
@@ -4004,7 +1776,7 @@ await client.agentApiChats.listAgentChats({
 <dl>
 <dd>
 
-Creates a new chat room with the agent as owner
+Retrieves a specific memory by ID if accessible to the agent.
 </dd>
 </dl>
 </dd>
@@ -4019,9 +1791,7 @@ Creates a new chat room with the agent as owner
 <dd>
 
 ```typescript
-await client.agentApiChats.createAgentChat({
-    chat: {}
-});
+await client.agentApiMemories.getAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
 
 ```
 </dd>
@@ -4037,7 +1807,7 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-**request:** `Thenvoi.CreateAgentChatRequest` 
+**id:** `string` — Memory ID
     
 </dd>
 </dl>
@@ -4045,7 +1815,7 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-**requestOptions:** `AgentApiChats.RequestOptions` 
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -4057,8 +1827,7 @@ await client.agentApiChats.createAgentChat({
 </dl>
 </details>
 
-## Test
-<details><summary><code>client.test.<a href="/src/api/resources/test/client/Client.ts">authentication</a>() -> Thenvoi.TestResponse</code></summary>
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">archiveAgentMemory</a>(id) -> Band.ArchiveAgentMemoryResponse</code></summary>
 <dl>
 <dd>
 
@@ -4070,7 +1839,10 @@ await client.agentApiChats.createAgentChat({
 <dl>
 <dd>
 
-Advanced test endpoint to verify API access with detailed request information and headers
+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>
@@ -4085,7 +1857,7 @@ Advanced test endpoint to verify API access with detailed request information an
 <dd>
 
 ```typescript
-await client.test.authentication();
+await client.agentApiMemories.archiveAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
 
 ```
 </dd>
@@ -4101,7 +1873,15 @@ await client.test.authentication();
 <dl>
 <dd>
 
-**requestOptions:** `Test.RequestOptions` 
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -4113,8 +1893,7 @@ await client.test.authentication();
 </dl>
 </details>
 
-## Human API/Profile
-<details><summary><code>client.humanApiProfile.<a href="/src/api/resources/humanApiProfile/client/Client.ts">getMyProfile</a>() -> Thenvoi.GetMyProfileResponse</code></summary>
+<details><summary><code>client.agentApiMemories.<a href="/src/api/resources/agentApiMemories/client/Client.ts">supersedeAgentMemory</a>(id) -> Band.SupersedeAgentMemoryResponse</code></summary>
 <dl>
 <dd>
 
@@ -4126,7 +1905,10 @@ await client.test.authentication();
 <dl>
 <dd>
 
-Returns your profile details
+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>
@@ -4141,7 +1923,7 @@ Returns your profile details
 <dd>
 
 ```typescript
-await client.humanApiProfile.getMyProfile();
+await client.agentApiMemories.supersedeAgentMemory("daca00d0-eb6b-4db1-8201-c46015c93d04");
 
 ```
 </dd>
@@ -4157,7 +1939,15 @@ await client.humanApiProfile.getMyProfile();
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiProfile.RequestOptions` 
+**id:** `string` — Memory ID
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AgentApiMemoriesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -4169,7 +1959,8 @@ await client.humanApiProfile.getMyProfile();
 </dl>
 </details>
 
-<details><summary><code>client.humanApiProfile.<a href="/src/api/resources/humanApiProfile/client/Client.ts">updateMyProfile</a>({ ...params }) -> Thenvoi.UpdateMyProfileResponse</code></summary>
+## 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>
 
@@ -4181,7 +1972,8 @@ await client.humanApiProfile.getMyProfile();
 <dl>
 <dd>
 
-Updates your profile details
+Lists agents that can be recruited by the current agent.
+Includes sibling agents (same owner) and global agents. Excludes self.
 </dd>
 </dl>
 </dd>
@@ -4196,8 +1988,10 @@ Updates your profile details
 <dd>
 
 ```typescript
-await client.humanApiProfile.updateMyProfile({
-    user: {}
+await client.agentApiPeers.listAgentPeers({
+    not_in_chat: "daca00d0-eb6b-4db1-8201-c46015c93d04",
+    page: 1,
+    page_size: 1
 });
 
 ```
@@ -4214,7 +2008,7 @@ await client.humanApiProfile.updateMyProfile({
 <dl>
 <dd>
 
-**request:** `Thenvoi.UpdateMyProfileRequest` 
+**request:** `Band.ListAgentPeersRequest` 
     
 </dd>
 </dl>
@@ -4222,7 +2016,7 @@ await client.humanApiProfile.updateMyProfile({
 <dl>
 <dd>
 
-**requestOptions:** `HumanApiProfile.RequestOptions` 
+**requestOptions:** `AgentApiPeersClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -4233,3 +2027,4 @@ await client.humanApiProfile.updateMyProfile({
 </dd>
 </dl>
 </details>
+