aoaoe 0.64.0 → 0.66.0

package/dist/config.js

@@ -592,6 +592,7 @@ example config:
 interactive commands (while daemon is running):
   /help          show available commands
   /explain       ask the AI to explain what's happening in plain English
+  /insist <msg>  interrupt + deliver message immediately (skip queue)
   /status        request daemon status
   /dashboard     request full dashboard output
   /pause         pause the daemon
@@ -600,6 +601,7 @@ interactive commands (while daemon is running):
   /verbose       toggle verbose logging
   /clear         clear the screen
   ESC ESC        interrupt the current reasoner (shortcut)
-  (anything)     send a message to the AI — it reads your input next cycle`);
+  !message       insist shortcut — same as /insist message
+  (anything)     send a message to the AI — queued for next cycle`);
 }
 //# sourceMappingURL=config.js.map

package/dist/index.js

@@ -12,7 +12,7 @@ import { loadGlobalContext, resolveProjectDirWithSource, discoverContextFiles, l
 import { tick as loopTick } from "./loop.js";
 import { exec as shellExec } from "./shell.js";
 import { wakeableSleep } from "./wake.js";
-import { classifyMessages, formatUserMessages, buildReceipts, shouldSkipSleep, hasPendingFile } from "./message.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 } from "./tui.js";
@@ -235,6 +235,29 @@ async function main() {
     // start interactive input listener and conversation log
     input.start();
     await reasonerConsole.start();
+    // wire scroll keys to TUI (PgUp/PgDn/Home/End)
+    if (tui) {
+        input.onScroll((dir) => {
+            switch (dir) {
+                case "up":
+                    tui.scrollUp();
+                    break;
+                case "down":
+                    tui.scrollDown();
+                    break;
+                case "top":
+                    tui.scrollToTop();
+                    break;
+                case "bottom":
+                    tui.scrollToBottom();
+                    break;
+            }
+        });
+        // wire queue count changes to TUI prompt display
+        input.onQueueChange((count) => {
+            tui.updateState({ pendingCount: count });
+        });
+    }
     // start TUI (alternate screen buffer) after input is ready
     if (tui) {
         // replay persisted history from previous runs before entering alt screen
@@ -374,6 +397,17 @@ async function main() {
         const allMessages = [...stdinMessages, ...consoleMessages];
         // classify into commands vs. real user messages
         const { commands, userMessages } = classifyMessages(allMessages);
+        // strip insist prefix from priority messages and log them distinctly
+        for (let i = 0; i < userMessages.length; i++) {
+            if (isInsistMessage(userMessages[i])) {
+                const raw = stripInsistPrefix(userMessages[i]);
+                userMessages[i] = raw;
+                if (tui)
+                    tui.log("you", `! ${raw}`);
+                else
+                    log(`[insist] ${raw}`);
+            }
+        }
         // auto-explain on first tick: inject an explain prompt so the AI introduces itself
         if (autoExplainPending && pollCount === 1) {
             const autoExplainPrompt = "This is your first observation. Please briefly introduce what you see: " +

package/dist/input.d.ts

@@ -1,8 +1,15 @@
+export type ScrollDirection = "up" | "down" | "top" | "bottom";
+export declare const INSIST_PREFIX = "__INSIST__";
 export declare class InputReader {
     private rl;
     private queue;
     private paused;
     private lastEscTime;
+    private scrollHandler;
+    private queueChangeHandler;
+    onScroll(handler: (dir: ScrollDirection) => void): void;
+    onQueueChange(handler: (count: number) => void): void;
+    private notifyQueueChange;
     start(): void;
     drain(): string[];
     isPaused(): boolean;
@@ -11,6 +18,7 @@ export declare class InputReader {
     prompt(): void;
     stop(): void;
     private handleEscInterrupt;
+    private handleInsist;
     private handleLine;
     private handleCommand;
 }

package/dist/input.js

@@ -6,11 +6,25 @@ import { requestInterrupt } from "./daemon-state.js";
 import { GREEN, DIM, YELLOW, RED, BOLD, RESET } from "./colors.js";
 // ESC-ESC interrupt detection
 const ESC_DOUBLE_TAP_MS = 500;
+export const INSIST_PREFIX = "__INSIST__";
 export class InputReader {
     rl = null;
     queue = []; // pending user messages for the reasoner
     paused = false;
     lastEscTime = 0;
+    scrollHandler = null;
+    queueChangeHandler = null;
+    // register a callback for scroll key events (PgUp/PgDn/Home/End)
+    onScroll(handler) {
+        this.scrollHandler = handler;
+    }
+    // register a callback for queue size changes (for TUI pending count display)
+    onQueueChange(handler) {
+        this.queueChangeHandler = handler;
+    }
+    notifyQueueChange() {
+        this.queueChangeHandler?.(this.queue.length);
+    }
     start() {
         // only works if stdin is a TTY (not piped)
         if (!process.stdin.isTTY)
@@ -39,6 +53,21 @@ export class InputReader {
             else {
                 this.lastEscTime = 0;
             }
+            // scroll key detection (PgUp, PgDn, Home, End)
+            if (this.scrollHandler) {
+                if (key?.name === "pageup" || key?.sequence === "\x1b[5~") {
+                    this.scrollHandler("up");
+                }
+                else if (key?.name === "pagedown" || key?.sequence === "\x1b[6~") {
+                    this.scrollHandler("down");
+                }
+                else if (key?.name === "home" || key?.sequence === "\x1b[1~") {
+                    this.scrollHandler("top");
+                }
+                else if (key?.name === "end" || key?.sequence === "\x1b[4~") {
+                    this.scrollHandler("bottom");
+                }
+            }
         });
         // show hint on startup
         console.error(`${DIM}type a message to talk to the AI supervisor, /help for commands, ESC ESC to interrupt${RESET}`);
@@ -47,6 +76,8 @@ export class InputReader {
     // drain all pending user messages (called each tick)
     drain() {
         const msgs = this.queue.splice(0);
+        if (msgs.length > 0)
+            this.notifyQueueChange();
         return msgs;
     }
     isPaused() {
@@ -59,6 +90,7 @@ export class InputReader {
     // inject a message directly into the queue (used after interrupt to feed text into next tick)
     inject(msg) {
         this.queue.push(msg);
+        this.notifyQueueChange();
     }
     // re-show the prompt (called after daemon prints output)
     prompt() {
@@ -71,10 +103,18 @@ export class InputReader {
     handleEscInterrupt() {
         requestInterrupt();
         this.queue.push("__CMD_INTERRUPT__");
+        this.notifyQueueChange();
         console.error(`\n${RED}${BOLD}>>> interrupting reasoner <<<${RESET}`);
         console.error(`${YELLOW}type your message now -- it will be sent before the next cycle${RESET}`);
         this.rl?.prompt(true);
     }
+    handleInsist(msg) {
+        requestInterrupt();
+        this.queue.push("__CMD_INTERRUPT__");
+        this.queue.push(`${INSIST_PREFIX}${msg}`);
+        this.notifyQueueChange();
+        console.error(`${RED}${BOLD}!${RESET} ${GREEN}insist${RESET} ${DIM}— interrupting + delivering your message immediately${RESET}`);
+    }
     handleLine(line) {
         if (!line) {
             this.rl?.prompt();
@@ -86,9 +126,20 @@ export class InputReader {
             this.rl?.prompt();
             return;
         }
+        // ! prefix = insist mode: interrupt + priority message
+        if (line.startsWith("!") && line.length > 1) {
+            const msg = line.slice(1).trim();
+            if (msg) {
+                this.handleInsist(msg);
+                this.rl?.prompt();
+                return;
+            }
+        }
         // queue as a user message for the reasoner
         this.queue.push(line);
-        console.error(`${GREEN}Got it!${RESET} ${DIM}The AI will read your message on the next cycle.${RESET}`);
+        this.notifyQueueChange();
+        const pending = this.queue.filter(m => !m.startsWith("__CMD_")).length;
+        console.error(`${GREEN}queued${RESET} ${DIM}(${pending} pending) — will be read next cycle${RESET}`);
         this.rl?.prompt();
     }
     handleCommand(line) {
@@ -97,7 +148,9 @@ export class InputReader {
             case "/help":
                 console.error(`
 ${BOLD}talking to the AI:${RESET}
-  just type          send a message to the AI supervisor
+  just type          send a message — queued for next cycle
+  !message           insist — interrupt + deliver message immediately
+  /insist <msg>      same as !message
   /explain           ask the AI to explain what's happening right now
 
 ${BOLD}controls:${RESET}
@@ -105,6 +158,8 @@ ${BOLD}controls:${RESET}
   /resume            resume the supervisor
   /interrupt         interrupt the AI mid-thought
   ESC ESC            same as /interrupt (shortcut)
+  PgUp / PgDn        scroll through activity history
+  Home / End         jump to oldest / return to live
 
 ${BOLD}info:${RESET}
   /status            show daemon state
@@ -141,6 +196,16 @@ ${BOLD}other:${RESET}
             case "/interrupt":
                 this.handleEscInterrupt();
                 break;
+            case "/insist": {
+                const insistMsg = line.slice("/insist".length).trim();
+                if (insistMsg) {
+                    this.handleInsist(insistMsg);
+                }
+                else {
+                    console.error(`${DIM}usage: /insist <message> — interrupts and delivers your message immediately${RESET}`);
+                }
+                break;
+            }
             case "/tasks":
                 this.queue.push("__CMD_TASK__list");
                 break;

package/dist/message.d.ts

@@ -36,4 +36,17 @@ export declare function shouldSkipSleep(state: {
  * Lightweight stat-only check — does not read or drain the file.
  */
 export declare function hasPendingFile(filePath: string): boolean;
+/**
+ * Insist prefix marker — messages prefixed with this bypass the normal queue
+ * and trigger an immediate interrupt + delivery.
+ */
+export declare const INSIST_PREFIX = "__INSIST__";
+/**
+ * Check if a message is an insist (priority) message.
+ */
+export declare function isInsistMessage(msg: string): boolean;
+/**
+ * Strip the insist prefix from a message, returning the raw user text.
+ */
+export declare function stripInsistPrefix(msg: string): string;
 //# sourceMappingURL=message.d.ts.map

package/dist/message.js

@@ -73,6 +73,23 @@ export function hasPendingFile(filePath) {
         return false;
     }
 }
+/**
+ * Insist prefix marker — messages prefixed with this bypass the normal queue
+ * and trigger an immediate interrupt + delivery.
+ */
+export const INSIST_PREFIX = "__INSIST__";
+/**
+ * Check if a message is an insist (priority) message.
+ */
+export function isInsistMessage(msg) {
+    return msg.startsWith(INSIST_PREFIX);
+}
+/**
+ * Strip the insist prefix from a message, returning the raw user text.
+ */
+export function stripInsistPrefix(msg) {
+    return msg.startsWith(INSIST_PREFIX) ? msg.slice(INSIST_PREFIX.length) : msg;
+}
 function truncate(s, max) {
     return s.length <= max ? s : s.slice(0, max - 3) + "...";
 }

package/dist/tui.d.ts

@@ -20,6 +20,9 @@ export declare class TUI {
     private activityBuffer;
     private maxActivity;
     private spinnerFrame;
+    private scrollOffset;
+    private newWhileScrolled;
+    private pendingCount;
     private phase;
     private pollCount;
     private sessions;
@@ -37,9 +40,15 @@ export declare class TUI {
         paused?: boolean;
         reasonerName?: string;
         nextTickAt?: number;
+        pendingCount?: number;
     }): void;
     log(tag: string, text: string): void;
     replayHistory(entries: HistoryEntry[]): void;
+    scrollUp(lines?: number): void;
+    scrollDown(lines?: number): void;
+    scrollToTop(): void;
+    scrollToBottom(): void;
+    isScrolledBack(): boolean;
     private updateDimensions;
     private computeLayout;
     private onResize;
@@ -63,5 +72,11 @@ declare function truncatePlain(str: string, max: number): string;
  * Kept for backward compatibility — used by non-TUI output paths.
  */
 export declare function formatSessionSentence(s: DaemonSessionState, maxCols: number): string;
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay };
+declare function formatPrompt(phase: DaemonPhase, paused: boolean, pendingCount: number): string;
+declare function computeScrollSlice(bufferLen: number, visibleLines: number, scrollOffset: number): {
+    start: number;
+    end: number;
+};
+declare function formatScrollIndicator(offset: number, totalEntries: number, visibleLines: number, newCount: number): string;
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatPrompt };
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.js

@@ -55,6 +55,9 @@ export class TUI {
     activityBuffer = []; // ring buffer for activity log
     maxActivity = 500; // max entries to keep
     spinnerFrame = 0; // current spinner animation frame
+    scrollOffset = 0; // 0 = live (bottom), >0 = scrolled back N entries
+    newWhileScrolled = 0; // entries added while user is scrolled back
+    pendingCount = 0; // queued user messages awaiting next tick
     // current state for repaints
     phase = "sleeping";
     pollCount = 0;
@@ -113,6 +116,8 @@ export class TUI {
             this.reasonerName = opts.reasonerName;
         if (opts.nextTickAt !== undefined)
             this.nextTickAt = opts.nextTickAt;
+        if (opts.pendingCount !== undefined)
+            this.pendingCount = opts.pendingCount;
         if (opts.sessions !== undefined) {
             const sessionCountChanged = opts.sessions.length !== this.sessions.length;
             this.sessions = opts.sessions;
@@ -139,8 +144,16 @@ export class TUI {
         if (this.activityBuffer.length > this.maxActivity) {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
         }
-        if (this.active)
-            this.writeActivityLine(entry);
+        if (this.active) {
+            if (this.scrollOffset > 0) {
+                // user is scrolled back — don't auto-scroll, just show indicator
+                this.newWhileScrolled++;
+                this.paintSeparator();
+            }
+            else {
+                this.writeActivityLine(entry);
+            }
+        }
         // persist to disk (fire-and-forget, never blocks)
         appendHistoryEntry({ ts: now.getTime(), time, tag, text });
     }
@@ -155,6 +168,48 @@ export class TUI {
             this.activityBuffer = this.activityBuffer.slice(-this.maxActivity);
         }
     }
+    // ── Scroll navigation ────────────────────────────────────────────────────
+    scrollUp(lines) {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const maxOffset = Math.max(0, this.activityBuffer.length - visibleLines);
+        this.scrollOffset = Math.min(maxOffset, this.scrollOffset + n);
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollDown(lines) {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const n = lines ?? Math.max(1, Math.floor(visibleLines / 2));
+        const wasScrolled = this.scrollOffset > 0;
+        this.scrollOffset = Math.max(0, this.scrollOffset - n);
+        if (wasScrolled && this.scrollOffset === 0)
+            this.newWhileScrolled = 0;
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollToTop() {
+        if (!this.active)
+            return;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        this.scrollOffset = Math.max(0, this.activityBuffer.length - visibleLines);
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    scrollToBottom() {
+        if (!this.active)
+            return;
+        this.scrollOffset = 0;
+        this.newWhileScrolled = 0;
+        this.repaintActivityRegion();
+        this.paintSeparator();
+    }
+    isScrolledBack() {
+        return this.scrollOffset > 0;
+    }
     // ── Layout computation ──────────────────────────────────────────────────
     updateDimensions() {
         this.cols = process.stderr.columns || 80;
@@ -245,8 +300,14 @@ export class TUI {
         process.stderr.write(RESTORE_CURSOR);
     }
     paintSeparator() {
-        const hints = " esc esc: interrupt  /help  /explain  /pause ";
         const prefix = `${BOX.h}${BOX.h} activity `;
+        let hints;
+        if (this.scrollOffset > 0) {
+            hints = formatScrollIndicator(this.scrollOffset, this.activityBuffer.length, this.scrollBottom - this.scrollTop + 1, this.newWhileScrolled);
+        }
+        else {
+            hints = " esc esc: interrupt  /help  /explain  /pause ";
+        }
         const totalLen = prefix.length + hints.length;
         const fill = Math.max(0, this.cols - totalLen);
         const left = Math.floor(fill / 2);
@@ -265,7 +326,8 @@ export class TUI {
     }
     repaintActivityRegion() {
         const visibleLines = this.scrollBottom - this.scrollTop + 1;
-        const entries = this.activityBuffer.slice(-visibleLines);
+        const { start, end } = computeScrollSlice(this.activityBuffer.length, visibleLines, this.scrollOffset);
+        const entries = this.activityBuffer.slice(start, end);
         for (let i = 0; i < visibleLines; i++) {
             const row = this.scrollTop + i;
             if (i < entries.length) {
@@ -278,12 +340,7 @@ export class TUI {
         }
     }
     paintInputLine() {
-        // phase-aware prompt styling
-        const prompt = this.paused
-            ? `${AMBER}${BOLD}paused >${RESET} `
-            : this.phase === "reasoning"
-                ? `${SKY}thinking >${RESET} `
-                : `${LIME}>${RESET} `;
+        const prompt = formatPrompt(this.phase, this.paused, this.pendingCount);
         process.stderr.write(SAVE_CURSOR +
             moveTo(this.inputRow, 1) + CLEAR_LINE + prompt +
             RESTORE_CURSOR);
@@ -431,6 +488,29 @@ export function formatSessionSentence(s, maxCols) {
     }
     return truncateAnsi(`${dot} ${BOLD}${name}${RESET} ${tool} ${SLATE}—${RESET} ${statusDesc}`, maxCols);
 }
+// ── Prompt helpers (pure, exported for testing) ─────────────────────────────
+// format the input prompt based on phase, pause state, and pending queue count
+function formatPrompt(phase, paused, pendingCount) {
+    const queueTag = pendingCount > 0 ? `${AMBER}${pendingCount} queued${RESET} ` : "";
+    if (paused)
+        return `${queueTag}${AMBER}${BOLD}paused >${RESET} `;
+    if (phase === "reasoning")
+        return `${queueTag}${SKY}thinking >${RESET} `;
+    return `${queueTag}${LIME}>${RESET} `;
+}
+// ── Scroll helpers (pure, exported for testing) ─────────────────────────────
+// compute the slice indices for the activity buffer given scroll state
+function computeScrollSlice(bufferLen, visibleLines, scrollOffset) {
+    const end = Math.max(0, bufferLen - scrollOffset);
+    const start = Math.max(0, end - visibleLines);
+    return { start, end };
+}
+// format the scroll indicator text for the separator bar
+function formatScrollIndicator(offset, totalEntries, visibleLines, newCount) {
+    const position = totalEntries - offset;
+    const newTag = newCount > 0 ? `  ${newCount} new ↓` : "";
+    return ` ↑ ${offset} older  │  ${position}/${totalEntries}  │  PgUp/PgDn  End=live${newTag} `;
+}
 // ── Exported pure helpers (for testing) ─────────────────────────────────────
-export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay };
+export { formatActivity, formatSessionCard, truncateAnsi, truncatePlain, padBoxLine, padToWidth, stripAnsiForLen, phaseDisplay, computeScrollSlice, formatScrollIndicator, formatPrompt };
 //# sourceMappingURL=tui.js.map

package/package.json

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