@remnic/core 9.69.10 → 9.69.12

package/dist/corpus-watermark.js

@@ -9,29 +9,29 @@ import {
   computeServiceCorpusWatermarks,
   digestPartitionCensus,
   resolveCorpusNamespaceRoots
-} from "./chunk-I6DURYZI.js";
-import "./chunk-UGA6PZTX.js";
-import "./chunk-NGP2FPB2.js";
-import "./chunk-GS5IFIVE.js";
+} from "./chunk-XMIAU4CO.js";
+import "./chunk-P7LVYPIX.js";
+import "./chunk-4UVDLNHQ.js";
+import "./chunk-VYD63IFH.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-6FUMA6AA.js";
-import "./chunk-D35XLYQ7.js";
+import "./chunk-JGXMA6HL.js";
+import "./chunk-BE4Y6GK6.js";
+import "./chunk-N37X5RU7.js";
+import "./chunk-NNBZS3DY.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
+import "./chunk-W7IGLX4G.js";
 import "./chunk-6KTXE6A3.js";
-import "./chunk-RACZB5HT.js";
-import "./chunk-AG46P24C.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-XZBXINXZ.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-W7IGLX4G.js";
-import "./chunk-227UFSEQ.js";
-import "./chunk-ET356KSB.js";
+import "./chunk-LEPOP46W.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-ET356KSB.js";
 import "./chunk-S2V7RUCL.js";
-import "./chunk-XXW32OL7.js";
+import "./chunk-OYV6RKPM.js";
 import "./chunk-S2HLHAZ4.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-2GF27PGH.js";
@@ -40,8 +40,8 @@ import "./chunk-LDXUBPMO.js";
 import "./chunk-XSTNGNJP.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-LUDBXTBJ.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";

package/dist/cross-lingual-recall.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryFile } from './types-eM7QIcX2.js';
+import { M as MemoryFile } from './types-CLRTESSD.js';
 import { SearchDegradation } from './search/port.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -6,6 +6,7 @@ import './operator-doctor-types.js';
 import './external-wiki-config.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
+import './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/day-summary.d.ts

@@ -1,10 +1,11 @@
-import { P as PluginConfig, M as MemoryFile } from './types-eM7QIcX2.js';
+import { P as PluginConfig, M as MemoryFile } from './types-CLRTESSD.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 './deep-recall-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/deep-recall-config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Deep-recall config (issue #2332) — the `deepRecall` block.
+ *
+ * Parsed the same way `driftDetection` and `contradictionScan` are:
+ * shape-validated, string-coercion safe (§24), and honoring documented
+ * zero/no-op values (§33) rather than clamping them to something non-zero.
+ * `maxSteps: 0` disables the policy loop (seed-only retrieval);
+ * `maxResults: 0` returns an empty entry list; `maxExpandPerStep: 0`
+ * lets the policy pick EXPAND but select nothing. Millisecond fields
+ * of `0` mean "no timeout on that axis".
+ */
+interface DeepRecallConfig {
+    /** Master switch for the deep-recall surface. Default false. */
+    enabled: boolean;
+    /** Policy iterations; 0 disables the loop (seed-only). Default 4. */
+    maxSteps: number;
+    /** Per-step cap on frontier nodes pulled into the working set. Default 3. */
+    maxExpandPerStep: number;
+    /** Final working-set cap returned to the caller. Default 12. */
+    maxResults: number;
+    /** Per policy-call timeout in ms; 0 = none. Default 10000. */
+    stepTimeoutMs: number;
+    /** Whole-invocation wall-clock timeout in ms; 0 = none. Default 45000. */
+    totalTimeoutMs: number;
+}
+interface DeepRecallSettings {
+    deepRecall: DeepRecallConfig;
+}
+declare const DEEP_RECALL_CONFIG_DEFAULTS: DeepRecallConfig;
+declare function parseDeepRecallConfig(raw: unknown): DeepRecallConfig;
+
+export { DEEP_RECALL_CONFIG_DEFAULTS, type DeepRecallConfig, type DeepRecallSettings, parseDeepRecallConfig };

package/dist/deep-recall-config.js

@@ -0,0 +1,12 @@
+import {
+  DEEP_RECALL_CONFIG_DEFAULTS,
+  parseDeepRecallConfig
+} from "./chunk-M6RORUO5.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DEEP_RECALL_CONFIG_DEFAULTS,
+  parseDeepRecallConfig
+};
+//# sourceMappingURL=deep-recall-config.js.map

