@pi-unipi/compactor 2.3.0 → 2.4.1

package/README.md

@@ -72,14 +72,14 @@ Keyboard:
 
 ### Presets tab
 
-Presets are profiles that set strategies, pipeline switches, sandbox mode, and display mode.
+Presets are profiles that set strategies, the implemented Auto Injection pipeline behavior, and sandbox mode.
 
 | Preset | Intended use | Important effects |
 |---|---|---|
-| `precise` | Code-heavy work, minimal waste | Full compaction sections, safe-only sandbox, opencode display, Pipeline: `ttlCache` + `mmapPragma` on. |
-| `balanced` | Daily/default profile | Compact transcript, balanced display, FTS mode auto, sandbox all, Pipeline: all six switches on. |
-| `thorough` | Debug/audit sessions | Full transcript, verbose display, sandbox all, Pipeline: all six switches on. |
-| `lean` | Quick fixes or short sessions | Brief/minimal compaction sections, no sandbox, no session continuity, Pipeline: all off. |
+| `precise` | Code-heavy work, minimal waste | Full compaction sections, sandbox enabled, Auto Injection off. |
+| `balanced` | Daily/default profile | Compact transcript, sandbox enabled, Auto Injection on. |
+| `thorough` | Debug/audit sessions | Full transcript, sandbox enabled, Auto Injection on. |
+| `lean` | Quick fixes or short sessions | Brief/minimal compaction sections, no sandbox, no session continuity, Auto Injection off. |
 
 The **Project Override** row controls where settings are saved:
 
@@ -99,11 +99,10 @@ These settings control what is extracted into compaction summaries or how relate
 | `Outstanding Context` | `full`, `critical-only`, `off` | Keeps blockers, TODOs, pending decisions, and follow-ups. |
 | `User Preferences` | `all`, `recent-only`, `off` | Preserves user preferences learned during the session. |
 | `Brief Transcript` | `full`, `compact`, `minimal`, `off` | Keeps a rolling recent transcript after the structured sections. |
-| `Session Continuity` | `full`, `essential-only`, `off` | Controls XML-style resume snapshots that help the next turn continue after compaction. |
-| `Sandbox Execution` | `all`, `safe-only`, `off` | Controls agent-facing sandbox availability/intent. Safe-only is intended for less risky execution. |
-| `Tool Display` | `opencode`, `balanced`, `verbose`, `custom` | Controls built-in tool output rendering style and diff display behavior. |
+| `Session Continuity` | `full`, `off` | Controls XML-style resume snapshots. Off prevents snapshot creation and injection; Pi’s normal compaction summary still remains. |
+| `Sandbox Execution` | `all`, `off` | Controls sandbox tool registration. Changes require a session reload. Allowed languages and output limit are enforced from config. |
 
-Config-only legacy field: `fts5Index` remains in the schema for compatibility, but project indexing has moved to `@pi-unipi/cocoindex`.
+Config-only legacy field: `fts5Index` remains in the schema for compatibility, but project indexing has moved to `@pi-unipi/cocoindex`. It is hidden from Compactor settings and presets. Legacy `sessionContinuity.mode: "essential-only"`, `eventCategories`, and `sandboxExecution.mode: "safe-only"` values remain loadable; essential-only behaves as full and safe-only behaves as enabled/all until explicit filtering/security policies are designed. Legacy `toolDisplay` and `showTruncationHints` fields also remain loadable but are deprecated and ignored; their profile names were never mapped to runtime renderer modes. Narrow-terminal diff clamping remains active as independent safety behavior.
 
 ### Auto tab
 
@@ -133,20 +132,15 @@ Example config:
 
 ### Pipeline tab
 
-Pipeline switches are low-level feature flags used by presets and advanced users.
+The Pipeline tab exposes only behavior implemented by the current runtime.
 
 | Setting | Preset behavior | Current effect |
 |---|---|---|
-| `TTL Cache` | On in `precise`, `balanced`, `thorough`; off in `lean` | Reserved/compatibility switch for cache behavior. Search has an internal cache, but this toggle is not currently required for it. |
-| `Auto Injection` | On in `balanced`, `thorough`; off in `precise`, `lean` | Active. Adds behavioral/session state to the resume snapshot after compaction. |
-| `MMap Pragma` | On in `precise`, `balanced`, `thorough`; off in `lean` | Reserved/compatibility switch for SQLite mmap tuning. |
-| `Proximity Reranking` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future recall/search ranking. |
-| `Timeline Sort` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future chronological recall sorting. |
-| `Progressive Throttling` | On in `balanced`, `thorough`; off in `precise`, `lean` | Reserved/compatibility switch for future large-project throttling. |
+| `Auto Injection` | On in `balanced`, `thorough`; off in `precise`, `lean` | Adds behavioral/session state to the one-shot resume context after compaction. |
 
-If all Pipeline values stay `off` after choosing a preset, that means the running version is not applying preset pipeline values correctly. Choose a preset, press **Enter** to save, and verify you are on a version containing the preset pipeline fix.
+Deprecated config-only compatibility fields are still accepted so existing files load without migration failures, but they are ignored and no longer controlled or advertised by presets: `ttlCache`, `mmapPragma`, `proximityReranking`, `timelineSort`, and `progressiveThrottling`.
 
-Config-only pipeline field:
+Other config-only pipeline field:
 
 | Field | Meaning |
 |---|---|
@@ -289,10 +283,12 @@ Practical interpretation:
 
 That means preset application is not updating `config.pipeline`. The intended behavior is:
 
-- `precise`: `ttlCache` + `mmapPragma` on.
-- `balanced`: all six pipeline switches on.
-- `thorough`: all six pipeline switches on.
-- `lean`: all pipeline switches off.
+- `precise`: Auto Injection off.
+- `balanced`: Auto Injection on.
+- `thorough`: Auto Injection on.
+- `lean`: Auto Injection off.
+
+The five deprecated compatibility fields remain off in every preset.
 
 Make sure you are running a version with the preset pipeline fix, select the preset, and press **Enter** to save.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.3.0",
