{
  "name": "edit_file",
  "description": "Replace exact strings in a file, or apply multiple replacements atomically. Requires read_file on the same path first. Two modes: (1) Single — old_string + new_string replaces a unique match (fails if multiple matches unless near_line disambiguates). (2) Batch — edits array with multiple old_string/new_string pairs applied atomically. Prefer this over write_file for partial modifications. For multi-file edits when filenames are known, go directly to read_file + edit_file for each file. When asked to change something in a file, follow through with edit_file after reading — reading alone is not enough.",
  "parameters": {
    "type": "object",
    "properties": {
      "path": {
        "type": "string",
        "description": "Absolute or relative file path."
      },
      "old_string": {
        "type": "string",
        "description": "The exact text to find and replace. For multiple edits in one call, use the edits array instead."
      },
      "new_string": {
        "type": "string",
        "description": "The replacement text."
      },
      "near_line": {
        "type": "integer",
        "description": "When old_string matches multiple locations, pick the one nearest this line number."
      },
      "replace_all": {
        "type": "boolean",
        "description": "Replace ALL occurrences of old_string instead of requiring a unique match. Cannot be used with near_line or edits array."
      },
      "edits": {
        "type": "array",
        "description": "Multiple replacements to apply atomically. Each entry has old_string, new_string, and optional near_line. All edits are validated before any are applied. Preferred over multiple edit_file calls when making several changes to the same file.",
        "items": {
          "type": "object",
          "properties": {
            "old_string": { "type": "string" },
            "new_string": { "type": "string" },
            "near_line": { "type": "integer" }
          },
          "required": ["old_string", "new_string"]
        }
      }
    },
    "required": ["path"]
  },
  "task_agent": true,
  "primary_key": "old_string"
}
