cerca 0.1.0

data/rbi/cerca/models/fleet.rbi

@@ -0,0 +1,50 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class Fleet < Cerca::Internal::Type::BaseModel
+      OrHash = T.type_alias { T.any(Cerca::Fleet, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig { returns(String) }
+      attr_accessor :org_id
+
+      sig { returns(String) }
+      attr_accessor :updated_at
+
+      sig do
+        params(
+          id: String,
+          created_at: String,
+          name: String,
+          org_id: String,
+          updated_at: String
+        ).returns(T.attached_class)
+      end
+      def self.new(id:, created_at:, name:, org_id:, updated_at:)
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: String,
+            name: String,
+            org_id: String,
+            updated_at: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/http_endpoint.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class HTTPEndpoint < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::HTTPEndpoint, Cerca::Internal::AnyHash) }
+
+      sig { returns(Cerca::HTTPEndpoint::Method::OrSymbol) }
+      attr_accessor :method_
+
+      sig { returns(String) }
+      attr_accessor :url
+
+      sig { returns(T.nilable(Cerca::HTTPEndpoint::Body::OrSymbol)) }
+      attr_reader :body
+
+      sig { params(body: Cerca::HTTPEndpoint::Body::OrSymbol).void }
+      attr_writer :body
+
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :headers
+
+      sig { params(headers: T::Hash[Symbol, String]).void }
+      attr_writer :headers
+
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :path
+
+      sig { params(path: T::Hash[Symbol, String]).void }
+      attr_writer :path
+
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :query
+
+      sig { params(query: T::Hash[Symbol, String]).void }
+      attr_writer :query
+
+      # HTTP endpoint invoked when the tool is called.
+      sig do
+        params(
+          method_: Cerca::HTTPEndpoint::Method::OrSymbol,
+          url: String,
+          body: Cerca::HTTPEndpoint::Body::OrSymbol,
+          headers: T::Hash[Symbol, String],
+          path: T::Hash[Symbol, String],
+          query: T::Hash[Symbol, String]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        method_:,
+        url:,
+        body: nil,
+        headers: nil,
+        path: nil,
+        query: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            method_: Cerca::HTTPEndpoint::Method::OrSymbol,
+            url: String,
+            body: Cerca::HTTPEndpoint::Body::OrSymbol,
+            headers: T::Hash[Symbol, String],
+            path: T::Hash[Symbol, String],
+            query: T::Hash[Symbol, String]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Method
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cerca::HTTPEndpoint::Method) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        GET = T.let(:GET, Cerca::HTTPEndpoint::Method::TaggedSymbol)
+        POST = T.let(:POST, Cerca::HTTPEndpoint::Method::TaggedSymbol)
+        PUT = T.let(:PUT, Cerca::HTTPEndpoint::Method::TaggedSymbol)
+        PATCH = T.let(:PATCH, Cerca::HTTPEndpoint::Method::TaggedSymbol)
+        DELETE = T.let(:DELETE, Cerca::HTTPEndpoint::Method::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Cerca::HTTPEndpoint::Method::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+
+      module Body
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, Cerca::HTTPEndpoint::Body) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        JSON_PARAMS =
+          T.let(:json_params, Cerca::HTTPEndpoint::Body::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Cerca::HTTPEndpoint::Body::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/http_tool_definition.rbi

@@ -0,0 +1,92 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class HTTPToolDefinition < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::HTTPToolDefinition, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :description
+
+      # HTTP endpoint invoked when the tool is called.
+      sig { returns(Cerca::HTTPEndpoint) }
+      attr_reader :endpoint
+
+      sig { params(endpoint: Cerca::HTTPEndpoint::OrHash).void }
+      attr_writer :endpoint
+
+      # JSON Schema object describing tool input parameters.
+      sig { returns(T::Hash[Symbol, T.anything]) }
+      attr_accessor :input_schema
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig { returns(T.nilable(Cerca::ToolApprovalMode::OrSymbol)) }
+      attr_reader :approval
+
+      sig { params(approval: Cerca::ToolApprovalMode::OrSymbol).void }
+      attr_writer :approval
+
+      # 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
+
+      # How the HTTP response should be normalized for the agent.
+      sig { returns(T.nilable(Cerca::ResponseNormalizationHint)) }
+      attr_reader :response
+
+      sig { params(response: Cerca::ResponseNormalizationHint::OrHash).void }
+      attr_writer :response
+
+      # Definition for a single HTTP tool exposed by a tool source.
+      sig do
+        params(
+          description: String,
+          endpoint: Cerca::HTTPEndpoint::OrHash,
+          input_schema: T::Hash[Symbol, T.anything],
+          name: String,
+          approval: Cerca::ToolApprovalMode::OrSymbol,
+          execution: Cerca::HTTPToolExecutionPolicy::OrHash,
+          response: Cerca::ResponseNormalizationHint::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        description:,
+        # HTTP endpoint invoked when the tool is called.
+        endpoint:,
+        # JSON Schema object describing tool input parameters.
+        input_schema:,
+        name:,
+        approval: nil,
+        # HTTP tool execution retry and timeout policy.
+        execution: nil,
+        # How the HTTP response should be normalized for the agent.
+        response: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            description: String,
+            endpoint: Cerca::HTTPEndpoint,
+            input_schema: T::Hash[Symbol, T.anything],
+            name: String,
+            approval: Cerca::ToolApprovalMode::OrSymbol,
+            execution: Cerca::HTTPToolExecutionPolicy,
+            response: Cerca::ResponseNormalizationHint
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/http_tool_execution_policy.rbi

@@ -0,0 +1,106 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class HTTPToolExecutionPolicy < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::HTTPToolExecutionPolicy, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :idempotency_key_header
+
+      sig { params(idempotency_key_header: String).void }
+      attr_writer :idempotency_key_header
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :max_attempts
+
+      sig { params(max_attempts: Float).void }
+      attr_writer :max_attempts
+
+      sig do
+        returns(T.nilable(Cerca::HTTPToolExecutionPolicy::RetryMode::OrSymbol))
+      end
+      attr_reader :retry_mode
+
+      sig do
+        params(
+          retry_mode: Cerca::HTTPToolExecutionPolicy::RetryMode::OrSymbol
+        ).void
+      end
+      attr_writer :retry_mode
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Float).void }
+      attr_writer :timeout_ms
+
+      # HTTP tool execution retry and timeout policy.
+      sig do
+        params(
+          idempotency_key_header: String,
+          max_attempts: Float,
+          retry_mode: Cerca::HTTPToolExecutionPolicy::RetryMode::OrSymbol,
+          timeout_ms: Float
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        idempotency_key_header: nil,
+        max_attempts: nil,
+        retry_mode: nil,
+        timeout_ms: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            idempotency_key_header: String,
+            max_attempts: Float,
+            retry_mode: Cerca::HTTPToolExecutionPolicy::RetryMode::OrSymbol,
+            timeout_ms: Float
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module RetryMode
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Cerca::HTTPToolExecutionPolicy::RetryMode)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DISABLED =
+          T.let(
+            :disabled,
+            Cerca::HTTPToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+        SAFE_ONLY =
+          T.let(
+            :safe_only,
+            Cerca::HTTPToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+        ENABLED =
+          T.let(
+            :enabled,
+            Cerca::HTTPToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cerca::HTTPToolExecutionPolicy::RetryMode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/http_tool_source.rbi

@@ -0,0 +1,117 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class HTTPToolSource < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::HTTPToolSource, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Tool source authentication configuration. The `kind` field selects one of
+      # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+      sig { returns(Cerca::ToolSourceAuth::Variants) }
+      attr_accessor :auth
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(T::Boolean) }
+      attr_accessor :enabled
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      sig { returns(T::Array[Cerca::HTTPToolDefinition]) }
+      attr_accessor :tools
+
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig { returns(String) }
+      attr_accessor :updated_at
+
+      sig { returns(Float) }
+      attr_accessor :version
+
+      sig { returns(T.nilable(Cerca::ToolApprovalMode::TaggedSymbol)) }
+      attr_reader :approval
+
+      sig { params(approval: Cerca::ToolApprovalMode::OrSymbol).void }
+      attr_writer :approval
+
+      # 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(
+          id: String,
+          auth:
+            T.any(
+              Cerca::NoToolSourceAuth::OrHash,
+              Cerca::APIKeyToolSourceAuth::OrHash,
+              Cerca::OAuthExchangeToolSourceAuth::OrHash,
+              Cerca::OAuthConnectionToolSourceAuth::OrHash
+            ),
+          created_at: String,
+          enabled: T::Boolean,
+          fleet_id: String,
+          namespace: String,
+          tools: T::Array[Cerca::HTTPToolDefinition::OrHash],
+          updated_at: String,
+          version: Float,
+          approval: Cerca::ToolApprovalMode::OrSymbol,
+          execution: Cerca::HTTPToolExecutionPolicy::OrHash,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # Tool source authentication configuration. The `kind` field selects one of
+        # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+        auth:,
+        created_at:,
+        enabled:,
+        fleet_id:,
+        namespace:,
+        tools:,
+        updated_at:,
+        version:,
+        approval: nil,
+        # HTTP tool execution retry and timeout policy.
+        execution: nil,
+        type: :http
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            auth: Cerca::ToolSourceAuth::Variants,
+            created_at: String,
+            enabled: T::Boolean,
+            fleet_id: String,
+            namespace: String,
+            tools: T::Array[Cerca::HTTPToolDefinition],
+            type: Symbol,
+            updated_at: String,
+            version: Float,
+            approval: Cerca::ToolApprovalMode::TaggedSymbol,
+            execution: Cerca::HTTPToolExecutionPolicy
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/json_object.rbi

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

data/rbi/cerca/models/mcp_tool_execution_policy.rbi

@@ -0,0 +1,106 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class McpToolExecutionPolicy < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::McpToolExecutionPolicy, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :discovery_timeout_ms
+
+      sig { params(discovery_timeout_ms: Float).void }
+      attr_writer :discovery_timeout_ms
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :execution_timeout_ms
+
+      sig { params(execution_timeout_ms: Float).void }
+      attr_writer :execution_timeout_ms
+
+      sig { returns(T.nilable(Float)) }
+      attr_reader :max_attempts
+
+      sig { params(max_attempts: Float).void }
+      attr_writer :max_attempts
+
+      sig do
+        returns(T.nilable(Cerca::McpToolExecutionPolicy::RetryMode::OrSymbol))
+      end
+      attr_reader :retry_mode
+
+      sig do
+        params(
+          retry_mode: Cerca::McpToolExecutionPolicy::RetryMode::OrSymbol
+        ).void
+      end
+      attr_writer :retry_mode
+
+      # MCP discovery and execution retry/timeout policy.
+      sig do
+        params(
+          discovery_timeout_ms: Float,
+          execution_timeout_ms: Float,
+          max_attempts: Float,
+          retry_mode: Cerca::McpToolExecutionPolicy::RetryMode::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        discovery_timeout_ms: nil,
+        execution_timeout_ms: nil,
+        max_attempts: nil,
+        retry_mode: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            discovery_timeout_ms: Float,
+            execution_timeout_ms: Float,
+            max_attempts: Float,
+            retry_mode: Cerca::McpToolExecutionPolicy::RetryMode::OrSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module RetryMode
+        extend Cerca::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Cerca::McpToolExecutionPolicy::RetryMode)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DISABLED =
+          T.let(
+            :disabled,
+            Cerca::McpToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+        CONNECT_ONLY =
+          T.let(
+            :connect_only,
+            Cerca::McpToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+        ENABLED =
+          T.let(
+            :enabled,
+            Cerca::McpToolExecutionPolicy::RetryMode::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cerca::McpToolExecutionPolicy::RetryMode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/cerca/models/mcp_tool_source.rbi

@@ -0,0 +1,117 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class McpToolSource < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cerca::McpToolSource, Cerca::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Tool source authentication configuration. The `kind` field selects one of
+      # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+      sig { returns(Cerca::ToolSourceAuth::Variants) }
+      attr_accessor :auth
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(T::Boolean) }
+      attr_accessor :enabled
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :namespace
+
+      sig { returns(Symbol) }
+      attr_accessor :type
+
+      sig { returns(String) }
+      attr_accessor :updated_at
+
+      sig { returns(String) }
+      attr_accessor :url
+
+      sig { returns(Float) }
+      attr_accessor :version
+
+      sig { returns(T.nilable(Cerca::ToolApprovalMode::TaggedSymbol)) }
+      attr_reader :approval
+
+      sig { params(approval: Cerca::ToolApprovalMode::OrSymbol).void }
+      attr_writer :approval
+
+      # 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(
+          id: String,
+          auth:
+            T.any(
+              Cerca::NoToolSourceAuth::OrHash,
+              Cerca::APIKeyToolSourceAuth::OrHash,
+              Cerca::OAuthExchangeToolSourceAuth::OrHash,
+              Cerca::OAuthConnectionToolSourceAuth::OrHash
+            ),
+          created_at: String,
+          enabled: T::Boolean,
+          fleet_id: String,
+          namespace: String,
+          updated_at: String,
+          url: String,
+          version: Float,
+          approval: Cerca::ToolApprovalMode::OrSymbol,
+          execution: Cerca::McpToolExecutionPolicy::OrHash,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # Tool source authentication configuration. The `kind` field selects one of
+        # `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+        auth:,
+        created_at:,
+        enabled:,
+        fleet_id:,
+        namespace:,
+        updated_at:,
+        url:,
+        version:,
+        approval: nil,
+        # MCP discovery and execution retry/timeout policy.
+        execution: nil,
+        type: :mcp
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            auth: Cerca::ToolSourceAuth::Variants,
+            created_at: String,
+            enabled: T::Boolean,
+            fleet_id: String,
+            namespace: String,
+            type: Symbol,
+            updated_at: String,
+            url: String,
+            version: Float,
+            approval: Cerca::ToolApprovalMode::TaggedSymbol,
+            execution: Cerca::McpToolExecutionPolicy
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end