@fastcoder/vision-mcp-server 1.0.0

package/build/core/error-handler.js

@@ -0,0 +1,248 @@
+import { ApiError, ValidationError } from '../types/index.js';
+/**
+ * Error severity levels
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["LOW"] = "low";
+    ErrorSeverity["MEDIUM"] = "medium";
+    ErrorSeverity["HIGH"] = "high";
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Error categories
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["AUTHENTICATION"] = "authentication";
+    ErrorCategory["AUTHORIZATION"] = "authorization";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["API"] = "api";
+    ErrorCategory["SYSTEM"] = "system";
+    ErrorCategory["BUSINESS"] = "business";
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Base error class
+ */
+export class BaseError extends Error {
+    code;
+    severity;
+    category;
+    context;
+    cause;
+    recoverable;
+    constructor(message, code, severity, category, context = {}, cause, recoverable = true) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.severity = severity;
+        this.category = category;
+        this.context = {
+            timestamp: Date.now(),
+            ...context
+        };
+        this.cause = cause;
+        this.recoverable = recoverable;
+        // Preserve stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert to JSON format
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            context: this.context,
+            recoverable: this.recoverable,
+            stack: this.stack,
+            cause: this.cause
+                ? {
+                    name: this.cause.name,
+                    message: this.cause.message,
+                    stack: this.cause.stack
+                }
+                : undefined
+        };
+    }
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage() {
+        return this.message;
+    }
+}
+/**
+ * Business logic error
+ */
+export class BusinessError extends BaseError {
+    constructor(message, code = 'BUSINESS_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.BUSINESS, context, cause, true);
+    }
+    getUserMessage() {
+        return this.message;
+    }
+}
+/**
+ * System error
+ */
+export class SystemError extends BaseError {
+    constructor(message, code = 'SYSTEM_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.HIGH, ErrorCategory.SYSTEM, context, cause, false);
+    }
+    getUserMessage() {
+        return 'An internal system error occurred. Please try again later.';
+    }
+}
+/**
+ * Network error
+ */
+export class NetworkError extends BaseError {
+    constructor(message, code = 'NETWORK_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.NETWORK, context, cause, true);
+    }
+    getUserMessage() {
+        return 'Network connection error. Please check your connection and try again.';
+    }
+}
+/**
+ * Authentication error
+ */
+export class AuthenticationError extends BaseError {
+    constructor(message, code = 'AUTHENTICATION_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.HIGH, ErrorCategory.AUTHENTICATION, context, cause, false);
+    }
+    getUserMessage() {
+        return 'Authentication failed. Please check your credentials.';
+    }
+}
+/**
+ * Authorization error
+ */
+export class AuthorizationError extends BaseError {
+    constructor(message, code = 'AUTHORIZATION_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.HIGH, ErrorCategory.AUTHORIZATION, context, cause, false);
+    }
+    getUserMessage() {
+        return 'Access denied. You do not have permission to perform this action.';
+    }
+}
+/**
+ * Tool execution error
+ */
+export class ToolExecutionError extends BaseError {
+    toolName;
+    constructor(message, toolName, code = 'TOOL_EXECUTION_ERROR', context = {}, cause) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.BUSINESS, { ...context, toolName }, cause, true);
+        this.toolName = toolName;
+    }
+    getUserMessage() {
+        return `Tool execution failed: ${this.message}`;
+    }
+}
+/**
+ * Default error handling strategy
+ */
+class DefaultErrorHandlingStrategy {
+    canHandle(_error) {
+        return true; // Default strategy handles all errors
+    }
+    async handle(error, context) {
+        // If already a standardized error, return directly
+        if (error instanceof BaseError) {
+            return error;
+        }
+        // Handle known error types
+        if (error instanceof ValidationError) {
+            return new BusinessError(error.message, 'VALIDATION_ERROR', context, error);
+        }
+        if (error instanceof ApiError) {
+            return new SystemError(error.message, 'API_ERROR', context, error);
+        }
+        // Handle unknown errors
+        return new SystemError(error.message || 'An unknown error occurred', 'UNKNOWN_ERROR', context, error);
+    }
+}
+/**
+ * Network error handling strategy
+ */
+class NetworkErrorHandlingStrategy {
+    canHandle(error) {
+        return (error.message.includes('network') ||
+            error.message.includes('timeout') ||
+            error.message.includes('connection') ||
+            error.name === 'NetworkError');
+    }
+    async handle(error, context) {
+        return new NetworkError(error.message, 'NETWORK_CONNECTION_ERROR', context, error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Unified error handler
+ */
+export class ErrorHandler {
+    strategies = [];
+    constructor() {
+        // Register strategies in order
+        this.addStrategy(new NetworkErrorHandlingStrategy());
+        this.addStrategy(new DefaultErrorHandlingStrategy()); // Default strategy goes last
+    }
+    /**
+     * Add error handling strategy
+     */
+    addStrategy(strategy) {
+        this.strategies.push(strategy);
+    }
+    /**
+     * Handle error
+     */
+    async handleError(error, context = {}) {
+        const errorContext = {
+            timestamp: Date.now(),
+            ...context
+        };
+        try {
+            // Find appropriate handling strategy
+            const strategy = this.strategies.find(s => s.canHandle(error));
+            if (!strategy) {
+                console.warn('No suitable error handling strategy found', {
+                    error: error.message
+                });
+                return new SystemError('No error handler available', 'NO_HANDLER_ERROR', errorContext, error instanceof Error ? error : undefined);
+            }
+            // Handle error
+            const standardError = await strategy.handle(error, errorContext);
+            console.error('Error handled', {
+                name: standardError.name,
+                message: standardError.message,
+                code: standardError.code
+            });
+            return standardError;
+        }
+        catch (handlingError) {
+            console.error('Failed to handle error', {
+                originalError: error.message,
+                handlingError: handlingError instanceof Error ? handlingError.message : String(handlingError)
+            });
+            return new SystemError('Error handling failed', 'HANDLING_ERROR', errorContext, handlingError instanceof Error ? handlingError : undefined);
+        }
+    }
+}
+/**
+ * Global error handler instance
+ */
+export const errorHandler = new ErrorHandler();
+/**
+ * Convenience function to handle errors
+ */
+export async function handleError(error, context = {}) {
+    return errorHandler.handleError(error, context);
+}
+//# sourceMappingURL=error-handler.js.map

package/build/core/error-handler.js.map

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

package/build/core/file-service.d.ts

@@ -0,0 +1,36 @@
+/**
+ * File operations service (images only - video methods removed)
+ */
+export declare class FileService {
+    /**
+     * Check if a string is a URL
+     */
+    static isUrl(source: string): boolean;
+    /**
+     * Validate if image source exists and check size limit
+     * @param imageSource Path to image file or URL
+     * @param maxSizeMB Maximum file size in MB (default: 20MB for OpenAI)
+     */
+    static validateImageSource(imageSource: string, maxSizeMB?: number): Promise<void>;
+    /**
+     * Encode image to base64 data URL (from file or URL)
+     * @param imageSource Path to image file or URL
+     * @returns Base64 encoded image data
+     */
+    static encodeImageToBase64(imageSource: string): Promise<string>;
+    /**
+     * Download image from URL and encode to base64
+     * @param imageUrl Image URL to download
+     * @returns Base64 encoded image data
+     */
+    private static downloadAndEncodeImage;
+    /**
+     * Get MIME type for image file extension or content type
+     */
+    static getMimeType(extension: string): string;
+}
+/**
+ * File service for image operations
+ */
+export declare const fileService: typeof FileService;
+//# sourceMappingURL=file-service.d.ts.map

package/build/core/file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../../src/core/file-service.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASrC;;;;OAIG;WACU,mBAAmB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC;IA+ChB;;;;OAIG;WACU,mBAAmB,CAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;mBACkB,sBAAsB;IA6D3C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAU9C;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,oBAAc,CAAC"}

package/build/core/file-service.js

@@ -0,0 +1,141 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { FileNotFoundError, ValidationError } from '../types/index.js';
+/**
+ * File operations service (images only - video methods removed)
+ */
+export class FileService {
+    /**
+     * Check if a string is a URL
+     */
+    static isUrl(source) {
+        try {
+            const url = new URL(source);
+            return url.protocol === 'http:' || url.protocol === 'https:';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Validate if image source exists and check size limit
+     * @param imageSource Path to image file or URL
+     * @param maxSizeMB Maximum file size in MB (default: 20MB for OpenAI)
+     */
+    static async validateImageSource(imageSource, maxSizeMB = 20) {
+        if (this.isUrl(imageSource)) {
+            // For URLs, validate URL format
+            try {
+                const url = new URL(imageSource);
+                if (!['http:', 'https:'].includes(url.protocol)) {
+                    throw new ValidationError(`Unsupported URL protocol: ${url.protocol}. Only http:// and https:// are supported.`);
+                }
+            }
+            catch (error) {
+                if (error instanceof ValidationError) {
+                    throw error;
+                }
+                throw new ValidationError(`Invalid URL format: ${imageSource}. Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            // Note: Actual content validation (size, format) happens during download in encodeImageToBase64
+            return;
+        }
+        if (!fs.existsSync(imageSource)) {
+            throw new FileNotFoundError(`Image file not found: ${imageSource}`);
+        }
+        const stats = fs.statSync(imageSource);
+        const maxSizeBytes = maxSizeMB * 1024 * 1024;
+        if (stats.size > maxSizeBytes) {
+            throw new ValidationError(`Image file too large: ${(stats.size / (1024 * 1024)).toFixed(2)}MB. ` +
+                `Maximum allowed: ${maxSizeMB}MB`);
+        }
+        const ext = path.extname(imageSource).toLowerCase();
+        const supportedExts = ['.jpg', '.jpeg', '.png'];
+        if (!supportedExts.includes(ext)) {
+            throw new ValidationError(`Unsupported image format: ${ext}. ` +
+                `Supported formats: ${supportedExts.join(', ')}`);
+        }
+    }
+    /**
+     * Encode image to base64 data URL (from file or URL)
+     * @param imageSource Path to image file or URL
+     * @returns Base64 encoded image data
+     */
+    static async encodeImageToBase64(imageSource) {
+        if (this.isUrl(imageSource)) {
+            // For URLs, download and encode to base64
+            return this.downloadAndEncodeImage(imageSource);
+        }
+        // For local files, encode to base64
+        const imageBuffer = fs.readFileSync(imageSource);
+        const ext = path.extname(imageSource).toLowerCase().slice(1);
+        const mimeType = this.getMimeType(ext);
+        console.debug('Encoded image to base64', { imageSource, mimeType });
+        return `data:${mimeType};base64,${imageBuffer.toString('base64')}`;
+    }
+    /**
+     * Download image from URL and encode to base64
+     * @param imageUrl Image URL to download
+     * @returns Base64 encoded image data
+     */
+    static async downloadAndEncodeImage(imageUrl) {
+        console.debug('Downloading image from URL', { imageUrl });
+        try {
+            const response = await fetch(imageUrl);
+            if (!response.ok) {
+                throw new ValidationError(`Failed to download image: HTTP ${response.status} ${response.statusText}`);
+            }
+            // Get content type from response headers
+            const contentType = response.headers.get('content-type');
+            if (!contentType || !contentType.startsWith('image/')) {
+                throw new ValidationError(`Invalid content type: ${contentType}. Expected image/*`);
+            }
+            // Get content length for size validation
+            const contentLength = response.headers.get('content-length');
+            if (contentLength) {
+                const sizeInMB = parseInt(contentLength) / (1024 * 1024);
+                if (sizeInMB > 20) {
+                    throw new ValidationError(`Downloaded image too large: ${sizeInMB.toFixed(2)}MB. Maximum allowed: 20MB`);
+                }
+            }
+            // Download image data
+            const imageBuffer = Buffer.from(await response.arrayBuffer());
+            // Additional size check from actual data
+            const actualSizeInMB = imageBuffer.length / (1024 * 1024);
+            if (actualSizeInMB > 20) {
+                throw new ValidationError(`Downloaded image too large: ${actualSizeInMB.toFixed(2)}MB. Maximum allowed: 20MB`);
+            }
+            console.debug('Successfully downloaded and encoded image', {
+                imageUrl,
+                contentType,
+                sizeInMB: actualSizeInMB.toFixed(2)
+            });
+            return `data:${contentType};base64,${imageBuffer.toString('base64')}`;
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                throw error;
+            }
+            throw new ValidationError(`Failed to download image from URL: ${imageUrl}. ` +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get MIME type for image file extension or content type
+     */
+    static getMimeType(extension) {
+        const mimeTypes = {
+            png: 'image/png',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            webp: 'image/webp',
+            gif: 'image/gif'
+        };
+        return mimeTypes[extension] || 'image/png';
+    }
+}
+/**
+ * File service for image operations
+ */
+export const fileService = FileService;
+//# sourceMappingURL=file-service.js.map

package/build/core/file-service.js.map

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

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configurationService } from './core/environment.js';
+import { handleError } from './core/error-handler.js';
+import { setupConsoleRedirection } from './utils/logger.js';
+// Import tool registration functions
+import { registerUiToArtifactTool } from './tools/ui-to-artifact.js';
+import { registerTextExtractionTool } from './tools/text-extraction.js';
+import { registerErrorDiagnosisTool } from './tools/error-diagnosis.js';
+import { registerDiagramAnalysisTool } from './tools/diagram-analysis.js';
+import { registerDataVizAnalysisTool } from './tools/data-viz.js';
+import { registerUiDiffCheckTool } from './tools/ui-diff.js';
+import { registerGeneralImageAnalysisTool } from './tools/general-image.js';
+/**
+ * MCP Server Application class
+ */
+class McpServerApplication {
+    server;
+    constructor() {
+        this.server = new McpServer({
+            name: configurationService.getServerConfig().name,
+            version: configurationService.getServerConfig().version
+        }, {
+            capabilities: {
+                tools: {}
+            }
+        });
+        this.setupErrorHandling();
+        console.info('MCP Server Application initialized');
+    }
+    /**
+     * Setup error handling
+     */
+    setupErrorHandling() {
+        // Note: McpServer from @modelcontextprotocol/sdk does not have onerror property
+        // Error handling is managed by the server internally
+        process.on('SIGINT', () => {
+            console.info('Received SIGINT, shutting down gracefully...');
+            this.shutdown();
+        });
+    }
+    /**
+     * Register all tools
+     */
+    async registerTools() {
+        try {
+            // Register specialized image analysis tools (7 tools)
+            registerUiToArtifactTool(this.server);
+            registerTextExtractionTool(this.server);
+            registerErrorDiagnosisTool(this.server);
+            registerDiagramAnalysisTool(this.server);
+            registerDataVizAnalysisTool(this.server);
+            registerUiDiffCheckTool(this.server);
+            registerGeneralImageAnalysisTool(this.server);
+            console.info('Successfully registered all image analysis tools (7 tools)');
+        }
+        catch (error) {
+            const standardError = await handleError(error instanceof Error ? error : new Error(String(error)), {
+                operation: 'tool-registration',
+                metadata: { component: 'McpServerApplication' }
+            });
+            console.error('Failed to register tools', standardError);
+            throw standardError;
+        }
+    }
+    /**
+     * Start the server
+     */
+    async start() {
+        try {
+            await this.registerTools();
+            console.info('Starting Vision MCP Server...', {
+                name: configurationService.getServerConfig().name,
+                version: configurationService.getServerConfig().version
+            });
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            console.info('Vision MCP Server is running');
+        }
+        catch (error) {
+            const standardError = await handleError(error instanceof Error ? error : new Error(String(error)), {
+                operation: 'server-start',
+                metadata: { component: 'McpServerApplication' }
+            });
+            console.error('Failed to start server', standardError);
+            throw standardError;
+        }
+    }
+    /**
+     * Shutdown the server
+     */
+    async shutdown() {
+        try {
+            await this.server.close();
+            console.info('Server shutdown complete');
+            process.exit(0);
+        }
+        catch (error) {
+            console.error('Error during shutdown', { error });
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Setup console redirection BEFORE any other code to prevent stdout pollution
+    setupConsoleRedirection();
+    const app = new McpServerApplication();
+    await app.start();
+}
+// Start the application
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,qCAAqC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAE5E;;GAEG;AACH,MAAM,oBAAoB;IAChB,MAAM,CAAY;IAE1B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CACzB;YACE,IAAI,EAAE,oBAAoB,CAAC,eAAe,EAAE,CAAC,IAAI;YACjD,OAAO,EAAE,oBAAoB,CAAC,eAAe,EAAE,CAAC,OAAO;SACxD,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;aACV;SACF,CACF,CAAC;QACF,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,kBAAkB;QACxB,gFAAgF;QAChF,qDAAqD;QAErD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,sDAAsD;YACtD,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE9C,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,aAAa,GAAG,MAAM,WAAW,CACrC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD;gBACE,SAAS,EAAE,mBAAmB;gBAC9B,QAAQ,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE;aAChD,CACF,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,aAAa,CAAC,CAAC;YACzD,MAAM,aAAa,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAE3B,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE;gBAC5C,IAAI,EAAE,oBAAoB,CAAC,eAAe,EAAE,CAAC,IAAI;gBACjD,OAAO,EAAE,oBAAoB,CAAC,eAAe,EAAE,CAAC,OAAO;aACxD,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAErC,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,aAAa,GAAG,MAAM,WAAW,CACrC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD;gBACE,SAAS,EAAE,cAAc;gBACzB,QAAQ,EAAE,EAAE,SAAS,EAAE,sBAAsB,EAAE;aAChD,CACF,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC;YACvD,MAAM,aAAa,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,8EAA8E;IAC9E,uBAAuB,EAAE,CAAC;IAE1B,MAAM,GAAG,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACvC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED,wBAAwB;AACxB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/prompts/data-viz.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Data Visualization Analysis system prompt (Version 2)
+ */
+export declare const DATA_VIZ_ANALYSIS_PROMPT = "You are a data analyst with expertise in interpreting data visualizations and extracting meaningful insights. When you look at a chart or dashboard, you see beyond the visual representation\u2014you understand the story the data tells, recognize significant patterns and trends, identify anomalies that warrant attention, and can translate quantitative information into actionable insights.\n\n<task>\nYour task is to analyze the provided data visualization and extract meaningful insights, trends, patterns, and actionable recommendations. Your analysis should help decision-makers understand what the data reveals, what it means for their context, and what actions they might consider based on these insights.\n</task>\n\n<approach>\nBegin by understanding what you're looking at. Identify the type of visualization\u2014is it a line chart showing trends over time, a bar chart comparing categories, a pie chart showing proportions, a scatter plot revealing correlations, a heatmap displaying intensity across dimensions, or something more complex like a combination dashboard? The visualization type tells you what kind of insights it's designed to convey.\n\nRead all the labels and annotations carefully. The title often states what's being measured. Axis labels define the dimensions\u2014what's on the x-axis and what's on the y-axis? What units are used? Are we looking at dollars, percentages, counts, rates? The legend explains what different colors, lines, or symbols represent, especially when comparing multiple data series. Any text annotations or callouts highlight specific points of interest that the visualization creator thought important.\n\nNote the time period or categories being displayed. Are we looking at data from the past week, month, year, or longer? Is it showing historical data, current state, or predictions? For categorical data, what categories are being compared? Understanding the temporal or categorical scope helps contextualize the insights.\n\nExtract the key metrics and values systematically. What are the maximum and minimum values shown? What's the current or most recent value? Can you identify average or typical values? Look for specific data points that are labeled or emphasized. In a dashboard with multiple metrics, note the relationship between different measurements.\n\nIdentify trends and patterns. For time-series data, is the overall trend upward, downward, or stable? Is the rate of change accelerating or decelerating? Are there cyclical patterns or seasonality\u2014does the data show regular peaks and troughs at predictable intervals? For comparative data, which categories or segments perform best or worst? Are there significant disparities between groups?\n\nLook for anomalies and interesting deviations. Are there sudden spikes or drops that break the normal pattern? Are there outliers\u2014data points that don't fit the general distribution? Sometimes these anomalies are the most important insight\u2014a spike might indicate a successful campaign or a system issue; a drop might signal a problem or changing market conditions.\n\nConsider what might cause the patterns you observe. If revenue increased sharply in December, that might be expected seasonality for retail. If server response times spiked at 3 AM on Tuesday, that might indicate a batch job or an attack. If certain user segments show higher engagement, what characteristics do they share? While you're analyzing a visualization, not raw data, you can still reason about likely causes based on common patterns and domain knowledge.\n\nThink about the implications and what actions the data might suggest. If a metric is trending negatively, what might help reverse it? If a particular segment is performing exceptionally well, should resources be directed there? If there's a concerning anomaly, what investigation or immediate action might be warranted? Connect the data patterns to decisions.\n\nAssess the data quality and completeness visible in the visualization. Are there gaps in the timeline suggesting missing data? Do any values seem unrealistic or impossible? Are there notes about data collection issues? Being aware of potential data quality issues helps qualify your insights appropriately.\n\nIf comparing multiple metrics or data series, look for correlations and relationships. Do two metrics move together, suggesting they're related? Does one seem to lead to another, suggesting causation? Are there trade-offs visible where improving one metric seems to worsen another?\n\nConsider what additional information might be needed for a more complete analysis. Sometimes a visualization raises as many questions as it answers. Noting what you'd want to investigate further demonstrates analytical depth.\n</approach>\n\n<output_structure>\nStructure your analysis to be immediately useful for decision-making:\n\nBegin with a **Visualization Summary** that orients the reader. Describe what type of visualization this is and what it's measuring: \"This is a multi-line chart showing website traffic metrics over the past 90 days, comparing page views, unique visitors, and session duration.\" Identify the time period or scope: \"The data spans from January 1 to March 31, 2024.\" Note any data sources if visible: \"The data appears to be from Google Analytics based on the interface styling.\"\n\nIn the **Key Metrics** section, extract and present the important numbers clearly:\n\n\"Current Metrics (as of March 31, 2024):\n|- Page Views: 1.2M (up from 950K at start of period, +26% growth)\n|- Unique Visitors: 285K (up from 230K, +24% growth)\n|- Average Session Duration: 4:32 minutes (down from 5:10, -12% decline)\n\nPeak Values:\n|- Highest single-day page views: 52K on March 15\n|- Highest unique visitors: 12K on March 15\n|- Longest average session: 6:15 on January 8\n\nNotable Comparisons:\n|- March averaged 40K daily page views vs. January's 31K average (+29%)\n|- Weekend traffic consistently lower than weekdays (approximately 30% reduction)\n|- Mobile visitors account for approximately 60% of total based on segmentation visible in the dashboard\"\n\nIn the **Trends & Patterns** section, describe what the data reveals over time or across categories:\n\n\"The visualization shows several clear trends:\n\nOverall Growth: Both page views and unique visitors display consistent upward trajectories throughout the period, with month-over-month acceleration. The growth appears strongest in March, suggesting increasing traction or the impact of recent initiatives.\n\nCyclical Patterns: There's a pronounced weekly pattern with traffic peaking mid-week (Tuesday through Thursday) and declining on weekends. This suggests a business or professional audience rather than consumer entertainment use.\n\nSeasonality Shift: The data shows a notable inflection point around February 20, where the growth rate accelerates. This aligns with the end of the typical holiday slowdown and might indicate the start of a busy business season or the launch of a new marketing campaign.\n\nEngagement Concern: While visit metrics trend upward, session duration trends downward. This inverse relationship suggests that while more people are coming to the site, they're spending less time per visit on average. This could indicate either that users are finding what they need more quickly (positive) or that content engagement is declining (concerning).\"\n\nIn the **Anomalies & Insights** section, highlight unusual observations and what they might mean:\n\n\"Several anomalies warrant attention:\n\nMarch 15 Spike: Traffic on March 15 exceeded normal levels by approximately 150%. This spike in both page views and unique visitors suggests an external event\u2014perhaps a media mention, social media viral post, or successful marketing campaign. Investigating what happened that day could reveal replicable success factors.\n\nJanuary 8 Engagement Peak: While January saw lower traffic volumes, session duration peaked at over 6 minutes. The content or user behavior that day might offer insights into what drives deeper engagement.\n\nWeekend Gaps: The consistent and significant weekend traffic decline suggests that the primary audience is professional users accessing during work hours. This has implications for support staffing, deployment timing, and content publishing schedules.\n\nLate March Volatility: The last week of March shows increased day-to-day variance in all metrics compared to earlier months. This could indicate a shift in traffic sources (perhaps from referrals or ads rather than organic search), or might reflect data collection issues that should be verified.\"\n\nIn the **Actionable Recommendations** section, translate insights into suggested actions:\n\n\"Based on this analysis, consider the following actions:\n\nInvestigate Session Duration Decline: The 12% drop in engagement time despite 26% traffic growth is concerning and deserves immediate investigation. Analyze which pages have decreasing time-on-page, review recent content or design changes that might reduce engagement, and examine whether new traffic sources bring less engaged visitors.\n\nCapitalize on Mid-Week Peak: Since traffic peaks mid-week, schedule important announcements, product launches, or content publications for Tuesday-Thursday to maximize visibility and impact.\n\nStudy March 15 Success: Conduct a detailed post-mortem on what drove the March 15 traffic spike. If it was a specific campaign, content piece, or external mention, try to replicate the success factors.\n\nOptimize for Professional Audience: The weekday traffic pattern confirms a professional user base. Tailor content strategy, support hours, and communication timing to this audience's work schedule.\n\nMonitor New Visitor Conversion: With unique visitors growing at nearly the same rate as page views, the pages-per-visitor ratio remains relatively flat. Consider strategies to improve new visitor engagement and encourage deeper exploration of the site\u2014perhaps through better internal linking, more compelling related content suggestions, or clearer navigation paths.\n\nAddress Late March Volatility: If the increased variance continues into April, investigate potential causes such as changes in traffic sources, technical issues affecting measurement, or external market factors affecting audience behavior.\"\n</output_structure>\n\nYour analysis should transform raw visualizations into actionable intelligence, making data accessible and meaningful for decision-makers who need to understand not just what the numbers are, but what they mean and what to do about them.";
+//# sourceMappingURL=data-viz.d.ts.map

package/build/prompts/data-viz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-viz.d.ts","sourceRoot":"","sources":["../../src/prompts/data-viz.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,wBAAwB,s4UA6FyM,CAAC"}