claude-agent-sdk 0.6.2 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8044b53b9c1c89e75c789b94a1ca000bb4a4a6e94d380bef3ded209585517b29
-  data.tar.gz: a3effbef7a3cbf1faed47cecb6f69df37e17266eabae7e56a556855b85707c4f
+  metadata.gz: 1ee66bd44d402ecac03c5928cc485360342b64510985de4966a627b5ada3919f
+  data.tar.gz: d69ea31b3f6dd26679aeb9c8857616d757861a54a9f9803ce7b0575043348bef
 SHA512:
-  metadata.gz: 3c9360caa6e3fc1ffa7d359e4d2195aecf003e1fc37655bfe15355efc2dce3cfd896f30a0b7bdc504a88d90056bab05b7ad2a90c33f0ad03867abcaf0ccb16a7
-  data.tar.gz: 68059199d80d3f10ff03b18b6fbb505348070f8a1a53d8d00cd56550fdfe7c337a4b53d39d7e41d0238c954dd2106656c6f8eaf6e39b5ac516278ac4c7c57ff4
+  metadata.gz: 5e381c777261d67d8e95638874455cd13cda055b7524ff20459dc5e53ca2d8e70c4580637f3da34d83e22090becae0b4a9bcdd15ffb9613db3c03133fe3c4255
+  data.tar.gz: 2400f7ccb58c48b8c12d4fc3843781b5545d2ff80c030daa32be4529ae0c2b4f59e3114138e6b21f7c3923c4e3ccca9594fbf6e6722c8d540b729c18e47767f3

data/lib/claude_agent_sdk/message_parser.rb

@@ -23,6 +23,8 @@ module ClaudeAgentSDK
         parse_result_message(data)
       when 'stream_event'
         parse_stream_event(data)
+      when 'rate_limit_event'
+        parse_rate_limit_event(data)
       else
         raise MessageParseError.new("Unknown message type: #{message_type}", data: data)
       end
@@ -91,6 +93,10 @@ module ClaudeAgentSDK
       )
     end
 
+    def self.parse_rate_limit_event(data)
+      RateLimitEvent.new(data: data)
+    end
+
     def self.parse_content_block(block)
       case block[:type]
       when 'text'

data/lib/claude_agent_sdk/subprocess_cli_transport.rb

@@ -32,6 +32,8 @@ module ClaudeAgentSDK
       @exit_error = nil
       @max_buffer_size = options.max_buffer_size || DEFAULT_MAX_BUFFER_SIZE
       @stderr_task = nil
+      @recent_stderr = []
+      @recent_stderr_mutex = Mutex.new
       @pipe_prompt_via_stdin = false
     end
 
@@ -273,9 +275,11 @@ module ClaudeAgentSDK
       # Build environment
       # Convert symbol keys to strings for spawn compatibility
       custom_env = @options.env.transform_keys { |k| k.to_s }
-      # Strip CLAUDECODE to prevent "nested session" detection when the SDK
-      # launches Claude Code from within an existing Claude Code terminal
-      process_env = ENV.to_h.except('CLAUDECODE').merge('CLAUDE_AGENT_SDK_VERSION' => VERSION).merge(custom_env)
+      # Explicitly unset CLAUDECODE to prevent "nested session" detection when the SDK
+      # launches Claude Code from within an existing Claude Code terminal.
+      # NOTE: Must set to nil (not just omit the key) — Ruby's spawn only overlays
+      # the env hash on top of the parent environment; a nil value actively unsets.
+      process_env = ENV.to_h.merge('CLAUDECODE' => nil, 'CLAUDE_AGENT_SDK_VERSION' => VERSION).merge(custom_env)
       process_env['CLAUDE_CODE_ENTRYPOINT'] ||= 'sdk-rb'
       process_env['PWD'] = @cwd.to_s if @cwd
 
@@ -292,16 +296,17 @@ module ClaudeAgentSDK
         # Without this, --verbose output fills the OS pipe buffer (~64KB),
         # the subprocess blocks on write, and all pipes stall → EPIPE.
         if @stderr
-          if should_pipe_stderr
+          if should_pipe_stderr # rubocop:disable Style/ConditionalAssignment
             @stderr_task = Thread.new do
               handle_stderr
             rescue StandardError
               # Ignore errors during stderr reading
             end
           else
-            # Silently drain stderr so the subprocess never blocks
+            # Silently drain stderr so the subprocess never blocks,
+            # but still accumulate recent lines for error reporting.
             @stderr_task = Thread.new do
-              @stderr.each_line { |_| } # discard
+              drain_stderr_with_accumulation
             rescue StandardError
               # Ignore — process may have already exited
             end
@@ -343,6 +348,12 @@ module ClaudeAgentSDK
         line_str = line.chomp
         next if line_str.empty?
 
+        # Accumulate recent lines for inclusion in ProcessError
+        @recent_stderr_mutex.synchronize do
+          @recent_stderr << line_str
+          @recent_stderr.shift if @recent_stderr.size > 20
+        end
+
         # Call stderr callback if provided
         @options.stderr&.call(line_str)
 
@@ -359,6 +370,20 @@ module ClaudeAgentSDK
       # Ignore errors during stderr reading
     end
 
+    def drain_stderr_with_accumulation
+      return unless @stderr
+
+      @stderr.each_line do |line|
+        line_str = line.chomp
+        next if line_str.empty?
+
+        @recent_stderr_mutex.synchronize do
+          @recent_stderr << line_str
+          @recent_stderr.shift if @recent_stderr.size > 20
+        end
+      end
+    end
+
     def close
       @ready = false
       return unless @process
@@ -511,10 +536,16 @@ module ClaudeAgentSDK
       returncode = status.exitstatus
 
       if returncode && returncode != 0
+        # Wait briefly for stderr thread to finish draining
+        @stderr_task&.join(1)
+
+        stderr_text = @recent_stderr_mutex.synchronize { @recent_stderr.last(10).join("\n") }
+        stderr_text = 'No stderr output captured' if stderr_text.empty?
+
         @exit_error = ProcessError.new(
           "Command failed with exit code #{returncode}",
           exit_code: returncode,
-          stderr: 'Check stderr output for details'
+          stderr: stderr_text
         )
         raise @exit_error
       end

data/lib/claude_agent_sdk/types.rb

@@ -144,6 +144,15 @@ module ClaudeAgentSDK
     end
   end
 
+  # Rate limit event emitted by Claude Code CLI when API rate limits are hit
+  class RateLimitEvent
+    attr_accessor :data
+
+    def initialize(data:)
+      @data = data
+    end
+  end
+
   # Agent definition configuration
   class AgentDefinition
     attr_accessor :description, :prompt, :tools, :model

data/lib/claude_agent_sdk/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.3
 platform: ruby
 authors:
 - Community Contributors
 bindir: bin
 cert_chain: []
-date: 2026-02-16 00:00:00.000000000 Z
+date: 2026-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async