@remnic/core 9.3.713 → 9.3.714

package/dist/{chunk-HSDJCT3V.js → chunk-DXGS5YOQ.js}

@@ -4,10 +4,10 @@ import {
 import {
   compareEntityTimestamps,
   normalizeEntityName
-} from "./chunk-JSDZMOT7.js";
+} from "./chunk-OC56UWV5.js";
 import {
   sanitizeMemoryContent
-} from "./chunk-FVQJYWH7.js";
+} from "./chunk-5GKPFL3S.js";
 import {
   normalizeEntityText,
   resolveRequestedEntitySectionKeys
@@ -679,4 +679,4 @@ export {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours
 };
-//# sourceMappingURL=chunk-HSDJCT3V.js.map
+//# sourceMappingURL=chunk-DXGS5YOQ.js.map

package/dist/{chunk-HV57RHMD.js → chunk-EH5ED3C6.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-U3PN77QT.js";
 import {
   sanitizeMemoryContent
-} from "./chunk-FVQJYWH7.js";
+} from "./chunk-5GKPFL3S.js";
 
 // src/explicit-capture.ts
 import { randomUUID } from "crypto";
@@ -438,4 +438,4 @@ export {
   shouldSkipImplicitExtraction,
   shouldProcessInlineExplicitCapture
 };
-//# sourceMappingURL=chunk-HV57RHMD.js.map
+//# sourceMappingURL=chunk-EH5ED3C6.js.map

package/dist/{chunk-GKPIY7EQ.js → chunk-FXZKXW7C.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,
@@ -2406,6 +2414,7 @@ var Orchestrator = class _Orchestrator {
   relevance;
   negatives;
   lastRecall;
+  handleHistory;
   tierMigrationStatus;
   /**
    * In-memory X-ray snapshot from the most recent `recall()` call that
@@ -3129,6 +3138,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 +3454,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 +9341,7 @@ ${tmtNode.summary}`
           this.appendRecallSection(
             sectionBuckets,
             "workspace-context",
-            this.formatQmdResults("Workspace Context", globalResults)
+            this.formatQmdResults("Workspace Context", globalResults, sessionKey)
           );
         }
         recordRecallSectionMetric({
@@ -9942,6 +9955,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 +10033,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).
@@ -13506,12 +13528,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 +13836,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 +15108,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 +15409,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-GKPIY7EQ.js.map
+//# sourceMappingURL=chunk-FXZKXW7C.js.map