claude_agent 0.7.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db922e35ad5e88546f17fe9d51a42d05ea0dbe5ae5b13f0f9733857b5bc467b2
-  data.tar.gz: 55b2aceec109d36a624fb0c2fa1979b440f05758e01b894f962b5c27c02bfdb9
+  metadata.gz: a975c8190094b78c316e158db7bc1ba0a6bcde1d64ff1e92ada4787e13a9c756
+  data.tar.gz: 7ee6a218923b9734f524f95b372711d6f2b31bcb941b9364b381f210104b2726
 SHA512:
-  metadata.gz: 1163853d431c1203309bb1926204034c9a77ab581deb52f3400cb266751a18a308be66342e8a31f7d2eae1a30767f68fb0255df35844097d733e34397345e56a
-  data.tar.gz: 8c99d3eb98b28a31abfd704e800fc8df816132037d8c30329a2f575a88b2debe02afd3dde48842edfcd78235268484e638119209712e9a82dccde725b0f908a4
+  metadata.gz: 0f75560464b82fa334a168c8dc46241608a3effd288e4537dc44fbb5182df6c1006e87c60dca19a3473813816c6709c868f842c934acb3fc29dd3852ec29fd71
+  data.tar.gz: 9b004ea2c7c510efe51801bf9d6170a21896a4d3593ea9566f9683c40e9edf60a76eaf81d1426970cfe1313df7f3176486529b7caaa5c29ccaf96fed86456df3

data/CHANGELOG.md

@@ -7,8 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.2] - 2026-02-05
+
+### Added
+- `description` field on `ToolPermissionContext` (TypeScript SDK v0.2.32 parity)
+- `allow_managed_domains_only` field on `SandboxNetworkConfig`
+- `initialization_result` method on `ControlProtocol` and `Client` with `InitializationResult`, `SlashCommand`, `ModelInfo`, and `AccountInfo` types
+
+### Changed
+- Updated SPEC.md to reference TypeScript SDK v0.2.32 and Python SDK v0.1.30
+
 ## [0.7.1] - 2026-02-03
 
+### Added
+- `debug` option for verbose debug logging (`--debug` CLI flag)
+- `debug_file` option for writing debug logs to a file (`--debug-file` CLI flag)
+- `stop_reason` field on `ResultMessage` indicating why the model stopped generating
+
+### Changed
+- Updated SPEC.md to reference TypeScript SDK v0.2.31 and Python SDK v0.1.29
+
 ## [0.7.0] - 2026-01-31
 
 ### Added

data/SPEC.md

@@ -3,11 +3,11 @@
 This document provides a comprehensive specification of the Claude Agent SDK, comparing feature parity across the official TypeScript and Python SDKs with this Ruby implementation.
 
 **Reference Versions:**
-- TypeScript SDK: v0.2.31 (npm package)
-- Python SDK: v0.1.29 from GitHub (commit 7519c96)
+- TypeScript SDK: v0.2.32 (npm package)
+- Python SDK: v0.1.30 from GitHub (commit 451f2f4)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-02-03
+**Last Updated:** 2026-02-05
 
 ---
 
@@ -236,6 +236,7 @@ Bidirectional control protocol for SDK-CLI communication.
 | `ModelInfo`           |     ✅      |   ❌    |  ✅   | Model information      |
 | `McpServerStatus`     |     ✅      |   ❌    |  ✅   | MCP server status      |
 | `AccountInfo`         |     ✅      |   ❌    |  ✅   | Account information    |
+| `InitializationResult`|     ✅      |   ❌    |  ✅   | Full init response     |
 | `McpSetServersResult` |     ✅      |   ❌    |  ✅   | Set servers result     |
 | `RewindFilesResult`   |     ✅      |   ✅    |  ✅   | Rewind result          |
 
