lean-ctx 3.9.17

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
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

//! Self-contained lifecycle runtime for the OCLA REST API.

use axum::serve;
use tokio::{net::TcpListener, task::JoinHandle};
use tokio_util::sync::CancellationToken;
use tracing::{debug, warn};

use crate::core::config::OclaConfig;

use super::OclaResult;
use super::wire_api::ocla_router;

/// Owns the OCLA REST server task and its graceful-shutdown signal.
pub struct OclaRuntime {
    rest_handle: JoinHandle<()>,
    cancel: CancellationToken,
    rest_port: u16,
}

impl OclaRuntime {
    /// Starts the OCLA REST API on an OS-assigned loopback port.
    pub async fn start(config: &OclaConfig) -> OclaResult<Self> {
        let _ = config;
        let listener = TcpListener::bind("127.0.0.1:0").await.map_err(|error| {
            super::OclaError::InvalidRequest(format!("failed to bind OCLA REST listener: {error}"))
        })?;
        let rest_port = listener
            .local_addr()
            .map_err(|error| {
                super::OclaError::InvalidRequest(format!(
                    "failed to inspect OCLA REST listener: {error}"
                ))
            })?
            .port();
        let cancel = CancellationToken::new();
        let shutdown = cancel.clone();
        let rest_handle = tokio::spawn(async move {
            if let Err(error) = serve(listener, ocla_router())
                .with_graceful_shutdown(shutdown.cancelled_owned())
                .await
            {
                warn!(error = %error, "OCLA REST server stopped with an error");
            }
        });

        Ok(Self {
            rest_handle,
            cancel,
            rest_port,
        })
    }

    /// Requests graceful shutdown and waits for the REST task to finish.
    pub async fn stop(self) -> OclaResult<()> {
        self.cancel.cancel();
        self.rest_handle.await.map_err(|error| {
            super::OclaError::InvalidRequest(format!("OCLA REST task failed: {error}"))
        })?;
        debug!("OCLA REST runtime stopped");
        Ok(())
    }

    /// Returns the OS-assigned REST listener port.
    #[must_use]
    pub fn rest_port(&self) -> u16 {
        self.rest_port
    }

    /// Returns whether the REST server task has not finished.
    #[must_use]
    pub fn is_running(&self) -> bool {
        !self.rest_handle.is_finished()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[tokio::test]
    async fn start_and_stop_lifecycle() {
        let runtime = OclaRuntime::start(&OclaConfig::default())
            .await
            .expect("runtime starts");
        assert!(runtime.is_running());
        runtime.stop().await.expect("runtime stops");
    }

    #[tokio::test]
    async fn rest_port_is_nonzero() {
        let runtime = OclaRuntime::start(&OclaConfig::default())
            .await
            .expect("runtime starts");
        assert_ne!(runtime.rest_port(), 0);
        runtime.stop().await.expect("runtime stops");
    }

    #[tokio::test]
    async fn double_stop_is_idempotent() {
        let runtime = OclaRuntime::start(&OclaConfig::default())
            .await
            .expect("runtime starts");
        runtime.cancel.cancel();
        runtime.cancel.cancel();
        runtime.stop().await.expect("runtime stops");
    }
}