wave-agent-sdk 0.6.4 → 0.7.0

package/dist/tools/multiEditTool.js

@@ -1,246 +0,0 @@
-import { readFile, writeFile } from "fs/promises";
-import { logger } from "../utils/globalLogger.js";
-import { resolvePath, getDisplayPath } from "../utils/path.js";
-import { escapeRegExp, analyzeEditMismatch } from "../utils/editUtils.js";
-import { MULTI_EDIT_TOOL_NAME, EDIT_TOOL_NAME, READ_TOOL_NAME, } from "../constants/tools.js";
-/**
- * Format compact parameter display
- */
-function formatCompactParams(args, context) {
-    const filePath = args.file_path;
-    const edits = args.edits;
-    const editCount = edits ? edits.length : 0;
-    const displayPath = getDisplayPath(filePath || "", context.workdir);
-    return `${displayPath} ${editCount} edits`;
-}
-/**
- * Multi-edit tool plugin
- */
-export const multiEditTool = {
-    name: MULTI_EDIT_TOOL_NAME,
-    formatCompactParams,
-    config: {
-        type: "function",
-        function: {
-            name: MULTI_EDIT_TOOL_NAME,
-            description: `This is a tool for making multiple edits to a single file in one operation. It is built on top of the ${EDIT_TOOL_NAME} tool and allows you to perform multiple find-and-replace operations efficiently. Prefer this tool over the ${EDIT_TOOL_NAME} tool when you need to make multiple edits to the same file.\n\nBefore using this tool:\n\n1. Use the ${READ_TOOL_NAME} tool to understand the file's contents and context\n2. Verify the directory path is correct\n\nTo make multiple file edits, provide the following:\n1. file_path: The absolute path to the file to modify (must be absolute, not relative)\n2. edits: An array of edit operations to perform, where each edit contains:\n   - old_string: The text to replace (must match the file contents exactly, including all whitespace and indentation)\n   - new_string: The edited text to replace the old_string\n   - replace_all: Replace all occurences of old_string. This parameter is optional and defaults to false.\n\nIMPORTANT:\n- All edits are applied in sequence, in the order they are provided\n- Each edit operates on the result of the previous edit\n- All edits must be valid for the operation to succeed - if any edit fails, none will be applied\n- This tool is ideal when you need to make several changes to different parts of the same file\n- For Jupyter notebooks (.ipynb files), use the NotebookEdit instead\n\nCRITICAL REQUIREMENTS:\n1. All edits follow the same requirements as the single ${EDIT_TOOL_NAME} tool\n2. The edits are atomic - either all succeed or none are applied\n3. Plan your edits carefully to avoid conflicts between sequential operations\n\nWARNING:\n- The tool will fail if edits.old_string doesn't match the file contents exactly (including whitespace)\n- The tool will fail if edits.old_string and edits.new_string are the same\n- Since edits are applied in sequence, ensure that earlier edits don't affect the text that later edits are trying to find\n\nWhen making edits:\n- Ensure all edits result in idiomatic, correct code\n- Do not leave the code in a broken state\n- Always use absolute file paths (starting with /)\n- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.\n- Use replace_all for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.`,
-            parameters: {
-                type: "object",
-                properties: {
-                    file_path: {
-                        type: "string",
-                        description: "The absolute path to the file to modify",
-                    },
-                    edits: {
-                        type: "array",
-                        items: {
-                            type: "object",
-                            properties: {
-                                old_string: {
-                                    type: "string",
-                                    description: "The text to replace",
-                                },
-                                new_string: {
-                                    type: "string",
-                                    description: "The text to replace it with",
-                                },
-                                replace_all: {
-                                    type: "boolean",
-                                    default: false,
-                                    description: "Replace all occurences of old_string (default false).",
-                                },
-                            },
-                            required: ["old_string", "new_string"],
-                            additionalProperties: false,
-                        },
-                        minItems: 1,
-                        description: "Array of edit operations to perform sequentially on the file",
-                    },
-                },
-                required: ["file_path", "edits"],
-                additionalProperties: false,
-            },
-        },
-    },
-    execute: async (args, context) => {
-        const filePath = args.file_path;
-        const edits = args.edits;
-        // Validate required parameters
-        if (!filePath || typeof filePath !== "string") {
-            return {
-                success: false,
-                content: "",
-                error: "file_path parameter is required and must be a string",
-            };
-        }
-        if (!Array.isArray(edits) || edits.length === 0) {
-            return {
-                success: false,
-                content: "",
-                error: "edits parameter is required and must be a non-empty array",
-            };
-        }
-        // Validate each edit operation
-        for (let i = 0; i < edits.length; i++) {
-            const edit = edits[i];
-            if (!edit || typeof edit !== "object") {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Edit operation ${i + 1} must be an object`,
-                };
-            }
-            if (typeof edit.old_string !== "string") {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Edit operation ${i + 1}: old_string is required and must be a string`,
-                };
-            }
-            if (typeof edit.new_string !== "string") {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Edit operation ${i + 1}: new_string is required and must be a string`,
-                };
-            }
-            if (edit.old_string === edit.new_string) {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Edit operation ${i + 1}: old_string and new_string must be different`,
-                };
-            }
-        }
-        try {
-            const resolvedPath = resolvePath(filePath, context.workdir);
-            // Read file content
-            let originalContent;
-            let isNewFile = false;
-            try {
-                originalContent = await readFile(resolvedPath, "utf-8");
-            }
-            catch (readError) {
-                // Check if this is a new file creation case (first edit has empty old_string)
-                if (edits[0] && edits[0].old_string === "") {
-                    originalContent = "";
-                    isNewFile = true;
-                    logger.debug(`Creating new file: ${resolvedPath}`);
-                }
-                else {
-                    return {
-                        success: false,
-                        content: "",
-                        error: `Failed to read file: ${readError instanceof Error ? readError.message : String(readError)}`,
-                    };
-                }
-            }
-            let currentContent = originalContent;
-            const appliedEdits = [];
-            // Apply each edit operation in sequence
-            for (let i = 0; i < edits.length; i++) {
-                const edit = edits[i];
-                const replaceAll = edit.replace_all || false;
-                // Special handling for the first edit of new file creation
-                if (isNewFile && i === 0 && edit.old_string === "") {
-                    currentContent = edit.new_string;
-                    appliedEdits.push(`Created file with content (${edit.new_string.length} characters)`);
-                    continue;
-                }
-                // Check if old_string exists
-                const matchedOldString = currentContent.includes(edit.old_string)
-                    ? edit.old_string
-                    : null;
-                if (!matchedOldString) {
-                    return {
-                        success: false,
-                        content: "",
-                        error: `Edit operation ${i + 1}: ${analyzeEditMismatch(currentContent, edit.old_string)}`,
-                    };
-                }
-                let replacementCount;
-                if (replaceAll) {
-                    // Replace all matches
-                    const regex = new RegExp(escapeRegExp(edit.old_string), "g");
-                    currentContent = currentContent.replace(regex, edit.new_string);
-                    replacementCount = (currentContent.match(regex) || []).length;
-                    appliedEdits.push(`Replaced ${replacementCount} instances of "${edit.old_string.substring(0, 50)}${edit.old_string.length > 50 ? "..." : ""}"`);
-                }
-                else {
-                    // Replace only the first match, but first check if it's unique
-                    const matches = currentContent.split(matchedOldString).length - 1;
-                    if (matches > 1) {
-                        return {
-                            success: false,
-                            content: "",
-                            error: `Edit operation ${i + 1}: old_string appears ${matches} times in the current content. Either provide a larger string with more surrounding context to make it unique or use replace_all=true.`,
-                        };
-                    }
-                    currentContent = currentContent.replace(matchedOldString, edit.new_string);
-                    appliedEdits.push(`Replaced "${edit.old_string.substring(0, 50)}${edit.old_string.length > 50 ? "..." : ""}"`);
-                }
-            }
-            // Permission check after validation but before real operation
-            if (context.permissionManager) {
-                try {
-                    const permissionContext = context.permissionManager.createContext(MULTI_EDIT_TOOL_NAME, context.permissionMode || "default", context.canUseToolCallback, { file_path: filePath, edits });
-                    const permissionResult = await context.permissionManager.checkPermission(permissionContext);
-                    if (permissionResult.behavior === "deny") {
-                        return {
-                            success: false,
-                            content: "",
-                            error: `${MULTI_EDIT_TOOL_NAME} operation denied, reason: ${permissionResult.message || "No reason provided"}`,
-                        };
-                    }
-                }
-                catch {
-                    return {
-                        success: false,
-                        content: "",
-                        error: "Permission check failed",
-                    };
-                }
-            }
-            // Record snapshot for reversion
-            let snapshotId;
-            if (context.reversionManager && context.messageId) {
-                snapshotId = await context.reversionManager.recordSnapshot(context.messageId, resolvedPath, isNewFile ? "create" : "modify");
-            }
-            // Write file
-            try {
-                await writeFile(resolvedPath, currentContent, "utf-8");
-                // Commit snapshot on success
-                if (context.reversionManager && snapshotId) {
-                    await context.reversionManager.commitSnapshot(snapshotId);
-                }
-            }
-            catch (writeError) {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Failed to write file: ${writeError instanceof Error ? writeError.message : String(writeError)}`,
-                };
-            }
-            const shortResult = isNewFile
-                ? `Created file with ${edits.length} operations`
-                : `Applied ${edits.length} edits`;
-            const detailedContent = `${shortResult}\n\nOperations performed:\n${appliedEdits.map((edit, i) => `${i + 1}. ${edit}`).join("\n")}`;
-            logger.debug(`MultiEdit tool: ${shortResult}`);
-            return {
-                success: true,
-                content: detailedContent,
-                shortResult,
-                filePath: resolvedPath,
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            logger.error(`MultiEdit tool error: ${errorMessage}`);
-            return {
-                success: false,
-                content: "",
-                error: errorMessage,
-            };
-        }
-    },
-};

package/src/tools/deleteFileTool.ts

@@ -1,127 +0,0 @@
-import { unlink } from "fs/promises";
-import { logger } from "../utils/globalLogger.js";
-import type { ToolPlugin, ToolResult, ToolContext } from "./types.js";
-import { resolvePath, getDisplayPath } from "../utils/path.js";
-import { DELETE_FILE_TOOL_NAME } from "../constants/tools.js";
-
-/**
- * Delete file tool plugin
- */
-export const deleteFileTool: ToolPlugin = {
-  name: DELETE_FILE_TOOL_NAME,
-  config: {
-    type: "function",
-    function: {
-      name: DELETE_FILE_TOOL_NAME,
-      description: `Deletes a file at the specified path. The operation will fail gracefully if:
-    - The file doesn't exist
-    - The operation is rejected for security reasons
-    - The file cannot be deleted`,
-      parameters: {
-        type: "object",
-        properties: {
-          target_file: {
-            type: "string",
-            description:
-              "The path of the file to delete, relative to the workspace root.",
-          },
-        },
-        required: ["target_file"],
-      },
-    },
-  },
-  execute: async (
-    args: Record<string, unknown>,
-    context: ToolContext,
-  ): Promise<ToolResult> => {
-    const targetFile = args.target_file as string;
-
-    if (!targetFile || typeof targetFile !== "string") {
-      return {
-        success: false,
-        content: "",
-        error: "target_file parameter is required and must be a string",
-      };
-    }
-
-    try {
-      const filePath = resolvePath(targetFile, context.workdir);
-
-      // Permission check after validation but before real operation
-      // Permission check after validation but before real operation
-      if (context.permissionManager) {
-        try {
-          const permissionContext = context.permissionManager.createContext(
-            DELETE_FILE_TOOL_NAME,
-            context.permissionMode || "default",
-            context.canUseToolCallback,
-            { target_file: targetFile },
-          );
-          const permissionResult =
-            await context.permissionManager.checkPermission(permissionContext);
-
-          if (permissionResult.behavior === "deny") {
-            return {
-              success: false,
-              content: "",
-              error: `${DELETE_FILE_TOOL_NAME} operation denied, reason: ${permissionResult.message || "No reason provided"}`,
-            };
-          }
-        } catch {
-          return {
-            success: false,
-            content: "",
-            error: "Permission check failed",
-          };
-        }
-      }
-
-      // Record snapshot for reversion
-      let snapshotId: string | undefined;
-      if (context.reversionManager && context.messageId) {
-        snapshotId = await context.reversionManager.recordSnapshot(
-          context.messageId,
-          filePath,
-          "delete",
-        );
-      }
-
-      // Delete file
-      await unlink(filePath);
-
-      // Commit snapshot on success
-      if (context.reversionManager && snapshotId) {
-        await context.reversionManager.commitSnapshot(snapshotId);
-      }
-
-      logger.debug(`Successfully deleted file: ${filePath}`);
-
-      return {
-        success: true,
-        content: `Successfully deleted file: ${targetFile}`,
-        shortResult: "File deleted",
-      };
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code === "ENOENT") {
-        return {
-          success: false,
-          content: "",
-          error: `File does not exist: ${targetFile}`,
-        };
-      }
-
-      return {
-        success: false,
-        content: "",
-        error: error instanceof Error ? error.message : String(error),
-      };
-    }
-  },
-  formatCompactParams: (
-    params: Record<string, unknown>,
-    context: ToolContext,
-  ) => {
-    const targetFile = params.target_file as string;
-    return getDisplayPath(targetFile || "", context.workdir);
-  },
-};

package/src/tools/multiEditTool.ts

@@ -1,306 +0,0 @@
-import { readFile, writeFile } from "fs/promises";
-import { logger } from "../utils/globalLogger.js";
-import type { ToolPlugin, ToolResult, ToolContext } from "./types.js";
-import { resolvePath, getDisplayPath } from "../utils/path.js";
-import { escapeRegExp, analyzeEditMismatch } from "../utils/editUtils.js";
-import {
-  MULTI_EDIT_TOOL_NAME,
-  EDIT_TOOL_NAME,
-  READ_TOOL_NAME,
-} from "../constants/tools.js";
-
-interface EditOperation {
-  old_string: string;
-  new_string: string;
-  replace_all?: boolean;
-}
-
-/**
- * Format compact parameter display
- */
-function formatCompactParams(
-  args: Record<string, unknown>,
-  context: ToolContext,
-): string {
-  const filePath = args.file_path as string;
-  const edits = args.edits as EditOperation[];
-  const editCount = edits ? edits.length : 0;
-  const displayPath = getDisplayPath(filePath || "", context.workdir);
-  return `${displayPath} ${editCount} edits`;
-}
-
-/**
- * Multi-edit tool plugin
- */
-export const multiEditTool: ToolPlugin = {
-  name: MULTI_EDIT_TOOL_NAME,
-  formatCompactParams,
-  config: {
-    type: "function",
-    function: {
-      name: MULTI_EDIT_TOOL_NAME,
-      description: `This is a tool for making multiple edits to a single file in one operation. It is built on top of the ${EDIT_TOOL_NAME} tool and allows you to perform multiple find-and-replace operations efficiently. Prefer this tool over the ${EDIT_TOOL_NAME} tool when you need to make multiple edits to the same file.\n\nBefore using this tool:\n\n1. Use the ${READ_TOOL_NAME} tool to understand the file's contents and context\n2. Verify the directory path is correct\n\nTo make multiple file edits, provide the following:\n1. file_path: The absolute path to the file to modify (must be absolute, not relative)\n2. edits: An array of edit operations to perform, where each edit contains:\n   - old_string: The text to replace (must match the file contents exactly, including all whitespace and indentation)\n   - new_string: The edited text to replace the old_string\n   - replace_all: Replace all occurences of old_string. This parameter is optional and defaults to false.\n\nIMPORTANT:\n- All edits are applied in sequence, in the order they are provided\n- Each edit operates on the result of the previous edit\n- All edits must be valid for the operation to succeed - if any edit fails, none will be applied\n- This tool is ideal when you need to make several changes to different parts of the same file\n- For Jupyter notebooks (.ipynb files), use the NotebookEdit instead\n\nCRITICAL REQUIREMENTS:\n1. All edits follow the same requirements as the single ${EDIT_TOOL_NAME} tool\n2. The edits are atomic - either all succeed or none are applied\n3. Plan your edits carefully to avoid conflicts between sequential operations\n\nWARNING:\n- The tool will fail if edits.old_string doesn't match the file contents exactly (including whitespace)\n- The tool will fail if edits.old_string and edits.new_string are the same\n- Since edits are applied in sequence, ensure that earlier edits don't affect the text that later edits are trying to find\n\nWhen making edits:\n- Ensure all edits result in idiomatic, correct code\n- Do not leave the code in a broken state\n- Always use absolute file paths (starting with /)\n- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.\n- Use replace_all for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.`,
-      parameters: {
-        type: "object",
-        properties: {
-          file_path: {
-            type: "string",
-            description: "The absolute path to the file to modify",
-          },
-          edits: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                old_string: {
-                  type: "string",
-                  description: "The text to replace",
-                },
-                new_string: {
-                  type: "string",
-                  description: "The text to replace it with",
-                },
-                replace_all: {
-                  type: "boolean",
-                  default: false,
-                  description:
-                    "Replace all occurences of old_string (default false).",
-                },
-              },
-              required: ["old_string", "new_string"],
-              additionalProperties: false,
-            },
-            minItems: 1,
-            description:
-              "Array of edit operations to perform sequentially on the file",
-          },
-        },
-        required: ["file_path", "edits"],
-        additionalProperties: false,
-      },
-    },
-  },
-  execute: async (
-    args: Record<string, unknown>,
-    context: ToolContext,
-  ): Promise<ToolResult> => {
-    const filePath = args.file_path as string;
-    const edits = args.edits as EditOperation[];
-
-    // Validate required parameters
-    if (!filePath || typeof filePath !== "string") {
-      return {
-        success: false,
-        content: "",
-        error: "file_path parameter is required and must be a string",
-      };
-    }
-
-    if (!Array.isArray(edits) || edits.length === 0) {
-      return {
-        success: false,
-        content: "",
-        error: "edits parameter is required and must be a non-empty array",
-      };
-    }
-
-    // Validate each edit operation
-    for (let i = 0; i < edits.length; i++) {
-      const edit = edits[i];
-      if (!edit || typeof edit !== "object") {
-        return {
-          success: false,
-          content: "",
-          error: `Edit operation ${i + 1} must be an object`,
-        };
-      }
-
-      if (typeof edit.old_string !== "string") {
-        return {
-          success: false,
-          content: "",
-          error: `Edit operation ${i + 1}: old_string is required and must be a string`,
-        };
-      }
-
-      if (typeof edit.new_string !== "string") {
-        return {
-          success: false,
-          content: "",
-          error: `Edit operation ${i + 1}: new_string is required and must be a string`,
-        };
-      }
-
-      if (edit.old_string === edit.new_string) {
-        return {
-          success: false,
-          content: "",
-          error: `Edit operation ${i + 1}: old_string and new_string must be different`,
-        };
-      }
-    }
-
-    try {
-      const resolvedPath = resolvePath(filePath, context.workdir);
-
-      // Read file content
-      let originalContent: string;
-      let isNewFile = false;
-
-      try {
-        originalContent = await readFile(resolvedPath, "utf-8");
-      } catch (readError) {
-        // Check if this is a new file creation case (first edit has empty old_string)
-        if (edits[0] && edits[0].old_string === "") {
-          originalContent = "";
-          isNewFile = true;
-          logger.debug(`Creating new file: ${resolvedPath}`);
-        } else {
-          return {
-            success: false,
-            content: "",
-            error: `Failed to read file: ${readError instanceof Error ? readError.message : String(readError)}`,
-          };
-        }
-      }
-
-      let currentContent = originalContent;
-      const appliedEdits: string[] = [];
-
-      // Apply each edit operation in sequence
-      for (let i = 0; i < edits.length; i++) {
-        const edit = edits[i];
-        const replaceAll = edit.replace_all || false;
-
-        // Special handling for the first edit of new file creation
-        if (isNewFile && i === 0 && edit.old_string === "") {
-          currentContent = edit.new_string;
-          appliedEdits.push(
-            `Created file with content (${edit.new_string.length} characters)`,
-          );
-          continue;
-        }
-
-        // Check if old_string exists
-        const matchedOldString = currentContent.includes(edit.old_string)
-          ? edit.old_string
-          : null;
-
-        if (!matchedOldString) {
-          return {
-            success: false,
-            content: "",
-            error: `Edit operation ${i + 1}: ${analyzeEditMismatch(currentContent, edit.old_string)}`,
-          };
-        }
-
-        let replacementCount: number;
-
-        if (replaceAll) {
-          // Replace all matches
-          const regex = new RegExp(escapeRegExp(edit.old_string), "g");
-          currentContent = currentContent.replace(regex, edit.new_string);
-          replacementCount = (currentContent.match(regex) || []).length;
-          appliedEdits.push(
-            `Replaced ${replacementCount} instances of "${edit.old_string.substring(0, 50)}${edit.old_string.length > 50 ? "..." : ""}"`,
-          );
-        } else {
-          // Replace only the first match, but first check if it's unique
-          const matches = currentContent.split(matchedOldString).length - 1;
-          if (matches > 1) {
-            return {
-              success: false,
-              content: "",
-              error: `Edit operation ${i + 1}: old_string appears ${matches} times in the current content. Either provide a larger string with more surrounding context to make it unique or use replace_all=true.`,
-            };
-          }
-
-          currentContent = currentContent.replace(
-            matchedOldString,
-            edit.new_string,
-          );
-          appliedEdits.push(
-            `Replaced "${edit.old_string.substring(0, 50)}${edit.old_string.length > 50 ? "..." : ""}"`,
-          );
-        }
-      }
-
-      // Permission check after validation but before real operation
-      if (context.permissionManager) {
-        try {
-          const permissionContext = context.permissionManager.createContext(
-            MULTI_EDIT_TOOL_NAME,
-            context.permissionMode || "default",
-            context.canUseToolCallback,
-            { file_path: filePath, edits },
-          );
-          const permissionResult =
-            await context.permissionManager.checkPermission(permissionContext);
-
-          if (permissionResult.behavior === "deny") {
-            return {
-              success: false,
-              content: "",
-              error: `${MULTI_EDIT_TOOL_NAME} operation denied, reason: ${permissionResult.message || "No reason provided"}`,
-            };
-          }
-        } catch {
-          return {
-            success: false,
-            content: "",
-            error: "Permission check failed",
-          };
-        }
-      }
-
-      // Record snapshot for reversion
-      let snapshotId: string | undefined;
-      if (context.reversionManager && context.messageId) {
-        snapshotId = await context.reversionManager.recordSnapshot(
-          context.messageId,
-          resolvedPath,
-          isNewFile ? "create" : "modify",
-        );
-      }
-
-      // Write file
-      try {
-        await writeFile(resolvedPath, currentContent, "utf-8");
-        // Commit snapshot on success
-        if (context.reversionManager && snapshotId) {
-          await context.reversionManager.commitSnapshot(snapshotId);
-        }
-      } catch (writeError) {
-        return {
-          success: false,
-          content: "",
-          error: `Failed to write file: ${writeError instanceof Error ? writeError.message : String(writeError)}`,
-        };
-      }
-
-      const shortResult = isNewFile
-        ? `Created file with ${edits.length} operations`
-        : `Applied ${edits.length} edits`;
-
-      const detailedContent = `${shortResult}\n\nOperations performed:\n${appliedEdits.map((edit, i) => `${i + 1}. ${edit}`).join("\n")}`;
-
-      logger.debug(`MultiEdit tool: ${shortResult}`);
-
-      return {
-        success: true,
-        content: detailedContent,
-        shortResult,
-        filePath: resolvedPath,
-      };
-    } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-      logger.error(`MultiEdit tool error: ${errorMessage}`);
-      return {
-        success: false,
-        content: "",
-        error: errorMessage,
-      };
-    }
-  },
-};