cerca 0.1.0

data/lib/cerca/internal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Internal
+    extend Cerca::Internal::Util::SorbetRuntimeSupport
+
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{Cerca::Internal}::OMIT>" }
+      end
+        .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
+    define_sorbet_constant!(:FileInput) do
+      T.type_alias { T.any(Pathname, StringIO, IO, String, Cerca::FilePart) }
+    end
+  end
+end

data/lib/cerca/models/agent.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#create
+    class Agent < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute configuration
+      #
+      #   @return [Cerca::Models::Configuration]
+      required :configuration, -> { Cerca::Configuration }
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute execution_principal
+      #
+      #   @return [Cerca::Models::ExecutionPrincipal::UserExecutionPrincipal, Cerca::Models::ExecutionPrincipal::APIKeyExecutionPrincipal, nil]
+      required :execution_principal,
+               union: -> { Cerca::ExecutionPrincipal },
+               api_name: :executionPrincipal,
+               nil?: true
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute metadata
+      #   Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+      #   value sizes.
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!attribute org_id
+      #
+      #   @return [String]
+      required :org_id, String, api_name: :orgId
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute user_id
+      #
+      #   @return [String]
+      required :user_id, String, api_name: :userId
+
+      # @!attribute effective
+      #
+      #   @return [Cerca::Models::EffectiveConfiguration, nil]
+      optional :effective, -> { Cerca::EffectiveConfiguration }
+
+      # @!method initialize(id:, configuration:, created_at:, execution_principal:, fleet_id:, metadata:, org_id:, updated_at:, user_id:, effective: nil)
+      #   Some parameter documentations has been truncated, see {Cerca::Models::Agent} for
+      #   more details.
+      #
+      #   @param id [String]
+      #
+      #   @param configuration [Cerca::Models::Configuration]
+      #
+      #   @param created_at [String]
+      #
+      #   @param execution_principal [Cerca::Models::ExecutionPrincipal::UserExecutionPrincipal, Cerca::Models::ExecutionPrincipal::APIKeyExecutionPrincipal, nil]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param metadata [Hash{Symbol=>String}] Arbitrary string metadata stored on an agent. Runtime enforces maximum key and v
+      #
+      #   @param org_id [String]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param user_id [String]
+      #
+      #   @param effective [Cerca::Models::EffectiveConfiguration]
+    end
+  end
+end

data/lib/cerca/models/agent_create_params.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#create
+    class AgentCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute configuration
+      #
+      #   @return [Cerca::Models::Configuration, nil]
+      optional :configuration, -> { Cerca::Configuration }
+
+      # @!attribute fleet_id
+      #
+      #   @return [String, nil]
+      optional :fleet_id, String, api_name: :fleetId
+
+      # @!attribute metadata
+      #   Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+      #   value sizes.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!attribute user_id
+      #
+      #   @return [String, nil]
+      optional :user_id, String, api_name: :userId
+
+      # @!method initialize(configuration: nil, fleet_id: nil, metadata: nil, user_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::AgentCreateParams} for more details.
+      #
+      #   @param configuration [Cerca::Models::Configuration]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param metadata [Hash{Symbol=>String}] Arbitrary string metadata stored on an agent. Runtime enforces maximum key and v
+      #
+      #   @param user_id [String]
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/agent_delete_params.rb

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

data/lib/cerca/models/agent_delete_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#delete
+    class AgentDeleteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/agent_list_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#list
+    class AgentListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute active
+      #   When set to true, lists only agents with active or awaiting threads.
+      #
+      #   @return [Symbol, Cerca::Models::AgentListParams::Active, nil]
+      optional :active, enum: -> { Cerca::AgentListParams::Active }
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute fleet_id
+      #   Fleet to list agents from. Defaults to the API key's default fleet when omitted.
+      #
+      #   @return [String, nil]
+      optional :fleet_id, String
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!method initialize(active: nil, cursor: nil, fleet_id: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::AgentListParams} for more details.
+      #
+      #   @param active [Symbol, Cerca::Models::AgentListParams::Active] When set to true, lists only agents with active or awaiting threads.
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param fleet_id [String] Fleet to list agents from. Defaults to the API key's default fleet when omitted.
+      #
+      #   @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 set to true, lists only agents with active or awaiting threads.
+      module Active
+        extend Cerca::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/agent_list_tools_params.rb

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

data/lib/cerca/models/agent_list_tools_response.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#list_tools
+    class AgentListToolsResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute tools
+      #   Unified list of runtime and external tools currently available to the agent.
+      #
+      #   @return [Array<Cerca::Models::DiscoveredTool, Cerca::Models::ToolDescriptor>]
+      required :tools, -> { Cerca::Internal::Type::ArrayOf[union: Cerca::Tool] }
+
+      # @!attribute source_warnings
+      #
+      #   @return [Array<Cerca::Models::SourceWarning>, nil]
+      optional :source_warnings,
+               -> { Cerca::Internal::Type::ArrayOf[Cerca::SourceWarning] },
+               api_name: :sourceWarnings
+
+      # @!method initialize(tools:, source_warnings: nil)
+      #   Response for GET /agents/{agentId}/tools. The tools field is an inspection list,
+      #   not a configuration request field.
+      #
+      #   @param tools [Array<Cerca::Models::DiscoveredTool, Cerca::Models::ToolDescriptor>] Unified list of runtime and external tools currently available to the agent.
+      #
+      #   @param source_warnings [Array<Cerca::Models::SourceWarning>]
+    end
+  end
+end

data/lib/cerca/models/agent_retrieve_config_params.rb

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

data/lib/cerca/models/agent_retrieve_params.rb

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

