aoaoe 0.76.0 → 0.78.0

package/dist/index.js

@@ -15,7 +15,7 @@ import { wakeableSleep } from "./wake.js";
 import { classifyMessages, formatUserMessages, buildReceipts, shouldSkipSleep, hasPendingFile, isInsistMessage, stripInsistPrefix } from "./message.js";
 import { TaskManager, loadTaskDefinitions, loadTaskState, formatTaskTable } from "./task-manager.js";
 import { runTaskCli, handleTaskSlashCommand } from "./task-cli.js";
-import { TUI, hitTestSession } from "./tui.js";
+import { TUI, hitTestSession, nextSortMode, SORT_MODES } from "./tui.js";
 import { isDaemonRunningFromState } from "./chat.js";
 import { sendNotification, sendTestNotification } from "./notify.js";
 import { startHealthServer } from "./health.js";
@@ -354,6 +354,21 @@ async function main() {
                 tui.log("system", "search cleared");
             }
         });
+        // wire /sort command to TUI session sort
+        input.onSort((mode) => {
+            if (mode && SORT_MODES.includes(mode)) {
+                tui.setSortMode(mode);
+                tui.log("system", `sort: ${mode}`);
+            }
+            else if (!mode) {
+                const next = nextSortMode(tui.getSortMode());
+                tui.setSortMode(next);
+                tui.log("system", `sort: ${next}`);
+            }
+            else {
+                tui.log("system", `unknown sort mode: ${mode} (try: status, name, activity, default)`);
+            }
+        });
         // wire mouse move to hover highlight on session cards
         input.onMouseMove((row, _col) => {
             if (tui.getViewMode() === "overview") {

package/dist/input.d.ts

@@ -3,6 +3,7 @@ export declare const INSIST_PREFIX = "__INSIST__";
 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 interface MouseEvent {
     button: number;
     col: number;
@@ -28,6 +29,7 @@ export declare class InputReader {
     private lastMoveRow;
     private searchHandler;
     private quickSwitchHandler;
+    private sortHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -37,6 +39,7 @@ export declare class InputReader {
     onMouseMove(handler: MouseMoveHandler): void;
     onSearch(handler: SearchHandler): void;
     onQuickSwitch(handler: QuickSwitchHandler): void;
+    onSort(handler: SortHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -35,6 +35,7 @@ export class InputReader {
     lastMoveRow = 0; // debounce: only fire move handler when row changes
     searchHandler = null;
     quickSwitchHandler = null;
+    sortHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -68,6 +69,10 @@ export class InputReader {
     onQuickSwitch(handler) {
         this.quickSwitchHandler = handler;
     }
+    // register a callback for sort commands (/sort <mode> or /sort to cycle)
+    onSort(handler) {
+        this.sortHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -245,6 +250,7 @@ ${BOLD}navigation:${RESET}
   1-9                quick-switch: jump to session N (type digit + Enter)
   /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)
   /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)
@@ -324,6 +330,16 @@ ${BOLD}other:${RESET}
                     console.error(`${DIM}already in overview${RESET}`);
                 }
                 break;
+            case "/sort": {
+                const sortArg = line.slice("/sort".length).trim().toLowerCase();
+                if (this.sortHandler) {
+                    this.sortHandler(sortArg || null); // empty = cycle to next mode
+                }
+                else {
+                    console.error(`${DIM}sort not available (no TUI)${RESET}`);
+                }
+                break;
+            }
             case "/search": {
                 const searchArg = line.slice("/search".length).trim();
                 if (this.searchHandler) {

package/dist/tui.d.ts

@@ -1,5 +1,11 @@
 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[];
+/** Cycle to the next sort mode. */
+declare function nextSortMode(current: SortMode): SortMode;
 declare function phaseDisplay(phase: DaemonPhase, paused: boolean, spinnerFrame: number): string;
 export interface ActivityEntry {
     time: string;
@@ -25,6 +31,10 @@ export declare class TUI {
     private pendingCount;
     private searchPattern;
     private hoverSessionIdx;
+    private activityTimestamps;
+    private sortMode;
+    private lastChangeAt;
+    private prevLastActivity;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -42,6 +52,10 @@ export declare class TUI {
     isActive(): boolean;
     /** Return the current number of sessions (for mouse hit testing) */
     getSessionCount(): number;
+    /** Set the session sort mode and repaint. */
+    setSortMode(mode: SortMode): void;
+    /** Return the current sort mode. */
+    getSortMode(): SortMode;
     updateState(opts: {
         phase?: DaemonPhase;
         pollCount?: number;
@@ -116,6 +130,10 @@ declare function computeScrollSlice(bufferLen: number, visibleLines: number, scr
 };
 declare function formatScrollIndicator(offset: number, totalEntries: number, visibleLines: number, newCount: number): string;
 declare function formatDrilldownScrollIndicator(offset: number, totalLines: number, visibleLines: number, newCount: number): string;
+/** Compute sparkline bucket counts from activity timestamps. Returns array of SPARK_BUCKETS counts. */
+declare function computeSparkline(timestamps: number[], now?: number, buckets?: number, windowMs?: number): number[];
+/** Format sparkline bucket counts as a colored Unicode block string. Returns empty string if all zeros. */
+declare function formatSparkline(counts: 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. */
@@ -128,5 +146,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 };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -21,6 +21,33 @@ const MOUSE_OFF = `${CSI}?1003l${CSI}?1006l`;
 const moveTo = (row, col) => `${CSI}${row};${col}H`;
 const setScrollRegion = (top, bottom) => `${CSI}${top};${bottom}r`;
 const resetScrollRegion = () => `${CSI}r`;
+const SORT_MODES = ["default", "status", "name", "activity"];
+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) {
+    const copy = sessions.slice();
+    switch (mode) {
+        case "status":
+            copy.sort((a, b) => (STATUS_PRIORITY[a.status] ?? 6) - (STATUS_PRIORITY[b.status] ?? 6));
+            break;
+        case "name":
+            copy.sort((a, b) => a.title.toLowerCase().localeCompare(b.title.toLowerCase()));
+            break;
+        case "activity":
+            copy.sort((a, b) => (lastChangeAt?.get(b.id) ?? 0) - (lastChangeAt?.get(a.id) ?? 0));
+            break;
+        // "default" — preserve original order
+    }
+    return copy;
+}
+/** Cycle to the next sort mode. */
+function nextSortMode(current) {
+    const idx = SORT_MODES.indexOf(current);
+    return SORT_MODES[(idx + 1) % SORT_MODES.length];
+}
 // ── Status rendering ────────────────────────────────────────────────────────
 const STATUS_DOT = {
     working: `${LIME}${DOT.filled}${RESET}`,
@@ -65,6 +92,10 @@ export class TUI {
     pendingCount = 0; // queued user messages awaiting next tick
     searchPattern = null; // active search filter pattern
     hoverSessionIdx = null; // 1-indexed session under mouse cursor (null = none)
+    activityTimestamps = []; // epoch ms of each log() call for sparkline
+    sortMode = "default";
+    lastChangeAt = new Map(); // session ID → epoch ms of last activity change
+    prevLastActivity = new Map(); // session ID → previous lastActivity string
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -121,6 +152,21 @@ export class TUI {
     getSessionCount() {
         return this.sessions.length;
     }
+    /** Set the session sort mode and repaint. */
+    setSortMode(mode) {
+        if (mode === this.sortMode)
+            return;
+        this.sortMode = mode;
+        // re-sort current sessions and repaint
+        this.sessions = sortSessions(this.sessions, this.sortMode, this.lastChangeAt);
+        if (this.active) {
+            this.paintSessions();
+        }
+    }
+    /** Return the current sort mode. */
+    getSortMode() {
+        return this.sortMode;
+    }
     // ── State updates ───────────────────────────────────────────────────────
     updateState(opts) {
         if (opts.phase !== undefined)
@@ -136,8 +182,19 @@ export class TUI {
         if (opts.pendingCount !== undefined)
             this.pendingCount = opts.pendingCount;
         if (opts.sessions !== undefined) {
-            const sessionCountChanged = opts.sessions.length !== this.sessions.length;
-            this.sessions = opts.sessions;
+            // track activity changes for sort-by-activity
+            const now = Date.now();
+            for (const s of opts.sessions) {
+                const prev = this.prevLastActivity.get(s.id);
+                if (s.lastActivity !== undefined && s.lastActivity !== prev) {
+                    this.lastChangeAt.set(s.id, now);
+                }
+                if (s.lastActivity !== undefined)
+                    this.prevLastActivity.set(s.id, s.lastActivity);
+            }
+            const sorted = sortSessions(opts.sessions, this.sortMode, this.lastChangeAt);
+            const sessionCountChanged = sorted.length !== this.sessions.length;
+            this.sessions = sorted;
             if (sessionCountChanged) {
                 this.computeLayout(this.sessions.length);
                 this.paintAll();
@@ -158,8 +215,10 @@ export class TUI {
         const time = `${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}:${String(now.getSeconds()).padStart(2, "0")}`;
         const entry = { time, tag, text };
         this.activityBuffer.push(entry);
+        this.activityTimestamps.push(now.getTime());
         if (this.activityBuffer.length > this.maxActivity) {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
+            this.activityTimestamps = this.activityTimestamps.slice(-this.maxActivity);
         }
         if (this.active) {
             if (this.searchPattern) {
@@ -461,8 +520,8 @@ export class TUI {
     paintSessions() {
         const startRow = this.headerHeight + 1;
         const innerWidth = this.cols - 2; // inside the box borders
-        // top border with label
-        const label = " agents ";
+        // top border with label (includes sort mode when not default)
+        const label = this.sortMode === "default" ? " agents " : ` agents (${this.sortMode}) `;
         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));
@@ -520,7 +579,9 @@ export class TUI {
             hints = formatScrollIndicator(this.scrollOffset, this.activityBuffer.length, this.scrollBottom - this.scrollTop + 1, this.newWhileScrolled);
         }
         else {
-            hints = " click agent to view  esc esc: interrupt  /help ";
+            // live mode: show sparkline + minimal hints
+            const spark = formatSparkline(computeSparkline(this.activityTimestamps));
+            hints = spark ? ` ${spark}  /help ` : " click agent to view  esc esc: interrupt  /help ";
         }
         const totalLen = prefix.length + hints.length;
         const fill = Math.max(0, this.cols - totalLen);
@@ -803,6 +864,41 @@ function formatDrilldownScrollIndicator(offset, totalLines, visibleLines, newCou
     const newTag = newCount > 0 ? `  ${newCount} new ↓` : "";
     return ` ↑ ${offset} lines  │  ${position}/${totalLines}  │  scroll: navigate  End=live${newTag} `;
 }
+// ── Sparkline helpers (pure, exported for testing) ──────────────────────────
+const SPARK_BLOCKS = ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"];
+const SPARK_BUCKETS = 20; // number of time buckets
+const SPARK_WINDOW_MS = 10 * 60 * 1000; // 10 minutes
+/** Compute sparkline bucket counts from activity timestamps. Returns array of SPARK_BUCKETS counts. */
+function computeSparkline(timestamps, now, buckets, windowMs) {
+    const n = buckets ?? SPARK_BUCKETS;
+    const window = windowMs ?? SPARK_WINDOW_MS;
+    const nowMs = now ?? Date.now();
+    const cutoff = nowMs - window;
+    const bucketSize = window / n;
+    const counts = new Array(n).fill(0);
+    for (const ts of timestamps) {
+        if (ts < cutoff)
+            continue;
+        const idx = Math.min(n - 1, Math.floor((ts - cutoff) / bucketSize));
+        counts[idx]++;
+    }
+    return counts;
+}
+/** Format sparkline bucket counts as a colored Unicode block string. Returns empty string if all zeros. */
+function formatSparkline(counts) {
+    const max = Math.max(...counts);
+    if (max === 0)
+        return "";
+    const blocks = counts.map((c) => {
+        if (c === 0)
+            return `${SLATE} ${RESET}`;
+        const level = Math.min(SPARK_BLOCKS.length - 1, Math.floor((c / max) * (SPARK_BLOCKS.length - 1)));
+        // color gradient: low=SLATE, mid=SKY, high=LIME
+        const color = level < 3 ? SLATE : level < 6 ? SKY : LIME;
+        return `${color}${SPARK_BLOCKS[level]}${RESET}`;
+    });
+    return blocks.join("");
+}
 // ── Search helpers (pure, exported for testing) ─────────────────────────────
 /** Case-insensitive substring match against an activity entry's tag, text, and time. */
 function matchesSearch(entry, pattern) {
@@ -835,5 +931,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 };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padBoxLineHover, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatDrilldownScrollIndicator, formatPrompt, formatDrilldownHeader, matchesSearch, formatSearchIndicator, computeSparkline, formatSparkline, sortSessions, nextSortMode, SORT_MODES };
 //# sourceMappingURL=tui.js.map

package/package.json

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