dsh-github-flow 0.3.0 → 0.5.0

package/lib/renderers/skill.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Skill 领域渲染器：负责 Agent Skills 跨仓检索结果、已安装列表与预览说明
+ */
+export declare function renderSkillMarkdown(args: any, value: any): string;
+export interface SkillDiagnosticItem {
+    type: 'error' | 'warning' | 'fixed';
+    skillName: string;
+    message: string;
+}
+export interface SkillPublishReport {
+    mode: 'dry-run' | 'fix' | 'publish';
+    success: boolean;
+    directory?: string;
+    items: SkillDiagnosticItem[];
+    repoWarnings: string[];
+    summary: string;
+    tag?: string;
+    rawText?: string;
+}
+/**
+ * 解析 gh skill publish 命令输出的 TSV 诊断行与状态汇总
+ *
+ * 核心设计理由与约束：
+ * 1. gh skill publish 命令无论成功还是失败，均采用制表符 `\t` 分隔的 TSV 纯文本行输出；
+ * 2. 诊断行格式：`error\t<skill>\t<msg>`、`warning\t<skill>\t<msg>`、`fixed\t<skill>\t<msg>` 或 `warning\t\t<repo_rule>`；
+ * 3. 校验失败时 exitCode 为 1，但其 stdout 中携带精准的错误项列表，需提取后结构化呈现，绝不能当作盲目异常吞没；
+ * 4. 若未匹配到有效技能或遇到无技能目录，从 stderr 提取根因提示。
+ */
+export declare function parseSkillPublishOutput(rawStdout: string, rawStderr: string, exitOk: boolean, mode: 'dry-run' | 'fix' | 'publish', directory?: string, tag?: string): SkillPublishReport;
+/**
+ * Skill Publish 结构化 Markdown 渲染器
+ * 将体检报告、自动修复明细与正式发布结果转化为紧凑、清晰的表格与指引
+ */
+export declare function renderSkillPublishMarkdown(report: SkillPublishReport): string;

package/lib/renderers/skill.js

