lockally 0.2.0 → 0.3.0

data/lib/lockally.rb

@@ -26,6 +26,11 @@ require 'lockally/models/add_on'
 require 'lockally/models/add_shared_member_request'
 require 'lockally/models/admin'
 require 'lockally/models/admin_full'
+require 'lockally/models/admin_login200_response'
+require 'lockally/models/admin_login_request'
+require 'lockally/models/agent_send_result'
+require 'lockally/models/ai_config'
+require 'lockally/models/ai_config_update'
 require 'lockally/models/audit_event'
 require 'lockally/models/batch_lookup_public_keys200_response'
 require 'lockally/models/batch_lookup_public_keys200_response_data_inner'
@@ -38,6 +43,13 @@ require 'lockally/models/calendar_member'
 require 'lockally/models/calendar_policies'
 require 'lockally/models/contact'
 require 'lockally/models/contact_list'
+require 'lockally/models/contact_lookup'
+require 'lockally/models/contact_lookup_contact'
+require 'lockally/models/contact_lookup_history'
+require 'lockally/models/create_ai_units_checkout200_response'
+require 'lockally/models/create_alias_request'
+require 'lockally/models/create_api_key201_response'
+require 'lockally/models/create_api_key_request'
 require 'lockally/models/create_billing_checkout200_response'
 require 'lockally/models/create_billing_checkout_request'
 require 'lockally/models/create_calendar_event_request'
@@ -47,16 +59,20 @@ require 'lockally/models/create_contact_list_request'
 require 'lockally/models/create_contact_request'
 require 'lockally/models/create_dedicated_ip_request_request'
 require 'lockally/models/create_distribution_list_request'
+require 'lockally/models/create_domain_request'
 require 'lockally/models/create_encryption_key201_response'
 require 'lockally/models/create_encryption_key_request'
 require 'lockally/models/create_encryption_recovery_request'
+require 'lockally/models/create_mailbox_request'
 require 'lockally/models/create_migration_credential_request'
 require 'lockally/models/create_migration_credential_request_credentials'
 require 'lockally/models/create_migration_request'
 require 'lockally/models/create_resource_request'
+require 'lockally/models/create_suppression_request'
 require 'lockally/models/create_units_checkout200_response'
 require 'lockally/models/create_units_checkout_request'
 require 'lockally/models/create_user_request'
+require 'lockally/models/create_webhook_request'
 require 'lockally/models/dns_record'
 require 'lockally/models/dedicated_ip_request'
 require 'lockally/models/directory_permissions'
@@ -64,6 +80,10 @@ require 'lockally/models/discover_migration202_response'
 require 'lockally/models/distribution_list_detail'
 require 'lockally/models/distribution_list_summary'
 require 'lockally/models/domain'
+require 'lockally/models/draft'
+require 'lockally/models/draft_list'
+require 'lockally/models/draft_result'
+require 'lockally/models/export_mailbox201_response'
 require 'lockally/models/gal_settings'
 require 'lockally/models/get_add_on_status200_response'
 require 'lockally/models/get_audit_summary200_response'
@@ -78,6 +98,7 @@ require 'lockally/models/get_contact_list200_response'
 require 'lockally/models/get_contact_list200_response_members_inner'
 require 'lockally/models/get_contact_lists200_response'
 require 'lockally/models/get_contact_lists200_response_data_inner'
+require 'lockally/models/get_current_admin200_response'
 require 'lockally/models/get_directory_activity200_response'
 require 'lockally/models/get_directory_activity200_response_data_inner'
 require 'lockally/models/get_directory_stats200_response'
@@ -95,9 +116,16 @@ require 'lockally/models/get_security200_response_stats_inner'
 require 'lockally/models/get_storage200_response'
 require 'lockally/models/get_storage200_response_top_mailboxes_inner'
 require 'lockally/models/get_storage200_response_top_messages_inner'
+require 'lockally/models/get_usage200_response'
 require 'lockally/models/get_user_insights200_response'
