hatchery-session-events 0.2.20

Session event layer: per-provider live PTY parsers (pluggable trait) that turn the terminal byte stream into typed events, plus an ACP adapter behind the same event type
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

//! Session event layer.
//!
//! Turns what a provider CLI draws in its terminal (or what an ACP agent reports) into typed
//! [`SessionEvent`]s. Web HQ (and later the TUI) read only this layer: chat answers, thought and
//! action widgets, diffs, prompt-needed alerts and avatar states are all derived from events.
//!
//! Design (see docs/hatchery/research/session-ui-competitors-2026-10.md):
//! * live PTY parsing is the quality base: [`ProviderParser`] modules, one per provider, plus a generic fallback;
//! * every event carries its `source` and a [`Confidence`]: screen parsing is always `Heuristic`;
//! * ACP is an additional source behind the same event type ([`acp::AcpAdapter`]), `Structured`.

pub mod acp;
mod engine;
mod event;
pub mod providers;

pub use engine::EventStream;
pub use event::{ActionStatus, Confidence, EventKind, PromptKind, SessionEvent, SessionState};
pub use providers::{parser_for, Item, Parsed, ProviderParser};