@cloudbase/agent-tools 0.0.2

package/dist/fs/toolkit.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesystemToolkit = void 0;
+const read_tool_1 = require("./read-tool");
+const write_tool_1 = require("./write-tool");
+const edit_tool_1 = require("./edit-tool");
+const glob_tool_1 = require("./glob-tool");
+const grep_tool_1 = require("./grep-tool");
+const ls_tool_1 = require("./ls-tool");
+const str_replace_editor_1 = require("./str-replace-editor");
+const utils_1 = require("../utils");
+/**
+ * FilesystemToolkit provides a comprehensive set of file system tools
+ * with configurable modes for different use cases.
+ */
+class FilesystemToolkit extends utils_1.BaseToolkit {
+    constructor(options) {
+        super({
+            name: options.name || "filesystem-toolkit",
+            description: options.description || "Comprehensive file system operations toolkit",
+            context: options.context,
+        });
+        this.context = {
+            workingDirectory: "",
+            fsOperator: null,
+        };
+        this.context = options.context;
+        this.config = {
+            mode: options.config?.mode || "atomic",
+        };
+        options.context.fsOperator.setWorkspaceRoot(options.context.workingDirectory);
+        this.initialize();
+    }
+    /**
+     * Initialize toolkit and add tools
+     */
+    async onInitialize() {
+        this.initializeTools();
+    }
+    /**
+     * Initialize tools based on configuration
+     */
+    initializeTools() {
+        // Clear existing tools
+        this.getTools().forEach((tool) => {
+            this.removeTool(tool.name);
+        });
+        // Add file operation tools based on mode
+        if (this.config.mode === "integrated") {
+            // Integrated mode: use str-replace-editor
+            const strReplaceEditor = (0, str_replace_editor_1.createStrReplaceEditorTool)(this.context);
+            this.addTool(strReplaceEditor);
+        }
+        else {
+            // Atomic mode: use separate read, write, edit tools
+            const readTool = (0, read_tool_1.createReadTool)(this.context);
+            this.addTool(readTool);
+            const writeTool = (0, write_tool_1.createWriteTool)(this.context);
+            this.addTool(writeTool);
+            const editTool = (0, edit_tool_1.createEditTool)(this.context);
+            this.addTool(editTool);
+        }
+        // Always add utility tools
+        const globTool = (0, glob_tool_1.createGlobTool)(this.context);
+        this.addTool(globTool);
+        const grepTool = (0, grep_tool_1.createGrepTool)(this.context);
+        this.addTool(grepTool);
+        const lsTool = (0, ls_tool_1.createLsTool)(this.context);
+        this.addTool(lsTool);
+    }
+    /**
+     * Get tools by category
+     */
+    getFileOperationTools() {
+        if (this.config.mode === "integrated") {
+            return this.getTools().filter((tool) => tool.name === "str_replace_editor");
+        }
+        else {
+            return this.getTools().filter((tool) => ["read", "write", "edit"].includes(tool.name));
+        }
+    }
+    /**
+     * Get utility tools (glob, grep, ls)
+     */
+    getUtilityTools() {
+        return this.getTools().filter((tool) => ["glob", "grep", "ls"].includes(tool.name));
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Switch between integrated and atomic modes
+     */
+    switchMode(mode) {
+        if (this.config.mode !== mode) {
+            this.config.mode = mode;
+            this.initializeTools();
+        }
+    }
+    /**
+     * Get toolkit statistics
+     */
+    getStats() {
+        return {
+            mode: this.config.mode,
+        };
+    }
+}
+exports.FilesystemToolkit = FilesystemToolkit;
+//# sourceMappingURL=toolkit.js.map

package/dist/fs/toolkit.js.map

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

package/dist/fs/utils.d.ts

@@ -0,0 +1,32 @@
+import { BaseFileOperator } from "./operator/base-operator";
+import { ToolResult } from "../utils";
+export interface ExecutionContext {
+    workingDirectory: string;
+    fsOperator: BaseFileOperator;
+    messageHandler?: any;
+}
+/**
+ * Validate if a path is within the workspace directory (supports both absolute and relative paths)
+ */
+export declare function validateWorkspacePath(filePath: string, context: ExecutionContext): ToolResult | null;
+/**
+ * Safely resolve a file path (supports both absolute and relative paths)
+ */
+export declare function resolveWorkspacePath(filePath: string, context: ExecutionContext): string;
+/**
+ * Create a success response with typed data
+ */
+export declare function createSuccessResponse<TOutput = any>(data: TOutput): ToolResult<TOutput>;
+/**
+ * Validation helper for required string parameters
+ */
+export declare function validateRequiredString(value: any, paramName: string): ToolResult | null;
+/**
+ * Validation helper for file existence
+ */
+export declare function validateFileExists(context: ExecutionContext, absolutePath: string, filePath: string): Promise<ToolResult | null>;
+/**
+ * Validation helper for directory existence
+ */
+export declare function validateDirectoryExists(context: ExecutionContext, absolutePath: string, dirPath: string): Promise<ToolResult | null>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/fs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/fs/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAmB,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,CAAC,EAAE,GAAG,CAA2B;CAChD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,UAAU,GAAG,IAAI,CAoCnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,GAAG,EACjD,IAAI,EAAE,OAAO,GACZ,UAAU,CAAC,OAAO,CAAC,CAKrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CASnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa5B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAuB5B"}

package/dist/fs/utils.js

@@ -0,0 +1,133 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkspacePath = validateWorkspacePath;
+exports.resolveWorkspacePath = resolveWorkspacePath;
+exports.createSuccessResponse = createSuccessResponse;
+exports.validateRequiredString = validateRequiredString;
+exports.validateFileExists = validateFileExists;
+exports.validateDirectoryExists = validateDirectoryExists;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+/**
+ * Validate if a path is within the workspace directory (supports both absolute and relative paths)
+ */
+function validateWorkspacePath(filePath, context) {
+    try {
+        // Prevent directory traversal attacks
+        if (filePath.includes("..")) {
+            return (0, utils_1.handleToolError)('Path cannot contain ".." for security reasons', "Path validation", "security");
+        }
+        const normalizedWorkspace = path.normalize(path.resolve(context.workingDirectory));
+        // Handle both absolute and relative paths
+        let resolvedPath;
+        if (path.isAbsolute(filePath)) {
+            resolvedPath = path.normalize(filePath);
+        }
+        else {
+            resolvedPath = path.resolve(context.workingDirectory, filePath);
+        }
+        // Check if path is within workspace boundary
+        if (!resolvedPath.startsWith(normalizedWorkspace)) {
+            return (0, utils_1.handleToolError)(`Path must be within workspace directory: ${filePath}`, "Security check", "security");
+        }
+        return null; // No error
+    }
+    catch (error) {
+        return (0, utils_1.handleToolError)(error, "Path validation", "validation");
+    }
+}
+/**
+ * Safely resolve a file path (supports both absolute and relative paths)
+ */
+function resolveWorkspacePath(filePath, context) {
+    if (path.isAbsolute(filePath)) {
+        return path.normalize(filePath);
+    }
+    else {
+        return path.resolve(context.workingDirectory, filePath);
+    }
+}
+/**
+ * Create a success response with typed data
+ */
+function createSuccessResponse(data) {
+    return new utils_1.ToolResult({
+        success: true,
+        data,
+    });
+}
+/**
+ * Validation helper for required string parameters
+ */
+function validateRequiredString(value, paramName) {
+    if (!value || typeof value !== "string" || value.trim() === "") {
+        return (0, utils_1.handleToolError)(`${paramName} is required and must be a non-empty string`, "Parameter validation", "validation");
+    }
+    return null;
+}
+/**
+ * Validation helper for file existence
+ */
+async function validateFileExists(context, absolutePath, filePath) {
+    try {
+        if (!(await context.fsOperator.exists(absolutePath))) {
+            return (0, utils_1.handleToolError)(`File not found: ${filePath}`, "File existence check", "file_not_found");
+        }
+        return null;
+    }
+    catch (error) {
+        return (0, utils_1.handleToolError)(error, "File existence check", "permission");
+    }
+}
+/**
+ * Validation helper for directory existence
+ */
+async function validateDirectoryExists(context, absolutePath, dirPath) {
+    try {
+        if (!(await context.fsOperator.exists(absolutePath))) {
+            return (0, utils_1.handleToolError)(`Directory not found: ${dirPath}`, "Directory existence check", "file_not_found");
+        }
+        const stats = await context.fsOperator.stat(absolutePath);
+        if (!stats.isDirectory()) {
+            return (0, utils_1.handleToolError)(`Path is not a directory: ${dirPath}`, "Directory validation", "validation");
+        }
+        return null;
+    }
+    catch (error) {
+        return (0, utils_1.handleToolError)(error, "Directory validation", "permission");
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/fs/utils.js.map

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

package/dist/fs/write-tool.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+import { ExecutionContext } from "./utils";
+import { ToolResult } from "../utils";
+/**
+ * Write tool result with metadata
+ */
+export interface IFileWriteResult {
+    file_path: string;
+    absolute_path: string;
+    is_new_file: boolean;
+    lines_written: number;
+    bytes_written: number;
+}
+export declare function write(context: ExecutionContext, { file_path, content, create_dirs }: {
+    file_path?: string;
+    content?: string;
+    create_dirs?: boolean;
+}): Promise<ToolResult<IFileWriteResult>>;
+/**
+ * Create SuperDesign write tool with execution context
+ */
+export declare function createWriteTool(context: ExecutionContext): import("../utils").DynamicTool<z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, Record<string, unknown>, IFileWriteResult>;
+//# sourceMappingURL=write-tool.d.ts.map

package/dist/fs/write-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-tool.d.ts","sourceRoot":"","sources":["../../src/fs/write-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAQ,UAAU,EAAmB,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,KAAK,CACzB,OAAO,EAAE,gBAAgB,EACzB,EAAE,SAAc,EAAE,OAAY,EAAE,WAAkB,EAAE;;;;CAAA,GACnD,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CA0EvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB;;;8DAiBxD"}

package/dist/fs/write-tool.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.write = write;
+exports.createWriteTool = createWriteTool;
+const path = __importStar(require("path"));
+const v4_1 = require("zod/v4");
+const utils_1 = require("./utils");
+const utils_2 = require("../utils");
+async function write(context, { file_path = "", content = "", create_dirs = true }) {
+    const startTime = Date.now();
+    try {
+        // Validate workspace path (handles both absolute and relative paths)
+        const pathError = (0, utils_1.validateWorkspacePath)(file_path, context);
+        if (pathError) {
+            return pathError;
+        }
+        // Resolve absolute path within workspace
+        const absolutePath = (0, utils_1.resolveWorkspacePath)(file_path, context);
+        context.messageHandler?.currentText.append(`\n[write] Writing to file: ${file_path}\n`);
+        // Check if target is a directory
+        if (await context.fsOperator.exists(absolutePath)) {
+            const stats = await context.fsOperator.stat(absolutePath);
+            if (stats.isDirectory()) {
+                return (0, utils_2.handleToolError)(`Target path is a directory, not a file: ${file_path}`, "Path validation", "validation");
+            }
+        }
+        // Create parent directories if needed and requested
+        if (create_dirs) {
+            const dirName = path.dirname(absolutePath);
+            if (!(await context.fsOperator.exists(dirName))) {
+                await context.fsOperator.mkdir(dirName, { recursive: true });
+                context.messageHandler?.currentText.append(`\n[write] Created parent directories for: ${file_path}\n`);
+            }
+        }
+        // Determine if this is a new file or overwrite
+        const isNewFile = !(await context.fsOperator.exists(absolutePath));
+        // Write the file
+        await context.fsOperator.writeFile(absolutePath, content, "utf8");
+        const duration = Date.now() - startTime;
+        const lines = content.split("\n").length;
+        const size = Buffer.byteLength(content, "utf8");
+        context.messageHandler?.currentText.append(`\n[write] ${isNewFile ? "Created" : "Updated"} file: ${file_path} (${lines} lines, ${size} bytes) in ${duration}ms\n`);
+        const result = {
+            file_path,
+            absolute_path: absolutePath,
+            is_new_file: isNewFile,
+            lines_written: lines,
+            bytes_written: size,
+        };
+        return (0, utils_1.createSuccessResponse)(result);
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        context.messageHandler?.currentText.append(`\n[write] Error writing file: ${errorMessage} (${duration}ms)\n`);
+        return (0, utils_2.handleToolError)(error, "Write tool execution", "execution");
+    }
+}
+/**
+ * Create SuperDesign write tool with execution context
+ */
+function createWriteTool(context) {
+    return (0, utils_2.tool)((params) => write(context, params), {
+        name: "Write",
+        description: "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.",
+        schema: v4_1.z.object({
+            file_path: v4_1.z
+                .string()
+                .describe("The absolute path to the file to write (must be absolute, not relative)"),
+            content: v4_1.z.string().describe("Content to write to the file"),
+        }),
+        getDisplay: ({ name, input }) => {
+            return `> Using ${name} for tool call: ${input.file_path || ""}`;
+        },
+    });
+}
+//# sourceMappingURL=write-tool.js.map

package/dist/fs/write-tool.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { BaseTool, BaseToolkit, DynamicTool, tool, toolkitManager, ToolkitManager, ToolResult, } from "./utils";
+export { BuiltInCodeExecutor } from "./code_executers/built_in_code_executor";
+export { UnsafeLocalCodeExecutor } from "./code_executers/unsafe_local_code_executor";
+export * from "./bash";
+export * from "./fs";
+export * from "./browser";
+export * from "./mcp";
+export type * from "./types";
+export type { ToolkitEvent, ToolkitEventListener } from "./utils";
+//# 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":"AACA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,WAAW,EACX,IAAI,EACJ,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAGtF,cAAc,QAAQ,CAAC;AAGvB,cAAc,MAAM,CAAC;AAGrB,cAAc,WAAW,CAAC;AAG1B,cAAc,OAAO,CAAC;AAEtB,mBAAmB,SAAS,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnsafeLocalCodeExecutor = exports.BuiltInCodeExecutor = exports.ToolResult = exports.ToolkitManager = exports.toolkitManager = exports.tool = exports.DynamicTool = exports.BaseToolkit = exports.BaseTool = void 0;
+// Core tool system
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "BaseTool", { enumerable: true, get: function () { return utils_1.BaseTool; } });
+Object.defineProperty(exports, "BaseToolkit", { enumerable: true, get: function () { return utils_1.BaseToolkit; } });
+Object.defineProperty(exports, "DynamicTool", { enumerable: true, get: function () { return utils_1.DynamicTool; } });
+Object.defineProperty(exports, "tool", { enumerable: true, get: function () { return utils_1.tool; } });
+Object.defineProperty(exports, "toolkitManager", { enumerable: true, get: function () { return utils_1.toolkitManager; } });
+Object.defineProperty(exports, "ToolkitManager", { enumerable: true, get: function () { return utils_1.ToolkitManager; } });
+Object.defineProperty(exports, "ToolResult", { enumerable: true, get: function () { return utils_1.ToolResult; } });
+// Code executors
+var built_in_code_executor_1 = require("./code_executers/built_in_code_executor");
+Object.defineProperty(exports, "BuiltInCodeExecutor", { enumerable: true, get: function () { return built_in_code_executor_1.BuiltInCodeExecutor; } });
+var unsafe_local_code_executor_1 = require("./code_executers/unsafe_local_code_executor");
+Object.defineProperty(exports, "UnsafeLocalCodeExecutor", { enumerable: true, get: function () { return unsafe_local_code_executor_1.UnsafeLocalCodeExecutor; } });
+// Bash tools
+__exportStar(require("./bash"), exports);
+// File system tools
+__exportStar(require("./fs"), exports);
+// Browser tools
+__exportStar(require("./browser"), exports);
+// MCP integration
+__exportStar(require("./mcp"), exports);
+//# 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,mBAAmB;AACnB,iCAQiB;AAPf,iGAAA,QAAQ,OAAA;AACR,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,6FAAA,IAAI,OAAA;AACJ,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AAGZ,iBAAiB;AACjB,kFAA8E;AAArE,6HAAA,mBAAmB,OAAA;AAC5B,0FAAsF;AAA7E,qIAAA,uBAAuB,OAAA;AAEhC,aAAa;AACb,yCAAuB;AAEvB,oBAAoB;AACpB,uCAAqB;AAErB,gBAAgB;AAChB,4CAA0B;AAE1B,kBAAkB;AAClB,wCAAsB"}