@patroltech/agent-capabilities 0.0.0-stage → 0.2.0

package/dist/actions/users.js

@@ -0,0 +1,146 @@
+import { z } from 'zod';
+import { segunIdioma } from '../domain/language.js';
+import { ambito, ROL_LABEL_ACCION } from '../reads/support/roles.js';
+import { ubicacionPedida } from './support/elegir-ubicacion.js';
+import { buscarPorEmail, INTERNO, sinPlazaDeGestor } from './support/shared.js';
+import { defineBotAction, ROLES, } from './types.js';
+/**
+ * Invitar a una persona al panel. Cambiar el rol o quitar el acceso a
+ * quien ya está va en `user-roles.ts`. La organización sale SIEMPRE de la sesión.
+ */
+// Validación de forma, no de entrega: la API no comprueba que el email exista y el correo de invitación dirá si llega.
+// Sin `<>,;:()[]"` ni punto final: lo que se cuela al copiarlo de una frase («…es luis@acme.test.»).
+const EMAIL_RE = /^[^\s@<>,;:()[\]"]+@[^\s@<>,;:()[\]"]+\.[^\s@<>,;:()[\]".]+$/;
+const inviteParams = {
+    nombre: z.string().trim().min(1).max(255).describe('Nombre de la persona'),
+    email: z.string().trim().min(1).max(255).describe('Email con el que entrará al panel'),
+    rol: z
+        .enum(ROLES)
+        .optional()
+        .describe('VIEWER (por defecto: solo ve la actividad; no ocupa plaza de gestor), EDITOR (gestiona checkpoints, rutas y vigilantes) o ' +
+        'ADMIN (todo, también usuarios y licencia). Usa VIEWER salvo que el cliente pida otro.'),
+    ubicacion: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe('SOLO si su acceso es a UNA ubicación: su nombre. OMÍTELO para toda la organización.'),
+    ubicacion_id: z.string().optional().describe(INTERNO),
+};
+export function inviteUser(env) {
+    const { gateway, urls } = env;
+    return defineBotAction({
+        nombre: 'invite_user',
+        tool: 'proponer_invitar_usuario',
+        descripcion: 'Prepara invitar a una persona al panel (dashboard) de la organización, con su propio usuario. NO la invita: le envía al cliente ' +
+            'un resumen con un botón para confirmarlo. Hace falta su nombre y su email; el rol es VIEWER (solo ver) salvo que pida otro, y el ' +
+            'acceso es a toda la organización salvo que diga una ubicación. Al confirmar le llega un correo para crear su contraseña.',
+        params: inviteParams,
+        rolMinimo: 'ADMIN',
+        rolDeOrganizacion: true,
+        async preparar(ctx, p) {
+            const email = p.email.trim().toLowerCase();
+            if (!EMAIL_RE.test(email))
+                return { error: `«${p.email}» no parece un email válido: pídeselo de nuevo al usuario.` };
+            const rol = p.rol ?? 'VIEWER';
+            let ubicacion;
+            if (p.ubicacion) {
+                // El backend no comprueba que la ubicación sea de la organización: el id sale SOLO de esta lista.
+                const u = ubicacionPedida(await gateway.listLocations(ctx.org.orgId, ctx.token), p.ubicacion, 'darle', false);
+                if ('error' in u)
+                    return u;
+                ubicacion = u.item;
+            }
+            // Con un rol ya en ese mismo ámbito, el backend rechaza la invitación (rol único por ámbito).
+            const scopeId = ubicacion?.id ?? ctx.org.orgId;
+            const existente = buscarPorEmail(await gateway.listOrgUsers(ctx.org.orgId, ctx.token), email);
+            const deOrganizacion = existente?.roles.find((r) => r.ambito === 'ORGANIZATION' && r.scopeId === ctx.org.orgId);
+            if (existente && deOrganizacion && ubicacion) {
+                // El backend la aceptaría (otro ámbito), pero ya ve esa ubicación: un rol de ubicación encima solo confunde.
+                return {
+                    error: `${existente.nombre} (${email}) ya tiene acceso a toda la organización como ${deOrganizacion.rol}, también a «${ubicacion.name}». ` +
+                        'No hace falta invitarla; si quiere cambiarle el rol, propón proponer_cambiar_rol_usuario.',
+                };
+            }
+            const yaTiene = existente?.roles.find((r) => r.scopeId === scopeId && r.ambito === (ubicacion ? 'LOCATION' : 'ORGANIZATION'));
+            if (existente && yaTiene) {
+                return {
+                    error: `${existente.nombre} (${email}) ya tiene acceso como ${yaTiene.rol} ${ambito('es', ubicacion?.name)}. ` +
+                        'No hace falta invitarla; si quiere cambiarle el rol, propón proponer_cambiar_rol_usuario.',
+                };
+            }
+            // Después de «ya tiene acceso»: a quien ya está, el plan lleno no le afecta.
+            if (rol !== 'VIEWER') {
+                // Anticipa el 402 USER_LIMIT_REACHED: un VIEWER nunca ocupa asiento de gestor.
+                const lleno = await sinPlazaDeGestor(env, ctx, {
+                    conPlan: 'ofrécele invitarla como VIEWER (solo ver), que no ocupa plaza,',
+                    sinPlan: 'ofrécele invitarla como VIEWER (solo ver), que no ocupa plaza',
+                });
+                if (lleno)
+                    return { error: lleno };
+            }
+            // El backend busca la cuenta por el email EXACTO: con otra capitalización crearía una segunda cuenta.
+            const emailCuenta = existente?.email.trim() ?? email;
+            return {
+                params: {
+                    nombre: p.nombre,
+                    email: emailCuenta,
+                    rol,
+                    ubicacion: ubicacion?.name,
+                    ubicacion_id: ubicacion?.id,
+                },
+            };
+        },
+        resumen(p, { idioma, organizacion }) {
+            const rol = ROL_LABEL_ACCION[p.rol ?? 'VIEWER'][idioma];
+            const donde = ambito(idioma, p.ubicacion);
+            return segunIdioma(idioma, {
+                es: `Invitar a ${p.nombre} (${p.email}) al panel de ${organizacion} como ${rol} ${donde}. Si aún no tiene cuenta en PatrolTech, le llegará un correo para crear su contraseña.`,
+                en: `Invite ${p.nombre} (${p.email}) to the ${organizacion} dashboard as ${rol} ${donde}. If they don't have a PatrolTech account yet, they'll get an email to set their password.`,
+                fr: `Inviter ${p.nombre} (${p.email}) sur le tableau de bord de ${organizacion} en tant que ${rol} ${donde}. Si cette personne n'a pas encore de compte PatrolTech, elle recevra un e-mail pour créer son mot de passe.`,
+            });
+        },
+        async ejecutar(ctx, p) {
+            const rolType = p.rol ?? 'VIEWER';
+            // Whitelist explícita (nunca `id`); la organización es la de la sesión y la ubicación la resuelta en `preparar`.
+            const input = {
+                organizationId: ctx.org.orgId,
+                name: p.nombre,
+                email: p.email,
+                roleType: rolType,
+                roleScope: p.ubicacion_id ? 'LOCATION' : 'ORGANIZATION',
+                ...(p.ubicacion_id ? { locationId: p.ubicacion_id } : {}),
+            };
+            const r = await gateway.inviteUser(input, ctx.token);
+            const rol = ROL_LABEL_ACCION[rolType][ctx.language];
+            const donde = ambito(ctx.language, p.ubicacion);
+            const quien = `${p.nombre} (${p.email})`;
+            if (!r.cuentaNueva) {
+                return {
+                    texto: segunIdioma(ctx.language, {
+                        es: `✅ ${quien} ya tenía cuenta en PatrolTech: se le ha añadido el rol ${rol} ${donde} en ${ctx.org.name}. Le llega un aviso y entra en ${urls.dashboard} con su contraseña de siempre.`,
+                        en: `✅ ${quien} already had a PatrolTech account: they've been given the ${rol} role ${donde} in ${ctx.org.name}. They'll get a notice and log in at ${urls.dashboard} with their usual password.`,
+                        fr: `✅ ${quien} avait déjà un compte PatrolTech : le rôle ${rol} ${donde} lui a été ajouté dans ${ctx.org.name}. Cette personne reçoit un avis et se connecte sur ${urls.dashboard} avec son mot de passe habituel.`,
+                    }),
+                };
+            }
+            if (!r.emailEnviado) {
+                return {
+                    texto: segunIdioma(ctx.language, {
+                        es: `✅ ${quien} ya tiene acceso a ${ctx.org.name} como ${rol} ${donde}, pero el correo de invitación no se ha podido enviar. Que entre en ${urls.dashboard} y pulse «¿Olvidaste tu contraseña?» con ese email para crear su contraseña.`,
+                        en: `✅ ${quien} now has access to ${ctx.org.name} as ${rol} ${donde}, but the invitation email couldn't be sent. Ask them to go to ${urls.dashboard} and click «Forgot your password?» with that email to set their password.`,
+                        fr: `✅ ${quien} a maintenant accès à ${ctx.org.name} en tant que ${rol} ${donde}, mais l'e-mail d'invitation n'a pas pu être envoyé. Demandez-lui d'aller sur ${urls.dashboard} et de cliquer sur «Mot de passe oublié ?» avec cet e-mail pour créer son mot de passe.`,
+                    }),
+                };
+            }
+            return {
+                texto: segunIdioma(ctx.language, {
+                    es: `✅ Invitación enviada a ${quien} en ${ctx.org.name}, como ${rol} ${donde}. Le llega el correo «Te han invitado a PatrolTech» con un enlace para crear su contraseña; el enlace caduca en 72 h. Después entrará en ${urls.dashboard}.`,
+                    en: `✅ Invitation sent to ${quien} in ${ctx.org.name}, as ${rol} ${donde}. They'll get an invitation email from PatrolTech with a link to set their password; the link expires in 72 h. Then they log in at ${urls.dashboard}.`,
+                    fr: `✅ Invitation envoyée à ${quien} dans ${ctx.org.name}, en tant que ${rol} ${donde}. Cette personne reçoit un e-mail d'invitation de PatrolTech avec un lien pour créer son mot de passe ; le lien expire dans 72 h. Ensuite, elle se connecte sur ${urls.dashboard}.`,
+                }),
+            };
+        },
+    });
+}
+//# sourceMappingURL=users.js.map

package/dist/actions/users.js.map

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

package/dist/catalog/buildCatalog.d.ts

@@ -0,0 +1,19 @@
+import type { ReadDeps } from '../reads/types.js';
+import type { Catalog, Channel } from './types.js';
+/**
+ * Dependencias del catálogo: las comunes (`gateway`, `logger`, `urls`) que
+ * reciben a la vez lecturas y acciones, más `offerFiles` de las lecturas.
+ */
+export type CatalogDeps = ReadDeps;
+/**
+ * El catálogo único de capacidades para un canal: cada lectura y cada acción
+ * junto a sus metadatos. Una capacidad sin entrada es un error de programación
+ * (se perdería en silencio de todos los canales), no un caso a tolerar.
+ *
+ * En `mcp` los textos van SIEMPRE sin upsell (`upsell: false`), digan lo que
+ * digan las dependencias: ni nombres de plan ni «mejorar el plan».
+ */
+export declare function buildCatalog(catalogDeps: CatalogDeps, opts: {
+    channel: Channel;
+}): Catalog;
+//# sourceMappingURL=buildCatalog.d.ts.map

package/dist/catalog/buildCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCatalog.d.ts","sourceRoot":"","sources":["../../src/catalog/buildCatalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAkB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAUnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAoB1F"}

package/dist/catalog/buildCatalog.js

@@ -0,0 +1,38 @@
+import { actionCatalog } from '../actions/index.js';
+import { readCapabilities } from '../reads/index.js';
+import { ACTION_ENTRIES, READ_ENTRIES } from './entries.js';
+function indexByCapability(entries) {
+    return new Map(entries.map((m) => [m.capability, m]));
+}
+/** ¿La ofrece este canal? Una entrada `off` no se ofrece en ninguno. */
+const offeredTo = (meta, channel) => meta.status !== 'off' && meta.channels.includes(channel);
+/**
+ * El catálogo único de capacidades para un canal: cada lectura y cada acción
+ * junto a sus metadatos. Una capacidad sin entrada es un error de programación
+ * (se perdería en silencio de todos los canales), no un caso a tolerar.
+ *
+ * En `mcp` los textos van SIEMPRE sin upsell (`upsell: false`), digan lo que
+ * digan las dependencias: ni nombres de plan ni «mejorar el plan».
+ */
+export function buildCatalog(catalogDeps, opts) {
+    const deps = opts.channel === 'mcp' ? { ...catalogDeps, upsell: false } : catalogDeps;
+    const readMetas = indexByCapability(READ_ENTRIES);
+    const actionMetas = indexByCapability(ACTION_ENTRIES);
+    const reads = readCapabilities(deps).map((read) => {
+        const meta = readMetas.get(read.name);
+        if (!meta)
+            throw new Error(`Lectura sin entrada en el catálogo: ${read.name}`);
+        return { meta, read };
+    });
+    const actions = actionCatalog(deps).map((action) => {
+        const meta = actionMetas.get(action.nombre);
+        if (!meta)
+            throw new Error(`Acción sin entrada en el catálogo: ${action.nombre}`);
+        return { meta, action };
+    });
+    return {
+        reads: reads.filter(({ meta }) => offeredTo(meta, opts.channel)),
+        actions: actions.filter(({ meta }) => offeredTo(meta, opts.channel)),
+    };
+}
+//# sourceMappingURL=buildCatalog.js.map

package/dist/catalog/buildCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCatalog.js","sourceRoot":"","sources":["../../src/catalog/buildCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5D,SAAS,iBAAiB,CAAC,OAAkC;IAC3D,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,wEAAwE;AACxE,MAAM,SAAS,GAAG,CAAC,IAAoB,EAAE,OAAgB,EAAW,EAAE,CACpE,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,WAAwB,EAAE,IAA0B;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACtF,MAAM,SAAS,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAChD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/catalog/english.d.ts

@@ -0,0 +1,14 @@
+import type { z } from 'zod';
+/**
+ * Los parámetros de una capacidad con nombres, valores y descripciones en inglés, para que los vea
+ * el modelo. Lanza si a alguno le falta la descripción en inglés (un parámetro nuevo sin traducir).
+ */
+export declare function englishInputSchema(id: string, shape: z.ZodRawShape): z.ZodRawShape;
+/**
+ * Los argumentos que mandó el modelo (en inglés) como los espera la capacidad (`shape`, sus
+ * parámetros en español). Lo que no es un parámetro de la capacidad se descarta.
+ */
+export declare function argsFromEnglish(shape: z.ZodRawShape, args: Record<string, unknown>): Record<string, unknown>;
+/** Los datos que devuelve una capacidad con sus claves en inglés (los valores no se tocan). */
+export declare function englishFields(value: unknown): unknown;
+//# sourceMappingURL=english.d.ts.map

package/dist/catalog/english.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"english.d.ts","sourceRoot":"","sources":["../../src/catalog/english.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsV7B;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAOlF;AA2BD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,CAAC,CAAC,WAAW,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD"}

package/dist/catalog/english.js

@@ -0,0 +1,368 @@
+/**
+ * La cara en inglés de las capacidades para los canales en inglés (el MCP): las capacidades y el
+ * bot siguen con sus parámetros y campos en español; el consumidor traduce en su borde con esto.
+ *
+ * Diccionarios fijos, no i18n. Un parámetro nuevo de una capacidad del canal `mcp` sin
+ * nombre o descripción aquí hace fallar `englishInputSchema` (y el test del catálogo); un campo de
+ * salida nuevo sin entrada sale tal cual, en español.
+ */
+/** Nombres en inglés de parámetros y campos, los mismos en la entrada y en la salida. */
+const NAMES = {
+    activa: 'active',
+    activar: 'enable',
+    alMenos: 'atLeast',
+    ambito: 'scope',
+    asignadaA: 'assignedTo',
+    asignadoA: 'assignedTo',
+    asignar_a: 'assignTo',
+    autor: 'author',
+    bateriaPct: 'batteryPct',
+    canal: 'channel',
+    cargando: 'charging',
+    categoria: 'category',
+    cerradaEn: 'closedAt',
+    checkpointsCreados: 'checkpointsCreated',
+    comentario: 'comment',
+    conexion: 'connection',
+    creadaEn: 'createdAt',
+    dentroAhora: 'insideNow',
+    descripcion: 'description',
+    desde: 'from',
+    dias: 'days',
+    dias_minimos: 'minDays',
+    diasSinEscanear: 'daysWithoutScan',
+    direccion: 'address',
+    dispositivo: 'device',
+    distanciaGpsM: 'gpsDistanceM',
+    enlace: 'link',
+    enlaceGeneral: 'generalLink',
+    enlaces: 'links',
+    entradas: 'entries',
+    entradasSinSalida: 'entriesWithoutExit',
+    escaneados: 'scanned',
+    escaneos: 'scans',
+    estado: 'status',
+    fecha: 'date',
+    fin: 'end',
+    fotos: 'photos',
+    franjas: 'timeWindows',
+    gestores: 'managers',
+    hasta: 'to',
+    hayEscaneos: 'hasScans',
+    hechos: 'done',
+    historial: 'history',
+    hora: 'time',
+    horarios: 'schedules',
+    identificador: 'identifier',
+    idioma: 'language',
+    incidencia: 'incident',
+    incidencias: 'incidents',
+    incluidos: 'included',
+    inicio: 'start',
+    limite: 'limit',
+    mensajeParaReenviar: 'messageToForward',
+    metodo: 'method',
+    modelo: 'model',
+    motivo: 'reason',
+    motivosSospecha: 'suspicionReasons',
+    nombre: 'name',
+    noValidos: 'invalid',
+    numero: 'number',
+    observador: 'viewer',
+    oculta: 'hidden',
+    operacion: 'operation',
+    orden_estricto: 'strictOrder',
+    otrasRondasCercanas: 'otherNearbyRounds',
+    pendientes: 'pending',
+    periodo: 'period',
+    pendientesRevision: 'pendingReview',
+    personas: 'people',
+    precisionGpsM: 'gpsAccuracyM',
+    prioridad: 'priority',
+    puesto: 'position',
+    que: 'what',
+    queHaceCadaRol: 'whatEachRoleDoes',
+    quien: 'who',
+    repetir_cada_min: 'repeatEveryMin',
+    reportadaPor: 'reportedBy',
+    resueltaEn: 'resolvedAt',
+    ronda: 'round',
+    ruta: 'route',
+    rutas: 'routes',
+    rutasCreadas: 'routesCreated',
+    salidas: 'exits',
+    siguientePaso: 'nextStep',
+    sinEscaneosVisibles: 'noVisibleScans',
+    sinSalidaRegistrada: 'withoutRecordedExit',
+    sistema: 'os',
+    sospechosos: 'suspicious',
+    solo_dentro: 'insideOnly',
+    solo_no_validos: 'invalidOnly',
+    solo_sospechosos: 'suspiciousOnly',
+    telefono: 'phone',
+    tipo: 'type',
+    titulo: 'title',
+    totalEscaneos: 'totalScans',
+    ubicacion: 'location',
+    ubicaciones: 'locations',
+    ultimoEscaneo: 'lastScan',
+    ultimos: 'latest',
+    usadas: 'used',
+    usados: 'used',
+    uso: 'usage',
+    usuarios: 'users',
+    validacion: 'validation',
+    validos: 'valid',
+    vigilante: 'guard',
+    vigilantes: 'guards',
+    vigilantesConAlgunEscaneo: 'guardsWithScans',
+    zona: 'zone',
+    zonaHoraria: 'timezone',
+};
+/** Valores de los parámetros enumerados (el resto de valores no se traduce). */
+const VALUES = {
+    hoy: 'today',
+    ayer: 'yesterday',
+    ultimos_7_dias: 'last_7_days',
+    ultimos_30_dias: 'last_30_days',
+    todos: 'all',
+    entrada: 'entry',
+    salida: 'exit',
+    abierto: 'open',
+    en_progreso: 'in_progress',
+    resuelto: 'resolved',
+    cerrado: 'closed',
+    descartado: 'dismissed',
+    codigo_manual: 'manual_code',
+    añadir: 'add',
+    quitar: 'remove',
+    lun: 'mon',
+    mar: 'tue',
+    mie: 'wed',
+    jue: 'thu',
+    vie: 'fri',
+    sab: 'sat',
+    dom: 'sun',
+};
+const OMIT_IF_UNCHANGED = 'Omit it if it does not change.';
+const DATE_FROM = 'Start date of the range, YYYY-MM-DD (never words like "yesterday").';
+const DATE_TO = 'End date of the range (inclusive), YYYY-MM-DD.';
+const PERIOD = 'Relative period. Use it when the user says "today", "yesterday", "last week", "last month" or similar.';
+const ROUTE_FILTER = 'Route name. Omit it (do not send it empty) if the user has not given one.';
+const DAYS = 'Days on which the time window STARTS.';
+const TIME_FROM = 'Start time, HH:mm in the local time of the account.';
+const TIME_TO = 'End time, HH:mm local. If it is earlier than `from`, it ends the next day (20:00-05:00).';
+/**
+ * Descripción en inglés de cada parámetro que ve el modelo, por id del catálogo y parámetro
+ * (los anidados, con su ruta: `franjas.dias`).
+ */
+const DESCRIPTIONS = {
+    'rounds.get_checkpoints': { ruta: ROUTE_FILTER },
+    'rounds.get_round': {
+        ruta: ROUTE_FILTER,
+        fecha: 'Day of the round in the calendar of the account, YYYY-MM-DD. Omit it for the latest round.',
+        hora: 'Approximate start time, HH:mm in the local time of the account. Only together with `date`.',
+    },
+    'routes.get_schedules': { ruta: ROUTE_FILTER },
+    'scans.list_recent': {
+        periodo: PERIOD,
+        desde: DATE_FROM,
+        hasta: DATE_TO,
+        vigilante: 'Guard name: only their scans. Omit it unless asked.',
+        checkpoint: 'Checkpoint name: only its scans. Omit it unless asked.',
+        ubicacion: 'Location name: only its scans. Omit it unless asked.',
+        solo_sospechosos: 'true: only the scans flagged as suspicious.',
+        solo_no_validos: 'true: only the rejected (invalid) scans.',
+    },
+    'patrollers.get_stats': {
+        vigilante: 'Name of the guard (never empty: if you do not know it, ask).',
+    },
+    'patrollers.get_ranking': {
+        periodo: PERIOD,
+        desde: DATE_FROM,
+        hasta: DATE_TO,
+    },
+    'scans.count_by_patroller': {
+        periodo: `${PERIOD} Omit it (and from/to) for the last 7 days.`,
+        desde: DATE_FROM,
+        hasta: DATE_TO,
+    },
+    'checkpoints.list_unreviewed': {
+        ubicacion: 'Only the checkpoints of this location. Omit it for all.',
+        dias_minimos: 'Only the ones with at least this many days without a scan. Omit it to see all.',
+    },
+    'patrollers.get_app_links': {
+        vigilante: 'Name of the guard who will receive it: returns their link and `messageToForward`, the message to forward to them. Omit it to list the links of every guard.',
+        idioma: "Language of `messageToForward`: 'es', 'en' or 'fr' (any other language: 'en').",
+    },
+    'incidents.list': { estado: 'Only the incidents with this status. Omit it to see all.' },
+    'incidents.get': {
+        incidencia: 'Title (or part of it), `id` or number in the incident list (without status filter).',
+    },
+    'access.list_logs': {
+        periodo: 'Period. Omit it (and from/to) for the last 24 hours.',
+        desde: DATE_FROM,
+        hasta: DATE_TO,
+        ubicacion: 'Location name. Omit it for all.',
+        zona: 'Access zone, written as in the dashboard. Omit it for all.',
+        tipo: 'Only entries or only exits. Omit it for both.',
+        solo_dentro: 'true: only who is inside now (entries without an exit in the last 24 h; older ones come apart, as exits not recorded).',
+    },
+    'checkpoints.propose_create': {
+        nombre: 'Checkpoint name: short, describing the place, in normal case, e.g. "Main entrance". No generic prefixes such as "Checkpoint 1" and no numbering; if the user gives it that way, propose the clean version (they see it in the summary). If they insist on their format, keep it.',
+        ubicacion: 'Location where to create it. Ask for it only if there are several.',
+        metodo: 'qr (default: printed and stuck on the spot) or manual_code (the guard types the code; when it cannot be printed).',
+    },
+    'alerts.propose_set_preference': {
+        tipo: 'Alert type: pending_route, missed_route, upcoming_deadline, patroller_inactive (guard inactive), suspicious_scan, role_assignment, incident_created, incident_status_changed, incident_assigned or incident_comment.',
+        canal: 'Channel: email, push or whatsapp.',
+        activar: 'true = start receiving it on that channel; false = stop receiving it.',
+    },
+    'routes.propose_create': {
+        nombre: 'Route name.',
+        ubicacion: 'Location of the route. Ask for it only if there are several.',
+        checkpoints: 'Names of the checkpoints of the route, in the order they are walked.',
+        orden_estricto: 'true = they must be scanned in that order. Default: no.',
+        franjas: 'Schedules of the route, in the local time of the account.',
+        'franjas.dias': DAYS,
+        'franjas.desde': TIME_FROM,
+        'franjas.hasta': TIME_TO,
+        'franjas.repetir_cada_min': 'ONLY for one round every X minutes inside the window (60 = one round per hour): it is split into schedules of that length. Without it, the window is ONE schedule for a single round.',
+    },
+    'routes.propose_add_time_window': {
+        ruta: 'Route name.',
+        dias: DAYS,
+        desde: TIME_FROM,
+        hasta: TIME_TO,
+    },
+    'routes.propose_set_active': {
+        ruta: 'Route name.',
+        activa: 'true = activate it; false = deactivate it.',
+    },
+    'routes.propose_change_checkpoint': {
+        ruta: 'Route name.',
+        checkpoint: 'Checkpoint name.',
+        operacion: 'add (at the end of the route) or remove.',
+    },
+    'incidents.propose_update': {
+        incidencia: 'Title of the incident (or part of it), or its `id` as listed by the incident list.',
+        estado: `New status: open, in_progress (it must be assigned), resolved (needs a comment), closed (FINAL) or dismissed (needs a comment; FINAL). ${OMIT_IF_UNCHANGED}`,
+        comentario: 'Comment to add. Required for resolved and dismissed (the reason).',
+        asignar_a: 'Dashboard user to assign it to (name or email), or "me" for the user themself. Omit it if it is not reassigned.',
+    },
+    'patrollers.propose_rename': {
+        vigilante: 'Current name of the guard.',
+        nombre: `New name. ${OMIT_IF_UNCHANGED}`,
+        telefono: `New phone number of the guard. ${OMIT_IF_UNCHANGED}`,
+    },
+    'checkpoints.propose_edit': {
+        checkpoint: 'Current name of the checkpoint.',
+        ubicacion: 'Location of the checkpoint, if several share that name. Omit it otherwise.',
+        nombre: `New name. ${OMIT_IF_UNCHANGED}`,
+        descripcion: `New description. ${OMIT_IF_UNCHANGED}`,
+    },
+    'locations.propose_edit': {
+        ubicacion: 'Current name of the location. Ask for it only if there are several.',
+        nombre: `New name. ${OMIT_IF_UNCHANGED}`,
+        direccion: `New address. ${OMIT_IF_UNCHANGED} It cannot be left empty.`,
+    },
+};
+const english = (name) => NAMES[name] ?? name;
+const englishValue = (value) => VALUES[value] ?? value;
+const spanishValue = (value, values) => values.find((v) => englishValue(v) === value) ?? value;
+/** El mismo esquema con los valores enumerados y las claves de objeto en inglés (conserva sus checks). */
+function translateSchema(schema, describe, path) {
+    const s = schema;
+    const { def } = s;
+    switch (def.type) {
+        case 'optional':
+        case 'nullable':
+        case 'default':
+            return s.clone({
+                ...def,
+                innerType: translateSchema(def.innerType, describe, path),
+            });
+        case 'array':
+            return s.clone({
+                ...def,
+                element: translateSchema(def.element, () => '', path),
+            });
+        case 'enum': {
+            const values = Object.values(def.entries).map(englishValue);
+            return s.clone({ ...def, entries: Object.fromEntries(values.map((v) => [v, v])) });
+        }
+        case 'object':
+            return s.clone({
+                ...def,
+                shape: translateShape(def.shape, describe, `${path}.`),
+            });
+        default:
+            return schema;
+    }
+}
+function translateShape(shape, describe, prefix = '') {
+    return Object.fromEntries(Object.entries(shape).map(([name, schema]) => {
+        const translated = translateSchema(schema, describe, `${prefix}${name}`);
+        return [english(name), translated.describe(describe(`${prefix}${name}`))];
+    }));
+}
+/**
+ * Los parámetros de una capacidad con nombres, valores y descripciones en inglés, para que los vea
+ * el modelo. Lanza si a alguno le falta la descripción en inglés (un parámetro nuevo sin traducir).
+ */
+export function englishInputSchema(id, shape) {
+    const descriptions = DESCRIPTIONS[id] ?? {};
+    return translateShape(shape, (path) => {
+        const description = descriptions[path];
+        if (!description)
+            throw new Error(`No English description for the param ${id}.${path}`);
+        return description;
+    });
+}
+/** Un valor en inglés de vuelta a lo que espera la capacidad, guiado por su esquema en español. */
+function toSpanish(schema, value) {
+    const { def } = schema;
+    switch (def.type) {
+        case 'optional':
+        case 'nullable':
+        case 'default':
+            return toSpanish(def.innerType, value);
+        case 'array':
+            return Array.isArray(value)
+                ? value.map((v) => toSpanish(def.element, v))
+                : value;
+        case 'enum':
+            return typeof value === 'string'
+                ? spanishValue(value, Object.values(def.entries))
+                : value;
+        case 'object':
+            return value && typeof value === 'object'
+                ? argsFromEnglish(def.shape, value)
+                : value;
+        default:
+            return value;
+    }
+}
+/**
+ * Los argumentos que mandó el modelo (en inglés) como los espera la capacidad (`shape`, sus
+ * parámetros en español). Lo que no es un parámetro de la capacidad se descarta.
+ */
+export function argsFromEnglish(shape, args) {
+    const out = {};
+    for (const [name, schema] of Object.entries(shape)) {
+        const value = args[english(name)];
+        if (value !== undefined)
+            out[name] = toSpanish(schema, value);
+    }
+    return out;
+}
+/** Los datos que devuelve una capacidad con sus claves en inglés (los valores no se tocan). */
+export function englishFields(value) {
+    if (Array.isArray(value))
+        return value.map(englishFields);
+    if (value && Object.getPrototypeOf(value) === Object.prototype) {
+        return Object.fromEntries(Object.entries(value).map(([key, v]) => [english(key), englishFields(v)]));
+    }
+    return value;
+}
+//# sourceMappingURL=english.js.map

package/dist/catalog/english.js.map

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

package/dist/catalog/entries.d.ts

@@ -0,0 +1,6 @@
+import type { CapabilityMeta } from './types.js';
+/** Las 25 lecturas, con el nombre que tienen en el bot. */
+export declare const READ_ENTRIES: readonly CapabilityMeta[];
+/** Las 19 acciones de escritura, con el nombre de `BOT_ACTIONS`. */
+export declare const ACTION_ENTRIES: readonly CapabilityMeta[];
+//# sourceMappingURL=entries.d.ts.map

package/dist/catalog/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../src/catalog/entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,YAAY,CAAC;AA+C1D,2DAA2D;AAC3D,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAuUjD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,cAAc,EAAE,SAAS,cAAc,EA0PnD,CAAC"}