@assetlab/mcp-server 1.27.0 → 2.0.1

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

@@ -20,7 +20,17 @@ function buildBody(params) {
     return body;
 }
 const PM_RESOURCE_TYPES = ['TOOL', 'PART', 'MATERIAL', 'EQUIPMENT'];
-const FORM_TEMPLATE_CATEGORIES = ['task_checklist', 'inspection', 'compliance', 'survey'];
+// Shared by the four PM tools: linking a form here makes every work order the schedule
+// generates carry a copy of that form for the technician to fill in.
+const FORM_TEMPLATE_LINK_SCHEMA = z
+    .string()
+    .uuid()
+    .optional()
+    .describe('Form template ID to attach to every work order this generates — resolve via list_form_templates. Use a PUBLISHED template: generation resolves the current published version of the form, so a draft attaches nothing until it is published.');
+// Work orders and PM schedules store each association twice — a singular id and a plural array.
+// The API mirrors whichever side is sent, but callers still need the arrays to associate several
+// records at once (and systems, which have no singular field at all).
+const ASSOCIATION_ARRAY_SCHEMA = (description) => z.array(z.string().uuid()).optional().describe(description);
 const FORM_TEMPLATE_STATUSES = ['draft', 'published', 'archived'];
 const FORM_ITEM_TYPES = [
     'section',
@@ -109,8 +119,15 @@ export function registerWriteTools(server, client) {
             .string()
             .uuid()
             .optional()
-            .describe('Location ID — resolve last via list_locations filtered by building_id'),
-        asset_id: z.string().uuid().optional().describe('Asset ID'),
+            .describe('Location this work order is for — resolve last via list_locations filtered by building_id. The server mirrors it into location_ids, so send this OR location_ids, not a conflicting pair.'),
+        asset_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset this work order is for — resolve via list_assets. The server mirrors it into asset_ids.'),
+        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.'),
         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'),
@@ -161,8 +178,15 @@ export function registerWriteTools(server, client) {
             .string()
             .uuid()
             .optional()
-            .describe('Location ID — resolve last via list_locations filtered by building_id'),
-        asset_id: z.string().uuid().optional().describe('Asset ID'),
+            .describe('Location this work order is for — resolve last via list_locations filtered by building_id. The server mirrors it into location_ids, so send this OR location_ids, not a conflicting pair.'),
+        asset_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset this work order is for — resolve via list_assets. The server mirrors it into asset_ids.'),
+        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.'),
         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'),
@@ -897,9 +921,9 @@ export function registerWriteTools(server, client) {
             .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'),
-        location_ids: z.array(z.string().uuid()).optional().describe('Array of location IDs'),
+        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.'),
         tasks: z
             .array(z.object({
             id: z.string().describe('Unique task ID (use a random string)'),
@@ -908,6 +932,7 @@ export function registerWriteTools(server, client) {
         }))
             .optional()
             .describe('Checklist of tasks for this PM schedule'),
+        form_template_id: FORM_TEMPLATE_LINK_SCHEMA,
     }, async (params) => {
         try {
             const result = await client.create('pm-schedules', buildBody(params));
@@ -971,9 +996,9 @@ export function registerWriteTools(server, client) {
             .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'),
-        location_ids: z.array(z.string().uuid()).optional().describe('Array of location IDs'),
+        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.'),
         tasks: z
             .array(z.object({
             id: z.string().describe('Unique task ID'),
@@ -982,6 +1007,7 @@ export function registerWriteTools(server, client) {
         }))
             .optional()
             .describe('Checklist of tasks for this PM schedule'),
+        form_template_id: FORM_TEMPLATE_LINK_SCHEMA,
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('pm-schedules', id, buildBody(rest));
@@ -1066,6 +1092,7 @@ export function registerWriteTools(server, client) {
             .array(z.string().uuid())
             .optional()
             .describe('Default location IDs to seed on derived schedules'),
+        form_template_id: FORM_TEMPLATE_LINK_SCHEMA,
     }, async (params) => {
         try {
             const result = await client.create('pm-templates', buildBody(normalizePmTemplateBody(params)));
@@ -1129,6 +1156,7 @@ export function registerWriteTools(server, client) {
         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'),
+        form_template_id: FORM_TEMPLATE_LINK_SCHEMA,
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('pm-templates', id, buildBody(normalizePmTemplateBody(rest)));
@@ -1153,10 +1181,11 @@ export function registerWriteTools(server, client) {
     server.tool('create_form_template', 'Create a form template — a reusable inspection, checklist, compliance, or survey definition. Step 1 of building a form: create it as a draft, then add questions with create_form_template_item (or bulk_create on form-template-items), then publish with update_form_template status=published (publishing is rejected if any question is malformed). Requires form_templates:write scope.', {
         name: z.string().min(1).max(500).describe('Form template name (required)'),
         description: z.string().max(5000).optional().describe('Description'),
-        category: z
-            .enum(FORM_TEMPLATE_CATEGORIES)
+        work_category_id: z
+            .string()
+            .uuid()
             .optional()
-            .describe('Form category: inspection (default), task_checklist, compliance, or survey. Manufacturer-recommended equipment checks → inspection.'),
+            .describe('Work category ID — the same tenant-configured categories used by work orders (e.g. Electrical, Plumbing, HVAC). Look them up with list_work_categories and pick the closest match; omit if none fits.'),
         status: z
             .enum(FORM_TEMPLATE_STATUSES)
             .optional()
@@ -1174,10 +1203,11 @@ export function registerWriteTools(server, client) {
         id: z.string().uuid().describe('Form template ID'),
         name: z.string().min(1).max(500).optional().describe('Form template name'),
         description: z.string().max(5000).optional().describe('Description'),
-        category: z
-            .enum(FORM_TEMPLATE_CATEGORIES)
+        work_category_id: z
+            .string()
+            .uuid()
             .optional()
-            .describe('Form category (task_checklist, inspection, compliance, or survey)'),
+            .describe('Work category ID (look up with list_work_categories)'),
         status: z
             .enum(FORM_TEMPLATE_STATUSES)
             .optional()
@@ -1286,6 +1316,44 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // 8d. Form responses — attach / detach (scope: form_responses)
+    // ============================================================
+    server.tool('create_form_response', "Attach a published form to one record so it can be filled in — the direct way to put an inspection or checklist on an existing work order. The form's questions are snapshotted at attach time, so later edits to the template never change a form already in progress. To put a form on every work order a PM schedule generates, set form_template_id on the schedule instead of calling this per work order. Answering and completing the form happen in the AssetLab app, not through this API. Requires form_responses:write scope.", {
+        template_id: z
+            .string()
+            .uuid()
+            .describe('Published form template ID — resolve via list_form_templates. A draft or archived template is rejected; publish it first with update_form_template status="published".'),
+        subject_type: z
+            .enum(['work_order', 'pm_schedule', 'infrastructure_asset', 'compliance_record', 'site'])
+            .describe('What kind of record the form is being attached to'),
+        subject_id: z
+            .string()
+            .uuid()
+            .describe('ID of the record — resolve via the matching list tool (list_work_orders, list_pm_schedules, list_infrastructure_assets, list_compliance_records, list_sites)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('form-responses', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_form_response', 'Remove a form from the record it is attached to, along with any answers already given. Use this before attaching a different form, since a record holds at most one form. Requires form_responses:write scope.', {
+        id: z
+            .string()
+            .uuid()
+            .describe('Form response ID — resolve via list_form_responses filtered by subject_id'),
+    }, async ({ id }) => {
+        try {
+            const result = await client.remove('form-responses', 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.', {
@@ -2247,9 +2315,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));
@@ -2266,9 +2335,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));
@@ -4280,6 +4350,7 @@ export function registerWriteTools(server, client) {
         'pm-templates',
         'form-templates',
         'form-template-items',
+        'form-responses',
         'projects',
         'contracts',
         'invoices',
@@ -4508,44 +4579,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'),
@@ -4553,16 +4625,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) {
@@ -4572,9 +4644,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'),
@@ -4590,7 +4662,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'),