cerca 0.1.0

data/lib/cerca/models/event_list_for_thread_params.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#list_for_thread
+    class EventListForThreadParams < 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 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::EventListForThreadParams::History, nil]
+      optional :history, enum: -> { Cerca::EventListForThreadParams::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:, thread_id:, cursor: nil, events: nil, history: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::EventListForThreadParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param thread_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::EventListForThreadParams::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_stream_for_agent_params.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#stream_for_agent_streaming
+    class EventStreamForAgentParams < 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::EventStreamForAgentParams::History, nil]
+      optional :history, enum: -> { Cerca::EventStreamForAgentParams::History }
+
+      # @!attribute last_event_id
+      #   Resume an event-log stream after the last received SSE event id.
+      #
+      #   @return [String, nil]
+      optional :last_event_id, String
+
+      # @!method initialize(agent_id:, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #   @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::EventStreamForAgentParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      #   @param last_event_id [String] Resume an event-log stream after the last received SSE event id.
+      #
+      #   @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_stream_for_fleet_params.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#stream_for_fleet_streaming
+    class EventStreamForFleetParams < 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::EventStreamForFleetParams::History, nil]
+      optional :history, enum: -> { Cerca::EventStreamForFleetParams::History }
+
+      # @!attribute last_event_id
+      #   Resume an event-log stream after the last received SSE event id.
+      #
+      #   @return [String, nil]
+      optional :last_event_id, String
+
+      # @!method initialize(fleet_id:, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #   @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::EventStreamForFleetParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      #   @param last_event_id [String] Resume an event-log stream after the last received SSE event id.
+      #
+      #   @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_stream_for_thread_events_params.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#stream_for_thread_events_streaming
+    class EventStreamForThreadEventsParams < 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 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::EventStreamForThreadEventsParams::History, nil]
+      optional :history, enum: -> { Cerca::EventStreamForThreadEventsParams::History }
+
+      # @!attribute last_event_id
+      #   Resume an event-log stream after the last received SSE event id.
+      #
+      #   @return [String, nil]
+      optional :last_event_id, String
+
+      # @!method initialize(agent_id:, thread_id:, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #   @param agent_id [String]
+      #
+      #   @param thread_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::EventStreamForThreadEventsParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      #   @param last_event_id [String] Resume an event-log stream after the last received SSE event id.
+      #
+      #   @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_stream_for_thread_params.rb

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

data/lib/cerca/models/exec_result.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Sandbox#exec_
+    class ExecResult < Cerca::Internal::Type::BaseModel
+      # @!attribute exit_code
+      #
+      #   @return [Float, nil]
+      required :exit_code, Float, api_name: :exitCode, nil?: true
+
+      # @!attribute handle
+      #
+      #   @return [String]
+      required :handle, String
+
+      # @!attribute state
+      #
+      #   @return [Symbol, Cerca::Models::ExecResult::State]
+      required :state, enum: -> { Cerca::ExecResult::State }
+
+      # @!attribute stderr
+      #
+      #   @return [String]
+      required :stderr, String
+
+      # @!attribute stderr_offset
+      #
+      #   @return [Float]
+      required :stderr_offset, Float, api_name: :stderrOffset
+
+      # @!attribute stdout
+      #
+      #   @return [String]
+      required :stdout, String
+
+      # @!attribute stdout_offset
+      #
+      #   @return [Float]
+      required :stdout_offset, Float, api_name: :stdoutOffset
+
+      # @!method initialize(exit_code:, handle:, state:, stderr:, stderr_offset:, stdout:, stdout_offset:)
+      #   @param exit_code [Float, nil]
+      #   @param handle [String]
+      #   @param state [Symbol, Cerca::Models::ExecResult::State]
+      #   @param stderr [String]
+      #   @param stderr_offset [Float]
+      #   @param stdout [String]
+      #   @param stdout_offset [Float]
+
+      # @see Cerca::Models::ExecResult#state
+      module State
+        extend Cerca::Internal::Type::Enum
+
+        RUNNING = :running
+        EXITED = :exited
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/execution_principal.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module ExecutionPrincipal
+      extend Cerca::Internal::Type::Union
+
+      discriminator :kind
+
+      variant :user, -> { Cerca::ExecutionPrincipal::UserExecutionPrincipal }
+
+      variant :apiKey, -> { Cerca::ExecutionPrincipal::APIKeyExecutionPrincipal }
+
+      class UserExecutionPrincipal < Cerca::Internal::Type::BaseModel
+        # @!attribute kind
+        #
+        #   @return [Symbol, :user]
+        required :kind, const: :user
+
+        # @!attribute user_id
+        #
+        #   @return [String]
+        required :user_id, String, api_name: :userId
+
+        # @!method initialize(user_id:, kind: :user)
+        #   @param user_id [String]
+        #   @param kind [Symbol, :user]
+      end
+
+      class APIKeyExecutionPrincipal < Cerca::Internal::Type::BaseModel
+        # @!attribute fleet_id
+        #
+        #   @return [String, nil]
+        required :fleet_id, String, api_name: :fleetId, nil?: true
+
+        # @!attribute key_id
+        #
+        #   @return [String]
+        required :key_id, String, api_name: :keyId
+
+        # @!attribute kind
+        #
+        #   @return [Symbol, :apiKey]
+        required :kind, const: :apiKey
+
+        # @!method initialize(fleet_id:, key_id:, kind: :apiKey)
+        #   @param fleet_id [String, nil]
+        #   @param key_id [String]
+        #   @param kind [Symbol, :apiKey]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::ExecutionPrincipal::UserExecutionPrincipal, Cerca::Models::ExecutionPrincipal::APIKeyExecutionPrincipal)]
+    end
+  end
+end

