Struct VelesSemanticMemory 

pub struct VelesSemanticMemory { /* private fields */ }

Semantic Memory for AI agents on mobile.

Stores knowledge facts as vectors with similarity search.

Fact content text is persisted in the point payload (mirroring the core SemanticMemory), so content survives a database reload.

Example (Swift)

let memory = try VelesSemanticMemory(db: db, dimension: 384)
try memory.store(id: 1, content: "Paris is the capital of France", embedding: embedding)
let results = try memory.query(embedding: queryEmbedding, topK: 5)

Implementations

impl VelesSemanticMemory

pub fn new(db: &VelesDatabase, dimension: u32) -> Result<Self, VelesError>

Creates a new VelesSemanticMemory with the given embedding dimension.

pub fn store( &self, id: u64, content: String, embedding: Vec<f32>, ) -> Result<(), VelesError>

Stores a knowledge fact with its embedding vector.

The content text is persisted in the point payload as {"content": ...} so it survives a database reload.

pub fn query( &self, embedding: Vec<f32>, top_k: u32, ) -> Result<Vec<SemanticResult>, VelesError>

Queries semantic memory by similarity search.

Content text is read back from each matched point’s payload.

pub fn len(&self) -> Result<u64, VelesError>

Returns the number of stored knowledge facts.

pub fn is_empty(&self) -> Result<bool, VelesError>

Returns true if no knowledge facts are stored.

pub fn delete(&self, id: u64) -> Result<(), VelesError>

Deletes a knowledge fact by ID.

pub fn remove(&self, id: u64) -> Result<(), VelesError>

Removes a knowledge fact by ID.

Deprecated alias for Self::delete, kept for backward compatibility and naming parity with prior mobile releases.

pub fn clear(&self) -> Result<(), VelesError>

Removes all stored knowledge facts.

Best-effort: individual delete failures are non-fatal so the operation clears as much as possible.

pub fn dimension(&self) -> u32

Returns the embedding dimension.

Trait Implementations

impl<UT> LiftRef<UT> for VelesSemanticMemory

type LiftType = Arc<VelesSemanticMemory>

impl<UT> LowerError<UT> for VelesSemanticMemory

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for VelesSemanticMemory

type ReturnType = <Arc<VelesSemanticMemory> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for VelesSemanticMemory

const TYPE_ID_META: MetadataBuffer