typescript-virtual-container 1.2.7 → 1.2.9

package/dist/commands/curl.js

@@ -1,46 +1,98 @@
-import { parseArgs } from "./command-helpers";
-import { assertPathAccess, normalizeTerminalOutput, resolvePath, runHostCommand, } from "./helpers";
+import { ifFlag, parseArgs } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
 export const curlCommand = {
     name: "curl",
-    description: "HTTP client",
+    description: "Transfer data from or to a server (pure fetch)",
     category: "network",
-    params: ["[-o file] <url>"],
+    params: ["[options] <url>"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {
-            flagsWithValue: ["-o", "--output"],
+            flagsWithValue: ["-o", "--output", "-X", "--request", "-d", "--data", "-H", "--header", "-u", "--user"],
         });
-        const outputPath = flagsWithValues.get("-o") || flagsWithValues.get("--output") || null;
-        const url = positionals[0];
-        if (!url) {
-            return { stderr: "curl: missing URL", exitCode: 1 };
-        }
-        const passthroughArgs = outputPath
-            ? [...positionals, "-o", "-"]
-            : positionals;
-        const result = await runHostCommand("curl", passthroughArgs);
-        if (result.exitCode !== 0) {
+        if (ifFlag(args, ["--help", "-h"])) {
             return {
-                stderr: normalizeTerminalOutput(result.stderr || `curl: exited with code ${result.exitCode}`),
-                exitCode: result.exitCode,
+                stdout: [
+                    "Usage: curl [options] <url>",
+                    "  -o, --output <file>    Write to file",
+                    "  -X, --request <method> HTTP method",
+                    "  -d, --data <data>      POST data",
+                    "  -H, --header <hdr>     Extra header",
+                    "  -s, --silent           Silent mode",
+                    "  -I, --head             Fetch headers only",
+                    "  -L, --location         Follow redirects",
+                    "  -v, --verbose          Verbose",
+                ].join("\n"),
+                exitCode: 0,
             };
         }
+        const url = positionals[0];
+        if (!url)
+            return { stderr: "curl: no URL specified", exitCode: 1 };
+        const outputPath = flagsWithValues.get("-o") ?? flagsWithValues.get("--output") ?? null;
+        const method = (flagsWithValues.get("-X") ?? flagsWithValues.get("--request") ?? "GET").toUpperCase();
+        const postData = flagsWithValues.get("-d") ?? flagsWithValues.get("--data") ?? null;
+        const headerRaw = flagsWithValues.get("-H") ?? flagsWithValues.get("--header") ?? null;
+        const silent = ifFlag(args, ["-s", "--silent"]);
+        const headOnly = ifFlag(args, ["-I", "--head"]);
+        const followRedirects = ifFlag(args, ["-L", "--location"]);
+        const verbose = ifFlag(args, ["-v", "--verbose"]);
+        const extraHeaders = { "User-Agent": "curl/7.88.1" };
+        if (headerRaw) {
+            const idx = headerRaw.indexOf(":");
+            if (idx !== -1)
+                extraHeaders[headerRaw.slice(0, idx).trim()] = headerRaw.slice(idx + 1).trim();
+        }
+        const finalMethod = postData && method === "GET" ? "POST" : method;
+        const fetchOpts = {
+            method: finalMethod,
+            headers: extraHeaders,
+            redirect: followRedirects ? "follow" : "manual",
+        };
+        if (postData) {
+            extraHeaders["Content-Type"] ??= "application/x-www-form-urlencoded";
+            fetchOpts.body = postData;
+        }
+        const stderrLines = [];
+        if (verbose) {
+            stderrLines.push(`* Trying ${url}...`, `* Connected`);
+            stderrLines.push(`> ${finalMethod} / HTTP/1.1`, `> Host: ${new URL(url).host}`);
+        }
+        let response;
+        try {
+            response = await fetch(url, fetchOpts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `curl: (6) Could not resolve host: ${msg}`, exitCode: 6 };
+        }
+        if (verbose) {
+            stderrLines.push(`< HTTP/1.1 ${response.status} ${response.statusText}`);
+        }
+        if (headOnly) {
+            const lines = [`HTTP/1.1 ${response.status} ${response.statusText}`];
+            for (const [k, v] of response.headers.entries())
+                lines.push(`${k}: ${v}`);
+            return { stdout: `${lines.join("\r\n")}\r\n`, exitCode: 0 };
+        }
+        let body;
+        try {
+            body = await response.text();
+        }
+        catch {
+            return { stderr: "curl: failed to read response body", exitCode: 1 };
+        }
         if (outputPath) {
             const target = resolvePath(cwd, outputPath);
             assertPathAccess(authUser, target, "curl");
-            shell.writeFileAsUser(authUser, target, result.stdout);
-            return {
-                stderr: result.stderr
-                    ? normalizeTerminalOutput(result.stderr)
-                    : undefined,
-                exitCode: 0,
-            };
+            shell.writeFileAsUser(authUser, target, body);
+            if (!silent)
+                stderrLines.push(`  % Total    % Received\n100 ${body.length}  100 ${body.length}`);
+            return { stderr: stderrLines.join("\n") || undefined, exitCode: response.ok ? 0 : 22 };
         }
         return {
-            stdout: result.stdout,
-            stderr: result.stderr
-                ? normalizeTerminalOutput(result.stderr)
-                : undefined,
-            exitCode: 0,
+            stdout: body,
+            stderr: stderrLines.length > 0 ? stderrLines.join("\n") : undefined,
+            exitCode: response.ok ? 0 : 22,
         };
     },
 };

