cerca 0.1.0

data/sig/cerca/models/content_block.rbs

@@ -0,0 +1,200 @@
+module Cerca
+  module Models
+    type content_block =
+      Cerca::ContentBlock::TextContentBlock
+      | Cerca::ContentBlock::ToolUseContentBlock
+      | Cerca::ContentBlock::ToolResultContentBlock
+      | Cerca::ContentBlock::ServerToolUseContentBlock
+      | Cerca::ContentBlock::WebSearchToolResultContentBlock
+
+    module ContentBlock
+      extend Cerca::Internal::Type::Union
+
+      type text_content_block =
+        {
+          text: String,
+          type: :text,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+
+      class TextContentBlock < Cerca::Internal::Type::BaseModel
+        attr_accessor text: String
+
+        attr_accessor type: :text
+
+        attr_reader provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]?
+
+        def provider_metadata=: (
+          ::Hash[Symbol, ::Hash[Symbol, String]]
+        ) -> ::Hash[Symbol, ::Hash[Symbol, String]]
+
+        def initialize: (
+          text: String,
+          ?provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]],
+          ?type: :text
+        ) -> void
+
+        def to_hash: -> {
+          text: String,
+          type: :text,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+      end
+
+      type tool_use_content_block =
+        {
+          id: String,
+          input: top,
+          name: Cerca::Models::tool_name,
+          type: :tool_use,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+
+      class ToolUseContentBlock < Cerca::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor input: top
+
+        attr_accessor name: Cerca::Models::tool_name
+
+        attr_accessor type: :tool_use
+
+        attr_reader provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]?
+
+        def provider_metadata=: (
+          ::Hash[Symbol, ::Hash[Symbol, String]]
+        ) -> ::Hash[Symbol, ::Hash[Symbol, String]]
+
+        def initialize: (
+          id: String,
+          input: top,
+          name: Cerca::Models::tool_name,
+          ?provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]],
+          ?type: :tool_use
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          input: top,
+          name: Cerca::Models::tool_name,
+          type: :tool_use,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+      end
+
+      type tool_result_content_block =
+        {
+          content: String,
+          is_error: bool,
+          tool_use_id: String,
+          type: :tool_result,
+          denied_by_user: bool,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+
+      class ToolResultContentBlock < Cerca::Internal::Type::BaseModel
+        attr_accessor content: String
+
+        attr_accessor is_error: bool
+
+        attr_accessor tool_use_id: String
+
+        attr_accessor type: :tool_result
+
+        attr_reader denied_by_user: bool?
+
+        def denied_by_user=: (bool) -> bool
+
+        attr_reader provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]?
+
+        def provider_metadata=: (
+          ::Hash[Symbol, ::Hash[Symbol, String]]
+        ) -> ::Hash[Symbol, ::Hash[Symbol, String]]
+
+        def initialize: (
+          content: String,
+          is_error: bool,
+          tool_use_id: String,
+          ?denied_by_user: bool,
+          ?provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]],
+          ?type: :tool_result
+        ) -> void
+
+        def to_hash: -> {
+          content: String,
+          is_error: bool,
+          tool_use_id: String,
+          type: :tool_result,
+          denied_by_user: bool,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+      end
+
+      type server_tool_use_content_block =
+        {
+          id: String,
+          input: top,
+          name: String,
+          type: :server_tool_use,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+
+      class ServerToolUseContentBlock < Cerca::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor input: top
+
+        attr_accessor name: String
+
+        attr_accessor type: :server_tool_use
+
+        attr_reader provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]?
+
+        def provider_metadata=: (
+          ::Hash[Symbol, ::Hash[Symbol, String]]
+        ) -> ::Hash[Symbol, ::Hash[Symbol, String]]
+
+        def initialize: (
+          id: String,
+          input: top,
+          name: String,
+          ?provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]],
+          ?type: :server_tool_use
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          input: top,
+          name: String,
+          type: :server_tool_use,
+          provider_metadata: ::Hash[Symbol, ::Hash[Symbol, String]]
+        }
+      end
+
+      type web_search_tool_result_content_block =
+        { content: top, tool_use_id: String, type: :web_search_tool_result }
+
+      class WebSearchToolResultContentBlock < Cerca::Internal::Type::BaseModel
+        attr_accessor content: top
+
+        attr_accessor tool_use_id: String
+
+        attr_accessor type: :web_search_tool_result
+
+        def initialize: (
+          content: top,
+          tool_use_id: String,
+          ?type: :web_search_tool_result
+        ) -> void
+
+        def to_hash: -> {
+          content: top,
+          tool_use_id: String,
+          type: :web_search_tool_result
+        }
+      end
+
+      def self?.variants: -> ::Array[Cerca::Models::content_block]
+    end
+  end
+end

