pi-mega-compact 0.8.16 → 0.8.18

package/dist/extensions/dashboard-server/html/styles.js

@@ -0,0 +1,103 @@
+/**
+ * Inline CSS for the dashboard.
+ *
+ * Extracted verbatim from the original monolithic `html-template.ts`.
+ * Kept as a single cohesive stylesheet — splitting CSS into per-tab files
+ * would fragment the design system (shared tokens, e.g. `.card`, `.stat-grid`,
+ * `.meter-*` are reused across all tabs).
+ */
+export function styles() {
+    return `<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; background: #0d1117; color: #c9d1d9; padding: 24px; line-height: 1.5; }
+  h1 { font-size: 20px; font-weight: 600; margin-bottom: 20px; display: flex; align-items: center; gap: 10px; color: #f0f6fc; }
+  h1 .tier { background: #1f6feb; color: #fff; font-size: 11px; font-weight: 700; padding: 2px 8px; border-radius: 10px; text-transform: uppercase; letter-spacing: .5px; }
+  .grid { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-bottom: 20px; }
+  .card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; }
+  .card.safe { border-color: #238636; }
+  .card.safe h2 { color: #3fb950; }
+  .safe-note { font-size: 12px; color: #8b949e; margin: 12px 0 0; line-height: 1.5; }
+  .value.ok { color: #3fb950; }
+  .label {
+    cursor: help;
+    border-bottom: 1px dotted #484f58;
+  }
+  .card.legend { grid-column: 1 / -1; }
+  .legend-list { margin: 0; padding-left: 18px; color: #c9d1d9; }
+  .legend-list li { margin-bottom: 8px; line-height: 1.5; }
+  .legend-list b { color: #f0f6fc; }
+  .legend-note { font-size: 12px; color: #8b949e; margin: 12px 0 0; font-style: italic; }
+  .card h2 { font-size: 12px; text-transform: uppercase; letter-spacing: .5px; color: #8b949e; margin-bottom: 12px; font-weight: 600; }
+  .meter-track { background: #21262d; border-radius: 4px; height: 20px; overflow: hidden; margin: 8px 0; }
+  .meter-fill { height: 100%; border-radius: 4px; transition: width .6s ease; min-width: 2px; }
+  .meter-green { background: #238636; }
+  .meter-yellow { background: #d29922; }
+  .meter-red { background: #f85149; }
+  .meter-label { font-size: 24px; font-weight: 700; color: #f0f6fc; }
+  .meter-sub { font-size: 12px; color: #8b949e; }
+  .status-row { display: flex; align-items: center; gap: 8px; margin: 6px 0; font-size: 14px; }
+  .status-row .bullet { width: 8px; height: 8px; border-radius: 50%; flex-shrink: 0; }
+  .bullet-on { background: #3fb950; box-shadow: 0 0 6px #3fb95088; }
+  .bullet-off { background: #484f58; }
+  .bullet-na { background: #d29922; }
+  .state-text { font-size: 13px; color: #8b949e; margin-top: 8px; font-family: monospace; }
+  .stat-grid { display: grid; grid-template-columns: auto 1fr; gap: 4px 12px; font-size: 14px; }
+  .stat-grid .label { color: #8b949e; }
+  .stat-grid .value { color: #f0f6fc; font-weight: 600; font-family: monospace; }
+  .conf-grid { display: grid; grid-template-columns: auto 1fr; gap: 4px 12px; font-size: 14px; }
+  .conf-grid .label { color: #8b949e; }
+  .conf-grid .value { color: #f0f6fc; font-family: monospace; }
+  .events { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; }
+  .events h2 { font-size: 12px; text-transform: uppercase; letter-spacing: .5px; color: #8b949e; margin-bottom: 12px; font-weight: 600; }
+  .events-wrap { max-height: 240px; overflow-y: auto; font-family: monospace; font-size: 12px; }
+  .ev { padding: 3px 0; border-bottom: 1px solid #21262d; display: flex; gap: 8px; align-items: baseline; }
+  .ev:last-child { border-bottom: none; }
+  .ev-type { font-weight: 700; min-width: 70px; text-align: right; }
+  .ev-type-compact { color: #3fb950; }
+  .ev-type-recall { color: #a371f7; }
+  .ev-time { color: #484f58; font-size: 10px; min-width: 80px; }
+  .ev-detail { color: #8b949e; flex: 1; }
+  .updated { font-size: 11px; color: #484f58; margin-top: 16px; text-align: right; }
+  .empty { color: #484f58; font-style: italic; font-size: 13px; padding: 8px 0; }
+  .offline-banner { background: #f8514922; border: 1px solid #f85149; border-radius: 6px; padding: 10px 16px; margin-bottom: 16px; font-size: 13px; color: #f85149; display: none; }
+  .tabs { display: flex; gap: 8px; margin-bottom: 20px; }
+  .tab { background: #161b22; color: #8b949e; border: 1px solid #30363d; border-radius: 6px; padding: 8px 16px; font-size: 13px; font-weight: 600; cursor: pointer; transition: all .15s ease; }
+  .tab:hover { color: #c9d1d9; border-color: #484f58; }
+  .tab.active { background: #1f6feb; color: #fff; border-color: #1f6feb; }
+  .tab.future { opacity: .7; }
+  .tab .soon { font-size: 9px; font-weight: 700; background: #6e40c9; color: #fff; padding: 1px 6px; border-radius: 8px; margin-left: 6px; text-transform: uppercase; letter-spacing: .5px; }
+  .tab-panel { display: none; }
+  .tab-panel.active { display: block; }
+  .summary-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 16px; margin-bottom: 20px; }
+  .summary-card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; }
+  .summary-card .num { font-size: 24px; font-weight: 700; color: #f0f6fc; }
+  .summary-card .lbl { font-size: 12px; color: #8b949e; text-transform: uppercase; letter-spacing: .5px; margin-top: 4px; }
+  table.repos { width: 100%; border-collapse: collapse; background: #161b22; border: 1px solid #30363d; border-radius: 8px; overflow: hidden; }
+  table.repos th, table.repos td { text-align: left; padding: 10px 14px; font-size: 13px; border-bottom: 1px solid #21262d; }
+  table.repos th { color: #8b949e; text-transform: uppercase; letter-spacing: .5px; font-size: 11px; background: #0d1117; }
+  table.repos td.num { font-family: monospace; color: #f0f6fc; text-align: right; }
+  table.repos tr:last-child td { border-bottom: none; }
+  table.repos tr:hover td { background: #1c2128; }
+  .repo-model { color: #a371f7; }
+  .repo-none { color: #484f58; font-style: italic; }
+  .updated { font-size: 11px; color: #484f58; margin-top: 16px; text-align: right; }
+  .model-pill { background: #6e40c9; color: #fff; font-size: 11px; font-weight: 700; padding: 2px 8px; border-radius: 10px; text-transform: uppercase; letter-spacing: .5px; }
+  .card.cost h2 { color: #a371f7; }
+  .cost-usd { font-size: 22px; font-weight: 700; color: #3fb950; }
+  .cost-sub { font-size: 12px; color: #8b949e; margin-top: 4px; }
+  .repo-link { cursor: pointer; }
+  .repo-link:hover td { color: #58a6ff; }
+  .repo-detail { position: fixed; inset: 0; background: rgba(0,0,0,.6); display: none; align-items: center; justify-content: center; z-index: 50; }
+  .repo-detail.open { display: flex; }
+  .repo-detail-box { background: #161b22; border: 1px solid #30363d; border-radius: 10px; padding: 24px; width: 560px; max-width: 92vw; max-height: 86vh; overflow-y: auto; }
+  .repo-detail-box h2 { font-size: 14px; color: #f0f6fc; margin-bottom: 14px; display: flex; justify-content: space-between; align-items: center; }
+  .repo-close { cursor: pointer; color: #8b949e; font-size: 20px; line-height: 1; border: none; background: none; padding: 0 4px; }
+  .repo-close:hover { color: #f0f6fc; }
+  .repo-path { font-size: 11px; color: #484f58; word-break: break-all; margin: -8px 0 12px; }
+  .placeholder { text-align: center; padding: 48px 16px; color: #8b949e; }
+  .placeholder .em { font-size: 40px; margin-bottom: 12px; }
+  .placeholder h2 { font-size: 16px; color: #f0f6fc; margin-bottom: 8px; }
+  .placeholder p { font-size: 13px; line-height: 1.6; max-width: 420px; margin: 0 auto; }
+</style>
+`;
+}

