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

use crate::view::markdown::render_markdown;
use crate::view::syntax::SyntaxHighlighter;
use crate::theme::Theme;
use crate::view::wrap::wrap_text;
use ratatui::style::Style;
use ratatui::text::{Line, Span};
use unicode_width::UnicodeWidthStr;

use super::tool_view::tool_lines;
use super::{ConversationContent, ConversationItem};

/// Which of the four transcript content kinds an item holds, driving the blank
/// line inserted between runs of different kinds.
#[derive(Clone, Copy, PartialEq, Eq)]
pub(crate) enum ContentKind {
    User,
    Assistant,
    Tool,
    Notice,
}

/// One item's rendered rows, whatever it holds.
pub(crate) fn item_lines(
    item: &ConversationItem,
    width: u16,
    padding: usize,
    spinner_tick: usize,
    theme: &Theme,
    highlighter: &mut SyntaxHighlighter,
) -> Vec<Line<'static>> {
    let content_width = content_width(width, padding);
    match item.content() {
        ConversationContent::User(text) => user_block_lines(&text.text, width, padding, theme),
        ConversationContent::Assistant(text) => {
            indent_lines(render_markdown(&text.text, content_width, theme, highlighter), padding)
        }
        ConversationContent::Notice(notice) => user_block_lines(&notice.text, width, padding, theme),
        ConversationContent::Tool(tool) => tool_lines(tool, content_width, padding, spinner_tick, theme, highlighter),
    }
}

pub(crate) fn content_kind(item: &ConversationItem) -> ContentKind {
    match item.content() {
        ConversationContent::User(_) => ContentKind::User,
        ConversationContent::Assistant(_) => ContentKind::Assistant,
        ConversationContent::Tool(_) => ContentKind::Tool,
        ConversationContent::Notice(_) => ContentKind::Notice,
    }
}

/// Width left for content once the gutter is taken from both sides.
pub(crate) fn content_width(width: u16, padding: usize) -> u16 {
    width.saturating_sub(u16::try_from(padding.saturating_mul(2)).unwrap_or(u16::MAX)).max(1)
}

/// Prepends the content gutter to every row.
pub(crate) fn indent_lines(lines: Vec<Line<'static>>, padding: usize) -> Vec<Line<'static>> {
    let prefix = " ".repeat(padding);
    lines
        .into_iter()
        .map(|mut line| {
            line.spans.insert(0, Span::raw(prefix.clone()));
            line
        })
        .collect()
}

/// The user's own message, drawn as a full-width tinted block.
fn user_block_lines(text: &str, width: u16, padding: usize, theme: &Theme) -> Vec<Line<'static>> {
    let block_style = Style::new().bg(theme.sidebar_bg).fg(theme.text_primary);
    let width = usize::from(width);
    let content_width = width.saturating_sub(padding.saturating_mul(2)).max(1);
    let blank = Line::styled(" ".repeat(width), block_style);
    let mut lines = vec![blank.clone()];
    for wrapped in wrap_text(text.trim_end_matches('\n'), content_width) {
        let fill = width.saturating_sub(padding + wrapped.width());
        lines.push(Line::styled(format!("{}{wrapped}{}", " ".repeat(padding), " ".repeat(fill)), block_style));
    }
    lines.push(blank);
    lines
}