autosnippet 3.2.16 → 3.2.17

package/dist/lib/{service/agent → agent}/context/ContextWindow.d.ts

@@ -43,11 +43,6 @@ interface ToolResultQuota {
  * 一组相关消息的原子单元:
  * - assistant(toolCalls) + 所有后续 tool results
  * - 或单独的 user/assistant 文本消息
- *
- * @typedef {Object} MessageRound
- * @property {'tool-round'|'text'} type
- * @property {Array<Object>} messages 本轮包含的消息
- * @property {number} estimatedTokens 估算 token 数
  */
 export declare class ContextWindow {
     #private;
@@ -55,7 +50,6 @@ export declare class ContextWindow {
      * 模型名 → 上下文窗口大小映射（token 数）。
      * 键为正则模式，按优先级从上到下匹配。
      * 值为模型的原始上下文窗口上限。
-     * @type {Array<[RegExp, number]>}
      */
     static MODEL_CONTEXT_WINDOWS: (number | RegExp)[][];
     /**
@@ -67,99 +61,68 @@ export declare class ContextWindow {
      *   - 小窗口 (≥16k):  预算 12000
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
-     * @param {string} modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
+     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
      * @param {{ isSystem?: boolean }} [opts] - isSystem 为 true 时给予更高预算
-     * @returns {number} 建议的 token 预算
+     * @returns 建议的 token 预算
      */
     static resolveTokenBudget(modelName: string, opts?: {
         isSystem?: boolean;
     }): number;
-    /**
-     * @param {number} [tokenBudget=24000] - token 预算上限
-     */
+    /** @param [tokenBudget=24000] token 预算上限 */
     constructor(tokenBudget?: number);
-    /**
-     * 追加用户消息
-     * @param {string} content
-     */
+    /** 追加用户消息 */
     appendUserMessage(content: string): void;
     /**
      * 追加阶段过渡引导消息 — 轻量级 user 消息，用于在 ExplorationTracker 阶段转换时
      * 向 AI 明确传达新阶段的行为期望。与 appendUserMessage 功能相同，
      * 独立命名以便审计和搜索。
-     * @param {string} content
      */
     appendUserNudge(content: string): void;
     /**
      * 追加 assistant 消息（含工具调用）
-     * @param {string|null} text - assistant 文本
-     * @param {Array} toolCalls - [{id, name, args}]
+     * @param text assistant 文本
+     * @param toolCalls [{id, name, args}]
      */
     appendAssistantWithToolCalls(text: string | null, toolCalls: ToolCallInfo[]): void;
     /**
      * 追加工具结果（必须紧跟 assistant toolCalls 后）
-     * @param {string} toolCallId
-     * @param {string} name 工具名
-     * @param {string} content 工具返回内容（已经过 ToolResultLimiter 截断）
+     * @param name 工具名
+     * @param content 工具返回内容（已经过 ToolResultLimiter 截断）
      */
     appendToolResult(toolCallId: string, name: string, content: string): void;
-    /**
-     * 追加 assistant 纯文本消息（无工具调用）
-     * @param {string} text
-     */
+    /** 追加 assistant 纯文本消息（无工具调用） */
     appendAssistantText(text: string): void;
     /**
      * 在每次 AI 调用前调用 — 根据 token 使用率执行分级压缩
      *
-     * @returns {{ level: number, removed: number }} 压缩结果
+     * @returns } 压缩结果
      */
     compactIfNeeded(): {
         level: number;
         removed: number;
     };
-    /**
-     * 导出消息（供 AI Provider 使用）
-     * @returns {Array<Object>}
-     */
+    /** 导出消息（供 AI Provider 使用） */
     toMessages(): ContextMessage[];
-    /**
-     * 获取消息数量
-     * @returns {number}
-     */
+    /** 获取消息数量 */
     get length(): number;
-    /**
-     * 获取 token 预算
-     * @returns {number}
-     */
+    /** 获取 token 预算 */
     get tokenBudget(): number;
-    /**
-     * 估算当前 token 使用量
-     * @returns {number}
-     */
+    /** 估算当前 token 使用量 */
     estimateTokens(): number;
-    /**
-     * 获取 token 使用率 (0-1)
-     * @returns {number}
-     */
+    /** 获取 token 使用率 (0-1) */
     getTokenUsageRatio(): number;
     /**
      * 获取动态工具结果配额
      * 根据当前 token 使用率返回工具结果的大小限制
-     * @returns {{ maxChars: number, maxMatches: number }}
+     * @returns }
      */
     getToolResultQuota(): {
         maxChars: number;
         maxMatches: number;
     };
-    /**
-     * 获取压缩日志（用于调试）
-     * @returns {Array<string>}
-     */
+    /** 获取压缩日志（用于调试） */
     getCompactionLog(): string[];
-    /**
-     * 获取被压缩掉的已提交候选标题
-     * @returns {Set<string>}
-     */
+    /** 获取被压缩掉的已提交候选标题 */
     getCompactedSubmits(): Set<unknown>;
     /**
      * 清空消息 — 仅保留首条 prompt
@@ -182,11 +145,10 @@ export declare class ContextWindow {
 /**
  * 工具结果入口限制器 — 在工具结果进入 ContextWindow 前压缩
  *
- * @param {string} toolName 工具名
- * @param {*} result 工具原始返回
+ * @param toolName 工具名
+ * @param result 工具原始返回
  * @param {{ maxChars: number, maxMatches: number }} quota 动态配额
- * @returns {string} 压缩后的结果字符串
+ * @returns 压缩后的结果字符串
  */
 export declare function limitToolResult(toolName: string, result: unknown, quota: ToolResultQuota): string;
 export {};
-//# sourceMappingURL=ContextWindow.d.ts.map

package/dist/lib/{service/agent → agent}/context/ContextWindow.js

@@ -26,11 +26,6 @@ import { estimateTokensFast } from '#shared/token-utils.js';
  * 一组相关消息的原子单元:
  * - assistant(toolCalls) + 所有后续 tool results
  * - 或单独的 user/assistant 文本消息
- *
- * @typedef {Object} MessageRound
- * @property {'tool-round'|'text'} type
- * @property {Array<Object>} messages 本轮包含的消息
- * @property {number} estimatedTokens 估算 token 数
  */
 export class ContextWindow {
     /** @type {Array<ContextMessage>} 统一格式消息 */
@@ -47,7 +42,6 @@ export class ContextWindow {
      * 模型名 → 上下文窗口大小映射（token 数）。
      * 键为正则模式，按优先级从上到下匹配。
      * 值为模型的原始上下文窗口上限。
-     * @type {Array<[RegExp, number]>}
      */
     static MODEL_CONTEXT_WINDOWS = [
         // ── Google Gemini ──
@@ -92,9 +86,9 @@ export class ContextWindow {
      *   - 小窗口 (≥16k):  预算 12000
      *   - 微窗口 (<16k):  预算 = 窗口 × 0.7（留 30% 给 prompt/tool schema）
      *
-     * @param {string} modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
+     * @param modelName 模型名称，如 'gemini-3-flash-preview', 'gpt-4o-mini'
      * @param {{ isSystem?: boolean }} [opts] - isSystem 为 true 时给予更高预算
-     * @returns {number} 建议的 token 预算
+     * @returns 建议的 token 预算
      */
     static resolveTokenBudget(modelName, opts = {}) {
         const { isSystem = false } = opts;
@@ -124,18 +118,13 @@ export class ContextWindow {
         }
         return budget;
     }
-    /**
-     * @param {number} [tokenBudget=24000] - token 预算上限
-     */
+    /** @param [tokenBudget=24000] token 预算上限 */
     constructor(tokenBudget = 24000) {
         this.#tokenBudget = tokenBudget;
         this.#logger = Logger.getInstance();
     }
     // ─── 消息添加 API ──────────────────────────────────────
-    /**
-     * 追加用户消息
-     * @param {string} content
-     */
+    /** 追加用户消息 */
     appendUserMessage(content) {
         this.#messages.push({ role: 'user', content });
     }
@@ -143,15 +132,14 @@ export class ContextWindow {
      * 追加阶段过渡引导消息 — 轻量级 user 消息，用于在 ExplorationTracker 阶段转换时
      * 向 AI 明确传达新阶段的行为期望。与 appendUserMessage 功能相同，
      * 独立命名以便审计和搜索。
-     * @param {string} content
      */
     appendUserNudge(content) {
         this.#messages.push({ role: 'user', content });
     }
     /**
      * 追加 assistant 消息（含工具调用）
-     * @param {string|null} text - assistant 文本
-     * @param {Array} toolCalls - [{id, name, args}]
+     * @param text assistant 文本
+     * @param toolCalls [{id, name, args}]
      */
     appendAssistantWithToolCalls(text, toolCalls) {
         this.#messages.push({
@@ -162,9 +150,8 @@ export class ContextWindow {
     }
     /**
      * 追加工具结果（必须紧跟 assistant toolCalls 后）
-     * @param {string} toolCallId
-     * @param {string} name 工具名
-     * @param {string} content 工具返回内容（已经过 ToolResultLimiter 截断）
+     * @param name 工具名
+     * @param content 工具返回内容（已经过 ToolResultLimiter 截断）
      */
     appendToolResult(toolCallId, name, content) {
         this.#messages.push({
@@ -174,10 +161,7 @@ export class ContextWindow {
             content,
         });
     }
-    /**
-     * 追加 assistant 纯文本消息（无工具调用）
-     * @param {string} text
-     */
+    /** 追加 assistant 纯文本消息（无工具调用） */
     appendAssistantText(text) {
         this.#messages.push({
             role: 'assistant',
@@ -188,7 +172,7 @@ export class ContextWindow {
     /**
      * 在每次 AI 调用前调用 — 根据 token 使用率执行分级压缩
      *
-     * @returns {{ level: number, removed: number }} 压缩结果
+     * @returns } 压缩结果
      */
     compactIfNeeded() {
         const usage = this.getTokenUsageRatio();
@@ -247,9 +231,7 @@ export class ContextWindow {
         }
         return this.#spliceAndSummarize(keepFrom, 2);
     }
-    /**
-     * L3 压缩: 激进模式 — 仅保留 prompt + 最后 1 轮
-     */
+    /** L3 压缩: 激进模式 — 仅保留 prompt + 最后 1 轮 */
     #compactL3() {
         const lastRoundStart = this.#findLastToolRoundStart();
         if (lastRoundStart <= 1) {
@@ -265,8 +247,8 @@ export class ContextWindow {
     }
     /**
      * 执行 splice + summarize（L2/L3 共用）
-     * @param {number} keepFrom 保留的消息起始位置
-     * @param {number} level 压缩级别
+     * @param keepFrom 保留的消息起始位置
+     * @param level 压缩级别
      *
      * ⚠ 注意：此方法在 messages[1] 插入 role='user' 摘要，
      *   与 messages[0]（也是 user）形成连续同角色消息。
@@ -307,31 +289,19 @@ export class ContextWindow {
         return { level, removed: removedCount };
     }
     // ─── 查询 API ─────────────────────────────────────────
-    /**
-     * 导出消息（供 AI Provider 使用）
-     * @returns {Array<Object>}
-     */
+    /** 导出消息（供 AI Provider 使用） */
     toMessages() {
         return this.#messages;
     }
-    /**
-     * 获取消息数量
-     * @returns {number}
-     */
+    /** 获取消息数量 */
     get length() {
         return this.#messages.length;
     }
-    /**
-     * 获取 token 预算
-     * @returns {number}
-     */
+    /** 获取 token 预算 */
     get tokenBudget() {
         return this.#tokenBudget;
     }
-    /**
-     * 估算当前 token 使用量
-     * @returns {number}
-     */
+    /** 估算当前 token 使用量 */
     estimateTokens() {
         let total = 0;
         for (const m of this.#messages) {
@@ -344,17 +314,14 @@ export class ContextWindow {
         }
         return total;
     }
-    /**
-     * 获取 token 使用率 (0-1)
-     * @returns {number}
-     */
+    /** 获取 token 使用率 (0-1) */
     getTokenUsageRatio() {
         return this.estimateTokens() / this.#tokenBudget;
     }
     /**
      * 获取动态工具结果配额
      * 根据当前 token 使用率返回工具结果的大小限制
-     * @returns {{ maxChars: number, maxMatches: number }}
+     * @returns }
      */
     getToolResultQuota() {
         const usage = this.getTokenUsageRatio();
@@ -369,17 +336,11 @@ export class ContextWindow {
         }
         return { maxChars: 800, maxMatches: 3 };
     }
-    /**
-     * 获取压缩日志（用于调试）
-     * @returns {Array<string>}
-     */
+    /** 获取压缩日志（用于调试） */
     getCompactionLog() {
         return [...this.#compactionLog];
     }
-    /**
-     * 获取被压缩掉的已提交候选标题
-     * @returns {Set<string>}
-     */
+    /** 获取被压缩掉的已提交候选标题 */
     getCompactedSubmits() {
         return new Set(this.#compactedSubmits);
     }
@@ -413,7 +374,7 @@ export class ContextWindow {
     }
     /**
      * 从消息中提取已提交候选到 compactedSubmits
-     * @param {number} fromIdx 从哪个索引开始扫描
+     * @param fromIdx 从哪个索引开始扫描
      */
     #extractCompactedSubmits(fromIdx) {
         for (let i = fromIdx; i < this.#messages.length; i++) {
@@ -430,7 +391,7 @@ export class ContextWindow {
     // ─── 内部方法 ──────────────────────────────────────────
     /**
      * 找到最后一个 assistant(toolCalls) 的位置
-     * @returns {number} 位置索引，-1 表示找不到
+     * @returns 位置索引，-1 表示找不到
      */
     #findLastToolRoundStart() {
         for (let i = this.#messages.length - 1; i >= 1; i--) {
@@ -441,10 +402,7 @@ export class ContextWindow {
         }
         return -1;
     }
-    /**
-     * 找到所有 assistant(toolCalls) 的位置（按顺序）
-     * @returns {Array<number>}
-     */
+    /** 找到所有 assistant(toolCalls) 的位置（按顺序） */
     #findAllToolRoundStarts() {
         const starts = [];
         for (let i = 1; i < this.#messages.length; i++) {
@@ -460,10 +418,10 @@ export class ContextWindow {
 /**
  * 工具结果入口限制器 — 在工具结果进入 ContextWindow 前压缩
  *
- * @param {string} toolName 工具名
- * @param {*} result 工具原始返回
+ * @param toolName 工具名
+ * @param result 工具原始返回
  * @param {{ maxChars: number, maxMatches: number }} quota 动态配额
- * @returns {string} 压缩后的结果字符串
+ * @returns 压缩后的结果字符串
  */
 export function limitToolResult(toolName, result, quota) {
     const { maxChars = 4000, maxMatches = 10 } = quota;
@@ -582,9 +540,7 @@ function limitSearchResultObj(result, maxMatches, maxChars) {
     }
     return limited;
 }
-/**
- * 限制文件内容 — 截断 content 字段
- */
+/** 限制文件内容 — 截断 content 字段 */
 function limitFileContent(result, maxChars) {
     if (typeof result === 'string') {
         return result.length > maxChars ? `${result.substring(0, maxChars)}\n... [truncated]` : result;
@@ -607,4 +563,3 @@ function limitFileContent(result, maxChars) {
     }
     return JSON.stringify(limited);
 }
-//# sourceMappingURL=ContextWindow.js.map

package/dist/lib/{service/agent → agent}/context/ExplorationTracker.d.ts

@@ -38,60 +38,44 @@ interface BudgetInput extends Partial<ExplorationBudget> {
 export declare class ExplorationTracker {
     #private;
     /**
-     * @param {object} strategy 策略配置对象
-     * @param {object} budget 预算配置 { maxIterations, searchBudget, ... }
+     * @param strategy 策略配置对象
+     * @param budget 预算配置 { maxIterations, searchBudget, ... }
      */
     constructor(strategy: ExplorationStrategy, budget: BudgetInput);
     /**
      * 根据调用参数解析应使用的策略
-     * @param {object} opts - AgentRuntime execute 的选项
-     * @param {object} budget 预算配置
-     * @returns {ExplorationTracker|null} - User 模式返回 null
+     * @param opts AgentRuntime execute 的选项
+     * @param budget 预算配置
+     * @returns User 模式返回 null
      */
     static resolve(opts: ResolveOptions, budget: BudgetInput): ExplorationTracker | null;
-    /**
-     * 每轮迭代开始时调用 — 递增计数
-     */
+    /** 每轮迭代开始时调用 — 递增计数 */
     tick(): void;
-    /**
-     * 撤销 tick（AI 调用失败或空响应时，不计入迭代）
-     */
+    /** 撤销 tick（AI 调用失败或空响应时，不计入迭代） */
     rollbackTick(): void;
     /** 提交工具名 */
     get submitToolName(): string;
     /** 管线类型标识 */
     get pipelineType(): PipelineType;
-    /**
-     * 是否应退出主循环
-     * @returns {boolean}
-     */
+    /** 是否应退出主循环 */
     shouldExit(): boolean;
     /**
      * 获取本轮的 Nudge（每轮最多一条）
-     * @param {object} trace 推理链
-     * @returns {{ type: string, text: string }|null}
+     * @param trace 推理链
+     * @returns |null}
      */
     getNudge(trace: ExplorationTrace | null): {
         type: string;
         text: string;
     } | null;
-    /**
-     * 获取当前阶段的上下文状态行（注入 systemPrompt 尾部）
-     * @returns {string}
-     */
+    /** 获取当前阶段的上下文状态行（注入 systemPrompt 尾部） */
     getPhaseContext(): string;
-    /**
-     * 获取当前阶段的 toolChoice
-     * @returns {'required'|'auto'|'none'}
-     */
+    /** 获取当前阶段的 toolChoice */
     getToolChoice(): "none" | "auto" | "required";
     /**
      * 记录一次工具调用结果，更新内部指标
      *
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     * @returns {{ isNew: boolean }}
+     * @returns }
      */
     recordToolCall(toolName: string, args: Record<string, unknown>, result: unknown): {
         isNew: boolean;
@@ -99,8 +83,7 @@ export declare class ExplorationTracker {
     /**
      * 结束本轮迭代 — 更新轮次级指标 + 检查阶段转换
      *
-     * @param {object} roundStats
-     * @returns {{ type: string, text: string }|null} 阶段转换 nudge
+     * @returns |null} 阶段转换 nudge
      */
     endRound({ hasNewInfo, submitCount, toolNames, skipped, }?: {
         hasNewInfo?: boolean | undefined;
@@ -113,7 +96,7 @@ export declare class ExplorationTracker {
     } | null;
     /**
      * 处理 AI 返回纯文本响应（无工具调用）
-     * @returns {{ isFinalAnswer: boolean, needsDigestNudge: boolean, shouldContinue: boolean, nudge: string|null }}
+     * @returns }
      */
     onTextResponse(): {
         isFinalAnswer: boolean;
@@ -121,10 +104,7 @@ export declare class ExplorationTracker {
         shouldContinue: boolean;
         nudge: string | null;
     };
-    /**
-     * 记录被截断的工具调用数量
-     * @param {number} count
-     */
+    /** 记录被截断的工具调用数量 */
     recordTruncatedCalls(count: number): void;
     get isGracefulExit(): boolean;
     get isHardExit(): boolean;
@@ -162,15 +142,11 @@ export declare class ExplorationTracker {
         lastReplanIteration: number | null;
         consecutiveOffPlan: number;
     };
-    /**
-     * 更新计划进度 — 委托 PlanTracker
-     * @param {object} trace
-     */
+    /** 更新计划进度 — 委托 PlanTracker */
     updatePlanProgress(trace: ExplorationTrace | null): void;
     /**
      * 推理质量评分 — 委托 PlanTracker
-     * @param {object} trace
-     * @returns {{ score: number, breakdown: object }}
+     * @returns }
      */
     getQualityMetrics(trace: ExplorationTrace | null): {
         score: number;
@@ -178,4 +154,3 @@ export declare class ExplorationTracker {
     };
 }
 export default ExplorationTracker;
-//# sourceMappingURL=ExplorationTracker.d.ts.map