mcp-hydrocoder-image 1.0.0

package/dist/business/fileManager.js

@@ -0,0 +1,76 @@
+/**
+ * File Manager for handling image file operations
+ * Provides functionality for saving images and managing directories
+ */
+import { promises as fs, mkdirSync } from 'node:fs';
+import * as path from 'node:path';
+import { Err, Ok } from '../types/result.js';
+import { FileOperationError } from '../utils/errors.js';
+// Constants for file naming and error messages
+const FILE_NAME_PREFIX = 'image';
+const DEFAULT_EXTENSION = '.png';
+const RANDOM_RANGE = 1000;
+const ERROR_MESSAGES = {
+    SAVE_FAILED: 'Failed to save image file',
+    DIRECTORY_CREATION_FAILED: 'Failed to create directory',
+    PERMISSION_SUGGESTION: 'Check output directory permissions and disk space',
+    PATH_SUGGESTION: 'Check directory path validity and write permissions',
+};
+/**
+ * Ensures that the specified directory exists, creating it if necessary
+ * @param dirPath Path to the directory
+ * @returns Result indicating success or failure
+ */
+function ensureDirectoryExists(dirPath) {
+    try {
+        // Use mkdirSync with recursive option to create all necessary parent directories
+        mkdirSync(dirPath, { recursive: true });
+        return Ok(undefined);
+    }
+    catch (error) {
+        return Err(new FileOperationError(`${ERROR_MESSAGES.DIRECTORY_CREATION_FAILED}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+/**
+ * Generates a unique filename based on timestamp and random component
+ * @returns Generated filename in the format: gemini-image-{timestamp}.png
+ */
+function generateFileName() {
+    const timestamp = Date.now();
+    const random = Math.floor(Math.random() * RANDOM_RANGE);
+    return `${FILE_NAME_PREFIX}-${timestamp}-${random}${DEFAULT_EXTENSION}`;
+}
+/**
+ * Creates a file manager for image file operations
+ * @returns FileManager implementation
+ */
+export function createFileManager() {
+    return {
+        /**
+         * Saves image data to the specified file path
+         * @param imageData Buffer containing the image data
+         * @param outputPath Absolute path where the image should be saved
+         * @param format Image format (used for validation)
+         * @returns Result containing the saved file path or an error
+         */
+        async saveImage(imageData, outputPath, _format) {
+            try {
+                // Ensure the directory exists
+                const directory = path.dirname(outputPath);
+                const dirResult = ensureDirectoryExists(directory);
+                if (!dirResult.success) {
+                    return Err(dirResult.error);
+                }
+                // Save the file
+                await fs.writeFile(outputPath, imageData);
+                return Ok(outputPath);
+            }
+            catch (error) {
+                return Err(new FileOperationError(`${ERROR_MESSAGES.SAVE_FAILED}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            }
+        },
+        ensureDirectoryExists,
+        generateFileName,
+    };
+}
+//# sourceMappingURL=fileManager.js.map

package/dist/business/fileManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileManager.js","sourceRoot":"","sources":["../../src/business/fileManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD,+CAA+C;AAC/C,MAAM,gBAAgB,GAAG,OAAgB,CAAA;AACzC,MAAM,iBAAiB,GAAG,MAAe,CAAA;AACzC,MAAM,YAAY,GAAG,IAAa,CAAA;AAElC,MAAM,cAAc,GAAG;IACrB,WAAW,EAAE,2BAA2B;IACxC,yBAAyB,EAAE,4BAA4B;IACvD,qBAAqB,EAAE,mDAAmD;IAC1E,eAAe,EAAE,qDAAqD;CAC9D,CAAA;AAeV;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,iFAAiF;QACjF,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACvC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CACR,IAAI,kBAAkB,CACpB,GAAG,cAAc,CAAC,yBAAyB,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC3G,CACF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;IACvD,OAAO,GAAG,gBAAgB,IAAI,SAAS,IAAI,MAAM,GAAG,iBAAiB,EAAE,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL;;;;;;WAMG;QACH,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,UAAkB,EAClB,OAAgB;YAEhB,IAAI,CAAC;gBACH,8BAA8B;gBAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;gBAC1C,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAA;gBAClD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBACvB,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;gBAC7B,CAAC;gBAED,gBAAgB;gBAChB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;gBAEzC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAA;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CACR,IAAI,kBAAkB,CACpB,GAAG,cAAc,CAAC,WAAW,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC7F,CACF,CAAA;YACH,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,gBAAgB;KACjB,CAAA;AACH,CAAC"}

