claude-agent-sdk 0.16.4 → 0.16.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98b00605830d86d1dc5e632ef9887574b255d2ace8fdc815451a53983ca0ea2e
-  data.tar.gz: d28cb3256fa5944f966e21afa753d082559a6d537d527dfc2abb5aaa962a450b
+  metadata.gz: f2fe7bf072c2a3b8448b23bf82c95e7f0a896b347bd43039145458b72e21f301
+  data.tar.gz: 1a58f5e31ef7a872aeaf75a3aada1c8e60a264d9ad5e93615b62c42d96179d99
 SHA512:
-  metadata.gz: 807595177836563a86f0dc72a3a70b297860d07f76d19c90d70f97dafae7a1bdd69a52583a8c005172148f6742b59fbd80e78f79a3d10c47ad33ba24d7ade89c
-  data.tar.gz: af94cf3bbd037da6b1a7998a41438f10227d731657c2050e4a0f1d57551e682d4dd9dcfef9d98c67f6ead150472804468093cc226622392b8b3ecdb25cae4d18
+  metadata.gz: e76c6cfe62c7b01320edf7a3d659e44fce46921f764132da7ab0f8223bb1d5a4a2b4457f5406b7bc68a1dde91f7af29fd0d4ff565334ed2cae8ad120339bac83
+  data.tar.gz: 9e1920a7254f5e27dab4ae88cc5ba6d8ac7430a7ec32e8c9157d80c792a65bee8c258096f52ac20ce69d5bedfd1a629a2c8ef852341c9b03e4aaa631c491d912

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.16.5] - 2026-04-24
+
+### Added
+- `display:` option on `ThinkingConfigAdaptive` and `ThinkingConfigEnabled`, forwarded to the CLI as `--thinking-display <summarized|omitted>`. Opus 4.7 defaults thinking display to `"omitted"` (empty `thinking` field, signature only), so pass `ThinkingConfigAdaptive.new(display: "summarized")` to receive plaintext summarized thinking text. Invalid values raise `ArgumentError` at construction. See [adaptive thinking docs](https://docs.claude.com/en/docs/build-with-claude/adaptive-thinking).
+
+### Internal
+- Extracted private `writeln`/`write` helpers in `Client` and `Query` to consolidate the `@transport.write(json + "\n")` pattern across five call sites. Pure refactor; same bytes on the wire.
+
 ## [0.16.4] - 2026-04-23
 
 ### Fixed

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

data/lib/claude_agent_sdk/command_builder.rb

@@ -158,8 +158,10 @@ module ClaudeAgentSDK
         case @options.thinking
         when ThinkingConfigAdaptive
           cmd.push("--thinking", "adaptive")
+          append_thinking_display(cmd, @options.thinking.display)
         when ThinkingConfigEnabled
           cmd.push("--max-thinking-tokens", @options.thinking.budget_tokens.to_s)
+          append_thinking_display(cmd, @options.thinking.display)
         when ThinkingConfigDisabled
           cmd.push("--thinking", "disabled")
         end
@@ -168,6 +170,15 @@ module ClaudeAgentSDK
       end
     end
 
+    # `--thinking-display` toggles between `"summarized"` (visible thinking
+    # text) and `"omitted"` (empty thinking, signature only). Opus 4.7 defaults
+    # to `"omitted"`, so pass `display: "summarized"` to see reasoning.
+    def append_thinking_display(cmd, display)
+      return if display.nil?
+
+      cmd.push("--thinking-display", display.to_s)
+    end
+
     # The set of supported levels is model-dependent; the CLI falls back to
     # the highest supported level at or below the one requested
     # (e.g. `xhigh` → `high` on Opus 4.6).

data/lib/claude_agent_sdk/query.rb

@@ -261,7 +261,7 @@ module ClaudeAgentSDK
           response: response_data
         }
       }
-      @transport.write(JSON.generate(success_response) + "\n")
+      writeln(JSON.generate(success_response))
     rescue Async::Stop
       # Cancellation requested; respond with an error so the CLI can unblock.
       cancelled_response = {
@@ -273,7 +273,7 @@ module ClaudeAgentSDK
           error: 'Cancelled'
         }
       }
-      @transport.write(JSON.generate(cancelled_response) + "\n")
+      writeln(JSON.generate(cancelled_response))
     rescue StandardError => e
       # Send error response
       error_response = {
@@ -285,7 +285,7 @@ module ClaudeAgentSDK
           error: e.message
         }
       }
-      @transport.write(JSON.generate(error_response) + "\n")
+      writeln(JSON.generate(error_response))
     end
 
     def handle_permission_request(request_data)
