@volter/browser-toolbelt 0.1.0

package/dist/browser-share-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-share-command.js","sourceRoot":"","sources":["../src/browser-share-command.ts"],"names":[],"mappings":"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"}

package/dist/browser-shell-filesystem.d.ts

@@ -0,0 +1,39 @@
+import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
+import type { BufferEncoding, CpOptions, FileContent, FsStat, IFileSystem, MkdirOptions, RmOptions } from "just-bash/browser";
+interface DirentEntry {
+    name: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+}
+/** Live just-bash adapter over the same AlmostNode VFS used by WALI. */
+export declare class BrowserShellFileSystem implements IFileSystem {
+    private readonly filesystem;
+    constructor(filesystem: BrowserFileSystem);
+    readFile(path: string, options?: {
+        encoding?: BufferEncoding | null;
+    } | BufferEncoding): Promise<string>;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: FileContent): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FsStat>;
+    mkdir(path: string, options?: MkdirOptions): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    readdirWithFileTypes(path: string): Promise<DirentEntry[]>;
+    rm(path: string, options?: RmOptions): Promise<void>;
+    cp(source: string, destination: string, options?: CpOptions): Promise<void>;
+    mv(source: string, destination: string): Promise<void>;
+    resolvePath(base: string, path: string): string;
+    getAllPaths(): string[];
+    chmod(path: string, mode: number): Promise<void>;
+    symlink(_target: string, _path: string): Promise<void>;
+    link(_source: string, _path: string): Promise<void>;
+    readlink(_path: string): Promise<string>;
+    lstat(path: string): Promise<FsStat>;
+    realpath(path: string): Promise<string>;
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
+    private assertExists;
+}
+export {};
+//# sourceMappingURL=browser-shell-filesystem.d.ts.map

package/dist/browser-shell-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-shell-filesystem.d.ts","sourceRoot":"","sources":["../src/browser-shell-filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EACZ,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wEAAwE;AACxE,qBAAa,sBAAuB,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,iBAAiB;IAEpD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAOxG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAanC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAExC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAO1D,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAE/C,WAAW,IAAI,MAAM,EAAE;IAcjB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE,OAAO,CAAC,YAAY;CAGrB"}

package/dist/browser-shell-filesystem.js

