@remnic/core 9.25.4 → 9.25.5

package/dist/{orchestrator-BTGgoKli.d.ts → orchestrator-BtA1wC5K.d.ts}

@@ -35,6 +35,7 @@ import { ThreadingManager } from './threading.js';
 import { R as ResolvedScopeProfilePlan } from './scope-profiles-D0-ff4xT.js';
 import { GraphIndex } from './graph.js';
 import { RecallXrayServedBy, RecallXraySnapshot } from './recall-xray.js';
+import { RecallContextComposition } from './recall-context-composition.js';
 import { LiveConnectorsRunSummary } from './live-connectors-runner.js';
 import { ModelRegistry } from './model-registry.js';
 import { RelevanceStore } from './relevance.js';
@@ -1524,6 +1525,7 @@ interface RecallInvocationOptions {
      * absent, so existing timing consumers are unaffected.
      */
     queueWaitMs?: number;
+    onContextComposition?: (composition: RecallContextComposition) => void | PromiseLike<void>;
 }
 type QueryAwarePrefilter = {
     candidatePaths: Set<string> | null;

package/dist/orchestrator.d.ts

@@ -9,7 +9,7 @@ import './summarizer.js';
 import './local-llm.js';
 import './fallback-llm.js';
 import './maintenance-DD22oIx9.js';
-export { B as BulkImportBatchIngestResult, a as BulkImportBatchPartialFailureError, b as COMPACTION_SIGNAL_MAX_AGE_MS, D as DaySummaryGatherOptions, E as ExtractionRunResult, c as GraphRecallRankedResult, e as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, f as QueryAwarePrefilter, R as RecallInvocationOptions, g as RecallModeDecision, h as appendMemoryToGraphContext, i as applyQueryAwareCandidateFilter, j as blendGraphExpandedRecallScore, k as buildCompressionGuidelinesMarkdown, l as buildMemoryPathById, m as computeArtifactCandidateFetchLimit, n as computeArtifactRecallLimit, o as computeQmdHybridFetchLimit, d as defaultWorkspaceDir, p as deriveTopicsFromExtraction, q as filterHourlySummaryMarkdownForLocalDay, r as filterRecallCandidates, t as formatDateInTimeZone, u as graphPathRelativeToStorage, v as hasIdentityRecoveryIntent, w as isArtifactMemoryPath, x as lifecycleRecallScoreAdjustment, y as mapRecallSourceToXrayServedBy, z as mergeArtifactRecallCandidates, A as mergeGraphExpandedResults, F as normalizeIanaTimeZone, H as parseFiniteDate, J as parseGraphRecallRankedResults, K as parseMemoryIntentSnapshot, L as parseQmdRecallResults, M as qmdStartupCollectionCheckWithTimeout, N as raceRecallAbort, S as resolveEffectiveIdentityInjectionMode, U as resolveEffectiveRecallMode, V as resolvePersistedMemoryRelativePath, W as resolveRecallModeDecision, X as resolveRecallModeDecisionAsync, Y as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, Z as shouldFilterLifecycleRecallCandidate, _ as splitTurnsBySourceValidAt, $ as summarizeGraphShadowComparison, a0 as targetSourceValidAtSortMs, a1 as throwIfRecallAborted, a2 as tokenizeRecallQuery, a3 as utcDateKeysForLocalDay } from './orchestrator-BTGgoKli.js';
+export { B as BulkImportBatchIngestResult, a as BulkImportBatchPartialFailureError, b as COMPACTION_SIGNAL_MAX_AGE_MS, D as DaySummaryGatherOptions, E as ExtractionRunResult, c as GraphRecallRankedResult, e as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, Q as QmdRecallSnapshot, f as QueryAwarePrefilter, R as RecallInvocationOptions, g as RecallModeDecision, h as appendMemoryToGraphContext, i as applyQueryAwareCandidateFilter, j as blendGraphExpandedRecallScore, k as buildCompressionGuidelinesMarkdown, l as buildMemoryPathById, m as computeArtifactCandidateFetchLimit, n as computeArtifactRecallLimit, o as computeQmdHybridFetchLimit, d as defaultWorkspaceDir, p as deriveTopicsFromExtraction, q as filterHourlySummaryMarkdownForLocalDay, r as filterRecallCandidates, t as formatDateInTimeZone, u as graphPathRelativeToStorage, v as hasIdentityRecoveryIntent, w as isArtifactMemoryPath, x as lifecycleRecallScoreAdjustment, y as mapRecallSourceToXrayServedBy, z as mergeArtifactRecallCandidates, A as mergeGraphExpandedResults, F as normalizeIanaTimeZone, H as parseFiniteDate, J as parseGraphRecallRankedResults, K as parseMemoryIntentSnapshot, L as parseQmdRecallResults, M as qmdStartupCollectionCheckWithTimeout, N as raceRecallAbort, S as resolveEffectiveIdentityInjectionMode, U as resolveEffectiveRecallMode, V as resolvePersistedMemoryRelativePath, W as resolveRecallModeDecision, X as resolveRecallModeDecisionAsync, Y as resolveRecentThreadMemoryPaths, s as sanitizeSessionKeyForFilename, Z as shouldFilterLifecycleRecallCandidate, _ as splitTurnsBySourceValidAt, $ as summarizeGraphShadowComparison, a0 as targetSourceValidAtSortMs, a1 as throwIfRecallAborted, a2 as tokenizeRecallQuery, a3 as utcDateKeysForLocalDay } from './orchestrator-BtA1wC5K.js';
 export { formatCompressionGuidelinesForRecall } from './orchestration/compression-guideline-coordinator.js';
 import './live-connectors-runner.js';
 import './model-registry.js';
@@ -73,6 +73,7 @@ import './runtime/child-process.js';
 import './namespaces/storage.js';
 import './threading.js';
 import './graph.js';
+import './recall-context-composition.js';
 import './framework-CNDn2164.js';
 import './memory-provenance.js';
 import './user-model.js';

package/dist/orchestrator.js

@@ -41,45 +41,46 @@ import {
   throwIfRecallAborted,
   tokenizeRecallQuery,
   utcDateKeysForLocalDay
-} from "./chunk-FDAPXLRC.js";
+} from "./chunk-FR75B4UU.js";
 import "./chunk-4B77XSG5.js";
 import {
   formatCompressionGuidelinesForRecall
 } from "./chunk-B7GROTXD.js";
