codesesh 0.1.5 → 0.2.0

package/README.md

@@ -19,10 +19,12 @@ Your browser will open at `http://localhost:4321` with all your sessions ready t
 ## Features
 
 - **Unified Timeline** — Browse sessions across all your AI agents in a single, searchable interface
+- **Dashboard & Activity Trends** — See totals, daily activity, agent distribution, and recent sessions
 - **Full Conversation Replay** — Read every message, tool call, and reasoning step exactly as it happened
 - **Cost & Token Visibility** — See exactly how many tokens and dollars each session consumed
 - **Zero Configuration** — Just run it. CodeSesh auto-discovers everything on your filesystem
 - **100% Local & Private** — Nothing leaves your machine. No accounts, no cloud sync, no telemetry
+- **Live Refresh** — Local session changes are picked up automatically while the server is running
 
 ## Supported Agents
 
@@ -46,6 +48,9 @@ npx codesesh --port 8080
 # Only show sessions from the last 3 days
 npx codesesh --days 3
 
+# Jump directly to a session
+npx codesesh --session claudecode://3b0e4ead-eba9-43e7-9fac-b30647e189f8
+
 # Filter to sessions from current project
 npx codesesh --cwd .
 
@@ -54,6 +59,9 @@ npx codesesh --agent claudecode
 
 # Output JSON instead of starting server
 npx codesesh --json
+
+# Show performance trace logs
+npx codesesh --trace
 ```
 
 ## CLI Options
@@ -66,8 +74,12 @@ npx codesesh --json
 | `--agent`   | `-a`  | all     | Filter to specific agent(s), comma-separated                |
 | `--from`    | —     | —       | Sessions created after this date `YYYY-MM-DD`               |
 | `--to`      | —     | —       | Sessions created before this date `YYYY-MM-DD`              |
+| `--session` | `-s`  | —       | Directly open a session (`agent://session-id`)              |
 | `--json`    | `-j`  | `false` | Output JSON and exit (no server)                            |
 | `--no-open` | —     | `false` | Don't auto-open the browser                                 |
+| `--trace`   | —     | `false` | Print performance trace logs                                |
+| `--cache`   | —     | `true`  | Use cached scan results when available                      |
+| `--clear-cache` | — | `false` | Clear scan cache before starting                            |
 
 ## Requirements
 

package/dist/{chunk-FG2FZIU5.js → chunk-2UNXB2D3.js}

@@ -2,7 +2,7 @@
 
 // ../core/dist/index.mjs
 import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
-import { join as join2, basename as basename2 } from "path";
+import { join as join2, basename as basename2, dirname } from "path";
 import { existsSync } from "fs";
 import { homedir, platform } from "os";
 import { join } from "path";
@@ -13,7 +13,7 @@ import { join as join3 } from "path";
 import { createRequire } from "module";
 import { createHash } from "crypto";
 import { existsSync as existsSync4, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
-import { join as join4, basename as basename3, dirname } from "path";
+import { join as join4, basename as basename3, dirname as dirname2 } from "path";
 import { existsSync as existsSync5, readFileSync as readFileSync4, readdirSync as readdirSync3, statSync as statSync4 } from "fs";
 import { join as join5, basename as basename4 } from "path";
 import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync5, statSync as statSync5 } from "fs";
@@ -205,6 +205,7 @@ var PerfTracer = class {
   }
 };
 var perf = new PerfTracer();
