cerca 0.1.0

data/lib/cerca/models/steer_result.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#steer
+    class SteerResult < Cerca::Internal::Type::BaseModel
+      # @!attribute status
+      #
+      #   @return [Symbol, Cerca::Models::SteerResult::Status]
+      required :status, enum: -> { Cerca::SteerResult::Status }
+
+      # @!attribute thread_status
+      #   `idle` threads can accept a new turn or be closed. `running` threads have an
+      #   active turn. `awaiting` threads are paused on external input such as approvals.
+      #   `closed` threads are terminal.
+      #
+      #   @return [Symbol, Cerca::Models::Status]
+      required :thread_status, enum: -> { Cerca::Status }, api_name: :threadStatus
+
+      # @!attribute turn_id
+      #
+      #   @return [String]
+      required :turn_id, String, api_name: :turnId
+
+      # @!method initialize(status:, thread_status:, turn_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::SteerResult} for more details.
+      #
+      #   @param status [Symbol, Cerca::Models::SteerResult::Status]
+      #
+      #   @param thread_status [Symbol, Cerca::Models::Status] `idle` threads can accept a new turn or be closed. `running` threads have an act
+      #
+      #   @param turn_id [String]
+
+      # @see Cerca::Models::SteerResult#status
+      module Status
+        extend Cerca::Internal::Type::Enum
+
+        ENQUEUED = :enqueued
+        TURN_STARTED = :turn_started
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/sub_thread_summary.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    class SubThreadSummary < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute completed_at
+      #
+      #   @return [String, nil]
+      required :completed_at, String, api_name: :completedAt, nil?: true
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute message_count
+      #
+      #   @return [Float]
+      required :message_count, Float, api_name: :messageCount
+
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!attribute parent_thread_id
+      #
+      #   @return [String, nil]
+      required :parent_thread_id, String, api_name: :parentThreadId, nil?: true
+
+      # @!attribute result
+      #
+      #   @return [String, nil]
+      required :result, String, nil?: true
+
+      # @!attribute schedule_id
+      #
+      #   @return [String, nil]
+      required :schedule_id, String, api_name: :scheduleId, nil?: true
+
+      # @!attribute schedule_seq
+      #
+      #   @return [Float, nil]
+      required :schedule_seq, Float, api_name: :scheduleSeq, nil?: true
+
+      # @!attribute state
+      #   `pending` means the parent thread is still waiting on this sub-thread. Other
+      #   values are the child thread lifecycle state.
+      #
+      #   @return [Symbol, Cerca::Models::SubThreadSummary::State]
+      required :state, enum: -> { Cerca::SubThreadSummary::State }
+
+      # @!attribute step_count
+      #
+      #   @return [Float]
+      required :step_count, Float, api_name: :stepCount
+
+      # @!attribute tool_use_id
+      #
+      #   @return [String, nil]
+      required :tool_use_id, String, api_name: :toolUseId, nil?: true
+
+      # @!method initialize(id:, completed_at:, created_at:, message_count:, model:, parent_thread_id:, result:, schedule_id:, schedule_seq:, state:, step_count:, tool_use_id:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::SubThreadSummary} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param completed_at [String, nil]
+      #
+      #   @param created_at [String]
+      #
+      #   @param message_count [Float]
+      #
+      #   @param model [String]
+      #
+      #   @param parent_thread_id [String, nil]
+      #
+      #   @param result [String, nil]
+      #
+      #   @param schedule_id [String, nil]
+      #
+      #   @param schedule_seq [Float, nil]
+      #
+      #   @param state [Symbol, Cerca::Models::SubThreadSummary::State] `pending` means the parent thread is still waiting on this sub-thread. Other val
+      #
+      #   @param step_count [Float]
+      #
+      #   @param tool_use_id [String, nil]
+
+      # `pending` means the parent thread is still waiting on this sub-thread. Other
+      # values are the child thread lifecycle state.
+      #
+      # @see Cerca::Models::SubThreadSummary#state
+      module State
+        extend Cerca::Internal::Type::Enum
+
+        PENDING = :pending
+        IDLE = :idle
+        RUNNING = :running
+        AWAITING = :awaiting
+        CLOSED = :closed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/subscription_event.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#list_for_agent
+    class SubscriptionEvent < Cerca::Internal::Type::BaseModel
+      # @!attribute event
+      #
+      #   @return [Cerca::Models::RuntimeWebhookEvent::AgentCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::AgentUpdatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::AgentDeletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadStatusChangedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadCompletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadFailedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnCompletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnFailedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::MessageCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalRequestedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalResolvedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalGrantedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleDeletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleTriggeredWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ConnectionAttachedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ConnectionDetachedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::WebhookTestWebhookEvent]
+      required :event, union: -> { Cerca::RuntimeWebhookEvent }
+
+      # @!attribute seq
+      #
+      #   @return [Float]
+      required :seq, Float
+
+      # @!method initialize(event:, seq:)
+      #   @param event [Cerca::Models::RuntimeWebhookEvent::AgentCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::AgentUpdatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::AgentDeletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadStatusChangedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadCompletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ThreadFailedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnCompletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::TurnFailedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::MessageCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalRequestedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalResolvedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ApprovalGrantedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleCreatedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleDeletedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ScheduleTriggeredWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ConnectionAttachedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::ConnectionDetachedWebhookEvent, Cerca::Models::RuntimeWebhookEvent::WebhookTestWebhookEvent]
+      #   @param seq [Float]
+    end
+  end
+end

