@remnic/core 9.69.61 → 9.69.64

package/dist/{chunk-M4PHCEPU.js → chunk-DDY7LJMP.js}

@@ -1,7 +1,7 @@
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES
-} from "./chunk-WD32KTVI.js";
+} from "./chunk-2ZVSQPAA.js";
 import {
   SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH
 } from "./chunk-PWPIERBM.js";
@@ -343,4 +343,4 @@ export {
   parseSupportPassportModelJob,
   SupportPassportModelBridge
 };
-//# sourceMappingURL=chunk-M4PHCEPU.js.map
+//# sourceMappingURL=chunk-DDY7LJMP.js.map

package/dist/{chunk-2L5DIVDU.js → chunk-DT33WNG2.js}

@@ -43,13 +43,13 @@ import {
 } from "./chunk-AB3A7EFH.js";
 import {
   applyToolOutputSchemas
-} from "./chunk-ZOASYXBS.js";
+} from "./chunk-MY2PLXSM.js";
 import {
   getOperation
-} from "./chunk-WD32KTVI.js";
+} from "./chunk-2ZVSQPAA.js";
 import {
   WHO_KNOWS_MCP_TOOLS
-} from "./chunk-HNOKNHFO.js";
+} from "./chunk-7L747CFR.js";
 import {
   PROMOTION_CANDIDATES_MCP_TOOLS
 } from "./chunk-VYCOJKSX.js";
@@ -4004,4 +4004,4 @@ export {
   MCP_MIGRATED_OPERATIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-2L5DIVDU.js.map
+//# sourceMappingURL=chunk-DT33WNG2.js.map

package/dist/{chunk-SZAWZPY6.js → chunk-E7SKAUEW.js}

@@ -3,7 +3,7 @@ import {
   readNamespaceMaintenanceLastRanStatuses,
   readNamespaceMaintenanceStatuses,
   runNamespaceMaintenancePlan
-} from "./chunk-B5GMOOY2.js";
+} from "./chunk-5AABWM72.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -14,7 +14,7 @@ import {
 } from "./chunk-CMTINOFS.js";
 import {
   summarizeCorpusAndReplica
-} from "./chunk-GMHWCPLP.js";
+} from "./chunk-GZLSIPYU.js";
 import {
   readJudgeVerdictStats
 } from "./chunk-OZKOPQCM.js";
@@ -41,14 +41,14 @@ import {
 } from "./chunk-2PKGJPQL.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-KRPMISWO.js";
+} from "./chunk-5C765XYU.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-LMLPLIT4.js";
+} from "./chunk-AQ6IBVFQ.js";
 import {
   listNamespaces
-} from "./chunk-QEGKMZNQ.js";
+} from "./chunk-FO5NDQZH.js";
 import {
   analyzeGraphHealth
 } from "./chunk-GWK7FEUL.js";
@@ -57,7 +57,7 @@ import {
 } from "./chunk-3SG4FGDV.js";
 import {
   StorageManager
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
@@ -1683,4 +1683,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-SZAWZPY6.js.map
+//# sourceMappingURL=chunk-E7SKAUEW.js.map

package/dist/{chunk-NRVGODSE.js → chunk-EK4MOTHM.js}

@@ -1,21 +1,21 @@
 import {
   RemoteSearchBackend
-} from "./chunk-WPGR3RW4.js";
+} from "./chunk-7VO6E5UD.js";
 import {
   EmbedHelper
 } from "./chunk-Z4TXB4K7.js";
 import {
   LanceDbBackend
-} from "./chunk-D7MAYFQP.js";
+} from "./chunk-S7LWX2PQ.js";
 import {
   MeilisearchBackend
-} from "./chunk-KVO2BTA4.js";
+} from "./chunk-T2YX56QI.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
 import {
   OramaBackend
-} from "./chunk-G6NQ3L4T.js";
+} from "./chunk-T3FMRLWQ.js";
 import {
   createConversationIndexBackend
 } from "./chunk-TFA6HPOA.js";
@@ -24,7 +24,7 @@ import {
 } from "./chunk-F4TWWUMP.js";
 import {
   QmdClient
-} from "./chunk-KG2OOAFF.js";
+} from "./chunk-3NTVCMDD.js";
 import {
   resolveIndexingCapabilities,
   resolvePipelineProcessingCapabilities,
@@ -179,4 +179,4 @@ export {
   createConversationSearchBackend,
   createConversationIndexRuntime
 };
-//# sourceMappingURL=chunk-NRVGODSE.js.map
+//# sourceMappingURL=chunk-EK4MOTHM.js.map

package/dist/{chunk-QEGKMZNQ.js → chunk-FO5NDQZH.js}

@@ -1,9 +1,9 @@
 import {
   NamespaceStorageRouter
-} from "./chunk-G4WZDQ32.js";
+} from "./chunk-3NG5OOCX.js";
 import {
   namespaceCollectionName
-} from "./chunk-JTTLH646.js";
+} from "./chunk-C2W6JKQQ.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-PCXDUHQH.js";
@@ -213,4 +213,4 @@ export {
   verifyNamespaces,
   runNamespaceMigration
 };
