@t4dhg/mcp-factorial 7.1.0 → 9.0.0

package/dist/tools/documents.js

@@ -0,0 +1,135 @@
+/**
+ * Documents tool registration
+ */
+import * as z from 'zod';
+import { textResponse, formatToolError } from '../tool-utils.js';
+import { listFolders, getFolder, listDocuments, getDocument, downloadEmployeePayslips, downloadEmployeeDocument, searchEmployees, } from '../api/index.js';
+export function registerDocumentsTool(server) {
+    server.registerTool('factorial_documents', {
+        title: 'FactorialHR Documents',
+        description: 'Document management: list folders, list/get documents, search, download (OAuth2 required for downloads)',
+        inputSchema: {
+            action: z
+                .enum([
+                'list_folders',
+                'get_folder',
+                'list',
+                'get',
+                'get_by_employee',
+                'search',
+                'download_payslips',
+                'download',
+            ])
+                .describe('Action'),
+            id: z.number().optional().describe('Folder/document ID'),
+            employee_id: z.number().optional().describe('Employee ID'),
+            folder_id: z.number().optional().describe('Folder ID filter'),
+            employee_name: z.string().optional().describe('Employee name (for search)'),
+            document_pattern: z.string().optional().describe('Document name pattern (for search)'),
+            output_dir: z.string().optional().describe('Output directory (for downloads)'),
+            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_folders': {
+                    const folders = await listFolders();
+                    const summary = folders.map(f => ({
+                        id: f.id,
+                        name: f.name,
+                    }));
+                    return textResponse(`Found ${folders.length} folders:\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'get_folder': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const folder = await getFolder(args.id);
+                    return textResponse(`Folder details:\n\n${JSON.stringify(folder, null, 2)}`);
+                }
+                case 'list': {
+                    const result = await listDocuments({
+                        folder_id: args.folder_id,
+                        employee_ids: args.employee_id ? [args.employee_id] : undefined,
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    const summary = result.data.map(d => ({
+                        id: d.id,
+                        name: d.filename,
+                        folder_id: d.folder_id,
+                        employee_id: d.employee_id,
+                        mime_type: d.content_type,
+                    }));
+                    return textResponse(`Found ${result.data.length} documents:\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'get': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const doc = await getDocument(args.id);
+                    return textResponse(`Document details:\n\n${JSON.stringify(doc, null, 2)}`);
+                }
+                case 'get_by_employee': {
+                    if (!args.employee_id)
+                        return textResponse('Error: employee_id is required');
+                    const result = await listDocuments({ employee_ids: [args.employee_id] });
+                    const summary = result.data.map(d => ({
+                        id: d.id,
+                        name: d.filename,
+                        folder_id: d.folder_id,
+                        mime_type: d.content_type,
+                    }));
+                    return textResponse(`Found ${result.data.length} documents for employee ${args.employee_id}:\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'search': {
+                    if (!args.employee_name)
+                        return textResponse('Error: employee_name is required');
+                    const employees = await searchEmployees(args.employee_name);
+                    if (employees.length === 0) {
+                        return textResponse(`No employees found matching "${args.employee_name}"`);
+                    }
+                    const allDocs = [];
+                    for (const emp of employees.slice(0, 5)) {
+                        const result = await listDocuments({ employee_ids: [emp.id] });
+                        let docs = result.data;
+                        if (args.document_pattern) {
+                            const pattern = args.document_pattern.toLowerCase();
+                            docs = docs.filter(d => d.filename.toLowerCase().includes(pattern));
+                        }
+                        allDocs.push(...docs.map(d => ({
+                            id: d.id,
+                            name: d.filename,
+                            employee: emp.full_name,
+                            folder_id: d.folder_id,
+                        })));
+                    }
+                    return textResponse(`Found ${allDocs.length} documents:\n\n${JSON.stringify(allDocs, null, 2)}`);
+                }
+                case 'download_payslips': {
+                    if (!args.employee_id)
+                        return textResponse('Error: employee_id is required');
+                    if (!args.output_dir)
+                        return textResponse('Error: output_dir is required for downloads');
+                    const { downloaded, failures } = await downloadEmployeePayslips(args.employee_id, args.output_dir);
+                    const paths = JSON.stringify(downloaded.map(r => r.path), null, 2);
+                    const failureNote = failures.length > 0
+                        ? `\n\n${failures.length} payslip(s) could not be downloaded:\n${failures.join('\n')}`
+                        : '';
+                    return textResponse(`Downloaded ${downloaded.length} payslips:\n\n${paths}${failureNote}`);
+                }
+                case 'download': {
+                    if (!args.id)
+                        return textResponse('Error: id (document ID) is required');
+                    if (!args.output_dir)
+                        return textResponse('Error: output_dir is required for downloads');
+                    const downloadResult = await downloadEmployeeDocument(args.id, args.output_dir);
+                    return textResponse(`Downloaded document to: ${downloadResult.path}`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

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

package/dist/tools/employees.d.ts

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

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

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

package/dist/tools/employees.js

@@ -0,0 +1,125 @@
+/**
+ * Employees 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 { listEmployees, getEmployee, searchEmployees, createEmployee, updateEmployee, terminateEmployee, } from '../api/index.js';
+export function registerEmployeesTool(server) {
+    server.registerTool('factorial_employees', {
+        title: 'FactorialHR Employees',
+        description: 'Manage employees: list, get, search, create, update, terminate',
+        inputSchema: {
+            action: z
+                .enum(['list', 'get', 'search', 'create', 'update', 'terminate'])
+                .describe('Action'),
+            id: z.number().optional().describe('Employee ID (for get/update/terminate)'),
+            query: z.string().optional().describe('Search query (for search)'),
+            team_id: z.number().optional().describe('Filter by team ID (for list)'),
+            location_id: z.number().optional().describe('Filter by location ID (for list)'),
+            page: z.number().optional().default(1).describe('Page number'),
+            limit: z.number().optional().default(100).describe('Items per page'),
+            first_name: z.string().optional().describe('First name'),
+            last_name: z.string().optional().describe('Last name'),
+            email: z.string().optional().describe('Email address'),
+            birthday_on: z.string().optional().describe('Birthday (YYYY-MM-DD)'),
+            gender: z.enum(['male', 'female', 'other']).optional().describe('Gender'),
+            nationality: z.string().optional().describe('Nationality'),
+            manager_id: z.number().optional().describe('Manager ID'),
+            terminated_on: z.string().optional().describe('Termination date (YYYY-MM-DD)'),
+            termination_reason: z.string().optional().describe('Reason for termination'),
+            confirm: z.boolean().optional().describe('Confirm high-risk operation'),
+        },
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list': {
+                    const result = await listEmployees({
+                        team_id: args.team_id,
+                        location_id: args.location_id,
+                        page: args.page,
+                        limit: args.limit,
+                    });
+                    const summary = result.data.map(e => ({
+                        id: e.id,
+                        name: e.full_name,
+                        email: e.email,
+                        identifier: e.identifier || null,
+                        location_id: e.location_id,
+                        manager_id: e.manager_id,
+                        active: e.active,
+                    }));
+                    return textResponse(`Found ${result.data.length} employees (${formatPaginationInfo(result.meta)}):\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'get': {
+                    if (!args.id)
+                        return textResponse('Error: id is required for get action');
+                    const employee = await getEmployee(args.id);
+                    return textResponse(`Employee details:\n\n${JSON.stringify(employee, null, 2)}`);
+                }
+                case 'search': {
+                    if (!args.query)
+                        return textResponse('Error: query is required for search action');
+                    const employees = await searchEmployees(args.query);
+                    if (employees.length === 0) {
+                        return textResponse(`No employees found matching "${args.query}"`);
+                    }
+                    const summary = employees.map(e => ({
+                        id: e.id,
+                        name: e.full_name,
+                        email: e.email,
+                        identifier: e.identifier,
+                    }));
+                    return textResponse(`Found ${employees.length} employees matching "${args.query}":\n\n${JSON.stringify(summary, null, 2)}`);
+                }
+                case 'create': {
+                    if (!args.first_name || !args.last_name || !args.email) {
+                        return textResponse('Error: first_name, last_name, and email are required for create');
+                    }
+                    const employee = await createEmployee({
+                        first_name: args.first_name,
+                        last_name: args.last_name,
+                        email: args.email,
+                        birthday_on: args.birthday_on,
+                        gender: args.gender,
+                        nationality: args.nationality,
+                        manager_id: args.manager_id,
+                        location_id: args.location_id,
+                    });
+                    return textResponse(`Employee created:\n\n${JSON.stringify(employee, null, 2)}`);
+                }
+                case 'update': {
+                    if (!args.id)
+                        return textResponse('Error: id is required for update action');
+                    const employee = await updateEmployee(args.id, {
+                        first_name: args.first_name,
+                        last_name: args.last_name,
+                        email: args.email,
+                        birthday_on: args.birthday_on,
+                        gender: args.gender,
+                        nationality: args.nationality,
+                        manager_id: args.manager_id,
+                        location_id: args.location_id,
+                    });
+                    return textResponse(`Employee updated:\n\n${JSON.stringify(employee, null, 2)}`);
+                }
+                case 'terminate': {
+                    if (!args.id)
+                        return textResponse('Error: id is required for terminate action');
+                    if (!args.terminated_on)
+                        return textResponse('Error: terminated_on is required');
+                    const check = checkConfirmation('terminate_employee', args.confirm);
+                    if (check.needsConfirmation)
+                        return textResponse(check.message);
+                    const employee = await terminateEmployee(args.id, args.terminated_on, args.termination_reason);
+                    return textResponse(`Employee terminated:\n\n${JSON.stringify(employee, null, 2)}`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=employees.js.map

package/dist/tools/employees.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for FactorialHR - Hierarchical Tool Discovery
+ *
+ * v8.0.0 introduces hierarchical tool discovery to reduce context usage.
+ * Instead of 117 individual tools, we now have 14 category-based tools.
+ *
+ * Usage:
+ * 1. Use `factorial_discover` to list available categories and their actions
+ * 2. Use category tools like `factorial_employees` with an `action` parameter
+ *
+ * This reduces context token usage by ~88% while maintaining full functionality.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare const server: McpServer;
+export { server };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAwBtF,QAAA,MAAM,MAAM,WAGV,CAAC;AAgPH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for FactorialHR - Hierarchical Tool Discovery
+ *
+ * v8.0.0 introduces hierarchical tool discovery to reduce context usage.
+ * Instead of 117 individual tools, we now have 14 category-based tools.
+ *
+ * Usage:
+ * 1. Use `factorial_discover` to list available categories and their actions
+ * 2. Use category tools like `factorial_employees` with an `action` parameter
+ *
+ * This reduces context token usage by ~88% while maintaining full functionality.
+ */
+import { loadEnv } from '../config.js';
+// Load environment variables before other imports
+loadEnv();
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import * as z from 'zod';
+import { cache } from '../cache.js';
+import { textResponse } from '../tool-utils.js';
+import { listEmployees, getEmployee, getTeam, listLeaves, listAllowances } from '../api/index.js';
+// Tool registration imports
+import { CATEGORIES } from './shared.js';
+import { registerEmployeesTool } from './employees.js';
+import { registerTeamsTool } from './teams.js';
+import { registerLocationsTool } from './locations.js';
+import { registerContractsTool } from './contracts.js';
+import { registerTimeOffTool } from './time-off.js';
+import { registerAttendanceTool } from './attendance.js';
+import { registerDocumentsTool } from './documents.js';
+import { registerJobCatalogTool } from './job-catalog.js';
+import { registerProjectsTool } from './projects.js';
+import { registerTrainingTool } from './training.js';
+import { registerWorkAreasTool } from './work-areas.js';
+import { registerAtsTool } from './ats.js';
+import { registerPayrollTool } from './payroll.js';
+// Create server instance
+const server = new McpServer({
+    name: 'factorial-hr',
+    version: '8.0.0',
+});
+// ============================================================================
+// Discovery Tool
+// ============================================================================
+server.registerTool('factorial_discover', {
+    title: 'Discover FactorialHR Tools',
+    description: 'List available FactorialHR tool categories and their actions. Use this first to understand what operations are available.',
+    inputSchema: {
+        category: z
+            .string()
+            .optional()
+            .describe('Get details for a specific category (e.g., "employees", "time_off")'),
+    },
+}, ({ category }) => {
+    if (category) {
+        const cat = CATEGORIES[category];
+        if (!cat) {
+            return textResponse(`Unknown category: "${category}". Available: ${Object.keys(CATEGORIES).join(', ')}`);
+        }
+        return textResponse(`## ${cat.name}\n\n${cat.description}\n\n**Available actions:**\n${cat.actions.map(a => `- ${a}`).join('\n')}\n\n**Usage:** factorial_${category}(action: "${cat.actions[0]}", ...)`);
+    }
+    const categoryList = Object.entries(CATEGORIES)
+        .map(([key, cat]) => `- **factorial_${key}**: ${cat.description} (${cat.actions.length} actions)`)
+        .join('\n');
+    return textResponse(`# FactorialHR Tool Categories\n\nUse \`factorial_discover(category: "name")\` for action details.\n\n${categoryList}\n\n**Total: 14 tools covering 117 operations**`);
+});
+// ============================================================================
+// Register All Domain Tools
+// ============================================================================
+registerEmployeesTool(server);
+registerTeamsTool(server);
+registerLocationsTool(server);
+registerContractsTool(server);
+registerTimeOffTool(server);
+registerAttendanceTool(server);
+registerDocumentsTool(server);
+registerJobCatalogTool(server);
+registerProjectsTool(server);
+registerTrainingTool(server);
+registerWorkAreasTool(server);
+registerAtsTool(server);
+registerPayrollTool(server);
+// ============================================================================
+// Resources
+// ============================================================================
+// Organization chart resource
+server.registerResource('org_chart', 'factorial://org-chart', {
+    description: 'View the organizational hierarchy of employees and their managers',
+    mimeType: 'application/json',
+}, async () => {
+    const result = await listEmployees({ page: 1, limit: 500 });
+    const employees = result.data;
+    const buildOrgChart = () => {
+        const employeeMap = new Map();
+        employees.forEach(e => {
+            employeeMap.set(e.id, {
+                id: e.id,
+                name: e.full_name,
+                email: e.email,
+                manager_id: e.manager_id,
+                reports: [],
+            });
+        });
+        const roots = [];
+        employeeMap.forEach(node => {
+            if (node.manager_id && employeeMap.has(node.manager_id)) {
+                employeeMap.get(node.manager_id).reports.push(node);
+            }
+            else {
+                roots.push(node);
+            }
+        });
+        return roots;
+    };
+    return {
+        contents: [
+            {
+                uri: 'factorial://org-chart',
+                mimeType: 'application/json',
+                text: JSON.stringify(buildOrgChart(), null, 2),
+            },
+        ],
+    };
+});
+// Employee directory resource template
+server.registerResource('employee_directory', new ResourceTemplate('factorial://employees/{id}', {
+    list: async () => {
+        const result = await listEmployees({ page: 1, limit: 100 });
+        return {
+            resources: result.data.map(e => ({
+                name: e.full_name || `Employee ${e.id}`,
+                uri: `factorial://employees/${e.id}`,
+                description: `Employee: ${e.full_name} (${e.email})`,
+                mimeType: 'application/json',
+            })),
+        };
+    },
+}), {
+    description: 'Get detailed information about an employee',
+    mimeType: 'application/json',
+}, async (uri, variables) => {
+    const employee = await getEmployee(Number(variables.id));
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(employee, null, 2),
+            },
+        ],
+    };
+});
+// ============================================================================
+// Prompts
+// ============================================================================
+server.registerPrompt('summarize_team', {
+    description: 'Generate a summary of a team including its members and their roles',
+    argsSchema: {
+        team_id: z.string().describe('The team ID to summarize'),
+    },
+}, async ({ team_id }) => {
+    const team = await getTeam(Number(team_id));
+    const members = team.employee_ids || [];
+    const employeeDetails = await Promise.all(members.map(id => getEmployee(Number(id))));
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Please summarize this team:\n\nTeam: ${team.name}\nDescription: ${team.description || 'N/A'}\nLead IDs: ${team.lead_ids?.join(', ') || 'None'}\n\nMembers (${members.length}):\n${employeeDetails.map(e => `- ${e.full_name} (${e.email})`).join('\n')}`,
+                },
+            },
+        ],
+    };
+});
+server.registerPrompt('time_off_report', {
+    description: 'Generate a time off report for an employee',
+    argsSchema: {
+        employee_id: z.string().describe('The employee ID'),
+    },
+}, async ({ employee_id }) => {
+    const employee = await getEmployee(Number(employee_id));
+    const leaves = await listLeaves({ employee_id: Number(employee_id) });
+    const allowances = await listAllowances({ employee_id: Number(employee_id) });
+    return {
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Generate a time off report for ${employee.full_name}:\n\nAllowances:\n${JSON.stringify(allowances.data, null, 2)}\n\nRecent Leaves:\n${JSON.stringify(leaves.data.slice(0, 10), null, 2)}`,
+                },
+            },
+        ],
+    };
+});
+// ============================================================================
+// Start Server
+// ============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Clear cache on shutdown
+    process.on('SIGINT', () => {
+        cache.clear();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        cache.clear();
+        process.exit(0);
+    });
+}
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+// Export server for testing
+export { server };
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

