@gracker/smartperfetto 1.0.13

package/dist/agent/compaction/compactionTypes.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Context Compaction Types
+ *
+ * 定义 Context 压缩系统的核心类型
+ */
+import { SubAgentContext } from '../types';
+/**
+ * 压缩策略类型
+ */
+export type CompactionStrategy = 'sliding_window' | 'severity' | 'hybrid';
+/**
+ * 压缩策略接口
+ */
+export interface ICompactionStrategy {
+    /** 策略名称 */
+    name: CompactionStrategy;
+    /**
+     * 压缩上下文
+     * @param context 原始上下文
+     * @param config 压缩配置
+     * @returns 压缩后的上下文和元数据
+     */
+    compact(context: SubAgentContext, config: CompactionConfig): Promise<CompactionResult>;
+    /**
+     * 估算压缩后的 token 数
+     */
+    estimateCompactedTokens(context: SubAgentContext, config: CompactionConfig): number;
+}
+/**
+ * 压缩配置
+ */
+export interface CompactionConfig {
+    /** 最大上下文 token 数（默认 8000） */
+    maxContextTokens: number;
+    /** 触发压缩的阈值（默认 6000，即 80%） */
+    compactionThreshold: number;
+    /** 保留最近的结果数量（默认 3） */
+    preserveRecentCount: number;
+    /** 压缩策略 */
+    strategy: CompactionStrategy;
+    /** 是否使用 LLM 生成摘要（成本更高但质量更好） */
+    useLLMSummarization: boolean;
+    /** LLM 摘要的最大 token 数 */
+    summaryMaxTokens?: number;
+    /** 是否保留所有 critical 发现 */
+    preserveCriticalFindings?: boolean;
+    /** 自定义字段权重（用于决定保留优先级） */
+    fieldWeights?: Partial<Record<CompactableField, number>>;
+}
+/**
+ * 可压缩的字段
+ */
+export type CompactableField = 'previousResults' | 'findings' | 'plan' | 'intent';
+/**
+ * 默认配置
+ */
+export declare const DEFAULT_COMPACTION_CONFIG: CompactionConfig;
+/**
+ * 压缩结果
+ */
+export interface CompactionResult {
+    /** 压缩后的上下文 */
+    compactedContext: SubAgentContext;
+    /** 原始 token 数 */
+    originalTokens: number;
+    /** 压缩后 token 数 */
+    compactedTokens: number;
+    /** 压缩率 (0-1) */
+    compressionRatio: number;
+    /** 被移除的结果数量 */
+    removedResultsCount: number;
+    /** 被移除的发现数量 */
+    removedFindingsCount: number;
+    /** 是否生成了摘要 */
+    hasSummary: boolean;
+    /** 摘要内容（如果有） */
+    summary?: CompactionSummary;
+    /** 压缩元数据 */
+    metadata: CompactionMetadata;
+}
+/**
+ * 压缩摘要
+ */
+export interface CompactionSummary {
+    /** 历史结果摘要 */
+    historicalResultsSummary: string;
+    /** 关键发现摘要 */
+    keyFindingsSummary: string;
+    /** 被压缩的迭代范围 */
+    compactedIterations: {
+        from: number;
+        to: number;
+    };
+    /** 摘要生成方式 */
+    generatedBy: 'rule' | 'llm';
+}
+/**
+ * 压缩元数据
+ */
+export interface CompactionMetadata {
+    /** 压缩时间戳 */
+    timestamp: number;
+    /** 使用的策略 */
+    strategy: CompactionStrategy;
+    /** 压缩前的迭代次数 */
+    originalIterations: number;
+    /** 压缩后保留的迭代次数 */
+    preservedIterations: number;
+    /** 压缩原因 */
+    reason: 'threshold_exceeded' | 'manual' | 'pre_iteration';
+}
+/**
+ * Token 估算结果
+ */
+export interface TokenEstimate {
+    /** 总 token 数 */
+    total: number;
+    /** 各字段的 token 数 */
+    breakdown: {
+        sessionId: number;
+        traceId: number;
+        intent: number;
+        plan: number;
+        previousResults: number;
+        findings: number;
+        other: number;
+    };
+    /** 是否超过阈值 */
+    exceedsThreshold: boolean;
+    /** 建议的压缩量 */
+    suggestedReduction: number;
+}
+/**
+ * Token 估算器配置
+ */
+export interface TokenEstimatorConfig {
+    /** 平均每个字符的 token 数（中文约 0.5，英文约 0.25） */
+    charsPerToken: number;
+    /** JSON 结构开销因子 */
+    jsonOverheadFactor: number;
+}
+/**
+ * 默认 Token 估算器配置
+ */
+export declare const DEFAULT_TOKEN_ESTIMATOR_CONFIG: TokenEstimatorConfig;
+/**
+ * 压缩器状态（用于跟踪压缩历史）
+ */
+export interface CompactorState {
+    /** 会话 ID */
+    sessionId: string;
+    /** 已执行的压缩次数 */
+    compactionCount: number;
+    /** 累计移除的结果数 */
+    totalRemovedResults: number;
+    /** 累计移除的发现数 */
+    totalRemovedFindings: number;
+    /** 历史摘要（累积） */
+    accumulatedSummaries: CompactionSummary[];
+    /** 上次压缩时间 */
+    lastCompactionTime: number;
+}
+//# sourceMappingURL=compactionTypes.d.ts.map

