sqlite-graphrag 1.2.8

Persistent GraphRAG memory for Claude Code, Codex, Cursor, and 27 AI agents — one self-contained ~19 MiB Rust binary, zero daemon. Never re-explain your codebase again. Hybrid retrieval (FTS5 BM25 + cosine similarity + multi-hop graph traversal) surfaces the right memory in milliseconds. Embedding and entity enrichment run as parallel REST calls against your cloud LLM — no fragile headless subprocesses, no ONNX runtime, no model downloads. Soft-delete with full version history, transactional atomic writes, BLAKE3-tracked mutations. OAuth-only: raw API keys ABORT the spawn.
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Result shapes of `deep-research`: sub-query records, evidence chains,
//! graph context and the top-level JSON envelope.

use serde::Serialize;

#[derive(Serialize)]
pub(in crate::commands) struct SubQuery {
    pub(super) id: usize,
    pub(super) text: String,
    pub(super) source: &'static str,
}

#[derive(Serialize)]
pub(super) struct DeepResult {
    pub(super) name: String,
    pub(super) score: f64,
    pub(super) source: String,
    pub(super) sub_query_ids: Vec<usize>,
    pub(super) snippet: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(super) body: Option<String>,
    pub(super) hop_distance: Option<usize>,
}

/// A node in a reconstructed evidence path.
#[derive(Serialize, Clone)]
pub(in crate::commands) struct EvidenceNode {
    pub(super) entity: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(super) relation: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(super) weight: Option<f64>,
}

/// A directed evidence chain reconstructed from BFS predecessors.
///
/// Fields:
/// - `from`: name of the seed (source) entity.
/// - `to`: name of the terminal (target) entity.
/// - `path`: ordered list of intermediate nodes from `from` to `to`.
/// - `total_weight`: product of edge weights along the path.
/// - `sub_query_ids`: which sub-queries produced this chain.
#[derive(Serialize)]
pub(in crate::commands) struct EvidenceChain {
    pub(super) from: String,
    pub(super) to: String,
    pub(super) path: Vec<EvidenceNode>,
    pub(super) total_weight: f64,
    pub(super) depth: usize,
    pub(super) sub_query_ids: Vec<usize>,
}

#[derive(Serialize)]
pub(super) struct ResearchStats {
    pub(super) sub_queries_total: usize,
    pub(super) sub_queries_completed: usize,
    pub(super) sub_queries_failed: usize,
    pub(super) sub_queries_timed_out: usize,
    pub(super) unique_memories_found: usize,
    pub(super) evidence_chains_found: usize,
    pub(super) elapsed_ms: u64,
    pub(super) vec_degraded: bool,
}

#[derive(Serialize)]
pub(super) struct GraphContextEntity {
    pub(super) name: String,
    pub(super) entity_type: String,
    pub(super) degree: u32,
}

#[derive(Serialize)]
pub(super) struct GraphContextRel {
    pub(super) from: String,
    pub(super) to: String,
    pub(super) relation: String,
    pub(super) weight: f64,
}

#[derive(Serialize)]
pub(super) struct GraphContext {
    pub(super) entities: Vec<GraphContextEntity>,
    pub(super) relationships: Vec<GraphContextRel>,
}

#[derive(Serialize)]
pub(super) struct DeepResearchResponse {
    pub(super) query: String,
    pub(super) sub_queries: Vec<SubQuery>,
    pub(super) results: Vec<DeepResult>,
    pub(super) evidence_chains: Vec<EvidenceChain>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub(super) graph_context: Option<GraphContext>,
    pub(super) stats: ResearchStats,
}

/// Aggregated hit data: (score, source_label, snippet, body, hop_distance, sub_query_ids).
pub(super) type MergedHit = (f64, String, String, String, Option<usize>, Vec<usize>);

/// Intermediate result from a single sub-query execution.
pub(in crate::commands) struct SubQueryResult {
    pub(super) sub_query_id: usize,
    /// (memory_id, score, source_label, snippet, body, hop_distance)
    pub(super) hits: Vec<(i64, f64, String, String, String, Option<usize>)>,
    /// Evidence chains reconstructed from BFS.
    pub(super) chains: Vec<EvidenceChain>,
}