lockally 0.2.0 → 0.3.0

data/docs/AgentsApi.md

@@ -4,26 +4,26 @@ All URIs are relative to *https://api.lockally.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**v1_api_keys_key_id_mailboxes_get**](AgentsApi.md#v1_api_keys_key_id_mailboxes_get) | **GET** /v1/api-keys/{keyID}/mailboxes | List a key's mailbox grants |
-| [**v1_api_keys_key_id_mailboxes_mailbox_id_delete**](AgentsApi.md#v1_api_keys_key_id_mailboxes_mailbox_id_delete) | **DELETE** /v1/api-keys/{keyID}/mailboxes/{mailboxID} | Revoke a mailbox grant |
-| [**v1_api_keys_key_id_mailboxes_post**](AgentsApi.md#v1_api_keys_key_id_mailboxes_post) | **POST** /v1/api-keys/{keyID}/mailboxes | Grant a mailbox to a key |
-| [**v1_auth_whoami_get**](AgentsApi.md#v1_auth_whoami_get) | **GET** /v1/auth/whoami | Introspect the calling credentials |
-| [**v1_contacts_lookup_get**](AgentsApi.md#v1_contacts_lookup_get) | **GET** /v1/contacts/lookup | Who is this sender? |
-| [**v1_inboxes_get**](AgentsApi.md#v1_inboxes_get) | **GET** /v1/inboxes | List granted inboxes |
-| [**v1_inboxes_mailbox_messages_post**](AgentsApi.md#v1_inboxes_mailbox_messages_post) | **POST** /v1/inboxes/{mailbox}/messages | Start a new conversation (agent stream) |
-| [**v1_inboxes_mailbox_threads_get**](AgentsApi.md#v1_inboxes_mailbox_threads_get) | **GET** /v1/inboxes/{mailbox}/threads | List conversation threads |
-| [**v1_threads_thread_id_get**](AgentsApi.md#v1_threads_thread_id_get) | **GET** /v1/threads/{threadID} | Get a whole conversation |
-| [**v1_threads_thread_id_messages_message_id_attachments_idx_get**](AgentsApi.md#v1_threads_thread_id_messages_message_id_attachments_idx_get) | **GET** /v1/threads/{threadID}/messages/{messageID}/attachments/{idx} | Download an attachment |
-| [**v1_threads_thread_id_messages_message_id_get**](AgentsApi.md#v1_threads_thread_id_messages_message_id_get) | **GET** /v1/threads/{threadID}/messages/{messageID} | Get one message with body |
-| [**v1_threads_thread_id_messages_message_id_read_post**](AgentsApi.md#v1_threads_thread_id_messages_message_id_read_post) | **POST** /v1/threads/{threadID}/messages/{messageID}/read | Mark read/unread |
-| [**v1_threads_thread_id_reply_post**](AgentsApi.md#v1_threads_thread_id_reply_post) | **POST** /v1/threads/{threadID}/reply | Reply in-thread (agent stream) |
+| [**download_thread_attachment**](AgentsApi.md#download_thread_attachment) | **GET** /v1/threads/{threadID}/messages/{messageID}/attachments/{idx} | Download an attachment |
+| [**get_thread**](AgentsApi.md#get_thread) | **GET** /v1/threads/{threadID} | Get a whole conversation |
+| [**get_thread_message**](AgentsApi.md#get_thread_message) | **GET** /v1/threads/{threadID}/messages/{messageID} | Get one message with body |
+| [**grant_api_key_mailbox**](AgentsApi.md#grant_api_key_mailbox) | **POST** /v1/api-keys/{keyID}/mailboxes | Grant a mailbox to a key |
+| [**list_api_key_mailboxes**](AgentsApi.md#list_api_key_mailboxes) | **GET** /v1/api-keys/{keyID}/mailboxes | List a key's mailbox grants |
+| [**list_inboxes**](AgentsApi.md#list_inboxes) | **GET** /v1/inboxes | List granted inboxes |
+| [**list_threads**](AgentsApi.md#list_threads) | **GET** /v1/inboxes/{mailbox}/threads | List conversation threads |
+| [**lookup_contact**](AgentsApi.md#lookup_contact) | **GET** /v1/contacts/lookup | Who is this sender? |
+| [**mark_thread_message_read**](AgentsApi.md#mark_thread_message_read) | **POST** /v1/threads/{threadID}/messages/{messageID}/read | Mark read/unread |
+| [**reply_to_thread**](AgentsApi.md#reply_to_thread) | **POST** /v1/threads/{threadID}/reply | Reply in-thread (agent stream) |
+| [**revoke_api_key_mailbox**](AgentsApi.md#revoke_api_key_mailbox) | **DELETE** /v1/api-keys/{keyID}/mailboxes/{mailboxID} | Revoke a mailbox grant |
+| [**start_conversation**](AgentsApi.md#start_conversation) | **POST** /v1/inboxes/{mailbox}/messages | Start a new conversation (agent stream) |
+| [**whoami**](AgentsApi.md#whoami) | **GET** /v1/auth/whoami | Introspect the calling credentials |
 
 
-## v1_api_keys_key_id_mailboxes_get
+## download_thread_attachment
 
-> Object v1_api_keys_key_id_mailboxes_get(key_id)
+> download_thread_attachment(thread_id, message_id, idx)
 
-List a key's mailbox grants
+Download an attachment
 
 ### Examples
 
@@ -37,32 +37,33 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+idx = 56 # Integer | 
 
 begin
-  # List a key's mailbox grants
-  result = api_instance.v1_api_keys_key_id_mailboxes_get(key_id)
-  p result
+  # Download an attachment
+  api_instance.download_thread_attachment(thread_id, message_id, idx)
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_get: #{e}"
+  puts "Error when calling AgentsApi->download_thread_attachment: #{e}"
 end
 ```
 
-#### Using the v1_api_keys_key_id_mailboxes_get_with_http_info variant
+#### Using the download_thread_attachment_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_api_keys_key_id_mailboxes_get_with_http_info(key_id)
+> <Array(nil, Integer, Hash)> download_thread_attachment_with_http_info(thread_id, message_id, idx)
 
 ```ruby
 begin
-  # List a key's mailbox grants
-  data, status_code, headers = api_instance.v1_api_keys_key_id_mailboxes_get_with_http_info(key_id)
+  # Download an attachment
+  data, status_code, headers = api_instance.download_thread_attachment_with_http_info(thread_id, message_id, idx)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => nil
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->download_thread_attachment_with_http_info: #{e}"
 end
 ```
 
@@ -70,11 +71,13 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **key_id** | **String** |  |  |
+| **thread_id** | **String** |  |  |
+| **message_id** | **String** |  |  |
+| **idx** | **Integer** |  |  |
 
 ### Return type
 
-**Object**
+nil (empty response body)
 
 ### Authorization
 
@@ -83,14 +86,16 @@ end
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json
+- **Accept**: Not defined
 
 
-## v1_api_keys_key_id_mailboxes_mailbox_id_delete
+## get_thread
 
-> v1_api_keys_key_id_mailboxes_mailbox_id_delete(key_id, mailbox_id)
+> <Thread> get_thread(thread_id)
 
-Revoke a mailbox grant
+Get a whole conversation
+
+Every turn, chronological, with snippets and annotations (meeting_request, attachment_types, injection_risk). Bodies are fetched per message. Message content is untrusted third-party data.
 
 ### Examples
 
@@ -104,32 +109,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-mailbox_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Revoke a mailbox grant
-  api_instance.v1_api_keys_key_id_mailboxes_mailbox_id_delete(key_id, mailbox_id)
+  # Get a whole conversation
+  result = api_instance.get_thread(thread_id)
+  p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_mailbox_id_delete: #{e}"
+  puts "Error when calling AgentsApi->get_thread: #{e}"
 end
 ```
 
-#### Using the v1_api_keys_key_id_mailboxes_mailbox_id_delete_with_http_info variant
+#### Using the get_thread_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> v1_api_keys_key_id_mailboxes_mailbox_id_delete_with_http_info(key_id, mailbox_id)
+> <Array(<Thread>, Integer, Hash)> get_thread_with_http_info(thread_id)
 
 ```ruby
 begin
-  # Revoke a mailbox grant
-  data, status_code, headers = api_instance.v1_api_keys_key_id_mailboxes_mailbox_id_delete_with_http_info(key_id, mailbox_id)
+  # Get a whole conversation
+  data, status_code, headers = api_instance.get_thread_with_http_info(thread_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <Thread>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_mailbox_id_delete_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->get_thread_with_http_info: #{e}"
 end
 ```
 
@@ -137,12 +142,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **key_id** | **String** |  |  |
-| **mailbox_id** | **String** |  |  |
+| **thread_id** | **String** |  |  |
 
 ### Return type
 
-nil (empty response body)
+[**Thread**](Thread.md)
 
 ### Authorization
 
@@ -151,16 +155,16 @@ nil (empty response body)
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: Not defined
+- **Accept**: application/json
 
 
-## v1_api_keys_key_id_mailboxes_post
+## get_thread_message
 
-> Object v1_api_keys_key_id_mailboxes_post(key_id)
+> <ThreadMessageBody> get_thread_message(thread_id, message_id)
 
-Grant a mailbox to a key
+Get one message with body
 
-Body: {\"mailbox\": \"email or id\"}. Refused (422) for mailboxes with agent access disabled or an active E2E encryption key — the server cannot read E2E mailboxes.
+Full text/html body fetched on demand from mail storage. Never marks the message read.
 
 ### Examples
 
@@ -174,32 +178,33 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Grant a mailbox to a key
-  result = api_instance.v1_api_keys_key_id_mailboxes_post(key_id)
+  # Get one message with body
+  result = api_instance.get_thread_message(thread_id, message_id)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_post: #{e}"
+  puts "Error when calling AgentsApi->get_thread_message: #{e}"
 end
 ```
 
-#### Using the v1_api_keys_key_id_mailboxes_post_with_http_info variant
+#### Using the get_thread_message_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_api_keys_key_id_mailboxes_post_with_http_info(key_id)
+> <Array(<ThreadMessageBody>, Integer, Hash)> get_thread_message_with_http_info(thread_id, message_id)
 
 ```ruby
 begin
-  # Grant a mailbox to a key
-  data, status_code, headers = api_instance.v1_api_keys_key_id_mailboxes_post_with_http_info(key_id)
+  # Get one message with body
+  data, status_code, headers = api_instance.get_thread_message_with_http_info(thread_id, message_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <ThreadMessageBody>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_api_keys_key_id_mailboxes_post_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->get_thread_message_with_http_info: #{e}"
 end
 ```
 
@@ -207,11 +212,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **key_id** | **String** |  |  |
+| **thread_id** | **String** |  |  |
+| **message_id** | **String** |  |  |
 
 ### Return type
 
-**Object**
+[**ThreadMessageBody**](ThreadMessageBody.md)
 
 ### Authorization
 
@@ -223,13 +229,13 @@ end
 - **Accept**: application/json
 
 
-## v1_auth_whoami_get
+## grant_api_key_mailbox
 
-> Object v1_auth_whoami_get
+> <MailboxGrant> grant_api_key_mailbox(key_id)
 
-Introspect the calling credentials
+Grant a mailbox to a key
 
-Returns the tenant, auth kind (api_key/session), key label, and granted scopes. The MCP server uses this to scope-filter tool discovery.
+Body: {\"mailbox\": \"email or id\"}. Refused (422) for mailboxes with agent access disabled or an active E2E encryption key — the server cannot read E2E mailboxes.
 
 ### Examples
 
@@ -243,41 +249,44 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
+key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Introspect the calling credentials
-  result = api_instance.v1_auth_whoami_get
+  # Grant a mailbox to a key
+  result = api_instance.grant_api_key_mailbox(key_id)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_auth_whoami_get: #{e}"
+  puts "Error when calling AgentsApi->grant_api_key_mailbox: #{e}"
 end
 ```
 
-#### Using the v1_auth_whoami_get_with_http_info variant
+#### Using the grant_api_key_mailbox_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_auth_whoami_get_with_http_info
+> <Array(<MailboxGrant>, Integer, Hash)> grant_api_key_mailbox_with_http_info(key_id)
 
 ```ruby
 begin
-  # Introspect the calling credentials
-  data, status_code, headers = api_instance.v1_auth_whoami_get_with_http_info
+  # Grant a mailbox to a key
+  data, status_code, headers = api_instance.grant_api_key_mailbox_with_http_info(key_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <MailboxGrant>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_auth_whoami_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->grant_api_key_mailbox_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-This endpoint does not need any parameter.
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_id** | **String** |  |  |
 
 ### Return type
 
-**Object**
+[**MailboxGrant**](MailboxGrant.md)
 
 ### Authorization
 
@@ -289,13 +298,11 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## v1_contacts_lookup_get
+## list_api_key_mailboxes
 
-> Object v1_contacts_lookup_get(email)
-
-Who is this sender?
+> <MailboxGrantList> list_api_key_mailboxes(key_id)
 
-Directory record (name, company, role, notes), whether the address is one of the tenant's own mailboxes, and grant-aware correspondence history (thread count, first/last seen across granted mailboxes only).
+List a key's mailbox grants
 
 ### Examples
 
@@ -309,32 +316,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-email = 'email_example' # String | 
+key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Who is this sender?
-  result = api_instance.v1_contacts_lookup_get(email)
+  # List a key's mailbox grants
+  result = api_instance.list_api_key_mailboxes(key_id)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_contacts_lookup_get: #{e}"
+  puts "Error when calling AgentsApi->list_api_key_mailboxes: #{e}"
 end
 ```
 
-#### Using the v1_contacts_lookup_get_with_http_info variant
+#### Using the list_api_key_mailboxes_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_contacts_lookup_get_with_http_info(email)
+> <Array(<MailboxGrantList>, Integer, Hash)> list_api_key_mailboxes_with_http_info(key_id)
 
 ```ruby
 begin
-  # Who is this sender?
-  data, status_code, headers = api_instance.v1_contacts_lookup_get_with_http_info(email)
+  # List a key's mailbox grants
+  data, status_code, headers = api_instance.list_api_key_mailboxes_with_http_info(key_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <MailboxGrantList>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_contacts_lookup_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->list_api_key_mailboxes_with_http_info: #{e}"
 end
 ```
 
@@ -342,11 +349,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **email** | **String** |  |  |
+| **key_id** | **String** |  |  |
 
 ### Return type
 
-**Object**
+[**MailboxGrantList**](MailboxGrantList.md)
 
 ### Authorization
 
@@ -358,9 +365,9 @@ end
 - **Accept**: application/json
 
 
-## v1_inboxes_get
+## list_inboxes
 
-> Object v1_inboxes_get
+> <InboxList> list_inboxes
 
 List granted inboxes
 
@@ -381,28 +388,28 @@ api_instance = Lockally::AgentsApi.new
 
 begin
   # List granted inboxes
-  result = api_instance.v1_inboxes_get
+  result = api_instance.list_inboxes
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_get: #{e}"
+  puts "Error when calling AgentsApi->list_inboxes: #{e}"
 end
 ```
 
-#### Using the v1_inboxes_get_with_http_info variant
+#### Using the list_inboxes_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_inboxes_get_with_http_info
+> <Array(<InboxList>, Integer, Hash)> list_inboxes_with_http_info
 
 ```ruby
 begin
   # List granted inboxes
-  data, status_code, headers = api_instance.v1_inboxes_get_with_http_info
+  data, status_code, headers = api_instance.list_inboxes_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <InboxList>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->list_inboxes_with_http_info: #{e}"
 end
 ```
 
@@ -412,7 +419,7 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-**Object**
+[**InboxList**](InboxList.md)
 
 ### Authorization
 
@@ -424,13 +431,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## v1_inboxes_mailbox_messages_post
+## list_threads
 
-> Object v1_inboxes_mailbox_messages_post(mailbox, idempotency_key, v1_inboxes_mailbox_messages_post_request)
+> <ThreadList> list_threads(mailbox, opts)
 
-Start a new conversation (agent stream)
+List conversation threads
 
-Sends a new email from a granted mailbox. Classified stream=agent (isolated reputation, per-key rate caps). The first inbound reply adopts the created thread via the References chain. Idempotency-Key required. Mailboxes with agent_draft_policy=always_approve divert this into a pending draft.
+Newest-active first. Cursors: `?before=<RFC3339>` pages backwards; `?since=<RFC3339>` delta-syncs forward (oldest first) so an agent can catch up in order.
 
 ### Examples
 
@@ -444,34 +451,37 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-mailbox = 'mailbox_example' # String | 
-idempotency_key = 'idempotency_key_example' # String | 
-v1_inboxes_mailbox_messages_post_request = Lockally::V1InboxesMailboxMessagesPostRequest.new({to: ['to_example'], text: 'text_example'}) # V1InboxesMailboxMessagesPostRequest | 
+mailbox = 'mailbox_example' # String | mailbox email or id
+opts = {
+  since: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
+  before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
+  limit: 56 # Integer | 
+}
 
 begin
-  # Start a new conversation (agent stream)
-  result = api_instance.v1_inboxes_mailbox_messages_post(mailbox, idempotency_key, v1_inboxes_mailbox_messages_post_request)
+  # List conversation threads
+  result = api_instance.list_threads(mailbox, opts)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_mailbox_messages_post: #{e}"
+  puts "Error when calling AgentsApi->list_threads: #{e}"
 end
 ```
 
-#### Using the v1_inboxes_mailbox_messages_post_with_http_info variant
+#### Using the list_threads_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_inboxes_mailbox_messages_post_with_http_info(mailbox, idempotency_key, v1_inboxes_mailbox_messages_post_request)
+> <Array(<ThreadList>, Integer, Hash)> list_threads_with_http_info(mailbox, opts)
 
 ```ruby
 begin
-  # Start a new conversation (agent stream)
-  data, status_code, headers = api_instance.v1_inboxes_mailbox_messages_post_with_http_info(mailbox, idempotency_key, v1_inboxes_mailbox_messages_post_request)
+  # List conversation threads
+  data, status_code, headers = api_instance.list_threads_with_http_info(mailbox, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <ThreadList>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_mailbox_messages_post_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->list_threads_with_http_info: #{e}"
 end
 ```
 
@@ -479,13 +489,14 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **mailbox** | **String** |  |  |
-| **idempotency_key** | **String** |  |  |
-| **v1_inboxes_mailbox_messages_post_request** | [**V1InboxesMailboxMessagesPostRequest**](V1InboxesMailboxMessagesPostRequest.md) |  |  |
+| **mailbox** | **String** | mailbox email or id |  |
+| **since** | **Time** |  | [optional] |
+| **before** | **Time** |  | [optional] |
+| **limit** | **Integer** |  | [optional][default to 50] |
 
 ### Return type
 
-**Object**
+[**ThreadList**](ThreadList.md)
 
 ### Authorization
 
@@ -493,17 +504,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## v1_inboxes_mailbox_threads_get
+## lookup_contact
 
-> Object v1_inboxes_mailbox_threads_get(mailbox, opts)
+> <ContactLookup> lookup_contact(email)
 
-List conversation threads
+Who is this sender?
 
-Newest-active first. Cursors: `?before=<RFC3339>` pages backwards; `?since=<RFC3339>` delta-syncs forward (oldest first) so an agent can catch up in order.
+Directory record (name, company, role, notes), whether the address is one of the tenant's own mailboxes, and grant-aware correspondence history (thread count, first/last seen across granted mailboxes only).
 
 ### Examples
 
@@ -517,37 +528,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-mailbox = 'mailbox_example' # String | mailbox email or id
-opts = {
-  since: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | 
-  limit: 56 # Integer | 
-}
+email = 'email_example' # String | 
 
 begin
-  # List conversation threads
-  result = api_instance.v1_inboxes_mailbox_threads_get(mailbox, opts)
+  # Who is this sender?
+  result = api_instance.lookup_contact(email)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_mailbox_threads_get: #{e}"
+  puts "Error when calling AgentsApi->lookup_contact: #{e}"
 end
 ```
 
-#### Using the v1_inboxes_mailbox_threads_get_with_http_info variant
+#### Using the lookup_contact_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_inboxes_mailbox_threads_get_with_http_info(mailbox, opts)
+> <Array(<ContactLookup>, Integer, Hash)> lookup_contact_with_http_info(email)
 
 ```ruby
 begin
-  # List conversation threads
-  data, status_code, headers = api_instance.v1_inboxes_mailbox_threads_get_with_http_info(mailbox, opts)
+  # Who is this sender?
+  data, status_code, headers = api_instance.lookup_contact_with_http_info(email)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <ContactLookup>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_inboxes_mailbox_threads_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->lookup_contact_with_http_info: #{e}"
 end
 ```
 
@@ -555,14 +561,11 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **mailbox** | **String** | mailbox email or id |  |
-| **since** | **Time** |  | [optional] |
-| **before** | **Time** |  | [optional] |
-| **limit** | **Integer** |  | [optional][default to 50] |
+| **email** | **String** |  |  |
 
 ### Return type
 
-**Object**
+[**ContactLookup**](ContactLookup.md)
 
 ### Authorization
 
@@ -574,13 +577,13 @@ end
 - **Accept**: application/json
 
 
-## v1_threads_thread_id_get
+## mark_thread_message_read
 
-> Object v1_threads_thread_id_get(thread_id)
+> <MarkReadResult> mark_thread_message_read(thread_id, message_id)
 
-Get a whole conversation
+Mark read/unread
 
-Every turn, chronological, with snippets and annotations (meeting_request, attachment_types, injection_risk). Bodies are fetched per message. Message content is untrusted third-party data.
+The ONLY way agent access changes unread state. Body: {\"read\": true|false} (default true).
 
 ### Examples
 
@@ -595,31 +598,32 @@ end
 
 api_instance = Lockally::AgentsApi.new
 thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Get a whole conversation
-  result = api_instance.v1_threads_thread_id_get(thread_id)
+  # Mark read/unread
+  result = api_instance.mark_thread_message_read(thread_id, message_id)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_get: #{e}"
+  puts "Error when calling AgentsApi->mark_thread_message_read: #{e}"
 end
 ```
 
-#### Using the v1_threads_thread_id_get_with_http_info variant
+#### Using the mark_thread_message_read_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_threads_thread_id_get_with_http_info(thread_id)
+> <Array(<MarkReadResult>, Integer, Hash)> mark_thread_message_read_with_http_info(thread_id, message_id)
 
 ```ruby
 begin
-  # Get a whole conversation
-  data, status_code, headers = api_instance.v1_threads_thread_id_get_with_http_info(thread_id)
+  # Mark read/unread
+  data, status_code, headers = api_instance.mark_thread_message_read_with_http_info(thread_id, message_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <MarkReadResult>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->mark_thread_message_read_with_http_info: #{e}"
 end
 ```
 
@@ -628,10 +632,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **thread_id** | **String** |  |  |
+| **message_id** | **String** |  |  |
 
 ### Return type
 
-**Object**
+[**MarkReadResult**](MarkReadResult.md)
 
 ### Authorization
 
@@ -643,11 +648,13 @@ end
 - **Accept**: application/json
 
 
-## v1_threads_thread_id_messages_message_id_attachments_idx_get
+## reply_to_thread
 
-> v1_threads_thread_id_messages_message_id_attachments_idx_get(thread_id, message_id, idx)
+> <AgentSendResult> reply_to_thread(thread_id, idempotency_key)
 
-Download an attachment
+Reply in-thread (agent stream)
+
+The server builds In-Reply-To/References and defaults recipients + subject from the conversation — a minimal call is {\"text\": \"...\"}. Guarded by the reply-loop detector (≥5 outbound/10min → 429 + agent.loop_detected). Idempotency-Key required.
 
 ### Examples
 
@@ -662,32 +669,32 @@ end
 
 api_instance = Lockally::AgentsApi.new
 thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-idx = 56 # Integer | 
+idempotency_key = 'idempotency_key_example' # String | 
 
 begin
-  # Download an attachment
-  api_instance.v1_threads_thread_id_messages_message_id_attachments_idx_get(thread_id, message_id, idx)
+  # Reply in-thread (agent stream)
+  result = api_instance.reply_to_thread(thread_id, idempotency_key)
+  p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_attachments_idx_get: #{e}"
+  puts "Error when calling AgentsApi->reply_to_thread: #{e}"
 end
 ```
 
-#### Using the v1_threads_thread_id_messages_message_id_attachments_idx_get_with_http_info variant
+#### Using the reply_to_thread_with_http_info variant
 
-This returns an Array which contains the response data (`nil` in this case), status code and headers.
+This returns an Array which contains the response data, status code and headers.
 
-> <Array(nil, Integer, Hash)> v1_threads_thread_id_messages_message_id_attachments_idx_get_with_http_info(thread_id, message_id, idx)
+> <Array(<AgentSendResult>, Integer, Hash)> reply_to_thread_with_http_info(thread_id, idempotency_key)
 
 ```ruby
 begin
-  # Download an attachment
-  data, status_code, headers = api_instance.v1_threads_thread_id_messages_message_id_attachments_idx_get_with_http_info(thread_id, message_id, idx)
+  # Reply in-thread (agent stream)
+  data, status_code, headers = api_instance.reply_to_thread_with_http_info(thread_id, idempotency_key)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => nil
+  p data # => <AgentSendResult>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_attachments_idx_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->reply_to_thread_with_http_info: #{e}"
 end
 ```
 
@@ -696,12 +703,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **thread_id** | **String** |  |  |
-| **message_id** | **String** |  |  |
-| **idx** | **Integer** |  |  |
+| **idempotency_key** | **String** |  |  |
 
 ### Return type
 
-nil (empty response body)
+[**AgentSendResult**](AgentSendResult.md)
 
 ### Authorization
 
@@ -710,16 +716,14 @@ nil (empty response body)
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: Not defined
-
+- **Accept**: application/json
 
-## v1_threads_thread_id_messages_message_id_get
 
-> Object v1_threads_thread_id_messages_message_id_get(thread_id, message_id)
+## revoke_api_key_mailbox
 
-Get one message with body
+> revoke_api_key_mailbox(key_id, mailbox_id)
 
-Full text/html body fetched on demand from mail storage. Never marks the message read.
+Revoke a mailbox grant
 
 ### Examples
 
@@ -733,33 +737,32 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+key_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+mailbox_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
 
 begin
-  # Get one message with body
-  result = api_instance.v1_threads_thread_id_messages_message_id_get(thread_id, message_id)
-  p result
+  # Revoke a mailbox grant
+  api_instance.revoke_api_key_mailbox(key_id, mailbox_id)
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_get: #{e}"
+  puts "Error when calling AgentsApi->revoke_api_key_mailbox: #{e}"
 end
 ```
 
-#### Using the v1_threads_thread_id_messages_message_id_get_with_http_info variant
+#### Using the revoke_api_key_mailbox_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_threads_thread_id_messages_message_id_get_with_http_info(thread_id, message_id)
+> <Array(nil, Integer, Hash)> revoke_api_key_mailbox_with_http_info(key_id, mailbox_id)
 
 ```ruby
 begin
-  # Get one message with body
-  data, status_code, headers = api_instance.v1_threads_thread_id_messages_message_id_get_with_http_info(thread_id, message_id)
+  # Revoke a mailbox grant
+  data, status_code, headers = api_instance.revoke_api_key_mailbox_with_http_info(key_id, mailbox_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => nil
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_get_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->revoke_api_key_mailbox_with_http_info: #{e}"
 end
 ```
 
@@ -767,12 +770,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **thread_id** | **String** |  |  |
-| **message_id** | **String** |  |  |
+| **key_id** | **String** |  |  |
+| **mailbox_id** | **String** |  |  |
 
 ### Return type
 
-**Object**
+nil (empty response body)
 
 ### Authorization
 
@@ -781,16 +784,16 @@ end
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json
+- **Accept**: Not defined
 
 
-## v1_threads_thread_id_messages_message_id_read_post
+## start_conversation
 
-> Object v1_threads_thread_id_messages_message_id_read_post(thread_id, message_id)
+> <AgentSendResult> start_conversation(mailbox, idempotency_key, start_conversation_request)
 
-Mark read/unread
+Start a new conversation (agent stream)
 
-The ONLY way agent access changes unread state. Body: {\"read\": true|false} (default true).
+Sends a new email from a granted mailbox. Classified stream=agent (isolated reputation, per-key rate caps). The first inbound reply adopts the created thread via the References chain. Idempotency-Key required. Mailboxes with agent_draft_policy=always_approve divert this into a pending draft.
 
 ### Examples
 
@@ -804,33 +807,34 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-message_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+mailbox = 'mailbox_example' # String | 
+idempotency_key = 'idempotency_key_example' # String | 
+start_conversation_request = Lockally::StartConversationRequest.new({to: ['to_example'], text: 'text_example'}) # StartConversationRequest | 
 
 begin
-  # Mark read/unread
-  result = api_instance.v1_threads_thread_id_messages_message_id_read_post(thread_id, message_id)
+  # Start a new conversation (agent stream)
+  result = api_instance.start_conversation(mailbox, idempotency_key, start_conversation_request)
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_read_post: #{e}"
+  puts "Error when calling AgentsApi->start_conversation: #{e}"
 end
 ```
 
-#### Using the v1_threads_thread_id_messages_message_id_read_post_with_http_info variant
+#### Using the start_conversation_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_threads_thread_id_messages_message_id_read_post_with_http_info(thread_id, message_id)
+> <Array(<AgentSendResult>, Integer, Hash)> start_conversation_with_http_info(mailbox, idempotency_key, start_conversation_request)
 
 ```ruby
 begin
-  # Mark read/unread
-  data, status_code, headers = api_instance.v1_threads_thread_id_messages_message_id_read_post_with_http_info(thread_id, message_id)
+  # Start a new conversation (agent stream)
+  data, status_code, headers = api_instance.start_conversation_with_http_info(mailbox, idempotency_key, start_conversation_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <AgentSendResult>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_messages_message_id_read_post_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->start_conversation_with_http_info: #{e}"
 end
 ```
 
@@ -838,12 +842,13 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **thread_id** | **String** |  |  |
-| **message_id** | **String** |  |  |
+| **mailbox** | **String** |  |  |
+| **idempotency_key** | **String** |  |  |
+| **start_conversation_request** | [**StartConversationRequest**](StartConversationRequest.md) |  |  |
 
 ### Return type
 
-**Object**
+[**AgentSendResult**](AgentSendResult.md)
 
 ### Authorization
 
@@ -851,17 +856,17 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
-## v1_threads_thread_id_reply_post
+## whoami
 
-> Object v1_threads_thread_id_reply_post(thread_id, idempotency_key)
+> <Whoami> whoami
 
-Reply in-thread (agent stream)
+Introspect the calling credentials
 
-The server builds In-Reply-To/References and defaults recipients + subject from the conversation — a minimal call is {\"text\": \"...\"}. Guarded by the reply-loop detector (≥5 outbound/10min → 429 + agent.loop_detected). Idempotency-Key required.
+Returns the tenant, auth kind (api_key/session), key label, and granted scopes. The MCP server uses this to scope-filter tool discovery.
 
 ### Examples
 
@@ -875,46 +880,41 @@ Lockally.configure do |config|
 end
 
 api_instance = Lockally::AgentsApi.new
-thread_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
-idempotency_key = 'idempotency_key_example' # String | 
 
 begin
-  # Reply in-thread (agent stream)
-  result = api_instance.v1_threads_thread_id_reply_post(thread_id, idempotency_key)
+  # Introspect the calling credentials
+  result = api_instance.whoami
   p result
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_reply_post: #{e}"
+  puts "Error when calling AgentsApi->whoami: #{e}"
 end
 ```
 
-#### Using the v1_threads_thread_id_reply_post_with_http_info variant
+#### Using the whoami_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Object, Integer, Hash)> v1_threads_thread_id_reply_post_with_http_info(thread_id, idempotency_key)
+> <Array(<Whoami>, Integer, Hash)> whoami_with_http_info
 
 ```ruby
 begin
-  # Reply in-thread (agent stream)
-  data, status_code, headers = api_instance.v1_threads_thread_id_reply_post_with_http_info(thread_id, idempotency_key)
+  # Introspect the calling credentials
+  data, status_code, headers = api_instance.whoami_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Object
+  p data # => <Whoami>
 rescue Lockally::ApiError => e
-  puts "Error when calling AgentsApi->v1_threads_thread_id_reply_post_with_http_info: #{e}"
+  puts "Error when calling AgentsApi->whoami_with_http_info: #{e}"
 end
 ```
 
 ### Parameters
 
-| Name | Type | Description | Notes |
-| ---- | ---- | ----------- | ----- |
-| **thread_id** | **String** |  |  |
-| **idempotency_key** | **String** |  |  |
+This endpoint does not need any parameter.
 
 ### Return type
 
-**Object**
+[**Whoami**](Whoami.md)
 
 ### Authorization