@patroltech/agent-capabilities 0.0.0-stage → 0.2.1

package/dist/gateway/types/rounds.d.ts

@@ -0,0 +1,89 @@
+export interface RoundsStatus {
+    /** Días hacia atrás que cubren los totales (los del resumen de soporte). */
+    windowDays: number;
+    open: number;
+    completed: number;
+    incomplete: number;
+}
+export interface SupportSummary {
+    rounds: {
+        windowDays: number;
+        inProgress: number;
+        completed: number;
+        incomplete: number;
+        expired: number;
+    };
+    patrollers: {
+        total: number;
+        active: number;
+        inactive: number;
+        alert: number;
+    };
+    checkpoints: {
+        total: number;
+    };
+    suspiciousScans: {
+        windowDays: number;
+        flagged: number;
+    };
+}
+export interface RoundRef {
+    id: string;
+    status: string;
+    patrollerName: string | null;
+    completedCheckpoints: number;
+    totalCheckpoints: number;
+    startTime: string;
+    endTime: string | null;
+}
+export interface RoundDetail {
+    status: string;
+    scannedCount: number;
+    totalCount: number;
+    checkpoints: RoundCheckpointDetail[];
+}
+export interface RouteRoundsSummary {
+    routeName: string;
+    isActive: boolean;
+    /** Presente si las rondas de ESTA ruta no se pudieron leer: `rounds: []` no significa "no tiene rondas". */
+    error?: string;
+    rounds: {
+        status: string;
+        patrollerName: string | null;
+        completedCheckpoints: number;
+        totalCheckpoints: number;
+        startTime: string;
+        endTime: string | null;
+    }[];
+}
+export interface RoundCheckpointDetail {
+    /** null si el backend no da el nombre (así lo declara el OpenAPI). */
+    checkpointName: string | null;
+    order: number;
+    scanned: boolean;
+    scanTime: string | null;
+}
+export type RoundCheckpointsResult = {
+    found: true;
+    routeName: string;
+    status: string;
+    scannedCount: number;
+    totalCount: number;
+    checkpoints: RoundCheckpointDetail[];
+} | {
+    found: false;
+    reason: 'route_not_found';
+    opciones: string[];
+} | {
+    found: false;
+    reason: 'route_ambiguous';
+    opciones: string[];
+} | {
+    found: false;
+    reason: 'route_not_specified';
+    opciones: string[];
+} | {
+    found: false;
+    reason: 'no_rounds';
+};
+//# sourceMappingURL=rounds.d.ts.map

package/dist/gateway/types/rounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/rounds.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,eAAe,EAAE;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,EAAE,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC,GACD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAE/D;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAE/D;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACnE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC"}

package/dist/gateway/types/rounds.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rounds.js.map

package/dist/gateway/types/rounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.js","sourceRoot":"","sources":["../../../src/gateway/types/rounds.ts"],"names":[],"mappings":""}

package/dist/gateway/types/routes.d.ts

@@ -0,0 +1,48 @@
+export interface RouteRef {
+    id: string;
+    name: string;
+    isActive: boolean;
+    /** Ubicación de la ruta; ausente o null si no se conoce. */
+    locationId?: string | null;
+}
+/** Horario de una ruta tal como lo guarda el backend: horas `HH:MM` y días ISO (1=lun..7=dom), en UTC. */
+export interface RouteTimeWindow {
+    id: string;
+    startTime: string;
+    endTime: string;
+    days: number[];
+}
+/** `GET /api/routes/:id/details`: la ruta con sus checkpoints (en orden) y sus horarios. */
+export interface RouteDetails {
+    id: string;
+    name: string;
+    isActive: boolean;
+    locationId: string;
+    checkpoints: {
+        checkpointId: string;
+        order: number;
+    }[];
+    timeWindows: RouteTimeWindow[];
+}
+/** Horario a enviar al backend: horas UTC y la zona en la que se configuró (para que lo reproyecte al cambiar la hora). */
+export interface NewTimeWindow {
+    startTime: string;
+    endTime: string;
+    days: number[];
+    timezone: string;
+}
+/** `POST /api/routes/complete`. El `id` lo pone el bot: así un alta dudosa se comprueba por él. */
+export interface NewRoute {
+    id: string;
+    name: string;
+    organizationId: string;
+    locationId: string;
+    requiresOrderedScan: boolean;
+    checkpoints: {
+        checkpointId: string;
+        order: number;
+    }[];
+    timeWindows: NewTimeWindow[];
+    scheduleTimezone: string;
+}
+//# sourceMappingURL=routes.d.ts.map

