@struktoai/mirage-node 0.0.5-alpha.1 → 0.0.6

package/dist/workspace/store/disk.d.ts

@@ -0,0 +1,46 @@
+import type { ObserverStore } from '@struktoai/mirage-core/observe/store';
+import type { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import type { SessionStore } from '@struktoai/mirage-core/workspace/session/store';
+import { WorkspaceStateStore } from '@struktoai/mirage-core/workspace/store/base';
+import type { WorkspaceFields, WorkspaceStateStoreOverrides } from '@struktoai/mirage-core/workspace/store/base';
+export declare const DEFAULT_STATE_ROOT = "~/.mirage/state";
+export interface DiskWorkspaceStateStoreOptions extends WorkspaceStateStoreOverrides {
+    root?: string;
+}
+/**
+ * WorkspaceStateStore backed by a directory tree.
+ *
+ * Each workspace is one self-contained directory (delete a workspace
+ * by removing its folder):
+ *
+ * - `{root}/workspaces/{ws}/workspace.json` — metadata record
+ * - `{root}/workspaces/{ws}/sessions/{sid}.json` — session table
+ * - `{root}/workspaces/{ws}/namespace.json` — nodes + user, one JSON
+ * - `{root}/workspaces/{ws}/history/<day>/<sid>.jsonl` — history
+ *
+ * The layout mirrors the S3 store file-for-object; mutable records get
+ * the same generation-CAS contract via the lockfile protocol
+ * (O_CREAT|O_EXCL mutex, tmp write, rename(2)), so multiple local
+ * processes share one workspace with zero infrastructure: a CLI-created
+ * workspace survives restart like `git init`. Local filesystems only;
+ * anything cross-machine belongs on redis or s3. Mirrors the Python
+ * DiskWorkspaceStateStore byte-for-byte on disk.
+ */
+export declare class DiskWorkspaceStateStore extends WorkspaceStateStore {
+    private readonly root;
+    private readonly meta;
+    private readonly namespaces;
+    private readonly observers;
+    private readonly sessionTables;
+    constructor(options?: DiskWorkspaceStateStoreOptions);
+    private wsRoot;
+    private metaClient;
+    protected makeNamespace(workspaceId: string): NamespaceStore;
+    protected makeObserver(workspaceId: string): ObserverStore;
+    protected makeSessions(workspaceId: string): SessionStore;
+    protected readMeta(workspaceId: string): Promise<WorkspaceFields | null>;
+    protected writeMeta(workspaceId: string, fields: WorkspaceFields): Promise<void>;
+    protected casWriteMeta(workspaceId: string, fields: WorkspaceFields, expectedGeneration: number): Promise<boolean>;
+    protected closeSelf(): Promise<void>;
+}
+//# sourceMappingURL=disk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/disk.ts"],"names":[],"mappings":"AAgBA,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,eAAO,MAAM,kBAAkB,oBAAoB,CAAA;AAgBnD,MAAM,WAAW,8BAA+B,SAAQ,4BAA4B;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;gBAExD,OAAO,GAAE,8BAAmC;IAMxD,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;IASlB,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAS5D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAS1D,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;cASzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAK9D,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAItE,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC;cAIH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAM3C"}

package/dist/workspace/store/disk.js

@@ -0,0 +1,119 @@
+// ========= 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 { homedir } from 'node:os';
+import path from 'node:path';
+import { WorkspaceStateStore } from '@struktoai/mirage-core/workspace/store/base';
+import { DiskObserverStore } from "../../observe/disk_store.js";
+import { DiskNamespaceStore } from "../namespace/disk.js";
+import { DiskRecordClient } from "../record/disk.js";
+import { DiskSessionStore } from "../session/disk.js";
+export const DEFAULT_STATE_ROOT = '~/.mirage/state';
+function expandHome(p) {
+    if (p === '~')
+        return homedir();
+    if (p.startsWith('~/'))
+        return path.join(homedir(), p.slice(2));
+    return p;
+}
+// Match Python's urllib quote(safe="") for the workspace path segment.
+function quoteSegment(name) {
+    return encodeURIComponent(name).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+/**
+ * WorkspaceStateStore backed by a directory tree.
+ *
+ * Each workspace is one self-contained directory (delete a workspace
+ * by removing its folder):
+ *
+ * - `{root}/workspaces/{ws}/workspace.json` — metadata record
+ * - `{root}/workspaces/{ws}/sessions/{sid}.json` — session table
+ * - `{root}/workspaces/{ws}/namespace.json` — nodes + user, one JSON
+ * - `{root}/workspaces/{ws}/history/<day>/<sid>.jsonl` — history
+ *
+ * The layout mirrors the S3 store file-for-object; mutable records get
+ * the same generation-CAS contract via the lockfile protocol
+ * (O_CREAT|O_EXCL mutex, tmp write, rename(2)), so multiple local
+ * processes share one workspace with zero infrastructure: a CLI-created
+ * workspace survives restart like `git init`. Local filesystems only;
+ * anything cross-machine belongs on redis or s3. Mirrors the Python
+ * DiskWorkspaceStateStore byte-for-byte on disk.
+ */
+export class DiskWorkspaceStateStore extends WorkspaceStateStore {
+    root;
+    meta = new Map();
+    namespaces = new Map();
+    observers = new Map();
+    sessionTables = new Map();
+    constructor(options = {}) {
+        const { root, ...overrides } = options;
+        super(overrides);
+        this.root = expandHome(root ?? DEFAULT_STATE_ROOT);
+    }
+    wsRoot(workspaceId) {
+        return path.join(this.root, 'workspaces', quoteSegment(workspaceId));
+    }
+    metaClient(workspaceId) {
+        let client = this.meta.get(workspaceId);
+        if (client === undefined) {
+            client = new DiskRecordClient(this.wsRoot(workspaceId), '');
+            this.meta.set(workspaceId, client);
+        }
+        return client;
+    }
+    makeNamespace(workspaceId) {
+        let ns = this.namespaces.get(workspaceId);
+        if (ns === undefined) {
+            ns = new DiskNamespaceStore(this.wsRoot(workspaceId));
+            this.namespaces.set(workspaceId, ns);
+        }
+        return ns;
+    }
+    makeObserver(workspaceId) {
+        let ob = this.observers.get(workspaceId);
+        if (ob === undefined) {
+            ob = new DiskObserverStore(path.join(this.wsRoot(workspaceId), 'history'));
+            this.observers.set(workspaceId, ob);
+        }
+        return ob;
+    }
+    makeSessions(workspaceId) {
+        let table = this.sessionTables.get(workspaceId);
+        if (table === undefined) {
+            table = new DiskSessionStore(this.wsRoot(workspaceId));
+            this.sessionTables.set(workspaceId, table);
+        }
+        return table;
+    }
+    async readMeta(workspaceId) {
+        const [fields] = await this.metaClient(workspaceId).get('workspace');
+        return fields;
+    }
+    async writeMeta(workspaceId, fields) {
+        await this.metaClient(workspaceId).put('workspace', fields);
+    }
+    async casWriteMeta(workspaceId, fields, expectedGeneration) {
+        return await this.metaClient(workspaceId).casPut('workspace', fields, expectedGeneration);
+    }
+    async closeSelf() {
+        for (const ns of this.namespaces.values())
+            await ns.close();
+        for (const ob of this.observers.values())
+            await ob.close();
+        for (const table of this.sessionTables.values())
+            await table.close();
+        for (const client of this.meta.values())
+            await client.close();
+    }
+}
+//# sourceMappingURL=disk.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { ObserverStore } from '@struktoai/mirage-core/observe/store';
+import type { NamespaceStore } from '@struktoai/mirage-core/workspace/mount/namespace/store';
+import type { SessionStore } from '@struktoai/mirage-core/workspace/session/store';
+import { WorkspaceStateStore } from '@struktoai/mirage-core/workspace/store/base';
+import type { WorkspaceFields, WorkspaceStateStoreOverrides } from '@struktoai/mirage-core/workspace/store/base';
+export interface RedisWorkspaceStateStoreOptions extends WorkspaceStateStoreOverrides {
+    url?: string;
+    keyPrefix?: string;
+}
+/**
+ * WorkspaceStateStore backed by one Redis server.
+ *
+ * Key layout under one prefix, everything scoped by workspace id:
+ *
+ * - `{prefix}workspaces` — hash, workspace id -> metadata JSON
+ * - `{prefix}{ws}:namespace:nodes` (+ `:user`) — namespace plane
+ * - `{prefix}{ws}:observer:*` — observer plane
+ * - `{prefix}{ws}:sessions` — session table
+ *
+ * All plane state survives restarts and is visible to every process
+ * pointed at the same url and prefix, so a workspace rebuilt from its
+ * config alone gets identical overlays, history, sessions, and grants.
+ * Mirrors the Python RedisWorkspaceStateStore.
+ */
+export declare class RedisWorkspaceStateStore extends WorkspaceStateStore {
+    readonly url: string;
+    private readonly prefix;
+    private readonly metaKey;
+    private clientPromise;
+    private readonly namespaces;
+    private readonly observers;
+    private readonly sessionTables;
+    constructor(options?: RedisWorkspaceStateStoreOptions);
+    private client;
+    protected makeNamespace(workspaceId: string): NamespaceStore;
+    protected makeObserver(workspaceId: string): ObserverStore;
+    protected makeSessions(workspaceId: string): SessionStore;
+    protected readMeta(workspaceId: string): Promise<WorkspaceFields | null>;
+    protected writeMeta(workspaceId: string, fields: WorkspaceFields): Promise<void>;
+    protected casWriteMeta(workspaceId: string, fields: WorkspaceFields, expectedGeneration: number): Promise<boolean>;
+    protected closeSelf(): Promise<void>;
+}
+//# sourceMappingURL=redis.d.ts.map

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

@@ -0,0 +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"}

package/dist/workspace/store/redis.js

@@ -0,0 +1,126 @@
+// ========= 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 { 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 { CAS_SCRIPT, RedisSessionStore } from "../session/redis.js";
+/**
+ * WorkspaceStateStore backed by one Redis server.
+ *
+ * Key layout under one prefix, everything scoped by workspace id:
+ *
+ * - `{prefix}workspaces` — hash, workspace id -> metadata JSON
+ * - `{prefix}{ws}:namespace:nodes` (+ `:user`) — namespace plane
+ * - `{prefix}{ws}:observer:*` — observer plane
+ * - `{prefix}{ws}:sessions` — session table
+ *
+ * All plane state survives restarts and is visible to every process
+ * pointed at the same url and prefix, so a workspace rebuilt from its
+ * config alone gets identical overlays, history, sessions, and grants.
+ * Mirrors the Python RedisWorkspaceStateStore.
+ */
+export class RedisWorkspaceStateStore extends WorkspaceStateStore {
+    url;
+    prefix;
+    metaKey;
+    clientPromise = null;
+    namespaces = new Map();
+    observers = new Map();
+    sessionTables = new Map();
+    constructor(options = {}) {
+        const { url, keyPrefix, ...overrides } = options;
+        super(overrides);
+        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;
+    }
+    makeNamespace(workspaceId) {
+        let ns = this.namespaces.get(workspaceId);
+        if (ns === undefined) {
+            ns = new RedisNamespaceStore({
+                url: this.url,
+                keyPrefix: `${this.prefix}${workspaceId}:namespace:`,
+            });
+            this.namespaces.set(workspaceId, ns);
+        }
+        return ns;
+    }
+    makeObserver(workspaceId) {
+        let ob = this.observers.get(workspaceId);
+        if (ob === undefined) {
+            ob = new RedisObserverStore({
+                url: this.url,
+                keyPrefix: `${this.prefix}${workspaceId}:observer:`,
+            });
+            this.observers.set(workspaceId, ob);
+        }
+        return ob;
+    }
+    makeSessions(workspaceId) {
+        let table = this.sessionTables.get(workspaceId);
+        if (table === undefined) {
+            table = new RedisSessionStore({
+                url: this.url,
+                keyPrefix: `${this.prefix}${workspaceId}:`,
+            });
+            this.sessionTables.set(workspaceId, table);
+        }
+        return table;
+    }
+    async readMeta(workspaceId) {
+        const c = await this.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 result = await c.eval(CAS_SCRIPT, {
+            keys: [this.metaKey],
+            arguments: [workspaceId, JSON.stringify(fields), String(expectedGeneration)],
+        });
+        return result === 1;
+    }
+    async closeSelf() {
+        for (const ns of this.namespaces.values())
+            await ns.close();
+        for (const ob of this.observers.values())
+            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();
+        }
+    }
+}
+//# sourceMappingURL=redis.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,48 @@
+import type { 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.
+ *
+ * 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:
+ * 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
+ * node one mounts the workspace itself, so that is what is held here.
+ */
+export declare class KernelMounts {
+    private readonly workspace;
+    private readonly mountpointsMap;
+    private readonly managers;
+    constructor(workspace: Workspace);
+    /**
+     * Expose `prefix` at a real mountpoint and return its path.
+     *
+     * A session-bound mount runs every op under that session's mount
+     * grants (the kernel-tier primitive: bind-mount the tree into a
+     * container and the narrowing travels with it).
+     *
+     * @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
+     */
+    add(prefix: string, mountpoint?: string, sessionId?: string, backend?: MountBackend): Promise<string>;
+    /**
+     * Unmount one exposed subtree.
+     *
+     * @param prefix the virtual prefix that was exposed
+     * @param sessionId session the mount was bound to
+     */
+    remove(prefix: string, sessionId?: string): Promise<void>;
+    /** Unmount everything this workspace exposed. */
+    close(): Promise<void>;
+    /** The single active mountpoint, when there is exactly one. */
+    get mountpoint(): string | null;
+    get mountpoints(): Record<string, string>;
+    private register;
+}
+//# sourceMappingURL=kernel_mounts.d.ts.map

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

@@ -0,0 +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"}

package/dist/workspace/workspace/kernel_mounts.js

@@ -0,0 +1,117 @@
+// ========= 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 { FuseManager } from "../fuse.js";
+/**
+ * The workspace's real mountpoints, one {@link FuseManager} 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:
+ * 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
+ * node one mounts the workspace itself, so that is what is held here.
+ */
+export class KernelMounts {
+    workspace;
+    mountpointsMap = new Map();
+    managers = new Map();
+    constructor(workspace) {
+        this.workspace = workspace;
+    }
+    /**
+     * Expose `prefix` at a real mountpoint and return its path.
+     *
+     * A session-bound mount runs every op under that session's mount
+     * grants (the kernel-tier primitive: bind-mount the tree into a
+     * container and the narrowing travels with it).
+     *
+     * @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
+     */
+    async add(prefix, mountpoint, sessionId, backend) {
+        const session = sessionId !== undefined ? this.workspace.getSession(sessionId) : undefined;
+        const key = sessionId === undefined ? prefix : `${prefix}@${sessionId}`;
+        // Register a pinned path BEFORE mounting so a collision is rejected
+        // without leaving a partial mount.
+        if (mountpoint !== undefined)
+            this.register(key, mountpoint);
+        const manager = new FuseManager();
+        this.managers.set(key, manager);
+        try {
+            const resolved = await manager.setup(this.workspace, {
+                rootPrefix: prefix,
+                ...(mountpoint !== undefined ? { mountpoint } : {}),
+                ...(session !== undefined ? { session } : {}),
+                ...(backend !== undefined ? { backend } : {}),
+            });
+            if (mountpoint === undefined)
+                this.register(key, resolved);
+            return resolved;
+        }
+        catch (err) {
+            // The mount never came up; drop the manager and any registered path
+            // so mountpoints does not misreport it as live.
+            this.managers.delete(key);
+            this.mountpointsMap.delete(key);
+            throw err;
+        }
+    }
+    /**
+     * Unmount one exposed subtree.
+     *
+     * @param prefix the virtual prefix that was exposed
+     * @param sessionId session the mount was bound to
+     */
+    async remove(prefix, sessionId) {
+        const key = sessionId === undefined ? prefix : `${prefix}@${sessionId}`;
+        const manager = this.managers.get(key);
+        this.managers.delete(key);
+        if (manager !== undefined)
+            await manager.unmount();
+        this.mountpointsMap.delete(key);
+    }
+    /** Unmount everything this workspace exposed. */
+    async close() {
+        for (const manager of this.managers.values())
+            await manager.unmount();
+        this.managers.clear();
+        this.mountpointsMap.clear();
+    }
+    /** The single active mountpoint, when there is exactly one. */
+    get mountpoint() {
+        if (this.mountpointsMap.size === 0)
+            return null;
+        if (this.mountpointsMap.size > 1) {
+            throw new Error('multiple FUSE mounts active; use fuseMountpoints to select one by prefix');
+        }
+        return this.mountpointsMap.values().next().value ?? null;
+    }
+    get mountpoints() {
+        return Object.fromEntries(this.mountpointsMap);
+    }
+    register(key, mountpoint) {
+        for (const [otherKey, otherMountpoint] of this.mountpointsMap) {
+            if (otherMountpoint === mountpoint && otherKey !== key) {
+                throw new Error(`FUSE mountpoint ${mountpoint} already used by prefix ${otherKey}; mounts need distinct paths`);
+            }
+        }
+        this.mountpointsMap.set(key, mountpoint);
+    }
+}
+//# sourceMappingURL=kernel_mounts.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,44 @@
+import type { ProvisionResult } from '@struktoai/mirage-core/provision/types';
+import { MountBackend } from '@struktoai/mirage-core/types';
+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 './compression_codecs.ts';
+import './runtime/sandbox/daytona/runtime.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>;
+    private fuseSetupPromise;
+    private readonly kernelMounts;
+    constructor(resources: Record<string, MountSpec | Mount>, 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
+     * at once. A pinned mountpoint is collision-checked BEFORE mounting, so a
+     * clash never leaves a partial kernel mount.
+     *
+     * A session-bound mount (`sessionId` given) runs every op under that
+     * session's mount grants (the kernel-tier primitive: bind-mount the tree
+     * into a container and the narrowing travels with it); it is keyed
+     * separately so the same prefix can also be exposed unbound.
+     */
+    addFuseMount(prefix: string, mountpoint?: string, sessionId?: string, backend?: MountBackend): Promise<string>;
+    removeFuseMount(prefix: string, sessionId?: string): Promise<void>;
+    get fuseMountpoints(): Record<string, string>;
+    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;
+    }): Promise<ExecuteResult>;
+    execute(command: string, options: ExecuteOptions & {
+        provision: true;
+    }): Promise<ProvisionResult>;
+    execute(command: string, options: ExecuteOptions): Promise<ExecuteResult | ProvisionResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +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"}