@reftrixmcp/mcp-server 0.1.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"mood.analyzer.d.ts","sourceRoot":"","sources":["../../../src/services/vision/mood.analyzer.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,eAAO,MAAM,WAAW,2HAWd,CAAC;AAqBX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,QAAQ,CAAC;IACtB,aAAa,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkBD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBAEhC,MAAM,CAAC,EAAE,kBAAkB;IAgBvC;;;;;;OAMG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyCrE;;;;;;;OAOG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA6CrC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;OAEG;IACH,OAAO,CAAC,cAAc;CAOvB"}

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

@@ -0,0 +1,258 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoodAnalyzer = exports.VALID_MOODS = void 0;
+/**
+ * MoodAnalyzer - Vision AIによるムード分析サービス
+ *
+ * Phase 5: スクリーンショットからムード（雰囲気）を抽出
+ *
+ * 機能:
+ * - Base64スクリーンショットからmood（雰囲気）を抽出
+ * - primary/secondary mood検出
+ * - confidence スコア検証（0.6以上が有効）
+ * - Ollama未接続時のgraceful degradation
+ * - LRUキャッシュ検証
+ * - セキュリティ検証（サイズ制限、入力バリデーション）
+ *
+ * Phase 5 REFACTOR:
+ * - OllamaVisionClientを使用してAPIロジック統合
+ * - VisionAnalysisErrorを使用してエラーハンドリング統一
+ * - vision.promptsからプロンプトを取得
+ *
+ * 参照:
+ * -  (page.analyze visualFeatures)
+ * - apps/mcp-server/src/services/vision-adapter/interface.ts
+ */
+const logger_1 = require("../../utils/logger");
+const zod_1 = require("zod");
+const vision_cache_js_1 = require("./vision.cache.js");
+const ollama_vision_client_js_1 = require("./ollama-vision-client.js");
+const vision_errors_js_1 = require("./vision.errors.js");
+const vision_prompts_js_1 = require("./vision.prompts.js");
+// =============================================================================
+// 定数
+// =============================================================================
+/**
+ * 有効なMoodタイプ一覧
+ */
+exports.VALID_MOODS = [
+    "professional",
+    "playful",
+    "minimal",
+    "bold",
+    "elegant",
+    "modern",
+    "classic",
+    "energetic",
+    "calm",
+    "luxurious",
+];
+/**
+ * 入力サイズ制限（5MB）
+ */
+const MAX_INPUT_SIZE_BYTES = 5 * 1024 * 1024;
+/**
+ * デフォルトタイムアウト（30秒）
+ */
+const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * 最小信頼度閾値
+ */
+const MIN_CONFIDENCE_THRESHOLD = 0.6;
+// =============================================================================
+// Zodスキーマ
+// =============================================================================
+const MoodAnalysisResultSchema = zod_1.z.object({
+    primaryMood: zod_1.z.enum(exports.VALID_MOODS),
+    secondaryMood: zod_1.z.enum(exports.VALID_MOODS).optional(),
+    confidence: zod_1.z.number().min(0).max(1),
+    indicators: zod_1.z.array(zod_1.z.string()),
+    colorContextUsed: zod_1.z.boolean(),
+});
+// =============================================================================
+// MoodAnalyzer クラス
+// =============================================================================
+class MoodAnalyzer {
+    cache;
+    client;
+    constructor(config) {
+        this.cache = new vision_cache_js_1.VisionCache({
+            capacity: config?.cacheCapacity ?? 100,
+            ttlMs: config?.cacheTTL ?? 5 * 60 * 1000, // 5分
+        });
+        this.client = new ollama_vision_client_js_1.OllamaVisionClient({
+            ollamaUrl: config?.ollamaUrl,
+            timeout: config?.timeout ?? DEFAULT_TIMEOUT_MS,
+            enableRetry: config?.enableRetry ?? true,
+        });
+    }
+    // ===========================================================================
+    // パブリックメソッド
+    // ===========================================================================
+    /**
+     * スクリーンショットからムードを分析
+     *
+     * @param screenshot - Base64エンコードされたスクリーンショット
+     * @returns Mood分析結果、または信頼度が低い/エラー時はnull
+     * @throws Error - 入力が無効な場合
+     */
+    async analyze(screenshot) {
+        // 入力バリデーション
+        this.validateInput(screenshot);
+        // キャッシュチェック
+        const cacheKey = vision_cache_js_1.VisionCache.generateKey(screenshot);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            // Ollama API呼び出し（OllamaVisionClient経由）
+            logger_1.logger.info("[MoodAnalyzer] Ollama API call started");
+            const prompt = (0, vision_prompts_js_1.getMoodAnalysisPrompt)();
+            const rawResult = await this.client.generateJSON(screenshot, prompt);
+            // 結果のバリデーション
+            const result = this.validateAndSanitizeResult(rawResult);
+            if (!result) {
+                return null;
+            }
+            // 信頼度チェック
+            if (result.confidence < MIN_CONFIDENCE_THRESHOLD) {
+                return null;
+            }
+            // キャッシュに保存
+            this.cache.set(cacheKey, result);
+            return result;
+        }
+        catch (error) {
+            // Graceful degradation: エラー時はnullを返す
+            if (process.env.NODE_ENV === "development") {
+                console.error("[MoodAnalyzer] Error:", error);
+            }
+            return null;
+        }
+    }
+    /**
+     * カラーコンテキスト付きでスクリーンショットからムードを分析
+     *
+     * @param screenshot - Base64エンコードされたスクリーンショット
+     * @param colorContext - カラーコンテキスト情報
+     * @returns Mood分析結果、または信頼度が低い/エラー時はnull
+     * @throws Error - 入力が無効な場合
+     */
+    async analyzeWithContext(screenshot, colorContext) {
+        // 入力バリデーション
+        this.validateInput(screenshot);
+        // キャッシュキーにカラーコンテキストを含める
+        const cacheKey = vision_cache_js_1.VisionCache.generateKey(screenshot + JSON.stringify(colorContext));
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            // Ollama API呼び出し（OllamaVisionClient経由）
+            logger_1.logger.info("[MoodAnalyzer] Ollama API call started");
+            const prompt = (0, vision_prompts_js_1.getMoodAnalysisWithContextPrompt)(colorContext);
+            const rawResult = await this.client.generateJSON(screenshot, prompt);
+            // 結果のバリデーション
+            const result = this.validateAndSanitizeResult(rawResult);
+            if (!result) {
+                return null;
+            }
+            // 信頼度チェック
+            if (result.confidence < MIN_CONFIDENCE_THRESHOLD) {
+                return null;
+            }
+            // キャッシュに保存
+            this.cache.set(cacheKey, result);
+            return result;
+        }
+        catch (error) {
+            // Graceful degradation: エラー時はnullを返す
+            if (process.env.NODE_ENV === "development") {
+                console.error("[MoodAnalyzer] Error:", error);
+            }
+            return null;
+        }
+    }
+    // ===========================================================================
+    // プライベートメソッド
+    // ===========================================================================
+    /**
+     * 入力バリデーション
+     * @throws VisionAnalysisError - 入力が無効な場合
+     */
+    validateInput(screenshot) {
+        // 空チェック
+        if (!screenshot || screenshot.length === 0) {
+            throw new vision_errors_js_1.VisionAnalysisError("Screenshot is required", "INPUT_VALIDATION", false);
+        }
+        // Base64バリデーション
+        if (!this.isValidBase64(screenshot)) {
+            throw new vision_errors_js_1.VisionAnalysisError("Invalid Base64 input", "INPUT_VALIDATION", false);
+        }
+        // サイズチェック
+        const sizeBytes = Buffer.byteLength(screenshot, "base64");
+        if (sizeBytes > MAX_INPUT_SIZE_BYTES) {
+            throw new vision_errors_js_1.VisionAnalysisError("Input exceeds 5MB limit", "INPUT_VALIDATION", false, {
+                sizeBytes,
+                maxSizeBytes: MAX_INPUT_SIZE_BYTES,
+            });
+        }
+    }
+    /**
+     * Base64文字列の検証
+     */
+    isValidBase64(str) {
+        // Base64正規表現パターン
+        const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+        if (!base64Regex.test(str)) {
+            return false;
+        }
+        try {
+            // 実際にデコードして検証
+            Buffer.from(str, "base64");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 結果のバリデーションとサニタイズ
+     */
+    validateAndSanitizeResult(rawResult) {
+        // 型チェック
+        if (typeof rawResult !== "object" || rawResult === null) {
+            return null;
+        }
+        // Zodでバリデーション
+        const parseResult = MoodAnalysisResultSchema.safeParse(rawResult);
+        if (!parseResult.success) {
+            if (process.env.NODE_ENV === "development") {
+                console.warn("[MoodAnalyzer] Validation failed:", parseResult.error);
+            }
+            return null;
+        }
+        const result = parseResult.data;
+        // indicatorsのサニタイズ
+        const sanitizedIndicators = result.indicators.map((indicator) => this.sanitizeString(indicator));
+        return {
+            ...result,
+            indicators: sanitizedIndicators,
+        };
+    }
+    /**
+     * 文字列のサニタイズ（XSS対策）
+     */
+    sanitizeString(str) {
+        return str
+            .replace(/<[^>]*>/g, "") // HTMLタグ除去
+            .replace(/[<>"'&]/g, "") // 特殊文字除去
+            .trim()
+            .slice(0, 200); // 長さ制限
+    }
+}
+exports.MoodAnalyzer = MoodAnalyzer;
+//# sourceMappingURL=mood.analyzer.js.map

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

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

package/dist/services/vision/ollama-readiness-probe.d.ts

@@ -0,0 +1,87 @@
+import type { VramInfo } from "./vram-utils.js";
+export type { VramInfo } from "./vram-utils.js";
+/**
+ * Readiness Probe結果
+ */
+export interface ReadinessProbeResult {
+    /** Ollama Vision実行可能か */
+    ready: boolean;
+    /** GPU VRAM情報（取得できた場合） */
+    vram: VramInfo | null;
+    /** Ollamaサービスが応答するか */
+    ollamaAvailable: boolean;
+    /** 待機した回数（0 = 即座にready） */
+    waitRetries: number;
+    /** 待機した総時間（ミリ秒） */
+    totalWaitMs: number;
+    /** 理由（ready=falseの場合） */
+    reason?: string | undefined;
+}
+/**
+ * OllamaReadinessProbe設定
+ */
+export interface OllamaReadinessProbeConfig {
+    /** Ollama API URL */
+    ollamaUrl?: string | undefined;
+    /** 最小VRAM空き容量（MB） */
+    minVramFreeMb?: number | undefined;
+    /** 最大待機リトライ回数 */
+    maxWaitRetries?: number | undefined;
+    /** 待機基準間隔（ミリ秒） */
+    waitBaseDelayMs?: number | undefined;
+    /** VRAM待機を無効化（常にreadyを返す） */
+    skipVramCheck?: boolean | undefined;
+}
+/**
+ * Ollama Vision実行前のReadiness Probe
+ *
+ * Phase 2.5（ScrollVision Analysis）実行前に呼び出し、
+ * GPU VRAMに十分な空きがあるか確認する。
+ * 空きが不足している場合は指数バックオフで待機し、
+ * 他のプロセス（Chromiumなど）がVRAMを解放するのを待つ。
+ *
+ * @example
+ * ```typescript
+ * const probe = new OllamaReadinessProbe();
+ * const result = await probe.check();
+ * if (result.ready) {
+ *   // Vision分析を実行
+ *   await analyzeScrollCaptures(captures);
+ * } else {
+ *   logger.warn('Ollama not ready', { reason: result.reason });
+ * }
+ * ```
+ */
+export declare class OllamaReadinessProbe {
+    private readonly ollamaUrl;
+    private readonly minVramFreeMb;
+    private readonly maxWaitRetries;
+    private readonly waitBaseDelayMs;
+    private readonly skipVramCheck;
+    constructor(config?: OllamaReadinessProbeConfig);
+    /**
+     * Readiness Probeを実行
+     *
+     * 1. Ollama接続チェック
+     * 2. GPU VRAM空き容量チェック（nvidia-smi）
+     * 3. 不足時は指数バックオフで待機
+     *
+     * @returns Probe結果
+     */
+    check(): Promise<ReadinessProbeResult>;
+    /**
+     * VRAM情報のみ取得（待機なし）
+     *
+     * @returns VRAM情報（GPU非搭載時はnull）
+     */
+    getVramInfo(): Promise<VramInfo | null>;
+    /**
+     * Ollama接続確認
+     */
+    private checkOllamaAvailable;
+    /**
+     * 指定ミリ秒だけスリープ
+     */
+    private sleep;
+}
+//# sourceMappingURL=ollama-readiness-probe.d.ts.map

package/dist/services/vision/ollama-readiness-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-readiness-probe.d.ts","sourceRoot":"","sources":["../../../src/services/vision/ollama-readiness-probe.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAmChD,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,uBAAuB;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iBAAiB;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kBAAkB;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,MAAM,CAAC,EAAE,0BAA0B;IAY/C;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAsF5C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAQ7C;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/services/vision/ollama-readiness-probe.js

@@ -0,0 +1,211 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OllamaReadinessProbe = void 0;
+/**
+ * OllamaReadinessProbe - VRAM状態チェックとOllamaサービス準備確認
+ *
+ * P2-8: Phase 2.5（ScrollVision Analysis）実行前にGPU VRAM状態を確認し、
+ * Ollama Vision LLM（llama3.2-vision: ~7.8GB VRAM）を安全に実行できるか判定する。
+ *
+ * 機能:
+ * - nvidia-smi によるGPU VRAM空き容量チェック
+ * - Ollama /api/tags による接続確認
+ * - VRAM不足時の待機（指数バックオフ付き）
+ * - GPU非搭載環境のgraceful degradation
+ *
+ * @see apps/mcp-server/src/services/vision/hardware-detector.ts
+ * @see apps/mcp-server/src/services/vision/scroll-vision.analyzer.ts
+ */
+const vram_utils_js_1 = require("./vram-utils.js");
+const hardware_detector_js_1 = require("./hardware-detector.js");
+// =============================================================================
+// 定数
+// =============================================================================
+/**
+ * llama3.2-visionが必要とする最小VRAM（MB）
+ *
+ * モデルロード時に約7.8GB使用。安全マージン含め8192MBを閾値とする。
+ */
+const MIN_VRAM_FREE_MB = 8192;
+/**
+ * VRAM待機の最大リトライ回数
+ */
+const MAX_WAIT_RETRIES = 3;
+/**
+ * VRAM待機の基準間隔（ミリ秒）
+ * 指数バックオフ: 10s → 20s → 40s
+ */
+const WAIT_BASE_DELAY_MS = 10000;
+/**
+ * Ollama APIタイムアウト（ミリ秒）
+ */
+const OLLAMA_API_TIMEOUT_MS = 5000;
+// =============================================================================
+// OllamaReadinessProbe クラス
+// =============================================================================
+/**
+ * Ollama Vision実行前のReadiness Probe
+ *
+ * Phase 2.5（ScrollVision Analysis）実行前に呼び出し、
+ * GPU VRAMに十分な空きがあるか確認する。
+ * 空きが不足している場合は指数バックオフで待機し、
+ * 他のプロセス（Chromiumなど）がVRAMを解放するのを待つ。
+ *
+ * @example
+ * ```typescript
+ * const probe = new OllamaReadinessProbe();
+ * const result = await probe.check();
+ * if (result.ready) {
+ *   // Vision分析を実行
+ *   await analyzeScrollCaptures(captures);
+ * } else {
+ *   logger.warn('Ollama not ready', { reason: result.reason });
+ * }
+ * ```
+ */
+class OllamaReadinessProbe {
+    ollamaUrl;
+    minVramFreeMb;
+    maxWaitRetries;
+    waitBaseDelayMs;
+    skipVramCheck;
+    constructor(config) {
+        this.ollamaUrl = config?.ollamaUrl ?? "http://localhost:11434";
+        this.minVramFreeMb = config?.minVramFreeMb ?? MIN_VRAM_FREE_MB;
+        this.maxWaitRetries = config?.maxWaitRetries ?? MAX_WAIT_RETRIES;
+        this.waitBaseDelayMs = config?.waitBaseDelayMs ?? WAIT_BASE_DELAY_MS;
+        this.skipVramCheck = config?.skipVramCheck ?? false;
+    }
+    // ===========================================================================
+    // パブリックメソッド
+    // ===========================================================================
+    /**
+     * Readiness Probeを実行
+     *
+     * 1. Ollama接続チェック
+     * 2. GPU VRAM空き容量チェック（nvidia-smi）
+     * 3. 不足時は指数バックオフで待機
+     *
+     * @returns Probe結果
+     */
+    async check() {
+        const startTime = Date.now();
+        let waitRetries = 0;
+        // 1. Ollama接続チェック
+        const ollamaAvailable = await this.checkOllamaAvailable();
+        if (!ollamaAvailable) {
+            return {
+                ready: false,
+                vram: null,
+                ollamaAvailable: false,
+                waitRetries: 0,
+                totalWaitMs: Date.now() - startTime,
+                reason: "Ollama service is not available",
+            };
+        }
+        // 2. VRAM チェックスキップモード
+        if (this.skipVramCheck) {
+            return {
+                ready: true,
+                vram: null,
+                ollamaAvailable: true,
+                waitRetries: 0,
+                totalWaitMs: Date.now() - startTime,
+            };
+        }
+        // 3. VRAM空き容量チェック（リトライ付き）
+        for (let attempt = 0; attempt <= this.maxWaitRetries; attempt++) {
+            const vram = await (0, vram_utils_js_1.queryVram)();
+            // nvidia-smi利用不可（CPU環境 or nvidia-smi未インストール）
+            if (vram === null) {
+                return {
+                    ready: true,
+                    vram: null,
+                    ollamaAvailable: true,
+                    waitRetries: 0,
+                    totalWaitMs: Date.now() - startTime,
+                    reason: hardware_detector_js_1.HardwareDetector.isAppleSilicon()
+                        ? "Apple Silicon detected: Metal GPU manages memory natively (nvidia-smi not applicable)"
+                        : "nvidia-smi not available, assuming CPU mode (no VRAM check)",
+                };
+            }
+            // VRAM十分
+            if (vram.freeMb >= this.minVramFreeMb) {
+                return {
+                    ready: true,
+                    vram,
+                    ollamaAvailable: true,
+                    waitRetries,
+                    totalWaitMs: Date.now() - startTime,
+                };
+            }
+            // 最後のリトライでもVRAM不足
+            if (attempt === this.maxWaitRetries) {
+                return {
+                    ready: false,
+                    vram,
+                    ollamaAvailable: true,
+                    waitRetries,
+                    totalWaitMs: Date.now() - startTime,
+                    reason: `Insufficient VRAM: ${vram.freeMb}MB free < ${this.minVramFreeMb}MB required (after ${waitRetries} retries)`,
+                };
+            }
+            // 待機（指数バックオフ）
+            waitRetries++;
+            const delay = this.waitBaseDelayMs * Math.pow(2, attempt);
+            await this.sleep(delay);
+        }
+        // 到達しないがTypeScript型ガード
+        return {
+            ready: false,
+            vram: null,
+            ollamaAvailable: true,
+            waitRetries,
+            totalWaitMs: Date.now() - startTime,
+            reason: "Unexpected: exceeded retry loop",
+        };
+    }
+    /**
+     * VRAM情報のみ取得（待機なし）
+     *
+     * @returns VRAM情報（GPU非搭載時はnull）
+     */
+    async getVramInfo() {
+        return (0, vram_utils_js_1.queryVram)();
+    }
+    // ===========================================================================
+    // プライベートメソッド
+    // ===========================================================================
+    /**
+     * Ollama接続確認
+     */
+    async checkOllamaAvailable() {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), OLLAMA_API_TIMEOUT_MS);
+            try {
+                const response = await fetch(`${this.ollamaUrl}/api/tags`, {
+                    method: "GET",
+                    signal: controller.signal,
+                });
+                return response.ok;
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 指定ミリ秒だけスリープ
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.OllamaReadinessProbe = OllamaReadinessProbe;
+//# sourceMappingURL=ollama-readiness-probe.js.map

package/dist/services/vision/ollama-readiness-probe.js.map

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