claude_hooks 1.2.1 → 1.4.0

data/lib/claude_hooks/post_tool_use.rb

@@ -30,6 +30,13 @@ module ClaudeHooks
       @input_data['tool_use_id'] || @input_data['toolUseId']
     end
 
+    # For MCP tools: { 'name' => ..., 'source' => ... } describing where the server's
+    # definition came from (e.g. 'plugin', 'sdk', 'user', 'project'). Base trust
+    # decisions on 'source', not on the name. nil for non-MCP tools. Requires Claude Code v2.1.274+.
+    def mcp_server
+      @input_data['mcp_server'] || @input_data['mcpServer']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def block_tool!(reason = '')
@@ -59,5 +66,12 @@ module ClaudeHooks
       @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
       @output_data['hookSpecificOutput']['updatedMCPToolOutput'] = value
     end
+
+    # Annotate this call's result for the auto-mode classifier (not for Claude).
+    # Requires Claude Code v2.1.236 or later.
+    def classifier_context!(note)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['classifierContext'] = note
+    end
   end
 end

data/lib/claude_hooks/post_tool_use_failure.rb

@@ -24,6 +24,13 @@ module ClaudeHooks
       @input_data['tool_use_id'] || @input_data['toolUseId']
     end
 
+    # For MCP tools: { 'name' => ..., 'source' => ... } describing where the server's
+    # definition came from (e.g. 'plugin', 'sdk', 'user', 'project'). Base trust
+    # decisions on 'source', not on the name. nil for non-MCP tools. Requires Claude Code v2.1.274+.
+    def mcp_server
+      @input_data['mcp_server'] || @input_data['mcpServer']
+    end
+
     def error
       @input_data['error']
     end

data/lib/claude_hooks/pre_model_switch.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PreModelSwitch < Base
+    def self.hook_type
+      'PreModelSwitch'
+    end
+
+    def self.input_fields
+      %w[from_model to_model requested_model source]
+    end
+
+    # === INPUT DATA ACCESS ===
+
+    def from_model
+      @input_data['from_model'] || @input_data['fromModel']
+    end
+
+    def to_model
+      @input_data['to_model'] || @input_data['toModel']
+    end
+
+    def requested_model
+      @input_data['requested_model'] || @input_data['requestedModel']
+    end
+
+    def source
+      @input_data['source']
+    end
+
+    def context_tokens
+      @input_data['context_tokens'] || @input_data['contextTokens']
+    end
+
+    def prompt_cache_warm
+      @input_data.key?('prompt_cache_warm') ? @input_data['prompt_cache_warm'] : @input_data['promptCacheWarm']
+    end
+
+    def cache_ttl
+      @input_data['cache_ttl'] || @input_data['cacheTtl']
+    end
+
+    def estimated_cache_write_usd
+      @input_data['estimated_cache_write_usd'] || @input_data['estimatedCacheWriteUsd']
+    end
+
+    def pricing
+      @input_data['pricing']
+    end
+
+    # === OUTPUT DATA HELPERS ===
+    #
+    # PreModelSwitch mirrors PreToolUse's permissionDecision API (allow/deny/ask).
+    # It does not accept 'defer', 'updatedInput', or 'additionalContext'.
+
+    def approve!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow',
+        'permissionDecisionReason' => reason
+      }
+    end
+    alias_method :allow!, :approve!
+
+    def deny!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'deny',
+        'permissionDecisionReason' => reason
+      }
+    end
+    alias_method :block_switch!, :deny!
+
+    def ask!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'ask',
+        'permissionDecisionReason' => reason
+      }
+    end
+
+    # Top-level decision:block also cancels the switch (equivalent to exit 2).
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+  end
+end

data/lib/claude_hooks/pre_tool_use.rb

@@ -26,6 +26,13 @@ module ClaudeHooks
       @input_data['tool_use_id'] || @input_data['toolUseId']
     end
 