package/dist/tools/job-catalog.d.ts

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

package/dist/tools/job-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/job-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAuCvD"}

package/dist/tools/job-catalog.js

@@ -0,0 +1,39 @@
+/**
+ * Job Catalog tool registration
+ */
+import * as z from 'zod';
+import { textResponse, formatToolError } from '../tool-utils.js';
+import { listJobRoles, getJobRole, listJobLevels } from '../api/index.js';
+export function registerJobCatalogTool(server) {
+    server.registerTool('factorial_job_catalog', {
+        title: 'FactorialHR Job Catalog',
+        description: 'View job roles and levels',
+        inputSchema: {
+            action: z.enum(['list_roles', 'get_role', 'list_levels']).describe('Action'),
+            id: z.number().optional().describe('Job role ID (for get_role)'),
+        },
+    }, async (args) => {
+        try {
+            switch (args.action) {
+                case 'list_roles': {
+                    const roles = await listJobRoles();
+                    return textResponse(`Found ${roles.length} job roles:\n\n${JSON.stringify(roles, null, 2)}`);
+                }
+                case 'get_role': {
+                    if (!args.id)
+                        return textResponse('Error: id is required');
+                    const role = await getJobRole(args.id);
+                    return textResponse(`Job role details:\n\n${JSON.stringify(role, null, 2)}`);
+                }
+                case 'list_levels': {
+                    const levels = await listJobLevels();
+                    return textResponse(`Found ${levels.length} job levels:\n\n${JSON.stringify(levels, null, 2)}`);
+                }
+            }
+        }
+        catch (error) {
+            return formatToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=job-catalog.js.map

package/dist/tools/job-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-catalog.js","sourceRoot":"","sources":["../../src/tools/job-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,2BAA2B;QACxC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACjE;KACF,EACD,KAAK,EAAC,IAAI,EAAC,EAAE;QACX,IAAI,CAAC;YACH,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpB,KAAK,YAAY,CAAC,CAAC,CAAC;oBAClB,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;oBACnC,OAAO,YAAY,CACjB,SAAS,KAAK,CAAC,MAAM,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACxE,CAAC;gBACJ,CAAC;gBAED,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,IAAI,CAAC,IAAI,CAAC,EAAE;wBAAE,OAAO,YAAY,CAAC,uBAAuB,CAAC,CAAC;oBAC3D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACvC,OAAO,YAAY,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBAED,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;oBACrC,OAAO,YAAY,CACjB,SAAS,MAAM,CAAC,MAAM,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC3E,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/locations.d.ts

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

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

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