@githolon/runtime 0.112.3 → 0.112.5

package/dist/RUNTIME-SOURCES.sha256

@@ -11,7 +11,6 @@
 06525d62b18918913a7fe7981204fba9e1f70369cc2aa785851caae39f546de3  node_modules/@bufbuild/protobuf/dist/esm/wire/base64-encoding.js
 09a24ed660112991f8105d8c0c2c250617b6ad99f6a12afe2d39b8a9305289ec  peer-office/src/runtime/session_directory.ts
 0a687d73d1754114045dd64ab0125af437945ed11b1302753b1c3c46793a014b  peer-office/src/runtime/replica_follow_lane.ts
-0aed53ba7b333581e2aab3f5e90444abdbaa8d3defdb11ae3d7ae475b869d36c  platform-shells/browser/kernel_custody.ts
 0b2994ee1fee5c72c7f27881aea421bdb1757b0c8c4042f155c433015b0b2455  node_modules/@bufbuild/protobuf/dist/esm/codegenv2/scalar.js
 0b5eee51991554d54865ea30f65f8803c8dfe73116cd815676f927021329259a  peer-office/src/runtime/credential_vault.ts
 0db0f42ba330749a7b05095ea1fd0ff63fd2b30e84cead30fe4c28359d15f194  node_modules/@bjorn3/browser_wasi_shim/dist/wasi_defs.js
@@ -27,11 +26,11 @@
 11ba369493cb754f09f8ef04f1235d64708a283cead2164bfd12679c940fcbe6  adapter/certification_seal.ts
 13418e92f08476ae029573738d8a74f8fb4d6cfd3d8f610d0512da9d44a3a20d  peer-office/src/runtime/http_obligation_delivery.ts
 151e39e98e6d58e6453f6b9aab5f93af32cfe4e8e2915b71952a337145976049  peer-office/src/runtime/authoring_preflight.ts
+15a24c9133b37575f0e8d6a0db6a9e383b8ebb944d1929aab6694084eff85291  adapter/kernel_machine_desk.ts
 161a203d3e9f10a6de3ffa798f736f6aa157f0ab85a40c3f3d6a412729a105e2  peer-office/src/runtime/platform_effect_driver.ts
 168eb977a826f75ab0c39f9322f78cc58dbd5b233019ad1d6a7e940af8a7c4aa  node_modules/@bjorn3/browser_wasi_shim/dist/wasi.js
 16d6522ee4ecf4a91c4d29357ebc874844c266f2ae89ef2a92ec2d391f3762e9  node_modules/is-unsafe/src/contexts/sql-strict.js
 17b0d228dd20748bd5fa03164478198c813214e4fa5d8f1650705128a954f0bd  adapter/wasi_custody_filesystem.ts
-1923aefdc23c6f66e5bc5b70c71b3fa66267738b3dcfa82a59ddecf7831152ef  adapter/memory_custody_filesystem.ts
 1963a804a9cfe7d44a76b2c476817639b939d7e93828da865cab40fe9ba536fa  adapter/custody-transport.ts
 1a5d9fd32360e2cec4adbee9e56221fb26def66bb9d122e0b5745cebc963d92e  node_modules/xml-naming/src/index.js
 1b27a1f4d58d6314cd4887d0f47493d1a98fc474e3364388f321c3aeb94a8ac3  adapter/workspace_effect_outcome.ts
@@ -52,6 +51,7 @@
 25c033d29ed62a510d8c43054ec238776bcba0949808cb6054df5cbea951ddf7  adapter/proto/nomos/runtime/v2/interaction_desk_pb.js
 25d57b7e880708c04738087de674a8c98092e5bfd39d5193cdb63a2f1e33871e  node_modules/@bufbuild/protobuf/dist/esm/wkt/gen/google/protobuf/compiler/plugin_pb.js
 27d164987aeae0cffae136eaa84ff39ca6efd9c07018dce4b63f0d352d3d855b  adapter/proto/nomos/runtime/v2/maintenance_desk_pb.js
+27d996c3e9e0e5b3c45612da4588dd10cf1c7a0d3285e652c705c07e238a2b48  platform-shells/browser/custody_store.ts
 286c659a8f940c313077afe8a00c0dc128d4a138edf6d9a4519f29538b58c94f  node_modules/fast-xml-parser/src/xmlparser/XMLParser.js
 2902315d1ae081647345f4e2aab7c8e60f8f8ae16de1a6c6e642ed6fd14e4959  peer-office/src/runtime/law_package_desk.ts
 29bf27cac2afa56801e728f9aeca4c6b7c281d7e602adb5a4c6d53bf0a79762b  peer-office/src/runtime/correspondence_recovery.ts
