@patroltech/agent-capabilities 0.0.0-stage → 0.2.1

package/dist/actions/support/shared.d.ts

@@ -0,0 +1,112 @@
+import { type FixedTextLanguage } from '../../domain/language.js';
+import type { CheckpointRef, LocationRef } from '../../gateway/index.js';
+import { AccionRechazada } from '../names.js';
+import type { ActionEnv } from '../types.js';
+/** Piezas comunes a los ficheros de acciones (checkpoints, rutas, vigilantes, ubicaciones, usuarios…). */
+/**
+ * Lo que resuelve `preparar` (id de ubicación, identificador del
+ * vigilante) viaja en los propios parámetros, que son lo único que guarda la
+ * acción pendiente; por eso el modelo ve esos campos. `preparar` los
+ * sobrescribe SIEMPRE, así que lo que ponga el modelo no llega al backend.
+ */
+export declare const INTERNO = "Interno: lo rellena el sistema; no lo rellenes ni lo indiques.";
+/**
+ * Los parámetros de una acción que rellena `preparar` (descritos con `INTERNO`): un canal que
+ * construye su propio esquema de entrada (el MCP) los quita, porque el modelo no debe rellenarlos
+ * y `preparar` los sobrescribe igualmente.
+ */
+export declare function internalParamNames(params: Readonly<Record<string, unknown>>): string[];
+/** «Luis Mora (luis@acme.test)», o solo el nombre si no hay email. */
+export declare const quien: (p: {
+    usuario: string;
+    email?: string;
+}) => string;
+/** La persona con ese email (exacto, sin mayúsculas ni espacios alrededor). */
+export declare function buscarPorEmail<T extends {
+    email: string;
+}>(usuarios: readonly T[], email: string): T | undefined;
+/**
+ * Al confirmar, una protección que ya no se cumple: «⚠️ No se ha hecho ningún
+ * cambio: <motivo>» en el idioma del cliente (queda `failed` sin tocar nada).
+ */
+export declare function sinCambios(idioma: FixedTextLanguage, motivo: Record<FixedTextLanguage, string>): AccionRechazada;
+/**
+ * El consejo al modelo cuando la organización está en un límite: con `upsell`
+ * (el bot) se le suma ampliar el plan; sin él (MCP), solo las alternativas.
+ */
+export interface ConsejoDeLimite {
+    /** Termina donde el bot añade «o mejorar el plan en Licencia (…)». */
+    conPlan: string;
+    /** Frase completa, sin plan ni Licencia. */
+    sinPlan: string;
+}
+/**
+ * Anticipa el 402 de plazas de gestor (Editor o Admin): el error al modelo con
+ * el consejo de quien llama, o null si cabe (o el plan no tiene límite). Sin
+ * `upsell`, el límite va con sus números y sin el nombre del plan.
+ */
+export declare function sinPlazaDeGestor({ gateway, urls, upsell }: Pick<ActionEnv, 'gateway' | 'urls' | 'upsell'>, ctx: {
+    org: {
+        orgId: string;
+    };
+    token: string;
+}, consejo: ConsejoDeLimite): Promise<string | null>;
+/** «A», «B», «C»; con más de `max`, los primeros y «y N más» en el idioma del cliente. */
+export declare function listaCitada(nombres: readonly string[], idioma?: FixedTextLanguage, max?: number): string;
+/**
+ * Aviso, antes de confirmar, de las rutas que se quedarán sin checkpoints y que
+ * el backend desactivará. Uno solo para quitar de una ruta y para archivar.
+ */
+export declare function avisoRutaVacia(rutas: readonly string[], idioma: FixedTextLanguage): string;
+/**
+ * Nombre dicho por el usuario → elemento, o el error con las opciones para que
+ * el modelo pregunte («No encuentro el checkpoint «X»…», «Hay varios checkpoints…»).
+ */
+export declare function resolver<T>(valor: string, items: readonly T[], nameOf: (item: T) => string, [singular, plural]: [string, string], opts?: {
+    idOf?: (item: T) => string;
+    etiqueta?: (item: T) => string;
+}): {
+    item: T;
+} | {
+    error: string;
+};
+/** Íd. con el texto de las acciones de rutas (`entre`: «las rutas»): «No encuentro «X» entre las rutas…». */
+export declare function elegir<T>(nombre: string, items: readonly T[], nameOf: (item: T) => string, entre: string): {
+    item: T;
+} | {
+    error: string;
+};
+/** Checkpoint por nombre, acotado a una ubicación si la dice (dos pueden llamarse igual en ubicaciones distintas). */
+export declare function resolverCheckpoint(items: CheckpointRef[], checkpoint: string, ubicacion?: string): {
+    item: CheckpointRef;
+} | {
+    error: string;
+};
+/** La ubicación dicha por el usuario; sin decirla, la única que tenga. `para` completa «pregúntale en cuál …». */
+export declare function ubicacionPara(ubicaciones: LocationRef[], nombre: string | undefined, para: string): {
+    item: LocationRef;
+} | {
+    error: string;
+};
+/**
+ * ¿Pudo el backend aplicar la escritura aunque la respuesta fuera un error?
+ * Red, timeout o 5xx: puede que sí (hay que comprobarlo antes de decir que no
+ * se hizo nada). Un 4xx es un rechazo: seguro que no.
+ */
+export declare function maybeApplied(err: unknown): boolean;
+/**
+ * Anticipa el 402/409 de checkpoints del plan (crear y desarchivar cuentan
+ * igual): nunca se confirma un cobro extra desde aquí. Devuelve el error al
+ * modelo (cada consejo recibe «Ha llegado al límite … (3 de 5)»), o null si
+ * cabe. Sin `upsell`, el límite no nombra el plan y se usa `sinPlan`.
+ */
+export declare function sinPlazaDeCheckpoint({ gateway, upsell }: Pick<ActionEnv, 'gateway' | 'upsell'>, ctx: {
+    org: {
+        orgId: string;
+    };
+    token: string;
+}, consejo: {
+    conPlan: (alLimite: string) => string;
+    sinPlan: (alLimite: string) => string;
+}): Promise<string | null>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/actions/support/shared.d.ts.map

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

