pub(crate) mod command_runner; pub(crate) mod discovery; pub(crate) mod dispatcher; pub(crate) mod output_parser; pub(crate) mod schema_loader; use crate::events::compact::PostCompactRequest; use crate::events::compact::PreCompactOutcome; use crate::events::compact::PreCompactRequest; use crate::events::compact::StatelessHookOutcome; use crate::events::permission_request::PermissionRequestOutcome; use crate::events::permission_request::PermissionRequestRequest; use crate::events::post_tool_use::PostToolUseOutcome; use crate::events::post_tool_use::PostToolUseRequest; use crate::events::pre_tool_use::PreToolUseOutcome; use crate::events::pre_tool_use::PreToolUseRequest; use crate::events::session_end::SessionEndOutcome; use crate::events::session_end::SessionEndRequest; use crate::events::session_start::SessionStartOutcome; use crate::events::session_start::SessionStartRequest; use crate::events::stop::StopOutcome; use crate::events::stop::StopRequest; use crate::events::user_prompt_submit::UserPromptSubmitOutcome; use crate::events::user_prompt_submit::UserPromptSubmitRequest; use crate::output_spill::AdditionalContextLimit; use codex_config::ConfigLayerStack; use codex_plugin::PluginHookSource; use codex_protocol::protocol::HookEventName; use codex_protocol::protocol::HookExecutionMode; use codex_protocol::protocol::HookHandlerType; use codex_protocol::protocol::HookRunSummary; use codex_protocol::protocol::HookSource; use codex_protocol::protocol::HookTrustStatus; use codex_utils_absolute_path::AbsolutePathBuf; use std::collections::HashMap; use std::time::Duration; use command_runner::CommandHookRuntime; #[derive(Debug, Clone)] pub(crate) struct CommandShell { pub program: String, pub args: Vec, } #[derive(Debug, Clone, PartialEq, Eq)] pub(crate) struct ConfiguredHandler { pub event_name: codex_protocol::protocol::HookEventName, pub execution_mode: HookExecutionMode, pub matcher: Option, pub command: String, pub timeout_sec: u64, pub status_message: Option, pub additional_context_limit: AdditionalContextLimit, pub source_path: AbsolutePathBuf, pub source: HookSource, pub display_order: i64, pub env: HashMap, } impl ConfiguredHandler { /// Only synchronous hooks can apply control effects. pub(crate) fn can_apply_control_effects(&self) -> bool { self.execution_mode == HookExecutionMode::Sync } pub fn run_id(&self) -> String { format!( "{}:{}:{}", self.event_name_label(), self.display_order, self.source_path.display() ) } fn event_name_label(&self) -> &'static str { match self.event_name { codex_protocol::protocol::HookEventName::PreToolUse => "pre-tool-use", codex_protocol::protocol::HookEventName::PermissionRequest => "permission-request", codex_protocol::protocol::HookEventName::PostToolUse => "post-tool-use", codex_protocol::protocol::HookEventName::PreCompact => "pre-compact", codex_protocol::protocol::HookEventName::PostCompact => "post-compact", codex_protocol::protocol::HookEventName::SessionStart => "session-start", codex_protocol::protocol::HookEventName::SessionEnd => "session-end", codex_protocol::protocol::HookEventName::UserPromptSubmit => "user-prompt-submit", codex_protocol::protocol::HookEventName::SubagentStart => "subagent-start", codex_protocol::protocol::HookEventName::SubagentStop => "subagent-stop", codex_protocol::protocol::HookEventName::Stop => "stop", } } } #[derive(Debug, Clone, PartialEq, Eq)] pub struct HookListEntry { pub key: String, pub event_name: HookEventName, pub handler_type: HookHandlerType, pub matcher: Option, pub command: Option, pub timeout_sec: u64, pub status_message: Option, pub additional_context_limit: Option, pub source_path: AbsolutePathBuf, pub source: HookSource, pub plugin_id: Option, pub display_order: i64, pub enabled: bool, pub is_managed: bool, pub current_hash: String, pub trust_status: HookTrustStatus, } #[derive(Clone)] pub(crate) struct ClaudeHooksEngine { handlers: Vec, warnings: Vec, pub(crate) command_runtime: CommandHookRuntime, } impl ClaudeHooksEngine { pub(crate) fn new( enabled: bool, bypass_hook_trust: bool, config_layer_stack: Option<&ConfigLayerStack>, plugin_hook_sources: Vec, plugin_hook_load_warnings: Vec, command_runtime: CommandHookRuntime, ) -> Self { if !enabled { return Self { handlers: Vec::new(), warnings: Vec::new(), command_runtime, }; } let _ = schema_loader::generated_hook_schemas(); let discovered = discovery::discover_handlers( config_layer_stack, plugin_hook_sources, plugin_hook_load_warnings, bypass_hook_trust, ); Self { handlers: discovered.handlers, warnings: discovered.warnings, command_runtime, } } pub(crate) fn warnings(&self) -> &[String] { &self.warnings } pub(crate) fn preview_session_start( &self, request: &SessionStartRequest, ) -> Vec { crate::events::session_start::preview(&self.handlers, request) } pub(crate) fn preview_pre_tool_use(&self, request: &PreToolUseRequest) -> Vec { crate::events::pre_tool_use::preview(&self.handlers, request) } pub(crate) fn preview_permission_request( &self, request: &PermissionRequestRequest, ) -> Vec { crate::events::permission_request::preview(&self.handlers, request) } pub(crate) fn max_permission_request_timeout(&self) -> Duration { Duration::from_secs( self.handlers .iter() .filter(|handler| { handler.event_name == HookEventName::PermissionRequest && handler.execution_mode == HookExecutionMode::Sync }) .map(|handler| handler.timeout_sec) .max() .unwrap_or_default(), ) } pub(crate) fn preview_post_tool_use( &self, request: &PostToolUseRequest, ) -> Vec { crate::events::post_tool_use::preview(&self.handlers, request) } pub(crate) async fn run_session_start( &self, request: SessionStartRequest, turn_id: Option, ) -> SessionStartOutcome { crate::events::session_start::run(&self.handlers, &self.command_runtime, request, turn_id) .await } pub(crate) async fn run_pre_tool_use(&self, request: PreToolUseRequest) -> PreToolUseOutcome { crate::events::pre_tool_use::run(&self.handlers, &self.command_runtime, request).await } pub(crate) async fn run_permission_request( &self, request: PermissionRequestRequest, ) -> PermissionRequestOutcome { crate::events::permission_request::run(&self.handlers, &self.command_runtime, request).await } pub(crate) async fn run_post_tool_use( &self, request: PostToolUseRequest, ) -> PostToolUseOutcome { let mut outcome = crate::events::post_tool_use::run(&self.handlers, &self.command_runtime, request).await; if let Some(feedback_message) = outcome.feedback_message.take() { outcome.feedback_message = Some( self.command_runtime .output_spiller() .maybe_spill_text(feedback_message) .await, ); } outcome } pub(crate) fn preview_pre_compact(&self, request: &PreCompactRequest) -> Vec { crate::events::compact::preview_pre(&self.handlers, request) } pub(crate) async fn run_pre_compact(&self, request: PreCompactRequest) -> PreCompactOutcome { crate::events::compact::run_pre(&self.handlers, &self.command_runtime, request).await } pub(crate) fn preview_post_compact(&self, request: &PostCompactRequest) -> Vec { crate::events::compact::preview_post(&self.handlers, request) } pub(crate) async fn run_post_compact( &self, request: PostCompactRequest, ) -> StatelessHookOutcome { crate::events::compact::run_post(&self.handlers, &self.command_runtime, request).await } pub(crate) fn preview_user_prompt_submit( &self, request: &UserPromptSubmitRequest, ) -> Vec { crate::events::user_prompt_submit::preview(&self.handlers, request) } pub(crate) async fn run_user_prompt_submit( &self, request: UserPromptSubmitRequest, ) -> UserPromptSubmitOutcome { crate::events::user_prompt_submit::run(&self.handlers, &self.command_runtime, request).await } pub(crate) fn preview_stop(&self, request: &StopRequest) -> Vec { crate::events::stop::preview(&self.handlers, request) } pub(crate) fn preview_session_end(&self) -> Vec { crate::events::session_end::preview(&self.handlers) } pub(crate) async fn run_session_end(&self, request: SessionEndRequest) -> SessionEndOutcome { crate::events::session_end::run(&self.handlers, &self.command_runtime, request).await } pub(crate) async fn run_stop(&self, request: StopRequest) -> StopOutcome { let mut outcome = crate::events::stop::run(&self.handlers, &self.command_runtime, request).await; outcome.continuation_fragments = self .command_runtime .output_spiller() .maybe_spill_prompt_fragments(outcome.continuation_fragments) .await; outcome } } #[cfg(test)] #[path = "mod_tests.rs"] mod tests;