@remnic/core 9.69.41 → 9.69.43

package/dist/who-knows.d.ts

@@ -1,6 +1,6 @@
-export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-Cisy5YDq.js';
-import './types-cK5LydjL.js';
-import './orchestrator-DT7ybIFz.js';
+export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-DxTTTg9O.js';
+import './types-Sps-lg5I.js';
+import './orchestrator-VXWKdatm.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
@@ -13,6 +13,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';
@@ -21,7 +22,7 @@ import './semantic-merge-config.js';
 import './types-continuity.js';
 import './included-memories.js';
 import './briefing.js';
-import './storage-C-0Ah5OY.js';
+import './storage-C9nsZX5Q.js';
 import './corpus-read-cancellation.js';
 import './artifact-search.js';
 import './active-context-transform.js';
@@ -37,7 +38,7 @@ import './write-envelope.js';
 import './structured-attributes.js';
 import './buffer.js';
 import './extraction-faithfulness.js';
-import './local-llm-DpXIvm6F.js';
+import './local-llm-3-jtw52a.js';
 import './model-registry.js';
 import './fallback-llm.js';
 import './fallback-llm-codex-subscription.js';
@@ -46,8 +47,8 @@ import './resolve-provider-secret.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
-import './maintenance-CNgoLsoM.js';
-import './catalog-wcX1QhtQ.js';
+import './maintenance-DgeeH0a1.js';
+import './catalog-Ya3DDn_T.js';
 import './namespaces/search.js';
 import './compounding/engine.js';
 import './shared-context/manager.js';
@@ -57,7 +58,7 @@ import './utility-runtime.js';
 import './tier-routing.js';
 import './lifecycle.js';
 import './orchestration/compression-guideline-coordinator.js';
-import './semantic-consolidation-BPFFVO84.js';
+import './semantic-consolidation-g6x-ShY8.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './embedding-fallback.js';
@@ -79,17 +80,17 @@ import './conversation-index/chunker.js';
 import './conversation-index/backend.js';
 import './faiss-adapter-BHecI1fF.js';
 import './runtime/child-process.js';
-import './dependency-propagation-delivery-BDDjImQn.js';
+import './dependency-propagation-delivery-CggS9BFT.js';
 import './namespaces/storage.js';
 import './threading.js';
-import './scope-profiles-BBPjZ9jb.js';
+import './scope-profiles-C564-hrv.js';
 import './graph-DRkl22KE.js';
 import './graph-write-lock.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './recall-context-composition.js';
-import './generic-recall-paths-CpDzNO_I.js';
+import './generic-recall-paths-CoXPSnCw.js';
 import './live-connectors-runner.js';
 import './framework-CNDn2164.js';
 import './relevance.js';
@@ -97,7 +98,7 @@ import './negative.js';
 import './session-observer-state.js';
 import './semantic-BalR6EXU.js';
 import './replay/types.js';
-import './service-jKcr6Jvr.js';
+import './service-CaCOk0rd.js';
 import './extraction-judge.js';
 import './lcm/engine.js';
 import './lcm/archive.js';
@@ -119,7 +120,8 @@ import './recall-audit.js';
 import './types-B1VHaf2w.js';
 import './transfer/capsule-import.js';
 import './transfer/types.js';
-import './access-namespace-preflight-DWsMc9Dh.js';
+import './recall-navigation.js';
+import './access-namespace-preflight-CE-RrXKu.js';
 import './access-token-capabilities.js';
 import 'node:async_hooks';
 import './recall-explain-renderer.js';
@@ -127,6 +129,7 @@ import './access-citation.js';
 import './access-health-types.js';
 import './corpus-watermark.js';
 import './replica-divergence.js';
+import './tagging-BA4RFdH3.js';
 import './explicit-capture.js';
 import './access-wearables-meetings-surface.js';
 import './deep-recall.js';

package/dist/who-knows.js

@@ -9,28 +9,28 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-2ZG2LLZT.js";
-import "./chunk-ICN37XHG.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-D7UUB33A.js";
+import "./chunk-GMU7MAHS.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-AIVRD66I.js";
-import "./chunk-PLJ2MQFT.js";
-import "./chunk-KVO2BTA4.js";
-import "./chunk-CYEPCZN5.js";
+import "./chunk-T3F2HWIG.js";
+import "./chunk-C3YEB7CR.js";
 import "./chunk-G6NQ3L4T.js";
 import "./chunk-WPGR3RW4.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-D7MAYFQP.js";