package/dist/actions/support/shared.js

@@ -0,0 +1,171 @@
+import { PatrolTechApiError } from '../../domain/backend-errors.js';
+import { segunIdioma } from '../../domain/language.js';
+import { resolveByName } from '../../domain/resolve-by-name.js';
+import { AccionRechazada } from '../names.js';
+import { elegirUbicacion } from './elegir-ubicacion.js';
+/** Piezas comunes a los ficheros de acciones (checkpoints, rutas, vigilantes, ubicaciones, usuarios…). */
+/**
+ * Lo que resuelve `preparar` (id de ubicación, identificador del
+ * vigilante) viaja en los propios parámetros, que son lo único que guarda la
+ * acción pendiente; por eso el modelo ve esos campos. `preparar` los
+ * sobrescribe SIEMPRE, así que lo que ponga el modelo no llega al backend.
+ */
+export const INTERNO = 'Interno: lo rellena el sistema; no lo rellenes ni lo indiques.';
+/**
+ * Los parámetros de una acción que rellena `preparar` (descritos con `INTERNO`): un canal que
+ * construye su propio esquema de entrada (el MCP) los quita, porque el modelo no debe rellenarlos
+ * y `preparar` los sobrescribe igualmente.
+ */
+export function internalParamNames(params) {
+    return Object.entries(params)
+        .filter(([, schema]) => schema.description === INTERNO)
+        .map(([name]) => name);
+}
+/** «Luis Mora (luis@acme.test)», o solo el nombre si no hay email. */
+export const quien = (p) => `${p.usuario}${p.email ? ` (${p.email})` : ''}`;
+/** La persona con ese email (exacto, sin mayúsculas ni espacios alrededor). */
+export function buscarPorEmail(usuarios, email) {
+    const buscado = email.trim().toLowerCase();
+    return usuarios.find((u) => u.email.trim().toLowerCase() === buscado);
+}
+/**
+ * Al confirmar, una protección que ya no se cumple: «⚠️ No se ha hecho ningún
+ * cambio: <motivo>» en el idioma del cliente (queda `failed` sin tocar nada).
+ */
+export function sinCambios(idioma, motivo) {
+    return new AccionRechazada(segunIdioma(idioma, {
+        es: `⚠️ No se ha hecho ningún cambio: ${motivo.es}`,
+        en: `⚠️ No changes have been made: ${motivo.en}`,
+        fr: `⚠️ Aucune modification n'a été effectuée : ${motivo.fr}`,
+    }));
+}
+/**
+ * Anticipa el 402 de plazas de gestor (Editor o Admin): el error al modelo con
+ * el consejo de quien llama, o null si cabe (o el plan no tiene límite). Sin
+ * `upsell`, el límite va con sus números y sin el nombre del plan.
+ */
+export async function sinPlazaDeGestor({ gateway, urls, upsell }, ctx, consejo) {
+    const plan = await gateway.getPlanUsage(ctx.org.orgId, ctx.token);
+    const g = plan.uso?.gestores;
+    if (!g || g.limite === null || g.usados < g.limite)
+        return null;
+    if (!upsell) {
+        return (`Ha llegado al límite de gestores (Editor o Admin) de la organización (${g.usados} de ${g.limite}). ` +
+            `No lo propongas así: ${consejo.sinPlan}.`);
+    }
+    return (`Ha llegado al límite de gestores (Editor o Admin) de su plan ${plan.plan} (${g.usados} de ${g.limite}). No lo propongas así: ` +
+        `${consejo.conPlan} o mejorar el plan en Licencia (${urls.license}).`);
+}
+/** Opciones que se le dan al modelo para que pregunte (las demás se cuentan con «y N más»). */
+const MAX_OPCIONES = 15;
+/** Nombres que se citan en un resumen o un resultado: la confirmación tiene que poder leerse entera. */
+const MAX_CITADOS = 10;
+/** «A», «B», «C»; con más de `max`, los primeros y «y N más» en el idioma del cliente. */
+export function listaCitada(nombres, idioma = 'es', max = MAX_CITADOS) {
+    const citados = nombres
+        .slice(0, max)
+        .map((n) => `«${n}»`)
+        .join(', ');
+    const resto = nombres.length - max;
+    if (resto <= 0)
+        return citados;
+    return `${citados} ${segunIdioma(idioma, { es: `y ${resto} más`, en: `and ${resto} more`, fr: `et ${resto} de plus` })}`;
+}
+/**
+ * Aviso, antes de confirmar, de las rutas que se quedarán sin checkpoints y que
+ * el backend desactivará. Uno solo para quitar de una ruta y para archivar.
+ */
+export function avisoRutaVacia(rutas, idioma) {
+    const nombres = listaCitada(rutas, idioma);
+    if (rutas.length === 1) {
+        return segunIdioma(idioma, {
+            es: `⚠️ La ruta ${nombres} se quedará sin checkpoints y se desactivará: no generará rondas hasta que le añadas checkpoints y la vuelvas a activar.`,
+            en: `⚠️ The route ${nombres} will be left without checkpoints and deactivated: it won't generate rounds until you add checkpoints and activate it again.`,
+            fr: `⚠️ Le parcours ${nombres} restera sans checkpoints et sera désactivé : il ne générera plus de rondes tant que vous n'y ajouterez pas de checkpoints et ne le réactiverez pas.`,
+        });
+    }
+    return segunIdioma(idioma, {
+        es: `⚠️ Las rutas ${nombres} se quedarán sin checkpoints y se desactivarán: no generarán rondas hasta que les añadas checkpoints y las vuelvas a activar.`,
+        en: `⚠️ The routes ${nombres} will be left without checkpoints and deactivated: they won't generate rounds until you add checkpoints and activate them again.`,
+        fr: `⚠️ Les parcours ${nombres} resteront sans checkpoints et seront désactivés : ils ne généreront plus de rondes tant que vous n'y ajouterez pas de checkpoints et ne les réactiverez pas.`,
+    });
+}
+/**
+ * Nombre dicho por el usuario → elemento, o el error con las opciones para que
+ * el modelo pregunte («No encuentro el checkpoint «X»…», «Hay varios checkpoints…»).
+ */
+export function resolver(valor, items, nameOf, [singular, plural], opts = {}) {
+    const r = resolveByName(valor, items, nameOf, { idOf: opts.idOf });
+    if (r.kind === 'found')
+        return { item: r.item };
+    const lista = listaCitada((r.kind === 'ambiguous' ? r.matches : items).map(opts.etiqueta ?? nameOf), 'es', MAX_OPCIONES);
+    if (r.kind === 'ambiguous') {
+        return {
+            error: `Hay varios ${plural} que casan con «${valor}»: pregunta al usuario cuál (${lista}).`,
+        };
+    }
+    return {
+        error: `No encuentro ${singular} «${valor}». ${lista ? `Pregunta al usuario cuál: ${lista}.` : `No hay ${plural}.`}`,
+    };
+}
+/** Íd. con el texto de las acciones de rutas (`entre`: «las rutas»): «No encuentro «X» entre las rutas…». */
+export function elegir(nombre, items, nameOf, entre) {
+    const r = resolveByName(nombre, items, nameOf);
+    if (r.kind === 'found')
+        return { item: r.item };
+    const opciones = (r.kind === 'ambiguous' ? r.matches : items).map(nameOf);
+    const motivo = r.kind === 'ambiguous'
+        ? `«${nombre}» casa con varios de ${entre}`
+        : `No encuentro «${nombre}» entre ${entre}`;
+    return {
+        error: `${motivo}. Pregunta al usuario cuál${opciones.length ? `: ${listaCitada(opciones, 'es', MAX_OPCIONES)}` : ''}.`,
+    };
+}
+/** Checkpoint por nombre, acotado a una ubicación si la dice (dos pueden llamarse igual en ubicaciones distintas). */
+export function resolverCheckpoint(items, checkpoint, ubicacion) {
+    let candidatos = items;
+    if (ubicacion?.trim()) {
+        const ubicaciones = [
+            ...new Map(items.map((c) => [c.locationId, { id: c.locationId, name: c.locationName }])).values(),
+        ];
+        const u = resolver(ubicacion, ubicaciones, (l) => l.name, ['la ubicación', 'ubicaciones']);
+        if ('error' in u)
+            return u;
+        candidatos = items.filter((c) => c.locationId === u.item.id);
+    }
+    return resolver(checkpoint, candidatos, (c) => c.name, ['el checkpoint', 'checkpoints'], {
+        etiqueta: (c) => `${c.name} (${c.locationName})`,
+    });
+}
+/** La ubicación dicha por el usuario; sin decirla, la única que tenga. `para` completa «pregúntale en cuál …». */
+export function ubicacionPara(ubicaciones, nombre, para) {
+    return elegirUbicacion(ubicaciones, nombre, {
+        sinUbicaciones: 'La organización no tiene ubicaciones: primero hay que crear una en el panel (Ubicaciones).',
+        preguntar: (opciones) => `El usuario tiene varias ubicaciones: pregúntale en cuál ${para} (${opciones}).`,
+    });
+}
+/**
+ * ¿Pudo el backend aplicar la escritura aunque la respuesta fuera un error?
+ * Red, timeout o 5xx: puede que sí (hay que comprobarlo antes de decir que no
+ * se hizo nada). Un 4xx es un rechazo: seguro que no.
+ */
+export function maybeApplied(err) {
+    return !(err instanceof PatrolTechApiError) || err.status >= 500;
+}
+/**
+ * Anticipa el 402/409 de checkpoints del plan (crear y desarchivar cuentan
+ * igual): nunca se confirma un cobro extra desde aquí. Devuelve el error al
+ * modelo (cada consejo recibe «Ha llegado al límite … (3 de 5)»), o null si
+ * cabe. Sin `upsell`, el límite no nombra el plan y se usa `sinPlan`.
+ */
+export async function sinPlazaDeCheckpoint({ gateway, upsell }, ctx, consejo) {
+    const plan = await gateway.getPlanUsage(ctx.org.orgId, ctx.token);
+    const cps = plan.uso?.checkpoints;
+    if (!cps || cps.incluidos === null || cps.usados < cps.incluidos)
+        return null;
+    if (!upsell) {
+        return consejo.sinPlan(`Ha llegado al límite de checkpoints de la organización (${cps.usados} de ${cps.incluidos})`);
+    }
+    return consejo.conPlan(`Ha llegado al límite de checkpoints de su plan ${plan.plan} (${cps.usados} de ${cps.incluidos})`);
+}
+//# sourceMappingURL=shared.js.map

