Struct AgentReflection 

pub struct AgentReflection {
    pub reflection_id: String,
    pub attempt_summary: String,
    pub failure_analysis: String,
    pub corrective_strategy: String,
    pub improvement_score: Option<f32>,
    pub tags: Vec<String>,
    pub outcome_signals: Vec<OutcomeSignal>,
    pub session_id: String,
    pub task_id: Option<String>,
    pub timestamp: DateTime<Utc>,
}

A structured reflection generated after a suboptimal agent turn.

This is Gestura’s durable representation of ERL’s corrective reflection: a concise summary of the attempted action, the failure mode, and the strategy the agent should apply next time.

The runtime can:

• use it immediately for a same-turn retry,
• store it in session working memory as short-term corrective context, and
• promote it into MemoryType::Reflection for retrieval in future turns.

Fields

reflection_id: String

Stable identifier so downstream outcomes can update the same reflection.

attempt_summary: String

What the agent attempted.

failure_analysis: String

What went wrong or was suboptimal.

corrective_strategy: String

Concrete corrective strategy for future attempts.

improvement_score: Option<f32>

Quality improvement score (0.0–1.0) — did the reflection help? Set after a subsequent attempt to measure improvement.

tags: Vec<String>

Tags for retrieval (tool names, error categories, task types).

outcome_signals: Vec<OutcomeSignal>

Durable outcome signals linked back from retries, gates, and task outcomes.

session_id: String

Session context.

task_id: Option<String>

Task ID if available.

timestamp: DateTime<Utc>

When this reflection was created.

Implementations

impl AgentReflection

pub fn new( session_id: impl Into<String>, attempt_summary: impl Into<String>, failure_analysis: impl Into<String>, corrective_strategy: impl Into<String>, ) -> Self

Create a new reflection.

pub fn with_tags(self, tags: Vec<String>) -> Self

Attach tags for retrieval.

pub fn with_task(self, task_id: impl Into<String>) -> Self

Attach a task ID.

pub fn with_outcome_signals(self, outcome_signals: Vec<OutcomeSignal>) -> Self

Attach durable outcome signals for corrective-learning provenance.

pub fn push_outcome_signal(&mut self, signal: OutcomeSignal)

Record a single durable outcome signal.

pub fn promotion_confidence(&self) -> f32

Score how strongly this reflection should be promoted into durable memory.

pub fn to_prompt_section(&self) -> String

Format as a prompt section for context injection.

Trait Implementations

impl Clone for AgentReflection

fn clone(&self) -> AgentReflection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentReflection

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentReflection

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentReflection

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

where __S: Serializer,

Serialize this value into the given Serde serializer.