@remnic/core 9.69.41 → 9.69.43

package/dist/recall-navigation-mcp-tools.d.ts

@@ -0,0 +1,162 @@
+import { l as McpTool } from './access-service-DxTTTg9O.js';
+import './types-Sps-lg5I.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './recall-state-view.js';
+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';
+import './local-llm-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+import './orchestrator-VXWKdatm.js';
+import './recall-state.js';
+import './utils/serialize-mutations.js';
+import './search/port.js';
+import './included-memories.js';
+import './briefing.js';
+import './storage-C9nsZX5Q.js';
+import './corpus-read-cancellation.js';
+import './artifact-search.js';
+import './active-context-transform.js';
+import './context-summary.js';
+import './entity-id-normalization.js';
+import './page-versioning.js';
+import './consolidation-operator.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
+import 'better-sqlite3';
+import './write-envelope.js';
+import './structured-attributes.js';
+import './buffer.js';
+import './extraction-faithfulness.js';
+import './local-llm-3-jtw52a.js';
+import './model-registry.js';
+import './fallback-llm.js';
+import './fallback-llm-codex-subscription.js';
+import './cli-fallback.js';
+import './resolve-provider-secret.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './maintenance-DgeeH0a1.js';
+import './catalog-Ya3DDn_T.js';
+import './namespaces/search.js';
+import './compounding/engine.js';
+import './shared-context/manager.js';
+import 'zod';
+import './capabilities.js';
+import './utility-runtime.js';
+import './tier-routing.js';
+import './lifecycle.js';
+import './orchestration/compression-guideline-coordinator.js';
+import './semantic-consolidation-g6x-ShY8.js';
+import './connectors/codex-materialize.js';
+import './logger.js';
+import './embedding-fallback.js';
+import './extraction.js';
+import './schemas.js';
+import './profiling.js';
+import './extraction-error-classification.js';
+import './trust-zones.js';
+import './harmonic-retrieval.js';
+import './abstraction-nodes.js';
+import './cue-anchors.js';
+import './verified-recall.js';
+import './boxes.js';
+import './semantic-rule-verifier.js';
+import './work-product-ledger.js';
+import './trust-score-stage.js';
+import './trust-score.js';
+import './conversation-index/chunker.js';
+import './conversation-index/backend.js';
+import './faiss-adapter-BHecI1fF.js';
+import './runtime/child-process.js';
+import './dependency-propagation-delivery-CggS9BFT.js';
+import './namespaces/storage.js';
+import './threading.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-CoXPSnCw.js';
+import './live-connectors-runner.js';
+import './framework-CNDn2164.js';
+import './relevance.js';
+import './negative.js';
+import './session-observer-state.js';
+import './semantic-BalR6EXU.js';
+import './replay/types.js';
+import './service-CaCOk0rd.js';
+import './extraction-judge.js';
+import './lcm/engine.js';
+import './lcm/archive.js';
+import './token-estimate.js';
+import './lcm/recall.js';
+import './lcm/dag.js';
+import './lcm/queue.js';
+import './policy-runtime.js';
+import './access-schema.js';
+import './resolve-auth-token.js';
+import 'node:stream';
+import './action-confidence.js';
+import './offline-sync.js';
+import './offline-sync-file-io.js';
+import './memory-worth-outcomes.js';
+import './cross-namespace-budget.js';
+import './recall-audit-anomaly.js';
+import './recall-audit.js';
+import './types-B1VHaf2w.js';
+import './transfer/capsule-import.js';
+import './transfer/types.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';
+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';
+import './graph-snapshot.js';
+import './access-offline-manifest.js';
+import 'node:fs/promises';
+import './reconcile/manifest.js';
+import './reconcile/plan.js';
+import './capsule-cli.js';
+import './transfer/capsule-export.js';
+import './access-errors.js';
+
+/**
+ * Recall-navigation MCP tool definitions (issue #1956) — extracted from
+ * access-mcp.ts so the surface file stays at its structural ceiling (same
+ * seam as deep-recall-mcp-tools.ts). Spread back into `this.tools`
+ * (`...RECALL_NAVIGATION_MCP_TOOLS`); the migrated-operation mapping lives
+ * in access-mcp.ts's MCP_MIGRATED_OPERATIONS. The `remnic.` canonical alias
+ * is minted by withToolAliases at tools/list time.
+ *
+ * Gating: spread is conditional on `service.recallNavigationEnabled !== false`
+ * — the flag defaults TRUE, so the check treats an absent property (older
+ * service shape / test stub) as enabled and removes the tools from listing
+ * ONLY on an explicit false. Disabled config therefore yields tools absent
+ * from tools/list, not present-but-erroring.
+ */
+
+declare const RECALL_NAVIGATION_MCP_TOOLS: McpTool[];
+
+export { RECALL_NAVIGATION_MCP_TOOLS };

