@milaboratories/pl-middle-layer 1.67.5 → 1.68.0

package/dist/mutator/template/template_cache.d.ts

@@ -1,20 +1,20 @@
 import { TemplateSpecPrepared } from "../../model/template_spec.js";
 import { BlockPackSpecPrepared } from "../../model/block_pack_spec.js";
+import "../../model/index.js";
 import { AnyResourceRef, PlClient, PlTransaction, ResourceRef, SignedResourceId } from "@milaboratories/pl-client";
 import { CompiledTemplateV3, TemplateData } from "@milaboratories/pl-model-backend";
-
 //#region src/mutator/template/template_cache.d.ts
-declare const TemplateCacheType: import("@milaboratories/pl-client").ResourceType;
-declare const TemplateCacheFieldName = "__templateCache";
+export declare const TemplateCacheType: import("@milaboratories/pl-client").ResourceType;
+export declare const TemplateCacheFieldName = "__templateCache";
 /** @internal exported for testing */
-declare const GC_ACCESS_THRESHOLD = 30;
+export declare const GC_ACCESS_THRESHOLD = 30;
 /** @internal exported for testing */
-declare const GC_MAX_ENTRIES = 3000;
+export declare const GC_MAX_ENTRIES = 3000;
 /** @internal exported for testing */
-declare const ACCESS_COUNT_KEY = "_accessCount";
+export declare const ACCESS_COUNT_KEY = "_accessCount";
 /** @internal exported for testing */