package/dist/gateway/types/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/routes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,0GAA0G;AAC1G,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,2HAA2H;AAC3H,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/gateway/types/routes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routes.js.map

package/dist/gateway/types/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/gateway/types/routes.ts"],"names":[],"mappings":""}

package/dist/gateway/types/scans.d.ts

@@ -0,0 +1,44 @@
+/** Móvil con el que se hizo un escaneo, tal como lo informa la app. Sin los campos que no vienen. */
+export interface ScanDevice {
+    modelo?: string;
+    sistema?: string;
+    /** Porcentaje 0-100 (el backend ya lo multiplica por 100). */
+    bateriaPct?: number;
+    cargando?: boolean;
+    conexion?: string;
+}
+export interface RecentScan {
+    timestamp: string;
+    checkpointName: string | null;
+    patrollerName: string | null;
+    fraudFlagged: boolean;
+    /** Estado de validación en lenguaje de cliente, con su motivo real (ver domain/scan-explanation). */
+    validacion: string;
+    /** Motivos reales de la sospecha; vacío si no es sospechoso. */
+    motivosSospecha: string[];
+    dispositivo?: ScanDevice;
+    /** Distancia del móvil al punto según la regla de proximidad GPS, si se evaluó. */
+    distanciaGpsM?: number;
+    /** Precisión del GPS del móvil en ese escaneo, si se evaluó la proximidad. */
+    precisionGpsM?: number;
+}
+/**
+ * Filtros de `GET /api/scans`. `patrollerId`/`checkpointId`/`locationId` son
+ * ids ya resueltos (el backend no filtra por nombre).
+ */
+export interface ScanQuery {
+    /** Máximo 100 (el backend rechaza más). */
+    limit?: number;
+    /** Página 1-based de `limit` escaneos. */
+    page?: number;
+    dateFrom?: string;
+    dateTo?: string;
+    patrollerId?: string;
+    checkpointId?: string;
+    locationId?: string;
+    /** `fraudStatus=flagged`. */
+    soloSospechosos?: boolean;
+    /** `validationStatus=rejected` (lo que el panel marca como no válido). */
+    soloNoValidos?: boolean;
+}
+//# sourceMappingURL=scans.d.ts.map

package/dist/gateway/types/scans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scans.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/scans.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,qGAAqG;IACrG,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/gateway/types/scans.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scans.js.map

package/dist/gateway/types/scans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scans.js","sourceRoot":"","sources":["../../../src/gateway/types/scans.ts"],"names":[],"mappings":""}

package/dist/gateway/types/users.d.ts

@@ -0,0 +1,32 @@
+/** Usuario del panel con sus roles en la organización (`ambito` LOCATION → `scopeId` es la ubicación). */
+export interface OrgUser {
+    id: string;
+    nombre: string;
+    email: string;
+    /** `id` = el `userRoleId` que piden cambiar el rol y quitar el acceso. */
+    roles: {
+        id: string;
+        rol: string;
+        ambito: string;
+        scopeId: string;
+    }[];
+}
+/**
+ * Invitación al panel. Sin `id` a propósito: el backend lo usaría para crear el
+ * usuario. `locationId` solo con `roleScope` LOCATION, y siempre de las
+ * ubicaciones de la organización (el backend no lo comprueba).
+ */
+export interface NewOrgUser {
+    organizationId: string;
+    name: string;
+    email: string;
+    roleType: 'VIEWER' | 'EDITOR' | 'ADMIN';
+    roleScope: 'ORGANIZATION' | 'LOCATION';
+    locationId?: string;
+}
+/** `cuentaNueva` false = el email ya tenía cuenta y solo se le añade el rol; `emailEnviado` false = falló el correo de bienvenida. */
+export interface InviteResult {
+    cuentaNueva: boolean;
+    emailEnviado: boolean;
+}
+//# sourceMappingURL=users.d.ts.map

