claude-agent-sdk 0.33.0 → 0.33.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5c70ede77de755091c7587cb3bed3ea95075ed6db34b7a2cc4e3214db9adcb5
-  data.tar.gz: b4d77a1e0888dc0ef3e436e933ee2334d6912b087e440fb88af0765e34703e10
+  metadata.gz: 6994a2674fc098001857cff72a21c3d804744c6fa25cb866f2a133ee1a2ec876
+  data.tar.gz: 349b7ce2314eac4c315e3c3d03ef0e466926fe3abb0f8823d1780f1486a8ce0d
 SHA512:
-  metadata.gz: '0658614c047b36d2cd7c8724c01e31b1bdcb4aac81246caf6e56c7afb9e8203bf2e7cedfd112c59c317fb0cd5359785737e8a4e33efa67f448ee47792a81fc17'
-  data.tar.gz: 2938e8804ee6396fdadb60be8345da7317628f853ec35947aba5f8542c732346d4a360aa0222f57977d18578e3689e0307d55337802f908ce4eed85543518122
+  metadata.gz: 0442feb3be095e8be7903e55e51f5620607b682cb0ed57f1ded989f01f6bf04bf22cee36556b52fd8cb4072d2e3bf4a2400c459b8cad231a83590d75b1010403
+  data.tar.gz: e287cd5825a5e16f1c8d7ce8295d0f3fba07ee15c5e4502be2dbfefcd223cf061c6e20afe5e5e6349e7ee2729c8c70e77aea152c6b95dc997978bc5ef358f68e

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.33.1] - 2026-09-21
+
+Compatibility with `json` 3.x and `mcp` 1.x. Upgrade if your bundle resolves `json` 3.x — `rename_session` / `tag_session` raise on 0.33.0.
+
+### Changed
+- `mcp` dependency is now `>= 0.20, < 2` (was `>= 0.6, < 1`). The floor moves to 0.20 because `mcp` 0.19 and older validate through the `json-schema` gem, which breaks under `json` 3.x and fails every SDK MCP `tools/call`; with `json` 2.x those versions still pass, so this only forces an `mcp` upgrade on bundles pinned below 0.20. The suite passes against every 1.x release through 1.6.0, and `initialize` / `tools/list` / `tools/call` / `resources/*` / `prompts/*` wire output is byte-identical to 0.2x.
+- SDK MCP tool handler exceptions now reach the model as the bare exception message (matching Python's `str(e)` and `SdkMcpServer#call_tool`) instead of the gem's `Internal error calling tool X: msg`. The exception is rescued inside the SDK's tool class, so the text no longer depends on the `mcp` gem version — `mcp` 1.2+ redacts the message from its own wrapper, which would otherwise have left the model with no error text to self-correct from. Still in-band `isError: true`.
+
+### Fixed
+- `rename_session` / `tag_session` raised `ArgumentError: unknown keyword: space_size` under `json` 3.x, which takes generator options as strict keywords. The option was a no-op on `json` 2.x (output unchanged), so it is simply gone. A fresh end-user bundle resolves `json` 3.x through `async → console → json`; CI missed it only because the dev-only RuboCop pin holds `json` at 2.x.
+
 ## [0.33.0] - 2026-09-21
 
 Subagent capabilities for UI builders: metadata reads, background snapshots, cooperative callback cancellation, and the task/background/permission signals the CLI already emits — all raw data and controls, no status model. Ruby-ahead of the Python SDK (0.2.153).

data/README.md

@@ -27,7 +27,7 @@ A Ruby SDK for the [Claude Code](https://docs.claude.com/en/docs/claude-code-ove
 
 ```ruby
 # Gemfile
-gem 'claude-agent-sdk', '~> 0.33.0'
+gem 'claude-agent-sdk', '~> 0.33.1'
 ```
 
 Then `bundle install`, or install directly with `gem install claude-agent-sdk`. To track unreleased changes, point the Gemfile at GitHub: `gem 'claude-agent-sdk', github: 'ya-luotao/claude-agent-sdk-ruby'`.

data/lib/claude_agent_sdk/query.rb

@@ -1195,9 +1195,12 @@ module ClaudeAgentSDK
       # server validates arguments against the tool's inputSchema BEFORE the
       # handler runs and reports validation failures, unknown tools, and
       # handler exceptions as in-band isError results). tools/list,
-      # initialize, resources/* and prompts/* stay on the SDK paths — the
-      # gem drops annotations/_meta from tools/list and negotiates newer
-      # protocol versions.
+      # initialize, resources/* and prompts/* stay on the SDK paths: the
+      # gem's tools/list injects "$schema" and drops `required: []` (and
+      # would advertise the empty fallback schema where the SDK advertises
+      # the user's own), and its initialize negotiates newer protocol
+      # versions and advertises prompts/resources/logging even for a
+      # tools-only server. Annotations/_meta do survive the gem path.
       server.handle_message(message)
     end
 

data/lib/claude_agent_sdk/sdk_mcp_server.rb

@@ -453,6 +453,16 @@ module ClaudeAgentSDK
                 error: !!is_error,
                 structured_content: structured_content
               )
+            rescue StandardError => e
+              # Report handler failures in-band HERE rather than letting them
+              # reach the gem: mcp >= 1.2 deliberately drops e.message from
+              # its "Internal error calling tool X" wrapper (CWE-209), which
+              # would hide the text the model needs to self-correct. Bare
+              # e.message like Python's str(e) and #call_tool — no prefix.
+              # Nothing gem-internal can be swallowed here today: handlers get
+              # no server_context, so MCP::CancelledError never originates
+              # inside this method. Revisit if cancellation is ever plumbed in.
+              MCP::Tool::Response.new([{ type: 'text', text: e.message }], error: true)
             end
           end
         end

data/lib/claude_agent_sdk/session_mutations.rb

@@ -38,8 +38,7 @@ module ClaudeAgentSDK
       stripped = title.strip
       raise ArgumentError, 'title must be non-empty' if stripped.empty?
 
-      data = "#{JSON.generate({ type: 'custom-title', customTitle: stripped, sessionId: session_id },
-                              space_size: 0)}\n"
+      data = "#{JSON.generate({ type: 'custom-title', customTitle: stripped, sessionId: session_id })}\n"
 
       append_to_session(session_id, data, directory)
     end
@@ -64,8 +63,7 @@ module ClaudeAgentSDK
         tag = sanitized
       end
 
-      data = "#{JSON.generate({ type: 'tag', tag: tag || '', sessionId: session_id },
-                              space_size: 0)}\n"
+      data = "#{JSON.generate({ type: 'tag', tag: tag || '', sessionId: session_id })}\n"
 
       append_to_session(session_id, data, directory)
     end

data/lib/claude_agent_sdk/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-agent-sdk
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.33.1
 platform: ruby
 authors:
 - Community Contributors
@@ -30,20 +30,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.20'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.20'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement