claude_agent 0.7.13 → 0.7.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e5c5f3de29ca5a58accdb4c6dcc0937ed867fd87579c4909c42ae4d7c82e8d7
-  data.tar.gz: 9209ef4868fc7d6267c8f215c6e46222d69cf672a8223c4277db35131510c466
+  metadata.gz: 332a35645bfd711fc84e4fe7b537df19113bc30cf7b94879057c1d784e1bea2d
+  data.tar.gz: 12eefc64eaed4f54078eb9d27ed8dd891968e11980350a777dcfa4d7281cc7b7
 SHA512:
-  metadata.gz: c78cf5cc5e99c4b97130950763ce04192cbe10dccc4def0f245d9dae298123a1a56e54a75ea079f23f1d9da1415ff9758f7b2a75943ba34027a602fff12cdf5d
-  data.tar.gz: 7c3146bd079c24011f2bf95dbd1e12c6a0a81a0dad1634221827138516467df9f344e54813d2281f76bc1e6bd0ff97dd04b0ea81b854222b992f467e541d6c4d
+  metadata.gz: 809c6be65d3327939436ea2e64cd4e531584ffd3b955e504ffdfbb086991588fbec449ab123b4c3daeb1895406bbe963692e811cb51c0fa49aabf3bc7971d217
+  data.tar.gz: f12b331660e1835e3b1ae0e2f48e0e16c91ce8be459cd72a0dbdd3908846fcc252a78d36febe34caeb0bd24733f31b3ecba2e2287a49801355fed11048fd0fdb

data/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.15] - 2026-03-15
+
+### Added
+- `AbortError#partial_turn` carries the in-progress `TurnResult` when a turn is aborted, eliminating the need for separate extraction paths on cancellation
+- `StreamEvent` typed accessors: `delta_text`, `delta_type`, `thinking_text`, `content_index` for convenient access without hash-digging into raw event data
+- `PermissionRequest#display_label` and `#summary` delegate to `ToolUseBlock` formatting, removing the need to construct dummy blocks for display
+- `AbortController#reset!` and `AbortSignal#reset!` allow reuse across turns; `Conversation#say` auto-resets at turn start
+- `PostCompact` hook event with `PostCompactInput` type (`trigger` and `compact_summary` fields) (TypeScript SDK v0.2.76 parity)
+- `cancel_async_message` control request to drop queued user messages by UUID (TypeScript SDK v0.2.76 parity)
+- `get_settings` control request to read effective merged settings (TypeScript SDK v0.2.76 parity)
+- `fork_session` standalone function to branch a session from a specific point with UUID remapping (TypeScript SDK v0.2.76 parity)
+- `ForkSessionResult` data type returned by `fork_session`
+
+### Changed
+- `TurnResult#text` now falls back to accumulated streaming deltas when no `AssistantMessage` text is available (e.g., on abort mid-stream)
+- `Conversation#say` resets the tool tracker at the **start** of each turn instead of the end, so tracker data survives abort and remains accessible until the next `say()` call
+- `Client#receive_turn` catches `AbortError` and re-raises with the partial `TurnResult` attached
+
+## [0.7.14] - 2026-03-14
+
+### Fixed
+- Replace busy-wait polling (`Queue#pop(true)` + `sleep 0.01`) in `ControlProtocol::Messaging#each_message` with blocking `Queue#pop` and `:done` sentinel, eliminating CPU waste and up-to-10ms per-message latency
+- Fix `Conversation#partition_kwargs` misrouting `on_elicitation` (and any future `on_*` Options attributes) as event callbacks instead of forwarding to Options; now uses explicit allowlist derived from `EventHandler::EVENTS`
+- Remove global `ENV["CLAUDE_CODE_ENTRYPOINT"]` mutation from `Client#connect` and `ClaudeAgent.query`; the subprocess already receives this via `Options#to_env`
+- Log stderr callback errors instead of silently swallowing them in `Transport::Subprocess`
+
 ## [0.7.13] - 2026-03-14
 
 ### 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.75 (npm package)
-- Python SDK: from GitHub (commit 9880677)
+- TypeScript SDK: v0.2.76 (npm package)
+- Python SDK: from GitHub (commit 302ceb6)
 - Ruby SDK: This repository
 
-**Last Updated:** 2026-03-13
+**Last Updated:** 2026-03-15
 
 ---
 
@@ -305,29 +305,31 @@ Bidirectional control protocol for SDK-CLI communication.
 
 ### Control Request Types
 
