mcp-image 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,13 @@ A powerful MCP (Model Context Protocol) server that enables AI assistants to gen
 ## ✨ Features
 
 - **AI-Powered Image Generation**: Create images from text prompts using Gemini 2.5 Flash Image Preview
+- **Intelligent Prompt Enhancement**: Automatically optimizes your prompts using Gemini 2.0 Flash for superior image quality
+  - Adds photographic and artistic details
+  - Enriches lighting, composition, and atmosphere descriptions
+  - Preserves your intent while maximizing generation quality
 - **Image Editing**: Transform existing images with natural language instructions
+  - Context-aware editing that preserves original style
+  - Maintains visual consistency with source image
 - **Advanced Options**: 
   - Multi-image blending for composite scenes
   - Character consistency across generations
@@ -36,19 +42,19 @@ claude mcp add mcp-image --env GEMINI_API_KEY=your-api-key --env IMAGE_OUTPUT_DI
 
 #### For Cursor
 
-Add to your Cursor settings (`~/.cursor/mcp.json`):
+Add to your Cursor settings:
+- **Global** (all projects): `~/.cursor/mcp.json`
+- **Project-specific**: `.cursor/mcp.json` in your project root
 
 ```json
 {
-  "mcp": {
-    "servers": {
-      "mcp-image": {
-        "command": "npx",
-        "args": ["-y", "mcp-image"],
-        "env": {
-          "GEMINI_API_KEY": "your_gemini_api_key_here",
-          "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
-        }
+  "mcpServers": {
+    "mcp-image": {
+      "command": "npx",
+      "args": ["-y", "mcp-image"],
+      "env": {
+        "GEMINI_API_KEY": "your_gemini_api_key_here",
+        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
       }
     }
   }
@@ -62,6 +68,18 @@ Add to your Cursor settings (`~/.cursor/mcp.json`):
 - Defaults to `./output` in the current working directory if not specified
 - Directory will be created automatically if it doesn't exist
 
+### Optional: Skip Prompt Enhancement
+
+Set `SKIP_PROMPT_ENHANCEMENT=true` to disable automatic prompt optimization and send your prompts directly to the image generator. Useful when you need full control over the exact prompt wording.
+
+**Claude Code:**
+```bash
+claude mcp add mcp-image --env GEMINI_API_KEY=your-api-key --env SKIP_PROMPT_ENHANCEMENT=true -- npx -y mcp-image
+```
+
+**Cursor:**
+Add `"SKIP_PROMPT_ENHANCEMENT": "true"` to the env section in your config.
+
 ## 📖 Usage Examples
 
 Once configured, your AI assistant can generate images using natural language:
@@ -72,6 +90,8 @@ Once configured, your AI assistant can generate images using natural language:
 "Generate a serene mountain landscape at sunset with a lake reflection"
 ```
 
+The system automatically enhances this to include rich details about lighting, materials, composition, and atmosphere for optimal results.
+
 ### Image Editing
 
 ```
@@ -79,7 +99,6 @@ Once configured, your AI assistant can generate images using natural language:
 (with inputImagePath: "/path/to/image.jpg")
 ```
 