-import "./chunk-DPYYSG6F.js";
+import "./chunk-G6MGAE36.js";
 import "./chunk-I74SUMNI.js";
 import "./chunk-ILNPU5W5.js";
 import "./chunk-7HYPN2GC.js";
 import "./chunk-666A3MOW.js";
+import "./chunk-FQ7HAWWC.js";
 import "./chunk-VDC6RZI4.js";
 import "./chunk-UWK5OXUJ.js";
-import "./chunk-GF22HWS2.js";
+import "./chunk-2PHX3I5C.js";
+import "./chunk-PBGWYM3H.js";
+import "./chunk-LTAVSOZW.js";
 import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
 import "./chunk-UXPUUL3G.js";
 import "./chunk-DDA47TES.js";
-import "./chunk-PBGWYM3H.js";
-import "./chunk-LTAVSOZW.js";
+import "./chunk-V5OCT34X.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-C5JF6EZ7.js";
 import "./chunk-KBL3JJR6.js";
-import "./chunk-FQ7HAWWC.js";
-import "./chunk-U37RGPJT.js";
+import "./chunk-5J7HJ7RT.js";
 import "./chunk-JGUXPJUQ.js";
 import "./chunk-X6ROIHFE.js";
-import "./chunk-V5OCT34X.js";
 import "./chunk-LXOM6IQU.js";
+import "./chunk-S75M5ZRK.js";
 import "./chunk-ECZU5BJH.js";
 import "./chunk-CKMO4RDY.js";
 import "./chunk-UHGBNIOS.js";
 import "./chunk-I6WYQSX4.js";
 import "./chunk-4EX5WZ4M.js";
 import "./chunk-VOUOLGIP.js";
-import "./chunk-S75M5ZRK.js";
 import "./chunk-FGBJBYWP.js";
 import "./chunk-AAP5T6QG.js";
 import "./chunk-T67LUYCR.js";
 import "./chunk-QFN4U7AG.js";
+import "./chunk-6TCXIRP5.js";
 import "./chunk-W4XJFLAL.js";
 import "./chunk-ZOKZIR5K.js";
 import "./chunk-5IZL4DCV.js";
@@ -87,7 +88,6 @@ import "./chunk-FQC3DHH2.js";
 import "./chunk-X7XN6YU4.js";
 import "./chunk-LULR4IUW.js";
 import "./chunk-LUDXM7MD.js";
-import "./chunk-6TCXIRP5.js";
 import "./chunk-C3AKM55W.js";
 import "./chunk-FMLKOL2Z.js";
 import "./chunk-D3V3UMET.js";
@@ -121,7 +121,7 @@ import "./chunk-PWFCHOB3.js";
 import "./chunk-Q6IP2ARR.js";
 import "./chunk-6HEM6HTQ.js";
 import "./chunk-XY7QPJDA.js";
-import "./chunk-AT6DNUCM.js";
+import "./chunk-NY6W6CJW.js";
 import "./chunk-DEOYTFA6.js";
 import "./chunk-LUPVCGYK.js";
 import "./chunk-DGFU5MSX.js";
