Struct AttentionEntry 

pub struct AttentionEntry {
    pub agent: String,
    pub ts: u64,
    pub event: Event,
    pub project: String,
    pub cwd: String,
    pub pid: Option<u32>,
    pub tmux_session: Option<String>,
    pub tmux_pane: Option<String>,
    pub message: Option<String>,
}

One entry stored per active agent session that is waiting on user attention.

Serialized as compact JSON to one file per session (keyed by session_id) under ${XDG_RUNTIME_DIR:-/tmp}/agent-status/. The bash precursor’s five original field names (project, cwd, event, tmux_pane, ts) are preserved so readers expecting that vocabulary still find what they need. tmux_pane is now an Option<String> rather than the bash version’s required string with an "" sentinel: empty strings deserialize to None, and None is omitted when serializing. The struct has grown additional optional fields over time (message, pid, tmux_session); each carries #[serde(default)] so older state files lacking the field still load.

Fields

agent: String

Stable identifier of the agent that wrote this entry (e.g. "claude-code").

ts: u64

Unix timestamp (seconds) when the entry was written.

event: Event

Hook event the producing agent reported.

project: String

Basename of the project directory (typically the cwd’s last component).

cwd: String

Absolute path of the project directory at the time the hook fired.

pid: Option<u32>

PID of the agent process at the time the hook fired (typically getppid() from inside the hook script — the claude/opencode/pi binary). Used to clean up state files whose owning process has exited without firing its session-end hook. Absent in entries written by older binaries; entries without a pid are never auto-pruned.

tmux_session: Option<String>

Name of the tmux session the hook fired from (the #S of the owning pane), or None when the hook fired outside tmux or the lookup failed. Preferred over project as the human-facing handle in the switcher because it carries the full multi-worktree context. #[serde(default)] lets entries written by older binaries (which lack this field) deserialize as None.

tmux_pane: Option<String>

Tmux pane id (such as %17), or None if the hook fired outside tmux. #[serde(default)] lets entries written by older binaries (which always emitted the field, possibly as "") still deserialize. The empty_string_as_none deserializer normalizes the bash precursor’s "" sentinel to None so callers only need to check one shape.

message: Option<String>

Optional last-message text from the agent (e.g. Claude Code Notification’s message field). Absent in the JSON when None; absent on entries written by older binaries.

Trait Implementations

impl Clone for AttentionEntry

fn clone(&self) -> AttentionEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttentionEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AttentionEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AttentionEntry

fn eq(&self, other: &AttentionEntry) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AttentionEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AttentionEntry

impl StructuralPartialEq for AttentionEntry