RubyGems - claude_agent - Versions diffs - 0.4.3 → 0.6.0 - Mend

claude_agent 0.4.3 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +19 -0
data/SPEC.md +117 -59
data/lib/claude_agent/client.rb +36 -0
data/lib/claude_agent/control_protocol.rb +32 -0
data/lib/claude_agent/message_parser.rb +55 -2
data/lib/claude_agent/messages.rb +191 -4
data/lib/claude_agent/version.rb +1 -1
data/sig/claude_agent.rbs +78 -2
metadata +1 -1

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5fe04480d4ac9e3510d30da98968e5775161e41fad4bdea29cf57b057c98a23
-  data.tar.gz: 1aca1e25aadbde128676a0182648df8fb8b6da1e81db8a82d1ea82d035ff00d5
+  metadata.gz: 4d11f6fa8fa6ecc4b00e0bb6f7913582d0ac8675f649f2d5b423306660a44247
+  data.tar.gz: 1c7259588ea2b823ad06c7f263830418a590b5488c7db3d9d825b3e46b31495a
 SHA512:
-  metadata.gz: 4c657079b59bcd095f3216f99da72d14f326df8b44cab8deb9d618bcf22c589978d319e75d33c4bc8876a81deb77e89f93a28b9d45a08f95e37952a05cf753f0
-  data.tar.gz: 9992a0c69e842bd7fd11556b00c8944ff69eb14d418cd8b2cb81ce36cf8cdd74d46f58bd08651e47f028e3b9fe35d98c16bb52f9b3953b513781b1070d426ee5
+  metadata.gz: e57643b8293c0cba79fb96322daa1c8fd08a068664f63bad5a6787f9731e60232ff0ee806698ff79707c4a000dd600bfc1e459ea9a0933e7685e5b5fefd87911
+  data.tar.gz: 6ac435262b2489ef696db91db6440e8df9f8000e09a46b97cc80decdda1b04cedfcd561a6d56e8b09aa8d373fa223f1ecdad2ff08f82ba9ea350375dd5772eed

data/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [0.6.0] - 2026-01-30
+### Added
+- `FilesPersistedEvent` message type for file persistence confirmation (TypeScript SDK v0.2.25 parity)
+- `claudeai-proxy` MCP server type support via Hash-based config passthrough
+### Changed
+- Updated SPEC.md to reference TypeScript SDK v0.2.25 and Python SDK v0.1.25
+## [0.5.0] - 2026-01-25
+### Added
+- `HookStartedMessage` for hook lifecycle visibility
+- `HookProgressMessage` for hook progress updates
+- `ToolUseSummaryMessage` for tool use summaries
+- `mcp_reconnect` and `mcp_toggle` control methods for MCP server lifecycle management
+- `hook_id`, `output`, and `outcome` fields on `HookResponseMessage`
+- Helper methods on `HookResponseMessage`: `success?`, `error?`, `cancelled?`
 ## [0.4.3] - 2026-01-18
 ### Changed

data/SPEC.md CHANGED Viewed

@@ -3,10 +3,12 @@
 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.12 (npm package)
-- Python SDK: v0.1.20 from GitHub (commit 05d2eb4)
+- TypeScript SDK: v0.2.25 (npm package)
+- Python SDK: v0.1.25 from GitHub (commit 1bf665c)
 - Ruby SDK: This repository
+**Last Updated:** 2026-01-30
 ---
 ## Table of Contents
@@ -58,15 +60,15 @@ Configuration options for SDK queries and clients.
 | `strictMcpConfig`                 |     ✅      |   ❌    |  ✅   | Strict validation of MCP config                              |
 | `hooks`                           |     ✅      |   ✅    |  ✅   | Hook callbacks                                               |
 | `agents`                          |     ✅      |   ✅    |  ✅   | Custom subagent definitions                                  |
+| `agent`                           |     ✅      |   ❌    |  ✅   | Agent name for main thread                                   |
 | `cwd`                             |     ✅      |   ✅    |  ✅   | Working directory                                            |
 | `additionalDirectories`           |     ✅      |   ✅    |  ✅   | Extra allowed directories                                    |
 | `env`                             |     ✅      |   ✅    |  ✅   | Environment variables                                        |
 | `sandbox`                         |     ✅      |   ✅    |  ✅   | Sandbox settings                                             |
-| `settings`                        |     ✅      |   ❌    |  ✅   | Settings file path or JSON string (e.g., plansDirectory)     |
+| `settings`                        |     ✅      |   ✅    |  ✅   | Settings file path or JSON string (e.g., plansDirectory)     |
 | `settingSources`                  |     ✅      |   ✅    |  ✅   | Which settings to load                                       |
 | `plugins`                         |     ✅      |   ✅    |  ✅   | Plugin configurations                                        |
 | `betas`                           |     ✅      |   ✅    |  ✅   | Beta features (e.g., context-1m-2025-08-07)                  |
-| `agent`                           |     ✅      |   ❌    |  ✅   | Agent name for main thread                                   |
 | `abortController`                 |     ✅      |   ❌    |  ✅   | Cancellation controller                                      |
 | `stderr`                          |     ✅      |   ✅    |  ✅   | Stderr callback                                              |
 | `spawnClaudeCodeProcess`          |     ✅      |   ❌    |  ✅   | Custom spawn function                                        |
@@ -85,20 +87,24 @@ Configuration options for SDK queries and clients.
 Messages exchanged between SDK and CLI.
