agentcat-api 0.0.1 → 0.0.3

data/docs/PublishEventRequest.md

@@ -0,0 +1,72 @@
+# AgentCatApi::PublishEventRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | ID of the event, typically auto-generated by the AgentCat Agent | [optional] |
+| **project_id** | **String** | ID of the project this event belongs to |  |
+| **session_id** | **String** | ID of the session this event belongs to. Null for stateless mode (server assigns session). | [optional] |
+| **actor_id** | **String** | Optional actor ID | [optional] |
+| **event_id** | **String** | Optional custom event ID (must be unique) | [optional] |
+| **event_type** | **String** | Type of event (e.g., mcp:tools/call, agentcat:identify) | [optional] |
+| **is_error** | **Boolean** | Whether this event represents an error | [optional] |
+| **error** | **Object** | Error details if is_error is true | [optional] |
+| **resource_name** | **String** | Name of the resource accessed (for resource events) | [optional] |
+| **duration** | **Integer** | Duration of the operation in milliseconds | [optional] |
+| **input_tokens** | **Integer** | Token count of the request side as measured by the SDK. When absent, the server estimates it from the stored parameters. | [optional] |
+| **output_tokens** | **Integer** | Token count of the response side as measured by the SDK. When absent, the server estimates it from the stored response. Drives the oversized-tool-response rule. | [optional] |
+| **timestamp** | **Time** | Agent-provided timestamp of when the event occurred | [optional] |
+| **user_intent** | **String** | Captured explanation of why the actor made this request | [optional] |
+| **parameters** | **Object** | Parameters sent with the request | [optional] |
+| **response** | **Object** | Response data from the operation | [optional] |
+| **identify_actor_given_id** | **String** | Actor ID for agentcat:identify events | [optional] |
+| **identify_actor_name** | **String** | Actor name for agentcat:identify events | [optional] |
+| **identify_data** | **Object** | Additional data for agentcat:identify events | [optional] |
+| **tags** | **Hash<String, String>** | Custom string key-value pairs. Keys: max 32 chars, alphanumeric/underscore/period/colon/dash/dollar-sign only. Values: max 200 chars, no newlines. Max 50 entries. | [optional] |
+| **properties** | **Object** | Custom structured data. Keys are strings, values can be string, number, boolean, array, object, or null (null values are filtered out). | [optional] |
+| **ip_address** | **String** | IP address of the client | [optional] |
+| **sdk_language** | **String** | Programming language of the SDK used | [optional] |
+| **agentcat_version** | **String** | Version of AgentCat being used | [optional] |
+| **server_name** | **String** | Name of the MCP server | [optional] |
+| **server_version** | **String** | Version of the MCP server | [optional] |
+| **client_name** | **String** | Name of the MCP client | [optional] |
+| **client_version** | **String** | Version of the MCP client | [optional] |
+
+## Example
+
+```ruby
+require 'agentcat-api'
+
+instance = AgentCatApi::PublishEventRequest.new(
+  id: null,
+  project_id: null,
+  session_id: null,
+  actor_id: null,
+  event_id: null,
+  event_type: null,
+  is_error: null,
+  error: null,
+  resource_name: null,
+  duration: null,
+  input_tokens: null,
+  output_tokens: null,
+  timestamp: null,
+  user_intent: null,
+  parameters: null,
+  response: null,
+  identify_actor_given_id: null,
+  identify_actor_name: null,
+  identify_data: null,
+  tags: null,
+  properties: null,
+  ip_address: null,
+  sdk_language: null,
+  agentcat_version: null,
+  server_name: null,
+  server_version: null,
+  client_name: null,
+  client_version: null
+)
+```
+

data/docs/QueryTimeout.md

@@ -0,0 +1,20 @@
+# AgentCatApi::QueryTimeout
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **detail** | **String** |  |  |
+| **code** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'agentcat-api'
+
+instance = AgentCatApi::QueryTimeout.new(
+  detail: null,
+  code: null
+)
+```
+

data/docs/UnsubscribeRequestRequest.md

@@ -0,0 +1,18 @@
+# AgentCatApi::UnsubscribeRequestRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **token** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'agentcat-api'
+
+instance = AgentCatApi::UnsubscribeRequestRequest.new(
+  token: null
+)
+```
+

data/docs/ValidationErrorValue.md

@@ -0,0 +1,49 @@
+# AgentCatApi::ValidationErrorValue
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'agentcat-api'
+
+AgentCatApi::ValidationErrorValue.openapi_one_of
+# =>
+# [
+#   :'Array<String>',
+#   :'String'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'agentcat-api'
+
+AgentCatApi::ValidationErrorValue.build(data)
+# => #<Array<String>:0x00007fdd4aab02a0>
+
+AgentCatApi::ValidationErrorValue.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `Array<String>`
+- `String`
+- `nil` (if no type matches)
+

data/lib/agentcat-api/api/alerts_api.rb

