@frihet/mcp-server 1.6.1 → 1.9.0-beta.1

package/dist/tools/time.js

@@ -0,0 +1,134 @@
+/**
+ * Time tracking tools for the Frihet MCP server — Wave 6 (4 tools).
+ *
+ * Tools:
+ *   1. list_time_entries  — list timesheets (filter: user, project, date range)
+ *   2. create_time_entry  — log time (project, hours, description, billable flag)
+ *   3. update_time_entry  — modify existing time entry
+ *   4. delete_time_entry  — soft delete (Trust Area: requires confirm)
+ *
+ * REST surface: /v1/time/entries
+ *
+ * NOTE: ERP backend endpoints /v1/time/* are planned. Tools are wired
+ * and will surface 404 errors until the backend ships.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, paginatedOutput, deleteResultOutput, timeEntryItemOutput, } from "./shared.js";
+export function registerTimeTools(server, client) {
+    // -- list_time_entries --
+    server.registerTool("list_time_entries", {
+        title: "List Time Entries",
+        description: "List time tracking entries with optional filters. " +
+            "Filter by user, project, date range, or billable status. " +
+            "Useful for generating timesheets, billing reports, and project cost analysis. " +
+            "/ Lista entradas de tiempo con filtros opcionales. " +
+            "Filtra por usuario, proyecto, rango de fechas o facturabilidad. " +
+            "Util para partes de trabajo, informes de facturacion y analisis de costes por proyecto.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            userId: z.string().optional().describe("Filter by user ID / Filtrar por ID de usuario"),
+            projectId: z.string().optional().describe("Filter by project ID / Filtrar por ID de proyecto"),
+            from: z.string().optional().describe("Start date ISO 8601 (YYYY-MM-DD) / Fecha inicio"),
+            to: z.string().optional().describe("End date ISO 8601 (YYYY-MM-DD) / Fecha fin"),
+            billable: z.boolean().optional().describe("Filter by billable flag / Filtrar por facturabilidad"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+            after: z.string().optional().describe("Cursor for cursor-based pagination / Cursor para paginacion"),
+        },
+        outputSchema: paginatedOutput(timeEntryItemOutput),
+    }, async ({ userId, projectId, from, to, billable, limit, offset, after }) => withToolLogging("list_time_entries", async () => {
+        const result = await client.listTimeEntries({ userId, projectId, from, to, billable, limit, offset, after });
+        return {
+            content: [listContent(formatPaginatedResponse("time_entries", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- create_time_entry --
+    server.registerTool("create_time_entry", {
+        title: "Create Time Entry",
+        description: "Log a time entry for a project. " +
+            "Requires projectId, hours (decimal), and date. " +
+            "Mark as billable=true to include in client invoicing. " +
+            "Example: projectId='proj_abc', hours=2.5, description='Frontend review', billable=true, date='2026-05-10' " +
+            "/ Registra una entrada de tiempo para un proyecto. " +
+            "Requiere projectId, horas (decimal) y fecha. " +
+            "Marca billable=true para incluirlo en la facturacion al cliente.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            projectId: z.string().describe("Project ID / ID del proyecto"),
+            hours: z.number().min(0.01).describe("Hours worked (decimal, e.g. 1.5) / Horas trabajadas (decimal)"),
+            date: z.string().describe("Work date ISO 8601 (YYYY-MM-DD) / Fecha del trabajo"),
+            description: z.string().optional().describe("Description of work done / Descripcion del trabajo realizado"),
+            billable: z.boolean().optional().describe("Whether hours are billable to client (default true) / Si las horas son facturables"),
+            userId: z.string().optional().describe("User ID (defaults to API key owner) / ID del usuario (por defecto el propietario de la API key)"),
+        },
+        outputSchema: timeEntryItemOutput,
+    }, async ({ projectId, hours, date, description, billable, userId }) => withToolLogging("create_time_entry", async () => {
+        const result = await client.createTimeEntry({ projectId, hours, date, description, billable, userId });
+        return {
+            content: [mutateContent(formatRecord("Time entry created", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- update_time_entry --
+    server.registerTool("update_time_entry", {
+        title: "Update Time Entry",
+        description: "Update an existing time entry using PATCH semantics. Only provided fields are changed. " +
+            "Example: id='te_abc123', hours=3.0, description='Frontend review + testing' " +
+            "/ Actualiza una entrada de tiempo existente. Solo se modifican los campos proporcionados.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Time entry ID / ID de la entrada de tiempo"),
+            hours: z.number().min(0.01).optional().describe("Updated hours / Horas actualizadas"),
+            date: z.string().optional().describe("Updated date ISO 8601 / Fecha actualizada"),
+            description: z.string().optional().describe("Updated description / Descripcion actualizada"),
+            billable: z.boolean().optional().describe("Updated billable flag / Facturabilidad actualizada"),
+            projectId: z.string().optional().describe("Reassign to different project / Reasignar a otro proyecto"),
+        },
+        outputSchema: timeEntryItemOutput,
+    }, async ({ id, ...data }) => withToolLogging("update_time_entry", async () => {
+        const result = await client.updateTimeEntry(id, data);
+        return {
+            content: [mutateContent(formatRecord("Time entry updated", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- delete_time_entry --
+    server.registerTool("delete_time_entry", {
+        title: "Delete Time Entry",
+        description: "Soft-delete a time entry by ID. " +
+            "Requires confirm=true to prevent accidental deletion. " +
+            "Deleted entries are excluded from billing reports but retained for audit. " +
+            "/ Elimina (soft-delete) una entrada de tiempo por su ID. " +
+            "Requiere confirm=true para evitar eliminaciones accidentales. " +
+            "Las entradas eliminadas se excluyen de informes de facturacion pero se retienen en auditoria.",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+        inputSchema: {
+            id: z.string().describe("Time entry ID / ID de la entrada de tiempo"),
+            confirm: z
+                .boolean()
+                .describe("Must be true to confirm deletion / Debe ser true para confirmar la eliminacion"),
+        },
+        outputSchema: deleteResultOutput,
+    }, async ({ id, confirm }) => withToolLogging("delete_time_entry", async () => {
+        if (!confirm) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: confirm=true is required to delete a time entry. " +
+                            "Deleted entries affect billing reports. Set confirm=true to proceed. / " +
+                            "Se requiere confirm=true para eliminar una entrada de tiempo.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        await client.deleteTimeEntry(id);
+        return {
+            content: [mutateContent(`Time entry ${id} deleted (soft). / Entrada de tiempo ${id} eliminada.`)],
+            structuredContent: { success: true, id },
+        };
+    }));
+}
+//# sourceMappingURL=time.js.map

package/dist/tools/time.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@frihet/mcp-server",
-  "version": "1.6.1",
-  "description": "AI-native MCP server for business management — invoices, expenses, deposits, clients, products, quotes, webhooks, CRM. 62 tools. Remote endpoint at mcp.frihet.io (zero install). Works with Claude, Cursor, Windsurf, Cline.",
+  "version": "1.9.0-beta.1",
+  "description": "AI-native MCP server for business management — invoices, expenses, deposits, clients, products, quotes, webhooks, CRM, e-invoicing, vacation rentals, POS, banking, fiscal (Modelo 303/130/390/180/347, VeriFactu, TicketBAI), time tracking, recurring invoices. 94 tools. Remote endpoint at mcp.frihet.io (zero install). Works with Claude, Cursor, Windsurf, Cline.",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
@@ -9,6 +9,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "test": "npm run build && node --test dist/__tests__/einvoice-tools.test.js dist/__tests__/stay-tools.test.js dist/__tests__/pos-tools.test.js dist/__tests__/banking-tools.test.js dist/__tests__/fiscal-tools.test.js dist/__tests__/time-tools.test.js dist/__tests__/recurring-tools.test.js",
     "start": "node dist/index.js",
     "postinstall": "node scripts/postinstall.js || true",
     "prepublishOnly": "npm run build"