claude-agent-sdk 0.16.5 → 0.16.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2fe7bf072c2a3b8448b23bf82c95e7f0a896b347bd43039145458b72e21f301
-  data.tar.gz: 1a58f5e31ef7a872aeaf75a3aada1c8e60a264d9ad5e93615b62c42d96179d99
+  metadata.gz: 5e77eea013fead986f47ff000864ddb9e52a3408186cf09bf3bb8d5214edec28
+  data.tar.gz: 49f94edca00072ec403cb26eb79165979d8684e655336bce6ca53f3c1a31eb81
 SHA512:
-  metadata.gz: e76c6cfe62c7b01320edf7a3d659e44fce46921f764132da7ab0f8223bb1d5a4a2b4457f5406b7bc68a1dde91f7af29fd0d4ff565334ed2cae8ad120339bac83
-  data.tar.gz: 9e1920a7254f5e27dab4ae88cc5ba6d8ac7430a7ec32e8c9157d80c792a65bee8c258096f52ac20ce69d5bedfd1a629a2c8ef852341c9b03e4aaa631c491d912
+  metadata.gz: '08544dd09bb2d8c1127364517e1cc3527aaa0321d8c2d957550f078c5ce1d20796f5622f987ddd9f128377cad697d314a63a31031cd8eeb2e823bbfef282ee17'
+  data.tar.gz: e7149a4d3d9546631449d71878a6480d3d8758c2d990b3836cdc1dde65e93d09a8d19658c781c4f2cf5655bcb3c910dac84bc7d0076f635af4957f78a2e91fe9

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.6] - 2026-04-29
+
+### Added
+- Type classes now accept hash construction with mixed key shapes — symbols or strings, snake_case or camelCase — and support bracket access (`obj[:field]`, `obj['field']`). `UserMessage.new({"sessionId" => "abc"})` works the same as `UserMessage.new(session_id: "abc")`. `Type.from_hash(nil)` and `Type.wrap(nil)` are nil-safe.
+- `ClaudeAgentOptions.new(nil)` is accepted and yields an options object populated with configured defaults.
+
+### Changed
+- Discriminator fields on type classes (`type` on `SystemPromptFile`/`McpStdioServerConfig`/etc., `behavior` on `PermissionResultAllow`/`Deny`, `hook_event_name` on every hook input/output) are now `attr_reader`-only, set authoritatively in `initialize`. They cannot be overwritten externally.
+- `ClaudeAgentOptions` continues to raise `ArgumentError` on unknown keys (constructor, `dup_with`, and `[]=`); other type subclasses silently drop unknown keys for forward-compatibility with newer CLI output.
+
+### Internal
+- Unified ~50 type classes (messages, hook inputs/outputs, MCP configs, system prompt configs, sandbox settings) under a shared `Type` base class. `lib/claude_agent_sdk/types.rb` shrank from 1510 to 588 lines; `MessageParser`'s system-message dispatch went from 215 lines to a 14-entry lookup table.
+
 ## [0.16.5] - 2026-04-24
 
 ### Added

data/README.md

@@ -108,7 +108,7 @@ Add this line to your application's Gemfile:
 gem 'claude-agent-sdk', github: 'ya-luotao/claude-agent-sdk-ruby'
 
 # Or use a stable version from RubyGems
-gem 'claude-agent-sdk', '~> 0.16.5'
+gem 'claude-agent-sdk', '~> 0.16.6'
 ```
 
 And then execute:

data/lib/claude_agent_sdk/message_parser.rb

@@ -78,214 +78,57 @@ module ClaudeAgentSDK
       )
     end
 
+    # Typed SystemMessage subclasses inherit from `Type` and accept the raw
+    # CLI hash directly — camelCase and snake_case keys are normalized by the
+    # base class, and the full hash is captured as `#data`.
+    SYSTEM_MESSAGE_CLASSES = {
+      'init' => InitMessage,
+      'compact_boundary' => CompactBoundaryMessage,
+      'status' => StatusMessage,
+      'api_retry' => APIRetryMessage,
+      'local_command_output' => LocalCommandOutputMessage,
+      'hook_started' => HookStartedMessage,
+      'hook_progress' => HookProgressMessage,
+      'hook_response' => HookResponseMessage,
+      'session_state_changed' => SessionStateChangedMessage,
+      'files_persisted' => FilesPersistedMessage,
+      'elicitation_complete' => ElicitationCompleteMessage,
+      'task_started' => TaskStartedMessage,
+      'task_progress' => TaskProgressMessage,
+      'task_notification' => TaskNotificationMessage
+    }.freeze
+
     def self.parse_system_message(data)
