codetether-agent 4.7.0-a-002.4

A2A-native AI coding agent for the CodeTether ecosystem
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

//! Chat and tool-preview scroll methods.
//!
//! Sentinel scheme: `chat_scroll >= 1_000_000` ("follow latest") is clamped
//! to `chat_last_max_scroll` at render time. `tool_preview_scroll` mirrors
//! the same scheme via [`TOOL_PREVIEW_FOLLOW`] so the tool panel auto-follows
//! the most recent activity until the user manually scrolls up.

/// Sentinel: tool panel auto-follows (scrolls to bottom of latest activity).
pub const TOOL_PREVIEW_FOLLOW: usize = 1_000_000;

impl super::AppState {
    pub fn scroll_up(&mut self, amount: usize) {
        // Manual scroll-up disengages auto-follow so streaming output
        // stops yanking the user back to the bottom of the chat.
        self.chat_auto_follow = false;
        let base = if self.chat_scroll >= 1_000_000 {
            self.chat_last_max_scroll
        } else {
            self.chat_scroll
        };
        self.chat_scroll = base.saturating_sub(amount);
    }

    pub fn scroll_down(&mut self, amount: usize) {
        if self.chat_scroll >= 1_000_000 {
            return;
        }
        let next = self.chat_scroll.saturating_add(amount);
        if next >= self.chat_last_max_scroll {
            self.scroll_to_bottom();
        } else {
            self.chat_scroll = next;
        }
    }

    /// Set sentinel value — clamped to actual content height at render time.
    /// Re-engages [`AppState::chat_auto_follow`] so subsequent session events
    /// keep the user pinned to the latest output.
    pub fn scroll_to_bottom(&mut self) {
        self.chat_scroll = 1_000_000;
        self.chat_auto_follow = true;
    }

    pub fn scroll_to_top(&mut self) {
        self.chat_scroll = 0;
    }

    pub fn set_chat_max_scroll(&mut self, max_scroll: usize) {
        self.chat_last_max_scroll = max_scroll;
        if max_scroll == 0 {
            self.chat_scroll = 0;
        } else if self.chat_scroll < 1_000_000 {
            self.chat_scroll = self.chat_scroll.min(max_scroll);
        }
    }

    pub fn scroll_tool_preview_up(&mut self, amount: usize) {
        // Manual scroll cancels auto-follow.
        let base = if self.tool_preview_scroll >= TOOL_PREVIEW_FOLLOW {
            self.tool_preview_last_max_scroll
        } else {
            self.tool_preview_scroll
        };
        self.tool_preview_scroll = base.saturating_sub(amount);
    }

    pub fn scroll_tool_preview_down(&mut self, amount: usize) {
        if self.tool_preview_scroll >= TOOL_PREVIEW_FOLLOW {
            return;
        }
        let next = self.tool_preview_scroll.saturating_add(amount);
        // Re-enable auto-follow when hitting bottom.
        self.tool_preview_scroll = if next >= self.tool_preview_last_max_scroll {
            TOOL_PREVIEW_FOLLOW
        } else {
            next
        };
    }

    pub fn reset_tool_preview_scroll(&mut self) {
        self.tool_preview_scroll = TOOL_PREVIEW_FOLLOW;
    }

    pub fn set_tool_preview_max_scroll(&mut self, max_scroll: usize) {
        self.tool_preview_last_max_scroll = max_scroll;
        self.tool_preview_scroll = if self.tool_preview_scroll >= TOOL_PREVIEW_FOLLOW {
            max_scroll
        } else {
            self.tool_preview_scroll.min(max_scroll)
        };
    }
}