cerca 0.1.0 → 0.2.0

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,

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cerca
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Cerca
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -37,6 +38,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+description:
 email: support@cerca.dev
 executables: []
 extensions: []
@@ -63,6 +65,7 @@ files:
 - lib/cerca/internal/sources_cursor_page.rb
 - lib/cerca/internal/stream.rb
 - lib/cerca/internal/subscriptions_cursor_page.rb
+- lib/cerca/internal/thread_messages_cursor_page.rb
 - lib/cerca/internal/threads_cursor_page.rb
 - lib/cerca/internal/transport/base_client.rb
 - lib/cerca/internal/transport/pooled_net_requester.rb
@@ -80,6 +83,8 @@ files:
 - lib/cerca/internal/type/unknown.rb
 - lib/cerca/internal/util.rb
 - lib/cerca/models.rb
+- lib/cerca/models/activity_detail.rb
+- lib/cerca/models/activity_summary.rb
 - lib/cerca/models/agent.rb
 - lib/cerca/models/agent_create_params.rb
 - lib/cerca/models/agent_delete_params.rb
@@ -158,6 +163,7 @@ files:
 - lib/cerca/models/mcp_tool_execution_policy.rb
 - lib/cerca/models/mcp_tool_source.rb
 - lib/cerca/models/message.rb
+- lib/cerca/models/message_page.rb
 - lib/cerca/models/metadata.rb
 - lib/cerca/models/model_descriptor.rb
 - lib/cerca/models/model_list_params.rb
@@ -191,16 +197,19 @@ files:
 - lib/cerca/models/sub_thread_summary.rb
 - lib/cerca/models/subscription_event.rb
 - lib/cerca/models/thread.rb
+- lib/cerca/models/thread_activity_params.rb
 - lib/cerca/models/thread_cancel_params.rb
 - lib/cerca/models/thread_close_params.rb
 - lib/cerca/models/thread_compact_params.rb
 - lib/cerca/models/thread_create_params.rb
+- lib/cerca/models/thread_list_messages_params.rb
 - lib/cerca/models/thread_list_params.rb
 - lib/cerca/models/thread_retrieve_params.rb
 - lib/cerca/models/thread_start_turn_params.rb
 - lib/cerca/models/thread_steer_params.rb
 - lib/cerca/models/thread_stream_event.rb
 - lib/cerca/models/thread_summary.rb
+- lib/cerca/models/thread_turn_summary.rb
 - lib/cerca/models/token_usage.rb
 - lib/cerca/models/tool.rb
 - lib/cerca/models/tool_approval_mode.rb
@@ -261,6 +270,7 @@ files:
 - rbi/cerca/internal/sources_cursor_page.rbi
 - rbi/cerca/internal/stream.rbi
 - rbi/cerca/internal/subscriptions_cursor_page.rbi
+- rbi/cerca/internal/thread_messages_cursor_page.rbi
 - rbi/cerca/internal/threads_cursor_page.rbi
 - rbi/cerca/internal/transport/base_client.rbi
 - rbi/cerca/internal/transport/pooled_net_requester.rbi
@@ -278,6 +288,8 @@ files:
 - rbi/cerca/internal/type/unknown.rbi
 - rbi/cerca/internal/util.rbi
 - rbi/cerca/models.rbi
+- rbi/cerca/models/activity_detail.rbi
+- rbi/cerca/models/activity_summary.rbi
 - rbi/cerca/models/agent.rbi
 - rbi/cerca/models/agent_create_params.rbi
 - rbi/cerca/models/agent_delete_params.rbi
@@ -356,6 +368,7 @@ files:
 - rbi/cerca/models/mcp_tool_execution_policy.rbi
 - rbi/cerca/models/mcp_tool_source.rbi
 - rbi/cerca/models/message.rbi
+- rbi/cerca/models/message_page.rbi
 - rbi/cerca/models/metadata.rbi
 - rbi/cerca/models/model_descriptor.rbi
 - rbi/cerca/models/model_list_params.rbi
