@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/services/vision/llama-vision-adapter.js

@@ -1,307 +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.LlamaVisionAdapter = void 0;
-/**
- * LlamaVisionAdapter - Vision CPU完走保証 Phase 2
- *
- * ImageOptimizer、HardwareDetector、OllamaVisionClientを統合したアダプター。
- * CPU推論時に画像を自動最適化し、推論時間を短縮する。
- *
- * 機能:
- * - HardwareDetectorによるGPU/CPU自動検出
- * - CPU時の画像自動最適化（ImageOptimizer）
- * - 動的タイムアウト計算（TimeoutCalculator）
- * - Graceful Degradation（最適化失敗時は元画像で続行）
- * - パフォーマンスメトリクス収集
- *
- * @see apps/mcp-server/tests/services/vision/llama-vision-adapter.test.ts
- */
-const hardware_detector_js_1 = require("./hardware-detector.js");
-const image_optimizer_js_1 = require("./image-optimizer.js");
-const ollama_vision_client_js_1 = require("./ollama-vision-client.js");
-// =============================================================================
-// LlamaVisionAdapter クラス
-// =============================================================================
-/**
- * LlamaVisionAdapter - Vision CPU完走保証のためのアダプター
- *
- * @example
- * ```typescript
- * const adapter = new LlamaVisionAdapter();
- *
- * // 基本的な使用
- * const result = await adapter.analyze(imageBase64, 'Analyze this image');
- * console.log(result.response);
- * console.log(result.metrics.optimizationApplied);
- *
- * // JSON結果を取得
- * const jsonResult = await adapter.analyzeJSON<{ mood: string }>(imageBase64, 'Analyze mood');
- * console.log(jsonResult.response.mood);
- * ```
- */
-class LlamaVisionAdapter {
-    enableOptimization;
-    hardwareDetector;
-    imageOptimizer;
-    ollamaClient;
-    /**
-     * LlamaVisionAdapterのコンストラクタ
-     *
-     * @param config - 設定オプション
-     */
-    constructor(config) {
-        this.enableOptimization = config?.enableOptimization ?? true;
-        // Note: config.maxImageSizeBytes is accepted but not yet used
-        // Reserved for future size-based preprocessing limits
-        // 依存性注入（DI）対応
-        this.hardwareDetector =
-            config?.hardwareDetector ??
-                new hardware_detector_js_1.HardwareDetector(config?.ollamaUrl ? { ollamaUrl: config.ollamaUrl } : undefined);
-        this.imageOptimizer = config?.imageOptimizer ?? new image_optimizer_js_1.ImageOptimizer();
-        // OllamaVisionClientにはHardwareDetectorを注入（動的タイムアウト用）
-        this.ollamaClient =
-            config?.ollamaClient ??
-                new ollama_vision_client_js_1.OllamaVisionClient({
-                    ollamaUrl: config?.ollamaUrl,
-                    hardwareDetector: this.hardwareDetector,
-                });
-    }
-    // ===========================================================================
-    // パブリックメソッド
-    // ===========================================================================
-    /**
-     * 画像を分析してテキスト結果を返す
-     *
-     * @param image - Base64エンコードされた画像またはBuffer
-     * @param prompt - プロンプト文字列
-     * @param options - 分析オプション
-     * @returns 分析結果とメトリクス
-     */
-    async analyze(image, prompt, options) {
-        const startTime = performance.now();
-        // 画像をBase64文字列に変換
-        const { imageBase64, originalSizeBytes, isEmpty } = this.prepareImage(image);
-        // ハードウェア検出
-        const hardwareInfo = await this.detectHardware();
-        // 画像最適化の判定と実行
-        const optimizationResult = await this.maybeOptimize(imageBase64, originalSizeBytes, hardwareInfo, options, isEmpty);
-        // 使用する画像を決定
-        const imageToAnalyze = optimizationResult.optimizedImage ?? imageBase64;
-        const imageSizeForTimeout = optimizationResult.optimizedSizeBytes ?? originalSizeBytes;
-        // Ollama Vision API呼び出し
-        const response = await this.ollamaClient.generateWithImageSize(imageToAnalyze, prompt, imageSizeForTimeout);
-        // メトリクス作成
-        const totalProcessingTimeMs = Math.round(performance.now() - startTime);
-        const metrics = this.createMetrics(hardwareInfo, originalSizeBytes, optimizationResult, totalProcessingTimeMs);
-        return { response, metrics };
-    }
-    /**
-     * 画像を分析してJSON結果を返す
-     *
-     * @param image - Base64エンコードされた画像またはBuffer
-     * @param prompt - プロンプト文字列
-     * @param options - 分析オプション
-     * @returns 分析結果とメトリクス
-     */
-    async analyzeJSON(image, prompt, options) {
-        const startTime = performance.now();
-        // 画像をBase64文字列に変換
-        const { imageBase64, originalSizeBytes, isEmpty } = this.prepareImage(image);
-        // ハードウェア検出
-        const hardwareInfo = await this.detectHardware();
-        // 画像最適化の判定と実行
-        const optimizationResult = await this.maybeOptimize(imageBase64, originalSizeBytes, hardwareInfo, options, isEmpty);
-        // 使用する画像を決定
-        const imageToAnalyze = optimizationResult.optimizedImage ?? imageBase64;
-        const imageSizeForTimeout = optimizationResult.optimizedSizeBytes ?? originalSizeBytes;
-        // Ollama Vision API呼び出し（JSON）
-        const response = await this.ollamaClient.generateJSONWithImageSize(imageToAnalyze, prompt, imageSizeForTimeout);
-        // メトリクス作成
-        const totalProcessingTimeMs = Math.round(performance.now() - startTime);
-        const metrics = this.createMetrics(hardwareInfo, originalSizeBytes, optimizationResult, totalProcessingTimeMs);
-        return { response, metrics };
-    }
-    /**
-     * Ollamaサービスが利用可能かどうかをチェック
-     *
-     * @returns 利用可能な場合はtrue
-     */
-    async isAvailable() {
-        return this.ollamaClient.isAvailable();
-    }
-    // ===========================================================================
-    // プライベートメソッド
-    // ===========================================================================
-    /**
-     * 画像をBase64文字列に変換し、サイズを計算
-     */
-    prepareImage(image) {
-        if (Buffer.isBuffer(image)) {
-            return {
-                imageBase64: image.toString("base64"),
-                originalSizeBytes: image.length,
-                isEmpty: image.length === 0,
-            };
-        }
-        // Base64文字列の場合、デコードしてサイズを計算
-        // data:image/...;base64, プレフィックスがある場合は除去
-        const base64Data = image.replace(/^data:image\/[a-z]+;base64,/, "");
-        const sizeBytes = Math.ceil((base64Data.length * 3) / 4);
-        return {
-            imageBase64: base64Data,
-            originalSizeBytes: sizeBytes,
-            isEmpty: base64Data.length === 0,
-        };
-    }
-    /**
-     * ハードウェア情報を検出
-     */
-    async detectHardware() {
-        try {
-            return await this.hardwareDetector.detect();
-        }
-        catch (error) {
-            // ハードウェア検出失敗時はCPUフォールバック
-            if (process.env.NODE_ENV === "development") {
-                console.warn("[LlamaVisionAdapter] Hardware detection failed, falling back to CPU", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-            return {
-                type: hardware_detector_js_1.HardwareType.CPU,
-                vramBytes: 0,
-                isGpuAvailable: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    /**
-     * 最適化結果の型
-     */
-    async maybeOptimize(imageBase64, _originalSizeBytes, // Reserved for future use (e.g., size-based strategy selection)
-    hardwareInfo, options, isEmpty) {
-        // 空画像の場合はエラーを返す
-        if (isEmpty) {
-            return {
-                applied: false,
-                error: "Empty image provided",
-            };
-        }
-        // 最適化を無効にする条件をチェック
-        if (!this.shouldOptimize(hardwareInfo, options)) {
-            const skipReason = this.getOptimizationSkipReason(hardwareInfo, options);
-            return {
-                applied: false,
-                skipReason,
-            };
-        }
-        // ImageOptimizerで最適化を実行
-        try {
-            const result = await this.imageOptimizer.optimizeForCPU(imageBase64, {
-                hardwareType: hardwareInfo.type,
-            });
-            // 最適化がスキップされた場合
-            if (result.skipped) {
-                return {
-                    applied: false,
-                    skipReason: result.reason,
-                    error: result.error,
-                };
-            }
-            // 最適化成功
-            return {
-                applied: true,
-                optimizedImage: result.buffer.toString("base64"),
-                optimizedSizeBytes: result.optimizedSizeBytes,
-                compressionRatio: result.compressionRatio,
-                optimizationTimeMs: result.processingTimeMs,
-            };
-        }
-        catch (error) {
-            // 最適化失敗時はGraceful Degradation
-            if (process.env.NODE_ENV === "development") {
-                console.warn("[LlamaVisionAdapter] Image optimization failed, using original image", {
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-            return {
-                applied: false,
-                error: error instanceof Error ? error.message : String(error),
-            };
-        }
-    }
-    /**
-     * 最適化を実行すべきかどうかを判定
-     */
-    shouldOptimize(hardwareInfo, options) {
-        // グローバル設定で無効化されている場合
-        if (!this.enableOptimization) {
-            return false;
-        }
-        // オプションで無効化されている場合
-        if (options?.enableOptimization === false) {
-            return false;
-        }
-        // forceOriginalオプションが指定されている場合
-        if (options?.forceOriginal) {
-            return false;
-        }
-        // GPUの場合は最適化不要
-        if (hardwareInfo.type === hardware_detector_js_1.HardwareType.GPU) {
-            return false;
-        }
-        return true;
-    }
-    /**
-     * 最適化をスキップする理由を取得
-     */
-    getOptimizationSkipReason(hardwareInfo, options) {
-        if (!this.enableOptimization) {
-            return "Optimization disabled in config";
-        }
-        if (options?.enableOptimization === false) {
-            return "Optimization disabled by option";
-        }
-        if (options?.forceOriginal) {
-            return "forceOriginal option set";
-        }
-        if (hardwareInfo.type === hardware_detector_js_1.HardwareType.GPU) {
-            return "GPU detected, no optimization needed";
-        }
-        return undefined;
-    }
-    /**
-     * メトリクスを作成
-     */
-    createMetrics(hardwareInfo, originalSizeBytes, optimizationResult, totalProcessingTimeMs) {
-        const metrics = {
-            hardwareType: hardwareInfo.type,
-            originalSizeBytes,
-            optimizationApplied: optimizationResult.applied,
-            totalProcessingTimeMs,
-        };
-        // ハードウェア検出エラーがある場合
-        if (hardwareInfo.error) {
-            metrics.hardwareDetectionError = hardwareInfo.error;
-        }
-        // 最適化がスキップされた理由
-        if (optimizationResult.skipReason) {
-            metrics.optimizationSkipReason = optimizationResult.skipReason;
-        }
-        // 最適化エラー
-        if (optimizationResult.error) {
-            metrics.optimizationError = optimizationResult.error;
-        }
-        // 最適化が適用された場合の追加メトリクス
-        if (optimizationResult.applied) {
-            metrics.optimizedSizeBytes = optimizationResult.optimizedSizeBytes;
-            metrics.compressionRatio = optimizationResult.compressionRatio;
-            metrics.optimizationTimeMs = optimizationResult.optimizationTimeMs;
-        }
-        return metrics;
-    }
-}
-exports.LlamaVisionAdapter = LlamaVisionAdapter;
-//# sourceMappingURL=llama-vision-adapter.js.map

package/dist/services/vision/llama-vision-adapter.js.map

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

package/dist/services/vision/mcp-progress-adapter.d.ts

@@ -1,128 +0,0 @@
-/**
- * MCPProgressAdapter - MCP notifications/progress 統合
- *
- * Vision CPU完走保証 Phase 4: MCPツール進捗コールバック対応
- *
- * ProgressReporterの進捗イベントをMCP SDK の sendNotification を通じて
- * notifications/progress として送信するアダプター。
- *
- * MCP Protocol Specification:
- * - method: 'notifications/progress'
- * - params: { progressToken, progress, total?, message? }
- *
- * @see https://spec.modelcontextprotocol.io/specification/basic/utilities/progress/
- * @see apps/mcp-server/src/services/vision/progress-reporter.ts
- */
-import type { ProgressEvent, ProgressCallback } from "./progress-reporter.js";
-/**
- * MCP Progress Notification 型
- *
- * MCP SDK の ProgressNotificationSchema に準拠
- */
-export interface MCPProgressNotification {
-    method: "notifications/progress";
-    params: {
-        /** クライアントから提供された進捗トークン */
-        progressToken: string | number;
-        /** 現在の進捗値 */
-        progress: number;
-        /** 合計値（オプション、デフォルト100） */
-        total?: number;
-        /** 進捗メッセージ（オプション） */
-        message?: string;
-    };
-}
-/**
- * sendNotification 関数型
- *
- * MCP SDK の RequestHandlerExtra.sendNotification に準拠
- */
-export type SendNotificationFn = (notification: MCPProgressNotification) => Promise<void>;
-/**
- * MCPProgressAdapter オプション
- */
-export interface MCPProgressOptions {
-    /** MCP クライアントから提供された progressToken */
-    progressToken: string | number | undefined;
-    /** MCP SDK の sendNotification 関数 */
-    sendNotification: SendNotificationFn | undefined;
-    /** ログ出力を有効にするか（デフォルト: false） */
-    enableLogging?: boolean;
-}
-/**
- * MCP Progress Notification アダプター
- *
- * ProgressReporter の進捗イベントを MCP の notifications/progress に変換して送信。
- *
- * @example
- * ```typescript
- * const adapter = new MCPProgressAdapter({
- *   progressToken: request._meta?.progressToken,
- *   sendNotification: extra.sendNotification,
- * });
- *
- * const reporter = new ProgressReporter({
- *   onProgress: (event) => adapter.sendProgress(event),
- * });
- * ```
- */
-export declare class MCPProgressAdapter {
-    private readonly progressToken;
-    private readonly sendNotification;
-    private readonly enableLogging;
-    /**
-     * MCPProgressAdapter のコンストラクタ
-     *
-     * @param options - アダプターオプション
-     * @throws Error - progressToken または sendNotification が未定義の場合
-     */
-    constructor(options: MCPProgressOptions);
-    /**
-     * progressToken を取得
-     *
-     * @returns progressToken
-     */
-    getProgressToken(): string | number;
-    /**
-     * アダプターが有効かどうか
-     *
-     * @returns 常に true（コンストラクタで検証済み）
-     */
-    isEnabled(): boolean;
-    /**
-     * 進捗を MCP notifications/progress として送信
-     *
-     * @param event - ProgressReporter からの進捗イベント
-     */
-    sendProgress(event: ProgressEvent): Promise<void>;
-    /**
-     * 進捗メッセージを構築
-     *
-     * @param event - 進捗イベント
-     * @returns フォーマットされたメッセージ
-     */
-    private buildMessage;
-}
-/**
- * ProgressReporter 用の MCP Progress Callback を作成
- *
- * progressToken または sendNotification が未定義の場合は null を返す。
- * これにより、進捗報告が利用不可の場合でも処理を続行できる（Graceful Degradation）。
- *
- * @param options - MCPProgressOptions
- * @returns ProgressCallback または null
- *
- * @example
- * ```typescript
- * const progressCallback = createMCPProgressCallback({
- *   progressToken: request._meta?.progressToken,
- *   sendNotification: extra.sendNotification,
- * });
- *
- * const reporter = new ProgressReporter({
- *   onProgress: progressCallback ?? undefined,
- * });
- * ```
- */
-export declare function createMCPProgressCallback(options: MCPProgressOptions): ProgressCallback | null;
-//# sourceMappingURL=mcp-progress-adapter.d.ts.map

package/dist/services/vision/mcp-progress-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-progress-adapter.d.ts","sourceRoot":"","sources":["../../../src/services/vision/mcp-progress-adapter.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO9E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE;QACN,0BAA0B;QAC1B,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;QAC/B,aAAa;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,0BAA0B;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,qBAAqB;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,oCAAoC;IACpC,gBAAgB,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC;;;;;OAKG;gBACS,OAAO,EAAE,kBAAkB;IAavC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,GAAG,MAAM;IAInC;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvD;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAWrB;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI,CAa9F"}

package/dist/services/vision/mcp-progress-adapter.js

@@ -1,150 +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.MCPProgressAdapter = void 0;
-exports.createMCPProgressCallback = createMCPProgressCallback;
-const logger_1 = require("../../utils/logger");
-// =============================================================================
-// MCPProgressAdapter クラス
-// =============================================================================
-/**
- * MCP Progress Notification アダプター
- *
- * ProgressReporter の進捗イベントを MCP の notifications/progress に変換して送信。
- *
- * @example
- * ```typescript
- * const adapter = new MCPProgressAdapter({
- *   progressToken: request._meta?.progressToken,
- *   sendNotification: extra.sendNotification,
- * });
- *
- * const reporter = new ProgressReporter({
- *   onProgress: (event) => adapter.sendProgress(event),
- * });
- * ```
- */
-class MCPProgressAdapter {
-    progressToken;
-    sendNotification;
-    enableLogging;
-    /**
-     * MCPProgressAdapter のコンストラクタ
-     *
-     * @param options - アダプターオプション
-     * @throws Error - progressToken または sendNotification が未定義の場合
-     */
-    constructor(options) {
-        if (options.progressToken === undefined) {
-            throw new Error("progressToken is required");
-        }
-        if (options.sendNotification === undefined) {
-            throw new Error("sendNotification is required");
-        }
-        this.progressToken = options.progressToken;
-        this.sendNotification = options.sendNotification;
-        this.enableLogging = options.enableLogging ?? false;
-    }
-    /**
-     * progressToken を取得
-     *
-     * @returns progressToken
-     */
-    getProgressToken() {
-        return this.progressToken;
-    }
-    /**
-     * アダプターが有効かどうか
-     *
-     * @returns 常に true（コンストラクタで検証済み）
-     */
-    isEnabled() {
-        return true;
-    }
-    /**
-     * 進捗を MCP notifications/progress として送信
-     *
-     * @param event - ProgressReporter からの進捗イベント
-     */
-    async sendProgress(event) {
-        try {
-            // 進捗値をクランプ（0-100）
-            const clampedProgress = Math.max(0, Math.min(100, event.progress));
-            // メッセージを構築（phase情報を含める）
-            const message = this.buildMessage(event);
-            const notification = {
-                method: "notifications/progress",
-                params: {
-                    progressToken: this.progressToken,
-                    progress: clampedProgress,
-                    total: 100,
-                    message,
-                },
-            };
-            await this.sendNotification(notification);
-            if (this.enableLogging) {
-                logger_1.logger.info(`[MCPProgressAdapter] Sent progress: ${clampedProgress}% - ${message}`);
-            }
-        }
-        catch (error) {
-            // Graceful Degradation: 進捗送信失敗はエラーとして扱わない
-            if (this.enableLogging) {
-                console.warn("[MCPProgressAdapter] Failed to send progress notification:", error);
-            }
-        }
-    }
-    /**
-     * 進捗メッセージを構築
-     *
-     * @param event - 進捗イベント
-     * @returns フォーマットされたメッセージ
-     */
-    buildMessage(event) {
-        const { phase, message } = event;
-        // メッセージに既にphase情報が含まれている場合はそのまま返す
-        if (message.toLowerCase().includes(phase)) {
-            return message;
-        }
-        // phase情報を含める
-        return `[${phase}] ${message}`;
-    }
-}
-exports.MCPProgressAdapter = MCPProgressAdapter;
-// =============================================================================
-// ファクトリ関数
-// =============================================================================
-/**
- * ProgressReporter 用の MCP Progress Callback を作成
- *
- * progressToken または sendNotification が未定義の場合は null を返す。
- * これにより、進捗報告が利用不可の場合でも処理を続行できる（Graceful Degradation）。
- *
- * @param options - MCPProgressOptions
- * @returns ProgressCallback または null
- *
- * @example
- * ```typescript
- * const progressCallback = createMCPProgressCallback({
- *   progressToken: request._meta?.progressToken,
- *   sendNotification: extra.sendNotification,
- * });
- *
- * const reporter = new ProgressReporter({
- *   onProgress: progressCallback ?? undefined,
- * });
- * ```
- */
-function createMCPProgressCallback(options) {
-    // progressToken または sendNotification が未定義の場合は null を返す
-    if (options.progressToken === undefined || options.sendNotification === undefined) {
-        return null;
-    }
-    const adapter = new MCPProgressAdapter(options);
-    // 非同期処理を同期的に呼び出すラッパー（fire-and-forget）
-    return (event) => {
-        // エラーは内部でハンドリングされるため、void として呼び出し
-        void adapter.sendProgress(event);
-    };
-}
-//# sourceMappingURL=mcp-progress-adapter.js.map

package/dist/services/vision/mcp-progress-adapter.js.map

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

package/dist/services/vision/mood.analyzer.d.ts

@@ -1,74 +0,0 @@
-/**
- * 有効なMoodタイプ一覧
- */
-export declare const VALID_MOODS: readonly ["professional", "playful", "minimal", "bold", "elegant", "modern", "classic", "energetic", "calm", "luxurious"];
-export type MoodType = (typeof VALID_MOODS)[number];
-/**
- * Mood分析結果
- */
-export interface MoodAnalysisResult {
-    primaryMood: MoodType;
-    secondaryMood?: MoodType | undefined;
-    confidence: number;
-    indicators: string[];
-    colorContextUsed: boolean;
-}
-/**
- * カラーコンテキスト（オプション）
- */
-export interface ColorContext {
-    dominantColors: string[];
-    theme: "light" | "dark";
-    contentDensity: number;
-}
-/**
- * MoodAnalyzer設定
- */
-export interface MoodAnalyzerConfig {
-    ollamaUrl?: string;
-    timeout?: number;
-    cacheCapacity?: number;
-    cacheTTL?: number;
-    /** リトライを有効化（デフォルト: true） */
-    enableRetry?: boolean;
-}
-export declare class MoodAnalyzer {
-    private readonly cache;
-    private readonly client;
-    constructor(config?: MoodAnalyzerConfig);
-    /**
-     * スクリーンショットからムードを分析
-     *
-     * @param screenshot - Base64エンコードされたスクリーンショット
-     * @returns Mood分析結果、または信頼度が低い/エラー時はnull
-     * @throws Error - 入力が無効な場合
-     */
-    analyze(screenshot: string): Promise<MoodAnalysisResult | null>;
-    /**
-     * カラーコンテキスト付きでスクリーンショットからムードを分析
-     *
-     * @param screenshot - Base64エンコードされたスクリーンショット
-     * @param colorContext - カラーコンテキスト情報
-     * @returns Mood分析結果、または信頼度が低い/エラー時はnull
-     * @throws Error - 入力が無効な場合
-     */
-    analyzeWithContext(screenshot: string, colorContext: ColorContext): Promise<MoodAnalysisResult | null>;
-    /**
-     * 入力バリデーション
-     * @throws VisionAnalysisError - 入力が無効な場合
-     */
-    private validateInput;
-    /**
-     * Base64文字列の検証
-     */
-    private isValidBase64;
-    /**
-     * 結果のバリデーションとサニタイズ
-     */
-    private validateAndSanitizeResult;
-    /**
-     * 文字列のサニタイズ（XSS対策）
-     */
-    private sanitizeString;
-}
-//# sourceMappingURL=mood.analyzer.d.ts.map