claude-agent-sdk 1.2.1 → 1.4.0

data/docs/rails.md

@@ -356,7 +356,7 @@ end
 
 Preconditions, spelled out: `:inline` is only correct when the process satisfies the same requirements as solid_queue's fiber workers — `isolation_level = :fiber`, Rails 7.2+ for AR, and no thread-keyed libraries used inside callbacks without a fiber-aware wrapper. The SDK warns once if it detects `:inline` under `isolation_level == :thread`. Everything else (Puma request threads, threaded Sidekiq/solid_queue workers) should stay on the default `callback_scheduling: :thread`.
 
-Note that `SessionStore` adapter calls (`#append` / `#load`) stay on threads by default even in `:inline` mode — their timeouts are hard bounds (`Thread#join`) so a wedged store adapter can never stall the reactor. The exception is an adapter that declares itself fiber-native via an optional `callback_scheduling` method returning `:inline` (see "Fiber-native adapters" in [docs/sessions.md](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/docs/sessions.md)); its calls then run on the reactor under a cooperative timeout. In both cases a configured `callback_wrapper` composes around the adapter call inside the bound.
+Note that `SessionStore` adapter calls (`#append` / `#load`) stay on threads by default even in `:inline` mode — their timeouts are hard bounds (`Thread#join`) so a wedged store adapter can never stall the reactor. The exception is an adapter that declares itself fiber-native via an optional `callback_scheduling` method returning `:inline` (see "Fiber-native adapters" in [docs/sessions.md](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/docs/sessions.md)); its calls then run on the reactor under a cooperative timeout. In both cases a configured `callback_wrapper` composes around the adapter call inside the bound.
 
 ## ActionCable Streaming
 
@@ -541,7 +541,7 @@ end
 Then every `ClaudeAgentSDK.query` and `Client` session automatically gets traced — no per-call wiring needed. The lambda factory ensures each request gets its own observer with isolated span state, safe for concurrent Puma/Sidekiq workers.
 
 See:
-- [examples/rails_actioncable_example.rb](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/rails_actioncable_example.rb)
-- [examples/rails_background_job_example.rb](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/rails_background_job_example.rb)
-- [examples/session_resumption_example.rb](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/session_resumption_example.rb)
-- [examples/http_mcp_server_example.rb](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/http_mcp_server_example.rb)
+- [examples/rails_actioncable_example.rb](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/rails_actioncable_example.rb)
+- [examples/rails_background_job_example.rb](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/rails_background_job_example.rb)
+- [examples/session_resumption_example.rb](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/session_resumption_example.rb)
+- [examples/http_mcp_server_example.rb](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/http_mcp_server_example.rb)

data/docs/sessions.md

@@ -398,7 +398,7 @@ end
 `InMemorySessionStore#append` is a working reference.
 
 Copy-in reference adapters for **S3, Redis, and Postgres** live in
-[`examples/session_stores/`](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/session_stores/README.md), each with a
+[`examples/session_stores/`](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/session_stores/README.md), each with a
 production checklist.
 
 #### Fiber-native adapters

data/docs/subagents.md

@@ -158,7 +158,7 @@ See [hook fields and permission cancellation](hooks-and-permissions.md).
 
 ## Minimal example
 