-| Request Subtype           | TypeScript | Python | Ruby | Notes                                      |
-|---------------------------|:----------:|:------:|:----:|--------------------------------------------|
-| `initialize`              |     ✅      |   ✅    |  ✅   | Initialize session with hooks/MCP          |
-| `interrupt`               |     ✅      |   ✅    |  ✅   | Interrupt current operation                |
-| `can_use_tool`            |     ✅      |   ✅    |  ✅   | Permission callback                        |
-| `hook_callback`           |     ✅      |   ✅    |  ✅   | Execute hook callback                      |
-| `set_permission_mode`     |     ✅      |   ✅    |  ✅   | Change permission mode                     |
-| `set_model`               |     ✅      |   ✅    |  ✅   | Change model                               |
-| `set_max_thinking_tokens` |     ✅      |   ❌    |  ✅   | Change thinking tokens limit               |
-| `rewind_files`            |     ✅      |   ✅    |  ✅   | Rewind file checkpoints (supports dry_run) |
-| `mcp_message`             |     ✅      |   ✅    |  ✅   | Route MCP message                          |
-| `mcp_set_servers`         |     ✅      |   ❌    |  ✅   | Dynamically set MCP servers                |
-| `mcp_status`              |     ✅      |   ✅    |  ✅   | Get MCP server status                      |
-| `mcp_reconnect`           |     ✅      |   ✅    |  ✅   | Reconnect to MCP server                    |
-| `mcp_toggle`              |     ✅      |   ✅    |  ✅   | Enable/disable MCP server                  |
-| `stop_task`               |     ✅      |   ✅    |  ✅   | Stop a running background task             |
-| `mcp_authenticate`        |     ✅      |   ❌    |  ✅   | Authenticate MCP server (v0.2.52)          |
-| `mcp_clear_auth`          |     ✅      |   ❌    |  ✅   | Clear MCP server auth (v0.2.52)            |
-| `supported_commands`      |     ✅      |   ❌    |  ✅   | Get available slash commands               |
-| `supported_models`        |     ✅      |   ❌    |  ✅   | Get available models                       |
-| `account_info`            |     ✅      |   ❌    |  ✅   | Get account information                    |
-| `apply_flag_settings`     |     ✅      |   ❌    |  ✅   | Merge settings into flag layer             |
-| `supported_agents`        |     ✅      |   ❌    |  ✅   | Get available subagents (v0.2.63)          |
+| Request Subtype           | TypeScript | Python | Ruby | Notes                                        |
+|---------------------------|:----------:|:------:|:----:|----------------------------------------------|
+| `initialize`              |     ✅      |   ✅    |  ✅   | Initialize session with hooks/MCP            |
+| `interrupt`               |     ✅      |   ✅    |  ✅   | Interrupt current operation                  |
+| `can_use_tool`            |     ✅      |   ✅    |  ✅   | Permission callback                          |
+| `hook_callback`           |     ✅      |   ✅    |  ✅   | Execute hook callback                        |
+| `set_permission_mode`     |     ✅      |   ✅    |  ✅   | Change permission mode                       |
+| `set_model`               |     ✅      |   ✅    |  ✅   | Change model                                 |
+| `set_max_thinking_tokens` |     ✅      |   ❌    |  ✅   | Change thinking tokens limit                 |
+| `rewind_files`            |     ✅      |   ✅    |  ✅   | Rewind file checkpoints (supports dry_run)   |
+| `mcp_message`             |     ✅      |   ✅    |  ✅   | Route MCP message                            |
+| `mcp_set_servers`         |     ✅      |   ❌    |  ✅   | Dynamically set MCP servers                  |
+| `mcp_status`              |     ✅      |   ✅    |  ✅   | Get MCP server status                        |
+| `mcp_reconnect`           |     ✅      |   ✅    |  ✅   | Reconnect to MCP server                      |
+| `mcp_toggle`              |     ✅      |   ✅    |  ✅   | Enable/disable MCP server                    |
+| `stop_task`               |     ✅      |   ✅    |  ✅   | Stop a running background task               |
+| `mcp_authenticate`        |     ✅      |   ❌    |  ✅   | Authenticate MCP server (v0.2.52)            |
+| `mcp_clear_auth`          |     ✅      |   ❌    |  ✅   | Clear MCP server auth (v0.2.52)              |
+| `supported_commands`      |     ✅      |   ❌    |  ✅   | Get available slash commands                 |
+| `supported_models`        |     ✅      |   ❌    |  ✅   | Get available models                         |
+| `account_info`            |     ✅      |   ❌    |  ✅   | Get account information                      |
+| `apply_flag_settings`     |     ✅      |   ❌    |  ✅   | Merge settings into flag layer               |
+| `supported_agents`        |     ✅      |   ❌    |  ✅   | Get available subagents (v0.2.63)            |
+| `cancel_async_message`    |     ✅      |   ❌    |  ✅   | Cancel queued user message by UUID (v0.2.76) |
+| `get_settings`            |     ✅      |   ❌    |  ✅   | Get effective merged settings (v0.2.72)      |
 
 ### Return Types
 
@@ -426,6 +428,7 @@ Event hooks for intercepting and modifying SDK behavior.
 | `SubagentStart`      |     ✅      |   ✅    |  ✅   | Subagent starts (Py v0.1.29)      |
 | `SubagentStop`       |     ✅      |   ✅    |  ✅   | Subagent stops                    |
 | `PreCompact`         |     ✅      |   ✅    |  ✅   | Before compaction                 |
+| `PostCompact`        |     ✅      |   ❌    |  ✅   | After compaction (v0.2.76)        |
 | `PermissionRequest`  |     ✅      |   ✅    |  ✅   | Permission requested (Py v0.1.29) |
 | `Setup`              |     ✅      |   ❌    |  ✅   | Initial setup/maintenance         |
 | `TeammateIdle`       |     ✅      |   ❌    |  ✅   | Teammate idle (v0.2.33)           |
@@ -452,6 +455,7 @@ Event hooks for intercepting and modifying SDK behavior.
 | `SubagentStartHookInput`      |     ✅      |   ✅    |  ✅   |
 | `SubagentStopHookInput`       |     ✅      |   ✅    |  ✅   |
 | `PreCompactHookInput`         |     ✅      |   ✅    |  ✅   |
+| `PostCompactHookInput`        |     ✅      |   ❌    |  ✅   |
 | `PermissionRequestHookInput`  |     ✅      |   ✅    |  ✅   |
 | `SetupHookInput`              |     ✅      |   ❌    |  ✅   |
 | `TeammateIdleHookInput`       |     ✅      |   ❌    |  ✅   |
