cerca 0.1.0

data/lib/cerca/models/webhook_update_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#update
+    class WebhookUpdateParams < 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 webhook_id
+      #
+      #   @return [String]
+      required :webhook_id, String
+
+      # @!attribute enabled
+      #   Whether deliveries are enabled for this subscription.
+      #
+      #   @return [Boolean, nil]
+      optional :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute events
+      #   Event names to deliver. Omit to subscribe to all non-test events.
+      #
+      #   @return [Array<Symbol, Cerca::Models::WebhookSubscriptionEventType>, nil]
+      optional :events, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::WebhookSubscriptionEventType] }
+
+      # @!attribute url
+      #   HTTPS endpoint that will receive webhook deliveries.
+      #
+      #   @return [String, nil]
+      optional :url, String
+
+      # @!method initialize(fleet_id:, webhook_id:, enabled: nil, events: nil, url: nil, request_options: {})
+      #   @param fleet_id [String]
+      #
+      #   @param webhook_id [String]
+      #
+      #   @param enabled [Boolean] Whether deliveries are enabled for this subscription.
+      #
+      #   @param events [Array<Symbol, Cerca::Models::WebhookSubscriptionEventType>] Event names to deliver. Omit to subscribe to all non-test events.
+      #
+      #   @param url [String] HTTPS endpoint that will receive webhook deliveries.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models.rb