-    "@pi-unipi/info-screen": "2.3.0",
+    "@pi-unipi/core": "2.4.1",
+    "@pi-unipi/info-screen": "2.4.1",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "peerDependencies": {

package/src/compaction/build-sections.ts

@@ -9,8 +9,8 @@ import { extractFiles } from "./extract/files.js";
 import { extractPreferences, dedupPreferencesAgainstGoals } from "./extract/preferences.js";
 import { extractCommits, formatCommits } from "./extract/commits.js";
 import { buildBriefSections, sectionsToTranscript, stringifyBrief } from "./brief.js";
-import type { SectionData } from "./sections.js";
-export type { SectionData } from "./sections.js";
+import type { SectionData } from "../types.js";
+export type { SectionData } from "../types.js";
 
 const BLOCKER_RE =
   /\b(fail(ed|s|ure|ing)?|broken|cannot|can't|won't work|does not work|doesn't work|still (broken|failing|wrong)|blocked|blocker|not (fixed|resolved|working)|crash(es|ed|ing)?)\b/i;

package/src/compaction/format.ts

@@ -2,7 +2,7 @@
  * Stage 5: Format — Render sections with separators
  */
 
-import type { SectionData } from "./sections.js";
+import type { SectionData } from "../types.js";
 
 const section = (title: string, items: string[]): string => {
   if (items.length === 0) return "";

package/src/config/presets.ts

@@ -12,13 +12,11 @@ const pipeline = (overrides: Partial<CompactorConfig["pipeline"]> = {}): Compact
   customNoisePatterns: [...(overrides.customNoisePatterns ?? DEFAULT_COMPACTOR_CONFIG.pipeline.customNoisePatterns)],
 });
 
-const pipelineAllOn = (): CompactorConfig["pipeline"] => pipeline({
-  ttlCache: true,
+// Auto Injection is the only preset-controlled pipeline feature with a runtime
+// implementation. The other persisted fields are retained as ignored legacy
+// compatibility data, but presets must not advertise or enable them.
+const pipelineWithAutoInjection = (): CompactorConfig["pipeline"] => pipeline({
   autoInjection: true,
-  proximityReranking: true,
-  timelineSort: true,
-  progressiveThrottling: true,
-  mmapPragma: true,
 });
 
 const preset = (
@@ -33,30 +31,29 @@ const preset = (
   userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, ...(overrides.userPreferences ?? {}) },
   briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, ...(overrides.briefTranscript ?? {}) },
   sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, ...(overrides.sessionContinuity ?? {}) },
-  fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, ...(overrides.fts5Index ?? {}) },
+  // Legacy compatibility data only; presets never advertise or alter it.
+  fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index },
   sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, ...(overrides.sandboxExecution ?? {}) },
-  toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, ...(overrides.toolDisplay ?? {}) },
+  // Legacy compatibility data only; presets never advertise or alter it.
+  toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay },
   pipeline: pipeline(overrides.pipeline),
   autoCompaction: { ...DEFAULT_COMPACTOR_CONFIG.autoCompaction, ...(overrides.autoCompaction ?? {}) },
 });
 
-// Pipeline feature defaults per preset:
-// precise: ttlCache+mmap on, rest off
-// balanced: all on
-// thorough: all on
-// lean: all off
+// Active pipeline behavior per preset:
+// precise/lean: auto-injection off
+// balanced/thorough: auto-injection on
+// Reserved compatibility fields remain at their inert defaults in all presets.
 
 export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
   // New preset names
   precise: preset({
-    pipeline: pipeline({ ttlCache: true, mmapPragma: true }),
-    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "safe-only" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "opencode" },
+    pipeline: pipeline(),
+    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "all" },
   }),
   thorough: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "full" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "verbose" },
   }),
   lean: preset({
     pipeline: pipeline(),
@@ -67,27 +64,21 @@ export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
     userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, enabled: false, mode: "off" },
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, enabled: true, mode: "minimal" },
     sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, enabled: false, mode: "off" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, enabled: false, mode: "off" },
     sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, enabled: false, mode: "off" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, enabled: true, mode: "opencode" },
   }),
   balanced: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "compact" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "balanced" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, mode: "auto" },
   }),
 
   // Backward-compat aliases — map old names to new
   opencode: preset({
-    pipeline: pipeline({ ttlCache: true, mmapPragma: true }),
-    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "safe-only" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "opencode" },
+    pipeline: pipeline(),
+    sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, mode: "all" },
   }),
   verbose: preset({
-    pipeline: pipelineAllOn(),
+    pipeline: pipelineWithAutoInjection(),
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, mode: "full" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, mode: "verbose" },
   }),
   minimal: preset({
     pipeline: pipeline(),
@@ -98,9 +89,7 @@ export const PRESET_CONFIGS: Record<CompactorPreset, CompactorConfig> = {
     userPreferences: { ...DEFAULT_COMPACTOR_CONFIG.userPreferences, enabled: false, mode: "off" },
     briefTranscript: { ...DEFAULT_COMPACTOR_CONFIG.briefTranscript, enabled: true, mode: "minimal" },
     sessionContinuity: { ...DEFAULT_COMPACTOR_CONFIG.sessionContinuity, enabled: false, mode: "off" },
-    fts5Index: { ...DEFAULT_COMPACTOR_CONFIG.fts5Index, enabled: false, mode: "off" },
     sandboxExecution: { ...DEFAULT_COMPACTOR_CONFIG.sandboxExecution, enabled: false, mode: "off" },
-    toolDisplay: { ...DEFAULT_COMPACTOR_CONFIG.toolDisplay, enabled: true, mode: "opencode" },
   }),
   custom: structuredClone(DEFAULT_COMPACTOR_CONFIG),
 };

package/src/index.ts

@@ -15,15 +15,14 @@ import {
 } from "./compaction/auto-trigger.js";
 import { SessionDB, getWorktreeSuffix } from "./session/db.js";
 import { extractEventsFromToolResult } from "./session/extract.js";
-import { injectResumeSnapshot } from "./session/resume-inject.js";
+import { buildResumeContextMessage, isSessionContinuityEnabled } from "./session/resume-inject.js";
 import { PolyglotExecutor } from "./executor/executor.js";
 import { registerCommands } from "./commands/index.js";
 import { registerCompactorTools } from "./tools/register.js";
 import { normalizeMessages } from "./compaction/normalize.js";
 import { filterNoise } from "./compaction/filter-noise.js";
 import { recallBlocksFromContext } from "./session/recall-blocks.js";
