bash-tool 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# bash-tool
+
+Generic bash tool for AI agents, compatible with [AI SDK](https://ai-sdk.dev/).
+
+## Installation
+
+```bash
+npm install bash-tool just-bash
+```
+
+For full VM support, install `@vercel/sandbox` or another sandbox product instead of `just-bash`.
+
+## Usage
+
+```typescript
+import { createBashTool } from "bash-tool";
+import { generateText } from "ai";
+
+const { bash, tools } = await createBashTool({
+  files: {
+    "src/index.ts": "export const hello = 'world';",
+    "package.json": '{"name": "my-project"}',
+  },
+});
+
+// Use just the bash tool
+const result = await generateText({
+  model: yourModel,
+  tools: { bash },
+  prompt: "Summarize the data",
+});
+
+// Or use all tools (bash, readFile, writeFile)
+const result2 = await generateText({
+  model: yourModel,
+  tools,
+  prompt: "Generate a markdown table of shirt colors",
+});
+```
+
+## Advanced Usage
+
+### Upload a local directory
+
+```typescript
+const { bash } = await createBashTool({
+  uploadDirectory: {
+    source: "./my-project",
+    include: "**/*.{ts,json}", // optional glob filter
+  },
+});
+```
+
+### Use @vercel/sandbox for full VM
+
+```typescript
+import { Sandbox } from "@vercel/sandbox";
+
+const sandbox = await Sandbox.create();
+// Files are written to /workspace by default
+const { tools } = await createBashTool({
+  sandbox,
+  files: { "index.ts": "console.log('hello');" },
+});
+```
+
+### Use a custom just-bash instance
+
+```typescript
+import { Bash } from "just-bash";
+
+const sandbox = new Bash({ cwd: "/app" });
+const { tools } = await createBashTool({
+  sandbox,
+  destination: "/app",
+});
+```
+
+### Track tool calls
+
+```typescript
+const { tools } = await createBashTool({
+  files: { "index.ts": "export const x = 1;" },
+  onCall: (toolName, args) => {
+    console.log(`Tool called: ${toolName}`, args);
+  },
+});
+```
+
+### Custom sandbox implementation
+
+```typescript
+import { createBashTool, Sandbox } from "bash-tool";
+
+const customSandbox: Sandbox = {
+  async executeCommand(command) {
+    // Return { stdout, stderr, exitCode }
+  },
+  async readFile(path) {
+    // Return file contents
+  },
+  async writeFile(path, content) {
+    // Write file
+  },
+};
+
+const { tools } = await createBashTool({ sandbox: customSandbox });
+```
+
+## License
+
+MIT

package/dist/files/loader.d.ts

@@ -0,0 +1,14 @@
+export interface LoadFilesOptions {
+    files?: Record<string, string>;
+    uploadDirectory?: {
+        source: string;
+        include?: string;
+    };
+}
+/**
+ * Load files from inline definitions and/or a directory on disk.
+ * Returns a record of relative paths to file contents.
+ * If both are provided, inline files take precedence (override directory files).
+ */
+export declare function loadFiles(options: LoadFilesOptions): Promise<Record<string, string>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/files/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/files/loader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,CAAC,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgCjC"}

package/dist/files/loader.js

@@ -0,0 +1,35 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import fg from "fast-glob";
+/**
+ * Load files from inline definitions and/or a directory on disk.
+ * Returns a record of relative paths to file contents.
+ * If both are provided, inline files take precedence (override directory files).
+ */
+export async function loadFiles(options) {
+    const result = {};
+    // Load from directory first (so inline can override)
+    if (options.uploadDirectory) {
+        const { source, include = "**/*" } = options.uploadDirectory;
+        const absoluteSource = path.resolve(source);
+        const files = await fg(include, {
+            cwd: absoluteSource,
+            dot: true,
+            onlyFiles: true,
+            ignore: ["**/node_modules/**", "**/.git/**"],
+        });
+        await Promise.all(files.map(async (relativePath) => {
+            const absolutePath = path.join(absoluteSource, relativePath);
+            const content = await fs.readFile(absolutePath, "utf-8");
+            result[relativePath] = content;
+        }));
+    }
+    // Merge inline files (override directory files)
+    if (options.files) {
+        for (const [relativePath, content] of Object.entries(options.files)) {
+            result[relativePath] = content;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/files/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/files/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,WAAW,CAAC;AAU3B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyB;IAEzB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,qDAAqD;IACrD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;QAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;YAC9B,GAAG,EAAE,cAAc;YACnB,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;SAC7C,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;QACjC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createBashTool } from "./tool.js";
+export type { BashToolkit, CommandResult, CreateBashToolOptions, JustBashInstance, Sandbox, VercelSandboxInstance, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,OAAO,EACP,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createBashTool } from "./tool.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/sandbox/just-bash.d.ts

@@ -0,0 +1,24 @@
+import type { JustBashInstance, Sandbox } from "../types.js";
+/**
+ * Options for creating a just-bash sandbox.
+ */
+export interface JustBashSandboxOptions {
+    /** Initial files to populate the virtual filesystem */
+    files?: Record<string, string>;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Creates a Sandbox implementation using just-bash (virtual bash environment).
+ * Dynamically imports just-bash to keep it as an optional peer dependency.
+ */
+export declare function createJustBashSandbox(options?: JustBashSandboxOptions): Promise<Sandbox>;
+/**
+ * Check if an object is a just-bash Bash instance using duck-typing.
+ */
+export declare function isJustBash(obj: unknown): obj is JustBashInstance;
+/**
+ * Wraps a just-bash Bash instance to conform to our Sandbox interface.
+ */
+export declare function wrapJustBash(bashInstance: JustBashInstance): Sandbox;
+//# sourceMappingURL=just-bash.d.ts.map

package/dist/sandbox/just-bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"just-bash.d.ts","sourceRoot":"","sources":["../../src/sandbox/just-bash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,OAAO,CAAC,CAoDlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,gBAAgB,CAKhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAoCpE"}

package/dist/sandbox/just-bash.js

@@ -0,0 +1,93 @@
+/**
+ * Creates a Sandbox implementation using just-bash (virtual bash environment).
+ * Dynamically imports just-bash to keep it as an optional peer dependency.
+ */
+export async function createJustBashSandbox(options = {}) {
+    // Dynamic import to handle optional peer dependency
+    let Bash;
+    try {
+        const module = await import("just-bash");
+        Bash = module.Bash;
+    }
+    catch {
+        throw new Error('just-bash is not installed. Either install it with "npm install just-bash" or provide your own sandbox via the sandbox option.');
+    }
+    const bashEnv = new Bash({
+        files: options.files,
+        cwd: options.cwd,
+    });
+    return {
+        async executeCommand(command) {
+            const result = await bashEnv.exec(command);
+            return {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+            };
+        },
+        async readFile(filePath) {
+            const result = await bashEnv.exec(`cat "${filePath}"`);
+            if (result.exitCode !== 0) {
+                throw new Error(`Failed to read file: ${filePath}\n${result.stderr}`);
+            }
+            return result.stdout;
+        },
+        async writeFile(filePath, content) {
+            // Ensure parent directory exists
+            const dir = filePath.substring(0, filePath.lastIndexOf("/"));
+            if (dir) {
+                await bashEnv.exec(`mkdir -p "${dir}"`);
+            }
+            // Write file using heredoc to handle special characters
+            const result = await bashEnv.exec(`cat > "${filePath}" << 'BASH_TOOL_EOF'\n${content}\nBASH_TOOL_EOF`);
+            if (result.exitCode !== 0) {
+                throw new Error(`Failed to write file: ${filePath}\n${result.stderr}`);
+            }
+        },
+    };
+}
+/**
+ * Check if an object is a just-bash Bash instance using duck-typing.
+ */
+export function isJustBash(obj) {
+    if (!obj || typeof obj !== "object")
+        return false;
+    const candidate = obj;
+    // just-bash Bash class has an exec method
+    return typeof candidate.exec === "function";
+}
+/**
+ * Wraps a just-bash Bash instance to conform to our Sandbox interface.
+ */
+export function wrapJustBash(bashInstance) {
+    return {
+        async executeCommand(command) {
+            const result = await bashInstance.exec(command);
+            return {
+                stdout: result.stdout,
+                stderr: result.stderr,
+                exitCode: result.exitCode,
+            };
+        },
+        async readFile(filePath) {
+            const result = await bashInstance.exec(`cat "${filePath}"`);
+            if (result.exitCode !== 0) {
+                throw new Error(`Failed to read file: ${filePath}\n${result.stderr}`);
+            }
+            return result.stdout;
+        },
+        async writeFile(filePath, content) {
+            // Ensure parent directory exists
+            const dir = filePath.substring(0, filePath.lastIndexOf("/"));
+            if (dir) {
+                await bashInstance.exec(`mkdir -p "${dir}"`);
+            }
+            // Write file using heredoc to handle special characters
+            const result = await bashInstance.exec(`cat > "${filePath}" << 'BASH_TOOL_EOF'\n${content}\nBASH_TOOL_EOF`);
+            if (result.exitCode !== 0) {
+                throw new Error(`Failed to write file: ${filePath}\n${result.stderr}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=just-bash.js.map

package/dist/sandbox/just-bash.js.map

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

package/dist/sandbox/vercel.d.ts

@@ -0,0 +1,33 @@
+import type { Sandbox } from "../types.js";
+/**
+ * Minimal interface for the @vercel/sandbox methods we actually use.
+ * This allows proper typing without requiring the full class.
+ */
+export interface VercelSandboxLike {
+    sandboxId: string;
+    runCommand: (command: string, args?: string[]) => Promise<{
+        exitCode: number;
+        stdout: (opts?: {
+            signal?: AbortSignal;
+        }) => Promise<string>;
+        stderr: (opts?: {
+            signal?: AbortSignal;
+        }) => Promise<string>;
+    }>;
+    readFile: (file: {
+        path: string;
+    }) => Promise<NodeJS.ReadableStream | null>;
+    writeFiles: (files: {
+        path: string;
+        content: Buffer;
+    }[]) => Promise<void>;
+}
+/**
+ * Check if an object is a @vercel/sandbox instance using duck-typing.
+ */
+export declare function isVercelSandbox(obj: unknown): obj is VercelSandboxLike;
+/**
+ * Wraps a @vercel/sandbox instance to conform to our Sandbox interface.
+ */
+export declare function wrapVercelSandbox(vercelSandbox: VercelSandboxLike): Sandbox;
+//# sourceMappingURL=vercel.d.ts.map

package/dist/sandbox/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../src/sandbox/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5E,UAAU,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAUtE;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CA6B3E"}

package/dist/sandbox/vercel.js

@@ -0,0 +1,55 @@
+/**
+ * Check if an object is a @vercel/sandbox instance using duck-typing.
+ */
+export function isVercelSandbox(obj) {
+    if (!obj || typeof obj !== "object")
+        return false;
+    const candidate = obj;
+    // @vercel/sandbox Sandbox class has these characteristic properties
+    return (typeof candidate.sandboxId === "string" &&
+        typeof candidate.runCommand === "function" &&
+        typeof candidate.readFile === "function" &&
+        typeof candidate.writeFiles === "function");
+}
+/**
+ * Helper to read a stream into a string.
+ */
+async function streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+/**
+ * Wraps a @vercel/sandbox instance to conform to our Sandbox interface.
+ */
+export function wrapVercelSandbox(vercelSandbox) {
+    return {
+        async executeCommand(command) {
+            const result = await vercelSandbox.runCommand("bash", ["-c", command]);
+            const [stdout, stderr] = await Promise.all([
+                result.stdout(),
+                result.stderr(),
+            ]);
+            return {
+                stdout,
+                stderr,
+                exitCode: result.exitCode,
+            };
+        },
+        async readFile(filePath) {
+            const stream = await vercelSandbox.readFile({ path: filePath });
+            if (stream === null) {
+                throw new Error(`File not found: ${filePath}`);
+            }
+            return streamToString(stream);
+        },
+        async writeFile(filePath, content) {
+            await vercelSandbox.writeFiles([
+                { path: filePath, content: Buffer.from(content, "utf-8") },
+            ]);
+        },
+    };
+}
+//# sourceMappingURL=vercel.js.map

package/dist/sandbox/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.js","sourceRoot":"","sources":["../../src/sandbox/vercel.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,SAAS,GAAG,GAA8B,CAAC;IACjD,oEAAoE;IACpE,OAAO,CACL,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;QACvC,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;QAC1C,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU;QACxC,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,MAA6B;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAgC;IAChE,OAAO;QACL,KAAK,CAAC,cAAc,CAAC,OAAe;YAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACzC,MAAM,CAAC,MAAM,EAAE;gBACf,MAAM,CAAC,MAAM,EAAE;aAChB,CAAC,CAAC;YACH,OAAO;gBACL,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;YAC7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAChE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,OAAe;YAC/C,MAAM,aAAa,CAAC,UAAU,CAAC;gBAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;aAC3D,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,29 @@
+import type { BashToolkit, CreateBashToolOptions } from "./types.js";
+/**
+ * Creates a bash tool with tools for AI agents.
+ *
+ * @example
+ * ```typescript
+ * // Simple usage with inline files
+ * const { tools, sandbox } = await createBashTool({
+ *   files: { "src/index.ts": "export const x = 1;" },
+ * });
+ *
+ * // Upload a directory from disk
+ * const { tools, sandbox } = await createBashTool({
+ *   uploadDirectory: { source: "./my-project" },
+ * });
+ *
+ * // Use with AI SDK
+ * const result = await generateText({
+ *   model,
+ *   tools,
+ *   prompt: "List all TypeScript files",
+ * });
+ *
+ * // Cleanup
+ * await sandbox.stop();
+ * ```
+ */
+export declare function createBashTool(options?: CreateBashToolOptions): Promise<BashToolkit>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAW,MAAM,YAAY,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,WAAW,CAAC,CAiEtB"}

package/dist/tool.js

@@ -0,0 +1,95 @@
+import path from "node:path";
+import { loadFiles } from "./files/loader.js";
+import { createJustBashSandbox, isJustBash, wrapJustBash, } from "./sandbox/just-bash.js";
+import { isVercelSandbox, wrapVercelSandbox } from "./sandbox/vercel.js";
+import { createBashExecuteTool } from "./tools/bash.js";
+import { createReadFileTool } from "./tools/read-file.js";
+import { createWriteFileTool } from "./tools/write-file.js";
+const DEFAULT_DESTINATION = "/workspace";
+/**
+ * Creates a bash tool with tools for AI agents.
+ *
+ * @example
+ * ```typescript
+ * // Simple usage with inline files
+ * const { tools, sandbox } = await createBashTool({
+ *   files: { "src/index.ts": "export const x = 1;" },
+ * });
+ *
+ * // Upload a directory from disk
+ * const { tools, sandbox } = await createBashTool({
+ *   uploadDirectory: { source: "./my-project" },
+ * });
+ *
+ * // Use with AI SDK
+ * const result = await generateText({
+ *   model,
+ *   tools,
+ *   prompt: "List all TypeScript files",
+ * });
+ *
+ * // Cleanup
+ * await sandbox.stop();
+ * ```
+ */
+export async function createBashTool(options = {}) {
+    const destination = options.destination ?? DEFAULT_DESTINATION;
+    // 1. Load files from disk and/or inline
+    const loadedFiles = await loadFiles({
+        files: options.files,
+        uploadDirectory: options.uploadDirectory,
+    });
+    // 2. Prefix all file paths with destination
+    const filesWithDestination = {};
+    for (const [relativePath, content] of Object.entries(loadedFiles)) {
+        const absolutePath = path.posix.join(destination, relativePath);
+        filesWithDestination[absolutePath] = content;
+    }
+    // 3. Create or wrap sandbox
+    let sandbox;
+    if (options.sandbox) {
+        // Check @vercel/sandbox first (more specific check)
+        if (isVercelSandbox(options.sandbox)) {
+            sandbox = wrapVercelSandbox(options.sandbox);
+        }
+        else if (isJustBash(options.sandbox)) {
+            sandbox = wrapJustBash(options.sandbox);
+        }
+        else {
+            sandbox = options.sandbox;
+        }
+        // Write files to existing sandbox
+        for (const [filePath, content] of Object.entries(filesWithDestination)) {
+            await sandbox.writeFile(filePath, content);
+        }
+    }
+    else {
+        // Create just-bash sandbox with files
+        sandbox = await createJustBashSandbox({
+            files: filesWithDestination,
+            cwd: destination,
+        });
+    }
+    // 4. Create tools
+    const fileList = Object.keys(loadedFiles);
+    const bash = createBashExecuteTool({
+        sandbox,
+        cwd: destination,
+        files: fileList,
+        extraInstructions: options.extraInstructions,
+        onCall: options.onCall,
+    });
+    const tools = {
+        bash,
+        readFile: createReadFileTool({
+            sandbox,
+            onCall: options.onCall,
+        }),
+        writeFile: createWriteFileTool({
+            sandbox,
+            onCall: options.onCall,
+        }),
+    };
+    return { bash, tools, sandbox };
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { CommandResult, Sandbox } from "../types.js";
+export interface CreateBashToolOptions {
+    sandbox: Sandbox;
+    /** Working directory for command execution */
+    cwd: string;
+    /** List of file paths available in the sandbox (relative to cwd) */
+    files?: string[];
+    extraInstructions?: string;
+    onCall?: (toolName: string, args: unknown) => void;
+}
+export declare function createBashExecuteTool(options: CreateBashToolOptions): import("ai").Tool<z.ZodObject<{
+    command: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+}, {
+    command: string;
+}>, CommandResult> & {
+    execute: (args: {
+        command: string;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<CommandResult>;
+};
+//# sourceMappingURL=bash.d.ts.map

package/dist/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM1D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AA0CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;EAWnE"}

package/dist/tools/bash.js

@@ -0,0 +1,50 @@
+import { tool } from "ai";
+import { z } from "zod";
+const bashSchema = z.object({
+    command: z.string().describe("The bash command to execute"),
+});
+function generateDescription(options) {
+    const { cwd, files, extraInstructions } = options;
+    const lines = [
+        "Execute bash commands in the sandbox environment.",
+        "",
+        `WORKING DIRECTORY: ${cwd}`,
+        "All commands execute from this directory. Use relative paths from here.",
+        "",
+    ];
+    // Add file discovery hints if files are provided
+    if (files && files.length > 0) {
+        const sampleFiles = files.slice(0, 8);
+        lines.push("Available files:");
+        for (const file of sampleFiles) {
+            lines.push(`  ${file}`);
+        }
+        if (files.length > 8) {
+            lines.push(`  ... and ${files.length - 8} more files`);
+        }
+        lines.push("");
+    }
+    lines.push("Common operations:");
+    lines.push("  ls -la              # List files with details");
+    lines.push("  find . -name '*.ts' # Find files by pattern");
+    lines.push("  grep -r 'pattern' . # Search file contents");
+    lines.push("  cat <file>          # View file contents");
+    lines.push("");
+    if (extraInstructions) {
+        lines.push(extraInstructions);
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+export function createBashExecuteTool(options) {
+    const { sandbox, onCall } = options;
+    return tool({
+        description: generateDescription(options),
+        parameters: bashSchema,
+        execute: async ({ command }) => {
+            onCall?.("bash", { command });
+            return sandbox.executeCommand(command);
+        },
+    });
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC5D,CAAC,CAAC;AAYH,SAAS,mBAAmB,CAAC,OAA8B;IACzD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAElD,MAAM,KAAK,GAAa;QACtB,mDAAmD;QACnD,EAAE;QACF,sBAAsB,GAAG,EAAE;QAC3B,yEAAyE;QACzE,EAAE;KACH,CAAC;IAEF,iDAAiD;IACjD,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEtC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,iBAAiB,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEpC,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACzC,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAA0B,EAAE;YACrD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9B,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { Sandbox } from "../types.js";
+export interface CreateReadFileToolOptions {
+    sandbox: Sandbox;
+    onCall?: (toolName: string, args: unknown) => void;
+}
+export declare function createReadFileTool(options: CreateReadFileToolOptions): import("ai").Tool<z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>, {
+    content: string;
+}> & {
+    execute: (args: {
+        path: string;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        content: string;
+    }>;
+};
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB;;;;;;;aAMnB,MAAM;;;;;iBAAN,MAAM;;EAMvD"}

package/dist/tools/read-file.js

@@ -0,0 +1,18 @@
+import { tool } from "ai";
+import { z } from "zod";
+const readFileSchema = z.object({
+    path: z.string().describe("The path to the file to read"),
+});
+export function createReadFileTool(options) {
+    const { sandbox, onCall } = options;
+    return tool({
+        description: "Read the contents of a file from the sandbox.",
+        parameters: readFileSchema,
+        execute: async ({ path }) => {
+            onCall?.("readFile", { path });
+            const content = await sandbox.readFile(path);
+            return { content };
+        },
+    });
+}
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC1D,CAAC,CAAC;AAOH,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEpC,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,+CAA+C;QAC5D,UAAU,EAAE,cAAc;QAC1B,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAgC,EAAE;YACxD,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/write-file.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { Sandbox } from "../types.js";
+export interface CreateWriteFileToolOptions {
+    sandbox: Sandbox;
+    onCall?: (toolName: string, args: unknown) => void;
+}
+export declare function createWriteFileTool(options: CreateWriteFileToolOptions): import("ai").Tool<z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    path: string;
+}, {
+    content: string;
+    path: string;
+}>, {
+    success: boolean;
+}> & {
+    execute: (args: {
+        content: string;
+        path: string;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<{
+        success: boolean;
+    }>;
+};
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tools/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B;;;;;;;;;;aAOZ,OAAO;;;;;;iBAAP,OAAO;;EAMjE"}

package/dist/tools/write-file.js

@@ -0,0 +1,19 @@
+import { tool } from "ai";
+import { z } from "zod";
+const writeFileSchema = z.object({
+    path: z.string().describe("The path where the file should be written"),
+    content: z.string().describe("The content to write to the file"),
+});
+export function createWriteFileTool(options) {
+    const { sandbox, onCall } = options;
+    return tool({
+        description: "Write content to a file in the sandbox. Creates parent directories if needed.",
+        parameters: writeFileSchema,
+        execute: async ({ path, content }) => {
+            onCall?.("writeFile", { path, content });
+            await sandbox.writeFile(path, content);
+            return { success: true };
+        },
+    });
+}
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACjE,CAAC,CAAC;AAOH,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEpC,OAAO,IAAI,CAAC;QACV,WAAW,EACT,+EAA+E;QACjF,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAiC,EAAE;YAClE,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACzC,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+import type { Sandbox as VercelSandbox } from "@vercel/sandbox";
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface Sandbox {
+    executeCommand(command: string): Promise<CommandResult>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+}
+/**
+ * Duck-typed just-bash Bash instance.
+ * We detect this by checking for the exec method.
+ */
+export interface JustBashInstance {
+    exec: (command: string) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    [key: string]: unknown;
+}
+export interface CreateBashToolOptions {
+    /**
+     * Destination directory on the sandbox for files.
+     * Both `files` and `uploadDirectory` are written relative to this.
+     * Also used as the working directory for commands.
+     * @default "/workspace"
+     */
+    destination?: string;
+    /**
+     * Inline files to write to the sandbox.
+     * Keys are relative paths within `destination`.
+     * @example { "src/index.ts": "export const x = 1;" }
+     */
+    files?: Record<string, string>;
+    /**
+     * Upload a directory from disk to the sandbox.
+     */
+    uploadDirectory?: {
+        /** Path on disk (local machine) */
+        source: string;
+        /**
+         * Glob pattern to filter files.
+         * @default "**\/*"
+         */
+        include?: string;
+    };
+    /**
+     * Override the default just-bash sandbox.
+     * Accepts a @vercel/sandbox instance, just-bash Bash instance,
+     * or any object implementing Sandbox.
+     */
+    sandbox?: Sandbox | VercelSandbox | JustBashInstance;
+    /**
+     * Additional instructions to append to tool descriptions.
+     */
+    extraInstructions?: string;
+    /**
+     * Callback invoked before each tool execution.
+     */
+    onCall?: (toolName: string, args: unknown) => void;
+}
+import type { createBashExecuteTool } from "./tools/bash.js";
+import type { createReadFileTool } from "./tools/read-file.js";
+import type { createWriteFileTool } from "./tools/write-file.js";
+export interface BashToolkit {
+    /** The bash tool for direct use */
+    bash: ReturnType<typeof createBashExecuteTool>;
+    /** All tools (bash, readFile, writeFile) for passing to AI SDK */
+    tools: {
+        bash: ReturnType<typeof createBashExecuteTool>;
+        readFile: ReturnType<typeof createReadFileTool>;
+        writeFile: ReturnType<typeof createWriteFileTool>;
+    };
+    sandbox: Sandbox;
+}
+/**
+ * Re-export @vercel/sandbox Sandbox type for convenience.
+ */
+export type { Sandbox as VercelSandboxInstance } from "@vercel/sandbox";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE;QAChB,mCAAmC;QACnC,MAAM,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAErD;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAGD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC/C,kEAAkE;IAClE,KAAK,EAAE;QACL,IAAI,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;QAC/C,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;QAChD,SAAS,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;KACnD,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,YAAY,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "bash-tool",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.0",
+  "description": "Generic bash tool for AI agents, compatible with AI SDK",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "bash",
+    "ai",
+    "tool",
+    "agent",
+    "ai-sdk",
+    "sandbox",
+    "vercel"
+  ],
+  "author": "Vercel, Inc.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vercel/bash-tool.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vercel/bash-tool/issues"
+  },
+  "homepage": "https://github.com/vercel/bash-tool#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@types/node": "^22.10.0",
+    "@vercel/sandbox": "^1.1.2",
+    "ai": "^4.0.0",
+    "knip": "^5.80.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@vercel/sandbox": "*",
+    "ai": "^4.0.0",
+    "just-bash": "*"
+  },
+  "peerDependenciesMeta": {
+    "just-bash": {
+      "optional": true
+    },
+    "@vercel/sandbox": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "knip": "knip",
+    "validate": "pnpm run lint && pnpm run knip && pnpm run typecheck && pnpm run test"
+  }
+}