Struct Invocation 

pub struct Invocation<'a> {
    pub cwd: &'a Path,
    pub prompt: &'a str,
    pub timeout: Duration,
    pub allow_write: bool,
    pub sessions: bool,
    pub artifacts: &'a Path,
    pub stem: &'a str,
    pub run: &'a str,
    pub node: &'a str,
    pub cache_dir: Option<&'a Path>,
    pub attachments: &'a [PathBuf],
}

One agent invocation.

Fields

cwd: &'a Path

Working directory. Always a real checkout, so every CLI can read the repository without per-vendor “extra directory” flags.

prompt: &'a str

The full prompt.

timeout: Duration

Wall-clock limit; the process tree is killed when it elapses.

allow_write: bool

May the agent modify files? Judges and reviewers may not.

sessions: bool

Continue this seat’s conversation when the CLI supports it.

artifacts: &'a Path

Directory for prompt / stdout / stderr artifacts.

stem: &'a str

Artifact filename stem.

run: &'a str

Run this invocation belongs to. Exported as MAGI_RUN so an agent that files a task with magi task add is attributed to the run that was paying for it, rather than looking like a human wandered by.

node: &'a str

Graph node being executed, e.g. implement or review. Exported as MAGI_NODE for the same reason: “who asked for this” is the first question about an autonomously created task.

cache_dir: Option<&'a Path>

Shared build cache the seat should build into, from the rendered CARGO_TARGET_DIR= in the verify commands. Exported as CARGO_TARGET_DIR so the implementer’s compile lands inside the same directory verify reads back from - one cache, one prune, and the build the agent just paid for is the build the gate reuses.

attachments: &'a [PathBuf]

Absolute paths of images the operator attached to this conversation, outside cwd - see chat/talk’s attachments_dir. Empty for every invocation that is not a chat or talk turn. [build_command] uses this only to decide whether a CLI’s sandbox needs widening to read them; the prompt text naming each path and its mime is built by the caller, not here.

Trait Implementations

impl<'a> Debug for Invocation<'a>

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

Formats the value using the given formatter.