II.
HookSurface overview
Reference · livehook-surface:claude.post-tool-use-failure
PostToolUseFailure (Claude Code) overview
Fires when a tool call fails. Same payload shape as PostToolUse but with error_message instead of tool_result. Subscribers can stop the agentic loop via decision: "block".
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
with error_message instead of tool_result. Subscribers can stop the
agentic loop via decision: "block".
Outgoing edges
canonicalized_to1
- hook-surface:post-tool-use·HookSurfacePostToolUse (canonical)
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-post-tool-use-failure·HookMapping