@rljson/fs-agent 0.0.58 → 0.0.59

package/dist/fs-agent.d.ts

@@ -176,6 +176,20 @@ export declare const TREE_FETCH_CONCURRENCY = 64;
  * which is the cheap half of the trade.
  */
 export declare const RESTORED_BLOB_MEMORY_MAX = 50000;
+/**
+ * How many tree children a restore works on at once.
+ *
+ * A restore's cost is dominated by `getBlob`, and a blob this node does not
+ * already hold is a socket round trip. Walking the tree strictly sequentially
+ * makes the whole restore `files × RTT` — invisible on localhost, and about
+ * sixteen files a second on the lab, where a 1 200-file folder then takes
+ * minutes and reads as a stalled node.
+ *
+ * Sixteen rather than sixty-four: blobs carry file CONTENT, so the ceiling is
+ * memory in flight rather than request count, and a folder of large files at
+ * high concurrency is how a client runs out of heap.
+ */
+export declare const RESTORE_FETCH_CONCURRENCY = 16;
 /**
  * What an agent concluded about an inbound ref.
  *

package/dist/fs-agent.js

@@ -1079,6 +1079,7 @@ const AGENT_STATE_FILE = ".fsagent-state.json";
 const REFUSAL_ANSWER_COOLDOWN_MS = 5e3;
 const TREE_FETCH_CONCURRENCY = 64;
 const RESTORED_BLOB_MEMORY_MAX = 5e4;
+const RESTORE_FETCH_CONCURRENCY = 16;
 const VERDICT_REASON = {
   "own-echo": "is this agent's own last advertisement echoed back",
   stale: "is not the newest its sender has advertised"
@@ -1637,9 +1638,26 @@ ${err.stack}` : String(err);
       const dirPath = meta.relativePath === "." ? targetPath : join(targetPath, meta.relativePath);
       await mkdir(dirPath, { recursive: true });
       if (treeNode.children && Array.isArray(treeNode.children)) {
-        for (const childHash of treeNode.children) {
-          await this._restoreTree(childHash, trees, targetPath, isOwnRoot);
-        }
+        const children = [...treeNode.children];
+        let next = 0;
+        const worker = async () => {
+          for (; ; ) {
+            const index = next++;
+            if (index >= children.length) return;
+            await this._restoreTree(
+              children[index],
+              trees,
+              targetPath,
+              isOwnRoot
+            );
+          }
+        };
+        await Promise.all(
+          Array.from(
+            { length: Math.min(RESTORE_FETCH_CONCURRENCY, children.length) },
+            worker
+          )
+        );
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/fs-agent",
-  "version": "0.0.58",
+  "version": "0.0.59",
   "description": "Rljson fs-agent description",
   "homepage": "https://github.com/rljson/fs-agent",
   "bugs": "https://github.com/rljson/fs-agent/issues",