just-bash 2.6.0 → 2.7.0

package/dist/commands/python3/fs-bridge-handler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Main thread filesystem bridge handler
+ *
+ * Runs on the main thread and processes filesystem requests from the worker thread.
+ * Uses SharedArrayBuffer + Atomics for synchronization.
+ */
+import type { IFileSystem } from "../../fs/interface.js";
+import type { SecureFetch } from "../../network/fetch.js";
+export interface FsBridgeOutput {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Handles filesystem requests from the worker thread.
+ */
+export declare class FsBridgeHandler {
+    private fs;
+    private cwd;
+    private secureFetch;
+    private protocol;
+    private running;
+    private output;
+    constructor(sharedBuffer: SharedArrayBuffer, fs: IFileSystem, cwd: string, secureFetch?: SecureFetch | undefined);
+    /**
+     * Run the handler loop until EXIT operation or timeout.
+     */
+    run(timeoutMs: number): Promise<FsBridgeOutput>;
+    stop(): void;
+    private handleOperation;
+    private resolvePath;
+    private handleReadFile;
+    private handleWriteFile;
+    private handleStat;
+    private handleLstat;
+    private handleReaddir;
+    private handleMkdir;
+    private handleRm;
+    private handleExists;
+    private handleAppendFile;
+    private handleSymlink;
+    private handleReadlink;
+    private handleChmod;
+    private handleRealpath;
+    private handleWriteStdout;
+    private handleWriteStderr;
+    private handleExit;
+    private handleHttpRequest;
+    private setErrorFromException;
+}

package/dist/commands/python3/protocol.d.ts

@@ -0,0 +1,138 @@
+/**
+ * SharedArrayBuffer protocol for synchronous filesystem bridge
+ *
+ * This protocol enables synchronous filesystem access from a worker thread
+ * (where Pyodide/Python runs) to the main thread (which has async IFileSystem).
+ */
+declare global {
+    interface Atomics {
+        waitAsync(typedArray: Int32Array, index: number, value: number, timeout?: number): {
+            async: false;
+            value: "not-equal" | "timed-out";
+        } | {
+            async: true;
+            value: Promise<"ok" | "timed-out">;
+        };
+    }
+}
+/** Operation codes */
+export declare const OpCode: {
+    readonly NOOP: 0;
+    readonly READ_FILE: 1;
+    readonly WRITE_FILE: 2;
+    readonly STAT: 3;
+    readonly READDIR: 4;
+    readonly MKDIR: 5;
+    readonly RM: 6;
+    readonly EXISTS: 7;
+    readonly APPEND_FILE: 8;
+    readonly SYMLINK: 9;
+    readonly READLINK: 10;
+    readonly LSTAT: 11;
+    readonly CHMOD: 12;
+    readonly REALPATH: 13;
+    readonly WRITE_STDOUT: 100;
+    readonly WRITE_STDERR: 101;
+    readonly EXIT: 102;
+    readonly HTTP_REQUEST: 200;
+};
+export type OpCodeType = (typeof OpCode)[keyof typeof OpCode];
+/** Status codes for synchronization */
+export declare const Status: {
+    readonly PENDING: 0;
+    readonly READY: 1;
+    readonly SUCCESS: 2;
+    readonly ERROR: 3;
+};
+export type StatusType = (typeof Status)[keyof typeof Status];
+/** Error codes */
+export declare const ErrorCode: {
+    readonly NONE: 0;
+    readonly NOT_FOUND: 1;
+    readonly IS_DIRECTORY: 2;
+    readonly NOT_DIRECTORY: 3;
+    readonly EXISTS: 4;
+    readonly PERMISSION_DENIED: 5;
+    readonly INVALID_PATH: 6;
+    readonly IO_ERROR: 7;
+    readonly TIMEOUT: 8;
+    readonly NETWORK_ERROR: 9;
+    readonly NETWORK_NOT_CONFIGURED: 10;
+};
+export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
+/** Flags for operations */
+export declare const Flags: {
+    readonly NONE: 0;
+    readonly RECURSIVE: 1;
+    readonly FORCE: 2;
+    readonly MKDIR_RECURSIVE: 1;
+};
+/** Create a new SharedArrayBuffer for the protocol */
+export declare function createSharedBuffer(): SharedArrayBuffer;
+/**
+ * Helper class for reading/writing protocol data
+ */
+export declare class ProtocolBuffer {
+    private int32View;
+    private uint8View;
+    private dataView;
+    constructor(buffer: SharedArrayBuffer);
+    getOpCode(): OpCodeType;
+    setOpCode(code: OpCodeType): void;
+    getStatus(): StatusType;
+    setStatus(status: StatusType): void;
+    getPathLength(): number;
+    setPathLength(length: number): void;
+    getDataLength(): number;
+    setDataLength(length: number): void;
+    getResultLength(): number;
+    setResultLength(length: number): void;
+    getErrorCode(): ErrorCodeType;
+    setErrorCode(code: ErrorCodeType): void;
+    getFlags(): number;
+    setFlags(flags: number): void;
+    getMode(): number;
+    setMode(mode: number): void;
+    getPath(): string;
+    setPath(path: string): void;
+    getData(): Uint8Array;
+    setData(data: Uint8Array): void;
+    getDataAsString(): string;
+    setDataFromString(str: string): void;
+    getResult(): Uint8Array;
+    setResult(data: Uint8Array): void;
+    getResultAsString(): string;
+    setResultFromString(str: string): void;
+    encodeStat(stat: {
+        isFile: boolean;
+        isDirectory: boolean;
+        isSymbolicLink: boolean;
+        mode: number;
+        size: number;
+        mtime: Date;
+    }): void;
+    decodeStat(): {
+        isFile: boolean;
+        isDirectory: boolean;
+        isSymbolicLink: boolean;
+        mode: number;
+        size: number;
+        mtime: Date;
+    };
+    waitForReady(timeout?: number): "ok" | "timed-out" | "not-equal";
+    waitForReadyAsync(timeout?: number): {
+        async: false;
+        value: "not-equal" | "timed-out";
+    } | {
+        async: true;
+        value: Promise<"ok" | "timed-out">;
+    };
+    /**
+     * Wait for status to become READY.
+     * Returns immediately if status is already READY, or waits until it changes.
+     */
+    waitUntilReady(timeout: number): Promise<boolean>;
+    waitForResult(timeout?: number): "ok" | "timed-out" | "not-equal";
+    notify(): number;
+    reset(): void;
+}

package/dist/commands/python3/python3.d.ts

@@ -0,0 +1,11 @@
+/**
+ * python3 - Execute Python code via Pyodide (Python in WebAssembly)
+ *
+ * Runs Python code in an isolated worker thread with access to the
+ * virtual filesystem via SharedArrayBuffer bridge.
+ *
+ * This command is Node.js only (uses worker_threads).
+ */
+import type { Command } from "../../types.js";
+export declare const python3Command: Command;
+export declare const pythonCommand: Command;

package/dist/commands/python3/sync-fs-backend.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Worker-side synchronous filesystem backend
+ *
+ * Runs in the worker thread and makes synchronous calls to the main thread
+ * via SharedArrayBuffer + Atomics.
+ */
+/**
+ * Synchronous filesystem backend for Pyodide worker.
+ */
+export declare class SyncFsBackend {
+    private protocol;
+    constructor(sharedBuffer: SharedArrayBuffer);
+    private execSync;
+    readFile(path: string): Uint8Array;
+    writeFile(path: string, data: Uint8Array): void;
+    stat(path: string): {
+        isFile: boolean;
+        isDirectory: boolean;
+        isSymbolicLink: boolean;
+        mode: number;
+        size: number;
+        mtime: Date;
+    };
+    lstat(path: string): {
+        isFile: boolean;
+        isDirectory: boolean;
+        isSymbolicLink: boolean;
+        mode: number;
+        size: number;
+        mtime: Date;
+    };
+    readdir(path: string): string[];
+    mkdir(path: string, recursive?: boolean): void;
+    rm(path: string, recursive?: boolean, force?: boolean): void;
+    exists(path: string): boolean;
+    appendFile(path: string, data: Uint8Array): void;
+    symlink(target: string, linkPath: string): void;
+    readlink(path: string): string;
+    chmod(path: string, mode: number): void;
+    realpath(path: string): string;
+    writeStdout(data: string): void;
+    writeStderr(data: string): void;
+    exit(code: number): void;
+    /**
+     * Make an HTTP request through the main thread's secureFetch.
+     * Returns the response as a parsed object.
+     */
+    httpRequest(url: string, options?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }): {
+        status: number;
+        statusText: string;
+        headers: Record<string, string>;
+        body: string;
+        url: string;
+    };
+}

