aoaoe 0.142.0 → 0.149.0

package/dist/daemon-state.js

@@ -148,6 +148,7 @@ export function buildSessionStates(obs) {
             tool: s.tool,
             status: s.status,
             path: snap.session.path,
+            createdAt: snap.session.created_at,
             currentTask: sessionTasks.get(s.id),
             lastActivity: lastActivity && lastActivity.length > 100
                 ? lastActivity.slice(0, 97) + "..."

package/dist/index.js

@@ -16,7 +16,7 @@ import { wakeableSleep } from "./wake.js";
 import { classifyMessages, formatUserMessages, buildReceipts, shouldSkipSleep, hasPendingFile, isInsistMessage, stripInsistPrefix } from "./message.js";
 import { TaskManager, loadTaskDefinitions, loadTaskState, formatTaskTable, importAoeSessionsToTasks } from "./task-manager.js";
 import { runTaskCli, handleTaskSlashCommand, quickTaskUpdate } from "./task-cli.js";
-import { TUI, hitTestSession, nextSortMode, SORT_MODES, formatUptime, formatClipText, loadTuiPrefs, saveTuiPrefs, validateGroupName, CONTEXT_BURN_THRESHOLD, buildSnapshotData, formatSnapshotJson, formatSnapshotMarkdown, formatBroadcastSummary, rankSessions, TOP_SORT_MODES, formatIdleSince, CONTEXT_CEILING_THRESHOLD, buildSessionStats, formatSessionStatsLines, formatStatsJson, validateSessionTag, validateColorName, computeErrorTrend, parseQuietHoursRange, computeCostSummary, formatSessionReport } from "./tui.js";
+import { TUI, hitTestSession, nextSortMode, SORT_MODES, formatUptime, formatClipText, loadTuiPrefs, saveTuiPrefs, validateGroupName, CONTEXT_BURN_THRESHOLD, buildSnapshotData, formatSnapshotJson, formatSnapshotMarkdown, formatBroadcastSummary, rankSessions, TOP_SORT_MODES, formatIdleSince, CONTEXT_CEILING_THRESHOLD, buildSessionStats, formatSessionStatsLines, formatStatsJson, validateSessionTag, validateColorName, computeErrorTrend, parseQuietHoursRange, computeCostSummary, formatSessionReport, formatQuietStatus, formatSessionAge } from "./tui.js";
 import { isDaemonRunningFromState } from "./chat.js";
 import { sendNotification, sendTestNotification } from "./notify.js";
 import { startHealthServer } from "./health.js";
@@ -606,7 +606,9 @@ async function main() {
                 const lastChange = lastChangeAt.get(s.id);
                 const idleStr = (lastChange && (s.status === "idle" || s.status === "stopped" || s.status === "done"))
                     ? ` idle ${formatUptime(now - lastChange)}` : "";
-                tui.log("system", `  ${s.title}${groupStr} — ${s.status} ${up}${ctxStr}${costStr}${errStr}${idleStr}${noteStr}`);
+                // session age from AoE created_at
+                const ageStr = s.createdAt ? ` age:${formatSessionAge(s.createdAt, now)}` : "";
+                tui.log("system", `  ${s.title}${groupStr} — ${s.status} ${up}${ctxStr}${costStr}${errStr}${idleStr}${ageStr}${noteStr}`);
             }
         });
         // wire /uptime listing