package/dist/actions/support/shared.js.map

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

package/dist/actions/support/texts.d.ts

@@ -0,0 +1,47 @@
+import type { FixedTextLanguage } from '../../domain/language.js';
+import { type PatrolTechUrls } from '../../domain/urls.js';
+/** Textos fijos del motor de acciones en un idioma. */
+export interface ActionTexts {
+    intro: string;
+    pregunta: string;
+    sinBotones: string;
+    confirmar: string;
+    cancelar: string;
+    cancelado: string;
+    caducada: string;
+    noPendiente: string;
+    noDisponible: string;
+    sinSesion: string;
+    sinCambiosAun: string;
+    /** Cierre de un lote con fallos: cuántas se hicieron y los números (de la lista) de las que no. */
+    loteResumen: (hechas: number, total: number, fallidas: number[]) => string;
+    /** Al ejecutar, el backend pidió aceptar las políticas (451): la propuesta sigue viva para volver a confirmarla. */
+    politicasPendientes: string;
+}
+/**
+ * Textos fijos del motor de acciones (no los escribe el modelo). En español,
+ * inglés y francés; el idioma lo decide `fixedTextLanguage`. `urls` son los
+ * enlaces que citan (los mismos que se dan a `actionCatalog`; por defecto, los de producción).
+ */
+export declare function actionTexts(urls?: Partial<PatrolTechUrls>): Record<FixedTextLanguage, ActionTexts>;
+/** Botones del siguiente paso de la puesta en marcha. Máximo 20 caracteres (botón de WhatsApp; lo vigila un test). */
+export type NextStepButton = 'vigilante' | 'otroVigilante' | 'checkpoint' | 'otroCheckpoint' | 'ruta' | 'anadirARuta' | 'probarEscaneo' | 'yaEscaneado' | 'rondas';
+/**
+ * Textos fijos del siguiente paso de la puesta en marcha (tras crear un
+ * checkpoint, un vigilante o una ruta, y en el nudge de una cuenta a medio
+ * arrancar). Al pulsar un botón llega su texto como un mensaje más del cliente
+ * y lo contesta el modelo con sus herramientas.
+ */
+export declare const NEXT_STEP_TEXTS: Record<FixedTextLanguage, {
+    faltaCheckpoint: string;
+    faltaVigilante: string;
+    faltaEscaneo: string;
+    trasCheckpointSinEscaneo: string;
+    trasCheckpointSinRutas: string;
+    trasCheckpointConRutas: string;
+    trasVigilante: string;
+    trasVigilanteSinCheckpoints: string;
+    trasRuta: string;
+    botones: Record<NextStepButton, string>;
+}>;
+//# sourceMappingURL=texts.d.ts.map

