@assetlab/mcp-server 1.0.3 → 1.2.0

package/dist/tools.js

@@ -1,14 +1,15 @@
 /**
  * MCP tool registrations for AssetLab.
  *
- * All tools are read-only. They map to GET endpoints
- * on the AssetLab API Gateway.
+ * Tools map to endpoints on the AssetLab API Gateway.
+ * Write tools require API keys with the appropriate scope (e.g. parts:write).
  */
 import { z } from 'zod';
-// Shared schema fragments
+// Shared schema fragments — pagination is handled automatically via listAll()
+// but still exposed for direct API users who want manual control
 const paginationSchema = {
-    page: z.number().int().min(1).optional().describe('Page number (default: 1)'),
-    per_page: z.number().int().min(1).max(100).optional().describe('Items per page (default: 25, max: 100)'),
+    page: z.number().int().min(1).optional().describe('Page number (default: all pages fetched automatically)'),
+    per_page: z.number().int().min(1).max(1000).optional().describe('Items per page (default: 1000, max: 1000). All pages are fetched automatically.'),
 };
 const searchSchema = {
     search: z.string().max(200).optional().describe('Search by name'),
@@ -21,6 +22,17 @@ function formatError(err) {
     const message = err instanceof Error ? err.message : String(err);
     return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
 }
+/**
+ * Smart list: if user explicitly passes page/per_page, use single-page list().
+ * Otherwise, auto-paginate with listAll() to return complete data.
+ */
+async function smartList(client, resource, params) {
+    const { page, per_page, ...filters } = params;
+    if (page !== undefined || per_page !== undefined) {
+        return client.list(resource, params);
+    }
+    return client.listAll(resource, filters);
+}
 export function registerTools(server, client) {
     // ============================================================
     // Assets
@@ -33,7 +45,7 @@ export function registerTools(server, client) {
         system_id: z.string().uuid().optional().describe('Filter by system ID'),
     }, async (params) => {
         try {
-            const result = await client.list('assets', params);
+            const result = await smartList(client, 'assets', params);
             return formatResult(result);
         }
         catch (err) {
@@ -61,7 +73,7 @@ export function registerTools(server, client) {
         site_id: z.string().uuid().optional().describe('Filter by site ID'),
     }, async (params) => {
         try {
-            const result = await client.list('work-orders', params);
+            const result = await smartList(client, 'work-orders', params);
             return formatResult(result);
         }
         catch (err) {
@@ -86,7 +98,7 @@ export function registerTools(server, client) {
         city: z.string().max(100).optional().describe('Filter by city name'),
     }, async (params) => {
         try {
-            const result = await client.list('sites', params);
+            const result = await smartList(client, 'sites', params);
             return formatResult(result);
         }
         catch (err) {
@@ -111,7 +123,7 @@ export function registerTools(server, client) {
         site_id: z.string().uuid().optional().describe('Filter by site ID'),
     }, async (params) => {
         try {
-            const result = await client.list('buildings', params);
+            const result = await smartList(client, 'buildings', params);
             return formatResult(result);
         }
         catch (err) {
@@ -127,7 +139,7 @@ export function registerTools(server, client) {
         building_id: z.string().uuid().optional().describe('Filter by building ID'),
     }, async (params) => {
         try {
-            const result = await client.list('locations', params);
+            const result = await smartList(client, 'locations', params);
             return formatResult(result);
         }
         catch (err) {
@@ -143,7 +155,7 @@ export function registerTools(server, client) {
         system_group_id: z.string().uuid().optional().describe('Filter by system group ID'),
     }, async (params) => {
         try {
-            const result = await client.list('systems', params);
+            const result = await smartList(client, 'systems', params);
             return formatResult(result);
         }
         catch (err) {
@@ -156,7 +168,7 @@ export function registerTools(server, client) {
         system_class_id: z.string().uuid().optional().describe('Filter by system class ID'),
     }, async (params) => {
         try {
-            const result = await client.list('system-groups', params);
+            const result = await smartList(client, 'system-groups', params);
             return formatResult(result);
         }
         catch (err) {
@@ -168,7 +180,7 @@ export function registerTools(server, client) {
         ...paginationSchema,
     }, async (params) => {
         try {
-            const result = await client.list('system-classes', params);
+            const result = await smartList(client, 'system-classes', params);
             return formatResult(result);
         }
         catch (err) {
@@ -186,7 +198,7 @@ export function registerTools(server, client) {
         frequency: z.string().optional().describe('Filter by frequency: DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUAL, ANNUAL, FIVE_YEARLY, CUSTOM'),
     }, async (params) => {
         try {
-            const result = await client.list('pm-schedules', params);
+            const result = await smartList(client, 'pm-schedules', params);
             return formatResult(result);
         }
         catch (err) {
@@ -210,7 +222,7 @@ export function registerTools(server, client) {
         ...paginationSchema,
     }, async (params) => {
         try {
-            const result = await client.list('pm-templates', params);
+            const result = await smartList(client, 'pm-templates', params);
             return formatResult(result);
         }
         catch (err) {
@@ -227,7 +239,7 @@ export function registerTools(server, client) {
         health_status: z.string().optional().describe('Filter by health: on_track, at_risk, delayed, critical'),
     }, async (params) => {
         try {
-            const result = await client.list('projects', params);
+            const result = await smartList(client, 'projects', params);
             return formatResult(result);
         }
         catch (err) {
@@ -252,7 +264,7 @@ export function registerTools(server, client) {
         category: z.string().max(100).optional().describe('Filter by contract category'),
     }, async (params) => {
         try {
-            const result = await client.list('contracts', params);
+            const result = await smartList(client, 'contracts', params);
             return formatResult(result);
         }
         catch (err) {
@@ -269,7 +281,7 @@ export function registerTools(server, client) {
         system_id: z.string().uuid().optional().describe('Filter by system ID'),
     }, async (params) => {
         try {
-            const result = await client.list('compliance', params);
+            const result = await smartList(client, 'compliance', params);
             return formatResult(result);
         }
         catch (err) {
@@ -286,6 +298,324 @@ export function registerTools(server, client) {
         }
     });
     // ============================================================
+    // Parts
+    // ============================================================
+    server.tool('list_parts', 'List parts/inventory items. Filter by site or category.', {
+        ...searchSchema,
+        ...paginationSchema,
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+        category: z.string().max(100).optional().describe('Filter by category (partial match)'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'parts', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_part', 'Get detailed information about a specific part including location and stock levels.', { id: uuidParam.describe('Part ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('parts', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('create_part', 'Create a new part/inventory item. Requires parts:write scope.', {
+        name: z.string().min(1).max(500).describe('Part name (required)'),
+        part_number: z.string().max(200).optional().describe('Part number / SKU'),
+        category: z.string().max(200).optional().describe('Category label'),
+        supplier: z.string().max(500).optional().describe('Supplier name'),
+        cost: z.number().min(0).optional().describe('Unit cost'),
+        quantity: z.number().int().min(0).max(10_000_000).optional().describe('Current stock quantity'),
+        desired_quantity: z.number().int().min(0).max(10_000_000).optional().describe('Target / reorder quantity'),
+        specific_location: z.string().max(500).optional().describe('Storage location description'),
+        site_id: z.string().uuid().optional().describe('Site ID'),
+        building_id: z.string().uuid().optional().describe('Building ID'),
+        location_id: z.string().uuid().optional().describe('Location ID'),
+    }, async (params) => {
+        try {
+            const body = {};
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    body[k] = v;
+            }
+            const result = await client.create('parts', body);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Vendors
+    // ============================================================
+    server.tool('list_vendors', 'List vendors. Filter by status, category, or city.', {
+        ...searchSchema,
+        ...paginationSchema,
+        status: z.string().optional().describe('Filter by vendor status'),
+        category: z.string().max(100).optional().describe('Filter by category (partial match)'),
+        city: z.string().max(100).optional().describe('Filter by city (partial match)'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'vendors', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_vendor', 'Get detailed vendor information including contact details, address, and website.', { id: uuidParam.describe('Vendor ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('vendors', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Work Requests
+    // ============================================================
+    server.tool('list_work_requests', 'List work requests (submitted by requesters). Filter by status (SUBMITTED, APPROVED, REJECTED, CONVERTED) or priority.', {
+        ...searchSchema,
+        ...paginationSchema,
+        status: z.string().optional().describe('Filter by status: SUBMITTED, APPROVED, REJECTED, CONVERTED'),
+        priority: z.string().optional().describe('Filter by priority: LOW, MEDIUM, HIGH, CRITICAL'),
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'work-requests', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_work_request', 'Get detailed work request information including description, attachments, and processing status.', { id: uuidParam.describe('Work request ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('work-requests', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Invoices
+    // ============================================================
+    server.tool('list_invoices', 'List invoices. Filter by status (pending, approved, paid, voided), vendor, or project.', {
+        ...searchSchema,
+        ...paginationSchema,
+        status: z.string().optional().describe('Filter by status: pending, approved, paid, voided'),
+        vendor_id: z.string().uuid().optional().describe('Filter by vendor ID'),
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'invoices', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_invoice', 'Get detailed invoice information including amounts, dates, linked vendor, project, and purchase order.', { id: uuidParam.describe('Invoice ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('invoices', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Purchase Orders
+    // ============================================================
+    server.tool('list_purchase_orders', 'List purchase orders. Filter by status (draft, issued, partially_received, received, closed, cancelled), vendor, or project.', {
+        ...searchSchema,
+        ...paginationSchema,
+        status: z.string().optional().describe('Filter by status: draft, issued, partially_received, received, closed, cancelled'),
+        vendor_id: z.string().uuid().optional().describe('Filter by vendor ID'),
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'purchase-orders', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_purchase_order', 'Get detailed purchase order information including amount, status, vendor, and linked project.', { id: uuidParam.describe('Purchase order ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('purchase-orders', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Expenses
+    // ============================================================
+    server.tool('list_expenses', 'List expenses. Filter by project, work order, or cost category.', {
+        ...searchSchema,
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        work_order_id: z.string().uuid().optional().describe('Filter by work order ID'),
+        category_id: z.string().uuid().optional().describe('Filter by cost category ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'expenses', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_expense', 'Get detailed expense information including amount, date, receipt, and linked project or work order.', { id: uuidParam.describe('Expense ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('expenses', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Asset Types
+    // ============================================================
+    server.tool('list_asset_types', 'List asset type classifications. Filter by category or group.', {
+        ...searchSchema,
+        ...paginationSchema,
+        category: z.string().max(100).optional().describe('Filter by category (partial match)'),
+        group_id: z.string().uuid().optional().describe('Filter by asset type group ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'asset-types', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Work Categories
+    // ============================================================
+    server.tool('list_work_categories', 'List work categories used to classify work orders and requests.', {
+        ...searchSchema,
+        ...paginationSchema,
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'work-categories', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Manufacturers
+    // ============================================================
+    server.tool('list_manufacturers', 'List manufacturers of equipment and assets.', {
+        ...searchSchema,
+        ...paginationSchema,
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'manufacturers', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_manufacturer', 'Get detailed manufacturer information including contact details and associated system classes.', { id: uuidParam.describe('Manufacturer ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('manufacturers', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Building Types
+    // ============================================================
+    server.tool('list_building_types', 'List building type classifications.', {
+        ...searchSchema,
+        ...paginationSchema,
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'building-types', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Location Types
+    // ============================================================
+    server.tool('list_location_types', 'List location type classifications (e.g., room types, floor types).', {
+        ...searchSchema,
+        ...paginationSchema,
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'location-types', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Cost Categories
+    // ============================================================
+    server.tool('list_cost_categories', 'List cost categories used to classify expenses, invoices, and purchase orders. Supports hierarchical parent-child structure.', {
+        ...searchSchema,
+        ...paginationSchema,
+        is_active: z.enum(['true', 'false']).optional().describe('Filter by active status'),
+        parent_id: z.string().uuid().optional().describe('Filter by parent category ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'cost-categories', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Budgets (annual_funding_budgets)
+    // ============================================================
+    server.tool('list_budgets', 'List annual funding budgets. Filter by year, site, building, or funding source. Includes allocated, budgeted, and remaining amounts.', {
+        ...searchSchema,
+        ...paginationSchema,
+        year: z.number().int().optional().describe('Filter by budget year (e.g. 2026)'),
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+        building_id: z.string().uuid().optional().describe('Filter by building ID'),
+        funding_source: z.number().int().optional().describe('Filter by funding source'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'budgets', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_budget', 'Get a single annual funding budget by ID. Use list_sites/list_buildings to resolve site_id/building_id.', { id: uuidParam.describe('Budget ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('budgets', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Dashboard
     // ============================================================
     server.tool('get_dashboard_summary', 'Get aggregated dashboard statistics: total assets, work orders by status, overdue count, active PM schedules, sites, and buildings.', {}, async () => {
@@ -297,5 +627,475 @@ export function registerTools(server, client) {
             return formatError(err);
         }
     });
+    // ============================================================
+    // Asset Comments
+    // ============================================================
+    server.tool('list_asset_comments', 'List comments on assets. Filter by asset_id to get comments for a specific asset.', {
+        ...paginationSchema,
+        asset_id: z.string().uuid().optional().describe('Filter by asset ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'asset-comments', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_asset_comment', 'Get a single asset comment by ID.', { id: uuidParam.describe('Asset comment ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('asset-comments', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Asset Costs
+    // ============================================================
+    server.tool('list_asset_costs', 'List asset cost records (repairs, PM, operations, replacements, decommissions). Filter by asset, site, category, or work order.', {
+        ...paginationSchema,
+        asset_id: z.string().uuid().optional().describe('Filter by asset ID'),
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+        category: z.enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission']).optional().describe('Filter by cost category'),
+        work_order_id: z.string().uuid().optional().describe('Filter by work order ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'asset-costs', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_asset_cost', 'Get a single asset cost record by ID, including related asset, site, and building names.', { id: uuidParam.describe('Asset cost ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('asset-costs', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Asset Replacement Plans
+    // ============================================================
+    server.tool('list_asset_replacement_plans', 'List asset replacement plans for lifecycle/capital planning. Filter by asset, status, priority, or planned year.', {
+        ...paginationSchema,
+        asset_id: z.string().uuid().optional().describe('Filter by asset ID'),
+        status: z.enum(['PLANNED', 'BUDGETED', 'APPROVED', 'COMPLETED', 'CANCELLED']).optional().describe('Filter by plan status'),
+        priority: z.enum(['CRITICAL', 'HIGH', 'MEDIUM', 'LOW']).optional().describe('Filter by priority'),
+        year: z.number().int().optional().describe('Filter by planned replacement year'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'asset-replacement-plans', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_asset_replacement_plan', 'Get a single asset replacement plan by ID.', { id: uuidParam.describe('Replacement plan ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('asset-replacement-plans', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Asset Risk History
+    // ============================================================
+    server.tool('list_asset_risk_history', 'List asset risk assessment history. Shows risk scores, condition scores, and trigger events over time.', {
+        ...paginationSchema,
+        asset_id: z.string().uuid().optional().describe('Filter by asset ID'),
+        trigger_event: z.enum(['maintenance', 'inspection', 'manual_update', 'scheduled']).optional().describe('Filter by trigger event type'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'asset-risk-history', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_asset_risk_history_entry', 'Get a single asset risk history entry by ID.', { id: uuidParam.describe('Risk history entry ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('asset-risk-history', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Work Order Comments
+    // ============================================================
+    server.tool('list_work_order_comments', 'List comments on work orders. Filter by work_order_id to get comments for a specific work order.', {
+        ...paginationSchema,
+        work_order_id: z.string().uuid().optional().describe('Filter by work order ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'work-order-comments', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_work_order_comment', 'Get a single work order comment by ID.', { id: uuidParam.describe('Work order comment ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('work-order-comments', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Tasks
+    // ============================================================
+    server.tool('list_project_tasks', 'List project tasks (work breakdown structure). Filter by project, phase, status, or priority.', {
+        ...searchSchema,
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        phase_id: z.string().uuid().optional().describe('Filter by phase ID'),
+        status: z.enum(['todo', 'in_progress', 'completed', 'blocked', 'cancelled']).optional().describe('Filter by task status'),
+        priority: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Filter by priority'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-tasks', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_task', 'Get a single project task by ID, including cost and hour tracking.', { id: uuidParam.describe('Project task ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-tasks', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Milestones
+    // ============================================================
+    server.tool('list_project_milestones', 'List project milestones. Filter by project or status (pending, completed, missed, at_risk).', {
+        ...searchSchema,
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        status: z.enum(['pending', 'completed', 'missed', 'at_risk']).optional().describe('Filter by milestone status'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-milestones', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_milestone', 'Get a single project milestone by ID.', { id: uuidParam.describe('Project milestone ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-milestones', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Phases
+    // ============================================================
+    server.tool('list_project_phases', 'List project phases. Filter by project or status (pending, in_progress, completed, skipped).', {
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        status: z.enum(['pending', 'in_progress', 'completed', 'skipped']).optional().describe('Filter by phase status'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-phases', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_phase', 'Get a single project phase by ID.', { id: uuidParam.describe('Project phase ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-phases', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Budget Items
+    // ============================================================
+    server.tool('list_project_budget_items', 'List project budget line items (labor, materials, equipment, subcontractors, permits, contingency, other).', {
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        category: z.enum(['labor', 'materials', 'equipment', 'subcontractors', 'permits', 'contingency', 'other']).optional().describe('Filter by budget category'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-budget-items', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_budget_item', 'Get a single project budget item by ID.', { id: uuidParam.describe('Budget item ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-budget-items', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Time Entries
+    // ============================================================
+    server.tool('list_project_time_entries', 'List project time entries for labor tracking. Filter by project, task, or user.', {
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+        task_id: z.string().uuid().optional().describe('Filter by task ID'),
+        user_id: z.string().optional().describe('Filter by user ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-time-entries', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_time_entry', 'Get a single project time entry by ID.', { id: uuidParam.describe('Time entry ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-time-entries', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project Comments
+    // ============================================================
+    server.tool('list_project_comments', 'List comments on projects. Supports threaded replies via parent_id.', {
+        ...paginationSchema,
+        project_id: z.string().uuid().optional().describe('Filter by project ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'project-comments', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_project_comment', 'Get a single project comment by ID.', { id: uuidParam.describe('Project comment ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('project-comments', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Compliance Records
+    // ============================================================
+    server.tool('list_compliance_records', 'List compliance records — audit trail of completed compliance checks linked to work orders and PM schedules.', {
+        ...paginationSchema,
+        compliance_item_id: z.string().uuid().optional().describe('Filter by compliance item ID'),
+        work_order_id: z.string().uuid().optional().describe('Filter by work order ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'compliance-records', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_compliance_record', 'Get a single compliance record by ID.', { id: uuidParam.describe('Compliance record ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('compliance-records', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Site FCI History
+    // ============================================================
+    server.tool('list_site_fci_history', 'List Facility Condition Index (FCI) history for sites. Track FCI trends over time.', {
+        ...paginationSchema,
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'site-fci-history', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_site_fci_history_entry', 'Get a single site FCI history entry by ID.', { id: uuidParam.describe('FCI history entry ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('site-fci-history', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Dashboard Snapshots
+    // ============================================================
+    server.tool('list_dashboard_snapshots', 'List monthly dashboard snapshots with aggregate stats: asset counts, condition scores, work order metrics, and CRV totals.', {
+        ...paginationSchema,
+        year: z.number().int().optional().describe('Filter by snapshot year (e.g. 2026)'),
+        month: z.number().int().min(1).max(12).optional().describe('Filter by snapshot month (1-12)'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'dashboard-snapshots', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_dashboard_snapshot', 'Get a single dashboard snapshot by ID.', { id: uuidParam.describe('Dashboard snapshot ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('dashboard-snapshots', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Vendor Site Assignments
+    // ============================================================
+    server.tool('list_vendor_site_assignments', 'List vendor-to-site assignments showing which vendors serve which sites.', {
+        ...paginationSchema,
+        vendor_id: z.string().uuid().optional().describe('Filter by vendor ID'),
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'vendor-site-assignments', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_vendor_site_assignment', 'Get a single vendor site assignment by ID, including vendor and site names.', { id: uuidParam.describe('Vendor site assignment ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('vendor-site-assignments', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Contract Sites
+    // ============================================================
+    server.tool('list_contract_sites', 'List contract-to-site mappings showing which contracts cover which sites. No single-record lookup (composite key).', {
+        ...paginationSchema,
+        contract_id: z.string().uuid().optional().describe('Filter by contract ID'),
+        site_id: z.string().uuid().optional().describe('Filter by site ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'contract-sites', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Custom Field Definitions
+    // ============================================================
+    server.tool('list_custom_field_definitions', 'List custom field definitions configured for this tenant. Filter by entity type (e.g. asset, work_order) or field type.', {
+        ...paginationSchema,
+        entity_type: z.string().max(100).optional().describe('Filter by entity type (e.g. asset, work_order)'),
+        field_type: z.enum(['text', 'number', 'date', 'boolean', 'select']).optional().describe('Filter by field type'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'custom-field-definitions', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_custom_field_definition', 'Get a single custom field definition by ID.', { id: uuidParam.describe('Custom field definition ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('custom-field-definitions', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Custom Field Values
+    // ============================================================
+    server.tool('list_custom_field_values', 'List custom field values. Filter by entity_id to get all custom fields for a specific record, or by field_definition_id.', {
+        ...paginationSchema,
+        entity_id: z.string().uuid().optional().describe('Filter by entity ID (e.g. asset ID, work order ID)'),
+        field_definition_id: z.string().uuid().optional().describe('Filter by field definition ID'),
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'custom-field-values', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_custom_field_value', 'Get a single custom field value by ID.', { id: uuidParam.describe('Custom field value ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('custom-field-values', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Part Categories
+    // ============================================================
+    server.tool('list_part_categories', 'List part categories used to classify inventory parts.', {
+        ...searchSchema,
+        ...paginationSchema,
+    }, async (params) => {
+        try {
+            const result = await smartList(client, 'part-categories', params);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('get_part_category', 'Get a single part category by ID.', { id: uuidParam.describe('Part category ID') }, async ({ id }) => {
+        try {
+            const result = await client.getOne('part-categories', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
 }
 //# sourceMappingURL=tools.js.map