nexusflex-mcp 3.72.0 → 3.74.0

package/server.mjs

@@ -1,1494 +1,1560 @@
-#!/usr/bin/env node
-// ============================================================================
-//  MCP Nexus Flex v3 — servidor stdio (paquete publicable en npm).
-//
-//  INSTALACIÓN FÁCIL:  npx -y nexusflex-mcp@latest         (arranca el server)
-//                      npx -y nexusflex-mcp@latest login   (autoriza en el navegador)
-//                      npx -y nexusflex-mcp@latest logout  (borra el token local)
-//
-//  AUTENTICACIÓN por DEVICE-FLOW (autorización web): sin pegar email/contraseña.
-//  El MCP pide un código, lo autorizás con un click desde la web ya logueado, y
-//  recibe un token de vida larga, revocable y con TU scope exacto (nunca dinero).
-//  Fallback: NEXUSFLEX_TOKEN o NEXUSFLEX_EMAIL+PASSWORD (compatibilidad).
-//
-//  AISLAMIENTO EN 3 CAPAS:
-//   1) El BACKEND gatea cada endpoint (requireAuth + requirePermiso + scope por
-//      nodo / idCliente). Un token de MCP hereda el rol/permisos FRESCOS del
-//      usuario en cada request. Es la garantía real.
-//   2) Este server registra los tools SEGÚN EL ROL del usuario (leído de /auth/me).
-//   3) DENYLIST de dinero en api.mjs + guard server-side (mcpMoneyGuard): jamás
-//      liquidaciones/cobros/cuentas/facturación.
-//
-//  Escritura por flags (default OFF):
-//   NEXUSFLEX_MCP_ALLOW_WRITE   → altas (clientes, productos, nodos) y edición.
-//   NEXUSFLEX_MCP_ALLOW_PRECIOS → actualizar listas de precios (aparte, sensible).
-// ============================================================================
-import { runDeviceFlow, saveToken, clearToken, tokenFilePath } from "./device-auth.mjs";
-import { api, log, API_URL } from "./api.mjs";
-import { renderAyuda, guiaOnboarding, renderFlujo, FLUJOS } from "./docs.mjs";
-
-// --- Subcomandos de línea de comando (login/logout) antes de arrancar el server ---
-const cmd = process.argv[2];
-if (cmd === "login") {
-  try {
-    const token = await runDeviceFlow(API_URL, { open: true, log });
-    const file = saveToken(token, API_URL);
-    log(`Token guardado en ${file}. Ya podés usar el MCP en Claude Desktop.`);
-    process.exit(0);
-  } catch (e) {
-    log("No se pudo autorizar:", e instanceof Error ? e.message : String(e));
-    process.exit(1);
-  }
-}
-if (cmd === "logout") {
-  clearToken();
-  log(`Token local borrado (${tokenFilePath()}). Revocá también desde la web (🔌 Conexiones) si querés cortar el acceso ya emitido.`);
-  process.exit(0);
-}
-
-const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
-const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
-const { z } = await import("zod");
-
-const truthy = (v) => /^(1|true|yes|si|sí)$/i.test(v ?? "");
-const ALLOW_WRITE = truthy(process.env.NEXUSFLEX_MCP_ALLOW_WRITE);
-const ALLOW_PRECIOS = truthy(process.env.NEXUSFLEX_MCP_ALLOW_PRECIOS);
-
-// ATADO CON: backend/src/services/mcp-remote.ts (MCP_VERSION + NOVEDADES + mismos tools, salvo SOLO_REMOTO)
-// y mcp/package.json. Lo verifica backend/src/coherencia.test.ts. Ver CLAUDE.md → "Cosas que van juntas".
-const MCP_VERSION = "3.72.0"; // bumpear junto con package.json + backend/services/mcp-remote.ts
-const NOVEDADES = [
-  "3.72.0 — CONTROL POR FOTO POR CARPETAS, para cualquier nodo y cualquiera de sus grupos. `control_foto_preparar` (MCP local) te crea las carpetas del día (o de varios) con los nombres exactos de tus grupos y cadetes. Armás una carpeta por día con DADOS/<grupo> (lo que pasaste a un grupo), DADOS/<cadete> (lo repartió un cadete tuyo), RECIBIDOS/…/<cadete> (te lo dio otro nodo y lo repartió tu cadete) y RECIBIDOS/<grupo> (te lo dieron y lo derivaste por ese grupo). `control_foto_carpeta` (MCP local) recorre la carpeta, lee el QR de cada foto (o la IA de etiquetas), busca o da de alta el envío SIN duplicar, lo asigna al responsable de zona / cadete / grupo, lo lleva a Entregado en el día real y le cuelga la foto (la que ven los nodos en su cuenta semanal). Primero simula y te devuelve las preguntas (cuentas de ML desconocidas, zonas con varios responsables, duplicados); se contestan con `control_foto_foto` o, más cómodo, en la app: Logística → 📷 Control por foto (ahí también quedan los envíos SIN VENDEDOR para asignarles el cliente o el nodo que te los dio; «recordar» asocia la cuenta de ML para la próxima, salvo que sea compartida entre logísticas). `control_foto_estructura` te dice qué nombres de carpeta valen. Nada sale de tu red (tu nodo + los de tus grupos). No mueve dinero.",
-  "3.71.0 — Habilitadas por el dueño: `liquidacion_excluir_envio` / `liquidacion_reincluir_envio` (sacar o devolver UN envío del cobro de una liquidación emitida, con motivo obligatorio) y `facturacion_estado` / `facturacion_preparar_cliente` (qué falta para facturar y cargar los datos fiscales de un cliente) ya funcionan por MCP: el filtro de dinero las deja pasar con su método exacto. Siguen sin pagar, cobrar ni emitir comprobantes, y piden permiso finanzas. Además `mis_envios` ahora sí filtra por `estado`.",
-  "3.70.0 — Descripciones al día: textos de las herramientas corregidos para que digan lo que hacen hoy (`envio_entregar`, `envio_asignar_mensajero`, `generar_enlace_vinculacion` vence en 48 hs, `grupo_miembros` y `provisorio_conciliar` apuntan a `grupos_tarifas`), `flujo` lista todos los flujos disponibles, `sugerencias_listar` solo para el superadmin, `envio_cargar` exige `telefono`, parámetros con formato (fechas YYYY-MM-DD, montos en ARS, nombre o id) y las instrucciones del conector más cortas (la guía sigue en `guia`). `liquidacion_excluir_envio`/`reincluir` avisan que hoy el filtro de dinero los bloquea por MCP (se hace desde la PWA).",
-  "3.69.1 — AYUDA completa: `ayuda` ahora tiene la ficha (qué hace, cómo usarlo, ejemplo, qué NO hace) de los 20 tools que no la tenían (cierre semanal, zonas de grupo, tarifas de grupo, sin vendedor, corregir estado, pago al cadete, retiros…) y los 26 que no aparecían en el índice. La ayuda del paquete npm se genera desde la del conector, así que ya no se desincronizan. No mueve dinero.",
-  "3.69.0 — Control por foto de la TANDA DE UN CADETE (propios + de otros nodos mezclados): en `envio_desde_etiqueta_ml` alcanza con el `mlQr` crudo — de ahí sale el número de ML y el vendedor, y el vendedor se reconoce igual que en el escáner (cuenta vinculada O cuenta aprendida en juntadas/escaneos; antes solo la vinculada). `nodoEntrega` ya no necesita `grupo`: si el cliente es del mismo nodo que entrega es un paquete propio (sin traspaso) y si es de otro nodo se usa el grupo que comparten. Si no conoce al vendedor, contesta 404 con el senderId para que preguntes de qué nodo/cliente es. Si el envío ya existía, no lo duplica: lo completa y lo avanza. No mueve dinero.",
-  "3.68.0 — Control por foto: `envio_desde_etiqueta_ml` acepta `nodoEntrega` (nombre o id de un nodo del `grupo`) = el nodo que RECIBIÓ y entregó el paquete. Con `fecha` + `grupo` + `nodoEntrega` una planilla atrasada entra al CIERRE SEMANAL entre nodos en su día real (ej. 5 envíos de un cliente de Envíos Frank que entregó FastCorreo el lunes 14: fecha 14/09, grupo Portela, nodoEntrega FastCorreo). Antes solo se ponía con `autoRutear` y si la zona tenía un único responsable; si no, quedaba fuera del cierre. Si el envío ya tenía OTRO nodo que entrega no se pisa (avisa). Si la semana ya cerró, entra en el cierre siguiente marcado como tarde, con su fecha real. No mueve dinero.",
-  "3.67.0 — TARIFA de grupo de una: `grupo_tarifa_set` fija la tarifa de clearing por zona (cercana/media/lejana/muyLejana) de TODO un grupo — el default del grupo y el precio de cada nodo miembro — en una sola llamada, sin ir nodo por nodo (ej. dejar un grupo nuevo en 2700 los 4 tramos). Con `soloDef` toca solo el default. Solo la comisión (admin) del grupo o el admin global. Es config del clearing, no mueve dinero.",
-  "3.66.0 — COMPOSICIÓN de zonas de grupo: `zona_mover_metazona` reclasifica una metazona/localidad de una zona de grupo a otra del mismo grupo sin tocar el nodo responsable (ej. 'El Palomar' mal puesto en Morón → Tres de Febrero). `zona_componer_grupo` crea/edita una zona de grupo agregando/quitando metazonas y sumándole un nodo responsable — sirve para armar las zonas de un grupo NUEVO con su composición completa (el ruteo matchea por metazona exacta, así que una zona de CABA necesita 'CABA · Barrio' y 'Barrio'). Solo la comisión (admin) del grupo o el admin global.",
-  "3.65.0 — SIN VENDEDOR: `sin_vendedor` muestra las cuentas de Mercado Libre y los envíos cargados con foto que tu nodo tiene sin vendedor (por ejemplo, un nodo recién dado de alta con etiquetas de cuentas no vinculadas ya escaneadas), y `asignar_sin_vendedor` los asigna a UN vendedor en un paso: asocia cada cuenta, le pasa todos sus envíos, le crea el usuario si hace falta y devuelve un enlace de vinculación por cuenta. Cuando el vendedor autoriza el enlace, lo que quedaba de esa cuenta se le engancha solo.",
-  "3.64.1 — FRENO DE DUPLICADOS en `envio_desde_etiqueta_ml` (sin número de ML) y `envio_cargar`: si el cliente ya tiene un envío a esa dirección ese día (±1), responde POSIBLE DUPLICADO nombrándolo (15/09 se cargaron 44 paquetes a mano que ya estaban por planilla y se cobraron dos veces). Si es otro paquete, repetí con `forzarNuevo:true`. Con número de ML, si difiere en un dígito de otro envío del mismo comprador, avisa en `advertencias`.",
-  "3.64.0 — CIERRE SEMANAL entre nodos (juntada): la semana de lunes a sábado se congela sola el miércoles siguiente a las 06:00. Cada paquete que un nodo le pasó a otro esa semana (entregado o no) vale la tarifa del que lo recibe, y por nodo se netea. Lo cerrado no se recalcula; lo que se cargue tarde entra en el cierre siguiente con su fecha. Lo que daría $0 (sin tarifa) no entra y se avisa. Nuevo `cuenta_semanal_nodos` y `cierre_semanal_links` (admin global). Arranca con la semana del 14 al 19/09.",
-  "3.63.0 — Responsable de zona PENDIENTE → FIRME: al despachar por grupo desde el escáner, el responsable de la zona (elegido en el popup, o automático si hay uno solo) queda PENDIENTE de confirmar, y recién queda FIRME cuando ese nodo lo recibe de verdad (lo procesa). Nuevo `nodo_link_confirmacion`: link FIJO sin login para un nodo que no tiene usuarios propios (un 'feeder' que solo deja paquetes en la juntada) — ve sus pendientes y los confirma con un toque. Se lo pasás por WhatsApp a mano.",
-  "3.62.0 — `nodo_renombrar` (solo admin global): cambia la razón social REAL de un nodo (la ve todo el mundo), a diferencia de `nodo_alias_poner` que es un apodo personal. Reusa la validación existente (nombre no vacío, sin repetir otro nodo) y renombra la marca si coincidía con el nombre viejo.",
-  "3.61.0 — `nodo_alias_poner`: le ponés TU propio apodo a un nodo (ej. 'Flex Fácil' = 'Félix', el dueño) para reconocerlo más fácil — es personal, no lo ve otro usuario ni cambia el nombre real. De ahí en más lo podés nombrar por ese apodo en `asignar_nodo_zona` y en los buscadores de la app. Alias vacío lo saca.",
-  "3.60.0 — Responsable de zona POR GRUPO logístico (Bonorino, Portela…): `asignar_nodo_zona` con `grupo` pasa a MODO COMISIÓN — la zona es del grupo, no de un nodo dueño, y solo un admin de ESE grupo (o el admin global) puede asignarla o reasignarla. Nuevo `zona_dejar`: el nodo responsable se saca solo (self-service) de una zona de grupo; si era el único, queda LIBERADA y se avisa a TODO el grupo, pero solo la comisión la puede volver a asignar. Nuevo `zonas_grupo`: lista las zonas de un grupo con quién las cubre y cuáles están liberadas.",
-  "3.59.0 — `cliente_editar` ya NO pisa el cliente: cambia solo los campos que le pasás (antes, cargarle el teléfono le borraba la lista de precios, el DNI y el nombre con el que cobra). Para vaciar un campo, mandalo vacío. Nuevo: `email` cambia el email con el que entra el usuario del cliente. `nombre` dejó de ser obligatorio.",
-  "3.58.0 — `colecta_historial`: cuántos paquetes se colectaron por día y por cliente en una fecha o rango (hasta 62 días), no solo lo de hoy/mañana. Pasale `cliente` (nombre o id) para uno puntual; dice también quién los colectó. Cuenta cada paquete una vez, el día de Argentina en que se colectó (por escaneo o en la puerta). Solo lectura.",
-  "3.57.0 — NOMBRE Y APELLIDO OBLIGATORIOS en todos los usuarios: `chofer_crear`, `operador_crear` y `cliente_generar_usuario` ahora piden `nombre` y `apellido` por separado (en un vendedor, los de la PERSONA que entra, no el de la tienda: con \"Fumshop\" en la lista no se sabía quién era). Nuevo `usuario_editar` para corregir nombre, apellido, teléfono o email de un usuario de tu nodo. Cambiar el nombre de un cadete NO cambia el nombre con el que se le paga: queda fijo para que sus entregas no se muden de grupo en la liquidación.",
-  "3.55.0 — `envio_editar_zona` ahora también COMPLETA destinatario, teléfono y dirección. El envío que entra por el escaneo del QR trae de quién es el paquete pero NO a dónde va: nace sin destino y se liquida en $0 sin que nadie se entere (5.554 así). En un envío ya ENTREGADO los datos del destino solo se completan si están VACÍOS —nunca se pisan— y los que no se tocaron vuelven en `noPisados`. Además el escáner ahora PIDE la zona en el momento, con el paquete en la mano, y muestra cuántos de la colecta siguen sin zona.",
-  "3.54.0 — `retiros_cargar`: la lista de RETIROS del día se carga por acá en vez del Excel Maestro. Le pasás las direcciones (numeradas o no) y el cadete, y crea un retiro por parada con la zona que cobra y paga (Retiro en CABA/GBA). Dos cosas que la planilla hacía mal y ya no: el número de orden iba PEGADO a la dirección y el geocoder terminaba devolviendo un cuartel en Gualeguaychú (~800 envíos con coordenadas en Entre Ríos), y la localidad quedaba en 'Retiro en CABA', que no es un lugar. Escribe el nombre por el que se PAGA, no solo el vínculo. Repetir la misma dirección el mismo día no duplica el retiro ni el cobro.",
-  "3.53.0 — `envio_pago_mensajero`: carga lo que se le paga a quien repartió, por envío. Cierra una brecha que se comía plata en silencio: al cadete se le paga por el NOMBRE (`Envio.mensajero`) y no por el vínculo, así que un envío asignado con `envio_asignar_mensajero` se veía correcto en todas las pantallas y NO entraba en su resumen de pago. Ahora, al cargar el valor, se completa el nombre con el que la persona está cargada (el apodo del resumen, no el nombre completo; en un vendedor con doble rol, el de su cliente). Sin GRUPO no hay tarifa que estampar —el cadete directo del nodo— y este valor manual era el único mecanismo, sin ninguna herramienta que lo escribiera. No paga por su cuenta un envío que no se entregó: los Cancelados/Devueltos vuelven listados salvo que lo pidas.",
-  "3.52.0 — `envio_completar_ciclo`: reconstruye los pasos que le faltan a un envío YA cerrado (Colectado / En centro de distribución / En camino), cada uno a nombre de quien lo hizo y fechado en el día real. El control por foto cerrado en lote marca ENTREGADO y nada más, así que el envío saltaba de 'A retirar' al cierre sin registro de quién lo movió, y `avanzarA` no servía porque solo avanza hacia adelante. Solo agrega lo que falta: no duplica, no cambia el estado actual y no inventa autores (el paso del que no decís quién lo hizo, no se agrega). No mueve dinero.",
-  "3.51.0 — `envio_entregar` ya no revive un envío que había vuelto al vendedor. Corregir una tanda mal fechada es una operación en LOTE, y un paquete en estado de EXCEPCIÓN (Cancelado, Devuelto al vendedor, En espera de reposición) que estuviera en la lista se marcaba ENTREGADO por estar ahí, en vez de que solo se le corrigiera la fecha. Ahora esos vuelven en `errores` con su estado real y no se tocan; y un envío ya cerrado por ML (`Entregado (Flex)`) entra por la corrección de fecha, no por una entrega nueva. Misma regla que la cadena de `avanzarA`.",
-  "3.50.0 — El control por foto ya cierra la tanda EN EL DÍA QUE SE MOVIÓ. `envio_desde_etiqueta_ml` con `fecha` + `avanzarA` estampa cada estado de la cadena con su hora de ESE día (Colectado 9, En centro 12, En camino 15, Entregado 18) en vez de la hora del control, así el timeline se lee en orden y el cumplimiento del día cuenta bien. Y sobre un envío que YA estaba cargado, la `fecha` ahora también se aplica: antes `cargarEnvio` cortaba antes por idempotencia y la planilla atrasada se seguía liquidando en la semana del alta. Si ese período ya está liquidado, rechaza la llamada nombrando la liquidación en vez de dejar el envío a medio corregir.",
-  "3.49.0 — `envio_entregar` acepta `fecha`: el día REAL en que se entregó. El control por foto se cuenta días después ('esto salió por Bonorino el 2', contado el 8) y el historial decía que se había entregado hoy. Sobre un envío que YA figura entregado, corrige la fecha del cierre ya registrado (vuelve en `fechaCorregida`) — así se arregla una tanda cerrada con el día equivocado sin tocar nada más. Toca el evento 'Entregado' del historial; la semana en que se liquida el envío sigue siendo cosa de `envio_editar_fecha`. No mueve dinero.",
-  "3.48.0 — `envio_asignar_grupo` acepta VARIOS envíos en una llamada: separá los códigos por coma o salto de línea. Una planilla despacha decenas por el mismo grupo y de a uno eran decenas de llamadas. Devuelve el resumen (asignados / ya estaban / no encontrados) en vez de cortar en el primero que falla, porque en una planilla es normal que alguno todavía no esté cargado. Un QR de ML crudo es un JSON con comas adentro: ese nunca se parte, va como un solo código.",
-  "3.47.0 — Quién puede repartir se resuelve en UN solo lugar. La 3.46.0 arregló a medias el `mensajero` de `envio_desde_etiqueta_ml`: miraba rol 'mensajero' y el flag `reparte`, pero seguía dejando afuera la TERCERA forma — el VENDEDOR con doble rol (su Cliente tiene `mensajeroNombre`), que es el caso típico del que vende y además reparte. Ahora tanto ese parámetro como `envio_asignar_mensajero` usan `usuariosQueReparten`, la misma fuente que las listas del panel, así que las tres formas valen igual y se puede pasar el id.",
-  "3.46.0 — El `mensajero` de `envio_desde_etiqueta_ml` ya no le atribuye entregas a la persona equivocada. Resolvía SOLO entre usuarios con rol 'mensajero', así que a un VENDEDOR que también reparte no lo encontraba y elegía a otro de nombre parecido; y si no había ninguna coincidencia lo ignoraba EN SILENCIO, dejando el envío sin mensajero con la respuesta en success. Ahora busca entre todos los que pueden repartir (rol mensajero o `reparte`), acepta el ID, falla si no encuentra a nadie, y si el nombre matchea a varios los lista con su id en vez de elegir por vos.",
-  "3.45.0 — Dos herramientas para DESHACER lo que quedó mal. `envio_corregir_estado` pone un envío en un estado puntual con motivo obligatorio (acepta también los terminales 'Cancelado'/'Rechazado por el comprador', que antes solo escribía ML o la devolución: si algo dejaba un envío ahí, no había forma de volverlo atrás). `envio_asignar_mensajero` asigna o QUITA el mensajero por tracking, buscando entre TODOS los que pueden repartir — rol mensajero o `reparte` habilitado — y aceptando el ID: el `mensajero` de `envio_desde_etiqueta_ml` solo mira rol 'mensajero', así que con un VENDEDOR que también reparte elegía a otra persona de nombre parecido y le atribuía entregas ajenas.",
-  "3.44.0 — FIX de la 3.43.0: un envío en estado de EXCEPCIÓN ya no se avanza. `avanzarA` sobre un envío existente buscaba su estado en el ciclo normal, y como 'Cancelado (Flex)' / 'Devuelto al vendedor' / 'En espera de reposición' no están ahí, `indexOf` daba -1 y lo trataba como si recién arrancara: marcaba ENTREGADO un paquete que en realidad había vuelto al vendedor. Ahora solo avanza desde el ciclo normal (A retirar / Colectado / En centro / En camino) y si no, contesta `noAvanzado` con el estado real, sin escribir nada.",
-  "3.43.0 — `avanzarA` ya no se ignora cuando el envío YA existía. La cadena de estados del control por foto vivía dentro de un `if (!yaExistia)`: si el paquete ya había entrado por otro lado (lo cargó el vendedor, o una integración ML/TiendaNube), `envio_desde_etiqueta_ml` contestaba success y lo dejaba donde estaba, sin avisar. Ahora lo avanza SOLO HACIA ADELANTE desde su estado actual (nunca retrocede, y un envío ya entregado no se toca), y devuelve `historial` + `hechoPor` como en un alta nueva para que se vea qué se movió. Sirve para cerrarle el ciclo a una planilla cuyos paquetes ya estaban cargados.",
-  "3.42.0 — Marcar ENTREGADO un envío que YA estaba cargado (`envio_entregar`, por tracking, uno o varios). Faltaba: el `avanzarA:'entregado'` de `envio_desde_etiqueta_ml` solo corre en altas NUEVAS, así que cuando la foto era de un paquete que ya había entrado por otro lado (lo cargó el vendedor, o una integración ML/TiendaNube) el parámetro se ignoraba EN SILENCIO y el envío quedaba 'A retirar' para siempre — no había forma de cerrarle el ciclo desde el MCP. Entrega 'solo con los datos' (sin foto ni firma) y corre la entrega real: sella la logística de entrega para el clearing y le avisa al vendedor. Los ya entregados vuelven en `yaEstaban` sin romper el lote. Staff, scopeado a tu nodo.",
-  "3.41.0 — Corregir el clearing de un envío YA ENTREGADO sin romperle el estado: `envio_asignar_grupo` nunca despachó los envíos en 'Entregado'/'En camino' (solo les setea con qué grupo salieron), pero la descripción decía que los pasaba a 'En camino' y la ruta devolvía un 409 genérico — 'No se pudo asignar el envío' — cuando en realidad el envío YA estaba en ese grupo y no había nada que hacer. Ahora eso responde ok con `yaEstaba`, y al asignar devuelve `estadoIntacto` para dejar claro que el estado no se tocó. Sirve para atribuirle el clearing a una planilla vieja ya entregada.",
-  "3.40.0 — No cobrarle a un vendedor un envío que el nodo no movió: `liquidacion_excluir_envio` lo saca del cobro de una liquidación YA emitida (re-suma y ajusta la cuenta corriente) y `liquidacion_reincluir_envio` lo devuelve. El MOTIVO es obligatorio: queda en el historial del envío y el vendedor lo ve en su portal. Si la liquidación ya está en una factura de ARCA emitida, lo rechaza (haría falta una nota de crédito). Además el motor de liquidación ahora decide con EVIDENCIA operativa (colecta, mensajero, foto, receptor, etiqueta impresa…) en vez de un guardarraíl binario, y deja registrado por qué no se cobró cada envío. Requiere permiso finanzas.",
-  "3.39.0 — Corregir la FECHA de un envío YA cargado (`envio_editar_fecha`): el que se subió atrasado sin `fecha` quedó con el día del alta y se liquidaría en la semana equivocada. Por tracking, mueve el envío de período y arrastra el primer estado del historial (los demás quedan como se registraron). Solo staff y solo tu nodo; no admite fecha futura; y si ese período YA está liquidado lo rechaza con el número de liquidación en vez de descuadrarla en silencio. No mueve dinero.",
-  "3.38.0 — Cargar envíos con FECHA ANTERIOR: `envio_cargar` y `envio_desde_etiqueta_ml` aceptan `fecha` (dd/mm/aaaa o aaaa-mm-dd) para subir una planilla días después de que el paquete se movió, en vez de que todo quede con la fecha del alta. La fecha define en qué SEMANA se liquida el envío: por eso es SOLO staff (un vendedor no puede mover sus paquetes de período) y no se admite una fecha futura. Sin `fecha` se comporta igual que antes (hoy). No mueve dinero.",
-  "3.37.0 — Guía para ponerse a facturar: nuevo flujo `flujo facturacion` (paso a paso completo: emisor por cuenta, trámite en ARCA, clientes, y cómo se emite después). `facturacion_estado` te dice qué falta — emisores incompletos, cuentas sin emisor y, por cliente, qué dato le falta (CUIT, razón social, condición IVA, emisor, habilitación). `facturacion_preparar_cliente` deja un cliente listo en un paso (datos fiscales + cuenta donde cobra + frecuencia + corte en HOY, para no re-facturar lo viejo). El MCP sigue SIN facturar: no emite comprobantes ni entra a ARCA (eso necesita la Clave Fiscal de esa persona). Requiere permiso finanzas.",
-  "3.33.0 — Colecta a vendedores SIN envíos cargados: `colecta_asignar` crea la colecta igual aunque el cliente no tenga nada cargado, y el cadete ESCANEA cada paquete en la puerta — los que no están en el sistema se crean solos a nombre del vendedor y el mismo QR nunca se cuenta dos veces. Si el QR es de Flex, se APRENDE la cuenta de ML (sender_id) del vendedor: sus próximas etiquetas se reconocen solas, sin preguntar de quién son. `colecta_pendientes` devuelve `clientesSinEnvios`.",
-  "3.32.0 — Alerta 'marcar entregado': los envíos que quedan 'En camino' +24h sin cerrarse ahora salen en `envios_trabados` como tipo `en_camino_sin_cerrar` ('revisá y marcá entregado'), y el aviso proactivo (opt-in ALERTAS_TRABADOS=1) le llega a los OPERATIVOS y admins del nodo (antes solo al jefe). Umbral configurable con ALERTA_EN_CAMINO_HORAS.",
-  "3.31.0 — Consulta rápida de barrios: `zona_barrios` responde '¿qué barrios/localidades hay en <zona>?' (ej. 'Matanza Norte', 'CABA') con su tramo por perfil. Busca por nombre entre las zonas visibles a tu nodo (propias, globales o de tus grupos logísticos). Solo lectura.",
-  "3.30.0 — Perfil de zona por SUCURSAL: un cliente con sucursales en zonas distintas ahora cotiza cada envío según la distancia de SU sucursal-origen (antes usaba un único perfil por cliente). `sucursales_cliente` lista las sucursales de un cliente con su perfil; `sucursal_perfil` setea (o limpia) el perfil de una sucursal (config de staff — el vendedor no lo toca). Perfil vacío = la sucursal hereda el del cliente (comportamiento previo, aditivo).",
-  "3.29.0 — Alta de portal para clientes, gaps cerrados: `cliente_resetear_clave` genera una clave temporal nueva para un cliente/vendedor que YA tiene usuario pero perdió el acceso (sin pisar el alta; para el alta nueva sigue `cliente_generar_usuario`). `generar_enlace_vinculacion` ahora resuelve `cliente` por NOMBRE además de id (antes solo aceptaba el id y tiraba 'Cliente inválido'). El enlace de vinculación (ML/TiendaNube/TiendaNegocio) pasó de vencer en 15 minutos a 48hs, para que le llegue vigente al cliente por WhatsApp aunque no lo abra al instante.",
-  "3.28.0 — Admin de grupo: los nodos ORIGINALES de un grupo (los que lo fundan por QR) son sus admins y gestionan quién está adentro. `grupo_miembros` lista los nodos marcando quién es admin; `grupo_sumar_nodo` / `grupo_expulsar_nodo` agregan o sacan nodos; `grupo_admin_permiso` da o saca el permiso de admin a otro nodo (así otros heredan la administración si los originales se van). Nunca se deja un grupo sin admin. Solo un admin del grupo (o admin global). No mueve dinero.",
-  "3.27.0 — Reconciliación de nodos (QR onboarding etapa 3): `provisorio_conciliar` acepta `modo` — 'absorber' (default, el nodo real se queda con el historial) o 'desde_ahora' (no toca el historial; el clearing arranca de acá). En la PWA, al vincular por QR elegís el modo y cargás la tarifa inicial del grupo.",
-  "3.26.0 — Planilla ML Fase 5: AUTO-PRECIO — `envio_desde_etiqueta_ml` devuelve `precioClearing` (lo que clearea el envío por su grupo+zona) cuando lo despachás por grupo. Nuevo `planilla_reporte`: resumen de lo cargado por control por foto (ml_manual) — total + por cliente/zona/estado + suma de valor y cobro.",
-  "3.25.0 — 'Control por foto y carga de planilla vía MCP' (flujo `control_por_foto`): `envio_desde_etiqueta_ml` cierra TODO el ciclo en un paso con `avanzarA:'entregado'` (A retirar→Colectado→Procesado→[grupo=En camino]→Entregado, cada estado con QUIÉN lo hizo). Vía rápida del clearing entre nodos. Nuevo `fotoRuta` = ruta local de la foto (no la imagen) para reencontrarla, sobre todo con dígitos '*'. Devuelve `historial` + `hechoPor`.",
-  "3.24.0 — Planilla por CARPETA de fotos (una habilidad): `envio_desde_etiqueta_ml` cierra el circuito en un paso con `avanzarA` ('colectado'/'procesado'), `autoRutear` (al nodo/mensajero responsable de la zona; configurás con `asignar_nodo_zona`/`asignar_mensajero_zona`) y `grupo`. Convención de dígitos ilegibles con '*' (ej. 'Aguirre 31**'), sin inventar. Flujo `alta_planilla_ml` reescrito.",
-  "3.23.0 — Flujo de comunicación: `envio_estado` responde '¿cuándo llega?' con narrativa + ETA (mensajero asignado, cuántos envíos en la ruta, posición del envío, estimado por posición×min/parada) y marca problemas (nunca despachado, sin mensajero, mensajero detenido). `envios_trabados` lista los envíos trabados del nodo por severidad. Aviso PROACTIVO al jefe de nodo por push opt-in (ALERTAS_TRABADOS=1, desactivado por defecto). Todo read-only.",
-  "3.22.0 — Planilla ML: `provisorio_conciliar` fusiona un NODO PROVISORIO con el nodo real cuando este ya está dado de alta — reatribuye sus envíos y su membresía de grupo al nodo real y lo marca resuelto (el clearing pasa a usar la tarifa del nodo real). Como operador solo conciliás los provisorios que creó tu nodo, contra un nodo que ya opera en el grupo; el admin global además puede definirle la tarifa. No mueve dinero.",
-  "3.21.0 — Paridad con el escáner: `envio_asignar_grupo` asigna/rutea un envío (por tracking) a un GRUPO logístico tuyo (por nombre o id, ej. 'Portela'/'Bonorino'), define con qué grupo salió (tarifa del clearing) y lo despacha ('En camino', sale del centro). Solo tus grupos / envíos de tu nodo. No mueve dinero. (Sugerencia #23.)",
-  "3.20.0 — Constructor de flujos: `flujo_registrar` captura cuándo el asistente tuvo que INDAGAR (varias preguntas) hasta entender qué quería el usuario → sirve para armar un FLUJO DIRECTO. Se auto-usa (instrucción al conectar). Cualquier rol.",
-  "3.19.0 — Fix de registro: `envio_procesar` (v3.16.0) ahora queda dentro del gate staff/mensajero en el conector remoto. NOTA: si un tool nuevo 'no aparece', abrí una SESIÓN nueva del MCP (el índice de herramientas se fija al iniciar; reconectar el conector no siempre alcanza).",
-  "3.18.0 — Ahora CUALQUIER usuario puede ver SUS propias sugerencias y en qué estado están (`mis_sugerencias`): Recibida / En evaluación / ✅ Implementada / Descartada. Cada uno ve solo lo suyo.",
-  "3.17.0 — Planilla ML Fase 3: crear un NODO PROVISORIO en un grupo al vuelo (`nodo_provisorio_crear`), para atribuir el clearing cuando te bajan paquetes de un nodo que todavía no está dado de alta. Solo en grupos de TU nodo (el admin global en cualquiera); no tiene login hasta conciliarlo con el nodo real. Reusa el clearing por grupo. No mueve dinero.",
-  "3.16.0 — Procesar/recibir un envío en el centro desde el MCP (`envio_procesar` por tracking), sin escanear ni entrar al panel web — igual que la acción 'procesar' del escáner (queda 'En centro de distribución'). Scopeado a tu nodo/grupo. (La consulta de liquidaciones por cliente/monto + detalle ya estaba desde 3.8.0.)",
-  "3.15.0 — Planilla ML manual (no vinculado): `envio_desde_etiqueta_ml` con `reusarEtiqueta:true` REUSA el mismo tracking/QR/etiqueta de ML que ya viene impreso (NO genera uno nuevo), marca el envío como 'ml_manual' y es idempotente (no duplica). Nuevo flujo `flujo alta_planilla_ml`. Además `alta_cliente` ahora guía también el PERFIL DE ZONA y la COLECTA (dirección con timbre + geoposición), y los flujos se AUTO-DISPARAN (el asistente consulta `flujo` cuando querés hacer algo). No mueve dinero.",
-  "3.14.0 — El admin global ya puede OPERAR (no solo consultar) sobre cualquier nodo: los tools de escritura scopeados por nodo aceptan un parámetro opcional `nodo` para elegir sobre qué nodo actuar (chofer_crear, cliente_crear/editar, cliente_generar_usuario, producto_crear, precio_actualizar, colecta_configurar/asignar/desasignar, procesar_zona, rechazar_zona, asignar_mensajero_zona; asignar_nodo_zona usa `logisticaId`). El operador de nodo lo ignora (siempre opera en SU nodo — aislamiento intacto). Antes chofer_crear fallaba con 'Elegí un nodo' para el admin global. De paso se cerró un IDOR: desasignar una colecta ahora valida que sea de tu nodo.",
-  "3.13.0 — Flujo guiado (Fase A): nuevo tool `flujo` que devuelve el PASO A PASO de un objetivo (alta_cliente, alta_operador, alta_chofer) para no dejar nada incompleto. Además `cliente_crear`, si no le pasás la lista de precios, te recuerda preguntar «¿qué le cobrás?» (Oficial de Flex o una propia con nombre reusable) y cómo asignarla. Todo en español, para operar sin saber nada.",
-  "3.12.0 — Alta de OPERADOR de nodo (`operador_crear`): crea el login de un operador (staff que administra el nodo) con email + CLAVE TEMPORAL y los permisos que le des (default 'logistica'). El operador de nodo lo crea en SU nodo; el admin global elige el nodo con `nodo`. Requiere permiso 'usuarios'. No otorga admin de nodo (eso es `usuario_habilitar_rol`) ni toca dinero.",
-  "3.11.1 — Fix `envio_desde_etiqueta_ml` / `envio_cargar`: (a) el id de ML leído de una foto con espacios OCR (\"4789055 7180\") ahora se limpia y se guarda como NÚMERO (así lo matchea el escáner); (b) los campos numérico-ambiguos (cp, teléfono, mlShipmentId, montoCobro) aceptan número o texto, así una llamada con `cp: 2804` ya no revienta en la validación con un error genérico sin detalle.",
-  "3.11.0 — Superadmin desde el MCP: habilitar operador/superoperador/admin de nodo (`usuario_habilitar_rol`), crear grupos logísticos (`grupo_crear`) y subir el logo/marca de un nodo (`logo_subir`, imagen en base64). Además `mis_datos` ahora muestra el nodo por su NOMBRE. Solo admin global. No toca dinero.",
-  "3.10.0 — Login para un vendedor: `cliente_generar_usuario` le crea las credenciales de acceso a un cliente/vendedor YA existente de tu nodo y devuelve una CLAVE TEMPORAL. Requiere permiso 'usuarios', scopeado a tu nodo. No toca dinero.",
-  "3.9.0 — Corregir el destino de un envío puntual (`envio_editar_zona`): arregla la localidad/zona/partido de UN envío (por tracking) cargado con el destino mal (ej. dos localidades pisadas en la etiqueta) para que vuelva a ser cobrable/ruteable, SIN reasignarlo de cliente y sin crear un alias global. Staff: su nodo; admin global: cualquiera. No mueve dinero.",
-  "3.8.0 — Consulta de liquidaciones: buscar por cliente/monto (`liquidacion_buscar`), ver el detalle de envíos de una liquidación (`liquidacion_detalle`) y listar las que están sin recibir/impagas (`liquidaciones_sin_recibir`). Solo lectura, scopeadas por nodo (admin de nodo: sus clientes; admin global: cualquier nodo con `nodo`). No mueve dinero.",
-  "3.7.0 — Atribución de marketing (Fase 1): ver/guardar los píxeles de marketing (Meta Pixel, GA4, GTM y tokens de la Conversions API) del nodo o del vendedor con `marketing_config_ver` / `marketing_config_guardar`. El backend resuelve el alcance por rol (vendedor: lo suyo; operador: su nodo). No mueve dinero.",
-  "3.6.1 — Guía (`guia`) con intro motivador que engancha a hacer el tutorial (qué podés automatizar en 5 min).",
-  "3.6.0 — Guía de arranque por rol (`guia` + instrucciones al conectar): metodología para empezar rápido (mensajero: foto→envío al colectar; vendedor: cargar ventas; nodo: implementar + operar + clearing). Los MENSAJEROS ya pueden registrar envíos de lo que colectan (`envio_cargar` / `envio_desde_etiqueta_ml`), scopeado a clientes de su nodo o que hayan colectado (marketplace incluido).",
-  "3.5.0 — Ayuda integrada (`ayuda`): documentación por herramienta (qué hace, cómo usar, ejemplo, qué NO hace) + temas transversales (facturacion_marketplace, dinero, aislamiento). Aclarado que adjudicar una ruta del marketplace NO genera facturación/rendición/comisión automática (el pago entre nodos es manual).",
-  "3.4.0 — Marketplace de rutas públicas (ruta_publicar/ofertar/adjudicar); admin también reparte; registrar envío desde foto de etiqueta ML; alta/edición de choferes; mcp_version.",
-  "3.3.0 — Afiliados y comisión por envío; métricas por tipo; gestión de colectas (asignar/rechazar entre nodos); cuentas vinculadas; sucursales; colecta a pedido; metazonas flexibles.",
-];
-const INSTRUCCIONES = "MCP de Nexus Flex. Si te preguntan la versión, consultá `mcp_version` (este texto puede ser anterior a una actualización). Para arrancar: `guia` (cómo trabajar según tu rol) y `ayuda` (índice de herramientas). El MCP NUNCA mueve dinero.\n\nCuando el usuario quiera completar un alta o una carga que tiene flujo guiado (ver `flujo`), traé el paso a paso y completalo entero antes de darlo por terminado: los pasos siguientes (lista de precios, perfil de zona, colecta) son los que se olvidan y dejan el alta a medias.";
-const server = new McpServer({ name: "nexusflex", version: MCP_VERSION }, { instructions: INSTRUCCIONES });
-
-/** Formatea un ApiResult como respuesta de tool MCP, con mensajes claros y SIN
- *  filtrar tokens ni stack traces. */
-function toResult(r) {
-  if (r.ok) return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
-  const base =
-    r.status === 401 ? "Sesión inválida o vencida (autorizá de nuevo con `npx nexusflex-mcp login`)." :
-    r.status === 403 ? "Tu usuario no tiene permiso para esta operación (aislamiento del backend)." :
-    r.status === 404 ? "No encontrado." :
-    `Error ${r.status}.`;
-  const d = r.data;
-  const detalle = d?.error ? ` ${d.error}` : d?.message ? ` ${d.message}` : "";
-  return { content: [{ type: "text", text: `${base}${detalle}` }], isError: true };
-}
-
-async function run(fn) {
-  try {
-    return toResult(await fn());
-  } catch (e) {
-    return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }], isError: true };
-  }
-}
-
-// Un modelo con visión suele mandar campos "de texto" como NÚMERO en el JSON
-// (ej. cp: 2804, mlShipmentId: 47890557180). Con z.string() eso reventaba en la
-// validación del SDK ANTES del handler → el cliente sólo veía "MCP tool call
-// failed" sin detalle. Estos helpers aceptan string|number y normalizan, así el
-// tool corre y, si algo falla, devuelve un mensaje útil del backend.
-const zStr = () => z.union([z.string(), z.number()]).transform((x) => String(x)).optional();
-const zNum = () => z.union([z.number(), z.string()]).optional();
-
-// Override de nodo: SOLO lo usa el admin global para elegir sobre qué nodo opera. El
-// operador de nodo lo ignora (el backend lo fuerza a SU nodo con nodoDe → sin escalada
-// cross-nodo). Se manda al backend como `logisticaId`. Ver sugerencia MCP #20.
-const NODO_OVERRIDE_DESC = "Solo admin global: nodo (id) sobre el que operás. El operador de nodo lo ignora (siempre opera en el suyo).";
-const zNodo = () => z.number().int().positive().optional().describe(NODO_OVERRIDE_DESC);
-
-const q = (params) => {
-  const s = Object.entries(params).filter(([, v]) => v != null && v !== "").map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join("&");
-  return s ? `?${s}` : "";
-};
-const registrados = new Set(); // para que `ayuda` liste solo lo que este usuario tiene
-const tool = (name, def, handler) => { registrados.add(name); server.registerTool(name, def, handler); };
-
-// ============================================================================
-//  CONTROL POR FOTO (staff). El servidor hace el trabajo foto por foto
-//  (/control-foto/foto); acá, en la PC, se recorre la CARPETA del día — cosa que el
-//  conector remoto no puede (no ve tu disco). Ver `flujo control_por_foto`.
-// ============================================================================
-const EXT_FOTO = /\.(jpe?g|png|webp)$/i;
-/** Día de la carpeta: "Lunes 14-9", "14-09-2026", "2026-09-14"… → "aaaa-mm-dd" (o null). */
-function diaDeCarpeta(nombre, anioDefault = new Date().getFullYear()) {
-  const iso = nombre.match(/(20\d{2})-(\d{1,2})-(\d{1,2})/);
-  if (iso) return `${iso[1]}-${iso[2].padStart(2, "0")}-${iso[3].padStart(2, "0")}`;
-  const m = nombre.match(/(\d{1,2})[-./](\d{1,2})(?:[-./](\d{2,4}))?/);
-  if (!m) return null;
-  const anio = m[3] ? (m[3].length === 2 ? `20${m[3]}` : m[3]) : String(anioDefault);
-  return `${anio}-${m[2].padStart(2, "0")}-${m[1].padStart(2, "0")}`;
-}
-/** Fotos de un día: [{ archivo, carpeta (relativa al día, sin el archivo) }]. Saltea carpetas "_…". */
-async function fotosDelDia(diaDir) {
-  const fs = await import("node:fs");
-  const path = await import("node:path");
-  const out = [];
-  const zips = [];
-  const recorrer = (dir) => {
-    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
-      if (e.name.startsWith("_")) continue;
-      const p = path.join(dir, e.name);
-      if (e.isDirectory()) recorrer(p);
-      else if (EXT_FOTO.test(e.name)) out.push({ archivo: p, carpeta: path.relative(diaDir, dir).split(path.sep).join("/") });
-      else if (/\.zip$/i.test(e.name)) zips.push(path.relative(diaDir, p));
-    }
-  };
-  recorrer(diaDir);
-  return { fotos: out.filter((f) => /^(dados|recibidos)\b/i.test(f.carpeta)), sueltas: out.filter((f) => !/^(dados|recibidos)\b/i.test(f.carpeta)).length, zips };
-}
-
-const DIAS_SEMANA = ["Domingo", "Lunes", "Martes", "Miercoles", "Jueves", "Viernes", "Sabado"];
-/** "2026-09-14" → "Lunes 14-9-2026" (la convención de las carpetas del control, con el año). */
-function nombreCarpetaDia(iso) {
-  const [a, m, d] = iso.split("-").map(Number);
-  return `${DIAS_SEMANA[new Date(Date.UTC(a, m - 1, d)).getUTCDay()]} ${d}-${m}-${a}`;
-}
-/** Un nombre de grupo/cadete como nombre de carpeta válido en Windows (sin "(operador)", sin / \ : * ? " < > |). */
-const nombreCarpeta = (s) => String(s).replace(/\s*\([^)]*\)\s*$/, "").replace(/[\\/:*?"<>|]+/g, "-").replace(/\s+/g, " ").trim();
-/** Fechas pedidas: "14/09/2026", "2026-09-14", rangos "14/09/2026 a 19/09/2026" o listas separadas por coma. */
-function fechasPedidas(texto, anioDefault) {
-  const una = (t) => {
-    const s = String(t).trim();
-    const iso = s.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/);
-    if (iso) return `${iso[1]}-${iso[2].padStart(2, "0")}-${iso[3].padStart(2, "0")}`;
-    const m = s.match(/^(\d{1,2})[-/.](\d{1,2})(?:[-/.](\d{2,4}))?$/);
-    if (!m) return null;
-    const a = m[3] ? (m[3].length === 2 ? `20${m[3]}` : m[3]) : String(anioDefault);
-    return `${a}-${m[2].padStart(2, "0")}-${m[1].padStart(2, "0")}`;
-  };
-  const out = [];
-  for (const parte of String(texto).split(",")) {
-    const [desde, hasta] = parte.split(/\s+(?:a|al|hasta)\s+/i).map(una);
-    if (!desde) return null;
-    if (!hasta) { out.push(desde); continue; }
-    for (let t = Date.parse(`${desde}T00:00:00Z`); t <= Date.parse(`${hasta}T00:00:00Z`) && out.length < 62; t += 864e5) out.push(new Date(t).toISOString().slice(0, 10));
-  }
-  return out;
-}
-
-function registrarControlFoto() {
-  tool("control_foto_preparar", {
-    title: "Control por foto: crear las carpetas del día (o de varios días)",
-    description: "Arma en la PC las carpetas para el control por foto de uno o varios días, con los nombres EXACTOS de tus grupos y cadetes: <día>/DADOS/<cada grupo>, <día>/DADOS/<cada cadete>, <día>/RECIBIDOS/<cada cadete>, <día>/RECIBIDOS/<cada grupo> (lo que derivaste por ese grupo) + un LEEME.txt que explica qué foto va en cada una. Usalo cuando el usuario dice 'hagamos el control por foto del día tal': creás las carpetas, le decís dónde quedaron y que suelte ahí las fotos; después, `control_foto_carpeta`. No pisa nada que ya exista. No mueve dinero.",
-    inputSchema: {
-      ruta: zStr().describe("Carpeta donde crear los días (ej. 'C:\\\\Users\\\\...\\\\Desktop\\\\Control por fotos'); se crea si no existe"),
-      fechas: zStr().describe("Día o días: '14/09/2026', '14/09 a 19/09', '14/09, 16/09' (sin año = el actual)"),
-      nodo: zNodo(),
-    },
-  }, async (a) => run(async () => {
-    const fs = await import("node:fs");
-    const path = await import("node:path");
-    const raiz = String(a.ruta ?? "").trim();
-    if (!raiz) return { ok: false, status: 400, data: { message: "Decime en qué carpeta de tu PC armo los días (ej. el Escritorio)." } };
-    const fechas = fechasPedidas(a.fechas ?? "", new Date().getFullYear());
-    if (!fechas?.length) return { ok: false, status: 400, data: { message: `No entiendo las fechas "${a.fechas ?? ""}". Usá '14/09/2026' o '14/09 a 19/09'.` } };
-    const est = await api("GET", `/control-foto/estructura${q({ nodo: a.nodo })}`);
-    if (!est.ok) return est;
-    const grupos = (est.data.grupos ?? []).map((g) => nombreCarpeta(g.nombre));
-    const cadetes = (est.data.cadetes ?? []).map((c) => nombreCarpeta(c.nombre));
-    const leeme = [
-      "CONTROL POR FOTO — qué foto va en cada carpeta",
-      "",
-      "DADOS/<grupo>     → los paquetes que le pasaste a ese grupo (juntada, colecta del grupo…).",
-      "DADOS/<cadete>    → los que salieron a repartir con ese cadete tuyo.",
-      "RECIBIDOS/<cadete> → los que te dieron otros nodos y repartió ese cadete.",
-      "RECIBIDOS/<grupo> → los que te dieron y mandaste por ese grupo a otro nodo (ej. Zárate Campana).",
-      "",
-      "Una foto por paquete, que se lea la etiqueta. Si un paquete llegó por un grupo en particular,",
-      "podés poner la carpeta del cadete adentro: RECIBIDOS/<grupo>/<cadete>.",
-      "Las carpetas que no uses quedan vacías: no pasa nada. No renombres las carpetas.",
-      "Cuando termines de soltar las fotos, pedile a Claude: \"hacé el control por foto de esta carpeta\".",
-    ].join("\r\n");
-    const creadas = [];
-    for (const f of fechas) {
-      const dia = path.join(raiz, nombreCarpetaDia(f));
-      const subs = [...grupos.map((g) => ["DADOS", g]), ...cadetes.map((c) => ["DADOS", c]), ...cadetes.map((c) => ["RECIBIDOS", c]), ...grupos.map((g) => ["RECIBIDOS", g])];
-      for (const s of subs) fs.mkdirSync(path.join(dia, ...s), { recursive: true });
-      const lm = path.join(dia, "LEEME.txt");
-      if (!fs.existsSync(lm)) fs.writeFileSync(lm, leeme);
-      creadas.push(dia);
-    }
-    return { ok: true, status: 200, data: { creadas, grupos, cadetes, siguiente: "Soltá las fotos en cada carpeta y después corré control_foto_carpeta sobre la carpeta del día (o sobre la de todos los días)." } };
-  }));
-
-  tool("control_foto_estructura", {
-    title: "Control por foto: cómo armar las carpetas (tus grupos y cadetes)",
-    description: "Devuelve cómo tienen que llamarse las carpetas del control por foto para TU nodo: tus grupos logísticos y quiénes reparten. Llamalo antes de `control_foto_carpeta` para explicarle al usuario la estructura o para entender por qué una carpeta no se reconoce. Solo lectura.",
-    inputSchema: { nodo: zNodo() },
-  }, async ({ nodo }) => run(() => api("GET", `/control-foto/estructura${q({ nodo })}`)));
-
-  tool("control_foto_foto", {
-    title: "Control por foto: procesar UNA foto de etiqueta",
-    description: "Procesa una sola foto (por su RUTA en la PC): lee el QR (o la IA de etiquetas), busca o da de alta el envío (sin duplicar), lo asigna según la CARPETA (DADOS/<grupo>, DADOS/<cadete>, RECIBIDOS/…/<cadete>, RECIBIDOS/<grupo>), lo lleva a Entregado en el `fecha` real y le cuelga la foto. Usalo para CONTESTAR una pregunta de `control_foto_carpeta`: repetí esa foto con `nodoEntrega` (quién la llevó) o `cliente` (de quién es la cuenta de ML). `simular:true` = solo mirar. No mueve dinero.",
-    inputSchema: {
-      ruta: zStr().describe("Ruta de la foto en la PC"),
-      carpeta: zStr().describe("Carpeta relativa al día, ej. 'DADOS/Bonorino' o 'RECIBIDOS/Matanza/Gerardo'"),
-      fecha: zStr().describe("Día real (dd/mm/aaaa o aaaa-mm-dd)"),
-      simular: z.boolean().optional(),
-      nodoEntrega: zStr().describe("Respuesta: nodo (nombre o id) que lo llevó, cuando la zona tiene varios responsables"),
-      cliente: zStr().describe("Respuesta: id del cliente dueño de una cuenta de ML desconocida"),
-      nodo: zNodo(),
-    },
-  }, async (a) => run(async () => {
-    const fs = await import("node:fs");
-    const path = await import("node:path");
-    if (!a.ruta || !fs.existsSync(a.ruta)) return { ok: false, status: 400, data: { message: `No encuentro la foto ${a.ruta ?? ""}.` } };
-    return api("POST", "/control-foto/foto", { imagen: fs.readFileSync(a.ruta).toString("base64"), carpeta: a.carpeta, fecha: a.fecha, simular: a.simular === true, nodoEntrega: a.nodoEntrega, cliente: a.cliente, nombreArchivo: path.basename(a.ruta), nodo: a.nodo });
-  }));
-
-  tool("control_foto_carpeta", {
-    title: "Control por foto: procesar la carpeta de un día (o de varios)",
-    description: "Recorre la carpeta de UN DÍA (o una carpeta con varios días adentro) en la PC: cada foto bajo DADOS/… o RECIBIDOS/… se manda al servidor con su carpeta y el día (sale del nombre de la carpeta: 'Lunes 14-9', '2026-09-14'…). Por defecto SIMULA (no escribe): devuelve qué haría, cuántos paquetes, y las PREGUNTAS (cuentas de ML que no conoce, zonas con varios responsables, posibles duplicados, carpetas que no reconoce). Mostrale el resumen al usuario, resolvé las preguntas y recién ahí corré con `aplicar:true`. Al aplicar, lo que siga dudoso se SUBE a la app (Logística → 📷 Control por foto) para resolverlo mirando la foto. Es reanudable: una foto ya procesada no se repite. Las fotos dudosas se copian a `_sin_identificar` dentro de cada día y deja el detalle en `_control-foto-<día>.json`. No mueve dinero.",
-    inputSchema: {
-      ruta: zStr().describe("Carpeta del día (ej. 'C:\\\\Users\\\\...\\\\Control por fotos\\\\Lunes 14-9') o la carpeta que contiene varios días"),
-      aplicar: z.boolean().optional().describe("true = escribe. Sin esto, solo simula."),
-      anio: zNum().describe("Año, si el nombre de la carpeta no lo trae (default: el actual)"),
-      nodo: zNodo(),
-    },
-  }, async (a) => run(async () => {
-    const fs = await import("node:fs");
-    const path = await import("node:path");
-    const raiz = String(a.ruta ?? "");
-    if (!raiz || !fs.existsSync(raiz)) return { ok: false, status: 400, data: { message: `No encuentro la carpeta ${raiz}.` } };
-    if (a.aplicar === true && !ALLOW_WRITE) return { ok: false, status: 403, data: { message: "Escritura deshabilitada en este MCP (NEXUSFLEX_MCP_ALLOW_WRITE)." } };
-    const esDia = (d) => fs.readdirSync(d, { withFileTypes: true }).some((e) => e.isDirectory() && /^(dados|recibidos)$/i.test(e.name));
-    const dias = esDia(raiz) ? [raiz] : fs.readdirSync(raiz, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith("_") && esDia(path.join(raiz, e.name))).map((e) => path.join(raiz, e.name));
-    if (!dias.length) return { ok: false, status: 400, data: { message: "No encontré carpetas DADOS/RECIBIDOS (¿están comprimidas en .zip? descomprimilas primero). Ver `control_foto_estructura`." } };
-    const resumen = { modo: a.aplicar === true ? "APLICADO" : "SIMULACIÓN (no se escribió nada)", dias: [] };
-    for (const dir of dias) {
-      const fecha = diaDeCarpeta(path.basename(dir), Number(a.anio) || undefined);
-      if (!fecha) { resumen.dias.push({ dia: path.basename(dir), error: "El nombre de la carpeta no tiene la fecha (ej. 'Lunes 14-9')." }); continue; }
-      const { fotos, sueltas, zips } = await fotosDelDia(dir);
-      const res = [];
-      let i = 0;
-      const trabajador = async () => {
-        while (i < fotos.length) {
-          const f = fotos[i++];
-          const r = await api("POST", "/control-foto/foto", { imagen: fs.readFileSync(f.archivo).toString("base64"), carpeta: f.carpeta, fecha, simular: a.aplicar !== true, nombreArchivo: path.basename(f.archivo), nodo: a.nodo }).catch((e) => ({ ok: false, data: { message: String(e) } }));
-          res.push({ archivo: path.relative(dir, f.archivo), carpeta: f.carpeta, ...(r.ok ? r.data : { estado: "error", error: r.data?.message ?? `HTTP ${r.status}` }) });
-        }
-      };
-      await Promise.all([trabajador(), trabajador(), trabajador()]);
-      fs.writeFileSync(path.join(dir, `_control-foto-${fecha}.json`), JSON.stringify(res, null, 1));
-      // Lo dudoso a mano: copia en _sin_identificar (el original queda donde estaba).
-      const dudosas = res.filter((r) => r.estado === "pregunta" || r.estado === "error");
-      if (dudosas.length) {
-        const destino = path.join(dir, "_sin_identificar");
-        fs.mkdirSync(destino, { recursive: true });
-        for (const d of dudosas) {
-          const motivo = (d.pregunta?.tipo ?? "error") + (d.pregunta?.datos?.cuentaML ? ` ML ${d.pregunta.datos.cuentaML}` : "");
-          try { fs.copyFileSync(path.join(dir, d.archivo), path.join(destino, `${motivo} - ${d.carpeta.replace(/\//g, " ")} - ${path.basename(d.archivo)}`)); } catch { /* no rompe el lote */ }
-        }
-      }
-      const cuenta = (k) => res.filter((r) => r.estado === k).length;
-      const porCuenta = {};
-      for (const r of res) if (r.pregunta?.tipo === "cuenta_ml") {
-        const c = r.pregunta.datos?.cuentaML;
-        (porCuenta[c] ??= { cuentaML: c, vendedor: r.pregunta.datos?.vendedor ?? null, marcas: new Set(), fotos: 0, ejemplo: r.archivo, carpeta: r.carpeta });
-        porCuenta[c].fotos++;
-        if (r.pregunta.datos?.marcaManual) porCuenta[c].marcas.add(r.pregunta.datos.marcaManual);
-      }
-      const otras = res.filter((r) => r.estado === "pregunta" && r.pregunta?.tipo !== "cuenta_ml").map((r) => ({ archivo: r.archivo, carpeta: r.carpeta, tipo: r.pregunta.tipo, texto: r.pregunta.texto, opciones: r.pregunta.opciones?.map((o) => o.nombre) }));
-      const errores = [...new Set(res.filter((r) => r.estado === "error").map((r) => `${r.carpeta}: ${r.error}`))];
-      resumen.dias.push({
-        dia: path.basename(dir), fecha, fotos: fotos.length,
-        ok: cuenta("ok"), sinCambios: cuenta("sin_cambios"), yaProcesadas: cuenta("ya_procesada"), altas: res.filter((r) => r.alta).length,
-        preguntas: cuenta("pregunta"), errores: cuenta("error"),
-        ...(sueltas ? { fuera_de_DADOS_RECIBIDOS: sueltas } : {}), ...(zips.length ? { zipsSinDescomprimir: zips } : {}),
-        cuentasMLDesconocidas: Object.values(porCuenta).map((c) => ({ ...c, marcas: [...c.marcas] })),
-        otrasPreguntas: otras.slice(0, 40), ...(otras.length > 40 ? { masPreguntas: otras.length - 40 } : {}),
-        erroresDeCarpeta: errores,
-        ...(a.aplicar === true && cuenta("pregunta") + cuenta("error") ? { resolverEnLaApp: `Las ${cuenta("pregunta") + cuenta("error")} foto(s) dudosas quedaron subidas en la app: menú Logística → 📷 Control por foto. Ahí se ven grandes y se elige el cliente, el nodo o el cadete.` } : {}),
-        detalle: path.join(dir, `_control-foto-${fecha}.json`),
-      });
-    }
-    return { ok: true, status: 200, data: resumen };
-  }));
-}
-
-// ============================================================================
-//  CAPA 2 — Identidad: leemos /auth/me ANTES de registrar tools. Cada usuario ve
-//  SOLO los tools de su rol. Si falla el login, se registra solo `mis_datos`.
-// ============================================================================
-let me = null;
-try {
-  const r = await api("GET", "/auth/me");
-  if (r.ok) me = r.data?.usuario ?? null;
-  else log(`/auth/me devolvió ${r.status} — revisá el token/credenciales.`);
-} catch (e) {
-  log("No se pudo contactar /auth/me:", e instanceof Error ? e.message : String(e));
-}
-
-const rol = me?.rol ?? "";
-const permisos = Array.isArray(me?.permisos) ? me.permisos : [];
-const esGlobal = rol === "admin" || me?.esSuperoperador === true;
-const esAdminNodo = me?.esAdminNodo === true;
-const isCliente = rol === "cliente";
-const isStaff = rol === "operador" || rol === "admin";
-const wmsActivo = me?.wmsActivo === true;
-// Espejo de requirePermiso del backend (solo para DECIDIR qué mostrar; el backend manda).
-const puede = (p) => esGlobal || (isStaff && (esAdminNodo || permisos.length === 0 || permisos.includes(p)));
-
-// ============================================================================
-//  SIEMPRE
-// ============================================================================
-tool("mis_datos", {
-  title: "Mis datos / alcance",
-  description: "Devuelve tu usuario, rol y nodo/cliente al que está atado este MCP. Usalo para confirmar tu alcance antes de operar. Reportá el nodo por su NOMBRE (campo `logisticaNombre`, ej. 'estás en FastCorreo'), nunca solo por el número.",
-  inputSchema: {},
-}, async () => run(() => api("GET", "/auth/me")));
-
-// Versión del MCP corriendo (cualquier rol). Sirve para saber si tenés lo último.
-tool("mcp_version", {
-  title: "Versión del MCP",
-  description: "Qué versión del MCP de Nexus Flex está corriendo y por qué vía. Cualquier rol lo puede consultar.",
-  inputSchema: {},
-}, async () => ({ content: [{ type: "text", text: JSON.stringify({ version: MCP_VERSION, modo: "npx (Claude Desktop)", novedades: NOVEDADES, nota: "Para tener lo último: actualizá con «npx -y nexusflex-mcp@latest» o pasate al conector remoto (siempre al día, sin instalar/actualizar)." }) }] }));
-
-// Guía de arranque por rol (metodología). Cualquier rol; read-only.
-tool("guia", {
-  title: "Guía de arranque (metodología para tu rol)",
-  description: "Cómo empezar a usar Nexus Flex rápido según tu rol: mensajero (registrar lo que colectás sacando fotos → envío), vendedor (cargar ventas), nodo (implementar + operar + clearing). Sin argumentos = tu rol; `rol` para ver otra (mensajero|cliente|nodo).",
-  inputSchema: { rol: z.string().optional().describe("mensajero | cliente | nodo (default: tu rol)") },
-}, async ({ rol: r }) => {
-  const pedido = String(r ?? "").trim().toLowerCase();
-  const target = pedido === "nodo" ? "operador" : pedido || rol;
-  return { content: [{ type: "text", text: guiaOnboarding(target) }] };
-});
-
-// Flujo guiado: paso a paso de un objetivo para no dejar nada incompleto (Fase A).
-tool("flujo", {
-  title: "Flujo guiado paso a paso",
-  description: "Te devuelve el PASO A PASO para completar bien un objetivo, sin dejar nada a medias (ej. dar de alta un cliente con su lista de precios, o el CONTROL POR FOTO de una carpeta de etiquetas ML). Sin argumento lista los flujos disponibles; pasá `objetivo` (una de las claves de abajo). Usalo para GUIAR al usuario que no sabe qué datos faltan.",
-  inputSchema: { objetivo: z.string().optional().describe(`Vacío = lista los flujos disponibles. Claves: ${Object.keys(FLUJOS).join(", ")}.`) },
-}, async ({ objetivo }) => ({ content: [{ type: "text", text: renderFlujo(objetivo) }] }));
-
-// Sugerencias: cualquier usuario (todos los roles) puede proponer funciones/mejoras.
-tool("sugerencia_crear", {
-  title: "Enviar una sugerencia",
-  description: "Proponé una función nueva, mejora o reportá un bug. mensaje obligatorio; categoria opcional (funcionalidad|mejora|bug|otro). Se registra tu usuario/rol/nodo automáticamente.",
-  inputSchema: { mensaje: z.string().min(1), categoria: z.enum(["funcionalidad", "mejora", "bug", "otro"]).optional() },
-}, async (args) => run(() => api("POST", "/feedback/sugerencias", args)));
-tool("mis_sugerencias", {
-  title: "Mis sugerencias y su estado",
-  description: "Lista TUS propias sugerencias/pedidos de mejora y en qué estado están (Recibida / En evaluación / ✅ Implementada / Descartada). Cada usuario ve SOLO las suyas. Sin argumentos.",
-  inputSchema: {},
-}, async () => run(() => api("GET", "/feedback/mis-sugerencias")));
-tool("flujo_registrar", {
-  title: "Registrar un flujo aprendido (indagación)",
-  description: "Usalo cuando, tras varias preguntas de aclaración, se entendió lo que el usuario quería: registra el objetivo y los pasos para convertirlo en un flujo directo. Avisale al usuario que lo registrás. Registrás `objetivo` (lo que terminó queriendo) y `pasos` (las preguntas/decisiones que lo aclararon + herramientas usadas). No mueve dinero.",
-  inputSchema: { objetivo: z.string().min(1), pasos: z.string().min(1) },
-}, async ({ objetivo, pasos }) => run(() => api("POST", "/feedback/sugerencias", { categoria: "mejora", mensaje: `[FLUJO APRENDIDO] Objetivo: ${objetivo}\nPasos que lo aclararon: ${pasos}` })));
-
-// ============================================================================
-//  ROL CLIENTE (vendedor) — SOLO lo suyo. El backend lo fuerza a su idCliente.
-// ============================================================================
-if (isCliente) {
-  tool("mis_envios", {
-    title: "Mis envíos",
-    description: "Tus envíos/paquetes (solo los tuyos), los 300 más recientes, cada uno con su `estado`. No incluye datos de otros clientes ni del nodo.",
-    inputSchema: { estado: z.string().optional().describe("Estado: 'A retirar', 'Colectado', 'En centro de distribución', 'En camino', 'Entregado' (o una novedad, ej. 'Comprador ausente'). Filtra por los que EMPIEZAN con ese texto ('Entregado' incluye 'Entregado (Flex)'); los 300 más recientes de ese estado.") },
-  }, async ({ estado }) => run(() => api("GET", `/portal/envios${q({ estado })}`)));
-
-  tool("mis_kpis", {
-    title: "Mis métricas",
-    description: "Tus métricas: volumen, calidad de entrega, saldo, última liquidación y un benchmark ANÓNIMO contra el promedio de tu nodo (nunca ves a quién corresponde cada número).",
-    inputSchema: { desde: z.string().optional().describe("Fecha YYYY-MM-DD (pasá desde y hasta juntas; si falta una, usa el mes en curso)"), hasta: z.string().optional().describe("Fecha YYYY-MM-DD") },
-  }, async ({ desde, hasta }) => run(() => api("GET", `/kpi/vendedor${q({ desde, hasta })}`)));
-
-  // --- Control de stock del vendedor (WMS Fase 1). Se registran SIEMPRE para
-  //     rol=cliente: el backend gatea con 403 si el vendedor no tiene depósito ni
-  //     control de stock propio. Así funciona tanto con WMS del nodo como con el
-  //     modo "soft" por vendedor (Cliente.controlStockActivo). ---
-  tool("mi_stock", {
-    title: "Mi stock",
-    description: "Tu stock físico en el depósito (solo tus productos). Requiere tener depósito o control de stock habilitado.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/wms/stock")));
-
-  tool("mi_disponible", {
-    title: "Mi disponible para vender",
-    description: "Disponible-para-vender por SKU = stock físico − comprometido en pedidos pendientes. Marca ⚠️ cuando un SKU está por debajo del mínimo. Solo tus productos.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/wms/stock/disponible")));
-
-  tool("mi_rentabilidad", {
-    title: "Mi rentabilidad por SKU",
-    description: "Margen por SKU en un rango (default: mes en curso) = precio de venta − costo de envío real − COGS opcional. Solo tus productos. Fechas YYYY-MM-DD.",
-    inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
-  }, async ({ desde, hasta }) => run(() => api("GET", `/wms/rentabilidad${q({ desde, hasta })}`)));
-
-  tool("mis_productos", {
-    title: "Mi catálogo",
-    description: "Tu catálogo de productos en el depósito.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/wms/productos")));
-
-  tool("mis_top_productos", {
-    title: "Mis productos más despachados",
-    description: "Ranking de TUS productos más despachados en un rango (default: mes en curso). Solo tus productos.",
-    inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
-  }, async ({ desde, hasta }) => run(() => api("GET", `/wms/top-productos${q({ desde, hasta })}`)));
-  tool("mis_sucursales", {
-    title: "Mis sucursales / puntos de retiro",
-    description: "Tus sucursales (puntos de retiro) con dirección, horario de corte y ventanas. La sucursal principal es tu dirección de retiro. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/portal/sucursales")));
-  tool("mi_colecta", {
-    title: "Estado de mi colecta",
-    description: "Cómo está tu colecta (retiro): si la colecta AUTOMÁTICA está prendida, si pediste una por única vez, y el aviso de costo (si te cobran cuando llevás menos de X envíos). Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/portal/colecta")));
-}
-
-// ============================================================================
-//  ROL MENSAJERO — su ruta y colectas (para saber cuántos envíos tendrá).
-// ============================================================================
-if (rol === "mensajero") {
-  tool("mi_ruta", {
-    title: "Mi ruta del día",
-    description: "Tus entregas asignadas (paradas de la ruta del día). Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/flujo/mi-ruta")));
-  tool("mis_colectas", {
-    title: "Mis colectas (retiros)",
-    description: "Las colectas/retiros que tenés asignados. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/colecta/mis-colectas")));
-}
-
-// ============================================================================
-//  ROL STAFF DE NODO — datos de SU nodo (gateado por permiso; el backend fuerza el nodo).
-// ============================================================================
-if (isStaff) {
-  if (puede("gestion")) {
-    tool("clientes_del_nodo", {
-      title: "Clientes y listas del nodo",
-      description: "Clientes/vendedores del nodo con su lista de precio asignada, más las listas disponibles. Scopeado a tu nodo.",
-      inputSchema: {},
-    }, async () => run(() => api("GET", "/gestion/formularios")));
-    tool("sin_vendedor", { title: "Cuentas de ML y envíos sin vendedor", description: "Cuentas de Mercado Libre y envíos cargados con foto que tu nodo tiene SIN VENDEDOR (típico de un nodo recién dado de alta, o de etiquetas de cuentas no vinculadas que se escanearon). Devuelve `cuentas` (por cuenta de ML: cuántos envíos, ejemplos de destinatarios, si ya está vinculada) y `envios` (los cargados con foto, con la pista de la etiqueta), y los `clientes` del nodo (con si tienen usuario). Después usá `asignar_sin_vendedor`. Admin global: pasá `nodo`. No mueve dinero.", inputSchema: { nodo: zNodo() } },
-      async ({ nodo }) => run(() => api("GET", `/sin-vendedor${q({ nodo })}`)));
-    if (ALLOW_WRITE)
-      tool("asignar_sin_vendedor", {
-        title: "Asignar cuentas de ML / envíos sin vendedor a un vendedor (+ enlaces)",
-        description: "Asigna a UN vendedor las cuentas de ML y/o envíos que el nodo tiene sin vendedor (ver `sin_vendedor`). En un paso: cada cuenta queda asociada al vendedor y TODOS sus envíos sin vendedor pasan a ser de él; los envíos con foto elegidos también; si el vendedor no tiene usuario y pasás `usuarioEmail`/`usuarioNombre`/`usuarioApellido` (de la PERSONA que entra), se le crea con clave temporal; y devuelve UN ENLACE DE VINCULACIÓN por cada cuenta de ML para mandárselo (vence en 48 hs). Cuando el vendedor lo autoriza, lo que quede de esa cuenta se le engancha solo. Vendedor: `idCliente` de tu nodo, o `nuevoVendedor` (nombre) para crearlo. No mueve dinero.",
-        inputSchema: {
-          idCliente: z.number().optional().describe("Vendedor existente de tu nodo"),
-          nuevoVendedor: z.string().optional().describe("Nombre de un vendedor NUEVO (se crea en tu nodo)"),
-          telefono: z.string().optional().describe("Teléfono del vendedor nuevo (opcional)"),
-          cuentasML: z.array(z.string()).optional().describe("Cuentas de ML (el número de usuario, de `sin_vendedor`)"),
-          envioIds: z.array(z.number()).optional().describe("Envíos cargados con foto (ids de `sin_vendedor`)"),
-          usuarioEmail: z.string().optional().describe("Si el vendedor no tiene usuario: email de login de la persona"),
-          usuarioNombre: z.string().optional(),
-          usuarioApellido: z.string().optional(),
-          nodo: z.number().optional().describe("Solo admin global"),
-        },
-      }, async (a) => run(() => api("POST", "/sin-vendedor/asignar", {
-        idCliente: a.idCliente, nuevo: a.nuevoVendedor ? { nombre: a.nuevoVendedor, telefono: a.telefono } : undefined,
-        usuario: a.usuarioEmail ? { email: a.usuarioEmail, nombre: a.usuarioNombre, apellido: a.usuarioApellido } : undefined,
-        cuentasML: a.cuentasML, envioIds: a.envioIds, nodo: a.nodo,
-      })));
-  }
-
-  if (puede("precios")) {
-    tool("precios_ver", {
-      title: "Ver listas de precios",
-      description: "Las listas de precios (por zona: cercana/media/lejana/muy lejana) de tu nodo. Solo lectura.",
-      inputSchema: {},
-    }, async () => run(() => api("GET", "/precios/clientes")));
-  }
-
-  if (puede("reportes")) {
-    tool("kpi_nodo", {
-      title: "Métricas del nodo",
-      description: "Tablero del nodo: volumen y entregas con variación mensual, P&L real, top de clientes y clientes en caída. Solo lectura, scopeado a tu nodo.",
-      inputSchema: { desde: z.string().optional().describe("Fecha YYYY-MM-DD (pasá desde y hasta juntas; si falta una, usa el mes en curso)"), hasta: z.string().optional().describe("Fecha YYYY-MM-DD"), nodo: zNodo() },
-    }, async ({ desde, hasta, nodo }) => run(() => api("GET", `/kpi/nodo${q({ desde, hasta, nodo })}`)));
-  }
-
-  if (puede("wms") && wmsActivo) {
-    tool("stock_nodo", {
-      title: "Stock del nodo",
-      description: "Stock del depósito del nodo. Opcional: filtrar por un cliente.",
-      inputSchema: { cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
-    }, async ({ cliente }) => run(() => api("GET", `/wms/stock${q({ cliente })}`)));
-
-    tool("productos_nodo", {
-      title: "Catálogo del nodo",
-      description: "Catálogo de productos del depósito del nodo. Opcional: filtrar por cliente.",
-      inputSchema: { cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
-    }, async ({ cliente }) => run(() => api("GET", `/wms/productos${q({ cliente })}`)));
-
-    tool("top_productos", {
-      title: "Productos más despachados del nodo",
-      description: "Ranking de productos más despachados del nodo en un rango (default: mes en curso). Opcional: filtrar por un cliente.",
-      inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD"), cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
-    }, async ({ desde, hasta, cliente }) => run(() => api("GET", `/wms/top-productos${q({ desde, hasta, cliente })}`)));
-  }
-}
-
-if (isStaff && puede("finanzas")) {
-  tool("cuenta_semanal_nodos", {
-    title: "Cuenta semanal con otros nodos (juntada)",
-    description: "La cuenta de TU nodo con cada nodo con el que se pasaron paquetes por un grupo (Bonorino, Portela…): semana de lunes a sábado que se congela el miércoles siguiente. Cada paquete vale la tarifa del nodo que lo recibe; por nodo se netea (neto > 0: te pagan; < 0: pagás vos). Sin `cierre`: lo que todavía NO se cerró (en vivo). Con `cierre` (id): ese cierre congelado. `lista:true` = tus cierres con su neto. Solo lectura, no mueve dinero. El admin global elige el nodo con `nodo`.",
-    inputSchema: {
-      cierre: z.number().int().positive().optional().describe("id del cierre semanal (de `lista`)"),
-      lista: z.boolean().optional().describe("true = listar tus cierres semanales"),
-      nodo: zNodo(),
-    },
-  }, async ({ cierre, lista, nodo }) =>
-    run(() => api("GET", lista ? `/logisticas/mis-cierres${q({ nodo })}` : cierre ? `/logisticas/mis-cierres/${cierre}${q({ nodo })}` : `/logisticas/mis-cierres/sin-cerrar${q({ nodo })}`)));
-}
-
-// ============================================================================
-//  ROL GLOBAL (superadmin / superoperador)
-// ============================================================================
-if (esGlobal) {
-  tool("cierre_semanal_links", {
-    title: "Links sin login del cierre semanal",
-    description: "Para cada nodo de un cierre semanal (el último si no pasás `cierre`), el link SIN LOGIN donde ve su cuenta de esa semana con cada nodo y la baja en PDF. Primero los que NO tienen usuario: a esos pasáselo vos por WhatsApp (no tienen teléfono cargado). Solo admin global. Solo lectura.",
-    inputSchema: { cierre: z.number().int().positive().optional().describe("id del cierre (default: el último)") },
-  }, async ({ cierre }) => run(() => api("GET", `/logisticas/cierres-semanales/links${q({ cierre })}`)));
-
-  tool("nodos_listar", {
-    title: "Listar nodos",
-    description: "Lista todas las logísticas (nodos) con sus conteos. Solo admin global.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/logisticas")));
-
-  tool("nodo_renombrar", {
-    title: "Cambiar el nombre real de un nodo",
-    description: "Cambia la razón social (nombre real) de un nodo — lo ve TODO el mundo (a diferencia de `nodo_alias_poner`, que es un apodo personal tuyo). Solo admin global. No toca dinero.",
-    inputSchema: {
-      nodo: z.string().min(1).describe("Nombre actual (o tu apodo) del nodo"),
-      nombreNuevo: z.string().min(1).describe("Nombre nuevo"),
-    },
-  }, async ({ nodo: nodoQ, nombreNuevo }) => run(async () => {
-    const lr = await api("GET", "/flujo/logisticas-select");
-    if (!lr.ok) return lr;
-    const lista = lr.data ?? [];
-    const q2 = nodoQ.trim().toLowerCase();
-    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q2) || (l.alias ?? "").toLowerCase().includes(q2));
-    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
-    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
-    return api("PUT", `/logisticas/${cands[0].id}`, { nombre: nombreNuevo });
-  }));
-
-  tool("kpi_red", {
-    title: "Métricas de la red (SaaS)",
-    description: "KPIs globales de toda la red de nodos (crecimiento, operacional, volumen de clearing). Solo admin global.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/kpi/saas")));
-
-  tool("usuario_habilitar_rol", {
-    title: "Habilitar/deshabilitar un rol de administración",
-    description: "Habilita o deshabilita a un usuario (por id) como superoperador (global) y/o admin de nodo. Solo admin global. El backend exige un superadmin real para otorgar superoperador. Pasá al menos uno de los flags (true = habilitar, false = quitar). No toca dinero.",
-    inputSchema: { id: z.number().int().positive(), esSuperoperador: z.boolean().optional(), esAdminNodo: z.boolean().optional() },
-  }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/${id}`, body)));
-
-  tool("grupo_crear", {
-    title: "Crear grupo logístico",
-    description: "Crea un grupo logístico nuevo (para clearing entre nodos; los nodos se agregan/tarifan después). Solo admin global. No toca dinero.",
-    inputSchema: { nombre: z.string().min(1) },
-  }, async ({ nombre }) => run(() => api("POST", "/logisticas/grupos", { nombre })));
-
-  tool("logo_subir", {
-    title: "Subir logo / marca de un nodo (marca blanca)",
-    description: "Sube o actualiza el logo y la marca de un nodo (marca blanca). El logo va como data-URI base64 (ej. data:image/png;base64,...). Solo admin global. No toca dinero.",
-    inputSchema: { nodo: z.number().int().positive().describe("Id del nodo (de `nodos_listar`)"), logo: z.string().min(1).describe("imagen en data-URI base64, ej. data:image/png;base64,..."), marca: z.string().optional(), slug: z.string().optional(), color: z.string().optional() },
-  }, async ({ nodo, logo, marca, slug, color }) => run(() => api("PUT", `/logisticas/${nodo}/branding`, { logo, marca, slug, color })));
-
-  tool("sugerencias_listar", {
-    title: "Sugerencias de usuarios (admin)",
-    description: "Solo superadmin: todas las sugerencias de la red (funciones nuevas/mejoras/bugs) con usuario, rol, nodo, estado. Filtrá por `rol` y/o `estado`. Para las propias está `mis_sugerencias`. Solo lectura.",
-    inputSchema: { rol: z.string().optional(), estado: z.string().optional().describe("nueva | vista | en_evaluacion | implementada | descartada") },
-  }, async ({ rol, estado }) => run(() => api("GET", `/feedback/sugerencias${q({ rol, estado })}`)));
-}
-
-// ============================================================================
-//  VINCULACIÓN DE TIENDAS — genera el enlace de autorización (OAuth) para traer las
-//  ventas de una tienda a Nexus Flex. Un vendedor genera el SUYO; el staff (permiso
-//  gestion) puede generarlo PARA un cliente de SU nodo y mandárselo. No toca dinero.
-// ============================================================================
-if (isCliente || (isStaff && puede("gestion"))) {
-  tool("generar_enlace_vinculacion", {
-    title: "Generar enlace de vinculación de tienda",
-    description: "Genera el enlace (link) para vincular una tienda —Mercado Libre, TiendaNube o Tienda Negocio— y traer sus ventas a Nexus Flex. Si sos vendedor genera el TUYO; si sos staff podés generarlo PARA un cliente de tu nodo pasando 'cliente' y mandarle ese enlace para que lo autorice desde su propia cuenta de la tienda. El enlace vence en 48 hs. No toca dinero.",
-    inputSchema: {
-      proveedor: z.enum(["ml", "tiendanube", "tiendanegocio"]).describe("ml = Mercado Libre · tiendanube · tiendanegocio"),
-      cliente: z.string().optional().describe("Solo staff: nombre o id del cliente de tu nodo"),
-    },
-  }, async ({ proveedor, cliente }) => run(() => api("GET", `/${proveedor}/auth${q({ cliente })}`)));
-}
-
-// ============================================================================
-//  RENDICIONES (lectura) + ZONAS DE REPARTO (mensajeros por zona)
-// ============================================================================
-if (isCliente || isStaff || rol === "mensajero") {
-  tool("rendiciones", {
-    title: "Rendiciones (a recuperar / a rendir)",
-    description: "Estado de rendiciones: cobros/cambios/devoluciones pendientes de recuperar o rendir, con totales y quién tiene cada uno. Scopeado a tu alcance (vendedor: lo tuyo; nodo: tu nodo). Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/flujo/rendiciones")));
-}
-
-// Reclamos de clientes ligados a liquidaciones (vendedor: lo suyo; operador: su nodo).
-if (isCliente || isStaff) {
-  tool("reclamos_listar", {
-    title: "Reclamos de clientes (liquidaciones)",
-    description: "Reclamos abiertos de clientes ligados a liquidaciones/rendiciones: tipo, estado, trackings en disputa, detalle. Sirve para ver qué cobros/rendiciones pendientes tienen reclamo. Vendedor ve lo suyo, operador su nodo. Solo lectura.",
-    inputSchema: { estado: z.string().optional().describe("abierto | resuelto") },
-  }, async ({ estado }) => run(() => api("GET", `/feedback/reclamos${q({ estado })}`)));
-}
-
-// ── ADMIN DE GRUPO ──  Los nodos originales de un grupo son sus admins; gestionan quién está
-//  adentro y quién administra. Ver miembros lo puede cualquier miembro; sumar/expulsar/permiso
-//  solo un admin del grupo (o admin global). Nunca se deja un grupo sin admin. No mueve dinero.
-if (isStaff) {
-  tool("grupos_tarifas", {
-    title: "Grupos logísticos con sus tarifas de clearing",
-    description: "Los grupos logísticos de tu nodo (admin global: todos) con los nodos que los integran y la TARIFA de clearing vigente de cada uno por zona (cercana / media / lejana / muy lejana). Es lo que hay que mirar para auditar por qué un traspaso entre nodos se cobró lo que se cobró: el tramo usa el precio del nodo en ESE grupo. `grupo_miembros` muestra quién está; esto muestra a cuánto. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/logisticas/grupos")));
-  tool("grupo_miembros", {
-    title: "Miembros de un grupo logístico",
-    description: "Lista los nodos de un grupo (por id), marcando quién es ADMIN de grupo y si vos lo sos. El id del grupo sale de `grupos_tarifas`. Solo miembros del grupo. Solo lectura.",
-    inputSchema: { grupo: z.number().int().positive().describe("id del grupo") },
-  }, async ({ grupo }) => run(() => api("GET", `/qr/grupo/${grupo}/miembros`)));
-  tool("grupo_sumar_nodo", {
-    title: "Sumar un nodo al grupo (admin de grupo)",
-    description: "Agrega un nodo (por id) a un grupo. Solo un ADMIN del grupo (o admin global) puede. El nodo entra como miembro normal (sin permiso de admin). No mueve dinero.",
-    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo a sumar") },
-  }, async ({ grupo, nodo }) => run(() => api("POST", "/qr/grupo-sumar", { grupoId: grupo, logisticaId: nodo })));
-  tool("grupo_expulsar_nodo", {
-    title: "Expulsar un nodo del grupo (admin de grupo)",
-    description: "Saca un nodo (por id) de un grupo. Solo un ADMIN del grupo (o admin global). No se puede expulsar al último admin (pasá antes el permiso a otro nodo). No mueve dinero.",
-    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo a expulsar") },
-  }, async ({ grupo, nodo }) => run(() => api("POST", "/qr/grupo-expulsar", { grupoId: grupo, logisticaId: nodo })));
-  tool("grupo_admin_permiso", {
-    title: "Dar / sacar permiso de admin de grupo",
-    description: "Da o saca el permiso de ADMIN de grupo a un nodo del grupo (así otros pueden administrar, ej. si los originales se van). Solo un admin del grupo (o admin global). No se puede sacar el permiso al último admin. No mueve dinero.",
-    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo"), admin: z.boolean().describe("true = darle admin, false = sacárselo") },
-  }, async ({ grupo, nodo, admin }) => run(() => api("POST", "/qr/grupo-permiso", { grupoId: grupo, logisticaId: nodo, esAdminGrupo: admin })));
-}
-
-// Consultar UN envío por tracking/código (cuando un vendedor pregunta "¿dónde está mi
-// envío X?"). Vendedor: solo entre SUS envíos; staff: dentro de su nodo.
-if (isCliente || isStaff) {
-  tool("envio_consultar", {
-    title: "Consultar un envío",
-    description: "Busca UN envío por tracking o código y devuelve su estado actual, el historial de estados (con fechas), destinatario, dirección y datos de cobro/cambio si tiene. Vendedor: solo entre SUS envíos; staff: dentro de su nodo. Úsalo cuando un vendedor pregunta por un pedido puntual.",
-    inputSchema: { codigo: z.string().min(1).describe("Tracking o código del envío (lo que manda el vendedor)") },
-  }, async ({ codigo }) => {
-    const code = String(codigo ?? "").trim();
-    if (!code) return { content: [{ type: "text", text: "Pasá un tracking o código de envío." }], isError: true };
-    const low = code.toLowerCase();
-    try {
-      if (isStaff) {
-        const lista = await api("GET", `/flujo/envios${q({ q: code })}`);
-        const rows = Array.isArray(lista.data) ? lista.data : [];
-        if (!rows.length) return { content: [{ type: "text", text: `No encontré un envío "${code}" en tu nodo.` }] };
-        const exact = rows.filter((e) => String(e.tracking ?? "").toLowerCase() === low);
-        const pick = exact.length ? exact : rows;
-        if (pick.length > 1)
-          return { content: [{ type: "text", text: `Varios envíos matchean "${code}". Elegí uno (pasá el tracking completo):\n${JSON.stringify(pick.slice(0, 10).map((e) => ({ id: e.id, tracking: e.tracking, estado: e.estado, cliente: e.cliente, destinatario: e.destinatario })), null, 2)}` }] };
-        return toResult(await api("GET", `/flujo/envios/${pick[0].id}`));
-      }
-      const lista = await api("GET", "/portal/envios");
-      const rows = Array.isArray(lista.data) ? lista.data : [];
-      let match = rows.filter((e) => String(e.tracking ?? "").toLowerCase() === low);
-      if (!match.length) match = rows.filter((e) => String(e.tracking ?? "").toLowerCase().includes(low));
-      if (!match.length) return { content: [{ type: "text", text: `No encontré un envío "${code}" entre tus envíos.` }] };
-      if (match.length > 1)
-        return { content: [{ type: "text", text: `Varios envíos matchean "${code}". Pasá el tracking completo:\n${JSON.stringify(match.slice(0, 10).map((e) => ({ id: e.id, tracking: e.tracking, estado: e.estado })), null, 2)}` }] };
-      return toResult(await api("GET", `/portal/envios/${match[0].id}`));
-    } catch (e) {
-      return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }], isError: true };
-    }
-  });
-}
-
-// Métricas por tipo de envío (flex/tienda/manual) + % antes de 21hs + (red) por logística.
-if (isCliente || isStaff) {
-  tool("metricas_por_tipo", {
-    title: "Métricas por tipo de envío",
-    description: "Métricas por TIPO de envío (flex/tienda/manual): total, entregados, tasa de entrega y % ENTREGADO ANTES DE LAS 21hs. Admin/red desglosa por logística (qué nodo entrega mejor). Vendedor ve lo suyo, operador su nodo. Fechas YYYY-MM-DD (default: últimos 30 días).",
-    inputSchema: {
-      desde: z.string().optional().describe("YYYY-MM-DD"),
-      hasta: z.string().optional().describe("YYYY-MM-DD"),
-      nodo: z.number().optional().describe("Solo admin/superoperador: elegir nodo (si no, la red)"),
-    },
-  }, async ({ desde, hasta, nodo }) => run(() => api("GET", `/kpi/envios-por-tipo${q({ desde, hasta, nodo })}`)));
-}
-
-// Cuentas de tienda vinculadas (ML / TiendaNube / TiendaNegocio), scopeadas por rol.
-if (isCliente || isStaff) {
-  tool("cuentas_vinculadas", {
-    title: "Cuentas vinculadas (ML / TiendaNube / TiendaNegocio)",
-    description: "Cuántas cuentas de tienda hay vinculadas, con desglose por proveedor (Mercado Libre / TiendaNube / TiendaNegocio). Vendedor: las suyas; operador: las de los clientes de SU nodo (agrupadas por cliente); admin/superoperador: por nodo (o pasá `nodo` para bajar al desglose por cliente de ese nodo). Solo lectura.",
-    inputSchema: { nodo: z.number().optional().describe("Solo admin: baja al desglose por cliente de ese nodo") },
-  }, async ({ nodo }) => run(() => api("GET", `/cuentas-vinculadas${q({ nodo })}`)));
-}
-
-// Afiliados: comisión recurrente por envío (staff = admin global o admin de nodo, scopeado).
-if (isStaff) {
-  tool("afiliacion_listar", {
-    title: "Listar afiliaciones",
-    description: "Afiliaciones (afiliado↔entidad referida) con su comisión por envío, vigencia y estado. Filtrá por `afiliado` o `entidad`. Solo lectura, scopeado a tu nodo.",
-    inputSchema: { afiliado: z.string().optional(), entidad: z.string().optional() },
-  }, async ({ afiliado, entidad }) => run(() => api("GET", `/afiliados/afiliaciones${q({ afiliado, entidad })}`)));
-  tool("comisiones_afiliado_ver", {
-    title: "Comisiones de afiliados",
-    description: "Comisiones devengadas por envío (pendiente/liquidada) con totales. Filtrá por `afiliado` y rango de fechas. Solo lectura, scopeado a tu nodo.",
-    inputSchema: { afiliado: z.string().optional(), desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
-  }, async ({ afiliado, desde, hasta }) => run(() => api("GET", `/afiliados/comisiones${q({ afiliado, desde, hasta })}`)));
-}
-
-// Choferes (mensajeros) del nodo — requiere permiso 'usuarios'.
-if (isStaff && puede("usuarios")) {
-  tool("chofer_listar", {
-    title: "Listar usuarios del nodo (choferes)",
-    description: "Usuarios de tu nodo (incluye los choferes = rol 'mensajero') con su id, nombre, teléfono, activo. Solo lectura, scopeado a tu nodo.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/usuarios")));
-}
-
-// Marketplace de rutas/colectas públicas (subasta abierta, cualquier nodo de la red).
-if (isStaff) {
-  tool("rutas_publicas", {
-    title: "Rutas/colectas públicas (marketplace)",
-    description: "Publicaciones ABIERTAS de toda la red que tu nodo puede tomar (con cuántas ofertas tiene cada una). Marca las tuyas (`esMia`). Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/rutas-publicas/publicas")));
-  tool("mis_rutas", {
-    title: "Mis publicaciones y ofertas (marketplace)",
-    description: "Tus publicaciones de rutas (con su estado/adjudicación) y las ofertas que hiciste a otros nodos. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/rutas-publicas/mias")));
-  tool("ruta_ofertas", {
-    title: "Ver ofertas de una publicación mía",
-    description: "Ofertas recibidas en una publicación TUYA (ordenadas por precio asc). Solo el que publicó. Usá el id de oferta para adjudicar.",
-    inputSchema: { publicacionId: z.number().int().positive() },
-  }, async ({ publicacionId }) => run(() => api("GET", `/rutas-publicas/${publicacionId}/ofertas`)));
-}
-
-if (isStaff) {
-  tool("nodo_alias_poner", {
-    title: "Ponerle un apodo personal a un nodo",
-    description: "Le ponés TU propio apodo a un nodo (ej. 'Flex Fácil' = 'Félix', el dueño) para reconocerlo más fácil: de ahí en más lo podés nombrar por ese apodo en cualquier herramienta que pida un nodo (asignar_nodo_zona, etc.) y también aparece en los buscadores de la app. Es PERSONAL — no lo ve otro usuario ni cambia el nombre real de la logística. Mandá `alias` vacío para sacarlo.",
-    inputSchema: {
-      nodo: z.string().min(1).describe("Nombre (o tu apodo actual) del nodo"),
-      alias: z.string().describe("El apodo nuevo (vacío para sacarlo)"),
-    },
-  }, async ({ nodo: nodoQ, alias }) => run(async () => {
-    const lr = await api("GET", "/flujo/logisticas-select");
-    if (!lr.ok) return lr;
-    const lista = lr.data ?? [];
-    const q = nodoQ.trim().toLowerCase();
-    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q) || (l.alias ?? "").toLowerCase().includes(q));
-    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
-    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
-    return api("POST", "/flujo/nodo-alias", { logisticaId: cands[0].id, alias });
-  }));
-}
-
-if (isStaff && puede("gestion")) {
-  tool("zonas_reparto", {
-    title: "Zonas de reparto (mensajeros por zona)",
-    description: "Lista las zonas de reparto de tu nodo con sus metazonas y qué mensajeros tiene asignado cada una. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/zonificacion/zonas-reparto")));
-
-  tool("zonas_simetria", {
-    title: "Chequear simetria de distancias entre zonas",
-    description: "Chequea la SIMETRIA de las distancias entre zonas: si desde el perfil de A un lugar B es 'cercana', desde el perfil de B el lugar A deberia ser 'cercana' tambien. Devuelve los pares que NO cumplen, los que faltan cargar en un sentido, y los perfiles que todavia no declararon en que lugar viven. SOLO INFORMA: no corrige ni completa nada, porque puede haber asimetrias legitimas (autopista, rio, barrera) y la decision es humana. Para que un grupo entre al chequeo hay que declararle su 'perfil de origen'.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/zonificacion/simetria")));
-
-  tool("zona_barrios", {
-    title: "Barrios/localidades de una zona",
-    description: "Consulta rápida: qué localidades y BARRIOS componen una zona con nombre (ej. 'Matanza Norte', 'CABA'), con su tramo por perfil. Buscás por nombre; devuelve las zonas que matchean (propias del nodo, globales o de tus grupos logísticos). Solo lectura. Usalo cuando te preguntan '¿qué barrios hay en <zona>?'.",
-    inputSchema: { zona: z.string().min(1).describe("Nombre de la zona, ej. 'Matanza Norte' o 'CABA'") },
-  }, async ({ zona }) => run(() => api("GET", `/zonificacion/zona-barrios${q({ zona })}`)));
-
-  tool("facturacion_estado", {
-    title: "¿Qué falta para facturar?",
-    description:
-      "Diagnóstico de facturación ARCA de tu nodo: qué emisores hay y si están completos, qué cuentas de dinero no tienen emisor propio, y por cada cliente exactamente qué dato le falta (CUIT, razón social, condición IVA, emisor, habilitación). Sin 'cliente' lista los YA habilitados; con 'cliente' (nombre o id) mira ese aunque no esté habilitado. NO devuelve importes ni emite nada: es estado de configuración. Empezá y terminá por acá cuando pongas a alguien a facturar (ver el flujo 'facturacion').",
-    inputSchema: { cliente: z.string().optional().describe("Nombre o id de un cliente puntual; vacío = los ya habilitados") },
-  }, async ({ cliente }) => run(() => api("GET", `/afip/estado${q({ cliente })}`)));
-
-  tool("colecta_ver", {
-    title: "Ver config de colectas",
-    description: "Resumen de valores de colecta del nodo: pago default del nodo, cobros por cliente y pagos pactados por cliente+mensajero. Solo lectura.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/colecta/config")));
-
-  tool("colecta_pendientes", {
-    title: "Colectas del día y de mañana",
-    description: "Panel de colectas de tu nodo. `items` = clientes a retirar HOY (con cuántos envíos, el corte y qué colecta está asignada a qué mensajero). `itemsManana` = clientes con envíos que entraron después del corte → van a la colecta de MAÑANA. `clientesSinEnvios` = vendedores del nodo SIN envíos cargados, a los que igual se los puede mandar a colectar (el cadete escanea los paquetes en la puerta). Solo lectura. Sirve para «¿quién levanta a tal cliente?» y «¿el cliente X tiene envíos para mañana?».",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/colecta/panel")));
-
-  tool("colecta_historial", {
-    title: "Historial de colectas (paquetes por día y cliente)",
-    description: "Paquetes COLECTADOS por día y por cliente en una fecha o rango (histórico, hasta 62 días), con quién los colectó. `desde` (aaaa-mm-dd, obligatorio), `hasta` (opcional, default = desde), `cliente` (nombre o id, opcional). Cuenta cada paquete una vez, en el día de Argentina en que se colectó (evento Colectado o colecta en la puerta). Solo tu nodo. Solo lectura. Sirve para «¿cuántos paquetes le levantamos a X el martes?».",
-    inputSchema: {
-      desde: z.string().describe("aaaa-mm-dd"),
-      hasta: z.string().optional().describe("aaaa-mm-dd; vacío = el mismo día"),
-      cliente: z.string().optional().describe("nombre (o parte) o id del cliente"),
-    },
-  }, async ({ desde, hasta, cliente }) => run(() => api("GET", `/colecta/historial${q({ desde, hasta, cliente })}`)));
-
-  tool("envios_por_zona", {
-    title: "Envíos que otros nodos te rutearon (por zona)",
-    description: "Envíos de OTROS nodos ruteados a tu nodo por zona de reparto, agrupados por zona (para aceptarlos o rechazarlos). Cada envío trae su id (usalo en procesar_zona/rechazar_zona). Solo lectura, tu nodo.",
-    inputSchema: {},
-  }, async () => run(() => api("GET", "/colecta/zonas-a-procesar")));
-
-  tool("asignar_mensajero_zona", {
-    title: "Asignar un mensajero a una zona",
-    description: "Asigna un mensajero (por nombre, de tu nodo) a una metazona/zona (ej. «asigná a Maxi la zona de Palermo»). Si ya existe una zona con esa metazona, le suma el mensajero; si no, la crea. No cruza nodos. El admin global elige el nodo con `nodo`.",
-    inputSchema: {
-      mensajero: z.string().min(1).describe("Nombre del mensajero (de tu nodo)"),
-      metazona: z.string().min(1).describe("Metazona/zona, ej. 'Palermo' o 'CABA'"),
-      nombre: z.string().optional().describe("Nombre de la zona (opcional)"),
-      nodo: zNodo(),
-    },
-  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/asignar-mensajero", { ...rest, logisticaId: nodo })));
-
-  tool("asignar_nodo_zona", {
-    title: "Asignar un NODO a una zona (grupo logístico)",
-    description: "Asigna un NODO COMPLETO (por nombre, de tu grupo logístico) a una metazona. Sin `grupo`: para cuando ese nodo cubre toda una localidad de TU zona (ej. «que RL cubra Portela») — suma el nodo como opción (nodoIds), sin cruzar fuera de tu grupo. CON `grupo` (ej. 'Bonorino'/'Portela'): MODO COMISIÓN — la zona es del GRUPO (no de un nodo dueño) y esto reasigna quién es el responsable; solo lo puede hacer un ADMIN de ese grupo (o el admin global). Acá `nodo` es el DESTINO (por nombre); el admin global elige el nodo DUEÑO de la zona sin-grupo con `logisticaId`.",
-    inputSchema: {
-      nodo: z.string().min(1).describe("Nombre del nodo (de tu grupo logístico) que cubre la zona"),
-      metazona: z.string().min(1).describe("Metazona/zona, ej. 'Portela' o 'CABA'"),
-      nombre: z.string().optional().describe("Nombre de la zona (opcional)"),
-      grupo: z.string().optional().describe("Nombre o id del grupo logístico (ej. 'Bonorino') — MODO COMISIÓN: la zona pasa a ser del grupo y solo su admin puede asignarla/reasignarla"),
-      logisticaId: z.number().int().positive().optional().describe("Solo admin global y sin `grupo`: id del nodo DUEÑO de la zona sobre el que operás. El operador de nodo lo ignora."),
-    },
-  }, async (args) => run(() => api("POST", "/zonificacion/zonas-reparto/asignar-nodo", args)));
-
-  tool("zona_dejar", {
-    title: "Dejar de ser responsable de una zona de grupo",
-    description: "Te sacás (a tu nodo) de una zona de un grupo logístico (ej. Bonorino) que tenías asignada — self-service, solo podés sacarte a VOS. Si eras el único responsable, la zona pasa a LIBERADA y se avisa a TODO el grupo; solo la comisión (admin del grupo) la puede volver a asignar con `asignar_nodo_zona` + `grupo`.",
-    inputSchema: {
-      grupo: z.string().min(1).describe("Nombre o id del grupo"),
-      metazona: z.string().min(1).describe("Metazona/zona que dejás"),
-      nodo: zNodo(),
-    },
-  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/dejar", { ...rest, logisticaId: nodo })));
-
-  tool("nodo_link_confirmacion", {
-    title: "Link de confirmación sin login para un nodo",
-    description: "Devuelve el link FIJO (sin login) donde un nodo sin usuarios propios (ej. un integrante 'feeder' de un grupo que solo deja paquetes) ve los envíos que le asignaron como responsable de zona y los confirma con un toque. Se lo pasás por WhatsApp a mano — el nodo no tiene teléfono cargado para mandárselo solo. Mismo link siempre para ese nodo (se genera la primera vez).",
-    inputSchema: { nodo: z.string().min(1).describe("Nombre o apodo del nodo") },
-  }, async ({ nodo: nodoQ }) => run(async () => {
-    const lr = await api("GET", "/flujo/logisticas-select");
-    if (!lr.ok) return lr;
-    const lista = lr.data ?? [];
-    const q2 = nodoQ.trim().toLowerCase();
-    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q2) || (l.alias ?? "").toLowerCase().includes(q2));
-    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
-    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
-    return api("POST", "/logisticas/link-confirmacion", { logisticaId: cands[0].id });
-  }));
-
-  tool("zonas_grupo", {
-    title: "Zonas de un grupo logístico y quién las cubre",
-    description: "Lista las zonas de un grupo logístico (ej. Bonorino/Portela) con el nodo responsable de cada una, marcando las LIBERADAS (sin responsable) y si vos podés reasignarlas (`puedoAsignar`, solo comisión/admin global). Visible a cualquier miembro del grupo. Solo lectura.",
-    inputSchema: { grupo: z.string().min(1).describe("Nombre o id del grupo") },
-  }, async ({ grupo }) => run(() => api("GET", `/zonificacion/zonas-reparto-grupo${q({ grupo })}`)));
-
-  tool("zona_mover_metazona", {
-    title: "Mover una metazona entre zonas de un grupo",
-    description: "Reclasifica UNA metazona/localidad: la saca de la zona de grupo que la contiene y la mete en OTRA zona del MISMO grupo, sin tocar el nodo responsable (ej. 'El Palomar' está mal puesto en Morón y va a Tres de Febrero, del que es partido). Solo la comisión (admin) del grupo o el admin global. No mueve dinero.",
-    inputSchema: {
-      grupo: z.string().min(1).describe("Nombre o id del grupo (ej. 'Portela')"),
-      metazona: z.string().min(1).describe("Metazona/localidad a mover (ej. 'El Palomar')"),
-      zonaDestino: z.string().min(1).describe("Zona destino: nombre, id, o una metazona que ya tenga (ej. 'Tres de Febrero')"),
-      nodo: zNodo(),
-    },
-  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/metazona-mover", { ...rest, logisticaId: nodo })));
-
-  tool("zona_componer_grupo", {
-    title: "Componer una zona de grupo (metazonas + nodo)",
-    description: "Crea o edita una zona de un grupo logístico: la ubica por nombre/id (o la crea con ese nombre), le puede sumar un NODO responsable y AGREGA/QUITA metazonas de su composición. Sirve para armar las zonas de un grupo NUEVO con su composición completa — importante para el ruteo, que matchea por metazona exacta (ej. una zona 'Flores' que cubra 'CABA · Flores' y 'Flores'). Solo la comisión (admin) del grupo o el admin global. No mueve dinero.",
-    inputSchema: {
-      grupo: z.string().min(1).describe("Nombre o id del grupo"),
-      zona: z.string().min(1).describe("Zona: nombre o id. Si no existe en el grupo, se crea con ese nombre."),
-      nodo: z.string().optional().describe("Nombre del nodo responsable a sumar a la zona (opcional)"),
-      agregar: z.array(z.string()).optional().describe("Metazonas a AGREGAR a la zona (ej. ['CABA · Flores','Flores'])"),
-      quitar: z.array(z.string()).optional().describe("Metazonas a QUITAR de la zona"),
-      nombre: z.string().optional().describe("Nombre para la zona si se crea (default: el valor de `zona`)"),
-      logisticaId: z.number().int().positive().optional().describe("Solo admin global: id del nodo (de la comisión) sobre el que operás. El operador de nodo lo ignora."),
-    },
-  }, async (args) => run(() => api("POST", "/zonificacion/zonas-reparto/grupo-componer", args)));
-
-  tool("grupo_tarifa_set", {
-    title: "Setear la tarifa de clearing de un grupo",
-    description: "Fija la tarifa de clearing por zona (cercana/media/lejana/muyLejana) de TODO un grupo logístico de una: el DEFAULT del grupo y el precio de CADA nodo miembro (su fila vigente). Sirve para dejar un grupo nuevo con su tarifa sin ir nodo por nodo (ej. 2700 en los 4 tramos). Con `soloDef` toca solo el default (no los nodos). Solo la comisión (admin) del grupo o el admin global. Es CONFIG del clearing — NO mueve dinero.",
-    inputSchema: {
-      grupo: z.string().min(1).describe("Nombre o id del grupo"),
-      cercana: z.number().optional().describe("Tarifa zona cercana"),
-      media: z.number().optional().describe("Tarifa zona media"),
-      lejana: z.number().optional().describe("Tarifa zona lejana"),
-      muyLejana: z.number().optional().describe("Tarifa zona muy lejana"),
-      soloDef: z.boolean().optional().describe("true = solo el default del grupo, sin tocar los nodos miembro"),
-    },
-  }, async (args) => run(() => api("POST", "/qr/grupo-tarifa-grupal", args)));
-}
-
-// ============================================================================
-//  ESCRITURA (opt-in por flag · NUNCA dinero). Además gateado por permiso en el backend.
-// ============================================================================
-if (ALLOW_WRITE) {
-  if (isCliente) {
-    tool("sucursal_guardar", {
-      title: "Crear/editar sucursal (punto de retiro)",
-      description: "Crea o edita una sucursal tuya (punto de retiro). Para cambiar tu DIRECCIÓN DE RETIRO editá la sucursal principal (o creá una con principal=true). id vacío = nueva sucursal. Geocodifica la dirección sola. No toca dinero.",
-      inputSchema: {
-        id: z.number().optional().describe("id de la sucursal a editar; vacío = nueva"),
-        nombre: z.string().min(1),
-        direccion: z.string().optional(),
-        principal: z.boolean().optional().describe("true = pasa a ser tu dirección de retiro principal"),
-        horarioCorte: z.string().optional().describe("HH:MM"),
-        ventana1Desde: z.string().optional(), ventana1Hasta: z.string().optional(),
-        ventana2Desde: z.string().optional(), ventana2Hasta: z.string().optional(),
-      },
-    }, async (args) => run(() => api("POST", "/portal/sucursales", args)));
-    tool("colecta_solicitar", {
-      title: "Solicitar colecta (por única vez)",
-      description: "Pedís que te retiren los envíos POR ÚNICA VEZ, aunque tengas la colecta automática apagada. Aparecés en el panel de colecta de tu nodo. Devuelve el aviso de costo (si te cobran cuando llevás menos de X envíos). No mueve dinero.",
-      inputSchema: {},
-    }, async () => run(() => api("POST", "/portal/colecta/solicitar")));
-    tool("colecta_auto", {
-      title: "Prender/apagar colecta automática",
-      description: "Activás (true) o desactivás (false) tu colecta AUTOMÁTICA. Apagada = llevás los envíos al depósito y no te retiran (salvo que pidas una por única vez con colecta_solicitar). No mueve dinero.",
-      inputSchema: { activa: z.boolean() },
-    }, async ({ activa }) => run(() => api("PUT", "/portal/colecta/auto", { activa })));
-  }
-  if (isCliente || (isStaff && puede("gestion")) || rol === "mensajero") {
-    tool("envio_cargar", {
-      title: "Cargar un envío (y etiqueta)",
-      description: "Registra un envío nuevo (queda 'A retirar') y devuelve el tracking + un LINK a la etiqueta imprimible + un LINK para subir una foto del envío desde el celular. El vendedor lo carga para sí mismo; el staff pasa `cliente` (nombre, de su nodo); el MENSAJERO pasa `cliente` y SOLO puede registrar clientes de su nodo o que haya colectado (marketplace incluido). Datos obligatorios: destinatario, telefono, direccion, localidad. Si el envío NO es de HOY (planilla que se carga días después), pasá `fecha` — es la que define en qué SEMANA se liquida. No toca dinero (montoCobro es el cobro contra entrega, no un movimiento).",
-      inputSchema: {
-        cliente: zStr().describe("Staff y mensajero: el vendedor del envío (staff: nombre, de tu nodo; mensajero: nombre o id, de tu nodo o que hayas colectado). El vendedor NO lo manda."),
-        destinatario: z.string().min(1).describe("Nombre de quien recibe"),
-        telefono: z.union([z.string().min(1), z.number()]).transform((x) => String(x)).describe("Teléfono del destinatario (obligatorio: el backend rechaza el envío sin él)"),
-        direccion: z.string().min(1),
-        localidad: z.string().min(1),
-        cp: zStr(),
-        montoCobro: zNum().describe("Cobro contra entrega (opcional)"),
-        esCambio: z.boolean().optional(),
-        detalleCambio: z.string().optional(),
-        comentarios: z.string().optional(),
-        fecha: zStr().describe("Solo staff — fecha del envío (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: para planillas que se cargan días después. Define en qué SEMANA se liquida el envío, así que no se admite una fecha futura."),
-        forzarNuevo: z.boolean().optional().describe("Solo si te respondió POSIBLE DUPLICADO (409): true = es OTRO paquete distinto (dos compras a la misma dirección) y hay que cargarlo igual. Si es el MISMO paquete, NO lo mandes: usá el tracking existente."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/cargar-mcp", args)));
-  }
-  if (isStaff || rol === "mensajero") {
-    tool("envio_desde_etiqueta_ml", {
-      title: "Registrar envío desde una etiqueta de Mercado Libre (foto)",
-      description: "Da de alta (o completa) un envío de Mercado Libre a partir de la etiqueta. El vendedor se resuelve por `mlQr`; si no, por `mlSenderId` (cuenta vinculada o aprendida); si no, por `cliente`. Si no se conoce, devuelve 404 con el senderId: preguntale al usuario de quién es. Es idempotente: si el envío ya estaba cargado no se duplica (se completa y, con `avanzarA`, se avanza). `nodoEntrega`: el nodo que lo entregó (control por foto). Dígitos ilegibles en la altura de la dirección: un '*' por cada uno (ej. 'Aguirre 31**'), no los adivines. Devuelve {id, tracking, yaExistia, noAvanzado?}. No mueve dinero. Para una carpeta de fotos, ver `flujo control_por_foto`.",
-      inputSchema: {
-        cliente: zStr().describe("Vendedor por nombre/id (si no mandás mlSenderId)"),
-        mlSenderId: zStr().describe("sender_id del vendedor en ML (mapea a su cuenta vinculada)"),
-        mlShipmentId: zStr().describe("id de envío/tracking de ML leído de la etiqueta (se limpian espacios OCR)"),
-        mlQr: zStr().describe("Contenido CRUDO del QR de ML (el JSON {id, sender_id, hash_code…}). Alcanza solo: de ahí salen el número de envío y el vendedor, y sirve para reimprimir la etiqueta idéntica. Mandalo SIEMPRE que lo leas."),
-        destinatario: zStr(), telefono: zStr(),
-        direccion: zStr().describe("Dirección; si un dígito de la altura no se lee, poné '*' por cada uno (ej. 'Julian Aguirre 31**'), NO lo inventes"),
-        localidad: zStr(), cp: zStr(), zona: zStr(), barrio: zStr(),
-        avanzarA: z.enum(["colectado", "procesado", "entregado"]).optional().describe("Control por foto: avanza el envío EN UN PASO registrando CADA estado intermedio (atribuido a vos, el usuario MCP). 'colectado' / 'procesado' (En centro) / 'entregado' (recorre A retirar→Colectado→En centro→[grupo=En camino]→Entregado). 'entregado' es la vía rápida para el clearing entre nodos."),
-        autoRutear: z.boolean().optional().describe("Planilla: asigna automáticamente el NODO y/o MENSAJERO responsable de la ZONA de reparto del destino. Configurá antes los responsables con `asignar_nodo_zona`/`asignar_mensajero_zona`."),
-        grupo: zStr().describe("Control por foto: nombre o id de un GRUPO logístico tuyo (ej. 'Bonorino') — despacha por ese grupo (queda 'En camino', su mensajero es el integrante del grupo)."),
-        nodoEntrega: zStr().describe("Solo staff: nodo (nombre o id) que RECIBIÓ y entregó el paquete (ej. 'FastCorreo'). Es el que cobra el traspaso en el cierre semanal entre nodos. Sin `grupo` se deduce: si el cliente es de ese mismo nodo es un paquete propio (sin traspaso); si es de otro nodo, el grupo que comparten (si comparten varios, pedí `grupo`). Si el envío ya tenía otro nodo que entrega, no se pisa."),
-        fotoRuta: zStr().describe("RUTA LOCAL de la foto de la etiqueta en tu compu (ej. 'C:\\\\Users\\\\...\\\\Desktop\\\\etiquetas\\\\ml_123.jpg') — NO la imagen, solo la ruta, para reencontrar la foto. Mandala SIEMPRE que la dirección tenga '*'."),
-        montoCobro: zNum(), mensajero: zStr().describe("Mensajero que hizo el paquete (de tu nodo)"),
-        reusarEtiqueta: z.boolean().optional().describe("ML MANUAL (no vinculado): true = REUSA el mismo tracking/QR/etiqueta de ML que ya viene impreso (NO genera uno nuevo), lo marca 'ml_manual' y es idempotente. Usalo cuando el paquete YA está etiquetado por ML pero no está vinculado a una cuenta."),
-        forzarNuevo: z.boolean().optional().describe("Solo si te respondió POSIBLE DUPLICADO (409): true = es OTRO paquete distinto (dos compras a la misma dirección) y hay que cargarlo igual. Si es el MISMO paquete, NO lo mandes: usá el tracking existente."),
-        fecha: zStr().describe("Solo staff — día REAL en que el paquete se movió (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: para planillas que se controlan días después. Define en qué SEMANA se liquida el envío (no se admite futura) y fecha TODA la cadena de `avanzarA`: cada estado queda con su hora de ESE día (Colectado 9, En centro 12, En camino 15, Entregado 18), no con la hora del control. Si el envío YA estaba cargado, también le mueve la fecha — y si ese período ya está liquidado, rechaza la llamada nombrando la liquidación en vez de dejarlo a medio corregir."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/desde-etiqueta", args)));
-    if (isStaff) registrarControlFoto();
-    tool("envio_procesar", {
-      title: "Procesar / recibir un envío en el centro",
-      description: "Marca un envío como PROCESADO / recibido en el centro de distribución (estado 'En centro de distribución') por su TRACKING, sin escanear — igual que la acción 'procesar' del escáner. Scopeado a tu nodo/grupo. No mueve dinero (registra el tramo de clearing del grupo, como `procesar_zona`).",
-      inputSchema: { tracking: zStr().describe("Tracking / código del envío a procesar") },
-    }, async ({ tracking }) => run(() => api("POST", "/flujo/escanear", { codigo: tracking, accion: "procesar" })));
-    tool("envio_entregar", {
-      title: "Marcar ENTREGADO un envío ya cargado",
-      description: "Marca ENTREGADO uno o varios envíos ya cargados, por tracking, sin foto ni firma. Usalo cuando no estás cargando desde una etiqueta (para eso está `envio_desde_etiqueta_ml` con `avanzarA`). Corre la entrega REAL: sella la logística de entrega para el clearing y le avisa al vendedor. Con `fecha` el historial dice el día REAL de entrega, no la hora del control; sobre un envío que YA figura entregado CORRIGE la fecha del cierre (vuelve en `fechaCorregida`), que es como se arregla una tanda cerrada con el día equivocado. Los que ya estaban entregados y no hay nada que corregirles vuelven en `yaEstaban` y no rompen el lote; los que están en un estado de EXCEPCIÓN (Cancelado, Devuelto al vendedor…) NO se entregan y vuelven en `errores` con su estado real. Staff, y solo envíos de tu nodo (admin global: cualquiera). No mueve dinero.",
-      inputSchema: {
-        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a marcar entregados (ej. ['TN-2057600163','NFABC123'])"),
-        fecha: zStr().describe("Día REAL de entrega (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: la tanda que se controla por foto días después queda en el historial con el día en que salió, no con el del control. No se admite futura. Cambia el evento 'Entregado' del historial, NO la semana en que se liquida el envío — esa se mueve con `envio_editar_fecha`."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/entregar-ref", args)));
-    tool("envio_completar_ciclo", {
-      title: "Reconstruir los pasos que le faltan a un envío ya cerrado",
-      description: "Rellena los pasos que le FALTAN a un envío ya cerrado: 'Colectado', 'En centro de distribución' y 'En camino', cada uno a nombre de QUIEN LO HIZO y fechado en el día real. Solo AGREGA lo que falta: no duplica un paso que ya está, no cambia el estado actual del envío y NO inventa autores (el paso del que no decís quién lo hizo, no se agrega). Pasá una persona por paso (nombre o id, del nodo); si el nombre matchea a varios te devuelve los candidatos con su id en vez de elegir por vos. Staff, y solo envíos de tu nodo. No mueve dinero (el mensajero se asigna con `envio_asignar_mensajero` y el grupo con `envio_asignar_grupo`).",
-      inputSchema: {
-        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a completar (ej. ['NFABC123','TN-2057600163'])"),
-        fecha: zStr().describe("Día REAL en que se hicieron esos pasos (dd/mm/aaaa o aaaa-mm-dd). Cada paso queda con su hora nominal de ese día: Colectado 9, En centro 12, En camino 15. No se admite futura."),
-        colectado: zStr().describe("Quién COLECTÓ (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
-        procesado: zStr().describe("Quién lo recibió EN EL CENTRO de distribución (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
-        enCamino: zStr().describe("Quién lo DESPACHÓ / salió a repartirlo (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/completar-ciclo", args)));
-    tool("envio_pago_mensajero", {
-      title: "Cargar lo que se le paga al mensajero por esos envíos",
-      description: "Carga LO QUE SE LE PAGA a quien repartió cada envío (el valor por envío) y, si al envío le falta el NOMBRE del mensajero, lo completa. Al mensajero se le paga por el nombre guardado en el envío (`Envio.mensajero`), no por el vínculo: este tool escribe valor + nombre. Usa el nombre con el que la persona está cargada (el apodo del resumen, ej. 'Maxi', no 'Maxi Sagarzazu'); en un VENDEDOR con doble rol, el de su cliente. Por defecto NO toca envíos que no estén entregados (un Cancelado o Devuelto vuelve en `noEntregados`); si igual querés pagarlos, pasá `incluirNoEntregados:true`. Si el envío no tiene mensajero y no pasás uno, vuelve en `sinMensajero` sin tocarse. Staff, y solo envíos de tu nodo.",
-      inputSchema: {
-        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a pagar (ej. ['NFABC123','TN-2057600163'])"),
-        valor: zNum().describe("Lo que se le paga POR ENVÍO, en pesos (ej. 2150). Se escribe igual en todos los que mandes."),
-        mensajero: zStr().describe("Opcional: nombre o id de quien repartió. Si lo pasás, lo ASIGNA y lo paga en un solo paso. Si no, usa el mensajero que el envío ya tenga."),
-        incluirNoEntregados: z.boolean().optional().describe("Opcional: true = pagar también los que NO están entregados (Cancelado, Devuelto…). Por defecto NO se tocan y vuelven listados."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/pago-mensajero", args)));
-    tool("envio_corregir_estado", {
-      title: "Corregir el estado de un envío",
-      description: "Corrige el ESTADO de un envío ya cargado, para DESHACER algo que quedó mal: un 'Entregado' que no fue, o un envío que una corrección revivió por error. Además de los estados del panel acepta los TERMINALES de excepción ('Cancelado', 'Rechazado por el comprador'). El `motivo` es OBLIGATORIO (mínimo 10 caracteres) y queda en el historial: una corrección sin explicación es indistinguible de un error. NO toca las banderas de devolución ni de cobro, y no mueve dinero. Staff, y solo envíos de tu nodo.",
-      inputSchema: { tracking: zStr().describe("Tracking del envío a corregir"), estado: zStr().describe("Estado destino (ej. 'Cancelado', 'En camino', 'Entregado')"), motivo: z.string().min(10).describe("Por qué se corrige. Queda en el historial del envío.") },
-    }, async (args) => run(() => api("POST", "/envios/corregir-estado", args)));
-    tool("envio_asignar_mensajero", {
-      title: "Asignar / quitar el mensajero de un envío",
-      description: "Asigna —o QUITA con `quitar:true`— el MENSAJERO de envíos ya cargados, por tracking. Busca entre todos los que pueden repartir (rol mensajero, `reparte`, o vendedor con doble rol); acepta id; si el nombre es ambiguo devuelve candidatos. No mueve dinero: el pago se liquida por NOMBRE (ver `envio_pago_mensajero`).",
-      inputSchema: { trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos"), mensajero: zStr().optional().describe("Nombre o ID de quien repartió (rol mensajero, o alguien con reparto habilitado)"), quitar: z.boolean().optional().describe("true = deja el envío SIN mensajero asignado") },
-    }, async (args) => run(() => api("POST", "/envios/asignar-mensajero", args)));
-    tool("envio_estado", {
-      title: "Estado + ETA de un envío (¿cuándo llega?)",
-      description: "Devuelve una NARRATIVA del estado de un envío (por tracking) para responder '¿cuándo se entrega?': si está en camino, con qué mensajero, cuántos envíos lleva en la ruta, en qué posición va este y una ETA estimada (posición en la ruta × minutos por parada). Marca PROBLEMAS si los hay (nunca despachado, sin mensajero asignado, mensajero sin reportar ubicación hace rato). Es una estimación explicable, no una promesa exacta. Read-only, scopeado a tu nodo.",
-      inputSchema: { tracking: z.string().min(1).describe("Tracking del envío a consultar") },
-    }, async ({ tracking }) => run(() => api("GET", `/flujo/envio-estado?tracking=${encodeURIComponent(tracking)}`)));
-    tool("envios_trabados", {
-      title: "Envíos trabados del nodo (para destrabar / cerrar)",
-      description: "Lista los envíos TRABADOS de tu nodo, con el motivo: 'estancado' (mucho tiempo en 'A retirar'/'En centro' sin avanzar, ~nunca despachado), 'sin_mensajero' (en el centro pero sin mensajero asignado), 'mensajero_detenido' (en camino pero el mensajero no reporta ubicación hace rato) o 'en_camino_sin_cerrar' (en camino hace +24h sin cerrarse: candidato a cerrar; confirmá con el usuario antes de marcarlo entregado). Ordenados por severidad. Es la misma detección que alimenta el aviso proactivo a los operativos y admins del nodo. Read-only.",
-      inputSchema: {},
-    }, async () => run(() => api("GET", "/flujo/envios-trabados")));
-    tool("planilla_reporte", {
-      title: "Reporte de la planilla ML (control por foto)",
-      description: "Resumen de los envíos cargados por el método de planilla/control por foto (ml_manual) de tu nodo: total + desglose por CLIENTE, por ZONA y por ESTADO + suma de valor declarado y de monto a cobrar. Opcional: rango de fechas (desde/hasta, YYYY-MM-DD). Read-only.",
-      inputSchema: { desde: zStr().describe("Desde (YYYY-MM-DD), opcional"), hasta: zStr().describe("Hasta (YYYY-MM-DD), opcional") },
-    }, async ({ desde, hasta }) => run(() => api("GET", `/flujo/planilla-reporte${desde || hasta ? `?${new URLSearchParams({ ...(desde ? { desde } : {}), ...(hasta ? { hasta } : {}) }).toString()}` : ""}`)));
-    tool("nodo_provisorio_crear", {
-      title: "Crear un nodo PROVISORIO en un grupo (planilla ML)",
-      description: "Crea al vuelo un nodo PROVISORIO (placeholder) dentro de un grupo logístico, para atribuirle el clearing cuando el nodo real todavía no está dado de alta. No tiene login hasta que se concilie con el nodo real. Solo en grupos a los que pertenece TU nodo (el admin global, en cualquiera). Reusa el clearing por grupo. No mueve dinero.",
-      inputSchema: { nombre: z.string().min(1).describe("Nombre del nodo (ej. 'Nodo Avellaneda - provisorio')"), grupoId: z.number().int().positive().describe("Grupo logístico donde crearlo (de tus grupos)") },
-    }, async (args) => run(() => api("POST", "/flujo/nodo-provisorio", args)));
-    tool("provisorio_conciliar", {
-      title: "Conciliar un nodo provisorio con el nodo real",
-      description: "Cuando el nodo real YA está dado de alta, CONCILIA (fusiona) el provisorio: reatribuye sus envíos (origen/entrega) y su membresía de grupo al nodo real, y marca el provisorio como RESUELTO (queda desactivado). El clearing de esos envíos pasa a usar la tarifa del nodo real en el grupo. Aislamiento: como operador solo conciliás los provisorios que creó TU nodo y contra un nodo real que YA opera en ese grupo; si el nodo real todavía no está en el grupo hay que definirle la tarifa → eso lo hace el admin global con `tarifa`. No mueve dinero (reordena el clearing).",
-      inputSchema: {
-        provisorioId: z.number().int().positive().describe("Id del nodo provisorio a conciliar (lo devolvió `nodo_provisorio_crear`, o lo ves en `grupos_tarifas`)"),
-        nodoReal: z.string().min(1).describe("Nodo real destino: nombre o id (nodo ya dado de alta)"),
-        tarifa: z.object({ cercana: z.number().optional(), media: z.number().optional(), lejana: z.number().optional(), muyLejana: z.number().optional() }).optional().describe("Solo admin global y solo si el nodo real todavía NO opera en el grupo: tarifa (bandas) con la que se lo agrega."),
-        modo: z.enum(["absorber", "desde_ahora"]).optional().describe("absorber (default) = el nodo real se queda con el HISTORIAL del provisorio (reatribuye sus envíos y su grupo). desde_ahora = NO toca el historial; el clearing arranca de acá en adelante."),
-      },
-    }, async (args) => run(() => api("POST", "/flujo/conciliar-provisorio", args)));
-    tool("afiliado_crear", {
-      title: "Crear afiliado",
-      description: "Alta de un afiliado (quien trae volumen nuevo a la red). tipo: nodo|mensajero|externo; refId = id del nodo/mensajero (null si externo). Admin global o admin de nodo (scopeado a tu nodo). NO toca dinero.",
-      inputSchema: { nombre: z.string().min(1), tipo: z.enum(["nodo", "mensajero", "externo"]), refId: z.number().int().optional(), telefono: z.string().optional(), email: z.string().optional() },
-    }, async (args) => run(() => api("POST", "/afiliados", args)));
-    tool("afiliacion_crear", {
-      title: "Crear afiliación (comisión por envío)",
-      description: "Vincula un afiliado con una entidad referida (nodo o cliente) y su comisión RECURRENTE por envío. tipoComision: porcentaje|montoFijo. `porcentaje` se calcula sobre el valorDeclarado del envío (MVP); `montoFijo` = monto por envío. fechaExpiracion opcional (null = no vence). Una entidad = un solo afiliado activo. NO toca dinero (es config).",
-      inputSchema: { afiliado: z.string().min(1).describe("nombre o id"), entidadTipo: z.enum(["nodo", "cliente"]), entidad: z.string().min(1).describe("nombre o id del nodo/cliente referido"), tipoComision: z.enum(["porcentaje", "montoFijo"]), valorComision: z.number(), fechaExpiracion: z.string().optional().describe("YYYY-MM-DD") },
-    }, async (args) => run(() => api("POST", "/afiliados/afiliaciones", args)));
-    tool("afiliacion_editar", {
-      title: "Editar afiliación",
-      description: "Edita una afiliación: valorComision, fechaExpiracion (renovar/extender) y/o activa (des/reactivar). NO toca dinero.",
-      inputSchema: { id: z.number().int().positive(), valorComision: z.number().optional(), fechaExpiracion: z.string().optional().describe("YYYY-MM-DD; vacío = quitar vencimiento"), activa: z.boolean().optional() },
-    }, async ({ id, ...body }) => run(() => api("PUT", `/afiliados/afiliaciones/${id}`, body)));
-    if (esGlobal || esAdminNodo || permisos.includes("finanzas")) { // igual que el gate del backend
-      tool("comision_liquidar", {
-        title: "Liquidar comisiones de afiliado (registra pago)",
-        description: "Marca comisiones devengadas como LIQUIDADAS (registra el pago al afiliado). `ids` = lista de comisiones (de comisiones_afiliado_ver). Requiere permiso de finanzas. Scopeado a tu nodo.",
-        inputSchema: { ids: z.array(z.number().int().positive()).min(1) },
-      }, async ({ ids }) => run(() => api("POST", "/afiliados/comisiones/liquidar", { ids })));
-    }
-  }
-  if (puede("usuarios")) {
-    tool("chofer_crear", {
-      title: "Alta de chofer (mensajero) con clave temporal",
-      description: "Da de alta un chofer (rol mensajero) en TU nodo. El server genera una CLAVE TEMPORAL y la devuelve (pasásela al chofer; debe cambiarla al primer ingreso). Requiere nombre, apellido (por separado, los dos obligatorios), teléfono y email. El admin global elige el nodo con `nodo`.",
-      inputSchema: { nombre: z.string().min(1).describe("Nombre de pila"), apellido: z.string().min(1), telefono: z.string().min(1), email: z.string().min(3), mensajeroNombre: z.string().optional().describe("Nombre para el macheo con su cta cte (default: el nombre)"), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/chofer", { ...rest, logisticaId: nodo })));
-    tool("chofer_editar", {
-      title: "Editar un chofer",
-      description: "Edita un chofer (mensajero) de TU nodo: nombre, apellido, teléfono, mensajeroNombre y/o activo (desactivar/activar). No toca credenciales.",
-      inputSchema: { id: z.number().int().positive(), nombre: z.string().optional(), apellido: z.string().optional(), telefono: z.string().optional(), mensajeroNombre: z.string().optional(), activo: z.boolean().optional() },
-    }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/chofer/${id}`, body)));
-    tool("cliente_generar_usuario", {
-      title: "Generar usuario de login para un cliente/vendedor",
-      description: "Le crea las credenciales de login a un cliente/vendedor YA EXISTENTE de TU nodo (para que entre a su portal). Buscás el cliente por nombre o id (usá `clientes_del_nodo`) y pasás el `email` con el que va a loguear, más `nombre` y `apellido` de la PERSONA que va a usar el acceso (obligatorios; no el nombre de la tienda). El server genera una CLAVE TEMPORAL y la devuelve (pasásela al cliente; debe cambiarla al primer ingreso). Yo nunca invento la clave. Si el cliente ya tiene usuario, avisa (no lo pisa). No da de alta el PERFIL del cliente (eso es `cliente_crear`) ni toca dinero. El admin global acota la búsqueda del cliente a un nodo con `nodo`.",
-      inputSchema: { cliente: z.string().min(1).describe("Nombre o id del cliente/vendedor de tu nodo (de `clientes_del_nodo`)"), email: z.string().min(3).describe("Email con el que va a loguear el cliente"), nombre: z.string().min(1).describe("Nombre de pila de la persona que va a entrar (no el de la tienda)"), apellido: z.string().min(1), telefono: z.string().optional(), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/cliente", { ...rest, logisticaId: nodo })));
-    tool("cliente_resetear_clave", {
-      title: "Resetear la clave de un cliente/vendedor",
-      description: "Genera una CLAVE TEMPORAL NUEVA para un cliente/vendedor de TU nodo que YA tiene usuario de login pero perdió el acceso. El server la genera y la devuelve (pasásela; debe cambiarla al primer ingreso). Si el cliente todavía NO tiene usuario, avisa y sugiere `cliente_generar_usuario`. No toca el perfil del cliente ni dinero. El admin global acota la búsqueda del cliente a un nodo con `nodo`.",
-      inputSchema: { cliente: z.string().min(1).describe("Nombre o id del cliente/vendedor de tu nodo (de `clientes_del_nodo`)"), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/cliente/resetear", { ...rest, logisticaId: nodo })));
-    tool("operador_crear", {
-      title: "Alta de operador de nodo con clave temporal",
-      description: "Da de alta un OPERADOR (staff que administra el nodo: recibe/escanea/despacha, liquida, etc., según los permisos que le des) en TU nodo. El server genera una CLAVE TEMPORAL y la devuelve (pasásela; debe cambiarla al primer ingreso). Requiere nombre, apellido, email y teléfono. `permisos` opcional (default 'logistica'): gestion, finanzas, mensajeros, reportes, logistica, wms, precios, usuarios. El admin global elige el nodo con `nodo`. NO es un vendedor (eso es `cliente_generar_usuario`) ni un chofer (`chofer_crear`); NO otorga jerarquía de admin de nodo (eso es `usuario_habilitar_rol`). Yo nunca invento la clave. No toca dinero.",
-      inputSchema: { nombre: z.string().min(1).describe("Nombre de pila"), apellido: z.string().min(1), email: z.string().min(3).describe("Email con el que va a loguear"), telefono: z.string().min(1), permisos: z.array(z.string()).optional().describe("Secciones habilitadas: gestion, finanzas, mensajeros, reportes, logistica, wms, precios, usuarios. Default: logistica."), nodo: z.number().int().positive().optional().describe("Solo admin global: nodo donde crear el operador. El operador de nodo lo crea en SU nodo.") },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/operador", { ...rest, logisticaId: nodo })));
-    tool("usuario_editar", {
-      title: "Editar datos de un usuario",
-      description: "Corrige nombre, apellido, teléfono y/o email (con el que entra) de un usuario de TU nodo, por id (de `chofer_listar`). Nombre y apellido son obligatorios: si el usuario todavía no los tiene separados, pasá los dos. Cambiar el nombre NO cambia el nombre con el que se le paga al cadete (queda fijo). No toca rol, permisos ni clave.",
-      inputSchema: { id: z.number().int().positive(), nombre: z.string().optional().describe("Nombre de pila"), apellido: z.string().optional(), telefono: z.string().optional(), email: z.string().optional().describe("Email con el que entra (no puede repetirse)") },
-    }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/${id}`, body)));
-    tool("usuario_habilitar_reparto", {
-      title: "Habilitar a un usuario como también mensajero",
-      description: "Marca (o desmarca con activo=false) a un operador/admin de TU nodo como TAMBIÉN mensajero: puede escanear, autoasignarse y entregar además de administrar. No toca credenciales.",
-      inputSchema: { id: z.number().int().positive(), activo: z.boolean().optional().describe("default true") },
-    }, async ({ id, activo }) => run(() => api("PUT", `/usuarios/${id}/reparto`, { activo: activo ?? true })));
-  }
-  if (isStaff) {
-    tool("ruta_publicar", {
-      title: "Publicar una ruta/colecta en el marketplace",
-      description: "Publicá una ruta/colecta/viaje para que CUALQUIER nodo de la red la tome (subasta abierta). VOS le pagás al que la toma. precioMax opcional (tope que ofrecés pagar). No mueve dinero (la obligación se registra al adjudicar).",
-      inputSchema: { titulo: z.string().min(1), tipo: z.enum(["ruta", "colecta", "viaje"]).optional(), descripcion: z.string().optional(), zona: z.string().optional(), precioMax: z.number().optional().describe("En pesos (ARS)") },
-    }, async (args) => run(() => api("POST", "/rutas-publicas", args)));
-    tool("ruta_ofertar", {
-      title: "Ofertar por una ruta pública",
-      description: "Ofertá por una publicación de OTRO nodo: `precio` = lo que cobrás por hacerla (subasta: más barato es mejor para el que publica). Si ya ofertaste, actualiza tu oferta. No podés ofertar en la tuya.",
-      inputSchema: { publicacionId: z.number().int().positive(), precio: z.number().describe("En pesos (ARS)"), nota: z.string().optional() },
-    }, async (args) => run(() => api("POST", `/rutas-publicas/${args.publicacionId}/ofertar`, { precio: args.precio, nota: args.nota })));
-    tool("ruta_adjudicar", {
-      title: "Adjudicar una ruta pública (elegir ganador)",
-      description: "Elegí la oferta ganadora de una publicación TUYA (los ids salen de «ruta_ofertas»). Cierra la subasta: el nodo ganador la toma al precio de su oferta (queda registrada la obligación). NO genera facturación/rendición/comisión ni clearing automático: el pago entre nodos se salda MANUALMENTE (ver «ayuda» tema:facturacion_marketplace).",
-      inputSchema: { publicacionId: z.number().int().positive(), ofertaId: z.number().int().positive() },
-    }, async ({ publicacionId, ofertaId }) => run(() => api("POST", `/rutas-publicas/${publicacionId}/adjudicar`, { ofertaId })));
-  }
-  if (isStaff) {
-    tool("envio_reasignar_cliente", {
-      title: "Reasignar un envío a otro cliente",
-      description: "Mueve UN envío (por tracking) a otro cliente/vendedor de TU nodo cuando se cargó mal. Deja registro en el historial. Igual que la función del frontend.",
-      inputSchema: { tracking: z.string().min(1), cliente: z.string().min(1).describe("nombre o id del cliente destino (de tu nodo)") },
-    }, async (args) => run(() => api("POST", "/envios/reasignar-cliente", args)));
-    tool("envio_mensajero_externo", {
-      title: "Asignar un mensajero EXTERNO a envíos",
-      description: "Registra que uno o varios envíos los hace un mensajero EXTERNO (alguien de AFUERA de la plataforma, que no tiene usuario). Quedan En camino a nombre de esa persona con su valor manual, así la entrega queda trazada y entra igual en la liquidación de mensajeros. Pasá `valorPorEnvio` para fijar cuánto se le paga por envío; si no lo pasás, figuran como FALTA VALOR hasta completarlo. No reasigna envíos ya entregados. No mueve dinero (registra el valor a pagar, no lo paga).",
-      inputSchema: { envioIds: z.array(z.number().int().positive()).describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), nombre: z.string().min(1).describe("Nombre de la persona que hace la entrega"), valorPorEnvio: z.number().optional().describe("Cuánto se le paga por envío"), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/envios/mensajero-externo", { ...rest, logisticaId: nodo })));
-
-    tool("envio_editar_zona", {
-      title: "Corregir zona/localidad/partido/CP de un envío",
-      description: "Corrige o COMPLETA los datos de UN envío (por tracking) para que se pueda cobrar y rutear. Dos usos: (1) CORREGIR un destino mal cargado —dos localidades pisadas ('san martin - Lanús'), el CP con la altura de la calle o con formato roto ('1.832,00')—; (2) COMPLETAR un envío que entró por el ESCANEO DEL QR del vendedor, que trae de quién es el paquete pero NO a dónde va: nace sin destinatario, sin dirección y sin zona, y así se liquida en $0 sin que nadie se entere. Acepta localidad, zona, partido, cp, destinatario, telefono y direccion; recalcula la zona y deja registro en el historial. ⚠️ En un envío YA ENTREGADO los datos del destino se COMPLETAN solo si están vacíos —nunca se pisan, porque cambiarle el destino a algo ya entregado es reescribir la historia—; lo que sí se puede corregir siempre es zona/localidad/partido/CP, que es lo que arregla la liquidación. Los campos que no se pisaron vuelven en `noPisados`. Es un arreglo PUNTUAL de ESE envío: no crea un alias global. Staff: solo envíos de tu nodo. No mueve dinero.",
-      inputSchema: {
-        tracking: z.string().min(1).describe("Tracking del envío a corregir"),
-        localidad: z.string().optional().describe("Localidad real del destino (ej. 'Lanús')"),
-        zona: z.string().optional().describe("Metazona para cobrar/rutear; si no la pasás se deriva de la localidad"),
-        cp: z.string().optional().describe("Código postal real (se guarda solo con dígitos: '1.832,00' → '1832'). Vacío = borrarlo."),
-        partido: z.string().optional().describe("Partido/municipio del destino (para la etiqueta)"),
-      },
-    }, async (args) => run(() => api("POST", "/envios/editar-zona", args)));
-    tool("envio_editar_fecha", {
-      title: "Corregir la fecha de un envío ya cargado",
-      description: "Cambia la FECHA de UN envío (por tracking) que quedó con el día en que se cargó y no con el día en que el paquete se movió — el caso típico: una planilla vieja que se subió sin `fecha`. Es la que define en qué SEMANA se le liquida al vendedor, así que corregirla mueve el envío de período. No admite fecha futura, y si el período ya está liquidado te lo rechaza con el número de liquidación (rehacerla es decisión tuya, no un efecto colateral). El primer estado del historial se mueve con el envío; los demás quedan como se registraron. Solo staff, y solo envíos de tu nodo (admin global: cualquiera). No mueve dinero.",
-      inputSchema: {
-        tracking: z.string().min(1).describe("Tracking del envío a corregir"),
-        fecha: z.string().min(1).describe("Fecha real del envío (dd/mm/aaaa o aaaa-mm-dd). No se admite futura."),
-      },
-    }, async (args) => run(() => api("POST", "/envios/editar-fecha", args)));
-    tool("envio_asignar_grupo", {
-      title: "Asignar un envío a un grupo logístico (despachar)",
-      description: "Asigna/rutea UN envío (por tracking) a un GRUPO logístico tuyo (por NOMBRE o id) — igual que la acción 'Asignar grupo' del escáner. Define con qué grupo salió (tarifa del clearing) y, si el envío TODAVÍA NO SALIÓ, lo DESPACHA: pasa a 'En camino' (sale del centro de distribución) y el vendedor lo ve así. Si el envío YA está 'Entregado' o 'En camino', NO se le toca el estado ni se le agrega un evento: solo queda registrado con qué grupo salió — por eso sirve para corregir el clearing de una planilla vieja ya entregada (mirá `estadoIntacto` en la respuesta). Si ya estaba en ese grupo te lo dice (`yaEstaba`) y no reescribe nada. Acepta VARIOS códigos separados por coma o salto de línea y devuelve el resumen. Solo grupos a los que pertenece tu nodo (el admin global, cualquiera) y envíos de tu nodo. No mueve dinero (el clearing es config).",
-      inputSchema: { tracking: z.string().min(1).describe("Tracking del envío. Podés mandar VARIOS separados por coma o salto de línea (un QR de ML crudo va solo, no se parte)"), grupo: z.string().min(1).describe("Nombre o id del grupo logístico de tus grupos (ej. 'Portela', 'Bonorino')") },
-    }, async (args) => run(() => api("POST", "/envios/asignar-grupo-ref", args)));
-    tool("cobro_corregir", {
-      title: "Corregir el monto de un cobro",
-      description: "Ajusta el monto a cobrar contra entrega de un envío (cuando se cobró de más o de menos), guardando el monto ORIGINAL en el historial. envioId + monto nuevo. No mueve dinero en cuentas (corrige el dato del envío).",
-      inputSchema: { envioId: z.number().int().positive().describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), monto: z.number().describe("En pesos (ARS)"), motivo: z.string().optional() },
-    }, async ({ envioId, monto, motivo }) => run(() => api("POST", `/envios/${envioId}/corregir-cobro`, { monto, motivo })));
-    tool("rendicion_revertir", {
-      title: "Revertir una rendición (marcada por error)",
-      description: "Revierte un cobro/cambio marcado como 'rendido' cuando en realidad NO se rindió → vuelve a 'a rendir'. Deja registro (quién/cuándo). envioId + tipo (cobro|cambio). Scopeado a tu nodo.",
-      inputSchema: { envioId: z.number().int().positive().describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), tipo: z.enum(["cobro", "cambio"]), motivo: z.string().optional() },
-    }, async (args) => run(() => api("POST", "/flujo/rendicion/revertir", args)));
-  }
-  if (puede("gestion")) {
-    tool("colecta_configurar", {
-      title: "Configurar valor de colecta",
-      description: "Setea un valor de colecta según alcance: 'nodo' = pago default del nodo (ej. $3000); 'mensajero' = default de ese mensajero (ej. $4000, cualquier colecta); 'cliente' = cuánto se le COBRA al vendedor (idCliente + valor, opcional minEnvios); 'par' = pago pactado a un mensajero por colectar a un cliente (idCliente + mensajero + valor). Scopeado a tu nodo (el admin global elige el nodo con `nodo`). No mueve dinero (config de tarifa).",
-      inputSchema: {
-        alcance: z.enum(["nodo", "mensajero", "cliente", "par"]),
-        valor: z.number(),
-        idCliente: z.string().optional(),
-        mensajero: z.string().optional().describe("Nombre del mensajero (de tu nodo)"),
-        minEnvios: z.number().optional().describe("Solo alcance=cliente: mínimo de envíos para colecta sin cargo"),
-        nodo: zNodo(),
-      },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/config", { ...rest, logisticaId: nodo })));
-
-    tool("colecta_fija", {
-    title: "Colecta fija de un vendedor (días)",
-    description: "Define la COLECTA FIJA de un vendedor: los días en que se lo va a buscar SIEMPRE, tenga o no envíos cargados. Es para los que no vinculan sus cuentas ni cargan envíos — los paquetes entran cuando el cadete los escanea en la puerta. Aparecen solos en `colecta_pendientes` esos días. `dias` acepta números (0=domingo … 6=sábado) o nombres (lunes, martes…); `dias:[]` quita la colecta fija. Config de AGENDA, no de dinero.",
-    inputSchema: { idCliente: z.string().describe("id del cliente (de clientes_del_nodo)"), dias: z.array(z.union([z.number(), z.string()])).describe("Días: [1,2,3,4,5] o [\"lunes\",\"miércoles\"]. [] = quitar."), nodo: zNodo() },
-  }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/fija", { ...rest, logisticaId: nodo })));
-
-  tool("colecta_asignar", {
-      title: "Asignar una colecta a un mensajero",
-      description: "Asigna la colecta (retiro de mercadería) de un cliente a un mensajero, ambos por NOMBRE de tu nodo (ej. «que Maxi levante al cliente Distri Sur»). Vincula los envíos 'A retirar' de ese cliente a la colecta y avisa al mensajero. FUNCIONA AUNQUE EL CLIENTE NO TENGA ENVÍOS CARGADOS (vendedores que no vinculan sus cuentas): se crea la colecta vacía y el cadete escanea cada paquete en la puerta — los que no están en el sistema se crean solos a nombre del vendedor, sin contar dos veces el mismo QR. Si el corte venció, la programa para el próximo día hábil. No mueve dinero (es logística). El admin global acota la resolución por nombre con `nodo`.",
-      inputSchema: {
-        cliente: z.string().min(1).describe("Nombre del cliente/vendedor a colectar"),
-        mensajero: z.string().min(1).describe("Nombre del mensajero (de tu nodo) que hace el retiro"),
-        nodo: zNodo(),
-      },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/asignar-por-nombre", { ...rest, logisticaId: nodo })));
-
-    tool("retiros_cargar", {
-      title: "Cargar la lista de retiros del día",
-      description: "Carga de una vez la LISTA DE RETIROS (colectas) del día: le pasás las direcciones y crea un retiro por cada una. OJO, no confundir con `colecta_asignar`, que es ir a levantarle los paquetes a UN vendedor; esto es la ronda de paradas donde el cadete va a BUSCAR (no tienen destinatario ni teléfono, solo dirección). Si vienen numeradas ('1. Helguera 936'), el número se usa como orden de ruta y se saca de la dirección. `zona` es la que cobra y paga por la tabla Retiros ('Retiro en CABA' o 'Retiro en GBA'): no la inventes. El cadete se asigna a TODA la lista y se escribe también el nombre por el que se le PAGA (el resumen de pago agrupa por nombre, no por el vínculo). Si mandás dos veces la misma dirección para el mismo cliente y día, no se duplica: vuelve en `duplicados`. Quedan en 'A retirar'; para cerrarlas usá `envio_completar_ciclo`. No mueve dinero: registra el trabajo, no lo paga.",
-      inputSchema: {
-        cliente: z.string().min(1).describe("Cliente al que se le cargan los retiros (nombre o id, de tu nodo)"),
-        direcciones: z.array(z.string().min(1)).min(1).describe("Una dirección por elemento, en el orden de la ruta. Pueden venir numeradas ('1. Helguera 936, CABA') o sueltas."),
-        zona: z.string().optional().describe("'Retiro en CABA' (default) o 'Retiro en GBA'. Es la metazona que cobra y paga."),
-        mensajero: zStr().describe("Nombre o id de quien hace TODA la ronda. Si el nombre matchea a varios, te los lista con su id en vez de elegir por vos."),
-        fecha: zStr().describe("dd/mm/aaaa o aaaa-mm-dd si NO es hoy (define la semana en que se liquida). No admite fecha futura."),
-        nodo: zNodo(),
-      },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/retiros", { ...rest, logisticaId: nodo })));
-
-    tool("colecta_desasignar", {
-      title: "Desasignar una colecta",
-      description: "Quita la asignación de una colecta (los envíos vuelven a 'sin colecta'). El colectaId lo devuelve «colecta_pendientes». Solo colectas de tu nodo (el admin global puede acotar con `nodo`). No mueve dinero.",
-      inputSchema: { colectaId: z.number().int().positive(), nodo: zNodo() },
-    }, async ({ colectaId, nodo }) => run(() => api("POST", "/colecta/desasignar", { colectaId, logisticaId: nodo })));
-
-    tool("procesar_zona", {
-      title: "Aceptar envíos ruteados por zona",
-      description: "ACEPTA (recibe en tu nodo) los envíos que otros nodos te rutearon por zona — los ids salen de «envios_por_zona». Opcional: mensajeroId para asignarlos a un mensajero puntual de esa zona. No mueve dinero (el clearing es config). El admin global elige el nodo receptor con `nodo`.",
-      inputSchema: { envioIds: z.array(z.number().int().positive()).min(1), mensajeroId: z.number().int().positive().optional(), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/procesar-zona", { ...rest, logisticaId: nodo })));
-
-    tool("rechazar_zona", {
-      title: "Rechazar envíos ruteados por zona",
-      description: "RECHAZA (declina) envíos que te rutearon por zona: dejan de aparecerte y quedan para el nodo de origen u otros nodos de la zona. No cambia el estado del envío. Los ids salen de «envios_por_zona». El admin global elige el nodo con `nodo`.",
-      inputSchema: { envioIds: z.array(z.number().int().positive()).min(1), motivo: z.string().optional(), nodo: zNodo() },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/rechazar-zona", { ...rest, logisticaId: nodo })));
-
-    tool("cliente_crear", {
-      title: "Crear cliente / vendedor",
-      description: "Da de alta un cliente en TU nodo (el backend fuerza el nodo). Podés asignarle la lista de precio con idLista. No toca dinero. El admin global elige el nodo con `nodo`.",
-      inputSchema: {
-        nombre: z.string().min(1).describe("Nombre del cliente"),
-        telefono: z.string().optional(),
-        dni: z.string().optional(),
-        direccion: z.string().optional(),
-        idLista: z.string().optional().describe("ID de la lista de precios a asignar (ej. 'B'). Consultá 'clientes_del_nodo' / 'precios_ver'. Si falta, el alta queda incompleta."),
-        nodo: zNodo(),
-      },
-    }, async ({ nodo, ...rest }) => {
-      const r = await api("POST", "/gestion/clientes", { ...rest, logisticaId: nodo });
-      const base = toResult(r);
-      // Hint de completitud (Fase A): sin lista de precios el alta está a medias → guío el próximo paso.
-      if (r.ok && !rest.idLista) {
-        base.content.push({ type: "text", text: "\n⚠️ FALTA LA LISTA DE PRECIOS — el alta está incompleta.\nPreguntale al operador: «¿qué le cobrás a este cliente?»\n • ¿La lista OFICIAL de Flex (la que usan todos)?\n • ¿Un precio PROPIO? Mirá las disponibles con `precios_ver` (el nombre está en 'referencia'); si es nueva, se crea en Precios con un nombre para reusarla.\nAsigná la lista con `cliente_editar idLista:<id>`. Ver `flujo alta_cliente`." });
-      }
-      return base;
-    });
-
-    tool("cliente_editar", {
-      title: "Editar cliente (solo lo que pasás)",
-      description: "Edita un cliente de TU nodo cambiando SOLO lo que pasás: lo que no mandás queda como está. Para VACIAR un campo mandalo vacío (\"\"). `email` cambia el email con el que ENTRA el usuario del cliente (tiene que tener usuario generado; requiere permiso de usuarios; no puede repetirse). No toca dinero. El admin global puede mover el cliente a otro nodo con `nodo`.",
-      inputSchema: {
-        id: z.number().int().positive().describe("ID del cliente (de clientes_del_nodo)"),
-        nombre: z.string().optional().describe("Solo si lo querés cambiar"),
-        nombreFantasia: z.string().optional(),
-        idLista: z.string().optional().describe("Lista de precios a asignar"),
-        telefono: z.string().optional(),
-        email: z.string().optional().describe("Email con el que entra su usuario"),
-        dni: z.string().optional(),
-        direccion: z.string().optional(),
-        mensajeroNombre: z.string().optional().describe("Nombre con el que cobra si también reparte"),
-        activo: z.boolean().optional(),
-        nodo: zNodo(),
-      },
-    }, async ({ id, nodo, ...body }) => run(() => api("PATCH", `/gestion/clientes/${id}`, { ...body, ...(nodo !== undefined ? { logisticaId: nodo } : {}) })));
-    tool("sucursales_cliente", {
-      title: "Sucursales de un cliente (con su perfil de zona)",
-      description: "Lista las sucursales (puntos de retiro) de un cliente de TU nodo con su id, nombre, dirección y PERFIL DE ZONA. Sirve para ver/ajustar con qué perfil cotiza cada sucursal (útil cuando un cliente tiene sucursales en zonas distintas). Solo lectura.",
-      inputSchema: { cliente: z.number().int().positive().describe("id del cliente (de `clientes_del_nodo`)") },
-    }, async ({ cliente }) => run(() => api("GET", `/zonificacion/sucursales${q({ cliente })}`)));
-    tool("sucursal_perfil", {
-      title: "Setear el perfil de zona de una sucursal",
-      description: "Define (o limpia con perfilZona vacío) el PERFIL DE ZONA de una sucursal — con eso la liquidación cotiza los envíos que salen de esa sucursal según SU distancia (no la del cliente). El id de la sucursal sale de `sucursales_cliente`. Perfil vacío = la sucursal hereda el perfil del cliente. Config de staff (NO lo toca el vendedor); no mueve dinero, pero afecta el tramo/precio.",
-      inputSchema: { sucursalId: z.number().int().positive().describe("id de la sucursal (de `sucursales_cliente`)"), perfilZona: z.string().optional().describe("nombre del perfil (ej. GENERAL, MORENO). Vacío = hereda el del cliente.") },
-    }, async ({ sucursalId, perfilZona }) => run(() => api("POST", "/zonificacion/sucursal-perfil", { sucursalId, perfilZona: perfilZona ?? null })));
-  }
-
-  if (puede("finanzas")) {
-    tool("liquidacion_excluir_envio", {
-      title: "No cobrar un envío de una liquidación",
-      description:
-        "Saca UN envío (por tracking) del cobro de una liquidación YA emitida y re-suma el total, ajustando el cargo en la cuenta corriente del cliente. El `motivo` es OBLIGATORIO: queda en el historial del envío y el vendedor lo ve en su portal. Si esa liquidación ya está en una factura de ARCA emitida, lo rechaza (haría falta una nota de crédito, que el sistema no emite). Scopeada a tu nodo.",
-      inputSchema: {
-        id: z.number().int().positive().describe("id de la liquidación"),
-        tracking: z.string().min(1),
-        motivo: z.string().min(10).describe("Por qué no se le cobra. Lo lee el vendedor."),
-      },
-    }, async ({ id, tracking, motivo }) => run(() => api("POST", `/liquidaciones/anteriores/${id}/excluir`, { tracking, motivo })));
-    tool("liquidacion_reincluir_envio", {
-      title: "Volver a cobrar un envío de una liquidación",
-      description:
-        "Lo inverso de `liquidacion_excluir_envio`: devuelve al cobro un envío que se había excluido, re-suma y ajusta la cuenta corriente. El `motivo` es OBLIGATORIO. Mismo guard de factura emitida.",
-      inputSchema: {
-        id: z.number().int().positive().describe("id de la liquidación"),
-        tracking: z.string().min(1),
-        motivo: z.string().min(10).describe("Por qué sí se le cobra."),
-      },
-    }, async ({ id, tracking, motivo }) => run(() => api("POST", `/liquidaciones/anteriores/${id}/reincluir`, { tracking, motivo })));
-    tool("facturacion_preparar_cliente", {
-      title: "Dejar un cliente listo para facturar",
-      description:
-        "Carga los datos fiscales de un cliente y lo habilita: CUIT, razón social (el TITULAR del CUIT, NO el nombre de fantasía), condición frente al IVA, en qué CUENTA cobra (eso define con qué CUIT se le factura) y si factura semanal o mensual. El corte queda en HOY salvo que pases 'desde': lo anterior se facturó por fuera del sistema y volver a emitirlo sería un comprobante duplicado. NO emite comprobantes — el MCP no factura; después se emite desde la PWA o desde el portal del cliente. Preguntá TODOS los datos antes de ejecutar: no inventes un CUIT ni una razón social. Ver el flujo 'facturacion'.",
-      inputSchema: {
-        cliente: z.string().min(1).describe("Nombre o id del cliente"),
-        cuit: z.string().min(1).describe("CUIT del cliente, 11 dígitos"),
-        razonSocial: z.string().min(1).describe("Razón social / titular del CUIT, como figura en ARCA"),
-        condicionIVA: z.string().min(1).describe("RI | MONOTRIBUTO | EXENTO | CONSUMIDOR_FINAL"),
-        cuentaCobro: z.string().optional().describe("Nombre o id de la cuenta de dinero donde cobra (define quién factura)"),
-        frecuencia: z.string().optional().describe("Semanal (default) o Mensual"),
-        desde: z.string().optional().describe("Corte YYYY-MM-DD; vacío = hoy"),
-      },
-    }, async (a) => run(() => api("POST", "/afip/preparar-cliente", a)));
-  }
-
-  if (puede("wms") && wmsActivo) {
-    tool("producto_crear", {
-      title: "Crear producto (WMS)",
-      description: "Alta de un producto en el catálogo del depósito. Staff puede indicar el cliente dueño con idCliente. No toca dinero. El admin global elige el nodo con `nodo`.",
-      inputSchema: {
-        nombre: z.string().min(1),
-        sku: z.string().optional(),
-        codigoBarra: z.string().optional(),
-        peso: z.number().optional(),
-        volumen: z.number().optional(),
-        idCliente: z.string().optional().describe("idCliente dueño del producto"),
-        nodo: zNodo(),
-      },
-    }, async ({ nodo, ...rest }) => run(() => api("POST", "/wms/productos", { ...rest, logisticaId: nodo })));
-  }
-
-  if (esGlobal) {
-    tool("nodo_crear", {
-      title: "Crear nodo (logística)",
-      description: "Da de alta un nodo/logística nuevo. Solo admin global. No toca dinero.",
-      inputSchema: {
-        nombre: z.string().min(1).describe("Nombre del nodo/logística"),
-        telefono: z.string().optional(),
-      },
-    }, async ({ nombre, telefono }) => run(() => api("POST", "/logisticas", { nombre, telefono: telefono ?? null })));
-  }
-}
-
-// ============================================================================
-//  EDICIÓN DE PRECIOS (flag aparte · sensible pero NO mueve dinero).
-// ============================================================================
-if (ALLOW_PRECIOS && puede("precios")) {
-  tool("precio_actualizar", {
-    title: "Actualizar precio de una lista (versionado)",
-    description: "Cambia los precios por zona de una lista creando una VERSIÓN nueva (histórico exacto). Requiere permiso 'precios'; el backend impide tocar listas de otro nodo. No mueve dinero. El admin global elige el nodo de la lista con `nodo`.",
-    inputSchema: {
-      idLista: z.string().min(1).describe("ID de la lista (ej. 'B'). Ver 'precios_ver'."),
-      cercana: z.number().optional().describe("Precio zona cercana, en pesos (ARS)"),
-      media: z.number().optional().describe("Precio zona media, en pesos (ARS)"),
-      lejana: z.number().optional().describe("Precio zona lejana, en pesos (ARS)"),
-      muyLejana: z.number().optional().describe("Precio zona muy lejana, en pesos (ARS)"),
-      referencia: z.string().optional(),
-      vigenciaDesde: z.string().optional().describe("Fecha YYYY-MM-DD desde cuándo rige (default: hoy)"),
-      nodo: zNodo(),
-    },
-  }, async ({ nodo, ...rest }) => run(() => api("POST", "/precios/clientes/version", { ...rest, logisticaId: nodo })));
-}
-
-// Ayuda integrada — se registra al final para que el índice conozca TODOS los tools
-// que este usuario tiene según su rol/permisos. Solo lectura de documentación.
-tool("ayuda", {
-  title: "Ayuda / documentación de las herramientas",
-  description: "Documentación de las herramientas del MCP: sin argumentos = índice de lo que podés usar; `tool` = ficha de una herramienta (qué hace, cómo usarla, ejemplo, qué NO hace); `tema` = tópico transversal (facturacion_marketplace, dinero, aislamiento). Consultalo antes de asumir cómo funciona algo.",
-  inputSchema: { tool: z.string().optional().describe("Nombre de una herramienta, ej. ruta_adjudicar"), tema: z.string().optional().describe("facturacion_marketplace | dinero | aislamiento") },
-}, async ({ tool: t, tema }) =>
-  ({ content: [{ type: "text", text: renderAyuda(t || tema, { version: MCP_VERSION, disponibles: registrados }) }] }));
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
-const cap = isCliente ? "cliente" : esGlobal ? "admin global" : isStaff ? "staff de nodo" : "sin identidad";
-log(`MCP Nexus Flex v3 listo. Rol: ${cap}. Escritura: ${ALLOW_WRITE ? "ON" : "off"} · Precios: ${ALLOW_PRECIOS ? "ON" : "off"}.`);
+#!/usr/bin/env node
+// ============================================================================
+//  MCP Nexus Flex v3 — servidor stdio (paquete publicable en npm).
+//
+//  INSTALACIÓN FÁCIL:  npx -y nexusflex-mcp@latest         (arranca el server)
+//                      npx -y nexusflex-mcp@latest login   (autoriza en el navegador)
+//                      npx -y nexusflex-mcp@latest logout  (borra el token local)
+//
+//  AUTENTICACIÓN por DEVICE-FLOW (autorización web): sin pegar email/contraseña.
+//  El MCP pide un código, lo autorizás con un click desde la web ya logueado, y
+//  recibe un token de vida larga, revocable y con TU scope exacto (nunca dinero).
+//  Fallback: NEXUSFLEX_TOKEN o NEXUSFLEX_EMAIL+PASSWORD (compatibilidad).
+//
+//  AISLAMIENTO EN 3 CAPAS:
+//   1) El BACKEND gatea cada endpoint (requireAuth + requirePermiso + scope por
+//      nodo / idCliente). Un token de MCP hereda el rol/permisos FRESCOS del
+//      usuario en cada request. Es la garantía real.
+//   2) Este server registra los tools SEGÚN EL ROL del usuario (leído de /auth/me).
+//   3) DENYLIST de dinero en api.mjs + guard server-side (mcpMoneyGuard): jamás
+//      liquidaciones/cobros/cuentas/facturación.
+//
+//  Escritura por flags (default OFF):
+//   NEXUSFLEX_MCP_ALLOW_WRITE   → altas (clientes, productos, nodos) y edición.
+//   NEXUSFLEX_MCP_ALLOW_PRECIOS → actualizar listas de precios (aparte, sensible).
+// ============================================================================
+import { runDeviceFlow, saveToken, clearToken, tokenFilePath } from "./device-auth.mjs";
+import { api, log, API_URL } from "./api.mjs";
+import { renderAyuda, guiaOnboarding, renderFlujo, FLUJOS } from "./docs.mjs";
+
+// --- Subcomandos de línea de comando (login/logout) antes de arrancar el server ---
+const cmd = process.argv[2];
+if (cmd === "login") {
+  try {
+    const token = await runDeviceFlow(API_URL, { open: true, log });
+    const file = saveToken(token, API_URL);
+    log(`Token guardado en ${file}. Ya podés usar el MCP en Claude Desktop.`);
+    process.exit(0);
+  } catch (e) {
+    log("No se pudo autorizar:", e instanceof Error ? e.message : String(e));
+    process.exit(1);
+  }
+}
+if (cmd === "logout") {
+  clearToken();
+  log(`Token local borrado (${tokenFilePath()}). Revocá también desde la web (🔌 Conexiones) si querés cortar el acceso ya emitido.`);
+  process.exit(0);
+}
+
+const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = await import("zod");
+
+const truthy = (v) => /^(1|true|yes|si|sí)$/i.test(v ?? "");
+const ALLOW_WRITE = truthy(process.env.NEXUSFLEX_MCP_ALLOW_WRITE);
+const ALLOW_PRECIOS = truthy(process.env.NEXUSFLEX_MCP_ALLOW_PRECIOS);
+
+// ATADO CON: backend/src/services/mcp-remote.ts (MCP_VERSION + NOVEDADES + mismos tools, salvo SOLO_REMOTO)
+// y mcp/package.json. Lo verifica backend/src/coherencia.test.ts. Ver CLAUDE.md → "Cosas que van juntas".
+const MCP_VERSION = "3.74.0"; // bumpear junto con package.json + backend/services/mcp-remote.ts
+const NOVEDADES = [
+  "3.74.0 — RECLAMOS DE VENDEDORES: nuevo `reclamo_responder` (responder, cerrar o reabrir el reclamo que un vendedor dejó sobre su liquidación; la respuesta la lee en su portal). Se usa junto con `liquidacion_excluir_envio` / `liquidacion_reincluir_envio`: primero corregís el cobro, después contestás con el nuevo total. Es lo mismo que la pantalla Reclamos de vendedores. Además `liquidacion_cobro_parcial`: cuando el comprador pagó en destino MENOS que el flete (ej. zona media cobrada como cercana), lo cobrado se da por pagado y el envío sigue en la liquidación por la diferencia; con `montoCobrado` 0 se quita el ajuste. Y el cierre automático de un reclamo ya no responde con un solo envío y un total viejo: espera a que estén atendidos todos los envíos del reclamo. Además la app y el MCP validan que el reclamo sea de un cliente de TU nodo. Solo texto y estado: no mueve dinero. Requiere permiso finanzas.",
+  "3.73.0 — CONTROL POR FOTO MÁS SEGURO: el MCP de la PC solo puede leer y crear adentro de UNA carpeta, la que elegís al instalar el plugin de Nexus Flex (si no elegís ninguna: Documentos\\Control por foto, que se crea sola). `control_foto_preparar`, `control_foto_carpeta` y `control_foto_foto` toman las rutas desde ahí (podés pasar solo 'Lunes 14-9-2026') y rechazan cualquier ruta de afuera o un acceso directo que apunte afuera. `control_foto_estructura` te dice cuál es la carpeta. No mueve dinero.",
+  "3.72.0 — CONTROL POR FOTO POR CARPETAS, para cualquier nodo y cualquiera de sus grupos. `control_foto_preparar` (MCP local) te crea las carpetas del día (o de varios) con los nombres exactos de tus grupos y cadetes. Armás una carpeta por día con DADOS/<grupo> (lo que pasaste a un grupo), DADOS/<cadete> (lo repartió un cadete tuyo), RECIBIDOS/…/<cadete> (te lo dio otro nodo y lo repartió tu cadete) y RECIBIDOS/<grupo> (te lo dieron y lo derivaste por ese grupo). `control_foto_carpeta` (MCP local) recorre la carpeta, lee el QR de cada foto (o la IA de etiquetas), busca o da de alta el envío SIN duplicar, lo asigna al responsable de zona / cadete / grupo, lo lleva a Entregado en el día real y le cuelga la foto (la que ven los nodos en su cuenta semanal). Primero simula y te devuelve las preguntas (cuentas de ML desconocidas, zonas con varios responsables, duplicados); se contestan con `control_foto_foto` o, más cómodo, en la app: Logística → 📷 Control por foto (ahí también quedan los envíos SIN VENDEDOR para asignarles el cliente o el nodo que te los dio; «recordar» asocia la cuenta de ML para la próxima, salvo que sea compartida entre logísticas). `control_foto_estructura` te dice qué nombres de carpeta valen. Nada sale de tu red (tu nodo + los de tus grupos). No mueve dinero.",
+  "3.71.0 — Habilitadas por el dueño: `liquidacion_excluir_envio` / `liquidacion_reincluir_envio` (sacar o devolver UN envío del cobro de una liquidación emitida, con motivo obligatorio) y `facturacion_estado` / `facturacion_preparar_cliente` (qué falta para facturar y cargar los datos fiscales de un cliente) ya funcionan por MCP: el filtro de dinero las deja pasar con su método exacto. Siguen sin pagar, cobrar ni emitir comprobantes, y piden permiso finanzas. Además `mis_envios` ahora sí filtra por `estado`.",
+  "3.70.0 — Descripciones al día: textos de las herramientas corregidos para que digan lo que hacen hoy (`envio_entregar`, `envio_asignar_mensajero`, `generar_enlace_vinculacion` vence en 48 hs, `grupo_miembros` y `provisorio_conciliar` apuntan a `grupos_tarifas`), `flujo` lista todos los flujos disponibles, `sugerencias_listar` solo para el superadmin, `envio_cargar` exige `telefono`, parámetros con formato (fechas YYYY-MM-DD, montos en ARS, nombre o id) y las instrucciones del conector más cortas (la guía sigue en `guia`). `liquidacion_excluir_envio`/`reincluir` avisan que hoy el filtro de dinero los bloquea por MCP (se hace desde la PWA).",
+  "3.69.1 — AYUDA completa: `ayuda` ahora tiene la ficha (qué hace, cómo usarlo, ejemplo, qué NO hace) de los 20 tools que no la tenían (cierre semanal, zonas de grupo, tarifas de grupo, sin vendedor, corregir estado, pago al cadete, retiros…) y los 26 que no aparecían en el índice. La ayuda del paquete npm se genera desde la del conector, así que ya no se desincronizan. No mueve dinero.",
+  "3.69.0 — Control por foto de la TANDA DE UN CADETE (propios + de otros nodos mezclados): en `envio_desde_etiqueta_ml` alcanza con el `mlQr` crudo — de ahí sale el número de ML y el vendedor, y el vendedor se reconoce igual que en el escáner (cuenta vinculada O cuenta aprendida en juntadas/escaneos; antes solo la vinculada). `nodoEntrega` ya no necesita `grupo`: si el cliente es del mismo nodo que entrega es un paquete propio (sin traspaso) y si es de otro nodo se usa el grupo que comparten. Si no conoce al vendedor, contesta 404 con el senderId para que preguntes de qué nodo/cliente es. Si el envío ya existía, no lo duplica: lo completa y lo avanza. No mueve dinero.",
+  "3.68.0 — Control por foto: `envio_desde_etiqueta_ml` acepta `nodoEntrega` (nombre o id de un nodo del `grupo`) = el nodo que RECIBIÓ y entregó el paquete. Con `fecha` + `grupo` + `nodoEntrega` una planilla atrasada entra al CIERRE SEMANAL entre nodos en su día real (ej. 5 envíos de un cliente de Envíos Frank que entregó FastCorreo el lunes 14: fecha 14/09, grupo Portela, nodoEntrega FastCorreo). Antes solo se ponía con `autoRutear` y si la zona tenía un único responsable; si no, quedaba fuera del cierre. Si el envío ya tenía OTRO nodo que entrega no se pisa (avisa). Si la semana ya cerró, entra en el cierre siguiente marcado como tarde, con su fecha real. No mueve dinero.",
+  "3.67.0 — TARIFA de grupo de una: `grupo_tarifa_set` fija la tarifa de clearing por zona (cercana/media/lejana/muyLejana) de TODO un grupo — el default del grupo y el precio de cada nodo miembro — en una sola llamada, sin ir nodo por nodo (ej. dejar un grupo nuevo en 2700 los 4 tramos). Con `soloDef` toca solo el default. Solo la comisión (admin) del grupo o el admin global. Es config del clearing, no mueve dinero.",
+  "3.66.0 — COMPOSICIÓN de zonas de grupo: `zona_mover_metazona` reclasifica una metazona/localidad de una zona de grupo a otra del mismo grupo sin tocar el nodo responsable (ej. 'El Palomar' mal puesto en Morón → Tres de Febrero). `zona_componer_grupo` crea/edita una zona de grupo agregando/quitando metazonas y sumándole un nodo responsable — sirve para armar las zonas de un grupo NUEVO con su composición completa (el ruteo matchea por metazona exacta, así que una zona de CABA necesita 'CABA · Barrio' y 'Barrio'). Solo la comisión (admin) del grupo o el admin global.",
+  "3.65.0 — SIN VENDEDOR: `sin_vendedor` muestra las cuentas de Mercado Libre y los envíos cargados con foto que tu nodo tiene sin vendedor (por ejemplo, un nodo recién dado de alta con etiquetas de cuentas no vinculadas ya escaneadas), y `asignar_sin_vendedor` los asigna a UN vendedor en un paso: asocia cada cuenta, le pasa todos sus envíos, le crea el usuario si hace falta y devuelve un enlace de vinculación por cuenta. Cuando el vendedor autoriza el enlace, lo que quedaba de esa cuenta se le engancha solo.",
+  "3.64.1 — FRENO DE DUPLICADOS en `envio_desde_etiqueta_ml` (sin número de ML) y `envio_cargar`: si el cliente ya tiene un envío a esa dirección ese día (±1), responde POSIBLE DUPLICADO nombrándolo (15/09 se cargaron 44 paquetes a mano que ya estaban por planilla y se cobraron dos veces). Si es otro paquete, repetí con `forzarNuevo:true`. Con número de ML, si difiere en un dígito de otro envío del mismo comprador, avisa en `advertencias`.",
+  "3.64.0 — CIERRE SEMANAL entre nodos (juntada): la semana de lunes a sábado se congela sola el miércoles siguiente a las 06:00. Cada paquete que un nodo le pasó a otro esa semana (entregado o no) vale la tarifa del que lo recibe, y por nodo se netea. Lo cerrado no se recalcula; lo que se cargue tarde entra en el cierre siguiente con su fecha. Lo que daría $0 (sin tarifa) no entra y se avisa. Nuevo `cuenta_semanal_nodos` y `cierre_semanal_links` (admin global). Arranca con la semana del 14 al 19/09.",
+  "3.63.0 — Responsable de zona PENDIENTE → FIRME: al despachar por grupo desde el escáner, el responsable de la zona (elegido en el popup, o automático si hay uno solo) queda PENDIENTE de confirmar, y recién queda FIRME cuando ese nodo lo recibe de verdad (lo procesa). Nuevo `nodo_link_confirmacion`: link FIJO sin login para un nodo que no tiene usuarios propios (un 'feeder' que solo deja paquetes en la juntada) — ve sus pendientes y los confirma con un toque. Se lo pasás por WhatsApp a mano.",
+  "3.62.0 — `nodo_renombrar` (solo admin global): cambia la razón social REAL de un nodo (la ve todo el mundo), a diferencia de `nodo_alias_poner` que es un apodo personal. Reusa la validación existente (nombre no vacío, sin repetir otro nodo) y renombra la marca si coincidía con el nombre viejo.",
+  "3.61.0 — `nodo_alias_poner`: le ponés TU propio apodo a un nodo (ej. 'Flex Fácil' = 'Félix', el dueño) para reconocerlo más fácil — es personal, no lo ve otro usuario ni cambia el nombre real. De ahí en más lo podés nombrar por ese apodo en `asignar_nodo_zona` y en los buscadores de la app. Alias vacío lo saca.",
+  "3.60.0 — Responsable de zona POR GRUPO logístico (Bonorino, Portela…): `asignar_nodo_zona` con `grupo` pasa a MODO COMISIÓN — la zona es del grupo, no de un nodo dueño, y solo un admin de ESE grupo (o el admin global) puede asignarla o reasignarla. Nuevo `zona_dejar`: el nodo responsable se saca solo (self-service) de una zona de grupo; si era el único, queda LIBERADA y se avisa a TODO el grupo, pero solo la comisión la puede volver a asignar. Nuevo `zonas_grupo`: lista las zonas de un grupo con quién las cubre y cuáles están liberadas.",
+  "3.59.0 — `cliente_editar` ya NO pisa el cliente: cambia solo los campos que le pasás (antes, cargarle el teléfono le borraba la lista de precios, el DNI y el nombre con el que cobra). Para vaciar un campo, mandalo vacío. Nuevo: `email` cambia el email con el que entra el usuario del cliente. `nombre` dejó de ser obligatorio.",
+  "3.58.0 — `colecta_historial`: cuántos paquetes se colectaron por día y por cliente en una fecha o rango (hasta 62 días), no solo lo de hoy/mañana. Pasale `cliente` (nombre o id) para uno puntual; dice también quién los colectó. Cuenta cada paquete una vez, el día de Argentina en que se colectó (por escaneo o en la puerta). Solo lectura.",
+  "3.57.0 — NOMBRE Y APELLIDO OBLIGATORIOS en todos los usuarios: `chofer_crear`, `operador_crear` y `cliente_generar_usuario` ahora piden `nombre` y `apellido` por separado (en un vendedor, los de la PERSONA que entra, no el de la tienda: con \"Fumshop\" en la lista no se sabía quién era). Nuevo `usuario_editar` para corregir nombre, apellido, teléfono o email de un usuario de tu nodo. Cambiar el nombre de un cadete NO cambia el nombre con el que se le paga: queda fijo para que sus entregas no se muden de grupo en la liquidación.",
+  "3.55.0 — `envio_editar_zona` ahora también COMPLETA destinatario, teléfono y dirección. El envío que entra por el escaneo del QR trae de quién es el paquete pero NO a dónde va: nace sin destino y se liquida en $0 sin que nadie se entere (5.554 así). En un envío ya ENTREGADO los datos del destino solo se completan si están VACÍOS —nunca se pisan— y los que no se tocaron vuelven en `noPisados`. Además el escáner ahora PIDE la zona en el momento, con el paquete en la mano, y muestra cuántos de la colecta siguen sin zona.",
+  "3.54.0 — `retiros_cargar`: la lista de RETIROS del día se carga por acá en vez del Excel Maestro. Le pasás las direcciones (numeradas o no) y el cadete, y crea un retiro por parada con la zona que cobra y paga (Retiro en CABA/GBA). Dos cosas que la planilla hacía mal y ya no: el número de orden iba PEGADO a la dirección y el geocoder terminaba devolviendo un cuartel en Gualeguaychú (~800 envíos con coordenadas en Entre Ríos), y la localidad quedaba en 'Retiro en CABA', que no es un lugar. Escribe el nombre por el que se PAGA, no solo el vínculo. Repetir la misma dirección el mismo día no duplica el retiro ni el cobro.",
+  "3.53.0 — `envio_pago_mensajero`: carga lo que se le paga a quien repartió, por envío. Cierra una brecha que se comía plata en silencio: al cadete se le paga por el NOMBRE (`Envio.mensajero`) y no por el vínculo, así que un envío asignado con `envio_asignar_mensajero` se veía correcto en todas las pantallas y NO entraba en su resumen de pago. Ahora, al cargar el valor, se completa el nombre con el que la persona está cargada (el apodo del resumen, no el nombre completo; en un vendedor con doble rol, el de su cliente). Sin GRUPO no hay tarifa que estampar —el cadete directo del nodo— y este valor manual era el único mecanismo, sin ninguna herramienta que lo escribiera. No paga por su cuenta un envío que no se entregó: los Cancelados/Devueltos vuelven listados salvo que lo pidas.",
+  "3.52.0 — `envio_completar_ciclo`: reconstruye los pasos que le faltan a un envío YA cerrado (Colectado / En centro de distribución / En camino), cada uno a nombre de quien lo hizo y fechado en el día real. El control por foto cerrado en lote marca ENTREGADO y nada más, así que el envío saltaba de 'A retirar' al cierre sin registro de quién lo movió, y `avanzarA` no servía porque solo avanza hacia adelante. Solo agrega lo que falta: no duplica, no cambia el estado actual y no inventa autores (el paso del que no decís quién lo hizo, no se agrega). No mueve dinero.",
+  "3.51.0 — `envio_entregar` ya no revive un envío que había vuelto al vendedor. Corregir una tanda mal fechada es una operación en LOTE, y un paquete en estado de EXCEPCIÓN (Cancelado, Devuelto al vendedor, En espera de reposición) que estuviera en la lista se marcaba ENTREGADO por estar ahí, en vez de que solo se le corrigiera la fecha. Ahora esos vuelven en `errores` con su estado real y no se tocan; y un envío ya cerrado por ML (`Entregado (Flex)`) entra por la corrección de fecha, no por una entrega nueva. Misma regla que la cadena de `avanzarA`.",
+  "3.50.0 — El control por foto ya cierra la tanda EN EL DÍA QUE SE MOVIÓ. `envio_desde_etiqueta_ml` con `fecha` + `avanzarA` estampa cada estado de la cadena con su hora de ESE día (Colectado 9, En centro 12, En camino 15, Entregado 18) en vez de la hora del control, así el timeline se lee en orden y el cumplimiento del día cuenta bien. Y sobre un envío que YA estaba cargado, la `fecha` ahora también se aplica: antes `cargarEnvio` cortaba antes por idempotencia y la planilla atrasada se seguía liquidando en la semana del alta. Si ese período ya está liquidado, rechaza la llamada nombrando la liquidación en vez de dejar el envío a medio corregir.",
+  "3.49.0 — `envio_entregar` acepta `fecha`: el día REAL en que se entregó. El control por foto se cuenta días después ('esto salió por Bonorino el 2', contado el 8) y el historial decía que se había entregado hoy. Sobre un envío que YA figura entregado, corrige la fecha del cierre ya registrado (vuelve en `fechaCorregida`) — así se arregla una tanda cerrada con el día equivocado sin tocar nada más. Toca el evento 'Entregado' del historial; la semana en que se liquida el envío sigue siendo cosa de `envio_editar_fecha`. No mueve dinero.",
+  "3.48.0 — `envio_asignar_grupo` acepta VARIOS envíos en una llamada: separá los códigos por coma o salto de línea. Una planilla despacha decenas por el mismo grupo y de a uno eran decenas de llamadas. Devuelve el resumen (asignados / ya estaban / no encontrados) en vez de cortar en el primero que falla, porque en una planilla es normal que alguno todavía no esté cargado. Un QR de ML crudo es un JSON con comas adentro: ese nunca se parte, va como un solo código.",
+  "3.47.0 — Quién puede repartir se resuelve en UN solo lugar. La 3.46.0 arregló a medias el `mensajero` de `envio_desde_etiqueta_ml`: miraba rol 'mensajero' y el flag `reparte`, pero seguía dejando afuera la TERCERA forma — el VENDEDOR con doble rol (su Cliente tiene `mensajeroNombre`), que es el caso típico del que vende y además reparte. Ahora tanto ese parámetro como `envio_asignar_mensajero` usan `usuariosQueReparten`, la misma fuente que las listas del panel, así que las tres formas valen igual y se puede pasar el id.",
+  "3.46.0 — El `mensajero` de `envio_desde_etiqueta_ml` ya no le atribuye entregas a la persona equivocada. Resolvía SOLO entre usuarios con rol 'mensajero', así que a un VENDEDOR que también reparte no lo encontraba y elegía a otro de nombre parecido; y si no había ninguna coincidencia lo ignoraba EN SILENCIO, dejando el envío sin mensajero con la respuesta en success. Ahora busca entre todos los que pueden repartir (rol mensajero o `reparte`), acepta el ID, falla si no encuentra a nadie, y si el nombre matchea a varios los lista con su id en vez de elegir por vos.",
+  "3.45.0 — Dos herramientas para DESHACER lo que quedó mal. `envio_corregir_estado` pone un envío en un estado puntual con motivo obligatorio (acepta también los terminales 'Cancelado'/'Rechazado por el comprador', que antes solo escribía ML o la devolución: si algo dejaba un envío ahí, no había forma de volverlo atrás). `envio_asignar_mensajero` asigna o QUITA el mensajero por tracking, buscando entre TODOS los que pueden repartir — rol mensajero o `reparte` habilitado — y aceptando el ID: el `mensajero` de `envio_desde_etiqueta_ml` solo mira rol 'mensajero', así que con un VENDEDOR que también reparte elegía a otra persona de nombre parecido y le atribuía entregas ajenas.",
+  "3.44.0 — FIX de la 3.43.0: un envío en estado de EXCEPCIÓN ya no se avanza. `avanzarA` sobre un envío existente buscaba su estado en el ciclo normal, y como 'Cancelado (Flex)' / 'Devuelto al vendedor' / 'En espera de reposición' no están ahí, `indexOf` daba -1 y lo trataba como si recién arrancara: marcaba ENTREGADO un paquete que en realidad había vuelto al vendedor. Ahora solo avanza desde el ciclo normal (A retirar / Colectado / En centro / En camino) y si no, contesta `noAvanzado` con el estado real, sin escribir nada.",
+  "3.43.0 — `avanzarA` ya no se ignora cuando el envío YA existía. La cadena de estados del control por foto vivía dentro de un `if (!yaExistia)`: si el paquete ya había entrado por otro lado (lo cargó el vendedor, o una integración ML/TiendaNube), `envio_desde_etiqueta_ml` contestaba success y lo dejaba donde estaba, sin avisar. Ahora lo avanza SOLO HACIA ADELANTE desde su estado actual (nunca retrocede, y un envío ya entregado no se toca), y devuelve `historial` + `hechoPor` como en un alta nueva para que se vea qué se movió. Sirve para cerrarle el ciclo a una planilla cuyos paquetes ya estaban cargados.",
+  "3.42.0 — Marcar ENTREGADO un envío que YA estaba cargado (`envio_entregar`, por tracking, uno o varios). Faltaba: el `avanzarA:'entregado'` de `envio_desde_etiqueta_ml` solo corre en altas NUEVAS, así que cuando la foto era de un paquete que ya había entrado por otro lado (lo cargó el vendedor, o una integración ML/TiendaNube) el parámetro se ignoraba EN SILENCIO y el envío quedaba 'A retirar' para siempre — no había forma de cerrarle el ciclo desde el MCP. Entrega 'solo con los datos' (sin foto ni firma) y corre la entrega real: sella la logística de entrega para el clearing y le avisa al vendedor. Los ya entregados vuelven en `yaEstaban` sin romper el lote. Staff, scopeado a tu nodo.",
+  "3.41.0 — Corregir el clearing de un envío YA ENTREGADO sin romperle el estado: `envio_asignar_grupo` nunca despachó los envíos en 'Entregado'/'En camino' (solo les setea con qué grupo salieron), pero la descripción decía que los pasaba a 'En camino' y la ruta devolvía un 409 genérico — 'No se pudo asignar el envío' — cuando en realidad el envío YA estaba en ese grupo y no había nada que hacer. Ahora eso responde ok con `yaEstaba`, y al asignar devuelve `estadoIntacto` para dejar claro que el estado no se tocó. Sirve para atribuirle el clearing a una planilla vieja ya entregada.",
+  "3.40.0 — No cobrarle a un vendedor un envío que el nodo no movió: `liquidacion_excluir_envio` lo saca del cobro de una liquidación YA emitida (re-suma y ajusta la cuenta corriente) y `liquidacion_reincluir_envio` lo devuelve. El MOTIVO es obligatorio: queda en el historial del envío y el vendedor lo ve en su portal. Si la liquidación ya está en una factura de ARCA emitida, lo rechaza (haría falta una nota de crédito). Además el motor de liquidación ahora decide con EVIDENCIA operativa (colecta, mensajero, foto, receptor, etiqueta impresa…) en vez de un guardarraíl binario, y deja registrado por qué no se cobró cada envío. Requiere permiso finanzas.",
+  "3.39.0 — Corregir la FECHA de un envío YA cargado (`envio_editar_fecha`): el que se subió atrasado sin `fecha` quedó con el día del alta y se liquidaría en la semana equivocada. Por tracking, mueve el envío de período y arrastra el primer estado del historial (los demás quedan como se registraron). Solo staff y solo tu nodo; no admite fecha futura; y si ese período YA está liquidado lo rechaza con el número de liquidación en vez de descuadrarla en silencio. No mueve dinero.",
+  "3.38.0 — Cargar envíos con FECHA ANTERIOR: `envio_cargar` y `envio_desde_etiqueta_ml` aceptan `fecha` (dd/mm/aaaa o aaaa-mm-dd) para subir una planilla días después de que el paquete se movió, en vez de que todo quede con la fecha del alta. La fecha define en qué SEMANA se liquida el envío: por eso es SOLO staff (un vendedor no puede mover sus paquetes de período) y no se admite una fecha futura. Sin `fecha` se comporta igual que antes (hoy). No mueve dinero.",
+  "3.37.0 — Guía para ponerse a facturar: nuevo flujo `flujo facturacion` (paso a paso completo: emisor por cuenta, trámite en ARCA, clientes, y cómo se emite después). `facturacion_estado` te dice qué falta — emisores incompletos, cuentas sin emisor y, por cliente, qué dato le falta (CUIT, razón social, condición IVA, emisor, habilitación). `facturacion_preparar_cliente` deja un cliente listo en un paso (datos fiscales + cuenta donde cobra + frecuencia + corte en HOY, para no re-facturar lo viejo). El MCP sigue SIN facturar: no emite comprobantes ni entra a ARCA (eso necesita la Clave Fiscal de esa persona). Requiere permiso finanzas.",
+  "3.33.0 — Colecta a vendedores SIN envíos cargados: `colecta_asignar` crea la colecta igual aunque el cliente no tenga nada cargado, y el cadete ESCANEA cada paquete en la puerta — los que no están en el sistema se crean solos a nombre del vendedor y el mismo QR nunca se cuenta dos veces. Si el QR es de Flex, se APRENDE la cuenta de ML (sender_id) del vendedor: sus próximas etiquetas se reconocen solas, sin preguntar de quién son. `colecta_pendientes` devuelve `clientesSinEnvios`.",
+  "3.32.0 — Alerta 'marcar entregado': los envíos que quedan 'En camino' +24h sin cerrarse ahora salen en `envios_trabados` como tipo `en_camino_sin_cerrar` ('revisá y marcá entregado'), y el aviso proactivo (opt-in ALERTAS_TRABADOS=1) le llega a los OPERATIVOS y admins del nodo (antes solo al jefe). Umbral configurable con ALERTA_EN_CAMINO_HORAS.",
+  "3.31.0 — Consulta rápida de barrios: `zona_barrios` responde '¿qué barrios/localidades hay en <zona>?' (ej. 'Matanza Norte', 'CABA') con su tramo por perfil. Busca por nombre entre las zonas visibles a tu nodo (propias, globales o de tus grupos logísticos). Solo lectura.",
+  "3.30.0 — Perfil de zona por SUCURSAL: un cliente con sucursales en zonas distintas ahora cotiza cada envío según la distancia de SU sucursal-origen (antes usaba un único perfil por cliente). `sucursales_cliente` lista las sucursales de un cliente con su perfil; `sucursal_perfil` setea (o limpia) el perfil de una sucursal (config de staff — el vendedor no lo toca). Perfil vacío = la sucursal hereda el del cliente (comportamiento previo, aditivo).",
+  "3.29.0 — Alta de portal para clientes, gaps cerrados: `cliente_resetear_clave` genera una clave temporal nueva para un cliente/vendedor que YA tiene usuario pero perdió el acceso (sin pisar el alta; para el alta nueva sigue `cliente_generar_usuario`). `generar_enlace_vinculacion` ahora resuelve `cliente` por NOMBRE además de id (antes solo aceptaba el id y tiraba 'Cliente inválido'). El enlace de vinculación (ML/TiendaNube/TiendaNegocio) pasó de vencer en 15 minutos a 48hs, para que le llegue vigente al cliente por WhatsApp aunque no lo abra al instante.",
+  "3.28.0 — Admin de grupo: los nodos ORIGINALES de un grupo (los que lo fundan por QR) son sus admins y gestionan quién está adentro. `grupo_miembros` lista los nodos marcando quién es admin; `grupo_sumar_nodo` / `grupo_expulsar_nodo` agregan o sacan nodos; `grupo_admin_permiso` da o saca el permiso de admin a otro nodo (así otros heredan la administración si los originales se van). Nunca se deja un grupo sin admin. Solo un admin del grupo (o admin global). No mueve dinero.",
+  "3.27.0 — Reconciliación de nodos (QR onboarding etapa 3): `provisorio_conciliar` acepta `modo` — 'absorber' (default, el nodo real se queda con el historial) o 'desde_ahora' (no toca el historial; el clearing arranca de acá). En la PWA, al vincular por QR elegís el modo y cargás la tarifa inicial del grupo.",
+  "3.26.0 — Planilla ML Fase 5: AUTO-PRECIO — `envio_desde_etiqueta_ml` devuelve `precioClearing` (lo que clearea el envío por su grupo+zona) cuando lo despachás por grupo. Nuevo `planilla_reporte`: resumen de lo cargado por control por foto (ml_manual) — total + por cliente/zona/estado + suma de valor y cobro.",
+  "3.25.0 — 'Control por foto y carga de planilla vía MCP' (flujo `control_por_foto`): `envio_desde_etiqueta_ml` cierra TODO el ciclo en un paso con `avanzarA:'entregado'` (A retirar→Colectado→Procesado→[grupo=En camino]→Entregado, cada estado con QUIÉN lo hizo). Vía rápida del clearing entre nodos. Nuevo `fotoRuta` = ruta local de la foto (no la imagen) para reencontrarla, sobre todo con dígitos '*'. Devuelve `historial` + `hechoPor`.",
+  "3.24.0 — Planilla por CARPETA de fotos (una habilidad): `envio_desde_etiqueta_ml` cierra el circuito en un paso con `avanzarA` ('colectado'/'procesado'), `autoRutear` (al nodo/mensajero responsable de la zona; configurás con `asignar_nodo_zona`/`asignar_mensajero_zona`) y `grupo`. Convención de dígitos ilegibles con '*' (ej. 'Aguirre 31**'), sin inventar. Flujo `alta_planilla_ml` reescrito.",
+  "3.23.0 — Flujo de comunicación: `envio_estado` responde '¿cuándo llega?' con narrativa + ETA (mensajero asignado, cuántos envíos en la ruta, posición del envío, estimado por posición×min/parada) y marca problemas (nunca despachado, sin mensajero, mensajero detenido). `envios_trabados` lista los envíos trabados del nodo por severidad. Aviso PROACTIVO al jefe de nodo por push opt-in (ALERTAS_TRABADOS=1, desactivado por defecto). Todo read-only.",
+  "3.22.0 — Planilla ML: `provisorio_conciliar` fusiona un NODO PROVISORIO con el nodo real cuando este ya está dado de alta — reatribuye sus envíos y su membresía de grupo al nodo real y lo marca resuelto (el clearing pasa a usar la tarifa del nodo real). Como operador solo conciliás los provisorios que creó tu nodo, contra un nodo que ya opera en el grupo; el admin global además puede definirle la tarifa. No mueve dinero.",
+  "3.21.0 — Paridad con el escáner: `envio_asignar_grupo` asigna/rutea un envío (por tracking) a un GRUPO logístico tuyo (por nombre o id, ej. 'Portela'/'Bonorino'), define con qué grupo salió (tarifa del clearing) y lo despacha ('En camino', sale del centro). Solo tus grupos / envíos de tu nodo. No mueve dinero. (Sugerencia #23.)",
+  "3.20.0 — Constructor de flujos: `flujo_registrar` captura cuándo el asistente tuvo que INDAGAR (varias preguntas) hasta entender qué quería el usuario → sirve para armar un FLUJO DIRECTO. Se auto-usa (instrucción al conectar). Cualquier rol.",
+  "3.19.0 — Fix de registro: `envio_procesar` (v3.16.0) ahora queda dentro del gate staff/mensajero en el conector remoto. NOTA: si un tool nuevo 'no aparece', abrí una SESIÓN nueva del MCP (el índice de herramientas se fija al iniciar; reconectar el conector no siempre alcanza).",
+  "3.18.0 — Ahora CUALQUIER usuario puede ver SUS propias sugerencias y en qué estado están (`mis_sugerencias`): Recibida / En evaluación / ✅ Implementada / Descartada. Cada uno ve solo lo suyo.",
+  "3.17.0 — Planilla ML Fase 3: crear un NODO PROVISORIO en un grupo al vuelo (`nodo_provisorio_crear`), para atribuir el clearing cuando te bajan paquetes de un nodo que todavía no está dado de alta. Solo en grupos de TU nodo (el admin global en cualquiera); no tiene login hasta conciliarlo con el nodo real. Reusa el clearing por grupo. No mueve dinero.",
+  "3.16.0 — Procesar/recibir un envío en el centro desde el MCP (`envio_procesar` por tracking), sin escanear ni entrar al panel web — igual que la acción 'procesar' del escáner (queda 'En centro de distribución'). Scopeado a tu nodo/grupo. (La consulta de liquidaciones por cliente/monto + detalle ya estaba desde 3.8.0.)",
+  "3.15.0 — Planilla ML manual (no vinculado): `envio_desde_etiqueta_ml` con `reusarEtiqueta:true` REUSA el mismo tracking/QR/etiqueta de ML que ya viene impreso (NO genera uno nuevo), marca el envío como 'ml_manual' y es idempotente (no duplica). Nuevo flujo `flujo alta_planilla_ml`. Además `alta_cliente` ahora guía también el PERFIL DE ZONA y la COLECTA (dirección con timbre + geoposición), y los flujos se AUTO-DISPARAN (el asistente consulta `flujo` cuando querés hacer algo). No mueve dinero.",
+  "3.14.0 — El admin global ya puede OPERAR (no solo consultar) sobre cualquier nodo: los tools de escritura scopeados por nodo aceptan un parámetro opcional `nodo` para elegir sobre qué nodo actuar (chofer_crear, cliente_crear/editar, cliente_generar_usuario, producto_crear, precio_actualizar, colecta_configurar/asignar/desasignar, procesar_zona, rechazar_zona, asignar_mensajero_zona; asignar_nodo_zona usa `logisticaId`). El operador de nodo lo ignora (siempre opera en SU nodo — aislamiento intacto). Antes chofer_crear fallaba con 'Elegí un nodo' para el admin global. De paso se cerró un IDOR: desasignar una colecta ahora valida que sea de tu nodo.",
+  "3.13.0 — Flujo guiado (Fase A): nuevo tool `flujo` que devuelve el PASO A PASO de un objetivo (alta_cliente, alta_operador, alta_chofer) para no dejar nada incompleto. Además `cliente_crear`, si no le pasás la lista de precios, te recuerda preguntar «¿qué le cobrás?» (Oficial de Flex o una propia con nombre reusable) y cómo asignarla. Todo en español, para operar sin saber nada.",
+  "3.12.0 — Alta de OPERADOR de nodo (`operador_crear`): crea el login de un operador (staff que administra el nodo) con email + CLAVE TEMPORAL y los permisos que le des (default 'logistica'). El operador de nodo lo crea en SU nodo; el admin global elige el nodo con `nodo`. Requiere permiso 'usuarios'. No otorga admin de nodo (eso es `usuario_habilitar_rol`) ni toca dinero.",
+  "3.11.1 — Fix `envio_desde_etiqueta_ml` / `envio_cargar`: (a) el id de ML leído de una foto con espacios OCR (\"4789055 7180\") ahora se limpia y se guarda como NÚMERO (así lo matchea el escáner); (b) los campos numérico-ambiguos (cp, teléfono, mlShipmentId, montoCobro) aceptan número o texto, así una llamada con `cp: 2804` ya no revienta en la validación con un error genérico sin detalle.",
+  "3.11.0 — Superadmin desde el MCP: habilitar operador/superoperador/admin de nodo (`usuario_habilitar_rol`), crear grupos logísticos (`grupo_crear`) y subir el logo/marca de un nodo (`logo_subir`, imagen en base64). Además `mis_datos` ahora muestra el nodo por su NOMBRE. Solo admin global. No toca dinero.",
+  "3.10.0 — Login para un vendedor: `cliente_generar_usuario` le crea las credenciales de acceso a un cliente/vendedor YA existente de tu nodo y devuelve una CLAVE TEMPORAL. Requiere permiso 'usuarios', scopeado a tu nodo. No toca dinero.",
+  "3.9.0 — Corregir el destino de un envío puntual (`envio_editar_zona`): arregla la localidad/zona/partido de UN envío (por tracking) cargado con el destino mal (ej. dos localidades pisadas en la etiqueta) para que vuelva a ser cobrable/ruteable, SIN reasignarlo de cliente y sin crear un alias global. Staff: su nodo; admin global: cualquiera. No mueve dinero.",
+  "3.8.0 — Consulta de liquidaciones: buscar por cliente/monto (`liquidacion_buscar`), ver el detalle de envíos de una liquidación (`liquidacion_detalle`) y listar las que están sin recibir/impagas (`liquidaciones_sin_recibir`). Solo lectura, scopeadas por nodo (admin de nodo: sus clientes; admin global: cualquier nodo con `nodo`). No mueve dinero.",
+  "3.7.0 — Atribución de marketing (Fase 1): ver/guardar los píxeles de marketing (Meta Pixel, GA4, GTM y tokens de la Conversions API) del nodo o del vendedor con `marketing_config_ver` / `marketing_config_guardar`. El backend resuelve el alcance por rol (vendedor: lo suyo; operador: su nodo). No mueve dinero.",
+  "3.6.1 — Guía (`guia`) con intro motivador que engancha a hacer el tutorial (qué podés automatizar en 5 min).",
+  "3.6.0 — Guía de arranque por rol (`guia` + instrucciones al conectar): metodología para empezar rápido (mensajero: foto→envío al colectar; vendedor: cargar ventas; nodo: implementar + operar + clearing). Los MENSAJEROS ya pueden registrar envíos de lo que colectan (`envio_cargar` / `envio_desde_etiqueta_ml`), scopeado a clientes de su nodo o que hayan colectado (marketplace incluido).",
+  "3.5.0 — Ayuda integrada (`ayuda`): documentación por herramienta (qué hace, cómo usar, ejemplo, qué NO hace) + temas transversales (facturacion_marketplace, dinero, aislamiento). Aclarado que adjudicar una ruta del marketplace NO genera facturación/rendición/comisión automática (el pago entre nodos es manual).",
+  "3.4.0 — Marketplace de rutas públicas (ruta_publicar/ofertar/adjudicar); admin también reparte; registrar envío desde foto de etiqueta ML; alta/edición de choferes; mcp_version.",
+  "3.3.0 — Afiliados y comisión por envío; métricas por tipo; gestión de colectas (asignar/rechazar entre nodos); cuentas vinculadas; sucursales; colecta a pedido; metazonas flexibles.",
+];
+const INSTRUCCIONES = "MCP de Nexus Flex. Si te preguntan la versión, consultá `mcp_version` (este texto puede ser anterior a una actualización). Para arrancar: `guia` (cómo trabajar según tu rol) y `ayuda` (índice de herramientas). El MCP NUNCA mueve dinero.\n\nCuando el usuario quiera completar un alta o una carga que tiene flujo guiado (ver `flujo`), traé el paso a paso y completalo entero antes de darlo por terminado: los pasos siguientes (lista de precios, perfil de zona, colecta) son los que se olvidan y dejan el alta a medias.";
+const server = new McpServer({ name: "nexusflex", version: MCP_VERSION }, { instructions: INSTRUCCIONES });
+
+/** Formatea un ApiResult como respuesta de tool MCP, con mensajes claros y SIN
+ *  filtrar tokens ni stack traces. */
+function toResult(r) {
+  if (r.ok) return { content: [{ type: "text", text: JSON.stringify(r.data, null, 2) }] };
+  const base =
+    r.status === 401 ? "Sesión inválida o vencida (autorizá de nuevo con `npx nexusflex-mcp login`)." :
+    r.status === 403 ? "Tu usuario no tiene permiso para esta operación (aislamiento del backend)." :
+    r.status === 404 ? "No encontrado." :
+    `Error ${r.status}.`;
+  const d = r.data;
+  const detalle = d?.error ? ` ${d.error}` : d?.message ? ` ${d.message}` : "";
+  return { content: [{ type: "text", text: `${base}${detalle}` }], isError: true };
+}
+
+async function run(fn) {
+  try {
+    return toResult(await fn());
+  } catch (e) {
+    return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }], isError: true };
+  }
+}
+
+// Un modelo con visión suele mandar campos "de texto" como NÚMERO en el JSON
+// (ej. cp: 2804, mlShipmentId: 47890557180). Con z.string() eso reventaba en la
+// validación del SDK ANTES del handler → el cliente sólo veía "MCP tool call
+// failed" sin detalle. Estos helpers aceptan string|number y normalizan, así el
+// tool corre y, si algo falla, devuelve un mensaje útil del backend.
+const zStr = () => z.union([z.string(), z.number()]).transform((x) => String(x)).optional();
+const zNum = () => z.union([z.number(), z.string()]).optional();
+
+// Override de nodo: SOLO lo usa el admin global para elegir sobre qué nodo opera. El
+// operador de nodo lo ignora (el backend lo fuerza a SU nodo con nodoDe → sin escalada
+// cross-nodo). Se manda al backend como `logisticaId`. Ver sugerencia MCP #20.
+const NODO_OVERRIDE_DESC = "Solo admin global: nodo (id) sobre el que operás. El operador de nodo lo ignora (siempre opera en el suyo).";
+const zNodo = () => z.number().int().positive().optional().describe(NODO_OVERRIDE_DESC);
+
+const q = (params) => {
+  const s = Object.entries(params).filter(([, v]) => v != null && v !== "").map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join("&");
+  return s ? `?${s}` : "";
+};
+const registrados = new Set(); // para que `ayuda` liste solo lo que este usuario tiene
+const tool = (name, def, handler) => { registrados.add(name); server.registerTool(name, def, handler); };
+
+// ============================================================================
+//  CONTROL POR FOTO (staff). El servidor hace el trabajo foto por foto
+//  (/control-foto/foto); acá, en la PC, se recorre la CARPETA del día — cosa que el
+//  conector remoto no puede (no ve tu disco). Ver `flujo control_por_foto`.
+// ============================================================================
+const EXT_FOTO = /\.(jpe?g|png|webp)$/i;
+
+// CARPETA PERMITIDA: el MCP solo lee y crea adentro de UNA carpeta, la que el usuario elige al
+// instalar el plugin (NEXUSFLEX_CARPETA_FOTOS). Sin elegir: Documentos\Control por foto (se crea
+// sola). Las rutas relativas se toman desde ahí; cualquier ruta que caiga afuera se rechaza.
+const CARPETA_DEFAULT = ["Documents", "Control por foto"];
+async function carpetaControl() {
+  const fs = await import("node:fs");
+  const path = await import("node:path");
+  const os = await import("node:os");
+  let c = String(process.env.NEXUSFLEX_CARPETA_FOTOS ?? "").trim();
+  if (!c || c.includes("${")) c = path.join(os.homedir(), ...CARPETA_DEFAULT); // sin configurar (o placeholder sin reemplazar)
+  fs.mkdirSync(c, { recursive: true });
+  return fs.realpathSync(c);
+}
+/** Resuelve `ruta` (relativa a la carpeta permitida, o absoluta) y la rechaza si cae afuera. */
+async function rutaPermitida(ruta) {
+  const fs = await import("node:fs");
+  const path = await import("node:path");
+  const base = await carpetaControl();
+  const pedida = String(ruta ?? "").trim();
+  let p = pedida ? path.resolve(base, pedida) : base;
+  if (fs.existsSync(p)) p = fs.realpathSync(p); // un acceso directo que apunta afuera, también afuera
+  const rel = path.relative(base, p);
+  if (rel.startsWith("..") || path.isAbsolute(rel)) {
+    return { error: { ok: false, status: 400, data: { message: `Por seguridad solo trabajo adentro de la carpeta del control por foto: ${base}. Mové las fotos ahí (o cambiá la carpeta en la configuración del plugin).`, carpetaPermitida: base } } };
+  }
+  return { ruta: p, base };
+}
+/** Día de la carpeta: "Lunes 14-9", "14-09-2026", "2026-09-14"… → "aaaa-mm-dd" (o null). */
+function diaDeCarpeta(nombre, anioDefault = new Date().getFullYear()) {
+  const iso = nombre.match(/(20\d{2})-(\d{1,2})-(\d{1,2})/);
+  if (iso) return `${iso[1]}-${iso[2].padStart(2, "0")}-${iso[3].padStart(2, "0")}`;
+  const m = nombre.match(/(\d{1,2})[-./](\d{1,2})(?:[-./](\d{2,4}))?/);
+  if (!m) return null;
+  const anio = m[3] ? (m[3].length === 2 ? `20${m[3]}` : m[3]) : String(anioDefault);
+  return `${anio}-${m[2].padStart(2, "0")}-${m[1].padStart(2, "0")}`;
+}
+/** Fotos de un día: [{ archivo, carpeta (relativa al día, sin el archivo) }]. Saltea carpetas "_…". */
+async function fotosDelDia(diaDir) {
+  const fs = await import("node:fs");
+  const path = await import("node:path");
+  const out = [];
+  const zips = [];
+  const recorrer = (dir) => {
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (e.name.startsWith("_") || e.isSymbolicLink()) continue; // un acceso directo puede apuntar afuera de la carpeta permitida
+      const p = path.join(dir, e.name);
+      if (e.isDirectory()) recorrer(p);
+      else if (EXT_FOTO.test(e.name)) out.push({ archivo: p, carpeta: path.relative(diaDir, dir).split(path.sep).join("/") });
+      else if (/\.zip$/i.test(e.name)) zips.push(path.relative(diaDir, p));
+    }
+  };
+  recorrer(diaDir);
+  return { fotos: out.filter((f) => /^(dados|recibidos)\b/i.test(f.carpeta)), sueltas: out.filter((f) => !/^(dados|recibidos)\b/i.test(f.carpeta)).length, zips };
+}
+
+const DIAS_SEMANA = ["Domingo", "Lunes", "Martes", "Miercoles", "Jueves", "Viernes", "Sabado"];
+/** "2026-09-14" → "Lunes 14-9-2026" (la convención de las carpetas del control, con el año). */
+function nombreCarpetaDia(iso) {
+  const [a, m, d] = iso.split("-").map(Number);
+  return `${DIAS_SEMANA[new Date(Date.UTC(a, m - 1, d)).getUTCDay()]} ${d}-${m}-${a}`;
+}
+/** Un nombre de grupo/cadete como nombre de carpeta válido en Windows (sin "(operador)", sin / \ : * ? " < > |). */
+const nombreCarpeta = (s) => String(s).replace(/\s*\([^)]*\)\s*$/, "").replace(/[\\/:*?"<>|]+/g, "-").replace(/\s+/g, " ").trim();
+/** Fechas pedidas: "14/09/2026", "2026-09-14", rangos "14/09/2026 a 19/09/2026" o listas separadas por coma. */
+function fechasPedidas(texto, anioDefault) {
+  const una = (t) => {
+    const s = String(t).trim();
+    const iso = s.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/);
+    if (iso) return `${iso[1]}-${iso[2].padStart(2, "0")}-${iso[3].padStart(2, "0")}`;
+    const m = s.match(/^(\d{1,2})[-/.](\d{1,2})(?:[-/.](\d{2,4}))?$/);
+    if (!m) return null;
+    const a = m[3] ? (m[3].length === 2 ? `20${m[3]}` : m[3]) : String(anioDefault);
+    return `${a}-${m[2].padStart(2, "0")}-${m[1].padStart(2, "0")}`;
+  };
+  const out = [];
+  for (const parte of String(texto).split(",")) {
+    const [desde, hasta] = parte.split(/\s+(?:a|al|hasta)\s+/i).map(una);
+    if (!desde) return null;
+    if (!hasta) { out.push(desde); continue; }
+    for (let t = Date.parse(`${desde}T00:00:00Z`); t <= Date.parse(`${hasta}T00:00:00Z`) && out.length < 62; t += 864e5) out.push(new Date(t).toISOString().slice(0, 10));
+  }
+  return out;
+}
+
+function registrarControlFoto() {
+  tool("control_foto_preparar", {
+    title: "Control por foto: crear las carpetas del día (o de varios días)",
+    description: "Arma en la PC las carpetas para el control por foto de uno o varios días, con los nombres EXACTOS de tus grupos y cadetes: <día>/DADOS/<cada grupo>, <día>/DADOS/<cada cadete>, <día>/RECIBIDOS/<cada cadete>, <día>/RECIBIDOS/<cada grupo> (lo que derivaste por ese grupo) + un LEEME.txt que explica qué foto va en cada una. Usalo cuando el usuario dice 'hagamos el control por foto del día tal': creás las carpetas, le decís dónde quedaron y que suelte ahí las fotos; después, `control_foto_carpeta`. No pisa nada que ya exista. No mueve dinero.",
+    inputSchema: {
+      ruta: zStr().describe("Opcional: subcarpeta adentro de la carpeta del control por foto (la que se eligió al instalar; por defecto Documentos\\\\Control por foto). Vacío = ahí mismo. Afuera de esa carpeta no se puede."),
+      fechas: zStr().describe("Día o días: '14/09/2026', '14/09 a 19/09', '14/09, 16/09' (sin año = el actual)"),
+      nodo: zNodo(),
+    },
+  }, async (a) => run(async () => {
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    const permitida = await rutaPermitida(a.ruta);
+    if (permitida.error) return permitida.error;
+    const raiz = permitida.ruta;
+    const fechas = fechasPedidas(a.fechas ?? "", new Date().getFullYear());
+    if (!fechas?.length) return { ok: false, status: 400, data: { message: `No entiendo las fechas "${a.fechas ?? ""}". Usá '14/09/2026' o '14/09 a 19/09'.` } };
+    const est = await api("GET", `/control-foto/estructura${q({ nodo: a.nodo })}`);
+    if (!est.ok) return est;
+    const grupos = (est.data.grupos ?? []).map((g) => nombreCarpeta(g.nombre));
+    const cadetes = (est.data.cadetes ?? []).map((c) => nombreCarpeta(c.nombre));
+    const leeme = [
+      "CONTROL POR FOTO — qué foto va en cada carpeta",
+      "",
+      "DADOS/<grupo>     → los paquetes que le pasaste a ese grupo (juntada, colecta del grupo…).",
+      "DADOS/<cadete>    → los que salieron a repartir con ese cadete tuyo.",
+      "RECIBIDOS/<cadete> → los que te dieron otros nodos y repartió ese cadete.",
+      "RECIBIDOS/<grupo> → los que te dieron y mandaste por ese grupo a otro nodo (ej. Zárate Campana).",
+      "",
+      "Una foto por paquete, que se lea la etiqueta. Si un paquete llegó por un grupo en particular,",
+      "podés poner la carpeta del cadete adentro: RECIBIDOS/<grupo>/<cadete>.",
+      "Las carpetas que no uses quedan vacías: no pasa nada. No renombres las carpetas.",
+      "Cuando termines de soltar las fotos, pedile a Claude: \"hacé el control por foto de esta carpeta\".",
+    ].join("\r\n");
+    const creadas = [];
+    for (const f of fechas) {
+      const dia = path.join(raiz, nombreCarpetaDia(f));
+      const subs = [...grupos.map((g) => ["DADOS", g]), ...cadetes.map((c) => ["DADOS", c]), ...cadetes.map((c) => ["RECIBIDOS", c]), ...grupos.map((g) => ["RECIBIDOS", g])];
+      for (const s of subs) fs.mkdirSync(path.join(dia, ...s), { recursive: true });
+      const lm = path.join(dia, "LEEME.txt");
+      if (!fs.existsSync(lm)) fs.writeFileSync(lm, leeme);
+      creadas.push(dia);
+    }
+    return { ok: true, status: 200, data: { creadas, grupos, cadetes, siguiente: "Soltá las fotos en cada carpeta y después corré control_foto_carpeta sobre la carpeta del día (o sobre la de todos los días)." } };
+  }));
+
+  tool("control_foto_estructura", {
+    title: "Control por foto: cómo armar las carpetas (tus grupos y cadetes)",
+    description: "Devuelve cómo tienen que llamarse las carpetas del control por foto para TU nodo: tus grupos logísticos y quiénes reparten. Llamalo antes de `control_foto_carpeta` para explicarle al usuario la estructura o para entender por qué una carpeta no se reconoce. Solo lectura.",
+    inputSchema: { nodo: zNodo() },
+  }, async ({ nodo }) => run(async () => {
+    const r = await api("GET", `/control-foto/estructura${q({ nodo })}`);
+    // En la PC: además, dónde tienen que ir las carpetas (la única carpeta que este MCP puede leer).
+    return r.ok ? { ...r, data: { ...r.data, carpetaDelControl: await carpetaControl() } } : r;
+  }));
+
+  tool("control_foto_foto", {
+    title: "Control por foto: procesar UNA foto de etiqueta",
+    description: "Procesa una sola foto (por su RUTA en la PC): lee el QR (o la IA de etiquetas), busca o da de alta el envío (sin duplicar), lo asigna según la CARPETA (DADOS/<grupo>, DADOS/<cadete>, RECIBIDOS/…/<cadete>, RECIBIDOS/<grupo>), lo lleva a Entregado en el `fecha` real y le cuelga la foto. Usalo para CONTESTAR una pregunta de `control_foto_carpeta`: repetí esa foto con `nodoEntrega` (quién la llevó) o `cliente` (de quién es la cuenta de ML). `simular:true` = solo mirar. No mueve dinero.",
+    inputSchema: {
+      ruta: zStr().describe("Ruta de la foto (adentro de la carpeta del control por foto; puede ser relativa a ella)"),
+      carpeta: zStr().describe("Carpeta relativa al día, ej. 'DADOS/Bonorino' o 'RECIBIDOS/Matanza/Gerardo'"),
+      fecha: zStr().describe("Día real (dd/mm/aaaa o aaaa-mm-dd)"),
+      simular: z.boolean().optional(),
+      nodoEntrega: zStr().describe("Respuesta: nodo (nombre o id) que lo llevó, cuando la zona tiene varios responsables"),
+      cliente: zStr().describe("Respuesta: id del cliente dueño de una cuenta de ML desconocida"),
+      nodo: zNodo(),
+    },
+  }, async (a) => run(async () => {
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    if (!a.ruta) return { ok: false, status: 400, data: { message: "Decime la ruta de la foto." } };
+    const permitida = await rutaPermitida(a.ruta);
+    if (permitida.error) return permitida.error;
+    const foto = permitida.ruta;
+    if (!fs.existsSync(foto) || !EXT_FOTO.test(foto)) return { ok: false, status: 400, data: { message: `No encuentro la foto ${a.ruta}.` } };
+    return api("POST", "/control-foto/foto", { imagen: fs.readFileSync(foto).toString("base64"), carpeta: a.carpeta, fecha: a.fecha, simular: a.simular === true, nodoEntrega: a.nodoEntrega, cliente: a.cliente, nombreArchivo: path.basename(foto), nodo: a.nodo });
+  }));
+
+  tool("control_foto_carpeta", {
+    title: "Control por foto: procesar la carpeta de un día (o de varios)",
+    description: "Recorre la carpeta de UN DÍA (o una carpeta con varios días adentro) en la PC: cada foto bajo DADOS/… o RECIBIDOS/… se manda al servidor con su carpeta y el día (sale del nombre de la carpeta: 'Lunes 14-9', '2026-09-14'…). Por defecto SIMULA (no escribe): devuelve qué haría, cuántos paquetes, y las PREGUNTAS (cuentas de ML que no conoce, zonas con varios responsables, posibles duplicados, carpetas que no reconoce). Mostrale el resumen al usuario, resolvé las preguntas y recién ahí corré con `aplicar:true`. Al aplicar, lo que siga dudoso se SUBE a la app (Logística → 📷 Control por foto) para resolverlo mirando la foto. Es reanudable: una foto ya procesada no se repite. Las fotos dudosas se copian a `_sin_identificar` dentro de cada día y deja el detalle en `_control-foto-<día>.json`. No mueve dinero.",
+    inputSchema: {
+      ruta: zStr().describe("Carpeta del día (ej. 'Lunes 14-9-2026') o la que contiene varios días, adentro de la carpeta del control por foto. Vacío = la carpeta del control entera."),
+      aplicar: z.boolean().optional().describe("true = escribe. Sin esto, solo simula."),
+      anio: zNum().describe("Año, si el nombre de la carpeta no lo trae (default: el actual)"),
+      nodo: zNodo(),
+    },
+  }, async (a) => run(async () => {
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    const permitida = await rutaPermitida(a.ruta);
+    if (permitida.error) return permitida.error;
+    const raiz = permitida.ruta;
+    if (!fs.existsSync(raiz)) return { ok: false, status: 400, data: { message: `No encuentro la carpeta ${a.ruta}.` } };
+    if (a.aplicar === true && !ALLOW_WRITE) return { ok: false, status: 403, data: { message: "Escritura deshabilitada en este MCP (NEXUSFLEX_MCP_ALLOW_WRITE)." } };
+    const esDia = (d) => fs.readdirSync(d, { withFileTypes: true }).some((e) => e.isDirectory() && /^(dados|recibidos)$/i.test(e.name));
+    const dias = esDia(raiz) ? [raiz] : fs.readdirSync(raiz, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith("_") && esDia(path.join(raiz, e.name))).map((e) => path.join(raiz, e.name));
+    if (!dias.length) return { ok: false, status: 400, data: { message: "No encontré carpetas DADOS/RECIBIDOS (¿están comprimidas en .zip? descomprimilas primero). Ver `control_foto_estructura`." } };
+    const resumen = { modo: a.aplicar === true ? "APLICADO" : "SIMULACIÓN (no se escribió nada)", dias: [] };
+    for (const dir of dias) {
+      const fecha = diaDeCarpeta(path.basename(dir), Number(a.anio) || undefined);
+      if (!fecha) { resumen.dias.push({ dia: path.basename(dir), error: "El nombre de la carpeta no tiene la fecha (ej. 'Lunes 14-9')." }); continue; }
+      const { fotos, sueltas, zips } = await fotosDelDia(dir);
+      const res = [];
+      let i = 0;
+      const trabajador = async () => {
+        while (i < fotos.length) {
+          const f = fotos[i++];
+          const r = await api("POST", "/control-foto/foto", { imagen: fs.readFileSync(f.archivo).toString("base64"), carpeta: f.carpeta, fecha, simular: a.aplicar !== true, nombreArchivo: path.basename(f.archivo), nodo: a.nodo }).catch((e) => ({ ok: false, data: { message: String(e) } }));
+          res.push({ archivo: path.relative(dir, f.archivo), carpeta: f.carpeta, ...(r.ok ? r.data : { estado: "error", error: r.data?.message ?? `HTTP ${r.status}` }) });
+        }
+      };
+      await Promise.all([trabajador(), trabajador(), trabajador()]);
+      fs.writeFileSync(path.join(dir, `_control-foto-${fecha}.json`), JSON.stringify(res, null, 1));
+      // Lo dudoso a mano: copia en _sin_identificar (el original queda donde estaba).
+      const dudosas = res.filter((r) => r.estado === "pregunta" || r.estado === "error");
+      if (dudosas.length) {
+        const destino = path.join(dir, "_sin_identificar");
+        fs.mkdirSync(destino, { recursive: true });
+        for (const d of dudosas) {
+          const motivo = (d.pregunta?.tipo ?? "error") + (d.pregunta?.datos?.cuentaML ? ` ML ${d.pregunta.datos.cuentaML}` : "");
+          try { fs.copyFileSync(path.join(dir, d.archivo), path.join(destino, `${motivo} - ${d.carpeta.replace(/\//g, " ")} - ${path.basename(d.archivo)}`)); } catch { /* no rompe el lote */ }
+        }
+      }
+      const cuenta = (k) => res.filter((r) => r.estado === k).length;
+      const porCuenta = {};
+      for (const r of res) if (r.pregunta?.tipo === "cuenta_ml") {
+        const c = r.pregunta.datos?.cuentaML;
+        (porCuenta[c] ??= { cuentaML: c, vendedor: r.pregunta.datos?.vendedor ?? null, marcas: new Set(), fotos: 0, ejemplo: r.archivo, carpeta: r.carpeta });
+        porCuenta[c].fotos++;
+        if (r.pregunta.datos?.marcaManual) porCuenta[c].marcas.add(r.pregunta.datos.marcaManual);
+      }
+      const otras = res.filter((r) => r.estado === "pregunta" && r.pregunta?.tipo !== "cuenta_ml").map((r) => ({ archivo: r.archivo, carpeta: r.carpeta, tipo: r.pregunta.tipo, texto: r.pregunta.texto, opciones: r.pregunta.opciones?.map((o) => o.nombre) }));
+      const errores = [...new Set(res.filter((r) => r.estado === "error").map((r) => `${r.carpeta}: ${r.error}`))];
+      resumen.dias.push({
+        dia: path.basename(dir), fecha, fotos: fotos.length,
+        ok: cuenta("ok"), sinCambios: cuenta("sin_cambios"), yaProcesadas: cuenta("ya_procesada"), altas: res.filter((r) => r.alta).length,
+        preguntas: cuenta("pregunta"), errores: cuenta("error"),
+        ...(sueltas ? { fuera_de_DADOS_RECIBIDOS: sueltas } : {}), ...(zips.length ? { zipsSinDescomprimir: zips } : {}),
+        cuentasMLDesconocidas: Object.values(porCuenta).map((c) => ({ ...c, marcas: [...c.marcas] })),
+        otrasPreguntas: otras.slice(0, 40), ...(otras.length > 40 ? { masPreguntas: otras.length - 40 } : {}),
+        erroresDeCarpeta: errores,
+        ...(a.aplicar === true && cuenta("pregunta") + cuenta("error") ? { resolverEnLaApp: `Las ${cuenta("pregunta") + cuenta("error")} foto(s) dudosas quedaron subidas en la app: menú Logística → 📷 Control por foto. Ahí se ven grandes y se elige el cliente, el nodo o el cadete.` } : {}),
+        detalle: path.join(dir, `_control-foto-${fecha}.json`),
+      });
+    }
+    return { ok: true, status: 200, data: resumen };
+  }));
+}
+
+// ============================================================================
+//  CAPA 2 — Identidad: leemos /auth/me ANTES de registrar tools. Cada usuario ve
+//  SOLO los tools de su rol. Si falla el login, se registra solo `mis_datos`.
+// ============================================================================
+let me = null;
+try {
+  const r = await api("GET", "/auth/me");
+  if (r.ok) me = r.data?.usuario ?? null;
+  else log(`/auth/me devolvió ${r.status} — revisá el token/credenciales.`);
+} catch (e) {
+  log("No se pudo contactar /auth/me:", e instanceof Error ? e.message : String(e));
+}
+
+const rol = me?.rol ?? "";
+const permisos = Array.isArray(me?.permisos) ? me.permisos : [];
+const esGlobal = rol === "admin" || me?.esSuperoperador === true;
+const esAdminNodo = me?.esAdminNodo === true;
+const isCliente = rol === "cliente";
+const isStaff = rol === "operador" || rol === "admin";
+const wmsActivo = me?.wmsActivo === true;
+// Espejo de requirePermiso del backend (solo para DECIDIR qué mostrar; el backend manda).
+const puede = (p) => esGlobal || (isStaff && (esAdminNodo || permisos.length === 0 || permisos.includes(p)));
+
+// ============================================================================
+//  SIEMPRE
+// ============================================================================
+tool("mis_datos", {
+  title: "Mis datos / alcance",
+  description: "Devuelve tu usuario, rol y nodo/cliente al que está atado este MCP. Usalo para confirmar tu alcance antes de operar. Reportá el nodo por su NOMBRE (campo `logisticaNombre`, ej. 'estás en FastCorreo'), nunca solo por el número.",
+  inputSchema: {},
+}, async () => run(() => api("GET", "/auth/me")));
+
+// Versión del MCP corriendo (cualquier rol). Sirve para saber si tenés lo último.
+tool("mcp_version", {
+  title: "Versión del MCP",
+  description: "Qué versión del MCP de Nexus Flex está corriendo y por qué vía. Cualquier rol lo puede consultar.",
+  inputSchema: {},
+}, async () => ({ content: [{ type: "text", text: JSON.stringify({ version: MCP_VERSION, modo: "npx (Claude Desktop)", novedades: NOVEDADES, nota: "Para tener lo último: actualizá con «npx -y nexusflex-mcp@latest» o pasate al conector remoto (siempre al día, sin instalar/actualizar)." }) }] }));
+
+// Guía de arranque por rol (metodología). Cualquier rol; read-only.
+tool("guia", {
+  title: "Guía de arranque (metodología para tu rol)",
+  description: "Cómo empezar a usar Nexus Flex rápido según tu rol: mensajero (registrar lo que colectás sacando fotos → envío), vendedor (cargar ventas), nodo (implementar + operar + clearing). Sin argumentos = tu rol; `rol` para ver otra (mensajero|cliente|nodo).",
+  inputSchema: { rol: z.string().optional().describe("mensajero | cliente | nodo (default: tu rol)") },
+}, async ({ rol: r }) => {
+  const pedido = String(r ?? "").trim().toLowerCase();
+  const target = pedido === "nodo" ? "operador" : pedido || rol;
+  return { content: [{ type: "text", text: guiaOnboarding(target) }] };
+});
+
+// Flujo guiado: paso a paso de un objetivo para no dejar nada incompleto (Fase A).
+tool("flujo", {
+  title: "Flujo guiado paso a paso",
+  description: "Te devuelve el PASO A PASO para completar bien un objetivo, sin dejar nada a medias (ej. dar de alta un cliente con su lista de precios, o el CONTROL POR FOTO de una carpeta de etiquetas ML). Sin argumento lista los flujos disponibles; pasá `objetivo` (una de las claves de abajo). Usalo para GUIAR al usuario que no sabe qué datos faltan.",
+  inputSchema: { objetivo: z.string().optional().describe(`Vacío = lista los flujos disponibles. Claves: ${Object.keys(FLUJOS).join(", ")}.`) },
+}, async ({ objetivo }) => ({ content: [{ type: "text", text: renderFlujo(objetivo) }] }));
+
+// Sugerencias: cualquier usuario (todos los roles) puede proponer funciones/mejoras.
+tool("sugerencia_crear", {
+  title: "Enviar una sugerencia",
+  description: "Proponé una función nueva, mejora o reportá un bug. mensaje obligatorio; categoria opcional (funcionalidad|mejora|bug|otro). Se registra tu usuario/rol/nodo automáticamente.",
+  inputSchema: { mensaje: z.string().min(1), categoria: z.enum(["funcionalidad", "mejora", "bug", "otro"]).optional() },
+}, async (args) => run(() => api("POST", "/feedback/sugerencias", args)));
+tool("mis_sugerencias", {
+  title: "Mis sugerencias y su estado",
+  description: "Lista TUS propias sugerencias/pedidos de mejora y en qué estado están (Recibida / En evaluación / ✅ Implementada / Descartada). Cada usuario ve SOLO las suyas. Sin argumentos.",
+  inputSchema: {},
+}, async () => run(() => api("GET", "/feedback/mis-sugerencias")));
+tool("flujo_registrar", {
+  title: "Registrar un flujo aprendido (indagación)",
+  description: "Usalo cuando, tras varias preguntas de aclaración, se entendió lo que el usuario quería: registra el objetivo y los pasos para convertirlo en un flujo directo. Avisale al usuario que lo registrás. Registrás `objetivo` (lo que terminó queriendo) y `pasos` (las preguntas/decisiones que lo aclararon + herramientas usadas). No mueve dinero.",
+  inputSchema: { objetivo: z.string().min(1), pasos: z.string().min(1) },
+}, async ({ objetivo, pasos }) => run(() => api("POST", "/feedback/sugerencias", { categoria: "mejora", mensaje: `[FLUJO APRENDIDO] Objetivo: ${objetivo}\nPasos que lo aclararon: ${pasos}` })));
+
+// ============================================================================
+//  ROL CLIENTE (vendedor) — SOLO lo suyo. El backend lo fuerza a su idCliente.
+// ============================================================================
+if (isCliente) {
+  tool("mis_envios", {
+    title: "Mis envíos",
+    description: "Tus envíos/paquetes (solo los tuyos), los 300 más recientes, cada uno con su `estado`. No incluye datos de otros clientes ni del nodo.",
+    inputSchema: { estado: z.string().optional().describe("Estado: 'A retirar', 'Colectado', 'En centro de distribución', 'En camino', 'Entregado' (o una novedad, ej. 'Comprador ausente'). Filtra por los que EMPIEZAN con ese texto ('Entregado' incluye 'Entregado (Flex)'); los 300 más recientes de ese estado.") },
+  }, async ({ estado }) => run(() => api("GET", `/portal/envios${q({ estado })}`)));
+
+  tool("mis_kpis", {
+    title: "Mis métricas",
+    description: "Tus métricas: volumen, calidad de entrega, saldo, última liquidación y un benchmark ANÓNIMO contra el promedio de tu nodo (nunca ves a quién corresponde cada número).",
+    inputSchema: { desde: z.string().optional().describe("Fecha YYYY-MM-DD (pasá desde y hasta juntas; si falta una, usa el mes en curso)"), hasta: z.string().optional().describe("Fecha YYYY-MM-DD") },
+  }, async ({ desde, hasta }) => run(() => api("GET", `/kpi/vendedor${q({ desde, hasta })}`)));
+
+  // --- Control de stock del vendedor (WMS Fase 1). Se registran SIEMPRE para
+  //     rol=cliente: el backend gatea con 403 si el vendedor no tiene depósito ni
+  //     control de stock propio. Así funciona tanto con WMS del nodo como con el
+  //     modo "soft" por vendedor (Cliente.controlStockActivo). ---
+  tool("mi_stock", {
+    title: "Mi stock",
+    description: "Tu stock físico en el depósito (solo tus productos). Requiere tener depósito o control de stock habilitado.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/wms/stock")));
+
+  tool("mi_disponible", {
+    title: "Mi disponible para vender",
+    description: "Disponible-para-vender por SKU = stock físico − comprometido en pedidos pendientes. Marca ⚠️ cuando un SKU está por debajo del mínimo. Solo tus productos.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/wms/stock/disponible")));
+
+  tool("mi_rentabilidad", {
+    title: "Mi rentabilidad por SKU",
+    description: "Margen por SKU en un rango (default: mes en curso) = precio de venta − costo de envío real − COGS opcional. Solo tus productos. Fechas YYYY-MM-DD.",
+    inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
+  }, async ({ desde, hasta }) => run(() => api("GET", `/wms/rentabilidad${q({ desde, hasta })}`)));
+
+  tool("mis_productos", {
+    title: "Mi catálogo",
+    description: "Tu catálogo de productos en el depósito.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/wms/productos")));
+
+  tool("mis_top_productos", {
+    title: "Mis productos más despachados",
+    description: "Ranking de TUS productos más despachados en un rango (default: mes en curso). Solo tus productos.",
+    inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
+  }, async ({ desde, hasta }) => run(() => api("GET", `/wms/top-productos${q({ desde, hasta })}`)));
+  tool("mis_sucursales", {
+    title: "Mis sucursales / puntos de retiro",
+    description: "Tus sucursales (puntos de retiro) con dirección, horario de corte y ventanas. La sucursal principal es tu dirección de retiro. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/portal/sucursales")));
+  tool("mi_colecta", {
+    title: "Estado de mi colecta",
+    description: "Cómo está tu colecta (retiro): si la colecta AUTOMÁTICA está prendida, si pediste una por única vez, y el aviso de costo (si te cobran cuando llevás menos de X envíos). Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/portal/colecta")));
+}
+
+// ============================================================================
+//  ROL MENSAJERO — su ruta y colectas (para saber cuántos envíos tendrá).
+// ============================================================================
+if (rol === "mensajero") {
+  tool("mi_ruta", {
+    title: "Mi ruta del día",
+    description: "Tus entregas asignadas (paradas de la ruta del día). Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/flujo/mi-ruta")));
+  tool("mis_colectas", {
+    title: "Mis colectas (retiros)",
+    description: "Las colectas/retiros que tenés asignados. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/colecta/mis-colectas")));
+}
+
+// ============================================================================
+//  ROL STAFF DE NODO — datos de SU nodo (gateado por permiso; el backend fuerza el nodo).
+// ============================================================================
+if (isStaff) {
+  if (puede("gestion")) {
+    tool("clientes_del_nodo", {
+      title: "Clientes y listas del nodo",
+      description: "Clientes/vendedores del nodo con su lista de precio asignada, más las listas disponibles. Scopeado a tu nodo.",
+      inputSchema: {},
+    }, async () => run(() => api("GET", "/gestion/formularios")));
+    tool("sin_vendedor", { title: "Cuentas de ML y envíos sin vendedor", description: "Cuentas de Mercado Libre y envíos cargados con foto que tu nodo tiene SIN VENDEDOR (típico de un nodo recién dado de alta, o de etiquetas de cuentas no vinculadas que se escanearon). Devuelve `cuentas` (por cuenta de ML: cuántos envíos, ejemplos de destinatarios, si ya está vinculada) y `envios` (los cargados con foto, con la pista de la etiqueta), y los `clientes` del nodo (con si tienen usuario). Después usá `asignar_sin_vendedor`. Admin global: pasá `nodo`. No mueve dinero.", inputSchema: { nodo: zNodo() } },
+      async ({ nodo }) => run(() => api("GET", `/sin-vendedor${q({ nodo })}`)));
+    if (ALLOW_WRITE)
+      tool("asignar_sin_vendedor", {
+        title: "Asignar cuentas de ML / envíos sin vendedor a un vendedor (+ enlaces)",
+        description: "Asigna a UN vendedor las cuentas de ML y/o envíos que el nodo tiene sin vendedor (ver `sin_vendedor`). En un paso: cada cuenta queda asociada al vendedor y TODOS sus envíos sin vendedor pasan a ser de él; los envíos con foto elegidos también; si el vendedor no tiene usuario y pasás `usuarioEmail`/`usuarioNombre`/`usuarioApellido` (de la PERSONA que entra), se le crea con clave temporal; y devuelve UN ENLACE DE VINCULACIÓN por cada cuenta de ML para mandárselo (vence en 48 hs). Cuando el vendedor lo autoriza, lo que quede de esa cuenta se le engancha solo. Vendedor: `idCliente` de tu nodo, o `nuevoVendedor` (nombre) para crearlo. No mueve dinero.",
+        inputSchema: {
+          idCliente: z.number().optional().describe("Vendedor existente de tu nodo"),
+          nuevoVendedor: z.string().optional().describe("Nombre de un vendedor NUEVO (se crea en tu nodo)"),
+          telefono: z.string().optional().describe("Teléfono del vendedor nuevo (opcional)"),
+          cuentasML: z.array(z.string()).optional().describe("Cuentas de ML (el número de usuario, de `sin_vendedor`)"),
+          envioIds: z.array(z.number()).optional().describe("Envíos cargados con foto (ids de `sin_vendedor`)"),
+          usuarioEmail: z.string().optional().describe("Si el vendedor no tiene usuario: email de login de la persona"),
+          usuarioNombre: z.string().optional(),
+          usuarioApellido: z.string().optional(),
+          nodo: z.number().optional().describe("Solo admin global"),
+        },
+      }, async (a) => run(() => api("POST", "/sin-vendedor/asignar", {
+        idCliente: a.idCliente, nuevo: a.nuevoVendedor ? { nombre: a.nuevoVendedor, telefono: a.telefono } : undefined,
+        usuario: a.usuarioEmail ? { email: a.usuarioEmail, nombre: a.usuarioNombre, apellido: a.usuarioApellido } : undefined,
+        cuentasML: a.cuentasML, envioIds: a.envioIds, nodo: a.nodo,
+      })));
+  }
+
+  if (puede("precios")) {
+    tool("precios_ver", {
+      title: "Ver listas de precios",
+      description: "Las listas de precios (por zona: cercana/media/lejana/muy lejana) de tu nodo. Solo lectura.",
+      inputSchema: {},
+    }, async () => run(() => api("GET", "/precios/clientes")));
+  }
+
+  if (puede("reportes")) {
+    tool("kpi_nodo", {
+      title: "Métricas del nodo",
+      description: "Tablero del nodo: volumen y entregas con variación mensual, P&L real, top de clientes y clientes en caída. Solo lectura, scopeado a tu nodo.",
+      inputSchema: { desde: z.string().optional().describe("Fecha YYYY-MM-DD (pasá desde y hasta juntas; si falta una, usa el mes en curso)"), hasta: z.string().optional().describe("Fecha YYYY-MM-DD"), nodo: zNodo() },
+    }, async ({ desde, hasta, nodo }) => run(() => api("GET", `/kpi/nodo${q({ desde, hasta, nodo })}`)));
+  }
+
+  if (puede("wms") && wmsActivo) {
+    tool("stock_nodo", {
+      title: "Stock del nodo",
+      description: "Stock del depósito del nodo. Opcional: filtrar por un cliente.",
+      inputSchema: { cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
+    }, async ({ cliente }) => run(() => api("GET", `/wms/stock${q({ cliente })}`)));
+
+    tool("productos_nodo", {
+      title: "Catálogo del nodo",
+      description: "Catálogo de productos del depósito del nodo. Opcional: filtrar por cliente.",
+      inputSchema: { cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
+    }, async ({ cliente }) => run(() => api("GET", `/wms/productos${q({ cliente })}`)));
+
+    tool("top_productos", {
+      title: "Productos más despachados del nodo",
+      description: "Ranking de productos más despachados del nodo en un rango (default: mes en curso). Opcional: filtrar por un cliente.",
+      inputSchema: { desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD"), cliente: z.string().optional().describe("Id del cliente de tu nodo (de `clientes_del_nodo`); no acepta nombre") },
+    }, async ({ desde, hasta, cliente }) => run(() => api("GET", `/wms/top-productos${q({ desde, hasta, cliente })}`)));
+  }
+}
+
+if (isStaff && puede("finanzas")) {
+  tool("cuenta_semanal_nodos", {
+    title: "Cuenta semanal con otros nodos (juntada)",
+    description: "La cuenta de TU nodo con cada nodo con el que se pasaron paquetes por un grupo (Bonorino, Portela…): semana de lunes a sábado que se congela el miércoles siguiente. Cada paquete vale la tarifa del nodo que lo recibe; por nodo se netea (neto > 0: te pagan; < 0: pagás vos). Sin `cierre`: lo que todavía NO se cerró (en vivo). Con `cierre` (id): ese cierre congelado. `lista:true` = tus cierres con su neto. Solo lectura, no mueve dinero. El admin global elige el nodo con `nodo`.",
+    inputSchema: {
+      cierre: z.number().int().positive().optional().describe("id del cierre semanal (de `lista`)"),
+      lista: z.boolean().optional().describe("true = listar tus cierres semanales"),
+      nodo: zNodo(),
+    },
+  }, async ({ cierre, lista, nodo }) =>
+    run(() => api("GET", lista ? `/logisticas/mis-cierres${q({ nodo })}` : cierre ? `/logisticas/mis-cierres/${cierre}${q({ nodo })}` : `/logisticas/mis-cierres/sin-cerrar${q({ nodo })}`)));
+}
+
+// ============================================================================
+//  ROL GLOBAL (superadmin / superoperador)
+// ============================================================================
+if (esGlobal) {
+  tool("cierre_semanal_links", {
+    title: "Links del cierre semanal para cada nodo",
+    description: "Para cada nodo de un cierre semanal (el último si no pasás `cierre`), el link de su cuenta de esa semana. El link NO muestra la cuenta sin login: si el nodo todavía no tiene usuario, le pide mail, contraseña, nombre y apellido y lo da de alta (una sola vez por nodo, con el primer link que abra); si ya tiene, lo manda a entrar y ve la cuenta con todos los nodos adentro. Primero los que NO tienen usuario: a esos pasáselo vos por WhatsApp. Solo admin global. Solo lectura.",
+    inputSchema: { cierre: z.number().int().positive().optional().describe("id del cierre (default: el último)") },
+  }, async ({ cierre }) => run(() => api("GET", `/logisticas/cierres-semanales/links${q({ cierre })}`)));
+
+  tool("nodos_listar", {
+    title: "Listar nodos",
+    description: "Lista todas las logísticas (nodos) con sus conteos. Solo admin global.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/logisticas")));
+
+  tool("nodo_renombrar", {
+    title: "Cambiar el nombre real de un nodo",
+    description: "Cambia la razón social (nombre real) de un nodo — lo ve TODO el mundo (a diferencia de `nodo_alias_poner`, que es un apodo personal tuyo). Solo admin global. No toca dinero.",
+    inputSchema: {
+      nodo: z.string().min(1).describe("Nombre actual (o tu apodo) del nodo"),
+      nombreNuevo: z.string().min(1).describe("Nombre nuevo"),
+    },
+  }, async ({ nodo: nodoQ, nombreNuevo }) => run(async () => {
+    const lr = await api("GET", "/flujo/logisticas-select");
+    if (!lr.ok) return lr;
+    const lista = lr.data ?? [];
+    const q2 = nodoQ.trim().toLowerCase();
+    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q2) || (l.alias ?? "").toLowerCase().includes(q2));
+    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
+    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
+    return api("PUT", `/logisticas/${cands[0].id}`, { nombre: nombreNuevo });
+  }));
+
+  tool("kpi_red", {
+    title: "Métricas de la red (SaaS)",
+    description: "KPIs globales de toda la red de nodos (crecimiento, operacional, volumen de clearing). Solo admin global.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/kpi/saas")));
+
+  tool("usuario_habilitar_rol", {
+    title: "Habilitar/deshabilitar un rol de administración",
+    description: "Habilita o deshabilita a un usuario (por id) como superoperador (global) y/o admin de nodo. Solo admin global. El backend exige un superadmin real para otorgar superoperador. Pasá al menos uno de los flags (true = habilitar, false = quitar). No toca dinero.",
+    inputSchema: { id: z.number().int().positive(), esSuperoperador: z.boolean().optional(), esAdminNodo: z.boolean().optional() },
+  }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/${id}`, body)));
+
+  tool("grupo_crear", {
+    title: "Crear grupo logístico",
+    description: "Crea un grupo logístico nuevo (para clearing entre nodos; los nodos se agregan/tarifan después). Solo admin global. No toca dinero.",
+    inputSchema: { nombre: z.string().min(1) },
+  }, async ({ nombre }) => run(() => api("POST", "/logisticas/grupos", { nombre })));
+
+  tool("logo_subir", {
+    title: "Subir logo / marca de un nodo (marca blanca)",
+    description: "Sube o actualiza el logo y la marca de un nodo (marca blanca). El logo va como data-URI base64 (ej. data:image/png;base64,...). Solo admin global. No toca dinero.",
+    inputSchema: { nodo: z.number().int().positive().describe("Id del nodo (de `nodos_listar`)"), logo: z.string().min(1).describe("imagen en data-URI base64, ej. data:image/png;base64,..."), marca: z.string().optional(), slug: z.string().optional(), color: z.string().optional() },
+  }, async ({ nodo, logo, marca, slug, color }) => run(() => api("PUT", `/logisticas/${nodo}/branding`, { logo, marca, slug, color })));
+
+  tool("sugerencias_listar", {
+    title: "Sugerencias de usuarios (admin)",
+    description: "Solo superadmin: todas las sugerencias de la red (funciones nuevas/mejoras/bugs) con usuario, rol, nodo, estado. Filtrá por `rol` y/o `estado`. Para las propias está `mis_sugerencias`. Solo lectura.",
+    inputSchema: { rol: z.string().optional(), estado: z.string().optional().describe("nueva | vista | en_evaluacion | implementada | descartada") },
+  }, async ({ rol, estado }) => run(() => api("GET", `/feedback/sugerencias${q({ rol, estado })}`)));
+}
+
+// ============================================================================
+//  VINCULACIÓN DE TIENDAS — genera el enlace de autorización (OAuth) para traer las
+//  ventas de una tienda a Nexus Flex. Un vendedor genera el SUYO; el staff (permiso
+//  gestion) puede generarlo PARA un cliente de SU nodo y mandárselo. No toca dinero.
+// ============================================================================
+if (isCliente || (isStaff && puede("gestion"))) {
+  tool("generar_enlace_vinculacion", {
+    title: "Generar enlace de vinculación de tienda",
+    description: "Genera el enlace (link) para vincular una tienda —Mercado Libre, TiendaNube o Tienda Negocio— y traer sus ventas a Nexus Flex. Si sos vendedor genera el TUYO; si sos staff podés generarlo PARA un cliente de tu nodo pasando 'cliente' y mandarle ese enlace para que lo autorice desde su propia cuenta de la tienda. El enlace vence en 48 hs. No toca dinero.",
+    inputSchema: {
+      proveedor: z.enum(["ml", "tiendanube", "tiendanegocio"]).describe("ml = Mercado Libre · tiendanube · tiendanegocio"),
+      cliente: z.string().optional().describe("Solo staff: nombre o id del cliente de tu nodo"),
+    },
+  }, async ({ proveedor, cliente }) => run(() => api("GET", `/${proveedor}/auth${q({ cliente })}`)));
+}
+
+// ============================================================================
+//  RENDICIONES (lectura) + ZONAS DE REPARTO (mensajeros por zona)
+// ============================================================================
+if (isCliente || isStaff || rol === "mensajero") {
+  tool("rendiciones", {
+    title: "Rendiciones (a recuperar / a rendir)",
+    description: "Estado de rendiciones: cobros/cambios/devoluciones pendientes de recuperar o rendir, con totales y quién tiene cada uno. Scopeado a tu alcance (vendedor: lo tuyo; nodo: tu nodo). Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/flujo/rendiciones")));
+}
+
+// Reclamos de clientes ligados a liquidaciones (vendedor: lo suyo; operador: su nodo).
+if (isCliente || isStaff) {
+  tool("reclamos_listar", {
+    title: "Reclamos de clientes (liquidaciones)",
+    description: "Reclamos abiertos de clientes ligados a liquidaciones/rendiciones: tipo, estado, trackings en disputa, detalle. Sirve para ver qué cobros/rendiciones pendientes tienen reclamo. Vendedor ve lo suyo, operador su nodo. Solo lectura.",
+    inputSchema: { estado: z.string().optional().describe("abierto | resuelto") },
+  }, async ({ estado }) => run(() => api("GET", `/feedback/reclamos${q({ estado })}`)));
+}
+
+// ── ADMIN DE GRUPO ──  Los nodos originales de un grupo son sus admins; gestionan quién está
+//  adentro y quién administra. Ver miembros lo puede cualquier miembro; sumar/expulsar/permiso
+//  solo un admin del grupo (o admin global). Nunca se deja un grupo sin admin. No mueve dinero.
+if (isStaff) {
+  tool("grupos_tarifas", {
+    title: "Grupos logísticos con sus tarifas de clearing",
+    description: "Los grupos logísticos de tu nodo (admin global: todos) con los nodos que los integran y la TARIFA de clearing vigente de cada uno por zona (cercana / media / lejana / muy lejana). Es lo que hay que mirar para auditar por qué un traspaso entre nodos se cobró lo que se cobró: el tramo usa el precio del nodo en ESE grupo. `grupo_miembros` muestra quién está; esto muestra a cuánto. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/logisticas/grupos")));
+  tool("grupo_miembros", {
+    title: "Miembros de un grupo logístico",
+    description: "Lista los nodos de un grupo (por id), marcando quién es ADMIN de grupo y si vos lo sos. El id del grupo sale de `grupos_tarifas`. Solo miembros del grupo. Solo lectura.",
+    inputSchema: { grupo: z.number().int().positive().describe("id del grupo") },
+  }, async ({ grupo }) => run(() => api("GET", `/qr/grupo/${grupo}/miembros`)));
+  tool("grupo_sumar_nodo", {
+    title: "Sumar un nodo al grupo (admin de grupo)",
+    description: "Agrega un nodo (por id) a un grupo. Solo un ADMIN del grupo (o admin global) puede. El nodo entra como miembro normal (sin permiso de admin). No mueve dinero.",
+    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo a sumar") },
+  }, async ({ grupo, nodo }) => run(() => api("POST", "/qr/grupo-sumar", { grupoId: grupo, logisticaId: nodo })));
+  tool("grupo_expulsar_nodo", {
+    title: "Expulsar un nodo del grupo (admin de grupo)",
+    description: "Saca un nodo (por id) de un grupo. Solo un ADMIN del grupo (o admin global). No se puede expulsar al último admin (pasá antes el permiso a otro nodo). No mueve dinero.",
+    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo a expulsar") },
+  }, async ({ grupo, nodo }) => run(() => api("POST", "/qr/grupo-expulsar", { grupoId: grupo, logisticaId: nodo })));
+  tool("grupo_admin_permiso", {
+    title: "Dar / sacar permiso de admin de grupo",
+    description: "Da o saca el permiso de ADMIN de grupo a un nodo del grupo (así otros pueden administrar, ej. si los originales se van). Solo un admin del grupo (o admin global). No se puede sacar el permiso al último admin. No mueve dinero.",
+    inputSchema: { grupo: z.number().int().positive().describe("id del grupo"), nodo: z.number().int().positive().describe("id del nodo"), admin: z.boolean().describe("true = darle admin, false = sacárselo") },
+  }, async ({ grupo, nodo, admin }) => run(() => api("POST", "/qr/grupo-permiso", { grupoId: grupo, logisticaId: nodo, esAdminGrupo: admin })));
+}
+
+// Consultar UN envío por tracking/código (cuando un vendedor pregunta "¿dónde está mi
+// envío X?"). Vendedor: solo entre SUS envíos; staff: dentro de su nodo.
+if (isCliente || isStaff) {
+  tool("envio_consultar", {
+    title: "Consultar un envío",
+    description: "Busca UN envío por tracking o código y devuelve su estado actual, el historial de estados (con fechas), destinatario, dirección y datos de cobro/cambio si tiene. Vendedor: solo entre SUS envíos; staff: dentro de su nodo. Úsalo cuando un vendedor pregunta por un pedido puntual.",
+    inputSchema: { codigo: z.string().min(1).describe("Tracking o código del envío (lo que manda el vendedor)") },
+  }, async ({ codigo }) => {
+    const code = String(codigo ?? "").trim();
+    if (!code) return { content: [{ type: "text", text: "Pasá un tracking o código de envío." }], isError: true };
+    const low = code.toLowerCase();
+    try {
+      if (isStaff) {
+        const lista = await api("GET", `/flujo/envios${q({ q: code })}`);
+        const rows = Array.isArray(lista.data) ? lista.data : [];
+        if (!rows.length) return { content: [{ type: "text", text: `No encontré un envío "${code}" en tu nodo.` }] };
+        const exact = rows.filter((e) => String(e.tracking ?? "").toLowerCase() === low);
+        const pick = exact.length ? exact : rows;
+        if (pick.length > 1)
+          return { content: [{ type: "text", text: `Varios envíos matchean "${code}". Elegí uno (pasá el tracking completo):\n${JSON.stringify(pick.slice(0, 10).map((e) => ({ id: e.id, tracking: e.tracking, estado: e.estado, cliente: e.cliente, destinatario: e.destinatario })), null, 2)}` }] };
+        return toResult(await api("GET", `/flujo/envios/${pick[0].id}`));
+      }
+      const lista = await api("GET", "/portal/envios");
+      const rows = Array.isArray(lista.data) ? lista.data : [];
+      let match = rows.filter((e) => String(e.tracking ?? "").toLowerCase() === low);
+      if (!match.length) match = rows.filter((e) => String(e.tracking ?? "").toLowerCase().includes(low));
+      if (!match.length) return { content: [{ type: "text", text: `No encontré un envío "${code}" entre tus envíos.` }] };
+      if (match.length > 1)
+        return { content: [{ type: "text", text: `Varios envíos matchean "${code}". Pasá el tracking completo:\n${JSON.stringify(match.slice(0, 10).map((e) => ({ id: e.id, tracking: e.tracking, estado: e.estado })), null, 2)}` }] };
+      return toResult(await api("GET", `/portal/envios/${match[0].id}`));
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }], isError: true };
+    }
+  });
+}
+
+// Métricas por tipo de envío (flex/tienda/manual) + % antes de 21hs + (red) por logística.
+if (isCliente || isStaff) {
+  tool("metricas_por_tipo", {
+    title: "Métricas por tipo de envío",
+    description: "Métricas por TIPO de envío (flex/tienda/manual): total, entregados, tasa de entrega y % ENTREGADO ANTES DE LAS 21hs. Admin/red desglosa por logística (qué nodo entrega mejor). Vendedor ve lo suyo, operador su nodo. Fechas YYYY-MM-DD (default: últimos 30 días).",
+    inputSchema: {
+      desde: z.string().optional().describe("YYYY-MM-DD"),
+      hasta: z.string().optional().describe("YYYY-MM-DD"),
+      nodo: z.number().optional().describe("Solo admin/superoperador: elegir nodo (si no, la red)"),
+    },
+  }, async ({ desde, hasta, nodo }) => run(() => api("GET", `/kpi/envios-por-tipo${q({ desde, hasta, nodo })}`)));
+}
+
+// Cuentas de tienda vinculadas (ML / TiendaNube / TiendaNegocio), scopeadas por rol.
+if (isCliente || isStaff) {
+  tool("cuentas_vinculadas", {
+    title: "Cuentas vinculadas (ML / TiendaNube / TiendaNegocio)",
+    description: "Cuántas cuentas de tienda hay vinculadas, con desglose por proveedor (Mercado Libre / TiendaNube / TiendaNegocio). Vendedor: las suyas; operador: las de los clientes de SU nodo (agrupadas por cliente); admin/superoperador: por nodo (o pasá `nodo` para bajar al desglose por cliente de ese nodo). Solo lectura.",
+    inputSchema: { nodo: z.number().optional().describe("Solo admin: baja al desglose por cliente de ese nodo") },
+  }, async ({ nodo }) => run(() => api("GET", `/cuentas-vinculadas${q({ nodo })}`)));
+}
+
+// Afiliados: comisión recurrente por envío (staff = admin global o admin de nodo, scopeado).
+if (isStaff) {
+  tool("afiliacion_listar", {
+    title: "Listar afiliaciones",
+    description: "Afiliaciones (afiliado↔entidad referida) con su comisión por envío, vigencia y estado. Filtrá por `afiliado` o `entidad`. Solo lectura, scopeado a tu nodo.",
+    inputSchema: { afiliado: z.string().optional(), entidad: z.string().optional() },
+  }, async ({ afiliado, entidad }) => run(() => api("GET", `/afiliados/afiliaciones${q({ afiliado, entidad })}`)));
+  tool("comisiones_afiliado_ver", {
+    title: "Comisiones de afiliados",
+    description: "Comisiones devengadas por envío (pendiente/liquidada) con totales. Filtrá por `afiliado` y rango de fechas. Solo lectura, scopeado a tu nodo.",
+    inputSchema: { afiliado: z.string().optional(), desde: z.string().optional().describe("YYYY-MM-DD"), hasta: z.string().optional().describe("YYYY-MM-DD") },
+  }, async ({ afiliado, desde, hasta }) => run(() => api("GET", `/afiliados/comisiones${q({ afiliado, desde, hasta })}`)));
+}
+
+// Choferes (mensajeros) del nodo — requiere permiso 'usuarios'.
+if (isStaff && puede("usuarios")) {
+  tool("chofer_listar", {
+    title: "Listar usuarios del nodo (choferes)",
+    description: "Usuarios de tu nodo (incluye los choferes = rol 'mensajero') con su id, nombre, teléfono, activo. Solo lectura, scopeado a tu nodo.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/usuarios")));
+}
+
+// Marketplace de rutas/colectas públicas (subasta abierta, cualquier nodo de la red).
+if (isStaff) {
+  tool("rutas_publicas", {
+    title: "Rutas/colectas públicas (marketplace)",
+    description: "Publicaciones ABIERTAS de toda la red que tu nodo puede tomar (con cuántas ofertas tiene cada una). Marca las tuyas (`esMia`). Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/rutas-publicas/publicas")));
+  tool("mis_rutas", {
+    title: "Mis publicaciones y ofertas (marketplace)",
+    description: "Tus publicaciones de rutas (con su estado/adjudicación) y las ofertas que hiciste a otros nodos. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/rutas-publicas/mias")));
+  tool("ruta_ofertas", {
+    title: "Ver ofertas de una publicación mía",
+    description: "Ofertas recibidas en una publicación TUYA (ordenadas por precio asc). Solo el que publicó. Usá el id de oferta para adjudicar.",
+    inputSchema: { publicacionId: z.number().int().positive() },
+  }, async ({ publicacionId }) => run(() => api("GET", `/rutas-publicas/${publicacionId}/ofertas`)));
+}
+
+if (isStaff) {
+  tool("nodo_alias_poner", {
+    title: "Ponerle un apodo personal a un nodo",
+    description: "Le ponés TU propio apodo a un nodo (ej. 'Flex Fácil' = 'Félix', el dueño) para reconocerlo más fácil: de ahí en más lo podés nombrar por ese apodo en cualquier herramienta que pida un nodo (asignar_nodo_zona, etc.) y también aparece en los buscadores de la app. Es PERSONAL — no lo ve otro usuario ni cambia el nombre real de la logística. Mandá `alias` vacío para sacarlo.",
+    inputSchema: {
+      nodo: z.string().min(1).describe("Nombre (o tu apodo actual) del nodo"),
+      alias: z.string().describe("El apodo nuevo (vacío para sacarlo)"),
+    },
+  }, async ({ nodo: nodoQ, alias }) => run(async () => {
+    const lr = await api("GET", "/flujo/logisticas-select");
+    if (!lr.ok) return lr;
+    const lista = lr.data ?? [];
+    const q = nodoQ.trim().toLowerCase();
+    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q) || (l.alias ?? "").toLowerCase().includes(q));
+    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
+    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
+    return api("POST", "/flujo/nodo-alias", { logisticaId: cands[0].id, alias });
+  }));
+}
+
+if (isStaff && puede("gestion")) {
+  tool("zonas_reparto", {
+    title: "Zonas de reparto (mensajeros por zona)",
+    description: "Lista las zonas de reparto de tu nodo con sus metazonas y qué mensajeros tiene asignado cada una. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/zonificacion/zonas-reparto")));
+
+  tool("zonas_simetria", {
+    title: "Chequear simetria de distancias entre zonas",
+    description: "Chequea la SIMETRIA de las distancias entre zonas: si desde el perfil de A un lugar B es 'cercana', desde el perfil de B el lugar A deberia ser 'cercana' tambien. Devuelve los pares que NO cumplen, los que faltan cargar en un sentido, y los perfiles que todavia no declararon en que lugar viven. SOLO INFORMA: no corrige ni completa nada, porque puede haber asimetrias legitimas (autopista, rio, barrera) y la decision es humana. Para que un grupo entre al chequeo hay que declararle su 'perfil de origen'.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/zonificacion/simetria")));
+
+  tool("zona_barrios", {
+    title: "Barrios/localidades de una zona",
+    description: "Consulta rápida: qué localidades y BARRIOS componen una zona con nombre (ej. 'Matanza Norte', 'CABA'), con su tramo por perfil. Buscás por nombre; devuelve las zonas que matchean (propias del nodo, globales o de tus grupos logísticos). Solo lectura. Usalo cuando te preguntan '¿qué barrios hay en <zona>?'.",
+    inputSchema: { zona: z.string().min(1).describe("Nombre de la zona, ej. 'Matanza Norte' o 'CABA'") },
+  }, async ({ zona }) => run(() => api("GET", `/zonificacion/zona-barrios${q({ zona })}`)));
+
+  tool("facturacion_estado", {
+    title: "¿Qué falta para facturar?",
+    description:
+      "Diagnóstico de facturación ARCA de tu nodo: qué emisores hay y si están completos, qué cuentas de dinero no tienen emisor propio, y por cada cliente exactamente qué dato le falta (CUIT, razón social, condición IVA, emisor, habilitación). Sin 'cliente' lista los YA habilitados; con 'cliente' (nombre o id) mira ese aunque no esté habilitado. NO devuelve importes ni emite nada: es estado de configuración. Empezá y terminá por acá cuando pongas a alguien a facturar (ver el flujo 'facturacion').",
+    inputSchema: { cliente: z.string().optional().describe("Nombre o id de un cliente puntual; vacío = los ya habilitados") },
+  }, async ({ cliente }) => run(() => api("GET", `/afip/estado${q({ cliente })}`)));
+
+  tool("colecta_ver", {
+    title: "Ver config de colectas",
+    description: "Resumen de valores de colecta del nodo: pago default del nodo, cobros por cliente y pagos pactados por cliente+mensajero. Solo lectura.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/colecta/config")));
+
+  tool("colecta_pendientes", {
+    title: "Colectas del día y de mañana",
+    description: "Panel de colectas de tu nodo. `items` = clientes a retirar HOY (con cuántos envíos, el corte y qué colecta está asignada a qué mensajero). `itemsManana` = clientes con envíos que entraron después del corte → van a la colecta de MAÑANA. `clientesSinEnvios` = vendedores del nodo SIN envíos cargados, a los que igual se los puede mandar a colectar (el cadete escanea los paquetes en la puerta). Solo lectura. Sirve para «¿quién levanta a tal cliente?» y «¿el cliente X tiene envíos para mañana?».",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/colecta/panel")));
+
+  tool("colecta_historial", {
+    title: "Historial de colectas (paquetes por día y cliente)",
+    description: "Paquetes COLECTADOS por día y por cliente en una fecha o rango (histórico, hasta 62 días), con quién los colectó. `desde` (aaaa-mm-dd, obligatorio), `hasta` (opcional, default = desde), `cliente` (nombre o id, opcional). Cuenta cada paquete una vez, en el día de Argentina en que se colectó (evento Colectado o colecta en la puerta). Solo tu nodo. Solo lectura. Sirve para «¿cuántos paquetes le levantamos a X el martes?».",
+    inputSchema: {
+      desde: z.string().describe("aaaa-mm-dd"),
+      hasta: z.string().optional().describe("aaaa-mm-dd; vacío = el mismo día"),
+      cliente: z.string().optional().describe("nombre (o parte) o id del cliente"),
+    },
+  }, async ({ desde, hasta, cliente }) => run(() => api("GET", `/colecta/historial${q({ desde, hasta, cliente })}`)));
+
+  tool("envios_por_zona", {
+    title: "Envíos que otros nodos te rutearon (por zona)",
+    description: "Envíos de OTROS nodos ruteados a tu nodo por zona de reparto, agrupados por zona (para aceptarlos o rechazarlos). Cada envío trae su id (usalo en procesar_zona/rechazar_zona). Solo lectura, tu nodo.",
+    inputSchema: {},
+  }, async () => run(() => api("GET", "/colecta/zonas-a-procesar")));
+
+  tool("asignar_mensajero_zona", {
+    title: "Asignar un mensajero a una zona",
+    description: "Asigna un mensajero (por nombre, de tu nodo) a una metazona/zona (ej. «asigná a Maxi la zona de Palermo»). Si ya existe una zona con esa metazona, le suma el mensajero; si no, la crea. No cruza nodos. El admin global elige el nodo con `nodo`.",
+    inputSchema: {
+      mensajero: z.string().min(1).describe("Nombre del mensajero (de tu nodo)"),
+      metazona: z.string().min(1).describe("Metazona/zona, ej. 'Palermo' o 'CABA'"),
+      nombre: z.string().optional().describe("Nombre de la zona (opcional)"),
+      nodo: zNodo(),
+    },
+  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/asignar-mensajero", { ...rest, logisticaId: nodo })));
+
+  tool("asignar_nodo_zona", {
+    title: "Asignar un NODO a una zona (grupo logístico)",
+    description: "Asigna un NODO COMPLETO (por nombre, de tu grupo logístico) a una metazona. Sin `grupo`: para cuando ese nodo cubre toda una localidad de TU zona (ej. «que RL cubra Portela») — suma el nodo como opción (nodoIds), sin cruzar fuera de tu grupo. CON `grupo` (ej. 'Bonorino'/'Portela'): MODO COMISIÓN — la zona es del GRUPO (no de un nodo dueño) y esto reasigna quién es el responsable; solo lo puede hacer un ADMIN de ese grupo (o el admin global). Acá `nodo` es el DESTINO (por nombre); el admin global elige el nodo DUEÑO de la zona sin-grupo con `logisticaId`.",
+    inputSchema: {
+      nodo: z.string().min(1).describe("Nombre del nodo (de tu grupo logístico) que cubre la zona"),
+      metazona: z.string().min(1).describe("Metazona/zona, ej. 'Portela' o 'CABA'"),
+      nombre: z.string().optional().describe("Nombre de la zona (opcional)"),
+      grupo: z.string().optional().describe("Nombre o id del grupo logístico (ej. 'Bonorino') — MODO COMISIÓN: la zona pasa a ser del grupo y solo su admin puede asignarla/reasignarla"),
+      logisticaId: z.number().int().positive().optional().describe("Solo admin global y sin `grupo`: id del nodo DUEÑO de la zona sobre el que operás. El operador de nodo lo ignora."),
+    },
+  }, async (args) => run(() => api("POST", "/zonificacion/zonas-reparto/asignar-nodo", args)));
+
+  tool("zona_dejar", {
+    title: "Dejar de ser responsable de una zona de grupo",
+    description: "Te sacás (a tu nodo) de una zona de un grupo logístico (ej. Bonorino) que tenías asignada — self-service, solo podés sacarte a VOS. Si eras el único responsable, la zona pasa a LIBERADA y se avisa a TODO el grupo; solo la comisión (admin del grupo) la puede volver a asignar con `asignar_nodo_zona` + `grupo`.",
+    inputSchema: {
+      grupo: z.string().min(1).describe("Nombre o id del grupo"),
+      metazona: z.string().min(1).describe("Metazona/zona que dejás"),
+      nodo: zNodo(),
+    },
+  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/dejar", { ...rest, logisticaId: nodo })));
+
+  tool("nodo_link_confirmacion", {
+    title: "Link de confirmación sin login para un nodo",
+    description: "Devuelve el link FIJO (sin login) donde un nodo sin usuarios propios (ej. un integrante 'feeder' de un grupo que solo deja paquetes) ve los envíos que le asignaron como responsable de zona y los confirma con un toque. Se lo pasás por WhatsApp a mano — el nodo no tiene teléfono cargado para mandárselo solo. Mismo link siempre para ese nodo (se genera la primera vez).",
+    inputSchema: { nodo: z.string().min(1).describe("Nombre o apodo del nodo") },
+  }, async ({ nodo: nodoQ }) => run(async () => {
+    const lr = await api("GET", "/flujo/logisticas-select");
+    if (!lr.ok) return lr;
+    const lista = lr.data ?? [];
+    const q2 = nodoQ.trim().toLowerCase();
+    const cands = lista.filter((l) => l.nombre.toLowerCase().includes(q2) || (l.alias ?? "").toLowerCase().includes(q2));
+    if (cands.length === 0) return { ok: false, status: 404, data: { message: `No encontré un nodo "${nodoQ}".` } };
+    if (cands.length > 1) return { ok: false, status: 409, data: { message: `Varios nodos matchean "${nodoQ}": ${cands.map((c) => c.nombre).join(", ")}. Sé más específico.` } };
+    return api("POST", "/logisticas/link-confirmacion", { logisticaId: cands[0].id });
+  }));
+
+  tool("zonas_grupo", {
+    title: "Zonas de un grupo logístico y quién las cubre",
+    description: "Lista las zonas de un grupo logístico (ej. Bonorino/Portela) con el nodo responsable de cada una, marcando las LIBERADAS (sin responsable) y si vos podés reasignarlas (`puedoAsignar`, solo comisión/admin global). Visible a cualquier miembro del grupo. Solo lectura.",
+    inputSchema: { grupo: z.string().min(1).describe("Nombre o id del grupo") },
+  }, async ({ grupo }) => run(() => api("GET", `/zonificacion/zonas-reparto-grupo${q({ grupo })}`)));
+
+  tool("zona_mover_metazona", {
+    title: "Mover una metazona entre zonas de un grupo",
+    description: "Reclasifica UNA metazona/localidad: la saca de la zona de grupo que la contiene y la mete en OTRA zona del MISMO grupo, sin tocar el nodo responsable (ej. 'El Palomar' está mal puesto en Morón y va a Tres de Febrero, del que es partido). Solo la comisión (admin) del grupo o el admin global. No mueve dinero.",
+    inputSchema: {
+      grupo: z.string().min(1).describe("Nombre o id del grupo (ej. 'Portela')"),
+      metazona: z.string().min(1).describe("Metazona/localidad a mover (ej. 'El Palomar')"),
+      zonaDestino: z.string().min(1).describe("Zona destino: nombre, id, o una metazona que ya tenga (ej. 'Tres de Febrero')"),
+      nodo: zNodo(),
+    },
+  }, async ({ nodo, ...rest }) => run(() => api("POST", "/zonificacion/zonas-reparto/metazona-mover", { ...rest, logisticaId: nodo })));
+
+  tool("zona_componer_grupo", {
+    title: "Componer una zona de grupo (metazonas + nodo)",
+    description: "Crea o edita una zona de un grupo logístico: la ubica por nombre/id (o la crea con ese nombre), le puede sumar un NODO responsable y AGREGA/QUITA metazonas de su composición. Sirve para armar las zonas de un grupo NUEVO con su composición completa — importante para el ruteo, que matchea por metazona exacta (ej. una zona 'Flores' que cubra 'CABA · Flores' y 'Flores'). Solo la comisión (admin) del grupo o el admin global. No mueve dinero.",
+    inputSchema: {
+      grupo: z.string().min(1).describe("Nombre o id del grupo"),
+      zona: z.string().min(1).describe("Zona: nombre o id. Si no existe en el grupo, se crea con ese nombre."),
+      nodo: z.string().optional().describe("Nombre del nodo responsable a sumar a la zona (opcional)"),
+      agregar: z.array(z.string()).optional().describe("Metazonas a AGREGAR a la zona (ej. ['CABA · Flores','Flores'])"),
+      quitar: z.array(z.string()).optional().describe("Metazonas a QUITAR de la zona"),
+      nombre: z.string().optional().describe("Nombre para la zona si se crea (default: el valor de `zona`)"),
+      logisticaId: z.number().int().positive().optional().describe("Solo admin global: id del nodo (de la comisión) sobre el que operás. El operador de nodo lo ignora."),
+    },
+  }, async (args) => run(() => api("POST", "/zonificacion/zonas-reparto/grupo-componer", args)));
+
+  tool("grupo_tarifa_set", {
+    title: "Setear la tarifa de clearing de un grupo",
+    description: "Fija la tarifa de clearing por zona (cercana/media/lejana/muyLejana) de TODO un grupo logístico de una: el DEFAULT del grupo y el precio de CADA nodo miembro (su fila vigente). Sirve para dejar un grupo nuevo con su tarifa sin ir nodo por nodo (ej. 2700 en los 4 tramos). Con `soloDef` toca solo el default (no los nodos). Solo la comisión (admin) del grupo o el admin global. Es CONFIG del clearing — NO mueve dinero.",
+    inputSchema: {
+      grupo: z.string().min(1).describe("Nombre o id del grupo"),
+      cercana: z.number().optional().describe("Tarifa zona cercana"),
+      media: z.number().optional().describe("Tarifa zona media"),
+      lejana: z.number().optional().describe("Tarifa zona lejana"),
+      muyLejana: z.number().optional().describe("Tarifa zona muy lejana"),
+      soloDef: z.boolean().optional().describe("true = solo el default del grupo, sin tocar los nodos miembro"),
+    },
+  }, async (args) => run(() => api("POST", "/qr/grupo-tarifa-grupal", args)));
+}
+
+// ============================================================================
+//  ESCRITURA (opt-in por flag · NUNCA dinero). Además gateado por permiso en el backend.
+// ============================================================================
+if (ALLOW_WRITE) {
+  if (isCliente) {
+    tool("sucursal_guardar", {
+      title: "Crear/editar sucursal (punto de retiro)",
+      description: "Crea o edita una sucursal tuya (punto de retiro). Para cambiar tu DIRECCIÓN DE RETIRO editá la sucursal principal (o creá una con principal=true). id vacío = nueva sucursal. Geocodifica la dirección sola. No toca dinero.",
+      inputSchema: {
+        id: z.number().optional().describe("id de la sucursal a editar; vacío = nueva"),
+        nombre: z.string().min(1),
+        direccion: z.string().optional(),
+        principal: z.boolean().optional().describe("true = pasa a ser tu dirección de retiro principal"),
+        horarioCorte: z.string().optional().describe("HH:MM"),
+        ventana1Desde: z.string().optional(), ventana1Hasta: z.string().optional(),
+        ventana2Desde: z.string().optional(), ventana2Hasta: z.string().optional(),
+      },
+    }, async (args) => run(() => api("POST", "/portal/sucursales", args)));
+    tool("colecta_solicitar", {
+      title: "Solicitar colecta (por única vez)",
+      description: "Pedís que te retiren los envíos POR ÚNICA VEZ, aunque tengas la colecta automática apagada. Aparecés en el panel de colecta de tu nodo. Devuelve el aviso de costo (si te cobran cuando llevás menos de X envíos). No mueve dinero.",
+      inputSchema: {},
+    }, async () => run(() => api("POST", "/portal/colecta/solicitar")));
+    tool("colecta_auto", {
+      title: "Prender/apagar colecta automática",
+      description: "Activás (true) o desactivás (false) tu colecta AUTOMÁTICA. Apagada = llevás los envíos al depósito y no te retiran (salvo que pidas una por única vez con colecta_solicitar). No mueve dinero.",
+      inputSchema: { activa: z.boolean() },
+    }, async ({ activa }) => run(() => api("PUT", "/portal/colecta/auto", { activa })));
+  }
+  if (isCliente || (isStaff && puede("gestion")) || rol === "mensajero") {
+    tool("envio_cargar", {
+      title: "Cargar un envío (y etiqueta)",
+      description: "Registra un envío nuevo (queda 'A retirar') y devuelve el tracking + un LINK a la etiqueta imprimible + un LINK para subir una foto del envío desde el celular. El vendedor lo carga para sí mismo; el staff pasa `cliente` (nombre, de su nodo); el MENSAJERO pasa `cliente` y SOLO puede registrar clientes de su nodo o que haya colectado (marketplace incluido). Datos obligatorios: destinatario, telefono, direccion, localidad. Si el envío NO es de HOY (planilla que se carga días después), pasá `fecha` — es la que define en qué SEMANA se liquida. No toca dinero (montoCobro es el cobro contra entrega, no un movimiento).",
+      inputSchema: {
+        cliente: zStr().describe("Staff y mensajero: el vendedor del envío (staff: nombre, de tu nodo; mensajero: nombre o id, de tu nodo o que hayas colectado). El vendedor NO lo manda."),
+        destinatario: z.string().min(1).describe("Nombre de quien recibe"),
+        telefono: z.union([z.string().min(1), z.number()]).transform((x) => String(x)).describe("Teléfono del destinatario (obligatorio: el backend rechaza el envío sin él)"),
+        direccion: z.string().min(1),
+        localidad: z.string().min(1),
+        cp: zStr(),
+        montoCobro: zNum().describe("Cobro contra entrega (opcional)"),
+        esCambio: z.boolean().optional(),
+        detalleCambio: z.string().optional(),
+        comentarios: z.string().optional(),
+        fecha: zStr().describe("Solo staff — fecha del envío (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: para planillas que se cargan días después. Define en qué SEMANA se liquida el envío, así que no se admite una fecha futura."),
+        forzarNuevo: z.boolean().optional().describe("Solo si te respondió POSIBLE DUPLICADO (409): true = es OTRO paquete distinto (dos compras a la misma dirección) y hay que cargarlo igual. Si es el MISMO paquete, NO lo mandes: usá el tracking existente."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/cargar-mcp", args)));
+  }
+  if (isStaff || rol === "mensajero") {
+    tool("envio_desde_etiqueta_ml", {
+      title: "Registrar envío desde una etiqueta de Mercado Libre (foto)",
+      description: "Da de alta (o completa) un envío de Mercado Libre a partir de la etiqueta. El vendedor se resuelve por `mlQr`; si no, por `mlSenderId` (cuenta vinculada o aprendida); si no, por `cliente`. Si no se conoce, devuelve 404 con el senderId: preguntale al usuario de quién es. Es idempotente: si el envío ya estaba cargado no se duplica (se completa y, con `avanzarA`, se avanza). `nodoEntrega`: el nodo que lo entregó (control por foto). Dígitos ilegibles en la altura de la dirección: un '*' por cada uno (ej. 'Aguirre 31**'), no los adivines. Devuelve {id, tracking, yaExistia, noAvanzado?}. No mueve dinero. Para una carpeta de fotos, ver `flujo control_por_foto`.",
+      inputSchema: {
+        cliente: zStr().describe("Vendedor por nombre/id (si no mandás mlSenderId)"),
+        mlSenderId: zStr().describe("sender_id del vendedor en ML (mapea a su cuenta vinculada)"),
+        mlShipmentId: zStr().describe("id de envío/tracking de ML leído de la etiqueta (se limpian espacios OCR)"),
+        mlQr: zStr().describe("Contenido CRUDO del QR de ML (el JSON {id, sender_id, hash_code…}). Alcanza solo: de ahí salen el número de envío y el vendedor, y sirve para reimprimir la etiqueta idéntica. Mandalo SIEMPRE que lo leas."),
+        destinatario: zStr(), telefono: zStr(),
+        direccion: zStr().describe("Dirección; si un dígito de la altura no se lee, poné '*' por cada uno (ej. 'Julian Aguirre 31**'), NO lo inventes"),
+        localidad: zStr(), cp: zStr(), zona: zStr(), barrio: zStr(),
+        avanzarA: z.enum(["colectado", "procesado", "entregado"]).optional().describe("Control por foto: avanza el envío EN UN PASO registrando CADA estado intermedio (atribuido a vos, el usuario MCP). 'colectado' / 'procesado' (En centro) / 'entregado' (recorre A retirar→Colectado→En centro→[grupo=En camino]→Entregado). 'entregado' es la vía rápida para el clearing entre nodos."),
+        autoRutear: z.boolean().optional().describe("Planilla: asigna automáticamente el NODO y/o MENSAJERO responsable de la ZONA de reparto del destino. Configurá antes los responsables con `asignar_nodo_zona`/`asignar_mensajero_zona`."),
+        grupo: zStr().describe("Control por foto: nombre o id de un GRUPO logístico tuyo (ej. 'Bonorino') — despacha por ese grupo (queda 'En camino', su mensajero es el integrante del grupo)."),
+        nodoEntrega: zStr().describe("Solo staff: nodo (nombre o id) que RECIBIÓ y entregó el paquete (ej. 'FastCorreo'). Es el que cobra el traspaso en el cierre semanal entre nodos. Sin `grupo` se deduce: si el cliente es de ese mismo nodo es un paquete propio (sin traspaso); si es de otro nodo, el grupo que comparten (si comparten varios, pedí `grupo`). Si el envío ya tenía otro nodo que entrega, no se pisa."),
+        fotoRuta: zStr().describe("RUTA LOCAL de la foto de la etiqueta en tu compu (ej. 'C:\\\\Users\\\\...\\\\Desktop\\\\etiquetas\\\\ml_123.jpg') — NO la imagen, solo la ruta, para reencontrar la foto. Mandala SIEMPRE que la dirección tenga '*'."),
+        montoCobro: zNum(), mensajero: zStr().describe("Mensajero que hizo el paquete (de tu nodo)"),
+        reusarEtiqueta: z.boolean().optional().describe("ML MANUAL (no vinculado): true = REUSA el mismo tracking/QR/etiqueta de ML que ya viene impreso (NO genera uno nuevo), lo marca 'ml_manual' y es idempotente. Usalo cuando el paquete YA está etiquetado por ML pero no está vinculado a una cuenta."),
+        forzarNuevo: z.boolean().optional().describe("Solo si te respondió POSIBLE DUPLICADO (409): true = es OTRO paquete distinto (dos compras a la misma dirección) y hay que cargarlo igual. Si es el MISMO paquete, NO lo mandes: usá el tracking existente."),
+        fecha: zStr().describe("Solo staff — día REAL en que el paquete se movió (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: para planillas que se controlan días después. Define en qué SEMANA se liquida el envío (no se admite futura) y fecha TODA la cadena de `avanzarA`: cada estado queda con su hora de ESE día (Colectado 9, En centro 12, En camino 15, Entregado 18), no con la hora del control. Si el envío YA estaba cargado, también le mueve la fecha — y si ese período ya está liquidado, rechaza la llamada nombrando la liquidación en vez de dejarlo a medio corregir."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/desde-etiqueta", args)));
+    if (isStaff) registrarControlFoto();
+    tool("envio_procesar", {
+      title: "Procesar / recibir un envío en el centro",
+      description: "Marca un envío como PROCESADO / recibido en el centro de distribución (estado 'En centro de distribución') por su TRACKING, sin escanear — igual que la acción 'procesar' del escáner. Scopeado a tu nodo/grupo. No mueve dinero (registra el tramo de clearing del grupo, como `procesar_zona`).",
+      inputSchema: { tracking: zStr().describe("Tracking / código del envío a procesar") },
+    }, async ({ tracking }) => run(() => api("POST", "/flujo/escanear", { codigo: tracking, accion: "procesar" })));
+    tool("envio_entregar", {
+      title: "Marcar ENTREGADO un envío ya cargado",
+      description: "Marca ENTREGADO uno o varios envíos ya cargados, por tracking, sin foto ni firma. Usalo cuando no estás cargando desde una etiqueta (para eso está `envio_desde_etiqueta_ml` con `avanzarA`). Corre la entrega REAL: sella la logística de entrega para el clearing y le avisa al vendedor. Con `fecha` el historial dice el día REAL de entrega, no la hora del control; sobre un envío que YA figura entregado CORRIGE la fecha del cierre (vuelve en `fechaCorregida`), que es como se arregla una tanda cerrada con el día equivocado. Los que ya estaban entregados y no hay nada que corregirles vuelven en `yaEstaban` y no rompen el lote; los que están en un estado de EXCEPCIÓN (Cancelado, Devuelto al vendedor…) NO se entregan y vuelven en `errores` con su estado real. Staff, y solo envíos de tu nodo (admin global: cualquiera). No mueve dinero.",
+      inputSchema: {
+        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a marcar entregados (ej. ['TN-2057600163','NFABC123'])"),
+        fecha: zStr().describe("Día REAL de entrega (dd/mm/aaaa o aaaa-mm-dd) si NO es HOY: la tanda que se controla por foto días después queda en el historial con el día en que salió, no con el del control. No se admite futura. Cambia el evento 'Entregado' del historial, NO la semana en que se liquida el envío — esa se mueve con `envio_editar_fecha`."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/entregar-ref", args)));
+    tool("envio_completar_ciclo", {
+      title: "Reconstruir los pasos que le faltan a un envío ya cerrado",
+      description: "Rellena los pasos que le FALTAN a un envío ya cerrado: 'Colectado', 'En centro de distribución' y 'En camino', cada uno a nombre de QUIEN LO HIZO y fechado en el día real. Solo AGREGA lo que falta: no duplica un paso que ya está, no cambia el estado actual del envío y NO inventa autores (el paso del que no decís quién lo hizo, no se agrega). Pasá una persona por paso (nombre o id, del nodo); si el nombre matchea a varios te devuelve los candidatos con su id en vez de elegir por vos. Staff, y solo envíos de tu nodo. No mueve dinero (el mensajero se asigna con `envio_asignar_mensajero` y el grupo con `envio_asignar_grupo`).",
+      inputSchema: {
+        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a completar (ej. ['NFABC123','TN-2057600163'])"),
+        fecha: zStr().describe("Día REAL en que se hicieron esos pasos (dd/mm/aaaa o aaaa-mm-dd). Cada paso queda con su hora nominal de ese día: Colectado 9, En centro 12, En camino 15. No se admite futura."),
+        colectado: zStr().describe("Quién COLECTÓ (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
+        procesado: zStr().describe("Quién lo recibió EN EL CENTRO de distribución (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
+        enCamino: zStr().describe("Quién lo DESPACHÓ / salió a repartirlo (nombre o id, del nodo). Si no lo pasás, ese paso no se agrega."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/completar-ciclo", args)));
+    tool("envio_pago_mensajero", {
+      title: "Cargar lo que se le paga al mensajero por esos envíos",
+      description: "Carga LO QUE SE LE PAGA a quien repartió cada envío (el valor por envío) y, si al envío le falta el NOMBRE del mensajero, lo completa. Al mensajero se le paga por el nombre guardado en el envío (`Envio.mensajero`), no por el vínculo: este tool escribe valor + nombre. Usa el nombre con el que la persona está cargada (el apodo del resumen, ej. 'Maxi', no 'Maxi Sagarzazu'); en un VENDEDOR con doble rol, el de su cliente. Por defecto NO toca envíos que no estén entregados (un Cancelado o Devuelto vuelve en `noEntregados`); si igual querés pagarlos, pasá `incluirNoEntregados:true`. Si el envío no tiene mensajero y no pasás uno, vuelve en `sinMensajero` sin tocarse. Staff, y solo envíos de tu nodo.",
+      inputSchema: {
+        trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos a pagar (ej. ['NFABC123','TN-2057600163'])"),
+        valor: zNum().describe("Lo que se le paga POR ENVÍO, en pesos (ej. 2150). Se escribe igual en todos los que mandes."),
+        mensajero: zStr().describe("Opcional: nombre o id de quien repartió. Si lo pasás, lo ASIGNA y lo paga en un solo paso. Si no, usa el mensajero que el envío ya tenga."),
+        incluirNoEntregados: z.boolean().optional().describe("Opcional: true = pagar también los que NO están entregados (Cancelado, Devuelto…). Por defecto NO se tocan y vuelven listados."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/pago-mensajero", args)));
+    tool("envio_corregir_estado", {
+      title: "Corregir el estado de un envío",
+      description: "Corrige el ESTADO de un envío ya cargado, para DESHACER algo que quedó mal: un 'Entregado' que no fue, o un envío que una corrección revivió por error. Además de los estados del panel acepta los TERMINALES de excepción ('Cancelado', 'Rechazado por el comprador'). El `motivo` es OBLIGATORIO (mínimo 10 caracteres) y queda en el historial: una corrección sin explicación es indistinguible de un error. NO toca las banderas de devolución ni de cobro, y no mueve dinero. Staff, y solo envíos de tu nodo.",
+      inputSchema: { tracking: zStr().describe("Tracking del envío a corregir"), estado: zStr().describe("Estado destino (ej. 'Cancelado', 'En camino', 'Entregado')"), motivo: z.string().min(10).describe("Por qué se corrige. Queda en el historial del envío.") },
+    }, async (args) => run(() => api("POST", "/envios/corregir-estado", args)));
+    tool("envio_asignar_mensajero", {
+      title: "Asignar / quitar el mensajero de un envío",
+      description: "Asigna —o QUITA con `quitar:true`— el MENSAJERO de envíos ya cargados, por tracking. Busca entre todos los que pueden repartir (rol mensajero, `reparte`, o vendedor con doble rol); acepta id; si el nombre es ambiguo devuelve candidatos. No mueve dinero: el pago se liquida por NOMBRE (ver `envio_pago_mensajero`).",
+      inputSchema: { trackings: z.array(zStr()).min(1).describe("Tracking(s) de los envíos"), mensajero: zStr().optional().describe("Nombre o ID de quien repartió (rol mensajero, o alguien con reparto habilitado)"), quitar: z.boolean().optional().describe("true = deja el envío SIN mensajero asignado") },
+    }, async (args) => run(() => api("POST", "/envios/asignar-mensajero", args)));
+    tool("envio_estado", {
+      title: "Estado + ETA de un envío (¿cuándo llega?)",
+      description: "Devuelve una NARRATIVA del estado de un envío (por tracking) para responder '¿cuándo se entrega?': si está en camino, con qué mensajero, cuántos envíos lleva en la ruta, en qué posición va este y una ETA estimada (posición en la ruta × minutos por parada). Marca PROBLEMAS si los hay (nunca despachado, sin mensajero asignado, mensajero sin reportar ubicación hace rato). Es una estimación explicable, no una promesa exacta. Read-only, scopeado a tu nodo.",
+      inputSchema: { tracking: z.string().min(1).describe("Tracking del envío a consultar") },
+    }, async ({ tracking }) => run(() => api("GET", `/flujo/envio-estado?tracking=${encodeURIComponent(tracking)}`)));
+    tool("envios_trabados", {
+      title: "Envíos trabados del nodo (para destrabar / cerrar)",
+      description: "Lista los envíos TRABADOS de tu nodo, con el motivo: 'estancado' (mucho tiempo en 'A retirar'/'En centro' sin avanzar, ~nunca despachado), 'sin_mensajero' (en el centro pero sin mensajero asignado), 'mensajero_detenido' (en camino pero el mensajero no reporta ubicación hace rato) o 'en_camino_sin_cerrar' (en camino hace +24h sin cerrarse: candidato a cerrar; confirmá con el usuario antes de marcarlo entregado). Ordenados por severidad. Es la misma detección que alimenta el aviso proactivo a los operativos y admins del nodo. Read-only.",
+      inputSchema: {},
+    }, async () => run(() => api("GET", "/flujo/envios-trabados")));
+    tool("planilla_reporte", {
+      title: "Reporte de la planilla ML (control por foto)",
+      description: "Resumen de los envíos cargados por el método de planilla/control por foto (ml_manual) de tu nodo: total + desglose por CLIENTE, por ZONA y por ESTADO + suma de valor declarado y de monto a cobrar. Opcional: rango de fechas (desde/hasta, YYYY-MM-DD). Read-only.",
+      inputSchema: { desde: zStr().describe("Desde (YYYY-MM-DD), opcional"), hasta: zStr().describe("Hasta (YYYY-MM-DD), opcional") },
+    }, async ({ desde, hasta }) => run(() => api("GET", `/flujo/planilla-reporte${desde || hasta ? `?${new URLSearchParams({ ...(desde ? { desde } : {}), ...(hasta ? { hasta } : {}) }).toString()}` : ""}`)));
+    tool("nodo_provisorio_crear", {
+      title: "Crear un nodo PROVISORIO en un grupo (planilla ML)",
+      description: "Crea al vuelo un nodo PROVISORIO (placeholder) dentro de un grupo logístico, para atribuirle el clearing cuando el nodo real todavía no está dado de alta. No tiene login hasta que se concilie con el nodo real. Solo en grupos a los que pertenece TU nodo (el admin global, en cualquiera). Reusa el clearing por grupo. No mueve dinero.",
+      inputSchema: { nombre: z.string().min(1).describe("Nombre del nodo (ej. 'Nodo Avellaneda - provisorio')"), grupoId: z.number().int().positive().describe("Grupo logístico donde crearlo (de tus grupos)") },
+    }, async (args) => run(() => api("POST", "/flujo/nodo-provisorio", args)));
+    tool("provisorio_conciliar", {
+      title: "Conciliar un nodo provisorio con el nodo real",
+      description: "Cuando el nodo real YA está dado de alta, CONCILIA (fusiona) el provisorio: reatribuye sus envíos (origen/entrega) y su membresía de grupo al nodo real, y marca el provisorio como RESUELTO (queda desactivado). El clearing de esos envíos pasa a usar la tarifa del nodo real en el grupo. Aislamiento: como operador solo conciliás los provisorios que creó TU nodo y contra un nodo real que YA opera en ese grupo; si el nodo real todavía no está en el grupo hay que definirle la tarifa → eso lo hace el admin global con `tarifa`. No mueve dinero (reordena el clearing).",
+      inputSchema: {
+        provisorioId: z.number().int().positive().describe("Id del nodo provisorio a conciliar (lo devolvió `nodo_provisorio_crear`, o lo ves en `grupos_tarifas`)"),
+        nodoReal: z.string().min(1).describe("Nodo real destino: nombre o id (nodo ya dado de alta)"),
+        tarifa: z.object({ cercana: z.number().optional(), media: z.number().optional(), lejana: z.number().optional(), muyLejana: z.number().optional() }).optional().describe("Solo admin global y solo si el nodo real todavía NO opera en el grupo: tarifa (bandas) con la que se lo agrega."),
+        modo: z.enum(["absorber", "desde_ahora"]).optional().describe("absorber (default) = el nodo real se queda con el HISTORIAL del provisorio (reatribuye sus envíos y su grupo). desde_ahora = NO toca el historial; el clearing arranca de acá en adelante."),
+      },
+    }, async (args) => run(() => api("POST", "/flujo/conciliar-provisorio", args)));
+    tool("afiliado_crear", {
+      title: "Crear afiliado",
+      description: "Alta de un afiliado (quien trae volumen nuevo a la red). tipo: nodo|mensajero|externo; refId = id del nodo/mensajero (null si externo). Admin global o admin de nodo (scopeado a tu nodo). NO toca dinero.",
+      inputSchema: { nombre: z.string().min(1), tipo: z.enum(["nodo", "mensajero", "externo"]), refId: z.number().int().optional(), telefono: z.string().optional(), email: z.string().optional() },
+    }, async (args) => run(() => api("POST", "/afiliados", args)));
+    tool("afiliacion_crear", {
+      title: "Crear afiliación (comisión por envío)",
+      description: "Vincula un afiliado con una entidad referida (nodo o cliente) y su comisión RECURRENTE por envío. tipoComision: porcentaje|montoFijo. `porcentaje` se calcula sobre el valorDeclarado del envío (MVP); `montoFijo` = monto por envío. fechaExpiracion opcional (null = no vence). Una entidad = un solo afiliado activo. NO toca dinero (es config).",
+      inputSchema: { afiliado: z.string().min(1).describe("nombre o id"), entidadTipo: z.enum(["nodo", "cliente"]), entidad: z.string().min(1).describe("nombre o id del nodo/cliente referido"), tipoComision: z.enum(["porcentaje", "montoFijo"]), valorComision: z.number(), fechaExpiracion: z.string().optional().describe("YYYY-MM-DD") },
+    }, async (args) => run(() => api("POST", "/afiliados/afiliaciones", args)));
+    tool("afiliacion_editar", {
+      title: "Editar afiliación",
+      description: "Edita una afiliación: valorComision, fechaExpiracion (renovar/extender) y/o activa (des/reactivar). NO toca dinero.",
+      inputSchema: { id: z.number().int().positive(), valorComision: z.number().optional(), fechaExpiracion: z.string().optional().describe("YYYY-MM-DD; vacío = quitar vencimiento"), activa: z.boolean().optional() },
+    }, async ({ id, ...body }) => run(() => api("PUT", `/afiliados/afiliaciones/${id}`, body)));
+    if (esGlobal || esAdminNodo || permisos.includes("finanzas")) { // igual que el gate del backend
+      tool("comision_liquidar", {
+        title: "Liquidar comisiones de afiliado (registra pago)",
+        description: "Marca comisiones devengadas como LIQUIDADAS (registra el pago al afiliado). `ids` = lista de comisiones (de comisiones_afiliado_ver). Requiere permiso de finanzas. Scopeado a tu nodo.",
+        inputSchema: { ids: z.array(z.number().int().positive()).min(1) },
+      }, async ({ ids }) => run(() => api("POST", "/afiliados/comisiones/liquidar", { ids })));
+    }
+  }
+  if (puede("usuarios")) {
+    tool("chofer_crear", {
+      title: "Alta de chofer (mensajero) con clave temporal",
+      description: "Da de alta un chofer (rol mensajero) en TU nodo. El server genera una CLAVE TEMPORAL y la devuelve (pasásela al chofer; debe cambiarla al primer ingreso). Requiere nombre, apellido (por separado, los dos obligatorios), teléfono y email. El admin global elige el nodo con `nodo`.",
+      inputSchema: { nombre: z.string().min(1).describe("Nombre de pila"), apellido: z.string().min(1), telefono: z.string().min(1), email: z.string().min(3), mensajeroNombre: z.string().optional().describe("Nombre para el macheo con su cta cte (default: el nombre)"), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/chofer", { ...rest, logisticaId: nodo })));
+    tool("chofer_editar", {
+      title: "Editar un chofer",
+      description: "Edita un chofer (mensajero) de TU nodo: nombre, apellido, teléfono, mensajeroNombre y/o activo (desactivar/activar). No toca credenciales.",
+      inputSchema: { id: z.number().int().positive(), nombre: z.string().optional(), apellido: z.string().optional(), telefono: z.string().optional(), mensajeroNombre: z.string().optional(), activo: z.boolean().optional() },
+    }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/chofer/${id}`, body)));
+    tool("cliente_generar_usuario", {
+      title: "Generar usuario de login para un cliente/vendedor",
+      description: "Le crea las credenciales de login a un cliente/vendedor YA EXISTENTE de TU nodo (para que entre a su portal). Buscás el cliente por nombre o id (usá `clientes_del_nodo`) y pasás el `email` con el que va a loguear, más `nombre` y `apellido` de la PERSONA que va a usar el acceso (obligatorios; no el nombre de la tienda). El server genera una CLAVE TEMPORAL y la devuelve (pasásela al cliente; debe cambiarla al primer ingreso). Yo nunca invento la clave. Si el cliente ya tiene usuario, avisa (no lo pisa). No da de alta el PERFIL del cliente (eso es `cliente_crear`) ni toca dinero. El admin global acota la búsqueda del cliente a un nodo con `nodo`.",
+      inputSchema: { cliente: z.string().min(1).describe("Nombre o id del cliente/vendedor de tu nodo (de `clientes_del_nodo`)"), email: z.string().min(3).describe("Email con el que va a loguear el cliente"), nombre: z.string().min(1).describe("Nombre de pila de la persona que va a entrar (no el de la tienda)"), apellido: z.string().min(1), telefono: z.string().optional(), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/cliente", { ...rest, logisticaId: nodo })));
+    tool("cliente_resetear_clave", {
+      title: "Resetear la clave de un cliente/vendedor",
+      description: "Genera una CLAVE TEMPORAL NUEVA para un cliente/vendedor de TU nodo que YA tiene usuario de login pero perdió el acceso. El server la genera y la devuelve (pasásela; debe cambiarla al primer ingreso). Si el cliente todavía NO tiene usuario, avisa y sugiere `cliente_generar_usuario`. No toca el perfil del cliente ni dinero. El admin global acota la búsqueda del cliente a un nodo con `nodo`.",
+      inputSchema: { cliente: z.string().min(1).describe("Nombre o id del cliente/vendedor de tu nodo (de `clientes_del_nodo`)"), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/cliente/resetear", { ...rest, logisticaId: nodo })));
+    tool("operador_crear", {
+      title: "Alta de operador de nodo con clave temporal",
+      description: "Da de alta un OPERADOR (staff que administra el nodo: recibe/escanea/despacha, liquida, etc., según los permisos que le des) en TU nodo. El server genera una CLAVE TEMPORAL y la devuelve (pasásela; debe cambiarla al primer ingreso). Requiere nombre, apellido, email y teléfono. `permisos` opcional (default 'logistica'): gestion, finanzas, mensajeros, reportes, logistica, wms, precios, usuarios. El admin global elige el nodo con `nodo`. NO es un vendedor (eso es `cliente_generar_usuario`) ni un chofer (`chofer_crear`); NO otorga jerarquía de admin de nodo (eso es `usuario_habilitar_rol`). Yo nunca invento la clave. No toca dinero.",
+      inputSchema: { nombre: z.string().min(1).describe("Nombre de pila"), apellido: z.string().min(1), email: z.string().min(3).describe("Email con el que va a loguear"), telefono: z.string().min(1), permisos: z.array(z.string()).optional().describe("Secciones habilitadas: gestion, finanzas, mensajeros, reportes, logistica, wms, precios, usuarios. Default: logistica."), nodo: z.number().int().positive().optional().describe("Solo admin global: nodo donde crear el operador. El operador de nodo lo crea en SU nodo.") },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/usuarios/operador", { ...rest, logisticaId: nodo })));
+    tool("usuario_editar", {
+      title: "Editar datos de un usuario",
+      description: "Corrige nombre, apellido, teléfono y/o email (con el que entra) de un usuario de TU nodo, por id (de `chofer_listar`). Nombre y apellido son obligatorios: si el usuario todavía no los tiene separados, pasá los dos. Cambiar el nombre NO cambia el nombre con el que se le paga al cadete (queda fijo). No toca rol, permisos ni clave.",
+      inputSchema: { id: z.number().int().positive(), nombre: z.string().optional().describe("Nombre de pila"), apellido: z.string().optional(), telefono: z.string().optional(), email: z.string().optional().describe("Email con el que entra (no puede repetirse)") },
+    }, async ({ id, ...body }) => run(() => api("PUT", `/usuarios/${id}`, body)));
+    tool("usuario_habilitar_reparto", {
+      title: "Habilitar a un usuario como también mensajero",
+      description: "Marca (o desmarca con activo=false) a un operador/admin de TU nodo como TAMBIÉN mensajero: puede escanear, autoasignarse y entregar además de administrar. No toca credenciales.",
+      inputSchema: { id: z.number().int().positive(), activo: z.boolean().optional().describe("default true") },
+    }, async ({ id, activo }) => run(() => api("PUT", `/usuarios/${id}/reparto`, { activo: activo ?? true })));
+  }
+  if (isStaff) {
+    tool("ruta_publicar", {
+      title: "Publicar una ruta/colecta en el marketplace",
+      description: "Publicá una ruta/colecta/viaje para que CUALQUIER nodo de la red la tome (subasta abierta). VOS le pagás al que la toma. precioMax opcional (tope que ofrecés pagar). No mueve dinero (la obligación se registra al adjudicar).",
+      inputSchema: { titulo: z.string().min(1), tipo: z.enum(["ruta", "colecta", "viaje"]).optional(), descripcion: z.string().optional(), zona: z.string().optional(), precioMax: z.number().optional().describe("En pesos (ARS)") },
+    }, async (args) => run(() => api("POST", "/rutas-publicas", args)));
+    tool("ruta_ofertar", {
+      title: "Ofertar por una ruta pública",
+      description: "Ofertá por una publicación de OTRO nodo: `precio` = lo que cobrás por hacerla (subasta: más barato es mejor para el que publica). Si ya ofertaste, actualiza tu oferta. No podés ofertar en la tuya.",
+      inputSchema: { publicacionId: z.number().int().positive(), precio: z.number().describe("En pesos (ARS)"), nota: z.string().optional() },
+    }, async (args) => run(() => api("POST", `/rutas-publicas/${args.publicacionId}/ofertar`, { precio: args.precio, nota: args.nota })));
+    tool("ruta_adjudicar", {
+      title: "Adjudicar una ruta pública (elegir ganador)",
+      description: "Elegí la oferta ganadora de una publicación TUYA (los ids salen de «ruta_ofertas»). Cierra la subasta: el nodo ganador la toma al precio de su oferta (queda registrada la obligación). NO genera facturación/rendición/comisión ni clearing automático: el pago entre nodos se salda MANUALMENTE (ver «ayuda» tema:facturacion_marketplace).",
+      inputSchema: { publicacionId: z.number().int().positive(), ofertaId: z.number().int().positive() },
+    }, async ({ publicacionId, ofertaId }) => run(() => api("POST", `/rutas-publicas/${publicacionId}/adjudicar`, { ofertaId })));
+  }
+  if (isStaff) {
+    tool("envio_reasignar_cliente", {
+      title: "Reasignar un envío a otro cliente",
+      description: "Mueve UN envío (por tracking) a otro cliente/vendedor de TU nodo cuando se cargó mal. Deja registro en el historial. Igual que la función del frontend.",
+      inputSchema: { tracking: z.string().min(1), cliente: z.string().min(1).describe("nombre o id del cliente destino (de tu nodo)") },
+    }, async (args) => run(() => api("POST", "/envios/reasignar-cliente", args)));
+    tool("envio_mensajero_externo", {
+      title: "Asignar un mensajero EXTERNO a envíos",
+      description: "Registra que uno o varios envíos los hace un mensajero EXTERNO (alguien de AFUERA de la plataforma, que no tiene usuario). Quedan En camino a nombre de esa persona con su valor manual, así la entrega queda trazada y entra igual en la liquidación de mensajeros. Pasá `valorPorEnvio` para fijar cuánto se le paga por envío; si no lo pasás, figuran como FALTA VALOR hasta completarlo. No reasigna envíos ya entregados. No mueve dinero (registra el valor a pagar, no lo paga).",
+      inputSchema: { envioIds: z.array(z.number().int().positive()).describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), nombre: z.string().min(1).describe("Nombre de la persona que hace la entrega"), valorPorEnvio: z.number().optional().describe("Cuánto se le paga por envío"), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/envios/mensajero-externo", { ...rest, logisticaId: nodo })));
+
+    tool("envio_editar_zona", {
+      title: "Corregir zona/localidad/partido/CP de un envío",
+      description: "Corrige o COMPLETA los datos de UN envío (por tracking) para que se pueda cobrar y rutear. Dos usos: (1) CORREGIR un destino mal cargado —dos localidades pisadas ('san martin - Lanús'), el CP con la altura de la calle o con formato roto ('1.832,00')—; (2) COMPLETAR un envío que entró por el ESCANEO DEL QR del vendedor, que trae de quién es el paquete pero NO a dónde va: nace sin destinatario, sin dirección y sin zona, y así se liquida en $0 sin que nadie se entere. Acepta localidad, zona, partido, cp, destinatario, telefono y direccion; recalcula la zona y deja registro en el historial. ⚠️ En un envío YA ENTREGADO los datos del destino se COMPLETAN solo si están vacíos —nunca se pisan, porque cambiarle el destino a algo ya entregado es reescribir la historia—; lo que sí se puede corregir siempre es zona/localidad/partido/CP, que es lo que arregla la liquidación. Los campos que no se pisaron vuelven en `noPisados`. Es un arreglo PUNTUAL de ESE envío: no crea un alias global. Staff: solo envíos de tu nodo. No mueve dinero.",
+      inputSchema: {
+        tracking: z.string().min(1).describe("Tracking del envío a corregir"),
+        localidad: z.string().optional().describe("Localidad real del destino (ej. 'Lanús')"),
+        zona: z.string().optional().describe("Metazona para cobrar/rutear; si no la pasás se deriva de la localidad"),
+        cp: z.string().optional().describe("Código postal real (se guarda solo con dígitos: '1.832,00' → '1832'). Vacío = borrarlo."),
+        partido: z.string().optional().describe("Partido/municipio del destino (para la etiqueta)"),
+      },
+    }, async (args) => run(() => api("POST", "/envios/editar-zona", args)));
+    tool("envio_editar_fecha", {
+      title: "Corregir la fecha de un envío ya cargado",
+      description: "Cambia la FECHA de UN envío (por tracking) que quedó con el día en que se cargó y no con el día en que el paquete se movió — el caso típico: una planilla vieja que se subió sin `fecha`. Es la que define en qué SEMANA se le liquida al vendedor, así que corregirla mueve el envío de período. No admite fecha futura, y si el período ya está liquidado te lo rechaza con el número de liquidación (rehacerla es decisión tuya, no un efecto colateral). El primer estado del historial se mueve con el envío; los demás quedan como se registraron. Solo staff, y solo envíos de tu nodo (admin global: cualquiera). No mueve dinero.",
+      inputSchema: {
+        tracking: z.string().min(1).describe("Tracking del envío a corregir"),
+        fecha: z.string().min(1).describe("Fecha real del envío (dd/mm/aaaa o aaaa-mm-dd). No se admite futura."),
+      },
+    }, async (args) => run(() => api("POST", "/envios/editar-fecha", args)));
+    tool("envio_asignar_grupo", {
+      title: "Asignar un envío a un grupo logístico (despachar)",
+      description: "Asigna/rutea UN envío (por tracking) a un GRUPO logístico tuyo (por NOMBRE o id) — igual que la acción 'Asignar grupo' del escáner. Define con qué grupo salió (tarifa del clearing) y, si el envío TODAVÍA NO SALIÓ, lo DESPACHA: pasa a 'En camino' (sale del centro de distribución) y el vendedor lo ve así. Si el envío YA está 'Entregado' o 'En camino', NO se le toca el estado ni se le agrega un evento: solo queda registrado con qué grupo salió — por eso sirve para corregir el clearing de una planilla vieja ya entregada (mirá `estadoIntacto` en la respuesta). Si ya estaba en ese grupo te lo dice (`yaEstaba`) y no reescribe nada. Acepta VARIOS códigos separados por coma o salto de línea y devuelve el resumen. Solo grupos a los que pertenece tu nodo (el admin global, cualquiera) y envíos de tu nodo. No mueve dinero (el clearing es config).",
+      inputSchema: { tracking: z.string().min(1).describe("Tracking del envío. Podés mandar VARIOS separados por coma o salto de línea (un QR de ML crudo va solo, no se parte)"), grupo: z.string().min(1).describe("Nombre o id del grupo logístico de tus grupos (ej. 'Portela', 'Bonorino')") },
+    }, async (args) => run(() => api("POST", "/envios/asignar-grupo-ref", args)));
+    tool("cobro_corregir", {
+      title: "Corregir el monto de un cobro",
+      description: "Ajusta el monto a cobrar contra entrega de un envío (cuando se cobró de más o de menos), guardando el monto ORIGINAL en el historial. envioId + monto nuevo. No mueve dinero en cuentas (corrige el dato del envío).",
+      inputSchema: { envioId: z.number().int().positive().describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), monto: z.number().describe("En pesos (ARS)"), motivo: z.string().optional() },
+    }, async ({ envioId, monto, motivo }) => run(() => api("POST", `/envios/${envioId}/corregir-cobro`, { monto, motivo })));
+    tool("rendicion_revertir", {
+      title: "Revertir una rendición (marcada por error)",
+      description: "Revierte un cobro/cambio marcado como 'rendido' cuando en realidad NO se rindió → vuelve a 'a rendir'. Deja registro (quién/cuándo). envioId + tipo (cobro|cambio). Scopeado a tu nodo.",
+      inputSchema: { envioId: z.number().int().positive().describe("El `id` del envío que devuelve `envio_consultar` (no el tracking)"), tipo: z.enum(["cobro", "cambio"]), motivo: z.string().optional() },
+    }, async (args) => run(() => api("POST", "/flujo/rendicion/revertir", args)));
+  }
+  if (puede("gestion")) {
+    tool("colecta_configurar", {
+      title: "Configurar valor de colecta",
+      description: "Setea un valor de colecta según alcance: 'nodo' = pago default del nodo (ej. $3000); 'mensajero' = default de ese mensajero (ej. $4000, cualquier colecta); 'cliente' = cuánto se le COBRA al vendedor (idCliente + valor, opcional minEnvios); 'par' = pago pactado a un mensajero por colectar a un cliente (idCliente + mensajero + valor). Scopeado a tu nodo (el admin global elige el nodo con `nodo`). No mueve dinero (config de tarifa).",
+      inputSchema: {
+        alcance: z.enum(["nodo", "mensajero", "cliente", "par"]),
+        valor: z.number(),
+        idCliente: z.string().optional(),
+        mensajero: z.string().optional().describe("Nombre del mensajero (de tu nodo)"),
+        minEnvios: z.number().optional().describe("Solo alcance=cliente: mínimo de envíos para colecta sin cargo"),
+        nodo: zNodo(),
+      },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/config", { ...rest, logisticaId: nodo })));
+
+    tool("colecta_fija", {
+    title: "Colecta fija de un vendedor (días)",
+    description: "Define la COLECTA FIJA de un vendedor: los días en que se lo va a buscar SIEMPRE, tenga o no envíos cargados. Es para los que no vinculan sus cuentas ni cargan envíos — los paquetes entran cuando el cadete los escanea en la puerta. Aparecen solos en `colecta_pendientes` esos días. `dias` acepta números (0=domingo … 6=sábado) o nombres (lunes, martes…); `dias:[]` quita la colecta fija. Config de AGENDA, no de dinero.",
+    inputSchema: { idCliente: z.string().describe("id del cliente (de clientes_del_nodo)"), dias: z.array(z.union([z.number(), z.string()])).describe("Días: [1,2,3,4,5] o [\"lunes\",\"miércoles\"]. [] = quitar."), nodo: zNodo() },
+  }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/fija", { ...rest, logisticaId: nodo })));
+
+  tool("colecta_asignar", {
+      title: "Asignar una colecta a un mensajero",
+      description: "Asigna la colecta (retiro de mercadería) de un cliente a un mensajero, ambos por NOMBRE de tu nodo (ej. «que Maxi levante al cliente Distri Sur»). Vincula los envíos 'A retirar' de ese cliente a la colecta y avisa al mensajero. FUNCIONA AUNQUE EL CLIENTE NO TENGA ENVÍOS CARGADOS (vendedores que no vinculan sus cuentas): se crea la colecta vacía y el cadete escanea cada paquete en la puerta — los que no están en el sistema se crean solos a nombre del vendedor, sin contar dos veces el mismo QR. Si el corte venció, la programa para el próximo día hábil. No mueve dinero (es logística). El admin global acota la resolución por nombre con `nodo`.",
+      inputSchema: {
+        cliente: z.string().min(1).describe("Nombre del cliente/vendedor a colectar"),
+        mensajero: z.string().min(1).describe("Nombre del mensajero (de tu nodo) que hace el retiro"),
+        nodo: zNodo(),
+      },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/asignar-por-nombre", { ...rest, logisticaId: nodo })));
+
+    tool("retiros_cargar", {
+      title: "Cargar la lista de retiros del día",
+      description: "Carga de una vez la LISTA DE RETIROS (colectas) del día: le pasás las direcciones y crea un retiro por cada una. OJO, no confundir con `colecta_asignar`, que es ir a levantarle los paquetes a UN vendedor; esto es la ronda de paradas donde el cadete va a BUSCAR (no tienen destinatario ni teléfono, solo dirección). Si vienen numeradas ('1. Helguera 936'), el número se usa como orden de ruta y se saca de la dirección. `zona` es la que cobra y paga por la tabla Retiros ('Retiro en CABA' o 'Retiro en GBA'): no la inventes. El cadete se asigna a TODA la lista y se escribe también el nombre por el que se le PAGA (el resumen de pago agrupa por nombre, no por el vínculo). Si mandás dos veces la misma dirección para el mismo cliente y día, no se duplica: vuelve en `duplicados`. Quedan en 'A retirar'; para cerrarlas usá `envio_completar_ciclo`. No mueve dinero: registra el trabajo, no lo paga.",
+      inputSchema: {
+        cliente: z.string().min(1).describe("Cliente al que se le cargan los retiros (nombre o id, de tu nodo)"),
+        direcciones: z.array(z.string().min(1)).min(1).describe("Una dirección por elemento, en el orden de la ruta. Pueden venir numeradas ('1. Helguera 936, CABA') o sueltas."),
+        zona: z.string().optional().describe("'Retiro en CABA' (default) o 'Retiro en GBA'. Es la metazona que cobra y paga."),
+        mensajero: zStr().describe("Nombre o id de quien hace TODA la ronda. Si el nombre matchea a varios, te los lista con su id en vez de elegir por vos."),
+        fecha: zStr().describe("dd/mm/aaaa o aaaa-mm-dd si NO es hoy (define la semana en que se liquida). No admite fecha futura."),
+        nodo: zNodo(),
+      },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/retiros", { ...rest, logisticaId: nodo })));
+
+    tool("colecta_desasignar", {
+      title: "Desasignar una colecta",
+      description: "Quita la asignación de una colecta (los envíos vuelven a 'sin colecta'). El colectaId lo devuelve «colecta_pendientes». Solo colectas de tu nodo (el admin global puede acotar con `nodo`). No mueve dinero.",
+      inputSchema: { colectaId: z.number().int().positive(), nodo: zNodo() },
+    }, async ({ colectaId, nodo }) => run(() => api("POST", "/colecta/desasignar", { colectaId, logisticaId: nodo })));
+
+    tool("procesar_zona", {
+      title: "Aceptar envíos ruteados por zona",
+      description: "ACEPTA (recibe en tu nodo) los envíos que otros nodos te rutearon por zona — los ids salen de «envios_por_zona». Opcional: mensajeroId para asignarlos a un mensajero puntual de esa zona. No mueve dinero (el clearing es config). El admin global elige el nodo receptor con `nodo`.",
+      inputSchema: { envioIds: z.array(z.number().int().positive()).min(1), mensajeroId: z.number().int().positive().optional(), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/procesar-zona", { ...rest, logisticaId: nodo })));
+
+    tool("rechazar_zona", {
+      title: "Rechazar envíos ruteados por zona",
+      description: "RECHAZA (declina) envíos que te rutearon por zona: dejan de aparecerte y quedan para el nodo de origen u otros nodos de la zona. No cambia el estado del envío. Los ids salen de «envios_por_zona». El admin global elige el nodo con `nodo`.",
+      inputSchema: { envioIds: z.array(z.number().int().positive()).min(1), motivo: z.string().optional(), nodo: zNodo() },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/colecta/rechazar-zona", { ...rest, logisticaId: nodo })));
+
+    tool("cliente_crear", {
+      title: "Crear cliente / vendedor",
+      description: "Da de alta un cliente en TU nodo (el backend fuerza el nodo). Podés asignarle la lista de precio con idLista. No toca dinero. El admin global elige el nodo con `nodo`.",
+      inputSchema: {
+        nombre: z.string().min(1).describe("Nombre del cliente"),
+        telefono: z.string().optional(),
+        dni: z.string().optional(),
+        direccion: z.string().optional(),
+        idLista: z.string().optional().describe("ID de la lista de precios a asignar (ej. 'B'). Consultá 'clientes_del_nodo' / 'precios_ver'. Si falta, el alta queda incompleta."),
+        nodo: zNodo(),
+      },
+    }, async ({ nodo, ...rest }) => {
+      const r = await api("POST", "/gestion/clientes", { ...rest, logisticaId: nodo });
+      const base = toResult(r);
+      // Hint de completitud (Fase A): sin lista de precios el alta está a medias → guío el próximo paso.
+      if (r.ok && !rest.idLista) {
+        base.content.push({ type: "text", text: "\n⚠️ FALTA LA LISTA DE PRECIOS — el alta está incompleta.\nPreguntale al operador: «¿qué le cobrás a este cliente?»\n • ¿La lista OFICIAL de Flex (la que usan todos)?\n • ¿Un precio PROPIO? Mirá las disponibles con `precios_ver` (el nombre está en 'referencia'); si es nueva, se crea en Precios con un nombre para reusarla.\nAsigná la lista con `cliente_editar idLista:<id>`. Ver `flujo alta_cliente`." });
+      }
+      return base;
+    });
+
+    tool("cliente_editar", {
+      title: "Editar cliente (solo lo que pasás)",
+      description: "Edita un cliente de TU nodo cambiando SOLO lo que pasás: lo que no mandás queda como está. Para VACIAR un campo mandalo vacío (\"\"). `email` cambia el email con el que ENTRA el usuario del cliente (tiene que tener usuario generado; requiere permiso de usuarios; no puede repetirse). No toca dinero. El admin global puede mover el cliente a otro nodo con `nodo`.",
+      inputSchema: {
+        id: z.number().int().positive().describe("ID del cliente (de clientes_del_nodo)"),
+        nombre: z.string().optional().describe("Solo si lo querés cambiar"),
+        nombreFantasia: z.string().optional(),
+        idLista: z.string().optional().describe("Lista de precios a asignar"),
+        telefono: z.string().optional(),
+        email: z.string().optional().describe("Email con el que entra su usuario"),
+        dni: z.string().optional(),
+        direccion: z.string().optional(),
+        mensajeroNombre: z.string().optional().describe("Nombre con el que cobra si también reparte"),
+        activo: z.boolean().optional(),
+        nodo: zNodo(),
+      },
+    }, async ({ id, nodo, ...body }) => run(() => api("PATCH", `/gestion/clientes/${id}`, { ...body, ...(nodo !== undefined ? { logisticaId: nodo } : {}) })));
+    tool("sucursales_cliente", {
+      title: "Sucursales de un cliente (con su perfil de zona)",
+      description: "Lista las sucursales (puntos de retiro) de un cliente de TU nodo con su id, nombre, dirección y PERFIL DE ZONA. Sirve para ver/ajustar con qué perfil cotiza cada sucursal (útil cuando un cliente tiene sucursales en zonas distintas). Solo lectura.",
+      inputSchema: { cliente: z.number().int().positive().describe("id del cliente (de `clientes_del_nodo`)") },
+    }, async ({ cliente }) => run(() => api("GET", `/zonificacion/sucursales${q({ cliente })}`)));
+    tool("sucursal_perfil", {
+      title: "Setear el perfil de zona de una sucursal",
+      description: "Define (o limpia con perfilZona vacío) el PERFIL DE ZONA de una sucursal — con eso la liquidación cotiza los envíos que salen de esa sucursal según SU distancia (no la del cliente). El id de la sucursal sale de `sucursales_cliente`. Perfil vacío = la sucursal hereda el perfil del cliente. Config de staff (NO lo toca el vendedor); no mueve dinero, pero afecta el tramo/precio.",
+      inputSchema: { sucursalId: z.number().int().positive().describe("id de la sucursal (de `sucursales_cliente`)"), perfilZona: z.string().optional().describe("nombre del perfil (ej. GENERAL, MORENO). Vacío = hereda el del cliente.") },
+    }, async ({ sucursalId, perfilZona }) => run(() => api("POST", "/zonificacion/sucursal-perfil", { sucursalId, perfilZona: perfilZona ?? null })));
+  }
+
+  if (puede("finanzas")) {
+    tool("liquidacion_excluir_envio", {
+      title: "No cobrar un envío de una liquidación",
+      description:
+        "Saca UN envío (por tracking) del cobro de una liquidación YA emitida y re-suma el total, ajustando el cargo en la cuenta corriente del cliente. El `motivo` es OBLIGATORIO: queda en el historial del envío y el vendedor lo ve en su portal. Si esa liquidación ya está en una factura de ARCA emitida, lo rechaza (haría falta una nota de crédito, que el sistema no emite). Scopeada a tu nodo.",
+      inputSchema: {
+        id: z.number().int().positive().describe("id de la liquidación"),
+        tracking: z.string().min(1),
+        motivo: z.string().min(10).describe("Por qué no se le cobra. Lo lee el vendedor."),
+      },
+    }, async ({ id, tracking, motivo }) => run(() => api("POST", `/liquidaciones/anteriores/${id}/excluir`, { tracking, motivo })));
+    tool("liquidacion_reincluir_envio", {
+      title: "Volver a cobrar un envío de una liquidación",
+      description:
+        "Lo inverso de `liquidacion_excluir_envio`: devuelve al cobro un envío que se había excluido, re-suma y ajusta la cuenta corriente. El `motivo` es OBLIGATORIO. Mismo guard de factura emitida.",
+      inputSchema: {
+        id: z.number().int().positive().describe("id de la liquidación"),
+        tracking: z.string().min(1),
+        motivo: z.string().min(10).describe("Por qué sí se le cobra."),
+      },
+    }, async ({ id, tracking, motivo }) => run(() => api("POST", `/liquidaciones/anteriores/${id}/reincluir`, { tracking, motivo })));
+    tool("liquidacion_cobro_parcial", {
+      title: "Cobro en destino parcial de un envío",
+      description: "Cuando el comprador le pagó al cadete MENOS que el flete (ej. el envío era zona media y se cobró como cercana): lo cobrado se da por pagado y el envío sigue en la liquidación YA emitida por la diferencia (flete − cobrado). `montoCobrado` 0 quita el ajuste y vuelve a cobrar el flete entero. Si lo cobrado cubre todo el flete usá `liquidacion_excluir_envio`. El `motivo` es OBLIGATORIO: queda en el historial del envío y el vendedor lo ve en su portal. Rechaza si la liquidación ya está en una factura de ARCA emitida y los viajes especiales. Ajusta el total y la cuenta corriente. No mueve dinero. Scopeada a tu nodo. Requiere permiso finanzas.",
+      inputSchema: {
+        id: z.number().int().positive().describe("id de la liquidación"),
+        tracking: z.string().min(1),
+        montoCobrado: z.number().min(0).describe("Lo que se cobró en destino, en pesos (ARS). 0 = quitar el ajuste."),
+        motivo: z.string().min(10).describe("Por qué (ej. 'zona media cobrada como cercana'). Lo lee el vendedor."),
+      },
+    }, async ({ id, tracking, montoCobrado, motivo }) => run(() => api("POST", `/liquidaciones/anteriores/${id}/cobro-parcial`, { tracking, montoCobrado, motivo })));
+    tool("reclamo_responder", {
+      title: "Responder o cerrar un reclamo de un vendedor",
+      description:
+        "Responde el reclamo que un vendedor dejó sobre su liquidación (el `id` sale de `reclamos_listar`). La respuesta la lee el vendedor en su portal (Mi Cuenta). `cerrar:true` además lo pasa a resuelto; `reabrir:true` lo vuelve a abierto. Es lo mismo que Reclamos de vendedores en la app. Para corregir lo cobrado primero usá `liquidacion_excluir_envio` / `liquidacion_reincluir_envio` y contale el resultado en la respuesta. Solo texto y estado: no mueve dinero. Scopeado a tu nodo. Requiere permiso finanzas.",
+      inputSchema: {
+        id: z.number().int().positive().describe("id del reclamo (de `reclamos_listar`)"),
+        respuesta: z.string().min(5).optional().describe("Texto para el vendedor (obligatorio salvo que solo reabras)"),
+        cerrar: z.boolean().optional().describe("true = dejarlo resuelto"),
+        reabrir: z.boolean().optional().describe("true = volver a abierto"),
+      },
+    }, async ({ id, respuesta, cerrar, reabrir }) => run(async () => {
+      if (!respuesta && !reabrir) throw new Error("Falta la respuesta para el vendedor.");
+      if (cerrar && reabrir) throw new Error("No podés cerrar y reabrir a la vez.");
+      return api("PUT", `/liquidaciones/observaciones/${id}`, { ...(respuesta ? { respuesta } : {}), ...(cerrar ? { estado: "resuelto" } : reabrir ? { estado: "abierto" } : {}) });
+    }));
+    tool("facturacion_preparar_cliente", {
+      title: "Dejar un cliente listo para facturar",
+      description:
+        "Carga los datos fiscales de un cliente y lo habilita: CUIT, razón social (el TITULAR del CUIT, NO el nombre de fantasía), condición frente al IVA, en qué CUENTA cobra (eso define con qué CUIT se le factura) y si factura semanal o mensual. El corte queda en HOY salvo que pases 'desde': lo anterior se facturó por fuera del sistema y volver a emitirlo sería un comprobante duplicado. NO emite comprobantes — el MCP no factura; después se emite desde la PWA o desde el portal del cliente. Preguntá TODOS los datos antes de ejecutar: no inventes un CUIT ni una razón social. Ver el flujo 'facturacion'.",
+      inputSchema: {
+        cliente: z.string().min(1).describe("Nombre o id del cliente"),
+        cuit: z.string().min(1).describe("CUIT del cliente, 11 dígitos"),
+        razonSocial: z.string().min(1).describe("Razón social / titular del CUIT, como figura en ARCA"),
+        condicionIVA: z.string().min(1).describe("RI | MONOTRIBUTO | EXENTO | CONSUMIDOR_FINAL"),
+        cuentaCobro: z.string().optional().describe("Nombre o id de la cuenta de dinero donde cobra (define quién factura)"),
+        frecuencia: z.string().optional().describe("Semanal (default) o Mensual"),
+        desde: z.string().optional().describe("Corte YYYY-MM-DD; vacío = hoy"),
+      },
+    }, async (a) => run(() => api("POST", "/afip/preparar-cliente", a)));
+  }
+
+  if (puede("wms") && wmsActivo) {
+    tool("producto_crear", {
+      title: "Crear producto (WMS)",
+      description: "Alta de un producto en el catálogo del depósito. Staff puede indicar el cliente dueño con idCliente. No toca dinero. El admin global elige el nodo con `nodo`.",
+      inputSchema: {
+        nombre: z.string().min(1),
+        sku: z.string().optional(),
+        codigoBarra: z.string().optional(),
+        peso: z.number().optional(),
+        volumen: z.number().optional(),
+        idCliente: z.string().optional().describe("idCliente dueño del producto"),
+        nodo: zNodo(),
+      },
+    }, async ({ nodo, ...rest }) => run(() => api("POST", "/wms/productos", { ...rest, logisticaId: nodo })));
+  }
+
+  if (esGlobal) {
+    tool("nodo_crear", {
+      title: "Crear nodo (logística)",
+      description: "Da de alta un nodo/logística nuevo. Solo admin global. No toca dinero.",
+      inputSchema: {
+        nombre: z.string().min(1).describe("Nombre del nodo/logística"),
+        telefono: z.string().optional(),
+      },
+    }, async ({ nombre, telefono }) => run(() => api("POST", "/logisticas", { nombre, telefono: telefono ?? null })));
+  }
+}
+
+// ============================================================================
+//  EDICIÓN DE PRECIOS (flag aparte · sensible pero NO mueve dinero).
+// ============================================================================
+if (ALLOW_PRECIOS && puede("precios")) {
+  tool("precio_actualizar", {
+    title: "Actualizar precio de una lista (versionado)",
+    description: "Cambia los precios por zona de una lista creando una VERSIÓN nueva (histórico exacto). Requiere permiso 'precios'; el backend impide tocar listas de otro nodo. No mueve dinero. El admin global elige el nodo de la lista con `nodo`.",
+    inputSchema: {
+      idLista: z.string().min(1).describe("ID de la lista (ej. 'B'). Ver 'precios_ver'."),
+      cercana: z.number().optional().describe("Precio zona cercana, en pesos (ARS)"),
+      media: z.number().optional().describe("Precio zona media, en pesos (ARS)"),
+      lejana: z.number().optional().describe("Precio zona lejana, en pesos (ARS)"),
+      muyLejana: z.number().optional().describe("Precio zona muy lejana, en pesos (ARS)"),
+      referencia: z.string().optional(),
+      vigenciaDesde: z.string().optional().describe("Fecha YYYY-MM-DD desde cuándo rige (default: hoy)"),
+      nodo: zNodo(),
+    },
+  }, async ({ nodo, ...rest }) => run(() => api("POST", "/precios/clientes/version", { ...rest, logisticaId: nodo })));
+}
+
+// Ayuda integrada — se registra al final para que el índice conozca TODOS los tools
+// que este usuario tiene según su rol/permisos. Solo lectura de documentación.
+tool("ayuda", {
+  title: "Ayuda / documentación de las herramientas",
+  description: "Documentación de las herramientas del MCP: sin argumentos = índice de lo que podés usar; `tool` = ficha de una herramienta (qué hace, cómo usarla, ejemplo, qué NO hace); `tema` = tópico transversal (facturacion_marketplace, dinero, aislamiento). Consultalo antes de asumir cómo funciona algo.",
+  inputSchema: { tool: z.string().optional().describe("Nombre de una herramienta, ej. ruta_adjudicar"), tema: z.string().optional().describe("facturacion_marketplace | dinero | aislamiento") },
+}, async ({ tool: t, tema }) =>
+  ({ content: [{ type: "text", text: renderAyuda(t || tema, { version: MCP_VERSION, disponibles: registrados }) }] }));
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+const cap = isCliente ? "cliente" : esGlobal ? "admin global" : isStaff ? "staff de nodo" : "sin identidad";
+log(`MCP Nexus Flex v3 listo. Rol: ${cap}. Escritura: ${ALLOW_WRITE ? "ON" : "off"} · Precios: ${ALLOW_PRECIOS ? "ON" : "off"}.`);