@remnic/core 9.62.1 → 9.63.0

package/dist/{chunk-JLMH5YMU.js → chunk-CH627RRV.js}

@@ -34,7 +34,7 @@ import {
   extractionCueAnchors,
   extractionText,
   isPlainRecord
-} from "./chunk-QP2IZTUR.js";
+} from "./chunk-2TYIAKU5.js";
 import {
   CUE_ANCHOR_PROMPT_INSTRUCTION,
   EXTRACTION_RESPONSE_SHAPE,
@@ -2442,4 +2442,4 @@ export {
   shouldEnableLocalExtractionThinking,
   ExtractionEngine
 };
-//# sourceMappingURL=chunk-JLMH5YMU.js.map
+//# sourceMappingURL=chunk-CH627RRV.js.map

package/dist/{chunk-XIABRKF6.js → chunk-CLJ5QS6J.js}

@@ -6,14 +6,14 @@ import {
   loadSyncState,
   syncWearableSource,
   wearableSourceLabel
-} from "./chunk-JGW2EUCQ.js";
+} from "./chunk-PMRUMGK6.js";
 import {
   CompressionGuidelineCoordinator
 } from "./chunk-UXREWVW4.js";
 import {
   ActivityStore,
   MaintenanceScheduler
-} from "./chunk-KCFZOSR6.js";
+} from "./chunk-3MA7JVXN.js";
 import {
   runPeerProfileReasoner
 } from "./chunk-I74SUMNI.js";
@@ -22,7 +22,7 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import {
   LcmEngine
-} from "./chunk-B2QHVLJO.js";
+} from "./chunk-256FBCVX.js";
 import {
   chunkTranscriptEntries
 } from "./chunk-TECVW3JP.js";
@@ -32,10 +32,13 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-JDJOAL4B.js";
+} from "./chunk-YSR3DXGC.js";
 import {
   SharedContextManager
 } from "./chunk-VI637ILW.js";
+import {
+  cleanArchivedUserMessage
+} from "./chunk-47DU4SGJ.js";
 import {
   applyUtilityPromotionRuntimePolicy,
   applyUtilityRankingRuntimeDelta,
@@ -44,6 +47,9 @@ import {
 import {
   extractTopics
 } from "./chunk-UHGBNIOS.js";
+import {
+  buildTemporalTimelineRecallSection
+} from "./chunk-2NKY7OC6.js";
 import {
   CODEX_THREAD_KEY_PREFIX
 } from "./chunk-4EX5WZ4M.js";
@@ -56,19 +62,21 @@ import {
 import {
   TmtBuilder
 } from "./chunk-ECZU5BJH.js";
+import {
+  HourlySummarizer
+} from "./chunk-EUYWQ7TS.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
 } from "./chunk-T67LUYCR.js";
-import {
-  buildTemporalTimelineRecallSection
-} from "./chunk-2NKY7OC6.js";
-import {
-  HourlySummarizer
-} from "./chunk-EUYWQ7TS.js";
 import {
   SessionObserverState
 } from "./chunk-ODZKV2F7.js";
+import {
+  RerankCache,
+  reorderByRankedKeys,
+  rerankLocalOrNoop
+} from "./chunk-LUDXM7MD.js";
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
@@ -103,11 +111,6 @@ import {
 import {
   RelevanceStore
 } from "./chunk-KATEWTQJ.js";
-import {
-  RerankCache,
-  reorderByRankedKeys,
-  rerankLocalOrNoop
-} from "./chunk-LUDXM7MD.js";
 import {
   LastRecallStore,
   RecallHandleHistoryStore,
@@ -150,7 +153,7 @@ import {
   harmonicEntitySegment,
   normalizedHarmonicEntityIdentity,
   persistHarmonicRecords
-} from "./chunk-5WQMORU5.js";
+} from "./chunk-5PFGMO33.js";
 import {
   classifyMemoryKind
 } from "./chunk-YAZNBMNF.js";
@@ -159,7 +162,7 @@ import {
 } from "./chunk-XXSOVESA.js";
 import {
   ExtractionEngine
-} from "./chunk-JLMH5YMU.js";
+} from "./chunk-CH627RRV.js";
 import {
   parseMemoryActionEligibilityContext
 } from "./chunk-WFLBP5GC.js";
@@ -195,26 +198,29 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-QRA3XVJX.js";
+} from "./chunk-UDTME32W.js";
+import {
+  planEpisodeWindowsWithFallback
+} from "./chunk-T3GIETKV.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-J6QIAYNR.js";
 import {
   tryDirectAnswer
-} from "./chunk-CSOYVTRX.js";
+} from "./chunk-IIPJKCZB.js";
 import {
   EmbeddingFallback
 } from "./chunk-DFEODULB.js";
 import {
   refreshConvergedNamespaces
-} from "./chunk-QNMNNFKD.js";
+} from "./chunk-347ZR6D4.js";
 import {
   builtInConnectorPackageSpecifier,
   ensureBuiltInWearableConnectors,
   getWearableConnector,
   listWearableConnectors,
   screenCandidateFact
-} from "./chunk-3XG4QEA2.js";
+} from "./chunk-FF6E6HOT.js";
 import {
   normalizeReplaySessionKey
 } from "./chunk-AJVLDJU6.js";
