@reftrixmcp/mcp-server 0.1.8 → 0.2.0

package/dist/services/vision/theme.analyzer.js

@@ -1,315 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.themeAnalyzer = exports.ThemeAnalyzer = void 0;
-/**
- * ThemeAnalyzer - Vision AIによるテーマ検出サービス
- *
- * Phase 5 REFACTOR: E&A Financialサイトの誤認識問題を解決
- *
- * 問題背景:
- * - E&A Financialサイト (#0A1628 ダークブルー) が "Light/Mixed" と誤認識された
- * - 原因: Vision AIプロンプトのテーマ判定基準が曖昧
- *
- * 解決策:
- * - テーマ判定専用のVision AIプロンプトを追加（明確な輝度基準を含む）
- * - Vision AIとピクセルベース検出を比較するフォールバック戦略
- * - 不一致時はピクセルベース（高信頼度）を優先
- *
- * @module services/vision/theme.analyzer
- */
-const logger_1 = require("../../utils/logger");
-const ollama_vision_client_js_1 = require("./ollama-vision-client.js");
-const pixel_theme_detector_service_js_1 = require("../visual-extractor/pixel-theme-detector.service.js");
-const vision_prompts_js_1 = require("./vision.prompts.js");
-// =============================================================================
-// Constants
-// =============================================================================
-/**
- * Default Ollama URL
- */
-const DEFAULT_OLLAMA_URL = "http://localhost:11434";
-/**
- * Default timeout for Vision API calls (30 seconds)
- */
-const DEFAULT_TIMEOUT = 30000;
-/**
- * Default cache capacity
- */
-const DEFAULT_CACHE_CAPACITY = 100;
-/**
- * Default cache TTL (5 minutes)
- */
-const DEFAULT_CACHE_TTL = 5 * 60 * 1000;
-/**
- * Minimum confidence threshold for valid results
- */
-const MIN_CONFIDENCE_THRESHOLD = 0.6;
-/**
- * Maximum input size (5MB)
- */
-const MAX_INPUT_SIZE = 5 * 1024 * 1024;
-// =============================================================================
-// ThemeAnalyzer Class
-// =============================================================================
-/**
- * ThemeAnalyzer - Analyzes web page screenshots to detect visual theme
- *
- * Features:
- * - Vision AI-based theme detection with explicit luminance thresholds
- * - LRU caching with TTL for performance
- * - Fallback to pixel-based detection when Vision AI is unavailable
- * - Conflict resolution: pixel-based takes priority on disagreement
- */
-class ThemeAnalyzer {
-    client;
-    pixelDetector;
-    cache;
-    config;
-    constructor(config = {}) {
-        this.config = {
-            ollamaUrl: config.ollamaUrl ?? DEFAULT_OLLAMA_URL,
-            timeout: config.timeout ?? DEFAULT_TIMEOUT,
-            cacheCapacity: config.cacheCapacity ?? DEFAULT_CACHE_CAPACITY,
-            cacheTTL: config.cacheTTL ?? DEFAULT_CACHE_TTL,
-            enablePixelFallback: config.enablePixelFallback ?? true,
-        };
-        this.client = new ollama_vision_client_js_1.OllamaVisionClient({
-            ollamaUrl: this.config.ollamaUrl,
-            timeout: this.config.timeout,
-        });
-        this.pixelDetector = (0, pixel_theme_detector_service_js_1.createPixelThemeDetectorService)();
-        this.cache = new Map();
-    }
-    /**
-     * Analyze theme from screenshot using Vision AI
-     *
-     * @param screenshotBase64 - Screenshot image as Base64 string
-     * @param colorContext - Optional color context for improved accuracy
-     * @returns Theme analysis result or null if analysis fails
-     */
-    async analyze(screenshotBase64, colorContext) {
-        // Input validation
-        this.validateInput(screenshotBase64);
-        // Check cache
-        const cacheKey = this.generateCacheKey(screenshotBase64);
-        const cachedResult = this.getCachedResult(cacheKey);
-        if (cachedResult) {
-            return cachedResult;
-        }
-        try {
-            // Generate prompt
-            const prompt = colorContext
-                ? (0, vision_prompts_js_1.getThemeAnalysisWithContextPrompt)(colorContext)
-                : (0, vision_prompts_js_1.getThemeAnalysisPrompt)();
-            // Call Vision AI
-            const response = await this.client.generateJSON(prompt, screenshotBase64);
-            // Validate response
-            const result = this.parseVisionResponse(response);
-            if (!result) {
-                return null;
-            }
-            // Cache result
-            this.setCachedResult(cacheKey, result);
-            return result;
-        }
-        catch (error) {
-            if (process.env.NODE_ENV === "development") {
-                console.error("[ThemeAnalyzer] Vision AI error:", error);
-            }
-            return null;
-        }
-    }
-    /**
-     * Analyze theme with fallback strategy
-     *
-     * Strategy:
-     * 1. Try Vision AI first
-     * 2. Also run pixel-based detection
-     * 3. If results conflict, prefer pixel-based (more reliable for luminance)
-     * 4. If Vision AI fails, use pixel-based only
-     *
-     * @param screenshotBase64 - Screenshot image as Base64 string
-     * @param colorContext - Optional color context for improved accuracy
-     * @returns Theme analysis result (never null with fallback enabled)
-     */
-    async analyzeWithFallback(screenshotBase64, colorContext) {
-        // Input validation
-        this.validateInput(screenshotBase64);
-        // Check if pixel fallback is enabled
-        if (!this.config.enablePixelFallback) {
-            return this.analyze(screenshotBase64, colorContext);
-        }
-        // Run both detections in parallel
-        const [visionResult, pixelResult] = await Promise.all([
-            this.analyze(screenshotBase64, colorContext).catch(() => null),
-            this.runPixelDetection(screenshotBase64).catch(() => null),
-        ]);
-        // If Vision AI is unavailable, use pixel-based only
-        if (!visionResult && pixelResult) {
-            return this.convertPixelResult(pixelResult, false);
-        }
-        // If pixel detection failed, use Vision AI only
-        if (visionResult && !pixelResult) {
-            return visionResult;
-        }
-        // Both failed
-        if (!visionResult && !pixelResult) {
-            return null;
-        }
-        // Both succeeded - check for conflicts
-        if (visionResult && pixelResult) {
-            // If themes match, use Vision AI result (has more details)
-            if (visionResult.theme === pixelResult.theme) {
-                return visionResult;
-            }
-            // Conflict detected - prefer pixel-based (more reliable for luminance)
-            logger_1.logger.debug("[ThemeAnalyzer] Theme conflict detected:", {
-                visionTheme: visionResult.theme,
-                visionConfidence: visionResult.confidence,
-                pixelTheme: pixelResult.theme,
-                pixelConfidence: pixelResult.confidence,
-                decision: "Using pixel-based result",
-            });
-            // Use pixel-based result but mark that Vision AI was attempted
-            return this.convertPixelResult(pixelResult, false);
-        }
-        return null;
-    }
-    /**
-     * Check if Ollama Vision API is available
-     */
-    async isAvailable() {
-        return this.client.isAvailable();
-    }
-    // ===========================================================================
-    // Private Methods
-    // ===========================================================================
-    /**
-     * Validate input screenshot
-     */
-    validateInput(screenshotBase64) {
-        if (!screenshotBase64 || screenshotBase64.trim() === "") {
-            throw new Error("Screenshot is required");
-        }
-        // Check size (Base64 is ~33% larger than binary)
-        const estimatedSize = (screenshotBase64.length * 3) / 4;
-        if (estimatedSize > MAX_INPUT_SIZE) {
-            throw new Error(`Screenshot exceeds maximum size of 5MB (estimated: ${Math.round(estimatedSize / 1024 / 1024)}MB)`);
-        }
-        // Basic Base64 validation
-        if (!/^[A-Za-z0-9+/=]+$/.test(screenshotBase64.replace(/\s/g, ""))) {
-            throw new Error("Invalid Base64 encoding");
-        }
-    }
-    /**
-     * Parse and validate Vision AI response
-     */
-    parseVisionResponse(response) {
-        if (!response) {
-            return null;
-        }
-        // Validate required fields
-        if (!response.theme || typeof response.themeConfidence !== "number") {
-            return null;
-        }
-        // Validate theme value
-        const theme = response.theme.toLowerCase();
-        if (!vision_prompts_js_1.VALID_THEMES.includes(theme)) {
-            return null;
-        }
-        // Check confidence threshold
-        if (response.themeConfidence < MIN_CONFIDENCE_THRESHOLD) {
-            return null;
-        }
-        const result = {
-            theme,
-            confidence: response.themeConfidence,
-            primaryBackgroundColor: response.primaryBackgroundColor || "#000000",
-            visionAiUsed: true,
-        };
-        // Only add optional properties if they have values
-        if (response.reasoning) {
-            result.reasoning = response.reasoning;
-        }
-        if (response.visualFeatures) {
-            result.visualFeatures = response.visualFeatures;
-        }
-        return result;
-    }
-    /**
-     * Run pixel-based theme detection
-     */
-    async runPixelDetection(screenshotBase64) {
-        try {
-            return await this.pixelDetector.detectTheme(screenshotBase64);
-        }
-        catch (error) {
-            if (process.env.NODE_ENV === "development") {
-                console.error("[ThemeAnalyzer] Pixel detection error:", error);
-            }
-            return null;
-        }
-    }
-    /**
-     * Convert pixel detection result to ThemeAnalysisResult
-     */
-    convertPixelResult(pixelResult, visionAiUsed) {
-        return {
-            theme: pixelResult.theme,
-            confidence: pixelResult.confidence,
-            primaryBackgroundColor: pixelResult.dominantColors[0] || "#000000",
-            visionAiUsed,
-            reasoning: `Pixel-based detection: average luminance ${(pixelResult.averageLuminance * 100).toFixed(1)}%`,
-        };
-    }
-    /**
-     * Generate cache key from screenshot
-     */
-    generateCacheKey(screenshotBase64) {
-        // Use first 100 chars + length as simple hash
-        const prefix = screenshotBase64.substring(0, 100);
-        return `${prefix}_${screenshotBase64.length}`;
-    }
-    /**
-     * Get cached result if valid
-     */
-    getCachedResult(key) {
-        const entry = this.cache.get(key);
-        if (!entry) {
-            return null;
-        }
-        // Check TTL
-        if (Date.now() - entry.timestamp > this.config.cacheTTL) {
-            this.cache.delete(key);
-            return null;
-        }
-        return entry.result;
-    }
-    /**
-     * Set cached result with LRU eviction
-     */
-    setCachedResult(key, result) {
-        // LRU eviction if at capacity
-        if (this.cache.size >= this.config.cacheCapacity) {
-            const oldestKey = this.cache.keys().next().value;
-            if (oldestKey) {
-                this.cache.delete(oldestKey);
-            }
-        }
-        this.cache.set(key, {
-            result,
-            timestamp: Date.now(),
-        });
-    }
-}
-exports.ThemeAnalyzer = ThemeAnalyzer;
-// =============================================================================
-// Singleton Export
-// =============================================================================
-/**
- * Default ThemeAnalyzer instance
- */
-exports.themeAnalyzer = new ThemeAnalyzer();
-//# sourceMappingURL=theme.analyzer.js.map