@@ -0,0 +1,142 @@
+=begin
+#AgentCat API
+
+#API for AgentCat application
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module AgentCatApi
+  class AlertsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Show the confirmation page for removing an email address from one alert rule
+    # GET, the link in the email, shows a confirmation page and changes nothing, because mail scanners fetch links. POST removes the address from the rule; the page's form and the List-Unsubscribe-Post header both send it. POST is idempotent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @return [String]
+    def unsubscribe_alert_get(opts = {})
+      data, _status_code, _headers = unsubscribe_alert_get_with_http_info(opts)
+      data
+    end
+
+    # Show the confirmation page for removing an email address from one alert rule
+    # GET, the link in the email, shows a confirmation page and changes nothing, because mail scanners fetch links. POST removes the address from the rule; the page's form and the List-Unsubscribe-Post header both send it. POST is idempotent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
+    def unsubscribe_alert_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AlertsApi.unsubscribe_alert_get ...'
+      end
+      # resource path
+      local_var_path = '/v1/public/alerts/unsubscribe'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['text/html', 'text/plain', 'application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'String'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"AlertsApi.unsubscribe_alert_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AlertsApi#unsubscribe_alert_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Remove an email address from one alert rule (List-Unsubscribe-Post and the confirmation form)
+    # GET, the link in the email, shows a confirmation page and changes nothing, because mail scanners fetch links. POST removes the address from the rule; the page's form and the List-Unsubscribe-Post header both send it. POST is idempotent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @return [String]
+    def unsubscribe_alert_post(opts = {})
+      data, _status_code, _headers = unsubscribe_alert_post_with_http_info(opts)
+      data
+    end
+
+    # Remove an email address from one alert rule (List-Unsubscribe-Post and the confirmation form)
+    # GET, the link in the email, shows a confirmation page and changes nothing, because mail scanners fetch links. POST removes the address from the rule; the page&#39;s form and the List-Unsubscribe-Post header both send it. POST is idempotent.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
+    def unsubscribe_alert_post_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AlertsApi.unsubscribe_alert_post ...'
+      end
+      # resource path
+      local_var_path = '/v1/public/alerts/unsubscribe'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'String'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"AlertsApi.unsubscribe_alert_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AlertsApi#unsubscribe_alert_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/agentcat-api/api/events_api.rb

@@ -0,0 +1,86 @@
+=begin
+#AgentCat API
+
+#API for AgentCat application
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module AgentCatApi
+  class EventsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Publish analytics event
+    # Submit analytics events for a project. Returns immediately with 202 Accepted.
+    # @param [Hash] opts the optional parameters
+    # @option opts [PublishEventRequest] :publish_event_request 
+    # @return [EventAcceptedResponse]
+    def publish_event(opts = {})
+      data, _status_code, _headers = publish_event_with_http_info(opts)
+      data
+    end
+
+    # Publish analytics event
+    # Submit analytics events for a project. Returns immediately with 202 Accepted.
+    # @param [Hash] opts the optional parameters
+    # @option opts [PublishEventRequest] :publish_event_request 
+    # @return [Array<(EventAcceptedResponse, Integer, Hash)>] EventAcceptedResponse data, response status code and response headers
+    def publish_event_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EventsApi.publish_event ...'
+      end
+      # resource path
+      local_var_path = '/v1/public/events/'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'publish_event_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EventAcceptedResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['tokenAuth']
+
+      new_options = opts.merge(
+        :operation => :"EventsApi.publish_event",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: EventsApi#publish_event\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/agentcat-api/api/notifications_api.rb

@@ -0,0 +1,154 @@
+=begin
+#AgentCat API
+
+#API for AgentCat application
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module AgentCatApi
+  class NotificationsApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Disable an email notification type for the token's user
+    # Anonymous endpoint reached from email unsubscribe links and the List-Unsubscribe header POST. The token encodes the user and the notification type to disable. Response bodies are plain text.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Signed unsubscribe token. May also be passed in the request body.
+    # @option opts [UnsubscribeRequestRequest] :unsubscribe_request_request 
+    # @return [String]
+    def unsubscribe_notification(opts = {})
+      data, _status_code, _headers = unsubscribe_notification_with_http_info(opts)
+      data
+    end
+
+    # Disable an email notification type for the token's user
+    # Anonymous endpoint reached from email unsubscribe links and the List-Unsubscribe header POST. The token encodes the user and the notification type to disable. Response bodies are plain text.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Signed unsubscribe token. May also be passed in the request body.
+    # @option opts [UnsubscribeRequestRequest] :unsubscribe_request_request 
+    # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
+    def unsubscribe_notification_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotificationsApi.unsubscribe_notification ...'
+      end
+      # resource path
+      local_var_path = '/v1/public/notifications/unsubscribe'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['text/plain', 'application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'unsubscribe_request_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'String'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"NotificationsApi.unsubscribe_notification",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotificationsApi#unsubscribe_notification\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Activate an email channel from its verification link
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @option opts [EmailChannelVerifyRequest] :email_channel_verify_request 
+    # @return [EmailChannelVerifyResponse]
+    def verify_email_channel(opts = {})
+      data, _status_code, _headers = verify_email_channel_with_http_info(opts)
+      data
+    end
+
+    # Activate an email channel from its verification link
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token 
+    # @option opts [EmailChannelVerifyRequest] :email_channel_verify_request 
+    # @return [Array<(EmailChannelVerifyResponse, Integer, Hash)>] EmailChannelVerifyResponse data, response status code and response headers
+    def verify_email_channel_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: NotificationsApi.verify_email_channel ...'
+      end
+      # resource path
+      local_var_path = '/v1/public/notifications/channels/verify'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'application/x-www-form-urlencoded', 'multipart/form-data'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'email_channel_verify_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EmailChannelVerifyResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"NotificationsApi.verify_email_channel",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: NotificationsApi#verify_email_channel\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end