@uptimebolt/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CLM Cloud Solutions S.L.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# UptimeBolt MCP Server
+
+AI-powered infrastructure monitoring tools for [Claude](https://claude.ai), [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com), and any MCP-compatible client.
+
+[UptimeBolt](https://uptimebolt.com) is an AI-first monitoring platform that groups monitors into logical business services, predicts cascade failures before they happen, and automatically identifies which deploy caused each incident — including the commit, files, and lines of code responsible.
+
+Built by [CLM Cloud Solutions](https://clmcloudsolutions.es) in Madrid, Spain.
+
+## Why UptimeBolt MCP Server?
+
+Ask your infrastructure questions in natural language. Instead of navigating dashboards, let your AI assistant query real-time monitoring data directly:
+
+- *"Is it safe to deploy right now?"* — get a data-driven answer based on health scores, active incidents, and predictions
+- *"What caused the last incident?"* — AI-powered root cause analysis with deploy correlation
+- *"Give me an executive summary of the last 24 hours"* — ready for your standup or status report
+- *"Show me monitors that are degraded"* — instant filtered view across your infrastructure
+
+## Features
+
+- **10 monitoring tools** — service status, incidents, predictions, RCA, deploy safety, and more
+- **Dual transport** — stdio (local) + HTTP (remote/CI-CD)
+- **API key authentication** — secure per-request access to your UptimeBolt data
+- **Works everywhere** — Claude Desktop, Claude Code, Cursor, Cline, and any MCP client
+- **CI/CD ready** — deploy safety checks directly in your pipeline
+
+## Quick Start
+
+### Claude Desktop (stdio)
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "uptimebolt": {
+      "command": "npx",
+      "args": ["-y", "@uptimebolt/mcp-server"],
+      "env": {
+        "UPTIMEBOLT_API_KEY": "your-api-key",
+        "UPTIMEBOLT_API_URL": "https://api.uptimebolt.io"
+      }
+    }
+  }
+}
+```
+
+### Claude Code / Cursor
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "uptimebolt": {
+      "command": "npx",
+      "args": ["-y", "@uptimebolt/mcp-server"],
+      "env": {
+        "UPTIMEBOLT_API_KEY": "your-api-key",
+        "UPTIMEBOLT_API_URL": "https://api.uptimebolt.io"
+      }
+    }
+  }
+}
+```
+
+### Docker (HTTP)
+
+```bash
+docker run -p 3100:3100 \
+  -e UPTIMEBOLT_API_URL=https://api.uptimebolt.io \
+  uptimebolt/mcp-server:latest
+```
+
+Then connect via `mcp-remote`:
+
+```json
+{
+  "mcpServers": {
+    "uptimebolt": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "http://localhost:3100/mcp", "--header", "x-api-key:your-api-key"]
+    }
+  }
+}
+```
+
+### npm (programmatic)
+
+```bash
+npm install @uptimebolt/mcp-server
+```
+
+```typescript
+import { TOOLS, HANDLERS } from "@uptimebolt/mcp-server";
+
+// TOOLS — MCP tool definitions (10 tools)
+// HANDLERS — tool handler functions: (args, context?) => Promise<result>
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_service_status` | Health status of business services with health score (0-100), monitor breakdown, and active incidents |
+| `get_monitors` | List all monitors with operational status, response time, and uptime percentage |
+| `get_monitor_health` | Detailed health for a specific monitor including response time trends and active predictions |
+| `get_monitor_metrics` | Response time stats (avg, p95, p99), uptime percentage, and error breakdown |
+| `get_incidents` | Active and resolved incidents with optional AI root cause analysis details |
+| `get_predictions` | AI predictions for upcoming issues with confidence levels and predicted impact |
+| `get_deployments` | Recent deployments with automatic incident correlation (GitHub/GitLab) |
+| `run_root_cause_analysis` | AI-powered RCA using multi-model analysis (Claude, GPT) with deploy correlation |
+| `is_safe_to_deploy` | CI/CD deploy safety check based on health scores, predictions, and active incidents |
+| `get_executive_summary` | Infrastructure health summary for standups, weekly reports, or status updates |
+
+## Authentication
+
+Get your API key at [app.uptimebolt.io/settings/api-keys](https://app.uptimebolt.io/settings/api-keys).
+
+- **stdio mode**: Set `UPTIMEBOLT_API_KEY` environment variable
+- **HTTP mode**: Pass `x-api-key` header with each request (no startup key required)
+
+## CI/CD Integration
+
+Use `is_safe_to_deploy` as a gate in your deployment pipeline:
+
+```bash
+curl -X POST http://localhost:3100/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "x-api-key: your-api-key" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "tools/call",
+    "params": {
+      "name": "is_safe_to_deploy",
+      "arguments": { "service_name": "my-service" }
+    }
+  }'
+```
+
+The response includes a risk level (`low`, `medium`, `high`), active issues, and a recommendation (`proceed`, `proceed_with_caution`, `wait_and_monitor`).
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `UPTIMEBOLT_API_KEY` | Your UptimeBolt API key | (required for stdio) |
+| `UPTIMEBOLT_API_URL` | UptimeBolt API base URL | `http://localhost:3200` |
+| `MCP_HTTP_PORT` | HTTP server port | `3100` |
+| `NODE_ENV` | Environment (`production` disables console logs) | `development` |
+| `LOG_LEVEL` | Log level (error, warn, info, debug) | `debug` (dev) / `info` (prod) |
+
+## Development
+
+```bash
+git clone https://github.com/clm-cloud-solutions/uptimebolt-mcp-server.git
+cd uptimebolt-mcp-server
+cp .env.example .env          # configure your environment
+npm install
+npm run dev          # stdio mode
+npm run dev:http     # HTTP mode
+npm run build        # compile TypeScript
+npm run typecheck    # type check without emitting
+```
+
+## About UptimeBolt
+
+[UptimeBolt](https://uptimebolt.com) is an AI-first SaaS monitoring platform for DevOps teams and SREs. Key capabilities:
+
+- **Cascade failure prediction** — dependency graph with what-if analysis, downtime cost estimation, and proactive mitigations
+- **Deploy correlation + RCA 2.0** — automatically correlates GitHub/GitLab deploys with incidents, identifies the responsible commit and files
+- **AI Copilot** — conversational assistant with real-time infrastructure context
+- **8 monitor types** — HTTP, TCP, DNS, Database, Email, Synthetic, Push, Ping
+
+## About CLM Cloud Solutions
+
+[CLM Cloud Solutions S.L.](https://clmcloudsolutions.es) is a technology company based in Madrid, Spain, building SaaS products for engineering teams to operate with confidence, speed, and security.
+
+- [LinkedIn](https://www.linkedin.com/company/clm-cloud-solutions/)
+- [GitHub](https://github.com/clm-cloud-solutions)
+- Contact: info@clmcloudsolutions.es
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,11 @@
+export declare class ApiError extends Error {
+    status: number;
+    body?: any | undefined;
+    constructor(message: string, status: number, body?: any | undefined);
+}
+export declare const apiClient: {
+    get<T = any>(path: string, params?: Record<string, string | number | boolean | undefined>, timeout?: number, authToken?: string): Promise<T>;
+    post<T = any>(path: string, body?: any, timeout?: number, authToken?: string): Promise<T>;
+};
+export declare function validateApiKey(): void;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;IAGxB,MAAM,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,GAAG;gBAFjB,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,YAAA;CAKpB;AAsDD,eAAO,MAAM,SAAS;QAChB,CAAC,cAAc,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,YAAY,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;SAIvI,CAAC,cAAc,MAAM,SAAS,GAAG,YAAY,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAG1F,CAAC;AAEF,wBAAgB,cAAc,IAAI,IAAI,CAUrC"}

package/dist/api-client.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiClient = exports.ApiError = void 0;
+exports.validateApiKey = validateApiKey;
+const BASE_URL = process.env.UPTIMEBOLT_API_URL || "http://localhost:3200";
+const API_KEY = process.env.UPTIMEBOLT_API_KEY || "";
+const API_PREFIX = "/api/v1";
+class ApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "ApiError";
+    }
+}
+exports.ApiError = ApiError;
+async function request(method, path, options) {
+    const url = new URL(`${API_PREFIX}${path}`, BASE_URL);
+    if (options?.params) {
+        for (const [key, value] of Object.entries(options.params)) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    const controller = new AbortController();
+    const timeoutMs = options?.timeout || 30000;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const resp = await fetch(url.toString(), {
+            method,
+            headers: {
+                ...(options?.authToken
+                    ? { Authorization: `Bearer ${options.authToken}` }
+                    : { "x-api-key": API_KEY }),
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+            body: options?.body ? JSON.stringify(options.body) : undefined,
+            signal: controller.signal,
+        });
+        const json = await resp.json().catch(() => null);
+        if (!resp.ok) {
+            const message = json?.message || json?.error || `HTTP ${resp.status} ${resp.statusText}`;
+            throw new ApiError(message, resp.status, json);
+        }
+        return json?.data !== undefined ? json.data : json;
+    }
+    catch (err) {
+        if (err instanceof ApiError)
+            throw err;
+        if (err?.name === "AbortError") {
+            throw new ApiError(`Request timed out after ${timeoutMs}ms`, 408);
+        }
+        throw new ApiError(err.message, 0);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+exports.apiClient = {
+    get(path, params, timeout, authToken) {
+        return request("GET", path, { params, timeout, authToken });
+    },
+    post(path, body, timeout, authToken) {
+        return request("POST", path, { body, timeout, authToken });
+    },
+};
+function validateApiKey() {
+    if (!API_KEY) {
+        process.stderr.write("Error: UPTIMEBOLT_API_KEY environment variable is required (stdio mode).\n" +
+            "Set it to your UptimeBolt API key.\n\n" +
+            "Usage:\n" +
+            "  UPTIMEBOLT_API_KEY=your-key UPTIMEBOLT_API_URL=https://api.uptimebolt.io node dist/server.js\n\n");
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/formatters.d.ts

@@ -0,0 +1,17 @@
+export declare function formatServiceStatus(data: any): string;
+export declare function formatPredictions(predictions: any[]): string;
+export declare function formatIncidents(incidents: any[], rcas?: Map<string, any>): string;
+export declare function formatMonitorHealth(monitor: any, predictions?: any[]): string;
+export declare function formatDeployments(deployments: any[]): string;
+export declare function formatRca(rca: any): string;
+export declare function formatSafetyCheck(result: {
+    safe: boolean;
+    riskLevel: string;
+    reason: string;
+    activeIssues: any[];
+    recommendation: string;
+}): string;
+export declare function formatExecutiveSummary(data: any): string;
+export declare function formatMonitors(monitors: any[]): string;
+export declare function formatMonitorMetrics(summary: any): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AA4CA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAmCrD;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,CAQ5D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAkBjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,CAiB7E;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,CAiB5D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CA2C1C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,GAAG,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAenJ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAsBxD;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,CAsCtD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CA8CzD"}

package/dist/formatters.js

@@ -0,0 +1,300 @@
+"use strict";
+// Formatters convert API JSON responses to concise text for LLM consumption
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatServiceStatus = formatServiceStatus;
+exports.formatPredictions = formatPredictions;
+exports.formatIncidents = formatIncidents;
+exports.formatMonitorHealth = formatMonitorHealth;
+exports.formatDeployments = formatDeployments;
+exports.formatRca = formatRca;
+exports.formatSafetyCheck = formatSafetyCheck;
+exports.formatExecutiveSummary = formatExecutiveSummary;
+exports.formatMonitors = formatMonitors;
+exports.formatMonitorMetrics = formatMonitorMetrics;
+function statusIcon(status) {
+    const s = status?.toLowerCase();
+    if (s === "up" || s === "active" || s === "healthy" || s === "resolved")
+        return "[UP]";
+    if (s === "degraded" || s === "warning" || s === "caution")
+        return "[DEGRADED]";
+    if (s === "down" || s === "critical" || s === "detecting" || s === "investigating")
+        return "[DOWN]";
+    if (s === "paused")
+        return "[PAUSED]";
+    if (s === "maintenance")
+        return "[MAINTENANCE]";
+    return `[${(status || "unknown").toUpperCase()}]`;
+}
+function priorityLabel(p) {
+    return `[${(p || "unknown").toUpperCase()}]`;
+}
+function pct(n) {
+    return n != null ? `${Number(n).toFixed(1)}%` : "N/A";
+}
+function ms(n) {
+    return n != null ? `${Math.round(n)}ms` : "N/A";
+}
+function ago(date) {
+    if (!date)
+        return "N/A";
+    const diff = Date.now() - new Date(date).getTime();
+    const mins = Math.floor(diff / 60000);
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+function truncateList(items, max, formatter) {
+    const shown = items.slice(0, max).map(formatter);
+    if (items.length > max) {
+        shown.push(`... and ${items.length - max} more`);
+    }
+    return shown.join("\n");
+}
+// --- Tool formatters ---
+function formatServiceStatus(data) {
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return "No services found.";
+        const totalMonitors = data.reduce((sum, s) => sum + (s.serviceMonitors?.length || 0), 0);
+        return `${data.length} services (${totalMonitors} monitors total):\n\n` + truncateList(data, 20, (s) => {
+            const health = s.currentHealthScore != null ? ` | Health: ${pct(s.currentHealthScore)}` : "";
+            const monitors = s.serviceMonitors || [];
+            const monitorCount = monitors.length > 0 ? ` | ${monitors.length} monitors` : "";
+            let line = `- ${s.name} (${s.environment || "unknown"})${health}${monitorCount} | ${s.criticality || "normal"} criticality\n  ID: ${s.id}`;
+            if (monitors.length > 0) {
+                line += "\n" + monitors.map((sm) => {
+                    const m = sm.monitor || sm;
+                    return `    ${statusIcon(m.operationalStatus || m.status)} ${m.name} (${m.type})`;
+                }).join("\n");
+            }
+            return line;
+        });
+    }
+    const s = data;
+    const monitors = s.serviceMonitors || [];
+    let text = `Service: ${s.name}\n`;
+    text += `Environment: ${s.environment || "unknown"} | Criticality: ${s.criticality || "normal"}\n`;
+    if (s.healthScore != null)
+        text += `Health Score: ${pct(s.healthScore)}\n`;
+    if (s.description)
+        text += `Description: ${s.description}\n`;
+    if (monitors.length > 0) {
+        text += `\nMonitors (${monitors.length}):\n`;
+        text += truncateList(monitors, 15, (sm) => {
+            const m = sm.monitor || sm;
+            return `  ${statusIcon(m.operationalStatus || m.status)} ${m.name} (${m.type}) | Response: ${ms(m.responseTime)} | Uptime: ${pct(m.uptimePercentage)}`;
+        });
+    }
+    return text;
+}
+function formatPredictions(predictions) {
+    if (!predictions || predictions.length === 0)
+        return "No active predictions.";
+    return `${predictions.length} active predictions:\n\n` + truncateList(predictions, 10, (p) => {
+        const confidence = p.confidence != null ? `${Math.round((p.confidence > 1 ? p.confidence : p.confidence * 100))}%` : "N/A";
+        const monitor = p.monitor?.name || p.monitorId || "unknown";
+        return `- ${priorityLabel(p.severity || p.predictionType)} ${p.predictionType} | Monitor: ${monitor} | Confidence: ${confidence} | Window: ${p.timeWindow || "N/A"}`;
+    });
+}
+function formatIncidents(incidents, rcas) {
+    if (!incidents || incidents.length === 0)
+        return "No incidents found.";
+    return `${incidents.length} incidents:\n\n` + truncateList(incidents, 10, (inc) => {
+        const dur = inc.downtimeDuration != null ? `${Math.round(inc.downtimeDuration / 60)}min` : "ongoing";
+        let text = `- ${statusIcon(inc.status)} ${priorityLabel(inc.severity)} ${inc.title || "Untitled"}\n`;
+        text += `  ID: ${inc.id} | Monitor: ${inc.monitor?.name || inc.monitorId || "unknown"} | Duration: ${dur} | Started: ${ago(inc.startTime || inc.createdAt)}`;
+        if (inc.errorCode)
+            text += ` | Error: ${inc.errorCode}`;
+        const rca = rcas?.get(inc.id);
+        if (rca) {
+            text += `\n  RCA: ${rca.rootCauseSummary || "N/A"} (${rca.rootCauseType || "unknown"}, confidence: ${pct(rca.confidenceScore)})`;
+            if (rca.cascadeDetected)
+                text += ` [CASCADE]`;
+            if (rca.correlatedDeploymentId)
+                text += ` [DEPLOY-RELATED]`;
+        }
+        return text;
+    });
+}
+function formatMonitorHealth(monitor, predictions) {
+    const m = monitor;
+    let text = `Monitor: ${m.name}\n`;
+    text += `ID: ${m.id}\n`;
+    text += `Type: ${m.type} | Status: ${statusIcon(m.operationalStatus || m.status)} ${m.operationalStatus || m.status}\n`;
+    text += `Response Time: ${ms(m.responseTime)} | Uptime: ${pct(m.uptimePercentage)}\n`;
+    if (m.target)
+        text += `Target: ${m.target}\n`;
+    if (predictions && predictions.length > 0) {
+        text += `\nActive Predictions (${predictions.length}):\n`;
+        text += truncateList(predictions, 5, (p) => {
+            const confidence = p.confidence != null ? `${Math.round((p.confidence > 1 ? p.confidence : p.confidence * 100))}%` : "N/A";
+            return `  - ${p.predictionType} | Confidence: ${confidence} | Window: ${p.timeWindow || "N/A"}`;
+        });
+    }
+    return text;
+}
+function formatDeployments(deployments) {
+    if (!deployments || deployments.length === 0)
+        return "No recent deployments.";
+    return `${deployments.length} deployments:\n\n` + truncateList(deployments, 15, (d) => {
+        const status = d.deploymentStatus || d.status || "unknown";
+        const msg = (d.commitMessage || "").substring(0, 80);
+        let text = `- ${statusIcon(status)} ${msg} (${d.branch || "N/A"})\n`;
+        text += `  Author: ${d.commitAuthor || "unknown"} | SHA: ${(d.commitSha || "").substring(0, 8)} | ${ago(d.deployedAt)}`;
+        if (d.filesChanged)
+            text += ` | ${d.filesChanged} files`;
+        const correlations = d.correlations || [];
+        if (correlations.length > 0) {
+            text += `\n  Correlations: ${correlations.map((c) => `score=${c.correlationScore} (${c.confidence})`).join(", ")}`;
+        }
+        return text;
+    });
+}
+function formatRca(rca) {
+    let text = `Root Cause Analysis\n`;
+    text += `${"=".repeat(40)}\n\n`;
+    text += `RCA ID: ${rca.id || "N/A"}\n`;
+    text += `Summary: ${rca.rootCauseSummary || "N/A"}\n`;
+    text += `Type: ${rca.rootCauseType || "unknown"} | Confidence: ${pct(rca.confidenceScore)}\n`;
+    text += `Model: ${rca.aiModelUsed || "unknown"} | Duration: ${rca.analysisDurationMs ? `${Math.round(rca.analysisDurationMs / 1000)}s` : "N/A"}\n`;
+    if (rca.cascadeDetected) {
+        text += `\nCascade Detected: Yes | Origin: ${rca.cascadeOriginMonitorId || "unknown"}`;
+        text += ` | Affected: ${rca.affectedMonitorsCount || 0} monitors, ${rca.affectedServicesCount || 0} services\n`;
+    }
+    if (rca.correlatedDeploymentId) {
+        text += `\nDeploy Correlated: Yes | Score: ${rca.deployCorrelationScore || "N/A"}\n`;
+    }
+    const analysis = rca.detailedAnalysis;
+    if (analysis) {
+        if (analysis.timeline?.length) {
+            text += `\nTimeline:\n`;
+            text += truncateList(analysis.timeline, 8, (t) => `  ${t.time}: ${t.event}`);
+        }
+        if (analysis.deployAnalysis?.suspectedLines?.length) {
+            text += `\n\nSuspected Code Changes:\n`;
+            text += truncateList(analysis.deployAnalysis.suspectedLines, 5, (sl) => `  - ${sl.filename}: ${sl.change}\n    Why: ${sl.explanation}\n    Fix: ${sl.suggestedFix}`);
+        }
+    }
+    if (rca.suggestedActions?.length) {
+        text += `\n\nSuggested Actions:\n`;
+        text += truncateList(rca.suggestedActions, 5, (a) => `  [${a.urgency}] ${a.action}`);
+    }
+    if (rca.preventionRecommendations?.length) {
+        text += `\n\nPrevention:\n`;
+        text += truncateList(rca.preventionRecommendations, 5, (r) => `  [${r.priority}] ${r.action}`);
+    }
+    return text;
+}
+function formatSafetyCheck(result) {
+    const icon = result.safe ? "[SAFE]" : result.riskLevel === "high" ? "[UNSAFE]" : "[CAUTION]";
+    let text = `${icon} Deploy Safety Check\n\n`;
+    text += `Risk Level: ${result.riskLevel}\n`;
+    text += `Recommendation: ${result.recommendation}\n\n`;
+    text += `${result.reason}\n`;
+    if (result.activeIssues.length > 0) {
+        text += `\nActive Issues:\n`;
+        text += truncateList(result.activeIssues, 10, (i) => `  - [${i.type}] ${i.message}${i.confidence ? ` (confidence: ${i.confidence}%)` : ""}`);
+    }
+    return text;
+}
+function formatExecutiveSummary(data) {
+    let text = data.summary || "No summary available.";
+    if (data.metrics) {
+        const m = data.metrics;
+        text += `\n\nMetrics:\n`;
+        text += `  Overall Health: ${pct(m.overallHealth)}\n`;
+        text += `  Monitors: ${m.totalMonitors || 0} total (${m.monitorsUp || 0} up, ${m.monitorsDegraded || 0} degraded, ${m.monitorsDown || 0} down)\n`;
+        text += `  Incidents: ${m.incidentsInPeriod || 0} | Predictions: ${m.predictionsActive || 0} | Deployments: ${m.deploymentsInPeriod || 0}`;
+    }
+    if (data.highlights?.length) {
+        text += `\n\nHighlights:\n`;
+        text += truncateList(data.highlights, 5, (h) => `  - [${h.type}] ${h.message}`);
+    }
+    if (data.suggestedQuestions?.length) {
+        text += `\n\nSuggested Questions:\n`;
+        text += data.suggestedQuestions.map((q) => `  - ${q}`).join("\n");
+    }
+    return text;
+}
+function formatMonitors(monitors) {
+    if (!monitors || monitors.length === 0)
+        return "No monitors found.";
+    // Effective status: use administrative status (paused/maintenance) when not active,
+    // otherwise use operationalStatus (up/down/degraded)
+    function effectiveStatus(m) {
+        const admin = (m.status || "active").toLowerCase();
+        if (admin === "paused" || admin === "maintenance")
+            return admin;
+        return (m.operationalStatus || "up").toLowerCase();
+    }
+    const statusCounts = {};
+    const typeCounts = {};
+    for (const m of monitors) {
+        const s = effectiveStatus(m);
+        statusCounts[s] = (statusCounts[s] || 0) + 1;
+        const t = (m.type || "unknown").toLowerCase();
+        typeCounts[t] = (typeCounts[t] || 0) + 1;
+    }
+    const statusParts = Object.entries(statusCounts).map(([s, c]) => `${c} ${s}`).join(", ");
+    const typeParts = Object.entries(typeCounts).map(([t, c]) => `${c} ${t}`).join(", ");
+    // Sort: down first, then degraded, then paused, then up
+    const order = { down: 0, critical: 0, degraded: 1, warning: 1, paused: 2, maintenance: 3, up: 4 };
+    const sorted = [...monitors].sort((a, b) => {
+        return (order[effectiveStatus(a)] ?? 5) - (order[effectiveStatus(b)] ?? 5);
+    });
+    let text = `${monitors.length} monitors (${statusParts}):\n`;
+    text += `By type: ${typeParts}\n\n`;
+    text += truncateList(sorted, 20, (m) => {
+        const es = effectiveStatus(m);
+        const icon = statusIcon(es === "paused" ? "paused" : es === "maintenance" ? "maintenance" : (m.operationalStatus || "unknown"));
+        return `- ${icon} ${m.name} (${m.type || "unknown"}) | Response: ${ms(m.responseTime)} | Uptime: ${pct(m.uptimePercentage)}\n  ID: ${m.id}`;
+    });
+    return text;
+}
+function formatMonitorMetrics(summary) {
+    const m = summary.monitor || summary;
+    const cs = summary.currentStatus || {};
+    const rt = summary.responseTime || {};
+    const up = summary.uptime || {};
+    const checks = summary.checks || {};
+    const ssl = summary.sslCertificate || null;
+    let text = `Monitor: ${m.name || "Unknown"} (${m.type || "unknown"})\n`;
+    text += `Status: ${statusIcon(cs.operationalStatus || m.operationalStatus || m.status || "unknown")} | Target: ${m.target || "N/A"}\n`;
+    text += `ID: ${m.id || "N/A"}\n`;
+    text += `\nResponse Time:\n`;
+    text += `  Current: ${ms(rt.current ?? cs.lastResponseTime)} | Day avg: ${ms(rt.avgDay)} | Week avg: ${ms(rt.avgWeek)} | Month avg: ${ms(rt.avgMonth)} | Year avg: ${ms(rt.avgYear)}\n`;
+    text += `\nUptime:\n`;
+    text += `  Day: ${pct(up.day)} | Week: ${pct(up.week)} | Month: ${pct(up.month)} | Year: ${pct(up.year)}\n`;
+    if (checks.day || checks.week || checks.month || checks.year) {
+        text += `\nChecks:\n`;
+        if (checks.day) {
+            text += `  Last 24h: ${checks.day.total || 0} total | ${checks.day.up || 0} up | ${checks.day.down || 0} down\n`;
+        }
+        if (checks.week) {
+            text += `  Last 7d: ${checks.week.total || 0} total | ${checks.week.up || 0} up | ${checks.week.down || 0} down\n`;
+        }
+        if (checks.month) {
+            text += `  Last 30d: ${checks.month.total || 0} total | ${checks.month.up || 0} up | ${checks.month.down || 0} down\n`;
+        }
+        if (checks.year) {
+            text += `  Last 365d: ${checks.year.total || 0} total | ${checks.year.up || 0} up | ${checks.year.down || 0} down\n`;
+        }
+    }
+    if (ssl) {
+        const expiresAt = ssl.expiresAt || ssl.validUntil;
+        const daysRemaining = ssl.daysRemaining != null
+            ? ssl.daysRemaining
+            : (expiresAt ? Math.floor((new Date(expiresAt).getTime() - Date.now()) / 86400000) : null);
+        text += `\nSSL Certificate:\n`;
+        text += `  Status: ${ssl.status || "unknown"} | Issuer: ${ssl.issuer || "N/A"}`;
+        if (expiresAt)
+            text += ` | Expires: ${expiresAt}`;
+        if (daysRemaining != null)
+            text += ` | Days remaining: ${daysRemaining}`;
+    }
+    return text;
+}
+//# sourceMappingURL=formatters.js.map