holographic-memory 0.6.4

Local-first search engine and agent memory: fast approximate nearest-neighbor and BM25 full-text search, encrypted stores, provable deletion, built on vector-symbolic architectures.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// Copyright 2024-2026 WritersLogic Contributors
// SPDX-License-Identifier: Apache-2.0

use napi::bindgen_prelude::*;
use std::sync::Arc;
use tracing::info_span;

use crate::{
    chunk_document, ConceptCandidate, DocumentChunk, DocumentInput, DocumentResult, EntangledHVec,
    HardwareCapabilities, HmsCore, IndexStatus, MemorizeBatchItem, QueryExplanation,
    RetrievalResult, SearchOptions, StorageHealth, TextMetrics,
};

mod api;
pub use api::HolographicMemorySystem;
mod config;
mod types;

#[cfg(feature = "local-embed")]
mod embed;

pub use config::HmsConfigJs;
pub use types::*;

fn napi_err(e: anyhow::Error) -> napi::Error {
    napi::Error::from_reason(e.to_string())
}

/// Memory API errors carry their class in a `[code]` prefix; `memory.js` turns it into
/// `error.code`.
fn memory_err(e: anyhow::Error) -> napi::Error {
    use crate::core::memory_api::MemoryError;
    let code = match e.downcast_ref::<MemoryError>() {
        Some(MemoryError::Invalid(_)) => "invalid_request",
        Some(MemoryError::NotFound(_)) => "not_found",
        Some(MemoryError::Conflict(_)) => "conflict",
        None => "internal",
    };
    napi::Error::from_reason(format!("[{code}] {e}"))
}

async fn run_async<T: Send + 'static, F: FnOnce() -> anyhow::Result<T> + Send + 'static>(
    f: F,
) -> Result<T> {
    tokio::task::spawn_blocking(f)
        .await
        .map_err(|e| napi::Error::from_reason(e.to_string()))?
        .map_err(napi_err)
}