@runcore-sh/runcore 0.1.2

package/dist/google/temporal.js

@@ -0,0 +1,176 @@
+/**
+ * Temporal validation layer.
+ * Catches day-of-week mismatches before calendar entries are created.
+ * Fixes ts_temporal_mismatch_01: March 4, 2026 is Wednesday, not Tuesday.
+ *
+ * Root cause: new Date('2026-03-04') parses as UTC midnight.
+ * getDay() returns local-timezone day, which can shift backward by 1
+ * in timezones behind UTC. All date math must use UTC methods on
+ * UTC-parsed strings, or local methods on locally-constructed dates.
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("google.temporal");
+const DAY_NAMES = [
+    "sunday", "monday", "tuesday", "wednesday",
+    "thursday", "friday", "saturday",
+];
+/**
+ * Parse a date string into year/month/day without timezone ambiguity.
+ * Extracts the date portion and constructs using local-time constructor
+ * to avoid the UTC-midnight-shifts-to-previous-day bug.
+ */
+export function parseDateSafe(dateStr) {
+    // Extract YYYY-MM-DD from any ISO string or date-only string
+    const match = dateStr.match(/^(\d{4})-(\d{2})-(\d{2})/);
+    if (!match) {
+        throw new Error(`Cannot parse date from: ${dateStr}`);
+    }
+    const [, year, month, day] = match;
+    // Use the (year, monthIndex, day) constructor — this uses LOCAL time,
+    // so getDay() will match the calendar date the user intended.
+    return new Date(parseInt(year), parseInt(month) - 1, parseInt(day));
+}
+/**
+ * Get the day-of-week name for a date string, correctly.
+ * Uses parseDateSafe to avoid UTC/local timezone mismatch.
+ */
+export function getDayOfWeek(dateStr) {
+    const d = parseDateSafe(dateStr);
+    return DAY_NAMES[d.getDay()];
+}
+/**
+ * Get the day-of-week index (0=Sunday, 6=Saturday) for a date string.
+ */
+export function getDayOfWeekIndex(dateStr) {
+    return parseDateSafe(dateStr).getDay();
+}
+/**
+ * Normalize a day name to lowercase for comparison.
+ * Accepts full names ("Wednesday") and abbreviations ("Wed").
+ */
+function normalizeDayName(name) {
+    const lower = name.toLowerCase().trim();
+    // Exact match
+    const exact = DAY_NAMES.find((d) => d === lower);
+    if (exact)
+        return exact;
+    // Prefix match (at least 3 chars: "mon", "tue", "wed", etc.)
+    if (lower.length >= 3) {
+        const prefix = DAY_NAMES.find((d) => d.startsWith(lower));
+        if (prefix)
+            return prefix;
+    }
+    return null;
+}
+/**
+ * Validate that a date string falls on the expected day-of-week.
+ *
+ * @param dateStr - ISO date or datetime string (e.g., "2026-03-04" or "2026-03-04T11:00:00")
+ * @param expectedDay - Expected day name (e.g., "Tuesday", "Wed")
+ * @returns Validation result with actual vs expected day
+ *
+ * @example
+ * validateDayOfWeek("2026-03-04", "Tuesday")
+ * // { valid: false, actualDay: "wednesday", expectedDay: "tuesday", date: "2026-03-04",
+ * //   mismatch: "2026-03-04 is wednesday, not tuesday" }
+ *
+ * validateDayOfWeek("2026-03-04", "Wednesday")
+ * // { valid: true, actualDay: "wednesday", expectedDay: "wednesday", date: "2026-03-04" }
+ */
+export function validateDayOfWeek(dateStr, expectedDay) {
+    const match = dateStr.match(/^(\d{4}-\d{2}-\d{2})/);
+    if (!match) {
+        return {
+            valid: false,
+            actualDay: "unknown",
+            expectedDay: expectedDay.toLowerCase(),
+            date: dateStr,
+            mismatch: `Cannot parse date from: ${dateStr}`,
+        };
+    }
+    const dateOnly = match[1];
+    const actualDay = getDayOfWeek(dateStr);
+    const normalizedExpected = normalizeDayName(expectedDay);
+    if (!normalizedExpected) {
+        return {
+            valid: false,
+            actualDay,
+            expectedDay: expectedDay.toLowerCase(),
+            date: dateOnly,
+            mismatch: `Unrecognized day name: ${expectedDay}`,
+        };
+    }
+    const valid = actualDay === normalizedExpected;
+    return {
+        valid,
+        actualDay,
+        expectedDay: normalizedExpected,
+        date: dateOnly,
+        ...(valid ? {} : {
+            mismatch: `${dateOnly} is ${actualDay}, not ${normalizedExpected}`,
+        }),
+    };
+}
+/**
+ * Validate a calendar event's start date before creation.
+ * If expectedDayOfWeek is provided (from user input or LLM parsing),
+ * cross-checks it against the actual calendar date.
+ *
+ * Returns { ok: true } if valid, or { ok: false, message, suggestion } if mismatched.
+ */
+export function validateCalendarEntry(startDateStr, expectedDayOfWeek) {
+    if (!expectedDayOfWeek)
+        return { ok: true };
+    const result = validateDayOfWeek(startDateStr, expectedDayOfWeek);
+    if (result.valid)
+        return { ok: true };
+    // Find the correct date for the expected day within ±3 days
+    const suggestion = findCorrectDate(startDateStr, expectedDayOfWeek);
+    return {
+        ok: false,
+        message: `Temporal mismatch: ${result.mismatch}`,
+        suggestion,
+    };
+}
+/**
+ * Given a date and the intended day-of-week, find the nearest date
+ * that actually falls on that day (within ±3 days).
+ */
+function findCorrectDate(dateStr, intendedDay) {
+    const target = normalizeDayName(intendedDay);
+    if (!target)
+        return `Could not resolve day name: ${intendedDay}`;
+    const targetIndex = DAY_NAMES.indexOf(target);
+    const base = parseDateSafe(dateStr);
+    for (let offset = -3; offset <= 3; offset++) {
+        const candidate = new Date(base);
+        candidate.setDate(base.getDate() + offset);
+        if (candidate.getDay() === targetIndex) {
+            const yyyy = candidate.getFullYear();
+            const mm = String(candidate.getMonth() + 1).padStart(2, "0");
+            const dd = String(candidate.getDate()).padStart(2, "0");
+            return `Did you mean ${target} ${yyyy}-${mm}-${dd}?`;
+        }
+    }
+    return `No ${target} found within ±3 days of ${dateStr}`;
+}
+/**
+ * Safe conversion to Google Tasks due date format.
+ * Extracts YYYY-MM-DD from the string directly, avoiding the
+ * UTC-midnight-to-local-time shift bug in toDueDate.
+ */
+export function toSafeDueDate(date) {
+    if (typeof date === "string") {
+        const match = date.match(/^(\d{4})-(\d{2})-(\d{2})/);
+        if (match) {
+            return `${match[1]}-${match[2]}-${match[3]}T00:00:00.000Z`;
+        }
+    }
+    // For Date objects or non-ISO strings, use local-time getters
+    const d = typeof date === "string" ? new Date(date) : date;
+    const yyyy = d.getFullYear();
+    const mm = String(d.getMonth() + 1).padStart(2, "0");
+    const dd = String(d.getDate()).padStart(2, "0");
+    return `${yyyy}-${mm}-${dd}T00:00:00.000Z`;
+}
+//# sourceMappingURL=temporal.js.map