+var RECENT_SESSION_REVALIDATION_WINDOW_MS = 24 * 60 * 60 * 1e3;
 function parseTimestampMs(data) {
   const raw = String(data["timestamp"] ?? "").trim();
   if (!raw) return 0;
@@ -348,17 +349,30 @@ var ClaudeCodeAgent = class extends BaseAgent {
     if (!this.basePath) {
       return { hasChanges: false, timestamp: Date.now() };
     }
-    const changedIds = [];
-    for (const session of cachedSessions) {
+    const now = Date.now();
+    const changedIds = /* @__PURE__ */ new Set();
+    const recentSessions = cachedSessions.filter(
+      (session) => now - session.time_created <= RECENT_SESSION_REVALIDATION_WINDOW_MS
+    );
+    for (const session of recentSessions) {
+      changedIds.add(session.id);
       const meta = this.sessionMetaMap.get(session.id);
       if (!meta) continue;
+      delete this.sessionsIndexCache[basename2(dirname(meta.sourcePath))];
+    }
+    for (const session of cachedSessions) {
+      const meta = this.sessionMetaMap.get(session.id);
+      if (!meta) {
+        changedIds.add(session.id);
+        continue;
+      }
       try {
         const stat = statSync(meta.sourcePath);
         if (stat.mtimeMs > sinceTimestamp) {
-          changedIds.push(session.id);
+          changedIds.add(session.id);
         }
       } catch {
-        changedIds.push(session.id);
+        changedIds.add(session.id);
       }
     }
     try {
@@ -368,14 +382,14 @@ var ClaudeCodeAgent = class extends BaseAgent {
       }
       const hasNewFiles = totalFiles > cachedSessions.length;
       return {
-        hasChanges: changedIds.length > 0 || hasNewFiles,
-        changedIds,
+        hasChanges: changedIds.size > 0 || hasNewFiles,
+        changedIds: Array.from(changedIds),
         timestamp: Date.now()
       };
     } catch {
       return {
-        hasChanges: changedIds.length > 0,
-        changedIds,
+        hasChanges: changedIds.size > 0,
+        changedIds: Array.from(changedIds),
         timestamp: Date.now()
       };
     }
@@ -1024,6 +1038,7 @@ var OpenCodeAgent = class extends BaseAgent {
         const timeUpdated = Number(row.time_updated ?? timeCreated);
         const slug = `opencode/${id}`;
         const directory = String(row.directory ?? "");
+        const stats = hasMessageTable ? this.readSessionStats(db, id) : null;
         heads.push({
           id,
           slug,
@@ -1032,10 +1047,10 @@ var OpenCodeAgent = class extends BaseAgent {
           time_created: timeCreated,
           time_updated: timeUpdated,
           stats: {
-            message_count: Number(row.message_count ?? 0),
-            total_input_tokens: 0,
-            total_output_tokens: 0,
-            total_cost: 0
+            message_count: stats?.message_count ?? Number(row.message_count ?? 0),
+            total_input_tokens: stats?.total_input_tokens ?? 0,
+            total_output_tokens: stats?.total_output_tokens ?? 0,
+            total_cost: stats?.total_cost ?? 0
           }
         });
         if (this.dbPath) {
@@ -1088,6 +1103,30 @@ var OpenCodeAgent = class extends BaseAgent {
   incrementalScan(_cachedSessions, _changedIds) {
     return this.scan();
   }
+  readSessionStats(db, sessionId) {
+    try {
+      const rows = db.prepare("SELECT data FROM message WHERE session_id = ? ORDER BY time_created ASC").all(sessionId);
+      let totalCost = 0;
+      let totalInputTokens = 0;
+      let totalOutputTokens = 0;
+      for (const row of rows) {
+        const msgData = JSON.parse(String(row.data ?? "{}"));
+        const cost = Number(msgData.cost ?? 0);
+        const tokens = msgData.tokens;
+        totalCost += cost;
+        totalInputTokens += Number(tokens?.input ?? 0);
+        totalOutputTokens += Number(tokens?.output ?? 0);
+      }
+      return {
+        message_count: rows.length,
+        total_input_tokens: totalInputTokens,
+        total_output_tokens: totalOutputTokens,
+        total_cost: totalCost
+      };
+    } catch {
+      return null;
+    }
+  }
   getSessionData(sessionId) {
     if (!this.dbPath) {
       this.dbPath = this.findDbPath();
@@ -1301,7 +1340,7 @@ var KimiAgent = class extends BaseAgent {
   parseSessionDir(sessionDir) {
     try {
       const sessionId = basename3(sessionDir);
-      const projectHash = basename3(dirname(sessionDir));
+      const projectHash = basename3(dirname2(sessionDir));
       const contextFile = join4(sessionDir, "context.jsonl");
       const wireFile = join4(sessionDir, "wire.jsonl");
       if (!existsSync4(contextFile) && !existsSync4(wireFile)) return null;
@@ -1351,6 +1390,7 @@ var KimiAgent = class extends BaseAgent {
         perf.end(parseMarker);
         if (!meta) continue;
         this.sessionMetaMap.set(meta.id, meta);
+        const stats = this.extractStats(meta.sourcePath);
         heads.push({
           id: meta.id,
           slug: `kimi/${meta.id}`,
@@ -1358,12 +1398,7 @@ var KimiAgent = class extends BaseAgent {
           directory: meta.cwd,
           time_created: meta.createdAt,
           time_updated: meta.createdAt,
-          stats: {
-            message_count: 0,
-            total_input_tokens: 0,
-            total_output_tokens: 0,
-            total_cost: 0
-          }
+          stats
         });
       } catch {
       }
@@ -1421,6 +1456,7 @@ var KimiAgent = class extends BaseAgent {
         if (!meta) continue;
         if (changedIds.includes(meta.id)) {
           this.sessionMetaMap.set(meta.id, meta);
+          const stats = this.extractStats(meta.sourcePath);
           sessionMap.set(meta.id, {
             id: meta.id,
             slug: `kimi/${meta.id}`,
@@ -1428,12 +1464,7 @@ var KimiAgent = class extends BaseAgent {
             directory: meta.cwd,
             time_created: meta.createdAt,
             time_updated: meta.createdAt,
-            stats: {
-              message_count: 0,
-              total_input_tokens: 0,
-              total_output_tokens: 0,
-              total_cost: 0
-            }
+            stats
           });
         }
       } catch {
@@ -1861,6 +1892,7 @@ var CODEX_TOOL_TITLE_MAP = {
   spawn_agent: "subagent",
   subagent: "subagent"
 };
+var RECENT_SESSION_REVALIDATION_WINDOW_MS2 = 24 * 60 * 60 * 1e3;
 function extractSessionId(filename) {
   const stem = basename4(filename, ".jsonl");
   const parts = stem.split("-");
@@ -1878,6 +1910,9 @@ function parseTimestampMs2(data) {
     return 0;
   }
 }
+function extractModelName(raw) {
+  return typeof raw === "string" && raw.trim() ? raw.trim() : null;
+}
 function normalizeTitleText3(text) {
   const line = text.split("\n").find((l) => l.trim());
   return line?.trim().slice(0, 80) || "";
@@ -2051,34 +2086,43 @@ var CodexAgent = class extends BaseAgent {
     if (!this.basePath) {
       return { hasChanges: false, timestamp: Date.now() };
     }
-    const changedIds = [];
+    const now = Date.now();
+    const changedIds = /* @__PURE__ */ new Set();
+    const currentFiles = this.listRolloutFiles();
+    const currentIds = new Set(currentFiles.map((file) => extractSessionId(file)));
+    const cachedIds = new Set(cachedSessions.map((session) => session.id));
+    const recentIds = cachedSessions.filter((session) => now - session.time_created <= RECENT_SESSION_REVALIDATION_WINDOW_MS2).map((session) => session.id);
+    for (const sessionId of recentIds) {
+      changedIds.add(sessionId);
+    }
     for (const session of cachedSessions) {
       const meta = this.sessionMetaMap.get(session.id);
-      if (!meta) continue;
+      if (!currentIds.has(session.id)) {
+        changedIds.add(session.id);
+        continue;
+      }
+      if (!meta) {
+        changedIds.add(session.id);
+        continue;
+      }
       try {
         const stat = statSync4(meta.sourcePath);
         if (stat.mtimeMs > sinceTimestamp) {
-          changedIds.push(session.id);
+          changedIds.add(session.id);
         }
       } catch {
-        changedIds.push(session.id);
+        changedIds.add(session.id);
       }
     }
-    try {
-      const allFiles = this.listRolloutFiles();
-      const hasNewFiles = allFiles.length > cachedSessions.length;
-      return {
-        hasChanges: changedIds.length > 0 || hasNewFiles,
-        changedIds,
-        timestamp: Date.now()
-      };
-    } catch {
-      return {
-        hasChanges: changedIds.length > 0,
-        changedIds,
-        timestamp: Date.now()
-      };
+    const hasAddedSessions = currentFiles.some((file) => !cachedIds.has(extractSessionId(file)));
+    if (recentIds.length > 0) {
+      this.sessionIndexCache.clear();
     }
+    return {
+      hasChanges: changedIds.size > 0 || hasAddedSessions,
+      changedIds: Array.from(changedIds),
+      timestamp: Date.now()
+    };
   }
   /**
    * 增量扫描
@@ -2086,10 +2130,19 @@ var CodexAgent = class extends BaseAgent {
   incrementalScan(cachedSessions, changedIds) {
     if (!this.basePath) return cachedSessions;
     const sessionMap = new Map(cachedSessions.map((s) => [s.id, s]));
-    for (const file of this.listRolloutFiles()) {
+    const changedSet = new Set(changedIds);
+    const currentFiles = this.listRolloutFiles();
+    const currentIds = new Set(currentFiles.map((file) => extractSessionId(file)));
+    for (const session of cachedSessions) {
+      if (!currentIds.has(session.id)) {
+        sessionMap.delete(session.id);
+        this.sessionMetaMap.delete(session.id);
+      }
+    }
+    for (const file of currentFiles) {
       try {
         const sessionId = extractSessionId(file);
-        if (changedIds.includes(sessionId)) {
+        if (changedSet.has(sessionId)) {
           const head = this.parseSessionHead(file);
           if (head) {
             sessionMap.set(head.id, head);
@@ -2108,7 +2161,7 @@ var CodexAgent = class extends BaseAgent {
       } catch {
       }
     }
-    for (const file of this.listRolloutFiles()) {
+    for (const file of currentFiles) {
       try {
         const sessionId = extractSessionId(file);
         if (!sessionMap.has(sessionId)) {
@@ -2144,13 +2197,18 @@ var CodexAgent = class extends BaseAgent {
     let currentAssistantIndex = null;
     let latestAssistantTextIndex = null;
     let pendingPlan = null;
+    let activeModel = meta.model;
     let prevCumulativeTotal = 0;
     let prevInput = 0;
-    let prevCached = 0;
     let prevOutput = 0;
     let prevReasoning = 0;
     for (const record of parseJsonlLines(content)) {
       try {
+        const recordType = String(record["type"] ?? "");
+        if (recordType === "turn_context") {
+          const payload = record["payload"] ?? {};
+          activeModel = extractModelName(payload["model"]) ?? activeModel;
+        }
         const result = this.convertRecord(
           record,
           messages,
@@ -2163,7 +2221,12 @@ var CodexAgent = class extends BaseAgent {
         currentAssistantIndex = result.currentAssistantIndex;
         latestAssistantTextIndex = result.latestAssistantTextIndex;
         pendingPlan = result.pendingPlan;
-        const recordType = String(record["type"] ?? "");
+        if (currentAssistantIndex !== null && activeModel) {
+          const message = messages[currentAssistantIndex];
+          if (message?.role === "assistant" && !message.model) {
+            message.model = activeModel;
+          }
+        }
         if (recordType === "event_msg") {
           const payload = record["payload"] ?? {};
           if (String(payload["type"] ?? "") === "token_count") {
@@ -2175,33 +2238,29 @@ var CodexAgent = class extends BaseAgent {
               prevCumulativeTotal = cumulativeTotal;
               const lastUsage = info?.["last_token_usage"];
               let inputTokens = 0;
-              let cachedInputTokens = 0;
               let outputTokens = 0;
               let reasoningTokens = 0;
               if (lastUsage) {
                 inputTokens = Number(lastUsage["input_tokens"] ?? 0);
-                cachedInputTokens = Number(lastUsage["cached_input_tokens"] ?? 0);
                 outputTokens = Number(lastUsage["output_tokens"] ?? 0);
                 reasoningTokens = Number(lastUsage["reasoning_output_tokens"] ?? 0);
               } else if (cumulativeTotal > 0 && totalUsage) {
                 inputTokens = Number(totalUsage["input_tokens"] ?? 0) - prevInput;
-                cachedInputTokens = Number(totalUsage["cached_input_tokens"] ?? 0) - prevCached;
                 outputTokens = Number(totalUsage["output_tokens"] ?? 0) - prevOutput;
                 reasoningTokens = Number(totalUsage["reasoning_output_tokens"] ?? 0) - prevReasoning;
                 prevInput = Number(totalUsage["input_tokens"] ?? 0);
-                prevCached = Number(totalUsage["cached_input_tokens"] ?? 0);
                 prevOutput = Number(totalUsage["output_tokens"] ?? 0);
                 prevReasoning = Number(totalUsage["reasoning_output_tokens"] ?? 0);
               }
-              const uncachedInput = Math.max(0, inputTokens - cachedInputTokens);
-              if (uncachedInput || outputTokens || reasoningTokens) {
-                totalInputTokens += uncachedInput;
+              const totalInput = Math.max(0, inputTokens);
+              if (totalInput || outputTokens || reasoningTokens) {
+                totalInputTokens += totalInput;
                 totalOutputTokens += outputTokens + reasoningTokens;
                 for (let i = messages.length - 1; i >= 0; i--) {
                   const msg = messages[i];
                   if (msg.role === "assistant" && !msg.tokens) {
                     msg.tokens = {
-                      input: uncachedInput,
+                      input: totalInput,
                       output: outputTokens + reasoningTokens
                     };
                     break;
@@ -2277,6 +2336,7 @@ var CodexAgent = class extends BaseAgent {
     }
   }
   getTitleForSession(sessionId) {
+    this.loadSessionIndex();
     return this.sessionIndexCache.get(sessionId) ?? null;
   }
   // ---- Session head parsing ----
@@ -2292,7 +2352,7 @@ var CodexAgent = class extends BaseAgent {
       return null;
     }
     const payload = firstRecord["payload"] ?? {};
-    const createdAt = parseTimestampMs2(payload) || statSync4(filePath).mtimeMs;
+    const createdAt = parseTimestampMs2(firstRecord) || parseTimestampMs2(payload) || statSync4(filePath).mtimeMs;
     const indexTitle = this.getTitleForSession(sessionId);
     const messageTitle = this.extractTitleFromLines(lines);
     const directoryTitle = basenameTitle(payload["cwd"] ? String(payload["cwd"]) : null);
@@ -2304,7 +2364,6 @@ var CodexAgent = class extends BaseAgent {
     let totalOutputTokens = 0;
     let scanPrevCumulativeTotal = 0;
     let scanPrevInput = 0;
-    let scanPrevCached = 0;
     let scanPrevOutput = 0;
     let scanPrevReasoning = 0;
     const COUNTED_TYPES = /* @__PURE__ */ new Set(["message", "function_call", "function_call_output"]);
@@ -2312,10 +2371,13 @@ var CodexAgent = class extends BaseAgent {
       try {
         const data = JSON.parse(line);
         const recordType = String(data["type"] ?? "");
-        if (recordType === "session_meta") {
-          const p = data["payload"] ?? {};
-          const ts = parseTimestampMs2(p);
-          if (ts > updatedAt) updatedAt = ts;
+        const recordTs = parseTimestampMs2(data) || parseTimestampMs2(data["payload"] ?? {});
+        if (recordTs > updatedAt) updatedAt = recordTs;
+        if (recordType === "session_meta" || recordType === "turn_context") {
+          const payload2 = data["payload"] ?? {};
+          if (!model) {
+            model = extractModelName(payload2["model"]);
+          }
           continue;
         }
         if (recordType === "response_item") {
@@ -2340,26 +2402,22 @@ var CodexAgent = class extends BaseAgent {
               scanPrevCumulativeTotal = cumulativeTotal;
               const lastUsage = info?.["last_token_usage"];
               let inputTokens = 0;
-              let cachedInputTokens = 0;
               let outputTokens = 0;
               let reasoningTokens = 0;
               if (lastUsage) {
                 inputTokens = Number(lastUsage["input_tokens"] ?? 0);
-                cachedInputTokens = Number(lastUsage["cached_input_tokens"] ?? 0);
                 outputTokens = Number(lastUsage["output_tokens"] ?? 0);
                 reasoningTokens = Number(lastUsage["reasoning_output_tokens"] ?? 0);
               } else if (cumulativeTotal > 0 && totalUsage) {
                 inputTokens = Number(totalUsage["input_tokens"] ?? 0) - scanPrevInput;
-                cachedInputTokens = Number(totalUsage["cached_input_tokens"] ?? 0) - scanPrevCached;
                 outputTokens = Number(totalUsage["output_tokens"] ?? 0) - scanPrevOutput;
                 reasoningTokens = Number(totalUsage["reasoning_output_tokens"] ?? 0) - scanPrevReasoning;
                 scanPrevInput = Number(totalUsage["input_tokens"] ?? 0);
-                scanPrevCached = Number(totalUsage["cached_input_tokens"] ?? 0);
                 scanPrevOutput = Number(totalUsage["output_tokens"] ?? 0);
                 scanPrevReasoning = Number(totalUsage["reasoning_output_tokens"] ?? 0);
               }
-              const uncachedInput = Math.max(0, inputTokens - cachedInputTokens);
-              totalInputTokens += uncachedInput;
+              const totalInput = Math.max(0, inputTokens);
+              totalInputTokens += totalInput;
               totalOutputTokens += outputTokens + reasoningTokens;
             }
           }
@@ -3002,7 +3060,12 @@ var CursorAgent = class extends BaseAgent {
           const title = this.extractTitle(composer);
           const createdAt = composer.createdAt ?? 0;
           const updatedAt = composer.updatedAt ?? createdAt;
-          const messages = this.loadMessagesFromBubbles(db, composerId, sessionId);
+          const messages = this.loadMessagesFromBubbles(
+            db,
+            composerId,
+            sessionId,
+            composer.modelConfig?.modelName ?? composer.model ?? null
+          );
           const hasSubagents = Array.isArray(composer.subagentInfos) && composer.subagentInfos.length > 0;
           if (messages.length === 0 && !hasSubagents) {
             continue;
@@ -3114,7 +3177,12 @@ var CursorAgent = class extends BaseAgent {
       const title = this.extractTitle(composer);
       const createdAt = composer.createdAt ?? 0;
       const updatedAt = composer.updatedAt ?? createdAt;
-      const messages = this.loadMessagesFromBubbles(db, composerId, resolvedSessionId);
+      const messages = this.loadMessagesFromBubbles(
+        db,
+        composerId,
+        resolvedSessionId,
+        composer.modelConfig?.modelName ?? composer.model ?? null
+      );
       let totalInputTokens = 0;
       let totalOutputTokens = 0;
       for (const msg of messages) {
@@ -3222,11 +3290,11 @@ var CursorAgent = class extends BaseAgent {
     }
   }
   /** Load messages from bubbles (like agent-dump) */
-  loadMessagesFromBubbles(db, composerId, _sessionId) {
+  loadMessagesFromBubbles(db, composerId, _sessionId, initialModelName) {
     const messages = [];
     try {
       const rows = db.prepare("SELECT key, value FROM cursorDiskKV WHERE key LIKE ? ORDER BY rowid ASC").all(`bubbleId:${composerId}:%`);
-      let activeModelName = null;
+      let activeModelName = initialModelName;
       let messageIndex = 0;
       for (const row of rows) {
         try {
@@ -3241,7 +3309,7 @@ var CursorAgent = class extends BaseAgent {
           } else if (bubble.timestamp) {
             timestampMs = bubble.timestamp;
           }
-          if (role === "user" && bubble.modelInfo?.modelName) {
+          if (bubble.modelInfo?.modelName) {
             activeModelName = bubble.modelInfo.modelName;
           }
           const inputTokens = bubble.tokenCount?.inputTokens ?? 0;
@@ -3265,7 +3333,7 @@ var CursorAgent = class extends BaseAgent {
             time_created: timestampMs,
             time_completed: null,
             mode: role === "assistant" && parts.some((p) => p.type === "tool") ? "tool" : null,
-            model: activeModelName,
+            model: bubble.modelInfo?.modelName ?? activeModelName,
             provider: null,
             tokens: { input: inputTokens, output: outputTokens },
             cost: 0,
@@ -3531,9 +3599,18 @@ function filterSessions(sessions, options) {
   }
   return result;
 }
+function buildAgentCacheMeta(agent) {
+  const metaMap = agent.getSessionMetaMap?.();
+  const meta = {};
+  if (!metaMap) return meta;
+  for (const [id, data] of metaMap.entries()) {
+    meta[id] = { id, ...data };
+  }
+  return meta;
+}
 async function scanAgentSmart(agent, options, onProgress) {
   const useCache = options.useCache ?? true;
-  const smartRefresh = options.smartRefresh ?? true;
+  const canValidateCache = Boolean(agent.checkForChanges && agent.incrementalScan);
   if (useCache) {
     const cached = loadCachedSessions(agent.name);
     if (cached !== null) {
@@ -3544,16 +3621,39 @@ async function scanAgentSmart(agent, options, onProgress) {
         }
         agent.setSessionMetaMap(metaMap);
       }
-      agent.isAvailable();
+      const isAvail = agent.isAvailable();
+      if (!isAvail) {
+        return null;
+      }
       onProgress?.({
         agent: agent.name,
         phase: "cache",
         cachedCount: cached.sessions.length
       });
-      if (smartRefresh && agent.checkForChanges) {
-        setTimeout(async () => {
-          await refreshAgentAsync(agent, cached.sessions, cached.timestamp, onProgress);
-        }, 0);
+      if (canValidateCache) {
+        onProgress?.({ agent: agent.name, phase: "checking" });
+        const checkResult = await Promise.resolve(
+          agent.checkForChanges(cached.timestamp, cached.sessions)
+        );
+        if (checkResult.hasChanges) {
+          onProgress?.({
+            agent: agent.name,
+            phase: "incremental",
+            changedCount: checkResult.changedIds?.length
+          });
+          const updatedSessions = await Promise.resolve(
+            agent.incrementalScan(cached.sessions, checkResult.changedIds || [])
+          );
+          saveCachedSessions(agent.name, updatedSessions, buildAgentCacheMeta(agent));
+          onProgress?.({
+            agent: agent.name,
+            phase: "complete",
+            newCount: updatedSessions.length
+          });
+          const filtered2 = filterSessions(updatedSessions, options);
+          return { agent, heads: filtered2, fromCache: true, refreshed: true };
+        }
+        onProgress?.({ agent: agent.name, phase: "complete", newCount: cached.sessions.length });
       }
       const filtered = filterSessions(cached.sessions, options);
       return { agent, heads: filtered, fromCache: true };
@@ -3561,41 +3661,6 @@ async function scanAgentSmart(agent, options, onProgress) {
   }
   return scanAgentFull(agent, options, onProgress);
 }
-async function refreshAgentAsync(agent, cachedSessions, cacheTimestamp, onProgress) {
-  try {
-    onProgress?.({ agent: agent.name, phase: "checking" });
-    const checkResult = await Promise.resolve(
-      agent.checkForChanges(cacheTimestamp, cachedSessions)
-    );
-    if (!checkResult.hasChanges) {
-      onProgress?.({ agent: agent.name, phase: "complete" });
-      return;
-    }
-    onProgress?.({
-      agent: agent.name,
-      phase: "incremental",
-      changedCount: checkResult.changedIds?.length
-    });
-    const updatedSessions = await Promise.resolve(
-      agent.incrementalScan(cachedSessions, checkResult.changedIds || [])
-    );
-    const metaMap = agent.getSessionMetaMap?.();
-    const meta = {};
-    if (metaMap) {
-      for (const [id, data] of metaMap.entries()) {
-        meta[id] = { id, ...data };
-      }
-    }
-    saveCachedSessions(agent.name, updatedSessions, meta);
-    onProgress?.({
-      agent: agent.name,
-      phase: "complete",
-      newCount: updatedSessions.length
-    });
-  } catch (err) {
-    console.error(`[${agent.name}] Background refresh failed:`, err);
-  }
-}
 async function scanAgentFull(agent, options, onProgress) {
   const availMarker = perf.start(`agent:${agent.name}:isAvailable`);
   const isAvail = agent.isAvailable();
@@ -3607,13 +3672,7 @@ async function scanAgentFull(agent, options, onProgress) {
     const scanMarker = perf.start(`agent:${agent.name}:scan`);
     const heads = agent.scan();
     perf.end(scanMarker);
-    const metaMap = agent.getSessionMetaMap?.();
-    const meta = {};
-    if (metaMap) {
-      for (const [id, data] of metaMap.entries()) {
-        meta[id] = { id, ...data };
-      }
-    }
+    const meta = buildAgentCacheMeta(agent);
     saveCachedSessions(agent.name, heads, meta);
     onProgress?.({ agent: agent.name, phase: "complete", newCount: heads.length });
     const filtered = filterSessions(heads, options);
@@ -3674,7 +3733,8 @@ export {
   saveCachedSessions,
   clearCache,
   getCacheInfo,
+  filterSessions,
   scanSessions,
   scanSessionsAsync
 };
-//# sourceMappingURL=chunk-FG2FZIU5.js.map
+//# sourceMappingURL=chunk-2UNXB2D3.js.map