cerca 0.1.0

data/lib/cerca/models/approval_grant_list_for_thread_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#list_for_thread
+    class ApprovalGrantListForThreadParams < 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/approval_grant_list_for_thread_response.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @type [Cerca::Internal::Type::Converter]
+    ApprovalGrantListForThreadResponse = Cerca::Internal::Type::ArrayOf[-> { Cerca::ApprovalGrant }]
+  end
+end

data/lib/cerca/models/approval_grant_list_params.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalGrants#list
+    class ApprovalGrantListParams < 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
+
+      # @!method initialize(agent_id:, cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ApprovalGrantListParams} 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 request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/approval_mode.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module ApprovalMode
+      extend Cerca::Internal::Type::Enum
+
+      ALWAYS = :always
+      NEVER = :never
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/approval_policy.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class ApprovalPolicy < Cerca::Internal::Type::BaseModel
+      # @!attribute timeout_ms
+      #
+      #   @return [Float, nil]
+      optional :timeout_ms, Float, api_name: :timeoutMs
+
+      # @!attribute tools
+      #
+      #   @return [Hash{Symbol=>Symbol, Cerca::Models::ApprovalMode}, nil]
+      optional :tools, -> { Cerca::Internal::Type::HashOf[enum: Cerca::ApprovalMode] }
+
+      # @!method initialize(timeout_ms: nil, tools: nil)
+      #   @param timeout_ms [Float]
+      #   @param tools [Hash{Symbol=>Symbol, Cerca::Models::ApprovalMode}]
+    end
+  end
+end

