@gracker/smartperfetto 1.0.13

package/dist/agent/core/circuitBreaker.js

@@ -0,0 +1,500 @@
+"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.CircuitBreaker = void 0;
+/**
+ * SmartPerfetto Agent Circuit Breaker
+ *
+ * 断路器模式实现，负责：
+ * 1. 监控 Agent 失败次数
+ * 2. 在达到阈值时熔断
+ * 3. 实现指数退避重试
+ * 4. 触发用户介入机制
+ */
+const events_1 = require("events");
+const types_1 = require("../types");
+const config_1 = require("../../config");
+// 默认配置 (从统一配置文件获取)
+const DEFAULT_CONFIG = {
+    maxRetriesPerAgent: config_1.circuitBreakerConfig.maxRetriesPerAgent,
+    maxIterationsPerStage: config_1.circuitBreakerConfig.maxIterationsPerStage,
+    cooldownMs: config_1.circuitBreakerConfig.cooldownMs,
+    halfOpenAttempts: config_1.circuitBreakerConfig.halfOpenAttempts,
+    failureThreshold: config_1.circuitBreakerConfig.failureThreshold,
+    successThreshold: config_1.circuitBreakerConfig.successThreshold,
+};
+/**
+ * 断路器实现
+ *
+ * 状态转换：
+ * - closed: 正常状态，允许请求通过
+ * - open: 熔断状态，拒绝请求，等待冷却
+ * - half-open: 半开状态，允许有限请求测试恢复
+ */
+class CircuitBreaker extends events_1.EventEmitter {
+    // Threshold getters from centralized config (支持环境变量覆盖)
+    get USER_RESPONSE_TIMEOUT_MS() {
+        return config_1.circuitBreakerConfig.userResponseTimeoutMs;
+    }
+    get FORCE_CLOSE_COOLDOWN_MS() {
+        return config_1.circuitBreakerConfig.forceCloseCooldownMs;
+    }
+    get MAX_FORCE_CLOSE_COUNT() {
+        return config_1.circuitBreakerConfig.maxForceCloseCount;
+    }
+    get HALF_OPEN_SUCCESS_THRESHOLD() {
+        return config_1.circuitBreakerConfig.halfOpenSuccessThreshold;
+    }
+    constructor(config = {}) {
+        super();
+        // 【P1 Fix】用户响应超时机制
+        this.userResponseTimeout = null;
+        // 【P1 Fix】forceClose 冷却期跟踪
+        this.lastForceCloseTime = 0;
+        // 【P2 Fix】forceClose 次数限制 - 防止用户无限循环选择 'continue'
+        this.forceCloseCount = 0;
+        // 【P1 Fix】半开状态成功计数（用于渐进式恢复）
+        this.halfOpenSuccessCount = 0;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.state = this.createInitialState();
+    }
+    createInitialState() {
+        return {
+            state: types_1.CircuitState.CLOSED,
+            retryCounters: new Map(),
+            iterationCounters: new Map(),
+            failureHistory: new Map(),
+            lastStateChange: Date.now(),
+            tripReason: undefined,
+        };
+    }
+    // ==========================================================================
+    // 状态查询
+    // ==========================================================================
+    get circuitState() {
+        return this.state.state;
+    }
+    get isTripped() {
+        return this.state.state === types_1.CircuitState.OPEN;
+    }
+    get isHalfOpen() {
+        return this.state.state === types_1.CircuitState.HALF_OPEN;
+    }
+    get isClosed() {
+        return this.state.state === types_1.CircuitState.CLOSED;
+    }
+    get tripReason() {
+        return this.state.tripReason;
+    }
+    /**
+     * 【P2 Fix】获取当前 forceClose 调用次数
+     */
+    get forceCloseCallCount() {
+        return this.forceCloseCount;
+    }
+    /**
+     * 【P2 Fix】检查是否已达到 forceClose 次数上限
+     */
+    get isForceCloseLimitReached() {
+        return this.forceCloseCount >= this.MAX_FORCE_CLOSE_COUNT;
+    }
+    // ==========================================================================
+    // 失败记录
+    // ==========================================================================
+    /**
+     * 记录 Agent 失败
+     */
+    recordFailure(agentId, error) {
+        const count = (this.state.retryCounters.get(agentId) || 0) + 1;
+        this.state.retryCounters.set(agentId, count);
+        // 记录失败历史
+        this.addToFailureHistory(agentId, error || 'Unknown error');
+        // 触发事件
+        this.emit('failure', { agentId, count, error });
+        // 检查是否需要熔断
+        if (count >= this.config.maxRetriesPerAgent) {
+            return this.trip(`Agent ${agentId} 失败次数达到上限 (${count}/${this.config.maxRetriesPerAgent})`);
+        }
+        // 返回重试决策
+        return {
+            action: 'retry',
+            delay: this.calculateBackoff(count),
+            reason: `重试第 ${count} 次`,
+        };
+    }
+    /**
+     * 记录阶段迭代
+     */
+    recordIteration(stageId) {
+        const count = (this.state.iterationCounters.get(stageId) || 0) + 1;
+        this.state.iterationCounters.set(stageId, count);
+        // 触发事件
+        this.emit('iteration', { stageId, count });
+        // 检查是否超过最大迭代次数
+        if (count >= this.config.maxIterationsPerStage) {
+            return {
+                action: 'ask_user',
+                reason: `阶段 ${stageId} 已迭代 ${count} 次，需要用户决策`,
+                context: this.getDiagnostics(stageId),
+            };
+        }
+        return { action: 'continue' };
+    }
+    /**
+     * 记录成功
+     */
+    recordSuccess(agentId) {
+        // 重置该 Agent 的失败计数
+        this.state.retryCounters.set(agentId, 0);
+        // 如果处于半开状态，检查是否可以关闭断路器
+        if (this.state.state === types_1.CircuitState.HALF_OPEN) {
+            this.checkHalfOpenRecovery();
+        }
+        this.emit('success', { agentId });
+    }
+    // ==========================================================================
+    // 断路器状态管理
+    // ==========================================================================
+    /**
+     * 触发熔断
+     */
+    trip(reason) {
+        this.state.state = types_1.CircuitState.OPEN;
+        this.state.tripReason = reason;
+        this.state.lastStateChange = Date.now();
+        this.emit('tripped', { reason, diagnostics: this.getAllDiagnostics() });
+        // 启动冷却计时器
+        this.scheduleCooldown();
+        // 【P1 Fix】启动用户响应超时计时器
+        this.startUserResponseTimeout();
+        return {
+            action: 'ask_user',
+            reason,
+            context: this.getAllDiagnostics(),
+        };
+    }
+    /**
+     * 【P1 Fix】启动用户响应超时计时器
+     * 如果用户在超时时间内未响应，自动执行 abort
+     */
+    startUserResponseTimeout() {
+        // 清理之前的超时计时器
+        this.clearUserResponseTimeout();
+        this.userResponseTimeout = setTimeout(() => {
+            console.warn(`[CircuitBreaker] User response timeout after ${this.USER_RESPONSE_TIMEOUT_MS}ms, auto-aborting`);
+            this.emit('userResponseTimeout', {
+                timeoutMs: this.USER_RESPONSE_TIMEOUT_MS,
+                reason: '用户响应超时，自动中止分析',
+            });
+            // 不自动调用 handleUserResponse，而是发出事件让上层处理
+        }, this.USER_RESPONSE_TIMEOUT_MS);
+        this.userResponseTimeout.unref?.();
+    }
+    /**
+     * 【P1 Fix】清理用户响应超时计时器
+     */
+    clearUserResponseTimeout() {
+        if (this.userResponseTimeout) {
+            clearTimeout(this.userResponseTimeout);
+            this.userResponseTimeout = null;
+        }
+    }
+    /**
+     * 进入半开状态
+     */
+    halfOpen() {
+        this.state.state = types_1.CircuitState.HALF_OPEN;
+        this.state.lastStateChange = Date.now();
+        this.emit('halfOpen');
+    }
+    /**
+     * 关闭断路器（恢复正常）
+     */
+    close() {
+        this.state.state = types_1.CircuitState.CLOSED;
+        this.state.tripReason = undefined;
+        this.state.lastStateChange = Date.now();
+        this.emit('closed');
+    }
+    /**
+     * 检查半开状态是否可以恢复
+     * 【P1 Fix】实现渐进式恢复：需要多次成功才完全关闭
+     */
+    checkHalfOpenRecovery() {
+        this.halfOpenSuccessCount++;
+        if (this.halfOpenSuccessCount >= this.HALF_OPEN_SUCCESS_THRESHOLD) {
+            console.log(`[CircuitBreaker] Half-open recovery complete after ${this.halfOpenSuccessCount} successes`);
+            this.halfOpenSuccessCount = 0;
+            this.close();
+        }
+        else {
+            console.log(`[CircuitBreaker] Half-open progress: ${this.halfOpenSuccessCount}/${this.HALF_OPEN_SUCCESS_THRESHOLD} successes`);
+        }
+    }
+    /**
+     * 安排冷却后的状态转换
+     */
+    scheduleCooldown() {
+        const cooldownTimer = setTimeout(() => {
+            if (this.state.state === types_1.CircuitState.OPEN) {
+                this.halfOpen();
+            }
+        }, this.config.cooldownMs);
+        cooldownTimer.unref?.();
+    }
+    // ==========================================================================
+    // 退避算法
+    // ==========================================================================
+    /**
+     * 计算指数退避延迟
+     */
+    calculateBackoff(attemptNumber) {
+        // 指数退避：使用配置的基础延迟和最大延迟
+        const baseDelay = config_1.circuitBreakerConfig.backoffBaseDelayMs;
+        const maxDelay = config_1.circuitBreakerConfig.backoffMaxDelayMs;
+        const delay = Math.min(baseDelay * Math.pow(2, attemptNumber - 1), maxDelay);
+        // 添加抖动 (±20%)
+        const jitter = delay * 0.2 * (Math.random() * 2 - 1);
+        return Math.round(delay + jitter);
+    }
+    // ==========================================================================
+    // 诊断信息
+    // ==========================================================================
+    /**
+     * 获取单个 Agent 的诊断信息
+     */
+    getDiagnostics(agentId) {
+        const history = this.state.failureHistory.get(agentId) || [];
+        const recentErrors = history.slice(-5); // 最近 5 条错误
+        return {
+            agentId,
+            failureCount: this.state.retryCounters.get(agentId) || 0,
+            iterationCount: this.state.iterationCounters.get(agentId) || 0,
+            lastError: recentErrors.length > 0 ? recentErrors[recentErrors.length - 1].error : undefined,
+            lastAttemptTime: recentErrors.length > 0 ? recentErrors[recentErrors.length - 1].time : 0,
+            state: this.state.state,
+            recentErrors,
+        };
+    }
+    /**
+     * 获取所有诊断信息
+     */
+    getAllDiagnostics() {
+        const allErrors = [];
+        let totalFailures = 0;
+        let totalIterations = 0;
+        for (const [, count] of this.state.retryCounters) {
+            totalFailures += count;
+        }
+        for (const [, count] of this.state.iterationCounters) {
+            totalIterations += count;
+        }
+        for (const [, history] of this.state.failureHistory) {
+            allErrors.push(...history);
+        }
+        // 按时间排序
+        allErrors.sort((a, b) => b.time - a.time);
+        return {
+            agentId: '*',
+            failureCount: totalFailures,
+            iterationCount: totalIterations,
+            lastError: allErrors.length > 0 ? allErrors[0].error : undefined,
+            lastAttemptTime: allErrors.length > 0 ? allErrors[0].time : 0,
+            state: this.state.state,
+            recentErrors: allErrors.slice(0, 10),
+        };
+    }
+    /**
+     * 添加失败历史记录
+     */
+    addToFailureHistory(agentId, error) {
+        const history = this.state.failureHistory.get(agentId) || [];
+        history.push({ time: Date.now(), error });
+        // 保留最近 20 条
+        if (history.length > 20) {
+            history.shift();
+        }
+        this.state.failureHistory.set(agentId, history);
+    }
+    // ==========================================================================
+    // 请求检查
+    // ==========================================================================
+    /**
+     * 检查是否允许执行
+     */
+    canExecute() {
+        switch (this.state.state) {
+            case types_1.CircuitState.CLOSED:
+                return { action: 'continue' };
+            case types_1.CircuitState.OPEN:
+                // 检查是否已过冷却期
+                const elapsed = Date.now() - this.state.lastStateChange;
+                if (elapsed >= this.config.cooldownMs) {
+                    this.halfOpen();
+                    return { action: 'continue', reason: '断路器进入半开状态' };
+                }
+                return {
+                    action: 'ask_user',
+                    reason: this.state.tripReason || '断路器已熔断',
+                    context: this.getAllDiagnostics(),
+                };
+            case types_1.CircuitState.HALF_OPEN:
+                return { action: 'continue', reason: '断路器半开状态，测试中' };
+            default:
+                return { action: 'continue' };
+        }
+    }
+    // ==========================================================================
+    // 重置和清理
+    // ==========================================================================
+    /**
+     * 重置单个 Agent 的计数器
+     */
+    resetAgent(agentId) {
+        this.state.retryCounters.set(agentId, 0);
+        this.state.iterationCounters.set(agentId, 0);
+        this.state.failureHistory.delete(agentId);
+        this.emit('agentReset', { agentId });
+    }
+    /**
+     * 重置所有状态
+     */
+    reset() {
+        // 【P1 Fix】清理所有计时器和状态
+        this.clearUserResponseTimeout();
+        this.lastForceCloseTime = 0;
+        this.halfOpenSuccessCount = 0;
+        // 【P2 Fix】重置 forceClose 计数
+        this.forceCloseCount = 0;
+        this.state = this.createInitialState();
+        this.emit('reset');
+    }
+    /**
+     * 手动关闭断路器（用户干预后）
+     * 【P1 Fix】添加冷却期检查，防止用户快速连续选择 'continue'
+     * 【P2 Fix】添加次数限制，防止用户无限循环选择 'continue'
+     */
+    forceClose() {
+        // 【P2 Fix】检查是否超过最大 forceClose 次数
+        if (this.forceCloseCount >= this.MAX_FORCE_CLOSE_COUNT) {
+            console.warn(`[CircuitBreaker] forceClose limit reached (${this.forceCloseCount}/${this.MAX_FORCE_CLOSE_COUNT})`);
+            this.emit('forceCloseLimitReached', {
+                count: this.forceCloseCount,
+                maxCount: this.MAX_FORCE_CLOSE_COUNT,
+                reason: `已达到最大继续次数 (${this.MAX_FORCE_CLOSE_COUNT} 次)，请检查分析配置或手动中止`,
+            });
+            return false;
+        }
+        // 检查是否在冷却期内
+        const timeSinceLastForceClose = Date.now() - this.lastForceCloseTime;
+        if (this.lastForceCloseTime > 0 && timeSinceLastForceClose < this.FORCE_CLOSE_COOLDOWN_MS) {
+            const remainingCooldown = this.FORCE_CLOSE_COOLDOWN_MS - timeSinceLastForceClose;
+            console.warn(`[CircuitBreaker] forceClose in cooldown, ${remainingCooldown}ms remaining`);
+            this.emit('forceCloseCooldown', {
+                remainingMs: remainingCooldown,
+                reason: '冷却期内，请稍后再试',
+            });
+            return false;
+        }
+        // 清理用户响应超时计时器
+        this.clearUserResponseTimeout();
+        // 更新计数和时间
+        this.forceCloseCount++;
+        this.lastForceCloseTime = Date.now();
+        this.halfOpenSuccessCount = 0; // 重置半开成功计数
+        console.log(`[CircuitBreaker] forceClose executed (${this.forceCloseCount}/${this.MAX_FORCE_CLOSE_COUNT})`);
+        this.close();
+        this.emit('forceClosed', { count: this.forceCloseCount, maxCount: this.MAX_FORCE_CLOSE_COUNT });
+        return true;
+    }
+    /**
+     * 手动触发熔断（用于测试）
+     */
+    forceTrip(reason) {
+        return this.trip(reason);
+    }
+    // ==========================================================================
+    // 用户响应处理
+    // ==========================================================================
+    /**
+     * 处理用户响应
+     * 【P1 Fix】清理超时计时器，处理冷却期
+     * 【P2 Fix】处理 forceClose 次数限制
+     */
+    handleUserResponse(decision) {
+        // 清理用户响应超时计时器
+        this.clearUserResponseTimeout();
+        switch (decision) {
+            case 'continue':
+                // 【P2 Fix】先检查是否达到次数限制
+                if (this.isForceCloseLimitReached) {
+                    return {
+                        action: 'abort',
+                        reason: `已达到最大继续次数 (${this.MAX_FORCE_CLOSE_COUNT} 次)，分析自动中止。请检查分析配置或 Trace 文件。`,
+                    };
+                }
+                const forceCloseSuccess = this.forceClose();
+                if (!forceCloseSuccess) {
+                    // 在冷却期内，返回特殊响应
+                    return {
+                        action: 'ask_user',
+                        reason: '操作过于频繁，请稍后再试继续',
+                    };
+                }
+                return { action: 'continue', reason: '用户选择继续' };
+            case 'abort':
+                return { action: 'abort', reason: '用户选择中止' };
+            case 'skip':
+                return { action: 'skip', reason: '用户选择跳过当前阶段' };
+            default:
+                return { action: 'abort', reason: '未知用户决策' };
+        }
+    }
+    // ==========================================================================
+    // 配置更新
+    // ==========================================================================
+    /**
+     * 更新配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        this.emit('configUpdated', this.config);
+    }
+    /**
+     * 获取当前配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    // ==========================================================================
+    // 序列化
+    // ==========================================================================
+    /**
+     * 导出状态（用于持久化）
+     */
+    exportState() {
+        return {
+            ...this.state,
+            retryCounters: new Map(this.state.retryCounters),
+            iterationCounters: new Map(this.state.iterationCounters),
+            failureHistory: new Map(this.state.failureHistory),
+        };
+    }
+    /**
+     * 导入状态（用于恢复）
+     */
+    importState(state) {
+        this.state = {
+            ...state,
+            retryCounters: new Map(state.retryCounters),
+            iterationCounters: new Map(state.iterationCounters),
+            failureHistory: new Map(state.failureHistory),
+        };
+        this.emit('stateImported');
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+exports.default = CircuitBreaker;
+//# sourceMappingURL=circuitBreaker.js.map

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

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

package/dist/agent/core/conclusionContract.d.ts

@@ -0,0 +1,61 @@
+export type ConclusionOutputMode = 'initial_report' | 'focused_answer' | 'need_input';
+export type ConclusionClusterOutputMode = 'required' | 'optional' | 'none';
+export type ConclusionClusterFrameListMode = 'none' | 'top' | 'full';
+export interface ConclusionContractConclusionItem {
+    rank: number;
+    statement: string;
+    confidencePercent?: number;
+    trigger?: string;
+    supply?: string;
+    amplification?: string;
+}
+export interface ConclusionContractClusterItem {
+    cluster: string;
+    description?: string;
+    frames?: number;
+    percentage?: number;
+    frameRefs?: string[];
+    omittedFrameRefs?: number;
+}
+export interface ConclusionContractClusterPolicy {
+    outputMode: ConclusionClusterOutputMode;
+    frameListMode: ConclusionClusterFrameListMode;
+    maxFramesPerCluster?: number;
+}
+export interface ConclusionContractEvidenceItem {
+    conclusionId: string;
+    text: string;
+}
+export interface ConclusionContractClaimReference {
+    evidenceRefId: string;
+    rowIndex?: number;
+    rowSelector?: Record<string, string | number | boolean>;
+    column?: string;
+    value?: string | number | boolean;
+    sourceRef?: string;
+    sourceToolCallId?: string;
+}
+export interface ConclusionContractClaimItem {
+    id?: string;
+    conclusionId?: string;
+    text: string;
+    references: ConclusionContractClaimReference[];
+}
+export interface ConclusionContractMetadata {
+    confidencePercent?: number;
+    rounds?: number;
+    clusterPolicy?: ConclusionContractClusterPolicy;
+    sceneId?: string;
+}
+export interface ConclusionContract {
+    schemaVersion: 'conclusion_contract_v1';
+    mode: ConclusionOutputMode;
+    conclusions: ConclusionContractConclusionItem[];
+    clusters: ConclusionContractClusterItem[];
+    evidenceChain: ConclusionContractEvidenceItem[];
+    claims?: ConclusionContractClaimItem[];
+    uncertainties: string[];
+    nextSteps: string[];
+    metadata?: ConclusionContractMetadata;
+}
+//# sourceMappingURL=conclusionContract.d.ts.map

package/dist/agent/core/conclusionContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conclusionContract.d.ts","sourceRoot":"","sources":["../../../src/agent/core/conclusionContract.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,YAAY,CAAC;AACtF,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,2BAA2B,CAAC;IACxC,aAAa,EAAE,8BAA8B,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gCAAgC,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,+BAA+B,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,wBAAwB,CAAC;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,gCAAgC,EAAE,CAAC;IAChD,QAAQ,EAAE,6BAA6B,EAAE,CAAC;IAC1C,aAAa,EAAE,8BAA8B,EAAE,CAAC;IAChD,MAAM,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC"}

package/dist/agent/core/conclusionContract.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=conclusionContract.js.map

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

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

package/dist/agent/core/conclusionGenerator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Conclusion Generator
+ *
+ * Generates analysis conclusions from accumulated findings and hypotheses.
+ * Uses LLM for intelligent root-cause synthesis, with markdown fallback.
+ */
+import { Finding, Intent } from '../types';
+import { SharedAgentContext } from '../types/agentProtocol';
+import { ModelRouter } from './modelRouter';
+import { ProgressEmitter } from './orchestratorTypes';
+import type { ConclusionContract, ConclusionOutputMode } from './conclusionContract';
+export interface ConclusionGenerationOptions {
+    /**
+     * Number of previous turns in this session (0-based).
+     * Example: 0 means this is the first user query of the session.
+     */
+    turnCount?: number;
+    /**
+     * Optional multi-turn context summary (compact, prompt-friendly).
+     */
+    historyContext?: string;
+}
+export declare function deriveConclusionContract(rawText: string, options?: {
+    mode?: ConclusionOutputMode;
+    singleFrameDrillDown?: boolean;
+    sceneId?: string;
+}): ConclusionContract | null;
+export declare function renderConclusionContractMarkdown(contract: ConclusionContract, options?: {
+    singleFrameDrillDown?: boolean;
+}): string;
+/**
+ * Generate an AI-powered conclusion from analysis results.
+ * Falls back to a simple markdown summary if LLM fails.
+ */
+export declare function generateConclusion(sharedContext: SharedAgentContext, allFindings: Finding[], intent: Intent, modelRouter: ModelRouter, emitter: ProgressEmitter, stopReason?: string, options?: ConclusionGenerationOptions): Promise<string>;
+/**
+ * Generate a simple markdown-formatted conclusion without LLM.
+ */
+export declare function generateSimpleConclusion(findings: Finding[], stopReason?: string): string;
+export declare function shouldNormalizeConclusionOutput(text: string): boolean;
+export declare function normalizeConclusionOutput(rawText: string): string;
+//# sourceMappingURL=conclusionGenerator.d.ts.map

package/dist/agent/core/conclusionGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conclusionGenerator.d.ts","sourceRoot":"","sources":["../../../src/agent/core/conclusionGenerator.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAGV,kBAAkB,EAQlB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAsB9B,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAk1FD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,kBAAkB,GAAG,IAAI,CAwC3B;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,MAAM,CAIR;AA2ED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,kBAAkB,EACjC,WAAW,EAAE,OAAO,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,eAAe,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,MAAM,CAAC,CAqSjB;AAqED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CA+BzF;AAkkBD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBrE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBjE"}