aoaoe 0.80.0 → 0.81.0

package/dist/index.js

@@ -378,6 +378,12 @@ async function main() {
             tui.setCompact(enabled);
             tui.log("system", `compact mode: ${enabled ? "on" : "off"}`);
         });
+        // 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,7 @@ 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 interface MouseEvent {
     button: number;
     col: number;
@@ -34,6 +35,7 @@ export declare class InputReader {
     private sortHandler;
     private compactHandler;
     private pinHandler;
+    private bellHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -46,6 +48,7 @@ export declare class InputReader {
     onSort(handler: SortHandler): void;
     onCompact(handler: CompactHandler): void;
     onPin(handler: PinHandler): void;
+    onBell(handler: BellHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -38,6 +38,7 @@ export class InputReader {
     sortHandler = null;
     compactHandler = null;
     pinHandler = null;
+    bellHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -83,6 +84,10 @@ export class InputReader {
     onPin(handler) {
         this.pinHandler = handler;
     }
+    // register a callback for bell toggle (/bell)
+    onBell(handler) {
+        this.bellHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -263,6 +268,7 @@ ${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
   /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 +381,14 @@ ${BOLD}other:${RESET}
                 }
                 break;
             }
+            case "/bell":
+                if (this.bellHandler) {
+                    this.bellHandler();
+                }
+                else {
+                    console.error(`${DIM}bell 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,8 @@ export declare class TUI {
     private prevLastActivity;
     private compactMode;
     private pinnedIds;
+    private bellEnabled;
+    private lastBellAt;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -83,6 +89,10 @@ export declare class TUI {
     isPinned(id: string): boolean;
     /** Return count of pinned sessions. */
     getPinnedCount(): number;
+    /** 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,8 @@ export class TUI {
     prevLastActivity = new Map(); // session ID → previous lastActivity string
     compactMode = false;
     pinnedIds = new Set(); // pinned session IDs (always sort to top)
+    bellEnabled = false;
+    lastBellAt = 0;
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -272,6 +285,14 @@ export class TUI {
     getPinnedCount() {
         return this.pinnedIds.size;
     }
+    /** 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)
@@ -325,6 +346,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

package/package.json

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