terminal-use 1.1.0

Headless virtual terminal for AI agents
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

use crate::daemon::protocol::CursorPos;

/// Format a plain text screenshot for human display.
///
/// `mouse_cursor` (when set) is reported as a trailer line *below* the body —
/// the body itself stays byte-identical to what the inner app drew so regex /
/// grep over `content` always matches the application's output, never tu's
/// synthetic overlay.
pub fn format_screenshot(
    content: &str,
    _rows: u16,
    _cols: u16,
    _cursor_row: u16,
    _cursor_col: u16,
    mouse_cursor: Option<CursorPos>,
    mouse_held: bool,
) -> String {
    match mouse_cursor {
        None => content.to_string(),
        Some(pos) => {
            let glyph = if mouse_held { "▲" } else { "△" };
            let label = if mouse_held { "held " } else { "" };
            format!(
                "{content}\n\n{glyph} tu mouse cursor {label}at ({col},{row})",
                col = pos.col,
                row = pos.row
            )
        }
    }
}

/// Format a screenshot as JSON.
pub fn format_screenshot_json(
    content: &str,
    rows: u16,
    cols: u16,
    cursor_row: u16,
    cursor_col: u16,
    mouse_cursor: Option<CursorPos>,
    mouse_held: bool,
) -> serde_json::Value {
    serde_json::json!({
        "type": "screenshot",
        "format": "text",
        "content": content,
        "rows": rows,
        "cols": cols,
        "cursor": {
            "row": cursor_row,
            "col": cursor_col,
        },
        "mouse_cursor": mouse_cursor.map(|p| serde_json::json!({"col": p.col, "row": p.row})),
        "mouse_held": mouse_held,
    })
}