package/dist/business/inputValidator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Input validation module for MCP server
+ * Validates user inputs according to Gemini API and business requirements
+ */
+import type { GenerateImageParams } from '../types/mcp.js';
+import type { Result } from '../types/result.js';
+import { InputValidationError } from '../utils/errors.js';
+/**
+ * Validates prompt text for length constraints
+ */
+export declare function validatePrompt(prompt: string): Result<string, InputValidationError>;
+/**
+ * Validates base64 encoded image data
+ * @param imageData - Base64 encoded image string
+ * @param mimeType - MIME type of the image
+ * @returns Result with validated Buffer or error
+ */
+export declare function validateBase64Image(imageData?: string, mimeType?: string): Result<Buffer | undefined, InputValidationError>;
+/**
+ * Validates an array of base64 encoded images
+ * @param images - Array of image objects with data and mimeType
+ * @returns Result with success or error
+ */
+export declare function validateBase64Images(images: Array<{
+    data: string;
+    mimeType: string;
+}>): Result<void, InputValidationError>;
+/**
+ * Validates an array of input image paths
+ * @param paths - Array of image file paths
+ * @returns Result with success or error
+ */
+export declare function validateImagePaths(paths: string[]): Result<void, InputValidationError>;
+/**
+ * Validates input image path
+ * @param imagePath - Path to the input image file
+ * @returns Result with validated path or error
+ */
+export declare function validateImagePath(imagePath?: string): Result<string | undefined, InputValidationError>;
+/**
+ * Validates complete GenerateImageParams object
+ */
+export declare function validateGenerateImageParams(params: GenerateImageParams): Result<GenerateImageParams, InputValidationError>;
+//# sourceMappingURL=inputValidator.d.ts.map

package/dist/business/inputValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputValidator.d.ts","sourceRoot":"","sources":["../../src/business/inputValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAEvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAiCzD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAanF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,oBAAoB,CAAC,CAuDlD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAyBpC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAuBpC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,oBAAoB,CAAC,CA6BlD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CA2GnD"}

package/dist/business/inputValidator.js

