@frihet/mcp-server 1.7.0-beta.1 → 1.12.0-beta.1

package/dist/tools/fiscal.js

@@ -0,0 +1,197 @@
+/**
+ * Fiscal tools for the Frihet MCP server — Wave 6 (7 tools).
+ *
+ * Tools:
+ *   1. get_modelo_303_summary   — IVA quarterly Spain
+ *   2. get_modelo_130_summary   — IRPF estimated payment Spain
+ *   3. get_modelo_390_summary   — IVA annual recap Spain
+ *   4. get_modelo_180_summary   — IRPF rentals annual Spain
+ *   5. get_modelo_347_summary   — Operations >€3005 annual third-party recap
+ *   6. verifactu_status         — VeriFactu submission status for an invoice
+ *   7. verifactu_resubmit       — Re-submit a failed VeriFactu submission (TRUST AREA)
+ *
+ * NOTE: ticketbai_status is registered by einvoice.ts (canonical, more complete impl).
+ *
+ * REST surface: /v1/fiscal/* (documented: pending — backend ships separately)
+ *
+ * NOTE: ERP backend endpoints /v1/fiscal/* are planned. Tools are wired
+ * and will surface 404 errors until the backend ships.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, fiscalModeloSummaryOutput, verifactuStatusOutput, } from "./shared.js";
+export function registerFiscalTools(server, client) {
+    // -- get_modelo_303_summary --
+    server.registerTool("get_modelo_303_summary", {
+        title: "Get Modelo 303 Summary (IVA Quarterly)",
+        description: "Get IVA (VAT) quarterly summary for Modelo 303 filing in Spain. " +
+            "Returns aggregated totals by tax rate, deductible IVA, net amount due, and filing deadline. " +
+            "Example: period='2026-Q1' / " +
+            "Obtiene el resumen trimestral del IVA para el Modelo 303 en Espana. " +
+            "Devuelve totales por tipo impositivo, IVA deducible, cuota a ingresar y plazo.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe("Period in format YYYY-QN (e.g. '2026-Q1') or YYYY for annual / Periodo en formato YYYY-QN o YYYY"),
+        },
+        outputSchema: fiscalModeloSummaryOutput,
+    }, async ({ period }) => withToolLogging("get_modelo_303_summary", async () => {
+        const result = await client.getFiscalModeloSummary("303", period);
+        return {
+            content: [getContent(formatRecord("Modelo 303 Summary", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_modelo_130_summary --
+    server.registerTool("get_modelo_130_summary", {
+        title: "Get Modelo 130 Summary (IRPF Estimated Payment)",
+        description: "Get IRPF estimated payment summary for Modelo 130 filing (freelancers/self-employed in Spain). " +
+            "Returns quarterly net income, deductible expenses, previous payments, and amount due. " +
+            "Example: period='2026-Q1' / " +
+            "Obtiene el resumen del pago fraccionado IRPF para el Modelo 130 (autonomos). " +
+            "Devuelve rendimiento neto, gastos deducibles, pagos previos y cuota a ingresar.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe("Period in format YYYY-QN (e.g. '2026-Q1') / Periodo en formato YYYY-QN"),
+        },
+        outputSchema: fiscalModeloSummaryOutput,
+    }, async ({ period }) => withToolLogging("get_modelo_130_summary", async () => {
+        const result = await client.getFiscalModeloSummary("130", period);
+        return {
+            content: [getContent(formatRecord("Modelo 130 Summary", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_modelo_390_summary --
+    server.registerTool("get_modelo_390_summary", {
+        title: "Get Modelo 390 Summary (IVA Annual Recap)",
+        description: "Get IVA annual summary for Modelo 390 filing in Spain. " +
+            "Returns full-year totals by rate, total deductible IVA, and annual balance. " +
+            "Example: period='2025' / " +
+            "Obtiene el resumen anual del IVA para el Modelo 390. " +
+            "Devuelve totales anuales por tipo, IVA deducible total y resultado anual.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe("Year in format YYYY (e.g. '2025') / Ejercicio en formato YYYY"),
+        },
+        outputSchema: fiscalModeloSummaryOutput,
+    }, async ({ period }) => withToolLogging("get_modelo_390_summary", async () => {
+        const result = await client.getFiscalModeloSummary("390", period);
+        return {
+            content: [getContent(formatRecord("Modelo 390 Summary", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_modelo_180_summary --
+    server.registerTool("get_modelo_180_summary", {
+        title: "Get Modelo 180 Summary (IRPF Rentals Annual)",
+        description: "Get IRPF annual informative summary for rental income withholdings (Modelo 180, Spain). " +
+            "Returns total retentions per tenant, property, and annual aggregate. " +
+            "Example: period='2025' / " +
+            "Obtiene el resumen anual de retenciones sobre alquileres para el Modelo 180. " +
+            "Devuelve retenciones totales por inquilino, inmueble y agregado anual.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe("Year in format YYYY (e.g. '2025') / Ejercicio en formato YYYY"),
+        },
+        outputSchema: fiscalModeloSummaryOutput,
+    }, async ({ period }) => withToolLogging("get_modelo_180_summary", async () => {
+        const result = await client.getFiscalModeloSummary("180", period);
+        return {
+            content: [getContent(formatRecord("Modelo 180 Summary", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_modelo_347_summary --
+    server.registerTool("get_modelo_347_summary", {
+        title: "Get Modelo 347 Summary (Operations >€3,005 Annual Recap)",
+        description: "Get annual informative summary of operations exceeding €3,005 per counterparty (Modelo 347, Spain). " +
+            "Returns per-party totals for clients and vendors above the threshold. " +
+            "Example: period='2025' / " +
+            "Obtiene el resumen anual de operaciones con terceros superiores a 3.005€ (Modelo 347). " +
+            "Devuelve totales por cliente/proveedor que superen el umbral.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z
+                .string()
+                .optional()
+                .describe("Year in format YYYY (e.g. '2025') / Ejercicio en formato YYYY"),
+        },
+        outputSchema: fiscalModeloSummaryOutput,
+    }, async ({ period }) => withToolLogging("get_modelo_347_summary", async () => {
+        const result = await client.getFiscalModeloSummary("347", period);
+        return {
+            content: [getContent(formatRecord("Modelo 347 Summary", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- verifactu_status --
+    server.registerTool("verifactu_status", {
+        title: "Get VeriFactu Submission Status",
+        description: "Get the VeriFactu (AEAT Spanish e-invoice chain) submission status for a specific invoice. " +
+            "Returns last submission timestamp, hash, AEAT response code, and QR verification URL. " +
+            "/ Obtiene el estado de envio VeriFactu (AEAT) para una factura especifica. " +
+            "Devuelve timestamp del ultimo envio, hash, respuesta AEAT y URL del codigo QR.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            invoiceId: z.string().describe("Invoice ID / ID de la factura"),
+        },
+        outputSchema: verifactuStatusOutput,
+    }, async ({ invoiceId }) => withToolLogging("verifactu_status", async () => {
+        const result = await client.getVerifactuStatus(invoiceId);
+        return {
+            content: [getContent(formatRecord("VeriFactu Status", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- verifactu_resubmit --
+    server.registerTool("verifactu_resubmit", {
+        title: "Re-submit VeriFactu Submission",
+        description: "TRUST AREA — COMPLIANCE. Re-submit a failed or rejected VeriFactu submission to AEAT. " +
+            "Idempotent: uses the same hash chain; AEAT deduplicates by hash. " +
+            "Creates an audit trail entry for every resubmission attempt. " +
+            "Requires confirm=true. Only use on invoices with status='failed'. " +
+            "/ AREA DE CONFIANZA — COMPLIANCE. Reenvio de una factura VeriFactu fallida a AEAT. " +
+            "Idempotente: misma cadena hash. Registra entrada de auditoria en cada intento. " +
+            "Requiere confirm=true. Solo para facturas con status='failed'.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: {
+            invoiceId: z.string().describe("Invoice ID to resubmit / ID de la factura a reenviar"),
+            confirm: z
+                .boolean()
+                .describe("Must be true to confirm VeriFactu resubmission / Debe ser true para confirmar el reenvio"),
+        },
+        outputSchema: verifactuStatusOutput,
+    }, async ({ invoiceId, confirm }) => withToolLogging("verifactu_resubmit", async () => {
+        if (!confirm) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: confirm=true is required for VeriFactu resubmission. " +
+                            "This is a COMPLIANCE action that submits fiscal data to AEAT. " +
+                            "Verify the invoice data is correct before setting confirm=true. / " +
+                            "Se requiere confirm=true para el reenvio VeriFactu. Accion de COMPLIANCE que envia datos fiscales a AEAT.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await client.resubmitVerifactu(invoiceId);
+        return {
+            content: [mutateContent(formatRecord("VeriFactu Resubmitted", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=fiscal.js.map

package/dist/tools/fiscal.js.map

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

package/dist/tools/gestoria.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Gestoria (accountant) tools for the Frihet MCP server — Wave Fase 1 (5 tools).
+ *
+ * Tools:
+ *   1. gestoria_message_send          — send a message in a contextual thread
+ *   2. gestoria_messages_list         — list messages in a thread (paged backwards)
+ *   3. gestoria_template_create       — create a document request template
+ *   4. gestoria_template_bulk_send    — bulk send template to N client workspaces
+ *   5. gestoria_aging_consolidated    — cross-client AR aging report
+ *
+ * REST surface: /v1/gestoria/*
+ *
+ * Backend status (post-Wave Fase 1, May 2026):
+ *   - Frihet-ERP PR #383 — `gestoriaBulkSendRequests` callable (eu-west1) MERGED.
+ *   - Frihet-ERP PR #384 — consolidated AR aging tab (branch live, await merge).
+ *   - Frihet-ERP PR #385 — contextual messaging (branch live, await merge).
+ *
+ * The MCP layer talks REST (`api.frihet.io/v1/gestoria/*`). The REST shell
+ * proxies to Firebase callables + Firestore reads. Until the REST shell ships,
+ * tools will surface 404 errors with clear messages — clients can retry post-deploy.
+ *
+ * App Check: mcp.frihet.io worker is App Check enforced. Region: callables
+ * auto-resolve eu-west1 via existing client routing.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerGestoriaTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=gestoria.d.ts.map

package/dist/tools/gestoria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestoria.d.ts","sourceRoot":"","sources":["../../src/tools/gestoria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAuC5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAyPpF"}

package/dist/tools/gestoria.js

@@ -0,0 +1,248 @@
+/**
+ * Gestoria (accountant) tools for the Frihet MCP server — Wave Fase 1 (5 tools).
+ *
+ * Tools:
+ *   1. gestoria_message_send          — send a message in a contextual thread
+ *   2. gestoria_messages_list         — list messages in a thread (paged backwards)
+ *   3. gestoria_template_create       — create a document request template
+ *   4. gestoria_template_bulk_send    — bulk send template to N client workspaces
+ *   5. gestoria_aging_consolidated    — cross-client AR aging report
+ *
+ * REST surface: /v1/gestoria/*
+ *
+ * Backend status (post-Wave Fase 1, May 2026):
+ *   - Frihet-ERP PR #383 — `gestoriaBulkSendRequests` callable (eu-west1) MERGED.
+ *   - Frihet-ERP PR #384 — consolidated AR aging tab (branch live, await merge).
+ *   - Frihet-ERP PR #385 — contextual messaging (branch live, await merge).
+ *
+ * The MCP layer talks REST (`api.frihet.io/v1/gestoria/*`). The REST shell
+ * proxies to Firebase callables + Firestore reads. Until the REST shell ships,
+ * tools will surface 404 errors with clear messages — clients can retry post-deploy.
+ *
+ * App Check: mcp.frihet.io worker is App Check enforced. Region: callables
+ * auto-resolve eu-west1 via existing client routing.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, listContent, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, gestoriaMessageItemOutput, gestoriaMessageSendResultOutput, gestoriaTemplateCreateResultOutput, gestoriaBulkSendResultOutput, gestoriaAgingConsolidatedOutput, } from "./shared.js";
+const PARENT_TYPE = z
+    .enum(["documentRequest", "filingItem", "obligation"])
+    .describe("Thread parent kind / Tipo de hilo: documentRequest (solicitud de documento), filingItem (presentacion fiscal), obligation (obligacion fiscal)");
+const TEMPLATE_VARIABLE = z.object({
+    key: z.string().describe("Variable placeholder key, e.g. 'quarter' / Clave variable, p.ej. 'trimestre'"),
+    label: z.string().optional().describe("Human label shown in template editor / Etiqueta legible"),
+    defaultValue: z.string().optional().describe("Fallback value if no override supplied / Valor por defecto"),
+});
+const PERIOD_OVERRIDES = z
+    .object({
+    quarter: z.union([z.string(), z.number()]).optional(),
+    year: z.union([z.string(), z.number()]).optional(),
+    month: z.union([z.string(), z.number()]).optional(),
+})
+    .optional()
+    .describe("Override template period variables in the bulk send / Sobrescribir variables de periodo (trimestre, ano, mes)");
+export function registerGestoriaTools(server, client) {
+    // -- gestoria_message_send ------------------------------------------------
+    server.registerTool("gestoria_message_send", {
+        title: "Send Gestoria Message",
+        description: "Send a message in a contextual thread between a gestor (accountant) and a client. " +
+            "Threads attach to a document request, a filing item, or a fiscal obligation — " +
+            "context is preserved so both sides see what the message is about. " +
+            "Useful for chasing a missing document, replying to a client's question, or " +
+            "annotating a presentation. " +
+            "Example: workspaceId='ws_abc', parentType='documentRequest', parentId='dr_q3_iva', body='Falta el extracto bancario de septiembre'. " +
+            "/ Envia un mensaje en un hilo contextual entre gestor y cliente. " +
+            "Los hilos se anclan a una solicitud de documento, presentacion o obligacion fiscal — " +
+            "ambas partes ven a que se refiere. Util para pedir documentos, responder dudas o anotar presentaciones.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            workspaceId: z
+                .string()
+                .min(1)
+                .describe("Client workspace ID the thread belongs to / ID del espacio de trabajo del cliente"),
+            parentType: PARENT_TYPE,
+            parentId: z.string().min(1).describe("ID of the parent entity (document request / filing item / obligation) / ID de la entidad padre"),
+            body: z
+                .string()
+                .min(1)
+                .max(4000)
+                .describe("Message body (plain text, 1-4000 chars) / Cuerpo del mensaje (texto plano)"),
+        },
+        outputSchema: gestoriaMessageSendResultOutput,
+    }, async ({ workspaceId, parentType, parentId, body }) => withToolLogging("gestoria_message_send", async () => {
+        const result = await client.sendGestoriaMessage({ workspaceId, parentType, parentId, body });
+        return {
+            content: [mutateContent(formatRecord("Message sent", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- gestoria_messages_list -----------------------------------------------
+    server.registerTool("gestoria_messages_list", {
+        title: "List Gestoria Messages",
+        description: "List messages in a contextual gestor/cliente thread, newest first. " +
+            "Use `before` (message ID or ISO timestamp) to paginate backwards through history. " +
+            "Returns up to `limit` messages plus a `hasMore` flag so the agent knows when to stop. " +
+            "/ Lista los mensajes de un hilo gestor/cliente, mas recientes primero. " +
+            "Usa `before` (ID o fecha) para paginar hacia atras. Devuelve hasta `limit` mensajes con flag `hasMore`.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            workspaceId: z.string().min(1).describe("Client workspace ID / ID del espacio de trabajo"),
+            parentType: PARENT_TYPE,
+            parentId: z.string().min(1).describe("ID of the parent entity / ID de la entidad padre"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Max messages to return (1-100, default 50) / Mensajes maximos"),
+            before: z
+                .string()
+                .optional()
+                .describe("Cursor: messages older than this (message ID or ISO date) / Cursor: mensajes anteriores a este"),
+        },
+        outputSchema: z.object({
+            messages: z.array(gestoriaMessageItemOutput),
+            hasMore: z.boolean(),
+        }),
+    }, async ({ workspaceId, parentType, parentId, limit, before }) => withToolLogging("gestoria_messages_list", async () => {
+        const result = await client.listGestoriaMessages({
+            workspaceId,
+            parentType,
+            parentId,
+            limit,
+            before,
+        });
+        const count = Array.isArray(result.messages) ? result.messages.length : 0;
+        return {
+            content: [
+                listContent(`Loaded ${count} message${count === 1 ? "" : "s"} for ${parentType}:${parentId}` +
+                    (result.hasMore ? " (more available — paginate with `before`)" : "")),
+            ],
+            structuredContent: result,
+        };
+    }));
+    // -- gestoria_template_create ---------------------------------------------
+    server.registerTool("gestoria_template_create", {
+        title: "Create Gestoria Template",
+        description: "Create a reusable document request template that the gestor can bulk-send to many " +
+            "client workspaces. Template body supports plain-text variable interpolation " +
+            "(e.g. `{{quarter}}`, `{{year}}`). `dueDateOffsetDays` sets when the request is due " +
+            "relative to the bulk-send date. `attachmentRequired=true` enforces clients to upload " +
+            "a file before marking complete. " +
+            "Example: name='IVA trimestral', title='Documentacion IVA {{quarter}}/{{year}}', " +
+            "description='Adjunta extractos bancarios y facturas emitidas del {{quarter}}', " +
+            "dueDateOffsetDays=14, attachmentRequired=true. " +
+            "/ Crea una plantilla de solicitud de documento reutilizable que el gestor puede enviar en masa a varios espacios cliente.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            name: z
+                .string()
+                .min(1)
+                .max(120)
+                .describe("Internal template name (shown to gestor only) / Nombre interno"),
+            title: z
+                .string()
+                .min(1)
+                .max(200)
+                .describe("Title rendered to the client (supports {{variables}}) / Titulo visible al cliente"),
+            description: z
+                .string()
+                .min(1)
+                .max(4000)
+                .describe("Description / instructions for the client (supports {{variables}}) / Descripcion e instrucciones"),
+            dueDateOffsetDays: z
+                .number()
+                .int()
+                .min(0)
+                .max(365)
+                .describe("Days from send until due (0-365) / Dias desde envio hasta vencimiento"),
+            attachmentRequired: z
+                .boolean()
+                .optional()
+                .describe("Require an uploaded file before completion (default: false) / Requiere archivo"),
+            variables: z
+                .array(TEMPLATE_VARIABLE)
+                .optional()
+                .describe("Variable definitions for interpolation / Definiciones de variables"),
+        },
+        outputSchema: gestoriaTemplateCreateResultOutput,
+    }, async ({ name, title, description, dueDateOffsetDays, attachmentRequired, variables }) => withToolLogging("gestoria_template_create", async () => {
+        const result = await client.createGestoriaTemplate({
+            name,
+            title,
+            description,
+            dueDateOffsetDays,
+            attachmentRequired,
+            variables,
+        });
+        return {
+            content: [mutateContent(formatRecord("Template created", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- gestoria_template_bulk_send ------------------------------------------
+    server.registerTool("gestoria_template_bulk_send", {
+        title: "Bulk Send Gestoria Template",
+        description: "Send the same document request template to up to 500 client workspaces in one call. " +
+            "Each spawned request triggers the per-client notification handler (email + in-app). " +
+            "Honours `allowGestoriaCommunications=false` on the client user doc (opt-out). " +
+            "Uses `periodOverrides` to plug runtime values (quarter/year/month) into template variables. " +
+            "Returns a per-client outcome with success count, failures, and total wall-clock duration. " +
+            "Trust Area: RGPD — recipients must already have granted accountant access. " +
+            "Example: templateId='tpl_iva_q', clientWorkspaceIds=['ws_a','ws_b','ws_c'], periodOverrides={quarter:3, year:2026}. " +
+            "/ Envia la misma plantilla a hasta 500 espacios cliente en una sola operacion. " +
+            "Respeta opt-out `allowGestoriaCommunications=false`.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            templateId: z.string().min(1).describe("Template ID (from `gestoria_template_create`) / ID de la plantilla"),
+            clientWorkspaceIds: z
+                .array(z.string().min(1))
+                .min(1)
+                .max(500)
+                .describe("Target client workspace IDs (1-500) / IDs de espacios cliente destino"),
+            periodOverrides: PERIOD_OVERRIDES,
+        },
+        outputSchema: gestoriaBulkSendResultOutput,
+    }, async ({ templateId, clientWorkspaceIds, periodOverrides }) => withToolLogging("gestoria_template_bulk_send", async () => {
+        const result = await client.bulkSendGestoriaTemplate({
+            templateId,
+            clientWorkspaceIds,
+            periodOverrides,
+        });
+        const success = typeof result.success === "number" ? result.success : 0;
+        const failed = Array.isArray(result.failed) ? result.failed.length : 0;
+        return {
+            content: [
+                mutateContent(`Bulk send complete: ${success} succeeded, ${failed} failed of ${clientWorkspaceIds.length} targets.`),
+            ],
+            structuredContent: result,
+        };
+    }));
+    // -- gestoria_aging_consolidated ------------------------------------------
+    server.registerTool("gestoria_aging_consolidated", {
+        title: "Consolidated AR Aging (Gestoria)",
+        description: "Get a cross-client AR aging report for a gestor — totals bucketed by current / 30-60 / " +
+            "60-90 / 90+ days overdue, a per-workspace breakdown, and the top overdue invoices. " +
+            "Defaults to the authenticated gestor; pass `ownerUid` to query a specific gestor " +
+            "(requires elevated scope). " +
+            "Useful for dunning prioritisation and end-of-month chase lists. " +
+            "/ Obtiene un informe de antiguedad de saldos cruzando todos los clientes del gestor — " +
+            "totales por tramo (al dia / 30-60 / 60-90 / 90+ dias), desglose por espacio y top vencidas. " +
+            "Util para priorizar reclamaciones y listas de cobro de fin de mes.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            ownerUid: z
+                .string()
+                .optional()
+                .describe("Gestor UID to query (defaults to authenticated caller; elevated scope required for other UIDs) / UID del gestor (por defecto el llamante)"),
+        },
+        outputSchema: gestoriaAgingConsolidatedOutput,
+    }, async ({ ownerUid }) => withToolLogging("gestoria_aging_consolidated", async () => {
+        const result = await client.getGestoriaAgingConsolidated({ ownerUid });
+        return {
+            content: [getContent(formatRecord("Aging consolidated", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=gestoria.js.map

package/dist/tools/gestoria.js.map

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

package/dist/tools/hr.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HR (Human Resources) tools for the Frihet MCP server — D4-B megasprint (9 tools).
+ *
+ * Tools:
+ *   1. leave_request_create — create a leave/PTO request
+ *   2. leave_approve        — approve a pending leave (logs decision)
+ *   3. leave_reject         — reject a pending leave with reason
+ *   4. leave_cancel         — cancel own leave request
+ *   5. leave_list           — list leaves (filter: employee, status, period)
+ *   6. attendance_clock_in  — clock in with optional mood + location
+ *   7. attendance_clock_out — close an open time entry
+ *   8. overtime_report      — aggregated overtime by period
+ *   9. anomaly_list         — list HR/operational anomalies
+ *
+ * REST surface: /v1/leaves, /v1/time-entries, /v1/anomalies
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. Tools wired —
+ * 404s propagate as isError until backend ships. TODO: wire to CF
+ * logLeaveDecision callable when REST shell lands.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerHrTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=hr.d.ts.map

package/dist/tools/hr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hr.d.ts","sourceRoot":"","sources":["../../src/tools/hr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkB5D,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAmQ9E"}