@@ -224,38 +230,38 @@ import {
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-IIRK5V5Z.js";
+} from "./chunk-BHO6RHE5.js";
 import {
   ThreadingManager
 } from "./chunk-OJP3N7UK.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-WANOCU3K.js";
+} from "./chunk-BP6WMYLP.js";
 import {
   searchWorkProductLedgerEntries
-} from "./chunk-WT6UL3UA.js";
+} from "./chunk-H7PRHUBD.js";
 import {
   TranscriptManager
 } from "./chunk-AM4T6CHX.js";
 import {
   PolicyRuntimeManager
-} from "./chunk-33JBK2XP.js";
+} from "./chunk-5F6HMNMZ.js";
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-IXJ5U6ZL.js";
+} from "./chunk-BBHFAVMP.js";
 import {
   NamespaceCatalog,
   planNamespaceMaintenance
-} from "./chunk-TLUSSS2F.js";
+} from "./chunk-4HO3542O.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
 } from "./chunk-JXS5PDQ7.js";
 import {
   searchHarmonicRetrieval
-} from "./chunk-QN7XQEIT.js";
+} from "./chunk-YIIC5IDU.js";
 import {
   EXTRACTION_JUDGE_VERDICT_CATEGORY,
   recordJudgeVerdict
@@ -286,7 +292,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-DYDACAK2.js";
+} from "./chunk-TGSMU3F2.js";
 import {
   BootstrapEngine
 } from "./chunk-MYVPLJOO.js";
@@ -304,7 +310,7 @@ import {
 } from "./chunk-6TBIWIAG.js";
 import {
   detectMeetings
-} from "./chunk-BHO3IVAN.js";
+} from "./chunk-RYST72N5.js";
 import {
   compileCorrectionRule,
   correctionsFilePath,
@@ -322,14 +328,14 @@ import {
 } from "./chunk-QW27DOHG.js";
 import {
   buildRecallQueryPolicy
-} from "./chunk-LBJBNWS2.js";
+} from "./chunk-YTHQHH5U.js";
 import {
   buildBehaviorSignalsForMemory,
   dedupeBehaviorSignalsByMemoryAndHash
 } from "./chunk-KD3QD3A5.js";
 import {
   MeetingsInputError
-} from "./chunk-JF6YSHJM.js";
+} from "./chunk-ZPGHA7EO.js";
 import {
   WearablesInputError,
   describeErrorForOperator
@@ -350,7 +356,7 @@ import {
   filterRecallCandidates,
   isGenericRecallExcludedPath,
   isTopLevelArchivePath
-} from "./chunk-HKYNBEL4.js";
+} from "./chunk-4FFROSFG.js";
 import {
   importCapsule
 } from "./chunk-QYN5PXDZ.js";