-//# sourceMappingURL=chunk-QEGKMZNQ.js.map
+//# sourceMappingURL=chunk-FO5NDQZH.js.map

package/dist/chunk-G26YNEOC.js

@@ -0,0 +1,37 @@
+// src/search/port.ts
+function reportSearchDegradation(execution, degradation) {
+  try {
+    execution?.onDegradation?.(degradation);
+  } catch {
+  }
+}
+var FATAL_SEARCH_DEGRADATION_CODES = Object.freeze({
+  backend_unavailable: true,
+  backend_error: true,
+  daemon_timeout: true,
+  daemon_loading: true,
+  subprocess_error: true,
+  deadline_exceeded: true,
+  remote_error: true
+});
+function fatalSearchDegradations(degradations) {
+  return degradations.filter((d) => FATAL_SEARCH_DEGRADATION_CODES[d.code] === true);
+}
+function describeSearchDegradations(degradations) {
+  return degradations.map((d) => `${d.backend}:${d.code}${d.detail !== void 0 ? ` (${d.detail})` : ""}`).join("; ");
+}
+function resolveEnsureCollectionArgs(collectionOrExecution, execution) {
+  if (typeof collectionOrExecution === "string") {
+    return { collection: collectionOrExecution, execution };
+  }
+  return { collection: void 0, execution: collectionOrExecution ?? execution };
+}
+
+export {
+  reportSearchDegradation,
+  FATAL_SEARCH_DEGRADATION_CODES,
+  fatalSearchDegradations,
+  describeSearchDegradations,
+  resolveEnsureCollectionArgs
+};
+//# sourceMappingURL=chunk-G26YNEOC.js.map

