Module program_status 

Bounded Program Status Protocol (OSC 7501) encoding. No terminal I/O.

Enums

InteractionKind

The actual user intervention required by an interaction.

ProgramState

Terminal record states, independent of execution authority.

ProgramStatusUpdate

Projection commands carry no input or execution authority.

Constants

MIN_VTE_VERSION_WITH_SAFE_OSC

Minimum VTE_VERSION whose parser safely ignores unknown OSC sequences.

Functions

clear_iterm21337

Encode the empty iTerm2 session-status report that clears a previous one.

encode_iterm21337

Encode an iTerm2 session-status report for a direct iTerm2 session.

encode_report

Encode a complete replacement record. An explicit owned ID is mandatory; callers cannot accidentally clear the terminal’s root or unrelated records.

iterm21337_status

iTerm2 session-status (OSC 21337) label and indicator for a terminal state.

record_segment

Generate an opaque ASCII segment without copying source identity onto the wire.

should_emit_iterm21337

Pure gate: 21337 is iTerm2-proprietary, so only direct iTerm2 sessions (no multiplexer or GNU screen between the program and the emulator).

should_emit_iterm21337_now

Live gate combining should_emit_iterm21337 with ITERM_SESSION_ID / TMUX / STY detection.

vte_allows_unknown_osc

Live gate combining vte_version_allows_unknown_osc with the process environment.

vte_version_allows_unknown_osc

Pure gate: whether a VTE_VERSION value permits unknown-OSC emission.