@@ -953,7 +955,7 @@ async function main() {
         input.onExportStats(() => {
             const sessions = tui.getSessions();
             const now = Date.now();
-            const entries = buildSessionStats(sessions, tui.getSessionErrorCounts(), tui.getAllBurnRates(now), tui.getAllFirstSeen(), tui.getAllLastChangeAt(), tui.getAllHealthScores(now), tui.getAllSessionAliases(), now, new Map(sessions.map((s) => [s.id, tui.getSessionErrorTimestamps(s.id)])), tui.getAllSessionCosts());
+            const entries = buildSessionStats(sessions, tui.getSessionErrorCounts(), tui.getAllBurnRates(now), tui.getAllFirstSeen(), tui.getAllLastChangeAt(), tui.getAllHealthScores(now), tui.getAllSessionAliases(), now, new Map(sessions.map((s) => [s.id, tui.getSessionErrorTimestamps(s.id)])), tui.getAllSessionCosts(), new Map(sessions.map((s) => [s.id, tui.getSessionHealthHistory(s.id)])));
             const ts = new Date(now).toISOString().replace(/[:.]/g, "-").slice(0, 19);
             const dir = join(homedir(), ".aoaoe");
             const path = join(dir, `stats-${ts}.json`);
@@ -1021,6 +1023,65 @@ 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());
+            tui.log("system", `quiet-status: ${message}`);
+            if (active)
+                tui.log("system", "  watchdog, burn-rate, and ceiling alerts are suppressed");
+        });
+        // wire /alert-log
+        input.onAlertLog((count) => {
+            const alerts = tui.getAlertLog();
+            const recent = alerts.slice(-count);
+            if (recent.length === 0) {
+                tui.log("system", "alert-log: no auto-generated alerts yet");
+                return;
+            }
+            tui.log("system", `alert-log: last ${recent.length} alert${recent.length !== 1 ? "s" : ""}:`);
+            for (const e of recent) {
+                tui.log("system", `  ${e.time}  ${e.text}`);
+            }
+        });
         // wire /cost-summary
         input.onCostSummary(() => {
             const sessions = tui.getSessions();
@@ -1133,7 +1194,7 @@ async function main() {
                 return;
             }
             const now = Date.now();
-            const entries = buildSessionStats(sessions, tui.getSessionErrorCounts(), tui.getAllBurnRates(now), tui.getAllFirstSeen(), tui.getAllLastChangeAt(), tui.getAllHealthScores(now), tui.getAllSessionAliases(), now, new Map(sessions.map((s) => [s.id, tui.getSessionErrorTimestamps(s.id)])), tui.getAllSessionCosts());
+            const entries = buildSessionStats(sessions, tui.getSessionErrorCounts(), tui.getAllBurnRates(now), tui.getAllFirstSeen(), tui.getAllLastChangeAt(), tui.getAllHealthScores(now), tui.getAllSessionAliases(), now, new Map(sessions.map((s) => [s.id, tui.getSessionErrorTimestamps(s.id)])), tui.getAllSessionCosts(), new Map(sessions.map((s) => [s.id, tui.getSessionHealthHistory(s.id)])));
             tui.log("system", `/stats — ${entries.length} session${entries.length !== 1 ? "s" : ""}:`);
             for (const line of formatSessionStatsLines(entries)) {
                 tui.log("system", line);

package/dist/input.d.ts

@@ -54,6 +54,10 @@ export type QuietHoursHandler = (specs: string[]) => void;
 export type HistoryStatsHandler = () => void;
 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;
@@ -130,6 +134,10 @@ export declare class InputReader {
     private historyStatsHandler;
     private costSummaryHandler;
     private sessionReportHandler;
+    private quietStatusHandler;
+    private alertLogHandler;
+    private budgetHandler;
+    private bulkControlHandler;
     private aliases;
     private mouseDataListener;
     onScroll(handler: (dir: ScrollDirection) => void): void;
@@ -189,6 +197,10 @@ export declare class InputReader {
     onHistoryStats(handler: HistoryStatsHandler): void;
     onCostSummary(handler: CostSummaryHandler): void;
     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

@@ -87,6 +87,10 @@ export class InputReader {
     historyStatsHandler = null;
     costSummaryHandler = null;
     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)
@@ -299,6 +303,10 @@ export class InputReader {
     onHistoryStats(handler) { this.historyStatsHandler = handler; }
     onCostSummary(handler) { this.costSummaryHandler = handler; }
     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();
@@ -560,6 +568,11 @@ ${BOLD}navigation:${RESET}
   /duplicate N [t]   spawn a new session cloned from session N (same tool/path)
   /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
   /session-report N  generate full markdown report for a session → ~/.aoaoe/report-<name>-<ts>.md
@@ -1115,6 +1128,61 @@ ${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();
+                else
+                    console.error(`${DIM}quiet-status not available (no TUI)${RESET}`);
+                break;
+            case "/alert-log": {
+                const alN = parseInt(line.slice("/alert-log".length).trim() || "20", 10);
+                const alCount = isNaN(alN) || alN < 1 ? 20 : Math.min(alN, 200);
+                if (this.alertLogHandler)
+                    this.alertLogHandler(alCount);
+                else
+                    console.error(`${DIM}alert-log not available (no TUI)${RESET}`);
+                break;
+            }
             case "/cost-summary":
                 if (this.costSummaryHandler)
                     this.costSummaryHandler();

package/dist/tui.d.ts

@@ -111,6 +111,32 @@ export declare const TIMELINE_DEFAULT_COUNT = 30;
  * Returns up to `count` entries.
  */
 export declare function filterSessionTimeline(buffer: readonly ActivityEntry[], sessionId: string, count?: number): ActivityEntry[];
+/**
+ * Given quiet-hours ranges and current hour, return a human-readable status string.
+ * Returns { active, message } where message explains current state.
+ */
+export declare function formatQuietStatus(ranges: ReadonlyArray<[number, number]>, now?: Date): {
+    active: boolean;
+    message: string;
+};
+/**
+ * Parse a session creation time from an ISO 8601 string.
+ * Returns null if unparseable.
+ */
+export declare function parseSessionAge(createdAt: string | undefined, now?: number): number | null;
+/** Format session age as compact string: "3d", "2h", "45m", "< 1m". */
+export declare function formatSessionAge(createdAt: string | undefined, now?: number): string;
+/** Max health score snapshots stored per session. */
+export declare const MAX_HEALTH_HISTORY = 20;
+export interface HealthSnapshot {
+    score: number;
+    ts: number;
+}
+/**
+ * Format health history as a compact 5-bucket sparkline.
+ * Each bucket covers 1/5 of the history window. Color: LIME/AMBER/ROSE by value.
+ */
+export declare function formatHealthSparkline(history: readonly HealthSnapshot[], now?: number): string;
 /**
  * Parse a cost string like "$3.42" → 3.42, or null if unparseable.
  */
@@ -154,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.
@@ -208,13 +238,14 @@ export interface SessionStatEntry {
     burnRatePerMin: number | null;
     contextPct: number | null;
     costStr?: string;
+    healthSparkline?: string;
     uptimeMs: number | null;
     idleSinceMs: number | null;
 }
 /**
  * Build stats entries for all sessions — pure, testable, no side effects.
  */
-export declare function buildSessionStats(sessions: readonly DaemonSessionState[], errorCounts: ReadonlyMap<string, number>, burnRates: ReadonlyMap<string, number | null>, firstSeen: ReadonlyMap<string, number>, lastChangeAt: ReadonlyMap<string, number>, healthScores: ReadonlyMap<string, number>, sessionAliases: ReadonlyMap<string, string>, now?: number, errorTimestamps?: ReadonlyMap<string, readonly number[]>, sessionCosts?: ReadonlyMap<string, string>): SessionStatEntry[];
+export declare function buildSessionStats(sessions: readonly DaemonSessionState[], errorCounts: ReadonlyMap<string, number>, burnRates: ReadonlyMap<string, number | null>, firstSeen: ReadonlyMap<string, number>, lastChangeAt: ReadonlyMap<string, number>, healthScores: ReadonlyMap<string, number>, sessionAliases: ReadonlyMap<string, string>, now?: number, errorTimestamps?: ReadonlyMap<string, readonly number[]>, sessionCosts?: ReadonlyMap<string, string>, healthHistories?: ReadonlyMap<string, readonly HealthSnapshot[]>): SessionStatEntry[];
 /**
  * Format session stats entries as a multi-line activity-log-friendly string.
  * Each line is one session summary.
@@ -379,6 +410,11 @@ export declare class TUI {
     private sessionColors;
     private sessionCosts;
     private quietHoursRanges;
+    private sessionHealthHistory;
+    private alertLog;
+    private sessionBudgets;
+    private globalBudget;
+    private budgetAlerted;
     private viewMode;
     private drilldownSessionId;
     private sessionOutputs;
@@ -510,6 +546,20 @@ 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). */
+    getAlertLog(): readonly ActivityEntry[];
     /** Get the latest cost string for a session (or undefined). */
     getSessionCost(id: string): string | undefined;
     /** Return all session costs (for /stats). */
@@ -658,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

@@ -358,6 +358,76 @@ export function filterSessionTimeline(buffer, sessionId, count = TIMELINE_DEFAUL
     const matching = buffer.filter((e) => e.sessionId === sessionId);
     return matching.slice(-count);
 }
+// ── Quiet status (pure, exported for testing) ────────────────────────────────
+/**
+ * Given quiet-hours ranges and current hour, return a human-readable status string.
+ * Returns { active, message } where message explains current state.
+ */
+export function formatQuietStatus(ranges, now) {
+    if (ranges.length === 0)
+        return { active: false, message: "quiet hours not configured" };
+    const d = now ?? new Date();
+    const hour = d.getHours();
+    const active = isQuietHour(hour, ranges);
+    const rangeStrs = ranges.map(([s, e]) => `${String(s).padStart(2, "0")}:00–${String(e).padStart(2, "0")}:00`);
+    if (active) {
+        return { active: true, message: `quiet hours ACTIVE — alerts suppressed (${rangeStrs.join(", ")})` };
+    }
+    return { active: false, message: `quiet hours inactive — configured: ${rangeStrs.join(", ")}` };
+}
+// ── Session age (pure, exported for testing) ──────────────────────────────────
+/**
+ * Parse a session creation time from an ISO 8601 string.
+ * Returns null if unparseable.
+ */
+export function parseSessionAge(createdAt, now) {
+    if (!createdAt)
+        return null;
+    const ts = Date.parse(createdAt);
+    if (isNaN(ts))
+        return null;
+    return (now ?? Date.now()) - ts;
+}
+/** Format session age as compact string: "3d", "2h", "45m", "< 1m". */
+export function formatSessionAge(createdAt, now) {
+    const ms = parseSessionAge(createdAt, now);
+    if (ms === null)
+        return "";
+    return formatUptime(ms);
+}
+// ── Health history (pure, exported for testing) ───────────────────────────────
+/** Max health score snapshots stored per session. */
+export const MAX_HEALTH_HISTORY = 20;
+/**
+ * Format health history as a compact 5-bucket sparkline.
+ * Each bucket covers 1/5 of the history window. Color: LIME/AMBER/ROSE by value.
+ */
+export function formatHealthSparkline(history, now) {
+    if (history.length === 0)
+        return "";
+    const BUCKETS = 5;
+    const WINDOW_MS = 30 * 60_000; // last 30 minutes
+    const nowMs = now ?? Date.now();
+    const cutoff = nowMs - WINDOW_MS;
+    const recent = history.filter((h) => h.ts >= cutoff);
+    if (recent.length === 0)
+        return "";
+    const bucketMs = WINDOW_MS / BUCKETS;
+    const buckets = Array(BUCKETS).fill(-1); // -1 = no data
+    for (const h of recent) {
+        const idx = Math.min(BUCKETS - 1, Math.floor((h.ts - cutoff) / bucketMs));
+        // take the most recent reading per bucket
+        if (buckets[idx] === -1 || h.ts > (recent.find((r) => r.ts >= cutoff + idx * bucketMs)?.ts ?? 0)) {
+            buckets[idx] = h.score;
+        }
+    }
+    return buckets.map((score) => {
+        if (score === -1)
+            return `${DIM}·${RESET}`;
+        const color = score >= HEALTH_GOOD ? LIME : score >= HEALTH_WARN ? AMBER : ROSE;
+        return `${color}${SPARK_BLOCKS[Math.min(SPARK_BLOCKS.length - 1, Math.floor(score / 100 * (SPARK_BLOCKS.length - 1)))]}${RESET}`;
+    }).join("");
+}
 // ── Cost summary (pure, exported for testing) ────────────────────────────────
 /**
  * Parse a cost string like "$3.42" → 3.42, or null if unparseable.
@@ -448,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
@@ -574,7 +656,7 @@ export function formatSessionTagsBadge(tags) {
 /**
  * Build stats entries for all sessions — pure, testable, no side effects.
  */
-export function buildSessionStats(sessions, errorCounts, burnRates, firstSeen, lastChangeAt, healthScores, sessionAliases, now, errorTimestamps, sessionCosts) {
+export function buildSessionStats(sessions, errorCounts, burnRates, firstSeen, lastChangeAt, healthScores, sessionAliases, now, errorTimestamps, sessionCosts, healthHistories) {
     const nowMs = now ?? Date.now();
     return sessions.map((s) => {
         const ceiling = parseContextCeiling(s.contextTokens);
@@ -583,6 +665,8 @@ export function buildSessionStats(sessions, errorCounts, burnRates, firstSeen, l
         const lc = lastChangeAt.get(s.id);
         const errTs = errorTimestamps?.get(s.id);
         const errTrend = errTs ? computeErrorTrend(errTs, nowMs) : undefined;
+        const healthHist = healthHistories?.get(s.id);
+        const healthSparkline = healthHist ? formatHealthSparkline(healthHist, nowMs) : undefined;
         return {
             title: s.title,
             displayName: sessionAliases.get(s.id),
@@ -593,6 +677,7 @@ export function buildSessionStats(sessions, errorCounts, burnRates, firstSeen, l
             burnRatePerMin: burnRates.get(s.id) ?? null,
             contextPct: ctxPct,
             costStr: sessionCosts?.get(s.id),
+            healthSparkline: healthSparkline || undefined,
             uptimeMs: fs !== undefined ? nowMs - fs : null,
             idleSinceMs: lc !== undefined ? nowMs - lc : null,
         };
@@ -614,9 +699,10 @@ export function formatSessionStatsLines(entries) {
             ? ` ${Math.round(e.burnRatePerMin / 100) * 100}tok/min` : "";
         const ctxStr = e.contextPct !== null ? ` ctx:${e.contextPct}%` : "";
         const costStr = e.costStr ? ` ${e.costStr}` : "";
+        const sparkStr = e.healthSparkline ? ` ${e.healthSparkline}` : "";
         const upStr = e.uptimeMs !== null ? ` up:${formatUptime(e.uptimeMs)}` : "";
         const idleStr = e.idleSinceMs !== null ? ` ${formatIdleSince(e.idleSinceMs)}` : "";
-        return `  ${label} [${e.status}] ${healthStr}${errStr}${burnStr}${ctxStr}${costStr}${upStr}${idleStr}`;
+        return `  ${label} [${e.status}] ${healthStr}${sparkStr}${errStr}${burnStr}${ctxStr}${costStr}${upStr}${idleStr}`;
     });
 }
 /** Format session stats entries as a JSON object for export. */
@@ -651,7 +737,8 @@ export const BUILTIN_COMMANDS = new Set([
     "/jump", "/marks", "/search", "/alias", "/insist", "/task", "/tasks",
     "/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", "/history-stats", "/cost-summary", "/session-report",
+    "/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) {
@@ -923,6 +1010,11 @@ export class TUI {
     sessionColors = new Map(); // session ID → accent color name
     sessionCosts = new Map(); // session ID → latest cost string ("$N.NN")
     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;
@@ -1395,6 +1487,50 @@ 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) ?? [];
+    }
+    /** Return all alert log entries (last 100 "status" tag entries). */
+    getAlertLog() {
+        return this.alertLog;
+    }
     /** Get the latest cost string for a session (or undefined). */
     getSessionCost(id) {
         return this.sessionCosts.get(id);
@@ -1719,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) {
@@ -1773,6 +1918,27 @@ export class TUI {
                 if (!currentIds.has(id))
                     this.sessionContextHistory.delete(id);
             }
+            // record health snapshots
+            for (const s of opts.sessions) {
+                const ceiling2 = parseContextCeiling(s.contextTokens);
+                const cf2 = ceiling2 ? ceiling2.current / ceiling2.max : null;
+                const bh2 = this.sessionContextHistory.get(s.id);
+                const br2 = bh2 ? computeContextBurnRate(bh2, now) : null;
+                const lc2 = this.lastChangeAt.get(s.id);
+                const idle2 = lc2 !== undefined ? now - lc2 : null;
+                const hs = computeHealthScore({
+                    errorCount: this.sessionErrorCounts.get(s.id) ?? 0,
+                    burnRatePerMin: br2,
+                    contextFraction: cf2,
+                    idleMs: idle2,
+                    watchdogThresholdMs: this.watchdogThresholdMs,
+                });
+                const hist = this.sessionHealthHistory.get(s.id) ?? [];
+                hist.push({ score: hs, ts: now });
+                if (hist.length > MAX_HEALTH_HISTORY)
+                    hist.shift();
+                this.sessionHealthHistory.set(s.id, hist);
+            }
             const sorted = sortSessions(opts.sessions, this.sortMode, this.lastChangeAt, this.pinnedIds);
             const prevVisibleCount = this.getVisibleCount();
             this.sessions = sorted;
@@ -1811,6 +1977,12 @@ export class TUI {
                 process.stderr.write("\x07");
             }
         }
+        // collect "status" alerts into alert log (for /alert-log)
+        if (tag === "status") {
+            this.alertLog.push(entry);
+            if (this.alertLog.length > 100)
+                this.alertLog.shift();
+        }
         // track per-session error counts + timestamps (for sparklines)
         if (sessionId && shouldAutoPin(tag)) {
             this.sessionErrorCounts.set(sessionId, (this.sessionErrorCounts.get(sessionId) ?? 0) + 1);
@@ -2283,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);
             }
@@ -2353,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);
     }
@@ -2471,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}`;
@@ -2511,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/dist/types.d.ts

@@ -138,6 +138,7 @@ export interface DaemonSessionState {
     userActive?: boolean;
     costStr?: string;
     path?: string;
+    createdAt?: string;
 }
 export interface DaemonState {
     tickStartedAt: number;

package/package.json

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