@@ -0,0 +1,138 @@
+/** Live just-bash adapter over the same AlmostNode VFS used by WALI. */
+export class BrowserShellFileSystem {
+    filesystem;
+    constructor(filesystem) {
+        this.filesystem = filesystem;
+    }
+    async readFile(path, options) {
+        const encoding = typeof options === "string" ? options : options?.encoding;
+        const bytes = this.filesystem.readFileSync(path);
+        if (encoding === "binary" || encoding === "latin1")
+            return binaryString(bytes);
+        return new TextDecoder().decode(bytes);
+    }
+    async readFileBuffer(path) {
+        return this.filesystem.readFileSync(path);
+    }
+    async writeFile(path, content) {
+        this.filesystem.writeFileSync(path, content);
+    }
+    async appendFile(path, content) {
+        const previous = this.filesystem.existsSync(path) ? this.filesystem.readFileSync(path) : new Uint8Array();
+        const next = typeof content === "string" ? new TextEncoder().encode(content) : content;
+        const combined = new Uint8Array(previous.byteLength + next.byteLength);
+        combined.set(previous);
+        combined.set(next, previous.byteLength);
+        this.filesystem.writeFileSync(path, combined);
+    }
+    async exists(path) { return this.filesystem.existsSync(path); }
+    async stat(path) {
+        const value = this.filesystem.statSync(path);
+        const executablePackageBin = value.isFile() && path.includes("/node_modules/.bin/");
+        return {
+            isFile: value.isFile(),
+            isDirectory: value.isDirectory(),
+            isSymbolicLink: false,
+            mode: executablePackageBin ? 0o755 : value.mode ?? (value.isDirectory() ? 0o755 : 0o644),
+            size: value.size,
+            mtime: new Date(value.mtimeMs ?? Date.now()),
+        };
+    }
+    async mkdir(path, options) {
+        this.filesystem.mkdirSync(path, options);
+    }
+    async readdir(path) { return this.filesystem.readdirSync(path); }
+    async readdirWithFileTypes(path) {
+        return this.filesystem.readdirSync(path).map((name) => {
+            const value = this.filesystem.statSync(join(path, name));
+            return { name, isFile: value.isFile(), isDirectory: value.isDirectory(), isSymbolicLink: false };
+        });
+    }
+    async rm(path, options) {
+        if (!this.filesystem.existsSync(path)) {
+            if (options?.force)
+                return;
+            throw filesystemError("ENOENT", path);
+        }
+        const value = this.filesystem.statSync(path);
+        if (!value.isDirectory()) {
+            this.filesystem.unlinkSync(path);
+            return;
+        }
+        if (options?.recursive) {
+            for (const name of this.filesystem.readdirSync(path))
+                await this.rm(join(path, name), options);
+        }
+        this.filesystem.rmdirSync(path);
+    }
+    async cp(source, destination, options) {
+        const value = this.filesystem.statSync(source);
+        if (!value.isDirectory()) {
+            this.filesystem.writeFileSync(destination, this.filesystem.readFileSync(source));
+            return;
+        }
+        if (!options?.recursive)
+            throw filesystemError("EISDIR", source);
+        this.filesystem.mkdirSync(destination, { recursive: true });
+        for (const name of this.filesystem.readdirSync(source)) {
+            await this.cp(join(source, name), join(destination, name), options);
+        }
+    }
+    async mv(source, destination) { this.filesystem.renameSync(source, destination); }
+    resolvePath(base, path) { return normalize(path.startsWith("/") ? path : join(base, path)); }
+    getAllPaths() {
+        const result = [];
+        const visit = (directory) => {
+            if (!this.filesystem.existsSync(directory) || !this.filesystem.statSync(directory).isDirectory())
+                return;
+            for (const name of this.filesystem.readdirSync(directory)) {
+                const path = join(directory, name);
+                result.push(path);
+                visit(path);
+            }
+        };
+        visit("/");
+        return result;
+    }
+    async chmod(path, mode) {
+        this.assertExists(path);
+        this.filesystem.chmodSync(path, mode);
+    }
+    async symlink(_target, _path) { throw new Error("Symbolic links are not supported."); }
+    async link(_source, _path) { throw new Error("Hard links are not supported."); }
+    async readlink(_path) { throw new Error("Symbolic links are not supported."); }
+    async lstat(path) { return this.stat(path); }
+    async realpath(path) { this.assertExists(path); return normalize(path); }
+    async utimes(path, atime, mtime) {
+        this.assertExists(path);
+        this.filesystem.utimesSync(path, atime, mtime);
+    }
+    assertExists(path) {
+        if (!this.filesystem.existsSync(path))
+            throw filesystemError("ENOENT", path);
+    }
+}
+function join(base, name) { return normalize(`${base}/${name}`); }
+function normalize(value) {
+    const parts = [];
+    for (const part of `/${value}`.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            parts.pop();
+        else
+            parts.push(part);
+    }
+    return `/${parts.join("/")}`;
+}
+function filesystemError(code, path) {
+    return Object.assign(new Error(`${code}: ${path}`), { code, path });
+}
+function binaryString(bytes) {
+    let value = "";
+    for (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {
+        value += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+    }
+    return value;
+}
+//# sourceMappingURL=browser-shell-filesystem.js.map

package/dist/browser-shell-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-shell-filesystem.js","sourceRoot":"","sources":["../src/browser-shell-filesystem.ts"],"names":[],"mappings":"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"}

package/dist/browser-shell.d.ts

@@ -0,0 +1,38 @@
+import type { BrowserFileSystem } from "@volter/browser-runtime/browser-filesystem.js";
+export interface BrowserShellRunOptions {
+    cwd?: string;
+    env?: Readonly<Record<string, string>>;
+    stdin?: string;
+    signal?: AbortSignal;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+}
+export interface BrowserShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    cwd?: string;
+    env?: Readonly<Record<string, string>>;
+}
+export type BrowserShellProgramRunner = (argv: readonly string[], options: BrowserShellRunOptions) => Promise<BrowserShellResult>;
+/** AST Bash, standard toolbelt, and a small persistent browser job table. */
+export declare class BrowserShell {
+    private readonly bash;
+    private readonly virtualFilesystem;
+    private readonly filesystem;
+    private readonly jobs;
+    private readonly registeredPrograms;
+    private readonly streamingRuns;
+    private nextPid;
+    constructor(filesystem: BrowserFileSystem);
+    registerProgram(name: string, runner: BrowserShellProgramRunner): void;
+    run(command: string, options?: BrowserShellRunOptions): Promise<BrowserShellResult>;
+    terminate(): void;
+    private ensureRuntimeDirectories;
+    private changeDirectory;
+    private runForeground;
+    private startBackground;
+    private registerJobCommands;
+    private registerShellExecutables;
+}
+//# sourceMappingURL=browser-shell.d.ts.map

