autosnippet 3.2.16 → 3.2.17

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

@@ -62,23 +62,6 @@ interface LoopContextConfig {
     contextWindow?: ContextWindow | null;
     toolChoiceOverride?: string | null;
 }
-/**
- * @typedef {Object} LoopContextConfig
- * @property {import('./MessageAdapter.js').MessageAdapter} messages 统一消息适配器
- * @property {Object|null} [tracker] - ExplorationTracker 实例
- * @property {Object|null} [trace] - ActiveContext 实例
- * @property {Object|null} [memoryCoordinator] - MemoryCoordinator 实例
- * @property {Object|null} [sharedState] 共享状态 { submittedTitles, submittedPatterns }
- * @property {string} [source] - 'user' | 'system'
- * @property {Object} budget 预算配置
- * @property {import('../capabilities.js').Capability[]} capabilities 本轮使用的 capabilities
- * @property {string} baseSystemPrompt 基础系统提示词
- * @property {Array} toolSchemas 工具 schema 列表
- * @property {string} prompt 原始用户提示
- * @property {Function|null} [onToolCall] 本轮工具调用钩子
- * @property {Object} [context] 额外上下文
- * @property {import('../context/ContextWindow.js').ContextWindow|null} [contextWindow] 原始 ContextWindow (供 forced-summary 等外部逻辑)
- */
 export declare class LoopContext {
     /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
     messages: MessageAdapter;
@@ -111,7 +94,6 @@ export declare class LoopContext {
     source: string;
     /** @type {Object} 预算配置 */
     budget: BudgetConfig;
-    /** @type {import('../capabilities.js').Capability[]} */
     capabilities: Capability[];
     /** @type {string} 基础系统提示词 */
     baseSystemPrompt: string;
@@ -127,9 +109,6 @@ export declare class LoopContext {
     contextWindow: ContextWindow | null;
     /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride: string | null;
-    /**
-     * @param {LoopContextConfig} config
-     */
     constructor(config: LoopContextConfig);
     /** 是否为 system 场景 */
     get isSystem(): boolean;
@@ -137,12 +116,12 @@ export declare class LoopContext {
     get maxIterations(): number;
     /**
      * 累加 token 用量到循环级统计
-     * @param {Object} usage - { inputTokens, outputTokens }
+     * @param usage { inputTokens, outputTokens }
      */
     addTokenUsage(usage: TokenUsage | null | undefined): void;
     /**
      * 构建循环返回值
-     * @returns {{ reply: string, toolCalls: Array, tokenUsage: Object, iterations: number }}
+     * @returns }
      */
     buildResult(): {
         reply: string;
@@ -155,4 +134,3 @@ export declare class LoopContext {
     };
 }
 export {};
-//# sourceMappingURL=LoopContext.d.ts.map

package/dist/lib/{service/agent → agent}/core/LoopContext.js

@@ -11,23 +11,6 @@
  *
  * @module core/LoopContext
  */
-/**
- * @typedef {Object} LoopContextConfig
- * @property {import('./MessageAdapter.js').MessageAdapter} messages 统一消息适配器
- * @property {Object|null} [tracker] - ExplorationTracker 实例
- * @property {Object|null} [trace] - ActiveContext 实例
- * @property {Object|null} [memoryCoordinator] - MemoryCoordinator 实例
- * @property {Object|null} [sharedState] 共享状态 { submittedTitles, submittedPatterns }
- * @property {string} [source] - 'user' | 'system'
- * @property {Object} budget 预算配置
- * @property {import('../capabilities.js').Capability[]} capabilities 本轮使用的 capabilities
- * @property {string} baseSystemPrompt 基础系统提示词
- * @property {Array} toolSchemas 工具 schema 列表
- * @property {string} prompt 原始用户提示
- * @property {Function|null} [onToolCall] 本轮工具调用钩子
- * @property {Object} [context] 额外上下文
- * @property {import('../context/ContextWindow.js').ContextWindow|null} [contextWindow] 原始 ContextWindow (供 forced-summary 等外部逻辑)
- */
 export class LoopContext {
     // ─── 注入依赖 ───
     /** @type {import('./MessageAdapter.js').MessageAdapter} 统一消息适配器 */
@@ -62,7 +45,6 @@ export class LoopContext {
     source;
     /** @type {Object} 预算配置 */
     budget;
-    /** @type {import('../capabilities.js').Capability[]} */
     capabilities;
     /** @type {string} 基础系统提示词 */
     baseSystemPrompt;
@@ -78,9 +60,6 @@ export class LoopContext {
     contextWindow;
     /** @type {string|null} 首轮 toolChoice 覆盖 ('required'/'auto'/'none') */
     toolChoiceOverride;
-    /**
-     * @param {LoopContextConfig} config
-     */
     constructor(config) {
         this.messages = config.messages;
         this.tracker = (config.tracker || null);
@@ -111,7 +90,7 @@ export class LoopContext {
     // ─── Token 累计辅助 ───
     /**
      * 累加 token 用量到循环级统计
-     * @param {Object} usage - { inputTokens, outputTokens }
+     * @param usage { inputTokens, outputTokens }
      */
     addTokenUsage(usage) {
         if (!usage) {
@@ -125,7 +104,7 @@ export class LoopContext {
     // ─── 结果构建 ───
     /**
      * 构建循环返回值
-     * @returns {{ reply: string, toolCalls: Array, tokenUsage: Object, iterations: number }}
+     * @returns }
      */
     buildResult() {
         return {
@@ -136,4 +115,3 @@ export class LoopContext {
         };
     }
 }
-//# sourceMappingURL=LoopContext.js.map

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

@@ -25,50 +25,31 @@ interface ChatMessage {
     toolCallId?: string;
     name?: string;
 }
-/**
- * @abstract
- */
+/** @abstract */
 export declare class MessageAdapter {
-    /**
-     * 追加用户消息
-     * @param {string} _text
-     */
+    /** 追加用户消息 */
     appendUserMessage(_text: string): void;
-    /**
-     * 追加助手纯文本回复
-     * @param {string} _text
-     */
+    /** 追加助手纯文本回复 */
     appendAssistantText(_text: string): void;
     /**
      * 追加助手带工具调用的回复
-     * @param {string|null} _text
-     * @param {Array} _calls - functionCalls 数组
+     * @param _calls functionCalls 数组
      */
     appendAssistantWithToolCalls(_text: string | null, _calls: ToolCallRecord[]): void;
-    /**
-     * 追加工具执行结果
-     * @param {string} _callId
-     * @param {string} _name
-     * @param {string} _content
-     */
+    /** 追加工具执行结果 */
     appendToolResult(_callId: string, _name: string, _content: string): void;
-    /**
-     * 追加系统/用户 nudge 消息
-     * @param {string} _text
-     */
+    /** 追加系统/用户 nudge 消息 */
     appendUserNudge(_text: string): void;
     /**
      * 导出当前消息列表 (供 LLM 调用)
-     * @returns {Array<{role: string, content: string}>}
+     * @returns >}
      */
     toMessages(): unknown[];
-    /**
-     * 重置到仅保留初始 prompt (错误恢复)
-     */
+    /** 重置到仅保留初始 prompt (错误恢复) */
     resetToPromptOnly(): void;
     /**
      * 获取工具结果限额
-     * @returns {{ maxChars: number, maxMatches: number }}
+     * @returns }
      */
     getToolResultQuota(): {
         maxChars: number;
@@ -76,7 +57,7 @@ export declare class MessageAdapter {
     };
     /**
      * 压缩检查 — 如果消息过多则自动压缩
-     * @returns {{ level: number, removed: number }}
+     * @returns }
      */
     compactIfNeeded(): {
         level: number;
@@ -84,9 +65,7 @@ export declare class MessageAdapter {
     };
     /**
      * 格式化工具结果字符串 (统一 limitToolResult 调用)
-     * @param {string} toolName
-     * @param {*} rawResult 工具原始返回值
-     * @returns {string}
+     * @param rawResult 工具原始返回值
      */
     formatToolResult(toolName: string, rawResult: unknown): string;
 }
@@ -98,9 +77,6 @@ export declare class MessageAdapter {
  */
 export declare class ContextWindowAdapter extends MessageAdapter {
     #private;
-    /**
-     * @param {import('../context/ContextWindow.js').ContextWindow} ctxWin
-     */
     constructor(ctxWin: ContextWindow);
     /** 获取底层 ContextWindow 实例 (供 forced-summary 等外部逻辑使用) */
     get contextWindow(): ContextWindow;
@@ -144,11 +120,6 @@ export declare class SimpleArrayAdapter extends MessageAdapter {
         removed: number;
     };
 }
-/**
- * 根据是否提供 contextWindow 创建对应适配器
- * @param {import('../context/ContextWindow.js').ContextWindow|null|undefined} contextWindow
- * @returns {MessageAdapter}
- */
+/** 根据是否提供 contextWindow 创建对应适配器 */
 export declare function createMessageAdapter(contextWindow: ContextWindow | null | undefined): ContextWindowAdapter | SimpleArrayAdapter;
 export {};
-//# sourceMappingURL=MessageAdapter.d.ts.map

package/dist/lib/{service/agent → agent}/core/MessageAdapter.js

@@ -14,80 +14,59 @@ import { limitToolResult } from '../context/ContextWindow.js';
 // ─────────────────────────────────────────────
 //  Base class (接口定义 + JSDoc)
 // ─────────────────────────────────────────────
-/**
- * @abstract
- */
+/** @abstract */
 export class MessageAdapter {
-    /**
-     * 追加用户消息
-     * @param {string} _text
-     */
+    /** 追加用户消息 */
     appendUserMessage(_text) {
         throw new Error('not implemented');
     }
-    /**
-     * 追加助手纯文本回复
-     * @param {string} _text
-     */
+    /** 追加助手纯文本回复 */
     appendAssistantText(_text) {
         throw new Error('not implemented');
     }
     /**
      * 追加助手带工具调用的回复
-     * @param {string|null} _text
-     * @param {Array} _calls - functionCalls 数组
+     * @param _calls functionCalls 数组
      */
     appendAssistantWithToolCalls(_text, _calls) {
         throw new Error('not implemented');
     }
-    /**
-     * 追加工具执行结果
-     * @param {string} _callId
-     * @param {string} _name
-     * @param {string} _content
-     */
+    /** 追加工具执行结果 */
     appendToolResult(_callId, _name, _content) {
         throw new Error('not implemented');
     }
-    /**
-     * 追加系统/用户 nudge 消息
-     * @param {string} _text
-     */
+    /** 追加系统/用户 nudge 消息 */
     appendUserNudge(_text) {
         throw new Error('not implemented');
     }
     /**
      * 导出当前消息列表 (供 LLM 调用)
-     * @returns {Array<{role: string, content: string}>}
+     * @returns >}
      */
     toMessages() {
         throw new Error('not implemented');
     }
-    /**
-     * 重置到仅保留初始 prompt (错误恢复)
-     */
+    /** 重置到仅保留初始 prompt (错误恢复) */
     resetToPromptOnly() {
         throw new Error('not implemented');
     }
     /**
      * 获取工具结果限额
-     * @returns {{ maxChars: number, maxMatches: number }}
+     * @returns }
      */
     getToolResultQuota() {
         throw new Error('not implemented');
     }
     /**
      * 压缩检查 — 如果消息过多则自动压缩
-     * @returns {{ level: number, removed: number }}
+     * @returns }
      */
     compactIfNeeded() {
         throw new Error('not implemented');
     }
     /**
      * 格式化工具结果字符串 (统一 limitToolResult 调用)
-     * @param {string} toolName
-     * @param {*} rawResult 工具原始返回值
-     * @returns {string}
+     * @param rawResult 工具原始返回值
      */
     formatToolResult(toolName, rawResult) {
         const quota = this.getToolResultQuota();
@@ -104,11 +83,7 @@ export class MessageAdapter {
  * ContextWindow 提供三级递进压缩 + 动态 token 预算。
  */
 export class ContextWindowAdapter extends MessageAdapter {
-    /** @type {import('../context/ContextWindow.js').ContextWindow} */
     #ctxWin;
-    /**
-     * @param {import('../context/ContextWindow.js').ContextWindow} ctxWin
-     */
     constructor(ctxWin) {
         super();
         this.#ctxWin = ctxWin;
@@ -155,7 +130,6 @@ export class ContextWindowAdapter extends MessageAdapter {
  * compactIfNeeded 始终返回 no-op。
  */
 export class SimpleArrayAdapter extends MessageAdapter {
-    /** @type {Array<ChatMessage>} */
     #messages = [];
     appendUserMessage(text) {
         this.#messages.push({ role: 'user', content: text });
@@ -192,15 +166,10 @@ export class SimpleArrayAdapter extends MessageAdapter {
 // ─────────────────────────────────────────────
 //  Factory helper
 // ─────────────────────────────────────────────
-/**
- * 根据是否提供 contextWindow 创建对应适配器
- * @param {import('../context/ContextWindow.js').ContextWindow|null|undefined} contextWindow
- * @returns {MessageAdapter}
- */
+/** 根据是否提供 contextWindow 创建对应适配器 */
 export function createMessageAdapter(contextWindow) {
     if (contextWindow) {
         return new ContextWindowAdapter(contextWindow);
     }
     return new SimpleArrayAdapter();
 }
-//# sourceMappingURL=MessageAdapter.js.map

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

@@ -47,25 +47,14 @@ interface BudgetOptions {
 }
 export declare class SystemPromptBuilder {
     #private;
-    /**
-     * @param {object} [opts]
-     * @param {object}   [opts.persona]
-     * @param {Array}    [opts.fileCache]
-     * @param {string}   [opts.lang]
-     * @param {object}   [opts.memoryConfig]
-     */
     constructor({ persona, fileCache, lang, memoryConfig }?: SystemPromptBuilderOptions);
-    /**
-     * 更新文件缓存引用 (bootstrap 场景: allFiles 注入后更新)
-     * @param {Array|null} files
-     */
+    /** 更新文件缓存引用 (bootstrap 场景: allFiles 注入后更新) */
     setFileCache(files: FileCacheEntry[] | null): void;
     /**
      * 构建基础系统提示词
      *
-     * @param {import('../capabilities.js').Capability[]} caps 已解析的 Capability 列表
-     * @param {object} context 额外上下文
-     * @returns {string}
+     * @param caps 已解析的 Capability 列表
+     * @param context 额外上下文
      */
     build(caps: Capability[], context?: Record<string, unknown>): string;
     /**
@@ -73,14 +62,12 @@ export declare class SystemPromptBuilder {
      *
      * 先验锚定阶段节奏: 60% 探索 → 80% 验证 → 最后 20% 输出总结
      *
-     * @param {string} prompt 基础系统提示词
-     * @param {object} opts
-     * @param {string}  opts.source 消息源 (仅 'system' 时注入)
-     * @param {object}  opts.tracker - ExplorationTracker (非 null 时注入)
-     * @param {object}  opts.budget 预算配置
-     * @returns {string} 可能追加了轮次预算段的提示词
+     * @param prompt 基础系统提示词
+     * @param opts.source 消息源 (仅 'system' 时注入)
+     * @param opts.tracker ExplorationTracker (非 null 时注入)
+     * @param opts.budget 预算配置
+     * @returns 可能追加了轮次预算段的提示词
      */
     static injectBudget(prompt: string, { source, tracker, budget }: BudgetOptions): string;
 }
 export {};
-//# sourceMappingURL=SystemPromptBuilder.d.ts.map

package/dist/lib/{service/agent → agent}/core/SystemPromptBuilder.js

@@ -20,32 +20,21 @@ export class SystemPromptBuilder {
     #lang;
     /** @type {MemoryConfig|null} 记忆配置 */
     #memoryConfig;
-    /**
-     * @param {object} [opts]
-     * @param {object}   [opts.persona]
-     * @param {Array}    [opts.fileCache]
-     * @param {string}   [opts.lang]
-     * @param {object}   [opts.memoryConfig]
-     */
     constructor({ persona, fileCache, lang, memoryConfig } = {}) {
         this.#persona = persona || null;
         this.#fileCache = fileCache || null;
         this.#lang = lang || null;
         this.#memoryConfig = memoryConfig || null;
     }
-    /**
-     * 更新文件缓存引用 (bootstrap 场景: allFiles 注入后更新)
-     * @param {Array|null} files
-     */
+    /** 更新文件缓存引用 (bootstrap 场景: allFiles 注入后更新) */
     setFileCache(files) {
         this.#fileCache = files;
     }
     /**
      * 构建基础系统提示词
      *
-     * @param {import('../capabilities.js').Capability[]} caps 已解析的 Capability 列表
-     * @param {object} context 额外上下文
-     * @returns {string}
+     * @param caps 已解析的 Capability 列表
+     * @param context 额外上下文
      */
     build(caps, context = {}) {
         const parts = [];
@@ -90,12 +79,11 @@ export class SystemPromptBuilder {
      *
      * 先验锚定阶段节奏: 60% 探索 → 80% 验证 → 最后 20% 输出总结
      *
-     * @param {string} prompt 基础系统提示词
-     * @param {object} opts
-     * @param {string}  opts.source 消息源 (仅 'system' 时注入)
-     * @param {object}  opts.tracker - ExplorationTracker (非 null 时注入)
-     * @param {object}  opts.budget 预算配置
-     * @returns {string} 可能追加了轮次预算段的提示词
+     * @param prompt 基础系统提示词
+     * @param opts.source 消息源 (仅 'system' 时注入)
+     * @param opts.tracker ExplorationTracker (非 null 时注入)
+     * @param opts.budget 预算配置
+     * @returns 可能追加了轮次预算段的提示词
      */
     static injectBudget(prompt, { source, tracker, budget }) {
         if (source !== 'system' || !tracker || prompt.includes('轮次预算')) {
@@ -112,4 +100,3 @@ export class SystemPromptBuilder {
             `到达第 ${verifyEnd} 轮时你必须开始输出总结，不要继续搜索。`);
     }
 }
-//# sourceMappingURL=SystemPromptBuilder.js.map

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

@@ -52,11 +52,7 @@ interface ToolMiddleware {
 }
 export declare class ToolExecutionPipeline {
     #private;
-    /**
-     * 注册中间件
-     * @param {ToolMiddleware} middleware
-     * @returns {this}
-     */
+    /** 注册中间件 */
     use(middleware: ToolMiddleware): this;
     /**
      * 执行单个工具调用
@@ -66,9 +62,9 @@ export declare class ToolExecutionPipeline {
      *   2. 实际执行工具 (toolRegistry.execute)
      *   3. 依次调用 after 钩子
      *
-     * @param {ToolCall} call - { name, args, id }
-     * @param {ToolExecContext} context - { runtime, loopCtx, iteration }
-     * @returns {Promise<{ result: *, metadata: ToolMetadata }>}
+     * @param call { name, args, id }
+     * @param context { runtime, loopCtx, iteration }
+     * @returns >}
      */
     execute(call: ToolCall, context: ToolExecContext): Promise<{
         result: unknown;
@@ -178,9 +174,6 @@ export declare const eventBusPublisher: {
  * NOTE: eventBusPublisher 和 progressEmitter 不在默认管道中，
  * 由 #processToolCalls 直接处理，以保持与原始 reactLoop 完全一致的事件顺序
  * (progress_end 需要 resultStr.length，在管道外计算)。
- *
- * @returns {ToolExecutionPipeline}
  */
 export declare function createToolPipeline(): ToolExecutionPipeline;
 export {};
-//# sourceMappingURL=ToolExecutionPipeline.d.ts.map

package/dist/lib/{service/agent → agent}/core/ToolExecutionPipeline.js

@@ -18,13 +18,8 @@
  */
 import { SafetyPolicy } from '../policies.js';
 export class ToolExecutionPipeline {
-    /** @type {ToolMiddleware[]} */
     #middlewares = [];
-    /**
-     * 注册中间件
-     * @param {ToolMiddleware} middleware
-     * @returns {this}
-     */
+    /** 注册中间件 */
     use(middleware) {
         this.#middlewares.push(middleware);
         return this;
@@ -37,9 +32,9 @@ export class ToolExecutionPipeline {
      *   2. 实际执行工具 (toolRegistry.execute)
      *   3. 依次调用 after 钩子
      *
-     * @param {ToolCall} call - { name, args, id }
-     * @param {ToolExecContext} context - { runtime, loopCtx, iteration }
-     * @returns {Promise<{ result: *, metadata: ToolMetadata }>}
+     * @param call { name, args, id }
+     * @param context { runtime, loopCtx, iteration }
+     * @returns >}
      */
     async execute(call, context) {
         let toolResult = null;
@@ -318,8 +313,6 @@ export const eventBusPublisher = {
  * NOTE: eventBusPublisher 和 progressEmitter 不在默认管道中，
  * 由 #processToolCalls 直接处理，以保持与原始 reactLoop 完全一致的事件顺序
  * (progress_end 需要 resultStr.length，在管道外计算)。
- *
- * @returns {ToolExecutionPipeline}
  */
 export function createToolPipeline() {
     return new ToolExecutionPipeline()
@@ -331,4 +324,3 @@ export function createToolPipeline() {
         .use(traceRecord)
         .use(submitDedup);
 }
-//# sourceMappingURL=ToolExecutionPipeline.js.map

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

@@ -66,9 +66,7 @@ export declare function taskCheckAndSubmit(context: TaskContext, { candidate, pr
 export declare function taskDiscoverAllRelations(context: TaskContext, { batchSize }?: {
     batchSize?: number | undefined;
 }): Promise<unknown>;
-/**
- * 任务: 批量 AI 补全候选语义字段
- */
+/** 任务: 批量 AI 补全候选语义字段 */
 export declare function taskFullEnrich(context: TaskContext, { status, maxCount }?: {
     status?: string | undefined;
     maxCount?: number | undefined;
@@ -131,4 +129,3 @@ export declare function taskGuardFullScan(context: TaskContext, { code, language
     error?: undefined;
 }>;
 export {};
-//# sourceMappingURL=ChatAgentTasks.d.ts.map

package/dist/lib/{service/agent → agent}/domain/ChatAgentTasks.js

@@ -63,9 +63,7 @@ export async function taskDiscoverAllRelations(context, { batchSize = 20 } = {})
     const agentFactory = container.get('agentFactory');
     return agentFactory.discoverRelations({ batchSize });
 }
-/**
- * 任务: 批量 AI 补全候选语义字段
- */
+/** 任务: 批量 AI 补全候选语义字段 */
 export async function taskFullEnrich(context, { status = 'pending', maxCount = 50 } = {}) {
     const { invokeAgent, container } = context;
     const knowledgeService = container.get('knowledgeService');
@@ -179,4 +177,3 @@ ${code.substring(0, 3000)}
         suggestions,
     };
 }
-//# sourceMappingURL=ChatAgentTasks.js.map

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

@@ -72,22 +72,15 @@ interface SessionStoreLike {
 }
 export declare class EpisodicConsolidator {
     #private;
-    /**
-     * @param {import('../memory/PersistentMemory.js').PersistentMemory} semanticMemory
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(semanticMemory: PersistentMemoryLike, { logger }?: {
         logger?: ConsolidatorLogger;
     });
     /**
      * 执行固化: SessionStore → PersistentMemory
      *
-     * @param {import('../memory/SessionStore.js').SessionStore} sessionStore
-     * @param {object} [opts]
-     * @param {string} [opts.bootstrapSession] - Bootstrap session ID
-     * @param {boolean} [opts.clearPrevious=false] 是否先清除旧的 bootstrap 记忆
-     * @returns {{ findings: object, insights: object, textFacts: object, total: object }}
+     * @param [opts.bootstrapSession] Bootstrap session ID
+     * @param [opts.clearPrevious=false] 是否先清除旧的 bootstrap 记忆
+     * @returns }
      */
     consolidate(sessionStore: SessionStoreLike, { bootstrapSession, clearPrevious, }?: {
         bootstrapSession?: string;
@@ -107,4 +100,3 @@ export declare class EpisodicConsolidator {
     };
 }
 export default EpisodicConsolidator;
-//# sourceMappingURL=EpisodicConsolidator.d.ts.map

package/dist/lib/{service/agent → agent}/domain/EpisodicConsolidator.js

@@ -51,15 +51,8 @@ const INSIGHT_PATTERNS = [
 // EpisodicConsolidator 类
 // ──────────────────────────────────────────────────────────────
 export class EpisodicConsolidator {
-    /** @type {import('../memory/PersistentMemory.js').PersistentMemory} */
     #semanticMemory;
-    /** @type {import('winston').Logger} */
     #logger;
-    /**
-     * @param {import('../memory/PersistentMemory.js').PersistentMemory} semanticMemory
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(semanticMemory, { logger } = {}) {
         this.#semanticMemory = semanticMemory;
         this.#logger = logger || Logger.getInstance();
@@ -67,11 +60,9 @@ export class EpisodicConsolidator {
     /**
      * 执行固化: SessionStore → PersistentMemory
      *
-     * @param {import('../memory/SessionStore.js').SessionStore} sessionStore
-     * @param {object} [opts]
-     * @param {string} [opts.bootstrapSession] - Bootstrap session ID
-     * @param {boolean} [opts.clearPrevious=false] 是否先清除旧的 bootstrap 记忆
-     * @returns {{ findings: object, insights: object, textFacts: object, total: object }}
+     * @param [opts.bootstrapSession] Bootstrap session ID
+     * @param [opts.clearPrevious=false] 是否先清除旧的 bootstrap 记忆
+     * @returns }
      */
     consolidate(sessionStore, { bootstrapSession, clearPrevious = false, } = {}) {
         const t0 = Date.now();
@@ -289,10 +280,6 @@ export class EpisodicConsolidator {
      *   - 大驼峰式: BDNetworkManager, UIViewController
      *   - 文件路径: Classes/Network/BDRequest.m
      *   - 冒号分隔的 evidence: "BDRequest.m:42"
-     *
-     * @param {string} text
-     * @param {string} [evidence]
-     * @returns {string[]}
      */
     #extractEntities(text, evidence = undefined) {
         const entities = new Set();
@@ -314,4 +301,3 @@ export class EpisodicConsolidator {
     }
 }
 export default EpisodicConsolidator;
-//# sourceMappingURL=EpisodicConsolidator.js.map