engrm 0.4.26 → 0.4.28

package/dist/server.js

@@ -14230,6 +14230,17 @@ var MIGRATIONS = [
         ON chat_messages(session_id, transcript_index)
         WHERE transcript_index IS NOT NULL;
     `
+  },
+  {
+    version: 18,
+    description: "Add sqlite-vec semantic search for chat recall",
+    condition: (db) => isVecExtensionLoaded(db),
+    sql: `
+      CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+        chat_message_id INTEGER PRIMARY KEY,
+        embedding FLOAT[384]
+      );
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -14303,6 +14314,9 @@ function inferLegacySchemaVersion(db) {
   if (columnExists(db, "chat_messages", "source_kind") && columnExists(db, "chat_messages", "transcript_index")) {
     version2 = Math.max(version2, 17);
   }
+  if (tableExists(db, "vec_chat_messages")) {
+    version2 = Math.max(version2, 18);
+  }
   return version2;
 }
 function runMigrations(db) {
@@ -14419,6 +14433,20 @@ function ensureChatMessageColumns(db) {
     db.exec("PRAGMA user_version = 17");
   }
 }
+function ensureChatVectorTable(db) {
+  if (!isVecExtensionLoaded(db))
+    return;
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS vec_chat_messages USING vec0(
+      chat_message_id INTEGER PRIMARY KEY,
+      embedding FLOAT[384]
+    );
+  `);
+  const current = getSchemaVersion(db);
+  if (current < 18) {
+    db.exec("PRAGMA user_version = 18");
+  }
+}
 function ensureSyncOutboxSupportsChatMessages(db) {
   if (syncOutboxSupportsChatMessages(db)) {
     const current = getSchemaVersion(db);
@@ -14632,6 +14660,7 @@ class MemDatabase {
     ensureObservationTypes(this.db);
     ensureSessionSummaryColumns(this.db);
     ensureChatMessageColumns(this.db);
+    ensureChatVectorTable(this.db);
     ensureSyncOutboxSupportsChatMessages(this.db);
   }
   loadVecExtension() {
@@ -14998,6 +15027,14 @@ class MemDatabase {
   getChatMessageByRemoteSourceId(remoteSourceId) {
     return this.db.query("SELECT * FROM chat_messages WHERE remote_source_id = ?").get(remoteSourceId) ?? null;
   }
+  getChatMessagesByIds(ids) {
+    if (ids.length === 0)
+      return [];
+    const placeholders = ids.map(() => "?").join(",");
+    const rows = this.db.query(`SELECT * FROM chat_messages WHERE id IN (${placeholders})`).all(...ids);
+    const order = new Map(ids.map((id, index) => [id, index]));
+    return rows.sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0));
+  }
   getSessionChatMessages(sessionId, limit = 50) {
     return this.db.query(`SELECT * FROM chat_messages
          WHERE session_id = ?
@@ -15074,6 +15111,39 @@ class MemDatabase {
          ORDER BY created_at_epoch DESC, id DESC
          LIMIT ?`).all(needle, ...userId ? [userId] : [], limit);
   }
+  vecChatInsert(chatMessageId, embedding) {
+    if (!this.vecAvailable)
+      return;
+    this.db.query("INSERT OR REPLACE INTO vec_chat_messages (chat_message_id, embedding) VALUES (?, ?)").run(chatMessageId, new Uint8Array(embedding.buffer));
+  }
+  searchChatVec(queryEmbedding, projectId, limit = 20, userId) {
+    if (!this.vecAvailable)
+      return [];
+    const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND c.user_id = ?" : "";
+    const transcriptPreference = `
+      AND (
+        c.source_kind = 'transcript'
+        OR NOT EXISTS (
+          SELECT 1 FROM chat_messages t2
+          WHERE t2.session_id = c.session_id
+            AND t2.source_kind = 'transcript'
+        )
+      )`;
+    if (projectId !== null) {
+      return this.db.query(`SELECT v.chat_message_id, v.distance
+           FROM vec_chat_messages v
+           JOIN chat_messages c ON c.id = v.chat_message_id
+           WHERE v.embedding MATCH ?
+             AND k = ?
+             AND c.project_id = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, projectId, ...userId ? [userId] : []);
+    }
+    return this.db.query(`SELECT v.chat_message_id, v.distance
+         FROM vec_chat_messages v
+         JOIN chat_messages c ON c.id = v.chat_message_id
+         WHERE v.embedding MATCH ?
+           AND k = ?` + visibilityClause + transcriptPreference).all(embeddingBlob, limit, ...userId ? [userId] : []);
+  }
   getTranscriptChatMessage(sessionId, transcriptIndex) {
     return this.db.query("SELECT * FROM chat_messages WHERE session_id = ? AND transcript_index = ?").get(sessionId, transcriptIndex) ?? null;
   }