@@ -537,6 +541,13 @@ Event-specific fields returned via `hookSpecificOutput`:
 |---------------------|:----------:|:------:|:----:|----------------------------------|
 | `additionalContext` |     ✅      |   ✅    |  ✅   | Context string returned to model |
 
+#### PostCompactHookInput Fields
+
+| Field             | TypeScript | Python | Ruby | Notes                          |
+|-------------------|:----------:|:------:|:----:|--------------------------------|
+| `trigger`         |     ✅      |   ❌    |  ✅   | 'manual' or 'auto'             |
+| `compact_summary` |     ✅      |   ❌    |  ✅   | Summary produced by compaction |
+
 #### SetupHookSpecificOutput
 
 | Field               | TypeScript | Python | Ruby | Notes                            |
@@ -740,6 +751,7 @@ Session management and resumption.
 | `getSessionInfo()`     |     ✅      |   ❌    |  ✅   | Get single session metadata (v0.2.75)            |
 | `renameSession()`      |     ✅      |   ✅    |  ✅   | Rename a session (v0.2.74)                       |
 | `tagSession()`         |     ✅      |   ✅    |  ✅   | Tag a session (v0.2.75)                          |
+| `forkSession()`        |     ✅      |   ❌    |  ✅   | Fork/branch a session (v0.2.76)                  |
 
 #### ListSessionsOptions
 
@@ -783,6 +795,20 @@ Session management and resumption.
 | `tag`          |     ✅      |   ❌    |  ✅   | User-set tag (v0.2.75)              |
 | `createdAt`    |     ✅      |   ❌    |  ✅   | Creation time in ms (v0.2.75)       |
 
+#### ForkSessionOptions
+
+| Field            | TypeScript | Python | Ruby | Notes                                          |
+|------------------|:----------:|:------:|:----:|------------------------------------------------|
+| `dir`            |     ✅      |   ❌    |  ❌   | Project directory                              |
+| `upToMessageId`  |     ✅      |   ❌    |  ❌   | Slice transcript up to this UUID (inclusive)   |
+| `title`          |     ✅      |   ❌    |  ❌   | Custom title for the fork                      |
+
+#### ForkSessionResult
+
+| Field       | TypeScript | Python | Ruby | Notes                          |
+|-------------|:----------:|:------:|:----:|--------------------------------|
+| `sessionId` |     ✅      |   ❌    |  ❌   | New forked session UUID        |
+
 ### V2 Session API (Unstable)
 
 | Feature                     | TypeScript | Python | Ruby | Notes                     |
@@ -899,6 +925,7 @@ Public API surface for SDK clients.
 | `getSessionInfo()`     |     ✅      |   ❌    |  ✅   | Get single session metadata (v0.2.75)      |
 | `renameSession()`      |     ✅      |   ✅    |  ✅   | Rename a session (v0.2.74)                 |
 | `tagSession()`         |     ✅      |   ✅    |  ✅   | Tag a session (v0.2.75)                    |
+| `forkSession()`        |     ✅      |   ❌    |  ✅   | Fork/branch a session (v0.2.76)            |
 
 ### Query Interface
 
@@ -989,6 +1016,7 @@ Public API surface for SDK clients.
 - v0.2.73: Fixed `options.env` being overridden by `~/.claude/settings.json`
 - v0.2.74: Added `renameSession()` for renaming session files
 - v0.2.75: Added `tag`/`createdAt` fields on `SDKSessionInfo`; `getSessionInfo()` for single-session lookup; `offset` on `listSessions` for pagination; `tagSession()` for tagging sessions; `supportsAutoMode` in `ModelInfo`; `description` on `SDKControlPermissionRequest`; `prompt` on `SDKTaskStartedMessage`; `fast_mode_state` on `SDKControlInitializeResponse`; `queued_to_running` status on `AgentToolOutput`
+- v0.2.76: Added `forkSession(sessionId, opts?)` for branching conversations from a point; `cancel_async_message` control subtype to drop queued user messages; `PostCompact` hook event with `compact_summary` field; `get_settings` control request for reading effective merged settings; `planFilePath` field on `ExitPlanMode` tool input
 - Includes `Elicitation`/`ElicitationResult` hook events, `onElicitation` option, `ElicitationCompleteMessage`, `LocalCommandOutputMessage`, `FastModeState` (undocumented in changelog, present in types)
 
 ### Python SDK
@@ -1017,12 +1045,11 @@ Public API surface for SDK clients.
 - v0.1.48: Fixed fine-grained tool streaming regression
 - Added `RateLimitEvent` message type with `RateLimitInfo`
 - Added `rename_session()` and `tag_session()` session management functions
-- Missing: `onElicitation`, `Elicitation`/`ElicitationResult` hooks, `ElicitationCompleteMessage`, `LocalCommandOutputMessage`, `FastModeState`, `InstructionsLoaded` hook, `agentProgressSummaries`, `getSessionInfo()`
+- Missing: `onElicitation`, `Elicitation`/`ElicitationResult` hooks, `ElicitationCompleteMessage`, `LocalCommandOutputMessage`, `FastModeState`, `InstructionsLoaded` hook, `agentProgressSummaries`, `getSessionInfo()`, `forkSession()`, `PostCompact` hook, `cancel_async_message`, `get_settings`
 
 ### Ruby SDK (This Repository)
-- Feature parity with TypeScript SDK v0.2.75
+- Feature parity with TypeScript SDK v0.2.76
 - 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)
