@remnic/core 9.69.86 → 9.69.87

package/dist/verified-recall.js

@@ -1,9 +1,9 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-TIQZNDZ5.js";
+} from "./chunk-JKMHZF3Q.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-S55WTPFJ.js";
+import "./chunk-FRCESVV6.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
@@ -22,12 +22,12 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-MRPOZBJC.js";
-import "./chunk-DM2T26WE.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
-import "./chunk-J3IWHCMF.js";
+import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
 import "./chunk-3ONXXHQO.js";
@@ -51,7 +51,7 @@ import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-ZTHGFTMW.js";
+import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
@@ -81,7 +81,7 @@ import "./chunk-AW4QUFQF.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
 import "./chunk-PWF4JXKD.js";
-import "./chunk-RGMVMVMF.js";
+import "./chunk-YBA52OKG.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";

package/dist/who-knows-cli.js

@@ -4,9 +4,9 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-RIEX7NOZ.js";
-import "./chunk-IMAP236M.js";
-import "./chunk-S55WTPFJ.js";
+} from "./chunk-W4AOR52H.js";
+import "./chunk-CS52MFDV.js";
+import "./chunk-FRCESVV6.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
@@ -25,12 +25,12 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-MRPOZBJC.js";
-import "./chunk-DM2T26WE.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
-import "./chunk-J3IWHCMF.js";
+import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
 import "./chunk-3ONXXHQO.js";
@@ -54,7 +54,7 @@ import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-ZTHGFTMW.js";
+import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
@@ -84,7 +84,7 @@ import "./chunk-AW4QUFQF.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
 import "./chunk-PWF4JXKD.js";
-import "./chunk-RGMVMVMF.js";
+import "./chunk-YBA52OKG.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";

package/dist/who-knows.js

@@ -9,8 +9,8 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-IMAP236M.js";
-import "./chunk-S55WTPFJ.js";
+} from "./chunk-CS52MFDV.js";
+import "./chunk-FRCESVV6.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
@@ -29,12 +29,12 @@ import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-MRPOZBJC.js";
-import "./chunk-DM2T26WE.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-LDXUBPMO.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-FF6N7BXC.js";
-import "./chunk-J3IWHCMF.js";
+import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
 import "./chunk-3ONXXHQO.js";
@@ -58,7 +58,7 @@ import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
-import "./chunk-ZTHGFTMW.js";
+import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
@@ -88,7 +88,7 @@ import "./chunk-AW4QUFQF.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
 import "./chunk-PWF4JXKD.js";
-import "./chunk-RGMVMVMF.js";
+import "./chunk-YBA52OKG.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.86",
+  "version": "9.69.87",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3317,7 +3317,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.69.86"
+    "@remnic/coding-graph": "^9.69.87"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-extraction-force-flush.ts

