Struct SemanticSummarizer 

pub struct SemanticSummarizer { /* private fields */ }

Semantic summarizer for episodes.

Compresses episodes into concise, searchable summaries suitable for efficient storage and retrieval. Extracts key concepts, critical steps, and generates coherent summary text.

Configuration

• min_summary_length - Minimum words in summary (default: 100)
• max_summary_length - Maximum words in summary (default: 200)
• max_key_steps - Maximum key steps to extract (default: 5)

Examples

use do_memory_core::semantic::SemanticSummarizer;
use do_memory_core::{Episode, TaskContext, TaskType, ExecutionStep, ExecutionResult, TaskOutcome};

let summarizer = SemanticSummarizer::new();

let mut episode = Episode::new(
    "Implement user authentication".to_string(),
    TaskContext::default(),
    TaskType::CodeGeneration,
);

// Add steps
let mut step = ExecutionStep::new(1, "planner".to_string(), "Analyze requirements".to_string());
step.result = Some(ExecutionResult::Success { output: "Requirements clear".to_string() });
episode.add_step(step);

episode.complete(TaskOutcome::Success {
    verdict: "Authentication implemented successfully".to_string(),
    artifacts: vec!["auth.rs".to_string()],
});

let summary = summarizer.summarize_episode(&episode).await?;
assert!(summary.summary_text.split_whitespace().count() >= 50);
assert!(!summary.key_concepts.is_empty());

Implementations

impl SemanticSummarizer

pub fn new() -> Self

Create a new semantic summarizer with default settings.

Default configuration:

• Min summary length: 100 words
• Max summary length: 200 words
• Max key steps: 5

Examples

use do_memory_core::semantic::SemanticSummarizer;

let summarizer = SemanticSummarizer::new();

pub fn with_config(min_len: usize, max_len: usize, max_steps: usize) -> Self

Create a semantic summarizer with custom configuration.

Arguments

• min_len - Minimum words in summary
• max_len - Maximum words in summary
• max_steps - Maximum key steps to extract

Examples

use do_memory_core::semantic::SemanticSummarizer;

let summarizer = SemanticSummarizer::with_config(50, 150, 3);

pub async fn summarize_episode( &self, episode: &Episode, ) -> Result<EpisodeSummary>

Summarize an episode into a semantic summary.

Extracts key information and compresses the episode into a concise, searchable summary with key concepts, critical steps, and summary text. Optionally generates embedding if provider is available.

Arguments

• episode - The episode to summarize

Returns

Semantic summary of the episode

Examples

use do_memory_core::semantic::SemanticSummarizer;
use do_memory_core::{Episode, TaskContext, TaskType};

let summarizer = SemanticSummarizer::new();
let episode = Episode::new(
    "Test task".to_string(),
    TaskContext::default(),
    TaskType::Testing,
);

let summary = summarizer.summarize_episode(&episode).await?;

pub async fn summarize_with_embedding( &self, episode: &Episode, embedding_provider: &impl EmbeddingProvider, ) -> Result<EpisodeSummary>

Summarize an episode with embedding generation.

Like summarize_episode but also generates an embedding vector for the summary text using the provided embedding provider.

Arguments

• episode - The episode to summarize
• embedding_provider - Provider to generate embeddings

Returns

Semantic summary with embedding vector

Examples

use do_memory_core::semantic::SemanticSummarizer;
use do_memory_core::{Episode, TaskContext, TaskType};
use do_memory_core::embeddings::EmbeddingProvider;

let summarizer = SemanticSummarizer::new();
let summary = summarizer.summarize_with_embedding(&episode, &provider).await.unwrap();
assert!(summary.summary_embedding.is_some());

pub fn extract_key_concepts(&self, episode: &Episode) -> Vec<String>

Extract key concepts from an episode.

Arguments

• episode - The episode to extract concepts from

Returns

Vector of key concept strings

pub fn extract_key_steps(&self, episode: &Episode) -> Vec<String>

Extract key steps from an episode.

Arguments

• episode - The episode to extract steps from

Returns

Vector of key step descriptions

pub fn generate_summary_text(&self, episode: &Episode) -> String

Generate summary text from an episode.

Creates a coherent 100-200 word summary with:

• Task description
• Key execution steps
• Salient features (if available)
• Outcome and artifacts

Arguments

• episode - The episode to summarize

Returns

Formatted summary text

Examples

use do_memory_core::semantic::SemanticSummarizer;
use do_memory_core::{Episode, TaskContext, TaskType, TaskOutcome};

let summarizer = SemanticSummarizer::new();

let mut episode = Episode::new(
    "Implement authentication".to_string(),
    TaskContext::default(),
    TaskType::CodeGeneration,
);

episode.complete(TaskOutcome::Success {
    verdict: "Successfully implemented".to_string(),
    artifacts: vec!["auth.rs".to_string()],
});

let summary = summarizer.generate_summary_text(&episode);
assert!(summary.contains("Task:"));
assert!(summary.contains("Outcome:"));

Trait Implementations

impl Clone for SemanticSummarizer

fn clone(&self) -> SemanticSummarizer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticSummarizer

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

Formats the value using the given formatter.

impl Default for SemanticSummarizer

fn default() -> Self

Returns the “default value” for a type.