package/dist/google/temporal.js.map

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

package/dist/health/alert-defaults.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default alert threshold configurations for common health checks.
+ *
+ * Provides ready-to-use threshold sets so callers can do:
+ *   new AlertManager(checker, { ...defaultAlertConfig(), thresholds: defaultThresholds() })
+ */
+import type { AlertConfig, AlertThreshold } from "./alert-types.js";
+/** Default thresholds for the built-in process-level checks. */
+export declare function defaultThresholds(): AlertThreshold[];
+/** Default alert configuration with sensible values. */
+export declare function defaultAlertConfig(overrides?: Partial<AlertConfig>): AlertConfig;
+//# sourceMappingURL=alert-defaults.d.ts.map

package/dist/health/alert-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-defaults.d.ts","sourceRoot":"","sources":["../../src/health/alert-defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,gEAAgE;AAChE,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAmEpD;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAUb"}

package/dist/health/alert-defaults.js

@@ -0,0 +1,88 @@
+/**
+ * Default alert threshold configurations for common health checks.
+ *
+ * Provides ready-to-use threshold sets so callers can do:
+ *   new AlertManager(checker, { ...defaultAlertConfig(), thresholds: defaultThresholds() })
+ */
+/** Default thresholds for the built-in process-level checks. */
+export function defaultThresholds() {
+    return [
+        {
+            checkName: "memory",
+            metric: "rss",
+            warningThreshold: 512,
+            criticalThreshold: 1024,
+            consecutiveBreaches: 2,
+            label: "Memory RSS",
+        },
+        {
+            checkName: "memory",
+            metric: "heap",
+            warningThreshold: 400,
+            criticalThreshold: 800,
+            consecutiveBreaches: 2,
+            label: "Heap Usage",
+        },
+        {
+            checkName: "event_loop",
+            metric: "drift",
+            warningThreshold: 250,
+            criticalThreshold: 500,
+            consecutiveBreaches: 3,
+            label: "Event Loop Drift",
+        },
+        {
+            checkName: "agent_capacity",
+            metric: "utilization",
+            warningThreshold: 80,
+            criticalThreshold: 95,
+            consecutiveBreaches: 2,
+            label: "Agent Capacity",
+        },
+        {
+            checkName: "sync",
+            metric: "failures",
+            warningThreshold: 3,
+            criticalThreshold: 5,
+            consecutiveBreaches: 1,
+            label: "Sync Failures",
+        },
+        {
+            checkName: "cpu",
+            metric: "usage",
+            warningThreshold: 80,
+            criticalThreshold: 95,
+            consecutiveBreaches: 3,
+            label: "CPU Usage",
+        },
+        {
+            checkName: "disk_usage",
+            metric: "used",
+            warningThreshold: 85,
+            criticalThreshold: 95,
+            consecutiveBreaches: 2,
+            label: "Disk Usage",
+        },
+        {
+            checkName: "openrouter_credits",
+            metric: "percentUsed",
+            warningThreshold: 80,
+            criticalThreshold: 95,
+            consecutiveBreaches: 1,
+            label: "OpenRouter Credits",
+        },
+    ];
+}
+/** Default alert configuration with sensible values. */
+export function defaultAlertConfig(overrides) {
+    return {
+        enabled: true,
+        evaluationIntervalMs: 30_000,
+        maxHistorySize: 100,
+        notificationCooldownMs: 300_000,
+        thresholds: defaultThresholds(),
+        notifications: [],
+        ...overrides,
+    };
+}
+//# sourceMappingURL=alert-defaults.js.map

