mcp-image 0.1.0 → 0.2.0

package/dist/integration/parameterOptimizer.js

@@ -0,0 +1,317 @@
+"use strict";
+/**
+ * Parameter optimizer for image generation based on structured prompts
+ * Analyzes structured prompts and optimizes image generation parameters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterOptimizerImpl = void 0;
+const result_1 = require("../types/result");
+const errors_1 = require("../utils/errors");
+/**
+ * Keywords for detecting different content types
+ */
+const CONTENT_TYPE_KEYWORDS = {
+    portrait: ['portrait', 'headshot', 'face', 'person', 'character', 'selfie'],
+    landscape: ['landscape', 'panoramic', 'vista', 'scenery', 'horizon', 'mountains', 'valley'],
+    object: ['object', 'product', 'item', 'tool', 'device', 'still life'],
+    scene: ['scene', 'environment', 'setting', 'room', 'interior', 'exterior', 'building'],
+    abstract: ['abstract', 'conceptual', 'artistic', 'pattern', 'texture', 'geometric'],
+};
+/**
+ * Keywords for detecting complexity levels
+ */
+const COMPLEXITY_KEYWORDS = {
+    simple: ['simple', 'minimal', 'clean', 'basic'],
+    complex: ['detailed', 'intricate', 'complex', 'elaborate', 'ornate', 'sophisticated'],
+};
+/**
+ * Keywords for detecting cinematic content
+ */
+const CINEMATIC_KEYWORDS = [
+    'cinematic',
+    'wide-angle',
+    'dramatic',
+    'professional photography',
+    'film',
+    'movie',
+    'camera angle',
+    'shot',
+    'lighting',
+    'composition',
+];
+/**
+ * Keywords for detecting character features
+ */
+const CHARACTER_KEYWORDS = [
+    'eyes',
+    'hair',
+    'face',
+    'facial features',
+    'expression',
+    'character',
+    'person',
+];
+/**
+ * Implementation of parameter optimization based on structured prompt analysis
+ */
+class ParameterOptimizerImpl {
+    /**
+     * Optimize parameters based on structured prompt analysis
+     */
+    async optimizeForStructuredPrompt(structuredPrompt, baseParams) {
+        try {
+            const characteristics = this.analyzePromptCharacteristics(structuredPrompt);
+            const optimizationReasons = [];
+            // Start with base parameters
+            const optimized = {
+                ...baseParams,
+                optimizationReasons,
+            };
+            // Optimize aspect ratio based on content type
+            if (!baseParams.aspectRatio ||
+                this.shouldOptimizeAspectRatio(characteristics, baseParams.aspectRatio)) {
+                optimized.aspectRatio = characteristics.suggestedAspectRatio;
+                optimizationReasons.push(`aspect ratio optimized for ${characteristics.contentType} content`);
+            }
+            else {
+                optimizationReasons.push('aspect ratio preserved - appropriate for content');
+            }
+            // Optimize quality based on complexity and content requirements
+            if (this.shouldUpgradeQuality(characteristics, baseParams.quality)) {
+                optimized.quality = characteristics.suggestedQuality;
+                optimizationReasons.push(`quality upgraded for ${characteristics.complexity} content`);
+            }
+            // Optimize style based on prompt analysis
+            // Only change style if no style was specified in baseParams
+            if (baseParams.style) {
+                // Keep the explicitly provided style
+                optimized.style = baseParams.style;
+                optimizationReasons.push('style preserved - explicitly provided');
+            }
+            else if (this.shouldOptimizeStyle(characteristics, baseParams.style)) {
+                optimized.style = characteristics.suggestedStyle;
+                optimizationReasons.push('style optimized for detected content characteristics');
+            }
+            // Apply feature recommendations
+            if (characteristics.recommendedFeatures.maintainCharacterConsistency &&
+                !baseParams.maintainCharacterConsistency) {
+                optimized.maintainCharacterConsistency = true;
+                optimizationReasons.push('character features detected - enabled consistency maintenance');
+            }
+            if (characteristics.recommendedFeatures.blendImages && !baseParams.blendImages) {
+                optimized.blendImages = true;
+                optimizationReasons.push('multiple elements detected - enabled blending');
+            }
+            if (characteristics.recommendedFeatures.useWorldKnowledge && !baseParams.useWorldKnowledge) {
+                optimized.useWorldKnowledge = true;
+                optimizationReasons.push('world knowledge requirements detected');
+            }
+            // Add cinematic optimization if detected
+            if (this.detectsCinematicContent(structuredPrompt)) {
+                optimizationReasons.push('cinematic composition detected');
+                if (optimized.aspectRatio === '1:1') {
+                    optimized.aspectRatio = '16:9';
+                    optimizationReasons.push('aspect ratio adjusted for cinematic content');
+                }
+            }
+            // Add macro photography detection
+            if (this.detectsMacroContent(structuredPrompt)) {
+                optimized.quality = 'high';
+                optimized.style = 'enhanced';
+                optimizationReasons.push('macro photography detected - enhanced quality and detail');
+            }
+            return (0, result_1.Ok)(optimized);
+        }
+        catch (error) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError(`Parameter optimization failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'Check prompt format and try again'));
+        }
+    }
+    /**
+     * Analyze prompt characteristics for optimization
+     */
+    analyzePromptCharacteristics(prompt) {
+        const lowerPrompt = prompt.toLowerCase();
+        // Detect content type
+        const contentType = this.detectContentType(lowerPrompt);
+        // Detect complexity
+        const complexity = this.detectComplexity(lowerPrompt);
+        // Generate suggestions based on analysis
+        const suggestedAspectRatio = this.suggestAspectRatio(contentType, lowerPrompt);
+        const suggestedQuality = this.suggestQuality(complexity, lowerPrompt);
+        const suggestedStyle = this.suggestStyle(lowerPrompt);
+        // Extract detected elements
+        const detectedElements = this.extractElements(lowerPrompt);
+        // Recommend features based on content
+        const recommendedFeatures = this.recommendFeatures(lowerPrompt);
+        return {
+            complexity,
+            contentType,
+            suggestedAspectRatio,
+            suggestedQuality,
+            suggestedStyle,
+            detectedElements,
+            recommendedFeatures,
+        };
+    }
+    /**
+     * Detect content type from prompt
+     */
+    detectContentType(prompt) {
+        for (const [type, keywords] of Object.entries(CONTENT_TYPE_KEYWORDS)) {
+            if (keywords.some((keyword) => prompt.includes(keyword))) {
+                return type;
+            }
+        }
+        return 'scene'; // Default fallback
+    }
+    /**
+     * Detect complexity level
+     */
+    detectComplexity(prompt) {
+        const simpleScore = COMPLEXITY_KEYWORDS.simple.filter((keyword) => prompt.includes(keyword)).length;
+        const complexScore = COMPLEXITY_KEYWORDS.complex.filter((keyword) => prompt.includes(keyword)).length;
+        if (complexScore > simpleScore)
+            return 'complex';
+        if (simpleScore > complexScore)
+            return 'simple';
+        return 'medium';
+    }
+    /**
+     * Suggest optimal aspect ratio based on content type
+     */
+    suggestAspectRatio(contentType, prompt) {
+        // Check for specific aspect ratio hints in prompt
+        if (prompt.includes('panoramic') || prompt.includes('wide'))
+            return '21:9';
+        if (prompt.includes('cinematic'))
+            return '16:9';
+        if (prompt.includes('square') || prompt.includes('instagram'))
+            return '1:1';
+        // Default based on content type
+        switch (contentType) {
+            case 'portrait':
+                return '3:4';
+            case 'landscape':
+                return '16:9';
+            case 'object':
+                return '1:1';
+            case 'scene':
+                return '16:9';
+            case 'abstract':
+                return '1:1';
+            default:
+                return '16:9';
+        }
+    }
+    /**
+     * Suggest quality level based on complexity and requirements
+     */
+    suggestQuality(complexity, prompt) {
+        if (prompt.includes('high detail') ||
+            prompt.includes('professional') ||
+            prompt.includes('macro')) {
+            return 'high';
+        }
+        if (prompt.includes('sketch') || prompt.includes('rough') || prompt.includes('simple')) {
+            return 'medium';
+        }
+        return complexity === 'complex' ? 'high' : 'medium';
+    }
+    /**
+     * Suggest style based on prompt content
+     */
+    suggestStyle(prompt) {
+        if (prompt.includes('artistic') || prompt.includes('creative') || prompt.includes('stylized')) {
+            return 'artistic';
+        }
+        if (prompt.includes('enhanced') ||
+            prompt.includes('detailed') ||
+            prompt.includes('professional')) {
+            return 'enhanced';
+        }
+        return 'natural';
+    }
+    /**
+     * Extract key elements from prompt
+     */
+    extractElements(prompt) {
+        const elements = [];
+        // Simple element extraction - can be enhanced with NLP
+        const elementPatterns = [
+            /\b(lighting|light)\b/g,
+            /\b(color|colours?)\b/g,
+            /\b(texture|textures?)\b/g,
+            /\b(composition)\b/g,
+            /\b(atmosphere|mood)\b/g,
+            /\b(details?)\b/g,
+        ];
+        for (const pattern of elementPatterns) {
+            const matches = prompt.match(pattern);
+            if (matches) {
+                elements.push(...matches);
+            }
+        }
+        return [...new Set(elements)]; // Remove duplicates
+    }
+    /**
+     * Recommend features based on prompt analysis
+     */
+    recommendFeatures(prompt) {
+        return {
+            blendImages: prompt.includes('blend') || prompt.includes('combine') || prompt.includes('merge'),
+            maintainCharacterConsistency: CHARACTER_KEYWORDS.some((keyword) => prompt.includes(keyword)),
+            useWorldKnowledge: prompt.includes('historical') || prompt.includes('real') || prompt.includes('accurate'),
+        };
+    }
+    /**
+     * Check if aspect ratio should be optimized
+     */
+    shouldOptimizeAspectRatio(characteristics, currentRatio) {
+        if (!currentRatio)
+            return true;
+        // Don't optimize if current ratio matches suggestion
+        if (currentRatio === characteristics.suggestedAspectRatio)
+            return false;
+        // Optimize if current ratio is clearly inappropriate for content type
+        if (characteristics.contentType === 'portrait' &&
+            (currentRatio === '16:9' || currentRatio === '21:9')) {
+            return true;
+        }
+        if (characteristics.contentType === 'landscape' && currentRatio === '3:4') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Check if quality should be upgraded
+     */
+    shouldUpgradeQuality(characteristics, currentQuality) {
+        return (characteristics.suggestedQuality === 'high' &&
+            (currentQuality === 'low' || currentQuality === 'medium'));
+    }
+    /**
+     * Check if style should be optimized
+     */
+    shouldOptimizeStyle(characteristics, currentStyle) {
+        return !currentStyle || currentStyle !== characteristics.suggestedStyle;
+    }
+    /**
+     * Detect cinematic content
+     */
+    detectsCinematicContent(prompt) {
+        const lowerPrompt = prompt.toLowerCase();
+        return CINEMATIC_KEYWORDS.some((keyword) => lowerPrompt.includes(keyword));
+    }
+    /**
+     * Detect macro photography content
+     */
+    detectsMacroContent(prompt) {
+        const lowerPrompt = prompt.toLowerCase();
+        return (lowerPrompt.includes('macro') ||
+            lowerPrompt.includes('close-up') ||
+            lowerPrompt.includes('extreme close-up') ||
+            lowerPrompt.includes('detailed texture'));
+    }
+}
+exports.ParameterOptimizerImpl = ParameterOptimizerImpl;
+//# sourceMappingURL=parameterOptimizer.js.map

package/dist/integration/parameterOptimizer.js.map

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

package/dist/integration/twoStageProcessor.d.ts

@@ -0,0 +1,66 @@
+/**
+ * TwoStageProcessor - Main integration point for 2-stage processing
+ * Coordinates structured prompt generation with image generation
+ * Implements complete workflow with performance tracking and fallback strategies
+ */
+import type { GeminiClient } from '../api/geminiClient';
+import type { StructuredPromptOrchestrator } from '../business/promptOrchestrator';
+import type { Result } from '../types/result';
+import type { ImageGenerationRequest, ImageParameters, OptimizedParameters, ProcessingMetadata, TwoStageProcessor, TwoStageProcessorOptions, TwoStageResult } from '../types/twoStageTypes';
+import { GeminiAPIError, NetworkError } from '../utils/errors';
+/**
+ * Implementation of TwoStageProcessor with complete workflow coordination
+ */
+export declare class TwoStageProcessorImpl implements TwoStageProcessor {
+    private orchestrator;
+    private imageClient;
+    private options;
+    private metadataManager;
+    private parameterOptimizer;
+    constructor(orchestrator: StructuredPromptOrchestrator, imageClient: GeminiClient, options?: TwoStageProcessorOptions);
+    /**
+     * Generate image using complete 2-stage workflow
+     */
+    generateImageWithStructuredPrompt(request: ImageGenerationRequest): Promise<Result<TwoStageResult, GeminiAPIError | NetworkError>>;
+    /**
+     * Execute the main processing workflow
+     */
+    private executeProcessingWorkflow;
+    /**
+     * Optimize image parameters based on structured prompt
+     */
+    optimizeImageParameters(structuredPrompt: string, baseParams: ImageParameters): Promise<Result<OptimizedParameters, GeminiAPIError>>;
+    /**
+     * Get processing metadata for a session
+     */
+    getProcessingMetadata(sessionId: string): ProcessingMetadata | undefined;
+    /**
+     * Validate processor configuration
+     */
+    validateConfiguration(): Promise<Result<boolean, GeminiAPIError>>;
+    /**
+     * Execute Stage 1: Structured Prompt Generation
+     */
+    private executePromptGenerationStage;
+    /**
+     * Execute Stage 2: Image Generation
+     */
+    private executeImageGenerationStage;
+    /**
+     * Handle fallback scenario when primary processing fails
+     */
+    private handleFallbackScenario;
+}
+/**
+ * Factory for creating TwoStageProcessor instances with dependency injection
+ */
+export declare class TwoStageProcessorFactory {
+    private orchestrator;
+    private imageClient;
+    constructor(orchestrator: StructuredPromptOrchestrator, imageClient: GeminiClient);
+    /**
+     * Create a new TwoStageProcessor instance
+     */
+    create(options?: Partial<TwoStageProcessorOptions>): TwoStageProcessor;
+}
+//# sourceMappingURL=twoStageProcessor.d.ts.map

package/dist/integration/twoStageProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twoStageProcessor.d.ts","sourceRoot":"","sources":["../../src/integration/twoStageProcessor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,KAAK,EAGV,4BAA4B,EAC7B,MAAM,gCAAgC,CAAA;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EAEnB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAc9D;;GAEG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAK3D,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,kBAAkB,CAAoB;gBAGpC,YAAY,EAAE,4BAA4B,EAC1C,WAAW,EAAE,YAAY,EACzB,OAAO,GAAE,wBAA0C;IAM7D;;OAEG;IACG,iCAAiC,CACrC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;IAyCjE;;OAEG;YACW,yBAAyB;IAyFvC;;OAEG;IACG,uBAAuB,CAC3B,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;IAavD;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIxE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAkCvE;;OAEG;YACW,4BAA4B;IA2C1C;;OAEG;YACW,2BAA2B;IAoDzC;;OAEG;YACW,sBAAsB;CA4FrC;AAED;;GAEG;AACH,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;gBADX,YAAY,EAAE,4BAA4B,EAC1C,WAAW,EAAE,YAAY;IAGnC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,iBAAiB;CAQvE"}