-import type { NormalizedBlock, CompactorStrategyConfig, RuntimeCounters } from "./types.js";
-import type { RuntimeStats } from "./session/analytics.js";
+import type { NormalizedBlock, CompactorStrategyConfig, RuntimeCounters, RuntimeStats } from "./types.js";
 
 /** Debug logger — only logs when config.debug === true */
 function createDebugLogger(getConfig: () => { debug: boolean }) {
@@ -63,11 +62,6 @@ function isSandboxTool(name: string): boolean {
   return name === "bash" || name === "Bash";
 }
 
-/** Check if a tool is an index tool (content goes to FTS5, not context). Future-proofing. */
-function isIndexTool(_name: string): boolean {
-  return false;
-}
-
 export default function compactorExtension(pi: ExtensionAPI): void {
   let sessionDB: SessionDB | null = null;
   let executor: PolyglotExecutor | null = null;
@@ -86,7 +80,6 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
   const runtimeStats: RuntimeStats = {
     bytesReturned: {},
-    bytesIndexed: 0,
     bytesSandboxed: 0,
     calls: {},
     sessionStart: Date.now(),
@@ -114,7 +107,7 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       sessionDB = null;
     }
 
-    executor = new PolyglotExecutor();
+    executor = null;
   };
 
   // Register compaction hooks with lazy deps — sessionDB/sessionId may not be
@@ -156,7 +149,6 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
     // Reset runtime stats for new session
     runtimeStats.bytesReturned = {};
-    runtimeStats.bytesIndexed = 0;
     runtimeStats.bytesSandboxed = 0;
     runtimeStats.calls = {};
     runtimeStats.sessionStart = Date.now();
@@ -168,11 +160,19 @@ export default function compactorExtension(pi: ExtensionAPI): void {
 
     // Register all compactor tools with Pi (deps now have live sessionDB)
     if (sessionDB) {
+      const sandboxEnabled = config.sandboxExecution.enabled && config.sandboxExecution.mode !== "off";
+      executor = sandboxEnabled
+        ? new PolyglotExecutor({ hardCapBytes: config.sandboxExecution.outputLimit, projectRoot: projectDir })
+        : null;
       registerCompactorTools(pi, {
         sessionDB,
         getSessionId: () => currentSessionId,
         getBlocks: () => cachedBlocks,
         getCounters,
+        sandbox: executor ? {
+          executor,
+          allowedLanguages: config.sandboxExecution.allowedLanguages,
+        } : undefined,
       });
     }
 
@@ -277,25 +277,11 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       // Non-fatal: recall will work on empty blocks
     }
 
-    if (sessionDB) {
-      const snapshot = await injectResumeSnapshot(sessionDB, currentSessionId);
-      debug("resume_snapshot", { injected: !!snapshot });
-
-      // Auto-injection on compact: inject behavioral state after compaction
-      if (snapshot && sessionDB) {
-        try {
-          const { buildAutoInjection } = await import("./session/auto-inject.js");
-          const events = sessionDB.getEvents(currentSessionId, { limit: 100 });
-          const autoInjection = buildAutoInjection(events);
-          if (autoInjection) {
-            debug("auto_injection", { tokens: autoInjection.tokens, length: autoInjection.text.length });
-            // Note: auto-injection is included in the resume snapshot context
-            // The model receives it as part of the session state restoration
-          }
-        } catch (err) {
-          debug("auto_injection_error", { error: String(err) });
-        }
-      }
+    const continuityEnabled = isSessionContinuityEnabled(config);
+    if (sessionDB && continuityEnabled) {
+      const resumeContext = await buildResumeContextMessage(sessionDB, currentSessionId);
+      debug("resume_snapshot", { injected: !!resumeContext });
+      return resumeContext;
     }
   });
 
@@ -358,7 +344,8 @@ export default function compactorExtension(pi: ExtensionAPI): void {
   });
 
   pi.on("session_before_compact", async (event, _ctx) => {
-    if (sessionDB) {
+    const continuityEnabled = isSessionContinuityEnabled(config);
+    if (sessionDB && continuityEnabled) {
       // Use closure currentSessionId — Pi's session_before_compact event
       // does not include sessionId at the top level.
       const sessionId = currentSessionId;
@@ -386,14 +373,21 @@ export default function compactorExtension(pi: ExtensionAPI): void {
       const compactionEntry = (event as any).compactionEntry;
       const tokensBefore = compactionEntry?.tokensBefore ?? 0;
 
+      let summarized = 0;
+      let kept = 0;
+      let tokensSaved = 0;
+
       if (tokensBefore > 0) {
         // Use actual token count from Pi's compactionEntry.
         // Compaction typically keeps ~10-15% of original context.
         const charsBefore = tokensBefore * 4;
-        const tokensAfter = (event as any).tokensAfter ?? Math.round(tokensBefore * 0.12);
+        const tokensAfter = Math.round(tokensBefore * 0.12);
+        kept = tokensAfter;
+        tokensSaved = tokensBefore - tokensAfter;
         const charsKept = tokensAfter * 4;
         const messagesSummarized = Math.max(1, Math.round(tokensBefore / 500));
-        counters.totalTokensCompacted += tokensBefore - tokensAfter;
+        summarized = messagesSummarized;
+        counters.totalTokensCompacted += tokensSaved;
         sessionDB.addCompactionStats(sessionId, charsBefore, charsKept, messagesSummarized);
       } else {
         // tokensBefore unavailable — use session event count as a rough heuristic.
@@ -407,13 +401,24 @@ export default function compactorExtension(pi: ExtensionAPI): void {
             const estTokensAfter = Math.round(estTokensBefore * 0.12);
             const charsBefore = estTokensBefore * 4;
             const charsKept = estTokensAfter * 4;
-            counters.totalTokensCompacted += estTokensBefore - estTokensAfter;
+            summarized = eventCount;
+            kept = estTokensAfter;
+            tokensSaved = estTokensBefore - estTokensAfter;
+            counters.totalTokensCompacted += tokensSaved;
             sessionDB.addCompactionStats(sessionId, charsBefore, charsKept, eventCount);
           }
         } catch {
           // Non-fatal: heuristic estimation failed
         }
       }
+      const totalEstimated = tokensSaved + kept;
+      emitEvent(pi, UNIPI_EVENTS.COMPACTOR_COMPACTED, {
+        sessionId,
+        summarized,
+        kept,
+        tokensSaved,
+        compressionRatio: kept > 0 ? `${Math.round(totalEstimated / kept)}:1` : "0:1",
+      });
       debug("session_compact", { sessionId, tokensBefore, hasCompactionEntry: !!compactionEntry });
     }
   });
@@ -531,34 +536,12 @@ export default function compactorExtension(pi: ExtensionAPI): void {
         if (isSandboxTool(tName)) {
           runtimeStats.bytesSandboxed += responseBytes;
         }
-        if (isIndexTool(tName)) {
-          runtimeStats.bytesIndexed += responseBytes;
-        }
       }
     } catch {
       // Non-blocking: byte tracking errors silently skipped
     }
 