package/dist/services/vision/theme.analyzer.js.map

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

package/dist/services/vision/timeout-calculator.d.ts

@@ -1,85 +0,0 @@
-/**
- * TimeoutCalculator - 動的タイムアウト計算
- *
- * Vision CPU完走保証 Phase 1: GPU/CPUおよび画像サイズに基づくタイムアウト計算
- *
- * タイムアウト値:
- * - GPU: 60秒 (60,000ms)
- * - CPU小画像 (< 100KB): 180秒 (180,000ms)
- * - CPU中画像 (100KB - 500KB): 600秒 (600,000ms)
- * - CPUフルページ (>= 500KB): 1200秒 (1,200,000ms)
- *
- * @see apps/mcp-server/tests/services/vision/timeout-calculator.test.ts
- */
-import { HardwareType, type HardwareInfo } from "./hardware-detector.js";
-export { HardwareType };
-/**
- * 画像サイズ分類
- */
-export declare enum ImageSize {
-    SMALL = "SMALL",
-    MEDIUM = "MEDIUM",
-    LARGE = "LARGE"
-}
-/**
- * タイムアウト定数（ミリ秒）
- */
-export declare const VisionTimeouts: {
-    /** GPU: 60秒 */
-    readonly GPU: 60000;
-    /** CPU小画像: 180秒（3分） */
-    readonly CPU_SMALL: 180000;
-    /** CPU中画像: 600秒（10分） */
-    readonly CPU_MEDIUM: 600000;
-    /** CPUフルページ: 1200秒（20分） */
-    readonly CPU_LARGE: 1200000;
-};
-/**
- * タイムアウト計算クラス
- *
- * ハードウェアタイプと画像サイズに基づいて適切なタイムアウトを計算。
- *
- * @example
- * ```typescript
- * const calculator = new TimeoutCalculator();
- * const timeout = calculator.calculate(HardwareType.CPU, 200_000);
- * console.log(calculator.formatTimeout(timeout)); // "10m 0s"
- * ```
- */
-export declare class TimeoutCalculator {
-    /**
-     * タイムアウトを計算
-     *
-     * @param hardwareType - ハードウェアタイプ（GPU/CPU）
-     * @param imageSizeBytes - 画像サイズ（バイト）、オプション
-     * @returns タイムアウト（ミリ秒）
-     */
-    calculate(hardwareType: HardwareType, imageSizeBytes?: number): number;
-    /**
-     * HardwareInfoオブジェクトからタイムアウトを計算
-     *
-     * @param info - ハードウェア情報
-     * @param imageSizeBytes - 画像サイズ（バイト）、オプション
-     * @returns タイムアウト（ミリ秒）
-     */
-    calculateFromHardwareInfo(info: HardwareInfo, imageSizeBytes?: number): number;
-    /**
-     * 画像サイズを分類
-     *
-     * - < 100KB: SMALL
-     * - 100KB - 500KB: MEDIUM
-     * - >= 500KB: LARGE
-     *
-     * @param bytes - 画像サイズ（バイト）
-     * @returns 画像サイズ分類
-     */
-    classifyImageSize(bytes?: number): ImageSize;
-    /**
-     * タイムアウトを人間が読みやすい形式にフォーマット
-     *
-     * @param ms - タイムアウト（ミリ秒）
-     * @returns フォーマットされた文字列（例: "10m 0s"）
-     */
-    formatTimeout(ms: number): string;
-}
-//# sourceMappingURL=timeout-calculator.d.ts.map

