II.
HookSurface overview
Reference · livehook-surface:post-tool-use
PostToolUse (canonical) overview
Canonical post-tool-use hook. Fires after every tool invocation completes, providing input and output for telemetry / governance.
Attributes
eventName
PostToolUse (canonical)
displayName
PostToolUse (canonical)
kind
canonical
direction
post
blocking
false
family
shell-hook
payloadSchema
type
object
required
- tool_name
- tool_input
- tool_response
- session_id
- transcript_path
properties
tool_name
type
string
tool_input
type
object
tool_response
type
object
description
Result returned by the tool (success or error).
session_id
type
string
transcript_path
type
string
cwd
type
string
description
Canonical post-tool-use hook. Fires after every tool invocation
completes, providing input and output for telemetry / governance.
Outgoing edges
None.
Incoming edges
canonicalized_to9
- hook-surface:claude.post-tool-use-failure·HookSurfacePostToolUseFailure (Claude Code)
- hook-surface:gemini.post-response·HookSurfacepost_response (Gemini)
- hook-surface:gemini.tool-call-post·HookSurfacetool_call_post (Gemini)
- hook-surface:hermes.on-event·HookSurfaceonEvent (Hermes)
- hook-surface:claude.post-tool-use·HookSurfacePostToolUse (Claude)
- hook-surface:omp.on-event·HookSurfaceonEvent (OMP)
- hook-surface:openclaw.on-event·HookSurfaceonEvent (OpenClaw)
- hook-surface:opencode.on-step·HookSurfaceon_step (OpenCode)
- hook-surface:pi.on-event·HookSurfaceonEvent (Pi)
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
fires_hook3
- agent-core-impl:a5c.core@current·AgentCoreImpla5c Unified Core (current) — unified agent loop
- agent-core-impl:claude-agent-sdk.core@current·AgentCoreImplClaude Agent SDK Core (current)
- agent-core-impl:claude-code.core@1.x·AgentCoreImplClaude Code Core (1.x)
maps_hook14
- hook-mapping:post-tool-use-antigravity·HookMapping
- hook-mapping:post-tool-use-opencode·HookMapping
- hook-mapping:post-tool-use-gemini·HookMapping
- hook-mapping:post-tool-use-hermes·HookMapping
- hook-mapping:post-tool-use-claude-code·HookMapping
- hook-mapping:post-tool-use-omp·HookMapping
- hook-mapping:post-tool-use-opencode·HookMapping
- hook-mapping:post-tool-use-codex·HookMapping
- hook-mapping:post-tool-use-cursor·HookMapping
- hook-mapping:tool-after-gemini·HookMapping
- hook-mapping:tool-after-copilot·HookMapping
- hook-mapping:tool-result-oh-my-pi·HookMapping
- hook-mapping:plugin-tool-after-openclaw·HookMapping
- hook-mapping:post-tool-use-pi·HookMapping