claude_agent 0.7.12 → 0.7.14

data/lib/claude_agent/messages/result.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module ClaudeAgent
+  # Result message (final message with usage/cost info) - TypeScript SDK parity
+  #
+  # @example Success result
+  #   msg = ResultMessage.new(
+  #     subtype: "success",
+  #     duration_ms: 1500,
+  #     duration_api_ms: 1200,
+  #     is_error: false,
+  #     num_turns: 3,
+  #     session_id: "session-abc",
+  #     total_cost_usd: 0.05,
+  #     usage: {input_tokens: 100, output_tokens: 50}
+  #   )
+  #
+  # @example Error result
+  #   msg = ResultMessage.new(
+  #     subtype: "error_max_turns",
+  #     errors: ["Maximum turns exceeded"],
+  #     ...
+  #   )
+  #
+  ResultMessage = Data.define(
+    :subtype,
+    :duration_ms,
+    :duration_api_ms,
+    :is_error,
+    :num_turns,
+    :session_id,
+    :uuid,
+    :total_cost_usd,
+    :usage,
+    :result,
+    :structured_output,
+    :errors,             # Array<String> for error subtypes
+    :permission_denials, # Array<SDKPermissionDenial>
+    :model_usage,        # Hash with per-model usage breakdown
+    :stop_reason,        # Why the model stopped generating (TypeScript SDK parity)
+    :fast_mode_state     # Fast mode state (TypeScript SDK v0.2.63 parity)
+  ) do
+    def initialize(
+      subtype:,
+      duration_ms:,
+      duration_api_ms:,
+      is_error:,
+      num_turns:,
+      session_id:,
+      uuid: nil,
+      total_cost_usd: nil,
+      usage: nil,
+      result: nil,
+      structured_output: nil,
+      errors: nil,
+      permission_denials: nil,
+      model_usage: nil,
+      stop_reason: nil,
+      fast_mode_state: nil
+    )
+      super
+    end
+
+    def type
+      :result
+    end
+
+    # Check if this was an error result
+    # @return [Boolean]
+    def error?
+      is_error
+    end
+
+    # Check if this was a successful result
+    # @return [Boolean]
+    def success?
+      !is_error
+    end
+  end
+end

data/lib/claude_agent/messages/streaming.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module ClaudeAgent
+  # Stream event (partial message during streaming)
+  #
+  # @example
+  #   event = StreamEvent.new(
+  #     uuid: "evt-123",
+  #     session_id: "session-abc",
+  #     event: {type: "content_block_delta", delta: {type: "text_delta", text: "Hello"}}
+  #   )
+  #
+  StreamEvent = Data.define(:uuid, :session_id, :event, :parent_tool_use_id) do
+    def initialize(uuid:, session_id:, event:, parent_tool_use_id: nil)
+      super
+    end
+
+    def type
+      :stream_event
+    end
+
+    # Get the event type from the raw event
+    # @return [String, nil]
+    def event_type
+      event[:type]
+    end
+  end
+
+  # Rate limit event (TypeScript SDK v0.2.45 parity)
+  #
+  # Reports rate limit status and utilization information.
+  #
+  # @example
+  #   msg = RateLimitEvent.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     rate_limit_info: {
+  #       status: "allowed_warning",
+  #       resetsAt: 1700000000,
+  #       rateLimitType: "five_hour",
+  #       utilization: 0.85,
+  #       isUsingOverage: false,
+  #       overageStatus: "available"
+  #     }
+  #   )
+  #   msg.status  # => "allowed_warning"
+  #
+  RateLimitEvent = Data.define(:rate_limit_info, :uuid, :session_id) do
+    def initialize(rate_limit_info:, uuid: nil, session_id: nil)
+      super
+    end
+
+    def type
+      :rate_limit_event
+    end
+
+    # Get the rate limit status
+    # @return [String, nil]
+    def status
+      rate_limit_info[:status]
+    end
+  end
+
+  # Prompt suggestion message (TypeScript SDK v0.2.47 parity)
+  #
+  # Contains a suggested prompt for the user.
+  #
+  # @example
+  #   msg = PromptSuggestionMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     suggestion: "Tell me about this project"
+  #   )
+  #
+  PromptSuggestionMessage = Data.define(:uuid, :session_id, :suggestion) do
+    def initialize(uuid: nil, session_id: nil, suggestion:)
+      super
+    end
+
+    def type
+      :prompt_suggestion
+    end
+  end
+end

