II.
HookSurface overview
Reference · livehook-surface:session-start
SessionStart (canonical) overview
Fires when a new session is created. The session-start hook may write a bare run ID into session state when bridging is active, enabling the orchestrating skill to discover and assign a process to the run.
Attributes
eventName
SessionStart (canonical)
displayName
SessionStart (canonical)
kind
canonical
direction
event
blocking
false
family
in-process
payloadSchema
type
object
required
- session_id
- transcript_path
- source
properties
session_id
type
string
transcript_path
type
string
cwd
type
string
model
type
string
description
Model id at session start (e.g. claude-sonnet-4-5).
source
type
string
enum
- startup
- resume
- clear
description
How the session was initiated.
startedAt
type
string
format
date-time
bare_run_id
type
string
description
When the session-start hook detects or creates a bare run, this field carries the run ID so downstream hooks and the babysit-skill can bind to it.
description
Fires when a new session is created. The session-start hook may
write a bare run ID into session state when bridging is active,
enabling the orchestrating skill to discover and assign a process
to the run.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
fires_hook1
- agent-core-impl:a5c.core@current·AgentCoreImpla5c Unified Core (current) — unified agent loop
maps_hook12
- hook-mapping:session-start-antigravity·HookMapping
- hook-mapping:session-start-claude-code·HookMapping
- hook-mapping:session-start-codex·HookMapping
- hook-mapping:session-start-cursor·HookMapping
- hook-mapping:session-start-github-copilot·HookMapping
- hook-mapping:session-start-opencode·HookMapping
- hook-mapping:session-start-pi·HookMapping
- hook-mapping:session-start-oh-my-pi·HookMapping
- hook-mapping:plugin-session-start-openclaw·HookMapping
- hook-mapping:gateway-request-received-openclaw·HookMapping
- hook-mapping:session-start-gemini·HookMapping
- hook-mapping:session-start-pi·HookMapping