@@ -0,0 +1,310 @@
+# frozen_string_literal: true
+
+module Cerca
+  [Cerca::Internal::Type::BaseModel, *Cerca::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Cerca::Internal::AnyHash) } }
+  end
+
+  Cerca::Internal::Util.walk_namespaces(Cerca::Models).each do |mod|
+    case mod
+    in Cerca::Internal::Type::Enum | Cerca::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Cerca::Internal::Util.walk_namespaces(Cerca::Models)
+                       .lazy
+                       .grep(Cerca::Internal::Type::Union)
+                       .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  Agent = Cerca::Models::Agent
+
+  AgentCreateParams = Cerca::Models::AgentCreateParams
+
+  AgentDeleteParams = Cerca::Models::AgentDeleteParams
+
+  AgentListParams = Cerca::Models::AgentListParams
+
+  AgentListToolsParams = Cerca::Models::AgentListToolsParams
+
+  AgentRetrieveConfigParams = Cerca::Models::AgentRetrieveConfigParams
+
+  AgentRetrieveParams = Cerca::Models::AgentRetrieveParams
+
+  AgentSummary = Cerca::Models::AgentSummary
+
+  AgentUpdateMetadataParams = Cerca::Models::AgentUpdateMetadataParams
+
+  AgentUpdateParams = Cerca::Models::AgentUpdateParams
+
+  APIKeyToolSourceAuth = Cerca::Models::APIKeyToolSourceAuth
+
+  ApprovalGrant = Cerca::Models::ApprovalGrant
+
+  ApprovalGrantDeleteForThreadParams = Cerca::Models::ApprovalGrantDeleteForThreadParams
+
+  ApprovalGrantDeleteParams = Cerca::Models::ApprovalGrantDeleteParams
+
+  ApprovalGrantListForThreadParams = Cerca::Models::ApprovalGrantListForThreadParams
+
+  ApprovalGrantListParams = Cerca::Models::ApprovalGrantListParams
+
+  ApprovalMode = Cerca::Models::ApprovalMode
+
+  ApprovalPolicy = Cerca::Models::ApprovalPolicy
+
+  ApprovalRequest = Cerca::Models::ApprovalRequest
+
+  ApprovalRequestListParams = Cerca::Models::ApprovalRequestListParams
+
+  ApprovalRequestResolveParams = Cerca::Models::ApprovalRequestResolveParams
+
+  AttachedConnection = Cerca::Models::AttachedConnection
+
+  AuthContextParams = Cerca::Models::AuthContextParams
+
+  AuthContextResponse = Cerca::Models::AuthContextResponse
+
+  AuthFleetsResponse = Cerca::Models::AuthFleetsResponse
+
+  AuthInjection = Cerca::Models::AuthInjection
+
+  AuthListFleetsParams = Cerca::Models::AuthListFleetsParams
+
+  CompiledContext = Cerca::Models::CompiledContext
+
+  Configuration = Cerca::Models::Configuration
+
+  ConfigurationFieldName = Cerca::Models::ConfigurationFieldName
+
+  Connection = Cerca::Models::Connection
+
+  ConnectionAttachParams = Cerca::Models::ConnectionAttachParams
+
+  ConnectionCreateParams = Cerca::Models::ConnectionCreateParams
+
+  ConnectionDeleteParams = Cerca::Models::ConnectionDeleteParams
+
+  ConnectionDetachParams = Cerca::Models::ConnectionDetachParams
+
+  ConnectionListForAgentParams = Cerca::Models::ConnectionListForAgentParams
+
+  ConnectionListParams = Cerca::Models::ConnectionListParams
+
+  ConnectionOwner = Cerca::Models::ConnectionOwner
+
+  ContentBlock = Cerca::Models::ContentBlock
+
+  ContextDeleteParams = Cerca::Models::ContextDeleteParams
+
+  ContextListParams = Cerca::Models::ContextListParams
+
+  ContextRetrieveParams = Cerca::Models::ContextRetrieveParams
+
+  ContextSearchParams = Cerca::Models::ContextSearchParams
+
+  ContextWriteParams = Cerca::Models::ContextWriteParams
+
+  CredentialProvider = Cerca::Models::CredentialProvider
+
+  CredentialType = Cerca::Models::CredentialType
+
+  DiscoveredTool = Cerca::Models::DiscoveredTool
+
+  EffectiveConfiguration = Cerca::Models::EffectiveConfiguration
+
+  Entry = Cerca::Models::Entry
+
+  EntrySummary = Cerca::Models::EntrySummary
+
+  ErrorResponse = Cerca::Models::ErrorResponse
+
+  EventListForAgentParams = Cerca::Models::EventListForAgentParams
+
+  EventListForFleetParams = Cerca::Models::EventListForFleetParams
+
+  EventListForThreadParams = Cerca::Models::EventListForThreadParams
+
+  EventStreamForAgentParams = Cerca::Models::EventStreamForAgentParams
+
+  EventStreamForFleetParams = Cerca::Models::EventStreamForFleetParams
+
+  EventStreamForThreadEventsParams = Cerca::Models::EventStreamForThreadEventsParams
+
+  EventStreamForThreadParams = Cerca::Models::EventStreamForThreadParams
+
+  ExecResult = Cerca::Models::ExecResult
+
+  ExecutionPrincipal = Cerca::Models::ExecutionPrincipal
+
+  Fleet = Cerca::Models::Fleet
+
+  HTTPEndpoint = Cerca::Models::HTTPEndpoint
+
+  HTTPToolDefinition = Cerca::Models::HTTPToolDefinition
+
+  HTTPToolExecutionPolicy = Cerca::Models::HTTPToolExecutionPolicy
+
+  HTTPToolSource = Cerca::Models::HTTPToolSource
+
+  # @type [Cerca::Internal::Type::Converter]
+  JsonObject = Cerca::Models::JsonObject
+
+  McpToolExecutionPolicy = Cerca::Models::McpToolExecutionPolicy
+
+  McpToolSource = Cerca::Models::McpToolSource
+
+  Message = Cerca::Models::Message
+
+  # @type [Cerca::Internal::Type::Converter]
+  Metadata = Cerca::Models::Metadata
+
+  ModelDescriptor = Cerca::Models::ModelDescriptor
+
+  ModelListParams = Cerca::Models::ModelListParams
+
+  NoToolSourceAuth = Cerca::Models::NoToolSourceAuth
+
+  OAuthConnectionToolSourceAuth = Cerca::Models::OAuthConnectionToolSourceAuth
+
+  OAuthConnectParams = Cerca::Models::OAuthConnectParams
+
+  OAuthConnectResponse = Cerca::Models::OAuthConnectResponse
+
+  OAuthExchangeConfig = Cerca::Models::OAuthExchangeConfig
+
+  OAuthExchangeToolSourceAuth = Cerca::Models::OAuthExchangeToolSourceAuth
+
+  ReadResponse = Cerca::Models::ReadResponse
+
+  ResponseNormalizationHint = Cerca::Models::ResponseNormalizationHint
+
+  RuntimeWebhookEvent = Cerca::Models::RuntimeWebhookEvent
+
+  SandboxExecParams = Cerca::Models::SandboxExecParams
+
+  SandboxReadParams = Cerca::Models::SandboxReadParams
+
+  SandboxWriteParams = Cerca::Models::SandboxWriteParams
+
+  Schedule = Cerca::Models::Schedule
+
+  ScheduleCreateParams = Cerca::Models::ScheduleCreateParams
+
+  ScheduleDeleteParams = Cerca::Models::ScheduleDeleteParams
+
+  ScheduleListParams = Cerca::Models::ScheduleListParams
+
+  ScheduleTriggerParams = Cerca::Models::ScheduleTriggerParams
+
+  ScheduleUpdateParams = Cerca::Models::ScheduleUpdateParams
+
+  SearchResult = Cerca::Models::SearchResult
+
+  SourceWarning = Cerca::Models::SourceWarning
+
+  Status = Cerca::Models::Status
+
+  SteerResult = Cerca::Models::SteerResult
+
+  SubscriptionEvent = Cerca::Models::SubscriptionEvent
+
+  SubThreadSummary = Cerca::Models::SubThreadSummary
+
+  Thread = Cerca::Models::Thread
+
+  ThreadCancelParams = Cerca::Models::ThreadCancelParams
+
+  ThreadCloseParams = Cerca::Models::ThreadCloseParams
+
+  ThreadCompactParams = Cerca::Models::ThreadCompactParams
+
+  ThreadCreateParams = Cerca::Models::ThreadCreateParams
+
+  ThreadListParams = Cerca::Models::ThreadListParams
+
+  ThreadRetrieveParams = Cerca::Models::ThreadRetrieveParams
+
+  ThreadStartTurnParams = Cerca::Models::ThreadStartTurnParams
+
+  ThreadSteerParams = Cerca::Models::ThreadSteerParams
+
+  ThreadStreamEvent = Cerca::Models::ThreadStreamEvent
+
+  ThreadSummary = Cerca::Models::ThreadSummary
+
+  TokenUsage = Cerca::Models::TokenUsage
+
+  Tool = Cerca::Models::Tool
+
+  ToolApprovalMode = Cerca::Models::ToolApprovalMode
+
+  # @type [Cerca::Internal::Type::Converter]
+  ToolConnectionMetadata = Cerca::Models::ToolConnectionMetadata
+
+  ToolCreateParams = Cerca::Models::ToolCreateParams
+
+  ToolDeleteParams = Cerca::Models::ToolDeleteParams
+
+  ToolDescriptor = Cerca::Models::ToolDescriptor
+
+  ToolListParams = Cerca::Models::ToolListParams
+
+  ToolName = Cerca::Models::ToolName
+
+  ToolRetrieveParams = Cerca::Models::ToolRetrieveParams
+
+  ToolSource = Cerca::Models::ToolSource
+
+  ToolSourceAuth = Cerca::Models::ToolSourceAuth
+
+  ToolSpec = Cerca::Models::ToolSpec
+
+  ToolUpdateParams = Cerca::Models::ToolUpdateParams
+
+  Turn = Cerca::Models::Turn
+
+  WebhookCreateParams = Cerca::Models::WebhookCreateParams
+
+  WebhookDeleteParams = Cerca::Models::WebhookDeleteParams
+
+  WebhookEventType = Cerca::Models::WebhookEventType
+
+  WebhookListParams = Cerca::Models::WebhookListParams
+
+  WebhookRetrieveParams = Cerca::Models::WebhookRetrieveParams
+
+  WebhookRotateParams = Cerca::Models::WebhookRotateParams
+
+  WebhookSubscription = Cerca::Models::WebhookSubscription
+
+  WebhookSubscriptionCreated = Cerca::Models::WebhookSubscriptionCreated
+
+  WebhookSubscriptionEventType = Cerca::Models::WebhookSubscriptionEventType
+
+  WebhookTestParams = Cerca::Models::WebhookTestParams
+
+  WebhookUpdateParams = Cerca::Models::WebhookUpdateParams
+end