data/lib/cerca/models/thread.rb

@@ -0,0 +1,202 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#create
+    class Thread < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String, api_name: :agentId
+
+      # @!attribute compiled_context
+      #
+      #   @return [Cerca::Models::CompiledContext, nil]
+      required :compiled_context, -> { Cerca::CompiledContext }, api_name: :compiledContext, nil?: true
+
+      # @!attribute completed_at
+      #
+      #   @return [String, nil]
+      required :completed_at, String, api_name: :completedAt, nil?: true
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute depth
+      #
+      #   @return [Float]
+      required :depth, Float
+
+      # @!attribute error
+      #
+      #   @return [String, nil]
+      required :error, String, nil?: true
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      required :instructions, String, nil?: true
+
+      # @!attribute last_turn_status
+      #
+      #   @return [Symbol, Cerca::Models::Thread::LastTurnStatus, nil]
+      required :last_turn_status,
+               enum: -> { Cerca::Thread::LastTurnStatus },
+               api_name: :lastTurnStatus,
+               nil?: true
+
+      # @!attribute message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute messages
+      #
+      #   @return [Array<Cerca::Models::Message>]
+      required :messages, -> { Cerca::Internal::Type::ArrayOf[Cerca::Message] }
+
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!attribute parent_thread_id
+      #
+      #   @return [String, nil]
+      required :parent_thread_id, String, api_name: :parentThreadId, nil?: true
+
+      # @!attribute result
+      #
+      #   @return [String, nil]
+      required :result, String, nil?: true
+
+      # @!attribute schedule_id
+      #
+      #   @return [String, nil]
+      required :schedule_id, String, api_name: :scheduleId, nil?: true
+
+      # @!attribute schedule_seq
+      #
+      #   @return [Float, nil]
+      required :schedule_seq, Float, api_name: :scheduleSeq, nil?: true
+
+      # @!attribute status
+      #   `idle` threads can accept a new turn or be closed. `running` threads have an
+      #   active turn. `awaiting` threads are paused on external input such as approvals.
+      #   `closed` threads are terminal.
+      #
+      #   @return [Symbol, Cerca::Models::Status]
+      required :status, enum: -> { Cerca::Status }
+
+      # @!attribute sub_threads
+      #
+      #   @return [Array<Cerca::Models::SubThreadSummary>]
+      required :sub_threads,
+               -> { Cerca::Internal::Type::ArrayOf[Cerca::SubThreadSummary] },
+               api_name: :subThreads
+
+      # @!attribute tools
+      #
+      #   @return [Array<Symbol, Cerca::Models::ToolName>]
+      required :tools, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::ToolName] }
+
+      # @!attribute turns
+      #
+      #   @return [Array<Cerca::Models::Turn>]
+      required :turns, -> { Cerca::Internal::Type::ArrayOf[Cerca::Turn] }
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute external_tool_namespaces
+      #
+      #   @return [Symbol, :all, Array<String>, nil]
+      optional :external_tool_namespaces,
+               union: -> { Cerca::Thread::ExternalToolNamespaces },
+               api_name: :externalToolNamespaces
+
+      # @!method initialize(id:, agent_id:, compiled_context:, completed_at:, created_at:, depth:, error:, instructions:, last_turn_status:, message:, messages:, model:, parent_thread_id:, result:, schedule_id:, schedule_seq:, status:, sub_threads:, tools:, turns:, updated_at:, external_tool_namespaces: nil)
+      #   Some parameter documentations has been truncated, see {Cerca::Models::Thread}
+      #   for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param agent_id [String]
+      #
+      #   @param compiled_context [Cerca::Models::CompiledContext, nil]
+      #
+      #   @param completed_at [String, nil]
+      #
+      #   @param created_at [String]
+      #
+      #   @param depth [Float]
+      #
+      #   @param error [String, nil]
+      #
+      #   @param instructions [String, nil]
+      #
+      #   @param last_turn_status [Symbol, Cerca::Models::Thread::LastTurnStatus, nil]
+      #
+      #   @param message [String]
+      #
+      #   @param messages [Array<Cerca::Models::Message>]
+      #
+      #   @param model [String]
+      #
+      #   @param parent_thread_id [String, nil]
+      #
+      #   @param result [String, nil]
+      #
+      #   @param schedule_id [String, nil]
+      #
+      #   @param schedule_seq [Float, nil]
+      #
+      #   @param status [Symbol, Cerca::Models::Status] `idle` threads can accept a new turn or be closed. `running` threads have an act
+      #
+      #   @param sub_threads [Array<Cerca::Models::SubThreadSummary>]
+      #
+      #   @param tools [Array<Symbol, Cerca::Models::ToolName>]
+      #
+      #   @param turns [Array<Cerca::Models::Turn>]
+      #
+      #   @param updated_at [String]
+      #
+      #   @param external_tool_namespaces [Symbol, :all, Array<String>]
+
+      # @see Cerca::Models::Thread#last_turn_status
+      module LastTurnStatus
+        extend Cerca::Internal::Type::Enum
+
+        COMPLETED = :completed
+        FAILED = :failed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see Cerca::Models::Thread#external_tool_namespaces
+      module ExternalToolNamespaces
+        extend Cerca::Internal::Type::Union
+
+        variant const: :all
+
+        variant -> { Cerca::Models::Thread::ExternalToolNamespaces::StringArray }
+
+        # @!method self.variants
+        #   @return [Array(Symbol, :all, Array<String>)]
+
+        # @type [Cerca::Internal::Type::Converter]
+        StringArray = Cerca::Internal::Type::ArrayOf[String]
+      end
+    end
+  end
+end