package/dist/actions/support/texts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texts.d.ts","sourceRoot":"","sources":["../../../src/actions/support/texts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;IAC3E,oHAAoH;IACpH,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,GACjC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAiExC;AAED,sHAAsH;AACtH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,MAAM,GACN,aAAa,GACb,eAAe,GACf,aAAa,GACb,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,iBAAiB,EACjB;IACE,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,EAAE,MAAM,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACzC,CA0FF,CAAC"}

package/dist/actions/support/texts.js

@@ -0,0 +1,134 @@
+import { resolveUrls } from '../../domain/urls.js';
+/**
+ * Textos fijos del motor de acciones (no los escribe el modelo). En español,
+ * inglés y francés; el idioma lo decide `fixedTextLanguage`. `urls` son los
+ * enlaces que citan (los mismos que se dan a `actionCatalog`; por defecto, los de producción).
+ */
+export function actionTexts(urls = {}) {
+    const { dashboard } = resolveUrls(urls);
+    return {
+        es: {
+            intro: 'Voy a hacer esto por ti:',
+            pregunta: '¿Lo confirmas?',
+            sinBotones: 'Responde «sí» para confirmarlo o «no» para cancelarlo.',
+            confirmar: 'Confirmar',
+            cancelar: 'Cancelar',
+            cancelado: 'Cancelado, no he cambiado nada.',
+            caducada: 'La propuesta caducó; ¿la preparo de nuevo?',
+            noPendiente: 'Esa acción ya no está pendiente.',
+            noDisponible: 'Esa acción ya no está disponible desde aquí. No se ha hecho ningún cambio.',
+            sinSesion: 'No he podido comprobar tu usuario en el panel. No se ha hecho ningún cambio; inténtalo de nuevo en unos minutos.',
+            sinCambiosAun: 'Aún no he hecho ningún cambio. ¿Quieres que lo prepare para que lo confirmes?',
+            loteResumen: (hechas, total, fallidas) => `Hecho: ${hechas} de ${total}. No se ha hecho: ${fallidas.join(', ')}.`,
+            politicasPendientes: `Antes de hacerlo tienes que aceptar las políticas vigentes en el panel (${dashboard}). ` +
+                'Cuando las aceptes, vuelve a pulsar *Confirmar*: lo tengo preparado.',
+        },
+        en: {
+            intro: "Here's what I'll do for you:",
+            pregunta: 'Do you confirm?',
+            sinBotones: 'Reply «yes» to confirm or «no» to cancel.',
+            confirmar: 'Confirm',
+            cancelar: 'Cancel',
+            cancelado: "Cancelled, I haven't changed anything.",
+            caducada: 'That proposal expired; shall I prepare it again?',
+            noPendiente: 'That action is no longer pending.',
+            noDisponible: 'That action is no longer available from here. No changes have been made.',
+            sinSesion: "I couldn't verify your user in the dashboard. No changes have been made; please try again in a few minutes.",
+            sinCambiosAun: "I haven't made any changes yet. Would you like me to prepare it so you can confirm it?",
+            loteResumen: (hechas, total, fallidas) => `Done: ${hechas} of ${total}. Not done: ${fallidas.join(', ')}.`,
+            politicasPendientes: `Before I can do it you need to accept the current policies in the dashboard (${dashboard}). ` +
+                "Once you've accepted them, press *Confirm* again: I have it ready.",
+        },
+        fr: {
+            intro: 'Voici ce que je vais faire pour vous :',
+            pregunta: 'Vous confirmez ?',
+            sinBotones: 'Répondez «oui» pour confirmer ou «non» pour annuler.',
+            confirmar: 'Confirmer',
+            cancelar: 'Annuler',
+            cancelado: "C'est annulé, je n'ai rien modifié.",
+            caducada: 'La proposition a expiré ; voulez-vous que je la prépare à nouveau ?',
+            noPendiente: "Cette action n'est plus en attente.",
+            noDisponible: "Cette action n'est plus disponible ici. Aucune modification n'a été effectuée.",
+            sinSesion: "Je n'ai pas pu vérifier votre utilisateur dans le tableau de bord. Aucune modification n'a été effectuée ; réessayez dans quelques minutes.",
+            sinCambiosAun: "Je n'ai encore rien modifié. Voulez-vous que je le prépare pour que vous puissiez le confirmer ?",
+            loteResumen: (hechas, total, fallidas) => `Fait : ${hechas} sur ${total}. Non fait : ${fallidas.join(', ')}.`,
+            politicasPendientes: `Pour que je puisse le faire, acceptez les politiques en vigueur dans le tableau de bord (${dashboard}), ` +
+                'puis appuyez à nouveau sur *Confirmer* : tout est prêt de mon côté.',
+        },
+    };
+}
+/**
+ * Textos fijos del siguiente paso de la puesta en marcha (tras crear un
+ * checkpoint, un vigilante o una ruta, y en el nudge de una cuenta a medio
+ * arrancar). Al pulsar un botón llega su texto como un mensaje más del cliente
+ * y lo contesta el modelo con sus herramientas.
+ */
+export const NEXT_STEP_TEXTS = {
+    es: {
+        faltaCheckpoint: 'Siguiente paso: crear tu primer checkpoint; te mando su QR para imprimirlo.',
+        faltaVigilante: 'Siguiente paso: dar de alta a tu vigilante para que pueda escanear los QR.',
+        faltaEscaneo: 'Siguiente paso: que tu vigilante instale la app «Patrol Tech Scan» en su móvil y escanee uno de los QR. Así comprobamos que todo funciona de principio a fin antes de montar las rondas.',
+        trasCheckpointSinEscaneo: 'Siguiente paso: imprime el QR y que tu vigilante, con la app «Patrol Tech Scan» instalada, lo escanee. Es lo más importante ahora: comprobar que el escaneo llega bien antes de montar las rondas.',
+        trasCheckpointSinRutas: 'Siguiente paso: imprime el QR y colócalo en su sitio. Como ya funcionan los escaneos, puedes crear una ruta para controlar las rondas con horario.',
+        trasCheckpointConRutas: 'Siguiente paso: imprime el QR y colócalo en su sitio. Si quieres que se revise en las rondas, añádelo a una ruta.',
+        trasVigilante: 'Siguiente paso: reenvíale el mensaje con su acceso para que instale la app y escanee uno de los QR. Cuando lo haga, lo comprobamos juntos.',
+        trasVigilanteSinCheckpoints: 'Siguiente paso: crear tu primer checkpoint para que tu vigilante tenga un QR que escanear.',
+        trasRuta: 'Siguiente paso: que tu vigilante haga una ronda de prueba escaneando los QR de la ruta; después te cuento cómo ha ido.',
+        botones: {
+            vigilante: 'Alta de un vigilante',
+            otroVigilante: 'Otro vigilante',
+            checkpoint: 'Crear un checkpoint',
+            otroCheckpoint: 'Otro checkpoint',
+            ruta: 'Crear una ruta',
+            anadirARuta: 'Añadir a una ruta',
+            probarEscaneo: 'Probar un escaneo',
+            yaEscaneado: 'Ya ha escaneado',
+            rondas: 'Cómo van las rondas',
+        },
+    },
+    en: {
+        faltaCheckpoint: "Next step: create your first checkpoint; I'll send you its QR code to print.",
+        faltaVigilante: 'Next step: add your guard so they can scan the QR codes.',
+        faltaEscaneo: 'Next step: have your guard install the «Patrol Tech Scan» app on their phone and scan one of the QR codes. That way we check everything works end to end before setting up rounds.',
+        trasCheckpointSinEscaneo: 'Next step: print the QR code and have your guard scan it with the «Patrol Tech Scan» app installed. That is the key thing now: checking the scan arrives before setting up rounds.',
+        trasCheckpointSinRutas: 'Next step: print the QR code and put it in place. Since scans are already working, you can create a route to control rounds on a schedule.',
+        trasCheckpointConRutas: 'Next step: print the QR code and put it in place. If you want it checked on the rounds, add it to a route.',
+        trasVigilante: 'Next step: forward them the message with their access so they install the app and scan one of the QR codes. Once they do, we check it together.',
+        trasVigilanteSinCheckpoints: 'Next step: create your first checkpoint so your guard has a QR code to scan.',
+        trasRuta: "Next step: have your guard do a test round scanning the route's QR codes; then I'll tell you how it went.",
+        botones: {
+            vigilante: 'Add a guard',
+            otroVigilante: 'Another guard',
+            checkpoint: 'Create a checkpoint',
+            otroCheckpoint: 'Another checkpoint',
+            ruta: 'Create a route',
+            anadirARuta: 'Add to a route',
+            probarEscaneo: 'Test a scan',
+            yaEscaneado: 'Guard has scanned',
+            rondas: 'Check the rounds',
+        },
+    },
+    fr: {
+        faltaCheckpoint: 'Prochaine étape : créer votre premier checkpoint ; je vous enverrai son QR code à imprimer.',
+        faltaVigilante: "Prochaine étape : ajouter votre agent pour qu'il puisse scanner les QR codes.",
+        faltaEscaneo: "Prochaine étape : que votre agent installe l'application «Patrol Tech Scan» sur son téléphone et scanne l'un des QR codes. Ainsi, nous vérifions que tout fonctionne de bout en bout avant de mettre en place les rondes.",
+        trasCheckpointSinEscaneo: "Prochaine étape : imprimez le QR code et demandez à votre agent de le scanner avec l'application «Patrol Tech Scan». C'est le plus important maintenant : vérifier que le scan arrive bien avant de mettre en place les rondes.",
+        trasCheckpointSinRutas: 'Prochaine étape : imprimez le QR code et placez-le à son emplacement. Comme les scans fonctionnent déjà, vous pouvez créer un parcours pour contrôler les rondes selon un horaire.',
+        trasCheckpointConRutas: "Prochaine étape : imprimez le QR code et placez-le à son emplacement. Si vous voulez qu'il soit contrôlé pendant les rondes, ajoutez-le à un parcours.",
+        trasVigilante: "Prochaine étape : transférez-lui le message avec son accès pour qu'il installe l'application et scanne l'un des QR codes. Une fois que c'est fait, nous le vérifions ensemble.",
+        trasVigilanteSinCheckpoints: 'Prochaine étape : créer votre premier checkpoint pour que votre agent ait un QR code à scanner.',
+        trasRuta: "Prochaine étape : que votre agent fasse une ronde de test en scannant les QR codes du parcours ; ensuite, je vous dirai comment cela s'est passé.",
+        botones: {
+            vigilante: 'Ajouter un agent',
+            otroVigilante: 'Un autre agent',
+            checkpoint: 'Créer un checkpoint',
+            otroCheckpoint: 'Un autre checkpoint',
+            ruta: 'Créer un parcours',
+            anadirARuta: 'Ajouter au parcours',
+            probarEscaneo: 'Tester un scan',
+            yaEscaneado: "L'agent a scanné",
+            rondas: 'Voir les rondes',
+        },
+    },
+};
+//# sourceMappingURL=texts.js.map

