Struct BeholderRegistry 

pub struct BeholderRegistry { /* private fields */ }

Registry of available beholders, consulted at task.run time.

Entries are tried in insertion (priority) order. Earlier registrations have higher priority when multiple beholders’ matches predicates would fire.

Implementations

impl BeholderRegistry

pub fn new() -> Self

pub fn register(&mut self, factory: Box<dyn BeholderFactory>)

Register a beholder factory. Earlier entries have higher priority.

pub fn attach( &self, raw_cmd: &str, select: &BeholderSelect, verbatim_output: bool, ) -> AttachResult

Determine and attach a beholder for the given invocation.

• Tokenizes raw_cmd and strips wrapper binaries (bunx, npx, pnpm, npm exec).

• verbatim_output signals that somebody reads this run’s output as text — a human watching a terminal tile, or an attach client that promised its caller byte-identical passthrough. Rewriter beholders decline in Auto mode rather than change what that reader sees; Force still attaches but records forced-against-verbatim.

  This flag used to be tty_attached, and the rename is the R739-B10 fix rather than tidying. A PTY was never the thing that mattered: what matters is whether anything downstream renders the bytes. yah build run moved off a PTY onto pipes (R739-F6) and instantly started leaking --message-format=json-render-diagnostics output into an agent’s stdout, because the only flag that could have stopped it was named after the mechanism instead of the requirement.

• Behaviour depends on select:

  • Auto — walk in priority order, first matches hit wins.
  • Force(name) — find by name; bypass matches (records forced-against-flags if the beholder would have declined, or forced-against-verbatim if the output is read verbatim and mode is Rewriter).
  • None — bytes-only; no beholder attached.

• If a Rewriter beholder attaches, its adjust_argv is applied to the returned AttachResult.argv and the diff is surfaced on status.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

Trait Implementations

impl Default for BeholderRegistry

fn default() -> Self

Returns the “default value” for a type.