@remnic/core 9.7.9 → 9.7.11

package/dist/temporal-index-compat.js

@@ -0,0 +1,16 @@
+import {
+  clearIndexes,
+  deindexMemory,
+  indexMemoriesBatch,
+  indexMemory,
+  indexesExist
+} from "./chunk-2VN4JAX7.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  clearIndexes,
+  deindexMemory,
+  indexMemoriesBatch,
+  indexMemory,
+  indexesExist
+};
+//# sourceMappingURL=temporal-index-compat.js.map

package/dist/temporal-index-compat.js.map

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

package/dist/temporal-index.d.ts

@@ -14,6 +14,7 @@
  * - Reads/writes are batched per extraction run
  * - Both indexes are plain JSON; no external dependencies
  */
+
 interface TemporalIndex {
     /** version bumped when schema changes */
     version: number;
@@ -64,6 +65,23 @@ interface TagNode {
     aliases?: string[];
     parents?: string[];
 }
+/** Test-only observer for asserting cache read/parse behavior. */
+declare function setIndexReadObserverForTest(observer?: () => void): void;
+type TemporalIndexCompatibilityMutation = {
+    kind: "index";
+    entries: TemporalIndexEntry[];
+} | {
+    kind: "deindex";
+    entries: TemporalIndexEntry[];
+} | {
+    kind: "clear";
+};
+/** @internal Pure model shared by the deprecated synchronous compatibility surface. */
+declare function applyTemporalIndexCompatibilityMutation(raw: unknown, mutation: TemporalIndexCompatibilityMutation): TemporalIndex;
+/** @internal Pure model shared by the deprecated synchronous compatibility surface. */
+declare function applyTagIndexCompatibilityMutation(raw: unknown, mutation: TemporalIndexCompatibilityMutation): TagIndex;
+/** @internal Schema check shared by the deprecated synchronous compatibility surface. */
+declare function hasCurrentTemporalIndexSchemaForCompatibility(raw: unknown): boolean;
 /**
  * Add (or update) a memory file in both indexes.
  *
@@ -72,27 +90,27 @@ interface TagNode {
  * @param createdAt ISO timestamp of the memory's creation date
  * @param tags Array of tag strings from the memory's frontmatter
  */
-declare function indexMemory(memoryDir: string, memoryPath: string, createdAt: string, tags: string[], temporal?: Omit<Partial<TemporalIndexEntry>, "path" | "createdAt" | "tags">): void;
+declare function indexMemoryAsync(memoryDir: string, memoryPath: string, createdAt: string, tags: string[], temporal?: Omit<Partial<TemporalIndexEntry>, "path" | "createdAt" | "tags">): Promise<void>;
 /**
  * Remove a memory file from both indexes (called on deletion/archival).
  */
-declare function deindexMemory(memoryDir: string, memoryPath: string, createdAt: string, tags: string[]): void;
+declare function deindexMemoryAsync(memoryDir: string, memoryPath: string, createdAt: string, tags: string[]): Promise<void>;
 /**
  * Reset both index files to empty state.
  * Called before a full-corpus rebuild so stale paths in any surviving index
  * file do not persist after the rebuild completes.
  */
-declare function clearIndexes(memoryDir: string): void;
+declare function clearIndexesAsync(memoryDir: string): Promise<void>;
 /**
  * Returns true when both index files exist on disk.
  * Used to detect first-time enablement so callers can trigger a full rebuild.
  */
-declare function indexesExist(memoryDir: string): boolean;
+declare function indexesExistAsync(memoryDir: string): Promise<boolean>;
 /**
  * Batch-add multiple memories to both indexes in a single read-modify-write cycle.
- * More efficient than calling indexMemory() per file when adding many at once.
+ * More efficient than calling indexMemoryAsync() per file when adding many at once.
  */
-declare function indexMemoriesBatch(memoryDir: string, entries: TemporalIndexEntry[]): void;
+declare function indexMemoriesBatchAsync(memoryDir: string, entries: TemporalIndexEntry[]): Promise<void>;
 /**
  * Return the set of memory paths whose index date falls in [fromDate, toDate).
  *
@@ -135,6 +153,20 @@ declare function resolvePromptTagPrefilterAsync(memoryDir: string, prompt: strin
     expandedTags: string[];
     paths: Set<string> | null;
 }>;
+/**
+ * Run a group of index reads as ONE consistent snapshot (issue #1911, Codex
+ * Medium). The `read` callback executes inside a single withMemoryDirMutex
+ * acquisition — the same in-memory op-lock every async mutator holds across its
+ * paired temporal+tag writes — so no mutation can land between the reads inside
+ * it. A recall that reads the temporal and tag indexes together therefore never
+ * observes a half-updated state (e.g. a new temporal row with a not-yet-written
+ * tag membership) that would let prefiltering drop the current memory. The
+ * genuine-tag-miss contract is preserved: a truly absent tag still yields an
+ * empty set, only now never as a transient artifact of an in-flight write.
+ * Index reads are cache-backed (microseconds), so ordering them on the op-chain
+ * is negligible beside the multi-second QMD phase.
+ */
+declare function readIndexSnapshotAsync<T>(memoryDir: string, read: () => Promise<T>): Promise<T>;
 /**
  * Detect if a prompt is time-sensitive (mentions specific time references).
  * Used to decide whether to activate the temporal prefilter.
@@ -171,4 +203,23 @@ declare function recencyWindowBoundsFromPrompt(prompt: string, nowMs?: number):
     toDate: string;
 };
 
-export { type TagIndex, type TagNode, type TemporalIndex, type TemporalIndexEntry, type TemporalIndexEvent, clearIndexes, deindexMemory, extractTagsFromPrompt, indexMemoriesBatch, indexMemory, indexesExist, isTemporalQuery, queryByDateRangeAsync, queryByTagsAsync, queryTemporalTimelineAsync, recencyWindowBoundsFromPrompt, recencyWindowFromPrompt, resolvePromptTagPrefilterAsync };
+/**
+ * Synchronous compatibility surface for the historical temporal-index API.
+ *
+ * New runtime code must use the explicit `*Async` exports from temporal-index.
+ * These wrappers preserve return timing and boolean truthiness for published
+ * JavaScript consumers that predate the async index implementation.
+ */
+
+/** @deprecated Use `indexMemoryAsync` in new code. */
+declare function indexMemory(memoryDir: string, memoryPath: string, createdAt: string, tags: string[], temporal?: Omit<Partial<TemporalIndexEntry>, "path" | "createdAt" | "tags">): void;
+/** @deprecated Use `deindexMemoryAsync` in new code. */
+declare function deindexMemory(memoryDir: string, memoryPath: string, createdAt: string, tags: string[]): void;
+/** @deprecated Use `clearIndexesAsync` in new code. */
+declare function clearIndexes(memoryDir: string): void;
+/** @deprecated Use `indexesExistAsync` in new code. */
+declare function indexesExist(memoryDir: string): boolean;
+/** @deprecated Use `indexMemoriesBatchAsync` in new code. */
+declare function indexMemoriesBatch(memoryDir: string, entries: TemporalIndexEntry[]): void;
+
+export { type TagIndex, type TagNode, type TemporalIndex, type TemporalIndexCompatibilityMutation, type TemporalIndexEntry, type TemporalIndexEvent, applyTagIndexCompatibilityMutation, applyTemporalIndexCompatibilityMutation, clearIndexes, clearIndexesAsync, deindexMemory, deindexMemoryAsync, extractTagsFromPrompt, hasCurrentTemporalIndexSchemaForCompatibility, indexMemoriesBatch, indexMemoriesBatchAsync, indexMemory, indexMemoryAsync, indexesExist, indexesExistAsync, isTemporalQuery, queryByDateRangeAsync, queryByTagsAsync, queryTemporalTimelineAsync, readIndexSnapshotAsync, recencyWindowBoundsFromPrompt, recencyWindowFromPrompt, resolvePromptTagPrefilterAsync, setIndexReadObserverForTest };

package/dist/temporal-index.js

@@ -1,32 +1,52 @@
 import {
+  applyTagIndexCompatibilityMutation,
+  applyTemporalIndexCompatibilityMutation,
   clearIndexes,
+  clearIndexesAsync,
   deindexMemory,
+  deindexMemoryAsync,
   extractTagsFromPrompt,
+  hasCurrentTemporalIndexSchemaForCompatibility,
   indexMemoriesBatch,
+  indexMemoriesBatchAsync,
   indexMemory,
+  indexMemoryAsync,
   indexesExist,
+  indexesExistAsync,
   isTemporalQuery,
   queryByDateRangeAsync,
   queryByTagsAsync,
   queryTemporalTimelineAsync,
+  readIndexSnapshotAsync,
   recencyWindowBoundsFromPrompt,
   recencyWindowFromPrompt,
-  resolvePromptTagPrefilterAsync
-} from "./chunk-HHAA35A3.js";
+  resolvePromptTagPrefilterAsync,
+  setIndexReadObserverForTest
+} from "./chunk-2VN4JAX7.js";
 import "./chunk-PZ5AY32C.js";
 export {
+  applyTagIndexCompatibilityMutation,
+  applyTemporalIndexCompatibilityMutation,
   clearIndexes,
+  clearIndexesAsync,
   deindexMemory,
+  deindexMemoryAsync,
   extractTagsFromPrompt,
+  hasCurrentTemporalIndexSchemaForCompatibility,
   indexMemoriesBatch,
+  indexMemoriesBatchAsync,
   indexMemory,
+  indexMemoryAsync,
   indexesExist,
+  indexesExistAsync,
   isTemporalQuery,
   queryByDateRangeAsync,
   queryByTagsAsync,
   queryTemporalTimelineAsync,
+  readIndexSnapshotAsync,
   recencyWindowBoundsFromPrompt,
   recencyWindowFromPrompt,
-  resolvePromptTagPrefilterAsync
+  resolvePromptTagPrefilterAsync,
+  setIndexReadObserverForTest
 };
 //# sourceMappingURL=temporal-index.js.map