data/lib/cerca/models/thread_cancel_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#cancel
+    class ThreadCancelParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String
+
+      # @!method initialize(agent_id:, thread_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param thread_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/thread_close_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#close
+    class ThreadCloseParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String
+
+      # @!method initialize(agent_id:, thread_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param thread_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/thread_compact_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#compact
+    class ThreadCompactParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String
+
+      # @!method initialize(agent_id:, thread_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param thread_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/thread_create_params.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#create
+    class ThreadCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute instructions
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute message
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!attribute model
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute system_prompt
+      #   Deprecated alias for `instructions`; accepted for backwards compatibility.
+      #
+      #   @return [String, nil]
+      optional :system_prompt, String, api_name: :systemPrompt
+
+      # @!attribute tools
+      #   Per-thread tool subset. Omit to inherit the agent's full effective tools; pass
+      #   [] to run with no configurable tools. Provided entries can only narrow the
+      #   agent's effective tools.
+      #
+      #   @return [Array<String>, nil]
+      optional :tools, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(agent_id:, instructions: nil, message: nil, model: nil, system_prompt: nil, tools: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ThreadCreateParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param instructions [String]
+      #
+      #   @param message [String]
+      #
+      #   @param model [String]
+      #
+      #   @param system_prompt [String] Deprecated alias for `instructions`; accepted for backwards compatibility.
+      #
+      #   @param tools [Array<String>] Per-thread tool subset. Omit to inherit the agent's full effective tools; pass [
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/thread_list_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#list
+    class ThreadListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!attribute schedule_id
+      #   Optional schedule id filter.
+      #
+      #   @return [String, nil]
+      optional :schedule_id, String
+
+      # @!attribute status
+      #   Optional thread status filter.
+      #
+      #   @return [Symbol, Cerca::Models::Status, nil]
+      optional :status, enum: -> { Cerca::Status }
+
+      # @!method initialize(agent_id:, cursor: nil, limit: nil, schedule_id: nil, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ThreadListParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param schedule_id [String] Optional schedule id filter.
+      #
+      #   @param status [Symbol, Cerca::Models::Status] Optional thread status filter.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/thread_retrieve_params.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#retrieve
+    class ThreadRetrieveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String
+
+      # @!attribute debug
+      #   When true, includes debug-only compiled context fields.
+      #
+      #   @return [Symbol, Cerca::Models::ThreadRetrieveParams::Debug, nil]
+      optional :debug, enum: -> { Cerca::ThreadRetrieveParams::Debug }
+
+      # @!attribute include_messages
+      #   When true, includes message content in the thread detail.
+      #
+      #   @return [Symbol, Cerca::Models::ThreadRetrieveParams::IncludeMessages, nil]
+      optional :include_messages, enum: -> { Cerca::ThreadRetrieveParams::IncludeMessages }
+
+      # @!method initialize(agent_id:, thread_id:, debug: nil, include_messages: nil, request_options: {})
+      #   @param agent_id [String]
+      #
+      #   @param thread_id [String]
+      #
+      #   @param debug [Symbol, Cerca::Models::ThreadRetrieveParams::Debug] When true, includes debug-only compiled context fields.
+      #
+      #   @param include_messages [Symbol, Cerca::Models::ThreadRetrieveParams::IncludeMessages] When true, includes message content in the thread detail.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      # When true, includes debug-only compiled context fields.
+      module Debug
+        extend Cerca::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # When true, includes message content in the thread detail.
+      module IncludeMessages
+        extend Cerca::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end