-    // Apply display overrides for built-in tools
     const toolName = (event as any).toolName ?? "";
-    const td = config.toolDisplay;
-    const toolConfig = {
-      readOutputMode: td?.mode as any,
-      searchOutputMode: td?.mode as any,
-      bashOutputMode: td?.mode as any,
-      previewLines: 20,
-      bashCollapsedLines: 5,
-      showTruncationHints: true,
-    };
-    try {
-      const { applyToolDisplayOverride } = await import("./display/tool-overrides.js");
-      const override = applyToolDisplayOverride(toolName, event as any, toolConfig);
-      if (override !== undefined) {
-        return override as any;
-      }
-    } catch {
-      // Non-fatal: display override failed
-    }
 
     // Width-safe diff truncation for edit/write tool results.
     // Pi's renderDiff() does not truncate lines to terminal width,

package/src/session/resume-inject.ts

@@ -2,10 +2,16 @@
  * Resume injection — inject snapshot into session context post-compaction
  */
 
+import type { BeforeAgentStartEventResult } from "@earendil-works/pi-coding-agent";
 import type { SessionDB } from "./db.js";
 import { buildResumeSnapshot } from "./snapshot.js";
 import { buildAutoInjection } from "./auto-inject.js";
 import { loadConfig } from "../config/manager.js";