package/dist/extensions/dashboard-server/html/summary-tab.js

@@ -0,0 +1,19 @@
+/**
+ * "Summary" tab panel — aggregate counts across all registered repos.
+ *
+ * Populated by the index poller in `script.ts`.
+ */
+export function summaryTab() {
+    return `<!-- Summary (aggregate across all repos) -->
+<div class="tab-panel" id="panel-summary">
+  <div class="summary-grid">
+    <div class="summary-card"><div class="num" id="sm-repos">0</div><div class="lbl">Repositories</div></div>
+    <div class="summary-card"><div class="num" id="sm-checkpoints">0</div><div class="lbl">Total Checkpoints</div></div>
+    <div class="summary-card"><div class="num" id="sm-saved">0</div><div class="lbl">Total Tokens Saved</div></div>
+    <div class="summary-card"><div class="num" id="sm-bytes">0 B</div><div class="lbl">Compressed-Original</div></div>
+  </div>
+  <div class="updated" id="sm-updated"></div>
+</div>
+
+`;
+}

package/dist/extensions/dashboard-server/html-template.js

@@ -0,0 +1,41 @@
+/**
+ * HTML template for the dashboard server — composer.
+ *
+ * Originally a single 518-line monolithic file returning one large HTML page
+ * template. Split into per-concern fragments under `./html/` (each tab is its
+ * own file; plus shared styles, header chrome, the repo-detail modal, and the
+ * client script). This file composes them back into the full document.
+ *
+ * `tierName` is threaded into the heading badge and the Configuration card.
+ *
+ * Fragment layout:
+ *   headOpen()            — <!DOCTYPE html>…<title>
+ *   styles()              — <style>…</style>  (shared CSS, design-system level)
+ *   bodyOpen(tier)        — </head><body>…<h1>…</nav>  (incl. High Score future tab)
+ *   currentRepoTab(tier)  — panel-current (cards + event stream + in-panel table)
+ *   allReposTab()         — panel-all (machine-wide repo table)
+ *   summaryTab()          — panel-summary (aggregate cards)
+ *   highScoreTab()        — panel-highscore (FUTURE placeholder, next milestone)
+ *   repoDetailModal()     — per-repo overlay (position-independent)
+ *   script()              — <script>…</script></body></html>
+ */
+import { headOpen } from "./html/head-open.js";
+import { styles } from "./html/styles.js";
+import { bodyOpen } from "./html/body-open.js";
+import { currentRepoTab } from "./html/current-repo-tab.js";
+import { allReposTab } from "./html/all-repos-tab.js";
+import { summaryTab } from "./html/summary-tab.js";
+import { highScoreTab } from "./html/high-score-tab.js";
+import { repoDetailModal } from "./html/repo-detail-modal.js";
+import { script } from "./html/script.js";
+export function dashboardHtml(tierName) {
+    return (headOpen() +
+        styles() +
+        bodyOpen(tierName) +
+        currentRepoTab(tierName) +
+        repoDetailModal() +
+        allReposTab() +
+        summaryTab() +
+        highScoreTab() +
+        script());
+}

