codex-helper-core 0.20.0

Core library for codex-helper.
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

use std::path::Path;

#[derive(Debug, Default, Clone, Copy, PartialEq, Eq)]
pub enum HostLocalSessionHistoryMode {
    #[default]
    Auto,
    Disabled,
    Enabled,
}

pub fn host_local_session_history_available() -> bool {
    host_local_session_history_available_for_mode(HostLocalSessionHistoryMode::Auto)
}

pub fn host_local_session_history_available_for_mode(mode: HostLocalSessionHistoryMode) -> bool {
    host_local_session_history_available_in_dir(
        configured_mode(mode),
        &crate::config::codex_sessions_dir(),
    )
}

pub fn host_local_session_history_available_in_dir(
    mode: HostLocalSessionHistoryMode,
    sessions_dir: &Path,
) -> bool {
    match mode {
        HostLocalSessionHistoryMode::Disabled => false,
        HostLocalSessionHistoryMode::Auto | HostLocalSessionHistoryMode::Enabled => {
            std::fs::metadata(sessions_dir)
                .map(|metadata| metadata.is_dir())
                .unwrap_or(false)
        }
    }
}

fn configured_mode(mode: HostLocalSessionHistoryMode) -> HostLocalSessionHistoryMode {
    match mode {
        HostLocalSessionHistoryMode::Auto => {
            mode_from_env().unwrap_or(HostLocalSessionHistoryMode::Auto)
        }
        mode => mode,
    }
}

fn mode_from_env() -> Option<HostLocalSessionHistoryMode> {
    let value = std::env::var("CODEX_HELPER_HOST_LOCAL_SESSION_HISTORY").ok()?;
    let normalized = value.trim().to_ascii_lowercase();
    match normalized.as_str() {
        "0" | "false" | "off" | "disabled" | "disable" => {
            Some(HostLocalSessionHistoryMode::Disabled)
        }
        "1" | "true" | "on" | "enabled" | "enable" => Some(HostLocalSessionHistoryMode::Enabled),
        "" | "auto" => Some(HostLocalSessionHistoryMode::Auto),
        _ => None,
    }
}

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

    #[test]
    fn host_local_history_disabled_even_when_dir_exists() {
        let dir = std::env::temp_dir().join(format!(
            "codex-helper-host-local-disabled-{}",
            std::process::id()
        ));
        std::fs::create_dir_all(&dir).expect("create temp sessions dir");

        assert!(!host_local_session_history_available_in_dir(
            HostLocalSessionHistoryMode::Disabled,
            &dir
        ));

        let _ = std::fs::remove_dir_all(&dir);
    }

    #[test]
    fn host_local_history_auto_requires_existing_dir() {
        let dir = std::env::temp_dir().join(format!(
            "codex-helper-host-local-auto-missing-{}",
            std::process::id()
        ));
        let _ = std::fs::remove_dir_all(&dir);

        assert!(!host_local_session_history_available_in_dir(
            HostLocalSessionHistoryMode::Auto,
            &dir
        ));

        std::fs::create_dir_all(&dir).expect("create temp sessions dir");
        assert!(host_local_session_history_available_in_dir(
            HostLocalSessionHistoryMode::Auto,
            &dir
        ));

        let _ = std::fs::remove_dir_all(&dir);
    }
}