Enum EnvPolicy 

#[non_exhaustive]
pub enum EnvPolicy {
    Minimal,
    Inherit,
    Only(Vec<String>),
}

Which of the host’s environment variables reach the agent.

The default is EnvPolicy::Minimal. Inheriting the whole environment is what a CLI gets from a shell, but this crate is embedded in processes that hold unrelated secrets, and full inheritance hands every one of them to the agent and to every command the agent runs. That is a decision worth making deliberately, so it is the opt-in rather than the default.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Minimal

Pass through only what the selected agent needs, per Agent::essential_env, plus anything set with crate::Request::env.

The crate owns this list rather than the caller, because “what does this CLI need to work” is knowledge about the agent, and an incomplete hand-written list produces a run that fails in a way that looks like an auth problem. Every agent is verified to authenticate under it by the live test suite.

Inherit

Pass the whole parent environment through, as a shell would.

Correct when the host process holds nothing the agent should not see, or when something environment-specific (a proxy, a custom CA, a vendor variable this crate does not know about) has to reach the CLI and enumerating it is impractical.

Only(Vec<String>)

Pass through only these names, plus anything set with crate::Request::env. Names unset in the parent are skipped.

Trait Implementations

impl Clone for EnvPolicy

fn clone(&self) -> EnvPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EnvPolicy

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

Formats the value using the given formatter.

impl Default for EnvPolicy

fn default() -> EnvPolicy

Returns the “default value” for a type.

impl Eq for EnvPolicy

impl PartialEq for EnvPolicy

fn eq(&self, other: &EnvPolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for EnvPolicy