claude-agent-sdk 0.17.0 → 0.18.0

data/lib/claude_agent_sdk/types.rb

@@ -525,7 +525,16 @@ module ClaudeAgentSDK
 
   # Permission update configuration
   class PermissionUpdate < Type
-    attr_accessor :type, :rules, :behavior, :mode, :directories, :destination
+    attr_accessor :type, :behavior, :mode, :directories, :destination
+    attr_reader :rules
+
+    # Wire-format parity with Python PermissionUpdate.from_dict (#920): the CLI
+    # sends rules as camelCase hashes ({toolName:, ruleContent:}); hydrate them
+    # into PermissionRuleValue (Type#assign_attribute normalizes the camelCase
+    # keys). Already-typed PermissionRuleValue entries pass through unchanged.
+    def rules=(value)
+      @rules = value&.map { |rule| rule.is_a?(Hash) ? PermissionRuleValue.new(rule) : rule }
+    end
 
     def to_h
       result = { type: @type }
@@ -888,6 +897,22 @@ module ClaudeAgentSDK
     end
   end
 
+  # Fallback for hook events the SDK does not yet model. Carries the wire
+  # event name and the complete raw payload so no fields are lost (Python
+  # passes hook input through as a raw dict, so unknown events lose
+  # nothing there).
+  class UnknownHookInput < BaseHookInput
+    attr_accessor :raw_input
+
+    def initialize(attributes = {})
+      super
+      # Direct assignment: BaseHookInput exposes hook_event_name as
+      # attr_reader only, and Type#assign_attribute silently drops keys
+      # without public setters.
+      @hook_event_name = attributes[:hook_event_name] || attributes['hook_event_name']
+    end
+  end
+
   # Setup hook specific output
   class SetupHookSpecificOutput < Type
     attr_accessor :additional_context
@@ -1480,10 +1505,10 @@ module ClaudeAgentSDK
                   :model, :permission_prompt_tool_name, :cwd, :cli_path, :settings,
                   :add_dirs, :env, :extra_args, :max_buffer_size, :stderr,
                   :can_use_tool, :hooks, :user,
-                  :agents, :setting_sources,
+                  :agents, :setting_sources, :skills,
                   :output_format, :max_budget_usd, :max_thinking_tokens,
                   :fallback_model, :plugins, :debug_stderr,
-                  :betas, :tools, :sandbox, :append_allowed_tools,
+                  :betas, :tools, :sandbox,
                   :thinking, :effort, :observers, :task_budget,
                   :session_store, :session_store_flush, :load_timeout_ms
     attr_reader :bare, :fork_session, :enable_file_checkpointing,
@@ -1596,8 +1621,11 @@ module ClaudeAgentSDK
       defaults = ClaudeAgentSDK.default_options
       return attributes unless defaults.any?
 
-      # Start from configured defaults (deep dup hashes to prevent mutation)
-      result = defaults.transform_values { |v| v.is_a?(Hash) ? v.dup : v }
+      # Start from configured defaults. Container values are recursively
+      # duped so per-instance mutation (options.allowed_tools << 'Bash')
+      # can never corrupt the global defaults; non-container leaves
+      # (Strings, Procs, SdkMcpServer instances) intentionally keep identity.
+      result = deep_dup_containers(defaults)
       attributes.each do |key, value|
         default_val = result[key]
         result[key] = if value.nil?
@@ -1610,6 +1638,16 @@ module ClaudeAgentSDK
       end
       result
     end
+
+    # Recurse ONLY into Hash/Array; leaves keep object identity (observer
+    # factories, callbacks, SDK MCP server instances must not be duped).
+    def deep_dup_containers(value)
+      case value
+      when Hash then value.to_h { |k, v| [k, deep_dup_containers(v)] }
+      when Array then value.map { |v| deep_dup_containers(v) }
+      else value
+      end
+    end
   end
 
   # SDK MCP Tool definition

data/lib/claude_agent_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeAgentSDK
-  VERSION = '0.17.0'
+  VERSION = '0.18.0'
 end