iiRecord
Agentic AI Atlas · PostToolUseFailure (Claude Code)
hook-surface:claude.post-tool-use-failurea5c.ai
II.
HookSurface JSON

hook-surface:claude.post-tool-use-failure

Structured · live

PostToolUseFailure (Claude Code) json

Inspect the normalized record payload exactly as the atlas UI reads it.

File · channels-hooks/hook-surfaces/native/claude-code-extended-hooks.yamlCluster · channels-hooks
Record JSON
{
  "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": {}
    }
  ]
}