@assetlab/mcp-server 1.28.0 → 2.2.0

package/dist/index.js

@@ -13,12 +13,13 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { AssetLabClient, loadConfig } from './client.js';
 import { registerTools, SERVER_INSTRUCTIONS } from './tools.js';
+import { VERSION } from './version.js';
 async function main() {
     const config = loadConfig();
     const client = new AssetLabClient(config);
     const server = new McpServer({
         name: 'assetlab',
-        version: '1.0.0',
+        version: VERSION,
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAA;IAED,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAA;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAA;IAED,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAA;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

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.', {
@@ -2315,9 +2369,10 @@ export function registerWriteTools(server, client) {
         user_id: z.string().min(1).describe('User ID (required)'),
         start_time: z.string().describe('Start time (ISO 8601 datetime, required)'),
         end_time: z.string().optional().describe('End time (ISO 8601 datetime)'),
-        hours: z.number().min(0).optional().describe('Hours worked'),
+        duration_minutes: z.number().min(0).optional().describe('Duration worked, in minutes'),
         description: z.string().optional().describe('Description'),
-        hourly_rate: z.number().min(0).optional().describe('Hourly rate'),
+        user_name: z.string().max(200).optional().describe('Display name of the user'),
+        is_billable: z.boolean().optional().describe('Whether the time is billable'),
     }, async (params) => {
         try {
             const result = await client.create('project-time-entries', buildBody(params));
@@ -2334,9 +2389,10 @@ export function registerWriteTools(server, client) {
         user_id: z.string().optional().describe('User ID'),
         start_time: z.string().optional().describe('Start time (ISO 8601 datetime)'),
         end_time: z.string().optional().describe('End time (ISO 8601 datetime)'),
-        hours: z.number().min(0).optional().describe('Hours worked'),
+        duration_minutes: z.number().min(0).optional().describe('Duration worked, in minutes'),
         description: z.string().optional().describe('Description'),
-        hourly_rate: z.number().min(0).optional().describe('Hourly rate'),
+        user_name: z.string().max(200).optional().describe('Display name of the user'),
+        is_billable: z.boolean().optional().describe('Whether the time is billable'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('project-time-entries', id, buildBody(rest));
@@ -3149,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',
@@ -3169,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',
@@ -4577,44 +4633,45 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
-    // Infrastructure Asset Classes (scope: infrastructure_asset_classes)
+    // Infrastructure Feature Classes (scope: infrastructure_feature_classes)
     // ============================================================
     const INFRA_ASSET_CLASS_CATEGORIES = [
-        'pavement',
-        'sewer',
+        'transportation',
         'water',
-        'gas',
+        'wastewater',
+        'stormwater',
+        'structures',
         'electrical',
         'telecom',
-        'structure',
-        'furniture',
+        'gas',
+        'roadside',
         'other',
     ];
-    const assetClassCode = z
+    const featureClassCode = z
         .string()
         .regex(/^[a-z][a-z0-9_]{0,49}$/)
         .describe('Asset class code (lowercase snake_case, 1-50 chars)');
-    server.tool('create_infrastructure_asset_class', 'Create a tenant-defined infrastructure asset class. Builtin classes are managed by AssetLab and cannot be created via API (is_builtin is always forced to false). Requires infrastructure_asset_classes:write scope.', {
-        code: assetClassCode,
+    server.tool('create_infrastructure_feature_class', 'Create a tenant-defined infrastructure feature class. Builtin classes are managed by AssetLab and cannot be created via API (is_builtin is always forced to false). Requires infrastructure_feature_classes:write scope.', {
+        code: featureClassCode,
         name: z.string().max(200).describe('Display name (required)'),
         category: z
             .enum(INFRA_ASSET_CLASS_CATEGORIES)
-            .describe('Category (pavement, sewer, water, gas, electrical, telecom, structure, furniture, other)'),
+            .describe('Category — municipal service family (transportation, water, wastewater, stormwater, structures, electrical, telecom, gas, roadside, other)'),
         description: z.string().optional().describe('Description'),
         icon: z.string().max(50).optional().describe('Icon name'),
         color: z.string().max(20).optional().describe('Display color (CSS color or hex)'),
         sort_order: z.number().int().optional().describe('Sort order'),
     }, async (params) => {
         try {
-            const result = await client.create('infrastructure-asset-classes', buildBody(params));
+            const result = await client.create('infrastructure-feature-classes', buildBody(params));
             return formatResult(result);
         }
         catch (err) {
             return formatError(err);
         }
     });
-    server.tool('update_infrastructure_asset_class', 'Update a tenant-defined infrastructure asset class (addressed by code). The `code`, `category`, and `is_builtin` fields are immutable; attempts to change them on a builtin class return 409. Requires infrastructure_asset_classes:write scope.', {
-        code: assetClassCode,
+    server.tool('update_infrastructure_feature_class', 'Update a tenant-defined infrastructure feature class (addressed by code). The `code`, `category`, and `is_builtin` fields are immutable; attempts to change them on a builtin class return 409. Requires infrastructure_feature_classes:write scope.', {
+        code: featureClassCode,
         name: z.string().max(200).optional().describe('Display name'),
         description: z.string().optional().describe('Description'),
         icon: z.string().max(50).optional().describe('Icon name'),
@@ -4622,16 +4679,16 @@ export function registerWriteTools(server, client) {
         sort_order: z.number().int().optional().describe('Sort order'),
     }, async ({ code, ...rest }) => {
         try {
-            const result = await client.update('infrastructure-asset-classes', code, buildBody(rest));
+            const result = await client.update('infrastructure-feature-classes', code, buildBody(rest));
             return formatResult(result);
         }
         catch (err) {
             return formatError(err);
         }
     });
-    server.tool('delete_infrastructure_asset_class', 'Delete a tenant-defined infrastructure asset class by code. Builtin classes cannot be deleted. Classes referenced by any infrastructure network are protected by FK and cannot be deleted until those networks are reassigned. Requires infrastructure_asset_classes:write scope.', { code: assetClassCode }, async ({ code }) => {
+    server.tool('delete_infrastructure_feature_class', 'Delete a tenant-defined infrastructure feature class by code. Builtin classes cannot be deleted. Classes referenced by any infrastructure network are protected by FK and cannot be deleted until those networks are reassigned. Requires infrastructure_feature_classes:write scope.', { code: featureClassCode }, async ({ code }) => {
         try {
-            const result = await client.remove('infrastructure-asset-classes', code);
+            const result = await client.remove('infrastructure-feature-classes', code);
             return formatResult(result);
         }
         catch (err) {
@@ -4641,9 +4698,9 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // Infrastructure Networks (scope: infrastructure_networks)
     // ============================================================
-    server.tool('create_infrastructure_network', 'Create an infrastructure network — a named grouping of features bound to one asset class. Requires infrastructure_networks:write scope.', {
+    server.tool('create_infrastructure_network', 'Create an infrastructure network — a named grouping of features bound to one feature class. Requires infrastructure_networks:write scope.', {
         name: z.string().max(200).describe('Network name (required)'),
-        asset_class: assetClassCode.describe('Asset class code (must exist; resolve via list_infrastructure_asset_classes)'),
+        feature_class: featureClassCode.describe('Asset class code (must exist; resolve via list_infrastructure_feature_classes)'),
         description: z.string().optional().describe('Description'),
         color_scheme: z.string().max(50).optional().describe('Display color scheme'),
         metadata: z.record(z.unknown()).optional().describe('Free-form JSON metadata'),
@@ -4659,7 +4716,7 @@ export function registerWriteTools(server, client) {
     server.tool('update_infrastructure_network', 'Update an existing infrastructure network by ID. Requires infrastructure_networks:write scope.', {
         id: z.string().uuid().describe('Infrastructure network ID'),
         name: z.string().max(200).optional().describe('Network name'),
-        asset_class: assetClassCode.optional().describe('Asset class code'),
+        feature_class: featureClassCode.optional().describe('Asset class code'),
         description: z.string().optional().describe('Description'),
         color_scheme: z.string().max(50).optional().describe('Display color scheme'),
         metadata: z.record(z.unknown()).optional().describe('Free-form JSON metadata'),