@reftrixmcp/mcp-server 0.1.7

package/dist/tools/motion/detect.schemas.js

@@ -0,0 +1,1715 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.motionMcpTools = exports.MOTION_WARNING_CODES = exports.MOTION_MCP_ERROR_CODES = exports.motionDetectOutputSchema = exports.motionDetectErrorOutputSchema = exports.motionDetectSuccessOutputSchema = exports.motionDetectErrorSchema = exports.motionDetectDataSchema = exports.sizeOptimizationSchema = exports.videoInfoSchema = exports.runtimeInfoSchema = exports.debugInfoSchema = exports.motionSaveResultSchema = exports.motionDetectInputSchema = exports.externalCssOptionsSchema = exports.animationMetricsResultSchema = exports.performanceRecommendationSchema = exports.clsContributorSchema = exports.animationImpactScoreSchema = exports.analyzeMetricsOptionsSchema = exports.lighthouseMetricsSchema = exports.lighthouseOptionsSchema = exports.lighthouseCategorySchema = exports.frameImageAnalysisInputOptionsSchema = exports.frameCaptureResultSchema = exports.frameFileInfoSchema = exports.frameCaptureOptionsSchema = exports.MAX_TOTAL_FRAMES = exports.videoOptionsSchema = exports.frameAnalysisOptionsSchema = exports.runtimeOptionsSchema = exports.jsAnimationResultSchema = exports.libraryDetectionResultSchema = exports.webAnimationSchema = exports.webAnimationKeyframeSchema = exports.webAnimationTimingSchema = exports.cdpAnimationSchema = exports.cdpAnimationSourceSchema = exports.jsAnimationOptionsSchema = exports.detectionModeSchema = void 0;
+exports.calculatePerformanceLevel = calculatePerformanceLevel;
+exports.calculateComplexityScore = calculateComplexityScore;
+exports.calculateAverageDuration = calculateAverageDuration;
+exports.countByType = countByType;
+exports.countByTrigger = countByTrigger;
+exports.countByCategory = countByCategory;
+exports.calculateFrameCaptureConfig = calculateFrameCaptureConfig;
+exports.generateFrameFileInfos = generateFrameFileInfos;
+/**
+ * motion.detect MCP Tool — Zod Schema Definitions
+ * motion.detect 固有のスキーマ定義（入力/出力/エラーコード/ユーティリティ）
+ *
+ * @module @reftrixmcp/mcp-server/tools/motion/detect.schemas
+ */
+const zod_1 = require("zod");
+const shared_schemas_1 = require("./shared.schemas");
+// ============================================================================
+// Detection Mode Schema (v0.1.0)
+// ============================================================================
+/**
+ * 検出モード
+ *
+ * モード選択ガイド:
+ * - 'css': CSS静的解析のみ。html または pageId が必須。
+ *   用途: layout.ingest → motion.detect パイプライン、静的HTMLの解析
+ *   長所: 高速、リソース軽量、Playwright不要
+ *   短所: JS駆動アニメーション（GSAP, Framer Motion等）検出不可
+ *
+ * - 'runtime': JavaScript駆動アニメーション検出。url が必須。
+ *   用途: SPA/React/Vue/Next.js等のJS駆動サイト
+ *   長所: CSS-in-JS、JSアニメーションライブラリを検出可能
+ *   短所: Playwright起動オーバーヘッド（数秒）
+ *
+ * - 'hybrid': CSS + runtime 両方を組み合わせた検出。url が必須。
+ *   用途: 最も包括的な検出が必要な場合
+ *   長所: 静的CSS + JS駆動の両方を検出
+ *   短所: 2倍のリソース消費、処理時間増加
+ *
+ * - 'video': 動画キャプチャ + フレーム解析。url が必須。
+ *   用途: 視覚的なモーション検出、Lighthouse連携
+ *   長所: 実際のレンダリング結果を解析
+ *   短所: 最大リソース消費、長時間処理
+ *
+ * - 'library_only' (v0.1.0): ライブラリ検出のみ。url が必須。
+ *   用途: WebGL/Three.jsサイトでの高速検出、layout_first モード
+ *   長所: 超高速（5-15秒）、グローバルオブジェクト検出のみ
+ *   短所: アニメーション詳細（duration, easing等）は取得不可
+ *   検出対象: window.THREE, window.gsap, window.anime, data-framer-* 等
+ *
+ * 推奨:
+ * - 静的サイト/事前取得HTML: 'css'
+ * - SPA/JSフレームワーク: 'runtime' または 'hybrid'
+ * - パフォーマンス分析: 'video' + lighthouse_options
+ * - WebGL/Three.jsサイト: 'library_only' (layout_first='auto'時に自動選択)
+ */
+exports.detectionModeSchema = zod_1.z.enum(["css", "runtime", "hybrid", "video", "library_only"]);
+// ============================================================================
+// JS Animation Detection Options Schema (v0.1.0)
+// ============================================================================
+/**
+ * JSアニメーション検出オプションスキーマ
+ *
+ * Chrome DevTools Protocol (CDP) と Web Animations API を使用した
+ * JavaScript駆動アニメーションの包括的検出オプション
+ *
+ * @property enable_cdp - CDP Animation ドメインを使用してアニメーション検出 (default: true)
+ * @property enable_web_animations - Web Animations API (document.getAnimations()) を使用 (default: true)
+ * @property enable_library_detection - ライブラリ検出を有効にするか (default: true)
+ * @property wait_time - アニメーション待機時間（ms）(default: 1000)
+ */
+exports.jsAnimationOptionsSchema = zod_1.z.object({
+    enable_cdp: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Enable CDP Animation domain for animation detection"),
+    enable_web_animations: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Enable Web Animations API (document.getAnimations()) detection"),
+    enable_library_detection: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Enable library detection (GSAP, Framer Motion, Anime.js, Three.js, Lottie)"),
+    wait_time: zod_1.z
+        .number()
+        .int()
+        .min(0, { message: "wait_timeは0以上である必要があります" })
+        .max(30000, { message: "wait_timeは30000ms以下にしてください" })
+        .default(1000)
+        .describe("Wait time for animations to start (ms)"),
+});
+// ============================================================================
+// JS Animation Detection Result Schemas (v0.1.0)
+// ============================================================================
+/**
+ * CDPアニメーションソース情報スキーマ
+ */
+exports.cdpAnimationSourceSchema = zod_1.z.object({
+    duration: zod_1.z.number().min(0),
+    delay: zod_1.z.number().min(0),
+    iterations: zod_1.z.number().min(0),
+    direction: zod_1.z.string(),
+    easing: zod_1.z.string(),
+    keyframesRule: zod_1.z
+        .object({
+        name: zod_1.z.string().optional(),
+        keyframes: zod_1.z
+            .array(zod_1.z.object({
+            offset: zod_1.z.string(),
+            easing: zod_1.z.string(),
+            style: zod_1.z.string().optional(),
+        }))
+            .optional(),
+    })
+        .optional(),
+});
+/**
+ * CDP経由で検出されたアニメーションスキーマ
+ */
+exports.cdpAnimationSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    pausedState: zod_1.z.boolean(),
+    playState: zod_1.z.string(),
+    playbackRate: zod_1.z.number(),
+    startTime: zod_1.z.number(),
+    currentTime: zod_1.z.number(),
+    type: zod_1.z.enum(["CSSAnimation", "CSSTransition", "WebAnimation"]),
+    source: exports.cdpAnimationSourceSchema,
+});
+/**
+ * Web Animations APIタイミング情報スキーマ
+ */
+exports.webAnimationTimingSchema = zod_1.z.object({
+    duration: zod_1.z.number().min(0),
+    delay: zod_1.z.number().min(0),
+    iterations: zod_1.z.number(),
+    direction: zod_1.z.string(),
+    easing: zod_1.z.string(),
+    fill: zod_1.z.string(),
+});
+/**
+ * Web Animations API キーフレームスキーマ
+ */
+exports.webAnimationKeyframeSchema = zod_1.z
+    .object({
+    offset: zod_1.z.number().nullable(),
+    easing: zod_1.z.string(),
+    composite: zod_1.z.string(),
+})
+    .passthrough();
+/**
+ * Web Animations API で検出されたアニメーションスキーマ
+ */
+exports.webAnimationSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    playState: zod_1.z.string(),
+    target: zod_1.z.string(),
+    timing: exports.webAnimationTimingSchema,
+    keyframes: zod_1.z.array(exports.webAnimationKeyframeSchema),
+});
+/**
+ * ライブラリ検出結果スキーマ
+ */
+exports.libraryDetectionResultSchema = zod_1.z.object({
+    gsap: zod_1.z.object({
+        detected: zod_1.z.boolean(),
+        version: zod_1.z.string().optional(),
+        tweens: zod_1.z.number().int().nonnegative().optional(),
+    }),
+    framerMotion: zod_1.z.object({
+        detected: zod_1.z.boolean(),
+        elements: zod_1.z.number().int().nonnegative().optional(),
+    }),
+    anime: zod_1.z.object({
+        detected: zod_1.z.boolean(),
+        instances: zod_1.z.number().int().nonnegative().optional(),
+    }),
+    three: zod_1.z.object({
+        detected: zod_1.z.boolean(),
+        scenes: zod_1.z.number().int().nonnegative().optional(),
+    }),
+    lottie: zod_1.z.object({
+        detected: zod_1.z.boolean(),
+        animations: zod_1.z.number().int().nonnegative().optional(),
+    }),
+});
+/**
+ * JSアニメーション検出結果スキーマ
+ */
+exports.jsAnimationResultSchema = zod_1.z.object({
+    /** CDP経由で検出されたアニメーション */
+    cdpAnimations: zod_1.z.array(exports.cdpAnimationSchema),
+    /** Web Animations API で検出されたアニメーション */
+    webAnimations: zod_1.z.array(exports.webAnimationSchema),
+    /** ライブラリ検出結果 */
+    libraries: exports.libraryDetectionResultSchema,
+    /** 検出にかかった時間（ms） */
+    detectionTimeMs: zod_1.z.number().int().nonnegative(),
+    /** 総検出数 */
+    totalDetected: zod_1.z.number().int().nonnegative(),
+});
+/**
+ * ランタイムオプションスキーマ (v0.1.0)
+ *
+ * @property wait_for_animations - アニメーション待機時間（ms）0-60000
+ * @property scroll_positions - スクロール位置の配列（%）0-100
+ */
+exports.runtimeOptionsSchema = zod_1.z.object({
+    wait_for_animations: zod_1.z
+        .number()
+        .min(0, { message: "wait_for_animationsは0以上である必要があります" })
+        .max(30000, { message: "wait_for_animationsは30000ms以下にしてください" })
+        .default(3000)
+        .optional(),
+    scroll_positions: zod_1.z
+        .array(zod_1.z
+        .number()
+        .min(0, { message: "scroll_positionは0以上である必要があります" })
+        .max(100, { message: "scroll_positionは100以下である必要があります" }))
+        .max(20, { message: "scroll_positionsは最大20個までです" })
+        .optional(),
+});
+// ============================================================================
+// Video Options Schema (Phase1)
+// ============================================================================
+/**
+ * フレーム解析オプションスキーマ
+ *
+ * @property fps - フレームレート (1-30, デフォルト: 10)
+ * @property change_threshold - 変化検出閾値 (0-1, デフォルト: 0.01)
+ * @property min_motion_duration_ms - 最小モーション継続時間 (デフォルト: 100ms)
+ */
+exports.frameAnalysisOptionsSchema = zod_1.z.object({
+    fps: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "fpsは1以上である必要があります" })
+        .max(30, { message: "fpsは30以下にしてください" })
+        .default(10)
+        .optional(),
+    change_threshold: zod_1.z
+        .number()
+        .min(0, { message: "change_thresholdは0以上である必要があります" })
+        .max(1, { message: "change_thresholdは1以下である必要があります" })
+        .default(0.01)
+        .optional(),
+    min_motion_duration_ms: zod_1.z
+        .number()
+        .int()
+        .min(0, { message: "min_motion_duration_msは0以上である必要があります" })
+        .max(10000, { message: "min_motion_duration_msは10000以下にしてください" })
+        .default(100)
+        .optional(),
+    gap_tolerance_ms: zod_1.z
+        .number()
+        .int()
+        .min(0, { message: "gap_tolerance_msは0以上である必要があります" })
+        .max(1000, { message: "gap_tolerance_msは1000以下にしてください" })
+        .default(50)
+        .optional(),
+});
+/**
+ * 動画キャプチャオプションスキーマ (Phase1)
+ *
+ * @property timeout - ページ読み込みタイムアウト (1000-120000ms, デフォルト: 30000)
+ * @property record_duration - 録画時間 (1000-60000ms, デフォルト: 5000)
+ * @property viewport - ビューポートサイズ (デフォルト: 1280x720)
+ * @property scroll_page - スクロール操作を行うか (デフォルト: true)
+ * @property move_mouse - マウス移動操作を行うか (デフォルト: true)
+ * @property frame_analysis - フレーム解析オプション
+ */
+exports.videoOptionsSchema = zod_1.z.object({
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(1000, { message: "timeoutは1000ms以上である必要があります" })
+        .max(120000, { message: "timeoutは120000ms以下にしてください" })
+        .default(30000)
+        .optional(),
+    record_duration: zod_1.z
+        .number()
+        .int()
+        .min(1000, { message: "record_durationは1000ms以上である必要があります" })
+        .max(60000, { message: "record_durationは60000ms以下にしてください" })
+        .default(5000)
+        .optional(),
+    viewport: zod_1.z
+        .object({
+        width: zod_1.z
+            .number()
+            .int()
+            .min(320, { message: "viewport.widthは320以上である必要があります" })
+            .max(4096, { message: "viewport.widthは4096以下にしてください" }),
+        height: zod_1.z
+            .number()
+            .int()
+            .min(240, { message: "viewport.heightは240以上である必要があります" })
+            .max(4096, { message: "viewport.heightは4096以下にしてください" }),
+    })
+        .optional(),
+    scroll_page: zod_1.z.boolean().default(true).optional(),
+    move_mouse: zod_1.z.boolean().default(true).optional(),
+    wait_until: zod_1.z.enum(["load", "domcontentloaded", "networkidle"]).default("load").optional(),
+    frame_analysis: exports.frameAnalysisOptionsSchema.optional(),
+});
+// ============================================================================
+// Frame Capture Options Schema (video mode)
+// ============================================================================
+/**
+ * 合計フレーム数の最大制限
+ * DoS攻撃やリソース枯渇を防ぐため、120fps × 300sec = 36,000 ではなく
+ * より安全な 3,600 フレーム（30fps × 2分相当）を上限とする
+ */
+exports.MAX_TOTAL_FRAMES = 3600;
+/**
+ * フレームキャプチャオプションスキーマ (video mode)
+ *
+ * ページをスクロールしながらフレームを連続撮影し、動画制作用の素材を生成する機能
+ *
+ * @property frame_rate - フレームレート (1-120fps, デフォルト: 30)
+ * @property frame_interval_ms - フレーム間隔 (ms, 自動計算: 1000/frame_rate)
+ * @property scroll_speed_px_per_sec - スクロール速度 (px/sec, 自動計算: page_height_px/scroll_duration_sec)
+ * @property scroll_px_per_frame - フレームあたりスクロール量 (px, 自動計算: scroll_speed_px_per_sec/frame_rate)
+ * @property output_format - 出力形式 (png|jpeg, デフォルト: png)
+ * @property output_dir - 出力ディレクトリ (デフォルト: /tmp/reftrix-frames/)
+ * @property filename_pattern - ファイル名パターン (デフォルト: frame-{0000}.png)
+ * @property page_height_px - ページ高さ (px, デフォルト: 1080)
+ * @property scroll_duration_sec - スクロール時間 (秒, デフォルト: 5)
+ *
+ * セキュリティ対策:
+ * - output_dir: パストラバーサル文字(..)を禁止
+ * - filename_pattern: パス区切り文字(/、..)を禁止
+ * - 合計フレーム数: MAX_TOTAL_FRAMES (3600) 以下に制限
+ */
+exports.frameCaptureOptionsSchema = zod_1.z
+    .object({
+    frame_rate: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "frame_rateは1以上である必要があります" })
+        .max(120, { message: "frame_rateは120以下にしてください" })
+        .optional(),
+    frame_interval_ms: zod_1.z
+        .number()
+        .min(1, { message: "frame_interval_msは1以上である必要があります" })
+        .optional(),
+    scroll_speed_px_per_sec: zod_1.z
+        .number()
+        .min(1, { message: "scroll_speed_px_per_secは1以上である必要があります" })
+        .optional(),
+    scroll_px_per_frame: zod_1.z
+        .number()
+        .min(0.01, { message: "scroll_px_per_frameは0.01以上である必要があります" })
+        .optional(),
+    output_format: zod_1.z.enum(["png", "jpeg"]).optional(),
+    output_dir: zod_1.z
+        .string()
+        .min(1, { message: "output_dirは1文字以上必要です" })
+        .refine((dir) => !dir.includes(".."), {
+        message: "output_dirにパストラバーサル文字(..)は使用できません",
+    })
+        .optional(),
+    filename_pattern: zod_1.z
+        .string()
+        .min(1, { message: "filename_patternは1文字以上必要です" })
+        .refine((pattern) => !pattern.includes("..") && !pattern.includes("/"), {
+        message: "filename_patternにパス区切り文字(/または..)は使用できません",
+    })
+        .optional(),
+    page_height_px: zod_1.z
+        .number()
+        .int()
+        .min(100, { message: "page_height_pxは100以上である必要があります" })
+        .max(100000, { message: "page_height_pxは100000以下にしてください" })
+        .optional(),
+    scroll_duration_sec: zod_1.z
+        .number()
+        .min(0.1, { message: "scroll_duration_secは0.1以上である必要があります" })
+        .max(300, { message: "scroll_duration_secは300以下にしてください" })
+        .optional(),
+})
+    .refine((data) => {
+    // 合計フレーム数制限チェック
+    const frameRate = data.frame_rate ?? 30;
+    const scrollDuration = data.scroll_duration_sec ?? 5;
+    const totalFrames = Math.ceil(frameRate * scrollDuration);
+    return totalFrames <= exports.MAX_TOTAL_FRAMES;
+}, {
+    message: `合計フレーム数は${exports.MAX_TOTAL_FRAMES}以下である必要があります（frame_rate × scroll_duration_sec）`,
+});
+/**
+ * フレームファイル情報スキーマ
+ */
+exports.frameFileInfoSchema = zod_1.z.object({
+    frame_number: zod_1.z.number().int().nonnegative(),
+    scroll_position_px: zod_1.z.number().nonnegative(),
+    timestamp_ms: zod_1.z.number().nonnegative(),
+    file_path: zod_1.z.string(),
+});
+/**
+ * フレームキャプチャ結果スキーマ
+ *
+ * FrameCaptureServiceResult と整合性を保つ。
+ * Phase5: v0.1.0 で実装構造に合わせて更新。
+ */
+exports.frameCaptureResultSchema = zod_1.z.object({
+    total_frames: zod_1.z.number().int().nonnegative(),
+    output_dir: zod_1.z.string(),
+    config: zod_1.z.object({
+        scroll_px_per_frame: zod_1.z.number().positive(),
+        frame_interval_ms: zod_1.z.number().positive(),
+        output_format: zod_1.z.enum(["png", "jpeg"]),
+        output_dir: zod_1.z.string(),
+        filename_pattern: zod_1.z.string(),
+    }),
+    files: zod_1.z.array(exports.frameFileInfoSchema),
+    duration_ms: zod_1.z.number().int().nonnegative(),
+});
+// ============================================================================
+// Frame Image Analysis Input Options Schema (Phase5)
+// ============================================================================
+/**
+ * フレーム画像分析入力オプションスキーマ (Phase5: v0.1.0)
+ *
+ * Pixelmatch + Sharpを使用したフレーム差分分析のオプション。
+ * analyze_frames=trueの場合にのみ有効。
+ *
+ * @property frame_dir - フレーム画像ディレクトリ（省略時はframeCaptureResult.output_dir または frame_capture_options.output_dir、最終フォールバック: /tmp/reftrix-frames/）
+ * @property sample_interval - サンプリング間隔（N番目のフレームごと、デフォルト: 10）
+ * @property diff_threshold - ピクセル差分しきい値（0-1、デフォルト: 0.1）
+ * @property cls_threshold - CLS（レイアウトシフト）しきい値（デフォルト: 0.05）
+ * @property motion_threshold - モーション検出しきい値（ピクセル、デフォルト: 50）
+ * @property output_diff_images - 差分可視化画像を出力するか（デフォルト: false）
+ * @property parallel - 並列処理を有効にするか（デフォルト: true）
+ */
+exports.frameImageAnalysisInputOptionsSchema = zod_1.z.object({
+    /**
+     * フレーム画像が保存されているディレクトリ
+     * 指定しない場合はframe_capture_options.output_dirを使用します。
+     * それも未指定の場合は'/tmp/reftrix-frames/'を使用します。
+     */
+    frame_dir: zod_1.z
+        .string()
+        .min(1, { message: "frame_dirは1文字以上必要です" })
+        .refine((dir) => !dir.includes(".."), {
+        message: "frame_dirにパストラバーサル文字(..)は使用できません",
+    })
+        .optional()
+        .describe('Directory containing frame images. Falls back to frameCaptureResult.output_dir, frame_capture_options.output_dir, or "/tmp/reftrix-frames/".'),
+    /**
+     * サンプリング間隔（N番目のフレームごとに分析）
+     * 大きな値にすると分析が高速化しますが、精度が低下します。
+     * @default 10
+     * @minimum 1
+     * @maximum 100
+     */
+    sample_interval: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(10)
+        .describe("Analyze every Nth frame. Higher values = faster but less precise. (1-100, default: 10)"),
+    /**
+     * ピクセル差分しきい値（0-1）
+     * この値を超える差分があるフレームペアを「有意な変化」として検出します。
+     * @default 0.1
+     * @minimum 0
+     * @maximum 1
+     */
+    diff_threshold: zod_1.z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.1)
+        .describe("Pixel diff threshold (0-1). Frame pairs exceeding this are marked as significant changes. (default: 0.1)"),
+    /**
+     * レイアウトシフト(CLS)しきい値
+     * Core Web Vitals基準では0.05が良好とされます。
+     * @default 0.05
+     * @minimum 0
+     * @maximum 1
+     */
+    cls_threshold: zod_1.z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.05)
+        .describe('Layout shift (CLS) threshold. Core Web Vitals considers 0.05 as "good". (default: 0.05)'),
+    /**
+     * モーション検出しきい値（ピクセル）
+     * この値を超える移動量があるフレームペアでモーションベクトルを検出します。
+     * @default 50
+     * @minimum 1
+     * @maximum 500
+     */
+    motion_threshold: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .describe("Motion detection threshold in pixels. Movements exceeding this are tracked as motion vectors. (default: 50)"),
+    /**
+     * 差分画像を出力するか
+     * trueにすると、フレーム間の差分を可視化した画像を生成します。
+     * @default false
+     */
+    output_diff_images: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Generate diff visualization images for each frame pair. (default: false)"),
+    /**
+     * 並列処理を有効にするか
+     * @default true
+     */
+    parallel: zod_1.z.boolean().default(true).describe("Enable parallel frame processing. (default: true)"),
+});
+// ============================================================================
+// Lighthouse Options Schema (Phase3)
+// ============================================================================
+/**
+ * Lighthouseカテゴリ
+ */
+exports.lighthouseCategorySchema = zod_1.z.enum([
+    "performance",
+    "accessibility",
+    "best-practices",
+    "seo",
+]);
+/**
+ * Lighthouseオプションスキーマ (Phase3)
+ *
+ * motion.detect 実行後にLighthouseを実行してパフォーマンスメトリクスを収集するオプション
+ *
+ * @property enabled - Lighthouse実行を有効にするか (default: false)
+ * @property categories - 収集するカテゴリ配列 (default: ['performance'])
+ * @property throttling - ネットワーク/CPU スロットリングを適用するか (default: false)
+ * @property timeout - Lighthouse実行タイムアウト (30000-120000ms, default: 60000)
+ * @property save_to_db - 結果をDBに保存するか (default: false)
+ */
+exports.lighthouseOptionsSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(false),
+    categories: zod_1.z.array(exports.lighthouseCategorySchema).default(["performance"]).optional(),
+    throttling: zod_1.z.boolean().default(false).optional(),
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(30000, { message: "timeoutは30000ms以上である必要があります" })
+        .max(120000, { message: "timeoutは120000ms以下にしてください" })
+        .default(60000)
+        .optional(),
+    save_to_db: zod_1.z.boolean().default(false).optional(),
+});
+/**
+ * Lighthouseメトリクススキーマ (Phase3)
+ *
+ * Lighthouse実行結果のパフォーマンスメトリクス
+ *
+ * @property fcp - First Contentful Paint (ms)
+ * @property lcp - Largest Contentful Paint (ms)
+ * @property cls - Cumulative Layout Shift (0-1)
+ * @property tbt - Total Blocking Time (ms)
+ * @property si - Speed Index (ms)
+ * @property tti - Time to Interactive (ms)
+ * @property performance_score - パフォーマンススコア (0-100)
+ * @property fetched_at - 取得日時 (ISO 8601)
+ */
+exports.lighthouseMetricsSchema = zod_1.z.object({
+    fcp: zod_1.z.number().min(0, { message: "fcpは0以上である必要があります" }),
+    lcp: zod_1.z.number().min(0, { message: "lcpは0以上である必要があります" }),
+    cls: zod_1.z
+        .number()
+        .min(0, { message: "clsは0以上である必要があります" })
+        .max(1, { message: "clsは1以下である必要があります" }),
+    tbt: zod_1.z.number().min(0, { message: "tbtは0以上である必要があります" }),
+    si: zod_1.z.number().min(0, { message: "siは0以上である必要があります" }),
+    tti: zod_1.z.number().min(0, { message: "ttiは0以上である必要があります" }),
+    performance_score: zod_1.z
+        .number()
+        .min(0, { message: "performance_scoreは0以上である必要があります" })
+        .max(100, { message: "performance_scoreは100以下である必要があります" }),
+    fetched_at: zod_1.z.string(),
+});
+// ============================================================================
+// Analyze Metrics Options Schema (Phase4)
+// ============================================================================
+/**
+ * AnimationMetricsCollector オプションスキーマ (Phase4)
+ *
+ * motion.detect 実行後にアニメーションパフォーマンス分析を行うオプション
+ *
+ * @property include_recommendations - 改善提案を含めるか (default: true)
+ * @property include_cls_contributors - CLS貢献者リストを含めるか (default: true)
+ * @property timeout - 分析タイムアウト (1000-60000ms, default: 30000)
+ */
+exports.analyzeMetricsOptionsSchema = zod_1.z.object({
+    include_recommendations: zod_1.z.boolean().default(true).optional(),
+    include_cls_contributors: zod_1.z.boolean().default(true).optional(),
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(1000, { message: "timeoutは1000ms以上である必要があります" })
+        .max(60000, { message: "timeoutは60000ms以下にしてください" })
+        .default(30000)
+        .optional(),
+});
+// ============================================================================
+// AnimationMetricsResult Output Schema (Phase4)
+// ============================================================================
+/**
+ * 個別アニメーションのパフォーマンス影響スコアスキーマ
+ */
+exports.animationImpactScoreSchema = zod_1.z.object({
+    /** パターンID */
+    patternId: zod_1.z.string(),
+    /** パターン名 */
+    patternName: zod_1.z.string(),
+    /** 総合影響スコア (0-100, 高いほど悪い) */
+    impactScore: zod_1.z.number().min(0).max(100),
+    /** レイアウト影響スコア (0-100) */
+    layoutImpact: zod_1.z.number().min(0).max(100),
+    /** レンダリング影響スコア (0-100) */
+    renderImpact: zod_1.z.number().min(0).max(100),
+    /** CPU影響スコア (0-100) */
+    cpuImpact: zod_1.z.number().min(0).max(100),
+    /** 影響カテゴリ */
+    severity: zod_1.z.enum(["low", "medium", "high", "critical"]),
+    /** 詳細情報 */
+    details: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * CLS貢献者スキーマ
+ */
+exports.clsContributorSchema = zod_1.z.object({
+    /** 要素セレクタ */
+    selector: zod_1.z.string(),
+    /** CLS貢献度 (0-1) */
+    contribution: zod_1.z.number().min(0).max(1),
+    /** 関連パターンID */
+    relatedPatternId: zod_1.z.string().optional(),
+    /** シフト量（ピクセル） */
+    shiftAmount: zod_1.z.number().optional(),
+});
+/**
+ * パフォーマンス改善推奨スキーマ
+ */
+exports.performanceRecommendationSchema = zod_1.z.object({
+    /** 推奨ID */
+    id: zod_1.z.string(),
+    /** 重要度 */
+    priority: zod_1.z.enum(["low", "medium", "high", "critical"]),
+    /** カテゴリ */
+    category: zod_1.z.enum(["layout", "rendering", "animation", "accessibility"]),
+    /** タイトル */
+    title: zod_1.z.string(),
+    /** 説明 */
+    description: zod_1.z.string(),
+    /** 影響を受けるパターンID */
+    affectedPatterns: zod_1.z.array(zod_1.z.string()),
+    /** 推定改善効果 (0-1) */
+    estimatedImpact: zod_1.z.number().min(0).max(1),
+    /** 実装難易度 */
+    effort: zod_1.z.enum(["low", "medium", "high"]),
+});
+/**
+ * AnimationMetricsResult スキーマ (Phase4)
+ *
+ * AnimationMetricsCollector が MotionPattern + LighthouseMetrics を分析した結果
+ *
+ * @property patternImpacts - 個別アニメーションのパフォーマンス影響スコア
+ * @property overallScore - 総合スコア (0-100, 高いほど良い)
+ * @property clsContributors - CLSに貢献している要素のリスト
+ * @property layoutTriggeringProperties - レイアウトをトリガーするプロパティ
+ * @property recommendations - パフォーマンス改善推奨
+ * @property lighthouseAvailable - Lighthouseメトリクスが利用可能か
+ * @property analyzedAt - 分析日時 (ISO 8601)
+ */
+exports.animationMetricsResultSchema = zod_1.z.object({
+    patternImpacts: zod_1.z.array(exports.animationImpactScoreSchema),
+    overallScore: zod_1.z.number().min(0).max(100),
+    clsContributors: zod_1.z.array(exports.clsContributorSchema),
+    layoutTriggeringProperties: zod_1.z.array(zod_1.z.string()),
+    recommendations: zod_1.z.array(exports.performanceRecommendationSchema),
+    lighthouseAvailable: zod_1.z.boolean(),
+    analyzedAt: zod_1.z.string(),
+});
+// ============================================================================
+// External CSS Options Schema
+// ============================================================================
+/**
+ * 外部CSSオプションスキーマ
+ */
+exports.externalCssOptionsSchema = zod_1.z.object({
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(1000, { message: "timeoutは1000ms以上である必要があります" })
+        .max(30000, { message: "timeoutは30000ms以下にしてください" })
+        .default(5000),
+    maxConcurrent: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "maxConcurrentは1以上である必要があります" })
+        .max(10, { message: "maxConcurrentは10以下にしてください" })
+        .default(5),
+});
+// ============================================================================
+// motion.detect Input Schema
+// ============================================================================
+/**
+ * motion.detect 入力スキーマ
+ *
+ * @property pageId - WebページID（UUID形式、htmlと排他）
+ * @property html - HTMLコンテンツ（最大10MB、pageIdと排他）
+ * @property css - 追加CSSコンテンツ（最大5MB）
+ * @property includeInlineStyles - インラインスタイルを解析するか（デフォルトtrue）
+ * @property includeStyleSheets - スタイルシートを解析するか（デフォルトtrue）
+ * @property minDuration - 検出する最小duration（ms、デフォルト0）
+ * @property maxPatterns - 最大検出パターン数（デフォルト100）
+ * @property includeWarnings - 警告を含めるか（デフォルトtrue）
+ * @property min_severity - 返却する警告の最小重要度（info/warning/error、デフォルトinfo）
+ * @property includeSummary - サマリーを含めるか（デフォルトtrue）
+ * @property verbose - 詳細モード（rawCssを含める、デフォルトfalse）
+ */
+exports.motionDetectInputSchema = zod_1.z
+    .object({
+    pageId: zod_1.z.string().uuid({ message: "有効なUUID形式のpageIdを指定してください" }).optional(),
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional(),
+    css: zod_1.z.string().max(5_000_000, { message: "CSSコンテンツは5MB以下にしてください" }).optional(),
+    includeInlineStyles: zod_1.z.boolean().default(true),
+    includeStyleSheets: zod_1.z.boolean().default(true),
+    minDuration: zod_1.z
+        .number()
+        .min(0, { message: "minDurationは0以上である必要があります" })
+        .max(60000, { message: "minDurationは60000ms以下にしてください" })
+        .default(0),
+    maxPatterns: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "maxPatternsは1以上である必要があります" })
+        .max(4000, { message: "maxPatternsは4000以下にしてください" })
+        .default(100),
+    includeWarnings: zod_1.z.boolean().default(true),
+    min_severity: shared_schemas_1.warningSeveritySchema.optional().default("info"),
+    includeSummary: zod_1.z.boolean().default(true),
+    verbose: zod_1.z.boolean().default(false),
+    // v0.1.0: 検出モード
+    detection_mode: exports.detectionModeSchema
+        .default("video")
+        .describe("Detection mode: 'video' (default, requires url) for visual motion detection with frame capture and Lighthouse integration, 'css' (requires html/pageId) for static CSS parsing, 'runtime' (requires url) for JS-driven animations (SPA/React/Vue), 'hybrid' (requires url) for CSS+runtime combined."),
+    // v0.1.0: 3D効果検出オプション
+    include_perspective: zod_1.z.boolean().default(false),
+    // v0.1.0: ランタイム検出オプション
+    runtime_options: exports.runtimeOptionsSchema.optional(),
+    // 外部CSS取得オプション
+    fetchExternalCss: zod_1.z.boolean().default(true),
+    baseUrl: zod_1.z.string().url({ message: "baseUrlは有効なURL形式である必要があります" }).optional(),
+    externalCssOptions: exports.externalCssOptionsSchema.optional(),
+    // DB保存オプション
+    save_to_db: zod_1.z.boolean().default(true),
+    // ============================================
+    // Phase1: 動画キャプチャオプション (v0.1.0)
+    // ============================================
+    /**
+     * 動画キャプチャ用URL
+     * detection_mode='video'の場合に必須。
+     * http/https のみ許可。SSRF対策が適用されます。
+     */
+    url: zod_1.z
+        .string()
+        .url({ message: "urlは有効なURL形式である必要があります" })
+        .refine((url) => {
+        try {
+            const parsed = new URL(url);
+            return parsed.protocol === "http:" || parsed.protocol === "https:";
+        }
+        catch {
+            return false;
+        }
+    }, { message: "urlはhttp://またはhttps://で始まる必要があります" })
+        .optional(),
+    /**
+     * 動画録画・フレーム解析オプション
+     * detection_mode='video'の場合のみ有効。
+     */
+    video_options: exports.videoOptionsSchema.optional(),
+    // ============================================
+    // video mode: フレームキャプチャオプション (v0.1.0)
+    // ============================================
+    /**
+     * フレームキャプチャを有効にするか
+     * detection_mode='video'の場合のみ有効。
+     * trueにすると、ページをスクロールしながらフレームを連続撮影し、
+     * フレームキャプチャ用の素材を生成します。
+     * @default true
+     */
+    enable_frame_capture: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Enable frame capture for video mode. When true, captures frames while scrolling for video production."),
+    /**
+     * フレームキャプチャオプション
+     * enable_frame_capture=true の場合のみ有効。
+     */
+    frame_capture_options: exports.frameCaptureOptionsSchema.optional(),
+    // ============================================
+    // Phase3: Lighthouseオプション (v0.1.0)
+    // ============================================
+    /**
+     * Lighthouse実行オプション
+     * detection_mode='video'の場合のみ有効。
+     * 動画キャプチャ後にLighthouseを実行してパフォーマンスメトリクスを収集します。
+     */
+    lighthouse_options: exports.lighthouseOptionsSchema.optional(),
+    // ============================================
+    // Phase4: AnimationMetricsCollector パラメータ (v0.1.0)
+    // ============================================
+    /**
+     * アニメーションパフォーマンス分析を有効にするか
+     * detection_mode='video' かつ lighthouse_options.enabled=true の場合に有効。
+     * trueにすると、MotionPatternとLighthouseメトリクスを分析して
+     * アニメーションがパフォーマンスに与える影響を定量化します。
+     * @default false
+     */
+    analyze_metrics: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Enable animation performance analysis using AnimationMetricsCollector. Requires detection_mode=video and lighthouse_options.enabled=true."),
+    /**
+     * AnimationMetricsCollector オプション
+     * analyze_metrics=true の場合のみ有効。
+     */
+    analyze_metrics_options: exports.analyzeMetricsOptionsSchema.optional(),
+    // ============================================
+    // Phase5: Frame Image Analysis パラメータ (v0.1.0)
+    // ============================================
+    /**
+     * フレーム画像分析を有効にするか
+     * detection_mode='video' の場合に有効。
+     * trueにすると、キャプチャされたフレーム画像を解析し、
+     * ピクセル差分、レイアウトシフト(CLS)、モーションベクトルを検出します。
+     * @default true
+     */
+    analyze_frames: zod_1.z
+        .boolean()
+        .default(true)
+        .describe("Enable frame image analysis using Pixelmatch + Sharp. Detects pixel diff, layout shifts (CLS), and motion vectors. Requires detection_mode=video."),
+    /**
+     * フレーム画像分析オプション
+     * analyze_frames=true の場合のみ有効。
+     */
+    frame_analysis_options: exports.frameImageAnalysisInputOptionsSchema
+        .optional()
+        .describe("Frame image analysis options. Only effective when analyze_frames=true."),
+    // ============================================
+    // Phase6: JS Animation Detection パラメータ (v0.1.0)
+    // ============================================
+    /**
+     * JSアニメーション検出を有効にするか
+     * detection_mode='video', 'runtime', 'hybrid' の場合に有効。
+     * trueにすると、Chrome DevTools Protocol (CDP) と Web Animations API を使用して
+     * JavaScript駆動のアニメーションを検出します。
+     * GSAP, Framer Motion, Anime.js, Three.js, Lottie などのライブラリも検出します。
+     * @default false
+     */
+    detect_js_animations: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Enable JS animation detection using CDP and Web Animations API. Detects GSAP, Framer Motion, Anime.js, Three.js, Lottie. Requires url (video/runtime/hybrid mode)."),
+    /**
+     * JSアニメーション検出オプション
+     * detect_js_animations=true の場合のみ有効。
+     */
+    js_animation_options: exports.jsAnimationOptionsSchema.optional(),
+    // ============================================
+    // レスポンスサイズ最適化パラメータ (v0.1.0)
+    // ============================================
+    /**
+     * 軽量モード（summary mode）
+     * trueにすると、パターンの詳細情報（animation, performance, rawCss等）を除外し、
+     * id, name, category, trigger, type のみを返却します。
+     * 期待削減率: 70-85%
+     * @default false
+     */
+    summary: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Lightweight mode: returns id, name, category, trigger, type only (default: false). When true, detailed animation/performance/rawCss info is excluded for 70-85% response size reduction."),
+    /**
+     * レスポンス最大文字数制限
+     * 指定した文字数を超える場合、パターンを順次削減して制限内に収めます。
+     * 切り詰め発生時は _truncated: true と _original_size がレスポンスに含まれます。
+     * @minimum 100
+     * @maximum 10000000
+     */
+    truncate_max_chars: zod_1.z
+        .number()
+        .int()
+        .min(100, { message: "truncate_max_charsは100以上である必要があります" })
+        .max(10_000_000, { message: "truncate_max_charsは10000000以下にしてください" })
+        .optional()
+        .describe("Max response size in characters (100-10000000). When exceeded, patterns are progressively removed and _truncated metadata is added."),
+    /**
+     * 自動サイズ最適化
+     * trueにすると、レスポンスサイズに応じて自動的に最適化を適用します。
+     * - 100KB超: summary=true に切り替え
+     * - 500KB超: truncate を適用
+     * 適用された最適化は _size_optimization メタデータで報告されます。
+     * @default false
+     */
+    auto_optimize: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Auto-optimize response size: applies summary=true when >100KB, truncate when >500KB. Reports applied optimizations in _size_optimization metadata."),
+    // ============================================
+    // タイムアウト設定 (v0.1.0)
+    // ============================================
+    /**
+     * 全体タイムアウト（ミリ秒）
+     * motion.detect 処理全体の最大実行時間を指定します。
+     * タイムアウト発生時は、それまでに取得できた結果（CSS解析等）を
+     * 警告付きで返却します（graceful degradation）。
+     * @minimum 30000 (30秒)
+     * @maximum 600000 (10分)
+     * @default 180000 (3分)
+     */
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(30000, { message: "timeoutは30000ms（30秒）以上である必要があります" })
+        .max(600000, { message: "timeoutは600000ms（10分）以下にしてください" })
+        .default(180000)
+        .describe("Overall timeout in milliseconds (30000-600000, default: 180000 = 3 minutes). On timeout, returns partial results with warnings (graceful degradation)."),
+})
+    .refine((data) => {
+    // video/runtime/hybrid モードの場合は url が必須
+    if (data.detection_mode === "video" ||
+        data.detection_mode === "runtime" ||
+        data.detection_mode === "hybrid") {
+        return data.url !== undefined;
+    }
+    // それ以外のモードでは pageId または html が必須
+    const hasPageId = data.pageId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return hasPageId || hasHtml;
+}, {
+    message: "detection_mode=video/runtime/hybridの場合はurlが必須、それ以外はpageIdまたはhtmlのいずれかを指定してください",
+})
+    .refine((_data) => {
+    // video モードでは pageId/html は使用しない（警告ではなく無視される）
+    // この refine は検証ではなくドキュメント目的
+    return true;
+}, {
+    message: "detection_mode=videoの場合、pageId/htmlは無視されます",
+})
+    .refine((data) => {
+    // fetchExternalCss=true の場合、baseUrl が必須
+    // ただし、以下の場合は免除:
+    // 1. detection_mode='css' かつ html/pageId 指定（CSS静的解析モードでは外部CSSフェッチは任意）
+    // 2. detection_mode='video'/'runtime'/'hybrid' かつ url 指定（urlからbaseUrlを推測可能）
+    if (data.fetchExternalCss && !data.baseUrl) {
+        // css モードで html または pageId が指定されている場合は OK
+        if (data.detection_mode === "css" && (data.html || data.pageId)) {
+            return true;
+        }
+        // video/runtime/hybrid モードで url が指定されている場合は OK（urlからbaseUrlを推測可能）
+        if ((data.detection_mode === "video" ||
+            data.detection_mode === "runtime" ||
+            data.detection_mode === "hybrid") &&
+            data.url) {
+            return true;
+        }
+        return false;
+    }
+    return true;
+}, {
+    message: "fetchExternalCssがtrueの場合、baseUrlは必須です（css+html/pageIdまたはvideo/runtime/hybrid+url指定時を除く）",
+    path: ["baseUrl"],
+});
+// ============================================================================
+// motion.detect Output Schema
+// ============================================================================
+/**
+ * DB保存結果スキーマ
+ */
+exports.motionSaveResultSchema = zod_1.z.object({
+    saved: zod_1.z.boolean(),
+    savedCount: zod_1.z.number().int().nonnegative(),
+    patternIds: zod_1.z.array(zod_1.z.string().uuid()),
+    embeddingIds: zod_1.z.array(zod_1.z.string().uuid()),
+    /** 保存されなかった理由（saved=false時） */
+    reason: zod_1.z.string().optional(),
+});
+/**
+ * デバッグ情報スキーマ（開発環境のみ）
+ */
+exports.debugInfoSchema = zod_1.z
+    .object({
+    persistenceServiceAvailable: zod_1.z.boolean(),
+    isAvailable: zod_1.z.boolean().optional(),
+    error: zod_1.z.string().optional(),
+    factoryExists: zod_1.z.boolean().optional(),
+})
+    .optional();
+/**
+ * ランタイム実行情報スキーマ (v0.1.0)
+ *
+ * runtime / hybrid モードで返却されるランタイム実行情報
+ */
+exports.runtimeInfoSchema = zod_1.z.object({
+    /** 実際に使用された待機時間（ms） */
+    wait_time_used: zod_1.z.number().min(0).optional(),
+    /** キャプチャされたアニメーション数 */
+    animations_captured: zod_1.z.number().int().nonnegative().optional(),
+    /** チェックされたスクロール位置の配列（%） */
+    scroll_positions_checked: zod_1.z.array(zod_1.z.number().min(0).max(100)).optional(),
+    /** スクロール位置ごとのパターン数 */
+    patterns_by_scroll_position: zod_1.z.record(zod_1.z.string(), zod_1.z.number().int().nonnegative()).optional(),
+    /** スクロールで検出されたパターン総数 */
+    total_scroll_patterns: zod_1.z.number().int().nonnegative().optional(),
+});
+/**
+ * ビデオ解析情報スキーマ (Phase1: v0.1.0)
+ *
+ * detection_mode='video' で返却されるビデオ録画・解析情報
+ */
+exports.videoInfoSchema = zod_1.z.object({
+    /** 録画URL */
+    recorded_url: zod_1.z.string().url(),
+    /** 録画時間（ms） */
+    record_duration_ms: zod_1.z.number().int().min(0),
+    /** 動画ファイルサイズ（bytes） */
+    video_size_bytes: zod_1.z.number().int().nonnegative(),
+    /** 解析したフレーム数 */
+    frames_analyzed: zod_1.z.number().int().nonnegative(),
+    /** 検出されたモーションセグメント数 */
+    motion_segments_detected: zod_1.z.number().int().nonnegative(),
+    /** 処理時間（ms） */
+    processing_time_ms: zod_1.z.number().int().nonnegative(),
+    /** ビューポートサイズ */
+    viewport: zod_1.z
+        .object({
+        width: zod_1.z.number().int().positive(),
+        height: zod_1.z.number().int().positive(),
+    })
+        .optional(),
+    /** ページタイトル */
+    page_title: zod_1.z.string().optional(),
+    /** モーションカバレッジ（0-1） - 動画内でモーションが検出された時間の割合 */
+    motion_coverage: zod_1.z.number().min(0).max(1).optional(),
+});
+// ============================================================================
+// レスポンスサイズ最適化メタデータスキーマ (v0.1.0)
+// ============================================================================
+/**
+ * サイズ最適化情報スキーマ
+ * auto_optimize=true 時に適用された最適化の詳細情報
+ */
+exports.sizeOptimizationSchema = zod_1.z.object({
+    /** 最適化前のサイズ（バイト） */
+    original_size_bytes: zod_1.z.number().int().nonnegative(),
+    /** 最適化後のサイズ（バイト） */
+    optimized_size_bytes: zod_1.z.number().int().nonnegative(),
+    /** 削減率（%） */
+    reduction_percent: zod_1.z.number().min(0).max(100),
+    /** 適用された最適化のリスト */
+    applied_optimizations: zod_1.z.array(zod_1.z.enum(["summary", "truncate"])),
+});
+/**
+ * motion.detect 成功レスポンスデータスキーマ
+ */
+exports.motionDetectDataSchema = zod_1.z.object({
+    pageId: zod_1.z.string().uuid().optional(),
+    patterns: zod_1.z.array(shared_schemas_1.motionPatternSchema),
+    summary: shared_schemas_1.motionSummarySchema.optional(),
+    warnings: zod_1.z.array(shared_schemas_1.motionWarningSchema).optional(),
+    metadata: shared_schemas_1.motionMetadataSchema,
+    saveResult: exports.motionSaveResultSchema.optional(),
+    /** デバッグ情報（開発環境のみ） */
+    _debugInfo: exports.debugInfoSchema,
+    /** v0.1.0: ランタイム実行情報 (runtime/hybrid モード時) */
+    runtime_info: exports.runtimeInfoSchema.optional(),
+    /** Phase1 v0.1.0: ビデオ解析情報 (video モード時) */
+    video_info: exports.videoInfoSchema.optional(),
+    // ============================================
+    // video mode: フレームキャプチャ結果 (v0.1.0)
+    // ============================================
+    /**
+     * フレームキャプチャ結果
+     * enable_frame_capture=true かつ detection_mode='video' の場合に設定
+     * enable_frame_capture=false の場合は undefined
+     */
+    frame_capture: exports.frameCaptureResultSchema.optional(),
+    /**
+     * フレームキャプチャエラー情報
+     * フレームキャプチャ実行が失敗した場合に設定（graceful degradation）
+     */
+    frame_capture_error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+    // ============================================
+    // Phase3: Lighthouseメトリクス (v0.1.0)
+    // ============================================
+    /**
+     * Lighthouseパフォーマンスメトリクス
+     * lighthouse_options.enabled=true かつ detection_mode='video' の場合に設定
+     * エラーまたは利用不可の場合はnull
+     */
+    lighthouse_metrics: exports.lighthouseMetricsSchema.nullable().optional(),
+    /**
+     * Lighthouseエラー情報
+     * Lighthouse実行が失敗した場合に設定（graceful degradation）
+     */
+    lighthouse_error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+    /**
+     * Lighthouse DB保存結果
+     * lighthouse_options.save_to_db=true の場合に設定
+     */
+    lighthouse_save_result: zod_1.z
+        .object({
+        saved: zod_1.z.boolean(),
+    })
+        .optional(),
+    // ============================================
+    // Phase4: AnimationMetrics分析結果 (v0.1.0)
+    // ============================================
+    /**
+     * アニメーションパフォーマンス分析結果
+     * analyze_metrics=true かつ detection_mode='video' かつ lighthouse_options.enabled=true の場合に設定
+     * エラーまたは利用不可の場合はnull
+     */
+    animation_metrics: exports.animationMetricsResultSchema.nullable().optional(),
+    /**
+     * AnimationMetrics分析エラー情報
+     * 分析が失敗した場合に設定（graceful degradation）
+     */
+    animation_metrics_error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+    // ============================================
+    // Phase5: Frame Image Analysis結果 (v0.1.0)
+    // ============================================
+    /**
+     * フレーム画像分析結果
+     * analyze_frames=true かつ detection_mode='video' の場合に設定
+     * Pixelmatch + Sharp を使用してフレーム間の差分、レイアウトシフト、モーションベクトルを検出
+     */
+    frame_analysis: zod_1.z
+        .object({
+        /**
+         * 分析メタデータ
+         */
+        metadata: zod_1.z.object({
+            /** 総フレーム数 */
+            totalFrames: zod_1.z.number().int().nonnegative(),
+            /** 分析したフレームペア数 */
+            analyzedPairs: zod_1.z.number().int().nonnegative(),
+            /** サンプリング間隔 */
+            sampleInterval: zod_1.z.number().int().positive(),
+            /** フレームあたりのスクロール量（px） */
+            scrollPxPerFrame: zod_1.z.number().positive(),
+            /** 分析時間（秒） */
+            analysisTime: zod_1.z.string(),
+            /** 分析日時（ISO 8601） */
+            analyzedAt: zod_1.z.string(),
+        }),
+        /**
+         * 統計情報
+         */
+        statistics: zod_1.z.object({
+            /** 平均ピクセル差分（%） */
+            averageDiffPercentage: zod_1.z.string(),
+            /** 有意な変化があったフレームペア数 */
+            significantChangeCount: zod_1.z.number().int().nonnegative(),
+            /** 有意な変化の割合（%） */
+            significantChangePercentage: zod_1.z.string(),
+            /** レイアウトシフト検出数 */
+            layoutShiftCount: zod_1.z.number().int().nonnegative(),
+            /** モーションベクトル検出数 */
+            motionVectorCount: zod_1.z.number().int().nonnegative(),
+        }),
+        /**
+         * 検出されたアニメーションゾーン
+         * 連続する有意な変化がある領域を検出
+         */
+        animationZones: zod_1.z.array(zod_1.z.object({
+            /** 開始フレーム名 */
+            frameStart: zod_1.z.string(),
+            /** 終了フレーム名 */
+            frameEnd: zod_1.z.string(),
+            /** スクロール開始位置（px） */
+            scrollStart: zod_1.z.number().nonnegative(),
+            /** スクロール終了位置（px） */
+            scrollEnd: zod_1.z.number().nonnegative(),
+            /** アニメーション持続時間（スクロールpx） */
+            duration: zod_1.z.number().nonnegative(),
+            /** 平均ピクセル差分（%） */
+            avgDiff: zod_1.z.string(),
+            /** 最大ピクセル差分（%） */
+            peakDiff: zod_1.z.string(),
+            /** アニメーションタイプ推定 */
+            animationType: zod_1.z.enum([
+                "micro-interaction",
+                "fade/slide transition",
+                "scroll-linked animation",
+                "long-form reveal",
+            ]),
+        })),
+        /**
+         * 検出されたレイアウトシフト（CLS問題）
+         * Core Web Vitalsの基準（0.05）を超えるシフトを検出
+         */
+        layoutShifts: zod_1.z.array(zod_1.z.object({
+            /** フレーム範囲（例: "frame-0010.png - frame-0020.png"） */
+            frameRange: zod_1.z.string(),
+            /** スクロール範囲（例: "150px - 300px"） */
+            scrollRange: zod_1.z.string(),
+            /** 影響度スコア（CLS指標） */
+            impactFraction: zod_1.z.string(),
+            /** 影響を受けた領域のバウンディングボックス */
+            boundingBox: zod_1.z.object({
+                x: zod_1.z.number().int().nonnegative(),
+                y: zod_1.z.number().int().nonnegative(),
+                width: zod_1.z.number().int().nonnegative(),
+                height: zod_1.z.number().int().nonnegative(),
+            }),
+        })),
+        /**
+         * 検出されたモーションベクトル
+         * 閾値を超える移動があるフレームペアを検出
+         */
+        motionVectors: zod_1.z.array(zod_1.z.object({
+            /** フレーム範囲 */
+            frameRange: zod_1.z.string(),
+            /** X方向移動量（px） */
+            dx: zod_1.z.number(),
+            /** Y方向移動量（px） */
+            dy: zod_1.z.number(),
+            /** 移動量の大きさ（px） */
+            magnitude: zod_1.z.string(),
+            /** 移動方向 */
+            direction: zod_1.z.enum(["up", "down", "left", "right", "stationary"]),
+            /** 角度（度） */
+            angle: zod_1.z.string(),
+        })),
+    })
+        .nullable()
+        .optional()
+        .describe("Frame image analysis results. Set when analyze_frames=true and detection_mode=video. Uses Pixelmatch + Sharp for diff detection, layout shift (CLS) detection, and motion vector estimation."),
+    /**
+     * フレーム画像分析エラー情報
+     * 分析が失敗した場合に設定（graceful degradation）
+     */
+    frame_analysis_error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+    /**
+     * フレーム画像分析結果のDB保存結果 (v0.1.0)
+     * save_to_db=true かつ analyze_frames=true の場合に、
+     * AnimationZone/LayoutShift/MotionVectorをMotionPatternとして保存した結果
+     */
+    frame_analysis_save_result: zod_1.z
+        .object({
+        /** 保存が成功したか */
+        saved: zod_1.z.boolean(),
+        /** 保存したパターン数 */
+        savedCount: zod_1.z.number().int().nonnegative(),
+        /** 保存したパターンID一覧 */
+        patternIds: zod_1.z.array(zod_1.z.string().uuid()),
+        /** 保存したEmbedding ID一覧 */
+        embeddingIds: zod_1.z.array(zod_1.z.string().uuid()),
+        /** エラー理由（失敗時） */
+        reason: zod_1.z.string().optional(),
+        /** カテゴリ別保存数 */
+        byCategory: zod_1.z
+            .object({
+            animationZones: zod_1.z.number().int().nonnegative(),
+            layoutShifts: zod_1.z.number().int().nonnegative(),
+            motionVectors: zod_1.z.number().int().nonnegative(),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe("DB save result for frame analysis. Set when save_to_db=true and analyze_frames=true. Saves AnimationZones, LayoutShifts, and MotionVectors as MotionPatterns with embeddings."),
+    // ============================================
+    // Phase6: JS Animation Detection結果 (v0.1.0)
+    // ============================================
+    /**
+     * JSアニメーション検出結果
+     * detect_js_animations=true かつ URL指定時（runtime/hybrid/videoモード）に設定
+     * Chrome DevTools Protocol + Web Animations API + ライブラリ検出の統合結果
+     */
+    js_animations: exports.jsAnimationResultSchema
+        .nullable()
+        .optional()
+        .describe("JS animation detection results. Set when detect_js_animations=true and URL is provided. " +
+        "Combines CDP Animation domain, Web Animations API, and library detection (GSAP, Framer Motion, Anime.js, Three.js, Lottie)."),
+    /**
+     * JSアニメーション検出エラー情報
+     * 検出が失敗した場合に設定（graceful degradation）
+     */
+    js_animations_error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+    /**
+     * JSアニメーションDB保存結果 (v0.1.0)
+     * save_to_db=true かつ JS Animation検出成功時に設定
+     * js_animation_patterns + js_animation_embeddings テーブルへの保存結果
+     */
+    js_animation_save_result: zod_1.z
+        .object({
+        savedPatternCount: zod_1.z.number().int().nonnegative(),
+        embeddingCount: zod_1.z.number().int().nonnegative(),
+        error: zod_1.z.string().optional(),
+    })
+        .optional()
+        .describe("DB save result for JS animation patterns. Set when save_to_db=true and JS animations are detected. " +
+        "Saves to js_animation_patterns and js_animation_embeddings tables with multilingual-e5-base embeddings."),
+    // ============================================
+    // レスポンスサイズ最適化メタデータ (v0.1.0)
+    // ============================================
+    /**
+     * サマリーモードフラグ
+     * summary=true が適用された場合に true
+     */
+    _summary_mode: zod_1.z.boolean().optional(),
+    /**
+     * 切り詰めフラグ
+     * truncate_max_chars による切り詰めが発生した場合に true
+     */
+    _truncated: zod_1.z.boolean().optional(),
+    /**
+     * 切り詰め前の元サイズ（文字数）
+     * 切り詰めが発生した場合のみ設定
+     */
+    _original_size: zod_1.z.number().int().nonnegative().optional(),
+    /**
+     * 切り詰められたパターン数
+     * truncate_max_chars で削減されたパターンの数
+     */
+    _patterns_truncated_count: zod_1.z.number().int().nonnegative().optional(),
+    /**
+     * サイズ最適化情報
+     * auto_optimize=true で最適化が適用された場合に設定
+     */
+    _size_optimization: exports.sizeOptimizationSchema.optional(),
+});
+/**
+ * エラー情報スキーマ
+ */
+exports.motionDetectErrorSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * motion.detect 成功レスポンススキーマ
+ */
+exports.motionDetectSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.motionDetectDataSchema,
+});
+/**
+ * motion.detect 失敗レスポンススキーマ
+ */
+exports.motionDetectErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.motionDetectErrorSchema,
+});
+/**
+ * motion.detect 出力スキーマ（統合）
+ */
+exports.motionDetectOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.motionDetectSuccessOutputSchema,
+    exports.motionDetectErrorOutputSchema,
+]);
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * motion.* ツール用エラーコード
+ */
+exports.MOTION_MCP_ERROR_CODES = {
+    /** バリデーションエラー */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** ページが見つからない */
+    PAGE_NOT_FOUND: "PAGE_NOT_FOUND",
+    /** 無効なHTML */
+    INVALID_HTML: "INVALID_HTML",
+    /** 無効なCSS */
+    INVALID_CSS: "INVALID_CSS",
+    /** 解析エラー */
+    PARSE_ERROR: "PARSE_ERROR",
+    /** 検出エラー */
+    DETECTION_ERROR: "DETECTION_ERROR",
+    /** データベースエラー */
+    DB_ERROR: "DB_ERROR",
+    /** 内部エラー */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    /** サービス利用不可 */
+    SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+    /** タイムアウト */
+    TIMEOUT: "TIMEOUT",
+    /** Phase1: 動画録画エラー */
+    VIDEO_RECORD_ERROR: "VIDEO_RECORD_ERROR",
+    /** Phase1: フレーム解析エラー */
+    FRAME_ANALYSIS_ERROR: "FRAME_ANALYSIS_ERROR",
+    /** Phase1: 動画タイムアウトエラー */
+    VIDEO_TIMEOUT_ERROR: "VIDEO_TIMEOUT_ERROR",
+    /** Phase1: SSRFブロック */
+    SSRF_BLOCKED: "SSRF_BLOCKED",
+};
+// ============================================================================
+// Warning Codes
+// ============================================================================
+/**
+ * 警告コード
+ */
+exports.MOTION_WARNING_CODES = {
+    /** パフォーマンス警告: レイアウトトリガー */
+    PERF_LAYOUT_TRIGGER: "PERF_LAYOUT_TRIGGER",
+    /** パフォーマンス警告: 過度なアニメーション */
+    PERF_TOO_MANY_ANIMATIONS: "PERF_TOO_MANY_ANIMATIONS",
+    /** パフォーマンス警告: 長いduration */
+    PERF_LONG_DURATION: "PERF_LONG_DURATION",
+    /** アクセシビリティ警告: reduced-motion未対応 */
+    A11Y_NO_REDUCED_MOTION: "A11Y_NO_REDUCED_MOTION",
+    /** アクセシビリティ警告: 無限アニメーション */
+    A11Y_INFINITE_ANIMATION: "A11Y_INFINITE_ANIMATION",
+    /** 解析警告: 不完全なキーフレーム */
+    PARSE_INCOMPLETE_KEYFRAMES: "PARSE_INCOMPLETE_KEYFRAMES",
+    /** 解析警告: 無効なイージング */
+    PARSE_INVALID_EASING: "PARSE_INVALID_EASING",
+    /** 外部CSS取得失敗 */
+    EXTERNAL_CSS_FETCH_FAILED: "EXTERNAL_CSS_FETCH_FAILED",
+    /** 外部CSS SSRF保護によりブロック */
+    EXTERNAL_CSS_SSRF_BLOCKED: "EXTERNAL_CSS_SSRF_BLOCKED",
+    /** Phase3: Lighthouse利用不可 */
+    LIGHTHOUSE_UNAVAILABLE: "LIGHTHOUSE_UNAVAILABLE",
+    /** Phase4: AnimationMetrics分析にはLighthouseが必要 */
+    ANALYZE_METRICS_REQUIRES_LIGHTHOUSE: "ANALYZE_METRICS_REQUIRES_LIGHTHOUSE",
+    /** Phase4: AnimationMetrics分析が利用不可 */
+    ANIMATION_METRICS_UNAVAILABLE: "ANIMATION_METRICS_UNAVAILABLE",
+    /** Phase5: Frame Image Analysis利用不可 */
+    FRAME_ANALYSIS_UNAVAILABLE: "FRAME_ANALYSIS_UNAVAILABLE",
+    /** WebGL/Canvas検出機能が無効（detect_js_animations=false時）*/
+    WEBGL_DETECTION_DISABLED: "WEBGL_DETECTION_DISABLED",
+};
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * パフォーマンスレベルを計算
+ */
+function calculatePerformanceLevel(info) {
+    // GPU加速プロパティのみ使用 && レイアウト/ペイントなし = excellent
+    if ((info.usesTransform || info.usesOpacity) && !info.triggersLayout && !info.triggersPaint) {
+        return "excellent";
+    }
+    // レイアウトトリガーあり = poor
+    if (info.triggersLayout) {
+        return "poor";
+    }
+    // ペイントトリガーあり = fair
+    if (info.triggersPaint) {
+        return "fair";
+    }
+    // それ以外 = good
+    return "good";
+}
+/**
+ * 複雑度スコアを計算
+ */
+function calculateComplexityScore(patterns) {
+    if (patterns.length === 0)
+        return 0;
+    let score = 0;
+    // パターン数による加算
+    score += Math.min(patterns.length * 5, 30);
+    // キーフレーム複雑度
+    const keyframeCount = patterns.reduce((sum, p) => sum + (p.keyframes?.length ?? 0), 0);
+    score += Math.min(keyframeCount * 2, 20);
+    // プロパティ数（propertiesがない場合も安全に処理）
+    const propertyCount = patterns.reduce((sum, p) => sum + (p.properties?.length ?? 0), 0);
+    score += Math.min(propertyCount * 3, 30);
+    // 無限アニメーション（'infinite' または -1 をサポート）
+    const infiniteCount = patterns.filter((p) => p.animation?.iterations === "infinite" ||
+        p.animation?.iterations === -1 ||
+        p.animation?.iterations === Infinity).length;
+    score += Math.min(infiniteCount * 5, 20);
+    return Math.min(score, 100);
+}
+/**
+ * 平均duration計算
+ */
+function calculateAverageDuration(patterns) {
+    const durations = patterns
+        .map((p) => p.animation?.duration)
+        .filter((d) => d !== undefined && d > 0);
+    if (durations.length === 0)
+        return 0;
+    return Math.round(durations.reduce((a, b) => a + b, 0) / durations.length);
+}
+/**
+ * タイプ別集計
+ */
+function countByType(patterns) {
+    const counts = {
+        css_animation: 0,
+        css_transition: 0,
+        keyframes: 0,
+        library_animation: 0,
+        video_motion: 0,
+    };
+    for (const pattern of patterns) {
+        counts[pattern.type]++;
+    }
+    return counts;
+}
+/**
+ * トリガー別集計
+ */
+function countByTrigger(patterns) {
+    const counts = {
+        scroll: 0,
+        scroll_velocity: 0,
+        hover: 0,
+        click: 0,
+        focus: 0,
+        load: 0,
+        intersection: 0,
+        time: 0,
+        state_change: 0,
+        unknown: 0,
+    };
+    for (const pattern of patterns) {
+        counts[pattern.trigger]++;
+    }
+    return counts;
+}
+/**
+ * カテゴリ別集計
+ */
+function countByCategory(patterns) {
+    const counts = {
+        scroll_trigger: 0,
+        hover_effect: 0,
+        page_transition: 0,
+        loading_state: 0,
+        micro_interaction: 0,
+        attention_grabber: 0,
+        navigation: 0,
+        feedback: 0,
+        entrance: 0,
+        exit: 0,
+        // v0.1.0 new categories
+        marquee: 0,
+        video_overlay: 0,
+        parallax: 0,
+        reveal: 0,
+        morphing: 0,
+        background_animation: 0,
+        typing_animation: 0,
+        unknown: 0,
+    };
+    for (const pattern of patterns) {
+        counts[pattern.category]++;
+    }
+    return counts;
+}
+/**
+ * フレームキャプチャ設定を計算
+ *
+ * デフォルト値を適用し、相互に依存する値を計算します。
+ *
+ * デフォルト値:
+ * - scroll_px_per_frame = 15 (Reftrix仕様)
+ * - frame_rate = 30
+ * - frame_interval_ms = 1000 / frame_rate = 33.33ms
+ *
+ * 計算式:
+ * - frame_interval_ms = 1000 / frame_rate
+ * - scroll_speed_px_per_sec = page_height_px / scroll_duration_sec
+ * - total_frames = ceil(scroll_duration_sec * frame_rate)
+ *
+ * @param options - フレームキャプチャオプション
+ * @returns 計算済みの設定
+ */
+function calculateFrameCaptureConfig(options = {}) {
+    // デフォルト値
+    const page_height_px = options.page_height_px ?? 1080;
+    const scroll_duration_sec = options.scroll_duration_sec ?? 5;
+    const frame_rate = options.frame_rate ?? 30;
+    const output_format = options.output_format ?? "png";
+    const output_dir = options.output_dir ?? "/tmp/reftrix-frames/";
+    const filename_pattern = options.filename_pattern ?? "frame-{0000}.png";
+    // 計算式: frame_interval_ms = 1000 / frame_rate
+    const frame_interval_ms = options.frame_interval_ms ?? 1000 / frame_rate;
+    // 計算式: scroll_speed_px_per_sec = page_height_px / scroll_duration_sec
+    const scroll_speed_px_per_sec = options.scroll_speed_px_per_sec ?? page_height_px / scroll_duration_sec;
+    // デフォルト値: 15px/frame（Reftrix仕様）
+    // 15px/frameの根拠:
+    // - 60fps等価スクロール（216px/秒 ÷ 60 ≈ 3.6px）と50px/frameの中間
+    // - IntersectionObserver閾値（0.1〜0.3）を確実に検出
+    // - cubic-bezier easing曲線の解析に十分なサンプル数
+    // - parallax微動（係数0.02〜0.05）の検出可能
+    const scroll_px_per_frame = options.scroll_px_per_frame ?? 15;
+    // 計算式: total_frames = scroll_duration_sec * frame_rate
+    const total_frames = Math.ceil(scroll_duration_sec * frame_rate);
+    if (process.env.NODE_ENV === "development" && process.env.DEBUG_FRAME_CAPTURE) {
+        console.warn("[FrameCapture] Config calculated:", {
+            frame_rate,
+            frame_interval_ms,
+            scroll_speed_px_per_sec,
+            scroll_px_per_frame,
+            total_frames,
+        });
+    }
+    return {
+        frame_rate,
+        frame_interval_ms,
+        scroll_speed_px_per_sec,
+        scroll_px_per_frame,
+        output_format,
+        output_dir,
+        filename_pattern,
+        page_height_px,
+        scroll_duration_sec,
+        total_frames,
+    };
+}
+/**
+ * フレームファイル情報の生成
+ *
+ * 設定に基づいて各フレームのファイル情報を生成します。
+ *
+ * @param config - フレームキャプチャ設定
+ * @returns フレームファイル情報の配列
+ */
+function generateFrameFileInfos(config) {
+    const files = [];
+    const pattern = config.filename_pattern;
+    const ext = config.output_format;
+    for (let i = 0; i < config.total_frames; i++) {
+        const frame_number = i;
+        const scroll_position_px = Math.min(i * config.scroll_px_per_frame, config.page_height_px);
+        const timestamp_ms = i * config.frame_interval_ms;
+        // ファイル名パターンの置換: {0000} -> 0001, {000} -> 001
+        let filename = pattern.replace(/\{(\d+)\}/g, (_, digits) => {
+            const padLength = digits.length;
+            return String(i).padStart(padLength, "0");
+        });
+        // 拡張子の置換
+        filename = filename.replace(/\.(png|jpeg)$/, `.${ext}`);
+        const file_path = `${config.output_dir}${filename}`;
+        files.push({
+            frame_number,
+            scroll_position_px,
+            timestamp_ms,
+            file_path,
+        });
+    }
+    if (process.env.NODE_ENV === "development" && process.env.DEBUG_FRAME_CAPTURE) {
+        console.warn("[FrameCapture] Generated", files.length, "frame file infos");
+    }
+    return files;
+}
+// ============================================================================
+// MCP Tool Definitions
+// ============================================================================
+/**
+ * MCP Tool definitions for motion.* tools
+ * MCPプロトコル準拠のツール定義
+ */
+exports.motionMcpTools = {
+    "motion.detect": {
+        name: "motion.detect",
+        description: "Webページからモーション/アニメーションパターンを検出・分類します。CSSアニメーション、トランジション、キーフレームを解析し、パフォーマンスやアクセシビリティの問題を警告します。",
+        inputSchema: exports.motionDetectInputSchema,
+    },
+    "motion.search": {
+        name: "motion.search",
+        description: "モーションパターンを類似検索します。自然言語クエリまたはサンプルパターンを使用して、類似のアニメーション/トランジションパターンを検索できます。",
+        // inputSchema is defined below after motionSearchInputSchema
+    },
+};
+//# sourceMappingURL=detect.schemas.js.map