[
  {
    "name": "read_file",
    "description": "Read the full UTF-8 content of a file within the allowed project paths. Use get_file_summary first to decide whether you need the full content.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Absolute or relative path to the file to read."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "list_directory",
    "description": "List files and subdirectories within an allowed directory. Shows name, type (file/dir), and size. Use this to explore the project structure.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Absolute path to the directory to list."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "search_files",
    "description": "Search for files matching a glob pattern within an allowed directory. Supports recursive patterns like '**/*.py'. Use this to find files by extension or name pattern.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Absolute path to the directory to search within."
        },
        "pattern": {
          "type": "string",
          "description": "Glob pattern, e.g. '*.py', '**/*.toml', 'src/**/*.rs'."
        }
      },
      "required": [
        "path",
        "pattern"
      ]
    }
  },
  {
    "name": "get_file_summary",
    "description": "Get a compact heuristic summary of a file without reading its full content. For Python: imports, classes, methods, functions, constants. For TOML: table keys. For Markdown: headings. Others: line count + preview. Use this before read_file to decide if you need the full content.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Absolute or relative path to the file to summarise."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "py_get_skeleton",
    "description": "Get a skeleton view of a Python file. This returns all classes and function signatures with their docstrings, but replaces function bodies with '...'. Use this to understand module interfaces without reading the full implementation.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "py_get_code_outline",
    "description": "Get a hierarchical outline of a code file. This returns classes, functions, and methods with their line ranges and brief docstrings. Use this to quickly map out a file's structure before reading specific sections.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the code file (currently supports .py)."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "get_file_slice",
    "description": "Read a specific line range from a file. Useful for reading parts of very large files.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the file."
        },
        "start_line": {
          "type": "integer",
          "description": "1-based start line number."
        },
        "end_line": {
          "type": "integer",
          "description": "1-based end line number (inclusive)."
        }
      },
      "required": [
        "path",
        "start_line",
        "end_line"
      ]
    }
  },
  {
    "name": "set_file_slice",
    "description": "Replace a specific line range in a file with new content. Surgical edit tool.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the file."
        },
        "start_line": {
          "type": "integer",
          "description": "1-based start line number."
        },
        "end_line": {
          "type": "integer",
          "description": "1-based end line number (inclusive)."
        },
        "new_content": {
          "type": "string",
          "description": "New content to insert."
        }
      },
      "required": [
        "path",
        "start_line",
        "end_line",
        "new_content"
      ]
    }
  },
  {
    "name": "py_get_definition",
    "description": "Get the full source code of a specific class, function, or method definition. This is more efficient than reading the whole file if you know what you're looking for.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "The name of the class or function to retrieve. Use 'ClassName.method_name' for methods."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "py_update_definition",
    "description": "Surgically replace the definition of a class or function in a Python file using AST to find line ranges.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of class/function/method."
        },
        "new_content": {
          "type": "string",
          "description": "Complete new source for the definition."
        }
      },
      "required": [
        "path",
        "name",
        "new_content"
      ]
    }
  },
  {
    "name": "py_get_signature",
    "description": "Get only the signature part of a Python function or method (from def until colon).",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of the function/method (e.g. 'ClassName.method_name')."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "py_set_signature",
    "description": "Surgically replace only the signature of a Python function or method.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of the function/method."
        },
        "new_signature": {
          "type": "string",
          "description": "Complete new signature string (including def and trailing colon)."
        }
      },
      "required": [
        "path",
        "name",
        "new_signature"
      ]
    }
  },
  {
    "name": "py_get_class_summary",
    "description": "Get a summary of a Python class, listing its docstring and all method signatures.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of the class."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "py_get_var_declaration",
    "description": "Get the assignment/declaration line for a variable.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of the variable."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "py_set_var_declaration",
    "description": "Surgically replace a variable assignment/declaration.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of the variable."
        },
        "new_declaration": {
          "type": "string",
          "description": "Complete new assignment/declaration string."
        }
      },
      "required": [
        "path",
        "name",
        "new_declaration"
      ]
    }
  },
  {
    "name": "get_git_diff",
    "description": "Returns the git diff for a file or directory. Use this to review changes efficiently without reading entire files.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the file or directory."
        },
        "base_rev": {
          "type": "string",
          "description": "Base revision (e.g. 'HEAD', 'HEAD~1', or a commit hash). Defaults to 'HEAD'."
        },
        "head_rev": {
          "type": "string",
          "description": "Head revision (optional)."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "web_search",
    "description": "Search the web using DuckDuckGo. Returns the top 5 search results with titles, URLs, and snippets. Chain this with fetch_url to read specific pages.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "The search query."
        }
      },
      "required": [
        "query"
      ]
    }
  },
  {
    "name": "fetch_url",
    "description": "Fetch the full text content of a URL (stripped of HTML tags). Use this after web_search to read relevant information from the web.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "description": "The full URL to fetch."
        }
      },
      "required": [
        "url"
      ]
    }
  },
  {
    "name": "get_ui_performance",
    "description": "Get a snapshot of the current UI performance metrics, including FPS, Frame Time (ms), CPU usage (%), and Input Lag (ms). Use this to diagnose UI slowness or verify that your changes haven't degraded the user experience.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "py_find_usages",
    "description": "Finds exact string matches of a symbol in a given file or directory.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to file or directory to search."
        },
        "name": {
          "type": "string",
          "description": "The symbol/string to search for."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "py_get_imports",
    "description": "Parses a file's AST and returns a strict list of its dependencies.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "py_check_syntax",
    "description": "Runs a quick syntax check on a Python file.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "py_get_hierarchy",
    "description": "Scans the project to find subclasses of a given class.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Directory path to search in."
        },
        "class_name": {
          "type": "string",
          "description": "Name of the base class."
        }
      },
      "required": [
        "path",
        "class_name"
      ]
    }
  },
  {
    "name": "py_get_docstring",
    "description": "Extracts the docstring for a specific module, class, or function.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Path to the .py file."
        },
        "name": {
          "type": "string",
          "description": "Name of symbol or 'module' for the file docstring."
        }
      },
      "required": [
        "path",
        "name"
      ]
    }
  },
  {
    "name": "get_tree",
    "description": "Returns a directory structure up to a max depth.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "Directory path."
        },
        "max_depth": {
          "type": "integer",
          "description": "Maximum depth to recurse (default 2)."
        }
      },
      "required": [
        "path"
      ]
    }
  },
  {
    "name": "run_powershell",
    "description": "Run a PowerShell script within the project base_dir. Use this to create, edit, rename, or delete files and directories. The working directory is set to base_dir automatically. stdout and stderr are returned to you as the result.",
    "parametersJsonSchema": {
      "type": "object",
      "properties": {
        "script": {
          "type": "string",
          "description": "The PowerShell script to execute."
        }
      },
      "required": [
        "script"
      ]
    }
  }
]
