lean-ctx 3.8.16

Context Runtime for AI Agents with CCP. 71 MCP tools, 10 read modes, 95+ compression patterns, cross-session memory (CCP), persistent AI knowledge with temporal facts + contradiction detection, multi-agent context sharing, LITM-aware positioning, AAAK compact format, adaptive compression with Thompson Sampling bandits. Supports 24+ AI tools. Reduces LLM token consumption by up to 99%.
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

//! The portable context-package bundle format (#293).

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

use crate::core::session::{Decision, FileTouched, Finding, TaskInfo, TestSnapshot};
use crate::core::session_summary::SummaryRecord;

pub const FORMAT_VERSION: u32 = 1;

/// A portable, self-contained context package.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ContextPackage {
    pub format_version: u32,
    pub created_at: DateTime<Utc>,
    pub project_root: String,
    pub session_id: String,
    pub metadata: PackageMetadata,
    pub session: SessionSlice,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub summaries: Vec<SummaryRecord>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub knowledge: Vec<KnowledgeFact>,
}

/// Human-readable metadata about the package.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PackageMetadata {
    pub agent_id: Option<String>,
    pub description: Option<String>,
    pub tool_calls: u32,
    pub tokens_saved: u64,
}

/// The essential slice of session state to restore.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SessionSlice {
    pub task: Option<TaskInfo>,
    pub findings: Vec<Finding>,
    pub decisions: Vec<Decision>,
    pub files: Vec<FileTouched>,
    pub next_steps: Vec<String>,
    pub test_results: Option<TestSnapshot>,
}

/// A knowledge fact (compact, portable representation).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct KnowledgeFact {
    pub category: String,
    pub key: String,
    pub value: String,
    pub confidence: f32,
    pub created_at: DateTime<Utc>,
}

impl ContextPackage {
    pub fn is_compatible(&self) -> bool {
        self.format_version <= FORMAT_VERSION
    }

    pub fn summary_line(&self) -> String {
        let desc = self
            .metadata
            .description
            .as_deref()
            .or(self.session.task.as_ref().map(|t| t.description.as_str()))
            .unwrap_or("(no description)");
        format!(
            "[{}] {} — {} files, {} decisions, {} summaries, {} facts",
            self.session_id
                .split('-')
                .next()
                .unwrap_or(&self.session_id),
            desc,
            self.session.files.len(),
            self.session.decisions.len(),
            self.summaries.len(),
            self.knowledge.len()
        )
    }
}