II.
HookSurface overview
Reference · livehook-surface:user-prompt-submit
UserPromptSubmit (canonical) overview
Fires when a user submits a prompt; can rewrite or block.
Attributes
eventName
UserPromptSubmit (canonical)
displayName
UserPromptSubmit (canonical)
kind
canonical
direction
pre
blocking
true
family
in-process
payloadSchema
type
object
required
- session_id
- transcript_path
- prompt
properties
session_id
type
string
transcript_path
type
string
cwd
type
string
prompt
type
string
description
The user's submitted prompt text. Handlers may rewrite or block.
description
Fires when a user submits a prompt; can rewrite or block.
Outgoing edges
None.
Incoming edges
canonicalized_to2
- hook-surface:claude.user-prompt-expansion·HookSurfaceUserPromptExpansion (Claude Code)
- hook-surface:claude.user-prompt-submit·HookSurfaceUserPromptSubmit (Claude)
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
fires_hook2
- 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_hook10
- hook-mapping:user-prompt-submit-codex·HookMapping
- hook-mapping:user-prompt-submit-github-copilot·HookMapping
- hook-mapping:user-prompt-submit-pi·HookMapping
- hook-mapping:user-prompt-submit-oh-my-pi·HookMapping
- hook-mapping:user-prompt-submit-claude-code·HookMapping
- hook-mapping:user-prompt-submit-cursor·HookMapping
- hook-mapping:user-prompt-submit-gemini·HookMapping
- hook-mapping:prompt-oh-my-pi·HookMapping
- hook-mapping:plugin-prompt-submitted-openclaw·HookMapping
- hook-mapping:gateway-request-routed-openclaw·HookMapping