package/dist/agent/compaction/compactionTypes.d.ts.map

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

package/dist/agent/compaction/compactionTypes.js

@@ -0,0 +1,32 @@
+"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.DEFAULT_TOKEN_ESTIMATOR_CONFIG = exports.DEFAULT_COMPACTION_CONFIG = void 0;
+/**
+ * 默认配置
+ */
+exports.DEFAULT_COMPACTION_CONFIG = {
+    maxContextTokens: 8000,
+    compactionThreshold: 6000, // 80%
+    preserveRecentCount: 3,
+    strategy: 'sliding_window',
+    useLLMSummarization: false,
+    summaryMaxTokens: 500,
+    preserveCriticalFindings: true,
+    fieldWeights: {
+        previousResults: 0.6, // 最大占比
+        findings: 0.2,
+        plan: 0.1,
+        intent: 0.1,
+    },
+};
+/**
+ * 默认 Token 估算器配置
+ */
+exports.DEFAULT_TOKEN_ESTIMATOR_CONFIG = {
+    charsPerToken: 0.4, // 中英文混合估算
+    jsonOverheadFactor: 1.2, // JSON 结构额外开销
+};
+//# sourceMappingURL=compactionTypes.js.map

package/dist/agent/compaction/compactionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactionTypes.js","sourceRoot":"","sources":["../../../src/agent/compaction/compactionTypes.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;AA2F/D;;GAEG;AACU,QAAA,yBAAyB,GAAqB;IACzD,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI,EAAG,MAAM;IAClC,mBAAmB,EAAE,CAAC;IACtB,QAAQ,EAAE,gBAAgB;IAC1B,mBAAmB,EAAE,KAAK;IAC1B,gBAAgB,EAAE,GAAG;IACrB,wBAAwB,EAAE,IAAI;IAC9B,YAAY,EAAE;QACZ,eAAe,EAAE,GAAG,EAAG,OAAO;QAC9B,QAAQ,EAAE,GAAG;QACb,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,GAAG;KACZ;CACF,CAAC;AAsHF;;GAEG;AACU,QAAA,8BAA8B,GAAyB;IAClE,aAAa,EAAE,GAAG,EAAG,UAAU;IAC/B,kBAAkB,EAAE,GAAG,EAAG,cAAc;CACzC,CAAC"}