package/dist/deep-recall-http-glue.d.ts

@@ -0,0 +1,170 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { f as EngramAccessService } from './access-service-Baz5xW5X.js';
+import './types-CLRTESSD.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 './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+import './orchestrator-DglY1H0w.js';
+import './recall-state.js';
+import './utils/serialize-mutations.js';
+import './search/port.js';
+import './included-memories.js';
+import './briefing.js';
+import './storage-DmTbQdD0.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.js';
+import './model-registry.js';
+import './fallback-llm.js';
+import './resolve-provider-secret.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './maintenance-BBpNqEeJ.js';
+import './catalog-9X8WpZNO.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-BzCI6Kuu.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-BZGUecZf.js';
+import './namespaces/storage.js';
+import './threading.js';
+import './scope-profiles-BVvqVzJX.js';
+import './graph-444E-DrF.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
+import './recall-context-composition.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-DQ3Gscy5.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 './access-namespace-preflight-Cy0yPsaE.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 './explicit-capture.js';
+import './access-wearables-meetings-surface.js';
+import './deep-recall.js';
+import './graph-snapshot.js';
+import './access-offline-manifest.js';
+import './reconcile/manifest.js';
+import './reconcile/plan.js';
+import './capsule-cli.js';
+import './transfer/capsule-export.js';
+import './access-errors.js';
+
+/**
+ * Deep-recall HTTP glue (issue #2332) — route body lives here so
+ * access-http.ts stays at its structural ceiling (same seam as
+ * meetings/http-glue.ts and location/http-glue.ts).
+ *
+ * Input errors map to 400; everything else rethrows so backend faults keep
+ * flowing to the global 500 handler. `deepRecall.enabled` gating lives in
+ * EngramAccessService — this module only translates transport shape.
+ */
+
+type RespondJson = (res: ServerResponse, status: number, payload: unknown) => void;
+type ReadJsonBody = (req: IncomingMessage) => Promise<unknown>;
+declare function respondDeepRecall(req: IncomingMessage, res: ServerResponse, respondJson: RespondJson, readJsonBody: ReadJsonBody, service: EngramAccessService, 
+/**
+ * Resolve the caller scope for a body-supplied namespace/sessionKey. The
+ * body `namespace` is user-controlled, so it MUST flow through the SAME
+ * effective-namespace allow-list gate as the query-string value (issue
+ * #1850 finding 2 / #2332 review): a scoped bearer that passes an allowed
+ * `?namespace=` while setting a different `namespace` in the body would
+ * otherwise read another tenant. access-http supplies the gate and applies
+ * the query-string fallback, so this module never selects a namespace of
+ * its own. Throws 403 when the effective namespace is not permitted.
+ *
+ * `authenticatedPrincipal` is the identity the transport authenticated, and
+ * it MUST reach the service: authorization and the audit trail derive from
+ * the presenting principal, never from the client-supplied `sessionKey`.
+ * Dropping it let a crafted key matching another principal rule read that
+ * principal's namespaces, and made a legitimate namespace-enabled request
+ * with no session key fail as unauthenticated.
+ */
+scopeFor: (bodyNamespace?: string, bodySessionKey?: string) => {
+    namespace?: string;
+    sessionKey?: string;
+    authenticatedPrincipal?: string;
+}): Promise<void>;
+
+export { respondDeepRecall };

package/dist/deep-recall-http-glue.js

@@ -0,0 +1,31 @@
+import {
+  respondDeepRecall
+} from "./chunk-NN5CQTAJ.js";
+import "./chunk-NHLEFBE2.js";
+import "./chunk-7LCGFUMB.js";
+import "./chunk-X7Y7WX73.js";
+import "./chunk-WEHSQBFR.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-XJJYSX6F.js";
+import "./chunk-UI3NYK34.js";
+import "./chunk-GCGJW34D.js";
+import "./chunk-AREGMX2J.js";
+import "./chunk-NBP4EX5N.js";
+import "./chunk-LQWOFU6L.js";
+import "./chunk-P7FMDTKL.js";
+import "./chunk-2Z24E5W2.js";
+import "./chunk-ET2CNMLD.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-VS2IYZRU.js";
+import "./chunk-5UZXUTVO.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  respondDeepRecall
+};
+//# sourceMappingURL=deep-recall-http-glue.js.map

