@struktoai/mirage-node 0.0.7-alpha.2 → 0.0.7

package/dist/core/ssh/constants.js

@@ -11,6 +11,8 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-export const SCOPE_WARN = 500;
 export const SCOPE_ERROR = 5000;
+/** SFTP open flags: write, creating a missing file and truncating none. */
+export const FXF_WRITE = 0x00000002;
+export const FXF_CREAT = 0x00000008;
 //# sourceMappingURL=constants.js.map

package/dist/core/ssh/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/ssh/constants.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,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAA;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/ssh/constants.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,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAA;AAE/B,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAA;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAA"}

package/dist/core/ssh/copy.d.ts

@@ -1,4 +1,13 @@
-import type { PathSpec } from '@struktoai/mirage-core/types';
+import { type PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const CP = "env LC_ALL=C cp -RL --";
+export declare const COPIED = "copied\n";
 export declare function copy(accessor: SSHAccessor, src: PathSpec, dst: PathSpec): Promise<void>;
+/**
+ * Copy a directory tree onto a fresh name with one `cp -RL` on the server,
+ * which follows links as the mount's listing does. A server that runs no
+ * commands leaves nothing at `dst`: that is ENOTSUP, and `cp -r` walks the
+ * tree itself. Mirrors Python's `dir_copy`.
+ */
+export declare function dirCopy(accessor: SSHAccessor, src: PathSpec, dst: PathSpec): Promise<void>;
 //# sourceMappingURL=copy.d.ts.map

package/dist/core/ssh/copy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/copy.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7F"}
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/copy.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAMxD,eAAO,MAAM,EAAE,2BAA2B,CAAA;AAC1C,eAAO,MAAM,MAAM,aAAa,CAAA;AAEhC,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7F;AAcD;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhG"}

package/dist/core/ssh/copy.js

@@ -11,10 +11,66 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { enotsup, fsError } from '@struktoai/mirage-core/errors/fs';
+import { POSIX } from '@struktoai/mirage-core/errors/posix';
+import { liftLost, lostCount, record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { exists } from "./exists.js";
 import { read } from "./read.js";
-import { writeBytes } from "./write.js";
+import { joinRoot } from "./utils.js";
+import { write } from "./write.js";
+export const CP = 'env LC_ALL=C cp -RL --';
+export const COPIED = 'copied\n';
 export async function copy(accessor, src, dst) {
     const data = await read(accessor, src);
-    await writeBytes(accessor, dst, data);
+    await write(accessor, dst, data);
+}
+/**
+ * The error a remote `cp` that ran and failed reports, by the phrase its
+ * first complaint ends with; anything else is EIO.
+ */
+function refusal(dst, err) {
+    const first = new TextDecoder().decode(err).trim().split('\n')[0] ?? '';
+    for (const [condition, posix] of Object.entries(POSIX)) {
+        if (first.endsWith(`: ${posix.phrase}`))
+            return fsError(dst, condition);
+    }
+    return fsError(dst, 'EIO');
+}
+/**
+ * Copy a directory tree onto a fresh name with one `cp -RL` on the server,
+ * which follows links as the mount's listing does. A server that runs no
+ * commands leaves nothing at `dst`: that is ENOTSUP, and `cp -r` walks the
+ * tree itself. Mirrors Python's `dir_copy`.
+ */
+export async function dirCopy(accessor, src, dst) {
+    const root = accessor.config.root ?? '/';
+    const command = `${CP} ${singleQuote(joinRoot(root, rawPathOf(src)))} ` +
+        `${singleQuote(joinRoot(root, rawPathOf(dst)))} && echo ${COPIED.trim()}`;
+    const upto = lostCount();
+    const timer = startOp();
+    let status;
+    let out;
+    let err;
+    try {
+        ;
+        [status, out, err] = await accessor.run(command);
+    }
+    catch (error) {
+        console.debug(`ssh tree copy left to the walk: ${String(error)}`);
+        throw enotsup(VFSName.SSH, 'dirCopy', dst);
+    }
+    if (status === 0 && new TextDecoder().decode(out) === COPIED) {
+        record('copy_prefix', dst.virtual, VFSName.SSH, 0, timer);
+        liftLost(dst, upto, true);
+        return;
+    }
+    if (!(await exists(accessor, dst))) {
+        console.debug(`ssh tree copy left to the walk: ${new TextDecoder().decode(err)}`);
+        throw enotsup(VFSName.SSH, 'dirCopy', dst);
+    }
+    throw refusal(dst, err);
 }
 //# sourceMappingURL=copy.js.map

package/dist/core/ssh/copy.js.map

@@ -1 +1 @@
-{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/core/ssh/copy.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;AAIvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAqB,EAAE,GAAa,EAAE,GAAa;IAC5E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACtC,MAAM,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../src/core/ssh/copy.ts"],"names":[],"mappings":"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"}

package/dist/core/ssh/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/create.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/create.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjF"}

package/dist/core/ssh/create.js

@@ -11,8 +11,23 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { writeBytes } from "./write.js";
-export function create(accessor, path) {
-    return writeBytes(accessor, path, new Uint8Array());
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { joinRoot, openForWrite } from "./utils.js";
+export async function create(accessor, path) {
+    const timer = startOp();
+    const sftp = await accessor.sftp();
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(path));
+    const handle = await openForWrite(sftp, remote, path, 'w');
+    await new Promise((resolveFn, rejectFn) => {
+        sftp.close(handle, (err) => {
+            if (err)
+                rejectFn(err);
+            else
+                resolveFn();
+        });
+    });
+    record('create', path.virtual, VFSName.SSH, 0, timer);
 }
 //# sourceMappingURL=create.js.map

package/dist/core/ssh/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/ssh/create.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;AAIvE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,UAAU,MAAM,CAAC,QAAqB,EAAE,IAAc;IAC1D,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/core/ssh/create.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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAGtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,IAAc;IAChE,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1D,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,GAAG;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBACjB,SAAS,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AACvD,CAAC"}

package/dist/core/ssh/exists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/exists.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjF"}
+{"version":3,"file":"exists.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/exists.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjF"}

package/dist/core/ssh/exists.js

@@ -11,10 +11,11 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { joinRoot, stripPrefix } from "./utils.js";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { joinRoot } from "./utils.js";
 export async function exists(accessor, p) {
     const sftp = await accessor.sftp();
-    const remote = joinRoot(accessor.config.root ?? '/', stripPrefix(p));
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
     return new Promise((resolveFn) => {
         sftp.exists(remote, (yes) => {
             resolveFn(yes);

package/dist/core/ssh/exists.js.map

@@ -1 +1 @@
-{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/ssh/exists.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;AAIvE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,CAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,OAAO,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,EAAE;QACxC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,SAAS,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"exists.js","sourceRoot":"","sources":["../../../src/core/ssh/exists.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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,CAAW;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,OAAO,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,EAAE;QACxC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,SAAS,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/core/ssh/mkdir.d.ts

@@ -1,4 +1,4 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
-export declare function mkdir(accessor: SSHAccessor, p: PathSpec, recursive: boolean): Promise<void>;
+export declare function mkdir(accessor: SSHAccessor, p: PathSpec, recursive?: boolean): Promise<void>;
 //# sourceMappingURL=mkdir.d.ts.map

package/dist/core/ssh/mkdir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/mkdir.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AA6BxD,wBAAsB,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjG"}
+{"version":3,"file":"mkdir.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/mkdir.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAI5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AA6BxD,wBAAsB,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhG"}

package/dist/core/ssh/mkdir.js

@@ -11,10 +11,10 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { invalidateAfterWrite, invalidateAncestors } from '@struktoai/mirage-core/cache/context';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { eexist, enoent } from '@struktoai/mirage-core/errors/fs';
 import { stripSlash } from '@struktoai/mirage-core/utils/slash';
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { isFailure, isNoSuchFile, joinRoot } from "./utils.js";
 async function statRemote(sftp, remote) {
     return new Promise((resolveFn) => {
         sftp.lstat(remote, (err, stats) => {
@@ -41,9 +41,9 @@ async function mkdirOne(sftp, remote, ignoreExisting) {
         });
     });
 }
-export async function mkdir(accessor, p, recursive) {
+export async function mkdir(accessor, p, recursive = false) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const root = accessor.config.root ?? '/';
     const remote = joinRoot(root, virtual);
     if (!recursive) {
@@ -53,6 +53,10 @@ export async function mkdir(accessor, p, recursive) {
         catch (err) {
             if (isNoSuchFile(err))
                 throw enoent(p);
+            // OpenSSH answers an existing target with SFTP 3's one generic
+            // refusal; only a stat can tell it was EEXIST.
+            if (isFailure(err) && (await statRemote(sftp, remote)) !== null)
+                throw eexist(p);
             throw err;
         }
         return;
@@ -70,7 +74,5 @@ export async function mkdir(accessor, p, recursive) {
             continue;
         await mkdirOne(sftp, stepRemote, true);
     }
-    await invalidateAfterWrite(p);
-    await invalidateAncestors(p);
 }
 //# sourceMappingURL=mkdir.js.map

package/dist/core/ssh/mkdir.js.map

@@ -1 +1 @@
-{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/core/ssh/mkdir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mkdir.js","sourceRoot":"","sources":["../../../src/core/ssh/mkdir.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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAG/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9D,KAAK,UAAU,UAAU,CAAC,IAAiB,EAAE,MAAc;IACzD,OAAO,IAAI,OAAO,CAAe,CAAC,SAAS,EAAE,EAAE;QAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,GAAG;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAA;;gBACnB,SAAS,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAiB,EAAE,MAAc,EAAE,cAAuB;IAChF,OAAO,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,SAAS,EAAE,CAAA;gBACX,OAAM;YACR,CAAC;YACD,IAAI,cAAc,EAAE,CAAC;gBACnB,6BAA6B;gBAC7B,SAAS,EAAE,CAAA;gBACX,OAAM;YACR,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAqB,EAAE,CAAW,EAAE,SAAS,GAAG,KAAK;IAC/E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAA;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,YAAY,CAAC,GAAG,CAAC;gBAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;YACtC,+DAA+D;YAC/D,+CAA+C;YAC/C,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI;gBAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;YAChF,MAAM,GAAG,CAAA;QACX,CAAC;QACD,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACnD,IAAI,QAAQ,EAAE,WAAW,EAAE;YAAE,SAAQ;QACrC,MAAM,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;IACxC,CAAC;AACH,CAAC"}

package/dist/core/ssh/pwrite.d.ts

@@ -0,0 +1,4 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare function pwrite(accessor: SSHAccessor, p: PathSpec, data: Uint8Array, offset: number): Promise<void>;
+//# sourceMappingURL=pwrite.d.ts.map

package/dist/core/ssh/pwrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwrite.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/pwrite.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/core/ssh/pwrite.js

@@ -0,0 +1,45 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { joinRoot, openForWrite } from "./utils.js";
+export async function pwrite(accessor, p, data, offset) {
+    const timer = startOp();
+    const sftp = await accessor.sftp();
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    const handle = await openForWrite(sftp, remote, p);
+    try {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.write(handle, Buffer.from(data), 0, data.byteLength, offset, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
+        });
+    }
+    finally {
+        await new Promise((resolveFn, rejectFn) => {
+            sftp.close(handle, (err) => {
+                if (err)
+                    rejectFn(err);
+                else
+                    resolveFn();
+            });
+        });
+    }
+    record('pwrite', p.virtual, VFSName.SSH, data.byteLength, timer);
+}
+//# sourceMappingURL=pwrite.js.map

package/dist/core/ssh/pwrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwrite.js","sourceRoot":"","sources":["../../../src/core/ssh/pwrite.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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAGtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,QAAqB,EACrB,CAAW,EACX,IAAgB,EAChB,MAAc;IAEd,MAAM,KAAK,GAAG,OAAO,EAAE,CAAA;IACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxE,IAAI,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBACjB,SAAS,EAAE,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,GAAG;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;oBACjB,SAAS,EAAE,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AAClE,CAAC"}

package/dist/core/ssh/read.d.ts

@@ -1,6 +1,6 @@
-import type { IndexCacheStore } from '@struktoai/mirage-core/cache/index/store';
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const WC = "env LC_ALL=C wc -l";
 /**
  * Read a file, optionally only a byte range of it.
  *
@@ -11,11 +11,17 @@ import type { SSHAccessor } from '../../accessor/ssh.ts';
  * Args:
  *   accessor: SSH accessor.
  *   p: the path to read.
- *   _index: unused; SFTP resolves the path itself.
  *   options: `{offset, size}`, the byte window, or absent for the whole file.
  */
-export declare function read(accessor: SSHAccessor, p: PathSpec, _index?: IndexCacheStore, options?: {
+export declare function read(accessor: SSHAccessor, p: PathSpec, options?: {
     offset?: number;
     size?: number;
 }): Promise<Uint8Array>;
+/**
+ * How many newlines a file holds, by wc on the server. Only an exit of 0 with
+ * nothing on stderr and one count on stdout answers: a server that runs no
+ * commands, a directory or a file wc could not read leaves the file to be
+ * read, which reports it. Mirrors Python's `line_count`.
+ */
+export declare function lineCount(accessor: SSHAccessor, p: PathSpec): Promise<number | null>;
 //# sourceMappingURL=read.d.ts.map

package/dist/core/ssh/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/read.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD;;;;;;;;;;;;GAYG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,UAAU,CAAC,CAgCrB"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/read.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAKxD,eAAO,MAAM,EAAE,uBAAuB,CAAA;AAEtC;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe1F"}

package/dist/core/ssh/read.js

@@ -11,9 +11,15 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { enoent } from '@struktoai/mirage-core/utils/errors';
+import { concat } from '@struktoai/mirage-core/utils/bytes';
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { record, startOp } from '@struktoai/mirage-core/observe/context';
+import { VFSName } from '@struktoai/mirage-core/types';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
 import { readChunks } from "./stream.js";
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { isNoSuchFile, joinRoot } from "./utils.js";
+export const WC = 'env LC_ALL=C wc -l';
 /**
  * Read a file, optionally only a byte range of it.
  *
@@ -24,14 +30,14 @@ import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
  * Args:
  *   accessor: SSH accessor.
  *   p: the path to read.
- *   _index: unused; SFTP resolves the path itself.
  *   options: `{offset, size}`, the byte window, or absent for the whole file.
  */
-export async function read(accessor, p, _index, options) {
+export async function read(accessor, p, options) {
     const start = options?.offset ?? 0;
     const size = options?.size ?? null;
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const timer = startOp();
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     // ssh2's readFile stats the file and issues a single READ for the whole
     // size; servers that honor large reads (asyncssh) reply with a packet over
@@ -54,12 +60,33 @@ export async function read(accessor, p, _index, options) {
             throw enoent(p);
         throw err;
     }
-    const out = new Uint8Array(total);
-    let at = 0;
-    for (const c of chunks) {
-        out.set(c, at);
-        at += c.byteLength;
-    }
+    const out = concat(chunks);
+    record('read', p.virtual, VFSName.SSH, total, timer);
     return out;
 }
+/**
+ * How many newlines a file holds, by wc on the server. Only an exit of 0 with
+ * nothing on stderr and one count on stdout answers: a server that runs no
+ * commands, a directory or a file wc could not read leaves the file to be
+ * read, which reports it. Mirrors Python's `line_count`.
+ */
+export async function lineCount(accessor, p) {
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    let status;
+    let out;
+    let err;
+    try {
+        ;
+        [status, out, err] = await accessor.run(`${WC} < ${singleQuote(remote)}`);
+    }
+    catch (error) {
+        console.debug(`ssh line count left to the read: ${String(error)}`);
+        return null;
+    }
+    const text = new TextDecoder().decode(out);
+    const count = text.trim();
+    if (status !== 0 || err.length > 0 || !text.endsWith('\n') || !/^\d+$/.test(count))
+        return null;
+    return Number(count);
+}
 //# sourceMappingURL=read.js.map

package/dist/core/ssh/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/ssh/read.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;AAIvE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAAqB,EACrB,CAAW,EACX,MAAwB,EACxB,OAA4C;IAE5C,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;IAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,wEAAwE;IACxE,2EAA2E;IAC3E,sEAAsE;IACtE,8CAA8C;IAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE;QACvC,KAAK;QACL,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACf,KAAK,IAAI,EAAE,CAAC,UAAU,CAAA;QACxB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,YAAY,CAAC,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,GAAG,CAAA;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACd,EAAE,IAAI,CAAC,CAAC,UAAU,CAAA;IACpB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/core/ssh/read.ts"],"names":[],"mappings":"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"}

package/dist/core/ssh/readdir.d.ts

@@ -1,4 +1,4 @@
-import type { PathSpec } from '@struktoai/mirage-core/types';
+import { FileStat, type PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
-export declare function readdir(accessor: SSHAccessor, p: PathSpec): Promise<string[]>;
+export declare function readdir(accessor: SSHAccessor, p: PathSpec): Promise<FileStat[]>;
 //# sourceMappingURL=readdir.d.ts.map

package/dist/core/ssh/readdir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/readdir.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAK5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAgCxD,wBAAsB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCnF"}
+{"version":3,"file":"readdir.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/readdir.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAY,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAKhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AA+DxD,wBAAsB,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA4BrF"}

package/dist/core/ssh/readdir.js

@@ -11,11 +11,13 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { listingError } from '@struktoai/mirage-core/utils/errors';
-import { mountPrefixOf } from '@struktoai/mirage-core/utils/key_prefix';
-import { stripSlash } from '@struktoai/mirage-core/utils/slash';
+import { FileStat, FileType } from '@struktoai/mirage-core/types';
+import { eacces, listingError } from '@struktoai/mirage-core/errors/fs';
+import { mountPrefixOf, rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
 import { compareCodePoints } from '@struktoai/mirage-core/utils/sort';
-import { isDirectoryAttrs, isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { attrsToFileStat } from "./stat.js";
+import { isDirectoryAttrs, isFileAttrs, isNoSuchFile, isPermissionDenied, joinRoot, } from "./utils.js";
 async function attrsOrNull(accessor, key) {
     const sftp = await accessor.sftp();
     const remote = joinRoot(accessor.config.root ?? '/', key);
@@ -44,11 +46,32 @@ async function isDir(accessor, key) {
     const attrs = await attrsOrNull(accessor, key);
     return attrs !== null && isDirectoryAttrs(attrs);
 }
+/**
+ * A listed entry as `stat` answers it. Readdir attrs are lstat-style, so an
+ * entry that is neither a directory nor a regular file (a link) is stat'ed
+ * once more, links followed, as `stat` reads it. A link that resolves to
+ * nothing the session may read keeps its listed name as a file. Mirrors
+ * Python's `_row_of`.
+ */
+async function rowOf(accessor, key, entry) {
+    // ssh2 types every field as present, but a server may leave the times (or
+    // size) out of a readdir entry; read them as optional.
+    const attrs = entry.attrs;
+    if (isDirectoryAttrs(attrs) || isFileAttrs(attrs))
+        return attrsToFileStat(entry.filename, attrs);
+    const followed = await attrsOrNull(accessor, key).catch((err) => {
+        if (isPermissionDenied(err))
+            return null;
+        throw err;
+    });
+    if (followed === null)
+        return new FileStat({ name: entry.filename, type: FileType.FILE });
+    return attrsToFileStat(entry.filename, followed);
+}
 export async function readdir(accessor, p) {
+    const mountPrefix = mountPrefixOf(p.virtual, p.vfsPath);
+    const virtual = p.pattern !== null ? p.directory.slice(mountPrefix.length) || '/' : rawPathOf(p);
     const sftp = await accessor.sftp();
-    const virtual = p.pattern !== null
-        ? p.directory.slice(mountPrefixOf(p.virtual, p.resourcePath).length) || '/'
-        : stripPrefix(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     const list = await new Promise((resolveFn, rejectFn) => {
         sftp.readdir(remote, (err, entries) => {
@@ -56,7 +79,7 @@ export async function readdir(accessor, p) {
                 if (isNoSuchFile(err))
                     resolveFn(null);
                 else
-                    rejectFn(err);
+                    rejectFn(isPermissionDenied(err) ? eacces(p) : err);
                 return;
             }
             resolveFn(entries);
@@ -65,16 +88,10 @@ export async function readdir(accessor, p) {
     if (list === null) {
         throw await listingError(p, virtual, (key) => isFile(accessor, key), (key) => isDir(accessor, key));
     }
-    const base = `/${stripSlash(virtual)}`;
-    const dirPrefix = base === '/' ? '/' : `${base}/`;
-    const mountPrefix = mountPrefixOf(p.virtual, p.resourcePath);
-    const names = [];
-    for (const entry of list) {
-        if (entry.filename === '.' || entry.filename === '..')
-            continue;
-        names.push(`${mountPrefix}${dirPrefix}${entry.filename}`);
-    }
-    names.sort(compareCodePoints);
-    return names;
+    const base = rstripSlash(virtual);
+    const found = list
+        .filter((entry) => entry.filename !== '.' && entry.filename !== '..')
+        .sort((x, y) => compareCodePoints(x.filename, y.filename));
+    return Promise.all(found.map((entry) => rowOf(accessor, `${base}/${entry.filename}`, entry)));
 }
 //# sourceMappingURL=readdir.js.map

package/dist/core/ssh/readdir.js.map

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

package/dist/core/ssh/rename.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/rename.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B/F"}
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/rename.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,wBAAsB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/F"}

package/dist/core/ssh/rename.js

@@ -11,14 +11,14 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { invalidateSubtree } from '@struktoai/mirage-core/cache/context';
-import { enoent } from '@struktoai/mirage-core/utils/errors';
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { isNoSuchFile, joinRoot } from "./utils.js";
 export async function rename(accessor, src, dst) {
     const sftp = await accessor.sftp();
     const root = accessor.config.root ?? '/';
-    const srcVirtual = stripPrefix(src);
-    const dstVirtual = stripPrefix(dst);
+    const srcVirtual = rawPathOf(src);
+    const dstVirtual = rawPathOf(dst);
     const remoteSrc = joinRoot(root, srcVirtual);
     const remoteDst = joinRoot(root, dstVirtual);
     // POSIX rename semantics (replace an existing destination); plain SFTP
@@ -41,10 +41,5 @@ export async function rename(accessor, src, dst) {
             sftp.rename(remoteSrc, remoteDst, done);
         }
     });
-    // Both sides are subtree evictions: a rename destroys the destination's
-    // previous identity and relocates everything under the source, so a
-    // listing or body cached below either name is now stale.
-    await invalidateSubtree(dst);
-    await invalidateSubtree(src);
 }
 //# sourceMappingURL=rename.js.map

package/dist/core/ssh/rename.js.map

@@ -1 +1 @@
-{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/core/ssh/rename.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,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,GAAa,EAAE,GAAa;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAA;IACxC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAC5C,uEAAuE;IACvE,wEAAwE;IACxE,uEAAuE;IACvE,iCAAiC;IACjC,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,CAAC,GAAY,EAAQ,EAAE;YAClC,IAAI,CAAC,GAAG;gBAAE,SAAS,EAAE,CAAA;iBAChB,IAAI,YAAY,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;;gBAC5C,QAAQ,CAAC,GAAY,CAAC,CAAA;QAC7B,CAAC,CAAA;QACD,IAAI,CAAC;YACH,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAC,CAAA;IACF,wEAAwE;IACxE,oEAAoE;IACpE,yDAAyD;IACzD,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC"}
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/core/ssh/rename.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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AAEzD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,GAAa,EAAE,GAAa;IAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAA;IACxC,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAC5C,uEAAuE;IACvE,wEAAwE;IACxE,uEAAuE;IACvE,iCAAiC;IACjC,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,CAAC,GAAY,EAAQ,EAAE;YAClC,IAAI,CAAC,GAAG;gBAAE,SAAS,EAAE,CAAA;iBAChB,IAAI,YAAY,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;;gBAC5C,QAAQ,CAAC,GAAY,CAAC,CAAA;QAC7B,CAAC,CAAA;QACD,IAAI,CAAC;YACH,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}