@nubiia/mcp-freematica 0.6.1

package/dist/tools/pedidos-compras.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools de pedidos de compra en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_pedidos_compra`: lista paginada con filtros mixtos
+ *   (4 query params nativos + FIQL vía rQuery).
+ * - `freematica_get_pedido_compra`: detalle por idReg opaco (objeto compuesto sin aplanar).
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerPedidosComprasTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/pedidos-compras.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { ListPedidosCompraFiltersSchema } from '../schemas/pedidos-compras.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_pedidos_compra';
+const GET_TOOL_NAME = 'freematica_get_pedido_compra';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de pedidos de compra de Freemática.',
+    '',
+    'DISEÑO MIXTO: este endpoint tiene 4 filtros como query params nativos (no FIQL)',
+    'y el resto de filtros vía rQuery (FIQL con campos ALCC_*).',
+    '',
+    'Filtros nativos (van directamente como query params):',
+    '  - empresa (4c) → codEmpresa',
+    '  - codProveedor (≤10c) → codProveedor',
+    '  - fechaPedidoDesde (ISO) → desdeFecha',
+    '  - fechaPedidoHasta (ISO) → hastaFecha',
+    '',
+    'Filtros FIQL (van en rQuery con campos ALCC_*):',
+    '  - numPedido → ALCC_NUMDOC',
+    '  - codDocumento → ALCC_CODDOC',
+    '  - delegacion → ALCC_DELEG',
+    '  - formaPago → ALCC_FPAGO',
+    '  - tipoIva → ALCC_TIPO_IVA',
+    '  - codCliente → ALCC_COD_CLIENTE',
+    '  - codInstalador → ALCC_COD_INSTALADOR',
+    '  - codMantenedor → ALCC_COD_MANTENEDOR',
+    '  - fechaEntregaDesde / fechaEntregaHasta → ALCC_FCHENTREGA con =ge=/=le=',
+    '  - referencia → ALCC_REFERENCIA (match exacto)',
+    '  - estado → enum: pendiente | bloqueado | recibido',
+    '',
+    'Cada item contiene los campos del pedido (ALCC_*) más `idReg` opaco para el endpoint singular.',
+    '',
+    'Paginación 1-indexed.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de un pedido de compra.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_pedidos_compra. NO usar ALCC_NUMDOC ni otro código natural.',
+    '',
+    'La respuesta es un objeto compuesto: { VoPedidosCompraCab, cabecera_proveedor, lineas[] }.',
+    'Se devuelve sin aplanar para conservar la estructura original del API.',
+].join('\n');
+/**
+ * Registra las tools de pedidos de compra en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_pedidos_compra`: lista paginada con filtros mixtos
+ *   (4 query params nativos + FIQL vía rQuery).
+ * - `freematica_get_pedido_compra`: detalle por idReg opaco (objeto compuesto sin aplanar).
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerPedidosComprasTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, ListPedidosCompraFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, empresa, codProveedor, fechaPedidoDesde, fechaPedidoHasta, numPedido, codDocumento, delegacion, formaPago, tipoIva, codCliente, codInstalador, codMantenedor, fechaEntregaDesde, fechaEntregaHasta, referencia, estado, }) => {
+        try {
+            const result = await client.listPedidosCompra({
+                page,
+                items,
+                empresa,
+                codProveedor,
+                fechaPedidoDesde,
+                fechaPedidoHasta,
+                numPedido,
+                codDocumento,
+                delegacion,
+                formaPago,
+                tipoIva,
+                codCliente,
+                codInstalador,
+                codMantenedor,
+                fechaEntregaDesde,
+                fechaEntregaHasta,
+                referencia,
+                estado,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del pedido de compra (campo "idReg" en los items de freematica_list_pedidos_compra). ' +
+            'Puede contener caracteres especiales como "==" (base64); se URL-encodeará automáticamente.'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const pedido = await client.getPedidoCompra(id);
+            return ok(pedido);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=pedidos-compras.js.map

package/dist/tools/pedidos-compras.js.map

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

package/dist/tools/personal.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools MCP del dominio Personal (RRHH).
+ *
+ * Tools expuestas:
+ *  1. freematica_list_personal  — lista paginada con filtros FIQL
+ *  2. freematica_get_persona    — detalle por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerPersonalTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/personal.js

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const LIST_TOOL_NAME = 'freematica_list_personal';
+const GET_TOOL_NAME = 'freematica_get_persona';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de personas (empleados / personal) de Freemática.',
+    '',
+    'Endpoint: GET /pers/v2/personal',
+    '',
+    'Permite filtrar por empresa (VSSPER_EMP), delegación (VSSPER_DELEG), código',
+    'de persona (VSSPER_COD), nombre (VSSPER_NOM, búsqueda parcial), primer',
+    'apellido (VSSPER_APELL1, búsqueda parcial), NIF (VSSPER_NIF), situación',
+    '(VSSPER_SIT), departamento (VSSPER_DPTO), sección (VSSPER_SECCION) y activo',
+    '(boolean traducido a FIQL VSSPER_ACTIVO==S o VSSPER_ACTIVO==N).',
+    '',
+    'Cada item incluye `idReg` opaco para usar en freematica_get_persona.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de una persona.',
+    '',
+    'Endpoint: GET /pers/v2/personal/{idreg}',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece',
+    'en los items de freematica_list_personal.',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+/** Schema para freematica_list_personal. */
+const ListPersonalSchema = {
+    ...PaginationSchema,
+    empresa: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de empresa (campo VSSPER_EMP en Freemática).'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (campo VSSPER_DELEG en Freemática).'),
+    codPersona: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural de la persona (campo VSSPER_COD en Freemática).'),
+    nombre: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Nombre de la persona — búsqueda parcial con FIQL LIKE (campo VSSPER_NOM). ' +
+        'Introduce parte del nombre para buscar (ej. "Juan" encuentra "Juan Carlos").'),
+    apellido: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Primer apellido — búsqueda parcial con FIQL LIKE (campo VSSPER_APELL1). ' +
+        'Introduce parte del apellido para buscar.'),
+    nif: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('NIF/DNI de la persona (campo VSSPER_NIF en Freemática). Coincidencia exacta.'),
+    situacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de situación laboral (campo VSSPER_SIT en Freemática).'),
+    departamento: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de departamento (campo VSSPER_DPTO en Freemática).'),
+    seccion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de sección (campo VSSPER_SECCION en Freemática).'),
+    activo: z
+        .boolean()
+        .optional()
+        .describe('Filtra por personas activas (true → VSSPER_ACTIVO==S) o inactivas (false → VSSPER_ACTIVO==N). ' +
+        'Si se omite, devuelve todas.'),
+};
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tools MCP del dominio Personal (RRHH).
+ *
+ * Tools expuestas:
+ *  1. freematica_list_personal  — lista paginada con filtros FIQL
+ *  2. freematica_get_persona    — detalle por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerPersonalTools(server, client) {
+    // -------------------------------------------------------------------------
+    // 1. freematica_list_personal
+    // -------------------------------------------------------------------------
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, ListPersonalSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, empresa, delegacion, codPersona, nombre, apellido, nif, situacion, departamento, seccion, activo, }) => {
+        try {
+            const result = await client.listPersonal({
+                page,
+                items,
+                empresa,
+                delegacion,
+                codPersona,
+                nombre,
+                apellido,
+                nif,
+                situacion,
+                departamento,
+                seccion,
+                activo,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 2. freematica_get_persona
+    // -------------------------------------------------------------------------
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco de la persona (campo "idReg" en los items de freematica_list_personal).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const persona = await client.getPersona(id);
+            return ok(persona);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=personal.js.map

package/dist/tools/personal.js.map

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

package/dist/tools/prl.d.ts

@@ -0,0 +1,47 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Schema Zod con `.refine()` para validar "al menos uno de los 4 identificadores".
+ *
+ * Se usa en los tests y dentro del handler. NO se pasa directamente a server.tool
+ * porque ZodEffects no es ZodRawShapeCompat.
+ */
+export declare const FichaPrevClienteRefinedSchema: z.ZodEffects<z.ZodObject<{
+    codCliente: z.ZodOptional<z.ZodString>;
+    grupoCliente: z.ZodOptional<z.ZodNumber>;
+    codLocalizacionServicio: z.ZodOptional<z.ZodNumber>;
+    codigoFicha: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    codCliente?: string | undefined;
+    grupoCliente?: number | undefined;
+    codLocalizacionServicio?: number | undefined;
+    codigoFicha?: string | undefined;
+}, {
+    codCliente?: string | undefined;
+    grupoCliente?: number | undefined;
+    codLocalizacionServicio?: number | undefined;
+    codigoFicha?: string | undefined;
+}>, {
+    codCliente?: string | undefined;
+    grupoCliente?: number | undefined;
+    codLocalizacionServicio?: number | undefined;
+    codigoFicha?: string | undefined;
+}, {
+    codCliente?: string | undefined;
+    grupoCliente?: number | undefined;
+    codLocalizacionServicio?: number | undefined;
+    codigoFicha?: string | undefined;
+}>;
+/**
+ * Registra las tools MCP del dominio PRL (Prevención de Riesgos Laborales).
+ *
+ * Tools expuestas:
+ *  1. freematica_get_ficha_prev_cliente  — ficha PRL de un cliente
+ *  2. freematica_list_vigilancia_salud   — lista paginada de VS con filtros
+ *  3. freematica_get_vigilancia_salud    — detalle de un registro VS por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerPrlTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/prl.js

@@ -0,0 +1,242 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const FICHA_TOOL_NAME = 'freematica_get_ficha_prev_cliente';
+const LIST_VS_TOOL_NAME = 'freematica_list_vigilancia_salud';
+const GET_VS_TOOL_NAME = 'freematica_get_vigilancia_salud';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const FICHA_DESCRIPTION = [
+    'Devuelve la ficha de Prevención de Riesgos Laborales (PRL) de un cliente.',
+    '',
+    'Endpoint: GET /pprl/v2/ficha-prev-cliente',
+    '',
+    'Los filtros se envían como query params nativos (NO FIQL). Al menos uno de los',
+    'cuatro identificadores es obligatorio: codCliente, grupoCliente,',
+    'codLocalizacionServicio o codigoFicha. Si se pasan varios se combinan con AND.',
+    '',
+    'IMPORTANTE: si no se pasa ningún identificador, la tool devuelve un error de',
+    'validación sin llamar al API.',
+    '',
+    'Campos de respuesta principales: COD_CLI, NOMBRE_CLI, COD_GRUPO_CLI,',
+    'COD_LOC_SERV, CODIGO_FICHA, FECHA_ALTA, ESTADO, etc.',
+].join('\n');
+const LIST_VS_DESCRIPTION = [
+    'Devuelve la lista paginada de registros de Vigilancia de la Salud.',
+    '',
+    'Endpoint: GET /pprl/v1/vigilancia-salud',
+    '',
+    'Permite filtrar por persona (idRegPersona nativo), empresa (PERVS_EMP),',
+    'delegación (PERVS_DELEG), código de persona (PERVS_PERSO), tipo de revisión',
+    '(PERVS_TIPO_REVISION), resultado (PERVS_RESULTADO) y rango de fecha de cita',
+    '(PERVS_FCH_CITA). Los filtros FIQL se combinan con AND.',
+    '',
+    'Campos principales: PERVS_EMP, PERVS_DELEG, PERVS_PERSO, PERVS_TIPO_REVISION,',
+    'PERVS_RESULTADO, PERVS_FCH_CITA, idReg.',
+].join('\n');
+const GET_VS_DESCRIPTION = [
+    'Devuelve el detalle completo de un registro de Vigilancia de la Salud.',
+    '',
+    'Endpoint: GET /pprl/v1/vigilancia-salud/{idreg}',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece',
+    'en los items de freematica_list_vigilancia_salud.',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Schemas (ZodRawShape: plain objects of zod fields, compatible with server.tool)
+// ---------------------------------------------------------------------------
+/**
+ * Shape de Zod para freematica_get_ficha_prev_cliente.
+ *
+ * El MCP SDK requiere un ZodRawShape (objeto plano de esquemas Zod), no un
+ * ZodObject ni ZodEffects. La validación "al menos uno requerido" se ejecuta
+ * dentro del handler mediante `FichaPrevClienteRefinedSchema.safeParse()`.
+ *
+ * Campos:
+ *  - codCliente              → query param codCli  (string)
+ *  - grupoCliente            → query param grpCli  (number, máx. 2 dígitos)
+ *  - codLocalizacionServicio → query param locServ (number, máx. 5 dígitos)
+ *  - codigoFicha             → query param codigo  (string)
+ */
+const FichaPrevClienteShape = {
+    codCliente: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural del cliente (query param codCli). Opcional: al menos uno requerido.'),
+    grupoCliente: z
+        .number()
+        .int()
+        .min(1)
+        .max(99)
+        .optional()
+        .describe('Código de grupo de clientes (query param grpCli, máx. 2 dígitos). Opcional: al menos uno requerido.'),
+    codLocalizacionServicio: z
+        .number()
+        .int()
+        .min(1)
+        .max(99999)
+        .optional()
+        .describe('Código de localización de servicio (query param locServ, máx. 5 dígitos). Opcional: al menos uno requerido.'),
+    codigoFicha: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de ficha PRL (query param codigo). Opcional: al menos uno requerido.'),
+};
+/**
+ * Schema Zod con `.refine()` para validar "al menos uno de los 4 identificadores".
+ *
+ * Se usa en los tests y dentro del handler. NO se pasa directamente a server.tool
+ * porque ZodEffects no es ZodRawShapeCompat.
+ */
+export const FichaPrevClienteRefinedSchema = z
+    .object(FichaPrevClienteShape)
+    .refine((v) => v.codCliente !== undefined ||
+    v.grupoCliente !== undefined ||
+    v.codLocalizacionServicio !== undefined ||
+    v.codigoFicha !== undefined, {
+    message: 'Se requiere al menos un identificador: codCliente, grupoCliente, codLocalizacionServicio o codigoFicha. ' +
+        'Llamar sin ningún filtro devolvería el dataset completo.',
+});
+/** Schema para freematica_list_vigilancia_salud. */
+const ListVigilanciaSaludShape = {
+    ...PaginationSchema,
+    idRegPersona: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('idReg opaco de la persona (query param nativo del API, no FIQL). Filtra registros de una persona concreta.'),
+    empresa: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de empresa (campo PERVS_EMP en Freemática).'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (campo PERVS_DELEG en Freemática).'),
+    codPersona: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código natural de la persona (campo PERVS_PERSO en Freemática).'),
+    tipoRevision: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Tipo de revisión médica (campo PERVS_TIPO_REVISION en Freemática).'),
+    resultado: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Resultado de la revisión (campo PERVS_RESULTADO en Freemática).'),
+    fechaCitaDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/, 'Debe ser una fecha ISO 8601 (YYYY-MM-DD)')
+        .optional()
+        .describe('Fecha inicio del rango de cita (campo PERVS_FCH_CITA, ISO 8601, inclusive).'),
+    fechaCitaHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/, 'Debe ser una fecha ISO 8601 (YYYY-MM-DD)')
+        .optional()
+        .describe('Fecha fin del rango de cita (campo PERVS_FCH_CITA, ISO 8601, inclusive).'),
+};
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tools MCP del dominio PRL (Prevención de Riesgos Laborales).
+ *
+ * Tools expuestas:
+ *  1. freematica_get_ficha_prev_cliente  — ficha PRL de un cliente
+ *  2. freematica_list_vigilancia_salud   — lista paginada de VS con filtros
+ *  3. freematica_get_vigilancia_salud    — detalle de un registro VS por idReg
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerPrlTools(server, client) {
+    // -------------------------------------------------------------------------
+    // 1. freematica_get_ficha_prev_cliente
+    // -------------------------------------------------------------------------
+    server.tool(FICHA_TOOL_NAME, FICHA_DESCRIPTION, FichaPrevClienteShape, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ codCliente, grupoCliente, codLocalizacionServicio, codigoFicha }) => {
+        // Validación "al menos uno requerido" — previene llamadas sin filtro que
+        // devolverían el dataset completo (potencialmente miles de registros).
+        const validation = FichaPrevClienteRefinedSchema.safeParse({
+            codCliente,
+            grupoCliente,
+            codLocalizacionServicio,
+            codigoFicha,
+        });
+        if (!validation.success) {
+            const msg = validation.error.errors.map((e) => e.message).join('; ');
+            return error(new Error(msg));
+        }
+        try {
+            const result = await client.getFichaPrevCliente({
+                codCliente,
+                grupoCliente,
+                codLocalizacionServicio,
+                codigoFicha,
+            });
+            return okList({ items: result.items, total: result.total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 2. freematica_list_vigilancia_salud
+    // -------------------------------------------------------------------------
+    server.tool(LIST_VS_TOOL_NAME, LIST_VS_DESCRIPTION, ListVigilanciaSaludShape, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items, idRegPersona, empresa, delegacion, codPersona, tipoRevision, resultado, fechaCitaDesde, fechaCitaHasta, }) => {
+        try {
+            const result = await client.listVigilanciaSalud({
+                page,
+                items,
+                idRegPersona,
+                empresa,
+                delegacion,
+                codPersona,
+                tipoRevision,
+                resultado,
+                fechaCitaDesde,
+                fechaCitaHasta,
+            });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 3. freematica_get_vigilancia_salud
+    // -------------------------------------------------------------------------
+    server.tool(GET_VS_TOOL_NAME, GET_VS_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del registro de vigilancia de la salud (campo "idReg" en los items de freematica_list_vigilancia_salud).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const vs = await client.getVigilanciaSalud(id);
+            return ok(vs);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=prl.js.map

package/dist/tools/prl.js.map

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

package/dist/tools/proveedores.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools de proveedores en el servidor MCP.
+ *
+ * Tools registradas:
+ * - `freematica_list_proveedores`: lista paginada con filtros FIQL (incluye búsqueda parcial por nombre
+ *   con =lk= y filtro activo/inactivo vía FECHA_BAJA).
+ * - `freematica_get_proveedor`: detalle por idReg opaco.
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerProveedoresTools(server: McpServer, client: FreematicaClient): void;