package/dist/commands/python3/worker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Worker thread for Python execution via Pyodide.
+ * Keeps Pyodide loaded and handles multiple execution requests.
+ */
+export interface WorkerInput {
+    sharedBuffer: SharedArrayBuffer;
+    pythonCode: string;
+    cwd: string;
+    env: Record<string, string>;
+    args: string[];
+    scriptPath?: string;
+}
+export interface WorkerOutput {
+    success: boolean;
+    error?: string;
+}

package/dist/commands/registry.d.ts

@@ -1,6 +1,6 @@
 import type { Command } from "../types.js";
 /** All available built-in command names (excludes network commands) */
-export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "rmdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "rg" | "sed" | "awk" | "sort" | "uniq" | "comm" | "cut" | "paste" | "tr" | "rev" | "nl" | "fold" | "expand" | "unexpand" | "strings" | "split" | "column" | "join" | "tee" | "find" | "basename" | "dirname" | "tree" | "du" | "env" | "printenv" | "alias" | "unalias" | "history" | "xargs" | "true" | "false" | "clear" | "bash" | "sh" | "jq" | "base64" | "diff" | "date" | "sleep" | "timeout" | "seq" | "expr" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat" | "tar" | "yq" | "xan" | "sqlite3" | "time" | "whoami";
+export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "rmdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "rg" | "sed" | "awk" | "sort" | "uniq" | "comm" | "cut" | "paste" | "tr" | "rev" | "nl" | "fold" | "expand" | "unexpand" | "strings" | "split" | "column" | "join" | "tee" | "find" | "basename" | "dirname" | "tree" | "du" | "env" | "printenv" | "alias" | "unalias" | "history" | "xargs" | "true" | "false" | "clear" | "bash" | "sh" | "jq" | "base64" | "diff" | "date" | "sleep" | "timeout" | "seq" | "expr" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat" | "tar" | "yq" | "xan" | "sqlite3" | "time" | "whoami" | "python3" | "python";
 /** Network command names (only available when network is configured) */
 export type NetworkCommandName = "curl";
 /** All command names including network commands */