package/dist/chunk-G26YNEOC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search/port.ts"],"sourcesContent":["import type { QmdSearchResult } from \"../types.js\";\n\n/** Alias so consumers don't need to reference \"Qmd\" in a backend-agnostic context. */\nexport type SearchResult = QmdSearchResult;\n\nexport interface SearchQueryOptions {\n  intent?: string;\n  explain?: boolean;\n  candidateLimit?: number;\n  rerank?: boolean;\n  chunkStrategy?: \"auto\" | \"regex\";\n  structuredSearches?: Array<{ type: \"lex\" | \"vec\" | \"hyde\"; query: string }>;\n}\n\n/**\n * A search that returned empty (or partial) results because the backend was\n * unavailable, still loading, or timed out — cases that are otherwise\n * indistinguishable from a genuine \"no matches\" (issue #1536, CLAUDE.md\n * rule 34).\n */\nexport interface SearchDegradation {\n  backend: \"qmd\" | \"remote\" | \"meilisearch\" | \"orama\" | \"lancedb\";\n  code:\n    | \"backend_unavailable\"\n    | \"backend_error\"\n    | \"daemon_timeout\"\n    | \"daemon_loading\"\n    | \"subprocess_error\"\n    | \"deadline_exceeded\"\n    | \"remote_error\"\n    | \"vector_tier_unavailable\";\n  detail?: string;\n}\n\nexport interface SearchExecutionOptions {\n  signal?: AbortSignal;\n  /**\n   * Observer invoked when the backend degrades during this call (#1536).\n   * Callers that need to distinguish empty-because-degraded from\n   * empty-because-no-matches (recall x-ray, fallback decisions) pass a\n   * collector here. Observer failures are swallowed by the notifier —\n   * observability must never break search.\n   */\n  onDegradation?: (degradation: SearchDegradation) => void;\n}\n\nexport function reportSearchDegradation(\n  execution: SearchExecutionOptions | undefined,\n  degradation: SearchDegradation\n): void {\n  try {\n    execution?.onDegradation?.(degradation);\n  } catch {\n    // Observability must never break search.\n  }\n}\n\n/**\n * Codes that mean the search backend could NOT answer, so an empty\n * result set carries no information (issue #3082 / recall_why #3033).\n * `vector_tier_unavailable` is excluded on purpose: the lexical tier\n * still answered, so the result set is degraded but real.\n */\nexport const FATAL_SEARCH_DEGRADATION_CODES: Readonly<\n  Partial<Record<SearchDegradation[\"code\"], true>>\n> = Object.freeze({\n  backend_unavailable: true,\n  backend_error: true,\n  daemon_timeout: true,\n  daemon_loading: true,\n  subprocess_error: true,\n  deadline_exceeded: true,\n  remote_error: true,\n});\n\nexport function fatalSearchDegradations(\n  degradations: readonly SearchDegradation[],\n): SearchDegradation[] {\n  return degradations.filter((d) => FATAL_SEARCH_DEGRADATION_CODES[d.code] === true);\n}\n\nexport function describeSearchDegradations(\n  degradations: readonly SearchDegradation[],\n): string {\n  return degradations\n    .map((d) => `${d.backend}:${d.code}${d.detail !== undefined ? ` (${d.detail})` : \"\"}`)\n    .join(\"; \");\n}\n\nexport function resolveEnsureCollectionArgs(\n  collectionOrExecution?: string | SearchExecutionOptions,\n  execution?: SearchExecutionOptions\n): { collection?: string; execution?: SearchExecutionOptions } {\n  if (typeof collectionOrExecution === \"string\") {\n    return { collection: collectionOrExecution, execution };\n  }\n  return { collection: undefined, execution: collectionOrExecution ?? execution };\n}\n\n/**\n * Optional status report for search backends that track embedding backlog.\n * Backends without embedding pipelines return null from status().\n */\nexport interface SearchBackendStatus {\n  pendingEmbeddings: number | null;\n  oldestPendingAgeMs: number | null;\n  totalFiles: number | null;\n  embeddedFiles: number | null;\n}\n\n/**\n * Abstract search backend interface.\n *\n * Implementations:\n * - QmdClient (default, local hybrid BM25+vector+reranking)\n * - OramaBackend (embedded, pure JS, hybrid FTS+vector)\n * - LanceDbBackend (embedded, native Arrow bindings, RRF reranking)\n * - MeilisearchBackend (server-based SDK, hybrid search)\n * - RemoteSearchBackend (HTTP REST adapter)\n * - NoopSearchBackend (graceful degradation)\n *\n * See docs/writing-a-search-backend.md for the implementation guide.\n */\nexport interface SearchBackend {\n  // ── Lifecycle ──\n  probe(execution?: SearchExecutionOptions): Promise<boolean>;\n  /**\n   * Optional non-mutating availability probe for health/readiness checks.\n   * Implementations must avoid auto-upgrades, collection creation, daemon\n   * startup, or any other runtime-modifying side effects.\n   */\n  checkAvailability?(execution?: SearchExecutionOptions): Promise<boolean>;\n  isAvailable(): boolean;\n  debugStatus(): string;\n  /** Optional embedding backlog status for health surfaces. */\n  status?(): Promise<SearchBackendStatus>;\n\n  // ── Search ──\n  search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    options?: SearchQueryOptions,\n    execution?: SearchExecutionOptions\n  ): Promise<SearchResult[]>;\n  searchGlobal(query: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]>;\n  bm25Search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions\n  ): Promise<SearchResult[]>;\n  vectorSearch(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions\n  ): Promise<SearchResult[]>;\n  hybridSearch(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions\n  ): Promise<SearchResult[]>;\n\n  // ── Maintenance ──\n  update(execution?: SearchExecutionOptions): Promise<void>;\n  /**\n   * Wall-clock ms of the most recent SUCCESSFUL index refresh, or null when the\n   * backend has never run one. Ordinary update() is fail-open: it returns\n   * silently (without throwing or advancing this timestamp) when the backend is\n   * unavailable or the call is suppressed by a min-interval / failure backoff.\n   * Callers that must know whether update() actually indexed — so they can\n   * invalidate dependent caches only on a real refresh — snapshot this before\n   * the call and treat the backend as refreshed iff the value advanced. Optional\n   * because not every backend tracks it; absent means \"assume refreshed\".\n   */\n  readonly lastUpdateRanAtMs?: number | null;\n  /**\n   * Optional strict refresh used by callers that must know whether the backend\n   * was actually refreshed before writing success markers. Ordinary update\n   * calls remain fail-open for migration/maintenance resilience.\n   */\n  updateStrict?(execution?: SearchExecutionOptions): Promise<void>;\n  updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  updateCollectionFromDir?(collection: string, memoryDir: string, execution?: SearchExecutionOptions): Promise<void>;\n  /**\n   * True when update() refreshes every indexed collection, not just this\n   * backend's configured collection. Namespace routers use this to avoid\n   * repeating the same expensive global update once per namespace.\n   */\n  updatesAllCollections?(): boolean;\n  /**\n   * Optional strict refresh used by callers that must know whether a collection\n   * was actually refreshed before writing success markers. Ordinary update\n   * calls remain fail-open for migration/maintenance resilience.\n   */\n  updateCollectionStrict?(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  embed(): Promise<void>;\n  /**\n   * Optional strict embed used by callers that must know vectors were actually\n   * refreshed before writing success markers.\n   */\n  embedStrict?(): Promise<void>;\n  embedCollection(collection: string): Promise<void>;\n  /**\n   * Optional strict collection embed used by callers that must know vectors were\n   * actually refreshed before writing success markers.\n   */\n  embedCollectionStrict?(collection: string): Promise<void>;\n\n  // ── Collection management ──\n  /**\n   * True only when the backend can bind, isolate, search, and delete collections\n   * outside Remnic's primary memory roots.\n   */\n  supportsAdditionalCollections?(): boolean;\n  /**\n   * Prevent a collection from participating in unscoped/global searches.\n   * Dedicated corpora must call this immediately after collection creation.\n   */\n  excludeCollectionFromGlobalSearch?(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  /** Remove a non-primary collection and its backend-owned index state. */\n  deleteCollection?(collection: string, execution?: SearchExecutionOptions): Promise<boolean>;\n  /** Canonical source root currently bound to a named collection. */\n  collectionRoot?(collection: string, execution?: SearchExecutionOptions): Promise<string | null>;\n  /** Collection-scoped status for observability surfaces. */\n  collectionStatus?(collection: string): Promise<Pick<SearchBackendStatus, \"totalFiles\">>;\n  /**\n   * Optional non-mutating collection probe. Backends that can distinguish a\n   * missing collection from a transient probe failure should implement this so\n   * callers can avoid auto-creating collections in unsafe layouts.\n   */\n  checkCollection?(\n    collectionOrExecution?: string | SearchExecutionOptions,\n    execution?: SearchExecutionOptions\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  ensureCollection(\n    memoryDir: string,\n    execution?: SearchExecutionOptions\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  ensureCollection(\n    memoryDir: string,\n    collection?: string,\n    execution?: SearchExecutionOptions\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n}\n"],"mappings":";AA8CO,SAAS,wBACd,WACA,aACM;AACN,MAAI;AACF,eAAW,gBAAgB,WAAW;AAAA,EACxC,QAAQ;AAAA,EAER;AACF;AAQO,IAAM,iCAET,OAAO,OAAO;AAAA,EAChB,qBAAqB;AAAA,EACrB,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,cAAc;AAChB,CAAC;AAEM,SAAS,wBACd,cACqB;AACrB,SAAO,aAAa,OAAO,CAAC,MAAM,+BAA+B,EAAE,IAAI,MAAM,IAAI;AACnF;AAEO,SAAS,2BACd,cACQ;AACR,SAAO,aACJ,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,IAAI,EAAE,IAAI,GAAG,EAAE,WAAW,SAAY,KAAK,EAAE,MAAM,MAAM,EAAE,EAAE,EACpF,KAAK,IAAI;AACd;AAEO,SAAS,4BACd,uBACA,WAC6D;AAC7D,MAAI,OAAO,0BAA0B,UAAU;AAC7C,WAAO,EAAE,YAAY,uBAAuB,UAAU;AAAA,EACxD;AACA,SAAO,EAAE,YAAY,QAAW,WAAW,yBAAyB,UAAU;AAChF;","names":[]}

