Struct AgentWorktree 

pub struct AgentWorktree { /* private fields */ }

A subagent’s private checkout.

Implementations

impl AgentWorktree

pub fn create(workdir: &Path, agent_id: &str) -> Result<AgentWorktree, Error>

Create an isolated checkout for agent_id, seeded with workdir’s current uncommitted state.

workdir is the session’s directory; it may be the repo top level or any directory under it. The child is rooted at the matching relative path inside the worktree, so a session running in crates/foo gives its children a crates/foo too and relative paths in the prompt still mean what they say.

pub fn root(&self) -> &Path

Where the child should run.

pub fn project_root(&self) -> &Path

Top level of the project this work merges back into. Callers serializing merges key their lock on this.

pub fn base(&self) -> &str

The commit the child’s work is currently measured against.

pub fn pending_files(&self) -> Result<Vec<PathBuf>, Error>

Absolute project paths the child’s pending work would touch.

Callers checkpoint these before Self::merge_into_project, so a merged patch is as recoverable through /restore as any other tool’s mutation. Reading them separately (rather than out of the merge result) is what lets the snapshot happen before the files change.

Sorted and deduplicated, so a caller can feed them straight to a multi-path lock acquisition without risking a deadlock against another caller holding the same paths in a different order.

pub fn merge_into_project(&mut self) -> Result<MergeOutcome, Error>

Apply the child’s work to the project.

Callers must serialize this across concurrent children — two patches applying at once reintroduce exactly the interleaving the worktree exists to prevent.

pub fn destroy(self)

Remove the checkout. Best-effort: a worktree we cannot delete is disk we can reclaim later (see gc_orphaned_worktrees), never a reason to fail the agent whose work already merged.

Trait Implementations

impl Debug for AgentWorktree

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

Formats the value using the given formatter.