-- Full v0.2.75 parity: `agentProgressSummaries`, `getSessionInfo()`, `renameSession()`, `tagSession()`, `offset` on `listSessions`, `tag`/`createdAt` on `SessionInfo`, `supportsAutoMode` on `ModelInfo`

data/lib/claude_agent/abort_controller.rb

@@ -34,6 +34,17 @@ module ClaudeAgent
     def abort(reason = nil)
       @signal.abort!(reason)
     end
+
+    # Reset the controller so it can be reused for another turn.
+    #
+    # After calling {#abort}, the controller is in an aborted state
+    # and cannot be reused without resetting. Call this before the
+    # next operation, or use {Conversation} which auto-resets.
+    #
+    # @return [void]
+    def reset!
+      @signal.reset!
+    end
   end
 
   # Signal object that tracks abort state (TypeScript SDK parity)
@@ -93,6 +104,19 @@ module ClaudeAgent
       raise AbortError, reason if aborted?
     end
 
+    # Reset the signal so the controller can be reused.
+    #
+    # No-op if the signal has not been aborted.
+    #
+    # @return [void]
+    def reset!
+      @mutex.synchronize do
+        return unless @aborted
+        @aborted = false
+        @reason = nil
+      end
+    end
+
     # @api private
     # Trigger the abort
     # @param reason [String, nil] Reason for aborting

data/lib/claude_agent/client/commands.rb

@@ -220,6 +220,38 @@ module ClaudeAgent
 
         @protocol.mcp_clear_auth(server_name)
       end
+
+      # Cancel a queued async user message (TypeScript SDK v0.2.76 parity)
+      #
+      # Drops a previously queued user message before it is processed.
+      #
+      # @param message_uuid [String] UUID of the message to cancel
+      # @return [Hash] Response from the CLI
+      #
+      # @example
+      #   client.cancel_async_message("msg-uuid-123")
+      #
+      def cancel_async_message(message_uuid)
+        require_connection!
+
+        @protocol.cancel_async_message(message_uuid)
+      end
+
+      # Get effective merged settings (TypeScript SDK v0.2.76 parity)
+      #
+      # Returns the current effective settings after merging all layers.
+      #
+      # @return [Hash] Merged settings
+      #
+      # @example
+      #   settings = client.get_settings
+      #   puts settings["model"]
+      #
+      def get_settings
+        require_connection!
+
+        @protocol.get_settings
+      end
     end
   end
 end

data/lib/claude_agent/client.rb

@@ -77,8 +77,6 @@ module ClaudeAgent
     def connect(prompt: nil)
       raise CLIConnectionError, "Already connected" if @connected
 
-      ENV["CLAUDE_CODE_ENTRYPOINT"] = "sdk-rb-client"
-
       logger.info("client") { "Connecting" }
       @protocol = ControlProtocol.new(transport: @transport, options: @options)
       @protocol.permission_queue = @permission_queue
@@ -191,17 +189,23 @@ module ClaudeAgent
     # Receive messages until a ResultMessage, accumulating into a TurnResult
     #
     # Dispatches events to registered handlers (see {#on}).
+    # On abort, raises {AbortError} with the partial {TurnResult} attached.
     #
     # @yield [Message] Each message as it arrives (optional)
     # @return [TurnResult] The completed turn
+    # @raise [AbortError] If abort signal is triggered (with partial_turn attached)
     def receive_turn
       require_connection!
 
       turn = TurnResult.new
-      receive_response do |message|
-        turn << message
-        @event_handler.handle(message)
-        yield message if block_given?
+      begin
+        receive_response do |message|
+          turn << message
+          @event_handler.handle(message)
+          yield message if block_given?
+        end
+      rescue AbortError => e
+        raise AbortError.new(e.message, partial_turn: turn)
       end
       @event_handler.reset!
       turn

data/lib/claude_agent/control_protocol/commands.rb

@@ -299,6 +299,34 @@ module ClaudeAgent
           errors: response["errors"] || {}
         )
       end
+      # Cancel a queued async user message (TypeScript SDK v0.2.76 parity)
+      #
+      # Drops a previously queued user message before it is processed.
+      #
+      # @param message_uuid [String] UUID of the message to cancel
+      # @return [Hash] Response from the CLI
+      #
+      # @example
+      #   protocol.cancel_async_message("msg-uuid-123")
+      #
+      def cancel_async_message(message_uuid)
+        send_control_request(subtype: "cancel_async_message", message_uuid: message_uuid)
+      end
+
+      # Get effective merged settings (TypeScript SDK v0.2.76 parity)
+      #
+      # Returns the current effective settings after merging all layers
+      # (user, project, local, flag, etc.).
+      #
+      # @return [Hash] Merged settings
+      #
+      # @example
+      #   settings = protocol.get_settings
+      #   puts settings["model"]
+      #
+      def get_settings
+        send_control_request(subtype: "get_settings")
+      end
     end
   end
 end

data/lib/claude_agent/control_protocol/lifecycle.rb

@@ -72,7 +72,8 @@ module ClaudeAgent
           @condition.broadcast
         end
 
-        # Terminate the transport
+        # Unblock the consumer and terminate the transport
+        @message_queue.push(:done)
         @transport.terminate if @transport.respond_to?(:terminate)
       end
 
@@ -107,6 +108,8 @@ module ClaudeAgent
       rescue AbortError
         logger.debug("protocol") { "Reader thread exiting: abort signal" }
         @running = false