package/dist/commands/dpkg.d.ts

@@ -0,0 +1,4 @@
+import type { ShellModule } from "../types/commands";
+export declare const dpkgCommand: ShellModule;
+export declare const dpkgQueryCommand: ShellModule;
+//# sourceMappingURL=dpkg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dpkg.d.ts","sourceRoot":"","sources":["../../src/commands/dpkg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA2GzB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WA4C9B,CAAC"}

package/dist/commands/dpkg.js

@@ -0,0 +1,144 @@
+import { ifFlag, parseArgs } from "./command-helpers";
+import { getPackageManager } from "./helpers";
+export const dpkgCommand = {
+    name: "dpkg",
+    description: "Debian package manager low-level tool",
+    category: "system",
+    params: ["[-l] [-s pkg] [-L pkg] [-i pkg] [--remove pkg]"],
+    run: ({ args, authUser, shell }) => {
+        const pm = getPackageManager(shell);
+        if (!pm)
+            return { stderr: "dpkg: package manager not initialised", exitCode: 1 };
+        const listFlag = ifFlag(args, ["-l", "--list"]);
+        const statusFlag = ifFlag(args, ["-s", "--status"]);
+        const listFilesFlag = ifFlag(args, ["-L", "--listfiles"]);
+        const removeFlag = ifFlag(args, ["-r", "--remove"]);
+        const purgeFlag = ifFlag(args, ["-P", "--purge"]);
+        const { positionals } = parseArgs(args, {
+            flags: ["-l", "--list", "-s", "--status", "-L", "--listfiles", "-r", "--remove", "-P", "--purge"],
+        });
+        if (listFlag) {
+            const pkgList = pm.listInstalled();
+            if (pkgList.length === 0) {
+                return {
+                    stdout: [
+                        "Desired=Unknown/Install/Remove/Purge/Hold",
+                        "|Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend",
+                        "|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)",
+                        "||/ Name           Version         Architecture Description",
+                        "+++-==============-===============-============-========================================",
+                        "(no packages installed)",
+                    ].join("\n"),
+                    exitCode: 0,
+                };
+            }
+            const header = [
+                "Desired=Unknown/Install/Remove/Purge/Hold",
+                "|Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend",
+                "|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)",
+                "||/ Name           Version         Architecture Description",
+                "+++-==============-===============-============-========================================",
+            ];
+            const rows = pkgList.map((p) => {
+                const name = p.name.padEnd(14).slice(0, 14);
+                const ver = p.version.padEnd(15).slice(0, 15);
+                const arch = p.architecture.padEnd(12).slice(0, 12);
+                const desc = (p.description || "").slice(0, 40);
+                return `ii  ${name} ${ver} ${arch} ${desc}`;
+            });
+            return { stdout: [...header, ...rows].join("\n"), exitCode: 0 };
+        }
+        if (statusFlag) {
+            const pkgName = positionals[0];
+            if (!pkgName)
+                return { stderr: "dpkg: -s needs a package name", exitCode: 1 };
+            const info = pm.show(pkgName);
+            if (!info)
+                return {
+                    stderr: `dpkg-query: package '${pkgName}' is not installed and no information is available`,
+                    exitCode: 1,
+                };
+            return { stdout: info, exitCode: 0 };
+        }
+        if (listFilesFlag) {
+            const pkgName = positionals[0];
+            if (!pkgName)
+                return { stderr: "dpkg: -L needs a package name", exitCode: 1 };
+            const installed = pm.listInstalled().find((p) => p.name === pkgName);
+            if (!installed)
+                return {
+                    stderr: `dpkg-query: package '${pkgName}' is not installed`,
+                    exitCode: 1,
+                };
+            if (installed.files.length === 0)
+                return { stdout: "/.keep", exitCode: 0 };
+            return { stdout: installed.files.join("\n"), exitCode: 0 };
+        }
+        if (removeFlag || purgeFlag) {
+            if (authUser !== "root")
+                return {
+                    stderr: "dpkg: error: requested operation requires superuser privilege",
+                    exitCode: 2,
+                };
+            if (positionals.length === 0)
+                return { stderr: "dpkg: error: need an action option", exitCode: 2 };
+            const { output, exitCode } = pm.remove(positionals, { purge: purgeFlag });
+            return { stdout: output || undefined, exitCode };
+        }
+        // Default: show help
+        return {
+            stdout: [
+                "Usage: dpkg [<option>...] <command>",
+                "",
+                "Commands:",
+                "  -l, --list                  List packages matching given pattern",
+                "  -s, --status <pkg>...       Report status of specified package",
+                "  -L, --listfiles <pkg>...    List files owned by package",
+                "  -r, --remove <pkg>...       Remove <pkg> but leave its configuration",
+                "  -P, --purge <pkg>...        Remove <pkg> and its configuration",
+            ].join("\n"),
+            exitCode: 0,
+        };
+    },
+};
+export const dpkgQueryCommand = {
+    name: "dpkg-query",
+    description: "Show information about installed packages",
+    category: "system",
+    params: ["-W [pkg] | -l [pattern]"],
+    run: ({ args, shell }) => {
+        const pm = getPackageManager(shell);
+        if (!pm)
+            return { stderr: "dpkg-query: package manager not initialised", exitCode: 1 };
+        const listFlag = ifFlag(args, ["-l"]);
+        const showFlag = ifFlag(args, ["-W", "--show"]);
+        const { positionals } = parseArgs(args, {
+            flags: ["-l", "-W", "--show"],
+        });
+        if (listFlag || showFlag) {
+            const pkgList = pm.listInstalled();
+            const pattern = positionals[0];
+            const filtered = pattern
+                ? pkgList.filter((p) => p.name.includes(pattern))
+                : pkgList;
+            if (showFlag) {
+                return {
+                    stdout: filtered
+                        .map((p) => `${p.name}\t${p.version}`)
+                        .join("\n"),
+                    exitCode: 0,
+                };
+            }
+            const rows = filtered.map((p) => {
+                const name = p.name.padEnd(14).slice(0, 14);
+                const ver = p.version.padEnd(15).slice(0, 15);
+                return `ii  ${name} ${ver} amd64 ${(p.description || "").slice(0, 40)}`;
+            });
+            return {
+                stdout: rows.join("\n") || "(no packages match)",
+                exitCode: 0,
+            };
+        }
+        return { stderr: "dpkg-query: need a flag (-l, -W)", exitCode: 1 };
+    },
+};

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

