@remnic/core 9.3.713 → 9.3.715

package/dist/{chunk-XKU4YE6Z.js → chunk-XZTUMWKQ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   StorageManager
-} from "./chunk-JSDZMOT7.js";
+} from "./chunk-OC56UWV5.js";
 import {
   assertPathInsideRoot
 } from "./chunk-5GPPACXK.js";
@@ -751,4 +751,4 @@ export {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
 };
-//# sourceMappingURL=chunk-XKU4YE6Z.js.map
+//# sourceMappingURL=chunk-XZTUMWKQ.js.map

package/dist/{chunk-GKPIY7EQ.js → chunk-YUJL27ET.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-DGTDRIUO.js";
 import {
   MaintenanceScheduler
-} from "./chunk-3TCRU4JA.js";
+} from "./chunk-O62P2LFL.js";
 import {
   migrateFromEngram
 } from "./chunk-7HYPN2GC.js";
@@ -23,18 +23,21 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-54TI5GLV.js";
+} from "./chunk-WI4QX7GH.js";
 import {
   SharedContextManager
 } from "./chunk-UFS7OXGL.js";
-import {
-  extractTopics
-} from "./chunk-UHGBNIOS.js";
 import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
 } from "./chunk-LXOM6IQU.js";
+import {
+  TmtBuilder
+} from "./chunk-ECZU5BJH.js";
+import {
+  extractTopics
+} from "./chunk-UHGBNIOS.js";
 import {
   CODEX_THREAD_KEY_PREFIX
 } from "./chunk-4EX5WZ4M.js";
@@ -44,9 +47,6 @@ import {
 import {
   decideTierTransition
 } from "./chunk-S75M5ZRK.js";
-import {
-  TmtBuilder
-} from "./chunk-ECZU5BJH.js";
 import {
   HourlySummarizer
 } from "./chunk-IO5NQEGZ.js";
@@ -57,6 +57,12 @@ import {
 import {
   SessionObserverState
 } from "./chunk-DKTSR7EK.js";
+import {
+  applyRuntimeRetrievalPolicy
+} from "./chunk-5IZL4DCV.js";
+import {
+  RelevanceStore
+} from "./chunk-GG6AJN7A.js";
 import {
   RerankCache,
   rerankLocalOrNoop
@@ -84,25 +90,20 @@ import {
   resolvePromptTagPrefilterAsync
 } from "./chunk-MGN7VHWQ.js";
 import {
-  applyRuntimeRetrievalPolicy
-} from "./chunk-5IZL4DCV.js";
+  LastRecallStore,
+  RecallHandleHistoryStore,
+  TierMigrationStatusStore,
+  clampGraphRecallExpandedEntries
+} from "./chunk-UC4YOAC2.js";
 import {
   findUnresolvedEntityRefs
 } from "./chunk-X7XN6YU4.js";
-import {
-  RelevanceStore
-} from "./chunk-GG6AJN7A.js";
 import {
   reorderRecallResultsWithMmr
 } from "./chunk-YDBIWGNI.js";
 import {
   createRecallSectionMetricRecorder
 } from "./chunk-VQ34TERH.js";
-import {
-  LastRecallStore,
-  TierMigrationStatusStore,
-  clampGraphRecallExpandedEntries
-} from "./chunk-VILEUJXC.js";
 import {
   applyReasoningTraceBoost
 } from "./chunk-ZZTOURJI.js";
@@ -138,7 +139,7 @@ import {
 } from "./chunk-TH7WMHVK.js";
 import {
   ExtractionEngine
-} from "./chunk-VYZNWH4J.js";
+} from "./chunk-2SXMCQEQ.js";
 import {
   parseMemoryActionEligibilityContext
 } from "./chunk-5GSUBCZM.js";
@@ -175,7 +176,7 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-HSDJCT3V.js";
+} from "./chunk-DXGS5YOQ.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-EO5QWINU.js";
@@ -188,14 +189,14 @@ import {
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-S6FQLQGH.js";
+} from "./chunk-V7GDTQ6I.js";
 import {
   ThreadingManager
 } from "./chunk-QRDOSYOR.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-SKQCFAYU.js";