-| Message Type             | TypeScript | Python | Ruby | Notes                           |
-|--------------------------|:----------:|:------:|:----:|---------------------------------|
-| `UserMessage`            |     ✅      |   ✅    |  ✅   | User input                      |
-| `UserMessageReplay`      |     ✅      |   ❌    |  ✅   | Replayed user message on resume |
-| `AssistantMessage`       |     ✅      |   ✅    |  ✅   | Claude response                 |
-| `SystemMessage`          |     ✅      |   ✅    |  ✅   | System/init messages            |
-| `ResultMessage`          |     ✅      |   ✅    |  ✅   | Final result with usage         |
-| `StreamEvent`            |     ✅      |   ✅    |  ✅   | Partial streaming events        |
-| `CompactBoundaryMessage` |     ✅      |   ❌    |  ✅   | Conversation compaction marker  |
-| `StatusMessage`          |     ✅      |   ❌    |  ✅   | Status updates (compacting)     |
-| `ToolProgressMessage`    |     ✅      |   ❌    |  ✅   | Long-running tool progress      |
-| `HookResponseMessage`    |     ✅      |   ❌    |  ✅   | Hook execution output           |
-| `AuthStatusMessage`      |     ✅      |   ❌    |  ✅   | Authentication status           |
-| `TaskNotificationMessage`|     ✅      |   ❌    |  ✅   | Background task completion      |
+| Message Type              | TypeScript | Python | Ruby | Notes                              |
+|---------------------------|:----------:|:------:|:----:|------------------------------------|
+| `UserMessage`             |     ✅      |   ✅    |  ✅   | User input                         |
+| `UserMessageReplay`       |     ✅      |   ❌    |  ✅   | Replayed user message on resume    |
+| `AssistantMessage`        |     ✅      |   ✅    |  ✅   | Claude response                    |
+| `SystemMessage`           |     ✅      |   ✅    |  ✅   | System/init messages               |
+| `ResultMessage`           |     ✅      |   ✅    |  ✅   | Final result with usage            |
+| `StreamEvent`             |     ✅      |   ✅    |  ✅   | Partial streaming events           |
+| `CompactBoundaryMessage`  |     ✅      |   ❌    |  ✅   | Conversation compaction marker     |
+| `StatusMessage`           |     ✅      |   ❌    |  ✅   | Status updates (compacting)        |
+| `ToolProgressMessage`     |     ✅      |   ❌    |  ✅   | Long-running tool progress         |
+| `HookStartedMessage`      |     ✅      |   ❌    |  ✅   | Hook execution started             |
+| `HookProgressMessage`     |     ✅      |   ❌    |  ✅   | Hook progress during execution     |
+| `HookResponseMessage`     |     ✅      |   ❌    |  ✅   | Hook execution output              |
+| `AuthStatusMessage`       |     ✅      |   ❌    |  ✅   | Authentication status              |
+| `TaskNotificationMessage` |     ✅      |   ❌    |  ✅   | Background task completion         |
+| `ToolUseSummaryMessage`   |     ✅      |   ❌    |  ✅   | Summary of tool use (collapsed)    |
+| `FilesPersistedEvent`     |     ✅      |   ❌    |  ✅   | File persistence confirmation      |
 ### Message Fields
@@ -131,6 +137,34 @@ Messages exchanged between SDK and CLI.
 | `error_max_budget_usd`                |     ✅      |   ✅    |  ✅   | Budget exceeded                    |
 | `error_max_structured_output_retries` |     ✅      |   ❌    |  ✅   | Structured output retries exceeded |
+#### HookResponseMessage Fields
+| Field        | TypeScript | Python | Ruby | Notes                                    |
+|--------------|:----------:|:------:|:----:|------------------------------------------|
+| `uuid`       |     ✅      |   ❌    |  ✅   | Message UUID                             |
+| `session_id` |     ✅      |   ❌    |  ✅   | Session ID                               |
+| `hook_id`    |     ✅      |   ❌    |  ✅   | Unique hook execution ID                 |
+| `hook_name`  |     ✅      |   ❌    |  ✅   | Hook name                                |
+| `hook_event` |     ✅      |   ❌    |  ✅   | Event type (PreToolUse, PostToolUse...)  |
+| `output`     |     ✅      |   ❌    |  ✅   | Combined output string                   |
+| `stdout`     |     ✅      |   ❌    |  ✅   | Standard output                          |
+| `stderr`     |     ✅      |   ❌    |  ✅   | Standard error                           |
+| `exit_code`  |     ✅      |   ❌    |  ✅   | Hook process exit code                   |
+| `outcome`    |     ✅      |   ❌    |  ✅   | 'success' / 'error' / 'cancelled'        |
+#### HookProgressMessage Fields
+| Field        | TypeScript | Python | Ruby | Notes                                    |
+|--------------|:----------:|:------:|:----:|------------------------------------------|
+| `uuid`       |     ✅      |   ❌    |  ✅   | Message UUID                             |
+| `session_id` |     ✅      |   ❌    |  ✅   | Session ID                               |
+| `hook_id`    |     ✅      |   ❌    |  ✅   | Unique hook execution ID                 |
+| `hook_name`  |     ✅      |   ❌    |  ✅   | Hook name                                |
+| `hook_event` |     ✅      |   ❌    |  ✅   | Event type                               |
+| `output`     |     ✅      |   ❌    |  ✅   | Combined output so far                   |
+| `stdout`     |     ✅      |   ❌    |  ✅   | Standard output so far                   |
+| `stderr`     |     ✅      |   ❌    |  ✅   | Standard error so far                    |
 ---
 ## 3. Content Blocks
