lean-ctx 3.9.19

Context Runtime for AI Agents with CCP. 79 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%.
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! Passthrough/control adapter for native A/B comparisons.

use std::path::{Path, PathBuf};
use std::sync::OnceLock;
use std::time::Instant;

use lean_ctx_protocol::CapabilityManifestV1;

use super::{invoke_passthrough_text, read_context_paths};
use crate::core::ocla::invocation::{
    CapabilityAdapter, CapabilityInput, CapabilityInvocation, CapabilityResult,
};
use crate::core::ocla::{OclaError, OclaResult};

/// Repository-relative manifest used by this adapter.
pub const MANIFEST_PATH: &str = "contracts/ocla/capability-manifests/leanctx/passthrough-v1.json";
const MANIFEST_JSON: &str =
    include_str!("../../../../../contracts/ocla/capability-manifests/leanctx/passthrough-v1.json");

fn manifest() -> &'static CapabilityManifestV1 {
    static MANIFEST: OnceLock<CapabilityManifestV1> = OnceLock::new();
    MANIFEST.get_or_init(|| {
        let manifest: CapabilityManifestV1 =
            serde_json::from_str(MANIFEST_JSON).expect("passthrough manifest is valid JSON");
        manifest
            .validate()
            .expect("passthrough manifest satisfies the protocol");
        manifest
    })
}

/// Baseline adapter that returns the materialized input unchanged.
pub struct PassthroughAdapter {
    root: PathBuf,
}

impl PassthroughAdapter {
    #[must_use]
    pub fn new() -> Self {
        Self {
            root: std::env::current_dir().unwrap_or_else(|_| PathBuf::from(".")),
        }
    }

    #[must_use]
    pub fn with_root(root: impl AsRef<Path>) -> Self {
        Self {
            root: root.as_ref().to_path_buf(),
        }
    }

    #[must_use]
    pub fn root(&self) -> &Path {
        &self.root
    }
}

impl Default for PassthroughAdapter {
    fn default() -> Self {
        Self::new()
    }
}

impl CapabilityAdapter for PassthroughAdapter {
    fn manifest(&self) -> &CapabilityManifestV1 {
        manifest()
    }

    fn invoke(&self, invocation: CapabilityInvocation) -> OclaResult<CapabilityResult> {
        invocation.validate()?;
        if invocation.capability_id != self.manifest().capability_id.as_str()
            || invocation.capability_version != self.manifest().version
        {
            return Err(OclaError::InvalidRequest(
                "invocation capability identity does not match adapter manifest".into(),
            ));
        }
        let start = Instant::now();
        match invocation.input.clone() {
            CapabilityInput::ContextRequest { paths, .. } => {
                let content = read_context_paths(&self.root, &paths)?;
                invoke_passthrough_text(&invocation, &content, start)
            }
            CapabilityInput::ShellCommand { command, .. } => {
                invoke_passthrough_text(&invocation, &command, start)
            }
            CapabilityInput::ModelRequest { prompt, .. } => {
                invoke_passthrough_text(&invocation, &prompt, start)
            }
        }
    }

    fn health_check(&self) -> OclaResult<bool> {
        Ok(self.root.is_dir() && self.manifest().validate().is_ok())
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::core::ocla::invocation::{CapabilityAdapter, PolicyConstraints};

    #[test]
    fn preserves_shell_command_content_reference() {
        let adapter = PassthroughAdapter::new();
        let invocation = CapabilityInvocation {
            task_id: "task-1".into(),
            capability_id: adapter.manifest().capability_id.as_str().into(),
            capability_version: adapter.manifest().version.clone(),
            input: CapabilityInput::ShellCommand {
                command: "printf unchanged".into(),
                workdir: None,
            },
            policy_constraints: PolicyConstraints::default(),
            timeout_ms: 100,
        };
        let result = adapter.invoke(invocation).expect("passthrough invocation");
        assert!(result.success);
        assert_eq!(result.observation.input_tokens, result.output_tokens);
        assert!(result.evidence_ref.is_some());
    }
}