oharness-critic 0.1.0

Critic / Reflector traits, composition, and shipped impls for open-harness
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

//! [`Reflector`] trait (plan §11.4).
//!
//! A reflector runs once per episode in a `run_reflexion` sweep. It receives
//! a borrowed [`oharness_core::Episode`] and optionally emits a
//! [`oharness_core::Reflection`] that the next episode will see via the
//! [`crate::ReflectionInjector`] middleware. Always invoked — the reflector
//! itself decides whether to produce a reflection (hence the `Option`
//! return type).

use async_trait::async_trait;
use oharness_core::{Episode, Reflection};

#[async_trait]
pub trait Reflector: Send + Sync {
    /// Short, stable identifier — e.g. `"null"`, `"llm"`.
    fn name(&self) -> &str;

    /// Inspect the finished episode and optionally produce a reflection.
    /// Returning `None` skips reflexion injection for the next iteration.
    async fn reflect(&self, episode: &Episode<'_>) -> Option<Reflection>;
}