autosnippet 3.2.16 → 3.2.17

package/dist/lib/{service/agent → agent}/forced-summary.js

@@ -11,21 +11,20 @@
  *
  * @module forced-summary
  */
-import Logger from '../../infrastructure/logging/Logger.js';
+import Logger from '#infra/logging/Logger.js';
 import { cleanFinalAnswer } from './core/ChatAgentPrompts.js';
 const logger = Logger.getInstance();
 /**
  * 生成强制摘要
  *
- * @param {Object} opts
- * @param {import('../../external/ai/AiProvider.js').AiProvider} opts.aiProvider - LLM 提供商
- * @param {string} [opts.source] - 'user' | 'system'
- * @param {Array} opts.toolCalls 工具调用记录
- * @param {Object} [opts.tracker] - ExplorationTracker 实例
- * @param {Object} [opts.contextWindow] - ContextWindow 实例 (用于避免超出 token)
- * @param {string} opts.prompt 原始用户 prompt
- * @param {Object} [opts.tokenUsage] - token 用量 (会被修改)
- * @returns {Promise<{ reply: string, tokenUsage: { input: number, output: number } }>}
+ * @param opts.aiProvider LLM 提供商
+ * @param [opts.source] 'user' | 'system'
+ * @param opts.toolCalls 工具调用记录
+ * @param [opts.tracker] ExplorationTracker 实例
+ * @param [opts.contextWindow] ContextWindow 实例 (用于避免超出 token)
+ * @param opts.prompt 原始用户 prompt
+ * @param [opts.tokenUsage] token 用量 (会被修改)
+ * @returns }>}
  */
 export async function produceForcedSummary({ aiProvider, source, toolCalls = [], tracker, contextWindow, prompt, tokenUsage, }) {
     const isSystem = source === 'system';
@@ -232,11 +231,7 @@ ${toolContextSummary}
     logger.info(`[ForcedSummary] ✅ forced summary — ${finalReply.length} chars`);
     return { reply: finalReply, tokenUsage: resultTokenUsage };
 }
