@cloudbase/agent-tools 0.0.2

package/dist/fs/operator/transaction/transaction-utils.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionController = exports.TransactionExecutor = void 0;
+exports.createTransactionExecutor = createTransactionExecutor;
+exports.withTransaction = withTransaction;
+const transaction_operator_1 = require("./transaction-operator");
+/**
+ * 事务执行器 - 提供便捷的事务操作方法
+ */
+class TransactionExecutor {
+    constructor(baseOperator) {
+        this.operations = [];
+        this.transactionOperator = new transaction_operator_1.TransactionFileOperator(baseOperator);
+    }
+    /**
+     * 获取事务操作器
+     */
+    getOperator() {
+        return this.transactionOperator;
+    }
+    /**
+     * 添加文件写入操作
+     */
+    writeFile(path, data, options) {
+        this.operations.push(async (op) => {
+            await op.writeFile(path, data, options);
+        });
+        return this;
+    }
+    /**
+     * 添加目录创建操作
+     */
+    mkdir(path, options) {
+        this.operations.push(async (op) => {
+            await op.mkdir(path, options);
+        });
+        return this;
+    }
+    /**
+     * 添加自定义操作
+     */
+    custom(operation) {
+        this.operations.push(operation);
+        return this;
+    }
+    /**
+     * 执行所有操作
+     */
+    async execute() {
+        await this.transactionOperator.beginTransaction();
+        try {
+            for (const operation of this.operations) {
+                await operation(this.transactionOperator);
+            }
+            await this.transactionOperator.commitTransaction();
+            return { success: true };
+        }
+        catch (error) {
+            await this.transactionOperator.rollbackTransaction();
+            return { success: false, error: error };
+        }
+        finally {
+            this.operations = []; // 清理操作列表
+        }
+    }
+    /**
+     * 在事务中执行操作
+     * @param operation 要执行的操作函数
+     * @returns 操作结果
+     */
+    async executeInTransaction(operation) {
+        await this.transactionOperator.beginTransaction();
+        try {
+            const result = await operation(this.transactionOperator);
+            await this.transactionOperator.commitTransaction();
+            return result;
+        }
+        catch (error) {
+            await this.transactionOperator.rollbackTransaction();
+            throw error;
+        }
+    }
+    /**
+     * 手动控制的事务 - 返回事务控制器
+     */
+    async createTransaction() {
+        await this.transactionOperator.beginTransaction();
+        return new TransactionController(this.transactionOperator);
+    }
+}
+exports.TransactionExecutor = TransactionExecutor;
+/**
+ * 事务控制器 - 用于手动控制事务的提交和回滚
+ */
+class TransactionController {
+    constructor(transactionOperator) {
+        this.isCompleted = false;
+        this.transactionOperator = transactionOperator;
+    }
+    /**
+     * 获取事务操作器
+     */
+    getOperator() {
+        if (this.isCompleted) {
+            throw new Error("Transaction has been completed");
+        }
+        return this.transactionOperator;
+    }
+    /**
+     * 提交事务
+     */
+    async commit() {
+        if (this.isCompleted) {
+            throw new Error("Transaction has already been completed");
+        }
+        await this.transactionOperator.commitTransaction();
+        this.isCompleted = true;
+    }
+    /**
+     * 回滚事务
+     */
+    async rollback() {
+        if (this.isCompleted) {
+            throw new Error("Transaction has already been completed");
+        }
+        await this.transactionOperator.rollbackTransaction();
+        this.isCompleted = true;
+    }
+    /**
+     * 检查事务是否已完成
+     */
+    isTransactionCompleted() {
+        return this.isCompleted;
+    }
+    /**
+     * 获取事务操作历史
+     */
+    getOperationHistory() {
+        return this.transactionOperator.getTransactionOperations();
+    }
+}
+exports.TransactionController = TransactionController;
+/**
+ * 创建事务执行器的便捷函数
+ */
+function createTransactionExecutor(baseOperator) {
+    return new TransactionExecutor(baseOperator);
+}
+/**
+ * 直接在事务中执行操作的便捷函数
+ */
+async function withTransaction(baseOperator, operation) {
+    const executor = new TransactionExecutor(baseOperator);
+    return executor.executeInTransaction(operation);
+}
+//# sourceMappingURL=transaction-utils.js.map

