@reftrixmcp/mcp-server 0.1.7

package/dist/tools/layout/schemas.js

@@ -0,0 +1,1497 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layoutSearchSourceSchema = exports.layoutSearchPreviewSchema = exports.layoutSearchInputSchema = exports.visionSearchOptionsSchema = exports.visionSearchQuerySchema = exports.visionSearchVisualFeaturesSchema = exports.multimodalOptionsSchema = exports.searchModeSchema = exports.integrationHintsSchema = exports.projectContextOptionsSchema = exports.layoutSearchFiltersSchema = exports.visualFeaturesFilterSchema = exports.visualFeaturesDensityFilterSchema = exports.visualFeaturesColorsFilterSchema = exports.visualFeaturesThemeFilterSchema = exports.layoutInspectOutputSchema = exports.gridInfoSchema = exports.typographyInfoSchema = exports.sectionInfoSchema = exports.layoutInspectInputSchema = exports.layoutInspectOptionsSchema = exports.layoutIngestSimpleOutputSchema = exports.layoutIngestOutputSchema = exports.layoutIngestErrorOutputSchema = exports.layoutIngestSuccessOutputSchema = exports.layoutIngestErrorInfoSchema = exports.layoutIngestDataSchema = exports.sourceInfoOutputSchema = exports.pageMetadataOutputSchema = exports.computedStyleInfoSchema = exports.childElementStyleInfoSchema = exports.elementComputedStylesSchema = exports.screenshotInfoSchema = exports.layoutIngestInputSchema = exports.layoutIngestOptionsSchema = exports.responsiveAnalysisOptionsSchema = exports.responsiveAnalysisSchema = exports.viewportScreenshotSchema = exports.responsiveDifferenceSchema = exports.elementVisibilitySchema = exports.navigationTypeSchema = exports.DEFAULT_VIEWPORTS = exports.responsiveViewportSchema = exports.viewportSchema = exports.sortOrderSchema = exports.sortBySchema = exports.frameworkSchema = exports.sectionTypeForSearchSchema = exports.usageScopeSchema = exports.sourceTypeSchema = void 0;
+exports.layoutMcpTools = exports.LAYOUT_MCP_ERROR_CODES = exports.layoutBatchIngestOutputSchema = exports.layoutBatchIngestErrorOutputSchema = exports.layoutBatchIngestSuccessOutputSchema = exports.layoutBatchIngestErrorInfoSchema = exports.layoutBatchIngestDataSchema = exports.batchIngestSummarySchema = exports.batchIngestResultItemSchema = exports.layoutBatchIngestInputSchema = exports.layoutBatchIngestOptionsSchema = exports.layoutPatternsOutputSchema = exports.layoutPatternItemSchema = exports.layoutPatternsInputSchema = exports.layoutToCodeLegacyOutputSchema = exports.layoutToCodeOutputSchema = exports.layoutToCodeErrorOutputSchema = exports.layoutToCodeSuccessOutputSchema = exports.layoutToCodeErrorInfoSchema = exports.layoutToCodeDataSchema = exports.layoutToCodeInputSchema = exports.layoutToCodeOptionsSchema = exports.layoutSearchOutputSchema = exports.layoutSearchErrorOutputSchema = exports.layoutSearchSuccessOutputSchema = exports.layoutSearchErrorInfoSchema = exports.layoutSearchDataSchema = exports.rrfDetailsSchema = exports.inferredContextSchema = exports.layoutSearchResultItemSchema = exports.visionAnalysisSchema = exports.visionFeatureSchema = void 0;
+/**
+ * layout.* MCP Tools Zod Schema Definitions
+ * Webデザインレイアウト解析ツールの入力/出力バリデーションスキーマ
+ *
+ * @module @reftrixmcp/mcp-server/tools/layout/schemas
+ *
+ * 対応ツール:
+ * - layout.ingest: URLからWebページを取得しレイアウト解析用データを準備
+ * - layout.inspect: HTMLを解析しセクション・グリッド・タイポグラフィを抽出
+ * - layout.search: レイアウトパターンをセマンティック検索
+ * - layout.generate_code: パターンからReact/Vue/HTMLコードを生成
+ * - layout.batch_ingest: 複数URLを一括取得しレイアウト解析用データを準備
+ */
+const zod_1 = require("zod");
+const mood_brandtone_filters_1 = require("../../schemas/mood-brandtone-filters");
+// ============================================================================
+// Enum Schemas
+// ============================================================================
+/**
+ * ソースタイプ
+ * - award_gallery: アワードサイトからの収集
+ * - user_provided: ユーザーが提供
+ */
+exports.sourceTypeSchema = zod_1.z.enum(["award_gallery", "user_provided"]);
+/**
+ * 利用範囲
+ * - inspiration_only: インスピレーションのみ（商用利用不可）
+ * - owned_asset: 所有アセット（商用利用可）
+ */
+exports.usageScopeSchema = zod_1.z.enum(["inspiration_only", "owned_asset"]);
+/**
+ * セクションタイプ（検索用 - unknownを除外）
+ * Webページの主要セクションタイプ
+ *
+ * 基本タイプ（10種）:
+ * - hero: ヒーローセクション
+ * - feature: 機能・特徴紹介
+ * - cta: コールトゥアクション
+ * - testimonial: お客様の声
+ * - pricing: 料金プラン
+ * - footer: フッター
+ * - navigation: ナビゲーション
+ * - about: 会社・サービス紹介
+ * - contact: お問い合わせ
+ * - gallery: ギャラリー
+ *
+ * 拡張タイプ（8種）:
+ * - partners: パートナー・クライアントロゴ
+ * - portfolio: ポートフォリオ・実績
+ * - team: チーム・メンバー紹介
+ * - stories: ストーリー・事例紹介
+ * - research: リサーチ・調査結果
+ * - subscribe: 購読・ニュースレター登録
+ * - stats: 統計・数値実績
+ * - faq: よくある質問
+ */
+exports.sectionTypeForSearchSchema = zod_1.z.enum([
+    // 基本タイプ（10種）
+    "hero",
+    "feature",
+    "cta",
+    "testimonial",
+    "pricing",
+    "footer",
+    "navigation",
+    "about",
+    "contact",
+    "gallery",
+    // 拡張タイプ（8種）
+    "partners",
+    "portfolio",
+    "team",
+    "stories",
+    "research",
+    "subscribe",
+    "stats",
+    "faq",
+]);
+/**
+ * フレームワーク
+ * コード生成時のターゲットフレームワーク
+ */
+exports.frameworkSchema = zod_1.z.enum(["react", "vue", "html"]);
+/**
+ * ソート対象フィールド
+ */
+exports.sortBySchema = zod_1.z.enum(["createdAt", "usageCount", "quality"]);
+/**
+ * ソート順序
+ */
+exports.sortOrderSchema = zod_1.z.enum(["asc", "desc"]);
+// ============================================================================
+// layout.ingest Schemas
+// ============================================================================
+/**
+ * ビューポート設定スキーマ
+ *
+ * @property width - 幅（320-4096px）
+ * @property height - 高さ（240-16384px）
+ */
+exports.viewportSchema = zod_1.z.object({
+    width: zod_1.z
+        .number()
+        .int({ message: "widthは整数である必要があります" })
+        .min(320, { message: "widthは320以上4096以下である必要があります" })
+        .max(4096, { message: "widthは320以上4096以下である必要があります" }),
+    height: zod_1.z
+        .number()
+        .int({ message: "heightは整数である必要があります" })
+        .min(240, { message: "heightは240以上16384以下である必要があります" })
+        .max(16384, { message: "heightは240以上16384以下である必要があります" }),
+});
+// ============================================================================
+// Responsive Viewport Schemas (v0.1.0)
+// ============================================================================
+/**
+ * 名前付きビューポートスキーマ
+ * マルチビューポートキャプチャ用
+ *
+ * @property name - ビューポート名（desktop/tablet/mobile等）
+ * @property width - 幅（320-4096px）
+ * @property height - 高さ（240-16384px）
+ */
+exports.responsiveViewportSchema = zod_1.z.object({
+    name: zod_1.z
+        .string()
+        .min(1, { message: "nameは1文字以上必要です" })
+        .max(50, { message: "nameは50文字以下にしてください" }),
+    width: zod_1.z
+        .number()
+        .int({ message: "widthは整数である必要があります" })
+        .min(320, { message: "widthは320以上4096以下である必要があります" })
+        .max(4096, { message: "widthは320以上4096以下である必要があります" }),
+    height: zod_1.z
+        .number()
+        .int({ message: "heightは整数である必要があります" })
+        .min(240, { message: "heightは240以上16384以下である必要があります" })
+        .max(16384, { message: "heightは240以上16384以下である必要があります" }),
+});
+/**
+ * デフォルトビューポートプリセット
+ * - desktop: 1920x1080 (Full HD)
+ * - tablet: 768x1024 (iPad Portrait)
+ * - mobile: 375x667 (iPhone SE)
+ */
+exports.DEFAULT_VIEWPORTS = [
+    { name: "desktop", width: 1920, height: 1080 },
+    { name: "tablet", width: 768, height: 1024 },
+    { name: "mobile", width: 375, height: 667 },
+];
+/**
+ * ナビゲーションタイプ
+ * レスポンシブデザインでのナビゲーション表示パターン
+ */
+exports.navigationTypeSchema = zod_1.z.enum([
+    "horizontal-menu", // 水平メニュー（デスクトップ向け）
+    "hamburger-menu", // ハンバーガーメニュー（モバイル向け）
+    "drawer", // ドロワーメニュー
+    "bottom-nav", // ボトムナビゲーション
+    "tab-bar", // タブバー
+    "hidden", // 非表示
+    "other", // その他
+]);
+/**
+ * 要素の可視性情報スキーマ
+ */
+exports.elementVisibilitySchema = zod_1.z.object({
+    visible: zod_1.z.boolean(),
+    type: exports.navigationTypeSchema.optional(),
+    displayMode: zod_1.z.string().optional(), // CSS display値
+    reason: zod_1.z.string().optional(), // 非表示の理由（display:none, visibility:hidden等）
+});
+/**
+ * レスポンシブ差異アイテムスキーマ
+ * 各ビューポート間での要素の差異を記録
+ *
+ * @property element - CSSセレクタ
+ * @property description - 差異の説明
+ * @property category - 差異のカテゴリ
+ */
+exports.responsiveDifferenceSchema = zod_1.z.object({
+    element: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    category: zod_1.z.enum([
+        "visibility", // 表示/非表示の変化
+        "layout", // レイアウト構造の変化
+        "navigation", // ナビゲーションパターンの変化
+        "typography", // タイポグラフィの変化
+        "spacing", // 間隔の変化
+        "order", // 要素順序の変化
+        "other", // その他
+    ]),
+    desktop: zod_1.z.record(zod_1.z.unknown()).optional(),
+    tablet: zod_1.z.record(zod_1.z.unknown()).optional(),
+    mobile: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+/**
+ * ビューポート別スクリーンショットスキーマ
+ */
+exports.viewportScreenshotSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    width: zod_1.z.number().int().positive(),
+    height: zod_1.z.number().int().positive(),
+    screenshot: zod_1.z
+        .object({
+        base64: zod_1.z.string(),
+        format: zod_1.z.enum(["png", "jpeg"]),
+        width: zod_1.z.number().int().positive(),
+        height: zod_1.z.number().int().positive(),
+    })
+        .optional(),
+});
+/**
+ * レスポンシブ解析結果スキーマ
+ * layout.ingestのレスポンシブ解析結果
+ *
+ * @property viewportsAnalyzed - 解析したビューポート名配列
+ * @property differences - 検出された差異配列
+ * @property breakpoints - 検出されたブレークポイント
+ * @property screenshots - ビューポート別スクリーンショット
+ */
+exports.responsiveAnalysisSchema = zod_1.z.object({
+    viewportsAnalyzed: zod_1.z.array(zod_1.z.string()),
+    differences: zod_1.z.array(exports.responsiveDifferenceSchema),
+    breakpoints: zod_1.z.array(zod_1.z.string()),
+    screenshots: zod_1.z.array(exports.viewportScreenshotSchema).optional(),
+    analysisTimeMs: zod_1.z.number().nonnegative().optional(),
+    /** DB保存時のレコードID（save_to_db: true 時のみ） */
+    responsiveAnalysisId: zod_1.z.string().uuid().optional(),
+});
+/**
+ * レスポンシブ解析オプションスキーマ
+ *
+ * @property enabled - レスポンシブ解析を有効化（デフォルトfalse）
+ * @property viewports - カスタムビューポート配列（省略時はデフォルト3種）
+ * @property include_screenshots - 各ビューポートのスクリーンショットを含める（デフォルトtrue）
+ * @property detect_navigation - ナビゲーションパターン検出（デフォルトtrue）
+ * @property detect_visibility - 要素の表示/非表示変化検出（デフォルトtrue）
+ * @property detect_layout - レイアウト構造変化検出（デフォルトtrue）
+ */
+exports.responsiveAnalysisOptionsSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().optional().default(false),
+    viewports: zod_1.z
+        .array(exports.responsiveViewportSchema)
+        .min(1, { message: "viewportsは1つ以上指定してください" })
+        .max(10, { message: "viewportsは10個以下にしてください" })
+        .optional(),
+    include_screenshots: zod_1.z.boolean().optional().default(true),
+    /** ビューポート差分画像を結果に含めるか（デフォルトfalse） */
+    include_diff_images: zod_1.z.boolean().optional().default(false),
+    /** ビューポート差分の閾値（0-1、デフォルト0.1） */
+    diff_threshold: zod_1.z.number().min(0).max(1).optional().default(0.1),
+    /** DB保存するか（デフォルトtrue、save_to_db連動） */
+    save_to_db: zod_1.z.boolean().optional().default(true),
+    detect_navigation: zod_1.z.boolean().optional().default(true),
+    detect_visibility: zod_1.z.boolean().optional().default(true),
+    detect_layout: zod_1.z.boolean().optional().default(true),
+});
+/**
+ * layout.ingest オプションスキーマ
+ *
+ * @property fullPage - フルページキャプチャ（デフォルトtrue）
+ * @property viewport - ビューポート設定（オプション）
+ * @property waitForSelector - 待機セレクタ（オプション）
+ * @property timeout - タイムアウト（1000-120000ms、デフォルト30000）
+ * @property disableJavaScript - JavaScript無効化（デフォルトfalse）
+ * @property include_html - HTMLを返却に含めるか（デフォルトfalse）
+ * @property include_screenshot - スクリーンショットを返却に含めるか（デフォルトfalse）
+ * @property truncate_html_bytes - HTMLを切り詰めるバイト数（100-10000000、オプション）
+ * @property screenshot_format - スクリーンショット形式（png/jpeg、デフォルトpng）
+ * @property screenshot_quality - JPEG品質（1-100、オプション）
+ * @property screenshot_max_width - スクリーンショット最大幅（オプション）
+ * @property screenshot_max_height - スクリーンショット最大高さ（オプション）
+ * @property auto_optimize - レスポンス自動最適化（デフォルトfalse）
+ * @property response_size_limit - レスポンスサイズ上限（10000-50000000、オプション）
+ * @property wait_until - ページ読み込み完了判定（load/domcontentloaded/networkidle、デフォルトload）
+ */
+exports.layoutIngestOptionsSchema = zod_1.z.object({
+    // snake_case parameters (MCP standard)
+    full_page: zod_1.z.boolean().optional().default(true),
+    viewport: exports.viewportSchema.optional(),
+    wait_for_selector: zod_1.z.string().optional(),
+    wait_until: zod_1.z.enum(["load", "domcontentloaded", "networkidle"]).optional().default("load"),
+    /** DOM安定化待機（React/Vue/Next.js対応、デフォルトtrue） */
+    wait_for_dom_stable: zod_1.z.boolean().optional().default(true),
+    /** DOM安定化判定の無変更時間（ms）（デフォルト500） */
+    dom_stable_timeout: zod_1.z
+        .number()
+        .int({ message: "dom_stable_timeoutは整数である必要があります" })
+        .min(100, { message: "dom_stable_timeoutは100以上5000以下である必要があります" })
+        .max(5000, { message: "dom_stable_timeoutは100以上5000以下である必要があります" })
+        .optional()
+        .default(500),
+    /** ローディング完了後の追加待機時間（ms）（0-30000） */
+    wait_for_timeout: zod_1.z
+        .number()
+        .int({ message: "wait_for_timeoutは整数である必要があります" })
+        .min(0, { message: "wait_for_timeoutは0以上30000以下である必要があります" })
+        .max(30000, { message: "wait_for_timeoutは0以上30000以下である必要があります" })
+        .optional(),
+    /** 非表示待機セレクター（ローディング要素など） */
+    wait_for_selector_hidden: zod_1.z.string().optional(),
+    timeout: zod_1.z
+        .number()
+        .int({ message: "timeoutは整数である必要があります" })
+        .min(1000, { message: "timeoutは1000以上120000以下である必要があります" })
+        .max(120000, { message: "timeoutは1000以上120000以下である必要があります" })
+        .optional()
+        .default(30000),
+    disable_javascript: zod_1.z.boolean().optional().default(false),
+    // レスポンス最適化オプション（DB-first: レスポンスサイズ削減）
+    include_html: zod_1.z.boolean().optional().default(false),
+    include_screenshot: zod_1.z.boolean().optional().default(false),
+    truncate_html_bytes: zod_1.z
+        .number()
+        .int({ message: "truncate_html_bytesは整数である必要があります" })
+        .min(100, { message: "truncate_html_bytesは100以上10000000以下である必要があります" })
+        .max(10000000, { message: "truncate_html_bytesは100以上10000000以下である必要があります" })
+        .optional(),
+    screenshot_format: zod_1.z.enum(["png", "jpeg"]).optional().default("png"),
+    screenshot_quality: zod_1.z
+        .number()
+        .int({ message: "screenshot_qualityは整数である必要があります" })
+        .min(1, { message: "screenshot_qualityは1以上100以下である必要があります" })
+        .max(100, { message: "screenshot_qualityは1以上100以下である必要があります" })
+        .optional(),
+    screenshot_max_width: zod_1.z
+        .number()
+        .int({ message: "screenshot_max_widthは整数である必要があります" })
+        .min(1, { message: "screenshot_max_widthは1以上16384以下である必要があります" })
+        .max(16384, { message: "screenshot_max_widthは1以上16384以下である必要があります" })
+        .optional(),
+    screenshot_max_height: zod_1.z
+        .number()
+        .int({ message: "screenshot_max_heightは整数である必要があります" })
+        .min(1, { message: "screenshot_max_heightは1以上16384以下である必要があります" })
+        .max(16384, { message: "screenshot_max_heightは1以上16384以下である必要があります" })
+        .optional(),
+    auto_optimize: zod_1.z.boolean().optional().default(false),
+    response_size_limit: zod_1.z
+        .number()
+        .int({ message: "response_size_limitは整数である必要があります" })
+        .min(10000, { message: "response_size_limitは10000以上50000000以下である必要があります" })
+        .max(50000000, { message: "response_size_limitは10000以上50000000以下である必要があります" })
+        .optional(),
+    // DB保存オプション（DB-first: デフォルトで保存）
+    save_to_db: zod_1.z.boolean().optional().default(true),
+    // 自動解析オプション（DB-first: Embedding自動生成）
+    auto_analyze: zod_1.z.boolean().optional().default(true),
+    // Computed Stylesオプション
+    include_computed_styles: zod_1.z.boolean().optional().default(false),
+    // 外部CSS取得オプション
+    /** 外部CSSファイルの内容を取得するか（デフォルト: true） */
+    fetch_external_css: zod_1.z.boolean().optional().default(true),
+    /** 外部CSS取得のタイムアウト（ミリ秒、デフォルト: 5000） */
+    external_css_timeout: zod_1.z
+        .number()
+        .int({ message: "external_css_timeoutは整数である必要があります" })
+        .min(1000, { message: "external_css_timeoutは1000以上30000以下である必要があります" })
+        .max(30000, { message: "external_css_timeoutは1000以上30000以下である必要があります" })
+        .optional()
+        .default(5000),
+    /** 外部CSS1ファイルあたりの最大サイズ（バイト、デフォルト: 5MB） */
+    external_css_max_size: zod_1.z
+        .number()
+        .int({ message: "external_css_max_sizeは整数である必要があります" })
+        .min(1024, { message: "external_css_max_sizeは1024以上10485760以下である必要があります" })
+        .max(10485760, { message: "external_css_max_sizeは1024以上10485760以下である必要があります" })
+        .optional()
+        .default(5242880),
+    /** 外部CSS取得の最大並列数（デフォルト: 5） */
+    external_css_max_concurrent: zod_1.z
+        .number()
+        .int({ message: "external_css_max_concurrentは整数である必要があります" })
+        .min(1, { message: "external_css_max_concurrentは1以上10以下である必要があります" })
+        .max(10, { message: "external_css_max_concurrentは1以上10以下である必要があります" })
+        .optional()
+        .default(5),
+    /** 外部CSS取得の最大ファイル数（デフォルト: 20） */
+    external_css_max_files: zod_1.z
+        .number()
+        .int({ message: "external_css_max_filesは整数である必要があります" })
+        .min(1, { message: "external_css_max_filesは1以上50以下である必要があります" })
+        .max(50, { message: "external_css_max_filesは1以上50以下である必要があります" })
+        .optional()
+        .default(20),
+    /**
+     * WebGLを完全に無効化
+     * 重い3Dサイト（Three.js、WebGL等）でタイムアウトが発生する場合に使用
+     * true設定時: 専用ブラウザインスタンスを起動し、WebGL関連機能を無効化
+     * @default false
+     */
+    disable_webgl: zod_1.z.boolean().optional().default(false),
+    /**
+     * タイムアウト時にブラウザプロセスを強制終了
+     * WebGLサイトでハングした場合の最終手段として使用
+     * @default false
+     */
+    force_kill_on_timeout: zod_1.z.boolean().optional().default(false),
+    /**
+     * レスポンシブ解析オプション
+     * 複数ビューポートでのレイアウト差異を検出
+     * @see responsiveAnalysisOptionsSchema
+     */
+    responsive: exports.responsiveAnalysisOptionsSchema.optional(),
+});
+/**
+ * layout.ingest 入力スキーマ
+ *
+ * @property url - 取得対象URL（必須）
+ * @property source_type - ソースタイプ（デフォルトuser_provided）
+ * @property usage_scope - 利用範囲（デフォルトinspiration_only）
+ * @property options - オプション設定（オプション）
+ */
+exports.layoutIngestInputSchema = zod_1.z.object({
+    url: zod_1.z.string().url({ message: "有効なURL形式を指定してください" }),
+    source_type: exports.sourceTypeSchema.optional().default("user_provided"),
+    usage_scope: exports.usageScopeSchema.optional().default("inspiration_only"),
+    options: exports.layoutIngestOptionsSchema.optional(),
+    /** robots.txtを尊重するかどうか（RFC 9309）。falseで無視 */
+    respect_robots_txt: zod_1.z.boolean().optional(),
+});
+/**
+ * スクリーンショット情報スキーマ
+ */
+exports.screenshotInfoSchema = zod_1.z.object({
+    base64: zod_1.z.string(),
+    format: zod_1.z.enum(["png", "jpeg"]),
+    width: zod_1.z.number().int().positive(),
+    height: zod_1.z.number().int().positive(),
+});
+/**
+ * 要素のComputed Stylesスキーマ
+ * 取得するCSSプロパティのセット
+ */
+exports.elementComputedStylesSchema = zod_1.z.object({
+    // 背景
+    backgroundColor: zod_1.z.string(),
+    backgroundImage: zod_1.z.string(),
+    // テキスト
+    color: zod_1.z.string(),
+    fontSize: zod_1.z.string(),
+    fontFamily: zod_1.z.string(),
+    fontWeight: zod_1.z.string(),
+    lineHeight: zod_1.z.string(),
+    letterSpacing: zod_1.z.string(),
+    textAlign: zod_1.z.string(),
+    textDecoration: zod_1.z.string(),
+    textTransform: zod_1.z.string(),
+    // レイアウト
+    display: zod_1.z.string(),
+    position: zod_1.z.string(),
+    flexDirection: zod_1.z.string(),
+    justifyContent: zod_1.z.string(),
+    alignItems: zod_1.z.string(),
+    padding: zod_1.z.string(),
+    paddingTop: zod_1.z.string(),
+    paddingRight: zod_1.z.string(),
+    paddingBottom: zod_1.z.string(),
+    paddingLeft: zod_1.z.string(),
+    margin: zod_1.z.string(),
+    marginTop: zod_1.z.string(),
+    marginRight: zod_1.z.string(),
+    marginBottom: zod_1.z.string(),
+    marginLeft: zod_1.z.string(),
+    gap: zod_1.z.string(),
+    width: zod_1.z.string(),
+    height: zod_1.z.string(),
+    maxWidth: zod_1.z.string(),
+    minHeight: zod_1.z.string(),
+    // 視覚効果
+    border: zod_1.z.string(),
+    borderRadius: zod_1.z.string(),
+    boxShadow: zod_1.z.string(),
+    backdropFilter: zod_1.z.string(),
+    opacity: zod_1.z.string(),
+    overflow: zod_1.z.string(),
+    // トランジション・アニメーション
+    transition: zod_1.z.string(),
+    transform: zod_1.z.string(),
+});
+/**
+ * 子要素のComputed Styles情報スキーマ
+ */
+exports.childElementStyleInfoSchema = zod_1.z.object({
+    /** CSSセレクタ（ユニーク識別用） */
+    selector: zod_1.z.string(),
+    /** HTML要素タグ名 */
+    tagName: zod_1.z.string(),
+    /** class属性値 */
+    className: zod_1.z.string(),
+    /** 親セクションからの相対パス */
+    path: zod_1.z.string(),
+    /** 要素のテキストコンテンツ（ボタンやリンクの場合） */
+    textContent: zod_1.z.string().optional(),
+    /** Computed Styles */
+    styles: exports.elementComputedStylesSchema,
+});
+/**
+ * Computed Styles情報スキーマ
+ * ブラウザがレンダリングした実際のスタイル値
+ */
+exports.computedStyleInfoSchema = zod_1.z.object({
+    /** セクションのインデックス */
+    index: zod_1.z.number().int().nonnegative(),
+    /** HTML要素タグ名 */
+    tagName: zod_1.z.string(),
+    /** class属性値 */
+    className: zod_1.z.string(),
+    /** id属性値 */
+    id: zod_1.z.string(),
+    /** role属性値 */
+    role: zod_1.z.string(),
+    /** セクション自体のComputed Styles */
+    styles: exports.elementComputedStylesSchema,
+    /** セクション内の子要素のスタイル（重要な要素のみ） */
+    children: zod_1.z.array(exports.childElementStyleInfoSchema).optional(),
+});
+/**
+ * ページメタデータ出力スキーマ
+ */
+exports.pageMetadataOutputSchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    favicon: zod_1.z.string().optional(),
+    ogImage: zod_1.z.string().optional(),
+});
+/**
+ * ソース情報出力スキーマ
+ */
+exports.sourceInfoOutputSchema = zod_1.z.object({
+    type: exports.sourceTypeSchema,
+    usageScope: exports.usageScopeSchema,
+});
+/**
+ * layout.ingest 成功レスポンスデータスキーマ
+ * htmlとscreenshotはinclude_html/include_screenshotオプションに応じて省略可能
+ */
+exports.layoutIngestDataSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    url: zod_1.z.string().url(),
+    normalizedUrl: zod_1.z.string().url(),
+    html: zod_1.z.string().optional(), // include_html: false で省略
+    screenshot: exports.screenshotInfoSchema.optional(), // include_screenshot: false で省略
+    computedStyles: zod_1.z.array(exports.computedStyleInfoSchema).optional(), // include_computed_styles: true で取得
+    metadata: exports.pageMetadataOutputSchema,
+    source: exports.sourceInfoOutputSchema,
+    crawledAt: zod_1.z.string().datetime(),
+    // DB保存ステータス
+    savedToDb: zod_1.z.boolean().optional(), // save_to_db: true 時のみ true
+    // レスポンシブ解析結果（responsive.enabled: true 時のみ）
+    responsiveAnalysis: exports.responsiveAnalysisSchema.optional(),
+});
+/**
+ * layout.ingest エラー情報スキーマ
+ */
+exports.layoutIngestErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * layout.ingest 成功レスポンススキーマ
+ */
+exports.layoutIngestSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.layoutIngestDataSchema,
+});
+/**
+ * layout.ingest 失敗レスポンススキーマ
+ */
+exports.layoutIngestErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.layoutIngestErrorInfoSchema,
+});
+/**
+ * layout.ingest 出力スキーマ（統合）
+ */
+exports.layoutIngestOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.layoutIngestSuccessOutputSchema,
+    exports.layoutIngestErrorOutputSchema,
+]);
+/**
+ * layout.ingest シンプル出力スキーマ（後方互換用）
+ * @deprecated layoutIngestOutputSchema を使用してください
+ */
+exports.layoutIngestSimpleOutputSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    url: zod_1.z.string().url(),
+    title: zod_1.z.string().optional(),
+    screenshotUrl: zod_1.z.string().url().optional(),
+    htmlSize: zod_1.z.number().int().nonnegative(),
+    sectionsDetected: zod_1.z.number().int().nonnegative(),
+    ingestedAt: zod_1.z.string().datetime(),
+});
+// ============================================================================
+// layout.inspect Schemas
+// ============================================================================
+/**
+ * layout.inspect オプションスキーマ
+ *
+ * @property detectSections - セクション検出（デフォルトtrue）
+ * @property extractColors - 色抽出（デフォルトtrue）
+ * @property analyzeTypography - タイポグラフィ解析（デフォルトtrue）
+ * @property detectGrid - グリッド検出（デフォルトtrue）
+ */
+exports.layoutInspectOptionsSchema = zod_1.z.object({
+    detectSections: zod_1.z.boolean().optional().default(true),
+    extractColors: zod_1.z.boolean().optional().default(true),
+    analyzeTypography: zod_1.z.boolean().optional().default(true),
+    detectGrid: zod_1.z.boolean().optional().default(true),
+});
+/**
+ * layout.inspect 入力スキーマ
+ *
+ * @property id - WebページID（UUID形式、htmlと排他）
+ * @property html - HTMLコンテンツ（最大10MB、idと排他）
+ * @property options - オプション設定（オプション）
+ *
+ * バリデーション: idまたはhtmlのいずれか一方のみ指定可能
+ */
+exports.layoutInspectInputSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid({ message: "有効なUUID形式のIDを指定してください" }).optional(),
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional(),
+    options: exports.layoutInspectOptionsSchema.optional(),
+})
+    .refine((data) => {
+    const hasId = data.id !== undefined;
+    const hasHtml = data.html !== undefined;
+    // Either id or html must be provided, but not both
+    return (hasId || hasHtml) && !(hasId && hasHtml);
+}, {
+    message: "idまたはhtmlのいずれか一方のみを指定してください",
+});
+/**
+ * セクション情報スキーマ
+ */
+exports.sectionInfoSchema = zod_1.z.object({
+    type: zod_1.z.string(),
+    index: zod_1.z.number().int().nonnegative(),
+    confidence: zod_1.z.number().min(0).max(1),
+    htmlSnippet: zod_1.z.string().optional(),
+});
+/**
+ * タイポグラフィ情報スキーマ
+ */
+exports.typographyInfoSchema = zod_1.z.object({
+    fonts: zod_1.z.array(zod_1.z.string()),
+    headingSizes: zod_1.z.array(zod_1.z.string()).optional(),
+    bodySize: zod_1.z.string().optional(),
+});
+/**
+ * グリッド情報スキーマ
+ */
+exports.gridInfoSchema = zod_1.z.object({
+    columns: zod_1.z.number().int().positive().optional(),
+    gap: zod_1.z.string().optional(),
+    areas: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * layout.inspect 出力スキーマ
+ */
+exports.layoutInspectOutputSchema = zod_1.z.object({
+    webPageId: zod_1.z.string().uuid(),
+    sections: zod_1.z.array(exports.sectionInfoSchema),
+    colors: zod_1.z.array(zod_1.z.string()).optional(),
+    typography: exports.typographyInfoSchema.optional(),
+    grid: exports.gridInfoSchema.optional(),
+});
+// ============================================================================
+// layout.search Schemas
+// ============================================================================
+// ============================================================================
+// Visual Features Filter Schemas (Phase 4-1)
+// ============================================================================
+/**
+ * HEXカラーパターン（#RRGGBB形式）
+ */
+const hexColorPattern = /^#[0-9A-Fa-f]{6}$/;
+/**
+ * テーマフィルタースキーマ
+ * layoutInfo.visualFeatures.theme に基づくフィルタリング
+ *
+ * @property type - テーマタイプ（light/dark/mixed）
+ * @property minContrastRatio - 最小コントラスト比（1-21、WCAG基準）
+ */
+exports.visualFeaturesThemeFilterSchema = zod_1.z.object({
+    type: zod_1.z.enum(["light", "dark", "mixed"]).optional(),
+    minContrastRatio: zod_1.z
+        .number()
+        .min(1, { message: "minContrastRatioは1以上21以下である必要があります" })
+        .max(21, { message: "minContrastRatioは1以上21以下である必要があります" })
+        .optional(),
+});
+/**
+ * カラーフィルタースキーマ
+ * layoutInfo.visualFeatures.colors に基づくフィルタリング
+ *
+ * @property dominantColor - 支配色（HEX形式 #RRGGBB）
+ * @property colorTolerance - 色許容度（ΔE距離、0-100、デフォルト15）
+ */
+exports.visualFeaturesColorsFilterSchema = zod_1.z.object({
+    dominantColor: zod_1.z
+        .string()
+        .regex(hexColorPattern, {
+        message: "dominantColorは#RRGGBB形式である必要があります",
+    })
+        .optional(),
+    colorTolerance: zod_1.z
+        .number()
+        .min(0, { message: "colorToleranceは0以上100以下である必要があります" })
+        .max(100, { message: "colorToleranceは0以上100以下である必要があります" })
+        .default(15)
+        .optional(),
+});
+/**
+ * 密度フィルタースキーマ
+ * layoutInfo.visualFeatures.density に基づくフィルタリング
+ *
+ * @property minContentDensity - 最小コンテンツ密度（0-1）
+ * @property maxContentDensity - 最大コンテンツ密度（0-1）
+ * @property minWhitespaceRatio - 最小ホワイトスペース比率（0-1）
+ */
+exports.visualFeaturesDensityFilterSchema = zod_1.z.object({
+    minContentDensity: zod_1.z
+        .number()
+        .min(0, { message: "minContentDensityは0以上1以下である必要があります" })
+        .max(1, { message: "minContentDensityは0以上1以下である必要があります" })
+        .optional(),
+    maxContentDensity: zod_1.z
+        .number()
+        .min(0, { message: "maxContentDensityは0以上1以下である必要があります" })
+        .max(1, { message: "maxContentDensityは0以上1以下である必要があります" })
+        .optional(),
+    minWhitespaceRatio: zod_1.z
+        .number()
+        .min(0, { message: "minWhitespaceRatioは0以上1以下である必要があります" })
+        .max(1, { message: "minWhitespaceRatioは0以上1以下である必要があります" })
+        .optional(),
+});
+/**
+ * ビジュアル特徴フィルタースキーマ（統合）
+ * SectionPattern.layoutInfo.visualFeatures に基づくフィルタリング
+ *
+ * @property theme - テーマフィルター（light/dark/mixed、コントラスト比）
+ * @property colors - カラーフィルター（支配色、許容度）
+ * @property density - 密度フィルター（コンテンツ密度、ホワイトスペース比率）
+ */
+exports.visualFeaturesFilterSchema = zod_1.z.object({
+    theme: exports.visualFeaturesThemeFilterSchema.optional(),
+    colors: exports.visualFeaturesColorsFilterSchema.optional(),
+    density: exports.visualFeaturesDensityFilterSchema.optional(),
+});
+// ============================================================================
+// layout.search Filters Schema
+// ============================================================================
+/**
+ * layout.search フィルタースキーマ
+ *
+ * @property sectionType - セクションタイプフィルター（オプション）
+ * @property sourceType - ソースタイプフィルター（オプション）
+ * @property usageScope - 利用範囲フィルター（オプション）
+ * @property visualFeatures - ビジュアル特徴フィルター（Phase 4-1、オプション）
+ */
+exports.layoutSearchFiltersSchema = zod_1.z.object({
+    sectionType: exports.sectionTypeForSearchSchema.optional(),
+    sourceType: exports.sourceTypeSchema.optional(),
+    usageScope: exports.usageScopeSchema.optional(),
+    visualFeatures: exports.visualFeaturesFilterSchema.optional(),
+    mood: mood_brandtone_filters_1.moodFilterSchema.optional(),
+    brandTone: mood_brandtone_filters_1.brandToneFilterSchema.optional(),
+});
+/**
+ * Project Context オプションスキーマ
+ * プロジェクトのデザインパターンを検出し、検索結果の適合度を評価
+ *
+ * @property enabled - プロジェクトコンテキスト解析を有効化（デフォルトtrue）
+ * @property project_path - スキャン対象のプロジェクトパス（オプション）
+ * @property design_tokens_path - デザイントークンファイルの特定パス（オプション）
+ */
+exports.projectContextOptionsSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().optional().default(true),
+    project_path: zod_1.z.string().min(1, { message: "project_pathは空文字列にできません" }).optional(),
+    design_tokens_path: zod_1.z
+        .string()
+        .min(1, { message: "design_tokens_pathは空文字列にできません" })
+        .optional(),
+});
+/**
+ * Integration Hints スキーマ
+ * 検索結果をプロジェクトに統合するためのヒント情報
+ *
+ * @property suggested_hooks - 推奨カスタムフック（useScrollAnimation等）
+ * @property color_mapping - パターン色からプロジェクトトークンへのマッピング
+ * @property existing_animations - 既存アニメーション（globals.css等）
+ */
+exports.integrationHintsSchema = zod_1.z.object({
+    suggested_hooks: zod_1.z.array(zod_1.z.string()),
+    color_mapping: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    existing_animations: zod_1.z.array(zod_1.z.string()),
+});
+// ============================================================================
+// Multimodal Search Schemas
+// ============================================================================
+/**
+ * 検索モードスキーマ
+ * マルチモーダル検索における検索モードを指定
+ *
+ * - text_only: text_embeddingのみを使用（デフォルト）
+ * - vision_only: vision_embeddingのみを使用
+ * - combined: 両方を使用してRRF統合
+ */
+exports.searchModeSchema = zod_1.z.enum(["text_only", "vision_only", "combined"]);
+/**
+ * マルチモーダルオプションスキーマ
+ * RRF統合検索の重み付け設定
+ *
+ * @property textWeight - text_embeddingの重み（0-1、デフォルト0.6）
+ * @property visionWeight - vision_embeddingの重み（0-1、デフォルト0.4）
+ * @property rrfK - RRFのkパラメータ（1-100、デフォルト60）
+ */
+exports.multimodalOptionsSchema = zod_1.z.object({
+    textWeight: zod_1.z
+        .number()
+        .min(0, { message: "textWeightは0以上1以下である必要があります" })
+        .max(1, { message: "textWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.6),
+    visionWeight: zod_1.z
+        .number()
+        .min(0, { message: "visionWeightは0以上1以下である必要があります" })
+        .max(1, { message: "visionWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.4),
+    rrfK: zod_1.z
+        .number()
+        .int({ message: "rrfKは整数である必要があります" })
+        .min(1, { message: "rrfKは1以上100以下である必要があります" })
+        .max(100, { message: "rrfKは1以上100以下である必要があります" })
+        .optional()
+        .default(60),
+});
+// ============================================================================
+// Vision Search Query Schema (Phase 4-2)
+// ============================================================================
+/**
+ * VisualFeatures検索条件スキーマ
+ * vision_embeddingを活用したセマンティック検索用
+ *
+ * @property theme - テーマ（light/dark/mixed）
+ * @property colors - 色指定（HEX形式配列）
+ * @property density - 密度（sparse/moderate/dense）
+ * @property gradient - グラデーション（none/subtle/prominent）
+ * @property mood - 雰囲気（professional/playful/minimal等）
+ * @property brandTone - ブランドトーン
+ */
+exports.visionSearchVisualFeaturesSchema = zod_1.z.object({
+    theme: zod_1.z.string().optional(),
+    colors: zod_1.z.array(zod_1.z.string()).optional(),
+    density: zod_1.z.string().optional(),
+    gradient: zod_1.z.string().optional(),
+    mood: zod_1.z.string().optional(),
+    brandTone: zod_1.z.string().optional(),
+});
+/**
+ * Vision検索クエリスキーマ
+ * vision_embedding列でのセマンティック検索
+ *
+ * @property textQuery - テキストクエリ（視覚的特徴を自然言語で記述）
+ * @property visualFeatures - 構造化された視覚的特徴条件
+ * @property sectionPatternId - 既存セクションIDで類似検索
+ */
+exports.visionSearchQuerySchema = zod_1.z.object({
+    textQuery: zod_1.z
+        .string()
+        .min(1, { message: "textQueryは1文字以上必要です" })
+        .max(500, { message: "textQueryは500文字以下にしてください" })
+        .optional(),
+    visualFeatures: exports.visionSearchVisualFeaturesSchema.optional(),
+    sectionPatternId: zod_1.z
+        .string()
+        .uuid({ message: "有効なUUID形式のsectionPatternIdを指定してください" })
+        .optional(),
+});
+/**
+ * Vision検索オプションスキーマ
+ *
+ * @property minSimilarity - 最小類似度（0-1、デフォルト0.5）
+ * @property visionWeight - RRFでのvision_embeddingの重み（0-1、デフォルト0.6）
+ * @property textWeight - RRFでのtext_embeddingの重み（0-1、デフォルト0.4）
+ */
+exports.visionSearchOptionsSchema = zod_1.z.object({
+    minSimilarity: zod_1.z
+        .number()
+        .min(0, { message: "minSimilarityは0以上1以下である必要があります" })
+        .max(1, { message: "minSimilarityは0以上1以下である必要があります" })
+        .optional()
+        .default(0.5),
+    visionWeight: zod_1.z
+        .number()
+        .min(0, { message: "visionWeightは0以上1以下である必要があります" })
+        .max(1, { message: "visionWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.6),
+    textWeight: zod_1.z
+        .number()
+        .min(0, { message: "textWeightは0以上1以下である必要があります" })
+        .max(1, { message: "textWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.4),
+});
+// ============================================================================
+// layout.search Input Schema
+// ============================================================================
+/**
+ * layout.search 入力スキーマ
+ *
+ * @property query - 検索クエリ（1-500文字、必須）
+ * @property filters - 検索フィルター（オプション）
+ * @property limit - 取得件数（1-50、デフォルト10）
+ * @property offset - オフセット（0以上、デフォルト0）
+ * @property include_html - HTMLを含めるか（デフォルトfalse）- snake_case正式形式
+ * @property includeHtml - HTMLを含めるか（デフォルトfalse）- レガシー互換（include_html推奨）
+ * @property include_preview - プレビュー用HTMLスニペットを含めるか（デフォルトtrue）
+ * @property preview_max_length - プレビューの最大文字数（100-1000、デフォルト500）
+ * @property project_context - プロジェクトコンテキスト解析オプション（オプション）
+ * @property use_vision_search - Vision検索を有効化（デフォルトfalse）
+ * @property vision_search_query - Vision検索クエリ（use_vision_search=true時に使用）
+ * @property vision_search_options - Vision検索オプション（use_vision_search=true時に使用）
+ */
+exports.layoutSearchInputSchema = zod_1.z.object({
+    query: zod_1.z
+        .string()
+        .min(1, { message: "クエリは1文字以上必要です" })
+        .max(500, { message: "クエリは500文字以下にしてください" }),
+    filters: exports.layoutSearchFiltersSchema.optional(),
+    limit: zod_1.z
+        .number()
+        .int({ message: "limitは整数である必要があります" })
+        .min(1, { message: "limitは1以上50以下である必要があります" })
+        .max(50, { message: "limitは1以上50以下である必要があります" })
+        .optional()
+        .default(10),
+    offset: zod_1.z
+        .number()
+        .int({ message: "offsetは整数である必要があります" })
+        .min(0, { message: "offsetは0以上である必要があります" })
+        .optional()
+        .default(0),
+    // MCP-RESP-03: snake_case正式形式（新規オプション推奨形式）
+    // デフォルト値はgetIncludeHtml()で適用（両形式対応のため）
+    include_html: zod_1.z.boolean().optional(),
+    // レガシー互換: camelCaseは後方互換として維持
+    // デフォルト値はgetIncludeHtml()で適用（両形式対応のため）
+    includeHtml: zod_1.z.boolean().optional(),
+    include_preview: zod_1.z.boolean().optional().default(true),
+    preview_max_length: zod_1.z
+        .number()
+        .int({ message: "preview_max_lengthは整数である必要があります" })
+        .min(100, { message: "preview_max_lengthは100以上1000以下である必要があります" })
+        .max(1000, { message: "preview_max_lengthは100以上1000以下である必要があります" })
+        .optional()
+        .default(500),
+    project_context: exports.projectContextOptionsSchema.optional(),
+    // REFTRIX-LAYOUT-02: Auto-detect context from query
+    /**
+     * クエリから業界・スタイルコンテキストを自動推論
+     * 推論結果に基づいて検索結果をブースト
+     * @default true
+     */
+    auto_detect_context: zod_1.z.boolean().optional().default(true),
+    // Phase 4-2: Vision Search Parameters
+    use_vision_search: zod_1.z.boolean().optional().default(false),
+    vision_search_query: exports.visionSearchQuerySchema.optional(),
+    vision_search_options: exports.visionSearchOptionsSchema.optional(),
+    // Multimodal Search Parameters
+    /**
+     * 検索モード
+     * - text_only: text_embeddingのみを使用（デフォルト）
+     * - vision_only: vision_embeddingのみを使用
+     * - combined: 両方を使用してRRF統合
+     * @default 'text_only'
+     */
+    search_mode: exports.searchModeSchema.optional().default("text_only"),
+    /**
+     * マルチモーダルオプション
+     * search_mode='combined'時のRRF統合パラメータ
+     */
+    multimodal_options: exports.multimodalOptionsSchema.optional(),
+    /**
+     * 嗜好プロファイルID（検索結果のリランキングに使用）
+     * Preference profile ID (used for search result reranking)
+     */
+    profile_id: zod_1.z.string().uuid().optional(),
+});
+/**
+ * 検索結果プレビュースキーマ
+ */
+exports.layoutSearchPreviewSchema = zod_1.z.object({
+    heading: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    thumbnail: zod_1.z.string().optional(), // Base64エンコード画像（縮小版）
+});
+/**
+ * 検索結果ソース情報スキーマ
+ */
+exports.layoutSearchSourceSchema = zod_1.z.object({
+    url: zod_1.z.string().url(),
+    type: exports.sourceTypeSchema,
+    usageScope: exports.usageScopeSchema,
+});
+/**
+ * Vision分析結果の特徴スキーマ
+ */
+exports.visionFeatureSchema = zod_1.z.object({
+    type: zod_1.z.string(),
+    confidence: zod_1.z.number().min(0).max(1),
+    description: zod_1.z.string().optional(),
+    data: zod_1.z.unknown().optional(),
+});
+/**
+ * Vision分析結果スキーマ（layout.inspect Vision分析の結果）
+ */
+exports.visionAnalysisSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    features: zod_1.z.array(exports.visionFeatureSchema),
+    textRepresentation: zod_1.z.string().optional(),
+    processingTimeMs: zod_1.z.number().optional(),
+    modelName: zod_1.z.string().optional(),
+    rawResponse: zod_1.z.string().optional(),
+    error: zod_1.z.string().optional(),
+});
+/**
+ * 検索結果アイテムスキーマ（拡張版）
+ */
+exports.layoutSearchResultItemSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    webPageId: zod_1.z.string().uuid(),
+    type: zod_1.z.string(), // sectionType
+    similarity: zod_1.z.number().min(0).max(1),
+    preview: exports.layoutSearchPreviewSchema,
+    source: exports.layoutSearchSourceSchema,
+    html: zod_1.z.string().optional(), // includeHtml=true時のみ
+    // HTMLプレビュー（サニタイズ済み短縮HTML）
+    htmlPreview: zod_1.z.string().optional(), // include_preview=true時のみ（デフォルト）
+    previewLength: zod_1.z.number().int().nonnegative().optional(), // htmlPreviewの元の文字数
+    visionAnalysis: exports.visionAnalysisSchema.optional(), // Vision分析結果
+    // Mood/BrandTone search results (optional, when mood/brandTone filters applied)
+    moodInfo: zod_1.z
+        .object({
+        primary: zod_1.z.string(),
+        secondary: zod_1.z.string().optional(),
+    })
+        .optional(),
+    brandToneInfo: zod_1.z
+        .object({
+        primary: zod_1.z.string(),
+        secondary: zod_1.z.string().optional(),
+    })
+        .optional(),
+    // Project Context Adaptation fields (optional, when project_context.enabled=true)
+    adaptability_score: zod_1.z.number().int().min(0).max(100).optional(), // 0-100
+    integration_hints: exports.integrationHintsSchema.optional(),
+    // REFTRIX-LAYOUT-02: Context boost (auto_detect_context=true時)
+    context_boost: zod_1.z.number().min(0).max(0.15).optional(),
+    // RRF統合検索時の個別結果詳細（combined モード時のみ）
+    rrfDetails: zod_1.z
+        .object({
+        textRank: zod_1.z.number().int().nonnegative(), // テキスト検索でのランク（0=含まれない）
+        visionRank: zod_1.z.number().int().nonnegative(), // Vision検索でのランク（0=含まれない）
+        textScore: zod_1.z.number().min(0).max(1).optional(), // テキスト類似度スコア
+        visionScore: zod_1.z.number().min(0).max(1).optional(), // Vision類似度スコア
+        rrfScore: zod_1.z.number().min(0).optional(), // RRF統合スコア
+    })
+        .optional(),
+});
+/**
+ * 推論されたコンテキストスキーマ（REFTRIX-LAYOUT-02）
+ */
+exports.inferredContextSchema = zod_1.z.object({
+    industry: zod_1.z.string().nullable(),
+    style: zod_1.z.string().nullable(),
+    confidence: zod_1.z.number().min(0).max(1),
+    detected_keywords: zod_1.z.array(zod_1.z.string()),
+});
+// ============================================================================
+// RRF Details Schema
+// ============================================================================
+/**
+ * RRF（Reciprocal Rank Fusion）詳細情報スキーマ
+ *
+ * @property k - RRFのkパラメータ
+ * @property textWeight - text_embeddingの重み
+ * @property visionWeight - vision_embeddingの重み
+ * @property textResultCount - text検索結果数
+ * @property visionResultCount - vision検索結果数
+ * @property fusedResultCount - 統合後の結果数
+ * @property calculationTimeMs - RRF計算時間（ミリ秒）
+ */
+exports.rrfDetailsSchema = zod_1.z.object({
+    k: zod_1.z.number().int().min(1).max(100),
+    textWeight: zod_1.z.number().min(0).max(1),
+    visionWeight: zod_1.z.number().min(0).max(1),
+    textResultCount: zod_1.z.number().int().nonnegative(),
+    visionResultCount: zod_1.z.number().int().nonnegative(),
+    fusedResultCount: zod_1.z.number().int().nonnegative(),
+    calculationTimeMs: zod_1.z.number().nonnegative().optional(),
+});
+/**
+ * layout.search 成功レスポンスデータスキーマ
+ */
+exports.layoutSearchDataSchema = zod_1.z.object({
+    results: zod_1.z.array(exports.layoutSearchResultItemSchema),
+    total: zod_1.z.number().int().nonnegative(),
+    query: zod_1.z.string(),
+    filters: zod_1.z.record(zod_1.z.unknown()).optional(),
+    filtersApplied: zod_1.z.array(zod_1.z.string()).optional(),
+    searchTimeMs: zod_1.z.number().nonnegative().optional(),
+    // REFTRIX-LAYOUT-02: Auto-detected context
+    inferred_context: exports.inferredContextSchema.optional(),
+    context_boost_applied: zod_1.z.boolean().optional(),
+    // Multimodal Search Output Fields
+    /**
+     * 要求された検索モード
+     */
+    searchMode: exports.searchModeSchema.optional(),
+    /**
+     * 実際に使用された検索モード
+     * vision_embeddingがnullの場合、text_onlyにフォールバック
+     */
+    actualSearchMode: exports.searchModeSchema.optional(),
+    /**
+     * 警告メッセージ（Graceful Degradation時など）
+     */
+    warnings: zod_1.z.array(zod_1.z.string()).optional(),
+    /**
+     * RRF統合の詳細情報（search_mode='combined'時のみ）
+     */
+    rrfDetails: exports.rrfDetailsSchema.optional(),
+    /**
+     * フォールバック理由（Graceful Degradation発生時のみ）
+     */
+    fallbackReason: zod_1.z.string().optional(),
+});
+/**
+ * layout.search エラー情報スキーマ
+ */
+exports.layoutSearchErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+});
+/**
+ * layout.search 成功レスポンススキーマ
+ */
+exports.layoutSearchSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.layoutSearchDataSchema,
+});
+/**
+ * layout.search 失敗レスポンススキーマ
+ */
+exports.layoutSearchErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.layoutSearchErrorInfoSchema,
+});
+/**
+ * layout.search 出力スキーマ（統合）
+ */
+exports.layoutSearchOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.layoutSearchSuccessOutputSchema,
+    exports.layoutSearchErrorOutputSchema,
+]);
+// ============================================================================
+// layout.generate_code Schemas
+// ============================================================================
+/**
+ * layout.generate_code オプションスキーマ
+ *
+ * @property framework - フレームワーク（react/vue/html、デフォルトreact）
+ * @property typescript - TypeScript出力（デフォルトtrue）
+ * @property tailwind - Tailwind使用（デフォルトtrue）
+ * @property paletteId - ブランドパレットID（オプション）
+ * @property componentName - コンポーネント名（PascalCase形式、オプション）
+ * @property splitComponents - HTMLを意味のあるサブコンポーネントに分割するか（デフォルトfalse）
+ */
+exports.layoutToCodeOptionsSchema = zod_1.z.object({
+    framework: exports.frameworkSchema.optional().default("react"),
+    typescript: zod_1.z.boolean().optional().default(true),
+    tailwind: zod_1.z.boolean().optional().default(true),
+    paletteId: zod_1.z.string().uuid({ message: "有効なUUID形式のpaletteIdを指定してください" }).optional(),
+    componentName: zod_1.z
+        .string()
+        .min(1, { message: "コンポーネント名は1文字以上必要です" })
+        .regex(/^[A-Z][a-zA-Z0-9]*$/, {
+        message: "コンポーネント名はPascalCase形式である必要があります",
+    })
+        .optional(),
+    splitComponents: zod_1.z.boolean().optional().default(false),
+    /**
+     * レスポンシブブレークポイント自動生成
+     * 大きなサイズのwidth/padding/font-size/flex-directionを
+     * モバイルファーストのレスポンシブクラスに変換します
+     * @default true
+     */
+    responsive: zod_1.z.boolean().optional().default(true),
+});
+/**
+ * layout.generate_code 入力スキーマ
+ *
+ * @property patternId - パターンID（UUID形式、必須）
+ * @property options - オプション設定（オプション）
+ */
+exports.layoutToCodeInputSchema = zod_1.z.object({
+    patternId: zod_1.z.string().uuid({ message: "有効なUUID形式のpatternIdを指定してください" }),
+    options: exports.layoutToCodeOptionsSchema.optional(),
+});
+/**
+ * layout.generate_code データスキーマ
+ */
+exports.layoutToCodeDataSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    framework: exports.frameworkSchema,
+    componentName: zod_1.z.string(),
+    filename: zod_1.z.string(),
+    dependencies: zod_1.z.array(zod_1.z.string()).optional(),
+    inspirationUrls: zod_1.z.array(zod_1.z.string().url()).optional(),
+    usageScope: exports.usageScopeSchema,
+});
+/**
+ * layout.generate_code エラー情報スキーマ
+ */
+exports.layoutToCodeErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * layout.generate_code 成功レスポンススキーマ
+ */
+exports.layoutToCodeSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.layoutToCodeDataSchema,
+});
+/**
+ * layout.generate_code 失敗レスポンススキーマ
+ */
+exports.layoutToCodeErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.layoutToCodeErrorInfoSchema,
+});
+/**
+ * layout.generate_code 出力スキーマ（統合）
+ */
+exports.layoutToCodeOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.layoutToCodeSuccessOutputSchema,
+    exports.layoutToCodeErrorOutputSchema,
+]);
+/**
+ * @deprecated Use layoutToCodeDataSchema instead
+ * 後方互換性のため残す（テスト移行後に削除）
+ */
+exports.layoutToCodeLegacyOutputSchema = exports.layoutToCodeDataSchema;
+// ============================================================================
+// layout.patterns Schemas (pattern listing, not a registered MCP tool)
+// ============================================================================
+/**
+ * layout patterns 入力スキーマ（パターン一覧取得用）
+ *
+ * @property sectionType - セクションタイプフィルター（オプション）
+ * @property limit - 取得件数（1-100、デフォルト20）
+ * @property offset - オフセット（0以上、デフォルト0）
+ * @property sortBy - ソート対象（createdAt/usageCount/quality、デフォルトcreatedAt）
+ * @property sortOrder - ソート順序（asc/desc、デフォルトdesc）
+ */
+exports.layoutPatternsInputSchema = zod_1.z.object({
+    sectionType: exports.sectionTypeForSearchSchema.optional(),
+    limit: zod_1.z
+        .number()
+        .int({ message: "limitは整数である必要があります" })
+        .min(1, { message: "limitは1以上100以下である必要があります" })
+        .max(100, { message: "limitは1以上100以下である必要があります" })
+        .optional()
+        .default(20),
+    offset: zod_1.z
+        .number()
+        .int({ message: "offsetは整数である必要があります" })
+        .min(0, { message: "offsetは0以上である必要があります" })
+        .optional()
+        .default(0),
+    sortBy: exports.sortBySchema.optional().default("createdAt"),
+    sortOrder: exports.sortOrderSchema.optional().default("desc"),
+});
+/**
+ * パターンアイテムスキーマ
+ */
+exports.layoutPatternItemSchema = zod_1.z.object({
+    id: zod_1.z.string().uuid(),
+    sectionType: zod_1.z.string(),
+    name: zod_1.z.string(),
+    previewUrl: zod_1.z.string().url().optional(),
+    usageCount: zod_1.z.number().int().nonnegative(),
+    quality: zod_1.z.number().min(0).max(1),
+    createdAt: zod_1.z.string().datetime(),
+});
+/**
+ * layout patterns 出力スキーマ（パターン一覧取得用）
+ */
+exports.layoutPatternsOutputSchema = zod_1.z.object({
+    patterns: zod_1.z.array(exports.layoutPatternItemSchema),
+    total: zod_1.z.number().int().nonnegative(),
+    limit: zod_1.z.number().int().positive(),
+    offset: zod_1.z.number().int().nonnegative(),
+});
+// ============================================================================
+// layout.batch_ingest Schemas
+// ============================================================================
+/**
+ * layout.batch_ingest オプションスキーマ
+ *
+ * @property concurrency - 並列処理数（1-10、デフォルト5）
+ * @property on_error - エラー時の動作（skip/abort、デフォルトskip）
+ * @property save_to_db - DBに保存するか（デフォルトtrue）
+ * @property auto_analyze - 自動解析するか（デフォルトtrue）
+ */
+exports.layoutBatchIngestOptionsSchema = zod_1.z.object({
+    concurrency: zod_1.z
+        .number()
+        .int({ message: "concurrencyは整数である必要があります" })
+        .min(1, { message: "concurrencyは1以上10以下である必要があります" })
+        .max(10, { message: "concurrencyは1以上10以下である必要があります" })
+        .optional()
+        .default(5),
+    on_error: zod_1.z.enum(["skip", "abort"]).optional().default("skip"),
+    save_to_db: zod_1.z.boolean().optional().default(true),
+    auto_analyze: zod_1.z.boolean().optional().default(true),
+});
+/**
+ * layout.batch_ingest 入力スキーマ
+ *
+ * @property urls - インジェスト対象のURL配列（1-100件、必須）
+ * @property options - オプション設定（オプション）
+ */
+exports.layoutBatchIngestInputSchema = zod_1.z.object({
+    urls: zod_1.z
+        .array(zod_1.z.string().url({ message: "有効なURL形式を指定してください" }))
+        .min(1, { message: "URLは1件以上100件以下で指定してください" })
+        .max(100, { message: "URLは1件以上100件以下で指定してください" }),
+    options: exports.layoutBatchIngestOptionsSchema.optional(),
+    /** robots.txtを尊重するかどうか（RFC 9309）。falseで無視 */
+    respect_robots_txt: zod_1.z.boolean().optional(),
+});
+/**
+ * バッチインジェスト結果アイテムスキーマ
+ */
+exports.batchIngestResultItemSchema = zod_1.z.object({
+    url: zod_1.z.string().url(),
+    status: zod_1.z.enum(["success", "failed"]),
+    page_id: zod_1.z.string().uuid().optional(),
+    error: zod_1.z.string().optional(),
+    patterns_extracted: zod_1.z.number().int().nonnegative().optional(),
+});
+/**
+ * バッチインジェストサマリースキーマ
+ */
+exports.batchIngestSummarySchema = zod_1.z.object({
+    success_rate: zod_1.z.number().min(0).max(100),
+    total_patterns: zod_1.z.number().int().nonnegative(),
+    processing_time_ms: zod_1.z.number().nonnegative(),
+});
+/**
+ * layout.batch_ingest 成功レスポンスデータスキーマ
+ */
+exports.layoutBatchIngestDataSchema = zod_1.z.object({
+    job_id: zod_1.z.string().uuid(),
+    total: zod_1.z.number().int().nonnegative(),
+    completed: zod_1.z.number().int().nonnegative(),
+    failed: zod_1.z.number().int().nonnegative(),
+    results: zod_1.z.array(exports.batchIngestResultItemSchema),
+    summary: exports.batchIngestSummarySchema,
+});
+/**
+ * layout.batch_ingest エラー情報スキーマ
+ */
+exports.layoutBatchIngestErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * layout.batch_ingest 成功レスポンススキーマ
+ */
+exports.layoutBatchIngestSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.layoutBatchIngestDataSchema,
+});
+/**
+ * layout.batch_ingest 失敗レスポンススキーマ
+ */
+exports.layoutBatchIngestErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.layoutBatchIngestErrorInfoSchema,
+});
+/**
+ * layout.batch_ingest 出力スキーマ（統合）
+ */
+exports.layoutBatchIngestOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.layoutBatchIngestSuccessOutputSchema,
+    exports.layoutBatchIngestErrorOutputSchema,
+]);
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * layout.* ツール用エラーコード
+ */
+exports.LAYOUT_MCP_ERROR_CODES = {
+    /** レイアウトが見つからない */
+    LAYOUT_NOT_FOUND: "LAYOUT_NOT_FOUND",
+    /** インジェスト失敗 */
+    INGEST_FAILED: "INGEST_FAILED",
+    /** 検査失敗 */
+    INSPECT_FAILED: "INSPECT_FAILED",
+    /** 検索失敗 */
+    SEARCH_FAILED: "SEARCH_FAILED",
+    /** コード生成失敗 */
+    CODE_GENERATION_FAILED: "CODE_GENERATION_FAILED",
+    /** バリデーションエラー */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** タイムアウト */
+    TIMEOUT: "TIMEOUT",
+    /** HTMLサイズ超過 */
+    HTML_TOO_LARGE: "HTML_TOO_LARGE",
+    /** パターンが見つからない */
+    PATTERN_NOT_FOUND: "PATTERN_NOT_FOUND",
+    /** SSRF対策によりブロック */
+    SSRF_BLOCKED: "SSRF_BLOCKED",
+    /** タイムアウトエラー */
+    TIMEOUT_ERROR: "TIMEOUT_ERROR",
+    /** ネットワークエラー */
+    NETWORK_ERROR: "NETWORK_ERROR",
+    /** ブラウザエラー */
+    BROWSER_ERROR: "BROWSER_ERROR",
+    /** 内部エラー */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    /** HTTPエラー */
+    HTTP_ERROR: "HTTP_ERROR",
+    /** DB保存失敗 */
+    DB_SAVE_FAILED: "DB_SAVE_FAILED",
+    /** バッチ処理中止 */
+    BATCH_ABORTED: "BATCH_ABORTED",
+};
+// ============================================================================
+// MCP Tool Definitions
+// ============================================================================
+/**
+ * MCP Tool definitions for layout.* tools
+ * MCPプロトコル準拠のツール定義
+ */
+exports.layoutMcpTools = {
+    "layout.ingest": {
+        name: "layout.ingest",
+        description: "URLからWebページを取得し、レイアウト解析用データを準備します",
+        inputSchema: exports.layoutIngestInputSchema,
+    },
+    "layout.inspect": {
+        name: "layout.inspect",
+        description: "HTMLを解析し、セクション・グリッド・タイポグラフィを抽出します",
+        inputSchema: exports.layoutInspectInputSchema,
+    },
+    "layout.search": {
+        name: "layout.search",
+        description: "レイアウトパターンをセマンティック検索します",
+        inputSchema: exports.layoutSearchInputSchema,
+    },
+    "layout.generate_code": {
+        name: "layout.generate_code",
+        description: "パターンからReact/Vue/HTMLコードを生成します",
+        inputSchema: exports.layoutToCodeInputSchema,
+    },
+    "layout.batch_ingest": {
+        name: "layout.batch_ingest",
+        description: "複数URLを一括取得しレイアウト解析用データを準備します",
+        inputSchema: exports.layoutBatchIngestInputSchema,
+    },
+};
+//# sourceMappingURL=schemas.js.map