@@ -179,12 +213,14 @@ Bidirectional control protocol for SDK-CLI communication.
 | `can_use_tool`            |     ✅      |   ✅    |  ✅   | Permission callback               |
 | `hook_callback`           |     ✅      |   ✅    |  ✅   | Execute hook callback             |
 | `set_permission_mode`     |     ✅      |   ✅    |  ✅   | Change permission mode            |
-| `set_model`               |     ✅      |   ❌    |  ✅   | Change model                      |
+| `set_model`               |     ✅      |   ✅    |  ✅   | Change model                      |
 | `set_max_thinking_tokens` |     ✅      |   ❌    |  ✅   | Change thinking tokens limit      |
 | `rewind_files`            |     ✅      |   ✅    |  ✅   | Rewind file checkpoints           |
 | `mcp_message`             |     ✅      |   ✅    |  ✅   | Route MCP message                 |
 | `mcp_set_servers`         |     ✅      |   ❌    |  ✅   | Dynamically set MCP servers       |
-| `mcp_status`              |     ✅      |   ❌    |  ✅   | Get MCP server status             |
+| `mcp_status`              |     ✅      |   ✅    |  ✅   | Get MCP server status             |
+| `mcp_reconnect`           |     ✅      |   ❌    |  ✅   | Reconnect to MCP server           |
+| `mcp_toggle`              |     ✅      |   ❌    |  ✅   | Enable/disable MCP server         |
 | `supported_commands`      |     ✅      |   ❌    |  ✅   | Get available slash commands      |
 | `supported_models`        |     ✅      |   ❌    |  ✅   | Get available models              |
 | `account_info`            |     ✅      |   ❌    |  ✅   | Get account information           |
@@ -212,7 +248,7 @@ Event hooks for intercepting and modifying SDK behavior.
 |----------------------|:----------:|:------:|:----:|---------------------------|
 | `PreToolUse`         |     ✅      |   ✅    |  ✅   | Before tool execution     |
 | `PostToolUse`        |     ✅      |   ✅    |  ✅   | After tool execution      |
-| `PostToolUseFailure` |     ✅      |   ❌    |  ✅   | After tool failure        |
+| `PostToolUseFailure` |     ✅      |   ✅    |  ✅   | After tool failure        |
 | `Notification`       |     ✅      |   ❌    |  ✅   | System notifications      |
 | `UserPromptSubmit`   |     ✅      |   ✅    |  ✅   | User message submitted    |
 | `SessionStart`       |     ✅      |   ❌    |  ✅   | Session starts            |
@@ -230,7 +266,7 @@ Event hooks for intercepting and modifying SDK behavior.
 |-------------------------------|:----------:|:------:|:----:|
 | `PreToolUseHookInput`         |     ✅      |   ✅    |  ✅   |
 | `PostToolUseHookInput`        |     ✅      |   ✅    |  ✅   |
-| `PostToolUseFailureHookInput` |     ✅      |   ❌    |  ✅   |
+| `PostToolUseFailureHookInput` |     ✅      |   ✅    |  ✅   |
 | `NotificationHookInput`       |     ✅      |   ❌    |  ✅   |
 | `UserPromptSubmitHookInput`   |     ✅      |   ✅    |  ✅   |
 | `SessionStartHookInput`       |     ✅      |   ❌    |  ✅   |
@@ -264,8 +300,8 @@ Event-specific fields returned via `hookSpecificOutput`:
 | Field                      | TypeScript | Python | Ruby | Notes                              |
 |----------------------------|:----------:|:------:|:----:|------------------------------------|
-| `permissionDecision`       |     ✅      |   ❌    |  ✅   | `allow`, `deny`, or `ask`          |
-| `permissionDecisionReason` |     ✅      |   ❌    |  ✅   | Reason for permission decision     |
+| `permissionDecision`       |     ✅      |   ✅    |  ✅   | `allow`, `deny`, or `ask`          |
+| `permissionDecisionReason` |     ✅      |   ✅    |  ✅   | Reason for permission decision     |
 | `updatedInput`             |     ✅      |   ✅    |  ✅   | Modified tool input                |
 | `additionalContext`        |     ✅      |   ❌    |  ✅   | Context string returned to model   |
@@ -273,14 +309,14 @@ Event-specific fields returned via `hookSpecificOutput`:
 | Field                  | TypeScript | Python | Ruby | Notes                            |
 |------------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext`    |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext`    |     ✅      |   ✅    |  ✅   | Context string returned to model |
 | `updatedMCPToolOutput` |     ✅      |   ❌    |  ✅   | Modified MCP tool output         |
 #### PostToolUseFailureHookSpecificOutput
 | Field               | TypeScript | Python | Ruby | Notes                            |
 |---------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 #### SessionStartHookSpecificOutput
@@ -304,7 +340,7 @@ Event-specific fields returned via `hookSpecificOutput`:
 | Field               | TypeScript | Python | Ruby | Notes                            |
 |---------------------|:----------:|:------:|:----:|----------------------------------|
-| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
+| `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 #### PermissionRequestHookSpecificOutput
@@ -312,6 +348,12 @@ Event-specific fields returned via `hookSpecificOutput`:
 |------------|:----------:|:------:|:----:|------------------------------------------|
 | `decision` |     ✅      |   ❌    |  ✅   | `{ behavior: 'allow'/'deny', ... }` obj  |
+#### NotificationHookSpecificOutput
+| Field               | TypeScript | Python | Ruby | Notes                            |
+|---------------------|:----------:|:------:|:----:|----------------------------------|
+| `additionalContext` |     ✅      |   ❌    |  ✅   | Context string returned to model |
 ### Hook Matcher
 | Field                 | TypeScript | Python | Ruby |
@@ -395,12 +437,13 @@ Model Context Protocol server support.
 ### MCP Server Types
-| Type    | TypeScript | Python | Ruby | Notes                 |
-|---------|:----------:|:------:|:----:|-----------------------|
-| `stdio` |     ✅      |   ✅    |  ✅   | Subprocess with stdio |
-| `sse`   |     ✅      |   ✅    |  ✅   | Server-sent events    |
-| `http`  |     ✅      |   ✅    |  ✅   | HTTP transport        |
-| `sdk`   |     ✅      |   ✅    |  ✅   | In-process SDK server |
+| Type             | TypeScript | Python | Ruby | Notes                            |
+|------------------|:----------:|:------:|:----:|----------------------------------|
+| `stdio`          |     ✅      |   ✅    |  ✅   | Subprocess with stdio            |
+| `sse`            |     ✅      |   ✅    |  ✅   | Server-sent events               |
+| `http`           |     ✅      |   ✅    |  ✅   | HTTP transport                   |
+| `sdk`            |     ✅      |   ✅    |  ✅   | In-process SDK server            |
+| `claudeai-proxy` |     ✅      |   ❌    |  ✅   | Claude.ai proxy server (managed) |
 ### MCP Server Config Fields
@@ -554,40 +597,41 @@ Public API surface for SDK clients.
 | One-shot query function | ✅ `query()` | ✅ `query()` | ✅ `ClaudeAgent.query()` | Simple prompts     |
 | Returns async generator |      ✅      |      ✅      |     ✅ (Enumerator)      | Streaming messages |
-### Query Control Methods (TypeScript)
+### Query Control Methods
 | Method                   | TypeScript | Python | Ruby | Notes                  |
 |--------------------------|:----------:|:------:|:----:|------------------------|
-| `interrupt()`            |     ✅      |   ❌    |  ✅   | Interrupt execution    |
-| `setPermissionMode()`    |     ✅      |   ❌    |  ✅   | Change permission mode |
-| `setModel()`             |     ✅      |   ❌    |  ✅   | Change model           |
+| `interrupt()`            |     ✅      |   ✅    |  ✅   | Interrupt execution    |
+| `setPermissionMode()`    |     ✅      |   ✅    |  ✅   | Change permission mode |
+| `setModel()`             |     ✅      |   ✅    |  ✅   | Change model           |
 | `setMaxThinkingTokens()` |     ✅      |   ❌    |  ✅   | Set thinking limit     |
 | `supportedCommands()`    |     ✅      |   ❌    |  ✅   | Get slash commands     |
 | `supportedModels()`      |     ✅      |   ❌    |  ✅   | Get available models   |
-| `mcpServerStatus()`      |     ✅      |   ❌    |  ✅   | Get MCP status         |
+| `mcpServerStatus()`      |     ✅      |   ✅    |  ✅   | Get MCP status         |
 | `accountInfo()`          |     ✅      |   ❌    |  ✅   | Get account info       |
 | `rewindFiles()`          |     ✅      |   ✅    |  ✅   | Rewind file changes    |
 | `setMcpServers()`        |     ✅      |   ❌    |  ✅   | Dynamic MCP servers    |
-| `streamInput()`          |     ✅      |   ❌    |  ✅   | Stream user input      |
+| `streamInput()`          |     ✅      |   ✅    |  ✅   | Stream user input      |
+| `close()`                |     ✅      |   ✅    |  ✅   | Close query/session    |
 ### Client Class
-| Feature              | TypeScript |       Python        |          Ruby           | Notes                          |
-|----------------------|:----------:|:-------------------:|:-----------------------:|--------------------------------|
-| Multi-turn client    |     ❌      | ✅ `ClaudeSDKClient` | ✅ `ClaudeAgent::Client` | Interactive sessions           |
-| `connect()`          |    N/A     |          ✅          |            ✅            | Start session                  |
-| `disconnect()`       |    N/A     |          ✅          |            ✅            | End session                    |
-| `send_message()`     |    N/A     |          ✅          |            ✅            | Send user message              |
-| `receive_response()` |    N/A     |          ✅          |            ✅            | Receive until result           |
-| `stream_input()`     |    N/A     |          ❌          |            ✅            | Stream input messages          |
-| `abort!()`           |    N/A     |          ❌          |            ✅            | Abort operations               |
-| Control methods      |    N/A     |       Partial       |            ✅            | All TypeScript control methods |
+| Feature              | TypeScript |       Python        |          Ruby           | Notes                                                                            |
+|----------------------|:----------:|:-------------------:|:-----------------------:|----------------------------------------------------------------------------------|
+| Multi-turn client    |     ❌      | ✅ `ClaudeSDKClient` | ✅ `ClaudeAgent::Client` | Interactive sessions                                                             |
+| `connect()`          |    N/A     |          ✅          |            ✅            | Start session                                                                    |
+| `disconnect()`       |    N/A     |          ✅          |            ✅            | End session                                                                      |
+| `send_message()`     |    N/A     |          ✅          |            ✅            | Send user message                                                                |
+| `receive_response()` |    N/A     |          ✅          |            ✅            | Receive until result                                                             |
+| `stream_input()`     |    N/A     |          ❌          |            ✅            | Stream input messages                                                            |
+| `abort!()`           |    N/A     |          ❌          |            ✅            | Abort operations                                                                 |
+| Control methods      |    N/A     |       Partial       |            ✅            | interrupt, setPermissionMode, setModel, rewindFiles (Python); all methods (Ruby) |
 ### Transport
 | Feature               | TypeScript | Python | Ruby | Notes                    |
 |-----------------------|:----------:|:------:|:----:|--------------------------|
-| `Transport` interface |     ✅      |   ❌    |  ✅   | Transport abstraction    |
+| `Transport` interface |     ✅      |   ✅    |  ✅   | Transport abstraction    |
 | Process transport     |     ✅      |   ✅    |  ✅   | Subprocess communication |
 | Custom spawn          |     ✅      |   ❌    |  ✅   | VM/container support     |
@@ -611,24 +655,38 @@ Public API surface for SDK clients.
 - Adds `deno` as supported executable option
 - Includes experimental `criticalSystemReminder_EXPERIMENTAL` for agent definitions
 - `SessionStartHookInput` includes `model` field
-- v0.2.12 adds `Setup` hook event for init/maintenance
-- v0.2.12 adds `skills` and `maxTurns` to AgentDefinition
-- v0.2.12 adds `TaskNotificationMessage` for background task completion
-- v0.2.12 adds `user` option to SDKSessionOptions
+- v0.2.12+ adds `Setup` hook event for init/maintenance
+- v0.2.12+ adds `skills` and `maxTurns` to AgentDefinition
+- v0.2.12+ adds `TaskNotificationMessage` for background task completion
+- v0.2.12+ adds `user` option to SDKSessionOptions
+- v0.2.19 adds `mcp_reconnect` and `mcp_toggle` control requests
+- v0.2.19 adds `HookStartedMessage`, `HookProgressMessage`, and `ToolUseSummaryMessage`
+- v0.2.25 adds `SDKFilesPersistedEvent` message type for file persistence confirmation
+- v0.2.25 adds `McpClaudeAIProxyServerConfig` (`claudeai-proxy` type) for managed proxy servers
 ### Python SDK
-- Full source available (v0.1.20)
-- Fewer control protocol features than TypeScript
-- Does not support SessionStart/SessionEnd/Notification hooks due to setup limitations
+- Full source available (v0.1.25)
+- Now has `Transport` abstract class and several query control methods
+- Supports `interrupt()`, `set_permission_mode()`, `set_model()`, `rewind_files()`, `stream_input()`, `close()`, `get_mcp_status()` in query
+- Client also supports `interrupt()`, `set_permission_mode()`, `set_model()`, `rewind_files()`
+- Does not support SessionStart/SessionEnd/Notification/SubagentStart/PermissionRequest/Setup hooks
 - Missing several permission modes (delegate, dontAsk)
+- Missing `allowDangerouslySkipPermissions`, `persistSession`, `resumeSessionAt`, `strictMcpConfig`
+- Missing `init`/`initOnly`/`maintenance` Setup hook options
 - `excludedCommands` in sandbox now supported
-- `tool_use_id` now included in PreToolUseHookInput
+- v0.1.25 adds `PostToolUseFailure` hook event support
+- v0.1.25 adds `permissionDecisionReason` to `PreToolUseHookSpecificOutput`
+- `additionalContext` supported in `UserPromptSubmitHookSpecificOutput`
+- `PreToolUseHookInput` does not include `tool_use_id` (unlike TypeScript)
+- `ToolPermissionContext` missing `blockedPath`, `decisionReason`, `toolUseID`, `agentID`
 ### Ruby SDK (This Repository)
-- Full TypeScript SDK feature parity achieved
+- Full TypeScript SDK feature parity
 - Ruby-idiomatic patterns (Data.define, snake_case)
 - Complete control protocol support
 - Dedicated Client class for multi-turn conversations
 - Full hook event support including all 13 events
 - Full V2 Session API support (unstable)
 - `executable`/`executableArgs` marked N/A (JS runtime options not applicable to Ruby)
+- Added: `FilesPersistedEvent` message type (new in TS v0.2.25)
+- `claudeai-proxy` MCP server type handled transparently via Hash-based config passthrough (new in TS v0.2.25)

data/lib/claude_agent/client.rb CHANGED Viewed

@@ -289,6 +289,42 @@ module ClaudeAgent
       @protocol.set_mcp_servers(servers)
     end
+    # Reconnect to an MCP server (TypeScript SDK parity)
+    #
+    # Attempts to reconnect to a disconnected or errored MCP server.
+    #
+    # @param server_name [String] Name of the MCP server to reconnect
+    # @return [Hash] Response from the CLI
+    #
+    # @example
+    #   client.mcp_reconnect("my-server")
+    #
+    def mcp_reconnect(server_name)
+      require_connection!
+      @protocol.mcp_reconnect(server_name)
+    end
+    # Enable or disable an MCP server (TypeScript SDK parity)
+    #
+    # Toggles an MCP server on or off without removing its configuration.
+    #
+    # @param server_name [String] Name of the MCP server to toggle
+    # @param enabled [Boolean] Whether to enable (true) or disable (false) the server
+    # @return [Hash] Response from the CLI
+    #
+    # @example Enable a server
+    #   client.mcp_toggle("my-server", enabled: true)
+    #
+    # @example Disable a server
+    #   client.mcp_toggle("my-server", enabled: false)
+    #
+    def mcp_toggle(server_name, enabled:)
+      require_connection!
+      @protocol.mcp_toggle(server_name, enabled: enabled)
+    end
     private
     def require_connection!

data/lib/claude_agent/control_protocol.rb CHANGED Viewed

@@ -363,6 +363,38 @@ module ClaudeAgent
       )
     end
+    # Reconnect to an MCP server (TypeScript SDK parity)
+    #
+    # Attempts to reconnect to a disconnected or errored MCP server.
+    #
+    # @param server_name [String] Name of the MCP server to reconnect
+    # @return [Hash] Response from the CLI
+    #
+    # @example
+    #   protocol.mcp_reconnect("my-server")
+    #
+    def mcp_reconnect(server_name)
+      send_control_request(subtype: "mcp_reconnect", serverName: server_name)
+    end
+    # Enable or disable an MCP server (TypeScript SDK parity)
+    #
+    # Toggles an MCP server on or off without removing its configuration.
+    #
+    # @param server_name [String] Name of the MCP server to toggle
+    # @param enabled [Boolean] Whether to enable (true) or disable (false) the server
+    # @return [Hash] Response from the CLI
+    #
+    # @example Enable a server
+    #   protocol.mcp_toggle("my-server", enabled: true)
+    #
+    # @example Disable a server
+    #   protocol.mcp_toggle("my-server", enabled: false)
+    #
+    def mcp_toggle(server_name, enabled:)
+      send_control_request(subtype: "mcp_toggle", serverName: server_name, enabled: enabled)
+    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/message_parser.rb CHANGED Viewed

@@ -11,7 +11,7 @@ module ClaudeAgent
     # Parse a raw message hash into a typed message object
     #
     # @param raw [Hash] Raw message from CLI
-    # @return [UserMessage, UserMessageReplay, AssistantMessage, SystemMessage, ResultMessage, StreamEvent, CompactBoundaryMessage, StatusMessage, ToolProgressMessage, HookResponseMessage, AuthStatusMessage, TaskNotificationMessage]
+    # @return [UserMessage, UserMessageReplay, AssistantMessage, SystemMessage, ResultMessage, StreamEvent, CompactBoundaryMessage, StatusMessage, ToolProgressMessage, HookResponseMessage, AuthStatusMessage, TaskNotificationMessage, HookStartedMessage, HookProgressMessage, ToolUseSummaryMessage, FilesPersistedEvent]
     # @raise [MessageParseError] If message cannot be parsed
     def parse(raw)
       type = raw["type"]
@@ -32,6 +32,12 @@ module ClaudeAgent
           parse_hook_response_message(raw)
         when "task_notification"
           parse_task_notification_message(raw)
+        when "hook_started"
+          parse_hook_started_message(raw)
+        when "hook_progress"
+          parse_hook_progress_message(raw)
+        when "files_persisted"
+          parse_files_persisted_event(raw)
         else
           parse_system_message(raw)
         end
@@ -43,6 +49,8 @@ module ClaudeAgent
         parse_tool_progress_message(raw)
       when "auth_status"
         parse_auth_status_message(raw)
+      when "tool_use_summary"
+        parse_tool_use_summary_message(raw)
       else
         raise MessageParseError.new("Unknown message type: #{type}", raw_message: raw)
       end
@@ -243,11 +251,14 @@ module ClaudeAgent
       HookResponseMessage.new(
         uuid: raw["uuid"] || "",
         session_id: fetch_dual(raw, :session_id, ""),
+        hook_id: fetch_dual(raw, :hook_id),
         hook_name: fetch_dual(raw, :hook_name, ""),
         hook_event: fetch_dual(raw, :hook_event, ""),
         stdout: raw["stdout"] || "",
         stderr: raw["stderr"] || "",
-        exit_code: fetch_dual(raw, :exit_code)
+        output: raw["output"] || "",
+        exit_code: fetch_dual(raw, :exit_code),
+        outcome: raw["outcome"]
       )
     end
@@ -271,5 +282,47 @@ module ClaudeAgent
         summary: raw["summary"] || ""
       )
     end
+    def parse_hook_started_message(raw)
+      HookStartedMessage.new(
+        uuid: raw["uuid"] || "",
+        session_id: fetch_dual(raw, :session_id, ""),
+        hook_id: fetch_dual(raw, :hook_id, ""),
+        hook_name: fetch_dual(raw, :hook_name, ""),
+        hook_event: fetch_dual(raw, :hook_event, "")
+      )
+    end
+    def parse_hook_progress_message(raw)
+      HookProgressMessage.new(
+        uuid: raw["uuid"] || "",
+        session_id: fetch_dual(raw, :session_id, ""),
+        hook_id: fetch_dual(raw, :hook_id, ""),
+        hook_name: fetch_dual(raw, :hook_name, ""),
+        hook_event: fetch_dual(raw, :hook_event, ""),
+        stdout: raw["stdout"] || "",
+        stderr: raw["stderr"] || "",
+        output: raw["output"] || ""
+      )
+    end
+    def parse_tool_use_summary_message(raw)
+      ToolUseSummaryMessage.new(
+        uuid: raw["uuid"] || "",
+        session_id: fetch_dual(raw, :session_id, ""),
+        summary: raw["summary"] || "",
+        preceding_tool_use_ids: fetch_dual(raw, :preceding_tool_use_ids, [])
+      )
+    end
+    def parse_files_persisted_event(raw)
+      FilesPersistedEvent.new(
+        uuid: raw["uuid"] || "",
+        session_id: fetch_dual(raw, :session_id, ""),
+        files: raw["files"] || [],
+        failed: raw["failed"] || [],
+        processed_at: fetch_dual(raw, :processed_at)
+      )
+    end
   end
 end

data/lib/claude_agent/messages.rb CHANGED Viewed

@@ -337,30 +337,47 @@ module ClaudeAgent
   #   msg = HookResponseMessage.new(
   #     uuid: "msg-123",
   #     session_id: "session-abc",
+  #     hook_id: "hook-456",
   #     hook_name: "my-hook",
   #     hook_event: "PreToolUse",
   #     stdout: "Hook output",
   #     stderr: "",
-  #     exit_code: 0
+  #     output: "Combined output",
+  #     exit_code: 0,
+  #     outcome: "success"
   #   )
+  #   msg.success?    # => true
+  #   msg.error?      # => false
+  #   msg.cancelled?  # => false
+  #
+  # Outcome values:
+  # - "success" - Hook completed successfully
+  # - "error" - Hook encountered an error
+  # - "cancelled" - Hook was cancelled
   #
   HookResponseMessage = Data.define(
     :uuid,
     :session_id,
+    :hook_id,
     :hook_name,
     :hook_event,
     :stdout,
     :stderr,
-    :exit_code
+    :output,
+    :exit_code,
+    :outcome
   ) do
     def initialize(
       uuid:,
       session_id:,
+      hook_id: nil,
       hook_name:,
       hook_event:,
       stdout: "",
       stderr: "",
-      exit_code: nil
+      output: "",
+      exit_code: nil,
+      outcome: nil
     )
       super
     end
@@ -368,6 +385,24 @@ module ClaudeAgent
     def type
       :hook_response
     end
+    # Check if hook completed successfully
+    # @return [Boolean]
+    def success?
+      outcome == "success"
+    end
+    # Check if hook encountered an error
+    # @return [Boolean]
+    def error?
+      outcome == "error"
+    end
+    # Check if hook was cancelled
+    # @return [Boolean]
+    def cancelled?
+      outcome == "cancelled"
+    end
   end
   # Auth status message (TypeScript SDK parity)
@@ -468,6 +503,154 @@ module ClaudeAgent
     end
   end
+  # Hook started message (TypeScript SDK parity)
+  #
+  # Sent when a hook execution starts.
+  #
+  # @example
+  #   msg = HookStartedMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     hook_id: "hook-456",
+  #     hook_name: "my-hook",
+  #     hook_event: "PreToolUse"
+  #   )
+  #
+  HookStartedMessage = Data.define(
+    :uuid,
+    :session_id,
+    :hook_id,
+    :hook_name,
+    :hook_event
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      hook_id:,
+      hook_name:,
+      hook_event:
+    )
+      super
+    end
+    def type
+      :hook_started
+    end
+  end
+  # Hook progress message (TypeScript SDK parity)
+  #
+  # Reports progress during hook execution.
+  #
+  # @example
+  #   msg = HookProgressMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     hook_id: "hook-456",
+  #     hook_name: "my-hook",
+  #     hook_event: "PreToolUse",
+  #     stdout: "Hook output so far...",
+  #     stderr: "",
+  #     output: "Combined output"
+  #   )
+  #
+  HookProgressMessage = Data.define(
+    :uuid,
+    :session_id,
+    :hook_id,
+    :hook_name,
+    :hook_event,
+    :stdout,
+    :stderr,
+    :output
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      hook_id:,
+      hook_name:,
+      hook_event:,
+      stdout: "",
+      stderr: "",
+      output: ""
+    )
+      super
+    end
+    def type
+      :hook_progress
+    end
+  end
+  # Tool use summary message (TypeScript SDK parity)
+  #
+  # Contains a summary of tool use for collapsed display.
+  #
+  # @example
+  #   msg = ToolUseSummaryMessage.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     summary: "Read 3 files",
+  #     preceding_tool_use_ids: ["tool-1", "tool-2", "tool-3"]
+  #   )
+  #
+  ToolUseSummaryMessage = Data.define(
+    :uuid,
+    :session_id,
+    :summary,
+    :preceding_tool_use_ids
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      summary:,
+      preceding_tool_use_ids: []
+    )
+      super
+    end
+    def type
+      :tool_use_summary
+    end
+  end
+  # Files persisted event (TypeScript SDK v0.2.25 parity)
+  #
+  # Sent when files are persisted to storage during a session.
+  # Contains lists of successfully persisted files and any failures.
+  #
+  # @example
+  #   msg = FilesPersistedEvent.new(
+  #     uuid: "msg-123",
+  #     session_id: "session-abc",
+  #     files: [{ "filename" => "test.rb", "file_id" => "file-456" }],
+  #     failed: [],
+  #     processed_at: "2026-01-30T12:00:00Z"
+  #   )
+  #   msg.files.first["filename"]  # => "test.rb"
+  #
+  FilesPersistedEvent = Data.define(
+    :uuid,
+    :session_id,
+    :files,
+    :failed,
+    :processed_at
+  ) do
+    def initialize(
+      uuid:,
+      session_id:,
+      files: [],
+      failed: [],
+      processed_at: nil
+    )
+      super
+    end
+    def type
+      :files_persisted
+    end
+  end
   # All message types
   MESSAGE_TYPES = [
     UserMessage,
@@ -481,6 +664,10 @@ module ClaudeAgent
     ToolProgressMessage,
     HookResponseMessage,
     AuthStatusMessage,
-    TaskNotificationMessage
+    TaskNotificationMessage,
+    HookStartedMessage,
+    HookProgressMessage,
+    ToolUseSummaryMessage,
+    FilesPersistedEvent
   ].freeze
 end

data/lib/claude_agent/version.rb CHANGED Viewed

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

data/sig/claude_agent.rbs CHANGED Viewed

@@ -393,7 +393,7 @@ module ClaudeAgent
   CONTENT_BLOCK_TYPES: Array[Class]
   # Message types
-  type message = UserMessage | UserMessageReplay | AssistantMessage | SystemMessage | ResultMessage | StreamEvent | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | HookResponseMessage | AuthStatusMessage
+  type message = UserMessage | UserMessageReplay | AssistantMessage | SystemMessage | ResultMessage | StreamEvent | CompactBoundaryMessage | StatusMessage | ToolProgressMessage | HookResponseMessage | AuthStatusMessage | TaskNotificationMessage | HookStartedMessage | HookProgressMessage | ToolUseSummaryMessage | FilesPersistedEvent
   MESSAGE_TYPES: Array[Class]
@@ -534,14 +534,20 @@ module ClaudeAgent
   class HookResponseMessage
     attr_reader uuid: String
     attr_reader session_id: String
+    attr_reader hook_id: String?
     attr_reader hook_name: String
     attr_reader hook_event: String
     attr_reader stdout: String
     attr_reader stderr: String
+    attr_reader output: String
     attr_reader exit_code: Integer?
+    attr_reader outcome: String?
-    def initialize: (uuid: String, session_id: String, hook_name: String, hook_event: String, ?stdout: String, ?stderr: String, ?exit_code: Integer?) -> void
+    def initialize: (uuid: String, session_id: String, ?hook_id: String?, hook_name: String, hook_event: String, ?stdout: String, ?stderr: String, ?output: String, ?exit_code: Integer?, ?outcome: String?) -> void
     def type: () -> :hook_response
+    def success?: () -> bool
+    def error?: () -> bool
+    def cancelled?: () -> bool
   end
   # Auth status message (TypeScript SDK parity)
@@ -556,6 +562,72 @@ module ClaudeAgent
     def type: () -> :auth_status
   end
+  # Task notification message (TypeScript SDK parity)
+  class TaskNotificationMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader task_id: String
+    attr_reader status: String
+    attr_reader output_file: String
+    attr_reader summary: String
+    def initialize: (uuid: String, session_id: String, task_id: String, status: String, output_file: String, summary: String) -> void
+    def type: () -> :task_notification
+    def completed?: () -> bool
+    def failed?: () -> bool
+    def stopped?: () -> bool
+  end
+  # Hook started message (TypeScript SDK parity)
+  class HookStartedMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader hook_id: String
+    attr_reader hook_name: String
+    attr_reader hook_event: String
+    def initialize: (uuid: String, session_id: String, hook_id: String, hook_name: String, hook_event: String) -> void
+    def type: () -> :hook_started
+  end
+  # Hook progress message (TypeScript SDK parity)
+  class HookProgressMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader hook_id: String
+    attr_reader hook_name: String
+    attr_reader hook_event: String
+    attr_reader stdout: String
+    attr_reader stderr: String
+    attr_reader output: String
+    def initialize: (uuid: String, session_id: String, hook_id: String, hook_name: String, hook_event: String, ?stdout: String, ?stderr: String, ?output: String) -> void
+    def type: () -> :hook_progress
+  end
+  # Tool use summary message (TypeScript SDK parity)
+  class ToolUseSummaryMessage
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader summary: String
+    attr_reader preceding_tool_use_ids: Array[String]
+    def initialize: (uuid: String, session_id: String, summary: String, ?preceding_tool_use_ids: Array[String]) -> void
+    def type: () -> :tool_use_summary
+  end
+  # Files persisted event (TypeScript SDK v0.2.25 parity)
+  class FilesPersistedEvent
+    attr_reader uuid: String
+    attr_reader session_id: String
+    attr_reader files: Array[Hash[String, String]]
+    attr_reader failed: Array[Hash[String, String]]
+    attr_reader processed_at: String?
+    def initialize: (uuid: String, session_id: String, ?files: Array[Hash[String, String]], ?failed: Array[Hash[String, String]], ?processed_at: String?) -> void
+    def type: () -> :files_persisted
+  end
   # Message parser
   class MessageParser
     def initialize: () -> void
@@ -765,6 +837,8 @@ module ClaudeAgent
     def rewind_files: (String user_message_id, ?dry_run: bool) -> RewindFilesResult
     def set_max_thinking_tokens: (Integer? tokens) -> Hash[String, untyped]
     def set_mcp_servers: (Hash[String, untyped] servers) -> McpSetServersResult
+    def mcp_reconnect: (String server_name) -> Hash[String, untyped]
+    def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]
@@ -798,6 +872,8 @@ module ClaudeAgent
     def rewind_files: (String user_message_id, ?dry_run: bool) -> RewindFilesResult
     def set_max_thinking_tokens: (Integer? tokens) -> Hash[String, untyped]
     def set_mcp_servers: (Hash[String, untyped] servers) -> McpSetServersResult
+    def mcp_reconnect: (String server_name) -> Hash[String, untyped]
+    def mcp_toggle: (String server_name, enabled: bool) -> Hash[String, untyped]
     def supported_commands: () -> Array[SlashCommand]
     def supported_models: () -> Array[ModelInfo]
     def mcp_server_status: () -> Array[McpServerStatus]

metadata CHANGED Viewed

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