data/lib/cerca/models/approval_request.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalRequests#list
+    class ApprovalRequest < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute input
+      #   Parsed JSON tool input from the original tool call. Generated SDKs may expose
+      #   this as unknown or Any.
+      #
+      #   @return [Object]
+      required :input, Cerca::Internal::Type::Unknown
+
+      # @!attribute resolved_at
+      #
+      #   @return [String, nil]
+      required :resolved_at, String, api_name: :resolvedAt, nil?: true
+
+      # @!attribute runtime_tool_name
+      #
+      #   @return [Symbol, Cerca::Models::ToolName]
+      required :runtime_tool_name, enum: -> { Cerca::ToolName }, api_name: :runtimeToolName
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Cerca::Models::ApprovalRequest::Status]
+      required :status, enum: -> { Cerca::ApprovalRequest::Status }
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String, api_name: :threadId
+
+      # @!attribute timeout_at
+      #
+      #   @return [String, nil]
+      required :timeout_at, String, api_name: :timeoutAt, nil?: true
+
+      # @!attribute timeout_ms
+      #
+      #   @return [Float, nil]
+      required :timeout_ms, Float, api_name: :timeoutMs, nil?: true
+
+      # @!attribute tool_index
+      #
+      #   @return [Float]
+      required :tool_index, Float, api_name: :toolIndex
+
+      # @!attribute tool_name
+      #
+      #   @return [String]
+      required :tool_name, String, api_name: :toolName
+
+      # @!attribute tool_use_id
+      #
+      #   @return [String]
+      required :tool_use_id, String, api_name: :toolUseId
+
+      # @!attribute turn_id
+      #
+      #   @return [String]
+      required :turn_id, String, api_name: :turnId
+
+      # @!attribute tool_source_id
+      #
+      #   @return [String, nil]
+      optional :tool_source_id, String, api_name: :toolSourceId
+
+      # @!attribute tool_source_version
+      #
+      #   @return [Float, nil]
+      optional :tool_source_version, Float, api_name: :toolSourceVersion
+
+      # @!method initialize(id:, created_at:, input:, resolved_at:, runtime_tool_name:, status:, thread_id:, timeout_at:, timeout_ms:, tool_index:, tool_name:, tool_use_id:, turn_id:, tool_source_id: nil, tool_source_version: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ApprovalRequest} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param created_at [String]
+      #
+      #   @param input [Object] Parsed JSON tool input from the original tool call. Generated SDKs may expose th
+      #
+      #   @param resolved_at [String, nil]
+      #
+      #   @param runtime_tool_name [Symbol, Cerca::Models::ToolName]
+      #
+      #   @param status [Symbol, Cerca::Models::ApprovalRequest::Status]
+      #
+      #   @param thread_id [String]
+      #
+      #   @param timeout_at [String, nil]
+      #
+      #   @param timeout_ms [Float, nil]
+      #
+      #   @param tool_index [Float]
+      #
+      #   @param tool_name [String]
+      #
+      #   @param tool_use_id [String]
+      #
+      #   @param turn_id [String]
+      #
+      #   @param tool_source_id [String]
+      #
+      #   @param tool_source_version [Float]
+
+      # @see Cerca::Models::ApprovalRequest#status
+      module Status
+        extend Cerca::Internal::Type::Enum
+
+        PENDING = :pending
+        APPROVED = :approved
+        DENIED = :denied
+        CANCELLED = :cancelled
+        TIMED_OUT = :timed_out
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/approval_request_list_params.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalRequests#list
+    class ApprovalRequestListParams < 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 thread_id
+      #   Optional thread id filter.
+      #
+      #   @return [String, nil]
+      optional :thread_id, String
+
+      # @!method initialize(agent_id:, cursor: nil, limit: nil, thread_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ApprovalRequestListParams} 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 thread_id [String] Optional thread id filter.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/approval_request_resolve_params.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::ApprovalRequests#resolve
+    class ApprovalRequestResolveParams < 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 approval_id
+      #
+      #   @return [String]
+      required :approval_id, String
+
+      # @!attribute decision
+      #
+      #   @return [Symbol, Cerca::Models::ApprovalRequestResolveParams::Decision]
+      required :decision, enum: -> { Cerca::ApprovalRequestResolveParams::Decision }
+
+      # @!attribute grant
+      #
+      #   @return [Symbol, Cerca::Models::ApprovalRequestResolveParams::Grant, nil]
+      optional :grant, enum: -> { Cerca::ApprovalRequestResolveParams::Grant }
+
+      # @!method initialize(agent_id:, thread_id:, approval_id:, decision:, grant: nil, request_options: {})
+      #   @param agent_id [String]
+      #   @param thread_id [String]
+      #   @param approval_id [String]
+      #   @param decision [Symbol, Cerca::Models::ApprovalRequestResolveParams::Decision]
+      #   @param grant [Symbol, Cerca::Models::ApprovalRequestResolveParams::Grant]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      module Decision
+        extend Cerca::Internal::Type::Enum
+
+        APPROVE = :approve
+        DENY = :deny
+        CANCEL = :cancel
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      module Grant
+        extend Cerca::Internal::Type::Enum
+
+        THREAD = :thread
+        AGENT = :agent
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/attached_connection.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#attach
+    class AttachedConnection < Cerca::Models::Connection
+      # @!attribute attached_at
+      #
+      #   @return [String]
+      required :attached_at, String, api_name: :attachedAt
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!method initialize(attached_at:, metadata: nil)
+      #   @param attached_at [String]
+      #   @param metadata [Hash{Symbol=>String}]
+    end
+  end
+end

data/lib/cerca/models/auth_context_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Auth#context
+    class AuthContextParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/auth_context_response.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Auth#context
+    class AuthContextResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute key_id
+      #
+      #   @return [String]
+      required :key_id, String, api_name: :keyId
+
+      # @!attribute org_id
+      #
+      #   @return [String]
+      required :org_id, String, api_name: :orgId
+
+      # @!method initialize(key_id:, org_id:)
+      #   @param key_id [String]
+      #   @param org_id [String]
+    end
+  end
+end

data/lib/cerca/models/auth_fleets_response.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class AuthFleetsResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute cursor
+      #
+      #   @return [String, nil]
+      required :cursor, String, nil?: true
+
+      # @!attribute fleets
+      #
+      #   @return [Array<Cerca::Models::Fleet>]
+      required :fleets, -> { Cerca::Internal::Type::ArrayOf[Cerca::Fleet] }
+
+      # @!attribute has_more
+      #
+      #   @return [Boolean]
+      required :has_more, Cerca::Internal::Type::Boolean, api_name: :hasMore
+
+      # @!method initialize(cursor:, fleets:, has_more:)
+      #   @param cursor [String, nil]
+      #   @param fleets [Array<Cerca::Models::Fleet>]
+      #   @param has_more [Boolean]
+    end
+  end
+end