-require 'lockally/models/healthz_get200_response'
+require 'lockally/models/health_check200_response'
+require 'lockally/models/inbox'
+require 'lockally/models/inbox_list'
+require 'lockally/models/invite_admin_request'
 require 'lockally/models/list_add_ons200_response'
+require 'lockally/models/list_admins200_response'
+require 'lockally/models/list_aliases200_response'
+require 'lockally/models/list_api_keys200_response'
 require 'lockally/models/list_calendar_events200_response'
 require 'lockally/models/list_calendar_integrations200_response'
 require 'lockally/models/list_calendar_members200_response'
@@ -106,16 +134,26 @@ require 'lockally/models/list_contact_lists200_response'
 require 'lockally/models/list_contacts200_response'
 require 'lockally/models/list_dedicated_ip_requests200_response'
 require 'lockally/models/list_distribution_lists200_response'
+require 'lockally/models/list_domains200_response'
+require 'lockally/models/list_mailboxes200_response'
+require 'lockally/models/list_messages200_response'
 require 'lockally/models/list_migration_credentials200_response'
 require 'lockally/models/list_migration_events200_response'
 require 'lockally/models/list_migration_mailboxes200_response'
 require 'lockally/models/list_migrations200_response'
 require 'lockally/models/list_resources200_response'
 require 'lockally/models/list_shared_members200_response'
+require 'lockally/models/list_suppressions200_response'
+require 'lockally/models/list_templates200_response'
 require 'lockally/models/list_users200_response'
+require 'lockally/models/list_vacation_responders200_response'
+require 'lockally/models/list_webhooks200_response'
 require 'lockally/models/mailbox'
+require 'lockally/models/mailbox_grant'
+require 'lockally/models/mailbox_grant_list'
 require 'lockally/models/map_migration_request'
 require 'lockally/models/map_migration_request_mappings_inner'
+require 'lockally/models/mark_read_result'
 require 'lockally/models/message'
 require 'lockally/models/message_detail'
 require 'lockally/models/message_stats'
@@ -138,15 +176,32 @@ require 'lockally/models/resource'
 require 'lockally/models/return_path'
 require 'lockally/models/return_path_check'
 require 'lockally/models/rotate_encryption_key_request'
+require 'lockally/models/send_email200_response'
+require 'lockally/models/send_email202_response'
+require 'lockally/models/send_email_batch200_response'
+require 'lockally/models/send_email_batch_request'
+require 'lockally/models/send_email_request'
+require 'lockally/models/send_email_request_attachments_inner'
 require 'lockally/models/send_message'
+require 'lockally/models/set_vacation_responder_request'
 require 'lockally/models/shared_member'
 require 'lockally/models/signup_request'
+require 'lockally/models/simulated_inbound'
+require 'lockally/models/start_conversation_request'
 require 'lockally/models/start_migration202_response'
 require 'lockally/models/suppression'
 require 'lockally/models/template'
 require 'lockally/models/template_input'
 require 'lockally/models/tenant'
+require 'lockally/models/thread'
+require 'lockally/models/thread_classification'
+require 'lockally/models/thread_list'
+require 'lockally/models/thread_message'
+require 'lockally/models/thread_message_body'
+require 'lockally/models/thread_message_body_all_of_body'
+require 'lockally/models/thread_summary'
 require 'lockally/models/unit_bundle'
+require 'lockally/models/update_admin_request'
 require 'lockally/models/update_calendar_event_request'
 require 'lockally/models/update_calendar_integration_request'
 require 'lockally/models/update_calendar_member_request'
@@ -156,49 +211,18 @@ require 'lockally/models/update_contact_list_request'
 require 'lockally/models/update_contact_request'
 require 'lockally/models/update_directory_permissions_request'
 require 'lockally/models/update_gal_settings_request'
+require 'lockally/models/update_mailbox_request'
 require 'lockally/models/update_migration_mailbox_request'
 require 'lockally/models/update_migration_request'
 require 'lockally/models/update_resource_request'
 require 'lockally/models/update_user_request'
