claude-overnight 1.25.23 → 1.25.24

package/dist/_version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.25.23";
+export declare const VERSION = "1.25.24";

package/dist/_version.js

@@ -1,2 +1,2 @@
 // Auto-generated by build — do not edit manually.
-export const VERSION = "1.25.23";
+export const VERSION = "1.25.24";

package/dist/interactive-panel.d.ts

@@ -0,0 +1,40 @@
+export type PanelMode = "debrief" | "ask" | "custom" | "none";
+/** Mutable state of the interactive panel. */
+export interface PanelState {
+    mode: PanelMode;
+    expanded: boolean;
+    scrollOffset: number;
+    /** Short title shown in the header bar. */
+    header: string;
+    /** One-line summary shown when collapsed. */
+    preview: string;
+    /** Multi-line body shown when expanded. */
+    body: string;
+    /** Whether to show a text input at the bottom (ask/steer). */
+    inputActive: boolean;
+    inputPlaceholder?: string;
+}
+export declare class InteractivePanel {
+    state: PanelState;
+    /** Cached non-empty body lines — rebuilt when body changes. */
+    private _bodyLines;
+    /** Set or clear the panel content. Mode "none" hides it. */
+    set(params: {
+        mode: PanelMode;
+        header: string;
+        preview: string;
+        body: string;
+    }): void;
+    /** Collapse the panel back to the compact bar. */
+    collapse(): void;
+    /** Toggle expanded/collapsed state. */
+    toggle(): void;
+    /** Scroll up/down within the expanded body. */
+    scroll(direction: "up" | "down", visibleRows: number): void;
+    /** Whether the panel is currently visible (any mode other than none). */
+    get visible(): boolean;
+    /** Render the collapsed compact bar. Returns empty string if no content. */
+    renderCollapsed(width: number): string;
+    /** Render the expanded panel as an array of lines for the content area. */
+    renderExpanded(width: number, maxRows: number): string[];
+}

package/dist/interactive-panel.js

@@ -0,0 +1,111 @@
+import chalk from "chalk";
+const DARK_GREEN_BG = "\x1B[48;5;22m";
+const LIGHT_GREEN_FG = "\x1B[38;5;156m";
+const RESET = "\x1B[0m";
+function greenBg(text) {
+    return `${DARK_GREEN_BG}${LIGHT_GREEN_FG} ${text} ${RESET}`;
+}
+function greenBgLine(text, width) {
+    const padded = text.padEnd(Math.max(0, width));
+    return `${DARK_GREEN_BG}${LIGHT_GREEN_FG}${padded}${RESET}`;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 1) + "\u2026";
+}
+export class InteractivePanel {
+    state = {
+        mode: "none",
+        expanded: false,
+        scrollOffset: 0,
+        header: "",
+        preview: "",
+        body: "",
+        inputActive: false,
+    };
+    /** Cached non-empty body lines — rebuilt when body changes. */
+    _bodyLines = [];
+    /** Set or clear the panel content. Mode "none" hides it. */
+    set(params) {
+        this.state.mode = params.mode;
+        this.state.header = params.header;
+        this.state.preview = params.preview;
+        this.state.body = params.body;
+        // Rebuild cached lines and reset scroll only when content changes
+        this._bodyLines = params.body.split("\n").filter(l => l.length > 0);
+        this.state.scrollOffset = 0;
+    }
+    /** Collapse the panel back to the compact bar. */
+    collapse() {
+        this.state.expanded = false;
+        this.state.scrollOffset = 0;
+    }
+    /** Toggle expanded/collapsed state. */
+    toggle() {
+        if (this.state.mode === "none")
+            return;
+        this.state.expanded = !this.state.expanded;
+        if (!this.state.expanded)
+            this.state.scrollOffset = 0;
+    }
+    /** Scroll up/down within the expanded body. */
+    scroll(direction, visibleRows) {
+        if (!this.state.expanded)
+            return;
+        const maxScroll = Math.max(0, this._bodyLines.length - visibleRows);
+        if (direction === "up") {
+            this.state.scrollOffset = Math.max(0, this.state.scrollOffset - 1);
+        }
+        else {
+            this.state.scrollOffset = Math.min(maxScroll, this.state.scrollOffset + 1);
+        }
+    }
+    /** Whether the panel is currently visible (any mode other than none). */
+    get visible() {
+        return this.state.mode !== "none";
+    }
+    /** Render the collapsed compact bar. Returns empty string if no content. */
+    renderCollapsed(width) {
+        if (this.state.mode === "none" || !this.state.preview)
+            return "";
+        const icon = this.state.expanded ? "\u25BC" : "\u25B6";
+        const modeLabel = this.state.header;
+        const hint = chalk.dim(`[Ctrl-O expand]`);
+        const content = truncate(this.state.preview, width - modeLabel.length - hint.length - 8);
+        return `  ${greenBg(`${icon} ${modeLabel}`)} ${content} ${hint}`;
+    }
+    /** Render the expanded panel as an array of lines for the content area. */
+    renderExpanded(width, maxRows) {
+        if (this.state.mode === "none")
+            return [];
+        const innerW = Math.max(20, width - 6);
+        const lines = [];
+        // Header bar — full-width dark green bg
+        const headerText = ` ${this.state.header}  ${chalk.dim("[Ctrl-O] collapse")}${this.state.inputActive ? chalk.dim("  [Esc] cancel") : ""}`;
+        lines.push(greenBgLine(headerText, Math.min(width - 4, innerW + 2)));
+        // Body content — scrolled
+        const headerSpace = this.state.inputActive ? 3 : 2; // header + footer + optional input
+        const visibleRows = Math.max(2, maxRows - headerSpace);
+        const start = this.state.scrollOffset;
+        const end = Math.min(start + visibleRows, this._bodyLines.length);
+        for (let i = start; i < end; i++) {
+            const ln = truncate(this._bodyLines[i], innerW);
+            lines.push(`  ${chalk.greenBright(ln)}`);
+        }
+        if (end < this._bodyLines.length) {
+            lines.push(chalk.dim(`  \u2026 +${this._bodyLines.length - end} more`));
+        }
+        if (this._bodyLines.length === 0) {
+            lines.push(chalk.dim("  (empty)"));
+        }
+        // Footer hint
+        if (this.state.inputActive && this.state.inputPlaceholder) {
+            lines.push("");
+            lines.push(`  ${chalk.cyan(">")} ${this.state.inputPlaceholder}`);
+        }
+        else if (!this.state.inputActive) {
+            lines.push("");
+            lines.push(chalk.dim("  \u2191\u2193 scroll  [Ctrl-O] collapse"));
+        }
+        return lines;
+    }
+}

package/dist/models.js

@@ -22,7 +22,6 @@ export const MODEL_CAPABILITIES = {
     // Opus 4.7: only model that earns "relaxed". 100% on 38-task routing, 95%+ IFEval.
     // Step-change agentic coding over Opus 4.6. 1M tokens, 128K output.
     "claude-opus-4-7": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "relaxed", displayName: "Opus 4.7" },
-    "claude-opus-4.7": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "relaxed", displayName: "Opus 4.7" },
     "claude-opus-4-7-low": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "moderate", displayName: "Opus 4.7 Low" },
     "claude-opus-4-7-medium": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "relaxed", displayName: "Opus 4.7 Medium" },
     "claude-opus-4-7-high": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "relaxed", displayName: "Opus 4.7 High" },
@@ -36,13 +35,11 @@ export const MODEL_CAPABILITIES = {
     "claude-opus-4-7-thinking-max": { contextWindow: 1_000_000, safeContext: 400_000, contextConstraint: "relaxed", displayName: "Opus 4.7 Max Thinking" },
     // Sonnet 4.6: 200K context, tight constraint.
     "claude-sonnet-4-6": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "tight", displayName: "Sonnet 4.6" },
