typescript-virtual-container 1.4.2 → 1.4.3

package/dist/VirtualFileSystem/index.d.ts

@@ -50,6 +50,10 @@ declare class VirtualFileSystem extends EventEmitter {
     private root;
     private readonly mode;
     private readonly snapshotFile;
+    /** Active host-directory mounts: vPath → { hostPath, readOnly } */
+    private readonly mounts;
+    /** True when running in a browser environment (no host FS access). */
+    private static readonly isBrowser;
     constructor(options?: VfsOptions);
     private makeDir;
     private makeFile;
@@ -75,6 +79,49 @@ declare class VirtualFileSystem extends EventEmitter {
     /** Returns the snapshot file path used in `"fs"` mode, or `null`. */
     getSnapshotPath(): string | null;
     /** Creates a directory (and any missing parents). */
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Files inside `vPath` are read directly from the host filesystem via
+     * `node:fs`. All standard VFS operations (`readFile`, `writeFile`,
+     * `exists`, `stat`, `list`) are transparently delegated.
+     *
+     * In browser environments the mount is silently ignored — `vPath` remains
+     * an empty in-memory directory.
+     *
+     * @param vPath     Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath  Path on the host filesystem — relative paths are
+     *                  resolved from `process.cwd()`.
+     * @param readOnly  When `true` (default), write operations inside the
+     *                  mount throw `EROFS: read-only file system`.
+     *
+     * @example
+     * ```ts
+     * shell.vfs.mount("/app", "./src", { readOnly: true });
+     * // cat /app/index.ts  — reads ./src/index.ts from host
+     * ```
+     */
+    mount(vPath: string, hostPath: string, { readOnly }?: {
+        readOnly?: boolean;
+    }): void;
+    /**
+     * Unmount a previously mounted host directory.
+     * The in-memory VFS directory at `vPath` is preserved but the host
+     * delegation is removed.
+     */
+    unmount(vPath: string): void;
+    /** List all active mounts. */
+    getMounts(): Array<{
+        vPath: string;
+        hostPath: string;
+        readOnly: boolean;
+    }>;
+    /**
+     * If `targetPath` is inside a mount, return `{ hostPath, readOnly, relPath }`.
+     * `relPath` is the path relative to the mount's host directory.
+     * Returns `null` if the path is not under any mount.
+     */
+    private resolveMount;
     mkdir(targetPath: string, mode?: number): void;
     /**
      * Writes UTF-8 text or binary content into a file.

package/dist/VirtualFileSystem/index.d.ts.map

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

package/dist/VirtualFileSystem/index.js

@@ -32,6 +32,10 @@ class VirtualFileSystem extends EventEmitter {
     root;
     mode;
     snapshotFile;
+    /** Active host-directory mounts: vPath → { hostPath, readOnly } */
+    mounts = new Map();
+    /** True when running in a browser environment (no host FS access). */
+    static isBrowser = typeof process === "undefined" || typeof process.versions?.node === "undefined";
     constructor(options = {}) {
         super();
         this.mode = options.mode ?? "memory";
@@ -151,6 +155,80 @@ class VirtualFileSystem extends EventEmitter {
     }
     // ── Public filesystem API ─────────────────────────────────────────────────
     /** Creates a directory (and any missing parents). */
+    // ── Mount API ─────────────────────────────────────────────────────────────
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Files inside `vPath` are read directly from the host filesystem via
+     * `node:fs`. All standard VFS operations (`readFile`, `writeFile`,
+     * `exists`, `stat`, `list`) are transparently delegated.
+     *
+     * In browser environments the mount is silently ignored — `vPath` remains
+     * an empty in-memory directory.
+     *
+     * @param vPath     Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath  Path on the host filesystem — relative paths are
+     *                  resolved from `process.cwd()`.
+     * @param readOnly  When `true` (default), write operations inside the
+     *                  mount throw `EROFS: read-only file system`.
+     *
+     * @example
+     * ```ts
+     * shell.vfs.mount("/app", "./src", { readOnly: true });
+     * // cat /app/index.ts  — reads ./src/index.ts from host
+     * ```
+     */
+    mount(vPath, hostPath, { readOnly = true } = {}) {
+        if (VirtualFileSystem.isBrowser)
+            return; // silently degrade in browser
+        const normalized = normalizePath(vPath);
+        const resolved = path.resolve(hostPath);
+        if (!fsSync.existsSync(resolved)) {
+            throw new Error(`VirtualFileSystem.mount: host path does not exist: "${resolved}"`);
+        }
+        if (!fsSync.statSync(resolved).isDirectory()) {
+            throw new Error(`VirtualFileSystem.mount: host path is not a directory: "${resolved}"`);
+        }
+        // Ensure the mount point exists in the VFS tree
+        this.mkdir(normalized);
+        this.mounts.set(normalized, { hostPath: resolved, readOnly });
+        this.emit("mount", { vPath: normalized, hostPath: resolved, readOnly });
+    }
+    /**
+     * Unmount a previously mounted host directory.
+     * The in-memory VFS directory at `vPath` is preserved but the host
+     * delegation is removed.
+     */
+    unmount(vPath) {
+        const normalized = normalizePath(vPath);
+        if (this.mounts.delete(normalized)) {
+            this.emit("unmount", { vPath: normalized });
+        }
+    }
+    /** List all active mounts. */
+    getMounts() {
+        return [...this.mounts.entries()].map(([vPath, opts]) => ({
+            vPath, ...opts,
+        }));
+    }
+    /**
+     * If `targetPath` is inside a mount, return `{ hostPath, readOnly, relPath }`.
+     * `relPath` is the path relative to the mount's host directory.
+     * Returns `null` if the path is not under any mount.
+     */
+    resolveMount(targetPath) {
+        const normalized = normalizePath(targetPath);
+        // Iterate mounts from most specific to least specific
+        const sorted = [...this.mounts.entries()].sort(([a], [b]) => b.length - a.length);
+        for (const [vBase, opts] of sorted) {
+            if (normalized === vBase || normalized.startsWith(`${vBase}/`)) {
+                const relPath = normalized.slice(vBase.length).replace(/^\//, "");
+                const fullHostPath = relPath ? path.join(opts.hostPath, relPath) : opts.hostPath;
+                return { hostPath: opts.hostPath, readOnly: opts.readOnly, relPath, fullHostPath };
+            }
+        }
+        return null;
+    }
     mkdir(targetPath, mode = 0o755) {
         const normalized = normalizePath(targetPath);
         const existing = (() => {
@@ -171,6 +249,17 @@ class VirtualFileSystem extends EventEmitter {
      * Parent directories are created when missing.
      */
     writeFile(targetPath, content, options = {}) {
+        // Delegate to host FS if inside a mount
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (m.readOnly)
+                throw new Error(`EROFS: read-only file system, open '${m.fullHostPath}'`);
+            const dir = path.dirname(m.fullHostPath);
+            if (!fsSync.existsSync(dir))
+                fsSync.mkdirSync(dir, { recursive: true });
+            fsSync.writeFileSync(m.fullHostPath, Buffer.isBuffer(content) ? content : Buffer.from(content, "utf8"));
+            return;
+        }
         const normalized = normalizePath(targetPath);
         const { parent, name } = getParentDirectory(this.root, normalized, true, (p) => this.mkdirRecursive(p, 0o755));
         const existing = parent.children.get(name);
@@ -200,6 +289,12 @@ class VirtualFileSystem extends EventEmitter {
      * Gzip-compressed files are transparently decompressed.
      */
     readFile(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
+            return fsSync.readFileSync(m.fullHostPath, "utf8");
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "file") {
@@ -212,6 +307,12 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Reads file content as a Buffer (decompresses if needed). */
     readFileRaw(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, open '${m.fullHostPath}'`);
+            return fsSync.readFileSync(m.fullHostPath);
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "file") {
@@ -224,6 +325,9 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Returns true when a file or directory exists at path. */
     exists(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m)
+            return fsSync.existsSync(m.fullHostPath);
         try {
             getNode(this.root, normalizePath(targetPath));
             return true;
@@ -238,6 +342,35 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Returns metadata for a file or directory. */
     stat(targetPath) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: stat '${m.fullHostPath}'`);
+            const hst = fsSync.statSync(m.fullHostPath);
+            const name = m.relPath.split("/").pop() ?? m.fullHostPath.split("/").pop() ?? "";
+            const now = hst.mtime;
+            if (hst.isDirectory()) {
+                return {
+                    type: "directory",
+                    name,
+                    path: normalizePath(targetPath),
+                    mode: 0o755,
+                    createdAt: hst.birthtime,
+                    updatedAt: now,
+                    childrenCount: fsSync.readdirSync(m.fullHostPath).length,
+                };
+            }
+            return {
+                type: "file",
+                name,
+                path: normalizePath(targetPath),
+                mode: m.readOnly ? 0o444 : 0o644,
+                createdAt: hst.birthtime,
+                updatedAt: now,
+                compressed: false,
+                size: hst.size,
+            };
+        }
         const normalized = normalizePath(targetPath);
         const node = getNode(this.root, normalized);
         const name = normalized === "/" ? "" : path.posix.basename(normalized);
@@ -267,6 +400,17 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Lists direct children names of a directory (sorted). */
     list(dirPath = "/") {
+        const m = this.resolveMount(dirPath);
+        if (m) {
+            if (!fsSync.existsSync(m.fullHostPath))
+                return [];
+            try {
+                return fsSync.readdirSync(m.fullHostPath).sort();
+            }
+            catch {
+                return [];
+            }
+        }
         const normalized = normalizePath(dirPath);
         const node = getNode(this.root, normalized);
         if (node.type !== "directory") {
@@ -402,6 +546,21 @@ class VirtualFileSystem extends EventEmitter {
     }
     /** Removes a file or directory node. */
     remove(targetPath, options = {}) {
+        const m = this.resolveMount(targetPath);
+        if (m) {
+            if (m.readOnly)
+                throw new Error(`EROFS: read-only file system, unlink '${m.fullHostPath}'`);
+            if (!fsSync.existsSync(m.fullHostPath))
+                throw new Error(`ENOENT: no such file or directory, unlink '${m.fullHostPath}'`);
+            const hst = fsSync.statSync(m.fullHostPath);
+            if (hst.isDirectory()) {
+                fsSync.rmSync(m.fullHostPath, { recursive: options.recursive ?? false });
+            }
+            else {
+                fsSync.unlinkSync(m.fullHostPath);
+            }
+            return;
+        }
         const normalized = normalizePath(targetPath);
         if (normalized === "/")
             throw new Error("Cannot remove root directory.");

package/dist/VirtualShell/index.d.ts

@@ -147,6 +147,35 @@ declare class VirtualShell extends EventEmitter {
      * reading `/proc` files for up-to-date values.
      */
     refreshProcFs(): void;
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Delegates file operations inside `vPath` to the host filesystem via
+     * `node:fs`. Silently ignored in browser environments.
+     *
+     * @param vPath    Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath Path on the host — relative paths are resolved from `process.cwd()`.
+     * @param options  `{ readOnly?: boolean }` — default `true`.
+     *
+     * @example
+     * ```ts
+     * const shell = new VirtualShell("dev-vm");
+     * await shell.ensureInitialized();
+     * shell.mount("/workspace", "./my-project");
+     * // shell commands can now read ./my-project files via /workspace
+     * ```
+     */
+    mount(vPath: string, hostPath: string, options?: {
+        readOnly?: boolean;
+    }): void;
+    /** Remove a previously mounted host directory. */
+    unmount(vPath: string): void;
+    /** List all active mounts. */
+    getMounts(): Array<{
+        vPath: string;
+        hostPath: string;
+        readOnly: boolean;
+    }>;
     /**
      * Updates only the session-dependent `/proc` entries (`/proc/<pid>`,
      * `/proc/self`). Cheaper than a full `refreshProcFs()` — call this

package/dist/VirtualShell/index.d.ts.map

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

package/dist/VirtualShell/index.js

@@ -196,6 +196,35 @@ class VirtualShell extends EventEmitter {
     refreshProcFs() {
         refreshProc(this.vfs, this.properties, this.hostname, this.startTime, this.users.listActiveSessions());
     }
+    /**
+     * Mount a host directory into the VFS at `vPath`.
+     *
+     * Delegates file operations inside `vPath` to the host filesystem via
+     * `node:fs`. Silently ignored in browser environments.
+     *
+     * @param vPath    Absolute path inside the VM (e.g. `"/app"`).
+     * @param hostPath Path on the host — relative paths are resolved from `process.cwd()`.
+     * @param options  `{ readOnly?: boolean }` — default `true`.
+     *
+     * @example
+     * ```ts
+     * const shell = new VirtualShell("dev-vm");
+     * await shell.ensureInitialized();
+     * shell.mount("/workspace", "./my-project");
+     * // shell commands can now read ./my-project files via /workspace
+     * ```
+     */
+    mount(vPath, hostPath, options = {}) {
+        this.vfs.mount(vPath, hostPath, options);
+    }
+    /** Remove a previously mounted host directory. */
+    unmount(vPath) {
+        this.vfs.unmount(vPath);
+    }
+    /** List all active mounts. */
+    getMounts() {
+        return this.vfs.getMounts();
+    }
     /**
      * Updates only the session-dependent `/proc` entries (`/proc/<pid>`,
      * `/proc/self`). Cheaper than a full `refreshProcFs()` — call this

package/dist/VirtualShell/shellParser.js

@@ -202,6 +202,9 @@ function parseCommandWithRedirections(token) {
     let outputFile;
     let appendOutput = false;
     let i = 0;
+    let stderrFile;
+    let stderrAppend = false;
+    let stderrToStdout = false;
     while (i < parts.length) {
         const part = parts[i];
         if (part === "<") {
@@ -227,11 +230,35 @@ function parseCommandWithRedirections(token) {
             appendOutput = false;
             i++;
         }
+        else if (part === "2>&1") {
+            stderrToStdout = true;
+            i++;
+        }
+        else if (part === "2>>") {
+            i++;
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after 2>>");
+            stderrFile = parts[i];
+            stderrAppend = true;
+            i++;
+        }
+        else if (part === "2>") {
+            i++;
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after 2>");
+            stderrFile = parts[i];
+            stderrAppend = false;
+            i++;
+        }
         else {
             cmdParts.push(part);
             i++;
         }
     }
     const name = (cmdParts[0] ?? "").toLowerCase();
-    return { name, args: cmdParts.slice(1), inputFile, outputFile, appendOutput };
+    return {
+        name, args: cmdParts.slice(1),
+        inputFile, outputFile, appendOutput,
+        stderrFile, stderrAppend, stderrToStdout,
+    };
 }

package/dist/commands/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAwB3B,CAAC"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WA0B3B,CAAC"}

package/dist/commands/export.js

@@ -9,13 +9,15 @@ export const exportCommand = {
     category: "shell",
     params: ["[VAR=value]"],
     run: ({ args, env }) => {
-        if (args.length === 0) {
+        // export -p or export with no args — list all exported vars
+        if (args.length === 0 || (args.length === 1 && args[0] === "-p")) {
             const out = Object.entries(env.vars)
+                .filter(([k]) => k && /^[A-Za-z_][A-Za-z0-9_]*$/.test(k))
                 .map(([k, v]) => `declare -x ${k}="${v}"`)
                 .join("\n");
-            return { stdout: out, exitCode: 0 };
+            return { stdout: out ? `${out}\n` : "", exitCode: 0 };
         }
-        for (const arg of args) {
+        for (const arg of args.filter((a) => a !== "-p")) {
             if (arg.includes("=")) {
                 const eq = arg.indexOf("=");
                 const name = arg.slice(0, eq);

package/dist/commands/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmNpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAYzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,WAAW,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqNpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAYzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,WAAW,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE"}

package/dist/commands/registry.js

@@ -34,6 +34,7 @@ import { htopCommand } from "./htop";
 import { idCommand } from "./id";
 import { killCommand } from "./kill";
 import { lnCommand, readlinkCommand } from "./ln";
+import { seqCommand } from "./seq";
 import { statCommand } from "./stat";
 import { lsCommand } from "./ls";
 import { lsbReleaseCommand } from "./lsb-release";
@@ -96,6 +97,7 @@ const BASE_COMMANDS = [
     lnCommand,
     readlinkCommand,
     chmodCommand,
+    seqCommand,
     statCommand,
     findCommand,
     // Text processing

package/dist/commands/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAK3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAyCD,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA4ExB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA+HxB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAK3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAyCD,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA4ExB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA0JxB"}

package/dist/commands/runtime.js

@@ -1,7 +1,7 @@
 /** biome-ignore-all lint/style/useNamingConvention: ENV VARIABLES */
 import { executeStatements } from "../SSHMimic/executor";
 import { parseScript } from "../VirtualShell/shellParser";
-import { expandAsync } from "../utils/expand";
+import { expandAsync, expandBraces } from "../utils/expand";
 import { tokenizeCommand } from "../utils/tokenize";
 import { resolveModule } from "./registry";
 export function makeDefaultEnv(authUser, hostname) {
@@ -135,13 +135,37 @@ export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell,
     const aliasExpanded = aliasVal
         ? trimmed.replace(rawFirstWord, aliasVal)
         : trimmed;
+    // Detect sh-syntax constructs that must be handled by the sh interpreter
+    const isShScript = /\bfor\s+\w+\s+in\b/.test(aliasExpanded) ||
+        /\bwhile\s+/.test(aliasExpanded) ||
+        /\bif\s+/.test(aliasExpanded) ||
+        /\w+\s*\(\s*\)\s*\{/.test(aliasExpanded) ||
+        /\bfunction\s+\w+/.test(aliasExpanded) ||
+        /\(\(\s*.+\s*\)\)/.test(aliasExpanded);
     const hasOperators = /(?<![|&])[|](?![|])/.test(aliasExpanded) ||
         aliasExpanded.includes(">") ||
         aliasExpanded.includes("<") ||
         aliasExpanded.includes("&&") ||
         aliasExpanded.includes("||") ||
         aliasExpanded.includes(";");
-    if (hasOperators) {
+    if ((isShScript && rawFirstWord !== "sh" && rawFirstWord !== "bash") || hasOperators) {
+        // sh-syntax: route through sh interpreter to handle for/while/functions
+        if (isShScript && rawFirstWord !== "sh" && rawFirstWord !== "bash") {
+            const shMod = resolveModule("sh");
+            if (shMod) {
+                return await shMod.run({
+                    authUser, hostname,
+                    activeSessions: shell.users.listActiveSessions(),
+                    rawInput: aliasExpanded,
+                    mode,
+                    args: ["-c", aliasExpanded],
+                    stdin: undefined,
+                    cwd,
+                    shell,
+                    env: shellEnv,
+                });
+            }
+        }
         const script = parseScript(aliasExpanded);
         if (!script.isValid)
             return { stderr: script.error || "Syntax error", exitCode: 1 };
@@ -158,7 +182,8 @@ export async function runCommand(rawInput, authUser, hostname, mode, cwd, shell,
     const expanded = await expandAsync(aliasExpanded, shellEnv.vars, shellEnv.lastExitCode, (sub) => runCommand(sub, authUser, hostname, mode, cwd, shell, undefined, shellEnv).then((r) => r.stdout ?? ""));
     const parts = tokenizeCommand(expanded.trim());
     const commandName = parts[0]?.toLowerCase() ?? "";
-    const args = parts.slice(1);
+    // Apply brace expansion to each arg token
+    const args = parts.slice(1).flatMap(expandBraces);
     const mod = resolveModule(commandName);
     if (!mod) {
         const vfsBinary = resolveVfsBinary(commandName, shellEnv, shell, authUser);

package/dist/commands/seq.d.ts

@@ -0,0 +1,4 @@
+import type { ShellModule } from "../types/commands";
+/** Generate sequences of numbers. seq LAST / seq FIRST LAST / seq FIRST INCREMENT LAST */
+export declare const seqCommand: ShellModule;
+//# sourceMappingURL=seq.d.ts.map

package/dist/commands/seq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seq.d.ts","sourceRoot":"","sources":["../../src/commands/seq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,WAuCxB,CAAC"}

package/dist/commands/seq.js

@@ -0,0 +1,50 @@
+/** Generate sequences of numbers. seq LAST / seq FIRST LAST / seq FIRST INCREMENT LAST */
+export const seqCommand = {
+    name: "seq",
+    description: "Print a sequence of numbers",
+    category: "text",
+    params: ["[FIRST [INCREMENT]] LAST"],
+    run: ({ args }) => {
+        const nums = args.filter((a) => !a.startsWith("-") || /^-[\d.]/.test(a)).map(Number);
+        const sep = (() => { const i = args.indexOf("-s"); return i !== -1 ? (args[i + 1] ?? "\n") : "\n"; })();
+        const fmt = (() => { const i = args.indexOf("-f"); return i !== -1 ? (args[i + 1] ?? "%g") : null; })();
+        const width = args.includes("-w");
+        let first = 1, inc = 1, last;
+        if (nums.length === 1) {
+            last = nums[0];
+        }
+        else if (nums.length === 2) {
+            first = nums[0];
+            last = nums[1];
+        }
+        else {
+            first = nums[0];
+            inc = nums[1];
+            last = nums[2];
+        }
+        if (inc === 0)
+            return { stderr: "seq: zero increment\n", exitCode: 1 };
+        if ((inc > 0 && first > last) || (inc < 0 && first < last))
+            return { stdout: "", exitCode: 0 };
+        const results = [];
+        const maxSteps = 100000;
+        let steps = 0;
+        for (let n = first; inc > 0 ? n <= last : n >= last; n = Math.round((n + inc) * 1e10) / 1e10) {
+            if (++steps > maxSteps)
+                break;
+            let s;
+            if (fmt) {
+                s = fmt.replace("%g", String(n)).replace("%f", n.toFixed(6)).replace("%d", String(Math.trunc(n)));
+            }
+            else {
+                s = Number.isInteger(n) ? String(n) : n.toPrecision(12).replace(/\.?0+$/, "");
+            }
+            if (width) {
+                const maxLen = String(Math.trunc(last)).length;
+                s = s.padStart(maxLen, "0");
+            }
+            results.push(s);
+        }
+        return { stdout: `${results.join(sep)}\n`, exitCode: 0 };
+    },
+};

package/dist/commands/sh.d.ts

@@ -1,9 +1,3 @@
 import type { ShellModule } from "../types/commands";
-/**
- * Execute shell scripts or commands with a minimal shell interpreter.
- * Supports if/elif/else, for loops, while loops, and variable expansion.
- * @category shell
- * @params ["-c <script>", "[<file>]"]
- */
 export declare const shCommand: ShellModule;
 //# sourceMappingURL=sh.d.ts.map

package/dist/commands/sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sh.d.ts","sourceRoot":"","sources":["../../src/commands/sh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EACX,MAAM,mBAAmB,CAAC;AA4R3B;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WA4CvB,CAAC"}
+{"version":3,"file":"sh.d.ts","sourceRoot":"","sources":["../../src/commands/sh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EACX,MAAM,mBAAmB,CAAC;AAqa3B,eAAO,MAAM,SAAS,EAAE,WAsCvB,CAAC"}