@t4dhg/mcp-factorial 7.0.1 → 8.2.0

package/dist/tools/locations.js

@@ -0,0 +1,93 @@
+/**
+ * Locations tool registration
+ */
+import * as z from 'zod';
+import { checkConfirmation } from './shared.js';
+import { textResponse, formatToolError } from '../tool-utils.js';
+import { formatPaginationInfo } from '../pagination.js';
+import { listLocations, getLocation, createLocation, updateLocation, deleteLocation, } from '../api/index.js';
+export function registerLocationsTool(server) {
+    server.registerTool('factorial_locations', {
+        title: 'FactorialHR Locations',
+        description: 'Manage locations: list, get, create, update, delete',
+        inputSchema: {
+            action: z.enum(['list', 'get', 'create', 'update', 'delete']).describe('Action'),
+            id: z.number().optional().describe('Location ID (for get/update/delete)'),
+            page: z.number().optional().default(1).describe('Page number'),
+            limit: z.number().optional().default(100).describe('Items per page'),
+            name: z.string().optional().describe('Location name'),
+            address_line_1: z.string().optional().describe('Address line 1'),
+            address_line_2: z.string().optional().describe('Address line 2'),
+            city: z.string().optional().describe('City'),
+            state: z.string().optional().describe('State/province'),
+            postal_code: z.string().optional().describe('Postal code'),
+            country: z.string().optional().describe('Country code (e.g., ES, US)'),
+            phone_number: z.string().optional().describe('Phone number'),
+            confirm: z.boolean().optional().describe('Confirm delete'),
+        },
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list': {
+                    const result = await listLocations({ page: args.page, limit: args.limit });
+                    const summary = result.data.map(l => ({
+                        id: l.id,
+                        name: l.name,
+                        city: l.city,
+                        country: l.country,
+                    }));
+                    return textResponse(`Found ${result.data.length} locations (${formatPaginationInfo(result.meta)}):\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'get': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const location = await getLocation(args.id);
+                    return textResponse(`Location details:\n\n${JSON.stringify(location, null, 2)}`);
+                }
+                case 'create': {
+                    if (!args.name)
+                        return textResponse('Error: name is required');
+                    const location = await createLocation({
+                        name: args.name,
+                        address_line_1: args.address_line_1,
+                        address_line_2: args.address_line_2,
+                        city: args.city,
+                        state: args.state,
+                        postal_code: args.postal_code,
+                        country: args.country,
+                        phone_number: args.phone_number,
+                    });
+                    return textResponse(`Location created:\n\n${JSON.stringify(location, null, 2)}`);
+                }
+                case 'update': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const location = await updateLocation(args.id, {
+                        name: args.name,
+                        address_line_1: args.address_line_1,
+                        address_line_2: args.address_line_2,
+                        city: args.city,
+                        state: args.state,
+                        postal_code: args.postal_code,
+                        country: args.country,
+                        phone_number: args.phone_number,
+                    });
+                    return textResponse(`Location updated:\n\n${JSON.stringify(location, null, 2)}`);
+                }
+                case 'delete': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const check = checkConfirmation('delete_location', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    await deleteLocation(args.id);
+                    return textResponse(`Location ${args.id} deleted successfully.`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=locations.js.map

package/dist/tools/locations.js.map

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

package/dist/tools/payroll.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Payroll tool registration (Read-only)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPayrollTool(server: McpServer): void;
+//# sourceMappingURL=payroll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payroll.d.ts","sourceRoot":"","sources":["../../src/tools/payroll.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA+EpD"}

package/dist/tools/payroll.js

@@ -0,0 +1,76 @@
+/**
+ * Payroll tool registration (Read-only)
+ */
+import * as z from 'zod';
+import { textResponse, formatToolError } from '../tool-utils.js';
+import { listPayrollSupplements, getPayrollSupplement, listTaxIdentifiers, getTaxIdentifier, listFamilySituations, getFamilySituation, } from '../api/index.js';
+export function registerPayrollTool(server) {
+    server.registerTool('factorial_payroll', {
+        title: 'FactorialHR Payroll',
+        description: 'View payroll data: supplements, tax identifiers, family situations (read-only)',
+        inputSchema: {
+            action: z
+                .enum([
+                'list_supplements',
+                'get_supplement',
+                'list_tax_ids',
+                'get_tax_id',
+                'list_family',
+                'get_family',
+            ])
+                .describe('Action'),
+            id: z.number().optional().describe('Item ID'),
+            employee_id: z.number().optional().describe('Employee ID filter'),
+            page: z.number().optional().default(1).describe('Page number'),
+            limit: z.number().optional().default(100).describe('Items per page'),
+        },
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list_supplements': {
+                    const result = await listPayrollSupplements(args.employee_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} payroll supplements:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'get_supplement': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const supplement = await getPayrollSupplement(args.id);
+                    return textResponse(`Payroll supplement:\n\n${JSON.stringify(supplement, null, 2)}`);
+                }
+                case 'list_tax_ids': {
+                    const result = await listTaxIdentifiers(args.employee_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} tax identifiers:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'get_tax_id': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const taxId = await getTaxIdentifier(args.id);
+                    return textResponse(`Tax identifier:\n\n${JSON.stringify(taxId, null, 2)}`);
+                }
+                case 'list_family': {
+                    const result = await listFamilySituations(args.employee_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} family situations:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'get_family': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const family = await getFamilySituation(args.id);
+                    return textResponse(`Family situation:\n\n${JSON.stringify(family, null, 2)}`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=payroll.js.map

package/dist/tools/payroll.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Projects tool registration
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectsTool(server: McpServer): void;
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QA+MrD"}

package/dist/tools/projects.js

@@ -0,0 +1,203 @@
+/**
+ * Projects tool registration
+ */
+import * as z from 'zod';
+import { checkConfirmation } from './shared.js';
+import { textResponse, formatToolError } from '../tool-utils.js';
+import { formatPaginationInfo } from '../pagination.js';
+import { listProjects, getProject, listProjectTasks, listProjectWorkers, listTimeRecords, createProject, updateProject, deleteProject, createProjectTask, updateProjectTask, deleteProjectTask, assignProjectWorker, removeProjectWorker, createTimeRecord, updateTimeRecord, deleteTimeRecord, } from '../api/index.js';
+export function registerProjectsTool(server) {
+    server.registerTool('factorial_projects', {
+        title: 'FactorialHR Projects',
+        description: 'Project management: projects, tasks, workers, time records. Full CRUD operations.',
+        inputSchema: {
+            action: z
+                .enum([
+                'list',
+                'get',
+                'create',
+                'update',
+                'delete',
+                'list_tasks',
+                'create_task',
+                'update_task',
+                'delete_task',
+                'list_workers',
+                'assign_worker',
+                'remove_worker',
+                'list_time',
+                'create_time',
+                'update_time',
+                'delete_time',
+            ])
+                .describe('Action'),
+            id: z.number().optional().describe('Project/task/worker/time record ID'),
+            project_id: z.number().optional().describe('Project ID'),
+            employee_id: z.number().optional().describe('Employee ID'),
+            project_worker_id: z.number().optional().describe('Project worker ID'),
+            name: z.string().optional().describe('Name'),
+            description: z.string().optional().describe('Description'),
+            status: z.string().optional().describe('Status'),
+            starts_on: z.string().optional().describe('Start date (YYYY-MM-DD)'),
+            ends_on: z.string().optional().describe('End date (YYYY-MM-DD)'),
+            minutes: z.number().optional().describe('Time in minutes'),
+            date: z.string().optional().describe('Date (YYYY-MM-DD)'),
+            page: z.number().optional().default(1).describe('Page number'),
+            limit: z.number().optional().default(100).describe('Items per page'),
+            confirm: z.boolean().optional().describe('Confirm delete'),
+        },
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list': {
+                    const result = await listProjects({ page: args.page, limit: args.limit });
+                    const summary = result.data.map(p => ({
+                        id: p.id,
+                        name: p.name,
+                        status: p.status,
+                    }));
+                    return textResponse(`Found ${result.data.length} projects (${formatPaginationInfo(result.meta)}):\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'get': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const project = await getProject(args.id);
+                    return textResponse(`Project details:\n\n${JSON.stringify(project, null, 2)}`);
+                }
+                case 'create': {
+                    if (!args.name)
+                        return textResponse('Error: name is required');
+                    const project = await createProject({
+                        name: args.name,
+                        description: args.description,
+                    });
+                    return textResponse(`Project created:\n\n${JSON.stringify(project, null, 2)}`);
+                }
+                case 'update': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const projectStatus = args.status;
+                    const project = await updateProject(args.id, {
+                        name: args.name,
+                        description: args.description,
+                        status: projectStatus,
+                    });
+                    return textResponse(`Project updated:\n\n${JSON.stringify(project, null, 2)}`);
+                }
+                case 'delete': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const check = checkConfirmation('delete_project', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    await deleteProject(args.id);
+                    return textResponse(`Project ${args.id} deleted successfully.`);
+                }
+                case 'list_tasks': {
+                    const result = await listProjectTasks(args.project_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} tasks:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'create_task': {
+                    if (!args.project_id || !args.name) {
+                        return textResponse('Error: project_id and name are required');
+                    }
+                    const task = await createProjectTask({
+                        project_id: args.project_id,
+                        name: args.name,
+                        description: args.description,
+                    });
+                    return textResponse(`Task created:\n\n${JSON.stringify(task, null, 2)}`);
+                }
+                case 'update_task': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const task = await updateProjectTask(args.id, {
+                        name: args.name,
+                        description: args.description,
+                    });
+                    return textResponse(`Task updated:\n\n${JSON.stringify(task, null, 2)}`);
+                }
+                case 'delete_task': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const check = checkConfirmation('delete_task', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    await deleteProjectTask(args.id);
+                    return textResponse(`Task ${args.id} deleted successfully.`);
+                }
+                case 'list_workers': {
+                    const result = await listProjectWorkers(args.project_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} project workers:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'assign_worker': {
+                    if (!args.project_id || !args.employee_id) {
+                        return textResponse('Error: project_id and employee_id are required');
+                    }
+                    const worker = await assignProjectWorker({
+                        project_id: args.project_id,
+                        employee_id: args.employee_id,
+                    });
+                    return textResponse(`Worker assigned:\n\n${JSON.stringify(worker, null, 2)}`);
+                }
+                case 'remove_worker': {
+                    if (!args.id)
+                        return textResponse('Error: id (project_worker_id) is required');
+                    const check = checkConfirmation('remove_project_worker', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    await removeProjectWorker(args.id);
+                    return textResponse(`Worker ${args.id} removed from project.`);
+                }
+                case 'list_time': {
+                    const result = await listTimeRecords(args.project_worker_id, {
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    return textResponse(`Found ${result.data.length} time records:\n\n${JSON.stringify(result.data, null, 2)}`);
+                }
+                case 'create_time': {
+                    if (!args.project_worker_id || !args.minutes || !args.date) {
+                        return textResponse('Error: project_worker_id, minutes, and date are required');
+                    }
+                    const record = await createTimeRecord({
+                        project_worker_id: args.project_worker_id,
+                        minutes: args.minutes,
+                        date: args.date,
+                        description: args.description,
+                    });
+                    return textResponse(`Time record created:\n\n${JSON.stringify(record, null, 2)}`);
+                }
+                case 'update_time': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const record = await updateTimeRecord(args.id, {
+                        minutes: args.minutes,
+                        date: args.date,
+                        description: args.description,
+                    });
+                    return textResponse(`Time record updated:\n\n${JSON.stringify(record, null, 2)}`);
+                }
+                case 'delete_time': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const check = checkConfirmation('delete_time', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    await deleteTimeRecord(args.id);
+                    return textResponse(`Time record ${args.id} deleted successfully.`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/shared.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shared tool utilities and constants
+ */
+import { type OperationName } from '../write-safety.js';
+/**
+ * Category definitions for tool discovery
+ */
+export declare const CATEGORIES: {
+    readonly employees: {
+        readonly name: "Employees";
+        readonly description: "Manage employee records";
+        readonly actions: readonly ["list", "get", "search", "create", "update", "terminate"];
+    };
+    readonly teams: {
+        readonly name: "Teams";
+        readonly description: "Manage team structure";
+        readonly actions: readonly ["list", "get", "create", "update", "delete"];
+    };
+    readonly locations: {
+        readonly name: "Locations";
+        readonly description: "Manage company locations";
+        readonly actions: readonly ["list", "get", "create", "update", "delete"];
+    };
+    readonly contracts: {
+        readonly name: "Contracts";
+        readonly description: "Employee contract and salary data";
+        readonly actions: readonly ["list", "get_with_employee", "by_job_role", "by_job_level"];
+    };
+    readonly time_off: {
+        readonly name: "Time Off";
+        readonly description: "Leave requests and allowances";
+        readonly actions: readonly ["list_leaves", "get_leave", "list_types", "get_type", "list_allowances", "create", "update", "cancel", "approve", "reject"];
+    };
+    readonly attendance: {
+        readonly name: "Attendance";
+        readonly description: "Clock in/out and shift records";
+        readonly actions: readonly ["list", "get", "create", "update", "delete"];
+    };
+    readonly documents: {
+        readonly name: "Documents";
+        readonly description: "Document management and downloads";
+        readonly actions: readonly ["list_folders", "get_folder", "list", "get", "get_by_employee", "search", "download_payslips", "download"];
+    };
+    readonly job_catalog: {
+        readonly name: "Job Catalog";
+        readonly description: "Job roles and levels";
+        readonly actions: readonly ["list_roles", "get_role", "list_levels"];
+    };
+    readonly projects: {
+        readonly name: "Projects";
+        readonly description: "Project management with tasks, workers, and time tracking";
+        readonly actions: readonly ["list", "get", "create", "update", "delete", "list_tasks", "create_task", "update_task", "delete_task", "list_workers", "assign_worker", "remove_worker", "list_time", "create_time", "update_time", "delete_time"];
+    };
+    readonly training: {
+        readonly name: "Training";
+        readonly description: "Training programs, sessions, and enrollments";
+        readonly actions: readonly ["list", "get", "create", "update", "delete", "list_sessions", "create_session", "update_session", "delete_session", "list_enrollments", "enroll", "unenroll"];
+    };
+    readonly work_areas: {
+        readonly name: "Work Areas";
+        readonly description: "Work areas within locations";
+        readonly actions: readonly ["list", "get", "create", "update", "archive", "unarchive"];
+    };
+    readonly ats: {
+        readonly name: "ATS (Recruiting)";
+        readonly description: "Applicant tracking: job postings, candidates, applications";
+        readonly actions: readonly ["list_postings", "get_posting", "create_posting", "update_posting", "delete_posting", "list_candidates", "get_candidate", "create_candidate", "update_candidate", "delete_candidate", "list_applications", "get_application", "create_application", "update_application", "delete_application", "advance_application", "list_stages"];
+    };
+    readonly payroll: {
+        readonly name: "Payroll";
+        readonly description: "Payroll supplements, tax IDs, family situations (read-only)";
+        readonly actions: readonly ["list_supplements", "get_supplement", "list_tax_ids", "get_tax_id", "list_family", "get_family"];
+    };
+};
+/**
+ * Check if confirmation is required for a high-risk operation
+ */
+export declare function checkConfirmation(operationName: OperationName, confirm?: boolean): {
+    needsConfirmation: true;
+    message: string;
+} | {
+    needsConfirmation: false;
+};
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/F;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Ib,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,OAAO,GAChB;IAAE,iBAAiB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,iBAAiB,EAAE,KAAK,CAAA;CAAE,CAU7E"}