aoaoe 0.80.0 → 0.82.0

package/dist/index.js

@@ -378,6 +378,18 @@ async function main() {
             tui.setCompact(enabled);
             tui.log("system", `compact mode: ${enabled ? "on" : "off"}`);
         });
+        // wire /focus toggle
+        input.onFocus(() => {
+            const enabled = !tui.isFocused();
+            tui.setFocus(enabled);
+            tui.log("system", `focus mode: ${enabled ? "on (pinned only)" : "off (all sessions)"}`);
+        });
+        // wire /bell toggle
+        input.onBell(() => {
+            const enabled = !tui.isBellEnabled();
+            tui.setBell(enabled);
+            tui.log("system", `bell notifications: ${enabled ? "on" : "off"}`);
+        });
         // wire /pin toggle
         input.onPin((target) => {
             const num = /^\d+$/.test(target) ? parseInt(target, 10) : undefined;

package/dist/input.d.ts

@@ -6,6 +6,8 @@ export type QuickSwitchHandler = (sessionNum: number) => void;
 export type SortHandler = (mode: string | null) => void;
 export type CompactHandler = () => void;
 export type PinHandler = (target: string) => void;
+export type BellHandler = () => void;
+export type FocusHandler = () => void;
 export interface MouseEvent {
     button: number;
     col: number;
@@ -34,6 +36,8 @@ export declare class InputReader {
     private sortHandler;
     private compactHandler;
     private pinHandler;
+    private bellHandler;
+    private focusHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -46,6 +50,8 @@ export declare class InputReader {
     onSort(handler: SortHandler): void;
     onCompact(handler: CompactHandler): void;
     onPin(handler: PinHandler): void;
+    onBell(handler: BellHandler): void;
+    onFocus(handler: FocusHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -38,6 +38,8 @@ export class InputReader {
     sortHandler = null;
     compactHandler = null;
     pinHandler = null;
+    bellHandler = null;
+    focusHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -83,6 +85,14 @@ export class InputReader {
     onPin(handler) {
         this.pinHandler = handler;
     }
+    // register a callback for bell toggle (/bell)
+    onBell(handler) {
+        this.bellHandler = handler;
+    }
+    // register a callback for focus mode toggle (/focus)
+    onFocus(handler) {
+        this.focusHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -263,6 +273,8 @@ ${BOLD}navigation:${RESET}
   /sort [mode]       sort sessions: status, name, activity, default (or cycle)
   /compact           toggle compact mode (dense session panel)
   /pin [N|name]      pin/unpin a session to the top (toggle)
+  /bell              toggle terminal bell on errors/completions
+  /focus             toggle focus mode (show only pinned sessions)
   /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)
@@ -375,6 +387,22 @@ ${BOLD}other:${RESET}
                 }
                 break;
             }
+            case "/bell":
+                if (this.bellHandler) {
+                    this.bellHandler();
+                }
+                else {
+                    console.error(`${DIM}bell not available (no TUI)${RESET}`);
+                }
+                break;
+            case "/focus":
+                if (this.focusHandler) {
+                    this.focusHandler();
+                }
+                else {
+                    console.error(`${DIM}focus not available (no TUI)${RESET}`);
+                }
+                break;
             case "/search": {
                 const searchArg = line.slice("/search".length).trim();
                 if (this.searchHandler) {

package/dist/tui.d.ts

@@ -6,6 +6,10 @@ declare const SORT_MODES: SortMode[];
 declare function sortSessions(sessions: DaemonSessionState[], mode: SortMode, lastChangeAt?: Map<string, number>, pinnedIds?: Set<string>): DaemonSessionState[];
 /** Cycle to the next sort mode. */
 declare function nextSortMode(current: SortMode): SortMode;
+/** Cooldown between terminal bells to avoid buzzing. */
+export declare const BELL_COOLDOWN_MS = 5000;
+/** Determine if an activity entry should trigger a terminal bell. High-signal events only. */
+export declare function shouldBell(tag: string, text: string): boolean;
 /** Max name length in compact token. */
 declare const COMPACT_NAME_LEN = 10;
 /** Pin indicator for pinned sessions. */
@@ -49,6 +53,9 @@ export declare class TUI {
     private prevLastActivity;
     private compactMode;
     private pinnedIds;
+    private focusMode;
+    private bellEnabled;
+    private lastBellAt;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -64,7 +71,7 @@ export declare class TUI {
     start(version: string): void;
     stop(): void;
     isActive(): boolean;
-    /** Return the current number of sessions (for mouse hit testing) */
+    /** Return the current number of visible sessions (for mouse hit testing) */
     getSessionCount(): number;
     /** Set the session sort mode and repaint. */
     setSortMode(mode: SortMode): void;
@@ -83,6 +90,16 @@ export declare class TUI {
     isPinned(id: string): boolean;
     /** Return count of pinned sessions. */
     getPinnedCount(): number;
+    /** Enable or disable focus mode. When focused, only pinned sessions are visible. */
+    setFocus(enabled: boolean): void;
+    /** Return whether focus mode is enabled. */
+    isFocused(): boolean;
+    /** Return count of visible sessions (all in normal mode, pinned-only in focus mode). */
+    private getVisibleCount;
+    /** Enable or disable terminal bell notifications. */
+    setBell(enabled: boolean): void;
+    /** Return whether terminal bell is enabled. */
+    isBellEnabled(): boolean;
     updateState(opts: {
         phase?: DaemonPhase;
         pollCount?: number;

package/dist/tui.js

@@ -52,6 +52,17 @@ function nextSortMode(current) {
     const idx = SORT_MODES.indexOf(current);
     return SORT_MODES[(idx + 1) % SORT_MODES.length];
 }
+// ── Bell notifications ──────────────────────────────────────────────────────
+/** Cooldown between terminal bells to avoid buzzing. */
+export const BELL_COOLDOWN_MS = 5000;
+/** Determine if an activity entry should trigger a terminal bell. High-signal events only. */
+export function shouldBell(tag, text) {
+    if (tag === "! action" || tag === "error")
+        return true;
+    if (tag === "+ action" && text.toLowerCase().includes("complete"))
+        return true;
+    return false;
+}
 // ── Compact mode ────────────────────────────────────────────────────────────
 /** Max name length in compact token. */
 const COMPACT_NAME_LEN = 10;
@@ -150,6 +161,9 @@ export class TUI {
     prevLastActivity = new Map(); // session ID → previous lastActivity string
     compactMode = false;
     pinnedIds = new Set(); // pinned session IDs (always sort to top)
+    focusMode = false; // focus mode: hide all sessions except pinned
+    bellEnabled = false;
+    lastBellAt = 0;
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -202,9 +216,9 @@ export class TUI {
     isActive() {
         return this.active;
     }
-    /** Return the current number of sessions (for mouse hit testing) */
+    /** Return the current number of visible sessions (for mouse hit testing) */
     getSessionCount() {
-        return this.sessions.length;
+        return this.getVisibleCount();
     }
     /** Set the session sort mode and repaint. */
     setSortMode(mode) {
@@ -227,7 +241,7 @@ export class TUI {
             return;
         this.compactMode = enabled;
         if (this.active) {
-            this.computeLayout(this.sessions.length);
+            this.computeLayout(this.getVisibleCount());
             this.paintAll();
         }
     }
@@ -272,6 +286,39 @@ export class TUI {
     getPinnedCount() {
         return this.pinnedIds.size;
     }
+    /** Enable or disable focus mode. When focused, only pinned sessions are visible. */
+    setFocus(enabled) {
+        if (enabled === this.focusMode)
+            return;
+        this.focusMode = enabled;
+        if (this.active) {
+            this.computeLayout(this.getVisibleCount());
+            this.paintAll();
+        }
+    }
+    /** Return whether focus mode is enabled. */
+    isFocused() {
+        return this.focusMode;
+    }
+    /** Return count of visible sessions (all in normal mode, pinned-only in focus mode). */
+    getVisibleCount() {
+        if (!this.focusMode)
+            return this.sessions.length;
+        let count = 0;
+        for (const s of this.sessions) {
+            if (this.pinnedIds.has(s.id))
+                count++;
+        }
+        return count;
+    }
+    /** Enable or disable terminal bell notifications. */
+    setBell(enabled) {
+        this.bellEnabled = enabled;
+    }
+    /** Return whether terminal bell is enabled. */
+    isBellEnabled() {
+        return this.bellEnabled;
+    }
     // ── State updates ───────────────────────────────────────────────────────
     updateState(opts) {
         if (opts.phase !== undefined)
@@ -298,10 +345,11 @@ export class TUI {
                     this.prevLastActivity.set(s.id, s.lastActivity);
             }
             const sorted = sortSessions(opts.sessions, this.sortMode, this.lastChangeAt, this.pinnedIds);
-            const sessionCountChanged = sorted.length !== this.sessions.length;
+            const prevVisibleCount = this.getVisibleCount();
             this.sessions = sorted;
-            if (sessionCountChanged) {
-                this.computeLayout(this.sessions.length);
+            const newVisibleCount = this.getVisibleCount();
+            if (newVisibleCount !== prevVisibleCount) {
+                this.computeLayout(newVisibleCount);
                 this.paintAll();
                 return;
             }
@@ -325,6 +373,14 @@ export class TUI {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
             this.activityTimestamps = this.activityTimestamps.slice(-this.maxActivity);
         }
+        // terminal bell for high-signal events (with cooldown)
+        if (this.bellEnabled && shouldBell(tag, text)) {
+            const nowMs = now.getTime();
+            if (nowMs - this.lastBellAt >= BELL_COOLDOWN_MS) {
+                this.lastBellAt = nowMs;
+                process.stderr.write("\x07");
+            }
+        }
         if (this.active) {
             if (this.searchPattern) {
                 // search active: only show new entry if it matches
@@ -487,7 +543,7 @@ export class TUI {
         this.drilldownNewWhileScrolled = 0;
         this.hoverSessionIdx = null;
         if (this.active) {
-            this.computeLayout(this.sessions.length);
+            this.computeLayout(this.getVisibleCount());
             this.paintAll();
         }
         return true;
@@ -502,7 +558,7 @@ export class TUI {
         this.drilldownNewWhileScrolled = 0;
         this.hoverSessionIdx = null;
         if (this.active) {
-            this.computeLayout(this.sessions.length);
+            this.computeLayout(this.getVisibleCount());
             this.paintAll();
         }
     }
@@ -565,8 +621,9 @@ export class TUI {
         }
         else {
             // overview: header (1) + sessions box + separator + activity + input
+            const visibleSessions = this.sessions.slice(0, this.getVisibleCount());
             const sessBodyRows = this.compactMode
-                ? computeCompactRowCount(this.sessions, this.cols - 2)
+                ? computeCompactRowCount(visibleSessions, this.cols - 2)
                 : Math.max(sessionCount, 1);
             this.sessionRows = sessBodyRows + 2; // + top/bottom borders
             this.separatorRow = this.headerHeight + this.sessionRows + 1;
@@ -579,7 +636,7 @@ export class TUI {
         }
     }
     onResize() {
-        this.computeLayout(this.sessions.length);
+        this.computeLayout(this.getVisibleCount());
         this.paintAll();
     }
     // ── Painting ────────────────────────────────────────────────────────────
@@ -607,7 +664,10 @@ export class TUI {
         }
         else {
             const phaseText = phaseDisplay(this.phase, this.paused, this.spinnerFrame);
-            const sessCount = `${this.sessions.length} agent${this.sessions.length !== 1 ? "s" : ""}`;
+            const visCount = this.getVisibleCount();
+            const sessCount = this.focusMode
+                ? `${visCount}/${this.sessions.length} agent${this.sessions.length !== 1 ? "s" : ""}`
+                : `${this.sessions.length} agent${this.sessions.length !== 1 ? "s" : ""}`;
             const activeCount = this.sessions.filter((s) => s.userActive).length;
             const activeTag = activeCount > 0 ? `  ${SLATE}│${RESET}  ${AMBER}${activeCount} user${RESET}` : "";
             // countdown to next tick (only in sleeping phase)
@@ -627,23 +687,29 @@ export class TUI {
     paintSessions() {
         const startRow = this.headerHeight + 1;
         const innerWidth = this.cols - 2; // inside the box borders
-        // top border with label (includes compact/sort mode tags)
+        const visibleCount = this.getVisibleCount();
+        const visibleSessions = this.sessions.slice(0, visibleCount); // pinned sort to top
+        // top border with label (includes focus/compact/sort mode tags)
+        const focusTag = this.focusMode ? "focus" : "";
         const sortTag = this.sortMode !== "default" ? this.sortMode : "";
         const compactTag = this.compactMode ? "compact" : "";
-        const tags = [compactTag, sortTag].filter(Boolean).join(", ");
+        const tags = [focusTag, compactTag, sortTag].filter(Boolean).join(", ");
         const label = tags ? ` agents (${tags}) ` : " agents ";
         const borderAfterLabel = Math.max(0, innerWidth - label.length);
         const topBorder = `${SLATE}${BOX.rtl}${BOX.h}${RESET}${SLATE}${label}${RESET}${SLATE}${BOX.h.repeat(borderAfterLabel)}${BOX.rtr}${RESET}`;
         process.stderr.write(SAVE_CURSOR + moveTo(startRow, 1) + CLEAR_LINE + truncateAnsi(topBorder, this.cols));
-        if (this.sessions.length === 0) {
+        if (visibleSessions.length === 0) {
             // empty state
-            const empty = `${SLATE}${BOX.v}${RESET}  ${DIM}no agents connected${RESET}`;
+            const msg = this.focusMode && this.sessions.length > 0
+                ? `${DIM}no pinned agents — /pin to add, /focus to exit${RESET}`
+                : `${DIM}no agents connected${RESET}`;
+            const empty = `${SLATE}${BOX.v}${RESET}  ${msg}`;
             const padded = padBoxLine(empty, this.cols);
             process.stderr.write(moveTo(startRow + 1, 1) + CLEAR_LINE + padded);
         }
         else if (this.compactMode) {
             // compact: inline tokens, multiple per row (with pin indicators)
-            const compactRows = formatCompactRows(this.sessions, innerWidth - 1, this.pinnedIds);
+            const compactRows = formatCompactRows(visibleSessions, innerWidth - 1, this.pinnedIds);
             for (let r = 0; r < compactRows.length; r++) {
                 const line = `${SLATE}${BOX.v}${RESET} ${compactRows[r]}`;
                 const padded = padBoxLine(line, this.cols);
@@ -651,8 +717,8 @@ export class TUI {
             }
         }
         else {
-            for (let i = 0; i < this.sessions.length; i++) {
-                const s = this.sessions[i];
+            for (let i = 0; i < visibleSessions.length; i++) {
+                const s = visibleSessions[i];
                 const isHovered = this.hoverSessionIdx === i + 1; // 1-indexed
                 const bg = isHovered ? BG_HOVER : "";
                 const pinned = this.pinnedIds.has(s.id);
@@ -665,8 +731,8 @@ export class TUI {
         }
         // bottom border
         const bodyRows = this.compactMode
-            ? computeCompactRowCount(this.sessions, innerWidth)
-            : Math.max(this.sessions.length, 1);
+            ? computeCompactRowCount(visibleSessions, innerWidth)
+            : Math.max(visibleCount, 1);
         const bottomRow = startRow + 1 + bodyRows;
         const bottomBorder = `${SLATE}${BOX.rbl}${BOX.h.repeat(Math.max(0, this.cols - 2))}${BOX.rbr}${RESET}`;
         process.stderr.write(moveTo(bottomRow, 1) + CLEAR_LINE + truncateAnsi(bottomBorder, this.cols));

package/package.json

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