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

package/dist/workspace/store/redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/redis.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAA;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAA;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC7B,MAAM,6CAA6C,CAAA;AAMpD,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;gBAEzD,OAAO,GAAE,+BAAoC;YAQ3C,MAAM;IAmBpB,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAY5D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAY1D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;cAYzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAM9D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAOtE,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC;cASH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAS3C"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/redis.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAA;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAA;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EACV,eAAe,EACf,4BAA4B,EAC7B,MAAM,6CAA6C,CAAA;AAMpD,MAAM,WAAW,+BAAgC,SAAQ,4BAA4B;IACnF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;gBAEzD,OAAO,GAAE,+BAAoC;IASzD,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAY5D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAY1D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;cAYzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAQ9D,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC;cASH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAS9C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAM3C"}

package/dist/workspace/store/redis.js

@@ -13,8 +13,8 @@
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
 import { WorkspaceStateStore } from '@struktoai/mirage-core/workspace/store/base';
 import { RedisObserverStore } from "../../observe/redis_store.js";
-import { loadOptionalPeer } from "../../optional_peer.js";
-import { RedisNamespaceStore } from "../namespace/redis.js";
+import { RedisConnection } from "../../optional_peer.js";
+import { RedisNamespaceStore } from "../mount/namespace/redis.js";
 import { CAS_SCRIPT, RedisSessionStore } from "../session/redis.js";
 /**
  * WorkspaceStateStore backed by one Redis server.
@@ -35,7 +35,7 @@ export class RedisWorkspaceStateStore extends WorkspaceStateStore {
     url;
     prefix;
     metaKey;
-    clientPromise = null;
+    redis;
     namespaces = new Map();
     observers = new Map();
     sessionTables = new Map();
@@ -45,18 +45,7 @@ export class RedisWorkspaceStateStore extends WorkspaceStateStore {
         this.url = url ?? 'redis://localhost:6379/0';
         this.prefix = keyPrefix ?? 'mirage:';
         this.metaKey = `${this.prefix}workspaces`;
-    }
-    async client() {
-        this.clientPromise ??= (async () => {
-            const mod = await loadOptionalPeer(() => import('redis'), { feature: 'RedisWorkspaceStateStore', packageName: 'redis' });
-            const c = mod.createClient({
-                url: this.url,
-                socket: { reconnectStrategy: false },
-            });
-            await c.connect();
-            return c;
-        })();
-        return this.clientPromise;
+        this.redis = new RedisConnection(this.url, 'RedisWorkspaceStateStore');
     }
     makeNamespace(workspaceId) {
         let ns = this.namespaces.get(workspaceId);
@@ -92,24 +81,28 @@ export class RedisWorkspaceStateStore extends WorkspaceStateStore {
         return table;
     }
     async readMeta(workspaceId) {
-        const c = await this.client();
+        const c = await this.redis.client();
         const raw = await c.hGet(this.metaKey, workspaceId);
         return raw != null ? JSON.parse(raw) : null;
     }
-    async writeMeta(workspaceId, fields) {
-        const c = await this.client();
-        await c.hSet(this.metaKey, workspaceId, JSON.stringify(fields));
-    }
     // Same generic hash-field CAS the session store uses: the meta hash
     // is keyed by workspace id instead of session id.
     async casWriteMeta(workspaceId, fields, expectedGeneration) {
-        const c = await this.client();
+        const c = await this.redis.client();
         const result = await c.eval(CAS_SCRIPT, {
             keys: [this.metaKey],
             arguments: [workspaceId, JSON.stringify(fields), String(expectedGeneration)],
         });
         return result === 1;
     }
+    async forgetSelf(workspaceId) {
+        for (const handles of [this.namespaces, this.observers, this.sessionTables]) {
+            await handles.get(workspaceId)?.close();
+            handles.delete(workspaceId);
+        }
+        const c = await this.redis.client();
+        await c.hDel(this.metaKey, workspaceId);
+    }
     async closeSelf() {
         for (const ns of this.namespaces.values())
             await ns.close();
@@ -117,10 +110,7 @@ export class RedisWorkspaceStateStore extends WorkspaceStateStore {
             await ob.close();
         for (const table of this.sessionTables.values())
             await table.close();
-        if (this.clientPromise !== null) {
-            const c = await this.clientPromise;
-            await c.quit();
-        }
+        await this.redis.close();
     }
 }
 //# sourceMappingURL=redis.js.map

package/dist/workspace/store/redis.js.map

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

package/dist/workspace/workspace/kernel_mounts.d.ts

@@ -1,16 +1,17 @@
-import type { MountBackend } from '@struktoai/mirage-core/types';
+import { MountBackend } from '@struktoai/mirage-core/types';
 import type { Workspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
 /**
- * The workspace's real mountpoints, one {@link FuseManager} per subtree.
+ * The workspace's real mountpoints, one manager per subtree.
  *
- * A `vfs` mount lives only inside mirage; a `fuse` or `fskit` mount also
- * registers a mountpoint with the kernel. This owns the set of those:
+ * A `workspace` mount lives only inside mirage; a `fuse`, `fskit` or `nfs`
+ * mount also registers a mountpoint with the kernel, through a
+ * {@link FuseManager} or, for `nfs`, an {@link NFSManager}. This owns the set of those:
  * which prefix is exposed where, and the manager serving it. Keys are
  * `prefix` or `prefix@sessionId`, so the same subtree can be exposed
  * both unbound and bound to a session.
  *
  * Twin of python's `workspace/workspace/kernel_mounts.py`. Python takes
- * `(ops, sessions)` because its FuseManager mounts the ops facade; the
+ * `(files, sessions)` because its FuseManager mounts `ws.vfs`; the
  * node one mounts the workspace itself, so that is what is held here.
  */
 export declare class KernelMounts {
@@ -28,7 +29,7 @@ export declare class KernelMounts {
      * @param prefix the virtual prefix to expose
      * @param mountpoint where to mount; undefined picks a path
      * @param sessionId session whose grants scope the ops
-     * @param backend fuse or fskit
+     * @param backend fuse, fskit or nfs
      */
     add(prefix: string, mountpoint?: string, sessionId?: string, backend?: MountBackend): Promise<string>;
     /**

package/dist/workspace/workspace/kernel_mounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel_mounts.d.ts","sourceRoot":"","sources":["../../../src/workspace/workspace/kernel_mounts.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAGrF;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAE9C,SAAS,EAAE,SAAS;IAIhC;;;;;;;;;;;OAWG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IA0BlB;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,+DAA+D;IAC/D,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAM9B;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExC;IAED,OAAO,CAAC,QAAQ;CAUjB"}
+{"version":3,"file":"kernel_mounts.d.ts","sourceRoot":"","sources":["../../../src/workspace/workspace/kernel_mounts.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAIrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;gBAE3D,SAAS,EAAE,SAAS;IAIhC;;;;;;;;;;;OAWG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IAoClB;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,+DAA+D;IAC/D,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAM9B;IAED,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExC;IAED,OAAO,CAAC,QAAQ;CAUjB"}

package/dist/workspace/workspace/kernel_mounts.js

@@ -11,18 +11,21 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 // ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { MountBackend } from '@struktoai/mirage-core/types';
 import { FuseManager } from "../fuse.js";
+import { NFSManager } from "../nfs.js";
 /**
- * The workspace's real mountpoints, one {@link FuseManager} per subtree.
+ * The workspace's real mountpoints, one manager per subtree.
  *
- * A `vfs` mount lives only inside mirage; a `fuse` or `fskit` mount also
- * registers a mountpoint with the kernel. This owns the set of those:
+ * A `workspace` mount lives only inside mirage; a `fuse`, `fskit` or `nfs`
+ * mount also registers a mountpoint with the kernel, through a
+ * {@link FuseManager} or, for `nfs`, an {@link NFSManager}. This owns the set of those:
  * which prefix is exposed where, and the manager serving it. Keys are
  * `prefix` or `prefix@sessionId`, so the same subtree can be exposed
  * both unbound and bound to a session.
  *
  * Twin of python's `workspace/workspace/kernel_mounts.py`. Python takes
- * `(ops, sessions)` because its FuseManager mounts the ops facade; the
+ * `(files, sessions)` because its FuseManager mounts `ws.vfs`; the
  * node one mounts the workspace itself, so that is what is held here.
  */
 export class KernelMounts {
@@ -42,7 +45,7 @@ export class KernelMounts {
      * @param prefix the virtual prefix to expose
      * @param mountpoint where to mount; undefined picks a path
      * @param sessionId session whose grants scope the ops
-     * @param backend fuse or fskit
+     * @param backend fuse, fskit or nfs
      */
     async add(prefix, mountpoint, sessionId, backend) {
         const session = sessionId !== undefined ? this.workspace.getSession(sessionId) : undefined;
@@ -51,15 +54,26 @@ export class KernelMounts {
         // without leaving a partial mount.
         if (mountpoint !== undefined)
             this.register(key, mountpoint);
-        const manager = new FuseManager();
-        this.managers.set(key, manager);
+        const options = {
+            rootPrefix: prefix,
+            ...(mountpoint !== undefined ? { mountpoint } : {}),
+            ...(session !== undefined ? { session } : {}),
+        };
         try {
-            const resolved = await manager.setup(this.workspace, {
-                rootPrefix: prefix,
-                ...(mountpoint !== undefined ? { mountpoint } : {}),
-                ...(session !== undefined ? { session } : {}),
-                ...(backend !== undefined ? { backend } : {}),
-            });
+            let resolved;
+            if (backend === MountBackend.NFS) {
+                const manager = new NFSManager();
+                this.managers.set(key, manager);
+                resolved = await manager.setup(this.workspace, options);
+            }
+            else {
+                const manager = new FuseManager();
+                this.managers.set(key, manager);
+                resolved = await manager.setup(this.workspace, {
+                    ...options,
+                    ...(backend !== undefined ? { backend } : {}),
+                });
+            }
             if (mountpoint === undefined)
                 this.register(key, resolved);
             return resolved;
@@ -81,9 +95,12 @@ export class KernelMounts {
     async remove(prefix, sessionId) {
         const key = sessionId === undefined ? prefix : `${prefix}@${sessionId}`;
         const manager = this.managers.get(key);
-        this.managers.delete(key);
-        if (manager !== undefined)
+        if (manager !== undefined) {
             await manager.unmount();
+            if (this.managers.get(key) !== manager)
+                return;
+        }
+        this.managers.delete(key);
         this.mountpointsMap.delete(key);
     }
     /** Unmount everything this workspace exposed. */

package/dist/workspace/workspace/kernel_mounts.js.map

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

package/dist/workspace.d.ts

@@ -1,20 +1,21 @@
-import type { ProvisionResult } from '@struktoai/mirage-core/provision/types';
 import { MountBackend } from '@struktoai/mirage-core/types';
+import type { ShellExecution } from '@struktoai/mirage-core/workspace/shell_execution';
 import { Workspace as CoreWorkspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
 import type { ExecuteOptions, ExecuteResult, MountSpec, WorkspaceOptions } from '@struktoai/mirage-core/workspace/workspace/workspace';
-import { Mount } from '@struktoai/mirage-core/workspace/mount/spec';
 import type { MountSnapshot } from '@struktoai/mirage-core/workspace/snapshot/types';
-import type { Resource } from '@struktoai/mirage-core/resource/base';
+import type { BaseVFS } from '@struktoai/mirage-core/vfs/base';
+import './commands/builtin/utils/http.ts';
 import './compression_codecs.ts';
-import './runtime/sandbox/daytona/runtime.ts';
+import './io/spool.ts';
+import './mount/sftp.ts';
 import './secrets/constants.ts';
 export type NodeWorkspaceOptions = WorkspaceOptions;
 export declare class Workspace extends CoreWorkspace {
-    /** A saved mount rebuilds through this package's resource registry. */
-    protected static buildSavedResource(entry: MountSnapshot): Promise<Resource | null>;
+    /** A saved mount rebuilds through this package's VFS registry. */
+    protected static buildSavedVfs(entry: MountSnapshot): Promise<BaseVFS | null>;
     private fuseSetupPromise;
     private readonly kernelMounts;
-    constructor(resources: Record<string, MountSpec | Mount>, options?: NodeWorkspaceOptions);
+    constructor(mounts: Record<string, MountSpec>, options?: NodeWorkspaceOptions);
     /**
      * Mount a workspace subtree under FUSE and own its lifecycle. Each mount gets
      * its own FuseManager, so a workspace can expose any number of FUSE subtrees
@@ -32,13 +33,14 @@ export declare class Workspace extends CoreWorkspace {
     get fuseMountpoint(): string | null;
     /** Await the eager per-mount fuse mounts started in the constructor. */
     fuseReady(): Promise<void>;
-    execute(command: string, options?: ExecuteOptions & {
-        provision?: false | undefined;
+    shell(command: string, options: ExecuteOptions & {
+        stream: true;
+    }): Promise<ShellExecution>;
+    shell(command: string, options?: ExecuteOptions & {
+        stream?: false;
     }): Promise<ExecuteResult>;
-    execute(command: string, options: ExecuteOptions & {
-        provision: true;
-    }): Promise<ProvisionResult>;
-    execute(command: string, options: ExecuteOptions): Promise<ExecuteResult | ProvisionResult>;
+    shell(command: string, options: ExecuteOptions): Promise<ExecuteResult | ShellExecution>;
     close(): Promise<void>;
+    delete(): Promise<void>;
 }
 //# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAG7E,OAAO,EAAmB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE5E,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,sDAAsD,CAAA;AACjG,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EACjB,MAAM,sDAAsD,CAAA;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,6CAA6C,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAA;AAEpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,yBAAyB,CAAA;AAChC,OAAO,sCAAsC,CAAA;AAC7C,OAAO,wBAAwB,CAAA;AAiB/B,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAA;AAEnD,qBAAa,SAAU,SAAQ,aAAa;IAC1C,uEAAuE;qBACvC,kBAAkB,CAChD,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAK3B,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC,EAAE,OAAO,GAAE,oBAAyB;IAiD5F;;;;;;;;;;OAUG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IAIlB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5C;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,wEAAwE;IAClE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,OAAO,CACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,SAAS,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;KAAE,GAC3D,OAAO,CAAC,aAAa,CAAC;IAChB,OAAO,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GAAG;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,GAC5C,OAAO,CAAC,eAAe,CAAC;IAClB,OAAO,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,GAAG,eAAe,CAAC;IAS5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtC"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAmB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAA;AACtF,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,sDAAsD,CAAA;AACjG,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,SAAS,EACT,gBAAgB,EACjB,MAAM,sDAAsD,CAAA;AAI7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAA;AAEpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,kCAAkC,CAAA;AACzC,OAAO,yBAAyB,CAAA;AAChC,OAAO,eAAe,CAAA;AACtB,OAAO,iBAAiB,CAAA;AACxB,OAAO,wBAAwB,CAAA;AAiB/B,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAA;AAEnD,qBAAa,SAAU,SAAQ,aAAa;IAC1C,kEAAkE;qBAClC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK5F,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAE,oBAAyB;IA2CjF;;;;;;;;;;OAUG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC;IAIlB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,IAAI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5C;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,wEAAwE;IAClE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,KAAK,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,GACzC,OAAO,CAAC,cAAc,CAAC;IACjB,KAAK,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,GAC5C,OAAO,CAAC,aAAa,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,cAAc,CAAC;IASlF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/workspace.js

@@ -18,10 +18,12 @@ import { KERNEL_BACKENDS, MountBackend } from '@struktoai/mirage-core/types';
 import { Workspace as CoreWorkspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
 import { KernelMounts } from "./workspace/workspace/kernel_mounts.js";
 import { Mount } from '@struktoai/mirage-core/workspace/mount/spec';
-import { savedResourceBuild } from '@struktoai/mirage-core/workspace/snapshot/state';
-import { buildResource, knownResources } from "./resource/registry.js";
+import { savedVfsBuild } from '@struktoai/mirage-core/workspace/snapshot/state';
+import { buildVfs, knownVfsNames } from "./vfs/registry.js";
+import "./commands/builtin/utils/http.js";
 import "./compression_codecs.js";
-import "./runtime/sandbox/daytona/runtime.js";
+import "./io/spool.js";
+import "./mount/sftp.js";
 import "./secrets/constants.js";
 const requireCjs = createRequire(import.meta.url);
 let cachedParser = null;
@@ -37,36 +39,30 @@ function loadShellParser() {
     return cachedParser;
 }
 export class Workspace extends CoreWorkspace {
-    /** A saved mount rebuilds through this package's resource registry. */
-    static async buildSavedResource(entry) {
-        const build = savedResourceBuild(entry, (name) => knownResources().includes(name));
-        return build === null ? null : buildResource(build.name, build.config);
+    /** A saved mount rebuilds through this package's VFS registry. */
+    static async buildSavedVfs(entry) {
+        const build = savedVfsBuild(entry, (name) => knownVfsNames().includes(name));
+        return build === null ? null : buildVfs(build.name, build.config);
     }
     fuseSetupPromise = null;
     kernelMounts = new KernelMounts(this);
-    constructor(resources, options = {}) {
-        const specs = {};
-        const commandLimits = {
-            ...(options.commandLimits ?? {}),
-        };
+    constructor(mounts, options = {}) {
+        // Core takes a `Mount` directly now, so this unwrap is down to the one
+        // fact core has no use for: which mounts also want a real mountpoint.
+        // It used to re-spell the mount as [vfs, mode] and lift commandLimits
+        // by hand, which is how a `Mount`'s read policy would have been lost
+        // before reaching the workspace.
         const mountTargets = [];
-        for (const [prefix, value] of Object.entries(resources)) {
-            if (value instanceof Mount) {
-                specs[prefix] =
-                    value.options.mode !== undefined ? [value.resource, value.options.mode] : value.resource;
-                if (value.options.commandLimits !== undefined)
-                    commandLimits[prefix] = value.options.commandLimits;
-                const backend = value.options.backend ?? MountBackend.VFS;
-                if (KERNEL_BACKENDS.includes(backend))
-                    mountTargets.push([prefix, backend, value.options.mountpoint]);
-            }
-            else {
-                specs[prefix] = value;
+        for (const [prefix, value] of Object.entries(mounts)) {
+            if (!(value instanceof Mount))
+                continue;
+            const backend = value.options.backend ?? MountBackend.WORKSPACE;
+            if (KERNEL_BACKENDS.includes(backend)) {
+                mountTargets.push([prefix, backend, value.options.mountpoint]);
             }
         }
-        super(specs, {
+        super(mounts, {
             ...options,
-            ...(Object.keys(commandLimits).length > 0 ? { commandLimits } : {}),
             shellParserFactory: options.shellParserFactory ?? loadShellParser,
         });
         if (mountTargets.length > 0) {
@@ -114,14 +110,21 @@ export class Workspace extends CoreWorkspace {
             this.fuseSetupPromise = null;
         }
     }
-    async execute(command, options = {}) {
+    async shell(command, options = {}) {
         await this.fuseReady();
-        return super.execute(command, options);
+        return super.shell(command, options);
     }
     async close() {
-        await this.fuseReady().catch(() => undefined);
+        await this.fuseReady();
         await this.kernelMounts.close();
         await super.close();
     }
+    // The kernel mounts come down first here too: the core teardown never
+    // reaches them, and a mount left up serves a workspace already closed.
+    async delete() {
+        await this.fuseReady();
+        await this.kernelMounts.close();
+        await super.delete();
+    }
 }
 //# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@struktoai/mirage-node",
-  "version": "0.0.7-alpha.2",
+  "version": "0.0.7-alpha.3",
   "description": "A Unified Virtual Filesystem For AI Agents",
   "keywords": [
     "bash",
     "fuse",
     "typescript",
-    "vfs",
+    "workspace",
     "ai-agents",
     "agent-sandbox",
     "langchain",
@@ -32,7 +32,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=20.18.1 <21 || >=22"
+    "node": "^22.20 || ^24.12 || >=25"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -48,22 +48,23 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES"
   ],
   "dependencies": {
     "@aws-sdk/client-secrets-manager": "^3.1121.0",
-    "@napi-rs/lzma": "^1.4.5",
+    "@napi-rs/lzma": "^1.5.1",
     "dotenv": "^16.6.1",
     "fast-xml-parser": "^5.9.0",
     "fast-xml-validator": "^1.4.0",
-    "fs-monkey": "^1.1.0",
     "http-proxy-agent": "^7.0.2",
     "https-proxy-agent": "^7.0.6",
-    "seek-bzip": "^2.0.0",
     "tree-sitter-bash": "^0.25.1",
+    "unbzip2-stream": "^1.4.3",
+    "undici": "^7.30.0",
     "web-tree-sitter": "^0.26.13",
     "yaml": "^2.6.0",
-    "@struktoai/mirage-core": "0.0.7-alpha.2"
+    "@struktoai/mirage-core": "0.0.7-alpha.3"
   },
   "peerDependencies": {
     "@1password/sdk": "^0.5.0",
@@ -74,7 +75,7 @@
     "imapflow": "^1.0.0",
     "mailparser": "^3.6.0",
     "mongodb": "^6.10.0",
-    "nodemailer": "^9.0.1",
+    "nodemailer": "^10.0.2",
     "opendal": "^0.49.4",
     "pg": "^8.13.0",
     "redis": "^5.0.0",
@@ -123,7 +124,7 @@
   },
   "devDependencies": {
     "@1password/sdk": "^0.5.0",
-    "@aws-sdk/client-s3": "^3.0.0",
+    "@aws-sdk/client-s3": "^3.1116.0",
     "@daytonaio/sdk": "^0.207.0",
     "@lancedb/lancedb": "^0.30.0",
     "@types/mailparser": "^3.4.6",
@@ -135,13 +136,13 @@
     "imapflow": "^1.3.2",
     "mailparser": "^3.9.8",
     "mongodb": "^6.10.0",
-    "nodemailer": "^9.0.1",
+    "nodemailer": "^10.0.2",
     "opendal": "^0.49.4",
     "pg": "^8.13.0",
     "redis": "^5.0.0",
     "ssh2": "^1.16.0",
     "typescript": "^6.0.0",
-    "vitest": "^3.2.6"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",

package/dist/accessor/hf.d.ts

@@ -1,38 +0,0 @@
-import type { Operator } from 'opendal';
-import { Accessor } from '@struktoai/mirage-core/accessor/index';
-import { ResourceName } from '@struktoai/mirage-core/types';
-import type { HfBucketsConfig, HfRepoConfig } from '../resource/hf_buckets/config.ts';
-export declare const HF_RESOURCES: readonly ["hf_buckets", "hf_datasets", "hf_models", "hf_spaces"];
-export declare abstract class HfAccessor extends Accessor {
-    readonly config: HfBucketsConfig | HfRepoConfig;
-    abstract readonly repoType: string;
-    abstract readonly resourceName: ResourceName;
-    private operatorPromise;
-    constructor(config: HfBucketsConfig | HfRepoConfig);
-    get repoId(): string;
-    abstract get bucketUri(): string;
-    operatorOptions(): Record<string, string>;
-    operator(): Promise<Operator>;
-    private createOperator;
-}
-export declare class HfBucketsAccessor extends HfAccessor {
-    readonly repoType: string;
-    readonly resourceName: ResourceName;
-    get bucketUri(): string;
-}
-export declare class HfDatasetsAccessor extends HfAccessor {
-    readonly repoType: string;
-    readonly resourceName: ResourceName;
-    get bucketUri(): string;
-}
-export declare class HfModelsAccessor extends HfAccessor {
-    readonly repoType: string;
-    readonly resourceName: ResourceName;
-    get bucketUri(): string;
-}
-export declare class HfSpacesAccessor extends HfAccessor {
-    readonly repoType: string;
-    readonly resourceName: ResourceName;
-    get bucketUri(): string;
-}
-//# sourceMappingURL=hf.d.ts.map

package/dist/accessor/hf.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hf.d.ts","sourceRoot":"","sources":["../../src/accessor/hf.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAErF,eAAO,MAAM,YAAY,kEAKf,CAAA;AAEV,8BAAsB,UAAW,SAAQ,QAAQ;aAKnB,MAAM,EAAE,eAAe,GAAG,YAAY;IAJlE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IAC5C,OAAO,CAAC,eAAe,CAAiC;gBAE5B,MAAM,EAAE,eAAe,GAAG,YAAY;IAIlE,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAA;IAEhC,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBzC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;YAKf,cAAc;CAO7B;AAUD,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAW;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAA0B;IAE7D,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAY;IACrC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAA2B;IAE9D,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAU;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAyB;IAE5D,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAU;IACnC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAyB;IAE5D,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}