Enum FrameKind 

pub enum FrameKind {
    IntentAnalysis,
    StepSummary,
    CodeChange,
    SystemState,
    ErrorRecovery,
    Checkpoint,
    ToolCall,
    Other(String),
}

The kind of context captured in a ContextFrame.

Determines how the frame’s summary and data should be interpreted. IntentAnalysis and Checkpoint are protected from eviction when max_frames is exceeded.

Variants

IntentAnalysis

Initial context derived from an Intent’s analyzed content.

Created when the AI fills in the content field on an Intent, serving as the foundation for subsequent Plan creation. This is the seed frame — always the first frame in a pipeline. Protected from eviction.

StepSummary

Summary produced after a PlanStep completes. Captures what the step accomplished so that subsequent steps have context.

CodeChange

Code change digest (e.g. files modified, diff stats). Typically produced alongside a PatchSet.

SystemState

System or environment state snapshot (e.g. memory usage, disk space, running services).

ErrorRecovery

Context captured during error recovery. Records what went wrong and what corrective action was taken, so that subsequent steps don’t repeat the same mistakes.

Checkpoint

Explicit save-point created by user or system. Protected from eviction. Used for long-running workflows where the agent may be paused and resumed.

ToolCall

Result of an external tool invocation (MCP service, function call, REST API, CLI command, etc.).

Intentionally protocol-agnostic: MCP is one transport for tool calls, but agents may also invoke tools via direct function calls, HTTP APIs, or shell commands. Protocol-specific details (server name, tool name, arguments, result preview) belong in ContextFrame.data.

Other(String)

Application-defined context type not covered by the variants above.

Implementations

impl FrameKind

pub fn as_str(&self) -> &str

Trait Implementations

impl Clone for FrameKind

fn clone(&self) -> FrameKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FrameKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FrameKind

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

Formats the value using the given formatter.

impl PartialEq for FrameKind

fn eq(&self, other: &FrameKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for FrameKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for FrameKind

impl StructuralPartialEq for FrameKind