@ssolis-ti/mcp-compra-agil 1.0.2

package/dist/tools/buscar-compras.js

@@ -0,0 +1,121 @@
+/**
+ * Tool: buscar_compras_agiles
+ *
+ * Busca y filtra procesos de Compra Ágil en Mercado Público
+ * usando palabras clave, fechas, estados y regiones.
+ */
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+const TOOL_NAME = 'buscar_compras_agiles';
+const TOOL_DESCRIPTION = `Busca procesos de Compra Ágil en Mercado Público de Chile.
+Permite filtrar por palabras clave, estado del proceso, región geográfica y rango de fechas de publicación.
+Retorna un listado resumido con código, nombre, estado, presupuesto e institución compradora.
+Nota: los parámetros 'q' (búsqueda por texto) e 'id' (código exacto) son mutuamente excluyentes.
+Estados válidos: publicada, cerrada, desierta, cancelada, proveedor_seleccionado.
+Regiones: códigos del 1 al 16 (ej: 13 = Metropolitana, 5 = Valparaíso).`;
+const inputSchema = {
+    q: z.string().optional().describe('Palabras clave para buscar en el nombre/descripción del proceso. Ej: "materiales electricos". No usar junto con "id".'),
+    id: z.string().optional().describe('Código exacto de una Compra Ágil. Ej: "1057539-228-COT26". No usar junto con "q".'),
+    estado: z.string().optional().describe('Estado(s) del proceso, separados por coma. Valores: publicada, cerrada, desierta, cancelada, proveedor_seleccionado. Ej: "publicada,proveedor_seleccionado".'),
+    region: z.string().optional().describe('Código(s) de región del organismo comprador, separados por coma (1-16). Ej: "13" para Metropolitana, "13,5" para Metropolitana y Valparaíso.'),
+    publicado_desde: z.string().optional().describe('Fecha mínima de publicación en formato ISO-8601. Ej: "2026-01-01T00:00:00Z".'),
+    publicado_hasta: z.string().optional().describe('Fecha máxima de publicación en formato ISO-8601. Ej: "2026-01-31T23:59:59Z".'),
+    palabras_clave_requeridas: z.string().optional().describe('Lista de palabras clave separadas por comas que DEBEN estar presentes en el nombre de la compra (filtro local. Ej: "software,desarrollo").'),
+    palabras_clave_excluidas: z.string().optional().describe('Lista de palabras clave separadas por comas que NO DEBEN estar en el nombre de la compra (filtro local. Ej: "soporte,licencias").'),
+    ordenar_por: z.enum(['FechaUltimaModificacion', 'FechaPublicacion']).optional().describe('Criterio de ordenamiento. "FechaPublicacion" para las más recientes primero, "FechaUltimaModificacion" (default) para las últimas modificadas.'),
+    tamano_pagina: z.number().min(10).max(50).optional().describe('Resultados por página (10-50, default 15).'),
+    numero_pagina: z.number().min(1).optional().describe('Número de página a consultar (comienza en 1).'),
+};
+export function registerBuscarCompras(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            // Validar exclusión mutua de q e id
+            if (args.q && args.id) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'Error de validación: Los parámetros "q" (búsqueda por texto) e "id" (código exacto) no pueden usarse juntos. Usa solo uno de los dos.',
+                        }],
+                    isError: true,
+                };
+            }
+            const response = await client.buscar({
+                q: args.q,
+                id: args.id,
+                estado: args.estado,
+                region: args.region,
+                publicado_desde: args.publicado_desde,
+                publicado_hasta: args.publicado_hasta,
+                ordenar_por: args.ordenar_por,
+                tamano_pagina: args.tamano_pagina,
+                numero_pagina: args.numero_pagina,
+            });
+            // Formatear resultado compacto para el LLM
+            let filteredItems = response.items;
+            // Filtrado local por palabras_clave_requeridas (AND lógico entre los términos)
+            if (args.palabras_clave_requeridas) {
+                const reqKeywords = args.palabras_clave_requeridas
+                    .split(',')
+                    .map(kw => kw.trim().toLowerCase())
+                    .filter(Boolean);
+                if (reqKeywords.length > 0) {
+                    filteredItems = filteredItems.filter(item => {
+                        const nameLower = item.nombre.toLowerCase();
+                        return reqKeywords.every(kw => nameLower.includes(kw));
+                    });
+                }
+            }
+            // Filtrado local por palabras_clave_excluidas (OR lógico entre los términos)
+            if (args.palabras_clave_excluidas) {
+                const excKeywords = args.palabras_clave_excluidas
+                    .split(',')
+                    .map(kw => kw.trim().toLowerCase())
+                    .filter(Boolean);
+                if (excKeywords.length > 0) {
+                    filteredItems = filteredItems.filter(item => {
+                        const nameLower = item.nombre.toLowerCase();
+                        return !excKeywords.some(kw => nameLower.includes(kw));
+                    });
+                }
+            }
+            const summary = filteredItems.map((item) => ({
+                codigo: item.codigo,
+                nombre: item.nombre,
+                estado: item.estado.glosa,
+                convocatoria: item.convocatoria.descripcion,
+                presupuesto_clp: item.montos.monto_disponible_clp,
+                moneda: item.montos.moneda,
+                institucion: item.institucion.organismo_comprador,
+                region: item.institucion.nombre_region,
+                fecha_publicacion: item.fechas.fecha_publicacion,
+                fecha_cierre: item.fechas.fecha_cierre,
+                ofertas_recibidas: item.resumen.total_ofertas_recibidas,
+            }));
+            const result = {
+                total_resultados: response.paginacion.total_resultados,
+                total_filtrados_en_pagina: filteredItems.length,
+                pagina: `${response.paginacion.numero_pagina} de ${response.paginacion.total_paginas}`,
+                resultados: summary,
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado: ${String(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=buscar-compras.js.map

package/dist/tools/buscar-compras.js.map

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

package/dist/tools/detalle-compra.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool: obtener_detalle_compra
+ *
+ * Obtiene el detalle completo de una Compra Ágil específica,
+ * incluyendo productos, proveedores, cotizaciones y estado de OC.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CompraAgilClient } from '../api/compra-agil-client.js';
+export declare function registerDetalleCompra(server: McpServer, client: CompraAgilClient): void;
+//# sourceMappingURL=detalle-compra.d.ts.map

package/dist/tools/detalle-compra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detalle-compra.d.ts","sourceRoot":"","sources":["../../src/tools/detalle-compra.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAiBhE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAyGvF"}

package/dist/tools/detalle-compra.js

@@ -0,0 +1,119 @@
+/**
+ * Tool: obtener_detalle_compra
+ *
+ * Obtiene el detalle completo de una Compra Ágil específica,
+ * incluyendo productos, proveedores, cotizaciones y estado de OC.
+ */
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+const TOOL_NAME = 'obtener_detalle_compra';
+const TOOL_DESCRIPTION = `Obtiene el detalle completo de una Compra Ágil específica por su código único.
+Incluye: descripción del proceso, productos solicitados con cantidades, proveedores que cotizaron con sus montos,
+presupuesto disponible, dirección y plazo de entrega, estado de la Orden de Compra (si fue emitida),
+y flags de sostenibilidad (requisitos medioambientales y de impacto social).
+NOTA: Las cotizaciones detalladas de los proveedores solo se muestran desde el estado "Cerrada" en segundo llamado en adelante.`;
+const inputSchema = {
+    codigo: z.string().describe('Código único de la Compra Ágil. Formato: XXXXXX-YYY-COTXX. Ej: "1057539-228-COT26".'),
+};
+export function registerDetalleCompra(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            const detalle = await client.detalle(args.codigo);
+            // Formatear para LLM — estructura limpia y legible
+            const result = {
+                codigo: detalle.codigo,
+                nombre: detalle.nombre,
+                descripcion: detalle.descripcion,
+                estado: detalle.estado.glosa,
+                convocatoria: detalle.convocatoria.descripcion,
+                institucion: {
+                    organismo: detalle.institucion.organismo_comprador,
+                    rut: detalle.institucion.rut,
+                    unidad: detalle.institucion.unidad_compra,
+                    region: detalle.institucion.nombre_region,
+                },
+                fechas: {
+                    publicacion: detalle.fechas.fecha_publicacion,
+                    cierre: detalle.fechas.fecha_cierre,
+                    cierre_primer_llamado: detalle.convocatoria.fecha_cierre_primer_llamado,
+                    cierre_segundo_llamado: detalle.convocatoria.fecha_cierre_segundo_llamado,
+                    cancelacion: detalle.fechas.fecha_cancelacion,
+                },
+                presupuesto: {
+                    tipo: detalle.presupuesto.tipo_presupuesto,
+                    monto_disponible_clp: detalle.presupuesto.monto_disponible_clp,
+                    moneda: detalle.presupuesto.moneda,
+                    presupuesto_estimado: detalle.presupuesto.presupuesto_estimado,
+                },
+                entrega: {
+                    direccion: detalle.entrega.direccion_entrega,
+                    plazo_dias: detalle.entrega.plazo_entrega_dias,
+                },
+                productos_solicitados: detalle.productos_solicitados.map((p) => ({
+                    codigo: p.codigo_producto,
+                    nombre: p.nombre,
+                    descripcion: p.descripcion,
+                    cantidad: p.cantidad,
+                    unidad: p.unidad_medida,
+                })),
+                proveedores_cotizando: detalle.proveedores_cotizando.map((prov) => ({
+                    rut: prov.rut_proveedor,
+                    razon_social: prov.razon_social,
+                    es_empresa_menor_tamano: prov.es_emt,
+                    monto_total: prov.monto_total,
+                    valor_neto: prov.valor_neto,
+                    impuesto: prov.total_impuesto,
+                    despacho: prov.monto_despacho,
+                    descripcion: prov.descripcion_cotizacion || prov.descripcion,
+                    estado_por_comprador: prov.estado_por_comprador,
+                    productos_cotizados: prov.productos_cotizados?.map((pc) => ({
+                        nombre: pc.nombre_producto,
+                        cantidad: pc.cantidad,
+                        precio_unitario: pc.precio_unitario,
+                        total: pc.monto_total_producto,
+                    })),
+                })),
+                orden_compra: {
+                    tiene_oc: (detalle.id_orden_compra ?? detalle.orden_compra?.id_orden_compra ?? null) !== null,
+                    id_orden_compra: detalle.id_orden_compra ?? detalle.orden_compra?.id_orden_compra ?? null,
+                    id_oc: detalle.orden_compra?.id_oc ?? null,
+                    codigo_oc: detalle.orden_compra?.codigo_orden_compra ?? null,
+                    estado_oc: detalle.orden_compra?.estado_orden_compra ?? null,
+                },
+                resumen: {
+                    total_ofertas: detalle.resumen.total_ofertas_recibidas,
+                    total_demandas: detalle.resumen.total_demandas,
+                    multa_sancion: detalle.resumen.multa_sancion,
+                },
+                motivos: detalle.motivos,
+                sostenibilidad: {
+                    medioambientales: detalle.flags.considera_requisitos_medioambientales,
+                    impacto_social_economico: detalle.flags.considera_requisitos_impacto_social_economico,
+                },
+                documentos_adjuntos: detalle.documentos.map((d) => ({
+                    id: d.id,
+                    nombre: d.nombre,
+                })),
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado: ${String(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=detalle-compra.js.map

package/dist/tools/detalle-compra.js.map

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

package/dist/tools/detalle-oc.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool: obtener_detalle_orden_compra
+ *
+ * Obtiene el detalle completo de una Orden de Compra (OC) en Mercado Público.
+ * Admite tanto el ID numérico interno como el código alfanumérico (ej. "1057532-156-AG26").
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { CompraAgilClient } from '../api/compra-agil-client.js';
+export declare function registerDetalleOC(server: McpServer, client: CompraAgilClient): void;
+//# sourceMappingURL=detalle-oc.d.ts.map

package/dist/tools/detalle-oc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detalle-oc.d.ts","sourceRoot":"","sources":["../../src/tools/detalle-oc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAuEnF"}

package/dist/tools/detalle-oc.js

@@ -0,0 +1,81 @@
+/**
+ * Tool: obtener_detalle_orden_compra
+ *
+ * Obtiene el detalle completo de una Orden de Compra (OC) en Mercado Público.
+ * Admite tanto el ID numérico interno como el código alfanumérico (ej. "1057532-156-AG26").
+ */
+import { z } from 'zod';
+import { CompraAgilApiError } from '../utils/error-handler.js';
+const TOOL_NAME = 'obtener_detalle_orden_compra';
+const TOOL_DESCRIPTION = `Obtiene el detalle completo de una Orden de Compra (OC) emitida en Mercado Público de Chile.
+Admite tanto el ID numérico (id_orden_compra) como el código alfanumérico externo.
+Retorna información sobre montos (neto, impuestos, total), comprador, proveedor adjudicado y el listado de productos/servicios adquiridos.`;
+const inputSchema = {
+    codigo_oc: z.string().describe('Código alfanumérico (ej: "1057532-156-AG26") o ID numérico (ej: "54909627") de la Orden de Compra.'),
+};
+export function registerDetalleOC(server, client) {
+    server.registerTool(TOOL_NAME, {
+        description: TOOL_DESCRIPTION,
+        inputSchema: inputSchema,
+    }, async (args) => {
+        try {
+            const response = await client.obtenerDetalleOC(args.codigo_oc);
+            if (!response.Listado || response.Listado.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No se encontró ninguna Orden de Compra asociada al identificador "${args.codigo_oc}".`,
+                        }],
+                };
+            }
+            const oc = response.Listado[0];
+            // Estructura simplificada e informativa para el LLM
+            const result = {
+                codigo: oc.Codigo,
+                nombre: oc.Nombre,
+                estado: oc.Estado,
+                codigo_estado: oc.CodigoEstado,
+                licitacion_asociada: oc.CodigoLicitacion,
+                descripcion: oc.Descripcion,
+                fecha_creacion: oc.FechaCreacion,
+                fecha_aceptacion: oc.FechaAceptacion,
+                montos: {
+                    neto: oc.MontoNeto,
+                    impuestos: oc.Impuestos,
+                    total: oc.Total,
+                },
+                comprador: {
+                    organismo: oc.Comprador.NombreOrganismo,
+                    unidad: oc.Comprador.NombreUnidad,
+                    region: oc.Comprador.RegionUsuario,
+                },
+                proveedor: {
+                    nombre: oc.Proveedor.Nombre,
+                    rut: oc.Proveedor.Rut,
+                },
+                items: oc.Items.Listado.map((item) => ({
+                    producto: item.Producto,
+                    cantidad: item.Cantidad,
+                    precio_neto: item.PrecioNeto,
+                    total_neto: item.TotalLnea,
+                })),
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof CompraAgilApiError
+                ? error.actionableMessage
+                : `Error inesperado: ${String(error)}`;
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=detalle-oc.js.map

package/dist/tools/detalle-oc.js.map

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

package/dist/tools/documentos.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registra las herramientas relacionadas con documentos y especificaciones en el servidor MCP.
+ */
+export declare function registerDocumentosTools(server: McpServer): void;
+//# sourceMappingURL=documentos.d.ts.map

package/dist/tools/documentos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentos.d.ts","sourceRoot":"","sources":["../../src/tools/documentos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoCpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2O/D"}

package/dist/tools/documentos.js

@@ -0,0 +1,245 @@
+import { z } from 'zod';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { PDFParse } from 'pdf-parse';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageDocsDir = path.resolve(__dirname, '../../docs');
+const cwdDocsDir = path.resolve(process.cwd(), 'docs');
+let DOCS_DIR = cwdDocsDir;
+if (fs.existsSync(packageDocsDir) && fs.readdirSync(packageDocsDir).some(f => f.toLowerCase().endsWith('.pdf'))) {
+    DOCS_DIR = packageDocsDir;
+}
+/**
+ * Obtiene de forma recursiva todos los archivos dentro de un directorio,
+ * retornando sus rutas relativas formateadas con barras diagonales (/).
+ */
+function getRelativeFilesRecursively(dir, baseDir = dir) {
+    let results = [];
+    if (!fs.existsSync(dir))
+        return [];
+    const list = fs.readdirSync(dir);
+    for (const file of list) {
+        const filePath = path.join(dir, file);
+        const stat = fs.statSync(filePath);
+        if (stat && stat.isDirectory()) {
+            results = results.concat(getRelativeFilesRecursively(filePath, baseDir));
+        }
+        else {
+            const relativePath = path.relative(baseDir, filePath).replace(/\\/g, '/');
+            results.push(relativePath);
+        }
+    }
+    return results;
+}
+/**
+ * Registra las herramientas relacionadas con documentos y especificaciones en el servidor MCP.
+ */
+export function registerDocumentosTools(server) {
+    // ─── 1. OBTENER ENLACE DE DOCUMENTO DE PROCESO ───────────────────────
+    server.registerTool('obtener_enlace_documento', {
+        description: 'Genera el enlace oficial de descarga pública en Mercado Público para un adjunto (bases, especificaciones o anexos) usando su ID de documento.',
+        inputSchema: {
+            id_documento: z.string().describe('ID único del documento. Ej: "123456" de la lista de documentos de una compra.'),
+        },
+    }, async (args) => {
+        const url = `https://www.mercadopublico.cl/FichaLicitacion/RetornaDocumento.aspx?id=${args.id_documento}`;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Enlace de descarga oficial del documento:\n${url}\n\nNota: Este enlace es público y se puede abrir directamente en el navegador para descargar el archivo.`,
+                }],
+        };
+    });
+    // ─── 2. DESCARGAR Y LEER DOCUMENTO DE PROCESO (REMOTO) ───────────────
+    server.registerTool('descargar_y_leer_documento', {
+        description: 'Descarga un documento adjunto de Mercado Público (bases técnicas/administrativas) en formato PDF usando su ID, extrae su texto y lo retorna al LLM. Útil para auditar requisitos técnicos de una oferta.',
+        inputSchema: {
+            id_documento: z.string().describe('ID único del documento. Ej: "123456".'),
+            query: z.string().optional().describe('Si se proporciona, busca y retorna solo fragmentos que contengan este término (case-insensitive).'),
+            max_caracteres: z.number().min(500).max(15000).default(5000).optional().describe('Límite de caracteres a retornar (default 5000) para evitar saturar el contexto de la IA.'),
+        },
+    }, async (args) => {
+        try {
+            const url = `https://www.mercadopublico.cl/FichaLicitacion/RetornaDocumento.aspx?id=${args.id_documento}`;
+            // Descargar PDF
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new Error(`Error HTTP al intentar descargar el documento: ${response.status} ${response.statusText}`);
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            const buffer = Buffer.from(arrayBuffer);
+            // Parsear PDF
+            const parser = new PDFParse({ data: buffer });
+            const pdfData = await parser.getText();
+            const text = pdfData.text || '';
+            if (!text.trim()) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `El documento con ID ${args.id_documento} se descargó pero parece estar vacío o no contiene texto legible (ej: escaneado sin OCR).`,
+                        }],
+                };
+            }
+            // Si se provee una query, realizar filtrado local de coincidencias
+            if (args.query) {
+                const searchTerm = args.query.toLowerCase();
+                const lines = text.split('\n');
+                const matches = [];
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i]?.trim();
+                    if (line && line.toLowerCase().includes(searchTerm)) {
+                        // Devolver la línea con algo de contexto (línea anterior y posterior)
+                        const context = [];
+                        if (i > 0 && lines[i - 1]?.trim())
+                            context.push(`[Anterior] ${lines[i - 1]?.trim()}`);
+                        context.push(`[COINCIDENCIA] ${line}`);
+                        if (i < lines.length - 1 && lines[i + 1]?.trim())
+                            context.push(`[Siguiente] ${lines[i + 1]?.trim()}`);
+                        matches.push(context.join('\n'));
+                    }
+                }
+                if (matches.length === 0) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `No se encontraron coincidencias para "${args.query}" en el documento ID ${args.id_documento}. El texto inicial del documento es:\n\n${text.substring(0, 1000)}...`,
+                            }],
+                    };
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Coincidencias encontradas para "${args.query}" en el documento (ID: ${args.id_documento}):\n\n${matches.slice(0, 15).join('\n\n--- \n\n')}`,
+                        }],
+                };
+            }
+            // Si no hay query, retornar el texto inicial
+            const limit = args.max_caracteres || 5000;
+            const truncated = text.length > limit ? `${text.substring(0, limit)}\n\n[... TEXTO TRUNCADO POR LÍMITE DE CONTEXTO ...] Código de descarga del documento completo: ${url}` : text;
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Contenido extraído del documento (ID: ${args.id_documento}):\n\n${truncated}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error al procesar el documento remoto: ${error.message || String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+    // ─── 3. CONSULTAR DOCUMENTOS LOCALES (MANUALES/GUÍAS) ────────────────
+    server.registerTool('consultar_documentos_locales', {
+        description: 'Busca y lee información dentro de los manuales, normativas o guías de Compra Ágil almacenados localmente en la carpeta docs/ (soporta formatos .pdf, .txt, .md).',
+        inputSchema: {
+            query: z.string().optional().describe('Término de búsqueda para filtrar fragmentos del documento (ej: "monto", "criterios"). Si se omite, lista los documentos disponibles.'),
+            max_caracteres: z.number().min(500).max(15000).default(3000).optional().describe('Cantidad máxima de texto a retornar de cada coincidencia.'),
+        },
+    }, async (args) => {
+        try {
+            if (!fs.existsSync(DOCS_DIR)) {
+                fs.mkdirSync(DOCS_DIR, { recursive: true });
+            }
+            const files = getRelativeFilesRecursively(DOCS_DIR).filter(file => {
+                const ext = path.extname(file).toLowerCase();
+                const name = path.basename(file).toLowerCase();
+                return (ext === '.pdf' || ext === '.txt' || ext === '.md') && name !== 'readme.md';
+            });
+            if (files.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `La carpeta local "docs/" está vacía. Guarda tus archivos PDF, TXT o MD de Compra Ágil allí para poder consultarlos con esta herramienta.\nRuta de la carpeta: ${DOCS_DIR}`,
+                        }],
+                };
+            }
+            // Si no hay query, listar los archivos disponibles
+            if (!args.query) {
+                const fileList = files.map(file => {
+                    const stats = fs.statSync(path.join(DOCS_DIR, file));
+                    return `- ${file} (${(stats.size / 1024).toFixed(1)} KB)`;
+                }).join('\n');
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Documentos locales de ayuda disponibles en "docs/":\n\n${fileList}\n\nPara buscar dentro de ellos, ejecuta esta herramienta especificando el parámetro "query".`,
+                        }],
+                };
+            }
+            const searchTerm = args.query.toLowerCase();
+            const results = [];
+            for (const file of files) {
+                const filePath = path.join(DOCS_DIR, file);
+                const ext = path.extname(file).toLowerCase();
+                let fileText = '';
+                try {
+                    if (ext === '.pdf') {
+                        const buffer = fs.readFileSync(filePath);
+                        const parser = new PDFParse({ data: buffer });
+                        const pdfData = await parser.getText();
+                        fileText = pdfData.text || '';
+                    }
+                    else {
+                        fileText = fs.readFileSync(filePath, 'utf8');
+                    }
+                    if (fileText.toLowerCase().includes(searchTerm)) {
+                        // Buscar fragmentos relevantes
+                        const lines = fileText.split('\n');
+                        const fileMatches = [];
+                        for (let i = 0; i < lines.length; i++) {
+                            const line = lines[i]?.trim();
+                            if (line && line.toLowerCase().includes(searchTerm)) {
+                                const context = [];
+                                if (i > 0 && lines[i - 1]?.trim())
+                                    context.push(`[Anterior] ${lines[i - 1]?.trim()}`);
+                                context.push(`[COINCIDENCIA] ${line}`);
+                                if (i < lines.length - 1 && lines[i + 1]?.trim())
+                                    context.push(`[Siguiente] ${lines[i + 1]?.trim()}`);
+                                fileMatches.push(context.join('\n'));
+                            }
+                        }
+                        if (fileMatches.length > 0) {
+                            const limit = args.max_caracteres || 3000;
+                            const matchesText = fileMatches.join('\n\n---\n\n');
+                            const truncated = matchesText.length > limit ? `${matchesText.substring(0, limit)}... [TRUNCADO]` : matchesText;
+                            results.push(`### Archivo: ${file}\n\n${truncated}`);
+                        }
+                    }
+                }
+                catch (e) {
+                    results.push(`### Archivo: ${file}\nError al leer o parsear: ${e.message || String(e)}`);
+                }
+            }
+            if (results.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No se encontraron coincidencias para "${args.query}" en ninguno de los ${files.length} documentos locales en "docs/".`,
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Resultados de búsqueda para "${args.query}" en documentos locales:\n\n${results.join('\n\n====================\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error al consultar documentos locales: ${error.message || String(error)}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=documentos.js.map