@remnic/core 9.69.9 → 9.69.11

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-Cqfk3dD1.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-Cqfk3dD1.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 };

package/dist/deep-recall-seeds.js

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

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

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

package/dist/deep-recall.d.ts

@@ -0,0 +1,97 @@
+import { AbstractionNode } from './abstraction-nodes.js';
+import { CueAnchor } from './cue-anchors.js';
+import { DeepRecallConfig } from './deep-recall-config.js';
+
+/**
+ * Budgeted deep-recall loop (issue #2332, harmonic series P4).
+ *
+ * REFINE / EXPAND / STOP retrieval over the abstraction-node + cue-anchor
+ * graph built by issue #2329, blended with QMD search. This is the deep
+ * surface ONLY — never wired into `before_prompt_build` or any recall
+ * section (that latency disqualifies the hot path; see the issue).
+ *
+ * The loop is dependency-injected: seeding, graph loading, memory loading,
+ * and the policy LLM call arrive as `DeepRecallDeps`, so the loop is
+ * deterministic under a scripted fake policy (tests) and thin when the
+ * access service wires real deps. Pure decision helpers are reused from
+ * the `recall-deep-*` primitives — never re-implemented here.
+ */
+
+interface DeepRecallEntry {
+    memoryId: string;
+    /** Trimmed to 500 chars for state rendering; full content only in final output. */
+    content: string;
+    /** Seed similarity, or expansion inheritance (parent score * 0.8). */
+    score: number;
+    origin: "seed" | "refine" | "expand";
+    /** anchorValue that linked the entry, when origin === "expand". */
+    viaAnchor?: string;
+}
+interface DeepRecallFrontierItem {
+    nodeId: string;
+    title: string;
+    /** e.g. `shares anchor "<anchorValue>" with <memoryId>`. */
+    reason: string;
+    sharedAnchorCount: number;
+    /** Working-set memory the anchor was shared with; drives expansion scoring. */
+    parentMemoryId: string;
+    parentScore: number;
+    anchorValue: string;
+}
+interface DeepRecallTraceStep {
+    step: number;
+    action: "REFINE" | "EXPAND" | "STOP" | "BUDGET_EXHAUSTED";
+    /** Rewritten query, chosen nodeIds, or stop reason. */
+    detail: string;
+    workingSetSize: number;
+    frontierSize: number;
+    durationMs: number;
+}
+interface DeepRecallResult {
+    /** false only for backend failure — NEVER conflated with empty (§22). */
+    ok: boolean;
+    error?: "backend_unavailable" | "timeout" | "disabled";
+    entries: DeepRecallEntry[];
+    trace: DeepRecallTraceStep[];
+}
+interface DeepRecallGraphSnapshot {
+    nodes: AbstractionNode[];
+    anchors: CueAnchor[];
+}
+interface DeepRecallSeedHit {
+    memoryId: string;
+    score: number;
+}
+type DeepRecallSeedResult = {
+    ok: true;
+    results: DeepRecallSeedHit[];
+} | {
+    ok: false;
+    error: "backend_unavailable";
+};
+interface DeepRecallMemoryView {
+    memoryId: string;
+    content: string;
+    active: boolean;
+}
+interface DeepRecallDeps {
+    config: DeepRecallConfig;
+    /** QMD (or equivalent) seed search. A thrown error means backend failure. */
+    searchSeed(query: string, limit: number): Promise<DeepRecallSeedHit[]>;
+    /** Nodes + anchors, loaded once per invocation. */
+    loadGraph(): Promise<DeepRecallGraphSnapshot>;
+    /** Namespace-scoped memory-by-id read; null when absent from the caller's namespace (§30). */
+    loadMemory(memoryId: string): Promise<DeepRecallMemoryView | null>;
+    /** Raw policy LLM output (JSON text); null when the call failed. */
+    callPolicy(statePrompt: string, timeoutMs: number): Promise<string | null>;
+    nowMs?(): number;
+}
+/**
+ * The budgeted loop. Seed (QMD + graph) -> policy steps -> ranked, capped
+ * output. Only a SEED backend failure returns `ok: false`; timeout and
+ * budget exhaustion mid-loop return the partial working set with
+ * `ok: true` and a BUDGET_EXHAUSTED trace tail.
+ */
+declare function runBudgetedDeepRecall(deps: DeepRecallDeps, query: string): Promise<DeepRecallResult>;
+
+export { DeepRecallConfig, type DeepRecallDeps, type DeepRecallEntry, type DeepRecallFrontierItem, type DeepRecallGraphSnapshot, type DeepRecallMemoryView, type DeepRecallResult, type DeepRecallSeedHit, type DeepRecallSeedResult, type DeepRecallTraceStep, runBudgetedDeepRecall };

package/dist/deep-recall.js

@@ -0,0 +1,13 @@
+import {
+  runBudgetedDeepRecall
+} from "./chunk-S5G2LAL7.js";
+import "./chunk-HRATODNO.js";
+import "./chunk-WTWQA7BB.js";
+import "./chunk-VZIAVM72.js";
+import "./chunk-RGMVMVMF.js";
+import "./chunk-G73MCJKL.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  runBudgetedDeepRecall
+};
+//# sourceMappingURL=deep-recall.js.map

package/dist/deep-recall.js.map

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