ai-debug-local-mcp/dist/utils/token-savings-tracker.d.ts

🎯 ENHANCED AI GUIDANCE v4.1.2: Dramatically improved tool descriptions help AI users choose the right tools instead of 'close enough' options. Ultra-fast keyboard automation (10x speed), universal recording, multi-ecosystem debugging support, and compreh

/**
 * Sub-Agent Context Delegation Tracker
 *
 * Real-time measurement and validation of sub-agent context delegation.
 * Tracks how effectively we delegate detailed work to sub-agents to keep
 * the main conversation focused and context-efficient.
 */
export interface ContextDelegationMeasurement {
    sessionId: string;
    agentType: string;
    taskDescription: string;
    startTime: Date;
    endTime?: Date;
    contextKeptInMain: number;
    contextDelegatedToAgent: number;
    delegationEfficiency: number;
    actualDelegationTime: number;
    wasSuccessfullyDelegated: boolean;
    complexityLevel: 'simple' | 'moderate' | 'complex' | 'revolutionary';
    frameworkDetected?: string;
    mainConversationImpact: 'minimal' | 'moderate' | 'significant';
    estimatedTokensSaved: number;
}
export interface SessionDelegationSummary {
    sessionId: string;
    totalContextDelegated: number;
    totalMainContextUsed: number;
    delegationRatio: number;
    agentsUsed: number;
    averageDelegationTime: number;
    peakComplexityLevel: string;
    conversationEfficiency: number;
    targetAchieved: boolean;
    totalTokensSaved: number;
    efficiencyScore: number;
}
export type SessionTokenSummary = SessionDelegationSummary;
export interface AgentDelegationMetrics {
    agentType: string;
    totalSessions: number;
    totalContextHandled: number;
    averageContextPerSession: number;
    averageDelegationTime: number;
    successfulDelegationRate: number;
    mainConversationImpactScore: number;
    complexityHandled: Record<string, number>;
    totalTokensSaved: number;
    averageTokensSaved: number;
    successRate: number;
}
export type AgentPerformanceMetrics = AgentDelegationMetrics;
export declare class ContextDelegationTracker {
    private static instance;
    private measurements;
    private sessionSummaries;
    private agentMetrics;
    private static readonly DELEGATION_TARGETS;
    private static readonly AGENT_CONTEXT_EXPECTATIONS;
    private constructor();
    static getInstance(): ContextDelegationTracker;
    private initializeAgentMetrics;
    /**
     * Start tracking a sub-agent delegation
     */
    startDelegation(sessionId: string, agentType: string, taskDescription: string, complexityLevel?: ContextDelegationMeasurement['complexityLevel'], frameworkDetected?: string): string;
    /**
     * Complete a sub-agent delegation measurement
     */
    completeDelegation(sessionId: string, agentType: string, actualTokensSaved: number, delegationTimeMs: number, successful?: boolean): void;
    private updateAgentMetrics;
    private updateSessionSummary;
    /**
     * Get real-time performance dashboard data
     */
    getPerformanceDashboard(): {
        totalSessions: number;
        totalTokensSaved: number;
        revolutionarySessionsCount: number;
        averageEfficiency: number;
        performanceTargetsMet: boolean;
        agentLeaderboard: Array<{
            agentType: string;
            tokensSaved: number;
            efficiency: number;
            successRate: number;
        }>;
    };
    /**
     * Get detailed validation report
     */
    getValidationReport(): {
        overallStatus: 'REVOLUTIONARY' | 'MEETING_TARGETS' | 'NEEDS_OPTIMIZATION' | 'CRITICAL_ISSUES';
        summary: string;
        agentPerformance: AgentPerformanceMetrics[];
        recommendations: string[];
        achievements: string[];
    };
    /**
     * Export performance data for analysis
     */
    exportPerformanceData(): string;
}
//# sourceMappingURL=token-savings-tracker.d.ts.map