Struct SonaEngine 

pub struct SonaEngine { /* private fields */ }

The SONA engine for trajectory-based self-learning.

Records execution trajectories, distills patterns from successful ones, and adapts future behavior by matching against learned patterns.

Implementations

impl SonaEngine

pub fn new(mode: SonaMode, embedding: Arc<dyn EmbeddingProvider>) -> SonaEngine

Create a new SONA engine with the given mode and embedding provider.

pub fn mode(&self) -> SonaMode

Return the current operating mode.

pub async fn record(&self, trajectory: Trajectory) -> Result<String, Error>

Record a new trajectory.

Generates an embedding for the trajectory’s input text and stores it for future distillation.

pub async fn distill(&self) -> Result<Vec<LearnedPattern>, Error>

Distill learned patterns from successful trajectories.

Groups successful trajectories by domain and extracts common patterns. Returns the newly distilled patterns.

pub async fn adapt(&self, query: &str) -> Result<Option<LearnedPattern>, Error>

Adapt to a new query by finding the most similar learned pattern.

Returns the best matching pattern if similarity exceeds threshold. Target: < 0.05ms for in-memory lookup.

pub fn counts(&self) -> (usize, usize)

Return counts of trajectories and patterns.

pub fn get_learned_patterns(&self) -> Vec<LearnedPattern>

Get all learned patterns for persistence.

pub fn load_learned_patterns(&self, patterns: Vec<LearnedPattern>)

Load learned patterns from persistence.

pub fn trajectories_by_verdict(&self, verdict: Verdict) -> Vec<Trajectory>

Get trajectories filtered by verdict.

pub fn persist_to_sqlite(&self, store: &SqliteMemoryStore) -> Result<(), Error>

Persist learned patterns to SQLite.

Saves all distilled patterns to the patterns table.

pub fn restore_from_sqlite( &self, store: &SqliteMemoryStore, ) -> Result<(), Error>

Restore learned patterns from SQLite.

Loads all SONA patterns from the patterns table.

Trait Implementations

impl Debug for SonaEngine

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

Formats the value using the given formatter.