@patroltech/agent-capabilities 0.0.0-stage → 0.2.1

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

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const scansParamSchema: {
+    periodo: z.ZodOptional<z.ZodEnum<{
+        hoy: "hoy";
+        ayer: "ayer";
+        ultimos_7_dias: "ultimos_7_dias";
+        ultimos_30_dias: "ultimos_30_dias";
+        todos: "todos";
+    }>>;
+    desde: z.ZodOptional<z.ZodString>;
+    hasta: z.ZodOptional<z.ZodString>;
+};
+export declare const scansFiltrosSchema: {
+    vigilante: z.ZodOptional<z.ZodString>;
+    checkpoint: z.ZodOptional<z.ZodString>;
+    ubicacion: z.ZodOptional<z.ZodString>;
+    solo_sospechosos: z.ZodOptional<z.ZodBoolean>;
+    solo_no_validos: z.ZodOptional<z.ZodBoolean>;
+    periodo: z.ZodOptional<z.ZodEnum<{
+        hoy: "hoy";
+        ayer: "ayer";
+        ultimos_7_dias: "ultimos_7_dias";
+        ultimos_30_dias: "ultimos_30_dias";
+        todos: "todos";
+    }>>;
+    desde: z.ZodOptional<z.ZodString>;
+    hasta: z.ZodOptional<z.ZodString>;
+};
+export declare const fechaSchema: (que: string) => z.ZodString;
+export declare const rutaParamSchema: {
+    ruta: z.ZodOptional<z.ZodString>;
+};
+export declare const accesosParamSchema: {
+    periodo: z.ZodOptional<z.ZodEnum<{
+        hoy: "hoy";
+        ayer: "ayer";
+        ultimos_7_dias: "ultimos_7_dias";
+        ultimos_30_dias: "ultimos_30_dias";
+    }>>;
+    desde: z.ZodOptional<z.ZodString>;
+    hasta: z.ZodOptional<z.ZodString>;
+    ubicacion: z.ZodOptional<z.ZodString>;
+    zona: z.ZodOptional<z.ZodString>;
+    tipo: z.ZodOptional<z.ZodEnum<{
+        entrada: "entrada";
+        salida: "salida";
+    }>>;
+    solo_dentro: z.ZodOptional<z.ZodBoolean>;
+};
+//# sourceMappingURL=params.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../src/reads/support/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,gBAAgB;;;;;;;;;;CAiB5B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAyB9B,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,gBACoC,CAAC;AAE5E,eAAO,MAAM,eAAe;;CAQ3B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAuB9B,CAAC"}

