cerca 0.1.0

data/rbi/cerca/resources/connections.rbi

@@ -0,0 +1,116 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Connections
+      # Create API key
+      sig do
+        params(
+          api_key: String,
+          owner:
+            T.any(
+              Cerca::ConnectionOwner::OrganizationConnectionOwner::OrHash,
+              Cerca::ConnectionOwner::FleetConnectionOwner::OrHash
+            ),
+          provider: String,
+          account_label: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Connection)
+      end
+      def create(
+        # API key secret. It is stored securely and is not returned.
+        api_key:,
+        # Public owner for a reusable connection. Organization owners use the
+        # authenticated organization; fleet owners add a fleetId.
+        owner:,
+        # Credential provider to store an API key for.
+        provider:,
+        # Optional human-readable account label.
+        account_label: nil,
+        request_options: {}
+      )
+      end
+
+      # List connections
+      sig do
+        params(
+          owner_type: Cerca::ConnectionListParams::OwnerType::OrSymbol,
+          cursor: String,
+          fleet_id: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::ConnectionsCursorPage[Cerca::Connection])
+      end
+      def list(
+        # Public connection owner type.
+        owner_type:,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Required when ownerType is fleet.
+        fleet_id: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete connection
+      sig do
+        params(
+          connection_id: String,
+          owner_type: Cerca::ConnectionDeleteParams::OwnerType::OrSymbol,
+          fleet_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ConnectionDeleteResponse)
+      end
+      def delete(
+        connection_id,
+        # Public connection owner type.
+        owner_type:,
+        # Required when ownerType is fleet.
+        fleet_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Attach connection
+      sig do
+        params(
+          agent_id: String,
+          connection_id: String,
+          metadata: T::Hash[Symbol, String],
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::AttachedConnection)
+      end
+      def attach(agent_id, connection_id:, metadata: nil, request_options: {})
+      end
+
+      # Detach connection
+      sig do
+        params(
+          agent_id: String,
+          connection_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ConnectionDetachResponse)
+      end
+      def detach(agent_id, connection_id, request_options: {})
+      end
+
+      # List connections
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ConnectionListForAgentResponse)
+      end
+      def list_for_agent(agent_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/context.rbi

@@ -0,0 +1,114 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Context
+      # Retrieve context entry
+      sig do
+        params(
+          agent_id: String,
+          key: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Entry)
+      end
+      def retrieve(
+        agent_id,
+        # Context entry key.
+        key:,
+        request_options: {}
+      )
+      end
+
+      # List context entries
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          limit: String,
+          prefix: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::EntriesCursorPage[Cerca::EntrySummary])
+      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 key prefix filter.
+        prefix: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete context entry
+      sig do
+        params(
+          agent_id: String,
+          key: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ContextDeleteResponse)
+      end
+      def delete(
+        agent_id,
+        # Context entry key.
+        key:,
+        request_options: {}
+      )
+      end
+
+      # Search context
+      sig do
+        params(
+          agent_id: String,
+          q: String,
+          cursor: String,
+          limit: String,
+          prefix: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::ResultsCursorPage[Cerca::SearchResult])
+      end
+      def search(
+        agent_id,
+        # Search query.
+        q:,
+        # 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 key prefix filter.
+        prefix: nil,
+        request_options: {}
+      )
+      end
+
+      # Update context entry
+      sig do
+        params(
+          agent_id: String,
+          content: String,
+          key: String,
+          expected_version: Float,
+          mime_type: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Entry)
+      end
+      def write(
+        agent_id,
+        content:,
+        key:,
+        expected_version: nil,
+        mime_type: 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/events.rbi

@@ -0,0 +1,188 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Events
+      # List events
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventListForAgentParams::History::OrSymbol,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent])
+      end
+      def list_for_agent(
+        agent_id,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Comma-separated event type filter.
+        events: nil,
+        # When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # List events
+      sig do
+        params(
+          fleet_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventListForFleetParams::History::OrSymbol,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent])
+      end
+      def list_for_fleet(
+        fleet_id,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Comma-separated event type filter.
+        events: nil,
+        # When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # List events
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventListForThreadParams::History::OrSymbol,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::EventsCursorPage[Cerca::SubscriptionEvent])
+      end
+      def list_for_thread(
+        agent_id,
+        thread_id,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Comma-separated event type filter.
+        events: nil,
+        # When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      sig do
+        params(
+          agent_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventStreamForAgentParams::History::OrSymbol,
+          last_event_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::Stream[Cerca::SubscriptionEvent])
+      end
+      def stream_for_agent_streaming(
+        # Path param
+        agent_id,
+        # Query param: Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Query param: Comma-separated event type filter.
+        events: nil,
+        # Query param: When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Header param: Resume an event-log stream after the last received SSE event id.
+        last_event_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      sig do
+        params(
+          fleet_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventStreamForFleetParams::History::OrSymbol,
+          last_event_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::Stream[Cerca::SubscriptionEvent])
+      end
+      def stream_for_fleet_streaming(
+        # Path param
+        fleet_id,
+        # Query param: Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Query param: Comma-separated event type filter.
+        events: nil,
+        # Query param: When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Header param: Resume an event-log stream after the last received SSE event id.
+        last_event_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::Stream[Cerca::ThreadStreamEvent::Variants])
+      end
+      def stream_for_thread_streaming(agent_id, thread_id, request_options: {})
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          cursor: String,
+          events: String,
+          history: Cerca::EventStreamForThreadEventsParams::History::OrSymbol,
+          last_event_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::Stream[Cerca::SubscriptionEvent])
+      end
+      def stream_for_thread_events_streaming(
+        # Path param
+        agent_id,
+        # Path param
+        thread_id,
+        # Query param: Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Query param: Comma-separated event type filter.
+        events: nil,
+        # Query param: When true, starts from the beginning of the retained buffer.
+        history: nil,
+        # Header param: Resume an event-log stream after the last received SSE event id.
+        last_event_id: 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/fleets.rbi

@@ -0,0 +1,12 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Fleets
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cerca/resources/models.rbi

@@ -0,0 +1,21 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Models
+      # List models
+      sig do
+        params(request_options: Cerca::RequestOptions::OrHash).returns(
+          Cerca::Models::ModelListResponse
+        )
+      end
+      def list(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/oauth.rbi

@@ -0,0 +1,39 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class OAuth
+      # Start OAuth authorization
+      sig do
+        params(
+          provider: String,
+          owner:
+            T.any(
+              Cerca::ConnectionOwner::OrganizationConnectionOwner::OrHash,
+              Cerca::ConnectionOwner::FleetConnectionOwner::OrHash
+            ),
+          return_origin: String,
+          scopes: T::Array[String],
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::OAuthConnectResponse)
+      end
+      def connect(
+        provider,
+        # Public owner for a reusable connection. Organization owners use the
+        # authenticated organization; fleet owners add a fleetId.
+        owner:,
+        # HTTP(S) origin that receives the OAuth completion message.
+        return_origin:,
+        # Provider-specific OAuth scopes. Empty entries are ignored after trimming.
+        scopes: 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/sandbox.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Sandbox
+      # Execute sandbox command
+      sig do
+        params(
+          agent_id: String,
+          command: String,
+          max_buffer: Float,
+          execution_timeout: Float,
+          workdir: T.nilable(String),
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::ExecResult)
+      end
+      def exec_(
+        agent_id,
+        command:,
+        max_buffer: nil,
+        # Timeout in seconds. Runtime converts this to milliseconds.
+        execution_timeout: nil,
+        # Optional sandbox working directory.
+        workdir: nil,
+        request_options: {}
+      )
+      end
+
+      # Read sandbox file
+      sig do
+        params(
+          agent_id: String,
+          path: String,
+          limit: Float,
+          offset: Float,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::ReadResponse)
+      end
+      def read(agent_id, path:, limit: nil, offset: nil, request_options: {})
+      end
+
+      # Write sandbox file
+      sig do
+        params(
+          agent_id: String,
+          content: String,
+          path: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::SandboxWriteResponse)
+      end
+      def write(agent_id, content:, path:, 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/schedules.rbi

@@ -0,0 +1,110 @@
+# typed: strong
+
+module Cerca
+  module Resources
+    class Schedules
+      # Create schedule
+      sig do
+        params(
+          agent_id: String,
+          message: String,
+          name: String,
+          cron: String,
+          instructions: String,
+          model: String,
+          run_at: Time,
+          timezone: String,
+          tools: T::Array[String],
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Schedule)
+      end
+      def create(
+        agent_id,
+        message:,
+        name:,
+        cron: nil,
+        instructions: nil,
+        model: nil,
+        run_at: nil,
+        timezone: nil,
+        # Per-schedule tool subset. When the schedule starts a thread, these tools can
+        # only narrow the agent's effective tools.
+        tools: nil,
+        request_options: {}
+      )
+      end
+
+      # Update schedule
+      sig do
+        params(
+          agent_id: String,
+          schedule_id: String,
+          cron: String,
+          enabled: T::Boolean,
+          instructions: String,
+          message: String,
+          model: String,
+          name: String,
+          run_at: Time,
+          timezone: String,
+          tools: T::Array[String],
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Schedule)
+      end
+      def update(
+        agent_id,
+        schedule_id,
+        cron: nil,
+        enabled: nil,
+        instructions: nil,
+        message: nil,
+        model: nil,
+        name: nil,
+        run_at: nil,
+        timezone: nil,
+        # Per-schedule tool subset. When updated, these tools can only narrow the agent's
+        # effective tools for future scheduled threads.
+        tools: nil,
+        request_options: {}
+      )
+      end
+
+      # List schedules
+      sig do
+        params(
+          agent_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ScheduleListResponse)
+      end
+      def list(agent_id, request_options: {})
+      end
+
+      # Delete schedule
+      sig do
+        params(
+          agent_id: String,
+          schedule_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ScheduleDeleteResponse)
+      end
+      def delete(agent_id, schedule_id, request_options: {})
+      end
+
+      # Trigger schedule
+      sig do
+        params(
+          agent_id: String,
+          schedule_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Models::ScheduleTriggerResponse)
+      end
+      def trigger(agent_id, schedule_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Cerca::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end