package/dist/actions/support/texts.js.map

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

package/dist/actions/support/turno.d.ts

@@ -0,0 +1,16 @@
+import type { ActionPrepareContext, CambioEnRuta, TurnoDePropuestas } from '../types.js';
+/** El turno de un lote: lecturas compartidas y los cambios ya aceptados en cada ruta. */
+export interface TurnoConRegistro extends TurnoDePropuestas {
+    /** Anota los cambios de una propuesta aceptada (en el orden de la lista). */
+    registrar(cambios: readonly CambioEnRuta[]): void;
+}
+/**
+ * Memo por turno, no una caché con TTL entre turnos. Techo por turno:
+ * un `listRoutes` por organización y un `getRouteDetails` por ruta, compartidos
+ * por todas las propuestas del lote (máx. 10). Una lectura que falla se olvida
+ * para que la siguiente propuesta lo reintente.
+ */
+export declare function nuevoTurno(): TurnoConRegistro;
+/** El turno de la propuesta, o el suelto si va sola. */
+export declare const turnoDe: (ctx: ActionPrepareContext) => TurnoDePropuestas;
+//# sourceMappingURL=turno.d.ts.map

package/dist/actions/support/turno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turno.d.ts","sourceRoot":"","sources":["../../../src/actions/support/turno.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEzF,yFAAyF;AACzF,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,6EAA6E;IAC7E,SAAS,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAmB7C;AAQD,wDAAwD;AACxD,eAAO,MAAM,OAAO,GAAI,KAAK,oBAAoB,KAAG,iBAA8C,CAAC"}

