claude_hooks 1.0.2 → 1.2.0

data/lib/claude_hooks/permission_request.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PermissionRequest < Base
+    def self.hook_type
+      'PermissionRequest'
+    end
+
+    def self.input_fields
+      %w[tool_name tool_input tool_use_id]
+    end
+
+    # === INPUT DATA ACCESS ===
+
+    def tool_name
+      @input_data['tool_name']
+    end
+
+    def tool_input
+      @input_data['tool_input']
+    end
+
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
+    def permission_suggestions
+      @input_data['permissionSuggestions'] || @input_data['permission_suggestions'] || []
+    end
+
+    # === OUTPUT DATA HELPERS ===
+
+    def allow_permission!(reason = '')
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'decision' => { 'behavior' => 'allow' }
+      }
+      @output_data['hookSpecificOutput']['decision']['message'] = reason unless reason.empty?
+    end
+
+    def deny_permission!(reason = '', interrupt: nil)
+      decision = { 'behavior' => 'deny' }
+      decision['message'] = reason unless reason.empty?
+      decision['interrupt'] = interrupt unless interrupt.nil?
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'decision' => decision
+      }
+    end
+
+    def update_input_and_allow!(updated_input, reason = '', updated_permissions: nil)
+      decision = { 'behavior' => 'allow', 'updatedInput' => updated_input }
+      decision['message'] = reason unless reason.empty?
+      decision['updatedPermissions'] = updated_permissions unless updated_permissions.nil?
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'decision' => decision
+      }
+    end
+  end
+end

data/lib/claude_hooks/post_compact.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PostCompact < Base
+    def self.hook_type
+      'PostCompact'
+    end
+
+    def self.input_fields
+      %w[trigger compact_summary]
+    end
+
+    def trigger
+      @input_data['trigger']
+    end
+
+    def compact_summary
+      @input_data['compact_summary'] || @input_data['compactSummary']
+    end
+  end
+end

data/lib/claude_hooks/post_tool_batch.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PostToolBatch < Base
+    def self.hook_type
+      'PostToolBatch'
+    end
+
+    def self.input_fields
+      %w[tool_calls]
+    end
+
+    def tool_calls
+      @input_data['tool_calls'] || @input_data['toolCalls'] || []
+    end
+
+    # Convenience partitions over tool_calls. Entries carry a `tool_response`
+    # rather than an explicit success flag, so success is derived from the
+    # presence of a response that isn't flagged as an error. When your payload
+    # shape differs, use the raw `tool_calls` array instead.
+    def succeeded_calls
+      tool_calls.reject { |call| failed_call?(call) }
+    end
+
+    def failed_calls
+      tool_calls.select { |call| failed_call?(call) }
+    end
+
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+
+    private
+
+    # A call is considered failed when its response is missing or carries an
+    # error marker (`is_error`/`isError` true, or an `error` key).
+    def failed_call?(call)
+      return true unless call.is_a?(Hash)
+
+      response = call['tool_response'] || call['toolResponse']
+      return true if response.nil?
+
+      if response.is_a?(Hash)
+        return true if response['is_error'] == true || response['isError'] == true
+        return true if response.key?('error') && !response['error'].nil?
+      end
+
+      false
+    end
+  end
+end

data/lib/claude_hooks/post_tool_use.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
     end
 
     def self.input_fields
-      %w[tool_name tool_input tool_response]
+      %w[tool_name tool_input tool_response tool_use_id]
     end
 
     # === INPUT DATA ACCESS ===
@@ -26,6 +26,10 @@ module ClaudeHooks
       @input_data['tool_response']
     end
 
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def block_tool!(reason = '')
@@ -45,5 +49,15 @@ module ClaudeHooks
       }
     end
     alias_method :add_context!, :add_additional_context!
+
+    def update_tool_output!(value)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['updatedToolOutput'] = value
+    end
+
+    def update_mcp_tool_output!(value)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['updatedMCPToolOutput'] = value
+    end
   end
 end