package/dist/fs/operator/transaction/transaction-utils.js.map

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

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

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+import { ExecutionContext } from "./utils";
+import { ToolResult } from "../utils";
+/**
+ * File read result with metadata
+ */
+export interface IFileReadResult {
+    content: string;
+    filePath: string;
+    fileType: "text" | "image" | "pdf" | "binary";
+    mimeType?: string;
+    lineCount?: number;
+    isTruncated?: boolean;
+    linesShown?: [number, number];
+    size: number;
+}
+export declare function read(context: ExecutionContext, params: {
+    file_path: string;
+    offset?: number;
+    endLine?: number;
+    limit?: number;
+    encoding?: string;
+}): Promise<ToolResult<IFileReadResult>>;
+/**
+ * Create SuperDesign read tool with execution context
+ */
+export declare function createReadTool(context: ExecutionContext): import("../utils").DynamicTool<z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, Record<string, unknown>, IFileReadResult>;
+//# sourceMappingURL=read-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-tool.d.ts","sourceRoot":"","sources":["../../src/fs/read-tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAKjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAQ,UAAU,EAAmB,MAAM,UAAU,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAkKD,wBAAsB,IAAI,CACxB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAyHtC;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB;;;;6DAwBvD"}

package/dist/fs/read-tool.js

@@ -0,0 +1,271 @@
+"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.read = read;
+exports.createReadTool = createReadTool;
+const path = __importStar(require("path"));
+const mime = __importStar(require("mime-types"));
+const v4_1 = require("zod/v4");
+const utils_1 = require("./utils");
+const utils_2 = require("../utils");
+// Constants for file processing
+const DEFAULT_MAX_LINES = 1000;
+const MAX_LINE_LENGTH = 2000;
+const MAX_FILE_SIZE_BYTES = 10 * 1024 * 1024; // 10MB
+/**
+ * Detect file type based on extension and content
+ */
+function detectFileType(context, filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mimeType = mime.lookup(filePath);
+    // Check for images
+    if (mimeType && mimeType.startsWith("image/")) {
+        return "image";
+    }
+    // Check for PDF
+    if (mimeType === "application/pdf") {
+        return "pdf";
+    }
+    // Known binary extensions
+    const binaryExtensions = [
+        ".exe",
+        ".dll",
+        ".so",
+        ".dylib",
+        ".zip",
+        ".tar",
+        ".gz",
+        ".7z",
+        ".bin",
+        ".dat",
+        ".class",
+        ".jar",
+        ".war",
+        ".pyc",
+        ".pyo",
+        ".doc",
+        ".docx",
+        ".xls",
+        ".xlsx",
+        ".ppt",
+        ".pptx",
+        ".odt",
+        ".ods",
+        ".odp",
+        ".wasm",
+        ".obj",
+        ".o",
+        ".a",
+        ".lib",
+    ];
+    if (binaryExtensions.includes(ext)) {
+        return "binary";
+    }
+    return "text";
+}
+/**
+ * Process text file content with line range support
+ */
+async function processTextFile(context, filePath, startLine, lineCount, endLine, encoding = "utf-8") {
+    const content = (await context.fsOperator.readFile(filePath, encoding)).toString();
+    const lines = content.split("\n");
+    const originalLineCount = lines.length;
+    // Handle line range
+    const actualStartLine = Math.max((startLine || 1) - 1, 0); // Convert to 0-based
+    if (endLine === undefined) {
+        const actualLineCount = lineCount || Math.min(DEFAULT_MAX_LINES, originalLineCount);
+        endLine = Math.min(actualStartLine + actualLineCount, originalLineCount);
+    }
+    if (endLine < 0) {
+        endLine += originalLineCount + 1;
+    }
+    const selectedLines = lines.slice(actualStartLine, endLine);
+    // Truncate long lines
+    let linesWereTruncated = false;
+    const processedLines = selectedLines.map((line) => {
+        if (line.length > MAX_LINE_LENGTH) {
+            linesWereTruncated = true;
+            return line.substring(0, MAX_LINE_LENGTH) + "... [line truncated]";
+        }
+        return line;
+    });
+    const contentWasTruncated = endLine < originalLineCount;
+    const isTruncated = contentWasTruncated || linesWereTruncated;
+    let processedContent = catWithLineNumbers(processedLines.join("\n"), actualStartLine);
+    // Add truncation notice
+    if (contentWasTruncated) {
+        processedContent =
+            `[Content truncated: showing lines ${actualStartLine + 1}-${endLine} of ${originalLineCount} total lines]\n\n` + processedContent;
+    }
+    else if (linesWereTruncated) {
+        processedContent =
+            `[Some lines truncated due to length (max ${MAX_LINE_LENGTH} chars)]\n\n` +
+                processedContent;
+    }
+    return {
+        content: processedContent,
+        metadata: {
+            lineCount: originalLineCount,
+            isTruncated,
+            linesShown: [actualStartLine + 1, endLine],
+        },
+    };
+}
+/**
+ * Process image or PDF file
+ */
+async function processMediaFile(context, filePath, fileType) {
+    const buffer = await context.fsOperator.readFile(filePath);
+    const mimeType = mime.lookup(filePath) || "application/octet-stream";
+    // For SuperDesign, we'll return a descriptive message rather than raw base64
+    // The actual file handling would be done by the VS Code webview
+    const fileName = path.basename(filePath);
+    const fileSize = (buffer.length / 1024).toFixed(1);
+    return {
+        content: `[${fileType.toUpperCase()} FILE: ${fileName}]\nFile size: ${fileSize} KB\nMIME type: ${mimeType}\nBase64 data available for webview display.`,
+        metadata: {
+            mimeType,
+        },
+    };
+}
+async function read(context, params) {
+    const { file_path, offset: startLine, endLine, limit: lineCount, encoding = "utf-8", } = params;
+    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 file path
+        const absolutePath = (0, utils_1.resolveWorkspacePath)(file_path, context);
+        // Check file existence
+        const fileError = await (0, utils_1.validateFileExists)(context, absolutePath, file_path);
+        if (fileError) {
+            return fileError;
+        }
+        // Check if it's a directory
+        const stats = await context.fsOperator.stat(absolutePath);
+        if (stats.isDirectory()) {
+            return (0, utils_2.handleToolError)(`Path is a directory, not a file: ${file_path}`, "Path validation", "validation");
+        }
+        // Check file size
+        if (stats.size > MAX_FILE_SIZE_BYTES) {
+            const sizeMB = (stats.size / 1024 / 1024).toFixed(1);
+            return (0, utils_2.handleToolError)(`File too large (${sizeMB}MB). Maximum size: ${MAX_FILE_SIZE_BYTES / 1024 / 1024}MB`, "File size check", "validation");
+        }
+        // Detect file type
+        const fileType = detectFileType(context, absolutePath);
+        context.messageHandler?.currentText.append(`\n[read] Reading ${fileType} file: ${file_path} (${(stats.size / 1024).toFixed(1)} KB)`);
+        let content;
+        let metadata = {};
+        // Process based on file type
+        switch (fileType) {
+            case "text": {
+                const result = await processTextFile(context, absolutePath, startLine, endLine, lineCount, encoding);
+                content = result.content;
+                metadata = result.metadata;
+                break;
+            }
+            case "image":
+            case "pdf": {
+                const result = await processMediaFile(context, absolutePath, fileType);
+                content = result.content;
+                metadata = result.metadata;
+                break;
+            }
+            case "binary": {
+                const fileName = path.basename(absolutePath);
+                const fileSize = (stats.size / 1024).toFixed(1);
+                content = `[BINARY FILE: ${fileName}]\nFile size: ${fileSize} KB\nCannot display binary content as text.`;
+                break;
+            }
+            default:
+                return (0, utils_2.handleToolError)(`Unsupported file type: ${fileType}`, "File type detection", "validation");
+        }
+        // Create result
+        const fileReadResult = {
+            content,
+            filePath: file_path || "",
+            fileType,
+            mimeType: mime.lookup(absolutePath) || undefined,
+            size: stats.size,
+            ...metadata,
+        };
+        const duration = Date.now() - startTime;
+        context.messageHandler?.currentText.append(`\n[read] File read completed in ${duration}ms\n`);
+        return (0, utils_1.createSuccessResponse)(fileReadResult);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        context.messageHandler?.currentText.append(`\n[read] Read failed: ${errorMessage}\n`);
+        return (0, utils_2.handleToolError)(error, "Read tool execution", "execution");
+    }
+}
+function catWithLineNumbers(content, offset = 0) {
+    // Split by lines
+    const lines = content.split("\n");
+    // Add line numbers to each line, consistent with cat -n format
+    const numberedLines = lines.map((line, index) => {
+        const lineNumber = index + 1 + offset;
+        // Right-align line numbers, 6-digit width, followed by tab
+        return `${lineNumber.toString().padStart(6)}\t${line}`;
+    });
+    return numberedLines.join("\n");
+}
+/**
+ * Create SuperDesign read tool with execution context
+ */
+function createReadTool(context) {
+    return (0, utils_2.tool)((params) => read(context, params), {
+        name: "Read",
+        description: "Reads a file from the local filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 2000 lines starting from the beginning of the file\n- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters\n- Any lines longer than 2000 characters will be truncated\n- Results are returned using cat -n format, with line numbers starting at 1\n- You have the capability to call multiple tools in a single response. It is always better to speculatively read multiple files as a batch that are potentially useful. \n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.",
+        schema: v4_1.z.object({
+            file_path: v4_1.z.string().describe("The absolute path to the file to read"),
+            offset: v4_1.z
+                .number()
+                .optional()
+                .describe("Optional: The number of lines to read. Only provide if the file is too large to read at once."),
+            limit: v4_1.z
+                .number()
+                .optional()
+                .describe("Optional: The line number to start reading from. Only provide if the file is too large to read at once"),
+        }),
+        getDisplay: ({ name, input }) => {
+            return `> Using ${name} for tool call: ${input.file_path || ""}`;
+        },
+    });
+}
+//# sourceMappingURL=read-tool.js.map

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

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