+import "./chunk-KVO2BTA4.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-PCEYGOSL.js";
-import "./chunk-WN2OXGGH.js";
+import "./chunk-66YUOI53.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -54,8 +54,6 @@ import "./chunk-KG2OOAFF.js";
 import "./chunk-U2VDCFXW.js";
 import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-GDYU6VF4.js";
-import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-TRTLWUDD.js";
@@ -66,7 +64,6 @@ import "./chunk-UHSOPTNB.js";
 import "./chunk-E2AWJ7KQ.js";
 import "./chunk-RW4QNB4J.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-VYCOJKSX.js";
 import "./chunk-6Q3ZTEF6.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PJKTFXE2.js";
@@ -75,17 +72,20 @@ import "./chunk-Z7L72ZHL.js";
 import "./chunk-4O4TKIXQ.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-PQVCH2AE.js";
+import "./chunk-GDYU6VF4.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-VYCOJKSX.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-JL4TQYM5.js";
-import "./chunk-TBXAY2SS.js";
+import "./chunk-SGHGCFVV.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
-import "./chunk-C7HJ3NEI.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-7RJUVTVF.js";
+import "./chunk-C7HJ3NEI.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";

package/dist/write-envelope.d.ts

@@ -1,4 +1,4 @@
-import { u as MemoryCategory, N as MemorySubject } from './types-cK5LydjL.js';
+import { u as MemoryCategory, N as MemorySubject } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/package.json

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

package/src/access-boundary.ts