package/dist/transfer/types.d.ts

@@ -20,26 +20,26 @@ declare const ExportManifestV1Schema: z.ZodObject<{
         bytes: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }>;
 type ExportManifestV1 = z.infer<typeof ExportManifestV1Schema>;
@@ -75,26 +75,26 @@ declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
@@ -109,15 +109,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -126,15 +126,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -313,16 +313,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -334,16 +334,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         forkRoot: string;
     } | null;
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -464,16 +464,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -485,16 +485,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null;
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -507,27 +507,25 @@ declare const ExportManifestV2Schema: z.ZodObject<{
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 2;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -539,28 +537,28 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null;
     };
-}, {
     schemaVersion: 2;
+    includesTranscripts: boolean;
+}, {
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -572,6 +570,8 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null | undefined;
     };
+    schemaVersion: 2;
+    includesTranscripts: boolean;
 }>;
 type ExportManifestV2 = z.infer<typeof ExportManifestV2Schema>;
 declare const ExportBundleV2Schema: z.ZodObject<{
@@ -683,16 +683,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -704,16 +704,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -726,27 +726,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             } | null | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -758,28 +756,28 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         };
-    }, {
         schemaVersion: 2;
+        includesTranscripts: boolean;
+    }, {
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -791,6 +789,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -804,27 +804,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -836,6 +834,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;
@@ -843,27 +843,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -875,6 +873,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;

package/dist/verified-recall.js

@@ -1,12 +1,12 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-KPXAJ77O.js";
+} from "./chunk-YLTG6BO4.js";
 import "./chunk-2A3OXAP2.js";
 import "./chunk-ZBJMUXZH.js";
-import "./chunk-PV7E2FGY.js";
-import "./chunk-B3ABVQ36.js";
+import "./chunk-KXLRMM35.js";
 import "./chunk-L2B3EE7B.js";
+import "./chunk-B3ABVQ36.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-VSMRDBFT.js";
 import "./chunk-LTJAMRGI.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.7.9",
+  "version": "9.7.11",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3010,7 +3010,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.7.9"
+    "@remnic/coding-graph": "^9.7.11"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-boundary.ts

@@ -102,6 +102,8 @@ export const OPERATION_NAMES = [
   "shared_context_write_output",
   "shared_feedback_record",
   "shared_priorities_append",
+  "relay_mission_append",
+  "relay_mission_read",
   "shared_context_cross_signals_run",
   "shared_context_curate_daily",
   "compounding_weekly_synthesize",