@hoilab/ada-cli 0.84.22 → 0.85.1

package/dist/core/lectura/mapa.js

@@ -0,0 +1,177 @@
+/**
+ * El mapa de lo que un `read` truncado NO enseñó.
+ *
+ * EL CASO, medido sobre este repositorio. `core/agent-session.ts` tiene 4.546
+ * líneas y 162 KB. El límite de 50 KB salta antes que el de 2.000 líneas, así
+ * que el agente ve las primeras **1.415 líneas (31%)** y nada más. Un bug en la
+ * línea 3.000 es invisible.
+ *
+ * Lo que hay hoy para eso son `offset` y `limit`, y sirven — si sabes a qué
+ * línea ir. El agente no lo sabe: le hemos cortado el fichero sin decirle qué
+ * había detrás. Su única salida es paginar a ciegas, que gasta turnos, o
+ * rendirse y editar lo que sí vio, que es peor.
+ *
+ * Es la misma familia de siempre. Un corte silencioso se lee como «esto es el
+ * fichero», igual que un `[]` se lee como «no hay». La diferencia entre «no
+ * está» y «no te lo he enseñado» tiene que ser visible, y aquí no lo era: el
+ * aviso decía cuántas líneas faltaban, nunca QUÉ faltaba.
+ *
+ * QUÉ HACE. Sobre la parte que NO cupo, lista las declaraciones de primer nivel
+ * con su línea: funciones, clases, interfaces, tipos y constantes exportadas.
+ * El agente pasa de «me faltan 3.131 líneas» a «`_rebuildSystemPrompt` está en
+ * la 1537», que es un `read offset=1530` en vez de seis intentos.
+ *
+ * NO es un resumen del contenido y a propósito. Un resumen lo escribe un modelo
+ * y puede inventarse lo que no leyó; esto son nombres y números sacados del
+ * árbol de sintaxis. En un registro que se vende como auditable, un mapa que
+ * miente es peor que no tener mapa.
+ *
+ * LÍMITES, dichos antes de que los descubra nadie:
+ *   · Solo TypeScript y JavaScript. Para el resto se dice que no se pudo mapear,
+ *     que no es lo mismo que decir que no hay nada — tres estados, no dos.
+ *   · Se baja UN nivel dentro de clases, y esa decisión está medida. La primera
+ *     versión solo miraba el primer nivel y sobre `agent-session.ts` —el fichero
+ *     que motivó todo esto— devolvió CERO declaraciones: sus 4.546 líneas son
+ *     una sola clase con 106 métodos. Un mapa que se queda en «hay una clase
+ *     AgentSession en la línea 368» no le dice nada a quien busca dónde está
+ *     `_rebuildSystemPrompt`. Más adentro no se baja: una función dentro de un
+ *     método es detalle, no ancla.
+ */
+import ts from "typescript";
+const EXTENSIONES = new Set([".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"]);
+function tipoDe(nodo) {
+    if (ts.isFunctionDeclaration(nodo))
+        return "funcion";
+    if (ts.isClassDeclaration(nodo))
+        return "clase";
+    if (ts.isInterfaceDeclaration(nodo))
+        return "interfaz";
+    if (ts.isTypeAliasDeclaration(nodo))
+        return "tipo";
+    if (ts.isEnumDeclaration(nodo))
+        return "enum";
+    if (ts.isVariableStatement(nodo))
+        return "constante";
+    return null;
+}
+function esExportada(nodo) {
+    const mods = ts.canHaveModifiers(nodo) ? ts.getModifiers(nodo) : undefined;
+    return mods?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+}
+function nombreDe(nodo) {
+    if (ts.isVariableStatement(nodo)) {
+        const d = nodo.declarationList.declarations[0];
+        return d && ts.isIdentifier(d.name) ? d.name.text : null;
+    }
+    const conNombre = nodo;
+    return conNombre.name && ts.isIdentifier(conNombre.name)
+        ? conNombre.name.text
+        : null;
+}
+/**
+ * Mapea las declaraciones que caen DESPUÉS de `desdeLinea`.
+ *
+ * `desdeLinea` es 1-indexada y exclusiva: se pasa el número de la última línea
+ * que el agente sí vio, y se devuelve lo que hay a partir de la siguiente.
+ */
+export function mapearNoVisto(ruta, contenido, desdeLinea) {
+    const punto = ruta.lastIndexOf(".");
+    if (punto < 0 || !EXTENSIONES.has(ruta.slice(punto))) {
+        return { declaraciones: [], sinMapa: "extension-no-soportada" };
+    }
+    let fuente;
+    try {
+        fuente = ts.createSourceFile(ruta, contenido, ts.ScriptTarget.Latest, true);
+    }
+    catch {
+        return { declaraciones: [], sinMapa: "no-parsea" };
+    }
+    // «No parsea» hay que preguntárselo a `parseDiagnostics`, no deducirlo.
+    //
+    // `createSourceFile` no lanza y es MUY permisivo: sobre
+    // `esto ( no { es ] typescript` devuelve sentencias igualmente, así que mirar
+    // si el árbol está vacío daba «nada-que-mapear» sobre un fichero roto — otra
+    // vez «no puedo» leído como «no hay». Es el mismo mecanismo que ya se midió
+    // en `core/edicion/parseo.ts` (10 de 10 frente a 7 de 10 con otras vías).
+    //
+    // `parseDiagnostics` no está en el tipo público, y aun así es lo correcto:
+    // contiene SOLO errores de sintaxis, no los del comprobador de tipos, que
+    // aquí serían ruido.
+    const diagnosticos = fuente.parseDiagnostics;
+    if (Array.isArray(diagnosticos) && diagnosticos.length > 0) {
+        return { declaraciones: [], sinMapa: "no-parsea" };
+    }
+    const declaraciones = [];
+    for (const nodo of fuente.statements) {
+        const que = tipoDe(nodo);
+        if (!que)
+            continue;
+        const nombre = nombreDe(nodo);
+        if (!nombre)
+            continue;
+        const linea = fuente.getLineAndCharacterOfPosition(nodo.getStart(fuente)).line + 1;
+        if (linea > desdeLinea)
+            declaraciones.push({ que, nombre, linea, exportada: esExportada(nodo) });
+        // Un nivel más, dentro de clases. Sin esto el mapa era inútil justo donde
+        // hacía falta: un fichero de 4.500 líneas que es una sola clase.
+        if (!ts.isClassDeclaration(nodo))
+            continue;
+        for (const miembro of nodo.members) {
+            if (!ts.isMethodDeclaration(miembro) && !ts.isGetAccessorDeclaration(miembro))
+                continue;
+            if (!ts.isIdentifier(miembro.name) && !ts.isPrivateIdentifier(miembro.name))
+                continue;
+            const lineaM = fuente.getLineAndCharacterOfPosition(miembro.getStart(fuente)).line + 1;
+            if (lineaM <= desdeLinea)
+                continue;
+            declaraciones.push({
+                que: ts.isGetAccessorDeclaration(miembro) ? "getter" : "metodo",
+                // Con la clase delante: `AgentSession.prompt` se busca mejor que `prompt`.
+                nombre: `${nombre}.${miembro.name.text}`,
+                linea: lineaM,
+                exportada: false,
+            });
+        }
+    }
+    if (declaraciones.length === 0)
+        return { declaraciones: [], sinMapa: "nada-que-mapear" };
+    return { declaraciones, sinMapa: null };
+}
+/** Cuántas declaraciones se enseñan como mucho, para no cambiar un muro por otro. */
+const TOPE = 40;
+/**
+ * El mapa, escrito para que el modelo pueda usarlo directamente.
+ *
+ * Devuelve `null` cuando no hay nada que decir, para que quien llame no tenga
+ * que decidir si una cadena vacía significa «sin mapa» o «error».
+ */
+export function textoDelMapa(mapa, ruta) {
+    if (mapa.sinMapa === "nada-que-mapear")
+        return null;
+    if (mapa.sinMapa === "extension-no-soportada")
+        return null;
+    if (mapa.sinMapa === "no-parsea") {
+        // Se dice, en vez de callar: «no se pudo mapear» y «no hay nada» son
+        // distintos, y confundirlos le haría creer al agente que el resto del
+        // fichero está vacío.
+        return "No se ha podido mapear el resto del fichero (no parsea). Usa offset/limit para recorrerlo.";
+    }
+    const orden = ["clase", "interfaz", "funcion", "metodo", "getter", "tipo", "enum", "constante"];
+    const lista = [...mapa.declaraciones].sort((a, b) => a.linea - b.linea);
+    const mostradas = lista.slice(0, TOPE);
+    const lineas = mostradas.map((d) => `  ${String(d.linea).padStart(5)}  ${d.que.padEnd(10)} ${d.exportada ? "export " : ""}${d.nombre}`);
+    let texto = `Lo que NO se ha mostrado de ${ruta} contiene estas declaraciones. ` +
+        `Usa \`read\` con \`offset\` para ir directo a la que necesites:\n${lineas.join("\n")}`;
+    if (lista.length > mostradas.length) {
+        // Se dice cuántas quedan: un mapa truncado en silencio repetiría el mismo
+        // fallo que este módulo existe para arreglar.
+        const porTipo = orden
+            .map((t) => [t, lista.slice(TOPE).filter((d) => d.que === t).length])
+            .filter(([, n]) => n > 0)
+            .map(([t, n]) => `${n} ${t}${n > 1 ? "s" : ""}`)
+            .join(", ");
+        texto += `\n  …y ${lista.length - mostradas.length} más (${porTipo}).`;
+    }
+    return texto;
+}
+//# sourceMappingURL=mapa.js.map

