claude_agent 0.7.7 → 0.7.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d3e15e24cc94819c7790d628776f0f04aee71592ae3b2eff9daa40b47941302
-  data.tar.gz: 9b60ffaf27391f41168549ac9bb878a9d184f4edf0144916b268e79855dddc65
+  metadata.gz: e9304128d18cec59aa0b0221f199b2674d60a5a2813141562b9df51b88057987
+  data.tar.gz: 8bd6696b854f8660e21744bc02d178e3e402a734119554c2869cc4fbb188a75d
 SHA512:
-  metadata.gz: '084b53215d8f9f9d95f2084d6c7b0e10a845bd028ad5e466ce7c822e245351b59916782f36591ab0f0088f996d27c127221843a603217bc2eb7adf569708aa85'
-  data.tar.gz: 1b30bec791d154c017daee5aa6ca93df25da998a19382554aae3610962c447294cce76bbdb96737614f7334bdc73cd3be148a3a8138bfa50bf9ef8d130a05f3d
+  metadata.gz: 8ad2321250e0967d302d41d23724fe6f368f3e8fe6cb4461f483f6d13d3b9b35368189cce06dd28f5fa427013a9a272c6a4e1b3e94ee75b8a38dd7ed422c5068
+  data.tar.gz: d17257cfcabecbb033ce1427a0237456e5ecbeb0c1c3bedb9bc21dac1336be6a21b96a85ffc96919f7c4774a3f51498a4876f31d11249a05f327966af23f0ae8

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.8] - 2026-02-22
+
+### Added
+- `WorktreeCreate` hook event with `WorktreeCreateInput` class (TypeScript SDK v0.2.50 parity)
+- `WorktreeRemove` hook event with `WorktreeRemoveInput` class (TypeScript SDK v0.2.50 parity)
+- `apply_flag_settings` control request on `ControlProtocol` and `Client` for merging settings into the flag layer (TypeScript SDK v0.2.50 parity)
+- RBS signatures for all new types
+
 ## [0.7.7] - 2026-02-20
 
 ### 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.49 (npm package)
+- TypeScript SDK: v0.2.50 (npm package)
 - Python SDK: v0.1.39 from GitHub (commit 146e3d6)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-02-20
+**Last Updated:** 2026-02-22
 
 ---
 
@@ -235,6 +235,7 @@ Bidirectional control protocol for SDK-CLI communication.
 | `supported_commands`      |     ✅      |   ❌    |  ✅   | Get available slash commands      |
 | `supported_models`        |     ✅      |   ❌    |  ✅   | Get available models              |
 | `account_info`            |     ✅      |   ❌    |  ✅   | Get account information           |
+| `apply_flag_settings`     |     ✅      |   ❌    |  ✅   | Merge settings into flag layer    |
 
 ### Return Types
 
@@ -274,6 +275,8 @@ Event hooks for intercepting and modifying SDK behavior.
 | `TeammateIdle`       |     ✅      |   ❌    |  ✅   | Teammate idle (v0.2.33)           |
 | `TaskCompleted`      |     ✅      |   ❌    |  ✅   | Task completed (v0.2.33)          |
 | `ConfigChange`       |     ✅      |   ❌    |  ✅   | Config file changed (v0.2.49)     |
+| `WorktreeCreate`     |     ✅      |   ❌    |  ✅   | Worktree creation (v0.2.50)       |
+| `WorktreeRemove`     |     ✅      |   ❌    |  ✅   | Worktree removal (v0.2.50)        |
 
 ### Hook Input Types
 
@@ -295,6 +298,8 @@ Event hooks for intercepting and modifying SDK behavior.
 | `TeammateIdleHookInput`       |     ✅      |   ❌    |  ✅   |
 | `TaskCompletedHookInput`      |     ✅      |   ❌    |  ✅   |
 | `ConfigChangeHookInput`       |     ✅      |   ❌    |  ✅   |
+| `WorktreeCreateHookInput`     |     ✅      |   ❌    |  ✅   |
+| `WorktreeRemoveHookInput`     |     ✅      |   ❌    |  ✅   |
 
 ### Hook Output Types
 
@@ -690,11 +695,12 @@ Public API surface for SDK clients.
 - v0.2.45: Added `TaskStartedMessage`, `RateLimitEvent` message types
 - v0.2.47: Added `promptSuggestions` option and `PromptSuggestionMessage`
 - v0.2.49: Added `ConfigChange` hook event, `SandboxFilesystemConfig`
+- v0.2.50: Added `WorktreeCreate`/`WorktreeRemove` hook events, `apply_flag_settings` control request
 
 ### Python SDK
 - Full source available with `Transport` abstract class
 - Partial control protocol: query and client support interrupt, setPermissionMode, setModel, rewindFiles, mcpStatus
