cerca 0.1.0

data/lib/cerca/models/thread_summary.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#list
+    class ThreadSummary < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute completed_at
+      #
+      #   @return [String, nil]
+      required :completed_at, String, api_name: :completedAt, nil?: true
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute message_count
+      #
+      #   @return [Float]
+      required :message_count, Float, api_name: :messageCount
+
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!attribute parent_thread_id
+      #
+      #   @return [String, nil]
+      required :parent_thread_id, String, api_name: :parentThreadId, nil?: true
+
+      # @!attribute result
+      #
+      #   @return [String, nil]
+      required :result, String, nil?: true
+
+      # @!attribute schedule_id
+      #
+      #   @return [String, nil]
+      required :schedule_id, String, api_name: :scheduleId, nil?: true
+
+      # @!attribute schedule_seq
+      #
+      #   @return [Float, nil]
+      required :schedule_seq, Float, api_name: :scheduleSeq, nil?: true
+
+      # @!attribute status
+      #   `idle` threads can accept a new turn or be closed. `running` threads have an
+      #   active turn. `awaiting` threads are paused on external input such as approvals.
+      #   `closed` threads are terminal.
+      #
+      #   @return [Symbol, Cerca::Models::Status]
+      required :status, enum: -> { Cerca::Status }
+
+      # @!attribute step_count
+      #
+      #   @return [Float]
+      required :step_count, Float, api_name: :stepCount
+
+      # @!method initialize(id:, completed_at:, created_at:, message_count:, model:, parent_thread_id:, result:, schedule_id:, schedule_seq:, status:, step_count:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ThreadSummary} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param completed_at [String, nil]
+      #
+      #   @param created_at [String]
+      #
+      #   @param message_count [Float]
+      #
+      #   @param model [String]
+      #
+      #   @param parent_thread_id [String, nil]
+      #
+      #   @param result [String, nil]
+      #
+      #   @param schedule_id [String, nil]
+      #
+      #   @param schedule_seq [Float, nil]
+      #
+      #   @param status [Symbol, Cerca::Models::Status] `idle` threads can accept a new turn or be closed. `running` threads have an act
+      #
+      #   @param step_count [Float]
+    end
+  end
+end

data/lib/cerca/models/token_usage.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class TokenUsage < Cerca::Internal::Type::BaseModel
+      # @!attribute input_tokens
+      #
+      #   @return [Float]
+      required :input_tokens, Float, api_name: :inputTokens
+
+      # @!attribute output_tokens
+      #
+      #   @return [Float]
+      required :output_tokens, Float, api_name: :outputTokens
+
+      # @!method initialize(input_tokens:, output_tokens:)
+      #   @param input_tokens [Float]
+      #   @param output_tokens [Float]
+    end
+  end
+end

data/lib/cerca/models/tool.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # A unified available tool entry. Runtime tools include requiresApproval; external
+    # tools include approval.
+    module Tool
+      extend Cerca::Internal::Type::Union
+
+      discriminator :category
+
+      # An external provider or tool-source tool currently available to the agent.
+      variant :external, -> { Cerca::DiscoveredTool }
+
+      # A built-in or configurable runtime tool currently available to the agent.
+      variant -> { Cerca::ToolDescriptor }
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::DiscoveredTool, Cerca::Models::ToolDescriptor)]
+    end
+  end
+end

data/lib/cerca/models/tool_approval_mode.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module ToolApprovalMode
+      extend Cerca::Internal::Type::Enum
+
+      ALWAYS = :always
+      NEVER = :never
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/tool_connection_metadata.rb

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