@@ -0,0 +1,213 @@
+/**
+ * Input validation module for MCP server
+ * Validates user inputs according to Gemini API and business requirements
+ */
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+import { IMAGE_QUALITY_VALUES } from '../types/mcp.js';
+import { Err, Ok } from '../types/result.js';
+import { InputValidationError } from '../utils/errors.js';
+// Constants for validation limits
+const PROMPT_MIN_LENGTH = 1;
+const PROMPT_MAX_LENGTH = 4000;
+const MAX_IMAGE_SIZE = 10 * 1024 * 1024; // 10MB in bytes
+const SUPPORTED_MIME_TYPES = ['image/jpeg', 'image/png', 'image/webp', 'image/gif', 'image/bmp'];
+const SUPPORTED_ASPECT_RATIOS = [
+    '1:1',
+    '1:4',
+    '1:8',
+    '2:3',
+    '3:2',
+    '3:4',
+    '4:1',
+    '4:3',
+    '4:5',
+    '5:4',
+    '8:1',
+    '9:16',
+    '16:9',
+    '21:9',
+];
+const SUPPORTED_QUALITY_VALUES = IMAGE_QUALITY_VALUES;
+/**
+ * Converts bytes to MB with proper formatting
+ */
+function formatFileSize(bytes) {
+    return (bytes / (1024 * 1024)).toFixed(1);
+}
+/**
+ * Validates prompt text for length constraints
+ */
+export function validatePrompt(prompt) {
+    if (prompt.length < PROMPT_MIN_LENGTH || prompt.length > PROMPT_MAX_LENGTH) {
+        return Err(new InputValidationError(`Prompt must be between ${PROMPT_MIN_LENGTH} and ${PROMPT_MAX_LENGTH} characters. Current length: ${prompt.length}`, prompt.length === 0
+            ? 'Please provide a descriptive prompt for image generation.'
+            : `Please shorten your prompt by ${prompt.length - PROMPT_MAX_LENGTH} characters.`));
+    }
+    return Ok(prompt);
+}
+/**
+ * Validates base64 encoded image data
+ * @param imageData - Base64 encoded image string
+ * @param mimeType - MIME type of the image
+ * @returns Result with validated Buffer or error
+ */
+export function validateBase64Image(imageData, mimeType) {
+    // If no image data provided, it's valid (optional parameter)
+    if (!imageData) {
+        return Ok(undefined);
+    }
+    // Validate MIME type if provided
+    if (mimeType && !SUPPORTED_MIME_TYPES.includes(mimeType)) {
+        return Err(new InputValidationError(`Unsupported MIME type: ${mimeType}. Supported types: ${SUPPORTED_MIME_TYPES.join(', ')}`, `Please provide an image with one of these MIME types: ${SUPPORTED_MIME_TYPES.join(', ')}`));
+    }
+    // Check if it's valid base64
+    // Remove data URI prefix if present
+    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+    const cleanedData = imageData.replace(/^data:image\/[a-z]+;base64,/, '');
+    if (!base64Regex.test(cleanedData)) {
+        return Err(new InputValidationError('Invalid base64 format', 'Please provide a valid base64 encoded image string'));
+    }
+    // Decode and check size
+    let buffer;
+    try {
+        buffer = Buffer.from(cleanedData, 'base64');
+        if (buffer.length > MAX_IMAGE_SIZE) {
+            const sizeInMB = formatFileSize(buffer.length);
+            const limitInMB = formatFileSize(MAX_IMAGE_SIZE);
+            return Err(new InputValidationError(`Image size exceeds ${limitInMB}MB limit. Current size: ${sizeInMB}MB`, `Please compress your image or reduce its resolution to stay below ${limitInMB}MB`));
+        }
+    }
+    catch (_error) {
+        return Err(new InputValidationError('Failed to decode base64 image', 'Please ensure the image is properly base64 encoded'));
+    }
+    return Ok(buffer);
+}
+/**
+ * Validates an array of base64 encoded images
+ * @param images - Array of image objects with data and mimeType
+ * @returns Result with success or error
+ */
+export function validateBase64Images(images) {
+    if (images.length === 0) {
+        return Err(new InputValidationError('inputImages array must not be empty', 'Provide at least one image in the inputImages array'));
+    }
+    for (let i = 0; i < images.length; i++) {
+        const img = images[i];
+        if (!img)
+            continue;
+        const result = validateBase64Image(img.data, img.mimeType);
+        if (!result.success) {
+            return Err(new InputValidationError(`inputImages[${i}]: ${result.error.message}`, result.error.suggestion));
+        }
+    }
+    return Ok(undefined);
+}
+/**
+ * Validates an array of input image paths
+ * @param paths - Array of image file paths
+ * @returns Result with success or error
+ */
+export function validateImagePaths(paths) {
+    if (paths.length === 0) {
+        return Err(new InputValidationError('inputImagePaths array must not be empty', 'Provide at least one file path in the inputImagePaths array'));
+    }
+    for (let i = 0; i < paths.length; i++) {
+        const result = validateImagePath(paths[i]);
+        if (!result.success) {
+            return Err(new InputValidationError(`inputImagePaths[${i}]: ${result.error.message}`, result.error.suggestion));
+        }
+    }
+    return Ok(undefined);
+}
+/**
+ * Validates input image path
+ * @param imagePath - Path to the input image file
+ * @returns Result with validated path or error
+ */
+export function validateImagePath(imagePath) {
+    // If no path provided, it's valid (optional parameter)
+    if (!imagePath) {
+        return Ok(undefined);
+    }
+    // Check if file exists
+    if (!existsSync(imagePath)) {
+        return Err(new InputValidationError(`Input image file not found: ${imagePath}`, 'Please provide a valid absolute path to an existing image file'));
+    }
+    // Check file extension
+    const ext = extname(imagePath).toLowerCase();
+    const supportedExtensions = ['.jpg', '.jpeg', '.png', '.webp', '.gif', '.bmp'];
+    if (!supportedExtensions.includes(ext)) {
+        return Err(new InputValidationError(`Unsupported image format: ${ext}. Supported formats: ${supportedExtensions.join(', ')}`, `Please provide an image with one of these extensions: ${supportedExtensions.join(', ')}`));
+    }
+    return Ok(imagePath);
+}
+/**
+ * Validates complete GenerateImageParams object
+ */
+export function validateGenerateImageParams(params) {
+    // Validate prompt
+    const promptResult = validatePrompt(params.prompt);
+    if (!promptResult.success) {
+        return Err(promptResult.error);
+    }
+    // Validate input image path if provided
+    const imagePathResult = validateImagePath(params.inputImagePath);
+    if (!imagePathResult.success) {
+        return Err(imagePathResult.error);
+    }
+    // Validate blendImages parameter
+    if (params.blendImages !== undefined && typeof params.blendImages !== 'boolean') {
+        return Err(new InputValidationError('blendImages must be a boolean value', 'Use true or false for blendImages parameter to enable/disable multi-image blending'));
+    }
+    // Validate maintainCharacterConsistency parameter
+    if (params.maintainCharacterConsistency !== undefined &&
+        typeof params.maintainCharacterConsistency !== 'boolean') {
+        return Err(new InputValidationError('maintainCharacterConsistency must be a boolean value', 'Use true or false for maintainCharacterConsistency parameter to enable/disable character consistency'));
+    }
+    // Validate useWorldKnowledge parameter
+    if (params.useWorldKnowledge !== undefined && typeof params.useWorldKnowledge !== 'boolean') {
+        return Err(new InputValidationError('useWorldKnowledge must be a boolean value', 'Use true or false for useWorldKnowledge parameter to enable/disable world knowledge integration'));
+    }
+    // Validate mutual exclusivity of image input methods
+    const imageInputCount = [
+        params.inputImagePath,
+        params.inputImage,
+        params.inputImages,
+        params.inputImagePaths,
+    ].filter(Boolean).length;
+    if (imageInputCount > 1) {
+        return Err(new InputValidationError('Only one image input method can be used at a time: inputImagePath, inputImage, inputImages, or inputImagePaths', 'Choose one: inputImagePath (single file), inputImage (single base64), inputImagePaths (multiple files), or inputImages (multiple base64)'));
+    }
+    // Validate inputImages array if provided
+    if (params.inputImages) {
+        const imagesResult = validateBase64Images(params.inputImages);
+        if (!imagesResult.success) {
+            return Err(imagesResult.error);
+        }
+    }
+    // Validate inputImagePaths array if provided
+    if (params.inputImagePaths) {
+        const pathsResult = validateImagePaths(params.inputImagePaths);
+        if (!pathsResult.success) {
+            return Err(pathsResult.error);
+        }
+    }
+    // Validate input image data if provided
+    if (params.inputImage || params.inputImageMimeType) {
+        const imageResult = validateBase64Image(params.inputImage, params.inputImageMimeType);
+        if (!imageResult.success) {
+            return Err(imageResult.error);
+        }
+    }
+    // Validate aspectRatio parameter
+    if (params.aspectRatio && !SUPPORTED_ASPECT_RATIOS.includes(params.aspectRatio)) {
+        return Err(new InputValidationError(`Invalid aspect ratio: ${params.aspectRatio}. Supported values: ${SUPPORTED_ASPECT_RATIOS.join(', ')}`, `Please use one of the supported aspect ratios: ${SUPPORTED_ASPECT_RATIOS.join(', ')}`));
+    }
+    // Validate quality parameter
+    if (params.quality !== undefined && !SUPPORTED_QUALITY_VALUES.includes(params.quality)) {
+        return Err(new InputValidationError(`Invalid quality value: "${params.quality}". Supported values: ${SUPPORTED_QUALITY_VALUES.join(', ')}`, `Please use one of the supported quality values: ${SUPPORTED_QUALITY_VALUES.join(', ')}`));
+    }
+    return Ok(params);
+}
+//# sourceMappingURL=inputValidator.js.map

