@codebaz/nextdoctor-agent 0.1.0-beta.1

package/dist/detectors/fetch-no-cache.detector.js

@@ -0,0 +1,178 @@
+import { BaseDetector } from './base-detector.js';
+export class FetchNoCacheDetector extends BaseDetector {
+    id = 'FETCH_NO_CACHE';
+    name = 'Fetch Without Cache Detector';
+    minDurationMs = 50;
+    nPlus1Threshold = 3;
+    detect(spans, context) {
+        const issues = [];
+        // Find fetch spans without cache directive
+        const fetchSpans = spans.filter(span => {
+            const name = span.name.toLowerCase();
+            return name.includes('fetch') || name.includes('http.client');
+        });
+        const noCacheFetches = [];
+        const urlCounts = new Map();
+        fetchSpans.forEach(span => {
+            const method = this.getSpanMethod(span);
+            const url = this.getSpanUrl(span);
+            // Ignore non-GET and non-POST (POST/PUT/DELETE shouldn't be cached anyway)
+            if (!method || !['GET', 'HEAD'].includes(method.toUpperCase())) {
+                return;
+            }
+            if (!url) {
+                return;
+            }
+            // Ignore internal URLs
+            if (this.isInternalUrl(url)) {
+                return;
+            }
+            // Check cache directive
+            const cacheAttr = this.getStringAttribute(span, 'fetch.cache');
+            const nextRevalidate = this.getNumberAttribute(span, 'next.revalidate');
+            // Has cache if:
+            // - has fetch.cache='force-cache' or 'force-revalidate'
+            // - has next.revalidate > 0
+            const hasCache = cacheAttr === 'force-cache' ||
+                cacheAttr === 'force-revalidate' ||
+                (nextRevalidate !== undefined && nextRevalidate > 0);
+            if (hasCache) {
+                return;
+            }
+            const duration = this.getSpanDurationMs(span);
+            if (duration < this.minDurationMs) {
+                return;
+            }
+            const fetchInfo = {
+                url,
+                duration,
+                spanId: span.spanContext().spanId,
+            };
+            noCacheFetches.push(fetchInfo);
+            // Track for N+1 detection
+            const existing = urlCounts.get(url);
+            if (existing) {
+                existing.push(fetchInfo);
+            }
+            else {
+                urlCounts.set(url, [fetchInfo]);
+            }
+        });
+        // Report individual fetches and group N+1s
+        urlCounts.forEach((fetches, url) => {
+            if (fetches.length >= this.nPlus1Threshold) {
+                // N+1 detected
+                issues.push({
+                    id: this.id,
+                    severity: 'critical',
+                    message: `Fetch "${url}" called ${fetches.length}x with no cache → likely fetch N+1 pattern`,
+                    suggestion: `This endpoint is being called multiple times without caching. Add a cache directive:
+
+// Option 1: Force cache (recommended for static data)
+fetch("${url}", { cache: 'force-cache' })
+
+// Option 2: Revalidate after time (recommended for semi-dynamic data)
+fetch("${url}", { 
+  next: { revalidate: 3600 } // revalidate every hour
+})
+
+// Option 3: Use server-side data fetching instead
+// Move to a parent Server Component or Route Handler
+
+// Option 4: Use unstable_cache wrapper (experimental)
+import { unstable_cache } from 'next/cache';
+const cachedFetch = unstable_cache(
+  async () => fetch("${url}").then(r => r.json()),
+  [${JSON.stringify(url)}],
+  { revalidate: 3600 }
+);`,
+                    route: context.route,
+                    spanId: fetches[0]?.spanId,
+                    attributes: {
+                        url,
+                        callCount: fetches.length,
+                        totalDuration: Math.round(fetches.reduce((sum, f) => sum + f.duration, 0)),
+                        avgDuration: Math.round(fetches.reduce((sum, f) => sum + f.duration, 0) / fetches.length),
+                    },
+                    detectedAt: Date.now(),
+                });
+            }
+            else if (fetches.length === 1) {
+                // Single slow fetch without cache
+                const fetch = fetches[0];
+                issues.push({
+                    id: this.id,
+                    severity: 'high',
+                    message: `Fetch "${url}" has no cache → +${Math.round(fetch.duration)}ms per request`,
+                    suggestion: `Add a cache directive to this fetch:
+
+// Option 1: Force cache (best for static APIs)
+fetch("${url}", { cache: 'force-cache' })
+
+// Option 2: Revalidate after time (better for semi-dynamic data)
+fetch("${url}", { 
+  next: { revalidate: 3600 } // revalidate every hour
+})
+
+// Option 3: Combine with other optimizations
+const data = await fetch("${url}", {
+  cache: 'force-cache',
+  headers: {
+    'User-Agent': 'NextDoctor-Agent/1.0'
+  }
+});`,
+                    route: context.route,
+                    spanId: fetch.spanId,
+                    attributes: {
+                        url,
+                        duration: Math.round(fetch.duration),
+                    },
+                    detectedAt: Date.now(),
+                });
+            }
+            else {
+                // 2 to nPlus1Threshold-1 calls: still suspicious
+                const totalDuration = Math.round(fetches.reduce((sum, f) => sum + f.duration, 0));
+                issues.push({
+                    id: this.id,
+                    severity: 'high',
+                    message: `Fetch "${url}" called ${fetches.length}x with no cache → ${totalDuration}ms wasted per request`,
+                    suggestion: `This endpoint is being called multiple times without caching. Consider adding a cache directive or deduplicating the request:
+
+// Option 1: Force cache
+fetch("${url}", { cache: 'force-cache' })
+
+// Option 2: Revalidate after time
+fetch("${url}", { next: { revalidate: 3600 } })`,
+                    route: context.route,
+                    spanId: fetches[0]?.spanId,
+                    attributes: {
+                        url,
+                        callCount: fetches.length,
+                        totalDuration,
+                        avgDuration: Math.round(totalDuration / fetches.length),
+                    },
+                    detectedAt: Date.now(),
+                });
+            }
+        });
+        return issues;
+    }
+    isInternalUrl(url) {
+        try {
+            const parsed = new URL(url);
+            const hostname = parsed.hostname;
+            return (hostname === 'localhost' ||
+                hostname === '127.0.0.1' ||
+                hostname === '::1' ||
+                hostname.endsWith('.local') ||
+                hostname.endsWith('.test') ||
+                hostname.startsWith('192.168.') ||
+                hostname.startsWith('10.'));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=fetch-no-cache.detector.js.map

package/dist/detectors/fetch-no-cache.detector.js.map

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

package/dist/detectors/index.d.ts

@@ -0,0 +1,28 @@
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { BaseDetector } from './base-detector.js';
+import type { DetectedIssue, DetectorContext } from './types.js';
+export declare class DetectionEngine {
+    private detectors;
+    private issueCache;
+    private readonly dedupWindowMs;
+    constructor(config?: {
+        disabledDetectors?: string[];
+    });
+    analyzeSpans(spans: ReadableSpan[], context: DetectorContext): DetectedIssue[];
+    private deduplicateIssues;
+    private getDeduplicationKey;
+    getDetectorById(id: string): BaseDetector | undefined;
+    listDetectors(): Array<{
+        id: string;
+        name: string;
+    }>;
+    clearCache(): void;
+    getCacheSize(): number;
+}
+export declare const detectionEngine: DetectionEngine;
+export type { DetectedIssue, DetectorContext, DetectorResult } from './types.js';
+export { BaseDetector } from './base-detector.js';
+export { ColdStartThresholdDetector } from './cold-start-threshold.detector.js';
+export { FetchNoCacheDetector } from './fetch-no-cache.detector.js';
+export { DynamicRouteCandidateDetector } from './dynamic-route-candidate.detector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/detectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAuC,MAAM,YAAY,CAAC;AAEtG,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,MAAM,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAarD,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE;IAuB9E,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,mBAAmB;IAQ3B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD,aAAa,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAOpD,UAAU,IAAI,IAAI;IAIlB,YAAY,IAAI,MAAM;CAGvB;AAMD,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAGrD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/detectors/index.js

@@ -0,0 +1,97 @@
+import { ColdStartThresholdDetector } from './cold-start-threshold.detector.js';
+import { FetchNoCacheDetector } from './fetch-no-cache.detector.js';
+import { DynamicRouteCandidateDetector } from './dynamic-route-candidate.detector.js';
+export class DetectionEngine {
+    detectors;
+    issueCache = new Map();
+    dedupWindowMs = 60_000; // 60 seconds
+    constructor(config) {
+        const disabledSet = new Set(config?.disabledDetectors || []);
+        // Instantiate all detectors
+        const allDetectors = [
+            new ColdStartThresholdDetector(),
+            new FetchNoCacheDetector(),
+            new DynamicRouteCandidateDetector(),
+        ];
+        this.detectors = allDetectors.filter(d => !disabledSet.has(d.id));
+    }
+    analyzeSpans(spans, context) {
+        const allIssues = [];
+        // Run all detectors
+        for (const detector of this.detectors) {
+            const result = detector.run(spans, context);
+            allIssues.push(...result.issues);
+        }
+        // Deduplicate within the window
+        const deduped = this.deduplicateIssues(allIssues);
+        // Sort by severity: critical > high > warning > info
+        const severityOrder = { critical: 0, high: 1, warning: 2, info: 3 };
+        deduped.sort((a, b) => severityOrder[a.severity] -
+            severityOrder[b.severity]);
+        return deduped;
+    }
+    deduplicateIssues(issues) {
+        const now = Date.now();
+        const dedupedMap = new Map();
+        // Clean old entries from cache
+        for (const [key, cached] of this.issueCache.entries()) {
+            if (now - cached.lastDetectedAt > this.dedupWindowMs) {
+                this.issueCache.delete(key);
+            }
+        }
+        // Process new issues
+        for (const issue of issues) {
+            const key = this.getDeduplicationKey(issue);
+            const existingCached = this.issueCache.get(key);
+            if (existingCached) {
+                // Update cache
+                existingCached.lastDetectedAt = now;
+                existingCached.count++;
+                // Don't duplicate in output if already reported recently
+                continue;
+            }
+            // New issue - add to cache and output
+            const dedupedIssue = {
+                ...issue,
+                firstDetectedAt: now,
+                lastDetectedAt: now,
+                count: 1,
+            };
+            this.issueCache.set(key, dedupedIssue);
+            dedupedMap.set(key, dedupedIssue);
+        }
+        return Array.from(dedupedMap.values());
+    }
+    getDeduplicationKey(issue) {
+        const key = {
+            id: issue.id,
+            route: issue.route,
+        };
+        return JSON.stringify(key);
+    }
+    getDetectorById(id) {
+        return this.detectors.find(d => d.id === id);
+    }
+    listDetectors() {
+        return this.detectors.map(d => ({
+            id: d.id,
+            name: d.name,
+        }));
+    }
+    clearCache() {
+        this.issueCache.clear();
+    }
+    getCacheSize() {
+        return this.issueCache.size;
+    }
+}
+// Singleton instance
+// MVP LIMITATION: In persistent Node.js environments (self-hosted), this cache 
+// is shared globally. Deduplication keys include 'id' and 'route', but lack 
+// project-level scope, which could cause cache collisions in multi-tenant usages.
+export const detectionEngine = new DetectionEngine();
+export { BaseDetector } from './base-detector.js';
+export { ColdStartThresholdDetector } from './cold-start-threshold.detector.js';
+export { FetchNoCacheDetector } from './fetch-no-cache.detector.js';
+export { DynamicRouteCandidateDetector } from './dynamic-route-candidate.detector.js';
+//# sourceMappingURL=index.js.map

package/dist/detectors/index.js.map

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

package/dist/detectors/types.d.ts

@@ -0,0 +1,32 @@
+export type IssueSeverity = 'info' | 'warning' | 'high' | 'critical';
+export interface DetectedIssue {
+    id: string;
+    severity: IssueSeverity;
+    message: string;
+    suggestion: string;
+    route?: string;
+    spanId?: string;
+    attributes?: Record<string, unknown>;
+    detectedAt: number;
+}
+export interface DetectorResult {
+    issues: DetectedIssue[];
+    detectorId: string;
+    analyzedSpans: number;
+    durationMs: number;
+}
+export interface DetectorContext {
+    route?: string;
+    runtime: 'nodejs' | 'edge';
+    startupTimeMs?: number;
+}
+export interface IssueDeduplicationKey {
+    id: string;
+    route?: string;
+}
+export interface DedupedIssue extends DetectedIssue {
+    firstDetectedAt: number;
+    lastDetectedAt: number;
+    count: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/detectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/detectors/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/detectors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/detectors/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { initNextDoctor, shutdownNextDoctor, getNextDoctorAgent, reportMetric, getHealthStatus, getDetectedIssues, getSystemMetrics, getSystemHealth, getSystemSummary, } from './init.js';
+export type { NextDoctorConfig, DetectedIssue, AgentHealth, RetryPolicy, ExporterConfig, } from './types.js';
+export { LogLevel, ExporterType, } from './types.js';
+export { withNextDoctorMonitoring, withNextDoctorTiming, } from './middleware.js';
+export { IntelligentSampler, BatchProcessor, CircuitBreaker, } from './optimization.js';
+export { SystemMonitor, CPUMonitor, MemoryMonitor, } from './system-monitor.js';
+export type { CPUMetrics, MemoryMetrics, SystemMetrics, } from './system-monitor.js';
+export { detectionEngine, ColdStartThresholdDetector, FetchNoCacheDetector, DynamicRouteCandidateDetector, } from './detectors/index.js';
+export type { DetectorContext, DetectorResult, IssueSeverity, } from './detectors/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { initNextDoctor, shutdownNextDoctor, getNextDoctorAgent, reportMetric, getHealthStatus, getDetectedIssues, getSystemMetrics, getSystemHealth, getSystemSummary, } from './init.js';
+export { LogLevel, ExporterType, } from './types.js';
+export { withNextDoctorMonitoring, withNextDoctorTiming, } from './middleware.js';
+export { IntelligentSampler, BatchProcessor, CircuitBreaker, } from './optimization.js';
+export { SystemMonitor, CPUMonitor, MemoryMonitor, } from './system-monitor.js';
+export { detectionEngine, ColdStartThresholdDetector, FetchNoCacheDetector, DynamicRouteCandidateDetector, } from './detectors/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAUnB,OAAO,EACL,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,GACd,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,133 @@
+import type { NextDoctorConfig, AgentHealth, DetectedIssue } from './types.js';
+import { type SystemMetrics } from './system-monitor.js';
+declare class NextDoctorAgent {
+    private sdk;
+    private config;
+    private systemMonitor;
+    private health;
+    private retryPolicy;
+    private logLevel;
+    private initialized;
+    private detectedIssues;
+    private spansBuffer;
+    private lastAnalysisTime;
+    private readonly analysisIntervalMs;
+    private startTime;
+    constructor(config: NextDoctorConfig);
+    private validateConfig;
+    private log;
+    private createTraceExporter;
+    private createResource;
+    private generateInstanceId;
+    private isVercelEnvironment;
+    initialize(): Promise<void>;
+    private analyzeSpan;
+    private runDetectionEngine;
+    shutdown(): Promise<void>;
+    getHealth(): AgentHealth;
+    getDetectedIssues(): DetectedIssue[];
+    clearDetectedIssues(): void;
+    reportCustomMetric(name: string, value: number, attributes?: Record<string, any>): void;
+    private getUptime;
+    getSystemMetrics(): SystemMetrics;
+    getSystemHealth(cpuThreshold?: number, memThreshold?: number): {
+        healthy: boolean;
+        warnings: string[];
+        metrics: SystemMetrics;
+    };
+    getSystemSummary(): {
+        status: string;
+        cpu: {
+            usage: string;
+            cores: number;
+            load: {
+                oneMinute: number;
+                fiveMinutes: number;
+                fifteenMinutes: number;
+            };
+        };
+        memory: {
+            heap: {
+                used: string;
+                total: string;
+                usage: string;
+            };
+            system: {
+                used: string;
+                total: string;
+                usage: string;
+            };
+        };
+        warnings: string[];
+    };
+    getStats(): {
+        uptime: number;
+        initialized: boolean;
+        health: AgentHealth;
+        detectedIssues: DetectedIssue[];
+        system: {
+            status: string;
+            cpu: {
+                usage: string;
+                cores: number;
+                load: {
+                    oneMinute: number;
+                    fiveMinutes: number;
+                    fifteenMinutes: number;
+                };
+            };
+            memory: {
+                heap: {
+                    used: string;
+                    total: string;
+                    usage: string;
+                };
+                system: {
+                    used: string;
+                    total: string;
+                    usage: string;
+                };
+            };
+            warnings: string[];
+        };
+    };
+}
+export declare function initNextDoctor(config: NextDoctorConfig): Promise<void>;
+export declare function shutdownNextDoctor(): Promise<void>;
+export declare function getNextDoctorAgent(): NextDoctorAgent | null;
+export declare function reportMetric(name: string, value: number, attributes?: Record<string, any>): void;
+export declare function getHealthStatus(): AgentHealth | null;
+export declare function getDetectedIssues(): DetectedIssue[];
+export declare function getSystemMetrics(): SystemMetrics | null;
+export declare function getSystemHealth(cpuThreshold?: number, memThreshold?: number): {
+    healthy: boolean;
+    warnings: string[];
+    metrics: SystemMetrics;
+} | null;
+export declare function getSystemSummary(): {
+    status: string;
+    cpu: {
+        usage: string;
+        cores: number;
+        load: {
+            oneMinute: number;
+            fiveMinutes: number;
+            fifteenMinutes: number;
+        };
+    };
+    memory: {
+        heap: {
+            used: string;
+            total: string;
+            usage: string;
+        };
+        system: {
+            used: string;
+            total: string;
+            usage: string;
+        };
+    };
+    warnings: string[];
+} | null;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAGhB,WAAW,EACX,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGxE,cAAM,eAAe;IACnB,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAMZ;IACF,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,SAAS,CAAc;gBAEnB,MAAM,EAAE,gBAAgB;IA0BpC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,GAAG;IAaX,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAOrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsEjC,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,kBAAkB;IA2CpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B,SAAS,IAAI,WAAW;IAOxB,iBAAiB,IAAI,aAAa,EAAE;IAIpC,mBAAmB,IAAI,IAAI;IAI3B,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAkBvF,OAAO,CAAC,SAAS;IAIjB,gBAAgB,IAAI,aAAa;IAIjC,eAAe,CAAC,YAAY,GAAE,MAAW,EAAE,YAAY,GAAE,MAAW;;;;;IAIpE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;IAIhB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAST;AAKD,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5E;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AAED,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAOhG;AAED,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD;AAED,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CAEnD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAED,wBAAgB,eAAe,CAAC,YAAY,GAAE,MAAW,EAAE,YAAY,GAAE,MAAW;;;;SAOnF;AAED,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;SAO/B"}