+import type { CompactorConfig } from "../types.js";
+
+export function isSessionContinuityEnabled(config: CompactorConfig): boolean {
+  return config.sessionContinuity.enabled && config.sessionContinuity.mode !== "off";
+}
 
 export async function injectResumeSnapshot(
   db: SessionDB,
@@ -35,3 +41,24 @@ export async function injectResumeSnapshot(
   db.markResumeConsumed(sessionId);
   return fullSnapshot;
 }
+
+/**
+ * Build the one-shot hidden context message used on the first turn after
+ * compaction. Keeping this out of the system prompt preserves Pi's stable
+ * prompt/history prefix for provider cache reuse.
+ */
+export async function buildResumeContextMessage(
+  db: SessionDB,
+  sessionId: string,
+): Promise<BeforeAgentStartEventResult | undefined> {
+  const snapshot = await injectResumeSnapshot(db, sessionId);
+  if (!snapshot) return undefined;
+
+  return {
+    message: {
+      customType: "unipi-compactor-resume",
+      content: snapshot,
+      display: false,
+    },
+  };
+}

package/src/tools/ctx-batch-execute.ts

@@ -20,9 +20,11 @@ export interface BatchResult {
   >;
 }
 
-export async function ctxBatchExecute(items: BatchItem[]): Promise<BatchResult> {
+export async function ctxBatchExecute(
+  items: BatchItem[],
+  executor = new PolyglotExecutor(),
+): Promise<BatchResult> {
   const results: BatchResult["results"] = [];
-  const executor = new PolyglotExecutor();
 
   for (const item of items) {
     if (item.type === "execute") {

package/src/tools/ctx-execute-file.ts

@@ -12,11 +12,13 @@ export interface CtxExecuteFileInput {
   timeout?: number;
 }
 
-export async function ctxExecuteFile(input: CtxExecuteFileInput): Promise<ExecResult> {
+export async function ctxExecuteFile(
+  input: CtxExecuteFileInput,
+  executor = new PolyglotExecutor(),
+): Promise<ExecResult> {
   const content = readFileSync(input.path, "utf-8");
   const code = `const FILE_CONTENT = ${JSON.stringify(content)};\n// User script follows:\n`;
   
-  const executor = new PolyglotExecutor();
   return executor.executeFile({
     language: input.language,
     path: input.path,

package/src/tools/ctx-execute.ts

@@ -11,8 +11,10 @@ export interface CtxExecuteInput {
   timeout?: number;
 }
 
-export async function ctxExecute(input: CtxExecuteInput): Promise<ExecResult> {
-  const executor = new PolyglotExecutor();
+export async function ctxExecute(
+  input: CtxExecuteInput,
+  executor = new PolyglotExecutor(),
+): Promise<ExecResult> {
   return executor.execute({
     language: input.language,
     code: input.code,

package/src/tools/register.ts

@@ -27,7 +27,8 @@ import { recallBlocksFromContext } from "../session/recall-blocks.js";
 import { filterNoise } from "../compaction/filter-noise.js";
 import { loadConfig } from "../config/manager.js";
 import type { SessionDB } from "../session/db.js";
-import type { NormalizedBlock, RuntimeCounters } from "../types.js";
+import type { Language, NormalizedBlock, RuntimeCounters } from "../types.js";
+import type { PolyglotExecutor } from "../executor/executor.js";
 
 // --- TypeBox Schemas for each tool ---
 
@@ -127,6 +128,10 @@ export interface CompactorToolDeps {
   getSessionId: () => string;
   getBlocks: () => NormalizedBlock[];
   getCounters?: () => RuntimeCounters;
+  sandbox?: {
+    executor: PolyglotExecutor;
+    allowedLanguages: Language[];
+  };
 }
 
 /**
@@ -189,13 +194,23 @@ export function registerCompactorTools(pi: ExtensionAPI, deps: CompactorToolDeps
   pi.registerTool({ name: "session_recall", label: "Session Recall", description: "Search session history using BM25 or regex. Find previous goals, files, commits, and context.", parameters: RecallParams, execute: recallExec } as any);
   pi.registerTool({ name: "vcc_recall", label: "Session Recall", description: "Search session history using BM25 or regex. (DEPRECATED: use session_recall instead)", parameters: VccRecallParams, async execute(tcId: string, p: any) { deprecationLog("vcc_recall", "session_recall"); return recallExec(tcId, p); } } as any);
 
+  // Sandbox tools are session-scoped and only registered when enabled.
+  if (deps.sandbox) {
+  const { executor, allowedLanguages } = deps.sandbox;
+  const assertAllowedLanguage = (language: Language): void => {
+    if (!allowedLanguages.includes(language)) {
+      throw new Error(`Language "${language}" is disabled by Compactor sandbox settings. Allowed: ${allowedLanguages.join(", ") || "none"}`);
+    }
+  };
+
   // 3. sandbox (new) / ctx_execute (deprecated) — run code in sandbox
   const sandboxExec = async (_toolCallId: string, params: any): Promise<import("@earendil-works/pi-coding-agent").AgentToolResult<unknown>> => {
     try {
       const c = deps.getCounters?.();
       if (c) { c.sandboxRuns++; }
       deps.sessionDB.incrementSandboxRuns(deps.getSessionId());
-      const result = await ctxExecute(params as CtxExecuteInput);
+      assertAllowedLanguage(params.language as Language);
+      const result = await ctxExecute(params as CtxExecuteInput, executor);
       const parts: string[] = [];
       if (result.stdout) parts.push(result.stdout);
       if (result.stderr) parts.push(`[stderr] ${result.stderr}`);
@@ -215,7 +230,8 @@ export function registerCompactorTools(pi: ExtensionAPI, deps: CompactorToolDeps
       const c = deps.getCounters?.();
       if (c) { c.sandboxRuns++; }
       deps.sessionDB.incrementSandboxRuns(deps.getSessionId());
-      const result = await ctxExecuteFile(params as CtxExecuteFileInput);
+      assertAllowedLanguage(params.language as Language);
+      const result = await ctxExecuteFile(params as CtxExecuteFileInput, executor);
       const parts: string[] = [];
       if (result.stdout) parts.push(result.stdout);
       if (result.stderr) parts.push(`[stderr] ${result.stderr}`);
@@ -234,7 +250,8 @@ export function registerCompactorTools(pi: ExtensionAPI, deps: CompactorToolDeps
       const c = deps.getCounters?.();
       if (c) { c.sandboxRuns++; }
       deps.sessionDB.incrementSandboxRuns(deps.getSessionId());
-      const result = await ctxBatchExecute(params.items as BatchItem[]);
+      for (const item of params.items as BatchItem[]) assertAllowedLanguage(item.language);
+      const result = await ctxBatchExecute(params.items as BatchItem[], executor);
       const summaries = result.results.map((r, i) => {
         const s = r.result.stdout?.slice(0, 200) || "(no output)";
         return `[${i}] execute → ${r.result.exitCode === 0 ? "ok" : "fail"}: ${s}`;
@@ -246,6 +263,7 @@ export function registerCompactorTools(pi: ExtensionAPI, deps: CompactorToolDeps
   };
   pi.registerTool({ name: "sandbox_batch", label: "Sandbox Batch", description: "Run multiple code executions atomically as a batch.", parameters: SandboxBatchParams, execute: sandboxBatchExec } as any);
   pi.registerTool({ name: "ctx_batch_execute", label: "Sandbox Batch", description: "Run batch operations. (DEPRECATED: use sandbox_batch instead)", parameters: CtxBatchExecuteParams, async execute(tcId: string, p: any) { deprecationLog("ctx_batch_execute", "sandbox_batch"); return sandboxBatchExec(tcId, p); } } as any);
+  }
 
   // 6. compactor_stats (new) / ctx_stats (deprecated) — context savings dashboard
   const statsExec = async (): Promise<import("@earendil-works/pi-coding-agent").AgentToolResult<unknown>> => {

package/src/tui/settings-overlay.ts

@@ -122,7 +122,7 @@ const STRATEGIES: StrategyDef[] = [
     key: "sessionContinuity",
     label: "Session Continuity",
     description: "XML resume snapshot for compaction survival",
-    modes: ["full", "essential-only", "off"],
+    modes: ["full", "off"],
     getEnabled: (c) => c.sessionContinuity.enabled,
     setEnabled: (c, v) => (c.sessionContinuity.enabled = v),
     getMode: (c) => c.sessionContinuity.mode,
@@ -132,31 +132,18 @@ const STRATEGIES: StrategyDef[] = [
     key: "sandboxExecution",
     label: "Sandbox Execution",
     description: "Polyglot code execution",
-    modes: ["all", "safe-only", "off"],
+    modes: ["all", "off"],
     getEnabled: (c) => c.sandboxExecution.enabled,
     setEnabled: (c, v) => (c.sandboxExecution.enabled = v),
     getMode: (c) => c.sandboxExecution.mode,
     setMode: (c, v) => (c.sandboxExecution.mode = v as any),
   },
-  {
-    key: "toolDisplay",
-    label: "Tool Display",
-    description: "Override tool output rendering",
-    modes: ["opencode", "balanced", "verbose", "custom"],
-    getEnabled: (c) => c.toolDisplay.enabled,
-    setEnabled: (c, v) => (c.toolDisplay.enabled = v),
-    getMode: (c) => c.toolDisplay.mode,
-    setMode: (c, v) => (c.toolDisplay.mode = v as any),
-  },
 ];
 
 const PIPELINE_ITEMS: PipelineDef[] = [
-  { key: "ttlCache", label: "TTL Cache", description: "Cache with time-based expiry", group: "On Compaction", getValue: (c) => c.pipeline.ttlCache, setValue: (c, v) => (c.pipeline.ttlCache = v) },
+  // Only expose implemented behavior. Reserved compatibility fields remain in
+  // the persisted schema so existing config files continue to load.
   { key: "autoInjection", label: "Auto Injection", description: "Inject behavioral state after compaction", group: "On Compaction", getValue: (c) => c.pipeline.autoInjection, setValue: (c, v) => (c.pipeline.autoInjection = v) },
-  { key: "mmapPragma", label: "MMap Pragma", description: "Use mmap for SQLite I/O", group: "On Compaction", getValue: (c) => c.pipeline.mmapPragma, setValue: (c, v) => (c.pipeline.mmapPragma = v) },
-  { key: "proximityReranking", label: "Proximity Reranking", description: "Rerank search results by proximity", group: "On Search", getValue: (c) => c.pipeline.proximityReranking, setValue: (c, v) => (c.pipeline.proximityReranking = v) },
-  { key: "timelineSort", label: "Timeline Sort", description: "Sort session events chronologically", group: "On Search", getValue: (c) => c.pipeline.timelineSort, setValue: (c, v) => (c.pipeline.timelineSort = v) },
-  { key: "progressiveThrottling", label: "Progressive Throttling", description: "Slow down processing for large projects", group: "On Compaction", getValue: (c) => c.pipeline.progressiveThrottling, setValue: (c, v) => (c.pipeline.progressiveThrottling = v) },
 ];
 
 const PRESETS: CompactorPreset[] = ["precise", "balanced", "thorough", "lean"];
@@ -167,20 +154,20 @@ const REPEAT_GROWTH_VALUES = ["0", "1k", "4k", "8k", "16k", "32k"];
 
 const PRESET_DESCRIPTIONS: Record<string, { summary: string; detail: string }> = {
   precise: {
-    summary: "Code-heavy, minimal waste — compaction: full, sandbox: safe-only",
-    detail: "Max token savings. Compaction: full. Display: minimal.\nSandbox: safe-only. Pipeline: ttlCache+mmap on.",
+    summary: "Code-heavy, minimal waste — compaction: full, sandbox: all",
+    detail: "Max token savings. Compaction: full.\nSandbox: all. Auto injection: off.",
   },
   balanced: {
     summary: "Daily use (default) — all strategies moderate",
-    detail: "Moderate all strategies. Display: balanced.\nSandbox: all. Pipeline: all 6 on.",
+    detail: "Moderate all strategies.\nSandbox: all. Auto injection: on.",
   },
   thorough: {
     summary: "Debug/audit — everything on, full transcript",
-    detail: "Everything enabled. Display: verbose.\nSandbox: all. Pipeline: all 6 on.",
+    detail: "Everything enabled.\nSandbox: all. Auto injection: on.",
   },
   lean: {
     summary: "Quick fixes, short sessions — compaction only",
-    detail: "Compaction only. Display: opencode.\nSandbox: off. Pipeline: all 6 off.",
+    detail: "Compaction only.\nSandbox: off. Auto injection: off.",
   },
 };
 

package/src/types.ts

@@ -49,6 +49,16 @@ export interface BriefLine {
   lines: string[];
 }
 
+/** Runtime stats tracked during a live session. */
+export interface RuntimeStats {
+  bytesReturned: Record<string, number>;
+  bytesSandboxed: number;
+  calls: Record<string, number>;
+  sessionStart: number;
+  cacheHits: number;
+  cacheBytesSaved: number;
+}
+
 // ─────────────────────────────────────────────────────────
 // Compaction input / output
 // ─────────────────────────────────────────────────────────
@@ -110,18 +120,29 @@ export interface CompactorConfig {
   outstandingContext: CompactorStrategyConfig & { mode: "full" | "critical-only" | "off"; maxItems: number };
   userPreferences: CompactorStrategyConfig & { mode: "all" | "recent-only" | "off"; maxPreferences: number };
   briefTranscript: CompactorStrategyConfig & { mode: "full" | "compact" | "minimal" | "off"; userTokenLimit: number; assistantTokenLimit: number; toolCallLimit: number };
-  sessionContinuity: CompactorStrategyConfig & { mode: "full" | "essential-only" | "off"; eventCategories: string[] };
+  sessionContinuity: CompactorStrategyConfig & {
+    mode: "full" | "essential-only" | "off";
+    /** @deprecated Category filtering was never implemented; ignored by runtime. */
+    eventCategories: string[];
+  };
+  /** @deprecated Project indexing moved to @pi-unipi/cocoindex; retained for config compatibility. */
   fts5Index: CompactorStrategyConfig & { mode: "auto" | "manual" | "off"; chunkSize: number; cacheTtlHours: number };
-  sandboxExecution: CompactorStrategyConfig & { mode: "all" | "safe-only" | "off"; allowedLanguages: string[]; outputLimit: number };
+  sandboxExecution: CompactorStrategyConfig & { mode: "all" | "safe-only" | "off"; allowedLanguages: Language[]; outputLimit: number };
+  /** @deprecated Display profiles were never connected to runtime; retained for config compatibility. */
   toolDisplay: CompactorStrategyConfig & { mode: "opencode" | "balanced" | "verbose" | "custom"; diffLayout: "auto" | "split" | "unified"; diffIndicator: "bars" | "classic" | "none"; showThinkingLabels: boolean; showUserMessageBox: boolean; showBashSpinner: boolean; showPendingPreviews: boolean };
 
   // Pipeline features
   pipeline: {
+    /** @deprecated Reserved compatibility field; ignored by runtime. */
     ttlCache: boolean;
     autoInjection: boolean;
+    /** @deprecated Reserved compatibility field; ignored by runtime. */
     proximityReranking: boolean;
+    /** @deprecated Reserved compatibility field; ignored by runtime. */
     timelineSort: boolean;
+    /** @deprecated Reserved compatibility field; ignored by runtime. */
     progressiveThrottling: boolean;
+    /** @deprecated Reserved compatibility field; ignored by runtime. */
     mmapPragma: boolean;
     customNoisePatterns: string[];
   };
@@ -132,6 +153,7 @@ export interface CompactorConfig {
   // Global settings
   overrideDefaultCompaction: boolean;
   debug: boolean;
+  /** @deprecated Truncation hints were never connected to runtime; retained for config compatibility. */
   showTruncationHints: boolean;
 }
 

package/src/compaction/recall-scope.ts

@@ -1,32 +0,0 @@
-/**
- * Recall scope — lineage filtering for vcc_recall
- */
-
-export interface LineageRange {
-  startIndex: number;
-  endIndex: number;
-}
-
-/**
- * Determine the valid message index range for recall based on
- * the most recent compaction boundary.
- */
-export function getRecallScope(
-  branchEntries: Array<{ type: string; [key: string]: unknown }>,
-  opts?: { expand?: boolean },
-): LineageRange {
-  let lastCompactionIdx = -1;
-  for (let i = branchEntries.length - 1; i >= 0; i--) {
-    if (branchEntries[i].type === "compaction") {
-      lastCompactionIdx = i;
-      break;
-    }
-  }
-
-  // If expand is true, include everything; otherwise only post-compaction
-  const startIndex = opts?.expand ? 0 : lastCompactionIdx + 1;
-  return {
-    startIndex: Math.max(0, startIndex),
-    endIndex: branchEntries.length,
-  };
-}

package/src/compaction/sections.ts

@@ -1,15 +0,0 @@
-/**
- * Section data type for compaction pipeline
- */
-
-import type { TranscriptEntry } from "../types.js";
-
-export interface SectionData {
-  sessionGoal: string[];
-  filesAndChanges: string[];
-  commits: string[];
-  outstandingContext: string[];
-  userPreferences: string[];
-  briefTranscript: string;
-  transcriptEntries: TranscriptEntry[];
-}

package/src/display/bash-display.ts

@@ -1,28 +0,0 @@
-/**
- * Bash display — spinner + elapsed time
- */
-
-const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-
-export function getSpinnerFrame(index: number): string {
-  return SPINNER_FRAMES[index % SPINNER_FRAMES.length];
-}
-
-export function formatElapsedTime(ms: number): string {
-  if (ms < 1000) return `${ms}ms`;
-  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-  const mins = Math.floor(ms / 60000);
-  const secs = ((ms % 60000) / 1000).toFixed(0);
-  return `${mins}m${secs}s`;
-}
-
-export function renderBashCall(command: string, opts?: { collapsed?: boolean }): string {
-  if (opts?.collapsed) {
-    const firstLine = command.split("\n")[0]?.trim() ?? command;
-    if (firstLine.length > 80) {
-      return firstLine.slice(0, 77) + "...";
-    }
-    return firstLine;
-  }
-  return command;
-}

package/src/display/diff-presentation.ts

@@ -1,25 +0,0 @@
-/**
- * Diff presentation — layout selection based on terminal width
- */
-
-import type { DiffLayout } from "../types.js";
-import { visibleWidth, truncateToWidth } from "@earendil-works/pi-tui";
-
-export function selectDiffLayout(
-  terminalWidth: number,
-  preferred: DiffLayout = "auto",
-): "split" | "unified" {
-  if (preferred !== "auto") return preferred;
-  return terminalWidth >= 100 ? "split" : "unified";
-}
-
-/** Clamp text to maxWidth visible columns, ANSI-aware */
-export function clampWidth(text: string, maxWidth: number): string {
-  return text
-    .split("\n")
-    .map((line) => {
-      if (visibleWidth(line) <= maxWidth) return line;
-      return truncateToWidth(line, maxWidth, "…");
-    })
-    .join("\n");
-}

package/src/display/pending-diff-preview.ts

@@ -1,51 +0,0 @@
-/**
- * Pending diff previews during streaming
- */
-
-export interface PendingDiffPreviewData {
-  type: "edit" | "write" | "create";
-  filePath: string;
-  previousContent?: string;
-  newContent: string;
-  confidence: number;
-}
-
-export function buildPendingEditPreviewData(
-  filePath: string,
-  oldText: string,
-  newText: string,
-): PendingDiffPreviewData {
-  return {
-    type: "edit",
-    filePath,
-    previousContent: oldText,
-    newContent: newText,
-    confidence: 1.0,
-  };
-}
-
-export function buildPendingWritePreviewData(
-  filePath: string,
-  content: string,
-  fileExisted: boolean,
-): PendingDiffPreviewData {
-  return {
-    type: fileExisted ? "write" : "create",
-    filePath,
-    newContent: content,
-    confidence: 1.0,
-  };
-}
-
-export function renderPendingDiffPreview(data: PendingDiffPreviewData, opts?: { maxLines?: number }): string {
-  const maxLines = opts?.maxLines ?? 20;
-  const lines = data.newContent.split("\n").slice(0, maxLines);
-  const header = data.type === "edit" ? `✏️  Edit: ${data.filePath}`
-    : data.type === "write" ? `📝 Write: ${data.filePath}`
-    : `📄 Create: ${data.filePath}`;
-
-  const omitted = data.newContent.split("\n").length - lines.length;
-  const hint = omitted > 0 ? `\n...(${omitted} more lines)...` : "";
-
-  return `${header}\n${"─".repeat(header.length)}\n${lines.join("\n")}${hint}`;
-}

package/src/display/user-message-box.ts

@@ -1,16 +0,0 @@
-/**
- * User message box — bordered display for user messages
- */
-
-export function renderUserMessageBox(text: string, opts?: { maxWidth?: number }): string {
-  const maxWidth = opts?.maxWidth ?? 80;
-  const lines = text.split("\n");
-  const clamped = lines.map((l) => (l.length > maxWidth - 4 ? l.slice(0, maxWidth - 7) + "..." : l));
-  const width = Math.min(maxWidth, Math.max(...clamped.map((l) => l.length), 10) + 4);
-
-  const top = `╭${"─".repeat(width - 2)}╮`;
-  const bottom = `╰${"─".repeat(width - 2)}╯`;
-  const middle = clamped.map((l) => `│ ${l.padEnd(width - 4)} │`);
-
-  return [top, ...middle, bottom].join("\n");
-}

package/src/session/analytics.ts

@@ -1,205 +0,0 @@
-/**
- * AnalyticsEngine — Runtime savings + session continuity reporting.
- *
- * Ported from context-mode's AnalyticsEngine, trimmed to budget-focused stats.
- * Omits: formatReport(), categoryLabels, categoryHints, ThinkInCodeComparison,
- * SandboxIO, dataBar(), visual formatting helpers.
- *
- * Usage:
- *   const engine = new AnalyticsEngine(sessionDb);
- *   const report = engine.queryAll(runtimeStats);
- */
-
-// ─────────────────────────────────────────────────────────
-// Types
-// ─────────────────────────────────────────────────────────
-
-/** Database adapter — anything with a prepare() method (better-sqlite3, bun:sqlite, etc.) */
-export interface DatabaseAdapter {
-  prepare(sql: string): {
-    run(...params: unknown[]): unknown;
-    get(...params: unknown[]): unknown;
-    all(...params: unknown[]): unknown[];
-  };
-}
-
-/** Context savings result */
-export interface ContextSavings {
-  rawBytes: number;
-  contextBytes: number;
-  savedBytes: number;
-  savedPercent: number;
-}
-
-/** Runtime stats tracked during a live session. */
-export interface RuntimeStats {
-  bytesReturned: Record<string, number>;
-  bytesIndexed: number;
-  bytesSandboxed: number;
-  calls: Record<string, number>;
-  sessionStart: number;
-  cacheHits: number;
-  cacheBytesSaved: number;
-}
-
-/** Unified report combining runtime stats, DB analytics, and continuity data. */
-export interface FullReport {
-  /** Runtime context savings */
-  savings: {
-    processed_kb: number;
-    entered_kb: number;
-    saved_kb: number;
-    pct: number;
-    savings_ratio: number;
-    by_tool: Array<{ tool: string; calls: number; context_kb: number; tokens: number }>;
-    total_calls: number;
-    total_bytes_returned: number;
-    kept_out: number;
-    total_processed: number;
-  };
-  /** Session metadata from SessionDB */
-  session: {
-    id: string;
-    uptime_min: string;
-  };
-  /** Session continuity data */
-  continuity: {
-    total_events: number;
-    compact_count: number;
-    all_time_compact_count: number;
-    resume_ready: boolean;
-  };
-  /** Persistent project memory — all events across all sessions */
-  projectMemory: {
-    total_events: number;
-    session_count: number;
-  };
-}
-
-// ─────────────────────────────────────────────────────────
-// AnalyticsEngine
-// ─────────────────────────────────────────────────────────
-
-export class AnalyticsEngine {
-  private readonly db: DatabaseAdapter;
-
-  constructor(db: DatabaseAdapter) {
-    this.db = db;
-  }
-
-  /**
-   * Build a FullReport by merging runtime stats (passed in)
-   * with continuity data from the DB.
-   */
-  queryAll(runtimeStats: RuntimeStats): FullReport {
-    // ── Resolve latest session ID ──
-    const latestSession = this.db.prepare(
-      "SELECT session_id FROM session_meta ORDER BY started_at DESC LIMIT 1",
-    ).get() as { session_id: string } | undefined;
-    const sid = latestSession?.session_id ?? "";
-
-    // ── Runtime savings ──
-    const totalBytesReturned = Object.values(runtimeStats.bytesReturned).reduce(
-      (sum, b) => sum + b, 0,
-    );
-    const totalCalls = Object.values(runtimeStats.calls).reduce(
-      (sum, c) => sum + c, 0,
-    );
-    const keptOut = runtimeStats.bytesIndexed + runtimeStats.bytesSandboxed;
-    const totalProcessed = keptOut + totalBytesReturned;
-    const savingsRatio = totalProcessed / Math.max(totalBytesReturned, 1);
-    const reductionPct = totalProcessed > 0
-      ? Math.round((1 - totalBytesReturned / totalProcessed) * 100)
-      : 0;
-
-    const toolNames = new Set([
-      ...Object.keys(runtimeStats.calls),
-      ...Object.keys(runtimeStats.bytesReturned),
-    ]);
-    const byTool = Array.from(toolNames).sort().map((tool) => ({
-      tool,
-      calls: runtimeStats.calls[tool] || 0,
-      context_kb: Math.round((runtimeStats.bytesReturned[tool] || 0) / 1024 * 10) / 10,
-      tokens: Math.round((runtimeStats.bytesReturned[tool] || 0) / 4),
-    }));
-
-    const uptimeMs = Date.now() - runtimeStats.sessionStart;
-    const uptimeMin = (uptimeMs / 60_000).toFixed(1);
-
-    // ── Continuity data (scoped to current session) ──
-    const eventTotal = (this.db.prepare(
-      "SELECT COUNT(*) as cnt FROM session_events WHERE session_id = ?",
-    ).get(sid) as { cnt: number }).cnt;
-
-    const meta = this.db.prepare(
-      "SELECT compact_count FROM session_meta WHERE session_id = ?",
-    ).get(sid) as { compact_count: number } | undefined;
-    const compactCount = meta?.compact_count ?? 0;
-
-    // ── All-time compaction count across all sessions ──
-    const allTimeCompactions = (this.db.prepare(
-      "SELECT COALESCE(SUM(compact_count), 0) as total FROM session_meta",
-    ).get() as { total: number }).total;
-
-    const resume = this.db.prepare(
-      "SELECT event_count, consumed FROM session_resume WHERE session_id = ? ORDER BY created_at DESC LIMIT 1",
-    ).get(sid) as { event_count: number; consumed: number } | undefined;
-    const resumeReady = resume ? !resume.consumed : false;
-
-    // ── Project-wide persistent memory (all sessions, no session_id filter) ──
-    const projectTotals = this.db.prepare(
-      "SELECT COUNT(*) as cnt, COUNT(DISTINCT session_id) as sessions FROM session_events",
-    ).get() as { cnt: number; sessions: number };
-
-    return {
-      savings: {
-        processed_kb: Math.round(totalProcessed / 1024 * 10) / 10,
-        entered_kb: Math.round(totalBytesReturned / 1024 * 10) / 10,
-        saved_kb: Math.round(keptOut / 1024 * 10) / 10,
-        pct: reductionPct,
-        savings_ratio: Math.round(savingsRatio * 10) / 10,
-        by_tool: byTool,
-        total_calls: totalCalls,
-        total_bytes_returned: totalBytesReturned,
-        kept_out: keptOut,
-        total_processed: totalProcessed,
-      },
-      session: {
-        id: sid,
-        uptime_min: uptimeMin,
-      },
-      continuity: {
-        total_events: eventTotal,
-        compact_count: compactCount,
-        all_time_compact_count: allTimeCompactions,
-        resume_ready: resumeReady,
-      },
-      projectMemory: {
-        total_events: projectTotals.cnt,
-        session_count: projectTotals.sessions,
-      },
-    };
-  }
-}
-
-// ─────────────────────────────────────────────────────────
-// createMinimalDb — in-memory SQLite fallback
-// ─────────────────────────────────────────────────────────
-
-/**
- * Create a minimal in-memory DatabaseAdapter for when SessionDB is unavailable.
- * Returns zeroed/empty results for all queries.
- */
-export function createMinimalDb(): DatabaseAdapter {
-  // Use an in-memory SQLite database with the expected schema
-  // so AnalyticsEngine queries don't fail.
-  const emptyStmt = {
-    run: (..._params: unknown[]) => {},
-    get: (..._params: unknown[]) => ({ cnt: 0, sessions: 0, compact_count: 0, total: 0, session_id: "", event_count: 0, consumed: 1 }),
-    all: (..._params: unknown[]) => [] as unknown[],
-  };
-
-  return {
-    prepare: (_sql: string) => emptyStmt,
-  };
-}