Struct PhaseContext 

pub struct PhaseContext {

    pub phase: Phase,
    pub snapshot: Snapshot,
    pub agent_spec: Arc<AgentSpec>,
    pub run_identity: RunIdentity,
    pub messages: Arc<[Arc<Message>]>,
    pub tool_name: Option<String>,
    pub tool_call_id: Option<String>,
    pub tool_args: Option<Value>,
    pub tool_result: Option<ToolResult>,
    pub run_mode: RunMode,
    pub adapter: AdapterKind,
    pub tool_kind: ToolKind,
    pub llm_response: Option<LLMResponse>,
    pub resume_input: Option<ToolCallResume>,
    pub suspension_id: Option<String>,
    pub suspension_reason: Option<String>,
    pub cancellation_token: Option<CancellationToken>,
    pub profile_access: Option<Arc<ProfileAccess>>,
}

Execution context passed to phase hooks and action handlers.

Three input sources per ADR-0009:

• agent_spec: immutable agent configuration (model, active_hook_filter, sections)
• snapshot: shared runtime state (StateKeys)
• run_identity: per-run identity (thread_id, run_id, etc.)

Fields

phase: Phase

snapshot: Snapshot

agent_spec: Arc<AgentSpec>

Active agent spec (resolved from registry at each phase boundary).

run_identity: RunIdentity

Per-run identity (thread_id, run_id, etc.). Immutable for the run.

messages: Arc<[Arc<Message>]>

Messages accumulated in the current run.

tool_name: Option<String>

tool_call_id: Option<String>

tool_args: Option<Value>

tool_result: Option<ToolResult>

run_mode: RunMode

adapter: AdapterKind

tool_kind: ToolKind

llm_response: Option<LLMResponse>

resume_input: Option<ToolCallResume>

suspension_id: Option<String>

suspension_reason: Option<String>

cancellation_token: Option<CancellationToken>

Optional cancellation token for cooperative cancellation at phase boundaries.

profile_access: Option<Arc<ProfileAccess>>

Optional profile access for cross-run persistence.

Implementations

impl PhaseContext

pub fn new(phase: Phase, snapshot: Snapshot) -> Self

Create a minimal context (for testing or phases without extra data).

pub fn state<K: StateKey>(&self) -> Option<&K::Value>

Read a state key from the snapshot.

pub fn config<K: PluginConfigKey>(&self) -> Result<K::Config, StateError>

Read a typed plugin config from the active agent spec. Returns Config::default() if the section is missing.

pub fn with_snapshot(self, snapshot: Snapshot) -> Self

pub fn with_agent_spec(self, spec: Arc<AgentSpec>) -> Self

pub fn with_run_identity(self, identity: RunIdentity) -> Self

pub fn with_messages(self, messages: Vec<Arc<Message>>) -> Self

pub fn with_tool_info( self, name: impl Into<String>, call_id: impl Into<String>, args: Option<Value>, ) -> Self

pub fn with_run_mode(self, mode: RunMode) -> Self

pub fn with_adapter(self, adapter: AdapterKind) -> Self

pub fn with_tool_kind(self, kind: ToolKind) -> Self

pub fn tool_policy_context(&self) -> Option<ToolPolicyContext>

Build typed policy context for ToolGate/ToolPolicy hooks.

pub fn with_tool_result(self, result: ToolResult) -> Self

pub fn with_llm_response(self, response: LLMResponse) -> Self

pub fn with_resume_input(self, resume: ToolCallResume) -> Self

pub fn with_suspension( self, suspension_id: Option<String>, suspension_reason: Option<String>, ) -> Self

pub fn with_cancellation_token(self, token: CancellationToken) -> Self

pub fn profile(&self) -> Option<&ProfileAccess>

Get profile access, if configured.

pub fn with_profile_access(self, access: Arc<ProfileAccess>) -> Self

Trait Implementations

impl Clone for PhaseContext

fn clone(&self) -> PhaseContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.