autosnippet 3.2.9 → 3.2.11

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

@@ -0,0 +1,271 @@
+/**
+ * OpenAiProvider - OpenAI / DeepSeek / Ollama 兼容提供商
+ * 使用标准 OpenAI Chat Completions API
+ *
+ * v2: 支持原生 Function Calling（结构化工具调用）
+ *     - 使用 Chat Completions API 的 tools + tool_choice 参数
+ *     - 兼容 DeepSeek / Ollama 等 OpenAI-compatible API
+ */
+import Logger from '#infra/logging/Logger.js';
+import { AiProvider, } from '../AiProvider.js';
+const OPENAI_BASE = 'https://api.openai.com/v1';
+export class OpenAiProvider extends AiProvider {
+    embedModel;
+    constructor(config = {}) {
+        super(config);
+        this.name = config.name || 'openai';
+        this.model = config.model || 'gpt-4o-mini';
+        this.apiKey = config.apiKey || process.env.ASD_OPENAI_API_KEY || '';
+        this.baseUrl = config.baseUrl || OPENAI_BASE;
+        this.embedModel = config.embedModel || 'text-embedding-3-small';
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * 是否支持原生结构化函数调用
+     * OpenAI / DeepSeek Chat Completions API 均支持
+     */
+    get supportsNativeToolCalling() {
+        return true;
+    }
+    async chat(prompt, context = {}) {
+        return this._withRetry(async () => {
+            const { history = [], temperature = 0.7, maxTokens = 4096 } = context;
+            const messages = [];
+            for (const h of history) {
+                messages.push({ role: h.role, content: h.content });
+            }
+            messages.push({ role: 'user', content: prompt });
+            const body = {
+                model: this.model,
+                messages,
+                temperature,
+                max_tokens: maxTokens,
+            };
+            const data = await this._post(`${this.baseUrl}/chat/completions`, body);
+            return data?.choices?.[0]?.message?.content || '';
+        });
+    }
+    /**
+     * 带工具声明的结构化对话 — OpenAI Chat Completions Function Calling
+     *
+     * 接受统一消息格式，内部转换为 OpenAI Chat Completions 消息格式。
+     * 兼容 DeepSeek / Ollama 等 OpenAI-Compatible API。
+     *
+     * @param {string} prompt - fallback prompt
+     * @param {object} opts 统一参数
+     * @returns {Promise<{text: string|null, functionCalls: Array<{id, name, args}>|null}>}
+     */
+    async chatWithTools(prompt, opts = {}) {
+        return this._withRetry(async () => {
+            const { messages: rawMessages, toolSchemas: rawToolSchemas, toolChoice = 'auto', systemPrompt, temperature = 0.7, maxTokens = 4096, } = opts;
+            const unifiedMessages = rawMessages;
+            const toolSchemas = rawToolSchemas;
+            // 统一消息 → OpenAI Chat Completions messages
+            const messages = [];
+            if (systemPrompt) {
+                messages.push({ role: 'system', content: systemPrompt });
+            }
+            const srcMessages = unifiedMessages && unifiedMessages.length > 0
+                ? unifiedMessages
+                : [{ role: 'user', content: prompt }];
+            for (const msg of srcMessages) {
+                if (msg.role === 'user') {
+                    messages.push({ role: 'user', content: msg.content });
+                }
+                else if (msg.role === 'assistant') {
+                    const m = { role: 'assistant', content: msg.content || null };
+                    if (msg.toolCalls && msg.toolCalls.length > 0) {
+                        m.tool_calls = msg.toolCalls.map((tc) => ({
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: JSON.stringify(tc.args || {}),
+                            },
+                        }));
+                    }
+                    messages.push(m);
+                }
+                else if (msg.role === 'tool') {
+                    messages.push({
+                        role: 'tool',
+                        tool_call_id: msg.toolCallId,
+                        content: msg.content || '',
+                    });
+                }
+            }
+            const body = {
+                model: this.model,
+                messages,
+                temperature,
+                max_tokens: maxTokens,
+            };
+            // 标准 tool schemas → OpenAI tools format
+            if (toolSchemas && toolSchemas.length > 0) {
+                body.tools = toolSchemas.map((s) => ({
+                    type: 'function',
+                    function: {
+                        name: s.name,
+                        description: s.description || '',
+                        parameters: s.parameters || { type: 'object', properties: {} },
+                    },
+                }));
+            }
+            // toolChoice → OpenAI tool_choice
+            if (toolChoice === 'required') {
+                body.tool_choice = 'required';
+            }
+            else if (toolChoice === 'none') {
+                body.tool_choice = 'none';
+            }
+            else {
+                body.tool_choice = 'auto';
+            }
+            const data = await this._post(`${this.baseUrl}/chat/completions`, body);
+            return this.#parseToolResponse(data);
+        });
+    }
+    /**
+     * 解析 OpenAI Chat Completions 响应 — 提取 tool_calls 或 text
+     *
+     * OpenAI 返回格式:
+     *   choices[0].message.tool_calls[]: { id, type: 'function', function: { name, arguments(JSON str) } }
+     */
+    #parseToolResponse(data) {
+        const choice = data?.choices?.[0];
+        // 提取 token 用量 (OpenAI usage)
+        const usage = data?.usage
+            ? {
+                inputTokens: data.usage.prompt_tokens || 0,
+                outputTokens: data.usage.completion_tokens || 0,
+                totalTokens: data.usage.total_tokens || 0,
+            }
+            : null;
+        if (!choice) {
+            return { text: '', functionCalls: null, usage };
+        }
+        const message = choice.message;
+        const text = message?.content || null;
+        if (message?.tool_calls?.length > 0) {
+            const functionCalls = message.tool_calls
+                .filter((tc) => tc.type === 'function')
+                .map((tc) => ({
+                id: tc.id,
+                name: tc.function.name,
+                args: (() => {
+                    try {
+                        return JSON.parse(tc.function.arguments || '{}');
+                    }
+                    catch {
+                        return {};
+                    }
+                })(),
+            }));
+            if (functionCalls.length > 0) {
+                this.logger?.debug(`[OpenAI] native function calls: ${functionCalls.map((fc) => fc.name).join(', ')}`);
+                return { text, functionCalls, usage };
+            }
+        }
+        return { text, functionCalls: null, usage };
+    }
+    async summarize(code) {
+        const prompt = `请对以下代码生成结构化摘要，返回 JSON 格式 {title, description, language, patterns: [], keyAPIs: []}:\n\n${code}`;
+        return ((await this.chatWithStructuredOutput(prompt, {
+            temperature: 0.3,
+            maxTokens: 4096,
+        })) || { title: '', description: '' });
+    }
+    /**
+     * Structured Output — OpenAI JSON mode
+     *
+     * 使用 response_format: { type: 'json_object' } 强制返回合法 JSON。
+     * 兼容 DeepSeek / Ollama 等 OpenAI-Compatible API。
+     */
+    async chatWithStructuredOutput(prompt, opts = {}) {
+        return this._withRetry(async () => {
+            const { temperature = 0.3, maxTokens = 32768, systemPrompt } = opts;
+            const messages = [];
+            if (systemPrompt) {
+                messages.push({ role: 'system', content: systemPrompt });
+            }
+            messages.push({ role: 'user', content: prompt });
+            const body = {
+                model: this.model,
+                messages,
+                temperature,
+                max_tokens: maxTokens,
+                response_format: { type: 'json_object' },
+            };
+            const data = await this._post(`${this.baseUrl}/chat/completions`, body);
+            const text = data?.choices?.[0]?.message?.content || '';
+            if (!text) {
+                return null;
+            }
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                // JSON mode 极少出错，降级到 extractJSON
+                const openChar = opts.openChar || '{';
+                const closeChar = opts.closeChar || '}';
+                return this.extractJSON(text, openChar, closeChar);
+            }
+        });
+    }
+    async embed(text) {
+        const texts = Array.isArray(text) ? text : [text];
+        try {
+            const body = {
+                model: this.embedModel,
+                input: texts.map((t) => t.slice(0, 8000)),
+            };
+            const data = await this._post(`${this.baseUrl}/embeddings`, body);
+            const embeddings = (data?.data || [])
+                .sort((a, b) => a.index - b.index)
+                .map((d) => d.embedding);
+            if (embeddings.length === 0) {
+                return Array.isArray(text) ? [] : [];
+            }
+            return Array.isArray(text) ? embeddings : embeddings[0];
+        }
+        catch (err) {
+            this.logger?.warn(`${this.name} embed failed, returning empty`, {
+                error: err.message,
+            });
+            return Array.isArray(text) ? texts.map(() => []) : [];
+        }
+    }
+    async _post(url, body) {
+        // Ollama 使用固定 dummy key，不需要校验
+        if (!this.apiKey && this.name !== 'ollama') {
+            const envKey = this.name === 'deepseek' ? 'ASD_DEEPSEEK_API_KEY' : 'ASD_OPENAI_API_KEY';
+            const err = new Error(`${this.name} API Key 未配置。请在 .env 中设置 ${envKey}，或运行 asd setup 完成配置。`);
+            err.code = 'API_KEY_MISSING';
+            throw err;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const res = await this._fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const err = new Error(`${this.name} API error: ${res.status}`);
+                err.status = res.status;
+                throw err;
+            }
+            return await res.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+export default OpenAiProvider;
+//# sourceMappingURL=OpenAiProvider.js.map

package/dist/lib/external/ai/providers/OpenAiProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAiProvider.js","sourceRoot":"","sources":["../../../../../lib/external/ai/providers/OpenAiProvider.ts"],"names":[],"mappings":"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"}

package/dist/lib/external/mcp/McpServer.d.ts

@@ -0,0 +1,127 @@
+/**
+ * AutoSnippet V3 MCP Server — 整合版
+ *
+ * Model Context Protocol (stdio transport)
+ * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
+ *
+ * V3.1 整合：39 → 22 工具（18 agent + 4 admin）
+ * 通过 ASD_MCP_TIER 环境变量控制可见工具集（agent/admin）
+ *
+ * 冷启动双路径:
+ *   - 外部 Agent 路径: bootstrap (Mission Briefing) → dimension_complete × N → wiki_plan → wiki_finalize
+ *   - 内部 Agent 路径: bootstrap.js bootstrapKnowledge() → orchestrator.js AI pipeline (Phase 5)
+ *
+ * Gateway 权限 gating: 写操作经过 Gateway 权限/宪法/审计检查（支持动态 resolver）
+ *
+ * 本文件仅包含服务编排层（初始化、路由、Gateway gating、生命周期）。
+ * 工具定义 → tools.js
+ * Handler 实现 → handlers/*.js
+ * 整合路由 → handlers/consolidated.js
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import Logger from '#infra/logging/Logger.js';
+import type { McpContext, McpServiceContainer } from './handlers/types.js';
+/** Decision entry (id + title pair) */
+interface DecisionEntry {
+    id: string;
+    title: string;
+}
+/** Decision cache structure */
+interface DecisionCache {
+    decisions: DecisionEntry[];
+    fetchedAt: number;
+    ttl: number;
+    _pending: Promise<DecisionEntry[]> | null;
+}
+/** MCP session tracking */
+interface McpSession {
+    id: string;
+    startedAt: number;
+    readyCalled: boolean;
+    toolCallCount: number;
+    toolsUsed: Set<string>;
+    lastActivityAt: number;
+}
+/** McpServer constructor options */
+interface McpServerOptions {
+    container?: McpServiceContainer | null;
+    bootstrap?: BootstrapLike | null;
+}
+/** Bootstrap instance minimal shape */
+interface BootstrapLike {
+    initialize(): Promise<Record<string, unknown>>;
+    shutdown(): Promise<void>;
+}
+/** Tool handler function (sync or async, compatible with wrapHandler) */
+type ToolHandlerFn = (ctx: McpContext, args: Record<string, unknown>) => Promise<unknown> | unknown;
+export declare class McpServer {
+    container: McpServiceContainer | null;
+    logger: ReturnType<typeof Logger.getInstance>;
+    _autoApproveMarked: boolean;
+    _decisionCache: DecisionCache;
+    _lastTaskOperation: string;
+    _session: McpSession;
+    _startedAt: number;
+    bootstrap: BootstrapLike | null;
+    server: Server | null;
+    constructor(options?: McpServerOptions);
+    /** 共享上下文对象，传给所有 handler */
+    get _ctx(): {
+        container: McpServiceContainer | null;
+        logger: import("winston").Logger;
+        startedAt: number;
+        session: McpSession;
+    };
+    initialize(): Promise<this>;
+    /**
+     * 注册 ListTools / CallTool 请求处理器
+     * ListTools 基于 ASD_MCP_TIER 过滤可见工具
+     */
+    _registerHandlers(): void;
+    _handleToolCall(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * 在工具返回结果中注入 decisions 摘要 + 更新 session 统计
+     *
+     * 策略：
+     *   - prime: 刷新缓存，不额外注入（response 本身含 decisions）
+     *   - decision 写操作 (record/revise/unpin): invalidate 缓存（下次查询拉最新）
+     *   - 其他工具: 注入 _activeDecisions 摘要
+     *   - 首次未调 prime 的工具: 注入更强提醒
+     *
+     * @param {string} toolName
+     * @param {object} result - handler 返回的 envelope 对象
+     */
+    _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
+    /**
+     * 获取 decisions 摘要（带缓存 + 防并发）
+     * @private
+     * @returns {Promise<Array<{id: string, title: string}>>}
+     */
+    _getDecisionsSummary(): Promise<DecisionEntry[]>;
+    /**
+     * 从 DB 查询 decisions 摘要（仅 id + title）
+     * @private
+     */
+    _fetchDecisionsSummary(): Promise<DecisionEntry[]>;
+    /**
+     * 从 ready 响应结果中刷新缓存（避免额外 DB 查询）
+     * @private
+     */
+    _refreshCacheFromReady(readyResult: unknown): void;
+    /**
+     * 解析工具名到 handler 函数（V3 整合版）
+     * @private
+     */
+    _resolveHandler(name: string): ToolHandlerFn | null;
+    /**
+     * Gateway 权限 gating — 写操作验证权限/宪法/审计
+     * 只读工具直接跳过（不在 TOOL_GATEWAY_MAP 中）
+     * 支持动态 resolver（operation-based 工具按参数解析 action/resource）
+     */
+    _gatewayGate(toolName: string, args: Record<string, unknown>): Promise<void>;
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function startMcpServer(): Promise<McpServer>;
+export default McpServer;
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/lib/external/mcp/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../../../../lib/external/mcp/McpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,MAAM,MAAM,0BAA0B,CAAC;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK3E,uCAAuC;AACvC,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,UAAU,aAAa;IACrB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,2BAA2B;AAC3B,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC;AAED,uCAAuC;AACvC,UAAU,aAAa;IACrB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,yEAAyE;AACzE,KAAK,aAAa,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AA+BpG,qBAAa,SAAS;IACpB,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,aAAa,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACV,OAAO,GAAE,gBAAqB;IA4B1C,2BAA2B;IAC3B,IAAI,IAAI;;;;;MAOP;IAEK,UAAU;IAiDhB;;;OAGG;IACH,iBAAiB;IAuCX,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAyCjE;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IAuCxD;;;;OAIG;IACG,oBAAoB;IA4B1B;;;OAGG;IACG,sBAAsB;IA0B5B;;;OAGG;IACH,sBAAsB,CAAC,WAAW,EAAE,OAAO;IAiB3C;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAwCnD;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsD5D,KAAK;IAwBL,QAAQ;CAQf;AAED,wBAAsB,cAAc,uBAInC;AAED,eAAe,SAAS,CAAC"}