+require 'lockally/models/update_webhook_request'
 require 'lockally/models/user'
 require 'lockally/models/user_event'
-require 'lockally/models/v1_admin_login_post200_response'
-require 'lockally/models/v1_admin_login_post_request'
-require 'lockally/models/v1_admin_me_get200_response'
-require 'lockally/models/v1_admins_get200_response'
-require 'lockally/models/v1_admins_id_patch_request'
-require 'lockally/models/v1_admins_post_request'
-require 'lockally/models/v1_aliases_get200_response'
-require 'lockally/models/v1_aliases_post_request'
-require 'lockally/models/v1_api_keys_get200_response'
-require 'lockally/models/v1_api_keys_post201_response'
-require 'lockally/models/v1_api_keys_post_request'
-require 'lockally/models/v1_domains_get200_response'
-require 'lockally/models/v1_domains_post_request'
-require 'lockally/models/v1_inboxes_mailbox_messages_post_request'
-require 'lockally/models/v1_mailboxes_email_export_post201_response'
-require 'lockally/models/v1_mailboxes_email_patch_request'
-require 'lockally/models/v1_mailboxes_email_vacation_put_request'
-require 'lockally/models/v1_mailboxes_get200_response'
-require 'lockally/models/v1_mailboxes_post_request'
-require 'lockally/models/v1_messages_get200_response'
-require 'lockally/models/v1_send_batch_post200_response'
-require 'lockally/models/v1_send_batch_post_request'
-require 'lockally/models/v1_send_post200_response'
-require 'lockally/models/v1_send_post202_response'
-require 'lockally/models/v1_send_post_request'
-require 'lockally/models/v1_send_post_request_attachments_inner'
-require 'lockally/models/v1_suppressions_get200_response'
-require 'lockally/models/v1_suppressions_post_request'
-require 'lockally/models/v1_templates_get200_response'
-require 'lockally/models/v1_usage_get200_response'
-require 'lockally/models/v1_vacation_get200_response'
-require 'lockally/models/v1_webhooks_get200_response'
-require 'lockally/models/v1_webhooks_id_patch_request'
-require 'lockally/models/v1_webhooks_post_request'
 require 'lockally/models/vacation_params'
 require 'lockally/models/vacation_responder'
 require 'lockally/models/webhook'
+require 'lockally/models/whoami'
 
 # APIs
 require 'lockally/api/add_ons_api'

data/spec/api/admin_api_spec.rb

@@ -32,35 +32,35 @@ describe 'AdminApi' do
     end
   end
 
-  # unit tests for v1_admin_login_post
+  # unit tests for admin_login
   # Tenant-admin email+password login
   # Exchanges an admin's email + password for a session token. The web console at `app.lockally.com` posts this on form submission and stores the returned token in an httpOnly cookie.  **No enumeration leak.** Wrong-email and wrong-password both return the same 401 with title \"Invalid credentials\". The argon2id verify runs even on lookup miss (well, structurally — the lookup fails fast but the response shape is constant) so timing leaks are bounded.  Tokens are prefixed `adm_sess_` and valid for 7 days. Use as the `Authorization: Bearer` value on all subsequent calls. 
-  # @param v1_admin_login_post_request 
+  # @param admin_login_request 
   # @param [Hash] opts the optional parameters
-  # @return [V1AdminLoginPost200Response]
-  describe 'v1_admin_login_post test' do
+  # @return [AdminLogin200Response]
+  describe 'admin_login test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_admin_logout_post
+  # unit tests for admin_logout
   # Invalidate the current admin session
   # Deletes the session row from the database. Idempotent — calling logout on an already-invalid token returns 204 anyway. 
   # @param [Hash] opts the optional parameters
   # @return [nil]
-  describe 'v1_admin_logout_post test' do
+  describe 'admin_logout test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_admin_me_get
+  # unit tests for get_current_admin
   # Get the current admin + tenant
   # Returns the admin profile + tenant for the session token presented in `Authorization: Bearer`. Used by the web console's layout load function to populate the sidebar.  Returns 403 if called with an API key (lk_live_*) bearer — admin context only exists for session tokens. 
   # @param [Hash] opts the optional parameters
