@patroltech/agent-capabilities 0.0.0-stage → 0.2.0

package/dist/reads/plan.js

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+import { backendErrorCode, PatrolTechApiError, translateBackendError, } from '../domain/backend-errors.js';
+import { FALTA_PAIS, normalizeCountry } from '../domain/country.js';
+import { importe } from '../domain/money.js';
+import { fail, ok } from '../domain/tool-result.js';
+import { ROL_LABEL } from './support/roles.js';
+import { defineRead } from './types.js';
+const usoPlanDesc = 'Consulta el plan de la organización y su uso frente a los límites: checkpoints usados/incluidos (y extra facturados), ubicaciones y gestores usados/límite. Límite null = sin tope. Úsala para «¿cuántos checkpoints me quedan?», «¿qué plan tengo?» o antes de proponer crear algo que cuenta para el plan.';
+const contratarPlanDesc = 'Genera el enlace de pago para contratar un plan, igual que el botón de Licencia del panel: el cliente paga en la página segura de Stripe (generar el enlace no cobra nada, así que no pide confirmación). Úsala cuando quiera contratar Pro o Business o subir de plan. Si no ha dicho plan, la recomendación es Business; si no ha dicho periodo, propón mensual; pregunta solo si duda. El cliente elige: si pide Pro o anual, dale ese. Solo un Admin de toda la organización puede contratar: si no lo es, la herramienta lo dice. Si la organización ya paga un plan, devuelve el enlace de su portal de suscripción en vez de un pago nuevo. Enterprise no tiene enlace: es a medida. Da el `enlace` completo, tal cual.';
+const gestionarSuscripcionDesc = 'Genera el enlace al portal de suscripción de Stripe de la organización (solo si ya paga): facturas, cambiar la tarjeta, datos de facturación, cancelar o cambiar de plan. Solo un Admin de toda la organización. Úsala cuando pida sus facturas, cambiar la tarjeta o gestionar la suscripción. Da el `enlace` completo, tal cual. Para BAJAR de plan, la base de conocimiento manda escalar: lo gestiona el equipo.';
+const ENLACE_NO_STRIPE = 'El panel ha devuelto un enlace de pago que no es de Stripe: no lo des. Escala al equipo.';
+/**
+ * ¿Es Admin de TODA la organización? Es lo que exige la API para contratar y
+ * abrir el portal (rol ADMIN de organización, no de una ubicación). null si la
+ * sesión no trae el rol: entonces decide la API.
+ */
+function esAdminDeOrganizacion(org) {
+    if (!org.roleType)
+        return null;
+    return org.roleType.toUpperCase() === 'ADMIN' && org.scope !== 'location';
+}
+function soloAdmin(org) {
+    const rol = ROL_LABEL[org.roleType?.toUpperCase() ?? ''] ?? org.roleType ?? 'desconocido';
+    const ambito = org.scope === 'location' ? ' solo de una ubicación' : '';
+    return fail(`Solo un Admin de toda la organización «${org.name}» puede contratar, cambiar o gestionar el plan y la suscripción; este usuario es ${rol}${ambito}. ` +
+        'No escales ni inventes quién es el Admin: dile que se lo pida a un Admin de su cuenta, que puede hacerlo en el panel (Licencia) o pedirme el enlace por WhatsApp desde su propio teléfono.');
+}
+/** El enlace que devuelve el backend solo se da si es de Stripe (el mismo guardia que el panel antes de redirigir). */
+function esUrlDeStripe(url) {
+    try {
+        const host = new URL(url).hostname;
+        return host === 'stripe.com' || host.endsWith('.stripe.com');
+    }
+    catch {
+        return false;
+    }
+}
+/** Traduce un rechazo del backend al pedir un enlace de pago; lo demás (red, timeout) sigue su camino. */
+function falloEnlace(err, language, policy) {
+    if (err instanceof PatrolTechApiError) {
+        return fail(translateBackendError(err, language, policy).mensajeCliente);
+    }
+    throw err;
+}
+/** Los enlaces de pago: la vuelta desde Stripe es la página Licencia del panel. */
+function billingLinks(gateway, policy) {
+    const licensePageUrl = policy.urls.license;
+    const checkoutSuccessUrl = `${licensePageUrl}/callback?status=success`;
+    const checkoutCancelUrl = `${licensePageUrl}/callback?status=cancel`;
+    async function enlacePortal(ctx) {
+        let enlace;
+        try {
+            enlace = await gateway.createCustomerPortalLink(ctx.org.orgId, licensePageUrl, ctx.token);
+        }
+        catch (err) {
+            return falloEnlace(err, ctx.language, policy);
+        }
+        return esUrlDeStripe(enlace) ? enlace : fail(ENLACE_NO_STRIPE);
+    }
+    /** Quien ya paga cambia de plan en su portal de suscripción, no con un pago nuevo. */
+    async function portalDeQuienYaPaga(ctx, planActual) {
+        const enlace = await enlacePortal(ctx);
+        if (typeof enlace !== 'string')
+            return enlace;
+        return ok({ enlace, tipo: 'portal_suscripcion', planActual }, {
+            avisos: [
+                `La organización ya paga el plan ${planActual}: no se contrata otro (serían dos cobros). Este enlace es su portal de suscripción de Stripe, donde cambia de plan, ve sus facturas y cambia la tarjeta. Si en el portal no le aparece el cambio de plan, se hace en el panel: Licencia → «Pasar a {plan}» (se aplica al momento y se cobra la parte proporcional).`,
+            ],
+        });
+    }
+    async function contratar(ctx, args) {
+        if (args.plan === 'enterprise') {
+            return ok({ plan: 'Enterprise', aMedida: true }, {
+                avisos: [
+                    'Enterprise es una oferta a medida que gestiona el equipo: no tiene enlace de pago. Antes de ofrecerlo, comprueba con consultar_precios (checkpoints incluidos y precio del extra) y consultar_uso_plan (sus límites y uso) si Business le cubre, sin dar límites de memoria: si le cubre, ofrécele Business con su enlace. Si de verdad necesita Enterprise, ofrécele una llamada con el equipo: acuerda día y hora y usa escalar_a_humano con `cita` (y programar_recordatorio).',
+                ],
+            });
+        }
+        if (esAdminDeOrganizacion(ctx.org) === false)
+            return soloAdmin(ctx.org);
+        const orgId = ctx.org.orgId;
+        const uso = await gateway.getPlanUsage(orgId, ctx.token);
+        // NUNCA un checkout para quien ya paga: crearía una segunda suscripción cobrando a la vez.
+        if (uso.pagaSuscripcion)
+            return portalDeQuienYaPaga(ctx, uso.plan);
+        if (!args.periodo) {
+            return fail('Falta el periodo: si no lo ha dicho, propón mensual; pregunta solo si duda. Vuelve a llamarla con periodo mensual (o anual si lo pide o quiere ahorrar: el anual son 10 mensualidades, 2 meses gratis).');
+        }
+        // El backend decide la moneda; aquí solo se le pasa el país (el que diga el cliente o el del contexto).
+        const pais = normalizeCountry(args.pais) ?? ctx.country;
+        if (!pais)
+            return fail(FALTA_PAIS);
+        const plan = (await gateway.getPlans(orgId, ctx.token, pais)).find((p) => p.identificador === args.plan);
+        if (!plan) {
+            return fail(`El plan ${args.plan} no está disponible ahora mismo en el panel: no des precio ni enlace. Escala al equipo.`);
+        }
+        const anual = args.periodo === 'anual';
+        let enlace;
+        try {
+            enlace = await gateway.createCheckoutLink(orgId, {
+                tierId: plan.tierId,
+                interval: anual ? 'year' : 'month',
+                successUrl: checkoutSuccessUrl,
+                cancelUrl: checkoutCancelUrl,
+                country: pais,
+            }, ctx.token);
+        }
+        catch (err) {
+            // Si no se sabía que ya paga, lo dice el backend al negarse a abrir otro checkout.
+            if (err instanceof PatrolTechApiError && backendErrorCode(err) === 'ALREADY_SUBSCRIBED') {
+                return portalDeQuienYaPaga(ctx, uso.plan);
+            }
+            return falloEnlace(err, ctx.language, policy);
+        }
+        if (!esUrlDeStripe(enlace))
+            return fail(ENLACE_NO_STRIPE);
+        const precios = anual ? plan.anual : plan.mensual;
+        const cada = anual ? 'al año' : 'al mes';
+        return ok({
+            enlace,
+            plan: plan.nombre,
+            periodo: args.periodo,
+            precio: `${importe(precios.base, plan.moneda)} ${cada}`,
+            moneda: plan.moneda,
+            checkpointsIncluidos: plan.checkpointsIncluidos,
+            checkpointExtra: `${importe(precios.extra, plan.moneda)} ${cada} por cada checkpoint por encima de ${plan.checkpointsIncluidos}`,
+        }, {
+            avisos: [
+                'Precio y moneda son los que cobra Stripe a esta organización (la moneda la decide el sistema por su país): dalos tal cual. Generar el enlace no cobra nada: paga en la página segura de Stripe, donde ve el total (con impuestos y, si ya tiene más checkpoints de los incluidos, los extra) antes de confirmar. El enlace caduca a los 45 minutos: si caduca, se genera otro. Al pagar, el plan se activa solo.',
+            ],
+        });
+    }
+    async function gestionar(ctx) {
+        if (esAdminDeOrganizacion(ctx.org) === false)
+            return soloAdmin(ctx.org);
+        const uso = await gateway.getPlanUsage(ctx.org.orgId, ctx.token);
+        const enlace = await enlacePortal(ctx);
+        if (typeof enlace !== 'string') {
+            // Sin cliente de Stripe (nunca ha pagado) el backend no abre el portal.
+            return uso.pagaSuscripcion === false
+                ? fail(`La organización no tiene suscripción de pago (plan ${uso.plan}): no hay facturas ni tarjeta que gestionar. Si quiere contratar un plan, usa enlace_contratar_plan.`)
+                : enlace;
+        }
+        return ok({ enlace, planActual: uso.plan });
+    }
+    return { contratar, gestionar };
+}
+/**
+ * Sin upsell (MCP) solo el consumo frente a los límites: ni el nombre del plan,
+ * ni su estado de pago, ni los checkpoints extra facturados.
+ */
+function usoSinFacturacion(uso) {
+    const { usados, incluidos } = uso.checkpoints;
+    return { ...uso, checkpoints: { usados, incluidos } };
+}
+/** Plan y suscripción: uso frente a los límites y enlaces de pago de Stripe. */
+export function planReads({ gateway, urls, upsell }) {
+    const enlaces = billingLinks(gateway, { urls, upsell });
+    return [
+        defineRead({
+            name: 'consultar_uso_plan',
+            description: usoPlanDesc,
+            params: {},
+            call: async ({ org, token }) => {
+                const usage = await gateway.getPlanUsage(org.orgId, token);
+                return ok(upsell ? usage : { uso: usage.uso && usoSinFacturacion(usage.uso) });
+            },
+        }),
+        defineRead({
+            name: 'enlace_contratar_plan',
+            description: contratarPlanDesc,
+            params: {
+                plan: z
+                    .enum(['pro', 'business', 'enterprise'])
+                    .describe('Plan que quiere contratar (si no lo ha dicho, la recomendación es business)'),
+                periodo: z
+                    .enum(['mensual', 'anual'])
+                    .optional()
+                    .describe('Facturación mensual o anual (anual = 10 mensualidades, 2 meses gratis). Si no lo ha dicho, propón mensual; pregunta solo si duda. Anual solo si lo pide o pregunta cómo ahorrar.'),
+                pais: z
+                    .string()
+                    .optional()
+                    .describe('Código ISO-2 del país del cliente (p. ej. MX, ES). Solo si el cliente lo ha dicho o si la herramienta te lo pide; si no, omítelo.'),
+            },
+            call: async (ctx, args) => enlaces.contratar(ctx, args),
+        }),
+        defineRead({
+            name: 'enlace_gestionar_suscripcion',
+            description: gestionarSuscripcionDesc,
+            params: {},
+            call: async (ctx) => enlaces.gestionar(ctx),
+        }),
+    ];
+}
+//# sourceMappingURL=plan.js.map