@@ -15815,6 +15885,9 @@ function composeEmbeddingText(obs) {
 
 `);
 }
+function composeChatEmbeddingText(text) {
+  return text.replace(/\s+/g, " ").trim().slice(0, 2000);
+}
 async function getPipeline() {
   if (_pipeline)
     return _pipeline;
@@ -16321,6 +16394,163 @@ function sanitizeFtsQuery(query) {
   return safe;
 }
 
+// src/tools/search-chat.ts
+async function searchChat(db, input) {
+  const limit = Math.max(1, Math.min(input.limit ?? 20, 100));
+  const projectScoped = input.project_scoped !== false;
+  let projectId = null;
+  let projectName;
+  if (projectScoped) {
+    const cwd = input.cwd ?? process.cwd();
+    const detected = detectProject(cwd);
+    const project = db.getProjectByCanonicalId(detected.canonical_id);
+    if (project) {
+      projectId = project.id;
+      projectName = project.name;
+    }
+  }
+  const lexical = db.searchChatMessages(input.query, projectId, limit * 2, input.user_id);
+  let semantic = [];
+  const queryEmbedding = db.vecAvailable ? await embedText(composeChatEmbeddingText(queryForEmbedding(input.query))) : null;
+  if (queryEmbedding && db.vecAvailable) {
+    semantic = db.searchChatVec(queryEmbedding, projectId, limit * 2, input.user_id);
+  }
+  const messageIds = mergeChatResults(lexical, semantic, limit);
+  const messages = messageIds.length > 0 ? db.getChatMessagesByIds(messageIds) : [];
+  return {
+    messages,
+    project: projectName,
+    session_count: countDistinctSessions(messages),
+    source_summary: summarizeChatSources(messages),
+    transcript_backed: messages.some((message) => message.source_kind === "transcript"),
+    semantic_backed: semantic.length > 0
+  };
+}
+var RRF_K2 = 40;
+function mergeChatResults(lexical, semantic, limit) {
+  const scores = new Map;
+  for (let rank = 0;rank < lexical.length; rank++) {
+    const message = lexical[rank];
+    scores.set(message.id, (scores.get(message.id) ?? 0) + 1 / (RRF_K2 + rank + 1));
+  }
+  for (let rank = 0;rank < semantic.length; rank++) {
+    const match = semantic[rank];
+    scores.set(match.chat_message_id, (scores.get(match.chat_message_id) ?? 0) + 1 / (RRF_K2 + rank + 1));
+  }
+  return Array.from(scores.entries()).sort((a, b) => b[1] - a[1]).slice(0, limit).map(([id]) => id);
+}
+function queryForEmbedding(query) {
+  return query.replace(/\s+/g, " ").trim().slice(0, 400);
+}
+function summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
+function countDistinctSessions(messages) {
+  return new Set(messages.map((message) => message.session_id)).size;
+}
+
+// src/tools/search-recall.ts
+async function searchRecall(db, input) {
+  const query = input.query.trim();
+  if (!query) {
+    return {
+      query,
+      results: [],
+      totals: { memory: 0, chat: 0 }
+    };
+  }
+  const limit = Math.max(1, Math.min(input.limit ?? 10, 50));
+  const [memory, chat] = await Promise.all([
+    searchObservations(db, input),
+    searchChat(db, {
+      query,
+      limit: limit * 2,
+      project_scoped: input.project_scoped,
+      cwd: input.cwd,
+      user_id: input.user_id
+    })
+  ]);
+  const merged = mergeRecallResults(memory.observations, chat.messages, limit);
+  return {
+    query,
+    project: memory.project ?? chat.project,
+    results: merged,
+    totals: {
+      memory: memory.total,
+      chat: chat.messages.length
+    }
+  };
+}
+function mergeRecallResults(memory, chat, limit) {
+  const nowEpoch = Math.floor(Date.now() / 1000);
+  const scored = [];
+  for (let index = 0;index < memory.length; index++) {
+    const item = memory[index];
+    const base = 1 / (60 + index + 1);
+    const score = base + Math.max(0, item.rank) * 0.08;
+    scored.push({
+      kind: "memory",
+      rank: score,
+      created_at: item.created_at,
+      created_at_epoch: Math.floor(new Date(item.created_at).getTime() / 1000) || undefined,
+      project_name: item.project_name,
+      observation_id: item.id,
+      id: item.id,
+      session_id: null,
+      type: item.type,
+      title: item.title,
+      detail: firstNonEmpty(item.narrative, parseFactsPreview(item.facts), item.files_modified ? `Files: ${item.files_modified}` : null, item.type) ?? item.type
+    });
+  }
+  for (let index = 0;index < chat.length; index++) {
+    const item = chat[index];
+    const base = 1 / (60 + index + 1);
+    const ageHours = Math.max(0, (nowEpoch - item.created_at_epoch) / 3600);
+    const immediacyBoost = ageHours < 1 ? 1 : 0;
+    const recencyBoost = ageHours < 24 ? 0.12 : ageHours < 72 ? 0.05 : 0.02;
+    const sourceBoost = item.source_kind === "transcript" ? 0.06 : 0.03;
+    scored.push({
+      kind: "chat",
+      rank: base + immediacyBoost + recencyBoost + sourceBoost,
+      created_at_epoch: item.created_at_epoch,
+      session_id: item.session_id,
+      id: item.id,
+      role: item.role,
+      source_kind: item.source_kind,
+      title: `${item.role} [${item.source_kind}]`,
+      detail: item.content.replace(/\s+/g, " ").trim()
+    });
+  }
+  return scored.sort((a, b) => {
+    if (b.rank !== a.rank)
+      return b.rank - a.rank;
+    return (b.created_at_epoch ?? 0) - (a.created_at_epoch ?? 0);
+  }).slice(0, limit);
+}
+function parseFactsPreview(facts) {
+  if (!facts)
+    return null;
+  try {
+    const parsed = JSON.parse(facts);
+    if (!Array.isArray(parsed) || parsed.length === 0)
+      return null;
+    const lines = parsed.filter((item) => typeof item === "string" && item.trim().length > 0);
+    return lines.length > 0 ? lines.slice(0, 2).join(" | ") : null;
+  } catch {
+    return facts;
+  }
+}
+function firstNonEmpty(...values) {
+  for (const value of values) {
+    if (value && value.trim().length > 0)
+      return value.trim();
+  }
+  return null;
+}
+
 // src/tools/get.ts
 function getObservations(db, input) {
   if (input.ids.length === 0) {
@@ -16461,8 +16691,8 @@ function getRecentChat(db, input) {
     const messages2 = db.getSessionChatMessages(input.session_id, limit).slice(-limit).reverse();
     return {
       messages: messages2,
-      session_count: countDistinctSessions(messages2),
-      source_summary: summarizeChatSources(messages2),
+      session_count: countDistinctSessions2(messages2),
+      source_summary: summarizeChatSources2(messages2),
       transcript_backed: messages2.some((message) => message.source_kind === "transcript")
     };
   }
@@ -16479,40 +16709,6 @@ function getRecentChat(db, input) {
     }
   }
   const messages = db.getRecentChatMessages(projectId, limit, input.user_id);
-  return {
-    messages,
-    project: projectName,
-    session_count: countDistinctSessions(messages),
-    source_summary: summarizeChatSources(messages),
-    transcript_backed: messages.some((message) => message.source_kind === "transcript")
-  };
-}
-function summarizeChatSources(messages) {
-  return messages.reduce((summary, message) => {
-    summary[message.source_kind] += 1;
-    return summary;
-  }, { transcript: 0, hook: 0 });
-}
-function countDistinctSessions(messages) {
-  return new Set(messages.map((message) => message.session_id)).size;
-}
-
-// src/tools/search-chat.ts
-function searchChat(db, input) {
-  const limit = Math.max(1, Math.min(input.limit ?? 20, 100));
-  const projectScoped = input.project_scoped !== false;
-  let projectId = null;
-  let projectName;
-  if (projectScoped) {
-    const cwd = input.cwd ?? process.cwd();
-    const detected = detectProject(cwd);
-    const project = db.getProjectByCanonicalId(detected.canonical_id);
-    if (project) {
-      projectId = project.id;
-      projectName = project.name;
-    }
-  }
-  const messages = db.searchChatMessages(input.query, projectId, limit, input.user_id);
   return {
     messages,
     project: projectName,
@@ -16552,6 +16748,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources3(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -16649,6 +16847,12 @@ function collectProvenanceSummary(observations) {
   }
   return Array.from(counts.entries()).map(([tool, count]) => ({ tool, count })).sort((a, b) => b.count - a.count || a.tool.localeCompare(b.tool)).slice(0, 6);
 }
+function summarizeChatSources3(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function createHandoff(db, config2, input) {
@@ -17995,16 +18199,17 @@ function getProjectMemoryIndex(db, input) {
   }).handoffs;
   const rollingHandoffDraftsCount = recentHandoffsCount.filter((handoff) => isDraftHandoff(handoff)).length;
   const savedHandoffsCount = recentHandoffsCount.length - rollingHandoffDraftsCount;
-  const recentChatCount = getRecentChat(db, {
+  const recentChat = getRecentChat(db, {
     cwd,
     project_scoped: true,
     user_id: input.user_id,
     limit: 20
-  }).messages.length;
+  });
+  const recentChatCount = recentChat.messages.length;
   const recentOutcomes = observations.filter((obs) => ["bugfix", "feature", "refactor", "change", "decision"].includes(obs.type)).map((obs) => obs.title.trim()).filter((title) => title.length > 0 && !looksLikeFileOperationTitle3(title)).slice(0, 8);
   const captureSummary = summarizeCaptureState(recentSessions);
   const topTypes = Object.entries(counts).map(([type, count]) => ({ type, count })).sort((a, b) => b.count - a.count || a.type.localeCompare(b.type)).slice(0, 5);
-  const suggestedTools = buildSuggestedTools(recentSessions, recentRequestsCount, recentToolsCount, observations.length);
+  const suggestedTools = buildSuggestedTools(recentSessions, recentRequestsCount, recentToolsCount, observations.length, recentChatCount, recentChat.transcript_backed);
   const estimatedReadTokens = estimateTokens([
     recentOutcomes.join(`
 `),
@@ -18029,6 +18234,9 @@ function getProjectMemoryIndex(db, input) {
     rolling_handoff_drafts_count: rollingHandoffDraftsCount,
     saved_handoffs_count: savedHandoffsCount,
     recent_chat_count: recentChatCount,
+    recent_chat_sessions: recentChat.session_count,
+    chat_source_summary: recentChat.source_summary,
+    chat_coverage_state: recentChat.transcript_backed ? "transcript-backed" : recentChatCount > 0 ? "hook-only" : "none",
     raw_capture_active: recentRequestsCount > 0 || recentToolsCount > 0,
     capture_summary: captureSummary,
     hot_files: hotFiles,
@@ -18101,7 +18309,7 @@ function summarizeCaptureState(sessions) {
   }
   return summary;
 }
-function buildSuggestedTools(sessions, requestCount, toolCount, observationCount) {
+function buildSuggestedTools(sessions, requestCount, toolCount, observationCount, recentChatCount, transcriptBackedChat) {
   const suggested = [];
   if (sessions.length > 0) {
     suggested.push("recent_sessions");
@@ -18109,13 +18317,21 @@ function buildSuggestedTools(sessions, requestCount, toolCount, observationCount
   if (requestCount > 0 || toolCount > 0) {
     suggested.push("activity_feed");
   }
+  if (requestCount > 0 || recentChatCount > 0 || observationCount > 0) {
+    suggested.push("search_recall");
+  }
   if (observationCount > 0) {
     suggested.push("tool_memory_index", "capture_git_worktree");
   }
   if (sessions.length > 0) {
     suggested.push("create_handoff", "recent_handoffs");
   }
-  suggested.push("recent_chat");
+  if (recentChatCount > 0 && !transcriptBackedChat) {
+    suggested.push("refresh_chat_recall");
+  }
+  if (recentChatCount > 0) {
+    suggested.push("recent_chat", "search_chat");
+  }
   return Array.from(new Set(suggested)).slice(0, 4);
 }
 
@@ -18162,12 +18378,12 @@ function getMemoryConsole(db, input) {
     project_scoped: projectScoped,
     user_id: input.user_id,
     limit: 6
-  }).messages;
+  });
   const projectIndex = projectScoped ? getProjectMemoryIndex(db, {
     cwd,
     user_id: input.user_id
   }) : null;
-  const continuityState = projectIndex?.continuity_state ?? classifyContinuityState(requests.length, tools.length, recentHandoffs.length, recentChat.length, sessions, (projectIndex?.recent_outcomes ?? []).length);
+  const continuityState = projectIndex?.continuity_state ?? classifyContinuityState(requests.length, tools.length, recentHandoffs.length, recentChat.messages.length, sessions, (projectIndex?.recent_outcomes ?? []).length);
   return {
     project: project?.name,
     capture_mode: requests.length > 0 || tools.length > 0 ? "rich" : "observations-only",
@@ -18179,7 +18395,10 @@ function getMemoryConsole(db, input) {
     recent_handoffs: recentHandoffs,
     rolling_handoff_drafts: rollingHandoffDrafts,
     saved_handoffs: savedHandoffs,
-    recent_chat: recentChat,
+    recent_chat: recentChat.messages,
+    recent_chat_sessions: projectIndex?.recent_chat_sessions ?? recentChat.session_count,
+    chat_source_summary: projectIndex?.chat_source_summary ?? recentChat.source_summary,
+    chat_coverage_state: projectIndex?.chat_coverage_state ?? (recentChat.transcript_backed ? "transcript-backed" : recentChat.messages.length > 0 ? "hook-only" : "none"),
     observations,
     capture_summary: projectIndex?.capture_summary,
     recent_outcomes: projectIndex?.recent_outcomes ?? [],
@@ -18189,23 +18408,27 @@ function getMemoryConsole(db, input) {
     assistant_checkpoint_types: projectIndex?.assistant_checkpoint_types ?? [],
     top_types: projectIndex?.top_types ?? [],
     estimated_read_tokens: projectIndex?.estimated_read_tokens,
-    suggested_tools: projectIndex?.suggested_tools ?? buildFallbackSuggestedTools(sessions.length, requests.length, tools.length, observations.length, recentHandoffs.length, recentChat.length)
+    suggested_tools: projectIndex?.suggested_tools ?? buildFallbackSuggestedTools(sessions.length, requests.length, tools.length, observations.length, recentHandoffs.length, recentChat.messages.length, recentChat.transcript_backed)
   };
 }
-function buildFallbackSuggestedTools(sessionCount, requestCount, toolCount, observationCount, handoffCount, chatCount) {
+function buildFallbackSuggestedTools(sessionCount, requestCount, toolCount, observationCount, handoffCount, chatCount, transcriptBackedChat) {
   const suggested = [];
   if (sessionCount > 0)
     suggested.push("recent_sessions");
   if (requestCount > 0 || toolCount > 0)
     suggested.push("activity_feed");
+  if (requestCount > 0 || chatCount > 0 || observationCount > 0)
+    suggested.push("search_recall");
   if (observationCount > 0)
     suggested.push("tool_memory_index", "capture_git_worktree");
   if (sessionCount > 0)
     suggested.push("create_handoff", "recent_handoffs");
   if (handoffCount > 0)
     suggested.push("load_handoff");
+  if (chatCount > 0 && !transcriptBackedChat)
+    suggested.push("refresh_chat_recall");
   if (chatCount > 0)
-    suggested.push("recent_chat");
+    suggested.push("recent_chat", "search_chat");
   return Array.from(new Set(suggested)).slice(0, 4);
 }
 
@@ -18428,7 +18651,7 @@ function toChatEvent(message) {
     created_at_epoch: message.created_at_epoch,
     session_id: message.session_id,
     id: message.id,
-    title: message.role === "user" ? "user" : "assistant",
+    title: `${message.role} [${message.source_kind}]`,
     detail: content.slice(0, 220)
   };
 }
@@ -19007,12 +19230,13 @@ function getSessionContext(db, input) {
   const rollingHandoffDrafts = (context.recentHandoffs ?? []).filter((handoff) => handoff.title.startsWith("Handoff Draft:")).length;
   const savedHandoffs = recentHandoffs - rollingHandoffDrafts;
   const latestHandoffTitle = context.recentHandoffs?.[0]?.title ?? null;
-  const recentChatMessages = getRecentChat(db, {
+  const recentChat = getRecentChat(db, {
     cwd,
     project_scoped: true,
     user_id: input.user_id,
     limit: 8
-  }).messages.length;
+  });
+  const recentChatMessages = recentChat.messages.length;
   const captureState = recentRequests > 0 && recentTools > 0 ? "rich" : recentRequests > 0 || recentTools > 0 ? "partial" : "summary-only";
   const hotFiles = buildHotFiles(context);
   const continuityState = classifyContinuityState(recentRequests, recentTools, recentHandoffs, recentChatMessages, context.recentSessions ?? [], (context.recentOutcomes ?? []).length);
@@ -19031,12 +19255,15 @@ function getSessionContext(db, input) {
     saved_handoffs: savedHandoffs,
     latest_handoff_title: latestHandoffTitle,
     recent_chat_messages: recentChatMessages,
+    recent_chat_sessions: recentChat.session_count,
+    chat_source_summary: recentChat.source_summary,
+    chat_coverage_state: recentChat.transcript_backed ? "transcript-backed" : recentChatMessages > 0 ? "hook-only" : "none",
     recent_outcomes: context.recentOutcomes ?? [],
     hot_files: hotFiles,
     capture_state: captureState,
     raw_capture_active: recentRequests > 0 || recentTools > 0,
     estimated_read_tokens: estimateTokens(preview),
-    suggested_tools: buildSuggestedTools2(context),
+    suggested_tools: buildSuggestedTools2(context, recentChat.transcript_backed),
     preview
   };
 }
@@ -19059,7 +19286,7 @@ function parseJsonArray3(value) {
     return [];
   }
 }
-function buildSuggestedTools2(context) {
+function buildSuggestedTools2(context, transcriptBackedChat) {
   const tools = [];
   if ((context.recentSessions?.length ?? 0) > 0) {
     tools.push("recent_sessions");
@@ -19067,6 +19294,9 @@ function buildSuggestedTools2(context) {
   if ((context.recentPrompts?.length ?? 0) > 0 || (context.recentToolEvents?.length ?? 0) > 0) {
     tools.push("activity_feed");
   }
+  if ((context.recentPrompts?.length ?? 0) > 0 || (context.recentChatMessages?.length ?? 0) > 0 || context.observations.length > 0) {
+    tools.push("search_recall");
+  }
   if (context.observations.length > 0) {
     tools.push("tool_memory_index", "capture_git_worktree");
   }
@@ -19076,7 +19306,12 @@ function buildSuggestedTools2(context) {
   if ((context.recentHandoffs?.length ?? 0) > 0) {
     tools.push("load_handoff");
   }
-  tools.push("recent_chat", "search_chat", "refresh_chat_recall");
+  if ((context.recentChatMessages?.length ?? 0) > 0 && !transcriptBackedChat) {
+    tools.push("refresh_chat_recall");
+  }
+  if ((context.recentChatMessages?.length ?? 0) > 0) {
+    tools.push("recent_chat", "search_chat");
+  }
   return Array.from(new Set(tools)).slice(0, 4);
 }
 
@@ -21047,7 +21282,7 @@ function readTranscript(sessionId, cwd, transcriptPath) {
   }
   return messages;
 }
-function syncTranscriptChat(db, config2, sessionId, cwd, transcriptPath) {
+async function syncTranscriptChat(db, config2, sessionId, cwd, transcriptPath) {
   const messages = readTranscript(sessionId, cwd, transcriptPath).map((message) => ({
     ...message,
     text: message.text.trim()
@@ -21077,6 +21312,12 @@ function syncTranscriptChat(db, config2, sessionId, cwd, transcriptPath) {
       transcript_index: transcriptIndex
     });
     db.addToOutbox("chat_message", row.id);
+    if (db.vecAvailable) {
+      const embedding = await embedText(composeChatEmbeddingText(message.text));
+      if (embedding) {
+        db.vecChatInsert(row.id, embedding);
+      }
+    }
     imported++;
   }
   return { imported, total: messages.length };
@@ -21152,7 +21393,7 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.26"
+  version: "0.4.28"
 });
 server.tool("save_observation", "Save an observation to memory", {
   type: exports_external.enum([
@@ -21545,6 +21786,58 @@ ${previews.join(`
     ]
   };
 });
