Struct AgentSession 

pub struct AgentSession { /* private fields */ }

Durable metadata for one provider-backed agent conversation.

Implementations

impl AgentSession

pub fn id(&self) -> &AgentSessionId

Stable identity owned by Muster rather than the provider.

pub fn name(&self) -> &ProcessName

Generated or user-supplied display name.

pub fn tool(&self) -> &AgentTool

Provider preset controlling launch, activity, and resume behavior.

pub fn project(&self) -> &PathBuf

Exact workspace config location that owns the session.

pub fn launch_command(&self) -> &CommandLine

Original launch command, including user customizations.

pub fn working_dir(&self) -> &Option<PathBuf>

Optional working directory relative to the owning workspace.

pub fn resume_command(&self) -> &Option<CommandLine>

Optional custom resume template. {session_id} is replaced when present.

pub fn native_id(&self) -> &Option<NativeSessionId>

Provider identity captured by a lifecycle integration.

pub fn owner_process_id(&self) -> &Option<AgentProcessId>

Process identity allowed to update the provider conversation.

pub fn owner_process_start_token(&self) -> &Option<AgentProcessStartToken>

Creation marker paired with the owner PID to reject PID reuse.

pub fn wrapper_process_id(&self) -> &Option<AgentProcessId>

Shell wrapper identity allowed to hand off to its direct provider child.

pub fn state(&self) -> &AgentSessionState

Open sessions restore automatically; closed sessions remain in history.

impl AgentSession

pub fn builder() -> AgentSessionBuilder<((), (), (), (), (), (), (), (), (), (), (), ())>

Create a builder for building AgentSession. On the builder, call .id(...), .name(...), .tool(...), .project(...), .launch_command(...), .working_dir(...)(optional), .resume_command(...)(optional), .native_id(...)(optional), .owner_process_id(...)(optional), .owner_process_start_token(...)(optional), .wrapper_process_id(...)(optional), .state(...) to set the values of the fields. Finally, call .build() to create the instance of AgentSession.

impl AgentSession

pub fn with_native_id(self, native_id: NativeSessionId) -> Self

Returns a copy with the provider identity captured by a hook or plugin.

pub fn with_owner_process_id(self, process_id: AgentProcessId) -> Self

Returns a copy bound to the current managed provider process.

pub fn with_launch_processes( self, owner_process_id: AgentProcessId, owner_process_start_token: Option<AgentProcessStartToken>, wrapper_process_id: Option<AgentProcessId>, ) -> Self

Returns a copy bound to a launch owner and its optional shell wrapper.

pub fn with_state(self, state: AgentSessionState) -> Self

Returns a copy with the requested persisted lifecycle state.

pub fn resume(&self) -> Option<CommandLine>

Builds the provider-specific command that resumes this conversation.

pub fn restore_command(&self) -> Option<CommandLine>

Builds the safest command available after a process or Muster restart. Pending launches and open caller-assigned identities retry their original new-session command until a lifecycle hook confirms them.

pub fn resume_template_is_valid(template: &CommandLine) -> bool

Whether a custom resume template can accept a provider identity without embedding it in a quoted or compound shell word. The complete template must also end outside quotes or escape syntax.

pub fn launch_command_accepts_provider_arguments(command: &CommandLine) -> bool

Whether built-in provider arguments can be safely appended to command. Shell compositions require an explicit resume template so arguments are never attached to a different command in a pipeline or sequence.

Trait Implementations

impl Clone for AgentSession

fn clone(&self) -> AgentSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentSession

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentSession

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.