@zincapp/mcp-server 1.10.0 → 1.11.0

package/dist/tools/nt-final-gestor.d.ts

@@ -9,4 +9,15 @@ export declare function validatePdf(bytes: Buffer): {
     ok: false;
     error: string;
 };
+interface LinkDto {
+    orden: number;
+    clientId: number;
+    centerId: number;
+    operacion: string;
+}
 export declare function registerNtFinalGestor(server: McpServer, client: ZincAppClient): void;
+/** Una línea por eslabón, en orden documental. Puro y exportado para test. */
+export declare function formatChain(cadena: LinkDto[]): string;
+/** Los defectos de forma que E3L reportará al emitir. NO bloquean el vínculo. Puro y exportado para test. */
+export declare function formatWarnings(avisos: string[]): string;
+export {};

package/dist/tools/nt-final-gestor.js

@@ -44,10 +44,11 @@ function resolvePdfBase64(pdfPath, pdfBase64) {
 }
 const errorContent = (text) => ({ content: [{ type: 'text', text }] });
 export function registerNtFinalGestor(server, client) {
-    server.tool('preview_nt_final_gestor', 'DRY-RUN: extrae por IA el "Gestor final para la operación Dxx" del PDF de una Notificación Previa ' +
-        '(NT), lo resuelve contra las entidades/centros de tu tenant, valida las invariantes E3L ' +
-        '(operación en Table2Type + autorización por LER del centro), y devuelve una PROPUESTA opaca ' +
-        '(con proposalId) SIN escribir nada. Aporta el PDF con pdfPath (ruta local) o pdfBase64 ' +
+    server.tool('preview_nt_final_gestor', 'DRY-RUN: extrae por IA la CADENA COMPLETA de gestores finales (hasta 3 eslabones, p.ej. ' +
+        'D15→D13→D9), la resuelve contra las entidades/centros de tu tenant (fail-closed sólo por ' +
+        'IDENTIDAD: el gestor debe estar dado de alta — si no, usa upsert_entidad/upsert_centro), avisa ' +
+        '(sin bloquear) de lo que le falte a cada centro para exportar E3L, y devuelve una PROPUESTA ' +
+        'opaca (con proposalId) SIN escribir nada. Aporta el PDF con pdfPath (ruta local) o pdfBase64 ' +
         '(exactamente uno). Revisa la propuesta y, si es correcta, aplícala con apply_nt_final_gestor. ' +
         'Corre bajo tu elevación de operador (company derivada de ella).', {
         ntNumero: z.string().describe('El número de la NT objetivo (p.ej. "NT30280008283420220064303")'),
@@ -66,20 +67,26 @@ export function registerNtFinalGestor(server, client) {
                 `**Razón:** ${p.razon ?? 'desconocida'}\n\n` +
                 `Terna actual en la NT: ${fmtTriple(p.ternaActual)}. No se ha persistido nada.`);
         }
+        const cadena = p.cadena ?? [];
+        const avisos = p.avisosE3l ?? [];
         const text = `# Propuesta · NT ${p.ntNumero}\n\n` +
             `- **proposalId:** \`${p.proposalId}\`\n` +
             `- **Nº de NT en el documento:** ${p.ntNumeroDocumento ?? '—'}\n` +
-            `- **Gestor final propuesto:** ${fmtTriple(p.gestorFinal)}\n` +
             `- **Terna actual en la NT:** ${fmtTriple(p.ternaActual)}\n\n` +
-            `Si es correcto, aplica con \`apply_nt_final_gestor({ proposalId: "${p.proposalId}" })\`. ` +
+            `**Cadena de gestores finales propuesta (${cadena.length} eslabón/es):**\n` +
+            `${formatChain(cadena)}\n\n` +
+            `El **último eslabón** es el que verá el libro de registro.` +
+            formatWarnings(avisos) +
+            `\n\nSi es correcto, aplica con \`apply_nt_final_gestor({ proposalId: "${p.proposalId}" })\`. ` +
             `La propuesta caduca (TTL) — aplícala pronto.`;
         return { content: [{ type: 'text', text }] };
     });
     server.tool('apply_nt_final_gestor', 'Aplica una propuesta de gestor final previamente revisada (por proposalId de preview_nt_final_gestor). ' +
-        'NO re-ejecuta la IA ni re-transporta el PDF. Escribe la terna (clientId, centerId, operación) en ' +
-        'la NT bajo tu elevación de operador, por el framework (hooks + auditoría), con regla ' +
-        'complete-what\'s-missing (si la NT ya tiene un gestor final distinto → conflicto, no se ' +
-        'sobrescribe). Sólo aplica propuestas que hayas verificado.', {
+        'NO re-ejecuta la IA ni re-transporta el PDF. Escribe la CADENA (orden 1..N) en la NT, crea los ' +
+        'LER que falten en los centros de la cadena, y deriva la terna del último eslabón, bajo tu ' +
+        'elevación de operador, por el framework (hooks + auditoría), con regla complete-what\'s-missing ' +
+        '(si la NT ya tiene un gestor final distinto → conflicto, no se sobrescribe). Sólo aplica ' +
+        'propuestas que hayas verificado.', {
         proposalId: z.string().describe('El proposalId devuelto por preview_nt_final_gestor'),
     }, async ({ proposalId }) => {
         const elev = await resolveElevation(client);
@@ -91,8 +98,10 @@ export function registerNtFinalGestor(server, client) {
             : `# Sin cambios · NT ${r.ntNumero}`;
         const text = `${titulo}\n\n` +
             `- **Resultado:** ${r.outcome}\n` +
-            `- **Gestor final:** ${fmtTriple(r.gestorFinal)}\n\n` +
-            `_Recuerda des-elevarte desde el portal web con un motivo cuando termines._`;
+            `- **Último eslabón (terna del libro):** ${fmtTriple(r.gestorFinal)}\n\n` +
+            `**Cadena escrita:**\n${formatChain(r.cadena ?? [])}` +
+            formatWarnings(r.avisos ?? []) +
+            `\n\n_Recuerda des-elevarte desde el portal web con un motivo cuando termines._`;
         return { content: [{ type: 'text', text }] };
     });
 }
@@ -101,3 +110,19 @@ function fmtTriple(t) {
         return '(vacía)';
     return `entidad ${t.clientId ?? '—'} / centro ${t.centerId ?? '—'} · operación ${t.operacion ?? '—'}`;
 }
+/** Una línea por eslabón, en orden documental. Puro y exportado para test. */
+export function formatChain(cadena) {
+    if (cadena.length === 0)
+        return '_(sin cadena de gestores finales)_';
+    return cadena
+        .map((l) => `${l.orden}. entidad ${l.clientId} / centro ${l.centerId} · operación **${l.operacion}**`)
+        .join('\n');
+}
+/** Los defectos de forma que E3L reportará al emitir. NO bloquean el vínculo. Puro y exportado para test. */
+export function formatWarnings(avisos) {
+    if (avisos.length === 0)
+        return '';
+    return (`\n\n**Avisos E3L (no bloquean el vínculo):**\n` +
+        avisos.map((a) => `- ${a}`).join('\n') +
+        `\n\n_Se vincula igualmente (best-effort). E3L reportará estos defectos al emitir el DCS._`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zincapp/mcp-server",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "MCP server for ZincApp — search docs, read API reference, execute sandbox calls, and audit/complete waste removals (retiradas)",
   "type": "module",
   "bin": {