package/dist/recall-navigation-mcp-tools.js

@@ -0,0 +1,8 @@
+import {
+  RECALL_NAVIGATION_MCP_TOOLS
+} from "./chunk-TE6S7KDF.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  RECALL_NAVIGATION_MCP_TOOLS
+};
+//# sourceMappingURL=recall-navigation-mcp-tools.js.map

package/dist/recall-navigation-mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigation-operations.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/recall-navigation-operations.js

@@ -0,0 +1,245 @@
+import "./chunk-2WFOVXVJ.js";
+import "./chunk-LXMZM7LM.js";
+import "./chunk-W4F3C7N7.js";
+import "./chunk-MPC7TYTZ.js";
+import "./chunk-ZHXSOMYH.js";
+import "./chunk-IFBSZGW3.js";
+import "./chunk-QKCXRS5A.js";
+import "./chunk-C3QXITIP.js";
+import "./chunk-VQ7B2Q6M.js";
+import "./chunk-D7UUB33A.js";
+import "./chunk-PJSK6OJM.js";
+import "./chunk-GNVZQ5JN.js";
+import "./chunk-YN2UN7N3.js";
+import "./chunk-ROBHL3GL.js";
+import "./chunk-J2MGTGKC.js";
+import "./chunk-6DNMUYEE.js";
+import "./chunk-P5FPO2BR.js";
+import "./chunk-S4DDLTPX.js";
+import "./chunk-5UBH37SL.js";
+import "./chunk-46FVFU7S.js";
+import "./chunk-KIW3OOZE.js";
+import "./chunk-YE4JBZO5.js";
+import "./chunk-5KVT6G5U.js";
+import "./chunk-VYDGHJIN.js";
+import "./chunk-AS2NOPDM.js";
+import "./chunk-7O5EW7KX.js";
+import "./chunk-H7XKCNR6.js";
+import "./chunk-PW4HTWXL.js";
+import "./chunk-SOBJ6NEY.js";
+import "./chunk-VW5TGNJN.js";
+import "./chunk-2HDLDBJW.js";
+import "./chunk-CVILPI77.js";
+import "./chunk-6WHJ2EAB.js";
+import "./chunk-AQEJKOKI.js";
+import "./chunk-HM7RHKS4.js";
+import "./chunk-UD7UNYRD.js";
+import "./chunk-IISBCCWR.js";
+import "./chunk-2YA5N2BY.js";
+import "./chunk-HWLIMQE2.js";
+import "./chunk-3254BYQV.js";
+import "./chunk-EI6V5UXY.js";
+import "./chunk-CEO4DONG.js";
+import "./chunk-SGUDMW2K.js";
+import "./chunk-7IRZK6MM.js";
+import "./chunk-NLE6TSLG.js";
+import "./chunk-WLZYGLJ4.js";
+import "./chunk-WGZHSQDV.js";
+import "./chunk-JUXOTY6J.js";
+import "./chunk-QM2SPLKQ.js";
+import "./chunk-LTHVM4XN.js";
+import "./chunk-LQVXSRAJ.js";
+import "./chunk-C37ZRXX7.js";
+import "./chunk-7ZNJN5WZ.js";
+import "./chunk-YR5QT4SR.js";
+import "./chunk-RF2SMMPP.js";
+import "./chunk-AJBWVDRV.js";
+import "./chunk-WUUGE7QC.js";
+import "./chunk-HRATODNO.js";
+import "./chunk-WTWQA7BB.js";
+import "./chunk-VZIAVM72.js";
+import "./chunk-5AJZ7EUW.js";
+import "./chunk-KDLOKVX7.js";
+import "./chunk-JDL5BYYF.js";
+import "./chunk-3YQ7VLP3.js";
+import "./chunk-UFGFMWAD.js";
+import "./chunk-BMWN7B3Y.js";
+import "./chunk-KORQWGUA.js";
+import "./chunk-3UXOZBHV.js";
+import "./chunk-PIWFNPQT.js";
+import "./chunk-5FAGCOZD.js";
+import "./chunk-EUT2WCWS.js";
+import "./chunk-2LSZVONP.js";
+import "./chunk-DEUNUKTD.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-BPXJINHW.js";
+import "./chunk-F6PTJLEM.js";
+import "./chunk-CSAKJVXW.js";
+import "./chunk-K2XUWZBM.js";
+import "./chunk-OD4FM2U7.js";
+import "./chunk-ZY2MNJR6.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-OGAKUA7I.js";
+import "./chunk-GMU7MAHS.js";
+import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
+import "./chunk-D5F7TKMH.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-66YUOI53.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-MRPOZBJC.js";
+import "./chunk-S2HLHAZ4.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-LDXUBPMO.js";
+import "./chunk-ZYSOT6HD.js";
+import "./chunk-AAD2ZS6P.js";
+import "./chunk-SHEHQBCG.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
+import "./chunk-5GINB5LC.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-JPKK466T.js";
+import "./chunk-XCB6QDL6.js";
+import "./chunk-RBOJCG4T.js";
+import "./chunk-R7QY5ZVB.js";
+import "./chunk-5WITETWU.js";
+import "./chunk-6CIAGZ6X.js";
+import "./chunk-KG2OOAFF.js";
+import "./chunk-U2VDCFXW.js";
+import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
+import "./chunk-C64XATK7.js";
+import "./chunk-42JKGUFJ.js";
+import "./chunk-TRTLWUDD.js";
+import "./chunk-I55KAVET.js";
+import "./chunk-L2EXJQJP.js";
+import "./chunk-45GF7Y3V.js";
+import "./chunk-UHSOPTNB.js";
+import "./chunk-E2AWJ7KQ.js";
+import "./chunk-6JMQR72P.js";
+import "./chunk-TOTT6S2V.js";
+import "./chunk-QLK3SL7Q.js";
+import "./chunk-FEHIOYML.js";
+import "./chunk-P32IDSHD.js";
+import "./chunk-EH3HNCAM.js";
+import "./chunk-LVTT5AUG.js";
+import "./chunk-WNIUPHWV.js";
+import "./chunk-IJ6WHMFB.js";
+import "./chunk-3SG4FGDV.js";
+import "./chunk-JV3C2MNQ.js";
+import "./chunk-ADXCCZL2.js";
+import "./chunk-7RGX7BMF.js";
+import "./chunk-236PXYG7.js";
+import "./chunk-ZCUTSMR2.js";
+import "./chunk-QDW3E4RD.js";
+import "./chunk-L63GFNKL.js";
+import "./chunk-RW4QNB4J.js";
+import "./chunk-ZIKENA2C.js";
+import "./chunk-6Q3ZTEF6.js";
+import "./chunk-YCVB7X56.js";
+import "./chunk-PJKTFXE2.js";
+import "./chunk-W5BIQOAJ.js";
+import "./chunk-Z7L72ZHL.js";
+import "./chunk-4O4TKIXQ.js";
+import "./chunk-C5C7IJ4Q.js";
+import "./chunk-2QG4SLZI.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-3QL24R5Y.js";
+import "./chunk-SYOIVK7K.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-YTV6J4T6.js";
+import "./chunk-UDAUULK2.js";
+import "./chunk-GDYU6VF4.js";
+import "./chunk-BT7NVCML.js";
+import "./chunk-353C5UNV.js";
+import "./chunk-VYCOJKSX.js";
+import "./chunk-CRK6F6N3.js";
+import "./chunk-KQAFEZQX.js";
+import "./chunk-WEHSQBFR.js";
+import "./chunk-X7Y7WX73.js";
+import "./chunk-J4EB7DNW.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-Z2YFLXHU.js";
+import "./chunk-I4WBNM3M.js";
+import "./chunk-SOAU2OE2.js";
+import "./chunk-6EGIQEKC.js";
+import "./chunk-JDOBQPJY.js";
+import "./chunk-PAAJWQH5.js";
+import "./chunk-RFIJH2OE.js";
+import "./chunk-OQQXGYMX.js";
+import "./chunk-MNIPH6LD.js";
+import "./chunk-JL4TQYM5.js";
+import "./chunk-SGHGCFVV.js";
+import "./chunk-ZA53AZND.js";
+import "./chunk-AL3UYZ5N.js";
+import "./chunk-RL6NEVXT.js";
+import "./chunk-PWPIERBM.js";
+import "./chunk-6MINUTGJ.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-MZWSOLMT.js";
+import "./chunk-AW4QUFQF.js";
+import "./chunk-C7HJ3NEI.js";
+import "./chunk-NB3LRY4T.js";
+import "./chunk-5FVVY2EB.js";
+import "./chunk-FFAZ2XFU.js";
+import "./chunk-JDSVLVCG.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-JAKIDQB2.js";
+import "./chunk-WQZZDN5M.js";
+import "./chunk-UI3NYK34.js";
+import "./chunk-GCGJW34D.js";
+import "./chunk-AREGMX2J.js";
+import "./chunk-3BTFBQLO.js";
+import "./chunk-LQWOFU6L.js";
+import "./chunk-P7FMDTKL.js";
+import "./chunk-ZN7SMKAK.js";
+import "./chunk-MRV7VSQK.js";
+import "./chunk-PCXDUHQH.js";
+import "./chunk-VUFL7X3H.js";
+import "./chunk-JUOZ62Y7.js";
+import "./chunk-LNEWDF2A.js";
+import "./chunk-T2JSUEH6.js";
+import "./chunk-VFUEZZBS.js";
+import "./chunk-YVGXH72Y.js";
+import "./chunk-3Q3N35W7.js";
+import "./chunk-ZEFVK7XC.js";
+import "./chunk-6KH5NLQS.js";
+import "./chunk-P2QRMMVQ.js";
+import "./chunk-2Z24E5W2.js";
+import "./chunk-BTTPKDIL.js";
+import "./chunk-46EST7JO.js";
+import "./chunk-G73MCJKL.js";
+import "./chunk-A2IYSXDQ.js";
+import "./chunk-B6O2YLUR.js";
+import "./chunk-7K5Q6COX.js";
+import "./chunk-LBLXEFWK.js";
+import "./chunk-RFYAYKTD.js";
+import "./chunk-YRLHEEQT.js";
+import "./chunk-FF4KLI5W.js";
+import "./chunk-JN72EPOE.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-VS2IYZRU.js";
+import "./chunk-KNA3BXXL.js";
+import "./chunk-NINSR6LX.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+//# sourceMappingURL=recall-navigation-operations.js.map

