a3s 0.10.5

a3s — A3S coding agent CLI; `a3s code` launches the interactive TUI
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

use std::fs::{self, OpenOptions};
use std::io::{self, Write};
use std::path::{Path, PathBuf};

use super::AgentPresencePublisher;

pub(super) const AGENT_ISLAND_DISABLED_FILE: &str = "island.disabled";

pub(super) fn disabled_path(directory: Option<&Path>) -> Option<PathBuf> {
    directory.map(|directory| directory.join(AGENT_ISLAND_DISABLED_FILE))
}

/// A missing marker is the default-on state. Any existing filesystem entry,
/// or an unreadable marker path, fails closed so a saved opt-out is not lost.
pub(super) fn is_enabled(directory: Option<&Path>) -> bool {
    let Some(path) = disabled_path(directory) else {
        return true;
    };
    match fs::symlink_metadata(path) {
        Err(error) if error.kind() == io::ErrorKind::NotFound => true,
        Ok(_) | Err(_) => false,
    }
}

pub(super) fn set_enabled(directory: Option<&Path>, enabled: bool) -> io::Result<()> {
    let directory = directory.ok_or_else(|| {
        io::Error::new(
            io::ErrorKind::NotFound,
            "no per-user A3S state directory is available",
        )
    })?;
    ensure_private_directory(directory)?;
    let path = directory.join(AGENT_ISLAND_DISABLED_FILE);
    if enabled {
        return match fs::remove_file(path) {
            Ok(()) => Ok(()),
            Err(error) if error.kind() == io::ErrorKind::NotFound => Ok(()),
            Err(error) => Err(error),
        };
    }

    let mut options = OpenOptions::new();
    options.create_new(true).write(true);
    #[cfg(unix)]
    {
        use std::os::unix::fs::OpenOptionsExt;
        options.mode(0o600);
    }
    match options.open(path) {
        Ok(mut file) => {
            file.write_all(b"disabled\n")?;
            file.sync_all()
        }
        Err(error) if error.kind() == io::ErrorKind::AlreadyExists => Ok(()),
        Err(error) => Err(error),
    }
}

#[cfg(unix)]
fn ensure_private_directory(path: &Path) -> io::Result<()> {
    use std::os::unix::fs::{DirBuilderExt, PermissionsExt};

    let mut builder = fs::DirBuilder::new();
    builder.recursive(true).mode(0o700);
    builder.create(path)?;
    fs::set_permissions(path, fs::Permissions::from_mode(0o700))
}

#[cfg(not(unix))]
fn ensure_private_directory(path: &Path) -> io::Result<()> {
    fs::create_dir_all(path)
}

impl AgentPresencePublisher {
    pub(crate) fn island_preference_enabled(&self) -> bool {
        is_enabled(self.directory.as_deref())
    }

    pub(crate) fn persist_island_enabled(&self, enabled: bool) -> io::Result<()> {
        set_enabled(self.directory.as_deref(), enabled)
    }
}