+} from "./chunk-JVEMUX6L.js";
 import {
   searchWorkProductLedgerEntries
 } from "./chunk-ZRWB5D4H.js";
@@ -205,14 +206,14 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-7NDYFAJS.js";
+} from "./chunk-GM3BMWKR.js";
 import {
   NamespaceCatalog,
   planNamespaceMaintenance
-} from "./chunk-GMRNKPWO.js";
+} from "./chunk-6QUPUTT7.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-BQCFXAMN.js";
+} from "./chunk-MPHDVHIB.js";
 import {
   PolicyRuntimeManager
 } from "./chunk-33JBK2XP.js";
@@ -257,7 +258,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-NXL5CVE7.js";
+} from "./chunk-2Y6LMOQQ.js";
 import {
   buildRecallQueryPolicy
 } from "./chunk-LBJBNWS2.js";
@@ -309,14 +310,14 @@ import {
 } from "./chunk-FF4KLI5W.js";
 import {
   buildXraySnapshot
-} from "./chunk-OWOKOFXK.js";
+} from "./chunk-AJOIM6UR.js";
 import {
   NamespaceSearchRouter
-} from "./chunk-K22IJO4R.js";
+} from "./chunk-CTOQEZSN.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend
-} from "./chunk-OMSTU233.js";
+} from "./chunk-2KAYTPPT.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -343,7 +344,7 @@ import {
 } from "./chunk-QDW3E4RD.js";
 import {
   shouldSkipImplicitExtraction
-} from "./chunk-HV57RHMD.js";
+} from "./chunk-EH5ED3C6.js";
 import {
   searchCausalTrajectories
 } from "./chunk-YI7RZO7Y.js";
@@ -356,7 +357,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-35YJ6KCV.js";
+} from "./chunk-JEIROMLX.js";
 import {
   ContentHashIndex,
   StorageManager,
@@ -364,7 +365,10 @@ import {
   fingerprintEntityStructuredFacts,
   normalizeAttributePairs,
   parseEntityFile
-} from "./chunk-JSDZMOT7.js";
+} from "./chunk-OC56UWV5.js";
+import {
+  buildRetiredFactTombstoneInputs
+} from "./chunk-3JJWNZTT.js";
 import {
   isValidTranscriptDate,
   loadSpeakerRegistry,
@@ -372,9 +376,6 @@ import {
   saveSpeakerRegistry,
   speakerRegistryKey
 } from "./chunk-M7XQSUBB.js";
-import {
-  buildRetiredFactTombstoneInputs
-} from "./chunk-3JJWNZTT.js";
 import {
   assertPathInsideRoot
 } from "./chunk-5GPPACXK.js";
@@ -388,17 +389,17 @@ import {
   isValidAsOf,
   isValidityExpiredNow
 } from "./chunk-6CIAGZ6X.js";
-import {
-  stripAttributesSuffix
-} from "./chunk-SVOZFLIQ.js";
 import {
   attachCitation,
   hasCitationForTemplate,
   stripCitationForTemplate
 } from "./chunk-J6A3CX5N.js";
+import {
+  stripAttributesSuffix
+} from "./chunk-SVOZFLIQ.js";
 import {
   confidenceTier
-} from "./chunk-BOGENF7P.js";
+} from "./chunk-MSVSP5VO.js";
 import {
   inferMemoryStatus,
   isActiveMemoryStatus
@@ -451,10 +452,17 @@ import {
 } from "./chunk-U3PN77QT.js";
 import {
   sanitizeMemoryContent
-} from "./chunk-FVQJYWH7.js";
+} from "./chunk-5GKPFL3S.js";
 import {
   log
 } from "./chunk-NU3CSQ4H.js";
