Struct ObserveRequest 

pub struct ObserveRequest {
    pub agent_id: Option<String>,
    pub session_id: String,
    pub cwd: Option<PathBuf>,
    pub transcript_path: Option<PathBuf>,
    pub event: SessionEvent,
    pub repo: Option<String>,
    pub model: Option<String>,
    pub agent: Agent,
    pub pid: Option<u32>,
}

An idempotent session sighting sent to the registry — the wire payload of the observe op, and the argument to SessionsRegistry::observe.

The hook sink and the transcript watcher both produce these; every field but session_id and event is best-effort and fills in missing data on an existing entry without ever clobbering known data with None.

Fields

agent_id: Option<String>

Claude subagent identity; absent for parent hooks and other feeds.

session_id: String

The Claude session_id (a UUID) — the primary key. Equal to the transcript filename stem and (per ADR-0052) the VS Code extension’s tab key, so the three feeds join without heuristics.

cwd: Option<PathBuf>

The session’s working directory, when known (from the hook cwd).

transcript_path: Option<PathBuf>

The ~/.claude/projects/**/<session-id>.jsonl transcript path, when known.

event: SessionEvent

The event that produced this sighting; drives the state inference.

repo: Option<String>

The repository name enriched from cwd by the adapter (git2), when resolvable. Stored verbatim; the engine does no disk I/O.

model: Option<String>

The model id, when a hook reports one.

agent: Agent

Which agent the session belongs to; omitted for Claude Code.

pid: Option<u32>

The agent process’s pid, when known: the hook sink’s parent, or claude-wrap’s wrapped child. Tells a resumed session’s new process from the old one it replaced, which share a session_id (#1948). Every other feed (the watchers, the Codex app-server, pi.dev) sends None.

This is also the seed for pid-based liveness (#1916): the [pid_watcher] independently probes every pid it sees here, off this wire and off the registry lock, rather than trusting a client-supplied process identity — see SessionEntry::pid_start.

Trait Implementations

impl Clone for ObserveRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ObserveRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObserveRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ObserveRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.