data/lib/claude_hooks/post_tool_use_failure.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class PostToolUseFailure < Base
+    def self.hook_type
+      'PostToolUseFailure'
+    end
+
+    def self.input_fields
+      %w[tool_name tool_input tool_use_id error]
+    end
+
+    def tool_name
+      @input_data['tool_name']
+    end
+
+    def tool_input
+      @input_data['tool_input']
+    end
+
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
+    def error
+      @input_data['error']
+    end
+
+    def is_interrupt
+      @input_data.key?('is_interrupt') ? @input_data['is_interrupt'] : @input_data['isInterrupt']
+    end
+    alias_method :interrupt?, :is_interrupt
+
+    def duration_ms
+      @input_data['duration_ms'] || @input_data['durationMs']
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+  end
+end

data/lib/claude_hooks/pre_compact.rb

@@ -27,6 +27,13 @@ module ClaudeHooks
       end
     end
 
+    # === OUTPUT DATA HELPERS ===
+
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+
     # === UTILITY HELPERS ===
 
     def backup_transcript!(backup_file_path)

data/lib/claude_hooks/pre_tool_use.rb

@@ -9,7 +9,7 @@ module ClaudeHooks
     end
 
     def self.input_fields
-      %w[tool_name tool_input]
+      %w[tool_name tool_input tool_use_id]
     end
 
     # === INPUT DATA ACCESS ===
@@ -22,6 +22,10 @@ module ClaudeHooks
       @input_data['tool_input']
     end
 
+    def tool_use_id
+      @input_data['tool_use_id'] || @input_data['toolUseId']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def approve_tool!(reason = '')
@@ -47,5 +51,34 @@ module ClaudeHooks
         'permissionDecisionReason' => reason
       }
     end
+
+    def update_tool_input!(updated_input)
+      @output_data['hookSpecificOutput'] ||= {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow'
+      }
+      @output_data['hookSpecificOutput']['updatedInput'] = updated_input
+      @output_data['hookSpecificOutput']['permissionDecision'] = 'allow'
+    end
+
+    def defer_permission!
+      @output_data['hookSpecificOutput'] = {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'defer'
+      }
+    end
+
+    def update_input!(updated_input)
+      @output_data['hookSpecificOutput'] ||= {
+        'hookEventName' => hook_event_name,
+        'permissionDecision' => 'allow'
+      }
+      @output_data['hookSpecificOutput']['updatedInput'] = updated_input
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
   end
 end

data/lib/claude_hooks/session_start.rb

@@ -18,6 +18,14 @@ module ClaudeHooks
       @input_data['source']
     end
 
+    def model
+      @input_data['model']
+    end
+
+    def session_title
+      @input_data['session_title'] || @input_data['sessionTitle']
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     def add_additional_context!(context)
@@ -31,5 +39,25 @@ module ClaudeHooks
     def empty_additional_context!
       @output_data['hookSpecificOutput'] = nil
     end
+
+    def session_title!(title)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['sessionTitle'] = title
+    end
+
+    def initial_user_message!(message)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['initialUserMessage'] = message
+    end
+
+    def watch_paths!(paths)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['watchPaths'] = Array(paths)
+    end
+
+    def reload_skills!(value = true)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['reloadSkills'] = value
+    end
   end
 end

data/lib/claude_hooks/setup.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class Setup < Base
+    def self.hook_type
+      'Setup'
+    end
+
+    def self.input_fields
+      %w[source]
+    end
+
+    def source
+      @input_data['source']
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+    alias_method :add_context!, :add_additional_context!
+  end
+end

data/lib/claude_hooks/stop.rb

@@ -26,6 +26,18 @@ module ClaudeHooks
       @input_data['stop_hook_active']
     end
 
+    def last_assistant_message
+      @input_data['last_assistant_message'] || @input_data['lastAssistantMessage']
+    end
+
+    def background_tasks
+      @input_data['background_tasks'] || @input_data['backgroundTasks'] || []
+    end
+
+    def session_crons
+      @input_data['session_crons'] || @input_data['sessionCrons'] || []
+    end
+
     # === OUTPUT DATA HELPERS ===
 
     # Block Claude from stopping (force it to continue)
@@ -40,5 +52,10 @@ module ClaudeHooks
       @output_data.delete('decision')
       @output_data.delete('reason')
     end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
   end
 end

data/lib/claude_hooks/stop_failure.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class StopFailure < Base
+    def self.hook_type
+      'StopFailure'
+    end
+
+    def self.input_fields
+      %w[error]
+    end
+
+    def error
+      @input_data['error']
+    end
+
+    def error_details
+      @input_data['error_details'] || @input_data['errorDetails']
+    end
+
+    def last_assistant_message
+      @input_data['last_assistant_message'] || @input_data['lastAssistantMessage']
+    end
+  end
+end