package/dist/agent/compaction/contextCompactor.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Context Compactor
+ *
+ * 上下文压缩服务
+ * 当上下文超过阈值时自动压缩，防止 token 溢出
+ */
+import { CompactionConfig, CompactionResult, CompactionStrategy, ICompactionStrategy, CompactorState } from './compactionTypes';
+import { SubAgentContext } from '../types';
+/**
+ * Context Compactor 配置
+ */
+export interface ContextCompactorConfig extends CompactionConfig {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 是否记录压缩操作 */
+    logCompaction?: boolean;
+}
+/**
+ * 默认配置
+ */
+export declare const DEFAULT_CONTEXT_COMPACTOR_CONFIG: ContextCompactorConfig;
+/**
+ * Context Compactor
+ */
+export declare class ContextCompactor {
+    private config;
+    private tokenEstimator;
+    private strategies;
+    private sessionStates;
+    constructor(config?: Partial<ContextCompactorConfig>);
+    /**
+     * 注册压缩策略
+     */
+    registerStrategy(strategy: ICompactionStrategy): void;
+    /**
+     * 获取策略
+     */
+    getStrategy(name: CompactionStrategy): ICompactionStrategy | undefined;
+    /**
+     * 检查是否需要压缩
+     */
+    needsCompaction(context: SubAgentContext): boolean;
+    /**
+     * 执行压缩
+     */
+    compact(context: SubAgentContext, reason?: 'threshold_exceeded' | 'manual' | 'pre_iteration'): Promise<CompactionResult>;
+    /**
+     * 自动压缩（如果需要）
+     */
+    compactIfNeeded(context: SubAgentContext): Promise<SubAgentContext>;
+    /**
+     * 估算上下文 token 数
+     */
+    estimateTokens(context: SubAgentContext): number;
+    /**
+     * 获取详细的 token 估算
+     */
+    getDetailedEstimate(context: SubAgentContext): import("./compactionTypes").TokenEstimate;
+    /**
+     * 获取会话压缩状态
+     */
+    getSessionState(sessionId: string): CompactorState | undefined;
+    /**
+     * 更新会话状态
+     */
+    private updateSessionState;
+    /**
+     * 清除会话状态
+     */
+    clearSessionState(sessionId: string): void;
+    /**
+     * 启用/禁用压缩
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * 检查是否启用
+     */
+    isEnabled(): boolean;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<ContextCompactorConfig>): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): ContextCompactorConfig;
+    /**
+     * 记录压缩结果
+     */
+    private logCompactionResult;
+}
+/**
+ * 获取全局 Context Compactor
+ */
+export declare function getContextCompactor(): ContextCompactor;
+/**
+ * 设置全局 Context Compactor
+ */
+export declare function setContextCompactor(compactor: ContextCompactor): void;
+/**
+ * 重置全局 Context Compactor
+ */
+export declare function resetContextCompactor(): void;
+/**
+ * 创建 Context Compactor
+ */
+export declare function createContextCompactor(config?: Partial<ContextCompactorConfig>): ContextCompactor;
+export default ContextCompactor;
+//# sourceMappingURL=contextCompactor.d.ts.map

package/dist/agent/compaction/contextCompactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextCompactor.d.ts","sourceRoot":"","sources":["../../../src/agent/compaction/contextCompactor.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQ3C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IAEjB,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,EAAE,sBAI9C,CAAC;AAEF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAA8B;gBAEvC,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAcxD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIrD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,SAAS;IAQtE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;IAWlD;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,eAAe,EACxB,MAAM,GAAE,oBAAoB,GAAG,QAAQ,GAAG,eAAsC,GAC/E,OAAO,CAAC,gBAAgB,CAAC;IAsB5B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IASzE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAIhD;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,eAAe;IAQ5C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI9D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,SAAS,IAAI,sBAAsB;IAQnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAU5B;AAQD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC3C,gBAAgB,CAElB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/agent/compaction/contextCompactor.js