+    # For MCP tools: { 'name' => ..., 'source' => ... } describing where the server's
+    # definition came from (e.g. 'plugin', 'sdk', 'user', 'project'). Base trust
+    # decisions on 'source', not on the name. nil for non-MCP tools. Requires Claude Code v2.1.274+.
+    def mcp_server
+      @input_data['mcp_server'] || @input_data['mcpServer']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def approve_tool!(reason = '')

data/lib/claude_hooks/session_start.rb

@@ -26,6 +26,24 @@ module ClaudeHooks
       @input_data['session_title'] || @input_data['sessionTitle']
     end
 
+    # Optional cost/context fields present when source is "resume" or "fork".
+
+    def seconds_since_last_response
+      @input_data['seconds_since_last_response'] || @input_data['secondsSinceLastResponse']
+    end
+
+    def context_tokens
+      @input_data['context_tokens'] || @input_data['contextTokens']
+    end
+
+    def prompt_cache_likely_expired
+      @input_data.key?('prompt_cache_likely_expired') ? @input_data['prompt_cache_likely_expired'] : @input_data['promptCacheLikelyExpired']
+    end
+
+    def estimated_cache_write_usd
+      @input_data['estimated_cache_write_usd'] || @input_data['estimatedCacheWriteUsd']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def add_additional_context!(context)

data/lib/claude_hooks/setup.rb

@@ -16,6 +16,9 @@ module ClaudeHooks
       @input_data['source']
     end
 
+    # DEPRECATED: Claude Code now discards all Setup JSON output, including
+    # hookSpecificOutput.additionalContext. Kept for backward compatibility, but
+    # this no longer adds context — use a SessionStart hook to inject context instead.
     def add_additional_context!(context)
       @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
       @output_data['hookSpecificOutput']['additionalContext'] = context

data/lib/claude_hooks/task_created.rb

@@ -31,5 +31,22 @@ module ClaudeHooks
     def team_name
       @input_data['team_name'] || @input_data['teamName']
     end
+
+    # === OUTPUT DATA HELPERS ===
+    #
+    # Claude Code ignores `continue: false` for TaskCreated. Block task creation
+    # either by exiting 2 or with a top-level decision:block; `reason` is returned
+    # to Claude as the task-creation error.
+
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+
+    def allow!
+      @output_data['decision'] = nil
+      @output_data['reason'] = nil
+    end
+    alias_method :unblock!, :allow!
   end
 end

data/lib/claude_hooks/user_prompt_submit.rb

@@ -20,18 +20,39 @@ module ClaudeHooks
     alias_method :user_prompt, :prompt
     alias_method :current_prompt, :prompt
 
+    # The session's custom title, when one is set. Requires Claude Code to send it
+    # (same meaning as SessionStart's session_title).
+    def session_title
+      @input_data['session_title'] || @input_data['sessionTitle']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def add_additional_context!(context)
-      @output_data['hookSpecificOutput'] = {
-        'hookEventName' => hook_event_name,
-        'additionalContext' => context
-      }
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
     end
     alias_method :add_context!, :add_additional_context!
 
     def empty_additional_context!
-      @output_data['hookSpecificOutput'] = nil
+      hso = @output_data['hookSpecificOutput']
+      return unless hso
+
+      hso.delete('additionalContext')
+      @output_data['hookSpecificOutput'] = nil if hso.keys == ['hookEventName']
+    end
+
+    def session_title!(title)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['sessionTitle'] = title
+    end
+
+    # When the prompt is blocked (block_prompt! or exit 2), leave the prompt text out
+    # of the block message shown to the user and written to the transcript. Doesn't
+    # remove it from other local files such as prompt history.
+    def suppress_original_prompt!(value = true)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['suppressOriginalPrompt'] = value
     end
 
     def block_prompt!(reason = '')

data/lib/claude_hooks/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeHooks
-  VERSION = "1.2.1"
+  VERSION = "1.4.0"
 end

data/lib/claude_hooks.rb

@@ -37,6 +37,9 @@ require_relative "claude_hooks/permission_denied"
 require_relative "claude_hooks/elicitation"
 require_relative "claude_hooks/elicitation_result"
 require_relative "claude_hooks/worktree_create"
