Enum SessionRole 

pub enum SessionRole {
    Worker,
    OrchestrationWorker,
    OrchestrationResearcher,
    Orchestrator,
}

Role one session plays in a multi-session workflow.

The role is orthogonal to SessionStatus: an orchestrator moves through the same lifecycle states as any other session, but its worktree exists only for repository reads and never receives commits. Diff, merge, and review-request affordances are therefore gated on the role rather than on a dedicated lifecycle state.

Variants

Worker

Ordinary session that owns the changes on its own branch.

OrchestrationWorker

Worker whose write capabilities are owned exclusively by an orchestration coordinator.

OrchestrationResearcher

Temporary read-only researcher whose worktree changes are discarded after its report is captured.

Orchestrator

Controller session that plans and supervises child worker sessions.

Implementations

impl SessionRole

pub fn owns_branch_changes(self) -> bool

Returns whether this role produces commits on its own session branch.

Orchestrators read the repository to plan work but delegate every edit to child sessions, so their branch stays empty for the session’s whole lifetime.

pub fn tracks_worktree_changes(self) -> bool

Returns whether Agentty should observe worktree changes after a turn.

Research children do not own their changes, but the coordinator records whether a child attempted edits before discarding its worktree.

pub fn accepts_user_turns(self) -> bool

Returns whether an end user may submit turns or branch mutations directly to this session.

pub fn is_managed(self) -> bool

Returns whether this worker is owned by an orchestration coordinator.

Trait Implementations

impl Clone for SessionRole

fn clone(&self) -> SessionRole

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionRole

impl Debug for SessionRole

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

Formats the value using the given formatter.

impl Default for SessionRole

fn default() -> SessionRole

Returns the “default value” for a type.

impl Display for SessionRole

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

Formats the value using the given formatter.

impl Eq for SessionRole

impl FromStr for SessionRole

type Err = String

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for SessionRole

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SessionRole