data/sig/cerca/models/context_delete_params.rbs

@@ -0,0 +1,28 @@
+module Cerca
+  module Models
+    type context_delete_params =
+      { agent_id: String, key: String }
+      & Cerca::Internal::Type::request_parameters
+
+    class ContextDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor key: String
+
+      def initialize: (
+        agent_id: String,
+        key: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        key: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/context_delete_response.rbs

@@ -0,0 +1,13 @@
+module Cerca
+  module Models
+    type context_delete_response = { success: true }
+
+    class ContextDeleteResponse < Cerca::Internal::Type::BaseModel
+      attr_accessor success: true
+
+      def initialize: (?success: true) -> void
+
+      def to_hash: -> { success: true }
+    end
+  end
+end

data/sig/cerca/models/context_list_params.rbs

@@ -0,0 +1,42 @@
+module Cerca
+  module Models
+    type context_list_params =
+      { agent_id: String, cursor: String, limit: String, prefix: String }
+      & Cerca::Internal::Type::request_parameters
+
+    class ContextListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader limit: String?
+
+      def limit=: (String) -> String
+
+      attr_reader prefix: String?
+
+      def prefix=: (String) -> String
+
+      def initialize: (
+        agent_id: String,
+        ?cursor: String,
+        ?limit: String,
+        ?prefix: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        cursor: String,
+        limit: String,
+        prefix: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/context_retrieve_params.rbs

@@ -0,0 +1,28 @@
+module Cerca
+  module Models
+    type context_retrieve_params =
+      { agent_id: String, key: String }
+      & Cerca::Internal::Type::request_parameters
+
+    class ContextRetrieveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor key: String
+
+      def initialize: (
+        agent_id: String,
+        key: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        key: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/context_search_params.rbs

@@ -0,0 +1,52 @@
+module Cerca
+  module Models
+    type context_search_params =
+      {
+        agent_id: String,
+        q: String,
+        cursor: String,
+        limit: String,
+        prefix: String
+      }
+      & Cerca::Internal::Type::request_parameters
+
+    class ContextSearchParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor q: String
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader limit: String?
+
+      def limit=: (String) -> String
+
+      attr_reader prefix: String?
+
+      def prefix=: (String) -> String
+
+      def initialize: (
+        agent_id: String,
+        q: String,
+        ?cursor: String,
+        ?limit: String,
+        ?prefix: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        q: String,
+        cursor: String,
+        limit: String,
+        prefix: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/context_write_params.rbs

@@ -0,0 +1,50 @@
+module Cerca
+  module Models
+    type context_write_params =
+      {
+        agent_id: String,
+        content: String,
+        key: String,
+        expected_version: Float,
+        mime_type: String
+      }
+      & Cerca::Internal::Type::request_parameters
+
+    class ContextWriteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor content: String
+
+      attr_accessor key: String
+
+      attr_reader expected_version: Float?
+
+      def expected_version=: (Float) -> Float
+
+      attr_reader mime_type: String?
+
+      def mime_type=: (String) -> String
+
+      def initialize: (
+        agent_id: String,
+        content: String,
+        key: String,
+        ?expected_version: Float,
+        ?mime_type: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        content: String,
+        key: String,
+        expected_version: Float,
+        mime_type: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/credential_provider.rbs

@@ -0,0 +1,20 @@
+module Cerca
+  module Models
+    type credential_provider =
+      :google | :github | :slack | :linear | :notion | :custom | :webhook
+
+    module CredentialProvider
+      extend Cerca::Internal::Type::Enum
+
+      GOOGLE: :google
+      GITHUB: :github
+      SLACK: :slack
+      LINEAR: :linear
+      NOTION: :notion
+      CUSTOM: :custom
+      WEBHOOK: :webhook
+
+      def self?.values: -> ::Array[Cerca::Models::credential_provider]
+    end
+  end
+end

data/sig/cerca/models/credential_type.rbs

@@ -0,0 +1,14 @@
+module Cerca
+  module Models
+    type credential_type = :oauth | :api_key
+
+    module CredentialType
+      extend Cerca::Internal::Type::Enum
+
+      OAUTH: :oauth
+      API_KEY: :api_key
+
+      def self?.values: -> ::Array[Cerca::Models::credential_type]
+    end
+  end
+end

data/sig/cerca/models/discovered_tool.rbs

@@ -0,0 +1,109 @@
+module Cerca
+  module Models
+    type discovered_tool =
+      {
+        approval: Cerca::Models::DiscoveredTool::approval,
+        category: :external,
+        description: String,
+        input_schema: ::Hash[Symbol, top],
+        name: String,
+        origin: Cerca::Models::DiscoveredTool::origin,
+        source: String,
+        account_label: String,
+        connection_id: String,
+        connection_metadata: Cerca::Models::tool_connection_metadata,
+        source_id: String,
+        source_version: Float
+      }
+
+    class DiscoveredTool < Cerca::Internal::Type::BaseModel
+      attr_accessor approval: Cerca::Models::DiscoveredTool::approval
+
+      attr_accessor category: :external
+
+      attr_accessor description: String
+
+      attr_accessor input_schema: ::Hash[Symbol, top]
+
+      attr_accessor name: String
+
+      attr_accessor origin: Cerca::Models::DiscoveredTool::origin
+
+      attr_accessor source: String
+
+      attr_reader account_label: String?
+
+      def account_label=: (String) -> String
+
+      attr_reader connection_id: String?
+
+      def connection_id=: (String) -> String
+
+      attr_reader connection_metadata: Cerca::Models::tool_connection_metadata?
+
+      def connection_metadata=: (
+        Cerca::Models::tool_connection_metadata
+      ) -> Cerca::Models::tool_connection_metadata
+
+      attr_reader source_id: String?
+
+      def source_id=: (String) -> String
+
+      attr_reader source_version: Float?
+
+      def source_version=: (Float) -> Float
+
+      def initialize: (
+        approval: Cerca::Models::DiscoveredTool::approval,
+        description: String,
+        input_schema: ::Hash[Symbol, top],
+        name: String,
+        origin: Cerca::Models::DiscoveredTool::origin,
+        source: String,
+        ?account_label: String,
+        ?connection_id: String,
+        ?connection_metadata: Cerca::Models::tool_connection_metadata,
+        ?source_id: String,
+        ?source_version: Float,
+        ?category: :external
+      ) -> void
+
+      def to_hash: -> {
+        approval: Cerca::Models::DiscoveredTool::approval,
+        category: :external,
+        description: String,
+        input_schema: ::Hash[Symbol, top],
+        name: String,
+        origin: Cerca::Models::DiscoveredTool::origin,
+        source: String,
+        account_label: String,
+        connection_id: String,
+        connection_metadata: Cerca::Models::tool_connection_metadata,
+        source_id: String,
+        source_version: Float
+      }
+
+      type approval = :always | :never
+
+      module Approval
+        extend Cerca::Internal::Type::Enum
+
+        ALWAYS: :always
+        NEVER: :never
+
+        def self?.values: -> ::Array[Cerca::Models::DiscoveredTool::approval]
+      end
+
+      type origin = :builtin | :tool_source
+
+      module Origin
+        extend Cerca::Internal::Type::Enum
+
+        BUILTIN: :builtin
+        TOOL_SOURCE: :tool_source
+
+        def self?.values: -> ::Array[Cerca::Models::DiscoveredTool::origin]
+      end
+    end
+  end
+end

data/sig/cerca/models/effective_configuration.rbs

@@ -0,0 +1,74 @@
+module Cerca
+  module Models
+    type effective_configuration =
+      {
+        approvals: Cerca::EffectiveConfiguration::Approvals,
+        approvals_writable_by_agent: bool,
+        default_model: String,
+        locked_by_fleet: ::Array[Cerca::Models::configuration_field_name],
+        resolved_from_fleet: ::Array[Cerca::Models::configuration_field_name],
+        tools: ::Array[Cerca::Models::tool_name],
+        instructions: String
+      }
+
+    class EffectiveConfiguration < Cerca::Internal::Type::BaseModel
+      attr_accessor approvals: Cerca::EffectiveConfiguration::Approvals
+
+      attr_accessor approvals_writable_by_agent: bool
+
+      attr_accessor default_model: String
+
+      attr_accessor locked_by_fleet: ::Array[Cerca::Models::configuration_field_name]
+
+      attr_accessor resolved_from_fleet: ::Array[Cerca::Models::configuration_field_name]
+
+      attr_accessor tools: ::Array[Cerca::Models::tool_name]
+
+      attr_reader instructions: String?
+
+      def instructions=: (String) -> String
+
+      def initialize: (
+        approvals: Cerca::EffectiveConfiguration::Approvals,
+        approvals_writable_by_agent: bool,
+        default_model: String,
+        locked_by_fleet: ::Array[Cerca::Models::configuration_field_name],
+        resolved_from_fleet: ::Array[Cerca::Models::configuration_field_name],
+        tools: ::Array[Cerca::Models::tool_name],
+        ?instructions: String
+      ) -> void
+
+      def to_hash: -> {
+        approvals: Cerca::EffectiveConfiguration::Approvals,
+        approvals_writable_by_agent: bool,
+        default_model: String,
+        locked_by_fleet: ::Array[Cerca::Models::configuration_field_name],
+        resolved_from_fleet: ::Array[Cerca::Models::configuration_field_name],
+        tools: ::Array[Cerca::Models::tool_name],
+        instructions: String
+      }
+
+      type approvals =
+        {
+          timeout_ms: Float,
+          tools: ::Hash[Symbol, Cerca::Models::approval_mode]
+        }
+
+      class Approvals < Cerca::Internal::Type::BaseModel
+        attr_accessor timeout_ms: Float
+
+        attr_accessor tools: ::Hash[Symbol, Cerca::Models::approval_mode]
+
+        def initialize: (
+          timeout_ms: Float,
+          tools: ::Hash[Symbol, Cerca::Models::approval_mode]
+        ) -> void
+
+        def to_hash: -> {
+          timeout_ms: Float,
+          tools: ::Hash[Symbol, Cerca::Models::approval_mode]
+        }
+      end
+    end
+  end
+end

data/sig/cerca/models/entry.rbs

@@ -0,0 +1,42 @@
+module Cerca
+  module Models
+    type entry =
+      {
+        content: String,
+        key: String,
+        updated_at: String,
+        version: Float,
+        mime_type: String
+      }
+
+    class Entry < Cerca::Internal::Type::BaseModel
+      attr_accessor content: String
+
+      attr_accessor key: String
+
+      attr_accessor updated_at: String
+
+      attr_accessor version: Float
+
+      attr_reader mime_type: String?
+
+      def mime_type=: (String) -> String
+
+      def initialize: (
+        content: String,
+        key: String,
+        updated_at: String,
+        version: Float,
+        ?mime_type: String
+      ) -> void
+
+      def to_hash: -> {
+        content: String,
+        key: String,
+        updated_at: String,
+        version: Float,
+        mime_type: String
+      }
+    end
+  end
+end