package/dist/services/vision/timeout-calculator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeout-calculator.d.ts","sourceRoot":"","sources":["../../../src/services/vision/timeout-calculator.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,CAAC;AAYxB;;GAEG;AACH,oBAAY,SAAS;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,eAAe;;IAEf,uBAAuB;;IAEvB,wBAAwB;;IAExB,2BAA2B;;CAEnB,CAAC;AAMX;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM;IAoBtE;;;;;;OAMG;IACH,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM;IAI9E;;;;;;;;;OASG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS;IAsB5C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;CAMlC"}

package/dist/services/vision/timeout-calculator.js

@@ -1,142 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutCalculator = exports.VisionTimeouts = exports.ImageSize = exports.HardwareType = void 0;
-/**
- * TimeoutCalculator - 動的タイムアウト計算
- *
- * Vision CPU完走保証 Phase 1: GPU/CPUおよび画像サイズに基づくタイムアウト計算
- *
- * タイムアウト値:
- * - GPU: 60秒 (60,000ms)
- * - CPU小画像 (< 100KB): 180秒 (180,000ms)
- * - CPU中画像 (100KB - 500KB): 600秒 (600,000ms)
- * - CPUフルページ (>= 500KB): 1200秒 (1,200,000ms)
- *
- * @see apps/mcp-server/tests/services/vision/timeout-calculator.test.ts
- */
-const hardware_detector_js_1 = require("./hardware-detector.js");
-Object.defineProperty(exports, "HardwareType", { enumerable: true, get: function () { return hardware_detector_js_1.HardwareType; } });
-// =============================================================================
-// 定数
-// =============================================================================
-/**
- * 画像サイズ境界値（バイト）
- */
-const IMAGE_SIZE_SMALL_THRESHOLD = 100_000; // 100KB
-const IMAGE_SIZE_LARGE_THRESHOLD = 500_000; // 500KB
-/**
- * 画像サイズ分類
- */
-var ImageSize;
-(function (ImageSize) {
-    ImageSize["SMALL"] = "SMALL";
-    ImageSize["MEDIUM"] = "MEDIUM";
-    ImageSize["LARGE"] = "LARGE";
-})(ImageSize || (exports.ImageSize = ImageSize = {}));
-/**
- * タイムアウト定数（ミリ秒）
- */
-exports.VisionTimeouts = {
-    /** GPU: 60秒 */
-    GPU: 60_000,
-    /** CPU小画像: 180秒（3分） */
-    CPU_SMALL: 180_000,
-    /** CPU中画像: 600秒（10分） */
-    CPU_MEDIUM: 600_000,
-    /** CPUフルページ: 1200秒（20分） */
-    CPU_LARGE: 1_200_000,
-};
-// =============================================================================
-// TimeoutCalculator クラス
-// =============================================================================
-/**
- * タイムアウト計算クラス
- *
- * ハードウェアタイプと画像サイズに基づいて適切なタイムアウトを計算。
- *
- * @example
- * ```typescript
- * const calculator = new TimeoutCalculator();
- * const timeout = calculator.calculate(HardwareType.CPU, 200_000);
- * console.log(calculator.formatTimeout(timeout)); // "10m 0s"
- * ```
- */
-class TimeoutCalculator {
-    /**
-     * タイムアウトを計算
-     *
-     * @param hardwareType - ハードウェアタイプ（GPU/CPU）
-     * @param imageSizeBytes - 画像サイズ（バイト）、オプション
-     * @returns タイムアウト（ミリ秒）
-     */
-    calculate(hardwareType, imageSizeBytes) {
-        // GPUは画像サイズに関係なく60秒
-        if (hardwareType === hardware_detector_js_1.HardwareType.GPU) {
-            return exports.VisionTimeouts.GPU;
-        }
-        // CPUの場合は画像サイズで判定
-        const imageSize = this.classifyImageSize(imageSizeBytes);
-        switch (imageSize) {
-            case ImageSize.SMALL:
-                return exports.VisionTimeouts.CPU_SMALL;
-            case ImageSize.LARGE:
-                return exports.VisionTimeouts.CPU_LARGE;
-            case ImageSize.MEDIUM:
-            default:
-                return exports.VisionTimeouts.CPU_MEDIUM;
-        }
-    }
-    /**
-     * HardwareInfoオブジェクトからタイムアウトを計算
-     *
-     * @param info - ハードウェア情報
-     * @param imageSizeBytes - 画像サイズ（バイト）、オプション
-     * @returns タイムアウト（ミリ秒）
-     */
-    calculateFromHardwareInfo(info, imageSizeBytes) {
-        return this.calculate(info.type, imageSizeBytes);
-    }
-    /**
-     * 画像サイズを分類
-     *
-     * - < 100KB: SMALL
-     * - 100KB - 500KB: MEDIUM
-     * - >= 500KB: LARGE
-     *
-     * @param bytes - 画像サイズ（バイト）
-     * @returns 画像サイズ分類
-     */
-    classifyImageSize(bytes) {
-        // undefined、0、負の値は中サイズとして扱う（デフォルト）
-        if (bytes === undefined) {
-            return ImageSize.MEDIUM;
-        }
-        // 負の値または0は小サイズ
-        if (bytes <= 0) {
-            return ImageSize.SMALL;
-        }
-        if (bytes < IMAGE_SIZE_SMALL_THRESHOLD) {
-            return ImageSize.SMALL;
-        }
-        if (bytes >= IMAGE_SIZE_LARGE_THRESHOLD) {
-            return ImageSize.LARGE;
-        }
-        return ImageSize.MEDIUM;
-    }
-    /**
-     * タイムアウトを人間が読みやすい形式にフォーマット
-     *
-     * @param ms - タイムアウト（ミリ秒）
-     * @returns フォーマットされた文字列（例: "10m 0s"）
-     */
-    formatTimeout(ms) {
-        const totalSeconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(totalSeconds / 60);
-        const seconds = totalSeconds % 60;
-        return `${minutes}m ${seconds}s`;
-    }
-}
-exports.TimeoutCalculator = TimeoutCalculator;
-//# sourceMappingURL=timeout-calculator.js.map

