innate 0.1.16

Innate — self-growing procedural knowledge layer for AI agents
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
50
51
52
53
54
55
56
57
58
59
60
61
62

pub mod backup;
pub mod cli;
pub mod daemon;
pub mod embedding;
pub mod errors;
pub mod hook;
pub mod install;
pub mod kb;
pub mod llm;
pub mod llm_trace;
pub mod mcp;
pub mod migrate;
pub mod paths;
pub mod refine;
pub mod settings;
pub mod storage;
pub mod upgrade;
pub mod utils;
pub mod web;

#[cfg(test)]
mod tests;

pub use errors::{InnateError, Result};
pub use kb::{
    AbstainReason, AppraiseParams, Contributor, CurateReport, FlaggedPoint, KnowledgeBase,
    RecallParams, RecallResult, RecordParams, Situation, Tier, Valence, Verdict, APPRAISE_ADVISORY,
};

/// Open a KnowledgeBase at `db_path`, injecting LLM providers from `~/.innate/settings.json`
/// if configured. Falls back to DummyEmbeddingProvider + HeuristicDistiller when no LLM
/// settings are present.
pub fn open_kb(db_path: impl AsRef<std::path::Path>) -> Result<KnowledgeBase> {
    use std::sync::Arc;
    let s = settings::load()?;

    let embedding: Option<Arc<dyn embedding::EmbeddingProvider>> = s.embedding.as_ref().map(|c| {
        Arc::new(llm::LlmEmbeddingProvider::new(c.clone())) as Arc<dyn embedding::EmbeddingProvider>
    });

    // When a remote LLM distiller is configured, wrap it with a deterministic
    // fallback so knowledge creation never depends on the LLM staying available:
    // the LLM gets the first 2 attempts per log (quality); after that the
    // deterministic HeuristicDistiller guarantees capture (stability).
    let distiller: Option<Arc<dyn refine::Distiller>> = s.llm.as_ref().map(|c| {
        let primary = llm::build_distiller(c) as Arc<dyn refine::Distiller>;
        Arc::new(refine::ResilientDistiller::new(
            primary,
            Arc::new(refine::HeuristicDistiller),
            2,
        )) as Arc<dyn refine::Distiller>
    });

    let kb = KnowledgeBase::open_with(db_path, embedding, None, distiller, None, None)?;
    // Opt-in offline reranker (part d): wired only when an LLM is configured. recall
    // invokes it solely when a caller sets rerank=true, so the hook path stays no-LLM.
    let kb = match s.llm.as_ref() {
        Some(c) => kb.with_reranker(Arc::new(llm::LlmReranker::new(c.clone()))),
        None => kb,
    };
    Ok(kb)
}