cerca 0.1.0

data/lib/cerca/models/context_list_params.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#list
+    class ContextListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_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
+
+      # @!attribute prefix
+      #   Optional key prefix filter.
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!method initialize(agent_id:, cursor: nil, limit: nil, prefix: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ContextListParams} for more details.
+      #
+      #   @param agent_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 prefix [String] Optional key prefix filter.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/context_retrieve_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#retrieve
+    class ContextRetrieveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute key
+      #   Context entry key.
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!method initialize(agent_id:, key:, request_options: {})
+      #   @param agent_id [String]
+      #
+      #   @param key [String] Context entry key.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/context_search_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#search
+    class ContextSearchParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute q
+      #   Search query.
+      #
+      #   @return [String]
+      required :q, 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
+
+      # @!attribute prefix
+      #   Optional key prefix filter.
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!method initialize(agent_id:, q:, cursor: nil, limit: nil, prefix: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ContextSearchParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param q [String] Search query.
+      #
+      #   @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 prefix [String] Optional key prefix filter.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/context_write_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#write
+    class ContextWriteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute content
+      #
+      #   @return [String]
+      required :content, String
+
+      # @!attribute key
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!attribute expected_version
+      #
+      #   @return [Float, nil]
+      optional :expected_version, Float, api_name: :expectedVersion
+
+      # @!attribute mime_type
+      #
+      #   @return [String, nil]
+      optional :mime_type, String, api_name: :mimeType
+
+      # @!method initialize(agent_id:, content:, key:, expected_version: nil, mime_type: nil, request_options: {})
+      #   @param agent_id [String]
+      #   @param content [String]
+      #   @param key [String]
+      #   @param expected_version [Float]
+      #   @param mime_type [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/credential_provider.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module CredentialProvider
+      extend Cerca::Internal::Type::Enum
+
+      GOOGLE = :google
+      GITHUB = :github
+      SLACK = :slack
+      LINEAR = :linear
+      NOTION = :notion
+      CUSTOM = :custom
+      WEBHOOK = :webhook
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/credential_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module CredentialType
+      extend Cerca::Internal::Type::Enum
+
+      OAUTH = :oauth
+      API_KEY = :api_key
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/discovered_tool.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class DiscoveredTool < Cerca::Internal::Type::BaseModel
+      # @!attribute approval
+      #
+      #   @return [Symbol, Cerca::Models::DiscoveredTool::Approval]
+      required :approval, enum: -> { Cerca::DiscoveredTool::Approval }
+
+      # @!attribute category
+      #
+      #   @return [Symbol, :external]
+      required :category, const: :external
+
+      # @!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 [String]
+      required :name, String
+
+      # @!attribute origin
+      #
+      #   @return [Symbol, Cerca::Models::DiscoveredTool::Origin]
+      required :origin, enum: -> { Cerca::DiscoveredTool::Origin }
+
+      # @!attribute source
+      #
+      #   @return [String]
+      required :source, String
+
+      # @!attribute account_label
+      #
+      #   @return [String, nil]
+      optional :account_label, String, api_name: :accountLabel
+
+      # @!attribute connection_id
+      #
+      #   @return [String, nil]
+      optional :connection_id, String, api_name: :connectionId
+
+      # @!attribute connection_metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :connection_metadata, Cerca::Internal::Type::HashOf[String], api_name: :connectionMetadata
+
+      # @!attribute source_id
+      #
+      #   @return [String, nil]
+      optional :source_id, String, api_name: :sourceId
+
+      # @!attribute source_version
+      #
+      #   @return [Float, nil]
+      optional :source_version, Float, api_name: :sourceVersion
+
+      # @!method initialize(approval:, description:, input_schema:, name:, origin:, source:, account_label: nil, connection_id: nil, connection_metadata: nil, source_id: nil, source_version: nil, category: :external)
+      #   An external provider or tool-source tool currently available to the agent.
+      #
+      #   @param approval [Symbol, Cerca::Models::DiscoveredTool::Approval]
+      #
+      #   @param description [String]
+      #
+      #   @param input_schema [Hash{Symbol=>Object}] JSON Schema object describing tool input parameters.
+      #
+      #   @param name [String]
+      #
+      #   @param origin [Symbol, Cerca::Models::DiscoveredTool::Origin]
+      #
+      #   @param source [String]
+      #
+      #   @param account_label [String]
+      #
+      #   @param connection_id [String]
+      #
+      #   @param connection_metadata [Hash{Symbol=>String}]
+      #
+      #   @param source_id [String]
+      #
+      #   @param source_version [Float]
+      #
+      #   @param category [Symbol, :external]
+
+      # @see Cerca::Models::DiscoveredTool#approval
+      module Approval
+        extend Cerca::Internal::Type::Enum
+
+        ALWAYS = :always
+        NEVER = :never
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Cerca::Models::DiscoveredTool#origin
+      module Origin
+        extend Cerca::Internal::Type::Enum
+
+        BUILTIN = :builtin
+        TOOL_SOURCE = :tool_source
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/effective_configuration.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#retrieve_config
+    class EffectiveConfiguration < Cerca::Internal::Type::BaseModel
+      # @!attribute approvals
+      #
+      #   @return [Cerca::Models::EffectiveConfiguration::Approvals]
+      required :approvals, -> { Cerca::EffectiveConfiguration::Approvals }
+
+      # @!attribute approvals_writable_by_agent
+      #
+      #   @return [Boolean]
+      required :approvals_writable_by_agent,
+               Cerca::Internal::Type::Boolean,
+               api_name: :approvalsWritableByAgent
+
+      # @!attribute default_model
+      #
+      #   @return [String]
+      required :default_model, String, api_name: :defaultModel
+
+      # @!attribute locked_by_fleet
+      #
+      #   @return [Array<Symbol, Cerca::Models::ConfigurationFieldName>]
+      required :locked_by_fleet,
+               -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::ConfigurationFieldName] },
+               api_name: :lockedByFleet
+
+      # @!attribute resolved_from_fleet
+      #
+      #   @return [Array<Symbol, Cerca::Models::ConfigurationFieldName>]
+      required :resolved_from_fleet,
+               -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::ConfigurationFieldName] },
+               api_name: :resolvedFromFleet
+
+      # @!attribute tools
+      #   Effective internal runtime tools after applying fleet defaults, fleet locks, and
+      #   the agent allowlist.
+      #
+      #   @return [Array<Symbol, Cerca::Models::ToolName>]
+      required :tools, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::ToolName] }
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!method initialize(approvals:, approvals_writable_by_agent:, default_model:, locked_by_fleet:, resolved_from_fleet:, tools:, instructions: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::EffectiveConfiguration} for more details.
+      #
+      #   @param approvals [Cerca::Models::EffectiveConfiguration::Approvals]
+      #
+      #   @param approvals_writable_by_agent [Boolean]
+      #
+      #   @param default_model [String]
+      #
+      #   @param locked_by_fleet [Array<Symbol, Cerca::Models::ConfigurationFieldName>]
+      #
+      #   @param resolved_from_fleet [Array<Symbol, Cerca::Models::ConfigurationFieldName>]
+      #
+      #   @param tools [Array<Symbol, Cerca::Models::ToolName>] Effective internal runtime tools after applying fleet defaults, fleet locks, and
+      #
+      #   @param instructions [String]
+
+      # @see Cerca::Models::EffectiveConfiguration#approvals
+      class Approvals < Cerca::Internal::Type::BaseModel
+        # @!attribute timeout_ms
+        #
+        #   @return [Float]
+        required :timeout_ms, Float, api_name: :timeoutMs
+
+        # @!attribute tools
+        #
+        #   @return [Hash{Symbol=>Symbol, Cerca::Models::ApprovalMode}]
+        required :tools, -> { Cerca::Internal::Type::HashOf[enum: Cerca::ApprovalMode] }
+
+        # @!method initialize(timeout_ms:, tools:)
+        #   @param timeout_ms [Float]
+        #   @param tools [Hash{Symbol=>Symbol, Cerca::Models::ApprovalMode}]
+      end
+    end
+  end
+end