package/dist/reads/support/params.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/** Esquemas de parámetros que comparten varias capacidades (mismas descripciones que el bot). */
+// Regex, no solo la descripción: una fecha en palabras lanzaba y se llevaba el turno.
+const ymd = () => z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'Usa exactamente YYYY-MM-DD');
+export const scansParamSchema = {
+    periodo: z
+        .enum(['hoy', 'ayer', 'ultimos_7_dias', 'ultimos_30_dias', 'todos'])
+        .optional()
+        .describe('Periodo relativo a consultar. Úsalo cuando el usuario diga "hoy", "ayer", "última semana", "último mes" o similar.'),
+    desde: ymd()
+        .optional()
+        .describe('Fecha de inicio del rango, formato YYYY-MM-DD (nunca palabras como "ayer"). Úsalo si el usuario da una fecha concreta.'),
+    hasta: ymd()
+        .optional()
+        .describe('Fecha de fin del rango (inclusive), formato YYYY-MM-DD (nunca palabras como "hoy").'),
+};
+export const scansFiltrosSchema = {
+    ...scansParamSchema,
+    vigilante: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre del vigilante: solo sus escaneos. OMÍTELO si no se pide.'),
+    checkpoint: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre del checkpoint: solo sus escaneos. OMÍTELO si no se pide.'),
+    ubicacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre de la ubicación: solo sus escaneos. OMÍTELO si no se pide.'),
+    solo_sospechosos: z
+        .boolean()
+        .optional()
+        .describe('true: solo los escaneos marcados como sospechosos.'),
+    solo_no_validos: z
+        .boolean()
+        .optional()
+        .describe('true: solo los escaneos rechazados (no válidos).'),
+};
+export const fechaSchema = (que) => ymd().describe(`${que}, formato YYYY-MM-DD en el calendario del cliente`);
+export const rutaParamSchema = {
+    ruta: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre de la ruta. Opcional: OMÍTELO (no lo mandes vacío) si el usuario no lo ha indicado.'),
+};
+export const accesosParamSchema = {
+    periodo: z
+        .enum(['hoy', 'ayer', 'ultimos_7_dias', 'ultimos_30_dias'])
+        .optional()
+        .describe('Periodo a consultar. OMÍTELO (y desde/hasta) para las últimas 24 horas.'),
+    desde: scansParamSchema.desde,
+    hasta: scansParamSchema.hasta,
+    ubicacion: z.string().min(1).optional().describe('Nombre de la ubicación. OMÍTELO para todas.'),
+    zona: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Zona de acceso, escrita como en el panel. OMÍTELO para todas.'),
+    tipo: z
+        .enum(['entrada', 'salida'])
+        .optional()
+        .describe('Solo entradas o solo salidas. OMÍTELO para las dos.'),
+    solo_dentro: z
+        .boolean()
+        .optional()
+        .describe('true: solo quién está dentro ahora (entradas sin salida de las últimas 24 h; las más antiguas vienen aparte, como salidas sin registrar).'),
+};
+//# sourceMappingURL=params.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../src/reads/support/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iGAAiG;AAEjG,sFAAsF;AACtF,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,4BAA4B,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;SACnE,QAAQ,EAAE;SACV,QAAQ,CACP,oHAAoH,CACrH;IACH,KAAK,EAAE,GAAG,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wHAAwH,CACzH;IACH,KAAK,EAAE,GAAG,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,gBAAgB;IACnB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;IAChF,gBAAgB,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE,CACzC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,GAAG,mDAAmD,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;IACtF,KAAK,EAAE,gBAAgB,CAAC,KAAK;IAC7B,KAAK,EAAE,gBAAgB,CAAC,KAAK;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC/F,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;IAClE,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,2IAA2I,CAC5I;CACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+import { type ToolResult } from '../../domain/tool-result.js';
+import type { CheckpointRef, RouteRef } from '../../gateway/index.js';
+/** Cómo se nombra cada tipo de elemento en los fallos: [singular, plural]. */
+export declare const VIGILANTE: [string, string];
+export declare const CHECKPOINT: [string, string];
+export declare const UBICACION: [string, string];
+/** Dos checkpoints pueden llamarse igual en ubicaciones distintas: la opción lleva la ubicación. */
+export declare const etiquetaCheckpoint: (c: CheckpointRef) => string;
+/** Resuelve un nombre dicho por el usuario contra una lista, con el mismo contrato de ambigua / no encontrado. */
+export declare function resolveNamed<T>(valor: string, items: readonly T[], nameOf: (item: T) => string, [singular, plural]: [string, string], etiqueta?: (item: T) => string): {
+    item: T;
+} | ToolResult<never>;
+/** Sin nombre de ruta: la única activa (o la única) vale; con varias, se pregunta. */
+export declare function resolveRuta(ruta: string | undefined, rutas: RouteRef[]): {
+    item: RouteRef;
+} | ToolResult<never>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/reads/support/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGtE,8EAA8E;AAC9E,eAAO,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAA+B,CAAC;AACvE,eAAO,MAAM,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAiC,CAAC;AAC1E,eAAO,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAgC,CAAC;AAGxE,oGAAoG;AACpG,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,MAAyC,CAAC;AAEhG,kHAAkH;AAClH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC3B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,QAAQ,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAe,GACrC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAOjC;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,QAAQ,EAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAUxC"}

package/dist/reads/support/resolve.js