package/dist/extensions/dashboard-server/server.js

@@ -691,6 +691,89 @@ export async function launchDashboardServer(stateDir) {
             }
             return;
         }
+        // /api/sessions — S39: active pi sessions with latest token usage + heartbeat.
+        // GET returns {updatedAt, pruned, sessions[]} after pruning stale heartbeats.
+        // The dashboard server is a detached child with no MegaRuntime ref, so it
+        // reads session_heartbeats via a require()'d sqlite helper (same pattern as
+        // /api/achievements, /api/perf). Non-GET -> 405. PREVENT-PI-004: loopback.
+        if (req.url?.startsWith("/api/sessions")) {
+            // Guard: /api/sessions/timeseries handled separately below.
+            if (req.url.startsWith("/api/sessions/timeseries")) {
+                // Fall through to the timeseries handler below.
+            }
+            else {
+                const sReq = createRequire(import.meta.url);
+                const { readActiveSessions, pruneStaleSessions, listRepoRegistry, } = sReq("../../src/store/sqlite.js");
+                if (req.method !== "GET") {
+                    res.writeHead(405, { "Content-Type": "application/json" }); // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+                    res.end(JSON.stringify({ error: "method_not_allowed" }));
+                    return;
+                }
+                try {
+                    const pruned = pruneStaleSessions(); // guardrails-allow PREVENT-PI-004: local SQLite read (loopback dashboard)
+                    const active = readActiveSessions();
+                    const repos = listRepoRegistry();
+                    const repoMap = new Map(repos.map((r) => [r.repoRoot, r]));
+                    const sessions = active.map((s) => ({
+                        pid: s.pid,
+                        sessionId: s.sessionId,
+                        repoRoot: s.repoRoot,
+                        displayName: s.repoRoot
+                            ? (s.repoRoot.split(/[\\/]/).filter(Boolean).pop() ?? s.repoRoot)
+                            : (s.stateDir?.split(/[\\/]/).filter(Boolean).pop() ?? "unknown"),
+                        model: s.repoRoot ? (repoMap.get(s.repoRoot)?.modelName ?? null) : null,
+                        tokens: s.tokens,
+                        percent: s.percent,
+                        ctxWindow: s.ctxWindow,
+                        lastSeen: s.lastSeen,
+                        stateDir: s.stateDir,
+                    }));
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ updatedAt: new Date().toISOString(), pruned, sessions }));
+                }
+                catch (e) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: "sessions_unavailable", detail: String(e) }));
+                }
+                return;
+            }
+        }
+        // /api/sessions/timeseries — S39: stacked per-session token timeseries for
+        // the recharts memory graph. GET ?minutes=N (clamped [1,1440]) returns
+        // {updatedAt, windowMinutes, series[], totals[]} in recharts-ready shape.
+        // Non-GET -> 405. PREVENT-PI-004: loopback.
+        if (req.url?.startsWith("/api/sessions/timeseries")) {
+            const tsReq = createRequire(import.meta.url);
+            const { readSessionTimeseries, pruneTokenSamples, } = tsReq("../../src/store/sqlite.js");
+            if (req.method !== "GET") {
+                res.writeHead(405, { "Content-Type": "application/json" }); // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+                res.end(JSON.stringify({ error: "method_not_allowed" }));
+                return;
+            }
+            try {
+                const url = new URL(req.url, "http://x"); // guardrails-allow PREVENT-PI-004: localhost dashboard URL base (loopback-only)
+                let minutes = Number(url.searchParams.get("minutes") ?? "30");
+                if (!Number.isFinite(minutes) || minutes <= 0)
+                    minutes = 30;
+                minutes = Math.min(Math.max(minutes, 1), 1440);
+                const sinceTs = Date.now() - minutes * 60_000;
+                const pruneMs = Math.max(minutes * 60_000, 1_800_000);
+                pruneTokenSamples(pruneMs); // guardrails-allow PREVENT-PI-004: local SQLite read (loopback dashboard)
+                const result = readSessionTimeseries(sinceTs); // guardrails-allow PREVENT-PI-004: local SQLite read (loopback dashboard)
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    updatedAt: new Date().toISOString(),
+                    windowMinutes: minutes,
+                    series: result.series,
+                    totals: result.totals,
+                }));
+            }
+            catch (e) {
+                res.writeHead(500, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "timeseries_unavailable", detail: String(e) }));
+            }
+            return;
+        }
         // Fallback — serve the React client build (SPA route) or legacy dashboard.
         // Non-/api/* GETs hit here: serve client assets if built, else inline HTML.
         if (req.method === "GET" &&

package/dist/extensions/mega-compact-s38.test.js

@@ -179,6 +179,39 @@ test("S38: classifyError returns 'compaction-noop' for 'Auto compaction failed'
     assert.equal(classifyErrorFn("Auto compaction failed"), "compaction-noop");
     assert.equal(classifyErrorFn("Auto-compaction failed"), "compaction-noop");
 });
