aoaoe 0.78.0 → 0.80.0

package/dist/index.js

@@ -318,6 +318,9 @@ async function main() {
                 tui.log("system", "returned to overview");
                 return;
             }
+            // compact mode: no per-session click targeting (use quick-switch or /view)
+            if (tui.isCompact())
+                return;
             const sessionIdx = hitTestSession(row, 1, tui.getSessionCount());
             if (sessionIdx !== null) {
                 const ok = tui.enterDrilldown(sessionIdx);
@@ -369,9 +372,26 @@ async function main() {
                 tui.log("system", `unknown sort mode: ${mode} (try: status, name, activity, default)`);
             }
         });
-        // wire mouse move to hover highlight on session cards
+        // wire /compact toggle
+        input.onCompact(() => {
+            const enabled = !tui.isCompact();
+            tui.setCompact(enabled);
+            tui.log("system", `compact mode: ${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") {
+            if (tui.getViewMode() === "overview" && !tui.isCompact()) {
                 const sessionIdx = hitTestSession(row, 1, tui.getSessionCount());
                 tui.setHoverSession(sessionIdx);
             }

package/dist/input.d.ts

@@ -4,6 +4,8 @@ export type ViewHandler = (target: string | null) => void;
 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 interface MouseEvent {
     button: number;
     col: number;
@@ -30,6 +32,8 @@ export declare class InputReader {
     private searchHandler;
     private quickSwitchHandler;
     private sortHandler;
+    private compactHandler;
+    private pinHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -40,6 +44,8 @@ export declare class InputReader {
     onSearch(handler: SearchHandler): void;
     onQuickSwitch(handler: QuickSwitchHandler): void;
     onSort(handler: SortHandler): void;
+    onCompact(handler: CompactHandler): void;
+    onPin(handler: PinHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -36,6 +36,8 @@ export class InputReader {
     searchHandler = null;
     quickSwitchHandler = null;
     sortHandler = null;
+    compactHandler = null;
+    pinHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -73,6 +75,14 @@ export class InputReader {
     onSort(handler) {
         this.sortHandler = handler;
     }
+    // register a callback for compact mode toggle (/compact)
+    onCompact(handler) {
+        this.compactHandler = handler;
+    }
+    // register a callback for pin/unpin commands (/pin <target>)
+    onPin(handler) {
+        this.pinHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -251,6 +261,8 @@ ${BOLD}navigation:${RESET}
   /view [N|name]     drill into a session's live output (default: 1)
   /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)
   /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)
@@ -340,6 +352,29 @@ ${BOLD}other:${RESET}
                 }
                 break;
             }
+            case "/compact":
+                if (this.compactHandler) {
+                    this.compactHandler();
+                }
+                else {
+                    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 "/search": {
                 const searchArg = line.slice("/search".length).trim();
                 if (this.searchHandler) {

package/dist/tui.d.ts

@@ -2,10 +2,22 @@ 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;
+/** 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}{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, 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;
 export interface ActivityEntry {
     time: string;
@@ -35,6 +47,8 @@ export declare class TUI {
     private sortMode;
     private lastChangeAt;
     private prevLastActivity;
+    private compactMode;
+    private pinnedIds;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -56,6 +70,19 @@ export declare class TUI {
     setSortMode(mode: SortMode): void;
     /** Return the current sort mode. */
     getSortMode(): SortMode;
+    /** Toggle or set compact mode. Recomputes layout and repaints. */
+    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;
     updateState(opts: {
         phase?: DaemonPhase;
         pollCount?: number;
@@ -146,5 +173,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 };
+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,6 +52,54 @@ function nextSortMode(current) {
     const idx = SORT_MODES.indexOf(current);
     return SORT_MODES[(idx + 1) % SORT_MODES.length];
 }
+// ── 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}{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, pinnedIds) {
+    if (sessions.length === 0)
+        return [`${DIM}no agents connected${RESET}`];
+    const tokens = [];
+    const widths = [];
+    for (let i = 0; i < sessions.length; i++) {
+        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}${pin}${dot}${BOLD}${name}${RESET}`);
+        widths.push(idx.length + (pinned ? 1 : 0) + 1 + name.length);
+    }
+    const rows = [];
+    let currentRow = "";
+    let currentWidth = 0;
+    for (let i = 0; i < tokens.length; i++) {
+        const gap = currentWidth > 0 ? 2 : 0;
+        if (currentWidth + gap + widths[i] > maxWidth && currentWidth > 0) {
+            rows.push(currentRow);
+            currentRow = tokens[i];
+            currentWidth = widths[i];
+        }
+        else {
+            currentRow += (currentWidth > 0 ? "  " : "") + tokens[i];
+            currentWidth += gap + widths[i];
+        }
+    }
+    if (currentRow)
+        rows.push(currentRow);
+    return rows;
+}
+/** Compute how many display rows compact mode needs (minimum 1). */
+function computeCompactRowCount(sessions, maxWidth) {
+    return Math.max(1, formatCompactRows(sessions, maxWidth).length);
+}
 // ── Status rendering ────────────────────────────────────────────────────────
 const STATUS_DOT = {
     working: `${LIME}${DOT.filled}${RESET}`,
@@ -96,6 +148,8 @@ export class TUI {
     sortMode = "default";
     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)
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -158,7 +212,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();
         }
