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

package/dist/vfs/wasabi/config.js

@@ -0,0 +1,60 @@
+// ========= 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 { parseConfigWithSchema, redactConfigWithSchema, secretStr, z, } from '@struktoai/mirage-core/vfs/secrets';
+import { S3_FAMILY_NORMALIZER } from "../s3/config.js";
+const WasabiConfigSchema = z.object({
+    bucket: z.string(),
+    accessKeyId: secretStr().optional(),
+    secretAccessKey: secretStr().optional(),
+    sessionToken: secretStr().optional(),
+    profile: z.string().optional(),
+    region: z.string().optional(),
+    endpoint: z.string().optional(),
+    forcePathStyle: z.boolean().optional(),
+    keyPrefix: z.string().optional(),
+    timeoutMs: z.number().optional(),
+    proxy: secretStr().optional(),
+});
+export function resolvedWasabiEndpoint(config) {
+    if (config.endpoint !== undefined && config.endpoint !== '')
+        return config.endpoint;
+    const region = config.region ?? 'us-east-1';
+    return region === 'us-east-1' ? 'https://s3.wasabisys.com' : `https://s3.${region}.wasabisys.com`;
+}
+export function wasabiToS3Config(config) {
+    return {
+        bucket: config.bucket,
+        region: config.region ?? 'us-east-1',
+        endpoint: resolvedWasabiEndpoint(config),
+        ...(config.accessKeyId !== undefined ? { accessKeyId: config.accessKeyId } : {}),
+        ...(config.secretAccessKey !== undefined ? { secretAccessKey: config.secretAccessKey } : {}),
+        ...(config.sessionToken !== undefined ? { sessionToken: config.sessionToken } : {}),
+        ...(config.profile !== undefined ? { profile: config.profile } : {}),
+        ...(config.forcePathStyle !== undefined ? { forcePathStyle: config.forcePathStyle } : {}),
+        ...(config.keyPrefix !== undefined ? { keyPrefix: config.keyPrefix } : {}),
+        ...(config.timeoutMs !== undefined ? { timeoutMs: config.timeoutMs } : {}),
+        ...(config.proxy !== undefined ? { proxy: config.proxy } : {}),
+    };
+}
+export function redactWasabiConfig(config) {
+    return redactConfigWithSchema(WasabiConfigSchema, {
+        ...config,
+        region: config.region ?? 'us-east-1',
+        endpoint: resolvedWasabiEndpoint(config),
+    });
+}
+export function normalizeWasabiConfig(input) {
+    return parseConfigWithSchema(WasabiConfigSchema, input, S3_FAMILY_NORMALIZER);
+}
+//# sourceMappingURL=config.js.map

package/dist/vfs/wasabi/config.js.map

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

package/dist/vfs/wasabi/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const PROMPT = "{prefix}\n  Remote Wasabi bucket (S3-compatible).\n  IMPORTANT: This is a remote mount. Prefer targeted reads over full scans.\n  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vfs/wasabi/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/vfs/wasabi/prompt.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,MAAM,yMAIkD,CAAA"}

package/dist/vfs/wasabi/prompt.js

@@ -0,0 +1,19 @@
+// ========= 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. =========
+export const PROMPT = `\
+{prefix}
+  Remote Wasabi bucket (S3-compatible).
+  IMPORTANT: This is a remote mount. Prefer targeted reads over full scans.
+  Supports: ls, cat, head, tail, grep, rg, wc, find, tree, jq, stat.`;
+//# sourceMappingURL=prompt.js.map

package/dist/vfs/wasabi/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/vfs/wasabi/prompt.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,MAAM,GAAG;;;;qEAI+C,CAAA"}

package/dist/vfs/wasabi/wasabi.d.ts

@@ -0,0 +1,8 @@
+import { S3AliasVFS, type S3AliasVFSState } from '../s3_alias.ts';
+import { type WasabiConfig, type WasabiConfigRedacted } from './config.ts';
+export type WasabiVFSState = S3AliasVFSState<WasabiConfigRedacted>;
+export declare class WasabiVFS extends S3AliasVFS<WasabiConfig, WasabiConfigRedacted> {
+    readonly prompt: string;
+    constructor(config: WasabiConfig);
+}
+//# sourceMappingURL=wasabi.d.ts.map

package/dist/vfs/wasabi/wasabi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasabi.d.ts","sourceRoot":"","sources":["../../../src/vfs/wasabi/wasabi.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAE1B,MAAM,aAAa,CAAA;AAGpB,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,oBAAoB,CAAC,CAAA;AAElE,qBAAa,SAAU,SAAQ,UAAU,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC3E,SAAkB,MAAM,EAAE,MAAM,CAAS;gBAE7B,MAAM,EAAE,YAAY;CAGjC"}

