@wwlocal/aibot-plugin-node 20260409.20.0

package/dist/esm/src/template-card-parser.js

@@ -0,0 +1,495 @@
+import { VALID_CARD_TYPES } from './const.js';
+
+/**
+ * 模板卡片解析器
+ *
+ * 从 LLM 回复文本中提取 markdown JSON 代码块，验证其是否为合法的企业微信模板卡片，
+ * 返回提取到的卡片列表和剩余文本。
+ *
+ * 同时提供 maskTemplateCardBlocks 函数，用于在流式中间帧中隐藏正在构建的卡片代码块，
+ * 避免 JSON 源码暴露给终端用户。
+ */
+// ============================================================================
+// LLM 输出字段类型修正
+// ============================================================================
+/**
+ * 将 LLM 可能输出的字符串/非法值修正为企业微信 API 要求的整数。
+ */
+function coerceToInt(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return Math.round(value);
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim().toLowerCase();
+        const num = Number(trimmed);
+        if (!Number.isNaN(num) && Number.isFinite(num)) {
+            return Math.round(num);
+        }
+    }
+    return undefined;
+}
+/** 将 LLM 可能输出的字符串/非法值修正为布尔值 */
+function coerceToBool(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        const t = value.trim().toLowerCase();
+        if (t === "true" || t === "1" || t === "yes")
+            return true;
+        if (t === "false" || t === "0" || t === "no")
+            return false;
+    }
+    if (typeof value === "number")
+        return value !== 0;
+    return undefined;
+}
+/** checkbox.mode 的语义别名映射 */
+const MODE_ALIASES = {
+    single: 0,
+    radio: 0,
+    "单选": 0,
+    multi: 1,
+    multiple: 1,
+    "多选": 1,
+};
+/**
+ * 修正 checkbox.mode
+ */
+function coerceCheckboxMode(value) {
+    let num;
+    if (typeof value === "number" && Number.isFinite(value)) {
+        num = Math.round(value);
+    }
+    else if (typeof value === "string") {
+        const trimmed = value.trim().toLowerCase();
+        if (trimmed in MODE_ALIASES)
+            return MODE_ALIASES[trimmed];
+        const parsed = Number(trimmed);
+        if (!Number.isNaN(parsed))
+            num = Math.round(parsed);
+    }
+    if (num === undefined)
+        return undefined;
+    if (num <= 0)
+        return 0;
+    return 1;
+}
+/**
+ * 对 LLM 生成的模板卡片 JSON 做字段类型修正
+ */
+function normalizeTemplateCardFields(card, log) {
+    const fixes = [];
+    // ── checkbox ──────────────────────────────────────────────────────────
+    const checkbox = card.checkbox;
+    if (checkbox && typeof checkbox === "object") {
+        if ("mode" in checkbox) {
+            const fixed = coerceCheckboxMode(checkbox.mode);
+            if (fixed !== undefined) {
+                if (checkbox.mode !== fixed) {
+                    fixes.push(`checkbox.mode: ${JSON.stringify(checkbox.mode)} → ${fixed}`);
+                }
+                checkbox.mode = fixed;
+            }
+            else {
+                fixes.push(`checkbox.mode: ${JSON.stringify(checkbox.mode)} → (deleted, invalid)`);
+                delete checkbox.mode;
+            }
+        }
+        if ("disable" in checkbox) {
+            const fixed = coerceToBool(checkbox.disable);
+            if (fixed !== undefined && checkbox.disable !== fixed) {
+                fixes.push(`checkbox.disable: ${JSON.stringify(checkbox.disable)} → ${fixed}`);
+                checkbox.disable = fixed;
+            }
+        }
+        if (Array.isArray(checkbox.option_list)) {
+            for (const opt of checkbox.option_list) {
+                if (opt && typeof opt === "object" && "is_checked" in opt) {
+                    const fixed = coerceToBool(opt.is_checked);
+                    if (fixed !== undefined && opt.is_checked !== fixed) {
+                        fixes.push(`checkbox.option_list.is_checked: ${JSON.stringify(opt.is_checked)} → ${fixed}`);
+                        opt.is_checked = fixed;
+                    }
+                }
+            }
+        }
+    }
+    // ── source.desc_color ────────────────────────────────────────────────
+    const source = card.source;
+    if (source && typeof source === "object" && "desc_color" in source) {
+        const fixed = coerceToInt(source.desc_color);
+        if (fixed !== undefined && source.desc_color !== fixed) {
+            fixes.push(`source.desc_color: ${JSON.stringify(source.desc_color)} → ${fixed}`);
+            source.desc_color = fixed;
+        }
+    }
+    // ── card_action.type ─────────────────────────────────────────────────
+    const cardAction = card.card_action;
+    if (cardAction && typeof cardAction === "object" && "type" in cardAction) {
+        const fixed = coerceToInt(cardAction.type);
+        if (fixed !== undefined && cardAction.type !== fixed) {
+            fixes.push(`card_action.type: ${JSON.stringify(cardAction.type)} → ${fixed}`);
+            cardAction.type = fixed;
+        }
+    }
+    // ── quote_area.type ──────────────────────────────────────────────────
+    const quoteArea = card.quote_area;
+    if (quoteArea && typeof quoteArea === "object" && "type" in quoteArea) {
+        const fixed = coerceToInt(quoteArea.type);
+        if (fixed !== undefined && quoteArea.type !== fixed) {
+            fixes.push(`quote_area.type: ${JSON.stringify(quoteArea.type)} → ${fixed}`);
+            quoteArea.type = fixed;
+        }
+    }
+    // ── image_text_area.type ─────────────────────────────────────────────
+    const imageTextArea = card.image_text_area;
+    if (imageTextArea && typeof imageTextArea === "object" && "type" in imageTextArea) {
+        const fixed = coerceToInt(imageTextArea.type);
+        if (fixed !== undefined && imageTextArea.type !== fixed) {
+            fixes.push(`image_text_area.type: ${JSON.stringify(imageTextArea.type)} → ${fixed}`);
+            imageTextArea.type = fixed;
+        }
+    }
+    // ── horizontal_content_list[].type ───────────────────────────────────
+    if (Array.isArray(card.horizontal_content_list)) {
+        for (const item of card.horizontal_content_list) {
+            if (item && typeof item === "object" && "type" in item) {
+                const fixed = coerceToInt(item.type);
+                if (fixed !== undefined && item.type !== fixed) {
+                    fixes.push(`horizontal_content_list.type: ${JSON.stringify(item.type)} → ${fixed}`);
+                    item.type = fixed;
+                }
+            }
+        }
+    }
+    // ── jump_list[].type ─────────────────────────────────────────────────
+    if (Array.isArray(card.jump_list)) {
+        for (const item of card.jump_list) {
+            if (item && typeof item === "object" && "type" in item) {
+                const fixed = coerceToInt(item.type);
+                if (fixed !== undefined && item.type !== fixed) {
+                    fixes.push(`jump_list.type: ${JSON.stringify(item.type)} → ${fixed}`);
+                    item.type = fixed;
+                }
+            }
+        }
+    }
+    // ── button_list[].style ──────────────────────────────────────────────
+    if (Array.isArray(card.button_list)) {
+        for (const btn of card.button_list) {
+            if (btn && typeof btn === "object" && "style" in btn) {
+                const fixed = coerceToInt(btn.style);
+                if (fixed !== undefined && btn.style !== fixed) {
+                    fixes.push(`button_list.style: ${JSON.stringify(btn.style)} → ${fixed}`);
+                    btn.style = fixed;
+                }
+            }
+        }
+    }
+    // ── button_selection.disable ─────────────────────────────────────────
+    const buttonSelection = card.button_selection;
+    if (buttonSelection && typeof buttonSelection === "object" && "disable" in buttonSelection) {
+        const fixed = coerceToBool(buttonSelection.disable);
+        if (fixed !== undefined && buttonSelection.disable !== fixed) {
+            fixes.push(`button_selection.disable: ${JSON.stringify(buttonSelection.disable)} → ${fixed}`);
+            buttonSelection.disable = fixed;
+        }
+    }
+    // ── select_list[].disable ────────────────────────────────────────────
+    if (Array.isArray(card.select_list)) {
+        for (const sel of card.select_list) {
+            if (sel && typeof sel === "object" && "disable" in sel) {
+                const fixed = coerceToBool(sel.disable);
+                if (fixed !== undefined && sel.disable !== fixed) {
+                    fixes.push(`select_list.disable: ${JSON.stringify(sel.disable)} → ${fixed}`);
+                    sel.disable = fixed;
+                }
+            }
+        }
+    }
+    if (fixes.length > 0) {
+        log?.(`[template-card-parser] normalizeTemplateCardFields: ${fixes.length} fix(es) applied: ${fixes.join("; ")}`);
+    }
+    return card;
+}
+function validateAndFixRequiredFields(card, log) {
+    const cardType = card.card_type;
+    const fixes = [];
+    const warnings = [];
+    // ── task_id ─────────────────────────────
+    const rawTid = (typeof card.task_id === "string" && card.task_id.trim()) ? card.task_id.trim() : "";
+    const rand = Math.random().toString(36).slice(2, 6);
+    const ts = Date.now();
+    let finalTid;
+    if (rawTid) {
+        const prefix = rawTid.replace(/_\d{8,}$/, "").replace(/[^a-zA-Z0-9_\-@]/g, "_").slice(0, 80);
+        finalTid = prefix ? `${prefix}_${ts}_${rand}` : `task_${cardType}_${ts}_${rand}`;
+    }
+    else {
+        finalTid = `task_${cardType}_${ts}_${rand}`;
+    }
+    if (finalTid !== rawTid) {
+        fixes.push(`task_id: "${rawTid || "(missing)"}" → "${finalTid}"`);
+    }
+    card.task_id = finalTid;
+    // ── main_title ────────────────────────────────────────────────────────
+    const mainTitle = card.main_title;
+    const hasMainTitle = mainTitle && typeof mainTitle === "object" &&
+        (typeof mainTitle.title === "string" && mainTitle.title.trim());
+    const hasSubTitleText = typeof card.sub_title_text === "string" && card.sub_title_text.trim();
+    switch (cardType) {
+        case "text_notice":
+            if (!hasMainTitle && !hasSubTitleText) {
+                card.sub_title_text = card.sub_title_text || "通知";
+                fixes.push(`sub_title_text: (missing, no main_title either) → fallback "通知"`);
+            }
+            break;
+        case "news_notice":
+        case "button_interaction":
+        case "vote_interaction":
+        case "multiple_interaction":
+            if (!mainTitle || typeof mainTitle !== "object") {
+                card.main_title = { title: "通知" };
+                fixes.push(`main_title: (missing) → { title: "通知" }`);
+            }
+            else if (!hasMainTitle) {
+                mainTitle.title = "通知";
+                fixes.push(`main_title.title: (empty) → "通知"`);
+            }
+            break;
+    }
+    // ── card_action ──────────────────────────
+    if (cardType === "text_notice" || cardType === "news_notice") {
+        if (!card.card_action || typeof card.card_action !== "object") {
+            card.card_action = { type: 1, url: "https://work.weixin.qq.com" };
+            fixes.push(`card_action: (missing) → { type: 1, url: "https://work.weixin.qq.com" }`);
+        }
+    }
+    // ── submit_button ──────────────────────────
+    if (cardType === "vote_interaction" || cardType === "multiple_interaction") {
+        if (!card.submit_button || typeof card.submit_button !== "object") {
+            card.submit_button = { text: "提交", key: `submit_${cardType}_${Date.now()}` };
+            fixes.push(`submit_button: (missing) → auto-generated`);
+        }
+    }
+    // ── 核心业务字段告警 ──────────────────────────
+    if (cardType === "button_interaction") {
+        if (!Array.isArray(card.button_list) || card.button_list.length === 0) {
+            warnings.push(`button_list is missing or empty (required for button_interaction)`);
+        }
+    }
+    if (cardType === "vote_interaction") {
+        if (!card.checkbox || typeof card.checkbox !== "object") {
+            warnings.push(`checkbox is missing (required for vote_interaction)`);
+        }
+    }
+    if (cardType === "multiple_interaction") {
+        if (!Array.isArray(card.select_list) || card.select_list.length === 0) {
+            warnings.push(`select_list is missing or empty (required for multiple_interaction)`);
+        }
+    }
+    if (fixes.length > 0) {
+        log?.(`[template-card-parser] validateAndFixRequiredFields: ${fixes.length} fix(es): ${fixes.join("; ")}`);
+    }
+    if (warnings.length > 0) {
+        log?.(`[template-card-parser] validateAndFixRequiredFields: ${warnings.length} warning(s): ${warnings.join("; ")}`);
+    }
+    return card;
+}
+// ============================================================================
+// 简化格式 → 企微 API 格式转换
+// ============================================================================
+function generateKey(prefix) {
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `${prefix}_${Date.now()}_${rand}`;
+}
+function transformVoteInteraction(card, log) {
+    const existingCheckbox = card.checkbox;
+    if (existingCheckbox && typeof existingCheckbox === "object" && Array.isArray(existingCheckbox.option_list)) {
+        log?.(`[template-card-parser] transformVoteInteraction: already has checkbox.option_list, skipping transform`);
+        return card;
+    }
+    const options = card.options;
+    if (!Array.isArray(options) || options.length === 0) {
+        log?.(`[template-card-parser] transformVoteInteraction: no "options" array found, skipping transform`);
+        return card;
+    }
+    log?.(`[template-card-parser] transformVoteInteraction: transforming simplified format → API format`);
+    log?.(`[template-card-parser] transformVoteInteraction: input=${JSON.stringify(card)}`);
+    const title = card.title;
+    const description = card.description;
+    if (title || description) {
+        card.main_title = {
+            ...(title ? { title } : {}),
+            ...(description ? { desc: description } : {}),
+        };
+        delete card.title;
+        delete card.description;
+    }
+    const mode = coerceCheckboxMode(card.mode) ?? 0;
+    const questionKey = generateKey("vote");
+    const clampedOptions = options.slice(0, 20);
+    if (options.length > 20) {
+        log?.(`[template-card-parser] transformVoteInteraction: options count ${options.length} exceeds max 20, clamped to 20`);
+    }
+    card.checkbox = {
+        question_key: questionKey,
+        mode,
+        option_list: clampedOptions.map((opt) => ({
+            id: String(opt.id ?? opt.value ?? `opt_${Math.random().toString(36).slice(2, 6)}`),
+            text: String(opt.text ?? opt.label ?? opt.name ?? ""),
+        })),
+    };
+    delete card.options;
+    delete card.mode;
+    const submitText = card.submit_text || "提交";
+    card.submit_button = {
+        text: submitText,
+        key: generateKey("submit_vote"),
+    };
+    delete card.submit_text;
+    delete card.vote_question;
+    delete card.vote_option;
+    delete card.vote_options;
+    log?.(`[template-card-parser] transformVoteInteraction: output=${JSON.stringify(card)}`);
+    return card;
+}
+function transformMultipleInteraction(card, log) {
+    const existingSelectList = card.select_list;
+    if (Array.isArray(existingSelectList) &&
+        existingSelectList.length > 0 &&
+        Array.isArray(existingSelectList[0]?.option_list)) {
+        log?.(`[template-card-parser] transformMultipleInteraction: already has select_list[].option_list, skipping transform`);
+        return card;
+    }
+    const selectors = card.selectors;
+    if (!Array.isArray(selectors) || selectors.length === 0) {
+        log?.(`[template-card-parser] transformMultipleInteraction: no "selectors" array found, skipping transform`);
+        return card;
+    }
+    log?.(`[template-card-parser] transformMultipleInteraction: transforming simplified format → API format`);
+    log?.(`[template-card-parser] transformMultipleInteraction: input=${JSON.stringify(card)}`);
+    const title = card.title;
+    const description = card.description;
+    if (title || description) {
+        card.main_title = {
+            ...(title ? { title } : {}),
+            ...(description ? { desc: description } : {}),
+        };
+        delete card.title;
+        delete card.description;
+    }
+    const clampedSelectors = selectors.slice(0, 3);
+    if (selectors.length > 3) {
+        log?.(`[template-card-parser] transformMultipleInteraction: selectors count ${selectors.length} exceeds max 3, clamped to 3`);
+    }
+    card.select_list = clampedSelectors.map((sel, idx) => {
+        const selectorOptions = (sel.options ?? []).slice(0, 10);
+        return {
+            question_key: generateKey(`sel_${idx}`),
+            title: String(sel.title ?? sel.label ?? `选择${idx + 1}`),
+            option_list: selectorOptions.map((opt) => ({
+                id: String(opt.id ?? opt.value ?? `opt_${Math.random().toString(36).slice(2, 6)}`),
+                text: String(opt.text ?? opt.label ?? opt.name ?? ""),
+            })),
+        };
+    });
+    delete card.selectors;
+    const submitText = card.submit_text || "提交";
+    card.submit_button = {
+        text: submitText,
+        key: generateKey("submit_multi"),
+    };
+    delete card.submit_text;
+    log?.(`[template-card-parser] transformMultipleInteraction: output=${JSON.stringify(card)}`);
+    return card;
+}
+function transformSimplifiedCard(card, log) {
+    const cardType = card.card_type;
+    if (cardType === "vote_interaction") {
+        return transformVoteInteraction(card, log);
+    }
+    if (cardType === "multiple_interaction") {
+        return transformMultipleInteraction(card, log);
+    }
+    return card;
+}
+const CODE_BLOCK_RE = /```(?:json)?\s*\n([\s\S]*?)\n```/g;
+const CLOSED_BLOCK_RE = /```(?:json)?\s*\n([\s\S]*?)\n```/g;
+const UNCLOSED_BLOCK_RE = /```(?:json)?\s*\n[\s\S]*$/;
+/**
+ * 从文本中提取模板卡片 JSON 代码块
+ */
+function extractTemplateCards(text, log) {
+    const cards = [];
+    const blocksToRemove = [];
+    log?.(`[template-card-parser] extractTemplateCards called, textLength=${text.length}`);
+    let match;
+    CODE_BLOCK_RE.lastIndex = 0;
+    let blockIndex = 0;
+    while ((match = CODE_BLOCK_RE.exec(text)) !== null) {
+        const fullMatch = match[0];
+        const jsonContent = match[1].trim();
+        blockIndex++;
+        log?.(`[template-card-parser] Found code block #${blockIndex}, length=${fullMatch.length}, preview=${jsonContent.slice(0, 1000)}...`);
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonContent);
+        }
+        catch (e) {
+            log?.(`[template-card-parser] Code block #${blockIndex} JSON parse failed: ${String(e)}`);
+            continue;
+        }
+        const cardType = parsed.card_type;
+        if (typeof cardType !== "string" || !VALID_CARD_TYPES.includes(cardType)) {
+            log?.(`[template-card-parser] Code block #${blockIndex} has invalid card_type="${String(cardType)}", skipping`);
+            continue;
+        }
+        log?.(`[template-card-parser] Code block #${blockIndex} is valid template card, card_type="${cardType}"`);
+        transformSimplifiedCard(parsed, log);
+        normalizeTemplateCardFields(parsed, log);
+        validateAndFixRequiredFields(parsed, log);
+        cards.push({
+            cardJson: parsed,
+            cardType,
+        });
+        blocksToRemove.push(fullMatch);
+    }
+    let remainingText = text;
+    for (const block of blocksToRemove) {
+        remainingText = remainingText.replace(block, "");
+    }
+    remainingText = remainingText.replace(/\n{3,}/g, "\n\n").trim();
+    log?.(`[template-card-parser] Extraction done: ${cards.length} card(s) found, remainingTextLength=${remainingText.length}`);
+    return { cards, remainingText };
+}
+/**
+ * 遮罩文本中的模板卡片代码块（用于流式中间帧展示）
+ */
+function maskTemplateCardBlocks(text, log) {
+    let masked = text;
+    let closedMaskCount = 0;
+    let unclosedMasked = false;
+    CLOSED_BLOCK_RE.lastIndex = 0;
+    masked = masked.replace(CLOSED_BLOCK_RE, (fullMatch, content) => {
+        if (/["']card_type["']/.test(content)) {
+            closedMaskCount++;
+            return "\n\n📋 *正在生成卡片消息...*\n\n";
+        }
+        return fullMatch;
+    });
+    const unclosedMatch = UNCLOSED_BLOCK_RE.exec(masked);
+    if (unclosedMatch) {
+        const unclosedContent = unclosedMatch[0];
+        if (/["']card_type["']/.test(unclosedContent)) {
+            unclosedMasked = true;
+            masked = masked.slice(0, unclosedMatch.index) + "\n\n📋 *正在生成卡片消息...*";
+        }
+    }
+    if (closedMaskCount > 0 || unclosedMasked) {
+        log?.(`[template-card-parser] maskTemplateCardBlocks: closedMasked=${closedMaskCount}, unclosedMasked=${unclosedMasked}, textLength=${text.length}, maskedLength=${masked.length}`);
+    }
+    return masked;
+}
+
+export { extractTemplateCards, maskTemplateCardBlocks };

package/dist/esm/src/timeout.js

@@ -0,0 +1,38 @@
+/**
+ * 超时控制工具模块
+ *
+ * 为异步操作提供统一的超时保护机制
+ */
+/**
+ * 为 Promise 添加超时保护
+ *
+ * @param promise - 原始 Promise
+ * @param timeoutMs - 超时时间（毫秒）
+ * @param message - 超时错误消息
+ * @returns 带超时保护的 Promise
+ */
+function withTimeout(promise, timeoutMs, message) {
+    if (timeoutMs <= 0 || !Number.isFinite(timeoutMs)) {
+        return promise;
+    }
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new TimeoutError(message ?? `Operation timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]).finally(() => {
+        clearTimeout(timeoutId);
+    });
+}
+/**
+ * 超时错误类型
+ */
+class TimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}
+
+export { TimeoutError, withTimeout };

package/dist/esm/src/version.js

@@ -0,0 +1,22 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** 从 package.json 中读取版本号，兼容打包产物和直接运行 .ts 两种场景 */
+const getVersion = () => {
+    try {
+        // ESM 环境使用 import.meta.url，CJS 环境使用全局 __dirname
+        const currentDir = dirname(fileURLToPath(import.meta.url));
+        // 直接运行 .ts 时在 src/ 下，打包后在 dist/ 下，都向上一级找 package.json
+        const pkgPath = resolve(currentDir, "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        return pkg.version ?? "";
+    }
+    catch {
+        return "";
+    }
+};
+/** 插件版本号，来源于 package.json */
+const PLUGIN_VERSION = getVersion();
+
+export { PLUGIN_VERSION };

package/dist/esm/types/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @wecom/aibot-plugin — 企业微信私有部署 AI 机器人插件
+ *
+ * 独立运行的 Node.js 服务入口
+ *
+ * 启动流程：
+ * 1. 解析命令行参数，确定配置文件路径
+ * 2. 加载 JSON 配置文件
+ * 3. 注入 CA 证书（如配置）
+ * 4. 启动 Express HTTP 服务
+ * 5. 为每个启用的账号创建 WSClient 连接
+ * 6. 注册进程信号处理（SIGINT/SIGTERM 优雅退出）
+ */
+export {};

package/dist/esm/types/src/adapters/anthropic-adapter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Anthropic 适配器
+ *
+ * 适用于：Anthropic Claude 原生 API，以及阿里百炼、腾讯混元、MiniMax、
+ *         AWS Bedrock、Google Vertex AI 等提供 Anthropic Messages API 兼容接口的平台
+ *
+ * 与 OpenAI 的核心差异：
+ * - 接口路径：POST /v1/messages（而非 /v1/chat/completions）
+ * - 系统提示词：顶层 system 字段（而非 messages[0].role = "system"）
+ * - 认证方式：x-api-key 头（而非 Authorization: Bearer）
+ * - 响应结构：content[] 块数组（而非 choices[0].message.content 字符串）
+ * - 流式格式：多事件类型（message_start → content_block_delta → message_stop）
+ * - 思维链：原生 type: "thinking" 块（而非私有 reasoning_content 字段）
+ * - 必填字段：max_tokens（OpenAI 可选）
+ *
+ * 推理内容折叠展示格式（collapse 模式，复用 DeepSeek 策略）：
+ * <think>
+ * {thinking}
+ * </think>
+ *
+ * {content}
+ */
+import type { AgentEndpoint } from "../interface.js";
+import { BaseAdapter } from "./base-adapter.js";
+import type { AdapterRequest, AdapterCallbacks } from "./types.js";
+/**
+ * Anthropic 适配器
+ */
+export declare class AnthropicAdapter extends BaseAdapter {
+    readonly name = "anthropic";
+    readonly displayName = "Anthropic";
+    /**
+     * 获取 Anthropic 配置选项
+     */
+    private getOptions;
+    /**
+     * 获取推理内容展示模式
+     */
+    private getReasoningDisplayMode;
+    /**
+     * 规范化 Anthropic API URL
+     *
+     * 用户可能配置为 base URL（如 https://api.minimaxi.com/anthropic）
+     * 或完整路径（如 https://api.anthropic.com/v1/messages）。
+     * 如果 URL 不以 /v1/messages 结尾，则自动拼接。
+     */
+    private normalizeUrl;
+    /**
+     * 构建 Anthropic 请求头
+     *
+     * 认证方式：
+     * - useXApiKey=true（默认）：使用 x-api-key 头（Anthropic 原生）
+     * - useXApiKey=false：使用 Authorization: Bearer（第三方兼容平台）
+     */
+    protected buildHeaders(endpoint: AgentEndpoint): Record<string, string>;
+    /**
+     * 转发请求到 Anthropic Messages API
+     */
+    forward(request: AdapterRequest, endpoint: AgentEndpoint, callbacks: AdapterCallbacks): Promise<string>;
+    /**
+     * 构建 Anthropic messages 数组
+     *
+     * 与 OpenAI 的差异：
+     * - 系统提示词不在 messages 中，而是顶层 system 字段（在 buildRequestBody 中处理）
+     * - 图片使用 { type: "image", source: { type: "base64", ... } } 格式
+     * - 不支持 role: "system"，只有 "user" 和 "assistant"
+     */
+    private buildMessages;
+    /**
+     * 构建 Anthropic 请求体
+     */
+    private buildRequestBody;
+    /**
+     * 处理 Anthropic 流式响应
+     *
+     * Anthropic SSE 事件流程：
+     * message_start → content_block_start → content_block_delta(多次) →
+     * content_block_stop → ... → message_delta → message_stop
+     */
+    private handleStreamResponse;
+    /**
+     * 处理 Anthropic 非流式响应
+     *
+     * 遍历 content[] 数组，按 type 提取 text 和 thinking 内容
+     */
+    private handleNonStreamResponse;
+    /**
+     * 格式化最终输出（根据 displayMode 配置）
+     *
+     * 复用 DeepSeek 的 show/hide/collapse 策略
+     */
+    private formatOutput;
+}