II.
HookSurface overview
Reference · livehook-surface:stop
Stop (canonical) overview
Fires when the agent is about to stop the current turn. Blocking; handlers can request continuation.
Attributes
eventName
Stop (canonical)
displayName
Stop (canonical)
kind
canonical
direction
event
blocking
true
family
in-process
payloadSchema
type
object
required
- session_id
- transcript_path
properties
session_id
type
string
transcript_path
type
string
stop_hook_active
type
boolean
description
True when the parent agent is already inside a Stop hook (avoid recursion).
reason
type
string
description
Fires when the agent is about to stop the current turn. Blocking;
handlers can request continuation.
Outgoing edges
None.
Incoming edges
asserts_about12
- claim:stop-hook-claude-interactive-fires·TestableClaimClaude Code stop hook fires in interactive mode
- claim:stop-hook-claude-interactive-blocks·TestableClaimClaude Code stop hook can block (deny) at end-of-turn
- claim:stop-hook-codex-interactive-fires·TestableClaimCodex stop hook fires in interactive mode
- claim:stop-hook-codex-interactive-blocks·TestableClaimCodex stop hook can block (deny) at end-of-turn
- claim:stop-hook-gemini-interactive-fires·TestableClaimGemini CLI stop hook fires in interactive mode
- claim:stop-hook-gemini-interactive-degrades·TestableClaimGemini CLI stop hook degrades deny (no block support)
- claim:stop-hook-cursor-interactive-fires·TestableClaimCursor stop hook fires in interactive mode
- claim:stop-hook-cursor-interactive-blocks·TestableClaimCursor stop hook can block (deny) at end-of-turn
- claim:stop-hook-copilot-interactive-fires·TestableClaimGitHub Copilot CLI stop hook fires in interactive mode
- claim:stop-hook-copilot-interactive-degrades·TestableClaimCopilot CLI stop hook degrades deny (no block support)
- claim:stop-hook-codex-noninteractive-fires·TestableClaimCodex stop hook fires in non-interactive mode
- claim:stop-hook-claude-noninteractive-fires·TestableClaimClaude Code stop hook fires in non-interactive mode
canonicalized_to2
- hook-surface:codex.on-stop·HookSurfaceOnStop (Codex)
- hook-surface:claude.stop·HookSurfaceStop (Claude)
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_hook7
- hook-mapping:stop-codex·HookMapping
- hook-mapping:stop-cursor·HookMapping
- hook-mapping:stop-pi·HookMapping
- hook-mapping:stop-oh-my-pi·HookMapping
- hook-mapping:stop-codex·HookMapping
- hook-mapping:stop-claude-code·HookMapping
- hook-mapping:plugin-turn-stop-openclaw·HookMapping