feat(sandbox-blaxel): add Blaxel sandbox provider

.changeset/sandbox-blaxel.md

@@ -0,0 +1,20 @@
+---
+"@voltagent/sandbox-blaxel": minor
+---
+
+Add `@voltagent/sandbox-blaxel` — a new workspace sandbox provider that runs your agents' shell commands inside [Blaxel](https://blaxel.ai)-managed sandboxes.
+
+```ts
+import { Workspace } from "@voltagent/core";
+import { BlaxelSandbox } from "@voltagent/sandbox-blaxel";
+
+const workspace = new Workspace({
+  sandbox: new BlaxelSandbox({
+    apiKey: process.env.BL_API_KEY,
+    workspace: process.env.BL_WORKSPACE,
+    config: { name: "voltagent-prod", region: "us-pdx-1" },
+  }),
+});
+```
+
+Supports streaming stdout/stderr, per-call timeouts and `AbortSignal`, output truncation, and lazy provisioning. Reach the underlying Blaxel SDK directly via `sandbox.getSandbox()` when you need provider-specific APIs (filesystem, previews, sessions, etc.).

.gitignore

@@ -182,6 +182,9 @@ node_modules/
 # serena
 .serena
 
+# joggr
+.joggr
+
 
 # example skills
 !examples/with-workspace/workspace/skills

packages/core/src/workspace/index.ts

@@ -28,6 +28,7 @@ import type {
   LocalSandboxIsolationOptions,
   LocalSandboxIsolationProvider,
   LocalSandboxOptions,
+  NormalizedCommand,
   WorkspaceSandbox,
   WorkspaceSandboxExecuteOptions,
   WorkspaceSandboxResult,
@@ -470,6 +471,7 @@ export {
   type WorkspaceSandboxToolName,
   createWorkspaceSandboxToolkit,
   normalizeCommandAndArgs,
+  type NormalizedCommand,
   type WorkspaceSandboxToolkitOptions,
   type WorkspaceSandboxToolkitContext,
   WorkspaceSearch,

packages/core/src/workspace/sandbox/index.ts

@@ -18,3 +18,4 @@ export type {
   WorkspaceSandboxToolName,
 } from "./toolkit";
 export { normalizeCommandAndArgs } from "./command-normalization";
+export type { NormalizedCommand } from "./command-normalization";

packages/sandbox-blaxel/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@voltagent/sandbox-blaxel",
+  "description": "VoltAgent Blaxel sandbox provider",
+  "version": "2.0.0",
+  "dependencies": {
+    "@blaxel/core": "^0.2.0",
+    "es-toolkit": "^1.46.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@voltagent/core": "^2.4.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.4"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "peerDependencies": {
+    "@voltagent/core": "^2.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VoltAgent/voltagent.git",
+    "directory": "packages/sandbox-blaxel"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "types": "dist/index.d.ts"
+}

packages/sandbox-blaxel/src/constants.ts

@@ -0,0 +1,20 @@
+/**
+ * Default `defaultTimeoutMs` (60 seconds).
+ */
+export const DEFAULT_TIMEOUT_MS = 60_000;
+
+/**
+ * Default `maxOutputBytes` (5 MiB).
+ */
+export const DEFAULT_MAX_OUTPUT_BYTES = 5 * 1024 * 1024;
+
+/**
+ * Default `pollIntervalMs` (250 ms).
+ */
+export const DEFAULT_POLL_INTERVAL_MS = 250;
+
+/**
+ * Safety cap on `process.wait()` `maxWait` when `timeoutMs: 0` is set.
+ * 24h — prevents runaway poll loops if a process never terminates.
+ */
+export const NO_TIMEOUT_MAX_WAIT_MS = 24 * 60 * 60 * 1000;

packages/sandbox-blaxel/src/index.ts

@@ -0,0 +1,6 @@
+export { BlaxelSandbox } from "./sandbox";
+export type {
+  BlaxelSandboxConfig,
+  BlaxelSandboxInstance,
+  BlaxelSandboxOptions,
+} from "./types";