II.
HookSurface overview
Reference · livehook-surface:notification
Notification (canonical) overview
Fires when an agent emits a user-visible notification (Claude Code "Notification" hook and equivalents). Payload mirrors the Claude Code docs.
Attributes
eventName
Notification (canonical)
displayName
Notification (canonical)
kind
canonical
direction
event
blocking
false
family
in-process
payloadSchema
type
object
required
- session_id
- transcript_path
- message
properties
session_id
type
string
transcript_path
type
string
cwd
type
string
message
type
string
description
Human-readable notification body shown to the user.
description
Fires when an agent emits a user-visible notification (Claude
Code "Notification" hook and equivalents). Payload mirrors the
Claude Code docs.
Outgoing edges
None.
Incoming edges
canonicalized_to1
- hook-surface:claude.notification·HookSurfaceNotification (Claude)
emits_hook1
- background-monitor:example-file-watcher·BackgroundMonitorProject file watcher (example)
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:notification-claude-code·HookMapping