just-bash-mcp 2.9.1 → 2.9.3

package/README.md

@@ -9,18 +9,16 @@ Execute bash commands in a secure, isolated environment with an in-memory virtua
 
 Built on top of [`just-bash`](https://github.com/vercel-labs/just-bash) v2.10.2.
 
-## What's New in v2.9.0
+## What's New in v2.9.2
 
-- **Synced with upstream `just-bash` v2.10.2** - Latest upstream commands, APIs, and type exports
+- **Expanded Vercel Sandbox API coverage** - `bash_sandbox_run` now supports optional `includeOutput` and `includeLogs`
+- **Sandbox domain support** - New `bash_sandbox_domain` tool returns the current sandbox domain/identifier
+- **Synced with upstream `just-bash` v2.10.2** - Full upstream commands, APIs, and type exports
 - **Defense-in-depth mode** - Opt-in monkey-patching of dangerous JS globals (`JUST_BASH_DEFENSE_IN_DEPTH=true`)
 - **Python support** - Python3 via Pyodide (`JUST_BASH_ENABLE_PYTHON=true`)
-- **Vercel Sandbox API** - Compatible `bash_sandbox_*` tools for isolated execution
-- **oxlint/oxfmt toolchain** - Replaced tsc/biome with faster oxlint and oxfmt
-- **Configurable limits** - Fine-grained control over glob ops, string length, array size, heredoc size, and more
-- **`rg` (ripgrep)** - Fast regex search with `--files`, `-d`, `--stats`, `-t markdown`
-- **`tar`** - Archive support with compression
-- **MountableFS** - Mount multiple filesystems at different paths
-- **ReadWriteFS** - Direct read-write access to real directories
+- **Vercel Sandbox API tools** - Compatible `bash_sandbox_*` tools for isolated execution
+- **MountableFS + ReadWriteFS** - Real directory mounts with overlay/read-write options
+- **Configurable execution limits** - Fine-grained control over loops, strings, arrays, heredocs, and substitutions
 
 ## Features
 
@@ -180,7 +178,8 @@ Get current working directory or environment variables.
 
 Compatible with the Vercel Sandbox API:
 
-- `bash_sandbox_run` - Run a command in the sandbox
+- `bash_sandbox_run` - Run a command in the sandbox (optionally include structured output/logs)
+- `bash_sandbox_domain` - Get the sandbox domain/identifier
 - `bash_sandbox_write_files` - Write multiple files at once
 - `bash_sandbox_read_file` - Read a file (supports base64 encoding)
 - `bash_sandbox_mkdir` - Create a directory

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "just-bash-mcp",
-	"version": "2.9.1",
+	"version": "2.9.3",
 	"description": "MCP server providing a sandboxed bash environment using just-bash",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -60,14 +60,14 @@
 	},
 	"packageManager": "bun@1.3.8",
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.26.0",
+		"@modelcontextprotocol/sdk": "^1.27.0",
 		"just-bash": "^2.10.2",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@types/node": "^25.2.3",
+		"@types/node": "^25.3.0",
 		"oxfmt": "^0.28.0",
-		"oxlint": "^1.48.0",
+		"oxlint": "^1.50.0",
 		"oxlint-tsgolint": "^0.11.5"
 	}
 }

package/src/tools/sandbox-tools.ts

@@ -15,6 +15,7 @@ import {
 	RedirectNotAllowedError,
 	SecurityViolationError,
 	TooManyRedirectsError,
+	type OutputMessage,
 } from "just-bash";
 import { z } from "zod/v4";
 import { config } from "../config/index.ts";
@@ -61,16 +62,28 @@ export function registerSandboxTools(server: McpServer): void {
 				command: z.string().describe("The command to execute"),
 				cwd: z.string().optional().describe("Working directory for the command"),
 				env: z.record(z.string(), z.string()).optional().describe("Environment variables to set"),
+				includeOutput: z
+					.boolean()
+					.optional()
+					.describe("Include structured output messages from SandboxCommand.output()"),
+				includeLogs: z
+					.boolean()
+					.optional()
+					.describe("Include execution logs from SandboxCommand.logs()"),
 			},
 		},
 		async ({
 			command,
 			cwd,
 			env,
+			includeOutput = false,
+			includeLogs = false,
 		}: {
 			command: string;
 			cwd?: string;
 			env?: Record<string, string>;
+			includeOutput?: boolean;
+			includeLogs?: boolean;
 		}) => {
 			try {
 				const sandbox = await getPersistentSandbox();
@@ -79,20 +92,55 @@ export function registerSandboxTools(server: McpServer): void {
 				const stdout = await cmd.stdout();
 				const stderr = await cmd.stderr();
 
-				return createJsonResponse(
-					{
-						stdout: truncateOutput(stdout, config.MAX_OUTPUT_LENGTH, "stdout"),
-						stderr: truncateOutput(stderr, config.MAX_OUTPUT_LENGTH, "stderr"),
-						exitCode: result.exitCode,
-					},
-					result.exitCode !== 0,
-				);
+				const response: {
+					stdout: string;
+					stderr: string;
+					exitCode: number;
+					output?: string;
+					logs?: OutputMessage[];
+				} = {
+					stdout: truncateOutput(stdout, config.MAX_OUTPUT_LENGTH, "stdout"),
+					stderr: truncateOutput(stderr, config.MAX_OUTPUT_LENGTH, "stderr"),
+					exitCode: result.exitCode,
+				};
+
+				if (includeOutput) {
+					response.output = truncateOutput(await cmd.output(), config.MAX_OUTPUT_LENGTH, "stdout");
+				}
+				if (includeLogs) {
+					const logs: OutputMessage[] = [];
+					for await (const message of cmd.logs()) {
+						logs.push(message);
+					}
+					response.logs = logs;
+				}
+
+				return createJsonResponse(response, result.exitCode !== 0);
 			} catch (error) {
 				return classifyError(error, "Sandbox error");
 			}
 		},
 	);
 
+	// ========================================================================
+	// bash_sandbox_domain - Get sandbox domain
+	// ========================================================================
+	server.registerTool(
+		"bash_sandbox_domain",
+		{
+			description: "Get the current sandbox domain/identifier.",
+			inputSchema: {},
+		},
+		async () => {
+			try {
+				const sandbox = await getPersistentSandbox();
+				return createJsonResponse({ domain: sandbox.domain });
+			} catch (error) {
+				return classifyError(error, "Domain error");
+			}
+		},
+	);
+
 	// ========================================================================
 	// bash_sandbox_write_files - Write multiple files
 	// ========================================================================