@access-mcp/system-status 0.5.0 → 0.6.0

package/dist/server.js

@@ -1,7 +1,30 @@
-import { BaseAccessServer, handleApiError } from "@access-mcp/shared";
+import { BaseAccessServer, handleApiError, resolveResourceId, } from "@access-mcp/shared";
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 export class SystemStatusServer extends BaseAccessServer {
     constructor() {
-        super("access-mcp-system-status", "0.4.0", "https://operations-api.access-ci.org");
+        super("access-mcp-system-status", version, "https://operations-api.access-ci.org");
+    }
+    /**
+     * Search for resources by name to resolve human-readable names to full IDs.
+     * Used by resolveResourceId callback.
+     */
+    async searchResourcesByName(query) {
+        try {
+            const response = await this.httpClient.get("/wh2/cider/v1/access-active-groups/type/resource-catalog.access-ci.org/");
+            const groups = response.data.results?.active_groups || [];
+            const queryLower = query.toLowerCase();
+            return groups
+                .filter((g) => g.group_descriptive_name?.toLowerCase().includes(queryLower))
+                .map((g) => ({
+                id: g.info_groupid || "",
+                name: g.group_descriptive_name || "",
+            }));
+        }
+        catch {
+            return [];
+        }
     }
     getTools() {
         return [
@@ -13,30 +36,30 @@ export class SystemStatusServer extends BaseAccessServer {
                     properties: {
                         query: {
                             type: "string",
-                            description: "Filter by resource name (e.g., 'delta', 'bridges2')"
+                            description: "Filter by resource name (e.g., 'delta', 'bridges2')",
                         },
                         time: {
                             type: "string",
                             enum: ["current", "scheduled", "past", "all"],
-                            description: "Period: current (active), scheduled (future), past, all",
-                            default: "current"
+                            description: "Time filter. Values: 'current' for active outages, 'scheduled' for future/planned, 'past' for historical, 'all' for everything",
+                            default: "current",
                         },
                         ids: {
                             type: "array",
                             items: { type: "string" },
-                            description: "Check status for specific resource IDs"
+                            description: "Check status for specific resources. Accepts names (e.g., 'Anvil', 'Delta') or full IDs (e.g., 'anvil.purdue.access-ci.org')",
                         },
                         limit: {
                             type: "number",
                             description: "Max results (default: 50)",
-                            default: 50
+                            default: 50,
                         },
                         use_group_api: {
                             type: "boolean",
                             description: "Use group API for status (with ids only)",
-                            default: false
-                        }
-                    }
+                            default: false,
+                        },
+                    },
                 },
             },
         ];
