mcp-image 0.1.0 → 0.2.0

package/dist/business/__tests__/mocks/mcpSamplingClient.mock.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Mock implementation of MCP Sampling Client for testing
+ * Provides predictable responses for testing the orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockMCPSamplingClient = void 0;
+exports.createMockMCPSamplingClient = createMockMCPSamplingClient;
+/**
+ * Mock implementation of MCPSamplingClient for testing purposes
+ * Provides predictable behavior for orchestrator testing
+ */
+class MockMCPSamplingClient {
+    constructor(_config) {
+        this.config = {
+            timeout: 5000,
+            maxAttempts: 3,
+            enableLogging: false,
+            ..._config,
+        };
+        this.mockDelay = 100; // Fast response for testing
+        this.shouldFail = false;
+    }
+    /**
+     * Set whether the mock should simulate failures
+     */
+    setShouldFail(shouldFail) {
+        this.shouldFail = shouldFail;
+    }
+    /**
+     * Set mock response delay for testing timing scenarios
+     */
+    setMockDelay(delay) {
+        this.mockDelay = delay;
+    }
+    /**
+     * Mock implementation of prompt refinement
+     * Returns predictable enhanced prompts for testing
+     */
+    async refinePrompt(prompt) {
+        // Simulate processing time
+        await new Promise((resolve) => setTimeout(resolve, this.mockDelay));
+        if (this.config.enableLogging) {
+            console.debug(`Mock MCP Sampling processing: ${prompt.substring(0, 50)}...`);
+        }
+        // Simulate security validation - reject sensitive information
+        const sensitivePatterns = /\b(api[_\s-]?key|secret|token|password|bearer|sk-\w+)\b/i;
+        if (sensitivePatterns.test(prompt)) {
+            return {
+                refinedPrompt: prompt, // Return original without enhancement
+                success: false,
+                processingTime: this.mockDelay,
+                metadata: {
+                    model: 'mock-model-v1',
+                    iterations: 0,
+                    confidence: 0,
+                },
+            };
+        }
+        if (this.shouldFail) {
+            return {
+                refinedPrompt: prompt,
+                success: false,
+                processingTime: this.mockDelay,
+                metadata: {
+                    model: 'mock-model-v1',
+                    iterations: 0,
+                    confidence: 0,
+                },
+            };
+        }
+        // Simulate advanced prompt refinement
+        const refinedPrompt = `${prompt}, highly detailed professional rendering with advanced lighting techniques, photorealistic quality, enhanced composition`;
+        return {
+            refinedPrompt,
+            success: true,
+            processingTime: this.mockDelay,
+            metadata: {
+                model: 'mock-model-v1',
+                iterations: 3,
+                confidence: 0.9,
+            },
+        };
+    }
+    /**
+     * Mock availability check - always returns true unless configured to fail
+     */
+    async isAvailable() {
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return !this.shouldFail;
+    }
+}
+exports.MockMCPSamplingClient = MockMCPSamplingClient;
+/**
+ * Factory function to create a mock MCP Sampling Client with default configuration
+ */
+function createMockMCPSamplingClient(config) {
+    return new MockMCPSamplingClient(config);
+}
+//# sourceMappingURL=mcpSamplingClient.mock.js.map

package/dist/business/__tests__/mocks/mcpSamplingClient.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpSamplingClient.mock.js","sourceRoot":"","sources":["../../../../src/business/__tests__/mocks/mcpSamplingClient.mock.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2JH,kEAIC;AAzGD;;;GAGG;AACH,MAAa,qBAAqB;IAKhC,YAAY,OAAoC;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,KAAK;YACpB,GAAG,OAAO;SACX,CAAA;QACD,IAAI,CAAC,SAAS,GAAG,GAAG,CAAA,CAAC,4BAA4B;QACjD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,UAAmB;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,2BAA2B;QAC3B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;QAEnE,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,iCAAiC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAA;QAC9E,CAAC;QAED,8DAA8D;QAC9D,MAAM,iBAAiB,GAAG,0DAA0D,CAAA;QACpF,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,aAAa,EAAE,MAAM,EAAE,sCAAsC;gBAC7D,OAAO,EAAE,KAAK;gBACd,cAAc,EAAE,IAAI,CAAC,SAAS;gBAC9B,QAAQ,EAAE;oBACR,KAAK,EAAE,eAAe;oBACtB,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,CAAC;iBACd;aACF,CAAA;QACH,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;gBACL,aAAa,EAAE,MAAM;gBACrB,OAAO,EAAE,KAAK;gBACd,cAAc,EAAE,IAAI,CAAC,SAAS;gBAC9B,QAAQ,EAAE;oBACR,KAAK,EAAE,eAAe;oBACtB,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,CAAC;iBACd;aACF,CAAA;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,aAAa,GAAG,GAAG,MAAM,0HAA0H,CAAA;QAEzJ,OAAO;YACL,aAAa;YACb,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI,CAAC,SAAS;YAC9B,QAAQ,EAAE;gBACR,KAAK,EAAE,eAAe;gBACtB,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,GAAG;aAChB;SACF,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;QACvD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAA;IACzB,CAAC;CACF;AA5FD,sDA4FC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CACzC,MAAmC;IAEnC,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC"}

