autosnippet 3.2.9 → 3.2.11

package/dist/lib/external/mcp/handlers/bootstrap/shared/skill-generator.js

@@ -0,0 +1,237 @@
+/**
+ * skill-generator.js — 标准化 Skill 生成 + 质量门控
+ *
+ * 内部 Agent (orchestrator.js Step 4) 和外部 Agent (dimension-complete.js)
+ * 共享相同的 Skill 内容构建和质量门控逻辑。
+ *
+ * 调用方:
+ *   - orchestrator.js (内部 Agent) — Phase 5.5 Project Skill 生成
+ *   - dimension-complete-external.js (外部 Agent) — 维度完成时 Skill 生成
+ *
+ * @module bootstrap/shared/skill-generator
+ */
+import Logger from '#infra/logging/Logger.js';
+const logger = Logger.getInstance();
+// ── 常量 ────────────────────────────────────────────────────
+/** Skill 分析文本最低字符数 */
+const MIN_ANALYSIS_LENGTH = 100;
+/** 重复率硬拒绝阈值（全局唯一率低于此值 → 尝试去重挽救） */
+const HARD_REJECT_RATIO = 0.1;
+/** 连续重复块阈值（连续相同行 ≥ 此值 → AI 循环信号） */
+const CONSECUTIVE_DUPE_THRESHOLD = 8;
+/** 短文本结构化豁免阈值（低于此字符数的文本必须有结构化内容） */
+const STRUCTURE_CHECK_THRESHOLD = 500;
+// ── 质量门控 ────────────────────────────────────────────────
+/**
+ * 规范化行文本 — 用于去重比较
+ * 去除列表标记、编号、代码围栏、引用标记等结构性前缀，
+ * 避免 category-scan 等维度中大量结构相似但内容不同的行被误判为重复。
+ */
+function normalizeLine(line) {
+    return line
+        .trim()
+        .replace(/^[-*•]\s+/, '') // strip list markers
+        .replace(/^\d+\.\s+/, '') // strip numbered list
+        .replace(/^[`>]+\s*/, '') // strip code/quote markers
+        .replace(/^#{1,3}\s+/, '') // strip Markdown headings
+        .replace(/\(来源[:：].*?\)/g, '') // strip source annotations
+        .replace(/\s+/g, ' ') // collapse whitespace
+        .trim();
+}
+/**
+ * 检测最长连续重复块长度 — AI 循环的核心特征
+ */
+function maxConsecutiveDuplicates(lines) {
+    let max = 0;
+    let current = 0;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i] === lines[i - 1] && lines[i].length > 0) {
+            current++;
+            if (current > max) {
+                max = current;
+            }
+        }
+        else {
+            current = 0;
+        }
+    }
+    return max;
+}
+/**
+ * 去除连续重复行 — 将连续 N 行相同内容压缩为 1 行
+ */
+function deduplicateConsecutive(text) {
+    const lines = text.split('\n');
+    const result = [lines[0]];
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() !== lines[i - 1].trim() || lines[i].trim().length === 0) {
+            result.push(lines[i]);
+        }
+    }
+    return result.join('\n');
+}
+/**
+ * 验证分析文本是否满足 Skill 生成的质量门控
+ *
+ * 门控规则:
+ *   1. 文本长度 ≥ 100 字符
+ *   2. 重复检测 (两层):
+ *      a. 连续重复块 ≥ 8 行 → AI 循环信号 → 去重后挽救
+ *      b. 规范化后全局唯一率 < 0.10 → 极端重复 → 去重后挽救
+ *   3. 短文本（<500 字符）必须包含结构化内容（标题/列表/代码块）
+ *
+ * 挽救机制: 当检测到重复时，先去除连续重复行，如果去重后文本 ≥ 100 字符则放行。
+ *
+ * @param {string} analysisText - Analyst 或外部 Agent 的分析文本
+ * @returns {{ pass: boolean, reason: string|null, deduplicatedText?: string }}
+ */
+function validateSkillQuality(analysisText) {
+    // 1. 文本过短
+    if (!analysisText || analysisText.trim().length < MIN_ANALYSIS_LENGTH) {
+        return {
+            pass: false,
+            reason: `analysisText too short (${analysisText?.trim().length || 0} chars, min ${MIN_ANALYSIS_LENGTH})`,
+        };
+    }
+    // 2. 重复检测 — 规范化后比较，避免结构性前缀导致误判
+    const textLines = analysisText.split('\n').filter((l) => l.trim().length > 0);
+    const normalizedLines = textLines.map(normalizeLine).filter((l) => l.length > 0);
+    const uniqueNormalized = new Set(normalizedLines);
+    const uniqueRatio = normalizedLines.length > 0 ? uniqueNormalized.size / normalizedLines.length : 1;
+    // 连续重复块检测（AI 循环的核心特征）
+    const maxConsDupes = maxConsecutiveDuplicates(normalizedLines);
+    const isRepetitive = (normalizedLines.length > 30 && uniqueRatio < HARD_REJECT_RATIO) ||
+        maxConsDupes >= CONSECUTIVE_DUPE_THRESHOLD;
+    if (isRepetitive) {
+        // ── 挽救: 去除连续重复后重新评估 ──
+        const cleaned = deduplicateConsecutive(analysisText);
+        if (cleaned.trim().length >= MIN_ANALYSIS_LENGTH) {
+            logger.info(`[SkillGenerator] Repetition detected (${uniqueNormalized.size}/${normalizedLines.length} unique, ` +
+                `ratio ${uniqueRatio.toFixed(2)}, maxConsec ${maxConsDupes}), salvaged via dedup ` +
+                `(${analysisText.length} → ${cleaned.length} chars)`);
+            return { pass: true, reason: null, deduplicatedText: cleaned };
+        }
+        return {
+            pass: false,
+            reason: `repetitive content detected (${uniqueNormalized.size}/${normalizedLines.length} unique, ratio ${uniqueRatio.toFixed(2)}, maxConsec ${maxConsDupes}) — dedup salvage also too short (${cleaned.trim().length} chars)`,
+        };
+    }
+    // 3. 内容中不包含项目特定标记（无 Markdown 标题、列表、代码块等结构化内容）
+    const hasStructure = /^#{1,3}\s.+/m.test(analysisText) ||
+        /^\d+\.\s/m.test(analysisText) ||
+        /^[-*•]\s/m.test(analysisText) ||
+        /```[\s\S]*?```/.test(analysisText) ||
+        // 补充: emoji 前缀列表 (❌/⚠️/✅/•) 和加粗标记也视为结构化内容
+        /^[-*]\s*[❌⚠✅🔴🟡🟢•]/u.test(analysisText) ||
+        /\*\*[^*]+\*\*/.test(analysisText) ||
+        // 补充: 多段落（≥3 个非空段落）视为有基本结构
+        analysisText.split(/\n\s*\n/).filter((p) => p.trim().length > 0).length >= 3;
+    if (!hasStructure && analysisText.length < STRUCTURE_CHECK_THRESHOLD) {
+        return {
+            pass: false,
+            reason: 'no structured content detected',
+        };
+    }
+    return { pass: true, reason: null };
+}
+// ── Skill 内容构建 ─────────────────────────────────────────
+/**
+ * 构建 Skill 的 Markdown 内容
+ *
+ * 标准化格式:
+ *   # {维度标题}
+ *   > Auto-generated by Bootstrap ({source}). Sources: N files analyzed.
+ *   ## 关键发现 (如果有)
+ *   - ...
+ *   {分析正文}
+ *   ## Referenced Files (如果有)
+ *   - `file1`
+ *
+ * @param {object} dim 维度定义 { id, label }
+ * @param {string} analysisText 分析报告全文
+ * @param {string[]} [referencedFiles=[]] 引用的文件路径列表
+ * @param {string[]} [keyFindings=[]] 关键发现摘要
+ * @param {string} [source='bootstrap'] 来源标签 (bootstrap-v3 / external-agent-bootstrap)
+ * @returns {string} - Skill Markdown 内容
+ */
+function buildSkillContent(dim, analysisText, referencedFiles = [], keyFindings = [], source = 'bootstrap') {
+    const parts = [];
+    // Header
+    parts.push(`# ${dim.label || dim.id}`);
+    parts.push('');
+    parts.push(`> Auto-generated by Bootstrap (${source}). Sources: ${referencedFiles.length} files analyzed.`);
+    parts.push('');
+    // Key findings 摘要
+    if (keyFindings.length > 0) {
+        parts.push('## 关键发现');
+        parts.push('');
+        for (const finding of keyFindings) {
+            parts.push(`- ${finding}`);
+        }
+        parts.push('');
+    }
+    // 主体分析
+    parts.push(analysisText);
+    // 引用文件
+    if (referencedFiles.length > 0) {
+        parts.push('');
+        parts.push('## Referenced Files');
+        parts.push('');
+        for (const file of referencedFiles.slice(0, 20)) {
+            parts.push(`- \`${file}\``);
+        }
+    }
+    return parts.filter((p) => p !== undefined).join('\n');
+}
+// ── Skill 生成 ─────────────────────────────────────────────
+/**
+ * generateSkill — 标准化 Skill 生成入口
+ *
+ * 执行流程: 质量门控 → 内容构建 → createSkill 调用
+ *
+ * @param {object} ctx - { container, logger }
+ * @param {object} dim 维度定义 { id, label, skillWorthy, skillMeta }
+ * @param {string} analysisText 分析报告全文
+ * @param {string[]} [referencedFiles=[]] 引用的文件
+ * @param {string[]} [keyFindings=[]] 关键发现
+ * @param {string} [source='bootstrap'] 来源标签
+ * @returns {Promise<{ success: boolean, skillName: string, error?: string }>}
+ */
+export async function generateSkill(ctx, dim, analysisText, referencedFiles = [], keyFindings = [], source = 'bootstrap') {
+    const skillName = dim.skillMeta?.name || `project-${dim.id}`;
+    // 1. 质量门控
+    const validation = validateSkillQuality(analysisText);
+    if (!validation.pass) {
+        logger.warn(`[SkillGenerator] Skill "${dim.id}" skipped — ${validation.reason}`);
+        return { success: false, skillName, error: validation.reason ?? undefined };
+    }
+    // 1.5. 如果触发了去重挽救，使用清理后的文本
+    const effectiveText = validation.deduplicatedText || analysisText;
+    // 2. 内容构建
+    const skillContent = buildSkillContent(dim, effectiveText, referencedFiles, keyFindings, source);
+    // 3. 创建 Skill
+    try {
+        const { createSkill } = await import('../../skill.js');
+        const skillDescription = dim.skillMeta?.description || `Auto-generated skill for ${dim.label}`;
+        const result = createSkill(ctx, {
+            name: skillName,
+            description: skillDescription,
+            content: skillContent,
+            overwrite: true,
+            createdBy: source,
+        });
+        const parsed = typeof result === 'string' ? JSON.parse(result) : result;
+        if (parsed?.success) {
+            logger.info(`[SkillGenerator] Skill "${skillName}" created for "${dim.id}" (${source})`);
+            return { success: true, skillName };
+        }
+        const errorMsg = parsed?.error?.message || 'createSkill returned failure';
+        throw new Error(errorMsg);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        logger.warn(`[SkillGenerator] Skill generation failed for "${dim.id}": ${msg}`);
+        return { success: false, skillName, error: msg };
+    }
+}
+//# sourceMappingURL=skill-generator.js.map

package/dist/lib/external/mcp/handlers/bootstrap/shared/skill-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../../../../../../lib/external/mcp/handlers/bootstrap/shared/skill-generator.ts"],"names":[],"mappings":"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"}

package/dist/lib/external/mcp/handlers/bootstrap/skills.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Bootstrap — Skill 加载与维度增强
+ *
+ * 负责加载 coldstart Skill，从中提取维度增强指引注入 baseDimensions。
+ *
+ * 内部 Agent (bootstrap.js) 和外部 Agent (bootstrap-external.js) 共享此模块。
+ *
+ * 注：语言特有知识已由 LanguageExtensions.buildLanguageExtension() 提供，
+ * 不再依赖语言 reference Skills。
+ */
+/** Minimal logger for bootstrap skill loading */
+interface SkillLogger {
+    info?(...args: unknown[]): void;
+    debug?(...args: unknown[]): void;
+    warn?(...args: unknown[]): void;
+}
+/** Dimension-like object passed to enhanceDimensions */
+interface DimensionLike {
+    id: string;
+    guide: string;
+    [key: string]: unknown;
+}
+/**
+ * 加载 Bootstrap 相关 Skills（仅 coldstart Skill）
+ *
+ * @param {string} _primaryLanguage 主语言（保留参数签名兼容）
+ * @param {object} logger
+ * @returns {{ coldstartSkill: string|null, loaded: string[] }}
+ */
+export declare function loadBootstrapSkills(_primaryLanguage: string, logger?: SkillLogger): {
+    coldstartSkill: string | null;
+    loaded: string[];
+};
+/**
+ * Skill 中提取维度增强指引
+ *
+ * 从 coldstart SKILL.md 中的 "Per-Dimension Industry Reference Templates" 提取
+ * rationale/whyStandard 作为维度增强指引。
+ *
+ * @param {object} skillContext 由 loadBootstrapSkills 返回
+ * @returns {{ guides: Record<string, string>, sectionMap: Record<string, Array<{title: string, content: string, keywords: string[]}>> }}
+ */
+export declare function extractSkillDimensionGuides(skillContext: {
+    coldstartSkill: string | null;
+    loaded: string[];
+}): {
+    guides: Record<string, string>;
+    sectionMap: Record<string, {
+        title: string;
+        content: string;
+        keywords: string[];
+    }[]>;
+};
+/**
+ * 增强 9 维度定义 — 将 Skill 提供的参考指引注入 dimensions[].guide
+ *
+ * @param {Array} dimensions 原始维度数组
+ * @param {Record<string, string>} skillGuides - guides 部分
+ * @param {Record<string, Array>} skillSections - sectionMap 部分（per-candidate 匹配用）
+ * @returns {Array} 增强后的维度数组（原数组不变，返回新数组）
+ */
+export declare function enhanceDimensions(dimensions: DimensionLike[], skillGuides: Record<string, string>, skillSections: Record<string, Array<{
+    title: string;
+    content: string;
+    keywords: string[];
+}>>): DimensionLike[];
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../../../../lib/external/mcp/handlers/bootstrap/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,iDAAiD;AACjD,UAAU,WAAW;IACnB,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,wDAAwD;AACxD,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;oBAChD,MAAM,GAAG,IAAI;YAAU,MAAM,EAAE;EAoBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE;IACxD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;;;eAIkB,MAAM;iBAAW,MAAM;kBAAY,MAAM,EAAE;;EA0B7D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,aAAa,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,mBAkB7F"}

package/dist/lib/external/mcp/handlers/bootstrap/skills.js

@@ -0,0 +1,102 @@
+/**
+ * Bootstrap — Skill 加载与维度增强
+ *
+ * 负责加载 coldstart Skill，从中提取维度增强指引注入 baseDimensions。
+ *
+ * 内部 Agent (bootstrap.js) 和外部 Agent (bootstrap-external.js) 共享此模块。
+ *
+ * 注：语言特有知识已由 LanguageExtensions.buildLanguageExtension() 提供，
+ * 不再依赖语言 reference Skills。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { SKILLS_DIR } from '../../../../shared/package-root.js';
+const COLDSTART_SKILL_NAME = 'autosnippet-coldstart';
+/**
+ * 加载 Bootstrap 相关 Skills（仅 coldstart Skill）
+ *
+ * @param {string} _primaryLanguage 主语言（保留参数签名兼容）
+ * @param {object} logger
+ * @returns {{ coldstartSkill: string|null, loaded: string[] }}
+ */
+export function loadBootstrapSkills(_primaryLanguage, logger) {
+    const result = {
+        coldstartSkill: null,
+        loaded: [],
+    };
+    const skillPath = path.join(SKILLS_DIR, COLDSTART_SKILL_NAME, 'SKILL.md');
+    try {
+        if (fs.existsSync(skillPath)) {
+            result.coldstartSkill = fs.readFileSync(skillPath, 'utf8');
+            result.loaded.push(COLDSTART_SKILL_NAME);
+            logger?.info?.(`[Bootstrap] Loaded skill: ${COLDSTART_SKILL_NAME}`);
+        }
+        else {
+            logger?.debug?.(`[Bootstrap] Skill not found: ${skillPath}`);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        logger?.warn?.(`[Bootstrap] Failed to load skill ${COLDSTART_SKILL_NAME}: ${msg}`);
+    }
+    return result;
+}
+/**
+ * Skill 中提取维度增强指引
+ *
+ * 从 coldstart SKILL.md 中的 "Per-Dimension Industry Reference Templates" 提取
+ * rationale/whyStandard 作为维度增强指引。
+ *
+ * @param {object} skillContext 由 loadBootstrapSkills 返回
+ * @returns {{ guides: Record<string, string>, sectionMap: Record<string, Array<{title: string, content: string, keywords: string[]}>> }}
+ */
+export function extractSkillDimensionGuides(skillContext) {
+    const guides = {}; // dimId → summary guide text
+    const sectionMap = {}; // dimId → [{title, content, keywords}]
+    // ── coldstart 模板: 从 rationale/whyStandard 提取维度指引 ──
+    if (skillContext.coldstartSkill) {
+        const content = skillContext.coldstartSkill;
+        const dimBlocks = content.matchAll(/###\s+维度\s*\d+\s*[:：]\s*(.+?)\s*\(([^)]+)\)\s*[—–-]\s*参考模板\s*\n([\s\S]*?)(?=\n###\s|\n##\s)/g);
+        for (const match of dimBlocks) {
+            let dimId = match[2].trim();
+            if (/solution|antiPattern|bug/i.test(dimId)) {
+                dimId = 'anti-pattern';
+            }
+            dimId = dimId.replace(/\s+/g, '-');
+            const block = match[3];
+            const rationaleMatch = block.match(/"rationale"\s*:\s*"([^"]{20,300})"/);
+            const whyMatch = block.match(/"whyStandard"\s*:\s*"([^"]{20,200})"/);
+            const extraGuide = [rationaleMatch?.[1], whyMatch?.[1]].filter(Boolean).join('。');
+            if (extraGuide) {
+                guides[dimId] = extraGuide;
+            }
+        }
+    }
+    return { guides, sectionMap };
+}
+/**
+ * 增强 9 维度定义 — 将 Skill 提供的参考指引注入 dimensions[].guide
+ *
+ * @param {Array} dimensions 原始维度数组
+ * @param {Record<string, string>} skillGuides - guides 部分
+ * @param {Record<string, Array>} skillSections - sectionMap 部分（per-candidate 匹配用）
+ * @returns {Array} 增强后的维度数组（原数组不变，返回新数组）
+ */
+export function enhanceDimensions(dimensions, skillGuides, skillSections) {
+    if (!skillGuides || Object.keys(skillGuides).length === 0) {
+        return dimensions;
+    }
+    return dimensions.map((dim) => {
+        const extra = skillGuides[dim.id];
+        if (!extra) {
+            return dim;
+        }
+        return {
+            ...dim,
+            guide: `${dim.guide}。[Skill 参考] ${extra}`,
+            _skillEnhanced: true,
+            _skillSections: skillSections?.[dim.id] || [],
+        };
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/external/mcp/handlers/bootstrap/skills.js.map

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

package/dist/lib/external/mcp/handlers/bootstrap-external.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MCP Handler — 外部 Agent 驱动的 Bootstrap (External-Agent-Driven)
+ *
+ * `autosnippet_bootstrap` 的主入口（无参数）：
+ *   Phase 1-4 同步执行（文件收集 / AST / 依赖图 / Guard）
+ *   → 构建 Mission Briefing 一次性返回
+ *   → 不启动 Phase 5 异步 AI pipeline
+ *   → 等待外部 Agent (Cursor/Copilot) 主动提交知识 + 完成维度
+ *
+ * 与 bootstrap-internal.js 的关系：
+ *   - 本文件: 外部 Agent 路径 — Agent 自己分析代码 + 提交知识，不需要 AI Provider
+ *   - bootstrap-internal.js: 内部 Agent 路径 — 内置 Analyst/Producer pipeline，需要 API Key
+ *   - 两者共享 Phase 1-4 的分析逻辑 → bootstrap/shared/bootstrap-phases.js
+ *
+ * @module handlers/bootstrap-external
+ */
+import type { ServiceContainer } from '#inject/ServiceContainer.js';
+/** MCP handler context passed from McpServer */
+interface McpContext {
+    container: ServiceContainer;
+    logger: {
+        info(msg: string, meta?: Record<string, unknown>): void;
+    };
+    startedAt?: number;
+    [key: string]: unknown;
+}
+/** Shape of the mission briefing returned by buildMissionBriefing */
+interface MissionBriefingResult {
+    meta?: {
+        warnings?: string[];
+        responseSizeKB?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * bootstrapExternal — 外部 Agent 驱动的一键冷启动
+ *
+ * 无参数调用，返回 Mission Briefing。
+ * Phase 1-4 复用现有 bootstrap.js 逻辑，Phase 5 不启动。
+ *
+ * @param {object} ctx - { container, logger, startedAt }
+ * @returns {Promise<object>} - envelope({ success, data: MissionBriefing })
+ */
+export declare function bootstrapExternal(ctx: McpContext): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        message: string;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+} | {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: MissionBriefingResult | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+/**
+ * 获取当前 active session（供其他 handler 使用）
+ * @param {object} container
+ * @param {string} [sessionId]
+ * @returns {import('./bootstrap/BootstrapSession.js').BootstrapSession|null}
+ */
+export declare function getActiveSession(container: ServiceContainer, sessionId?: string): import("./bootstrap/BootstrapSession.js").BootstrapSession | null;
+export {};
+//# sourceMappingURL=bootstrap-external.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-external.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/bootstrap-external.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAOpE,gDAAgD;AAChD,UAAU,UAAU;IAClB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qEAAqE;AACrE,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuCD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;GAmHtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,qEAG/E"}