+      ensure
+        @message_queue.push(:done)
       end
     end
   end

data/lib/claude_agent/control_protocol/messaging.rb

@@ -26,19 +26,16 @@ module ClaudeAgent
       def each_message
         return enum_for(:each_message) unless block_given?
 
-        while @running || !@message_queue.empty?
-          # Check abort signal
+        loop do
           @abort_signal&.check!
 
+          raw = @message_queue.pop  # blocks until data available
+          break if raw == :done     # sentinel from reader_loop
+
           begin
-            raw = @message_queue.pop(true)
             message = @parser.parse(raw)
             yield message
-          rescue ThreadError
-            # Queue empty, wait a bit
-            sleep 0.01
           rescue AbortError
-            # Re-raise abort errors
             raise
           rescue => e
             logger.warn("protocol") { "Message parse error: #{e.message}" }

data/lib/claude_agent/control_protocol.rb

@@ -25,6 +25,28 @@ module ClaudeAgent
   #   protocol.start
   #   protocol.each_message { |msg| process(msg) }
   #
+  # State ownership across modules:
+  #
+  # Owned by Lifecycle:
+  #   @running, @reader_thread
+  #
+  # Owned by RequestHandling:
+  #   @hook_callbacks
+  #
+  # Owned by Primitives:
+  #   write_message, read helpers (stateless)
+  #
+  # Owned by Commands:
+  #   interrupt, rewind (stateless, uses @transport)
+  #
+  # Shared (initialized here, used by multiple modules):
+  #   @transport, @options, @parser, @server_info
+  #   @request_counter, @pending_requests, @pending_results (Primitives + RequestHandling)
+  #   @mutex, @condition (Primitives + Lifecycle + RequestHandling)
+  #   @message_queue (Lifecycle + Messaging)
+  #   @abort_signal (Lifecycle + Messaging)
+  #   @permission_queue (RequestHandling, set externally by Client)
+  #
   class ControlProtocol
     DEFAULT_TIMEOUT = 60
     REQUEST_ID_PREFIX = "req"
@@ -78,6 +100,7 @@ module ClaudeAgent
 
       # Abort signal from options
       @abort_signal = options&.abort_signal
+      @abort_signal&.on_abort { @message_queue.push(:done) }
     end
 
     private

data/lib/claude_agent/conversation.rb

@@ -100,12 +100,21 @@ module ClaudeAgent
     # Send a message and receive the complete turn result.
     #
     # Auto-connects on first call. Appends to conversation history.
+    # Resets the tool tracker and abort signal at the start of each turn
+    # so they are fresh for the new operation.
+    #
+    # On abort, raises {AbortError} with the partial {TurnResult} attached.
+    # The tool tracker retains its state from the aborted turn until the
+    # next call to {#say}.
     #
     # @param prompt [String, Array] The message content
     # @yield [Message] Each message as it streams in (optional)
     # @return [TurnResult] The completed turn
+    # @raise [AbortError] If abort signal is triggered (with partial_turn attached)
     def say(prompt, &block)
       ensure_connected!
+      @tool_tracker&.reset!
+      @options.abort_signal&.reset!
 
       logger.debug("conversation") { "Turn #{@turns.size}: sending message" }
 
@@ -116,7 +125,6 @@ module ClaudeAgent
 
       @turns << turn
       build_tool_activities(turn, @turns.size - 1)
-      @tool_tracker&.reset!
 
       logger.info("conversation") { "Turn #{@turns.size - 1} complete (#{turn.tool_uses.size} tools, cost=$#{total_cost})" }
 
@@ -193,6 +201,13 @@ module ClaudeAgent
 
     private
 
+    # Callback keys derived from EventHandler events + aliases + on_permission
+    CALLBACK_KEYS = (
+      EventHandler::EVENTS.map { |e| :"on_#{e}" } +
+      CALLBACK_ALIASES.keys +
+      [ :on_permission ]
+    ).freeze
+
     def partition_kwargs(kwargs)
       callbacks = {}
       conversation_kwargs = {}
@@ -201,7 +216,7 @@ module ClaudeAgent
       kwargs.each do |key, value|
         if CONVERSATION_KEYS.include?(key)
           conversation_kwargs[key] = value
-        elsif key.to_s.start_with?("on_")
+        elsif CALLBACK_KEYS.include?(key)
           callbacks[key] = value
         else
           options_kwargs[key] = value

data/lib/claude_agent/errors.rb

@@ -92,12 +92,26 @@ module ClaudeAgent
   # This error is raised when an operation is explicitly cancelled,
   # such as through a user interrupt or abort signal.
   #
-  # @example
-  #   raise ClaudeAgent::AbortError, "Operation cancelled by user"
+  # When raised from {Client#receive_turn} or {Conversation#say},
+  # carries a partial {TurnResult} with whatever was accumulated
+  # before cancellation (text, tool executions, usage).
+  #
+  # @example Accessing partial results
+  #   begin
+  #     turn = conversation.say("Fix the bug")
+  #   rescue ClaudeAgent::AbortError => e
+  #     turn = e.partial_turn
+  #     puts turn.text         # accumulated text (from stream events if needed)
+  #     puts turn.tool_uses    # tools that were called before abort
+  #   end
   #
   class AbortError < Error
-    def initialize(message = "Operation was aborted")
-      super
+    # @return [TurnResult, nil] Partial turn accumulated before abort
+    attr_reader :partial_turn
+
+    def initialize(message = "Operation was aborted", partial_turn: nil)
+      @partial_turn = partial_turn
+      super(message)
     end
   end
 end

