@hasna/uptime 0.1.0 → 0.1.1

package/dist/mcp/index.js

@@ -14362,6 +14362,9 @@ async function runTcpCheck(monitor) {
   });
 }
 
+// src/service.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
 // src/store.ts
 import { mkdirSync } from "fs";
 import { dirname } from "path";
@@ -14388,6 +14391,13 @@ var MAX_RETRY_COUNT = 10;
 var MAX_RESULT_LIMIT = 1000;
 
 // src/store.ts
+class StaleCheckResultError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "StaleCheckResultError";
+  }
+}
+
 class UptimeStore {
   dbPath;
   db;
@@ -14421,10 +14431,12 @@ class UptimeStore {
         enabled INTEGER NOT NULL DEFAULT 1,
         status TEXT NOT NULL DEFAULT 'unknown',
         last_checked_at TEXT,
+        revision INTEGER NOT NULL DEFAULT 1,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL
       )
     `);
+    this.ensureColumn("monitors", "revision", "INTEGER NOT NULL DEFAULT 1");
     this.db.run(`
       CREATE TABLE IF NOT EXISTS check_results (
         id TEXT PRIMARY KEY,
@@ -14450,8 +14462,17 @@ class UptimeStore {
         reason TEXT
       )
     `);
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS check_leases (
+        monitor_id TEXT PRIMARY KEY REFERENCES monitors(id) ON DELETE CASCADE,
+        owner TEXT NOT NULL,
+        leased_until TEXT NOT NULL,
+        acquired_at TEXT NOT NULL
+      )
+    `);
     this.db.run("CREATE INDEX IF NOT EXISTS idx_results_monitor_time ON check_results(monitor_id, checked_at DESC)");
     this.db.run("CREATE INDEX IF NOT EXISTS idx_incidents_monitor_status ON incidents(monitor_id, status)");
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_check_leases_until ON check_leases(leased_until)");
   }
   createMonitor(input) {
     const normalized = normalizeCreateMonitor(input);
@@ -14471,14 +14492,15 @@ class UptimeStore {
       enabled: normalized.enabled ?? true,
       status: normalized.enabled === false ? "paused" : "unknown",
       lastCheckedAt: null,
+      revision: 1,
       createdAt: now,
       updatedAt: now
     };
     this.db.query(`INSERT INTO monitors (
           id, name, kind, url, host, port, method, expected_status,
           interval_seconds, timeout_ms, retry_count, enabled, status,
-          last_checked_at, created_at, updated_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(monitor.id, monitor.name, monitor.kind, monitor.url, monitor.host, monitor.port, monitor.method, monitor.expectedStatus, monitor.intervalSeconds, monitor.timeoutMs, monitor.retryCount, monitor.enabled ? 1 : 0, monitor.status, monitor.lastCheckedAt, monitor.createdAt, monitor.updatedAt);
+          last_checked_at, revision, created_at, updated_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(monitor.id, monitor.name, monitor.kind, monitor.url, monitor.host, monitor.port, monitor.method, monitor.expectedStatus, monitor.intervalSeconds, monitor.timeoutMs, monitor.retryCount, monitor.enabled ? 1 : 0, monitor.status, monitor.lastCheckedAt, monitor.revision, monitor.createdAt, monitor.updatedAt);
     return monitor;
   }
   listMonitors(options = {}) {
@@ -14498,8 +14520,12 @@ class UptimeStore {
     this.db.query(`UPDATE monitors SET
           name = ?, kind = ?, url = ?, host = ?, port = ?, method = ?,
           expected_status = ?, interval_seconds = ?, timeout_ms = ?,
-          retry_count = ?, enabled = ?, status = ?, last_checked_at = ?, updated_at = ?
+          retry_count = ?, enabled = ?, status = ?, last_checked_at = ?,
+          revision = revision + 1, updated_at = ?
         WHERE id = ?`).run(next.name, next.kind, next.url, next.host, next.port, next.method, next.expectedStatus, next.intervalSeconds, next.timeoutMs, next.retryCount, next.enabled ? 1 : 0, next.status, next.lastCheckedAt, updatedAt, current.id);
+    if (definitionChanged(current, next)) {
+      this.closeOpenIncident(current.id, updatedAt);
+    }
     return this.getMonitor(current.id);
   }
   deleteMonitor(idOrName) {
@@ -14509,10 +14535,31 @@ class UptimeStore {
     this.db.query("DELETE FROM monitors WHERE id = ?").run(current.id);
     return true;
   }
+  acquireCheckLease(monitorId, owner, ttlMs) {
+    const now = new Date;
+    const nowIso = now.toISOString();
+    const leasedUntil = new Date(now.getTime() + Math.max(1000, ttlMs)).toISOString();
+    const tx = this.db.transaction(() => {
+      this.db.query("DELETE FROM check_leases WHERE monitor_id = ? AND leased_until <= ?").run(monitorId, nowIso);
+      this.db.query("INSERT OR IGNORE INTO check_leases (monitor_id, owner, leased_until, acquired_at) VALUES (?, ?, ?, ?)").run(monitorId, owner, leasedUntil, nowIso);
+      const row = this.db.query("SELECT * FROM check_leases WHERE monitor_id = ?").get(monitorId);
+      return row?.owner === owner;
+    });
+    return tx();
+  }
+  releaseCheckLease(monitorId, owner) {
+    this.db.query("DELETE FROM check_leases WHERE monitor_id = ? AND owner = ?").run(monitorId, owner);
+  }
   recordCheckResult(input) {
     const monitor = this.getMonitor(input.monitorId);
     if (!monitor)
       throw new Error(`Monitor not found: ${input.monitorId}`);
+    if (input.expectedMonitorRevision !== undefined && monitor.revision !== input.expectedMonitorRevision) {
+      throw new StaleCheckResultError(`Monitor changed while check was in progress: ${monitor.name}`);
+    }
+    if (!monitor.enabled) {
+      throw new StaleCheckResultError(`Monitor was disabled while check was in progress: ${monitor.name}`);
+    }
     const checkedAt = input.checkedAt ?? new Date().toISOString();
     const result = {
       id: newId("chk"),
@@ -14525,6 +14572,15 @@ class UptimeStore {
       attemptCount: Math.max(1, input.attemptCount)
     };
     const tx = this.db.transaction(() => {
+      const current = this.db.query("SELECT * FROM monitors WHERE id = ?").get(result.monitorId);
+      if (!current)
+        throw new Error(`Monitor not found: ${result.monitorId}`);
+      if (input.expectedMonitorRevision !== undefined && current.revision !== input.expectedMonitorRevision) {
+        throw new StaleCheckResultError(`Monitor changed while check was in progress: ${current.name}`);
+      }
+      if (!current.enabled) {
+        throw new StaleCheckResultError(`Monitor was disabled while check was in progress: ${current.name}`);
+      }
       this.db.query(`INSERT INTO check_results (
             id, monitor_id, checked_at, status, latency_ms, status_code, error, attempt_count
           ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(result.id, result.monitorId, result.checkedAt, result.status, result.latencyMs, result.statusCode, result.error, result.attemptCount);
@@ -14572,10 +14628,14 @@ class UptimeStore {
         down: monitors.filter((m) => m.status === "down").length,
         paused: monitors.filter((m) => !m.enabled || m.status === "paused").length,
         unknown: monitors.filter((m) => m.status === "unknown").length,
-        openIncidents: this.listIncidents({ status: "open", limit: 1000 }).length
+        openIncidents: this.countOpenIncidents()
       }
     };
   }
+  countOpenIncidents() {
+    const row = this.db.query("SELECT COUNT(*) AS count FROM incidents WHERE status = 'open'").get();
+    return Number(row?.count ?? 0);
+  }
   monitorSummary(monitor) {
     const row = this.db.query(`SELECT
           COUNT(*) as total,
@@ -14613,13 +14673,24 @@ class UptimeStore {
       this.db.query("UPDATE incidents SET status = 'closed', closed_at = ?, recovery_check_id = ? WHERE id = ?").run(result.checkedAt, result.id, open.id);
     }
   }
+  closeOpenIncident(monitorId, closedAt) {
+    this.db.query("UPDATE incidents SET status = 'closed', closed_at = ? WHERE monitor_id = ? AND status = 'open'").run(closedAt, monitorId);
+  }
+  ensureColumn(table, name, definition) {
+    const columns = this.db.query(`PRAGMA table_info(${table})`).all();
+    if (!columns.some((column) => column.name === name)) {
+      this.db.run(`ALTER TABLE ${table} ADD COLUMN ${name} ${definition}`);
+    }
+  }
 }
 function normalizeCreateMonitor(input) {
   const name = input.name?.trim();
   if (!name)
     throw new Error("Monitor name is required");
+  rejectControlCharacters(name, "Monitor name");
   const method = normalizeMethod(input.method ?? "GET");
   const expectedStatus = normalizeExpectedStatus(input.expectedStatus);
+  const enabled = normalizeEnabled(input.enabled);
   if (input.kind === "http") {
     const url2 = normalizeHttpUrl(input.url);
     return {
@@ -14631,12 +14702,13 @@ function normalizeCreateMonitor(input) {
       intervalSeconds: boundedInteger(input.intervalSeconds ?? 60, "intervalSeconds", MIN_INTERVAL_SECONDS, MAX_INTERVAL_SECONDS),
       timeoutMs: boundedInteger(input.timeoutMs ?? 5000, "timeoutMs", MIN_TIMEOUT_MS, MAX_TIMEOUT_MS),
       retryCount: boundedInteger(input.retryCount ?? 0, "retryCount", MIN_RETRY_COUNT, MAX_RETRY_COUNT),
-      enabled: input.enabled ?? true
+      enabled
     };
   } else if (input.kind === "tcp") {
     const host = input.host?.trim();
     if (!host)
       throw new Error("TCP monitors require host");
+    rejectControlCharacters(host, "TCP host");
     if (!Number.isInteger(input.port) || input.port <= 0 || input.port > 65535) {
       throw new Error("TCP monitors require a port from 1 to 65535");
     }
@@ -14650,12 +14722,15 @@ function normalizeCreateMonitor(input) {
       intervalSeconds: boundedInteger(input.intervalSeconds ?? 60, "intervalSeconds", MIN_INTERVAL_SECONDS, MAX_INTERVAL_SECONDS),
       timeoutMs: boundedInteger(input.timeoutMs ?? 5000, "timeoutMs", MIN_TIMEOUT_MS, MAX_TIMEOUT_MS),
       retryCount: boundedInteger(input.retryCount ?? 0, "retryCount", MIN_RETRY_COUNT, MAX_RETRY_COUNT),
-      enabled: input.enabled ?? true
+      enabled
     };
   } else {
     throw new Error("Monitor kind must be http or tcp");
   }
 }
+function definitionChanged(current, next) {
+  return next.kind !== current.kind || next.url !== current.url || next.host !== current.host || next.port !== current.port || next.method !== current.method || next.expectedStatus !== current.expectedStatus;
+}
 function normalizeUpdateMonitor(current, input, updatedAt) {
   const merged = {
     ...current,
@@ -14720,6 +14795,18 @@ function normalizeExpectedStatus(value) {
   }
   return value;
 }
+function normalizeEnabled(value) {
+  if (value === undefined)
+    return true;
+  if (typeof value !== "boolean")
+    throw new Error("enabled must be a boolean");
+  return value;
+}
+function rejectControlCharacters(value, label) {
+  if (/[\x00-\x1f\x7f-\x9f]/.test(value)) {
+    throw new Error(`${label} must not contain control characters`);
+  }
+}
 function monitorFromRow(row) {
   return {
     id: row.id,
@@ -14736,6 +14823,7 @@ function monitorFromRow(row) {
     enabled: Boolean(row.enabled),
     status: row.status,
     lastCheckedAt: row.last_checked_at,
+    revision: row.revision ?? 1,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -14784,10 +14872,281 @@ function round(value, places) {
   return Math.round(value * factor) / factor;
 }
 
+// src/report.ts
+var DEFAULT_MAILERY_API_URL = "http://localhost:3900";
+var DEFAULT_TELEPHONY_API_URL = "http://localhost:19451";
+var DEFAULT_LOGS_API_URL = "http://localhost:3460";
+var DEFAULT_TIMEOUT_MS = 15000;
+function buildUptimeReport(summary, options = {}) {
+  const subject = options.subject ?? defaultSubject(summary);
+  const lines = [
+    subject,
+    `Generated: ${summary.generatedAt}`,
+    `Monitors: ${summary.totals.monitors} total, ${summary.totals.enabled} enabled, ${summary.totals.up} up, ${summary.totals.down} down, ${summary.totals.openIncidents} open incidents`,
+    "",
+    ...summary.monitors.map(renderMonitorLine)
+  ];
+  const text = lines.join(`
+`).trimEnd();
+  const json2 = {
+    kind: "open-uptime.report",
+    generated_at: summary.generatedAt,
+    subject,
+    totals: summary.totals,
+    monitors: summary.monitors
+  };
+  return {
+    subject,
+    generatedAt: summary.generatedAt,
+    summary,
+    text,
+    html: `<pre>${escapeHtml(text)}</pre>`,
+    json: json2
+  };
+}
+async function sendUptimeReport(summary, options = {}) {
+  const report = buildUptimeReport(summary, options);
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const deliveries = [];
+  if (options.email) {
+    deliveries.push(await sendEmailReport(report, resolveEmailTarget(options.email), fetchImpl, timeoutMs));
+  }
+  if (options.sms) {
+    const smsTarget = resolveSmsTarget(options.sms);
+    const recipients = splitTargets(smsTarget.to);
+    if (recipients.length === 0) {
+      deliveries.push(await sendSmsReport(report, smsTarget, fetchImpl, timeoutMs));
+    } else {
+      for (const target of recipients) {
+        deliveries.push(await sendSmsReport(report, { ...smsTarget, to: target }, fetchImpl, timeoutMs));
+      }
+    }
+  }
+  if (options.logs) {
+    deliveries.push(await sendLogsReport(report, resolveLogsTarget(options.logs), fetchImpl, timeoutMs));
+  }
+  return deliveries;
+}
+function defaultSubject(summary) {
+  if (summary.totals.openIncidents > 0 || summary.totals.down > 0) {
+    return `Open Uptime alert: ${summary.totals.down} down, ${summary.totals.openIncidents} open incidents`;
+  }
+  return `Open Uptime report: ${summary.totals.up}/${summary.totals.enabled} enabled monitors up`;
+}
+function renderMonitorLine(item) {
+  const uptime = item.uptimePercent == null ? "-" : `${item.uptimePercent.toFixed(2)}%`;
+  const latency = item.averageLatencyMs == null ? "-" : `${item.averageLatencyMs}ms`;
+  const incident = item.openIncident ? ` open incident: ${item.openIncident.reason ?? "down"}` : "";
+  return `- ${item.monitor.status.toUpperCase()} ${item.monitor.name} (${targetLabel(item)}): uptime ${uptime}, latency ${latency}${incident}`;
+}
+function targetLabel(item) {
+  return item.monitor.kind === "http" ? item.monitor.url ?? "" : `${item.monitor.host}:${item.monitor.port}`;
+}
+function resolveEmailTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_MAILERY_API_URL", "MAILERY_API_URL") ?? DEFAULT_MAILERY_API_URL,
+    sendKey: target.sendKey ?? env("HASNA_MAILERY_SEND_KEY", "MAILERY_SEND_KEY", "ESK"),
+    from: target.from ?? env("HASNA_UPTIME_REPORT_EMAIL_FROM", "UPTIME_REPORT_EMAIL_FROM"),
+    to: target.to ?? env("HASNA_UPTIME_REPORT_EMAIL_TO", "UPTIME_REPORT_EMAIL_TO"),
+    subject: target.subject,
+    providerId: target.providerId ?? env("HASNA_MAILERY_PROVIDER_ID", "MAILERY_PROVIDER_ID")
+  };
+}
+function resolveSmsTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_TELEPHONY_API_URL", "TELEPHONY_API_URL") ?? DEFAULT_TELEPHONY_API_URL,
+    from: target.from ?? env("HASNA_UPTIME_REPORT_SMS_FROM", "UPTIME_REPORT_SMS_FROM"),
+    to: target.to ?? env("HASNA_UPTIME_REPORT_PHONE_TO", "UPTIME_REPORT_PHONE_TO")
+  };
+}
+function resolveLogsTarget(value) {
+  const target = typeof value === "boolean" ? {} : value;
+  return {
+    apiUrl: target.apiUrl ?? env("HASNA_LOGS_URL", "LOGS_URL") ?? DEFAULT_LOGS_API_URL,
+    apiKey: target.apiKey ?? env("HASNA_LOGS_API_TOKEN", "LOGS_API_TOKEN", "HASNA_LOGS_API_KEY", "LOGS_API_KEY"),
+    projectId: target.projectId ?? env("HASNA_LOGS_PROJECT_ID", "LOGS_PROJECT_ID") ?? "open-uptime",
+    environment: target.environment ?? env("HASNA_ENV", "NODE_ENV"),
+    service: target.service ?? "open-uptime"
+  };
+}
+async function sendEmailReport(report, target, fetchImpl, timeoutMs) {
+  if (!target.sendKey)
+    return { channel: "email", ok: false, error: "Mailery send key is required" };
+  if (!target.from)
+    return { channel: "email", ok: false, error: "Email from address is required" };
+  if (!hasTargets(target.to))
+    return { channel: "email", ok: false, error: "Email recipient is required" };
+  const body = {
+    from: target.from,
+    to: splitTargets(target.to),
+    subject: target.subject ?? report.subject,
+    text: report.text,
+    html: report.html,
+    provider_id: target.providerId
+  };
+  return requestJson("email", `${normalizeUrl(target.apiUrl ?? DEFAULT_MAILERY_API_URL)}/api/v1/send`, {
+    method: "POST",
+    headers: { authorization: `Bearer ${target.sendKey}` },
+    body
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function sendSmsReport(report, target, fetchImpl, timeoutMs) {
+  if (!hasTargets(target.to))
+    return { channel: "sms", ok: false, error: "SMS recipient phone number is required" };
+  return requestJson("sms", `${normalizeUrl(target.apiUrl ?? DEFAULT_TELEPHONY_API_URL)}/api/sms/send`, {
+    method: "POST",
+    body: {
+      to: Array.isArray(target.to) ? target.to[0] : target.to,
+      from: target.from,
+      body: truncateSms(report.text)
+    }
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function sendLogsReport(report, target, fetchImpl, timeoutMs) {
+  const params = new URLSearchParams({
+    format: "json",
+    source: "structured",
+    service: target.service ?? "open-uptime",
+    project_id: target.projectId ?? "open-uptime"
+  });
+  if (target.environment)
+    params.set("environment", target.environment);
+  return requestJson("logs", `${normalizeUrl(target.apiUrl ?? DEFAULT_LOGS_API_URL)}/api/logs/structured?${params}`, {
+    method: "POST",
+    headers: target.apiKey ? { authorization: `Bearer ${target.apiKey}` } : undefined,
+    body: {
+      timestamp: report.generatedAt,
+      level: report.summary.totals.down > 0 || report.summary.totals.openIncidents > 0 ? "warn" : "info",
+      message: report.subject,
+      report: report.json
+    }
+  }, fetchImpl, timeoutMs, secretsForTarget(target));
+}
+async function requestJson(channel, url2, options, fetchImpl, timeoutMs, secrets = []) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetchImpl(url2, {
+      method: options.method,
+      signal: controller.signal,
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json",
+        ...options.headers
+      },
+      body: JSON.stringify(options.body)
+    });
+    const text = await response.text();
+    const data = parseMaybeJson(text);
+    if (!response.ok) {
+      return { channel, ok: false, status: response.status, error: errorFromResponse(data, response.statusText, secrets) };
+    }
+    return { channel, ok: true, status: response.status, id: redactOptional(idFromResponse(data), secrets) };
+  } catch (error51) {
+    const message = error51 instanceof Error && error51.name === "AbortError" ? "request timed out" : error51 instanceof Error ? error51.message : String(error51);
+    return { channel, ok: false, error: redactSecrets(message, secrets) };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function hasTargets(value) {
+  return splitTargets(value).length > 0;
+}
+function splitTargets(value) {
+  if (!value)
+    return [];
+  const values = Array.isArray(value) ? value : value.split(",");
+  return values.map((item) => item.trim()).filter(Boolean);
+}
+function normalizeUrl(value) {
+  const parsed = new URL(value.trim());
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error("Integration API URL must use http or https");
+  }
+  return parsed.toString().replace(/\/$/, "");
+}
+function truncateSms(value) {
+  return value.length > 1400 ? `${value.slice(0, 1397)}...` : value;
+}
+function parseMaybeJson(text) {
+  if (!text.trim())
+    return {};
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { message: text };
+  }
+}
+function idFromResponse(data) {
+  if (!data || typeof data !== "object")
+    return;
+  const record2 = data;
+  for (const key of ["id", "message_id", "event_id"]) {
+    if (typeof record2[key] === "string")
+      return record2[key];
+  }
+  return;
+}
+function errorFromResponse(data, fallback, secrets = []) {
+  if (data && typeof data === "object") {
+    const record2 = data;
+    if (typeof record2.error === "string")
+      return redactSecrets(record2.error, secrets);
+    if (typeof record2.message === "string")
+      return redactSecrets(record2.message, secrets);
+  }
+  return redactSecrets(fallback, secrets);
+}
+function env(...keys) {
+  for (const key of keys) {
+    const value = process.env[key]?.trim();
+    if (value)
+      return value;
+  }
+  return;
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function secretsForTarget(target) {
+  const values = new Set;
+  for (const key of ["sendKey", "apiKey"]) {
+    const value = target[key];
+    if (typeof value === "string" && value.trim())
+      values.add(value.trim());
+  }
+  const apiUrl = target.apiUrl;
+  if (apiUrl) {
+    try {
+      const parsed = new URL(apiUrl);
+      if (parsed.username)
+        values.add(decodeURIComponent(parsed.username));
+      if (parsed.password)
+        values.add(decodeURIComponent(parsed.password));
+    } catch {}
+  }
+  return [...values];
+}
+function redactSecrets(value, secrets = []) {
+  let redacted = value;
+  for (const secret of secrets) {
+    if (secret.length >= 3)
+      redacted = redacted.split(secret).join("[REDACTED]");
+  }
+  return redacted.replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/gi, "Bearer [REDACTED]").replace(/\besk_[A-Za-z0-9._~+/=-]+/g, "esk_[REDACTED]");
+}
+function redactOptional(value, secrets) {
+  return value === undefined ? undefined : redactSecrets(value, secrets);
+}
+
 // src/service.ts
 class UptimeService {
   store;
   checkRunner;
+  leaseOwner = `svc_${randomUUID2().replace(/-/g, "").slice(0, 18)}`;
   inFlightChecks = new Set;
   constructor(options = {}) {
     this.store = options.store ?? new UptimeStore(options);
@@ -14820,6 +15179,12 @@ class UptimeService {
   summary() {
     return this.store.summary();
   }
+  buildReport(options = {}) {
+    return buildUptimeReport(this.summary(), options);
+  }
+  async sendReport(options = {}) {
+    return sendUptimeReport(this.summary(), options);
+  }
   async checkMonitor(idOrName) {
     const monitor = this.store.getMonitor(idOrName);
     if (!monitor)
@@ -14828,6 +15193,10 @@ class UptimeService {
       throw new Error(`Monitor is disabled: ${monitor.name}`);
     if (this.inFlightChecks.has(monitor.id))
       throw new Error(`Monitor check already in progress: ${monitor.name}`);
+    const leaseTtlMs = Math.max(60000, (monitor.retryCount + 1) * monitor.timeoutMs + 1e4);
+    if (!this.store.acquireCheckLease(monitor.id, this.leaseOwner, leaseTtlMs)) {
+      throw new MonitorCheckBusyError(`Monitor check already in progress: ${monitor.name}`);
+    }
     this.inFlightChecks.add(monitor.id);
     try {
       let attemptCount = 0;
@@ -14845,10 +15214,12 @@ class UptimeService {
         latencyMs: last.latencyMs,
         statusCode: last.statusCode ?? null,
         error: last.error ?? null,
-        attemptCount
+        attemptCount,
+        expectedMonitorRevision: monitor.revision
       });
     } finally {
       this.inFlightChecks.delete(monitor.id);
+      this.store.releaseCheckLease(monitor.id, this.leaseOwner);
     }
   }
   async checkAll() {
@@ -14877,7 +15248,13 @@ class UptimeService {
       const current = this.store.getMonitor(monitor.id);
       if (!current || !this.isDue(current, now))
         continue;
-      results.push(await this.checkMonitor(current.id));
+      try {
+        results.push(await this.checkMonitor(current.id));
+      } catch (error51) {
+        if (error51 instanceof MonitorCheckBusyError || error51 instanceof StaleCheckResultError)
+          continue;
+        throw error51;
+      }
     }
     return results;
   }
@@ -14892,6 +15269,12 @@ class UptimeService {
     return now.getTime() - last >= monitor.intervalSeconds * 1000;
   }
 }
+class MonitorCheckBusyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "MonitorCheckBusyError";
+  }
+}
 
 // src/version.ts
 import { readFileSync } from "fs";
@@ -15003,6 +15386,39 @@ function createMcpServer(options = {}) {
     description: "Summarize monitor status, uptime percentages, latency, and open incidents.",
     inputSchema: {}
   }, async () => jsonResult(service.summary()));
+  server.registerTool("uptime_send_report", {
+    title: "Send an uptime report",
+    description: "Build an uptime report and send it through Mailery email, Telephony SMS, and/or Open Logs structured logs.",
+    inputSchema: {
+      subject: exports_external.string().optional(),
+      email: exports_external.object({
+        apiUrl: exports_external.string().url().optional(),
+        sendKey: exports_external.string().optional(),
+        from: exports_external.string().optional(),
+        to: exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]).optional(),
+        providerId: exports_external.string().optional()
+      }).optional(),
+      sms: exports_external.object({
+        apiUrl: exports_external.string().url().optional(),
+        from: exports_external.string().optional(),
+        to: exports_external.union([exports_external.string(), exports_external.array(exports_external.string())]).optional()
+      }).optional(),
+      logs: exports_external.object({
+        apiUrl: exports_external.string().url().optional(),
+        apiKey: exports_external.string().optional(),
+        projectId: exports_external.string().optional(),
+        environment: exports_external.string().optional(),
+        service: exports_external.string().optional()
+      }).optional(),
+      timeoutMs: exports_external.number().int().min(1000).max(60000).optional()
+    }
+  }, async (args) => jsonResult(await service.sendReport({
+    subject: args.subject,
+    email: args.email,
+    sms: args.sms,
+    logs: args.logs,
+    timeoutMs: args.timeoutMs
+  })));
   server.registerTool("uptime_results", {
     title: "List uptime check results",
     description: "List recent check results.",

package/dist/report.d.ts

@@ -0,0 +1,49 @@
+import type { UptimeSummary } from "./types.js";
+export interface BuildUptimeReportOptions {
+    subject?: string;
+}
+export interface UptimeReport {
+    subject: string;
+    generatedAt: string;
+    summary: UptimeSummary;
+    text: string;
+    html: string;
+    json: Record<string, unknown>;
+}
+export interface SendUptimeReportOptions extends BuildUptimeReportOptions {
+    email?: boolean | UptimeEmailReportTarget;
+    sms?: boolean | UptimeSmsReportTarget;
+    logs?: boolean | UptimeLogsReportTarget;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}
+export interface UptimeEmailReportTarget {
+    apiUrl?: string;
+    sendKey?: string;
+    from?: string;
+    to?: string | string[];
+    subject?: string;
+    providerId?: string;
+}
+export interface UptimeSmsReportTarget {
+    apiUrl?: string;
+    from?: string;
+    to?: string | string[];
+}
+export interface UptimeLogsReportTarget {
+    apiUrl?: string;
+    apiKey?: string;
+    projectId?: string;
+    environment?: string;
+    service?: string;
+}
+export interface UptimeReportDelivery {
+    channel: "email" | "sms" | "logs";
+    ok: boolean;
+    status?: number;
+    id?: string;
+    error?: string;
+}
+export declare function buildUptimeReport(summary: UptimeSummary, options?: BuildUptimeReportOptions): UptimeReport;
+export declare function sendUptimeReport(summary: UptimeSummary, options?: SendUptimeReportOptions): Promise<UptimeReportDelivery[]>;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,KAAK,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IAC1C,GAAG,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACtC,IAAI,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IACxC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,wBAA6B,GAAG,YAAY,CAyB9G;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAyBrI"}