data/lib/cerca/models/entry.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#retrieve
+    class Entry < Cerca::Internal::Type::BaseModel
+      # @!attribute content
+      #
+      #   @return [String]
+      required :content, String
+
+      # @!attribute key
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute version
+      #
+      #   @return [Float]
+      required :version, Float
+
+      # @!attribute mime_type
+      #
+      #   @return [String, nil]
+      optional :mime_type, String, api_name: :mimeType
+
+      # @!method initialize(content:, key:, updated_at:, version:, mime_type: nil)
+      #   @param content [String]
+      #   @param key [String]
+      #   @param updated_at [String]
+      #   @param version [Float]
+      #   @param mime_type [String]
+    end
+  end
+end

data/lib/cerca/models/entry_summary.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#list
+    class EntrySummary < Cerca::Internal::Type::BaseModel
+      # @!attribute byte_length
+      #
+      #   @return [Float]
+      required :byte_length, Float, api_name: :byteLength
+
+      # @!attribute key
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute version
+      #
+      #   @return [Float]
+      required :version, Float
+
+      # @!attribute mime_type
+      #
+      #   @return [String, nil]
+      optional :mime_type, String, api_name: :mimeType
+
+      # @!method initialize(byte_length:, key:, updated_at:, version:, mime_type: nil)
+      #   @param byte_length [Float]
+      #   @param key [String]
+      #   @param updated_at [String]
+      #   @param version [Float]
+      #   @param mime_type [String]
+    end
+  end
+end

