aoaoe 0.79.0 → 0.81.0

package/dist/index.js

@@ -378,6 +378,23 @@ 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;
+            const ok = tui.togglePin(num ?? target);
+            if (ok) {
+                tui.log("system", `pin toggled: ${target}`);
+            }
+            else {
+                tui.log("system", `session not found: ${target}`);
+            }
+        });
         // wire mouse move to hover highlight on session cards (disabled in compact)
         input.onMouseMove((row, _col) => {
             if (tui.getViewMode() === "overview" && !tui.isCompact()) {

package/dist/input.d.ts

@@ -5,6 +5,8 @@ export type SearchHandler = (pattern: string | null) => void;
 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;
@@ -32,6 +34,8 @@ export declare class InputReader {
     private quickSwitchHandler;
     private sortHandler;
     private compactHandler;
+    private pinHandler;
+    private bellHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -43,6 +47,8 @@ export declare class InputReader {
     onQuickSwitch(handler: QuickSwitchHandler): void;
     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

@@ -37,6 +37,8 @@ export class InputReader {
     quickSwitchHandler = null;
     sortHandler = null;
     compactHandler = null;
+    pinHandler = null;
+    bellHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -78,6 +80,14 @@ export class InputReader {
     onCompact(handler) {
         this.compactHandler = handler;
     }
+    // register a callback for pin/unpin commands (/pin <target>)
+    onPin(handler) {
+        this.pinHandler = handler;
+    }
+    // register a callback for bell toggle (/bell)
+    onBell(handler) {
+        this.bellHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -257,6 +267,8 @@ ${BOLD}navigation:${RESET}
   /back              return to overview from drill-down
   /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)
@@ -354,6 +366,29 @@ ${BOLD}other:${RESET}
                     console.error(`${DIM}compact mode not available (no TUI)${RESET}`);
                 }
                 break;
+            case "/pin": {
+                const pinArg = line.slice("/pin".length).trim();
+                if (this.pinHandler) {
+                    if (pinArg) {
+                        this.pinHandler(pinArg);
+                    }
+                    else {
+                        console.error(`${DIM}usage: /pin <N|name> — toggle pin for a session${RESET}`);
+                    }
+                }
+                else {
+                    console.error(`${DIM}pin not available (no TUI)${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

@@ -2,18 +2,24 @@ import type { DaemonSessionState, DaemonPhase } from "./types.js";
 import type { HistoryEntry } from "./tui-history.js";
 export type SortMode = "default" | "status" | "name" | "activity";
 declare const SORT_MODES: SortMode[];
-/** Sort sessions by mode. Returns a new array (never mutates). */
-declare function sortSessions(sessions: DaemonSessionState[], mode: SortMode, lastChangeAt?: Map<string, number>): DaemonSessionState[];
+/** Sort sessions by mode. Pinned sessions always sort first (stable). Returns a new array (never mutates). */
+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. */
+declare const PIN_ICON = "\u25B2";
 /**
  * Format sessions as inline compact tokens, wrapped to fit maxWidth.
- * Each token: "{idx}{dot}{name}" — e.g. "1●Alpha" with colored dot and bold name.
+ * Each token: "{idx}{pin?}{dot}{name}" — e.g. "1▲●Alpha" for pinned, "2●Bravo" for unpinned.
  * Returns array of formatted row strings (one per display row).
  */
-declare function formatCompactRows(sessions: DaemonSessionState[], maxWidth: number): string[];
+declare function formatCompactRows(sessions: DaemonSessionState[], maxWidth: number, pinnedIds?: Set<string>): string[];
 /** Compute how many display rows compact mode needs (minimum 1). */
 declare function computeCompactRowCount(sessions: DaemonSessionState[], maxWidth: number): number;
 declare function phaseDisplay(phase: DaemonPhase, paused: boolean, spinnerFrame: number): string;
@@ -46,6 +52,9 @@ export declare class TUI {
     private lastChangeAt;
     private prevLastActivity;
     private compactMode;
+    private pinnedIds;
+    private bellEnabled;
+    private lastBellAt;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -71,6 +80,19 @@ export declare class TUI {
     setCompact(enabled: boolean): void;
     /** Return whether compact mode is enabled. */
     isCompact(): boolean;
+    /**
+     * Toggle pin for a session (by 1-indexed number, ID, ID prefix, or title).
+     * Pinned sessions always sort to the top. Returns true if session found.
+     */
+    togglePin(sessionIdOrIndex: string | number): boolean;
+    /** Check if a session ID is pinned. */
+    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;
@@ -161,5 +183,5 @@ declare function formatSearchIndicator(pattern: string, matchCount: number, tota
  * (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, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES, formatCompactRows, computeCompactRowCount, COMPACT_NAME_LEN };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES, formatCompactRows, computeCompactRowCount, COMPACT_NAME_LEN, PIN_ICON };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -26,8 +26,8 @@ const STATUS_PRIORITY = {
     error: 0, waiting: 1, working: 2, running: 2,
     idle: 3, done: 4, stopped: 5, unknown: 6,
 };
-/** Sort sessions by mode. Returns a new array (never mutates). */
-function sortSessions(sessions, mode, lastChangeAt) {
+/** Sort sessions by mode. Pinned sessions always sort first (stable). Returns a new array (never mutates). */
+function sortSessions(sessions, mode, lastChangeAt, pinnedIds) {
     const copy = sessions.slice();
     switch (mode) {
         case "status":
@@ -41,6 +41,10 @@ function sortSessions(sessions, mode, lastChangeAt) {
             break;
         // "default" — preserve original order
     }
+    // stable-sort pinned to top (preserves mode order within each group)
+    if (pinnedIds && pinnedIds.size > 0) {
+        copy.sort((a, b) => (pinnedIds.has(a.id) ? 0 : 1) - (pinnedIds.has(b.id) ? 0 : 1));
+    }
     return copy;
 }
 /** Cycle to the next sort mode. */
@@ -48,15 +52,28 @@ 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;
+/** Pin indicator for pinned sessions. */
+const PIN_ICON = "▲";
 /**
  * Format sessions as inline compact tokens, wrapped to fit maxWidth.
- * Each token: "{idx}{dot}{name}" — e.g. "1●Alpha" with colored dot and bold name.
+ * Each token: "{idx}{pin?}{dot}{name}" — e.g. "1▲●Alpha" for pinned, "2●Bravo" for unpinned.
  * Returns array of formatted row strings (one per display row).
  */
-function formatCompactRows(sessions, maxWidth) {
+function formatCompactRows(sessions, maxWidth, pinnedIds) {
     if (sessions.length === 0)
         return [`${DIM}no agents connected${RESET}`];
     const tokens = [];
@@ -65,9 +82,11 @@ function formatCompactRows(sessions, maxWidth) {
         const s = sessions[i];
         const idx = String(i + 1);
         const dot = STATUS_DOT[s.status] ?? `${AMBER}${DOT.filled}${RESET}`;
+        const pinned = pinnedIds?.has(s.id) ?? false;
+        const pin = pinned ? `${AMBER}${PIN_ICON}${RESET}` : "";
         const name = truncatePlain(s.title, COMPACT_NAME_LEN);
-        tokens.push(`${SLATE}${idx}${RESET}${dot}${BOLD}${name}${RESET}`);
-        widths.push(idx.length + 1 + name.length); // idx chars + dot char + name chars
+        tokens.push(`${SLATE}${idx}${RESET}${pin}${dot}${BOLD}${name}${RESET}`);
+        widths.push(idx.length + (pinned ? 1 : 0) + 1 + name.length);
     }
     const rows = [];
     let currentRow = "";
@@ -141,6 +160,9 @@ export class TUI {
     lastChangeAt = new Map(); // session ID → epoch ms of last activity change
     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;
@@ -203,7 +225,7 @@ export class TUI {
             return;
         this.sortMode = mode;
         // re-sort current sessions and repaint
-        this.sessions = sortSessions(this.sessions, this.sortMode, this.lastChangeAt);
+        this.sessions = sortSessions(this.sessions, this.sortMode, this.lastChangeAt, this.pinnedIds);
         if (this.active) {
             this.paintSessions();
         }
@@ -226,6 +248,51 @@ export class TUI {
     isCompact() {
         return this.compactMode;
     }
+    /**
+     * Toggle pin for a session (by 1-indexed number, ID, ID prefix, or title).
+     * Pinned sessions always sort to the top. Returns true if session found.
+     */
+    togglePin(sessionIdOrIndex) {
+        let sessionId;
+        if (typeof sessionIdOrIndex === "number") {
+            sessionId = this.sessions[sessionIdOrIndex - 1]?.id;
+        }
+        else {
+            const needle = sessionIdOrIndex.toLowerCase();
+            const match = this.sessions.find((s) => s.id === sessionIdOrIndex || s.id.startsWith(needle) || s.title.toLowerCase() === needle);
+            sessionId = match?.id;
+        }
+        if (!sessionId)
+            return false;
+        if (this.pinnedIds.has(sessionId)) {
+            this.pinnedIds.delete(sessionId);
+        }
+        else {
+            this.pinnedIds.add(sessionId);
+        }
+        // re-sort and repaint
+        this.sessions = sortSessions(this.sessions, this.sortMode, this.lastChangeAt, this.pinnedIds);
+        if (this.active) {
+            this.paintSessions();
+        }
+        return true;
+    }
+    /** Check if a session ID is pinned. */
+    isPinned(id) {
+        return this.pinnedIds.has(id);
+    }
+    /** Return count of pinned sessions. */
+    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)
@@ -251,7 +318,7 @@ export class TUI {
                 if (s.lastActivity !== undefined)
                     this.prevLastActivity.set(s.id, s.lastActivity);
             }
-            const sorted = sortSessions(opts.sessions, this.sortMode, this.lastChangeAt);
+            const sorted = sortSessions(opts.sessions, this.sortMode, this.lastChangeAt, this.pinnedIds);
             const sessionCountChanged = sorted.length !== this.sessions.length;
             this.sessions = sorted;
             if (sessionCountChanged) {
@@ -279,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
@@ -596,8 +671,8 @@ export class TUI {
             process.stderr.write(moveTo(startRow + 1, 1) + CLEAR_LINE + padded);
         }
         else if (this.compactMode) {
-            // compact: inline tokens, multiple per row
-            const compactRows = formatCompactRows(this.sessions, innerWidth - 1);
+            // compact: inline tokens, multiple per row (with pin indicators)
+            const compactRows = formatCompactRows(this.sessions, 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);
@@ -609,7 +684,10 @@ export class TUI {
                 const s = this.sessions[i];
                 const isHovered = this.hoverSessionIdx === i + 1; // 1-indexed
                 const bg = isHovered ? BG_HOVER : "";
-                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${formatSessionCard(s, innerWidth - 1)}`;
+                const pinned = this.pinnedIds.has(s.id);
+                const pin = pinned ? `${AMBER}${PIN_ICON}${RESET} ` : "";
+                const cardWidth = pinned ? innerWidth - 3 : innerWidth - 1; // pin takes 2 extra chars
+                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${formatSessionCard(s, cardWidth)}`;
                 const padded = padBoxLineHover(line, this.cols, isHovered);
                 process.stderr.write(moveTo(startRow + 1 + i, 1) + CLEAR_LINE + padded);
             }
@@ -639,7 +717,10 @@ export class TUI {
         const s = this.sessions[i];
         const isHovered = this.hoverSessionIdx === idx;
         const bg = isHovered ? BG_HOVER : "";
-        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${formatSessionCard(s, innerWidth - 1)}`;
+        const pinned = this.pinnedIds.has(s.id);
+        const pin = pinned ? `${AMBER}${PIN_ICON}${RESET} ` : "";
+        const cardWidth = pinned ? innerWidth - 3 : innerWidth - 1;
+        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${formatSessionCard(s, cardWidth)}`;
         const padded = padBoxLineHover(line, this.cols, isHovered);
         process.stderr.write(SAVE_CURSOR + moveTo(startRow + 1 + i, 1) + CLEAR_LINE + padded + RESTORE_CURSOR);
     }
@@ -1006,5 +1087,5 @@ export function hitTestSession(row, headerHeight, sessionCount) {
     return row - firstSessionRow + 1; // 1-indexed
 }
 // ── Exported pure helpers (for testing) ─────────────────────────────────────
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES, formatCompactRows, computeCompactRowCount, COMPACT_NAME_LEN };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES, formatCompactRows, computeCompactRowCount, COMPACT_NAME_LEN, PIN_ICON };
 //# sourceMappingURL=tui.js.map

package/package.json

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