data/lib/claude_hooks/subagent_start.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class SubagentStart < Base
+    def self.hook_type
+      'SubagentStart'
+    end
+
+    def self.input_fields
+      %w[agent_id agent_type]
+    end
+
+    # agent_id and agent_type readers come from Base (Part A)
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+    alias_method :add_context!, :add_additional_context!
+  end
+end

data/lib/claude_hooks/subagent_stop.rb

@@ -7,5 +7,9 @@ module ClaudeHooks
     def self.hook_type
       'SubagentStop'
     end
+
+    def agent_transcript_path
+      @input_data['agent_transcript_path'] || @input_data['agentTranscriptPath']
+    end
   end
-end
+end

data/lib/claude_hooks/task_completed.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TaskCompleted < Base
+    def self.hook_type
+      'TaskCompleted'
+    end
+
+    def self.input_fields
+      %w[task_id task_subject]
+    end
+
+    def task_id
+      @input_data['task_id'] || @input_data['taskId']
+    end
+
+    def task_subject
+      @input_data['task_subject'] || @input_data['taskSubject']
+    end
+
+    def task_description
+      @input_data['task_description'] || @input_data['taskDescription']
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/task_created.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TaskCreated < Base
+    def self.hook_type
+      'TaskCreated'
+    end
+
+    def self.input_fields
+      %w[task_id task_subject]
+    end
+
+    def task_id
+      @input_data['task_id'] || @input_data['taskId']
+    end
+
+    def task_subject
+      @input_data['task_subject'] || @input_data['taskSubject']
+    end
+
+    def task_description
+      @input_data['task_description'] || @input_data['taskDescription']
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/teammate_idle.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class TeammateIdle < Base
+    def self.hook_type
+      'TeammateIdle'
+    end
+
+    def self.input_fields
+      %w[teammate_name team_name]
+    end
+
+    def teammate_name
+      @input_data['teammate_name'] || @input_data['teammateName']
+    end
+
+    def team_name
+      @input_data['team_name'] || @input_data['teamName']
+    end
+  end
+end

data/lib/claude_hooks/user_prompt_expansion.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class UserPromptExpansion < Base
+    def self.hook_type
+      'UserPromptExpansion'
+    end
+
+    def self.input_fields
+      %w[expansion_type command_name command_args command_source prompt]
+    end
+
+    def expansion_type
+      @input_data['expansion_type'] || @input_data['expansionType']
+    end
+
+    def command_name
+      @input_data['command_name'] || @input_data['commandName']
+    end
+
+    def command_args
+      @input_data['command_args'] || @input_data['commandArgs']
+    end
+
+    def command_source
+      @input_data['command_source'] || @input_data['commandSource']
+    end
+
+    def prompt
+      @input_data['prompt']
+    end
+
+    def block!(reason = '')
+      @output_data['decision'] = 'block'
+      @output_data['reason'] = reason
+    end
+
+    def add_additional_context!(context)
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['additionalContext'] = context
+    end
+  end
+end

data/lib/claude_hooks/version.rb

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

data/lib/claude_hooks/worktree_create.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class WorktreeCreate < Base
+    def self.hook_type
+      'WorktreeCreate'
+    end
+
+    def self.input_fields
+      %w[name]
+    end
+
+    def name
+      @input_data['name']
+    end
+
+    # Emit the worktree path as bare stdout (last non-empty line).
+    # Also sets hookSpecificOutput.worktreePath for programmatic access.
+    def worktree_path!(path)
+      @output_data['_worktree_path'] = path
+      @output_data['hookSpecificOutput'] ||= { 'hookEventName' => hook_event_name }
+      @output_data['hookSpecificOutput']['worktreePath'] = path
+    end
+  end
+end

data/lib/claude_hooks/worktree_remove.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module ClaudeHooks
+  class WorktreeRemove < Base
+    def self.hook_type
+      'WorktreeRemove'
+    end
+
+    def self.input_fields
+      %w[worktree_path]
+    end
+
+    def worktree_path
+      @input_data['worktree_path'] || @input_data['worktreePath']
+    end
+  end
+end