@@ -0,0 +1,241 @@
+import { sanitizeCell } from './common.js';
+/**
+ * Skill 领域渲染器：负责 Agent Skills 跨仓检索结果、已安装列表与预览说明
+ */
+export function renderSkillMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${value.warning || '⚠️ 操作确认拦截'}`,
+            `> - **影响评估**: ${value.impact || ''}`,
+            `> - **确认指引**: ${value.requiredAction || '如确认继续，请在参数中附加 `confirm: true` 重新调用。'}`,
+        ].join('\n');
+    }
+    if (typeof value.result === 'string')
+        return value.result;
+    // 6.0 特化 action 处理（update）
+    if (args?.action === 'update' || value?.action === 'update') {
+        const extra = value.output || value.detail;
+        return `### 🔄 ${value.message || 'Agent Skills 更新结果'}\n` + (extra ? `\`\`\`text\n${String(extra).trim()}\n\`\`\`` : '');
+    }
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    // 6.1 Skill 检索列表
+    if (Array.isArray(value.items) && args?.action === 'search') {
+        const list = value.items.filter(Boolean);
+        if (list.length === 0)
+            return '📭 未检索到匹配的 Agent Skill。';
+        const rows = list.map((s) => {
+            const name = s.skillName ? `\`${s.skillName}\`` : '-';
+            const repo = s.repo ? `[${s.repo}](https://github.com/${s.repo})` : '-';
+            const stars = typeof s.stars === 'number' ? `⭐ ${s.stars}` : '-';
+            const desc = sanitizeCell(s.description, 50);
+            return `| ${name} | ${repo} | ${stars} | ${desc} |`;
+        });
+        return [
+            `**Skills 检索结果 (${list.length} 个):**\n`,
+            '| Skill | 仓库 | Stars | 描述 |',
+            '| :--- | :--- | :--- | :--- |',
+            ...rows,
+        ].join('\n');
+    }
+    // 6.2 已安装 Skills 列表
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        const list = value.items.filter(Boolean);
+        if (list.length === 0)
+            return '📭 当前环境尚未安装任何 Agent Skill。';
+        const rows = list.map((s) => {
+            const name = s.skillName ? `\`${s.skillName}\`` : '-';
+            const ver = s.version ? String(s.version) : '-';
+            const scope = s.scope ? String(s.scope) : '-';
+            const source = s.sourceURL ? `[来源](${s.sourceURL})` : (s.path ? `\`${sanitizeCell(s.path, 40)}\`` : '-');
+            return `| ${name} | ${ver} | ${scope} | ${source} |`;
+        });
+        return [
+            `**已安装 ${list.length} 个 Agent Skill:**\n`,
+            '| Skill | 版本 | 范围 | 来源 |',
+            '| :--- | :--- | :--- | :--- |',
+            ...rows,
+        ].join('\n');
+    }
+    // 6.3 Skill 校验与发布报告
+    if (args?.action === 'publish' || value?.mode === 'dry-run' || value?.mode === 'fix' || value?.mode === 'publish') {
+        return renderSkillPublishMarkdown(value);
+    }
+    // 兜底降级
+    return JSON.stringify(value, null, 2);
+}
+/**
+ * 解析 gh skill publish 命令输出的 TSV 诊断行与状态汇总
+ *
+ * 核心设计理由与约束：
+ * 1. gh skill publish 命令无论成功还是失败，均采用制表符 `\t` 分隔的 TSV 纯文本行输出；
+ * 2. 诊断行格式：`error\t<skill>\t<msg>`、`warning\t<skill>\t<msg>`、`fixed\t<skill>\t<msg>` 或 `warning\t\t<repo_rule>`；
+ * 3. 校验失败时 exitCode 为 1，但其 stdout 中携带精准的错误项列表，需提取后结构化呈现，绝不能当作盲目异常吞没；
+ * 4. 若未匹配到有效技能或遇到无技能目录，从 stderr 提取根因提示。
+ */
+export function parseSkillPublishOutput(rawStdout, rawStderr, exitOk, mode, directory, tag) {
+    const items = [];
+    const repoWarnings = [];
+    let summary = '';
+    const combined = `${rawStdout || ''}\n${rawStderr || ''}`;
+    const lines = combined.split(/\r?\n/).map(l => l.trimEnd()).filter(Boolean);
+    for (const line of lines) {
+        // 匹配 TSV 诊断行：error/warning/fixed + \t + skillName + \t + message
+        const tsvMatch = line.match(/^(error|warning|fixed)\t([^\t]*)\t(.*)$/i);
+        if (tsvMatch) {
+            const type = tsvMatch[1].toLowerCase();
+            const skillName = tsvMatch[2].trim();
+            const message = tsvMatch[3].trim();
+            if (!skillName) {
+                // 技能名为空通常是仓库级规则警告（如 ruleset 缺少 tag 保护）
+                repoWarnings.push(message);
+            }
+            else {
+                items.push({ type, skillName, message });
+            }
+            continue;
+        }
+        // 汇总与特征行识别
+        if (/validation failed with \d+ error\(s\)/i.test(line)) {
+            summary = line.trim();
+        }
+        else if (/Dry run complete/i.test(line)) {
+            if (!summary)
+                summary = line.trim();
+        }
+        else if (/Fixed \d+ file\(s\)/i.test(line)) {
+            summary = line.trim();
+        }
+        else if (/no skills found in/i.test(line)) {
+            summary = line.trim();
+        }
+        else if (/Released/i.test(line) && mode === 'publish') {
+            if (!summary)
+                summary = line.trim();
+        }
+    }
+    // 判定最终业务成功态：
+    // 1. 若 items 中存在任一 error，则判定为失败；
+    // 2. 若 exitOk 为 false，即使没有 TSV 行也判定为失败；
+    // 3. dry-run 模式下无 error 且正常跑完判定为成功；
+    // 4. 若没有找到 skill（summary 包含 no skills found），视作失败并在 items 中追加说明项。
+    const hasErrors = items.some(i => i.type === 'error');
+    const noSkillsFound = summary.includes('no skills found in');
+    let success = exitOk && !hasErrors && !noSkillsFound;
+    if (noSkillsFound && items.length === 0) {
+        items.push({
+            type: 'error',
+            skillName: '-',
+            message: summary || '在目标目录下未检索到符合规范的 Agent Skill（需满足 skills/*/SKILL.md 等路径约束）',
+        });
+        success = false;
+    }
+    else if (!exitOk && items.length === 0 && rawStderr) {
+        // 其它非零退出且无 TSV 诊断行的情况，将 stderr 作为通用错误提示
+        items.push({
+            type: 'error',
+            skillName: '-',
+            message: rawStderr.trim(),
+        });
+        success = false;
+    }
+    return {
+        mode,
+        success,
+        directory,
+        items,
+        repoWarnings,
+        summary,
+        tag,
+        rawText: rawStdout.trim() || rawStderr.trim(),
+    };
+}
+/**
+ * Skill Publish 结构化 Markdown 渲染器
+ * 将体检报告、自动修复明细与正式发布结果转化为紧凑、清晰的表格与指引
+ */
+export function renderSkillPublishMarkdown(report) {
+    if (!report)
+        return '无返回内容';
+    if (report.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${report.warning || '⚠️ 操作确认拦截'}`,
+            `> - **影响评估**: ${report.impact || ''}`,
+            `> - **确认指引**: ${report.requiredAction || ''}`,
+        ].join('\n');
+    }
+    const sections = [];
+    const dirHint = report.directory ? ` (目录: \`${report.directory}\`)` : '';
+    if (report.mode === 'dry-run') {
+        const errorCount = report.items.filter(i => i.type === 'error').length;
+        const warningCount = report.items.filter(i => i.type === 'warning').length;
+        if (report.success && errorCount === 0) {
+            sections.push(`### ✅ Agent Skills 合规校验通过！${dirHint}\n`);
+            sections.push('受检 Skill 均符合 agentskills.io 规范（命名规范、目录匹配、必需 frontmatter 字段均通过）。');
+            if (warningCount > 0) {
+                sections.push(`\n**建议优化项 (${warningCount} 项):**`);
+            }
+        }
+        else {
+            sections.push(`### ⚠️ Agent Skills 校验发现问题 (${errorCount} 项错误${warningCount > 0 ? `，${warningCount} 项警告` : ''})${dirHint}\n`);
+        }
+        if (report.items.length > 0) {
+            const rows = report.items.map(item => {
+                let badge = 'ℹ️ 提示';
+                if (item.type === 'error')
+                    badge = '❌ 错误';
+                else if (item.type === 'warning')
+                    badge = '⚠️ 建议';
+                else if (item.type === 'fixed')
+                    badge = '🛠️ 已修复';
+                return `| ${badge} | \`${sanitizeCell(item.skillName, 30)}\` | ${sanitizeCell(item.message, 80)} |`;
+            });
+            sections.push('| 级别 | Skill 名称 | 问题详情与指引 |\n| :--- | :--- | :--- |\n' + rows.join('\n'));
+        }
+        if (report.repoWarnings && report.repoWarnings.length > 0) {
+            sections.push('\n**仓库策略提醒:**\n' + report.repoWarnings.map(w => `- 💡 ${w}`).join('\n'));
+        }
+        if (report.success && errorCount === 0) {
+            sections.push('\n> 💡 **正式发版指引**: 若需创建 GitHub Release 正式发布技能，请指定版本 Tag 并附带 `confirm: true`：\n> `github_skill(action: "publish", tag: "v1.0.0", dry_run: false, confirm: true)`');
+        }
+        else {
+            sections.push('\n> 🔍 **修复提示**: 若存在安装元数据残留，可先调用 `github_skill(action: "publish", fix: true)` 自动剥离清洗。');
+        }
+    }
+    else if (report.mode === 'fix') {
+        const fixedItems = report.items.filter(i => i.type === 'fixed');
+        sections.push(`### 🛠️ Agent Skills 元数据自动修复${report.success ? '完成' : '结果'}${dirHint}\n`);
+        if (fixedItems.length > 0) {
+            sections.push(`已自动清洗 **${fixedItems.length}** 处技能文件中的安装残留元数据（如 \`metadata.github-*\`）：\n`);
+            const rows = fixedItems.map(item => `| \`${sanitizeCell(item.skillName, 30)}\` | ${sanitizeCell(item.message, 80)} |`);
+            sections.push('| Skill 名称 | 修复操作 |\n| :--- | :--- |\n' + rows.join('\n'));
+            sections.push('\n> 📌 **后续步骤**: 请使用 `git diff` 审查本地文件变更，提交 Git 后再重新运行合规体检或发布。');
+        }
+        else {
+            sections.push(report.summary || '未检测到需要修复的元数据残留。');
+        }
+    }
+    else if (report.mode === 'publish') {
+        if (report.success) {
+            sections.push(`### 🚀 Agent Skill 发布成功！${dirHint}\n`);
+            sections.push(`- **版本 Tag**: \`${report.tag || '-'}\``);
+            sections.push('- **发布状态**: 已自动附加 `agent-skills` 仓库 Topic，并创建了关联 GitHub Release。');
+            if (report.summary)
+                sections.push(`\n${report.summary}`);
+        }
+        else {
+            sections.push(`### ❌ Agent Skill 发布失败${dirHint}\n`);
+            if (report.summary)
+                sections.push(`- **原因**: ${report.summary}`);
+            if (report.items.length > 0) {
+                const rows = report.items.map(item => `| ${item.type} | \`${sanitizeCell(item.skillName, 30)}\` | ${sanitizeCell(item.message, 80)} |`);
+                sections.push('\n| 级别 | Skill 名称 | 详情 |\n| :--- | :--- | :--- |\n' + rows.join('\n'));
+            }
+        }
+    }
+    return sections.join('\n');
+}

package/lib/renderers/status.d.ts

@@ -0,0 +1,28 @@
+import type { TelemetrySummary } from '../telemetry.js';
+export interface StatusSectionItem {
+    repo?: string;
+    number?: string;
+    title?: string;
+    detail?: string;
+    raw: string;
+}
+export interface ParsedStatusReport {
+    assignedIssues: StatusSectionItem[];
+    assignedPrs: StatusSectionItem[];
+    reviewRequests: StatusSectionItem[];
+    mentions: StatusSectionItem[];
+    activity: StatusSectionItem[];
+    rawText: string;
+}
+/**
+ * 解析 gh status 的输出，提取待办 Issue、待办 PR、评审请求、提及与近期动态
+ */
+export declare function parseStatusOutput(output: string): ParsedStatusReport;
+/**
+ * Status 领域渲染器：负责用户跨仓待办大盘的 Markdown 格式化
+ */
+export declare function renderStatusMarkdown(args: any, value: any): string;
+/**
+ * 渲染 DSH GitHub 工具链健康度与降级率审计报表
+ */
+export declare function renderHealthAuditMarkdown(summary: TelemetrySummary): string;

package/lib/renderers/status.js

@@ -0,0 +1,176 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 解析 gh status 的输出，提取待办 Issue、待办 PR、评审请求、提及与近期动态
+ */
+export function parseStatusOutput(output) {
+    const trimmed = (output || '').trim();
+    const report = {
+        assignedIssues: [],
+        assignedPrs: [],
+        reviewRequests: [],
+        mentions: [],
+        activity: [],
+        rawText: trimmed,
+    };
+    if (!trimmed)
+        return report;
+    const lines = trimmed.split(/[\r\n]+/);
+    let currentSection = null;
+    for (const line of lines) {
+        const rawLine = line.trim();
+        if (!rawLine)
+            continue;
+        // 检查是否包含版块头
+        if (/Assigned Issues/i.test(rawLine)) {
+            currentSection = 'assignedIssues';
+            // 如果同一行有双列分割
+            if (/Assigned Pull Requests/i.test(rawLine)) {
+                // 双列行，仅做标记
+                continue;
+            }
+            continue;
+        }
+        if (/Assigned Pull Requests/i.test(rawLine)) {
+            currentSection = 'assignedPrs';
+            continue;
+        }
+        if (/Review Requests/i.test(rawLine)) {
+            currentSection = 'reviewRequests';
+            continue;
+        }
+        if (/Mentions/i.test(rawLine)) {
+            currentSection = 'mentions';
+            continue;
+        }
+        if (/Repository Activity/i.test(rawLine)) {
+            currentSection = 'activity';
+            continue;
+        }
+        // 过滤空状态占位符
+        if (rawLine.includes('Nothing here') || rawLine.includes('^_^')) {
+            continue;
+        }
+        // 处理行内容（支持制表符或双列分隔）
+        const cleanSegments = rawLine
+            .split('│')
+            .map((s) => s.trim())
+            .filter((s) => s && !s.includes('Nothing here') && !s.includes('^_^'));
+        for (const segment of cleanSegments) {
+            if (!segment)
+                continue;
+            // 尝试匹配制表符或 "repo#123\tdesc\tdetail"
+            const tabParts = segment.split('\t').map((p) => p.trim());
+            const itemMatch = tabParts[0].match(/^([^#\s]+)#(\d+)/);
+            const item = {
+                raw: segment,
+            };
+            if (itemMatch) {
+                item.repo = itemMatch[1];
+                item.number = itemMatch[2];
+                item.title = tabParts[1] || '';
+                item.detail = tabParts[2] || '';
+            }
+            else {
+                item.detail = segment;
+            }
+            if (currentSection && report[currentSection]) {
+                report[currentSection].push(item);
+            }
+            else {
+                // 未匹配版块默认归入 activity
+                report.activity.push(item);
+            }
+        }
+    }
+    return report;
+}
+/**
+ * Status 领域渲染器：负责用户跨仓待办大盘的 Markdown 格式化
+ */
+export function renderStatusMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value?.healthScore !== undefined || value?.degradationRate !== undefined || args?.action === 'health') {
+        return renderHealthAuditMarkdown(value);
+    }
+    const report = value.parsed || parseStatusOutput(value.rawText || value.output || '');
+    const renderSection = (title, icon, items, emptyText) => {
+        if (!items || items.length === 0) {
+            return `#### ${icon} ${title}\n*${emptyText}*\n`;
+        }
+        const rows = items.map((it) => {
+            const repoRef = it.repo && it.number ? `\`${it.repo}#${it.number}\`` : '-';
+            const titleText = sanitizeCell(it.title || it.raw, 40);
+            const detailText = sanitizeCell(it.detail, 40);
+            return `| ${repoRef} | ${titleText} | ${detailText} |`;
+        });
+        return [
+            `#### ${icon} ${title} (${items.length})\n`,
+            '| 仓库 & 编号 | 标题 / 动作 | 详情 / 摘要 |',
+            '| :--- | :--- | :--- |',
+            ...rows,
+            '',
+        ].join('\n');
+    };
+    const sections = [
+        renderSection('指派给我的 Issue (Assigned Issues)', '📌', report.assignedIssues, '🟢 暂无分配给你的未决 Issue'),
+        renderSection('指派给我的 PR (Assigned Pull Requests)', '🔀', report.assignedPrs, '🟢 暂无分配给你的未决 PR'),
+        renderSection('等待我评审的 PR (Review Requests)', '👀', report.reviewRequests, '🟢 暂无待你评审的 PR'),
+        renderSection('提及我的动态 (Mentions)', '🔔', report.mentions, '🟢 暂无与你相关的近期提及'),
+        renderSection('订阅仓库近期动态 (Repository Activity)', '⚡', report.activity, '暂无近期仓库动态'),
+    ];
+    return [
+        '### 🧭 GitHub 个人待办与跨仓动态聚合看板\n',
+        ...sections,
+        '> 💡 **待办操作建议**: 可通过 `github_issue(action: \'view\')` 或 `github_pr(action: \'checkout\')` 快速检视对应议题并展开工作。',
+    ].join('\n');
+}
+/**
+ * 渲染 DSH GitHub 工具链健康度与降级率审计报表
+ */
+export function renderHealthAuditMarkdown(summary) {
+    if (!summary)
+        return '无遥测健康度数据';
+    let badge = '🟢 极佳';
+    if (summary.statusLevel === 'NEEDS_ATTENTION') {
+        badge = '🔴 需关注';
+    }
+    else if (summary.statusLevel === 'GOOD') {
+        badge = '🟡 良好';
+    }
+    const successRate = summary.totalCalls > 0
+        ? `${((summary.successCount / summary.totalCalls) * 100).toFixed(1)}%`
+        : '100%';
+    const lines = [
+        '### 🩺 DSH GitHub 工具链健康度与降级率审计报表\n',
+        `- **综合健康分**: ${badge} (${summary.healthScore} / 100 分)`,
+        `- **统计样本量**: 最近 ${summary.totalCalls} 次 Agent 工具调用`,
+        `- **API 降级率**: \`${summary.degradationRate}%\` (${summary.degradedCount} 次触发降级链路)`,
+        `- **安全防御拦截**: ${summary.confirmBlockedCount + summary.scopeBlockedCount} 次 (含 ${summary.scopeBlockedCount} 次权限缺失，${summary.confirmBlockedCount} 次确认防线)`,
+        `- **执行成功率**: \`${successRate}\` (${summary.successCount} 成功, ${summary.failureCount} 失败)`,
+    ];
+    // 工具调用分布表
+    const toolNames = Object.keys(summary.toolStats || {});
+    if (toolNames.length > 0) {
+        const sorted = toolNames.sort((a, b) => summary.toolStats[b].total - summary.toolStats[a].total);
+        const rows = sorted.map((name) => {
+            const s = summary.toolStats[name];
+            const rate = s.total > 0 ? `${((s.success / s.total) * 100).toFixed(0)}%` : '100%';
+            let toolBadge = '🟢 正常';
+            if (s.degraded > 0)
+                toolBadge = '🟡 存在降级';
+            if (s.failed > 0 && s.success === 0)
+                toolBadge = '🔴 异常';
+            return `| \`${name}\` | ${s.total} | ${rate} | ${s.degraded} | ${toolBadge} |`;
+        });
+        lines.push('\n**核心工具调用分布:**', '| 工具名称 | 调用次数 | 成功率 | 降级次数 | 状态 |', '| :--- | :---: | :---: | :---: | :--- |', ...rows);
+    }
+    // 自愈优化建议
+    if (Array.isArray(summary.recommendations) && summary.recommendations.length > 0) {
+        lines.push('\n> 💡 **优化与自愈建议:**');
+        summary.recommendations.forEach((rec) => {
+            lines.push(`> - ${rec}`);
+        });
+    }
+    return lines.join('\n');
+}

package/lib/telemetry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DSH GitHub Flow - 运行时遥测审计与降级率收集器
+ *
+ * 遵循 /dsh-plugin-dev-skill 规范，利用 Cordis 的 tools/result 事件总线
+ * 建立内存中固定容量的轻量无锁环形队列，实现零外部数据库依赖、常驻内存严格 <200KB
+ * 的工业级运行时可观测性，量化分析 18 大工具矩阵的 API 降级率与健康度指标。
+ */
+export interface TelemetryRecord {
+    id: string;
+    timestamp: number;
+    toolName: string;
+    action?: string;
+    durationMs?: number;
+    success: boolean;
+    degraded: boolean;
+    scopeBlocked: boolean;
+    confirmBlocked: boolean;
+    errorType?: string;
+}
+export interface ToolUsageStat {
+    total: number;
+    success: number;
+    degraded: number;
+    failed: number;
+    blocked: number;
+}
+export interface TelemetrySummary {
+    totalCalls: number;
+    successCount: number;
+    failureCount: number;
+    degradedCount: number;
+    degradationRate: number;
+    scopeBlockedCount: number;
+    confirmBlockedCount: number;
+    healthScore: number;
+    statusLevel: 'EXCELLENT' | 'GOOD' | 'NEEDS_ATTENTION';
+    toolStats: Record<string, ToolUsageStat>;
+    recommendations: string[];
+}
+/**
+ * 内存固定容量环形队列（无锁、确定性内存上限）
+ */
+export declare class TelemetryRingBuffer {
+    private buffer;
+    private readonly capacity;
+    constructor(capacity?: number);
+    push(record: TelemetryRecord): void;
+    getAll(): TelemetryRecord[];
+    size(): number;
+    clear(): void;
+}
+/**
+ * 遥测收集与健康分析引擎
+ */
+export declare class TelemetryCollector {
+    private ringBuffer;
+    private callCounter;
+    constructor(capacity?: number);
+    /**
+     * 记录一次工具调用结果（Fail-Open 保护，绝不阻滞主流程）
+     */
+    recordCall(name: string, args: any, result: any, durationMs?: number): void;
+    /**
+     * 生成工具链健康度与降级率统计大盘
+     */
+    getSummary(): TelemetrySummary;
+    clear(): void;
+}
+/** 全局单例收集器实例 */
+export declare const defaultTelemetryCollector: TelemetryCollector;