mcp-image 0.1.0 → 0.2.0

package/dist/integration/twoStageProcessor.js

@@ -0,0 +1,348 @@
+"use strict";
+/**
+ * TwoStageProcessor - Main integration point for 2-stage processing
+ * Coordinates structured prompt generation with image generation
+ * Implements complete workflow with performance tracking and fallback strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwoStageProcessorFactory = exports.TwoStageProcessorImpl = void 0;
+const generationMetadata_1 = require("../infrastructure/metadata/generationMetadata");
+const result_1 = require("../types/result");
+const errors_1 = require("../utils/errors");
+const parameterOptimizer_1 = require("./parameterOptimizer");
+/**
+ * Default configuration for TwoStageProcessor
+ */
+const DEFAULT_OPTIONS = {
+    maxProcessingTime: 20000, // 20 seconds
+    enableParameterOptimization: true,
+    enableMetadataCollection: true,
+    fallbackStrategy: 'primary',
+    performanceTarget: 20000,
+};
+/**
+ * Implementation of TwoStageProcessor with complete workflow coordination
+ */
+class TwoStageProcessorImpl {
+    constructor(orchestrator, imageClient, options = DEFAULT_OPTIONS) {
+        this.orchestrator = orchestrator;
+        this.imageClient = imageClient;
+        this.options = options;
+        this.metadataManager = new generationMetadata_1.GenerationMetadataManager();
+        this.parameterOptimizer = new parameterOptimizer_1.ParameterOptimizerImpl();
+    }
+    /**
+     * Generate image using complete 2-stage workflow
+     */
+    async generateImageWithStructuredPrompt(request) {
+        const sessionId = this.metadataManager.createSession(request.originalPrompt);
+        // Set up timeout for the entire operation
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new errors_1.GeminiAPIError('2-stage processing timeout', `Exceeded ${this.options.maxProcessingTime}ms limit`));
+            }, this.options.maxProcessingTime);
+        });
+        try {
+            // Validate configuration before processing
+            const configValidation = await this.validateConfiguration();
+            if (!configValidation.success) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Configuration validation failed', 'Check processor setup'));
+            }
+            // Race the processing against timeout
+            const processingResult = await Promise.race([
+                this.executeProcessingWorkflow(request, sessionId),
+                timeoutPromise,
+            ]);
+            return processingResult;
+        }
+        catch (error) {
+            const apiError = error instanceof errors_1.GeminiAPIError
+                ? error
+                : new errors_1.GeminiAPIError(`2-stage processing failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            return await this.handleFallbackScenario(sessionId, request, apiError);
+        }
+    }
+    /**
+     * Execute the main processing workflow
+     */
+    async executeProcessingWorkflow(request, sessionId) {
+        const startTime = Date.now();
+        // Stage 1: Generate structured prompt
+        const stage1Result = await this.executePromptGenerationStage(sessionId, request);
+        if (!stage1Result.success) {
+            // Try fallback with original prompt - don't throw here, return the error result
+            throw stage1Result.error;
+        }
+        const orchestrationResult = stage1Result.data;
+        const structuredPrompt = orchestrationResult.structuredPrompt;
+        // Stage 2: Optimize parameters based on structured prompt
+        let optimizedParams;
+        if (this.options.enableParameterOptimization) {
+            const paramResult = await this.optimizeImageParameters(structuredPrompt, request.imageParameters || {});
+            if (!paramResult.success) {
+                // Continue with original parameters if optimization fails
+                optimizedParams = request.imageParameters || {};
+                this.metadataManager.recordOptimization(sessionId, 'parameter optimization failed - using original');
+            }
+            else {
+                optimizedParams = paramResult.data;
+                // Record all optimization reasons
+                if (optimizedParams.optimizationReasons) {
+                    for (const reason of optimizedParams.optimizationReasons) {
+                        this.metadataManager.recordOptimization(sessionId, reason);
+                    }
+                }
+            }
+        }
+        else {
+            optimizedParams = request.imageParameters || {};
+        }
+        // Stage 3: Generate image with structured prompt
+        const stage2Result = await this.executeImageGenerationStage(sessionId, structuredPrompt, optimizedParams);
+        if (!stage2Result.success) {
+            throw stage2Result.error;
+        }
+        // Compile final result
+        const processingMetadata = this.metadataManager.completeSession(sessionId);
+        if (!processingMetadata) {
+            throw new errors_1.GeminiAPIError('Failed to retrieve processing metadata');
+        }
+        const endTime = Date.now();
+        const totalTime = endTime - startTime;
+        // Performance monitoring
+        if (totalTime > this.options.performanceTarget) {
+            console.warn(`2-stage processing exceeded target: ${totalTime}ms > ${this.options.performanceTarget}ms`);
+            this.metadataManager.recordOptimization(sessionId, `performance target exceeded: ${totalTime}ms`);
+        }
+        const result = {
+            originalPrompt: request.originalPrompt,
+            structuredPrompt,
+            generatedImage: stage2Result.data,
+            processingMetadata: {
+                ...processingMetadata,
+                totalProcessingTime: totalTime,
+            },
+            optimizedParameters: optimizedParams,
+            orchestrationResult,
+            success: true,
+        };
+        return (0, result_1.Ok)(result);
+    }
+    /**
+     * Optimize image parameters based on structured prompt
+     */
+    async optimizeImageParameters(structuredPrompt, baseParams) {
+        try {
+            return await this.parameterOptimizer.optimizeForStructuredPrompt(structuredPrompt, baseParams);
+        }
+        catch (error) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError(`Parameter optimization failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'Using original parameters as fallback'));
+        }
+    }
+    /**
+     * Get processing metadata for a session
+     */
+    getProcessingMetadata(sessionId) {
+        return this.metadataManager.getSession(sessionId);
+    }
+    /**
+     * Validate processor configuration
+     */
+    async validateConfiguration() {
+        try {
+            // Validate orchestrator
+            const orchestratorValidation = await this.orchestrator.validateConfiguration();
+            if (!orchestratorValidation.success) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Orchestrator configuration invalid', 'Check orchestrator setup'));
+            }
+            // Validate required components exist
+            if (!this.orchestrator || !this.imageClient) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Required components not available', 'Initialize all dependencies'));
+            }
+            // Validate options
+            if (this.options.maxProcessingTime <= 0 || this.options.performanceTarget <= 0) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Invalid timing configuration', 'Set positive timeout values'));
+            }
+            return (0, result_1.Ok)(true);
+        }
+        catch (error) {
+            return (0, result_1.Err)(new errors_1.GeminiAPIError(`Configuration validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        }
+    }
+    /**
+     * Execute Stage 1: Structured Prompt Generation
+     */
+    async executePromptGenerationStage(sessionId, request) {
+        const stageName = 'Structured Prompt Generation';
+        this.metadataManager.recordStage(sessionId, {
+            stageName,
+            status: 'processing',
+            inputData: { originalPrompt: request.originalPrompt, options: request.orchestrationOptions },
+        });
+        try {
+            const orchestrationOptions = {
+                enablePOML: request.orchestrationOptions?.enablePOML ?? true,
+                bestPracticesMode: request.orchestrationOptions?.bestPracticesMode ?? 'complete',
+                maxProcessingTime: request.orchestrationOptions?.maxProcessingTime ?? 15000, // 15 seconds for prompt generation
+                ...request.orchestrationOptions,
+            };
+            const result = await this.orchestrator.generateStructuredPrompt(request.originalPrompt, orchestrationOptions);
+            if (result.success) {
+                this.metadataManager.completeStage(sessionId, stageName, result.data);
+                return (0, result_1.Ok)(result.data);
+            }
+            this.metadataManager.failStage(sessionId, stageName, result.error);
+            return (0, result_1.Err)(result.error);
+        }
+        catch (error) {
+            const apiError = error instanceof errors_1.GeminiAPIError
+                ? error
+                : new errors_1.GeminiAPIError(`Prompt generation stage failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            this.metadataManager.failStage(sessionId, stageName, apiError);
+            return (0, result_1.Err)(apiError);
+        }
+    }
+    /**
+     * Execute Stage 2: Image Generation
+     */
+    async executeImageGenerationStage(sessionId, structuredPrompt, optimizedParams) {
+        const stageName = 'Image Generation';
+        this.metadataManager.recordStage(sessionId, {
+            stageName,
+            status: 'processing',
+            inputData: { structuredPrompt, optimizedParams },
+        });
+        try {
+            const imageParams = {
+                prompt: structuredPrompt,
+                ...(optimizedParams.inputImage && {
+                    inputImage: optimizedParams.inputImage.toString('base64'),
+                }),
+                ...(optimizedParams.blendImages && { blendImages: optimizedParams.blendImages }),
+                ...(optimizedParams.maintainCharacterConsistency && {
+                    maintainCharacterConsistency: optimizedParams.maintainCharacterConsistency,
+                }),
+                ...(optimizedParams.useWorldKnowledge && {
+                    useWorldKnowledge: optimizedParams.useWorldKnowledge,
+                }),
+            };
+            const result = await this.imageClient.generateImage(imageParams);
+            if (result.success) {
+                this.metadataManager.completeStage(sessionId, stageName, result.data);
+                return (0, result_1.Ok)(result.data);
+            }
+            this.metadataManager.failStage(sessionId, stageName, result.error);
+            return (0, result_1.Err)(result.error);
+        }
+        catch (error) {
+            const apiError = error instanceof errors_1.NetworkError
+                ? error
+                : error instanceof errors_1.GeminiAPIError
+                    ? error
+                    : new errors_1.GeminiAPIError(`Image generation stage failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            this.metadataManager.failStage(sessionId, stageName, apiError);
+            return (0, result_1.Err)(apiError);
+        }
+    }
+    /**
+     * Handle fallback scenario when primary processing fails
+     */
+    async handleFallbackScenario(sessionId, request, error) {
+        this.metadataManager.recordFallback(sessionId);
+        const fallbackStageName = 'Fallback Image Generation';
+        this.metadataManager.recordStage(sessionId, {
+            stageName: fallbackStageName,
+            status: 'processing',
+            inputData: { originalPrompt: request.originalPrompt, fallbackReason: error.message },
+        });
+        try {
+            // Generate image with original prompt
+            const imageParams = {
+                prompt: request.originalPrompt,
+                ...(request.imageParameters?.inputImage && {
+                    inputImage: request.imageParameters.inputImage.toString('base64'),
+                }),
+                ...(request.imageParameters?.blendImages && {
+                    blendImages: request.imageParameters.blendImages,
+                }),
+                ...(request.imageParameters?.maintainCharacterConsistency && {
+                    maintainCharacterConsistency: request.imageParameters.maintainCharacterConsistency,
+                }),
+                ...(request.imageParameters?.useWorldKnowledge && {
+                    useWorldKnowledge: request.imageParameters.useWorldKnowledge,
+                }),
+            };
+            const fallbackResult = await this.imageClient.generateImage(imageParams);
+            if (!fallbackResult.success) {
+                this.metadataManager.failStage(sessionId, fallbackStageName, fallbackResult.error);
+                return (0, result_1.Err)(fallbackResult.error);
+            }
+            this.metadataManager.completeStage(sessionId, fallbackStageName, fallbackResult.data);
+            // Create mock orchestration result for fallback
+            const fallbackOrchestrationResult = {
+                originalPrompt: request.originalPrompt,
+                structuredPrompt: request.originalPrompt, // No enhancement in fallback
+                processingStages: [],
+                appliedStrategies: [
+                    {
+                        strategy: 'Fallback',
+                        applied: true,
+                        reason: 'Primary processing failed',
+                        processingTime: 0,
+                    },
+                ],
+                metrics: {
+                    totalProcessingTime: 0,
+                    stageCount: 0,
+                    successRate: 0,
+                    failureCount: 1,
+                    fallbacksUsed: 1,
+                    timestamp: new Date(),
+                },
+            };
+            const processingMetadata = this.metadataManager.completeSession(sessionId);
+            if (!processingMetadata) {
+                return (0, result_1.Err)(new errors_1.GeminiAPIError('Failed to retrieve fallback processing metadata'));
+            }
+            const fallbackResult_final = {
+                originalPrompt: request.originalPrompt,
+                structuredPrompt: request.originalPrompt,
+                generatedImage: fallbackResult.data,
+                processingMetadata,
+                optimizedParameters: request.imageParameters || {},
+                orchestrationResult: fallbackOrchestrationResult,
+                success: true, // Fallback succeeded
+            };
+            return (0, result_1.Ok)(fallbackResult_final);
+        }
+        catch (fallbackError) {
+            const apiError = fallbackError instanceof errors_1.GeminiAPIError || fallbackError instanceof errors_1.NetworkError
+                ? fallbackError
+                : new errors_1.GeminiAPIError(`Fallback processing failed: ${fallbackError instanceof Error ? fallbackError.message : 'Unknown error'}`);
+            this.metadataManager.failStage(sessionId, fallbackStageName, apiError);
+            return (0, result_1.Err)(apiError);
+        }
+    }
+}
+exports.TwoStageProcessorImpl = TwoStageProcessorImpl;
+/**
+ * Factory for creating TwoStageProcessor instances with dependency injection
+ */
+class TwoStageProcessorFactory {
+    constructor(orchestrator, imageClient) {
+        this.orchestrator = orchestrator;
+        this.imageClient = imageClient;
+    }
+    /**
+     * Create a new TwoStageProcessor instance
+     */
+    create(options) {
+        const finalOptions = {
+            ...DEFAULT_OPTIONS,
+            ...options,
+        };
+        return new TwoStageProcessorImpl(this.orchestrator, this.imageClient, finalOptions);
+    }
+}
+exports.TwoStageProcessorFactory = TwoStageProcessorFactory;
+//# sourceMappingURL=twoStageProcessor.js.map

package/dist/integration/twoStageProcessor.js.map

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

package/dist/server/handlers/structuredPromptHandler.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Structured Prompt Handler for MCP server
+ * Handles orchestration integration with progress notifications and fallback mechanisms
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { OrchestrationOptions, OrchestrationResult, StructuredPromptOrchestrator } from '../../business/promptOrchestrator';
+import type { MCPOrchestrationConfig, OrchestrationStatus } from '../../types/mcpOrchestrationTypes';
+import type { Result } from '../../types/result';
+import { GeminiAPIError } from '../../utils/errors';
+import { Logger } from '../../utils/logger';
+/**
+ * Dependencies for StructuredPromptHandler
+ */
+export interface StructuredPromptHandlerDependencies {
+    orchestrator: StructuredPromptOrchestrator;
+    logger?: Logger;
+}
+/**
+ * Structured Prompt Handler implementation
+ * Manages orchestration requests with progress notifications and error handling
+ */
+export declare class StructuredPromptHandler {
+    private orchestrator;
+    private config;
+    private status;
+    private logger;
+    constructor(orchestrator: StructuredPromptOrchestrator, initialConfig?: Partial<MCPOrchestrationConfig>, dependencies?: Pick<StructuredPromptHandlerDependencies, 'logger'>);
+    /**
+     * Process structured prompt request with orchestration
+     */
+    processStructuredPrompt(prompt: string, options?: OrchestrationOptions, server?: Server, progressToken?: string | number): Promise<Result<OrchestrationResult, GeminiAPIError>>;
+    /**
+     * Handle orchestration failure with configured fallback behavior
+     */
+    private handleOrchestrationFailure;
+    /**
+     * Send progress notification to MCP client
+     */
+    private sendProgressNotification;
+    /**
+     * Merge options with current mode configuration
+     */
+    private mergeWithModeOptions;
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<MCPOrchestrationConfig>): void;
+    /**
+     * Get current orchestration status
+     */
+    getOrchestrationStatus(): OrchestrationStatus;
+    /**
+     * Reset statistics
+     */
+    resetStatistics(): void;
+    /**
+     * Initialize orchestration status
+     */
+    private initializeStatus;
+    /**
+     * Update average processing time with new measurement
+     */
+    private updateAverageProcessingTime;
+}
+//# sourceMappingURL=structuredPromptHandler.d.ts.map

package/dist/server/handlers/structuredPromptHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredPromptHandler.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/structuredPromptHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AACvE,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EACV,sBAAsB,EAGtB,mBAAmB,EACpB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,4BAA4B,CAAA;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAMhC,OAAO,CAAC,YAAY;IALtB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAQ;gBAGZ,YAAY,EAAE,4BAA4B,EAClD,aAAa,GAAE,OAAO,CAAC,sBAAsB,CAAM,EACnD,YAAY,GAAE,IAAI,CAAC,mCAAmC,EAAE,QAAQ,CAAM;IAOxE;;OAEG;IACG,uBAAuB,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,EAClC,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;IAgIvD;;OAEG;YACW,0BAA0B;IAuFxC;;OAEG;YACW,wBAAwB;IAuBtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAK9D;;OAEG;IACH,sBAAsB,IAAI,mBAAmB;IAI7C;;OAEG;IACH,eAAe,IAAI,IAAI;IAYvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,2BAA2B;CAYpC"}