@@ -72,7 +72,6 @@
 3c092b8d4185badd23ecf4552434d05aa541b0cd0d534781d687db55260d5da8  adapter/proto/nomos/runtime/v2/sealing_desk_pb.js
 3c98fa838c05abcfd8dfda1128f2d1fca9b196a371fe9751abbd8f4c3b9d04ec  node_modules/@bufbuild/protobuf/dist/esm/wkt/timestamp.js
 3d05089a8c1008f20e06da9907eec7f8824f871edfc95e907c15dc8e2bdf43e7  node_modules/@bufbuild/protobuf/dist/esm/extensions.js
-3e4d4f410f38ade5689895263df29265e13bb49c0760b82c565618082baed0a6  adapter/kernel_machine_desk.ts
 3eef60b7d08402d6a0b9427fde0308878929398918f09747833fd9a06ea3fa7d  workspace-discovery/src/http.ts
 3fa38ca64538032d871cd44da41bf6a6ad2eb133b6b8ebc2d8b4d33615b00dcf  peer-office/src/reception/application_session_pipe.ts
 3fade4f9262d10e39f346b57a7f08d03641e0ebd75556d087f6319f6c6003a24  peer-office/src/runtime/sha256.ts
@@ -84,7 +83,6 @@
 42242740dd3c09c2530972c6bc477e6aa2be2f91f6cdf112585eb1f1929721a7  peer-office/src/runtime/subscription_manager.ts
 437d1f7906925689d0329ee2f729786117903a5f9191a5a47faec67081ab6f6a  peer-office/src/runtime/interaction_desk.ts
 44d54aa1500d8b179b56c47003530ade9220c0daec31caeeeb1a59760eca6d88  node_modules/fast-xml-builder/src/fxb.js
-45f49fcf3773351a4983772c470e14e40baa392d148c991f92674c9fba1246b4  platform-shells/browser/custody_store.ts
 463a7041ce45ddd801fc0e0981bb11658b76bb44caad19d2971d73d7700d739b  node_modules/@bufbuild/protobuf/dist/esm/wire/text-encoding.js
 46ce19f00a64198852937f4a982c59a5d237aeab590255873e131f2f0468e98e  peer-office/src/runtime/workspace_opening.ts
 475e62094c73367833cec6253c5834a887cae9bcfa43a691a9fe3b7495c19106  node_modules/@bufbuild/protobuf/dist/esm/unknown-enum.js
@@ -107,6 +105,7 @@
 589afd70975c49b5d8856a85ffb597b1412f04b35b6234c324564d8640fcae15  node_modules/@bufbuild/protobuf/dist/esm/wkt/gen/google/protobuf/type_pb.js
 59ceb09d3fd2402e81ed7e5992245f2b398c7ceeb80141138f4eab5da0244586  node_modules/is-unsafe/src/contexts/redos.js
 59dd7fdcd3eac52054ff1edd4667fbadb66c851a66f60ec528f9db6421a0eed9  node_modules/@bufbuild/protobuf/dist/esm/codegenv2/restore-json-names.js
+5ac35f182ca8cdf2e187276f9c961a20799d7a2d64f3de3f5217d12ed3420890  peer-office/package/package.json
 5c47d871d691707bfa347b2c9199b433e277332ba4c523a4eb802d8c5cded105  peer-office/src/runtime/office_seat.ts
 5ce7673a392e7c11100428b040d6c9a08242021e33f859b2ad670edef31d80de  node_modules/@bufbuild/protobuf/dist/esm/from-binary.js
 5cf55a0f51490590bf56e1ff2d6dd11002f8a8b43b0bc661d2cc15a6c6e0e981  adapter/git-fs.ts
@@ -163,10 +162,10 @@
 8ce60aff8226986c6ec652887c97a9515a2f10dd046596d76797cbdd0bb46e1d  peer-office/src/runtime/remote_runtime_paper.ts
 8e033b086d23caeba4a8b2e69284b6448787884bb0978eddf67729569d268367  peer-office/src/runtime/credential_recovery_desk.ts
 8e73c652d2c41232e1a3217524dcdbbe7f26834d59cfe80e4432ec59a801dc42  peer-office/src/runtime/authentication_readiness_desk.ts