-      case data[:subtype]
-      when 'init'
-        InitMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          agents: data[:agents], api_key_source: data[:apiKeySource] || data[:api_key_source],
-          betas: data[:betas], claude_code_version: data[:claude_code_version],
-          cwd: data[:cwd], tools: data[:tools], mcp_servers: data[:mcp_servers],
-          model: data[:model], permission_mode: data[:permissionMode] || data[:permission_mode],
-          slash_commands: data[:slash_commands], output_style: data[:output_style],
-          skills: data[:skills], plugins: data[:plugins],
-          fast_mode_state: data[:fastModeState] || data[:fast_mode_state]
-        )
-      when 'compact_boundary'
-        raw_metadata = data[:compact_metadata]
-        CompactBoundaryMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          compact_metadata: CompactMetadata.from_hash(raw_metadata)
-        )
-      when 'status'
-        StatusMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          status: data[:status],
-          permission_mode: data[:permissionMode] || data[:permission_mode]
-        )
-      when 'api_retry'
-        APIRetryMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          attempt: data[:attempt], max_retries: data[:maxRetries] || data[:max_retries],
-          retry_delay_ms: data[:retryDelayMs] || data[:retry_delay_ms],
-          error_status: data[:errorStatus] || data[:error_status],
-          error: data[:error]
-        )
-      when 'local_command_output'
-        LocalCommandOutputMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          content: data[:content]
-        )
-      when 'hook_started'
-        HookStartedMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          hook_id: data[:hookId] || data[:hook_id],
-          hook_name: data[:hookName] || data[:hook_name],
-          hook_event: data[:hookEvent] || data[:hook_event]
-        )
-      when 'hook_progress'
-        HookProgressMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          hook_id: data[:hookId] || data[:hook_id],
-          hook_name: data[:hookName] || data[:hook_name],
-          hook_event: data[:hookEvent] || data[:hook_event],
-          stdout: data[:stdout], stderr: data[:stderr], output: data[:output]
-        )
-      when 'hook_response'
-        HookResponseMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          hook_id: data[:hookId] || data[:hook_id],
-          hook_name: data[:hookName] || data[:hook_name],
-          hook_event: data[:hookEvent] || data[:hook_event],
-          output: data[:output], stdout: data[:stdout], stderr: data[:stderr],
-          exit_code: data[:exitCode] || data[:exit_code],
-          outcome: data[:outcome]
-        )
-      when 'session_state_changed'
-        SessionStateChangedMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          state: data[:state]
-        )
-      when 'files_persisted'
-        FilesPersistedMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          files: data[:files], failed: data[:failed],
-          processed_at: data[:processedAt] || data[:processed_at]
-        )
-      when 'elicitation_complete'
-        ElicitationCompleteMessage.new(
-          subtype: data[:subtype], data: data,
-          uuid: data[:uuid], session_id: data[:session_id],
-          mcp_server_name: data[:mcpServerName] || data[:mcp_server_name],
-          elicitation_id: data[:elicitationId] || data[:elicitation_id]
-        )
-      when 'task_started'
-        TaskStartedMessage.new(
-          subtype: data[:subtype], data: data,
-          task_id: data[:task_id], description: data[:description],
-          uuid: data[:uuid], session_id: data[:session_id],
-          tool_use_id: data[:tool_use_id], task_type: data[:task_type],
-          workflow_name: data[:workflowName] || data[:workflow_name],
-          prompt: data[:prompt]
-        )
-      when 'task_progress'
-        TaskProgressMessage.new(
-          subtype: data[:subtype], data: data,
-          task_id: data[:task_id], description: data[:description],
-          usage: data[:usage], uuid: data[:uuid], session_id: data[:session_id],
-          tool_use_id: data[:tool_use_id], last_tool_name: data[:last_tool_name],
-          summary: data[:summary]
-        )
-      when 'task_notification'
-        TaskNotificationMessage.new(
-          subtype: data[:subtype], data: data,
-          task_id: data[:task_id], status: data[:status],
-          output_file: data[:output_file], summary: data[:summary],
-          uuid: data[:uuid], session_id: data[:session_id],
-          tool_use_id: data[:tool_use_id], usage: data[:usage]
-        )
-      else
-        SystemMessage.new(subtype: data[:subtype], data: data)
-      end
+      klass = SYSTEM_MESSAGE_CLASSES[data[:subtype]] || SystemMessage
+      klass.new(data)
     end
 
     def self.parse_result_message(data)
