@assetlab/mcp-server 1.14.0 → 1.14.2

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'),
@@ -47,8 +47,11 @@ export function registerWriteTools(server, client) {
         estimated_time: z.number().min(0).optional().describe('Estimated time in hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
-        assigned_to: z.string().optional().describe('Assigned user ID'),
+        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));
@@ -64,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'),
@@ -74,8 +77,11 @@ export function registerWriteTools(server, client) {
         estimated_time: z.number().min(0).optional().describe('Estimated time in hours'),
         estimated_cost: z.number().min(0).optional().describe('Estimated cost'),
         work_category_id: z.string().uuid().optional().describe('Work category ID'),
-        assigned_to: z.string().optional().describe('Assigned user ID'),
+        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));
@@ -132,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));
@@ -164,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'),
@@ -483,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'),
@@ -522,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'),