@assetlab/mcp-server 1.14.1 → 1.16.0

package/dist/tools-write.js

@@ -32,12 +32,12 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // 1. Work Orders (scope: work_orders)
     // ============================================================
-    server.tool('create_work_order', 'Create a new work order. Requires work_orders:write scope. IMPORTANT — Location hierarchy: always resolve top-down by calling list_sites first, then list_buildings filtered by site_id, then list_locations filtered by building_id. Provide all three IDs (site_id, building_id, location_id) explicitly.', {
+    server.tool('create_work_order', 'Create a new work order. Requires work_orders:write scope. REQUIRED fields: title, site_id, building_id, AND at least one association (asset_id OR location_id). A work order with no asset/location association is not valid — ask the user which one applies before calling. RECOMMENDED: work_category_id (look up via list_work_categories; omit only if no reasonable match exists). Location hierarchy: always resolve top-down by calling list_sites first, then list_buildings filtered by site_id, then list_locations filtered by building_id.', {
         title: z.string().min(1).max(500).describe('Work order title (required)'),
         description: z.string().optional().describe('Detailed description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'URGENT']).optional().describe('Priority level'),
         status: z.enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
-        type: z.enum(['PM', 'DEMAND']).optional().describe('Work order type'),
+        type: z.enum(['PM', 'REACTIVE']).optional().describe('Work order type'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
         building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
         location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
@@ -50,6 +50,8 @@ export function registerWriteTools(server, client) {
         assigned_to: z.string().optional().describe('Assigned user ID (mapped to assignees array)'),
         assignees: z.array(z.string()).optional().describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
         image_url: z.string().max(2000).optional().describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+        meter_reading: z.number().min(0).optional().describe('Meter/odometer reading at time of service'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async (params) => {
         try {
             const result = await client.create('work-orders', buildBody(params));
@@ -65,7 +67,7 @@ export function registerWriteTools(server, client) {
         description: z.string().optional().describe('Detailed description'),
         priority: z.enum(['LOW', 'MEDIUM', 'HIGH', 'URGENT']).optional().describe('Priority level'),
         status: z.enum(['NEW', 'IN_PROGRESS', 'ON_HOLD', 'REJECTED', 'COMPLETED', 'CANCELLED']).optional().describe('Status'),
-        type: z.enum(['PM', 'DEMAND']).optional().describe('Work order type'),
+        type: z.enum(['PM', 'REACTIVE']).optional().describe('Work order type'),
         site_id: z.string().uuid().optional().describe('Site ID — resolve first via list_sites'),
         building_id: z.string().uuid().optional().describe('Building ID — resolve second via list_buildings filtered by site_id'),
         location_id: z.string().uuid().optional().describe('Location ID — resolve last via list_locations filtered by building_id'),
@@ -78,6 +80,8 @@ export function registerWriteTools(server, client) {
         assigned_to: z.string().optional().describe('Assigned user ID (mapped to assignees array)'),
         assignees: z.array(z.string()).optional().describe('Array of assigned user IDs (alternative to assigned_to for multiple assignees)'),
         image_url: z.string().max(2000).optional().describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+        meter_reading: z.number().min(0).optional().describe('Meter/odometer reading at time of service'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('work-orders', id, buildBody(rest));
@@ -134,6 +138,8 @@ export function registerWriteTools(server, client) {
         environmental_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
         regulatory_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
         reputation_impact: z.enum(['LOW', 'MEDIUM', 'HIGH', 'CRITICAL']).optional().describe('Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL)'),
+        current_meter_reading: z.number().min(0).optional().describe('Current meter/odometer reading'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
     }, async (params) => {
         try {
             const result = await client.create('assets', buildBody(params));
@@ -166,6 +172,8 @@ export function registerWriteTools(server, client) {
         system_id: z.string().uuid().optional().describe('System ID — resolve last via list_systems filtered by system_group_id'),
         image_url: z.string().max(2000).optional().describe('Image URL'),
         last_maintenance_date: z.string().optional().describe('Last maintenance date (ISO 8601)'),
+        current_meter_reading: z.number().min(0).optional().describe('Current meter/odometer reading'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         quantity: z.number().min(0).optional().describe('Quantity'),
         unit_of_measure: z.string().max(100).optional().describe('Unit of measure'),
         unit_replacement_value: z.number().min(0).optional().describe('Unit replacement value'),
@@ -485,6 +493,9 @@ export function registerWriteTools(server, client) {
         status: z.enum(['active', 'inactive']).optional().describe('Schedule status'),
         auto_generate_wo: z.boolean().optional().describe('Auto-generate work orders'),
         floating: z.boolean().optional().describe('Floating schedule (due date based on completion)'),
+        meter_based: z.boolean().optional().describe('Whether this PM triggers at meter intervals (e.g. every 5000 km)'),
+        meter_interval: z.number().min(0).optional().describe('Meter interval — trigger every N units'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Array of asset IDs'),
         system_ids: z.array(z.string().uuid()).optional().describe('Array of system IDs'),
@@ -524,6 +535,9 @@ export function registerWriteTools(server, client) {
         status: z.enum(['active', 'inactive']).optional().describe('Schedule status'),
         auto_generate_wo: z.boolean().optional().describe('Auto-generate work orders'),
         floating: z.boolean().optional().describe('Floating schedule (due date based on completion)'),
+        meter_based: z.boolean().optional().describe('Whether this PM triggers at meter intervals'),
+        meter_interval: z.number().min(0).optional().describe('Meter interval — trigger every N units'),
+        meter_unit: z.string().max(50).optional().describe('Meter unit (km, miles, hours, cycles)'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         asset_ids: z.array(z.string().uuid()).optional().describe('Array of asset IDs'),
         system_ids: z.array(z.string().uuid()).optional().describe('Array of system IDs'),
@@ -552,6 +566,75 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // 8b. PM Templates (scope: pm_templates)
+    // ============================================================
+    server.tool('create_pm_template', 'Create a new PM template. Templates are reusable PM definitions (not linked to a site/asset) that can seed new PM schedules. Requires pm_templates:write scope.', {
+        title: z.string().min(1).max(500).describe('PM template title (required, unique per tenant)'),
+        description: z.string().optional().describe('Description'),
+        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Suggested maintenance frequency'),
+        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        work_category: z.string().max(200).optional().describe('Work category label (free text)'),
+        work_category_id: z.string().uuid().optional().describe('Work category ID — resolve via list_work_categories'),
+        estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
+        estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
+        safety_requirements: z.string().optional().describe('Safety requirements'),
+        tasks: z.array(z.object({
+            id: z.string().describe('Unique task ID (use a random string)'),
+            description: z.string().describe('Task description'),
+            completed: z.boolean().describe('Whether the task is completed'),
+        })).optional().describe('Checklist of tasks baked into this template'),
+        resources: z.array(z.record(z.unknown())).optional().describe('Resource references (parts, tools, documents)'),
+        documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
+        asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs to seed on derived schedules'),
+        location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs to seed on derived schedules'),
+    }, async (params) => {
+        try {
+            const result = await client.create('pm-templates', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_pm_template', 'Update an existing PM template by ID. Requires pm_templates:write scope.', {
+        id: z.string().uuid().describe('PM template ID'),
+        title: z.string().min(1).max(500).optional().describe('PM template title'),
+        description: z.string().optional().describe('Description'),
+        frequency: z.enum(['DAILY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'SEMI_ANNUAL', 'ANNUAL', 'FIVE_YEARLY', 'CUSTOM']).optional().describe('Suggested maintenance frequency'),
+        custom_interval_weeks: z.number().int().min(1).optional().describe('Custom interval in weeks (when frequency is CUSTOM)'),
+        work_category: z.string().max(200).optional().describe('Work category label (free text)'),
+        work_category_id: z.string().uuid().optional().describe('Work category ID'),
+        estimated_hours: z.number().min(0).optional().describe('Estimated hours'),
+        estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
+        safety_requirements: z.string().optional().describe('Safety requirements'),
+        tasks: z.array(z.object({
+            id: z.string().describe('Unique task ID'),
+            description: z.string().describe('Task description'),
+            completed: z.boolean().describe('Whether the task is completed'),
+        })).optional().describe('Checklist of tasks baked into this template'),
+        resources: z.array(z.record(z.unknown())).optional().describe('Resource references'),
+        documents: z.array(z.record(z.unknown())).optional().describe('Document references'),
+        asset_ids: z.array(z.string().uuid()).optional().describe('Default asset IDs'),
+        location_ids: z.array(z.string().uuid()).optional().describe('Default location IDs'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('pm-templates', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_pm_template', 'Delete a PM template by ID. Requires pm_templates:write scope.', { id: z.string().uuid().describe('PM template ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('pm-templates', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // 9. Projects (scope: projects)
     // ============================================================
     server.tool('create_project', 'Create a new project. Requires projects:write scope.', {
@@ -1992,10 +2075,14 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // 36. Custom Field Values (scope: custom_fields)
     // ============================================================
-    server.tool('create_custom_field_value', 'Create a new custom field value. Requires custom_fields:write scope.', {
-        entity_id: z.string().uuid().describe('Entity ID (required)'),
-        field_definition_id: z.string().uuid().describe('Custom field definition ID (required)'),
-        value: z.string().max(5000).optional().describe('Field value'),
+    server.tool('create_custom_field_value', 'Create (upsert) a custom field value for an entity. The table stores values in typed columns — prefer setting the one that matches the field definition\'s field_type: value_text (text/select), value_number (number), value_date (date, ISO YYYY-MM-DD), value_boolean (boolean). Alternatively pass a single `value` string and the server will dispatch it to the right column based on field_type. Writes upsert on (entity_id, field_definition_id) so replaying a batch is idempotent. Requires custom_fields:write scope.', {
+        entity_id: z.string().uuid().describe('Entity ID — e.g. asset.id, work_order.id (required)'),
+        field_definition_id: z.string().uuid().describe('Custom field definition ID — resolve via list_custom_field_definitions (required)'),
+        value_text: z.string().max(5000).nullable().optional().describe('Text value (use for field_type=text or select)'),
+        value_number: z.number().nullable().optional().describe('Numeric value (use for field_type=number)'),
+        value_date: z.string().nullable().optional().describe('Date value, ISO YYYY-MM-DD (use for field_type=date)'),
+        value_boolean: z.boolean().nullable().optional().describe('Boolean value (use for field_type=boolean)'),
+        value: z.string().max(5000).optional().describe('Legacy single-value shim — server dispatches to the correct typed column based on the field definition\'s field_type. Ignored if any value_* typed column is set.'),
     }, async (params) => {
         try {
             const result = await client.create('custom-field-values', buildBody(params));
@@ -2005,11 +2092,15 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool('update_custom_field_value', 'Update an existing custom field value by ID. Requires custom_fields:write scope.', {
+    server.tool('update_custom_field_value', 'Update an existing custom field value by ID. Set whichever typed column matches the definition\'s field_type (value_text / value_number / value_date / value_boolean), or pass a single `value` and the server will dispatch it. Requires custom_fields:write scope.', {
         id: z.string().uuid().describe('Custom field value ID'),
         entity_id: z.string().uuid().optional().describe('Entity ID'),
-        field_definition_id: z.string().uuid().optional().describe('Custom field definition ID'),
-        value: z.string().max(5000).optional().describe('Field value'),
+        field_definition_id: z.string().uuid().optional().describe('Custom field definition ID — required when using the `value` fallback if you want to avoid the server fetching it'),
+        value_text: z.string().max(5000).nullable().optional().describe('Text value'),
+        value_number: z.number().nullable().optional().describe('Numeric value'),
+        value_date: z.string().nullable().optional().describe('Date value, ISO YYYY-MM-DD'),
+        value_boolean: z.boolean().nullable().optional().describe('Boolean value'),
+        value: z.string().max(5000).optional().describe('Legacy single-value shim — server dispatches based on field_type'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('custom-field-values', id, buildBody(rest));
@@ -2886,7 +2977,7 @@ export function registerWriteTools(server, client) {
     const BULK_RESOURCES = [
         'assets', 'work-orders', 'work-requests', 'vendors', 'sites',
         'buildings', 'locations', 'systems', 'system-groups', 'system-classes',
-        'pm-schedules', 'projects',
+        'pm-schedules', 'pm-templates', 'projects',
         'contracts', 'invoices', 'purchase-orders', 'expenses', 'budgets',
         'asset-types', 'asset-type-groups', 'asset-statuses', 'work-categories', 'manufacturers',
         'building-types', 'location-types', 'cost-categories',