aoaoe 0.146.0 → 0.149.0

package/dist/index.js

@@ -1023,6 +1023,45 @@ async function main() {
             tui.log("system", `quiet hours: ${specs.join(", ")} — watchdog+burn alerts suppressed`);
             persistPrefs();
         });
+        // wire /budget cost alerts
+        input.onBudget((target, budgetUSD) => {
+            if (budgetUSD === null) {
+                // clear global budget
+                tui.setGlobalBudget(null);
+                tui.log("system", "budget: global budget cleared");
+                return;
+            }
+            if (target === null) {
+                tui.setGlobalBudget(budgetUSD);
+                tui.log("system", `budget: global budget set to $${budgetUSD.toFixed(2)}`);
+                return;
+            }
+            const num = /^\d+$/.test(target) ? parseInt(target, 10) : undefined;
+            const ok = tui.setSessionBudget(num ?? target, budgetUSD);
+            if (ok)
+                tui.log("system", `budget: $${budgetUSD.toFixed(2)} set for ${target}`);
+            else
+                tui.log("system", `session not found: ${target}`);
+        });
+        // wire /pause-all and /resume-all
+        input.onBulkControl((action) => {
+            const sessions = tui.getSessions();
+            if (sessions.length === 0) {
+                tui.log("system", `${action}-all: no sessions`);
+                return;
+            }
+            // ESC for pause, Enter for resume (nudge sessions out of waiting)
+            const keys = action === "pause" ? "Escape" : "Enter";
+            let count = 0;
+            for (const s of sessions) {
+                const tmuxName = computeTmuxName(s.title, s.id);
+                shellExec("tmux", ["send-keys", "-t", tmuxName, "", keys])
+                    .then(() => { })
+                    .catch((_e) => { });
+                count++;
+            }
+            tui.log("system", `${action}-all: sent to ${count} session${count !== 1 ? "s" : ""}`);
+        });
         // wire /quiet-status
         input.onQuietStatus(() => {
             const { active, message } = formatQuietStatus(tui.getQuietHours());

package/dist/input.d.ts

@@ -56,6 +56,8 @@ export type CostSummaryHandler = () => void;
 export type SessionReportHandler = (target: string) => void;
 export type QuietStatusHandler = () => void;
 export type AlertLogHandler = (count: number) => void;
+export type BudgetHandler = (target: string | null, budgetUSD: number | null) => void;
+export type BulkControlHandler = (action: "pause" | "resume") => void;
 export interface MouseEvent {
     button: number;
     col: number;
@@ -134,6 +136,8 @@ export declare class InputReader {
     private sessionReportHandler;
     private quietStatusHandler;
     private alertLogHandler;
+    private budgetHandler;
+    private bulkControlHandler;
     private aliases;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
@@ -195,6 +199,8 @@ export declare class InputReader {
     onSessionReport(handler: SessionReportHandler): void;
     onQuietStatus(handler: QuietStatusHandler): void;
     onAlertLog(handler: AlertLogHandler): void;
+    onBudget(handler: BudgetHandler): void;
+    onBulkControl(handler: BulkControlHandler): void;
     /** Set aliases from persisted prefs. */
     setAliases(aliases: Record<string, string>): void;
     /** Get current aliases as a plain object. */

package/dist/input.js

@@ -89,6 +89,8 @@ export class InputReader {
     sessionReportHandler = null;
     quietStatusHandler = null;
     alertLogHandler = null;
+    budgetHandler = null;
+    bulkControlHandler = null;
     aliases = new Map(); // /shortcut → /full command
     mouseDataListener = null;
     // register a callback for scroll key events (PgUp/PgDn/Home/End)
@@ -303,6 +305,8 @@ export class InputReader {
     onSessionReport(handler) { this.sessionReportHandler = handler; }
     onQuietStatus(handler) { this.quietStatusHandler = handler; }
     onAlertLog(handler) { this.alertLogHandler = handler; }
+    onBudget(handler) { this.budgetHandler = handler; }
+    onBulkControl(handler) { this.bulkControlHandler = handler; }
     /** Set aliases from persisted prefs. */
     setAliases(aliases) {
         this.aliases.clear();
@@ -565,6 +569,9 @@ ${BOLD}navigation:${RESET}
   /color-all [c]     set accent color for all sessions (no color = clear all)
   /quiet-hours [H-H] suppress watchdog+burn alerts during hours (e.g. 22-06; no arg = clear)
   /quiet-status      show whether quiet hours are currently active
+  /budget [N] [$]    set cost budget: /budget 1 2.50 (session), /budget 2.50 (global), /budget clear
+  /pause-all         send interrupt to all sessions
+  /resume-all        send resume to all sessions
   /alert-log [N]     show last N auto-generated alerts (burn-rate/watchdog/ceiling; default 20)
   /history-stats     show aggregate statistics from persisted activity history
   /cost-summary      show total estimated spend across all sessions
@@ -1121,6 +1128,46 @@ ${BOLD}other:${RESET}
                     console.error(`${DIM}history-stats not available (no TUI)${RESET}`);
                 }
                 break;
+            case "/budget": {
+                const bArgs = line.slice("/budget".length).trim().split(/\s+/).filter(Boolean);
+                if (bArgs.length === 0 || bArgs[0] === "clear") {
+                    // clear global budget
+                    if (this.budgetHandler)
+                        this.budgetHandler(null, null);
+                    else
+                        console.error(`${DIM}budget not available${RESET}`);
+                    break;
+                }
+                if (this.budgetHandler) {
+                    // /budget <$N> → global, /budget <N|name> <$N> → per-session
+                    const maybeUSD = parseFloat(bArgs[bArgs.length - 1].replace("$", ""));
+                    if (!isNaN(maybeUSD) && bArgs.length === 1) {
+                        this.budgetHandler(null, maybeUSD); // global
+                    }
+                    else if (!isNaN(maybeUSD) && bArgs.length >= 2) {
+                        this.budgetHandler(bArgs[0], maybeUSD); // per-session
+                    }
+                    else {
+                        console.error(`${DIM}usage: /budget [$N.NN] — global, /budget <N|name> $N.NN — per-session, /budget clear — remove${RESET}`);
+                    }
+                }
+                else {
+                    console.error(`${DIM}budget not available${RESET}`);
+                }
+                break;
+            }
+            case "/pause-all":
+                if (this.bulkControlHandler)
+                    this.bulkControlHandler("pause");
+                else
+                    console.error(`${DIM}pause-all not available${RESET}`);
+                break;
+            case "/resume-all":
+                if (this.bulkControlHandler)
+                    this.bulkControlHandler("resume");
+                else
+                    console.error(`${DIM}resume-all not available${RESET}`);
+                break;
             case "/quiet-status":
                 if (this.quietStatusHandler)
                     this.quietStatusHandler();

package/dist/tui.d.ts

@@ -180,6 +180,10 @@ export interface SessionReportData {
 }
 /** Format a session report as a Markdown document. */
 export declare function formatSessionReport(data: SessionReportData): string;
+/** Check if a cost string exceeds a budget value. Returns true when over budget. */
+export declare function isOverBudget(costStr: string | undefined, budgetUSD: number): boolean;
+/** Format a budget-exceeded alert message. */
+export declare function formatBudgetAlert(title: string, costStr: string, budgetUSD: number): string;
 /**
  * Build args for duplicating a session: given a source session, return
  * { path, tool, title } for use in a create_agent action.
@@ -408,6 +412,9 @@ export declare class TUI {
     private quietHoursRanges;
     private sessionHealthHistory;
     private alertLog;
+    private sessionBudgets;
+    private globalBudget;
+    private budgetAlerted;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -539,6 +546,16 @@ export declare class TUI {
         tool: string;
         title: string;
     } | null;
+    /** Set a per-session budget in USD. Pass null to clear. */
+    setSessionBudget(sessionIdOrIndex: string | number, budgetUSD: number | null): boolean;
+    /** Set global fallback budget (applies to all sessions without per-session budget). */
+    setGlobalBudget(budgetUSD: number | null): void;
+    /** Get the per-session budget (or null). */
+    getSessionBudget(id: string): number | null;
+    /** Get the global budget (or null if not set). */
+    getGlobalBudget(): number | null;
+    /** Return all per-session budgets. */
+    getAllSessionBudgets(): ReadonlyMap<string, number>;
     /** Return health history for a session (for sparkline). */
     getSessionHealthHistory(id: string): readonly HealthSnapshot[];
     /** Return all alert log entries (last 100 "status" tag entries). */
@@ -691,7 +708,7 @@ export declare class TUI {
     private repaintDrilldownContent;
     private paintInputLine;
 }
-declare function formatSessionCard(s: DaemonSessionState, maxWidth: number, errorSparkline?: string, idleSinceMs?: number, healthBadge?: string, displayName?: string): string;
+declare function formatSessionCard(s: DaemonSessionState, maxWidth: number, errorSparkline?: string, idleSinceMs?: number, healthBadge?: string, displayName?: string, ageStr?: string): string;
 declare function formatActivity(entry: ActivityEntry, maxCols: number): string;
 declare function padBoxLine(line: string, totalWidth: number): string;
 declare function padBoxLineHover(line: string, totalWidth: number, hovered: boolean): string;

package/dist/tui.js

@@ -518,6 +518,18 @@ export function formatSessionReport(data) {
     }
     return lines.join("\n");
 }
+// ── Session cost budget (pure, exported for testing) ─────────────────────────
+/** Check if a cost string exceeds a budget value. Returns true when over budget. */
+export function isOverBudget(costStr, budgetUSD) {
+    if (!costStr)
+        return false;
+    const val = parseCostValue(costStr);
+    return val !== null && val > budgetUSD;
+}
+/** Format a budget-exceeded alert message. */
+export function formatBudgetAlert(title, costStr, budgetUSD) {
+    return `${title}: cost ${costStr} exceeded budget $${budgetUSD.toFixed(2)}`;
+}
 // ── Duplicate session helpers (pure, exported for testing) ───────────────────
 /**
  * Build args for duplicating a session: given a source session, return
@@ -726,6 +738,7 @@ export const BUILTIN_COMMANDS = new Set([
     "/group", "/groups", "/group-filter", "/burn-rate", "/snapshot", "/broadcast", "/watchdog", "/top", "/ceiling", "/rename", "/copy", "/stats", "/recall", "/pin-all-errors", "/export-stats",
     "/mute-errors", "/prev-goal", "/tag", "/tags", "/tag-filter", "/find", "/reset-health", "/timeline", "/color", "/clear-history",
     "/duplicate", "/color-all", "/quiet-hours", "/quiet-status", "/history-stats", "/cost-summary", "/session-report", "/alert-log",
+    "/budget", "/pause-all", "/resume-all",
 ]);
 /** Resolve a slash command through the alias map. Returns the expanded command or the original. */
 export function resolveAlias(line, aliases) {
@@ -999,6 +1012,9 @@ export class TUI {
     quietHoursRanges = []; // quiet-hour start/end pairs
     sessionHealthHistory = new Map(); // session ID → health snapshots
     alertLog = []; // recent auto-generated status alerts (ring buffer, max 100)
+    sessionBudgets = new Map(); // session ID → USD budget
+    globalBudget = null; // global fallback budget in USD
+    budgetAlerted = new Map(); // session ID → epoch ms of last budget alert
     // drill-down mode: show a single session's full output
     viewMode = "overview";
     drilldownSessionId = null;
@@ -1471,6 +1487,42 @@ export class TUI {
         return buildDuplicateArgs(this.sessions, sessionIdOrIndex, newTitle);
     }
     // ── Session timeline ─────────────────────────────────────────────────────
+    // ── Session cost budget ──────────────────────────────────────────────────
+    /** Set a per-session budget in USD. Pass null to clear. */
+    setSessionBudget(sessionIdOrIndex, budgetUSD) {
+        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 (budgetUSD === null)
+            this.sessionBudgets.delete(sessionId);
+        else
+            this.sessionBudgets.set(sessionId, budgetUSD);
+        return true;
+    }
+    /** Set global fallback budget (applies to all sessions without per-session budget). */
+    setGlobalBudget(budgetUSD) {
+        this.globalBudget = budgetUSD;
+    }
+    /** Get the per-session budget (or null). */
+    getSessionBudget(id) {
+        return this.sessionBudgets.get(id) ?? null;
+    }
+    /** Get the global budget (or null if not set). */
+    getGlobalBudget() {
+        return this.globalBudget;
+    }
+    /** Return all per-session budgets. */
+    getAllSessionBudgets() {
+        return this.sessionBudgets;
+    }
     /** Return health history for a session (for sparkline). */
     getSessionHealthHistory(id) {
         return this.sessionHealthHistory.get(id) ?? [];
@@ -1803,9 +1855,18 @@ export class TUI {
                 }
                 if (s.lastActivity !== undefined)
                     this.prevLastActivity.set(s.id, s.lastActivity);
-                // track cost string
-                if (s.costStr)
+                // track cost string + check budget
+                if (s.costStr) {
                     this.sessionCosts.set(s.id, s.costStr);
+                    const budget = this.sessionBudgets.get(s.id) ?? this.globalBudget;
+                    if (budget !== null && isOverBudget(s.costStr, budget) && !quietNow) {
+                        const lastAlert = this.budgetAlerted.get(s.id) ?? 0;
+                        if (now - lastAlert >= 5 * 60_000) {
+                            this.budgetAlerted.set(s.id, now);
+                            this.log("status", formatBudgetAlert(s.title, s.costStr, budget), s.id);
+                        }
+                    }
+                }
                 // track context token history for burn-rate alerts
                 const tokens = parseContextTokenNumber(s.contextTokens);
                 if (tokens !== null) {
@@ -2394,7 +2455,8 @@ export class TUI {
                 const badgeSuffix = muteBadge ? `${muteBadge} ` : "";
                 const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0) + (noted ? 2 : 0) + actualBadgeWidth + groupBadgeWidth + tagsBadgeWidth + colorDotWidth;
                 const cardWidth = innerWidth - 1 - iconsWidth;
-                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${badgeSuffix}${note}${groupBadge}${tagsBadge}${colorDot}${formatSessionCard(s, cardWidth, errSparkline || undefined, idleSinceMs, healthBadge || undefined, displayName)}`;
+                const cardAge = s.createdAt ? formatSessionAge(s.createdAt, nowMs) : undefined;
+                const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${badgeSuffix}${note}${groupBadge}${tagsBadge}${colorDot}${formatSessionCard(s, cardWidth, errSparkline || undefined, idleSinceMs, healthBadge || undefined, displayName, cardAge || undefined)}`;
                 const padded = padBoxLineHover(line, this.cols, isHovered);
                 process.stderr.write(moveTo(startRow + 1 + i, 1) + CLEAR_LINE + padded);
             }
@@ -2464,7 +2526,8 @@ export class TUI {
         const badgeSuffix = muteBadge ? `${muteBadge} ` : "";
         const iconsWidth = (pinned ? 2 : 0) + (muted ? 2 : 0) + (noted ? 2 : 0) + actualBadgeWidth + groupBadgeWidth + tagsBadgeWidth2 + colorDotWidth2;
         const cardWidth = innerWidth - 1 - iconsWidth;
-        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${badgeSuffix}${note}${groupBadge}${tagsBadge2}${colorDot2}${formatSessionCard(s, cardWidth, errSparkline || undefined, idleSinceMs, healthBadge2 || undefined, displayName2)}`;
+        const cardAge2 = s.createdAt ? formatSessionAge(s.createdAt, nowMs2) : undefined;
+        const line = `${bg}${SLATE}${BOX.v}${RESET}${bg} ${pin}${mute}${badgeSuffix}${note}${groupBadge}${tagsBadge2}${colorDot2}${formatSessionCard(s, cardWidth, errSparkline || undefined, idleSinceMs, healthBadge2 || undefined, displayName2, cardAge2 || undefined)}`;
         const padded = padBoxLineHover(line, this.cols, isHovered);
         process.stderr.write(SAVE_CURSOR + moveTo(startRow + 1 + i, 1) + CLEAR_LINE + padded + RESTORE_CURSOR);
     }
@@ -2582,7 +2645,8 @@ export class TUI {
 // idleSinceMs: optional ms since last activity change (shown when idle/stopped)
 // healthBadge: optional pre-formatted health score badge ("⬡83" colored)
 // displayName: optional custom name override (from /rename)
-function formatSessionCard(s, maxWidth, errorSparkline, idleSinceMs, healthBadge, displayName) {
+// ageStr: optional session age string (from createdAt)
+function formatSessionCard(s, maxWidth, errorSparkline, idleSinceMs, healthBadge, displayName, ageStr) {
     const dot = STATUS_DOT[s.status] ?? `${AMBER}${DOT.filled}${RESET}`;
     const title = displayName ?? s.title;
     const name = displayName ? `${BOLD}${displayName}${DIM} (${s.title})${RESET}` : `${BOLD}${s.title}${RESET}`;
@@ -2622,7 +2686,8 @@ function formatSessionCard(s, maxWidth, errorSparkline, idleSinceMs, healthBadge
     else {
         desc = `${SLATE}${s.status}${RESET}`;
     }
-    return truncateAnsi(`${dot} ${healthPrefix}${name} ${toolBadge}${contextBadge} ${SLATE}${BOX.h}${RESET} ${desc}${sparkSuffix}`, maxWidth);
+    const ageSuffix = ageStr ? ` ${DIM}age:${ageStr}${RESET}` : "";
+    return truncateAnsi(`${dot} ${healthPrefix}${name} ${toolBadge}${contextBadge} ${SLATE}${BOX.h}${RESET} ${desc}${ageSuffix}${sparkSuffix}`, maxWidth);
 }
 // colorize an activity entry based on its tag
 function formatActivity(entry, maxCols) {

package/package.json

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