package/dist/recall-navigation-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigation-renderer.d.ts

@@ -0,0 +1,36 @@
+import { RecallNavigationResult } from './recall-navigation.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './types-Sps-lg5I.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './recall-state-view.js';
+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';
+import './local-llm-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+import './user-model.js';
+
+/**
+ * Shared markdown renderer for recall navigation (issue #1956).
+ *
+ * Rule 22: CLI text output, MCP `rendered`, and HTTP human output all
+ * render through this one module — never forked per surface.
+ * Deterministic: items in result order, budget and disclosure spend last.
+ */
+
+type NavigationRenderInput = RecallNavigationResult extends infer Result ? Result extends {
+    rendered: string;
+} ? Omit<Result, "rendered"> : never : never;
+declare function renderNavigationResult(result: NavigationRenderInput): string;
+
+export { renderNavigationResult };

package/dist/recall-navigation-renderer.js

@@ -0,0 +1,8 @@
+import {
+  renderNavigationResult
+} from "./chunk-KIW3OOZE.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  renderNavigationResult
+};
+//# sourceMappingURL=recall-navigation-renderer.js.map

package/dist/recall-navigation-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigation.d.ts

@@ -0,0 +1,121 @@
+import { RecallXrayDisclosureSummary } from './recall-xray.js';
+import { RecallNavigationConfig } from './recall-navigation-config.js';
+import { o as RecallDisclosure, M as MemoryFile } from './types-Sps-lg5I.js';
+import './memory-provenance.js';
+import './user-model.js';
+import './recall-state-view.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './contradiction-config.js';
+import './graph-path-scoring-config.js';
+import './background-generation-config.js';
+import './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './local-llm-config.js';
+import './semantic-merge-config.js';
+import './types-continuity.js';
+
+/**
+ * Recall navigation (issue #1956) — session-scoped follow-up tools over
+ * already-served recall results.
+ *
+ * Composes existing primitives; owns no new storage and no new link types:
+ *   - authority: the session's last `windowSnapshots` recall id sets
+ *     (`RecallHandleHistoryStore`, the same ring `resolveMemoryHandle` reads)
+ *   - isolation: every read resolves through the caller's resolved readable
+ *     namespace and ONE storage instance (pattern 30 — no arbitrary-id
+ *     fishing across namespaces)
+ *   - disclosure: `planDisclosureStep` enforces strictly-deeper expansion;
+ *     rendering reuses `shapeMemorySummary` (single formatter, rule 22)
+ *   - links: frontmatter `links` via `selectTraverseNeighbors`
+ *   - budget: per-call character cap drawn from the recall character budget,
+ *     with per-item disclosure/token spend reported through the SAME
+ *     disclosure accounting X-ray aggregates (`estimateRecallTokens` +
+ *     `summarizeDisclosureTokens`).
+ *
+ * Unknown, expired (outside the window), or foreign ids are rejected with a
+ * typed error naming the constraint (pattern 39) — never reinterpreted.
+ */
+
+/** Navigation reads touch only these storage members. */
+type NavigationStorage = Pick<StorageManagerLike, "dir" | "getMemoryById" | "readMemoriesWindow">;
+/** Structural stand-in so this module does not import StorageManager directly. */
+interface StorageManagerLike {
+    dir: string;
+    getMemoryById(id: string): Promise<MemoryFile | null>;
+    readMemoriesWindow(options?: {
+        maxMemories?: number;
+    }): Promise<{
+        memories: MemoryFile[];
+    }>;
+}
+/** Injected seams; the service supplies live wiring, tests supply doubles. */
+interface RecallNavigationDeps {
+    readonly config: RecallNavigationConfig;
+    /** Per-call character cap for the assembled response payload. */
+    readonly recallBudgetChars: number;
+    /** Served-id sets for a session, newest snapshot first. */
+    readonly recentServedIds: (sessionKey: string, depth: number) => ReadonlyArray<readonly string[]>;
+    readonly resolveReadableNamespace: (namespace: string | undefined, principal?: string) => string;
+    readonly getStorage: (namespace: string) => Promise<NavigationStorage>;
+}
+type NavigationAction = "expand" | "traverse" | "entity_neighbors";
+interface RecallNavigationRequest {
+    readonly action: NavigationAction;
+    /** Memory id (or `[m:xxxx]` handle) served to this session's recent recalls. */
+    readonly memoryId: string;
+    /** Session whose recall window authorizes the id. Required. */
+    readonly sessionKey: string;
+    readonly namespace?: string;
+    readonly authenticatedPrincipal?: string;
+    /** expand: target depth. Must be strictly deeper than the chunk default. */
+    readonly disclosure?: RecallDisclosure;
+    /** traverse: optional relation filter. */
+    readonly relation?: string;
+    /** traverse / entity_neighbors: optional result cap. */
+    readonly limit?: number;
+}
+interface NavigationItem {
+    readonly memoryId: string;
+    readonly path: string;
+    readonly disclosure: RecallDisclosure;
+    readonly estimatedTokens: number;
+    readonly preview: string;
+    /** Present when the disclosure level carries full content (expand). */
+    readonly content?: string;
+    /** Relation edge that produced this neighbor (traverse only). */
+    readonly linkType?: string;
+}
+type RecallNavigationError = "disabled" | "not_served" | "not_found" | "not_deeper" | "unknown_level" | "unknown_relation" | "invalid_limit";
+type RecallNavigationResult = {
+    ok: true;
+    action: NavigationAction;
+    memoryId: string;
+    namespace: string;
+    items: NavigationItem[];
+    truncated: boolean;
+    budget: {
+        chars: number;
+        used: number;
+    };
+    disclosureSpend: RecallXrayDisclosureSummary;
+    rendered: string;
+} | {
+    ok: false;
+    action: NavigationAction;
+    error: RecallNavigationError;
+    message: string;
+    rendered: string;
+};
+/**
+ * Run one navigation step. Throws {@link EngramAccessInputError} for caller
+ * faults (missing sessionKey, malformed limit); returns typed errors for
+ * domain refusals so MCP/HTTP/CLI render the constraint instead of a stack.
+ */
+declare function runRecallNavigation(deps: RecallNavigationDeps, request: RecallNavigationRequest): Promise<RecallNavigationResult>;
+
+export { type NavigationAction, type NavigationItem, type NavigationStorage, type RecallNavigationDeps, type RecallNavigationError, type RecallNavigationRequest, type RecallNavigationResult, runRecallNavigation };