Module inspect 

Best-effort foreground-job inspection, not proof of native TUI keyboard ownership. All failures are conservative; callers should pass the key through on errors.

Supported ancestry is a bounded chain of recognized shells on the pane’s TTY, not an arbitrary descendant tree. Missing/exited group leaders, intervening editors/SSH, nested PTYs, and stopped ancestors are rejected. Same-group helpers must descend from a verified frontend and have nonterminal stdin and no extra TTY FDs. Frontend launches with unsupported flags/layouts or overwritten titles/argv that no longer preserve a recognizable command are unsupported; original argv cannot be reconstructed. Revalidation is best effort, not an atomic keyboard-ownership check.

Structs

Decision

Invocation

Identity of a validated frontend launch, independent of helpers and job control. Kernel start times are platform-specific; tokens are local to this host/boot.

Enums

Liveness

Functions

eligible

Inspect the pane’s actual foreground job, without hooks or process environments. Unsupported/ambiguous jobs return a negative decision. OS/race/resource failures return an error, which the caller must treat as ineligible as well.