cerca 0.1.0

data/lib/cerca/models/http_tool_source.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class HTTPToolSource < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute auth
+      #   Tool source authentication configuration. The `kind` field selects one of
+      #   `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+      #
+      #   @return [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth]
+      required :auth, union: -> { Cerca::ToolSourceAuth }
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean]
+      required :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute namespace
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!attribute tools
+      #
+      #   @return [Array<Cerca::Models::HTTPToolDefinition>]
+      required :tools, -> { Cerca::Internal::Type::ArrayOf[Cerca::HTTPToolDefinition] }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :http]
+      required :type, const: :http
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute version
+      #
+      #   @return [Float]
+      required :version, Float
+
+      # @!attribute approval
+      #
+      #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+      optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+      # @!attribute execution
+      #   HTTP tool execution retry and timeout policy.
+      #
+      #   @return [Cerca::Models::HTTPToolExecutionPolicy, nil]
+      optional :execution, -> { Cerca::HTTPToolExecutionPolicy }
+
+      # @!method initialize(id:, auth:, created_at:, enabled:, fleet_id:, namespace:, tools:, updated_at:, version:, approval: nil, execution: nil, type: :http)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::HTTPToolSource} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param auth [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth] Tool source authentication configuration. The `kind` field selects one of `none`
+      #
+      #   @param created_at [String]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param namespace [String]
+      #
+      #   @param tools [Array<Cerca::Models::HTTPToolDefinition>]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param version [Float]
+      #
+      #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+      #
+      #   @param execution [Cerca::Models::HTTPToolExecutionPolicy] HTTP tool execution retry and timeout policy.
+      #
+      #   @param type [Symbol, :http]
+    end
+  end
+end

data/lib/cerca/models/json_object.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @type [Cerca::Internal::Type::Converter]
+    JsonObject = Cerca::Internal::Type::HashOf[Cerca::Internal::Type::Unknown]
+  end
+end

data/lib/cerca/models/mcp_tool_execution_policy.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class McpToolExecutionPolicy < Cerca::Internal::Type::BaseModel
+      # @!attribute discovery_timeout_ms
+      #
+      #   @return [Float, nil]
+      optional :discovery_timeout_ms, Float, api_name: :discoveryTimeoutMs
+
+      # @!attribute execution_timeout_ms
+      #
+      #   @return [Float, nil]
+      optional :execution_timeout_ms, Float, api_name: :executionTimeoutMs
+
+      # @!attribute max_attempts
+      #
+      #   @return [Float, nil]
+      optional :max_attempts, Float, api_name: :maxAttempts
+
+      # @!attribute retry_mode
+      #
+      #   @return [Symbol, Cerca::Models::McpToolExecutionPolicy::RetryMode, nil]
+      optional :retry_mode, enum: -> { Cerca::McpToolExecutionPolicy::RetryMode }, api_name: :retryMode
+
+      # @!method initialize(discovery_timeout_ms: nil, execution_timeout_ms: nil, max_attempts: nil, retry_mode: nil)
+      #   MCP discovery and execution retry/timeout policy.
+      #
+      #   @param discovery_timeout_ms [Float]
+      #   @param execution_timeout_ms [Float]
+      #   @param max_attempts [Float]
+      #   @param retry_mode [Symbol, Cerca::Models::McpToolExecutionPolicy::RetryMode]
+
+      # @see Cerca::Models::McpToolExecutionPolicy#retry_mode
+      module RetryMode
+        extend Cerca::Internal::Type::Enum
+
+        DISABLED = :disabled
+        CONNECT_ONLY = :connect_only
+        ENABLED = :enabled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/mcp_tool_source.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class McpToolSource < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute auth
+      #   Tool source authentication configuration. The `kind` field selects one of
+      #   `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+      #
+      #   @return [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth]
+      required :auth, union: -> { Cerca::ToolSourceAuth }
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean]
+      required :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute namespace
+      #
+      #   @return [String]
+      required :namespace, String
+
+      # @!attribute type
+      #
+      #   @return [Symbol, :mcp]
+      required :type, const: :mcp
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute version
+      #
+      #   @return [Float]
+      required :version, Float
+
+      # @!attribute approval
+      #
+      #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+      optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+      # @!attribute execution
+      #   MCP discovery and execution retry/timeout policy.
+      #
+      #   @return [Cerca::Models::McpToolExecutionPolicy, nil]
+      optional :execution, -> { Cerca::McpToolExecutionPolicy }
+
+      # @!method initialize(id:, auth:, created_at:, enabled:, fleet_id:, namespace:, updated_at:, url:, version:, approval: nil, execution: nil, type: :mcp)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::McpToolSource} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param auth [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth] Tool source authentication configuration. The `kind` field selects one of `none`
+      #
+      #   @param created_at [String]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param namespace [String]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param url [String]
+      #
+      #   @param version [Float]
+      #
+      #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+      #
+      #   @param execution [Cerca::Models::McpToolExecutionPolicy] MCP discovery and execution retry/timeout policy.
+      #
+      #   @param type [Symbol, :mcp]
+    end
+  end
+end