@@ -71,15 +94,16 @@ export class SystemStatusServer extends BaseAccessServer {
     }
     async handleToolCall(request) {
         const { name, arguments: args = {} } = request.params;
+        const typedArgs = args;
         try {
             switch (name) {
                 case "get_infrastructure_news":
                     return await this.getInfrastructureNewsRouter({
-                        resource: args.query,
-                        time: args.time,
-                        resource_ids: args.ids,
-                        limit: args.limit,
-                        use_group_api: args.use_group_api
+                        resource: typedArgs.query,
+                        time: typedArgs.time,
+                        resource_ids: typedArgs.ids,
+                        limit: typedArgs.limit,
+                        use_group_api: typedArgs.use_group_api,
                     });
                 default:
                     return this.errorResponse(`Unknown tool: ${name}`);
@@ -95,8 +119,8 @@ export class SystemStatusServer extends BaseAccessServer {
      */
     async getInfrastructureNewsRouter(args) {
         const { resource, time = "current", resource_ids, limit, use_group_api = false } = args;
-        // Check resource status (returns operational/affected)
-        if (resource_ids && Array.isArray(resource_ids)) {
+        // Check resource status (returns operational/affected) - only if IDs provided
+        if (resource_ids && Array.isArray(resource_ids) && resource_ids.length > 0) {
             return await this.checkResourceStatus(resource_ids, use_group_api);
         }
         // Time-based routing
@@ -116,7 +140,7 @@ export class SystemStatusServer extends BaseAccessServer {
     async handleResourceRead(request) {
         const { uri } = request.params;
         switch (uri) {
-            case "accessci://system-status":
+            case "accessci://system-status": {
                 return {
                     contents: [
                         {
@@ -126,39 +150,49 @@ export class SystemStatusServer extends BaseAccessServer {
                         },
                     ],
                 };
-            case "accessci://outages/current":
+            }
+            case "accessci://outages/current": {
                 const currentOutages = await this.getCurrentOutages();
+                const content = currentOutages.content[0];
+                const text = content.type === "text" ? content.text : "";
                 return {
                     contents: [
                         {
                             uri,
                             mimeType: "application/json",
-                            text: currentOutages.content[0].text,
+                            text,
                         },
                     ],
                 };
-            case "accessci://outages/scheduled":
+            }
+            case "accessci://outages/scheduled": {
                 const scheduledMaintenance = await this.getScheduledMaintenance();
+                const content = scheduledMaintenance.content[0];
+                const text = content.type === "text" ? content.text : "";
                 return {
                     contents: [
                         {
                             uri,
                             mimeType: "application/json",
-                            text: scheduledMaintenance.content[0].text,
+                            text,
                         },
                     ],
                 };
-            case "accessci://outages/past":
+            }
+            case "accessci://outages/past": {
                 const pastOutages = await this.getPastOutages();
+                const content = pastOutages.content[0];
+                const text = content.type === "text" ? content.text : "";
                 return {
                     contents: [
                         {
                             uri,
                             mimeType: "application/json",
-                            text: pastOutages.content[0].text,
+                            text,
                         },
                     ],
                 };
+            }
             default:
                 throw new Error(`Unknown resource: ${uri}`);
         }
@@ -178,9 +212,11 @@ export class SystemStatusServer extends BaseAccessServer {
         const severityCounts = { high: 0, medium: 0, low: 0, unknown: 0 };
         // Enhance outages with status summary
         const enhancedOutages = outages.map((outage) => {
-            // Track affected resources
+            // Track affected resources (use ResourceID as fallback if ResourceName is missing)
             outage.AffectedResources?.forEach((resource) => {
-                affectedResources.add(resource.ResourceName);
+                const resourceIdentifier = resource.ResourceName || resource.ResourceID;
+                if (resourceIdentifier)
+                    affectedResources.add(String(resourceIdentifier));
             });
             // Categorize severity (basic heuristic)
             const subject = outage.Subject?.toLowerCase() || "";
@@ -188,8 +224,7 @@ export class SystemStatusServer extends BaseAccessServer {
             if (subject.includes("emergency") || subject.includes("critical")) {
                 severity = "high";
             }
-            else if (subject.includes("maintenance") ||
-                subject.includes("scheduled")) {
+            else if (subject.includes("maintenance") || subject.includes("scheduled")) {
                 severity = "low";
             }
             else {
@@ -228,8 +263,8 @@ export class SystemStatusServer extends BaseAccessServer {
         }
         // Sort by scheduled start time
         maintenance.sort((a, b) => {
-            const dateA = new Date(a.OutageStart);
-            const dateB = new Date(b.OutageStart);
+            const dateA = new Date(a.OutageStart || "");
+            const dateB = new Date(b.OutageStart || "");
             return dateA.getTime() - dateB.getTime();
         });
         // Initialize tracking variables
@@ -239,11 +274,13 @@ export class SystemStatusServer extends BaseAccessServer {
         const enhancedMaintenance = maintenance.map((item) => {
             // Track affected resources
             item.AffectedResources?.forEach((resource) => {
-                affectedResources.add(resource.ResourceName);
+                const resourceIdentifier = resource.ResourceName || resource.ResourceID;
+                if (resourceIdentifier)
+                    affectedResources.add(String(resourceIdentifier));
             });
             // Check timing - use OutageStart for scheduling
             const hasScheduledTime = !!item.OutageStart;
-            const startTime = new Date(item.OutageStart);
+            const startTime = new Date(item.OutageStart || "");
             const now = new Date();
             const hoursUntil = (startTime.getTime() - now.getTime()) / (1000 * 60 * 60);
             if (hoursUntil <= 24)
@@ -256,8 +293,7 @@ export class SystemStatusServer extends BaseAccessServer {
                 scheduled_end: item.OutageEnd,
                 hours_until_start: Math.max(0, Math.round(hoursUntil)),
                 duration_hours: item.OutageEnd && item.OutageStart
-                    ? Math.round((new Date(item.OutageEnd).getTime() -
-                        new Date(item.OutageStart).getTime()) /
+                    ? Math.round((new Date(item.OutageEnd).getTime() - new Date(item.OutageStart).getTime()) /
                         (1000 * 60 * 60))
                     : null,
                 has_scheduled_time: hasScheduledTime,
@@ -291,8 +327,8 @@ export class SystemStatusServer extends BaseAccessServer {
         }
         // Sort by outage end time (most recent first)
         pastOutages.sort((a, b) => {
-            const dateA = new Date(a.OutageEnd);
-            const dateB = new Date(b.OutageEnd);
+            const dateA = new Date(a.OutageEnd || "");
+            const dateB = new Date(b.OutageEnd || "");
             return dateB.getTime() - dateA.getTime();
         });
         // Apply limit
@@ -303,23 +339,25 @@ export class SystemStatusServer extends BaseAccessServer {
         const affectedResources = new Set();
         const outageTypes = new Set();
         const recentOutages = pastOutages.filter((outage) => {
-            const endTime = new Date(outage.OutageEnd);
+            const endTime = new Date(outage.OutageEnd || "");
             const daysAgo = (Date.now() - endTime.getTime()) / (1000 * 60 * 60 * 24);
             return daysAgo <= 30; // Last 30 days
         });
         // Enhance outages with calculated fields
         const enhancedOutages = pastOutages.map((outage) => {
-            // Track affected resources
+            // Track affected resources (use ResourceID as fallback if ResourceName is missing)
             outage.AffectedResources?.forEach((resource) => {
-                affectedResources.add(resource.ResourceName);
+                const resourceIdentifier = resource.ResourceName || resource.ResourceID;
+                if (resourceIdentifier)
+                    affectedResources.add(String(resourceIdentifier));
             });
             // Track outage types
             if (outage.OutageType) {
                 outageTypes.add(outage.OutageType);
             }
             // Calculate duration
-            const startTime = new Date(outage.OutageStart);
-            const endTime = new Date(outage.OutageEnd);
+            const startTime = new Date(outage.OutageStart || "");
+            const endTime = new Date(outage.OutageEnd || "");
             const durationHours = Math.round((endTime.getTime() - startTime.getTime()) / (1000 * 60 * 60));
             // Calculate how long ago it ended
             const daysAgo = Math.round((Date.now() - endTime.getTime()) / (1000 * 60 * 60 * 24));
@@ -339,9 +377,9 @@ export class SystemStatusServer extends BaseAccessServer {
             outage_types: Array.from(outageTypes),
             average_duration_hours: enhancedOutages.length > 0
                 ? Math.round(enhancedOutages
-                    .filter((o) => o.duration_hours > 0)
-                    .reduce((sum, o) => sum + o.duration_hours, 0) /
-                    enhancedOutages.filter((o) => o.duration_hours > 0).length)
+                    .filter((o) => o.duration_hours && o.duration_hours > 0)
+                    .reduce((sum, o) => sum + (o.duration_hours || 0), 0) /
+                    enhancedOutages.filter((o) => o.duration_hours && o.duration_hours > 0).length)
                 : 0,
             outages: enhancedOutages,
         };
@@ -363,27 +401,30 @@ export class SystemStatusServer extends BaseAccessServer {
         ]);
         const currentOutages = currentResponse.data.results || [];
         const futureOutages = futureResponse.data.results || [];
-        const pastOutages = pastResponse.data.results || [];
+        const pastOutagesData = pastResponse.data.results || [];
         // Filter recent past outages (last 30 days) for announcements
-        const recentPastOutages = pastOutages.filter((outage) => {
-            const endTime = new Date(outage.OutageEnd);
+        const recentPastOutages = pastOutagesData.filter((outage) => {
+            const endTime = new Date(outage.OutageEnd || "");
             const daysAgo = (Date.now() - endTime.getTime()) / (1000 * 60 * 60 * 24);
             return daysAgo <= 30;
         });
         // Combine all announcements and sort by most relevant date
         const allAnnouncements = [
-            ...currentOutages.map((item) => ({ ...item, category: 'current' })),
-            ...futureOutages.map((item) => ({ ...item, category: 'scheduled' })),
-            ...recentPastOutages.map((item) => ({ ...item, category: 'recent_past' })),
+            ...currentOutages.map((item) => ({ ...item, category: "current" })),
+            ...futureOutages.map((item) => ({ ...item, category: "scheduled" })),
+            ...recentPastOutages.map((item) => ({
+                ...item,
+                category: "recent_past",
+            })),
         ]
             .sort((a, b) => {
             // Sort by most relevant date: current first, then future by start time, then past by end time
-            if (a.category === 'current' && b.category !== 'current')
+            if (a.category === "current" && b.category !== "current")
                 return -1;
-            if (b.category === 'current' && a.category !== 'current')
+            if (b.category === "current" && a.category !== "current")
                 return 1;
-            const dateA = new Date(a.OutageStart);
-            const dateB = new Date(b.OutageStart);
+            const dateA = new Date(a.OutageStart || "");
+            const dateB = new Date(b.OutageStart || "");
             return dateB.getTime() - dateA.getTime(); // Most recent first
         })
             .slice(0, limit);
@@ -393,9 +434,9 @@ export class SystemStatusServer extends BaseAccessServer {
             scheduled_maintenance: futureOutages.length,
             recent_past_outages: recentPastOutages.length,
             categories: {
-                current: allAnnouncements.filter(a => a.category === 'current').length,
-                scheduled: allAnnouncements.filter(a => a.category === 'scheduled').length,
-                recent_past: allAnnouncements.filter(a => a.category === 'recent_past').length,
+                current: allAnnouncements.filter((a) => a.category === "current").length,
+                scheduled: allAnnouncements.filter((a) => a.category === "scheduled").length,
+                recent_past: allAnnouncements.filter((a) => a.category === "recent_past").length,
             },
             announcements: allAnnouncements,
         };
@@ -412,13 +453,43 @@ export class SystemStatusServer extends BaseAccessServer {
         if (!resourceIds || !Array.isArray(resourceIds) || resourceIds.length === 0) {
             throw new Error("resource_ids parameter is required and must be a non-empty array of resource IDs");
         }
+        // Resolve all resource names to IDs first
+        const resolvedIds = [];
+        const resolutionErrors = [];
+        for (const inputId of resourceIds) {
+            const resolved = await resolveResourceId(inputId, (query) => this.searchResourcesByName(query));
+            if (resolved.success) {
+                resolvedIds.push(resolved.id);
+            }
+            else {
+                resolutionErrors.push({ input: inputId, error: resolved.error });
+            }
+        }
+        // If any resolutions failed, return errors
+        if (resolutionErrors.length > 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "Could not resolve some resource names",
+                            resolution_errors: resolutionErrors,
+                            suggestions: [
+                                "Use full resource IDs (e.g., 'anvil.purdue.access-ci.org')",
+                                "Or use exact resource names (e.g., 'Anvil', 'Delta')",
+                            ],
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
         if (useGroupApi) {
-            return await this.checkResourceStatusViaGroups(resourceIds);
+            return await this.checkResourceStatusViaGroups(resolvedIds);
         }
         // Efficient approach: fetch raw current outages data once
         const response = await this.httpClient.get("/wh2/news/v1/affiliation/access-ci.org/current_outages/");
         const rawOutages = response.data.results || [];
-        const resourceStatus = resourceIds.map((resourceId) => {
+        const resourceStatus = resolvedIds.map((resourceId) => {
             const affectedOutages = rawOutages.filter((outage) => outage.AffectedResources?.some((resource) => resource.ResourceID?.toString() === resourceId ||
                 resource.ResourceName?.toLowerCase().includes(resourceId.toLowerCase())));
             let status = "operational";
@@ -462,10 +533,9 @@ export class SystemStatusServer extends BaseAccessServer {
                     type: "text",
                     text: JSON.stringify({
                         checked_at: new Date().toISOString(),
-                        resources_checked: resourceIds.length,
+                        resources_checked: resolvedIds.length,
                         operational: resourceStatus.filter((r) => r.status === "operational").length,
-                        affected: resourceStatus.filter((r) => r.status === "affected")
-                            .length,
+                        affected: resourceStatus.filter((r) => r.status === "affected").length,
                         api_method: "direct_outages_check",
                         resource_status: resourceStatus,
                     }, null, 2),
@@ -494,7 +564,7 @@ export class SystemStatusServer extends BaseAccessServer {
                     api_method: "group_specific",
                 };
             }
-            catch (error) {
+            catch {
                 // Fallback to general check if group API fails
                 return {
                     resource_id: resourceId,
@@ -516,10 +586,8 @@ export class SystemStatusServer extends BaseAccessServer {
                         checked_at: new Date().toISOString(),
                         resources_checked: resourceIds.length,
                         operational: resourceStatus.filter((r) => r.status === "operational").length,
-                        affected: resourceStatus.filter((r) => r.status === "affected")
-                            .length,
-                        unknown: resourceStatus.filter((r) => r.status === "unknown")
-                            .length,
+                        affected: resourceStatus.filter((r) => r.status === "affected").length,
+                        unknown: resourceStatus.filter((r) => r.status === "unknown").length,
                         api_method: "resource_group_api",
                         resource_status: resourceStatus,
                     }, null, 2),

package/dist/web-server.js

@@ -3,7 +3,7 @@ import path from "path";
 import { SystemStatusServer } from "./server.js";
 export function startWebServer(port = 3000) {
     const app = express();
-    const server = new SystemStatusServer();
+    new SystemStatusServer();
     // Serve static files from public directory
     const publicDir = path.join(__dirname, "../../../public");
     app.use(express.static(publicDir));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@access-mcp/system-status",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "MCP server for ACCESS-CI System Status and Outages API",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@access-mcp/shared": "^0.3.3",
+    "@access-mcp/shared": "^0.6.0",
     "express": "^4.18.0"
   },
   "devDependencies": {