data/lib/cerca/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Cerca
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Cerca::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Cerca::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Cerca::Internal::Type::HashOf[Cerca::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Cerca::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Cerca::Internal::Type::HashOf[Cerca::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Cerca::RequestOptions, Cerca::Internal::AnyHash) }
+    end
+  end
+end

data/lib/cerca/resources/agents.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Agents
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::AgentCreateParams} for more details.
+      #
+      # Create agent
+      #
+      # @overload create(configuration: nil, fleet_id: nil, metadata: nil, user_id: nil, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Cerca::Models::Agent]
+      #
+      # @see Cerca::Models::AgentCreateParams
+      def create(params = {})
+        parsed, options = Cerca::AgentCreateParams.dump_request(params)
+        @client.request(method: :post, path: "agents", body: parsed, model: Cerca::Agent, options: options)
+      end
+
+      # Retrieve agent
+      #
+      # @overload retrieve(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Agent]
+      #
+      # @see Cerca::Models::AgentRetrieveParams
+      def retrieve(agent_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s", agent_id],
+          model: Cerca::Agent,
+          options: params[:request_options]
+        )
+      end
+
+      # Update agent
+      #
+      # @overload update(agent_id, configuration:, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param configuration [Cerca::Models::Configuration]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Agent]
+      #
+      # @see Cerca::Models::AgentUpdateParams
+      def update(agent_id, params)
+        parsed, options = Cerca::AgentUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["agents/%1$s", agent_id],
+          body: parsed,
+          model: Cerca::Agent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::AgentListParams} for more details.
+      #
+      # List agents
+      #
+      # @overload list(active: nil, cursor: nil, fleet_id: nil, limit: nil, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Cerca::Internal::AgentsCursorPage<Cerca::Models::AgentSummary>]
+      #
+      # @see Cerca::Models::AgentListParams
+      def list(params = {})
+        parsed, options = Cerca::AgentListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "agents",
+          query: query.transform_keys(fleet_id: "fleetId"),
+          page: Cerca::Internal::AgentsCursorPage,
+          model: Cerca::AgentSummary,
+          options: options
+        )
+      end
+
+      # Delete agent
+      #
+      # @overload delete(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::AgentDeleteResponse]
+      #
+      # @see Cerca::Models::AgentDeleteParams
+      def delete(agent_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s", agent_id],
+          model: Cerca::Models::AgentDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List tools
+      #
+      # @overload list_tools(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::AgentListToolsResponse]
+      #
+      # @see Cerca::Models::AgentListToolsParams
+      def list_tools(agent_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/tools", agent_id],
+          model: Cerca::Models::AgentListToolsResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Retrieve config
+      #
+      # @overload retrieve_config(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::EffectiveConfiguration]
+      #
+      # @see Cerca::Models::AgentRetrieveConfigParams
+      def retrieve_config(agent_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/config", agent_id],
+          model: Cerca::EffectiveConfiguration,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::AgentUpdateMetadataParams} for more details.
+      #
+      # Update metadata
+      #
+      # @overload update_metadata(agent_id, metadata:, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Cerca::Models::Agent]
+      #
+      # @see Cerca::Models::AgentUpdateMetadataParams
+      def update_metadata(agent_id, params)
+        parsed, options = Cerca::AgentUpdateMetadataParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["agents/%1$s/metadata", agent_id],
+          body: parsed,
+          model: Cerca::Agent,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end