-/**
- * 从工具调用记录中提取上下文摘要 (供 user 源强制总结使用)
- * @param {Array} toolCalls
- * @returns {string}
- */
+/** 从工具调用记录中提取上下文摘要 (供 user 源强制总结使用) */
 function buildToolContextForUserSummary(toolCalls) {
     const sections = [];
     // 目录结构探索
@@ -307,4 +302,3 @@ function buildToolContextForUserSummary(toolCalls) {
     return sections.length > 0 ? sections.join('\n') : '（工具调用记录为空）';
 }
 export default produceForcedSummary;
-//# sourceMappingURL=forced-summary.js.map

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

@@ -1,7 +1,7 @@
 /**
  * AutoSnippet Agent 模块 — 统一出口
  *
- * @module service/agent
+ * @module agent
  *
  * 统一架构: ONE Runtime, 多种配置
  *
@@ -58,4 +58,3 @@ export { PipelineStrategy } from './PipelineStrategy.js';
 export { BudgetPolicy, Policy, PolicyEngine, QualityGatePolicy, SafetyPolicy, } from './policies.js';
 export { getPreset, PRESETS, resolveStrategy } from './presets.js';
 export { AdaptiveStrategy, FanOutStrategy, SingleStrategy, Strategy, StrategyRegistry, } from './strategies.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/{service/agent → agent}/index.js

@@ -1,7 +1,7 @@
 /**
  * AutoSnippet Agent 模块 — 统一出口
  *
- * @module service/agent
+ * @module agent
  *
  * 统一架构: ONE Runtime, 多种配置
  *
@@ -64,4 +64,3 @@ export { BudgetPolicy, Policy, PolicyEngine, QualityGatePolicy, SafetyPolicy, }
 export { getPreset, PRESETS, resolveStrategy } from './presets.js';
 // ── Strategies ──
 export { AdaptiveStrategy, FanOutStrategy, SingleStrategy, Strategy, StrategyRegistry, } from './strategies.js';
-//# sourceMappingURL=index.js.map

package/dist/lib/{service/agent → agent}/memory/ActiveContext.d.ts

@@ -81,70 +81,48 @@ interface ActiveContextJSON {
 export declare class ActiveContext {
     #private;
     /**
-     * @param {object} [options]
-     * @param {number} [options.maxRecentRounds=3] 保留最近 N 轮原始结果 (WM 滑动窗口)
-     * @param {boolean} [options.lightweight=false] 轻量模式: 跳过 WM 的压缩/Scratchpad 逻辑 (D5)
+     * @param [options.maxRecentRounds=3] 保留最近 N 轮原始结果 (WM 滑动窗口)
+     * @param [options.lightweight=false] 轻量模式: 跳过 WM 的压缩/Scratchpad 逻辑 (D5)
      */
     constructor(options?: ActiveContextOptions);
     /**
      * 开始新一轮推理
-     * @param {number} iteration 轮次编号
+     * @param iteration 轮次编号
      */
     startRound(iteration: number): void;
-    /**
-     * 结束当前轮次
-     */
+    /** 结束当前轮次 */
     endRound(): void;
-    /**
-     * 记录 AI 的推理文本（从 aiResult.text 提取）
-     * @param {string} text
-     */
+    /** 记录 AI 的推理文本（从 aiResult.text 提取） */
     setThought(text: string): void;
     /**
      * 统一记录一次工具调用 — 合并原 WM.observe() + RT.addAction() + RT.addObservation()
      *
-     * @param {string} toolName 工具名称
-     * @param {object} args 工具参数
-     * @param {*} result 工具返回的原始结果
-     * @param {boolean} isNew 是否发现新信息 (由 ExplorationTracker.recordToolCall 提供)
+     * @param toolName 工具名称
+     * @param args 工具参数
+     * @param result 工具返回的原始结果
+     * @param isNew 是否发现新信息 (由 ExplorationTracker.recordToolCall 提供)
      */
     recordToolCall(toolName: string, args: Record<string, unknown>, result: unknown, isNew: boolean): void;
-    /**
-     * 兼容旧 RT API: 记录一次工具调用 (Action only)
-     * @param {string} toolName
-     * @param {object} params
-     */
+    /** 兼容旧 RT API: 记录一次工具调用 (Action only) */
     addAction(toolName: string, params: Record<string, unknown>): void;
-    /**
-     * 兼容旧 RT API: 记录一次工具结果的结构化观察
-     * @param {string} toolName
-     * @param {object} meta
-     */
+    /** 兼容旧 RT API: 记录一次工具结果的结构化观察 */
     addObservation(toolName: string, meta: Record<string, unknown>): void;
-    /**
-     * 兼容旧 WM API: 记录工具调用结果 (Observe, 仅 WM 滑动窗口)
-     * @param {string} toolName
-     * @param {*} result
-     * @param {number} round
-     */
+    /** 兼容旧 WM API: 记录工具调用结果 (Observe, 仅 WM 滑动窗口) */
     observe(toolName: string, result: unknown, round: number): void;
-    /**
-     * 记录反思内容 (ExplorationTracker 使用, L5 修复)
-     * @param {string} text
-     */
+    /** 记录反思内容 (ExplorationTracker 使用, L5 修复) */
     setReflection(text: string): void;
     /**
      * 记录轮次摘要
-     * @param {object} summary - { newInfoCount, totalCalls, submits, cumulativeFiles, cumulativePatterns }
+     * @param summary { newInfoCount, totalCalls, submits, cumulativeFiles, cumulativePatterns }
      */
     setRoundSummary(summary: RoundSummary): void;
     /**
      * Agent 主动记录关键发现 (note_finding 工具入口)
      *
-     * @param {string} finding 关键发现描述
-     * @param {string} [evidence] 证据 (文件路径:行号)
-     * @param {number} [importance=5] 重要性 1-10
-     * @param {number} [round=0] 当前轮次
+     * @param finding 关键发现描述
+     * @param [evidence] 证据 (文件路径:行号)
+     * @param [importance=5] 重要性 1-10
+     * @param [round=0] 当前轮次
      */
     noteKeyFinding(finding: string, evidence?: unknown, importance?: number, round?: number): void;
     /**
@@ -154,9 +132,9 @@ export declare class ActiveContext {
      * 这防止 reflection 回复中的编号列表（非计划的回应文本）污染已有计划。
      * ExplorationTracker 在发送 plan elicitation / replan 时调用 expectPlan() 授权更新。
      *
-     * @param {string} text - AI 完整响应文本
-     * @param {number} iteration 当前轮次
-     * @returns {boolean} 是否成功提取到计划
+     * @param text AI 完整响应文本
+     * @param iteration 当前轮次
+     * @returns 是否成功提取到计划
      */
     extractAndSetPlan(text: string, iteration: number): boolean;
     /**
@@ -164,22 +142,11 @@ export declare class ActiveContext {
      * 由 ExplorationTracker 在发送 plan elicitation / replan nudge 时调用。
      */
     expectPlan(): void;
-    /**
-     * 直接设置计划 (公开接口，供 ExplorationTracker 和测试使用)
-     * @param {string} planText
-     * @param {number} iteration
-     */
+    /** 直接设置计划 (公开接口，供 ExplorationTracker 和测试使用) */
     setPlan(planText: string, iteration: number): void;
-    /**
-     * 更新计划 (保留旧 plan 到 history)
-     * @param {string} replanText
-     * @param {number} iteration
-     */
+    /** 更新计划 (保留旧 plan 到 history) */
     updatePlan(replanText: string, iteration: number): void;
-    /**
-     * 获取当前计划 (只读副本)
-     * @returns {Plan|null}
-     */
+    /** 获取当前计划 (只读副本) */
     getPlan(): {
         steps: {
             description: string;
@@ -190,15 +157,9 @@ export declare class ActiveContext {
         createdAtIteration: number;
         lastUpdatedAtIteration: number;
     } | null;
-    /**
-     * 获取计划步骤的可变引用 (ExplorationTracker.updatePlanProgress 使用)
-     * @returns {Array<PlanStep>}
-     */
+    /** 获取计划步骤的可变引用 (ExplorationTracker.updatePlanProgress 使用) */
     getPlanStepsMutable(): PlanStep[];
-    /**
-     * 获取计划历史 (F7)
-     * @returns {Array<Plan>}
-     */
+    /** 获取计划历史 (F7) */
     getPlanHistory(): {
         steps: {
             description: string;
@@ -211,27 +172,22 @@ export declare class ActiveContext {
     }[];
     /**
      * 获取当前轮次的 actions (ExplorationTracker.updatePlanProgress 使用, L5 修复)
-     * @returns {Array<{tool: string, params: object}>}
+     * @returns >}
      */
     getCurrentRoundActions(): RoundAction[];
-    /**
-     * 获取当前轮次的 iteration 编号 (F8)
-     * @returns {number|null}
-     */
+    /** 获取当前轮次的 iteration 编号 (F8) */
     getCurrentIteration(): number | null;
     /**
      * 构建当前工作记忆的上下文快照
      * 用于注入到 system prompt 或 user nudge 中
      *
-     * @param {number} [tokenBudget=Infinity] - token 预算 (新增: 预算控制)
-     * @returns {string} Markdown 格式的上下文块，空字符串表示无内容
+     * @param [tokenBudget=Infinity] token 预算 (新增: 预算控制)
+     * @returns Markdown 格式的上下文块，空字符串表示无内容
      */
     buildContext(tokenBudget?: number): string;
     /**
      * 蒸馏 ActiveContext 为结构化报告
      * 在 Agent execute 结束时调用，结果写入 SessionStore
-     *
-     * @returns {DistilledContext}
      */
     distill(): {
         keyFindings: {
@@ -263,7 +219,7 @@ export declare class ActiveContext {
     };
     /**
      * 获取所有有 Thought 的轮次
-     * @returns {Array<{iteration: number, thought: string}>}
+     * @returns >}
      */
     getThoughts(): {
         iteration: number;
@@ -271,8 +227,7 @@ export declare class ActiveContext {
     }[];
     /**
      * 获取最近 N 轮的紧凑摘要 (ExplorationTracker.#checkReflection 使用)
-     * @param {number} [n=3] 回看轮数
-     * @returns {object|null}
+     * @param [n=3] 回看轮数
      */
     getRecentSummary(n?: number): {
         roundCount: number;
@@ -281,10 +236,7 @@ export declare class ActiveContext {
         newInfoRatio: number;
         lastIteration: number;
     } | null;
-    /**
-     * 统计指标 (ExplorationTracker.getQualityMetrics 使用)
-     * @returns {object}
-     */
+    /** 统计指标 (ExplorationTracker.getQualityMetrics 使用) */
     getStats(): {
         totalRounds: number;
         thoughtCount: number;
@@ -293,26 +245,16 @@ export declare class ActiveContext {
         reflectionCount: number;
         totalDurationMs: number;
     };
-    /**
-     * 获取 scratchpad 中的关键发现数量
-     * @returns {number}
-     */
+    /** 获取 scratchpad 中的关键发现数量 */
     get scratchpadSize(): number;
-    /**
-     * 获取总观察数
-     * @returns {number}
-     */
+    /** 获取总观察数 */
     get totalObservations(): number;
     /**
      * 获取 scratchpad 中的高重要性发现
-     * @param {number} [minImportance=7]
-     * @returns {Array<{finding: string, evidence: string, importance: number}>}
+     * @returns >}
      */
     getHighPriorityFindings(minImportance?: number): ScratchpadEntry[];
-    /**
-     * 可序列化输出
-     * @returns {object}
-     */
+    /** 可序列化输出 */
     toJSON(): {
         plan?: {
             text: string;
@@ -354,23 +296,17 @@ export declare class ActiveContext {
     };
     /**
      * 从 JSON 恢复 ActiveContext (断点续传)
-     * @param {object} json - toJSON() 的输出
-     * @returns {ActiveContext}
+     * @param json toJSON() 的输出
      */
     static fromJSON(json: ActiveContextJSON): ActiveContext;
-    /**
-     * 清空 ActiveContext — 释放内存
-     */
+    /** 清空 ActiveContext — 释放内存 */
     clear(): void;
     /**
      * 从工具执行结果构建结构化观察元数据
      * 不改变工具结果传给 AI 的内容，只影响推理链记录
      *
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     * @param {boolean} isNew 由 ExplorationTracker.recordToolCall 提供
-     * @returns {{ gotNewInfo: boolean, resultType: string, keyFacts: string[], resultSize: number }}
+     * @param isNew 由 ExplorationTracker.recordToolCall 提供
+     * @returns }
      */
     static buildObservationMeta(toolName: string, args: Record<string, unknown>, result: unknown, isNew: boolean): {
         gotNewInfo: boolean;
@@ -380,4 +316,3 @@ export declare class ActiveContext {
     };
 }
 export default ActiveContext;
-//# sourceMappingURL=ActiveContext.d.ts.map