package/dist/reads/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/reads/plan.ts"],"names":[],"mappings":"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"}

package/dist/reads/rounds.d.ts

@@ -0,0 +1,4 @@
+import { type ReadCapability, type ReadEnv } from './types.js';
+/** Rondas: estado general, detalle por ruta, checkpoints de la última y una ronda concreta. */
+export declare function roundReads({ gateway }: ReadEnv): ReadCapability[];
+//# sourceMappingURL=rounds.d.ts.map

package/dist/reads/rounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.d.ts","sourceRoot":"","sources":["../../src/reads/rounds.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAuJ3E,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,GAAG,cAAc,EAAE,CAmCjE"}

package/dist/reads/rounds.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+import { localToUtc } from '../domain/timezone.js';
+import { fail, ok } from '../domain/tool-result.js';
+import { rutaParamSchema } from './support/params.js';
+import { resolveRuta } from './support/resolve.js';
+import { failAmbigua, failNoEncontrado, isFail, okLista, TRUNCADO_HINT, } from './support/results.js';
+import { defineRead } from './types.js';
+const rondasDesc = 'Consulta el estado de las rondas de la cuenta del usuario (abiertas, completadas, incompletas) de los últimos `windowDays` días.';
+const rondasDetalleDesc = 'Consulta el detalle de las rondas/rutas de la organización: cada ruta con sus rondas recientes (estado, vigilante, checkpoints completados de total, horas). Úsala cuando el usuario pida ver el detalle de las rondas, cómo van las rutas, o el estado de rondas concretas. Si una ruta trae `error`, sus rondas NO se pudieron leer: no digas que no tiene rondas.' +
+    TRUNCADO_HINT;
+const checkpointsRondaDesc = 'Consulta el detalle por punto de control de la ÚLTIMA ronda de una ruta: qué checkpoints se escanearon (con hora) y cuáles faltan. Úsala cuando el usuario pregunte qué puntos faltan/se hicieron en una ronda, o el detalle de checkpoints de una ruta concreta. Si el usuario NO indica la ruta, llámala igualmente SIN el parámetro `ruta`: si solo hay una ruta activa la usará, y si hay varias devolverá la lista de rutas para que el usuario elija (no le pidas la ruta a ciegas).';
+const rondaDesc = 'Consulta UNA ronda concreta de una ruta: estado, vigilante, inicio y fin, y qué checkpoints se hicieron (con hora) y cuáles quedaron pendientes. Sin `fecha` devuelve la ÚLTIMA ronda. Para una ronda concreta pasa `fecha` (día del cliente) y, si lo sabes, `hora` aproximada: «anoche» → fecha de ayer y hora 23:00; «esta mañana» → hoy y 08:00. Si ese día hubo más rondas, vienen en `otrasRondasCercanas`. Si el usuario no dice la ruta, llámala sin `ruta`: si hay varias, devuelve la lista para preguntar. Las horas vienen en UTC.';
+const rondaParamSchema = {
+    ruta: rutaParamSchema.ruta,
+    fecha: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Usa exactamente YYYY-MM-DD')
+        .optional()
+        .describe('Día de la ronda en el calendario del cliente, YYYY-MM-DD. OMÍTELO para la última ronda.'),
+    hora: z
+        .string()
+        .regex(/^\d{2}:\d{2}$/, 'Usa exactamente HH:mm')
+        .optional()
+        .describe('Hora aproximada de inicio, HH:mm en la hora del cliente. Solo junto con `fecha`.'),
+};
+const ROUNDS_PAGE_SIZE = 50;
+// Hasta 300 rondas hacia atrás: el backend no filtra rondas por fecha, hay que paginar.
+const MAX_ROUND_PAGES = 6;
+const HORA_MS = 3600_000;
+const MAX_RONDAS_CERCANAS = 5;
+/** Avisos de las rutas cuyas rondas no se pudieron leer (no son "rutas sin rondas"). */
+const avisosRutasConError = (rutas) => {
+    const conError = rutas.filter((r) => r.error).map((r) => r.routeName);
+    return conError.length > 0
+        ? [
+            `No se pudieron leer las rondas de: ${conError.join(', ')}. NO digas que esas rutas no tienen rondas.`,
+        ]
+        : [];
+};
+/** Traduce el resultado del gateway: solo `found` y "no hay rondas" son respuestas con datos. */
+function checkpointsRondaResult(result) {
+    if (result.found)
+        return ok(result);
+    if (result.reason === 'route_ambiguous') {
+        return failAmbigua('el nombre indicado', 'rutas', result.opciones);
+    }
+    if (result.reason === 'route_not_found')
+        return failNoEncontrado('ruta', result.opciones);
+    if (result.reason === 'route_not_specified') {
+        return fail('ruta no indicada: hay varias, pregunta al usuario cuál de estas quiere', result.opciones);
+    }
+    // no_rondas: es un hecho, no un fallo (la ruta existe y no tiene rondas aún).
+    return ok(result);
+}
+async function rondaConDetalle(gateway, token, ruta, ronda) {
+    const detalle = await gateway.getRoundDetail(ruta.id, ronda.id, token);
+    return {
+        ruta: ruta.name,
+        estado: detalle.status,
+        vigilante: ronda.patrollerName,
+        inicio: ronda.startTime,
+        fin: ronda.endTime,
+        escaneados: detalle.scannedCount,
+        total: detalle.totalCount,
+        hechos: detalle.checkpoints
+            .filter((c) => c.scanned)
+            .map((c) => ({ checkpoint: c.checkpointName, hora: c.scanTime })),
+        pendientes: detalle.checkpoints.filter((c) => !c.scanned).map((c) => c.checkpointName),
+    };
+}
+/**
+ * La ronda pedida con sus puntos hechos y pendientes. Sin `cuando`, la última;
+ * con fecha, la que empezó más cerca de esa fecha y hora (mediodía si no hay
+ * hora), dentro de ±6 h con hora o ±12 h sin ella. Las rondas no se filtran
+ * por fecha en el backend: se pagina hacia atrás hasta pasar la ventana.
+ */
+async function consultarRonda(gateway, token, ruta, cuando) {
+    if (!cuando) {
+        const { items } = await gateway.getRouteRounds(ruta.id, token, { page: 1, limit: 1 });
+        if (!items[0]) {
+            return ok({ ruta: ruta.name, ronda: null, motivo: 'esta ruta todavía no tiene rondas' });
+        }
+        return ok(await rondaConDetalle(gateway, token, ruta, items[0]));
+    }
+    const objetivo = localToUtc(`${cuando.fecha}T${cuando.hora ?? '12:00'}`, cuando.tz).getTime();
+    const tolerancia = (cuando.hora ? 6 : 12) * HORA_MS;
+    const vistas = [];
+    let agotado = false;
+    for (let page = 1;; page++) {
+        const { items, totalPages } = await gateway.getRouteRounds(ruta.id, token, {
+            page,
+            limit: ROUNDS_PAGE_SIZE,
+        });
+        vistas.push(...items);
+        const masAntigua = items.at(-1);
+        if (!masAntigua ||
+            Date.parse(masAntigua.startTime) < objetivo - tolerancia ||
+            page >= totalPages) {
+            break;
+        }
+        if (page >= MAX_ROUND_PAGES) {
+            agotado = true;
+            break;
+        }
+    }
+    const distancia = (r) => Math.abs(Date.parse(r.startTime) - objetivo);
+    const cercanas = [...vistas].sort((a, b) => distancia(a) - distancia(b));
+    const enVentana = cercanas.filter((r) => distancia(r) <= tolerancia);
+    if (enVentana.length === 0) {
+        if (agotado) {
+            return fail(`No he encontrado esa ronda entre las ${vistas.length} más recientes de «${ruta.name}»: es demasiado antigua para consultarla desde aquí; puede verla en el panel (Rutas).`);
+        }
+        return fail(`No hay ninguna ronda de «${ruta.name}» cerca de esa fecha. Estas son las más próximas (hora de inicio en UTC); pregunta cuál quiere:`, cercanas.slice(0, MAX_RONDAS_CERCANAS).map((r) => r.startTime));
+    }
+    const [elegida, ...resto] = enVentana;
+    const otrasRondasCercanas = resto.slice(0, MAX_RONDAS_CERCANAS).map((r) => ({
+        inicio: r.startTime,
+        estado: r.status,
+        vigilante: r.patrollerName,
+    }));
+    return ok({ ...(await rondaConDetalle(gateway, token, ruta, elegida)), otrasRondasCercanas });
+}
+/** Rondas: estado general, detalle por ruta, checkpoints de la última y una ronda concreta. */
+export function roundReads({ gateway }) {
+    return [
+        defineRead({
+            name: 'consultar_estado_rondas',
+            description: rondasDesc,
+            params: {},
+            call: async ({ org, token }) => ok(await gateway.getRoundsStatus(org.orgId, token)),
+        }),
+        defineRead({
+            name: 'consultar_detalles_rondas',
+            description: rondasDetalleDesc,
+            params: {},
+            call: async ({ org, token }) => {
+                const rutas = await gateway.getRoundsDetail(org.orgId, token);
+                return okLista(rutas, 'rutas', avisosRutasConError(rutas.items));
+            },
+        }),
+        defineRead({
+            name: 'consultar_checkpoints_ronda',
+            description: checkpointsRondaDesc,
+            params: rutaParamSchema,
+            call: async ({ org, token }, { ruta }) => checkpointsRondaResult(await gateway.getRoundCheckpoints(org.orgId, token, ruta)),
+        }),
+        defineRead({
+            name: 'consultar_ronda',
+            description: rondaDesc,
+            params: rondaParamSchema,
+            call: async ({ org, token, tz }, { ruta, fecha, hora }) => {
+                const r = resolveRuta(ruta, (await gateway.listRoutes(org.orgId, token)).items);
+                if (isFail(r))
+                    return r;
+                return consultarRonda(gateway, token, r.item, fecha ? { fecha, hora, tz } : undefined);
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=rounds.js.map

package/dist/reads/rounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.js","sourceRoot":"","sources":["../../src/reads/rounds.ts"],"names":[],"mappings":"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"}

package/dist/reads/routes.d.ts

@@ -0,0 +1,4 @@
+import { type ReadCapability, type ReadEnv } from './types.js';
+/** Rutas: sus horarios en la hora del cliente. */
+export declare function routeReads({ gateway }: ReadEnv): ReadCapability[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/reads/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/reads/routes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAK3E,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,GAAG,cAAc,EAAE,CAqBjE"}

package/dist/reads/routes.js

@@ -0,0 +1,34 @@
+import { listarHorarios } from '../domain/route-schedule.js';
+import { utcOffsetMinutes } from '../domain/timezone.js';
+import { fail, ok } from '../domain/tool-result.js';
+import { rutaParamSchema } from './support/params.js';
+import { resolveRuta } from './support/resolve.js';
+import { isFail } from './support/results.js';
+import { defineRead } from './types.js';
+const horariosRutaDesc = 'Lista los horarios de una ruta en la hora LOCAL del cliente, numerados («1. lun, mar 20:00-21:00»), y si la ruta está activa. Cada horario es una ronda: días en los que empieza y franja (si acaba antes de empezar, cruza la medianoche). Úsala para «¿qué horarios tiene la ruta?» o antes de borrar uno. Si el usuario no dice la ruta, llámala sin `ruta`.';
+/** Rutas: sus horarios en la hora del cliente. */
+export function routeReads({ gateway }) {
+    return [
+        defineRead({
+            name: 'consultar_horarios_ruta',
+            description: horariosRutaDesc,
+            params: rutaParamSchema,
+            call: async ({ org, token, tz }, { ruta }) => {
+                const r = resolveRuta(ruta, (await gateway.listRoutes(org.orgId, token)).items);
+                if (isFail(r))
+                    return r;
+                const detalle = await gateway.getRouteDetails(r.item.id, token);
+                if (!detalle)
+                    return fail(`No he podido leer la ruta «${r.item.name}».`);
+                const horarios = listarHorarios(detalle.timeWindows, utcOffsetMinutes(tz));
+                return ok({
+                    ruta: r.item.name,
+                    activa: r.item.isActive,
+                    zonaHoraria: tz,
+                    horarios: horarios.map((h, i) => `${i + 1}. ${h.texto}`),
+                });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=routes.js.map

package/dist/reads/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/reads/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAqC,MAAM,YAAY,CAAC;AAE3E,MAAM,gBAAgB,GACpB,iWAAiW,CAAC;AAEpW,kDAAkD;AAClD,MAAM,UAAU,UAAU,CAAC,EAAE,OAAO,EAAW;IAC7C,OAAO;QACL,UAAU,CAAC;YACT,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,gBAAgB;YAC7B,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC3C,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChF,IAAI,MAAM,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,CAAC;gBACxB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChE,IAAI,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC,8BAA8B,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;gBACzE,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3E,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;oBACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;oBACvB,WAAW,EAAE,EAAE;oBACf,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;iBACzD,CAAC,CAAC;YACL,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/reads/support/access-locations.d.ts

@@ -0,0 +1,22 @@
+import { type ToolResult } from '../../domain/tool-result.js';
+import type { LocationRef, PatrolTechGateway } from '../../gateway/index.js';
+/** Recorrido de las ubicaciones del Control de Acceso (el backend exige una por consulta). */
+export declare const TIPO_PARAM: {
+    readonly entrada: "ENTRY";
+    readonly salida: "EXIT";
+};
+/** Las ubicaciones a recorrer: la pedida o todas. */
+export declare function ubicacionesAccesos(gateway: PatrolTechGateway, orgId: string, token: string, ubicacion: string | undefined): Promise<{
+    ubicaciones: LocationRef[];
+    avisos: string[];
+} | ToolResult<never>>;
+/** Recorre las ubicaciones con `leer`; un 403 del gate es la App apagada y corta. Las demás caídas se cuentan. */
+export declare function porUbicacion<T>(ubicaciones: LocationRef[], leer: (u: LocationRef) => Promise<T>): Promise<{
+    resultados: {
+        ubicacion: LocationRef;
+        valor: T;
+    }[];
+    conError: number;
+} | ToolResult<never>>;
+export declare function avisoUbicacionesSinLeer(conError: number): string[];
+//# sourceMappingURL=access-locations.d.ts.map

package/dist/reads/support/access-locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-locations.d.ts","sourceRoot":"","sources":["../../../src/reads/support/access-locations.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI7E,8FAA8F;AAE9F,eAAO,MAAM,UAAU;;;CAAgD,CAAC;AAOxE,qDAAqD;AACrD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC;IAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAc/E;AAED,kHAAkH;AAClH,wBAAsB,YAAY,CAAC,CAAC,EAClC,WAAW,EAAE,WAAW,EAAE,EAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACnC,OAAO,CACR;IAAE,UAAU,EAAE;QAAE,SAAS,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAC7F,CAiBA;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlE"}

package/dist/reads/support/access-locations.js

@@ -0,0 +1,55 @@
+import { isFeatureDisabled, PatrolTechApiError } from '../../domain/backend-errors.js';
+import { fail } from '../../domain/tool-result.js';
+import { isFail } from './results.js';
+import { resolveNamed, UBICACION } from './resolve.js';
+/** Recorrido de las ubicaciones del Control de Acceso (el backend exige una por consulta). */
+export const TIPO_PARAM = { entrada: 'ENTRY', salida: 'EXIT' };
+// Como mucho 20 ubicaciones por consulta (dos llamadas por ubicación);
+// una organización con más tiene que acotar con `ubicacion`.
+const MAX_UBICACIONES_ACCESOS = 20;
+const CONTROL_ACCESO_APAGADO = 'El Control de Acceso no está activo en esta organización: no hay registros de entradas y salidas. Lo activa un Admin en el panel, en Apps → Control de Acceso.';
+/** Las ubicaciones a recorrer: la pedida o todas. */
+export async function ubicacionesAccesos(gateway, orgId, token, ubicacion) {
+    const todas = await gateway.listLocations(orgId, token);
+    if (ubicacion) {
+        const r = resolveNamed(ubicacion, todas, (l) => l.name, UBICACION);
+        if (isFail(r))
+            return r;
+        return { ubicaciones: [r.item], avisos: [] };
+    }
+    const avisos = todas.length > MAX_UBICACIONES_ACCESOS
+        ? [
+            `La organización tiene ${todas.length} ubicaciones: solo se han consultado ${MAX_UBICACIONES_ACCESOS}. Pide la ubicación para ver las demás.`,
+        ]
+        : [];
+    return { ubicaciones: todas.slice(0, MAX_UBICACIONES_ACCESOS), avisos };
+}
+/** Recorre las ubicaciones con `leer`; un 403 del gate es la App apagada y corta. Las demás caídas se cuentan. */
+export async function porUbicacion(ubicaciones, leer) {
+    const resultados = [];
+    let conError = 0;
+    for (const u of ubicaciones) {
+        try {
+            resultados.push({ ubicacion: u, valor: await leer(u) });
+        }
+        catch (err) {
+            if (isFeatureDisabled(err))
+                return fail(CONTROL_ACCESO_APAGADO);
+            // Un rol solo de otra ubicación da 403 en esta: se cuenta y se sigue.
+            if (err instanceof PatrolTechApiError) {
+                conError += 1;
+                continue;
+            }
+            throw err;
+        }
+    }
+    return { resultados, conError };
+}
+export function avisoUbicacionesSinLeer(conError) {
+    return conError > 0
+        ? [
+            `${conError} ubicación(es) no se pudieron consultar (permisos o error): sus accesos faltan. No afirmes que allí no ha entrado nadie.`,
+        ]
+        : [];
+}
+//# sourceMappingURL=access-locations.js.map

package/dist/reads/support/access-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-locations.js","sourceRoot":"","sources":["../../../src/reads/support/access-locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,IAAI,EAAmB,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEvD,8FAA8F;AAE9F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAW,CAAC;AACxE,uEAAuE;AACvE,6DAA6D;AAC7D,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,sBAAsB,GAC1B,gKAAgK,CAAC;AAEnK,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA0B,EAC1B,KAAa,EACb,KAAa,EACb,SAA6B;IAE7B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACxB,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,GAAG,uBAAuB;QACpC,CAAC,CAAC;YACE,yBAAyB,KAAK,CAAC,MAAM,wCAAwC,uBAAuB,yCAAyC;SAC9I;QACH,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC;AAED,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAA0B,EAC1B,IAAoC;IAIpC,MAAM,UAAU,GAA2C,EAAE,CAAC;IAC9D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,iBAAiB,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAChE,sEAAsE;YACtE,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,QAAQ,IAAI,CAAC,CAAC;gBACd,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,QAAQ,GAAG,CAAC;QACjB,CAAC,CAAC;YACE,GAAG,QAAQ,0HAA0H;SACtI;QACH,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/reads/support/excel.d.ts

@@ -0,0 +1,10 @@
+import { type ToolResult } from '../../domain/tool-result.js';
+import type { FileSink } from '../../ports/FileSink.js';
+/** Comprueba el periodo de un Excel (fechas YYYY-MM-DD, en orden y de 31 días como mucho); null si vale. */
+export declare function validarPeriodoExcel(desdeYmd: string, hastaYmd: string): ToolResult<never> | null;
+/**
+ * Envía un CSV como documento que se abre con Excel. Va declarado como lo que es
+ * (`text/csv`): el adaptador de cada canal lo cambia si su plataforma no lo admite.
+ */
+export declare function enviarCsv(files: FileSink, bytes: Uint8Array, filename: string, caption: string): Promise<void>;
+//# sourceMappingURL=excel.d.ts.map

package/dist/reads/support/excel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel.d.ts","sourceRoot":"","sources":["../../../src/reads/support/excel.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAOxD,4GAA4G;AAC5G,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAYhG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/reads/support/excel.js

@@ -0,0 +1,35 @@
+import { parseLocalDate } from '../../domain/date-range.js';
+import { fail } from '../../domain/tool-result.js';
+import { DIA_MS } from './scans.js';
+/** Lo común de los Excel que se envían: el periodo admitido y cómo sale el fichero. */
+const MAX_DIAS = 31;
+/** Comprueba el periodo de un Excel (fechas YYYY-MM-DD, en orden y de 31 días como mucho); null si vale. */
+export function validarPeriodoExcel(desdeYmd, hastaYmd) {
+    const desde = parseLocalDate(desdeYmd);
+    const hasta = parseLocalDate(hastaYmd);
+    if (!desde || !hasta)
+        return fail('Fechas no válidas: usa YYYY-MM-DD en «desde» y «hasta».');
+    const dias = (Date.UTC(hasta.y, hasta.m - 1, hasta.d) - Date.UTC(desde.y, desde.m - 1, desde.d)) / DIA_MS +
+        1;
+    if (dias < 1)
+        return fail('«desde» es posterior a «hasta»: corrige las fechas.');
+    if (dias > MAX_DIAS) {
+        return fail(`El periodo máximo es de ${MAX_DIAS} días: pídelo por meses o acota las fechas.`);
+    }
+    return null;
+}
+/**
+ * Envía un CSV como documento que se abre con Excel. Va declarado como lo que es
+ * (`text/csv`): el adaptador de cada canal lo cambia si su plataforma no lo admite.
+ */
+export async function enviarCsv(files, bytes, filename, caption) {
+    await files.sendDocument({
+        bytes,
+        filename,
+        // Un canal que no admita `text/csv` puede subirlo como `application/vnd.ms-excel` (el nombre
+        // sigue siendo .csv).
+        mimeType: 'text/csv',
+        caption,
+    });
+}
+//# sourceMappingURL=excel.js.map

package/dist/reads/support/excel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel.js","sourceRoot":"","sources":["../../../src/reads/support/excel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAmB,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,uFAAuF;AAEvF,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,4GAA4G;AAC5G,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,QAAgB;IACpE,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC7F,MAAM,IAAI,GACR,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM;QAC5F,CAAC,CAAC;IACJ,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACjF,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,2BAA2B,QAAQ,6CAA6C,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAe,EACf,KAAiB,EACjB,QAAgB,EAChB,OAAe;IAEf,MAAM,KAAK,CAAC,YAAY,CAAC;QACvB,KAAK;QACL,QAAQ;QACR,6FAA6F;QAC7F,sBAAsB;QACtB,QAAQ,EAAE,UAAU;QACpB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}