package/dist/fs/str-replace-editor.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+import { ExecutionContext } from "./utils";
+import { IFileReadResult } from "./read-tool";
+import { IFileWriteResult } from "./write-tool";
+import { IFileEditResult } from "./edit-tool";
+type StrReplaceEditorResult = IFileReadResult | IFileWriteResult | IFileEditResult;
+export declare function createStrReplaceEditorTool(context: ExecutionContext): import("../utils").DynamicTool<z.ZodObject<{
+    command: z.ZodEnum<{
+        grep: "grep";
+        view: "view";
+        str_replace: "str_replace";
+        create: "create";
+        insert: "insert";
+    }>;
+    path: z.ZodString;
+    view_range: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    old_str: z.ZodOptional<z.ZodString>;
+    new_str: z.ZodOptional<z.ZodString>;
+    file_text: z.ZodOptional<z.ZodString>;
+    insert_line: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, Record<string, unknown>, StrReplaceEditorResult>;
+export {};
+//# sourceMappingURL=str-replace-editor.d.ts.map

package/dist/fs/str-replace-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str-replace-editor.d.ts","sourceRoot":"","sources":["../../src/fs/str-replace-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAQ,eAAe,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAS,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAY,eAAe,EAAE,MAAM,aAAa,CAAC;AAIxD,KAAK,sBAAsB,GACvB,eAAe,GACf,gBAAgB,GAChB,eAAe,CAAC;AAmCpB,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB;;;;;;;;;;;;;;oEAwFnE"}

package/dist/fs/str-replace-editor.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStrReplaceEditorTool = createStrReplaceEditorTool;
+const v4_1 = require("zod/v4");
+const read_tool_1 = require("./read-tool");
+const write_tool_1 = require("./write-tool");
+const edit_tool_1 = require("./edit-tool");
+const utils_1 = require("../utils");
+function createStrReplaceEditorTool(context) {
+    return (0, utils_1.tool)(async ({ command, path, view_range = [], old_str, new_str, file_text, insert_line, }) => {
+        switch (command) {
+            case "view":
+                const [startLine = 0, endLine = -1] = view_range;
+                return (0, read_tool_1.read)(context, { file_path: path, offset: startLine, endLine });
+            case "str_replace":
+                return (0, edit_tool_1.editFile)(context, {
+                    file_path: path,
+                    old_string: old_str,
+                    new_string: new_str,
+                });
+            case "create":
+                return (0, write_tool_1.write)(context, { file_path: path, content: file_text });
+            case "insert": {
+                const content = (await context.fsOperator.readFile(path, "utf-8")).toString();
+                const lines = content.split("\n");
+                if (insert_line != undefined && insert_line <= lines.length) {
+                    lines.splice(insert_line + 1, 0, new_str || "");
+                }
+                return (0, write_tool_1.write)(context, { file_path: path, content: lines.join("\n") });
+            }
+            default:
+                return {
+                    success: false,
+                    error: `Unknown command: ${command}`,
+                };
+        }
+    }, {
+        name: "str-replace-editor",
+        description: "Text editor tool to view and modify text files, helping you debug, fix, and improve code or other text documents.Common indicates the operation type. Different commons require different parameters.",
+        schema: v4_1.z.object({
+            command: v4_1.z.enum(["view", "str_replace", "create", "insert", "grep"])
+                .describe(`Edit type，Must be one of:
+1. view: Examine the contents of a file or list the contents of a directory. It can read the entire file or a specific range of lines
+2. str_replace: Replace a specific string in a file with a new string. This is used for making precise edits.
+3. create: Create a new file with specified content.
+4. insert: Insert text at a specific location in a file.
+5. grep: Search for text patterns within file contents using regular expressions. Can filter by file types and paths.`),
+            path: v4_1.z.string().describe("The path to the file or directory to view."),
+            view_range: v4_1.z
+                .array(v4_1.z.number())
+                .min(2)
+                .max(2)
+                .optional()
+                .describe("Optional: An array of two integers specifying the start and end line numbers to view. Line numbers are 1-indexed, and -1 for the end line means read to the end of the file. This parameter only applies when viewing files, not directories."),
+            old_str: v4_1.z
+                .string()
+                .optional()
+                .describe("The text to replace (must match exactly, including whitespace and indentation). Is required when command is str_replace."),
+            new_str: v4_1.z
+                .string()
+                .optional()
+                .describe("The new text to insert in place of the old text. Is required when command is str_replace or insert."),
+            file_text: v4_1.z
+                .string()
+                .optional()
+                .describe("The content to write to the new file. Is required when command is create."),
+            insert_line: v4_1.z
+                .number()
+                .optional()
+                .describe("The line number after which to insert the text (0 for beginning of file). Is required when command is insert."),
+        }),
+    });
+}
+//# sourceMappingURL=str-replace-editor.js.map

package/dist/fs/str-replace-editor.js.map

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

package/dist/fs/toolkit.d.ts

@@ -0,0 +1,61 @@
+import { ExecutionContext } from "./utils";
+import { BaseToolkit, BaseTool } from "../utils";
+import { IToolkitOptions } from "../types/index";
+/**
+ * Configuration options for FilesystemToolkit
+ */
+export interface FilesystemToolkitConfig {
+    /**
+     * Mode for file editing operations
+     * - 'integrated': Use str-replace-editor tool (single tool for read/write/edit operations)
+     * - 'atomic': Use separate read, write, and edit tools
+     */
+    mode: "integrated" | "atomic";
+}
+/**
+ * Options for creating FilesystemToolkit
+ */
+export interface FilesystemToolkitOptions extends IToolkitOptions {
+    context: ExecutionContext;
+    config?: FilesystemToolkitConfig;
+}
+/**
+ * FilesystemToolkit provides a comprehensive set of file system tools
+ * with configurable modes for different use cases.
+ */
+export declare class FilesystemToolkit extends BaseToolkit {
+    context: ExecutionContext;
+    private config;
+    constructor(options: FilesystemToolkitOptions);
+    /**
+     * Initialize toolkit and add tools
+     */
+    protected onInitialize(): Promise<void>;
+    /**
+     * Initialize tools based on configuration
+     */
+    private initializeTools;
+    /**
+     * Get tools by category
+     */
+    getFileOperationTools(): BaseTool[];
+    /**
+     * Get utility tools (glob, grep, ls)
+     */
+    getUtilityTools(): BaseTool[];
+    /**
+     * Get current configuration
+     */
+    getConfig(): FilesystemToolkitConfig;
+    /**
+     * Switch between integrated and atomic modes
+     */
+    switchMode(mode: "integrated" | "atomic"): void;
+    /**
+     * Get toolkit statistics
+     */
+    getStats(): {
+        mode: string;
+    };
+}
+//# sourceMappingURL=toolkit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../../src/fs/toolkit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAQ3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IACzC,OAAO,EAAE,gBAAgB,CAG9B;IACF,OAAO,CAAC,MAAM,CAA0B;gBAE5B,OAAO,EAAE,wBAAwB;IAoB7C;;OAEG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7C;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,qBAAqB,IAAI,QAAQ,EAAE;IAYnC;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAM7B;;OAEG;IACH,SAAS,IAAI,uBAAuB;IAIpC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI;IAO/C;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;KACd;CAKF"}