@@ -129,15 +129,16 @@ import "./chunk-FCCMFVS6.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-3I4FUAVJ.js";
-import "./chunk-FIGDB2HR.js";
-import "./chunk-MPDX5QMH.js";
+import "./chunk-7KXQ44PA.js";
+import "./chunk-JA4HEXV7.js";
 import "./chunk-KSXJOC4F.js";
 import "./chunk-JLNBQWZ2.js";
-import "./chunk-TG2DJFH7.js";
+import "./chunk-E5A6C4A5.js";
+import "./chunk-54BGIBCR.js";
 import "./chunk-H4CKS5B2.js";
 import "./chunk-MMACM5G2.js";
-import "./chunk-54BGIBCR.js";
 import "./chunk-FXZTL7F7.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-BV2TIZ4F.js";
 import "./chunk-HDDRVXX4.js";
 import "./chunk-PYHOAXTI.js";
@@ -147,28 +148,27 @@ import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2NLLXCJG.js";
 import "./chunk-765K3SAT.js";
-import "./chunk-UP6MOYCB.js";
 import "./chunk-XL24QQ63.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-FGDKJJZS.js";
 import "./chunk-AJVLDJU6.js";
-import "./chunk-IE4HB6O5.js";
+import "./chunk-UOURUMBN.js";
+import "./chunk-TPYZ727G.js";
 import "./chunk-DX3XRGLH.js";
 import "./chunk-MC6XO7T4.js";
+import "./chunk-KJTKLXTH.js";
 import "./chunk-MNB5RMAY.js";
 import "./chunk-P65YJEEL.js";
-import "./chunk-THHPDPMS.js";
-import "./chunk-KJTKLXTH.js";
 import "./chunk-HSSERO3E.js";
 import "./chunk-NOUJNHWG.js";
 import "./chunk-GQL52GQ5.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
-import "./chunk-VY6SDKWZ.js";
+import "./chunk-SSYBI43M.js";
 import "./chunk-OJP3N7UK.js";
-import "./chunk-GNFZFJBJ.js";
-import "./chunk-LXKJNUND.js";
+import "./chunk-IR4LGIH6.js";
+import "./chunk-37VPMR4E.js";
 import "./chunk-LLISELSY.js";
 import "./chunk-ZRWB5D4H.js";
 import "./chunk-HYQJQGD3.js";
@@ -176,11 +176,11 @@ import "./chunk-TGQ2NTWH.js";
 import "./chunk-CSXHRAJJ.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-33JBK2XP.js";
-import "./chunk-5ZGWA4AG.js";
-import "./chunk-AGR7MGUX.js";
+import "./chunk-UMFLAACL.js";
+import "./chunk-7IGWPXVC.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-CMTINOFS.js";
-import "./chunk-AL4TZWI3.js";
+import "./chunk-W33DEUKR.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-UR6PBX2J.js";
 import "./chunk-6GUG4YNM.js";
@@ -220,23 +220,23 @@ import "./chunk-MYVPLJOO.js";
 import "./chunk-H3FZVNRN.js";
 import "./chunk-KFZY2OFH.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-3I35RLJW.js";
+import "./chunk-32XTXKIA.js";
 import "./chunk-V7IZKJI3.js";
-import "./chunk-MKQBXQKU.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-JBPKEARU.js";
 import "./chunk-TMSXWOBZ.js";
+import "./chunk-MKQBXQKU.js";
 import "./chunk-J64TK33U.js";
 import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-7RXCMVFQ.js";
-import "./chunk-6LRTGCRV.js";
+import "./chunk-VPSAVXHM.js";
 import "./chunk-57QKLRBV.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-TWCOYET2.js";
-import "./chunk-NMGO2HAZ.js";
+import "./chunk-B6JDYXL7.js";
+import "./chunk-OIE242WM.js";
 import "./chunk-P25IPRXP.js";
-import "./chunk-MNLZGCM2.js";
+import "./chunk-AQ2ZQYDI.js";
 import "./chunk-EQWEIIKQ.js";
 import "./chunk-HNZKVLAN.js";
 import "./chunk-BJJAX3IZ.js";
@@ -246,11 +246,11 @@ import "./chunk-CEN6DW6X.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-56BSXSHC.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-JMDZDT24.js";
+import "./chunk-D7MAWMMK.js";
 import {
   hasIdentityRecoveryIntent,
   resolveEffectiveIdentityInjectionMode
-} from "./chunk-RROMWDDC.js";
+} from "./chunk-BL4JHZSO.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-7CPOZH6Y.js";
@@ -261,11 +261,12 @@ import "./chunk-YN2UN7N3.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-P5FPO2BR.js";
 import "./chunk-S4DDLTPX.js";