-[`examples/subagent_status_example.rb`](https://github.com/ya-luotao/claude-agent-sdk-ruby/blob/main/examples/subagent_status_example.rb)
+[`examples/subagent_status_example.rb`](https://github.com/rubycatco/claude-agent-sdk-ruby/blob/main/examples/subagent_status_example.rb)
 defines a tool-free reviewer, registers lifecycle hooks, reads metadata, and
 prints task events and forwarded child text without building a status model:
 

data/docs/types.md

@@ -1,6 +1,6 @@
 # Types Reference
 
-See [lib/claude_agent_sdk/types/](https://github.com/ya-luotao/claude-agent-sdk-ruby/tree/main/lib/claude_agent_sdk/types) for complete type definitions (one file per area; `types.rb` loads them all).
+See [lib/claude_agent_sdk/types/](https://github.com/rubycatco/claude-agent-sdk-ruby/tree/main/lib/claude_agent_sdk/types) for complete type definitions (one file per area; `types.rb` loads them all).
 
 ## Hash keys
 
@@ -214,7 +214,7 @@ message types of their own.
 
 | Class | Wire type | Attributes | Notes |
 |-------|-----------|------------|-------|
-| `InitMessage` | `system` / `init` | `uuid`, `session_id`, `model`, `cwd`, `tools`, `mcp_servers`, `agents`, `skills`, `plugins`, `slash_commands`, `permission_mode`, `claude_code_version`, `api_key_source`, `betas`, `output_style`, `fast_mode_state` | Start of every turn, with the session as the CLI sees it (so a multi-query `Client` session receives one per query) |
+| `InitMessage` | `system` / `init` | `uuid`, `session_id`, `model`, `cwd`, `tools`, `mcp_servers`, `agents`, `skills`, `plugins`, `plugin_errors`, `slash_commands`, `terminal_slash_commands`, `permission_mode`, `claude_code_version`, `api_key_source`, `betas`, `output_style`, `fast_mode_state`, `fast_mode_disabled_reason`, `capabilities` (protocol features such as `"interrupt_receipt_v1"`: test it instead of `claude_code_version`) | Start of every turn, with the session as the CLI sees it (so a multi-query `Client` session receives one per query) |
 | `CompactBoundaryMessage` | `system` / `compact_boundary` | `uuid`, `session_id`, `compact_metadata` (a `CompactMetadata`: `pre_tokens`, `post_tokens`, `trigger`, `preserved_segment`, `custom_instructions`) | Context compaction completed |
 | `StatusMessage` | `system` / `status` | `uuid`, `session_id`, `status`, `permission_mode` | Compacting status, permission mode changes |
 | `APIRetryMessage` | `system` / `api_retry` | `uuid`, `session_id`, `attempt`, `max_retries`, `retry_delay_ms`, `error_status`, `error` | The CLI is retrying an API request |

data/lib/claude_agent_sdk/cli_installer.rb

@@ -53,7 +53,7 @@ module ClaudeAgentSDK
     # Single source of truth: bumped here (and only here) by
     # .github/workflows/cli-pin-bump.yml or a Python-sync release, so a
     # Dependabot bump of the gem carries the CLI forward with it.
-    PINNED_CLI_VERSION = '2.1.288'
+    PINNED_CLI_VERSION = '2.1.295'
     # @api private
     BINARY_NAME = 'claude'
     # @api private

data/lib/claude_agent_sdk/query.rb

@@ -868,227 +868,55 @@ module ClaudeAgentSDK
       @callback_request_signals.delete(request_id)
     end
 
-    def parse_hook_input(input_data) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength -- one branch per hook event type
+    # The typed input built for each hook event the SDK models; any other
+    # event becomes an UnknownHookInput.
+    HOOK_INPUT_CLASSES = {
+      'PreToolUse' => PreToolUseHookInput,
+      'PostToolUse' => PostToolUseHookInput,
+      'PostToolUseFailure' => PostToolUseFailureHookInput,
+      'UserPromptSubmit' => UserPromptSubmitHookInput,
+      'Stop' => StopHookInput,
+      'SubagentStop' => SubagentStopHookInput,
+      'Notification' => NotificationHookInput,
+      'SubagentStart' => SubagentStartHookInput,
+      'PermissionRequest' => PermissionRequestHookInput,
+      'PreCompact' => PreCompactHookInput,
+      'SessionStart' => SessionStartHookInput,
+      'SessionEnd' => SessionEndHookInput,
+      'Setup' => SetupHookInput,
+      'TeammateIdle' => TeammateIdleHookInput,
+      'TaskCompleted' => TaskCompletedHookInput,
+      'ConfigChange' => ConfigChangeHookInput,
+      'WorktreeCreate' => WorktreeCreateHookInput,
+      'WorktreeRemove' => WorktreeRemoveHookInput,
+      'StopFailure' => StopFailureHookInput,
+      'PostCompact' => PostCompactHookInput,
+      'PermissionDenied' => PermissionDeniedHookInput,
+      'TaskCreated' => TaskCreatedHookInput,
+      'Elicitation' => ElicitationHookInput,
+      'ElicitationResult' => ElicitationResultHookInput,
+      'InstructionsLoaded' => InstructionsLoadedHookInput,
+      'CwdChanged' => CwdChangedHookInput,
+      'FileChanged' => FileChangedHookInput,
+      'PostToolBatch' => PostToolBatchHookInput,
+      'UserPromptExpansion' => UserPromptExpansionHookInput,
+      'PreModelSwitch' => PreModelSwitchHookInput,
+      'PostModelSwitch' => PostModelSwitchHookInput,
+      'DirectoryAdded' => DirectoryAddedHookInput,
+      'MessageDisplay' => MessageDisplayHookInput
+    }.freeze
+    private_constant :HOOK_INPUT_CLASSES
+
+    # Every field of the payload that the class declares is assigned (the
+    # lenient parse path: other keys are skipped, not rejected), and the
+    # whole payload is kept as #raw_input, so a field the CLI added after this
+    # SDK version is still readable there.
+    def parse_hook_input(input_data)
+      input_data = {} unless input_data.is_a?(Hash)
       event_name = input_data[:hook_event_name] || input_data['hook_event_name']
-      fetch = lambda do |key|
-        if input_data.key?(key)
-          input_data[key]
-        elsif input_data.key?(key.to_s)
-          input_data[key.to_s]
-        end
-      end
-      base_args = {
-        session_id: fetch.call(:session_id),
-        transcript_path: fetch.call(:transcript_path),
-        cwd: fetch.call(:cwd),
-        permission_mode: fetch.call(:permission_mode)
-      }
-
-      # Subagent context fields shared by tool-lifecycle hooks
-      subagent_args = {
-        agent_id: fetch.call(:agent_id),
-        agent_type: fetch.call(:agent_type)
-      }
-
-      case event_name
-      when 'PreToolUse'
-        PreToolUseHookInput.new(
-          tool_name: fetch.call(:tool_name),
-          tool_input: fetch.call(:tool_input),
-          tool_use_id: fetch.call(:tool_use_id),
-          **subagent_args, **base_args
-        )
-      when 'PostToolUse'
-        PostToolUseHookInput.new(
-          tool_name: fetch.call(:tool_name),
-          tool_input: fetch.call(:tool_input),
-          tool_response: fetch.call(:tool_response),
-          tool_use_id: fetch.call(:tool_use_id),
-          **subagent_args, **base_args
-        )
-      when 'PostToolUseFailure'
-        PostToolUseFailureHookInput.new(
-          tool_name: fetch.call(:tool_name),
-          tool_input: fetch.call(:tool_input),
-          tool_use_id: fetch.call(:tool_use_id),
-          error: fetch.call(:error),
-          is_interrupt: fetch.call(:is_interrupt),
-          **subagent_args, **base_args
-        )
-      when 'UserPromptSubmit'
-        UserPromptSubmitHookInput.new(
-          prompt: fetch.call(:prompt),
-          **base_args
-        )
-      when 'Stop'
-        StopHookInput.new(
-          stop_hook_active: fetch.call(:stop_hook_active),
-          last_assistant_message: fetch.call(:last_assistant_message),
-          background_tasks: fetch.call(:background_tasks),
-          session_crons: fetch.call(:session_crons),
-          **base_args
-        )
-      when 'SubagentStop'
-        SubagentStopHookInput.new(
-          stop_hook_active: fetch.call(:stop_hook_active),
-          agent_id: fetch.call(:agent_id),
-          agent_transcript_path: fetch.call(:agent_transcript_path),
-          agent_type: fetch.call(:agent_type),
-          last_assistant_message: fetch.call(:last_assistant_message),
-          background_tasks: fetch.call(:background_tasks),
-          session_crons: fetch.call(:session_crons),
-          **base_args
-        )
-      when 'Notification'
-        NotificationHookInput.new(
-          message: fetch.call(:message),
-          title: fetch.call(:title),
-          notification_type: fetch.call(:notification_type),
-          **base_args
-        )
-      when 'SubagentStart'
-        SubagentStartHookInput.new(
-          agent_id: fetch.call(:agent_id),
-          agent_type: fetch.call(:agent_type),
-          **base_args
-        )
-      when 'PermissionRequest'
-        PermissionRequestHookInput.new(
-          tool_name: fetch.call(:tool_name),
-          tool_input: fetch.call(:tool_input),
-          permission_suggestions: fetch.call(:permission_suggestions),
-          **subagent_args, **base_args
-        )
-      when 'PreCompact'
-        PreCompactHookInput.new(
-          trigger: fetch.call(:trigger),
-          custom_instructions: fetch.call(:custom_instructions),
-          **base_args
-        )
-      when 'SessionStart'
-        SessionStartHookInput.new(
-          source: fetch.call(:source),
-          agent_type: fetch.call(:agent_type),
-          model: fetch.call(:model),
-          **base_args
-        )
-      when 'SessionEnd'
-        SessionEndHookInput.new(
-          reason: fetch.call(:reason),
-          **base_args
-        )
-      when 'Setup'
-        SetupHookInput.new(
-          trigger: fetch.call(:trigger),
-          **base_args
-        )
-      when 'TeammateIdle'
-        TeammateIdleHookInput.new(
-          teammate_name: fetch.call(:teammate_name),
-          team_name: fetch.call(:team_name),
-          **base_args
-        )
-      when 'TaskCompleted'
-        TaskCompletedHookInput.new(
-          task_id: fetch.call(:task_id),
-          task_subject: fetch.call(:task_subject),
-          task_description: fetch.call(:task_description),
-          teammate_name: fetch.call(:teammate_name),
-          team_name: fetch.call(:team_name),
-          **base_args
-        )
-      when 'ConfigChange'
-        ConfigChangeHookInput.new(
-          source: fetch.call(:source),
-          file_path: fetch.call(:file_path),
-          **base_args
-        )
-      when 'WorktreeCreate'
-        WorktreeCreateHookInput.new(
-          name: fetch.call(:name),
-          **base_args
-        )
-      when 'WorktreeRemove'
-        WorktreeRemoveHookInput.new(
-          worktree_path: fetch.call(:worktree_path),
-          **base_args
-        )
-      when 'StopFailure'
-        StopFailureHookInput.new(
-          error: fetch.call(:error),
-          error_details: fetch.call(:error_details),
-          last_assistant_message: fetch.call(:last_assistant_message),
-          **base_args
-        )
-      when 'PostCompact'
-        PostCompactHookInput.new(
-          trigger: fetch.call(:trigger),
-          compact_summary: fetch.call(:compact_summary),
-          **base_args
-        )
-      when 'PermissionDenied'
-        PermissionDeniedHookInput.new(
-          tool_name: fetch.call(:tool_name),
-          tool_input: fetch.call(:tool_input),
-          tool_use_id: fetch.call(:tool_use_id),
-          reason: fetch.call(:reason),
-          **subagent_args, **base_args
-        )
-      when 'TaskCreated'
-        TaskCreatedHookInput.new(
-          task_id: fetch.call(:task_id),
-          task_subject: fetch.call(:task_subject),
-          task_description: fetch.call(:task_description),
-          teammate_name: fetch.call(:teammate_name),
-          team_name: fetch.call(:team_name),
-          **base_args
-        )
-      when 'Elicitation'
-        ElicitationHookInput.new(
-          mcp_server_name: fetch.call(:mcp_server_name),
-          message: fetch.call(:message),
-          mode: fetch.call(:mode),
-          url: fetch.call(:url),
-          elicitation_id: fetch.call(:elicitation_id),
-          requested_schema: fetch.call(:requested_schema),
-          **base_args
-        )
-      when 'ElicitationResult'
-        ElicitationResultHookInput.new(
-          mcp_server_name: fetch.call(:mcp_server_name),
-          elicitation_id: fetch.call(:elicitation_id),
-          mode: fetch.call(:mode),
-          action: fetch.call(:action),
-          content: fetch.call(:content),
-          **base_args
-        )
-      when 'InstructionsLoaded'
-        InstructionsLoadedHookInput.new(
-          file_path: fetch.call(:file_path),
-          memory_type: fetch.call(:memory_type),
-          load_reason: fetch.call(:load_reason),
-          globs: fetch.call(:globs),
-          trigger_file_path: fetch.call(:trigger_file_path),
-          **base_args
-        )
-      when 'CwdChanged'
-        CwdChangedHookInput.new(
-          old_cwd: fetch.call(:old_cwd),
-          new_cwd: fetch.call(:new_cwd),
-          **base_args
-        )
-      when 'FileChanged'
-        FileChangedHookInput.new(
-          file_path: fetch.call(:file_path),
-          event: fetch.call(:event),
-          **base_args
-        )
-      else
-        # Unknown event: preserve the wire event name and full raw payload
-        # rather than dropping event-specific fields (Python passes the raw
-        # dict through, so nothing is lost there).
-        UnknownHookInput.new(hook_event_name: event_name, raw_input: input_data, **base_args)
-      end
+      hook_input = HOOK_INPUT_CLASSES.fetch(event_name, UnknownHookInput).from_hash(input_data)
+      hook_input.raw_input = input_data
+      hook_input
     end
 
     def handle_mcp_message(request_data)

data/lib/claude_agent_sdk/subprocess_cli_transport.rb

@@ -373,6 +373,15 @@ module ClaudeAgentSDK
         # On Windows spawn raises for :uid, wrapped below into
         # CLIConnectionError — fail-loud instead of the old silent ignore.
         opts = { chdir: @cwd&.to_s, uid: @options.user }.compact
+        # process_group: the terminal's Ctrl-C signals the whole foreground
+        # process group, so a CLI left in ours ends the turn on its own
+        # before the host can choose to interrupt, ask, or ignore it. Its own
+        # group keeps that decision with the host. Teardown still signals
+        # the pid, not the group. Windows has no :pgroup; :new_pgroup
+        # (CREATE_NEW_PROCESS_GROUP) is its equivalent, and Unix rejects it.
+        # Absent unless set, like :uid. The `-v` probe is short-lived and
+        # bounded, and stays in our group.
+        opts[Gem.win_platform? ? :new_pgroup : :pgroup] = true if @options.process_group?
 
         @stdin, @stdout, @stderr, @process = Open3.popen3(process_env, *cmd, opts)
         # The CLI emits UTF-8 regardless of the parent locale. popen3 pipes