aoaoe 0.64.0 → 0.65.0

package/dist/index.js

@@ -235,6 +235,25 @@ async function main() {
     // start interactive input listener and conversation log
     input.start();
     await reasonerConsole.start();
+    // wire scroll keys to TUI (PgUp/PgDn/Home/End)
+    if (tui) {
+        input.onScroll((dir) => {
+            switch (dir) {
+                case "up":
+                    tui.scrollUp();
+                    break;
+                case "down":
+                    tui.scrollDown();
+                    break;
+                case "top":
+                    tui.scrollToTop();
+                    break;
+                case "bottom":
+                    tui.scrollToBottom();
+                    break;
+            }
+        });
+    }
     // start TUI (alternate screen buffer) after input is ready
     if (tui) {
         // replay persisted history from previous runs before entering alt screen

package/dist/input.d.ts

@@ -1,8 +1,11 @@
+export type ScrollDirection = "up" | "down" | "top" | "bottom";
 export declare class InputReader {
     private rl;
     private queue;
     private paused;
     private lastEscTime;
+    private scrollHandler;
+    onScroll(handler: (dir: ScrollDirection) => void): void;
     start(): void;
     drain(): string[];
     isPaused(): boolean;

package/dist/input.js

@@ -11,6 +11,11 @@ export class InputReader {
     queue = []; // pending user messages for the reasoner
     paused = false;
     lastEscTime = 0;
+    scrollHandler = null;
+    // register a callback for scroll key events (PgUp/PgDn/Home/End)
+    onScroll(handler) {
+        this.scrollHandler = handler;
+    }
     start() {
         // only works if stdin is a TTY (not piped)
         if (!process.stdin.isTTY)
@@ -39,6 +44,21 @@ export class InputReader {
             else {
                 this.lastEscTime = 0;
             }
+            // scroll key detection (PgUp, PgDn, Home, End)
+            if (this.scrollHandler) {
+                if (key?.name === "pageup" || key?.sequence === "\x1b[5~") {
+                    this.scrollHandler("up");
+                }
+                else if (key?.name === "pagedown" || key?.sequence === "\x1b[6~") {
+                    this.scrollHandler("down");
+                }
+                else if (key?.name === "home" || key?.sequence === "\x1b[1~") {
+                    this.scrollHandler("top");
+                }
+                else if (key?.name === "end" || key?.sequence === "\x1b[4~") {
+                    this.scrollHandler("bottom");
+                }
+            }
         });
         // show hint on startup
         console.error(`${DIM}type a message to talk to the AI supervisor, /help for commands, ESC ESC to interrupt${RESET}`);
@@ -105,6 +125,8 @@ ${BOLD}controls:${RESET}
   /resume            resume the supervisor
   /interrupt         interrupt the AI mid-thought
   ESC ESC            same as /interrupt (shortcut)
+  PgUp / PgDn        scroll through activity history
+  Home / End         jump to oldest / return to live
 
 ${BOLD}info:${RESET}
   /status            show daemon state

package/dist/tui.d.ts

@@ -20,6 +20,8 @@ export declare class TUI {
     private activityBuffer;
     private maxActivity;
     private spinnerFrame;
+    private scrollOffset;
+    private newWhileScrolled;
     private phase;
     private pollCount;
     private sessions;
@@ -40,6 +42,11 @@ export declare class TUI {
     }): void;
     log(tag: string, text: string): void;
     replayHistory(entries: HistoryEntry[]): void;
+    scrollUp(lines?: number): void;
+    scrollDown(lines?: number): void;
+    scrollToTop(): void;
+    scrollToBottom(): void;
+    isScrolledBack(): boolean;
     private updateDimensions;
     private computeLayout;
     private onResize;
@@ -63,5 +70,10 @@ declare function truncatePlain(str: string, max: number): string;
  * Kept for backward compatibility — used by non-TUI output paths.
  */
 export declare function formatSessionSentence(s: DaemonSessionState, maxCols: number): string;
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay };
+declare function computeScrollSlice(bufferLen: number, visibleLines: number, scrollOffset: number): {
+    start: number;
+    end: number;
+};
+declare function formatScrollIndicator(offset: number, totalEntries: number, visibleLines: number, newCount: number): string;
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -55,6 +55,8 @@ export class TUI {
     activityBuffer = []; // ring buffer for activity log
     maxActivity = 500; // max entries to keep
     spinnerFrame = 0; // current spinner animation frame
+    scrollOffset = 0; // 0 = live (bottom), >0 = scrolled back N entries
+    newWhileScrolled = 0; // entries added while user is scrolled back
     // current state for repaints
     phase = "sleeping";
     pollCount = 0;
@@ -139,8 +141,16 @@ export class TUI {
         if (this.activityBuffer.length > this.maxActivity) {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
         }
-        if (this.active)
-            this.writeActivityLine(entry);
+        if (this.active) {
+            if (this.scrollOffset > 0) {
+                // user is scrolled back — don't auto-scroll, just show indicator
+                this.newWhileScrolled++;
+                this.paintSeparator();
+            }
+            else {
+                this.writeActivityLine(entry);
+            }
+        }
         // persist to disk (fire-and-forget, never blocks)
         appendHistoryEntry({ ts: now.getTime(), time, tag, text });
     }
@@ -155,6 +165,48 @@ export class TUI {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
         }
     }
+    // ── Scroll navigation ────────────────────────────────────────────────────
+    scrollUp(lines) {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const maxOffset = Math.max(0, this.activityBuffer.length - visibleLines);
+        this.scrollOffset = Math.min(maxOffset, this.scrollOffset + n);
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollDown(lines) {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const wasScrolled = this.scrollOffset > 0;
+        this.scrollOffset = Math.max(0, this.scrollOffset - n);
+        if (wasScrolled && this.scrollOffset === 0)
+            this.newWhileScrolled = 0;
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollToTop() {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        this.scrollOffset = Math.max(0, this.activityBuffer.length - visibleLines);
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollToBottom() {
+        if (!this.active)
+            return;
+        this.scrollOffset = 0;
+        this.newWhileScrolled = 0;
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    isScrolledBack() {
+        return this.scrollOffset > 0;
+    }
     // ── Layout computation ──────────────────────────────────────────────────
     updateDimensions() {
         this.cols = process.stderr.columns || 80;
@@ -245,8 +297,14 @@ export class TUI {
         process.stderr.write(RESTORE_CURSOR);
     }
     paintSeparator() {
-        const hints = " esc esc: interrupt  /help  /explain  /pause ";
         const prefix = `${BOX.h}${BOX.h} activity `;
+        let hints;
+        if (this.scrollOffset > 0) {
+            hints = formatScrollIndicator(this.scrollOffset, this.activityBuffer.length, this.scrollBottom - this.scrollTop + 1, this.newWhileScrolled);
+        }
+        else {
+            hints = " esc esc: interrupt  /help  /explain  /pause ";
+        }
         const totalLen = prefix.length + hints.length;
         const fill = Math.max(0, this.cols - totalLen);
         const left = Math.floor(fill / 2);
@@ -265,7 +323,8 @@ export class TUI {
     }
     repaintActivityRegion() {
         const visibleLines = this.scrollBottom - this.scrollTop + 1;
-        const entries = this.activityBuffer.slice(-visibleLines);
+        const { start, end } = computeScrollSlice(this.activityBuffer.length, visibleLines, this.scrollOffset);
+        const entries = this.activityBuffer.slice(start, end);
         for (let i = 0; i < visibleLines; i++) {
             const row = this.scrollTop + i;
             if (i < entries.length) {
@@ -431,6 +490,19 @@ export function formatSessionSentence(s, maxCols) {
     }
     return truncateAnsi(`${dot} ${BOLD}${name}${RESET} ${tool} ${SLATE}—${RESET} ${statusDesc}`, maxCols);
 }
+// ── Scroll helpers (pure, exported for testing) ─────────────────────────────
+// compute the slice indices for the activity buffer given scroll state
+function computeScrollSlice(bufferLen, visibleLines, scrollOffset) {
+    const end = Math.max(0, bufferLen - scrollOffset);
+    const start = Math.max(0, end - visibleLines);
+    return { start, end };
+}
+// format the scroll indicator text for the separator bar
+function formatScrollIndicator(offset, totalEntries, visibleLines, newCount) {
+    const position = totalEntries - offset;
+    const newTag = newCount > 0 ? `  ${newCount} new ↓` : "";
+    return ` ↑ ${offset} older  │  ${position}/${totalEntries}  │  PgUp/PgDn  End=live${newTag} `;
+}
 // ── Exported pure helpers (for testing) ─────────────────────────────────────
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator };
 //# sourceMappingURL=tui.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aoaoe",
-  "version": "0.64.0",
+  "version": "0.65.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",