package/dist/actions/support/turno.js

@@ -0,0 +1,35 @@
+/**
+ * Memo por turno, no una caché con TTL entre turnos. Techo por turno:
+ * un `listRoutes` por organización y un `getRouteDetails` por ruta, compartidos
+ * por todas las propuestas del lote (máx. 10). Una lectura que falla se olvida
+ * para que la siguiente propuesta lo reintente.
+ */
+export function nuevoTurno() {
+    const lecturas = new Map();
+    const cambios = new Map();
+    return {
+        leer(clave, lectura) {
+            const hecha = lecturas.get(clave);
+            if (hecha)
+                return hecha;
+            const nueva = lectura();
+            lecturas.set(clave, nueva);
+            nueva.catch(() => lecturas.delete(clave));
+            return nueva;
+        },
+        cambiosEnRuta: (rutaId) => cambios.get(rutaId) ?? [],
+        registrar(nuevos) {
+            for (const { rutaId, op, checkpointId } of nuevos) {
+                cambios.set(rutaId, [...(cambios.get(rutaId) ?? []), { op, checkpointId }]);
+            }
+        },
+    };
+}
+/** El de una propuesta suelta (sin lote): lee siempre y no hay cambios previos. */
+const TURNO_SUELTO = {
+    leer: (_clave, lectura) => lectura(),
+    cambiosEnRuta: () => [],
+};
+/** El turno de la propuesta, o el suelto si va sola. */
+export const turnoDe = (ctx) => ctx.turno ?? TURNO_SUELTO;
+//# sourceMappingURL=turno.js.map

