claude-agent-sdk 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '03965bed10e6220b6f00d32ad789aa5c743c7c74f5625f046bd58c0137f1ccae'
-  data.tar.gz: c1460d6d10d52ddb5e0ece51e3b5eab2c6d5962d8a7ead7a07661e1ee63aaf99
+  metadata.gz: ca3c257ced832f2e2120e7600aa346ef7e8487567309ac1ff579e8672743819e
+  data.tar.gz: f3598c2b3abe03b67042b5f04b5a0fd4b6cc12f80ba73d36bb9708e6b080d94e
 SHA512:
-  metadata.gz: 52e72c3cf52957c54965300787f213add70236025b7fd5de309aabba4fcb9243e1ff973141f4c0ae85aefddf3b182ac49a737a2696bd5f57893ca031af70999d
-  data.tar.gz: 3472c21997df7a77cf96eafd6f08671f77574321b23cbb8128d81364b2c523b64617c624c63f70a7a64f0bd6e1d3de807430bfd570e12ba989dda80163704417
+  metadata.gz: d88cfa73d92aa49aaf83d94ad51ba6f0e65761c51b7f4703477e606765a4cee06f65725cf295f30e8605c694cafc40f389f96e131f0db668db145ec31409da02
+  data.tar.gz: fa86ac725b72ee1896525cccaebc119b0d1c8138c931e375e95e8549275ff0b89426cc9dbaa2f352ff389e9b7614d4cb7164a1c290ed92c0b03634246f17db4b

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.11.0] - 2026-03-20
+
+### Added
+
+#### Custom Transport Support
+- `Client.new` accepts `transport_class:` and `transport_args:` keyword arguments, allowing consumers to plug in custom transports (e.g., E2B sandbox, remote SSH) without duplicating `Client#connect` internals
+- Default remains `SubprocessCLITransport` — zero behavior change for existing callers
+- Custom transport class must implement the `Transport` interface (`connect`, `write`, `read_messages`, `end_input`, `close`, `ready?`)
+- `transport_args` are passed as keyword arguments to `transport_class.new(options, **transport_args)`
+- All option transformations, MCP extraction, hook conversion, and Query lifecycle stay in `Client#connect` — the transport only handles I/O
+
 ## [0.10.0] - 2026-03-20
 
 Port of Python SDK v0.1.48 features for feature parity.

data/README.md

@@ -6,7 +6,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/claude-agent-sdk.svg?icon=si%3Arubygems)](https://badge.fury.io/rb/claude-agent-sdk)
 
-### Feature Parity with Python SDK (v0.1.48)
+### Feature Parity with Python SDK (v0.1.48) + Ruby Extras
 
 | Feature | Python | Ruby |
 |---------|:------:|:----:|
@@ -34,6 +34,7 @@
 | `usage` on `AssistantMessage` | ✅ | ✅ |
 | Fallback model | ✅ | ✅ |
 | Plugin support | ✅ | ✅ |
+| Custom transport (pluggable I/O layer) | — | ✅ |
 | Rails integration (configure block, ActionCable) | — | ✅ |
 | Bundled CLI binary | ✅ | — |
 
@@ -127,6 +128,7 @@ Both SDKs spawn `claude` CLI as a subprocess with stream-JSON over stdin/stdout.
 - [Quick Start](#quick-start)
 - [Basic Usage: query()](#basic-usage-query)
 - [Client](#client)
+- [Custom Transport](#custom-transport)
 - [Custom Tools (SDK MCP Servers)](#custom-tools-sdk-mcp-servers)
 - [Hooks](#hooks)
 - [Permission Callbacks](#permission-callbacks)
@@ -156,7 +158,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.10.0'
+gem 'claude-agent-sdk', '~> 0.11.0'
 ```
 
 And then execute:
@@ -358,6 +360,59 @@ Async do
 end.wait
 ```
 
+### Custom Transport
+
+By default, `Client` uses `SubprocessCLITransport` to spawn the Claude Code CLI locally. You can provide a custom transport class to connect via other channels (e.g., E2B sandbox, remote SSH, WebSocket):
+
+```ruby
+# Custom transport must implement the Transport interface:
+# connect, write, read_messages, end_input, close, ready?
+class E2BSandboxTransport < ClaudeAgentSDK::Transport
+  def initialize(options, sandbox:)
+    @options = options
+    @sandbox = sandbox
+  end
+
+  def connect
+    @sandbox.connect
+  end
+
+  def write(data)
+    @sandbox.stdin_write(data)
+  end
+
+  def read_messages(&block)
+    @sandbox.stdout_read_lines { |line| yield JSON.parse(line, symbolize_names: true) }
+  end
+
+  def end_input
+    @sandbox.close_stdin
+  end
+
+  def close
+    @sandbox.disconnect
+  end
+
+  def ready?
+    @sandbox.connected?
+  end
+end
+
+# Use it with Client — all connect orchestration (option transforms,
+# MCP extraction, hook conversion, Query lifecycle) is handled for you
+Async do
+  client = ClaudeAgentSDK::Client.new(
+    options: options,
+    transport_class: E2BSandboxTransport,
+    transport_args: { sandbox: my_sandbox }
+  )
+  client.connect
+  client.query("Hello from the sandbox!")
+  client.receive_response { |msg| puts msg }
+  client.disconnect
+end.wait
+```
+
 ## Custom Tools (SDK MCP Servers)
 
 A **custom tool** is a Ruby proc/lambda that you can offer to Claude, for Claude to invoke as needed.

data/lib/claude_agent_sdk/version.rb

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

data/lib/claude_agent_sdk.rb

@@ -239,8 +239,14 @@ module ClaudeAgentSDK
   class Client
     attr_reader :query_handler
 
-    def initialize(options: nil)
+    # @param options [ClaudeAgentOptions, nil] Configuration options
+    # @param transport_class [Class] Transport class to use (must implement Transport interface).
+    #   Defaults to SubprocessCLITransport.
+    # @param transport_args [Hash] Additional keyword arguments passed to transport_class.new(options, **transport_args)
+    def initialize(options: nil, transport_class: SubprocessCLITransport, transport_args: {})
       @options = options || ClaudeAgentOptions.new
+      @transport_class = transport_class
+      @transport_args = transport_args
       @transport = nil
       @query_handler = nil
       @connected = false
@@ -274,7 +280,7 @@ module ClaudeAgentSDK
       )
 
       # Client always uses streaming mode; keep stdin open for bidirectional communication.
-      @transport = SubprocessCLITransport.new(configured_options)
+      @transport = @transport_class.new(configured_options, **@transport_args)
       @transport.connect
 
       # Extract SDK MCP servers

metadata

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