cerca 0.1.0

data/lib/cerca/models/thread_stream_event.rb

@@ -0,0 +1,888 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Events#stream_for_thread_streaming
+    module ThreadStreamEvent
+      extend Cerca::Internal::Type::Union
+
+      discriminator :type
+
+      variant :status, -> { Cerca::ThreadStreamEvent::ThreadStreamStatusMessage }
+
+      variant :message, -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage }
+
+      variant :progress, -> { Cerca::ThreadStreamEvent::ThreadStreamProgressMessage }
+
+      variant :"turn/started", -> { Cerca::ThreadStreamEvent::ThreadStreamTurnStartedMessage }
+
+      variant :"turn/completed", -> { Cerca::ThreadStreamEvent::ThreadStreamTurnCompletedMessage }
+
+      variant :"item/started", -> { Cerca::ThreadStreamEvent::ThreadStreamItemStartedMessage }
+
+      variant :"item/completed", -> { Cerca::ThreadStreamEvent::ThreadStreamItemCompletedMessage }
+
+      variant :token_usage, -> { Cerca::ThreadStreamEvent::ThreadStreamTokenUsageMessage }
+
+      variant :"approval/requested", -> { Cerca::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage }
+
+      variant :"approval/resolved", -> { Cerca::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage }
+
+      class ThreadStreamStatusMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute error
+        #
+        #   @return [String, nil]
+        required :error, String, nil?: true
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute result
+        #
+        #   @return [String, nil]
+        required :result, String, 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 step_seq
+        #
+        #   @return [Float]
+        required :step_seq, Float, api_name: :stepSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :status]
+        required :type, const: :status
+
+        # @!method initialize(error:, event_seq:, result:, status:, step_seq:, turn_id:, type: :status)
+        #   Some parameter documentations has been truncated, see
+        #   {Cerca::Models::ThreadStreamEvent::ThreadStreamStatusMessage} for more details.
+        #
+        #   @param error [String, nil]
+        #
+        #   @param event_seq [Float]
+        #
+        #   @param result [String, nil]
+        #
+        #   @param status [Symbol, Cerca::Models::Status] `idle` threads can accept a new turn or be closed. `running` threads have an act
+        #
+        #   @param step_seq [Float]
+        #
+        #   @param turn_id [String]
+        #
+        #   @param type [Symbol, :status]
+      end
+
+      class ThreadStreamContentMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute message
+        #
+        #   @return [Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message]
+        required :message, -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message }
+
+        # @!attribute step_seq
+        #
+        #   @return [Float]
+        required :step_seq, Float, api_name: :stepSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :message]
+        required :type, const: :message
+
+        # @!method initialize(event_seq:, message:, step_seq:, turn_id:, type: :message)
+        #   @param event_seq [Float]
+        #   @param message [Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message]
+        #   @param step_seq [Float]
+        #   @param turn_id [String]
+        #   @param type [Symbol, :message]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage#message
+        class Message < Cerca::Internal::Type::BaseModel
+          # @!attribute content
+          #
+          #   @return [Array<Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::Text, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolResult, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ServerToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::WebSearchToolResult>]
+          required :content,
+                   -> { Cerca::Internal::Type::ArrayOf[union: Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content] }
+
+          # @!attribute created_at
+          #
+          #   @return [String]
+          required :created_at, String, api_name: :createdAt
+
+          # @!attribute role
+          #
+          #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Role]
+          required :role, enum: -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Role }
+
+          # @!attribute seq
+          #
+          #   @return [Float]
+          required :seq, Float
+
+          # @!method initialize(content:, created_at:, role:, seq:)
+          #   @param content [Array<Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::Text, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolResult, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ServerToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::WebSearchToolResult>]
+          #   @param created_at [String]
+          #   @param role [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Role]
+          #   @param seq [Float]
+
+          module Content
+            extend Cerca::Internal::Type::Union
+
+            discriminator :type
+
+            variant :text, -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::Text }
+
+            variant :tool_use, -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolUse }
+
+            variant :tool_result,
+                    -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolResult }
+
+            variant :server_tool_use,
+                    -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ServerToolUse }
+
+            variant :web_search_tool_result,
+                    -> { Cerca::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::WebSearchToolResult }
+
+            class Text < Cerca::Internal::Type::BaseModel
+              # @!attribute text
+              #
+              #   @return [String]
+              required :text, String
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :text]
+              required :type, const: :text
+
+              # @!attribute provider_metadata
+              #
+              #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+              optional :provider_metadata,
+                       Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                       api_name: :providerMetadata
+
+              # @!method initialize(text:, provider_metadata: nil, type: :text)
+              #   @param text [String]
+              #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+              #   @param type [Symbol, :text]
+            end
+
+            class ToolUse < Cerca::Internal::Type::BaseModel
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute input
+              #   JSON-serialized tool input payload. Parse as JSON before reading tool-specific
+              #   fields.
+              #
+              #   @return [String]
+              required :input, String
+
+              # @!attribute name
+              #
+              #   @return [Symbol, Cerca::Models::ToolName]
+              required :name, enum: -> { Cerca::ToolName }
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :tool_use]
+              required :type, const: :tool_use
+
+              # @!attribute provider_metadata
+              #
+              #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+              optional :provider_metadata,
+                       Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                       api_name: :providerMetadata
+
+              # @!method initialize(id:, input:, name:, provider_metadata: nil, type: :tool_use)
+              #   Some parameter documentations has been truncated, see
+              #   {Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolUse}
+              #   for more details.
+              #
+              #   @param id [String]
+              #
+              #   @param input [String] JSON-serialized tool input payload. Parse as JSON before reading tool-specific f
+              #
+              #   @param name [Symbol, Cerca::Models::ToolName]
+              #
+              #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+              #
+              #   @param type [Symbol, :tool_use]
+            end
+
+            class ToolResult < Cerca::Internal::Type::BaseModel
+              # @!attribute content
+              #
+              #   @return [String]
+              required :content, String
+
+              # @!attribute is_error
+              #
+              #   @return [Boolean]
+              required :is_error, Cerca::Internal::Type::Boolean, api_name: :isError
+
+              # @!attribute tool_use_id
+              #
+              #   @return [String]
+              required :tool_use_id, String, api_name: :toolUseId
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :tool_result]
+              required :type, const: :tool_result
+
+              # @!attribute denied_by_user
+              #
+              #   @return [Boolean, nil]
+              optional :denied_by_user, Cerca::Internal::Type::Boolean, api_name: :deniedByUser
+
+              # @!attribute provider_metadata
+              #
+              #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+              optional :provider_metadata,
+                       Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                       api_name: :providerMetadata
+
+              # @!method initialize(content:, is_error:, tool_use_id:, denied_by_user: nil, provider_metadata: nil, type: :tool_result)
+              #   @param content [String]
+              #   @param is_error [Boolean]
+              #   @param tool_use_id [String]
+              #   @param denied_by_user [Boolean]
+              #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+              #   @param type [Symbol, :tool_result]
+            end
+
+            class ServerToolUse < Cerca::Internal::Type::BaseModel
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute input
+              #   JSON-serialized tool input payload. Parse as JSON before reading tool-specific
+              #   fields.
+              #
+              #   @return [String]
+              required :input, String
+
+              # @!attribute name
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :server_tool_use]
+              required :type, const: :server_tool_use
+
+              # @!attribute provider_metadata
+              #
+              #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+              optional :provider_metadata,
+                       Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                       api_name: :providerMetadata
+
+              # @!method initialize(id:, input:, name:, provider_metadata: nil, type: :server_tool_use)
+              #   Some parameter documentations has been truncated, see
+              #   {Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ServerToolUse}
+              #   for more details.
+              #
+              #   @param id [String]
+              #
+              #   @param input [String] JSON-serialized tool input payload. Parse as JSON before reading tool-specific f
+              #
+              #   @param name [String]
+              #
+              #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+              #
+              #   @param type [Symbol, :server_tool_use]
+            end
+
+            class WebSearchToolResult < Cerca::Internal::Type::BaseModel
+              # @!attribute content
+              #   Web search result payload. The runtime returns either an array of web search
+              #   results or an error object.
+              #
+              #   @return [Object]
+              required :content, Cerca::Internal::Type::Unknown
+
+              # @!attribute tool_use_id
+              #
+              #   @return [String]
+              required :tool_use_id, String, api_name: :toolUseId
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :web_search_tool_result]
+              required :type, const: :web_search_tool_result
+
+              # @!method initialize(content:, tool_use_id:, type: :web_search_tool_result)
+              #   Some parameter documentations has been truncated, see
+              #   {Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::WebSearchToolResult}
+              #   for more details.
+              #
+              #   @param content [Object] Web search result payload. The runtime returns either an array of web search res
+              #
+              #   @param tool_use_id [String]
+              #
+              #   @param type [Symbol, :web_search_tool_result]
+            end
+
+            # @!method self.variants
+            #   @return [Array(Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::Text, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ToolResult, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::ServerToolUse, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message::Content::WebSearchToolResult)]
+          end
+
+          # @see Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage::Message#role
+          module Role
+            extend Cerca::Internal::Type::Enum
+
+            USER = :user
+            ASSISTANT = :assistant
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
+      class ThreadStreamProgressMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute message_count
+        #
+        #   @return [Float]
+        required :message_count, Float, api_name: :messageCount
+
+        # @!attribute step_count
+        #
+        #   @return [Float]
+        required :step_count, Float, api_name: :stepCount
+
+        # @!attribute step_seq
+        #
+        #   @return [Float]
+        required :step_seq, Float, api_name: :stepSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :progress]
+        required :type, const: :progress
+
+        # @!method initialize(event_seq:, message_count:, step_count:, step_seq:, turn_id:, type: :progress)
+        #   @param event_seq [Float]
+        #   @param message_count [Float]
+        #   @param step_count [Float]
+        #   @param step_seq [Float]
+        #   @param turn_id [String]
+        #   @param type [Symbol, :progress]
+      end
+
+      class ThreadStreamTurnStartedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute turn_seq
+        #
+        #   @return [Float]
+        required :turn_seq, Float, api_name: :turnSeq
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"turn/started"]
+        required :type, const: :"turn/started"
+
+        # @!method initialize(event_seq:, turn_id:, turn_seq:, type: :"turn/started")
+        #   @param event_seq [Float]
+        #   @param turn_id [String]
+        #   @param turn_seq [Float]
+        #   @param type [Symbol, :"turn/started"]
+      end
+
+      class ThreadStreamTurnCompletedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute error
+        #
+        #   @return [String, nil]
+        required :error, String, nil?: true
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute result
+        #
+        #   @return [String, nil]
+        required :result, String, nil?: true
+
+        # @!attribute status
+        #
+        #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnCompletedMessage::Status]
+        required :status, enum: -> { Cerca::ThreadStreamEvent::ThreadStreamTurnCompletedMessage::Status }
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute turn_seq
+        #
+        #   @return [Float]
+        required :turn_seq, Float, api_name: :turnSeq
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"turn/completed"]
+        required :type, const: :"turn/completed"
+
+        # @!method initialize(error:, event_seq:, result:, status:, turn_id:, turn_seq:, type: :"turn/completed")
+        #   @param error [String, nil]
+        #   @param event_seq [Float]
+        #   @param result [String, nil]
+        #   @param status [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnCompletedMessage::Status]
+        #   @param turn_id [String]
+        #   @param turn_seq [Float]
+        #   @param type [Symbol, :"turn/completed"]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamTurnCompletedMessage#status
+        module Status
+          extend Cerca::Internal::Type::Enum
+
+          COMPLETED = :completed
+          FAILED = :failed
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class ThreadStreamItemStartedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute item_id
+        #
+        #   @return [String]
+        required :item_id, String, api_name: :itemId
+
+        # @!attribute item_type
+        #
+        #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamItemStartedMessage::ItemType]
+        required :item_type,
+                 enum: -> { Cerca::ThreadStreamEvent::ThreadStreamItemStartedMessage::ItemType },
+                 api_name: :itemType
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"item/started"]
+        required :type, const: :"item/started"
+
+        # @!attribute requested_tool_name
+        #
+        #   @return [String, nil]
+        optional :requested_tool_name, String, api_name: :requestedToolName
+
+        # @!attribute sub_thread_id
+        #
+        #   @return [String, nil]
+        optional :sub_thread_id, String, api_name: :subThreadId
+
+        # @!attribute tool_name
+        #
+        #   @return [Symbol, Cerca::Models::ToolName, nil]
+        optional :tool_name, enum: -> { Cerca::ToolName }, api_name: :toolName
+
+        # @!method initialize(event_seq:, item_id:, item_type:, turn_id:, requested_tool_name: nil, sub_thread_id: nil, tool_name: nil, type: :"item/started")
+        #   @param event_seq [Float]
+        #   @param item_id [String]
+        #   @param item_type [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamItemStartedMessage::ItemType]
+        #   @param turn_id [String]
+        #   @param requested_tool_name [String]
+        #   @param sub_thread_id [String]
+        #   @param tool_name [Symbol, Cerca::Models::ToolName]
+        #   @param type [Symbol, :"item/started"]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamItemStartedMessage#item_type
+        module ItemType
+          extend Cerca::Internal::Type::Enum
+
+          TOOL_CALL = :tool_call
+          AGENT_MESSAGE = :agent_message
+          LLM_CALL = :llm_call
+          SUB_THREAD = :sub_thread
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class ThreadStreamItemCompletedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute duration_ms
+        #
+        #   @return [Float]
+        required :duration_ms, Float, api_name: :durationMs
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute item_id
+        #
+        #   @return [String]
+        required :item_id, String, api_name: :itemId
+
+        # @!attribute item_type
+        #
+        #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamItemCompletedMessage::ItemType]
+        required :item_type,
+                 enum: -> { Cerca::ThreadStreamEvent::ThreadStreamItemCompletedMessage::ItemType },
+                 api_name: :itemType
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"item/completed"]
+        required :type, const: :"item/completed"
+
+        # @!attribute is_error
+        #
+        #   @return [Boolean, nil]
+        optional :is_error, Cerca::Internal::Type::Boolean, api_name: :isError
+
+        # @!attribute requested_tool_name
+        #
+        #   @return [String, nil]
+        optional :requested_tool_name, String, api_name: :requestedToolName
+
+        # @!method initialize(duration_ms:, event_seq:, item_id:, item_type:, turn_id:, is_error: nil, requested_tool_name: nil, type: :"item/completed")
+        #   @param duration_ms [Float]
+        #   @param event_seq [Float]
+        #   @param item_id [String]
+        #   @param item_type [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamItemCompletedMessage::ItemType]
+        #   @param turn_id [String]
+        #   @param is_error [Boolean]
+        #   @param requested_tool_name [String]
+        #   @param type [Symbol, :"item/completed"]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamItemCompletedMessage#item_type
+        module ItemType
+          extend Cerca::Internal::Type::Enum
+
+          TOOL_CALL = :tool_call
+          AGENT_MESSAGE = :agent_message
+          LLM_CALL = :llm_call
+          SUB_THREAD = :sub_thread
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class ThreadStreamTokenUsageMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute cumulative_input_tokens
+        #
+        #   @return [Float]
+        required :cumulative_input_tokens, Float, api_name: :cumulativeInputTokens
+
+        # @!attribute cumulative_output_tokens
+        #
+        #   @return [Float]
+        required :cumulative_output_tokens, Float, api_name: :cumulativeOutputTokens
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute input_tokens
+        #
+        #   @return [Float]
+        required :input_tokens, Float, api_name: :inputTokens
+
+        # @!attribute output_tokens
+        #
+        #   @return [Float]
+        required :output_tokens, Float, api_name: :outputTokens
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :token_usage]
+        required :type, const: :token_usage
+
+        # @!method initialize(cumulative_input_tokens:, cumulative_output_tokens:, event_seq:, input_tokens:, output_tokens:, turn_id:, type: :token_usage)
+        #   @param cumulative_input_tokens [Float]
+        #   @param cumulative_output_tokens [Float]
+        #   @param event_seq [Float]
+        #   @param input_tokens [Float]
+        #   @param output_tokens [Float]
+        #   @param turn_id [String]
+        #   @param type [Symbol, :token_usage]
+      end
+
+      class ThreadStreamApprovalRequestedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute approval
+        #
+        #   @return [Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval]
+        required :approval, -> { Cerca::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval }
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"approval/requested"]
+        required :type, const: :"approval/requested"
+
+        # @!method initialize(approval:, event_seq:, turn_id:, type: :"approval/requested")
+        #   @param approval [Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval]
+        #   @param event_seq [Float]
+        #   @param turn_id [String]
+        #   @param type [Symbol, :"approval/requested"]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage#approval
+        class Approval < Cerca::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute created_at
+          #
+          #   @return [String]
+          required :created_at, String, api_name: :createdAt
+
+          # @!attribute requested_tool_name
+          #
+          #   @return [String]
+          required :requested_tool_name, String, api_name: :requestedToolName
+
+          # @!attribute resolved_at
+          #
+          #   @return [String, nil]
+          required :resolved_at, String, api_name: :resolvedAt, nil?: true
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval::Status]
+          required :status,
+                   enum: -> { Cerca::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval::Status }
+
+          # @!attribute thread_id
+          #
+          #   @return [String]
+          required :thread_id, String, api_name: :threadId
+
+          # @!attribute timeout_at
+          #
+          #   @return [String, nil]
+          required :timeout_at, String, api_name: :timeoutAt, nil?: true
+
+          # @!attribute timeout_ms
+          #
+          #   @return [Float, nil]
+          required :timeout_ms, Float, api_name: :timeoutMs, nil?: true
+
+          # @!attribute tool_index
+          #
+          #   @return [Float]
+          required :tool_index, Float, api_name: :toolIndex
+
+          # @!attribute tool_input
+          #   JSON-serialized tool input payload. Parse as JSON before reading tool-specific
+          #   fields.
+          #
+          #   @return [String]
+          required :tool_input, String, api_name: :toolInput
+
+          # @!attribute tool_name
+          #
+          #   @return [Symbol, Cerca::Models::ToolName]
+          required :tool_name, enum: -> { Cerca::ToolName }, api_name: :toolName
+
+          # @!attribute tool_use_id
+          #
+          #   @return [String]
+          required :tool_use_id, String, api_name: :toolUseId
+
+          # @!attribute turn_id
+          #
+          #   @return [String]
+          required :turn_id, String, api_name: :turnId
+
+          # @!attribute tool_source_id
+          #
+          #   @return [String, nil]
+          optional :tool_source_id, String, api_name: :toolSourceId
+
+          # @!attribute tool_source_version
+          #
+          #   @return [Float, nil]
+          optional :tool_source_version, Float, api_name: :toolSourceVersion
+
+          # @!method initialize(id:, created_at:, requested_tool_name:, resolved_at:, status:, thread_id:, timeout_at:, timeout_ms:, tool_index:, tool_input:, tool_name:, tool_use_id:, turn_id:, tool_source_id: nil, tool_source_version: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval}
+          #   for more details.
+          #
+          #   @param id [String]
+          #
+          #   @param created_at [String]
+          #
+          #   @param requested_tool_name [String]
+          #
+          #   @param resolved_at [String, nil]
+          #
+          #   @param status [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval::Status]
+          #
+          #   @param thread_id [String]
+          #
+          #   @param timeout_at [String, nil]
+          #
+          #   @param timeout_ms [Float, nil]
+          #
+          #   @param tool_index [Float]
+          #
+          #   @param tool_input [String] JSON-serialized tool input payload. Parse as JSON before reading tool-specific f
+          #
+          #   @param tool_name [Symbol, Cerca::Models::ToolName]
+          #
+          #   @param tool_use_id [String]
+          #
+          #   @param turn_id [String]
+          #
+          #   @param tool_source_id [String]
+          #
+          #   @param tool_source_version [Float]
+
+          # @see Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage::Approval#status
+          module Status
+            extend Cerca::Internal::Type::Enum
+
+            PENDING = :pending
+            APPROVED = :approved
+            DENIED = :denied
+            CANCELLED = :cancelled
+            TIMED_OUT = :timed_out
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+
+      class ThreadStreamApprovalResolvedMessage < Cerca::Internal::Type::BaseModel
+        # @!attribute approval_id
+        #
+        #   @return [String]
+        required :approval_id, String, api_name: :approvalId
+
+        # @!attribute decision
+        #
+        #   @return [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage::Decision]
+        required :decision, enum: -> { Cerca::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage::Decision }
+
+        # @!attribute event_seq
+        #
+        #   @return [Float]
+        required :event_seq, Float, api_name: :eventSeq
+
+        # @!attribute turn_id
+        #
+        #   @return [String]
+        required :turn_id, String, api_name: :turnId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :"approval/resolved"]
+        required :type, const: :"approval/resolved"
+
+        # @!method initialize(approval_id:, decision:, event_seq:, turn_id:, type: :"approval/resolved")
+        #   @param approval_id [String]
+        #   @param decision [Symbol, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage::Decision]
+        #   @param event_seq [Float]
+        #   @param turn_id [String]
+        #   @param type [Symbol, :"approval/resolved"]
+
+        # @see Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage#decision
+        module Decision
+          extend Cerca::Internal::Type::Enum
+
+          APPROVE = :approve
+          DENY = :deny
+          CANCEL = :cancel
+          TIMEOUT = :timeout
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::ThreadStreamEvent::ThreadStreamStatusMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamProgressMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnStartedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnCompletedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamItemStartedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamItemCompletedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTokenUsageMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage)]
+    end
+  end
+end