@@ -1 +1 @@
-{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUrD,eAAO,MAAM,WAAW,EAAE,WAkBzB,CAAC"}
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,eAAO,MAAM,WAAW,EAAE,WAwBzB,CAAC"}

package/dist/commands/echo.js

@@ -1,23 +1,35 @@
 import { parseArgs } from "./command-helpers";
-import { getAllEnvVars } from "./set";
-function expandEnvVars(input, env) {
-    return input.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => {
-        return env[name] ?? "";
-    });
+/**
+ * Expand escape sequences for `echo -e`.
+ * Handles \n \t \r \\ \a \b \f \v and \0NNN (octal).
+ */
+function expandEscapes(text) {
+    return text
+        .replace(/\\n/g, "\n")
+        .replace(/\\t/g, "\t")
+        .replace(/\\r/g, "\r")
+        .replace(/\\\\/g, "\\")
+        .replace(/\\a/g, "\x07")
+        .replace(/\\b/g, "\x08")
+        .replace(/\\f/g, "\x0C")
+        .replace(/\\v/g, "\x0B")
+        .replace(/\\0(\d{1,3})/g, (_, oct) => String.fromCharCode(parseInt(oct, 8)));
 }
 export const echoCommand = {
     name: "echo",
     description: "Display text",
     category: "shell",
-    params: ["[options] [text...]"],
-    run: ({ args, authUser, stdin }) => {
-        const { flags, positionals } = parseArgs(args, { flags: ["-n"] });
-        const newline = !flags.has("-n");
+    params: ["[-n] [-e] [text...]"],
+    run: ({ args, stdin, env }) => {
+        const { flags, positionals } = parseArgs(args, { flags: ["-n", "-e", "-E"] });
+        const noNewline = flags.has("-n");
+        const escapes = flags.has("-e");
         const rawText = positionals.length > 0 ? positionals.join(" ") : (stdin ?? "");
-        const env = getAllEnvVars(authUser);
-        const text = expandEnvVars(rawText, env);
+        // Expand $VAR references using the session env (not the legacy global store)
+        const varsExpanded = rawText.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => env?.vars[name] ?? "");
+        const text = escapes ? expandEscapes(varsExpanded) : varsExpanded;
         return {
-            stdout: newline ? text : text.trimEnd(),
+            stdout: noNewline ? text : `${text}\n`,
             exitCode: 0,
         };
     },

package/dist/commands/free.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const freeCommand: ShellModule;
+//# sourceMappingURL=free.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"free.d.ts","sourceRoot":"","sources":["../../src/commands/free.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAmCzB,CAAC"}

package/dist/commands/free.js

@@ -0,0 +1,38 @@
+import * as os from "node:os";
+import { ifFlag } from "./command-helpers";
+export const freeCommand = {
+    name: "free",
+    description: "Display amount of free and used memory",
+    category: "system",
+    params: ["[-h] [-m] [-g]"],
+    run: ({ args }) => {
+        const human = ifFlag(args, ["-h", "--human"]);
+        const mb = ifFlag(args, ["-m"]);
+        const gb = ifFlag(args, ["-g"]);
+        const osTotalB = os.totalmem();
+        const osFreeB = os.freemem();
+        const usedB = osTotalB - osFreeB;
+        const sharedB = Math.floor(osTotalB * 0.02);
+        const buffersB = Math.floor(osTotalB * 0.05);
+        const availableB = Math.floor(osFreeB * 0.95);
+        const swapB = Math.floor(osTotalB * 0.5);
+        const fmt = (bytes) => {
+            if (human) {
+                if (bytes >= 1024 * 1024 * 1024)
+                    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
+                if (bytes >= 1024 * 1024)
+                    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+                return `${(bytes / 1024).toFixed(1)}K`;
+            }
+            if (gb)
+                return String(Math.floor(bytes / (1024 * 1024 * 1024)));
+            if (mb)
+                return String(Math.floor(bytes / (1024 * 1024)));
+            return String(Math.floor(bytes / 1024));
+        };
+        const header = `               total        used        free      shared  buff/cache   available`;
+        const memRow = `Mem:  ${fmt(osTotalB).padStart(12)} ${fmt(usedB).padStart(11)} ${fmt(osFreeB).padStart(11)} ${fmt(sharedB).padStart(11)} ${fmt(buffersB).padStart(11)} ${fmt(availableB).padStart(11)}`;
+        const swapRow = `Swap: ${fmt(swapB).padStart(12)} ${fmt(0).padStart(11)} ${fmt(swapB).padStart(11)}`;
+        return { stdout: [header, memRow, swapRow].join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/helpers.d.ts

@@ -1,4 +1,6 @@
 import type VirtualFileSystem from "../VirtualFileSystem";
+import type { VirtualPackageManager } from "../VirtualPackageManager";
+import type { VirtualShell } from "../VirtualShell";
 export declare function normalizeTerminalOutput(text: string): string;
 export declare function resolvePath(cwd: string, inputPath: string): string;
 export declare function assertPathAccess(authUser: string, targetPath: string, operation: string): void;
@@ -23,4 +25,5 @@ export declare function resolveReadablePath(vfs: VirtualFileSystem, cwd: string,
 export declare function joinListWithType(cwd: string, items: string[], statAt: (p: string) => {
     type: "file" | "directory";
 }): string;
+export declare function getPackageManager(shell: VirtualShell): VirtualPackageManager | undefined;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAY1D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOlE;AAYD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AA4BD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACnD,MAAM,CAQR"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAYpD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOlE;AAYD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AA4BD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACnD,MAAM,CAQR;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,YAAY,GACjB,qBAAqB,GAAG,SAAS,CAEnC"}

package/dist/commands/helpers.js

@@ -158,3 +158,6 @@ export function joinListWithType(cwd, items, statAt) {
     })
         .join("  ");
 }
+export function getPackageManager(shell) {
+    return shell.packageManager;
+}

package/dist/commands/history.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const historyCommand: ShellModule;
+//# sourceMappingURL=history.d.ts.map

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

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

package/dist/commands/history.js

@@ -0,0 +1,21 @@
+export const historyCommand = {
+    name: "history",
+    description: "Display command history",
+    category: "shell",
+    params: ["[n]"],
+    run: ({ args, shell }) => {
+        // History is persisted in the VFS by the interactive shell
+        const histPath = "/virtual-env-js/.bash_history";
+        if (!shell.vfs.exists(histPath)) {
+            return { stdout: "", exitCode: 0 };
+        }
+        const raw = shell.vfs.readFile(histPath);
+        const lines = raw.split("\n").filter(Boolean);
+        const nArg = args[0];
+        const n = nArg ? parseInt(nArg, 10) : null;
+        const slice = n && !Number.isNaN(n) ? lines.slice(-n) : lines;
+        const offset = lines.length - slice.length + 1;
+        const numbered = slice.map((line, i) => `${String(offset + i).padStart(5)}  ${line}`);
+        return { stdout: numbered.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/index.d.ts

@@ -1,4 +1,3 @@
-/** biome-ignore-all lint/style/useNamingConvention: ENV VARIABLES */
 import type { VirtualShell } from "../VirtualShell";
 import type { CommandContext, CommandMode, CommandResult, ShellEnv, ShellModule } from "../types/commands";
 export declare function registerCommand(module: ShellModule): void;
@@ -7,5 +6,13 @@ export declare function getCommandNames(): string[];
 export declare function getCommandModulesPublic(): ShellModule[];
 export declare function resolveModule(name: string): ShellModule | undefined;
 export declare function makeDefaultEnv(authUser: string, hostname: string): ShellEnv;
+/**
+ * Execute a pre-parsed command directly by name and argument list.
+ *
+ * Unlike `runCommand`, this function does NOT re-join name+args into a string
+ * and re-parse — so arguments that contain special characters (`;`, `|`, `>`,
+ * quotes) are passed through verbatim. Use this from the pipeline executor.
+ */
+export declare function runCommandDirect(name: string, args: string[], authUser: string, hostname: string, mode: CommandMode, cwd: string, shell: VirtualShell, stdin: string | undefined, env: ShellEnv): Promise<CommandResult>;
 export declare function runCommand(rawInput: string, authUser: string, hostname: string, mode: CommandMode, cwd: string, shell: VirtualShell, stdin?: string, env?: ShellEnv): Promise<CommandResult>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,MAAM,mBAAmB,CAAC;AA8G3B,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;AA8BD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;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+CxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,EACX,MAAM,mBAAmB,CAAC;AAiI3B,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;AA8BD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAED;;;;;;GAMG;AACH,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,CA2BxB;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,CAqFxB"}