-
 ### Advanced Features
 
 ```
@@ -91,7 +110,9 @@ Once configured, your AI assistant can generate images using natural language:
 
 ### `generate_image` Tool
 
-The MCP server exposes a single tool for all image operations:
+The MCP server exposes a single tool for all image operations. Internally, it uses a two-stage process:
+1. **Prompt Optimization**: Gemini 2.0 Flash analyzes and enriches your prompt
+2. **Image Generation**: Gemini 2.5 Flash Image Preview creates the final image
 
 #### Parameters
 
@@ -142,17 +163,20 @@ The MCP server exposes a single tool for all image operations:
 
 ### Performance Tips
 
-- Image generation: 30-60 seconds typical
-- Image editing: 15-45 seconds typical  
-- Use specific, descriptive prompts for better results
+- Image generation: 30-60 seconds typical (includes prompt optimization)
+- Image editing: 15-45 seconds typical (includes context analysis)
+- Simple prompts work great - the AI automatically adds professional details
+- Complex prompts are preserved and further enhanced
 - Consider enabling `useWorldKnowledge` for historical or factual subjects
 
-
 ## 💰 Usage Notes
 
-- This MCP server uses the paid Gemini API for image generation
+- This MCP server uses the paid Gemini API for both prompt optimization and image generation
+  - Gemini 2.0 Flash for intelligent prompt enhancement (minimal token usage)
+  - Gemini 2.5 Flash Image Preview for actual image generation
 - Check current pricing and rate limits at [Google AI Studio](https://aistudio.google.com/)
 - Monitor your API usage to avoid unexpected charges
+- The prompt optimization step adds minimal cost while significantly improving output quality
 
 ## 📄 License
 

package/dist/api/geminiClient.d.ts

@@ -15,23 +15,13 @@ export interface GeminiGenerationMetadata {
     mimeType: string;
     timestamp: Date;
     inputImageProvided: boolean;
-    contextMethod: string;
-    /** Features usage metadata */
-    features?: {
-        blendImages: boolean;
-        maintainCharacterConsistency: boolean;
-        useWorldKnowledge: boolean;
-    };
 }
 /**
- * Parameters for Gemini API image generation (with processed data)
+ * Parameters for Gemini API image generation
  */
 export interface GeminiApiParams {
     prompt: string;
-    inputImage?: Buffer;
-    blendImages?: boolean;
-    maintainCharacterConsistency?: boolean;
-    useWorldKnowledge?: boolean;
+    inputImage?: string;
 }
 /**
  * Result of image generation

package/dist/api/geminiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geminiClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAiD9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,OAAO,CAAA;QACpB,4BAA4B,EAAE,OAAO,CAAA;QACrC,iBAAiB,EAAE,OAAO,CAAA;KAC3B,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,wBAAwB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,CACX,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CACxE;AAwPD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAevF"}
+{"version":3,"file":"geminiClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AA2C9D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,wBAAwB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,CACX,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CACxE;AAkND;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAevF"}

package/dist/api/geminiClient.js

@@ -9,10 +9,6 @@ exports.createGeminiClient = createGeminiClient;
 const genai_1 = require("@google/genai");
 const result_1 = require("../types/result");
 const errors_1 = require("../utils/errors");
-/**
- * URL pattern for automatic URL detection
- */
-const URL_PATTERN = /https?:\/\/(?:[-\w.])+(?:\.[a-zA-Z]{2,})+(?:\/[-\w._~:\/?#[\]@!$&'()*+,;=]*)?/g;
 /**
  * Implementation of Gemini API client
  */
@@ -23,44 +19,39 @@ class GeminiClientImpl {
     }
     async generateImage(params) {
         try {
-            // Enhance prompt with structured parameters for better accuracy
-            let enhancedPrompt = params.prompt;
-            // Convert MCP parameters to structured prompt instructions
-            if (params.maintainCharacterConsistency) {
-                enhancedPrompt +=
-                    ' [INSTRUCTION: Maintain exact character appearance, including facial features, hairstyle, clothing, and all physical characteristics consistent throughout the image]';
-            }
-            if (params.blendImages) {
-                enhancedPrompt +=
-                    ' [INSTRUCTION: Seamlessly blend multiple visual elements into a natural, cohesive composition with smooth transitions]';
-            }
-            if (params.useWorldKnowledge) {
-                enhancedPrompt +=
-                    ' [INSTRUCTION: Apply accurate real-world knowledge including historical facts, geographical accuracy, cultural contexts, and realistic depictions]';
-            }
-            // Prepare the request content with enhanced prompt
-            const requestContent = [enhancedPrompt];
-            // Add input image if provided
+            // Prepare the request content with proper structure for multimodal input
+            const requestContent = [];
+            // Structure the contents properly for image generation/editing
             if (params.inputImage) {
+                // For image editing: provide image first, then text instructions
                 requestContent.push({
-                    inlineData: {
-                        data: params.inputImage.toString('base64'),
-                        mimeType: 'image/jpeg', // Assume JPEG for input images
-                    },
+                    parts: [
+                        {
+                            inlineData: {
+                                data: params.inputImage,
+                                mimeType: 'image/jpeg', // TODO: Dynamic MIME type support
+                            },
+                        },
+                        {
+                            text: params.prompt,
+                        },
+                    ],
                 });
             }
-            // Prepare API configuration
-            const config = {};
-            // URL detection is maintained for potential future use
-            // Note: urlContext tool has been removed as it's not supported by the model
-            this.detectUrls(params.prompt);
-            // Note: Feature parameters are now handled via prompt enhancement
-            // The Gemini API does not directly support these as config parameters
-            // Generate content using Gemini API with official URL Context support
+            else {
+                // For text-to-image: provide only text prompt
+                requestContent.push({
+                    parts: [
+                        {
+                            text: params.prompt,
+                        },
+                    ],
+                });
+            }
+            // Generate content using Gemini API (@google/genai v1.17.0+)
             const response = await this.genai.models.generateContent({
                 model: this.modelName,
                 contents: requestContent,
-                config,
             });
             // Extract image data from response
             if (!response || typeof response !== 'object') {
@@ -91,25 +82,14 @@ class GeminiClientImpl {
             // Convert base64 image data to Buffer
             const imageBuffer = Buffer.from(imagePart.inlineData.data, 'base64');
             const mimeType = imagePart.inlineData.mimeType || 'image/png';
-            // Create metadata with features information
+            // Create simplified metadata
             const metadata = {
                 model: this.modelName,
-                prompt: params.prompt, // Original prompt, not enhanced
+                prompt: params.prompt,
                 mimeType,
                 timestamp: new Date(),
                 inputImageProvided: !!params.inputImage,
-                contextMethod: 'prompt_only',
             };
-            // Add features usage information if any features are specified (including false)
-            if (params.blendImages !== undefined ||
-                params.maintainCharacterConsistency !== undefined ||
-                params.useWorldKnowledge !== undefined) {
-                metadata.features = {
-                    blendImages: params.blendImages || false,
-                    maintainCharacterConsistency: params.maintainCharacterConsistency || false,
-                    useWorldKnowledge: params.useWorldKnowledge || false,
-                };
-            }
             return (0, result_1.Ok)({
                 imageData: imageBuffer,
                 metadata,
@@ -165,14 +145,6 @@ class GeminiClientImpl {
         }
         return undefined;
     }
-    /**
-     * Detect URLs in prompt for automatic URL Context activation
-     * @param prompt The prompt text to analyze
-     * @returns True if URLs are detected, false otherwise
-     */
-    detectUrls(prompt) {
-        return URL_PATTERN.test(prompt);
-    }
 }
 /**
  * Creates a new Gemini API client

package/dist/api/geminiClient.js.map

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

package/dist/api/geminiTextClient.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Gemini Text Client for text generation using Gemini 2.0 Flash
+ * Pure API client for interacting with Google AI Studio
+ * Handles text generation without any prompt optimization logic
+ */
+import type { Result } from '../types/result';
+import type { Config } from '../utils/config';
+import { GeminiAPIError, NetworkError } from '../utils/errors';
+/**
+ * Options for text generation
+ */
+export interface GenerationConfig {
+    temperature?: number;
+    maxTokens?: number;
+    timeout?: number;
+    systemInstruction?: string;
+    inputImage?: string;
+}
+/**
+ * Interface for Gemini Text Client - pure API client
+ */
+export interface GeminiTextClient {
+    /**
+     * Generate text using Gemini 2.0 Flash API
+     * @param prompt The prompt to send to the API
+     * @param config Optional configuration for generation
+     * @returns Result containing generated text or error
+     */
+    generateText(prompt: string, config?: GenerationConfig): Promise<Result<string, GeminiAPIError | NetworkError>>;
+    /**
+     * Validate connection to Gemini 2.0 Flash API
+     * @returns Result indicating if connection is successful
+     */
+    validateConnection(): Promise<Result<boolean, GeminiAPIError | NetworkError>>;
+}
+/**
+ * Creates a new Gemini Text Client for prompt generation
+ * @param config Configuration containing API key and settings
+ * @returns Result containing the client or an error
+ */
+export declare function createGeminiTextClient(config: Config): Result<GeminiTextClient, GeminiAPIError>;
+//# sourceMappingURL=geminiTextClient.d.ts.map

package/dist/api/geminiTextClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiTextClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiTextClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;IAEzD;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CAC9E;AA8QD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAY/F"}

package/dist/api/geminiTextClient.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Gemini Text Client for text generation using Gemini 2.0 Flash
+ * Pure API client for interacting with Google AI Studio
+ * Handles text generation without any prompt optimization logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGeminiTextClient = createGeminiTextClient;
+const genai_1 = require("@google/genai");
+const result_1 = require("../types/result");
+const errors_1 = require("../utils/errors");
+/**
+ * Default configuration for text generation
+ */
+const DEFAULT_GENERATION_CONFIG = {
+    temperature: 0.7,
+    maxTokens: 8192,
+    timeout: 15000,
+};
+/**
+ * Implementation of Gemini Text Client - pure API client
+ */
+class GeminiTextClientImpl {
+    constructor(config) {
+        this.modelName = 'gemini-2.0-flash';
+        this.genai = new genai_1.GoogleGenAI({
+            apiKey: config.geminiApiKey,
+        });
+    }
+    async generateText(prompt, config = {}) {
+        // Merge with default configuration
+        const mergedConfig = {
+            ...DEFAULT_GENERATION_CONFIG,
+            ...config,
+        };
+        // Validate input
+        const validationResult = this.validatePromptInput(prompt);
+        if (!validationResult.success) {
+            return validationResult;
+        }
+        try {
+            // Call Gemini API
+            const generatedText = await this.callGeminiAPI(prompt, mergedConfig);
+            return (0, result_1.Ok)(generatedText);
+        }
+        catch (error) {
+            return this.handleError(error, 'text generation');
+        }
+    }
+    /**
+     * Call Gemini 2.0-flash API to generate text
+     */
+    async callGeminiAPI(prompt, config) {
+        try {
+            // Generate content with timeout
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('API call timeout')), config.timeout || 15000);
+            });
+            // Build contents based on whether input image is provided (multimodal support)
+            let contents;
+            if (config.inputImage) {
+                // Multimodal request: combine image and text
+                contents = [
+                    {
+                        parts: [
+                            {
+                                inlineData: {
+                                    data: config.inputImage,
+                                    mimeType: 'image/jpeg', // Assuming JPEG for simplicity; can be enhanced later
+                                },
+                            },
+                            {
+                                text: prompt,
+                            },
+                        ],
+                    },
+                ];
+            }
+            else {
+                // Text-only request
+                contents = prompt;
+            }
+            // Use the updated API structure for @google/genai v1.17.0+
+            const apiCall = this.genai.models.generateContent({
+                model: this.modelName,
+                contents,
+                ...(config.systemInstruction && { systemInstruction: config.systemInstruction }),
+                generationConfig: {
+                    temperature: config.temperature || 0.7,
+                    maxOutputTokens: config.maxTokens || 8192,
+                },
+            });
+            const response = await Promise.race([apiCall, timeoutPromise]);
+            // Extract text from response - handling both possible response structures
+            let responseText;
+            if (typeof response.text === 'string') {
+                responseText = response.text;
+            }
+            else if (response.response?.text && typeof response.response.text === 'function') {
+                responseText = response.response.text();
+            }
+            else if (response.response?.candidates?.[0]?.content?.parts?.[0]?.text) {
+                responseText = response.response.candidates[0].content.parts[0].text;
+            }
+            else {
+                throw new Error('Unable to extract text from API response');
+            }
+            if (!responseText || responseText.trim().length === 0) {
+                throw new Error('Empty response from Gemini API');
+            }
+            return responseText.trim();
+        }
+        catch (error) {
+            // Re-throw with context for proper error handling
+            throw new Error(`Gemini API call failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async validateConnection() {
+        try {
+            // Validate by checking if the models object exists
+            if (!this.genai.models) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Failed to access Gemini models', 'Check your GEMINI_API_KEY configuration'));
+            }
+            // API key validation happens during actual API calls
+            return (0, result_1.Ok)(true);
+        }
+        catch (error) {
+            return this.handleError(error, 'connection validation');
+        }
+    }
+    handleError(error, context) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        // Check for network errors
+        if (this.isNetworkError(error)) {
+            return (0, result_1.Err)(new errors_1.NetworkError(`Network error during ${context}: ${errorMessage}`, 'Check your internet connection and try again'));
+        }
+        // Check for API errors
+        if (this.isAPIError(error)) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError(`Failed during ${context}: ${errorMessage}`, this.getAPIErrorSuggestion(errorMessage)));
+        }
+        // Generic error
+        return (0, result_1.Err)(new errors_1.GeminiAPIError(`Failed during ${context}: ${errorMessage}`, 'Check your API configuration and try again'));
+    }
+    isNetworkError(error) {
+        if (error instanceof Error) {
+            const networkErrorCodes = ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND'];
+            return networkErrorCodes.some((code) => error.message.includes(code) || error.code === code);
+        }
+        return false;
+    }
+    isAPIError(error) {
+        if (error instanceof Error) {
+            const apiErrorKeywords = ['quota', 'rate limit', 'unauthorized', 'forbidden', 'api key'];
+            return apiErrorKeywords.some((keyword) => error.message.toLowerCase().includes(keyword));
+        }
+        return false;
+    }
+    getAPIErrorSuggestion(errorMessage) {
+        const lowerMessage = errorMessage.toLowerCase();
+        if (lowerMessage.includes('quota') || lowerMessage.includes('rate limit')) {
+            return 'You have exceeded your API quota or rate limit. Wait before making more requests or upgrade your plan';
+        }
+        if (lowerMessage.includes('unauthorized') || lowerMessage.includes('api key')) {
+            return 'Check that your GEMINI_API_KEY is valid and has the necessary permissions';
+        }
+        if (lowerMessage.includes('forbidden')) {
+            return 'Your API key does not have permission for this operation';
+        }
+        return 'Check your API configuration and try again';
+    }
+    /**
+     * Validate prompt input before processing
+     */
+    validatePromptInput(prompt) {
+        if (!prompt || prompt.trim().length === 0) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError('Empty prompt provided', 'Please provide a non-empty prompt for generation'));
+        }
+        if (prompt.length > 100000) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError('Prompt too long', 'Please provide a shorter prompt (under 100,000 characters)'));
+        }
+        return (0, result_1.Ok)(true);
+    }
+}
+/**
+ * Creates a new Gemini Text Client for prompt generation
+ * @param config Configuration containing API key and settings
+ * @returns Result containing the client or an error
+ */
+function createGeminiTextClient(config) {
+    try {
+        return (0, result_1.Ok)(new GeminiTextClientImpl(config));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return (0, result_1.Err)(new errors_1.GeminiAPIError(`Failed to initialize Gemini Text client: ${errorMessage}`, 'Verify your GEMINI_API_KEY is valid and the @google/genai package is properly installed'));
+    }
+}
+//# sourceMappingURL=geminiTextClient.js.map

