Contents

Event Catalog

Generated by rake events:catalog. The dispatch mode is part of each event’s public contract; the bus enforces it at runtime.

Event Mode Durable Description
agent/disposed emit   an agent was disposed (session_id); reap its session-keyed runtime state
agent/pre_step waterfall   rewrite or reject the claimed messages
agent/request waterfall   rewrite the outbound model request
agent/turn_stopping serial   ordered veto point before turn/end
approval/requested emit yes tool call parked awaiting a decision
approval/resolved emit yes parked call decided (approve/deny)
assistant/chunk emit yes raw stream delta (replay/UI fidelity)
assistant/message emit yes completed assistant message
config/updated emit   a row’s config was hot-swapped (id, config)
context/injected emit yes agent.inject landed in a request
fs/authorize waterfall   veto or admit an fs operation
llm/stream waterfall   wrap/replace the adapter stream
policy/updated emit yes agent allow-list replaced (metadata; projection-invisible)
session/compacted emit yes history up to upto_seq replaced by summary (still model-visible)
session/created emit yes session opened
session/event emit   fan-out of every durable append
session/forked emit yes lineage record
session/titled emit yes session titled (metadata; projection-invisible)
step/end emit yes model step closed
step/start emit yes model step opened
tool/call emit yes tool invocation requested by model
tool/result emit yes tool outcome
tools/execute waterfall   a provider may replace execution
tools/post_execute waterfall   truncate/redact the result
tools/pre_execute waterfall   validate, veto, or rewrite a call
turn/end emit yes turn closed with status
turn/start emit yes turn opened
user/message emit yes entered user input