II.
HookSurface overview
Reference · livehook-surface:codex.on-stop
OnStop (Codex) overview
Codex's session-stop hook. Fired when the assistant finishes its last turn before yielding control. Canonicalizes to stop.
Attributes
eventName
OnStop (Codex)
displayName
OnStop (Codex)
kind
native
originVendor
OpenAI
direction
post
blocking
false
family
shell-hook
payloadSchema
type
object
required
- sessionId
properties
sessionId
type
string
reason
type
string
description
Codex's session-stop hook. Fired when the assistant finishes its
last turn before yielding control. Canonicalizes to stop.
Outgoing edges
canonicalized_to1
- hook-surface:stop·HookSurfaceStop (canonical)
Incoming edges
exposes2
- agent-runtime-impl:codex-app-server.runtime@current·AgentRuntimeImplCodex App-Server Runtime (current)
- agent-runtime-impl:codex.runtime@1.x·AgentRuntimeImplCodex CLI Runtime (1.x)
fires_hook1
- agent-core-impl:codex.core@1.x·AgentCoreImplCodex CLI Core (1.x)
maps_hook1
- hook-mapping:codex-on-stop-native·HookMapping
tests_hook_surface2
- 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