data/lib/claude_agent/messages/system.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module ClaudeAgent
+  # System message (internal events)
+  #
+  # @example
+  #   msg = SystemMessage.new(subtype: "init", data: {version: "2.0.0"})
+  #
+  SystemMessage = Data.define(:subtype, :data) do
+    def type
+      :system
+    end
+  end
+
+  # Compact boundary message (conversation compaction marker) - TypeScript SDK parity
+  #
+  # Sent when the conversation is compacted to reduce context size.
+  # Contains metadata about the compaction operation.
+  #
+  # @example
+  #   msg = CompactBoundaryMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     compact_metadata: { trigger: "auto", pre_tokens: 50000 }
+  #   )
+  #   msg.trigger     # => "auto"
+  #   msg.pre_tokens  # => 50000
+  #
+  CompactBoundaryMessage = Data.define(:uuid, :session_id, :compact_metadata) do
+    def type
+      :compact_boundary
+    end
+
+    # Get the compaction trigger type
+    # @return [String] "manual" or "auto"
+    def trigger
+      compact_metadata[:trigger]
+    end
+
+    # Get the token count before compaction
+    # @return [Integer, nil]
+    def pre_tokens
+      compact_metadata[:pre_tokens]
+    end
+  end
+
+  # Status message (TypeScript SDK parity)
+  #
+  # Reports session status like 'compacting' during operations.
+  #
+  # @example
+  #   msg = StatusMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     status: "compacting"
+  #   )
+  #
+  StatusMessage = Data.define(:uuid, :session_id, :status, :permission_mode) do
+    def initialize(uuid:, session_id:, status:, permission_mode: nil)
+      super
+    end
+
+    def type
+      :status
+    end
+  end
+end

data/lib/claude_agent/messages/task_lifecycle.rb

@@ -0,0 +1,240 @@
+# frozen_string_literal: true
+
+module ClaudeAgent
+  # Task started message (TypeScript SDK v0.2.45 parity)
+  #
+  # Sent when a new task (subagent) is started.
+  #
+  # @example
+  #   msg = TaskStartedMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     task_id: "task-456",
+  #     tool_use_id: "tool-789",
+  #     description: "Running tests",
+  #     task_type: "bash"
+  #   )
+  #
+  TaskStartedMessage = Data.define(
+    :uuid,
+    :session_id,
+    :task_id,
+    :tool_use_id,
+    :description,
+    :task_type,
+    :prompt
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      task_id:,
+      tool_use_id: nil,
+      description: nil,
+      task_type: nil,
+      prompt: nil
+    )
+      super
+    end
+
+    def type
+      :task_started
+    end
+  end
+
+  # Task progress message (TypeScript SDK v0.2.51 parity)
+  #
+  # Reports progress during background task (subagent) execution.
+  # Contains usage information and description of what the task is doing.
+  #
+  # @example
+  #   msg = TaskProgressMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     task_id: "task-456",
+  #     description: "Searching codebase for patterns",
+  #     usage: { total_tokens: 5000, tool_uses: 3, duration_ms: 2500 }
+  #   )
+  #
+  TaskProgressMessage = Data.define(
+    :uuid, :session_id, :task_id, :tool_use_id,
+    :description, :usage, :last_tool_name, :summary
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      task_id:,
+      description:,
+      usage: nil,
+      tool_use_id: nil,
+      last_tool_name: nil,
+      summary: nil
+    )
+      super
+    end
+
+    def type
+      :task_progress
+    end
+  end
+
+  # Task notification message (TypeScript SDK parity)
+  #
+  # Sent when a background task completes, fails, or is stopped.
+  # Used for tracking async task execution status.
+  #
+  # @example
+  #   msg = TaskNotificationMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     task_id: "task-456",
+  #     status: "completed",
+  #     output_file: "/path/to/output.txt",
+  #     summary: "Task completed successfully"
+  #   )
+  #   msg.completed?  # => true
+  #   msg.failed?     # => false
+  #
+  # Status values:
+  # - "completed" - Task finished successfully
+  # - "failed" - Task encountered an error
+  # - "stopped" - Task was manually stopped
+  #
+  TaskNotificationMessage = Data.define(
+    :uuid,
+    :session_id,
+    :task_id,
+    :status,
+    :output_file,
+    :summary,
+    :tool_use_id,
+    :usage
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      task_id:,
+      status:,
+      output_file:,
+      summary:,
+      tool_use_id: nil,
+      usage: nil
+    )
+      super
+    end
+
+    def type
+      :task_notification
+    end
+
+    # Check if task completed successfully
+    # @return [Boolean]
+    def completed?
+      status == "completed"
+    end
+
+    # Check if task failed
+    # @return [Boolean]
+    def failed?
+      status == "failed"
+    end
+
+    # Check if task was stopped
+    # @return [Boolean]
+    def stopped?
+      status == "stopped"
+    end
+  end
+
+  # Files persisted event (TypeScript SDK v0.2.25 parity)
+  #
+  # Sent when files are persisted to storage during a session.
+  # Contains lists of successfully persisted files and any failures.
+  #
+  # @example
+  #   msg = FilesPersistedEvent.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     files: [{ filename: "test.rb", file_id: "file-456" }],
+  #     failed: [],
+  #     processed_at: "2026-01-30T12:00:00Z"
+  #   )
+  #   msg.files.first[:filename]  # => "test.rb"
+  #
+  FilesPersistedEvent = Data.define(
+    :uuid,
+    :session_id,
+    :files,
+    :failed,
+    :processed_at
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      files: [],
+      failed: [],
+      processed_at: nil
+    )
+      super
+    end
+
+    def type
+      :files_persisted
+    end
+  end
+
+  # Elicitation complete message (TypeScript SDK v0.2.63 parity)
+  #
+  # Sent when an MCP server elicitation request completes.
+  #
+  # @example
+  #   msg = ElicitationCompleteMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     mcp_server_name: "my-server",
+  #     elicitation_id: "elic-456"
+  #   )
+  #
+  ElicitationCompleteMessage = Data.define(:uuid, :session_id, :mcp_server_name, :elicitation_id) do
+    def initialize(uuid: "", session_id: "", mcp_server_name: "", elicitation_id: "")
+      super
+    end
+
+    def type
+      :elicitation_complete
+    end
+  end
+
+  # Auth status message (TypeScript SDK parity)
+  #
+  # Reports authentication status during login flows.
+  #
+  # @example
+  #   msg = AuthStatusMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     is_authenticating: true,
+  #     output: ["Waiting for browser..."]
+  #   )
+  #
+  AuthStatusMessage = Data.define(
+    :uuid,
+    :session_id,
+    :is_authenticating,
+    :output,
+    :error
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      is_authenticating:,
+      output: [],
+      error: nil
+    )
+      super
+    end
+
+    def type
+      :auth_status
+    end
+  end
+end

