@assetlab/mcp-server 1.12.0 → 1.14.0

package/dist/tools-write.js

@@ -2664,6 +2664,221 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Level of Service: Service Areas (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area', 'Create a new service area for Level of Service tracking. Requires service_areas:write scope. After creating, link system classes via create_service_area_system_class and sites via create_service_area_site.', {
+        name: z.string().min(1).max(500).describe('Service area name (required, unique per tenant)'),
+        description: z.string().max(2000).optional().describe('Description'),
+        icon: z.string().max(200).optional().describe('Icon name (e.g., "droplets" for water)'),
+        color: z.string().max(50).optional().describe('Hex color code (e.g., "#3B82F6")'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
+        is_active: z.boolean().optional().describe('Whether the service area is active (default: true)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-areas', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_service_area', 'Update an existing service area by ID. Requires service_areas:write scope.', {
+        id: z.string().uuid().describe('Service area ID'),
+        name: z.string().min(1).max(500).optional().describe('Service area name'),
+        description: z.string().max(2000).optional().describe('Description'),
+        icon: z.string().max(200).optional().describe('Icon name'),
+        color: z.string().max(50).optional().describe('Hex color code'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order'),
+        is_active: z.boolean().optional().describe('Active status'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('service-areas', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area', 'Delete a service area by ID. WARNING: This also deletes all linked measures, measurements, and junction records. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-areas', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Service Area System Classes (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area_system_class', 'Link a system class to a service area. Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_system_classes → system_class_id.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        system_class_id: z.string().uuid().describe('System class ID (required)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-area-system-classes', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area_system_class', 'Remove a system class link from a service area. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area system class link ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-area-system-classes', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Service Area Sites (scope: service_areas)
+    // ============================================================
+    server.tool('create_service_area_site', 'Link a site to a service area (optional scoping). Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_sites → site_id.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        site_id: z.string().uuid().describe('Site ID (required)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('service-area-sites', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_service_area_site', 'Remove a site link from a service area. Requires service_areas:write scope.', { id: z.string().uuid().describe('Service area site link ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('service-area-sites', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Measures (scope: los_measures)
+    // ============================================================
+    server.tool('create_los_measure', 'Create a new LoS measure within a service area. Requires los_measures:write scope. Resolve service_area_id first via list_service_areas.', {
+        service_area_id: z.string().uuid().describe('Service area ID (required)'),
+        name: z.string().min(1).max(500).describe('Measure name (required, unique per service area)'),
+        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).describe('Measure category (required)'),
+        type: z.enum(['community', 'technical']).describe('Measure type (required)'),
+        data_source: z.enum([
+            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
+            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
+            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
+            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+            'asset_past_useful_life_pct',
+        ]).describe('Data source type (required). Use "manual" if values will be entered by hand.'),
+        description: z.string().max(2000).optional().describe('Description'),
+        community_statement: z.string().max(2000).optional().describe('Community-facing statement (for community type measures)'),
+        unit: z.string().max(100).optional().describe('Unit of measurement (e.g., "%", "hours", "count")'),
+        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        target_value: z.number().optional().describe('Target value'),
+        minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
+        stretch_goal: z.number().optional().describe('Stretch goal value'),
+        weight: z.number().min(0).optional().describe('Weight for composite score calculation (default: 1.0)'),
+        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB). E.g., {"threshold": 3} for pct_above/below, {"days_back": 90} for WO metrics.'),
+        is_active: z.boolean().optional().describe('Whether the measure is active (default: true)'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order for display'),
+    }, async (params) => {
+        try {
+            const result = await client.create('los-measures', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_los_measure', 'Update an existing LoS measure by ID. Requires los_measures:write scope.', {
+        id: z.string().uuid().describe('LoS measure ID'),
+        name: z.string().min(1).max(500).optional().describe('Measure name'),
+        category: z.enum(['quality', 'reliability', 'responsiveness', 'safety', 'sustainability', 'cost_efficiency', 'capacity']).optional().describe('Measure category'),
+        type: z.enum(['community', 'technical']).optional().describe('Measure type'),
+        data_source: z.enum([
+            'manual', 'custom_formula', 'asset_condition_avg', 'asset_condition_pct_above',
+            'asset_condition_pct_below', 'risk_score_avg', 'risk_pct_critical',
+            'wo_response_time_avg', 'wo_completion_time_avg', 'wo_backlog_count', 'wo_overdue_count',
+            'pm_compliance_rate', 'compliance_score', 'fci', 'deferred_maintenance_ratio',
+            'asset_past_useful_life_pct',
+        ]).optional().describe('Data source type'),
+        description: z.string().max(2000).optional().describe('Description'),
+        community_statement: z.string().max(2000).optional().describe('Community-facing statement'),
+        unit: z.string().max(100).optional().describe('Unit of measurement'),
+        trend_direction: z.enum(['higher_is_better', 'lower_is_better', 'target_is_optimal']).optional().describe('Which direction is better'),
+        target_value: z.number().optional().describe('Target value'),
+        minimum_acceptable: z.number().optional().describe('Minimum acceptable value'),
+        stretch_goal: z.number().optional().describe('Stretch goal value'),
+        weight: z.number().min(0).optional().describe('Weight for composite score calculation'),
+        data_source_config: z.record(z.unknown()).optional().describe('Data source configuration (JSONB)'),
+        is_active: z.boolean().optional().describe('Active status'),
+        sort_order: z.number().int().min(0).optional().describe('Sort order'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('los-measures', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_los_measure', 'Delete a LoS measure by ID. WARNING: This also deletes all associated measurements and targets history. Requires los_measures:write scope.', { id: z.string().uuid().describe('LoS measure ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('los-measures', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Level of Service: Measurements (scope: los_measurements)
+    // ============================================================
+    server.tool('create_los_measurement', 'Record a new LoS measurement value. Requires los_measurements:write scope. Resolve los_measure_id first via list_los_measures.', {
+        los_measure_id: z.string().uuid().describe('LoS measure ID (required)'),
+        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).describe('Period type (required)'),
+        period_start: z.string().describe('Period start date (ISO 8601, required, e.g., "2026-01-01")'),
+        period_end: z.string().describe('Period end date (ISO 8601, required, e.g., "2026-03-31")'),
+        actual_value: z.number().describe('Measured value (required)'),
+        notes: z.string().max(2000).optional().describe('Notes or context for this measurement'),
+        is_auto: z.boolean().optional().describe('Whether this is an auto-calculated value (default: false)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('los-measurements', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_los_measurement', 'Update an existing LoS measurement by ID. Requires los_measurements:write scope.', {
+        id: z.string().uuid().describe('LoS measurement ID'),
+        actual_value: z.number().optional().describe('Measured value'),
+        notes: z.string().max(2000).optional().describe('Notes or context'),
+        period_type: z.enum(['monthly', 'quarterly', 'semi_annual', 'annual']).optional().describe('Period type'),
+        period_start: z.string().optional().describe('Period start date (ISO 8601)'),
+        period_end: z.string().optional().describe('Period end date (ISO 8601)'),
+        is_auto: z.boolean().optional().describe('Whether this is auto-calculated'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('los-measurements', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_los_measurement', 'Delete a LoS measurement by ID. Requires los_measurements:write scope.', { id: z.string().uuid().describe('LoS measurement ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('los-measurements', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Bulk operations
     // ============================================================
     const BULK_RESOURCES = [
@@ -2685,6 +2900,7 @@ export function registerWriteTools(server, client) {
         'custom-field-definitions', 'custom-field-values',
         'vendor-site-assignments', 'contract-sites',
         'asset-documents', 'attachments', 'project-documents', 'contract-documents',
+        'service-areas', 'los-measures', 'los-measurements',
     ];
     server.tool('bulk_create', 'Create multiple records of a resource type in one API call (max 100). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {
         resource: z.enum(BULK_RESOURCES).describe('Resource type (e.g. "assets", "work-orders")'),