-declare const ACCESS_KEY_PREFIX = "access_";
-type TemplateCacheStat = {
+export declare const ACCESS_KEY_PREFIX = "access_";
+export type TemplateCacheStat = {
   totalMs: number;
   flattenMs: number;
   cacheInitMs: number;
@@ -38,13 +38,13 @@ interface CacheableNode {
   childHashes: string[];
 }
 /** Flatten template tree into a topologically ordered list of cacheable nodes (leaves first). */
-declare function flattenTemplateTree(data: TemplateData | CompiledTemplateV3): CacheableNode[];
+export declare function flattenTemplateTree(data: TemplateData | CompiledTemplateV3): CacheableNode[];
 /** Clear the in-memory cacheRid entry (call on errors referencing the cache resource). */
-declare function invalidateTemplateCacheId(pl: PlClient): void;
+export declare function invalidateTemplateCacheId(pl: PlClient): void;
 /** Find or create the TemplateCache/1 resource on user root. */
-declare function getOrCreateTemplateCache(pl: PlClient): Promise<SignedResourceId>;
+export declare function getOrCreateTemplateCache(pl: PlClient): Promise<SignedResourceId>;
 /** Remove the template cache from user root. */
-declare function dropTemplateCache(pl: PlClient): Promise<void>;
+export declare function dropTemplateCache(pl: PlClient): Promise<void>;
 /**
  * Run count-based garbage collection on the template cache.
  * Evicts least-recently-used entries when the cache exceeds maxEntries.
@@ -53,14 +53,14 @@ declare function dropTemplateCache(pl: PlClient): Promise<void>;
  * @internal exported for testing (maxEntries parameter allows low thresholds in tests)
  * @returns true if entries were evicted
  */
-declare function runGc(pl: PlClient, cacheRid: SignedResourceId, maxEntries?: number): Promise<boolean>;
+export declare function runGc(pl: PlClient, cacheRid: SignedResourceId, maxEntries?: number): Promise<boolean>;
 /**
  * Materialize a template tree via the cache.
  * Manages its own transactions internally — do NOT call inside an existing tx.
  *
  * @returns concrete SignedResourceId of the root template
  */
-declare function loadTemplateCached(pl: PlClient, spec: TemplateSpecPrepared, options?: {
+export declare function loadTemplateCached(pl: PlClient, spec: TemplateSpecPrepared, options?: {
   cacheResourceId?: SignedResourceId;
 }): Promise<SignedResourceId>;
 /**
@@ -68,9 +68,8 @@ declare function loadTemplateCached(pl: PlClient, spec: TemplateSpecPrepared, op
  * Returns a copy of the spec with the template replaced by a cached reference.
  * If the template is already cached, returns the spec unchanged.
  */
-declare function cacheBlockPackTemplate(pl: PlClient, spec: BlockPackSpecPrepared, options?: {
+export declare function cacheBlockPackTemplate(pl: PlClient, spec: BlockPackSpecPrepared, options?: {
   cacheResourceId?: SignedResourceId;
 }): Promise<BlockPackSpecPrepared>;
 //#endregion
-export { ACCESS_COUNT_KEY, ACCESS_KEY_PREFIX, GC_ACCESS_THRESHOLD, GC_MAX_ENTRIES, TemplateCacheFieldName, TemplateCacheStat, TemplateCacheType, cacheBlockPackTemplate, dropTemplateCache, flattenTemplateTree, getOrCreateTemplateCache, invalidateTemplateCacheId, loadTemplateCached, runGc };
 //# sourceMappingURL=template_cache.d.ts.map

package/dist/mutator/template/template_cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template_cache.d.ts","names":[],"sources":["../../../src/mutator/template/template_cache.ts"],"mappings":";;;;;;cAqCa,iBAAA,sCAAiB,YAAqC;AAAA,cAEtD,sBAAA;;cAGA,mBAAA;;cAEA,cAAA;;cAEA,gBAAA;AAPb;AAAA,cASa,iBAAA;AAAA,KAED,iBAAA;EACV,OAAA;EACA,SAAA;EACA,WAAA;EACA,aAAA;EACA,UAAA;EACA,SAAA;EACA,WAAA;EACA,UAAA;EACA,SAAA;EACA,WAAA;EACA,OAAA;EACA,cAAA;AAAA;AAAA,UAoBQ,aAAA;;EAER,IAAA;EAtC2B;AAE7B;EAuCE,MAAA,GAAS,EAAA,EAAI,aAAA,EAAe,SAAA,EAAW,WAAA,SAAoB,cAAA,MAAoB,WAAA;;EAE/E,WAAA;AAAA;AAvCF;AAAA,iBAkYgB,mBAAA,CAAoB,IAAA,EAAM,YAAA,GAAe,kBAAA,GAAqB,aAAA;;iBAY9D,yBAAA,CAA0B,EAAY,EAAR,QAAQ;;iBAKhC,wBAAA,CAAyB,EAAA,EAAI,QAAA,GAAW,OAAA,CAAQ,gBAAA;;iBA+BhD,iBAAA,CAAkB,EAAA,EAAI,QAAA,GAAW,OAAO;;;;;;;;;iBAoBxC,KAAA,CACpB,EAAA,EAAI,QAAA,EACJ,QAAA,EAAU,gBAAA,EACV,UAAA,YACC,OAAA;AA9ba;AACd;;;;;AADc,iBA4nBM,kBAAA,CACpB,EAAA,EAAI,QAAA,EACJ,IAAA,EAAM,oBAAA,EACN,OAAA;EAAY,eAAA,GAAkB,gBAAA;AAAA,IAC7B,OAAA,CAAQ,gBAAA;;;;;;iBAiFW,sBAAA,CACpB,EAAA,EAAI,QAAA,EACJ,IAAA,EAAM,qBAAA,EACN,OAAA;EAAY,eAAA,GAAkB,gBAAA;AAAA,IAC7B,OAAA,CAAQ,qBAAA"}
+{"version":3,"file":"template_cache.d.ts","names":[],"sources":["../../../src/mutator/template/template_cache.ts"],"mappings":";;;;;;qBAqCa,uDAAiB;qBAEjB;;qBAGA;;qBAEA;;qBAEA;;qBAEA;YAED;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAoBQ;;EAER;;;EAGA,SAAS,IAAI,eAAe,WAAW,oBAAoB,oBAAoB;;EAE/E;;;wBA2Vc,oBAAoB,MAAM,eAAe,qBAAqB;;wBAY9D,0BAA0B,IAAI;;wBAKxB,yBAAyB,IAAI,WAAW,QAAQ;;wBA+BhD,kBAAkB,IAAI,WAAW;;;;;;;;;wBAoBjC,MACpB,IAAI,UACJ,UAAU,kBACV,sBACC;;;;;;;wBA8LmB,mBACpB,IAAI,UACJ,MAAM,sBACN;EAAY,kBAAkB;IAC7B,QAAQ;;;;;;wBAiFW,uBACpB,IAAI,UACJ,MAAM,uBACN;EAAY,kBAAkB;IAC7B,QAAQ"}

package/dist/mutator/template/template_loading.d.ts

@@ -1,17 +1,15 @@
 import { TemplateSpecAny, TemplateSpecPrepared } from "../../model/template_spec.js";
 import { AnyRef, PlTransaction, ResourceType } from "@milaboratories/pl-client";
-
 //#region src/mutator/template/template_loading.d.ts
-declare const TengoTemplateGet: ResourceType;
-declare const TengoTemplateGetRegistry = "registry";
-declare const TengoTemplateGetTemplateURI = "templateURI";
-declare const TengoTemplateGetTemplate = "template";
-declare const TengoTemplatePack: ResourceType;
-declare const TengoTemplatePackConvert: ResourceType;
-declare const TengoTemplatePackConvertTemplatePack = "templatePack";
-declare const TengoTemplatePackConvertTemplate = "template";
-declare function prepareTemplateSpec(tpl: TemplateSpecAny): Promise<TemplateSpecPrepared>;
-declare function loadTemplate(tx: PlTransaction, spec: TemplateSpecPrepared): AnyRef;
+export declare const TengoTemplateGet: ResourceType;
+export declare const TengoTemplateGetRegistry = "registry";
+export declare const TengoTemplateGetTemplateURI = "templateURI";
+export declare const TengoTemplateGetTemplate = "template";
+export declare const TengoTemplatePack: ResourceType;
+export declare const TengoTemplatePackConvert: ResourceType;
+export declare const TengoTemplatePackConvertTemplatePack = "templatePack";
+export declare const TengoTemplatePackConvertTemplate = "template";
+export declare function prepareTemplateSpec(tpl: TemplateSpecAny): Promise<TemplateSpecPrepared>;
+export declare function loadTemplate(tx: PlTransaction, spec: TemplateSpecPrepared): AnyRef;
 //#endregion
-export { TengoTemplateGet, TengoTemplateGetRegistry, TengoTemplateGetTemplate, TengoTemplateGetTemplateURI, TengoTemplatePack, TengoTemplatePackConvert, TengoTemplatePackConvertTemplate, TengoTemplatePackConvertTemplatePack, loadTemplate, prepareTemplateSpec };
 //# sourceMappingURL=template_loading.d.ts.map

package/dist/mutator/template/template_loading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template_loading.d.ts","names":[],"sources":["../../../src/mutator/template/template_loading.ts"],"mappings":";;;;cAea,gBAAA,EAAkB,YAAyD;AAAA,cAC3E,wBAAA;AAAA,cACA,2BAAA;AAAA,cACA,wBAAA;AAAA,cAEA,iBAAA,EAAmB,YAA0D;AAAA,cAC7E,wBAAA,EAA0B,YAGtC;AAAA,cACY,oCAAA;AAAA,cACA,gCAAA;AAAA,iBAES,mBAAA,CAAoB,GAAA,EAAK,eAAA,GAAkB,OAAA,CAAQ,oBAAA;AAAA,iBAgCzD,YAAA,CAAa,EAAA,EAAI,aAAA,EAAe,IAAA,EAAM,oBAAA,GAAuB,MAAA"}
+{"version":3,"file":"template_loading.d.ts","names":[],"sources":["../../../src/mutator/template/template_loading.ts"],"mappings":";;;qBAea,kBAAkB;qBAClB;qBACA;qBACA;qBAEA,mBAAmB;qBACnB,0BAA0B;qBAI1B;qBACA;wBAES,oBAAoB,KAAK,kBAAkB,QAAQ;wBAgCzD,aAAa,IAAI,eAAe,MAAM,uBAAuB"}

package/dist/network_check/network_check.d.ts

@@ -2,9 +2,8 @@ import { Dispatcher } from "undici";
 import { MiLogger, Signer } from "@milaboratories/ts-helpers";
 import { PlClient, PlClientConfig } from "@milaboratories/pl-client";
 import { ClientDownload, ClientUpload, LsDriver } from "@milaboratories/pl-drivers";
-
 //#region src/network_check/network_check.d.ts
-interface CheckNetworkOpts {
+export interface CheckNetworkOpts {
   /** Signal to abort all network checks. */
   signal?: AbortSignal;
   /** Platforma Backend pings options. */
@@ -40,8 +39,8 @@ interface CheckNetworkOpts {
 /** Checks connectivity to Platforma Backend, to block registry
  * and to auto-update CDN,
  * and generates a string report. */
-declare function checkNetwork(plCredentials: string, plUser: string | undefined, plPassword: string | undefined, optsOverrides?: Partial<CheckNetworkOpts>): Promise<string>;
-declare function initNetworkCheck(plCredentials: string, plUser: string | undefined, plPassword: string | undefined, optsOverrides?: Partial<CheckNetworkOpts>): Promise<{
+export declare function checkNetwork(plCredentials: string, plUser: string | undefined, plPassword: string | undefined, optsOverrides?: Partial<CheckNetworkOpts>): Promise<string>;
+export declare function initNetworkCheck(plCredentials: string, plUser: string | undefined, plPassword: string | undefined, optsOverrides?: Partial<CheckNetworkOpts>): Promise<{
   logger: MiLogger;
   plConfig: PlClientConfig;
   signer: Signer;
@@ -54,5 +53,4 @@ declare function initNetworkCheck(plCredentials: string, plUser: string | undefi
   terminate: () => Promise<void>;
 }>;
 //#endregion
-export { CheckNetworkOpts, checkNetwork, initNetworkCheck };
 //# sourceMappingURL=network_check.d.ts.map

package/dist/network_check/network_check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network_check.d.ts","names":[],"sources":["../../src/network_check/network_check.ts"],"mappings":";;;;;;UAqEiB,gBAAA;EA0Bf;EAxBA,MAAA,GAAS,WAAW;EA6BpB;EA1BA,mBAAA;EACA,aAAA;EACA,iBAAA;EA8ByB;EA3BzB,aAAA;EAiCoB;EA9BpB,uBAAA;EACA,0BAAA;EACA,gBAAA;EACA,kBAAA;EACA,iBAAA;EACA,WAAA;EA8BQ;EA3BR,uBAAA;EACA,+BAAA;EACA,gBAAA;EAwBe;EArBf,SAAA;EAqBA;EAlBA,sBAAA;EAmBQ;EAjBR,uBAAA;EA4GoB;EA1GpB,uBAAA;;EAEA,yBAAA;EA4Ge;EA1Gf,yBAAA;AAAA;;;;iBAMoB,YAAA,CACpB,aAAA,UACA,MAAA,sBACA,UAAA,sBACA,aAAA,GAAe,OAAA,CAAQ,gBAAA,IACtB,OAAA;AAAA,iBA2FmB,gBAAA,CACpB,aAAA,UACA,MAAA,sBACA,UAAA,sBACA,aAAA,GAAe,OAAA,CAAQ,gBAAA,IACtB,OAAA;EACD,MAAA,EAAQ,QAAA;EACR,QAAA,EAAU,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,QAAA;EACR,cAAA,EAAgB,cAAA;EAChB,gBAAA,EAAkB,YAAA;EAClB,QAAA,EAAU,QAAA;EACV,UAAA,EAAY,UAAA;EACZ,GAAA,EAAK,gBAAA;EACL,SAAA,QAAiB,OAAA;AAAA"}
+{"version":3,"file":"network_check.d.ts","names":[],"sources":["../../src/network_check/network_check.ts"],"mappings":";;;;;iBAqEiB;;EAEf,SAAS;;EAGT;EACA;EACA;;EAGA;;EAGA;EACA;EACA;EACA;EACA;EACA;;EAGA;EACA;EACA;;EAGA;;EAGA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;wBAMoB,aACpB,uBACA,4BACA,gCACA,gBAAe,QAAQ,oBACtB;wBA2FmB,iBACpB,uBACA,4BACA,gCACA,gBAAe,QAAQ,oBACtB;EACD,QAAQ;EACR,UAAU;EACV,QAAQ;EACR,QAAQ;EACR,gBAAgB;EAChB,kBAAkB;EAClB,UAAU;EACV,YAAY;EACZ,KAAK;EACL,iBAAiB"}

package/dist/pool/data.d.ts

@@ -3,10 +3,8 @@ import { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
 import { ResourceType, SignedResourceId } from "@milaboratories/pl-client";
 import { PlTreeNodeAccessor } from "@milaboratories/pl-tree";
 import { OnDemandBlobResourceSnapshot } from "@milaboratories/pl-drivers";
-
 //#region src/pool/data.d.ts
-declare function deriveGlobalPObjectId(blockId: string, exportName: string): PObjectId;
-declare function deriveLocalPObjectId(resolvePath: string[], outputName: string): PObjectId;
+export declare function deriveGlobalPObjectId(blockId: string, exportName: string): PObjectId;
+export declare function deriveLocalPObjectId(resolvePath: string[], outputName: string): PObjectId;
 //#endregion
-export { deriveGlobalPObjectId, deriveLocalPObjectId };
 //# sourceMappingURL=data.d.ts.map

package/dist/pool/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","names":[],"sources":["../../src/pool/data.ts"],"mappings":";;;;;;;iBA6UgB,qBAAA,CAAsB,OAAA,UAAiB,UAAA,WAAqB,SAAS;AAAA,iBAIrE,oBAAA,CAAqB,WAAA,YAAuB,UAAA,WAAqB,SAAS"}
+{"version":3,"file":"data.d.ts","names":[],"sources":["../../src/pool/data.ts"],"mappings":";;;;;;wBA6UgB,sBAAsB,iBAAiB,qBAAqB;wBAI5D,qBAAqB,uBAAuB,qBAAqB"}

package/dist/pool/driver.d.ts

@@ -2,19 +2,19 @@ import { PColumnDataUniversal } from "@platforma-sdk/model";
 import { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
 import { PlTreeNodeAccessor } from "@milaboratories/pl-tree";
 import { DownloadDriver } from "@milaboratories/pl-drivers";
+import "@milaboratories/helpers";
 import { AbstractInternalPFrameDriver, AbstractPFrameDriverOps } from "@milaboratories/pf-driver";
-
 //#region src/pool/driver.d.ts
-interface InternalPFrameDriver extends AbstractInternalPFrameDriver<PColumnDataUniversal<PlTreeNodeAccessor>> {}
-type PFrameDriverOps = AbstractPFrameDriverOps & {
-  /** Port to run parquet HTTP server on. */parquetServerPort: number;
+export interface InternalPFrameDriver extends AbstractInternalPFrameDriver<PColumnDataUniversal<PlTreeNodeAccessor>> {}
+export type PFrameDriverOps = AbstractPFrameDriverOps & {
+  /** Port to run parquet HTTP server on. */
+  parquetServerPort: number;
 };
 /**
  * Tuning for the persistent parquet blob cache, minus its filesystem path (which
  * is supplied separately - see {@link createPFrameDriver}'s `cachePath`). Carries
  * only the size/eviction knobs of {@link PFrameInternal.CacheConfig}.
  */
-type ParquetCacheOps = Omit<PFrameInternal.CacheConfig, "cachePath">;
+export type ParquetCacheOps = Omit<PFrameInternal.CacheConfig, "cachePath">;
 //#endregion
-export { InternalPFrameDriver, PFrameDriverOps, ParquetCacheOps };
 //# sourceMappingURL=driver.d.ts.map

package/dist/pool/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","names":[],"sources":["../../src/pool/driver.ts"],"mappings":";;;;;;;UA4SiB,oBAAA,SAA6B,4BAAA,CAC5C,oBAAA,CAAqB,kBAAA;AAAA,KAGX,eAAA,GAAkB,uBAAuB;EAJf,0CAMpC,iBAAiB;AAAA;;;;;;KAaP,eAAA,GAAkB,IAAI,CAAC,cAAA,CAAe,WAAA"}
+{"version":3,"file":"driver.d.ts","names":[],"sources":["../../src/pool/driver.ts"],"mappings":";;;;;;;iBA4SiB,6BAA6B,6BAC5C,qBAAqB;YAGX,kBAAkB;;EAE5B;;;;;;;YAaU,kBAAkB,KAAK,eAAe"}

package/dist/pool/index.d.ts

@@ -1,2 +1,3 @@
 import { InternalPFrameDriver, PFrameDriverOps, ParquetCacheOps } from "./driver.js";
+import "./result_pool.js";
 export { InternalPFrameDriver, PFrameDriverOps, ParquetCacheOps };

package/dist/pool/p_object_collection.d.ts

@@ -1,8 +1,6 @@
 import { PObject } from "@platforma-sdk/model";
 import { PlTreeNodeAccessor } from "@milaboratories/pl-tree";
-
 //#region src/pool/p_object_collection.d.ts
-declare function parseFinalPObjectCollection(node: PlTreeNodeAccessor, errorOnUnknownField: boolean | undefined, prefix: string | undefined, resolvePath: string[]): Record<string, PObject<PlTreeNodeAccessor>>;
+export declare function parseFinalPObjectCollection(node: PlTreeNodeAccessor, errorOnUnknownField: boolean | undefined, prefix: string | undefined, resolvePath: string[]): Record<string, PObject<PlTreeNodeAccessor>>;
 //#endregion
-export { parseFinalPObjectCollection };
 //# sourceMappingURL=p_object_collection.d.ts.map

package/dist/pool/p_object_collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"p_object_collection.d.ts","names":[],"sources":["../../src/pool/p_object_collection.ts"],"mappings":";;;;iBA+FgB,2BAAA,CACd,IAAA,EAAM,kBAAA,EACN,mBAAA,uBACA,MAAA,sBACA,WAAA,aACC,MAAA,SAAe,OAAA,CAAQ,kBAAA"}
+{"version":3,"file":"p_object_collection.d.ts","names":[],"sources":["../../src/pool/p_object_collection.ts"],"mappings":";;;wBA+FgB,4BACd,MAAM,oBACN,0CACA,4BACA,wBACC,eAAe,QAAQ"}

package/dist/pool/result_pool.d.ts

@@ -1,2 +1,4 @@
 import { PObject, PlRef } from "@platforma-sdk/model";
-import { PlTreeNodeAccessor } from "@milaboratories/pl-tree";
+import { PlTreeNodeAccessor } from "@milaboratories/pl-tree";
+import "@milaboratories/computable";
+import "utility-types";

package/dist/worker/worker.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-middle-layer",
-  "version": "1.67.5",
+  "version": "1.68.0",
   "description": "Pl Middle Layer",
   "keywords": [],
   "license": "UNLICENSED",
@@ -31,33 +31,33 @@
     "yaml": "^2.8.0",
     "zod": "~3.25.76",
     "@milaboratories/columns-collection-driver": "0.2.4",
-    "@milaboratories/computable": "2.9.8",
-    "@milaboratories/pl-deployments": "3.0.16",
-    "@milaboratories/pf-spec-driver": "1.5.1",
     "@milaboratories/helpers": "1.14.5",
-    "@milaboratories/pl-client": "3.14.7",
     "@milaboratories/pf-driver": "1.9.1",
-    "@milaboratories/pl-drivers": "1.16.16",
+    "@milaboratories/pf-spec-driver": "1.5.1",
+    "@milaboratories/computable": "2.9.8",
+    "@milaboratories/pl-drivers": "1.16.17",
+    "@milaboratories/pl-client": "3.14.7",
     "@milaboratories/pl-errors": "1.4.36",
+    "@milaboratories/pl-http": "1.2.4",
     "@milaboratories/pl-model-backend": "1.4.21",
+    "@milaboratories/pl-deployments": "3.0.16",
     "@milaboratories/pl-model-common": "1.48.0",
+    "@milaboratories/pl-tree": "1.14.0",
     "@milaboratories/pl-model-middle-layer": "1.32.0",
-    "@milaboratories/pl-http": "1.2.4",
-    "@milaboratories/resolve-helper": "1.1.3",
-    "@milaboratories/pl-tree": "1.13.7",
     "@platforma-sdk/block-tools": "2.14.3",
-    "@platforma-sdk/workflow-tengo": "6.8.3",
+    "@milaboratories/resolve-helper": "1.1.3",
+    "@milaboratories/ts-helpers": "1.8.6",
     "@platforma-sdk/model": "1.83.0",
-    "@milaboratories/ts-helpers": "1.8.6"
+    "@platforma-sdk/workflow-tengo": "6.8.3"
   },
   "devDependencies": {
     "@types/node": "~24.5.2",
     "@types/semver": "^7.7.0",
     "@vitest/coverage-istanbul": "^4.1.3",
-    "typescript": "~5.9.3",
+    "typescript": "7.0.2",
     "vitest": "^4.1.3",
-    "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.7.0",
+    "@milaboratories/build-configs": "2.0.1",
+    "@milaboratories/ts-builder": "1.7.1",
     "@milaboratories/ts-configs": "1.4.0"
   },
   "engines": {

package/src/middle_layer/build_stamp.ts

@@ -0,0 +1,36 @@
+/** Injected by rolldown at build time, see `build.node.config.js`. Absent when the package is
+ *  consumed straight from sources (`USE_SOURCES=1`), because no build step runs then. */
+declare const __PL_ML_BUILD_STAMP__: string | undefined;
+
+function injectedStamp(): string | undefined {
+  try {
+    // Read inside a try: with no build step the identifier is an undeclared global, and
+    // reading it throws a ReferenceError rather than yielding undefined.
+    return __PL_ML_BUILD_STAMP__;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Identifies the build of this package, and through it the rules that shape what a persisted
+ * tree mirror contains: the pruning function, the field filter and the traversal stop rules,
+ * all of which live in this package. (The finality predicate comes from pl-client and is NOT
+ * covered, which is harmless: finality is recomputed on restore, so it is the one rule that
+ * cannot poison a stored file.)
+ *
+ * Used as a cache-key component, so a change to those rules invalidates every snapshot, costing
+ * one cold open. Each built artifact bakes in one stamp, so reopens stay warm across restarts
+ * of an installed version. A build from a dirty worktree includes the build time, so editing
+ * those rules locally can never hit a snapshot written under the old ones. In practice release
+ * builds are dirty too, because CI writes version bumps into the worktree before building; that
+ * costs nothing, since the stamp only has to be stable within an artifact.
+ *
+ * With no build at all (sources mode) the value is a constant. That deliberately trades away
+ * the dirty-worktree guarantee: it means someone running from sources exercises the restore
+ * path at all, rather than every snapshot being a guaranteed miss for the one audience most
+ * likely to find its defects. The exposure it reintroduces, editing pruning rules from sources
+ * and hitting a mirror written under the old ones, is the local-development gap the design
+ * already accepts, and `treeSnapshots: false` or deleting the directory clears it.
+ */
+export const ML_BUILD_STAMP: string = injectedStamp() ?? "sources";

package/src/middle_layer/index.ts

@@ -2,5 +2,6 @@ export { MiddleLayer } from "./middle_layer";
 export { Project } from "./project";
 export * from "./driver_kit";
 export * from "./ops";
+export type { TreeSnapshotMiss, TreeSnapshotStat } from "./tree_snapshot_store";
 export { ProjectsField } from "./project_list";
 export type { OutgoingShare, PendingShare } from "./sharing_list";

package/src/middle_layer/middle_layer.ts

@@ -111,6 +111,13 @@ import type { Dispatcher } from "undici";
 import { RetryAgent } from "undici";
 import { getDebugFlags } from "../debug";
 import { ProjectHelper } from "../model/project_helper";
+import type { TreeSnapshotStat } from "./tree_snapshot_store";
+import { TreeSnapshotStore } from "./tree_snapshot_store";
+
+/** How long shutdown waits for close-boundary snapshot writes that are already running. Long
+ *  enough for a ten-megabyte encode and write on ordinary storage, short enough that a wedged
+ *  filesystem does not hold the quit open. */
+const SNAPSHOT_DRAIN_TIMEOUT_MS = 5_000;
 
 export interface MiddleLayerEnvironment {
   dispose(): Promise<void>;
@@ -129,6 +136,9 @@ export interface MiddleLayerEnvironment {
   readonly driverKit: MiddleLayerDriverKit;
   readonly serviceRegistry: ModelServiceRegistry;
   readonly projectHelper: ProjectHelper;
+  /** Persisted project tree mirrors. Undefined when snapshots are switched off, or when the
+   *  client is impersonating another user, in which case nothing is read or written. */
+  readonly treeSnapshots?: TreeSnapshotStore;
 }
 
 /**
@@ -1132,6 +1142,36 @@ export class MiddleLayer {
 
   private readonly openedProjects = new Map<ProjectId, Project>();
 
+  /** Snapshot writes started by {@link closeProject} and not yet finished. Held only so
+   *  {@link close} can give them a bounded chance to land. */
+  private readonly pendingSnapshotWrites = new Set<Promise<void>>();
+
+  private trackSnapshotWrite(write: Promise<void>): void {
+    this.pendingSnapshotWrites.add(write);
+    void write.finally(() => this.pendingSnapshotWrites.delete(write));
+  }
+
+  /** Waits for close-boundary snapshot writes that are already running, up to `timeoutMs`.
+   *
+   * This starts no work: quitting still performs no snapshot of its own. It only lets a write
+   * that a project close already began finish, so closing a project and immediately quitting
+   * does not routinely lose it. Bounded, because a wedged filesystem must not hang the quit,
+   * and losing the write costs one cold open rather than any correctness. */
+  private async drainSnapshotWrites(timeoutMs: number): Promise<void> {
+    if (this.pendingSnapshotWrites.size === 0) return;
+
+    let timer: NodeJS.Timeout | undefined;
+    const expiry = new Promise<void>((resolve) => {
+      timer = setTimeout(resolve, timeoutMs);
+      timer.unref?.();
+    });
+    try {
+      await Promise.race([Promise.allSettled(this.pendingSnapshotWrites), expiry]);
+    } finally {
+      if (timer !== undefined) clearTimeout(timer);
+    }
+  }
+
   /** Opens a project, and starts corresponding project maintenance loop. */
   public async openProject(id: ProjectId): Promise<void> {
     if (this.openedProjects.has(id)) throw new Error(`Project ${id} already opened`);
@@ -1145,6 +1185,16 @@ export class MiddleLayer {
     const prj = this.openedProjects.get(id);
     if (prj === undefined) throw new Error(`Project ${id} not found among opened projects`);
     this.openedProjects.delete(id);
+
+    // Snapshot before destroy, and here rather than inside destroy(): destroy() is also what
+    // application shutdown runs, and quitting should perform no snapshot work. Terminating the
+    // tree invalidates it, so the state has to be taken first either way.
+    //
+    // Started, not awaited. The capture happens synchronously inside, which is the part that
+    // needs the tree alive; the encode and write are up to ten megabytes of work that closing a
+    // project should not sit behind. Kept so shutdown can drain it.
+    this.trackSnapshotWrite(prj.snapshotOnClose());
+
     await prj.destroy();
     this.openedProjectsList.setValue([...this.openedProjects.keys()]);
   }
@@ -1161,6 +1211,13 @@ export class MiddleLayer {
     return this.openedProjects.has(id);
   }
 
+  /** Counters for the persisted project tree mirrors, or undefined when they are switched off.
+   *  Reads and hits are what show whether a reopen was actually warm, and the miss breakdown
+   *  says why it was not. */
+  public get treeSnapshotStats(): Readonly<TreeSnapshotStat> | undefined {
+    return this.env.treeSnapshots?.getStats();
+  }
+
   /**
    * Deallocates all runtime resources consumed by this object and awaits
    * actual termination of event loops and other processes associated with
@@ -1176,6 +1233,7 @@ export class MiddleLayer {
       this.sharingStateTree.terminate(),
       this.pendingSharesTree.terminate(),
     ]);
+    await this.drainSnapshotWrites(SNAPSHOT_DRAIN_TIMEOUT_MS);
     await this.env.dispose();
     await this.pl.close();
   }
@@ -1283,6 +1341,24 @@ export class MiddleLayer {
 
     const serviceRegistry = createModelServiceRegistry({ logger });
 
+    const treeSnapshots = TreeSnapshotStore.create(pl, {
+      dir: ops.treeSnapshotPath,
+      maxSizeBytes: ops.treeSnapshotOps.maxSizeBytes,
+      enabled: ops.treeSnapshotOps.enabled,
+      logger,
+    });
+    if (ops.treeSnapshotOps.enabled) {
+      // Housekeeping before any project opens: drop snapshots from other builds, backends and
+      // users, then trim to the ceiling.
+      await treeSnapshots?.evict();
+    } else {
+      // Switched off, so reclaim what earlier sessions left on disk. The reason to reach for
+      // this switch is usually the disk itself, and leaving the files behind would answer the
+      // wrong half of that complaint. Keyed on the setting, not on the store being absent: it
+      // is also absent for an impersonated client, whose session must not delete anything.
+      await TreeSnapshotStore.purge(ops.treeSnapshotPath, logger);
+    }
+
     const env: MiddleLayerEnvironment = {
       pl,
       blockEventDispatcher: new BlockEventDispatcher(),
@@ -1303,6 +1379,7 @@ export class MiddleLayer {
       serviceRegistry,
       quickJs,
       projectHelper: new ProjectHelper(quickJs, logger),
+      treeSnapshots,
       dispose: async () => {
         await serviceRegistry.dispose();
         await retryHttpDispatcher.destroy();

package/src/middle_layer/ops.ts

@@ -222,6 +222,40 @@ export type DriverKitOpsConstructor = Omit<
 export type MiddleLayerOpsPaths = DriverKitOpsPaths & {
   /** Common root where to put frontend code. */
   readonly frontendDownloadPath: string;
+
+  /**
+   * Directory holding persisted project tree mirrors, one file per project. Like
+   * {@link DriverKitOpsPaths.parquetCachePath} and unlike the spill directories, it is NOT
+   * emptied on startup: surviving a restart is the entire point. It is pruned instead, see
+   * {@link TreeSnapshotOps.maxSizeBytes}.
+   */
+  readonly treeSnapshotPath: string;
+};
+
+/** Tuning for the persisted project tree mirrors. Their directory is
+ *  {@link MiddleLayerOpsPaths.treeSnapshotPath}; this carries the behaviour knobs. */
+export type TreeSnapshotOps = {
+  /**
+   * Whether project tree mirrors are persisted and restored at all.
+   *
+   * On by default. This is an operational kill switch, for a deployment where the cache
+   * directory turns out to be unwritable or otherwise troublesome, not a rollout gate: the
+   * floor of the feature is current behaviour, since a cache that never hits is a cold open.
+   */
+  readonly enabled: boolean;
+
+  /**
+   * Minimum wall-clock gap between periodic writes for one project.
+   *
+   * Can be generous, because a stale snapshot is less complete rather than wrong: final
+   * resources never change and are never refetched, so this only bounds how much recent work
+   * comes back from the non-final frontier on restore.
+   */
+  readonly writeInterval: number;
+
+  /** Total bytes the snapshot directory may occupy after startup eviction. Needed because a
+   *  heavy project runs to roughly ten megabytes. */
+  readonly maxSizeBytes: number;
 };
 
 /** Debug options for middle layer. */
@@ -253,6 +287,10 @@ export type MiddleLayerOpsSettings = DriverKitOpsSettings & {
    * `sharedAt + envelopeTtlMs`. Share-with-everybody envelopes never expire
    * (`expiresAt: null`) and ignore this. */
   readonly envelopeTtlMs: number;
+
+  /** Settings for persisting project tree mirrors to disk, so reopening a project transfers
+   * what changed rather than the tree again. */
+  readonly treeSnapshotOps: TreeSnapshotOps;
 };
 
 export type MiddleLayerOps = MiddleLayerOpsSettings & MiddleLayerOpsPaths;
@@ -266,6 +304,7 @@ export const DefaultMiddleLayerOpsSettings: Pick<
   | "devBlockUpdateRecheckInterval"
   | "debugOps"
   | "envelopeTtlMs"
+  | "treeSnapshotOps"
 > = {
   ...DefaultDriverKitOpsSettings,
   defaultTreeOptions: {
@@ -279,17 +318,23 @@ export const DefaultMiddleLayerOpsSettings: Pick<
   devBlockUpdateRecheckInterval: 1000,
   projectRefreshInterval: 2000,
   envelopeTtlMs: 14 * 24 * 3600 * 1000, // 14 days
+  treeSnapshotOps: {
+    enabled: true,
+    writeInterval: 5 * 60 * 1000, // 5 minutes
+    maxSizeBytes: 256 * 1024 * 1024, // 256 MB, roughly 25 heavy projects
+  },
 };
 
 export function DefaultMiddleLayerOpsPaths(
   workDir: string,
 ): Pick<
   MiddleLayerOpsPaths,
-  keyof ReturnType<typeof DefaultDriverKitOpsPaths> | "frontendDownloadPath"
+  keyof ReturnType<typeof DefaultDriverKitOpsPaths> | "frontendDownloadPath" | "treeSnapshotPath"
 > {
   return {
     ...DefaultDriverKitOpsPaths(workDir),
     frontendDownloadPath: path.join(workDir, "frontend"),
+    treeSnapshotPath: path.join(workDir, "treeSnapshots"),
   };
 }