@within-7/minto 0.4.2 → 0.4.3

package/dist/services/subagentCompressor.js

@@ -1,146 +0,0 @@
-import { countTokens } from "../utils/tokens.js";
-import { createUserMessage, normalizeMessagesForAPI } from "../utils/messages.js";
-import { queryLLM } from "./claude.js";
-import { getCompressionPrompt } from "../constants/compressionPrompts.js";
-import { getCompressionMode } from "../utils/compressionMode.js";
-const AUTO_COMPACT_THRESHOLD_RATIO = 0.92;
-class SubagentCompressor {
-  /**
-   * 判断是否应该触发压缩
-   *
-   * @param messages - Subagent 的消息数组
-   * @param contextLength - Subagent 使用的模型上下文长度
-   * @param threshold - 触发压缩的阈值比例
-   * @returns 是否应该压缩
-   *
-   * @private 内部使用
-   */
-  static shouldCompress(messages, contextLength, threshold = AUTO_COMPACT_THRESHOLD_RATIO) {
-    if (messages.length < 3) {
-      return false;
-    }
-    const tokenCount = countTokens(messages);
-    const thresholdTokens = contextLength * threshold;
-    return tokenCount >= thresholdTokens;
-  }
-  /**
-   * 执行 subagent 压缩
-   *
-   * 这是一个完全无副作用的函数：
-   * - 不调用 getMessagesSetter()（不修改全局消息）
-   * - 不清理 cache（cache 属于主 agent）
-   * - 不重置 file freshness（文件追踪属于主 agent）
-   * - 不恢复文件（subagent 应该轻量化）
-   *
-   * @param messages - Subagent 的局部消息数组
-   * @param tools - 可用工具列表
-   * @param abortSignal - 中止信号
-   * @param contextLength - Subagent 使用的模型上下文长度（必须传入！）
-   * @param options - 可选的压缩配置
-   * @returns 压缩后的消息数组和压缩状态
-   *
-   * @example
-   * ```typescript
-   * // 在 TaskTool 中使用
-   * const result = await SubagentCompressor.compress(
-   *   subagentMessages,
-   *   tools,
-   *   abortSignal,
-   *   200000, // Subagent 模型的上下文长度
-   * )
-   *
-   * if (result.wasCompacted) {
-   *   console.log('Subagent context compressed:', result.summary)
-   *   // 使用压缩后的消息继续任务
-   *   subagentMessages = result.messages
-   * }
-   * ```
-   */
-  static async compress(messages, tools, abortSignal, contextLength, options) {
-    if (!this.shouldCompress(messages, contextLength, options?.threshold)) {
-      return {
-        messages,
-        wasCompacted: false
-      };
-    }
-    try {
-      const mode = options?.mode ?? getCompressionMode();
-      const compressionPrompt = getCompressionPrompt(mode);
-      const summaryRequest = createUserMessage(compressionPrompt);
-      const summaryResponse = await queryLLM(
-        normalizeMessagesForAPI([...messages, summaryRequest]),
-        [
-          "You are a helpful AI assistant tasked with creating comprehensive conversation summaries that preserve all essential context for continuing work."
-        ],
-        0,
-        // conversationId: 0 表示不记录
-        tools,
-        abortSignal,
-        {
-          safeMode: false,
-          model: "main",
-          // 使用主模型进行压缩，确保质量
-          prependCLISysprompt: true
-        }
-      );
-      const content = summaryResponse.message.content;
-      const summary = typeof content === "string" ? content : content.length > 0 && content[0]?.type === "text" ? content[0].text : null;
-      if (!summary) {
-        throw new Error("Failed to generate conversation summary");
-      }
-      summaryResponse.message.usage = {
-        input_tokens: 0,
-        output_tokens: summaryResponse.message.usage.output_tokens,
-        cache_creation_input_tokens: 0,
-        cache_read_input_tokens: 0
-      };
-      const compressedMessages = [
-        createUserMessage(
-          "Subagent context automatically compressed due to token limit. Essential information preserved."
-        ),
-        summaryResponse
-      ];
-      return {
-        messages: compressedMessages,
-        wasCompacted: true,
-        summary
-      };
-    } catch (error) {
-      console.error("Subagent compression failed:", error);
-      return {
-        messages,
-        wasCompacted: false
-      };
-    }
-  }
-  /**
-   * 获取压缩统计信息（用于调试和监控）
-   *
-   * @param messages - 消息数组
-   * @param contextLength - 模型上下文长度
-   * @returns 压缩统计信息
-   *
-   * @example
-   * ```typescript
-   * const stats = SubagentCompressor.getCompressionStats(messages, 200000)
-   * console.log(`Context usage: ${stats.percentUsed}%`)
-   * console.log(`Tokens remaining: ${stats.tokensRemaining}`)
-   * ```
-   */
-  static getCompressionStats(messages, contextLength, threshold = AUTO_COMPACT_THRESHOLD_RATIO) {
-    const tokenCount = countTokens(messages);
-    const thresholdTokens = contextLength * threshold;
-    return {
-      tokenCount,
-      contextLimit: contextLength,
-      thresholdTokens,
-      percentUsed: Math.round(tokenCount / contextLength * 100),
-      tokensRemaining: Math.max(0, thresholdTokens - tokenCount),
-      shouldCompress: this.shouldCompress(messages, contextLength, threshold)
-    };
-  }
-}
-export {
-  SubagentCompressor
-};
-//# sourceMappingURL=subagentCompressor.js.map