+// ---- context-overflow classifier (S38.8: 400 "too long... even after compaction") ----
+test("S38: classifyError returns 'context-overflow' for the literal user 400 string", () => {
+    assert.equal(classifyErrorFn("Your conversation is too long for this model's context window even after compaction. Reduce the conversation length or enable/allow compaction."), "context-overflow");
+});
+test("S38: classifyError returns 'context-overflow' for 'All targets failed' wrapper", () => {
+    assert.equal(classifyErrorFn("All targets failed: ... Last error: ... too long ... context window even after compaction"), "context-overflow");
+});
+test("S38: classifyError returns 'context-overflow' for invalid_request_error JSON shape", () => {
+    assert.equal(classifyErrorFn('{"type":"invalid_request_error","message":"... too long for context window ..."}'), "context-overflow");
+});
+test("S38: classifyError returns 'context-overflow' for OpenRouter 'All targets failed' max-context 400 (FAIL-20260725)", () => {
+    // Regression: the OpenAI/OpenRouter provider-side phrasing
+    // "maximum context length is N tokens ... requires at least M tokens ...
+    // reduce your input or max_tokens" does NOT contain "too long" / "context
+    // window" / "reduce the conversation", so it slipped past the original S38.8
+    // regex and fell through to the generic transient branch, firing 5 blind
+    // retry nudges that re-submitted the same oversized prompt -> re-400 ->
+    // busy-loop. The exact user-facing wrapper string from the router:
+    assert.equal(classifyErrorFn('Error: 400: {"message":"All targets failed: neuralwatt/glm-5.2-short. Last error: This model\'s maximum context length is 200000 tokens. Your request requires at least 201070 tokens (201070 prompt + 0 max_tokens). Please reduce your input or max_tokens.","type":"invalid_request_error"}'), "context-overflow");
+});
+test("S38: classifyError returns 'context-overflow' for bare 'maximum context length' phrasing", () => {
+    assert.equal(classifyErrorFn("This model's maximum context length is 128000 tokens. Your request requires at least 130000 tokens. Please reduce your input or max_tokens."), "context-overflow");
+});
+test("S38: classifyError returns 'context-overflow' for 'context length exceeded' phrasing", () => {
+    assert.equal(classifyErrorFn("This model's context length exceeded: 200000 tokens"), "context-overflow");
+});
+test("S38: context-overflow fires NO blind retry nudge and logs 'context_overflow'", async () => {
+    const h = harness();
+    await s38TurnEnd(h, "error", "Your conversation is too long for this model's context window even after compaction. Reduce the conversation length or enable/allow compaction.");
+    const ev = eventTypes(h.stateDir);
+    assert.equal(h.sendUserMessages.length, 0, "context-overflow: NO blind retry nudge fired");
+    assert.ok(ev.includes("context_overflow"), "context-overflow: 'context_overflow' event logged");
+});
 // ---- integration tests (fire turn_end through the real extension) ----
 test("S38: compaction-noop logs 'compaction_noop_diagnostic' + resets counter + no retry fired", async () => {
     const h = harness();

package/dist/extensions/mega-events/agent-handlers.js

@@ -5,6 +5,7 @@ import { evaluateAndUnlockAchievements } from "../../src/store/sqlite/game-achie
 import { isMegaCache } from "../../src/game/scoring.js";
 import { resolveRepoRoot } from "../mega-config.js";
 import { classifyError } from "./error-classifier.js";
+import { safeSendUserMessage } from "./send-safe.js";
 /** Register agent/turn tracking event handlers. */
 export function registerAgentHandlers(pi, runtime, config) {
     // ---- Agent tracking for real-time widget + status-line updates ---------
@@ -188,7 +189,7 @@ export function registerAgentHandlers(pi, runtime, config) {
                     const nudgeMsg = lengthStop && !didDurableTrim
                         ? "[mega-compact] the last response hit the output-token cap; continue from where it stopped."
                         : "[mega-compact] continue from the compacted context above.";
-                    pi.sendUserMessage(nudgeMsg);
+                    await safeSendUserMessage(pi, nudgeMsg);
                 }
             }
             catch {
@@ -312,6 +313,53 @@ export function registerAgentHandlers(pi, runtime, config) {
                         turnIndex: event.turnIndex,
                     });
                 }
+                else if (category === 'context-overflow') {
+                    // (4b) context-window overflow 400 ("too long... even after compaction").
+                    // NOT a blind retry: re-submitting the same oversized prompt would just
+                    // re-400 and busy-loop. Reset the counters (this turn is terminal, not
+                    // retryable in the S38 sense) and force ONE best-effort re-compact with
+                    // the debounce bypassed + the same race-guard (lastNativeCompactAt
+                    // cooldown + deferred setTimeout re-check) as the agent_end durable
+                    // trim. Resume after that forced compact is handled by the existing
+                    // nudgeResume() inside session_before_compact (it fires after
+                    // driveNativeCompaction supplies the compaction) — do NOT add a
+                    // separate nudge here.
+                    runtime.rt.errorRetryCount = 0;
+                    runtime.rt.consecutiveErrors = 0;
+                    runtime.dashboard.event('context_overflow', {
+                        turnIndex: event.turnIndex,
+                        sessionId: runtime.rt.sessionId,
+                    });
+                    runtime.logger.warn('context-overflow', {
+                        sessionId: runtime.rt.sessionId,
+                        turnIndex: event.turnIndex,
+                    });
+                    if (config.auto) {
+                        const now2 = Date.now();
+                        const cooldownMs2 = config.raceGuardStrict ? 30_000 : 10_000;
+                        const sinceCompact2 = now2 - (runtime.rt.lastNativeCompactAt ?? 0);
+                        if (sinceCompact2 >= cooldownMs2 && !piCompactWouldNoop(ctx)) {
+                            runtime.debounceUntil = now2 + 0;
+                            const stamp2 = runtime.rt.lastNativeCompactAt;
+                            const liveSid2 = runtime.rt.sessionId;
+                            setTimeout(() => {
+                                try {
+                                    if (runtime.rt.sessionId !== liveSid2)
+                                        return; // session reset
+                                    const since3 = Date.now() - (runtime.rt.lastNativeCompactAt ?? 0);
+                                    if (runtime.rt.lastNativeCompactAt !== stamp2 && since3 < cooldownMs2)
+                                        return;
+                                    if (piCompactWouldNoop(ctx))
+                                        return;
+                                    ctx.compact({ customInstructions: undefined }); // guardrails-allow PREVENT-PI-004: local ctx.compact() — no network; deferred + re-validated. Forced re-compact after a context-overflow 400.
+                                }
+                                catch {
+                                    /* non-fatal */
+                                }
+                            }, 500);
+                        }
+                    }
+                }
                 else {
                     // (5) transient or permanent — retry with exponential backoff.
                     // S38.7: hard-stop switch — bypass ALL retry logic when set.
@@ -388,8 +436,8 @@ export function registerAgentHandlers(pi, runtime, config) {
                                 count: runtime.rt.errorRetryCount,
                                 max,
                             });
-                            // PREVENT-PI-003: user-role sendUserMessage only.
-                            pi.sendUserMessage('[mega-compact] the last turn ended with an error; please retry.');
+                            // PREVENT-PI-003: user-role sendUserMessage only (queued + catch-guarded).
+                            await safeSendUserMessage(pi, '[mega-compact] the last turn ended with an error; please retry.');
                         }
                     }
                 }

