spatio-sdk 0.0.2

data/spec/api/conversations_api_spec.rb

@@ -0,0 +1,140 @@
+=begin
+#SpatioAPI
+
+#The REST API that owns every resource in your Spatio workspace: notes, sheets, slides, tasks, calendar events, mail, chat, files, and contacts. SpatioMCP wraps this API; Spatio Desktop reads from it. You can call it directly from your own code.  All requests must be authenticated with a Personal Access Token (`Authorization: Bearer pat_...`) or an OAuth 2.1 access token, and use HTTPS.  Official SDKs (MIT, generated from this spec on every release):  - TypeScript: https://github.com/spatio-labs/spatio-ts (`npm install @spatio-labs/spatio-ts`) - Python: https://github.com/spatio-labs/spatio-py (`pip install spatio-sdk`) - Go: https://github.com/spatio-labs/spatio-go (`go get github.com/spatio-labs/spatio-go`)  This specification is generated from the platform-service Go source on every push to `main`. The spec, not hand-written documentation, is the source of truth: server stubs and SDKs are generated from it, and any drift between the spec and the running service fails CI. 
+
+The version of the OpenAPI document: v1
+Contact: hello@spatio.app
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Spatio::ConversationsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ConversationsApi' do
+  before do
+    # run before each test
+    @api_instance = Spatio::ConversationsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ConversationsApi' do
+    it 'should create an instance of ConversationsApi' do
+      expect(@api_instance).to be_instance_of(Spatio::ConversationsApi)
+    end
+  end
+
+  # unit tests for create_conversation
+  # Persist a new LLM conversation.
+  # @param [Hash] opts the optional parameters
+  # @option opts [CreateConversationRequest] :create_conversation_request 
+  # @return [Conversation]
+  describe 'create_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 delete_conversation
+  # Soft-delete a conversation.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_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 get_conversation
+  # Fetch one conversation.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Conversation]
+  describe 'get_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 get_latest_conversation_for_context
+  # Fetch the most recently active conversation for a given context tag.
+  # @param context 
+  # @param [Hash] opts the optional parameters
+  # @return [Conversation]
+  describe 'get_latest_conversation_for_context 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 list_conversation_messages
+  # List messages in a conversation.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :limit 
+  # @option opts [String] :before 
+  # @return [Array<ConversationMessage>]
+  describe 'list_conversation_messages 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 list_conversations
+  # List the caller&#39;s persisted LLM conversations.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :context 
+  # @option opts [Integer] :limit 
+  # @return [Array<Conversation>]
+  describe 'list_conversations 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 save_conversation_message
+  # Append a message to a conversation.
+  # @param id 
+  # @param save_message_request 
+  # @param [Hash] opts the optional parameters
+  # @return [ConversationMessage]
+  describe 'save_conversation_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 update_conversation
+  # Update conversation metadata (title, context, cwd, session_id, pinned).
+  # @param id 
+  # @param update_conversation_request 
+  # @param [Hash] opts the optional parameters
+  # @return [Conversation]
+  describe 'update_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 update_conversation_message_metadata
+  # Patch metadata on an existing message. Body must include the message id (path is the conversation id, not the message). 
+  # @param id 
+  # @param update_message_metadata_request 
+  # @param [Hash] opts the optional parameters
+  # @return [ConversationMessage]
+  describe 'update_conversation_message_metadata test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/direct_messages_api_spec.rb