+require_relative "claude_hooks/directory_added"
+require_relative "claude_hooks/pre_model_switch"
+require_relative "claude_hooks/post_model_switch"
 
 # Output classes
 require_relative "claude_hooks/output/base"
@@ -70,6 +73,9 @@ require_relative "claude_hooks/output/permission_denied"
 require_relative "claude_hooks/output/elicitation"
 require_relative "claude_hooks/output/elicitation_result"
 require_relative "claude_hooks/output/worktree_create"
+require_relative "claude_hooks/output/directory_added"
+require_relative "claude_hooks/output/pre_model_switch"
+require_relative "claude_hooks/output/post_model_switch"
 
 module ClaudeHooks
   class Error < StandardError; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude_hooks
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Gabriel Dehan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-14 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -73,6 +73,7 @@ files:
 - docs/API/COMMON.md
 - docs/API/CONFIG_CHANGE.md
 - docs/API/CWD_CHANGED.md
+- docs/API/DIRECTORY_ADDED.md
 - docs/API/ELICITATION.md
 - docs/API/ELICITATION_RESULT.md
 - docs/API/FILE_CHANGED.md
@@ -82,10 +83,12 @@ files:
 - docs/API/PERMISSION_DENIED.md
 - docs/API/PERMISSION_REQUEST.md
 - docs/API/POST_COMPACT.md
+- docs/API/POST_MODEL_SWITCH.md
 - docs/API/POST_TOOL_BATCH.md
 - docs/API/POST_TOOL_USE.md
 - docs/API/POST_TOOL_USE_FAILURE.md
 - docs/API/PRE_COMPACT.md
+- docs/API/PRE_MODEL_SWITCH.md
 - docs/API/PRE_TOOL_USE.md
 - docs/API/SESSION_END.md
 - docs/API/SESSION_START.md
@@ -124,6 +127,7 @@ files:
 - lib/claude_hooks/config_change.rb
 - lib/claude_hooks/configuration.rb
 - lib/claude_hooks/cwd_changed.rb
+- lib/claude_hooks/directory_added.rb
 - lib/claude_hooks/elicitation.rb
 - lib/claude_hooks/elicitation_result.rb
 - lib/claude_hooks/file_changed.rb
@@ -134,6 +138,7 @@ files:
 - lib/claude_hooks/output/base.rb
 - lib/claude_hooks/output/config_change.rb
 - lib/claude_hooks/output/cwd_changed.rb
+- lib/claude_hooks/output/directory_added.rb
 - lib/claude_hooks/output/elicitation.rb
 - lib/claude_hooks/output/elicitation_result.rb
 - lib/claude_hooks/output/file_changed.rb
@@ -143,10 +148,12 @@ files:
 - lib/claude_hooks/output/permission_denied.rb
 - lib/claude_hooks/output/permission_request.rb
 - lib/claude_hooks/output/post_compact.rb
+- lib/claude_hooks/output/post_model_switch.rb
 - lib/claude_hooks/output/post_tool_batch.rb
 - lib/claude_hooks/output/post_tool_use.rb
 - lib/claude_hooks/output/post_tool_use_failure.rb
 - lib/claude_hooks/output/pre_compact.rb
+- lib/claude_hooks/output/pre_model_switch.rb
 - lib/claude_hooks/output/pre_tool_use.rb
 - lib/claude_hooks/output/session_end.rb
 - lib/claude_hooks/output/session_start.rb
@@ -165,10 +172,12 @@ files:
 - lib/claude_hooks/permission_denied.rb
 - lib/claude_hooks/permission_request.rb
 - lib/claude_hooks/post_compact.rb
+- lib/claude_hooks/post_model_switch.rb
 - lib/claude_hooks/post_tool_batch.rb
 - lib/claude_hooks/post_tool_use.rb
 - lib/claude_hooks/post_tool_use_failure.rb
 - lib/claude_hooks/pre_compact.rb
+- lib/claude_hooks/pre_model_switch.rb
 - lib/claude_hooks/pre_tool_use.rb
 - lib/claude_hooks/session_end.rb
 - lib/claude_hooks/session_start.rb