@hasna/terminal 3.3.9 → 3.4.0

package/dist/cli.js

@@ -78,6 +78,14 @@ if (args[0] === "uninstall") {
     handleInstall(["uninstall"]);
     process.exit(0);
 }
+// ── Prune ────────────────────────────────────────────────────────────────────
+if (args[0] === "prune") {
+    const days = parseInt(args.find(a => a.startsWith("--older-than="))?.split("=")[1] ?? "90");
+    const { pruneSessions } = await import("./sessions-db.js");
+    const result = pruneSessions(days);
+    console.log(`  Pruned ${result.sessionsDeleted} sessions, ${result.interactionsDeleted} interactions older than ${days}d`);
+    process.exit(0);
+}
 // ── MCP commands ─────────────────────────────────────────────────────────────
 if (args[0] === "mcp") {
     if (args[1] === "serve" || args.length === 1) {

package/dist/mcp/server.js

@@ -12,7 +12,7 @@ import { listRecipes, listCollections, getRecipe, createRecipe } from "../recipe
 import { substituteVariables } from "../recipes/model.js";
 import { bgStart, bgStatus, bgStop, bgLogs, bgWaitPort } from "../supervisor.js";
 import { diffOutput } from "../diff-cache.js";
-import { listSessions, getSessionInteractions, getSessionStats } from "../sessions-db.js";
+import { createSession, logInteraction, listSessions, getSessionInteractions, getSessionStats, getSessionEconomy } from "../sessions-db.js";
 import { cachedRead } from "../file-cache.js";
 import { getBootContext, invalidateBootCache } from "../session-boot.js";
 import { storeOutput, expandOutput } from "../expand-store.js";
@@ -57,8 +57,26 @@ function exec(command, cwd, timeout, allowRewrite = false) {
 export function createServer() {
     const server = new McpServer({
         name: "terminal",
-        version: "0.2.0",
+        version: "3.4.0",
     });
+    // Create a session for this MCP server instance
+    const sessionId = createSession(process.cwd(), "mcp");
+    /** Log a tool call to sessions.db for economy tracking */
+    function logCall(tool, data) {
+        try {
+            logInteraction(sessionId, {
+                nl: `[mcp:${tool}]${data.command ? ` ${data.command.slice(0, 200)}` : ""}`,
+                command: data.command?.slice(0, 500),
+                exitCode: data.exitCode,
+                tokensUsed: data.aiProcessed ? (data.outputTokens ?? 0) : 0,
+                tokensSaved: data.tokensSaved ?? 0,
+                durationMs: data.durationMs,
+                model: data.model,
+                cached: false,
+            });
+        }
+        catch { } // never let logging break tool execution
+    }
     // ── execute: run a command, return structured result ──────────────────────
     server.tool("execute", "Run a shell command. Format guide: no format/raw for git commit/push (<50 tokens). format=compressed for long build output (CPU-only, no AI). format=json or format=summary for AI-summarized output (234ms, saves 80% tokens). Prefer execute_smart for most tasks.", {
         command: z.string().describe("Shell command to execute"),
@@ -67,15 +85,16 @@ export function createServer() {
         format: z.enum(["raw", "json", "compressed", "summary"]).optional().describe("Output format"),
         maxTokens: z.number().optional().describe("Token budget for compressed/summary format"),
     }, async ({ command, cwd, timeout, format, maxTokens }) => {
+        const start = Date.now();
         const result = await exec(command, cwd, timeout ?? 30000);
         const output = (result.stdout + result.stderr).trim();
         // Raw mode — with lazy execution for large results
         if (!format || format === "raw") {
             const clean = stripAnsi(output);
-            // Lazy mode: if >100 lines, return count + sample instead of full output
             if (shouldBeLazy(clean, command)) {
                 const lazy = toLazy(clean, command);
                 const detailKey = storeOutput(command, clean);
+                logCall("execute", { command, outputTokens: estimateTokens(clean), tokensSaved: 0, durationMs: Date.now() - start, exitCode: result.exitCode });
                 return {
                     content: [{ type: "text", text: JSON.stringify({
                                 exitCode: result.exitCode, ...lazy, detailKey, duration: result.duration,
@@ -83,6 +102,7 @@ export function createServer() {
                             }) }],
                 };
             }
+            logCall("execute", { command, outputTokens: estimateTokens(clean), tokensSaved: 0, durationMs: Date.now() - start, exitCode: result.exitCode });
             return {
                 content: [{ type: "text", text: JSON.stringify({
                             exitCode: result.exitCode, output: clean, duration: result.duration, tokens: estimateTokens(clean),
@@ -95,6 +115,7 @@ export function createServer() {
             try {
                 const processed = await processOutput(command, output);
                 const detailKey = output.split("\n").length > 15 ? storeOutput(command, output) : undefined;
+                logCall("execute", { command, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode, aiProcessed: processed.aiProcessed });
                 return {
                     content: [{ type: "text", text: JSON.stringify({
                                 exitCode: result.exitCode,
@@ -109,6 +130,7 @@ export function createServer() {
             }
             catch {
                 const compressed = compress(command, output, { maxTokens });
+                logCall("execute", { command, outputTokens: estimateTokens(output), tokensSaved: compressed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode });
                 return {
                     content: [{ type: "text", text: JSON.stringify({
                                 exitCode: result.exitCode, output: compressed.content, duration: result.duration,
@@ -135,11 +157,12 @@ export function createServer() {
         cwd: z.string().optional().describe("Working directory"),
         timeout: z.number().optional().describe("Timeout in ms (default: 30000)"),
     }, async ({ command, cwd, timeout }) => {
-        const result = await exec(command, cwd, timeout ?? 30000, true); // allow rewrite for smart mode
+        const start = Date.now();
+        const result = await exec(command, cwd, timeout ?? 30000, true);
         const output = (result.stdout + result.stderr).trim();
         const processed = await processOutput(command, output);
-        // Progressive disclosure: store full output, return summary + expand key
         const detailKey = output.split("\n").length > 15 ? storeOutput(command, output) : undefined;
+        logCall("execute_smart", { command, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode, aiProcessed: processed.aiProcessed });
         return {
             content: [{ type: "text", text: JSON.stringify({
                         exitCode: result.exitCode,
@@ -217,7 +240,9 @@ export function createServer() {
         includeNodeModules: z.boolean().optional().describe("Include node_modules (default: false)"),
         maxResults: z.number().optional().describe("Max results per category (default: 50)"),
     }, async ({ pattern, path, includeNodeModules, maxResults }) => {
+        const start = Date.now();
         const result = await searchFiles(pattern, path ?? process.cwd(), { includeNodeModules, maxResults });
+        logCall("search_files", { command: `search_files ${pattern}`, tokensSaved: result.tokensSaved ?? 0, durationMs: Date.now() - start });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
     });
     // ── search_content: smart grep with grouping ──────────────────────────────
@@ -228,7 +253,9 @@ export function createServer() {
         maxResults: z.number().optional().describe("Max files to return (default: 30)"),
         contextLines: z.number().optional().describe("Context lines around matches (default: 0)"),
     }, async ({ pattern, path, fileType, maxResults, contextLines }) => {
+        const start = Date.now();
         const result = await searchContent(pattern, path ?? process.cwd(), { fileType, maxResults, contextLines });
+        logCall("search_content", { command: `grep ${pattern}`, tokensSaved: result.tokensSaved ?? 0, durationMs: Date.now() - start });
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
     });
     // ── search_semantic: AST-powered code search ───────────────────────────────
@@ -340,6 +367,7 @@ export function createServer() {
         cwd: z.string().optional().describe("Working directory"),
         timeout: z.number().optional().describe("Timeout in ms"),
     }, async ({ command, cwd, timeout }) => {
+        const start = Date.now();
         const workDir = cwd ?? process.cwd();
         const result = await exec(command, workDir, timeout ?? 30000);
         const output = (result.stdout + result.stderr).trim();
@@ -347,6 +375,7 @@ export function createServer() {
         if (diff.tokensSaved > 0) {
             recordSaving("diff", diff.tokensSaved);
         }
+        logCall("execute_diff", { command, outputTokens: estimateTokens(output), tokensSaved: diff.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode });
         if (diff.unchanged) {
             return { content: [{ type: "text", text: JSON.stringify({
                             exitCode: result.exitCode, unchanged: true, diffSummary: diff.diffSummary,
@@ -388,7 +417,8 @@ export function createServer() {
         }
         if (action === "detail" && sessionId) {
             const interactions = getSessionInteractions(sessionId);
-            return { content: [{ type: "text", text: JSON.stringify(interactions) }] };
+            const economy = getSessionEconomy(sessionId);
+            return { content: [{ type: "text", text: JSON.stringify({ interactions, economy }) }] };
         }
         const sessions = listSessions(limit ?? 20);
         return { content: [{ type: "text", text: JSON.stringify(sessions) }] };
@@ -453,9 +483,11 @@ export function createServer() {
         limit: z.number().optional().describe("Max lines to return"),
         summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
     }, async ({ path, offset, limit, summarize }) => {
+        const start = Date.now();
         const result = cachedRead(path, { offset, limit });
         if (summarize && result.content.length > 500) {
             const processed = await processOutput(`cat ${path}`, result.content);
+            logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: true });
             return {
                 content: [{ type: "text", text: JSON.stringify({
                             summary: processed.summary,
@@ -465,6 +497,7 @@ export function createServer() {
                         }) }],
             };
         }
+        logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: 0, durationMs: Date.now() - start });
         return {
             content: [{ type: "text", text: JSON.stringify({
                         content: result.content,

package/dist/sessions-db.js

@@ -137,6 +137,45 @@ export function getSessionStats() {
         errorRate: totalInteractions > 0 ? (errors.c ?? 0) / totalInteractions : 0,
     };
 }
+/** Get economy stats for a specific session */
+export function getSessionEconomy(sessionId) {
+    const d = getDb();
+    const rows = d.prepare("SELECT nl, tokens_saved, tokens_used, duration_ms FROM interactions WHERE session_id = ?").all(sessionId);
+    const tools = {};
+    let totalSaved = 0, totalUsed = 0, aiCalls = 0, totalLatency = 0, latencyCount = 0;
+    for (const r of rows) {
+        totalSaved += r.tokens_saved ?? 0;
+        totalUsed += r.tokens_used ?? 0;
+        if (r.tokens_used > 0)
+            aiCalls++;
+        if (r.duration_ms) {
+            totalLatency += r.duration_ms;
+            latencyCount++;
+        }
+        // Extract tool name from nl field: [mcp:toolname] command
+        const toolMatch = r.nl.match(/^\[mcp:(\w+)\]/);
+        const tool = toolMatch?.[1] ?? "cli";
+        if (!tools[tool])
+            tools[tool] = { calls: 0, tokensSaved: 0 };
+        tools[tool].calls++;
+        tools[tool].tokensSaved += r.tokens_saved ?? 0;
+    }
+    // Savings at consumer model rates (×5 turns before compaction)
+    const multiplied = totalSaved * 5;
+    return {
+        totalCalls: rows.length,
+        tokensSaved: totalSaved,
+        tokensUsed: totalUsed,
+        aiCalls,
+        avgLatencyMs: latencyCount > 0 ? Math.round(totalLatency / latencyCount) : 0,
+        savingsUsd: {
+            opus: (multiplied * 15) / 1_000_000,
+            sonnet: (multiplied * 3) / 1_000_000,
+            haiku: (multiplied * 0.8) / 1_000_000,
+        },
+        tools,
+    };
+}
 // ── Corrections ─────────────────────────────────────────────────────────────
 /** Record a correction: command failed, then AI retried with a better one */
 export function recordCorrection(prompt, failedCommand, errorOutput, correctedCommand, worked, errorType) {
@@ -164,6 +203,25 @@ export function findSimilarCorrections(prompt, limit = 5) {
 export function recordOutput(command, rawOutputPath, compressedSummary, tokensRaw, tokensCompressed, provider, model, sessionId) {
     getDb().prepare("INSERT INTO outputs (session_id, command, raw_output_path, compressed_summary, tokens_raw, tokens_compressed, provider, model, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)").run(sessionId ?? null, command, rawOutputPath ?? null, compressedSummary?.slice(0, 5000) ?? "", tokensRaw, tokensCompressed, provider ?? null, model ?? null, Date.now());
 }
+/** Prune sessions and interactions older than N days */
+export function pruneSessions(olderThanDays = 90) {
+    const d = getDb();
+    const cutoff = Date.now() - (olderThanDays * 24 * 60 * 60 * 1000);
+    const oldSessions = d.prepare("SELECT id FROM sessions WHERE started_at < ?").all(cutoff);
+    if (oldSessions.length === 0)
+        return { sessionsDeleted: 0, interactionsDeleted: 0 };
+    const ids = oldSessions.map(s => s.id);
+    const placeholders = ids.map(() => "?").join(",");
+    const intResult = d.prepare(`DELETE FROM interactions WHERE session_id IN (${placeholders})`).run(...ids);
+    const sesResult = d.prepare(`DELETE FROM sessions WHERE id IN (${placeholders})`).run(...ids);
+    // Also prune old corrections and outputs
+    d.prepare("DELETE FROM corrections WHERE created_at < ?").run(cutoff);
+    d.prepare("DELETE FROM outputs WHERE created_at < ?").run(cutoff);
+    return {
+        sessionsDeleted: oldSessions.length,
+        interactionsDeleted: intResult.changes ?? 0,
+    };
+}
 /** Close the database connection */
 export function closeDb() {
     if (db) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/terminal",
-  "version": "3.3.9",
+  "version": "3.4.0",
   "description": "Smart terminal wrapper for AI agents and humans — structured output, token compression, MCP server, natural language",
   "type": "module",
   "files": [

package/src/cli.tsx

@@ -83,6 +83,16 @@ if (args[0] === "uninstall") {
   process.exit(0);
 }
 
+// ── Prune ────────────────────────────────────────────────────────────────────
+
+if (args[0] === "prune") {
+  const days = parseInt(args.find(a => a.startsWith("--older-than="))?.split("=")[1] ?? "90");
+  const { pruneSessions } = await import("./sessions-db.js");
+  const result = pruneSessions(days);
+  console.log(`  Pruned ${result.sessionsDeleted} sessions, ${result.interactionsDeleted} interactions older than ${days}d`);
+  process.exit(0);
+}
+
 // ── MCP commands ─────────────────────────────────────────────────────────────
 
 if (args[0] === "mcp") {

package/src/mcp/server.ts

@@ -13,7 +13,7 @@ import { listRecipes, listCollections, getRecipe, createRecipe } from "../recipe
 import { substituteVariables } from "../recipes/model.js";
 import { bgStart, bgStatus, bgStop, bgLogs, bgWaitPort } from "../supervisor.js";
 import { diffOutput } from "../diff-cache.js";
-import { listSessions, getSessionInteractions, getSessionStats } from "../sessions-db.js";
+import { createSession, logInteraction, listSessions, getSessionInteractions, getSessionStats, getSessionEconomy } from "../sessions-db.js";
 import { cachedRead, cacheStats } from "../file-cache.js";
 import { getBootContext, invalidateBootCache } from "../session-boot.js";
 import { storeOutput, expandOutput } from "../expand-store.js";
@@ -62,9 +62,36 @@ function exec(command: string, cwd?: string, timeout?: number, allowRewrite: boo
 export function createServer(): McpServer {
   const server = new McpServer({
     name: "terminal",
-    version: "0.2.0",
+    version: "3.4.0",
   });
 
+  // Create a session for this MCP server instance
+  const sessionId = createSession(process.cwd(), "mcp");
+
+  /** Log a tool call to sessions.db for economy tracking */
+  function logCall(tool: string, data: {
+    command?: string;
+    outputTokens?: number;
+    tokensSaved?: number;
+    durationMs?: number;
+    exitCode?: number;
+    aiProcessed?: boolean;
+    model?: string;
+  }) {
+    try {
+      logInteraction(sessionId, {
+        nl: `[mcp:${tool}]${data.command ? ` ${data.command.slice(0, 200)}` : ""}`,
+        command: data.command?.slice(0, 500),
+        exitCode: data.exitCode,
+        tokensUsed: data.aiProcessed ? (data.outputTokens ?? 0) : 0,
+        tokensSaved: data.tokensSaved ?? 0,
+        durationMs: data.durationMs,
+        model: data.model,
+        cached: false,
+      });
+    } catch {} // never let logging break tool execution
+  }
+
   // ── execute: run a command, return structured result ──────────────────────
 
   server.tool(
@@ -78,16 +105,17 @@ export function createServer(): McpServer {
       maxTokens: z.number().optional().describe("Token budget for compressed/summary format"),
     },
     async ({ command, cwd, timeout, format, maxTokens }) => {
+      const start = Date.now();
       const result = await exec(command, cwd, timeout ?? 30000);
       const output = (result.stdout + result.stderr).trim();
 
       // Raw mode — with lazy execution for large results
       if (!format || format === "raw") {
         const clean = stripAnsi(output);
-        // Lazy mode: if >100 lines, return count + sample instead of full output
         if (shouldBeLazy(clean, command)) {
           const lazy = toLazy(clean, command);
           const detailKey = storeOutput(command, clean);
+          logCall("execute", { command, outputTokens: estimateTokens(clean), tokensSaved: 0, durationMs: Date.now() - start, exitCode: result.exitCode });
           return {
             content: [{ type: "text" as const, text: JSON.stringify({
               exitCode: result.exitCode, ...lazy, detailKey, duration: result.duration,
@@ -95,6 +123,7 @@ export function createServer(): McpServer {
             }) }],
           };
         }
+        logCall("execute", { command, outputTokens: estimateTokens(clean), tokensSaved: 0, durationMs: Date.now() - start, exitCode: result.exitCode });
         return {
           content: [{ type: "text" as const, text: JSON.stringify({
             exitCode: result.exitCode, output: clean, duration: result.duration, tokens: estimateTokens(clean),
@@ -108,6 +137,7 @@ export function createServer(): McpServer {
         try {
           const processed = await processOutput(command, output);
           const detailKey = output.split("\n").length > 15 ? storeOutput(command, output) : undefined;
+          logCall("execute", { command, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode, aiProcessed: processed.aiProcessed });
           return {
             content: [{ type: "text" as const, text: JSON.stringify({
               exitCode: result.exitCode,
@@ -121,6 +151,7 @@ export function createServer(): McpServer {
           };
         } catch {
           const compressed = compress(command, output, { maxTokens });
+          logCall("execute", { command, outputTokens: estimateTokens(output), tokensSaved: compressed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode });
           return {
             content: [{ type: "text" as const, text: JSON.stringify({
               exitCode: result.exitCode, output: compressed.content, duration: result.duration,
@@ -156,12 +187,13 @@ export function createServer(): McpServer {
       timeout: z.number().optional().describe("Timeout in ms (default: 30000)"),
     },
     async ({ command, cwd, timeout }) => {
-      const result = await exec(command, cwd, timeout ?? 30000, true); // allow rewrite for smart mode
+      const start = Date.now();
+      const result = await exec(command, cwd, timeout ?? 30000, true);
       const output = (result.stdout + result.stderr).trim();
       const processed = await processOutput(command, output);
 
-      // Progressive disclosure: store full output, return summary + expand key
       const detailKey = output.split("\n").length > 15 ? storeOutput(command, output) : undefined;
+      logCall("execute_smart", { command, outputTokens: estimateTokens(output), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode, aiProcessed: processed.aiProcessed });
 
       return {
         content: [{ type: "text" as const, text: JSON.stringify({
@@ -274,7 +306,9 @@ export function createServer(): McpServer {
       maxResults: z.number().optional().describe("Max results per category (default: 50)"),
     },
     async ({ pattern, path, includeNodeModules, maxResults }) => {
+      const start = Date.now();
       const result = await searchFiles(pattern, path ?? process.cwd(), { includeNodeModules, maxResults });
+      logCall("search_files", { command: `search_files ${pattern}`, tokensSaved: (result as any).tokensSaved ?? 0, durationMs: Date.now() - start });
       return { content: [{ type: "text" as const, text: JSON.stringify(result) }] };
     }
   );
@@ -292,7 +326,9 @@ export function createServer(): McpServer {
       contextLines: z.number().optional().describe("Context lines around matches (default: 0)"),
     },
     async ({ pattern, path, fileType, maxResults, contextLines }) => {
+      const start = Date.now();
       const result = await searchContent(pattern, path ?? process.cwd(), { fileType, maxResults, contextLines });
+      logCall("search_content", { command: `grep ${pattern}`, tokensSaved: result.tokensSaved ?? 0, durationMs: Date.now() - start });
       return { content: [{ type: "text" as const, text: JSON.stringify(result) }] };
     }
   );
@@ -482,6 +518,7 @@ export function createServer(): McpServer {
       timeout: z.number().optional().describe("Timeout in ms"),
     },
     async ({ command, cwd, timeout }) => {
+      const start = Date.now();
       const workDir = cwd ?? process.cwd();
       const result = await exec(command, workDir, timeout ?? 30000);
       const output = (result.stdout + result.stderr).trim();
@@ -490,6 +527,7 @@ export function createServer(): McpServer {
       if (diff.tokensSaved > 0) {
         recordSaving("diff", diff.tokensSaved);
       }
+      logCall("execute_diff", { command, outputTokens: estimateTokens(output), tokensSaved: diff.tokensSaved, durationMs: Date.now() - start, exitCode: result.exitCode });
 
       if (diff.unchanged) {
         return { content: [{ type: "text" as const, text: JSON.stringify({
@@ -553,7 +591,8 @@ export function createServer(): McpServer {
       }
       if (action === "detail" && sessionId) {
         const interactions = getSessionInteractions(sessionId);
-        return { content: [{ type: "text" as const, text: JSON.stringify(interactions) }] };
+        const economy = getSessionEconomy(sessionId);
+        return { content: [{ type: "text" as const, text: JSON.stringify({ interactions, economy }) }] };
       }
       const sessions = listSessions(limit ?? 20);
       return { content: [{ type: "text" as const, text: JSON.stringify(sessions) }] };
@@ -646,10 +685,12 @@ export function createServer(): McpServer {
       summarize: z.boolean().optional().describe("Return AI summary instead of full content (saves ~90% tokens)"),
     },
     async ({ path, offset, limit, summarize }) => {
+      const start = Date.now();
       const result = cachedRead(path, { offset, limit });
 
       if (summarize && result.content.length > 500) {
         const processed = await processOutput(`cat ${path}`, result.content);
+        logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: processed.tokensSaved, durationMs: Date.now() - start, aiProcessed: true });
         return {
           content: [{ type: "text" as const, text: JSON.stringify({
             summary: processed.summary,
@@ -660,6 +701,7 @@ export function createServer(): McpServer {
         };
       }
 
+      logCall("read_file", { command: path, outputTokens: estimateTokens(result.content), tokensSaved: 0, durationMs: Date.now() - start });
       return {
         content: [{ type: "text" as const, text: JSON.stringify({
           content: result.content,

package/src/sessions-db.ts

@@ -212,6 +212,55 @@ export function getSessionStats(): SessionStats {
   };
 }
 
+/** Get economy stats for a specific session */
+export function getSessionEconomy(sessionId: string): {
+  totalCalls: number;
+  tokensSaved: number;
+  tokensUsed: number;
+  aiCalls: number;
+  avgLatencyMs: number;
+  savingsUsd: { opus: number; sonnet: number; haiku: number };
+  tools: Record<string, { calls: number; tokensSaved: number }>;
+} {
+  const d = getDb();
+  const rows = d.prepare(
+    "SELECT nl, tokens_saved, tokens_used, duration_ms FROM interactions WHERE session_id = ?"
+  ).all(sessionId) as { nl: string; tokens_saved: number; tokens_used: number; duration_ms: number | null }[];
+
+  const tools: Record<string, { calls: number; tokensSaved: number }> = {};
+  let totalSaved = 0, totalUsed = 0, aiCalls = 0, totalLatency = 0, latencyCount = 0;
+
+  for (const r of rows) {
+    totalSaved += r.tokens_saved ?? 0;
+    totalUsed += r.tokens_used ?? 0;
+    if (r.tokens_used > 0) aiCalls++;
+    if (r.duration_ms) { totalLatency += r.duration_ms; latencyCount++; }
+
+    // Extract tool name from nl field: [mcp:toolname] command
+    const toolMatch = r.nl.match(/^\[mcp:(\w+)\]/);
+    const tool = toolMatch?.[1] ?? "cli";
+    if (!tools[tool]) tools[tool] = { calls: 0, tokensSaved: 0 };
+    tools[tool].calls++;
+    tools[tool].tokensSaved += r.tokens_saved ?? 0;
+  }
+
+  // Savings at consumer model rates (×5 turns before compaction)
+  const multiplied = totalSaved * 5;
+  return {
+    totalCalls: rows.length,
+    tokensSaved: totalSaved,
+    tokensUsed: totalUsed,
+    aiCalls,
+    avgLatencyMs: latencyCount > 0 ? Math.round(totalLatency / latencyCount) : 0,
+    savingsUsd: {
+      opus: (multiplied * 15) / 1_000_000,
+      sonnet: (multiplied * 3) / 1_000_000,
+      haiku: (multiplied * 0.8) / 1_000_000,
+    },
+    tools,
+  };
+}
+
 // ── Corrections ─────────────────────────────────────────────────────────────
 
 /** Record a correction: command failed, then AI retried with a better one */
@@ -267,6 +316,30 @@ export function recordOutput(
   ).run(sessionId ?? null, command, rawOutputPath ?? null, compressedSummary?.slice(0, 5000) ?? "", tokensRaw, tokensCompressed, provider ?? null, model ?? null, Date.now());
 }
 
+/** Prune sessions and interactions older than N days */
+export function pruneSessions(olderThanDays: number = 90): { sessionsDeleted: number; interactionsDeleted: number } {
+  const d = getDb();
+  const cutoff = Date.now() - (olderThanDays * 24 * 60 * 60 * 1000);
+  const oldSessions = d.prepare("SELECT id FROM sessions WHERE started_at < ?").all(cutoff) as { id: string }[];
+
+  if (oldSessions.length === 0) return { sessionsDeleted: 0, interactionsDeleted: 0 };
+
+  const ids = oldSessions.map(s => s.id);
+  const placeholders = ids.map(() => "?").join(",");
+
+  const intResult = d.prepare(`DELETE FROM interactions WHERE session_id IN (${placeholders})`).run(...ids);
+  const sesResult = d.prepare(`DELETE FROM sessions WHERE id IN (${placeholders})`).run(...ids);
+
+  // Also prune old corrections and outputs
+  d.prepare("DELETE FROM corrections WHERE created_at < ?").run(cutoff);
+  d.prepare("DELETE FROM outputs WHERE created_at < ?").run(cutoff);
+
+  return {
+    sessionsDeleted: oldSessions.length,
+    interactionsDeleted: (intResult as any).changes ?? 0,
+  };
+}
+
 /** Close the database connection */
 export function closeDb(): void {
   if (db) { db.close(); db = null; }