claude-agent-sdk 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74a467e8e7f814ad55325db2de60cee2bd1f7a8bd849945b28302cf7776db2b9
-  data.tar.gz: b0c9dc121f7500f314ebe03ba77db2e16a112c60222a7e7d50ca68897d36af41
+  metadata.gz: 8044b53b9c1c89e75c789b94a1ca000bb4a4a6e94d380bef3ded209585517b29
+  data.tar.gz: a3effbef7a3cbf1faed47cecb6f69df37e17266eabae7e56a556855b85707c4f
 SHA512:
-  metadata.gz: 5c6b145098e0e8489838f4d9b6e1a3f0af50a18e20a15055497fca65c1922e6f0e556bfb1e1844720989b81811eaf50d1605392d4d6bbf500fe367cbd744c172
-  data.tar.gz: 7ca8630977ebe60f00d8592c993d80eab1cc9754a1190dbd579b239a6f8ee105c48bbf3e5fe3b1aaa3da26c6ea62f369ee00d040d48eab002253f27aecee26a5
+  metadata.gz: 3c9360caa6e3fc1ffa7d359e4d2195aecf003e1fc37655bfe15355efc2dce3cfd896f30a0b7bdc504a88d90056bab05b7ad2a90c33f0ad03867abcaf0ccb16a7
+  data.tar.gz: 68059199d80d3f10ff03b18b6fbb505348070f8a1a53d8d00cd56550fdfe7c337a4b53d39d7e41d0238c954dd2106656c6f8eaf6e39b5ac516278ac4c7c57ff4

data/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.2] - 2026-02-17
+
+### Fixed
+- **Large prompt `Errno::E2BIG` crash:** Prompts exceeding 200KB are now piped via stdin instead of passed as CLI arguments, avoiding the OS `ARG_MAX` limit (typically 1MB on macOS/Linux). This fixes `CLIConnectionError: Failed to start Claude Code: Argument list too long` when using `query()` with large prompts.
+- **Stderr pipe deadlock (`Errno::EPIPE`):** Always drain stderr in a background thread, even when `stderr` option is not set. Without this, `--verbose` output fills the 64KB OS pipe buffer, the subprocess blocks on write, and all pipes stall. Previously only manifested with long-running Opus sessions.
+
 ## [0.6.0] - 2026-02-13
 
 ### Added

data/lib/claude_agent_sdk/subprocess_cli_transport.rb

@@ -13,6 +13,11 @@ module ClaudeAgentSDK
     DEFAULT_MAX_BUFFER_SIZE = 1024 * 1024 # 1MB buffer limit
     MINIMUM_CLAUDE_CODE_VERSION = '2.0.0'
 
+    # Prompts larger than this are piped via stdin instead of CLI args
+    # to avoid Errno::E2BIG (ARG_MAX is typically 1MB on macOS/Linux,
+    # shared with environment variables).
+    PROMPT_STDIN_THRESHOLD = 200 * 1024 # 200KB
+
     def initialize(prompt, options)
       @prompt = prompt
       @is_streaming = !prompt.is_a?(String)
@@ -27,6 +32,7 @@ module ClaudeAgentSDK
       @exit_error = nil
       @max_buffer_size = options.max_buffer_size || DEFAULT_MAX_BUFFER_SIZE
       @stderr_task = nil
+      @pipe_prompt_via_stdin = false
     end
 
     def find_cli
@@ -245,6 +251,11 @@ module ClaudeAgentSDK
       # Prompt handling
       if @is_streaming
         cmd.concat(['--input-format', 'stream-json'])
+      elsif @prompt.to_s.bytesize > PROMPT_STDIN_THRESHOLD
+        # Large prompts are piped via stdin to avoid OS argument size limits.
+        # Claude CLI reads from stdin when --print is used without a trailing argument.
+        cmd << '--print'
+        @pipe_prompt_via_stdin = true
       else
         cmd.concat(['--print', '--', @prompt.to_s])
       end
@@ -277,15 +288,32 @@ module ClaudeAgentSDK
 
         @stdin, @stdout, @stderr, @process = Open3.popen3(process_env, *cmd, opts)
 
-        # Handle stderr if piped
-        if should_pipe_stderr && @stderr
-          @stderr_task = Thread.new do
-            handle_stderr
-          rescue StandardError
-            # Ignore errors during stderr reading
+        # Always drain stderr to prevent pipe buffer deadlock.
+        # 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
+            @stderr_task = Thread.new do
+              handle_stderr
+            rescue StandardError
+              # Ignore errors during stderr reading
+            end
+          else
+            # Silently drain stderr so the subprocess never blocks
+            @stderr_task = Thread.new do
+              @stderr.each_line { |_| } # discard
+            rescue StandardError
+              # Ignore — process may have already exited
+            end
           end
         end
 
+        # For large prompts, pipe the prompt text to stdin before closing.
+        # This avoids Errno::E2BIG when the prompt exceeds ARG_MAX.
+        if @pipe_prompt_via_stdin && @stdin
+          @stdin.write(@prompt.to_s)
+        end
+
         # Close stdin for non-streaming mode
         @stdin.close unless @is_streaming
         @stdin = nil unless @is_streaming

data/lib/claude_agent_sdk/version.rb

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

metadata

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