Method execute

src/tools/ast/edit-symbol.ts:165–291

(args: z.infer<typeof ArgsSchema>, ctx: ToolContext)

  argsSchema = ArgsSchema;

  async execute(args: z.infer<typeof ArgsSchema>, ctx: ToolContext): Promise<ToolResult> {
    const abs = path.isAbsolute(args.path) ? args.path : path.resolve(ctx.cwd, args.path);
    const rel = path.relative(ctx.cwd, abs);

    const lang = detectLanguage(abs);
    if (!lang) {
      return {
        content: `[UNSUPPORTED_LANGUAGE] No AST grammar for ${path.extname(abs)}. Use edit_text instead for this file type.`,
        isError: true,
      };
    }

    const nodeTypes = NODE_TYPES[lang]?.[args.symbol_kind];
    if (!nodeTypes) {
      return {
        content: `[UNSUPPORTED] AST editing of ${args.symbol_kind} not supported for ${lang}. Use edit_text.`,
        isError: true,
      };
    }

    let parserResult;
    try {
      parserResult = await getParser(lang);
    } catch (e: any) {
      const msg = e?.message ?? String(e);
      // Common failure: bundled .wasm grammar was built for a tree-sitter ABI
      // version that doesn't match the installed `web-tree-sitter` runtime.
      // Surface a clear, actionable message — and recommend edit_text as the
      // immediate workaround instead of looping.
      if (/Incompatible language version|abi/i.test(msg)) {
        return {
          content: `[AST_GRAMMAR_INCOMPATIBLE] The bundled tree-sitter grammar for ${lang} is incompatible with the installed runtime (${msg}). This is a packaging issue, not your code. Workaround: use \`edit_text\` for this edit — it's slightly less safe but works reliably. Don't retry edit_symbol on this file.`,
          isError: true,
        };
      }
      return {
        content: `[AST_GRAMMAR_LOAD_ERROR] Could not load grammar for ${lang}: ${msg}. Use \`edit_text\` instead.`,
        isError: true,
      };
    }
    if (!parserResult) {
      return {
        content: `[AST_UNAVAILABLE] Tree-sitter grammar for ${lang} not loaded. Use edit_text instead. To enable AST editing, install the grammar wasm into grammars/tree-sitter-${lang}.wasm`,
        isError: true,
      };
    }

    let source: string;
    try {
      source = await fs.readFile(abs, 'utf-8');
    } catch (e: any) {
      return { content: `[ERROR] Cannot read ${args.path}: ${e.message}`, isError: true };
    }

    let tree;
    try {
      tree = parserResult.parser.parse(source);
    } catch (e: any) {