+8ee050cca65954e7962806818145a4cf0e9a7532362b96da0363c1d918c66e5d  platform-shells/browser/kernel_custody.ts
 9109542ce7615df736d0b89b9562a0f8e989099aff65de707217d6a170591812  peer-office/src/runtime/read_maintenance_desk.ts
 92884553e5d2d46ea273441deb32dc07187dc8ded3524356fa68536d1f2fc435  node_modules/@bufbuild/protobuf/dist/esm/descriptors.js
 92aa7e4df3bf7dfc02235174f297dcbff6bd02f7eb6325876cbb24ada6d51414  node_modules/@bufbuild/protobuf/dist/esm/wire/text-format.js
-9330a6cd8db9a2a6aee8d6511ec0f4e1b1dee8a6d2eac3bec39712c27127f8b6  platform-shells/browser/peer.ts
 939bd8b89505a4e9be6b8d60fed0479086c441d7ae50930986cf9657123e0524  peer-office/src/runtime_v2_codec.ts
 9471d4fa81aa8caafdf7fca7cff9563b047a5b1803883f5dd9b7df5241350fff  peer-office/src/runtime/replica_follow_desk.ts
 94a3cef0f355a9a177661748d24faae32206a5cc382c8601a34dcf005340107b  node_modules/fast-xml-parser/src/xmlparser/OrderedObjParser.js
@@ -238,6 +237,7 @@ c41faf95c6c33b80349ff96f8127153672a6e6bf8bb9593f7aa67d2e2e642684  peer-office/sr
 c649d39c53ebe6817c71407de8105b6d8cbc2326867f90d59f49ab02d9271b44  node_modules/anynum/digitTable.js
 c6c85d892e445a8f84e9f628f2ac1ac6766103e90bb502ee9c101774831c4f0c  peer-office/src/runtime/command_preparation_desk.ts
 c87f55e284241bdf08e06a54b09567c329e8cc24519dbd08f064d0230a19f8fd  peer-office/src/runtime/correspondence_work_registry.ts
+c884aa80ac787299da2ec4ebd930c78372d82e227363980cc6a3baf08daf1889  platform-shells/browser/peer.ts
 caa925cb881f7586e9e01f09325f09ebdecf742debbfff21eb7c4c49ea09ef02  node_modules/@bufbuild/protobuf/dist/esm/wkt/gen/google/protobuf/java_features_pb.js
 cb095614d5f901cd00d46b930a23c64ebd909a77831aa666768fca47f3e7745f  node_modules/@bufbuild/protobuf/dist/esm/reflect/scalar.js
 cce0e8a8876bd1d3305a666e70cd556fd1ae57560fbca9f4ff0577d91178a0b1  node_modules/fast-xml-parser/src/xmlparser/node2json.js
@@ -268,7 +268,6 @@ e34016b82b6f6e4c4a1cc2dd44ccd14a348e8156a1f6c5aeeb2c7fc36a15b8f9  adapter/proto/
 e34016b82b6f6e4c4a1cc2dd44ccd14a348e8156a1f6c5aeeb2c7fc36a15b8f9  peer-office/package/src/protocol/nomos/kernel/v1/kernel_pb.js
 e394b7a580a2853949ec937d742b54fd8169029a5d10a3e4e521b984c60adb6d  peer-office/src/runtime/identity_desk.ts
 e411cf95c1c0c7063b863a08ad568d61044069f9338028eace56e362029ad3a7  peer-office/src/runtime/residency_desk.ts
-e4406907e251677b130006208fa24b1537e8e8c0d54505685a90ce88bd109d81  peer-office/package/package.json
 e45a879696cd2e7b692aa282677abf216297c1d129135e914b8a76fd0cbe15bd  peer-office/src/reception/generated_offer_counter.ts
 e8ef38f512bfa38f0a40c8edc32540040162576cccc229197a8fbd0c0097bb73  peer-office/src/runtime/history_acquisition_desk.ts
 eb9e106e81226ab9547882079e7fd6a9d885d2c71ba78784f7edaa7db61bb941  node_modules/is-unsafe/src/contexts/svg.js
@@ -277,6 +276,7 @@ ece435d3784d928d02bff4d015b7cb686f8c06de8536ff9f8ebc38a8f403a3be  node_modules/@
 eda289d9ef0e979fe77a578ffbbf8012cadcfec4629b66cd98c27d6229a9f020  node_modules/@bufbuild/protobuf/dist/esm/is-message.js
 efce20f9f127263ca66d855115e01b37af0afb8b8baafeba7dcc2e0834e99e4f  node_modules/@bufbuild/protobuf/dist/esm/wkt/gen/google/protobuf/struct_pb.js
 f23513db2fea432df6121956d9bab4761dabf8034b6eba8988452104dba1783e  adapter/proto/nomos/runtime/v2/records_desk_pb.js