package/dist/{chunk-GMHWCPLP.js → chunk-GZLSIPYU.js}

@@ -4,7 +4,7 @@ import {
 import {
   computeCorpusWatermarks,
   resolveCorpusNamespaceRoots
-} from "./chunk-CDQO5DCD.js";
+} from "./chunk-TO3G56GM.js";
 
 // src/operator-doctor-corpus.ts
 var DIGEST_PREFIX_LENGTH = 12;
@@ -78,4 +78,4 @@ export {
   corpusWatermarksFromCheck,
   summarizeCorpusAndReplica
 };
-//# sourceMappingURL=chunk-GMHWCPLP.js.map
+//# sourceMappingURL=chunk-GZLSIPYU.js.map

package/dist/{chunk-ZFUPRODV.js → chunk-HPWJ5B7D.js}

@@ -4,6 +4,10 @@ import {
   composeMissingMemoryContext,
   composeRecallContext
 } from "./chunk-NVKO5YKP.js";
+import {
+  describeSearchDegradations,
+  fatalSearchDegradations
+} from "./chunk-G26YNEOC.js";
 import {
   isAbortError
 } from "./chunk-BTTPKDIL.js";
@@ -31,16 +35,48 @@ function compactRecallContextFromBuckets(buckets) {
   return sections.join(RECALL_CONTEXT_SEPARATOR);
 }
 function decideRecallContextComposition(input) {
-  const composition = boundRecallContextComposition({
+  const observed = input.backendDegradations ?? [];
+  const qmdExpected = input.qmdExpected !== false;
+  const fatal = fatalSearchDegradations(observed).filter(
+    (d) => qmdExpected || d.backend !== "qmd" || d.code !== "backend_unavailable"
+  );
+  if (fatal.length > 0 && input.context.trim().length === 0) {
+    const missing = composeMissingMemoryContext({
+      detail: describeSearchDegradations(fatal)
+    });
+    const composition2 = input.footer ? { ...missing, footer: input.footer } : missing;
+    return {
+      composition: composition2,
+      context: composeRecallContext(composition2),
+      truncated: false
+    };
+  }
+  const bounded = boundRecallContextComposition({
     context: input.context,
     footer: input.footer,
     maxChars: input.maxChars,
     compactContext: input.compactContext
   });
+  if (fatal.length === 0) {
+    return {
+      composition: bounded,
+      context: composeRecallContext(bounded),
+      truncated: bounded.degradation?.reason === "budget-clipped" || bounded.degradation?.reason === "budget-compacted"
+    };
+  }
+  const composition = {
+    ...bounded,
+    degradation: {
+      state: "degraded",
+      reason: "backend-unavailable",
+      detail: describeSearchDegradations(fatal),
+      ...bounded.degradation?.budget ? { budget: bounded.degradation.budget } : {}
+    }
+  };
   return {
     composition,
     context: composeRecallContext(composition),
-    truncated: composition.degradation?.reason === "budget-clipped" || composition.degradation?.reason === "budget-compacted"
+    truncated: bounded.degradation?.reason === "budget-clipped" || bounded.degradation?.reason === "budget-compacted"
   };
 }
 function notifyContextComposition(onContextComposition, composition, onError) {
@@ -66,4 +102,4 @@ export {
   notifyContextComposition,
   recallFailureComposition
 };
-//# sourceMappingURL=chunk-ZFUPRODV.js.map
+//# sourceMappingURL=chunk-HPWJ5B7D.js.map

package/dist/chunk-HPWJ5B7D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-composition-decision.ts"],"sourcesContent":["/**\n * Recall composition decision (#2972 layer 2).\n *\n * Extracted from recall-internal so that file stays under its ratchet\n * ceiling. Classifies injected memory context as complete / degraded /\n * missing, builds the compact (first-line) form from section buckets,\n * and turns outer-recall failures into the missing-note instead of \"\".\n */\n\nimport { isAbortError } from \"./abort-error.js\";\nimport {\n  boundRecallContextComposition,\n  composeMissingMemoryContext,\n  composeRecallContext,\n  RECALL_CONTEXT_SEPARATOR,\n  type RecallContextComposition,\n} from \"./recall-context-composition.js\";\nimport {\n  describeSearchDegradations,\n  fatalSearchDegradations,\n  type SearchDegradation,\n} from \"./search/port.js\";\n\nexport type RecallCompositionChunk = string | { readonly content: string };\n\nexport interface DecideRecallContextCompositionInput {\n  context: string;\n  compactContext?: string;\n  footer?: string;\n  maxChars: number;\n  /** Mid-recall backend degradations (#3082). Absent on the healthy path. */\n  backendDegradations?: readonly SearchDegradation[];\n  /**\n   * When false, `{ backend: \"qmd\", code: \"backend_unavailable\" }` is the\n   * QMD-disabled/noop skip marker, not an outage. Other backends still count.\n   * Default true so unit tests that pass degradations stay honest.\n   */\n  qmdExpected?: boolean;\n}\n\nexport interface DecidedRecallContextComposition {\n  composition: RecallContextComposition;\n  context: string;\n  truncated: boolean;\n}\n\nfunction firstLine(content: string): string {\n  const trimmed = content.trim();\n  if (trimmed.length === 0) return \"\";\n  const newline = trimmed.indexOf(\"\\n\");\n  return newline === -1 ? trimmed : trimmed.slice(0, newline).trimEnd();\n}\n\nfunction chunkContent(chunk: RecallCompositionChunk): string {\n  return typeof chunk === \"string\" ? chunk : chunk.content;\n}\n\n/**\n * Shallow form of every section chunk: the first line of each entry,\n * so a budget miss prefers breadth-complete-but-shallow over a clipped\n * tail. Empty chunks contribute nothing.\n */\nexport function compactRecallContextFromBuckets(\n  buckets: Iterable<readonly [unknown, readonly RecallCompositionChunk[]]>,\n): string {\n  const sections: string[] = [];\n  for (const [, chunks] of buckets) {\n    const lines: string[] = [];\n    for (const chunk of chunks) {\n      const line = firstLine(chunkContent(chunk));\n      if (line.length > 0) lines.push(line);\n    }\n    if (lines.length > 0) sections.push(lines.join(\"\\n\"));\n  }\n  return sections.join(RECALL_CONTEXT_SEPARATOR);\n}\n\nexport function decideRecallContextComposition(\n  input: DecideRecallContextCompositionInput,\n): DecidedRecallContextComposition {\n  const observed = input.backendDegradations ?? [];\n  const qmdExpected = input.qmdExpected !== false;\n  const fatal = fatalSearchDegradations(observed).filter(\n    (d) => qmdExpected || d.backend !== \"qmd\" || d.code !== \"backend_unavailable\",\n  );\n  if (fatal.length > 0 && input.context.trim().length === 0) {\n    const missing = composeMissingMemoryContext({\n      detail: describeSearchDegradations(fatal),\n    });\n    const composition = input.footer\n      ? { ...missing, footer: input.footer }\n      : missing;\n    return {\n      composition,\n      context: composeRecallContext(composition),\n      truncated: false,\n    };\n  }\n  const bounded = boundRecallContextComposition({\n    context: input.context,\n    footer: input.footer,\n    maxChars: input.maxChars,\n    compactContext: input.compactContext,\n  });\n  if (fatal.length === 0) {\n    return {\n      composition: bounded,\n      context: composeRecallContext(bounded),\n      truncated:\n        bounded.degradation?.reason === \"budget-clipped\" ||\n        bounded.degradation?.reason === \"budget-compacted\",\n    };\n  }\n  const composition = {\n    ...bounded,\n    degradation: {\n      state: \"degraded\" as const,\n      reason: \"backend-unavailable\" as const,\n      detail: describeSearchDegradations(fatal),\n      ...(bounded.degradation?.budget ? { budget: bounded.degradation.budget } : {}),\n    },\n  };\n  return {\n    composition,\n    context: composeRecallContext(composition),\n    truncated:\n      bounded.degradation?.reason === \"budget-clipped\" ||\n      bounded.degradation?.reason === \"budget-compacted\",\n  };\n}\n\nexport function notifyContextComposition(\n  onContextComposition:\n    | ((composition: RecallContextComposition) => void | PromiseLike<void>)\n    | undefined,\n  composition: RecallContextComposition,\n  onError: (err: unknown) => void,\n): void {\n  if (!onContextComposition) return;\n  try {\n    const result = onContextComposition(composition);\n    if (result && typeof result.then === \"function\") {\n      void Promise.resolve(result).catch(onError);\n    }\n  } catch (err) {\n    onError(err);\n  }\n}\n\n/**\n * Outer-recall failure: abort stays silent (empty string). Timeout and\n * other errors become the missing-note so a failed query is never\n * indistinguishable from \"no matches\".\n */\nexport function recallFailureComposition(err: unknown): RecallContextComposition | null {\n  if (isAbortError(err)) return null;\n  const detail =\n    err instanceof Error && err.message === \"recall timeout\"\n      ? \"timeout\"\n      : \"recall_failed\";\n  return composeMissingMemoryContext({ detail });\n}\n"],"mappings":";;;;;;;;;;;;;;;AA8CA,SAAS,UAAU,SAAyB;AAC1C,QAAM,UAAU,QAAQ,KAAK;AAC7B,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,QAAQ,QAAQ,IAAI;AACpC,SAAO,YAAY,KAAK,UAAU,QAAQ,MAAM,GAAG,OAAO,EAAE,QAAQ;AACtE;AAEA,SAAS,aAAa,OAAuC;AAC3D,SAAO,OAAO,UAAU,WAAW,QAAQ,MAAM;AACnD;AAOO,SAAS,gCACd,SACQ;AACR,QAAM,WAAqB,CAAC;AAC5B,aAAW,CAAC,EAAE,MAAM,KAAK,SAAS;AAChC,UAAM,QAAkB,CAAC;AACzB,eAAW,SAAS,QAAQ;AAC1B,YAAM,OAAO,UAAU,aAAa,KAAK,CAAC;AAC1C,UAAI,KAAK,SAAS,EAAG,OAAM,KAAK,IAAI;AAAA,IACtC;AACA,QAAI,MAAM,SAAS,EAAG,UAAS,KAAK,MAAM,KAAK,IAAI,CAAC;AAAA,EACtD;AACA,SAAO,SAAS,KAAK,wBAAwB;AAC/C;AAEO,SAAS,+BACd,OACiC;AACjC,QAAM,WAAW,MAAM,uBAAuB,CAAC;AAC/C,QAAM,cAAc,MAAM,gBAAgB;AAC1C,QAAM,QAAQ,wBAAwB,QAAQ,EAAE;AAAA,IAC9C,CAAC,MAAM,eAAe,EAAE,YAAY,SAAS,EAAE,SAAS;AAAA,EAC1D;AACA,MAAI,MAAM,SAAS,KAAK,MAAM,QAAQ,KAAK,EAAE,WAAW,GAAG;AACzD,UAAM,UAAU,4BAA4B;AAAA,MAC1C,QAAQ,2BAA2B,KAAK;AAAA,IAC1C,CAAC;AACD,UAAMA,eAAc,MAAM,SACtB,EAAE,GAAG,SAAS,QAAQ,MAAM,OAAO,IACnC;AACJ,WAAO;AAAA,MACL,aAAAA;AAAA,MACA,SAAS,qBAAqBA,YAAW;AAAA,MACzC,WAAW;AAAA,IACb;AAAA,EACF;AACA,QAAM,UAAU,8BAA8B;AAAA,IAC5C,SAAS,MAAM;AAAA,IACf,QAAQ,MAAM;AAAA,IACd,UAAU,MAAM;AAAA,IAChB,gBAAgB,MAAM;AAAA,EACxB,CAAC;AACD,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO;AAAA,MACL,aAAa;AAAA,MACb,SAAS,qBAAqB,OAAO;AAAA,MACrC,WACE,QAAQ,aAAa,WAAW,oBAChC,QAAQ,aAAa,WAAW;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cAAc;AAAA,IAClB,GAAG;AAAA,IACH,aAAa;AAAA,MACX,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ,2BAA2B,KAAK;AAAA,MACxC,GAAI,QAAQ,aAAa,SAAS,EAAE,QAAQ,QAAQ,YAAY,OAAO,IAAI,CAAC;AAAA,IAC9E;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,qBAAqB,WAAW;AAAA,IACzC,WACE,QAAQ,aAAa,WAAW,oBAChC,QAAQ,aAAa,WAAW;AAAA,EACpC;AACF;AAEO,SAAS,yBACd,sBAGA,aACA,SACM;AACN,MAAI,CAAC,qBAAsB;AAC3B,MAAI;AACF,UAAM,SAAS,qBAAqB,WAAW;AAC/C,QAAI,UAAU,OAAO,OAAO,SAAS,YAAY;AAC/C,WAAK,QAAQ,QAAQ,MAAM,EAAE,MAAM,OAAO;AAAA,IAC5C;AAAA,EACF,SAAS,KAAK;AACZ,YAAQ,GAAG;AAAA,EACb;AACF;AAOO,SAAS,yBAAyB,KAA+C;AACtF,MAAI,aAAa,GAAG,EAAG,QAAO;AAC9B,QAAM,SACJ,eAAe,SAAS,IAAI,YAAY,mBACpC,YACA;AACN,SAAO,4BAA4B,EAAE,OAAO,CAAC;AAC/C;","names":["composition"]}

package/dist/{chunk-SEHKTE4F.js → chunk-I4IKTNZP.js}

@@ -7,10 +7,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-LMLPLIT4.js";
+} from "./chunk-AQ6IBVFQ.js";
 import {
   StorageManager
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -1005,4 +1005,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-SEHKTE4F.js.map
+//# sourceMappingURL=chunk-I4IKTNZP.js.map

package/dist/{chunk-W65KK3X6.js → chunk-II4TIQCU.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   StorageManager
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   assertInjectedStorageRooted
 } from "./chunk-JE334SIA.js";
@@ -260,4 +260,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-W65KK3X6.js.map
+//# sourceMappingURL=chunk-II4TIQCU.js.map

package/dist/{chunk-FWVDTLRK.js → chunk-IJQEVNEF.js}

@@ -318,4 +318,4 @@ export {
   readProjectedHarmonicGraph,
   searchHarmonicRetrieval
 };
-//# sourceMappingURL=chunk-FWVDTLRK.js.map
+//# sourceMappingURL=chunk-IJQEVNEF.js.map

package/dist/{chunk-KXJ7XYUT.js → chunk-IOUQUXHO.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   getCachedRuleMemories,
   setCachedRuleMemories
@@ -119,4 +119,4 @@ export {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
 };
-//# sourceMappingURL=chunk-KXJ7XYUT.js.map
+//# sourceMappingURL=chunk-IOUQUXHO.js.map

package/dist/{chunk-V3JM4XEI.js → chunk-ITLFUILH.js}

@@ -23,7 +23,7 @@ import {
 } from "./chunk-NVKO5YKP.js";
 import {
   compareEntityTimestamps
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -918,4 +918,4 @@ export {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours
 };
-//# sourceMappingURL=chunk-V3JM4XEI.js.map
+//# sourceMappingURL=chunk-ITLFUILH.js.map

package/dist/{chunk-ZNFHWNDM.js → chunk-IULYVB5X.js}

@@ -1,7 +1,7 @@
 import {
   buildStandup,
   parseStandupDate
-} from "./chunk-EIU642TN.js";
+} from "./chunk-BE4GMH45.js";
 import {
   backfillMemoryStorage,
   runLocationBackfill,
@@ -9,16 +9,16 @@ import {
   runLocationDay,
   runLocationStatus,
   runLocationSync
-} from "./chunk-GYNCJSQ7.js";
+} from "./chunk-OCEIHKH5.js";
 import {
   externalWikiSearchOperation
-} from "./chunk-4P3ZBL5E.js";
+} from "./chunk-MUGLJAZ3.js";
 import {
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   defineOperation,
   isCodegraphToolName
-} from "./chunk-WD32KTVI.js";
+} from "./chunk-2ZVSQPAA.js";
 import {
   CorrectionContractError
 } from "./chunk-QLK3SL7Q.js";
