Add MCP tool handler support to the hooks engine (#38705)

## What changed

- Discover synchronous `mcp_tool` hook handlers and invoke their configured MCP server and tool through a supplied executor.
- Expand nested hook-event placeholders in MCP tool inputs while preserving JSON types, and process tool output through the existing hook output contract.
- Represent hook details as handler-specific metadata in `hooks/list`, including MCP server and tool fields, and show those details in the TUI hooks browser.
- Skip unsupported `SessionEnd` MCP hooks and runtimes without MCP invocation support with startup warnings.

## Testing

- Cover argument expansion, missing placeholders, MCP invocation and hook decisions, discovery warnings, `hooks/list` metadata, and TUI rendering.

GitOrigin-RevId: 295b845471fe92bd7ad7cd272fbcd2c3713912e0
This commit is contained in:
Abhinav authored and copyberry committed 2026-08-15 05:53:54 +00:00
1 parent 3685a61dad
commit 85fc4def35
33 files changed
+1351 -182

No files matched your search

@@ -3396,6 +3396,45 @@ fn user_input_into_core_preserves_media_fields() {
);
}
#[test]
fn hook_handler_metadata_only_exposes_async_for_commands() {
assert_eq!(
serde_json::to_value(HookHandlerMetadata::Command {
command: "echo hello".to_string(),
r#async: true,
})
.unwrap(),
json!({
"handlerType": "command",
"command": "echo hello",
"async": true,
}),
);
assert_eq!(
serde_json::from_value::<HookHandlerMetadata>(json!({
"handlerType": "command",
"command": "echo hello",
}))
.unwrap(),
HookHandlerMetadata::Command {
command: "echo hello".to_string(),
r#async: false,
},
);
assert_eq!(
serde_json::to_value(HookHandlerMetadata::McpTool {
server: "security".to_string(),
tool: "scan".to_string(),
})
.unwrap(),
json!({
"handlerType": "mcpTool",
"server": "security",
"tool": "scan",
}),
);
}
#[test]
fn skills_list_params_serialization_uses_force_reload() {
assert_eq!(