typescript-virtual-container 1.5.8 → 1.5.10

package/dist/VirtualShell/shell.js

@@ -1,6 +1,7 @@
 import * as path from "node:path";
 import { applyUserSwitch, getCommandNames, makeDefaultEnv, runCommand, userHome } from "../commands";
 import { NanoEditor } from "../modules/nanoEditor";
+import { PacmanGame } from "../modules/pacmanGame";
 import { spawnHtopProcess, } from "../modules/shellInteractive";
 import { getVisibleHtopPidList, toTtyLines, } from "../modules/shellRuntime";
 import { buildLoginBanner } from "../SSHMimic/loginBanner";
@@ -15,6 +16,11 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
     let cwd = userHome(authUser);
     let pendingHeredoc = null;
     const shellEnv = makeDefaultEnv(authUser, hostname);
+    if (sessionId) {
+        const sess = shell.users.listActiveSessions().find((s) => s.id === sessionId);
+        if (sess)
+            shellEnv.vars.__TTY = sess.tty;
+    }
     const sessionStack = [];
     let nanoSession = null;
     let pendingSudo = null;
@@ -60,7 +66,7 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
     })();
     function renderLine() {
         const prompt = buildCurrentPrompt();
-        stream.write(`\r${prompt}${lineBuffer}\u001b[K`);
+        stream.write(`\r\x1b[0m${prompt}${lineBuffer}\u001b[K`);
         const moveLeft = lineBuffer.length - cursorPos;
         if (moveLeft > 0) {
             stream.write(`\u001b[${moveLeft}D`);
@@ -110,6 +116,10 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
             await startHtop();
             return;
         }
+        if (result.openPacman) {
+            startPacman();
+            return;
+        }
         if (result.clearScreen) {
             stream.write("\u001b[2J\u001b[H");
         }
@@ -132,10 +142,15 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
         // WAL: checkpoint handled by auto-flush timer
         renderLine();
     }
+    let interactivePid = -1;
     function finishInteractiveSession(savedContent, targetPath) {
         if (savedContent !== undefined && targetPath) {
             shell.writeFileAsUser(authUser, targetPath, savedContent);
         }
+        if (interactivePid !== -1) {
+            shell.users.unregisterProcess(interactivePid);
+            interactivePid = -1;
+        }
         nanoSession = null;
         lineBuffer = "";
         cursorPos = 0;
@@ -144,6 +159,7 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
         renderLine();
     }
     function startNanoEditor(targetPath, initialContent, _tempPath) {
+        interactivePid = shell.users.registerProcess(authUser, "nano", ["nano", targetPath], shellEnv.vars.__TTY ?? "?");
         const editor = new NanoEditor({
             stream,
             terminalSize,
@@ -167,6 +183,7 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
             stream.write("htop: no child_process processes to display\r\n");
             return;
         }
+        interactivePid = shell.users.registerProcess(authUser, "htop", ["htop"], shellEnv.vars.__TTY ?? "?");
         const monitor = spawnHtopProcess(pidList, terminalSize, stream);
         monitor.on("error", (error) => {
             stream.write(`htop: ${error.message}\r\n`);
@@ -177,6 +194,26 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
         });
         nanoSession = { kind: "htop", process: monitor };
     }
+    function startPacman() {
+        interactivePid = shell.users.registerProcess(authUser, "pacman", ["pacman"], shellEnv.vars.__TTY ?? "?");
+        const game = new PacmanGame({
+            stream,
+            terminalSize,
+            onExit: () => {
+                if (interactivePid !== -1) {
+                    shell.users.unregisterProcess(interactivePid);
+                    interactivePid = -1;
+                }
+                nanoSession = null;
+                lineBuffer = "";
+                cursorPos = 0;
+                stream.write("\x1b[2J\x1b[H\x1b[0m");
+                renderLine();
+            },
+        });
+        nanoSession = { kind: "pacman", game };
+        game.start();
+    }
     function applyHistoryLine(nextLine) {
         lineBuffer = nextLine;
         cursorPos = lineBuffer.length;
@@ -247,6 +284,9 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
             if (nanoSession.kind === "nano") {
                 nanoSession.editor.handleInput(chunk);
             }
+            else if (nanoSession.kind === "pacman") {
+                nanoSession.game.handleInput(chunk);
+            }
             else {
                 nanoSession.process.stdin.write(chunk);
             }
@@ -552,6 +592,10 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
                         await startHtop();
                         return;
                     }
+                    if (result.openPacman) {
+                        startPacman();
+                        return;
+                    }
                     if (result.sudoChallenge) {
                         startSudoPrompt(result.sudoChallenge);
                         return;
@@ -617,6 +661,9 @@ export function startShell(properties, stream, authUser, hostname, sessionId, re
             if (nanoSession.kind === "htop") {
                 nanoSession.process.kill("SIGTERM");
             }
+            else if (nanoSession.kind === "pacman") {
+                nanoSession.game.stop();
+            }
             nanoSession = null;
         }
     });