@@ -0,0 +1,225 @@
+"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.ContextCompactor = exports.DEFAULT_CONTEXT_COMPACTOR_CONFIG = void 0;
+exports.getContextCompactor = getContextCompactor;
+exports.setContextCompactor = setContextCompactor;
+exports.resetContextCompactor = resetContextCompactor;
+exports.createContextCompactor = createContextCompactor;
+/**
+ * Context Compactor
+ *
+ * 上下文压缩服务
+ * 当上下文超过阈值时自动压缩，防止 token 溢出
+ */
+const compactionTypes_1 = require("./compactionTypes");
+const tokenEstimator_1 = require("./tokenEstimator");
+const slidingWindowStrategy_1 = require("./strategies/slidingWindowStrategy");
+/**
+ * 默认配置
+ */
+exports.DEFAULT_CONTEXT_COMPACTOR_CONFIG = {
+    ...compactionTypes_1.DEFAULT_COMPACTION_CONFIG,
+    enabled: true, // 默认启用，防止 token 溢出
+    logCompaction: false,
+};
+/**
+ * Context Compactor
+ */
+class ContextCompactor {
+    constructor(config = {}) {
+        this.config = { ...exports.DEFAULT_CONTEXT_COMPACTOR_CONFIG, ...config };
+        this.tokenEstimator = (0, tokenEstimator_1.getTokenEstimator)();
+        this.strategies = new Map();
+        this.sessionStates = new Map();
+        // 注册内置策略
+        this.registerStrategy(new slidingWindowStrategy_1.SlidingWindowStrategy(this.tokenEstimator));
+    }
+    // ===========================================================================
+    // Strategy Management
+    // ===========================================================================
+    /**
+     * 注册压缩策略
+     */
+    registerStrategy(strategy) {
+        this.strategies.set(strategy.name, strategy);
+    }
+    /**
+     * 获取策略
+     */
+    getStrategy(name) {
+        return this.strategies.get(name);
+    }
+    // ===========================================================================
+    // Main Methods
+    // ===========================================================================
+    /**
+     * 检查是否需要压缩
+     */
+    needsCompaction(context) {
+        if (!this.config.enabled) {
+            return false;
+        }
+        return this.tokenEstimator.needsCompaction(context, this.config.compactionThreshold);
+    }
+    /**
+     * 执行压缩
+     */
+    async compact(context, reason = 'threshold_exceeded') {
+        // 获取策略
+        const strategy = this.strategies.get(this.config.strategy);
+        if (!strategy) {
+            throw new Error(`Unknown compaction strategy: ${this.config.strategy}`);
+        }
+        // 执行压缩
+        const result = await strategy.compact(context, this.config);
+        result.metadata.reason = reason;
+        // 更新会话状态
+        this.updateSessionState(context.sessionId, result);
+        // 记录日志
+        if (this.config.logCompaction) {
+            this.logCompactionResult(result);
+        }
+        return result;
+    }
+    /**
+     * 自动压缩（如果需要）
+     */
+    async compactIfNeeded(context) {
+        if (!this.needsCompaction(context)) {
+            return context;
+        }
+        const result = await this.compact(context, 'threshold_exceeded');
+        return result.compactedContext;
+    }
+    /**
+     * 估算上下文 token 数
+     */
+    estimateTokens(context) {
+        return this.tokenEstimator.estimate(context).total;
+    }
+    /**
+     * 获取详细的 token 估算
+     */
+    getDetailedEstimate(context) {
+        return this.tokenEstimator.estimateWithThreshold(context, this.config);
+    }
+    // ===========================================================================
+    // Session State Management
+    // ===========================================================================
+    /**
+     * 获取会话压缩状态
+     */
+    getSessionState(sessionId) {
+        return this.sessionStates.get(sessionId);
+    }
+    /**
+     * 更新会话状态
+     */
+    updateSessionState(sessionId, result) {
+        let state = this.sessionStates.get(sessionId);
+        if (!state) {
+            state = {
+                sessionId,
+                compactionCount: 0,
+                totalRemovedResults: 0,
+                totalRemovedFindings: 0,
+                accumulatedSummaries: [],
+                lastCompactionTime: 0,
+            };
+        }
+        state.compactionCount++;
+        state.totalRemovedResults += result.removedResultsCount;
+        state.totalRemovedFindings += result.removedFindingsCount;
+        state.lastCompactionTime = result.metadata.timestamp;
+        if (result.summary) {
+            state.accumulatedSummaries.push(result.summary);
+        }
+        this.sessionStates.set(sessionId, state);
+    }
+    /**
+     * 清除会话状态
+     */
+    clearSessionState(sessionId) {
+        this.sessionStates.delete(sessionId);
+    }
+    // ===========================================================================
+    // Configuration
+    // ===========================================================================
+    /**
+     * 启用/禁用压缩
+     */
+    setEnabled(enabled) {
+        this.config.enabled = enabled;
+    }
+    /**
+     * 检查是否启用
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * 更新配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    // ===========================================================================
+    // Logging
+    // ===========================================================================
+    /**
+     * 记录压缩结果
+     */
+    logCompactionResult(result) {
+        console.log(`[ContextCompactor] Compaction completed:`);
+        console.log(`  - Strategy: ${result.metadata.strategy}`);
+        console.log(`  - Original tokens: ${result.originalTokens}`);
+        console.log(`  - Compacted tokens: ${result.compactedTokens}`);
+        console.log(`  - Compression ratio: ${(result.compressionRatio * 100).toFixed(1)}%`);
+        console.log(`  - Removed results: ${result.removedResultsCount}`);
+        console.log(`  - Removed findings: ${result.removedFindingsCount}`);
+        console.log(`  - Has summary: ${result.hasSummary}`);
+    }
+}
+exports.ContextCompactor = ContextCompactor;
+// =============================================================================
+// Singleton and Factory
+// =============================================================================
+let _globalContextCompactor = null;
+/**
+ * 获取全局 Context Compactor
+ */
+function getContextCompactor() {
+    if (!_globalContextCompactor) {
+        _globalContextCompactor = new ContextCompactor();
+    }
+    return _globalContextCompactor;
+}
+/**
+ * 设置全局 Context Compactor
+ */
+function setContextCompactor(compactor) {
+    _globalContextCompactor = compactor;
+}
+/**
+ * 重置全局 Context Compactor
+ */
+function resetContextCompactor() {
+    _globalContextCompactor = null;
+}
+/**
+ * 创建 Context Compactor
+ */
+function createContextCompactor(config = {}) {
+    return new ContextCompactor(config);
+}
+exports.default = ContextCompactor;
+//# sourceMappingURL=contextCompactor.js.map

