autoform-mcp-server 1.6.1 → 1.7.0

package/README.md

@@ -38,13 +38,14 @@ Config file location:
 - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
 - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-## Tools (9)
+## Tools (11)
 
 ### PDF Analysis
 | Tool | Description |
 |------|-------------|
 | `autoform_get_pdf_info` | Get page count and dimensions of a PDF |
 | `autoform_detect_fields` | Detect AcroForm fields in interactive PDFs |
+| `autoform_analyze_static_pdf` | Classify PDF type and suggest field positions for static PDFs |
 
 ### Fill Single PDF
 | Tool | Description |
@@ -55,6 +56,7 @@ Config file location:
 ### Batch Generation
 | Tool | Description |
 |------|-------------|
+| `autoform_fill_batch_acroform` | Generate multiple PDFs from an AcroForm PDF + data array |
 | `autoform_fill_batch_at_coordinates` | Generate multiple PDFs from one template + data, using coordinates |
 | `autoform_generate_batch` | Generate multiple PDFs using a saved template + data array |
 
@@ -65,6 +67,20 @@ Config file location:
 | `autoform_import_template` | Import a template JSON exported from the AutoForm web app |
 | `autoform_list_templates` | List all saved templates |
 
+### Experimental Parameters (v1.7.0+)
+
+All tools accept optional `_session_id` and `_mode` parameters for experimental instrumentation:
+
+- `_session_id`: Groups related tool calls in `metrics.jsonl` (format: `<pdf_id>_<mode>_<rep>`)
+- `_mode`: Labels the autonomy mode (`1_manual_web`, `2_hybrid`, `3a_acroform`, `3b_vision`)
+
+### Metrics (v1.7.0+)
+
+Every tool call is logged to `~/.autoform-mcp/metrics.jsonl` with:
+- Timestamp, tool name, duration, success/error
+- Per-field details: coordinates (PDF points), text written, field IDs
+- Session and mode labels for experimental analysis
+
 ## Usage Examples
 
 ### Fill a certificate (Claude analyzes the PDF visually)

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.6.1' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'autoform', version: '1.7.0' }, { capabilities: { tools: {} } });
 // Register all tools
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -78,4 +78,4 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 // Start server
 const transport = new StdioServerTransport();
 await server.connect(transport);
-console.error('[AutoForm MCP] Server v1.6.1 started — 11 tools registered (metrics enabled)');
+console.error('[AutoForm MCP] Server v1.7.0 started — 11 tools registered (metrics enabled)');

package/dist/services/metricsLogger.d.ts

@@ -5,13 +5,10 @@ export interface MetricsEvent {
     success: boolean;
     error_message?: string;
     session_id?: string;
-    input?: Record<string, number | string | boolean>;
+    mode?: string;
+    input?: Record<string, any>;
     output?: Record<string, number | string | boolean>;
 }
