comindly-engine 0.5.0-beta.12

comindly's engine: the index behind /api/v1 and /mcp, on this machine or as a team server, with the web app, indexing jobs, members and roles.
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
108
109
110
111
112
113
114
115
116
117
118

//! Settings from the UI: read and write `config.toml`, and switch the
//! loaded index without a restart.

use axum::extract::State;
use axum::Json;

use super::{bad as fail, Cur, Reply, Shared};
use crate::api;
use crate::config::Setting;

pub(super) async fn get(State(app): State<Shared>, Cur(s): Cur) -> Json<api::Settings> {
    let (server, cfg, settings) = (app.server.clone(), app.config(), app.settings());
    let root = s.data.root.clone().unwrap_or_default();
    let team = app.team().name;
    let key = tokio::task::spawn_blocking(move || {
        crate::credentials::llm_key(team.as_deref(), server.as_deref()).1
    })
    .await
    .unwrap_or(crate::credentials::Source::None);
    Json(api::Settings {
        config_path: crate::config::store_path().to_string_lossy().into_owned(),
        index_dir: cfg.index_dir.clone(),
        index_effective: root,
        author_name: cfg.author_name.clone(),
        author_effective: crate::config::local_identity().name,
        record_names: cfg.record_names.unwrap_or(true),
        llm_model: settings.llm_model,
        defaults: super::team::defaults(),
        llm_key: key,
        cache_ttl_secs: cfg.cache_ttl_secs.unwrap_or(crate::cache::DEFAULT_TTL),
    })
}

/// Save the given settings; a new index location is loaded before it is saved.
pub(super) async fn save(
    State(app): State<Shared>,
    Json(c): Json<api::SettingsChange>,
) -> Reply<api::Done> {
    let run = async {
        let text = |v: &Option<String>| match v.as_deref().map(str::trim) {
            Some("") => Setting::Remove,
            Some(t) => Setting::Text(t.to_string()),
            None => unreachable!(),
        };
        let mut changes: Vec<(&str, Setting)> = Vec::new();
        anyhow::ensure!(
            app.server.is_none(),
            "a server takes its settings from the deployment and the index's shared settings"
        );
        if c.author_name.is_some() {
            changes.push(("author_name", text(&c.author_name)));
        }
        if let Some(v) = c.record_names {
            changes.push(("record_names", Setting::Flag(v)));
        }
        if let Some(v) = c.cache_ttl_secs {
            changes.push(("cache_ttl_secs", Setting::Number(v.max(30) as i64)));
        }
        let mut message = "saved".to_string();
        if let Some(dir) = c
            .index_dir
            .as_deref()
            .map(str::trim)
            .filter(|d| !d.is_empty())
        {
            let dir = crate::config::expand_tilde(dir);
            app.reload(&dir).await?;
            changes.push(("index_dir", Setting::Text(dir.clone())));
            message = format!("saved; now showing {dir}");
        }
        crate::config::update(&changes)?;
        app.config_changed();
        anyhow::Ok(message)
    };
    run.await.map(|m| Json(api::Done::new(m))).map_err(fail)
}

/// Whether an index location can be read, without switching to it.
pub(super) async fn test(Json(p): Json<api::IndexDirRequest>) -> Reply<api::Done> {
    let root = crate::config::expand_tilde(p.index_dir.trim());
    let graph = format!("{}/_graph", root.trim_end_matches('/'));
    let message = match crate::index::graph_versions(&graph).await {
        Ok(v) if !v.is_empty() => {
            format!("index found: {}", crate::doctor::plural(v.len(), "version"))
        }
        Ok(_) | Err(_) if !root.contains("://") && !std::path::Path::new(&root).exists() => {
            "empty location: an index will be created here when you index repositories".into()
        }
        Ok(_) => "reachable, no index yet".into(),
        Err(e) => return Err(fail(e)),
    };
    Ok(Json(api::Done::new(message)))
}

pub(super) async fn logging() -> Json<api::Logging> {
    Json(api::Logging {
        access: crate::telemetry::logs("access"),
        tool: crate::telemetry::logs("tool"),
    })
}

/// Switch kinds of log lines on or off now; a server keeps the choice across restarts.
pub(super) async fn set_logging(
    who: super::Member,
    State(app): State<Shared>,
    Json(l): Json<api::Logging>,
) -> Reply<api::Done> {
    crate::telemetry::set_logs("access", l.access);
    crate::telemetry::set_logs("tool", l.tool);
    if let Some(server) = &app.server {
        let by = who.map(|w| w.email.clone()).unwrap_or_default();
        server
            .settings
            .set_log_skip(&by, &crate::telemetry::skipped())
            .map_err(super::bad)?;
    }
    Ok(Json(api::Done::new("Logging updated")))
}