pub enum SessionLogMode {
Disabled,
Auto,
External(SessionLogCoordinator),
}Expand description
Controls whether the builder manages a SessionLogCoordinator for the
session it launches.
Default for AgentBuilder is SessionLogMode::Disabled so that
existing Rust library callers see no side effects. The CLI and any
caller that wants live event streaming should select
SessionLogMode::Auto.
SessionLogMode::External lets an advanced caller (e.g. the CLI’s
plan/review handlers, zag-serve) start and bookkeep its own
coordinator — the builder will write through it without double-starting.
Variants§
Disabled
No session log is started by the builder. No on-disk JSONL and no live event callbacks.
Auto
The builder starts its own SessionLogCoordinator, tears it down
when the terminal method returns, and populates
AgentOutput::log_path.
External(SessionLogCoordinator)
The caller provides a pre-started SessionLogCoordinator; the
builder uses it verbatim and does not stop it at exit.