@@ -34,6 +34,14 @@ export async function extractionForceFlush(
   if (request.deadlineMs !== undefined && (!Number.isFinite(request.deadlineMs) || request.deadlineMs < 0)) {
     throw new EngramAccessInputError("deadlineMs must be a finite non-negative number");
   }
+  // `deadlineMs` is a BUDGET from now, not an absolute epoch (issue #3140):
+  // callers passing a natural relative value (e.g. 30000) were instantly
+  // rejected with `replay extraction deadline exceeded (scope_resolution)`
+  // because the raw duration was compared against Date.now(). Convert once
+  // here; every phase below and the orchestrator flush keep absolute deadlines.
+  const deadlineAt = typeof request.deadlineMs === "number"
+    ? (request.deadlineMs > 1e11 ? request.deadlineMs : Date.now() + request.deadlineMs)
+    : undefined;
 
   const authenticatedPrincipal = request.authenticatedPrincipal?.trim();
   throwIfAborted(request.abortSignal, "extraction force-flush aborted");
@@ -87,7 +95,7 @@ export async function extractionForceFlush(
         () => deps.resolveMemoryScopePlan(request),
         {
           abortSignal: request.abortSignal,
-          extractionDeadlineMs: request.deadlineMs,
+          extractionDeadlineMs: deadlineAt,
           reason: "access_force_flush",
           deadlineStage: "scope_resolution",
           onDeadline: cancelBeforeScopeResolution,
@@ -107,7 +115,7 @@ export async function extractionForceFlush(
     };
     if (request.abortSignal?.aborted) cancelScopedPendingObserveExtractions();
     throwIfAborted(request.abortSignal, "extraction force-flush aborted");
-    if (typeof request.deadlineMs === "number" && request.deadlineMs <= Date.now()) {
+    if (deadlineAt !== undefined && deadlineAt <= Date.now()) {
       cancelScopedPendingObserveExtractions();
       throw new EngramAccessInputError("extraction force-flush deadline exceeded before buffer drain");
     }
@@ -119,7 +127,7 @@ export async function extractionForceFlush(
           reason: "access_force_flush",
           abortSignal: request.abortSignal,
           failOnExtractionFailure: true,
-          extractionDeadlineMs: request.deadlineMs,
+          extractionDeadlineMs: deadlineAt,
           writeNamespaceOverride: scope.writeNamespace,
           principalOverride:
             typeof scope.principal === "string" && scope.principal.length > 0 ? scope.principal : undefined,
@@ -128,7 +136,7 @@ export async function extractionForceFlush(
         }),
       {
         abortSignal: request.abortSignal,
-        extractionDeadlineMs: request.deadlineMs,
+        extractionDeadlineMs: deadlineAt,
         reason: "access_force_flush",
         deadlineStage: "buffer_drain",
         onDeadline: cancelScopedPendingObserveExtractions,
@@ -154,7 +162,7 @@ export async function extractionForceFlush(
           ),
         {
           abortSignal: request.abortSignal,
-          extractionDeadlineMs: request.deadlineMs,
+          extractionDeadlineMs: deadlineAt,
           reason: "access_force_flush",
           deadlineStage: "pending_observe_extraction",
           onDeadline: () => {
@@ -172,11 +180,11 @@ export async function extractionForceFlush(
           () =>
             buffer.clearRetainedTurnsForSession(request.sessionKey, namespacesEnabled ? scope.principal : undefined, {
               abortSignal: request.abortSignal,
-              deadlineMs: request.deadlineMs,
+              deadlineMs: deadlineAt,
             }),
           {
             abortSignal: request.abortSignal,
-            extractionDeadlineMs: request.deadlineMs,
+            extractionDeadlineMs: deadlineAt,
             reason: "access_force_flush",
             deadlineStage: "retained_turn_cleanup",
           }

package/src/access-mcp.ts

@@ -1,7 +1,8 @@
 import { sharedContextMcpTools } from "./access-mcp-shared-context-tools.js";
 import { randomUUID } from "node:crypto";
 import {
-  MCP_ADMIN_OPS_MIGRATED_OPERATIONS, MCP_ADMIN_OPS_TOOLS,
+  MCP_ADMIN_OPS_MIGRATED_OPERATIONS,
+  MCP_ADMIN_OPS_TOOLS,
   MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED,
 } from "./access-mcp-admin-tools.js";
 import { readFile } from "node:fs/promises";
@@ -10,7 +11,12 @@ import type { Readable, Writable } from "node:stream";
 // (memory_get / memory_search / memory_store) as a side effect; callTool
 // dispatches migrated tools through the registry (issue #1525).
 import { type OperationName, getOperation } from "./access-boundary.js";
-import { assertOperationAllowed, capabilityAllowsOp, enforceNamespaceAllowList, tokenCapabilityStore } from "./access-token-capabilities.js";
+import {
+  assertOperationAllowed,
+  capabilityAllowsOp,
+  enforceNamespaceAllowList,
+  tokenCapabilityStore,
+} from "./access-token-capabilities.js";
 import {
   type ActionConfidenceRequest,
   type CapsuleExportRequest,
@@ -53,9 +59,14 @@ import {
   withToolAliases,
 } from "./access-mcp-tool-names.js";
 import { MCP_READ_ONLY_TOOL_SUFFIXES } from "./mcp-read-only-tools.js";
-import { MEETINGS_MCP_TOOLS } from "./meetings/mcp-tools.js"; import { DEEP_RECALL_MCP_TOOLS } from "./deep-recall-mcp-tools.js"; import { RECALL_NAVIGATION_MCP_TOOLS } from "./recall-navigation-mcp-tools.js"; import { MEMORY_BROWSE_MCP_TOOLS } from "./memory-browse-mcp-tools.js";
+import { MEETINGS_MCP_TOOLS } from "./meetings/mcp-tools.js";
+import { DEEP_RECALL_MCP_TOOLS } from "./deep-recall-mcp-tools.js";
+import { RECALL_NAVIGATION_MCP_TOOLS } from "./recall-navigation-mcp-tools.js";
+import { MEMORY_BROWSE_MCP_TOOLS } from "./memory-browse-mcp-tools.js";
 import { WEARABLES_MCP_TOOLS } from "./wearables/mcp-tools.js";
-import { WHO_KNOWS_MCP_TOOLS } from "./who-knows.js"; import { LOCATION_MCP_TOOLS } from "./location/mcp-tools.js"; import { STANDUP_MCP_TOOLS } from "./standup/mcp-tools.js";
+import { WHO_KNOWS_MCP_TOOLS } from "./who-knows.js";
+import { LOCATION_MCP_TOOLS } from "./location/mcp-tools.js";
+import { STANDUP_MCP_TOOLS } from "./standup/mcp-tools.js";
 import { RECALL_WHY_MCP_TOOLS } from "./access-recall-diagnostics.js";
 import { PROMOTION_CANDIDATES_MCP_TOOLS } from "./memory-subject.js";
 import { EXTERNAL_WIKI_MCP_TOOLS } from "./external-wiki-mcp-tools.js";
@@ -170,13 +181,26 @@ export const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> =
   // Fully migrated through the strict-schema boundary (#1668).
   "engram.recall": "recall",
   "engram.recall_explain": "recall_explain",
-  "engram.set_coding_context": "set_coding_context", "engram.recall_tier_explain": "recall_tier_explain",
-  "engram.recall_xray": "recall_xray", "engram.recall_why": "recall_why", "engram.who_knows": "who_knows", "engram.promotion_candidates": "promotion_candidates",
-  "engram.wearables_status": "wearables_status", "engram.wearables_sync": "wearables_sync",
-  "engram.location_status": "location_status", "engram.location_check": "location_check", "engram.location_sync": "location_sync",
-  "engram.location_backfill": "location_backfill", "engram.location_day": "location_day",
-  "engram.transcript_day": "transcript_day", "engram.transcript_search": "transcript_search",
-  "engram.transcript_memories": "transcript_memories", "engram.meetings_list": "meetings_list", "engram.meetings_get": "meetings_get", "engram.meetings_build": "meetings_build", "engram.standup": "standup",
+  "engram.set_coding_context": "set_coding_context",
+  "engram.recall_tier_explain": "recall_tier_explain",
+  "engram.recall_xray": "recall_xray",
+  "engram.recall_why": "recall_why",
+  "engram.who_knows": "who_knows",
+  "engram.promotion_candidates": "promotion_candidates",
+  "engram.wearables_status": "wearables_status",
+  "engram.wearables_sync": "wearables_sync",
+  "engram.location_status": "location_status",
+  "engram.location_check": "location_check",
+  "engram.location_sync": "location_sync",
+  "engram.location_backfill": "location_backfill",
+  "engram.location_day": "location_day",
+  "engram.transcript_day": "transcript_day",
+  "engram.transcript_search": "transcript_search",
+  "engram.transcript_memories": "transcript_memories",
+  "engram.meetings_list": "meetings_list",
+  "engram.meetings_get": "meetings_get",
+  "engram.meetings_build": "meetings_build",
+  "engram.standup": "standup",
   "engram.action_confidence": "action_confidence",
   "engram.chatgpt_memory_inspector": "chatgpt_memory_inspector",
   "engram.day_summary": "day_summary",
@@ -187,7 +211,8 @@ export const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> =
   "engram.entity_synthesis_run": "entity_synthesis_run",
   "engram.procedure_mining_run": "procedure_mining_run",
   "engram.pattern_reinforcement_run": "pattern_reinforcement_run",
-  "engram.procedural_stats": "procedural_stats", "engram.procedure_library_maintenance": "procedure_library_maintenance",
+  "engram.procedural_stats": "procedural_stats",
+  "engram.procedure_library_maintenance": "procedure_library_maintenance",
   "engram.memory_timeline": "memory_timeline",
   "engram.suggestion_submit": "suggestion_submit",
   "engram.entity_get": "entity_get",
@@ -249,7 +274,14 @@ export const MCP_MIGRATED_OPERATIONS: Readonly<Record<string, OperationName>> =
   "engram.console_state": "console_state",
   "engram.dreams_status": "dreams_status",
   "engram.dreams_run": "dreams_run",
-  ...SUPPORT_PASSPORT_MCP_MIGRATED_OPERATIONS, ...MCP_ADMIN_OPS_MIGRATED_OPERATIONS, "engram.deep_recall": "deep_recall", "engram.memory_expand": "memory_expand", "engram.memory_traverse": "memory_traverse", "engram.memory_ls": "memory_ls", "engram.memory_tree": "memory_tree", "engram.memory_find": "memory_find",
+  ...SUPPORT_PASSPORT_MCP_MIGRATED_OPERATIONS,
+  ...MCP_ADMIN_OPS_MIGRATED_OPERATIONS,
+  "engram.deep_recall": "deep_recall",
+  "engram.memory_expand": "memory_expand",
+  "engram.memory_traverse": "memory_traverse",
+  "engram.memory_ls": "memory_ls",
+  "engram.memory_tree": "memory_tree",
+  "engram.memory_find": "memory_find",
   "engram.memory_chat": "chat_message",
 };
 
@@ -570,7 +602,8 @@ export class EngramMcpServer {
             },
             stateView: {
               type: "boolean",
-              description: "Opt in to state-aware recall views (issue #1952); ORs with the recallStateViews config flag.",
+              description:
+                "Opt in to state-aware recall views (issue #1952); ORs with the recallStateViews config flag.",
             },
           },
           required: ["query"],
@@ -690,7 +723,15 @@ export class EngramMcpServer {
           additionalProperties: false,
         },
       },
-      ...WEARABLES_MCP_TOOLS, ...MEETINGS_MCP_TOOLS, ...WHO_KNOWS_MCP_TOOLS, ...PROMOTION_CANDIDATES_MCP_TOOLS, ...LOCATION_MCP_TOOLS, ...STANDUP_MCP_TOOLS, ...DEEP_RECALL_MCP_TOOLS, ...(service.recallNavigationEnabled !== false ? RECALL_NAVIGATION_MCP_TOOLS : []), ...MEMORY_BROWSE_MCP_TOOLS,
+      ...WEARABLES_MCP_TOOLS,
+      ...MEETINGS_MCP_TOOLS,
+      ...WHO_KNOWS_MCP_TOOLS,
+      ...PROMOTION_CANDIDATES_MCP_TOOLS,
+      ...LOCATION_MCP_TOOLS,
+      ...STANDUP_MCP_TOOLS,
+      ...DEEP_RECALL_MCP_TOOLS,
+      ...(service.recallNavigationEnabled !== false ? RECALL_NAVIGATION_MCP_TOOLS : []),
+      ...MEMORY_BROWSE_MCP_TOOLS,
       ...RECALL_WHY_MCP_TOOLS,
       ...(service.supportPassportEnabled ? SUPPORT_PASSPORT_MCP_TOOLS : []),
       {
@@ -1089,7 +1130,11 @@ export class EngramMcpServer {
             namespace: { type: "string" },
             cwd: { type: "string", description: "Working directory for auto git-context resolution." },
             projectTag: { type: "string", description: "Project tag for non-git project scoping." },
-            deadlineMs: { type: "number", minimum: 0 },
+            deadlineMs: {
+              type: "number",
+              minimum: 0,
+              description: "Budget in milliseconds from now; the flush aborts when it elapses.",
+            },
           },
           required: ["sessionKey"],
           additionalProperties: false,
@@ -1375,7 +1420,12 @@ export class EngramMcpServer {
               description:
                 "QMD collection. With namespaces enabled, omitted, base, and 'global' searches stay scoped to readable namespaces; namespace-derived collections require matching namespace access.",
             },
-            mode: { type: "string", enum: ["search", "hybrid", "bm25", "vector"], description: "Ranking mode; omitted uses the backend default. Not supported with 'collection' on a flat corpus." },
+            mode: {
+              type: "string",
+              enum: ["search", "hybrid", "bm25", "vector"],
+              description:
+                "Ranking mode; omitted uses the backend default. Not supported with 'collection' on a flat corpus.",
+            },
           },
           required: ["query"],
           additionalProperties: false,
@@ -1587,9 +1637,16 @@ export class EngramMcpServer {
                 type: "object",
                 properties: {
                   since: { type: "string", description: "Lookback window (e.g. 'yesterday', '3d', '1w', '24h')." },
-                  focus: { type: "string", description: "Optional focus filter (e.g. 'person:Jane Doe', 'project:remnic-core', 'topic:retrieval')." },
+                  focus: {
+                    type: "string",
+                    description:
+                      "Optional focus filter (e.g. 'person:Jane Doe', 'project:remnic-core', 'topic:retrieval').",
+                  },
                   namespace: { type: "string" },
-                  includeLocation: { type: "boolean", description: "Opt-in: append matched location place names (location gates apply)." },
+                  includeLocation: {
+                    type: "boolean",
+                    description: "Opt-in: append matched location place names (location gates apply).",
+                  },
                   format: { type: "string", enum: ["markdown", "json"] },
                   maxFollowups: {
                     type: "number",
@@ -2256,9 +2313,10 @@ export class EngramMcpServer {
       // token's ops allow-list via the same map callTool uses. Unrestricted
       // tokens (ops axis absent) see everything; unmapped tool ⇒ "" ⇒ hidden.
       const caps = tokenCapabilityStore.getStore();
-      const tools = caps?.ops === undefined
-        ? this.tools
-        : this.tools.filter((t) => capabilityAllowsOp(caps, MCP_MIGRATED_OPERATIONS[toLegacyToolName(t.name)] ?? ""));
+      const tools =
+        caps?.ops === undefined
+          ? this.tools
+          : this.tools.filter((t) => capabilityAllowsOp(caps, MCP_MIGRATED_OPERATIONS[toLegacyToolName(t.name)] ?? ""));
       return { jsonrpc: "2.0", id, result: { tools } };
     }
     if (method === "resources/list") {
@@ -2370,7 +2428,7 @@ export class EngramMcpServer {
           options?.enforceWriteQuota,
           options?.recordWriteCommit,
           options?.sourceConnector,
-          options?.abortSignal,
+          options?.abortSignal
         );
         if (isReadOnlyToolName(name)) {
           throwMcpAbort(options?.abortSignal, "MCP request aborted before response");
@@ -2588,7 +2646,7 @@ export class EngramMcpServer {
     enforceWriteQuota?: () => void | Promise<void>,
     recordWriteCommit?: () => void,
     sourceConnector?: string,
-    abortSignal?: AbortSignal,
+    abortSignal?: AbortSignal
   ): Promise<unknown> {
     const migrated = MCP_MIGRATED_OPERATIONS[toLegacyToolName(name)];
     if (!migrated) {
@@ -2604,8 +2662,7 @@ export class EngramMcpServer {
       const visible = this.tools
         .filter(
           (t) =>
-            caps?.ops === undefined
-            || capabilityAllowsOp(caps, MCP_MIGRATED_OPERATIONS[toLegacyToolName(t.name)] ?? ""),
+            caps?.ops === undefined || capabilityAllowsOp(caps, MCP_MIGRATED_OPERATIONS[toLegacyToolName(t.name)] ?? "")
         )
         .map((t) => t.name);
       throw new Error(unknownToolError(name, visible));
@@ -2641,7 +2698,7 @@ export class EngramMcpServer {
         enforceNamespaceAllowList(
           tokenCapabilityStore.getStore(),
           scope?.namespace,
-          this.service.configRef?.defaultNamespace,
+          this.service.configRef?.defaultNamespace
         );
       }
       const chatResult = await processChatMessage({
@@ -2689,7 +2746,12 @@ export class EngramMcpServer {
       service: this.service,
       authenticatedPrincipal: effectivePrincipal,
       ...(enforceWriteQuota || recordWriteCommit
-        ? { hooks: { ...(enforceWriteQuota ? { enforceWriteQuota } : {}), ...(recordWriteCommit ? { recordWriteCommit } : {}) } }
+        ? {
+            hooks: {
+              ...(enforceWriteQuota ? { enforceWriteQuota } : {}),
+              ...(recordWriteCommit ? { recordWriteCommit } : {}),
+            },
+          }
         : {}),
       ...(sourceConnector ? { sourceConnector } : {}),
       ...(abortSignal ? { abortSignal } : {}),

package/src/access-service-health.test.ts

@@ -511,11 +511,11 @@ test("health surfaces extraction liveness as degraded when the buffer is non-emp
     assert.equal(health.extraction.oldestBufferedTurnAgeMs, 10_000);
     assert.ok(
       health.extraction.degradedReason !== null && health.extraction.degradedReason.length > 0,
-      "degraded reason is populated",
+      "degraded reason is populated"
     );
     const scopedHealth = await tokenCapabilityStore.run(
       { version: TOKEN_CAPABILITIES_VERSION, namespaces: ["default"] },
-      () => service.health(),
+      () => service.health()
     );
     assert.equal(scopedHealth.extraction.lastExtractionAt, null);
     assert.equal(scopedHealth.extraction.degraded, true);
@@ -562,7 +562,7 @@ test("health reports extraction liveness ok when the buffer is empty (nothing to
     assert.equal(health.extraction.lastExtractionAt, oldTs);
     const scopedHealth = await tokenCapabilityStore.run(
       { version: TOKEN_CAPABILITIES_VERSION, namespaces: ["default"] },
-      () => service.health(),
+      () => service.health()
     );
     assert.equal(scopedHealth.extraction.degraded, health.extraction.degraded);
     assert.equal(scopedHealth.extraction.lastExtractionAt, null);
@@ -685,7 +685,7 @@ test("health reports extraction liveness degraded when the buffer read fails (§
     assert.match(health.extraction.degradedReason ?? "", /buffer file corrupt/);
     const scopedHealth = await tokenCapabilityStore.run(
       { version: TOKEN_CAPABILITIES_VERSION, namespaces: ["default"] },
-      () => service.health(),
+      () => service.health()
     );
     assert.equal(scopedHealth.extraction.lastExtractionAt, null);
     assert.match(scopedHealth.extraction.degradedReason ?? "", /extraction buffer unreadable/);
@@ -722,7 +722,7 @@ test("health reports extraction liveness degraded when the watermark (meta) read
     assert.match(health.extraction.degradedReason ?? "", /meta\.json unreadable/);
     const scopedHealth = await tokenCapabilityStore.run(
       { version: TOKEN_CAPABILITIES_VERSION, namespaces: ["default"] },
-      () => service.health(),
+      () => service.health()
     );
     assert.equal(scopedHealth.extraction.lastExtractionAt, null);
     assert.match(scopedHealth.extraction.degradedReason ?? "", /extraction watermark unreadable/);
@@ -731,3 +731,39 @@ test("health reports extraction liveness degraded when the watermark (meta) read
     await rm(memoryDir, { recursive: true, force: true });
   }
 });
+
+test("health surfaces extraction-LLM availability and last failure reason (#3140)", async () => {
+  const {
+    getExtractionLlmHealth,
+    recordExtractionLlmFailure,
+    recordExtractionLlmSuccess,
+    resetExtractionLlmHealthForTests,
+  } = await import("./extraction-llm-health.js");
+  const memoryDir = await mkdtemp(path.join(os.tmpdir(), "remnic-health-llm-"));
+  const makeService = () =>
+    new EngramAccessService({
+      config: parseConfig({ memoryDir }),
+      qmd: makeQmd({}),
+      async getStorage() {
+        return { dir: memoryDir };
+      },
+    } as unknown as Orchestrator);
+  try {
+    resetExtractionLlmHealthForTests();
+    recordExtractionLlmFailure("no_models", Date.now());
+    const unhealthy = await makeService().health();
+    assert.equal(unhealthy.extraction.llmReachable, false);
+    assert.equal(unhealthy.extraction.lastFailureReason, "no_models");
+    assert.equal(unhealthy.extraction.lastFailureAt, getExtractionLlmHealth().lastFailureAt);
+
+    // A recovered extractor reads reachable with no stale reason.
+    recordExtractionLlmSuccess();
+    const healthy = await makeService().health();
+    assert.equal(healthy.extraction.llmReachable, true);
+    assert.equal(healthy.extraction.lastFailureReason, null);
+    assert.equal(healthy.extraction.lastFailureAt, null);
+  } finally {
+    resetExtractionLlmHealthForTests();
+    await rm(memoryDir, { recursive: true, force: true });
+  }
+});

package/src/access-service-helpers.ts

@@ -20,6 +20,7 @@ export interface EngramAccessExtractionForceFlushRequest extends CodingScopedWri
   sessionKey: string;
   namespace?: string;
   authenticatedPrincipal?: string;
+  /** Budget in milliseconds FROM NOW (not an absolute epoch); converted at the force-flush entry (#3140). */
   deadlineMs?: number;
   abortSignal?: AbortSignal;
   /** Internal HTTP hook invoked at the durable commit boundary. */