data/lib/cerca/models/agent_summary.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#list
+    class AgentSummary < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute active_thread_count
+      #
+      #   @return [Float]
+      required :active_thread_count, Float, api_name: :activeThreadCount
+
+      # @!attribute awaiting_thread_count
+      #
+      #   @return [Float]
+      required :awaiting_thread_count, Float, api_name: :awaitingThreadCount
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute default_model
+      #
+      #   @return [String, nil]
+      required :default_model, String, api_name: :defaultModel, nil?: true
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute metadata
+      #   Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+      #   value sizes.
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!attribute org_id
+      #
+      #   @return [String]
+      required :org_id, String, api_name: :orgId
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute user_id
+      #
+      #   @return [String]
+      required :user_id, String, api_name: :userId
+
+      # @!method initialize(id:, active_thread_count:, awaiting_thread_count:, created_at:, default_model:, fleet_id:, metadata:, org_id:, updated_at:, user_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::AgentSummary} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param active_thread_count [Float]
+      #
+      #   @param awaiting_thread_count [Float]
+      #
+      #   @param created_at [String]
+      #
+      #   @param default_model [String, nil]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param metadata [Hash{Symbol=>String}] Arbitrary string metadata stored on an agent. Runtime enforces maximum key and v
+      #
+      #   @param org_id [String]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param user_id [String]
+    end
+  end
+end

data/lib/cerca/models/agent_update_metadata_params.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#update_metadata
+    class AgentUpdateMetadataParams < 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 metadata
+      #   Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+      #   value sizes.
+      #
+      #   @return [Hash{Symbol=>String}]
+      required :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!method initialize(agent_id:, metadata:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::AgentUpdateMetadataParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param metadata [Hash{Symbol=>String}] Arbitrary string metadata stored on an agent. Runtime enforces maximum key and v
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/agent_update_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Agents#update
+    class AgentUpdateParams < 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 configuration
+      #
+      #   @return [Cerca::Models::Configuration]
+      required :configuration, -> { Cerca::Configuration }
+
+      # @!method initialize(agent_id:, configuration:, request_options: {})
+      #   @param agent_id [String]
+      #   @param configuration [Cerca::Models::Configuration]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/api_key_tool_source_auth.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class APIKeyToolSourceAuth < Cerca::Internal::Type::BaseModel
+      # @!attribute connection_id
+      #
+      #   @return [String]
+      required :connection_id, String, api_name: :connectionId
+
+      # @!attribute inject
+      #   Where an API key or OAuth access token should be injected into outgoing
+      #   tool-source requests.
+      #
+      #   @return [Cerca::Models::AuthInjection::HeaderAuthInjection, Cerca::Models::AuthInjection::QueryAuthInjection]
+      required :inject, union: -> { Cerca::AuthInjection }
+
+      # @!attribute kind
+      #
+      #   @return [Symbol, :api_key]
+      required :kind, const: :api_key
+
+      # @!method initialize(connection_id:, inject:, kind: :api_key)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::APIKeyToolSourceAuth} for more details.
+      #
+      #   @param connection_id [String]
+      #
+      #   @param inject [Cerca::Models::AuthInjection::HeaderAuthInjection, Cerca::Models::AuthInjection::QueryAuthInjection] Where an API key or OAuth access token should be injected into outgoing tool-sou
+      #
+      #   @param kind [Symbol, :api_key]
+    end
+  end
+end

data/lib/cerca/models/approval_grant.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#list
+    class ApprovalGrant < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute created_by
+      #
+      #   @return [String, nil]
+      required :created_by, String, api_name: :createdBy, nil?: true
+
+      # @!attribute expires_at
+      #
+      #   @return [String, nil]
+      required :expires_at, String, api_name: :expiresAt, nil?: true
+
+      # @!attribute grant_key
+      #
+      #   @return [String]
+      required :grant_key, String, api_name: :grantKey
+
+      # @!attribute scope
+      #
+      #   @return [Symbol, Cerca::Models::ApprovalGrant::Scope]
+      required :scope, enum: -> { Cerca::ApprovalGrant::Scope }
+
+      # @!method initialize(id:, created_at:, created_by:, expires_at:, grant_key:, scope:)
+      #   @param id [String]
+      #   @param created_at [String]
+      #   @param created_by [String, nil]
+      #   @param expires_at [String, nil]
+      #   @param grant_key [String]
+      #   @param scope [Symbol, Cerca::Models::ApprovalGrant::Scope]
+
+      # @see Cerca::Models::ApprovalGrant#scope
+      module Scope
+        extend Cerca::Internal::Type::Enum
+
+        THREAD = :thread
+        AGENT = :agent
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/approval_grant_delete_for_thread_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#delete_for_thread
+    class ApprovalGrantDeleteForThreadParams < 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 thread_id
+      #
+      #   @return [String]
+      required :thread_id, String
+
+      # @!attribute grant_id
+      #
+      #   @return [String]
+      required :grant_id, String
+
+      # @!method initialize(agent_id:, thread_id:, grant_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param thread_id [String]
+      #   @param grant_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/approval_grant_delete_for_thread_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#delete_for_thread
+    class ApprovalGrantDeleteForThreadResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute ok
+      #
+      #   @return [Boolean, true]
+      required :ok, const: true
+
+      # @!method initialize(ok: true)
+      #   @param ok [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/approval_grant_delete_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#delete
+    class ApprovalGrantDeleteParams < 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 grant_id
+      #
+      #   @return [String]
+      required :grant_id, String
+
+      # @!method initialize(agent_id:, grant_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param grant_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/approval_grant_delete_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#delete
+    class ApprovalGrantDeleteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute ok
+      #
+      #   @return [Boolean, true]
+      required :ok, const: true
+
+      # @!method initialize(ok: true)
+      #   @param ok [Boolean, true]
+    end
+  end
+end