claude_agent 0.4.3 → 0.6.0

checksums.yaml

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

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

data/sig/claude_agent.rbs

@@ -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

@@ -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