@trentapps/manager-protocol 1.1.1

package/dist/engine/AppMonitor.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Enterprise Agent Supervisor - App Monitor
+ *
+ * Monitors production applications running on the server.
+ * Tracks online status, health checks, and process information.
+ */
+import { MonitoredApp, AppStatus, AppHealthCheckResult, AppStatusHistoryEntry, AppMonitorStats } from '../types/index.js';
+export interface AppMonitorOptions {
+    prodBasePath?: string;
+    maxHistoryEntries?: number;
+    maxTotalHistoryEntries?: number;
+    defaultCheckIntervalMs?: number;
+    defaultTimeoutMs?: number;
+}
+export declare class AppMonitor {
+    private apps;
+    private statusHistory;
+    private lastCheckResults;
+    private checkIntervals;
+    private prodBasePath;
+    private maxHistoryEntries;
+    private maxTotalHistoryEntries;
+    private defaultCheckIntervalMs;
+    private defaultTimeoutMs;
+    constructor(options?: AppMonitorOptions);
+    /**
+     * Generate a unique app ID
+     */
+    private generateAppId;
+    /**
+     * Add a new app to monitor
+     */
+    addApp(config: {
+        name: string;
+        path: string;
+        port: number;
+        description?: string;
+        healthEndpoint?: string;
+        expectedResponseCode?: number;
+        checkIntervalMs?: number;
+        timeoutMs?: number;
+        tags?: string[];
+        metadata?: Record<string, unknown>;
+        autoStart?: boolean;
+    }): Promise<MonitoredApp>;
+    /**
+     * Remove an app from monitoring
+     */
+    removeApp(appId: string): boolean;
+    /**
+     * Get an app by ID
+     */
+    getApp(appId: string): MonitoredApp | undefined;
+    /**
+     * Get app by name
+     */
+    getAppByName(name: string): MonitoredApp | undefined;
+    /**
+     * Get all apps
+     */
+    getAllApps(): MonitoredApp[];
+    /**
+     * Update an app configuration
+     */
+    updateApp(appId: string, updates: Partial<Omit<MonitoredApp, 'id' | 'createdAt'>>): MonitoredApp | undefined;
+    /**
+     * Check if a path exists
+     */
+    private checkPathExists;
+    /**
+     * Check if a port is in use
+     */
+    private isPortInUse;
+    /**
+     * Get process info by PID
+     */
+    private getProcessInfo;
+    /**
+     * Make an HTTP health check request with proper cleanup to prevent memory leaks
+     */
+    private httpHealthCheck;
+    /**
+     * Check health of a specific app
+     */
+    checkAppHealth(appId: string): Promise<AppHealthCheckResult>;
+    /**
+     * Check health of all apps
+     */
+    checkAllApps(): Promise<AppHealthCheckResult[]>;
+    /**
+     * Get the last check result for an app
+     */
+    getLastCheckResult(appId: string): AppHealthCheckResult | undefined;
+    /**
+     * Get status history for an app
+     */
+    getStatusHistory(appId: string, limit?: number): AppStatusHistoryEntry[];
+    /**
+     * Add entry to status history with global memory budget enforcement
+     */
+    private addToHistory;
+    /**
+     * Enforce global history limit to prevent unbounded memory growth
+     * Uses LRU-style eviction: removes oldest entries from largest histories first
+     */
+    private enforceGlobalHistoryLimit;
+    /**
+     * Start monitoring an app
+     */
+    startMonitoring(appId: string): boolean;
+    /**
+     * Stop monitoring an app
+     */
+    stopMonitoring(appId: string): boolean;
+    /**
+     * Enable/disable an app
+     */
+    setAppEnabled(appId: string, enabled: boolean): boolean;
+    /**
+     * Get monitoring statistics
+     */
+    getStats(): AppMonitorStats;
+    /**
+     * Find apps by tag
+     */
+    findAppsByTag(tag: string): MonitoredApp[];
+    /**
+     * Find apps by status
+     */
+    findAppsByStatus(status: AppStatus): MonitoredApp[];
+    /**
+     * Get apps that are currently offline
+     */
+    getOfflineApps(): MonitoredApp[];
+    /**
+     * Get apps that are degraded
+     */
+    getDegradedApps(): MonitoredApp[];
+    /**
+     * Scan /mnt/prod for potential apps (directories with package.json or similar)
+     */
+    scanForApps(): Promise<Array<{
+        name: string;
+        path: string;
+        type: string;
+        hasPackageJson: boolean;
+        potentialPorts: number[];
+    }>>;
+    /**
+     * Get logs for an app (tail of stdout/stderr or PM2 logs)
+     */
+    getAppLogs(appId: string, lines?: number): Promise<{
+        logs: string;
+        source: string;
+    }>;
+    /**
+     * Cleanup - stop all monitoring intervals
+     */
+    cleanup(): void;
+}
+export declare const appMonitor: AppMonitor;
+//# sourceMappingURL=AppMonitor.d.ts.map

package/dist/engine/AppMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppMonitor.d.ts","sourceRoot":"","sources":["../../src/engine/AppMonitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EACL,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,aAAa,CAAmD;IACxE,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,cAAc,CAA0C;IAEhE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,GAAE,iBAAsB;IAQ3C;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,YAAY,CAAC;IA+DzB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAiBjC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI/C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASpD;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,GAAG,YAAY,GAAG,SAAS;IAyB5G;;OAEG;YACW,eAAe;IAS7B;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,cAAc;IAoC5B;;OAEG;YACW,eAAe;IA6D7B;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgFlE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqCrD;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAInE;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAQxE;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IA+BvC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAUtC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAkBvD;;OAEG;IACH,QAAQ,IAAI,eAAe;IAoD3B;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE;IAM1C;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,EAAE;IAWnD;;OAEG;IACH,cAAc,IAAI,YAAY,EAAE;IAIhC;;OAEG;IACH,eAAe,IAAI,YAAY,EAAE;IAIjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,OAAO,CAAC;QACxB,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC,CAAC;IA0GH;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC;QAC3D,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IA8CF;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC"}