@assetlab/mcp-server 2.0.1 → 2.3.0

package/dist/tools-write.js

@@ -128,6 +128,7 @@ export function registerWriteTools(server, client) {
         location_ids: ASSOCIATION_ARRAY_SCHEMA('Locations this work order covers — use instead of location_id when there is more than one. Sending location_id alone replaces this with that single id.'),
         asset_ids: ASSOCIATION_ARRAY_SCHEMA('Assets this work order covers — use instead of asset_id when there is more than one.'),
         system_ids: ASSOCIATION_ARRAY_SCHEMA('Systems this work order covers — resolve via list_systems. Systems have no singular field; this array is the only way to associate them.'),
+        infrastructure_asset_ids: ASSOCIATION_ARRAY_SCHEMA('Infrastructure features this work order covers — resolve via list_infrastructure_assets. Use this when one job covers several features (a round of hydrant flushing); the whole selection is one work order with one completion and one cost, split across the features. Mutually exclusive with asset/location/system targets.'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
         estimated_time: z.number().min(0).optional().describe('Estimated time in hours'),
@@ -142,7 +143,7 @@ export function registerWriteTools(server, client) {
             .string()
             .max(2000)
             .optional()
-            .describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+            .describe('Image storage path (upload via create_upload_url with bucket "attachments", then set this to the returned path)'),
         meter_reading: z
             .number()
             .min(0)
@@ -187,6 +188,7 @@ export function registerWriteTools(server, client) {
         location_ids: ASSOCIATION_ARRAY_SCHEMA('Locations this work order covers — use instead of location_id when there is more than one. Sending location_id alone replaces this with that single id.'),
         asset_ids: ASSOCIATION_ARRAY_SCHEMA('Assets this work order covers — use instead of asset_id when there is more than one.'),
         system_ids: ASSOCIATION_ARRAY_SCHEMA('Systems this work order covers — resolve via list_systems. Systems have no singular field; this array is the only way to associate them.'),
+        infrastructure_asset_ids: ASSOCIATION_ARRAY_SCHEMA('Infrastructure features this work order covers — resolve via list_infrastructure_assets. Use this when one job covers several features (a round of hydrant flushing); the whole selection is one work order with one completion and one cost, split across the features. Mutually exclusive with asset/location/system targets.'),
         start_date: z.string().optional().describe('Start date (ISO 8601)'),
         due_date: z.string().optional().describe('Due date (ISO 8601)'),
         estimated_time: z.number().min(0).optional().describe('Estimated time in hours'),
@@ -201,7 +203,7 @@ export function registerWriteTools(server, client) {
             .string()
             .max(2000)
             .optional()
-            .describe('Image URL (upload via create_upload_url with bucket "attachments", then set this to the public_url)'),
+            .describe('Image storage path (upload via create_upload_url with bucket "attachments", then set this to the returned path)'),
         meter_reading: z
             .number()
             .min(0)
@@ -924,6 +926,7 @@ export function registerWriteTools(server, client) {
         asset_ids: ASSOCIATION_ARRAY_SCHEMA('Assets this schedule covers — use instead of asset_id when there is more than one.'),
         system_ids: ASSOCIATION_ARRAY_SCHEMA('Systems this schedule covers. Systems have no singular field; this array is the only way to associate them.'),
         location_ids: ASSOCIATION_ARRAY_SCHEMA('Locations this schedule covers — use instead of location_id when there is more than one. Sending location_id alone replaces this with that single id.'),
+        infrastructure_asset_ids: ASSOCIATION_ARRAY_SCHEMA('Infrastructure features this schedule covers — resolve via list_infrastructure_assets. One schedule over several features generates one work order per cycle covering all of them. Mutually exclusive with asset/location/system targets.'),
         tasks: z
             .array(z.object({
             id: z.string().describe('Unique task ID (use a random string)'),
@@ -999,6 +1002,7 @@ export function registerWriteTools(server, client) {
         asset_ids: ASSOCIATION_ARRAY_SCHEMA('Assets this schedule covers — use instead of asset_id when there is more than one.'),
         system_ids: ASSOCIATION_ARRAY_SCHEMA('Systems this schedule covers. Systems have no singular field; this array is the only way to associate them.'),
         location_ids: ASSOCIATION_ARRAY_SCHEMA('Locations this schedule covers — use instead of location_id when there is more than one. Sending location_id alone replaces this with that single id.'),
+        infrastructure_asset_ids: ASSOCIATION_ARRAY_SCHEMA('Infrastructure features this schedule covers — resolve via list_infrastructure_assets. One schedule over several features generates one work order per cycle covering all of them. Mutually exclusive with asset/location/system targets.'),
         tasks: z
             .array(z.object({
             id: z.string().describe('Unique task ID'),
@@ -1918,6 +1922,56 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // 16b. Work Order Schedules (scope: work_order_schedules)
+    // ============================================================
+    server.tool('create_work_order_schedule', "Schedule a work order for a technician on a date (one entry of a day plan). stop_order gives the position in the technician's day; leave it unset for an unordered calendar entry. Requires work_order_schedules:write scope.", {
+        work_order_id: z.string().uuid().describe('Work order ID (required)'),
+        technician_id: z.string().min(1).describe('Technician Clerk user ID (required)'),
+        scheduled_date: z.string().describe('Date (YYYY-MM-DD, required)'),
+        scheduled_start_time: z.string().optional().describe('Start time (HH:MM)'),
+        scheduled_end_time: z.string().optional().describe('End time (HH:MM)'),
+        duration_minutes: z.number().int().optional().describe('Planned duration in minutes'),
+        stop_order: z.number().int().optional().describe('1-based stop position in the day plan'),
+        travel_time_minutes: z.number().int().optional().describe('Travel time from previous stop'),
+        scheduling_notes: z.string().optional().describe('Scheduling notes'),
+    }, async (params) => {
+        try {
+            const result = await client.create('work-order-schedules', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_work_order_schedule', 'Update a work order schedule entry by ID (date, times, stop_order, notes). work_order_id is immutable. Requires work_order_schedules:write scope.', {
+        id: z.string().uuid().describe('Work order schedule ID'),
+        technician_id: z.string().min(1).optional().describe('Technician Clerk user ID'),
+        scheduled_date: z.string().optional().describe('Date (YYYY-MM-DD)'),
+        scheduled_start_time: z.string().optional().describe('Start time (HH:MM)'),
+        scheduled_end_time: z.string().optional().describe('End time (HH:MM)'),
+        duration_minutes: z.number().int().optional().describe('Planned duration in minutes'),
+        stop_order: z.number().int().optional().describe('1-based stop position in the day plan'),
+        travel_time_minutes: z.number().int().optional().describe('Travel time from previous stop'),
+        scheduling_notes: z.string().optional().describe('Scheduling notes'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('work-order-schedules', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_work_order_schedule', "Delete a work order schedule entry by ID (removes the stop from the technician's day). Requires work_order_schedules:write scope.", { id: z.string().uuid().describe('Work order schedule ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('work-order-schedules', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // 17. Project Comments (scope: project_comments)
     // ============================================================
     server.tool('create_project_comment', 'Create a new comment on a project. Requires project_comments:write scope.', {
@@ -3151,7 +3205,7 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // Upload URLs
     // ============================================================
-    server.tool('create_upload_url', 'Generate a signed upload URL for uploading a file to AssetLab storage. Returns a signed_url to PUT the file to, a public_url for referencing, and the path. IMPORTANT — When a user wants to upload a file, always clarify the target. File upload paths: (1) Asset IMAGE: bucket "asset-images" → update_asset with image_url. (2) Asset DOCUMENT (O&M, warranty, spec): bucket "documents" → create_asset_document. (3) Work order IMAGE: bucket "attachments" → update_work_order with image_url. (4) Work order/request/PM ATTACHMENT: bucket "attachments" → create_attachment with the parent ID. (5) Project DOCUMENT: bucket "project-documents" → create_project_document. (6) Contract DOCUMENT: bucket "contract-documents" → create_contract_document. Always ask the user which type they mean if ambiguous. Requires upload_urls:write scope.', {
+    server.tool('create_upload_url', 'Generate a signed upload URL for uploading a file to AssetLab storage. Returns a signed_url to PUT the file to, and the storage path to store on the record. IMPORTANT — When a user wants to upload a file, always clarify the target. File upload paths: (1) Asset IMAGE: bucket "asset-images" → update_asset with image_url. (2) Asset DOCUMENT (O&M, warranty, spec): bucket "documents" → create_asset_document. (3) Work order IMAGE: bucket "attachments" → update_work_order with image_url. (4) Work order/request/PM ATTACHMENT: bucket "attachments" → create_attachment with the parent ID. (5) Project DOCUMENT: bucket "project-documents" → create_project_document. (6) Contract DOCUMENT: bucket "contract-documents" → create_contract_document. Always ask the user which type they mean if ambiguous. Requires upload_urls:write scope.', {
         bucket: z
             .enum([
             'documents',
@@ -3171,7 +3225,7 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool('upload_file', 'Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side — use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, public_url, bucket, file_size, content_type }. After uploading, pass path or public_url to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_path, create_project_document file_path, create_contract_document file_path). Server limit is ~10 MB decoded; MCP arg ceiling effectively caps file size around 700 KB–1 MB. For larger files, use create_upload_url instead. Requires upload_urls:write scope.', {
+    server.tool('upload_file', 'Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side — use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, bucket, file_size, content_type }. After uploading, pass path to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_path, create_project_document file_path, create_contract_document file_path). Server limit is ~10 MB decoded; MCP arg ceiling effectively caps file size around 700 KB–1 MB. For larger files, use create_upload_url instead. Requires upload_urls:write scope.', {
         bucket: z
             .enum([
             'documents',
@@ -4642,6 +4696,137 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Infrastructure Lifecycle Events (scope: infrastructure_lifecycle_events)
+    // ============================================================
+    const lifecycleEventScope = {
+        feature_class: z
+            .string()
+            .regex(/^[a-z][a-z0-9_]{0,49}$/)
+            .optional()
+            .describe('Feature class code the strategy scope applies to (omit for a material-wide scope; at least one of feature_class/material is required)'),
+        material: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('Material the scope applies to, exactly as features carry it (e.g. "PVC")'),
+        diameter_min_mm: z
+            .number()
+            .positive()
+            .optional()
+            .describe('Lower bound of a diameter band (requires material); bands ladder like rates'),
+    };
+    const lifecycleEventFields = {
+        event_class: z
+            .enum(['preventive', 'rehabilitation'])
+            .describe('Event type — preventative maintenance or rehabilitation'),
+        trigger_condition_max: z
+            .number()
+            .int()
+            .min(1)
+            .max(99)
+            .describe('Upper bound of the trigger window — the event fires when projected condition falls to this'),
+        trigger_condition_min: z
+            .number()
+            .int()
+            .min(0)
+            .max(98)
+            .optional()
+            .describe('Lower bound of the trigger window (default 0); a feature already below it has missed the event'),
+        impact_method: z
+            .enum(['add_years', 'reset_condition'])
+            .describe('Effect: add years of life, or reset condition to a value'),
+        impact_add_years: z
+            .number()
+            .positive()
+            .max(100)
+            .optional()
+            .describe('Years added (required when impact_method is add_years)'),
+        impact_reset_to: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Condition after the event (required when impact_method is reset_condition)'),
+        cost_method: z
+            .enum(['per_unit', 'fixed'])
+            .optional()
+            .describe("Costing: per unit (uses the feature's measured quantity and unit) or a fixed amount (default per_unit)"),
+        unit_cost: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Cost per unit (current dollars, never indexed)'),
+        fixed_cost: z.number().min(0).optional().describe('Fixed cost (current dollars)'),
+        cost_source: z
+            .string()
+            .max(200)
+            .optional()
+            .describe('Provenance of the cost ("Engineering 2026", a tender reference)'),
+        max_applications: z
+            .number()
+            .int()
+            .min(1)
+            .max(10)
+            .optional()
+            .describe("How many times the event may fire over a feature's life (default 1)"),
+        min_years_between: z
+            .number()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe('Minimum years between firings of a recurring event (default 1)'),
+        sort_order: z.number().int().min(0).optional().describe('Evaluation order within the strategy'),
+    };
+    server.tool('create_infrastructure_lifecycle_event', 'Create a lifecycle strategy event. Events attach to a SCOPE (feature_class code, material, optional diameter band) — never to individual features; every feature resolves the most specific matching scope, like replacement rates. Replacement is NOT an event (it is priced by the rates and scheduled by the renewal forecast) — model the interventions BEFORE replacement: crack sealing, relining, resurfacing. List existing events first to reuse a scope. Requires infrastructure_lifecycle_events:write scope.', {
+        name: z.string().max(200).describe('Event name (required, e.g. "Crack Sealing")'),
+        ...lifecycleEventScope,
+        ...lifecycleEventFields,
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-lifecycle-events', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_lifecycle_event', 'Update a lifecycle strategy event by ID. Editing re-confirms the cost (cost_reviewed_on is server-set). Set is_active false to disable an event without deleting it — projections recompute immediately. Requires infrastructure_lifecycle_events:write scope.', {
+        id: z.string().uuid().describe('Lifecycle event ID'),
+        name: z.string().max(200).optional().describe('Event name'),
+        is_active: z.boolean().optional().describe('Disable/enable the event'),
+        event_class: lifecycleEventFields.event_class.optional(),
+        trigger_condition_max: lifecycleEventFields.trigger_condition_max.optional(),
+        trigger_condition_min: lifecycleEventFields.trigger_condition_min,
+        impact_method: lifecycleEventFields.impact_method.optional(),
+        impact_add_years: lifecycleEventFields.impact_add_years,
+        impact_reset_to: lifecycleEventFields.impact_reset_to,
+        cost_method: lifecycleEventFields.cost_method,
+        unit_cost: lifecycleEventFields.unit_cost,
+        fixed_cost: lifecycleEventFields.fixed_cost,
+        cost_source: lifecycleEventFields.cost_source,
+        max_applications: lifecycleEventFields.max_applications,
+        min_years_between: lifecycleEventFields.min_years_between,
+        sort_order: lifecycleEventFields.sort_order,
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-lifecycle-events', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_lifecycle_event', 'Delete a lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires infrastructure_lifecycle_events:write scope.', { id: z.string().uuid().describe('Lifecycle event ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-lifecycle-events', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Infrastructure Networks (scope: infrastructure_networks)
     // ============================================================
     server.tool('create_infrastructure_network', 'Create an infrastructure network — a named grouping of features bound to one feature class. Requires infrastructure_networks:write scope.', {