Struct SpawnOpts 

pub struct SpawnOpts {

    pub cwd: PathBuf,
    pub env: Vec<(String, String)>,
    pub label: Option<String>,
    pub initiator: Initiator,
    pub pty_cols: u16,
    pub pty_rows: u16,
    pub stdin_enabled: bool,
    pub pin: bool,
    pub beholder_select: BeholderSelect,
    pub tty_attached: bool,
    pub log_fd_enabled: bool,
    pub origin: Option<String>,
    pub argv: Option<Vec<String>>,
}

Options for TaskDriver::spawn_run.

Fields

cwd: PathBuf

env: Vec<(String, String)>

Env vars set on the child process (merged on top of the current env).

label: Option<String>

initiator: Initiator

pty_cols: u16

PTY column count. Defaults to 80.

pty_rows: u16

PTY row count. Defaults to 24.

stdin_enabled: bool

Enable stdin relay via TaskDriver::send_stdin.

pin: bool

Pin the run so the GC sweep does not drop its output during warm rolloff.

beholder_select: BeholderSelect

Beholder attachment policy. Defaults to BeholderSelect::Auto.

tty_attached: bool

true when a human-facing terminal tile is attached. Causes Rewriter beholders to decline in Auto mode so the human sees unmodified output.

log_fd_enabled: bool

Create a side-channel FIFO and export YAH_TASK_RUN / YAH_LOG_PIPE so Tier-2 shim libraries (yah-log-rust, @yah/log) can emit structured events. Has no effect on non-Unix platforms. Defaults to true.

origin: Option<String>

Provenance tag stored on the run’s TaskRunMeta.origin (e.g. Some("terminal") for an interactive shell). None is an ordinary job.

argv: Option<Vec<String>>

Exec this argv directly instead of wrapping cmd in sh -c.

The default sh -c <cmd> is right for a job — the caller wrote a command line and expects a shell to parse it. It is wrong for an interactive shell: sh -c "zsh -l" leaves an inert sh as the PTY’s foreground process group leader, so job control misbehaves, signals go to the wrong process, and anything that reads the foreground pid (a live-cwd probe, say) sees sh instead of the shell the operator is typing into. Handing the exact argv here makes the shell itself the child, which is also the only way to pass -l as a real argv element so .zprofile / .profile actually run.

cmd is still what gets recorded on TaskRunMeta.command, so the run reads the way the caller asked for it. Beholder argv rewriting is bypassed when this is set: the caller has already decided the exact process to exec, and a recorded rewrite=… that didn’t happen would be a lie in the run metadata.

Trait Implementations

impl Clone for SpawnOpts

fn clone(&self) -> SpawnOpts

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpawnOpts

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

Formats the value using the given formatter.

impl Default for SpawnOpts

fn default() -> Self

Returns the “default value” for a type.