cerca 0.1.0 → 0.2.1

data/rbi/cerca/models.rbi

@@ -1,6 +1,10 @@
 # typed: strong
 
 module Cerca
+  ActivityDetail = Cerca::Models::ActivityDetail
+
+  ActivitySummary = Cerca::Models::ActivitySummary
+
   Agent = Cerca::Models::Agent
 
   AgentCreateParams = Cerca::Models::AgentCreateParams
@@ -143,6 +147,8 @@ module Cerca
 
   Message = Cerca::Models::Message
 
+  MessagePage = Cerca::Models::MessagePage
+
   Metadata = T.let(Cerca::Models::Metadata, Cerca::Internal::Type::Converter)
 
   ModelDescriptor = Cerca::Models::ModelDescriptor
@@ -199,6 +205,8 @@ module Cerca
 
   Thread = Cerca::Models::Thread
 
+  ThreadActivityParams = Cerca::Models::ThreadActivityParams
+
   ThreadCancelParams = Cerca::Models::ThreadCancelParams
 
   ThreadCloseParams = Cerca::Models::ThreadCloseParams
@@ -207,6 +215,8 @@ module Cerca
 
   ThreadCreateParams = Cerca::Models::ThreadCreateParams
 
+  ThreadListMessagesParams = Cerca::Models::ThreadListMessagesParams
+
   ThreadListParams = Cerca::Models::ThreadListParams
 
   ThreadRetrieveParams = Cerca::Models::ThreadRetrieveParams
@@ -219,6 +229,8 @@ module Cerca
 
   ThreadSummary = Cerca::Models::ThreadSummary
 
+  ThreadTurnSummary = Cerca::Models::ThreadTurnSummary
+
   TokenUsage = Cerca::Models::TokenUsage
 
   Tool = Cerca::Models::Tool

data/rbi/cerca/resources/threads.rbi

@@ -46,7 +46,9 @@ module Cerca
         thread_id,
         # When true, includes debug-only compiled context fields.
         debug: nil,
-        # When true, includes message content in the thread detail.
+        # Deprecated compatibility flag. Thread detail includes a bounded recent message
+        # page by default; pass `false` only to opt out when no message pagination params
+        # are present.
         include_messages: nil,
         request_options: {}
       )
@@ -78,6 +80,25 @@ module Cerca
       )
       end
 
+      # Fetch compact current and recent activity for a thread without returning
+      # transcript content or runtime debug state.
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          fleet_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::ActivityDetail)
+      end
+      def activity(
+        agent_id,
+        thread_id,
+        # Optional fleet id for index-backed authorization.
+        fleet_id: nil,
+        request_options: {}
+      )
+      end
+
       # Cancel a running or awaiting thread. The underlying runtime treats repeat
       # cancellation as an idempotent lifecycle operation when possible.
       sig do
@@ -114,6 +135,31 @@ module Cerca
       def compact(agent_id, thread_id, request_options: {})
       end
 