package/dist/business/bestPracticesEngine.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Best Practices Engine for prompt optimization using 7 research-based strategies
+ * Implements hyper-specific conversion, semantic transformation, and structured enhancement
+ * for image generation prompts to improve output quality and consistency
+ */
+import type { GeminiTextClient } from '../api/geminiTextClient';
+import type { Result } from '../types/result';
+/**
+ * Configuration options for best practices application
+ */
+export interface BestPracticesOptions {
+    enabledPractices?: BestPracticeType[];
+    aspectRatio?: AspectRatio;
+    targetStyle?: string;
+    contextIntent?: string;
+    maintainCharacterConsistency?: boolean;
+    blendImages?: boolean;
+    useWorldKnowledge?: boolean;
+}
+/**
+ * Configuration for the Best Practices Engine
+ */
+export interface BestPracticesConfig {
+    timeout: number;
+    enableAllPractices: boolean;
+    performanceTarget: number;
+}
+/**
+ * Types of best practices available for prompt enhancement
+ */
+export type BestPracticeType = 'hyper-specific' | 'character-consistency' | 'multi-image-coordination' | 'iterative-refinement' | 'semantic-enhancement' | 'aspect-ratio-optimization' | 'camera-control-terminology';
+/**
+ * Supported aspect ratios for image generation
+ */
+export type AspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4';
+/**
+ * Individual best practice item with application details
+ */
+export interface BestPracticeItem {
+    type: BestPracticeType;
+    applied: boolean;
+    enhancement: string;
+    metadata: {
+        processingTime: number;
+        confidence: number;
+    };
+}
+/**
+ * Analysis of which best practices are already present in a prompt
+ */
+export interface BestPracticeAnalysis {
+    existingPractices: BestPracticeType[];
+    missingPractices: BestPracticeType[];
+    overallScore: number;
+    recommendations: string[];
+}
+/**
+ * Enhanced prompt with applied best practices and metadata
+ */
+export interface EnhancedPrompt {
+    originalPrompt: string;
+    enhancedPrompt: string;
+    appliedPractices: BestPracticeItem[];
+    transformationMeta: TransformationMetadata;
+}
+/**
+ * Metadata about the transformation process
+ */
+export interface TransformationMetadata {
+    totalProcessingTime: number;
+    practicesAnalyzed: number;
+    practicesApplied: number;
+    qualityScore: number;
+    timestamp: Date;
+}
+/**
+ * Strategy for applying individual best practices
+ */
+export interface TransformationStrategy {
+    analyze(prompt: string): Promise<boolean>;
+    apply(prompt: string, options?: BestPracticesOptions): Promise<string>;
+    getMetadata(): {
+        confidence: number;
+        processingTime: number;
+    };
+}
+/**
+ * Interface for the Best Practices Engine
+ */
+export interface BestPracticesEngine {
+    /**
+     * Apply best practices to optimize a prompt for image generation
+     * @param prompt The original prompt to enhance
+     * @param options Optional configuration for practice application
+     * @returns Result containing enhanced prompt or error
+     */
+    applyBestPractices(prompt: string, options?: BestPracticesOptions): Promise<Result<EnhancedPrompt, Error>>;
+    /**
+     * Analyze which best practices are already present in a prompt
+     * @param prompt The prompt to analyze
+     * @returns Analysis of current practice compliance
+     */
+    analyzePracticeCompliance(prompt: string): Promise<BestPracticeAnalysis>;
+    /**
+     * Get list of available best practices and their status
+     * @returns Array of best practice items
+     */
+    getAppliedPractices(): BestPracticeItem[];
+}
+/**
+ * Error for best practices engine operations
+ */
+export declare class BestPracticesError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * Factory function to create BestPracticesEngine instance
+ * @param config Optional configuration
+ * @returns BestPracticesEngine instance
+ */
+export declare function createBestPracticesEngine(config?: Partial<BestPracticesConfig>, geminiTextClient?: GeminiTextClient): BestPracticesEngine;
+/**
+ * Implementation of the Best Practices Engine
+ */
+export declare class BestPracticesEngineImpl implements BestPracticesEngine {
+    private readonly strategies;
+    private readonly config;
+    private appliedPractices;
+    private geminiTextClient;
+    constructor(config?: Partial<BestPracticesConfig>, geminiTextClient?: GeminiTextClient);
+    applyBestPractices(prompt: string, options?: BestPracticesOptions): Promise<Result<EnhancedPrompt, Error>>;
+    analyzePracticeCompliance(prompt: string): Promise<BestPracticeAnalysis>;
+    getAppliedPractices(): BestPracticeItem[];
+    private initializeStrategies;
+    private getEnhancementDescription;
+    private calculateQualityScore;
+    private generateRecommendations;
+    /**
+     * Build AI enhancement prompt for Gemini 2.0 Flash
+     */
+    private buildAIEnhancementPrompt;
+    /**
+     * Apply feature parameters as structured prompt instructions
+     */
+    private applyFeatureParameters;
+}
+//# sourceMappingURL=bestPracticesEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bestPracticesEngine.d.ts","sourceRoot":"","sources":["../../src/business/bestPracticesEngine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACrC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,uBAAuB,GACvB,0BAA0B,GAC1B,sBAAsB,GACtB,sBAAsB,GACtB,2BAA2B,GAC3B,4BAA4B,CAAA;AAEhC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,gBAAgB,EAAE,CAAA;IACrC,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;IACpC,kBAAkB,EAAE,sBAAsB,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtE,WAAW,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAA;IAEzC;;;;OAIG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAExE;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB,EAAE,CAAA;CAC1C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAWD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,EACrC,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,mBAAmB,CAErB;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+C;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EAAE,gBAAgB,CAAC,EAAE,gBAAgB;IAOpF,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAqPnC,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwC9E,mBAAmB,IAAI,gBAAgB,EAAE;IAIzC,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4DhC;;OAEG;YACW,sBAAsB;CAwBrC"}