autosnippet 3.2.16 → 3.2.18

package/dist/lib/domain/task/TaskDependency.js

@@ -23,21 +23,12 @@ export const DepType = Object.freeze({
 const ALL_DEP_TYPES = Object.values(DepType);
 /** 影响就绪计算的依赖类型集合 */
 const BLOCKING_TYPES = new Set([DepType.BLOCKS, DepType.WAITS_FOR]);
-/**
- * 判断依赖类型是否影响就绪计算
- * @param {string} depType
- * @returns {boolean}
- */
+/** 判断依赖类型是否影响就绪计算 */
 export function affectsReadyWork(depType) {
     return BLOCKING_TYPES.has(depType);
 }
-/**
- * 判断依赖类型是否合法
- * @param {string} depType
- * @returns {boolean}
- */
+/** 判断依赖类型是否合法 */
 export function isValidDepType(depType) {
     return ALL_DEP_TYPES.includes(depType);
 }
 export default DepType;
-//# sourceMappingURL=TaskDependency.js.map

package/dist/lib/domain/task/TaskIdGenerator.d.ts

@@ -19,13 +19,11 @@ export declare class TaskIdGenerator {
     #private;
     _db: DbHandle;
     _prefix: string;
-    /**
-     * @param {import('better-sqlite3').Database} db - raw SQLite handle
-     */
+    /** @param db raw SQLite handle */
     constructor(db: DbHandle, drizzle?: DrizzleDB);
     /**
      * 生成新的短 Hash ID
-     * @returns {string} 如 'asd-a1b2'
+     * @returns 如 'asd-a1b2'
      */
     generate(): string;
     /**
@@ -40,4 +38,3 @@ export declare class TaskIdGenerator {
     _exists(id: string): boolean;
 }
 export default TaskIdGenerator;
-//# sourceMappingURL=TaskIdGenerator.d.ts.map

package/dist/lib/domain/task/TaskIdGenerator.js

@@ -7,9 +7,7 @@ export class TaskIdGenerator {
     _db;
     _prefix;
     #drizzle;
-    /**
-     * @param {import('better-sqlite3').Database} db - raw SQLite handle
-     */
+    /** @param db raw SQLite handle */
     constructor(db, drizzle) {
         this._db = db;
         this._prefix = 'asd';
@@ -17,7 +15,7 @@ export class TaskIdGenerator {
     }
     /**
      * 生成新的短 Hash ID
-     * @returns {string} 如 'asd-a1b2'
+     * @returns 如 'asd-a1b2'
      */
     generate() {
         const taskCount = this._getTaskCount();
@@ -75,4 +73,3 @@ export class TaskIdGenerator {
     }
 }
 export default TaskIdGenerator;
-//# sourceMappingURL=TaskIdGenerator.js.map

package/dist/lib/domain/task/index.d.ts

@@ -1,7 +1,4 @@
-/**
- * Task Domain — 统一导出
- */
+/** Task Domain — 统一导出 */
 export { Task } from './Task.js';
 export { affectsReadyWork, DepType, isValidDepType } from './TaskDependency.js';
 export { TaskIdGenerator } from './TaskIdGenerator.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/domain/task/index.js

@@ -1,7 +1,4 @@
-/**
- * Task Domain — 统一导出
- */
+/** Task Domain — 统一导出 */
 export { Task } from './Task.js';
 export { affectsReadyWork, DepType, isValidDepType } from './TaskDependency.js';
 export { TaskIdGenerator } from './TaskIdGenerator.js';
-//# sourceMappingURL=index.js.map

package/dist/lib/external/ai/AiFactory.d.ts

@@ -10,8 +10,7 @@ import { MockProvider } from './providers/MockProvider.js';
 import { OpenAiProvider } from './providers/OpenAiProvider.js';
 /**
  * 创建 AI Provider 实例
- * @param {object} options - {provider, model, apiKey, baseUrl}
- * @returns {AiProvider}
+ * @param options {provider, model, apiKey, baseUrl}
  */
 export declare function createProvider(options?: Record<string, unknown>): ClaudeProvider | GoogleGeminiProvider | MockProvider | OpenAiProvider;
 /**
@@ -19,25 +18,16 @@ export declare function createProvider(options?: Record<string, unknown>): Claud
  * 优先级: ASD_AI_PROVIDER 指定 > 有 key 的第一个
  */
 export declare function autoDetectProvider(): ClaudeProvider | GoogleGeminiProvider | MockProvider | OpenAiProvider;
-/**
- * 获取可用的 fallback provider 列表（排除当前 provider）
- * @param {string} currentProvider
- * @returns {string[]}
- */
+/** 获取可用的 fallback provider 列表（排除当前 provider） */
 export declare function getAvailableFallbacks(currentProvider: string): string[];
-/**
- * 判断是否为地理限制 / 不可恢复的 provider 级错误（应触发 fallback）
- */
+/** 判断是否为地理限制 / 不可恢复的 provider 级错误（应触发 fallback） */
 export declare function isGeoOrProviderError(err: unknown): boolean;
 /**
  * 获取 AI Provider，带自动 fallback：
  * 当主 provider 调用失败（地理限制等）时自动切换到备选 provider
- * @returns {Promise<AiProvider>}
  */
 export declare function getProviderWithFallback(): Promise<ClaudeProvider | GoogleGeminiProvider | MockProvider | OpenAiProvider | null>;
-/**
- * 获取当前 AI 配置信息（同步，用于 UI 展示）
- */
+/** 获取当前 AI 配置信息（同步，用于 UI 展示） */
 export declare function getAiConfigInfo(): {
     provider: string;
     model: string;
@@ -63,4 +53,3 @@ declare const _default: {
     isGeoOrProviderError: typeof isGeoOrProviderError;
 };
 export default _default;
-//# sourceMappingURL=AiFactory.d.ts.map

package/dist/lib/external/ai/AiFactory.js

@@ -23,8 +23,7 @@ const PROVIDER_MAP = {
 const DEEPSEEK_BASE = 'https://api.deepseek.com/v1';
 /**
  * 创建 AI Provider 实例
- * @param {object} options - {provider, model, apiKey, baseUrl}
- * @returns {AiProvider}
+ * @param options {provider, model, apiKey, baseUrl}
  */
 export function createProvider(options = {}) {
     const provider = options.provider || process.env.ASD_AI_PROVIDER || 'google';
@@ -109,11 +108,7 @@ const PROVIDER_KEY_MAP = {
     deepseek: 'ASD_DEEPSEEK_API_KEY',
     claude: 'ASD_CLAUDE_API_KEY',
 };
-/**
- * 获取可用的 fallback provider 列表（排除当前 provider）
- * @param {string} currentProvider
- * @returns {string[]}
- */
+/** 获取可用的 fallback provider 列表（排除当前 provider） */
 export function getAvailableFallbacks(currentProvider) {
     const fallbacks = [];
     for (const [name, envKey] of Object.entries(PROVIDER_KEY_MAP)) {
@@ -127,9 +122,7 @@ export function getAvailableFallbacks(currentProvider) {
     }
     return fallbacks;
 }
-/**
- * 判断是否为地理限制 / 不可恢复的 provider 级错误（应触发 fallback）
- */
+/** 判断是否为地理限制 / 不可恢复的 provider 级错误（应触发 fallback） */
 export function isGeoOrProviderError(err) {
     const msg = (err.message || '').toLowerCase();
     return (/user location is not supported|failed_precondition|unsupported.*(region|country|location)|geo|blocked/i.test(msg) ||
@@ -138,7 +131,6 @@ export function isGeoOrProviderError(err) {
 /**
  * 获取 AI Provider，带自动 fallback：
  * 当主 provider 调用失败（地理限制等）时自动切换到备选 provider
- * @returns {Promise<AiProvider>}
  */
 export async function getProviderWithFallback() {
     const logger = Logger.getInstance();
@@ -180,9 +172,7 @@ export async function getProviderWithFallback() {
     }
     return primary;
 }
-/**
- * 获取当前 AI 配置信息（同步，用于 UI 展示）
- */
+/** 获取当前 AI 配置信息（同步，用于 UI 展示） */
 export function getAiConfigInfo() {
     const provider = process.env.ASD_AI_PROVIDER || 'auto';
     const model = process.env.ASD_AI_MODEL || '';
@@ -216,4 +206,3 @@ export default {
     getAvailableFallbacks,
     isGeoOrProviderError,
 };
-//# sourceMappingURL=AiFactory.js.map

package/dist/lib/external/ai/AiProvider.d.ts

@@ -155,38 +155,23 @@ export declare class AiProvider {
     _setRateLimitWindow(waitMs: number): void;
     /**
      * 对话 - 发送 prompt + context，返回文本响应
-     * @param {string} prompt
-     * @param {object} context - {history: [], temperature, maxTokens}
-     * @returns {Promise<string>}
+     * @param context {history: [], temperature, maxTokens}
      */
     chat(prompt: string, context?: ChatContext): Promise<string>;
-    /**
-     * 摘要 - 对代码/文档生成结构化摘要
-     * @param {string} code
-     * @returns {Promise<object>}
-     */
+    /** 摘要 - 对代码/文档生成结构化摘要 */
     summarize(code: string): Promise<unknown>;
-    /**
-     * 向量嵌入 - 返回浮点数组
-     * @param {string|string[]} text
-     * @returns {Promise<number[]|number[][]>}
-     */
+    /** 向量嵌入 - 返回浮点数组 */
     embed(text: string | string[]): Promise<number[] | number[][]>;
     /**
      * 探测 provider 是否可用（轻量级 API 调用验证连接性）
      * 子类可覆盖实现更具体的探测逻辑
-     * @returns {Promise<boolean>}
      */
     probe(): Promise<boolean>;
-    /**
-     * 检查是否支持 embedding
-     * @returns {boolean}
-     */
+    /** 检查是否支持 embedding */
     supportsEmbedding(): boolean;
     /**
      * 是否支持原生结构化函数调用（非文本解析）
      * 子类（如 GoogleGeminiProvider）覆盖返回 true
-     * @returns {boolean}
      */
     get supportsNativeToolCalling(): boolean;
     /**
@@ -202,15 +187,12 @@ export declare class AiProvider {
      *   - { role: 'assistant', content: 'text or null', toolCalls: [{id, name, args}] }
      *   - { role: 'tool', toolCallId: 'id', name: 'tool_name', content: 'result string' }
      *
-     * @param {string} prompt 用户消息（仅在 messages 为空时使用）
-     * @param {object} opts
-     * @param {Array} opts.messages 统一格式消息历史
-     * @param {Array} opts.toolSchemas - [{name, description, parameters}]
-     * @param {string} opts.toolChoice - 'auto' | 'required' | 'none'
-     * @param {string} [opts.systemPrompt] 系统指令
-     * @param {number} [opts.temperature=0.7]
-     * @param {number} [opts.maxTokens=8192]
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id: string, name: string, args: object}>|null}>}
+     * @param prompt 用户消息（仅在 messages 为空时使用）
+     * @param opts.messages 统一格式消息历史
+     * @param opts.toolSchemas [{name, description, parameters}]
+     * @param opts.toolChoice 'auto' | 'required' | 'none'
+     * @param [opts.systemPrompt] 系统指令
+     * @returns >|null}>}
      */
     chatWithTools(prompt: string, opts?: ChatWithToolsOptions): Promise<ChatWithToolsResult>;
     /**
@@ -221,40 +203,31 @@ export declare class AiProvider {
      *   - OpenAI: response_format: { type: 'json_object' }
      *   - Claude: 无原生支持，使用默认实现 (chat + extractJSON)
      *
-     * @param {string} prompt 完整提示词（应包含返回 JSON 的指令）
-     * @param {object} [opts]
-     * @param {object} [opts.schema] - JSON Schema（Gemini/OpenAI 的 structured output 用）
-     * @param {string} [opts.openChar='{'] - extractJSON 边界起始符（fallback 用）
-     * @param {string} [opts.closeChar='}'] - extractJSON 边界终止符
-     * @param {number} [opts.temperature=0.3]
-     * @param {number} [opts.maxTokens=32768]
-     * @param {string} [opts.systemPrompt] 可选系统指令
-     * @returns {Promise<any>} 解析后的 JSON 对象/数组，解析失败返回 null
+     * @param prompt 完整提示词（应包含返回 JSON 的指令）
+     * @param [opts.schema] JSON Schema（Gemini/OpenAI 的 structured output 用）
+     * @param [opts.openChar='{'] extractJSON 边界起始符（fallback 用）
+     * @param [opts.closeChar='}'] extractJSON 边界终止符
+     * @param [opts.systemPrompt] 可选系统指令
+     * @returns 解析后的 JSON 对象/数组，解析失败返回 null
      */
     chatWithStructuredOutput(prompt: string, opts?: StructuredOutputOptions): Promise<unknown>;
-    /**
-     * 内部日志辅助（子类可通过 this.logger 覆盖）
-     */
+    /** 内部日志辅助（子类可通过 this.logger 覆盖） */
     _log(level: string, message: string): void;
     /**
      * 根据用户语言偏好生成输出语言指令
-     * @param {string} [lang] 语言代码，如 'zh', 'en'
-     * @returns {string} 语言指令段落（为空则返回空字符串）
+     * @param [lang] 语言代码，如 'zh', 'en'
+     * @returns 语言指令段落（为空则返回空字符串）
      */
     _buildLangInstruction(lang: string | undefined): string;
-    /**
-     * 根据文件扩展名检测语言特征，返回提示词适配参数
-     */
+    /** 根据文件扩展名检测语言特征，返回提示词适配参数 */
     _detectLanguageProfile(filesContent: FileContentEntry[]): LanguageProfile;
     /**
      * AI 语义字段补全 — 分析候选代码，填补缺失的语义字段
-     * @param {Array<object>} candidates 候选对象数组，每项至少含 {code, language, title?}
-     * @returns {Promise<Array<object>>} enriched 候选数组（仅含补全的字段）
+     * @param candidates 候选对象数组，每项至少含 {code, language, title?}
+     * @returns enriched 候选数组（仅含补全的字段）
      */
     enrichCandidates(candidates: EnrichCandidate[], options?: EnrichOptions): Promise<any[]>;
-    /**
-     * 构建 enrichCandidates 提示词
-     */
+    /** 构建 enrichCandidates 提示词 */
     _buildEnrichPrompt(candidates: EnrichCandidate[], options?: EnrichOptions): string;
     /**
      * 解析当前 Provider 应使用的代理 URL。
@@ -282,18 +255,14 @@ export declare class AiProvider {
      * 策略 2（回退路径）: 正则 + 渐进 JSON.parse 尝试（应对代码段中未转义引号导致 inString 追踪失效）
      */
     _repairTruncatedArray(text: string): any[] | null;
-    /**
-     * 字符级深度追踪修复（原逻辑，处理标准 JSON）
-     */
+    /** 字符级深度追踪修复（原逻辑，处理标准 JSON） */
     _repairByCharTracking(text: string): any[] | null;
     /**
      * 正则回退修复 — 不依赖 inString 追踪
      * 寻找所有 "},\s*{" 或 "}\s*]" 边界，从后往前尝试 JSON.parse
      */
     _repairByRegexFallback(text: string): any[] | null;
-    /**
-     * 在指定位置截断并尝试闭合 JSON 数组
-     */
+    /** 在指定位置截断并尝试闭合 JSON 数组 */
     _tryRepairAt(text: string, endPos: number): any[] | null;
     /**
      * 指数退避重试 + 熔断器（受 Cline 三级错误恢复启发）
@@ -308,4 +277,3 @@ export declare class AiProvider {
     _withRetry<T>(fn: () => Promise<T>, retries?: number, baseDelay?: number): Promise<T>;
 }
 export default AiProvider;
-//# sourceMappingURL=AiProvider.d.ts.map

package/dist/lib/external/ai/AiProvider.js

@@ -74,49 +74,34 @@ export class AiProvider {
     }
     /**
      * 对话 - 发送 prompt + context，返回文本响应
-     * @param {string} prompt
-     * @param {object} context - {history: [], temperature, maxTokens}
-     * @returns {Promise<string>}
+     * @param context {history: [], temperature, maxTokens}
      */
     async chat(prompt, context = {}) {
         throw new Error(`${this.name}.chat() not implemented`);
     }
-    /**
-     * 摘要 - 对代码/文档生成结构化摘要
-     * @param {string} code
-     * @returns {Promise<object>}
-     */
+    /** 摘要 - 对代码/文档生成结构化摘要 */
     async summarize(code) {
         throw new Error(`${this.name}.summarize() not implemented`);
     }
-    /**
-     * 向量嵌入 - 返回浮点数组
-     * @param {string|string[]} text
-     * @returns {Promise<number[]|number[][]>}
-     */
+    /** 向量嵌入 - 返回浮点数组 */
     async embed(text) {
         throw new Error(`${this.name}.embed() not implemented`);
     }
     /**
      * 探测 provider 是否可用（轻量级 API 调用验证连接性）
      * 子类可覆盖实现更具体的探测逻辑
-     * @returns {Promise<boolean>}
      */
     async probe() {
         const result = await this.chat('ping', { maxTokens: 16, temperature: 0 });
         return !!result;
     }
-    /**
-     * 检查是否支持 embedding
-     * @returns {boolean}
-     */
+    /** 检查是否支持 embedding */
     supportsEmbedding() {
         return true;
     }
     /**
      * 是否支持原生结构化函数调用（非文本解析）
      * 子类（如 GoogleGeminiProvider）覆盖返回 true
-     * @returns {boolean}
      */
     get supportsNativeToolCalling() {
         return false;
@@ -134,15 +119,12 @@ export class AiProvider {
      *   - { role: 'assistant', content: 'text or null', toolCalls: [{id, name, args}] }
      *   - { role: 'tool', toolCallId: 'id', name: 'tool_name', content: 'result string' }
      *
-     * @param {string} prompt 用户消息（仅在 messages 为空时使用）
-     * @param {object} opts
-     * @param {Array} opts.messages 统一格式消息历史
-     * @param {Array} opts.toolSchemas - [{name, description, parameters}]
-     * @param {string} opts.toolChoice - 'auto' | 'required' | 'none'
-     * @param {string} [opts.systemPrompt] 系统指令
-     * @param {number} [opts.temperature=0.7]
-     * @param {number} [opts.maxTokens=8192]
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id: string, name: string, args: object}>|null}>}
+     * @param prompt 用户消息（仅在 messages 为空时使用）
+     * @param opts.messages 统一格式消息历史
+     * @param opts.toolSchemas [{name, description, parameters}]
+     * @param opts.toolChoice 'auto' | 'required' | 'none'
+     * @param [opts.systemPrompt] 系统指令
+     * @returns >|null}>}
      */
     async chatWithTools(prompt, opts = {}) {
         // 默认降级: 忽略 tools/toolChoice，走纯文本 chat()
@@ -169,15 +151,12 @@ export class AiProvider {
      *   - OpenAI: response_format: { type: 'json_object' }
      *   - Claude: 无原生支持，使用默认实现 (chat + extractJSON)
      *
-     * @param {string} prompt 完整提示词（应包含返回 JSON 的指令）
-     * @param {object} [opts]
-     * @param {object} [opts.schema] - JSON Schema（Gemini/OpenAI 的 structured output 用）
-     * @param {string} [opts.openChar='{'] - extractJSON 边界起始符（fallback 用）
-     * @param {string} [opts.closeChar='}'] - extractJSON 边界终止符
-     * @param {number} [opts.temperature=0.3]
-     * @param {number} [opts.maxTokens=32768]
-     * @param {string} [opts.systemPrompt] 可选系统指令
-     * @returns {Promise<any>} 解析后的 JSON 对象/数组，解析失败返回 null
+     * @param prompt 完整提示词（应包含返回 JSON 的指令）
+     * @param [opts.schema] JSON Schema（Gemini/OpenAI 的 structured output 用）
+     * @param [opts.openChar='{'] extractJSON 边界起始符（fallback 用）
+     * @param [opts.closeChar='}'] extractJSON 边界终止符
+     * @param [opts.systemPrompt] 可选系统指令
+     * @returns 解析后的 JSON 对象/数组，解析失败返回 null
      */
     async chatWithStructuredOutput(prompt, opts = {}) {
         const response = await this.chat(prompt, {
@@ -192,9 +171,7 @@ export class AiProvider {
         const closeChar = opts.closeChar || '}';
         return this.extractJSON(response, openChar, closeChar);
     }
-    /**
-     * 内部日志辅助（子类可通过 this.logger 覆盖）
-     */
+    /** 内部日志辅助（子类可通过 this.logger 覆盖） */
     _log(level, message) {
         try {
             if (this.logger && typeof this.logger[level] === 'function') {
@@ -209,8 +186,8 @@ export class AiProvider {
     }
     /**
      * 根据用户语言偏好生成输出语言指令
-     * @param {string} [lang] 语言代码，如 'zh', 'en'
-     * @returns {string} 语言指令段落（为空则返回空字符串）
+     * @param [lang] 语言代码，如 'zh', 'en'
+     * @returns 语言指令段落（为空则返回空字符串）
      */
     _buildLangInstruction(lang) {
         if (!lang || lang === 'en') {
@@ -244,9 +221,7 @@ export class AiProvider {
         // 其他语言通用指令
         return `\n# Output Language\nThe user's preferred language is "${lang}". Write all human-readable text fields (title, description, doClause, dontClause, whenClause, topicHint, content.markdown, content.rationale, reasoning.whyStandard, aiInsight, constraints text) in "${lang}". Keep code fields (trigger, content.pattern, coreCode, headers, tags) in their original language.\n`;
     }
-    /**
-     * 根据文件扩展名检测语言特征，返回提示词适配参数
-     */
+    /** 根据文件扩展名检测语言特征，返回提示词适配参数 */
     _detectLanguageProfile(filesContent) {
         const extCounts = {};
         for (const f of filesContent) {
@@ -388,8 +363,8 @@ export class AiProvider {
     }
     /**
      * AI 语义字段补全 — 分析候选代码，填补缺失的语义字段
-     * @param {Array<object>} candidates 候选对象数组，每项至少含 {code, language, title?}
-     * @returns {Promise<Array<object>>} enriched 候选数组（仅含补全的字段）
+     * @param candidates 候选对象数组，每项至少含 {code, language, title?}
+     * @returns enriched 候选数组（仅含补全的字段）
      */
     async enrichCandidates(candidates, options = {}) {
         const prompt = this._buildEnrichPrompt(candidates, options);
@@ -400,9 +375,7 @@ export class AiProvider {
         });
         return Array.isArray(parsed) ? parsed : [];
     }
-    /**
-     * 构建 enrichCandidates 提示词
-     */
+    /** 构建 enrichCandidates 提示词 */
     _buildEnrichPrompt(candidates, options = {}) {
         const items = candidates
             .map((c, i) => {
@@ -570,9 +543,7 @@ ${items}`;
         }
         return null;
     }
-    /**
-     * 字符级深度追踪修复（原逻辑，处理标准 JSON）
-     */
+    /** 字符级深度追踪修复（原逻辑，处理标准 JSON） */
     _repairByCharTracking(text) {
         let depth = 0;
         let inString = false;
@@ -632,9 +603,7 @@ ${items}`;
         }
         return null;
     }
-    /**
-     * 在指定位置截断并尝试闭合 JSON 数组
-     */
+    /** 在指定位置截断并尝试闭合 JSON 数组 */
     _tryRepairAt(text, endPos) {
         let repaired = text.slice(0, endPos + 1);
         // 去掉尾逗号
@@ -753,4 +722,3 @@ ${items}`;
     }
 }
 export default AiProvider;
-//# sourceMappingURL=AiProvider.js.map

package/dist/lib/external/ai/providers/ClaudeProvider.d.ts

@@ -10,9 +10,7 @@ import { AiProvider, type AiProviderConfig, type ApiResponse, type ChatContext,
 export declare class ClaudeProvider extends AiProvider {
     #private;
     constructor(config?: AiProviderConfig);
-    /**
-     * 是否支持原生结构化函数调用
-     */
+    /** 是否支持原生结构化函数调用 */
     get supportsNativeToolCalling(): boolean;
     chat(prompt: string, context?: ChatContext): Promise<any>;
     /**
@@ -26,9 +24,9 @@ export declare class ClaudeProvider extends AiProvider {
      *   - 工具结果通过 user 消息中的 tool_result blocks 传递
      *   - tool_choice: {type: 'auto'|'any'|'tool'}（无 'none'，不传 tools 即可）
      *
-     * @param {string} prompt - fallback prompt
-     * @param {object} opts 统一参数
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt fallback prompt
+     * @param opts 统一参数
+     * @returns >|null}>}
      */
     chatWithTools(prompt: string, opts?: ChatWithToolsOptions): Promise<ChatWithToolsResult>;
     summarize(code: string): Promise<{}>;
@@ -37,4 +35,3 @@ export declare class ClaudeProvider extends AiProvider {
     _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
 }
 export default ClaudeProvider;
-//# sourceMappingURL=ClaudeProvider.d.ts.map

package/dist/lib/external/ai/providers/ClaudeProvider.js

@@ -19,9 +19,7 @@ export class ClaudeProvider extends AiProvider {
         this.maxRetries = 0; // Claude 不做重试
         this.logger = Logger.getInstance();
     }
-    /**
-     * 是否支持原生结构化函数调用
-     */
+    /** 是否支持原生结构化函数调用 */
     get supportsNativeToolCalling() {
         return true;
     }
@@ -53,9 +51,9 @@ export class ClaudeProvider extends AiProvider {
      *   - 工具结果通过 user 消息中的 tool_result blocks 传递
      *   - tool_choice: {type: 'auto'|'any'|'tool'}（无 'none'，不传 tools 即可）
      *
-     * @param {string} prompt - fallback prompt
-     * @param {object} opts 统一参数
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt fallback prompt
+     * @param opts 统一参数
+     * @returns >|null}>}
      */
     async chatWithTools(prompt, opts = {}) {
         const { messages: rawMessages, toolSchemas: rawToolSchemas, toolChoice = 'auto', systemPrompt, temperature = 0.7, maxTokens = 4096, } = opts;
@@ -107,9 +105,7 @@ export class ClaudeProvider extends AiProvider {
      */
     #convertMessages(messages) {
         const result = [];
-        /**
-         * 推入 result，如果上一个 entry 同角色则合并 content
-         */
+        /** 推入 result，如果上一个 entry 同角色则合并 content */
         const pushOrMerge = (entry) => {
             const last = result[result.length - 1];
             if (last && last.role === entry.role) {
@@ -266,4 +262,3 @@ export class ClaudeProvider extends AiProvider {
     }
 }
 export default ClaudeProvider;
-//# sourceMappingURL=ClaudeProvider.js.map

package/dist/lib/external/ai/providers/GoogleGeminiProvider.d.ts

@@ -10,9 +10,7 @@ import { AiProvider, type AiProviderConfig, type ApiResponse, type ChatContext,
 export declare class GoogleGeminiProvider extends AiProvider {
     #private;
     constructor(config?: AiProviderConfig);
-    /**
-     * 是否支持原生结构化函数调用
-     */
+    /** 是否支持原生结构化函数调用 */
     get supportsNativeToolCalling(): boolean;
     chat(prompt: string, context?: ChatContext): Promise<any>;
     /**
@@ -20,15 +18,11 @@ export declare class GoogleGeminiProvider extends AiProvider {
      *
      * 接受统一消息格式，内部转换为 Gemini 原生 contents 格式。
      *
-     * @param {string} prompt 未使用 messages 时的 fallback prompt
-     * @param {object} opts
-     * @param {Array}  opts.messages 统一格式消息
-     * @param {Array}  opts.toolSchemas - [{name, description, parameters}]
-     * @param {string} opts.toolChoice - 'auto' | 'required' | 'none'
-     * @param {string} [opts.systemPrompt]
-     * @param {number} [opts.temperature=0.7]
-     * @param {number} [opts.maxTokens=8192]
-     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     * @param prompt 未使用 messages 时的 fallback prompt
+     * @param opts.messages 统一格式消息
+     * @param opts.toolSchemas [{name, description, parameters}]
+     * @param opts.toolChoice 'auto' | 'required' | 'none'
+     * @returns >|null}>}
      */
     chatWithTools(prompt: string, opts?: ChatWithToolsOptions): Promise<ChatWithToolsResult>;
     summarize(code: string): Promise<any>;
@@ -43,4 +37,3 @@ export declare class GoogleGeminiProvider extends AiProvider {
     _post(url: string, body: Record<string, unknown>): Promise<ApiResponse>;
 }
 export default GoogleGeminiProvider;
-//# sourceMappingURL=GoogleGeminiProvider.d.ts.map