package/dist/vfs/wasabi/wasabi.js

@@ -0,0 +1,24 @@
+// ========= 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 { VFSName } from '@struktoai/mirage-core/types';
+import { S3AliasVFS } from "../s3_alias.js";
+import { redactWasabiConfig, wasabiToS3Config, } from "./config.js";
+import { PROMPT } from "./prompt.js";
+export class WasabiVFS extends S3AliasVFS {
+    prompt = PROMPT;
+    constructor(config) {
+        super(VFSName.WASABI, config, wasabiToS3Config(config), redactWasabiConfig);
+    }
+}
+//# sourceMappingURL=wasabi.js.map

package/dist/vfs/wasabi/wasabi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasabi.js","sourceRoot":"","sources":["../../../src/vfs/wasabi/wasabi.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,OAAO,EAAE,MAAM,8BAA8B,CAAA;AACtD,OAAO,EAAE,UAAU,EAAwB,MAAM,gBAAgB,CAAA;AACjE,OAAO,EACL,kBAAkB,EAGlB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIpC,MAAM,OAAO,SAAU,SAAQ,UAA8C;IACzD,MAAM,GAAW,MAAM,CAAA;IAEzC,YAAY,MAAoB;QAC9B,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAA;IAC7E,CAAC;CACF"}

package/dist/workspace/fuse.d.ts