package/dist/gateway/types/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/gateway/types/users.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,SAAS,EAAE,cAAc,GAAG,UAAU,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sIAAsI;AACtI,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/dist/gateway/types/users.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=users.js.map

package/dist/gateway/types/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../../src/gateway/types/users.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export * from './context.js';
+export * from './deps.js';
+export * from './domain/urls.js';
+export * from './ports/Logger.js';
+export * from './ports/FileSink.js';
+export * from './ports/PendingActionStore.js';
+export * from './gateway/index.js';
+export * from './domain/language.js';
+export * from './domain/incident-status.js';
+export * from './domain/resolve-by-name.js';
+export * from './domain/scan-explanation.js';
+export * from './domain/route-schedule.js';
+export * from './domain/route-checkpoints.js';
+export * from './domain/geo.js';
+export * from './domain/backend-errors.js';
+export * from './domain/qr-image.js';
+export * from './domain/guard-app-message.js';
+export * from './domain/date-range.js';
+export * from './domain/timezone.js';
+export * from './domain/scans-csv.js';
+export * from './domain/access-logs-csv.js';
+export * from './domain/tool-result.js';
+export * from './domain/puesta-en-marcha.js';
+export * from './domain/country.js';
+export * from './domain/money.js';
+export * from './reads/index.js';
+export * from './actions/index.js';
+export * from './catalog/types.js';
+export * from './catalog/entries.js';
+export * from './catalog/buildCatalog.js';
+export * from './catalog/english.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAG7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,40 @@
+// Contexto de sesión común a lecturas y acciones (organización canónica y anti-fuga)
+export * from './context.js';
+// Dependencias comunes del catálogo (gateway, logger, enlaces)
+export * from './deps.js';
+export * from './domain/urls.js';
+// Puertos (los implementa cada consumidor)
+export * from './ports/Logger.js';
+export * from './ports/FileSink.js';
+export * from './ports/PendingActionStore.js';
+// Puerto de la API de PatrolTech y sus tipos (el fake va en ./testing)
+export * from './gateway/index.js';
+// Dominio puro
+export * from './domain/language.js';
+export * from './domain/incident-status.js';
+export * from './domain/resolve-by-name.js';
+export * from './domain/scan-explanation.js';
+export * from './domain/route-schedule.js';
+export * from './domain/route-checkpoints.js';
+export * from './domain/geo.js';
+export * from './domain/backend-errors.js';
+export * from './domain/qr-image.js';
+export * from './domain/guard-app-message.js';
+export * from './domain/date-range.js';
+export * from './domain/timezone.js';
+export * from './domain/scans-csv.js';
+export * from './domain/access-logs-csv.js';
+export * from './domain/tool-result.js';
+export * from './domain/puesta-en-marcha.js';
+export * from './domain/country.js';
+export * from './domain/money.js';
+// Capacidades de lectura
+export * from './reads/index.js';
+// Acciones de escritura (propuesta y confirmación)
+export * from './actions/index.js';
+// Catálogo único: metadatos, canales y filtro por canal
+export * from './catalog/types.js';
+export * from './catalog/entries.js';
+export * from './catalog/buildCatalog.js';
+export * from './catalog/english.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,cAAc,cAAc,CAAC;AAE7B,+DAA+D;AAC/D,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAEjC,2CAA2C;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,uEAAuE;AACvE,cAAc,oBAAoB,CAAC;AAEnC,eAAe;AACf,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAElC,yBAAyB;AACzB,cAAc,kBAAkB,CAAC;AAEjC,mDAAmD;AACnD,cAAc,oBAAoB,CAAC;AAEnC,wDAAwD;AACxD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC"}