package/dist/business/inputValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputValidator.js","sourceRoot":"","sources":["../../src/business/inputValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEzD,kCAAkC;AAClC,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAC3B,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAC9B,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA,CAAC,gBAAgB;AACxD,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;AAChG,MAAM,uBAAuB,GAA2B;IACtD,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAA;AAEV,MAAM,wBAAwB,GAAG,oBAAoB,CAAA;AAErD;;GAEG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAC3E,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,0BAA0B,iBAAiB,QAAQ,iBAAiB,gCAAgC,MAAM,CAAC,MAAM,EAAE,EACnH,MAAM,CAAC,MAAM,KAAK,CAAC;YACjB,CAAC,CAAC,2DAA2D;YAC7D,CAAC,CAAC,iCAAiC,MAAM,CAAC,MAAM,GAAG,iBAAiB,cAAc,CACrF,CACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAkB,EAClB,QAAiB;IAEjB,6DAA6D;IAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IAED,iCAAiC;IACjC,IAAI,QAAQ,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,0BAA0B,QAAQ,sBAAsB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACzF,yDAAyD,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CACF,CAAA;IACH,CAAC;IAED,6BAA6B;IAC7B,oCAAoC;IACpC,MAAM,WAAW,GAAG,wBAAwB,CAAA;IAC5C,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAA;IAExE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,uBAAuB,EACvB,oDAAoD,CACrD,CACF,CAAA;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QAE3C,IAAI,MAAM,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAC9C,MAAM,SAAS,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;YAChD,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,sBAAsB,SAAS,2BAA2B,QAAQ,IAAI,EACtE,qEAAqE,SAAS,IAAI,CACnF,CACF,CAAA;QACH,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,+BAA+B,EAC/B,oDAAoD,CACrD,CACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAiD;IAEjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,qCAAqC,EACrC,qDAAqD,CACtD,CACF,CAAA;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,CAAC,GAAG;YAAE,SAAQ;QAClB,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,eAAe,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAC5C,MAAM,CAAC,KAAK,CAAC,UAAU,CACxB,CACF,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAe;IAEf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,yCAAyC,EACzC,6DAA6D,CAC9D,CACF,CAAA;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,mBAAmB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAChD,MAAM,CAAC,KAAK,CAAC,UAAU,CACxB,CACF,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAkB;IAElB,uDAAuD;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,+BAA+B,SAAS,EAAE,EAC1C,gEAAgE,CACjE,CACF,CAAA;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAA;IAC5C,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,6BAA6B,GAAG,wBAAwB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACxF,yDAAyD,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1F,CACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,CAAC,SAAS,CAAC,CAAA;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAA2B;IAE3B,kBAAkB;IAClB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAClD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAChE,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAChF,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,qCAAqC,EACrC,oFAAoF,CACrF,CACF,CAAA;IACH,CAAC;IAED,kDAAkD;IAClD,IACE,MAAM,CAAC,4BAA4B,KAAK,SAAS;QACjD,OAAO,MAAM,CAAC,4BAA4B,KAAK,SAAS,EACxD,CAAC;QACD,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,sDAAsD,EACtD,sGAAsG,CACvG,CACF,CAAA;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC5F,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,2CAA2C,EAC3C,iGAAiG,CAClG,CACF,CAAA;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,eAAe,GAAG;QACtB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,UAAU;QACjB,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,eAAe;KACvB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAA;IACxB,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,gHAAgH,EAChH,0IAA0I,CAC3I,CACF,CAAA;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QAC7D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QAC9D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACrF,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAChF,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,yBAAyB,MAAM,CAAC,WAAW,uBAAuB,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtG,kDAAkD,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvF,CACF,CAAA;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvF,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,2BAA2B,MAAM,CAAC,OAAO,wBAAwB,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtG,mDAAmD,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;AACnB,CAAC"}