@@ -642,7 +642,7 @@ module ClaudeAgentSDK
         request: request
       }
 
-      @transport.write(JSON.generate(control_request) + "\n")
+      writeln(JSON.generate(control_request))
 
       # Wait for response with timeout (default 1200s to handle slow CLI startup)
       Async do |task|
@@ -913,13 +913,8 @@ module ClaudeAgentSDK
     def stream_input(stream)
       stream.each do |message|
         break if @closed
-        serialized = if message.is_a?(Hash)
-                       JSON.generate(message) + "\n"
-                     else
-                       message.to_s
-                     end
-        serialized += "\n" unless serialized.end_with?("\n")
-        @transport.write(serialized)
+        serialized = message.is_a?(Hash) ? JSON.generate(message) : message.to_s
+        writeln(serialized)
       end
     rescue StandardError => e
       # Log error but don't raise
@@ -928,6 +923,14 @@ module ClaudeAgentSDK
       wait_for_result_and_end_input
     end
 
+    def writeln(string)
+      write string.end_with?("\n") ? string : "#{string}\n"
+    end
+
+    def write(string)
+      @transport.write(string)
+    end
+
     # Receive SDK messages (not control messages)
     def receive_messages(&block)
       return enum_for(:receive_messages) unless block

data/lib/claude_agent_sdk/types.rb

@@ -599,23 +599,53 @@ module ClaudeAgentSDK
   end
 
   # Thinking configuration types
+  #
+  # `display` controls how thinking content appears in responses. Valid values
+  # are `"summarized"` (plaintext summary) and `"omitted"` (empty thinking
+  # field, signature only). Defaults are model-dependent: Opus 4.6/Sonnet 4.6
+  # default to `"summarized"`; Opus 4.7 and Mythos Preview default to
+  # `"omitted"`. Pass `display: "summarized"` explicitly on Opus 4.7 to get
+  # visible thinking text. Not supported with `ThinkingConfigDisabled`.
+  THINKING_DISPLAY_VALUES = %w[summarized omitted].freeze
 
   # Adaptive thinking: uses a default budget of 32000 tokens
   class ThinkingConfigAdaptive
-    attr_accessor :type
+    attr_accessor :type, :display
 
-    def initialize
+    def initialize(display: nil)
       @type = 'adaptive'
+      @display = validate_display(display)
+    end
+
+    private
+
+    def validate_display(value)
+      return nil if value.nil?
+      return value if THINKING_DISPLAY_VALUES.include?(value.to_s)
+
+      raise ArgumentError,
+            "invalid thinking display #{value.inspect}; expected one of #{THINKING_DISPLAY_VALUES.inspect}"
     end
   end
 
   # Enabled thinking: uses a user-specified budget
   class ThinkingConfigEnabled
-    attr_accessor :type, :budget_tokens
+    attr_accessor :type, :budget_tokens, :display
 
-    def initialize(budget_tokens:)
+    def initialize(budget_tokens:, display: nil)
       @type = 'enabled'
       @budget_tokens = budget_tokens
+      @display = validate_display(display)
+    end
+
+    private
+
+    def validate_display(value)
+      return nil if value.nil?
+      return value if THINKING_DISPLAY_VALUES.include?(value.to_s)
+
+      raise ArgumentError,
+            "invalid thinking display #{value.inspect}; expected one of #{THINKING_DISPLAY_VALUES.inspect}"
     end
   end
 

data/lib/claude_agent_sdk/version.rb

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

data/lib/claude_agent_sdk.rb

@@ -374,9 +374,7 @@ module ClaudeAgentSDK
         query(prompt)
       else
         prompt.each do |message_json|
-          message_json = message_json.to_s
-          message_json += "\n" unless message_json.end_with?("\n")
-          @transport.write(message_json)
+          writeln(message_json.to_s)
         end
       end
     end
@@ -394,7 +392,7 @@ module ClaudeAgentSDK
         parent_tool_use_id: nil,
         session_id: session_id
       }
-      @transport.write(JSON.generate(message) + "\n")
+      writeln(JSON.generate(message))
     end
 
     # Receive all messages from Claude
@@ -557,5 +555,13 @@ module ClaudeAgentSDK
       end
       nil
     end
+
+    def writeln(string)
+      write string.end_with?("\n") ? string : "#{string}\n"
+    end
+
+    def write(string)
+      @transport.write(string)
+    end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.16.4
+  version: 0.16.5
 platform: ruby
 authors:
 - Community Contributors
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async