claude_hooks 1.1.0 → 1.2.0

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

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

@@ -58,9 +58,27 @@ module ClaudeHooks
         'permissionDecision' => 'allow'
       }
       @output_data['hookSpecificOutput']['updatedInput'] = updated_input
-
-      # Ensure permission decision is 'allow' when updating 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.1.0"
+  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

data/lib/claude_hooks.rb

@@ -12,11 +12,31 @@ require_relative "claude_hooks/pre_tool_use"
 require_relative "claude_hooks/permission_request"
 require_relative "claude_hooks/post_tool_use"
 require_relative "claude_hooks/notification"
+require_relative "claude_hooks/message_display"
 require_relative "claude_hooks/stop"
 require_relative "claude_hooks/subagent_stop"
 require_relative "claude_hooks/pre_compact"
 require_relative "claude_hooks/session_start"
 require_relative "claude_hooks/session_end"
+require_relative "claude_hooks/setup"
+require_relative "claude_hooks/subagent_start"
+require_relative "claude_hooks/user_prompt_expansion"
+require_relative "claude_hooks/post_tool_batch"
+require_relative "claude_hooks/config_change"
+require_relative "claude_hooks/task_created"
+require_relative "claude_hooks/task_completed"
+require_relative "claude_hooks/teammate_idle"
+require_relative "claude_hooks/post_tool_use_failure"
+require_relative "claude_hooks/stop_failure"
+require_relative "claude_hooks/post_compact"
+require_relative "claude_hooks/cwd_changed"
+require_relative "claude_hooks/file_changed"
+require_relative "claude_hooks/instructions_loaded"
+require_relative "claude_hooks/worktree_remove"
+require_relative "claude_hooks/permission_denied"
+require_relative "claude_hooks/elicitation"
+require_relative "claude_hooks/elicitation_result"
+require_relative "claude_hooks/worktree_create"
 
 # Output classes
 require_relative "claude_hooks/output/base"
@@ -25,11 +45,31 @@ require_relative "claude_hooks/output/pre_tool_use"
 require_relative "claude_hooks/output/permission_request"
 require_relative "claude_hooks/output/post_tool_use"
 require_relative "claude_hooks/output/notification"
+require_relative "claude_hooks/output/message_display"
 require_relative "claude_hooks/output/stop"
 require_relative "claude_hooks/output/subagent_stop"
 require_relative "claude_hooks/output/pre_compact"
 require_relative "claude_hooks/output/session_start"
 require_relative "claude_hooks/output/session_end"
+require_relative "claude_hooks/output/setup"
+require_relative "claude_hooks/output/subagent_start"
+require_relative "claude_hooks/output/user_prompt_expansion"
+require_relative "claude_hooks/output/post_tool_batch"
+require_relative "claude_hooks/output/config_change"
+require_relative "claude_hooks/output/task_created"
+require_relative "claude_hooks/output/task_completed"
+require_relative "claude_hooks/output/teammate_idle"
+require_relative "claude_hooks/output/post_tool_use_failure"
+require_relative "claude_hooks/output/stop_failure"
+require_relative "claude_hooks/output/post_compact"
+require_relative "claude_hooks/output/cwd_changed"
+require_relative "claude_hooks/output/file_changed"
+require_relative "claude_hooks/output/instructions_loaded"
+require_relative "claude_hooks/output/worktree_remove"
+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"
 
 module ClaudeHooks
   class Error < StandardError; end