package/dist/ports/FileSink.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Dónde dejar los ficheros que generan las capacidades (el QR de un checkpoint,
+ * un Excel de escaneos…). Cada consumidor lo implementa a su manera: el bot los
+ * envía por el chat, el servidor MCP los devuelve como contenido de la herramienta.
+ */
+export interface FileSink {
+    /** Una imagen PNG, con un pie opcional. */
+    sendImage(file: {
+        png: Uint8Array;
+        caption?: string;
+    }): Promise<void>;
+    /** Un documento cualquiera (p. ej. un CSV para Excel), con un pie opcional. */
+    sendDocument(file: {
+        bytes: Uint8Array;
+        filename: string;
+        mimeType: string;
+        caption?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=FileSink.d.ts.map

package/dist/ports/FileSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSink.d.ts","sourceRoot":"","sources":["../../src/ports/FileSink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,SAAS,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,+EAA+E;IAC/E,YAAY,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}

package/dist/ports/FileSink.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FileSink.js.map

package/dist/ports/FileSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSink.js","sourceRoot":"","sources":["../../src/ports/FileSink.ts"],"names":[],"mappings":""}

package/dist/ports/Logger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Logger que las capacidades reciben por inyección: el paquete no sabe dónde se
+ * escribe (JSON por consola en el bot, stderr en el servidor MCP…) ni depende de
+ * ningún logger global.
+ *
+ * Convención: si el contexto trae un error, va en `meta.err`. El logger del bot
+ * (`info(event, ctx)`) cumple esta interfaz tal cual.
+ */
+export interface Logger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+/** Logger que descarta todo: el valor por defecto cuando el consumidor no inyecta uno. */
+export declare const noopLogger: Logger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/ports/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/ports/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC"}

package/dist/ports/Logger.js

@@ -0,0 +1,7 @@
+/** Logger que descarta todo: el valor por defecto cuando el consumidor no inyecta uno. */
+export const noopLogger = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+//# sourceMappingURL=Logger.js.map

package/dist/ports/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/ports/Logger.ts"],"names":[],"mappings":"AAcA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAC"}

package/dist/ports/PendingActionStore.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Almacén de las acciones de escritura que se proponen al usuario y esperan su
+ * confirmación. Solo los tipos: las implementaciones (base de datos en el bot, en
+ * memoria en el servidor MCP…) viven en cada consumidor.
+ *
+ * Refleja las operaciones del almacén de propuestas del bot
+ * con `contextKey` en lugar de `threadId`: la clave de la conversación o sesión a
+ * la que pertenecen las propuestas (solo hay un lote vivo por clave).
+ *
+ * `contextKey` tiene que atar al USUARIO y a su cliente o conversación (p. ej.
+ * `<userId>:<conversationId>` en el bot, `<userId>:<clientId>:<sessionId>` en el
+ * MCP) y no compartirse NUNCA entre usuarios: quien tenga la clave puede
+ * confirmar, cancelar o ver las propuestas de ese lote.
+ */
+export type PendingActionStatus = 'proposed' | 'executing' | 'executed' | 'failed' | 'cancelled' | 'expired';
+export interface PendingAction {
+    id: string;
+    /** Usuario + cliente/conversación: nunca compartida entre usuarios (ver arriba). */
+    contextKey: string;
+    /** Nombre de la acción del catálogo (`ActionDefinition.nombre`, p. ej. `create_checkpoint`). */
+    action: string;
+    params: unknown;
+    organizationId: string | null;
+    status: PendingActionStatus;
+    idempotencyKey: string | null;
+    result: unknown;
+    error: string | null;
+    expiresAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Lote de propuestas del mismo turno, que se confirman de una vez (null en las anteriores a los lotes). */
+    batchId: string | null;
+}
+/** Una acción del lote, tal como se guarda al proponerla. */
+export interface ProposedItem {
+    action: string;
+    params: unknown;
+    organizationId: string | null;
+    idempotencyKey?: string | null;
+}
+export interface PendingActionStore {
+    /**
+     * Guarda un lote de acciones propuestas (las del mismo turno) con el mismo
+     * `batchId` y en el orden de la lista que verá el usuario. Las `proposed`
+     * anteriores de la misma clave se retiran (`cancelled`, o `expired` si ya
+     * habían caducado). La caducidad la calcula el almacén, con el mismo reloj que
+     * usa `claimForExecution`.
+     */
+    proposeActions(input: {
+        contextKey: string;
+        ttlMin: number;
+        items: ProposedItem[];
+    }): Promise<PendingAction[]>;
+    /** Las acciones de un lote, en el orden de la lista que vio el usuario. */
+    findBatch(contextKey: string, batchId: string): Promise<PendingAction[]>;
+    /**
+     * Una acción `proposed` de la clave (la primera de su lote), caducada o no
+     * (quien llama decide qué decir si ya caducó). Confirmarla confirma su lote entero.
+     */
+    findProposed(contextKey: string): Promise<PendingAction | undefined>;
+    findById(id: string): Promise<PendingAction | undefined>;
+    /**
+     * Reclama la acción para ejecutarla: `proposed` → `executing` de forma atómica,
+     * así que de dos confirmaciones simultáneas solo una la recibe. `undefined` = ya
+     * ejecutada o en curso, cancelada, caducada o de otra clave.
+     */
+    claimForExecution(id: string, contextKey: string): Promise<PendingAction | undefined>;
+    markExecuted(id: string, result: unknown): Promise<void>;
+    markFailed(id: string, error: string): Promise<void>;
+    /**
+     * Vuelve a dejar como propuestas, con la caducidad renovada a `ttlMin` minutos,
+     * las acciones que aún no se han hecho (la que se ejecutaba y las que esperaban
+     * su turno en el lote). Las ya hechas, fallidas o retiradas no se tocan.
+     */
+    reopenProposed(ids: readonly string[], ttlMin: number): Promise<void>;
+    /**
+     * Retira el lote vivo de la clave entero (el usuario dijo «cancelar»). Devuelve
+     * una de las retiradas, con su estado final (`cancelled`, o `expired` si llegó tarde).
+     */
+    cancelProposed(contextKey: string): Promise<PendingAction | undefined>;
+    /** ¿Se ejecutó alguna acción de esta clave en los últimos `withinMin` minutos? */
+    executedRecently(contextKey: string, withinMin: number): Promise<boolean>;
+}
+//# sourceMappingURL=PendingActionStore.d.ts.map

package/dist/ports/PendingActionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingActionStore.d.ts","sourceRoot":"","sources":["../../src/ports/PendingActionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,mBAAmB,GAC7B,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,4GAA4G;IAC5G,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,YAAY,EAAE,CAAC;KACvB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE7B,2EAA2E;IAC3E,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAEzE;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAErE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEzD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEtF,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEvE,kFAAkF;IAClF,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E"}

package/dist/ports/PendingActionStore.js

@@ -0,0 +1,16 @@
+/**
+ * Almacén de las acciones de escritura que se proponen al usuario y esperan su
+ * confirmación. Solo los tipos: las implementaciones (base de datos en el bot, en
+ * memoria en el servidor MCP…) viven en cada consumidor.
+ *
+ * Refleja las operaciones del almacén de propuestas del bot
+ * con `contextKey` en lugar de `threadId`: la clave de la conversación o sesión a
+ * la que pertenecen las propuestas (solo hay un lote vivo por clave).
+ *
+ * `contextKey` tiene que atar al USUARIO y a su cliente o conversación (p. ej.
+ * `<userId>:<conversationId>` en el bot, `<userId>:<clientId>:<sessionId>` en el
+ * MCP) y no compartirse NUNCA entre usuarios: quien tenga la clave puede
+ * confirmar, cancelar o ver las propuestas de ese lote.
+ */
+export {};
+//# sourceMappingURL=PendingActionStore.js.map

package/dist/ports/PendingActionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingActionStore.js","sourceRoot":"","sources":["../../src/ports/PendingActionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/reads/access.d.ts

@@ -0,0 +1,4 @@
+import { type ReadCapability, type ReadEnv } from './types.js';
+/** Control de Acceso: entradas, salidas y quién está dentro. */
+export declare function accessReads({ gateway, offerFiles }: ReadEnv): ReadCapability[];
+//# sourceMappingURL=access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/reads/access.ts"],"names":[],"mappings":"AAeA,OAAO,EAAsC,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAgJnG,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,GAAG,cAAc,EAAE,CAS9E"}