package/dist/business/responseBuilder.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Response Builder for MCP structured content responses
+ * Converts generation results and errors into MCP-compatible response format
+ */
+import type { GeneratedImageResult } from '../api/geminiClient.js';
+import type { McpToolResponse } from '../types/mcp.js';
+import { type BaseError } from '../utils/errors.js';
+/**
+ * Interface for response builder functionality
+ */
+export interface ResponseBuilder {
+    buildSuccessResponse(generationResult: GeneratedImageResult, filePath: string): McpToolResponse;
+    buildBase64SuccessResponse(generationResult: GeneratedImageResult, filePath: string, base64Data: string): McpToolResponse;
+    buildErrorResponse(error: BaseError | Error): McpToolResponse;
+}
+/**
+ * Creates a response builder with MCP structured content support
+ * @returns ResponseBuilder implementation
+ */
+export declare function createResponseBuilder(): ResponseBuilder;
+//# sourceMappingURL=responseBuilder.d.ts.map

package/dist/business/responseBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseBuilder.d.ts","sourceRoot":"","sources":["../../src/business/responseBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,iBAAiB,CAAA;AACzE,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,oBAAoB,CAAA;AAmB3B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;IAC/F,0BAA0B,CACxB,gBAAgB,EAAE,oBAAoB,EACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAA;IAClB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,eAAe,CAAA;CAC9D;AA+DD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CA0GvD"}