package/dist/core/lectura/mapa.js.map

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

package/dist/core/lectura/pdf.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Lectura de PDF sin dependencias: los flujos de contenido de un PDF van
+ * comprimidos con Flate (zlib), y `node:zlib` viene de serie. omp lo resuelve
+ * renderizando el documento en un navegador headless y haciéndole capturas:
+ * infraestructura pesada que aquí no existe. Lo que se extrae es la CAPA DE
+ * TEXTO, no una imagen del documento.
+ *
+ * LOS TRES ESTADOS, nunca dos — confundir dos de ellos es un fallo que se lee
+ * como éxito:
+ *
+ *   - `texto`:    hay capa de texto y se extrajo. El caso normal.
+ *   - `sin-capa`: el PDF está BIEN FORMADO pero no trae texto (escaneado o
+ *                 solo imágenes). NO es «fichero vacío»: decir eso sería
+ *                 mentir sobre la causa, y el modelo se lo creería.
+ *   - `no-pudo`:  cifrado, malformado o sin firma. No se sabe qué había.
+ *
+ * LÍMITES, dichos antes de descubrirlos nadie:
+ *   · No sigue el cross-reference table: recorre los objetos `N 0 obj …
+ *     stream…endstream` directamente. Para leer texto basta y evita toda la
+ *     maquinaria de xref (incluidos los xref streams comprimidos).
+ *   · Los operadores de posicionamiento fino (Tm, matrices) se aproximan:
+ *     salto de línea en Td/TD con componente vertical distinta de cero, T*,
+ *     BT; espacio cuando el kerning de TJ es muy negativo. El ORDEN del
+ *     texto se conserva; la GEOMETRÍA no. Para layout exacto, omp tiene el
+ *     navegador y nosotros no fingimos tenerlo.
+ *   · No descifra: un PDF con /Encrypt se reporta como `no-pudo`, nunca se
+ *     intenta a ciegas.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+export type ResultadoPdf = {
+    estado: "texto";
+    texto: string;
+} | {
+    estado: "sin-capa";
+    detalle: string;
+} | {
+    estado: "no-pudo";
+    motivo: string;
+};
+export declare function extraerTextoPdf(buffer: Buffer): ResultadoPdf;
+/**
+ * Envuelve la definición de `read` ya construida — mismo patrón que
+ * `envolverReadConUrlsInternas`, y por la misma razón: `read.ts` es de
+ * upstream y el presupuesto de sync está al tope. Si la ruta apunta a un PDF
+ * real (firma `%PDF-`, nunca la extensión: los ficheros mienten), lo resuelve
+ * aquí; si no, delega SIN haber leído más que la cabecera.
+ */
+export declare function envolverReadConPdf<TBase extends ToolDefinition<any, any, any>>(base: TBase, cwd: string): TBase;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/core/lectura/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/core/lectura/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9E,MAAM,MAAM,YAAY,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAmMzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CA+B5D;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAmD/G"}

