@remnic/core 9.25.7 → 9.26.0

package/dist/testing/lifecycle-matrix.js

@@ -0,0 +1,149 @@
+import "../chunk-PZ5AY32C.js";
+
+// src/testing/lifecycle-matrix.ts
+import { createRequire } from "module";
+var MATRIX_ROWS = Object.freeze([
+  {
+    id: "explicit-provider-identity",
+    title: "explicit provider identity",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: false,
+      restart: false,
+      flush: "none",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "sparse-metadata-with-binding",
+    title: "sparse metadata with remembered binding",
+    dimensions: {
+      providerIdentity: "sparse",
+      rememberedBinding: true,
+      restart: false,
+      flush: "none",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "sparse-metadata-without-binding",
+    title: "sparse metadata without remembered binding",
+    dimensions: {
+      providerIdentity: "sparse",
+      rememberedBinding: false,
+      restart: false,
+      flush: "none",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "provider-rebinding",
+    title: "provider rebinding",
+    dimensions: {
+      providerIdentity: "rebound",
+      rememberedBinding: true,
+      restart: false,
+      flush: "none",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "restart-reload-recovery",
+    title: "restart/reload recovery",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: true,
+      restart: true,
+      flush: "none",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "compaction-flush",
+    title: "compaction flush",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: false,
+      restart: false,
+      flush: "compaction",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "before-reset",
+    title: "before_reset",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: false,
+      restart: false,
+      flush: "before_reset",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "session-end",
+    title: "session_end",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: false,
+      restart: false,
+      flush: "session_end",
+      dedupeOrReplay: false
+    }
+  },
+  {
+    id: "dedupe-replay",
+    title: "dedupe/replay behavior",
+    dimensions: {
+      providerIdentity: "explicit",
+      rememberedBinding: false,
+      restart: false,
+      flush: "none",
+      dedupeOrReplay: true
+    }
+  }
+]);
+function lifecycleTestName(subjectName, row) {
+  return `lifecycle-matrix[${subjectName}] :: ${row.id} \u2014 ${row.title}`;
+}
+var requiredNodeTest = createRequire(import.meta.url)("node:test");
+var nodeTest = typeof requiredNodeTest === "function" ? requiredNodeTest : requiredNodeTest.test;
+var defaultRegister = (name, fn) => {
+  nodeTest(name, fn);
+};
+var defaultRegisterSkipped = (name, reason) => {
+  nodeTest(name, { skip: reason }, () => {
+  });
+};
+function runLifecycleMatrix(subjectName, subject, options = {}) {
+  const register = options.register ?? defaultRegister;
+  const registerSkipped = options.registerSkipped ?? defaultRegisterSkipped;
+  const rows = options.rows ?? MATRIX_ROWS;
+  for (const row of rows) {
+    const name = lifecycleTestName(subjectName, row);
+    const applicability = subject.appliesTo ? subject.appliesTo(row) : true;
+    if (applicability !== true) {
+      const reason = typeof applicability === "string" && applicability.length > 0 ? applicability : "not applicable to this subsystem";
+      registerSkipped(name, reason);
+      continue;
+    }
+    register(name, async () => {
+      let built;
+      let setupDone = false;
+      try {
+        built = await subject.setup(row);
+        setupDone = true;
+        await subject.exercise(built, row);
+        await subject.invariants(built, row);
+      } finally {
+        if (setupDone) await subject.teardown(built, row);
+      }
+    });
+  }
+}
+export {
+  MATRIX_ROWS,
+  lifecycleTestName,
+  runLifecycleMatrix
+};
+//# sourceMappingURL=lifecycle-matrix.js.map

package/dist/testing/lifecycle-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/lifecycle-matrix.ts"],"sourcesContent":["/**\n * Lifecycle scenario-matrix harness (issue #1993, umbrella #1988 phase 5).\n *\n * AGENTS.md mandates a scenario matrix for stateful subsystem changes\n * (session/retrieval/cache work): the nine canonical rows a reviewer will\n * otherwise probe by hand — provider identity, sparse metadata ± remembered\n * binding, provider rebinding, restart/reload recovery, compaction flush,\n * `before_reset`, `session_end`, and dedupe/replay. Historically that matrix\n * lived only as prose (see the \"Why Stateful PRs Churn\" section) and nobody\n * instantiated it, so PR #1923 burned 53 review threads on exactly those\n * adjacent invariants.\n *\n * This module makes the matrix EXECUTABLE. A subsystem adapter implements\n * `LifecycleSubject<S>`; `runLifecycleMatrix` registers one named test per\n * `MATRIX_ROWS` entry. Adding a row here is a one-file change that\n * automatically extends every adopter — the whole point of the harness.\n *\n * Test-support only: this file lives under `src/testing/` and is exported solely\n * so adapter test subjects can share the canonical matrix across packages.\n * The registrar loads `node:test` through `createRequire` so the built artifact\n * keeps the builtin specifier, and runtime code must never import this module.\n */\n\nimport { createRequire } from \"node:module\";\n\n/** The nine canonical AGENTS.md session/retrieval/cache matrix rows. */\nexport type MatrixRowId =\n  | \"explicit-provider-identity\"\n  | \"sparse-metadata-with-binding\"\n  | \"sparse-metadata-without-binding\"\n  | \"provider-rebinding\"\n  | \"restart-reload-recovery\"\n  | \"compaction-flush\"\n  | \"before-reset\"\n  | \"session-end\"\n  | \"dedupe-replay\";\n\n/**\n * Typed scenario axes a subject can branch on instead of re-parsing the row\n * id. These encode the real dimensions the AGENTS.md matrix probes.\n */\nexport interface MatrixRowDimensions {\n  /** How the session's provider/identity binding is established. */\n  readonly providerIdentity: \"explicit\" | \"sparse\" | \"rebound\" | \"none\";\n  /** Whether a previously remembered binding is available to reuse. */\n  readonly rememberedBinding: boolean;\n  /** Whether the scenario exercises a fresh instance over persisted state. */\n  readonly restart: boolean;\n  /** The forced-flush lifecycle transition under test, if any. */\n  readonly flush: \"before_reset\" | \"session_end\" | \"compaction\" | \"none\";\n  /** Whether the scenario replays/duplicates content through the dedupe path. */\n  readonly dedupeOrReplay: boolean;\n}\n\nexport interface MatrixRow {\n  readonly id: MatrixRowId;\n  /** Human-readable row title (matches the AGENTS.md bullet). */\n  readonly title: string;\n  readonly dimensions: MatrixRowDimensions;\n}\n\n/**\n * The canonical matrix. Order and membership mirror AGENTS.md\n * \"Minimum scenario matrix for session/retrieval/cache work\". Frozen so an\n * adopter cannot mutate the shared set.\n */\nexport const MATRIX_ROWS: readonly MatrixRow[] = Object.freeze([\n  {\n    id: \"explicit-provider-identity\",\n    title: \"explicit provider identity\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"none\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"sparse-metadata-with-binding\",\n    title: \"sparse metadata with remembered binding\",\n    dimensions: {\n      providerIdentity: \"sparse\",\n      rememberedBinding: true,\n      restart: false,\n      flush: \"none\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"sparse-metadata-without-binding\",\n    title: \"sparse metadata without remembered binding\",\n    dimensions: {\n      providerIdentity: \"sparse\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"none\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"provider-rebinding\",\n    title: \"provider rebinding\",\n    dimensions: {\n      providerIdentity: \"rebound\",\n      rememberedBinding: true,\n      restart: false,\n      flush: \"none\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"restart-reload-recovery\",\n    title: \"restart/reload recovery\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: true,\n      restart: true,\n      flush: \"none\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"compaction-flush\",\n    title: \"compaction flush\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"compaction\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"before-reset\",\n    title: \"before_reset\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"before_reset\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"session-end\",\n    title: \"session_end\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"session_end\",\n      dedupeOrReplay: false,\n    },\n  },\n  {\n    id: \"dedupe-replay\",\n    title: \"dedupe/replay behavior\",\n    dimensions: {\n      providerIdentity: \"explicit\",\n      rememberedBinding: false,\n      restart: false,\n      flush: \"none\",\n      dedupeOrReplay: true,\n    },\n  },\n] as const);\n\n/**\n * A subsystem adapter. Each row runs `setup → exercise → invariants`. `setup`\n * is transactional — it cleans up its own partial state if it throws — and once\n * it returns a fixture, `teardown` always runs (even when `exercise` or\n * `invariants` throws), so a leaked temp dir or orchestrator cannot poison a\n * sibling row.\n *\n * A row a subject cannot honestly realize must NOT be faked: return a skip\n * reason from `appliesTo` and the harness registers it as an explicit skipped\n * test (a mock-only pass is a finding about the code, not the harness — #1993).\n */\nexport interface LifecycleSubject<S> {\n  /** Build the row-specific fixture; MUST clean up its own partial state if it throws. */\n  setup(row: MatrixRow): Promise<S>;\n  /** Drive the behavior under test. */\n  exercise(subject: S, row: MatrixRow): Promise<void>;\n  /** Row-specific assertions against observable effects. */\n  invariants(subject: S, row: MatrixRow): Promise<void>;\n  /** Always-run cleanup. */\n  teardown(subject: S, row: MatrixRow): Promise<void>;\n  /**\n   * Optional: return a non-empty string to SKIP a row with that reason, or\n   * `false`. Omitted / `true` means the row applies. A skip is honest coverage\n   * documentation, not a silent pass.\n   */\n  appliesTo?(row: MatrixRow): boolean | string;\n}\n\n/** Minimal test registrar seam (defaults to `node:test`), injectable for self-test. */\nexport type MatrixTestRegistrar = (\n  name: string,\n  fn: () => void | Promise<void>,\n) => void;\n\nexport type MatrixSkipRegistrar = (name: string, reason: string) => void;\n\nexport interface RunLifecycleMatrixOptions {\n  /** Override the test registrar (self-test injects a capturing fake). */\n  readonly register?: MatrixTestRegistrar;\n  /** Override the skip registrar. */\n  readonly registerSkipped?: MatrixSkipRegistrar;\n  /** Override the row set (self-test only; production adopters use MATRIX_ROWS). */\n  readonly rows?: readonly MatrixRow[];\n}\n\n/** Deterministic, greppable test name — the coverage manifest and CI depend on it. */\nexport function lifecycleTestName(subjectName: string, row: MatrixRow): string {\n  return `lifecycle-matrix[${subjectName}] :: ${row.id} — ${row.title}`;\n}\ntype NodeTestRegistrar = {\n  (name: string, fn: () => void | Promise<void>): void;\n  (name: string, options: { skip: string }, fn: () => void): void;\n};\n\nconst requiredNodeTest = createRequire(import.meta.url)(\"node:test\") as\n  | NodeTestRegistrar\n  | { test: NodeTestRegistrar };\nconst nodeTest: NodeTestRegistrar =\n  typeof requiredNodeTest === \"function\" ? requiredNodeTest : requiredNodeTest.test;\n\nconst defaultRegister: MatrixTestRegistrar = (name, fn) => {\n  nodeTest(name, fn);\n};\n\nconst defaultRegisterSkipped: MatrixSkipRegistrar = (name, reason) => {\n  nodeTest(name, { skip: reason }, () => {});\n};\n\n/**\n * Register one test per matrix row for `subject`, named with the row identity\n * so a failing row is unambiguous in CI output. Runs `setup → exercise →\n * invariants`; `teardown` runs whenever `setup` produced a fixture.\n */\nexport function runLifecycleMatrix<S>(\n  subjectName: string,\n  subject: LifecycleSubject<S>,\n  options: RunLifecycleMatrixOptions = {},\n): void {\n  const register = options.register ?? defaultRegister;\n  const registerSkipped = options.registerSkipped ?? defaultRegisterSkipped;\n  const rows = options.rows ?? MATRIX_ROWS;\n\n  for (const row of rows) {\n    const name = lifecycleTestName(subjectName, row);\n    const applicability = subject.appliesTo ? subject.appliesTo(row) : true;\n    if (applicability !== true) {\n      const reason =\n        typeof applicability === \"string\" && applicability.length > 0\n          ? applicability\n          : \"not applicable to this subsystem\";\n      registerSkipped(name, reason);\n      continue;\n    }\n\n    register(name, async () => {\n      let built: S | undefined;\n      let setupDone = false;\n      try {\n        built = await subject.setup(row);\n        setupDone = true;\n        await subject.exercise(built, row);\n        await subject.invariants(built, row);\n      } finally {\n        // Teardown runs whenever setup COMPLETED — even when a subject's fixture\n        // type is `void`/undefined — and is skipped only when setup itself threw\n        // (a transactional setup cleans up its own partial state on throw). The\n        // sentinel is a completion flag, NOT the fixture value, so a stateless or\n        // void subject that did setup work is still torn down.\n        if (setupDone) await subject.teardown(built as S, row);\n      }\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/transfer/backup.js

@@ -1,14 +1,14 @@
 import {
   backupMemoryDir
-} from "../chunk-2NLLXCJG.js";
+} from "../chunk-BXLOS5AJ.js";
 import "../chunk-765K3SAT.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.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

@@ -1,15 +1,15 @@
 import {
   exportCapsule,
   isValidCapsuleSince
-} from "../chunk-KQAFEZQX.js";
+} from "../chunk-VDX2J7OX.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.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

@@ -1,17 +1,17 @@
 import {
   importCapsule
-} from "../chunk-7CPOZH6Y.js";
+} from "../chunk-AJ7QCSIS.js";
 import "../chunk-5VQJBH2G.js";
 import "../chunk-AITCS2RC.js";
 import "../chunk-XMMESCPD.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-PDJTHRAW.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
-import "../chunk-GCGJW34D.js";
+import "../chunk-DQEMWVMT.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/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;
     parent: {
         version: string;
@@ -334,16 +334,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
-    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;
         parent: {
             version: string;
@@ -485,16 +485,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
-        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;
         parent: {
             version: string;
@@ -539,28 +537,28 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     };
-}, {
     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;
             parent: {
                 version: string;
@@ -704,16 +704,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
-            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;
             parent: {
                 version: string;
@@ -758,28 +756,28 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
-    }, {
         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;
             parent: {
                 version: string;
@@ -836,6 +834,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
+        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;