II.
Adapter overview
Reference · liveadapter:hooks-adapter
hooks-adapter overview
Bridges per-product native hook names to the canonical hook taxonomy + applies per-axis merge policies (persistEnv key-wise, decision most-restrictive-wins, systemMessage concat, toolMutation single-writer). Emits MergeDiagnostics: handlerCount, handlerOrder, conflicts, degradedFields, handlerTimings, unsupportedOutputFields, nativeRenderingLosses, mergedAt.
Attributes
displayName
hooks-adapter
protocolType
hook
nativeSide
- claude — PreToolUse, PostToolUse, UserPromptSubmit, Notification, Stop, SubagentStop, SessionStart, SessionEnd, PreCompact, ShellEnv
- codex — OnToolCall, OnStop
- gemini — pre_prompt, post_response
- copilot — preTool, postTool
- cursor — inherits Claude Code hook schema
- opencode — on_step, SessionIdle, ShellEnv
- pi, omp, openclaw, hermes — onEvent (generic)
canonicalSide
Canonical 14-hook surface set (PreToolUse, PostToolUse, UserPromptSubmit, etc.)
position
Between Agent-Runtime hook events and subscribed plugins / extension-interface impls
bridgingConcerns
- name mapping (per-agent → canonical)
- payload schema normalization (UnifiedHookEvent: version, adapter, phase, rawEventName, supportLevel, execution, payload, env, raw)
- support level (supported / degraded / unsupported) per (agent, hook)
- hook family (shell-hook / in-process / observer) — determines delivery mechanism
- merge policy across multiple subscribers (DECISION_PRECEDENCE deny < ask < allow < continue < noop)
catalogInputNodeKinds
- HookSurface
- HookMapping
- AgentVersion
trustChainParticipation
planned
description
Bridges per-product native hook names to the canonical hook taxonomy
+ applies per-axis merge policies (persistEnv key-wise, decision
most-restrictive-wins, systemMessage concat, toolMutation single-writer).
Emits MergeDiagnostics: handlerCount, handlerOrder, conflicts,
degradedFields, handlerTimings, unsupportedOutputFields,
nativeRenderingLosses, mergedAt.
Outgoing edges
bridges_for30
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-51
- agentVersion:pi:ge-0-75-4
- agentVersion:omp:ge-15-5-6
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-55-3·AgentVersionGitHub Copilot CLI
- agentVersion:pi:ge-0-75-4
- agentVersion:omp:ge-15-2-4
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
- agentVersion:codex:ge-0-119-0·AgentVersionCodex CLI
- agentVersion:cursor:ge-0-0-0·AgentVersionCursor
- agentVersion:gemini:ge-0-43-0·AgentVersionGemini CLI
- agentVersion:opencode:ge-0-0-0·AgentVersionOpenCode
- agentVersion:copilot:ge-1-0-51
- agentVersion:pi:ge-0-75-5·AgentVersionPi CLI (>=0.77.0)
- agentVersion:omp:ge-15-2-4
- agentVersion:openclaw:ge-2026-5-27·AgentVersionOpenClaw
- agent-version:hermes@current·AgentVersionHermes
bridges_protocol_type3
- layer:5-agent-runtime·LayerAgent-Runtime
- layer:5-agent-runtime·LayerAgent-Runtime
- layer:5-agent-runtime·LayerAgent-Runtime
Incoming edges
None.