agent_push_kit 0.1.0

data/docs/AgentTokensApi.md

@@ -0,0 +1,279 @@
+# AgentPushKit::AgentTokensApi
+
+All URIs are relative to *https://api.chatdna.co/agent-push-kit/v1*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**call_mcp**](AgentTokensApi.md#call_mcp) | **POST** /mcp | Connect through stateless MCP Streamable HTTP |
+| [**create_agent_token**](AgentTokensApi.md#create_agent_token) | **POST** /agent-tokens | Create a named non-expiring agent token |
+| [**list_agent_tokens**](AgentTokensApi.md#list_agent_tokens) | **GET** /agent-tokens | List agent access tokens without their secrets |
+| [**revoke_agent_token**](AgentTokensApi.md#revoke_agent_token) | **DELETE** /agent-tokens/{tokenId} | Revoke one of the current user's agent tokens |
+
+
+## call_mcp
+
+> call_mcp(request_body)
+
+Connect through stateless MCP Streamable HTTP
+
+This endpoint accepts only an `apt_` agent access token.
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+# setup authorization
+AgentPushKit.configure do |config|
+  # Configure Bearer authorization (apt_): AgentToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = AgentPushKit::AgentTokensApi.new
+request_body = { key: 3.56} # Hash<String, Object> | 
+
+begin
+  # Connect through stateless MCP Streamable HTTP
+  api_instance.call_mcp(request_body)
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->call_mcp: #{e}"
+end
+```
+
+#### Using the call_mcp_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> call_mcp_with_http_info(request_body)
+
+```ruby
+begin
+  # Connect through stateless MCP Streamable HTTP
+  data, status_code, headers = api_instance.call_mcp_with_http_info(request_body)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->call_mcp_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[AgentToken](../README.md#AgentToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_agent_token
+
+> <AgentTokenCreated> create_agent_token(create_agent_token_input)
+
+Create a named non-expiring agent token
+
+The raw `apt_` token is shown once. Store it before dismissing the response.
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+# setup authorization
+AgentPushKit.configure do |config|
+  # Configure Bearer authorization (Agent Push Kit JWT or apt_ token): UserOrAgent
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = AgentPushKit::AgentTokensApi.new
+create_agent_token_input = AgentPushKit::CreateAgentTokenInput.new({name: 'name_example'}) # CreateAgentTokenInput | 
+
+begin
+  # Create a named non-expiring agent token
+  result = api_instance.create_agent_token(create_agent_token_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->create_agent_token: #{e}"
+end
+```
+
+#### Using the create_agent_token_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AgentTokenCreated>, Integer, Hash)> create_agent_token_with_http_info(create_agent_token_input)
+
+```ruby
+begin
+  # Create a named non-expiring agent token
+  data, status_code, headers = api_instance.create_agent_token_with_http_info(create_agent_token_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AgentTokenCreated>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->create_agent_token_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **create_agent_token_input** | [**CreateAgentTokenInput**](CreateAgentTokenInput.md) |  |  |
+
+### Return type
+
+[**AgentTokenCreated**](AgentTokenCreated.md)
+
+### Authorization
+
+[UserOrAgent](../README.md#UserOrAgent)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## list_agent_tokens
+
+> <Array<AgentToken>> list_agent_tokens
+
+List agent access tokens without their secrets
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+# setup authorization
+AgentPushKit.configure do |config|
+  # Configure Bearer authorization (Agent Push Kit JWT or apt_ token): UserOrAgent
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = AgentPushKit::AgentTokensApi.new
+
+begin
+  # List agent access tokens without their secrets
+  result = api_instance.list_agent_tokens
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->list_agent_tokens: #{e}"
+end
+```
+
+#### Using the list_agent_tokens_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<Array<AgentToken>>, Integer, Hash)> list_agent_tokens_with_http_info
+
+```ruby
+begin
+  # List agent access tokens without their secrets
+  data, status_code, headers = api_instance.list_agent_tokens_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <Array<AgentToken>>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->list_agent_tokens_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**Array&lt;AgentToken&gt;**](AgentToken.md)
+
+### Authorization
+
+[UserOrAgent](../README.md#UserOrAgent)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## revoke_agent_token
+
+> <RevokedResponse> revoke_agent_token(token_id)
+
+Revoke one of the current user's agent tokens
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+# setup authorization
+AgentPushKit.configure do |config|
+  # Configure Bearer authorization (Agent Push Kit JWT or apt_ token): UserOrAgent
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = AgentPushKit::AgentTokensApi.new
+token_id = 'token_id_example' # String | 
+
+begin
+  # Revoke one of the current user's agent tokens
+  result = api_instance.revoke_agent_token(token_id)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->revoke_agent_token: #{e}"
+end
+```
+
+#### Using the revoke_agent_token_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<RevokedResponse>, Integer, Hash)> revoke_agent_token_with_http_info(token_id)
+
+```ruby
+begin
+  # Revoke one of the current user's agent tokens
+  data, status_code, headers = api_instance.revoke_agent_token_with_http_info(token_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <RevokedResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AgentTokensApi->revoke_agent_token_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **token_id** | **String** |  |  |
+
+### Return type
+
+[**RevokedResponse**](RevokedResponse.md)
+
+### Authorization
+
+[UserOrAgent](../README.md#UserOrAgent)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/ApiKeySummary.md

@@ -0,0 +1,22 @@
+# AgentPushKit::ApiKeySummary
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **key_prefix** | **String** |  | [optional] |
+| **last_four** | **String** |  | [optional] |
+| **updated_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'agent_push_kit'
+
+instance = AgentPushKit::ApiKeySummary.new(
+  key_prefix: null,
+  last_four: null,
+  updated_at: null
+)
+```
+

data/docs/AuthResponse.md

@@ -0,0 +1,24 @@
+# AgentPushKit::AuthResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **access_token** | **String** |  |  |
+| **user** | [**User**](User.md) |  |  |
+| **organizations** | [**Array<Organization>**](Organization.md) |  |  |
+| **bootstrap_api_key** | **String** | Present only when a new customer account was created. | [optional] |
+
+## Example
+
+```ruby
+require 'agent_push_kit'
+
+instance = AgentPushKit::AuthResponse.new(
+  access_token: null,
+  user: null,
+  organizations: null,
+  bootstrap_api_key: null
+)
+```
+

data/docs/AuthenticationApi.md

@@ -0,0 +1,385 @@
+# AgentPushKit::AuthenticationApi
+
+All URIs are relative to *https://api.chatdna.co/agent-push-kit/v1*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**complete_password_reset**](AuthenticationApi.md#complete_password_reset) | **POST** /auth/password-reset/complete | Choose a new password and log in |
+| [**login_with_apple**](AuthenticationApi.md#login_with_apple) | **POST** /auth/apple | Log in or attach an account using a Sign in with Apple identity token |
+| [**login_with_google**](AuthenticationApi.md#login_with_google) | **POST** /auth/google | Log in or attach an account using a verified Google ID token |
+| [**login_with_password**](AuthenticationApi.md#login_with_password) | **POST** /auth/login | Log in with email and password |
+| [**register**](AuthenticationApi.md#register) | **POST** /auth/register | Create a user and first customer account |
+| [**request_password_reset**](AuthenticationApi.md#request_password_reset) | **POST** /auth/password-reset/request | Email a single-use password reset token |
+
+
+## complete_password_reset
+
+> <AuthResponse> complete_password_reset(password_reset_complete_input)
+
+Choose a new password and log in
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+password_reset_complete_input = AgentPushKit::PasswordResetCompleteInput.new({token: 'token_example', password: 'password_example'}) # PasswordResetCompleteInput | 
+
+begin
+  # Choose a new password and log in
+  result = api_instance.complete_password_reset(password_reset_complete_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->complete_password_reset: #{e}"
+end
+```
+
+#### Using the complete_password_reset_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AuthResponse>, Integer, Hash)> complete_password_reset_with_http_info(password_reset_complete_input)
+
+```ruby
+begin
+  # Choose a new password and log in
+  data, status_code, headers = api_instance.complete_password_reset_with_http_info(password_reset_complete_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AuthResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->complete_password_reset_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **password_reset_complete_input** | [**PasswordResetCompleteInput**](PasswordResetCompleteInput.md) |  |  |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## login_with_apple
+
+> <AuthResponse> login_with_apple(provider_login_input)
+
+Log in or attach an account using a Sign in with Apple identity token
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+provider_login_input = AgentPushKit::ProviderLoginInput.new({id_token: 'id_token_example'}) # ProviderLoginInput | 
+
+begin
+  # Log in or attach an account using a Sign in with Apple identity token
+  result = api_instance.login_with_apple(provider_login_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_apple: #{e}"
+end
+```
+
+#### Using the login_with_apple_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AuthResponse>, Integer, Hash)> login_with_apple_with_http_info(provider_login_input)
+
+```ruby
+begin
+  # Log in or attach an account using a Sign in with Apple identity token
+  data, status_code, headers = api_instance.login_with_apple_with_http_info(provider_login_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AuthResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_apple_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **provider_login_input** | [**ProviderLoginInput**](ProviderLoginInput.md) |  |  |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## login_with_google
+
+> <AuthResponse> login_with_google(provider_login_input)
+
+Log in or attach an account using a verified Google ID token
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+provider_login_input = AgentPushKit::ProviderLoginInput.new({id_token: 'id_token_example'}) # ProviderLoginInput | 
+
+begin
+  # Log in or attach an account using a verified Google ID token
+  result = api_instance.login_with_google(provider_login_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_google: #{e}"
+end
+```
+
+#### Using the login_with_google_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AuthResponse>, Integer, Hash)> login_with_google_with_http_info(provider_login_input)
+
+```ruby
+begin
+  # Log in or attach an account using a verified Google ID token
+  data, status_code, headers = api_instance.login_with_google_with_http_info(provider_login_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AuthResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_google_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **provider_login_input** | [**ProviderLoginInput**](ProviderLoginInput.md) |  |  |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## login_with_password
+
+> <AuthResponse> login_with_password(password_login_input)
+
+Log in with email and password
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+password_login_input = AgentPushKit::PasswordLoginInput.new({email: 'email_example', password: 'password_example'}) # PasswordLoginInput | 
+
+begin
+  # Log in with email and password
+  result = api_instance.login_with_password(password_login_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_password: #{e}"
+end
+```
+
+#### Using the login_with_password_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AuthResponse>, Integer, Hash)> login_with_password_with_http_info(password_login_input)
+
+```ruby
+begin
+  # Log in with email and password
+  data, status_code, headers = api_instance.login_with_password_with_http_info(password_login_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AuthResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->login_with_password_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **password_login_input** | [**PasswordLoginInput**](PasswordLoginInput.md) |  |  |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## register
+
+> <AuthResponse> register(register_input)
+
+Create a user and first customer account
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+register_input = AgentPushKit::RegisterInput.new({email: 'email_example', password: 'password_example'}) # RegisterInput | 
+
+begin
+  # Create a user and first customer account
+  result = api_instance.register(register_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->register: #{e}"
+end
+```
+
+#### Using the register_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AuthResponse>, Integer, Hash)> register_with_http_info(register_input)
+
+```ruby
+begin
+  # Create a user and first customer account
+  data, status_code, headers = api_instance.register_with_http_info(register_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AuthResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->register_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **register_input** | [**RegisterInput**](RegisterInput.md) |  |  |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## request_password_reset
+
+> <AcceptedResponse> request_password_reset(password_reset_request_input)
+
+Email a single-use password reset token
+
+### Examples
+
+```ruby
+require 'time'
+require 'agent_push_kit'
+
+api_instance = AgentPushKit::AuthenticationApi.new
+password_reset_request_input = AgentPushKit::PasswordResetRequestInput.new({email: 'email_example'}) # PasswordResetRequestInput | 
+
+begin
+  # Email a single-use password reset token
+  result = api_instance.request_password_reset(password_reset_request_input)
+  p result
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->request_password_reset: #{e}"
+end
+```
+
+#### Using the request_password_reset_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AcceptedResponse>, Integer, Hash)> request_password_reset_with_http_info(password_reset_request_input)
+
+```ruby
+begin
+  # Email a single-use password reset token
+  data, status_code, headers = api_instance.request_password_reset_with_http_info(password_reset_request_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AcceptedResponse>
+rescue AgentPushKit::ApiError => e
+  puts "Error when calling AuthenticationApi->request_password_reset_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **password_reset_request_input** | [**PasswordResetRequestInput**](PasswordResetRequestInput.md) |  |  |
+
+### Return type
+
+[**AcceptedResponse**](AcceptedResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+