@assetlab/mcp-server 2.3.0 → 2.4.0

package/dist/tools-write.js

@@ -5083,6 +5083,122 @@ export function registerWriteTools(server, client) {
         }
     });
     // ============================================================
+    // Asset Lifecycle Events (scope: asset_lifecycle_events)
+    // ============================================================
+    const assetLifecycleEventFields = {
+        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); an asset 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)'),
+        fixed_cost: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('Fixed cost per application (current dollars, never indexed)'),
+        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 an asset'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_asset_lifecycle_event', "Create a facility lifecycle strategy event. Events attach to an asset-type SCOPE — exactly ONE of asset_type_id or asset_type_group_id — never to individual assets; an asset resolves its type's own strategy first, else its type group's. Replacement is NOT an event (it stays the renewal forecast + replacement value) — model the interventions BEFORE replacement: roof recoats, boiler retubes, overhauls. Resolve type ids with list_asset_types / list_asset_type_groups, and list existing events first to reuse a scope. Requires asset_lifecycle_events:write scope.", {
+        name: z.string().max(200).describe('Event name (required, e.g. "Roof recoat")'),
+        asset_type_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset type the strategy scope applies to (exactly one of the two scope ids)'),
+        asset_type_group_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe('Asset type group the scope applies to (exactly one of the two scope ids)'),
+        ...assetLifecycleEventFields,
+    }, async (params) => {
+        try {
+            const result = await client.create('asset-lifecycle-events', buildBody(params));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('update_asset_lifecycle_event', 'Update a facility 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 asset_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: assetLifecycleEventFields.event_class.optional(),
+        trigger_condition_max: assetLifecycleEventFields.trigger_condition_max.optional(),
+        trigger_condition_min: assetLifecycleEventFields.trigger_condition_min,
+        impact_method: assetLifecycleEventFields.impact_method.optional(),
+        impact_add_years: assetLifecycleEventFields.impact_add_years,
+        impact_reset_to: assetLifecycleEventFields.impact_reset_to,
+        fixed_cost: assetLifecycleEventFields.fixed_cost,
+        cost_source: assetLifecycleEventFields.cost_source,
+        max_applications: assetLifecycleEventFields.max_applications,
+        min_years_between: assetLifecycleEventFields.min_years_between,
+        sort_order: assetLifecycleEventFields.sort_order,
+    }, async ({ id, ...rest }) => {
+        try {
+            const result = await client.update('asset-lifecycle-events', id, buildBody(rest));
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    server.tool('delete_asset_lifecycle_event', 'Delete a facility lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires asset_lifecycle_events:write scope.', { id: z.string().uuid().describe('Lifecycle event ID') }, async ({ id }) => {
+        try {
+            const result = await client.remove('asset-lifecycle-events', id);
+            return formatResult(result);
+        }
+        catch (err) {
+            return formatError(err);
+        }
+    });
+    // ============================================================
     // Asset Condition Assessments (scope: asset_condition_assessments)
     // ============================================================
     server.tool('create_asset_condition_assessment', 'Record a point-in-time condition assessment against an asset. Requires asset_condition_assessments:write scope. Call list_assets first to resolve asset_id.', {