cerca 0.1.0

data/rbi/cerca/models.rbi

@@ -0,0 +1,277 @@
+# typed: strong
+
+module Cerca
+  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
+
+  JsonObject =
+    T.let(Cerca::Models::JsonObject, Cerca::Internal::Type::Converter)
+
+  McpToolExecutionPolicy = Cerca::Models::McpToolExecutionPolicy
+
+  McpToolSource = Cerca::Models::McpToolSource
+
+  Message = Cerca::Models::Message
+
+  Metadata = T.let(Cerca::Models::Metadata, Cerca::Internal::Type::Converter)
+
+  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
+
+  ToolConnectionMetadata =
+    T.let(
+      Cerca::Models::ToolConnectionMetadata,
+      Cerca::Internal::Type::Converter
+    )
+
+  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/rbi/cerca/request_options.rbi

@@ -0,0 +1,55 @@
+# typed: strong
+
+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
+    OrHash =
+      T.type_alias { T.any(Cerca::RequestOptions, Cerca::Internal::AnyHash) }
+
+    # @api private
+    sig { params(opts: Cerca::RequestOptions::OrHash).void }
+    def self.validate!(opts)
+    end
+
+    # Idempotency key to send with request and all associated retries. Will only be
+    # sent for write requests.
+    sig { returns(T.nilable(String)) }
+    attr_accessor :idempotency_key
+
+    # Extra query params to send with the request. These are `.merge`’d into any
+    # `query` given at the client level.
+    sig do
+      returns(
+        T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))])
+      )
+    end
+    attr_accessor :extra_query
+
+    # Extra headers to send with the request. These are `.merged`’d into any
+    # `extra_headers` given at the client level.
+    sig { returns(T.nilable(T::Hash[String, T.nilable(String)])) }
+    attr_accessor :extra_headers
+
+    # Extra data to send with the request. These are deep merged into any data
+    # generated as part of the normal request.
+    sig { returns(T.nilable(T.anything)) }
+    attr_accessor :extra_body
+
+    # Maximum number of retries to attempt after a failed initial request.
+    sig { returns(T.nilable(Integer)) }
+    attr_accessor :max_retries
+
+    # Request timeout in seconds.
+    sig { returns(T.nilable(Float)) }
+    attr_accessor :timeout
+
+    # Returns a new instance of RequestOptions.
+    sig { params(values: Cerca::Internal::AnyHash).returns(T.attached_class) }
+    def self.new(values = {})
+    end
+  end
+end

data/rbi/cerca/resources/agents.rbi

@@ -0,0 +1,125 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Agents
+      # Create agent
+      sig do
+        params(
+          configuration: Cerca::Configuration::OrHash,
+          fleet_id: String,
+          metadata: T::Hash[Symbol, String],
+          user_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Agent)
+      end
+      def create(
+        configuration: nil,
+        fleet_id: nil,
+        # Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+        # value sizes.
+        metadata: nil,
+        user_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve agent
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Agent)
+      end
+      def retrieve(agent_id, request_options: {})
+      end
+
+      # Update agent
+      sig do
+        params(
+          agent_id: String,
+          configuration: Cerca::Configuration::OrHash,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Agent)
+      end
+      def update(agent_id, configuration:, request_options: {})
+      end
+
+      # List agents
+      sig do
+        params(
+          active: Cerca::AgentListParams::Active::OrSymbol,
+          cursor: String,
+          fleet_id: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::AgentsCursorPage[Cerca::AgentSummary])
+      end
+      def list(
+        # When set to true, lists only agents with active or awaiting threads.
+        active: nil,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Fleet to list agents from. Defaults to the API key's default fleet when omitted.
+        fleet_id: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete agent
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::AgentDeleteResponse)
+      end
+      def delete(agent_id, request_options: {})
+      end
+
+      # List tools
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::AgentListToolsResponse)
+      end
+      def list_tools(agent_id, request_options: {})
+      end
+
+      # Retrieve config
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::EffectiveConfiguration)
+      end
+      def retrieve_config(agent_id, request_options: {})
+      end
+
+      # Update metadata
+      sig do
+        params(
+          agent_id: String,
+          metadata: T::Hash[Symbol, String],
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Agent)
+      end
+      def update_metadata(
+        agent_id,
+        # Arbitrary string metadata stored on an agent. Runtime enforces maximum key and
+        # value sizes.
+        metadata:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cerca/resources/approval_grants.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class ApprovalGrants
+      # List approval grants
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::GrantsCursorPage[Cerca::ApprovalGrant])
+      end
+      def list(
+        agent_id,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete approval grant
+      sig do
+        params(
+          agent_id: String,
+          grant_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ApprovalGrantDeleteResponse)
+      end
+      def delete(agent_id, grant_id, request_options: {})
+      end
+
+      # Delete approval grant
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          grant_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ApprovalGrantDeleteForThreadResponse)
+      end
+      def delete_for_thread(agent_id, thread_id, grant_id, request_options: {})
+      end
+
+      # List approval grants
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T::Array[Cerca::ApprovalGrant])
+      end
+      def list_for_thread(agent_id, thread_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cerca/resources/approval_requests.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class ApprovalRequests
+      # List approvals
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          limit: String,
+          thread_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(
+          Cerca::Internal::ApprovalRequestsCursorPage[Cerca::ApprovalRequest]
+        )
+      end
+      def list(
+        agent_id,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        # Optional thread id filter.
+        thread_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Create approval
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          approval_id: String,
+          decision: Cerca::ApprovalRequestResolveParams::Decision::OrSymbol,
+          grant: Cerca::ApprovalRequestResolveParams::Grant::OrSymbol,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::ApprovalRequest)
+      end
+      def resolve(
+        agent_id,
+        thread_id,
+        approval_id,
+        decision:,
+        grant: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cerca/resources/auth.rbi

@@ -0,0 +1,39 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Auth
+      # Retrieve context
+      sig do
+        params(request_options: Cerca::RequestOptions::OrHash).returns(
+          Cerca::AuthContextResponse
+        )
+      end
+      def context(request_options: {})
+      end
+
+      # List fleets
+      sig do
+        params(
+          cursor: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::FleetsCursorPage[Cerca::Fleet])
+      end
+      def list_fleets(
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end