cerca 0.1.0

data/rbi/cerca/models/thread_summary.rbi

@@ -0,0 +1,99 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ThreadSummary < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::ThreadSummary, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :completed_at
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(Float) }
+      attr_accessor :message_count
+
+      sig { returns(String) }
+      attr_accessor :model
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :parent_thread_id
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :result
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :schedule_id
+
+      sig { returns(T.nilable(Float)) }
+      attr_accessor :schedule_seq
+
+      # `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.
+      sig { returns(Cerca::Status::TaggedSymbol) }
+      attr_accessor :status
+
+      sig { returns(Float) }
+      attr_accessor :step_count
+
+      sig do
+        params(
+          id: String,
+          completed_at: T.nilable(String),
+          created_at: String,
+          message_count: Float,
+          model: String,
+          parent_thread_id: T.nilable(String),
+          result: T.nilable(String),
+          schedule_id: T.nilable(String),
+          schedule_seq: T.nilable(Float),
+          status: Cerca::Status::OrSymbol,
+          step_count: Float
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        completed_at:,
+        created_at:,
+        message_count:,
+        model:,
+        parent_thread_id:,
+        result:,
+        schedule_id:,
+        schedule_seq:,
+        # `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.
+        status:,
+        step_count:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            completed_at: T.nilable(String),
+            created_at: String,
+            message_count: Float,
+            model: String,
+            parent_thread_id: T.nilable(String),
+            result: T.nilable(String),
+            schedule_id: T.nilable(String),
+            schedule_seq: T.nilable(Float),
+            status: Cerca::Status::TaggedSymbol,
+            step_count: Float
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/token_usage.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class TokenUsage < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::TokenUsage, Cerca::Internal::AnyHash) }
+
+      sig { returns(Float) }
+      attr_accessor :input_tokens
+
+      sig { returns(Float) }
+      attr_accessor :output_tokens
+
+      sig do
+        params(input_tokens: Float, output_tokens: Float).returns(
+          T.attached_class
+        )
+      end
+      def self.new(input_tokens:, output_tokens:)
+      end
+
+      sig { override.returns({ input_tokens: Float, output_tokens: Float }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool.rbi

@@ -0,0 +1,18 @@
+# typed: strong
+
+module Cerca
+  module Models
+    # A unified available tool entry. Runtime tools include requiresApproval; external
+    # tools include approval.
+    module Tool
+      extend Cerca::Internal::Type::Union
+
+      Variants =
+        T.type_alias { T.any(Cerca::DiscoveredTool, Cerca::ToolDescriptor) }
+
+      sig { override.returns(T::Array[Cerca::Tool::Variants]) }
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool_approval_mode.rbi

@@ -0,0 +1,19 @@
+# typed: strong
+
+module Cerca
+  module Models
+    module ToolApprovalMode
+      extend Cerca::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Cerca::ToolApprovalMode) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      ALWAYS = T.let(:always, Cerca::ToolApprovalMode::TaggedSymbol)
+      NEVER = T.let(:never, Cerca::ToolApprovalMode::TaggedSymbol)
+
+      sig { override.returns(T::Array[Cerca::ToolApprovalMode::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool_connection_metadata.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Cerca
+  module Models
+    ToolConnectionMetadata =
+      T.let(
+        Cerca::Internal::Type::HashOf[String],
+        Cerca::Internal::Type::Converter
+      )
+  end
+end

data/rbi/cerca/models/tool_create_params.rbi

@@ -0,0 +1,286 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ToolCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ToolCreateParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig do
+        returns(
+          T.any(
+            Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest,
+            Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest
+          )
+        )
+      end
+      attr_accessor :body
+
+      sig do
+        params(
+          fleet_id: String,
+          body:
+            T.any(
+              Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest::OrHash,
+              Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest::OrHash
+            ),
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(fleet_id:, body:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            body:
+              T.any(
+                Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest,
+                Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest
+              ),
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Body
+        extend Cerca::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest,
+              Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest
+            )
+          end
+
+        class CreateHTTPToolSourceRequest < Cerca::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cerca::ToolCreateParams::Body::CreateHTTPToolSourceRequest,
+                Cerca::Internal::AnyHash
+              )
+            end
+
+          # Tool source authentication configuration. The `kind` field selects one of
+          # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+          sig do
+            returns(
+              T.any(
+                Cerca::NoToolSourceAuth,
+                Cerca::APIKeyToolSourceAuth,
+                Cerca::OAuthExchangeToolSourceAuth,
+                Cerca::OAuthConnectionToolSourceAuth
+              )
+            )
+          end
+          attr_accessor :auth
+
+          sig { returns(String) }
+          attr_accessor :namespace
+
+          sig { returns(T::Array[Cerca::HTTPToolDefinition]) }
+          attr_accessor :tools
+
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig { returns(T.nilable(Cerca::ToolApprovalMode::OrSymbol)) }
+          attr_reader :approval
+
+          sig { params(approval: Cerca::ToolApprovalMode::OrSymbol).void }
+          attr_writer :approval
+
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :enabled
+
+          sig { params(enabled: T::Boolean).void }
+          attr_writer :enabled
+
+          # HTTP tool execution retry and timeout policy.
+          sig { returns(T.nilable(Cerca::HTTPToolExecutionPolicy)) }
+          attr_reader :execution
+
+          sig { params(execution: Cerca::HTTPToolExecutionPolicy::OrHash).void }
+          attr_writer :execution
+
+          sig do
+            params(
+              auth:
+                T.any(
+                  Cerca::NoToolSourceAuth::OrHash,
+                  Cerca::APIKeyToolSourceAuth::OrHash,
+                  Cerca::OAuthExchangeToolSourceAuth::OrHash,
+                  Cerca::OAuthConnectionToolSourceAuth::OrHash
+                ),
+              namespace: String,
+              tools: T::Array[Cerca::HTTPToolDefinition::OrHash],
+              approval: Cerca::ToolApprovalMode::OrSymbol,
+              enabled: T::Boolean,
+              execution: Cerca::HTTPToolExecutionPolicy::OrHash,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Tool source authentication configuration. The `kind` field selects one of
+            # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+            auth:,
+            namespace:,
+            tools:,
+            approval: nil,
+            enabled: nil,
+            # HTTP tool execution retry and timeout policy.
+            execution: nil,
+            type: :http
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                auth:
+                  T.any(
+                    Cerca::NoToolSourceAuth,
+                    Cerca::APIKeyToolSourceAuth,
+                    Cerca::OAuthExchangeToolSourceAuth,
+                    Cerca::OAuthConnectionToolSourceAuth
+                  ),
+                namespace: String,
+                tools: T::Array[Cerca::HTTPToolDefinition],
+                type: Symbol,
+                approval: Cerca::ToolApprovalMode::OrSymbol,
+                enabled: T::Boolean,
+                execution: Cerca::HTTPToolExecutionPolicy
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        class CreateMcpToolSourceRequest < Cerca::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Cerca::ToolCreateParams::Body::CreateMcpToolSourceRequest,
+                Cerca::Internal::AnyHash
+              )
+            end
+
+          # Tool source authentication configuration. The `kind` field selects one of
+          # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+          sig do
+            returns(
+              T.any(
+                Cerca::NoToolSourceAuth,
+                Cerca::APIKeyToolSourceAuth,
+                Cerca::OAuthExchangeToolSourceAuth,
+                Cerca::OAuthConnectionToolSourceAuth
+              )
+            )
+          end
+          attr_accessor :auth
+
+          sig { returns(String) }
+          attr_accessor :namespace
+
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          sig { returns(String) }
+          attr_accessor :url
+
+          sig { returns(T.nilable(Cerca::ToolApprovalMode::OrSymbol)) }
+          attr_reader :approval
+
+          sig { params(approval: Cerca::ToolApprovalMode::OrSymbol).void }
+          attr_writer :approval
+
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :enabled
+
+          sig { params(enabled: T::Boolean).void }
+          attr_writer :enabled
+
+          # MCP discovery and execution retry/timeout policy.
+          sig { returns(T.nilable(Cerca::McpToolExecutionPolicy)) }
+          attr_reader :execution
+
+          sig { params(execution: Cerca::McpToolExecutionPolicy::OrHash).void }
+          attr_writer :execution
+
+          sig do
+            params(
+              auth:
+                T.any(
+                  Cerca::NoToolSourceAuth::OrHash,
+                  Cerca::APIKeyToolSourceAuth::OrHash,
+                  Cerca::OAuthExchangeToolSourceAuth::OrHash,
+                  Cerca::OAuthConnectionToolSourceAuth::OrHash
+                ),
+              namespace: String,
+              url: String,
+              approval: Cerca::ToolApprovalMode::OrSymbol,
+              enabled: T::Boolean,
+              execution: Cerca::McpToolExecutionPolicy::OrHash,
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Tool source authentication configuration. The `kind` field selects one of
+            # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+            auth:,
+            namespace:,
+            url:,
+            approval: nil,
+            enabled: nil,
+            # MCP discovery and execution retry/timeout policy.
+            execution: nil,
+            type: :mcp
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                auth:
+                  T.any(
+                    Cerca::NoToolSourceAuth,
+                    Cerca::APIKeyToolSourceAuth,
+                    Cerca::OAuthExchangeToolSourceAuth,
+                    Cerca::OAuthConnectionToolSourceAuth
+                  ),
+                namespace: String,
+                type: Symbol,
+                url: String,
+                approval: Cerca::ToolApprovalMode::OrSymbol,
+                enabled: T::Boolean,
+                execution: Cerca::McpToolExecutionPolicy
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        sig do
+          override.returns(T::Array[Cerca::ToolCreateParams::Body::Variants])
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool_delete_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ToolDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::ToolDeleteParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :source_id
+
+      sig do
+        params(
+          fleet_id: String,
+          source_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(fleet_id:, source_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            source_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool_descriptor.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ToolDescriptor < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::ToolDescriptor, Cerca::Internal::AnyHash) }
+
+      sig { returns(Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol) }
+      attr_accessor :approval_source
+
+      sig { returns(Cerca::ToolDescriptor::Category::TaggedSymbol) }
+      attr_accessor :category
+
+      sig { returns(String) }
+      attr_accessor :description
+
+      # JSON Schema object describing tool input parameters.
+      sig { returns(T::Hash[Symbol, T.anything]) }
+      attr_accessor :input_schema
+
+      sig { returns(Cerca::ToolName::TaggedSymbol) }
+      attr_accessor :name
+
+      sig { returns(T::Boolean) }
+      attr_accessor :requires_approval
+
+      # A built-in or configurable runtime tool currently available to the agent.
+      sig do
+        params(
+          approval_source: Cerca::ToolDescriptor::ApprovalSource::OrSymbol,
+          category: Cerca::ToolDescriptor::Category::OrSymbol,
+          description: String,
+          input_schema: T::Hash[Symbol, T.anything],
+          name: Cerca::ToolName::OrSymbol,
+          requires_approval: T::Boolean
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        approval_source:,
+        category:,
+        description:,
+        # JSON Schema object describing tool input parameters.
+        input_schema:,
+        name:,
+        requires_approval:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            approval_source:
+              Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol,
+            category: Cerca::ToolDescriptor::Category::TaggedSymbol,
+            description: String,
+            input_schema: T::Hash[Symbol, T.anything],
+            name: Cerca::ToolName::TaggedSymbol,
+            requires_approval: T::Boolean
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module ApprovalSource
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cerca::ToolDescriptor::ApprovalSource) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AGENT =
+          T.let(:agent, Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol)
+        ENV = T.let(:env, Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol)
+        CATALOG =
+          T.let(:catalog, Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Cerca::ToolDescriptor::ApprovalSource::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module Category
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cerca::ToolDescriptor::Category) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        BUILT_IN =
+          T.let(:builtIn, Cerca::ToolDescriptor::Category::TaggedSymbol)
+        CONFIGURABLE =
+          T.let(:configurable, Cerca::ToolDescriptor::Category::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Cerca::ToolDescriptor::Category::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/tool_list_params.rbi

@@ -0,0 +1,63 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class ToolListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias { T.any(Cerca::ToolListParams, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      # Opaque pagination cursor returned by a previous request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of items to return. Defaults to 20 and preserves parseInt
+      # semantics.
+      sig { returns(T.nilable(String)) }
+      attr_reader :limit
+
+      sig { params(limit: String).void }
+      attr_writer :limit
+
+      sig do
+        params(
+          fleet_id: String,
+          cursor: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        fleet_id:,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            cursor: String,
+            limit: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end