package/dist/business/responseBuilder.js

@@ -0,0 +1,166 @@
+/**
+ * Response Builder for MCP structured content responses
+ * Converts generation results and errors into MCP-compatible response format
+ */
+import * as path from 'node:path';
+import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, SecurityError, } from '../utils/errors.js';
+// Constants for MIME types and error handling
+const MIME_TYPES = {
+    PNG: 'image/png',
+    JPEG: 'image/jpeg',
+    WEBP: 'image/webp',
+};
+const FILE_EXTENSIONS = {
+    PNG: ['.png'],
+    JPEG: ['.jpg', '.jpeg'],
+    WEBP: ['.webp'],
+};
+const DEFAULT_MIME_TYPE = MIME_TYPES.PNG;
+const UNKNOWN_ERROR_CODE = 'UNKNOWN_ERROR';
+const DEFAULT_ERROR_SUGGESTION = 'Please try again or contact support if the problem persists';
+/**
+ * Determines MIME type based on file extension
+ * @param filePath Path to the image file
+ * @returns MIME type string
+ */
+function getMimeTypeFromPath(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (FILE_EXTENSIONS.PNG.includes(ext)) {
+        return MIME_TYPES.PNG;
+    }
+    if (FILE_EXTENSIONS.JPEG.includes(ext)) {
+        return MIME_TYPES.JPEG;
+    }
+    if (FILE_EXTENSIONS.WEBP.includes(ext)) {
+        return MIME_TYPES.WEBP;
+    }
+    return DEFAULT_MIME_TYPE;
+}
+/**
+ * Converts various error types to structured error format
+ * @param error Error to convert
+ * @returns Structured error object
+ */
+function convertErrorToStructured(error) {
+    const baseError = {
+        timestamp: new Date().toISOString(),
+    };
+    if (error instanceof InputValidationError ||
+        error instanceof FileOperationError ||
+        error instanceof GeminiAPIError ||
+        error instanceof NetworkError ||
+        error instanceof ConfigError ||
+        error instanceof SecurityError) {
+        return {
+            ...baseError,
+            code: error.code,
+            message: error.message,
+            suggestion: error.suggestion,
+        };
+    }
+    // Handle unknown errors
+    return {
+        ...baseError,
+        code: UNKNOWN_ERROR_CODE,
+        message: error.message || 'An unknown error occurred',
+        suggestion: DEFAULT_ERROR_SUGGESTION,
+    };
+}
+/**
+ * Creates a response builder with MCP structured content support
+ * @returns ResponseBuilder implementation
+ */
+export function createResponseBuilder() {
+    return {
+        /**
+         * Builds a successful structured content response with file path
+         * @param generationResult Result from image generation
+         * @param filePath Absolute path to the saved image file (required)
+         * @returns MCP tool response with structured content containing file path
+         */
+        buildSuccessResponse(generationResult, filePath) {
+            // File-based implementation: Always return file path, never base64
+            // This avoids MCP token limit issues (25,000 tokens max)
+            const mimeType = getMimeTypeFromPath(filePath);
+            const fileName = path.basename(filePath);
+            const structuredContent = {
+                type: 'resource',
+                resource: {
+                    uri: `file://${filePath}`,
+                    name: fileName,
+                    mimeType,
+                },
+                metadata: {
+                    model: generationResult.metadata.model,
+                    processingTime: 0, // Not tracked in simplified version
+                    contextMethod: 'structured_prompt',
+                    timestamp: generationResult.metadata.timestamp.toISOString(),
+                },
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(structuredContent),
+                    },
+                ],
+                isError: false,
+            };
+        },
+        /**
+         * Builds a successful response that includes base64 image data alongside file path
+         * @param generationResult Result from image generation
+         * @param filePath Absolute path to the saved image file
+         * @param base64Data Base64 encoded image data
+         * @returns MCP tool response with both file URI and base64 data
+         */
+        buildBase64SuccessResponse(generationResult, filePath, base64Data) {
+            const mimeType = getMimeTypeFromPath(filePath);
+            const fileName = path.basename(filePath);
+            const responseData = {
+                type: 'resource',
+                resource: {
+                    uri: `file://${filePath}`,
+                    name: fileName,
+                    mimeType,
+                },
+                base64Data,
+                metadata: {
+                    model: generationResult.metadata.model,
+                    processingTime: 0,
+                    contextMethod: 'structured_prompt',
+                    timestamp: generationResult.metadata.timestamp.toISOString(),
+                },
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(responseData),
+                    },
+                ],
+                isError: false,
+            };
+        },
+        /**
+         * Builds an error response in structured content format
+         * @param error Error that occurred during processing
+         * @returns MCP tool response with structured error
+         */
+        buildErrorResponse(error) {
+            const structuredError = {
+                error: convertErrorToStructured(error),
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(structuredError),
+                    },
+                ],
+                isError: true,
+            };
+        },
+    };
+}
+//# sourceMappingURL=responseBuilder.js.map