package/dist/extensions/mega-events/compact-handlers.js

@@ -3,6 +3,7 @@ import { estimateBlockTokens } from "../../src/tokens.js";
 import { recordScore, getDedupStats } from "../../src/store/sqlite.js";
 import { evaluateAndUnlockAchievements } from "../../src/store/sqlite/game-achievements.js";
 import { resolveRepoRoot } from "../mega-config.js";
+import { safeSendUserMessage } from "./send-safe.js";
 /**
  * Build a minimal fallback compaction so pi never runs its throwing compact().
  *
@@ -34,13 +35,18 @@ function fallbackCompaction(event) {
 /**
  * Debounced resume-nudge: restart the agent loop after a compaction (which
  * may have stopped it). Idempotent — one nudge per 30s, never blocks.
+ *
+ * Uses safeSendUserMessage ({ deliverAs: 'followUp' } + catch-guard) so that a
+ * nudge fired during session_before_compact (which is mid-prompt-submission,
+ * so the agent can be busy) QUEUES instead of throwing
+ * "Agent is already processing. Specify streamingBehavior (steer or followUp)".
  */
-function nudgeResume(pi, runtime) {
+async function nudgeResume(pi, runtime) {
     try {
         const now = Date.now();
         if (now >= runtime.resumeNudgeUntil) {
             runtime.resumeNudgeUntil = now + 30_000;
-            pi.sendUserMessage("[mega-compact] continue from the compacted context above.");
+            await safeSendUserMessage(pi, "[mega-compact] continue from the compacted context above.");
         }
     }
     catch {
@@ -83,7 +89,7 @@ export function registerCompactHandlers(pi, runtime, config) {
                     tokensBefore: result.compaction.tokensBefore,
                     summaryTokens: result.compaction.estimatedTokensAfter,
                 });
-                nudgeResume(pi, runtime);
+                await nudgeResume(pi, runtime);
                 return { compaction: result.compaction };
             }
             // FIX "compacts but doesn't resume" + "Nothing to compact" regression:
@@ -104,7 +110,7 @@ export function registerCompactHandlers(pi, runtime, config) {
                     tokensBefore: fb.compaction.tokensBefore,
                     reason: event.reason,
                 });
