@assetlab/mcp-server 1.20.0 → 1.23.0

package/dist/tools-write.js

@@ -1669,7 +1669,7 @@ export function registerWriteTools(server, client) {
     // ============================================================
     // 18. Asset Costs (scope: asset_costs)
     // ============================================================
-    server.tool('create_asset_cost', 'Create a new asset cost entry. Requires asset_costs:write scope.', {
+    server.tool('create_asset_cost', 'Create a new asset cost entry — the record type shown on the AssetLab "Expenses" page. Requires asset_costs:write scope.', {
         category: z
             .enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other'])
             .describe('Cost category (required)'),
@@ -1680,6 +1680,8 @@ export function registerWriteTools(server, client) {
         building_id: z.string().uuid().optional().describe('Building ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
         description: z.string().optional().describe('Description'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number (free text)'),
+        po_number: z.string().max(200).optional().describe('Purchase order number (free text)'),
     }, async (params) => {
         try {
             const result = await client.create('asset-costs', buildBody(params));
@@ -1689,7 +1691,7 @@ export function registerWriteTools(server, client) {
             return formatError(err);
         }
     });
-    server.tool('update_asset_cost', 'Update an existing asset cost entry by ID. Requires asset_costs:write scope.', {
+    server.tool('update_asset_cost', 'Update an existing asset cost entry by ID — the record type shown on the AssetLab "Expenses" page. Requires asset_costs:write scope.', {
         id: z.string().uuid().describe('Asset cost ID'),
         category: z
             .enum(['Repair', 'PM', 'Operation', 'Replacement', 'Decommission', 'Other'])
@@ -1702,6 +1704,8 @@ export function registerWriteTools(server, client) {
         building_id: z.string().uuid().optional().describe('Building ID'),
         work_order_id: z.string().uuid().optional().describe('Work order ID'),
         description: z.string().optional().describe('Description'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number (free text)'),
+        po_number: z.string().max(200).optional().describe('Purchase order number (free text)'),
     }, async ({ id, ...rest }) => {
         try {
             const result = await client.update('asset-costs', id, buildBody(rest));
@@ -4107,6 +4111,7 @@ export function registerWriteTools(server, client) {
         'floorplans',
         'floorplan-regions',
         'asset-placements',
+        'infrastructure-assets',
     ];
     server.tool('bulk_create', 'Create multiple records of a resource type in one API call (max 100). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {
         resource: z.enum(BULK_RESOURCES).describe('Resource type (e.g. "assets", "work-orders")'),
@@ -4280,6 +4285,589 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Infrastructure Asset Classes (scope: infrastructure_asset_classes)
+    // ============================================================
+    const INFRA_ASSET_CLASS_CATEGORIES = [
+        'pavement',
+        'sewer',
+        'water',
+        'gas',
+        'electrical',
+        'telecom',
+        'structure',
+        'furniture',
+        'other',
+    ];
+    const assetClassCode = 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,
+        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)'),
+        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));
+            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,
+        name: z.string().max(200).optional().describe('Display name'),
+        description: z.string().optional().describe('Description'),
+        icon: z.string().max(50).optional().describe('Icon name'),
+        color: z.string().max(20).optional().describe('Display color'),
+        sort_order: z.number().int().optional().describe('Sort order'),
+    }, async ({ code, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-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 }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-classes', code);
+            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 asset 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)'),
+        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'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-networks', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    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'),
+        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'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-networks', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_network', 'Delete an infrastructure network by ID. Cascades to all features in the network — confirm with the user before deleting. Requires infrastructure_networks:write scope.', { id: z.string().uuid().describe('Infrastructure network ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-networks', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Assets / Features (scope: infrastructure_assets)
+    // ============================================================
+    const pointGeometry = z.object({
+        type: z.literal('Point'),
+        coordinates: z.tuple([z.number(), z.number()]),
+    });
+    const lineStringGeometry = z.object({
+        type: z.literal('LineString'),
+        coordinates: z.array(z.tuple([z.number(), z.number()])).min(2),
+    });
+    const featureGeometry = z.union([pointGeometry, lineStringGeometry]);
+    const FEATURE_TYPES = ['segment', 'node'];
+    const FLOW_DIRECTIONS = ['with_geometry', 'against_geometry'];
+    const POSITIONAL_ACCURACY = ['survey_grade', 'mapping_grade', 'sketch', 'unknown'];
+    server.tool('create_infrastructure_asset', 'Create an infrastructure asset (feature — segment or node). Geometry must be GeoJSON Point (for nodes) or LineString (for segments) in EPSG:4326; coordinates are [longitude, latitude]. `length_m`, `slope_pct`, and `risk_score` are computed server-side. Requires infrastructure_assets:write scope.', {
+        network_id: z.string().uuid().describe('Infrastructure network ID (required)'),
+        feature_type: z.enum(FEATURE_TYPES).describe('"segment" (LineString) or "node" (Point)'),
+        geometry: featureGeometry.describe('GeoJSON geometry — Point for nodes, LineString for segments'),
+        name: z.string().max(500).optional().describe('Feature name'),
+        description: z.string().optional().describe('Description'),
+        external_ids: z.record(z.unknown()).optional().describe('Free-form external ID map'),
+        from_street: z.string().max(200).optional().describe('From street (segments)'),
+        to_street: z.string().max(200).optional().describe('To street (segments)'),
+        image_url: z.string().optional().describe('Image URL'),
+        qr_code: z.string().max(200).optional().describe('QR code'),
+        from_feature_id: z.string().uuid().optional().describe('From-node feature ID (segments)'),
+        to_feature_id: z.string().uuid().optional().describe('To-node feature ID (segments)'),
+        flow_direction: z.enum(FLOW_DIRECTIONS).optional().describe('Flow direction'),
+        asset_type_id: z.string().uuid().optional().describe('Asset type ID'),
+        manufacturer_id: z.string().uuid().optional().describe('Manufacturer ID'),
+        system_class_id: z.string().uuid().optional().describe('System class ID'),
+        system_group_id: z.string().uuid().optional().describe('System group ID'),
+        system_id: z.string().uuid().optional().describe('System ID'),
+        model: z.string().max(200).optional().describe('Model'),
+        serial_number: z.string().max(200).optional().describe('Serial number'),
+        site_id: z.string().uuid().optional().describe('Site ID'),
+        building_id: z.string().uuid().optional().describe('Building ID'),
+        location_id: z.string().uuid().optional().describe('Location ID'),
+        status_id: z.string().optional().describe('Asset status ID'),
+        condition_score: z.number().min(0).max(100).optional().describe('Condition score (0-100)'),
+        last_maintenance_date: z.string().optional().describe('Last maintenance date (YYYY-MM-DD)'),
+        risk_factor: z.string().optional().describe('Risk factor: CRITICAL, HIGH, MEDIUM, LOW'),
+        consequence_of_failure_score: z.number().min(0).max(100).optional(),
+        likelihood_of_failure_score: z.number().min(0).max(100).optional(),
+        safety_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        service_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        environmental_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        financial_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        regulatory_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        reputation_impact: z.string().optional().describe('LOW, MEDIUM, HIGH, CRITICAL'),
+        purchase_cost: z.number().min(0).optional().describe('Purchase cost'),
+        purchase_date: z.string().optional().describe('Purchase date (YYYY-MM-DD)'),
+        install_date: z.string().optional().describe('Install date (YYYY-MM-DD)'),
+        expected_lifetime_years: z.number().min(0).optional().describe('Expected lifetime (years)'),
+        salvage_value: z.number().min(0).optional().describe('Salvage value'),
+        salvage_value_percentage: z.number().min(0).max(100).optional(),
+        quantity: z.number().min(0).optional().describe('Quantity'),
+        unit_of_measure: z.string().max(50).optional().describe('Unit of measure'),
+        unit_replacement_value: z.number().min(0).optional().describe('Unit replacement value'),
+        purchase_cost_calculation_method: z
+            .enum(['manual', 'calculated_sqft', 'calculated_unit'])
+            .optional()
+            .describe('Cost calc method'),
+        material: z.string().max(200).optional().describe('Material'),
+        diameter_mm: z.number().min(0).optional().describe('Diameter (mm)'),
+        width_m: z.number().min(0).optional().describe('Width (m)'),
+        lanes: z.number().int().min(0).optional().describe('Lane count'),
+        depth_m: z.number().min(0).optional().describe('Depth (m)'),
+        from_invert_m: z.number().optional().describe('From-invert elevation (m)'),
+        to_invert_m: z.number().optional().describe('To-invert elevation (m)'),
+        positional_accuracy_class: z
+            .enum(POSITIONAL_ACCURACY)
+            .optional()
+            .describe('Positional accuracy class'),
+        data_source: z.string().max(200).optional().describe('Data source'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-assets', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset', 'Update an existing infrastructure asset (feature) by ID. To change geometry, provide a new GeoJSON Point/LineString matching the existing feature_type. Computed columns (length_m, slope_pct, risk_score) cannot be set. Requires infrastructure_assets:write scope.', {
+        id: z.string().uuid().describe('Infrastructure asset ID'),
+        geometry: featureGeometry.optional().describe('Replacement GeoJSON geometry'),
+        name: z.string().max(500).optional(),
+        description: z.string().optional(),
+        external_ids: z.record(z.unknown()).optional(),
+        from_street: z.string().max(200).optional(),
+        to_street: z.string().max(200).optional(),
+        image_url: z.string().optional(),
+        qr_code: z.string().max(200).optional(),
+        from_feature_id: z.string().uuid().optional(),
+        to_feature_id: z.string().uuid().optional(),
+        flow_direction: z.enum(FLOW_DIRECTIONS).optional(),
+        asset_type_id: z.string().uuid().optional(),
+        manufacturer_id: z.string().uuid().optional(),
+        system_class_id: z.string().uuid().optional(),
+        system_group_id: z.string().uuid().optional(),
+        system_id: z.string().uuid().optional(),
+        model: z.string().max(200).optional(),
+        serial_number: z.string().max(200).optional(),
+        site_id: z.string().uuid().optional(),
+        building_id: z.string().uuid().optional(),
+        location_id: z.string().uuid().optional(),
+        status_id: z.string().optional(),
+        condition_score: z.number().min(0).max(100).optional(),
+        last_maintenance_date: z.string().optional(),
+        risk_factor: z.string().optional(),
+        consequence_of_failure_score: z.number().min(0).max(100).optional(),
+        likelihood_of_failure_score: z.number().min(0).max(100).optional(),
+        safety_impact: z.string().optional(),
+        service_impact: z.string().optional(),
+        environmental_impact: z.string().optional(),
+        financial_impact: z.string().optional(),
+        regulatory_impact: z.string().optional(),
+        reputation_impact: z.string().optional(),
+        purchase_cost: z.number().min(0).optional(),
+        purchase_date: z.string().optional(),
+        install_date: z.string().optional(),
+        expected_lifetime_years: z.number().min(0).optional(),
+        salvage_value: z.number().min(0).optional(),
+        salvage_value_percentage: z.number().min(0).max(100).optional(),
+        quantity: z.number().min(0).optional(),
+        unit_of_measure: z.string().max(50).optional(),
+        unit_replacement_value: z.number().min(0).optional(),
+        purchase_cost_calculation_method: z
+            .enum(['manual', 'calculated_sqft', 'calculated_unit'])
+            .optional(),
+        material: z.string().max(200).optional(),
+        diameter_mm: z.number().min(0).optional(),
+        width_m: z.number().min(0).optional(),
+        lanes: z.number().int().min(0).optional(),
+        depth_m: z.number().min(0).optional(),
+        from_invert_m: z.number().optional(),
+        to_invert_m: z.number().optional(),
+        positional_accuracy_class: z.enum(POSITIONAL_ACCURACY).optional(),
+        data_source: z.string().max(200).optional(),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-assets', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset', 'Soft-delete an infrastructure asset (feature) by ID (sets deleted_at). Requires infrastructure_assets:write scope.', { id: z.string().uuid().describe('Infrastructure asset ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-assets', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Asset Inspections (scope: infrastructure_asset_inspections)
+    // ============================================================
+    server.tool('create_infrastructure_asset_inspection', 'Record an inspection against an infrastructure feature. Requires infrastructure_asset_inspections:write scope.', {
+        feature_id: z.string().uuid().describe('Infrastructure asset (feature) ID (required)'),
+        inspection_date: z.string().describe('Inspection date (YYYY-MM-DD, required)'),
+        inspector_id: z.string().optional().describe('Inspector user ID'),
+        method: z.string().max(100).optional().describe('Inspection method (e.g. CCTV, visual)'),
+        condition_score: z.number().min(0).max(100).optional().describe('Condition score (0-100)'),
+        defects: z.record(z.unknown()).optional().describe('Defect observations (JSON)'),
+        notes: z.string().optional().describe('Free-form notes'),
+        attachments: z.array(z.string()).optional().describe('Attachment URLs/paths'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-asset-inspections', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset_inspection', 'Update an existing infrastructure asset inspection by ID. Requires infrastructure_asset_inspections:write scope.', {
+        id: z.string().uuid().describe('Inspection ID'),
+        inspection_date: z.string().optional().describe('Inspection date (YYYY-MM-DD)'),
+        inspector_id: z.string().optional().describe('Inspector user ID'),
+        method: z.string().max(100).optional().describe('Inspection method'),
+        condition_score: z.number().min(0).max(100).optional().describe('Condition score'),
+        defects: z.record(z.unknown()).optional().describe('Defect observations'),
+        notes: z.string().optional().describe('Notes'),
+        attachments: z.array(z.string()).optional().describe('Attachment URLs/paths'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-inspections', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset_inspection', 'Soft-delete an infrastructure asset inspection by ID. Requires infrastructure_asset_inspections:write scope.', { id: z.string().uuid().describe('Inspection ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-inspections', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Asset Costs (scope: infrastructure_asset_costs)
+    // ============================================================
+    const INFRA_COST_CATEGORIES = [
+        'Repair',
+        'PM',
+        'Operation',
+        'Replacement',
+        'Decommission',
+    ];
+    server.tool('create_infrastructure_asset_cost', 'Record a cost against an infrastructure feature. work_order_number is derived server-side from work_order_id; do not set it. Requires infrastructure_asset_costs:write scope.', {
+        feature_id: z.string().uuid().describe('Infrastructure feature ID (required)'),
+        category: z.enum(INFRA_COST_CATEGORIES).describe('Cost category (required)'),
+        amount: z.number().min(0).describe('Cost amount (required)'),
+        cost_date: z.string().describe('Cost date (YYYY-MM-DD, required)'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number'),
+        po_number: z.string().max(200).optional().describe('PO number'),
+        work_order_id: z.string().uuid().optional().describe('Linked work order ID'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-asset-costs', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset_cost', 'Update an infrastructure asset cost by ID. Requires infrastructure_asset_costs:write scope.', {
+        id: z.string().uuid().describe('Cost ID'),
+        category: z.enum(INFRA_COST_CATEGORIES).optional().describe('Cost category'),
+        amount: z.number().min(0).optional().describe('Cost amount'),
+        cost_date: z.string().optional().describe('Cost date (YYYY-MM-DD)'),
+        invoice_number: z.string().max(200).optional().describe('Invoice number'),
+        po_number: z.string().max(200).optional().describe('PO number'),
+        work_order_id: z.string().uuid().optional().describe('Linked work order ID'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-costs', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset_cost', 'Delete an infrastructure asset cost by ID. Requires infrastructure_asset_costs:write scope.', { id: z.string().uuid().describe('Cost ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-costs', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Asset Parts (scope: infrastructure_asset_parts)
+    // ============================================================
+    server.tool('create_infrastructure_asset_part', 'Associate a part with an infrastructure feature. The (feature_id, part_id) pair must be unique — a duplicate returns 409. Requires infrastructure_asset_parts:write scope.', {
+        feature_id: z.string().uuid().describe('Infrastructure feature ID (required)'),
+        part_id: z.string().uuid().describe('Part ID (required; resolve via list_parts)'),
+        quantity: z.number().min(0).optional().describe('Design/installed quantity (default 1)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-asset-parts', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset_part', 'Update an infrastructure asset part association by ID. Requires infrastructure_asset_parts:write scope.', {
+        id: z.string().uuid().describe('Association ID'),
+        feature_id: z.string().uuid().optional().describe('Infrastructure feature ID'),
+        part_id: z.string().uuid().optional().describe('Part ID'),
+        quantity: z.number().min(0).optional().describe('Design/installed quantity'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-parts', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset_part', 'Delete an infrastructure asset part association by ID. Requires infrastructure_asset_parts:write scope.', { id: z.string().uuid().describe('Association ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-parts', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Asset Documents (scope: infrastructure_asset_documents)
+    // ============================================================
+    server.tool('create_infrastructure_asset_document', 'Attach document metadata to an infrastructure feature. Upload the file bytes first via create_upload_url, then pass the returned file_path here. Requires infrastructure_asset_documents:write scope.', {
+        feature_id: z.string().uuid().describe('Infrastructure feature ID (required)'),
+        name: z.string().max(500).describe('Document name (required)'),
+        file_path: z.string().max(2000).describe('Storage path from create_upload_url (required)'),
+        description: z.string().optional().describe('Description'),
+        file_type: z.string().max(200).optional().describe('MIME type'),
+        file_size: z.number().min(0).optional().describe('File size in bytes'),
+        category: z.string().max(100).optional().describe('Document category'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-asset-documents', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset_document', 'Update infrastructure asset document metadata by ID. Requires infrastructure_asset_documents:write scope.', {
+        id: z.string().uuid().describe('Document ID'),
+        name: z.string().max(500).optional().describe('Document name'),
+        file_path: z.string().max(2000).optional().describe('Storage path'),
+        description: z.string().optional().describe('Description'),
+        file_type: z.string().max(200).optional().describe('MIME type'),
+        file_size: z.number().min(0).optional().describe('File size in bytes'),
+        category: z.string().max(100).optional().describe('Document category'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-documents', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset_document', 'Delete an infrastructure asset document by ID. Requires infrastructure_asset_documents:write scope.', { id: z.string().uuid().describe('Document ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-documents', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Asset Comments (scope: infrastructure_asset_comments)
+    // ============================================================
+    server.tool('create_infrastructure_asset_comment', 'Add a comment to an infrastructure feature. The author is attributed to the API key automatically; do not pass user_id. Requires infrastructure_asset_comments:write scope.', {
+        feature_id: z.string().uuid().describe('Infrastructure feature ID (required)'),
+        comment: z.string().max(10000).describe('Comment text (required)'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-asset-comments', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_asset_comment', 'Update an infrastructure asset comment by ID. Requires infrastructure_asset_comments:write scope.', {
+        id: z.string().uuid().describe('Comment ID'),
+        comment: z.string().max(10000).optional().describe('Comment text'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-asset-comments', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_asset_comment', 'Delete an infrastructure asset comment by ID. Requires infrastructure_asset_comments:write scope.', { id: z.string().uuid().describe('Comment ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-asset-comments', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Infrastructure Zones (scope: infrastructure_zones)
+    // ============================================================
+    const INFRA_ZONE_KINDS = [
+        'pressure_zone',
+        'dma',
+        'sewershed',
+        'storm_catchment',
+        'maintenance_district',
+    ];
+    const geoJsonPolygon = z
+        .object({
+        type: z.literal('Polygon'),
+        coordinates: z.array(z.array(z.tuple([z.number(), z.number()]))),
+    })
+        .describe('GeoJSON Polygon (EPSG:4326). Each ring is closed; coordinates are [lon, lat].');
+    server.tool('create_infrastructure_zone', 'Create an operational hydraulic boundary (pressure zone, DMA, sewershed, etc.). boundary is a GeoJSON Polygon (single polygon only; MultiPolygon is rejected). (network_id, name) must be unique. Requires infrastructure_zones:write scope.', {
+        network_id: z.string().uuid().describe('Infrastructure network ID (required)'),
+        kind: z.enum(INFRA_ZONE_KINDS).describe('Zone kind (required)'),
+        name: z.string().max(200).describe('Zone name (required)'),
+        boundary: geoJsonPolygon,
+        code: z.string().max(50).optional().describe('Optional short code (e.g. "PZ-04")'),
+        notes: z.string().optional().describe('Free-form notes'),
+    }, async (params) => {
+        try {
+            const result = await client.create('infrastructure-zones', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_infrastructure_zone', 'Update an infrastructure zone by ID. Pass boundary as a GeoJSON Polygon to replace the geometry. Requires infrastructure_zones:write scope.', {
+        id: z.string().uuid().describe('Zone ID'),
+        network_id: z.string().uuid().optional().describe('Infrastructure network ID'),
+        kind: z.enum(INFRA_ZONE_KINDS).optional().describe('Zone kind'),
+        name: z.string().max(200).optional().describe('Zone name'),
+        boundary: geoJsonPolygon.optional(),
+        code: z.string().max(50).optional().describe('Optional short code'),
+        notes: z.string().optional().describe('Free-form notes'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('infrastructure-zones', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_infrastructure_zone', 'Delete an infrastructure zone by ID. Requires infrastructure_zones:write scope.', { id: z.string().uuid().describe('Zone ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('infrastructure-zones', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
+    // Project ↔ Infrastructure Asset links (scope: project_infrastructure_assets)
+    // ============================================================
+    server.tool('create_project_infrastructure_asset', 'Link a project to an infrastructure feature. The (project_id, feature_id) pair must be unique — a duplicate returns 409. Requires project_infrastructure_assets:write scope.', {
+        project_id: z.string().uuid().describe('Project ID (required)'),
+        feature_id: z.string().uuid().describe('Infrastructure feature ID (required)'),
+        notes: z.string().optional().describe('Free-form notes'),
+    }, async (params) => {
+        try {
+            const result = await client.create('project-infrastructure-assets', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_project_infrastructure_asset', 'Update a project ↔ infrastructure feature link by ID. Requires project_infrastructure_assets:write scope.', {
+        id: z.string().uuid().describe('Link ID'),
+        project_id: z.string().uuid().optional().describe('Project ID'),
+        feature_id: z.string().uuid().optional().describe('Infrastructure feature ID'),
+        notes: z.string().optional().describe('Free-form notes'),
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('project-infrastructure-assets', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_project_infrastructure_asset', 'Delete a project ↔ infrastructure feature link by ID. Requires project_infrastructure_assets:write scope.', { id: z.string().uuid().describe('Link ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('project-infrastructure-assets', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Bulk Operations
     // ============================================================
     server.tool('bulk_update', 'Update multiple records of a resource type in one API call (max 100). Each item must include an "id" field (UUID). Each item is processed independently — one failure does not affect others. Returns per-item results. Requires {resource}:write scope. Counts as 1 request for rate limiting.', {