data/lib/cerca/models/tool_create_params.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#create
+    class ToolCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute body
+      #
+      #   @return [Cerca::Models::ToolCreateParams::Body::CreateHTTPToolSourceRequest, Cerca::Models::ToolCreateParams::Body::CreateMcpToolSourceRequest]
+      required :body, union: -> { Cerca::ToolCreateParams::Body }
+
+      # @!method initialize(fleet_id:, body:, request_options: {})
+      #   @param fleet_id [String]
+      #   @param body [Cerca::Models::ToolCreateParams::Body::CreateHTTPToolSourceRequest, Cerca::Models::ToolCreateParams::Body::CreateMcpToolSourceRequest]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      module Body
+        extend Cerca::Internal::Type::Union
+
+        discriminator :type
+
+        variant :http, -> { Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest }
+
+        variant :mcp, -> { Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest }
+
+        class CreateHTTPToolSourceRequest < Cerca::Internal::Type::BaseModel
+          # @!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 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 approval
+          #
+          #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+          optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+          # @!attribute enabled
+          #
+          #   @return [Boolean, nil]
+          optional :enabled, Cerca::Internal::Type::Boolean
+
+          # @!attribute execution
+          #   HTTP tool execution retry and timeout policy.
+          #
+          #   @return [Cerca::Models::HTTPToolExecutionPolicy, nil]
+          optional :execution, -> { Cerca::HTTPToolExecutionPolicy }
+
+          # @!method initialize(auth:, namespace:, tools:, approval: nil, enabled: nil, execution: nil, type: :http)
+          #   Some parameter documentations has been truncated, see
+          #   {Cerca::Models::ToolCreateParams::Body::CreateHTTPToolSourceRequest} for more
+          #   details.
+          #
+          #   @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 namespace [String]
+          #
+          #   @param tools [Array<Cerca::Models::HTTPToolDefinition>]
+          #
+          #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+          #
+          #   @param enabled [Boolean]
+          #
+          #   @param execution [Cerca::Models::HTTPToolExecutionPolicy] HTTP tool execution retry and timeout policy.
+          #
+          #   @param type [Symbol, :http]
+        end
+
+        class CreateMcpToolSourceRequest < Cerca::Internal::Type::BaseModel
+          # @!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 namespace
+          #
+          #   @return [String]
+          required :namespace, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :mcp]
+          required :type, const: :mcp
+
+          # @!attribute url
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!attribute approval
+          #
+          #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+          optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+          # @!attribute enabled
+          #
+          #   @return [Boolean, nil]
+          optional :enabled, Cerca::Internal::Type::Boolean
+
+          # @!attribute execution
+          #   MCP discovery and execution retry/timeout policy.
+          #
+          #   @return [Cerca::Models::McpToolExecutionPolicy, nil]
+          optional :execution, -> { Cerca::McpToolExecutionPolicy }
+
+          # @!method initialize(auth:, namespace:, url:, approval: nil, enabled: nil, execution: nil, type: :mcp)
+          #   Some parameter documentations has been truncated, see
+          #   {Cerca::Models::ToolCreateParams::Body::CreateMcpToolSourceRequest} for more
+          #   details.
+          #
+          #   @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 namespace [String]
+          #
+          #   @param url [String]
+          #
+          #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+          #
+          #   @param enabled [Boolean]
+          #
+          #   @param execution [Cerca::Models::McpToolExecutionPolicy] MCP discovery and execution retry/timeout policy.
+          #
+          #   @param type [Symbol, :mcp]
+        end
+
+        # @!method self.variants
+        #   @return [Array(Cerca::Models::ToolCreateParams::Body::CreateHTTPToolSourceRequest, Cerca::Models::ToolCreateParams::Body::CreateMcpToolSourceRequest)]
+      end
+    end
+  end
+end

