@reftrixmcp/mcp-server 0.1.7

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

@@ -0,0 +1,307 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,128 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,150 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,74 @@
+/**
+ * 有効な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