@reftrixmcp/mcp-server 0.1.7

package/dist/tools/page/input.schemas.d.ts

@@ -0,0 +1,2223 @@
+/**
+ * page.analyze MCPツールの入力スキーマ定義
+ * Input schemas + all option types
+ *
+ * @module @reftrixmcp/mcp-server/tools/page/input.schemas
+ */
+import { z } from "zod";
+/** 分析機能フラグ（デフォルト: 全機能有効） */
+export declare const analysisFeaturesSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    /** レイアウト解析（セクション検出含む） */
+    layout: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** モーション検出（アニメーション/トランジション） */
+    motion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** 品質評価（3軸 + AIクリシェ検出） */
+    quality: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    layout: boolean;
+    motion: boolean;
+    quality: boolean;
+}, {
+    layout?: boolean | undefined;
+    motion?: boolean | undefined;
+    quality?: boolean | undefined;
+}>>>;
+export type AnalysisFeatures = z.infer<typeof analysisFeaturesSchema>;
+export declare const viewportSchema: z.ZodObject<{
+    width: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+}, {
+    width?: number | undefined;
+    height?: number | undefined;
+}>;
+export type Viewport = z.infer<typeof viewportSchema>;
+export declare const layoutOptionsSchema: z.ZodOptional<z.ZodObject<{
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        height: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+    include_html: z.ZodOptional<z.ZodBoolean>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    includeHtml: z.ZodOptional<z.ZodBoolean>;
+    includeScreenshot: z.ZodOptional<z.ZodBoolean>;
+    saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    autoAnalyze: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * 外部CSSファイルを取得して解析に含めるか
+     * @default true
+     */
+    fetchExternalCss: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Vision API（Ollama + llama3.2-vision）を使用してスクリーンショットを解析するか
+     * true の場合、スクリーンショートを layout.inspect の screenshot モードに委譲し、
+     * 画像から直接セクション構造・デザイン特徴を抽出する
+     *
+     * NOTE: Ollamaがローカルで起動していない場合は、graceful degradation によりHTML解析のみで続行する
+     * 処理時間が5-10秒増加する点に注意
+     *
+     * @default true
+     */
+    useVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Enable per-section Vision analysis for more accurate semantic search.
+     * Each section gets individual visual feature extraction.
+     * Requires useVision=true.
+     *
+     * @default true (maximum analysis capability)
+     * @warning Increases processing time significantly
+     */
+    perSectionVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Maximum concurrent Vision API calls when perSectionVision is enabled.
+     * Higher values increase speed but may overwhelm Ollama.
+     *
+     * @default 5 (optimized for parallel processing)
+     */
+    visionBatchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Scroll-position Smart Capture + Vision analysis.
+     * Captures viewport screenshots at section boundary scroll positions
+     * and analyzes with Ollama Vision for scroll-triggered animation detection.
+     * Only works in async mode (requires Playwright + Ollama).
+     * @default true (when useVision=true)
+     */
+    scrollVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Maximum number of scroll positions to capture.
+     * @default 10
+     * @min 2
+     * @max 20
+     */
+    scrollVisionMaxCaptures: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    fullPage: boolean;
+    saveToDb: boolean;
+    autoAnalyze: boolean;
+    fetchExternalCss: boolean;
+    useVision: boolean;
+    perSectionVision: boolean;
+    visionBatchSize: number;
+    scrollVision: boolean;
+    scrollVisionMaxCaptures: number;
+    include_html?: boolean | undefined;
+    includeHtml?: boolean | undefined;
+    include_screenshot?: boolean | undefined;
+    includeScreenshot?: boolean | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+}, {
+    include_html?: boolean | undefined;
+    includeHtml?: boolean | undefined;
+    include_screenshot?: boolean | undefined;
+    includeScreenshot?: boolean | undefined;
+    fullPage?: boolean | undefined;
+    viewport?: {
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    saveToDb?: boolean | undefined;
+    autoAnalyze?: boolean | undefined;
+    fetchExternalCss?: boolean | undefined;
+    useVision?: boolean | undefined;
+    perSectionVision?: boolean | undefined;
+    visionBatchSize?: number | undefined;
+    scrollVision?: boolean | undefined;
+    scrollVisionMaxCaptures?: number | undefined;
+}>>;
+export type LayoutOptions = z.infer<typeof layoutOptionsSchema>;
+/**
+ * Vision CPU完走保証オプションスキーマ
+ *
+ * Vision CPU完走保証 Phase 3: GPU/CPU検出に基づく動的タイムアウト・画像最適化オプション
+ *
+ * 用途:
+ * - page.analyze / layout.inspect のVision解析で使用
+ * - HardwareDetector, TimeoutCalculator, ImageOptimizer との統合
+ * - Graceful Degradation（HTML解析フォールバック）のサポート
+ *
+ * タイムアウト値の目安:
+ * - GPU: 60,000ms (1分)
+ * - CPU Small (<100KB): 180,000ms (3分)
+ * - CPU Medium (100KB-500KB): 600,000ms (10分)
+ * - CPU Large (>=500KB): 1,200,000ms (20分)
+ *
+ * @see apps/mcp-server/src/services/vision/hardware-detector.ts
+ * @see apps/mcp-server/src/services/vision/timeout-calculator.ts
+ * @see apps/mcp-server/src/services/vision/image-optimizer.ts
+ */
+export declare const visionOptionsSchema: z.ZodOptional<z.ZodObject<{
+    /**
+     * Vision解析のタイムアウト（ミリ秒）
+     * 未指定時はHardwareDetector + TimeoutCalculatorで自動計算
+     *
+     * @min 1000 (1秒)
+     * @max 1200000 (20分)
+     */
+    visionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Vision解析に渡す画像の最大サイズ（バイト）
+     * これを超える画像はImageOptimizerで圧縮される
+     *
+     * @min 1024 (1KB)
+     * @max 10000000 (10MB)
+     */
+    visionImageMaxSize: z.ZodOptional<z.ZodNumber>;
+    /**
+     * GPUが利用可能でもCPUモードを強制するか
+     * テストやCI環境で有用
+     *
+     * @default false
+     */
+    visionForceCpu: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * 長時間処理時に進捗報告を有効にするか
+     * 将来的なストリーミング対応用
+     *
+     * @default false
+     */
+    visionEnableProgress: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Vision解析がタイムアウト/失敗した場合にHTML解析のみで続行するか
+     * Graceful Degradation設定
+     *
+     * @default true (フォールバック有効)
+     */
+    visionFallbackToHtmlOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    visionForceCpu: boolean;
+    visionEnableProgress: boolean;
+    visionFallbackToHtmlOnly: boolean;
+    visionTimeoutMs?: number | undefined;
+    visionImageMaxSize?: number | undefined;
+}, {
+    visionTimeoutMs?: number | undefined;
+    visionImageMaxSize?: number | undefined;
+    visionForceCpu?: boolean | undefined;
+    visionEnableProgress?: boolean | undefined;
+    visionFallbackToHtmlOnly?: boolean | undefined;
+}>>;
+export type VisionOptions = z.infer<typeof visionOptionsSchema>;
+/** 最大合計フレーム数制限 (motion.detect と同じ) */
+export declare const PAGE_ANALYZE_MAX_TOTAL_FRAMES = 3600;
+/**
+ * page.analyze 各フェーズのタイムアウト定数
+ *
+ * 問題背景: 600秒タイムアウトが発生する原因
+ * - HTMLフェッチのみにタイムアウトが適用され、並列分析フェーズには伝播しない
+ * - フレームキャプチャに上限がなく、大きなページで数千フレームをキャプチャ
+ * - networkidleは遅いサイトで非常に時間がかかる
+ *
+ * 改善策:
+ * - 各フェーズに個別タイムアウトを設定
+ * - フレームキャプチャに最大フレーム数制限を追加
+ * - タイムアウト時は部分結果を返却（Graceful Degradation）
+ */
+export declare const PAGE_ANALYZE_TIMEOUTS: {
+    /** HTML取得フェーズのタイムアウト（ms） - デフォルト60秒 */
+    readonly FETCH_HTML: 60000;
+    /** レイアウト分析フェーズのタイムアウト（ms） - 30秒 */
+    readonly LAYOUT_ANALYSIS: 30000;
+    /** モーション検出フェーズのタイムアウト（ms） - フレームキャプチャ含む場合120秒 */
+    readonly MOTION_DETECTION: 120000;
+    /** 品質評価フェーズのタイムアウト（ms） - 15秒 */
+    readonly QUALITY_EVALUATION: 15000;
+    /** フレームキャプチャのタイムアウト（ms） - 90秒 */
+    readonly FRAME_CAPTURE: 90000;
+    /**
+     * JSアニメーション検出のタイムアウト（ms）
+     * WebGL/Three.jsサイトではPlaywright起動 + ページ読み込み + CDP検出に時間がかかるため、
+     * 120秒（2分）を確保。軽量サイトでは早期に完了する。
+     * @default 120000 (2分)
+     */
+    readonly JS_ANIMATION_DETECTION: 120000;
+    /** DB保存のタイムアウト（ms） - 30秒 */
+    readonly DB_SAVE: 30000;
+    /** Vision解析のタイムアウト（ms） - 30秒 */
+    readonly VISION_ANALYSIS: 30000;
+};
+/** フレームキャプチャの最大フレーム数 */
+export declare const PAGE_ANALYZE_FRAME_CAPTURE_MAX_FRAMES = 1000;
+/**
+ * フレームキャプチャオプションスキーマ (page.analyze 用)
+ *
+ * motion.detect の frameCaptureOptionsSchema と同等の構造。
+ * セキュリティ対策:
+ * - output_dir: パストラバーサル文字(..)を禁止
+ * - filename_pattern: パス区切り文字(/、..)を禁止
+ */
+export declare const pageAnalyzeFrameCaptureOptionsSchema: z.ZodEffects<z.ZodObject<{
+    frame_rate: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    frame_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    scroll_speed_px_per_sec: z.ZodOptional<z.ZodNumber>;
+    scroll_px_per_frame: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    output_format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>>;
+    output_dir: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+    filename_pattern: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+    page_height_px: z.ZodOptional<z.ZodNumber>;
+    scroll_duration_sec: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    frame_rate: number;
+    frame_interval_ms: number;
+    scroll_px_per_frame: number;
+    output_format: "png" | "jpeg";
+    output_dir: string;
+    filename_pattern: string;
+    scroll_speed_px_per_sec?: number | undefined;
+    page_height_px?: number | undefined;
+    scroll_duration_sec?: number | undefined;
+}, {
+    frame_rate?: number | undefined;
+    frame_interval_ms?: number | undefined;
+    scroll_speed_px_per_sec?: number | undefined;
+    scroll_px_per_frame?: number | undefined;
+    output_format?: "png" | "jpeg" | undefined;
+    output_dir?: string | undefined;
+    filename_pattern?: string | undefined;
+    page_height_px?: number | undefined;
+    scroll_duration_sec?: number | undefined;
+}>, {
+    frame_rate: number;
+    frame_interval_ms: number;
+    scroll_px_per_frame: number;
+    output_format: "png" | "jpeg";
+    output_dir: string;
+    filename_pattern: string;
+    scroll_speed_px_per_sec?: number | undefined;
+    page_height_px?: number | undefined;
+    scroll_duration_sec?: number | undefined;
+}, {
+    frame_rate?: number | undefined;
+    frame_interval_ms?: number | undefined;
+    scroll_speed_px_per_sec?: number | undefined;
+    scroll_px_per_frame?: number | undefined;
+    output_format?: "png" | "jpeg" | undefined;
+    output_dir?: string | undefined;
+    filename_pattern?: string | undefined;
+    page_height_px?: number | undefined;
+    scroll_duration_sec?: number | undefined;
+}>;
+export type PageAnalyzeFrameCaptureOptions = z.infer<typeof pageAnalyzeFrameCaptureOptionsSchema>;
+/**
+ * フレーム画像分析オプションスキーマ (page.analyze 用)
+ *
+ * motion.detect の frameImageAnalysisInputOptionsSchema と同等の構造。
+ * CLS検出、差分解析などフレーム画像分析のオプション。
+ */
+export declare const pageAnalyzeFrameAnalysisOptionsSchema: z.ZodObject<{
+    /** フレーム画像ディレクトリ（省略時はframe_capture_options.output_dir使用） */
+    frame_dir: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    /** サンプリング間隔（N番目のフレームごと、デフォルト: 1 = 全フレーム） */
+    sample_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** ピクセル差分しきい値（0-1、デフォルト: 0.01 = 1%） */
+    diff_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** CLS（レイアウトシフト）しきい値（デフォルト: 0.1、WCAG推奨値） */
+    cls_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** モーション検出しきい値（ピクセル、デフォルト: 5） */
+    motion_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** 差分可視化画像を出力するか（デフォルト: false） */
+    output_diff_images: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** 並列処理を有効にするか（デフォルト: true） */
+    parallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    sample_interval: number;
+    diff_threshold: number;
+    cls_threshold: number;
+    motion_threshold: number;
+    output_diff_images: boolean;
+    parallel: boolean;
+    frame_dir?: string | undefined;
+}, {
+    frame_dir?: string | undefined;
+    sample_interval?: number | undefined;
+    diff_threshold?: number | undefined;
+    cls_threshold?: number | undefined;
+    motion_threshold?: number | undefined;
+    output_diff_images?: boolean | undefined;
+    parallel?: boolean | undefined;
+}>;
+export type PageAnalyzeFrameAnalysisOptions = z.infer<typeof pageAnalyzeFrameAnalysisOptionsSchema>;
+/**
+ * WebGLアニメーション検出オプションスキーマ (page.analyze 用)
+ *
+ * Canvas/WebGLベースのアニメーション（Three.js等）をフレームベースで検出するオプション
+ * @see WebGLAnimationDetectorService
+ */
+export declare const webglAnimationOptionsSchema: z.ZodObject<{
+    /**
+     * サンプリングするフレーム数
+     * @default 50 (maximum analysis capability)
+     * @min 5
+     * @max 100
+     */
+    sample_frames: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * フレーム間隔（ms）
+     * @default 100
+     * @min 50
+     * @max 500
+     */
+    sample_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * 変化検出しきい値（0-1）
+     * @default 0.005 (high sensitivity for maximum detection)
+     * @min 0.001
+     * @max 0.5
+     */
+    change_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * 検出タイムアウト（ms）
+     * v0.1.0: デフォルトを120秒に増加（重いWebGLサイト対応）
+     * @default 120000
+     * @min 5000
+     * @max 180000
+     */
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    sample_frames: number;
+    sample_interval_ms: number;
+    change_threshold: number;
+    timeout_ms: number;
+}, {
+    sample_frames?: number | undefined;
+    sample_interval_ms?: number | undefined;
+    change_threshold?: number | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type WebGLAnimationOptions = z.infer<typeof webglAnimationOptionsSchema>;
+/**
+ * JSアニメーション検出オプションスキーマ (page.analyze 用)
+ *
+ * Chrome DevTools Protocol + Web Animations API + ライブラリシグネチャ検出のオプション
+ * @see motion.detect の js_animation_options と同等の構造
+ */
+export declare const jsAnimationOptionsSchema: z.ZodObject<{
+    /**
+     * CDPアニメーション検出を有効にするか
+     * @default true
+     */
+    enableCDP: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Web Animations API検出を有効にするか
+     * @default true
+     */
+    enableWebAnimations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * ライブラリ検出を有効にするか (GSAP, Framer Motion, anime.js, Three.js, Lottie)
+     * @default true
+     */
+    enableLibraryDetection: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * アニメーション待機時間（ms）- ページ読み込み後、アニメーション開始を待つ時間
+     * @default 2000
+     */
+    waitTime: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    enableCDP: boolean;
+    enableWebAnimations: boolean;
+    enableLibraryDetection: boolean;
+    waitTime: number;
+}, {
+    enableCDP?: boolean | undefined;
+    enableWebAnimations?: boolean | undefined;
+    enableLibraryDetection?: boolean | undefined;
+    waitTime?: number | undefined;
+}>;
+export type JSAnimationOptions = z.infer<typeof jsAnimationOptionsSchema>;
+/**
+ * モーション検出モード
+ * - css: CSS静的解析のみ（最速、デフォルト）
+ * - video: 動画録画+フレーム解析（motion.detectと同等）
+ * - runtime: Playwrightでページ読み込み後のランタイムアニメーション検出
+ * - hybrid: CSS静的解析 + ランタイム検出の組み合わせ
+ */
+export declare const motionDetectionModeSchema: z.ZodEnum<["css", "video", "runtime", "hybrid"]>;
+export type MotionDetectionMode = z.infer<typeof motionDetectionModeSchema>;
+export declare const motionOptionsSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    /**
+     * モーション検出モード
+     * - css: CSS静的解析のみ（最速、デフォルト）
+     * - video: 動画録画+フレーム解析（motion.detectのvideo modeと同等）
+     * - runtime: Playwrightでランタイムアニメーション検出
+     * - hybrid: CSS + ランタイム検出の組み合わせ（WebGLサイト対応）
+     * @default 'css' (v0.1.0: タイムアウト問題回避のためCSSのみに戻す)
+     */
+    detection_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["css", "video", "runtime", "hybrid"]>>>;
+    /** 外部CSSファイルを取得して解析に含めるか（v0.1.0でデフォルトtrue化） */
+    fetchExternalCss: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    minDuration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxPatterns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    includeWarnings: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * フレームキャプチャを有効にするか
+     * @default false (v0.1.0: タイムアウト問題回避のためデフォルト無効化)
+     * 有効化する場合は明示的に true を指定
+     */
+    enable_frame_capture: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** フレームキャプチャオプション（enable_frame_capture=true時のみ有効） */
+    frame_capture_options: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        frame_rate: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        frame_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        scroll_speed_px_per_sec: z.ZodOptional<z.ZodNumber>;
+        scroll_px_per_frame: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        output_format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>>;
+        output_dir: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+        filename_pattern: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+        page_height_px: z.ZodOptional<z.ZodNumber>;
+        scroll_duration_sec: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        frame_rate: number;
+        frame_interval_ms: number;
+        scroll_px_per_frame: number;
+        output_format: "png" | "jpeg";
+        output_dir: string;
+        filename_pattern: string;
+        scroll_speed_px_per_sec?: number | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    }, {
+        frame_rate?: number | undefined;
+        frame_interval_ms?: number | undefined;
+        scroll_speed_px_per_sec?: number | undefined;
+        scroll_px_per_frame?: number | undefined;
+        output_format?: "png" | "jpeg" | undefined;
+        output_dir?: string | undefined;
+        filename_pattern?: string | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    }>, {
+        frame_rate: number;
+        frame_interval_ms: number;
+        scroll_px_per_frame: number;
+        output_format: "png" | "jpeg";
+        output_dir: string;
+        filename_pattern: string;
+        scroll_speed_px_per_sec?: number | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    }, {
+        frame_rate?: number | undefined;
+        frame_interval_ms?: number | undefined;
+        scroll_speed_px_per_sec?: number | undefined;
+        scroll_px_per_frame?: number | undefined;
+        output_format?: "png" | "jpeg" | undefined;
+        output_dir?: string | undefined;
+        filename_pattern?: string | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    }>>;
+    /**
+     * フレーム画像分析を有効にするか
+     * @default false (v0.1.0: タイムアウト問題回避のためデフォルト無効化)
+     */
+    analyze_frames: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** フレーム画像分析オプション（analyze_frames=true時のみ有効） */
+    frame_analysis_options: z.ZodOptional<z.ZodObject<{
+        /** フレーム画像ディレクトリ（省略時はframe_capture_options.output_dir使用） */
+        frame_dir: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        /** サンプリング間隔（N番目のフレームごと、デフォルト: 1 = 全フレーム） */
+        sample_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** ピクセル差分しきい値（0-1、デフォルト: 0.01 = 1%） */
+        diff_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** CLS（レイアウトシフト）しきい値（デフォルト: 0.1、WCAG推奨値） */
+        cls_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** モーション検出しきい値（ピクセル、デフォルト: 5） */
+        motion_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** 差分可視化画像を出力するか（デフォルト: false） */
+        output_diff_images: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** 並列処理を有効にするか（デフォルト: true） */
+        parallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        sample_interval: number;
+        diff_threshold: number;
+        cls_threshold: number;
+        motion_threshold: number;
+        output_diff_images: boolean;
+        parallel: boolean;
+        frame_dir?: string | undefined;
+    }, {
+        frame_dir?: string | undefined;
+        sample_interval?: number | undefined;
+        diff_threshold?: number | undefined;
+        cls_threshold?: number | undefined;
+        motion_threshold?: number | undefined;
+        output_diff_images?: boolean | undefined;
+        parallel?: boolean | undefined;
+    }>>;
+    /**
+     * 動画録画・フレーム解析オプション
+     * detection_mode='video'の場合のみ有効
+     */
+    video_options: z.ZodOptional<z.ZodObject<{
+        /** ページ読み込みタイムアウト (1000-120000ms) @default 30000 */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** 録画時間 (1000-60000ms) @default 10000 */
+        record_duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** ビューポートサイズ */
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width: number;
+            height: number;
+        }>>;
+        /** スクロール操作を行うか @default true */
+        scroll_page: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** マウス移動操作を行うか @default true */
+        move_mouse: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** ページロード完了待機戦略 @default 'domcontentloaded' */
+        wait_until: z.ZodDefault<z.ZodOptional<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>>;
+        /** フレーム解析オプション */
+        frame_analysis: z.ZodOptional<z.ZodObject<{
+            /** フレームレート (1-30fps) @default 15 */
+            fps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** 変化検出閾値 (0-1) @default 0.005 */
+            change_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** 最小モーション継続時間 (ms) @default 50 */
+            min_motion_duration_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** ギャップ許容時間 (ms) @default 50 */
+            gap_tolerance_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            change_threshold: number;
+            fps: number;
+            min_motion_duration_ms: number;
+            gap_tolerance_ms: number;
+        }, {
+            change_threshold?: number | undefined;
+            fps?: number | undefined;
+            min_motion_duration_ms?: number | undefined;
+            gap_tolerance_ms?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        timeout: number;
+        record_duration: number;
+        scroll_page: boolean;
+        move_mouse: boolean;
+        wait_until: "load" | "domcontentloaded" | "networkidle";
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        frame_analysis?: {
+            change_threshold: number;
+            fps: number;
+            min_motion_duration_ms: number;
+            gap_tolerance_ms: number;
+        } | undefined;
+    }, {
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        timeout?: number | undefined;
+        record_duration?: number | undefined;
+        scroll_page?: boolean | undefined;
+        move_mouse?: boolean | undefined;
+        wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        frame_analysis?: {
+            change_threshold?: number | undefined;
+            fps?: number | undefined;
+            min_motion_duration_ms?: number | undefined;
+            gap_tolerance_ms?: number | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * ランタイム検出オプション
+     * detection_mode='runtime'または'hybrid'の場合のみ有効
+     */
+    runtime_options: z.ZodOptional<z.ZodObject<{
+        /** アニメーション待機時間 (0-30000ms) @default 5000 */
+        wait_for_animations: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** スクロール位置の配列 (0-100%) 最大20個 */
+        scroll_positions: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        wait_for_animations: number;
+        scroll_positions?: number[] | undefined;
+    }, {
+        wait_for_animations?: number | undefined;
+        scroll_positions?: number[] | undefined;
+    }>>;
+    /**
+     * JavaScript駆動アニメーション検出を有効にするか
+     * CDP Animation API + Web Animations API + ライブラリ検出 を統合
+     * Playwrightが必要で処理に30秒以上かかる場合あり
+     * @default true (v0.1.0: データ蓄積のため再有効化、asyncモードで長時間検出可能)
+     */
+    detect_js_animations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * JSアニメーション検出の詳細オプション
+     * detect_js_animations=true時のみ有効
+     */
+    js_animation_options: z.ZodOptional<z.ZodObject<{
+        /**
+         * CDPアニメーション検出を有効にするか
+         * @default true
+         */
+        enableCDP: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Web Animations API検出を有効にするか
+         * @default true
+         */
+        enableWebAnimations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * ライブラリ検出を有効にするか (GSAP, Framer Motion, anime.js, Three.js, Lottie)
+         * @default true
+         */
+        enableLibraryDetection: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * アニメーション待機時間（ms）- ページ読み込み後、アニメーション開始を待つ時間
+         * @default 2000
+         */
+        waitTime: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        enableCDP: boolean;
+        enableWebAnimations: boolean;
+        enableLibraryDetection: boolean;
+        waitTime: number;
+    }, {
+        enableCDP?: boolean | undefined;
+        enableWebAnimations?: boolean | undefined;
+        enableLibraryDetection?: boolean | undefined;
+        waitTime?: number | undefined;
+    }>>;
+    /**
+     * WebGL/Canvasベースのアニメーション検出を有効にするか
+     * Three.js等のWebGLアニメーションをフレームベースで検出
+     * Playwrightが必要で処理に30秒以上かかる場合あり
+     * @default true (v0.1.0: データ蓄積のため再有効化、asyncモードで長時間検出可能)
+     */
+    detect_webgl_animations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * WebGLアニメーション検出の詳細オプション
+     * detect_webgl_animations=true時のみ有効
+     */
+    webgl_animation_options: z.ZodOptional<z.ZodObject<{
+        /**
+         * サンプリングするフレーム数
+         * @default 50 (maximum analysis capability)
+         * @min 5
+         * @max 100
+         */
+        sample_frames: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * フレーム間隔（ms）
+         * @default 100
+         * @min 50
+         * @max 500
+         */
+        sample_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * 変化検出しきい値（0-1）
+         * @default 0.005 (high sensitivity for maximum detection)
+         * @min 0.001
+         * @max 0.5
+         */
+        change_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * 検出タイムアウト（ms）
+         * v0.1.0: デフォルトを120秒に増加（重いWebGLサイト対応）
+         * @default 120000
+         * @min 5000
+         * @max 180000
+         */
+        timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        sample_frames: number;
+        sample_interval_ms: number;
+        change_threshold: number;
+        timeout_ms: number;
+    }, {
+        sample_frames?: number | undefined;
+        sample_interval_ms?: number | undefined;
+        change_threshold?: number | undefined;
+        timeout_ms?: number | undefined;
+    }>>;
+    /**
+     * Motion検出のタイムアウト（ミリ秒）
+     *
+     * MCP Protocol (Claude Desktop/API) には60秒のツール呼び出し制限があります。
+     * page.analyzeのasyncモードでは、この制限が適用されないため、
+     * 長時間のmotion検出が可能です。
+     *
+     * 同期モード（async=false）では、このパラメータはツール内部処理用であり、
+     * MCP層の60秒制限を上書きすることはできません。
+     *
+     * @default 300000 (5分)
+     * @min 30000 (30秒)
+     * @max 600000 (10分)
+     */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    saveToDb: boolean;
+    fetchExternalCss: boolean;
+    detection_mode: "css" | "video" | "runtime" | "hybrid";
+    minDuration: number;
+    maxPatterns: number;
+    includeWarnings: boolean;
+    enable_frame_capture: boolean;
+    analyze_frames: boolean;
+    timeout: number;
+    detect_js_animations: boolean;
+    detect_webgl_animations: boolean;
+    frame_capture_options?: {
+        frame_rate: number;
+        frame_interval_ms: number;
+        scroll_px_per_frame: number;
+        output_format: "png" | "jpeg";
+        output_dir: string;
+        filename_pattern: string;
+        scroll_speed_px_per_sec?: number | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    } | undefined;
+    frame_analysis_options?: {
+        sample_interval: number;
+        diff_threshold: number;
+        cls_threshold: number;
+        motion_threshold: number;
+        output_diff_images: boolean;
+        parallel: boolean;
+        frame_dir?: string | undefined;
+    } | undefined;
+    video_options?: {
+        timeout: number;
+        record_duration: number;
+        scroll_page: boolean;
+        move_mouse: boolean;
+        wait_until: "load" | "domcontentloaded" | "networkidle";
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        frame_analysis?: {
+            change_threshold: number;
+            fps: number;
+            min_motion_duration_ms: number;
+            gap_tolerance_ms: number;
+        } | undefined;
+    } | undefined;
+    runtime_options?: {
+        wait_for_animations: number;
+        scroll_positions?: number[] | undefined;
+    } | undefined;
+    js_animation_options?: {
+        enableCDP: boolean;
+        enableWebAnimations: boolean;
+        enableLibraryDetection: boolean;
+        waitTime: number;
+    } | undefined;
+    webgl_animation_options?: {
+        sample_frames: number;
+        sample_interval_ms: number;
+        change_threshold: number;
+        timeout_ms: number;
+    } | undefined;
+}, {
+    saveToDb?: boolean | undefined;
+    fetchExternalCss?: boolean | undefined;
+    detection_mode?: "css" | "video" | "runtime" | "hybrid" | undefined;
+    minDuration?: number | undefined;
+    maxPatterns?: number | undefined;
+    includeWarnings?: boolean | undefined;
+    enable_frame_capture?: boolean | undefined;
+    frame_capture_options?: {
+        frame_rate?: number | undefined;
+        frame_interval_ms?: number | undefined;
+        scroll_speed_px_per_sec?: number | undefined;
+        scroll_px_per_frame?: number | undefined;
+        output_format?: "png" | "jpeg" | undefined;
+        output_dir?: string | undefined;
+        filename_pattern?: string | undefined;
+        page_height_px?: number | undefined;
+        scroll_duration_sec?: number | undefined;
+    } | undefined;
+    analyze_frames?: boolean | undefined;
+    frame_analysis_options?: {
+        frame_dir?: string | undefined;
+        sample_interval?: number | undefined;
+        diff_threshold?: number | undefined;
+        cls_threshold?: number | undefined;
+        motion_threshold?: number | undefined;
+        output_diff_images?: boolean | undefined;
+        parallel?: boolean | undefined;
+    } | undefined;
+    timeout?: number | undefined;
+    video_options?: {
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        timeout?: number | undefined;
+        record_duration?: number | undefined;
+        scroll_page?: boolean | undefined;
+        move_mouse?: boolean | undefined;
+        wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        frame_analysis?: {
+            change_threshold?: number | undefined;
+            fps?: number | undefined;
+            min_motion_duration_ms?: number | undefined;
+            gap_tolerance_ms?: number | undefined;
+        } | undefined;
+    } | undefined;
+    runtime_options?: {
+        wait_for_animations?: number | undefined;
+        scroll_positions?: number[] | undefined;
+    } | undefined;
+    detect_js_animations?: boolean | undefined;
+    js_animation_options?: {
+        enableCDP?: boolean | undefined;
+        enableWebAnimations?: boolean | undefined;
+        enableLibraryDetection?: boolean | undefined;
+        waitTime?: number | undefined;
+    } | undefined;
+    detect_webgl_animations?: boolean | undefined;
+    webgl_animation_options?: {
+        sample_frames?: number | undefined;
+        sample_interval_ms?: number | undefined;
+        change_threshold?: number | undefined;
+        timeout_ms?: number | undefined;
+    } | undefined;
+}>>>;
+export type MotionOptions = z.infer<typeof motionOptionsSchema>;
+export declare const qualityOptionsSchema: z.ZodOptional<z.ZodObject<{
+    weights: z.ZodOptional<z.ZodObject<{
+        originality: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        craftsmanship: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        contextuality: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        originality: number;
+        craftsmanship: number;
+        contextuality: number;
+    }, {
+        originality?: number | undefined;
+        craftsmanship?: number | undefined;
+        contextuality?: number | undefined;
+    }>>;
+    targetIndustry: z.ZodOptional<z.ZodString>;
+    targetAudience: z.ZodOptional<z.ZodString>;
+    strict: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeRecommendations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    strict: boolean;
+    includeRecommendations: boolean;
+    weights?: {
+        originality: number;
+        craftsmanship: number;
+        contextuality: number;
+    } | undefined;
+    targetIndustry?: string | undefined;
+    targetAudience?: string | undefined;
+}, {
+    strict?: boolean | undefined;
+    weights?: {
+        originality?: number | undefined;
+        craftsmanship?: number | undefined;
+        contextuality?: number | undefined;
+    } | undefined;
+    targetIndustry?: string | undefined;
+    targetAudience?: string | undefined;
+    includeRecommendations?: boolean | undefined;
+}>>;
+export type QualityOptions = z.infer<typeof qualityOptionsSchema>;
+/**
+ * Narrative分析オプションスキーマ
+ *
+ * page.analyzeでWebページの「世界観・雰囲気（WorldView）」と
+ * 「レイアウト構成（LayoutStructure）」を分析するオプション。
+ *
+ * 機能:
+ * - WorldViewAnalyzer: 色彩印象、タイポグラフィ性格、モーション感情、全体トーン
+ * - LayoutStructureAnalyzer: グリッドシステム、視覚的階層、スペーシングリズム
+ * - Embedding生成（multilingual-e5-base、768次元）
+ * - DB保存（DesignNarrative, DesignNarrativeEmbedding）
+ *
+ * @see NarrativeAnalysisService
+ */
+export declare const narrativeOptionsSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    /**
+     * Narrative分析を有効化するか
+     * @default true
+     */
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * 分析結果をDBに保存するか
+     * @default true
+     */
+    saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Vision LLM（Ollama llama3.2-vision）を使用するか
+     * trueの場合、スクリーンショットを使用してより精度の高い分析を行う
+     * @default true
+     */
+    includeVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Vision解析タイムアウト（ミリ秒）
+     * @default 300000 (5分)
+     * @min 30000 (30秒)
+     * @max 600000 (10分)
+     */
+    visionTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Embedding生成を含むか
+     * @default true
+     */
+    generateEmbedding: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    saveToDb: boolean;
+    visionTimeoutMs: number;
+    includeVision: boolean;
+    generateEmbedding: boolean;
+}, {
+    enabled?: boolean | undefined;
+    saveToDb?: boolean | undefined;
+    visionTimeoutMs?: number | undefined;
+    includeVision?: boolean | undefined;
+    generateEmbedding?: boolean | undefined;
+}>>>;
+export type NarrativeOptions = z.infer<typeof narrativeOptionsSchema>;
+/**
+ * タイムアウト戦略
+ * - strict: タイムアウト発生時は完全に失敗（部分結果なし）
+ * - progressive: タイムアウト発生時も部分結果を返却（デフォルト）
+ */
+export declare const timeoutStrategySchema: z.ZodEnum<["strict", "progressive"]>;
+export type TimeoutStrategy = z.infer<typeof timeoutStrategySchema>;
+/** page.analyze 入力スキーマ */
+export declare const pageAnalyzeInputSchema: z.ZodObject<{
+    url: z.ZodEffects<z.ZodString, string, string>;
+    sourceType: z.ZodDefault<z.ZodOptional<z.ZodEnum<["award_gallery", "user_provided"]>>>;
+    usageScope: z.ZodDefault<z.ZodOptional<z.ZodEnum<["inspiration_only", "owned_asset"]>>>;
+    features: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** レイアウト解析（セクション検出含む） */
+        layout: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** モーション検出（アニメーション/トランジション） */
+        motion: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** 品質評価（3軸 + AIクリシェ検出） */
+        quality: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        layout: boolean;
+        motion: boolean;
+        quality: boolean;
+    }, {
+        layout?: boolean | undefined;
+        motion?: boolean | undefined;
+        quality?: boolean | undefined;
+    }>>>;
+    layoutOptions: z.ZodOptional<z.ZodObject<{
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            height: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width?: number | undefined;
+            height?: number | undefined;
+        }>>;
+        include_html: z.ZodOptional<z.ZodBoolean>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        includeHtml: z.ZodOptional<z.ZodBoolean>;
+        includeScreenshot: z.ZodOptional<z.ZodBoolean>;
+        saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        autoAnalyze: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * 外部CSSファイルを取得して解析に含めるか
+         * @default true
+         */
+        fetchExternalCss: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Vision API（Ollama + llama3.2-vision）を使用してスクリーンショットを解析するか
+         * true の場合、スクリーンショートを layout.inspect の screenshot モードに委譲し、
+         * 画像から直接セクション構造・デザイン特徴を抽出する
+         *
+         * NOTE: Ollamaがローカルで起動していない場合は、graceful degradation によりHTML解析のみで続行する
+         * 処理時間が5-10秒増加する点に注意
+         *
+         * @default true
+         */
+        useVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Enable per-section Vision analysis for more accurate semantic search.
+         * Each section gets individual visual feature extraction.
+         * Requires useVision=true.
+         *
+         * @default true (maximum analysis capability)
+         * @warning Increases processing time significantly
+         */
+        perSectionVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Maximum concurrent Vision API calls when perSectionVision is enabled.
+         * Higher values increase speed but may overwhelm Ollama.
+         *
+         * @default 5 (optimized for parallel processing)
+         */
+        visionBatchSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Scroll-position Smart Capture + Vision analysis.
+         * Captures viewport screenshots at section boundary scroll positions
+         * and analyzes with Ollama Vision for scroll-triggered animation detection.
+         * Only works in async mode (requires Playwright + Ollama).
+         * @default true (when useVision=true)
+         */
+        scrollVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Maximum number of scroll positions to capture.
+         * @default 10
+         * @min 2
+         * @max 20
+         */
+        scrollVisionMaxCaptures: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        fullPage: boolean;
+        saveToDb: boolean;
+        autoAnalyze: boolean;
+        fetchExternalCss: boolean;
+        useVision: boolean;
+        perSectionVision: boolean;
+        visionBatchSize: number;
+        scrollVision: boolean;
+        scrollVisionMaxCaptures: number;
+        include_html?: boolean | undefined;
+        includeHtml?: boolean | undefined;
+        include_screenshot?: boolean | undefined;
+        includeScreenshot?: boolean | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+    }, {
+        include_html?: boolean | undefined;
+        includeHtml?: boolean | undefined;
+        include_screenshot?: boolean | undefined;
+        includeScreenshot?: boolean | undefined;
+        fullPage?: boolean | undefined;
+        viewport?: {
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        saveToDb?: boolean | undefined;
+        autoAnalyze?: boolean | undefined;
+        fetchExternalCss?: boolean | undefined;
+        useVision?: boolean | undefined;
+        perSectionVision?: boolean | undefined;
+        visionBatchSize?: number | undefined;
+        scrollVision?: boolean | undefined;
+        scrollVisionMaxCaptures?: number | undefined;
+    }>>;
+    motionOptions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * モーション検出モード
+         * - css: CSS静的解析のみ（最速、デフォルト）
+         * - video: 動画録画+フレーム解析（motion.detectのvideo modeと同等）
+         * - runtime: Playwrightでランタイムアニメーション検出
+         * - hybrid: CSS + ランタイム検出の組み合わせ（WebGLサイト対応）
+         * @default 'css' (v0.1.0: タイムアウト問題回避のためCSSのみに戻す)
+         */
+        detection_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["css", "video", "runtime", "hybrid"]>>>;
+        /** 外部CSSファイルを取得して解析に含めるか（v0.1.0でデフォルトtrue化） */
+        fetchExternalCss: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        minDuration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        maxPatterns: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        includeWarnings: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * フレームキャプチャを有効にするか
+         * @default false (v0.1.0: タイムアウト問題回避のためデフォルト無効化)
+         * 有効化する場合は明示的に true を指定
+         */
+        enable_frame_capture: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** フレームキャプチャオプション（enable_frame_capture=true時のみ有効） */
+        frame_capture_options: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            frame_rate: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            frame_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            scroll_speed_px_per_sec: z.ZodOptional<z.ZodNumber>;
+            scroll_px_per_frame: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            output_format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>>;
+            output_dir: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+            filename_pattern: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
+            page_height_px: z.ZodOptional<z.ZodNumber>;
+            scroll_duration_sec: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            frame_rate: number;
+            frame_interval_ms: number;
+            scroll_px_per_frame: number;
+            output_format: "png" | "jpeg";
+            output_dir: string;
+            filename_pattern: string;
+            scroll_speed_px_per_sec?: number | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        }, {
+            frame_rate?: number | undefined;
+            frame_interval_ms?: number | undefined;
+            scroll_speed_px_per_sec?: number | undefined;
+            scroll_px_per_frame?: number | undefined;
+            output_format?: "png" | "jpeg" | undefined;
+            output_dir?: string | undefined;
+            filename_pattern?: string | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        }>, {
+            frame_rate: number;
+            frame_interval_ms: number;
+            scroll_px_per_frame: number;
+            output_format: "png" | "jpeg";
+            output_dir: string;
+            filename_pattern: string;
+            scroll_speed_px_per_sec?: number | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        }, {
+            frame_rate?: number | undefined;
+            frame_interval_ms?: number | undefined;
+            scroll_speed_px_per_sec?: number | undefined;
+            scroll_px_per_frame?: number | undefined;
+            output_format?: "png" | "jpeg" | undefined;
+            output_dir?: string | undefined;
+            filename_pattern?: string | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        }>>;
+        /**
+         * フレーム画像分析を有効にするか
+         * @default false (v0.1.0: タイムアウト問題回避のためデフォルト無効化)
+         */
+        analyze_frames: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** フレーム画像分析オプション（analyze_frames=true時のみ有効） */
+        frame_analysis_options: z.ZodOptional<z.ZodObject<{
+            /** フレーム画像ディレクトリ（省略時はframe_capture_options.output_dir使用） */
+            frame_dir: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            /** サンプリング間隔（N番目のフレームごと、デフォルト: 1 = 全フレーム） */
+            sample_interval: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** ピクセル差分しきい値（0-1、デフォルト: 0.01 = 1%） */
+            diff_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** CLS（レイアウトシフト）しきい値（デフォルト: 0.1、WCAG推奨値） */
+            cls_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** モーション検出しきい値（ピクセル、デフォルト: 5） */
+            motion_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** 差分可視化画像を出力するか（デフォルト: false） */
+            output_diff_images: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** 並列処理を有効にするか（デフォルト: true） */
+            parallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            sample_interval: number;
+            diff_threshold: number;
+            cls_threshold: number;
+            motion_threshold: number;
+            output_diff_images: boolean;
+            parallel: boolean;
+            frame_dir?: string | undefined;
+        }, {
+            frame_dir?: string | undefined;
+            sample_interval?: number | undefined;
+            diff_threshold?: number | undefined;
+            cls_threshold?: number | undefined;
+            motion_threshold?: number | undefined;
+            output_diff_images?: boolean | undefined;
+            parallel?: boolean | undefined;
+        }>>;
+        /**
+         * 動画録画・フレーム解析オプション
+         * detection_mode='video'の場合のみ有効
+         */
+        video_options: z.ZodOptional<z.ZodObject<{
+            /** ページ読み込みタイムアウト (1000-120000ms) @default 30000 */
+            timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** 録画時間 (1000-60000ms) @default 10000 */
+            record_duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** ビューポートサイズ */
+            viewport: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                width: number;
+                height: number;
+            }, {
+                width: number;
+                height: number;
+            }>>;
+            /** スクロール操作を行うか @default true */
+            scroll_page: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** マウス移動操作を行うか @default true */
+            move_mouse: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** ページロード完了待機戦略 @default 'domcontentloaded' */
+            wait_until: z.ZodDefault<z.ZodOptional<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>>;
+            /** フレーム解析オプション */
+            frame_analysis: z.ZodOptional<z.ZodObject<{
+                /** フレームレート (1-30fps) @default 15 */
+                fps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                /** 変化検出閾値 (0-1) @default 0.005 */
+                change_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                /** 最小モーション継続時間 (ms) @default 50 */
+                min_motion_duration_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                /** ギャップ許容時間 (ms) @default 50 */
+                gap_tolerance_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, "strip", z.ZodTypeAny, {
+                change_threshold: number;
+                fps: number;
+                min_motion_duration_ms: number;
+                gap_tolerance_ms: number;
+            }, {
+                change_threshold?: number | undefined;
+                fps?: number | undefined;
+                min_motion_duration_ms?: number | undefined;
+                gap_tolerance_ms?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            timeout: number;
+            record_duration: number;
+            scroll_page: boolean;
+            move_mouse: boolean;
+            wait_until: "load" | "domcontentloaded" | "networkidle";
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            frame_analysis?: {
+                change_threshold: number;
+                fps: number;
+                min_motion_duration_ms: number;
+                gap_tolerance_ms: number;
+            } | undefined;
+        }, {
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            timeout?: number | undefined;
+            record_duration?: number | undefined;
+            scroll_page?: boolean | undefined;
+            move_mouse?: boolean | undefined;
+            wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+            frame_analysis?: {
+                change_threshold?: number | undefined;
+                fps?: number | undefined;
+                min_motion_duration_ms?: number | undefined;
+                gap_tolerance_ms?: number | undefined;
+            } | undefined;
+        }>>;
+        /**
+         * ランタイム検出オプション
+         * detection_mode='runtime'または'hybrid'の場合のみ有効
+         */
+        runtime_options: z.ZodOptional<z.ZodObject<{
+            /** アニメーション待機時間 (0-30000ms) @default 5000 */
+            wait_for_animations: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** スクロール位置の配列 (0-100%) 最大20個 */
+            scroll_positions: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            wait_for_animations: number;
+            scroll_positions?: number[] | undefined;
+        }, {
+            wait_for_animations?: number | undefined;
+            scroll_positions?: number[] | undefined;
+        }>>;
+        /**
+         * JavaScript駆動アニメーション検出を有効にするか
+         * CDP Animation API + Web Animations API + ライブラリ検出 を統合
+         * Playwrightが必要で処理に30秒以上かかる場合あり
+         * @default true (v0.1.0: データ蓄積のため再有効化、asyncモードで長時間検出可能)
+         */
+        detect_js_animations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * JSアニメーション検出の詳細オプション
+         * detect_js_animations=true時のみ有効
+         */
+        js_animation_options: z.ZodOptional<z.ZodObject<{
+            /**
+             * CDPアニメーション検出を有効にするか
+             * @default true
+             */
+            enableCDP: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /**
+             * Web Animations API検出を有効にするか
+             * @default true
+             */
+            enableWebAnimations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /**
+             * ライブラリ検出を有効にするか (GSAP, Framer Motion, anime.js, Three.js, Lottie)
+             * @default true
+             */
+            enableLibraryDetection: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /**
+             * アニメーション待機時間（ms）- ページ読み込み後、アニメーション開始を待つ時間
+             * @default 2000
+             */
+            waitTime: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            enableCDP: boolean;
+            enableWebAnimations: boolean;
+            enableLibraryDetection: boolean;
+            waitTime: number;
+        }, {
+            enableCDP?: boolean | undefined;
+            enableWebAnimations?: boolean | undefined;
+            enableLibraryDetection?: boolean | undefined;
+            waitTime?: number | undefined;
+        }>>;
+        /**
+         * WebGL/Canvasベースのアニメーション検出を有効にするか
+         * Three.js等のWebGLアニメーションをフレームベースで検出
+         * Playwrightが必要で処理に30秒以上かかる場合あり
+         * @default true (v0.1.0: データ蓄積のため再有効化、asyncモードで長時間検出可能)
+         */
+        detect_webgl_animations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * WebGLアニメーション検出の詳細オプション
+         * detect_webgl_animations=true時のみ有効
+         */
+        webgl_animation_options: z.ZodOptional<z.ZodObject<{
+            /**
+             * サンプリングするフレーム数
+             * @default 50 (maximum analysis capability)
+             * @min 5
+             * @max 100
+             */
+            sample_frames: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /**
+             * フレーム間隔（ms）
+             * @default 100
+             * @min 50
+             * @max 500
+             */
+            sample_interval_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /**
+             * 変化検出しきい値（0-1）
+             * @default 0.005 (high sensitivity for maximum detection)
+             * @min 0.001
+             * @max 0.5
+             */
+            change_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /**
+             * 検出タイムアウト（ms）
+             * v0.1.0: デフォルトを120秒に増加（重いWebGLサイト対応）
+             * @default 120000
+             * @min 5000
+             * @max 180000
+             */
+            timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            sample_frames: number;
+            sample_interval_ms: number;
+            change_threshold: number;
+            timeout_ms: number;
+        }, {
+            sample_frames?: number | undefined;
+            sample_interval_ms?: number | undefined;
+            change_threshold?: number | undefined;
+            timeout_ms?: number | undefined;
+        }>>;
+        /**
+         * Motion検出のタイムアウト（ミリ秒）
+         *
+         * MCP Protocol (Claude Desktop/API) には60秒のツール呼び出し制限があります。
+         * page.analyzeのasyncモードでは、この制限が適用されないため、
+         * 長時間のmotion検出が可能です。
+         *
+         * 同期モード（async=false）では、このパラメータはツール内部処理用であり、
+         * MCP層の60秒制限を上書きすることはできません。
+         *
+         * @default 300000 (5分)
+         * @min 30000 (30秒)
+         * @max 600000 (10分)
+         */
+        timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        saveToDb: boolean;
+        fetchExternalCss: boolean;
+        detection_mode: "css" | "video" | "runtime" | "hybrid";
+        minDuration: number;
+        maxPatterns: number;
+        includeWarnings: boolean;
+        enable_frame_capture: boolean;
+        analyze_frames: boolean;
+        timeout: number;
+        detect_js_animations: boolean;
+        detect_webgl_animations: boolean;
+        frame_capture_options?: {
+            frame_rate: number;
+            frame_interval_ms: number;
+            scroll_px_per_frame: number;
+            output_format: "png" | "jpeg";
+            output_dir: string;
+            filename_pattern: string;
+            scroll_speed_px_per_sec?: number | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        } | undefined;
+        frame_analysis_options?: {
+            sample_interval: number;
+            diff_threshold: number;
+            cls_threshold: number;
+            motion_threshold: number;
+            output_diff_images: boolean;
+            parallel: boolean;
+            frame_dir?: string | undefined;
+        } | undefined;
+        video_options?: {
+            timeout: number;
+            record_duration: number;
+            scroll_page: boolean;
+            move_mouse: boolean;
+            wait_until: "load" | "domcontentloaded" | "networkidle";
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            frame_analysis?: {
+                change_threshold: number;
+                fps: number;
+                min_motion_duration_ms: number;
+                gap_tolerance_ms: number;
+            } | undefined;
+        } | undefined;
+        runtime_options?: {
+            wait_for_animations: number;
+            scroll_positions?: number[] | undefined;
+        } | undefined;
+        js_animation_options?: {
+            enableCDP: boolean;
+            enableWebAnimations: boolean;
+            enableLibraryDetection: boolean;
+            waitTime: number;
+        } | undefined;
+        webgl_animation_options?: {
+            sample_frames: number;
+            sample_interval_ms: number;
+            change_threshold: number;
+            timeout_ms: number;
+        } | undefined;
+    }, {
+        saveToDb?: boolean | undefined;
+        fetchExternalCss?: boolean | undefined;
+        detection_mode?: "css" | "video" | "runtime" | "hybrid" | undefined;
+        minDuration?: number | undefined;
+        maxPatterns?: number | undefined;
+        includeWarnings?: boolean | undefined;
+        enable_frame_capture?: boolean | undefined;
+        frame_capture_options?: {
+            frame_rate?: number | undefined;
+            frame_interval_ms?: number | undefined;
+            scroll_speed_px_per_sec?: number | undefined;
+            scroll_px_per_frame?: number | undefined;
+            output_format?: "png" | "jpeg" | undefined;
+            output_dir?: string | undefined;
+            filename_pattern?: string | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        } | undefined;
+        analyze_frames?: boolean | undefined;
+        frame_analysis_options?: {
+            frame_dir?: string | undefined;
+            sample_interval?: number | undefined;
+            diff_threshold?: number | undefined;
+            cls_threshold?: number | undefined;
+            motion_threshold?: number | undefined;
+            output_diff_images?: boolean | undefined;
+            parallel?: boolean | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        video_options?: {
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            timeout?: number | undefined;
+            record_duration?: number | undefined;
+            scroll_page?: boolean | undefined;
+            move_mouse?: boolean | undefined;
+            wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+            frame_analysis?: {
+                change_threshold?: number | undefined;
+                fps?: number | undefined;
+                min_motion_duration_ms?: number | undefined;
+                gap_tolerance_ms?: number | undefined;
+            } | undefined;
+        } | undefined;
+        runtime_options?: {
+            wait_for_animations?: number | undefined;
+            scroll_positions?: number[] | undefined;
+        } | undefined;
+        detect_js_animations?: boolean | undefined;
+        js_animation_options?: {
+            enableCDP?: boolean | undefined;
+            enableWebAnimations?: boolean | undefined;
+            enableLibraryDetection?: boolean | undefined;
+            waitTime?: number | undefined;
+        } | undefined;
+        detect_webgl_animations?: boolean | undefined;
+        webgl_animation_options?: {
+            sample_frames?: number | undefined;
+            sample_interval_ms?: number | undefined;
+            change_threshold?: number | undefined;
+            timeout_ms?: number | undefined;
+        } | undefined;
+    }>>>;
+    qualityOptions: z.ZodOptional<z.ZodObject<{
+        weights: z.ZodOptional<z.ZodObject<{
+            originality: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            craftsmanship: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            contextuality: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            originality: number;
+            craftsmanship: number;
+            contextuality: number;
+        }, {
+            originality?: number | undefined;
+            craftsmanship?: number | undefined;
+            contextuality?: number | undefined;
+        }>>;
+        targetIndustry: z.ZodOptional<z.ZodString>;
+        targetAudience: z.ZodOptional<z.ZodString>;
+        strict: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        includeRecommendations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        strict: boolean;
+        includeRecommendations: boolean;
+        weights?: {
+            originality: number;
+            craftsmanship: number;
+            contextuality: number;
+        } | undefined;
+        targetIndustry?: string | undefined;
+        targetAudience?: string | undefined;
+    }, {
+        strict?: boolean | undefined;
+        weights?: {
+            originality?: number | undefined;
+            craftsmanship?: number | undefined;
+            contextuality?: number | undefined;
+        } | undefined;
+        targetIndustry?: string | undefined;
+        targetAudience?: string | undefined;
+        includeRecommendations?: boolean | undefined;
+    }>>;
+    /**
+     * Narrative分析オプション
+     *
+     * Webページの「世界観・雰囲気（WorldView）」と「レイアウト構成（LayoutStructure）」を分析するオプション。
+     * enabled=trueで有効化。Vision LLMを使用してより精度の高い分析が可能。
+     *
+     * @see narrativeOptionsSchema
+     */
+    narrativeOptions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * Narrative分析を有効化するか
+         * @default true
+         */
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * 分析結果をDBに保存するか
+         * @default true
+         */
+        saveToDb: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Vision LLM（Ollama llama3.2-vision）を使用するか
+         * trueの場合、スクリーンショットを使用してより精度の高い分析を行う
+         * @default true
+         */
+        includeVision: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Vision解析タイムアウト（ミリ秒）
+         * @default 300000 (5分)
+         * @min 30000 (30秒)
+         * @max 600000 (10分)
+         */
+        visionTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /**
+         * Embedding生成を含むか
+         * @default true
+         */
+        generateEmbedding: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        saveToDb: boolean;
+        visionTimeoutMs: number;
+        includeVision: boolean;
+        generateEmbedding: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        saveToDb?: boolean | undefined;
+        visionTimeoutMs?: number | undefined;
+        includeVision?: boolean | undefined;
+        generateEmbedding?: boolean | undefined;
+    }>>>;
+    /**
+     * Vision CPU完走保証オプション（Phase 3）
+     *
+     * Visionモデル（Ollama llama3.2-vision）の推論を確実に完了させるためのオプション。
+     * GPU/CPU自動判定、動的タイムアウト、画像最適化、Graceful Degradation をサポート。
+     *
+     * @see visionOptionsSchema
+     */
+    visionOptions: z.ZodOptional<z.ZodObject<{
+        /**
+         * Vision解析のタイムアウト（ミリ秒）
+         * 未指定時はHardwareDetector + TimeoutCalculatorで自動計算
+         *
+         * @min 1000 (1秒)
+         * @max 1200000 (20分)
+         */
+        visionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Vision解析に渡す画像の最大サイズ（バイト）
+         * これを超える画像はImageOptimizerで圧縮される
+         *
+         * @min 1024 (1KB)
+         * @max 10000000 (10MB)
+         */
+        visionImageMaxSize: z.ZodOptional<z.ZodNumber>;
+        /**
+         * GPUが利用可能でもCPUモードを強制するか
+         * テストやCI環境で有用
+         *
+         * @default false
+         */
+        visionForceCpu: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * 長時間処理時に進捗報告を有効にするか
+         * 将来的なストリーミング対応用
+         *
+         * @default false
+         */
+        visionEnableProgress: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /**
+         * Vision解析がタイムアウト/失敗した場合にHTML解析のみで続行するか
+         * Graceful Degradation設定
+         *
+         * @default true (フォールバック有効)
+         */
+        visionFallbackToHtmlOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        visionForceCpu: boolean;
+        visionEnableProgress: boolean;
+        visionFallbackToHtmlOnly: boolean;
+        visionTimeoutMs?: number | undefined;
+        visionImageMaxSize?: number | undefined;
+    }, {
+        visionTimeoutMs?: number | undefined;
+        visionImageMaxSize?: number | undefined;
+        visionForceCpu?: boolean | undefined;
+        visionEnableProgress?: boolean | undefined;
+        visionFallbackToHtmlOnly?: boolean | undefined;
+    }>>;
+    summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * 非同期モード（Phase3-2 + v0.1.0 Smart Defaults）
+     *
+     * true: ジョブをBullMQキューに投入し、ジョブIDを返す
+     * false: 同期処理（従来動作）
+     * undefined: 自動判定（Vision有効時はtrue、それ以外はfalse）
+     *
+     * **v0.1.0 Smart Defaults**:
+     * Vision分析（useVision=true または narrativeOptions.includeVision=true）が有効で、
+     * asyncが明示的に指定されていない場合、Redisが利用可能であれば自動的にasync=trueに設定。
+     * Vision LLM (llama3.2-vision) はCPUモードで2-5分以上かかるため、
+     * MCPの600秒ハードタイムアウトを回避するために自動非同期化される。
+     *
+     * WebGL重いサイト（Linear, Vercel, Notion等）は非同期モードを推奨。
+     * ジョブ結果は24時間保持され、page.getJobStatusで取得可能。
+     *
+     * 注意: async=true にはRedisが必要。Redis未起動時はエラーを返す。
+     *
+     * @default undefined (Vision有効時は自動でtrue)
+     */
+    async: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * タイムアウト（ミリ秒）
+     * WebGL/Three.jsサイトは初期レンダリングに60-90秒かかることがあるため、
+     * デフォルトを600秒（10分）に設定。最大限の分析能力を発揮するための設定。
+     * @default 600000 (10分)
+     * @max 600000 (10分)
+     */
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<["load", "domcontentloaded", "networkidle"]>>>;
+    /**
+     * タイムアウト戦略
+     * - strict: タイムアウト発生時は完全に失敗
+     * - progressive: タイムアウト発生時も部分結果を返却（デフォルト）
+     * @default 'progressive'
+     */
+    timeout_strategy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["strict", "progressive"]>>>;
+    /**
+     * 部分結果を許可するか
+     * true: タイムアウト発生時も完了したフェーズの結果を返却
+     * false: 全フェーズ完了時のみ結果を返却
+     * @default true
+     */
+    partial_results: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * レイアウトフェーズの個別タイムアウト（ミリ秒）
+     *
+     * レイアウト分析（HTML解析、セクション検出、Vision分析）に適用。
+     * 重いサイトでもモーション/品質評価を継続するため、個別設定可能。
+     *
+     * @default 120000 (2分)
+     * @min 5000 (5秒)
+     * @max 300000 (5分)
+     */
+    layoutTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * モーションフェーズの個別タイムアウト（ミリ秒）
+     *
+     * モーション検出（CSS静的解析、JSアニメーション検出、フレームキャプチャ）に適用。
+     * WebGL/Three.jsサイトはフレームキャプチャに時間がかかるため、長めに設定推奨。
+     *
+     * @default 300000 (5分)
+     * @min 5000 (5秒)
+     * @max 300000 (5分)
+     */
+    motionTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * 品質評価フェーズの個別タイムアウト（ミリ秒）
+     *
+     * 品質評価（アクセシビリティ、パフォーマンス、ベストプラクティス）に適用。
+     * 通常は15秒で十分だが、大規模サイトでは延長可能。
+     *
+     * @default 60000 (1分)
+     * @min 5000 (5秒)
+     * @max 60000 (1分)
+     */
+    qualityTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * 自動リトライを有効化するか（v0.1.0）
+     *
+     * true: HTML取得失敗時に段階的にリトライ
+     * - 1回目: 元のタイムアウト、waitUntil='load'
+     * - 2回目: タイムアウト1.5倍、waitUntil='domcontentloaded'
+     * - 3回目: タイムアウト2倍、waitUntil='domcontentloaded'
+     *
+     * 注: WebGLは無効化しません（ユーザー要件）
+     * @default true
+     */
+    auto_retry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * 最大リトライ回数（v0.1.0）
+     * auto_retry=true の場合に使用
+     * @default 3
+     * @min 1
+     * @max 3
+     */
+    max_retries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * レイアウト優先モード（v0.1.0）
+     *
+     * WebGL/Three.jsサイトでレイアウト抽出を最優先し、モーション検出を軽量化。
+     * 'auto': WebGL検出時に自動でレイアウト優先（デフォルト）
+     * 'always': 常にレイアウト優先
+     * 'never': 従来の並列処理
+     *
+     * レイアウト優先モードでは:
+     * - SectionPattern抽出を最優先で実行
+     * - モーション検出はlibrary_onlyモード（グローバルオブジェクト検出のみ）
+     * - タイムアウト予算をレイアウトに再配分
+     *
+     * @default 'auto'
+     */
+    layout_first: z.ZodDefault<z.ZodOptional<z.ZodEnum<["auto", "always", "never"]>>>;
+    /**
+     * Pre-flight Probe による自動タイムアウト調整（v0.1.0）
+     *
+     * URLのページ複雑度を事前に分析し、最適なタイムアウト値を動的に計算します。
+     * WebGL、SPA、重いフレームワーク（Three.js等）を検出し、タイムアウトを自動調整。
+     *
+     * - true: probe実行 → calculatedTimeoutMsを使用
+     * - false: 従来のtimeoutパラメータを使用
+     *
+     * probe結果はレスポンスの`preflightProbe`フィールドに含まれます。
+     * saveToDb=trueの場合、WebPage.complexity_metricsにも保存されます。
+     *
+     * @default true
+     */
+    auto_timeout: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** robots.txtを尊重するかどうか（RFC 9309）。falseで無視 */
+    respect_robots_txt: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * レスポンシブ分析オプション
+     *
+     * 複数ビューポート（desktop/tablet/mobile）でページをキャプチャし、
+     * レイアウト差分・ブレークポイント・ナビゲーション変化を検出する。
+     * enabled=trueで有効化。結果はresponsive_analysesテーブルに保存される。
+     */
+    responsiveOptions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** レスポンシブ分析を有効化（デフォルト: true） */
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** カスタムビューポート設定（デフォルト: desktop/tablet/mobile） */
+        viewports: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            width: number;
+            height: number;
+        }, {
+            name: string;
+            width: number;
+            height: number;
+        }>, "many">>;
+        /** スクリーンショットをレスポンスに含めるか（デフォルト: false、DB-first） */
+        include_screenshots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** ビューポート差分画像を含めるか（デフォルト: false） */
+        include_diff_images: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** ビューポート差分の閾値（0-1、デフォルト: 0.1） */
+        diff_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** DB保存するか（デフォルト: true） */
+        save_to_db: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** ナビゲーションパターン変化を検出するか（デフォルト: true） */
+        detect_navigation: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** 要素の表示/非表示変化を検出するか（デフォルト: true） */
+        detect_visibility: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** レイアウト構造変化を検出するか（デフォルト: true） */
+        detect_layout: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** ブレークポイント解像度（'range': CSSメディアクエリ+VP差分推定, 'precise': 二分探索で±8px精度）。preciseは処理時間3-5倍 */
+        breakpoint_resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<["range", "precise"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        diff_threshold: number;
+        include_screenshots: boolean;
+        include_diff_images: boolean;
+        save_to_db: boolean;
+        detect_navigation: boolean;
+        detect_visibility: boolean;
+        detect_layout: boolean;
+        breakpoint_resolution: "range" | "precise";
+        viewports?: {
+            name: string;
+            width: number;
+            height: number;
+        }[] | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        diff_threshold?: number | undefined;
+        viewports?: {
+            name: string;
+            width: number;
+            height: number;
+        }[] | undefined;
+        include_screenshots?: boolean | undefined;
+        include_diff_images?: boolean | undefined;
+        save_to_db?: boolean | undefined;
+        detect_navigation?: boolean | undefined;
+        detect_visibility?: boolean | undefined;
+        detect_layout?: boolean | undefined;
+        breakpoint_resolution?: "range" | "precise" | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    motionOptions: {
+        saveToDb: boolean;
+        fetchExternalCss: boolean;
+        detection_mode: "css" | "video" | "runtime" | "hybrid";
+        minDuration: number;
+        maxPatterns: number;
+        includeWarnings: boolean;
+        enable_frame_capture: boolean;
+        analyze_frames: boolean;
+        timeout: number;
+        detect_js_animations: boolean;
+        detect_webgl_animations: boolean;
+        frame_capture_options?: {
+            frame_rate: number;
+            frame_interval_ms: number;
+            scroll_px_per_frame: number;
+            output_format: "png" | "jpeg";
+            output_dir: string;
+            filename_pattern: string;
+            scroll_speed_px_per_sec?: number | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        } | undefined;
+        frame_analysis_options?: {
+            sample_interval: number;
+            diff_threshold: number;
+            cls_threshold: number;
+            motion_threshold: number;
+            output_diff_images: boolean;
+            parallel: boolean;
+            frame_dir?: string | undefined;
+        } | undefined;
+        video_options?: {
+            timeout: number;
+            record_duration: number;
+            scroll_page: boolean;
+            move_mouse: boolean;
+            wait_until: "load" | "domcontentloaded" | "networkidle";
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            frame_analysis?: {
+                change_threshold: number;
+                fps: number;
+                min_motion_duration_ms: number;
+                gap_tolerance_ms: number;
+            } | undefined;
+        } | undefined;
+        runtime_options?: {
+            wait_for_animations: number;
+            scroll_positions?: number[] | undefined;
+        } | undefined;
+        js_animation_options?: {
+            enableCDP: boolean;
+            enableWebAnimations: boolean;
+            enableLibraryDetection: boolean;
+            waitTime: number;
+        } | undefined;
+        webgl_animation_options?: {
+            sample_frames: number;
+            sample_interval_ms: number;
+            change_threshold: number;
+            timeout_ms: number;
+        } | undefined;
+    };
+    summary: boolean;
+    timeout: number;
+    url: string;
+    sourceType: "award_gallery" | "user_provided";
+    usageScope: "inspiration_only" | "owned_asset";
+    features: {
+        layout: boolean;
+        motion: boolean;
+        quality: boolean;
+    };
+    narrativeOptions: {
+        enabled: boolean;
+        saveToDb: boolean;
+        visionTimeoutMs: number;
+        includeVision: boolean;
+        generateEmbedding: boolean;
+    };
+    waitUntil: "load" | "domcontentloaded" | "networkidle";
+    timeout_strategy: "strict" | "progressive";
+    partial_results: boolean;
+    layoutTimeout: number;
+    motionTimeout: number;
+    qualityTimeout: number;
+    auto_retry: boolean;
+    max_retries: number;
+    layout_first: "never" | "auto" | "always";
+    auto_timeout: boolean;
+    responsiveOptions: {
+        enabled: boolean;
+        diff_threshold: number;
+        include_screenshots: boolean;
+        include_diff_images: boolean;
+        save_to_db: boolean;
+        detect_navigation: boolean;
+        detect_visibility: boolean;
+        detect_layout: boolean;
+        breakpoint_resolution: "range" | "precise";
+        viewports?: {
+            name: string;
+            width: number;
+            height: number;
+        }[] | undefined;
+    };
+    layoutOptions?: {
+        fullPage: boolean;
+        saveToDb: boolean;
+        autoAnalyze: boolean;
+        fetchExternalCss: boolean;
+        useVision: boolean;
+        perSectionVision: boolean;
+        visionBatchSize: number;
+        scrollVision: boolean;
+        scrollVisionMaxCaptures: number;
+        include_html?: boolean | undefined;
+        includeHtml?: boolean | undefined;
+        include_screenshot?: boolean | undefined;
+        includeScreenshot?: boolean | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
+    qualityOptions?: {
+        strict: boolean;
+        includeRecommendations: boolean;
+        weights?: {
+            originality: number;
+            craftsmanship: number;
+            contextuality: number;
+        } | undefined;
+        targetIndustry?: string | undefined;
+        targetAudience?: string | undefined;
+    } | undefined;
+    visionOptions?: {
+        visionForceCpu: boolean;
+        visionEnableProgress: boolean;
+        visionFallbackToHtmlOnly: boolean;
+        visionTimeoutMs?: number | undefined;
+        visionImageMaxSize?: number | undefined;
+    } | undefined;
+    async?: boolean | undefined;
+    respect_robots_txt?: boolean | undefined;
+}, {
+    url: string;
+    layoutOptions?: {
+        include_html?: boolean | undefined;
+        includeHtml?: boolean | undefined;
+        include_screenshot?: boolean | undefined;
+        includeScreenshot?: boolean | undefined;
+        fullPage?: boolean | undefined;
+        viewport?: {
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        saveToDb?: boolean | undefined;
+        autoAnalyze?: boolean | undefined;
+        fetchExternalCss?: boolean | undefined;
+        useVision?: boolean | undefined;
+        perSectionVision?: boolean | undefined;
+        visionBatchSize?: number | undefined;
+        scrollVision?: boolean | undefined;
+        scrollVisionMaxCaptures?: number | undefined;
+    } | undefined;
+    motionOptions?: {
+        saveToDb?: boolean | undefined;
+        fetchExternalCss?: boolean | undefined;
+        detection_mode?: "css" | "video" | "runtime" | "hybrid" | undefined;
+        minDuration?: number | undefined;
+        maxPatterns?: number | undefined;
+        includeWarnings?: boolean | undefined;
+        enable_frame_capture?: boolean | undefined;
+        frame_capture_options?: {
+            frame_rate?: number | undefined;
+            frame_interval_ms?: number | undefined;
+            scroll_speed_px_per_sec?: number | undefined;
+            scroll_px_per_frame?: number | undefined;
+            output_format?: "png" | "jpeg" | undefined;
+            output_dir?: string | undefined;
+            filename_pattern?: string | undefined;
+            page_height_px?: number | undefined;
+            scroll_duration_sec?: number | undefined;
+        } | undefined;
+        analyze_frames?: boolean | undefined;
+        frame_analysis_options?: {
+            frame_dir?: string | undefined;
+            sample_interval?: number | undefined;
+            diff_threshold?: number | undefined;
+            cls_threshold?: number | undefined;
+            motion_threshold?: number | undefined;
+            output_diff_images?: boolean | undefined;
+            parallel?: boolean | undefined;
+        } | undefined;
+        timeout?: number | undefined;
+        video_options?: {
+            viewport?: {
+                width: number;
+                height: number;
+            } | undefined;
+            timeout?: number | undefined;
+            record_duration?: number | undefined;
+            scroll_page?: boolean | undefined;
+            move_mouse?: boolean | undefined;
+            wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+            frame_analysis?: {
+                change_threshold?: number | undefined;
+                fps?: number | undefined;
+                min_motion_duration_ms?: number | undefined;
+                gap_tolerance_ms?: number | undefined;
+            } | undefined;
+        } | undefined;
+        runtime_options?: {
+            wait_for_animations?: number | undefined;
+            scroll_positions?: number[] | undefined;
+        } | undefined;
+        detect_js_animations?: boolean | undefined;
+        js_animation_options?: {
+            enableCDP?: boolean | undefined;
+            enableWebAnimations?: boolean | undefined;
+            enableLibraryDetection?: boolean | undefined;
+            waitTime?: number | undefined;
+        } | undefined;
+        detect_webgl_animations?: boolean | undefined;
+        webgl_animation_options?: {
+            sample_frames?: number | undefined;
+            sample_interval_ms?: number | undefined;
+            change_threshold?: number | undefined;
+            timeout_ms?: number | undefined;
+        } | undefined;
+    } | undefined;
+    qualityOptions?: {
+        strict?: boolean | undefined;
+        weights?: {
+            originality?: number | undefined;
+            craftsmanship?: number | undefined;
+            contextuality?: number | undefined;
+        } | undefined;
+        targetIndustry?: string | undefined;
+        targetAudience?: string | undefined;
+        includeRecommendations?: boolean | undefined;
+    } | undefined;
+    summary?: boolean | undefined;
+    timeout?: number | undefined;
+    sourceType?: "award_gallery" | "user_provided" | undefined;
+    usageScope?: "inspiration_only" | "owned_asset" | undefined;
+    features?: {
+        layout?: boolean | undefined;
+        motion?: boolean | undefined;
+        quality?: boolean | undefined;
+    } | undefined;
+    narrativeOptions?: {
+        enabled?: boolean | undefined;
+        saveToDb?: boolean | undefined;
+        visionTimeoutMs?: number | undefined;
+        includeVision?: boolean | undefined;
+        generateEmbedding?: boolean | undefined;
+    } | undefined;
+    visionOptions?: {
+        visionTimeoutMs?: number | undefined;
+        visionImageMaxSize?: number | undefined;
+        visionForceCpu?: boolean | undefined;
+        visionEnableProgress?: boolean | undefined;
+        visionFallbackToHtmlOnly?: boolean | undefined;
+    } | undefined;
+    async?: boolean | undefined;
+    waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout_strategy?: "strict" | "progressive" | undefined;
+    partial_results?: boolean | undefined;
+    layoutTimeout?: number | undefined;
+    motionTimeout?: number | undefined;
+    qualityTimeout?: number | undefined;
+    auto_retry?: boolean | undefined;
+    max_retries?: number | undefined;
+    layout_first?: "never" | "auto" | "always" | undefined;
+    auto_timeout?: boolean | undefined;
+    respect_robots_txt?: boolean | undefined;
+    responsiveOptions?: {
+        enabled?: boolean | undefined;
+        diff_threshold?: number | undefined;
+        viewports?: {
+            name: string;
+            width: number;
+            height: number;
+        }[] | undefined;
+        include_screenshots?: boolean | undefined;
+        include_diff_images?: boolean | undefined;
+        save_to_db?: boolean | undefined;
+        detect_navigation?: boolean | undefined;
+        detect_visibility?: boolean | undefined;
+        detect_layout?: boolean | undefined;
+        breakpoint_resolution?: "range" | "precise" | undefined;
+    } | undefined;
+}>;
+export type PageAnalyzeInput = z.infer<typeof pageAnalyzeInputSchema>;
+//# sourceMappingURL=input.schemas.d.ts.map