@struktoai/mirage-node 0.0.8-alpha.1 → 0.0.8

package/dist/core/disk/rmdir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rmdir.d.ts","sourceRoot":"","sources":["../../../src/core/disk/rmdir.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAsB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAOjF"}
+{"version":3,"file":"rmdir.d.ts","sourceRoot":"","sources":["../../../src/core/disk/rmdir.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAsB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF"}

package/dist/core/disk/rmdir.js

@@ -12,15 +12,19 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { rmdir as fsRmdir } from 'node:fs/promises';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
 import { diskError } from "./errors.js";
 import { resolveInside } from "./utils.js";
 export async function rmdir(accessor, path) {
     const full = await resolveInside(accessor.root, path);
+    const timer = startOp();
     try {
         await fsRmdir(full);
     }
     catch (err) {
         throw diskError(err, path);
     }
+    record('rmdir', path.virtual, VFSName.DISK, 0, timer);
 }
 //# sourceMappingURL=rmdir.js.map

package/dist/core/disk/rmdir.js.map

@@ -1 +1 @@
-{"version":3,"file":"rmdir.js","sourceRoot":"","sources":["../../../src/core/disk/rmdir.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAsB,EAAE,IAAc;IAChE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"rmdir.js","sourceRoot":"","sources":["../../../src/core/disk/rmdir.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAsB,EAAE,IAAc;IAChE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AACvD,CAAC"}

package/dist/core/disk/set_attrs.d.ts

@@ -1,11 +1,4 @@
-import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { PathSpec, SetAttrFields } from '@struktoai/mirage-core/types';
 import type { DiskAccessor } from '../../accessor/disk.ts';
-export interface SetAttrsFields {
-    mode?: number;
-    uid?: number | string;
-    gid?: number | string;
-    atime?: string;
-    mtime?: string;
-}
-export declare function setAttrs(accessor: DiskAccessor, path: PathSpec, fields: SetAttrsFields): Promise<Record<string, number | string>>;
+export declare function setAttrs(accessor: DiskAccessor, path: PathSpec, fields: SetAttrFields): Promise<Record<string, number | string>>;
 //# sourceMappingURL=set_attrs.d.ts.map

package/dist/core/disk/set_attrs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set_attrs.d.ts","sourceRoot":"","sources":["../../../src/core/disk/set_attrs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AASD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAuB1C"}
+{"version":3,"file":"set_attrs.d.ts","sourceRoot":"","sources":["../../../src/core/disk/set_attrs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAW1D,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAwB1C"}

package/dist/core/disk/set_attrs.js

@@ -11,8 +11,8 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { chmod, stat as fsStat, utimes } from 'node:fs/promises';
 import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { chmod, stat as fsStat, utimes } from 'node:fs/promises';
 import { diskError } from "./errors.js";
 import { resolveInside } from "./utils.js";
 // Write metadata fields (the write side of stat). Applies natively what the
@@ -37,6 +37,7 @@ export async function setAttrs(accessor, path, fields) {
     if (fields.mode !== undefined) {
         const keep = st.isDirectory() ? 0o700 : 0o600;
         await chmod(full, fields.mode | keep);
+        accessor.usage?.stale();
         if ((fields.mode | keep) !== fields.mode)
             residual.mode = fields.mode;
     }

package/dist/core/disk/set_attrs.js.map

@@ -1 +1 @@
-{"version":3,"file":"set_attrs.js","sourceRoot":"","sources":["../../../src/core/disk/set_attrs.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAU1C,4EAA4E;AAC5E,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,0EAA0E;AAC1E,yEAAyE;AACzE,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAsB,EACtB,IAAc,EACd,MAAsB;IAEtB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,IAAI,EAAE,CAAA;IACN,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACxE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAoC,EAAE,CAAA;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QAC7C,MAAM,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI;YAAE,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACvE,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;IACvD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;IACvD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAA;QAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAA;QAC/E,MAAM,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}
+{"version":3,"file":"set_attrs.js","sourceRoot":"","sources":["../../../src/core/disk/set_attrs.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,4EAA4E;AAC5E,uEAAuE;AACvE,6EAA6E;AAC7E,qEAAqE;AACrE,0EAA0E;AAC1E,yEAAyE;AACzE,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAsB,EACtB,IAAc,EACd,MAAqB;IAErB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,IAAI,EAAE,CAAA;IACN,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACxE,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAoC,EAAE,CAAA;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QAC7C,MAAM,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;QACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI;YAAE,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACvE,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;IACvD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;IACvD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAA;QAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAA;QAC/E,MAAM,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/core/disk/stream.d.ts

@@ -1,4 +1,12 @@
 import type { DiskAccessor } from '../../accessor/disk.ts';
 import type { PathSpec } from '@struktoai/mirage-core/types';
+/**
+ * A file's bytes as they are read, through `node:fs/promises`, never the
+ * CommonJS fs a JS runtime's patch may route back into the workspace this
+ * mount serves. A short read of a regular file is its end, as the kernel
+ * answers it, so a reader of a file its own pipeline appends to
+ * (`awk 1 f | tee -a f`) stops where the file ended when it read. Mirrors
+ * Python's `read_stream`.
+ */
 export declare function readStream(accessor: DiskAccessor, path: PathSpec): AsyncIterable<Uint8Array>;
 //# sourceMappingURL=stream.d.ts.map

package/dist/core/disk/stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/disk/stream.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,GACb,aAAa,CAAC,UAAU,CAAC,CAiB3B"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/disk/stream.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D;;;;;;;GAOG;AACH,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,GACb,aAAa,CAAC,UAAU,CAAC,CA6B3B"}

package/dist/core/disk/stream.js

@@ -11,30 +11,50 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { createReadStream } from 'node:fs';
+import { open } from 'node:fs/promises';
 import { recordStream } from '@struktoai/mirage-core/observe/context';
 import { VFSName } from '@struktoai/mirage-core/types';
 import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { diskError } from "./errors.js";
 import { resolveInside } from "./utils.js";
+/**
+ * A file's bytes as they are read, through `node:fs/promises`, never the
+ * CommonJS fs a JS runtime's patch may route back into the workspace this
+ * mount serves. A short read of a regular file is its end, as the kernel
+ * answers it, so a reader of a file its own pipeline appends to
+ * (`awk 1 f | tee -a f`) stops where the file ended when it read. Mirrors
+ * Python's `read_stream`.
+ */
 export async function* readStream(accessor, path) {
     const full = await resolveInside(accessor.root, path);
     const rec = recordStream('read', path.virtual, VFSName.DISK);
-    const rs = createReadStream(full, { highWaterMark: 65536 });
+    const failed = (err) => err.code === 'ENOENT' ? enoent(path) : diskError(err, path);
+    const handle = await open(full, 'r').catch((err) => {
+        throw failed(err);
+    });
     try {
-        for await (const chunk of rs) {
-            const buf = chunk;
-            const u8 = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
-            if (rec !== null)
-                rec.bytes += u8.byteLength;
-            yield u8;
+        const regular = (await handle.stat()).isFile();
+        const size = 256 * 1024;
+        for (;;) {
+            const { bytesRead, buffer } = await handle
+                .read(new Uint8Array(size), 0, size, null)
+                .catch((err) => {
+                throw failed(err);
+            });
+            if (bytesRead > 0) {
+                if (rec !== null)
+                    rec.bytes += bytesRead;
+                yield buffer.subarray(0, bytesRead);
+            }
+            if (bytesRead === 0 || (regular && bytesRead < size)) {
+                if (rec !== null)
+                    rec.complete = true;
+                return;
+            }
         }
     }
-    catch (err) {
-        if (err.code === 'ENOENT') {
-            throw enoent(path);
-        }
-        throw diskError(err, path);
+    finally {
+        await handle.close();
     }
 }
 //# sourceMappingURL=stream.js.map

package/dist/core/disk/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/core/disk/stream.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,QAAsB,EACtB,IAAc;IAEd,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3D,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,KAAe,CAAA;YAC3B,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAA;YACrE,IAAI,GAAG,KAAK,IAAI;gBAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAA;YAC5C,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/core/disk/stream.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAC/B,QAAsB,EACtB,IAAc;IAEd,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAY,EAAW,EAAE,CACtC,GAA6B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACxF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC1D,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC,CAAC,CAAA;IACF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;QAC9C,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAA;QACvB,SAAS,CAAC;YACR,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM;iBACvC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;iBACzC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;YACnB,CAAC,CAAC,CAAA;YACJ,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,IAAI,GAAG,KAAK,IAAI;oBAAE,GAAG,CAAC,KAAK,IAAI,SAAS,CAAA;gBACxC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACrC,CAAC;YACD,IAAI,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;gBACrD,IAAI,GAAG,KAAK,IAAI;oBAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAA;gBACrC,OAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;AACH,CAAC"}

package/dist/core/disk/unlink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/disk/unlink.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,wBAAsB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlF"}
+{"version":3,"file":"unlink.d.ts","sourceRoot":"","sources":["../../../src/core/disk/unlink.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,wBAAsB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBlF"}

package/dist/core/disk/unlink.js

@@ -12,11 +12,14 @@
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { stat as fsStat, unlink as fsUnlink } from 'node:fs/promises';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
 import { eisdir } from '@struktoai/mirage-core/errors/fs';
 import { diskError } from "./errors.js";
 import { resolveInside } from "./utils.js";
 export async function unlink(accessor, path) {
     const full = await resolveInside(accessor.root, path);
+    const timer = startOp();
     try {
         await fsUnlink(full);
     }
@@ -30,5 +33,6 @@ export async function unlink(accessor, path) {
         }
         throw diskError(err, path);
     }
+    record('unlink', path.virtual, VFSName.DISK, 0, timer);
 }
 //# sourceMappingURL=unlink.js.map

package/dist/core/disk/unlink.js.map

@@ -1 +1 @@
-{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/disk/unlink.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGrE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAsB,EAAE,IAAc;IACjE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kEAAkE;QAClE,iDAAiD;QACjD,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CACnC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EACxB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;YACD,IAAI,KAAK;gBAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QACD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"unlink.js","sourceRoot":"","sources":["../../../src/core/disk/unlink.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAGvE,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAsB,EAAE,IAAc;IACjE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,kEAAkE;QAClE,iDAAiD;QACjD,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CACnC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EACxB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;YACD,IAAI,KAAK;gBAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QACD,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AACxD,CAAC"}

package/dist/core/disk/utils.d.ts

@@ -10,6 +10,8 @@ export declare function resolveSafe(root: string, virtual: string): string;
  * spelled-wise read or write wherever the link points on the host, and
  * `readdir` leaves it out so every walk agrees. Components past the first
  * absent one are left to the op, which answers its own ENOENT or creates.
+ * Fresh native proofs avoid sibling scans where supported; other names require
+ * listing. Parents remain readable on both paths for uniform permissions.
  * Mirrors Python's resolve_inside.
  *
  * It answers for the tree as it stands when called. The mount's own writers

package/dist/core/disk/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/disk/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAEzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWjE;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,MAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASnE;AAED,4FAA4F;AAC5F,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAItE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/disk/utils.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,SAAS,CAAA;AAC5C,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAA;AAEzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAWjE;AAkED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,MAAuB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASnE;AAED,4FAA4F;AAC5F,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAItE"}

package/dist/core/disk/utils.js

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { constants, lstat, open, realpath, readdir } from 'node:fs/promises';
+import { constants, lstat, open, opendir, readdir, realpath, } from 'node:fs/promises';
 import path from 'node:path';
 import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { lstripSlash } from '@struktoai/mirage-core/utils/slash';
@@ -27,15 +27,68 @@ export function resolveSafe(root, virtual) {
     }
     return resolved;
 }
-// Null when realpath fails. That happens alike for a missing component, a
-// dangling link and a loop, so resolveInside's walk, which tells them apart,
-// is what answers.
-async function realOrNull(p) {
+async function nativeRealpath(file) {
+    return realpath(file);
+}
+/**
+ * Prove the requested spelling is the entry's own, listing the parent's names
+ * only when nothing cheaper proves it. An ASCII name has one spelling unless
+ * the directory folds case, and the name with one letter's case flipped tells:
+ * absent, a link or another entry means the directory keeps case apart, so the
+ * name that resolved is exact. Where it folds, a native path is trusted only
+ * when the flipped, non-link spelling converges on the same full path whose
+ * leaf is exactly the requested name. A name past ASCII may also fold or
+ * normalize in ways one probe cannot see. Every proof that skips the listing
+ * still opens the parent, so permissions stay uniform; no name cache. Mirrors
+ * Python's exact_name.
+ */
+async function exactName(parent, part, info) {
+    const index = part.search(/[A-Za-z]/);
+    let alternate;
+    let folds = false;
+    if (index !== -1) {
+        const char = part[index] ?? '';
+        const flipped = char === char.toLowerCase() ? char.toUpperCase() : char.toLowerCase();
+        alternate = path.join(parent, part.slice(0, index) + flipped + part.slice(index + 1));
+        try {
+            const alias = await lstat(alternate);
+            folds = !alias.isSymbolicLink() && alias.dev === info.dev && alias.ino === info.ino;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT' && code !== 'ENOTDIR') {
+                console.debug('Disk spelling probe unavailable:', code);
+                return (await readdir(parent)).includes(part);
+            }
+        }
+    }
+    if (/^\p{ASCII}*$/u.test(part) && !folds) {
+        await openParent(parent);
+        return true;
+    }
+    if (folds && alternate !== undefined && ['darwin', 'win32'].includes(process.platform)) {
+        try {
+            const canonical = await nativeRealpath(path.join(parent, part));
+            if (path.basename(canonical) === part && (await nativeRealpath(alternate)) === canonical) {
+                await openParent(parent);
+                return true;
+            }
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT' && code !== 'ENOTDIR' && code !== 'EACCES')
+                console.debug('Native disk spelling proof unavailable:', code);
+        }
+    }
+    return (await readdir(parent)).includes(part);
+}
+async function openParent(parent) {
+    const listing = await opendir(parent, { bufferSize: 1 });
     try {
-        return await realpath(p);
+        await listing.read();
     }
-    catch {
-        return null;
+    finally {
+        await listing.close();
     }
 }
 /**
@@ -45,6 +98,8 @@ async function realOrNull(p) {
  * spelled-wise read or write wherever the link points on the host, and
  * `readdir` leaves it out so every walk agrees. Components past the first
  * absent one are left to the op, which answers its own ENOENT or creates.
+ * Fresh native proofs avoid sibling scans where supported; other names require
+ * listing. Parents remain readable on both paths for uniform permissions.
  * Mirrors Python's resolve_inside.
  *
  * It answers for the tree as it stands when called. The mount's own writers
@@ -62,25 +117,17 @@ export async function resolveInside(root, spec, virtual = spec.mountPath) {
     const base = path.resolve(root);
     if (full === base)
         return full;
-    // A realpath or two instead of an lstat per component: a path that is its
-    // own real location crosses no link at all, and one whose real location is
-    // the root's plus the same relative path crosses none below the root.
-    // Anything else (a link, a missing component, a case the filesystem folds)
-    // is decided by the walk below, which reports its own errors.
-    const real = await realOrNull(full);
-    if (real === full)
-        return full;
-    const realBase = await realOrNull(base);
-    if (realBase !== null && real === path.join(realBase, path.relative(base, full)))
-        return full;
     let at = base;
     for (const part of path.relative(at, full).split(path.sep)) {
         if (part === '')
             break;
-        at = path.join(at, part);
+        const parent = at;
+        at = path.join(parent, part);
         let info;
+        let exact;
         try {
             info = await lstat(at);
+            exact = info.isSymbolicLink() ? false : await exactName(parent, part, info);
         }
         catch (err) {
             const code = err.code;
@@ -88,7 +135,7 @@ export async function resolveInside(root, spec, virtual = spec.mountPath) {
                 return full;
             throw diskError(err, spec);
         }
-        if (info.isSymbolicLink())
+        if (!exact || info.isSymbolicLink())
             throw enoent(spec);
     }
     return full;

package/dist/core/disk/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/disk/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/disk/utils.ts"],"names":[],"mappings":"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"}

package/dist/core/disk/write.d.ts

@@ -1,6 +1,11 @@
 import type { DiskAccessor } from '../../accessor/disk.ts';
 import type { ByteSource } from '@struktoai/mirage-core/io/types';
 import type { PathSpec } from '@struktoai/mirage-core/types';
-export declare function write(accessor: DiskAccessor, p: PathSpec, data: Uint8Array): Promise<void>;
-export declare function writeStream(accessor: DiskAccessor, p: PathSpec, data: ByteSource, append?: boolean, signal?: AbortSignal, atomic?: boolean): Promise<void>;
+/**
+ * Replace a file's bytes, or add them to its end, with one open handle: bytes
+ * in one write, a stream in bounded pulls, so a reader watches the file grow.
+ * `atomic` stages the output until it ends, keeping the file's mode. Mirrors
+ * Python's `write`.
+ */
+export declare function write(accessor: DiskAccessor, p: PathSpec, data: ByteSource, append?: boolean, signal?: AbortSignal, atomic?: boolean): Promise<void>;
 //# sourceMappingURL=write.d.ts.map

package/dist/core/disk/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAGjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,wBAAsB,KAAK,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhG;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,YAAY,EACtB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,UAAQ,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CA+Cf"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAI1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAGjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D;;;;;GAKG;AACH,wBAAsB,KAAK,CACzB,QAAQ,EAAE,YAAY,EACtB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,UAAQ,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,UAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/core/disk/write.js

@@ -11,30 +11,36 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { chmod, mkdtemp, open, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { appendFile, chmod, mkdtemp, open, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { chunks } from '@struktoai/mirage-core/io/cooperative';
 import { record, startOp } from '@struktoai/mirage-core/observe/context';
 import { VFSName } from '@struktoai/mirage-core/types';
 import { diskError } from "./errors.js";
 import { resolveInside } from "./utils.js";
-export async function write(accessor, p, data) {
+/**
+ * Replace a file's bytes, or add them to its end, with one open handle: bytes
+ * in one write, a stream in bounded pulls, so a reader watches the file grow.
+ * `atomic` stages the output until it ends, keeping the file's mode. Mirrors
+ * Python's `write`.
+ */
+export async function write(accessor, p, data, append = false, signal, atomic = false) {
+    const op = append ? 'append' : 'write';
     const timer = startOp();
     const full = await resolveInside(accessor.root, p);
-    // A write is not `mkdir -p`: GNU reports ENOENT on a missing parent
-    // rather than building the chain, and the store-backed backends refuse
-    // the same way. Only the virtual path may reach a stderr line.
-    try {
-        await writeFile(full, data);
-    }
-    catch (err) {
-        throw diskError(err, p);
+    if (data instanceof Uint8Array && !atomic) {
+        // A write is not `mkdir -p`: GNU reports ENOENT on a missing parent
+        // rather than building the chain, and the store-backed backends refuse
+        // the same way. Only the virtual path may reach a stderr line.
+        try {
+            await (append ? appendFile(full, data) : writeFile(full, data));
+        }
+        catch (err) {
+            throw diskError(err, p);
+        }
+        record(op, p.virtual, VFSName.DISK, data.byteLength, timer);
+        return;
     }
-    record('write', p.virtual, VFSName.DISK, data.byteLength, timer);
-}
-export async function writeStream(accessor, p, data, append = false, signal, atomic = false) {
-    const timer = startOp();
-    const full = await resolveInside(accessor.root, p);
     let size = 0;
     let staged = null;
     let reading = false;
@@ -88,6 +94,6 @@ export async function writeStream(accessor, p, data, append = false, signal, ato
         if (staged !== null)
             await rm(staged, { recursive: true, force: true });
     }
-    record(append ? 'append' : 'write', p.virtual, VFSName.DISK, size, timer);
+    record(op, p.virtual, VFSName.DISK, size, timer);
 }
 //# sourceMappingURL=write.js.map

package/dist/core/disk/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/core/disk/write.ts"],"names":[],"mappings":"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"}

package/dist/core/email/_parse.d.ts

@@ -1,7 +1,4 @@
-interface EmailAddress {
-    name: string;
-    email: string;
-}
+import type { EmailAddress as MailparserEmailAddress, ParsedMail } from 'mailparser';
 interface ParsedAttachment {
     filename: string;
     content_type: string;
@@ -10,11 +7,27 @@ interface ParsedAttachment {
 interface ParsedAttachmentWithPayload extends ParsedAttachment {
     payload: Uint8Array;
 }
-export interface ParsedRfc822 {
-    from: EmailAddress;
-    reply_to: EmailAddress[];
-    to: EmailAddress[];
-    cc: EmailAddress[];
+export declare function toAddr(a: MailparserEmailAddress | undefined): {
+    name: string;
+    email: string;
+};
+export declare function fromParsed(parsed: ParsedMail, headersOnly: boolean): {
+    from: {
+        name: string;
+        email: string;
+    };
+    reply_to: {
+        name: string;
+        email: string;
+    }[];
+    to: {
+        name: string;
+        email: string;
+    }[];
+    cc: {
+        name: string;
+        email: string;
+    }[];
     subject: string;
     date: string;
     body_text: string;
@@ -24,9 +37,44 @@ export interface ParsedRfc822 {
     in_reply_to: string | null;
     references: string[];
     has_attachments: boolean;
-    attachments: ParsedAttachment[];
-}
-export declare function parseRfc822(raw: Uint8Array, headersOnly?: boolean): Promise<ParsedRfc822>;
+    attachments: {
+        filename: string;
+        content_type: string;
+        size: number;
+    }[];
+};
+export declare function parseRfc822(raw: Uint8Array, headersOnly?: boolean): Promise<{
+    from: {
+        name: string;
+        email: string;
+    };
+    reply_to: {
+        name: string;
+        email: string;
+    }[];
+    to: {
+        name: string;
+        email: string;
+    }[];
+    cc: {
+        name: string;
+        email: string;
+    }[];
+    subject: string;
+    date: string;
+    body_text: string;
+    body_html: string;
+    snippet: string;
+    message_id: string;
+    in_reply_to: string | null;
+    references: string[];
+    has_attachments: boolean;
+    attachments: {
+        filename: string;
+        content_type: string;
+        size: number;
+    }[];
+}>;
 export declare function parseWithPayloads(raw: Uint8Array): Promise<ParsedAttachmentWithPayload[]>;
 export {};
 //# sourceMappingURL=_parse.d.ts.map

package/dist/core/email/_parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_parse.d.ts","sourceRoot":"","sources":["../../../src/core/email/_parse.ts"],"names":[],"mappings":"AAsBA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,2BAA4B,SAAQ,gBAAgB;IAC5D,OAAO,EAAE,UAAU,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,EAAE,EAAE,YAAY,EAAE,CAAA;IAClB,EAAE,EAAE,YAAY,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAChC;AAsED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAI7F;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAS/F"}
+{"version":3,"file":"_parse.d.ts","sourceRoot":"","sources":["../../../src/core/email/_parse.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAEV,YAAY,IAAI,sBAAsB,EACtC,UAAU,EAEX,MAAM,YAAY,CAAA;AAEnB,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,2BAA4B,SAAQ,gBAAgB;IAC5D,OAAO,EAAE,UAAU,CAAA;CACpB;AAkBD,wBAAgB,MAAM,CAAC,CAAC,EAAE,sBAAsB,GAAG,SAAS;;;EAG3D;AAmBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BlE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,UAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAIrE;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC,CAS/F"}

package/dist/core/email/_parse.js

@@ -20,7 +20,7 @@ async function getParser() {
     })();
     return parserPromise;
 }
-function toAddr(a) {
+export function toAddr(a) {
     if (a === undefined)
         return { name: '', email: '' };
     return { name: a.name, email: a.address ?? '' };
@@ -40,7 +40,7 @@ function rawDateHeader(parsed) {
     const colon = found.line.indexOf(':');
     return colon === -1 ? '' : found.line.slice(colon + 1).trim();
 }
-function fromParsed(parsed, headersOnly) {
+export function fromParsed(parsed, headersOnly) {
     const text = headersOnly ? '' : (parsed.text ?? '');
     const html = headersOnly ? '' : typeof parsed.html === 'string' ? parsed.html : '';
     const attachments = headersOnly