@@ -306,14 +307,14 @@ Event-specific fields returned via `hookSpecificOutput`:
 | `permissionDecision`       |     ✅      |   ✅    |  ✅   | `allow`, `deny`, or `ask`          |
 | `permissionDecisionReason` |     ✅      |   ✅    |  ✅   | Reason for permission decision     |
 | `updatedInput`             |     ✅      |   ✅    |  ✅   | Modified tool input                |
-| `additionalContext`        |     ✅      |   ❌    |  ✅   | Context string returned to model   |
+| `additionalContext`        |     ✅      |   ✅    |  ✅   | Context string returned to model   |
 
 #### PostToolUseHookSpecificOutput
 
 | Field                  | TypeScript | Python | Ruby | Notes                            |
 |------------------------|:----------:|:------:|:----:|----------------------------------|
 | `additionalContext`    |     ✅      |   ✅    |  ✅   | Context string returned to model |
-| `updatedMCPToolOutput` |     ✅      |   ❌    |  ✅   | Modified MCP tool output         |
+| `updatedMCPToolOutput` |     ✅      |   ✅    |  ✅   | Modified MCP tool output         |
 
 #### PostToolUseFailureHookSpecificOutput
 
@@ -325,7 +326,7 @@ Event-specific fields returned via `hookSpecificOutput`:
 
 | Field               | TypeScript | Python | Ruby | Notes                            |
 |---------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 
 #### SetupHookSpecificOutput
 
@@ -337,7 +338,7 @@ Event-specific fields returned via `hookSpecificOutput`:
 
 | Field               | TypeScript | Python | Ruby | Notes                            |
 |---------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 
 #### UserPromptSubmitHookSpecificOutput
 
@@ -349,13 +350,13 @@ Event-specific fields returned via `hookSpecificOutput`:
 
 | Field      | TypeScript | Python | Ruby | Notes                                    |
 |------------|:----------:|:------:|:----:|------------------------------------------|
-| `decision` |     ✅      |   ❌    |  ✅   | `{ behavior: 'allow'/'deny', ... }` obj  |
+| `decision` |     ✅      |   ✅    |  ✅   | `{ behavior: 'allow'/'deny', ... }` obj  |
 
 #### NotificationHookSpecificOutput
 
 | Field               | TypeScript | Python | Ruby | Notes                            |
 |---------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 
 ### Hook Matcher
 
@@ -423,14 +424,15 @@ Permission handling and updates.
 
 ### ToolPermissionContext
 
-| Field            | TypeScript | Python | Ruby | Notes                     |
-|------------------|:----------:|:------:|:----:|---------------------------|
-| `signal`         |     ✅      |   ✅    |  ✅   | Abort signal              |
-| `suggestions`    |     ✅      |   ✅    |  ✅   | Permission suggestions    |
-| `blockedPath`    |     ✅      |   ❌    |  ✅   | Blocked file path         |
-| `decisionReason` |     ✅      |   ❌    |  ✅   | Why permission triggered  |
-| `toolUseID`      |     ✅      |   ❌    |  ✅   | Tool call ID              |
-| `agentID`        |     ✅      |   ❌    |  ✅   | Subagent ID if applicable |
+| Field            | TypeScript | Python | Ruby | Notes                           |
+|------------------|:----------:|:------:|:----:|---------------------------------|
+| `signal`         |     ✅      |   ✅    |  ✅   | Abort signal                    |
+| `suggestions`    |     ✅      |   ✅    |  ✅   | Permission suggestions          |
+| `blockedPath`    |     ✅      |   ❌    |  ✅   | Blocked file path               |
+| `decisionReason` |     ✅      |   ❌    |  ✅   | Why permission triggered        |
+| `toolUseID`      |     ✅      |   ❌    |  ✅   | Tool call ID                    |
+| `agentID`        |     ✅      |   ❌    |  ✅   | Subagent ID if applicable       |
+| `description`    |     ✅      |   ❌    |  ✅   | Human-readable tool description |
 
 ---
 
@@ -479,10 +481,10 @@ Model Context Protocol server support.
 
 | Feature              | TypeScript | Python |         Ruby         | Notes                    |
 |----------------------|:----------:|:------:|:--------------------:|--------------------------|