@@ -367,10 +373,10 @@ import {
 import {
   listTrustZoneRecords,
   searchTrustZoneRecords
-} from "./chunk-KQS72GCR.js";
+} from "./chunk-LJOIZPJH.js";
 import {
   buildXraySnapshot
-} from "./chunk-EHMMRZOZ.js";
+} from "./chunk-QICOU4RY.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
@@ -401,7 +407,7 @@ import {
 } from "./chunk-7ZNJN5WZ.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-67MKNKJQ.js";
+} from "./chunk-AYIHDC5S.js";
 import {
   GraphIndex
 } from "./chunk-YMOPYG3K.js";
@@ -454,10 +460,10 @@ import {
 } from "./chunk-PD6O7AXF.js";
 import {
   searchCausalTrajectories
-} from "./chunk-HXXGZ4KV.js";
+} from "./chunk-ALNZEWGN.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-UIRU3MIJ.js";
+} from "./chunk-7BJYTX6Q.js";
 import {
   QmdResultResolver,
   StorageManager,
@@ -476,7 +482,7 @@ import {
   reconstructFusionInputs,
   selfDeps,
   serializeFusionDay
-} from "./chunk-ZJKLGS76.js";
+} from "./chunk-CALURYWR.js";
 import {
   bodyIsEscaped,
   decodeTranscriptBody,
@@ -489,16 +495,16 @@ import {
 } from "./chunk-UHVXE24Y.js";
 import {
   buildRetiredFactTombstoneInputs
-} from "./chunk-KHQ57QLJ.js";
+} from "./chunk-46WM6JX2.js";
 import {
   NamespaceSearchRouter,
   namespaceCollectionName
-} from "./chunk-QWPAQLYV.js";
+} from "./chunk-JFLKSD5V.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend,
   isSearchBackendEnabled
-} from "./chunk-7N7DB4L5.js";
+} from "./chunk-LTJTP5YQ.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -512,7 +518,7 @@ import {
 } from "./chunk-S2V7RUCL.js";
 import {
   confidenceTier
-} from "./chunk-5WVUO6QT.js";
+} from "./chunk-AR253JBM.js";
 import {
   lintWorkspaceFiles,
   rotateMarkdownFileToArchive
@@ -587,7 +593,9 @@ import {
 } from "./chunk-PJKTFXE2.js";
 import {
   createBoundedCoreSectionRunner,
-  createRecallSectionMetricRecorder
+  createRecallSectionMetricRecorder,
+  resolveRecallCoreSectionDeadlineMs,
+  runRecallSectionWithinDeadline
 } from "./chunk-4O4TKIXQ.js";
 import {
   decideLifecycleTransition,
@@ -595,7 +603,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   normalizeRecallTokenSet
-} from "./chunk-ZBJMUXZH.js";
+} from "./chunk-DJ7HMNSL.js";
 import {
   CAPSULE_ID_PATTERN
 } from "./chunk-WEHSQBFR.js";
@@ -685,6 +693,7 @@ import {
   resolveUtilityLearningCapabilities
 } from "./chunk-JUOZ62Y7.js";
 import {
+  lcmSessionKeyForNamespace,
   resolveCodingNamespaceOverlay
 } from "./chunk-J2WC5LF4.js";
 import {
@@ -8426,6 +8435,166 @@ ${body}`;
 ${blocks.join("\n\n")}`;
 }
 
