@xdarkicex/openclaw-memory-libravdb 1.3.21 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.3.21",
+  "version": "1.4.0",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/src/context-engine.ts

@@ -12,7 +12,11 @@ import {
   rankSection7VariantCandidates,
 } from "./scoring.js";
 import { buildInjectedMemoryMessageContent, buildMemoryHeader, recentIds } from "./recall-utils.js";
-import { detectTemporalQuerySignal, rankTemporalRecoveryCandidates } from "./temporal.js";
+import {
+  decideTemporalSelectorGuard,
+  detectTemporalQuerySignal,
+  rankTemporalRecoveryCandidates,
+} from "./temporal.js";
 import type { TemporalRecoveryRankingResult } from "./temporal.js";
 import { countTokens, estimateTokens, fitPromptBudget, fitPromptBudgetFirstFit } from "./tokens.js";
 import type { RpcGetter } from "./plugin-runtime.js";
@@ -194,6 +198,7 @@ export function buildContextEngineFactory(
         } satisfies ContextAssembleResult;
       }
       const temporalQuery = detectTemporalQuerySignal(queryText);
+      const temporalSelectorGuard = decideTemporalSelectorGuard(queryText, temporalQuery);
 
       const excluded = recentIds(messages, 4);
       const cached = recallCache.take({ userId, queryText });
@@ -258,6 +263,7 @@ export function buildContextEngineFactory(
           excluded,
           queryText,
           temporalQuery,
+          temporalSelectorGuard,
           sessionId,
           userId,
           messages,
@@ -293,6 +299,7 @@ export function buildContextEngineFactory(
       excluded,
       queryText,
       temporalQuery,
+      temporalSelectorGuard,
       sessionId,
       userId,
       messages,
@@ -310,6 +317,7 @@ export function buildContextEngineFactory(
       excluded: string[];
       queryText: string;
       temporalQuery: ReturnType<typeof detectTemporalQuerySignal>;
+      temporalSelectorGuard: ReturnType<typeof decideTemporalSelectorGuard>;
       sessionId: string;
       userId: string;
       messages: Array<{ role: string; content: string }>;
@@ -608,7 +616,7 @@ export function buildContextEngineFactory(
             excludeIds: recoveryExcludeIDs,
           });
           const annotatedUserResults = annotateCollection(rawUserResults.results ?? [], `turns:${userId}`);
-          temporalRecoveryResult = temporalQuery.active
+          temporalRecoveryResult = temporalSelectorGuard.shouldApply
             ? rankTemporalRecoveryCandidates(annotatedUserResults, {
                 queryText,
                 maxSelected: 3,
@@ -709,6 +717,8 @@ export function buildContextEngineFactory(
               temporalQueryIndicator: temporalQuery.indicator,
               temporalQueryActive: temporalQuery.active,
               temporalQueryPatterns: temporalQuery.matchedPatterns,
+              temporalSelectorApplied: temporalSelectorGuard.shouldApply,
+              temporalSelectorReason: temporalSelectorGuard.reason,
               temporalRecoverySlots: temporalRecoveryResult?.slots,
               rawUserRecoveryCandidates: rawUserRecoveryDebug,
             }

package/src/temporal.ts

@@ -112,6 +112,12 @@ export interface TemporalQuerySignal {
   matchedPatterns: string[];
 }
 
+export interface TemporalSelectorGuardDecision {
+  shouldApply: boolean;
+  slots: string[];
+  reason: string;
+}
+
 export interface TemporalRecoveryDebugCandidate {
   id: string;
   text: string;
@@ -276,6 +282,48 @@ export function rankTemporalRecoveryCandidates(
   return { ranked, debug, temporalQuery, slots };
 }
 
+export function decideTemporalSelectorGuard(
+  queryText: string,
+  temporalQuery: TemporalQuerySignal = detectTemporalQuerySignal(queryText),
+): TemporalSelectorGuardDecision {
+  const slots = extractTemporalSlots(queryText);
+  if (!temporalQuery.active) {
+    return {
+      shouldApply: false,
+      slots,
+      reason: "temporal query gate inactive",
+    };
+  }
+
+  const strongCompositionalPattern = temporalQuery.matchedPatterns.some((pattern) =>
+    pattern === "how many days" ||
+    pattern === "how long" ||
+    pattern === "before or after" ||
+    pattern === "since or between"
+  );
+  if (!strongCompositionalPattern) {
+    return {
+      shouldApply: false,
+      slots,
+      reason: "query lacks strong compositional temporal pattern",
+    };
+  }
+
+  if (slots.length !== 2) {
+    return {
+      shouldApply: false,
+      slots,
+      reason: "query did not resolve to exactly two temporal slots",
+    };
+  }
+
+  return {
+    shouldApply: true,
+    slots,
+    reason: "strong temporal query with two-slot decomposition",
+  };
+}
+
 export function resetTemporalCachesForTest(): void {
   temporalAnchorCache.clear();
 }

package/src/types.ts

@@ -217,6 +217,8 @@ export interface ContextAssembleResult {
     temporalQueryIndicator?: number;
     temporalQueryActive?: boolean;
     temporalQueryPatterns?: string[];
+    temporalSelectorApplied?: boolean;
+    temporalSelectorReason?: string;
     temporalRecoverySlots?: string[];
   };
 }