package/dist/agent/compaction/contextCompactor.js.map

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

package/dist/agent/compaction/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Context Compaction System Exports
+ *
+ * SmartPerfetto Agent Context 压缩系统
+ */
+export * from './compactionTypes';
+export { TokenEstimator, getTokenEstimator, createTokenEstimator, } from './tokenEstimator';
+export { ContextCompactor, getContextCompactor, setContextCompactor, resetContextCompactor, createContextCompactor, type ContextCompactorConfig, DEFAULT_CONTEXT_COMPACTOR_CONFIG, } from './contextCompactor';
+export * from './strategies';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/compaction/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAG5B,cAAc,cAAc,CAAC"}

package/dist/agent/compaction/index.js

@@ -0,0 +1,43 @@
+"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.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONTEXT_COMPACTOR_CONFIG = exports.createContextCompactor = exports.resetContextCompactor = exports.setContextCompactor = exports.getContextCompactor = exports.ContextCompactor = exports.createTokenEstimator = exports.getTokenEstimator = exports.TokenEstimator = void 0;
+/**
+ * Context Compaction System Exports
+ *
+ * SmartPerfetto Agent Context 压缩系统
+ */
+// Types
+__exportStar(require("./compactionTypes"), exports);
+// Token Estimator
+var tokenEstimator_1 = require("./tokenEstimator");
+Object.defineProperty(exports, "TokenEstimator", { enumerable: true, get: function () { return tokenEstimator_1.TokenEstimator; } });
+Object.defineProperty(exports, "getTokenEstimator", { enumerable: true, get: function () { return tokenEstimator_1.getTokenEstimator; } });
+Object.defineProperty(exports, "createTokenEstimator", { enumerable: true, get: function () { return tokenEstimator_1.createTokenEstimator; } });
+// Context Compactor
+var contextCompactor_1 = require("./contextCompactor");
+Object.defineProperty(exports, "ContextCompactor", { enumerable: true, get: function () { return contextCompactor_1.ContextCompactor; } });
+Object.defineProperty(exports, "getContextCompactor", { enumerable: true, get: function () { return contextCompactor_1.getContextCompactor; } });
+Object.defineProperty(exports, "setContextCompactor", { enumerable: true, get: function () { return contextCompactor_1.setContextCompactor; } });
+Object.defineProperty(exports, "resetContextCompactor", { enumerable: true, get: function () { return contextCompactor_1.resetContextCompactor; } });
+Object.defineProperty(exports, "createContextCompactor", { enumerable: true, get: function () { return contextCompactor_1.createContextCompactor; } });
+Object.defineProperty(exports, "DEFAULT_CONTEXT_COMPACTOR_CONFIG", { enumerable: true, get: function () { return contextCompactor_1.DEFAULT_CONTEXT_COMPACTOR_CONFIG; } });
+// Strategies
+__exportStar(require("./strategies"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agent/compaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/compaction/index.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;;;;;;;;;;;;;;;AAE/D;;;;GAIG;AAEH,QAAQ;AACR,oDAAkC;AAElC,kBAAkB;AAClB,mDAI0B;AAHxB,gHAAA,cAAc,OAAA;AACd,mHAAA,iBAAiB,OAAA;AACjB,sHAAA,oBAAoB,OAAA;AAGtB,oBAAoB;AACpB,uDAQ4B;AAP1B,oHAAA,gBAAgB,OAAA;AAChB,uHAAA,mBAAmB,OAAA;AACnB,uHAAA,mBAAmB,OAAA;AACnB,yHAAA,qBAAqB,OAAA;AACrB,0HAAA,sBAAsB,OAAA;AAEtB,oIAAA,gCAAgC,OAAA;AAGlC,aAAa;AACb,+CAA6B"}

package/dist/agent/compaction/strategies/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compaction Strategies Exports
+ */
+export { SlidingWindowStrategy, createSlidingWindowStrategy, } from './slidingWindowStrategy';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/compaction/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/compaction/strategies/index.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC"}

package/dist/agent/compaction/strategies/index.js

@@ -0,0 +1,13 @@
+"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.createSlidingWindowStrategy = exports.SlidingWindowStrategy = void 0;
+/**
+ * Compaction Strategies Exports
+ */
+var slidingWindowStrategy_1 = require("./slidingWindowStrategy");
+Object.defineProperty(exports, "SlidingWindowStrategy", { enumerable: true, get: function () { return slidingWindowStrategy_1.SlidingWindowStrategy; } });
+Object.defineProperty(exports, "createSlidingWindowStrategy", { enumerable: true, get: function () { return slidingWindowStrategy_1.createSlidingWindowStrategy; } });
+//# sourceMappingURL=index.js.map

package/dist/agent/compaction/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agent/compaction/strategies/index.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;AAE/D;;GAEG;AAEH,iEAGiC;AAF/B,8HAAA,qBAAqB,OAAA;AACrB,oIAAA,2BAA2B,OAAA"}