@gracker/smartperfetto 1.0.13

package/dist/agent/core/entityRegistry.js

@@ -0,0 +1,102 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntityDescriptor = getEntityDescriptor;
+exports.getEntityParamKey = getEntityParamKey;
+exports.getEntityLabel = getEntityLabel;
+exports.getEntityIdFieldKeys = getEntityIdFieldKeys;
+exports.getEntityDrillDownStrategy = getEntityDrillDownStrategy;
+exports.buildEntityLabel = buildEntityLabel;
+exports.getCaptureStepPatterns = getCaptureStepPatterns;
+exports.resolveCaptureEntityKindByStepId = resolveCaptureEntityKindByStepId;
+const ENTITY_DESCRIPTORS = {
+    frame: {
+        type: 'frame',
+        paramKey: 'frame_id',
+        label: '帧',
+        idFieldKeys: ['frame_id', 'frameId'],
+        drillDownStrategy: 'frame_drill_down',
+    },
+    session: {
+        type: 'session',
+        paramKey: 'session_id',
+        label: '滑动会话',
+        idFieldKeys: ['session_id', 'sessionId'],
+        drillDownStrategy: 'session_drill_down',
+    },
+    startup: {
+        type: 'startup',
+        paramKey: 'startup_id',
+        label: '启动事件',
+        idFieldKeys: ['startup_id', 'startupId'],
+        drillDownStrategy: 'startup_drill_down',
+    },
+    process: {
+        type: 'process',
+        paramKey: 'process_name',
+        label: '进程',
+        idFieldKeys: ['process_name', 'processName', 'package'],
+    },
+    binder_call: {
+        type: 'binder_call',
+        paramKey: 'binder_txn_id',
+        label: 'Binder 调用',
+        idFieldKeys: ['binder_txn_id', 'binderTxnId', 'transaction_id', 'transactionId'],
+    },
+    time_range: {
+        type: 'time_range',
+        paramKey: 'time_range',
+        label: '时间范围',
+        idFieldKeys: ['time_range', 'timeRange'],
+    },
+};
+const ENTITY_CAPTURE_STEP_PATTERNS = {
+    frame: ['get_app_jank_frames', 'batch_frame_root_cause', 'jank_frames', 'frame_list', 'frames'],
+    session: ['scroll_sessions', 'sessions', 'session_list'],
+    cpu_slice: ['cpu_slices', 'sched_slices', 'thread_slices', 'scheduling', 'cpu_timeline'],
+    binder: ['binder_transactions', 'binder_calls', 'ipc_transactions', 'binder_blocking'],
+    gc: ['gc_events', 'garbage_collection', 'gc_analysis', 'gc_pauses'],
+    memory: ['memory_events', 'allocations', 'oom_events', 'lmk_events', 'memory_stats'],
+};
+function getEntityDescriptor(type) {
+    return ENTITY_DESCRIPTORS[type];
+}
+function getEntityParamKey(type) {
+    return ENTITY_DESCRIPTORS[type].paramKey;
+}
+function getEntityLabel(type) {
+    return ENTITY_DESCRIPTORS[type].label;
+}
+function getEntityIdFieldKeys(type) {
+    return [...ENTITY_DESCRIPTORS[type].idFieldKeys];
+}
+function getEntityDrillDownStrategy(type) {
+    return ENTITY_DESCRIPTORS[type].drillDownStrategy;
+}
+function buildEntityLabel(type, entityId) {
+    return `${getEntityLabel(type)} ${String(entityId)}`;
+}
+function getCaptureStepPatterns(kind) {
+    return ENTITY_CAPTURE_STEP_PATTERNS[kind];
+}
+function resolveCaptureEntityKindByStepId(stepId, matchMode = 'exact') {
+    const normalizedStepId = String(stepId || '').trim().toLowerCase();
+    if (!normalizedStepId)
+        return null;
+    for (const kind of Object.keys(ENTITY_CAPTURE_STEP_PATTERNS)) {
+        const patterns = ENTITY_CAPTURE_STEP_PATTERNS[kind];
+        for (const pattern of patterns) {
+            const normalizedPattern = pattern.toLowerCase();
+            if (matchMode === 'exact' && normalizedStepId === normalizedPattern) {
+                return kind;
+            }
+            if (matchMode === 'contains' && normalizedStepId.includes(normalizedPattern)) {
+                return kind;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=entityRegistry.js.map

package/dist/agent/core/entityRegistry.js.map

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

package/dist/agent/core/executors/analysisExecutor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Analysis Executor Interface
+ *
+ * Unified interface for all analysis execution paths.
+ * Eliminates the strategy-vs-hypothesis dual-path hardcoding
+ * by abstracting the execution loop behind a common contract.
+ *
+ * Implementations:
+ * - StrategyExecutor: deterministic multi-stage pipeline
+ * - HypothesisExecutor: adaptive AI-driven hypothesis loop
+ */
+import { ExecutionContext, ExecutorResult, ProgressEmitter } from '../orchestratorTypes';
+/**
+ * Common interface for analysis execution strategies.
+ * Each executor owns its own loop (stages or rounds) and returns
+ * accumulated results in a uniform format.
+ */
+export interface AnalysisExecutor {
+    execute(ctx: ExecutionContext, emitter: ProgressEmitter): Promise<ExecutorResult>;
+}
+//# sourceMappingURL=analysisExecutor.d.ts.map

package/dist/agent/core/executors/analysisExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysisExecutor.d.ts","sourceRoot":"","sources":["../../../../src/agent/core/executors/analysisExecutor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnF"}

package/dist/agent/core/executors/analysisExecutor.js

@@ -0,0 +1,6 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=analysisExecutor.js.map

package/dist/agent/core/executors/analysisExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysisExecutor.js","sourceRoot":"","sources":["../../../../src/agent/core/executors/analysisExecutor.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D"}

package/dist/agent/core/executors/clarifyExecutor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Clarify Executor
+ *
+ * A read-only executor for handling clarification requests.
+ * Explains previous findings without executing trace SQL queries.
+ *
+ * Use cases:
+ * - "为什么帧 1436069 卡顿?" → explains the jank type and contributing factors
+ * - "解释一下这个发现" → provides more context about a finding
+ * - "什么是 App Deadline Missed?" → explains technical concepts
+ *
+ * Key characteristics:
+ * - No trace SQL by default (pure LLM reasoning)
+ * - References EntityStore and findings for context
+ * - Generates explanation-style conclusions
+ */
+import { AnalysisExecutor } from './analysisExecutor';
+import { AnalysisServices, ExecutionContext, ExecutorResult, ProgressEmitter } from '../orchestratorTypes';
+import type { EnhancedSessionContext } from '../../context/enhancedSessionContext';
+export declare class ClarifyExecutor implements AnalysisExecutor {
+    private sessionContext;
+    private services;
+    constructor(sessionContext: EnhancedSessionContext, services: AnalysisServices);
+    execute(ctx: ExecutionContext, emitter: ProgressEmitter): Promise<ExecutorResult>;
+    /**
+     * Build context for clarification from session state.
+     */
+    private buildClarificationContext;
+    /**
+     * Generate explanation using LLM.
+     */
+    private generateExplanation;
+    /**
+     * Build the explanation prompt for LLM.
+     */
+    private buildExplanationPrompt;
+    /**
+     * Build a fallback explanation when LLM is unavailable.
+     */
+    private buildFallbackExplanation;
+}
+//# sourceMappingURL=clarifyExecutor.d.ts.map

package/dist/agent/core/executors/clarifyExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarifyExecutor.d.ts","sourceRoot":"","sources":["../../../../src/agent/core/executors/clarifyExecutor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAOnF,qBAAa,eAAgB,YAAW,gBAAgB;IAEpD,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;gBADR,cAAc,EAAE,sBAAsB,EACtC,QAAQ,EAAE,gBAAgB;IAG9B,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAiDvF;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0CjC;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgF9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAkCjC"}

package/dist/agent/core/executors/clarifyExecutor.js

@@ -0,0 +1,316 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClarifyExecutor = void 0;
+const orchestratorTypes_1 = require("../orchestratorTypes");
+// =============================================================================
+// ClarifyExecutor
+// =============================================================================
+class ClarifyExecutor {
+    constructor(sessionContext, services) {
+        this.sessionContext = sessionContext;
+        this.services = services;
+    }
+    async execute(ctx, emitter) {
+        emitter.log('[Clarify] Starting clarification (read-only mode)');
+        emitter.emitUpdate('progress', {
+            phase: 'clarifying',
+            message: '生成解释说明 (无需查询 trace)',
+        });
+        // Gather context for LLM
+        const context = this.buildClarificationContext(ctx);
+        // Generate explanation via LLM
+        const explanation = await this.generateExplanation(ctx.query, context, emitter);
+        // Build a single "explanation" finding
+        const findings = [{
+                id: `clarify_${Date.now()}`,
+                category: 'explanation',
+                type: 'clarification',
+                severity: 'info',
+                title: '解释说明',
+                description: explanation,
+                source: 'clarify_executor',
+                confidence: 0.9,
+            }];
+        emitter.emitUpdate('finding', {
+            round: 1,
+            findings,
+        });
+        emitter.emitUpdate('progress', {
+            phase: 'synthesis_complete',
+            confirmedFindings: 0,
+            updatedHypotheses: 0,
+            message: '解释生成完成',
+        });
+        emitter.log('[Clarify] Clarification complete');
+        return {
+            findings,
+            lastStrategy: (0, orchestratorTypes_1.concludeDecision)(0.9, 'Clarification provided'),
+            confidence: 0.9,
+            informationGaps: [],
+            rounds: 1,
+            stopReason: 'Clarification complete',
+        };
+    }
+    /**
+     * Build context for clarification from session state.
+     */
+    buildClarificationContext(ctx) {
+        const entityStore = this.sessionContext.getEntityStore();
+        const recentFindings = this.sessionContext.getAllFindings().slice(-10);
+        const referencedEntities = ctx.intent.referencedEntities || [];
+        // Gather referenced entity data
+        const frameData = [];
+        const sessionData = [];
+        for (const ref of referencedEntities) {
+            if (ref.type === 'frame') {
+                const id = ref.value ?? ref.id;
+                if (id !== undefined) {
+                    const frame = entityStore.getFrame(String(id));
+                    if (frame)
+                        frameData.push(frame);
+                }
+            }
+            else if (ref.type === 'session') {
+                const id = ref.value ?? ref.id;
+                if (id !== undefined) {
+                    const session = entityStore.getSession(String(id));
+                    if (session)
+                        sessionData.push(session);
+                }
+            }
+        }
+        // Extract recent turn summaries
+        const recentTurns = this.sessionContext.getRecentTurns(3);
+        const turnSummaries = recentTurns.map(turn => ({
+            query: turn.query,
+            findingCount: turn.findings.length,
+            keyFindings: turn.findings.slice(0, 3).map(f => f.title),
+        }));
+        return {
+            recentFindings,
+            frameData,
+            sessionData,
+            turnSummaries,
+            contextSummary: this.sessionContext.generatePromptContext(300),
+        };
+    }
+    /**
+     * Generate explanation using LLM.
+     */
+    async generateExplanation(query, context, emitter) {
+        const prompt = this.buildExplanationPrompt(query, context);
+        try {
+            const result = await this.services.modelRouter.callWithFallback(prompt, 'synthesis', {
+                sessionId: this.sessionContext.getSessionId(),
+                traceId: this.sessionContext.getTraceId(),
+                promptId: 'agent.clarifyExecutor',
+                promptVersion: '1.0.0',
+                contractVersion: 'clarify_text@1.0.0',
+            });
+            if (result.success && result.response) {
+                return result.response;
+            }
+            return '无法生成解释，请尝试重新提问或提供更多上下文。';
+        }
+        catch (error) {
+            emitter.log(`[Clarify] LLM call failed: ${error.message}`);
+            return this.buildFallbackExplanation(query, context);
+        }
+    }
+    /**
+     * Build the explanation prompt for LLM.
+     */
+    buildExplanationPrompt(query, context) {
+        const parts = [];
+        parts.push('你是一个 Android 性能分析专家，正在回答用户的澄清问题。');
+        parts.push('');
+        parts.push('## 用户问题');
+        parts.push(query);
+        parts.push('');
+        // Add context summary
+        if (context.contextSummary) {
+            parts.push('## 对话上下文');
+            parts.push(context.contextSummary);
+            parts.push('');
+        }
+        // Add frame data if relevant
+        if (context.frameData.length > 0) {
+            parts.push('## 相关帧数据');
+            for (const frame of context.frameData) {
+                parts.push(`- 帧 ${frame.frame_id}:`);
+                if (frame.jank_type)
+                    parts.push(`  - 卡顿类型: ${frame.jank_type}`);
+                if (frame.dur_ms)
+                    parts.push(`  - 持续时间: ${frame.dur_ms}ms`);
+                if (frame.vsync_missed)
+                    parts.push(`  - 丢失 VSync: ${frame.vsync_missed}`);
+                if (frame.process_name)
+                    parts.push(`  - 进程: ${frame.process_name}`);
+            }
+            parts.push('');
+        }
+        // Add session data if relevant
+        if (context.sessionData.length > 0) {
+            parts.push('## 相关会话数据');
+            for (const session of context.sessionData) {
+                parts.push(`- 会话 ${session.session_id}:`);
+                if (session.frame_count)
+                    parts.push(`  - 总帧数: ${session.frame_count}`);
+                if (session.jank_count)
+                    parts.push(`  - 卡顿帧数: ${session.jank_count}`);
+                if (session.process_name)
+                    parts.push(`  - 进程: ${session.process_name}`);
+            }
+            parts.push('');
+        }
+        // Add recent findings
+        if (context.recentFindings.length > 0) {
+            parts.push('## 近期发现');
+            for (const finding of context.recentFindings.slice(0, 5)) {
+                parts.push(`- [${finding.severity}] ${finding.title}`);
+                if (finding.description) {
+                    parts.push(`  ${finding.description.substring(0, 100)}${finding.description.length > 100 ? '...' : ''}`);
+                }
+            }
+            parts.push('');
+        }
+        parts.push('## 要求');
+        parts.push('1. 直接回答用户的问题，不要绕弯子');
+        parts.push('2. 如果是技术概念解释：');
+        parts.push('   - 先给出简明定义（1-2句话）');
+        parts.push('   - 再解释对性能的影响');
+        parts.push('   - 列出常见原因（如果适用）');
+        parts.push('3. 如果是关于特定帧/会话的问题：');
+        parts.push('   - 结合上述数据分析具体原因');
+        parts.push('   - 引用具体数值作为依据');
+        parts.push('   - 给出可能的优化方向');
+        parts.push('4. 使用中文回答，保持专业但易懂');
+        parts.push('5. 如果信息不足，明确说明：');
+        parts.push('   - 当前已知什么');
+        parts.push('   - 还需要什么信息');
+        parts.push('   - 如何获取这些信息（例如"需要先运行完整分析"）');
+        parts.push('');
+        parts.push('## 常见卡顿类型说明');
+        parts.push('- App Deadline Missed: 应用侧超时，通常是主线程或RenderThread问题');
+        parts.push('- Buffer Stuffing: 帧堆积，应用产帧速度超过显示刷新率');
+        parts.push('- SurfaceFlinger Deadline Missed: 系统合成层问题');
+        parts.push('- Dropped Frame: 帧被丢弃，最严重的卡顿类型');
+        parts.push('');
+        parts.push('请直接给出解释，不要添加额外的格式标记。');
+        return parts.join('\n');
+    }
+    /**
+     * Build a fallback explanation when LLM is unavailable.
+     */
+    buildFallbackExplanation(query, context) {
+        const parts = [];
+        parts.push('基于当前上下文的解释：');
+        parts.push('');
+        // Try to provide some useful information based on available data
+        if (context.frameData.length > 0) {
+            for (const frame of context.frameData) {
+                parts.push(`帧 ${frame.frame_id}：`);
+                if (frame.jank_type) {
+                    parts.push(`- 卡顿类型为 "${frame.jank_type}"，这表示 ${getJankTypeExplanation(frame.jank_type)}`);
+                }
+                if (frame.dur_ms) {
+                    parts.push(`- 渲染耗时 ${frame.dur_ms}ms`);
+                }
+            }
+        }
+        if (context.sessionData.length > 0) {
+            for (const session of context.sessionData) {
+                if (session.jank_count && session.frame_count) {
+                    const jankRate = ((Number(session.jank_count) / Number(session.frame_count)) * 100).toFixed(1);
+                    parts.push(`会话 ${session.session_id} 的卡顿率为 ${jankRate}%`);
+                }
+            }
+        }
+        if (parts.length === 2) {
+            parts.push('当前没有足够的上下文信息来回答这个问题。请尝试先运行一次完整的分析。');
+        }
+        return parts.join('\n');
+    }
+}
+exports.ClarifyExecutor = ClarifyExecutor;
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Get a comprehensive explanation for jank types.
+ *
+ * Provides detailed explanations including:
+ * - What the jank type means
+ * - Common causes
+ * - Where to look for more details
+ */
+function getJankTypeExplanation(jankType) {
+    const explanations = {
+        // App-side jank types
+        'App Deadline Missed': `应用在规定时间内未能完成帧的渲染。
+
+常见原因：
+• 主线程耗时操作（布局计算、业务逻辑、IO）
+• RenderThread 渲染耗时（复杂绘制、Shader 编译）
+• Binder 同步调用阻塞
+• GC 导致暂停
+
+诊断建议：查看四象限分析和主线程/RenderThread 耗时操作`,
+        'Buffer Stuffing': `应用产生帧的速度超过了显示刷新率。
+
+这通常发生在：
+• 应用连续快速提交多帧
+• 前序帧延迟导致后续帧在 Buffer 中堆积
+• 系统合成层处理不及时
+
+诊断建议：检查帧间隔是否过短，以及 SF 合成延迟`,
+        'SurfaceFlinger Deadline Missed': `SurfaceFlinger 未能及时完成帧合成。
+
+常见原因：
+• 系统负载过高
+• 图层数量过多
+• GPU 合成耗时
+• HWC 硬件合成问题
+
+诊断建议：检查系统 CPU 负载和 SF 帧处理时序`,
+        'Unknown Deadline Missed': `帧未按时完成，但系统未能明确分类原因。
+
+可能的情况：
+• 多因素共同导致
+• Trace 数据不完整
+• 边界情况
+
+诊断建议：查看帧的完整时间线和各阶段耗时`,
+        'No Jank': '该帧正常渲染，在 VSync 周期内完成，没有卡顿问题。',
+        'Dropped Frame': `帧被丢弃，未能显示到屏幕上。
+
+这是最严重的卡顿类型，用户会明显感知。通常发生在：
+• 连续多帧超时
+• 系统资源严重不足
+• GPU/SF 严重阻塞`,
+        // Additional jank types from Android FrameTimeline
+        'Display HAL': `显示硬件层面导致的延迟。
+
+可能原因：
+• 显示控制器问题
+• 刷新率切换
+• HDMI/DP 同步问题`,
+        'GPU Composition': `GPU 合成耗时过长。
+
+常见原因：
+• 过度绘制 (Overdraw)
+• 复杂的图层混合
+• GPU 频率不足`,
+        'Present Late': `帧在 Present 阶段延迟。
+
+可能原因：
+• GPU Fence 等待
+• Display commit 延迟
+• VSync 对齐问题`,
+    };
+    return explanations[jankType] || `该卡顿类型 (${jankType}) 需要进一步分析具体原因。建议查看帧级详细数据和四象限分析。`;
+}
+//# sourceMappingURL=clarifyExecutor.js.map

package/dist/agent/core/executors/clarifyExecutor.js.map

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

package/dist/agent/core/executors/comparisonExecutor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Comparison Executor
+ *
+ * Handles comparison queries between multiple frames or sessions.
+ * Resolves entities via DrillDownResolver (cache-first), then produces
+ * a comparison table and narrative diff.
+ *
+ * Use cases:
+ * - "比较帧 1436069 和 1436070" → side-by-side frame comparison
+ * - "对比会话 1 和会话 2 的卡顿率" → session metrics comparison
+ * - "这几个帧有什么区别?" → multiple entity comparison
+ *
+ * Key characteristics:
+ * - Resolves multiple entities via EntityStore cache (no re-query if cached)
+ * - SQL enrichment only for uncached entities
+ * - Generates comparison table + narrative explanation
+ */
+import { AnalysisExecutor } from './analysisExecutor';
+import { AnalysisServices, ExecutionContext, ExecutorResult, ProgressEmitter } from '../orchestratorTypes';
+import type { EnhancedSessionContext } from '../../context/enhancedSessionContext';
+export declare class ComparisonExecutor implements AnalysisExecutor {
+    private sessionContext;
+    private services;
+    private traceProcessorService?;
+    private traceId?;
+    constructor(sessionContext: EnhancedSessionContext, services: AnalysisServices, traceProcessorService?: any | undefined, traceId?: string | undefined);
+    execute(ctx: ExecutionContext, emitter: ProgressEmitter): Promise<ExecutorResult>;
+    private buildFrameComparison;
+    private buildSessionComparison;
+    private generateNarrativeDiff;
+    private buildNarrativePrompt;
+    private buildFallbackNarrative;
+    private formatComparisonTable;
+    private determineSeverity;
+    private buildInsufficientEntitiesResult;
+    private buildMixedTypesResult;
+    private buildResolutionFailedResult;
+}
+//# sourceMappingURL=comparisonExecutor.d.ts.map

package/dist/agent/core/executors/comparisonExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparisonExecutor.d.ts","sourceRoot":"","sources":["../../../../src/agent/core/executors/comparisonExecutor.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AASnF,qBAAa,kBAAmB,YAAW,gBAAgB;IAEvD,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,qBAAqB,CAAC;IAC9B,OAAO,CAAC,OAAO,CAAC;gBAHR,cAAc,EAAE,sBAAsB,EACtC,QAAQ,EAAE,gBAAgB,EAC1B,qBAAqB,CAAC,EAAE,GAAG,YAAA,EAC3B,OAAO,CAAC,EAAE,MAAM,YAAA;IAGpB,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAkIvF,OAAO,CAAC,oBAAoB;IAwB5B,OAAO,CAAC,sBAAsB;YAgChB,qBAAqB;IA2BnC,OAAO,CAAC,oBAAoB;IAqE5B,OAAO,CAAC,sBAAsB;IAkE9B,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,+BAA+B;IAoBvC,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,2BAA2B;CAmBpC"}