II.
HookSurface JSON
Structured · livehook-surface:claude.post-tool-use-failure
PostToolUseFailure (Claude Code) json
Inspect the normalized record payload exactly as the atlas UI reads it.
{
"id": "hook-surface:claude.post-tool-use-failure",
"_kind": "HookSurface",
"_file": "channels-hooks/hook-surfaces/native/claude-code-extended-hooks.yaml",
"_cluster": "channels-hooks",
"attributes": {
"eventName": "PostToolUseFailure (Claude Code)",
"displayName": "PostToolUseFailure (Claude Code)",
"kind": "native",
"originVendor": "Anthropic",
"direction": "post",
"blocking": true,
"family": "in-process",
"payloadSchema": {
"type": "object",
"required": [
"hook_event_name",
"tool_name",
"tool_input",
"tool_use_id",
"error_message"
],
"properties": {
"hook_event_name": {
"type": "string",
"const": "PostToolUseFailure"
},
"tool_name": {
"type": "string"
},
"tool_input": {
"type": "object"
},
"tool_use_id": {
"type": "string"
},
"error_message": {
"type": "string"
}
}
},
"description": "Fires when a tool call fails. Same payload shape as PostToolUse but\nwith error_message instead of tool_result. Subscribers can stop the\nagentic loop via decision: \"block\".\n"
},
"outgoingEdges": [
{
"from": "hook-surface:claude.post-tool-use-failure",
"to": "hook-surface:post-tool-use",
"kind": "canonicalized_to",
"attributes": {}
}
],
"incomingEdges": [
{
"from": "agent-runtime-impl:claude-code.runtime@1.x",
"to": "hook-surface:claude.post-tool-use-failure",
"kind": "exposes",
"attributes": {}
},
{
"from": "hook-mapping:claude-post-tool-use-failure",
"to": "hook-surface:claude.post-tool-use-failure",
"kind": "maps_hook",
"attributes": {}
}
]
}