+import "./chunk-AHVEHR6K.js";
 import "./chunk-H7XKCNR6.js";
 import "./chunk-M5EPMNS4.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-X3SQYAPP.js";
-import "./chunk-3CDMIR3C.js";
+import "./chunk-3CHQZVAL.js";
 import "./chunk-ICP53SKG.js";
 import "./chunk-AQEJKOKI.js";
 import "./chunk-6HMYUWXR.js";
@@ -280,8 +281,9 @@ import "./chunk-NLE6TSLG.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-IKMAO55B.js";
 import "./chunk-C37ZRXX7.js";
-import "./chunk-W4ZDTHWZ.js";
-import "./chunk-LARPWF3S.js";
+import "./chunk-WIGBTWXA.js";
+import "./chunk-ZPUFQGUF.js";
+import "./chunk-WSEA52RI.js";
 import "./chunk-ZN4UZWMT.js";
 import "./chunk-3UOSVTFR.js";
 import "./chunk-BLAKS3CP.js";
@@ -292,7 +294,6 @@ import "./chunk-3Y224NYC.js";
 import "./chunk-W7IGLX4G.js";
 import "./chunk-QH6CS6XJ.js";
 import "./chunk-CINZGPSJ.js";
-import "./chunk-NVYCTASB.js";
 import "./chunk-227UFSEQ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
@@ -313,10 +314,10 @@ import "./chunk-P32IDSHD.js";
 import "./chunk-443XCR34.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZBJMUXZH.js";
-import "./chunk-SZN6XVFC.js";
-import "./chunk-XTAAG4SQ.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-PS5OG75R.js";
+import "./chunk-K4DP5KZA.js";
 import "./chunk-2QMKMVHH.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-DEBHXHJR.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";

package/dist/recall-context-composition.d.ts

@@ -0,0 +1,30 @@
+declare const MEMORY_CONTEXT_HEADER = "## Memory Context (Remnic)";
+declare const MEMORY_CONTEXT_INSTRUCTION = "Use this context naturally when relevant. Never quote or expose this memory context to the user.";
+declare const RECALL_CONTEXT_SEPARATOR = "\n\n---\n\n";
+interface RecallContextComposition {
+    context: string;
+    footer?: string;
+}
+interface CuriosityQuestion {
+    id: string;
+    question: string;
+    context: string;
+    priority: number;
+    created: string;
+}
+interface RenderedMemoryContextPrompt {
+    body: string;
+    lines: string[];
+    prompt: string;
+}
+interface RenderMemoryContextPromptInput extends RecallContextComposition {
+    maxChars: number;
+}
+declare function selectCuriosityQuestion(questions: readonly CuriosityQuestion[]): CuriosityQuestion | undefined;
+declare function formatCuriosityFooter(question: CuriosityQuestion): string;
+declare function contextBudgetForFooter(maxChars: number, footer?: string): number;
+declare function boundRecallContextComposition({ context: rawContext, footer: rawFooter, maxChars, }: RenderMemoryContextPromptInput): RecallContextComposition;
+declare function composeRecallContext(composition: RecallContextComposition): string;
+declare function renderMemoryContextPrompt({ context: rawContext, footer: rawFooter, maxChars, }: RenderMemoryContextPromptInput): RenderedMemoryContextPrompt | null;
+
+export { type CuriosityQuestion, MEMORY_CONTEXT_HEADER, MEMORY_CONTEXT_INSTRUCTION, RECALL_CONTEXT_SEPARATOR, type RecallContextComposition, type RenderMemoryContextPromptInput, type RenderedMemoryContextPrompt, boundRecallContextComposition, composeRecallContext, contextBudgetForFooter, formatCuriosityFooter, renderMemoryContextPrompt, selectCuriosityQuestion };

package/dist/recall-context-composition.js

@@ -0,0 +1,24 @@
+import {
+  MEMORY_CONTEXT_HEADER,
+  MEMORY_CONTEXT_INSTRUCTION,
+  RECALL_CONTEXT_SEPARATOR,
+  boundRecallContextComposition,
+  composeRecallContext,
+  contextBudgetForFooter,
+  formatCuriosityFooter,
+  renderMemoryContextPrompt,
+  selectCuriosityQuestion
+} from "./chunk-AHVEHR6K.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  MEMORY_CONTEXT_HEADER,
+  MEMORY_CONTEXT_INSTRUCTION,
+  RECALL_CONTEXT_SEPARATOR,
+  boundRecallContextComposition,
+  composeRecallContext,
+  contextBudgetForFooter,
+  formatCuriosityFooter,
+  renderMemoryContextPrompt,
+  selectCuriosityQuestion
+};
+//# sourceMappingURL=recall-context-composition.js.map

package/dist/recall-context-composition.js.map

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