@@ -0,0 +1,33 @@
+import { resolveByName } from '../../domain/resolve-by-name.js';
+import { fail } from '../../domain/tool-result.js';
+import { failAmbigua, failNoEncontrado, MAX_OPCIONES } from './results.js';
+/** Cómo se nombra cada tipo de elemento en los fallos: [singular, plural]. */
+export const VIGILANTE = ['vigilante', 'vigilantes'];
+export const CHECKPOINT = ['checkpoint', 'checkpoints'];
+export const UBICACION = ['ubicación', 'ubicaciones'];
+const RUTA = ['ruta', 'rutas'];
+/** Dos checkpoints pueden llamarse igual en ubicaciones distintas: la opción lleva la ubicación. */
+export const etiquetaCheckpoint = (c) => `${c.name} (${c.locationName})`;
+/** Resuelve un nombre dicho por el usuario contra una lista, con el mismo contrato de ambigua / no encontrado. */
+export function resolveNamed(valor, items, nameOf, [singular, plural], etiqueta = nameOf) {
+    const match = resolveByName(valor, items, nameOf);
+    if (match.kind === 'found')
+        return { item: match.item };
+    if (match.kind === 'ambiguous') {
+        return failAmbigua(valor, plural, match.matches.slice(0, MAX_OPCIONES).map(etiqueta));
+    }
+    return failNoEncontrado(singular, items.slice(0, MAX_OPCIONES).map(etiqueta));
+}
+/** Sin nombre de ruta: la única activa (o la única) vale; con varias, se pregunta. */
+export function resolveRuta(ruta, rutas) {
+    if (rutas.length === 0)
+        return fail('La organización no tiene ninguna ruta creada.');
+    if (ruta)
+        return resolveNamed(ruta, rutas, (r) => r.name, RUTA);
+    const activas = rutas.filter((r) => r.isActive);
+    const candidatas = activas.length > 0 ? activas : rutas;
+    if (candidatas.length === 1)
+        return { item: candidatas[0] };
+    return fail('ruta no indicada: hay varias, pregunta al usuario cuál de estas quiere', candidatas.map((r) => r.name));
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/reads/support/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,IAAI,EAAmB,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE3E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAqB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACxE,MAAM,IAAI,GAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,oGAAoG;AACpG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAgB,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,YAAY,GAAG,CAAC;AAEhG,kHAAkH;AAClH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,KAAmB,EACnB,MAA2B,EAC3B,CAAC,QAAQ,EAAE,MAAM,CAAmB,EACpC,WAAgC,MAAM;IAEtC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CACzB,IAAwB,EACxB,KAAiB;IAEjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,+CAA+C,CAAC,CAAC;IACrF,IAAI,IAAI;QAAE,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACxD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,IAAI,CACT,wEAAwE,EACxE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+import { type ToolResult } from '../../domain/tool-result.js';
+import type { ListaTruncable } from '../../gateway/index.js';
+/** Coletilla de las descripciones de las capacidades que devuelven listas capadas. */
+export declare const TRUNCADO_HINT = " Si el resultado trae `truncado: true`, los datos est\u00E1n CAPADOS: no afirmes totales ni ausencias (\"no se ha escaneado nunca\", \"solo hay N\"); dilo y acota el periodo.";
+/** Opciones como mucho en una pregunta de desambiguación. */
+export declare const MAX_OPCIONES = 15;
+/** ¿Es un fallo ya listo para devolver (y no el valor resuelto)? */
+export declare function isFail<T extends object>(x: T | ToolResult<never>): x is ToolResult<never>;
+/**
+ * Mismo contrato para TODA ambigüedad (organización, vigilante, ruta): el modelo
+ * no tiene que aprenderse un `found:false`/`ambigua` distinto por capacidad.
+ */
+export declare function failAmbigua(valor: string, queSon: string, opciones: string[]): ToolResult<never>;
+/** Lo mismo cuando no hay ninguna coincidencia. */
+export declare function failNoEncontrado(queSon: string, opciones?: string[]): ToolResult<never>;
+/** Texto del aviso de truncado, compartido por las listas y por el ranking. */
+export declare function avisoTruncado(devueltos: number, total: number | undefined, queSon: string): string;
+/** Envuelve una lista posiblemente capada, avisando al modelo de que hay más datos. */
+export declare function okLista<T>(lista: ListaTruncable<T>, queSon: string, avisosExtra?: string[]): ToolResult<T[]>;
+/** Aviso cuando alguna ubicación no se pudo leer: sus checkpoints faltan de la lista. */
+export declare function avisosUbicaciones(ubicacionesConError: number): string[];
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/reads/support/results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,sFAAsF;AACtF,eAAO,MAAM,aAAa,mLAC+I,CAAC;AAE1K,6DAA6D;AAC7D,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAEzF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAKhG;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAEvF;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GACb,MAAM,CAGR;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,CAAC,EACvB,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAM,EAAO,GACzB,UAAU,CAAC,CAAC,EAAE,CAAC,CAIjB;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvE"}

package/dist/reads/support/results.js

@@ -0,0 +1,41 @@
+import { fail, ok } from '../../domain/tool-result.js';
+/** Coletilla de las descripciones de las capacidades que devuelven listas capadas. */
+export const TRUNCADO_HINT = ' Si el resultado trae `truncado: true`, los datos están CAPADOS: no afirmes totales ni ausencias ("no se ha escaneado nunca", "solo hay N"); dilo y acota el periodo.';
+/** Opciones como mucho en una pregunta de desambiguación. */
+export const MAX_OPCIONES = 15;
+/** ¿Es un fallo ya listo para devolver (y no el valor resuelto)? */
+export function isFail(x) {
+    return 'ok' in x;
+}
+/**
+ * Mismo contrato para TODA ambigüedad (organización, vigilante, ruta): el modelo
+ * no tiene que aprenderse un `found:false`/`ambigua` distinto por capacidad.
+ */
+export function failAmbigua(valor, queSon, opciones) {
+    return fail(`ambigua: «${valor}» coincide con varios/as ${queSon}; pregunta al usuario cuál de estas quiere`, opciones);
+}
+/** Lo mismo cuando no hay ninguna coincidencia. */
+export function failNoEncontrado(queSon, opciones) {
+    return fail(`no encontrado: no hay ningún/a ${queSon} con ese nombre`, opciones);
+}
+/** Texto del aviso de truncado, compartido por las listas y por el ranking. */
+export function avisoTruncado(devueltos, total, queSon) {
+    const deTotal = typeof total === 'number' ? ` de ${total}` : '';
+    return `Resultado TRUNCADO: se devuelven ${devueltos}${deTotal} ${queSon}. No afirmes totales ni ausencias; acota el periodo o el filtro.`;
+}
+/** Envuelve una lista posiblemente capada, avisando al modelo de que hay más datos. */
+export function okLista(lista, queSon, avisosExtra = []) {
+    const avisos = [...avisosExtra];
+    if (lista.truncado)
+        avisos.push(avisoTruncado(lista.items.length, lista.total, queSon));
+    return ok(lista.items, { truncado: lista.truncado, avisos });
+}
+/** Aviso cuando alguna ubicación no se pudo leer: sus checkpoints faltan de la lista. */
+export function avisosUbicaciones(ubicacionesConError) {
+    return ubicacionesConError > 0
+        ? [
+            `${ubicacionesConError} ubicación(es) no se pudieron consultar: faltan sus checkpoints. NO afirmes que un checkpoint no existe o no se ha escaneado.`,
+        ]
+        : [];
+}
+//# sourceMappingURL=results.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/reads/support/results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAmB,MAAM,6BAA6B,CAAC;AAGxE,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GACxB,uKAAuK,CAAC;AAE1K,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,oEAAoE;AACpE,MAAM,UAAU,MAAM,CAAmB,CAAwB;IAC/D,OAAO,IAAI,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,QAAkB;IAC3E,OAAO,IAAI,CACT,aAAa,KAAK,4BAA4B,MAAM,4CAA4C,EAChG,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,QAAmB;IAClE,OAAO,IAAI,CAAC,kCAAkC,MAAM,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,KAAyB,EACzB,MAAc;IAEd,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,oCAAoC,SAAS,GAAG,OAAO,IAAI,MAAM,kEAAkE,CAAC;AAC7I,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,OAAO,CACrB,KAAwB,EACxB,MAAc,EACd,cAAwB,EAAE;IAE1B,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACxF,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,mBAA2B;IAC3D,OAAO,mBAAmB,GAAG,CAAC;QAC5B,CAAC,CAAC;YACE,GAAG,mBAAmB,+HAA+H;SACtJ;QACH,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type FixedTextLanguage } from '../../domain/language.js';
+/** Cómo se llama cada rol en el panel (lecturas: lo que ve el modelo, en español). */
+export declare const ROL_LABEL: Readonly<Partial<Record<string, string>>>;
+/**
+ * Cómo se nombra cada rol en las confirmaciones y resultados de las acciones,
+ * en el idioma del cliente. Textos distintos de `ROL_LABEL` a propósito (son
+ * los que ya ve el cliente en las propuestas del bot): no se unifican sin
+ * decidirlo antes.
+ */
+export declare const ROL_LABEL_ACCION: Record<'VIEWER' | 'EDITOR' | 'ADMIN', Record<FixedTextLanguage, string>>;
+/** «de toda la organización» / «de la ubicación «X»». */
+export declare function ambito(idioma: FixedTextLanguage, ubicacion: string | undefined): string;
+//# sourceMappingURL=roles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/reads/support/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,sFAAsF;AACtF,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAI/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,QAAQ,GAAG,QAAQ,GAAG,OAAO,EAC7B,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAKlC,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMvF"}

package/dist/reads/support/roles.js

@@ -0,0 +1,27 @@
+import { segunIdioma } from '../../domain/language.js';
+/** Cómo se llama cada rol en el panel (lecturas: lo que ve el modelo, en español). */
+export const ROL_LABEL = {
+    ADMIN: 'Admin',
+    EDITOR: 'Editor',
+    VIEWER: 'Observador (Viewer)',
+};
+/**
+ * Cómo se nombra cada rol en las confirmaciones y resultados de las acciones,
+ * en el idioma del cliente. Textos distintos de `ROL_LABEL` a propósito (son
+ * los que ya ve el cliente en las propuestas del bot): no se unifican sin
+ * decidirlo antes.
+ */
+export const ROL_LABEL_ACCION = {
+    VIEWER: { es: 'Viewer (solo ver)', en: 'Viewer (view only)', fr: 'Viewer (lecture seule)' },
+    EDITOR: { es: 'Editor', en: 'Editor', fr: 'Editor' },
+    ADMIN: { es: 'Admin', en: 'Admin', fr: 'Admin' },
+};
+/** «de toda la organización» / «de la ubicación «X»». */
+export function ambito(idioma, ubicacion) {
+    return segunIdioma(idioma, {
+        es: ubicacion ? `de la ubicación «${ubicacion}»` : 'de toda la organización',
+        en: ubicacion ? `of the location «${ubicacion}»` : 'of the whole organization',
+        fr: ubicacion ? `du site «${ubicacion}»` : "de toute l'organisation",
+    });
+}
+//# sourceMappingURL=roles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../src/reads/support/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,0BAA0B,CAAC;AAE/E,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAA8C;IAClE,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,qBAAqB;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGzB;IACF,MAAM,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,wBAAwB,EAAE;IAC3F,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE;IACpD,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE;CACjD,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAC,MAAyB,EAAE,SAA6B;IAC7E,OAAO,WAAW,CAAC,MAAM,EAAE;QACzB,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,oBAAoB,SAAS,GAAG,CAAC,CAAC,CAAC,yBAAyB;QAC5E,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,oBAAoB,SAAS,GAAG,CAAC,CAAC,CAAC,2BAA2B;QAC9E,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,YAAY,SAAS,GAAG,CAAC,CAAC,CAAC,yBAAyB;KACrE,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { ToolResult } from '../../domain/tool-result.js';
+import type { PatrolTechGateway, RecentScan, ScanQuery } from '../../gateway/index.js';
+export declare const TAM_PAGINA = 100;
+export declare const MAX_FILAS = 2000;
+export declare const DIA_MS = 86400000;
+/**
+ * Los escaneos que casan con `query`, de 100 en 100 y del más reciente al más
+ * antiguo, hasta `maxFilas` o hasta que `seguir` (tras cada página) diga que ya
+ * basta. `hayMas`: quedaron escaneos sin leer.
+ */
+export declare function paginarEscaneos(gateway: PatrolTechGateway, orgId: string, token: string, query: ScanQuery, { maxFilas, seguir, }?: {
+    maxFilas?: number;
+    seguir?: (pagina: RecentScan[]) => boolean;
+}): Promise<{
+    escaneos: RecentScan[];
+    hayMas: boolean;
+}>;
+/** Filtros de escaneos tal como los dice el usuario (por nombre). */
+export interface FiltrosEscaneos {
+    vigilante?: string;
+    checkpoint?: string;
+    ubicacion?: string;
+    solo_sospechosos?: boolean;
+    solo_no_validos?: boolean;
+}
+/**
+ * Filtros de escaneos dichos por su nombre → ids del backend (que no filtra por
+ * nombre). Lo comparten consultar_ultimos_scans y enviar_excel_escaneos.
+ */
+export declare function resolverFiltrosEscaneos(gateway: PatrolTechGateway, orgId: string, token: string, args: FiltrosEscaneos): Promise<ScanQuery | ToolResult<never>>;
+//# sourceMappingURL=scans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scans.d.ts","sourceRoot":"","sources":["../../../src/reads/support/scans.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKvF,eAAO,MAAM,UAAU,MAAM,CAAC;AAI9B,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,MAAM,WAAa,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,EACE,QAAoB,EACpB,MAAmB,GACpB,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,CAAA;CAAO,GACxE,OAAO,CAAC;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CActD;AAED,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAiCxC"}

package/dist/reads/support/scans.js

@@ -0,0 +1,66 @@
+import { isFail } from './results.js';
+import { CHECKPOINT, etiquetaCheckpoint, resolveNamed, UBICACION, VIGILANTE } from './resolve.js';
+// El backend da como mucho 100 filas por página (escaneos y registros de acceso).
+export const TAM_PAGINA = 100;
+// Tope de 2.000 filas (20 páginas) para no colgar al consumidor ni mandar
+// ficheros enormes por el chat; más allá, que acote el periodo o los filtros, o
+// exporte desde el panel.
+export const MAX_FILAS = 2000;
+export const DIA_MS = 86_400_000;
+/**
+ * Los escaneos que casan con `query`, de 100 en 100 y del más reciente al más
+ * antiguo, hasta `maxFilas` o hasta que `seguir` (tras cada página) diga que ya
+ * basta. `hayMas`: quedaron escaneos sin leer.
+ */
+export async function paginarEscaneos(gateway, orgId, token, query, { maxFilas = MAX_FILAS, seguir = () => true, } = {}) {
+    const escaneos = [];
+    let hayMas = true;
+    for (let page = 1; hayMas && escaneos.length < maxFilas; page++) {
+        const { items, total } = await gateway.getRecentScans(orgId, token, {
+            ...query,
+            limit: TAM_PAGINA,
+            page,
+        });
+        escaneos.push(...items);
+        hayMas = items.length === TAM_PAGINA && (total === undefined || escaneos.length < total);
+        if (!seguir(items))
+            break;
+    }
+    return { escaneos, hayMas };
+}
+/**
+ * Filtros de escaneos dichos por su nombre → ids del backend (que no filtra por
+ * nombre). Lo comparten consultar_ultimos_scans y enviar_excel_escaneos.
+ */
+export async function resolverFiltrosEscaneos(gateway, orgId, token, args) {
+    const filtros = {
+        soloSospechosos: args.solo_sospechosos,
+        soloNoValidos: args.solo_no_validos,
+    };
+    if (args.vigilante) {
+        const vigilantes = await gateway.listPatrollers(orgId, token);
+        const r = resolveNamed(args.vigilante, vigilantes.items, (p) => p.name, VIGILANTE);
+        if (isFail(r))
+            return r;
+        filtros.patrollerId = r.item.id;
+    }
+    if (args.ubicacion) {
+        const ubicaciones = await gateway.listLocations(orgId, token);
+        const r = resolveNamed(args.ubicacion, ubicaciones, (l) => l.name, UBICACION);
+        if (isFail(r))
+            return r;
+        filtros.locationId = r.item.id;
+    }
+    if (args.checkpoint) {
+        const { items } = await gateway.listCheckpoints(orgId, token);
+        const candidatos = filtros.locationId
+            ? items.filter((c) => c.locationId === filtros.locationId)
+            : items;
+        const r = resolveNamed(args.checkpoint, candidatos, (c) => c.name, CHECKPOINT, etiquetaCheckpoint);
+        if (isFail(r))
+            return r;
+        filtros.checkpointId = r.item.id;
+    }
+    return filtros;
+}
+//# sourceMappingURL=scans.js.map

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

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

package/dist/reads/types.d.ts

@@ -0,0 +1,48 @@
+import type { z } from 'zod';
+import type { SessionContext } from '../context.js';
+import type { ToolResult } from '../domain/tool-result.js';
+import type { FileSink } from '../ports/FileSink.js';
+import type { CapabilityDeps, CapabilityEnv } from '../deps.js';
+/**
+ * El contexto de una lectura: el de la sesión (`SessionContext`) y, si el canal
+ * puede entregarlos, dónde dejar los ficheros. La organización la resuelve el
+ * consumidor con `resolveOrganization`, solo entre `organizations`; el
+ * envoltorio de `readCapabilities` comprueba que sea una de ellas y usa SU
+ * entrada (rol y ámbito de la sesión).
+ */
+export interface CapabilityContext extends SessionContext {
+    /**
+     * Dónde dejar el QR y los Excel de ESTA llamada (la conversación o la sesión
+     * del usuario). Va en el contexto y no en las dependencias: un `FileSink`
+     * compartido entre usuarios mandaría los ficheros de uno a otro.
+     */
+    files?: FileSink;
+}
+/**
+ * Una capacidad de lectura. `params` son sus parámetros PROPIOS: el de la
+ * organización no aparece nunca aquí (lo añade el consumidor solo si el usuario
+ * tiene más de una y lo resuelve con `resolveOrganization`).
+ */
+export interface ReadCapability<P extends z.ZodRawShape = z.ZodRawShape> {
+    /** Nombre de la herramienta (el del bot, p. ej. `consultar_estado_rondas`). */
+    name: string;
+    description: string;
+    params: P;
+    call(ctx: CapabilityContext, args: z.infer<z.ZodObject<P>>): Promise<ToolResult<unknown>>;
+}
+/** Declara una capacidad conservando la inferencia de `params` en `call`. */
+export declare function defineRead<P extends z.ZodRawShape>(read: ReadCapability<P>): ReadCapability;
+/** Dependencias de `readCapabilities`: las comunes y si el canal entrega ficheros. */
+export interface ReadDeps extends CapabilityDeps {
+    /**
+     * true = el canal puede entregar ficheros: existen `enviar_qr_checkpoint` y
+     * los dos `enviar_excel_*`, que los dejan en `ctx.files` de cada llamada. Por
+     * defecto, false (no se ofrecen).
+     */
+    offerFiles?: boolean;
+}
+/** Las dependencias ya con sus valores por defecto, tal como las reciben las áreas. */
+export interface ReadEnv extends CapabilityEnv {
+    offerFiles: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reads/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACrE,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3F;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAE3F;AAED,sFAAsF;AACtF,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,uFAAuF;AACvF,MAAM,WAAW,OAAQ,SAAQ,aAAa;IAC5C,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/reads/types.js

@@ -0,0 +1,5 @@
+/** Declara una capacidad conservando la inferencia de `params` en `call`. */
+export function defineRead(read) {
+    return read;
+}
+//# sourceMappingURL=types.js.map

package/dist/reads/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reads/types.ts"],"names":[],"mappings":"AAmCA,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAA0B,IAAuB;IACzE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/reads/users.d.ts

@@ -0,0 +1,4 @@
+import { type ReadCapability, type ReadEnv } from './types.js';
+/** Usuarios del panel con su rol y ámbito. */
+export declare function userReads({ gateway, upsell }: ReadEnv): ReadCapability[];
+//# sourceMappingURL=users.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/reads/users.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAuB3E,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,GAAG,cAAc,EAAE,CAqCxE"}

package/dist/reads/users.js

@@ -0,0 +1,57 @@
+import { PatrolTechApiError } from '../domain/backend-errors.js';
+import { fail, ok } from '../domain/tool-result.js';
+import { ROL_LABEL } from './support/roles.js';
+import { defineRead } from './types.js';
+const usuariosRolesDesc = 'Lista los usuarios del panel de la organización (gestores y observadores) con su rol (Admin, Editor u Observador) y su ámbito (toda la organización o una ubicación), y explica qué puede cambiar cada rol. Úsala para «¿quién puede cambiar rutas, checkpoints o vigilantes?», «¿qué usuarios tenemos?». Solo la puede consultar un Admin de la organización: si falla por permisos, explícalo.';
+const AMBITO_DE_LOS_ROLES = 'Un rol de organización vale para todas las ubicaciones; uno de ubicación, solo para esa (con los dos, vale el más alto). Con rol solo de ubicación no se pueden ver ni exportar los escaneos, ver o crear patrulleros, crear rutas, gestionar chips NFC ni generar el certificado.';
+/**
+ * Qué puede hacer cada rol (Admin, Editor, Viewer) y con qué ámbito.
+ * Sin upsell (MCP) se omite lo de Licencia, facturas y pagos.
+ */
+function queHaceCadaRol(upsell) {
+    return {
+        observador: upsell
+            ? 'Solo consulta: no crea ni edita nada, no imprime QR y no ve Licencia.'
+            : 'Solo consulta: no crea ni edita nada y no imprime QR.',
+        editor: `Además de consultar, crea y edita checkpoints, rutas, patrulleros (vigilantes), personas autorizadas e incidencias (en el panel)${upsell ? '; ve Licencia y facturas, pero no cambia el plan.' : '.'}`,
+        admin: `Además de lo del Editor, en el panel: usuarios y roles, ubicaciones, datos de empresa, privacidad del vigilante, Apps, zonas de acceso, categorías y plantillas de incidencias${upsell ? ', y pagos.' : '.'}`,
+        ambito: AMBITO_DE_LOS_ROLES,
+    };
+}
+/** Usuarios del panel con su rol y ámbito. */
+export function userReads({ gateway, upsell }) {
+    return [
+        defineRead({
+            name: 'consultar_usuarios_y_roles',
+            description: usuariosRolesDesc,
+            params: {},
+            call: async ({ org, token }) => {
+                let usuarios;
+                try {
+                    usuarios = await gateway.listOrgUsers(org.orgId, token);
+                }
+                catch (err) {
+                    if (err instanceof PatrolTechApiError && err.status === 403) {
+                        return fail('Solo un Admin de la organización puede ver sus usuarios y roles (en el panel, Usuarios). Con el rol de este usuario no se pueden consultar: que se lo pregunte a un Admin de su cuenta.');
+                    }
+                    throw err;
+                }
+                const ubicaciones = new Map((await gateway.listLocations(org.orgId, token)).map((l) => [l.id, l.name]));
+                return ok({
+                    usuarios: usuarios.map((u) => ({
+                        nombre: u.nombre,
+                        email: u.email,
+                        roles: u.roles.map((r) => {
+                            const rol = ROL_LABEL[r.rol] ?? r.rol;
+                            return r.ambito === 'LOCATION'
+                                ? `${rol} de la ubicación «${ubicaciones.get(r.scopeId) ?? r.scopeId}»`
+                                : `${rol} de toda la organización`;
+                        }),
+                    })),
+                    queHaceCadaRol: queHaceCadaRol(upsell),
+                });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=users.js.map

package/dist/reads/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/reads/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAqC,MAAM,YAAY,CAAC;AAE3E,MAAM,iBAAiB,GACrB,kYAAkY,CAAC;AAErY,MAAM,mBAAmB,GACvB,oRAAoR,CAAC;AAEvR;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAe;IACrC,OAAO;QACL,UAAU,EAAE,MAAM;YAChB,CAAC,CAAC,uEAAuE;YACzE,CAAC,CAAC,uDAAuD;QAC3D,MAAM,EAAE,mIAAmI,MAAM,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,GAAG,EAAE;QAC/M,KAAK,EAAE,iLAAiL,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE;QACrN,MAAM,EAAE,mBAAmB;KAC5B,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAW;IACpD,OAAO;QACL,UAAU,CAAC;YACT,IAAI,EAAE,4BAA4B;YAClC,WAAW,EAAE,iBAAiB;YAC9B,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,IAAI,QAAmB,CAAC;gBACxB,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC1D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,kBAAkB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBAC5D,OAAO,IAAI,CACT,yLAAyL,CAC1L,CAAC;oBACJ,CAAC;oBACD,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAC3E,CAAC;gBACF,OAAO,EAAE,CAAC;oBACR,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BACvB,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;4BACtC,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU;gCAC5B,CAAC,CAAC,GAAG,GAAG,qBAAqB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG;gCACvE,CAAC,CAAC,GAAG,GAAG,0BAA0B,CAAC;wBACvC,CAAC,CAAC;qBACH,CAAC,CAAC;oBACH,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}