+server.tool("search_recall", "Search live recall across durable memory and chat together. Best for questions like 'what were we just talking about?'", {
+  query: exports_external.string().describe("Recall query"),
+  project_scoped: exports_external.boolean().optional().describe("Scope to project (default: true)"),
+  limit: exports_external.number().optional().describe("Max results (default: 10)"),
+  cwd: exports_external.string().optional().describe("Optional cwd override for project-scoped recall"),
+  user_id: exports_external.string().optional().describe("Optional user override")
+}, async (params) => {
+  const result = await searchRecall(db, {
+    query: params.query,
+    project_scoped: params.project_scoped,
+    limit: params.limit,
+    cwd: params.cwd,
+    user_id: params.user_id ?? config2.user_id
+  });
+  if (result.results.length === 0) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: result.project ? `No recall found for "${params.query}" in project ${result.project}` : `No recall found for "${params.query}"`
+        }
+      ]
+    };
+  }
+  const projectLine = result.project ? `Project: ${result.project}
+` : "";
+  const summaryLine = `Matches: ${result.results.length} · memory ${result.totals.memory} · chat ${result.totals.chat}
+`;
+  const rows = result.results.map((item) => {
+    const sourceBits = [item.kind];
+    if (item.type)
+      sourceBits.push(item.type);
+    if (item.role)
+      sourceBits.push(item.role);
+    if (item.source_kind)
+      sourceBits.push(item.source_kind);
+    const idBit = item.observation_id ? `#${item.observation_id}` : item.id ? `chat:${item.id}` : "";
+    const title = `${idBit ? `${idBit} ` : ""}${item.title}${item.project_name ? ` (${item.project_name})` : ""}`;
+    return `- [${sourceBits.join(" · ")}] ${title}
+  ${item.detail.slice(0, 220)}`;
+  }).join(`
+`);
+  return {
+    content: [
+      {
+        type: "text",
+        text: `${projectLine}${summaryLine}Recall search for "${params.query}":
+${rows}`
+      }
+    ]
+  };
+});
 server.tool("get_observations", "Get observations by ID", {
   ids: exports_external.array(exports_external.number()).describe("Observation IDs")
 }, async (params) => {
@@ -21865,6 +22158,7 @@ server.tool("memory_console", "Show a high-signal local overview of what Engrm c
       {
         type: "text",
         text: `${projectLine}` + `${captureLine}` + `Continuity: ${result.continuity_state} — ${result.continuity_summary}
+` + `Chat recall: ${result.chat_coverage_state} · ${result.recent_chat.length} messages across ${result.recent_chat_sessions} sessions (transcript ${result.chat_source_summary.transcript}, hook ${result.chat_source_summary.hook})
 ` + `${typeof result.assistant_checkpoint_count === "number" ? `Assistant checkpoints: ${result.assistant_checkpoint_count}
 ` : ""}` + `Handoffs: ${result.saved_handoffs} saved, ${result.rolling_handoff_drafts} rolling drafts
 ` + `${typeof result.estimated_read_tokens === "number" ? `Estimated read cost: ~${result.estimated_read_tokens}t
@@ -22071,6 +22365,7 @@ server.tool("session_context", "Preview the exact project memory context Engrm w
 ` + `Recent handoffs: ${result.recent_handoffs}
 ` + `Handoff split: ${result.saved_handoffs} saved, ${result.rolling_handoff_drafts} rolling drafts
 ` + `Recent chat messages: ${result.recent_chat_messages}
+` + `Chat recall: ${result.chat_coverage_state} · ${result.recent_chat_sessions} sessions (transcript ${result.chat_source_summary.transcript}, hook ${result.chat_source_summary.hook})
 ` + `Latest handoff: ${result.latest_handoff_title ?? "(none)"}
 ` + `Raw chronology active: ${result.raw_capture_active ? "yes" : "no"}
 
@@ -22150,6 +22445,7 @@ server.tool("project_memory_index", "Show a typed local memory index for the cur
 ` + `Recent handoffs captured: ${result.recent_handoffs_count}
 ` + `Handoff split: ${result.saved_handoffs_count} saved, ${result.rolling_handoff_drafts_count} rolling drafts
 ` + `Recent chat messages captured: ${result.recent_chat_count}
+` + `Chat recall: ${result.chat_coverage_state} · ${result.recent_chat_sessions} sessions (transcript ${result.chat_source_summary.transcript}, hook ${result.chat_source_summary.hook})
 
 ` + `Raw chronology: ${result.raw_capture_active ? "active" : "observations-only so far"}
 
@@ -22321,7 +22617,7 @@ server.tool("refresh_chat_recall", "Hydrate the separate chat lane from the curr
       content: [{ type: "text", text: "No session available to hydrate chat recall from." }]
     };
   }
-  const result = syncTranscriptChat(db, config2, sessionId, cwd, params.transcript_path);
+  const result = await syncTranscriptChat(db, config2, sessionId, cwd, params.transcript_path);
   return {
     content: [
       {
@@ -22437,10 +22733,10 @@ server.tool("search_chat", "Search the separate chat lane without mixing it into
   cwd: exports_external.string().optional(),
   user_id: exports_external.string().optional()
 }, async (params) => {
-  const result = searchChat(db, params);
+  const result = await searchChat(db, params);
   const projectLine = result.project ? `Project: ${result.project}
 ` : "";
-  const coverageLine = `Coverage: ${result.messages.length} matches across ${result.session_count} session${result.session_count === 1 ? "" : "s"} ` + `· transcript ${result.source_summary.transcript} · hook ${result.source_summary.hook}
+  const coverageLine = `Coverage: ${result.messages.length} matches across ${result.session_count} session${result.session_count === 1 ? "" : "s"} ` + `· transcript ${result.source_summary.transcript} · hook ${result.source_summary.hook}` + `${result.semantic_backed ? " · semantic yes" : ""}
 ` + `${result.transcript_backed ? "" : `Hint: run refresh_chat_recall if this looks under-captured.
 `}`;
   const rows = result.messages.length > 0 ? result.messages.map((msg) => {
@@ -22554,7 +22850,7 @@ server.tool("session_story", "Show the full local memory story for one session",
 `) : "(none)";
   const promptLines = result.prompts.length > 0 ? result.prompts.map((prompt) => `- #${prompt.prompt_number} ${prompt.prompt.replace(/\s+/g, " ").trim()}`).join(`
 `) : "- (none)";
-  const chatLines = result.chat_messages.length > 0 ? result.chat_messages.slice(-12).map((msg) => `- [${msg.role}] ${msg.content.replace(/\s+/g, " ").trim().slice(0, 200)}`).join(`
+  const chatLines = result.chat_messages.length > 0 ? result.chat_messages.slice(-12).map((msg) => `- [${msg.role}] [${msg.source_kind}] ${msg.content.replace(/\s+/g, " ").trim().slice(0, 200)}`).join(`
 `) : "- (none)";
   const toolLines = result.tool_events.length > 0 ? result.tool_events.slice(-15).map((tool) => {
     const detail = tool.file_path ?? tool.command ?? tool.tool_response_preview ?? "";
@@ -22596,6 +22892,8 @@ ${summaryLines}
 ` + `Prompts:
 ${promptLines}
 
+` + `Chat recall: ${result.chat_coverage_state} (transcript ${result.chat_source_summary.transcript}, hook ${result.chat_source_summary.hook})
+
 ` + `Chat:
 ${chatLines}