II.
HookSurface overview
Reference · livehook-surface:session-idle
SessionIdle (canonical) overview
Fires when a session has been quiet for a configured threshold. Used by orchestrators to dispatch keepalives, by reliability impls to detect stalled loops, and by IDE integrations to dim idle agent avatars. Native equivalents: opencode `SessionIdle`, claude-code `Notification` with `idle` qualifier.
Attributes
eventName
SessionIdle (canonical)
displayName
SessionIdle (canonical)
kind
canonical
direction
observer
blocking
false
family
observer
payloadSchema
type
object
required
- session_id
- idle_since_ms
properties
session_id
type
string
idle_since_ms
type
integer
description
Milliseconds since the last user input or tool result.
last_event_kind
type
string
description
Kind of the last event before idle (e.g. text-deltas-complete, tool-result, user-prompt).
description
Fires when a session has been quiet for a configured threshold. Used
by orchestrators to dispatch keepalives, by reliability impls to
detect stalled loops, and by IDE integrations to dim idle agent
avatars. Native equivalents: opencode `SessionIdle`, claude-code
`Notification` with `idle` qualifier.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:session-idle-gemini·HookMapping