engrm 0.4.26 → 0.4.27

package/README.md

@@ -228,6 +228,7 @@ The MCP server exposes tools that supported agents can call directly:
 | `refresh_chat_recall` | Rehydrate the separate chat lane from a Claude transcript when a long session feels under-captured |
 | `recent_chat` | Inspect the separate synced chat lane without mixing it into durable memory |
 | `search_chat` | Search recent chat recall separately from reusable memory observations |
+| `search_recall` | Search durable memory and chat recall together when you do not want to guess the right lane |
 | `plugin_catalog` | Inspect Engrm plugin manifests for memory-aware integrations |
 | `save_plugin_memory` | Save reduced plugin output with stable Engrm provenance |
 | `capture_git_diff` | Reduce a git diff into a durable memory object and save it |
@@ -359,6 +360,8 @@ What each tool is good for:
 - `capture_status` tells you whether prompt/tool hooks are live on this machine
 - `capture_quality` shows whether chat recall is transcript-backed or still hook-only across the workspace
 - `memory_console` gives the quickest project snapshot, including whether continuity is `fresh`, `thin`, or `cold`
+- `memory_console`, `project_memory_index`, and `session_context` now also show whether project chat recall is transcript-backed or only hook-captured
+- when chat continuity is only hook-captured, the workbench and startup hints now prefer `refresh_chat_recall`
 - `activity_feed` shows the merged chronology across prompts, tools, chat, handoffs, observations, and summaries
 - `recent_sessions` helps you pick a session worth opening
 - `session_story` reconstructs one session in detail, including handoffs and chat recall

package/dist/hooks/post-tool-use.js

@@ -3831,6 +3831,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -3928,6 +3930,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 summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function upsertRollingHandoff(db, config, input) {

package/dist/hooks/pre-compact.js

@@ -2154,6 +2154,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -2251,6 +2253,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 summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";

package/dist/hooks/session-start.js

@@ -494,6 +494,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -591,6 +593,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 summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";
@@ -3049,7 +3057,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
 var STATE_PATH = join3(homedir(), ".engrm", "config-fingerprint.json");
-var CLIENT_VERSION = "0.4.26";
+var CLIENT_VERSION = "0.4.27";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -5671,10 +5679,12 @@ function formatInspectHints(context, visibleObservationIds = []) {
   if ((context.recentChatMessages?.length ?? 0) > 0) {
     hints.push("recent_chat");
   }
+  if (hasHookOnlyRecentChat(context)) {
+    hints.push("refresh_chat_recall");
+  }
   if (continuityState !== "fresh") {
     hints.push("recent_chat");
     hints.push("recent_handoffs");
-    hints.push("refresh_chat_recall");
   }
   const unique = Array.from(new Set(hints)).slice(0, 4);
   if (unique.length === 0)
@@ -6144,6 +6154,10 @@ function hasFreshContinuitySignal(context) {
 function getStartupContinuityState(context) {
   return classifyContinuityState(context.recentPrompts?.length ?? 0, context.recentToolEvents?.length ?? 0, context.recentHandoffs?.length ?? 0, context.recentChatMessages?.length ?? 0, context.recentSessions ?? [], context.recentOutcomes?.length ?? 0);
 }
+function hasHookOnlyRecentChat(context) {
+  const recentChat = context.recentChatMessages ?? [];
+  return recentChat.length > 0 && !recentChat.some((message) => message.source_kind === "transcript");
+}
 function observationAgeDays3(obs) {
   const createdAt = new Date(obs.created_at).getTime();
   if (!Number.isFinite(createdAt))

package/dist/hooks/stop.js

@@ -3009,7 +3009,7 @@ function buildBeacon(db, config, sessionId, metrics) {
     sentinel_used: valueSignals.security_findings_count > 0,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.26",
+    client_version: "0.4.27",
     context_observations_injected: metrics?.contextObsInjected ?? 0,
     context_total_available: metrics?.contextTotalAvailable ?? 0,
     recall_attempts: metrics?.recallAttempts ?? 0,
@@ -4040,6 +4040,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -4137,6 +4139,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 summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function upsertRollingHandoff(db, config, input) {

package/dist/hooks/user-prompt-submit.js

@@ -2924,6 +2924,8 @@ function getSessionStory(db, input) {
     summary,
     prompts,
     chat_messages: chatMessages,
+    chat_source_summary: summarizeChatSources(chatMessages),
+    chat_coverage_state: chatMessages.some((message) => message.source_kind === "transcript") ? "transcript-backed" : chatMessages.length > 0 ? "hook-only" : "none",
     tool_events: toolEvents,
     observations,
     handoffs,
@@ -3021,6 +3023,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 summarizeChatSources(messages) {
+  return messages.reduce((summary, message) => {
+    summary[message.source_kind] += 1;
+    return summary;
+  }, { transcript: 0, hook: 0 });
+}
 
 // src/tools/handoffs.ts
 async function upsertRollingHandoff(db, config, input) {

package/dist/server.js

@@ -16321,6 +16321,139 @@ function sanitizeFtsQuery(query) {
   return safe;
 }
 
+// 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,
+    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-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),
+    Promise.resolve(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 +16594,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 +16612,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 +16651,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 +16750,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 +18102,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 +18137,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 +18212,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");
@@ -18115,7 +18226,12 @@ function buildSuggestedTools(sessions, requestCount, toolCount, observationCount
   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 +18278,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 +18295,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,10 +18308,10 @@ 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");
@@ -18204,8 +18323,10 @@ function buildFallbackSuggestedTools(sessionCount, requestCount, toolCount, obse
     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 +18549,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 +19128,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 +19153,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 +19184,7 @@ function parseJsonArray3(value) {
     return [];
   }
 }
-function buildSuggestedTools2(context) {
+function buildSuggestedTools2(context, transcriptBackedChat) {
   const tools = [];
   if ((context.recentSessions?.length ?? 0) > 0) {
     tools.push("recent_sessions");
@@ -19076,7 +19201,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);
 }
 
@@ -21152,7 +21282,7 @@ process.on("SIGTERM", () => {
 });
 var server = new McpServer({
   name: "engrm",
-  version: "0.4.26"
+  version: "0.4.27"
 });
 server.tool("save_observation", "Save an observation to memory", {
   type: exports_external.enum([
@@ -21545,6 +21675,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 +22047,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 +22254,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 +22334,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"}
 
@@ -22554,7 +22739,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 +22781,8 @@ ${summaryLines}
 ` + `Prompts:
 ${promptLines}
 
+` + `Chat recall: ${result.chat_coverage_state} (transcript ${result.chat_source_summary.transcript}, hook ${result.chat_source_summary.hook})
+
 ` + `Chat:
 ${chatLines}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.4.26",
+  "version": "0.4.27",
   "description": "Shared memory across devices, sessions, and coding agents",
   "mcpName": "io.github.dr12hes/engrm",
   "type": "module",