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

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

@@ -1 +1 @@
-{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/rm.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAsDxD,wBAAsB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3E"}
+{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/rm.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAsDxD,wBAAsB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E"}

package/dist/core/ssh/rm.js

@@ -11,9 +11,9 @@
 // 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 { isDirectoryAttrs, isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { enoent } from '@struktoai/mirage-core/errors/fs';
+import { isDirectoryAttrs, isNoSuchFile, joinRoot } from "./utils.js";
 async function statRemote(sftp, remote) {
     return new Promise((resolveFn, rejectFn) => {
         sftp.lstat(remote, (err, stats) => {
@@ -71,7 +71,7 @@ async function rmRecurse(sftp, remote) {
 }
 export async function rmR(accessor, p) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     try {
         await rmRecurse(sftp, remote);
@@ -81,6 +81,5 @@ export async function rmR(accessor, p) {
             throw enoent(p);
         throw err;
     }
-    await invalidateSubtree(p);
 }
 //# sourceMappingURL=rm.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../../src/core/ssh/rm.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,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAE5D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAElF,KAAK,UAAU,UAAU,CAAC,IAAiB,EAAE,MAAc;IACzD,OAAO,IAAI,OAAO,CAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAChD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAChC,IAAI,GAAG,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBAC/B,SAAS,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAiB,EAAE,MAAc;IAC5D,OAAO,IAAI,OAAO,CAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC/D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACjC,IAAI,GAAG,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBAC/B,SAAS,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAiB,EAAE,MAAc;IAC3D,OAAO,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC/C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,IAAI,GAAG;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;;gBACjB,SAAS,EAAE,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAiB,EAAE,MAAc;IAC1D,OAAO,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC/C,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;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAiB,EAAE,MAAc;IACxD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC5C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;gBAAE,SAAQ;YAC/D,MAAM,KAAK,GAAG,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAA;YACnF,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC/B,OAAM;IACR,CAAC;IACD,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,QAAqB,EAAE,CAAW;IAC1D,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,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/B,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,iBAAiB,CAAC,CAAC,CAAC,CAAA;AAC5B,CAAC"}
+{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../../src/core/ssh/rm.ts"],"names":[],"mappings":"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"}

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

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

package/dist/core/ssh/rmdir.js

@@ -11,9 +11,9 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
-import { invalidateAfterUnlink } from '@struktoai/mirage-core/cache/context';
-import { enoent, enotempty } from '@struktoai/mirage-core/utils/errors';
-import { isFailure, isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { enoent, enotempty } from '@struktoai/mirage-core/errors/fs';
+import { isFailure, isNoSuchFile, joinRoot } from "./utils.js";
 // The probe behind the version-3 arm below: whether the directory
 // still lists children. A probe that fails is a negative probe, never
 // an error to surface; the caller re-raises what the server said.
@@ -42,7 +42,7 @@ async function holdsEntries(accessor, remote) {
 // on ssh (it keys on the errno), and the raw SFTP failure leaks.
 export async function rmdir(accessor, p) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     try {
         await new Promise((resolveFn, rejectFn) => {
@@ -64,6 +64,5 @@ export async function rmdir(accessor, p) {
         }
         throw err;
     }
-    await invalidateAfterUnlink(p);
 }
 //# sourceMappingURL=rmdir.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"rmdir.js","sourceRoot":"","sources":["../../../src/core/ssh/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;AAEvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAE5E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAEvE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3E,kEAAkE;AAClE,sEAAsE;AACtE,kEAAkE;AAClE,KAAK,UAAU,YAAY,CAAC,QAAqB,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YACxD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;gBACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,QAAQ,CAAC,GAAG,CAAC,CAAA;oBACb,OAAM;gBACR,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAA;YAC3E,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,iEAAiE;AACjE,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAqB,EAAE,CAAW;IAC5D,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,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,SAAS,EAAE,CAAA;oBACX,OAAM;gBACR,CAAC;gBACD,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;oBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IACD,MAAM,qBAAqB,CAAC,CAAC,CAAC,CAAA;AAChC,CAAC"}
+{"version":3,"file":"rmdir.js","sourceRoot":"","sources":["../../../src/core/ssh/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;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAA;AAEpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9D,kEAAkE;AAClE,sEAAsE;AACtE,kEAAkE;AAClE,KAAK,UAAU,YAAY,CAAC,QAAqB,EAAE,MAAc;IAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,OAAO,CAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YACxD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;gBACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,QAAQ,CAAC,GAAG,CAAC,CAAA;oBACb,OAAM;gBACR,CAAC;gBACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAA;YAC3E,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,iEAAiE;AACjE,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAqB,EAAE,CAAW;IAC5D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,SAAS,EAAE,CAAA;oBACX,OAAM;gBACR,CAAC;gBACD,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;oBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { PathSpec } from '@struktoai/mirage-core/types';
+import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const GREP = "env LC_ALL=C grep --dereference-recursive --devices=skip -lF --null";
+/**
+ * The remote grep that lists the files under `scopes` holding `text`.
+ * Mirrors Python's `grep_command`.
+ */
+export declare function grepCommand(text: string, scopes: string[], ignoreCase: boolean): string;
+/**
+ * The files under `under` whose bytes hold `text`, as grep on the server
+ * finds them.
+ *
+ * The answer is exact, since every file is searched, so a whole word is asked
+ * as plain text: a file the word only sits inside is one more read. Only an
+ * exit of 0 or 1 with nothing on stderr, and output that is NUL-ended names,
+ * answers: a server that runs no commands (one forced to internal-sftp says
+ * so on stdout and exits 1), a grep that refuses an option (busybox exits 1
+ * for one), or a file it could not read (which the walk then reports) leaves
+ * every file to be read. Mirrors Python's `files_containing`.
+ */
+export declare function filesContaining(accessor: SSHAccessor, text: string, under: PathSpec[], ignoreCase: boolean): Promise<PathSpec[] | null>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/search.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AASxD,eAAO,MAAM,IAAI,wEAAwE,CAAA;AAEzF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAGvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAiC5B"}

package/dist/core/ssh/search.js

@@ -0,0 +1,85 @@
+// ========= 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 { mountedPath } from '@struktoai/mirage-core/utils/key_prefix';
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { joinRoot } from "./utils.js";
+// The remote search: grep in the C locale, so it compares bytes as mirage
+// reads them; --dereference-recursive, so it reads every file the walk can
+// reach, a link's target included (GNU's spelling of -R: BSD grep's -R
+// follows no link, and refuses this one); --devices=skip, so a FIFO the walk
+// would never read cannot block it; and --null, so a name ends where a NUL
+// does. `env` sets the locale under any login shell.
+export const GREP = 'env LC_ALL=C grep --dereference-recursive --devices=skip -lF --null';
+/**
+ * The remote grep that lists the files under `scopes` holding `text`.
+ * Mirrors Python's `grep_command`.
+ */
+export function grepCommand(text, scopes, ignoreCase) {
+    const words = [GREP, ...(ignoreCase ? ['-i'] : []), '-e', singleQuote(text)];
+    return [...words, '--', ...scopes.map(singleQuote)].join(' ');
+}
+/**
+ * The files under `under` whose bytes hold `text`, as grep on the server
+ * finds them.
+ *
+ * The answer is exact, since every file is searched, so a whole word is asked
+ * as plain text: a file the word only sits inside is one more read. Only an
+ * exit of 0 or 1 with nothing on stderr, and output that is NUL-ended names,
+ * answers: a server that runs no commands (one forced to internal-sftp says
+ * so on stdout and exits 1), a grep that refuses an option (busybox exits 1
+ * for one), or a file it could not read (which the walk then reports) leaves
+ * every file to be read. Mirrors Python's `files_containing`.
+ */
+export async function filesContaining(accessor, text, under, ignoreCase) {
+    const root = accessor.config.root ?? '/';
+    const scopes = under.map((p) => joinRoot(root, p.mountPath));
+    let status;
+    let out;
+    let err;
+    try {
+        ;
+        [status, out, err] = await accessor.run(grepCommand(text, scopes, ignoreCase));
+    }
+    catch (error) {
+        console.debug(`ssh search left to the scan: ${String(error)}`);
+        return null;
+    }
+    if ((status !== 0 && status !== 1) || err.length > 0)
+        return null;
+    if (out.length > 0 && out[out.length - 1] !== 0)
+        return null;
+    const [first] = under;
+    if (first === undefined)
+        return [];
+    const base = root.replace(/\/+$/, '');
+    const decoder = new TextDecoder('utf-8', { fatal: true });
+    const hits = [];
+    let start = 0;
+    for (let end = out.indexOf(0); end !== -1; end = out.indexOf(0, start)) {
+        let name;
+        try {
+            name = decoder.decode(out.subarray(start, end));
+        }
+        catch (error) {
+            console.debug(`ssh search left to the scan: ${String(error)}`);
+            return null;
+        }
+        if (!name.startsWith(`${base}/`))
+            return null;
+        hits.push(mountedPath(first, name.slice(base.length)));
+        start = end + 1;
+    }
+    return hits;
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"set_attrs.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/set_attrs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,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;AA+CD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAoB1C"}
+{"version":3,"file":"set_attrs.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/set_attrs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,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;AA+CD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAoB1C"}

package/dist/core/ssh/set_attrs.js

@@ -11,8 +11,9 @@
 // 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 { 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";
 function sftpStat(sftp, remote, p) {
     return new Promise((resolveFn, rejectFn) => {
         sftp.stat(remote, (err, stats) => {
@@ -58,7 +59,7 @@ function sftpUtimes(sftp, remote, atime, mtime) {
 // always residual.
 export async function setAttrs(accessor, path, fields) {
     const sftp = await accessor.sftp();
-    const remote = joinRoot(accessor.config.root ?? '/', stripPrefix(path));
+    const remote = joinRoot(accessor.config.root ?? '/', rawPathOf(path));
     const st = await sftpStat(sftp, remote, path);
     const residual = {};
     if (fields.mode !== undefined) {

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

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

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

@@ -1,4 +1,31 @@
-import type { FileStat, PathSpec } from '@struktoai/mirage-core/types';
+import { FileStat, type PathSpec } from '@struktoai/mirage-core/types';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const FIND = "env LC_ALL=C find -L";
+export declare const TREE_FORMAT = "%y %m %s %T@ %A@ %U %G %P\\0";
+export interface SshAttrs {
+    size?: number;
+    mode?: number;
+    mtime?: number;
+    atime?: number;
+    uid?: number;
+    gid?: number;
+}
+export declare function attrsToFileStat(name: string, attrs: SshAttrs): FileStat;
 export declare function stat(accessor: SSHAccessor, p: PathSpec): Promise<FileStat>;
+/**
+ * The remote find that lists `scope` and everything below it, links
+ * followed, one NUL-ended record per entry. Mirrors Python's `tree_command`.
+ */
+export declare function treeCommand(scope: string): string;
+/**
+ * Every file and directory under a directory, each as `stat` answers it, from
+ * one find on the server, where a walk sends a readdir per directory.
+ *
+ * Only an exit of 0 with nothing on stderr, a directory at `p`, and entries
+ * that are each a directory or a regular file answer: a server that runs no
+ * commands, a find without `-printf` (busybox, BSD), an entry it could not
+ * read, a link loop, a broken link or a special file leaves the walk to
+ * readdir, which reports each as it does today. Mirrors Python's `tree`.
+ */
+export declare function tree(accessor: SSHAccessor, p: PathSpec): Promise<Map<string, FileStat> | null>;
 //# sourceMappingURL=stat.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stat.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAItE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBhF"}
+{"version":3,"file":"stat.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stat.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAY,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAMhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAUxD,eAAO,MAAM,IAAI,yBAAyB,CAAA;AAC1C,eAAO,MAAM,WAAW,iCAAiC,CAAA;AAGzD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAwCvE;AAED,wBAAsB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBhF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CACxB,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,GACV,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,CAmCvC"}

package/dist/core/ssh/stat.js

@@ -11,13 +11,64 @@
 // 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 { rawPathOf } from '@struktoai/mirage-core/utils/key_prefix';
+import { FileStat, FileType } from '@struktoai/mirage-core/types';
+import { epochToIso } from '@struktoai/mirage-core/utils/dates';
+import { eacces, enoent } from '@struktoai/mirage-core/errors/fs';
+import { contentTypeForPath } from '@struktoai/mirage-core/utils/filetype';
 import { rstripSlash } from '@struktoai/mirage-core/utils/slash';
-import { attrsToFileStat } from "./entry.js";
-import { isNoSuchFile, joinRoot, stripPrefix } from "./utils.js";
+import { singleQuote } from '@struktoai/mirage-core/utils/quote';
+import { S_IFDIR, S_IFREG, isDirectoryAttrs, isNoSuchFile, isPermissionDenied, joinRoot, } from "./utils.js";
+export const FIND = 'env LC_ALL=C find -L';
+export const TREE_FORMAT = '%y %m %s %T@ %A@ %U %G %P\\0';
+const FIND_TYPES = { d: S_IFDIR, f: S_IFREG };
+export function attrsToFileStat(name, attrs) {
+    const modified = attrs.mtime !== undefined ? epochToIso(attrs.mtime) : null;
+    const extra = {};
+    if (attrs.mode !== undefined)
+        extra.mode = attrs.mode;
+    if (attrs.uid !== undefined)
+        extra.uid = attrs.uid;
+    if (attrs.gid !== undefined)
+        extra.gid = attrs.gid;
+    // Fields setattr applies natively (mode, times) surface from the
+    // remote inode, so external chmod/utime stays visible, mirroring
+    // disk. Ownership can never be applied natively (chown over SFTP
+    // needs privileges), so it lives wholly in the namespace overlay;
+    // server-side uid/gid stay in extra only.
+    const mode = attrs.mode !== undefined ? attrs.mode & 0o7777 : null;
+    const atime = attrs.atime !== undefined ? epochToIso(attrs.atime) : null;
+    // The remote mtime is the only cheap change token SFTP offers, so it is
+    // also the fingerprint: without one, a `read: fresh` mount has
+    // nothing to compare and keeps serving a cached copy that the server has
+    // already replaced. Mirrors the python stat.
+    if (isDirectoryAttrs(attrs)) {
+        return new FileStat({
+            name,
+            size: null,
+            modified,
+            fingerprint: modified,
+            type: FileType.DIRECTORY,
+            mode,
+            atime,
+            extra,
+        });
+    }
+    return new FileStat({
+        name,
+        size: attrs.size ?? null,
+        modified,
+        fingerprint: modified,
+        type: FileType.FILE,
+        content: contentTypeForPath(name),
+        mode,
+        atime,
+        extra,
+    });
+}
 export async function stat(accessor, p) {
     const sftp = await accessor.sftp();
-    const virtual = stripPrefix(p);
+    const virtual = rawPathOf(p);
     const remote = joinRoot(accessor.config.root ?? '/', virtual);
     const attrs = await new Promise((resolveFn, rejectFn) => {
         // Follow symlinks (stat, not lstat), like the Python core: reads
@@ -27,7 +78,7 @@ export async function stat(accessor, p) {
                 if (isNoSuchFile(err))
                     rejectFn(enoent(p));
                 else
-                    rejectFn(err);
+                    rejectFn(isPermissionDenied(err) ? eacces(p) : err);
                 return;
             }
             resolveFn(stats);
@@ -37,4 +88,82 @@ export async function stat(accessor, p) {
     const name = cleaned.length === 0 ? '/' : (cleaned.split('/').pop() ?? '/');
     return attrsToFileStat(name, attrs);
 }
+/**
+ * The remote find that lists `scope` and everything below it, links
+ * followed, one NUL-ended record per entry. Mirrors Python's `tree_command`.
+ */
+export function treeCommand(scope) {
+    return `${FIND} ${singleQuote(scope)} -printf ${singleQuote(TREE_FORMAT)}`;
+}
+/**
+ * Every file and directory under a directory, each as `stat` answers it, from
+ * one find on the server, where a walk sends a readdir per directory.
+ *
+ * Only an exit of 0 with nothing on stderr, a directory at `p`, and entries
+ * that are each a directory or a regular file answer: a server that runs no
+ * commands, a find without `-printf` (busybox, BSD), an entry it could not
+ * read, a link loop, a broken link or a special file leaves the walk to
+ * readdir, which reports each as it does today. Mirrors Python's `tree`.
+ */
+export async function tree(accessor, p) {
+    const scope = joinRoot(accessor.config.root ?? '/', rawPathOf(p));
+    let status;
+    let out;
+    let err;
+    try {
+        ;
+        [status, out, err] = await accessor.run(treeCommand(scope));
+    }
+    catch (error) {
+        console.debug(`ssh tree left to the walk: ${String(error)}`);
+        return null;
+    }
+    if (status !== 0 || err.length > 0 || out[out.length - 1] !== 0)
+        return null;
+    const decoder = new TextDecoder('utf-8', { fatal: true });
+    const rows = new Map();
+    let top = false;
+    let start = 0;
+    for (let end = out.indexOf(0); end !== -1; end = out.indexOf(0, start)) {
+        let fields;
+        try {
+            fields = decoder.decode(out.subarray(start, end)).split(' ');
+        }
+        catch (error) {
+            console.debug(`ssh tree left to the walk: ${String(error)}`);
+            return null;
+        }
+        start = end + 1;
+        const attrs = findAttrs(fields);
+        if (attrs === null)
+            return null;
+        const rel = fields.slice(7).join(' ');
+        if (rel === '') {
+            top = isDirectoryAttrs(attrs);
+            continue;
+        }
+        rows.set(rel, attrsToFileStat(rel.split('/').pop() ?? rel, attrs));
+    }
+    return top ? rows : null;
+}
+// One find record's fields as SFTP attributes, or null for a record that is
+// not a directory or a regular file, or that does not parse.
+function findAttrs(fields) {
+    const [kind = '', mode = '', size = '', mtime = '', atime = '', uid = '', gid = ''] = fields;
+    const type = FIND_TYPES[kind];
+    if (type === undefined || fields.length < 8 || !/^[0-7]+$/.test(mode))
+        return null;
+    if (![size, uid, gid].every((n) => /^\d+$/.test(n)))
+        return null;
+    if (![mtime, atime].every((t) => /^-?\d+(\.\d*)?$/.test(t)))
+        return null;
+    return {
+        mode: type | Number.parseInt(mode, 8),
+        size: Number(size),
+        mtime: Number(mtime.split('.')[0]),
+        atime: Number(atime.split('.')[0]),
+        uid: Number(uid),
+        gid: Number(gid),
+    };
+}
 //# sourceMappingURL=stat.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/ssh/stat.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,MAAM,EAAE,MAAM,qCAAqC,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAqB,EAAE,CAAW;IAC3D,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,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,CAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC7D,iEAAiE;QACjE,8DAA8D;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAC/B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,YAAY,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;;oBACrC,QAAQ,CAAC,GAAG,CAAC,CAAA;gBAClB,OAAM;YACR,CAAC;YACD,SAAS,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAA;IAC3E,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACrC,CAAC"}
+{"version":3,"file":"stat.js","sourceRoot":"","sources":["../../../src/core/ssh/stat.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,25 @@
 import type { PathSpec } from '@struktoai/mirage-core/types';
 import type { ReadStream } from 'ssh2';
 import type { SSHAccessor } from '../../accessor/ssh.ts';
+export declare const FOLLOW: string;
 export declare function readChunks(rs: ReadStream): AsyncIterable<Uint8Array>;
-export declare function stream(accessor: SSHAccessor, p: PathSpec): AsyncIterable<Uint8Array>;
-export declare function rangeRead(accessor: SSHAccessor, p: PathSpec, start: number, end: number): Promise<Uint8Array>;
+export declare function readStream(accessor: SSHAccessor, p: PathSpec): AsyncIterable<Uint8Array>;
+/**
+ * The file's last `n` lines, then each line added to it, from `tail -f` on the
+ * server over the mount's connection, so the file is not read again on each
+ * poll.
+ *
+ * The server's shell opens the file itself and, once it holds it open and
+ * finds a tail to run, says so with an empty line, and tail follows the
+ * descriptor it opened, so the file the open found is the file followed.
+ * Anything else (a server that runs no commands or has no tail, a missing or
+ * unreadable file, a directory, a file gone before the open) leaves the file
+ * to tail's poll, which reports it the way a failed open is reported and,
+ * under `--retry`, waits for it. The bytes are the server tail's own: whole
+ * lines, and the last line as it stands while the file has not ended it, as a
+ * tail there prints them. Its wait for growth is its own, so `interval` goes
+ * unused, and what it says on stderr (a truncation) is not shown. Mirrors
+ * Python's `follow`.
+ */
+export declare function follow(accessor: SSHAccessor, p: PathSpec, n: number, _interval: number): Promise<AsyncIterable<Uint8Array> | null>;
 //# sourceMappingURL=stream.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stream.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAYxD,wBAAuB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAa3E;AAED,wBAAuB,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAW3F;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAuBrB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/core/ssh/stream.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGxD,eAAO,MAAM,MAAM,QAEyB,CAAA;AAW5C,wBAAuB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAa3E;AAED,wBAAuB,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAW/F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,QAAQ,EACX,CAAC,EAAE,MAAM,EACT,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAmB3C"}