@remnic/core 9.3.679 → 9.3.681

package/dist/semantic-rule-verifier.js

@@ -1,31 +1,31 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-LVTTO3VC.js";
-import "./chunk-EUM7CZFM.js";
+} from "./chunk-KACIOX42.js";
+import "./chunk-TY5NT3T3.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-FMSDA2D3.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-4DJQYKMN.js";
-import "./chunk-ZBJMUXZH.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-VF4XKTX3.js";
 import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
+import "./chunk-ZBJMUXZH.js";
 import "./chunk-PZ5AY32C.js";
 export {
   compareVerifiedSemanticRuleResults,

package/dist/storage.js

@@ -9,29 +9,29 @@ import {
   parseEntityFile,
   serializeEntityFile,
   stripAttributesSuffix
-} from "./chunk-EUM7CZFM.js";
+} from "./chunk-TY5NT3T3.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-FMSDA2D3.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-4DJQYKMN.js";
-import "./chunk-2ODBA7MQ.js";
+import "./chunk-VF4XKTX3.js";
 import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VS2IYZRU.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   ContentHashIndex,

package/dist/transfer/backup.js

@@ -4,11 +4,11 @@ import {
 import "../chunk-765K3SAT.js";
 import "../chunk-X7Y7WX73.js";
 import "../chunk-J4EB7DNW.js";
-import "../chunk-UI3NYK34.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
+import "../chunk-UI3NYK34.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/transfer/capsule-export.js

@@ -5,11 +5,11 @@ import {
 import "../chunk-WEHSQBFR.js";
 import "../chunk-X7Y7WX73.js";
 import "../chunk-J4EB7DNW.js";
-import "../chunk-UI3NYK34.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
+import "../chunk-UI3NYK34.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/transfer/capsule-import.js

@@ -4,10 +4,10 @@ import {
 import "../chunk-VF4XKTX3.js";
 import "../chunk-WEHSQBFR.js";
 import "../chunk-X7Y7WX73.js";
-import "../chunk-GCGJW34D.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
+import "../chunk-GCGJW34D.js";
 import "../chunk-A6XUJE5D.js";
 import "../chunk-VS2IYZRU.js";
 import "../chunk-PZ5AY32C.js";

package/dist/transfer/import-sqlite.js

@@ -1,8 +1,8 @@
 import {
   importSqlite
-} from "../chunk-AGNBY3VG.js";
-import "../chunk-Z734BLO3.js";
+} from "../chunk-APJQ6UEA.js";
 import "../chunk-G4IAEX6D.js";
+import "../chunk-Z734BLO3.js";
 import "../chunk-6KYMPV2O.js";
 import "../chunk-GCGJW34D.js";
 import "../chunk-PZ5AY32C.js";

package/dist/transfer/types.d.ts

@@ -11,20 +11,20 @@ declare const ExportManifestV1Schema: z.ZodObject<{
         sha256: z.ZodString;
         bytes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }, {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
     createdAt: string;
     files: {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }[];
     format: "openclaw-engram-export";
@@ -34,8 +34,8 @@ declare const ExportManifestV1Schema: z.ZodObject<{
     schemaVersion: 1;
     createdAt: string;
     files: {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }[];
     format: "openclaw-engram-export";
@@ -66,20 +66,20 @@ declare const ExportBundleV1Schema: z.ZodObject<{
             sha256: z.ZodString;
             bytes: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }, {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         schemaVersion: 1;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
@@ -89,8 +89,8 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         schemaVersion: 1;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
@@ -112,8 +112,8 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         schemaVersion: 1;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
@@ -129,8 +129,8 @@ declare const ExportBundleV1Schema: z.ZodObject<{
         schemaVersion: 1;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
@@ -313,34 +313,34 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     description: string;
     version: string;
+    parentCapsule: string | null;
     parent: {
         version: string;
         capsuleId: string;
         forkRoot: string;
     } | null;
-    parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
         directAnswerEnabled: boolean;
     };
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -367,12 +367,12 @@ declare const ExportManifestV2Schema: z.ZodObject<{
         sha256: z.ZodString;
         bytes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }, {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }>, "many">;
     capsule: z.ZodObject<{
@@ -464,34 +464,34 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
+        parentCapsule: string | null;
         parent: {
             version: string;
             capsuleId: string;
             forkRoot: string;
         } | null;
-        parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
             directAnswerEnabled: boolean;
         };
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -510,30 +510,30 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     schemaVersion: 2;
     createdAt: string;
     files: {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }[];
     format: "openclaw-engram-export";
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
+        parentCapsule: string | null;
         parent: {
             version: string;
             capsuleId: string;
             forkRoot: string;
         } | null;
-        parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
             directAnswerEnabled: boolean;
@@ -543,21 +543,21 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     schemaVersion: 2;
     createdAt: string;
     files: {
-        path: string;
         sha256: string;
+        path: string;
         bytes: number;
     }[];
     format: "openclaw-engram-export";
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -586,12 +586,12 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             sha256: z.ZodString;
             bytes: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }, {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }>, "many">;
         capsule: z.ZodObject<{
@@ -683,34 +683,34 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
+            parentCapsule: string | null;
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
-            parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
                 directAnswerEnabled: boolean;
             };
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -729,30 +729,30 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         schemaVersion: 2;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
+            parentCapsule: string | null;
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
-            parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
                 directAnswerEnabled: boolean;
@@ -762,21 +762,21 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         schemaVersion: 2;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -807,30 +807,30 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         schemaVersion: 2;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;
+            parentCapsule: string | null;
             parent: {
                 version: string;
                 capsuleId: string;
                 forkRoot: string;
             } | null;
-            parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
                 directAnswerEnabled: boolean;
@@ -846,21 +846,21 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         schemaVersion: 2;
         createdAt: string;
         files: {
-            path: string;
             sha256: string;
+            path: string;
             bytes: number;
         }[];
         format: "openclaw-engram-export";
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            schemaVersion: string;
             id: string;
             description: string;
             version: string;

package/dist/utils/serialize-mutations.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Instance-scoped keyed serializer. Holds the per-key chain map so that all
+ * tasks queued under the same key on the SAME serializer run strictly in order.
+ *
+ * The map is instance-scoped (not module-level) so tests can construct a fresh
+ * serializer per case and avoid cross-test contamination, and so adopters that
+ * want isolation (e.g. one serializer per storage root) can have it. The free
+ * {@link serializeMutations} export delegates to a single shared default
+ * instance for callers that want process-wide serialization.
+ */
+declare class MutationSerializer {
+    private readonly chains;
+    /**
+     * Run `task` strictly after every other task already queued under `key` on
+     * this serializer has settled.
+     *
+     * Rejection recovery (rule #40, mirroring the catalog's `queueCritical`):
+     * if a prior task rejects, later tasks STILL RUN, while the rejecting task's
+     * error is surfaced to ITS OWN caller. Concretely, the recovered tail is
+     * `run.then(noop, noop)` — never a bare `.then(fn)`, which would let one
+     * failure kill every queued task behind it.
+     *
+     * No unbounded growth: when a chain's last task settles and no newer task
+     * chained onto it, its entry is deleted (the storage router's
+     * `inFlightResolved` marker-then-clear discipline).
+     */
+    serialize<T>(key: string, task: () => Promise<T>): Promise<T>;
+    /**
+     * Test-only: the number of keys with a not-yet-cleaned chain. Used to assert
+     * the no-unbounded-growth invariant. Not part of the public contract.
+     */
+    pendingKeysForTest(): number;
+}
+/**
+ * Free-function entry point (issue #1524 signature). Serializes `task` against
+ * every other task queued under `key` across the whole process, via a shared
+ * default {@link MutationSerializer}. For isolated/testable serialization,
+ * construct a `MutationSerializer` directly.
+ */
+declare function serializeMutations<T>(key: string, task: () => Promise<T>): Promise<T>;
+/** Options for {@link withHeldFileLock}. */
+interface HeldFileLockOptions {
+    /**
+     * A lock whose mtime is older than this (in ms) is treated as a crashed
+     * holder and broken. Required — there is no safe default, since the right
+     * value depends on how long the guarded critical section can legitimately
+     * run.
+     */
+    readonly staleMs: number;
+    /**
+     * Bounded acquisition: give up trying to acquire a busy lock after this long
+     * (ms) and invoke `task(false)` best-effort WITHOUT holding the lock, rather
+     * than blocking forever or crashing the primary op. Default 5000ms (matches
+     * the namespace catalog's `REBUILD_LOCK_MAX_WAIT_MS`).
+     */
+    readonly maxWaitMs?: number;
+    /**
+     * Poll interval (ms) while waiting for a busy lock to clear. Default 50ms.
+     */
+    readonly pollMs?: number;
+    /**
+     * While WE hold the lock, refresh its mtime on this cadence (ms) so a
+     * legitimately long task is not mistaken for a crashed holder and broken out
+     * from under. Default `floor(staleMs / 3)` (at least 100ms), mirroring the
+     * catalog heartbeat ratio. Must be comfortably below `staleMs`.
+     */
+    readonly heartbeatMs?: number;
+    /**
+     * Test seam (NG7Bg, #1506 round 28): fires AFTER a lock is judged stale and
+     * BEFORE the re-verify + unlink, simulating a replacement lock being created
+     * in the race window. No-op in production.
+     */
+    readonly onBeforeBreakStaleUnlinkForTest?: () => Promise<void> | void;
+    /**
+     * Test seam (codex P2): fires AFTER the release rename moves the lock to a
+     * trash path and BEFORE the ownership re-verify/restore — simulating a third
+     * contender acquiring the (now-empty) lockPath in the race window. No-op in
+     * production. Used to prove the pre-check prevents the rename entirely.
+     */
+    readonly onAfterReleaseRenameForTest?: () => Promise<void> | void;
+    /**
+     * Best-effort hook for non-fatal lock warnings (heartbeat refresh failure,
+     * release-time ownership check failure). Never throws into the caller. If
+     * omitted, warnings are swallowed (the lock is advisory; release/heartbeat
+     * failures must never crash the guarded op).
+     */
+    readonly onLockWarning?: (message: string, err: unknown) => void;
+}
+/**
+ * Run `task` under an exclusive on-disk lock at `lockPath`.
+ *
+ * Cross-process mutex via `open(lockPath, "wx")` (atomic exclusive create).
+ * While held, a heartbeat timer refreshes the lock's mtime so a legitimately
+ * long task is not mistaken for a crashed holder and broken out from under. A
+ * lock older than `opts.staleMs` is treated as stale and broken — but
+ * REPLACEMENT-SAFE (NG7Bg): we capture the stale lock's identity (full content
+ * line: `<pid> <owner-uuid> <iso>`) when judging it stale, then RE-READ and
+ * RE-STAT immediately before `unlink`, deleting only if byte-identical AND
+ * still stale. A replacement lock created in the window has a different owner
+ * id / timestamp, so its content differs and is left untouched.
+ *
+ * `task` receives `acquired: boolean` — `true` when we hold the lock, `false`
+ * when acquisition timed out (best-effort). The signature takes
+ * `(acquired) => Promise<T>` rather than the issue's sketched `() => Promise<T>`
+ * so this can be the SINGLE lock home (issue: "do NOT leave two lock
+ * implementations; pick one home"): the catalog's touch path needs to DROP on
+ * timeout, which requires knowing whether the lock was acquired. A caller that
+ * ignores the flag is still assignable (`() => Promise<T>` ⊆
+ * `(acquired: boolean) => Promise<T>` in TypeScript).
+ *
+ * Release is ownership-checked: we only `unlink` a lock whose content still
+ * identifies THIS acquirer (same owner id), so a replacement created after we
+ * stopped heartbeating is never destroyed — mirroring the catalog's
+ * `rebuildLockHeldBySelf`.
+ *
+ * ADOPTION NOTE: lock only the brief final read-merge-write window, never a
+ * long scan — a scan-length lock makes concurrent writers time out and
+ * silently drop work (catalog round 5, codex/cursor P2).
+ */
+declare function withHeldFileLock<T>(lockPath: string, opts: HeldFileLockOptions, task: (acquired: boolean) => Promise<T>): Promise<T>;
+
+export { type HeldFileLockOptions, MutationSerializer, serializeMutations, withHeldFileLock };