@@ -1,5 +1,32 @@
 import type { Workspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
 import { type MountOptions } from '../fuse/mount.ts';
+export interface CleanupEntry {
+    mountpoint: string;
+    ownsMountpoint: boolean;
+    release?: (mountpoint: string) => void;
+}
+export declare function removeMountpointIfOwned(entry: {
+    mountpoint: string;
+    ownsMountpoint: boolean;
+}): void;
+/**
+ * Tracks auto-mounted FUSE handles and installs a single process-wide cleanup
+ * path on SIGINT / SIGTERM / SIGHUP / `process.exit` so the kernel never ends
+ * up with a stale mountpoint after the node process dies. Mirrors Python's
+ * KeyboardInterrupt → `diskutil unmount force` / `fusermount -u` in mount.py.
+ */
+declare class FuseCleanupRegistry {
+    private readonly mounts;
+    private installed;
+    private exiting;
+    register(entry: CleanupEntry): void;
+    unregister(entry: CleanupEntry): void;
+    private install;
+    private readonly onSignal;
+    private readonly onExit;
+    private drainSync;
+}
+export declare const CLEANUP: FuseCleanupRegistry;
 export declare class FuseManager {
     private handle;
     private cleanupEntry;
@@ -8,4 +35,5 @@ export declare class FuseManager {
     unmount(): Promise<void>;
     close(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=fuse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fuse.d.ts","sourceRoot":"","sources":["../../src/workspace/fuse.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AACrF,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAiF1F,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAEK,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAejE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"fuse.d.ts","sourceRoot":"","sources":["../../src/workspace/fuse.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AACrF,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAI1F,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAElB,cAAc,EAAE,OAAO,CAAA;IAEvB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;CACxB,GAAG,IAAI,CAWP;AAED;;;;;GAKG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAQ;IAEvB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKnC,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIrC,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOxB;IAED,OAAO,CAAC,QAAQ,CAAC,MAAM,CAItB;IAED,OAAO,CAAC,SAAS;CAQlB;AAED,eAAO,MAAM,OAAO,qBAA4B,CAAA;AAKhD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAEK,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/workspace/fuse.js

@@ -14,7 +14,7 @@
 import { rmdirSync } from 'node:fs';
 import { forceUnmount, mount } from "../fuse/mount.js";
 const SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'];
-function removeMountpointIfOwned(entry) {
+export function removeMountpointIfOwned(entry) {
     if (!entry.ownsMountpoint)
         return;
     try {
@@ -22,8 +22,10 @@ function removeMountpointIfOwned(entry) {
         // still-mounted FUSE path can make deletes hit the mounted backend.
         rmdirSync(entry.mountpoint);
     }
-    catch {
-        // mountpoint may still be busy, non-empty, or already gone; caller can retry
+    catch (err) {
+        // The mountpoint may still be busy, non-empty, or already gone; the
+        // caller can retry.
+        console.debug(`fuse: removing mountpoint ${entry.mountpoint} failed: ${String(err)}`);
     }
 }
 /**
@@ -70,13 +72,14 @@ class FuseCleanupRegistry {
     };
     drainSync() {
         for (const entry of this.mounts) {
-            forceUnmount(entry.mountpoint);
+            const release = entry.release ?? forceUnmount;
+            release(entry.mountpoint);
             removeMountpointIfOwned(entry);
         }
         this.mounts.clear();
     }
 }
-const CLEANUP = new FuseCleanupRegistry();
+export const CLEANUP = new FuseCleanupRegistry();
 // Passive mounting primitive: it mounts a workspace subtree and tears it down.
 // Registry/lifecycle ownership lives on the node Workspace (addFuseMount /
 // removeFuseMount), mirroring Python's FuseManager.
@@ -93,7 +96,6 @@ export class FuseManager {
         this.handle = handle;
         this.cleanupEntry = {
             mountpoint: handle.mountpoint,
-            handle,
             // Preserve the ownership decision made by mount(); unmount cleanup must
             // not infer ownership from path shape or whether the directory exists.
             ownsMountpoint: handle.ownsMountpoint,
@@ -106,21 +108,17 @@ export class FuseManager {
             return;
         }
         const mp = this.handle.mountpoint;
-        try {
-            await this.handle.unmount();
-        }
-        finally {
-            const cleanupEntry = this.cleanupEntry;
-            if (cleanupEntry !== null) {
-                CLEANUP.unregister(cleanupEntry);
-                this.cleanupEntry = null;
-            }
-            this.handle = null;
-            removeMountpointIfOwned({
-                mountpoint: mp,
-                ownsMountpoint: cleanupEntry?.ownsMountpoint ?? false,
-            });
+        await this.handle.unmount();
+        const cleanupEntry = this.cleanupEntry;
+        if (cleanupEntry !== null) {
+            CLEANUP.unregister(cleanupEntry);
+            this.cleanupEntry = null;
         }
+        this.handle = null;
+        removeMountpointIfOwned({
+            mountpoint: mp,
+            ownsMountpoint: cleanupEntry?.ownsMountpoint ?? false,
+        });
     }
     async close() {
         await this.unmount();

package/dist/workspace/fuse.js.map

@@ -1 +1 @@
-{"version":3,"file":"fuse.js","sourceRoot":"","sources":["../../src/workspace/fuse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fuse.js","sourceRoot":"","sources":["../../src/workspace/fuse.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,SAAS,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAsC,MAAM,kBAAkB,CAAA;AAE1F,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA;AAUxD,MAAM,UAAU,uBAAuB,CAAC,KAGvC;IACC,IAAI,CAAC,KAAK,CAAC,cAAc;QAAE,OAAM;IACjC,IAAI,CAAC;QACH,sEAAsE;QACtE,oEAAoE;QACpE,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,oBAAoB;QACpB,OAAO,CAAC,KAAK,CAAC,6BAA6B,KAAK,CAAC,UAAU,YAAY,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACvF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,mBAAmB;IACN,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAA;IACzC,SAAS,GAAG,KAAK,CAAA;IACjB,OAAO,GAAG,KAAK,CAAA;IAEvB,QAAQ,CAAC,KAAmB;QAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACtB,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAED,UAAU,CAAC,KAAmB;QAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACrC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IAEgB,QAAQ,GAAG,CAAC,GAAW,EAAQ,EAAE;QAChD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,SAAS,EAAE,CAAA;QAChB,yEAAyE;QACzE,sEAAsE;QACtE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAChC,CAAC,CAAA;IAEgB,MAAM,GAAG,GAAS,EAAE;QACnC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QACxB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,SAAS,EAAE,CAAA;IAClB,CAAC,CAAA;IAEO,SAAS;QACf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,YAAY,CAAA;YAC7C,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;YACzB,uBAAuB,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,mBAAmB,EAAE,CAAA;AAEhD,+EAA+E;AAC/E,2EAA2E;AAC3E,oDAAoD;AACpD,MAAM,OAAO,WAAW;IACd,MAAM,GAAsB,IAAI,CAAA;IAChC,YAAY,GAAwB,IAAI,CAAA;IAEhD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EAAa,EAAE,UAAwB,EAAE;QACnD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAA;QACvD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,YAAY,GAAG;YAClB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,wEAAwE;YACxE,uEAAuE;YACvE,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAA;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACnC,OAAO,MAAM,CAAC,UAAU,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,OAAM;QACR,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAA;QACjC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;QACtC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;QAC1B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,uBAAuB,CAAC;YACtB,UAAU,EAAE,EAAE;YACd,cAAc,EAAE,YAAY,EAAE,cAAc,IAAI,KAAK;SACtD,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/workspace/mount/namespace/disk.d.ts

@@ -0,0 +1,26 @@
+import { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import type { NodeFields } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+/**
+ * NamespaceStore backed by one `namespace.json` per workspace.
+ *
+ * The whole plane is one human-readable record
+ * `{"nodes": {path: fields}}`: the namespace is bound to
+ * the workspace, so it serializes as one JSON file, not per-node
+ * files. Read-modify-writes take the record's lockfile so concurrent
+ * local processes never lose a node upsert; the write itself stays
+ * tmp-then-rename atomic, so readers never see a torn file. Mirrors
+ * the Python DiskNamespaceStore byte-for-byte on disk.
+ */
+export declare class DiskNamespaceStore extends NamespaceStore {
+    private readonly records;
+    constructor(root: string);
+    private state;
+    private write;
+    load(): Promise<Map<string, NodeFields>>;
+    set(path: string, fields: NodeFields): Promise<void>;
+    delete(paths: readonly string[]): Promise<void>;
+    replaceAll(entries: Map<string, NodeFields>): Promise<void>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=disk.d.ts.map

package/dist/workspace/mount/namespace/disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../../src/workspace/mount/namespace/disk.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAA;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAA;AASxF;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,IAAI,EAAE,MAAM;YAKV,KAAK;YAML,KAAK;IAIb,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAIxC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/workspace/mount/namespace/disk.js

@@ -0,0 +1,93 @@
+// ========= 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 { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import { DiskRecordClient } from "../../record/disk.js";
+const NAMESPACE_RECORD = 'namespace';
+/**
+ * NamespaceStore backed by one `namespace.json` per workspace.
+ *
+ * The whole plane is one human-readable record
+ * `{"nodes": {path: fields}}`: the namespace is bound to
+ * the workspace, so it serializes as one JSON file, not per-node
+ * files. Read-modify-writes take the record's lockfile so concurrent
+ * local processes never lose a node upsert; the write itself stays
+ * tmp-then-rename atomic, so readers never see a torn file. Mirrors
+ * the Python DiskNamespaceStore byte-for-byte on disk.
+ */
+export class DiskNamespaceStore extends NamespaceStore {
+    records;
+    constructor(root) {
+        super();
+        this.records = new DiskRecordClient(root, '');
+    }
+    async state() {
+        const [fields] = await this.records.get(NAMESPACE_RECORD);
+        if (fields === null)
+            return { nodes: {} };
+        return { nodes: fields.nodes ?? {} };
+    }
+    async write(state) {
+        await this.records.put(NAMESPACE_RECORD, { nodes: state.nodes });
+    }
+    async load() {
+        return new Map(Object.entries((await this.state()).nodes));
+    }
+    async set(path, fields) {
+        const fh = await this.records.lock(NAMESPACE_RECORD);
+        try {
+            const state = await this.state();
+            state.nodes[path] = fields;
+            await this.write(state);
+        }
+        finally {
+            await this.records.unlock(NAMESPACE_RECORD, fh);
+        }
+    }
+    async delete(paths) {
+        const fh = await this.records.lock(NAMESPACE_RECORD);
+        try {
+            const state = await this.state();
+            const drop = new Set(paths);
+            state.nodes = Object.fromEntries(Object.entries(state.nodes).filter(([path]) => !drop.has(path)));
+            await this.write(state);
+        }
+        finally {
+            await this.records.unlock(NAMESPACE_RECORD, fh);
+        }
+    }
+    async replaceAll(entries) {
+        const fh = await this.records.lock(NAMESPACE_RECORD);
+        try {
+            const state = await this.state();
+            state.nodes = Object.fromEntries(entries);
+            await this.write(state);
+        }
+        finally {
+            await this.records.unlock(NAMESPACE_RECORD, fh);
+        }
+    }
+    async clear() {
+        const fh = await this.records.lock(NAMESPACE_RECORD);
+        try {
+            await this.write({ nodes: {} });
+        }
+        finally {
+            await this.records.unlock(NAMESPACE_RECORD, fh);
+        }
+    }
+    async close() {
+        await this.records.close();
+    }
+}
+//# sourceMappingURL=disk.js.map

package/dist/workspace/mount/namespace/disk.js.map

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

package/dist/workspace/mount/namespace/redis.d.ts

@@ -0,0 +1,27 @@
+import { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import type { NodeFields } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+export interface RedisNamespaceStoreOptions {
+    url?: string;
+    keyPrefix?: string;
+}
+/**
+ * NamespaceStore backed by one Redis hash (path -> JSON fields).
+ *
+ * Symlinks and attribute overlays survive process restarts and are visible
+ * to any workspace pointed at the same key prefix. Writes are
+ * single-command (HSET/HDEL) so mutations stay one round trip. Mirrors the
+ * Python RedisNamespaceStore.
+ */
+export declare class RedisNamespaceStore extends NamespaceStore {
+    readonly url: string;
+    private readonly key;
+    private readonly redis;
+    constructor(options?: RedisNamespaceStoreOptions);
+    load(): Promise<Map<string, NodeFields>>;
+    set(path: string, fields: NodeFields): Promise<void>;
+    delete(paths: readonly string[]): Promise<void>;
+    replaceAll(entries: Map<string, NodeFields>): Promise<void>;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/workspace/mount/namespace/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/workspace/mount/namespace/redis.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAA;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAA;AAGxF,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,OAAO,GAAE,0BAA+B;IAQ9C,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAUxC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/workspace/mount/namespace/redis.js

@@ -0,0 +1,70 @@
+// ========= 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 { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import { RedisConnection } from "../../../optional_peer.js";
+/**
+ * NamespaceStore backed by one Redis hash (path -> JSON fields).
+ *
+ * Symlinks and attribute overlays survive process restarts and are visible
+ * to any workspace pointed at the same key prefix. Writes are
+ * single-command (HSET/HDEL) so mutations stay one round trip. Mirrors the
+ * Python RedisNamespaceStore.
+ */
+export class RedisNamespaceStore extends NamespaceStore {
+    url;
+    key;
+    redis;
+    constructor(options = {}) {
+        super();
+        this.url = options.url ?? 'redis://localhost:6379/0';
+        const prefix = options.keyPrefix ?? 'mirage:namespace:';
+        this.key = `${prefix}nodes`;
+        this.redis = new RedisConnection(this.url, 'RedisNamespaceStore');
+    }
+    async load() {
+        const c = await this.redis.client();
+        const raw = await c.hGetAll(this.key);
+        const out = new Map();
+        for (const [path, value] of Object.entries(raw)) {
+            out.set(path, JSON.parse(value));
+        }
+        return out;
+    }
+    async set(path, fields) {
+        const c = await this.redis.client();
+        await c.hSet(this.key, path, JSON.stringify(fields));
+    }
+    async delete(paths) {
+        if (paths.length === 0)
+            return;
+        const c = await this.redis.client();
+        await c.hDel(this.key, [...paths]);
+    }
+    async replaceAll(entries) {
+        const c = await this.redis.client();
+        const multi = c.multi().del(this.key);
+        for (const [path, fields] of entries) {
+            multi.hSet(this.key, path, JSON.stringify(fields));
+        }
+        await multi.exec();
+    }
+    async clear() {
+        const c = await this.redis.client();
+        await c.del([this.key]);
+    }
+    async close() {
+        await this.redis.close();
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/workspace/mount/namespace/redis.js.map

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

package/dist/workspace/nfs.d.ts

@@ -0,0 +1,29 @@
+import type { SessionState } from '@struktoai/mirage-core/workspace/session/session';
+import type { Workspace } from '@struktoai/mirage-core/workspace/workspace/workspace';
+/**
+ * Mounts one workspace subtree through the operating system's own NFS
+ * client: a `MirageNFSServer` on this process's event loop, and the system
+ * `mount` pointed at it. As with a FUSE mount, never read the mountpoint
+ * synchronously from this process: the server answers on the same loop.
+ * Mirrors Python's NFSManager.
+ */
+export declare class NFSManager {
+    private server;
+    private entry;
+    private given;
+    get mountpoint(): string | null;
+    /** Serve the workspace's files over NFS, mount them, and return the live mountpoint. */
+    setup(ws: Workspace, options?: {
+        mountpoint?: string;
+        rootPrefix?: string;
+        session?: SessionState;
+    }): Promise<string>;
+    /** Unmount, then stop the server: the other order would leave the kernel waiting on a server that is gone. */
+    unmount(): Promise<void>;
+    /**
+     * The exit-time teardown: the server dies with this process, so only the
+     * forced unmount can still finish.
+     */
+    private static readonly release;
+}
+//# sourceMappingURL=nfs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nfs.d.ts","sourceRoot":"","sources":["../../src/workspace/nfs.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAA;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sDAAsD,CAAA;AAOrF;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAAsB;IAEnC,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAE9B;IAED,wFAAwF;IAClF,KAAK,CACT,EAAE,EAAE,SAAS,EACb,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAA;KAAO,GACjF,OAAO,CAAC,MAAM,CAAC;IAgClB,8GAA8G;IACxG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAO9B;CACF"}