/** * AI Guard observability module. * * Provides lightweight instrumentation for production monitoring * without requiring external dependencies. All exports are zero-cost * when not configured. */ export type ScanMetrics = { scansTotal: number; scansFailed: number; findingsTotal: number; findingsBySeverity: Record; scanDurationMsTotal: number; scanDurationMsMax: number; lastScanAt: number | null; }; export type RuntimeMetrics = { requestsEvaluated: number; requestsBlocked: number; findingsEmitted: number; avgEvalMs: number; maxEvalMs: number; errorCount: number; }; export declare function recordScan(durationMs: number, findingCount: number, severityCounts: Record): void; export declare function recordScanFailure(): void; export declare function recordRuntimeRequest(evalMs: number, findingsEmitted: number, wasBlocked: boolean): void; export declare function recordRuntimeError(): void; export declare function getScanMetrics(): Readonly; export declare function getRuntimeMetrics(): Readonly; /** * Returns a Prometheus-compatible text format metrics payload. * Suitable for exposing at GET /metrics in a health endpoint. */ export declare function prometheusMetricsText(): string; /** * Returns a health check payload suitable for /healthz or /readyz endpoints. */ export declare function healthCheck(): { status: "healthy" | "degraded"; uptimeMs: number; metrics: { scan: Readonly; runtime: Readonly; }; };