-                nudgeResume(pi, runtime);
+                await nudgeResume(pi, runtime);
                 return { compaction: fb.compaction };
             }
         }

package/dist/extensions/mega-events/error-classifier.js

@@ -11,7 +11,7 @@
  * exclusively (its agent_end nudge path is separate and must not be doubled).
  *
  * @param message  the event.message (a pi AgentMessage) or an error string
- * @returns 'transient' | 'permanent' | 'compaction-noop' | null (success/unknown)
+ * @returns 'transient' | 'permanent' | 'compaction-noop' | 'context-overflow' | null (success/unknown)
  */
 export function classifyError(message) {
     // Resolve a searchable text blob from a pi AgentMessage or raw string.
@@ -84,6 +84,29 @@ export function classifyError(message) {
         return 'compaction-noop';
     if (/auto[\s-]?compaction failed/.test(s))
         return 'compaction-noop';
+    // --- context-overflow (ORDER BEFORE generic transient!) ---
+    // A 400 from the model meaning "the prompt is bigger than the context window."
+    // Catches BOTH provider phrasings so the classification does not depend on
+    // which backend the router landed on:
+    //   - pi/Anthropic wrapper: "too long for this model's context window even
+    //     after compaction. Reduce the conversation length..." ->
+    //     too long | context window | even after compaction | reduce the conversation
+    //   - OpenAI/OpenRouter provider-side (often wrapped in "All targets failed:
+    //     <model>. Last error: ..."): "This model's maximum context length is N
+    //     tokens. Your request requires at least M tokens. Please reduce your
+    //     input or max_tokens." -> maximum context length | context length
+    //     exceeded | requires at least N tokens | reduce your input
+    // All of these carry `invalid_request_error` (UNDERSCORE, not 'invalid
+    // request' space) and would otherwise fall through to the generic
+    // `s.includes('error')` transient branch below, misclassifying as
+    // 'transient' and firing up to 5 blind retry nudges that re-submit the same
+    // oversized prompt -> re-400 -> busy-loop. 'context-overflow' instead forces
+    // ONE deferred re-compact (debounce-bypassed, race-guarded) and fires NO
+    // blind retry nudge. The forced re-compact is shaped by the existing
+    // session_before_compact durable trim (it cannot lower pi's firstKeptEntryId).
+    if (/too long|context window|maximum context length|context length exceeded|requires at least \d+ tokens|even after compaction|reduce the conversation|reduce your input/.test(s)) {
+        return 'context-overflow';
+    }
     // --- transient (retryable) ---
     if (s.includes('error') && !/\b(permanent|invalid request|malformed|bad request|auth|unauthorized|invalid (api )?key|permission)\b/.test(s)) {
         return 'transient'; // generic pi stopReason 'error' / 'aborted'

package/dist/extensions/mega-events/send-safe.js

@@ -0,0 +1,12 @@
+/**
+ * safeSendUserMessage — await + catch-guard + queue-safe wrapper for
+ * pi.sendUserMessage. Never throws; never produces an unhandled rejection.
+ */
+export async function safeSendUserMessage(pi, content) {
+    try {
+        await pi.sendUserMessage(content, { deliverAs: "followUp" });
+    }
+    catch {
+        /* non-fatal: a failed/queued nudge never blocks the agent loop */
+    }
+}

package/dist/extensions/mega-events.js

@@ -17,3 +17,4 @@ export * from "./mega-events/context-handler.js";
 export * from "./mega-events/compact-handlers.js";
 export * from "./mega-events/perf-handler.js";
 export * from "./mega-events/error-classifier.js";
+export * from "./mega-events/send-safe.js";

package/dist/extensions/mega-runtime/state.js

@@ -15,7 +15,7 @@ import { VectorStore } from "../../src/vectorStore.js";
 import { toEngineMessages } from "../../src/adapt.js";
 import { normalizeSessionId } from "../../src/store.js";
 import { Logger } from "../../src/log.js";
-import { recordModelSnapshot, latestModelSnapshot, upsertRepoRegistry, recordRepoModel, getDedupStats, getCompactCount, getRecallInjected, getCacheHitTokensSaved, getGameState, recordPerfSample, } from "../../src/store/sqlite.js";
+import { recordModelSnapshot, latestModelSnapshot, upsertRepoRegistry, recordRepoModel, getDedupStats, getCompactCount, getRecallInjected, getCacheHitTokensSaved, getGameState, recordPerfSample, recordSessionHeartbeat, appendTokenSample, } from "../../src/store/sqlite.js";
 import { detectCrossRepoDrift } from "../../src/driftDetection.js";
 import { repoStateDir, resolveRepoRoot, pressureRatio, pressureFromPct, pressureBand, effectiveThresholdTokens, } from "../mega-config.js";
 import { Dashboard } from "../mega-dashboard.js";
@@ -513,6 +513,22 @@ export class MegaRuntime {
             },
         });
         const perfDiskMs = this.dashboard.lastWriteMs;
+        // S39: record a session heartbeat + token sample into the shared
+        // machine-wide index.sqlite so the dashboard can show a real-time
+        // stacked-memory graph across all active pi processes. Behind the
+        // material-change gate (this code only runs when sig changed). Non-fatal
+        // try/catch mirrors the recordPerfSample pattern below. Skip the token
+        // sample when lastCtxTokens is null (no context data yet).
+        try {
+            const repo = resolveRepoRoot(ctx?.cwd ?? this.currentStateDir) ?? this.currentStateDir;
+            recordSessionHeartbeat(process.pid, this.rt.sessionId, repo, this.currentStateDir, this.lastCtxWindow || 0);
+            if (this.lastCtxTokens != null) {
+                appendTokenSample(this.rt.sessionId, repo, this.lastCtxTokens, this.lastCtxPercent ?? 0, this.lastCtxWindow || 0, join(this.currentStateDir, "events.log"));
+            }
+        }
+        catch {
+            /* non-fatal: S39 monitoring must never block the snapshot path */
+        }
         // Live stats widget above the editor
         if (ctx) {
             // ── gather widget data (computed per snapshot, rendered per frame) ────

package/dist/src/store/sqlite/connection.js

@@ -0,0 +1,35 @@
+/**
+ * Per-repo SQLite connection management (open / reuse / close).
+ *
+ * In-process cache so the same stateDir reuses one connection (and so a fresh
+ * VectorStore over the same dir shares the open DB). Cross-process durability
+ * comes from reopening the same file path — proven by the integration test.
+ */
+import { DatabaseSync } from "node:sqlite";
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { getStateDir } from "../../store.js";
+import { initSchema } from "./schema.js";
+const cache = new Map();
+/** Open (or reuse) the SQLite store for a state dir. */
+export function openStore(stateDir = getStateDir()) {
+    const existing = cache.get(stateDir);
+    if (existing)
+        return existing;
+    if (!existsSync(stateDir))
+        mkdirSync(stateDir, { recursive: true });
+    const db = new DatabaseSync(join(stateDir, "sqlite.db"));
+    db.exec("PRAGMA journal_mode = WAL");
+    db.exec("PRAGMA foreign_keys = ON");
+    initSchema(db);
+    cache.set(stateDir, db);
+    return db;
+}
+/** Close and evict a cached connection (test teardown only). */
+export function closeStore(stateDir) {
+    const db = cache.get(stateDir);
+    if (db) {
+        db.close();
+        cache.delete(stateDir);
+    }
+}