autoform-mcp-server 1.7.1 → 1.7.3

package/dist/index.js

@@ -13,7 +13,7 @@ import { handleGenerateBatch, generateBatchSchema } from './tools/generateBatch.
 import { handleListTemplates, listTemplatesSchema } from './tools/manageTemplates.js';
 import { handleImportTemplate, importTemplateSchema } from './tools/importTemplate.js';
 import { withMetrics } from './services/metricsLogger.js';
-const server = new Server({ name: 'autoform', version: '1.7.1' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'autoform', version: '1.7.2' }, { capabilities: { tools: {} } });
 // Register all tools
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [

package/dist/services/batchGenerator.d.ts

@@ -4,7 +4,7 @@ import { SavedTemplate, ParsedData, DistributionMode, GenerationResult } from '.
  * Adapts web app's distributionEngine + pdfGenerator for Node.js.
  */
 export declare class BatchGenerator {
-    static generate(template: SavedTemplate, data: ParsedData[], mode?: DistributionMode, mergeIntoSingle?: boolean): Promise<GenerationResult>;
+    static generate(template: SavedTemplate, data: ParsedData[], mode?: DistributionMode, mergeIntoSingle?: boolean, outputDir?: string): Promise<GenerationResult>;
     private static calculateDocumentsNeeded;
     private static createMappings;
 }

package/dist/services/batchGenerator.js

@@ -9,8 +9,9 @@ const OUTPUT_DIR = path.join(AUTOFORM_HOME, 'output');
  * Adapts web app's distributionEngine + pdfGenerator for Node.js.
  */
 export class BatchGenerator {
-    static async generate(template, data, mode = 'sequential', mergeIntoSingle = false) {
-        fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+    static async generate(template, data, mode = 'sequential', mergeIntoSingle = false, outputDir) {
+        const effectiveOutputDir = outputDir || path.dirname(template.pdfPath) || OUTPUT_DIR;
+        fs.mkdirSync(effectiveOutputDir, { recursive: true });
         const timestamp = new Date().toISOString().slice(0, 10);
         const safeName = template.name.replace(/[^a-zA-Z0-9_\-]/g, '_');
         // Read base PDF
@@ -25,8 +26,8 @@ export class BatchGenerator {
         const errors = [];
         // If merging, write individuals to temp dir (will be cleaned up)
         const workingDir = mergeIntoSingle
-            ? fs.mkdtempSync(path.join(OUTPUT_DIR, '.tmp_batch_'))
-            : OUTPUT_DIR;
+            ? fs.mkdtempSync(path.join(effectiveOutputDir, '.tmp_batch_'))
+            : effectiveOutputDir;
         for (let docNum = 0; docNum < documentsNeeded; docNum++) {
             try {
                 const mappings = this.createMappings(data, template, docNum, mode);
@@ -42,7 +43,7 @@ export class BatchGenerator {
         // Merge if requested — and clean up individuals
         let mergedPath;
         if (mergeIntoSingle && outputPaths.length > 0) {
-            mergedPath = path.join(OUTPUT_DIR, `${safeName}_merged_${timestamp}.pdf`);
+            mergedPath = path.join(effectiveOutputDir, `${safeName}_merged_${timestamp}.pdf`);
             await PdfService.mergePdfs(outputPaths, mergedPath);
             // Delete temp files and dir
             for (const p of outputPaths) {

package/dist/tools/fillBatchAtCoordinates.js

@@ -13,6 +13,7 @@ IMPORTANTE — Codificación de texto:
 IMPORTANTE — Casillas de verificación (checkboxes) en PDFs estaticos:
 - Si detectas opciones tipo checkbox, SOLO marcalas si puedes VER el PDF visualmente (adjuntado al chat). Si no puedes verlo, pide al usuario que lo adjunte.
 - Para marcar: text="X", fontSize=10, en las coordenadas exactas del cuadrado.
+- CHECKBOXES MUTUAMENTE EXCLUYENTES: si el formulario tiene opciones donde solo una puede estar marcada (ej: ALUMNO / DOCENTE / ADMINISTRATIVO), cada fila de data_rows debe tener "X" en EXACTAMENTE UN campo checkbox y "" en los demas. NUNCA pongas "X" en multiples checkboxes de la misma fila.
 
 IMPORTANTE — Verificación visual:
 - Si el usuario adjunto el PDF al chat Y tambien dio la ruta, APROVECHA la imagen visual para verificar que tus coordenadas son correctas antes de generar.

package/dist/tools/generateBatch.d.ts

@@ -27,6 +27,10 @@ export declare const generateBatchSchema: {
                 type: string;
                 description: string;
             };
+            output_dir: {
+                type: string;
+                description: string;
+            };
             _session_id: {
                 type: string;
                 description: string;

package/dist/tools/generateBatch.js

@@ -9,6 +9,15 @@ NO USAR SI: No tienes template guardado → usa autoform_fill_batch_at_coordinat
 
 DATOS: Pasa los datos como array de objetos JSON en el parametro "data". Si el usuario tiene un archivo (Excel, CSV, etc.), leelo primero y convierte a JSON.
 
+CHECKBOXES MUTUAMENTE EXCLUYENTES:
+- Si el template tiene campos tipo checkbox (ej: es_alumno, es_docente, es_administrativo) donde SOLO UNO debe marcarse por documento, asegurate de que CADA fila de data tenga "X" en EXACTAMENTE UN campo de checkbox y "" (string vacio) en todos los demas.
+- NUNCA pongas "X" en multiples checkboxes de la misma fila.
+- Si un error produce checkboxes mal marcados, el error esta en tus datos, NO en el MCP. Revisa y corrige los datos antes de culpar al sistema.
+
+DIRECTORIO DE SALIDA: Si no se especifica output_dir, guarda en el mismo directorio del PDF base del template.
+
+NO GENERES PDF DE PRUEBA: Genera el batch completo directamente.
+
 Modos de distribucion:
 - "sequential": campos repetidos consumen filas diferentes (para tablas/listas)
 - "repeat": una fila se repite en todos los campos con el mismo nombre (para certificados)`,
@@ -36,6 +45,10 @@ Modos de distribucion:
                 type: 'boolean',
                 description: 'Si es true, une todos los PDFs en uno solo. Default: false.'
             },
+            output_dir: {
+                type: 'string',
+                description: '(Opcional) Directorio donde guardar los PDFs generados. Default: mismo directorio del PDF base del template.'
+            },
             _session_id: {
                 type: 'string',
                 description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
@@ -50,7 +63,7 @@ Modos de distribucion:
     }
 };
 export async function handleGenerateBatch(args) {
-    const { template_name, distribution_mode = 'sequential', merge_into_single = false } = args;
+    const { template_name, distribution_mode = 'sequential', merge_into_single = false, output_dir } = args;
     // data puede llegar como string JSON o como array
     let data = args.data;
     if (typeof data === 'string') {
@@ -97,7 +110,7 @@ export async function handleGenerateBatch(args) {
         };
     }
     // Generate
-    const result = await BatchGenerator.generate(template, parsedData, distribution_mode, merge_into_single);
+    const result = await BatchGenerator.generate(template, parsedData, distribution_mode, merge_into_single, output_dir);
     return {
         content: [{
                 type: 'text',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoform-mcp-server",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "MCP server for bulk PDF form filling. Detect fields, fill templates, and generate hundreds of PDFs from data — directly from Claude.",
   "type": "module",
   "main": "dist/index.js",