@@ -0,0 +1,420 @@
+=begin
+#SpatioAPI
+
+#The REST API that owns every resource in your Spatio workspace: notes, sheets, slides, tasks, calendar events, mail, chat, files, and contacts. SpatioMCP wraps this API; Spatio Desktop reads from it. You can call it directly from your own code.  All requests must be authenticated with a Personal Access Token (`Authorization: Bearer pat_...`) or an OAuth 2.1 access token, and use HTTPS.  Official SDKs (MIT, generated from this spec on every release):  - TypeScript: https://github.com/spatio-labs/spatio-ts (`npm install @spatio-labs/spatio-ts`) - Python: https://github.com/spatio-labs/spatio-py (`pip install spatio-sdk`) - Go: https://github.com/spatio-labs/spatio-go (`go get github.com/spatio-labs/spatio-go`)  This specification is generated from the platform-service Go source on every push to `main`. The spec, not hand-written documentation, is the source of truth: server stubs and SDKs are generated from it, and any drift between the spec and the running service fails CI. 
+
+The version of the OpenAPI document: v1
+Contact: hello@spatio.app
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Spatio::DirectMessagesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'DirectMessagesApi' do
+  before do
+    # run before each test
+    @api_instance = Spatio::DirectMessagesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of DirectMessagesApi' do
+    it 'should create an instance of DirectMessagesApi' do
+      expect(@api_instance).to be_instance_of(Spatio::DirectMessagesApi)
+    end
+  end
+
+  # unit tests for add_dm_reaction
+  # React to a DM message.
+  # @param message_id Chat-message id.
+  # @param dm_reaction_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DMReactionResponse]
+  describe 'add_dm_reaction 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 attach_to_dm_message
+  # Attach a file/image/etc. to an existing DM message.
+  # @param message_id Chat-message id.
+  # @param dm_attach_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DMMessageEnvelope]
+  describe 'attach_to_dm_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 execute_dm_action
+  # Dispatch a DM action by id.
+  # @param execute_chat_action_request 
+  # @param [Hash] opts the optional parameters
+  # @return [ExecuteChatActionResponse]
+  describe 'execute_dm_action 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 forward_dm_message
+  # Forward a DM message to another DM or channel.
+  # @param message_id Chat-message id.
+  # @param dm_forward_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DMMessageEnvelope]
+  describe 'forward_dm_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 get_dm_user
+  # Fetch one chat user.
+  # @param id Chat-user id (provider-scoped).
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [GetChatUserResponse]
+  describe 'get_dm_user 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 list_direct_conversations_enriched
+  # Enriched DM conversation list with unread + pin + draft state.
+  # Native fast-path. Returns conversations augmented with the DM-feature state (unread counts, pinned/muted flags, saved drafts) the renderer's DM UI consumes. The shape is provider-specific and treated as opaque. 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @option opts [String] :x_workspace_id Workspace scope for unscoped tokens. Workspace-scoped PATs and OAuth tokens carry this implicitly; for session/JWT auth without a scoped PAT, pass it explicitly. 
+  # @return [Hash<String, Object>]
+  describe 'list_direct_conversations_enriched 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 list_direct_message_conversations
+  # List 1:1 and group DM conversations.
+  # Returns DM-type conversations only (&#x60;type: im | mpim&#x60;). Channel-type conversations are surfaced via &#x60;/v1/channels&#x60;. 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Array<String>] :account_ids Repeatable. Restrict to these connected-account row ids. Mutually orthogonal to &#x60;providers&#x60; — when both are set the intersection is used. 
+  # @option opts [Array<String>] :providers Repeatable. Restrict to these provider ids (&#x60;gmail&#x60;, &#x60;outlook&#x60;).
+  # @option opts [String] :x_workspace_id Workspace scope for unscoped tokens. Workspace-scoped PATs and OAuth tokens carry this implicitly; for session/JWT auth without a scoped PAT, pass it explicitly. 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :include_archived 
+  # @return [ListChannelsResponse]
+  describe 'list_direct_message_conversations 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 list_direct_messages
+  # List messages in a DM conversation.
+  # @param channel DM conversation id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @option opts [Array<String>] :account_ids Repeatable. Restrict to these connected-account row ids. Mutually orthogonal to &#x60;providers&#x60; — when both are set the intersection is used. 
+  # @option opts [Array<String>] :providers Repeatable. Restrict to these provider ids (&#x60;gmail&#x60;, &#x60;outlook&#x60;).
+  # @option opts [String] :x_workspace_id Workspace scope for unscoped tokens. Workspace-scoped PATs and OAuth tokens carry this implicitly; for session/JWT auth without a scoped PAT, pass it explicitly. 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :oldest_first 
+  # @return [ListMessagesResponse]
+  describe 'list_direct_messages 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 list_dm_actions
+  # Discover the action catalog for DirectMessages.
+  # @param [Hash] opts the optional parameters
+  # @return [ChatActionsList]
+  describe 'list_dm_actions 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 list_dm_pinned_messages
+  # List pinned messages in a DM conversation.
+  # @param dm_id Direct-message conversation id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [DMPinnedList]
+  describe 'list_dm_pinned_messages 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 list_dm_thread_replies
+  # List replies in a DM message thread.
+  # @param dm_id Direct-message conversation id.
+  # @param message_id Chat-message id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [Hash<String, Object>]
+  describe 'list_dm_thread_replies 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 list_dm_users
+  # List chat users (DM contacts) across connected accounts.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Array<String>] :account_ids Repeatable. Restrict to these connected-account row ids. Mutually orthogonal to &#x60;providers&#x60; — when both are set the intersection is used. 
+  # @option opts [Array<String>] :providers Repeatable. Restrict to these provider ids (&#x60;gmail&#x60;, &#x60;outlook&#x60;).
+  # @option opts [String] :x_workspace_id Workspace scope for unscoped tokens. Workspace-scoped PATs and OAuth tokens carry this implicitly; for session/JWT auth without a scoped PAT, pass it explicitly. 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :cursor 
+  # @return [ListChatUsersResponse]
+  describe 'list_dm_users 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 mark_dm_read
+  # Mark a DM message read.
+  # @param dm_id Direct-message conversation id.
+  # @param dm_mark_read_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SuccessFlag]
+  describe 'mark_dm_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 mute_dm
+  # Mute a DM conversation (until a time, or forever).
+  # @param dm_id Direct-message conversation id.
+  # @param dm_mute_request 
+  # @param [Hash] opts the optional parameters
+  # @return [DMMuteResponse]
+  describe 'mute_dm 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 pin_dm_conversation
+  # Pin a DM conversation to the top of the sidebar.
+  # @param dm_id Direct-message conversation id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [SuccessFlag]
+  describe 'pin_dm_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 pin_dm_message
+  # Pin a DM message.
+  # @param message_id Chat-message id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [ChannelMembershipRequest] :channel_membership_request 
+  # @return [SuccessFlag]
+  describe 'pin_dm_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 post_dm_thread_reply
+  # Reply in a DM message thread.
+  # @param dm_id Direct-message conversation id.
+  # @param message_id Chat-message id.
+  # @param dm_thread_reply_request 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [DMMessageEnvelope]
+  describe 'post_dm_thread_reply 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 remove_dm_reaction
+  # Remove a DM message reaction.
+  # @param message_id Chat-message id.
+  # @param emoji Reaction emoji (e.g. &#x60;+1&#x60;, &#x60;eyes&#x60;, &#x60;pepper&#x60;).
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [DMReactionResponse]
+  describe 'remove_dm_reaction 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 search_direct_messages
+  # Search across DM messages.
+  # @param q Free-form query string.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :limit 
+  # @option opts [String] :dm_id Restrict to one conversation.
+  # @option opts [String] :user Restrict to messages from this user id.
+  # @option opts [String] :account_id 
+  # @return [DMSearchResults]
+  describe 'search_direct_messages 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 send_direct_message
+  # Send a DM.
+  # @param send_chat_message_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SendChatMessageResponse]
+  describe 'send_direct_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 set_dm_draft
+  # Save the unsent draft text for a DM.
+  # @param dm_id Direct-message conversation id.
+  # @param dm_set_draft_request 
+  # @param [Hash] opts the optional parameters
+  # @return [SuccessFlag]
+  describe 'set_dm_draft 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 unpin_dm_conversation
+  # Unpin a DM conversation.
+  # @param dm_id Direct-message conversation id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [SuccessFlag]
+  describe 'unpin_dm_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 unpin_dm_message
+  # Unpin a DM message.
+  # @param message_id Chat-message id.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :account_id 
+  # @return [SuccessFlag]
+  describe 'unpin_dm_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 workspace_execute_dm_action
+  # @param org 
+  # @param workspace 
+  # @param request_body 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_execute_dm_action 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 workspace_get_dm_user
+  # @param org 
+  # @param workspace 
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_get_dm_user 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 workspace_list_direct_messages
+  # @param org 
+  # @param workspace 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_list_direct_messages 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 workspace_list_dm_actions
+  # @param org 
+  # @param workspace 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_list_dm_actions 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 workspace_list_dm_conversations
+  # @param org 
+  # @param workspace 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_list_dm_conversations 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 workspace_list_dm_messages
+  # @param org 
+  # @param workspace 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_list_dm_messages 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 workspace_list_dm_users
+  # @param org 
+  # @param workspace 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_list_dm_users 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 workspace_send_direct_message
+  # @param org 
+  # @param workspace 
+  # @param request_body 
+  # @param [Hash] opts the optional parameters
+  # @return [Hash<String, Object>]
+  describe 'workspace_send_direct_message test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end