aether-wisp 0.5.1

A terminal UI for AI coding agents via the Agent Client Protocol (ACP)
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

//! Host integrations the UI reaches for: opening a URL and writing the
//! clipboard. Injected as closures so tests can observe them without spawning
//! anything.

use std::sync::Arc;

pub type BrowserOpener = Arc<dyn Fn(&str) -> Result<(), String> + Send + Sync>;
pub type ClipboardWriter = Arc<dyn Fn(&str) -> Result<(), String> + Send + Sync>;

pub fn default_browser_opener() -> BrowserOpener {
    Arc::new(|url: &str| open_url(url))
}

pub fn default_clipboard_writer() -> ClipboardWriter {
    Arc::new(|text: &str| write_clipboard(text))
}

#[cfg(target_os = "macos")]
fn open_url(url: &str) -> Result<(), String> {
    run("open", &[url])
}

#[cfg(target_os = "linux")]
fn open_url(url: &str) -> Result<(), String> {
    run("xdg-open", &[url])
}

#[cfg(target_os = "windows")]
fn open_url(url: &str) -> Result<(), String> {
    run("cmd", &["/C", "start", url])
}

#[cfg(not(any(target_os = "macos", target_os = "linux", target_os = "windows")))]
fn open_url(_url: &str) -> Result<(), String> {
    Err("Unsupported platform for opening URLs".to_string())
}

#[cfg(target_os = "macos")]
fn write_clipboard(text: &str) -> Result<(), String> {
    pipe_to("pbcopy", &[], text)
}

#[cfg(target_os = "linux")]
fn write_clipboard(text: &str) -> Result<(), String> {
    pipe_to("wl-copy", &[], text)
        .or_else(|_| pipe_to("xclip", &["-selection", "clipboard"], text))
        .or_else(|_| pipe_to("xsel", &["--clipboard", "--input"], text))
        .map_err(|_| "No clipboard tool found (wl-copy, xclip, or xsel)".to_string())
}

#[cfg(target_os = "windows")]
fn write_clipboard(text: &str) -> Result<(), String> {
    pipe_to("clip", &[], text)
}

#[cfg(not(any(target_os = "macos", target_os = "linux", target_os = "windows")))]
fn write_clipboard(_text: &str) -> Result<(), String> {
    Err("Unsupported platform for copying text".to_string())
}

#[cfg(any(target_os = "macos", target_os = "linux", target_os = "windows"))]
fn run(command: &str, args: &[&str]) -> Result<(), String> {
    let status = std::process::Command::new(command)
        .args(args)
        .status()
        .map_err(|error| format!("Failed to spawn '{command}': {error}"))?;
    exit_ok(command, status)
}

#[cfg(any(target_os = "macos", target_os = "linux", target_os = "windows"))]
fn pipe_to(command: &str, args: &[&str], text: &str) -> Result<(), String> {
    use std::io::Write;
    let mut child = std::process::Command::new(command)
        .args(args)
        .stdin(std::process::Stdio::piped())
        .spawn()
        .map_err(|error| format!("Failed to spawn '{command}': {error}"))?;
    child
        .stdin
        .as_mut()
        .ok_or_else(|| format!("'{command}' has no stdin"))?
        .write_all(text.as_bytes())
        .map_err(|error| format!("Failed to write to '{command}': {error}"))?;
    let status = child.wait().map_err(|error| format!("Failed to wait for '{command}': {error}"))?;
    exit_ok(command, status)
}

#[cfg(any(target_os = "macos", target_os = "linux", target_os = "windows"))]
fn exit_ok(command: &str, status: std::process::ExitStatus) -> Result<(), String> {
    status.success().then_some(()).ok_or_else(|| format!("'{command}' exited with status {status}"))
}