data/lib/cerca/models/fleet.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class Fleet < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, 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
+
+      # @!method initialize(id:, created_at:, name:, org_id:, updated_at:)
+      #   @param id [String]
+      #   @param created_at [String]
+      #   @param name [String]
+      #   @param org_id [String]
+      #   @param updated_at [String]
+    end
+  end
+end

data/lib/cerca/models/http_endpoint.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class HTTPEndpoint < Cerca::Internal::Type::BaseModel
+      # @!attribute method_
+      #
+      #   @return [Symbol, Cerca::Models::HTTPEndpoint::Method]
+      required :method_, enum: -> { Cerca::HTTPEndpoint::Method }, api_name: :method
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute body
+      #
+      #   @return [Symbol, Cerca::Models::HTTPEndpoint::Body, nil]
+      optional :body, enum: -> { Cerca::HTTPEndpoint::Body }
+
+      # @!attribute headers
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, Cerca::Internal::Type::HashOf[String]
+
+      # @!attribute path
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :path, Cerca::Internal::Type::HashOf[String]
+
+      # @!attribute query
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :query, Cerca::Internal::Type::HashOf[String]
+
+      # @!method initialize(method_:, url:, body: nil, headers: nil, path: nil, query: nil)
+      #   HTTP endpoint invoked when the tool is called.
+      #
+      #   @param method_ [Symbol, Cerca::Models::HTTPEndpoint::Method]
+      #   @param url [String]
+      #   @param body [Symbol, Cerca::Models::HTTPEndpoint::Body]
+      #   @param headers [Hash{Symbol=>String}]
+      #   @param path [Hash{Symbol=>String}]
+      #   @param query [Hash{Symbol=>String}]
+
+      # @see Cerca::Models::HTTPEndpoint#method_
+      module Method
+        extend Cerca::Internal::Type::Enum
+
+        GET = :GET
+        POST = :POST
+        PUT = :PUT
+        PATCH = :PATCH
+        DELETE = :DELETE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Cerca::Models::HTTPEndpoint#body
+      module Body
+        extend Cerca::Internal::Type::Enum
+
+        JSON_PARAMS = :json_params
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/http_tool_definition.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class HTTPToolDefinition < Cerca::Internal::Type::BaseModel
+      # @!attribute description
+      #
+      #   @return [String]
+      required :description, String
+
+      # @!attribute endpoint
+      #   HTTP endpoint invoked when the tool is called.
+      #
+      #   @return [Cerca::Models::HTTPEndpoint]
+      required :endpoint, -> { Cerca::HTTPEndpoint }
+
+      # @!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 approval
+      #
+      #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+      optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+      # @!attribute execution
+      #   HTTP tool execution retry and timeout policy.
+      #
+      #   @return [Cerca::Models::HTTPToolExecutionPolicy, nil]
+      optional :execution, -> { Cerca::HTTPToolExecutionPolicy }
+
+      # @!attribute response
+      #   How the HTTP response should be normalized for the agent.
+      #
+      #   @return [Cerca::Models::ResponseNormalizationHint, nil]
+      optional :response, -> { Cerca::ResponseNormalizationHint }
+
+      # @!method initialize(description:, endpoint:, input_schema:, name:, approval: nil, execution: nil, response: nil)
+      #   Definition for a single HTTP tool exposed by a tool source.
+      #
+      #   @param description [String]
+      #
+      #   @param endpoint [Cerca::Models::HTTPEndpoint] HTTP endpoint invoked when the tool is called.
+      #
+      #   @param input_schema [Hash{Symbol=>Object}] JSON Schema object describing tool input parameters.
+      #
+      #   @param name [String]
+      #
+      #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+      #
+      #   @param execution [Cerca::Models::HTTPToolExecutionPolicy] HTTP tool execution retry and timeout policy.
+      #
+      #   @param response [Cerca::Models::ResponseNormalizationHint] How the HTTP response should be normalized for the agent.
+    end
+  end
+end

data/lib/cerca/models/http_tool_execution_policy.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class HTTPToolExecutionPolicy < Cerca::Internal::Type::BaseModel
+      # @!attribute idempotency_key_header
+      #
+      #   @return [String, nil]
+      optional :idempotency_key_header, String, api_name: :idempotencyKeyHeader
+
+      # @!attribute max_attempts
+      #
+      #   @return [Float, nil]
+      optional :max_attempts, Float, api_name: :maxAttempts
+
+      # @!attribute retry_mode
+      #
+      #   @return [Symbol, Cerca::Models::HTTPToolExecutionPolicy::RetryMode, nil]
+      optional :retry_mode, enum: -> { Cerca::HTTPToolExecutionPolicy::RetryMode }, api_name: :retryMode
+
+      # @!attribute timeout_ms
+      #
+      #   @return [Float, nil]
+      optional :timeout_ms, Float, api_name: :timeoutMs
+
+      # @!method initialize(idempotency_key_header: nil, max_attempts: nil, retry_mode: nil, timeout_ms: nil)
+      #   HTTP tool execution retry and timeout policy.
+      #
+      #   @param idempotency_key_header [String]
+      #   @param max_attempts [Float]
+      #   @param retry_mode [Symbol, Cerca::Models::HTTPToolExecutionPolicy::RetryMode]
+      #   @param timeout_ms [Float]
+
+      # @see Cerca::Models::HTTPToolExecutionPolicy#retry_mode
+      module RetryMode
+        extend Cerca::Internal::Type::Enum
+
+        DISABLED = :disabled
+        SAFE_ONLY = :safe_only
+        ENABLED = :enabled
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end