typescript-virtual-container 1.2.4 → 1.2.5

package/dist/VirtualShell/index.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import type { CommandContext, CommandResult } from "../types/commands";
 import type { ShellStream } from "../types/streams";
-import VirtualFileSystem from "../VirtualFileSystem";
+import VirtualFileSystem, { type VfsOptions } from "../VirtualFileSystem";
 import { VirtualUserManager } from "../VirtualUserManager";
 export interface ShellProperties {
     kernel: string;
@@ -15,7 +15,6 @@ export interface ShellProperties {
  * client API.
  */
 declare class VirtualShell extends EventEmitter {
-    basePath: string;
     vfs: VirtualFileSystem;
     users: VirtualUserManager;
     hostname: string;
@@ -26,9 +25,9 @@ declare class VirtualShell extends EventEmitter {
      *
      * @param hostname Virtual hostname used for prompts and idents.
      * @param properties Customizable properties shown in `uname -a` and similar commands.
-     * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
+     * @param vfsOptions Optional VFS persistence options (mode, snapshotPath).
      */
-    constructor(hostname: string, properties?: ShellProperties, basePath?: string);
+    constructor(hostname: string, properties?: ShellProperties, vfsOptions?: VfsOptions);
     /**
      * Ensures initialization is complete before allowing operations.
      * Call this before any authentication or command execution.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAmBD;;;;;GAKG;AACH,cAAM,YAAa,SAAQ,YAAY;IACtC,QAAQ,EAAE,MAAM,CAAO;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;;;OAMG;gBAEF,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM;IAsBlB;;;OAGG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/C;;;;;;OAMG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GACvE,IAAI;IASP;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMrE;;;;;;;OAOG;IAEH,uBAAuB,CACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAgBP;;;;OAIG;IACI,MAAM,IAAI,iBAAiB,GAAG,IAAI;IAIzC;;;;OAIG;IACI,QAAQ,IAAI,kBAAkB,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;;;OAMG;IACI,eAAe,CACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GACtB,IAAI;CAKP;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualShell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,iBAAiB,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAmBD;;;;;GAKG;AACH,cAAM,YAAa,SAAQ,YAAY;IACtC,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,WAAW,CAAgB;IAEnC;;;;;;OAMG;gBAEF,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,eAAe,EAC5B,UAAU,CAAC,EAAE,UAAU;IAqBxB;;;OAGG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/C;;;;;;OAMG;IACH,UAAU,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GACvE,IAAI;IASP;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMrE;;;;;;;OAOG;IAEH,uBAAuB,CACtB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAgBP;;;;OAIG;IACI,MAAM,IAAI,iBAAiB,GAAG,IAAI;IAIzC;;;;OAIG;IACI,QAAQ,IAAI,kBAAkB,GAAG,IAAI;IAI5C;;;;OAIG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;;;OAMG;IACI,eAAe,CACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GACtB,IAAI;CAKP;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/VirtualShell/index.js

@@ -1,7 +1,7 @@
 import { EventEmitter } from "node:events";
 import { createCustomCommand, registerCommand, runCommand } from "../commands";
 import { createPerfLogger } from "../utils/perfLogger";
-import VirtualFileSystem from "../VirtualFileSystem";
+import VirtualFileSystem, {} from "../VirtualFileSystem";
 import { VirtualUserManager } from "../VirtualUserManager";
 import { startShell } from "./shell";
 const defaultShellProperties = {
@@ -24,7 +24,6 @@ function resolveAutoSudoForNewUsers() {
  * client API.
  */
 class VirtualShell extends EventEmitter {
-    basePath = ".";
     vfs;
     users;
     hostname;
@@ -35,15 +34,14 @@ class VirtualShell extends EventEmitter {
      *
      * @param hostname Virtual hostname used for prompts and idents.
      * @param properties Customizable properties shown in `uname -a` and similar commands.
-     * @param basePath Optional base path for the virtual filesystem (defaults to process.cwd()).
+     * @param vfsOptions Optional VFS persistence options (mode, snapshotPath).
      */
-    constructor(hostname, properties, basePath) {
+    constructor(hostname, properties, vfsOptions) {
         super();
         perf.mark("constructor");
         this.hostname = hostname;
         this.properties = properties || defaultShellProperties;
-        this.basePath = basePath || ".";
-        this.vfs = new VirtualFileSystem(this.basePath);
+        this.vfs = new VirtualFileSystem(vfsOptions ?? {});
         this.users = new VirtualUserManager(this.vfs, resolveAutoSudoForNewUsers());
         // Store references to avoid TypeScript "used before assigned" errors
         const vfs = this.vfs;

package/dist/VirtualUserManager/index.d.ts

@@ -189,5 +189,30 @@ export declare class VirtualUserManager extends EventEmitter {
     hashPassword(password: string): string;
     private validateUsername;
     private validatePassword;
+    private readonly authorizedKeys;
+    /**
+     * Adds an SSH public key for a user, enabling public-key authentication.
+     *
+     * @param username Target user.
+     * @param algo Key algorithm (e.g. "ssh-rsa", "ssh-ed25519").
+     * @param data Raw key data as a Buffer (the base64-decoded key bytes).
+     */
+    addAuthorizedKey(username: string, algo: string, data: Buffer): void;
+    /**
+     * Removes all authorized keys for a user.
+     *
+     * @param username Target user.
+     */
+    removeAuthorizedKeys(username: string): void;
+    /**
+     * Returns the list of authorized keys for a user.
+     * Returns an empty array when no keys are registered.
+     *
+     * @param username Target user.
+     */
+    getAuthorizedKeys(username: string): Array<{
+        algo: string;
+        data: Buffer;
+    }>;
 }
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/VirtualUserManager/index.js

@@ -505,6 +505,39 @@ export class VirtualUserManager extends EventEmitter {
             throw new Error("invalid password");
         }
     }
+    authorizedKeys = new Map();
+    /**
+     * Adds an SSH public key for a user, enabling public-key authentication.
+     *
+     * @param username Target user.
+     * @param algo Key algorithm (e.g. "ssh-rsa", "ssh-ed25519").
+     * @param data Raw key data as a Buffer (the base64-decoded key bytes).
+     */
+    addAuthorizedKey(username, algo, data) {
+        perf.mark("addAuthorizedKey");
+        const keys = this.authorizedKeys.get(username) ?? [];
+        keys.push({ algo, data });
+        this.authorizedKeys.set(username, keys);
+        this.emit("key:add", { username, algo });
+    }
+    /**
+     * Removes all authorized keys for a user.
+     *
+     * @param username Target user.
+     */
+    removeAuthorizedKeys(username) {
+        this.authorizedKeys.delete(username);
+        this.emit("key:remove", { username });
+    }
+    /**
+     * Returns the list of authorized keys for a user.
+     * Returns an empty array when no keys are registered.
+     *
+     * @param username Target user.
+     */
+    getAuthorizedKeys(username) {
+        return this.authorizedKeys.get(username) ?? [];
+    }
 }
 function normalizeVfsPath(targetPath) {
     const normalized = path.posix.normalize(targetPath);

package/dist/commands/chmod.d.ts

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

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

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

package/dist/commands/chmod.js

@@ -0,0 +1,31 @@
+import { assertPathAccess, resolvePath } from "./helpers";
+export const chmodCommand = {
+    name: "chmod",
+    params: ["<mode> <file>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const [modeArg, fileArg] = args;
+        if (!modeArg || !fileArg) {
+            return { stderr: "chmod: missing operand", exitCode: 1 };
+        }
+        const filePath = resolvePath(cwd, fileArg);
+        try {
+            assertPathAccess(authUser, filePath, "chmod");
+            if (!shell.vfs.exists(filePath)) {
+                return {
+                    stderr: `chmod: ${fileArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+            const mode = parseInt(modeArg, 8);
+            if (Number.isNaN(mode)) {
+                return { stderr: `chmod: invalid mode: ${modeArg}`, exitCode: 1 };
+            }
+            shell.vfs.chmod(filePath, mode);
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `chmod: ${msg}`, exitCode: 1 };
+        }
+    },
+};

package/dist/commands/cp.d.ts

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

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

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

package/dist/commands/cp.js

@@ -0,0 +1,68 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const cpCommand = {
+    name: "cp",
+    params: ["[-r] <source> <dest>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const recursive = ifFlag(args, ["-r", "-R", "--recursive"]);
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const [srcArg, destArg] = positionals;
+        if (!srcArg || !destArg) {
+            return { stderr: "cp: missing operand", exitCode: 1 };
+        }
+        const srcPath = resolvePath(cwd, srcArg);
+        const destPath = resolvePath(cwd, destArg);
+        try {
+            assertPathAccess(authUser, srcPath, "cp");
+            assertPathAccess(authUser, destPath, "cp");
+            if (!shell.vfs.exists(srcPath)) {
+                return {
+                    stderr: `cp: ${srcArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+            const srcStat = shell.vfs.stat(srcPath);
+            if (srcStat.type === "directory") {
+                if (!recursive) {
+                    return {
+                        stderr: `cp: ${srcArg}: is a directory (use -r)`,
+                        exitCode: 1,
+                    };
+                }
+                const copyDir = (from, to) => {
+                    shell.vfs.mkdir(to, 0o755);
+                    for (const entry of shell.vfs.list(from)) {
+                        const fromEntry = `${from}/${entry}`;
+                        const toEntry = `${to}/${entry}`;
+                        const stat = shell.vfs.stat(fromEntry);
+                        if (stat.type === "directory") {
+                            copyDir(fromEntry, toEntry);
+                        }
+                        else {
+                            const content = shell.vfs.readFileRaw(fromEntry);
+                            shell.writeFileAsUser(authUser, toEntry, content);
+                        }
+                    }
+                };
+                const finalDest = shell.vfs.exists(destPath) &&
+                    shell.vfs.stat(destPath).type === "directory"
+                    ? `${destPath}/${srcArg.split("/").pop()}`
+                    : destPath;
+                copyDir(srcPath, finalDest);
+            }
+            else {
+                const finalDest = shell.vfs.exists(destPath) &&
+                    shell.vfs.stat(destPath).type === "directory"
+                    ? `${destPath}/${srcArg.split("/").pop()}`
+                    : destPath;
+                const content = shell.vfs.readFileRaw(srcPath);
+                shell.writeFileAsUser(authUser, finalDest, content);
+            }
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `cp: ${msg}`, exitCode: 1 };
+        }
+    },
+};

package/dist/commands/find.d.ts

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

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

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

package/dist/commands/find.js

@@ -0,0 +1,48 @@
+import { getFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const findCommand = {
+    name: "find",
+    params: ["[path] [-name <pattern>] [-type f|d]"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const namePattern = getFlag(args, ["-name"]);
+        const typeFilter = getFlag(args, ["-type"]);
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== namePattern && a !== typeFilter);
+        const rootArg = positionals[0] ?? ".";
+        const rootPath = resolvePath(cwd, rootArg);
+        try {
+            assertPathAccess(authUser, rootPath, "find");
+            if (!shell.vfs.exists(rootPath)) {
+                return {
+                    stderr: `find: ${rootArg}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `find: ${msg}`, exitCode: 1 };
+        }
+        const nameRegex = namePattern
+            ? new RegExp(`^${namePattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".")}$`)
+            : null;
+        const results = [];
+        const walk = (currentPath, display) => {
+            const stat = shell.vfs.stat(currentPath);
+            const matchesType = !typeFilter ||
+                (typeFilter === "f" && stat.type === "file") ||
+                (typeFilter === "d" && stat.type === "directory");
+            const matchesName = !nameRegex || nameRegex.test(currentPath.split("/").pop() ?? "");
+            if (matchesType && matchesName)
+                results.push(display);
+            if (stat.type === "directory") {
+                for (const entry of shell.vfs.list(currentPath)) {
+                    const full = `${currentPath}/${entry}`;
+                    const disp = `${display}/${entry}`;
+                    walk(full, disp);
+                }
+            }
+        };
+        walk(rootPath, rootArg);
+        return { stdout: results.join("\n"), exitCode: 0 };
+    },
+};

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

@@ -1 +1 @@
-{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/commands/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA2EzB,CAAC"}
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/commands/grep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,WAAW,EAAE,WA2FzB,CAAC"}

package/dist/commands/grep.js

@@ -2,11 +2,15 @@ import { parseArgs } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const grepCommand = {
     name: "grep",
-    params: ["[-i] [-v] <pattern> [file...]"],
+    params: ["[-i] [-v] [-n] [-r] <pattern> [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
-        const { flags, positionals } = parseArgs(args, { flags: ["-i", "-v"] });
+        const { flags, positionals } = parseArgs(args, {
+            flags: ["-i", "-v", "-n", "-r"],
+        });
         const caseInsensitive = flags.has("-i");
         const invertMatch = flags.has("-v");
+        const showLineNumbers = flags.has("-n");
+        const recursive = flags.has("-r");
         const pattern = positionals[0];
         const files = positionals.slice(1);
         if (!pattern) {
@@ -14,51 +18,73 @@ export const grepCommand = {
         }
         let regex;
         try {
-            const flags = caseInsensitive ? "gmi" : "gm";
-            regex = new RegExp(pattern, flags);
+            // No "g" flag — avoids the stateful lastIndex problem with regex.test()
+            const regexFlags = caseInsensitive ? "mi" : "m";
+            regex = new RegExp(pattern, regexFlags);
         }
         catch {
             return { stderr: `grep: invalid regex: ${pattern}`, exitCode: 1 };
         }
-        const results = [];
-        if (files.length === 0) {
-            if (!stdin) {
-                return { stdout: "", exitCode: 1 };
-            }
-            const lines = stdin.split("\n");
-            for (const line of lines) {
-                regex.lastIndex = 0;
+        const matchLines = (content, prefix = "") => {
+            const lines = content.split("\n");
+            const out = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i] ?? "";
                 const matches = regex.test(line);
                 const shouldInclude = invertMatch ? !matches : matches;
                 if (shouldInclude) {
-                    results.push(line);
+                    const lineLabel = showLineNumbers ? `${i + 1}:` : "";
+                    out.push(`${prefix}${lineLabel}${line}`);
                 }
             }
-            return {
-                stdout: results.length > 0 ? results.join("\n") : "",
-                exitCode: results.length > 0 ? 0 : 1,
+            return out;
+        };
+        const readPaths = (base) => {
+            if (!shell.vfs.exists(base))
+                return [];
+            const stat = shell.vfs.stat(base);
+            if (stat.type === "file")
+                return [base];
+            if (!recursive)
+                return [];
+            const paths = [];
+            const walk = (dir) => {
+                for (const entry of shell.vfs.list(dir)) {
+                    const full = `${dir}/${entry}`;
+                    const s = shell.vfs.stat(full);
+                    if (s.type === "file")
+                        paths.push(full);
+                    else
+                        walk(full);
+                }
             };
+            walk(base);
+            return paths;
+        };
+        const results = [];
+        if (files.length === 0) {
+            if (!stdin)
+                return { stdout: "", exitCode: 1 };
+            results.push(...matchLines(stdin));
         }
-        for (const file of files) {
-            const target = resolvePath(cwd, file);
-            try {
-                assertPathAccess(authUser, target, "grep");
-                const content = shell.vfs.readFile(target);
-                const lines = content.split("\n");
-                for (const line of lines) {
-                    regex.lastIndex = 0;
-                    const matches = regex.test(line);
-                    const shouldInclude = invertMatch ? !matches : matches;
-                    if (shouldInclude) {
-                        results.push(line);
-                    }
+        else {
+            const resolvedPaths = files.flatMap((f) => {
+                const target = resolvePath(cwd, f);
+                return readPaths(target).map((p) => ({ file: f, path: p }));
+            });
+            for (const { file, path: filePath } of resolvedPaths) {
+                try {
+                    assertPathAccess(authUser, filePath, "grep");
+                    const content = shell.vfs.readFile(filePath);
+                    const prefix = resolvedPaths.length > 1 ? `${file}:` : "";
+                    results.push(...matchLines(content, prefix));
+                }
+                catch {
+                    return {
+                        stderr: `grep: ${file}: No such file or directory`,
+                        exitCode: 1,
+                    };
                 }
-            }
-            catch {
-                return {
-                    stderr: `grep: ${file}: No such file or directory`,
-                    exitCode: 1,
-                };
             }
         }
         return {

package/dist/commands/head.d.ts

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

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

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

package/dist/commands/head.js

@@ -0,0 +1,30 @@
+import { getFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const headCommand = {
+    name: "head",
+    params: ["[-n <lines>] [file...]"],
+    run: ({ authUser, shell, cwd, args, stdin }) => {
+        const nArg = getFlag(args, ["-n"]);
+        const n = typeof nArg === "string" ? parseInt(nArg, 10) : 10;
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== nArg);
+        const take = (content) => content.split("\n").slice(0, n).join("\n");
+        if (positionals.length === 0) {
+            return { stdout: take(stdin ?? ""), exitCode: 0 };
+        }
+        const results = [];
+        for (const file of positionals) {
+            const filePath = resolvePath(cwd, file);
+            try {
+                assertPathAccess(authUser, filePath, "head");
+                results.push(take(shell.vfs.readFile(filePath)));
+            }
+            catch {
+                return {
+                    stderr: `head: ${file}: No such file or directory`,
+                    exitCode: 1,
+                };
+            }
+        }
+        return { stdout: results.join("\n"), exitCode: 0 };
+    },
+};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,mBAAmB,CAAC;AAgG3B,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAsBzD;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,CAMb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAK1C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAKnE;AAsDD,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,GACZ,OAAO,CAAC,aAAa,CAAC,CA6DxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,mBAAmB,CAAC;AA0G3B,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBzD;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,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE;AAgDD,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,GACZ,OAAO,CAAC,aAAa,CAAC,CAqDxB"}