+f3b65d81bf72f0cf4f8c6c36af75915e9146db35d590f1e51ffcececd4233147  adapter/memory_custody_filesystem.ts
 f3b9324922e08cffcc4c7ae3c6e08454f62e187a37404df31a00160cddf34d77  node_modules/@bufbuild/protobuf/dist/esm/reflect/guard.js
 f4eb625c1c0ebee8e5863b6958706af4635ca58d1d2544ae2b465e75060ba12c  peer-office/src/runtime/placement_desk.ts
 f50218256bfd061c59b454fbaf8ca304f1799b1d0d09b0f7851ba2420e1129ca  adapter/kernel_failure.ts

package/dist/nomos-runner.js

@@ -7847,10 +7847,10 @@
   // ../../platform-shells/browser/kernel_custody.ts
   init_define_NOMOS_KERNEL_RELEASE();
   init_shims();
-  function browserKernelCustody(kernel, checkpoint, isCheckpointCurrent) {
+  function browserKernelCustody(kernel, checkpoint, isCheckpointCurrent, provisionedGenesisWorkspace) {
     return {
       canRetainChanges: () => true,
-      hasLocalCustody: (workspace) => kernel.branchHead(workspace, "main") !== void 0,
+      hasLocalCustody: (workspace) => kernel.branchHead(workspace, "main") !== void 0 || workspace === provisionedGenesisWorkspace,
       openLocalCustody: async () => ({}),
       ledgerFor: () => {
         throw new Error("Browser Git custody is opened in place; there is no second local ledger");
@@ -9722,9 +9722,25 @@
     };
     return {
       preopen,
-      snapshot() {
+      delta(previous, mutated, includePath = () => true, copyChanged = true) {
+        const nodes = /* @__PURE__ */ new Map();
+        const changed = [];
+        const visit = (path, node) => {
+          if (!includePath(path)) return;
+          if (path !== "/work") {
+            nodes.set(path, node);
+            if (copyChanged && (previous.get(path) !== node || mutated.has(node)))
+              changed.push({ path, ...node.data ? { bytes: node.data.slice() } : {} });
+          }
+          for (const [name, child] of node.contents ?? []) visit(`${path}/${name}`, child);
+        };
+        visit("/work", preopen.dir);
+        return { nodes, changed, removed: [...previous.keys()].filter((path) => !nodes.has(path)) };
+      },
+      snapshot(includePath = () => true) {
         const entries = [];
         const visit = (path, node) => {
+          if (!includePath(path)) return;
           if (path !== "/work") entries.push({ path, ...node.data ? { bytes: node.data.slice() } : {} });
           for (const [name, child] of node.contents ?? []) visit(`${path}/${name}`, child);
         };
@@ -9949,7 +9965,11 @@
           if (!original) continue;
           imports[name] = (...args) => {
             const result = original(...args);
-            if (result === 0 && !(name === "fd_write" && Number(args[0]) < 3) && !(name === "path_open" && (Number(args[4]) & 9) === 0)) onFilesystemMutation();
+            if (result === 0 && !(name === "fd_write" && Number(args[0]) < 3) && !(name === "path_open" && (Number(args[4]) & 9) === 0)) {
+              const fd = name === "path_open" ? new DataView(wasi.inst.exports.memory.buffer).getUint32(Number(args[8]) >>> 0, true) : Number(args[0]);
+              const opened = wasi.fds[fd];
+              onFilesystemMutation(opened instanceof OpenFile ? opened.file : void 0);
+            }
             return result;
           };
         }
@@ -11377,8 +11397,10 @@
   init_define_NOMOS_KERNEL_RELEASE();
   init_shims();
   var copyRecord = (record) => ({ ...record, value: record.value.slice() });
+  var currentCacheFile = (path) => path.endsWith("/nomos.git/nomos-cache/raw-frontier-v2/current.sqlite");
+  var durableFile = (path) => !path.includes("/nomos.git/nomos-cache/raw-frontier-v2/addressed/") && !path.endsWith("/nomos.git/nomos-cache/raw-frontier-v2/addressed") && !currentCacheFile(path);
   var keyOf = (namespace, key) => JSON.stringify([namespace, key]);
-  var _backend, _records, _revision, _committed, _queued, _failure, _closed;
+  var _backend, _records, _knownNodes, _mutatedNodes, _changedRecords, _cachePaths, _cacheDirty, _cacheDisabled, _cacheTimer, _cachePending, _revision, _committed, _queued, _failure, _closed;
   var _BrowserCustodyStore = class _BrowserCustodyStore {
     constructor(backend, snapshot) {
       __publicField(this, "filesystem", memoryCustodyFilesystem());
@@ -11386,26 +11408,46 @@
       __publicField(this, "identity");
       __privateAdd(this, _backend);
       __privateAdd(this, _records, /* @__PURE__ */ new Map());
+      __privateAdd(this, _knownNodes, /* @__PURE__ */ new Map());
+      __privateAdd(this, _mutatedNodes, /* @__PURE__ */ new Set());
+      __privateAdd(this, _changedRecords, /* @__PURE__ */ new Map());
+      __privateAdd(this, _cachePaths, /* @__PURE__ */ new Set());
+      __privateAdd(this, _cacheDirty, false);
+      __privateAdd(this, _cacheDisabled, false);
+      __privateAdd(this, _cacheTimer);
+      __privateAdd(this, _cachePending);
       __privateAdd(this, _revision, 0);
       __privateAdd(this, _committed, -1);
       __privateAdd(this, _queued);
       __privateAdd(this, _failure);
       __privateAdd(this, _closed, false);
-      __publicField(this, "changed", () => {
+      __publicField(this, "changed", (inode) => {
         this.assertUsable();
+        if (inode) __privateGet(this, _mutatedNodes).add(inode);
         __privateWrapper(this, _revision)._++;
+        if (__privateGet(this, _backend).commitCache && !__privateGet(this, _cacheDisabled)) {
+          __privateSet(this, _cacheDirty, true);
+          if (!__privateGet(this, _cacheTimer)) __privateSet(this, _cacheTimer, setTimeout(() => {
+            __privateSet(this, _cacheTimer, void 0);
+            void this.flushCache().catch(() => {
+            });
+          }, 3e4));
+          __privateGet(this, _cacheTimer).unref?.();
+        }
         void this.checkpoint().catch(() => {
         });
       });
       __privateSet(this, _backend, backend);
-      if (snapshot && snapshot.format !== 1) throw new Error("Unsupported browser custody format; keep this site's data and update the application.");
+      if (snapshot && snapshot.format !== 2) throw new Error("Unsupported browser custody format; keep this site's data and update the application.");
       this.replica = snapshot?.replica ?? globalThis.crypto.getRandomValues(new BigUint64Array(1))[0] & (1n << 63n) - 1n;
       this.identity = snapshot?.identity ?? `browser-${globalThis.crypto.randomUUID()}`;
       for (const entry of snapshot?.files ?? []) {
         if (entry.bytes === void 0) this.filesystem.files.mkdir(entry.path);
         else this.filesystem.files.writeFile(entry.path, entry.bytes);
+        if (currentCacheFile(entry.path)) __privateGet(this, _cachePaths).add(entry.path);
       }
       for (const record of snapshot?.records ?? []) __privateGet(this, _records).set(keyOf(record.namespace, record.key), copyRecord(record));
+      __privateSet(this, _knownNodes, new Map(this.filesystem.delta(/* @__PURE__ */ new Map(), /* @__PURE__ */ new Set(), durableFile, false).nodes));
       for (const name of ["mkdir", "writeFile", "unlink"]) {
         const original = this.filesystem.files[name].bind(this.filesystem.files);
         this.filesystem.files[name] = (...args) => {
@@ -11416,20 +11458,15 @@
         };
       }
       const promises = this.filesystem.fs.promises;
-      const mkdir = promises.mkdir.bind(promises);
-      const writeFile = promises.writeFile.bind(promises);
-      promises.mkdir = async (path) => {
-        this.assertUsable();
-        const result = await mkdir(path);
-        this.changed();
-        return result;
-      };
-      promises.writeFile = async (path, bytes) => {
-        this.assertUsable();
-        const result = await writeFile(path, bytes);
-        this.changed();
-        return result;
-      };
+      for (const name of ["mkdir", "writeFile", "unlink", "rmdir"]) {
+        const original = promises[name].bind(promises);
+        promises[name] = async (...args) => {
+          this.assertUsable();
+          const result = await original(...args);
+          this.changed();
+          return result;
+        };
+      }
     }
     static async open(backend) {
       try {
@@ -11455,6 +11492,7 @@
       const next = value === void 0 ? void 0 : { namespace, key, revision: (current?.revision ?? 0n) + 1n, value: value.slice() };
       if (next) __privateGet(this, _records).set(id, next);
       else __privateGet(this, _records).delete(id);
+      __privateGet(this, _changedRecords).set(id, next && copyRecord(next));
       this.changed();
       return next && copyRecord(next);
     }
@@ -11464,14 +11502,19 @@
         __privateSet(this, _queued, Promise.resolve().then(async () => {
           while (__privateGet(this, _committed) !== __privateGet(this, _revision)) {
             const revision = __privateGet(this, _revision);
-            const snapshot = {
-              format: 1,
-              replica: this.replica,
-              identity: this.identity,
-              files: this.filesystem.snapshot(),
-              records: [...__privateGet(this, _records).values()].map(copyRecord)
-            };
-            await __privateGet(this, _backend).commit(snapshot);
+            const delta = this.filesystem.delta(__privateGet(this, _knownNodes), __privateGet(this, _mutatedNodes), durableFile);
+            __privateGet(this, _mutatedNodes).clear();
+            const records = [...__privateGet(this, _changedRecords).values()].filter((record) => record !== void 0).map(copyRecord);
+            const removedRecords = [...__privateGet(this, _changedRecords).entries()].filter(([, record]) => record === void 0).map(([id]) => id);
+            __privateGet(this, _changedRecords).clear();
+            await __privateGet(this, _backend).commit({
+              control: { format: 2, replica: this.replica, identity: this.identity },
+              files: delta.changed,
+              removedFiles: delta.removed,
+              records,
+              removedRecords
+            });
+            __privateSet(this, _knownNodes, new Map(delta.nodes));
             __privateSet(this, _committed, revision);
           }
         }).catch((error) => {
@@ -11488,14 +11531,41 @@
     isCheckpointCurrent() {
       return !__privateGet(this, _failure) && !__privateGet(this, _closed) && __privateGet(this, _committed) === __privateGet(this, _revision);
     }
+    async flushCache() {
+      if (__privateGet(this, _cachePending)) await __privateGet(this, _cachePending);
+      if (!__privateGet(this, _backend).commitCache || !__privateGet(this, _cacheDirty) || __privateGet(this, _cacheDisabled)) return;
+      __privateSet(this, _cacheDirty, false);
+      const paths = new Set(this.filesystem.files.listFiles("/work").filter(currentCacheFile));
+      const files = [...paths].map((path) => ({ path, bytes: this.filesystem.files.readFile(path) }));
+      const removed = [...__privateGet(this, _cachePaths)].filter((path) => !paths.has(path));
+      __privateSet(this, _cachePending, __privateGet(this, _backend).commitCache(files, removed).then(() => {
+        __privateSet(this, _cachePaths, paths);
+      }).catch(() => {
+        __privateSet(this, _cacheDisabled, true);
+      }).finally(() => {
+        __privateSet(this, _cachePending, void 0);
+      }));
+      await __privateGet(this, _cachePending);
+    }
     async close() {
       await this.checkpoint();
+      if (__privateGet(this, _cacheTimer)) clearTimeout(__privateGet(this, _cacheTimer));
+      __privateSet(this, _cacheTimer, void 0);
+      await this.flushCache();
       __privateSet(this, _closed, true);
       __privateGet(this, _backend).close();
     }
   };
   _backend = new WeakMap();
   _records = new WeakMap();
+  _knownNodes = new WeakMap();
+  _mutatedNodes = new WeakMap();
+  _changedRecords = new WeakMap();
+  _cachePaths = new WeakMap();
+  _cacheDirty = new WeakMap();
+  _cacheDisabled = new WeakMap();
+  _cacheTimer = new WeakMap();
+  _cachePending = new WeakMap();
   _revision = new WeakMap();
   _committed = new WeakMap();
   _queued = new WeakMap();
@@ -11527,8 +11597,28 @@
     let db;
     try {
       db = await new Promise((resolve, reject) => {
-        const request = indexedDB.open(name, 1);
-        request.onupgradeneeded = () => request.result.createObjectStore("custody");
+        const request = indexedDB.open(name, 3);
+        request.onupgradeneeded = (event) => {
+          const database = request.result;
+          if (!database.objectStoreNames.contains("custody")) database.createObjectStore("custody");
+          if (!database.objectStoreNames.contains("files")) database.createObjectStore("files");
+          if (!database.objectStoreNames.contains("records")) database.createObjectStore("records");
+          if (!database.objectStoreNames.contains("cache")) database.createObjectStore("cache");
+          if (event.oldVersion === 2) {
+            const files = request.transaction.objectStore("files");
+            const cache = request.transaction.objectStore("cache");
+            const cursor = files.openCursor();
+            cursor.onsuccess = () => {
+              const entry = cursor.result;
+              if (!entry) return;
+              if (Array.isArray(entry.key) && currentCacheFile(String(entry.key[0]))) {
+                cache.put(entry.value, entry.key);
+                entry.delete();
+              }
+              entry.continue();
+            };
+          }
+        };
         request.onsuccess = () => resolve(request.result);
         request.onerror = () => reject(request.error);
         request.onblocked = () => reject(new Error("Browser custody upgrade is blocked by another tab. Close it and retry."));
@@ -11537,19 +11627,148 @@
       release();
       throw error;
     }
+    const chunkBytes = 4 * 1024 * 1024;
+    const replace = (store, id, entry) => {
+      const old = store.get([id, -1]);
+      old.onsuccess = () => {
+        const count = Number(old.result?.chunks ?? 0);
+        for (let index = 0; index < count; index++) store.delete([id, index]);
+        store.delete([id, -1]);
+        if (!entry) return;
+        const bytes = "path" in entry ? entry.bytes : entry.value;
+        const chunks = bytes === void 0 ? 0 : Math.max(1, Math.ceil(bytes.byteLength / chunkBytes));
+        const meta = "path" in entry ? { path: entry.path, directory: bytes === void 0, chunks } : { namespace: entry.namespace, key: entry.key, revision: entry.revision, chunks };
+        store.put(meta, [id, -1]);
+        for (let index = 0; index < chunks; index++)
+          store.put(bytes.slice(index * chunkBytes, (index + 1) * chunkBytes), [id, index]);
+      };
+    };
+    const completeChunks = (chunks, count) => Number.isSafeInteger(count) && count >= 0 && chunks.length === count && Array.from({ length: count }, (_, index) => chunks[index]).every((chunk) => chunk instanceof Uint8Array);
+    const readState = () => new Promise((resolve, reject) => {
+      const tx = db.transaction(["custody", "files", "records", "cache"], "readonly");
+      const control = tx.objectStore("custody").get("current");
+      const files = tx.objectStore("files").getAll();
+      const fileKeys = tx.objectStore("files").getAllKeys();
+      const records = tx.objectStore("records").getAll();
+      const recordKeys = tx.objectStore("records").getAllKeys();
+      const caches = tx.objectStore("cache").getAll();
+      const cacheKeys = tx.objectStore("cache").getAllKeys();
+      tx.oncomplete = () => {
+        try {
+          if (!control.result) {
+            resolve(void 0);
+            return;
+          }
+          if (control.result.format !== 2) {
+            reject(new Error("Unsupported browser custody format"));
+            return;
+          }
+          const fileValues = /* @__PURE__ */ new Map();
+          for (let index = 0; index < fileKeys.result.length; index++) {
+            const [path, chunk] = fileKeys.result[index];
+            const value = fileValues.get(path) ?? { chunks: [] };
+            if (chunk === -1) value.meta = files.result[index];
+            else value.chunks[chunk] = files.result[index];
+            fileValues.set(path, value);
+          }
+          for (let index = 0; index < cacheKeys.result.length; index++) {
+            const [path, chunk] = cacheKeys.result[index];
+            const value = fileValues.get(path) ?? { chunks: [] };
+            if (chunk === -1) value.meta = caches.result[index];
+            else value.chunks[chunk] = caches.result[index];
+            fileValues.set(path, value);
+          }
+          const image = [...fileValues].map(([path, value]) => {
+            if (!value.meta) throw new Error(`Missing browser custody file metadata: ${path}`);
+            if (value.meta.directory) return { path };
+            if (!completeChunks(value.chunks, value.meta.chunks))
+              throw new Error(`Incomplete browser custody file: ${path}`);
+            const length = value.chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+            const bytes = new Uint8Array(length);
+            let offset = 0;
+            for (const chunk of value.chunks) {
+              bytes.set(chunk, offset);
+              offset += chunk.byteLength;
+            }
+            return { path, bytes };
+          }).sort((a, b) => a.path.split("/").length - b.path.split("/").length || a.path.localeCompare(b.path));
+          const recordValues = /* @__PURE__ */ new Map();
+          for (let index = 0; index < recordKeys.result.length; index++) {
+            const [id, chunk] = recordKeys.result[index];
+            const value = recordValues.get(id) ?? { chunks: [] };
+            if (chunk === -1) value.meta = records.result[index];
+            else value.chunks[chunk] = records.result[index];
+            recordValues.set(id, value);
+          }
+          const restoredRecords = [...recordValues].map(([id, value]) => {
+            if (!value.meta || !completeChunks(value.chunks, value.meta.chunks))
+              throw new Error(`Incomplete browser custody record: ${id}`);
+            const length = value.chunks.reduce((sum, chunk) => sum + chunk.byteLength, 0);
+            const bytes = new Uint8Array(length);
+            let offset = 0;
+            for (const chunk of value.chunks) {
+              bytes.set(chunk, offset);
+              offset += chunk.byteLength;
+            }
+            return { namespace: value.meta.namespace, key: value.meta.key, revision: value.meta.revision, value: bytes };
+          });
+          resolve({ ...control.result, files: image, records: restoredRecords });
+        } catch (error) {
+          reject(error);
+        }
+      };
+      tx.onabort = () => reject(tx.error ?? new Error("Browser custody read aborted"));
+    });
+    const migrate = async () => new Promise((resolve, reject) => {
+      const tx = db.transaction(["custody", "files", "records", "cache"], "readwrite", { durability: "strict" });
+      const control = tx.objectStore("custody");
+      const read = control.get("current");
+      read.onsuccess = () => {
+        const snapshot = read.result;
+        if (!snapshot || snapshot.format === 2) return;
+        if (snapshot.format !== 1) {
+          tx.abort();
+          return;
+        }
+        for (const file of snapshot.files) {
+          if (durableFile(file.path)) replace(tx.objectStore("files"), file.path, file);
+          else if (currentCacheFile(file.path)) replace(tx.objectStore("cache"), file.path, file);
+        }
+        for (const record of snapshot.records) replace(tx.objectStore("records"), keyOf(record.namespace, record.key), record);
+        control.put({ format: 2, replica: snapshot.replica, identity: snapshot.identity }, "current");
+      };
+      tx.oncomplete = () => resolve();
+      tx.onabort = () => reject(tx.error ?? new Error("Browser custody migration aborted"));
+    });
+    try {
+      await migrate();
+    } catch (error) {
+      db.close();
+      release();
+      throw error;
+    }
     return BrowserCustodyStore.open({
-      load: () => new Promise((resolve, reject) => {
-        const tx = db.transaction("custody", "readonly");
-        const read = tx.objectStore("custody").get("current");
-        tx.oncomplete = () => resolve(read.result);
-        tx.onabort = () => reject(tx.error ?? new Error("Browser custody read aborted"));
-      }),
-      commit: (snapshot) => new Promise((resolve, reject) => {
-        const tx = db.transaction("custody", "readwrite", { durability: "strict" });
-        tx.objectStore("custody").put(snapshot, "current");
+      load: readState,
+      commit: (change) => new Promise((resolve, reject) => {
+        const tx = db.transaction(["custody", "files", "records"], "readwrite", { durability: "strict" });
+        const files = tx.objectStore("files");
+        const records = tx.objectStore("records");
+        for (const path of change.removedFiles) replace(files, path);
+        for (const file of change.files) replace(files, file.path, file);
+        for (const id of change.removedRecords) replace(records, id);
+        for (const record of change.records) replace(records, keyOf(record.namespace, record.key), record);
+        tx.objectStore("custody").put(change.control, "current");
         tx.oncomplete = () => resolve();
         tx.onabort = () => reject(tx.error ?? new Error("Browser custody transaction aborted"));
       }),
+      commitCache: (cacheFiles, removedFiles) => new Promise((resolve, reject) => {
+        const tx = db.transaction("cache", "readwrite", { durability: "relaxed" });
+        const cache = tx.objectStore("cache");
+        for (const path of removedFiles) replace(cache, path);
+        for (const file of cacheFiles) replace(cache, file.path, file);
+        tx.oncomplete = () => resolve();
+        tx.onabort = () => reject(tx.error ?? new Error("Browser cache checkpoint aborted"));
+      }),
       close: () => {
         db.close();
         release();
@@ -35031,9 +35250,10 @@
         replica: options.replica ?? storage.replica,
         trustRootPublicKey: options.trustRootPublicKey
       }, storage.filesystem, storage.changed);
-      const kernel = kernelExecutionDesk(machine);
+      const physicalKernel = kernelExecutionDesk(machine);
+      const kernel = options.observeKernel?.(physicalKernel) ?? physicalKernel;
       const custodyDesk = gitCustodyDesk(kernel, fetchImpl);
-      const kernelStore = browserKernelCustody(kernel, () => storage.checkpoint(), () => storage.isCheckpointCurrent());
+      const kernelStore = browserKernelCustody(kernel, () => storage.checkpoint(), () => storage.isCheckpointCurrent(), options.provisionedGenesisWorkspace);
       const physical = withWorkspaceDiscovery(kernelStore, {
         providers: options.discoveryProviders ?? [options.base],
         fetch: (input, init) => fetchImpl(input, init)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githolon/runtime",
-  "version": "0.112.3",
+  "version": "0.112.5",
   "type": "module",
   "description": "The portable Nomos application runtime, reception contracts, and Node/browser runners.",
   "license": "SEE LICENSE IN LICENSE.md",