Struct AgentContext 

pub struct AgentContext {
    pub task_id: String,
    pub item_id: String,
    pub cycle: u32,
    pub phase: String,
    pub workspace_root: PathBuf,
    pub workspace_id: String,
    pub execution_history: Vec<PhaseRecord>,
    pub upstream_outputs: Vec<AgentOutput>,
    pub artifacts: ArtifactRegistry,
    pub shared_state: SharedState,
}

Full agent context available during phase execution.

Fields

task_id: String

Parent task identifier.

item_id: String

Current task-item identifier.

cycle: u32

Execution cycle number.

phase: String

Current phase name.

workspace_root: PathBuf

Absolute workspace root used for command execution.

workspace_id: String

Workspace identifier from configuration.

execution_history: Vec<PhaseRecord>

Historical phase executions accumulated so far.

upstream_outputs: Vec<AgentOutput>

Outputs produced by upstream phases.

artifacts: ArtifactRegistry

Artifact registry accumulated across phases.

shared_state: SharedState

Shared key-value state available to templates and follow-up steps.

Implementations

impl AgentContext

pub fn new( task_id: String, item_id: String, cycle: u32, phase: String, workspace_root: PathBuf, workspace_id: String, ) -> AgentContext

Creates a fresh execution context for an agent phase.

pub fn add_upstream_output(&mut self, output: AgentOutput)

Adds an upstream output and merges its artifacts into the registry.

pub fn render_template(&self, template: &str) -> String

Renders a template using context variables only.

Note: Pipeline variable values are escaped for safe use inside bash double-quoted strings. This prevents content like markdown backticks from triggering shell command substitution.

pub fn render_template_with_pipeline( &self, template: &str, pipeline: Option<&PipelineVariables>, ) -> String

Renders a template using context variables and optional pipeline values.

pub fn to_ref(&self) -> AgentContextRef

Converts the full context into a lightweight serializable reference.

Trait Implementations

impl Clone for AgentContext

fn clone(&self) -> AgentContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentContext

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

Formats the value using the given formatter.