package/dist/services/vision/timeout-calculator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"timeout-calculator.js","sourceRoot":"","sources":["../../../src/services/vision/timeout-calculator.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;;;;;;;;;;GAYG;AAEH,iEAAyE;AAGhE,6FAHA,mCAAY,OAGA;AAErB,gFAAgF;AAChF,KAAK;AACL,gFAAgF;AAEhF;;GAEG;AACH,MAAM,0BAA0B,GAAG,OAAO,CAAC,CAAC,QAAQ;AACpD,MAAM,0BAA0B,GAAG,OAAO,CAAC,CAAC,QAAQ;AAEpD;;GAEG;AACH,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,8BAAiB,CAAA;IACjB,4BAAe,CAAA;AACjB,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB;AAED;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,eAAe;IACf,GAAG,EAAE,MAAM;IACX,uBAAuB;IACvB,SAAS,EAAE,OAAO;IAClB,wBAAwB;IACxB,UAAU,EAAE,OAAO;IACnB,2BAA2B;IAC3B,SAAS,EAAE,SAAS;CACZ,CAAC;AAEX,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,YAA0B,EAAE,cAAuB;QAC3D,oBAAoB;QACpB,IAAI,YAAY,KAAK,mCAAY,CAAC,GAAG,EAAE,CAAC;YACtC,OAAO,sBAAc,CAAC,GAAG,CAAC;QAC5B,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAEzD,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,SAAS,CAAC,KAAK;gBAClB,OAAO,sBAAc,CAAC,SAAS,CAAC;YAClC,KAAK,SAAS,CAAC,KAAK;gBAClB,OAAO,sBAAc,CAAC,SAAS,CAAC;YAClC,KAAK,SAAS,CAAC,MAAM,CAAC;YACtB;gBACE,OAAO,sBAAc,CAAC,UAAU,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,yBAAyB,CAAC,IAAkB,EAAE,cAAuB;QACnE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,KAAc;QAC9B,mCAAmC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;QAED,eAAe;QACf,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,KAAK,GAAG,0BAA0B,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,IAAI,KAAK,IAAI,0BAA0B,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,OAAO,SAAS,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,EAAU;QACtB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC;IACnC,CAAC;CACF;AAnFD,8CAmFC"}

