mirror of
https://github.com/openai/codex.git
synced 2026-05-23 12:34:25 +00:00
d661ab70ed
# What `SubagentStart` runs once when Codex creates a thread-spawned subagent, before that child sends its first model request. Thread-spawned subagents use `SubagentStart` instead of the normal root-agent `SessionStart` hook. Configured handlers match on the subagent `agent_type`, using the same value passed to `spawn_agent`. When no agent type is specified, Codex uses the default agent type. Hook input includes the normal session-start fields plus: - `agent_id`: the child thread id. - `agent_type`: the resolved subagent type. `SubagentStart` may return `hookSpecificOutput.additionalContext`. That context is added to the child conversation before the first model request. # Lifecycle Scope Only thread-spawned subagents run `SubagentStart`. Internal/system subagents such as Review, Compact, MemoryConsolidation, and Other do not run normal `SessionStart` hooks and do not run `SubagentStart`. This avoids exposing synthetic matcher labels for internal implementation paths. Also the `SessionStart` hook no longer fires for subagents, this matches behavior with other coding agents' implementation # Stack 1. This PR: add `SubagentStart`. 2. #22873: add `SubagentStop`. 3. #22882: add subagent identity to normal hook inputs.
106 lines
3.4 KiB
Rust
106 lines
3.4 KiB
Rust
mod config_rules;
|
|
mod declarations;
|
|
mod engine;
|
|
pub(crate) mod events;
|
|
mod legacy_notify;
|
|
mod output_spill;
|
|
mod registry;
|
|
mod schema;
|
|
mod types;
|
|
|
|
use codex_protocol::protocol::HookEventName;
|
|
|
|
pub use config_rules::hook_states_from_stack;
|
|
pub use declarations::PluginHookDeclaration;
|
|
pub use declarations::plugin_hook_declarations;
|
|
pub use engine::HookListEntry;
|
|
/// Hook event names as they appear in hooks JSON and config files.
|
|
pub const HOOK_EVENT_NAMES: [&str; 9] = [
|
|
"PreToolUse",
|
|
"PermissionRequest",
|
|
"PostToolUse",
|
|
"PreCompact",
|
|
"PostCompact",
|
|
"SessionStart",
|
|
"UserPromptSubmit",
|
|
"SubagentStart",
|
|
"Stop",
|
|
];
|
|
|
|
/// Hook event names whose matcher fields are meaningful during dispatch.
|
|
///
|
|
/// Other events can appear in hooks JSON, but Codex ignores their matcher
|
|
/// fields because those events do not dispatch against a tool, compaction
|
|
/// trigger, or session-start source.
|
|
pub const HOOK_EVENT_NAMES_WITH_MATCHERS: [&str; 7] = [
|
|
"PreToolUse",
|
|
"PermissionRequest",
|
|
"PostToolUse",
|
|
"PreCompact",
|
|
"PostCompact",
|
|
"SessionStart",
|
|
"SubagentStart",
|
|
];
|
|
|
|
pub use events::compact::PostCompactRequest;
|
|
pub use events::compact::PreCompactOutcome;
|
|
pub use events::compact::PreCompactRequest;
|
|
pub use events::compact::StatelessHookOutcome;
|
|
pub use events::permission_request::PermissionRequestDecision;
|
|
pub use events::permission_request::PermissionRequestOutcome;
|
|
pub use events::permission_request::PermissionRequestRequest;
|
|
pub use events::post_tool_use::PostToolUseOutcome;
|
|
pub use events::post_tool_use::PostToolUseRequest;
|
|
pub use events::pre_tool_use::PreToolUseOutcome;
|
|
pub use events::pre_tool_use::PreToolUseRequest;
|
|
pub use events::session_start::SessionStartOutcome;
|
|
pub use events::session_start::SessionStartRequest;
|
|
pub use events::session_start::SessionStartSource;
|
|
pub use events::session_start::StartHookTarget;
|
|
pub use events::stop::StopOutcome;
|
|
pub use events::stop::StopRequest;
|
|
pub use events::user_prompt_submit::UserPromptSubmitOutcome;
|
|
pub use events::user_prompt_submit::UserPromptSubmitRequest;
|
|
pub use legacy_notify::legacy_notify_json;
|
|
pub use legacy_notify::notify_hook;
|
|
pub use registry::HookListOutcome;
|
|
pub use registry::Hooks;
|
|
pub use registry::HooksConfig;
|
|
pub use registry::command_from_argv;
|
|
pub use registry::list_hooks;
|
|
pub use schema::write_schema_fixtures;
|
|
pub use types::Hook;
|
|
pub use types::HookEvent;
|
|
pub use types::HookEventAfterAgent;
|
|
pub use types::HookPayload;
|
|
pub use types::HookResponse;
|
|
pub use types::HookResult;
|
|
|
|
/// Returns the hook event label used in persisted hook-state keys.
|
|
pub fn hook_event_key_label(event_name: HookEventName) -> &'static str {
|
|
match event_name {
|
|
HookEventName::PreToolUse => "pre_tool_use",
|
|
HookEventName::PermissionRequest => "permission_request",
|
|
HookEventName::PostToolUse => "post_tool_use",
|
|
HookEventName::PreCompact => "pre_compact",
|
|
HookEventName::PostCompact => "post_compact",
|
|
HookEventName::SessionStart => "session_start",
|
|
HookEventName::UserPromptSubmit => "user_prompt_submit",
|
|
HookEventName::SubagentStart => "subagent_start",
|
|
HookEventName::Stop => "stop",
|
|
}
|
|
}
|
|
|
|
/// Builds the persisted config-state key for one discovered hook handler.
|
|
pub fn hook_key(
|
|
key_source: &str,
|
|
event_name: HookEventName,
|
|
group_index: usize,
|
|
handler_index: usize,
|
|
) -> String {
|
|
format!(
|
|
"{key_source}:{}:{group_index}:{handler_index}",
|
|
hook_event_key_label(event_name)
|
|
)
|
|
}
|