-- Missing hooks: SessionStart, SessionEnd, Setup, TeammateIdle, TaskCompleted, ConfigChange
+- Missing hooks: SessionStart, SessionEnd, Setup, TeammateIdle, TaskCompleted, ConfigChange, WorktreeCreate, WorktreeRemove
 - Missing permission modes: `dontAsk`
 - Missing options: `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `sessionId`, `strictMcpConfig`, `init`/`initOnly`/`maintenance`, `debug`/`debugFile`, `promptSuggestions`
 - `ToolPermissionContext` missing `blockedPath`, `decisionReason`, `toolUseID`, `agentID`, `description`
@@ -703,9 +709,8 @@ Public API surface for SDK clients.
 - Handles `rate_limit_event` and unknown message types gracefully (v0.1.39)
 
 ### Ruby SDK (This Repository)
-- Feature parity with TypeScript SDK v0.2.42
+- Feature parity with TypeScript SDK v0.2.50
 - Ruby-idiomatic patterns (Data.define, snake_case)
 - Complete control protocol, hook, and V2 Session API support
 - Dedicated Client class for multi-turn conversations
 - `executable`/`executableArgs` marked N/A (JS runtime options)
-- Gaps from TS v0.2.43-v0.2.49: `promptSuggestions`, `TaskStartedMessage`, `RateLimitEvent`, `PromptSuggestionMessage`, `ConfigChange` hook, `SandboxFilesystemConfig`

data/lib/claude_agent/client.rb

@@ -298,6 +298,22 @@ module ClaudeAgent
       @protocol.stop_task(task_id)
     end
 
+    # Apply flag settings (TypeScript SDK v0.2.50 parity)
+    #
+    # Merges the provided settings into the flag settings layer.
+    #
+    # @param settings [Hash] Settings to merge into the flag layer
+    # @return [Hash] Response from the CLI
+    #
+    # @example
+    #   client.apply_flag_settings({ "model" => "claude-sonnet-4-5-20250514" })
+    #
+    def apply_flag_settings(settings)
+      require_connection!
+
+      @protocol.apply_flag_settings(settings)
+    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

@@ -458,6 +458,20 @@ module ClaudeAgent
       send_control_request(subtype: "stop_task", task_id: task_id)
     end
 
+    # Apply flag settings (TypeScript SDK v0.2.50 parity)
+    #
+    # Merges the provided settings into the flag settings layer.
+    #
+    # @param settings [Hash] Settings to merge into the flag layer
+    # @return [Hash] Response from the CLI
+    #
+    # @example
+    #   protocol.apply_flag_settings({ "model" => "claude-sonnet-4-5-20250514" })
+    #
+    def apply_flag_settings(settings)
+      send_control_request(subtype: "apply_flag_settings", settings: settings)
+    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/hooks.rb

@@ -19,6 +19,8 @@ module ClaudeAgent
     TeammateIdle
     TaskCompleted
     ConfigChange
+    WorktreeCreate
+    WorktreeRemove
   ].freeze
 
   # Matcher configuration for hooks
@@ -304,6 +306,34 @@ module ClaudeAgent
     end
   end
 
+  # Input for WorktreeCreate hook (TypeScript SDK v0.2.50 parity)
+  #
+  # Fired when a worktree is created.
+  #
+  class WorktreeCreateInput < BaseHookInput
+    attr_reader :name
+
+    # @param name [String] Worktree name
+    def initialize(name:, **kwargs)
+      super(hook_event_name: "WorktreeCreate", **kwargs)
+      @name = name
+    end
+  end
+
+  # Input for WorktreeRemove hook (TypeScript SDK v0.2.50 parity)
+  #
+  # Fired when a worktree is removed.
+  #
+  class WorktreeRemoveInput < BaseHookInput
+    attr_reader :worktree_path
+
+    # @param worktree_path [String] Path to the worktree
+    def initialize(worktree_path:, **kwargs)
+      super(hook_event_name: "WorktreeRemove", **kwargs)
+      @worktree_path = worktree_path
+    end
+  end
+
   # Input for TaskCompleted hook (TypeScript SDK v0.2.33 parity)
   #
   # Fired when a task completes.

data/lib/claude_agent/version.rb

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

data/sig/claude_agent.rbs

@@ -879,6 +879,18 @@ module ClaudeAgent
     def initialize: (source: String, ?file_path: String?, **untyped) -> void
   end
 
+  class WorktreeCreateInput < BaseHookInput
+    attr_reader name: String
+
+    def initialize: (name: String, **untyped) -> void
+  end
+
+  class WorktreeRemoveInput < BaseHookInput
+    attr_reader worktree_path: String
+
+    def initialize: (worktree_path: String, **untyped) -> void
+  end
+
   # Permission types
   type permission_result = PermissionResultAllow | PermissionResultDeny
 
@@ -967,6 +979,7 @@ module ClaudeAgent
     def mcp_reconnect: (String server_name) -> Hash[String, untyped]
     def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
     def stop_task: (String task_id) -> Hash[String, untyped]
+    def apply_flag_settings: (Hash[String, untyped] settings) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
@@ -1004,6 +1017,7 @@ module ClaudeAgent
     def mcp_reconnect: (String server_name) -> Hash[String, untyped]
     def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
     def stop_task: (String task_id) -> Hash[String, untyped]
+    def apply_flag_settings: (Hash[String, untyped] settings) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]

metadata

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