-| `createSdkMcpServer` |     ✅      |   ❌    |          ✅           | Create SDK server        |
-| `tool()` helper      |     ✅      |   ❌    |          ✅           | Create tool definition   |
-| Tool input schema    |  ✅ (Zod)   |   ❌    | ✅ (Hash/JSON Schema) | Schema definition        |
-| Tool annotations     |     ✅      |   ❌    |          ✅           | MCP tool hints (v0.2.27) |
+| `createSdkMcpServer` |     ✅      |   ✅    |          ✅           | Create SDK server        |
+| `tool()` helper      |     ✅      |   ✅    |          ✅           | Create tool definition   |
+| Tool input schema    |  ✅ (Zod)   |   ✅    | ✅ (Hash/JSON Schema) | Schema definition        |
+| Tool annotations     |     ✅      |   ✅    |          ✅           | MCP tool hints (v0.2.27) |
 
 ---
 
@@ -549,14 +551,15 @@ Sandbox configuration for command execution isolation.
 
 ### SandboxNetworkConfig
 
-| Field                 | TypeScript | Python | Ruby |
-|-----------------------|:----------:|:------:|:----:|
-| `allowedDomains`      |     ✅      |   ❌    |  ✅   |
-| `allowUnixSockets`    |     ✅      |   ✅    |  ✅   |
-| `allowAllUnixSockets` |     ✅      |   ✅    |  ✅   |
-| `allowLocalBinding`   |     ✅      |   ✅    |  ✅   |
-| `httpProxyPort`       |     ✅      |   ✅    |  ✅   |
-| `socksProxyPort`      |     ✅      |   ✅    |  ✅   |
+| Field                     | TypeScript | Python | Ruby |
+|---------------------------|:----------:|:------:|:----:|
+| `allowedDomains`          |     ✅      |   ❌    |  ✅   |
+| `allowManagedDomainsOnly` |     ✅      |   ❌    |  ✅   |
+| `allowUnixSockets`        |     ✅      |   ✅    |  ✅   |
+| `allowAllUnixSockets`     |     ✅      |   ✅    |  ✅   |
+| `allowLocalBinding`       |     ✅      |   ✅    |  ✅   |
+| `httpProxyPort`           |     ✅      |   ✅    |  ✅   |
+| `socksProxyPort`          |     ✅      |   ✅    |  ✅   |
 
 ---
 
@@ -618,6 +621,7 @@ Public API surface for SDK clients.
 | `reconnectMcpServer()`   |     ✅      |   ❌    |  ✅   | Reconnect MCP server   |
 | `toggleMcpServer()`      |     ✅      |   ❌    |  ✅   | Enable/disable MCP     |
 | `streamInput()`          |     ✅      |   ✅    |  ✅   | Stream user input      |
+| `initializationResult()` |     ✅      |   ❌    |  ✅   | Full init response     |
 | `close()`                |     ✅      |   ✅    |  ✅   | Close query/session    |
 
 ### Client Class
@@ -669,9 +673,11 @@ Public API surface for SDK clients.
 - Missing permission modes: `delegate`, `dontAsk`
 - Missing options: `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`
 - `ToolPermissionContext` missing `blockedPath`, `decisionReason`, `toolUseID`, `agentID`
+- Now has `additionalContext` in `PreToolUseHookSpecificOutput` (added in v0.1.30)
+- Now has `create_sdk_mcp_server`, `tool()` helper, and MCP tool annotations (added in v0.1.30)
 
 ### Ruby SDK (This Repository)
-- Full TypeScript SDK v0.2.31 feature parity
+- Full TypeScript SDK v0.2.32 feature parity
 - Ruby-idiomatic patterns (Data.define, snake_case)
 - Complete control protocol, hook, and V2 Session API support
 - Dedicated Client class for multi-turn conversations

data/lib/claude_agent/client.rb