data/lib/cerca/models/message.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class Message < Cerca::Internal::Type::BaseModel
+      # @!attribute content
+      #
+      #   @return [Array<Cerca::Models::ContentBlock::TextContentBlock, Cerca::Models::ContentBlock::ToolUseContentBlock, Cerca::Models::ContentBlock::ToolResultContentBlock, Cerca::Models::ContentBlock::ServerToolUseContentBlock, Cerca::Models::ContentBlock::WebSearchToolResultContentBlock>]
+      required :content, -> { Cerca::Internal::Type::ArrayOf[union: Cerca::ContentBlock] }
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute role
+      #
+      #   @return [Symbol, Cerca::Models::Message::Role]
+      required :role, enum: -> { Cerca::Message::Role }
+
+      # @!attribute seq
+      #
+      #   @return [Float]
+      required :seq, Float
+
+      # @!method initialize(content:, created_at:, role:, seq:)
+      #   @param content [Array<Cerca::Models::ContentBlock::TextContentBlock, Cerca::Models::ContentBlock::ToolUseContentBlock, Cerca::Models::ContentBlock::ToolResultContentBlock, Cerca::Models::ContentBlock::ServerToolUseContentBlock, Cerca::Models::ContentBlock::WebSearchToolResultContentBlock>]
+      #   @param created_at [String]
+      #   @param role [Symbol, Cerca::Models::Message::Role]
+      #   @param seq [Float]
+
+      # @see Cerca::Models::Message#role
+      module Role
+        extend Cerca::Internal::Type::Enum
+
+        USER = :user
+        ASSISTANT = :assistant
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/metadata.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @type [Cerca::Internal::Type::Converter]
+    Metadata = Cerca::Internal::Type::HashOf[String]
+  end
+end

data/lib/cerca/models/model_descriptor.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class ModelDescriptor < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute capabilities
+      #
+      #   @return [Array<String>]
+      required :capabilities, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!attribute context_window_tokens
+      #
+      #   @return [Float]
+      required :context_window_tokens, Float, api_name: :contextWindowTokens
+
+      # @!attribute default_max_output_tokens
+      #
+      #   @return [Float]
+      required :default_max_output_tokens, Float, api_name: :defaultMaxOutputTokens
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute provider
+      #
+      #   @return [Symbol, Cerca::Models::ModelDescriptor::Provider]
+      required :provider, enum: -> { Cerca::ModelDescriptor::Provider }
+
+      # @!attribute request_headroom_tokens
+      #
+      #   @return [Float]
+      required :request_headroom_tokens, Float, api_name: :requestHeadroomTokens
+
+      # @!method initialize(id:, capabilities:, context_window_tokens:, default_max_output_tokens:, name:, provider:, request_headroom_tokens:)
+      #   @param id [String]
+      #   @param capabilities [Array<String>]
+      #   @param context_window_tokens [Float]
+      #   @param default_max_output_tokens [Float]
+      #   @param name [String]
+      #   @param provider [Symbol, Cerca::Models::ModelDescriptor::Provider]
+      #   @param request_headroom_tokens [Float]
+
+      # @see Cerca::Models::ModelDescriptor#provider
+      module Provider
+        extend Cerca::Internal::Type::Enum
+
+        ANTHROPIC = :anthropic
+        OPENAI = :openai
+        GOOGLE = :google
+        FIREWORKS = :fireworks
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/model_list_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Models#list
+    class ModelListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/model_list_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Models#list
+    class ModelListResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute models
+      #
+      #   @return [Array<Cerca::Models::ModelDescriptor>]
+      required :models, -> { Cerca::Internal::Type::ArrayOf[Cerca::ModelDescriptor] }
+
+      # @!method initialize(models:)
+      #   @param models [Array<Cerca::Models::ModelDescriptor>]
+    end
+  end
+end

