typescript-virtual-container 1.2.9 → 1.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["../../src/commands/which.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WA+B1B,CAAC"}
+{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["../../src/commands/which.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAkC1B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"xargs.d.ts","sourceRoot":"","sources":["../../src/commands/xargs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WAa1B,CAAC"}
+{"version":3,"file":"xargs.d.ts","sourceRoot":"","sources":["../../src/commands/xargs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WAsB1B,CAAC"}

package/dist/commands/xargs.js

@@ -1,4 +1,4 @@
-import { runCommand } from "./index";
+import { runCommand } from "./runtime";
 export const xargsCommand = {
     name: "xargs",
     description: "Build and execute command lines from stdin",

package/dist/index.d.ts

@@ -1,17 +1,18 @@
-import { HoneyPot } from "./Honeypot/index";
-import { SshClient } from "./SSHClient/index";
-import { SftpMimic, SshMimic } from "./SSHMimic/index";
-import VirtualFileSystem from "./VirtualFileSystem/index";
-import { VirtualShell } from "./VirtualShell/index";
-import { VirtualUserManager } from "./VirtualUserManager/index";
-import { VirtualPackageManager } from "./VirtualPackageManager/index";
-export type { AuditLogEntry, HoneyPotStats, } from "./Honeypot/index";
-export type { CommandContext, CommandMode, CommandOutcome, CommandResult, NanoEditorSession, ShellEnv, ShellModule, SudoChallenge, } from "./types/commands";
-export type { ShellProperties } from "./VirtualShell/index";
+export { HoneyPot } from "./Honeypot/index";
+export { SshClient } from "./SSHClient/index";
+export { SftpMimic as VirtualSftpServer, SshMimic as VirtualSshServer } from "./SSHMimic/index";
+export { default as VirtualFileSystem } from "./VirtualFileSystem/index";
+export { VirtualPackageManager } from "./VirtualPackageManager/index";
+export { VirtualShell } from "./VirtualShell/index";
+export { VirtualUserManager } from "./VirtualUserManager/index";
+export type { AuditLogEntry, HoneyPotStats } from "./Honeypot/index";
+export type { CommandContext, CommandMode, CommandOutcome, CommandResult, NanoEditorSession, ShellEnv, ShellModule, SudoChallenge } from "./types/commands";
 export type { ExecStream, ShellStream } from "./types/streams";
-export type { RemoveOptions, VfsBaseNode, VfsDirectoryNode, VfsFileNode, VfsNodeStats, VfsNodeType, VfsSnapshot, VfsSnapshotBaseNode, VfsSnapshotDirectoryNode, VfsSnapshotFileNode, VfsSnapshotNode, WriteFileOptions, } from "./types/vfs";
+export type { RemoveOptions, VfsBaseNode, VfsDirectoryNode, VfsFileNode, VfsNodeStats, VfsNodeType, VfsSnapshot, VfsSnapshotBaseNode, VfsSnapshotDirectoryNode, VfsSnapshotFileNode, VfsSnapshotNode, WriteFileOptions } from "./types/vfs";
 export type { VfsOptions, VfsPersistenceMode } from "./VirtualFileSystem/index";
-export type { PackageDefinition, PackageFile, InstalledPackage, } from "./VirtualPackageManager/index";
-export { HoneyPot, SshClient, VirtualFileSystem, SftpMimic as VirtualSftpServer, VirtualShell, SshMimic as VirtualSshServer, VirtualUserManager, VirtualPackageManager, };
-export { getArg, getFlag, ifFlag, } from "./commands/command-helpers";
+export type { ShellProperties } from "./VirtualShell/index";
+export type { InstalledPackage, PackageDefinition, PackageFile } from "./VirtualPackageManager/index";
+export { assertDiff, diffSnapshots, formatDiff } from "./utils/vfsDiff";
+export type { VfsDiff, VfsDiffEntry, VfsDiffModified } from "./utils/vfsDiff";
+export { getArg, getFlag, ifFlag } from "./commands/command-helpers";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,iBAAiB,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,YAAY,EACX,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,YAAY,EACX,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,SAAS,IAAI,iBAAiB,EAC9B,YAAY,EACZ,QAAQ,IAAI,gBAAgB,EAC5B,kBAAkB,EAClB,qBAAqB,GACrB,CAAC;AAEF,OAAO,EACN,MAAM,EACN,OAAO,EACP,MAAM,GACN,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,YAAY,EACX,aAAa,EACb,aAAa,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY,EACX,gBAAgB,EAAE,iBAAiB,EACnC,WAAW,EACX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,UAAU,EAAE,aAAa,EACzB,UAAU,EACV,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,OAAO,EACP,YAAY,EACZ,eAAe,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,9 +1,9 @@
-import { HoneyPot } from "./Honeypot/index";
-import { SshClient } from "./SSHClient/index";
-import { SftpMimic, SshMimic } from "./SSHMimic/index";
-import VirtualFileSystem from "./VirtualFileSystem/index";
-import { VirtualShell } from "./VirtualShell/index";
-import { VirtualUserManager } from "./VirtualUserManager/index";
-import { VirtualPackageManager } from "./VirtualPackageManager/index";
-export { HoneyPot, SshClient, VirtualFileSystem, SftpMimic as VirtualSftpServer, VirtualShell, SshMimic as VirtualSshServer, VirtualUserManager, VirtualPackageManager, };
-export { getArg, getFlag, ifFlag, } from "./commands/command-helpers";
+export { HoneyPot } from "./Honeypot/index";
+export { SshClient } from "./SSHClient/index";
+export { SftpMimic as VirtualSftpServer, SshMimic as VirtualSshServer } from "./SSHMimic/index";
+export { default as VirtualFileSystem } from "./VirtualFileSystem/index";
+export { VirtualPackageManager } from "./VirtualPackageManager/index";
+export { VirtualShell } from "./VirtualShell/index";
+export { VirtualUserManager } from "./VirtualUserManager/index";
+export { assertDiff, diffSnapshots, formatDiff } from "./utils/vfsDiff";
+export { getArg, getFlag, ifFlag } from "./commands/command-helpers";

package/dist/modules/linuxRootfs.d.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/style/useNamingConvention: ENV VAR KEYS */
 /**
  * linuxRootfs.ts
  *
@@ -8,8 +9,24 @@
 import type { ShellProperties } from "../VirtualShell";
 import type VirtualFileSystem from "../VirtualFileSystem";
 import type { VirtualUserManager } from "../VirtualUserManager";
+/**
+ * Sync `/etc/passwd`, `/etc/group`, and `/etc/shadow` from the
+ * VirtualUserManager's current user list into the VFS.
+ * @param vfs VirtualFileSystem instance to write files into
+ * @param users VirtualUserManager to source users from
+ */
 export declare function syncEtcPasswd(vfs: VirtualFileSystem, users: VirtualUserManager): void;
-export declare function refreshProc(vfs: VirtualFileSystem, props: ShellProperties, hostname: string, shellStartTime: number): void;
+/**
+ * Populate and refresh `/proc` virtual entries based on host stats and
+ * provided active sessions. Rewrites `/proc/uptime`, `/proc/meminfo`,
+ * `/proc/cpuinfo`, `/proc/<pid>` entries and `/proc/self` content.
+ * @param vfs VirtualFileSystem instance
+ * @param props ShellProperties used for version strings
+ * @param hostname Hostname to write into /proc/hostname
+ * @param shellStartTime Start time used to compute uptime
+ * @param sessions Optional active sessions list to populate per-pid entries
+ */
+export declare function refreshProc(vfs: VirtualFileSystem, props: ShellProperties, hostname: string, shellStartTime: number, sessions?: import("../VirtualUserManager").VirtualActiveSession[]): void;
 /**
  * Bootstraps the full Linux rootfs hierarchy in the VFS.
  * Safe to call multiple times — idempotent.

package/dist/modules/linuxRootfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linuxRootfs.d.ts","sourceRoot":"","sources":["../../src/modules/linuxRootfs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAyHhE,wBAAgB,aAAa,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,GACvB,IAAI,CAsCN;AAID,wBAAgB,WAAW,CAC1B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACpB,IAAI,CA6DN;AAuKD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,GACpB,IAAI,CAYN"}
+{"version":3,"file":"linuxRootfs.d.ts","sourceRoot":"","sources":["../../src/modules/linuxRootfs.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAgHhE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,GACvB,IAAI,CAsCN;AAgED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,OAAO,uBAAuB,EAAE,oBAAoB,EAAE,GAC/D,IAAI,CAmJN;AAuND;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,GACpB,IAAI,CAYN"}

package/dist/modules/linuxRootfs.js

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/style/useNamingConvention: ENV VAR KEYS */
 /**
  * linuxRootfs.ts
  *
@@ -36,12 +37,7 @@ function bootstrapEtc(vfs, hostname, props) {
         "export PS1='\\u@\\h:\\w\\$ '",
     ].join("\n")}\n`);
     ensureFile(vfs, "/etc/issue", `Fortune GNU/Linux 1.0 \\n \\l\n`);
-    ensureFile(vfs, "/etc/motd", [
-        "",
-        `Welcome to ${props.os}`,
-        `Kernel: ${props.kernel}`,
-        "",
-    ].join("\n"));
+    ensureFile(vfs, "/etc/motd", ["", `Welcome to ${props.os}`, `Kernel: ${props.kernel}`, ""].join("\n"));
     // APT sources
     ensureDir(vfs, "/etc/apt");
     ensureDir(vfs, "/etc/apt/sources.list.d");
@@ -71,6 +67,12 @@ function bootstrapEtc(vfs, hostname, props) {
     ensureDir(vfs, "/etc/systemd/system");
 }
 // ─── /etc/passwd + /etc/group + /etc/shadow ─────────────────────────────────
+/**
+ * Sync `/etc/passwd`, `/etc/group`, and `/etc/shadow` from the
+ * VirtualUserManager's current user list into the VFS.
+ * @param vfs VirtualFileSystem instance to write files into
+ * @param users VirtualUserManager to source users from
+ */
 export function syncEtcPasswd(vfs, users) {
     const userList = users.listUsers();
     const passwdLines = [
@@ -108,7 +110,53 @@ export function syncEtcPasswd(vfs, users) {
     vfs.writeFile("/etc/shadow", `${shadowLines.join("\n")}\n`, { mode: 0o640 });
 }
 // ─── /proc ───────────────────────────────────────────────────────────────────
-export function refreshProc(vfs, props, hostname, shellStartTime) {
+/** Derive a stable virtual PID from a tty string like "pts/0" → 1000, "pts/1" → 1001 */
+function ttyToPid(tty) {
+    const match = tty.match(/(\d+)$/);
+    return 1000 + (match?.[1] ? parseInt(match[1], 10) : 0);
+}
+/** Write /proc/<pid>/ subtree for a single virtual process */
+function writeProcPid(vfs, pid, username, _tty, cmdline, startedAt, env) {
+    const dir = `/proc/${pid}`;
+    ensureDir(vfs, dir);
+    ensureDir(vfs, `${dir}/fd`);
+    ensureDir(vfs, `${dir}/fdinfo`);
+    const uptimeSec = Math.floor((Date.now() - new Date(startedAt).getTime()) / 1000);
+    vfs.writeFile(`${dir}/cmdline`, `${cmdline.replace(/\s+/g, "\0")}\0`);
+    vfs.writeFile(`${dir}/comm`, cmdline.split(/\s+/)[0] ?? "bash");
+    vfs.writeFile(`${dir}/status`, `${[
+        `Name:   ${cmdline.split(/\s+/)[0] ?? "bash"}`,
+        `State:  S (sleeping)`,
+        `Pid:    ${pid}`,
+        `PPid:   1`,
+        `Uid:    0\t0\t0\t0`,
+        `Gid:    0\t0\t0\t0`,
+        `VmRSS:  4096 kB`,
+        `VmSize: 16384 kB`,
+        `Threads: 1`,
+    ].join("\n")}\n`);
+    vfs.writeFile(`${dir}/stat`, `${pid} (${cmdline.split(/\s+/)[0] ?? "bash"}) S 1 ${pid} ${pid} 0 -1 4194304 0 0 0 0 ${uptimeSec} 0 0 0 20 0 1 0 0 16384 4096 0\n`);
+    vfs.writeFile(`${dir}/environ`, `${Object.entries(env)
+        .map(([k, v]) => `${k}=${v}`)
+        .join("\0")}\0`);
+    vfs.writeFile(`${dir}/cwd`, `/home/${username}\0`);
+    vfs.writeFile(`${dir}/exe`, "/bin/bash\0");
+    // Standard fd entries
+    vfs.writeFile(`${dir}/fd/0`, "");
+    vfs.writeFile(`${dir}/fd/1`, "");
+    vfs.writeFile(`${dir}/fd/2`, "");
+}
+/**
+ * Populate and refresh `/proc` virtual entries based on host stats and
+ * provided active sessions. Rewrites `/proc/uptime`, `/proc/meminfo`,
+ * `/proc/cpuinfo`, `/proc/<pid>` entries and `/proc/self` content.
+ * @param vfs VirtualFileSystem instance
+ * @param props ShellProperties used for version strings
+ * @param hostname Hostname to write into /proc/hostname
+ * @param shellStartTime Start time used to compute uptime
+ * @param sessions Optional active sessions list to populate per-pid entries
+ */
+export function refreshProc(vfs, props, hostname, shellStartTime, sessions) {
     ensureDir(vfs, "/proc");
     const uptimeSec = Math.floor((Date.now() - shellStartTime) / 1000);
     vfs.writeFile("/proc/uptime", `${uptimeSec}.00 ${Math.floor(uptimeSec * 0.9)}.00\n`);
@@ -130,7 +178,7 @@ export function refreshProc(vfs, props, hostname, shellStartTime) {
         const c = cpus[i];
         if (!c)
             continue;
-        const mhz = (c.speed).toFixed(3);
+        const mhz = c.speed.toFixed(3);
         cpuLines.push(`processor\t: ${i}`, `model name\t: ${c.model}`, `cpu MHz\t\t: ${mhz}`, `cache size\t: 8192 KB`, "");
     }
     vfs.writeFile("/proc/cpuinfo", `${cpuLines.join("\n")}\n`);
@@ -138,7 +186,8 @@ export function refreshProc(vfs, props, hostname, shellStartTime) {
     vfs.writeFile("/proc/hostname", `${hostname}\n`);
     // /proc/loadavg
     const load = (Math.random() * 0.5).toFixed(2);
-    vfs.writeFile("/proc/loadavg", `${load} ${load} ${load} 1/1 1\n`);
+    const numProcs = 1 + (sessions?.length ?? 0);
+    vfs.writeFile("/proc/loadavg", `${load} ${load} ${load} ${numProcs}/${numProcs} 1\n`);
     // /proc/net stubs
     ensureDir(vfs, "/proc/net");
     ensureFile(vfs, "/proc/net/dev", `${[
@@ -147,6 +196,61 @@ export function refreshProc(vfs, props, hostname, shellStartTime) {
         "    lo:       0       0    0    0    0     0          0         0        0       0    0    0    0     0       0          0",
         "  eth0:  131072    1024    0    0    0     0          0         0    65536     512    0    0    0     0       0          0",
     ].join("\n")}\n`);
+    // ── /proc/1 — init process ────────────────────────────────────────────────
+    writeProcPid(vfs, 1, "root", "pts/0", "/sbin/init", new Date(shellStartTime).toISOString(), {});
+    // ── /proc/<pid> per session ───────────────────────────────────────────────
+    const activeSessions = sessions ?? [];
+    for (const session of activeSessions) {
+        const pid = ttyToPid(session.tty);
+        writeProcPid(vfs, pid, session.username, session.tty, "bash", session.startedAt, {
+            USER: session.username,
+            HOME: `/home/${session.username}`,
+            TERM: "xterm-256color",
+            SHELL: "/bin/bash",
+        });
+    }
+    // ── /proc/self — symlink to current session PID or 1 ────────────────────
+    // We can't know which session is "current" at populate time,
+    // so /proc/self is a directory that mirrors the most recent session,
+    // or init if no sessions. Commands that read /proc/self get consistent data.
+    const selfPid = activeSessions.length > 0
+        ? ttyToPid(activeSessions[activeSessions.length - 1].tty)
+        : 1;
+    // Remove existing /proc/self and recreate as content copy
+    if (vfs.exists("/proc/self")) {
+        try {
+            vfs.remove("/proc/self");
+        }
+        catch { }
+    }
+    // /proc/self is a real directory (not a symlink, which VFS may not support for dirs)
+    const selfSrc = `/proc/${selfPid}`;
+    if (vfs.exists(selfSrc)) {
+        ensureDir(vfs, "/proc/self");
+        ensureDir(vfs, "/proc/self/fd");
+        for (const entry of vfs.list(selfSrc)) {
+            const srcPath = `${selfSrc}/${entry}`;
+            const dstPath = `/proc/self/${entry}`;
+            try {
+                const st = vfs.stat(srcPath);
+                if (st.type === "file") {
+                    vfs.writeFile(dstPath, vfs.readFile(srcPath));
+                }
+            }
+            catch { }
+        }
+        vfs.writeFile("/proc/self/status", vfs.exists(`${selfSrc}/status`) ? vfs.readFile(`${selfSrc}/status`) : "");
+    }
+    else {
+        // Fallback minimal /proc/self
+        ensureDir(vfs, "/proc/self");
+        vfs.writeFile("/proc/self/cmdline", "bash\0");
+        vfs.writeFile("/proc/self/comm", "bash");
+        vfs.writeFile("/proc/self/status", "Name:\tbash\nState:\tS (sleeping)\nPid:\t1\nPPid:\t0\n");
+        vfs.writeFile("/proc/self/environ", "");
+        vfs.writeFile("/proc/self/cwd", "/root\0");
+        vfs.writeFile("/proc/self/exe", "/bin/bash\0");
+    }
 }
 // ─── /sys ─────────────────────────────────────────────────────────────────────
 function bootstrapSys(vfs, props) {
@@ -191,18 +295,57 @@ function bootstrapUsr(vfs) {
     ensureDir(vfs, "/usr/lib");
     // Stub binaries so `which` can find built-in commands
     const builtins = [
-        "sh", "bash", "ls", "cat", "echo", "grep", "find", "sort",
-        "head", "tail", "cut", "tr", "sed", "awk", "wc", "tee",
-        "tar", "gzip", "gunzip", "touch", "mkdir", "rm", "mv", "cp",
-        "chmod", "ln", "pwd", "env", "date", "sleep", "id", "whoami",
-        "hostname", "uname", "ps", "kill", "df", "du", "curl", "wget",
-        "nano", "diff", "uniq", "xargs", "base64",
+        "sh",
+        "bash",
+        "ls",
+        "cat",
+        "echo",
+        "grep",
+        "find",
+        "sort",
+        "head",
+        "tail",
+        "cut",
+        "tr",
+        "sed",
+        "awk",
+        "wc",
+        "tee",
+        "tar",
+        "gzip",
+        "gunzip",
+        "touch",
+        "mkdir",
+        "rm",
+        "mv",
+        "cp",
+        "chmod",
+        "ln",
+        "pwd",
+        "env",
+        "date",
+        "sleep",
+        "id",
+        "whoami",
+        "hostname",
+        "uname",
+        "ps",
+        "kill",
+        "df",
+        "du",
+        "curl",
+        "wget",
+        "nano",
+        "diff",
+        "uniq",
+        "xargs",
+        "base64",
     ];
     for (const bin of builtins) {
         ensureFile(vfs, `/usr/bin/${bin}`, `#!/bin/sh\nexec builtin ${bin} "$@"\n`, 0o755);
     }
     // lsb_release script
-    ensureFile(vfs, "/usr/bin/lsb_release", "#!/bin/sh\nexec lsb_release \"$@\"\n", 0o755);
+    ensureFile(vfs, "/usr/bin/lsb_release", '#!/bin/sh\nexec lsb_release "$@"\n', 0o755);
 }
 // ─── /var ─────────────────────────────────────────────────────────────────────
 function bootstrapVar(vfs) {
@@ -292,6 +435,6 @@ export function bootstrapLinuxRootfs(vfs, users, hostname, props, shellStartTime
     bootstrapTmp(vfs);
     bootstrapRoot(vfs);
     bootstrapMisc(vfs);
-    refreshProc(vfs, props, hostname, shellStartTime);
+    refreshProc(vfs, props, hostname, shellStartTime, []);
     syncEtcPasswd(vfs, users);
 }

package/dist/standalone-wo-sftp.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standalone-wo-sftp.d.ts.map

package/dist/standalone-wo-sftp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-wo-sftp.d.ts","sourceRoot":"","sources":["../src/standalone-wo-sftp.ts"],"names":[],"mappings":""}

package/dist/standalone-wo-sftp.js

@@ -0,0 +1,30 @@
+import { SshMimic } from "./SSHMimic/index";
+import { VirtualShell } from "./VirtualShell";
+const hostname = process.env.SSH_MIMIC_HOSTNAME ?? "typescript-vm";
+const virtualShell = new VirtualShell(hostname, undefined, {
+    mode: "fs",
+    snapshotPath: ".vfs",
+});
+virtualShell.addCommand("demo", [], () => {
+    return {
+        stdout: "This is a demo command. It does nothing useful.",
+        exitCode: 0,
+    };
+});
+new SshMimic({
+    port: 2222,
+    hostname,
+    shell: virtualShell,
+})
+    .start()
+    .catch((error) => {
+    console.error("Failed to start SSH Mimic:", error);
+    process.exit(1);
+});
+process.on("uncaughtException", (error) => {
+    console.log("Oh my god, something terrible happened: ", error);
+});
+process.on("unhandledRejection", (error, promise) => {
+    console.log(" Oh Lord! We forgot to handle a promise rejection here: ", promise);
+    console.log(" The error was: ", error);
+});

package/dist/utils/expand.d.ts

@@ -0,0 +1,50 @@
+/**
+ * expand.ts
+ *
+ * Centralised shell variable and expression expansion.
+ * Used by `runCommand` (index.ts), `echo`, and `sh.ts`.
+ *
+ * Handles (in order):
+ *   ~             tilde to $HOME
+ *   $?            last exit code
+ *   $$            mock PID
+ *   $#            argument count (0 outside scripts)
+ *   ${#VAR}       string length
+ *   ${VAR:-def}   default if unset/empty
+ *   ${VAR:=def}   assign default if unset/empty
+ *   ${VAR:+val}   alternate value if set
+ *   ${VAR}        simple braced reference
+ *   $VAR          simple reference
+ *   $((expr))     arithmetic (integer)
+ */
+/**
+ * Evaluate a simple integer arithmetic expression.
+ * Supports: +  -  *  /  %  **  unary-  ( )
+ * Variables are resolved from `env` before evaluation.
+ * Returns NaN on syntax error.
+ */
+export declare function evalArith(expr: string, env: Record<string, string>): number;
+/**
+ * Expand all shell variable and expression forms synchronously.
+ * Does NOT handle `$(cmd)` — that requires async; see `expandAsync`.
+ * Content inside single quotes is left verbatim per POSIX sh rules.
+ *
+ * @param input     Raw string possibly containing `$VAR`, `${...}`, `$((...))`.
+ * @param env       Current session env vars.
+ * @param lastExit  Last command exit code (for `$?`).
+ * @param home      Home directory path (for `~`).
+ */
+export declare function expandSync(input: string, env: Record<string, string>, lastExit?: number, home?: string): string;
+/**
+ * Expand all shell forms including `$(cmd)` command substitution.
+ *
+ * Processes `$(...)` blocks depth-first, respecting single-quote boundaries.
+ * Then delegates to `expandSync` for the remaining forms.
+ *
+ * @param input     Raw string.
+ * @param env       Current session env vars.
+ * @param lastExit  Last exit code.
+ * @param runCmd    Async callback to execute a command and return its stdout.
+ */
+export declare function expandAsync(input: string, env: Record<string, string>, lastExit: number, runCmd: (cmd: string) => Promise<string>): Promise<string>;
+//# sourceMappingURL=expand.d.ts.map

package/dist/utils/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/utils/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuB3E;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,SAAI,EACZ,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CA4DR;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAuDjB"}

package/dist/utils/expand.js

@@ -0,0 +1,183 @@
+/**
+ * expand.ts
+ *
+ * Centralised shell variable and expression expansion.
+ * Used by `runCommand` (index.ts), `echo`, and `sh.ts`.
+ *
+ * Handles (in order):
+ *   ~             tilde to $HOME
+ *   $?            last exit code
+ *   $$            mock PID
+ *   $#            argument count (0 outside scripts)
+ *   ${#VAR}       string length
+ *   ${VAR:-def}   default if unset/empty
+ *   ${VAR:=def}   assign default if unset/empty
+ *   ${VAR:+val}   alternate value if set
+ *   ${VAR}        simple braced reference
+ *   $VAR          simple reference
+ *   $((expr))     arithmetic (integer)
+ */
+// ─── arithmetic evaluator ────────────────────────────────────────────────────
+/**
+ * Evaluate a simple integer arithmetic expression.
+ * Supports: +  -  *  /  %  **  unary-  ( )
+ * Variables are resolved from `env` before evaluation.
+ * Returns NaN on syntax error.
+ */
+export function evalArith(expr, env) {
+    // Substitute variable names before evaluating
+    const substituted = expr.replace(/\b([A-Za-z_][A-Za-z0-9_]*)\b/g, (_, name) => {
+        const val = env[name];
+        return val !== undefined && val !== "" ? val : "0";
+    });
+    // Whitelist: only digits, operators, spaces, parens
+    if (!/^[\d\s+\-*/%()^!&|<>=,. ]+$/.test(substituted))
+        return NaN;
+    try {
+        // Use Function constructor for safe subset (no identifiers remain)
+        // eslint-disable-next-line no-new-func
+        const result = Function(`"use strict"; return (${substituted.replace(/\*\*/g, "**")});`)();
+        return typeof result === "number" ? Math.trunc(result) : NaN;
+    }
+    catch {
+        return NaN;
+    }
+}
+// ─── synchronous expansion ───────────────────────────────────────────────────
+/**
+ * Apply a replacer only to portions of `input` that are NOT inside single quotes.
+ * Single-quoted content is passed through verbatim (POSIX sh behaviour).
+ */
+function outsideSingleQuotes(input, replacer) {
+    const parts = [];
+    let i = 0;
+    while (i < input.length) {
+        const sqIdx = input.indexOf("'", i);
+        if (sqIdx === -1) {
+            // No more single quotes — expand the rest
+            parts.push(replacer(input.slice(i)));
+            break;
+        }
+        // Expand the part before the single quote
+        parts.push(replacer(input.slice(i, sqIdx)));
+        // Find closing single quote — everything inside is literal
+        const closeIdx = input.indexOf("'", sqIdx + 1);
+        if (closeIdx === -1) {
+            // Unclosed quote — treat rest as literal
+            parts.push(input.slice(sqIdx));
+            break;
+        }
+        parts.push(input.slice(sqIdx, closeIdx + 1)); // include quotes
+        i = closeIdx + 1;
+    }
+    return parts.join("");
+}
+/**
+ * Expand all shell variable and expression forms synchronously.
+ * Does NOT handle `$(cmd)` — that requires async; see `expandAsync`.
+ * Content inside single quotes is left verbatim per POSIX sh rules.
+ *
+ * @param input     Raw string possibly containing `$VAR`, `${...}`, `$((...))`.
+ * @param env       Current session env vars.
+ * @param lastExit  Last command exit code (for `$?`).
+ * @param home      Home directory path (for `~`).
+ */
+export function expandSync(input, env, lastExit = 0, home) {
+    const homePath = home ?? env.HOME ?? "/home/user";
+    return outsideSingleQuotes(input, (chunk) => {
+        let s = chunk;
+        // Tilde expansion — only at start of token or after `:` or whitespace
+        s = s.replace(/(^|[\s:])~(\/|$)/g, (_, pre, post) => `${pre}${homePath}${post}`);
+        // $? $$ $#
+        s = s.replace(/\$\?/g, String(lastExit));
+        s = s.replace(/\$\$/g, "1");
+        s = s.replace(/\$#/g, "0");
+        // $(( arithmetic )) — must come before ${ and $VAR to avoid conflicts
+        s = s.replace(/\$\(\(([^)]+(?:\([^)]*\)[^)]*)*)\)\)/g, (_, expr) => {
+            const result = evalArith(expr, env);
+            return Number.isNaN(result) ? "0" : String(result);
+        });
+        // ${#VAR} — string length
+        s = s.replace(/\$\{#([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, name) => String((env[name] ?? "").length));
+        // ${VAR:-default}
+        s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):-([^}]*)\}/g, (_, name, def) => env[name] !== undefined && env[name] !== "" ? env[name] : def);
+        // ${VAR:=default} — also assigns to env
+        s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):=([^}]*)\}/g, (_, name, def) => {
+            if (env[name] === undefined || env[name] === "")
+                env[name] = def;
+            return env[name];
+        });
+        // ${VAR:+alternate}
+        s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):\+([^}]*)\}/g, (_, name, alt) => env[name] !== undefined && env[name] !== "" ? alt : "");
+        // ${VAR}
+        s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, name) => env[name] ?? "");
+        // $VAR
+        s = s.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => env[name] ?? "");
+        return s;
+    });
+}
+// ─── async expansion (includes $(cmd)) ──────────────────────────────────────
+/**
+ * Expand all shell forms including `$(cmd)` command substitution.
+ *
+ * Processes `$(...)` blocks depth-first, respecting single-quote boundaries.
+ * Then delegates to `expandSync` for the remaining forms.
+ *
+ * @param input     Raw string.
+ * @param env       Current session env vars.
+ * @param lastExit  Last exit code.
+ * @param runCmd    Async callback to execute a command and return its stdout.
+ */
+export async function expandAsync(input, env, lastExit, runCmd) {
+    // $(cmd) substitution — skip content inside single quotes
+    if (input.includes("$(")) {
+        let result = "";
+        let inSingle = false;
+        let i = 0;
+        while (i < input.length) {
+            const ch = input[i];
+            if (ch === "'" && !inSingle) {
+                inSingle = true;
+                result += ch;
+                i++;
+                continue;
+            }
+            if (ch === "'" && inSingle) {
+                inSingle = false;
+                result += ch;
+                i++;
+                continue;
+            }
+            if (!inSingle && ch === "$" && input[i + 1] === "(") {
+                // $((expr)) arithmetic — NOT a $(cmd) substitution, skip it
+                if (input[i + 2] === "(") {
+                    result += ch;
+                    i++;
+                    continue;
+                }
+                // Find matching ) with depth tracking
+                let depth = 0;
+                let j = i + 1;
+                while (j < input.length) {
+                    if (input[j] === "(")
+                        depth++;
+                    else if (input[j] === ")") {
+                        depth--;
+                        if (depth === 0)
+                            break;
+                    }
+                    j++;
+                }
+                const sub = input.slice(i + 2, j).trim();
+                const out = (await runCmd(sub)).replace(/\n$/, "");
+                result += out;
+                i = j + 1;
+                continue;
+            }
+            result += ch;
+            i++;
+        }
+        input = result;
+    }
+    return expandSync(input, env, lastExit);
+}