@@ -268,6 +268,15 @@ module ClaudeAgent
       @protocol.account_info
     end
 
+    # Get full initialization result (TypeScript SDK parity)
+    #
+    # @return [InitializationResult]
+    def initialization_result
+      require_connection!
+
+      @protocol.initialization_result
+    end
+
     # Dynamically set MCP servers for this session (TypeScript SDK parity)
     #
     # This replaces the current set of dynamically-added MCP servers.

data/lib/claude_agent/control_protocol.rb

@@ -324,6 +324,51 @@ module ClaudeAgent
       end
     end
 
+    # Get full initialization result (TypeScript SDK parity)
+    #
+    # Sends the supported_commands request and maps the full response including
+    # commands, output style, available output styles, models, and account info.
+    #
+    # @return [InitializationResult]
+    def initialization_result
+      response = send_control_request(subtype: "supported_commands")
+
+      commands = (response["commands"] || []).map do |cmd|
+        SlashCommand.new(
+          name: cmd["name"],
+          description: cmd["description"],
+          argument_hint: cmd["argumentHint"]
+        )
+      end
+
+      models = (response["models"] || []).map do |model|
+        ModelInfo.new(
+          value: model["value"],
+          display_name: model["displayName"],
+          description: model["description"]
+        )
+      end
+
+      account_data = response["account"]
+      account = if account_data
+        AccountInfo.new(
+          email: account_data["email"],
+          organization: account_data["organization"],
+          subscription_type: account_data["subscriptionType"],
+          token_source: account_data["tokenSource"],
+          api_key_source: account_data["apiKeySource"]
+        )
+      end
+
+      InitializationResult.new(
+        commands: commands,
+        output_style: response["output_style"],
+        available_output_styles: response["available_output_styles"] || [],
+        models: models,
+        account: account
+      )
+    end
+
     # Get available models (TypeScript SDK parity)
     # @return [Array<ModelInfo>]
     def supported_models
@@ -536,7 +581,8 @@ module ClaudeAgent
         blocked_path: request["blocked_path"],
         decision_reason: request["decision_reason"],
         tool_use_id: request["tool_use_id"],
-        agent_id: request["agent_id"]
+        agent_id: request["agent_id"],
+        description: request["description"]
       }
 
       result = options.can_use_tool.call(tool_name, input, context)

data/lib/claude_agent/permissions.rb

@@ -156,7 +156,8 @@ module ClaudeAgent
     :decision_reason,
     :tool_use_id,
     :agent_id,
-    :signal
+    :signal,
+    :description
   ) do
     def initialize(
       permission_suggestions: nil,
@@ -164,7 +165,8 @@ module ClaudeAgent
       decision_reason: nil,
       tool_use_id: nil,
       agent_id: nil,
-      signal: nil
+      signal: nil,
+      description: nil
     )
       super
     end

data/lib/claude_agent/sandbox_settings.rb

@@ -15,6 +15,7 @@ module ClaudeAgent
     :allow_local_binding,
     :allow_unix_sockets,
     :allow_all_unix_sockets,
+    :allow_managed_domains_only,
     :http_proxy_port,
     :socks_proxy_port
   ) do
@@ -23,6 +24,7 @@ module ClaudeAgent
       allow_local_binding: false,
       allow_unix_sockets: [],
       allow_all_unix_sockets: false,
+      allow_managed_domains_only: false,
       http_proxy_port: nil,
       socks_proxy_port: nil
     )
@@ -35,6 +37,7 @@ module ClaudeAgent
       result[:allowLocalBinding] = allow_local_binding if allow_local_binding
       result[:allowUnixSockets] = allow_unix_sockets unless allow_unix_sockets.empty?
       result[:allowAllUnixSockets] = allow_all_unix_sockets if allow_all_unix_sockets
+      result[:allowManagedDomainsOnly] = allow_managed_domains_only if allow_managed_domains_only
       result[:httpProxyPort] = http_proxy_port if http_proxy_port
       result[:socksProxyPort] = socks_proxy_port if socks_proxy_port
       result

