aoaoe 0.84.0 → 0.85.0

package/dist/index.js

@@ -444,6 +444,37 @@ async function main() {
                 tui.log("system", `session not found: ${target}`);
             }
         });
+        // wire /note set/clear
+        input.onNote((target, text) => {
+            const num = /^\d+$/.test(target) ? parseInt(target, 10) : undefined;
+            const ok = tui.setNote(num ?? target, text);
+            if (ok) {
+                if (text) {
+                    tui.log("system", `note set for ${target}: "${text}"`);
+                }
+                else {
+                    tui.log("system", `note cleared for ${target}`);
+                }
+            }
+            else {
+                tui.log("system", `session not found: ${target}`);
+            }
+        });
+        // wire /notes listing
+        input.onNotes(() => {
+            const notes = tui.getAllNotes();
+            if (notes.size === 0) {
+                tui.log("system", "no notes — use /note <N|name> <text> to add one");
+            }
+            else {
+                const sessions = tui.getSessions();
+                for (const [id, text] of notes) {
+                    const session = sessions.find((s) => s.id === id);
+                    const label = session ? session.title : id.slice(0, 8);
+                    tui.log("system", `  ${label}: "${text}"`);
+                }
+            }
+        });
         // 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

@@ -12,6 +12,8 @@ export type MarkHandler = () => void;
 export type JumpHandler = (num: number) => void;
 export type MarksHandler = () => void;
 export type MuteHandler = (target: string) => void;