data/lib/claude_agent/messages/tool_lifecycle.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module ClaudeAgent
+  # Tool progress message (TypeScript SDK parity)
+  #
+  # Reports progress during long-running tool executions.
+  #
+  # @example
+  #   msg = ToolProgressMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     tool_use_id: "tool-456",
+  #     tool_name: "Bash",
+  #     elapsed_time_seconds: 5.2
+  #   )
+  #
+  ToolProgressMessage = Data.define(
+    :uuid,
+    :session_id,
+    :tool_use_id,
+    :tool_name,
+    :parent_tool_use_id,
+    :elapsed_time_seconds,
+    :task_id
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      tool_use_id:,
+      tool_name:,
+      elapsed_time_seconds:,
+      parent_tool_use_id: nil,
+      task_id: nil
+    )
+      super
+    end
+
+    def type
+      :tool_progress
+    end
+  end
+
+  # Tool use summary message (TypeScript SDK parity)
+  #
+  # Contains a summary of tool use for collapsed display.
+  #
+  # @example
+  #   msg = ToolUseSummaryMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     summary: "Read 3 files",
+  #     preceding_tool_use_ids: ["tool-1", "tool-2", "tool-3"]
+  #   )
+  #
+  ToolUseSummaryMessage = Data.define(
+    :uuid,
+    :session_id,
+    :summary,
+    :preceding_tool_use_ids
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      summary:,
+      preceding_tool_use_ids: []
+    )
+      super
+    end
+
+    def type
+      :tool_use_summary
+    end
+  end
+
+  # Local command output message (TypeScript SDK v0.2.63 parity)
+  #
+  # Contains output from a local command execution.
+  #
+  # @example
+  #   msg = LocalCommandOutputMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     content: "command output here"
+  #   )
+  #
+  LocalCommandOutputMessage = Data.define(:uuid, :session_id, :content) do
+    def initialize(uuid: "", session_id: "", content: "")
+      super
+    end
+
+    def type
+      :local_command_output
+    end
+  end
+end