cerca 0.1.0

data/sig/cerca/models/webhook_update_params.rbs

@@ -0,0 +1,54 @@
+module Cerca
+  module Models
+    type webhook_update_params =
+      {
+        fleet_id: String,
+        webhook_id: String,
+        enabled: bool,
+        events: ::Array[Cerca::Models::webhook_subscription_event_type],
+        url: String
+      }
+      & Cerca::Internal::Type::request_parameters
+
+    class WebhookUpdateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor fleet_id: String
+
+      attr_accessor webhook_id: String
+
+      attr_reader enabled: bool?
+
+      def enabled=: (bool) -> bool
+
+      attr_reader events: ::Array[Cerca::Models::webhook_subscription_event_type]?
+
+      def events=: (
+        ::Array[Cerca::Models::webhook_subscription_event_type]
+      ) -> ::Array[Cerca::Models::webhook_subscription_event_type]
+
+      attr_reader url: String?
+
+      def url=: (String) -> String
+
+      def initialize: (
+        fleet_id: String,
+        webhook_id: String,
+        ?enabled: bool,
+        ?events: ::Array[Cerca::Models::webhook_subscription_event_type],
+        ?url: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        fleet_id: String,
+        webhook_id: String,
+        enabled: bool,
+        events: ::Array[Cerca::Models::webhook_subscription_event_type],
+        url: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models.rbs

@@ -0,0 +1,267 @@
+module Cerca
+  class Agent = Cerca::Models::Agent
+
+  class AgentCreateParams = Cerca::Models::AgentCreateParams
+
+  class AgentDeleteParams = Cerca::Models::AgentDeleteParams
+
+  class AgentListParams = Cerca::Models::AgentListParams
+
+  class AgentListToolsParams = Cerca::Models::AgentListToolsParams
+
+  class AgentRetrieveConfigParams = Cerca::Models::AgentRetrieveConfigParams
+
+  class AgentRetrieveParams = Cerca::Models::AgentRetrieveParams
+
+  class AgentSummary = Cerca::Models::AgentSummary
+
+  class AgentUpdateMetadataParams = Cerca::Models::AgentUpdateMetadataParams
+
+  class AgentUpdateParams = Cerca::Models::AgentUpdateParams
+
+  class APIKeyToolSourceAuth = Cerca::Models::APIKeyToolSourceAuth
+
+  class ApprovalGrant = Cerca::Models::ApprovalGrant
+
+  class ApprovalGrantDeleteForThreadParams = Cerca::Models::ApprovalGrantDeleteForThreadParams
+
+  class ApprovalGrantDeleteParams = Cerca::Models::ApprovalGrantDeleteParams
+
+  class ApprovalGrantListForThreadParams = Cerca::Models::ApprovalGrantListForThreadParams
+
+  class ApprovalGrantListParams = Cerca::Models::ApprovalGrantListParams
+
+  module ApprovalMode = Cerca::Models::ApprovalMode
+
+  class ApprovalPolicy = Cerca::Models::ApprovalPolicy
+
+  class ApprovalRequest = Cerca::Models::ApprovalRequest
+
+  class ApprovalRequestListParams = Cerca::Models::ApprovalRequestListParams
+
+  class ApprovalRequestResolveParams = Cerca::Models::ApprovalRequestResolveParams
+
+  class AttachedConnection = Cerca::Models::AttachedConnection
+
+  class AuthContextParams = Cerca::Models::AuthContextParams
+
+  class AuthContextResponse = Cerca::Models::AuthContextResponse
+
+  class AuthFleetsResponse = Cerca::Models::AuthFleetsResponse
+
+  module AuthInjection = Cerca::Models::AuthInjection
+
+  class AuthListFleetsParams = Cerca::Models::AuthListFleetsParams
+
+  class CompiledContext = Cerca::Models::CompiledContext
+
+  class Configuration = Cerca::Models::Configuration
+
+  module ConfigurationFieldName = Cerca::Models::ConfigurationFieldName
+
+  class Connection = Cerca::Models::Connection
+
+  class ConnectionAttachParams = Cerca::Models::ConnectionAttachParams
+
+  class ConnectionCreateParams = Cerca::Models::ConnectionCreateParams
+
+  class ConnectionDeleteParams = Cerca::Models::ConnectionDeleteParams
+
+  class ConnectionDetachParams = Cerca::Models::ConnectionDetachParams
+
+  class ConnectionListForAgentParams = Cerca::Models::ConnectionListForAgentParams
+
+  class ConnectionListParams = Cerca::Models::ConnectionListParams
+
+  module ConnectionOwner = Cerca::Models::ConnectionOwner
+
+  module ContentBlock = Cerca::Models::ContentBlock
+
+  class ContextDeleteParams = Cerca::Models::ContextDeleteParams
+
+  class ContextListParams = Cerca::Models::ContextListParams
+
+  class ContextRetrieveParams = Cerca::Models::ContextRetrieveParams
+
+  class ContextSearchParams = Cerca::Models::ContextSearchParams
+
+  class ContextWriteParams = Cerca::Models::ContextWriteParams
+
+  module CredentialProvider = Cerca::Models::CredentialProvider
+
+  module CredentialType = Cerca::Models::CredentialType
+
+  class DiscoveredTool = Cerca::Models::DiscoveredTool
+
+  class EffectiveConfiguration = Cerca::Models::EffectiveConfiguration
+
+  class Entry = Cerca::Models::Entry
+
+  class EntrySummary = Cerca::Models::EntrySummary
+
+  class ErrorResponse = Cerca::Models::ErrorResponse
+
+  class EventListForAgentParams = Cerca::Models::EventListForAgentParams
+
+  class EventListForFleetParams = Cerca::Models::EventListForFleetParams
+
+  class EventListForThreadParams = Cerca::Models::EventListForThreadParams
+
+  class EventStreamForAgentParams = Cerca::Models::EventStreamForAgentParams
+
+  class EventStreamForFleetParams = Cerca::Models::EventStreamForFleetParams
+
+  class EventStreamForThreadEventsParams = Cerca::Models::EventStreamForThreadEventsParams
+
+  class EventStreamForThreadParams = Cerca::Models::EventStreamForThreadParams
+
+  class ExecResult = Cerca::Models::ExecResult
+
+  module ExecutionPrincipal = Cerca::Models::ExecutionPrincipal
+
+  class Fleet = Cerca::Models::Fleet
+
+  class HTTPEndpoint = Cerca::Models::HTTPEndpoint
+
+  class HTTPToolDefinition = Cerca::Models::HTTPToolDefinition
+
+  class HTTPToolExecutionPolicy = Cerca::Models::HTTPToolExecutionPolicy
+
+  class HTTPToolSource = Cerca::Models::HTTPToolSource
+
+  JsonObject: Cerca::Internal::Type::Converter
+
+  class McpToolExecutionPolicy = Cerca::Models::McpToolExecutionPolicy
+
+  class McpToolSource = Cerca::Models::McpToolSource
+
+  class Message = Cerca::Models::Message
+
+  Metadata: Cerca::Internal::Type::Converter
+
+  class ModelDescriptor = Cerca::Models::ModelDescriptor
+
+  class ModelListParams = Cerca::Models::ModelListParams
+
+  class NoToolSourceAuth = Cerca::Models::NoToolSourceAuth
+
+  class OAuthConnectionToolSourceAuth = Cerca::Models::OAuthConnectionToolSourceAuth
+
+  class OAuthConnectParams = Cerca::Models::OAuthConnectParams
+
+  class OAuthConnectResponse = Cerca::Models::OAuthConnectResponse
+
+  module OAuthExchangeConfig = Cerca::Models::OAuthExchangeConfig
+
+  class OAuthExchangeToolSourceAuth = Cerca::Models::OAuthExchangeToolSourceAuth
+
+  class ReadResponse = Cerca::Models::ReadResponse
+
+  class ResponseNormalizationHint = Cerca::Models::ResponseNormalizationHint
+
+  module RuntimeWebhookEvent = Cerca::Models::RuntimeWebhookEvent
+
+  class SandboxExecParams = Cerca::Models::SandboxExecParams
+
+  class SandboxReadParams = Cerca::Models::SandboxReadParams
+
+  class SandboxWriteParams = Cerca::Models::SandboxWriteParams
+
+  class Schedule = Cerca::Models::Schedule
+
+  class ScheduleCreateParams = Cerca::Models::ScheduleCreateParams
+
+  class ScheduleDeleteParams = Cerca::Models::ScheduleDeleteParams
+
+  class ScheduleListParams = Cerca::Models::ScheduleListParams
+
+  class ScheduleTriggerParams = Cerca::Models::ScheduleTriggerParams
+
+  class ScheduleUpdateParams = Cerca::Models::ScheduleUpdateParams
+
+  class SearchResult = Cerca::Models::SearchResult
+
+  class SourceWarning = Cerca::Models::SourceWarning
+
+  module Status = Cerca::Models::Status
+
+  class SteerResult = Cerca::Models::SteerResult
+
+  class SubscriptionEvent = Cerca::Models::SubscriptionEvent
+
+  class SubThreadSummary = Cerca::Models::SubThreadSummary
+
+  class Thread = Cerca::Models::Thread
+
+  class ThreadCancelParams = Cerca::Models::ThreadCancelParams
+
+  class ThreadCloseParams = Cerca::Models::ThreadCloseParams
+
+  class ThreadCompactParams = Cerca::Models::ThreadCompactParams
+
+  class ThreadCreateParams = Cerca::Models::ThreadCreateParams
+
+  class ThreadListParams = Cerca::Models::ThreadListParams
+
+  class ThreadRetrieveParams = Cerca::Models::ThreadRetrieveParams
+
+  class ThreadStartTurnParams = Cerca::Models::ThreadStartTurnParams
+
+  class ThreadSteerParams = Cerca::Models::ThreadSteerParams
+
+  module ThreadStreamEvent = Cerca::Models::ThreadStreamEvent
+
+  class ThreadSummary = Cerca::Models::ThreadSummary
+
+  class TokenUsage = Cerca::Models::TokenUsage
+
+  module Tool = Cerca::Models::Tool
+
+  module ToolApprovalMode = Cerca::Models::ToolApprovalMode
+
+  ToolConnectionMetadata: Cerca::Internal::Type::Converter
+
+  class ToolCreateParams = Cerca::Models::ToolCreateParams
+
+  class ToolDeleteParams = Cerca::Models::ToolDeleteParams
+
+  class ToolDescriptor = Cerca::Models::ToolDescriptor
+
+  class ToolListParams = Cerca::Models::ToolListParams
+
+  module ToolName = Cerca::Models::ToolName
+
+  class ToolRetrieveParams = Cerca::Models::ToolRetrieveParams
+
+  module ToolSource = Cerca::Models::ToolSource
+
+  module ToolSourceAuth = Cerca::Models::ToolSourceAuth
+
+  class ToolSpec = Cerca::Models::ToolSpec
+
+  class ToolUpdateParams = Cerca::Models::ToolUpdateParams
+
+  class Turn = Cerca::Models::Turn
+
+  class WebhookCreateParams = Cerca::Models::WebhookCreateParams
+
+  class WebhookDeleteParams = Cerca::Models::WebhookDeleteParams
+
+  module WebhookEventType = Cerca::Models::WebhookEventType
+
+  class WebhookListParams = Cerca::Models::WebhookListParams
+
+  class WebhookRetrieveParams = Cerca::Models::WebhookRetrieveParams
+
+  class WebhookRotateParams = Cerca::Models::WebhookRotateParams
+
+  class WebhookSubscription = Cerca::Models::WebhookSubscription
+
+  class WebhookSubscriptionCreated = Cerca::Models::WebhookSubscriptionCreated
+
+  module WebhookSubscriptionEventType = Cerca::Models::WebhookSubscriptionEventType
+
+  class WebhookTestParams = Cerca::Models::WebhookTestParams
+
+  class WebhookUpdateParams = Cerca::Models::WebhookUpdateParams
+end

data/sig/cerca/request_options.rbs

@@ -0,0 +1,34 @@
+module Cerca
+  type request_opts =
+    Cerca::RequestOptions | Cerca::request_options | ::Hash[Symbol, top]
+
+  type request_options =
+    {
+      idempotency_key: String?,
+      extra_query: ::Hash[String, (::Array[String] | String)?]?,
+      extra_headers: ::Hash[String, String?]?,
+      extra_body: top?,
+      max_retries: Integer?,
+      timeout: Float?
+    }
+
+  class RequestOptions < Cerca::Internal::Type::BaseModel
+    def self.validate!: (Cerca::request_opts opts) -> void
+
+    attr_accessor idempotency_key: String?
+
+    attr_accessor extra_query: ::Hash[String, (::Array[String] | String)?]?
+
+    attr_accessor extra_headers: ::Hash[String, String?]?
+
+    attr_accessor extra_body: top?
+
+    attr_accessor max_retries: Integer?
+
+    attr_accessor timeout: Float?
+
+    def initialize: (
+      ?Cerca::request_options | ::Hash[Symbol, top] values
+    ) -> void
+  end
+end

data/sig/cerca/resources/agents.rbs

@@ -0,0 +1,55 @@
+module Cerca
+  module Resources
+    class Agents
+      def create: (
+        ?configuration: Cerca::Configuration,
+        ?fleet_id: String,
+        ?metadata: Cerca::Models::metadata,
+        ?user_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Agent
+
+      def retrieve: (
+        String agent_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Agent
+
+      def update: (
+        String agent_id,
+        configuration: Cerca::Configuration,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Agent
+
+      def list: (
+        ?active: Cerca::Models::AgentListParams::active,
+        ?cursor: String,
+        ?fleet_id: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::AgentsCursorPage[Cerca::AgentSummary]
+
+      def delete: (
+        String agent_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::AgentDeleteResponse
+
+      def list_tools: (
+        String agent_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::AgentListToolsResponse
+
+      def retrieve_config: (
+        String agent_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::EffectiveConfiguration
+
+      def update_metadata: (
+        String agent_id,
+        metadata: Cerca::Models::metadata,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Agent
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/approval_grants.rbs

@@ -0,0 +1,33 @@
+module Cerca
+  module Resources
+    class ApprovalGrants
+      def list: (
+        String agent_id,
+        ?cursor: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::GrantsCursorPage[Cerca::ApprovalGrant]
+
+      def delete: (
+        String agent_id,
+        String grant_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ApprovalGrantDeleteResponse
+
+      def delete_for_thread: (
+        String agent_id,
+        String thread_id,
+        String grant_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ApprovalGrantDeleteForThreadResponse
+
+      def list_for_thread: (
+        String agent_id,
+        String thread_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::approval_grant_list_for_thread_response
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/approval_requests.rbs

@@ -0,0 +1,24 @@
+module Cerca
+  module Resources
+    class ApprovalRequests
+      def list: (
+        String agent_id,
+        ?cursor: String,
+        ?limit: String,
+        ?thread_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::ApprovalRequestsCursorPage[Cerca::ApprovalRequest]
+
+      def resolve: (
+        String agent_id,
+        String thread_id,
+        String approval_id,
+        decision: Cerca::Models::ApprovalRequestResolveParams::decision,
+        ?grant: Cerca::Models::ApprovalRequestResolveParams::grant,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::ApprovalRequest
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/auth.rbs

@@ -0,0 +1,17 @@
+module Cerca
+  module Resources
+    class Auth
+      def context: (
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::AuthContextResponse
+
+      def list_fleets: (
+        ?cursor: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::FleetsCursorPage[Cerca::Fleet]
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/connections.rbs

@@ -0,0 +1,48 @@
+module Cerca
+  module Resources
+    class Connections
+      def create: (
+        api_key: String,
+        owner: Cerca::Models::connection_owner,
+        provider: String,
+        ?account_label: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Connection
+
+      def list: (
+        owner_type: Cerca::Models::ConnectionListParams::owner_type,
+        ?cursor: String,
+        ?fleet_id: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::ConnectionsCursorPage[Cerca::Connection]
+
+      def delete: (
+        String connection_id,
+        owner_type: Cerca::Models::ConnectionDeleteParams::owner_type,
+        ?fleet_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ConnectionDeleteResponse
+
+      def attach: (
+        String agent_id,
+        connection_id: String,
+        ?metadata: Cerca::Models::tool_connection_metadata,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::AttachedConnection
+
+      def detach: (
+        String agent_id,
+        String connection_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ConnectionDetachResponse
+
+      def list_for_agent: (
+        String agent_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ConnectionListForAgentResponse
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/context.rbs

@@ -0,0 +1,45 @@
+module Cerca
+  module Resources
+    class Context
+      def retrieve: (
+        String agent_id,
+        key: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Entry
+
+      def list: (
+        String agent_id,
+        ?cursor: String,
+        ?limit: String,
+        ?prefix: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::EntriesCursorPage[Cerca::EntrySummary]
+
+      def delete: (
+        String agent_id,
+        key: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ContextDeleteResponse
+
+      def search: (
+        String agent_id,
+        q: String,
+        ?cursor: String,
+        ?limit: String,
+        ?prefix: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::ResultsCursorPage[Cerca::SearchResult]
+
+      def write: (
+        String agent_id,
+        content: String,
+        key: String,
+        ?expected_version: Float,
+        ?mime_type: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Entry
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/events.rbs

@@ -0,0 +1,69 @@
+module Cerca
+  module Resources
+    class Events
+      def list_for_agent: (
+        String agent_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventListForAgentParams::history,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent]
+
+      def list_for_fleet: (
+        String fleet_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventListForFleetParams::history,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent]
+
+      def list_for_thread: (
+        String agent_id,
+        String thread_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventListForThreadParams::history,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent]
+
+      def stream_for_agent_streaming: (
+        String agent_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventStreamForAgentParams::history,
+        ?last_event_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::Stream[Cerca::SubscriptionEvent]
+
+      def stream_for_fleet_streaming: (
+        String fleet_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventStreamForFleetParams::history,
+        ?last_event_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::Stream[Cerca::SubscriptionEvent]
+
+      def stream_for_thread_streaming: (
+        String agent_id,
+        String thread_id,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::Stream[Cerca::Models::thread_stream_event]
+
+      def stream_for_thread_events_streaming: (
+        String agent_id,
+        String thread_id,
+        ?cursor: String,
+        ?events: String,
+        ?history: Cerca::Models::EventStreamForThreadEventsParams::history,
+        ?last_event_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::Stream[Cerca::SubscriptionEvent]
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/fleets.rbs

@@ -0,0 +1,7 @@
+module Cerca
+  module Resources
+    class Fleets
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/models.rbs

@@ -0,0 +1,11 @@
+module Cerca
+  module Resources
+    class Models
+      def list: (
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Models::ModelListResponse
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end

data/sig/cerca/resources/oauth.rbs

@@ -0,0 +1,15 @@
+module Cerca
+  module Resources
+    class OAuth
+      def connect: (
+        String provider,
+        owner: Cerca::Models::connection_owner,
+        return_origin: String,
+        ?scopes: ::Array[String],
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::OAuthConnectResponse
+
+      def initialize: (client: Cerca::Client) -> void
+    end
+  end
+end