data/lib/cerca/models/no_tool_source_auth.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class NoToolSourceAuth < Cerca::Internal::Type::BaseModel
+      # @!attribute kind
+      #
+      #   @return [Symbol, :none]
+      required :kind, const: :none
+
+      # @!method initialize(kind: :none)
+      #   @param kind [Symbol, :none]
+    end
+  end
+end

data/lib/cerca/models/oauth_connect_params.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::OAuth#connect
+    class OAuthConnectParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute provider
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute owner
+      #   Public owner for a reusable connection. Organization owners use the
+      #   authenticated organization; fleet owners add a fleetId.
+      #
+      #   @return [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner]
+      required :owner, union: -> { Cerca::ConnectionOwner }
+
+      # @!attribute return_origin
+      #   HTTP(S) origin that receives the OAuth completion message.
+      #
+      #   @return [String]
+      required :return_origin, String, api_name: :returnOrigin
+
+      # @!attribute scopes
+      #   Provider-specific OAuth scopes. Empty entries are ignored after trimming.
+      #
+      #   @return [Array<String>, nil]
+      optional :scopes, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(provider:, owner:, return_origin:, scopes: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::OAuthConnectParams} for more details.
+      #
+      #   @param provider [String]
+      #
+      #   @param owner [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner] Public owner for a reusable connection. Organization owners use the authenticate
+      #
+      #   @param return_origin [String] HTTP(S) origin that receives the OAuth completion message.
+      #
+      #   @param scopes [Array<String>] Provider-specific OAuth scopes. Empty entries are ignored after trimming.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/oauth_connect_response.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::OAuth#connect
+    class OAuthConnectResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute authorization_url
+      #   Provider authorization URL that the client should open.
+      #
+      #   @return [String]
+      required :authorization_url, String, api_name: :authorizationUrl
+
+      # @!attribute callback_origin
+      #   Origin hosting the OAuth callback endpoint.
+      #
+      #   @return [String]
+      required :callback_origin, String, api_name: :callbackOrigin
+
+      # @!attribute expires_at
+      #   OAuth state expiration timestamp, when returned.
+      #
+      #   @return [String, nil]
+      optional :expires_at, String, api_name: :expiresAt
+
+      # @!attribute state_nonce
+      #   OAuth state nonce, when returned.
+      #
+      #   @return [String, nil]
+      optional :state_nonce, String, api_name: :stateNonce
+
+      # @!method initialize(authorization_url:, callback_origin:, expires_at: nil, state_nonce: nil)
+      #   @param authorization_url [String] Provider authorization URL that the client should open.
+      #
+      #   @param callback_origin [String] Origin hosting the OAuth callback endpoint.
+      #
+      #   @param expires_at [String] OAuth state expiration timestamp, when returned.
+      #
+      #   @param state_nonce [String] OAuth state nonce, when returned.
+    end
+  end
+end

data/lib/cerca/models/oauth_connection_tool_source_auth.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class OAuthConnectionToolSourceAuth < Cerca::Internal::Type::BaseModel
+      # @!attribute kind
+      #
+      #   @return [Symbol, :oauth_connection]
+      required :kind, const: :oauth_connection
+
+      # @!attribute provider
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute inject
+      #   Where an API key or OAuth access token should be injected into outgoing
+      #   tool-source requests.
+      #
+      #   @return [Cerca::Models::AuthInjection::HeaderAuthInjection, Cerca::Models::AuthInjection::QueryAuthInjection, nil]
+      optional :inject, union: -> { Cerca::AuthInjection }
+
+      # @!attribute required_scopes
+      #
+      #   @return [Array<String>, nil]
+      optional :required_scopes, Cerca::Internal::Type::ArrayOf[String], api_name: :requiredScopes
+
+      # @!method initialize(provider:, inject: nil, required_scopes: nil, kind: :oauth_connection)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::OAuthConnectionToolSourceAuth} for more details.
+      #
+      #   @param provider [String]
+      #
+      #   @param inject [Cerca::Models::AuthInjection::HeaderAuthInjection, Cerca::Models::AuthInjection::QueryAuthInjection] Where an API key or OAuth access token should be injected into outgoing tool-sou
+      #
+      #   @param required_scopes [Array<String>]
+      #
+      #   @param kind [Symbol, :oauth_connection]
+    end
+  end
+end

