Module program_status 

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

Enums

ConEmuProgress

ConEmu OSC 9;4 tab-progress state, also rendered natively by Windows Terminal and Ghostty 1.2+. Numeric mapping follows ConEmu and the Windows Terminal docs.

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_GHOSTTY_VERSION_WITH_CONEMU94

Minimum Ghostty (major, minor) rendering OSC 9;4 as tab progress.

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_conemu94

Encode a ConEmu OSC 9;4 tab-progress report (BEL-terminated, the canonical form from the Windows Terminal docs).

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.

ghostty_version_allows_conemu94

Pure gate: whether a TERM_PROGRAM_VERSION value permits OSC 9;4. Compares only the leading major.minor pair; anything else fails closed.

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_conemu94

Pure gate: OSC 9;4 renders only on terminals documented to honor it.

should_emit_conemu94_now

Live gate combining should_emit_conemu94 with process-environment detection: WT_SESSION/WT_PROFILE_ID (Windows Terminal), ConEmuPID (ConEmu), or exactly TERM_PROGRAM=ghostty with ghostty_version_allows_conemu94.

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.