claude-agent-sdk 0.16.2 → 0.16.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 184cf490ead1c830e0733d720e8f3580310ea3d68880e4e2945b28f803bea83b
-  data.tar.gz: fd3d83127d247eec43f30852ee8e5a75b14420721ad32b14e2ee7a811ed1d673
+  metadata.gz: 98b00605830d86d1dc5e632ef9887574b255d2ace8fdc815451a53983ca0ea2e
+  data.tar.gz: d28cb3256fa5944f966e21afa753d082559a6d537d527dfc2abb5aaa962a450b
 SHA512:
-  metadata.gz: 054c00ec53645630c0a60e66d78503b46da03f6bc3b43f9021c4dd3274d3309345af83751a7556074e7303205f1d502361c9f1d339a8f9201aea92b5f0dfda6a
-  data.tar.gz: e32f7b8a2ed41fe1c5db98e5254b1abddcfffe4f935508fe61eeef1c10ed11c1bb14a344fea16f46300d1fd3e0c8e150884b0340600dd161ec1c9582a0ff4289
+  metadata.gz: 807595177836563a86f0dc72a3a70b297860d07f76d19c90d70f97dafae7a1bdd69a52583a8c005172148f6742b59fbd80e78f79a3d10c47ad33ba24d7ade89c
+  data.tar.gz: af94cf3bbd037da6b1a7998a41438f10227d731657c2050e4a0f1d57551e682d4dd9dcfef9d98c67f6ead150472804468093cc226622392b8b3ecdb25cae4d18

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.4] - 2026-04-23
+
+### Fixed
+- `Client#receive_response` no longer hangs in interactive Client mode. The 0.16.1 flag-based fix relied on the loop draining via the transport's `:end` sentinel, which only arrives when the CLI subprocess exits — true for one-shot `query()` but never for a `Client` whose CLI stays alive between turns. `receive_response` now drives `QueryHandler#receive_messages` directly so its `break` runs on the same fiber as the underlying `Async::Queue#dequeue` loop and unwinds it. The 0.16.1 regression spec passed only because its stub iterated a finite array; replaced with a real `Async::Queue` driven from a sibling task so a hang now fails the test.
+
+### Internal
+- `FiberBoundary` doc-comment now warns that `break`/`return`/`next` cannot cross the thread hop, so SDK-internal loops yielding user callbacks must keep loop control on the outer side of the boundary.
+
+## [0.16.3] - 2026-04-23
+
+### Changed
+- Internal: extracted `SubprocessCLITransport#record_bounded_stderr` helper to deduplicate the recent-stderr ring-buffer append/trim logic shared by `handle_stderr` and `drain_stderr_with_accumulation`, and replaced the inlined `20` cap with a named `RECENT_STDERR_LINES_LIMIT` constant. No public behavior change.
+
 ## [0.16.2] - 2026-04-23
 
 ### Changed

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.2'
+gem 'claude-agent-sdk', '~> 0.16.4'
 ```
 
 And then execute:

data/lib/claude_agent_sdk/fiber_boundary.rb

@@ -23,6 +23,10 @@ module ClaudeAgentSDK
   # user's app makes.
   #
   # No-op when no scheduler is active, so it's cheap to use unconditionally.
+  #
+  # The thread hop severs `break`/`return`/`next` from the surrounding method,
+  # so SDK loops yielding user callbacks must keep loop control outside the
+  # invoked block (see `Client#receive_response`).
   module FiberBoundary
     module_function
 

data/lib/claude_agent_sdk/subprocess_cli_transport.rb

@@ -13,6 +13,7 @@ module ClaudeAgentSDK
   class SubprocessCLITransport < Transport
     DEFAULT_MAX_BUFFER_SIZE = 1024 * 1024 # 1MB buffer limit
     MINIMUM_CLAUDE_CODE_VERSION = '2.0.0'
+    RECENT_STDERR_LINES_LIMIT = 20
 
     def initialize(options_or_prompt = nil, options = nil)
       # Support both new single-arg form and legacy two-arg form
@@ -145,11 +146,7 @@ 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
+        record_bounded_stderr(line_str)
 
         # Call stderr callback if provided
         @options.stderr&.call(line_str)
@@ -174,10 +171,7 @@ module ClaudeAgentSDK
         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
+        record_bounded_stderr(line_str)
       end
     end
 
@@ -282,7 +276,6 @@ module ClaudeAgentSDK
     def write(data)
       raise CLIConnectionError, 'ProcessTransport is not ready for writing' unless @ready && @stdin
       raise CLIConnectionError, "Cannot write to terminated process" if @process && !@process.alive?
-
       raise CLIConnectionError, "Cannot write to process that exited with error: #{@exit_error}" if @exit_error
 
       begin
@@ -395,5 +388,17 @@ module ClaudeAgentSDK
     def ready?
       @ready
     end
+
+    private
+
+    # Append a stderr line to the recent-stderr ring, dropping the oldest
+    # entry once the buffer exceeds RECENT_STDERR_LINES_LIMIT. Used to surface the
+    # last few lines in ProcessError when the CLI exits non-zero.
+    def record_bounded_stderr(line)
+      @recent_stderr_mutex.synchronize do
+        @recent_stderr << line
+        @recent_stderr.shift if @recent_stderr.size > RECENT_STDERR_LINES_LIMIT
+      end
+    end
   end
 end

data/lib/claude_agent_sdk/version.rb

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

data/lib/claude_agent_sdk.rb

@@ -418,15 +418,18 @@ module ClaudeAgentSDK
     def receive_response(&block)
       return enum_for(:receive_response) unless block
 
-      # Flag-based rather than `break`: `receive_messages` hops this
-      # block onto a plain thread via `FiberBoundary.invoke`, which
-      # severs break's unwind target.
-      result_seen = false
-      receive_messages do |message|
-        next if result_seen
-
-        block.call(message)
-        result_seen = true if message.is_a?(ResultMessage)
+      raise CLIConnectionError, 'Not connected. Call connect() first' unless @connected
+
+      # Keep `break` on the same fiber as the underlying dequeue. Going through
+      # Client#receive_messages would put the FiberBoundary hop above the break
+      # and hang in Client mode — the CLI keeps stdin open and never emits `:end`.
+      @query_handler.receive_messages do |data|
+        message = MessageParser.parse(data)
+        next unless message
+
+        ClaudeAgentSDK.notify_observers(@resolved_observers, :on_message, message)
+        FiberBoundary.invoke { block.call(message) }
+        break if message.is_a?(ResultMessage)
       end
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.16.2
+  version: 0.16.4
 platform: ruby
 authors:
 - Community Contributors