package/dist/core/lectura/pdf.js

@@ -0,0 +1,337 @@
+/**
+ * Lectura de PDF sin dependencias: los flujos de contenido de un PDF van
+ * comprimidos con Flate (zlib), y `node:zlib` viene de serie. omp lo resuelve
+ * renderizando el documento en un navegador headless y haciéndole capturas:
+ * infraestructura pesada que aquí no existe. Lo que se extrae es la CAPA DE
+ * TEXTO, no una imagen del documento.
+ *
+ * LOS TRES ESTADOS, nunca dos — confundir dos de ellos es un fallo que se lee
+ * como éxito:
+ *
+ *   - `texto`:    hay capa de texto y se extrajo. El caso normal.
+ *   - `sin-capa`: el PDF está BIEN FORMADO pero no trae texto (escaneado o
+ *                 solo imágenes). NO es «fichero vacío»: decir eso sería
+ *                 mentir sobre la causa, y el modelo se lo creería.
+ *   - `no-pudo`:  cifrado, malformado o sin firma. No se sabe qué había.
+ *
+ * LÍMITES, dichos antes de descubrirlos nadie:
+ *   · No sigue el cross-reference table: recorre los objetos `N 0 obj …
+ *     stream…endstream` directamente. Para leer texto basta y evita toda la
+ *     maquinaria de xref (incluidos los xref streams comprimidos).
+ *   · Los operadores de posicionamiento fino (Tm, matrices) se aproximan:
+ *     salto de línea en Td/TD con componente vertical distinta de cero, T*,
+ *     BT; espacio cuando el kerning de TJ es muy negativo. El ORDEN del
+ *     texto se conserva; la GEOMETRÍA no. Para layout exacto, omp tiene el
+ *     navegador y nosotros no fingimos tenerlo.
+ *   · No descifra: un PDF con /Encrypt se reporta como `no-pudo`, nunca se
+ *     intenta a ciegas.
+ */
+import { open, readFile } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import { inflateSync } from "node:zlib";
+import { truncateHead } from "../tools/truncate.js";
+/** Techo de seguridad: un PDF malicioso no decide cuánta CPU gasta el lector. */
+const MAX_FLUJOS = 800;
+const MAX_DECODIFICADO = 8 * 1024 * 1024;
+function flujosDe(crudo) {
+    const flujos = [];
+    let idx = 0;
+    while (flujos.length < MAX_FLUJOS) {
+        const kw = crudo.indexOf("stream", idx);
+        if (kw === -1)
+            break;
+        const cierreDict = crudo.lastIndexOf(">>", kw);
+        const aperturaDict = cierreDict === -1 ? -1 : crudo.lastIndexOf("<<", cierreDict);
+        if (aperturaDict === -1 || cierreDict < aperturaDict) {
+            idx = kw + 6;
+            continue;
+        }
+        let p = kw + 6;
+        if (crudo[p] === "\r")
+            p++;
+        if (crudo[p] === "\n")
+            p++;
+        const fin = crudo.indexOf("endstream", p);
+        if (fin === -1) {
+            idx = kw + 6;
+            continue;
+        }
+        flujos.push({ diccionario: crudo.slice(aperturaDict, cierreDict + 2), contenido: crudo.slice(p, fin) });
+        idx = fin + 9;
+    }
+    return flujos;
+}
+function decodificar(flujos) {
+    const decodificados = [];
+    let fallosInflado = 0;
+    let presupuesto = MAX_DECODIFICADO;
+    for (const flujo of flujos) {
+        if (presupuesto <= 0)
+            break;
+        // Una imagen también va en Flate e infla megas sin aportar texto: se
+        // excluye ANTES de descomprimirla, no después.
+        if (/\/Subtype\s*\/Image/.test(flujo.diccionario))
+            continue;
+        try {
+            const bruto = Buffer.from(flujo.contenido, "latin1");
+            const datos = flujo.diccionario.includes("/FlateDecode") ? inflateSync(bruto) : bruto;
+            if (datos.length > presupuesto)
+                continue;
+            presupuesto -= datos.length;
+            const texto = datos.toString("latin1");
+            // Solo quedan los flujos que SON de contenido: operadores de texto.
+            if (/\bBT\b/.test(texto) && /\b(Tj|TJ)\b/.test(texto))
+                decodificados.push(texto);
+        }
+        catch {
+            fallosInflado++;
+        }
+    }
+    return { decodificados, fallosInflado };
+}
+/**
+ * Escáner de operadores de texto. Mantiene una línea en curso y corta en las
+ * fronteras que de verdad separan líneas; dentro de una línea, los fragmentos
+ * de un TJ se pegan sin inventar separadores.
+ */
+function extraerTextoDeContenido(decodificado) {
+    const lineas = [];
+    let lineaActual = "";
+    let ultimoNumero = Number.NaN;
+    const cortaLinea = () => {
+        lineas.push(lineaActual);
+        lineaActual = "";
+    };
+    const emite = (s) => {
+        lineaActual += s;
+    };
+    let i = 0;
+    const n = decodificado.length;
+    while (i < n) {
+        const c = decodificado[i];
+        if (c === "(") {
+            i++;
+            let literal = "";
+            let profundidad = 1;
+            while (i < n && profundidad > 0) {
+                const ch = decodificado[i];
+                if (ch === "\\") {
+                    const sig = decodificado[i + 1];
+                    if (sig === "n")
+                        literal += "\n";
+                    else if (sig === "r")
+                        literal += "\r";
+                    else if (sig === "t")
+                        literal += "\t";
+                    else if (sig === "b" || sig === "f")
+                        literal += " ";
+                    else if (sig >= "0" && sig <= "7") {
+                        // Octal \ddd, hasta tres dígitos.
+                        let octal = "";
+                        let j = i + 1;
+                        while (j < n && octal.length < 3 && decodificado[j] >= "0" && decodificado[j] <= "7") {
+                            octal += decodificado[j];
+                            j++;
+                        }
+                        literal += String.fromCharCode(Number.parseInt(octal, 8));
+                        i = j;
+                        continue;
+                    }
+                    else if (sig === "\r") {
+                        // Continuación de línea: la barra se come junto al salto.
+                        i += decodificado[i + 2] === "\n" ? 3 : 2;
+                        continue;
+                    }
+                    else if (sig === "\n") {
+                        i += 2;
+                        continue;
+                    }
+                    else
+                        literal += sig ?? "";
+                    i += 2;
+                    continue;
+                }
+                if (ch === "(")
+                    profundidad++;
+                else if (ch === ")") {
+                    profundidad--;
+                    if (profundidad === 0) {
+                        i++;
+                        break;
+                    }
+                }
+                literal += ch;
+                i++;
+            }
+            emite(literal);
+            continue;
+        }
+        if (c === "<" && decodificado[i + 1] !== "<") {
+            const fin = decodificado.indexOf(">", i);
+            if (fin === -1)
+                break;
+            const hex = decodificado.slice(i + 1, fin).replace(/[^0-9A-Fa-f]/g, "");
+            let literal = "";
+            for (let j = 0; j + 1 < hex.length; j += 2) {
+                literal += String.fromCharCode(Number.parseInt(hex.slice(j, j + 2), 16));
+            }
+            emite(literal);
+            i = fin + 1;
+            continue;
+        }
+        if (c === "<") {
+            // Diccionario inline «<<»: no aporta operandos de texto.
+            i += 2;
+            continue;
+        }
+        if (c === "[" || c === "]") {
+            i++;
+            continue;
+        }
+        if (c === "/") {
+            // Nombre: se consume entero para que sus letras no acaben en el texto.
+            let j = i + 1;
+            while (j < n && !/[\s/[<>()]/.test(decodificado[j]))
+                j++;
+            i = j;
+            continue;
+        }
+        if (c === "-" || c === "." || (c >= "0" && c <= "9")) {
+            let j = i + 1;
+            while (j < n && /[0-9.]/.test(decodificado[j]))
+                j++;
+            ultimoNumero = Number.parseFloat(decodificado.slice(i, j));
+            // Kerning muy negativo en TJ: así escriben varias herramientas el
+            // espacio que no metieron como literal.
+            if (ultimoNumero <= -150)
+                emite(" ");
+            i = j;
+            continue;
+        }
+        if (!/\s/.test(c)) {
+            let j = i;
+            while (j < n && !/\s/.test(decodificado[j]) && !"()[<>/".includes(decodificado[j]))
+                j++;
+            const op = decodificado.slice(i, j);
+            if (op === "'" || op === '"' || op === "T*" || op === "BT") {
+                cortaLinea();
+            }
+            else if (op === "Td" || op === "TD") {
+                // Solo si mueve en vertical: un desplazamiento horizontal seguido
+                // NO parte la línea.
+                if (!Number.isNaN(ultimoNumero) && Math.abs(ultimoNumero) > 0.01)
+                    cortaLinea();
+            }
+            // Tj/TJ no necesitan nada aquí: el literal ya se emitió al
+            // parsearlo; el operador solo lo confirma.
+            ultimoNumero = Number.NaN;
+            i = j;
+            continue;
+        }
+        i++;
+    }
+    if (lineaActual.trim() !== "")
+        lineas.push(lineaActual);
+    return lineas
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export function extraerTextoPdf(buffer) {
+    // La firma `%PDF-` puede ir precedida de basura; cabecera amplia.
+    if (!buffer.subarray(0, 1024).toString("latin1").includes("%PDF-")) {
+        return { estado: "no-pudo", motivo: "no lleva la firma %PDF-" };
+    }
+    const crudo = buffer.toString("latin1");
+    if (/\/Encrypt\s+\d+\s+\d+\s+R/.test(crudo)) {
+        return { estado: "no-pudo", motivo: "está cifrado y no se descifra a ciegas" };
+    }
+    const flujos = flujosDe(crudo);
+    if (flujos.length === 0) {
+        return crudo.includes("/Page")
+            ? { estado: "sin-capa", detalle: "el PDF declara páginas pero ningún flujo de contenido legible" }
+            : { estado: "no-pudo", motivo: "estructura no reconocida: ni flujos ni páginas" };
+    }
+    const { decodificados, fallosInflado } = decodificar(flujos);
+    if (decodificados.length === 0) {
+        if (fallosInflado > 0)
+            return { estado: "no-pudo", motivo: `${fallosInflado} flujo(s) no se pudieron descomprimir` };
+        return {
+            estado: "sin-capa",
+            detalle: "los flujos existen pero ninguno contiene operadores de texto (PDF escaneado o de solo imágenes)",
+        };
+    }
+    const partes = decodificados.map(extraerTextoDeContenido).filter((p) => p !== "");
+    const texto = partes
+        .join("\n\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    if (texto === "")
+        return { estado: "sin-capa", detalle: "los flujos de contenido no produjeron texto" };
+    return { estado: "texto", texto };
+}
+const CABECERA_TEXTO = "[PDF: capa de texto extraída]";
+const CABECERA_SIN_CAPA = "[PDF sin capa de texto: es un PDF escaneado o de solo imágenes. No está vacío; su contenido son imágenes y aquí no hay OCR.]";
+/**
+ * Envuelve la definición de `read` ya construida — mismo patrón que
+ * `envolverReadConUrlsInternas`, y por la misma razón: `read.ts` es de
+ * upstream y el presupuesto de sync está al tope. Si la ruta apunta a un PDF
+ * real (firma `%PDF-`, nunca la extensión: los ficheros mienten), lo resuelve
+ * aquí; si no, delega SIN haber leído más que la cabecera.
+ */
+export function envolverReadConPdf(base, cwd) {
+    return {
+        ...base,
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            if (typeof params !== "object" || params === null || !("path" in params)) {
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            }
+            const rutaCruda = params.path;
+            if (typeof rutaCruda !== "string" || rutaCruda === "" || rutaCruda.includes("://")) {
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            }
+            const absoluta = isAbsolute(rutaCruda) ? rutaCruda : join(cwd, rutaCruda);
+            try {
+                // Solo la CABEZA antes de decidir: un binario de 500 MB no se lee
+                // entero para descubrir que no es un PDF.
+                const manejador = await open(absoluta, "r");
+                let cabeza;
+                try {
+                    cabeza = Buffer.alloc(1024);
+                    const { bytesRead } = await manejador.read(cabeza, 0, cabeza.length, 0);
+                    if (!cabeza.subarray(0, bytesRead).toString("latin1").includes("%PDF-")) {
+                        return base.execute(toolCallId, params, signal, onUpdate, ctx);
+                    }
+                }
+                finally {
+                    await manejador.close();
+                }
+                const buffer = await readFile(absoluta);
+                const resultado = extraerTextoPdf(buffer);
+                if (resultado.estado === "no-pudo") {
+                    throw new Error(`El PDF no se pudo leer: ${resultado.motivo}.`);
+                }
+                if (resultado.estado === "sin-capa") {
+                    return {
+                        content: [{ type: "text", text: `${CABECERA_SIN_CAPA}\nDetalle: ${resultado.detalle}` }],
+                        details: { pdf: resultado.estado },
+                    };
+                }
+                const truncado = truncateHead(resultado.texto);
+                let texto = `${CABECERA_TEXTO}\n${truncado.content}`;
+                if (truncado.truncated) {
+                    texto += `\n[Truncado: ${truncado.outputLines} de ${truncado.totalLines} líneas del texto extraído.]`;
+                }
+                return { content: [{ type: "text", text: texto }], details: { pdf: "texto" } };
+            }
+            catch (error) {
+                if (error instanceof Error && error.message.startsWith("El PDF no se pudo leer"))
+                    throw error;
+                // Que la falta de permisos o el directorio la cuente `read`
+                // con SU mensaje, no el nuestro.
+                return base.execute(toolCallId, params, signal, onUpdate, ctx);
+            }
+        },
+    };
+}
+//# sourceMappingURL=pdf.js.map

package/dist/core/lectura/pdf.js.map

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

package/dist/core/lectura/sniffer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Sniffer binario: clasifica un fichero como binario/texto por CONTENIDO antes
+ * de decodificarlo como UTF-8 y mostrárselo al modelo.
+ *
+ * EL BUG QUE MOTIVA ESTO: `read.ts:275` hace `buffer.toString("utf-8")` sobre
+ * cualquier fichero que no sea imagen. Un .wasm, un .png sin extensión, un
+ * .so, un .db — el decode es lossy: NUL bytes y secuencias inválidas se
+ * convierten en U+FFFD y caracteres de control, quemando el contexto con
+ * mojibake que el modelo no puede usar. omp lo resuelve con el mismo
+ * heurístico de git: sniffea los primeros 8 KB.
+ *
+ * REGLA (espejo de git):
+ *   · NUL byte en la cabecera → binario (true binary + UTF-16/32 cuyo rango
+ *     ASCII lleva padding NUL).
+ *   · Decode UTF-8 estricto (fatal) falla → binario (secuencia inválida real;
+ *     streaming mode tolera multibyte truncado en el borde de la cabecera).
+ *   · Todo lo demás → texto.
+ *
+ * FICHERO VACÍO → texto (no binario): un fichero de 0 bytes no produce
+ * mojibake y el modelo necesita saber que existe y está vacío.
+ */
+import type { ToolDefinition } from "../extensions/types.ts";
+/** Cabecera sniffeada: espejo de los 8.000 bytes de git. */
+export declare const BINARY_SNIFF_BYTES = 8192;
+/**
+ * Clasifica una cabecera en memoria como binaria (no texto UTF-8).
+ *
+ * Binario cuando la cabecera contiene un byte NUL (true binary, más texto
+ * UTF-16/32 cuyo rango ASCII lleva padding NUL) o cuando no es UTF-8 válido.
+ * El decode corre en modo streaming para que una secuencia multibyte
+ * truncada en el borde de la cabecera se tolere, mientras que cualquier byte
+ * genuinamente inválido falla — igual que el decode `fatal` estricto que las
+ * rutas de lectura `local://`/`ssh://` ya usan.
+ */
+export declare function esCabeceraBinaria(cabecera: Uint8Array): boolean;
+/**
+ * Sniffea los primeros {@link BINARY_SNIFF_BYTES} de `ruta` y devuelve si es
+ * binario. Abre el fichero, lee la cabecera y cierra — nunca lee el fichero
+ * entero solo para clasificarlo.
+ */
+export declare function esProbablementeBinario(ruta: string, maxBytes?: number): Promise<boolean>;
+/**
+ * Envuelve la definición de `read` ya construida para que un fichero binario
+ * devuelva un aviso limpio en vez de mojibake que quema el contexto. Mismo
+ * patrón que `envolverReadConPdf` y `envolverReadConUrlsInternas`: read.ts es
+ * de upstream y el presupuesto de sync está al tope.
+ *
+ * Orden de composición: el sniffer va MÁS ADENTRO que el PDF wrapper (un PDF
+ * es binario por el sniffer, pero el PDF wrapper lo maneja con su propio
+ * mensaje más útil; el sniffer solo actúa sobre binarios que NADIE más
+ * maneja).
+ */
+export declare function envolverReadConSniffer(base: ToolDefinition<any, any, any>, cwd: string): ToolDefinition<any, any, any>;
+//# sourceMappingURL=sniffer.d.ts.map

package/dist/core/lectura/sniffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sniffer.d.ts","sourceRoot":"","sources":["../../../src/core/lectura/sniffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE9E,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAQ/D;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAS1G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACnC,GAAG,EAAE,MAAM,GACT,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CA+B/B"}