@@ -389,16 +402,19 @@ files:
 - rbi/cerca/models/sub_thread_summary.rbi
 - rbi/cerca/models/subscription_event.rbi
 - rbi/cerca/models/thread.rbi
+- rbi/cerca/models/thread_activity_params.rbi
 - rbi/cerca/models/thread_cancel_params.rbi
 - rbi/cerca/models/thread_close_params.rbi
 - rbi/cerca/models/thread_compact_params.rbi
 - rbi/cerca/models/thread_create_params.rbi
+- rbi/cerca/models/thread_list_messages_params.rbi
 - rbi/cerca/models/thread_list_params.rbi
 - rbi/cerca/models/thread_retrieve_params.rbi
 - rbi/cerca/models/thread_start_turn_params.rbi
 - rbi/cerca/models/thread_steer_params.rbi
 - rbi/cerca/models/thread_stream_event.rbi
 - rbi/cerca/models/thread_summary.rbi
+- rbi/cerca/models/thread_turn_summary.rbi
 - rbi/cerca/models/token_usage.rbi
 - rbi/cerca/models/tool.rbi
 - rbi/cerca/models/tool_approval_mode.rbi
@@ -458,6 +474,7 @@ files:
 - sig/cerca/internal/sources_cursor_page.rbs
 - sig/cerca/internal/stream.rbs
 - sig/cerca/internal/subscriptions_cursor_page.rbs
+- sig/cerca/internal/thread_messages_cursor_page.rbs
 - sig/cerca/internal/threads_cursor_page.rbs
 - sig/cerca/internal/transport/base_client.rbs
 - sig/cerca/internal/transport/pooled_net_requester.rbs
@@ -475,6 +492,8 @@ files:
 - sig/cerca/internal/type/unknown.rbs
 - sig/cerca/internal/util.rbs
 - sig/cerca/models.rbs
+- sig/cerca/models/activity_detail.rbs
+- sig/cerca/models/activity_summary.rbs
 - sig/cerca/models/agent.rbs
 - sig/cerca/models/agent_create_params.rbs
 - sig/cerca/models/agent_delete_params.rbs
@@ -553,6 +572,7 @@ files:
 - sig/cerca/models/mcp_tool_execution_policy.rbs
 - sig/cerca/models/mcp_tool_source.rbs
 - sig/cerca/models/message.rbs
+- sig/cerca/models/message_page.rbs
 - sig/cerca/models/metadata.rbs
 - sig/cerca/models/model_descriptor.rbs
 - sig/cerca/models/model_list_params.rbs
@@ -586,16 +606,19 @@ files:
 - sig/cerca/models/sub_thread_summary.rbs
 - sig/cerca/models/subscription_event.rbs
 - sig/cerca/models/thread.rbs
+- sig/cerca/models/thread_activity_params.rbs
 - sig/cerca/models/thread_cancel_params.rbs
 - sig/cerca/models/thread_close_params.rbs
 - sig/cerca/models/thread_compact_params.rbs
 - sig/cerca/models/thread_create_params.rbs
+- sig/cerca/models/thread_list_messages_params.rbs
 - sig/cerca/models/thread_list_params.rbs
 - sig/cerca/models/thread_retrieve_params.rbs
 - sig/cerca/models/thread_start_turn_params.rbs
 - sig/cerca/models/thread_steer_params.rbs
 - sig/cerca/models/thread_stream_event.rbs
 - sig/cerca/models/thread_summary.rbs
+- sig/cerca/models/thread_turn_summary.rbs
 - sig/cerca/models/token_usage.rbs
 - sig/cerca/models/tool.rbs
 - sig/cerca/models/tool_approval_mode.rbs
@@ -646,6 +669,7 @@ metadata:
   homepage_uri: https://gemdocs.org/gems/cerca
   source_code_uri: https://github.com/matrices/cerca-ruby
   rubygems_mfa_required: 'false'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -660,7 +684,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 3.4.1
+signing_key:
 specification_version: 4
 summary: Ruby library to access the Cerca API
 test_files: []