data/lib/claude_agent/fork_session.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "json"
+require "securerandom"
+
+module ClaudeAgent
+  # Fork a session by creating a new session file with remapped UUIDs.
+  #
+  # Reads all JSONL entries from the source session, optionally truncates
+  # at a given message UUID, remaps all UUIDs to fresh values, and writes
+  # a new session file in the same project directory.
+  #
+  # @example Basic fork
+  #   result = ClaudeAgent.fork_session("abc-123-...")
+  #   puts result.session_id
+  #
+  # @example Fork with truncation and title
+  #   result = ClaudeAgent.fork_session(
+  #     "abc-123-...",
+  #     up_to_message_id: "msg-456-...",
+  #     title: "Forked conversation"
+  #   )
+  #
+  module ForkSession
+    UUID_FIELDS = %w[uuid parentUuid].freeze
+    SESSION_ID_FIELDS = %w[session_id sessionId].freeze
+
+    module_function
+
+    # Fork a session, creating a new session file with remapped UUIDs.
+    #
+    # @param session_id [String] UUID of the source session
+    # @param up_to_message_id [String, nil] If provided, truncate at this message UUID (inclusive)
+    # @param title [String, nil] If provided, append a custom-title entry
+    # @param dir [String, nil] Project directory to find the session in
+    # @return [ForkSessionResult] Result with the new session ID
+    # @raise [ArgumentError] If session_id is not a valid UUID
+    # @raise [Error] If the session file is not found
+    def call(session_id, up_to_message_id: nil, title: nil, dir: nil)
+      SessionMutations.send(:validate_session_id!, session_id)
+
+      source_path = SessionMutations.send(:find_session_file, session_id, dir: dir)
+      raise Error, "Session not found: #{session_id}" unless source_path
+
+      lines = File.readlines(source_path, chomp: true)
+      entries = lines.filter_map do |line|
+        next if line.strip.empty?
+        JSON.parse(line)
+      end
+
+      # Truncate at up_to_message_id (inclusive)
+      if up_to_message_id
+        cut_index = entries.index { |e| e["uuid"] == up_to_message_id }
+        raise ArgumentError, "Message not found: #{up_to_message_id}" unless cut_index
+        entries = entries[0..cut_index]
+      end
+
+      # Generate new session ID and UUID map
+      new_session_id = SecureRandom.uuid
+      uuid_map = build_uuid_map(entries)
+
+      # Remap all entries
+      remapped = entries.map { |entry| remap_entry(entry, uuid_map, new_session_id) }
+
+      # Append custom-title entry if requested
+      if title
+        remapped << {
+          "type" => "custom-title",
+          "customTitle" => title.to_s,
+          "sessionId" => new_session_id
+        }
+      end
+
+      # Write new session file in the same directory as the source
+      dest_path = File.join(File.dirname(source_path), "#{new_session_id}.jsonl")
+      File.open(dest_path, "w") do |f|
+        remapped.each { |entry| f.write("#{JSON.generate(entry)}\n") }
+      end
+
+      ForkSessionResult.new(session_id: new_session_id)
+    end
+
+    # Build a map of old UUIDs to new UUIDs from all entries.
+    # @param entries [Array<Hash>]
+    # @return [Hash<String, String>]
+    def build_uuid_map(entries)
+      map = {}
+      entries.each do |entry|
+        UUID_FIELDS.each do |field|
+          value = entry[field]
+          next unless value.is_a?(String) && !value.empty?
+          map[value] ||= SecureRandom.uuid
+        end
+      end
+      map
+    end
+
+    # Remap UUID and session_id fields in an entry.
+    # @param entry [Hash] Original entry
+    # @param uuid_map [Hash<String, String>] Old UUID to new UUID mapping
+    # @param new_session_id [String] New session ID
+    # @return [Hash] Remapped entry
+    def remap_entry(entry, uuid_map, new_session_id)
+      result = entry.dup
+
+      UUID_FIELDS.each do |field|
+        result[field] = uuid_map[result[field]] if result.key?(field) && uuid_map.key?(result[field])
+      end
+
+      SESSION_ID_FIELDS.each do |field|
+        result[field] = new_session_id if result.key?(field)
+      end
+
+      result
+    end
+  end
+end

data/lib/claude_agent/hooks.rb

@@ -14,6 +14,7 @@ module ClaudeAgent
     SubagentStart
     SubagentStop
     PreCompact
+    PostCompact
     PermissionRequest
     Setup
     TeammateIdle
@@ -184,6 +185,9 @@ module ClaudeAgent
     required: [ :trigger ],
     optional: { custom_instructions: nil }
 
+  BaseHookInput.define_input "PostCompact",
+    required: [ :trigger, :compact_summary ]
+
   BaseHookInput.define_input "PermissionRequest",
     required: [ :tool_name, :tool_input ],
     optional: { permission_suggestions: nil }

data/lib/claude_agent/messages/streaming.rb

@@ -24,6 +24,43 @@ module ClaudeAgent
     def event_type
       event[:type]
     end
