@jagilber-org/index-server 1.22.0

package/dist/dashboard/server/AdminPanel.d.ts

@@ -0,0 +1,195 @@
+import { ToolMetrics } from './MetricsCollector';
+import type { AdminConfig } from './AdminPanelConfig';
+import type { AdminSession, AdminSessionHistoryEntry } from './AdminPanelState';
+export type { AdminConfig, AdminSession, AdminSessionHistoryEntry };
+interface SystemMaintenance {
+    lastBackup: Date | null;
+    nextScheduledMaintenance: Date | null;
+    maintenanceMode: boolean;
+    systemHealth: {
+        status: 'healthy' | 'warning' | 'critical';
+        issues: string[];
+        recommendations: string[];
+        cpuTrend?: 'stable' | 'increasing' | 'decreasing';
+        memoryTrend?: 'stable' | 'increasing' | 'decreasing';
+        memoryGrowthRate?: number;
+    };
+}
+interface AdminStats {
+    totalConnections: number;
+    activeConnections: number;
+    /** Count of active admin panel sessions (logical authenticated/admin sessions) */
+    adminActiveSessions: number;
+    totalRequests: number;
+    errorRate: number;
+    avgResponseTime: number;
+    uptime: number;
+    memoryUsage: {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+    };
+    cpuUsage: {
+        user: number;
+        system: number;
+        percent: number;
+    };
+    toolMetrics: {
+        [toolName: string]: ToolMetrics;
+    };
+    indexStats: {
+        /** Accepted (validated) instruction count – kept also as totalInstructions for backward compatibility */
+        totalInstructions: number;
+        acceptedInstructions: number;
+        rawFileCount: number;
+        skippedInstructions: number;
+        lastUpdated: Date;
+        version: string;
+        schemaVersion: string;
+    };
+}
+export declare class AdminPanel {
+    private readonly panelConfig;
+    private readonly panelState;
+    private maintenanceInfo;
+    private indexStatsCache;
+    private lastUptimeSeconds;
+    private get backupRoot();
+    private get instructionsRoot();
+    /**
+     * Validate and sanitize a user-supplied backupId to prevent path traversal (SH-4).
+     * Returns the sanitized basename or throws if the id is invalid.
+     */
+    private validateBackupId;
+    private cpuHistory;
+    private lastCpuUsage;
+    private readonly maxCpuHistoryEntries;
+    private memoryHistory;
+    private readonly maxMemoryHistoryEntries;
+    constructor();
+    getAdminConfig(): AdminConfig;
+    updateAdminConfig(updates: Partial<AdminConfig>): {
+        success: boolean;
+        message: string;
+    };
+    getActiveSessions(): AdminSession[];
+    createAdminSession(userId: string, ipAddress: string, userAgent: string): AdminSession;
+    terminateSession(sessionId: string): boolean;
+    /**
+     * Get system maintenance information
+     */
+    getMaintenanceInfo(): SystemMaintenance;
+    /**
+     * Set maintenance mode
+     */
+    setMaintenanceMode(enabled: boolean, message?: string): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * Perform system backup
+     */
+    performBackup(): Promise<{
+        success: boolean;
+        message: string;
+        backupId?: string;
+        files?: number;
+    }>;
+    listBackups(): {
+        id: string;
+        createdAt: string;
+        instructionCount: number;
+        schemaVersion?: string;
+        sizeBytes: number;
+    }[];
+    restoreBackup(backupId: string): {
+        success: boolean;
+        message: string;
+        restored?: number;
+    };
+    /** Delete a backup zip or directory (safety checks on name) */
+    deleteBackup(backupId: string): {
+        success: boolean;
+        message: string;
+        removed?: boolean;
+    };
+    /** Prune backups keeping newest N (by createdAt / mtime). Returns count pruned. */
+    pruneBackups(retain: number): {
+        success: boolean;
+        message: string;
+        pruned?: number;
+    };
+    /** Export a backup — returns the zip file path for streaming, or falls back to JSON bundle for legacy dirs */
+    exportBackup(backupId: string): {
+        success: boolean;
+        message: string;
+        zipPath?: string;
+        bundle?: {
+            manifest: Record<string, unknown>;
+            files: Record<string, unknown>;
+        };
+    };
+    /** Import a backup from a JSON bundle uploaded by the client — creates a zip */
+    importBackup(bundle: {
+        manifest?: Record<string, unknown>;
+        files?: Record<string, unknown>;
+    }): {
+        success: boolean;
+        message: string;
+        backupId?: string;
+        files?: number;
+    };
+    /** Import a zip backup uploaded by the client without rewriting its contents. */
+    importZipBackup(zipBuffer: Buffer, sourceName?: string): {
+        success: boolean;
+        message: string;
+        backupId?: string;
+        files?: number;
+    };
+    /**
+     * Calculate current CPU usage with historical tracking
+     */
+    private calculateCpuUsage;
+    /**
+     * Analyze CPU trends for potential leaks
+     */
+    private analyzeCpuTrends;
+    /**
+     * Analyze memory usage trends for leak detection
+     */
+    private analyzeMemoryTrends;
+    /**
+     * Get comprehensive admin statistics
+     */
+    getAdminStats(): AdminStats;
+    private updateSystemHealth;
+    /** Return immutable copy of session history */
+    getSessionHistory(limit?: number): AdminSessionHistoryEntry[];
+    clearSessionHistory(): Promise<{
+        success: boolean;
+        message: string;
+        clearedCount: number;
+    }>;
+    updateSessionActivity(sessionId: string): boolean;
+    private getTotalConnections;
+    private getTotalRequests;
+    private getErrorRate;
+    private getAvgResponseTime;
+    private getIndexInstructionCount;
+    /**
+     * Restart server components
+     */
+    restartServer(component?: 'dashboard' | 'mcp' | 'all'): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Clear server caches
+     */
+    clearCaches(): {
+        success: boolean;
+        message: string;
+        cleared: string[];
+    };
+}
+export declare function getAdminPanel(): AdminPanel;