package/dist/limits.d.ts

@@ -23,6 +23,8 @@ export interface ExecutionLimits {
     maxJqIterations?: number;
     /** Maximum sqlite3 query execution time in milliseconds (default: 5000) */
     maxSqliteTimeoutMs?: number;
+    /** Maximum Python execution time in milliseconds (default: 30000) */
+    maxPythonTimeoutMs?: number;
 }
 /**
  * Resolve execution limits by merging user-provided limits with defaults.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-bash",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "A simulated bash environment with virtual filesystem",
   "repository": {
     "type": "git",
@@ -73,6 +73,7 @@
     "minimatch": "^10.1.1",
     "modern-tar": "^0.7.3",
     "papaparse": "^5.5.3",
+    "pyodide": "^0.27.0",
     "smol-toml": "^1.6.0",
     "sprintf-js": "^1.1.3",
     "sql.js": "^1.13.0",
@@ -84,12 +85,13 @@
   },
   "packageManager": "pnpm@8.15.9+sha512.499434c9d8fdd1a2794ebf4552b3b25c0a633abcee5bb15e7b5de90f32f47b513aca98cd5cfd001c31f0db454bc3804edccd578501e4ca293a6816166bbd9f81",
   "scripts": {
-    "build": "rm -rf dist && tsc && pnpm build:lib && pnpm build:browser && pnpm build:cli && pnpm build:shell && pnpm build:clean && sed '1,/^-->/d' AGENTS.npm.md > dist/AGENTS.md",
+    "build": "rm -rf dist && tsc && pnpm build:lib && pnpm build:browser && pnpm build:cli && pnpm build:shell && pnpm build:worker && pnpm build:clean && sed '1,/^-->/d' AGENTS.npm.md > dist/AGENTS.md",
     "build:clean": "find dist -name '*.test.js' -delete && find dist -name '*.test.d.ts' -delete",
-    "build:lib": "esbuild dist/index.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bundle --chunk-names=chunks/[name]-[hash] --external:diff --external:minimatch --external:sprintf-js --external:turndown --external:sql.js --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
+    "build:worker": "esbuild src/commands/python3/worker.ts --bundle --platform=node --format=esm --outfile=src/commands/python3/worker.js --external:pyodide && cp src/commands/python3/worker.js dist/commands/python3/worker.js && mkdir -p dist/bin/chunks && cp src/commands/python3/worker.js dist/bin/chunks/worker.js && mkdir -p dist/bundle/chunks && cp src/commands/python3/worker.js dist/bundle/chunks/worker.js",
+    "build:lib": "esbuild dist/index.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bundle --chunk-names=chunks/[name]-[hash] --external:diff --external:minimatch --external:sprintf-js --external:turndown --external:sql.js --external:pyodide --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
     "build:browser": "esbuild dist/browser.js --bundle --platform=browser --format=esm --minify --outfile=dist/bundle/browser.js --external:diff --external:minimatch --external:sprintf-js --external:turndown --external:node:* --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs --define:__BROWSER__=true",
-    "build:cli": "esbuild dist/cli/just-bash.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bin --entry-names=[name] --chunk-names=chunks/[name]-[hash] --banner:js='#!/usr/bin/env node' --external:sql.js --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
-    "build:shell": "esbuild dist/cli/shell.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bin/shell --entry-names=[name] --chunk-names=chunks/[name]-[hash] --banner:js='#!/usr/bin/env node' --external:sql.js --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
+    "build:cli": "esbuild dist/cli/just-bash.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bin --entry-names=[name] --chunk-names=chunks/[name]-[hash] --banner:js='#!/usr/bin/env node' --external:sql.js --external:pyodide --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
+    "build:shell": "esbuild dist/cli/shell.js --bundle --splitting --platform=node --format=esm --minify --outdir=dist/bin/shell --entry-names=[name] --chunk-names=chunks/[name]-[hash] --banner:js='#!/usr/bin/env node' --external:sql.js --external:pyodide --external:@mongodb-js/zstd --external:node-liblzma --external:compressjs",
     "validate": "pnpm lint && pnpm knip && pnpm typecheck &&  pnpm build && pnpm test:run && pnpm test:dist",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",