package/dist/health/alert-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-defaults.js","sourceRoot":"","sources":["../../src/health/alert-defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gEAAgE;AAChE,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL;YACE,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,KAAK;YACb,gBAAgB,EAAE,GAAG;YACrB,iBAAiB,EAAE,IAAI;YACvB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,MAAM;YACd,gBAAgB,EAAE,GAAG;YACrB,iBAAiB,EAAE,GAAG;YACtB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE,OAAO;YACf,gBAAgB,EAAE,GAAG;YACrB,iBAAiB,EAAE,GAAG;YACtB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,kBAAkB;SAC1B;QACD;YACE,SAAS,EAAE,gBAAgB;YAC3B,MAAM,EAAE,aAAa;YACrB,gBAAgB,EAAE,EAAE;YACpB,iBAAiB,EAAE,EAAE;YACrB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,gBAAgB;SACxB;QACD;YACE,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,CAAC;YACnB,iBAAiB,EAAE,CAAC;YACpB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,eAAe;SACvB;QACD;YACE,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,OAAO;YACf,gBAAgB,EAAE,EAAE;YACpB,iBAAiB,EAAE,EAAE;YACrB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,WAAW;SACnB;QACD;YACE,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE,MAAM;YACd,gBAAgB,EAAE,EAAE;YACpB,iBAAiB,EAAE,EAAE;YACrB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,YAAY;SACpB;QACD;YACE,SAAS,EAAE,oBAAoB;YAC/B,MAAM,EAAE,aAAa;YACrB,gBAAgB,EAAE,EAAE;YACpB,iBAAiB,EAAE,EAAE;YACrB,mBAAmB,EAAE,CAAC;YACtB,KAAK,EAAE,oBAAoB;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,kBAAkB,CAChC,SAAgC;IAEhC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,oBAAoB,EAAE,MAAM;QAC5B,cAAc,EAAE,GAAG;QACnB,sBAAsB,EAAE,OAAO;QAC/B,UAAU,EAAE,iBAAiB,EAAE;QAC/B,aAAa,EAAE,EAAE;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/health/alert-types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Alert system type definitions.
+ *
+ * Extends the health check system with threshold-based alerting,
+ * notification channels, and alert lifecycle management.
+ */
+export type AlertSeverity = "warning" | "critical";
+export type AlertState = "firing" | "acknowledged" | "resolved";
+/** Threshold for a single metric (e.g., memory RSS, CPU, disk usage). */
+export interface AlertThreshold {
+    /** The health check name this threshold watches. */
+    checkName: string;
+    /** Metric name within the check (e.g., "rss", "heap", "utilization"). */
+    metric: string;
+    /** Value above which a warning fires. */
+    warningThreshold: number;
+    /** Value above which a critical alert fires. */
+    criticalThreshold: number;
+    /** How many consecutive breaches before firing. Prevents flapping. Default: 1. */
+    consecutiveBreaches?: number;
+    /** Human-readable label for notifications (e.g., "Memory RSS"). */
+    label?: string;
+}
+/** A single alert occurrence. */
+export interface Alert {
+    id: string;
+    /** Which threshold rule produced this alert. */
+    thresholdId: string;
+    checkName: string;
+    metric: string;
+    severity: AlertSeverity;
+    state: AlertState;
+    /** The value that triggered the alert. */
+    value: number;
+    /** The threshold that was breached. */
+    threshold: number;
+    message: string;
+    /** ISO timestamp when the alert first fired. */
+    firedAt: string;
+    /** ISO timestamp when acknowledged, if applicable. */
+    acknowledgedAt?: string;
+    /** Who/what acknowledged the alert. */
+    acknowledgedBy?: string;
+    /** ISO timestamp when resolved, if applicable. */
+    resolvedAt?: string;
+}
+/** Interface for notification delivery channels. */
+export interface NotificationChannel {
+    /** Channel identifier (e.g., "email", "sms", "webhook"). */
+    name: string;
+    /** Whether this channel is currently enabled. */
+    enabled: boolean;
+    /** Send an alert notification. Returns true on success. */
+    send(alert: Alert): Promise<boolean>;
+}
+/** Per-channel notification preferences. */
+export interface ChannelPreference {
+    /** Channel name. */
+    channel: string;
+    /** Minimum severity to notify on this channel. */
+    minSeverity: AlertSeverity;
+    /** Only notify for specific check names. Empty = all checks. */
+    checkFilter?: string[];
+}
+/** Full alert system configuration. */
+export interface AlertConfig {
+    /** Whether the alerting system is enabled. */
+    enabled: boolean;
+    /** How often to evaluate thresholds (ms). Default: 30_000. */
+    evaluationIntervalMs?: number;
+    /** How many resolved alerts to keep in history. Default: 100. */
+    maxHistorySize?: number;
+    /** Minimum time between repeated notifications for the same alert (ms). Default: 300_000. */
+    notificationCooldownMs?: number;
+    /** Threshold rules. */
+    thresholds: AlertThreshold[];
+    /** Notification channel preferences. */
+    notifications: ChannelPreference[];
+}
+/** Summary for dashboard display. */
+export interface AlertSummary {
+    /** Total active (firing + acknowledged) alerts. */
+    activeCount: number;
+    /** Breakdown by severity. */
+    bySeverity: Record<AlertSeverity, number>;
+    /** Currently firing alerts. */
+    firing: Alert[];
+    /** Acknowledged but unresolved alerts. */
+    acknowledged: Alert[];
+    /** Recently resolved alerts. */
+    recentlyResolved: Alert[];
+    /** When the last evaluation ran. */
+    lastEvaluation: string | null;
+}
+/** Metric value extractor — registered per check to pull numeric values. */
+export type MetricExtractor = (detail: string) => Record<string, number>;
+//# sourceMappingURL=alert-types.d.ts.map

