Module recall 

Memory recall (search) service.

Searches for memories using hybrid (vector + BM25) search with RRF fusion.

Examples

Text search with BM25:

use subcog::services::RecallService;
use subcog::models::{SearchFilter, SearchMode};
use subcog::storage::index::SqliteBackend;

let index = SqliteBackend::in_memory()?;
let service = RecallService::with_index(index);

let filter = SearchFilter::new();
let results = service.search("database architecture", SearchMode::Text, &filter, 10)?;

for hit in &results.memories {
    println!("{}: {:.2}", hit.memory.id.as_str(), hit.score);
}

Filtering by namespace:

use subcog::services::RecallService;
use subcog::models::{Namespace, SearchFilter, SearchMode};
use subcog::storage::index::SqliteBackend;

let index = SqliteBackend::in_memory()?;
let service = RecallService::with_index(index);

let filter = SearchFilter::new().with_namespace(Namespace::Decisions);
let results = service.search("PostgreSQL", SearchMode::Text, &filter, 5)?;

Structs

RecallService

Service for searching and retrieving memories.

Constants

DEFAULT_SEARCH_TIMEOUT_MS

Default search timeout in milliseconds (5 seconds).

Functions

create_placeholder_memory 🔒

Creates a placeholder memory for search results.

domain_label 🔒

Returns a domain label for metrics, avoiding allocations for common cases.

normalize_scores 🔒

Normalizes search result scores to the 0.0-1.0 range.

record_recall_events 🔒

Type Aliases

RrfEntry 🔒

RRF fusion entry storing indices instead of cloning SearchHit.