@tekton-ui/mcp-server 0.3.0

package/dist/schemas/mcp-schemas.js

@@ -0,0 +1,946 @@
+/**
+ * MCP Tool Input/Output Schemas with Zod validation
+ * SPEC-MCP-002: U-002 Input Schema Validation
+ */
+import { z } from 'zod';
+// ============================================================================
+// Generate Blueprint Tool Schemas
+// ============================================================================
+/**
+ * Layout types from @tekton-ui/core LAYOUTS
+ */
+export const LayoutTypeSchema = z.enum([
+    'single-column',
+    'two-column',
+    'sidebar-left',
+    'sidebar-right',
+    'dashboard',
+    'landing',
+]);
+/**
+ * ComponentNode schema - recursive structure from @tekton-ui/core
+ */
+const ComponentNodeSchema = z.lazy(() => z.object({
+    type: z.string(),
+    props: z.record(z.string(), z.unknown()).optional(),
+    children: z.array(z.union([ComponentNodeSchema, z.string()])).optional(),
+    slot: z.string().optional(),
+}));
+/**
+ * Theme ID validation - alphanumeric with hyphens only (security: prevent path traversal)
+ * SPEC: UW-002 No Theme ID Injection
+ */
+export const ThemeIdSchema = z
+    .string()
+    .regex(/^[a-z0-9-]+$/, 'Theme ID must contain only lowercase letters, numbers, and hyphens');
+/**
+ * Generate Blueprint Input Schema
+ * SPEC: E-001 Blueprint Generation Request
+ * SPEC-ICON-001: Added iconLibrary parameter
+ */
+export const GenerateBlueprintInputSchema = z.object({
+    description: z
+        .string()
+        .min(10, 'Description must be at least 10 characters')
+        .max(500, 'Description must not exceed 500 characters'),
+    layout: LayoutTypeSchema,
+    themeId: ThemeIdSchema,
+    iconLibrary: z
+        .string()
+        .regex(/^[a-z0-9-]+$/, 'Icon library ID must contain only lowercase letters, numbers, and hyphens')
+        .optional(),
+    componentHints: z.array(z.string()).optional(),
+});
+/**
+ * Template Recommendation Schema
+ * SPEC-MCP-004 Phase 3: Blueprint Generator Enhancement
+ */
+export const TemplateRecommendationSchema = z.object({
+    templateId: z.string(),
+    templateName: z.string(),
+    category: z.string(),
+    confidence: z.number(), // 0-100
+    matchedKeywords: z.array(z.string()),
+    layoutRecommendation: z.object({
+        shell: z.string(),
+        page: z.string(),
+        description: z.string(),
+    }),
+});
+/**
+ * Generate Blueprint Output Schema (MCP JSON-RPC format - no previewUrl)
+ * SPEC-ICON-001: Added iconLibrary field
+ * SPEC-MCP-004: Added templateRecommendations field
+ */
+export const GenerateBlueprintOutputSchema = z.object({
+    success: z.boolean(),
+    blueprint: z.optional(z.object({
+        id: z.string(),
+        name: z.string(),
+        themeId: z.string(),
+        iconLibrary: z.string(), // SPEC-ICON-001: Icon library used
+        layout: LayoutTypeSchema,
+        components: z.array(ComponentNodeSchema), // ComponentNode[] from @tekton-ui/core
+        timestamp: z.number(),
+    })),
+    // SPEC-MCP-004 Phase 3: Template recommendations based on description analysis
+    templateRecommendations: z.array(TemplateRecommendationSchema).optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// List Themes Tool Schemas (v2.1)
+// ============================================================================
+/**
+ * List Themes Input Schema
+ * No input required - lists all available themes
+ */
+export const ListThemesInputSchema = z.object({});
+/**
+ * Theme metadata schema for v2.1 themes
+ */
+export const ThemeMetaSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    brandTone: z.string(),
+    schemaVersion: z.string(),
+});
+/**
+ * List Themes Output Schema
+ */
+export const ListThemesOutputSchema = z.object({
+    success: z.boolean(),
+    themes: z.array(ThemeMetaSchema).optional(),
+    count: z.number().optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Preview Theme Tool Schemas (v2.1 Updated)
+// ============================================================================
+/**
+ * Preview Theme Input Schema
+ * SPEC: E-002 Theme Preview Request
+ */
+export const PreviewThemeInputSchema = z.object({
+    themeId: ThemeIdSchema,
+});
+/**
+ * Preview Theme Output Schema (v2.1 - includes full theme data)
+ */
+export const PreviewThemeOutputSchema = z.object({
+    success: z.boolean(),
+    theme: z.optional(z.object({
+        id: z.string(),
+        name: z.string(),
+        description: z.string().optional(),
+        brandTone: z.string(),
+        schemaVersion: z.string(),
+        designDNA: z
+            .object({
+            moodKeywords: z.array(z.string()),
+            targetEmotion: z.string(),
+            visualAtmosphere: z.string(),
+        })
+            .optional(),
+        tokens: z.object({
+            atomic: z.unknown(),
+            semantic: z.unknown(),
+            component: z.unknown().optional(),
+            recipes: z.unknown().optional(),
+        }),
+        stateLayer: z.unknown().optional(),
+        motion: z.unknown().optional(),
+        elevation: z.unknown().optional(),
+        typography: z.unknown().optional(),
+    })),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Export Screen Tool Schemas
+// ============================================================================
+/**
+ * Export format types
+ * SPEC: S-004 Export Format Compatibility
+ */
+export const ExportFormatSchema = z.enum(['jsx', 'tsx', 'vue']);
+/**
+ * Export Screen Input Schema (MCP JSON-RPC format - accepts blueprint object)
+ * SPEC: E-003 Screen Export Request
+ */
+export const ExportScreenInputSchema = z.object({
+    blueprint: z.unknown(), // Blueprint from @tekton-ui/core (accept any object for flexibility)
+    format: ExportFormatSchema,
+});
+/**
+ * Export Screen Output Schema (MCP JSON-RPC format - no filePath)
+ */
+export const ExportScreenOutputSchema = z.object({
+    success: z.boolean(),
+    code: z.string().optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Hybrid Export Tool Schemas (SPEC-COMPONENT-001-D)
+// ============================================================================
+/**
+ * Export component resolution tier
+ * - tier1: Copy from @tekton-ui/ui (fast, deterministic)
+ * - tier2: Generate with LLM (flexible, customizable)
+ * - auto: Automatically choose based on component availability
+ */
+export const ExportTierSchema = z.enum(['tier1', 'tier2', 'auto']);
+/**
+ * Hybrid Export Input Schema
+ * SPEC-COMPONENT-001-D: Hybrid Export System
+ */
+export const HybridExportInputSchema = z.object({
+    /** Blueprint or component name */
+    blueprint: z.unknown().optional(),
+    /** Single component name for direct export */
+    componentName: z.string().optional(),
+    /** Component description (for Tier 2 LLM generation) */
+    componentDescription: z.string().optional(),
+    /** Output format */
+    format: ExportFormatSchema,
+    /** Include CSS Variables */
+    includeCSS: z.boolean().optional().default(false),
+    /** Resolution tier preference */
+    tier: ExportTierSchema.optional().default('auto'),
+    /** Theme ID for CSS generation */
+    themeId: ThemeIdSchema.optional(),
+});
+/**
+ * Component resolution result
+ */
+export const ComponentResolutionSchema = z.object({
+    componentName: z.string(),
+    code: z.string(),
+    source: z.enum(['tier1-ui', 'tier1-example', 'tier2-llm', 'tier2-mock']),
+});
+/**
+ * Hybrid Export Output Schema
+ * SPEC-COMPONENT-001-D: Hybrid Export System
+ */
+export const HybridExportOutputSchema = z.object({
+    success: z.boolean(),
+    /** Screen/component code */
+    code: z.string().optional(),
+    /** CSS Variables (if includeCSS was true) */
+    css: z.string().optional(),
+    /** Component resolution details */
+    components: z.array(ComponentResolutionSchema).optional(),
+    /** Tier used for resolution */
+    tierUsed: ExportTierSchema.optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Common Error Response Schema
+// ============================================================================
+/**
+ * Standardized error response format
+ * SPEC: U-004 Error Response Consistency
+ */
+export const ErrorResponseSchema = z.object({
+    success: z.literal(false),
+    error: z.string(),
+});
+// ============================================================================
+// Generate Screen Tool Schemas (SPEC-LAYOUT-002 Phase 4)
+// ============================================================================
+/**
+ * Output format for code generation
+ */
+export const OutputFormatSchema = z.enum(['css-in-js', 'tailwind', 'react']);
+/**
+ * CSS Framework options for CSS-in-JS format
+ */
+export const CSSFrameworkSchema = z.enum(['styled-components', 'emotion']);
+/**
+ * Generation options for generate_screen tool
+ */
+export const GenerationOptionsSchema = z.object({
+    cssFramework: CSSFrameworkSchema.optional(),
+    typescript: z.boolean().optional().default(true),
+    prettier: z.boolean().optional().default(false),
+});
+/**
+ * Generate Screen Input Schema
+ * SPEC-LAYOUT-002: Generate production code from screen definition
+ */
+export const GenerateScreenInputSchema = z.object({
+    screenDefinition: z.unknown(), // Accept any object - will be validated by @tekton-ui/core
+    outputFormat: OutputFormatSchema,
+    options: GenerationOptionsSchema.optional(),
+});
+/**
+ * Dependencies structure for generated code
+ * SPEC-MCP-005: Automatic dependency extraction and environment validation
+ */
+export const DependenciesSchema = z.object({
+    external: z.array(z.string()).describe('External NPM packages required by generated code'),
+    internal: z.array(z.string()).describe('Internal @tekton packages'),
+    installCommands: z.object({
+        npm: z.string(),
+        yarn: z.string(),
+        pnpm: z.string(),
+        bun: z.string(),
+    }),
+    compatibility: z
+        .object({
+        react: z.string().optional(),
+        node: z.string().optional(),
+    })
+        .optional(),
+    notes: z.array(z.string()).optional(),
+});
+/**
+ * Generate Screen Output Schema
+ */
+export const GenerateScreenOutputSchema = z.object({
+    success: z.boolean(),
+    code: z.string().optional(),
+    cssVariables: z.string().optional(),
+    dependencies: DependenciesSchema.optional(),
+    errors: z.array(z.string()).optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Validate Screen Tool Schemas (SPEC-LAYOUT-002 Phase 4)
+// ============================================================================
+/**
+ * Validate Screen Input Schema
+ */
+export const ValidateScreenInputSchema = z.object({
+    screenDefinition: z.unknown(), // Accept any object for validation
+    strictMode: z.boolean().optional().default(false),
+});
+/**
+ * Validation suggestion
+ */
+export const ValidationSuggestionSchema = z.object({
+    field: z.string(),
+    message: z.string(),
+    suggestion: z.string().optional(),
+});
+/**
+ * Validate Screen Output Schema
+ */
+export const ValidateScreenOutputSchema = z.object({
+    success: z.boolean(),
+    valid: z.boolean().optional(),
+    errors: z.array(z.string()).optional(),
+    warnings: z.array(z.string()).optional(),
+    suggestions: z.array(ValidationSuggestionSchema).optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// List Tokens Tool Schemas (SPEC-LAYOUT-002 Phase 4)
+// ============================================================================
+/**
+ * Token type filter
+ */
+export const TokenTypeSchema = z.enum(['shell', 'page', 'section', 'all']);
+/**
+ * List Tokens Input Schema
+ */
+export const ListTokensInputSchema = z.object({
+    tokenType: TokenTypeSchema.optional().default('all'),
+    filter: z.string().optional(),
+});
+/**
+ * Token metadata
+ */
+export const TokenMetadataSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    platform: z.string().optional(),
+    purpose: z.string().optional(),
+    type: z.string().optional(),
+});
+/**
+ * List Tokens Output Schema
+ */
+export const ListTokensOutputSchema = z.object({
+    success: z.boolean(),
+    shells: z.array(TokenMetadataSchema).optional(),
+    pages: z.array(TokenMetadataSchema).optional(),
+    sections: z.array(TokenMetadataSchema).optional(),
+    metadata: z
+        .object({
+        total: z.number(),
+        filtered: z.number().optional(),
+    })
+        .optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Icon Library Tool Schemas (SPEC-ICON-001)
+// ============================================================================
+/**
+ * Icon Library ID validation - alphanumeric with hyphens only
+ * SPEC-ICON-001: UW-001 No Icon Library ID Injection
+ */
+export const IconLibraryIdSchema = z
+    .string()
+    .regex(/^[a-z0-9-]+$/, 'Icon library ID must contain only lowercase letters, numbers, and hyphens');
+/**
+ * List Icon Libraries Input Schema
+ * No input required - lists all available icon libraries
+ */
+export const ListIconLibrariesInputSchema = z.object({});
+/**
+ * Icon library metadata schema
+ */
+export const IconLibraryMetaSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    version: z.string(),
+    license: z.string(),
+    totalIcons: z.number(),
+    categories: z.array(z.string()),
+});
+/**
+ * List Icon Libraries Output Schema
+ */
+export const ListIconLibrariesOutputSchema = z.object({
+    success: z.boolean(),
+    libraries: z.array(IconLibraryMetaSchema).optional(),
+    count: z.number().optional(),
+    error: z.string().optional(),
+});
+/**
+ * Preview Icon Library Input Schema
+ */
+export const PreviewIconLibraryInputSchema = z.object({
+    libraryId: IconLibraryIdSchema,
+});
+/**
+ * Icon size mapping schema
+ */
+export const IconSizeMappingSchema = z.object({
+    xs: z.number().optional(),
+    sm: z.number(),
+    md: z.number(),
+    lg: z.number(),
+    xl: z.number().optional(),
+});
+/**
+ * Framework config schema
+ */
+export const IconFrameworkConfigSchema = z.object({
+    packageName: z.string(),
+    importStatement: z.string(),
+    componentPattern: z.string(),
+    variants: z.record(z.string()).optional(),
+});
+/**
+ * Preview Icon Library Output Schema
+ */
+export const PreviewIconLibraryOutputSchema = z.object({
+    success: z.boolean(),
+    library: z.optional(z.object({
+        id: z.string(),
+        name: z.string(),
+        description: z.string(),
+        version: z.string(),
+        license: z.string(),
+        website: z.string(),
+        totalIcons: z.number(),
+        categories: z.array(z.string()),
+        sizeMapping: IconSizeMappingSchema,
+        frameworks: z.object({
+            react: IconFrameworkConfigSchema,
+            vue: IconFrameworkConfigSchema,
+        }),
+        defaultVariant: z.string().optional(),
+        iconSample: z.array(z.string()).optional(),
+    })),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Component Discovery Tool Schemas (SPEC-MCP-003)
+// ============================================================================
+/**
+ * Component category types
+ * SPEC-MCP-003: Component tier system
+ */
+export const ComponentCategorySchema = z.enum(['core', 'complex', 'advanced']);
+/**
+ * List Components Input Schema
+ * SPEC-MCP-003: [TAG-MCP003-006]
+ */
+export const ListComponentsInputSchema = z.object({
+    category: z.enum(['core', 'complex', 'advanced', 'all']).optional().default('all'),
+    search: z.string().optional(),
+});
+/**
+ * Component metadata schema
+ */
+export const ComponentMetaSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    category: ComponentCategorySchema,
+    description: z.string(),
+    variantsCount: z.number(),
+    hasSubComponents: z.boolean(),
+    tier: z.number(),
+});
+/**
+ * List Components Output Schema
+ */
+export const ListComponentsOutputSchema = z.object({
+    success: z.boolean(),
+    components: z.array(ComponentMetaSchema).optional(),
+    count: z.number().optional(),
+    categories: z
+        .object({
+        core: z.number(),
+        complex: z.number(),
+        advanced: z.number(),
+    })
+        .optional(),
+    error: z.string().optional(),
+});
+/**
+ * Preview Component Input Schema
+ * SPEC-MCP-003: [TAG-MCP003-007]
+ */
+export const PreviewComponentInputSchema = z.object({
+    componentId: z.string().regex(/^[a-z-]+$/, 'Component ID must be lowercase with hyphens'),
+    includeExamples: z.boolean().optional(),
+    includeDependencies: z.boolean().optional(),
+});
+/**
+ * Prop definition schema
+ */
+export const PropDefinitionSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    required: z.boolean(),
+    defaultValue: z.string().optional(),
+    description: z.string().optional(),
+});
+/**
+ * Variant schema
+ */
+export const VariantSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    description: z.string().optional(),
+});
+/**
+ * Usage example schema
+ */
+export const UsageExampleSchema = z.object({
+    title: z.string(),
+    code: z.string(),
+    description: z.string().optional(),
+});
+/**
+ * Preview Component Output Schema
+ */
+export const PreviewComponentOutputSchema = z.object({
+    success: z.boolean(),
+    component: z
+        .object({
+        id: z.string(),
+        name: z.string(),
+        category: ComponentCategorySchema,
+        description: z.string(),
+        tier: z.number(),
+        props: z.array(PropDefinitionSchema),
+        variants: z.array(VariantSchema).optional(),
+        subComponents: z.array(z.string()).optional(),
+        importStatement: z.string(),
+        dependencies: z
+            .object({
+            internal: z.array(z.string()),
+            external: z.array(z.string()),
+        })
+            .optional(),
+        examples: z.array(UsageExampleSchema).optional(),
+        accessibility: z.string().optional(),
+    })
+        .optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Screen Template Discovery Tool Schemas (SPEC-MCP-003)
+// ============================================================================
+/**
+ * Template category types
+ */
+export const TemplateCategorySchema = z.enum([
+    'auth',
+    'dashboard',
+    'form',
+    'marketing',
+    'feedback',
+]);
+/**
+ * List Screen Templates Input Schema
+ * SPEC-MCP-003: [TAG-MCP003-008]
+ */
+export const ListScreenTemplatesInputSchema = z.object({
+    category: z
+        .enum(['auth', 'dashboard', 'form', 'marketing', 'feedback', 'all'])
+        .optional()
+        .default('all'),
+    search: z.string().optional(),
+});
+/**
+ * Template layout type schema
+ */
+export const TemplateLayoutTypeSchema = z.enum(['centered', 'sidebar', 'full']);
+/**
+ * Template metadata schema
+ */
+export const TemplateMetaSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    category: TemplateCategorySchema,
+    description: z.string(),
+    requiredComponentsCount: z.number(),
+    layoutType: TemplateLayoutTypeSchema,
+    version: z.string(),
+    tags: z.array(z.string()).optional(),
+});
+/**
+ * List Screen Templates Output Schema
+ */
+export const ListScreenTemplatesOutputSchema = z.object({
+    success: z.boolean(),
+    templates: z.array(TemplateMetaSchema).optional(),
+    count: z.number().optional(),
+    categories: z
+        .object({
+        auth: z.number(),
+        dashboard: z.number(),
+        form: z.number(),
+        marketing: z.number(),
+        feedback: z.number(),
+    })
+        .optional(),
+    error: z.string().optional(),
+});
+/**
+ * Preview Screen Template Input Schema
+ * SPEC-MCP-003: [TAG-MCP003-009]
+ */
+export const PreviewScreenTemplateInputSchema = z.object({
+    templateId: z.string().regex(/^[a-z]+\.[a-z-]+$/, 'Template ID must be in format category.name'),
+    includeLayoutTokens: z.boolean().optional(),
+});
+/**
+ * Skeleton schema
+ */
+export const SkeletonSchema = z.object({
+    shell: z.string(),
+    page: z.string(),
+    sections: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        slot: z.string(),
+        required: z.boolean(),
+    })),
+});
+/**
+ * Customization schema
+ */
+export const CustomizationSchema = z.object({
+    texts: z.array(z.string()),
+    optional: z.array(z.string()),
+    slots: z.array(z.string()),
+});
+/**
+ * Responsive layout schema
+ */
+export const ResponsiveLayoutSchema = z.object({
+    mobile: z.object({
+        padding: z.string(),
+        gap: z.string(),
+        columns: z.number(),
+    }),
+    tablet: z.object({
+        padding: z.string(),
+        gap: z.string(),
+        columns: z.number(),
+    }),
+    desktop: z.object({
+        padding: z.string(),
+        gap: z.string(),
+        columns: z.number(),
+    }),
+});
+/**
+ * Preview Screen Template Output Schema
+ */
+export const PreviewScreenTemplateOutputSchema = z.object({
+    success: z.boolean(),
+    template: z
+        .object({
+        id: z.string(),
+        name: z.string(),
+        category: TemplateCategorySchema,
+        description: z.string(),
+        version: z.string(),
+        skeleton: SkeletonSchema,
+        layout: z.object({
+            type: TemplateLayoutTypeSchema,
+            responsive: ResponsiveLayoutSchema.optional(),
+        }),
+        customizable: CustomizationSchema,
+        requiredComponents: z.array(z.string()),
+        importStatement: z.string(),
+        exampleProps: z
+            .object({
+            texts: z.record(z.string()).optional(),
+            options: z.record(z.boolean()).optional(),
+            slots: z.array(z.string()).optional(),
+        })
+            .optional(),
+        created: z.string(),
+        updated: z.string(),
+        tags: z.array(z.string()).optional(),
+    })
+        .optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Get Screen Generation Context Tool Schemas (SPEC-MCP-004 Phase 3.5)
+// ============================================================================
+/**
+ * Get Screen Generation Context Input Schema
+ * SPEC-MCP-004 Phase 3.5: Provides coding agents with complete context for screen generation
+ */
+export const GetScreenGenerationContextInputSchema = z.object({
+    description: z
+        .string()
+        .min(5, 'Description must be at least 5 characters')
+        .max(1000, 'Description must not exceed 1000 characters'),
+    themeId: ThemeIdSchema.optional(),
+    includeExamples: z.boolean().optional().default(true),
+});
+/**
+ * Template match result for generation context
+ */
+export const ContextTemplateMatchSchema = z.object({
+    templateId: z.string(),
+    templateName: z.string(),
+    category: z.string(),
+    confidence: z.number(),
+    matchedKeywords: z.array(z.string()),
+    skeleton: SkeletonSchema.optional(),
+    requiredComponents: z.array(z.string()).optional(),
+});
+/**
+ * Component info for generation context
+ */
+export const ContextComponentInfoSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    category: ComponentCategorySchema,
+    description: z.string(),
+    importStatement: z.string(),
+    props: z.array(PropDefinitionSchema),
+    variants: z.array(VariantSchema).optional(),
+});
+/**
+ * Screen definition schema for validation and examples
+ */
+export const ScreenDefinitionSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/, 'Screen ID must be lowercase alphanumeric with hyphens'),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    shell: z
+        .string()
+        .regex(/^shell\.[a-z]+\.[a-z-]+$/, 'Shell token must be in format shell.platform.name'),
+    page: z.string().regex(/^page\.[a-z-]+$/, 'Page token must be in format page.name'),
+    themeId: ThemeIdSchema.optional(),
+    sections: z.array(z.object({
+        id: z.string(),
+        pattern: z
+            .string()
+            .regex(/^section\.[a-z0-9-]+$/, 'Section pattern must be in format section.name'),
+        slot: z.string().optional(),
+        components: z.array(z.object({
+            type: z.string(),
+            props: z.record(z.unknown()).optional(),
+            children: z.union([z.string(), z.array(z.unknown())]).optional(),
+        })),
+    })),
+    metadata: z
+        .object({
+        version: z.string().optional(),
+        author: z.string().optional(),
+        created: z.string().optional(),
+        updated: z.string().optional(),
+    })
+        .optional(),
+});
+/**
+ * Example screen definition with description
+ */
+export const ScreenExampleSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    definition: ScreenDefinitionSchema,
+});
+/**
+ * Theme recipe info for generation context
+ */
+export const ThemeRecipeInfoSchema = z.object({
+    componentType: z.string(),
+    variants: z.array(z.string()),
+    defaultClassName: z.string().optional(),
+});
+/**
+ * Generation hint for coding agents
+ */
+export const GenerationHintSchema = z.object({
+    category: z.enum(['layout', 'component', 'styling', 'accessibility', 'best-practice']),
+    priority: z.enum(['high', 'medium', 'low']),
+    message: z.string(),
+    example: z.string().optional(),
+});
+/**
+ * Workflow Step Schema
+ * SPEC-MCP-004 Phase 5: E2E workflow guide for agents
+ */
+export const WorkflowStepSchema = z.object({
+    step: z.number(),
+    action: z.string(),
+    tool: z.string().optional(),
+    description: z.string(),
+    example: z.string().optional(),
+});
+/**
+ * Workflow Guide Schema
+ * Provides step-by-step guidance for agents to generate screens
+ */
+export const WorkflowGuideSchema = z.object({
+    title: z.string(),
+    description: z.string(),
+    steps: z.array(WorkflowStepSchema),
+    notes: z.array(z.string()).optional(),
+});
+/**
+ * Get Screen Generation Context Output Schema
+ */
+export const GetScreenGenerationContextOutputSchema = z.object({
+    success: z.boolean(),
+    templateMatch: ContextTemplateMatchSchema.optional(),
+    components: z.array(ContextComponentInfoSchema).optional(),
+    schema: z
+        .object({
+        screenDefinition: z.unknown(), // JSON Schema representation
+        description: z.string(),
+    })
+        .optional(),
+    examples: z.array(ScreenExampleSchema).optional(),
+    themeRecipes: z.array(ThemeRecipeInfoSchema).optional(),
+    hints: z.array(GenerationHintSchema).optional(),
+    workflow: WorkflowGuideSchema.optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Validate Screen Definition Tool Schemas (SPEC-MCP-004 Phase 3.5)
+// ============================================================================
+/**
+ * Validate Screen Definition Input Schema
+ * SPEC-MCP-004 Phase 3.5: Validates screen definitions with helpful feedback
+ */
+export const ValidateScreenDefinitionInputSchema = z.object({
+    definition: z.unknown(), // Accept any object for validation
+    strict: z.boolean().optional().default(true),
+});
+/**
+ * Validation error with path and suggestion
+ */
+export const ValidationErrorSchema = z.object({
+    path: z.string(),
+    code: z.string(),
+    message: z.string(),
+    expected: z.string().optional(),
+    received: z.string().optional(),
+    suggestion: z.string().optional(),
+});
+/**
+ * Validation warning (non-blocking)
+ */
+export const ValidationWarningSchema = z.object({
+    path: z.string(),
+    code: z.string(),
+    message: z.string(),
+    recommendation: z.string().optional(),
+});
+/**
+ * Improvement suggestion
+ */
+export const ImprovementSuggestionSchema = z.object({
+    category: z.enum(['accessibility', 'performance', 'maintainability', 'consistency']),
+    message: z.string(),
+    affectedPath: z.string().optional(),
+    suggestedChange: z.string().optional(),
+});
+/**
+ * Validate Screen Definition Output Schema
+ */
+export const ValidateScreenDefinitionOutputSchema = z.object({
+    success: z.boolean(),
+    valid: z.boolean().optional(),
+    errors: z.array(ValidationErrorSchema).optional(),
+    warnings: z.array(ValidationWarningSchema).optional(),
+    suggestions: z.array(ImprovementSuggestionSchema).optional(),
+    error: z.string().optional(),
+});
+// ============================================================================
+// Validate Environment Tool Schemas (SPEC-MCP-005 Phase 2)
+// ============================================================================
+/**
+ * Validate Environment Input Schema
+ * SPEC-MCP-005 Phase 2: Check user's environment for missing dependencies
+ */
+export const ValidateEnvironmentInputSchema = z.object({
+    projectPath: z.string().describe('Path to package.json or project root'),
+    requiredPackages: z
+        .array(z.string())
+        .describe('Packages to validate (from generate_screen.dependencies.external)'),
+    checkTailwind: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Also validate Tailwind CSS configuration for @tekton-ui/ui compatibility'),
+});
+/**
+ * Validate Environment Output Schema
+ */
+export const ValidateEnvironmentOutputSchema = z.object({
+    success: z.boolean(),
+    installed: z.record(z.string()).optional().describe('Packages already installed with versions'),
+    missing: z.array(z.string()).optional().describe('Packages that need to be installed'),
+    installCommands: z
+        .object({
+        npm: z.string(),
+        yarn: z.string(),
+        pnpm: z.string(),
+        bun: z.string(),
+    })
+        .optional(),
+    warnings: z.array(z.string()).optional().describe('Version conflicts or compatibility issues'),
+    tailwind: z
+        .object({
+        configFound: z.boolean(),
+        configPath: z.string().optional(),
+        hasUiContentPath: z.boolean(),
+        hasAnimatePlugin: z.boolean(),
+        issues: z.array(z.string()),
+        fixes: z.array(z.string()),
+    })
+        .optional()
+        .describe('Tailwind CSS configuration validation for @tekton-ui/ui compatibility'),
+    error: z.string().optional(),
+});
+//# sourceMappingURL=mcp-schemas.js.map