+
+    # Text delta content, or nil if this is not a text_delta event.
+    # @return [String, nil]
+    def delta_text
+      return nil unless event_type == "content_block_delta"
+      delta = event[:delta] || event["delta"]
+      return nil unless delta
+      type = delta[:type] || delta["type"]
+      return nil unless type == "text_delta"
+      delta[:text] || delta["text"]
+    end
+
+    # The delta type (e.g. "text_delta", "thinking_delta", "input_json_delta").
+    # @return [String, nil]
+    def delta_type
+      return nil unless event_type == "content_block_delta"
+      delta = event[:delta] || event["delta"]
+      return nil unless delta
+      delta[:type] || delta["type"]
+    end
+
+    # Thinking delta text, or nil if this is not a thinking_delta event.
+    # @return [String, nil]
+    def thinking_text
+      return nil unless event_type == "content_block_delta"
+      delta = event[:delta] || event["delta"]
+      return nil unless delta
+      type = delta[:type] || delta["type"]
+      return nil unless type == "thinking_delta"
+      delta[:thinking] || delta["thinking"]
+    end
+
+    # Content block index within the message.
+    # @return [Integer, nil]
+    def content_index
+      event[:index] || event["index"]
+    end
   end
 
   # Rate limit event (TypeScript SDK v0.2.45 parity)

data/lib/claude_agent/permission_request.rb

@@ -132,6 +132,23 @@ module ClaudeAgent
       end
     end
 
+    # Human-readable label for the permission request.
+    #
+    # Delegates to {ToolUseBlock#display_label} formatting.
+    #
+    # @return [String]
+    def display_label
+      ToolUseBlock.new(id: "", name: tool_name, input: input || {}).display_label
+    end
+
+    # Detailed summary of the tool call.
+    #
+    # @param max [Integer] Maximum length before truncation
+    # @return [String]
+    def summary(max: 60)
+      ToolUseBlock.new(id: "", name: tool_name, input: input || {}).summary(max: max)
+    end
+
     def inspect
       status = resolved? ? "resolved(#{@result&.behavior})" : "pending"
       "#<#{self.class} tool=#{tool_name} status=#{status} age=#{(Time.now - created_at).round(1)}s>"

data/lib/claude_agent/query.rb

@@ -41,8 +41,6 @@ module ClaudeAgent
       transport ||= Transport::Subprocess.new(options: options)
 
       Enumerator.new do |yielder|
-        # Set entrypoint environment variable
-        ENV["CLAUDE_CODE_ENTRYPOINT"] = "sdk-rb"
         query_logger = options.effective_logger
         query_logger.info("query") { "Starting query" }
         query_start = Process.clock_gettime(Process::CLOCK_MONOTONIC)

data/lib/claude_agent/transport/subprocess.rb

@@ -387,8 +387,8 @@ module ClaudeAgent
           @stderr.each_line do |line|
             # Call callback if provided, otherwise just drain
             @options.stderr_callback&.call(line.chomp)
-          rescue
-            # Ignore callback errors
+          rescue => e
+            logger.debug("transport") { "stderr callback error: #{e.message}" }
           end
         rescue IOError
           # Stream closed, exit thread

data/lib/claude_agent/turn_result.rb

@@ -35,6 +35,7 @@ module ClaudeAgent
     def initialize
       @messages = []
       @result = nil
+      @streamed_text = +""
     end
 
     # Append a message to this turn
@@ -44,6 +45,13 @@ module ClaudeAgent
     def <<(message)
       @messages << message
       @result = message if message.is_a?(ResultMessage)
+
+      # Accumulate streaming text deltas for reliable text access on abort
+      if message.is_a?(StreamEvent)
+        delta = message.delta_text
+        @streamed_text << delta if delta
+      end
+
       self
     end
 
@@ -61,10 +69,20 @@ module ClaudeAgent
 
     # --- Text & Thinking ---
 
-    # All text content concatenated across assistant messages
+    # All text content from the turn.
+    #
+    # Returns text from AssistantMessages when available (canonical source).
+    # Falls back to accumulated streaming deltas when assistant messages
+    # have no text (e.g., turn was aborted before AssistantMessage arrived).
+    #
     # @return [String]
     def text
-      assistant_messages.map(&:text).join
+      t = assistant_messages.map(&:text).join
+      if t.empty? && !@streamed_text.empty?
+        @streamed_text.dup.freeze
+      else
+        t
+      end
     end
 
     # All thinking content concatenated across assistant messages

data/lib/claude_agent/types/sessions.rb

@@ -47,4 +47,12 @@ module ClaudeAgent
       super
     end
   end
+
+  # Result of forking a session (TypeScript SDK v0.2.76 parity)
+  #
+  # @example
+  #   result = ClaudeAgent.fork_session("abc-123")
+  #   puts result.session_id  # => new UUID
+  #
+  ForkSessionResult = Data.define(:session_id)
 end

data/lib/claude_agent/version.rb

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

data/lib/claude_agent.rb

@@ -38,6 +38,7 @@ require_relative "claude_agent/get_session_messages"    # Session transcript rea
 require_relative "claude_agent/session_message_relation" # Chainable message query object
 require_relative "claude_agent/session_mutations"          # Session rename/tag mutations
 require_relative "claude_agent/get_session_info"           # Single session lookup
+require_relative "claude_agent/fork_session"               # Session forking (TypeScript SDK v0.2.76 parity)
 require_relative "claude_agent/v2_session"                  # V2 Session API (unstable)
 require_relative "claude_agent/session"                    # Session finder
 
@@ -110,6 +111,17 @@ module ClaudeAgent
       GetSessionInfo.call(session_id, dir: dir)
     end
 