package/dist/services/vision/vision-fallback.service.d.ts

@@ -1,121 +0,0 @@
-/**
- * VisionFallbackService - Vision CPU完走保証 Phase 3
- *
- * Graceful Degradation強化: Vision分析が失敗またはタイムアウトした場合に
- * HTML分析のみにフォールバックするサービス。
- *
- * 3つのフォールバック戦略:
- * 1. Vision timeout → HTML analysis only (warning logged)
- * 2. Vision failure (e.g., Ollama not running) → HTML analysis only (warning logged)
- * 3. No image → HTML analysis only (no warning, expected behavior)
- *
- * @see apps/mcp-server/tests/services/vision/vision-fallback.service.test.ts
- */
-import type { DetectedSection, SectionDetector } from "@reftrixmcp/webdesign-core";
-import type { LlamaVisionAdapter, VisionAnalysisResult } from "./llama-vision-adapter.js";
-/**
- * VisionFallbackServiceオプション
- */
-export interface VisionFallbackOptions {
-    /** Vision分析のタイムアウト（ミリ秒、デフォルト: 30000） */
-    visionTimeoutMs?: number;
-    /** Vision分析を強制するか（タイムアウト/エラー時にフォールバックせずエラーを返す） */
-    forceVision?: boolean;
-    /** Vision分析のプロンプト（オプション） */
-    visionPrompt?: string;
-}
-/**
- * HTML分析結果
- */
-export interface HTMLAnalysisResult {
-    /** 検出されたセクション */
-    sections: DetectedSection[];
-    /** HTML分析のエラー（発生した場合） */
-    error?: string;
-}
-/**
- * フォールバック結果
- */
-export interface FallbackResult {
-    /** 処理が成功したか */
-    success: boolean;
-    /** Vision分析が使用されたか */
-    visionUsed: boolean;
-    /** フォールバック理由（Vision未使用時） */
-    fallbackReason?: string;
-    /** HTML分析のみで処理されたか */
-    htmlAnalysisOnly: boolean;
-    /** Vision分析結果（成功時） */
-    visionAnalysis?: VisionAnalysisResult<string>;
-    /** HTML分析結果 */
-    htmlAnalysis: HTMLAnalysisResult;
-    /** パフォーマンスメトリクス */
-    metrics: {
-        /** 合計処理時間（ミリ秒） */
-        totalTimeMs: number;
-        /** Vision分析の試行時間（ミリ秒、試行した場合のみ） */
-        visionAttemptTimeMs?: number;
-        /** Visionがタイムアウトしたか */
-        visionTimedOut: boolean;
-    };
-}
-/**
- * VisionFallbackService設定
- */
-export interface VisionFallbackServiceConfig {
-    /** LlamaVisionAdapter（DI用） */
-    visionAdapter?: LlamaVisionAdapter;
-    /** SectionDetector（DI用） */
-    sectionDetector?: SectionDetector;
-    /** デフォルトタイムアウト（ミリ秒） */
-    defaultTimeoutMs?: number;
-}
-/**
- * VisionFallbackService - Graceful Degradation付きVision分析
- *
- * @example
- * ```typescript
- * const service = new VisionFallbackService();
- *
- * // 基本的な使用
- * const result = await service.analyzeWithFallback(imageBase64, html, {});
- *
- * if (result.visionUsed) {
- *   console.log('Vision analysis:', result.visionAnalysis);
- * } else {
- *   console.log('Fallback reason:', result.fallbackReason);
- * }
- *
- * // HTML分析は常に利用可能
- * console.log('Sections:', result.htmlAnalysis.sections);
- * ```
- */
-export declare class VisionFallbackService {
-    private readonly visionAdapter;
-    private readonly sectionDetector;
-    private readonly defaultTimeoutMs;
-    /**
-     * VisionFallbackServiceのコンストラクタ
-     *
-     * @param config - 設定オプション
-     */
-    constructor(config?: VisionFallbackServiceConfig);
-    /**
-     * Vision分析をフォールバック付きで実行
-     *
-     * @param image - Base64エンコードされた画像（空文字または未定義の場合はHTML分析のみ）
-     * @param html - 分析対象のHTML
-     * @param options - 分析オプション
-     * @returns フォールバック結果
-     */
-    analyzeWithFallback(image: string | undefined, html: string, options: VisionFallbackOptions): Promise<FallbackResult>;
-    /**
-     * Vision分析をタイムアウト付きで実行
-     */
-    private runVisionWithTimeout;
-    /**
-     * HTML分析を実行
-     */
-    private runHtmlAnalysis;
-}
-//# sourceMappingURL=vision-fallback.service.d.ts.map