-  # @return [V1AdminMeGet200Response]
-  describe 'v1_admin_me_get test' do
+  # @return [GetCurrentAdmin200Response]
+  describe 'get_current_admin test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/admins_api_spec.rb

@@ -32,48 +32,48 @@ describe 'AdminsApi' do
     end
   end
 
-  # unit tests for v1_admins_get
-  # List tenant admins
+  # unit tests for delete_admin
+  # Delete an admin
+  # Hard-delete. Cascade-drops the admin's sessions (immediate revocation). Same safety rails as PATCH disabled=true. 
+  # @param id 
   # @param [Hash] opts the optional parameters
-  # @return [V1AdminsGet200Response]
-  describe 'v1_admins_get test' do
+  # @return [nil]
+  describe 'delete_admin test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_admins_id_delete
-  # Delete an admin
-  # Hard-delete. Cascade-drops the admin's sessions (immediate revocation). Same safety rails as PATCH disabled=true. 
-  # @param id 
+  # unit tests for invite_admin
+  # Invite a new admin
+  # Creates a new tenant admin. If `password` is omitted, lockally generates a 16-char password and returns it ONCE in the response. Email is case-insensitive and unique per tenant. 
+  # @param invite_admin_request 
   # @param [Hash] opts the optional parameters
-  # @return [nil]
-  describe 'v1_admins_id_delete test' do
+  # @return [AdminFull]
+  describe 'invite_admin test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_admins_id_patch
-  # Update an admin
-  # Supply at least one of `password`, `display_name`, `role`, `disabled`.  **Safety rails.** A session bearer (adm_sess_*) cannot disable itself — use another admin or an API key (which bypasses the self-rail). Disabling the last active admin returns 409 to prevent orphaning the tenant from its console. 
-  # @param id 
-  # @param v1_admins_id_patch_request 
+  # unit tests for list_admins
+  # List tenant admins
   # @param [Hash] opts the optional parameters
-  # @return [AdminFull]
-  describe 'v1_admins_id_patch test' do
+  # @return [ListAdmins200Response]
+  describe 'list_admins test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_admins_post
-  # Invite a new admin
-  # Creates a new tenant admin. If `password` is omitted, lockally generates a 16-char password and returns it ONCE in the response. Email is case-insensitive and unique per tenant. 
-  # @param v1_admins_post_request 
+  # unit tests for update_admin
+  # Update an admin
+  # Supply at least one of `password`, `display_name`, `role`, `disabled`.  **Safety rails.** A session bearer (adm_sess_*) cannot disable itself — use another admin or an API key (which bypasses the self-rail). Disabling the last active admin returns 409 to prevent orphaning the tenant from its console. 
+  # @param id 
+  # @param update_admin_request 
   # @param [Hash] opts the optional parameters
   # @return [AdminFull]
-  describe 'v1_admins_post test' do
+  describe 'update_admin test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/agents_api_spec.rb

@@ -32,90 +32,79 @@ describe 'AgentsApi' do
     end
   end
 
-  # unit tests for v1_api_keys_key_id_mailboxes_get
-  # List a key's mailbox grants
-  # @param key_id 
+  # unit tests for download_thread_attachment
+  # Download an attachment
+  # @param thread_id 
+  # @param message_id 
+  # @param idx 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_api_keys_key_id_mailboxes_get test' do
+  # @return [nil]
+  describe 'download_thread_attachment test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_api_keys_key_id_mailboxes_mailbox_id_delete
-  # Revoke a mailbox grant
-  # @param key_id 
-  # @param mailbox_id 
+  # unit tests for get_thread
+  # 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.
+  # @param thread_id 
   # @param [Hash] opts the optional parameters