package/dist/browser-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-shell.d.ts","sourceRoot":"","sources":["../src/browser-shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAMvF,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,sBAAsB,KAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAWjC,6EAA6E;AAC7E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsD;IACpF,OAAO,CAAC,OAAO,CAAQ;gBAEX,UAAU,EAAE,iBAAiB;IAmBzC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,GAAG,IAAI;IA4BhE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4B7F,SAAS,IAAI,IAAI;IAKjB,OAAO,CAAC,wBAAwB;YAKlB,eAAe;YA2Bf,aAAa;IAoB3B,OAAO,CAAC,eAAe;IA0CvB,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,wBAAwB;CA0BjC"}

package/dist/browser-shell.js

@@ -0,0 +1,412 @@
+import { Bash, defineCommand } from "just-bash/browser";
+import { BrowserShellFileSystem } from "./browser-shell-filesystem.js";
+/** AST Bash, standard toolbelt, and a small persistent browser job table. */
+export class BrowserShell {
+    bash;
+    virtualFilesystem;
+    filesystem;
+    jobs = new Map();
+    registeredPrograms = new Set();
+    streamingRuns = new WeakMap();
+    nextPid = 1000;
+    constructor(filesystem) {
+        this.virtualFilesystem = filesystem;
+        this.filesystem = new BrowserShellFileSystem(filesystem);
+        this.ensureRuntimeDirectories();
+        this.bash = new Bash({
+            fs: this.filesystem,
+            cwd: "/",
+            env: {
+                HOME: "/home/supercode",
+                USER: "supercode",
+                PATH: "/usr/local/bin:/usr/bin:/bin:/node_modules/.bin",
+                NODE_ENV: "development",
+            },
+            processInfo: { pid: 1, ppid: 0, uid: 1000, gid: 1000 },
+        });
+        this.registerShellExecutables();
+        this.registerJobCommands();
+    }
+    registerProgram(name, runner) {
+        this.registeredPrograms.add(name);
+        this.bash.registerCommand(trustedCommand(name, async (args, context) => {
+            const streaming = context.signal ? this.streamingRuns.get(context.signal) : undefined;
+            let streamedStdout = false;
+            let streamedStderr = false;
+            const result = await runner([name, ...args], {
+                cwd: context.cwd,
+                env: Object.fromEntries(context.env),
+                stdin: context.stdin,
+                ...(context.signal ? { signal: context.signal } : {}),
+                ...(streaming?.onStdout ? { onStdout: (data) => {
+                        streamedStdout = true;
+                        streaming.onStdout(data);
+                    } } : {}),
+                ...(streaming?.onStderr ? { onStderr: (data) => {
+                        streamedStderr = true;
+                        streaming.onStderr(data);
+                    } } : {}),
+            });
+            return {
+                ...result,
+                stdout: streamedStdout ? "" : result.stdout,
+                stderr: streamedStderr ? "" : result.stderr,
+            };
+        }));
+    }
+    async run(command, options = {}) {
+        // Project restoration replaces the VFS contents after the shell is created.
+        // Reassert process-owned directories at the command boundary so restores and
+        // project resets cannot invalidate the shell environment.
+        this.ensureRuntimeDirectories();
+        const changedDirectory = await this.changeDirectory(command, options);
+        if (changedDirectory)
+            return changedDirectory;
+        const sequence = splitBackgroundSequence(command);
+        if (sequence) {
+            const background = this.startBackground(sequence.background, options);
+            // A background server commonly registers its port on a microtask. Let
+            // that startup settle before the foreground dev server claims its own
+            // port so process ownership remains deterministic.
+            await new Promise((resolve) => globalThis.setTimeout(resolve, 0));
+            const foreground = await this.run(sequence.foreground, options);
+            return {
+                stdout: `${background.stdout}${foreground.stdout}`,
+                stderr: `${background.stderr}${foreground.stderr}`,
+                exitCode: foreground.exitCode,
+                ...(foreground.cwd ? { cwd: foreground.cwd } : {}),
+                ...(foreground.env ? { env: foreground.env } : {}),
+            };
+        }
+        const background = stripBackgroundOperator(command);
+        if (background !== undefined)
+            return this.startBackground(background, options);
+        return this.runForeground(command, options);
+    }
+    terminate() {
+        for (const job of this.jobs.values())
+            job.controller.abort(new DOMException("Shell terminated", "AbortError"));
+        this.jobs.clear();
+    }
+    ensureRuntimeDirectories() {
+        this.virtualFilesystem.mkdirSync("/tmp", { recursive: true });
+        this.virtualFilesystem.mkdirSync("/home/supercode", { recursive: true });
+    }
+    async changeDirectory(command, options) {
+        let words;
+        try {
+            words = parseWords(command);
+        }
+        catch {
+            return;
+        }
+        if (words[0] !== "cd")
+            return;
+        if (words.length > 2)
+            return { stdout: "", stderr: "bash: cd: too many arguments\n", exitCode: 1 };
+        const current = options.cwd ?? "/";
+        const requested = words[1] ?? options.env?.HOME ?? "/home/supercode";
+        const destination = this.filesystem.resolvePath(current, requested);
+        try {
+            const value = await this.filesystem.stat(destination);
+            if (!value.isDirectory)
+                return { stdout: "", stderr: `bash: cd: ${requested}: Not a directory\n`, exitCode: 1 };
+            return {
+                stdout: "",
+                stderr: "",
+                exitCode: 0,
+                cwd: destination,
+                env: { ...options.env, OLDPWD: current, PWD: destination },
+            };
+        }
+        catch {
+            return { stdout: "", stderr: `bash: cd: ${requested}: No such file or directory\n`, exitCode: 1 };
+        }
+    }
+    async runForeground(command, options) {
+        if (options.signal?.aborted)
+            return { stdout: "", stderr: "", exitCode: 130 };
+        const cwd = options.cwd ?? "/";
+        try {
+            const result = await this.bash.exec(command, {
+                cwd,
+                env: withNodeModuleBinPath(options.env, cwd),
+                ...(options.stdin !== undefined ? { stdin: options.stdin } : {}),
+                ...(options.signal ? { signal: options.signal } : {}),
+                rawScript: true,
+            });
+            options.onStdout?.(result.stdout);
+            options.onStderr?.(result.stderr);
+            return { stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode, env: result.env };
+        }
+        catch (cause) {
+            if (options.signal?.aborted)
+                return { stdout: "", stderr: "", exitCode: 130 };
+            return { stdout: "", stderr: `${cause instanceof Error ? cause.message : String(cause)}\n`, exitCode: 1 };
+        }
+    }
+    startBackground(command, options) {
+        if (!command)
+            return { stdout: "", stderr: "bash: syntax error near unexpected token `&'\n", exitCode: 2 };
+        const pid = this.nextPid++;
+        const controller = new AbortController();
+        const abortWithParent = () => {
+            if (!controller.signal.aborted) {
+                controller.abort(options.signal?.reason ?? new DOMException("Parent process terminated", "AbortError"));
+            }
+        };
+        if (options.signal?.aborted)
+            abortWithParent();
+        else
+            options.signal?.addEventListener("abort", abortWithParent, { once: true });
+        const job = {
+            pid,
+            command,
+            controller,
+            state: "running",
+            promise: Promise.resolve({ stdout: "", stderr: "", exitCode: 0 }),
+        };
+        const streamProgram = isSimpleCommand(command)
+            && this.registeredPrograms.has(parseWords(command)[0] ?? "");
+        if (streamProgram)
+            this.streamingRuns.set(controller.signal, options);
+        const { onStdout: _onStdout, onStderr: _onStderr, ...jobOptions } = options;
+        job.promise = this.runForeground(command, {
+            ...jobOptions,
+            signal: controller.signal,
+        }).then((result) => {
+            options.signal?.removeEventListener("abort", abortWithParent);
+            job.state = "done";
+            job.result = result;
+            if (!streamProgram) {
+                options.onStdout?.(result.stdout);
+                options.onStderr?.(result.stderr);
+            }
+            options.onStderr?.(`[${pid}] Done (${result.exitCode}) ${command}\n`);
+            return result;
+        });
+        this.jobs.set(pid, job);
+        const stdout = `[${pid}] ${pid}\n`;
+        options.onStdout?.(stdout);
+        return { stdout, stderr: "", exitCode: 0 };
+    }
+    registerJobCommands() {
+        this.bash.registerCommand(trustedCommand("jobs", async () => ({
+            stdout: [...this.jobs.values()].map((job) => `[${job.pid}] ${job.state === "running" ? "Running" : "Done"} ${job.command}\n`).join(""),
+            stderr: "",
+            exitCode: 0,
+        })));
+        this.bash.registerCommand(trustedCommand("kill", async (args) => {
+            const targets = args.filter((arg) => !arg.startsWith("-"));
+            if (targets.length === 0)
+                return { stdout: "", stderr: "kill: usage: kill PID...\n", exitCode: 2 };
+            let stderr = "";
+            for (const target of targets) {
+                const pid = Number(target.replace(/^%/u, ""));
+                const job = this.jobs.get(pid);
+                if (!job || job.state !== "running")
+                    stderr += `kill: (${target}) - No such process\n`;
+                else
+                    job.controller.abort(new DOMException("Terminated", "AbortError"));
+            }
+            return { stdout: "", stderr, exitCode: stderr ? 1 : 0 };
+        }));
+        this.bash.registerCommand(trustedCommand("wait", async (args) => {
+            const selected = args.length === 0
+                ? [...this.jobs.values()]
+                : args.map((arg) => this.jobs.get(Number(arg.replace(/^%/u, "")))).filter((job) => !!job);
+            if (args.length > 0 && selected.length !== args.length) {
+                return { stdout: "", stderr: "wait: pid is not a child of this shell\n", exitCode: 127 };
+            }
+            const results = await Promise.all(selected.map((job) => job.promise));
+            for (const job of selected)
+                this.jobs.delete(job.pid);
+            return { stdout: "", stderr: "", exitCode: results.at(-1)?.exitCode ?? 0 };
+        }));
+    }
+    registerShellExecutables() {
+        for (const name of ["bash", "sh", "zsh"]) {
+            this.bash.registerCommand(trustedCommand(name, async (args, context) => {
+                if (args.includes("--version")) {
+                    return {
+                        // Native harnesses use this as an executability probe and often
+                        // attach null stdio. Success is the contract; keeping it silent
+                        // also avoids leaking a detached probe into the parent terminal.
+                        stdout: "",
+                        stderr: "",
+                        exitCode: 0,
+                    };
+                }
+                const commandIndex = args.findIndex((argument) => argument === "-c" || argument.endsWith("lc") || argument.endsWith("ilc"));
+                const script = commandIndex >= 0 ? args[commandIndex + 1] : context.stdin;
+                if (!script)
+                    return { stdout: "", stderr: "", exitCode: 0 };
+                return this.bash.exec(script, {
+                    cwd: context.cwd,
+                    env: Object.fromEntries(context.env),
+                    ...(context.signal ? { signal: context.signal } : {}),
+                    rawScript: true,
+                });
+            }));
+        }
+    }
+}
+function withNodeModuleBinPath(environment, cwd) {
+    const executableDirectories = [];
+    let directory = normalizeShellPath(cwd);
+    for (;;) {
+        executableDirectories.push(`${directory === "/" ? "" : directory}/node_modules/.bin`);
+        if (directory === "/")
+            break;
+        directory = directory.slice(0, directory.lastIndexOf("/")) || "/";
+    }
+    const inherited = environment?.PATH ?? "/usr/local/bin:/usr/bin:/bin";
+    const path = [...new Set([...executableDirectories, ...inherited.split(":").filter(Boolean)])].join(":");
+    return { ...environment, PATH: path };
+}
+function normalizeShellPath(value) {
+    const parts = [];
+    for (const part of `/${value}`.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            parts.pop();
+        else
+            parts.push(part);
+    }
+    return `/${parts.join("/")}`;
+}
+function splitBackgroundSequence(command) {
+    let quote = "";
+    let escaped = false;
+    for (let index = 0; index < command.length; index += 1) {
+        const character = command[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote)
+                quote = "";
+            continue;
+        }
+        if (character === "'" || character === '"') {
+            quote = character;
+            continue;
+        }
+        if (character !== "&" || command[index - 1] === "&" || command[index + 1] === "&"
+            || command[index - 1] === ">" || !/\s/u.test(command[index - 1] ?? "")
+            || !/\s/u.test(command[index + 1] ?? ""))
+            continue;
+        const background = command.slice(0, index).trim();
+        const foreground = command.slice(index + 1).trim();
+        if (background && foreground)
+            return { background, foreground };
+    }
+    return;
+}
+function stripBackgroundOperator(command) {
+    const value = command.trimEnd();
+    if (!value.endsWith("&") || value.endsWith("&&"))
+        return;
+    let quote = "";
+    let escaped = false;
+    for (let index = 0; index < value.length - 1; index += 1) {
+        const character = value[index];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote)
+                quote = "";
+            continue;
+        }
+        if (character === "'" || character === '"')
+            quote = character;
+    }
+    if (quote || escaped)
+        return;
+    return value.slice(0, -1).trimEnd();
+}
+function isSimpleCommand(command) {
+    let quote = "";
+    let escaped = false;
+    for (const character of command) {
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote)
+                quote = "";
+            continue;
+        }
+        if (character === "'" || character === '"') {
+            quote = character;
+            continue;
+        }
+        if (/[|&;<>]/u.test(character))
+            return false;
+    }
+    return true;
+}
+function parseWords(command) {
+    const words = [];
+    let word = "";
+    let quote = "";
+    let escaped = false;
+    for (const character of command.trim()) {
+        if (escaped) {
+            word += character;
+            escaped = false;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote)
+                quote = "";
+            else
+                word += character;
+            continue;
+        }
+        if (character === "'" || character === '"') {
+            quote = character;
+            continue;
+        }
+        if (/\s/u.test(character)) {
+            if (word) {
+                words.push(word);
+                word = "";
+            }
+            continue;
+        }
+        if (/[|&;<>]/u.test(character))
+            throw new Error("Compound command");
+        word += character;
+    }
+    if (quote || escaped)
+        throw new Error("Unterminated quoting");
+    if (word)
+        words.push(word);
+    return words;
+}
+function trustedCommand(name, execute) {
+    return { ...defineCommand(name, execute), trusted: true };
+}
+//# sourceMappingURL=browser-shell.js.map