+      # List a bounded page of transcript messages for a thread, newest first. Use the
+      # returned `cursor` to page older messages.
+      sig do
+        params(
+          agent_id: String,
+          thread_id: String,
+          cursor: String,
+          fleet_id: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(Cerca::Internal::ThreadMessagesCursorPage[Cerca::Message])
+      end
+      def list_messages(
+        agent_id,
+        thread_id,
+        # Cursor returned by a previous thread messages response.
+        cursor: nil,
+        # Optional fleet id for index-backed authorization.
+        fleet_id: nil,
+        # Maximum number of messages to include, capped at 500.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
       # Create turn
       sig do
         params(

data/sig/cerca/internal/thread_messages_cursor_page.rbs

@@ -0,0 +1,15 @@
+module Cerca
+  module Internal
+    class ThreadMessagesCursorPage[Elem]
+      include Cerca::Internal::Type::BasePage[Elem]
+
+      attr_accessor messages: ::Array[Elem]?
+
+      attr_accessor cursor: String?
+
+      attr_accessor has_more: bool
+
+      def inspect: -> String
+    end
+  end
+end

data/sig/cerca/models/activity_detail.rbs

@@ -0,0 +1,28 @@
+module Cerca
+  module Models
+    type activity_detail =
+      { error: String?, recent_turns: ::Array[Cerca::ThreadTurnSummary] }
+
+    class ActivityDetail < Cerca::Models::ActivitySummary
+      def error: -> String?
+
+      def error=: (String? _) -> String?
+
+      def recent_turns: -> ::Array[Cerca::ThreadTurnSummary]
+
+      def recent_turns=: (
+        ::Array[Cerca::ThreadTurnSummary] _
+      ) -> ::Array[Cerca::ThreadTurnSummary]
+
+      def initialize: (
+        error: String?,
+        recent_turns: ::Array[Cerca::ThreadTurnSummary]
+      ) -> void
+
+      def to_hash: -> {
+        error: String?,
+        recent_turns: ::Array[Cerca::ThreadTurnSummary]
+      }
+    end
+  end
+end

data/sig/cerca/models/activity_summary.rbs

@@ -0,0 +1,85 @@
+module Cerca
+  module Models
+    type activity_summary =
+      {
+        id: String,
+        completed_at: String?,
+        created_at: String,
+        goal: String,
+        latest_activity: String?,
+        message_count: Float,
+        model: String,
+        next_step: String?,
+        parent_thread_id: String?,
+        result: String?,
+        schedule_id: String?,
+        status: Cerca::Models::status,
+        step_count: Float,
+        updated_at: String
+      }
+
+    class ActivitySummary < Cerca::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor completed_at: String?
+
+      attr_accessor created_at: String
+
+      attr_accessor goal: String
+
+      attr_accessor latest_activity: String?
+
+      attr_accessor message_count: Float
+
+      attr_accessor model: String
+
+      attr_accessor next_step: String?
+
+      attr_accessor parent_thread_id: String?
+
+      attr_accessor result: String?
+
+      attr_accessor schedule_id: String?
+
+      attr_accessor status: Cerca::Models::status
+
+      attr_accessor step_count: Float
+
+      attr_accessor updated_at: String
+
+      def initialize: (
+        id: String,
+        completed_at: String?,
+        created_at: String,
+        goal: String,
+        latest_activity: String?,
+        message_count: Float,
+        model: String,
+        next_step: String?,
+        parent_thread_id: String?,
+        result: String?,
+        schedule_id: String?,
+        status: Cerca::Models::status,
+        step_count: Float,
+        updated_at: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        completed_at: String?,
+        created_at: String,
+        goal: String,
+        latest_activity: String?,
+        message_count: Float,
+        model: String,
+        next_step: String?,
+        parent_thread_id: String?,
+        result: String?,
+        schedule_id: String?,
+        status: Cerca::Models::status,
+        step_count: Float,
+        updated_at: String
+      }
+    end
+  end
+end

data/sig/cerca/models/message_page.rbs

@@ -0,0 +1,26 @@
+module Cerca
+  module Models
+    type message_page =
+      { cursor: String?, has_more: bool, messages: ::Array[Cerca::Message] }
+
+    class MessagePage < Cerca::Internal::Type::BaseModel
+      attr_accessor cursor: String?
+
+      attr_accessor has_more: bool
+
+      attr_accessor messages: ::Array[Cerca::Message]
+
+      def initialize: (
+        cursor: String?,
+        has_more: bool,
+        messages: ::Array[Cerca::Message]
+      ) -> void
+
+      def to_hash: -> {
+        cursor: String?,
+        has_more: bool,
+        messages: ::Array[Cerca::Message]
+      }
+    end
+  end
+end

data/sig/cerca/models/thread.rbs

@@ -9,9 +9,11 @@ module Cerca
         created_at: String,
         depth: Float,
         error: String?,
+        has_more_messages: bool,
         instructions: String?,
         last_turn_status: Cerca::Models::Thread::last_turn_status?,
         message: String,
+        message_cursor: Float?,
         messages: ::Array[Cerca::Message],
         model: String,
         parent_thread_id: String?,
@@ -41,12 +43,16 @@ module Cerca
 
       attr_accessor error: String?
 
+      attr_accessor has_more_messages: bool
+
       attr_accessor instructions: String?
 
       attr_accessor last_turn_status: Cerca::Models::Thread::last_turn_status?
 
       attr_accessor message: String
 
+      attr_accessor message_cursor: Float?
+
       attr_accessor messages: ::Array[Cerca::Message]
 
       attr_accessor model: String
@@ -83,9 +89,11 @@ module Cerca
         created_at: String,
         depth: Float,
         error: String?,
+        has_more_messages: bool,
         instructions: String?,
         last_turn_status: Cerca::Models::Thread::last_turn_status?,
         message: String,
+        message_cursor: Float?,
         messages: ::Array[Cerca::Message],
         model: String,
         parent_thread_id: String?,
@@ -108,9 +116,11 @@ module Cerca
         created_at: String,
         depth: Float,
         error: String?,
+        has_more_messages: bool,
         instructions: String?,
         last_turn_status: Cerca::Models::Thread::last_turn_status?,
         message: String,
+        message_cursor: Float?,
         messages: ::Array[Cerca::Message],
         model: String,
         parent_thread_id: String?,

data/sig/cerca/models/thread_activity_params.rbs

@@ -0,0 +1,34 @@
+module Cerca
+  module Models
+    type thread_activity_params =
+      { agent_id: String, thread_id: String, fleet_id: String }
+      & Cerca::Internal::Type::request_parameters
+
+    class ThreadActivityParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor thread_id: String
+
+      attr_reader fleet_id: String?
+
+      def fleet_id=: (String) -> String
+
+      def initialize: (
+        agent_id: String,
+        thread_id: String,
+        ?fleet_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        thread_id: String,
+        fleet_id: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/thread_list_messages_params.rbs

@@ -0,0 +1,52 @@
+module Cerca
+  module Models
+    type thread_list_messages_params =
+      {
+        agent_id: String,
+        thread_id: String,
+        cursor: String,
+        fleet_id: String,
+        limit: String
+      }
+      & Cerca::Internal::Type::request_parameters
+
+    class ThreadListMessagesParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      attr_accessor agent_id: String
+
+      attr_accessor thread_id: String
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader fleet_id: String?
+
+      def fleet_id=: (String) -> String
+
+      attr_reader limit: String?
+
+      def limit=: (String) -> String
+
+      def initialize: (
+        agent_id: String,
+        thread_id: String,
+        ?cursor: String,
+        ?fleet_id: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        agent_id: String,
+        thread_id: String,
+        cursor: String,
+        fleet_id: String,
+        limit: String,
+        request_options: Cerca::RequestOptions
+      }
+    end
+  end
+end

data/sig/cerca/models/thread_turn_summary.rbs

@@ -0,0 +1,56 @@
+module Cerca
+  module Models
+    type thread_turn_summary =
+      {
+        activity: String?,
+        completed_at: String,
+        message_count: Float,
+        next_step: String?,
+        status: Cerca::Models::ThreadTurnSummary::status,
+        turn_seq: Float
+      }
+
+    class ThreadTurnSummary < Cerca::Internal::Type::BaseModel
+      attr_accessor activity: String?
+
+      attr_accessor completed_at: String
+
+      attr_accessor message_count: Float
+
+      attr_accessor next_step: String?
+
+      attr_accessor status: Cerca::Models::ThreadTurnSummary::status
+
+      attr_accessor turn_seq: Float
+
+      def initialize: (
+        activity: String?,
+        completed_at: String,
+        message_count: Float,
+        next_step: String?,
+        status: Cerca::Models::ThreadTurnSummary::status,
+        turn_seq: Float
+      ) -> void
+
+      def to_hash: -> {
+        activity: String?,
+        completed_at: String,
+        message_count: Float,
+        next_step: String?,
+        status: Cerca::Models::ThreadTurnSummary::status,
+        turn_seq: Float
+      }
+
+      type status = :completed | :failed
+
+      module Status
+        extend Cerca::Internal::Type::Enum
+
+        COMPLETED: :completed
+        FAILED: :failed
+
+        def self?.values: -> ::Array[Cerca::Models::ThreadTurnSummary::status]
+      end
+    end
+  end
+end

data/sig/cerca/models.rbs

@@ -1,4 +1,8 @@
 module Cerca
+  class ActivityDetail = Cerca::Models::ActivityDetail
+
+  class ActivitySummary = Cerca::Models::ActivitySummary
+
   class Agent = Cerca::Models::Agent
 
   class AgentCreateParams = Cerca::Models::AgentCreateParams
@@ -137,6 +141,8 @@ module Cerca
 
   class Message = Cerca::Models::Message
 
+  class MessagePage = Cerca::Models::MessagePage
+
   Metadata: Cerca::Internal::Type::Converter
 
   class ModelDescriptor = Cerca::Models::ModelDescriptor
@@ -193,6 +199,8 @@ module Cerca
 
   class Thread = Cerca::Models::Thread
 
+  class ThreadActivityParams = Cerca::Models::ThreadActivityParams
+
   class ThreadCancelParams = Cerca::Models::ThreadCancelParams
 
   class ThreadCloseParams = Cerca::Models::ThreadCloseParams
@@ -201,6 +209,8 @@ module Cerca
 
   class ThreadCreateParams = Cerca::Models::ThreadCreateParams
 
+  class ThreadListMessagesParams = Cerca::Models::ThreadListMessagesParams
+
   class ThreadListParams = Cerca::Models::ThreadListParams
 
   class ThreadRetrieveParams = Cerca::Models::ThreadRetrieveParams
@@ -213,6 +223,8 @@ module Cerca
 
   class ThreadSummary = Cerca::Models::ThreadSummary
 
+  class ThreadTurnSummary = Cerca::Models::ThreadTurnSummary
+
   class TokenUsage = Cerca::Models::TokenUsage
 
   module Tool = Cerca::Models::Tool

data/sig/cerca/resources/threads.rbs

@@ -28,6 +28,13 @@ module Cerca
         ?request_options: Cerca::request_opts
       ) -> Cerca::Internal::ThreadsCursorPage[Cerca::ThreadSummary]
 
+      def activity: (
+        String agent_id,
+        String thread_id,
+        ?fleet_id: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::ActivityDetail
+
       def cancel: (
         String agent_id,
         String thread_id,
@@ -46,6 +53,15 @@ module Cerca
         ?request_options: Cerca::request_opts
       ) -> Cerca::Thread
 
+      def list_messages: (
+        String agent_id,
+        String thread_id,
+        ?cursor: String,
+        ?fleet_id: String,
+        ?limit: String,
+        ?request_options: Cerca::request_opts
+      ) -> Cerca::Internal::ThreadMessagesCursorPage[Cerca::Message]
+
       def start_turn: (
         String agent_id,
         String thread_id,