+    # Fork a session by creating a new session file with remapped UUIDs.
+    #
+    # @param session_id [String] UUID of the source session
+    # @param up_to_message_id [String, nil] Truncate at this message UUID (inclusive)
+    # @param title [String, nil] Title for the forked session
+    # @param dir [String, nil] Project directory to find the session in
+    # @return [ForkSessionResult]
+    def fork_session(session_id, up_to_message_id: nil, title: nil, dir: nil)
+      ForkSession.call(session_id, up_to_message_id: up_to_message_id, title: title, dir: dir)
+    end
+
     # Resume a previous Conversation by session ID
     #
     # @param session_id [String] Session ID to resume

data/sig/claude_agent.rbs

@@ -91,7 +91,9 @@ module ClaudeAgent
   end
 
   class AbortError < Error
-    def initialize: (?String message) -> void
+    attr_reader partial_turn: TurnResult?
+
+    def initialize: (?String message, ?partial_turn: TurnResult?) -> void
   end
 
   # Abort controller for cancelling operations (TypeScript SDK parity)
@@ -100,6 +102,7 @@ module ClaudeAgent
 
     def initialize: () -> void
     def abort: (?String? reason) -> void
+    def reset!: () -> void
   end
 
   # Abort signal for tracking abort state (TypeScript SDK parity)
@@ -110,6 +113,7 @@ module ClaudeAgent
     def on_abort: () { (String?) -> void } -> void
     def wait: (?timeout: Numeric?) -> bool
     def check!: () -> void
+    def reset!: () -> void
     def abort!: (?String? reason) -> void
   end
 
@@ -255,6 +259,13 @@ module ClaudeAgent
     def initialize: (type: String, uuid: String, session_id: String, message: untyped, ?parent_tool_use_id: nil) -> void
   end
 
+  # Fork session result (TypeScript SDK v0.2.76 parity)
+  class ForkSessionResult
+    attr_reader session_id: String
+
+    def initialize: (session_id: String) -> void
+  end
+
   # Agent definition for custom subagents (TypeScript SDK parity)
   class AgentDefinition
     attr_reader description: String
@@ -680,6 +691,10 @@ module ClaudeAgent
     def initialize: (uuid: String, session_id: String, event: Hash[String, untyped], ?parent_tool_use_id: String?) -> void
     def type: () -> :stream_event
     def event_type: () -> String?
+    def delta_text: () -> String?
+    def delta_type: () -> String?
+    def thinking_text: () -> String?
+    def content_index: () -> Integer?
   end
 
   class CompactBoundaryMessage
@@ -996,6 +1011,13 @@ module ClaudeAgent
     def initialize: (trigger: String, ?custom_instructions: String?, **untyped) -> void
   end
 
+  class PostCompactInput < BaseHookInput
+    attr_reader trigger: String
+    attr_reader compact_summary: String
+
+    def initialize: (trigger: String, compact_summary: String, **untyped) -> void
+  end
+
   class PermissionRequestInput < BaseHookInput
     attr_reader tool_name: String
     attr_reader tool_input: Hash[String, untyped]
@@ -1161,6 +1183,8 @@ module ClaudeAgent
     def pending?: () -> bool
     def result: () -> permission_result?
     def wait: (?timeout: Numeric?) -> permission_result
+    def display_label: () -> String
+    def summary: (?max: Integer) -> String
     def inspect: () -> String
   end
 
@@ -1384,6 +1408,7 @@ module ClaudeAgent
   def self.rename_session: (String session_id, String title, ?dir: String?) -> void
   def self.tag_session: (String session_id, String? tag, ?dir: String?) -> void
   def self.get_session_info: (String session_id, ?dir: String?) -> SessionInfo?
+  def self.fork_session: (String session_id, ?up_to_message_id: String?, ?title: String?, ?dir: String?) -> ForkSessionResult
 
   # Shared session path infrastructure
   module SessionPaths
@@ -1427,6 +1452,14 @@ module ClaudeAgent
     def self.call: (String session_id, ?dir: String?) -> SessionInfo?
   end
 
+  # Session forking (TypeScript SDK v0.2.76 parity)
+  module ForkSession
+    UUID_FIELDS: Array[String]
+    SESSION_ID_FIELDS: Array[String]
+
+    def self.call: (String session_id, ?up_to_message_id: String?, ?title: String?, ?dir: String?) -> ForkSessionResult
+  end
+
   # Convenience methods
   def self.conversation: (**untyped) -> Conversation
   def self.resume_conversation: (String session_id, **untyped) -> Conversation
@@ -1514,6 +1547,8 @@ module ClaudeAgent
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
     def initialization_result: () -> InitializationResult
+    def cancel_async_message: (String message_uuid) -> Hash[String, untyped]
+    def get_settings: () -> Hash[String, untyped]
     def pending_permission: () -> PermissionRequest?
     def pending_permissions?: () -> bool
   end
@@ -1580,6 +1615,8 @@ module ClaudeAgent
     def mcp_server_status: () -> Array[McpServerStatus]
     def account_info: () -> AccountInfo
     def initialization_result: () -> InitializationResult
+    def cancel_async_message: (String message_uuid) -> Hash[String, untyped]
+    def get_settings: () -> Hash[String, untyped]
   end
 
   # Transport layer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_agent
 version: !ruby/object:Gem::Version
-  version: 0.7.13
+  version: 0.7.15
 platform: ruby
 authors:
 - Thomas Carr
@@ -74,6 +74,7 @@ files:
 - lib/claude_agent/cumulative_usage.rb
 - lib/claude_agent/errors.rb
 - lib/claude_agent/event_handler.rb
+- lib/claude_agent/fork_session.rb
 - lib/claude_agent/get_session_info.rb
 - lib/claude_agent/get_session_messages.rb
 - lib/claude_agent/hooks.rb