@reftrixmcp/mcp-server 0.1.7

package/dist/tools/narrative/schemas.js

@@ -0,0 +1,747 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pageAnalyzeNarrativeOptionsSchema = exports.narrativeMcpTools = exports.NARRATIVE_MCP_ERROR_CODES = exports.narrativeSearchOutputSchema = exports.narrativeSearchErrorOutputSchema = exports.narrativeSearchSuccessOutputSchema = exports.narrativeSearchErrorInfoSchema = exports.narrativeSearchDataSchema = exports.narrativeSearchInfoSchema = exports.narrativeSearchResultItemSchema = exports.layoutStructureSummarySchema = exports.worldViewSummarySchema = exports.narrativeSearchInputSchema = exports.narrativeSearchOptionsSchema = exports.narrativeSearchFiltersSchema = exports.narrativeAnalyzeOutputSchema = exports.narrativeAnalyzeErrorOutputSchema = exports.narrativeAnalyzeSuccessOutputSchema = exports.narrativeAnalyzeErrorInfoSchema = exports.narrativeAnalyzeWarningSchema = exports.narrativeAnalyzeDataSchema = exports.confidenceScoreSchema = exports.confidenceBreakdownSchema = exports.layoutStructureSchema = exports.graphicElementsSchema = exports.visualBalanceSchema = exports.decorationsSchema = exports.imageLayoutSchema = exports.sectionRelationshipSchema = exports.spacingRhythmSchema = exports.sectionGapsSchema = exports.visualHierarchySchema = exports.weightDistributionSchema = exports.gridSystemSchema = exports.breakpointsSchema = exports.worldViewSchema = exports.overallToneSchema = exports.motionEmotionSchema = exports.typographyPersonalitySchema = exports.colorImpressionSchema = exports.narrativeAnalyzeInputSchema = exports.narrativeAnalyzeOptionsSchema = exports.narrativeSearchModeSchema = exports.sectionFlowSchema = exports.gridTypeSchema = exports.colorHarmonySchema = exports.moodCategorySchema = void 0;
+/**
+ * narrative.* MCP Tools Zod Schema Definitions
+ * Webデザインの世界観・レイアウト構成分析ツールの入力/出力バリデーションスキーマ
+ *
+ * @module @reftrixmcp/mcp-server/tools/narrative/schemas
+ *
+ * 対応ツール:
+ * - narrative.analyze: URLまたはHTMLから世界観・レイアウト構成を分析
+ * - narrative.search: 世界観・レイアウト構成でセマンティック検索
+ *
+ * 分析対象:
+ * - WorldView: 世界観・雰囲気（moodCategory, colorImpression, typographyPersonality等）
+ * - LayoutStructure: レイアウト構成（gridSystem, visualHierarchy, spacingRhythm等）
+ */
+const zod_1 = require("zod");
+// ============================================================================
+// Enum Schemas
+// ============================================================================
+/**
+ * ムードカテゴリ
+ * Webデザインの全体的な雰囲気を分類
+ *
+ * @see services/narrative/types/narrative.types.ts
+ */
+exports.moodCategorySchema = zod_1.z.enum([
+    "professional", // ビジネス、企業
+    "playful", // 遊び心、カジュアル
+    "premium", // 高級、ラグジュアリー
+    "tech", // テクノロジー、先進的
+    "organic", // 自然、オーガニック
+    "minimal", // ミニマル、シンプル
+    "bold", // 大胆、インパクト
+    "elegant", // 上品、洗練
+    "friendly", // 親しみやすい
+    "artistic", // アート、クリエイティブ
+    "trustworthy", // 信頼、安心
+    "energetic", // エネルギッシュ、活発
+]);
+/**
+ * 色彩調和タイプ
+ */
+exports.colorHarmonySchema = zod_1.z.enum([
+    "complementary", // 補色
+    "analogous", // 類似色
+    "monochromatic", // モノクロマティック
+    "triadic", // トライアド
+    "split-complementary", // スプリットコンプリメンタリー
+    "mixed", // 混合
+]);
+/**
+ * グリッドタイプ
+ */
+exports.gridTypeSchema = zod_1.z.enum([
+    "css-grid", // CSS Grid
+    "flexbox", // Flexbox
+    "float", // Float
+    "mixed", // 混合
+    "none", // なし
+]);
+/**
+ * セクション配置パターン
+ */
+exports.sectionFlowSchema = zod_1.z.enum([
+    "linear", // 線形
+    "modular", // モジュラー
+    "asymmetric", // 非対称
+]);
+/**
+ * 検索モード
+ */
+exports.narrativeSearchModeSchema = zod_1.z.enum([
+    "vector", // Vectorのみ
+    "hybrid", // Vector + Full-text（RRF統合）
+]);
+// ============================================================================
+// narrative.analyze Input Schemas
+// ============================================================================
+/**
+ * narrative.analyze オプションスキーマ
+ *
+ * @property saveToDb - DB保存（デフォルトtrue）
+ * @property includeVision - Vision LLM分析を使用（デフォルトtrue）
+ * @property cssVariables - 既存CSS変数分析結果（オプション）
+ * @property motionPatterns - 既存モーション分析結果（オプション）
+ * @property timeout - タイムアウト（デフォルト60000ms）
+ */
+exports.narrativeAnalyzeOptionsSchema = zod_1.z.object({
+    /** DB保存（デフォルトtrue） */
+    save_to_db: zod_1.z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("分析結果をDBに保存するか（デフォルト: true）"),
+    /** Vision LLM分析を使用（デフォルトtrue） */
+    include_vision: zod_1.z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Vision LLM分析を使用するか。falseの場合はCSS静的分析のみ（デフォルト: true）"),
+    /** 既存CSS変数分析結果（オプション、page.analyzeから再利用） */
+    css_variables: zod_1.z
+        .record(zod_1.z.string(), zod_1.z.string())
+        .optional()
+        .describe("既存CSS変数分析結果（page.analyzeからの再利用）"),
+    /** 既存モーション分析結果（オプション、page.analyzeから再利用） */
+    motion_patterns: zod_1.z
+        .array(zod_1.z.object({
+        type: zod_1.z.string(),
+        category: zod_1.z.string().optional(),
+        properties: zod_1.z.array(zod_1.z.string()).optional(),
+        duration: zod_1.z.number().optional(),
+        easing: zod_1.z.string().optional(),
+    }))
+        .optional()
+        .describe("既存モーション分析結果（page.analyzeからの再利用）"),
+    /** タイムアウト（ms） */
+    timeout: zod_1.z
+        .number()
+        .int({ message: "timeoutは整数である必要があります" })
+        .min(5000, { message: "timeoutは5000以上120000以下である必要があります" })
+        .max(120000, { message: "timeoutは5000以上120000以下である必要があります" })
+        .optional()
+        .default(60000)
+        .describe("分析タイムアウト（ms）（デフォルト: 60000）"),
+});
+/**
+ * narrative.analyze 入力スキーマ
+ *
+ * urlまたはhtmlのいずれか一方のみ指定可能
+ *
+ * @property url - 分析対象URL（urlまたはhtmlのいずれか必須）
+ * @property html - HTMLコンテンツ（urlまたはhtmlのいずれか必須）
+ * @property screenshot - スクリーンショット（Base64、urlなしの場合必須）
+ * @property options - オプション
+ */
+exports.narrativeAnalyzeInputSchema = zod_1.z
+    .object({
+    /** 分析対象URL */
+    url: zod_1.z
+        .string()
+        .url({ message: "有効なURL形式を指定してください" })
+        .optional()
+        .describe("分析対象URL（urlまたはhtmlのいずれか必須）"),
+    /** HTMLコンテンツ（最大10MB） */
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional()
+        .describe("分析対象HTML（urlまたはhtmlのいずれか必須）"),
+    /** スクリーンショット（Base64エンコード） */
+    screenshot: zod_1.z
+        .string()
+        .min(1, { message: "スクリーンショットは空文字列にできません" })
+        .optional()
+        .describe("Base64エンコードスクリーンショット（urlなし + include_vision時に必須）"),
+    /** オプション */
+    options: exports.narrativeAnalyzeOptionsSchema.optional(),
+})
+    .refine((data) => {
+    const hasUrl = data.url !== undefined;
+    const hasHtml = data.html !== undefined;
+    // urlまたはhtmlのいずれか一方が必須
+    return hasUrl || hasHtml;
+}, {
+    message: "urlまたはhtmlのいずれかを指定してください",
+})
+    .refine((data) => {
+    const hasUrl = data.url !== undefined;
+    const hasHtml = data.html !== undefined;
+    // 両方同時に指定は不可
+    return !(hasUrl && hasHtml);
+}, {
+    message: "urlとhtmlを同時に指定することはできません",
+})
+    .refine((data) => {
+    // html指定 + include_vision = true の場合、screenshotが必須
+    const hasUrl = data.url !== undefined;
+    const includeVision = data.options?.include_vision !== false; // デフォルトtrue
+    const hasScreenshot = data.screenshot !== undefined;
+    if (!hasUrl && includeVision) {
+        return hasScreenshot;
+    }
+    return true;
+}, {
+    message: "html指定時にVision分析を使用する場合はscreenshotが必須です",
+    path: ["screenshot"],
+});
+// ============================================================================
+// narrative.analyze Output Schemas
+// ============================================================================
+/**
+ * 色彩印象スキーマ
+ */
+exports.colorImpressionSchema = zod_1.z.object({
+    /** 全体的な印象 */
+    overall: zod_1.z.string().describe('全体的な色彩印象（例: "warm and inviting"）'),
+    /** 支配的な感情 */
+    dominantEmotion: zod_1.z.string().describe('支配的な感情（例: "trust", "excitement"）'),
+    /** 配色調和タイプ */
+    harmony: exports.colorHarmonySchema,
+});
+/**
+ * タイポグラフィの性格スキーマ
+ */
+exports.typographyPersonalitySchema = zod_1.z.object({
+    /** スタイル */
+    style: zod_1.z.string().describe('タイポグラフィスタイル（例: "modern", "classic"）'),
+    /** 読みやすさ */
+    readability: zod_1.z.enum(["high", "medium", "low"]),
+    /** 階層の明確さ */
+    hierarchy: zod_1.z.enum(["clear", "subtle", "flat"]),
+});
+/**
+ * モーションの感情スキーマ
+ */
+exports.motionEmotionSchema = zod_1.z.object({
+    /** 全体的な印象 */
+    overall: zod_1.z.string().describe('モーションの全体印象（例: "smooth and elegant"）'),
+    /** ペース */
+    pace: zod_1.z.enum(["slow", "moderate", "fast"]),
+    /** 強度（0-1） */
+    intensity: zod_1.z.number().min(0).max(1),
+    /** prefers-reduced-motion対応 */
+    accessibility: zod_1.z.boolean(),
+});
+/**
+ * 全体的なトーンスキーマ
+ */
+exports.overallToneSchema = zod_1.z.object({
+    /** プライマリートーン */
+    primary: zod_1.z.string().describe('プライマリートーン（例: "professional"）'),
+    /** フォーマル度（0-1） */
+    formality: zod_1.z.number().min(0).max(1),
+    /** エネルギー度（0-1） */
+    energy: zod_1.z.number().min(0).max(1),
+});
+/**
+ * 世界観・雰囲気スキーマ
+ */
+exports.worldViewSchema = zod_1.z.object({
+    /** ムードカテゴリ */
+    moodCategory: exports.moodCategorySchema,
+    /** セカンダリームードカテゴリ（オプション） */
+    secondaryMoodCategory: exports.moodCategorySchema.optional(),
+    /** ムードの説明 */
+    moodDescription: zod_1.z.string().describe("ムードの自然言語説明"),
+    /** 色彩印象 */
+    colorImpression: exports.colorImpressionSchema,
+    /** タイポグラフィの性格 */
+    typographyPersonality: exports.typographyPersonalitySchema,
+    /** モーションの感情（モーションがある場合） */
+    motionEmotion: exports.motionEmotionSchema.optional(),
+    /** 全体的なトーン */
+    overallTone: exports.overallToneSchema,
+});
+/**
+ * ブレークポイントスキーマ
+ */
+exports.breakpointsSchema = zod_1.z.object({
+    mobile: zod_1.z.string().optional(),
+    tablet: zod_1.z.string().optional(),
+    desktop: zod_1.z.string().optional(),
+    wide: zod_1.z.string().optional(),
+});
+/**
+ * グリッドシステムスキーマ
+ */
+exports.gridSystemSchema = zod_1.z.object({
+    /** グリッドタイプ */
+    type: exports.gridTypeSchema,
+    /** カラム数（'fluid'も許容） */
+    columns: zod_1.z.union([zod_1.z.number().int().positive(), zod_1.z.literal("fluid")]),
+    /** ガター幅 */
+    gutterWidth: zod_1.z.string().optional(),
+    /** コンテナ幅 */
+    containerWidth: zod_1.z.string().optional(),
+    /** ブレークポイント */
+    breakpoints: exports.breakpointsSchema.optional(),
+});
+/**
+ * 視覚的重み分布スキーマ
+ */
+exports.weightDistributionSchema = zod_1.z.object({
+    top: zod_1.z.number().min(0).max(1),
+    middle: zod_1.z.number().min(0).max(1),
+    bottom: zod_1.z.number().min(0).max(1),
+});
+/**
+ * 視覚的階層スキーマ
+ */
+exports.visualHierarchySchema = zod_1.z.object({
+    /** 主要要素 */
+    primaryElements: zod_1.z.array(zod_1.z.string()),
+    /** 二次要素 */
+    secondaryElements: zod_1.z.array(zod_1.z.string()),
+    /** 三次要素 */
+    tertiaryElements: zod_1.z.array(zod_1.z.string()),
+    /** セクション配置パターン */
+    sectionFlow: exports.sectionFlowSchema,
+    /** 視覚的重み分布 */
+    weightDistribution: exports.weightDistributionSchema,
+});
+/**
+ * セクション間スペーシングスキーマ
+ */
+exports.sectionGapsSchema = zod_1.z.object({
+    min: zod_1.z.string(),
+    max: zod_1.z.string(),
+    average: zod_1.z.string(),
+});
+/**
+ * スペーシングリズムスキーマ
+ */
+exports.spacingRhythmSchema = zod_1.z.object({
+    /** 基準単位 */
+    baseUnit: zod_1.z.string(),
+    /** スケール倍率 */
+    scale: zod_1.z.array(zod_1.z.number()),
+    /** スケール名 */
+    scaleName: zod_1.z.enum(["fibonacci", "linear", "geometric", "custom"]).optional(),
+    /** セクション間スペーシング */
+    sectionGaps: exports.sectionGapsSchema,
+});
+/**
+ * セクション間関係性スキーマ
+ */
+exports.sectionRelationshipSchema = zod_1.z.object({
+    /** ソースセクションID */
+    sourceId: zod_1.z.string(),
+    /** ターゲットセクションID */
+    targetId: zod_1.z.string(),
+    /** 関係タイプ */
+    relationshipType: zod_1.z.enum(["follows", "contains", "parallels", "contrasts"]),
+    /** 関係の強さ（0-1） */
+    strength: zod_1.z.number().min(0).max(1),
+});
+/**
+ * 画像配置パターンスキーマ
+ */
+exports.imageLayoutSchema = zod_1.z.object({
+    /** パターン */
+    pattern: zod_1.z.enum(["full-bleed", "contained", "scattered", "grid", "none"]),
+    /** アスペクト比 */
+    aspectRatios: zod_1.z.array(zod_1.z.string()),
+    /** 配置位置 */
+    positions: zod_1.z.array(zod_1.z.enum(["hero", "inline", "background", "decorative"])),
+});
+/**
+ * 装飾要素スキーマ
+ */
+exports.decorationsSchema = zod_1.z.object({
+    hasGradients: zod_1.z.boolean(),
+    hasShadows: zod_1.z.boolean(),
+    hasBorders: zod_1.z.boolean(),
+    hasIllustrations: zod_1.z.boolean(),
+});
+/**
+ * 視覚的バランススキーマ
+ */
+exports.visualBalanceSchema = zod_1.z.object({
+    /** 対称性 */
+    symmetry: zod_1.z.enum(["symmetric", "asymmetric", "dynamic"]),
+    /** 密度 */
+    density: zod_1.z.enum(["sparse", "balanced", "dense"]),
+    /** ホワイトスペース比率（0-1） */
+    whitespace: zod_1.z.number().min(0).max(1),
+});
+/**
+ * グラフィック要素スキーマ
+ */
+exports.graphicElementsSchema = zod_1.z.object({
+    /** 画像配置パターン */
+    imageLayout: exports.imageLayoutSchema,
+    /** 装飾要素 */
+    decorations: exports.decorationsSchema,
+    /** 視覚的バランス */
+    visualBalance: exports.visualBalanceSchema,
+});
+/**
+ * レイアウト構成スキーマ
+ */
+exports.layoutStructureSchema = zod_1.z.object({
+    /** グリッドシステム */
+    gridSystem: exports.gridSystemSchema,
+    /** 視覚的階層 */
+    visualHierarchy: exports.visualHierarchySchema,
+    /** スペーシングリズム */
+    spacingRhythm: exports.spacingRhythmSchema,
+    /** セクション間関係性 */
+    sectionRelationships: zod_1.z.array(exports.sectionRelationshipSchema),
+    /** グラフィック要素 */
+    graphicElements: exports.graphicElementsSchema,
+});
+/**
+ * 信頼度内訳スキーマ
+ */
+exports.confidenceBreakdownSchema = zod_1.z.object({
+    /** Vision LLM分析信頼度 */
+    visionAnalysis: zod_1.z.number().min(0).max(1),
+    /** CSS静的分析信頼度 */
+    cssStaticAnalysis: zod_1.z.number().min(0).max(1),
+    /** HTML構造分析信頼度 */
+    htmlStructureAnalysis: zod_1.z.number().min(0).max(1),
+    /** モーション分析信頼度 */
+    motionAnalysis: zod_1.z.number().min(0).max(1),
+});
+/**
+ * 信頼度スキーマ
+ */
+exports.confidenceScoreSchema = zod_1.z.object({
+    /** 総合信頼度 */
+    overall: zod_1.z.number().min(0).max(1),
+    /** 世界観分析信頼度 */
+    worldView: zod_1.z.number().min(0).max(1),
+    /** レイアウト分析信頼度 */
+    layoutStructure: zod_1.z.number().min(0).max(1),
+    /** 詳細内訳 */
+    breakdown: exports.confidenceBreakdownSchema,
+});
+/**
+ * narrative.analyze 成功レスポンスデータスキーマ
+ */
+exports.narrativeAnalyzeDataSchema = zod_1.z.object({
+    /** DB保存時のID（save_to_db: true時のみ） */
+    id: zod_1.z.string().uuid().optional(),
+    /** 関連WebPageのID（存在する場合） */
+    webPageId: zod_1.z.string().uuid().optional(),
+    // 世界観・雰囲気
+    /** 世界観 */
+    worldView: exports.worldViewSchema,
+    // レイアウト構成
+    /** レイアウト構成 */
+    layoutStructure: exports.layoutStructureSchema,
+    // メタデータ
+    /** 信頼度 */
+    confidence: exports.confidenceScoreSchema,
+    /** 分析日時 */
+    analyzedAt: zod_1.z.string().datetime(),
+    /** 分析所要時間（ms） */
+    analysisTimeMs: zod_1.z.number().nonnegative().optional(),
+    /** Vision分析が使用されたか */
+    visionUsed: zod_1.z.boolean().optional(),
+    /** フォールバック理由（Vision未使用時） */
+    fallbackReason: zod_1.z.string().optional(),
+    /** 分析器バージョン */
+    analyzerVersion: zod_1.z.string().optional(),
+});
+/**
+ * narrative.analyze 警告スキーマ
+ */
+exports.narrativeAnalyzeWarningSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+});
+/**
+ * narrative.analyze エラー情報スキーマ
+ */
+exports.narrativeAnalyzeErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * narrative.analyze 成功レスポンススキーマ
+ */
+exports.narrativeAnalyzeSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.narrativeAnalyzeDataSchema,
+    warnings: zod_1.z.array(exports.narrativeAnalyzeWarningSchema).optional(),
+});
+/**
+ * narrative.analyze 失敗レスポンススキーマ
+ */
+exports.narrativeAnalyzeErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.narrativeAnalyzeErrorInfoSchema,
+});
+/**
+ * narrative.analyze 出力スキーマ（統合）
+ */
+exports.narrativeAnalyzeOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.narrativeAnalyzeSuccessOutputSchema,
+    exports.narrativeAnalyzeErrorOutputSchema,
+]);
+// ============================================================================
+// narrative.search Input Schemas
+// ============================================================================
+/**
+ * narrative.search フィルタースキーマ
+ */
+exports.narrativeSearchFiltersSchema = zod_1.z.object({
+    /** ムードカテゴリでフィルター */
+    moodCategory: exports.moodCategorySchema.optional(),
+    /** 最小信頼度 */
+    minConfidence: zod_1.z
+        .number()
+        .min(0, { message: "minConfidenceは0以上1以下である必要があります" })
+        .max(1, { message: "minConfidenceは0以上1以下である必要があります" })
+        .optional()
+        .describe("最小信頼度フィルター（0-1）"),
+});
+/**
+ * narrative.search オプションスキーマ
+ */
+exports.narrativeSearchOptionsSchema = zod_1.z.object({
+    /** 結果数（デフォルト10） */
+    limit: zod_1.z
+        .number()
+        .int({ message: "limitは整数である必要があります" })
+        .min(1, { message: "limitは1以上50以下である必要があります" })
+        .max(50, { message: "limitは1以上50以下である必要があります" })
+        .optional()
+        .default(10),
+    /** 最小類似度（デフォルト0.6） */
+    minSimilarity: zod_1.z
+        .number()
+        .min(0, { message: "minSimilarityは0以上1以下である必要があります" })
+        .max(1, { message: "minSimilarityは0以上1以下である必要があります" })
+        .optional()
+        .default(0.6),
+    /** 検索モード（デフォルトhybrid） */
+    searchMode: exports.narrativeSearchModeSchema.optional().default("hybrid"),
+    /** Vector検索の重み（hybridモード時、デフォルト0.6） */
+    vectorWeight: zod_1.z
+        .number()
+        .min(0, { message: "vectorWeightは0以上1以下である必要があります" })
+        .max(1, { message: "vectorWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.6),
+    /** Full-text検索の重み（hybridモード時、デフォルト0.4） */
+    fulltextWeight: zod_1.z
+        .number()
+        .min(0, { message: "fulltextWeightは0以上1以下である必要があります" })
+        .max(1, { message: "fulltextWeightは0以上1以下である必要があります" })
+        .optional()
+        .default(0.4),
+});
+/**
+ * narrative.search 入力スキーマ
+ *
+ * queryまたはembeddingのいずれか一方のみ指定可能
+ */
+exports.narrativeSearchInputSchema = zod_1.z
+    .object({
+    /** 自然言語クエリ */
+    query: zod_1.z
+        .string()
+        .min(1, { message: "クエリは1文字以上必要です" })
+        .max(500, { message: "クエリは500文字以下にしてください" })
+        .optional()
+        .describe('検索クエリ（例: "サイバーセキュリティ感のあるダークなデザイン"）'),
+    /** 直接Embedding指定（768次元） */
+    embedding: zod_1.z
+        .array(zod_1.z.number())
+        .length(768, { message: "embeddingは768次元である必要があります" })
+        .optional()
+        .describe("直接Embedding指定（768次元）"),
+    /** フィルター */
+    filters: exports.narrativeSearchFiltersSchema.optional(),
+    /** オプション */
+    options: exports.narrativeSearchOptionsSchema.optional(),
+    /**
+     * 嗜好プロファイルID（検索結果のリランキングに使用）
+     * Preference profile ID (used for search result reranking)
+     */
+    profile_id: zod_1.z.string().uuid().optional(),
+})
+    .refine((data) => {
+    const hasQuery = data.query !== undefined;
+    const hasEmbedding = data.embedding !== undefined;
+    // queryまたはembeddingのいずれか一方が必須
+    return hasQuery || hasEmbedding;
+}, {
+    message: "queryまたはembeddingのいずれかを指定してください",
+})
+    .refine((data) => {
+    const hasQuery = data.query !== undefined;
+    const hasEmbedding = data.embedding !== undefined;
+    // 両方同時に指定は不可
+    return !(hasQuery && hasEmbedding);
+}, {
+    message: "queryとembeddingを同時に指定することはできません",
+});
+// ============================================================================
+// narrative.search Output Schemas
+// ============================================================================
+/**
+ * 検索結果の世界観サマリースキーマ
+ */
+exports.worldViewSummarySchema = zod_1.z.object({
+    moodCategory: exports.moodCategorySchema,
+    moodDescription: zod_1.z.string(),
+    overallTone: zod_1.z.string(),
+});
+/**
+ * 検索結果のレイアウトサマリースキーマ
+ */
+exports.layoutStructureSummarySchema = zod_1.z.object({
+    gridType: exports.gridTypeSchema,
+    columns: zod_1.z.union([zod_1.z.number().int().positive(), zod_1.z.literal("fluid")]),
+});
+/**
+ * 検索結果アイテムスキーマ
+ */
+exports.narrativeSearchResultItemSchema = zod_1.z.object({
+    /** DesignNarrative ID */
+    id: zod_1.z.string().uuid(),
+    /** WebPage ID */
+    webPageId: zod_1.z.string().uuid(),
+    /** ソースURL */
+    sourceUrl: zod_1.z.string().url(),
+    /** 類似度 */
+    similarity: zod_1.z.number().min(0).max(1),
+    /** 世界観サマリー */
+    worldView: exports.worldViewSummarySchema,
+    /** レイアウト構成サマリー */
+    layoutStructure: exports.layoutStructureSummarySchema,
+    /** 信頼度 */
+    confidence: zod_1.z.number().min(0).max(1),
+});
+/**
+ * 検索情報スキーマ
+ */
+exports.narrativeSearchInfoSchema = zod_1.z.object({
+    /** 検索クエリ（embedding指定時は"[embedding]"） */
+    query: zod_1.z.string(),
+    /** 検索モード */
+    searchMode: exports.narrativeSearchModeSchema,
+    /** 総結果数 */
+    totalResults: zod_1.z.number().int().nonnegative(),
+    /** 検索所要時間（ms） */
+    searchTimeMs: zod_1.z.number().nonnegative(),
+});
+/**
+ * narrative.search 成功レスポンスデータスキーマ
+ */
+exports.narrativeSearchDataSchema = zod_1.z.object({
+    /** 検索結果 */
+    results: zod_1.z.array(exports.narrativeSearchResultItemSchema),
+    /** 検索情報 */
+    searchInfo: exports.narrativeSearchInfoSchema,
+});
+/**
+ * narrative.search エラー情報スキーマ
+ */
+exports.narrativeSearchErrorInfoSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+});
+/**
+ * narrative.search 成功レスポンススキーマ
+ */
+exports.narrativeSearchSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.narrativeSearchDataSchema,
+});
+/**
+ * narrative.search 失敗レスポンススキーマ
+ */
+exports.narrativeSearchErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.narrativeSearchErrorInfoSchema,
+});
+/**
+ * narrative.search 出力スキーマ（統合）
+ */
+exports.narrativeSearchOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.narrativeSearchSuccessOutputSchema,
+    exports.narrativeSearchErrorOutputSchema,
+]);
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * narrative.* ツール用エラーコード
+ */
+exports.NARRATIVE_MCP_ERROR_CODES = {
+    /** バリデーションエラー */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** 分析失敗 */
+    ANALYSIS_FAILED: "ANALYSIS_FAILED",
+    /** Vision分析失敗 */
+    VISION_ANALYSIS_FAILED: "VISION_ANALYSIS_FAILED",
+    /** タイムアウト */
+    TIMEOUT: "TIMEOUT",
+    /** ページが見つからない */
+    PAGE_NOT_FOUND: "PAGE_NOT_FOUND",
+    /** Narrativeが見つからない */
+    NARRATIVE_NOT_FOUND: "NARRATIVE_NOT_FOUND",
+    /** DB保存失敗 */
+    DB_SAVE_FAILED: "DB_SAVE_FAILED",
+    /** 検索失敗 */
+    SEARCH_FAILED: "SEARCH_FAILED",
+    /** Embedding生成失敗 */
+    EMBEDDING_FAILED: "EMBEDDING_FAILED",
+    /** SSRF対策によりブロック */
+    SSRF_BLOCKED: "SSRF_BLOCKED",
+    /** ネットワークエラー */
+    NETWORK_ERROR: "NETWORK_ERROR",
+    /** 内部エラー */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+};
+// ============================================================================
+// MCP Tool Definitions
+// ============================================================================
+/**
+ * MCP Tool definitions for narrative.* tools
+ * MCPプロトコル準拠のツール定義
+ */
+exports.narrativeMcpTools = {
+    "narrative.analyze": {
+        name: "narrative.analyze",
+        description: "URLまたはHTMLからWebデザインの世界観（WorldView）とレイアウト構成（LayoutStructure）を分析します。" +
+            "Vision LLMとCSS静的分析を組み合わせ、ムードカテゴリ・色彩印象・グリッドシステム・視覚的階層等を抽出します。",
+        inputSchema: exports.narrativeAnalyzeInputSchema,
+    },
+    "narrative.search": {
+        name: "narrative.search",
+        description: "世界観・レイアウト構成でセマンティック検索します。" +
+            '自然言語クエリ（例: "サイバーセキュリティ感のあるダークなデザイン"）または768次元Embeddingで検索可能。' +
+            "Hybrid Search（Vector + Full-text）でRRF統合。",
+        inputSchema: exports.narrativeSearchInputSchema,
+    },
+};
+// ============================================================================
+// page.analyze 統合用オプションスキーマ
+// ============================================================================
+/**
+ * page.analyze のnarrative分析オプションスキーマ
+ *
+ * 既存のpage.analyzeツールに追加するオプション
+ */
+exports.pageAnalyzeNarrativeOptionsSchema = zod_1.z.object({
+    /** narrative分析有効化（デフォルトtrue） — page/schemas.tsと一致 */
+    enabled: zod_1.z.boolean().optional().default(true),
+    /** DB保存（デフォルトtrue） */
+    save_to_db: zod_1.z.boolean().optional().default(true),
+    /** Vision LLM分析使用（デフォルトtrue） */
+    include_vision: zod_1.z.boolean().optional().default(true),
+});
+//# sourceMappingURL=schemas.js.map