@@ -167,6 +221,57 @@ export class TUI {
     getSortMode() {
         return this.sortMode;
     }
+    /** Toggle or set compact mode. Recomputes layout and repaints. */
+    setCompact(enabled) {
+        if (enabled === this.compactMode)
+            return;
+        this.compactMode = enabled;
+        if (this.active) {
+            this.computeLayout(this.sessions.length);
+            this.paintAll();
+        }
+    }
+    /** Return whether compact mode is enabled. */
+    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;
+    }
     // ── State updates ───────────────────────────────────────────────────────
     updateState(opts) {
         if (opts.phase !== undefined)
@@ -192,7 +297,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) {
@@ -460,7 +565,9 @@ export class TUI {
         }
         else {
             // overview: header (1) + sessions box + separator + activity + input
-            const sessBodyRows = Math.max(sessionCount, 1);
+            const sessBodyRows = this.compactMode
+                ? computeCompactRowCount(this.sessions, this.cols - 2)
+                : Math.max(sessionCount, 1);
             this.sessionRows = sessBodyRows + 2; // + top/bottom borders
             this.separatorRow = this.headerHeight + this.sessionRows + 1;
             this.inputRow = this.rows;
@@ -520,8 +627,11 @@ export class TUI {
     paintSessions() {
         const startRow = this.headerHeight + 1;
         const innerWidth = this.cols - 2; // inside the box borders
-        // top border with label (includes sort mode when not default)
-        const label = this.sortMode === "default" ? " agents " : ` agents (${this.sortMode}) `;
+        // top border with label (includes compact/sort mode tags)
+        const sortTag = this.sortMode !== "default" ? this.sortMode : "";
+        const compactTag = this.compactMode ? "compact" : "";
+        const tags = [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));
@@ -531,18 +641,32 @@ export class TUI {
             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);
+            for (let r = 0; r < compactRows.length; r++) {
+                const line = `${SLATE}${BOX.v}${RESET} ${compactRows[r]}`;
+                const padded = padBoxLine(line, this.cols);
+                process.stderr.write(moveTo(startRow + 1 + r, 1) + CLEAR_LINE + padded);
+            }
+        }
         else {
             for (let i = 0; i < this.sessions.length; i++) {
                 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);
             }
         }
         // bottom border
-        const bodyRows = Math.max(this.sessions.length, 1);
+        const bodyRows = this.compactMode
+            ? computeCompactRowCount(this.sessions, innerWidth)
+            : Math.max(this.sessions.length, 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));
@@ -564,7 +688,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);
     }
@@ -931,5 +1058,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 };
+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.78.0",
+  "version": "0.80.0",
   "description": "Autonomous supervisor for agent-of-empires sessions using OpenCode or Claude Code",
   "type": "module",
   "main": "dist/index.js",