package/dist/deep-recall-http-glue.js.map

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

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

@@ -0,0 +1,144 @@
+import { K as McpTool } from './access-service-Baz5xW5X.js';
+import './types-CLRTESSD.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 './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+import './orchestrator-DglY1H0w.js';
+import './recall-state.js';
+import './utils/serialize-mutations.js';
+import './search/port.js';
+import './included-memories.js';
+import './briefing.js';
+import './storage-DmTbQdD0.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.js';
+import './model-registry.js';
+import './fallback-llm.js';
+import './resolve-provider-secret.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './maintenance-BBpNqEeJ.js';
+import './catalog-9X8WpZNO.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-BzCI6Kuu.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-BZGUecZf.js';
+import './namespaces/storage.js';
+import './threading.js';
+import './scope-profiles-BVvqVzJX.js';
+import './graph-444E-DrF.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
+import './recall-context-composition.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-DQ3Gscy5.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 './access-namespace-preflight-Cy0yPsaE.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 './explicit-capture.js';
+import './access-wearables-meetings-surface.js';
+import './deep-recall.js';
+import './graph-snapshot.js';
+import './access-offline-manifest.js';
+import './reconcile/manifest.js';
+import './reconcile/plan.js';
+import './capsule-cli.js';
+import './transfer/capsule-export.js';
+import './access-errors.js';
+
+/**
+ * Deep-recall MCP tool definition (issue #2332) — extracted from
+ * access-mcp.ts so the surface file stays at its structural ceiling.
+ * Spread back into `this.tools` (`...DEEP_RECALL_MCP_TOOLS`); the
+ * migrated-operation mapping spreads into MCP_MIGRATED_OPERATIONS.
+ * The `remnic.` canonical alias is minted by withToolAliases at
+ * tools/list time (same as meetings).
+ */
+
+declare const DEEP_RECALL_MCP_TOOLS: McpTool[];
+
+export { DEEP_RECALL_MCP_TOOLS };

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

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

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

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

package/dist/deep-recall-policy-llm.d.ts

@@ -0,0 +1,37 @@
+import { FallbackLlmClient } from './fallback-llm.js';
+import { LocalLlmClient } from './local-llm.js';
+import { P as PluginConfig } from './types-CLRTESSD.js';
+import './resolve-provider-secret.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 './deep-recall-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+import './model-registry.js';
+
+/**
+ * Policy-call LLM routing for deep recall (issue #2332).
+ *
+ * Mirrors `extraction-judge.ts` `callJudgeLlm` exactly: local client first
+ * (json_object response format) unless modelSource is "gateway", then the
+ * fallback client with the shared background-task chain options. Never a
+ * raw OpenAI client. Returns null when both legs fail — the loop treats
+ * that as a stop, never a crash.
+ */
+
+declare const DEEP_RECALL_POLICY_SYSTEM_PROMPT = "You are the retrieval policy for a long-term memory system. Given the question, the current working set of retrieved memories, and the frontier of anchor-linked candidates, choose exactly one action: REFINE (rewrite the query), EXPAND (follow named frontier nodes), or STOP. Respond with JSON only.";
+declare function callDeepRecallPolicyLlm(input: {
+    statePrompt: string;
+    config: PluginConfig;
+    localLlm: LocalLlmClient | null;
+    fallbackLlm: FallbackLlmClient | null;
+    timeoutMs: number;
+}): Promise<string | null>;
+
+export { DEEP_RECALL_POLICY_SYSTEM_PROMPT, callDeepRecallPolicyLlm };

package/dist/deep-recall-policy-llm.js

@@ -0,0 +1,19 @@
+import {
+  DEEP_RECALL_POLICY_SYSTEM_PROMPT,
+  callDeepRecallPolicyLlm
+} from "./chunk-DXFG2VGN.js";
+import "./chunk-JALOAKSZ.js";
+import "./chunk-QIEUU4UK.js";
+import "./chunk-L2EXJQJP.js";
+import "./chunk-45GF7Y3V.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-N7RWREIQ.js";
+import "./chunk-EYIEWJNI.js";
+import "./chunk-JUC24CTX.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DEEP_RECALL_POLICY_SYSTEM_PROMPT,
+  callDeepRecallPolicyLlm
+};
+//# sourceMappingURL=deep-recall-policy-llm.js.map

