@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/estructural/buscar.js

@@ -0,0 +1,261 @@
+/**
+ * Búsqueda por FORMA sintáctica, no por texto.
+ *
+ * `grep "function foo"` encuentra la declaración, el comentario que la
+ * menciona y la cadena que la nombra en un mensaje de error: para `grep`, las
+ * tres líneas son iguales, texto que casa con el patrón. Esto camina el AST
+ * real de TypeScript, así que un comentario (trivia, no nodo) o una cadena
+ * (`StringLiteral`, un tipo de nodo que ninguno de nuestros patrones pide)
+ * nunca pueden colar como si fueran la declaración.
+ *
+ * Mismo compilador que ya usa `edicion/parseo.ts`: sin dependencias nuevas, y
+ * ya sabemos que acierta en sintaxis (no en tipos, que es justo lo que no
+ * hace falta para esto). Cubre `.ts/.tsx/.js/.jsx` y sus variantes de módulo;
+ * el resto de lenguajes de programación conocidos se declaran SIN COBERTURA
+ * en vez de callarse y devolver cero resultados, que es indistinguible de "no
+ * hay nada que encontrar" y por eso miente.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import ts from "typescript";
+/** Alias en español e inglés para el mismo tipo de patrón. */
+const ALIAS_TIPO = {
+    funcion: "funcion",
+    function: "funcion",
+    func: "funcion",
+    clase: "clase",
+    class: "clase",
+    tipo: "tipo",
+    type: "tipo",
+    interfaz: "tipo",
+    interface: "tipo",
+    llamada: "llamada",
+    call: "llamada",
+    import: "import",
+    importacion: "import",
+    propiedad: "propiedad",
+    property: "propiedad",
+    prop: "propiedad",
+};
+/**
+ * `null` = el patrón no tiene la forma `tipo:nombre` que entendemos.
+ *
+ * Se corta en el PRIMER `:` a propósito: `import:node:fs` tiene que dejar
+ * `nombre = "node:fs"` intacto, con su propio `:` de módulo interno de Node.
+ */
+export function parsearPatron(cadena) {
+    const separador = cadena.indexOf(":");
+    if (separador === -1)
+        return null;
+    const tipo = ALIAS_TIPO[cadena.slice(0, separador).trim().toLowerCase()];
+    const nombre = cadena.slice(separador + 1).trim();
+    if (!tipo || nombre === "")
+        return null;
+    return { tipo, nombre };
+}
+/** Lo que este buscador sabe LEER de verdad (parsea con el compilador de TS). */
+const EXTENSIONES_CUBIERTAS = new Set([".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"]);
+/**
+ * Lenguajes de programación que reconocemos pero que este buscador NO sabe
+ * leer. Un `.py`, un `.go`, un componente `.vue`... tienen que salir como "sin
+ * cobertura", no como "cero coincidencias": lo segundo es indistinguible de
+ * haber buscado de verdad y no encontrar nada.
+ *
+ * Los ficheros que no son código en absoluto (`.json`, `.md`, imágenes...) no
+ * entran aquí: nunca pretendimos cubrirlos, así que no hay nada que avisar.
+ */
+const EXTENSIONES_OTRO_LENGUAJE = new Set([
+    ".py",
+    ".go",
+    ".rs",
+    ".java",
+    ".rb",
+    ".php",
+    ".c",
+    ".h",
+    ".cpp",
+    ".hpp",
+    ".cc",
+    ".cs",
+    ".swift",
+    ".kt",
+    ".kts",
+    ".scala",
+    ".sh",
+    ".bash",
+    ".zsh",
+    ".lua",
+    ".pl",
+    ".ex",
+    ".exs",
+    ".erl",
+    ".hs",
+    ".clj",
+    ".dart",
+    ".m",
+    ".mm",
+    ".vue",
+    ".svelte",
+]);
+function extensionDe(ruta) {
+    const punto = ruta.lastIndexOf(".");
+    return punto === -1 ? "" : ruta.slice(punto).toLowerCase();
+}
+export function extensionCubierta(ruta) {
+    return EXTENSIONES_CUBIERTAS.has(extensionDe(ruta));
+}
+export function esOtroLenguajeConocido(ruta) {
+    return EXTENSIONES_OTRO_LENGUAJE.has(extensionDe(ruta));
+}
+const DIRS_IGNORADOS = new Set(["node_modules", "dist", "build", "out", "coverage", ".next", ".turbo", ".cache"]);
+/**
+ * Todos los ficheros bajo `raiz` (o `[raiz]` si ya es un fichero).
+ *
+ * Sin `fd` ni glob: un recorrido a mano basta para lo que pide esta tool, y
+ * evita depender de un binario externo para algo que `readdirSync` ya resuelve.
+ * Se saltan los directorios ocultos y los de artefactos de build, igual que
+ * haría cualquier búsqueda de código real.
+ */
+export function listarFicheros(raiz) {
+    let info;
+    try {
+        info = statSync(raiz);
+    }
+    catch {
+        return [];
+    }
+    if (info.isFile())
+        return [raiz];
+    if (!info.isDirectory())
+        return [];
+    const resultado = [];
+    const pila = [raiz];
+    while (pila.length > 0) {
+        const dir = pila.pop();
+        let entradas;
+        try {
+            entradas = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entrada of entradas) {
+            if (entrada.name.startsWith("."))
+                continue; // .git, .cache, etc.
+            const ruta = join(dir, entrada.name);
+            if (entrada.isSymbolicLink())
+                continue; // evita ciclos por symlink
+            if (entrada.isDirectory()) {
+                if (!DIRS_IGNORADOS.has(entrada.name))
+                    pila.push(ruta);
+                continue;
+            }
+            if (entrada.isFile())
+                resultado.push(ruta);
+        }
+    }
+    return resultado;
+}
+function nombreDeCallee(expr) {
+    if (ts.isIdentifier(expr))
+        return expr.text;
+    if (ts.isPropertyAccessExpression(expr) && ts.isIdentifier(expr.name))
+        return expr.name.text;
+    return null;
+}
+function nombreDePropiedad(nombre) {
+    if (ts.isIdentifier(nombre) || ts.isPrivateIdentifier(nombre))
+        return nombre.text;
+    if (ts.isStringLiteral(nombre))
+        return nombre.text;
+    return null;
+}
+/** ¿Este nodo del AST es la declaración/uso que pide el patrón? */
+function coincideNodo(nodo, patron) {
+    switch (patron.tipo) {
+        case "funcion":
+            if (ts.isFunctionDeclaration(nodo))
+                return nodo.name?.text === patron.nombre;
+            if (ts.isVariableDeclaration(nodo) && ts.isIdentifier(nodo.name) && nodo.initializer) {
+                return (nodo.name.text === patron.nombre &&
+                    (ts.isArrowFunction(nodo.initializer) || ts.isFunctionExpression(nodo.initializer)));
+            }
+            if (ts.isMethodDeclaration(nodo))
+                return nombreDePropiedad(nodo.name) === patron.nombre;
+            return false;
+        case "clase":
+            return ts.isClassDeclaration(nodo) && nodo.name?.text === patron.nombre;
+        case "tipo":
+            if (ts.isTypeAliasDeclaration(nodo))
+                return nodo.name.text === patron.nombre;
+            if (ts.isInterfaceDeclaration(nodo))
+                return nodo.name.text === patron.nombre;
+            return false;
+        case "llamada":
+            return ts.isCallExpression(nodo) && nombreDeCallee(nodo.expression) === patron.nombre;
+        case "import":
+            return (ts.isImportDeclaration(nodo) &&
+                ts.isStringLiteral(nodo.moduleSpecifier) &&
+                nodo.moduleSpecifier.text === patron.nombre);
+        case "propiedad":
+            if (ts.isPropertyAssignment(nodo) || ts.isPropertySignature(nodo) || ts.isPropertyDeclaration(nodo)) {
+                return nombreDePropiedad(nodo.name) === patron.nombre;
+            }
+            if (ts.isShorthandPropertyAssignment(nodo))
+                return nodo.name.text === patron.nombre;
+            return false;
+    }
+}
+/** Todos los nodos de `fuente` que coinciden con `patron`, en orden de aparición. */
+export function nodosCoincidentes(fuente, patron) {
+    const resultado = [];
+    const visitar = (nodo) => {
+        if (coincideNodo(nodo, patron))
+            resultado.push(nodo);
+        ts.forEachChild(nodo, visitar);
+    };
+    visitar(fuente);
+    return resultado;
+}
+function lineaYFragmento(fuente, posicion) {
+    const { line } = fuente.getLineAndCharacterOfPosition(posicion);
+    const texto = fuente.text.split("\n")[line] ?? "";
+    return { linea: line + 1, fragmento: texto.trim().slice(0, 200) };
+}
+/**
+ * `null` = el patrón no se entendió (fallo de lectura, no "no hay nada").
+ *
+ * `raices` son rutas absolutas (ficheros o directorios); `cwd` solo se usa
+ * para dejar las rutas del resultado relativas y legibles.
+ */
+export function buscarEstructural(patronCadena, raices, cwd) {
+    const patron = parsearPatron(patronCadena);
+    if (!patron)
+        return null;
+    const coincidencias = [];
+    const noCubiertos = new Set();
+    for (const raiz of raices) {
+        for (const ruta of listarFicheros(raiz)) {
+            const relativa = relative(cwd, ruta) || ruta;
+            if (esOtroLenguajeConocido(ruta)) {
+                noCubiertos.add(relativa);
+                continue;
+            }
+            if (!extensionCubierta(ruta))
+                continue; // no es código: ni cobertura ni aviso
+            let codigo;
+            try {
+                codigo = readFileSync(ruta, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            const fuente = ts.createSourceFile(ruta, codigo, ts.ScriptTarget.Latest, false);
+            for (const nodo of nodosCoincidentes(fuente, patron)) {
+                coincidencias.push({ ruta: relativa, ...lineaYFragmento(fuente, nodo.getStart(fuente)) });
+            }
+        }
+    }
+    return { coincidencias, noCubiertos: [...noCubiertos].sort() };
+}
+//# sourceMappingURL=buscar.js.map

package/dist/core/estructural/buscar.js.map

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

package/dist/core/estructural/editar.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Edición por FORMA sintáctica: sustituye el nodo que coincide, no el texto
+ * que se le parece.
+ *
+ * La otra cara del mismo problema que `buscar.ts`: un `sed`/reemplazo de
+ * cadenas que renombra `foo` también renombra la cadena `"llama a foo()"` y el
+ * comentario `// foo hace el cálculo`, porque para texto plano las tres cosas
+ * son la misma palabra. Aquí se sustituye el NODO — el rango exacto que ocupa
+ * la declaración, la llamada o el import en el AST — así que lo que no es ese
+ * nodo no se toca, sea lo que sea que diga.
+ *
+ * Reindenta las líneas del reemplazo que no sean la primera con la
+ * indentación de la línea del sitio: sin esto, sustituir una declaración
+ * multilínea deja el cuerpo pegado al margen izquierdo.
+ */
+export interface CambioEstructural {
+    ruta: string;
+    linea: number;
+    antes: string;
+    despues: string;
+}
+export interface ResultadoEdicionEstructural {
+    cambios: CambioEstructural[];
+    /** Ficheros de código en un lenguaje que no sabemos editar. Igual que en la búsqueda: nunca se disfraza de "nada que cambiar". */
+    noCubiertos: string[];
+    /** Rutas cuya edición dejó de parsear (antes sí, después no). Se aplica igual, como `edit`/`write`: se avisa, no se bloquea en silencio. */
+    rompieronParseo: string[];
+}
+/**
+ * `null` = el patrón no se entendió. `aplicar: false` calcula los cambios sin
+ * tocar disco; `aplicar: true` escribe cada fichero que cambió.
+ */
+export declare function editarEstructural(patronCadena: string, out: string, raices: string[], cwd: string, opciones: {
+    aplicar: boolean;
+}): ResultadoEdicionEstructural | null;
+//# sourceMappingURL=editar.d.ts.map

package/dist/core/estructural/editar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editar.d.ts","sourceRoot":"","sources":["../../../src/core/estructural/editar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC3C,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kIAAkI;IAClI,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4IAA4I;IAC5I,eAAe,EAAE,MAAM,EAAE,CAAC;CAC1B;AAmED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,2BAA2B,GAAG,IAAI,CAoCpC"}

package/dist/core/estructural/editar.js

@@ -0,0 +1,123 @@
+/**
+ * Edición por FORMA sintáctica: sustituye el nodo que coincide, no el texto
+ * que se le parece.
+ *
+ * La otra cara del mismo problema que `buscar.ts`: un `sed`/reemplazo de
+ * cadenas que renombra `foo` también renombra la cadena `"llama a foo()"` y el
+ * comentario `// foo hace el cálculo`, porque para texto plano las tres cosas
+ * son la misma palabra. Aquí se sustituye el NODO — el rango exacto que ocupa
+ * la declaración, la llamada o el import en el AST — así que lo que no es ese
+ * nodo no se toca, sea lo que sea que diga.
+ *
+ * Reindenta las líneas del reemplazo que no sean la primera con la
+ * indentación de la línea del sitio: sin esto, sustituir una declaración
+ * multilínea deja el cuerpo pegado al margen izquierdo.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { relative } from "node:path";
+import ts from "typescript";
+import { parsea } from "../edicion/parseo.js";
+import { esOtroLenguajeConocido, extensionCubierta, listarFicheros, nodosCoincidentes, parsearPatron, } from "./buscar.js";
+/** La indentación (espacios/tabs) con la que empieza la línea que contiene `posicion`. */
+function indentacionDeLinea(fuente, posicion) {
+    const { line } = fuente.getLineAndCharacterOfPosition(posicion);
+    const texto = fuente.text.split("\n")[line] ?? "";
+    return texto.match(/^[ \t]*/)?.[0] ?? "";
+}
+/** Las líneas 2+ del reemplazo, alineadas con la indentación del sitio donde entra. */
+function reindentar(texto, indentacion) {
+    return texto
+        .split("\n")
+        .map((l, i) => (i === 0 ? l : indentacion + l))
+        .join("\n");
+}
+/**
+ * Descarta los nodos coincidentes que caen DENTRO del rango de otro nodo
+ * coincidente (mismo patrón anidado en sí mismo: `{ id: { id: 1 } }` para
+ * `propiedad:id`, `foo(foo(1))` para `llamada:foo`, una función sombreada
+ * dentro de otra con el mismo nombre para `funcion:foo`...).
+ *
+ * Sin esto, sustituir el de fuera desplaza el texto y dos rangos que se
+ * solapan se aplican con offsets que ya no encajan: cortan por mitad de un
+ * literal y dejan basura sintáctica — a veces detectada por `parsea()`
+ * después del hecho, a veces no (si por casualidad el resultado seguía
+ * siendo JS válido, aunque mutilado). El nodo de dentro de todos modos
+ * desaparece cuando se sustituye el de fuera, así que editarlo aparte no
+ * tiene sentido: solo sobreviven los nodos que no están contenidos en
+ * ningún otro nodo coincidente.
+ */
+function sinAnidados(nodos, fuente) {
+    return nodos.filter((nodo) => {
+        const inicio = nodo.getStart(fuente);
+        const fin = nodo.getEnd();
+        return !nodos.some((otro) => otro !== nodo && otro.getStart(fuente) <= inicio && otro.getEnd() >= fin);
+    });
+}
+/** Sustituye en un fichero ya parseado todos los nodos que coinciden. `null` si ninguno coincidió. */
+function reescribirFuente(fuente, patron, out) {
+    const nodos = sinAnidados(nodosCoincidentes(fuente, patron), fuente);
+    if (nodos.length === 0)
+        return null;
+    // De atrás hacia adelante: sustituir un nodo de más adelante en el fichero no
+    // desplaza la posición de los que quedan por delante en el texto.
+    const ordenados = [...nodos].sort((a, b) => b.getStart(fuente) - a.getStart(fuente));
+    let contenido = fuente.text;
+    const cambios = [];
+    for (const nodo of ordenados) {
+        const inicio = nodo.getStart(fuente);
+        const fin = nodo.getEnd();
+        const antes = contenido.slice(inicio, fin);
+        const despues = reindentar(out, indentacionDeLinea(fuente, inicio));
+        contenido = contenido.slice(0, inicio) + despues + contenido.slice(fin);
+        const { line } = fuente.getLineAndCharacterOfPosition(inicio);
+        cambios.push({ linea: line + 1, antes, despues });
+    }
+    cambios.reverse(); // en orden de aparición en el fichero, no en orden de sustitución
+    return { contenido, cambios };
+}
+/**
+ * `null` = el patrón no se entendió. `aplicar: false` calcula los cambios sin
+ * tocar disco; `aplicar: true` escribe cada fichero que cambió.
+ */
+export function editarEstructural(patronCadena, out, raices, cwd, opciones) {
+    const patron = parsearPatron(patronCadena);
+    if (!patron)
+        return null;
+    const cambios = [];
+    const noCubiertos = new Set();
+    const rompieronParseo = [];
+    for (const raiz of raices) {
+        for (const ruta of listarFicheros(raiz)) {
+            const relativa = relative(cwd, ruta) || ruta;
+            if (esOtroLenguajeConocido(ruta)) {
+                noCubiertos.add(relativa);
+                continue;
+            }
+            if (!extensionCubierta(ruta))
+                continue;
+            let codigo;
+            try {
+                codigo = readFileSync(ruta, "utf-8");
+            }
+            catch {
+                continue;
+            }
+            const fuente = ts.createSourceFile(ruta, codigo, ts.ScriptTarget.Latest, false);
+            const resultado = reescribirFuente(fuente, patron, out);
+            if (!resultado)
+                continue;
+            for (const c of resultado.cambios)
+                cambios.push({ ruta: relativa, ...c });
+            // Avisar, no bloquear: es la misma regla que ya sigue `edit`/`write` vía
+            // `ObservadorDeEdiciones`, y esta tool no pasa por ahí porque toca varios
+            // ficheros con un `path` que es un ámbito, no la ruta de un solo fichero.
+            if (parsea(codigo, ruta) === true && parsea(resultado.contenido, ruta) === false) {
+                rompieronParseo.push(relativa);
+            }
+            if (opciones.aplicar)
+                writeFileSync(ruta, resultado.contenido, "utf-8");
+        }
+    }
+    return { cambios, noCubiertos: [...noCubiertos].sort(), rompieronParseo };
+}
+//# sourceMappingURL=editar.js.map

package/dist/core/estructural/editar.js.map

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

package/dist/core/estructural/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `ast_search` y `ast_edit`: la búsqueda y la edición estructural, como tools
+ * del agente.
+ *
+ * El renderizado se deja al genérico (`ToolDefinition.renderCall/renderResult`
+ * son opcionales): igual que `crearBrowserTools`, la caja de texto por
+ * defecto ya vale para lo que devuelven estas dos.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+export declare function crearEstructuralTools(cwd: string): Record<string, ToolDefinition>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/core/estructural/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/core/estructural/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA6G9E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAKjF"}

package/dist/core/estructural/tools.js

@@ -0,0 +1,100 @@
+/**
+ * `ast_search` y `ast_edit`: la búsqueda y la edición estructural, como tools
+ * del agente.
+ *
+ * El renderizado se deja al genérico (`ToolDefinition.renderCall/renderResult`
+ * son opcionales): igual que `crearBrowserTools`, la caja de texto por
+ * defecto ya vale para lo que devuelven estas dos.
+ */
+import { Type } from "typebox";
+import { resolveToCwd } from "../tools/path-utils.js";
+import { buscarEstructural } from "./buscar.js";
+import { editarEstructural } from "./editar.js";
+const AYUDA_PATRON = 'Patrón estructural "tipo:nombre". tipo es uno de: funcion, clase, tipo, llamada, import, propiedad. ' +
+    'Ejemplos: "funcion:procesarPedido", "clase:Cliente", "llamada:fetch", "import:react", "propiedad:id".';
+function rutasDe(pathParam, cwd) {
+    const crudas = (pathParam ?? ".")
+        .split(";")
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    return (crudas.length > 0 ? crudas : ["."]).map((p) => resolveToCwd(p, cwd));
+}
+function texto(t) {
+    return { content: [{ type: "text", text: t }], details: undefined };
+}
+function avisoNoCubiertos(noCubiertos) {
+    if (noCubiertos.length === 0)
+        return "";
+    return `\n\nSin cobertura estructural (no es .ts/.tsx/.js/.jsx), no se han mirado: ${noCubiertos.join(", ")}`;
+}
+const astSearchSchema = Type.Object({
+    pat: Type.String({ description: AYUDA_PATRON }),
+    path: Type.Optional(Type.String({ description: 'Fichero o directorio a buscar; varios separados por ";" (default: ".")' })),
+});
+function crearAstSearchTool(cwd) {
+    return {
+        name: "ast_search",
+        label: "Búsqueda estructural",
+        promptSnippet: "buscar una declaración/llamada/import por su FORMA en el AST, no por texto (evita comentarios y cadenas)",
+        description: "Busca en código TypeScript/JavaScript por estructura sintáctica, no por texto: encuentra la declaración de una " +
+            "función/clase/tipo, una llamada, un import o una propiedad SIN que un comentario o una cadena que mencionen el " +
+            `mismo nombre cuenten como coincidencia. ${AYUDA_PATRON} Solo cubre .ts/.tsx/.js/.jsx (y variantes de módulo); ` +
+            "para otros lenguajes de programación lo dice explícitamente en vez de devolver cero resultados.",
+        parameters: astSearchSchema,
+        async execute(_toolCallId, { pat, path }) {
+            const raices = rutasDe(path, cwd);
+            const resultado = buscarEstructural(pat, raices, cwd);
+            if (resultado === null) {
+                throw new Error(`No se entiende el patrón "${pat}". ${AYUDA_PATRON}`);
+            }
+            const { coincidencias, noCubiertos } = resultado;
+            const cuerpo = coincidencias.length === 0
+                ? "No hay coincidencias estructurales."
+                : coincidencias.map((c) => `${c.ruta}:${c.linea}: ${c.fragmento}`).join("\n");
+            return texto(cuerpo + avisoNoCubiertos(noCubiertos));
+        },
+    };
+}
+const astEditSchema = Type.Object({
+    pat: Type.String({ description: AYUDA_PATRON }),
+    out: Type.String({
+        description: "Texto que sustituye a CADA nodo que coincida, completo (por ejemplo la declaración entera con el nuevo " +
+            "nombre). Las líneas 2+ se reindentan a la indentación del sitio.",
+    }),
+    path: Type.Optional(Type.String({ description: 'Fichero o directorio a editar; varios separados por ";" (default: ".")' })),
+});
+function crearAstEditTool(cwd) {
+    return {
+        name: "ast_edit",
+        label: "Edición estructural",
+        promptSnippet: "sustituir una declaración/llamada por su FORMA en el AST, sin tocar cadenas/comentarios que compartan el mismo texto",
+        description: "Reemplaza en código TypeScript/JavaScript el nodo que coincide con un patrón estructural (ver ast_search) " +
+            "por el texto de `out`, sin tocar cadenas ni comentarios que mencionen el mismo nombre porque no son ese nodo. " +
+            "Útil para renombrar una declaración con precisión donde un buscar-y-reemplazar de texto rompería otras cosas. " +
+            "Escribe los ficheros que cambian. Solo cubre .ts/.tsx/.js/.jsx; para otros lenguajes lo dice en vez de fingir que no había nada que cambiar.",
+        parameters: astEditSchema,
+        async execute(_toolCallId, { pat, out, path }) {
+            const raices = rutasDe(path, cwd);
+            const resultado = editarEstructural(pat, out, raices, cwd, { aplicar: true });
+            if (resultado === null) {
+                throw new Error(`No se entiende el patrón "${pat}". ${AYUDA_PATRON}`);
+            }
+            const { cambios, noCubiertos, rompieronParseo } = resultado;
+            if (cambios.length === 0) {
+                return texto(`No hay coincidencias estructurales; ningún fichero se ha tocado.${avisoNoCubiertos(noCubiertos)}`);
+            }
+            const cuerpo = cambios.map((c) => `${c.ruta}:${c.linea}:\n- ${c.antes}\n+ ${c.despues}`).join("\n\n");
+            const avisoRoto = rompieronParseo.length > 0
+                ? `\n\n⚠ Estos ficheros han quedado sintácticamente rotos tras la edición: ${rompieronParseo.join(", ")}. Arréglalos antes de seguir.`
+                : "";
+            return texto(`${cambios.length} cambio(s) aplicados.\n\n${cuerpo}${avisoRoto}${avisoNoCubiertos(noCubiertos)}`);
+        },
+    };
+}
+export function crearEstructuralTools(cwd) {
+    return {
+        ast_search: crearAstSearchTool(cwd),
+        ast_edit: crearAstEditTool(cwd),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/estructural/tools.js.map

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

package/dist/core/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IACnD,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAqBnD","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IACnD,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAqBnD"}

package/dist/core/event-bus.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,UAAU,cAAc,GAAuB;IACpD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAA,CAC5B;QACD,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YAAA,CACD,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAAA,CAC/C;QACD,KAAK,EAAE,GAAG,EAAE,CAAC;YACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAAA,CAC7B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,UAAU,cAAc;IAC7B,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YACvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC3C,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YACF,CAAC,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAChD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACX,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC9B,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB"}

package/dist/core/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"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"}

package/dist/core/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/core/experimental.ts"],"names":[],"mappings":"AAEA,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED,wBAAgB,2BAA2B;;;cAE1C","sourcesContent":["const PREFER_STRICT_TOOL_SAMPLING = { type: \"json_schema\", strict: \"prefer\" } as const;\n\nexport function areExperimentalFeaturesEnabled(): boolean {\n\treturn process.env.PI_EXPERIMENTAL === \"1\";\n}\n\nexport function getExperimentalToolSampling() {\n\treturn areExperimentalFeaturesEnabled() ? PREFER_STRICT_TOOL_SAMPLING : undefined;\n}\n"]}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/core/experimental.ts"],"names":[],"mappings":"AAIA,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED,wBAAgB,2BAA2B;;;cAU1C"}