typescript-virtual-container 1.2.5 → 1.2.6

package/dist/commands/unset.js

@@ -1,15 +1,11 @@
-import { setEnvVar } from "./set";
 export const unsetCommand = {
     name: "unset",
-    params: ["<VAR...>"],
-    run: ({ args }) => {
-        if (args.length === 0) {
-            return { stderr: "unset: missing variable name", exitCode: 1 };
-        }
-        // Unset (remove) all specified variables
-        for (const varName of args) {
-            setEnvVar(varName, "");
-        }
+    description: "Remove shell variable",
+    category: "shell",
+    params: ["<VAR>"],
+    run: ({ args, env }) => {
+        for (const name of args)
+            delete env.vars[name];
         return { exitCode: 0 };
     },
 };

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

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

package/dist/commands/wc.js

@@ -2,6 +2,8 @@ import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const wcCommand = {
     name: "wc",
+    description: "Count words/lines/bytes",
+    category: "text",
     params: ["[-l] [-w] [-c] [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
         const lines = ifFlag(args, ["-l"]);

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

@@ -1 +1 @@
-{"version":3,"file":"wget.d.ts","sourceRoot":"","sources":["../../src/commands/wget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA8ErD,eAAO,MAAM,WAAW,EAAE,WA6DzB,CAAC"}
+{"version":3,"file":"wget.d.ts","sourceRoot":"","sources":["../../src/commands/wget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA8ErD,eAAO,MAAM,WAAW,EAAE,WA+DzB,CAAC"}

package/dist/commands/wget.js

@@ -61,6 +61,8 @@ function runHostWget(args) {
 }
 export const wgetCommand = {
     name: "wget",
+    description: "File downloader",
+    category: "network",
     params: ["[url]"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {

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

@@ -1 +1 @@
-{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../../src/commands/who.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WAcxB,CAAC"}
+{"version":3,"file":"who.d.ts","sourceRoot":"","sources":["../../src/commands/who.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WAgBxB,CAAC"}

package/dist/commands/who.js

@@ -1,6 +1,8 @@
 import { formatLoginDate } from "../SSHMimic/loginFormat";
 export const whoCommand = {
     name: "who",
+    description: "Show active sessions",
+    category: "system",
     params: [],
     run: ({ shell }) => {
         const lines = shell.users.listActiveSessions().map((session) => {

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

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

package/dist/commands/whoami.js

@@ -1,5 +1,7 @@
 export const whoamiCommand = {
     name: "whoami",
+    description: "Print current user",
+    category: "system",
     params: [],
     run: ({ authUser }) => ({ stdout: authUser, exitCode: 0 }),
 };

package/dist/commands/xargs.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/xargs.js

@@ -0,0 +1,16 @@
+import { runCommand } from "./index";
+export const xargsCommand = {
+    name: "xargs",
+    description: "Build and execute command lines from stdin",
+    category: "text",
+    params: ["[command] [args...]"],
+    run: async ({ authUser, hostname, mode, cwd, args, stdin, shell, env }) => {
+        const baseCmd = args[0] ?? "echo";
+        const extraArgs = args.slice(1);
+        const items = (stdin ?? "").trim().split(/\s+/).filter(Boolean);
+        if (items.length === 0)
+            return { exitCode: 0 };
+        const fullCmd = [baseCmd, ...extraArgs, ...items].join(" ");
+        return runCommand(fullCmd, authUser, hostname, mode, cwd, shell, undefined, env);
+    },
+};

package/dist/types/commands.d.ts

@@ -52,6 +52,13 @@ export interface NanoEditorSession {
     /** Initial editor content shown to user. */
     initialContent: string;
 }
+/** Per-session shell environment (variables, last exit code). */
+export interface ShellEnv {
+    /** Environment variables visible to commands. */
+    vars: Record<string, string>;
+    /** Exit status of the last executed command. */
+    lastExitCode: number;
+}
 /** Runtime context object passed to each command module. */
 export interface CommandContext {
     /** Authenticated user currently bound to stream. */
@@ -72,6 +79,8 @@ export interface CommandContext {
     stdin?: string;
     /** Current working directory for command execution. */
     cwd: string;
+    /** Per-session environment available to command modules. */
+    env: ShellEnv;
 }
 /** Contract implemented by each shell command module. */
 export interface ShellModule {
@@ -83,6 +92,10 @@ export interface ShellModule {
     run: (ctx: CommandContext) => CommandResult | Promise<CommandResult>;
     /** Optional alternative command names. */
     aliases?: string[];
+    /** Short description shown in `help`. */
+    description?: string;
+    /** Category used for grouped help output. */
+    category?: string;
 }
 /** Command return union allowing sync or async handlers. */
 export type CommandOutcome = CommandResult | Promise<CommandResult>;

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IACjC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"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"}

package/dist/types/pipeline.d.ts

@@ -11,6 +11,8 @@ export interface PipelineCommand {
     /** Append to output file (>> file) */
     appendOutput?: boolean;
 }
+/** Logical operator connecting two statement groups. */
+export type LogicalOp = "&&" | "||" | ";";
 /** Represents a parsed shell pipeline */
 export interface Pipeline {
     /** List of commands in the pipeline */
@@ -20,4 +22,22 @@ export interface Pipeline {
     /** Error message if parsing failed */
     error?: string;
 }
+/** A statement: one pipeline optionally followed by && / || / ; and the next statement */
+export interface Statement {
+    /** Pipeline to execute for this statement. */
+    pipeline: Pipeline;
+    /** Operator connecting this statement to the next one. */
+    op?: LogicalOp;
+    /** Optional next statement in sequence. */
+    next?: Statement;
+}
+/** Top-level parse result for a script. */
+export interface Script {
+    /** Statements contained in the script. */
+    statements: Statement[];
+    /** Whether the script was parsed successfully. */
+    isValid: boolean;
+    /** Optional parse error message. */
+    error?: string;
+}
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/types/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACtB,0CAA0C;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/SSHMimic/exec.ts

@@ -1,4 +1,4 @@
-import { runCommand } from "../commands";
+import { makeDefaultEnv, runCommand } from "../commands";
 import type { ExecStream } from "../types/streams";
 import type { VirtualShell } from "../VirtualShell";
 
@@ -17,7 +17,7 @@ export function runExec(
 	shell: VirtualShell,
 ): void {
 	Promise.resolve(
-		runCommand(cmd, authUser, hostname, "exec", `/home/${authUser}`, shell),
+		runCommand(cmd, authUser, hostname, "exec", `/home/${authUser}`, shell, undefined, makeDefaultEnv(authUser, hostname)),
 	)
 		.then((result) => {
 			if (result.stdout) {

package/src/SSHMimic/executor.ts

@@ -1,13 +1,79 @@
 import { runCommand as runSingleCommand } from "../commands";
 import { resolvePath } from "../commands/helpers";
-import type { CommandMode, CommandResult } from "../types/commands";
-import type { Pipeline, PipelineCommand } from "../types/pipeline";
+import type { CommandMode, CommandResult, ShellEnv } from "../types/commands";
+import type { Pipeline, PipelineCommand, Script, Statement } from "../types/pipeline";
 import type { VirtualShell } from "../VirtualShell";
 
-/**
- * Execute a parsed pipeline, chaining commands and handling redirections.
- * Manages stdout/stderr flow between commands and file I/O.
- */
+// ── Script executor (handles &&/||/;) ────────────────────────────────────────
+
+export async function executeScript(
+	script: Script,
+	authUser: string,
+	hostname: string,
+	mode: CommandMode,
+	cwd: string,
+	shell: VirtualShell,
+	env: ShellEnv,
+): Promise<CommandResult> {
+	if (!script.isValid) return { stderr: script.error || "Syntax error", exitCode: 1 };
+
+	let lastResult: CommandResult = { exitCode: 0 };
+
+	for (const stmt of script.statements) {
+		// Decide whether to run this statement based on previous op
+		lastResult = await executePipeline(stmt.pipeline, authUser, hostname, mode, cwd, shell, env);
+		env.lastExitCode = lastResult.exitCode ?? 0;
+
+		// Propagate session-control signals
+		if (lastResult.closeSession || lastResult.switchUser || lastResult.nextCwd) {
+			break;
+		}
+	}
+
+	return lastResult;
+}
+
+/** Execute statements connected by &&/||/; */
+export async function executeStatements(
+	statements: Statement[],
+	authUser: string,
+	hostname: string,
+	mode: CommandMode,
+	cwd: string,
+	shell: VirtualShell,
+	env: ShellEnv,
+): Promise<CommandResult> {
+	let last: CommandResult = { exitCode: 0 };
+	let i = 0;
+
+	while (i < statements.length) {
+		const stmt = statements[i]!;
+		last = await executePipeline(stmt.pipeline, authUser, hostname, mode, cwd, shell, env);
+		env.lastExitCode = last.exitCode ?? 0;
+
+		if (last.closeSession || last.switchUser) return last;
+
+		const op = stmt.op;
+		if (!op || op === ";") {
+			// always run next
+		} else if (op === "&&") {
+			if ((last.exitCode ?? 0) !== 0) {
+				// skip until next ; or end
+				while (i < statements.length && statements[i]?.op === "&&") i++;
+			}
+		} else if (op === "||") {
+			if ((last.exitCode ?? 0) === 0) {
+				// skip until next ; or end
+				while (i < statements.length && statements[i]?.op === "||") i++;
+			}
+		}
+		i++;
+	}
+	return last;
+}
+
+// ── Pipeline executor ─────────────────────────────────────────────────────────
+
 export async function executePipeline(
 	pipeline: Pipeline,
 	authUser: string,
@@ -15,37 +81,26 @@ export async function executePipeline(
 	mode: CommandMode,
 	cwd: string,
 	shell: VirtualShell,
+	env?: ShellEnv,
 ): Promise<CommandResult> {
-	if (pipeline.commands.length === 0) {
-		return { exitCode: 0 };
-	}
+	if (!pipeline.isValid) return { stderr: pipeline.error || "Syntax error", exitCode: 1 };
+	if (pipeline.commands.length === 0) return { exitCode: 0 };
+
+	const shellEnv: ShellEnv = env ?? { vars: {}, lastExitCode: 0 };
 
 	if (pipeline.commands.length === 1) {
-		// Single command with possible redirections
 		return executeSingleCommandWithRedirections(
 			pipeline.commands[0] as PipelineCommand,
-			authUser,
-			hostname,
-			mode,
-			cwd,
-			shell,
+			authUser, hostname, mode, cwd, shell, shellEnv,
 		);
 	}
 
-	// Multiple commands in a pipeline
 	return executePipelineChain(
 		pipeline.commands as PipelineCommand[],
-		authUser,
-		hostname,
-		mode,
-		cwd,
-		shell,
+		authUser, hostname, mode, cwd, shell, shellEnv,
 	);
 }
 
-/**
- * Execute a single command with input/output redirections
- */
 async function executeSingleCommandWithRedirections(
 	cmd: PipelineCommand,
 	authUser: string,
@@ -53,66 +108,37 @@ async function executeSingleCommandWithRedirections(
 	mode: CommandMode,
 	cwd: string,
 	shell: VirtualShell,
+	env: ShellEnv,
 ): Promise<CommandResult> {
-	// Prepare input if input file specified
 	let stdin: string | undefined;
 	if (cmd.inputFile) {
 		const inputPath = resolvePath(cwd, cmd.inputFile);
-		try {
-			stdin = shell.vfs.readFile(inputPath);
-		} catch {
-			return {
-				stderr: `cat: ${cmd.inputFile}: No such file or directory`,
-				exitCode: 1,
-			};
-		}
+		try { stdin = shell.vfs.readFile(inputPath); }
+		catch { return { stderr: `${cmd.inputFile}: No such file or directory`, exitCode: 1 }; }
 	}
 
-	// Build raw input for the command
 	const rawInput = [cmd.name, ...cmd.args].join(" ");
+	const result = await runSingleCommand(rawInput, authUser, hostname, mode, cwd, shell, stdin, env);
 
-	// Run the command with potential input
-	const result = await runSingleCommand(
-		rawInput,
-		authUser,
-		hostname,
-		mode,
-		cwd,
-		shell,
-		stdin,
-	);
-
-	// Handle output redirection
 	if (cmd.outputFile) {
 		const outputPath = resolvePath(cwd, cmd.outputFile);
 		const output = result.stdout || "";
 		try {
 			if (cmd.appendOutput) {
-				try {
-					const existing = shell.vfs.readFile(outputPath);
-					shell.writeFileAsUser(authUser, outputPath, existing + output);
-				} catch {
-					shell.writeFileAsUser(authUser, outputPath, output);
-				}
+				const existing = (() => { try { return shell.vfs.readFile(outputPath); } catch { return ""; } })();
+				shell.writeFileAsUser(authUser, outputPath, existing + output);
 			} else {
 				shell.writeFileAsUser(authUser, outputPath, output);
 			}
 			return { ...result, stdout: "" };
 		} catch {
-			return {
-				...result,
-				stderr: `Failed to write to ${cmd.outputFile}`,
-				exitCode: 1,
-			};
+			return { ...result, stderr: `Failed to write to ${cmd.outputFile}`, exitCode: 1 };
 		}
 	}
 
 	return result;
 }
 
-/**
- * Execute a chain of commands connected by pipes
- */
 async function executePipelineChain(
 	commands: PipelineCommand[],
 	authUser: string,
@@ -120,6 +146,7 @@ async function executePipelineChain(
 	mode: CommandMode,
 	cwd: string,
 	shell: VirtualShell,
+	env: ShellEnv,
 ): Promise<CommandResult> {
 	let currentOutput = "";
 	let exitCode = 0;
@@ -127,66 +154,36 @@ async function executePipelineChain(
 	for (let i = 0; i < commands.length; i++) {
 		const cmd = commands[i] as PipelineCommand;
 
-		// Handle input file for first command
 		if (i === 0 && cmd.inputFile) {
 			const inputPath = resolvePath(cwd, cmd.inputFile);
-			try {
-				currentOutput = shell.vfs.readFile(inputPath);
-			} catch {
-				return {
-					stderr: `cat: ${cmd.inputFile}: No such file or directory`,
-					exitCode: 1,
-				};
-			}
+			try { currentOutput = shell.vfs.readFile(inputPath); }
+			catch { return { stderr: `${cmd.inputFile}: No such file or directory`, exitCode: 1 }; }
 		}
 
-		// Build raw input
 		const rawInput = [cmd.name, ...cmd.args].join(" ");
-
-		// Create a modified context that might accept stdin
-		// For now, we'll append input as an additional arg for commands that support it
-		const result = await runSingleCommand(
-			rawInput,
-			authUser,
-			hostname,
-			mode,
-			cwd,
-			shell,
-			currentOutput,
-		);
-
+		const result = await runSingleCommand(rawInput, authUser, hostname, mode, cwd, shell, currentOutput, env);
 		exitCode = result.exitCode ?? 0;
 
-		// Handle output redirection (only for last command)
 		if (i === commands.length - 1 && cmd.outputFile) {
 			const outputPath = resolvePath(cwd, cmd.outputFile);
 			const output = result.stdout || "";
 			try {
 				if (cmd.appendOutput) {
-					try {
-						const existing = shell.vfs.readFile(outputPath);
-						shell.writeFileAsUser(authUser, outputPath, existing + output);
-					} catch {
-						shell.writeFileAsUser(authUser, outputPath, output);
-					}
+					const existing = (() => { try { return shell.vfs.readFile(outputPath); } catch { return ""; } })();
+					shell.writeFileAsUser(authUser, outputPath, existing + output);
 				} else {
 					shell.writeFileAsUser(authUser, outputPath, output);
 				}
 				currentOutput = "";
 			} catch {
-				return {
-					stderr: `Failed to write to ${cmd.outputFile}`,
-					exitCode: 1,
-				};
+				return { stderr: `Failed to write to ${cmd.outputFile}`, exitCode: 1 };
 			}
 		} else {
-			// Pass output to next command
 			currentOutput = result.stdout || "";
 		}
 
-		if (result.stderr && exitCode !== 0) {
-			return { stderr: result.stderr, exitCode };
-		}
+		if (result.stderr && exitCode !== 0) return { stderr: result.stderr, exitCode };
+		if (result.closeSession || result.switchUser) return result;
 	}
 
 	return { stdout: currentOutput, exitCode };

package/src/SSHMimic/index.ts

@@ -140,11 +140,7 @@ class SshMimic extends EventEmitter {
 
 					// Rate-limit check
 					if (this.isLockedOut(remoteAddress)) {
-						this.emit("auth:failure", {
-							username: candidateUser,
-							remoteAddress,
-							reason: "lockout",
-						});
+						this.emit("auth:failure", { username: candidateUser, remoteAddress, reason: "lockout" });
 						ctx.reject();
 						return;
 					}
@@ -156,10 +152,7 @@ class SshMimic extends EventEmitter {
 								`User ${candidateUser} has no password set, allowing login without verification`,
 							);
 							authUser = candidateUser;
-							sessionId = shell.users.registerSession(
-								authUser,
-								remoteAddress,
-							).id;
+							sessionId = shell.users.registerSession(authUser, remoteAddress).id;
 							this.recordSuccess(remoteAddress);
 							this.emit("auth:success", { username: authUser, remoteAddress });
 							this.ensureHomeDir(authUser);
@@ -173,10 +166,7 @@ class SshMimic extends EventEmitter {
 							!shell.users.verifyPassword(candidateUser, ctx.password)
 						) {
 							this.recordFailure(remoteAddress);
-							this.emit("auth:failure", {
-								username: candidateUser,
-								remoteAddress,
-							});
+							this.emit("auth:failure", { username: candidateUser, remoteAddress });
 							ctx.reject();
 							return;
 						}
@@ -202,16 +192,13 @@ class SshMimic extends EventEmitter {
 						const incomingKey = ctx.key;
 						const keyMatches = authorizedKeys.some(
 							(k) =>
-								k.algo === incomingKey.algo && k.data.equals(incomingKey.data),
+								k.algo === incomingKey.algo &&
+								k.data.equals(incomingKey.data),
 						);
 
 						if (!keyMatches) {
 							this.recordFailure(remoteAddress);
-							this.emit("auth:failure", {
-								username: candidateUser,
-								remoteAddress,
-								method: "publickey",
-							});
+							this.emit("auth:failure", { username: candidateUser, remoteAddress, method: "publickey" });
 							ctx.reject();
 							return;
 						}
@@ -219,16 +206,9 @@ class SshMimic extends EventEmitter {
 						// Key matched — if this is a signature check step, accept
 						if (ctx.signature) {
 							authUser = candidateUser;
-							sessionId = shell.users.registerSession(
-								authUser,
-								remoteAddress,
-							).id;
+							sessionId = shell.users.registerSession(authUser, remoteAddress).id;
 							this.recordSuccess(remoteAddress);
-							this.emit("auth:success", {
-								username: authUser,
-								remoteAddress,
-								method: "publickey",
-							});
+							this.emit("auth:success", { username: authUser, remoteAddress, method: "publickey" });
 							this.ensureHomeDir(authUser);
 							ctx.accept();
 						} else {
@@ -258,35 +238,20 @@ class SshMimic extends EventEmitter {
 							acceptPty();
 						});
 
-						session.on(
-							"window-change",
-							(_acceptChange, _rejectChange, info) => {
-								terminalSize.cols = info?.cols ?? terminalSize.cols;
-								terminalSize.rows = info?.rows ?? terminalSize.rows;
-							},
-						);
+						session.on("window-change", (_acceptChange, _rejectChange, info) => {
+							terminalSize.cols = info?.cols ?? terminalSize.cols;
+							terminalSize.rows = info?.rows ?? terminalSize.rows;
+						});
 
 						session.on("shell", (acceptShell) => {
 							const stream = acceptShell();
-							shell?.startInteractiveSession(
-								stream,
-								authUser,
-								sessionId,
-								remoteAddress,
-								terminalSize,
-							);
+							shell?.startInteractiveSession(stream, authUser, sessionId, remoteAddress, terminalSize);
 						});
 
 						session.on("exec", (acceptExec, _rejectExec, info) => {
 							const stream = acceptExec();
 							if (stream) {
-								runExec(
-									stream,
-									info.command.trim(),
-									authUser,
-									shell.hostname,
-									shell,
-								);
+								runExec(stream, info.command.trim(), authUser, shell.hostname, shell);
 							}
 						});
 					});
@@ -328,3 +293,4 @@ class SshMimic extends EventEmitter {
 
 export { SftpMimic } from "./sftp";
 export { SshMimic };
+

package/src/SSHMimic/sftp.ts

@@ -253,6 +253,14 @@ export class SftpMimic extends EventEmitter {
 					);
 
 					if (ctx.method === "password") {
+						// If no password is set for the user, allow login without verification
+						if (!this.getUsers().hasPassword(candidateUser)) {
+							acceptSession(candidateUser);
+							this.emit("auth:success", { username: authUser, remoteAddress });
+							ctx.accept();
+							return;
+						}
+
 						if (
 							!this.getUsers().verifyPassword(candidateUser, ctx.password ?? "")
 						) {
@@ -272,6 +280,13 @@ export class SftpMimic extends EventEmitter {
 
 					if (ctx.method === "keyboard-interactive") {
 						const keyboardCtx = ctx as KeyboardAuthContext;
+						// If no password is set, accept immediately
+						if (!this.getUsers().hasPassword(candidateUser)) {
+							acceptSession(candidateUser);
+							this.emit("auth:success", { username: authUser, remoteAddress });
+							keyboardCtx.accept();
+							return;
+						}
 						keyboardCtx.prompt(
 							[{ prompt: "Password: ", echo: false }],
 							(answers) => {