+import {
+  MEMORY_ID_PATTERN,
+  buildHandleIndexForResults,
+  parseIdOrHandle,
+  resolveHandle,
+  stripHandles
+} from "./chunk-JAKIDQB2.js";
 import {
   abortError,
   isAbortError,
@@ -2292,7 +2300,10 @@ function resolveRecentThreadMemoryPaths(options) {
   if (options.threadEpisodeIds.length === 0 || maxRecent === 0) return [];
   const pathById = options.pathById ?? buildMemoryPathById(options.allMemsForGraph, options.storageDir);
   if (pathById.size === 0) return [];
-  return options.threadEpisodeIds.filter((id) => id !== options.currentMemoryId).slice(-maxRecent).map((id) => pathById.get(id)).filter((p) => typeof p === "string" && p.length > 0);
+  const pendingReviewIds = new Set(
+    (options.allMemsForGraph ?? []).filter((m) => m.frontmatter.status === "pending_review" && m.frontmatter.id).map((m) => m.frontmatter.id)
+  );
+  return options.threadEpisodeIds.filter((id) => id !== options.currentMemoryId).filter((id) => !pendingReviewIds.has(id)).slice(-maxRecent).map((id) => pathById.get(id)).filter((p) => typeof p === "string" && p.length > 0);
 }
 function buildMemoryPathById(allMemsForGraph, storageDir) {
   const pathById = /* @__PURE__ */ new Map();
@@ -2385,6 +2396,11 @@ var Orchestrator = class _Orchestrator {
    * callers already destructure `persistedIds` by position.
    */
   lastPersistExtractionDeferredCount = 0;
+  /**
+   * Side-channel (#1635): pending_review persisted ids from the last
+   * persistExtraction; runExtraction excludes them from the thread episode set.
+   */
+  lastPersistExtractionPendingReviewIds = [];
   _fastGatewayLlm;
   get fastGatewayLlm() {
     return this._fastGatewayLlm;
@@ -2406,6 +2422,7 @@ var Orchestrator = class _Orchestrator {
   relevance;
   negatives;
   lastRecall;
+  handleHistory;
   tierMigrationStatus;
   /**
    * In-memory X-ray snapshot from the most recent `recall()` call that
@@ -3129,6 +3146,9 @@ var Orchestrator = class _Orchestrator {
     this.relevance = new RelevanceStore(config.memoryDir);
     this.negatives = new NegativeExampleStore(config.memoryDir);
     this.lastRecall = new LastRecallStore(config.memoryDir);
+    this.handleHistory = new RecallHandleHistoryStore(config.memoryDir, {
+      maxDepth: config.recallHandleSnapshotDepth
+    });
     this.tierMigrationStatus = new TierMigrationStatusStore(config.memoryDir);
     this.sessionObserver = new SessionObserverState({
       memoryDir: config.memoryDir,
@@ -3442,6 +3462,7 @@ var Orchestrator = class _Orchestrator {
       await this.relevance.load();
       await this.negatives.load();
       await this.lastRecall.load();
+      await this.handleHistory.load();
       await this.tierMigrationStatus.load();
       await this.sessionObserver.load();
       this.runtimePolicyValues = await this.policyRuntime.loadRuntimeValues();
@@ -9328,7 +9349,7 @@ ${tmtNode.summary}`
           this.appendRecallSection(
             sectionBuckets,
             "workspace-context",
-            this.formatQmdResults("Workspace Context", globalResults)
+            this.formatQmdResults("Workspace Context", globalResults, sessionKey)
           );
         }
         recordRecallSectionMetric({
@@ -9942,6 +9963,14 @@ _Context: ${topQuestion.context}_`
           // reviews on #1544).
           backendDegradations: backendDegradations.length > 0 ? backendDegradations : void 0
         }).catch((err) => log.debug(`last recall record failed: ${err}`));
+        if (this.config.recallMemoryHandles && recalledMemoryIds.length > 0) {
+          const handleEligibleIds = recalledMemoryIds.filter(
+            (id) => MEMORY_ID_PATTERN.test(id)
+          );
+          if (handleEligibleIds.length > 0) {
+            this.handleHistory.record(sessionKey, handleEligibleIds).catch((err) => log.debug(`handle history record failed: ${err}`));
+          }
+        }
       }
       if (sessionKey) {
         this.queueEvalShadowRecall({
@@ -10012,9 +10041,10 @@ _Context: ${topQuestion.context}_`
     }
     const bufferKey = typeof options.bufferKey === "string" && options.bufferKey.length > 0 ? options.bufferKey : typeof sessionKey === "string" && sessionKey.length > 0 ? sessionKey : "default";
     const captureTimestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const bufferedContent = this.config.recallMemoryHandles ? stripHandles(content) : content;
     const turn = {
       role,
-      content,
+      content: bufferedContent,
       timestamp: captureTimestamp,
       // #1578: anchor live-capture turns to wall-clock when bi-temporal is on;
       // replay/import turns carry sourceValidAt explicitly (codex P1).
@@ -10895,17 +10925,10 @@ ${normalized}`).digest("hex");
       );
     }
     if (this.config.threadingEnabled && threadIdForExtraction && persistedIds.length > 0) {
-      try {
-        await this.threading.appendEpisodeIds(
-          threadIdForExtraction,
-          persistedIds
-        );
-      } catch (err) {
-        log.warn(
-          "[threading] appendEpisodeIds failed after persistence (non-fatal)",
-          err
-        );
-      }
+      await this.appendPersistedThreadEpisodes(
+        threadIdForExtraction,
+        persistedIds
+      );
     }
     if (this.config.threadingEnabled && threadIdForExtraction) {
       const conversationContent = turns.map((t) => t.content).join(" ");
@@ -11171,13 +11194,17 @@ ${normalized}`).digest("hex");
       };
       return attachCitation(content, citationContext, citationTemplate);
     };
-    const supersessionOrderingAt = (validAt) => validAt && validAt.length > 0 ? validAt : (/* @__PURE__ */ new Date()).toISOString();
     const persistedIds = [];
+    const supersessionOrderingAt = (validAt) => validAt && validAt.length > 0 ? validAt : (/* @__PURE__ */ new Date()).toISOString();
+    const pendingReviewPersistedIds = [];
     const persistedIdsByStorage = /* @__PURE__ */ new Map();
     const trackPersistedId = (targetStorage, id, options = {}) => {
       if (options.includeReturnedIds !== false) {
         persistedIds.push(id);
       }
+      if (options.pendingReview) {
+        pendingReviewPersistedIds.push(id);
+      }
       const key = targetStorage.dir;
       const existing = persistedIdsByStorage.get(key);
       if (existing) {
@@ -12010,7 +12037,9 @@ ${normalized}`).digest("hex");
           log.debug(
             `chunked memory ${parentId} into ${chunkResult.chunks.length} chunks`
           );
-          trackPersistedId(targetStorage, parentId);
+          trackPersistedId(targetStorage, parentId, {
+            pendingReview: faithfulnessEnforceStatus === "pending_review"
+          });
           if (faithfulnessEnforceStatus !== "pending_review" && threadEpisodeIdsForGraph && !threadEpisodeIdsForGraph.includes(parentId)) {
             threadEpisodeIdsForGraph.push(parentId);
           }
@@ -12208,7 +12237,9 @@ ${normalized}`).digest("hex");
             source: "extraction"
           })
         );
-        trackPersistedId(targetStorage, memoryId);
+        trackPersistedId(targetStorage, memoryId, {
+          pendingReview: faithfulnessEnforceStatus === "pending_review"
+        });
         if (faithfulnessEnforceStatus !== "pending_review" && threadEpisodeIdsForGraph && !threadEpisodeIdsForGraph.includes(memoryId)) {
           threadEpisodeIdsForGraph.push(memoryId);
         }
@@ -12419,8 +12450,27 @@ ${normalized}`).digest("hex");
     })().catch(
       (err) => log.debug(`temporal-index update error (non-fatal): ${err}`)
     );
+    this.lastPersistExtractionPendingReviewIds = pendingReviewPersistedIds;
     return persistedIds;
   }
+  /**
+   * Append persisted ids to the thread episode set, excluding pending_review
+   * fact ids (#1635) so they don't re-seed predecessor edges. Fail-open like
+   * the raw appendEpisodeIds call it replaces.
+   */
+  async appendPersistedThreadEpisodes(threadId, persistedIds) {
+    const pendingReviewIds = this.lastPersistExtractionPendingReviewIds ?? [];
+    const episodeIds = pendingReviewIds.length > 0 ? persistedIds.filter((id) => !pendingReviewIds.includes(id)) : persistedIds;
+    if (episodeIds.length === 0) return;
+    try {
+      await this.threading.appendEpisodeIds(threadId, episodeIds);
+    } catch (err) {
+      log.warn(
+        "[threading] appendEpisodeIds failed after persistence (non-fatal)",
+        err
+      );
+    }
+  }
   async indexPersistedMemory(storage, memoryId) {
     if (!this.config.embeddingFallbackEnabled) return;
     if (!await this.embeddingFallback.isAvailable()) return;
@@ -13506,12 +13556,18 @@ ${reflectionsContent.trim()}
       );
     }
   }
-  formatQmdResults(title, results) {
+  formatQmdResults(title, results, sessionKey) {
+    const handleByIndex = buildHandleIndexForResults(
+      results,
+      this.config.recallMemoryHandles === true && sessionKey != null
+    );
     const lines = results.map((r, i) => {
       const snippet = r.snippet ? r.snippet.slice(0, 500).replace(/\n/g, " ") : "(no preview)";
       const source = typeof r.line === "number" ? `${r.path}:${r.line}` : r.path;
-      return `[${i + 1}] ${source} (score: ${r.score.toFixed(3)})
+      const head = `[${i + 1}] ${source} (score: ${r.score.toFixed(3)})
 ${snippet}`;
+      const handle = handleByIndex.get(i);
+      return handle ? `${head.replace(/\s+$/, "")} ${handle}` : head;
     });
     return `## ${title}
 
@@ -13808,7 +13864,7 @@ ${lines.join("\n\n")}`;
     this.appendRecallSection(
       options.sectionBuckets,
       sectionId,
-      this.formatQmdResults(options.title, options.results)
+      this.formatQmdResults(options.title, options.results, options.sessionKey)
     );
   }
   /**
@@ -15080,6 +15136,49 @@ ${lines.join("\n\n")}`;
   getLastRecall(sessionKey) {
     return this.lastRecall.get(sessionKey);
   }
+  /**
+   * Issue #1582 — resolve a memory handle (`[m:4f2a]` / bare hex) to its memory
+   * id against THIS session's recent recall history. Returns the id on a unique
+   * hit, `null` on a miss, and throws on ambiguity (callers must disambiguate —
+   * rule 34/51). Resolution is per-session and snapshot-scoped; there is no
+   * global handle→id map (rule 42).
+   */
+  resolveMemoryHandle(handle, sessionKey) {
+    if (!sessionKey) return null;
+    const depth = this.config.recallHandleSnapshotDepth;
+    const snapshots = this.handleHistory.recent(sessionKey, depth).map((ids) => ({ memoryIds: ids }));
+    const result = resolveHandle(handle, snapshots, depth);
+    if (result.ok) return result.memoryId;
+    if (result.reason === "ambiguous") {
+      throw new Error(
+        `Memory handle ${handle} is ambiguous in session ${sessionKey}: ${result.candidates.join(", ")}. Cite a unique memory id instead.`
+      );
+    }
+    return null;
+  }
+  /**
+   * Issue #1582 — resolve a caller reference that may be EITHER a memory id or
+   * a handle to a concrete memory id. Handles resolve against the session's
+   * recall history; raw ids pass through unchanged. The single shared helper
+   * every surface (memory_get / feedback / outcome / correction targetIds)
+   * calls so handle resolution has one path (rule 22).
+   */
+  resolveMemoryIdOrHandle(ref, sessionKey) {
+    const parsed = parseIdOrHandle(ref);
+    if (!parsed.isHandle) return parsed.value;
+    if (!sessionKey) {
+      throw new Error(
+        `Memory handle ${ref} cannot be resolved without a session key.`
+      );
+    }
+    const resolved = this.resolveMemoryHandle(parsed.value, sessionKey);
+    if (resolved === null) {
+      throw new Error(
+        `Memory handle ${ref} was not found in the recent recall history for session ${sessionKey}.`
+      );
+    }
+    return resolved;
+  }
   /**
    * Check if a new memory contradicts an existing one.
    * Uses QMD to find similar memories, then LLM to verify contradiction.
@@ -15338,4 +15437,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-GKPIY7EQ.js.map
+//# sourceMappingURL=chunk-YUJL27ET.js.map