aoaoe 0.72.0 → 0.74.0

package/dist/index.js

@@ -256,19 +256,36 @@ async function main() {
     // 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;
+            if (tui.getViewMode() === "drilldown") {
+                // PgUp/PgDn/Home/End scroll the session output in drill-down mode
+                switch (dir) {
+                    case "up":
+                        tui.scrollDrilldownUp();
+                        break;
+                    case "down":
+                        tui.scrollDrilldownDown();
+                        break;
+                    case "bottom":
+                        tui.scrollDrilldownToBottom();
+                        break;
+                    // "top" not wired for drilldown — could add scrollDrilldownToTop() later
+                }
+            }
+            else {
+                switch (dir) {
+                    case "up":
+                        tui.scrollUp();
+                        break;
+                    case "down":
+                        tui.scrollDown();
+                        break;
+                    case "top":
+                        tui.scrollToTop();
+                        break;
+                    case "bottom":
+                        tui.scrollToBottom();
+                        break;
+                }
             }
         });
         // wire queue count changes to TUI prompt display
@@ -308,6 +325,31 @@ async function main() {
                     tui.log("system", `viewing session #${sessionIdx}`);
             }
         });
+        // wire /search command to TUI activity filter
+        input.onSearch((pattern) => {
+            tui.setSearch(pattern);
+            if (pattern) {
+                tui.log("system", `search: "${pattern}"`);
+            }
+            else {
+                tui.log("system", "search cleared");
+            }
+        });
+        // wire mouse wheel to scroll (3 lines per tick for smooth scrolling)
+        input.onMouseWheel((direction) => {
+            if (tui.getViewMode() === "drilldown") {
+                if (direction === "up")
+                    tui.scrollDrilldownUp(3);
+                else
+                    tui.scrollDrilldownDown(3);
+            }
+            else {
+                if (direction === "up")
+                    tui.scrollUp(3);
+                else
+                    tui.scrollDown(3);
+            }
+        });
     }
     // start TUI (alternate screen buffer) after input is ready
     if (tui) {

package/dist/input.d.ts

@@ -1,6 +1,7 @@
 export type ScrollDirection = "up" | "down" | "top" | "bottom";
 export declare const INSIST_PREFIX = "__INSIST__";
 export type ViewHandler = (target: string | null) => void;
+export type SearchHandler = (pattern: string | null) => void;
 export interface MouseEvent {
     button: number;
     col: number;
@@ -8,6 +9,7 @@ export interface MouseEvent {
     press: boolean;
 }
 export type MouseClickHandler = (row: number, col: number) => void;
+export type MouseWheelHandler = (direction: "up" | "down") => void;
 /** Parse an SGR extended mouse event from raw terminal data. Returns null if not a mouse event. */
 export declare function parseMouseEvent(data: string): MouseEvent | null;
 export declare class InputReader {
@@ -19,11 +21,15 @@ export declare class InputReader {
     private queueChangeHandler;
     private viewHandler;
     private mouseClickHandler;
+    private mouseWheelHandler;
+    private searchHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
     onView(handler: ViewHandler): void;
     onMouseClick(handler: MouseClickHandler): void;
+    onMouseWheel(handler: MouseWheelHandler): void;
+    onSearch(handler: SearchHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -30,6 +30,8 @@ export class InputReader {
     queueChangeHandler = null;
     viewHandler = null;
     mouseClickHandler = null;
+    mouseWheelHandler = null;
+    searchHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -47,6 +49,14 @@ export class InputReader {
     onMouseClick(handler) {
         this.mouseClickHandler = handler;
     }
+    // register a callback for mouse wheel events (scroll up/down)
+    onMouseWheel(handler) {
+        this.mouseWheelHandler = handler;
+    }
+    // register a callback for search commands (/search <pattern> or /search to clear)
+    onSearch(handler) {
+        this.searchHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -68,9 +78,19 @@ export class InputReader {
         this.mouseDataListener = (data) => {
             const str = data.toString("utf8");
             const evt = parseMouseEvent(str);
-            if (evt && evt.press && evt.button === 0 && this.mouseClickHandler) {
+            if (!evt)
+                return;
+            // left click press
+            if (evt.press && evt.button === 0 && this.mouseClickHandler) {
                 this.mouseClickHandler(evt.row, evt.col);
             }
+            // mouse wheel: button 64 = scroll up, 65 = scroll down
+            if (evt.button === 64 && this.mouseWheelHandler) {
+                this.mouseWheelHandler("up");
+            }
+            else if (evt.button === 65 && this.mouseWheelHandler) {
+                this.mouseWheelHandler("down");
+            }
         };
         process.stdin.on("data", this.mouseDataListener);
         process.stdin.on("keypress", (_ch, key) => {
@@ -200,8 +220,11 @@ ${BOLD}controls:${RESET}
 ${BOLD}navigation:${RESET}
   /view [N|name]     drill into a session's live output (default: 1)
   /back              return to overview from drill-down
+  /search <pattern>  filter activity entries by substring (case-insensitive)
+  /search            clear active search filter
   click session      click an agent card to drill down (click again to go back)
-  PgUp / PgDn        scroll through activity history
+  mouse wheel        scroll activity (overview) or session output (drill-down)
+  PgUp / PgDn        scroll through activity or session output
   Home / End         jump to oldest / return to live
 
 ${BOLD}info:${RESET}
@@ -276,6 +299,16 @@ ${BOLD}other:${RESET}
                     console.error(`${DIM}already in overview${RESET}`);
                 }
                 break;
+            case "/search": {
+                const searchArg = line.slice("/search".length).trim();
+                if (this.searchHandler) {
+                    this.searchHandler(searchArg || null); // empty = clear search
+                }
+                else {
+                    console.error(`${DIM}search not available (no TUI)${RESET}`);
+                }
+                break;
+            }
             case "/clear":
                 process.stderr.write("\x1b[2J\x1b[H");
                 break;

package/dist/tui.d.ts

@@ -23,9 +23,12 @@ export declare class TUI {
     private scrollOffset;
     private newWhileScrolled;
     private pendingCount;
+    private searchPattern;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
+    private drilldownScrollOffset;
+    private drilldownNewWhileScrolled;
     private phase;
     private pollCount;
     private sessions;
@@ -54,6 +57,10 @@ export declare class TUI {
     scrollToTop(): void;
     scrollToBottom(): void;
     isScrolledBack(): boolean;
+    scrollDrilldownUp(lines?: number): void;
+    scrollDrilldownDown(lines?: number): void;
+    scrollDrilldownToBottom(): void;
+    isDrilldownScrolledBack(): boolean;
     /** Store full session outputs (called each tick from main loop) */
     setSessionOutputs(outputs: Map<string, string>): void;
     /** Enter drill-down view for a session. Returns false if session not found. */
@@ -64,6 +71,10 @@ export declare class TUI {
     getViewMode(): "overview" | "drilldown";
     /** Get drill-down session ID (or null) */
     getDrilldownSessionId(): string | null;
+    /** Set or clear the search filter. Resets scroll and repaints. */
+    setSearch(pattern: string | null): void;
+    /** Get the current search pattern (or null if no active search). */
+    getSearchPattern(): string | null;
     private updateDimensions;
     private computeLayout;
     private onResize;
@@ -96,6 +107,11 @@ declare function computeScrollSlice(bufferLen: number, visibleLines: number, scr
     end: number;
 };
 declare function formatScrollIndicator(offset: number, totalEntries: number, visibleLines: number, newCount: number): string;
+declare function formatDrilldownScrollIndicator(offset: number, totalLines: number, visibleLines: number, newCount: number): string;
+/** Case-insensitive substring match against an activity entry's tag, text, and time. */
+declare function matchesSearch(entry: ActivityEntry, pattern: string): boolean;
+/** Format the search indicator text for the separator bar. */
+declare function formatSearchIndicator(pattern: string, matchCount: number, totalCount: number): string;
 /**
  * Hit-test a mouse click row against the session panel.
  * Returns 1-indexed session number if the click hit a session card, null otherwise.
@@ -104,5 +120,5 @@ declare function formatScrollIndicator(offset: number, totalEntries: number, vis
  * (row = headerHeight + 2 + i for 0-indexed session i)
  */
 export declare function hitTestSession(row: number, headerHeight: number, sessionCount: number): number | null;
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatPrompt, formatDrilldownHeader };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -61,10 +61,13 @@ export class TUI {
     scrollOffset = 0; // 0 = live (bottom), >0 = scrolled back N entries
     newWhileScrolled = 0; // entries added while user is scrolled back
     pendingCount = 0; // queued user messages awaiting next tick
+    searchPattern = null; // active search filter pattern
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
     sessionOutputs = new Map(); // full output lines per session
+    drilldownScrollOffset = 0; // 0 = live (tail), >0 = scrolled back N lines
+    drilldownNewWhileScrolled = 0; // lines added while scrolled back
     // current state for repaints
     phase = "sleeping";
     pollCount = 0;
@@ -156,7 +159,20 @@ export class TUI {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
         }
         if (this.active) {
-            if (this.scrollOffset > 0) {
+            if (this.searchPattern) {
+                // search active: only show new entry if it matches
+                if (matchesSearch(entry, this.searchPattern)) {
+                    if (this.scrollOffset > 0) {
+                        this.newWhileScrolled++;
+                        this.paintSeparator();
+                    }
+                    else {
+                        this.writeActivityLine(entry);
+                    }
+                }
+                // non-matching entries are silently buffered — visible when search is cleared
+            }
+            else if (this.scrollOffset > 0) {
                 // user is scrolled back — don't auto-scroll, just show indicator
                 this.newWhileScrolled++;
                 this.paintSeparator();
@@ -185,7 +201,10 @@ export class TUI {
             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);
+        const entryCount = this.searchPattern
+            ? this.activityBuffer.filter((e) => matchesSearch(e, this.searchPattern)).length
+            : this.activityBuffer.length;
+        const maxOffset = Math.max(0, entryCount - visibleLines);
         this.scrollOffset = Math.min(maxOffset, this.scrollOffset + n);
         this.repaintActivityRegion();
         this.paintSeparator();
@@ -206,7 +225,10 @@ export class TUI {
         if (!this.active)
             return;
         const visibleLines = this.scrollBottom - this.scrollTop + 1;
-        this.scrollOffset = Math.max(0, this.activityBuffer.length - visibleLines);
+        const entryCount = this.searchPattern
+            ? this.activityBuffer.filter((e) => matchesSearch(e, this.searchPattern)).length
+            : this.activityBuffer.length;
+        this.scrollOffset = Math.max(0, entryCount - visibleLines);
         this.repaintActivityRegion();
         this.paintSeparator();
     }
@@ -221,15 +243,58 @@ export class TUI {
     isScrolledBack() {
         return this.scrollOffset > 0;
     }
+    // ── Drill-down scroll ─────────────────────────────────────────────────
+    scrollDrilldownUp(lines) {
+        if (!this.active || this.viewMode !== "drilldown" || !this.drilldownSessionId)
+            return;
+        const outputLines = this.sessionOutputs.get(this.drilldownSessionId) ?? [];
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const maxOffset = Math.max(0, outputLines.length - visibleLines);
+        this.drilldownScrollOffset = Math.min(maxOffset, this.drilldownScrollOffset + n);
+        this.repaintDrilldownContent();
+        this.paintDrilldownSeparator();
+    }
+    scrollDrilldownDown(lines) {
+        if (!this.active || this.viewMode !== "drilldown")
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const wasScrolled = this.drilldownScrollOffset > 0;
+        this.drilldownScrollOffset = Math.max(0, this.drilldownScrollOffset - n);
+        if (wasScrolled && this.drilldownScrollOffset === 0)
+            this.drilldownNewWhileScrolled = 0;
+        this.repaintDrilldownContent();
+        this.paintDrilldownSeparator();
+    }
+    scrollDrilldownToBottom() {
+        if (!this.active || this.viewMode !== "drilldown")
+            return;
+        this.drilldownScrollOffset = 0;
+        this.drilldownNewWhileScrolled = 0;
+        this.repaintDrilldownContent();
+        this.paintDrilldownSeparator();
+    }
+    isDrilldownScrolledBack() {
+        return this.drilldownScrollOffset > 0;
+    }
     // ── Drill-down mode ────────────────────────────────────────────────────
     /** Store full session outputs (called each tick from main loop) */
     setSessionOutputs(outputs) {
         for (const [id, text] of outputs) {
-            this.sessionOutputs.set(id, text.split("\n"));
+            const prevLen = this.sessionOutputs.get(id)?.length ?? 0;
+            const lines = text.split("\n");
+            this.sessionOutputs.set(id, lines);
+            // track new lines while scrolled back in drill-down
+            if (this.viewMode === "drilldown" && this.drilldownSessionId === id && this.drilldownScrollOffset > 0) {
+                const newLines = Math.max(0, lines.length - prevLen);
+                this.drilldownNewWhileScrolled += newLines;
+            }
         }
         // repaint drill-down view if we're watching this session
         if (this.active && this.viewMode === "drilldown" && this.drilldownSessionId) {
             this.repaintDrilldownContent();
+            this.paintDrilldownSeparator();
         }
     }
     /** Enter drill-down view for a session. Returns false if session not found. */
@@ -251,6 +316,8 @@ export class TUI {
             return false;
         this.viewMode = "drilldown";
         this.drilldownSessionId = sessionId;
+        this.drilldownScrollOffset = 0;
+        this.drilldownNewWhileScrolled = 0;
         if (this.active) {
             this.computeLayout(this.sessions.length);
             this.paintAll();
@@ -263,6 +330,8 @@ export class TUI {
             return;
         this.viewMode = "overview";
         this.drilldownSessionId = null;
+        this.drilldownScrollOffset = 0;
+        this.drilldownNewWhileScrolled = 0;
         if (this.active) {
             this.computeLayout(this.sessions.length);
             this.paintAll();
@@ -276,6 +345,21 @@ export class TUI {
     getDrilldownSessionId() {
         return this.drilldownSessionId;
     }
+    // ── Search ──────────────────────────────────────────────────────────────
+    /** Set or clear the search filter. Resets scroll and repaints. */
+    setSearch(pattern) {
+        this.searchPattern = pattern && pattern.length > 0 ? pattern : null;
+        this.scrollOffset = 0;
+        this.newWhileScrolled = 0;
+        if (this.active && this.viewMode === "overview") {
+            this.repaintActivityRegion();
+            this.paintSeparator();
+        }
+    }
+    /** Get the current search pattern (or null if no active search). */
+    getSearchPattern() {
+        return this.searchPattern;
+    }
     // ── Layout computation ──────────────────────────────────────────────────
     updateDimensions() {
         this.cols = process.stderr.columns || 80;
@@ -386,7 +470,11 @@ export class TUI {
     paintSeparator() {
         const prefix = `${BOX.h}${BOX.h} activity `;
         let hints;
-        if (this.scrollOffset > 0) {
+        if (this.searchPattern) {
+            const filtered = this.activityBuffer.filter((e) => matchesSearch(e, this.searchPattern));
+            hints = formatSearchIndicator(this.searchPattern, filtered.length, this.activityBuffer.length);
+        }
+        else if (this.scrollOffset > 0) {
             hints = formatScrollIndicator(this.scrollOffset, this.activityBuffer.length, this.scrollBottom - this.scrollTop + 1, this.newWhileScrolled);
         }
         else {
@@ -410,8 +498,12 @@ export class TUI {
     }
     repaintActivityRegion() {
         const visibleLines = this.scrollBottom - this.scrollTop + 1;
-        const { start, end } = computeScrollSlice(this.activityBuffer.length, visibleLines, this.scrollOffset);
-        const entries = this.activityBuffer.slice(start, end);
+        // when search is active, filter entries first, then paginate
+        const source = this.searchPattern
+            ? this.activityBuffer.filter((e) => matchesSearch(e, this.searchPattern))
+            : this.activityBuffer;
+        const { start, end } = computeScrollSlice(source.length, visibleLines, this.scrollOffset);
+        const entries = source.slice(start, end);
         for (let i = 0; i < visibleLines; i++) {
             const row = this.scrollTop + i;
             if (i < entries.length) {
@@ -428,7 +520,15 @@ export class TUI {
         const session = this.sessions.find((s) => s.id === this.drilldownSessionId);
         const title = session ? session.title : this.drilldownSessionId ?? "?";
         const prefix = `${BOX.h}${BOX.h} ${title} `;
-        const hints = " /back: overview  /view N: switch session ";
+        let hints;
+        if (this.drilldownScrollOffset > 0) {
+            const outputLines = this.sessionOutputs.get(this.drilldownSessionId ?? "") ?? [];
+            const visibleLines = this.scrollBottom - this.scrollTop + 1;
+            hints = formatDrilldownScrollIndicator(this.drilldownScrollOffset, outputLines.length, visibleLines, this.drilldownNewWhileScrolled);
+        }
+        else {
+            hints = " click or /back: overview  scroll: navigate  /view N: switch ";
+        }
         const totalLen = prefix.length + hints.length;
         const fill = Math.max(0, this.cols - totalLen);
         const left = Math.floor(fill / 2);
@@ -441,9 +541,9 @@ export class TUI {
             return;
         const outputLines = this.sessionOutputs.get(this.drilldownSessionId) ?? [];
         const visibleLines = this.scrollBottom - this.scrollTop + 1;
-        // show the last N lines (tail view, like following output)
-        const startIdx = Math.max(0, outputLines.length - visibleLines);
-        const visible = outputLines.slice(startIdx);
+        // use scroll offset: 0 = tail (live), >0 = scrolled back
+        const { start, end } = computeScrollSlice(outputLines.length, visibleLines, this.drilldownScrollOffset);
+        const visible = outputLines.slice(start, end);
         for (let i = 0; i < visibleLines; i++) {
             const row = this.scrollTop + i;
             if (i < visible.length) {
@@ -646,6 +746,26 @@ function formatScrollIndicator(offset, totalEntries, visibleLines, newCount) {
     const newTag = newCount > 0 ? `  ${newCount} new ↓` : "";
     return ` ↑ ${offset} older  │  ${position}/${totalEntries}  │  PgUp/PgDn  End=live${newTag} `;
 }
+// format the scroll indicator for drill-down separator bar
+function formatDrilldownScrollIndicator(offset, totalLines, visibleLines, newCount) {
+    const position = totalLines - offset;
+    const newTag = newCount > 0 ? `  ${newCount} new ↓` : "";
+    return ` ↑ ${offset} lines  │  ${position}/${totalLines}  │  scroll: navigate  End=live${newTag} `;
+}
+// ── Search helpers (pure, exported for testing) ─────────────────────────────
+/** Case-insensitive substring match against an activity entry's tag, text, and time. */
+function matchesSearch(entry, pattern) {
+    if (!pattern)
+        return true;
+    const lower = pattern.toLowerCase();
+    return (entry.tag.toLowerCase().includes(lower) ||
+        entry.text.toLowerCase().includes(lower) ||
+        entry.time.toLowerCase().includes(lower));
+}
+/** Format the search indicator text for the separator bar. */
+function formatSearchIndicator(pattern, matchCount, totalCount) {
+    return ` search: "${pattern}"  │  ${matchCount} of ${totalCount}  │  /search: clear `;
+}
 // ── Mouse hit testing (pure, exported for testing) ──────────────────────────
 /**
  * Hit-test a mouse click row against the session panel.
@@ -664,5 +784,5 @@ export function hitTestSession(row, headerHeight, sessionCount) {
     return row - firstSessionRow + 1; // 1-indexed
 }
 // ── Exported pure helpers (for testing) ─────────────────────────────────────
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatPrompt, formatDrilldownHeader };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator };
 //# sourceMappingURL=tui.js.map

package/package.json

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