-    "claude-sonnet-4.6": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "tight", displayName: "Sonnet 4.6" },
     "claude-4.6-sonnet-medium": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "tight", displayName: "Sonnet 4.6 Medium" },
     "claude-sonnet-4-6-thinking": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "tight", displayName: "Sonnet 4.6 Thinking" },
     "claude-4.6-sonnet-medium-thinking": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "tight", displayName: "Sonnet 4.6 Medium Thinking" },
     // Sonnet 4.5: 200K context.
     "claude-sonnet-4-5": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "moderate", displayName: "Sonnet 4.5" },
-    "claude-sonnet-4.5": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "moderate", displayName: "Sonnet 4.5" },
     "claude-4.5-sonnet": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "moderate", displayName: "Sonnet 4.5" },
     "claude-sonnet-4-5-thinking": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "moderate", displayName: "Sonnet 4.5 Thinking" },
     "claude-4.5-sonnet-thinking": { contextWindow: 200_000, safeContext: 60_000, contextConstraint: "moderate", displayName: "Sonnet 4.5 Thinking" },
@@ -71,7 +68,7 @@ export const MODEL_CAPABILITIES = {
     "gpt-5.4-xhigh-fast": { contextWindow: 1_050_000, safeContext: 300_000, contextConstraint: "moderate", displayName: "GPT-5.4 Extra High Fast" },
     "gpt-5.4-mini": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini" },
     "gpt-5.4-mini-low": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini Low" },
-    "gpt-5.4-mini-medium": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini" },
+    "gpt-5.4-mini-medium": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini Medium" },
     "gpt-5.4-mini-high": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini High" },
     "gpt-5.4-mini-xhigh": { contextWindow: 1_050_000, safeContext: 200_000, contextConstraint: "tight", displayName: "GPT-5.4 Mini Extra High" },
     // Codex 5.3: best agentic coder from OpenAI. 400K context, 128K output.

package/dist/planner-query.d.ts

@@ -13,6 +13,10 @@ export interface PlannerRateLimitInfo {
     windows: Map<string, RateLimitWindow>;
     resetsAt?: number;
     costUsd: number;
+    /** Peak total input tokens (input + cache) in any single planner turn — proxy for context-window occupancy. */
+    contextTokens?: number;
+    /** Model used by the current planner query (for safeContext lookup). */
+    model?: string;
 }
 export interface PlannerOpts {
     cwd: string;
@@ -36,6 +40,10 @@ export interface PlannerOpts {
 }
 export declare function setPlannerEnvResolver(fn: ((model?: string) => Record<string, string> | undefined) | undefined): void;
 export declare function getTotalPlannerCost(): number;
+export declare function getPeakPlannerContext(): {
+    tokens: number;
+    model?: string;
+};
 export declare function getPlannerRateLimitInfo(): PlannerRateLimitInfo;
 export declare function runPlannerQuery(prompt: string, opts: PlannerOpts, onLog: PlannerLog): Promise<string>;
 export declare function postProcess(raw: Task[], budget: number | undefined, onLog: (text: string) => void): Task[];

package/dist/planner-query.js

@@ -1,7 +1,12 @@
 import { query } from "@anthropic-ai/claude-agent-sdk";
 import { readFileSync } from "fs";
-import { NudgeError } from "./types.js";
+import { NudgeError, extractToolTarget, sumUsageTokens } from "./types.js";
 import { writeTranscriptEvent } from "./transcripts.js";
+/** Log a tool invocation with a short target for planner queries. */
+const logTool = (label, input) => {
+    const target = extractToolTarget(input);
+    return target ? `${label} \u2192 ${target}` : label;
+};
 const DEFAULT_TOOLS = ["Read", "Glob", "Grep", "Write", "Bash", "WebFetch", "WebSearch", "TodoWrite", "Agent"];
 const DEFAULT_MAX_TURNS = 20;
 // ── Shared env resolver (set once at run start, used by every planner query) ──
@@ -21,6 +26,11 @@ function isRateLimitError(err) {
 }
 let _totalPlannerCostUsd = 0;
 export function getTotalPlannerCost() { return _totalPlannerCostUsd; }
+let _peakPlannerContextTokens = 0;
+let _peakPlannerContextModel;
+export function getPeakPlannerContext() {
+    return { tokens: _peakPlannerContextTokens, model: _peakPlannerContextModel };
+}
 let _plannerRateLimitInfo = {
     utilization: 0, status: "", isUsingOverage: false, windows: new Map(), costUsd: 0,
 };
@@ -66,22 +76,6 @@ async function throttlePlanner(onLog, aborted) {
     }
     // Exhausted backoffs — proceed anyway, the retry loop will catch a rejection.
 }
-/**
- * Pick a short, human-readable target for a tool invocation (Read/Grep/Bash/…).
- * Prefers explicit file paths; falls back to the first few tokens of a shell
- * command. Returns `""` when the input has no useful identifier.
- */
-function extractToolTarget(input) {
-    if (!input)
-        return "";
-    const p = input.path ?? input.file_path ?? input.pattern;
-    if (typeof p === "string" && p)
-        return p;
-    if (typeof input.command === "string" && input.command) {
-        return input.command.split(" ").slice(0, 3).join(" ");
-    }
-    return "";
-}
 // ── Query execution ──
 const NUDGE_MS = 15 * 60 * 1000;
 const HARD_TIMEOUT_MS = 30 * 60 * 1000;
@@ -123,7 +117,7 @@ export async function runPlannerQuery(prompt, opts, onLog) {
     throw new Error("Planner query failed after retries");
 }
 async function runPlannerQueryOnce(prompt, opts, onLog) {
-    _plannerRateLimitInfo = { utilization: 0, status: "", isUsingOverage: false, windows: new Map(), costUsd: 0 };
+    _plannerRateLimitInfo = { utilization: 0, status: "", isUsingOverage: false, windows: new Map(), costUsd: 0, contextTokens: 0, model: opts.model };
     let resultText = "";
     let structuredOutput;
     const startedAt = Date.now();
@@ -310,6 +304,16 @@ async function runPlannerQueryOnce(prompt, opts, onLog) {
             // turn message for tool_use / thinking / text so the ticker still moves
             // every ~6-15s instead of sitting silent for minutes.
             if (msg.type === "assistant") {
+                const u = msg.message?.usage;
+                if (u) {
+                    const turnTotal = sumUsageTokens(u);
+                    if (turnTotal > (_plannerRateLimitInfo.contextTokens ?? 0))
+                        _plannerRateLimitInfo.contextTokens = turnTotal;
+                    if (turnTotal > _peakPlannerContextTokens) {
+                        _peakPlannerContextTokens = turnTotal;
+                        _peakPlannerContextModel = opts.model;
+                    }
+                }
                 const content = msg.message?.content;
                 if (Array.isArray(content)) {
                     for (const part of content) {

package/dist/providers.js

@@ -11,6 +11,28 @@ import { getBearerToken, clearTokenCache } from "./auth.js";
 import { DEFAULT_MODEL } from "./models.js";
 import { CURSOR_PRIORITY_MODELS, CURSOR_KNOWN_MODELS, KNOWN_CURSOR_MODEL_IDS, cursorModelHint, } from "./cursor-models.js";
 import { VERSION } from "./_version.js";
+/** Cached system Node.js and agent script paths — resolved once, reused across envFor calls. */
+let _cachedAgentNode = null;
+let _cachedAgentScript = null;
+/** Resolve system Node.js and agent index.js paths. Returns [nodePath, scriptPath] or [null, null]. */
+function resolveAgentPaths(timeoutMs = 2_000) {
+    let nodePath = null;
+    let agentJs = null;
+    try {
+        nodePath = execSync("which node 2>/dev/null", { timeout: timeoutMs, encoding: "utf-8", shell: "bash" }).trim() || null;
+        const agentPath = execSync("command -v agent 2>/dev/null || command -v cursor-agent 2>/dev/null", {
+            timeout: timeoutMs, encoding: "utf-8", shell: "bash",
+        }).trim();
+        if (agentPath) {
+            const agentDir = dirname(realpathSync(agentPath));
+            const indexPath = `${agentDir}/index.js`;
+            if (existsSync(indexPath))
+                agentJs = indexPath;
+        }
+    }
+    catch { }
+    return [nodePath, agentJs];
+}
 /** Run the installed package CLI with `node` (avoids npx/npm invoking extra tooling on macOS). */
 function resolveCursorComposerCli() {
     try {
@@ -129,23 +151,17 @@ export function envFor(p) {
         // agents and workers must use "plan" so they actually interact with the codebase.
         base.CURSOR_BRIDGE_MODE = "plan";
         // Use system Node.js for agent subprocess to avoid macOS segfaults with
-        // bundled Node.js. Resolve lazily — same logic as startProxyProcess().
-        if (!base.CURSOR_AGENT_NODE || !base.CURSOR_AGENT_SCRIPT) {
-            try {
-                const sysNode = execSync("which node 2>/dev/null", { timeout: 2_000, encoding: "utf-8", shell: "bash" }).trim();
-                const agentPath = execSync("command -v agent 2>/dev/null || command -v cursor-agent 2>/dev/null", {
-                    timeout: 2_000, encoding: "utf-8", shell: "bash",
-                }).trim();
-                if (sysNode && agentPath) {
-                    const agentDir = dirname(realpathSync(agentPath));
-                    const indexPath = `${agentDir}/index.js`;
-                    if (existsSync(indexPath)) {
-                        base.CURSOR_AGENT_NODE = sysNode;
-                        base.CURSOR_AGENT_SCRIPT = indexPath;
-                    }
-                }
-            }
-            catch { }
+        // bundled Node.js. Resolve lazily.
+        if (!_cachedAgentNode || !_cachedAgentScript) {
+            const [node, script] = resolveAgentPaths(2_000);
+            _cachedAgentNode = node;
+            _cachedAgentScript = script;
+        }
+        if (_cachedAgentNode) {
+            base.CURSOR_AGENT_NODE = _cachedAgentNode;
+        }
+        if (_cachedAgentScript) {
+            base.CURSOR_AGENT_SCRIPT = _cachedAgentScript;
         }
         return base;
     }
@@ -837,21 +853,7 @@ async function startProxyProcess(baseUrl, url, port) {
     console.log(chalk.yellow(`\n  Proxy not running at ${baseUrl} — starting it for you…`));
     // Resolve system node and agent index.js so the proxy uses system Node.js
     // for the agent subprocess (avoids segfaults with --list-models on macOS).
-    let sysNode = null;
-    let agentJs = null;
-    try {
-        sysNode = execSync("which node 2>/dev/null", { timeout: 3_000, encoding: "utf-8", shell: "bash" }).trim() || null;
-        const agentPath = execSync("command -v agent 2>/dev/null || command -v cursor-agent 2>/dev/null", {
-            timeout: 3_000, encoding: "utf-8", shell: "bash",
-        }).trim();
-        if (agentPath) {
-            const agentDir = dirname(realpathSync(agentPath));
-            const indexPath = `${agentDir}/index.js`;
-            if (existsSync(indexPath))
-                agentJs = indexPath;
-        }
-    }
-    catch { }
+    const [sysNode, agentJs] = resolveAgentPaths(3_000);
     const apiKeyStored = loadProviders().find(p => p.cursorProxy)?.cursorApiKey;
     const agentToken = resolveCursorAgentToken();
     if (!agentToken) {

package/dist/render.d.ts

@@ -1,6 +1,8 @@
+import chalk from "chalk";
 import type { Swarm } from "./swarm.js";
-import type { RateLimitWindow } from "./types.js";
+import type { RLGetter } from "./types.js";
 import type { RunInfo, SteeringContext, SteeringEvent } from "./ui.js";
+import { InteractivePanel } from "./interactive-panel.js";
 export interface Section {
     title: string;
     rows: string[];
@@ -14,6 +16,11 @@ export interface ContentRenderer {
 export declare function truncate(s: string, max: number): string;
 export declare function fmtTokens(n: number): string;
 export declare function fmtDur(ms: number): string;
+/** Context-fill percentage and color function for a token count vs safe limit. */
+export declare function contextFillInfo(tokens: number, safe: number): {
+    pct: number;
+    color: typeof chalk;
+};
 export declare function renderUnifiedFrame(params: {
     model?: string;
     phase: string;
@@ -36,13 +43,7 @@ export declare function renderUnifiedFrame(params: {
     extraFooterRows?: string[];
     maxRows?: number;
 }): string;
-type RLGetter = () => {
-    utilization: number;
-    isUsingOverage: boolean;
-    windows: Map<string, RateLimitWindow>;
-    resetsAt?: number;
-};
-export declare function renderFrame(swarm: Swarm, showHotkeys: boolean, runInfo?: RunInfo, selectedAgentId?: number, maxRows?: number, debrief?: string): string;
+export declare function renderFrame(swarm: Swarm, showHotkeys: boolean, runInfo?: RunInfo, selectedAgentId?: number, maxRows?: number, panel?: InteractivePanel): string;
 export interface SteeringViewData {
     /** The ephemeral ticker heartbeat  -- elapsed, tool count, cost, current reasoning snippet. */
     statusLine: string;
@@ -51,6 +52,5 @@ export interface SteeringViewData {
     /** Optional context read from disk at setSteering() time. */
     context?: SteeringContext;
 }
-export declare function renderSteeringFrame(runInfo: RunInfo, data: SteeringViewData, showHotkeys: boolean, rlGetter?: RLGetter, maxRows?: number, debrief?: string): string;
+export declare function renderSteeringFrame(runInfo: RunInfo, data: SteeringViewData, showHotkeys: boolean, rlGetter?: RLGetter, maxRows?: number, panel?: InteractivePanel): string;
 export declare function renderSummary(swarm: Swarm): string;
-export {};

package/dist/render.js

@@ -1,5 +1,6 @@
 import chalk from "chalk";
 import { RATE_LIMIT_WINDOW_SHORT } from "./types.js";
+import { getModelCapability, modelDisplayName } from "./models.js";
 const SPINNER = ["|", "/", "-", "\\"];
 // ── Shared helpers ──
 export function truncate(s, max) {
@@ -62,10 +63,53 @@ function renderHeader(out, w, p) {
         (costStr ? `  ${costStr}` : "") + sessionStr);
 }
 // ── Usage bars ──
-function renderUsageBars(out, w, swarm) {
+/** Context-fill percentage and color function for a token count vs safe limit. */
+export function contextFillInfo(tokens, safe) {
+    const pct = safe > 0 ? Math.round((tokens / safe) * 100) : 0;
+    const color = pct > 80 ? chalk.red : pct > 50 ? chalk.yellow : chalk.green;
+    return { pct, color };
+}
+function drawContextBar(out, w, tokens, safe, label) {
+    const barW = Math.min(30, w - 40);
+    const { pct, color } = contextFillInfo(tokens, safe);
+    const filled = Math.round((pct / 100) * barW);
+    const bar = color("\u2588".repeat(filled)) + chalk.gray("\u2591".repeat(barW - filled));
+    const prefix = chalk.dim("Ctx   ");
+    out.push(`  ${prefix}${bar}  ${label}`);
+}
+/** Pick the running agent with the highest context-fill ratio; returns {tokens, safe, agentId} or null. */
+function peakAgentContext(swarm) {
+    let best = null;
+    for (const a of swarm.agents) {
+        if (a.status !== "running")
+            continue;
+        const tokens = a.contextTokens ?? 0;
+        if (tokens <= 0)
+            continue;
+        const model = a.task.model || swarm.model || "unknown";
+        const safe = getModelCapability(model).safeContext;
+        const ratio = safe > 0 ? tokens / safe : 0;
+        if (!best || ratio > best.ratio)
+            best = { tokens, safe, agentId: a.id, model, ratio };
+    }
+    return best;
+}
+function renderUsageBars(out, w, swarm, selectedAgentId) {
     const windows = Array.from(swarm.rateLimitWindows.values());
     const rlPct = swarm.rateLimitUtilization;
-    if (rlPct <= 0 && !swarm.rateLimitResetsAt && !swarm.cappedOut && swarm.rateLimitPaused <= 0 && windows.length === 0)
+    const hasRL = !(rlPct <= 0 && !swarm.rateLimitResetsAt && !swarm.cappedOut && swarm.rateLimitPaused <= 0 && windows.length === 0);
+    // Context bar — prefer the selected agent when detail view is open, else the peak running agent.
+    let ctx = null;
+    if (selectedAgentId != null) {
+        const a = swarm.agents.find(x => x.id === selectedAgentId);
+        if (a && (a.contextTokens ?? 0) > 0) {
+            const model = a.task.model || swarm.model || "unknown";
+            ctx = { tokens: a.contextTokens ?? 0, safe: getModelCapability(model).safeContext, agentId: a.id, model };
+        }
+    }
+    if (!ctx)
+        ctx = peakAgentContext(swarm);
+    if (!hasRL && !ctx)
         return;
     const barW = Math.min(30, w - 40);
     const capFrac = swarm.usageCap;
@@ -107,10 +151,13 @@ function renderUsageBars(out, w, swarm) {
         }
         if (swarm.isUsingOverage && !swarm.cappedOut)
             label += chalk.red(" [OVERAGE]");
-        const prefix = windowLabel ? chalk.dim(windowLabel.padEnd(6)) : chalk.dim("Usage ");
+        const prefix = windowLabel ? chalk.dim(windowLabel.padEnd(6)) : chalk.dim("RL    ");
         out.push(`  ${prefix}${barStr}  ${label}`);
     };
-    if (windows.length > 1) {
+    if (!hasRL) {
+        // Skip the Anthropic RL bar entirely when there's no signal — just show the context bar below.
+    }
+    else if (windows.length > 1) {
         const cycleIdx = Math.floor(Date.now() / 3000) % windows.length;
         const win = windows[cycleIdx];
         const shortName = RATE_LIMIT_WINDOW_SHORT[win.type] ?? win.type.replace(/_/g, " ");
@@ -137,6 +184,12 @@ function renderUsageBars(out, w, swarm) {
             : `$${swarm.overageCostUsd.toFixed(2)}/$${swarm.extraUsageBudget}`;
         out.push(`  ${chalk.dim("Extra ")}${barStr}  ${label}`);
     }
+    // Context fullness bar (per peak-running-agent or selected agent).
+    if (ctx) {
+        const who = selectedAgentId != null && ctx.agentId === selectedAgentId ? `agent ${ctx.agentId}` : `peak a${ctx.agentId}`;
+        const label = `${fmtTokens(ctx.tokens)}/${fmtTokens(ctx.safe)} safe  ${chalk.dim(`${who} · ${modelDisplayName(ctx.model)}`)}`;
+        drawContextBar(out, w, ctx.tokens, ctx.safe, label);
+    }
 }
 // ── Unified frame renderer ──
 export function renderUnifiedFrame(params) {
@@ -188,9 +241,14 @@ export function renderUnifiedFrame(params) {
             content.push(row);
         }
     }
-    return [...header, ...content, ...footer].join("\n");
+    const full = [...header, ...content, ...footer];
+    if (params.maxRows != null && full.length > params.maxRows) {
+        return full.slice(0, Math.max(0, params.maxRows)).join("\n");
+    }
+    return full.join("\n");
 }
-export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRows, debrief) {
+// ── Frame renderers ──
+export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRows, panel) {
     const allDone = swarm.agents.length > 0 && swarm.agents.every(a => a.status !== "running");
     const doneTag = allDone && !swarm.aborted ? chalk.green("COMPLETE") : "";
     const stoppingTag = swarm.aborted ? chalk.yellow("STOPPING") : "";
@@ -211,6 +269,14 @@ export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRow
     const content = {
         sections() {
             const secs = [];
+            // Expanded panel (debrief, ask, custom) — rendered as first section
+            if (panel?.visible && panel.state.expanded) {
+                const ww = Math.max((process.stdout.columns ?? 80) || 80, 60);
+                const panelRows = maxRows != null ? Math.max(4, maxRows - 6) : 12;
+                const lines = panel.renderExpanded(ww, panelRows);
+                if (lines.length > 0)
+                    secs.push({ title: "", rows: lines });
+            }
             // Agent table (undecorated  -- raw header + rows)
             if (show.length > 0) {
                 const rows = [
@@ -245,6 +311,13 @@ export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRow
                     meta.push(chalk.yellow(`$${detailAgent.costUsd.toFixed(3)}`));
                 if (detailAgent.toolCalls > 0)
                     meta.push(chalk.dim(`${detailAgent.toolCalls} tools`));
+                if ((detailAgent.contextTokens ?? 0) > 0) {
+                    const mdl = detailAgent.task.model || swarm.model || "unknown";
+                    const safe = getModelCapability(mdl).safeContext;
+                    const tok = detailAgent.contextTokens ?? 0;
+                    const { pct, color } = contextFillInfo(tok, safe);
+                    meta.push(color(`ctx ${fmtTokens(tok)}/${fmtTokens(safe)} (${pct}%)`));
+                }
                 if (meta.length > 0)
                     rows.push(`  ${meta.join(chalk.dim("  \u00b7 "))}`);
                 secs.push({ title: `Agent ${detailAgent.id} detail \u00b7 [d] next \u00b7 [Esc] close`, rows });
@@ -290,8 +363,12 @@ export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRow
     // Build footer
     let hotkeyRow;
     const extraFooterRows = [];
-    if (debrief)
-        extraFooterRows.push(chalk.dim(`  ${debrief}`));
+    // Collapsed panel bar shown in footer area
+    if (panel?.visible && !panel.state.expanded) {
+        const bar = panel.renderCollapsed(Math.max((process.stdout.columns ?? 80) || 80, 60));
+        if (bar)
+            extraFooterRows.push(bar);
+    }
     if (showHotkeys) {
         const pending = runInfo?.pendingSteer ?? 0;
         const chip = pending > 0 ? chalk.cyan(`  \u270E ${pending} steer queued`) : "";
@@ -300,7 +377,8 @@ export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRow
         const pauseLabel = swarm.paused ? "[p] resume" : "[p] pause";
         const detailChip = swarm.active > 0 ? chalk.dim("  [d] detail") : "";
         const selectChip = swarm.active > 0 && running.length <= 10 ? chalk.dim("  [0-9] select") : "";
-        hotkeyRow = chalk.dim(`  [b] budget  [t] cap  [c] conc  [e] extra  ${pauseLabel}  [s] steer  [?] ask  [q] stop`) + fixChip + retryChip + chip + detailChip + selectChip;
+        const panelChip = panel?.visible ? chalk.green(`  [Ctrl-O] ${panel.state.expanded ? "collapse" : "expand"}`) : "";
+        hotkeyRow = chalk.dim(`  [b] budget  [t] cap  [c] conc  [e] extra  ${pauseLabel}  [s] steer  [?] ask  [q] stop`) + fixChip + retryChip + chip + detailChip + selectChip + panelChip;
         if (swarm.blocked > 0 && swarm.blocked === swarm.active) {
             extraFooterRows.push(chalk.yellow(`  all workers rate-limited  -- [r] retry-now, [c] reduce concurrency, [p] pause, [q] quit`));
         }
@@ -321,7 +399,7 @@ export function renderFrame(swarm, showHotkeys, runInfo, selectedAgentId, maxRow
         sessionsUsed: (runInfo ? runInfo.accCompleted + runInfo.accFailed : 0) + waveUsed,
         sessionsBudget: runInfo?.sessionsBudget ?? swarm.total,
         remaining: Math.max(0, (runInfo?.remaining ?? swarm.total) - waveUsed),
-        usageBarRender: (out, w) => renderUsageBars(out, w, swarm),
+        usageBarRender: (out, w) => renderUsageBars(out, w, swarm, selectedAgentId),
         content,
         hotkeyRow,
         extraFooterRows,
@@ -352,16 +430,25 @@ function renderSteeringUsageBar(out, w, rl) {
             const mm = Math.floor(waitSec / 60), ss = waitSec % 60;
             lbl = chalk.red(`Waiting for reset ${mm > 0 ? `${mm}m ${ss}s` : `${ss}s`}`);
         }
-        const prefix = label ? chalk.dim(label.padEnd(6)) : chalk.dim("Usage ");
+        const prefix = label ? chalk.dim(label.padEnd(6)) : chalk.dim("RL    ");
         out.push(`  ${prefix}${barStr}  ${lbl}`);
     };
-    if (rl.windows.size > 1) {
-        const wins = Array.from(rl.windows.values());
-        const idx = Math.floor(Date.now() / 3000) % wins.length;
-        draw(wins[idx].utilization, wins[idx].type.replace(/_/g, " ").slice(0, 5));
+    const hasRL = rl.utilization > 0 || rl.windows.size > 0 || (rl.resetsAt && rl.resetsAt > Date.now());
+    if (hasRL) {
+        if (rl.windows.size > 1) {
+            const wins = Array.from(rl.windows.values());
+            const idx = Math.floor(Date.now() / 3000) % wins.length;
+            draw(wins[idx].utilization, wins[idx].type.replace(/_/g, " ").slice(0, 5));
+        }
+        else {
+            draw(rl.utilization);
+        }
     }
-    else {
-        draw(rl.utilization);
+    if ((rl.contextTokens ?? 0) > 0 && rl.model) {
+        const safe = getModelCapability(rl.model).safeContext;
+        const tok = rl.contextTokens ?? 0;
+        const label = `${fmtTokens(tok)}/${fmtTokens(safe)} safe  ${chalk.dim(`planner · ${modelDisplayName(rl.model)}`)}`;
+        drawContextBar(out, w, tok, safe, label);
     }
 }
 function renderLastWave(out, w, lw) {
@@ -399,13 +486,20 @@ function renderStatusBlock(out, w, status) {
     for (const ln of lines)
         out.push(`  ${chalk.dim(truncate(ln.trim(), w - 4))}`);
 }
-export function renderSteeringFrame(runInfo, data, showHotkeys, rlGetter, maxRows, debrief) {
+export function renderSteeringFrame(runInfo, data, showHotkeys, rlGetter, maxRows, panel) {
     const totalUsed = runInfo.accCompleted + runInfo.accFailed;
     const ctx = data.context;
     const content = {
         sections() {
             const secs = [];
             const ww = Math.max((process.stdout.columns ?? 80) || 80, 60);
+            // Expanded panel (debrief, ask, custom) — rendered as first section
+            if (panel?.visible && panel.state.expanded) {
+                const panelRows = maxRows != null ? Math.max(4, maxRows - 6) : 12;
+                const lines = panel.renderExpanded(ww, panelRows);
+                if (lines.length > 0)
+                    secs.push({ title: "", rows: lines });
+            }
             // Objective (undecorated  -- raw line)
             if (ctx?.objective) {
                 const obj = ctx.objective.replace(/\s+/g, " ").trim();
@@ -462,7 +556,7 @@ export function renderSteeringFrame(runInfo, data, showHotkeys, rlGetter, maxRow
     const usageBarRender = rlGetter
         ? (out, w) => {
             const rl = rlGetter();
-            if (rl && (rl.utilization > 0 || rl.windows.size > 0)) {
+            if (rl && (rl.utilization > 0 || rl.windows.size > 0 || (rl.contextTokens ?? 0) > 0)) {
                 renderSteeringUsageBar(out, w, rl);
             }
         }
@@ -470,12 +564,17 @@ export function renderSteeringFrame(runInfo, data, showHotkeys, rlGetter, maxRow
     // Footer
     let hotkeyRow;
     const extraFooterRows = [];
-    if (debrief)
-        extraFooterRows.push(chalk.dim(`  ${debrief}`));
+    // Collapsed panel bar shown in footer area
+    if (panel?.visible && !panel.state.expanded) {
+        const bar = panel.renderCollapsed(Math.max((process.stdout.columns ?? 80) || 80, 60));
+        if (bar)
+            extraFooterRows.push(bar);
+    }
     if (showHotkeys) {
         const pending = runInfo?.pendingSteer ?? 0;
         const chip = pending > 0 ? chalk.cyan(`  \u270E ${pending} steer queued`) : "";
-        hotkeyRow = chalk.dim("  [b] budget  [s] steer  [q] stop") + chip;
+        const panelChip = panel?.visible ? chalk.green(`  [Ctrl-O] ${panel.state.expanded ? "collapse" : "expand"}`) : "";
+        hotkeyRow = chalk.dim("  [b] budget  [s] steer  [q] stop") + chip + panelChip;
     }
     return renderUnifiedFrame({
         model: runInfo.model,
@@ -502,11 +601,12 @@ export function renderSteeringFrame(runInfo, data, showHotkeys, rlGetter, maxRow
 export function renderSummary(swarm) {
     const w = Math.max((process.stdout.columns ?? 80) || 80, 60);
     const out = [];
-    const fixedW = 3 + 6 + 8 + 5 + 5 + 8 + 12 + 2;
+    const ctxW = 5;
+    const fixedW = 3 + 6 + 8 + 5 + 5 + 8 + ctxW + 14;
     const taskW = Math.max(10, w - fixedW);
     out.push("");
     out.push(chalk.gray("  " + "#".padStart(3) + "  " + "Status".padEnd(6) + "  " + "Task".padEnd(taskW) +
-        "  " + "Duration".padStart(8) + "  " + "Files".padStart(5) + "  " + "Tools".padStart(5) + "  " + "Cost".padStart(8)));
+        "  " + "Duration".padStart(8) + "  " + "Files".padStart(5) + "  " + "Tools".padStart(5) + "  " + "Ctx%".padStart(ctxW) + "  " + "Cost".padStart(8)));
     out.push(chalk.gray("  " + "\u2500".repeat(Math.min(w - 4, fixedW + taskW))));
     const groups = [
         swarm.agents.filter(a => a.status === "running"),
@@ -516,6 +616,7 @@ export function renderSummary(swarm) {
     ].filter(g => g.length > 0);
     const thinSep = chalk.gray("  " + "\u254C".repeat(Math.min(w - 4, fixedW + taskW)));
     let totalDurMs = 0, totalFiles = 0, totalTools = 0, totalCost = 0;
+    let peakCtxPct = 0;
     for (let gi = 0; gi < groups.length; gi++) {
         if (gi > 0)
             out.push(thinSep);
@@ -532,17 +633,25 @@ export function renderSummary(swarm) {
             const files = String(a.filesChanged ?? 0).padStart(5);
             const tools = String(a.toolCalls).padStart(5);
             const cost = a.costUsd != null ? `$${a.costUsd.toFixed(3)}`.padStart(8) : "".padStart(8);
+            const mdl = a.task.model || swarm.model || "unknown";
+            const safe = getModelCapability(mdl).safeContext;
+            const ctxTok = a.contextTokens ?? 0;
+            const { pct: ctxPct, color: ctxColor } = ctxTok > 0 ? contextFillInfo(ctxTok, safe) : { pct: 0, color: chalk.gray };
+            if (ctxPct > peakCtxPct)
+                peakCtxPct = ctxPct;
+            const ctxCell = ctxTok > 0 ? `${ctxPct}%`.padStart(ctxW) : "".padStart(ctxW);
             totalDurMs += durMs;
             totalFiles += a.filesChanged ?? 0;
             totalTools += a.toolCalls;
             totalCost += a.costUsd ?? 0;
             const color = ok ? chalk.white : a.status === "running" ? chalk.blue : a.status === "paused" ? chalk.yellow : chalk.red;
-            out.push(color(`  ${id}  ${status}  ${task}  ${dur}  ${files}  ${tools}  ${cost}`));
+            out.push(color(`  ${id}  ${status}  ${task}  ${dur}  ${files}  ${tools}  `) + (ctxTok > 0 ? ctxColor(ctxCell) : chalk.gray(ctxCell)) + color(`  ${cost}`));
         }
     }
     out.push(chalk.gray("  " + "\u2500".repeat(Math.min(w - 4, fixedW + taskW))));
     const label = `${swarm.agents.length} tasks`.padEnd(taskW);
-    out.push(chalk.bold(`  ${"".padStart(3)}  ${"Total ".padEnd(6)}  ${label}  ${fmtDur(totalDurMs).padStart(8)}  ${String(totalFiles).padStart(5)}  ${String(totalTools).padStart(5)}  ${`$${totalCost.toFixed(3)}`.padStart(8)}`));
+    const peakCell = peakCtxPct > 0 ? `${peakCtxPct}%`.padStart(ctxW) : "".padStart(ctxW);
+    out.push(chalk.bold(`  ${"".padStart(3)}  ${"Total ".padEnd(6)}  ${label}  ${fmtDur(totalDurMs).padStart(8)}  ${String(totalFiles).padStart(5)}  ${String(totalTools).padStart(5)}  ${peakCell}  ${`$${totalCost.toFixed(3)}`.padStart(8)}`));
     out.push("");
     return out.join("\n");
 }

package/dist/run.js

@@ -4,7 +4,9 @@ import { execSync } from "child_process";
 import chalk from "chalk";
 import { Swarm } from "./swarm.js";
 import { steerWave } from "./steering.js";
-import { getTotalPlannerCost, getPlannerRateLimitInfo, runPlannerQuery, setPlannerEnvResolver } from "./planner-query.js";
+import { getTotalPlannerCost, getPlannerRateLimitInfo, getPeakPlannerContext, runPlannerQuery, setPlannerEnvResolver } from "./planner-query.js";
+import { contextFillInfo } from "./render.js";
+import { getModelCapability } from "./models.js";
 import { buildEnvResolver, isCursorProxyProvider } from "./providers.js";
 import { RunDisplay } from "./ui.js";
 import { renderSummary } from "./render.js";
@@ -47,6 +49,7 @@ export async function executeRun(cfg) {
     const waveHistory = [];
     let accCost, accCompleted, accFailed, accTools;
     let accIn = 0, accOut = 0;
+    let peakWorkerCtxPct = 0, peakWorkerCtxTokens = 0;
     let lastCapped = false, lastAborted = false, objectiveComplete = false, lastHealed = false;
     let lastEstimate;
     const branches = [];
@@ -429,6 +432,18 @@ export async function executeRun(cfg) {
             accCompleted += swarm.completed;
             accFailed += swarm.failed;
             accTools += swarm.agents.reduce((sum, a) => sum + a.toolCalls, 0);
+            for (const a of swarm.agents) {
+                const tok = a.contextTokens ?? 0;
+                if (tok <= 0)
+                    continue;
+                const mdl = a.task.model || swarm.model || "unknown";
+                const safe = getModelCapability(mdl).safeContext;
+                const { pct } = contextFillInfo(tok, safe);
+                if (pct > peakWorkerCtxPct) {
+                    peakWorkerCtxPct = pct;
+                    peakWorkerCtxTokens = tok;
+                }
+            }
             remaining = Math.max(0, remaining - swarm.completed - swarm.failed);
             const totalConsumed = accCompleted + accFailed + cfg.thinkingUsed;
             const expectedFloor = Math.max(0, cfg.budget - totalConsumed);
@@ -619,11 +634,21 @@ export async function executeRun(cfg) {
         console.log(chalk.bold.yellow(`  CLAUDE OVERNIGHT  -- STOPPED`));
     console.log(chalk.green(`  ${bannerChar.repeat(Math.min(termW - 4, 60))}`));
     console.log("");
+    const peakPlanner = getPeakPlannerContext();
+    const plannerSafe = peakPlanner.model ? getModelCapability(peakPlanner.model).safeContext : 0;
+    const plannerPct = plannerSafe > 0 && peakPlanner.tokens > 0 ? Math.round((peakPlanner.tokens / plannerSafe) * 100) : 0;
+    const colorByPct = (pct) => pct > 80 ? chalk.red : pct > 50 ? chalk.yellow : chalk.green;
+    const fmtCtx = (tok, pct) => {
+        if (tok <= 0)
+            return chalk.dim("—");
+        return colorByPct(pct)(`${fmtTokens(tok)} (${pct}%)`);
+    };
     const statRows = [
         [chalk.bold("Waves"), String(waves), chalk.bold("Sessions"), `${accCompleted} done${accFailed > 0 ? ` / ${accFailed} failed` : ""}${remaining > 0 ? ` (${remaining} remaining)` : ""}`],
         [chalk.bold("Cost"), chalk.green(`$${accCost.toFixed(2)}`), chalk.bold("Elapsed"), elapsedStr],
         [chalk.bold("Merged"), `${totalMerged} branches`, chalk.bold("Conflicts"), totalConflicts > 0 ? chalk.red(String(totalConflicts)) : chalk.green("0")],
         [chalk.bold("Tokens"), `${fmtTokens(accIn)} in / ${fmtTokens(accOut)} out`, chalk.bold("Tool calls"), String(accTools)],
+        [chalk.bold("Peak ctx"), `worker ${fmtCtx(peakWorkerCtxTokens, peakWorkerCtxPct)}`, chalk.bold(""), `planner ${fmtCtx(peakPlanner.tokens, plannerPct)}`],
     ];
     for (const [k1, v1, k2, v2] of statRows)
         console.log(`  ${k1}  ${v1.padEnd(20)}  ${k2}  ${v2}`);

package/dist/state.js

@@ -18,6 +18,14 @@ export function readMdDir(dir) {
         return "";
     }
 }
+function hasMdFiles(dir) {
+    try {
+        return readdirSync(dir).some(f => f.endsWith(".md"));
+    }
+    catch {
+        return false;
+    }
+}
 export function readRunMemory(runDir, previousRuns) {
     let goal = "", status = "";
     try {
@@ -194,6 +202,16 @@ export function findIncompleteRuns(rootDir, filterCwd) {
             const state = loadRunState(runDir);
             if (!state || state.phase === "done" || state.cwd !== filterCwd)
                 continue;
+            // Filter empty planning shells: no tasks.json, no designs/, no spent
+            // cost or completed sessions — nothing to resume.
+            if (state.phase === "planning"
+                && !existsSync(join(runDir, "tasks.json"))
+                && !hasMdFiles(join(runDir, "designs"))
+                && (state.accCost ?? 0) === 0
+                && (state.accCompleted ?? 0) === 0
+                && (state.accFailed ?? 0) === 0) {
+                continue;
+            }
             results.push({ dir: runDir, state });
         }
         return results;

package/dist/swarm.d.ts

@@ -68,6 +68,7 @@ export declare class Swarm {
     private activeQueries;
     private cleanedUp;
     private pendingTools;
+    private ctxWarned;
     logFile?: string;
     readonly model: string | undefined;
     usageCap: number | undefined;

package/dist/swarm.js

@@ -3,9 +3,10 @@ import { join } from "path";
 import { tmpdir } from "os";
 import chalk from "chalk";
 import { query } from "@anthropic-ai/claude-agent-sdk";
-import { NudgeError, RATE_LIMIT_WINDOW_SHORT } from "./types.js";
+import { NudgeError, RATE_LIMIT_WINDOW_SHORT, extractToolTarget, sumUsageTokens } from "./types.js";
 import { gitExec, autoCommit, mergeAllBranches, warnDirtyTree, cleanStaleWorktrees, writeSwarmLog } from "./merge.js";
 import { ensureCursorProxyRunning } from "./providers.js";
+import { getModelCapability } from "./models.js";
 const SIMPLIFY_PROMPT = `You just finished your task. Now review and simplify your changes.
 
 Run \`git diff\` to see what you changed, then fix any issues:
@@ -76,6 +77,7 @@ export class Swarm {
     // with empty `input` and streams the real payload via `input_json_delta`, so we
     // need to wait for content_block_stop before we can log the file/path target.
     pendingTools = new WeakMap();
+    ctxWarned = new WeakSet();
     logFile;
     model;
     usageCap;
@@ -449,7 +451,7 @@ export class Swarm {
             return;
         }
         const id = this.nextId++;
-        const agent = { id, task, status: "running", startedAt: Date.now(), toolCalls: 0 };
+        const agent = { id, task, status: "running", startedAt: Date.now(), toolCalls: 0, contextTokens: 0 };
         this.agents.push(agent);
         let agentCwd = task.agentCwd || task.cwd || this.config.cwd;
         if (this.config.useWorktrees && this.worktreeBase && !task.noWorktree && !task.agentCwd) {
@@ -706,12 +708,7 @@ export class Swarm {
     // ── Message handler ──
     /** Log a tool invocation with a short target extracted from its input. */
     logToolUse(agent, name, input) {
-        const p = input.path ?? input.file_path ?? input.pattern;
-        const target = typeof p === "string" && p
-            ? p
-            : typeof input.command === "string" && input.command
-                ? input.command.split(" ").slice(0, 3).join(" ")
-                : "";
+        const target = extractToolTarget(input);
         this.log(agent.id, target ? `${name} \u2192 ${target}` : name);
     }
     handleMsg(agent, msg) {
@@ -725,6 +722,22 @@ export class Swarm {
         switch (msg.type) {
             case "assistant": {
                 const m = msg;
+                const u = m.message?.usage;
+                if (u) {
+                    const turnTotal = sumUsageTokens(u);
+                    if (turnTotal > (agent.contextTokens ?? 0)) {
+                        agent.contextTokens = turnTotal;
+                        if (!this.ctxWarned.has(agent)) {
+                            const mdl = agent.task.model || this.config.model || "unknown";
+                            const safe = getModelCapability(mdl).safeContext;
+                            if (safe > 0 && turnTotal > safe * 0.8) {
+                                this.ctxWarned.add(agent);
+                                const pct = Math.round((turnTotal / safe) * 100);
+                                this.log(agent.id, `\u26A0 context ${pct}% of safe window — task may degrade`);
+                            }
+                        }
+                    }
+                }
                 if (!m.message?.content)
                     break;
                 for (const block of m.message.content) {

package/dist/types.d.ts

@@ -80,6 +80,8 @@ export interface AgentState {
     filesChanged?: number;
     /** Unix timestamp (ms) when this agent entered a rate-limit wait inside its retry loop. Cleared when work resumes. */
     blockedAt?: number;
+    /** Peak total input tokens (input + cache_read + cache_creation) seen in any single turn — a proxy for current context-window occupancy. */
+    contextTokens?: number;
 }
 /** A timestamped log line from an agent's execution. */
 export interface LogEntry {
@@ -151,7 +153,7 @@ export interface SteerResult {
     statusUpdate?: string;
     estimatedSessionsRemaining?: number;
 }
-/** Accumulated run memory  -- designs, verifications, etc.  -- fed to the steerer. */
+/** RunMemory accumulates run designs, reflections, verifications, milestones, status, goal, and previous runs. */
 export interface RunMemory {
     designs: string;
     reflections: string;
@@ -235,3 +237,20 @@ export interface RunState extends RunConfigBase {
     /** Working directory for the run. */
     cwd: string;
 }
+/** Function that returns a rate-limit snapshot with optional context token info. */
+export type RLGetter = () => {
+    utilization: number;
+    isUsingOverage: boolean;
+    windows: Map<string, RateLimitWindow>;
+    resetsAt?: number;
+    contextTokens?: number;
+    model?: string;
+};
+/** Pick a short, human-readable target for a tool invocation (Read/Grep/Bash/...). */
+export declare function extractToolTarget(input: Record<string, unknown> | undefined): string;
+/** Sum input + cache read + cache creation tokens from a usage object. */
+export declare function sumUsageTokens(u: {
+    input_tokens?: number;
+    cache_read_input_tokens?: number;
+    cache_creation_input_tokens?: number;
+}): number;

package/dist/types.js

@@ -11,3 +11,19 @@ export class NudgeError extends Error {
         this.name = "NudgeError";
     }
 }
+/** Pick a short, human-readable target for a tool invocation (Read/Grep/Bash/...). */
+export function extractToolTarget(input) {
+    if (!input)
+        return "";
+    const p = input.path ?? input.file_path ?? input.pattern;
+    if (typeof p === "string" && p)
+        return p;
+    if (typeof input.command === "string" && input.command) {
+        return input.command.split(" ").slice(0, 3).join(" ");
+    }
+    return "";
+}
+/** Sum input + cache read + cache creation tokens from a usage object. */
+export function sumUsageTokens(u) {
+    return (u.input_tokens ?? 0) + (u.cache_read_input_tokens ?? 0) + (u.cache_creation_input_tokens ?? 0);
+}

package/dist/ui.d.ts

@@ -1,5 +1,6 @@
 import type { Swarm } from "./swarm.js";
-import type { RateLimitWindow, WaveSummary } from "./types.js";
+import type { RLGetter, WaveSummary } from "./types.js";
+import { InteractivePanel } from "./interactive-panel.js";
 /** Short-lived context the steering view renders around its live log. */
 export interface SteeringContext {
     objective?: string;
@@ -43,12 +44,6 @@ export interface AskState {
     streaming: boolean;
     error?: string;
 }
-type RLGetter = () => {
-    utilization: number;
-    isUsingOverage: boolean;
-    windows: Map<string, RateLimitWindow>;
-    resetsAt?: number;
-};
 export declare class RunDisplay {
     readonly runInfo: RunInfo;
     private liveConfig?;
@@ -72,12 +67,11 @@ export declare class RunDisplay {
     /** ID of the agent whose detail panel is open; undefined = no detail shown. */
     private selectedAgentId?;
     private navState;
+    /** Interactive panel for debrief, Q&A, and other user-facing content. */
+    readonly panel: InteractivePanel;
     private onSteer?;
     private onAsk?;
-    private debriefText?;
-    /** Get the latest debrief line for footer rendering. */
-    getDebrief(): string | undefined;
-    /** Set or clear the debrief text shown in the footer. */
+    /** Set or clear the debrief text shown in the interactive panel. */
     setDebrief(text: string | undefined): void;
     constructor(runInfo: RunInfo, liveConfig?: LiveConfig, callbacks?: {
         onSteer?: (text: string) => void;
@@ -124,7 +118,6 @@ export declare class RunDisplay {
     private flush;
     private render;
     private renderInputPrompt;
-    private renderAskPanel;
     private hasHotkeys;
     private setupHotkeys;
     /** Handle a pasted block. Returns true if the frame needs a redraw. */
@@ -145,4 +138,3 @@ export declare class RunDisplay {
     private handleTyped;
     private plainTick;
 }
-export {};

package/dist/ui.js

@@ -5,9 +5,14 @@ import { mkdtempSync, writeFileSync, rmSync } from "fs";
 import { tmpdir } from "os";
 import { join } from "path";
 import { execSync } from "child_process";
+import { InteractivePanel } from "./interactive-panel.js";
 const MAX_STEERING_EVENTS = 60;
 const MAX_INPUT_LEN = 600;
 const MAX_ASK_LINES = 40;
+/** Visible lines for the ask panel, clamped to leave room for header/content/footer/input. */
+function askDisplayCap() {
+    return Math.max(3, Math.min(MAX_ASK_LINES, (process.stdout.rows || 40) - 20));
+}
 let askTempDir;
 export class RunDisplay {
     runInfo;
@@ -32,13 +37,19 @@ export class RunDisplay {
     /** ID of the agent whose detail panel is open; undefined = no detail shown. */
     selectedAgentId;
     navState = { focusSection: 0, focusRow: 0, scrollOffset: 0 };
+    /** Interactive panel for debrief, Q&A, and other user-facing content. */
+    panel = new InteractivePanel();
     onSteer;
     onAsk;
-    debriefText;
-    /** Get the latest debrief line for footer rendering. */
-    getDebrief() { return this.debriefText; }
-    /** Set or clear the debrief text shown in the footer. */
-    setDebrief(text) { this.debriefText = text; }
+    /** Set or clear the debrief text shown in the interactive panel. */
+    setDebrief(text) {
+        if (text) {
+            this.panel.set({ mode: "debrief", header: "Debrief", preview: text, body: text });
+        }
+        else if (this.panel.state.mode === "debrief") {
+            this.panel.set({ mode: "none", header: "", preview: "", body: "" });
+        }
+    }
     constructor(runInfo, liveConfig, callbacks) {
         this.runInfo = runInfo;
         this.liveConfig = liveConfig;
@@ -54,7 +65,7 @@ export class RunDisplay {
         // Write full answer to temp file when streaming is done and answer is long
         if (state && !state.streaming && !state.error && state.answer) {
             const lines = state.answer.split("\n");
-            if (lines.length > MAX_ASK_LINES) {
+            if (lines.length > askDisplayCap()) {
                 try {
                     askTempDir = mkdtempSync(join(tmpdir(), "overnight-ask-"));
                     this.askTempFile = join(askTempDir, "answer.txt");
@@ -62,6 +73,20 @@ export class RunDisplay {
                 }
                 catch { }
             }
+            // Also populate the panel with the Q&A content
+            const preview = state.answer.split("\n")[0]?.slice(0, 120) || "(answered)";
+            this.panel.set({
+                mode: "ask",
+                header: `Ask`,
+                preview,
+                body: `Q: ${state.question}\n\nA: ${state.answer}`,
+            });
+        }
+        else if (state && state.error) {
+            this.panel.set({ mode: "ask", header: "Ask", preview: state.error, body: `Q: ${state.question}\n\nError: ${state.error}` });
+        }
+        else if (!state && this.panel.state.mode === "ask") {
+            this.panel.set({ mode: "none", header: "", preview: "", body: "" });
         }
     }
     /** Signal to the UI whether an ask is in progress (prevents duplicate firings). */
@@ -364,23 +389,25 @@ export class RunDisplay {
         }
     }
     render(maxRows) {
-        // Compute how many rows the input prompt + ask panel need so the
-        // main frame can shrink its content area to leave room.
+        // Compute how many rows the bottom area (input prompt + collapsed panel) need.
         const inputPrompt = this.renderInputPrompt();
-        const askPanel = this.renderAskPanel();
-        const bottom = inputPrompt + askPanel;
-        const bottomRows = bottom ? (bottom.match(/\n/g) || []).length : 0;
+        const panelCollapsed = this.panel.visible && !this.panel.state.expanded
+            ? this.panel.renderCollapsed(Math.max((process.stdout.columns ?? 80) || 80, 60))
+            : "";
+        const panelExpanded = this.panel.visible && this.panel.state.expanded ? 1 : 0; // 1 = header row, content handled by frame
+        const bottom = inputPrompt + (panelCollapsed ? "\n" + panelCollapsed : "");
+        const bottomRows = bottom ? (bottom.match(/\n/g) || []).length + 1 : 0;
         const frameBudget = maxRows != null ? maxRows - bottomRows : undefined;
         let frame = "";
         if (this.swarm) {
-            frame = renderFrame(this.swarm, this.hasHotkeys(), this.runInfo, this.selectedAgentId, frameBudget, this.debriefText);
+            frame = renderFrame(this.swarm, this.hasHotkeys(), this.runInfo, this.selectedAgentId, frameBudget, this.panel);
         }
         else if (this.steeringActive) {
             frame = renderSteeringFrame(this.runInfo, {
                 statusLine: this.steeringStatusLine,
                 events: this.steeringEvents,
                 context: this.steeringContext,
-            }, this.hasHotkeys(), this.rlGetter, frameBudget, this.debriefText);
+            }, this.hasHotkeys(), this.rlGetter, frameBudget, this.panel);
         }
         else {
             return "";
@@ -411,34 +438,6 @@ export class RunDisplay {
         }
         return "";
     }
-    renderAskPanel() {
-        const a = this.askState;
-        if (!a)
-            return "";
-        const out = ["", chalk.gray("  \u2500\u2500\u2500 Ask " + "\u2500".repeat(40))];
-        out.push(`  ${chalk.bold.cyan("Q:")} ${a.question}`);
-        if (a.error) {
-            out.push(`  ${chalk.red("A:")} ${chalk.red(a.error)}`);
-        }
-        else if (a.streaming) {
-            out.push(`  ${chalk.dim("A: " + (a.answer || "thinking..."))}`);
-        }
-        else {
-            const allLines = a.answer.split("\n");
-            const showLines = allLines.slice(0, MAX_ASK_LINES);
-            out.push(`  ${chalk.bold.green("A:")} ${showLines[0] || ""}`);
-            for (const ln of showLines.slice(1))
-                out.push(`     ${ln}`);
-            if (allLines.length > MAX_ASK_LINES) {
-                const overflow = allLines.length - MAX_ASK_LINES;
-                out.push(chalk.dim(`     \u2026 + ${overflow} more lines`));
-                if (this.askTempFile) {
-                    out.push(chalk.dim("  \u23CE Enter to reveal full answer in Finder"));
-                }
-            }
-        }
-        return "\n" + out.join("\n");
-    }
     hasHotkeys() {
         return !!this.liveConfig && !!process.stdin.isTTY;
     }
@@ -508,6 +507,24 @@ export class RunDisplay {
         // ── 1. Arrow keys: \x1B[A = up, \x1B[B = down, \x1B[C = right, \x1B[D = left ──
         if (s.startsWith("\x1B[")) {
             const dir = s[2];
+            // When panel is expanded, arrows scroll the panel content
+            if (this.panel.state.expanded) {
+                const rows = Math.max(4, (process.stdout.rows || 40) - 10);
+                if (dir === "A") {
+                    this.panel.scroll("up", rows);
+                    return true;
+                }
+                if (dir === "B") {
+                    this.panel.scroll("down", rows);
+                    return true;
+                }
+                // Left/right: collapse or pass through
+                if (dir === "D") {
+                    this.panel.collapse();
+                    return true;
+                }
+                return true;
+            }
             if (dir === "A") {
                 this.navigate("up");
                 return true;
@@ -672,6 +689,14 @@ export class RunDisplay {
             }
             return true;
         }
+        // Ctrl+O: toggle interactive panel expand/collapse
+        if (s === "\x0F") {
+            if (this.panel.visible) {
+                this.panel.toggle();
+                return true;
+            }
+            return false;
+        }
         // Only single printable ASCII characters reach hotkey matching
         if (s.length !== 1)
             return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-overnight",
-  "version": "1.25.23",
+  "version": "1.25.24",
   "description": "Parallel Claude agents in git worktrees with a usage cap that reserves headroom for your interactive Claude Code. Crash-safe resume. Provider-agnostic model catalog (Anthropic, Cursor, OpenAI, Gemini, DeepSeek, Llama, Qwen) with capability-based task scoping.",
   "type": "module",
   "bin": {

package/plugins/claude-overnight/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-overnight",
-  "version": "1.25.23",
+  "version": "1.25.24",
   "description": "Claude Code skill for understanding, installing, and inspecting claude-overnight runs  -- parallel Claude agents in git worktrees with thinking waves, multi-wave steering, and crash-safe resume. Supports Cursor API Proxy, Qwen, OpenRouter.",
   "author": {
     "name": "Francesco Fornace"