@@ -1914,4 +1914,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-ZNFHWNDM.js.map
+//# sourceMappingURL=chunk-IULYVB5X.js.map

package/dist/{chunk-Z3YQOV45.js → chunk-JLU7WK22.js}

@@ -1,6 +1,6 @@
 import {
   isNamespaceKind
-} from "./chunk-F4PEETM4.js";
+} from "./chunk-755VRFBS.js";
 import {
   EngramAccessInputError
 } from "./chunk-3MUKQQ7A.js";
@@ -40,4 +40,4 @@ export {
   positiveIntQueryParam,
   optionalNamespaceKindQueryParam
 };
-//# sourceMappingURL=chunk-Z3YQOV45.js.map
+//# sourceMappingURL=chunk-JLU7WK22.js.map

package/dist/{chunk-NRTVZSPO.js → chunk-L4HT5QZ5.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-B7RWBZXW.js";
 import {
   StorageManager
-} from "./chunk-5QZHDS4X.js";
+} from "./chunk-LI4IWBLN.js";
 import {
   getCachedEpisodeMap,
   setCachedEpisodeMap
@@ -109,4 +109,4 @@ export {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
 };
-//# sourceMappingURL=chunk-NRTVZSPO.js.map
+//# sourceMappingURL=chunk-L4HT5QZ5.js.map

package/dist/{chunk-5QZHDS4X.js → chunk-LI4IWBLN.js}

@@ -17,7 +17,7 @@ import {
 } from "./chunk-UHVXE24Y.js";
 import {
   normalizeQmdResultPath
-} from "./chunk-JTTLH646.js";
+} from "./chunk-C2W6JKQQ.js";
 import {
   withholdToolScopedFromSharedNamespace
 } from "./chunk-S2V7RUCL.js";