data/lib/cerca/models/tool_delete_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#delete
+    class ToolDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute source_id
+      #
+      #   @return [String]
+      required :source_id, String
+
+      # @!method initialize(fleet_id:, source_id:, request_options: {})
+      #   @param fleet_id [String]
+      #   @param source_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/tool_descriptor.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class ToolDescriptor < Cerca::Internal::Type::BaseModel
+      # @!attribute approval_source
+      #
+      #   @return [Symbol, Cerca::Models::ToolDescriptor::ApprovalSource]
+      required :approval_source, enum: -> { Cerca::ToolDescriptor::ApprovalSource }, api_name: :approvalSource
+
+      # @!attribute category
+      #
+      #   @return [Symbol, Cerca::Models::ToolDescriptor::Category]
+      required :category, enum: -> { Cerca::ToolDescriptor::Category }
+
+      # @!attribute description
+      #
+      #   @return [String]
+      required :description, String
+
+      # @!attribute input_schema
+      #   JSON Schema object describing tool input parameters.
+      #
+      #   @return [Hash{Symbol=>Object}]
+      required :input_schema,
+               Cerca::Internal::Type::HashOf[Cerca::Internal::Type::Unknown],
+               api_name: :inputSchema
+
+      # @!attribute name
+      #
+      #   @return [Symbol, Cerca::Models::ToolName]
+      required :name, enum: -> { Cerca::ToolName }
+
+      # @!attribute requires_approval
+      #
+      #   @return [Boolean]
+      required :requires_approval, Cerca::Internal::Type::Boolean, api_name: :requiresApproval
+
+      # @!method initialize(approval_source:, category:, description:, input_schema:, name:, requires_approval:)
+      #   A built-in or configurable runtime tool currently available to the agent.
+      #
+      #   @param approval_source [Symbol, Cerca::Models::ToolDescriptor::ApprovalSource]
+      #
+      #   @param category [Symbol, Cerca::Models::ToolDescriptor::Category]
+      #
+      #   @param description [String]
+      #
+      #   @param input_schema [Hash{Symbol=>Object}] JSON Schema object describing tool input parameters.
+      #
+      #   @param name [Symbol, Cerca::Models::ToolName]
+      #
+      #   @param requires_approval [Boolean]
+
+      # @see Cerca::Models::ToolDescriptor#approval_source
+      module ApprovalSource
+        extend Cerca::Internal::Type::Enum
+
+        AGENT = :agent
+        ENV = :env
+        CATALOG = :catalog
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Cerca::Models::ToolDescriptor#category
+      module Category
+        extend Cerca::Internal::Type::Enum
+
+        BUILT_IN = :builtIn
+        CONFIGURABLE = :configurable
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/tool_list_params.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#list
+    class ToolListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!method initialize(fleet_id:, cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ToolListParams} for more details.
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/tool_name.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module ToolName
+      extend Cerca::Internal::Type::Enum
+
+      GET_TIME = :get_time
+      SUB_THREAD = :sub_thread
+      WAIT = :wait
+      TOOL_CALL = :"tool.call"
+      TOOL_DISCOVER = :"tool.discover"
+      ARTIFACT_READ = :"artifact.read"
+      AGENT_THREADS_LIST = :"agent.threads.list"
+      AGENT_THREADS_GET = :"agent.threads.get"
+      AGENT_APPROVALS_CANCEL = :"agent.approvals.cancel"
+      AGENT_APPROVALS_GRANT_THREAD = :"agent.approvals.grant_thread"
+      AGENT_APPROVALS_GRANT_AGENT = :"agent.approvals.grant_agent"
+      AGENT_CREATE = :"agent.create"
+      AGENT_APPROVALS_UPDATE = :"agent.approvals.update"
+      TOOL_CONNECT = :"tool.connect"
+      SANDBOX_EXEC = :"sandbox.exec"
+      SANDBOX_READ = :"sandbox.read"
+      SANDBOX_WRITE_FILE = :"sandbox.write_file"
+      SANDBOX_READ_FILE = :"sandbox.read_file"
+      SANDBOX_SPAWN = :"sandbox.spawn"
+      SANDBOX_STDIN = :"sandbox.stdin"
+      SANDBOX_SESSION_READ = :"sandbox.session_read"
+      SANDBOX_KILL = :"sandbox.kill"
+      SANDBOX_LIST_SESSIONS = :"sandbox.list_sessions"
+      SANDBOX_SYNC_ARTIFACT = :"sandbox.sync_artifact"
+      MEMORY_READ = :"memory.read"
+      MEMORY_LIST = :"memory.list"
+      MEMORY_SEARCH = :"memory.search"
+      MEMORY_WRITE = :"memory.write"
+      MEMORY_DELETE = :"memory.delete"
+      DB_QUERY = :"db.query"
+      WEB_SEARCH = :"web.search"
+      WEB_FETCH = :"web.fetch"
+      AGENT_SCHEDULE_LIST = :"agent.schedule.list"
+      AGENT_SCHEDULE_CREATE = :"agent.schedule.create"
+      AGENT_SCHEDULE_UPDATE = :"agent.schedule.update"
+      AGENT_SCHEDULE_DELETE = :"agent.schedule.delete"
+      AGENT_SCHEDULE_TRIGGER = :"agent.schedule.trigger"
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/tool_retrieve_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#retrieve
+    class ToolRetrieveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute source_id
+      #
+      #   @return [String]
+      required :source_id, String
+
+      # @!method initialize(fleet_id:, source_id:, request_options: {})
+      #   @param fleet_id [String]
+      #   @param source_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/tool_source.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#create
+    module ToolSource
+      extend Cerca::Internal::Type::Union
+
+      discriminator :type
+
+      variant :http, -> { Cerca::HTTPToolSource }
+
+      variant :mcp, -> { Cerca::McpToolSource }
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::HTTPToolSource, Cerca::Models::McpToolSource)]
+    end
+  end
+end

data/lib/cerca/models/tool_source_auth.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # Tool source authentication configuration. The `kind` field selects one of
+    # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+    module ToolSourceAuth
+      extend Cerca::Internal::Type::Union
+
+      discriminator :kind
+
+      variant :none, -> { Cerca::NoToolSourceAuth }
+
+      variant :api_key, -> { Cerca::APIKeyToolSourceAuth }
+
+      variant :oauth_exchange, -> { Cerca::OAuthExchangeToolSourceAuth }
+
+      variant :oauth_connection, -> { Cerca::OAuthConnectionToolSourceAuth }
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth)]
+    end
+  end
+end

data/lib/cerca/models/tool_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    ToolSpec = String
+  end
+end