+// src/orchestration/episodic-context-section.ts
+var EPISODIC_FACT_SCAN_LIMIT = 8;
+var EPISODIC_TURN_CHAR_LIMIT = 300;
+async function appendEpisodicContextSection(deps, options) {
+  const engine = deps.lcmEngine;
+  if (!engine?.enabled) return;
+  if (!deps.isRecallSectionEnabled("episodic-context", false)) return;
+  const maxEpisodes = deps.getRecallSectionNumber("episodic-context", "maxResults") ?? 2;
+  const maxTurns = deps.getRecallSectionNumber("episodic-context", "maxTurns") ?? 8;
+  const skip = (timing) => options.recordMetric({
+    section: "episodicContext",
+    priority: "enrichment",
+    durationMs: 0,
+    deadlineMs: options.enrichmentSectionDeadlineMs,
+    source: "skip",
+    success: true,
+    timing
+  });
+  if (maxEpisodes <= 0 || maxTurns <= 0) {
+    skip("skip(limit=0)");
+    return;
+  }
+  if (options.recalledMemoryPaths.length === 0) {
+    skip("skip(no-memories)");
+    return;
+  }
+  const outerDeadlineAtMs = options.recallOuterTimeoutMs > 0 ? options.recallStart + options.recallOuterTimeoutMs : null;
+  const remainingOuterMs = outerDeadlineAtMs === null ? null : outerDeadlineAtMs - deps.recallAssemblyClockMs();
+  const deadlineMs = resolveRecallCoreSectionDeadlineMs({
+    configuredCoreDeadlineMs: options.enrichmentSectionDeadlineMs,
+    remainingOuterMs
+  });
+  const outcome = await runRecallSectionWithinDeadline({
+    deadlineMs,
+    fallback: null,
+    parentSignal: options.abortSignal,
+    run: async (signal) => {
+      const facts = [];
+      const scanLimit = Math.min(
+        options.recalledMemoryPaths.length,
+        EPISODIC_FACT_SCAN_LIMIT
+      );
+      for (let index = 0; index < scanLimit; index += 1) {
+        const memoryPath = options.recalledMemoryPaths[index];
+        const namespace = options.recalledMemoryNamespaces[index];
+        try {
+          const storage = await deps.storageRouter.storageFor(
+            namespace ?? deps.config.defaultNamespace
+          );
+          const memory = await storage.readMemoryByPath(memoryPath);
+          const sources = memory?.frontmatter?.sources;
+          if (memory && Array.isArray(sources) && sources.length > 0) {
+            facts.push({
+              memoryId: memory.frontmatter.id,
+              rank: index,
+              sources
+            });
+          }
+        } catch (err) {
+          log.debug(
+            `episodic-context: provenance read failed for ${memoryPath}`,
+            err
+          );
+        }
+      }
+      if (facts.length === 0) return null;
+      const readNamespaces = options.namespacesEnabled ? options.scopePlan.lcmReadNamespaces : [deps.config.defaultNamespace];
+      const candidateSessionIds = (sessionKey) => {
+        const seen = /* @__PURE__ */ new Set();
+        const out = [];
+        for (const namespace of readNamespaces) {
+          const key = lcmSessionKeyForNamespace(
+            namespace,
+            sessionKey,
+            deps.config.defaultNamespace
+          ) ?? sessionKey;
+          if (!seen.has(key)) {
+            seen.add(key);
+            out.push(key);
+          }
+        }
+        return out;
+      };
+      const windows = await planEpisodeWindowsWithFallback({
+        recalledFacts: facts,
+        maxEpisodes,
+        maxTurnsPerEpisode: maxTurns,
+        locateQuote: async (quote, sessionKey) => {
+          for (const sessionId of candidateSessionIds(sessionKey)) {
+            try {
+              const hits = await engine.searchContextFull(quote, 1, sessionId);
+              if (hits.length > 0) return hits[0].turn_index;
+            } catch (err) {
+              log.debug(
+                `episodic-context: quote search failed for session ${sessionId}`,
+                err
+              );
+            }
+          }
+          return null;
+        }
+      });
+      if (windows.length === 0) return null;
+      const episodes = [];
+      for (const window of windows) {
+        if (signal.aborted) break;
+        let rows = [];
+        for (const sessionId of candidateSessionIds(window.sessionKey)) {
+          try {
+            const fetched = await engine.getTurnRange(
+              sessionId,
+              window.fromTurn,
+              window.toTurn - 1
+            );
+            if (fetched.length > 0) {
+              rows = fetched;
+              break;
+            }
+          } catch (err) {
+            log.debug(
+              `episodic-context: turn-range read failed for session ${sessionId}`,
+              err
+            );
+          }
+        }
+        if (rows.length === 0) continue;
+        const turns = rows.filter((m) => m.role === "user" || m.role === "assistant").map((m) => ({
+          role: m.role,
+          content: m.role === "user" ? cleanArchivedUserMessage(m.content) : m.content
+        })).map((turn) => ({
+          ...turn,
+          content: turn.content.length > EPISODIC_TURN_CHAR_LIMIT ? `${turn.content.slice(0, EPISODIC_TURN_CHAR_LIMIT)}\u2026` : turn.content
+        }));
+        if (turns.length === 0) continue;
+        episodes.push({
+          sessionKey: window.sessionKey,
+          fromTurn: window.fromTurn,
+          toTurn: window.toTurn,
+          memoryIds: window.memoryIds,
+          turns
+        });
+      }
+      return episodes.length > 0 ? deps.recallResultFormatter.formatEpisodicContext(episodes) : null;
+    }
+  });
+  options.recordMetric({
+    section: "episodicContext",
+    priority: "enrichment",
+    durationMs: outcome.durationMs,
+    deadlineMs,
+    source: outcome.timedOut ? "timeout" : "fresh",
+    success: true,
+    ...outcome.timedOut ? { timing: `timeout(${Math.max(0, Math.round(outcome.durationMs))}ms)` } : {}
+  });
+  if (outcome.value === null) return;
+  const maxChars = deps.getRecallSectionMaxChars("episodic-context");
+  const body = typeof maxChars === "number" ? deps.truncateRecallSectionToBudget(outcome.value, maxChars) : outcome.value;
+  deps.appendRecallSection(options.sectionBuckets, "episodic-context", body);
+}
+
 // src/orchestration/recall-profile-storage.ts
 import path9 from "path";
 function resolveCompositeProfileStorage(options) {
@@ -12249,6 +12418,29 @@ ${tmtNode.summary}`
         recallPlan: timings.recallPlan,
         queryPolicy: timings.queryPolicy
       });
+      const episodicNamespaceByPath = /* @__PURE__ */ new Map();
+      for (const result of xrayRecalledResults) {
+        if (result.path) episodicNamespaceByPath.set(result.path, result.namespace);
+      }
+      const episodicMemoryNamespaces = recalledMemoryPaths.map(
+        (memoryPath) => episodicNamespaceByPath.get(memoryPath)
+      );
+      try {
+        await appendEpisodicContextSection(this.deps, {
+          sectionBuckets,
+          recalledMemoryPaths,
+          recalledMemoryNamespaces: episodicMemoryNamespaces,
+          scopePlan,
+          namespacesEnabled,
+          enrichmentSectionDeadlineMs,
+          recallOuterTimeoutMs,
+          recallStart,
+          recordMetric: recordRecallSectionMetric,
+          abortSignal: options.abortSignal
+        });
+      } catch (err) {
+        log.debug("episodic-context: section degraded after error", err);
+      }
       const recallBudgetChars = this.deps.getRecallBudgetChars(options.budgetCharsOverride);
       const assembledRecall = this.deps.assembleRecallSections(
         sectionBuckets,
@@ -15245,7 +15437,7 @@ var OrchestratorInitCoordinator = class {
     if (signal.aborted) return;
     if (!this.deps.wearablesAutoSyncHandle && this.deps.config.wearables.enabled && this.deps.config.wearables.autoSyncEnabled && Object.values(this.deps.config.wearables.sources).some((source) => source.enabled)) {
       try {
-        const { startWearablesAutoSync } = await import("./auto-sync-FMWQQB3J.js");
+        const { startWearablesAutoSync } = await import("./auto-sync-Z52VWMNC.js");
         if (signal.aborted) return;
         this.deps.wearablesAutoSyncHandle = startWearablesAutoSync(
           {
@@ -27201,4 +27393,4 @@ export {
   blendGraphExpandedRecallScore,
   Orchestrator
 };
-//# sourceMappingURL=chunk-XIABRKF6.js.map
+//# sourceMappingURL=chunk-CLJ5QS6J.js.map