data/lib/cerca/models/oauth_exchange_config.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # Source-owned OAuth exchange configuration. Public schemas use connection IDs for
+    # stored client secrets and assertions.
+    module OAuthExchangeConfig
+      extend Cerca::Internal::Type::Union
+
+      discriminator :grantType
+
+      variant :client_credentials, -> { Cerca::OAuthExchangeConfig::ClientCredentialsOAuthExchange }
+
+      variant :jwt_bearer, -> { Cerca::OAuthExchangeConfig::JwtBearerOAuthExchange }
+
+      class ClientCredentialsOAuthExchange < Cerca::Internal::Type::BaseModel
+        # @!attribute client_id
+        #
+        #   @return [String]
+        required :client_id, String, api_name: :clientId
+
+        # @!attribute client_secret_connection_id
+        #
+        #   @return [String]
+        required :client_secret_connection_id, String, api_name: :clientSecretConnectionId
+
+        # @!attribute grant_type
+        #
+        #   @return [Symbol, :client_credentials]
+        required :grant_type, const: :client_credentials, api_name: :grantType
+
+        # @!attribute token_url
+        #
+        #   @return [String]
+        required :token_url, String, api_name: :tokenUrl
+
+        # @!attribute audience
+        #
+        #   @return [String, nil]
+        optional :audience, String
+
+        # @!attribute extra_params
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :extra_params, Cerca::Internal::Type::HashOf[String], api_name: :extraParams
+
+        # @!attribute scopes
+        #
+        #   @return [Array<String>, nil]
+        optional :scopes, Cerca::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(client_id:, client_secret_connection_id:, token_url:, audience: nil, extra_params: nil, scopes: nil, grant_type: :client_credentials)
+        #   @param client_id [String]
+        #   @param client_secret_connection_id [String]
+        #   @param token_url [String]
+        #   @param audience [String]
+        #   @param extra_params [Hash{Symbol=>String}]
+        #   @param scopes [Array<String>]
+        #   @param grant_type [Symbol, :client_credentials]
+      end
+
+      class JwtBearerOAuthExchange < Cerca::Internal::Type::BaseModel
+        # @!attribute assertion_connection_id
+        #
+        #   @return [String]
+        required :assertion_connection_id, String, api_name: :assertionConnectionId
+
+        # @!attribute audience
+        #
+        #   @return [String]
+        required :audience, String
+
+        # @!attribute grant_type
+        #
+        #   @return [Symbol, :jwt_bearer]
+        required :grant_type, const: :jwt_bearer, api_name: :grantType
+
+        # @!attribute issuer
+        #
+        #   @return [String]
+        required :issuer, String
+
+        # @!attribute token_url
+        #
+        #   @return [String]
+        required :token_url, String, api_name: :tokenUrl
+
+        # @!attribute extra_params
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :extra_params, Cerca::Internal::Type::HashOf[String], api_name: :extraParams
+
+        # @!attribute scopes
+        #
+        #   @return [Array<String>, nil]
+        optional :scopes, Cerca::Internal::Type::ArrayOf[String]
+
+        # @!attribute subject
+        #
+        #   @return [String, nil]
+        optional :subject, String
+
+        # @!method initialize(assertion_connection_id:, audience:, issuer:, token_url:, extra_params: nil, scopes: nil, subject: nil, grant_type: :jwt_bearer)
+        #   @param assertion_connection_id [String]
+        #   @param audience [String]
+        #   @param issuer [String]
+        #   @param token_url [String]
+        #   @param extra_params [Hash{Symbol=>String}]
+        #   @param scopes [Array<String>]
+        #   @param subject [String]
+        #   @param grant_type [Symbol, :jwt_bearer]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::OAuthExchangeConfig::ClientCredentialsOAuthExchange, Cerca::Models::OAuthExchangeConfig::JwtBearerOAuthExchange)]
+    end
+  end
+end