@reftrixmcp/mcp-server 0.1.7

package/dist/services/vision/hardware-detector.d.ts

@@ -0,0 +1,166 @@
+/**
+ * ハードウェアキャッシュTTL（5分）
+ */
+export declare const HARDWARE_CACHE_TTL_MS: number;
+/**
+ * ハードウェアタイプ列挙型
+ */
+export declare enum HardwareType {
+    GPU = "GPU",
+    CPU = "CPU"
+}
+/**
+ * GPUベンダー列挙型
+ */
+export declare enum GpuVendor {
+    NVIDIA = "NVIDIA",
+    APPLE_METAL = "APPLE_METAL",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * ハードウェア情報
+ */
+export interface HardwareInfo {
+    /** ハードウェアタイプ（GPU/CPU） */
+    type: HardwareType;
+    /** VRAM使用量（バイト） */
+    vramBytes: number;
+    /** GPUが利用可能かどうか */
+    isGpuAvailable: boolean;
+    /** GPUベンダー（GPU検出時のみ設定） */
+    gpuVendor?: GpuVendor;
+    /** エラーメッセージ（Ollama未起動時等） */
+    error?: string;
+}
+/**
+ * HardwareDetector設定
+ */
+export interface HardwareDetectorConfig {
+    /** Ollama API URL */
+    ollamaUrl?: string;
+    /**
+     * 強制CPUモード
+     *
+     * trueの場合、Ollama APIの結果に関わらずCPUとして検出する。
+     * NVMLドライバ/ライブラリバージョン不整合などでGPUが使用できない場合に有効。
+     *
+     * 優先順位:
+     * 1. コンストラクタオプション (forceCpuMode)
+     * 2. 環境変数 (VISION_FORCE_CPU_MODE=true)
+     */
+    forceCpuMode?: boolean;
+}
+/**
+ * GPU不整合情報 / GPU mismatch information
+ *
+ * nvidia-smiでGPU検出 + Ollama size_vram=0 の不整合を報告する。
+ * Detects mismatch between nvidia-smi GPU detection and Ollama VRAM usage.
+ */
+export interface GpuMismatchInfo {
+    /** 不整合が検出されたか / Whether mismatch was detected */
+    mismatch: boolean;
+    /** nvidia-smiで検出されたGPU名 / GPU name detected by nvidia-smi */
+    nvidia_gpu: string;
+    /** Ollamaが報告したVRAM使用量（バイト） / VRAM bytes reported by Ollama */
+    ollama_vram_bytes: number;
+    /** 是正アクション / Recommended action to resolve */
+    action: string;
+}
+/**
+ * ハードウェア検出クラス
+ *
+ * Ollama /api/ps エンドポイントを使用してGPU/CPUを検出。
+ * 結果は5分間キャッシュされ、並行リクエスト時はデデュプリケーションを行う。
+ *
+ * @example
+ * ```typescript
+ * const detector = new HardwareDetector();
+ * const info = await detector.detect();
+ * if (info.type === HardwareType.GPU) {
+ *   console.log('GPU detected with', info.vramBytes, 'bytes VRAM');
+ * }
+ * ```
+ */
+export declare class HardwareDetector {
+    /**
+     * Apple Silicon（macOS arm64）かどうかを判定
+     *
+     * process.platform/process.archのみ使用（外部コマンド実行なし）
+     *
+     * @returns Apple Silicon環境の場合true
+     */
+    static isAppleSilicon(): boolean;
+    private readonly ollamaUrl;
+    private readonly forceCpuMode;
+    private cache;
+    private pendingRequest;
+    /**
+     * HardwareDetectorのコンストラクタ
+     *
+     * @param config - 設定オプション
+     */
+    constructor(config?: HardwareDetectorConfig);
+    /**
+     * ハードウェア情報を検出
+     *
+     * - 強制CPUモードが有効な場合は即座にCPUを返却
+     * - キャッシュが有効な場合はキャッシュから返却
+     * - 並行リクエストがある場合は同一リクエストを共有
+     * - Ollama未起動時はCPUフォールバック
+     *
+     * @returns ハードウェア情報
+     */
+    detect(): Promise<HardwareInfo>;
+    /**
+     * キャッシュをクリア
+     */
+    clearCache(): void;
+    /**
+     * 強制CPUモードが有効かどうかを返す
+     *
+     * @returns 強制CPUモードが有効な場合true
+     */
+    isForceCpuModeEnabled(): boolean;
+    /**
+     * nvidia-smiでGPUの物理的存在を確認 / Check physical GPU via nvidia-smi
+     *
+     * nvidia-smiが利用不可（未インストール or GPU未搭載）の場合はnullを返す。
+     * Returns null if nvidia-smi is unavailable or no GPU detected.
+     *
+     * @returns GPU名（未検出時はnull） / GPU name (null if not detected)
+     */
+    static queryNvidiaGpu(): string | null;
+    /**
+     * nvidia-smiとOllama /api/psのGPU状態をクロスチェック / Cross-check nvidia-smi and Ollama GPU state
+     *
+     * 検出パターン / Detection patterns:
+     * - nvidia-smi: GPU検出 + Ollama: モデルロード済み + size_vram=0 → mismatch
+     * - nvidia-smi: GPU未検出 → null（チェック不要）
+     * - Ollama: モデル未ロード → null（判定不可）
+     * - Ollama: size_vram > 0 → null（正常）
+     *
+     * @returns 不整合情報（問題なしの場合はnull） / Mismatch info (null if OK)
+     */
+    detectGpuMismatch(): Promise<GpuMismatchInfo | null>;
+    /**
+     * キャッシュからハードウェア情報を取得
+     */
+    private getCachedInfo;
+    /**
+     * ハードウェア情報をキャッシュに保存
+     */
+    private cacheInfo;
+    /**
+     * Ollama APIからハードウェア情報を取得
+     */
+    private fetchHardwareInfo;
+    /**
+     * Ollama /api/ps レスポンスをパース
+     */
+    private parseOllamaResponse;
+    /**
+     * CPUフォールバック情報を作成
+     */
+    private createCpuFallback;
+}
+//# sourceMappingURL=hardware-detector.d.ts.map

package/dist/services/vision/hardware-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-detector.d.ts","sourceRoot":"","sources":["../../../src/services/vision/hardware-detector.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AA4BnD;;GAEG;AACH,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,mBAAmB;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAaD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,IAAI,OAAO;IAIhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,cAAc,CAAsC;IAE5D;;;;OAIG;gBACS,MAAM,CAAC,EAAE,sBAAsB;IAW3C;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IA6BrC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,IAAI,MAAM,GAAG,IAAI;IAatC;;;;;;;;;;OAUG;IACG,iBAAiB,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgD1D;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;YACW,iBAAiB;IA6B/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/services/vision/hardware-detector.js

@@ -0,0 +1,330 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HardwareDetector = exports.GpuVendor = exports.HardwareType = exports.HARDWARE_CACHE_TTL_MS = void 0;
+/**
+ * HardwareDetector - GPU/CPU検出機能
+ *
+ * Vision CPU完走保証 Phase 1: Ollama /api/ps からハードウェア情報を取得
+ *
+ * 機能:
+ * - Ollama /api/ps エンドポイントからモデル情報取得
+ * - size_vram > 0 でGPU検出、それ以外はCPU
+ * - 5分間キャッシュ（HARDWARE_CACHE_TTL_MS = 300000）
+ * - Ollama未起動時はCPUフォールバック（Graceful Degradation）
+ * - 並行リクエスト時のデデュプリケーション
+ * - VISION_FORCE_CPU_MODE=true で強制CPUモード（NVMLドライバ不整合対策）
+ *
+ * @see apps/mcp-server/tests/services/vision/hardware-detector.test.ts
+ */
+const node_child_process_1 = require("node:child_process");
+// =============================================================================
+// 定数
+// =============================================================================
+/**
+ * ハードウェアキャッシュTTL（5分）
+ */
+exports.HARDWARE_CACHE_TTL_MS = 5 * 60 * 1000;
+/**
+ * デフォルトOllama URL
+ */
+const DEFAULT_OLLAMA_URL = "http://localhost:11434";
+/**
+ * API呼び出しタイムアウト（5秒）
+ */
+const API_TIMEOUT_MS = 5000;
+/**
+ * 環境変数: 強制CPUモード
+ *
+ * NVMLドライバ/ライブラリバージョン不整合などでGPUが物理的に存在するが
+ * 実際にはCPUで推論が行われる場合に使用。
+ *
+ * 設定方法:
+ * - 環境変数: VISION_FORCE_CPU_MODE=true
+ * - コンストラクタオプション: { forceCpuMode: true }
+ */
+const ENV_FORCE_CPU_MODE = "VISION_FORCE_CPU_MODE";
+// =============================================================================
+// 型定義
+// =============================================================================
+/**
+ * ハードウェアタイプ列挙型
+ */
+var HardwareType;
+(function (HardwareType) {
+    HardwareType["GPU"] = "GPU";
+    HardwareType["CPU"] = "CPU";
+})(HardwareType || (exports.HardwareType = HardwareType = {}));
+/**
+ * GPUベンダー列挙型
+ */
+var GpuVendor;
+(function (GpuVendor) {
+    GpuVendor["NVIDIA"] = "NVIDIA";
+    GpuVendor["APPLE_METAL"] = "APPLE_METAL";
+    GpuVendor["UNKNOWN"] = "UNKNOWN";
+})(GpuVendor || (exports.GpuVendor = GpuVendor = {}));
+// =============================================================================
+// HardwareDetector クラス
+// =============================================================================
+/**
+ * ハードウェア検出クラス
+ *
+ * Ollama /api/ps エンドポイントを使用してGPU/CPUを検出。
+ * 結果は5分間キャッシュされ、並行リクエスト時はデデュプリケーションを行う。
+ *
+ * @example
+ * ```typescript
+ * const detector = new HardwareDetector();
+ * const info = await detector.detect();
+ * if (info.type === HardwareType.GPU) {
+ *   console.log('GPU detected with', info.vramBytes, 'bytes VRAM');
+ * }
+ * ```
+ */
+class HardwareDetector {
+    /**
+     * Apple Silicon（macOS arm64）かどうかを判定
+     *
+     * process.platform/process.archのみ使用（外部コマンド実行なし）
+     *
+     * @returns Apple Silicon環境の場合true
+     */
+    static isAppleSilicon() {
+        return process.platform === "darwin" && process.arch === "arm64";
+    }
+    ollamaUrl;
+    forceCpuMode;
+    cache = null;
+    pendingRequest = null;
+    /**
+     * HardwareDetectorのコンストラクタ
+     *
+     * @param config - 設定オプション
+     */
+    constructor(config) {
+        this.ollamaUrl = config?.ollamaUrl ?? DEFAULT_OLLAMA_URL;
+        // 強制CPUモード: コンストラクタオプション > 環境変数
+        this.forceCpuMode =
+            config?.forceCpuMode ?? process.env[ENV_FORCE_CPU_MODE]?.toLowerCase() === "true";
+    }
+    // ===========================================================================
+    // パブリックメソッド
+    // ===========================================================================
+    /**
+     * ハードウェア情報を検出
+     *
+     * - 強制CPUモードが有効な場合は即座にCPUを返却
+     * - キャッシュが有効な場合はキャッシュから返却
+     * - 並行リクエストがある場合は同一リクエストを共有
+     * - Ollama未起動時はCPUフォールバック
+     *
+     * @returns ハードウェア情報
+     */
+    async detect() {
+        // 強制CPUモードチェック（NVMLドライバ不整合対策）
+        if (this.forceCpuMode) {
+            return this.createCpuFallback("Force CPU mode enabled (VISION_FORCE_CPU_MODE=true)");
+        }
+        // キャッシュチェック
+        const cachedInfo = this.getCachedInfo();
+        if (cachedInfo) {
+            return cachedInfo;
+        }
+        // 並行リクエストのデデュプリケーション
+        if (this.pendingRequest) {
+            return this.pendingRequest;
+        }
+        // 新しいリクエストを開始
+        this.pendingRequest = this.fetchHardwareInfo();
+        try {
+            const info = await this.pendingRequest;
+            this.cacheInfo(info);
+            return info;
+        }
+        finally {
+            this.pendingRequest = null;
+        }
+    }
+    /**
+     * キャッシュをクリア
+     */
+    clearCache() {
+        this.cache = null;
+    }
+    /**
+     * 強制CPUモードが有効かどうかを返す
+     *
+     * @returns 強制CPUモードが有効な場合true
+     */
+    isForceCpuModeEnabled() {
+        return this.forceCpuMode;
+    }
+    /**
+     * nvidia-smiでGPUの物理的存在を確認 / Check physical GPU via nvidia-smi
+     *
+     * nvidia-smiが利用不可（未インストール or GPU未搭載）の場合はnullを返す。
+     * Returns null if nvidia-smi is unavailable or no GPU detected.
+     *
+     * @returns GPU名（未検出時はnull） / GPU name (null if not detected)
+     */
+    static queryNvidiaGpu() {
+        try {
+            const result = (0, node_child_process_1.execSync)("nvidia-smi --query-gpu=name --format=csv,noheader", {
+                timeout: 3000,
+                encoding: "utf-8",
+            });
+            const gpuName = result.trim().split("\n")[0]?.trim();
+            return gpuName || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * nvidia-smiとOllama /api/psのGPU状態をクロスチェック / Cross-check nvidia-smi and Ollama GPU state
+     *
+     * 検出パターン / Detection patterns:
+     * - nvidia-smi: GPU検出 + Ollama: モデルロード済み + size_vram=0 → mismatch
+     * - nvidia-smi: GPU未検出 → null（チェック不要）
+     * - Ollama: モデル未ロード → null（判定不可）
+     * - Ollama: size_vram > 0 → null（正常）
+     *
+     * @returns 不整合情報（問題なしの場合はnull） / Mismatch info (null if OK)
+     */
+    async detectGpuMismatch() {
+        const nvidiaGpu = HardwareDetector.queryNvidiaGpu();
+        if (!nvidiaGpu)
+            return null;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+            try {
+                const response = await fetch(`${this.ollamaUrl}/api/ps`, {
+                    method: "GET",
+                    signal: controller.signal,
+                });
+                if (!response.ok)
+                    return null;
+                const data = (await response.json());
+                const models = data.models;
+                if (!models || !Array.isArray(models) || models.length === 0) {
+                    return null;
+                }
+                const hasVram = models.some((m) => (m.size_vram ?? 0) > 0);
+                if (hasVram)
+                    return null;
+                return {
+                    mismatch: true,
+                    nvidia_gpu: nvidiaGpu,
+                    ollama_vram_bytes: 0,
+                    action: "Ollama is running models on CPU despite GPU being available. " +
+                        'Likely cause: a rogue ollama process started with CUDA_VISIBLE_DEVICES="" is occupying port 11434. ' +
+                        "Fix: (1) pkill ollama (2) sudo systemctl restart ollama " +
+                        '(3) Verify: curl http://localhost:11434/api/ps | jq ".models[].size_vram"',
+                };
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    // ===========================================================================
+    // プライベートメソッド
+    // ===========================================================================
+    /**
+     * キャッシュからハードウェア情報を取得
+     */
+    getCachedInfo() {
+        if (!this.cache) {
+            return null;
+        }
+        const now = Date.now();
+        const elapsed = now - this.cache.timestamp;
+        if (elapsed > exports.HARDWARE_CACHE_TTL_MS) {
+            this.cache = null;
+            return null;
+        }
+        return this.cache.info;
+    }
+    /**
+     * ハードウェア情報をキャッシュに保存
+     */
+    cacheInfo(info) {
+        this.cache = {
+            info,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Ollama APIからハードウェア情報を取得
+     */
+    async fetchHardwareInfo() {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+            try {
+                const response = await fetch(`${this.ollamaUrl}/api/ps`, {
+                    method: "GET",
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    return this.createCpuFallback(`Ollama API error: ${response.status} ${response.statusText}`);
+                }
+                const data = (await response.json());
+                return this.parseOllamaResponse(data);
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch (error) {
+            return this.createCpuFallback(`Ollama connection failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Ollama /api/ps レスポンスをパース
+     */
+    parseOllamaResponse(data) {
+        // models配列が存在しないか空の場合はCPU
+        const models = data.models;
+        if (!models || !Array.isArray(models) || models.length === 0) {
+            return this.createCpuFallback();
+        }
+        // 最大VRAM使用量を検出
+        let maxVram = 0;
+        for (const model of models) {
+            const vram = model.size_vram ?? 0;
+            if (vram > maxVram) {
+                maxVram = vram;
+            }
+        }
+        // VRAM > 0 ならGPU、それ以外はCPU
+        if (maxVram > 0) {
+            return {
+                type: HardwareType.GPU,
+                vramBytes: maxVram,
+                isGpuAvailable: true,
+                gpuVendor: HardwareDetector.isAppleSilicon() ? GpuVendor.APPLE_METAL : GpuVendor.NVIDIA,
+            };
+        }
+        return this.createCpuFallback();
+    }
+    /**
+     * CPUフォールバック情報を作成
+     */
+    createCpuFallback(error) {
+        return {
+            type: HardwareType.CPU,
+            vramBytes: 0,
+            isGpuAvailable: false,
+            ...(error && { error }),
+        };
+    }
+}
+exports.HardwareDetector = HardwareDetector;
+//# sourceMappingURL=hardware-detector.js.map

package/dist/services/vision/hardware-detector.js.map

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

package/dist/services/vision/image-optimizer.d.ts

@@ -0,0 +1,152 @@
+import { HardwareType } from "./hardware-detector.js";
+/**
+ * 画像サイズ閾値（バイト）
+ */
+export declare const IMAGE_SIZE_THRESHOLDS: {
+    /** Small画像閾値: 100KB */
+    readonly SMALL: 100000;
+    /** Large画像閾値: 500KB */
+    readonly LARGE: 500000;
+};
+/**
+ * 最適化戦略
+ */
+export declare enum OptimizationStrategy {
+    /** 最適化なし */
+    NONE = "NONE",
+    /** 中程度の最適化（1024x1024、品質80%） */
+    MEDIUM = "MEDIUM",
+    /** 積極的な最適化（768x768、品質70%） */
+    AGGRESSIVE = "AGGRESSIVE"
+}
+/**
+ * 最適化設定
+ */
+export interface OptimizationConfig {
+    /** 最大幅 */
+    maxWidth?: number;
+    /** 最大高さ */
+    maxHeight?: number;
+    /** JPEG品質（1-100） */
+    quality?: number;
+}
+/**
+ * 最適化設定プリセット
+ */
+export declare const OPTIMIZATION_CONFIGS: Record<OptimizationStrategy, OptimizationConfig>;
+/**
+ * 最適化オプション
+ */
+export interface OptimizeOptions {
+    /** ハードウェアタイプ（GPU/CPU） */
+    hardwareType: HardwareType;
+    /** 戦略を強制（自動選択をスキップ） */
+    forceStrategy?: OptimizationStrategy;
+    /** 出力フォーマット（デフォルト: jpeg） */
+    outputFormat?: "jpeg" | "png";
+}
+/**
+ * 最適化結果
+ */
+export interface OptimizeResult {
+    /** 最適化後のバッファ */
+    buffer: Buffer;
+    /** 元のサイズ（バイト） */
+    originalSizeBytes: number;
+    /** 最適化後のサイズ（バイト） */
+    optimizedSizeBytes: number;
+    /** 画像サイズ（幅x高さ） */
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    /** 圧縮率（optimized / original、1以下なら圧縮成功） */
+    compressionRatio: number;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs: number;
+    /** 最適化がスキップされたか */
+    skipped: boolean;
+    /** スキップまたはエラーの理由 */
+    reason?: string;
+    /** エラーメッセージ */
+    error?: string;
+}
+/**
+ * 最適サイズ推定結果
+ */
+export interface ImageDimensions {
+    /** 最大幅（undefined = 制限なし） */
+    maxWidth: number | undefined;
+    /** 最大高さ（undefined = 制限なし） */
+    maxHeight: number | undefined;
+    /** JPEG品質（undefined = 制限なし） */
+    quality: number | undefined;
+    /** 選択された戦略 */
+    strategy: OptimizationStrategy;
+}
+/**
+ * 画像最適化クラス
+ *
+ * CPU推論のパフォーマンスを向上させるため、画像を事前にリサイズ・圧縮。
+ * GPU使用時や小さな画像では最適化をスキップして効率を維持。
+ *
+ * @example
+ * ```typescript
+ * const optimizer = new ImageOptimizer();
+ *
+ * // 自動戦略選択
+ * const result = await optimizer.optimizeForCPU(imageBuffer, {
+ *   hardwareType: HardwareType.CPU,
+ * });
+ *
+ * // 強制的に積極的な最適化
+ * const result = await optimizer.optimizeForCPU(imageBuffer, {
+ *   hardwareType: HardwareType.CPU,
+ *   forceStrategy: OptimizationStrategy.AGGRESSIVE,
+ * });
+ * ```
+ */
+export declare class ImageOptimizer {
+    constructor();
+    /**
+     * 最適化戦略を選択
+     *
+     * @param hardwareType - ハードウェアタイプ（GPU/CPU）
+     * @param imageSizeBytes - 画像サイズ（バイト）
+     * @returns 最適化戦略
+     */
+    selectStrategy(hardwareType: HardwareType, imageSizeBytes: number): OptimizationStrategy;
+    /**
+     * 最適なサイズを推定
+     *
+     * @param imageSizeBytes - 画像サイズ（バイト）
+     * @param hardwareType - ハードウェアタイプ（GPU/CPU）
+     * @returns 推定される最適サイズと戦略
+     */
+    estimateOptimalSize(imageSizeBytes: number, hardwareType: HardwareType): ImageDimensions;
+    /**
+     * CPU推論向けに画像を最適化
+     *
+     * @param input - 画像バッファまたはBase64文字列
+     * @param options - 最適化オプション
+     * @returns 最適化結果
+     */
+    optimizeForCPU(input: Buffer | string, options: OptimizeOptions): Promise<OptimizeResult>;
+    /**
+     * 入力をBufferに変換
+     */
+    private toBuffer;
+    /**
+     * 最適化を適用
+     */
+    private applyOptimization;
+    /**
+     * スキップ結果を作成
+     */
+    private createSkippedResult;
+    /**
+     * エラー結果を作成（Graceful Degradation）
+     */
+    private createErrorResult;
+}
+//# sourceMappingURL=image-optimizer.d.ts.map

package/dist/services/vision/image-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-optimizer.d.ts","sourceRoot":"","sources":["../../../src/services/vision/image-optimizer.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMtD;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,uBAAuB;;IAEvB,uBAAuB;;CAEf,CAAC;AAEX;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,YAAY;IACZ,IAAI,SAAS;IACb,+BAA+B;IAC/B,MAAM,WAAW;IACjB,6BAA6B;IAC7B,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAYxE,CAAC;AAWX;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,uBAAuB;IACvB,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,cAAc;IACd,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAc;;IAUzB;;;;;;OAMG;IACH,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,oBAAoB;IAkBxF;;;;;;OAMG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,eAAe;IAYxF;;;;;;OAMG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAiE/F;;OAEG;IACH,OAAO,CAAC,QAAQ;IAWhB;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAc1B"}