-  # @return [nil]
-  describe 'v1_api_keys_key_id_mailboxes_mailbox_id_delete test' do
+  # @return [Thread]
+  describe 'get_thread test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_api_keys_key_id_mailboxes_post
-  # Grant a mailbox to a key
-  # 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.
-  # @param key_id 
+  # unit tests for get_thread_message
+  # Get one message with body
+  # Full text/html body fetched on demand from mail storage. Never marks the message read.
+  # @param thread_id 
+  # @param message_id 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_api_keys_key_id_mailboxes_post test' do
+  # @return [ThreadMessageBody]
+  describe 'get_thread_message test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_auth_whoami_get
-  # Introspect the calling credentials
-  # Returns the tenant, auth kind (api_key/session), key label, and granted scopes. The MCP server uses this to scope-filter tool discovery.
+  # unit tests for grant_api_key_mailbox
+  # Grant a mailbox to a key
+  # 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.
+  # @param key_id 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_auth_whoami_get test' do
+  # @return [MailboxGrant]
+  describe 'grant_api_key_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_contacts_lookup_get
-  # Who is this sender?
-  # 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).
-  # @param email 
+  # unit tests for list_api_key_mailboxes
+  # List a key's mailbox grants
+  # @param key_id 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_contacts_lookup_get test' do
+  # @return [MailboxGrantList]
+  describe 'list_api_key_mailboxes test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_inboxes_get
+  # unit tests for list_inboxes
   # List granted inboxes
   # The mailboxes this key is granted, with thread counts and last activity. Admin sessions see every agent-enabled, non-E2E mailbox.
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_inboxes_get test' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
-  # unit tests for v1_inboxes_mailbox_messages_post
-  # Start a new conversation (agent stream)
-  # 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.
-  # @param mailbox 
-  # @param idempotency_key 
-  # @param v1_inboxes_mailbox_messages_post_request 
-  # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_inboxes_mailbox_messages_post test' do
+  # @return [InboxList]
+  describe 'list_inboxes test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_inboxes_mailbox_threads_get
+  # unit tests for list_threads
   # List conversation threads
   # Newest-active first. Cursors: `?before=<RFC3339>` pages backwards; `?since=<RFC3339>` delta-syncs forward (oldest first) so an agent can catch up in order.
   # @param mailbox mailbox email or id
@@ -123,72 +112,83 @@ describe 'AgentsApi' do
   # @option opts [Time] :since 
   # @option opts [Time] :before 
   # @option opts [Integer] :limit 
-  # @return [Object]
-  describe 'v1_inboxes_mailbox_threads_get test' do
+  # @return [ThreadList]
+  describe 'list_threads test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_get
-  # 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.
-  # @param thread_id 
+  # unit tests for lookup_contact
+  # Who is this sender?
+  # 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).
+  # @param email 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_threads_thread_id_get test' do
+  # @return [ContactLookup]
+  describe 'lookup_contact test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_messages_message_id_attachments_idx_get
-  # Download an attachment
+  # unit tests for mark_thread_message_read
+  # Mark read/unread
+  # The ONLY way agent access changes unread state. Body: {\"read\": true|false} (default true).
   # @param thread_id 
   # @param message_id 
-  # @param idx 
   # @param [Hash] opts the optional parameters
-  # @return [nil]
-  describe 'v1_threads_thread_id_messages_message_id_attachments_idx_get test' do
+  # @return [MarkReadResult]
+  describe 'mark_thread_message_read test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_messages_message_id_get
-  # Get one message with body
-  # Full text/html body fetched on demand from mail storage. Never marks the message read.
+  # unit tests for reply_to_thread
+  # 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.
   # @param thread_id 
-  # @param message_id 
+  # @param idempotency_key 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_threads_thread_id_messages_message_id_get test' do
+  # @return [AgentSendResult]
+  describe 'reply_to_thread test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_messages_message_id_read_post
-  # Mark read/unread
-  # The ONLY way agent access changes unread state. Body: {\"read\": true|false} (default true).
-  # @param thread_id 
-  # @param message_id 
+  # unit tests for revoke_api_key_mailbox
+  # Revoke a mailbox grant
+  # @param key_id 
+  # @param mailbox_id 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_threads_thread_id_messages_message_id_read_post test' do
+  # @return [nil]
+  describe 'revoke_api_key_mailbox test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_reply_post
-  # 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.
-  # @param thread_id 
+  # unit tests for start_conversation
+  # Start a new conversation (agent stream)
+  # 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.
+  # @param mailbox 
   # @param idempotency_key 