@@ -11348,4 +11348,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-5QZHDS4X.js.map
+//# sourceMappingURL=chunk-LI4IWBLN.js.map

package/dist/{chunk-LY3SDHMI.js → chunk-LQ4OSM5V.js}

@@ -21,13 +21,13 @@ import {
   defineOperation,
   parseNamespacePreflightWriteOp,
   resolveAuthorizedNamespaceWritablePreflight
-} from "./chunk-WD32KTVI.js";
+} from "./chunk-2ZVSQPAA.js";
 import {
   parseSharedWriteOutputControls
 } from "./chunk-IFBSZGW3.js";
 import {
   validateBriefingFormat
-} from "./chunk-LDP6LBDS.js";
+} from "./chunk-Y3AFTYK4.js";
 import {
   parseDeepRecallMaxSteps
 } from "./chunk-A7AISUJI.js";
@@ -603,4 +603,4 @@ defineOperation({ name: "graph_events", description: "SSE graph events.", schema
 defineOperation({ name: "chat_message", description: "Chat message.", schema: strictSchema({ message: S.str, chatSessionId: S.str }), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
 defineOperation({ name: "chat_events", description: "SSE chat events.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { stream: "sse" } }) });
 defineOperation({ name: "adapters_status", description: "Adapter registry metadata (issue #1850 round 5). Marker op: the HTTP transport builds the response from its own adapterRegistry, but the op still must be registered so it appears in listRegisteredOperations and enforceTokenOp can gate it for scoped tokens.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
-//# sourceMappingURL=chunk-LY3SDHMI.js.map
+//# sourceMappingURL=chunk-LQ4OSM5V.js.map

package/dist/{chunk-2OUSWDY6.js → chunk-M3TMVHQ2.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-SEHKTE4F.js";
+} from "./chunk-I4IKTNZP.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-2OUSWDY6.js.map
+//# sourceMappingURL=chunk-M3TMVHQ2.js.map

package/dist/{chunk-IDRSTHVR.js → chunk-MB3HMRXM.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-AERXJCOG.js";
 import {
   deriveSourceConnector
-} from "./chunk-FQGY7XB2.js";
+} from "./chunk-S52VKUUW.js";
 import {
   resolvePipelineProcessingCapabilities
 } from "./chunk-BMXEBWBT.js";
@@ -112,4 +112,4 @@ export {
   renderExtractionConversation,
   applyGroundingWithConnector
 };
-//# sourceMappingURL=chunk-IDRSTHVR.js.map
+//# sourceMappingURL=chunk-MB3HMRXM.js.map

package/dist/{chunk-4P3ZBL5E.js → chunk-MUGLJAZ3.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-7T4TOGMS.js";
 import {
   defineOperation
-} from "./chunk-WD32KTVI.js";
+} from "./chunk-2ZVSQPAA.js";
 
 // src/external-wiki-access.ts
 import { z } from "zod";
@@ -26,4 +26,4 @@ var externalWikiSearchOperation = defineOperation({
 export {
   externalWikiSearchOperation
 };
-//# sourceMappingURL=chunk-4P3ZBL5E.js.map
+//# sourceMappingURL=chunk-MUGLJAZ3.js.map

package/dist/{chunk-ZOASYXBS.js → chunk-MY2PLXSM.js}

@@ -77,7 +77,11 @@ var TOOL_OUTPUT_SCHEMAS = {
     memoryIds: T_ARRAY,
     results: T_ARRAY,
     fallbackUsed: T_BOOLEAN,
-    sourcesUsed: T_ARRAY
+    sourcesUsed: T_ARRAY,
+    retrievalFailure: objectSchema({
+      reason: T_STRING,
+      detail: T_STRING
+    })
   }),
   recall_explain: objectSchema({
     found: T_BOOLEAN,
@@ -626,4 +630,4 @@ function applyToolOutputSchemas(tools, canonicalPrefix, legacyPrefix) {
 export {
   applyToolOutputSchemas
 };
-//# sourceMappingURL=chunk-ZOASYXBS.js.map
+//# sourceMappingURL=chunk-MY2PLXSM.js.map