+export type NoteHandler = (target: string, text: string) => void;
+export type NotesHandler = () => void;
 export interface MouseEvent {
     button: number;
     col: number;
@@ -46,6 +48,8 @@ export declare class InputReader {
     private jumpHandler;
     private marksHandler;
     private muteHandler;
+    private noteHandler;
+    private notesHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -64,6 +68,8 @@ export declare class InputReader {
     onJump(handler: JumpHandler): void;
     onMarks(handler: MarksHandler): void;
     onMute(handler: MuteHandler): void;
+    onNote(handler: NoteHandler): void;
+    onNotes(handler: NotesHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -44,6 +44,8 @@ export class InputReader {
     jumpHandler = null;
     marksHandler = null;
     muteHandler = null;
+    noteHandler = null;
+    notesHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -113,6 +115,14 @@ export class InputReader {
     onMute(handler) {
         this.muteHandler = handler;
     }
+    // register a callback for note commands (/note <target> <text>)
+    onNote(handler) {
+        this.noteHandler = handler;
+    }
+    // register a callback for listing notes (/notes)
+    onNotes(handler) {
+        this.notesHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -296,6 +306,8 @@ ${BOLD}navigation:${RESET}
   /bell              toggle terminal bell on errors/completions
   /focus             toggle focus mode (show only pinned sessions)
   /mute [N|name]     mute/unmute a session's activity entries (toggle)
+  /note N|name text  attach a note to a session (no text = clear)
+  /notes             list all session notes
   /mark              bookmark current activity position
   /jump N            jump to bookmark N
   /marks             list all bookmarks
@@ -442,6 +454,37 @@ ${BOLD}other:${RESET}
                 }
                 break;
             }
+            case "/note": {
+                const noteArg = line.slice("/note".length).trim();
+                if (this.noteHandler) {
+                    // split: first word is target, rest is note text
+                    const spaceIdx = noteArg.indexOf(" ");
+                    if (spaceIdx > 0) {
+                        const target = noteArg.slice(0, spaceIdx);
+                        const text = noteArg.slice(spaceIdx + 1).trim();
+                        this.noteHandler(target, text);
+                    }
+                    else if (noteArg) {
+                        // target only, no text — clear note
+                        this.noteHandler(noteArg, "");
+                    }
+                    else {
+                        console.error(`${DIM}usage: /note <N|name> <text> — set note, or /note <N|name> — clear${RESET}`);
+                    }
+                }
+                else {
+                    console.error(`${DIM}notes not available (no TUI)${RESET}`);
+                }
+                break;
+            }
+            case "/notes":
+                if (this.notesHandler) {
+                    this.notesHandler();
+                }
+                else {
+                    console.error(`${DIM}notes not available (no TUI)${RESET}`);
+                }
+                break;
             case "/mark":
                 if (this.markHandler) {
                     this.markHandler();

package/dist/tui.d.ts

@@ -31,7 +31,7 @@ declare const PIN_ICON = "\u25B2";
  * Each token: "{idx}{pin?}{mute?}{dot}{name}" — e.g. "1▲●Alpha" for pinned, "2◌●Bravo" for muted.
  * Returns array of formatted row strings (one per display row).
  */
-declare function formatCompactRows(sessions: DaemonSessionState[], maxWidth: number, pinnedIds?: Set<string>, mutedIds?: Set<string>): string[];
+declare function formatCompactRows(sessions: DaemonSessionState[], maxWidth: number, pinnedIds?: Set<string>, mutedIds?: Set<string>, noteIds?: 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;
@@ -43,6 +43,12 @@ export interface ActivityEntry {
 }
 /** Mute indicator for muted sessions (shown dim beside session card). */
 declare const MUTE_ICON = "\u25CC";
+/** Note indicator for sessions with notes. */
+declare const NOTE_ICON = "\u270E";
+/** Max length for a session note (visible chars). */
+export declare const MAX_NOTE_LEN = 80;
+/** Truncate a note to the max length. */
+export declare function truncateNote(text: string): string;
 /** Determine if an activity entry should be hidden due to muting. */
 export declare function shouldMuteEntry(entry: ActivityEntry, mutedIds: Set<string>): boolean;
 export declare class TUI {
@@ -75,6 +81,7 @@ export declare class TUI {
     private bellEnabled;
     private lastBellAt;
     private mutedIds;
+    private sessionNotes;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -129,6 +136,19 @@ export declare class TUI {
     isMuted(id: string): boolean;
     /** Return count of muted sessions. */
     getMutedCount(): number;
+    /**
+     * Set a note on a session (by 1-indexed number, ID, ID prefix, or title).
+     * Returns true if session found. Pass empty text to clear.
+     */
+    setNote(sessionIdOrIndex: string | number, text: string): boolean;
+    /** Get the note for a session ID (or undefined if none). */
+    getNote(id: string): string | undefined;
+    /** Return count of sessions with notes. */
+    getNoteCount(): number;
+    /** Return all session notes (for /notes listing). */
+    getAllNotes(): ReadonlyMap<string, string>;
+    /** Return the current sessions (read-only, for resolving IDs to titles in the UI). */
+    getSessions(): readonly DaemonSessionState[];
     /**
      * Add a bookmark at the current activity position.
      * Returns the bookmark number (1-indexed) or 0 if buffer is empty.
@@ -233,5 +253,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, PIN_ICON, MUTE_ICON };
+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, MUTE_ICON, NOTE_ICON };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -90,7 +90,7 @@ const PIN_ICON = "▲";
  * Each token: "{idx}{pin?}{mute?}{dot}{name}" — e.g. "1▲●Alpha" for pinned, "2◌●Bravo" for muted.
  * Returns array of formatted row strings (one per display row).
  */
-function formatCompactRows(sessions, maxWidth, pinnedIds, mutedIds) {
+function formatCompactRows(sessions, maxWidth, pinnedIds, mutedIds, noteIds) {
     if (sessions.length === 0)
         return [`${DIM}no agents connected${RESET}`];
     const tokens = [];
@@ -101,11 +101,13 @@ function formatCompactRows(sessions, maxWidth, pinnedIds, mutedIds) {
         const dot = STATUS_DOT[s.status] ?? `${AMBER}${DOT.filled}${RESET}`;
         const pinned = pinnedIds?.has(s.id) ?? false;
         const muted = mutedIds?.has(s.id) ?? false;
+        const noted = noteIds?.has(s.id) ?? false;
         const pin = pinned ? `${AMBER}${PIN_ICON}${RESET}` : "";
         const muteIcon = muted ? `${DIM}${MUTE_ICON}${RESET}` : "";
+        const noteIcon = noted ? `${TEAL}${NOTE_ICON}${RESET}` : "";
         const name = truncatePlain(s.title, COMPACT_NAME_LEN);
-        tokens.push(`${SLATE}${idx}${RESET}${pin}${muteIcon}${dot}${BOLD}${name}${RESET}`);
-        widths.push(idx.length + (pinned ? 1 : 0) + (muted ? 1 : 0) + 1 + name.length);
+        tokens.push(`${SLATE}${idx}${RESET}${pin}${muteIcon}${noteIcon}${dot}${BOLD}${name}${RESET}`);
+        widths.push(idx.length + (pinned ? 1 : 0) + (muted ? 1 : 0) + (noted ? 1 : 0) + 1 + name.length);
     }
     const rows = [];
     let currentRow = "";
@@ -157,6 +159,15 @@ function phaseDisplay(phase, paused, spinnerFrame) {
 // ── Mute helpers ──────────────────────────────────────────────────────────────
 /** Mute indicator for muted sessions (shown dim beside session card). */
 const MUTE_ICON = "◌";
+// ── Notes ─────────────────────────────────────────────────────────────────────
+/** Note indicator for sessions with notes. */
+const NOTE_ICON = "✎";
+/** Max length for a session note (visible chars). */
+export const MAX_NOTE_LEN = 80;
+/** Truncate a note to the max length. */
+export function truncateNote(text) {
+    return text.length > MAX_NOTE_LEN ? text.slice(0, MAX_NOTE_LEN - 2) + ".." : text;
+}
 /** Determine if an activity entry should be hidden due to muting. */
 export function shouldMuteEntry(entry, mutedIds) {
     if (!entry.sessionId)
@@ -194,6 +205,7 @@ export class TUI {
     bellEnabled = false;
     lastBellAt = 0;
     mutedIds = new Set(); // muted session IDs (activity entries hidden)
+    sessionNotes = new Map(); // session ID → note text
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -387,6 +399,52 @@ export class TUI {
     getMutedCount() {
         return this.mutedIds.size;
     }
+    /**
+     * Set a note on a session (by 1-indexed number, ID, ID prefix, or title).
+     * Returns true if session found. Pass empty text to clear.
+     */
+    setNote(sessionIdOrIndex, text) {
+        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 (text.trim() === "") {
+            this.sessionNotes.delete(sessionId);
+        }
+        else {
+            this.sessionNotes.set(sessionId, truncateNote(text.trim()));
+        }
+        if (this.active) {
+            this.paintSessions();
+            if (this.viewMode === "drilldown" && this.drilldownSessionId === sessionId) {
+                this.paintDrilldownSeparator();
+            }
+        }
+        return true;
+    }
+    /** Get the note for a session ID (or undefined if none). */
+    getNote(id) {
+        return this.sessionNotes.get(id);
+    }
+    /** Return count of sessions with notes. */
+    getNoteCount() {
+        return this.sessionNotes.size;
+    }
+    /** Return all session notes (for /notes listing). */
+    getAllNotes() {
+        return this.sessionNotes;
+    }
+    /** Return the current sessions (read-only, for resolving IDs to titles in the UI). */
+    getSessions() {
+        return this.sessions;
+    }
     /**
      * Add a bookmark at the current activity position.
      * Returns the bookmark number (1-indexed) or 0 if buffer is empty.
@@ -837,7 +895,8 @@ export class TUI {
         }
         else if (this.compactMode) {
             // compact: inline tokens, multiple per row (with pin indicators)
-            const compactRows = formatCompactRows(visibleSessions, innerWidth - 1, this.pinnedIds, this.mutedIds);
+            const noteIdSet = new Set(this.sessionNotes.keys());
+            const compactRows = formatCompactRows(visibleSessions, innerWidth - 1, this.pinnedIds, this.mutedIds, noteIdSet);
             for (let r = 0; r < compactRows.length; r++) {
                 const line = `${SLATE}${BOX.v}${RESET} ${compactRows[r]}`;
                 const padded = padBoxLine(line, this.cols);
@@ -851,11 +910,13 @@ export class TUI {
                 const bg = isHovered ? BG_HOVER : "";
                 const pinned = this.pinnedIds.has(s.id);
                 const muted = this.mutedIds.has(s.id);
+                const noted = this.sessionNotes.has(s.id);
                 const pin = pinned ? `${AMBER}${PIN_ICON}${RESET} ` : "";
                 const mute = muted ? `${DIM}${MUTE_ICON}${RESET} ` : "";
-                const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0); // each icon + space = 2 chars
+                const note = noted ? `${TEAL}${NOTE_ICON}${RESET} ` : "";
+                const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0) + (noted ? 2 : 0);
                 const cardWidth = innerWidth - 1 - iconsWidth;
-                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${formatSessionCard(s, cardWidth)}`;
+                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${note}${formatSessionCard(s, cardWidth)}`;
                 const padded = padBoxLineHover(line, this.cols, isHovered);
                 process.stderr.write(moveTo(startRow + 1 + i, 1) + CLEAR_LINE + padded);
             }
@@ -887,11 +948,13 @@ export class TUI {
         const bg = isHovered ? BG_HOVER : "";
         const pinned = this.pinnedIds.has(s.id);
         const muted = this.mutedIds.has(s.id);
+        const noted = this.sessionNotes.has(s.id);
         const pin = pinned ? `${AMBER}${PIN_ICON}${RESET} ` : "";
         const mute = muted ? `${DIM}${MUTE_ICON}${RESET} ` : "";
-        const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0);
+        const note = noted ? `${TEAL}${NOTE_ICON}${RESET} ` : "";
+        const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0) + (noted ? 2 : 0);
         const cardWidth = innerWidth - 1 - iconsWidth;
-        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${formatSessionCard(s, cardWidth)}`;
+        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${note}${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);
     }
@@ -952,7 +1015,9 @@ export class TUI {
     paintDrilldownSeparator() {
         const session = this.sessions.find((s) => s.id === this.drilldownSessionId);
         const title = session ? session.title : this.drilldownSessionId ?? "?";
-        const prefix = `${BOX.h}${BOX.h} ${title} `;
+        const noteText = this.drilldownSessionId ? this.sessionNotes.get(this.drilldownSessionId) : undefined;
+        const noteSuffix = noteText ? `"${noteText}" ` : "";
+        const prefix = `${BOX.h}${BOX.h} ${title} ${noteSuffix}`;
         let hints;
         if (this.drilldownScrollOffset > 0) {
             const outputLines = this.sessionOutputs.get(this.drilldownSessionId ?? "") ?? [];
@@ -1261,5 +1326,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, PIN_ICON, MUTE_ICON };
+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, MUTE_ICON, NOTE_ICON };
 //# sourceMappingURL=tui.js.map

package/package.json

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