data/lib/claude_agent/types.rb

@@ -80,6 +80,23 @@ module ClaudeAgent
     end
   end
 
+  # Composite initialization result from supported_commands request (TypeScript SDK parity)
+  #
+  # @example
+  #   result = InitializationResult.new(
+  #     commands: [SlashCommand.new(name: "commit")],
+  #     output_style: "default",
+  #     available_output_styles: ["default", "concise"],
+  #     models: [ModelInfo.new(value: "claude-sonnet")],
+  #     account: AccountInfo.new(email: "user@example.com")
+  #   )
+  #
+  InitializationResult = Data.define(:commands, :output_style, :available_output_styles, :models, :account) do
+    def initialize(commands: [], output_style: nil, available_output_styles: [], models: [], account: nil)
+      super
+    end
+  end
+
   # Per-model usage statistics returned in result messages (TypeScript SDK parity)
   #
   # @example

data/lib/claude_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeAgent
-  VERSION = "0.7.1"
+  VERSION = "0.7.2"
 end

data/sig/claude_agent.rbs

@@ -114,6 +114,16 @@ module ClaudeAgent
     def initialize: (?email: String?, ?organization: String?, ?subscription_type: String?, ?token_source: String?, ?api_key_source: String?) -> void
   end
 
+  class InitializationResult
+    attr_reader commands: Array[SlashCommand]
+    attr_reader output_style: String?
+    attr_reader available_output_styles: Array[String]
+    attr_reader models: Array[ModelInfo]
+    attr_reader account: AccountInfo?
+
+    def initialize: (?commands: Array[SlashCommand], ?output_style: String?, ?available_output_styles: Array[String], ?models: Array[ModelInfo], ?account: AccountInfo?) -> void
+  end
+
   class ModelUsage
     attr_reader input_tokens: Integer
     attr_reader output_tokens: Integer
@@ -175,10 +185,11 @@ module ClaudeAgent
     attr_reader allow_local_binding: bool
     attr_reader allow_unix_sockets: Array[String]
     attr_reader allow_all_unix_sockets: bool
+    attr_reader allow_managed_domains_only: bool
     attr_reader http_proxy_port: Integer?
     attr_reader socks_proxy_port: Integer?
 
-    def initialize: (?allowed_domains: Array[String], ?allow_local_binding: bool, ?allow_unix_sockets: Array[String], ?allow_all_unix_sockets: bool, ?http_proxy_port: Integer?, ?socks_proxy_port: Integer?) -> void
+    def initialize: (?allowed_domains: Array[String], ?allow_local_binding: bool, ?allow_unix_sockets: Array[String], ?allow_all_unix_sockets: bool, ?allow_managed_domains_only: bool, ?http_proxy_port: Integer?, ?socks_proxy_port: Integer?) -> void
     def to_h: () -> Hash[Symbol, untyped]
   end
 
@@ -810,8 +821,9 @@ module ClaudeAgent
     attr_reader tool_use_id: String?
     attr_reader agent_id: String?
     attr_reader signal: AbortSignal?
+    attr_reader description: String?
 
-    def initialize: (?permission_suggestions: untyped, ?blocked_path: String?, ?decision_reason: String?, ?tool_use_id: String?, ?agent_id: String?, ?signal: AbortSignal?) -> void
+    def initialize: (?permission_suggestions: untyped, ?blocked_path: String?, ?decision_reason: String?, ?tool_use_id: String?, ?agent_id: String?, ?signal: AbortSignal?, ?description: String?) -> void
   end
 
   # Client
@@ -847,6 +859,7 @@ module ClaudeAgent
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
+    def initialization_result: () -> InitializationResult
   end
 
   # Control protocol
@@ -882,6 +895,7 @@ module ClaudeAgent
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
+    def initialization_result: () -> InitializationResult
   end
 
   # Transport layer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_agent
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.7.2
 platform: ruby
 authors:
 - Thomas Carr