package/dist/deep-recall-policy-llm.js.map

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

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

@@ -0,0 +1,16 @@
+import { DeepRecallResult } from './deep-recall.js';
+import './abstraction-nodes.js';
+import './cue-anchors.js';
+import './deep-recall-config.js';
+
+/**
+ * Shared markdown renderer for deep recall (issue #2332).
+ *
+ * Rule 22 (AGENTS.md): never fork formatting — CLI text output, MCP text
+ * output, and any later surface all render through this one module.
+ * Deterministic: entries in result order, trace in step order.
+ */
+
+declare function renderDeepRecallResult(result: DeepRecallResult): string;
+
+export { renderDeepRecallResult };

package/dist/deep-recall-renderer.js

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

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

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

package/dist/deep-recall-seeds.d.ts

@@ -0,0 +1,83 @@
+import { DeepRecallSeedHit } from './deep-recall.js';
+import { SearchDegradation } from './search/port.js';
+import './abstraction-nodes.js';
+import './cue-anchors.js';
+import './deep-recall-config.js';
+import './types-CLRTESSD.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 './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+
+/**
+ * Deep-recall seed retrieval (issue #2332 review).
+ *
+ * Seeds route through the SAME namespace search router the rest of the read
+ * path uses, so a non-default caller searches its own suffixed collection
+ * instead of the base (default-namespace) collection — read and write resolve
+ * through one resolver, never two (§30).
+ *
+ * Each hit is resolved to a real memory id through the shared QMD result
+ * resolver (`QmdResultResolver.readQmdResultMemory`), per hit and bounded by
+ * the requested limit, instead of pre-scanning the whole namespace corpus to
+ * build a path index. With namespaces disabled the fanout queries the QMD
+ * backend directly, so hits keep the indexer's raw path forms; the resolver
+ * decodes `qmd://<collection>/` URIs and `<collection>/`-prefixed relatives,
+ * and the two forms it cannot decode (`qmd:///`, a leading `/`) are stripped
+ * for one retry. A hit with no path is dropped: its namespace membership
+ * cannot be verified, and a bare docid from a foreign collection must never
+ * enter the working set as a resolved memory.
+ *
+ * An unavailable namespace backend (or a missing collection) contributes an
+ * empty result set and reports itself only through `execution.onDegradation`,
+ * so the observer is REQUIRED here: without it a dead index is indistinguishable
+ * from a healthy empty one and deep recall would answer `ok: true` with zero
+ * entries instead of the advertised `backend_unavailable` failure.
+ */
+
+/** Namespace-scoped search entrypoint (satisfied by `Orchestrator.searchAcrossNamespaces`). */
+interface DeepRecallSeedRouter {
+    searchAcrossNamespaces(options: {
+        query: string;
+        namespaces: string[];
+        maxResults?: number;
+        execution?: {
+            onDegradation?: (degradation: SearchDegradation) => void;
+        };
+    }): Promise<ReadonlyArray<{
+        path?: string;
+        docid?: string;
+        score?: number;
+    }>>;
+}
+/** Namespace-scoped storage read (satisfied by `StorageManager`). */
+interface DeepRecallSeedStorage {
+    readonly dir: string;
+    readMemoryByPath(filePath: string): Promise<{
+        frontmatter: {
+            id?: string;
+        };
+    } | null>;
+}
+/** Full QMD hit -> memory resolver (satisfied by `QmdResultResolver#readQmdResultMemory`). */
+interface DeepRecallSeedResultResolver {
+    readQmdResultMemory(resultPath: string, fallbackStorage: DeepRecallSeedStorage, recallNamespaces?: readonly string[], preferredNamespace?: string): Promise<{
+        frontmatter: {
+            id?: string;
+        };
+    } | null>;
+}
+declare function createDeepRecallSeedSearch(deps: {
+    namespace: string;
+    storage: DeepRecallSeedStorage;
+    router: DeepRecallSeedRouter;
+    resolver: DeepRecallSeedResultResolver;
+}): (query: string, limit: number) => Promise<DeepRecallSeedHit[]>;
+
+export { type DeepRecallSeedResultResolver, type DeepRecallSeedRouter, type DeepRecallSeedStorage, createDeepRecallSeedSearch };