package/dist/services/subagentCompressor.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/services/subagentCompressor.ts"],
-  "sourcesContent": ["/**\n * Subagent \u538B\u7F29\u5668\n *\n * \u804C\u8D23\uFF1A\n * - \u5904\u7406 subagent \u7684\u81EA\u52A8\u538B\u7F29\n * - \u5B8C\u5168\u4E0D\u64CD\u4F5C\u5168\u5C40\u72B6\u6001\uFF08\u96F6\u526F\u4F5C\u7528\u8BBE\u8BA1\uFF09\n * - \u53EA\u538B\u7F29\u4F20\u5165\u7684\u5C40\u90E8\u6D88\u606F\u6570\u7EC4\n *\n * \u5173\u952E\u7279\u6027\uFF1A\n * - \u96F6\u526F\u4F5C\u7528\uFF1A\u4E0D\u8C03\u7528 getMessagesSetter()\u3001\u4E0D\u6E05\u7406 cache\n * - \u4E0D\u6062\u590D\u6587\u4EF6\uFF1Asubagent \u5E94\u8BE5\u8F7B\u91CF\u5316\n * - \u4F7F\u7528\u4F20\u5165\u7684 contextLength \u53C2\u6570\uFF08\u4E0D\u4F7F\u7528\u5168\u5C40\u914D\u7F6E\uFF09\n * - \u4F9D\u8D56 CompressionService \u8FDB\u884C\u5B9E\u9645\u538B\u7F29\n *\n * @module SubagentCompressor\n */\n\nimport type { Message } from '@query'\nimport { countTokens } from '@utils/tokens'\nimport { createUserMessage, normalizeMessagesForAPI } from '@utils/messages'\nimport { queryLLM } from '@services/claude'\nimport { getCompressionPrompt } from '@constants/compressionPrompts'\nimport { getCompressionMode } from '@utils/compressionMode'\n\n/**\n * \u538B\u7F29\u9608\u503C\u6BD4\u4F8B\n * \u5F53\u4E0A\u4E0B\u6587\u4F7F\u7528\u7387\u8D85\u8FC7 92% \u65F6\u89E6\u53D1\u538B\u7F29\n */\nconst AUTO_COMPACT_THRESHOLD_RATIO = 0.92\n\n/**\n * Subagent \u538B\u7F29\u9009\u9879\n */\nexport interface SubagentCompressionOptions {\n  /** \u538B\u7F29\u6A21\u5F0F\uFF1Abusiness \u6216 code */\n  mode?: 'business' | 'code'\n  /** \u89E6\u53D1\u538B\u7F29\u7684\u9608\u503C\u6BD4\u4F8B\uFF08\u9ED8\u8BA4 0.92\uFF09 */\n  threshold?: number\n}\n\n/**\n * Subagent \u538B\u7F29\u7ED3\u679C\n */\nexport interface SubagentCompressionResult {\n  /** \u538B\u7F29\u540E\u7684\u6D88\u606F\u6570\u7EC4 */\n  messages: Message[]\n  /** \u662F\u5426\u6267\u884C\u4E86\u538B\u7F29 */\n  wasCompacted: boolean\n  /** \u538B\u7F29\u6458\u8981\u6587\u672C\uFF08\u4EC5\u5728\u538B\u7F29\u65F6\u5B58\u5728\uFF09 */\n  summary?: string\n}\n\n/**\n * Subagent \u538B\u7F29\u5668\u7C7B\n *\n * \u5B8C\u5168\u65E0\u72B6\u6001\u7684\u538B\u7F29\u5668\uFF0C\u4E13\u95E8\u4E3A subagent \u8BBE\u8BA1\n */\nexport class SubagentCompressor {\n  /**\n   * \u5224\u65AD\u662F\u5426\u5E94\u8BE5\u89E6\u53D1\u538B\u7F29\n   *\n   * @param messages - Subagent \u7684\u6D88\u606F\u6570\u7EC4\n   * @param contextLength - Subagent \u4F7F\u7528\u7684\u6A21\u578B\u4E0A\u4E0B\u6587\u957F\u5EA6\n   * @param threshold - \u89E6\u53D1\u538B\u7F29\u7684\u9608\u503C\u6BD4\u4F8B\n   * @returns \u662F\u5426\u5E94\u8BE5\u538B\u7F29\n   *\n   * @private \u5185\u90E8\u4F7F\u7528\n   */\n  private static shouldCompress(\n    messages: Message[],\n    contextLength: number,\n    threshold: number = AUTO_COMPACT_THRESHOLD_RATIO,\n  ): boolean {\n    // \u81F3\u5C11\u9700\u8981 3 \u6761\u6D88\u606F\u624D\u8003\u8651\u538B\u7F29\n    if (messages.length < 3) {\n      return false\n    }\n\n    const tokenCount = countTokens(messages)\n    const thresholdTokens = contextLength * threshold\n\n    return tokenCount >= thresholdTokens\n  }\n\n  /**\n   * \u6267\u884C subagent \u538B\u7F29\n   *\n   * \u8FD9\u662F\u4E00\u4E2A\u5B8C\u5168\u65E0\u526F\u4F5C\u7528\u7684\u51FD\u6570\uFF1A\n   * - \u4E0D\u8C03\u7528 getMessagesSetter()\uFF08\u4E0D\u4FEE\u6539\u5168\u5C40\u6D88\u606F\uFF09\n   * - \u4E0D\u6E05\u7406 cache\uFF08cache \u5C5E\u4E8E\u4E3B agent\uFF09\n   * - \u4E0D\u91CD\u7F6E file freshness\uFF08\u6587\u4EF6\u8FFD\u8E2A\u5C5E\u4E8E\u4E3B agent\uFF09\n   * - \u4E0D\u6062\u590D\u6587\u4EF6\uFF08subagent \u5E94\u8BE5\u8F7B\u91CF\u5316\uFF09\n   *\n   * @param messages - Subagent \u7684\u5C40\u90E8\u6D88\u606F\u6570\u7EC4\n   * @param tools - \u53EF\u7528\u5DE5\u5177\u5217\u8868\n   * @param abortSignal - \u4E2D\u6B62\u4FE1\u53F7\n   * @param contextLength - Subagent \u4F7F\u7528\u7684\u6A21\u578B\u4E0A\u4E0B\u6587\u957F\u5EA6\uFF08\u5FC5\u987B\u4F20\u5165\uFF01\uFF09\n   * @param options - \u53EF\u9009\u7684\u538B\u7F29\u914D\u7F6E\n   * @returns \u538B\u7F29\u540E\u7684\u6D88\u606F\u6570\u7EC4\u548C\u538B\u7F29\u72B6\u6001\n   *\n   * @example\n   * ```typescript\n   * // \u5728 TaskTool \u4E2D\u4F7F\u7528\n   * const result = await SubagentCompressor.compress(\n   *   subagentMessages,\n   *   tools,\n   *   abortSignal,\n   *   200000, // Subagent \u6A21\u578B\u7684\u4E0A\u4E0B\u6587\u957F\u5EA6\n   * )\n   *\n   * if (result.wasCompacted) {\n   *   console.log('Subagent context compressed:', result.summary)\n   *   // \u4F7F\u7528\u538B\u7F29\u540E\u7684\u6D88\u606F\u7EE7\u7EED\u4EFB\u52A1\n   *   subagentMessages = result.messages\n   * }\n   * ```\n   */\n  static async compress(\n    messages: Message[],\n    tools: any[],\n    abortSignal: AbortSignal,\n    contextLength: number,\n    options?: SubagentCompressionOptions,\n  ): Promise<SubagentCompressionResult> {\n    // \u68C0\u67E5\u662F\u5426\u9700\u8981\u538B\u7F29\n    if (!this.shouldCompress(messages, contextLength, options?.threshold)) {\n      return {\n        messages,\n        wasCompacted: false,\n      }\n    }\n\n    try {\n      // 1. \u83B7\u53D6\u538B\u7F29\u63D0\u793A\u8BCD\n      const mode = options?.mode ?? getCompressionMode()\n      const compressionPrompt = getCompressionPrompt(mode)\n      const summaryRequest = createUserMessage(compressionPrompt)\n\n      // 2. \u8C03\u7528 LLM \u751F\u6210\u538B\u7F29\u6458\u8981\n      // \u6CE8\u610F\uFF1A\u4F7F\u7528 'main' \u6A21\u578B\u6307\u9488\uFF0C\u786E\u4FDD\u538B\u7F29\u8D28\u91CF\n      const summaryResponse = await queryLLM(\n        normalizeMessagesForAPI([...messages, summaryRequest]),\n        [\n          'You are a helpful AI assistant tasked with creating comprehensive conversation summaries that preserve all essential context for continuing work.',\n        ],\n        0, // conversationId: 0 \u8868\u793A\u4E0D\u8BB0\u5F55\n        tools,\n        abortSignal,\n        {\n          safeMode: false,\n          model: 'main', // \u4F7F\u7528\u4E3B\u6A21\u578B\u8FDB\u884C\u538B\u7F29\uFF0C\u786E\u4FDD\u8D28\u91CF\n          prependCLISysprompt: true,\n        },\n      )\n\n      // 3. \u63D0\u53D6\u6458\u8981\u6587\u672C\n      const content = summaryResponse.message.content\n      const summary =\n        typeof content === 'string'\n          ? content\n          : content.length > 0 && content[0]?.type === 'text'\n            ? content[0].text\n            : null\n\n      if (!summary) {\n        throw new Error('Failed to generate conversation summary')\n      }\n\n      // 4. \u91CD\u7F6E\u6458\u8981\u54CD\u5E94\u7684 token \u8BA1\u6570\uFF08\u907F\u514D\u91CD\u590D\u8BA1\u8D39\uFF09\n      summaryResponse.message.usage = {\n        input_tokens: 0,\n        output_tokens: summaryResponse.message.usage.output_tokens,\n        cache_creation_input_tokens: 0,\n        cache_read_input_tokens: 0,\n      }\n\n      // 5. \u6784\u5EFA\u538B\u7F29\u540E\u7684\u6D88\u606F\u6570\u7EC4\n      // \u53EA\u5305\u542B\u538B\u7F29\u6458\u8981\uFF0C\u4E0D\u6062\u590D\u6587\u4EF6\n      const compressedMessages: Message[] = [\n        createUserMessage(\n          'Subagent context automatically compressed due to token limit. Essential information preserved.',\n        ),\n        summaryResponse,\n      ]\n\n      // \u2705 \u96F6\u526F\u4F5C\u7528\u4FDD\u8BC1\uFF1A\n      // - \u4E0D\u8C03\u7528 getMessagesSetter()\n      // - \u4E0D\u6E05\u7406 getContext.cache\n      // - \u4E0D\u6E05\u7406 getCodeStyle.cache\n      // - \u4E0D\u8C03\u7528 resetFileFreshnessSession()\n      // - \u4E0D\u6062\u590D\u6587\u4EF6\uFF08recoverFiles: false\uFF09\n\n      return {\n        messages: compressedMessages,\n        wasCompacted: true,\n        summary,\n      }\n    } catch (error) {\n      // \u5BB9\u9519\u673A\u5236\uFF1A\u5982\u679C\u538B\u7F29\u5931\u8D25\uFF0C\u8FD4\u56DE\u539F\u59CB\u6D88\u606F\n      // Subagent \u53EF\u4EE5\u7EE7\u7EED\u6267\u884C\uFF0C\u4F46\u53EF\u80FD\u4F1A\u8D85\u51FA\u4E0A\u4E0B\u6587\u9650\u5236\n      console.error('Subagent compression failed:', error)\n      return {\n        messages,\n        wasCompacted: false,\n      }\n    }\n  }\n\n  /**\n   * \u83B7\u53D6\u538B\u7F29\u7EDF\u8BA1\u4FE1\u606F\uFF08\u7528\u4E8E\u8C03\u8BD5\u548C\u76D1\u63A7\uFF09\n   *\n   * @param messages - \u6D88\u606F\u6570\u7EC4\n   * @param contextLength - \u6A21\u578B\u4E0A\u4E0B\u6587\u957F\u5EA6\n   * @returns \u538B\u7F29\u7EDF\u8BA1\u4FE1\u606F\n   *\n   * @example\n   * ```typescript\n   * const stats = SubagentCompressor.getCompressionStats(messages, 200000)\n   * console.log(`Context usage: ${stats.percentUsed}%`)\n   * console.log(`Tokens remaining: ${stats.tokensRemaining}`)\n   * ```\n   */\n  static getCompressionStats(\n    messages: Message[],\n    contextLength: number,\n    threshold: number = AUTO_COMPACT_THRESHOLD_RATIO,\n  ): {\n    tokenCount: number\n    contextLimit: number\n    thresholdTokens: number\n    percentUsed: number\n    tokensRemaining: number\n    shouldCompress: boolean\n  } {\n    const tokenCount = countTokens(messages)\n    const thresholdTokens = contextLength * threshold\n\n    return {\n      tokenCount,\n      contextLimit: contextLength,\n      thresholdTokens,\n      percentUsed: Math.round((tokenCount / contextLength) * 100),\n      tokensRemaining: Math.max(0, thresholdTokens - tokenCount),\n      shouldCompress: this.shouldCompress(messages, contextLength, threshold),\n    }\n  }\n}\n"],
-  "mappings": "AAkBA,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB,+BAA+B;AAC3D,SAAS,gBAAgB;AACzB,SAAS,4BAA4B;AACrC,SAAS,0BAA0B;AAMnC,MAAM,+BAA+B;AA6B9B,MAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAW9B,OAAe,eACb,UACA,eACA,YAAoB,8BACX;AAET,QAAI,SAAS,SAAS,GAAG;AACvB,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,YAAY,QAAQ;AACvC,UAAM,kBAAkB,gBAAgB;AAExC,WAAO,cAAc;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmCA,aAAa,SACX,UACA,OACA,aACA,eACA,SACoC;AAEpC,QAAI,CAAC,KAAK,eAAe,UAAU,eAAe,SAAS,SAAS,GAAG;AACrE,aAAO;AAAA,QACL;AAAA,QACA,cAAc;AAAA,MAChB;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,OAAO,SAAS,QAAQ,mBAAmB;AACjD,YAAM,oBAAoB,qBAAqB,IAAI;AACnD,YAAM,iBAAiB,kBAAkB,iBAAiB;AAI1D,YAAM,kBAAkB,MAAM;AAAA,QAC5B,wBAAwB,CAAC,GAAG,UAAU,cAAc,CAAC;AAAA,QACrD;AAAA,UACE;AAAA,QACF;AAAA,QACA;AAAA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,UACE,UAAU;AAAA,UACV,OAAO;AAAA;AAAA,UACP,qBAAqB;AAAA,QACvB;AAAA,MACF;AAGA,YAAM,UAAU,gBAAgB,QAAQ;AACxC,YAAM,UACJ,OAAO,YAAY,WACf,UACA,QAAQ,SAAS,KAAK,QAAQ,CAAC,GAAG,SAAS,SACzC,QAAQ,CAAC,EAAE,OACX;AAER,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AAGA,sBAAgB,QAAQ,QAAQ;AAAA,QAC9B,cAAc;AAAA,QACd,eAAe,gBAAgB,QAAQ,MAAM;AAAA,QAC7C,6BAA6B;AAAA,QAC7B,yBAAyB;AAAA,MAC3B;AAIA,YAAM,qBAAgC;AAAA,QACpC;AAAA,UACE;AAAA,QACF;AAAA,QACA;AAAA,MACF;AASA,aAAO;AAAA,QACL,UAAU;AAAA,QACV,cAAc;AAAA,QACd;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AAGd,cAAQ,MAAM,gCAAgC,KAAK;AACnD,aAAO;AAAA,QACL;AAAA,QACA,cAAc;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,OAAO,oBACL,UACA,eACA,YAAoB,8BAQpB;AACA,UAAM,aAAa,YAAY,QAAQ;AACvC,UAAM,kBAAkB,gBAAgB;AAExC,WAAO;AAAA,MACL;AAAA,MACA,cAAc;AAAA,MACd;AAAA,MACA,aAAa,KAAK,MAAO,aAAa,gBAAiB,GAAG;AAAA,MAC1D,iBAAiB,KAAK,IAAI,GAAG,kBAAkB,UAAU;AAAA,MACzD,gBAAgB,KAAK,eAAe,UAAU,eAAe,SAAS;AAAA,IACxE;AAAA,EACF;AACF;",
-  "names": []
-}