data/lib/cerca/models/error_response.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class ErrorResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute error
+      #
+      #   @return [String]
+      required :error, String
+
+      # @!attribute code
+      #   Stable machine-readable error code when the API can provide one.
+      #
+      #   @return [String, nil]
+      optional :code, String
+
+      # @!method initialize(error:, code: nil)
+      #   @param error [String]
+      #
+      #   @param code [String] Stable machine-readable error code when the API can provide one.
+    end
+  end
+end

data/lib/cerca/models/event_list_for_agent_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#list_for_agent
+    class EventListForAgentParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute events
+      #   Comma-separated event type filter.
+      #
+      #   @return [String, nil]
+      optional :events, String
+
+      # @!attribute history
+      #   When true, starts from the beginning of the retained buffer.
+      #
+      #   @return [Symbol, Cerca::Models::EventListForAgentParams::History, nil]
+      optional :history, enum: -> { Cerca::EventListForAgentParams::History }
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!method initialize(agent_id:, cursor: nil, events: nil, history: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::EventListForAgentParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param events [String] Comma-separated event type filter.
+      #
+      #   @param history [Symbol, Cerca::Models::EventListForAgentParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      # When true, starts from the beginning of the retained buffer.
+      module History
+        extend Cerca::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/event_list_for_fleet_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#list_for_fleet
+    class EventListForFleetParams < 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 events
+      #   Comma-separated event type filter.
+      #
+      #   @return [String, nil]
+      optional :events, String
+
+      # @!attribute history
+      #   When true, starts from the beginning of the retained buffer.
+      #
+      #   @return [Symbol, Cerca::Models::EventListForFleetParams::History, nil]
+      optional :history, enum: -> { Cerca::EventListForFleetParams::History }
+
+      # @!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, events: nil, history: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::EventListForFleetParams} for more details.
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param events [String] Comma-separated event type filter.
+      #
+      #   @param history [Symbol, Cerca::Models::EventListForFleetParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      # When true, starts from the beginning of the retained buffer.
+      module History
+        extend Cerca::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end