Struct AgentInvocation 

pub struct AgentInvocation {

    pub agent: String,
    pub model: Option<String>,
    pub work_dir: PathBuf,
    pub system_prompt: String,
    pub agent_message: String,
    pub task_id: String,
    pub disallowed_tools: Vec<String>,
    pub git_author_name: String,
    pub git_author_email: String,
    pub output_file: PathBuf,
    pub timeout_seconds: u64,
    pub repo: String,
    pub sandbox: bool,
    pub main_project_dir: PathBuf,
    pub branch: String,
    pub attempt: u32,
}

Agent invocation configuration.

Fields

agent: String

Agent name (claude, codex, opencode, grok, kimi, minimax)

model: Option<String>

Model override (e.g., “claude-sonnet-4-6”, “o3”, “gpt-4.1”)

work_dir: PathBuf

Working directory

system_prompt: String

System prompt content

agent_message: String

Agent message (task prompt)

task_id: String

Task ID

disallowed_tools: Vec<String>

Disallowed tools pattern

git_author_name: String

Git author name

git_author_email: String

Git author email

output_file: PathBuf

Output file path for agent response

timeout_seconds: u64

Timeout in seconds (0 = no timeout)

repo: String

Repository slug (owner/repo) for per-repo state isolation

sandbox: bool

Whether the agent runs in the OS sandbox, from workflow.sandbox

main_project_dir: PathBuf

The project’s main checkout, which the sandbox keeps read-only but for its .git

branch: String

The task’s branch, from orch’s records, the one ref the sandbox lets the agent move

attempt: u32

Current attempt number (1-indexed)