@zincapp/mcp-server 1.9.0 → 1.11.0

package/dist/tools/index.js

@@ -17,6 +17,7 @@ import { registerLinkGestorAuthorizations } from './link-gestor-authorizations.j
 import { registerProposeNt } from './propose-nt.js';
 import { registerLookupAuthorization } from './lookup-authorization.js';
 import { registerNtFinalGestor } from './nt-final-gestor.js';
+import { registerUpsertGestor } from './upsert-gestor.js';
 export function registerAllTools(server, client) {
     registerSearchDocs(server, client);
     registerReadDoc(server, client);
@@ -37,4 +38,5 @@ export function registerAllTools(server, client) {
     registerProposeNt(server, client);
     registerLookupAuthorization(server, client);
     registerNtFinalGestor(server, client);
+    registerUpsertGestor(server, client);
 }

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/dist/tools/upsert-gestor.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ZincAppClient } from '../client.js';
+export declare function registerUpsertGestor(server: McpServer, client: ZincAppClient): void;

package/dist/tools/upsert-gestor.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { resolveElevation } from './elevation.js';
+export function registerUpsertGestor(server, client) {
+    server.tool('upsert_entidad', 'Alta o completado (best-effort) de una entidad gestor/transportista por CIF, bajo la elevación del ' +
+        'operador. Idempotente: si el CIF ya existe la completa (solo los campos aportados), si no la crea. ' +
+        'No valida E3L: rellena lo disponible.', {
+        cif: z.string().describe('CIF de la entidad (identidad; requerido).'),
+        nombre: z.string().optional(),
+        entityType: z.number().int().optional().describe('tipo_entidad (E3L lo exige a nivel entidad).'),
+        telefono: z.string().optional(),
+        mail: z.string().optional(),
+        gestor: z.boolean().optional(),
+        transportista: z.boolean().optional(),
+    }, async (args) => {
+        const elev = await resolveElevation(client);
+        if ('content' in elev)
+            return elev;
+        const res = await client.post('/mwm/retirada/upsert-entidad', { confirm: true, ...args });
+        const verbo = res.outcome === 'created' ? 'creada' : 'actualizada';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Entidad **${verbo}** (CIF \`${args.cif}\`) — clientId \`${res.clientId}\`.`,
+                }],
+        };
+    });
+    server.tool('upsert_centro', 'Alta o completado (best-effort) de un centro de un gestor, bajo la elevación del operador. Identidad ' +
+        'por centerId o por nima inequívoco (varios con la misma nima → 409, aporta centerId). Valida un id de ' +
+        'catálogo solo si se aporta. Si aportas authId+autorizacion, hace también el upsert de la autorización.', {
+        clientId: z.number().int().describe('clientId de la entidad padre (requerido; debe existir).'),
+        centerId: z.number().int().optional().describe('Identidad explícita del centro (si se conoce).'),
+        nima: z.number().int().optional().describe('NIMA para identificar el centro si no hay centerId.'),
+        nombre: z.string().optional(),
+        direccion: z.string().optional(),
+        ciudad: z.string().optional(),
+        cp: z.string().optional(),
+        regionId: z.number().int().optional(),
+        provinceId: z.number().int().optional(),
+        localityId: z.number().int().optional(),
+        vialId: z.number().int().optional(),
+        codigoCnae: z.string().optional().describe('Código CNAE (varchar(4), PK de IneCnae).'),
+        telefono: z.string().optional(),
+        mail: z.string().optional(),
+        authId: z.string().optional().describe('Tipo de autorización (T01/G0x) — con autorizacion, hace el upsert.'),
+        autorizacion: z.string().optional().describe('Número de registro de la autorización (lo aporta el humano).'),
+    }, async (args) => {
+        const elev = await resolveElevation(client);
+        if ('content' in elev)
+            return elev;
+        const res = await client.post('/mwm/retirada/upsert-centro', { confirm: true, ...args });
+        const verbo = res.outcome === 'created' ? 'creado' : 'actualizado';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Centro **${verbo}** — clientId \`${res.clientId}\`, centerId \`${res.centerId}\`.`,
+                }],
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zincapp/mcp-server",
-  "version": "1.9.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": {