data/lib/cerca/models/auth_injection.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # Where an API key or OAuth access token should be injected into outgoing
+    # tool-source requests.
+    module AuthInjection
+      extend Cerca::Internal::Type::Union
+
+      discriminator :location
+
+      variant :header, -> { Cerca::AuthInjection::HeaderAuthInjection }
+
+      variant :query, -> { Cerca::AuthInjection::QueryAuthInjection }
+
+      class HeaderAuthInjection < Cerca::Internal::Type::BaseModel
+        # @!attribute location
+        #
+        #   @return [Symbol, :header]
+        required :location, const: :header
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute value
+        #   Optional value template. For OAuth connection auth, use values such as
+        #   `Bearer ${token}`.
+        #
+        #   @return [String, nil]
+        optional :value, String
+
+        # @!method initialize(name:, value: nil, location: :header)
+        #   Some parameter documentations has been truncated, see
+        #   {Cerca::Models::AuthInjection::HeaderAuthInjection} for more details.
+        #
+        #   @param name [String]
+        #
+        #   @param value [String] Optional value template. For OAuth connection auth, use values such as `Bearer $
+        #
+        #   @param location [Symbol, :header]
+      end
+
+      class QueryAuthInjection < Cerca::Internal::Type::BaseModel
+        # @!attribute location
+        #
+        #   @return [Symbol, :query]
+        required :location, const: :query
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(name:, location: :query)
+        #   @param name [String]
+        #   @param location [Symbol, :query]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::AuthInjection::HeaderAuthInjection, Cerca::Models::AuthInjection::QueryAuthInjection)]
+    end
+  end
+end

data/lib/cerca/models/auth_list_fleets_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Auth#list_fleets
+    class AuthListFleetsParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!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
+
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::AuthListFleetsParams} for more details.
+      #
+      #   @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 request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/compiled_context.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class CompiledContext < Cerca::Internal::Type::BaseModel
+      # @!attribute enabled_tools
+      #
+      #   @return [Array<Symbol, Cerca::Models::ToolName>, nil]
+      required :enabled_tools,
+               -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::ToolName] },
+               api_name: :enabledTools,
+               nil?: true
+
+      # @!attribute system_prompt
+      #
+      #   @return [String, nil]
+      required :system_prompt, String, api_name: :systemPrompt, nil?: true
+
+      # @!attribute turn_id
+      #
+      #   @return [String, nil]
+      required :turn_id, String, api_name: :turnId, nil?: true
+
+      # @!method initialize(enabled_tools:, system_prompt:, turn_id:)
+      #   @param enabled_tools [Array<Symbol, Cerca::Models::ToolName>, nil]
+      #   @param system_prompt [String, nil]
+      #   @param turn_id [String, nil]
+    end
+  end
+end

data/lib/cerca/models/configuration.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class Configuration < Cerca::Internal::Type::BaseModel
+      # @!attribute approvals
+      #
+      #   @return [Cerca::Models::ApprovalPolicy, nil]
+      optional :approvals, -> { Cerca::ApprovalPolicy }
+
+      # @!attribute default_model
+      #
+      #   @return [String, nil]
+      optional :default_model, String, api_name: :defaultModel
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute tools
+      #   Agent tool allowlist. These tools are subject to fleet defaults and locks, and
+      #   thread or turn requests may only narrow the resulting effective tools.
+      #
+      #   @return [Array<String>, nil]
+      optional :tools, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(approvals: nil, default_model: nil, instructions: nil, tools: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::Configuration} for more details.
+      #
+      #   @param approvals [Cerca::Models::ApprovalPolicy]
+      #
+      #   @param default_model [String]
+      #
+      #   @param instructions [String]
+      #
+      #   @param tools [Array<String>] Agent tool allowlist. These tools are subject to fleet defaults and locks, and t
+    end
+  end
+end

data/lib/cerca/models/configuration_field_name.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module ConfigurationFieldName
+      extend Cerca::Internal::Type::Enum
+
+      DEFAULT_MODEL = :defaultModel
+      INSTRUCTIONS = :instructions
+      TOOLS = :tools
+      APPROVALS = :approvals
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end