package/dist/api/geminiTextClient.js.map

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

package/dist/business/__tests__/mocks/mcpSamplingClient.mock.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Mock implementation of MCP Sampling Client for testing
+ * Provides predictable responses for testing the orchestrator
+ */
+/**
+ * Configuration for MCP Sampling operations
+ */
+export interface MCPSamplingConfig {
+    /** Timeout in milliseconds for sampling operations */
+    timeout: number;
+    /** Maximum number of sampling attempts */
+    maxAttempts: number;
+    /** Whether to enable detailed logging */
+    enableLogging: boolean;
+}
+/**
+ * Result from MCP Sampling process
+ */
+export interface MCPSamplingResult {
+    /** The sampled and refined prompt */
+    refinedPrompt: string;
+    /** Success status of the sampling process */
+    success: boolean;
+    /** Processing time in milliseconds */
+    processingTime: number;
+    /** Additional metadata from sampling */
+    metadata: {
+        /** Model used for sampling */
+        model: string;
+        /** Number of sampling iterations performed */
+        iterations: number;
+        /** Confidence in the refined prompt */
+        confidence: number;
+    };
+}
+/**
+ * Interface for MCP Sampling Client
+ * Defines the contract for advanced prompt refinement
+ */
+export interface MCPSamplingClient {
+    /**
+     * Refine a complex prompt using MCP Sampling techniques
+     * @param prompt - The input prompt to refine
+     * @returns Promise<MCPSamplingResult> - The refined result
+     */
+    refinePrompt(prompt: string): Promise<MCPSamplingResult>;
+    /**
+     * Check if the client is properly configured and available
+     * @returns Promise<boolean> - True if client is ready
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Mock implementation of MCPSamplingClient for testing purposes
+ * Provides predictable behavior for orchestrator testing
+ */
+export declare class MockMCPSamplingClient implements MCPSamplingClient {
+    private config;
+    private mockDelay;
+    private shouldFail;
+    constructor(_config?: Partial<MCPSamplingConfig>);
+    /**
+     * Set whether the mock should simulate failures
+     */
+    setShouldFail(shouldFail: boolean): void;
+    /**
+     * Set mock response delay for testing timing scenarios
+     */
+    setMockDelay(delay: number): void;
+    /**
+     * Mock implementation of prompt refinement
+     * Returns predictable enhanced prompts for testing
+     */
+    refinePrompt(prompt: string): Promise<MCPSamplingResult>;
+    /**
+     * Mock availability check - always returns true unless configured to fail
+     */
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Factory function to create a mock MCP Sampling Client with default configuration
+ */
+export declare function createMockMCPSamplingClient(config?: Partial<MCPSamplingConfig>): MockMCPSamplingClient;
+//# sourceMappingURL=mcpSamplingClient.mock.d.ts.map

package/dist/business/__tests__/mocks/mcpSamplingClient.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpSamplingClient.mock.d.ts","sourceRoot":"","sources":["../../../../src/business/__tests__/mocks/mcpSamplingClient.mock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,QAAQ,EAAE;QACR,8BAA8B;QAC9B,KAAK,EAAE,MAAM,CAAA;QACb,8CAA8C;QAC9C,UAAU,EAAE,MAAM,CAAA;QAClB,uCAAuC;QACvC,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAExD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAWhD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAIxC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmD9D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAItC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,qBAAqB,CAEvB"}