+  # @param start_conversation_request 
+  # @param [Hash] opts the optional parameters
+  # @return [AgentSendResult]
+  describe 'start_conversation test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for whoami
+  # Introspect the calling credentials
+  # Returns the tenant, auth kind (api_key/session), key label, and granted scopes. The MCP server uses this to scope-filter tool discovery.
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_threads_thread_id_reply_post test' do
+  # @return [Whoami]
+  describe 'whoami test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end

data/spec/api/ai_api_spec.rb

@@ -32,47 +32,47 @@ describe 'AiApi' do
     end
   end
 
-  # unit tests for v1_ai_config_get
-  # Read the tenant's AI configuration
-  # Mode (off/byok/units), model, masked key hint, AI-unit balance, whether the units tier is available on this deployment.
+  # unit tests for classify_thread
+  # LLM-classify a thread
+  # Returns {intent, urgency, summary, suggested_action} via the tenant's AI tier (BYOK or prepaid units — see /v1/ai-config). Cached per thread state: unchanged threads return the cache free; ?refresh=true forces a re-run. A failed model call charges nothing. 402 when the AI tier is off.
+  # @param thread_id 
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_ai_config_get test' do
+  # @option opts [Boolean] :refresh 
+  # @return [ThreadClassification]
+  describe 'classify_thread test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_ai_config_put
-  # Configure the AI tier
-  # Body: {\"mode\": \"off|byok|units\", \"model\": \"...\", \"anthropic_key\": \"sk-ant-...\"}. BYOK keys are stored AES-256-GCM encrypted; the cleartext is never returned. Omit anthropic_key to keep the stored one.
+  # unit tests for create_ai_units_checkout
+  # Buy prepaid AI units
+  # Body: {\"bundle\": \"100|500|2000\"}. One classification = one unit; bundles expire after 6 months. Admin session required. 503 until Paystack billing is configured.
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_ai_config_put test' do
+  # @return [CreateAiUnitsCheckout200Response]
+  describe 'create_ai_units_checkout test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_billing_ai_units_checkout_post
-  # Buy prepaid AI units
-  # Body: {\"bundle\": \"100|500|2000\"}. One classification = one unit; bundles expire after 6 months. Admin session required. 503 until Paystack billing is configured.
+  # unit tests for get_ai_config
+  # Read the tenant's AI configuration
+  # Mode (off/byok/units), model, masked key hint, AI-unit balance, whether the units tier is available on this deployment.
   # @param [Hash] opts the optional parameters
-  # @return [Object]
-  describe 'v1_billing_ai_units_checkout_post test' do
+  # @return [AiConfig]
+  describe 'get_ai_config test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
-  # unit tests for v1_threads_thread_id_classify_post
-  # LLM-classify a thread
-  # Returns {intent, urgency, summary, suggested_action} via the tenant's AI tier (BYOK or prepaid units — see /v1/ai-config). Cached per thread state: unchanged threads return the cache free; ?refresh=true forces a re-run. A failed model call charges nothing. 402 when the AI tier is off.
-  # @param thread_id 
+  # unit tests for update_ai_config
+  # Configure the AI tier
+  # Body: {\"mode\": \"off|byok|units\", \"model\": \"...\", \"anthropic_key\": \"sk-ant-...\"}. BYOK keys are stored AES-256-GCM encrypted; the cleartext is never returned. Omit anthropic_key to keep the stored one.
   # @param [Hash] opts the optional parameters
-  # @option opts [Boolean] :refresh 
-  # @return [Object]
-  describe 'v1_threads_thread_id_classify_post test' do
+  # @return [AiConfigUpdate]
+  describe 'update_ai_config test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end