aoaoe 0.82.0 → 0.83.0

package/dist/index.js

@@ -378,6 +378,38 @@ async function main() {
             tui.setCompact(enabled);
             tui.log("system", `compact mode: ${enabled ? "on" : "off"}`);
         });
+        // wire /mark bookmark
+        input.onMark(() => {
+            const num = tui.addBookmark();
+            if (num > 0) {
+                tui.log("system", `bookmark #${num} saved`);
+            }
+            else {
+                tui.log("system", "nothing to bookmark (activity buffer empty)");
+            }
+        });
+        // wire /jump to bookmark
+        input.onJump((num) => {
+            const ok = tui.jumpToBookmark(num);
+            if (ok) {
+                tui.log("system", `jumped to bookmark #${num}`);
+            }
+            else {
+                tui.log("system", `bookmark #${num} not found`);
+            }
+        });
+        // wire /marks listing
+        input.onMarks(() => {
+            const bms = tui.getBookmarks();
+            if (bms.length === 0) {
+                tui.log("system", "no bookmarks — use /mark to save one");
+            }
+            else {
+                for (let i = 0; i < bms.length; i++) {
+                    tui.log("system", `  #${i + 1}: ${bms[i].label}`);
+                }
+            }
+        });
         // wire /focus toggle
         input.onFocus(() => {
             const enabled = !tui.isFocused();

package/dist/input.d.ts

@@ -8,6 +8,9 @@ export type CompactHandler = () => void;
 export type PinHandler = (target: string) => void;
 export type BellHandler = () => void;
 export type FocusHandler = () => void;
+export type MarkHandler = () => void;
+export type JumpHandler = (num: number) => void;
+export type MarksHandler = () => void;
 export interface MouseEvent {
     button: number;
     col: number;
@@ -38,6 +41,9 @@ export declare class InputReader {
     private pinHandler;
     private bellHandler;
     private focusHandler;
+    private markHandler;
+    private jumpHandler;
+    private marksHandler;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
     onQueueChange(handler: (count: number) => void): void;
@@ -52,6 +58,9 @@ export declare class InputReader {
     onPin(handler: PinHandler): void;
     onBell(handler: BellHandler): void;
     onFocus(handler: FocusHandler): void;
+    onMark(handler: MarkHandler): void;
+    onJump(handler: JumpHandler): void;
+    onMarks(handler: MarksHandler): void;
     private notifyQueueChange;
     start(): void;
     drain(): string[];

package/dist/input.js

@@ -40,6 +40,9 @@ export class InputReader {
     pinHandler = null;
     bellHandler = null;
     focusHandler = null;
+    markHandler = null;
+    jumpHandler = null;
+    marksHandler = null;
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
     onScroll(handler) {
@@ -93,6 +96,18 @@ export class InputReader {
     onFocus(handler) {
         this.focusHandler = handler;
     }
+    // register a callback for adding bookmarks (/mark)
+    onMark(handler) {
+        this.markHandler = handler;
+    }
+    // register a callback for jumping to bookmarks (/jump N)
+    onJump(handler) {
+        this.jumpHandler = handler;
+    }
+    // register a callback for listing bookmarks (/marks)
+    onMarks(handler) {
+        this.marksHandler = handler;
+    }
     notifyQueueChange() {
         this.queueChangeHandler?.(this.queue.length);
     }
@@ -275,6 +290,9 @@ ${BOLD}navigation:${RESET}
   /pin [N|name]      pin/unpin a session to the top (toggle)
   /bell              toggle terminal bell on errors/completions
   /focus             toggle focus mode (show only pinned sessions)
+  /mark              bookmark current activity position
+  /jump N            jump to bookmark N
+  /marks             list all bookmarks
   /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)
@@ -403,6 +421,36 @@ ${BOLD}other:${RESET}
                     console.error(`${DIM}focus not available (no TUI)${RESET}`);
                 }
                 break;
+            case "/mark":
+                if (this.markHandler) {
+                    this.markHandler();
+                }
+                else {
+                    console.error(`${DIM}bookmarks not available (no TUI)${RESET}`);
+                }
+                break;
+            case "/jump": {
+                const jumpArg = line.slice("/jump".length).trim();
+                const jumpNum = parseInt(jumpArg, 10);
+                if (this.jumpHandler && !isNaN(jumpNum) && jumpNum > 0) {
+                    this.jumpHandler(jumpNum);
+                }
+                else if (!this.jumpHandler) {
+                    console.error(`${DIM}bookmarks not available (no TUI)${RESET}`);
+                }
+                else {
+                    console.error(`${DIM}usage: /jump N — jump to bookmark number N${RESET}`);
+                }
+                break;
+            }
+            case "/marks":
+                if (this.marksHandler) {
+                    this.marksHandler();
+                }
+                else {
+                    console.error(`${DIM}bookmarks not available (no TUI)${RESET}`);
+                }
+                break;
             case "/search": {
                 const searchArg = line.slice("/search".length).trim();
                 if (this.searchHandler) {

package/dist/tui.d.ts

@@ -10,6 +10,18 @@ declare function nextSortMode(current: SortMode): SortMode;
 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;
+export interface Bookmark {
+    index: number;
+    label: string;
+}
+/** Max number of bookmarks. */
+export declare const MAX_BOOKMARKS = 20;
+/**
+ * Compute the scroll offset needed to show a bookmarked entry.
+ * Centers the entry in the visible region when possible.
+ * Returns 0 (live) if the entry is within the visible tail.
+ */
+export declare function computeBookmarkOffset(bookmarkIndex: number, bufferLen: number, visibleLines: number): number;
 /** Max name length in compact token. */
 declare const COMPACT_NAME_LEN = 10;
 /** Pin indicator for pinned sessions. */
@@ -54,6 +66,7 @@ export declare class TUI {
     private compactMode;
     private pinnedIds;
     private focusMode;
+    private bookmarks;
     private bellEnabled;
     private lastBellAt;
     private viewMode;
@@ -100,6 +113,20 @@ export declare class TUI {
     setBell(enabled: boolean): void;
     /** Return whether terminal bell is enabled. */
     isBellEnabled(): boolean;
+    /**
+     * Add a bookmark at the current activity position.
+     * Returns the bookmark number (1-indexed) or 0 if buffer is empty.
+     */
+    addBookmark(): number;
+    /**
+     * Jump to a bookmark by number (1-indexed). Returns false if not found.
+     * Adjusts scroll offset to center the bookmarked entry.
+     */
+    jumpToBookmark(num: number): boolean;
+    /** Return all bookmarks (for /marks listing). */
+    getBookmarks(): readonly Bookmark[];
+    /** Return bookmark count. */
+    getBookmarkCount(): number;
     updateState(opts: {
         phase?: DaemonPhase;
         pollCount?: number;

package/dist/tui.js

@@ -63,6 +63,23 @@ export function shouldBell(tag, text) {
         return true;
     return false;
 }
+/** Max number of bookmarks. */
+export const MAX_BOOKMARKS = 20;
+/**
+ * Compute the scroll offset needed to show a bookmarked entry.
+ * Centers the entry in the visible region when possible.
+ * Returns 0 (live) if the entry is within the visible tail.
+ */
+export function computeBookmarkOffset(bookmarkIndex, bufferLen, visibleLines) {
+    // entry position from the end of the buffer
+    const fromEnd = bufferLen - 1 - bookmarkIndex;
+    // if entry is within the visible tail, no scroll needed
+    if (fromEnd < visibleLines)
+        return 0;
+    // center the entry in the visible region
+    const half = Math.floor(visibleLines / 2);
+    return Math.max(0, fromEnd - half);
+}
 // ── Compact mode ────────────────────────────────────────────────────────────
 /** Max name length in compact token. */
 const COMPACT_NAME_LEN = 10;
@@ -162,6 +179,7 @@ export class TUI {
     compactMode = false;
     pinnedIds = new Set(); // pinned session IDs (always sort to top)
     focusMode = false; // focus mode: hide all sessions except pinned
+    bookmarks = []; // saved positions in activity buffer
     bellEnabled = false;
     lastBellAt = 0;
     // drill-down mode: show a single session's full output
@@ -319,6 +337,55 @@ export class TUI {
     isBellEnabled() {
         return this.bellEnabled;
     }
+    /**
+     * Add a bookmark at the current activity position.
+     * Returns the bookmark number (1-indexed) or 0 if buffer is empty.
+     */
+    addBookmark() {
+        if (this.activityBuffer.length === 0)
+            return 0;
+        // bookmark the entry at the current view position
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        const { start } = computeScrollSlice(this.activityBuffer.length, visibleLines, this.scrollOffset);
+        const entry = this.activityBuffer[start];
+        if (!entry)
+            return 0;
+        const bm = { index: start, label: `${entry.time} ${entry.tag}` };
+        this.bookmarks.push(bm);
+        if (this.bookmarks.length > MAX_BOOKMARKS) {
+            this.bookmarks = this.bookmarks.slice(-MAX_BOOKMARKS);
+        }
+        return this.bookmarks.length;
+    }
+    /**
+     * Jump to a bookmark by number (1-indexed). Returns false if not found.
+     * Adjusts scroll offset to center the bookmarked entry.
+     */
+    jumpToBookmark(num) {
+        const bm = this.bookmarks[num - 1];
+        if (!bm)
+            return false;
+        // clamp index to current buffer
+        if (bm.index >= this.activityBuffer.length)
+            return false;
+        const visibleLines = this.scrollBottom - this.scrollTop + 1;
+        this.scrollOffset = computeBookmarkOffset(bm.index, this.activityBuffer.length, visibleLines);
+        if (this.scrollOffset === 0)
+            this.newWhileScrolled = 0;
+        if (this.active && this.viewMode === "overview") {
+            this.repaintActivityRegion();
+            this.paintSeparator();
+        }
+        return true;
+    }
+    /** Return all bookmarks (for /marks listing). */
+    getBookmarks() {
+        return this.bookmarks;
+    }
+    /** Return bookmark count. */
+    getBookmarkCount() {
+        return this.bookmarks.length;
+    }
     // ── State updates ───────────────────────────────────────────────────────
     updateState(opts) {
         if (opts.phase !== undefined)

package/package.json

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