II.
HookSurface overview
Reference · livehook-surface:claude.stop-failure
StopFailure (Claude Code) overview
Fires when a turn ends due to an API error (rate limit, auth, billing, server error, etc.). Non-blocking — for telemetry / alerting only. Output and exit code are ignored. Matcher accepts the error_type enum value.
Attributes
eventName
StopFailure (Claude Code)
displayName
StopFailure (Claude Code)
kind
native
originVendor
Anthropic
direction
post
blocking
false
family
observer
payloadSchema
type
object
required
- hook_event_name
- error_type
- error_message
properties
hook_event_name
type
string
const
StopFailure
error_type
type
string
enum
- rate_limit
- authentication_failed
- oauth_org_not_allowed
- billing_error
- invalid_request
- server_error
- max_output_tokens
- unknown
error_message
type
string
description
Fires when a turn ends due to an API error (rate limit, auth, billing,
server error, etc.). Non-blocking — for telemetry / alerting only.
Output and exit code are ignored. Matcher accepts the error_type
enum value.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-stop-failure·HookMapping