Struct NativeLaunchProfileControl 

pub struct NativeLaunchProfileControl { /* private fields */ }

Clonable host-local control for selecting profiles without mutable runtime access.

The handle intentionally does not implement Debug: its shared registry retains opaque environment resolvers that may own secret material.

Implementations

impl NativeLaunchProfileControl

pub fn select_native_launch_profile( &self, instance_id: AgentInstanceId, profile_id: NativeLaunchProfileId, ) -> Result<(), NativeLaunchProfileError>

Selects a profile for future spawns of one exact instance.

Spawn dispatch snapshots the selection under the same registry lock, so a selection change does not alter a child that was already dispatched.

pub fn clear_native_launch_profile_selection( &self, instance_id: AgentInstanceId, ) -> bool

Clears one instance selection for future spawns only.

pub fn install_native_launch_environment_overlay( &self, instance_id: AgentInstanceId, overlay: NativeLaunchEnvironmentOverlay, ) -> Result<(), NativeLaunchProfileError>

Installs or replaces one host-only environment overlay for an exact selection.

pub fn install_native_instance_launch_overlay( &self, instance_id: AgentInstanceId, overlay: NativeInstanceLaunchOverlay, ) -> Result<(), NativeLaunchProfileError>

Installs or replaces one host-only PTY launch overlay for an exact instance.

An argv-only overlay does not require an environment profile selection. Environment mutations retain the existing exact-selection requirement.

pub fn clear_native_instance_launch_overlay( &self, instance_id: AgentInstanceId, ) -> bool

Clears one host-only instance launch overlay for future spawns only.

pub fn install_native_mcp_server_launch_overlay( &self, instance_id: AgentInstanceId, overlay: NativeMcpServerLaunchOverlay, ) -> Result<(), NativeLaunchProfileError>

Installs the dedicated MCP-server launch overlay for one exact future PTY or ACP spawn.

pub fn clear_native_mcp_server_launch_overlay( &self, instance_id: AgentInstanceId, ) -> bool

Clears one dedicated MCP-server launch overlay before or after the child lifetime.

Trait Implementations

impl Clone for NativeLaunchProfileControl

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.