-/**
- * Wrap a tool handler to automatically measure and log metrics.
- * The handler's behavior is unchanged; metrics are captured transparently.
- */
 export declare function withMetrics<T>(toolName: string, args: any, handler: (args: any) => Promise<T>): Promise<T>;
 /**
  * Generate a new random session ID (not used automatically — exported for future use).

package/dist/services/metricsLogger.js

@@ -22,10 +22,6 @@ import * as crypto from 'crypto';
 const METRICS_DIR = path.join(os.homedir(), '.autoform-mcp');
 const METRICS_FILE = path.join(METRICS_DIR, 'metrics.jsonl');
 const METRICS_DISABLED = process.env.AUTOFORM_METRICS_DISABLED === '1';
-/**
- * Extract structural stats from tool arguments without leaking raw data.
- * Only records COUNTS and sizes, never the actual content of fields or user data.
- */
 function summarizeInput(toolName, args) {
     const summary = {};
     if (!args || typeof args !== 'object')
@@ -72,8 +68,93 @@ function summarizeInput(toolName, args) {
     if (typeof args.template_name === 'string') {
         summary.template_name = args.template_name;
     }
+    // ─── Ítem 1: Exact coordinate logging per field written ───
+    // For fill tools, extract detailed per-field info (coordinates + text)
+    try {
+        if (toolName === 'autoform_fill_at_coordinates' && fields) {
+            summary.fields_written = extractFieldsWritten(fields);
+        }
+        if (toolName === 'autoform_fill_batch_at_coordinates' && fieldDefs && dataRows) {
+            // For batch: log fields per row (first row only for brevity, full set in fields_written_all)
+            summary.fields_written = extractFieldDefsWritten(fieldDefs, dataRows[0]);
+            if (dataRows.length > 1) {
+                summary.fields_written_all_rows = dataRows.map((row) => extractFieldDefsWritten(fieldDefs, row));
+            }
+        }
+        if (toolName === 'autoform_fill_batch_acroform' && dataRows) {
+            // AcroForm: we know the field names from data_rows keys + optional field_map
+            const fieldMap = args.field_map && typeof args.field_map === 'object' ? args.field_map : null;
+            summary.fields_written = extractAcroFormFieldsWritten(dataRows[0], fieldMap);
+            if (dataRows.length > 1) {
+                summary.fields_written_all_rows = dataRows.map((row) => extractAcroFormFieldsWritten(row, fieldMap));
+            }
+        }
+        if (toolName === 'autoform_fill_pdf') {
+            // fill_pdf with field_values — AcroForm or template-based
+            if (args.field_values && typeof args.field_values === 'object') {
+                const fieldMap = args.field_map && typeof args.field_map === 'object' ? args.field_map : null;
+                summary.fields_written = extractAcroFormFieldsWritten(args.field_values, fieldMap);
+            }
+        }
+    }
+    catch {
+        // Never let field extraction break the logger
+    }
     return summary;
 }
+/** Extract per-field details from fill_at_coordinates fields array */
+function extractFieldsWritten(fields) {
+    return fields.map((f) => {
+        const detail = {
+            text: String(f.text ?? ''),
+            x_pt: Number(f.x) || 0,
+            y_pt: Number(f.y) || 0,
+            page: Number(f.page) || 1,
+            coordinate_origin: 'bottom_left'
+        };
+        if (f.width != null)
+            detail.width_pt = Number(f.width);
+        if (f.height != null)
+            detail.height_pt = Number(f.height);
+        if (f.fontSize != null)
+            detail.fontSize = Number(f.fontSize);
+        return detail;
+    });
+}
+/** Extract per-field details from fill_batch_at_coordinates (field_definitions + one data row) */
+function extractFieldDefsWritten(fieldDefs, dataRow) {
+    if (!dataRow || typeof dataRow !== 'object')
+        return [];
+    return fieldDefs.map((fd) => {
+        const label = fd.label || '';
+        const detail = {
+            text: String(dataRow[label] ?? ''),
+            x_pt: Number(fd.x) || 0,
+            y_pt: Number(fd.y) || 0,
+            page: Number(fd.page) || 1,
+            coordinate_origin: 'bottom_left',
+            semantic_label: label
+        };
+        if (fd.width != null)
+            detail.width_pt = Number(fd.width);
+        if (fd.height != null)
+            detail.height_pt = Number(fd.height);
+        if (fd.fontSize != null)
+            detail.fontSize = Number(fd.fontSize);
+        return detail;
+    });
+}
+/** Extract per-field details from AcroForm fill (field_values object) */
+function extractAcroFormFieldsWritten(fieldValues, fieldMap) {
+    if (!fieldValues || typeof fieldValues !== 'object')
+        return [];
+    return Object.entries(fieldValues).map(([key, value]) => ({
+        text: String(value ?? ''),
+        coordinates_available: false, // AcroForm positions handled internally by pdf-lib — harness uses field_id matching
+        field_id: fieldMap ? (fieldMap[key] || key) : key,
+        semantic_label: key
+    }));
+}
 /**
  * Extract structural stats from the MCP tool response.
  * Parses the returned JSON text to extract counts (documents_generated, total_fields, etc.).
@@ -175,13 +256,18 @@ function writeEvent(event) {
  * Wrap a tool handler to automatically measure and log metrics.
  * The handler's behavior is unchanged; metrics are captured transparently.
  */
+/** Valid experimental modes for _mode parameter */
+const VALID_MODES = ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'];
 export async function withMetrics(toolName, args, handler) {
     const startTime = Date.now();
     const sessionId = typeof args?._session_id === 'string' ? args._session_id : undefined;
-    // Strip _session_id from args before passing to handler (internal only)
-    const cleanArgs = args && typeof args === 'object' && '_session_id' in args
-        ? (() => { const { _session_id, ...rest } = args; return rest; })()
-        : args;
+    const mode = typeof args?._mode === 'string' && VALID_MODES.includes(args._mode) ? args._mode : undefined;
+    // Strip _session_id and _mode from args before passing to handler (internal only)
+    let cleanArgs = args;
+    if (args && typeof args === 'object' && ('_session_id' in args || '_mode' in args)) {
+        const { _session_id, _mode, ...rest } = args;
+        cleanArgs = rest;
+    }
     let result;
     let success = true;
     let errorMessage;
@@ -208,6 +294,7 @@ export async function withMetrics(toolName, args, handler) {
             success: false,
             error_message: errorMessage,
             ...(sessionId ? { session_id: sessionId } : {}),
+            ...(mode ? { mode } : {}),
             input: summarizeInput(toolName, cleanArgs)
         };
         writeEvent(event);
@@ -220,6 +307,7 @@ export async function withMetrics(toolName, args, handler) {
         success,
         ...(errorMessage ? { error_message: errorMessage } : {}),
         ...(sessionId ? { session_id: sessionId } : {}),
+        ...(mode ? { mode } : {}),
         input: summarizeInput(toolName, cleanArgs),
         output: summarizeOutput(result)
     };

package/dist/services/pdfTextExtractor.d.ts

@@ -68,6 +68,25 @@ export declare class PdfTextExtractor {
      * Each graphic element gets a nearbyLabel from the closest text item.
      */
     static extractFullPageInfo(pdfPath: string): Promise<PageFullInfo[]>;
+    /**
+     * Extract all text items from a PDF with positions converted to top-left origin.
+     * Used for post-hoc validation: verify that pdf-lib actually wrote where the MCP said it wrote.
+     *
+     * Returns items grouped by proximity (consecutive items on the same Y line are merged).
+     * Coordinates: PDF points, origin top-left (y=0 at top of page).
+     *
+     * This is an internal function called by the analysis harness (research/scripts/analyze-experiment.js),
+     * NOT exposed as an MCP tool.
+     */
+    static extractWrittenTextPositions(pdfPath: string): Promise<Array<{
+        text: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        fontSize: number;
+        page: number;
+    }>>;
     /**
      * Classify a PDF based on extractable text density.
      * Thresholds are empirical; can be tuned.

package/dist/services/pdfTextExtractor.js

@@ -233,6 +233,75 @@ export class PdfTextExtractor {
         }
         return results;
     }
+    /**
+     * Extract all text items from a PDF with positions converted to top-left origin.
+     * Used for post-hoc validation: verify that pdf-lib actually wrote where the MCP said it wrote.
+     *
+     * Returns items grouped by proximity (consecutive items on the same Y line are merged).
+     * Coordinates: PDF points, origin top-left (y=0 at top of page).
+     *
+     * This is an internal function called by the analysis harness (research/scripts/analyze-experiment.js),
+     * NOT exposed as an MCP tool.
+     */
+    static async extractWrittenTextPositions(pdfPath) {
+        const bytes = fs.readFileSync(pdfPath);
+        const pdf = await pdfjsLib.getDocument({
+            data: new Uint8Array(bytes),
+            useSystemFonts: true,
+            verbosity: 0
+        }).promise;
+        const results = [];
+        for (let pageNum = 1; pageNum <= pdf.numPages; pageNum++) {
+            const page = await pdf.getPage(pageNum);
+            const viewport = page.getViewport({ scale: 1 });
+            const pageHeight = viewport.height;
+            const textContent = await page.getTextContent();
+            // Collect raw items with top-left coordinates
+            const rawItems = [];
+            for (const raw of textContent.items) {
+                const text = String(raw.str ?? '');
+                if (text === '')
+                    continue;
+                const [, , , scaleY, tx, ty] = raw.transform;
+                const fontSize = Math.abs(scaleY);
+                const width = Math.abs(raw.width ?? 0);
+                const height = Math.abs(raw.height ?? fontSize);
+                // Convert from PDF bottom-left to top-left origin
+                // ty is the text baseline; subtract height to get the top edge of the text
+                const yTopLeft = pageHeight - ty - height;
+                rawItems.push({
+                    text,
+                    x: tx,
+                    y: yTopLeft,
+                    width,
+                    height,
+                    fontSize,
+                    page: pageNum
+                });
+            }
+            // Group consecutive items on the same Y line (within 2pt tolerance)
+            // pdfjs-dist fragments text into runs; pdf-lib may write a whole string as one item
+            const grouped = [];
+            for (const item of rawItems) {
+                const last = grouped[grouped.length - 1];
+                if (last &&
+                    last.page === item.page &&
+                    Math.abs(last.y - item.y) < 2 &&
+                    Math.abs((last.x + last.width) - item.x) < 5) {
+                    // Merge: extend text and width
+                    last.text += item.text;
+                    last.width = (item.x + item.width) - last.x;
+                    last.height = Math.max(last.height, item.height);
+                    last.fontSize = Math.max(last.fontSize, item.fontSize);
+                }
+                else {
+                    grouped.push({ ...item });
+                }
+            }
+            results.push(...grouped);
+        }
+        return results;
+    }
     /**
      * Classify a PDF based on extractable text density.
      * Thresholds are empirical; can be tuned.

package/dist/tools/analyzeStaticPdf.d.ts

@@ -8,6 +8,15 @@ export declare const analyzeStaticPdfSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/analyzeStaticPdf.js

@@ -42,6 +42,15 @@ Hay algo de texto pero poca densidad. Puede haber campos que NO se detectaron au
             pdf_path: {
                 type: 'string',
                 description: 'Ruta absoluta al PDF estatico a analizar'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['pdf_path']

package/dist/tools/detectFields.d.ts

@@ -8,6 +8,15 @@ export declare const detectFieldsSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/detectFields.js

@@ -36,6 +36,15 @@ FLUJO RECOMENDADO PARA MULTIPLES DOCUMENTOS:
             pdf_path: {
                 type: 'string',
                 description: 'Ruta absoluta al archivo PDF'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['pdf_path']

package/dist/tools/fillAtCoordinates.d.ts

@@ -55,6 +55,15 @@ export declare const fillAtCoordinatesSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };
@@ -69,6 +78,15 @@ export declare const getPdfInfoSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/fillAtCoordinates.js

@@ -47,6 +47,15 @@ COORDENADAS: Origen (0,0) = esquina inferior-izquierda. Y aumenta hacia arriba.
             output_path: {
                 type: 'string',
                 description: '(Opcional) Ruta donde guardar el PDF. Default: ~/.autoform-mcp/output/'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl. Formato: <pdf_id>_<mode>_<rep>'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental. Se registra en metrics.jsonl.'
             }
         },
         required: ['pdf_path', 'fields']
@@ -61,6 +70,15 @@ export const getPdfInfoSchema = {
             pdf_path: {
                 type: 'string',
                 description: 'Ruta absoluta al archivo PDF'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['pdf_path']

package/dist/tools/fillBatchAcroForm.d.ts

@@ -33,6 +33,15 @@ export declare const fillBatchAcroFormSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/fillBatchAcroForm.js

@@ -51,6 +51,15 @@ VERIFICACION: Si el usuario adjunto el PDF al chat Y dio la ruta, aprovecha la i
             output_dir: {
                 type: 'string',
                 description: '(Opcional) Directorio de salida. Default: ~/.autoform-mcp/output/'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl. Formato: <pdf_id>_<mode>_<rep>'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental. Se registra en metrics.jsonl.'
             }
         },
         required: ['pdf_path', 'data_rows']

package/dist/tools/fillBatchAtCoordinates.d.ts

@@ -69,6 +69,15 @@ export declare const fillBatchAtCoordinatesSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/fillBatchAtCoordinates.js

@@ -75,6 +75,15 @@ SISTEMA DE COORDENADAS: Origen (0,0) = esquina inferior-izquierda. Y aumenta hac
             output_dir: {
                 type: 'string',
                 description: '(Opcional) Directorio de salida. Default: ~/.autoform-mcp/output/'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl. Formato: <pdf_id>_<mode>_<rep>'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental. Se registra en metrics.jsonl.'
             }
         },
         required: ['pdf_path', 'field_definitions', 'data_rows']

package/dist/tools/fillPdf.d.ts

@@ -23,6 +23,15 @@ export declare const fillPdfSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/fillPdf.js

@@ -34,6 +34,15 @@ DIRECTORIO DE SALIDA: Si no se especifica output_path, guarda en el MISMO direct
             template_name: {
                 type: 'string',
                 description: '(Opcional) Nombre del template a usar para posicionar los campos. Solo necesario si el PDF no tiene AcroForm.'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['pdf_path', 'field_values']

package/dist/tools/generateBatch.d.ts

@@ -27,6 +27,15 @@ export declare const generateBatchSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/generateBatch.js

@@ -35,6 +35,15 @@ Modos de distribucion:
             merge_into_single: {
                 type: 'boolean',
                 description: 'Si es true, une todos los PDFs en uno solo. Default: false.'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['template_name', 'data']

package/dist/tools/importTemplate.d.ts

@@ -8,6 +8,15 @@ export declare const importTemplateSchema: {
                 type: string;
                 description: string;
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/importTemplate.js

@@ -11,6 +11,15 @@ ALTERNATIVA: Si no usas la app web, usa autoform_save_coordinates_as_template pa
             json_file_path: {
                 type: 'string',
                 description: 'Ruta absoluta al archivo JSON exportado desde la app web de AutoForm'
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['json_file_path']

package/dist/tools/manageTemplates.d.ts

@@ -3,8 +3,18 @@ export declare const listTemplatesSchema: {
     description: string;
     inputSchema: {
         type: "object";
-        properties: {};
-        required: never[];
+        properties: {
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
     };
 };
 export declare function handleListTemplates(): Promise<{

package/dist/tools/manageTemplates.js

@@ -6,7 +6,17 @@ export const listTemplatesSchema = {
 CUANDO USAR: Antes de autoform_generate_batch para verificar que el template existe y ver sus columnas requeridas.`,
     inputSchema: {
         type: 'object',
-        properties: {},
+        properties: {
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
+            }
+        },
         required: []
     }
 };

package/dist/tools/saveCoordinatesAsTemplate.d.ts

@@ -59,6 +59,15 @@ export declare const saveCoordinatesAsTemplateSchema: {
                     required: string[];
                 };
             };
+            _session_id: {
+                type: string;
+                description: string;
+            };
+            _mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
         };
         required: string[];
     };

package/dist/tools/saveCoordinatesAsTemplate.js

@@ -45,6 +45,15 @@ FLUJO TIPICO:
                     },
                     required: ['label', 'page', 'x', 'y', 'width', 'height']
                 }
+            },
+            _session_id: {
+                type: 'string',
+                description: '(Opcional) ID de sesion experimental para agrupar tool calls en metrics.jsonl.'
+            },
+            _mode: {
+                type: 'string',
+                enum: ['1_manual_web', '2_hybrid', '3a_acroform', '3b_vision'],
+                description: '(Opcional) Modo de autonomia experimental.'
             }
         },
         required: ['pdf_path', 'template_name', 'fields']

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoform-mcp-server",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "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",