@lutery/vision-mcp 1.0.0

package/dist/utils/image-input.js

@@ -0,0 +1,238 @@
+/**
+ * Image Input Normalization Utility
+ *
+ * @description 统一处理图片输入：支持 URL、base64(data URL) 和本地路径
+ */
+import { readFile } from 'fs/promises';
+import { InvalidInputError, ImageLoadError, VisionMCPError } from './errors.js';
+import { logger } from './logger.js';
+/**
+ * 支持的图片 MIME 类型
+ * 仅支持 GLM 和 SiliconFlow 明确支持的格式（保守列表）
+ * D-002: Only support image input types supported by GLM/SiliconFlow
+ */
+const SUPPORTED_MIME_TYPES = [
+    'image/jpeg',
+    'image/jpg',
+    'image/png',
+    'image/webp'
+];
+/**
+ * 文件扩展名到 MIME 类型的映射
+ * 仅支持 GLM 和 SiliconFlow 明确支持的格式
+ */
+const EXT_TO_MIME_TYPE = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.webp': 'image/webp'
+};
+/**
+ * 检测输入类型
+ */
+export function detectInputType(input) {
+    // 检测 base64 data URL
+    if (input.startsWith('data:image/') && input.includes(';base64,')) {
+        return 'base64';
+    }
+    // 检测 URL（http 或 https）
+    if (input.startsWith('http://') || input.startsWith('https://')) {
+        return 'url';
+    }
+    // 其他情况视为本地路径
+    return 'local';
+}
+/**
+ * 从文件扩展名获取 MIME 类型
+ */
+export function getMimeTypeFromFileName(filename) {
+    const ext = filename.toLowerCase().substring(filename.lastIndexOf('.'));
+    const mimeType = EXT_TO_MIME_TYPE[ext];
+    if (!mimeType) {
+        throw new InvalidInputError(`Unsupported file extension: ${ext}`, { filename, supportedExtensions: Object.keys(EXT_TO_MIME_TYPE) });
+    }
+    return mimeType;
+}
+/**
+ * 从 data URL 提取 MIME 类型
+ */
+export function getMimeTypeFromDataUrl(dataUrl) {
+    const match = dataUrl.match(/^data:(image\/[^;]+);base64,/i);
+    if (!match) {
+        throw new InvalidInputError('Invalid data URL format. Expected: data:image/*;base64,...', { dataUrl });
+    }
+    const mimeType = match[1].toLowerCase();
+    if (!SUPPORTED_MIME_TYPES.includes(mimeType)) {
+        throw new InvalidInputError(`Unsupported image MIME type: ${mimeType}`, { supportedTypes: SUPPORTED_MIME_TYPES });
+    }
+    return mimeType;
+}
+/**
+ * 检测 URL 是否指向图片文件
+ */
+export function isImageUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        const pathname = urlObj.pathname.toLowerCase();
+        return Object.keys(EXT_TO_MIME_TYPE).some(ext => pathname.endsWith(ext));
+    }
+    catch {
+        // 无效的 URL
+        return false;
+    }
+}
+/**
+ * 规范化图片输入为统一的 data URL 格式
+ */
+export async function normalizeImageInput(input) {
+    const type = detectInputType(input);
+    // 默认启用严格 URL 验证（符合 D-002），可通过 VISION_STRICT_URL_VALIDATION=false 禁用
+    const strictValidation = process.env.VISION_STRICT_URL_VALIDATION !== 'false';
+    logger.debug('Normalizing image input', {
+        type,
+        inputLength: input.length,
+        strictValidation
+    });
+    try {
+        switch (type) {
+            case 'base64':
+                return await normalizeBase64Input(input);
+            case 'url':
+                return await normalizeUrlInput(input, strictValidation);
+            case 'local':
+                return await normalizeLocalInput(input);
+            default:
+                throw new InvalidInputError(`Unsupported input type: ${type}`, { input, detectedType: type });
+        }
+    }
+    catch (error) {
+        if (error instanceof VisionMCPError) {
+            throw error;
+        }
+        throw new ImageLoadError(`Failed to normalize image input`, { input, type }, error);
+    }
+}
+/**
+ * 规范化 base64 data URL 输入
+ */
+async function normalizeBase64Input(input) {
+    try {
+        // 验证格式
+        if (!input.includes(',') || input.split(',').length !== 2) {
+            throw new InvalidInputError('Invalid data URL format. Expected: data:image/*;base64,DATA');
+        }
+        const mimeType = getMimeTypeFromDataUrl(input);
+        const dataPart = input.split(',')[1];
+        // 验证 base64 数据
+        if (!dataPart || dataPart.length === 0) {
+            throw new InvalidInputError('No base64 data found in data URL');
+        }
+        logger.debug('Base64 input validated', { mimeType, dataLength: dataPart.length });
+        return {
+            type: 'base64',
+            originalInput: input,
+            dataUrl: input,
+            mimeType
+        };
+    }
+    catch (error) {
+        throw new ImageLoadError('Invalid base64 data URL', { input }, error);
+    }
+}
+/**
+ * 规范化 URL 输入
+ *
+ * @description 当前直接返回 URL，实际场景中可以下载并转换为 base64
+ */
+async function normalizeUrlInput(input, strictValidation) {
+    try {
+        // 验证 URL 格式
+        const url = new URL(input);
+        if (!url.protocol.startsWith('http')) {
+            throw new InvalidInputError('Only HTTP/HTTPS URLs are supported', { protocol: url.protocol });
+        }
+        // 检测是否为图片 URL
+        if (!isImageUrl(input)) {
+            if (strictValidation) {
+                throw new InvalidInputError(`URL does not have a supported image extension (allowed: ${Object.keys(EXT_TO_MIME_TYPE).join(', ')})`, { url: input });
+            }
+            else {
+                logger.warn('URL does not appear to point to an image file', { url: input });
+                logger.warn('Set VISION_STRICT_URL_VALIDATION=true to enforce strict validation', { url: input });
+            }
+        }
+        logger.debug('URL input validated', { url: input, strictValidation });
+        // 注意：SiliconFlow 和 GLM 都直接支持 URL
+        // 这里我们保持为 URL 格式，适配器会处理
+        return {
+            type: 'url',
+            originalInput: input,
+            dataUrl: input, // 保持为 URL
+            mimeType: 'image/*' // 实际类型由模型确定
+        };
+    }
+    catch (error) {
+        if (error instanceof TypeError) {
+            throw new InvalidInputError('Invalid URL format', { input }, error);
+        }
+        throw new ImageLoadError('Failed to process URL input', { input }, error);
+    }
+}
+/**
+ * 规范化本地文件路径输入
+ *
+ * @description 读取本地文件并转换为 base64 data URL
+ */
+async function normalizeLocalInput(input) {
+    try {
+        logger.debug('Reading local file', { path: input });
+        // 读取文件
+        const fileBuffer = await readFile(input);
+        if (fileBuffer.length === 0) {
+            throw new ImageLoadError('File is empty', { path: input });
+        }
+        // 检测 MIME 类型
+        const mimeType = getMimeTypeFromFileName(input);
+        // 转换为 base64
+        const base64Data = fileBuffer.toString('base64');
+        const dataUrl = `data:${mimeType};base64,${base64Data}`;
+        logger.debug('Local file converted to base64', {
+            path: input,
+            mimeType,
+            size: fileBuffer.length,
+            dataUrlLength: dataUrl.length
+        });
+        return {
+            type: 'local',
+            originalInput: input,
+            dataUrl,
+            mimeType
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new ImageLoadError('File not found', { path: input }, error);
+        }
+        if (error.code === 'EACCES') {
+            throw new ImageLoadError('Permission denied reading file', { path: input }, error);
+        }
+        throw new ImageLoadError('Failed to read local file', { path: input }, error);
+    }
+}
+/**
+ * 获取图片大小信息（用于日志）
+ */
+export function getImageSizeInfo(dataUrl) {
+    try {
+        const base64Data = dataUrl.includes(',')
+            ? dataUrl.split(',')[1]
+            : dataUrl;
+        // 计算大小（base64 编码的原始数据）
+        const decodedSize = Math.floor(base64Data.length * 0.75);
+        return { size: decodedSize };
+    }
+    catch {
+        return { size: 0 };
+    }
+}
+//# sourceMappingURL=image-input.js.map