package/dist/health/alert-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-types.d.ts","sourceRoot":"","sources":["../../src/health/alert-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;AAIhE,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,iCAAiC;AACjC,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAID,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,aAAa,CAAC;IAC3B,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB;IACvB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,wCAAwC;IACxC,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAID,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1C,+BAA+B;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,0CAA0C;IAC1C,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,gCAAgC;IAChC,gBAAgB,EAAE,KAAK,EAAE,CAAC;IAC1B,oCAAoC;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/health/alert-types.js

@@ -0,0 +1,8 @@
+/**
+ * Alert system type definitions.
+ *
+ * Extends the health check system with threshold-based alerting,
+ * notification channels, and alert lifecycle management.
+ */
+export {};
+//# sourceMappingURL=alert-types.js.map

package/dist/health/alert-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-types.js","sourceRoot":"","sources":["../../src/health/alert-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/health/alerting.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Threshold-based alerting system for Core health monitoring.
+ *
+ * Evaluates health check results against configured thresholds, manages
+ * alert lifecycle (firing → acknowledged → resolved), dispatches
+ * notifications, and maintains alert history.
+ *
+ * Integrates with HealthChecker via its public API — no modifications
+ * to the core checker are needed.
+ */
+import type { HealthChecker } from "./checker.js";
+import type { Alert, AlertConfig, AlertSummary, AlertThreshold, ChannelPreference, MetricExtractor } from "./alert-types.js";
+import type { NotificationDispatcher } from "../notifications/channel.js";
+export declare class AlertManager {
+    private checker;
+    private dispatcher;
+    private config;
+    private extractors;
+    private activeAlerts;
+    private history;
+    private breachCounts;
+    private lastNotified;
+    private timer;
+    private lastEvaluation;
+    private idCounter;
+    constructor(checker: HealthChecker, config: AlertConfig, dispatcher?: NotificationDispatcher);
+    /** Register a custom metric extractor for a check name. */
+    registerExtractor(checkName: string, extractor: MetricExtractor): void;
+    /** Start the alerting evaluation loop. */
+    start(): void;
+    /** Stop the alerting evaluation loop. */
+    stop(): void;
+    /** Run a single evaluation cycle. Returns IDs of newly fired or resolved alerts. */
+    evaluate(): Promise<{
+        fired: string[];
+        resolved: string[];
+    }>;
+    /** Acknowledge an active alert. Returns true if the alert was found and acknowledged. */
+    acknowledge(alertId: string, by?: string): boolean;
+    /** Manually resolve an active alert. */
+    resolve(alertId: string): boolean;
+    /** Get all active alerts (firing + acknowledged). */
+    getActive(): Alert[];
+    /** Get alert history (resolved alerts, most recent first). */
+    getHistory(): Alert[];
+    /** Get a single alert by ID (active or historical). */
+    getAlert(id: string): Alert | undefined;
+    /** Get dashboard summary. */
+    getSummary(): AlertSummary;
+    /** Get the current configuration (read-only snapshot). */
+    getConfig(): Readonly<AlertConfig>;
+    /** Update thresholds at runtime. */
+    updateThresholds(thresholds: AlertThreshold[]): void;
+    /** Update notification preferences at runtime. */
+    updateNotifications(notifications: ChannelPreference[]): void;
+    /** Enable or disable the alerting system. */
+    setEnabled(enabled: boolean): void;
+    private createAlert;
+    private formatMessage;
+    private addToHistory;
+    private notifyIfAllowed;
+    private notifyResolved;
+    private dispatchToChannels;
+    private meetsMinSeverity;
+}
+//# sourceMappingURL=alerting.d.ts.map

package/dist/health/alerting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerting.d.ts","sourceRoot":"","sources":["../../src/health/alerting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EAGX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAuE1E,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,MAAM,CAAwB;IAEtC,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAK;gBAGpB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,sBAAsB;IAwBrC,2DAA2D;IAC3D,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;IAMtE,0CAA0C;IAC1C,KAAK,IAAI,IAAI;IASb,yCAAyC;IACzC,IAAI,IAAI,IAAI;IAQZ,oFAAoF;IAC9E,QAAQ,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAwHlE,yFAAyF;IACzF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAalD,wCAAwC;IACxC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAgBjC,qDAAqD;IACrD,SAAS,IAAI,KAAK,EAAE;IAIpB,8DAA8D;IAC9D,UAAU,IAAI,KAAK,EAAE;IAIrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAOvC,6BAA6B;IAC7B,UAAU,IAAI,YAAY;IAwB1B,0DAA0D;IAC1D,SAAS,IAAI,QAAQ,CAAC,WAAW,CAAC;IAMlC,oCAAoC;IACpC,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI;IAIpD,kDAAkD;IAClD,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAI7D,6CAA6C;IAC7C,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOlC,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,gBAAgB;CAUzB"}