package/dist/VirtualShell/shellParser.js

@@ -45,7 +45,7 @@ export function expandGlob(pattern, entries) {
 }
 // ── Internal parser ───────────────────────────────────────────────────────────
 function parseStatements(input) {
-    // Split by ;, &&, || — respecting quotes and parens
+    // Split by ;, &&, ||, & — respecting quotes and parens
     const segments = splitByLogicalOps(input);
     const statements = [];
     for (const seg of segments) {
@@ -53,6 +53,8 @@ function parseStatements(input) {
         const stmt = { pipeline: { commands, isValid: true } };
         if (seg.op)
             stmt.op = seg.op;
+        if (seg.background)
+            stmt.background = true;
         statements.push(stmt);
     }
     return statements;
@@ -64,9 +66,9 @@ function splitByLogicalOps(input) {
     let inQ = false;
     let qChar = "";
     let i = 0;
-    const flush = (op) => {
+    const flush = (op, background) => {
         if (current.trim())
-            segments.push({ text: current, op });
+            segments.push({ text: current, op, background });
         current = "";
     };
     while (i < input.length) {
@@ -117,6 +119,25 @@ function splitByLogicalOps(input) {
             i += 2;
             continue;
         }
+        if (ch === "&" && input[i + 1] !== "&") {
+            // &> redirect (stdout+stderr) — keep in current segment, not a background op
+            if (input[i + 1] === ">") {
+                current += ch;
+                i++;
+                continue;
+            }
+            // 2>&1 — the & is part of a redirection target, not a background op
+            const trimmed = current.trimEnd();
+            if (trimmed.endsWith(">") || trimmed.endsWith("2>") || trimmed.endsWith(">>")) {
+                current += ch;
+                i++;
+                continue;
+            }
+            // trailing & → background job; treat like ; for sequencing
+            flush(";", true);
+            i++;
+            continue;
+        }
         if (ch === ";") {
             flush(";");
             i++;
@@ -209,6 +230,17 @@ function parseCommandWithRedirections(token) {
             appendOutput = false;
             i++;
         }
+        else if (part === "&>" || part === "&>>") {
+            // &> file — redirect both stdout and stderr to file
+            const append = part === "&>>";
+            i++;
+            if (i >= parts.length)
+                throw new Error(`Syntax error: expected filename after ${part}`);
+            outputFile = parts[i];
+            appendOutput = append;
+            stderrToStdout = true;
+            i++;
+        }
         else if (part === "2>&1") {
             stderrToStdout = true;
             i++;

package/dist/VirtualUserManager/index.d.ts

@@ -12,6 +12,21 @@ export interface VirtualUserRecord {
     /** Scrypt-derived password hash in hex encoding. */
     passwordHash: string;
 }
+/** Runtime representation of a command currently executing in a session. */
+export interface VirtualProcess {
+    /** Unique process identifier (auto-incremented). */
+    pid: number;
+    /** Username running the process. */
+    username: string;
+    /** Command name (argv[0]). */
+    command: string;
+    /** Full argument list (command + args). */
+    argv: string[];
+    /** TTY identifier of the owning session, or "?" for background jobs. */
+    tty: string;
+    /** ISO-8601 start timestamp. */
+    startedAt: string;
+}
 /** Runtime representation of authenticated SSH session. */
 export interface VirtualActiveSession {
     /** Stable session identifier (UUID). */
@@ -43,7 +58,9 @@ export declare class VirtualUserManager extends EventEmitter {
     private readonly sudoers;
     private readonly quotas;
     private readonly activeSessions;
+    private readonly activeProcesses;
     private nextTty;
+    private nextPid;
     /**
      * Creates a user manager instance backed by a virtual filesystem.
      *
@@ -196,6 +213,15 @@ export declare class VirtualUserManager extends EventEmitter {
      * @returns Array of username strings sorted alphabetically.
      */
     listUsers(): string[];
+    /**
+     * Registers a running command as a virtual process.
+     * Returns the assigned PID so the caller can deregister on completion.
+     */
+    registerProcess(username: string, command: string, argv: string[], tty: string): number;
+    /** Removes a process record when the command exits. */
+    unregisterProcess(pid: number): void;
+    /** Returns all currently running processes sorted by PID. */
+    listProcesses(): VirtualProcess[];
     private loadFromVfs;
     private loadSudoersFromVfs;
     private loadQuotasFromVfs;

package/dist/VirtualUserManager/index.js

@@ -26,7 +26,9 @@ export class VirtualUserManager extends EventEmitter {
     sudoers = new Set();
     quotas = new Map();
     activeSessions = new Map();
+    activeProcesses = new Map();
     nextTty = 0;
+    nextPid = 1000;
     /**
      * Creates a user manager instance backed by a virtual filesystem.
      *
@@ -401,6 +403,30 @@ export class VirtualUserManager extends EventEmitter {
     listUsers() {
         return Array.from(this.users.keys()).sort();
     }
+    /**
+     * Registers a running command as a virtual process.
+     * Returns the assigned PID so the caller can deregister on completion.
+     */
+    registerProcess(username, command, argv, tty) {
+        const pid = this.nextPid++;
+        this.activeProcesses.set(pid, {
+            pid,
+            username,
+            command,
+            argv,
+            tty,
+            startedAt: new Date().toISOString(),
+        });
+        return pid;
+    }
+    /** Removes a process record when the command exits. */
+    unregisterProcess(pid) {
+        this.activeProcesses.delete(pid);
+    }
+    /** Returns all currently running processes sorted by PID. */
+    listProcesses() {
+        return Array.from(this.activeProcesses.values()).sort((a, b) => a.pid - b.pid);
+    }
     loadFromVfs() {
         this.users.clear();
         if (!this.vfs.exists(this.usersPath)) {

package/dist/commands/coreutils.d.ts

@@ -0,0 +1,55 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * timeout — run command with time limit (simulated: just runs the command)
+ * @category shell
+ * @params ["<duration> <command> [args...]"]
+ */
+export declare const timeoutCommand: ShellModule;
+/**
+ * mktemp — create a temporary file or directory
+ * @category shell
+ * @params ["[TEMPLATE]"]
+ */
+export declare const mktempCommand: ShellModule;
+/**
+ * nproc — print number of processing units
+ * @category system
+ * @params ["[--all]"]
+ */
+export declare const nprocCommand: ShellModule;
+/**
+ * wait — wait for background jobs (no-op: background jobs are fire-and-forget)
+ * @category shell
+ * @params ["[job_id...]"]
+ */
+export declare const waitCommand: ShellModule;
+/**
+ * shuf — shuffle lines of input
+ * @category text
+ * @params ["[-n count] [-i lo-hi] [file]"]
+ */
+export declare const shufCommand: ShellModule;
+/**
+ * paste — merge lines of files side by side
+ * @category text
+ * @params ["[-d delimiter] file..."]
+ */
+export declare const pasteCommand: ShellModule;
+/**
+ * tac — concatenate files in reverse (line order)
+ * @category text
+ * @params ["[file...]"]
+ */
+export declare const tacCommand: ShellModule;
+/**
+ * nl — number lines of files
+ * @category text
+ * @params ["[file]"]
+ */
+export declare const nlCommand: ShellModule;
+/**
+ * column — columnate lists
+ * @category text
+ * @params ["[-t] [-s sep] [file]"]
+ */
+export declare const columnCommand: ShellModule;

package/dist/commands/coreutils.js

@@ -0,0 +1,271 @@
+import { resolvePath } from "./helpers";
+/**
+ * timeout — run command with time limit (simulated: just runs the command)
+ * @category shell
+ * @params ["<duration> <command> [args...]"]
+ */
+export const timeoutCommand = {
+    name: "timeout",
+    description: "Run command with time limit",
+    category: "shell",
+    params: ["<duration>", "<command>", "[args...]"],
+    run: async ({ args, authUser, hostname, mode, cwd, shell, env, stdin }) => {
+        // First arg is duration (ignored in simulation), rest is the command
+        if (args.length < 2)
+            return { stderr: "timeout: missing operand", exitCode: 1 };
+        const { runCommand } = await import("./runtime");
+        const cmd = args.slice(1).join(" ");
+        return runCommand(cmd, authUser, hostname, mode, cwd, shell, stdin, env);
+    },
+};
+/**
+ * mktemp — create a temporary file or directory
+ * @category shell
+ * @params ["[TEMPLATE]"]
+ */
+export const mktempCommand = {
+    name: "mktemp",
+    description: "Create a temporary file or directory",
+    category: "shell",
+    params: ["[-d]", "[TEMPLATE]"],
+    run: ({ args, shell }) => {
+        const isDir = args.includes("-d");
+        const templateArg = args.find((a) => !a.startsWith("-")) ?? "tmp.XXXXXXXXXX";
+        const suffix = templateArg.replace(/X+$/, "") || "tmp.";
+        const rand = Math.random().toString(36).slice(2, 10);
+        const name = `${suffix}${rand}`;
+        const path = name.startsWith("/") ? name : `/tmp/${name}`;
+        try {
+            if (!shell.vfs.exists("/tmp"))
+                shell.vfs.mkdir("/tmp");
+            if (isDir) {
+                shell.vfs.mkdir(path);
+            }
+            else {
+                shell.vfs.writeFile(path, "");
+            }
+        }
+        catch {
+            return { stderr: `mktemp: failed to create ${isDir ? "directory" : "file"} via template '${templateArg}'`, exitCode: 1 };
+        }
+        return { stdout: path, exitCode: 0 };
+    },
+};
+/**
+ * nproc — print number of processing units
+ * @category system
+ * @params ["[--all]"]
+ */
+export const nprocCommand = {
+    name: "nproc",
+    description: "Print number of processing units",
+    category: "system",
+    params: ["[--all]"],
+    run: () => ({ stdout: "4", exitCode: 0 }),
+};
+/**
+ * wait — wait for background jobs (no-op: background jobs are fire-and-forget)
+ * @category shell
+ * @params ["[job_id...]"]
+ */
+export const waitCommand = {
+    name: "wait",
+    description: "Wait for background jobs to finish",
+    category: "shell",
+    params: ["[job_id...]"],
+    run: () => ({ exitCode: 0 }),
+};
+/**
+ * shuf — shuffle lines of input
+ * @category text
+ * @params ["[-n count] [-i lo-hi] [file]"]
+ */
+export const shufCommand = {
+    name: "shuf",
+    description: "Shuffle lines of input randomly",
+    category: "text",
+    params: ["[-n count]", "[-i lo-hi]", "[file]"],
+    run: ({ args, stdin, shell, cwd }) => {
+        // -i lo-hi: generate range
+        const iIdx = args.indexOf("-i");
+        if (iIdx !== -1) {
+            const range = args[iIdx + 1] ?? "";
+            const m = range.match(/^(-?\d+)-(-?\d+)$/);
+            if (!m)
+                return { stderr: "shuf: invalid range", exitCode: 1 };
+            const lo = parseInt(m[1], 10);
+            const hi = parseInt(m[2], 10);
+            const nums = [];
+            for (let n = lo; n <= hi; n++)
+                nums.push(n);
+            for (let i = nums.length - 1; i > 0; i--) {
+                const j = Math.floor(Math.random() * (i + 1));
+                [nums[i], nums[j]] = [nums[j], nums[i]];
+            }
+            const nIdx = args.indexOf("-n");
+            const count = nIdx !== -1 ? parseInt(args[nIdx + 1] ?? "0", 10) : nums.length;
+            return { stdout: nums.slice(0, count).join("\n"), exitCode: 0 };
+        }
+        // file or stdin
+        let input = stdin ?? "";
+        const fileArg = args.find((a) => !a.startsWith("-"));
+        if (fileArg) {
+            const p = resolvePath(cwd ?? "/", fileArg);
+            if (!shell.vfs.exists(p))
+                return { stderr: `shuf: ${fileArg}: No such file or directory`, exitCode: 1 };
+            input = shell.vfs.readFile(p);
+        }
+        const lines = input.split("\n").filter((l) => l !== "");
+        for (let i = lines.length - 1; i > 0; i--) {
+            const j = Math.floor(Math.random() * (i + 1));
+            [lines[i], lines[j]] = [lines[j], lines[i]];
+        }
+        const nIdx = args.indexOf("-n");
+        const count = nIdx !== -1 ? parseInt(args[nIdx + 1] ?? "0", 10) : lines.length;
+        return { stdout: lines.slice(0, count).join("\n"), exitCode: 0 };
+    },
+};
+/**
+ * paste — merge lines of files side by side
+ * @category text
+ * @params ["[-d delimiter] file..."]
+ */
+export const pasteCommand = {
+    name: "paste",
+    description: "Merge lines of files",
+    category: "text",
+    params: ["[-d delimiter]", "file..."],
+    run: ({ args, stdin, shell, cwd }) => {
+        let delim = "\t";
+        const files = [];
+        let i = 0;
+        while (i < args.length) {
+            if (args[i] === "-d" && args[i + 1]) {
+                delim = args[i + 1];
+                i += 2;
+            }
+            else {
+                files.push(args[i]);
+                i++;
+            }
+        }
+        // serial mode (-s not implemented; basic merge)
+        let sources;
+        if (files.length === 0 || files[0] === "-") {
+            sources = [(stdin ?? "").split("\n")];
+        }
+        else {
+            sources = files.map((f) => {
+                const p = resolvePath(cwd ?? "/", f);
+                if (!shell.vfs.exists(p))
+                    return [];
+                return shell.vfs.readFile(p).split("\n");
+            });
+        }
+        const maxLen = Math.max(...sources.map((s) => s.length));
+        const out = [];
+        for (let row = 0; row < maxLen; row++) {
+            out.push(sources.map((s) => s[row] ?? "").join(delim));
+        }
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};
+/**
+ * tac — concatenate files in reverse (line order)
+ * @category text
+ * @params ["[file...]"]
+ */
+export const tacCommand = {
+    name: "tac",
+    description: "Concatenate files in reverse line order",
+    category: "text",
+    params: ["[file...]"],
+    run: ({ args, stdin, shell, cwd }) => {
+        let input = "";
+        if (args.length === 0 || (args.length === 1 && args[0] === "-")) {
+            input = stdin ?? "";
+        }
+        else {
+            for (const f of args) {
+                const p = resolvePath(cwd ?? "/", f);
+                if (!shell.vfs.exists(p))
+                    return { stderr: `tac: ${f}: No such file or directory`, exitCode: 1 };
+                input += shell.vfs.readFile(p);
+            }
+        }
+        const lines = input.split("\n");
+        // preserve trailing newline behaviour
+        if (lines[lines.length - 1] === "")
+            lines.pop();
+        return { stdout: lines.reverse().join("\n"), exitCode: 0 };
+    },
+};
+/**
+ * nl — number lines of files
+ * @category text
+ * @params ["[file]"]
+ */
+export const nlCommand = {
+    name: "nl",
+    description: "Number lines of files",
+    category: "text",
+    params: ["[-ba] [-nrz] [file]"],
+    run: ({ args, stdin, shell, cwd }) => {
+        const fileArg = args.find((a) => !a.startsWith("-"));
+        let input = stdin ?? "";
+        if (fileArg) {
+            const p = resolvePath(cwd ?? "/", fileArg);
+            if (!shell.vfs.exists(p))
+                return { stderr: `nl: ${fileArg}: No such file or directory`, exitCode: 1 };
+            input = shell.vfs.readFile(p);
+        }
+        const lines = input.split("\n");
+        if (lines[lines.length - 1] === "")
+            lines.pop();
+        let n = 1;
+        const out = lines.map((l) => {
+            if (l.trim() === "")
+                return `\t${l}`;
+            return `${String(n++).padStart(6)}\t${l}`;
+        });
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};
+/**
+ * column — columnate lists
+ * @category text
+ * @params ["[-t] [-s sep] [file]"]
+ */
+export const columnCommand = {
+    name: "column",
+    description: "Columnate lists",
+    category: "text",
+    params: ["[-t]", "[-s sep]", "[file]"],
+    run: ({ args, stdin, shell, cwd }) => {
+        const tableMode = args.includes("-t");
+        const sIdx = args.indexOf("-s");
+        const sep = sIdx !== -1 ? (args[sIdx + 1] ?? "\t") : /\s+/;
+        const fileArg = args.find((a) => !a.startsWith("-") && a !== args[sIdx + 1]);
+        let input = stdin ?? "";
+        if (fileArg) {
+            const p = resolvePath(cwd ?? "/", fileArg);
+            if (!shell.vfs.exists(p))
+                return { stderr: `column: ${fileArg}: No such file or directory`, exitCode: 1 };
+            input = shell.vfs.readFile(p);
+        }
+        const lines = input.split("\n").filter((l) => l !== "");
+        if (tableMode) {
+            const rows = lines.map((l) => (typeof sep === "string" ? l.split(sep) : l.split(sep)));
+            const colWidths = [];
+            for (const row of rows) {
+                row.forEach((cell, ci) => {
+                    colWidths[ci] = Math.max(colWidths[ci] ?? 0, cell.length);
+                });
+            }
+            const out = rows.map((row) => row.map((cell, ci) => cell.padEnd(colWidths[ci] ?? 0)).join("  ").trimEnd());
+            return { stdout: out.join("\n"), exitCode: 0 };
+        }
+        // Default: fill columns (simple: just output as-is)
+        return { stdout: lines.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/htop.d.ts

@@ -1,7 +1,7 @@
 import type { ShellModule } from "../types/commands";
 /**
- * Interactive system monitor (requires terminal interaction).
+ * Interactive system monitor — full ANSI output in exec/ssh mode, interactive panel in shell mode.
  * @category system
- * @params []
+ * @params ["[-d delay] [-p pid]"]
  */
 export declare const htopCommand: ShellModule;