package/dist/utils/image-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-input.js","sourceRoot":"","sources":["../../src/utils/image-input.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Logger Utility
+ *
+ * @description 统一的日志工具，确保只使用 stdout 输出
+ * 符合 MCP 协议要求：stdout 用于 JSON-RPC 通信，日志使用 stderr
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export interface LogEntry {
+    timestamp: string;
+    level: keyof typeof LogLevel;
+    message: string;
+    requestId?: string;
+    modelType?: string;
+    latency?: number;
+    [key: string]: any;
+}
+export declare class Logger {
+    private static instance;
+    private logLevel;
+    private constructor();
+    static getInstance(): Logger;
+    /**
+     * 写入日志到 stderr
+     * @param entry 日志条目
+     */
+    private write;
+    /**
+     * 记录 DEBUG 级别日志
+     */
+    debug(message: string, meta?: Record<string, any>): void;
+    /**
+     * 记录 INFO 级别日志
+     */
+    info(message: string, meta?: Record<string, any>): void;
+    /**
+     * 记录 WARN 级别日志
+     */
+    warn(message: string, meta?: Record<string, any>): void;
+    /**
+     * 记录 ERROR 级别日志
+     */
+    error(message: string, error?: Error | unknown, meta?: Record<string, any>): void;
+    /**
+     * 为请求添加上下文信息的日志记录
+     */
+    logRequest(message: string, context: {
+        requestId?: string;
+        modelType?: string;
+        latency?: number;
+        [key: string]: any;
+    }): void;
+}
+export declare const logger: Logger;
+/**
+ * 装饰器：记录函数执行时间和错误
+ */
+export declare function withLogging(target: any, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,OAAO,QAAQ,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO;WAkBO,WAAW,IAAI,MAAM;IAOnC;;;OAGG;IACH,OAAO,CAAC,KAAK;IAKb;;OAEG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAW/D;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAW9D;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAW9D;;OAEG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAyBxF;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GAAG,IAAI;CAUT;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC;AAE3C;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,sBAgC3F"}

package/dist/utils/logger.js

@@ -0,0 +1,157 @@
+/**
+ * Logger Utility
+ *
+ * @description 统一的日志工具，确保只使用 stdout 输出
+ * 符合 MCP 协议要求：stdout 用于 JSON-RPC 通信，日志使用 stderr
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    static instance;
+    logLevel;
+    constructor() {
+        // 从环境变量读取日志级别，默认为 INFO
+        const envLevel = process.env.LOG_LEVEL?.toUpperCase();
+        switch (envLevel) {
+            case 'DEBUG':
+                this.logLevel = LogLevel.DEBUG;
+                break;
+            case 'WARN':
+                this.logLevel = LogLevel.WARN;
+                break;
+            case 'ERROR':
+                this.logLevel = LogLevel.ERROR;
+                break;
+            default:
+                this.logLevel = LogLevel.INFO;
+        }
+    }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    /**
+     * 写入日志到 stderr
+     * @param entry 日志条目
+     */
+    write(entry) {
+        // MCP 协议要求：stdout 用于 JSON-RPC，日志必须使用 stderr
+        console.error(JSON.stringify(entry));
+    }
+    /**
+     * 记录 DEBUG 级别日志
+     */
+    debug(message, meta) {
+        if (this.logLevel <= LogLevel.DEBUG) {
+            this.write({
+                timestamp: new Date().toISOString(),
+                level: 'DEBUG',
+                message,
+                ...meta
+            });
+        }
+    }
+    /**
+     * 记录 INFO 级别日志
+     */
+    info(message, meta) {
+        if (this.logLevel <= LogLevel.INFO) {
+            this.write({
+                timestamp: new Date().toISOString(),
+                level: 'INFO',
+                message,
+                ...meta
+            });
+        }
+    }
+    /**
+     * 记录 WARN 级别日志
+     */
+    warn(message, meta) {
+        if (this.logLevel <= LogLevel.WARN) {
+            this.write({
+                timestamp: new Date().toISOString(),
+                level: 'WARN',
+                message,
+                ...meta
+            });
+        }
+    }
+    /**
+     * 记录 ERROR 级别日志
+     */
+    error(message, error, meta) {
+        if (this.logLevel <= LogLevel.ERROR) {
+            const logEntry = {
+                timestamp: new Date().toISOString(),
+                level: 'ERROR',
+                message,
+                ...meta
+            };
+            if (error) {
+                if (error instanceof Error) {
+                    logEntry.error = {
+                        name: error.name,
+                        message: error.message,
+                        stack: error.stack
+                    };
+                }
+                else {
+                    logEntry.error = String(error);
+                }
+            }
+            this.write(logEntry);
+        }
+    }
+    /**
+     * 为请求添加上下文信息的日志记录
+     */
+    logRequest(message, context) {
+        const { requestId, modelType, latency, ...rest } = context;
+        this.info(message, {
+            ...(requestId && { requestId }),
+            ...(modelType && { modelType }),
+            ...(latency !== undefined && { latency }),
+            ...rest
+        });
+    }
+}
+// 导出单例实例
+export const logger = Logger.getInstance();
+/**
+ * 装饰器：记录函数执行时间和错误
+ */
+export function withLogging(target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function (...args) {
+        const startTime = Date.now();
+        const requestId = Math.random().toString(36).substring(7);
+        logger.debug(`[${propertyKey}] Starting execution`, { requestId });
+        try {
+            const result = await originalMethod.apply(this, args);
+            const latency = Date.now() - startTime;
+            logger.logRequest(`[${propertyKey}] Completed successfully`, {
+                requestId,
+                latency
+            });
+            return result;
+        }
+        catch (error) {
+            const latency = Date.now() - startTime;
+            logger.error(`[${propertyKey}] Execution failed`, error, {
+                requestId,
+                latency
+            });
+            throw error;
+        }
+    };
+    return descriptor;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/thinking-extractors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Thinking Extractor Functions
+ *
+ * @description Independent module for thinking content extraction functions.
+ * Separated to avoid circular dependencies with provider-registry.ts.
+ */
+/**
+ * Re-export the type for backward compatibility
+ * This type is defined here to avoid importing thinking-filter.ts
+ */
+export interface ModelResponseEnvelope {
+    content: string;
+    reasoning?: string;
+    thinking?: string;
+    rawResponse?: unknown;
+}
+/**
+ * Type for extracting thinking content from raw model responses
+ */
+export type ThinkingExtractor = (rawResponse: unknown) => ModelResponseEnvelope;
+/**
+ * Extracts thinking content from GLM-4.6V model responses
+ */
+export declare function extractGLMThinking(rawResponse: unknown): ModelResponseEnvelope;
+/**
+ * Extracts thinking content from OpenAI-compatible responses (SiliconFlow)
+ */
+export declare function extractOpenAIThinking(rawResponse: unknown): ModelResponseEnvelope;
+/**
+ * Extracts thinking content from Claude Messages API responses
+ * Claude response format: { content: [{type: "text", text: "..."}], usage: {...} }
+ */
+export declare function extractClaudeThinking(rawResponse: unknown): ModelResponseEnvelope;
+//# sourceMappingURL=thinking-extractors.d.ts.map

package/dist/utils/thinking-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-extractors.d.ts","sourceRoot":"","sources":["../../src/utils/thinking-extractors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,WAAW,EAAE,OAAO,KAAK,qBAAqB,CAAC;AAEhF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,OAAO,GAAG,qBAAqB,CAkB9E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,GAAG,qBAAqB,CAkBjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,GAAG,qBAAqB,CA4BjF"}

package/dist/utils/thinking-extractors.js

@@ -0,0 +1,83 @@
+/**
+ * Thinking Extractor Functions
+ *
+ * @description Independent module for thinking content extraction functions.
+ * Separated to avoid circular dependencies with provider-registry.ts.
+ */
+import { logger } from './logger.js';
+/**
+ * Extracts thinking content from GLM-4.6V model responses
+ */
+export function extractGLMThinking(rawResponse) {
+    try {
+        // @ts-ignore - Access response structure
+        const choice = rawResponse?.choices?.[0];
+        const message = choice?.message || {};
+        return {
+            content: message.content || '',
+            reasoning: message.reasoning || message.thinking || '',
+            rawResponse
+        };
+    }
+    catch (error) {
+        logger.warn('Failed to extract GLM thinking content', { error });
+        return {
+            content: '',
+            rawResponse
+        };
+    }
+}
+/**
+ * Extracts thinking content from OpenAI-compatible responses (SiliconFlow)
+ */
+export function extractOpenAIThinking(rawResponse) {
+    try {
+        // @ts-ignore - Access response structure
+        const choice = rawResponse?.choices?.[0];
+        const message = choice?.message || {};
+        return {
+            content: message.content || '',
+            reasoning: message.reasoning || '',
+            rawResponse
+        };
+    }
+    catch (error) {
+        logger.warn('Failed to extract OpenAI thinking content', { error });
+        return {
+            content: '',
+            rawResponse
+        };
+    }
+}
+/**
+ * Extracts thinking content from Claude Messages API responses
+ * Claude response format: { content: [{type: "text", text: "..."}], usage: {...} }
+ */
+export function extractClaudeThinking(rawResponse) {
+    try {
+        // @ts-ignore - Access response structure
+        const contentBlocks = rawResponse?.content || [];
+        // 提取所有文本内容
+        const textParts = contentBlocks
+            .filter((block) => block?.type === 'text')
+            .map((block) => block?.text || '')
+            .filter(Boolean);
+        const content = textParts.join('\n\n');
+        // Claude 的 extended thinking 可能返回在 thinking 字段中
+        // 但大多数情况下不会单独返回，而是混在 content 中
+        // stripThinking 会处理这种情况
+        return {
+            content,
+            reasoning: rawResponse?.thinking || '',
+            rawResponse
+        };
+    }
+    catch (error) {
+        logger.warn('Failed to extract Claude thinking content', { error });
+        return {
+            content: '',
+            rawResponse
+        };
+    }
+}
+//# sourceMappingURL=thinking-extractors.js.map

package/dist/utils/thinking-extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-extractors.js","sourceRoot":"","sources":["../../src/utils/thinking-extractors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAkBrC;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,MAAM,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;QAEtC,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE;YACtD,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW;SACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAoB;IACxD,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,MAAM,GAAG,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;QAEtC,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAClC,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW;SACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAoB;IACxD,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,aAAa,GAAG,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;QAEjD,WAAW;QACX,MAAM,SAAS,GAAG,aAAa;aAC5B,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM,CAAC;aAC9C,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;aACtC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvC,gDAAgD;QAChD,+BAA+B;QAC/B,wBAAwB;QACxB,OAAO;YACL,OAAO;YACP,SAAS,EAAG,WAAmB,EAAE,QAAQ,IAAI,EAAE;YAC/C,WAAW;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW;SACZ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/thinking-filter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Thinking/Reasoning Content Filter
+ *
+ * @description Filters thinking/reasoning content from model responses to prevent
+ * exposing internal reasoning to MCP clients. Supports multiple models and response formats.
+ *
+ * Architecture Decision: Keep thinking enabled at model level but strip reasoning
+ * content before returning to MCP client.
+ */
+import { ModelResponseEnvelope, ThinkingExtractor } from './thinking-extractors.js';
+export type { ModelResponseEnvelope, ThinkingExtractor };
+/**
+ * Registry of thinking extractors by model type
+ * Uses imported extractor functions to avoid circular dependencies
+ */
+export declare const THINKING_EXTRACTORS: Record<string, ThinkingExtractor>;
+/**
+ * Strips thinking content from model response envelope
+ * @param envelope - Response envelope that may contain thinking content
+ * @returns Cleaned content string with all thinking content removed
+ */
+export declare function stripThinking(envelope: ModelResponseEnvelope): string;
+/**
+ * Filters thinking content from raw model response
+ * This is the main entry point for filtering thinking content
+ *
+ * @param rawResponse - The raw response from the model API
+ * @param modelType - The type of model (e.g., 'glm-4.6v', 'siliconflow')
+ * @returns Cleaned content string with thinking content removed
+ */
+export declare function filterThinkingContent(rawResponse: unknown, modelType: string): string;
+//# sourceMappingURL=thinking-filter.d.ts.map

package/dist/utils/thinking-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-filter.d.ts","sourceRoot":"","sources":["../../src/utils/thinking-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAIlB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;AAsBzD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAOjE,CAAC;AAuCF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAiCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgCrF"}