@@ -84,6 +84,8 @@ export const OPERATION_NAMES = [
   "meetings_get",
   "meetings_build",
   "deep_recall",
+  "memory_expand",
+  "memory_traverse",
   "standup",
   "action_confidence",
   "chatgpt_memory_inspector",

package/src/access-http.test.ts

@@ -861,6 +861,7 @@ test("HTTP briefing endpoint dispatches through the briefing operation", async (
       {
         since: "24h",
         focus: undefined,
+        includeLocation: undefined,
         namespace: "team",
         format: "markdown",
         maxFollowups: 5,

package/src/access-http.ts

@@ -26,7 +26,7 @@ import {
 import { peerManifestRevision } from "./reconcile/manifest.js";
 import { nonEmptyQueryParam, optionalNamespaceKindQueryParam, optionalQueryString, positiveIntQueryParam } from "./access-http-query.js";
 import { CorrectionContractError } from "./correction/correction-contract.js";
-import { respondWearablesErrorGlue } from "./wearables/http-glue.js"; import { respondMeetingsList, respondMeetingsGet, respondMeetingsBuild } from "./meetings/http-glue.js"; import { respondLocationStatus, respondLocationCheck, respondLocationSync, respondLocationBackfill, respondLocationDay } from "./location/http-glue.js"; import { respondStandup } from "./standup/http-glue.js"; import { respondDeepRecall } from "./deep-recall-http-glue.js";
+import { respondWearablesErrorGlue } from "./wearables/http-glue.js"; import { respondMeetingsList, respondMeetingsGet, respondMeetingsBuild } from "./meetings/http-glue.js"; import { respondLocationStatus, respondLocationCheck, respondLocationSync, respondLocationBackfill, respondLocationDay } from "./location/http-glue.js"; import { respondStandup } from "./standup/http-glue.js"; import { respondDeepRecall } from "./deep-recall-http-glue.js"; import { maybeRespondRecallNavigation } from "./recall-navigation-http-glue.js";
 import { EngramMcpServer, MCP_SUPPORTED_PROTOCOL_VERSIONS } from "./access-mcp.js";
 import { handleMcpGetSse } from "./access-mcp-sse.js";
 import { validateRequest, type SchemaName, type SchemaTypeFor } from "./access-schema.js";
@@ -1752,8 +1752,8 @@ export class EngramAccessHttpServer extends ReviewDeckAccessHttpBase {
     const meetingGetEngram = /^\/engram\/v1\/meetings\/([^/]+)$/.exec(pathname);
     if (req.method === "GET" && meetingGetEngram) { this.enforceTokenOp("meetings_get"); await respondMeetingsGet(res, this.respondJson.bind(this), this.service, meetingGetEngram[1] ?? "", this.wearablesScope(req, parsed.searchParams.get("namespace") ?? undefined, parsed.searchParams.get("sessionKey") ?? undefined)); return; }
     const meetingGetRemnic = /^\/remnic\/v1\/meetings\/([^/]+)$/.exec(pathname); if (req.method === "GET" && meetingGetRemnic) { this.enforceTokenOp("meetings_get"); await respondMeetingsGet(res, this.respondJson.bind(this), this.service, meetingGetRemnic[1] ?? "", this.wearablesScope(req, parsed.searchParams.get("namespace") ?? undefined, parsed.searchParams.get("sessionKey") ?? undefined)); return; }
-    if (req.method === "POST" && (pathname === "/engram/v1/recall/deep" || pathname === "/remnic/v1/recall/deep")) {
-      this.enforceTokenOp("deep_recall"); await respondDeepRecall(req, res, this.respondJson.bind(this), this.readJsonBody.bind(this), this.service, (ns, sk) => this.wearablesScope(req, ns ?? parsed.searchParams.get("namespace") ?? undefined, sk ?? parsed.searchParams.get("sessionKey") ?? undefined), abortSignal); return; }
+    if (req.method === "POST" && (pathname === "/engram/v1/recall/deep" || pathname === "/remnic/v1/recall/deep")) { this.enforceTokenOp("deep_recall"); await respondDeepRecall(req, res, this.respondJson.bind(this), this.readJsonBody.bind(this), this.service, (ns, sk) => this.wearablesScope(req, ns ?? parsed.searchParams.get("namespace") ?? undefined, sk ?? parsed.searchParams.get("sessionKey") ?? undefined), abortSignal); return; }
+    if (await maybeRespondRecallNavigation(req, res, pathname, req.method, (op) => this.enforceTokenOp(op), this.respondJson.bind(this), this.readJsonBody.bind(this), this.service, (ns, sk) => this.wearablesScope(req, ns ?? parsed.searchParams.get("namespace") ?? undefined, sk ?? parsed.searchParams.get("sessionKey") ?? undefined))) return;
     // Location sync surfaces (issue #2047): thin branches; bodies + boundary dispatch live in location/http-glue.ts.
     if (req.method === "GET" && (pathname === "/engram/v1/location/status" || pathname === "/remnic/v1/location/status")) {
       this.enforceTokenOp("location_status"); await respondLocationStatus(res, this.respondJson.bind(this), this.service); return; }

package/src/access-mcp-output-schemas.ts

@@ -28,6 +28,31 @@ function objectSchema(
   };
 }
 
+/** RecallNavigationResult-shaped schema — shared by memory_expand/memory_traverse. */
+function navigationResultSchema(): Record<string, unknown> {
+  return objectSchema(
+    {
+      ok: T_BOOLEAN,
+      action: T_STRING,
+      memoryId: T_STRING,
+      namespace: T_STRING,
+      items: T_ARRAY,
+      truncated: T_BOOLEAN,
+      budget: objectSchema({ chars: T_NUMBER, used: T_NUMBER }),
+      disclosureSpend: objectSchema({
+        chunk: objectSchema({ count: T_NUMBER, estimatedTokens: T_NUMBER }),
+        section: objectSchema({ count: T_NUMBER, estimatedTokens: T_NUMBER }),
+        raw: objectSchema({ count: T_NUMBER, estimatedTokens: T_NUMBER }),
+        unspecified: objectSchema({ count: T_NUMBER, estimatedTokens: T_NUMBER }),
+      }),
+      error: T_NULLABLE_STRING,
+      message: T_NULLABLE_STRING,
+      rendered: T_STRING,
+    },
+    ["ok", "action", "rendered"]
+  );
+}
+
 /**
  * Per-suffix outputSchema registry. Tools not present here fall back to
  * `{ type: "object", additionalProperties: true }` in the constructor pass.
@@ -86,6 +111,11 @@ const TOOL_OUTPUT_SCHEMAS: Readonly<Record<string, Record<string, unknown>>> = {
     { ok: T_BOOLEAN, error: T_NULLABLE_STRING, entries: T_ARRAY, trace: T_ARRAY, rendered: T_STRING },
     ["entries", "trace"]
   ),
+  // RecallNavigationResult union (recall-navigation.ts): success carries
+  // items/budget/disclosureSpend; error carries error/message. ok/action/
+  // rendered are the fields every variant returns.
+  memory_expand: navigationResultSchema(),
+  memory_traverse: navigationResultSchema(),
   standup: objectSchema({
     date: T_STRING,
     yesterday: T_STRING,

package/src/access-mcp.ts

@@ -52,7 +52,7 @@ 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 { 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 { 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 { PROMOTION_CANDIDATES_MCP_TOOLS } from "./memory-subject.js";
@@ -247,7 +247,7 @@ 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",
+  ...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_chat": "chat_message",
 };
 
@@ -261,7 +261,7 @@ function resolveChatGptInspectorRecallSessionKey(
 }
 
 const STRICT_MCP_SCHEMA_KEYS: Partial<Record<SchemaName, readonly string[]>> = {
-  daySummary: ["memories", "sessionKey", "namespace", "timeZone", "cwd", "projectTag"],
+  daySummary: ["memories", "includeLocation", "sessionKey", "namespace", "timeZone", "cwd", "projectTag"],
   memoryStore: [
     "schemaVersion",
     "idempotencyKey",
@@ -688,7 +688,7 @@ 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,
+      ...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 : []),
       ...(service.supportPassportEnabled ? SUPPORT_PASSPORT_MCP_TOOLS : []),
       {
         name: "engram.action_confidence",
@@ -1584,12 +1584,9 @@ 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)." },
                   format: { type: "string", enum: ["markdown", "json"] },
                   maxFollowups: {
                     type: "number",

package/src/access-observe-write-category.ts

@@ -13,6 +13,7 @@ import {
 } from "./access-schema.js";
 
 export { reapplyCategoryCoercion };
+export { applyBriefingLocationContext } from "./location/tagging.js";
 
 export function splitCanonicalWriteRequest<T extends { rawCategory?: string }>(
   request: T,

package/src/access-observe-write-surface.ts

@@ -29,7 +29,7 @@ import {
   type MemoryScopePlan,
   NamespaceNotWritableError,
 } from "./access-service.js";
-import { reapplyCategoryCoercion, splitCanonicalWriteRequest } from "./access-observe-write-category.js";
+import { applyBriefingLocationContext, reapplyCategoryCoercion, splitCanonicalWriteRequest } from "./access-observe-write-category.js";
 import { extractionForceFlush } from "./access-extraction-force-flush.js";
 import { ObserveTranscriptPersister, observeTranscriptSessionKey } from "./access-observe-transcript.js";
 import { FileCalendarSource, buildBriefing, parseBriefingFocus, parseBriefingWindow } from "./briefing.js";
@@ -454,7 +454,7 @@ export class AccessObserveWriteSurface {
       ? new FileCalendarSource(config.briefing.calendarSource)
       : undefined;
 
-    const result = await buildBriefing({
+    const result = await applyBriefingLocationContext(await buildBriefing({
       storage,
       namespace,
       window,
@@ -470,7 +470,7 @@ export class AccessObserveWriteSurface {
       // other LLM feature uses. A configured key keeps its precedence so
       // existing deployments are unchanged.
       followupGenerator: config.openaiApiKey ? undefined : this.deps.orchestrator.briefingChainFollowupGenerator,
-    });
+    }), request.includeLocation, storage.dir, window.from.toISOString(), config.location);
 
     return {
       format,

package/src/access-operations-batch.ts

@@ -233,7 +233,7 @@ defineOperation({ name: "chatgpt_memory_inspector", description: "Memory inspect
     return { result: buildChatGptMemoryInspectorResult(ii, r, x, ac) };
   },
 });
-defineOperation({ name: "day_summary", description: "Day summary.", schema: strictSchema({ memories: S.str, sessionKey: S.str, namespace: S.str, timeZone: S.str, cwd: S.str, projectTag: S.str }), handler: async (input, ctx) => { const req: Record<string, unknown> = {}; if (input.memories !== undefined) req.memories = optStr(input.memories); if (input.sessionKey !== undefined) req.sessionKey = optStr(input.sessionKey); if (input.namespace !== undefined) req.namespace = optStr(input.namespace); if (input.timeZone !== undefined) req.timeZone = optStr(input.timeZone); const summary = await ctx.service.daySummary(req); return { result: summary ?? {} }; } });
+defineOperation({ name: "day_summary", description: "Day summary.", schema: strictSchema({ memories: S.str, includeLocation: S.bool, sessionKey: S.str, namespace: S.str, timeZone: S.str, cwd: S.str, projectTag: S.str }), handler: async (input, ctx) => { const req: Record<string, unknown> = {}; if (input.memories !== undefined) req.memories = optStr(input.memories); if (input.includeLocation !== undefined) req.includeLocation = optBool(input.includeLocation); if (input.sessionKey !== undefined) req.sessionKey = optStr(input.sessionKey); if (input.namespace !== undefined) req.namespace = optStr(input.namespace); if (input.timeZone !== undefined) req.timeZone = optStr(input.timeZone); const summary = await ctx.service.daySummary(req); return { result: summary ?? {} }; } });
 defineOperation({ name: "capsule_export", description: "Export capsule.", schema: strictSchema({ name: S.str, namespace: S.str, since: S.str, includeKinds: S.strArr, peerIds: S.strArr, includeTranscripts: S.bool, encrypt: S.bool, cwd: S.str, projectTag: S.str }), handler: async (input, ctx) => ({ result: await ctx.service.capsuleExport({ name: optStr(input.name) ?? "", namespace: optStr(input.namespace), since: optStr(input.since), includeKinds: optStrArr(input.includeKinds), peerIds: optStrArr(input.peerIds), includeTranscripts: optBool(input.includeTranscripts as unknown), encrypt: optBool(input.encrypt as unknown), principal: ctx.authenticatedPrincipal } as unknown as Parameters<EngramAccessService["capsuleExport"]>[0]) }) });
 defineOperation({ name: "capsule_import", description: "Import capsule.", schema: strictSchema({ archivePath: S.str, namespace: S.str, mode: S.str, passphrase: S.str, cwd: S.str, projectTag: S.str }), handler: async (input, ctx) => ({ result: await ctx.service.capsuleImport({ archivePath: expandTildePath(optStr(input.archivePath) ?? ""), namespace: optStr(input.namespace), mode: optStr(input.mode) as "skip" | "overwrite" | "fork" | undefined, passphrase: optStr(input.passphrase), principal: ctx.authenticatedPrincipal }) }) });
 defineOperation({ name: "capsule_list", description: "List capsules.", schema: strictSchema({ namespace: S.str, sessionKey: S.str, cwd: S.str, projectTag: S.str }), handler: async (input, ctx) => {
@@ -373,7 +373,7 @@ defineOperation({ name: "memory_promote", description: "Promote memory.", schema
 defineOperation({ name: "memory_outcome", description: "Record outcome.", schema: strictSchema({ memoryId: S.str, outcome: S.str, namespace: S.str, sessionKey: S.str, timestamp: S.str }), handler: async (input, ctx) => { const o = optStr(input.outcome); if (o !== "success" && o !== "failure") throw new EngramAccessInputError("memory_outcome: outcome must be \"success\" or \"failure\"; got " + JSON.stringify(o)); return { result: await ctx.service.memoryOutcome({ memoryId: optStr(input.memoryId) ?? "", outcome: o, namespace: optStr(input.namespace), sessionKey: optStr(input.sessionKey), timestamp: optStr(input.timestamp), principal: ctx.authenticatedPrincipal }) }; } });
 defineOperation({ name: "memory_action_apply", description: "Apply action.", schema: strictSchema({ action: S.str, outcome: S.str, reason: S.str, memoryId: S.str, namespace: S.str, sessionKey: S.str, content: S.str, category: S.str, linkTargetId: S.str, linkType: S.str, linkStrength: S.num, artifactType: S.str, execute: S.bool, sourcePrompt: S.str, dryRun: S.bool }), handler: async (input, ctx) => ({ result: await ctx.service.memoryActionApply({ action: optStr(input.action) ?? "", outcome: optStr(input.outcome), reason: optStr(input.reason), memoryId: optStr(input.memoryId) ?? "", namespace: optStr(input.namespace), sessionKey: optStr(input.sessionKey), content: optStr(input.content), category: optStr(input.category), linkTargetId: optStr(input.linkTargetId), linkType: optStr(input.linkType), linkStrength: optNum(input.linkStrength), artifactType: optStr(input.artifactType), execute: optBool(input.execute), sourcePrompt: optStr(input.sourcePrompt), dryRun: input.dryRun === true, principal: ctx.authenticatedPrincipal }) }) });
 defineOperation({ name: "context_checkpoint", description: "Context checkpoint.", schema: strictSchema({ sessionKey: S.str, context: S.str, namespace: S.str }), handler: async (input, ctx) => ({ result: await ctx.service.contextCheckpoint({ sessionKey: optStr(input.sessionKey) ?? "", context: optStr(input.context) ?? "", namespace: optStr(input.namespace), principal: ctx.authenticatedPrincipal }) }) });
-defineOperation({ name: "briefing", description: "Daily briefing.", schema: strictSchema({ since: S.str, focus: S.str, namespace: S.str, format: S.str, maxFollowups: S.num }), handler: async (input, ctx) => { const rf = optStr(input.format); const fe = validateBriefingFormat(rf); if (fe) throw new EngramAccessInputError(fe); return { result: await ctx.service.briefing({ since: optStr(input.since), focus: optStr(input.focus), namespace: optStr(input.namespace), format: rf as "json" | "markdown" | undefined, maxFollowups: optNum(input.maxFollowups), principal: ctx.authenticatedPrincipal }) }; } });
+defineOperation({ name: "briefing", description: "Daily briefing.", schema: strictSchema({ since: S.str, focus: S.str, namespace: S.str, includeLocation: S.bool, format: S.str, maxFollowups: S.num }), handler: async (input, ctx) => { const rf = optStr(input.format); const fe = validateBriefingFormat(rf); if (fe) throw new EngramAccessInputError(fe); return { result: await ctx.service.briefing({ since: optStr(input.since), focus: optStr(input.focus), namespace: optStr(input.namespace), includeLocation: optBool(input.includeLocation), format: rf as "json" | "markdown" | undefined, maxFollowups: optNum(input.maxFollowups), principal: ctx.authenticatedPrincipal }) }; } });
 
 // === CONTRADICTION/REVIEW ===
 defineOperation({ name: "review_list", description: "List review pairs.", schema: strictSchema({ filter: S.str, namespace: S.str, limit: S.num }),

package/src/access-operations.ts

@@ -698,6 +698,8 @@ import "./relay/mission-access.js";
 // Location sync surfaces (issue #2047).
 import "./location/access-operations.js";
 import "./standup/access-operations.js";
+// Recall navigation (issue #1956).
+import "./recall-navigation-operations.js";
 
 export const REGISTERED_OPERATIONS = [
   memoryGetOperation.spec.name,

package/src/access-schema.ts

@@ -529,6 +529,7 @@ export const lcmCompactionRecordRequestSchema = z.object({
 
 export const daySummaryRequestSchema = z.object({
   memories: z.string().max(100000).optional(),
+  includeLocation: z.boolean().optional(),
   sessionKey: sessionKeySchema,
   namespace: namespaceSchema,
   timeZone: timeZoneSchema.optional(),

package/src/access-service.ts

@@ -36,6 +36,7 @@ import type { ResolveSecretRefFn } from "./resolve-auth-token.js";
 import { buildAccessWriteRequestFingerprint, buildObserveRequestFingerprint } from "./write-envelope.js";
 import { UNATTRIBUTED_ACCESS_WRITE_ORIGIN } from "./shared-context/envelope-io.js";
 import { isSharedContextWriteInputError } from "./shared-context/write-output-controls.js";
+import { daySummaryAutoOptions, type LocationContextRequestOptions } from "./location/tagging.js";
 export type { EngramAccessHealthResponse, EngramAccessQmdCollectionState, EngramAccessQmdHealthResponse };
 import { AccessAuditAdapter, type AccessAuditConfig, type AccessAuditResult } from "./access-audit.js";
 import {
@@ -172,6 +173,9 @@ import {
 } from "./admin/admin-surfaces.js";
 import { FileCalendarSource, buildBriefing, parseBriefingFocus, parseBriefingWindow } from "./briefing.js";
 import { type DeepRecallResult, runBudgetedDeepRecall } from "./deep-recall.js";
+import { resolveEffectiveDeepRecallConfig } from "./deep-recall-config.js";
+import { type RecallNavigationRequest, type RecallNavigationResult, runRecallNavigation } from "./recall-navigation.js";
+import { RECALL_NAVIGATION_CONFIG_DEFAULTS } from "./recall-navigation-config.js";
 import { callDeepRecallPolicyLlm } from "./deep-recall-policy-llm.js";
 import { createDeepRecallSeedSearch } from "./deep-recall-seeds.js";
 import { renderDeepRecallResult } from "./deep-recall-renderer.js";
@@ -481,7 +485,7 @@ export interface EngramAccessRecallExplainResponse {
   graph?: GraphRecallSnapshot | null;
 }
 
-export interface EngramAccessDaySummaryRequest {
+export interface EngramAccessDaySummaryRequest extends LocationContextRequestOptions {
   memories?: string;
   sessionKey?: string;
   namespace?: string;
@@ -489,7 +493,7 @@ export interface EngramAccessDaySummaryRequest {
 }
 
 /** Inputs accepted by the `remnic_briefing` MCP tool. */
-export interface EngramAccessBriefingRequest {
+export interface EngramAccessBriefingRequest extends LocationContextRequestOptions {
   since?: string;
   focus?: string;
   namespace?: string;
@@ -1277,6 +1281,7 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
   private readonly replicaDivergenceMonitor: ReplicaDivergenceMonitor;
   private readonly injectedSupportPassportGatewayRoute: SupportPassportModelRoute | null;
   readonly reviewDeckEnabled: boolean;
+  readonly recallNavigationEnabled: boolean;
 
   /** AccessObserveWriteSurface (access-service decomposition). Lazy; selfDeps live wiring. */
   private _accessObserveWriteSurface: AccessObserveWriteSurface | undefined;
@@ -1365,6 +1370,9 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
     this.replicaDivergenceMonitor = new ReplicaDivergenceMonitor({ resolveSecretRef: options.resolveSecretRef });
     this.injectedSupportPassportGatewayRoute = options.supportPassportGatewayRoute ?? null;
     this.reviewDeckEnabled = options.reviewDeckEnabled === true;
+    // Configs built without parseConfig (test stubs, older host shapes) may
+    // omit the block; the parsed default (enabled: true) is the contract.
+    this.recallNavigationEnabled = (orchestrator.config.recallNavigation ?? RECALL_NAVIGATION_CONFIG_DEFAULTS).enabled;
     const accessCaps = resolveAccessSetupCapabilities(orchestrator.config); // #1566 Cluster B
     this.budget = new CrossNamespaceBudget({
       enabled: accessCaps.recallCrossNamespaceBudget,
@@ -2476,9 +2484,7 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
 
     if (memories.length === 0) {
       // Auto-gather today's facts from the resolved namespace
-      return this.orchestrator.generateDaySummaryAuto(namespace, {
-        timeZone: request.timeZone,
-      });
+      return this.orchestrator.generateDaySummaryAuto(namespace, daySummaryAutoOptions(request));
     }
     return this.orchestrator.generateDaySummary(memories);
   }
@@ -2744,29 +2750,7 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
     if (query.length === 0) {
       throw new EngramAccessInputError("deepRecall: query is required");
     }
-    let effective = cfg;
-    const requestedSteps = request.maxSteps;
-    if (requestedSteps !== undefined) {
-      if (typeof requestedSteps !== "number" || !Number.isInteger(requestedSteps) || requestedSteps < 0) {
-        throw new EngramAccessInputError("deepRecall: maxSteps must be a non-negative integer");
-      }
-      // `deepRecall.maxSteps: 0` is a documented disable value (§33): the
-      // policy loop is off, so ANY positive override is a refusal rather than
-      // a ceiling comparison. The zero case resolves first, so the ceiling
-      // threshold below only runs while the loop is enabled.
-      if (cfg.maxSteps <= 0) {
-        if (requestedSteps > 0) {
-          throw new EngramAccessInputError(
-            "deepRecall: the policy loop is disabled (deepRecall.maxSteps=0); maxSteps must be 0"
-          );
-        }
-      } else if (requestedSteps > cfg.maxSteps) {
-        throw new EngramAccessInputError(
-          `deepRecall: maxSteps ${requestedSteps} exceeds the configured ceiling ${cfg.maxSteps}`
-        );
-      }
-      effective = { ...cfg, maxSteps: requestedSteps };
-    }
+    const effective = resolveEffectiveDeepRecallConfig(cfg, request.maxSteps);
     const principal =
       request.authenticatedPrincipal?.trim() || resolvePrincipal(request.sessionKey, this.orchestrator.config);
     // Read path resolves through the SAME namespace layer as memoryGet (§30):
@@ -2845,6 +2829,11 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
     return { ...result, rendered: renderDeepRecallResult(result) };
   }
 
+  async recallNavigate(request: RecallNavigationRequest): Promise<RecallNavigationResult> {
+    const principal = request.authenticatedPrincipal?.trim() || resolvePrincipal(request.sessionKey, this.orchestrator.config);
+    return runRecallNavigation({ config: this.orchestrator.config.recallNavigation ?? RECALL_NAVIGATION_CONFIG_DEFAULTS, recallBudgetChars: this.orchestrator.config.recallBudgetChars, recentServedIds: (sessionKey, depth) => this.orchestrator.handleHistory.recent(sessionKey, depth), resolveReadableNamespace: (ns, p) => this.resolveReadableNamespace(ns, p || undefined), getStorage: (namespace) => this.orchestrator.getStorage(namespace) }, { ...request, authenticatedPrincipal: (principal ?? "").length > 0 ? principal : undefined });
+  }
+
   async recallXray(request: {
     query: string;
     sessionKey?: string;

package/src/access-surface-catalog.test.ts

@@ -271,8 +271,17 @@ function extractHttpRouteDispatchMap(): Map<string, Set<string>> {
       // must not be keyed — validateDispatchCoverage will flag any catalog
       // entry claiming migration through it (no pathname-only fallback).
       currentKey = method ? `${method} ${pathname}` : null;
-      if (currentKey && !routeOps.has(currentKey)) {
-        routeOps.set(currentKey, new Set<string>());
+      if (currentKey) {
+        if (!routeOps.has(currentKey)) {
+          routeOps.set(currentKey, new Set<string>());
+        }
+        // One-line route branches (compact style, e.g. the deep-recall
+        // route) carry their dispatch marker on the SAME line as the route
+        // match — collect it before the loop advances or it is lost.
+        const sameLineOp = line.match(/(?:getOperation|enforceTokenOp)\("(\w+)"\)/);
+        if (sameLineOp) {
+          routeOps.get(currentKey)!.add(sameLineOp[1]!);
+        }
       }
       continue;
     }
@@ -350,6 +359,25 @@ function extractHttpRouteDispatchMap(): Map<string, Set<string>> {
       }
     }
   }
+
+  // Recall-navigation routes (issue #1956): the compact catch-all in
+  // access-http.ts delegates to maybeRespondRecallNavigation; the boundary
+  // dispatch markers live per-route in recall-navigation-http-glue.ts.
+  if (/\bawait\s+maybeRespondRecallNavigation\(/.test(source)) {
+    const navigationSource = readFileSync(
+      new URL("./recall-navigation-http-glue.ts", import.meta.url),
+      "utf-8",
+    );
+    const navigationRoutes = [
+      ["POST", "/engram/v1/memory/expand", "memory_expand"],
+      ["POST", "/engram/v1/memory/traverse", "memory_traverse"],
+    ] as const;
+    for (const [method, pathname, operation] of navigationRoutes) {
+      if (navigationSource.includes(`"${pathname}"`) && navigationSource.includes(`enforceTokenOp("${operation}")`)) {
+        routeOps.set(`${method} ${pathname}`, new Set([operation]));
+      }
+    }
+  }
   for (const [sourcePath, routes] of [
     ["./support-passport/access-http.ts", SUPPORT_PASSPORT_OWNER_HTTP_ROUTES],
     ["./support-passport/public-http.ts", SUPPORT_PASSPORT_PUBLIC_HTTP_ROUTES],

package/src/access-surface-catalog.ts

@@ -72,6 +72,8 @@ export const MCP_TOOLS: readonly McpToolEntry[] = [
   { tool: "meetings_get", operation: "meetings_get" },
   { tool: "meetings_build", operation: "meetings_build" },
   { tool: "deep_recall", operation: "deep_recall" },
+  { tool: "memory_expand", operation: "memory_expand" },
+  { tool: "memory_traverse", operation: "memory_traverse" },
   { tool: "standup", operation: "standup" },
   { tool: "action_confidence", operation: "action_confidence" },
   { tool: "chatgpt_memory_inspector", operation: "chatgpt_memory_inspector" },
@@ -237,6 +239,8 @@ export const HTTP_ROUTES: readonly HttpRouteEntry[] = [
   { method: "POST", pathname: "/engram/v1/meetings/build", operation: "meetings_build" },
   { method: "GET", pathname: "/engram/v1/meetings/:id", operation: "meetings_get" },
   { method: "POST", pathname: "/engram/v1/recall/deep", operation: "deep_recall" },
+  { method: "POST", pathname: "/engram/v1/memory/expand", operation: "memory_expand" },
+  { method: "POST", pathname: "/engram/v1/memory/traverse", operation: "memory_traverse" },
   { method: "GET", pathname: "/engram/v1/standup", operation: "standup" },
   { method: "POST", pathname: "/engram/v1/observe", operation: "observe" },
   { method: "POST", pathname: "/engram/v1/lcm/search", operation: "lcm_search" },