package/dist/business/responseBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseBuilder.js","sourceRoot":"","sources":["../../src/business/responseBuilder.ts"],"names":[],"mappings":"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"}

package/dist/business/structuredPromptGenerator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Structured Prompt Generator
+ * Uses Gemini Flash to generate optimized prompts for image generation
+ * Applies 7 best practices and 3 feature perspectives through intelligent selection
+ */
+import type { GeminiTextClient } from '../api/geminiTextClient.js';
+import type { Result } from '../types/result.js';
+/**
+ * Feature flags for image generation
+ */
+export interface FeatureFlags {
+    maintainCharacterConsistency?: boolean;
+    blendImages?: boolean;
+    useWorldKnowledge?: boolean;
+    useGoogleSearch?: boolean;
+}
+/**
+ * Result of structured prompt generation
+ */
+export interface StructuredPromptResult {
+    originalPrompt: string;
+    structuredPrompt: string;
+    selectedPractices: string[];
+}
+/**
+ * Interface for structured prompt generation
+ */
+export interface StructuredPromptGenerator {
+    generateStructuredPrompt(userPrompt: string, features?: FeatureFlags, inputImageData?: string, // Optional base64-encoded image for context
+    purpose?: string): Promise<Result<StructuredPromptResult, Error>>;
+}
+/**
+ * Implementation of StructuredPromptGenerator using Gemini Flash
+ */
+export declare class StructuredPromptGeneratorImpl implements StructuredPromptGenerator {
+    private readonly geminiTextClient;
+    constructor(geminiTextClient: GeminiTextClient);
+    generateStructuredPrompt(userPrompt: string, features?: FeatureFlags, inputImageData?: string, purpose?: string): Promise<Result<StructuredPromptResult, Error>>;
+    /**
+     * Build complete prompt with all optimization context
+     */
+    private buildCompletePrompt;
+    /**
+     * Build enhanced feature context based on flags with explicit requirements
+     */
+    private buildEnhancedFeatureContext;
+    /**
+     * Infer which best practices were selected based on the generated prompt
+     */
+    private inferSelectedPractices;
+}
+/**
+ * Factory function to create StructuredPromptGenerator
+ */
+export declare function createStructuredPromptGenerator(geminiTextClient: GeminiTextClient): StructuredPromptGenerator;
+//# sourceMappingURL=structuredPromptGenerator.d.ts.map

package/dist/business/structuredPromptGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredPromptGenerator.d.ts","sourceRoot":"","sources":["../../src/business/structuredPromptGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AA+ChD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wBAAwB,CACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EAAE,4CAA4C;IACrE,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,qBAAa,6BAA8B,YAAW,yBAAyB;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAEzD,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,YAAiB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAgDjD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA4BnC;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAkF/B;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,gBAAgB,GACjC,yBAAyB,CAE3B"}