package/dist/actions/support/turno.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turno.js","sourceRoot":"","sources":["../../../src/actions/support/turno.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IACxD,OAAO;QACL,IAAI,CAAI,KAAa,EAAE,OAAyB;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,KAAK;gBAAE,OAAO,KAAmB,CAAC;YACtC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACpD,SAAS,CAAC,MAAM;YACd,KAAK,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,MAAM,EAAE,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,YAAY,GAAsB;IACtC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;IACpC,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE;CACxB,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAyB,EAAqB,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,YAAY,CAAC"}

package/dist/actions/support/user-access.d.ts

@@ -0,0 +1,72 @@
+import { type FixedTextLanguage } from '../../domain/language.js';
+import type { OrgUser, PatrolTechGateway } from '../../gateway/index.js';
+import { type ActionContext, type ActionPrepareContext } from '../types.js';
+/**
+ * Quién y qué acceso del panel tocan cambiar el rol y quitar el acceso, y sus dos
+ * protecciones (uno mismo, el último Admin de organización) al proponer y al confirmar.
+ */
+/** Un rol de la persona en la organización, con el nombre de su ubicación si es de una. */
+export interface Acceso {
+    id: string;
+    rol: string;
+    /** undefined = de toda la organización. */
+    ubicacion?: string;
+}
+export declare const esAdminDeOrganizacion: (r: {
+    rol: string;
+    ambito: string;
+    scopeId: string;
+}, orgId: string) => boolean;
+/** «Viewer (solo ver)» o el rol tal cual si el backend trae uno que no conocemos. */
+export declare const etiquetaRol: (rol: string | undefined, idioma: FixedTextLanguage) => string;
+/** La persona por email (exacto, sin mayúsculas) o por nombre, entre los usuarios de la organización. */
+export declare function elegirPersona(usuarios: readonly OrgUser[], dicho: string): {
+    item: OrgUser;
+} | {
+    error: string;
+};
+export declare const RELLENO_ORGANIZACION: Set<string>;
+export declare const ORGANIZACION: Set<string>;
+/** ¿Dice «el de toda la organización» y nada más? «Nave Global» o «Todas las naves» no. */
+export declare function diceOrganizacion(texto: string): boolean;
+/**
+ * Cuál de sus accesos: con uno solo y sin decirlo, ese. Si lo dice, se busca
+ * siempre (aunque tenga uno): «quítale el de Norte» a quien solo tiene el de
+ * organización no puede quitarle el de organización en silencio.
+ */
+export declare function elegirAcceso(nombre: string, accesos: readonly Acceso[], dicho: string | undefined, para: string): {
+    item: Acceso;
+} | {
+    error: string;
+};
+/** Lo que resuelven las dos acciones en `preparar`: persona, su acceso y la lista para las protecciones. */
+export declare function resolverAcceso(gateway: PatrolTechGateway, ctx: ActionPrepareContext, p: {
+    usuario: string;
+    acceso?: string;
+}, para: string): Promise<{
+    persona: OrgUser;
+    acceso: Acceso;
+    accesos: Acceso[];
+    usuarios: OrgUser[];
+} | {
+    error: string;
+}>;
+/** ¿Quitar este rol (o bajarlo de ADMIN) deja la organización sin ningún Admin de organización? */
+export declare function dejaSinAdmin(usuarios: readonly OrgUser[], orgId: string, rolId: string): boolean;
+/** Error al modelo de las dos protecciones en `preparar` (null = se puede). */
+export declare function proteccionAlPreparar(ctx: ActionPrepareContext, usuarios: readonly OrgUser[], persona: OrgUser, acceso: Acceso, quitaAdmin: boolean): string | null;
+/**
+ * Las mismas protecciones al confirmar, con la lista del momento. Si alguna ya no
+ * se cumple, lanza `AccionRechazada` con el texto al cliente (no se hace nada y
+ * queda `failed`); si no, devuelve el `rol_id` ya comprobado. Un rol que ya no está en la lista también se para aquí: el
+ * backend no da 404 sino 403 («Organization could not be resolved», porque saca
+ * la organización del propio rol) y se traduciría como «no tienes permiso».
+ */
+export declare function proteccionAlEjecutar(gateway: PatrolTechGateway, ctx: ActionContext, p: {
+    usuario: string;
+    usuario_id?: string;
+    rol_id?: string;
+}, quitaAdmin: boolean): Promise<string>;
+/** «al acceso de toda la organización» / «a la ubicación «X»», para el resumen del cambio de rol. */
+export declare function accesoA(idioma: FixedTextLanguage, ubicacion: string | undefined): string;
+//# sourceMappingURL=user-access.d.ts.map