-      ResultMessage.new(
-        subtype: data[:subtype],
-        duration_ms: data[:duration_ms],
-        duration_api_ms: data[:duration_api_ms],
-        is_error: data[:is_error],
-        num_turns: data[:num_turns],
-        session_id: data[:session_id],
-        stop_reason: data[:stop_reason],
-        total_cost_usd: data[:total_cost_usd],
-        usage: data[:usage],
-        result: data[:result],
-        structured_output: data[:structured_output],
-        model_usage: data[:modelUsage] || data[:model_usage],
-        permission_denials: data[:permission_denials],
-        errors: data[:errors],
-        uuid: data[:uuid],
-        fast_mode_state: data[:fastModeState] || data[:fast_mode_state]
-      )
+      ResultMessage.new(data)
     end
 
     def self.parse_stream_event(data)
-      StreamEvent.new(
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        event: data[:event],
-        parent_tool_use_id: data[:parent_tool_use_id]
-      )
+      StreamEvent.new(data)
     end
 
     def self.parse_rate_limit_event(data)
-      info = data[:rate_limit_info] || {}
-      rate_limit_info = RateLimitInfo.new(
-        status: info[:status],
-        resets_at: info[:resetsAt],
-        rate_limit_type: info[:rateLimitType],
-        utilization: info[:utilization],
-        overage_status: info[:overageStatus],
-        overage_resets_at: info[:overageResetsAt],
-        overage_disabled_reason: info[:overageDisabledReason],
-        raw: info
-      )
-      RateLimitEvent.new(
-        rate_limit_info: rate_limit_info,
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        raw_data: data
-      )
+      RateLimitEvent.new(data.merge(raw_data: data))
     end
 
     def self.parse_tool_progress_message(data)
-      ToolProgressMessage.new(
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        tool_use_id: data[:toolUseId] || data[:tool_use_id],
-        tool_name: data[:toolName] || data[:tool_name],
-        parent_tool_use_id: data[:parentToolUseId] || data[:parent_tool_use_id],
-        elapsed_time_seconds: data[:elapsedTimeSeconds] || data[:elapsed_time_seconds],
-        task_id: data[:taskId] || data[:task_id]
-      )
+      ToolProgressMessage.new(data)
     end
 
     def self.parse_auth_status_message(data)
-      AuthStatusMessage.new(
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        is_authenticating: data[:isAuthenticating] || data[:is_authenticating],
-        output: data[:output],
-        error: data[:error]
-      )
+      AuthStatusMessage.new(data)
     end
 
     def self.parse_tool_use_summary_message(data)
-      ToolUseSummaryMessage.new(
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        summary: data[:summary],
-        preceding_tool_use_ids: data[:precedingToolUseIds] || data[:preceding_tool_use_ids]
-      )
+      ToolUseSummaryMessage.new(data)
     end
 
     def self.parse_prompt_suggestion_message(data)
-      PromptSuggestionMessage.new(
-        uuid: data[:uuid],
-        session_id: data[:session_id],
-        suggestion: data[:suggestion]
-      )
+      PromptSuggestionMessage.new(data)
     end
 
     # Accepts blocks with either symbol or string keys — live CLI messages