@fastcoder/vision-mcp-server 1.0.0

package/build/tools/general-image.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register General Image Analysis tool with MCP server
+ */
+export declare function registerGeneralImageAnalysisTool(server: any): void;
+//# sourceMappingURL=general-image.d.ts.map

package/build/tools/general-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general-image.d.ts","sourceRoot":"","sources":["../../src/tools/general-image.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAgElE"}

package/build/tools/general-image.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { FileNotFoundError, ApiError, ValidationError } from '../types/index.js';
+import { CommonSchemas } from '../utils/validation.js';
+import { formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
+import { BaseImageAnalysisService } from '../core/base-image-service.js';
+import { GENERAL_IMAGE_ANALYSIS_PROMPT } from '../prompts/general-image.js';
+/**
+ * General Image Analysis service - General-purpose image analysis
+ */
+class GeneralImageAnalysisService extends BaseImageAnalysisService {
+    /**
+     * Analyze general image
+     */
+    async analyzeImage(imageSource, userPrompt) {
+        console.info('Starting general image analysis', {
+            imageSource,
+            prompt: userPrompt
+        });
+        // Validate prompt
+        this.validatePrompt(userPrompt, 'general-image-analysis');
+        // Process image
+        const imageContent = await this.processImageSource(imageSource);
+        // Execute analysis
+        return await this.executeVisionAnalysis(GENERAL_IMAGE_ANALYSIS_PROMPT, userPrompt, [imageContent], 'general-image-analysis');
+    }
+}
+/**
+ * Register General Image Analysis tool with MCP server
+ */
+export function registerGeneralImageAnalysisTool(server) {
+    const service = new GeneralImageAnalysisService();
+    const retryableAnalyze = withRetry(service.analyzeImage.bind(service), 2, 1000);
+    server.tool('analyze_image', `General-purpose image analysis for scenarios not covered by specialized tools.`, {
+        image_source: z
+            .string()
+            .min(1, 'Image source cannot be empty')
+            .describe('Local file path or remote URL to the image'),
+        prompt: z
+            .string()
+            .min(1, 'Prompt cannot be empty')
+            .describe('Detailed description of what you want to analyze')
+    }, async (params) => {
+        try {
+            // Validate parameters
+            const validationSchema = CommonSchemas.filePath
+                ? z.object({
+                    image_source: CommonSchemas.filePath,
+                    prompt: CommonSchemas.nonEmptyString
+                })
+                : z.object({
+                    image_source: CommonSchemas.nonEmptyString,
+                    prompt: CommonSchemas.nonEmptyString
+                });
+            const validated = validationSchema.safeParse(params);
+            if (!validated.success) {
+                const errorResponse = createErrorResponse(`Validation failed: ${validated.error.errors?.map(e => e.message).join(', ')}`);
+                return formatMcpResponse(errorResponse);
+            }
+            // Execute analysis
+            const result = await retryableAnalyze(validated.data.image_source, validated.data.prompt);
+            return formatMcpResponse(createSuccessResponse(result));
+        }
+        catch (error) {
+            let errorResponse;
+            if (error instanceof FileNotFoundError) {
+                errorResponse = createErrorResponse(`Image file not found: ${error.message}`);
+            }
+            else if (error instanceof ValidationError) {
+                errorResponse = createErrorResponse(`Validation error: ${error.message}`);
+            }
+            else if (error instanceof ApiError) {
+                errorResponse = createErrorResponse(`API error: ${error.message}`);
+            }
+            else {
+                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return formatMcpResponse(errorResponse);
+        }
+    });
+}
+//# sourceMappingURL=general-image.js.map

package/build/tools/general-image.js.map

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

package/build/tools/index.d.ts

@@ -0,0 +1,8 @@
+export { registerUiToArtifactTool } from './ui-to-artifact.js';
+export { registerTextExtractionTool } from './text-extraction.js';
+export { registerErrorDiagnosisTool } from './error-diagnosis.js';
+export { registerDiagramAnalysisTool } from './diagram-analysis.js';
+export { registerDataVizAnalysisTool } from './data-viz.js';
+export { registerUiDiffCheckTool } from './ui-diff.js';
+export { registerGeneralImageAnalysisTool } from './general-image.js';
+//# sourceMappingURL=index.d.ts.map

package/build/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC"}

package/build/tools/index.js

@@ -0,0 +1,9 @@
+// Re-export all tools for easier imports
+export { registerUiToArtifactTool } from './ui-to-artifact.js';
+export { registerTextExtractionTool } from './text-extraction.js';
+export { registerErrorDiagnosisTool } from './error-diagnosis.js';
+export { registerDiagramAnalysisTool } from './diagram-analysis.js';
+export { registerDataVizAnalysisTool } from './data-viz.js';
+export { registerUiDiffCheckTool } from './ui-diff.js';
+export { registerGeneralImageAnalysisTool } from './general-image.js';
+//# sourceMappingURL=index.js.map

package/build/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC"}

package/build/tools/text-extraction.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register Text Extraction tool with MCP server
+ */
+export declare function registerTextExtractionTool(server: any): void;
+//# sourceMappingURL=text-extraction.d.ts.map

package/build/tools/text-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-extraction.d.ts","sourceRoot":"","sources":["../../src/tools/text-extraction.ts"],"names":[],"mappings":"AAoDA;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAuE5D"}

package/build/tools/text-extraction.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { FileNotFoundError, ApiError, ValidationError } from '../types/index.js';
+import { CommonSchemas } from '../utils/validation.js';
+import { formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
+import { BaseImageAnalysisService } from '../core/base-image-service.js';
+import { TEXT_EXTRACTION_PROMPT } from '../prompts/text-extraction.js';
+/**
+ * Text Extraction service - OCR text extraction from screenshots
+ */
+class TextExtractionService extends BaseImageAnalysisService {
+    /**
+     * Extract text from screenshot
+     */
+    async extractText(imageSource, userPrompt, programmingLanguage) {
+        console.info('Starting text extraction', {
+            imageSource,
+            prompt: userPrompt,
+            programmingLanguage
+        });
+        // Validate prompt
+        this.validatePrompt(userPrompt, 'text-extraction');
+        // If programming language is provided, enhance the prompt
+        let enhancedPrompt = userPrompt;
+        if (programmingLanguage && programmingLanguage.trim()) {
+            enhancedPrompt = `${userPrompt}\n\n<language_hint>The code is in ${programmingLanguage}.</language_hint>`;
+        }
+        // Process image
+        const imageContent = await this.processImageSource(imageSource);
+        // Execute analysis
+        return await this.executeVisionAnalysis(TEXT_EXTRACTION_PROMPT, enhancedPrompt, [imageContent], 'text-extraction');
+    }
+}
+/**
+ * Register Text Extraction tool with MCP server
+ */
+export function registerTextExtractionTool(server) {
+    const service = new TextExtractionService();
+    const retryableExtract = withRetry(service.extractText.bind(service), 2, 1000);
+    server.tool('extract_text_from_screenshot', `Extract and recognize text from screenshots using advanced OCR capabilities.`, {
+        image_source: z
+            .string()
+            .min(1, 'Image source cannot be empty')
+            .describe('Local file path or remote URL to the image containing text to extract'),
+        prompt: z
+            .string()
+            .min(1, 'Prompt cannot be empty')
+            .describe('Instructions for text extraction - describe what text to extract or any special requirements'),
+        programming_language: z
+            .string()
+            .optional()
+            .describe('Optional hint about the programming language in the image (e.g., javascript, python, go)')
+    }, async (params) => {
+        try {
+            // Validate parameters
+            const validationSchema = CommonSchemas.filePath
+                ? z.object({
+                    image_source: CommonSchemas.filePath,
+                    prompt: CommonSchemas.nonEmptyString,
+                    programming_language: z.string().optional()
+                })
+                : z.object({
+                    image_source: CommonSchemas.nonEmptyString,
+                    prompt: CommonSchemas.nonEmptyString,
+                    programming_language: z.string().optional()
+                });
+            const validated = validationSchema.safeParse(params);
+            if (!validated.success) {
+                const errorResponse = createErrorResponse(`Validation failed: ${validated.error.errors?.map(e => e.message).join(', ')}`);
+                return formatMcpResponse(errorResponse);
+            }
+            // Execute extraction
+            const result = await retryableExtract(validated.data.image_source, validated.data.prompt, validated.data.programming_language);
+            return formatMcpResponse(createSuccessResponse(result));
+        }
+        catch (error) {
+            let errorResponse;
+            if (error instanceof FileNotFoundError) {
+                errorResponse = createErrorResponse(`Image file not found: ${error.message}`);
+            }
+            else if (error instanceof ValidationError) {
+                errorResponse = createErrorResponse(`Validation error: ${error.message}`);
+            }
+            else if (error instanceof ApiError) {
+                errorResponse = createErrorResponse(`API error: ${error.message}`);
+            }
+            else {
+                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return formatMcpResponse(errorResponse);
+        }
+    });
+}
+//# sourceMappingURL=text-extraction.js.map

package/build/tools/text-extraction.js.map

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

package/build/tools/ui-diff.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register UI Diff Check tool with MCP server
+ */
+export declare function registerUiDiffCheckTool(server: any): void;
+//# sourceMappingURL=ui-diff.d.ts.map

package/build/tools/ui-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-diff.d.ts","sourceRoot":"","sources":["../../src/tools/ui-diff.ts"],"names":[],"mappings":"AAyDA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAuEzD"}

package/build/tools/ui-diff.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { FileNotFoundError, ApiError, ValidationError } from '../types/index.js';
+import { CommonSchemas } from '../utils/validation.js';
+import { formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
+import { BaseImageAnalysisService } from '../core/base-image-service.js';
+import { UI_DIFF_CHECK_PROMPT } from '../prompts/ui-diff.js';
+/**
+ * UI Diff Check service - Compare two UI screenshots
+ */
+class UiDiffCheckService extends BaseImageAnalysisService {
+    /**
+     * Compare two UI screenshots
+     */
+    async compareUiScreenshots(expectedImageSource, actualImageSource, userPrompt) {
+        console.info('Starting UI diff check', {
+            expectedImageSource,
+            actualImageSource,
+            prompt: userPrompt
+        });
+        // Validate prompt
+        this.validatePrompt(userPrompt, 'ui-diff-check');
+        // Enhance the prompt to clarify which is expected vs actual
+        const enhancedPrompt = `<images>
+The first image is EXPECTED/REFERENCE design (the target).
+The second image is ACTUAL/CURRENT implementation (what needs to be checked).
+</images>
+
+${userPrompt}`;
+        // Process both images
+        const imageContents = await this.processMultipleImageSources([
+            expectedImageSource,
+            actualImageSource
+        ]);
+        // Execute analysis
+        return await this.executeVisionAnalysis(UI_DIFF_CHECK_PROMPT, enhancedPrompt, imageContents, 'ui-diff-check');
+    }
+}
+/**
+ * Register UI Diff Check tool with MCP server
+ */
+export function registerUiDiffCheckTool(server) {
+    const service = new UiDiffCheckService();
+    const retryableCompare = withRetry(service.compareUiScreenshots.bind(service), 2, 1000);
+    server.tool('ui_diff_check', `Compare two UI screenshots to identify visual differences and implementation discrepancies.`, {
+        expected_image_source: z
+            .string()
+            .min(1, 'Expected image source cannot be empty')
+            .describe('Local file path or remote URL to the expected/reference image'),
+        actual_image_source: z
+            .string()
+            .min(1, 'Actual image source cannot be empty')
+            .describe('Local file path or remote URL to the actual implementation image'),
+        prompt: z
+            .string()
+            .min(1, 'Prompt cannot be empty')
+            .describe('Instructions for comparison')
+    }, async (params) => {
+        try {
+            // Validate parameters
+            const validationSchema = CommonSchemas.filePath
+                ? z.object({
+                    expected_image_source: CommonSchemas.filePath,
+                    actual_image_source: CommonSchemas.filePath,
+                    prompt: CommonSchemas.nonEmptyString
+                })
+                : z.object({
+                    expected_image_source: CommonSchemas.nonEmptyString,
+                    actual_image_source: CommonSchemas.nonEmptyString,
+                    prompt: CommonSchemas.nonEmptyString
+                });
+            const validated = validationSchema.safeParse(params);
+            if (!validated.success) {
+                const errorResponse = createErrorResponse(`Validation failed: ${validated.error.errors?.map(e => e.message).join(', ')}`);
+                return formatMcpResponse(errorResponse);
+            }
+            // Execute comparison
+            const result = await retryableCompare(validated.data.expected_image_source, validated.data.actual_image_source, validated.data.prompt);
+            return formatMcpResponse(createSuccessResponse(result));
+        }
+        catch (error) {
+            let errorResponse;
+            if (error instanceof FileNotFoundError) {
+                errorResponse = createErrorResponse(`Image file not found: ${error.message}`);
+            }
+            else if (error instanceof ValidationError) {
+                errorResponse = createErrorResponse(`Validation error: ${error.message}`);
+            }
+            else if (error instanceof ApiError) {
+                errorResponse = createErrorResponse(`API error: ${error.message}`);
+            }
+            else {
+                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return formatMcpResponse(errorResponse);
+        }
+    });
+}
+//# sourceMappingURL=ui-diff.js.map

package/build/tools/ui-diff.js.map

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

package/build/tools/ui-to-artifact.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Register UI to Artifact tool with MCP server
+ */
+export declare function registerUiToArtifactTool(server: any): void;
+//# sourceMappingURL=ui-to-artifact.d.ts.map

package/build/tools/ui-to-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-to-artifact.d.ts","sourceRoot":"","sources":["../../src/tools/ui-to-artifact.ts"],"names":[],"mappings":"AAwDA;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAoG1D"}

package/build/tools/ui-to-artifact.js

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import { FileNotFoundError, ApiError, ValidationError } from '../types/index.js';
+import { CommonSchemas } from '../utils/validation.js';
+import { formatMcpResponse, createSuccessResponse, createErrorResponse, withRetry } from '../core/api-common.js';
+import { BaseImageAnalysisService } from '../core/base-image-service.js';
+import { UI_TO_ARTIFACT_PROMPTS } from '../prompts/ui-to-artifact.js';
+/**
+ * UI to Artifact service - Convert UI screenshots to various artifacts
+ */
+class UiToArtifactService extends BaseImageAnalysisService {
+    /**
+     * Convert UI screenshot to specified artifact type
+     */
+    async convertUiToArtifact(imageSource, outputType, userPrompt) {
+        console.info('Starting UI to artifact conversion', {
+            imageSource,
+            outputType,
+            prompt: userPrompt
+        });
+        // Validate output type
+        const normalizedType = outputType.toLowerCase();
+        const systemPrompt = UI_TO_ARTIFACT_PROMPTS[normalizedType];
+        if (!systemPrompt) {
+            throw new ValidationError(`Invalid output_type '${outputType}'. Must be one of: code, prompt, spec, description`);
+        }
+        // Validate prompt
+        this.validatePrompt(userPrompt, 'ui-to-artifact');
+        // Process image
+        const imageContent = await this.processImageSource(imageSource);
+        // Execute analysis
+        return await this.executeVisionAnalysis(systemPrompt, userPrompt, [imageContent], 'ui-to-artifact');
+    }
+}
+/**
+ * Register UI to Artifact tool with MCP server
+ */
+export function registerUiToArtifactTool(server) {
+    const service = new UiToArtifactService();
+    const retryableConvert = withRetry(service.convertUiToArtifact.bind(service), 2, 1000);
+    server.tool('ui_to_artifact', `Convert UI screenshots into various artifacts: code, prompts, design specifications, or descriptions.
+
+Use this tool ONLY when user wants to:
+- Generate frontend code from UI design (output_type='code')
+- Create AI prompts for UI generation (output_type='prompt')
+- Extract design specifications (output_type='spec')
+- Generate UI descriptions (output_type='description')
+
+Supported output types:
+- code: Production-ready HTML + CSS with semantic structure
+- prompt: Detailed AI prompt for recreating the UI
+- spec: Comprehensive design system documentation
+- description: Natural language UI analysis`, {
+        image_source: z
+            .string()
+            .min(1, 'Image source cannot be empty')
+            .describe('Local file path or remote URL to the UI screenshot'),
+        output_type: z
+            .enum(['code', 'prompt', 'spec', 'description'], {
+            message: 'output_type must be one of: code, prompt, spec, description'
+        })
+            .describe('Type of artifact to generate from the UI'),
+        prompt: z
+            .string()
+            .min(1, 'Prompt cannot be empty')
+            .describe('Detailed instructions describing what to generate')
+    }, async (params) => {
+        try {
+            // Validate parameters
+            const validationSchema = CommonSchemas.filePath
+                ? z.object({
+                    image_source: CommonSchemas.filePath,
+                    output_type: z.enum([
+                        'code',
+                        'prompt',
+                        'spec',
+                        'description'
+                    ]),
+                    prompt: CommonSchemas.nonEmptyString
+                })
+                : z.object({
+                    image_source: CommonSchemas.nonEmptyString,
+                    output_type: z.enum([
+                        'code',
+                        'prompt',
+                        'spec',
+                        'description'
+                    ]),
+                    prompt: CommonSchemas.nonEmptyString
+                });
+            const validated = validationSchema.safeParse(params);
+            if (!validated.success) {
+                const errorResponse = createErrorResponse(`Validation failed: ${validated.error.errors?.map(e => e.message).join(', ')}`);
+                return formatMcpResponse(errorResponse);
+            }
+            // Execute conversion
+            const result = await retryableConvert(validated.data.image_source, validated.data.output_type, validated.data.prompt);
+            return formatMcpResponse(createSuccessResponse(result));
+        }
+        catch (error) {
+            let errorResponse;
+            if (error instanceof FileNotFoundError) {
+                errorResponse = createErrorResponse(`Image file not found: ${error.message}`);
+            }
+            else if (error instanceof ValidationError) {
+                errorResponse = createErrorResponse(`Validation error: ${error.message}`);
+            }
+            else if (error instanceof ApiError) {
+                errorResponse = createErrorResponse(`API error: ${error.message}`);
+            }
+            else {
+                errorResponse = createErrorResponse(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return formatMcpResponse(errorResponse);
+        }
+    });
+}
+//# sourceMappingURL=ui-to-artifact.js.map

package/build/tools/ui-to-artifact.js.map

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

package/build/types/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Custom error class for API-related errors
+ */
+export declare class ApiError extends Error {
+    constructor(message: string);
+}
+/**
+ * Custom error class for file not found errors
+ */
+export declare class FileNotFoundError extends Error {
+    constructor(message: string);
+}
+/**
+ * Custom error class for validation errors
+ */
+export declare class ValidationError extends Error {
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Custom error class for tool execution errors
+ */
+export declare class ToolExecutionError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACJ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAAzD,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKtE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAK5B"}

package/build/types/index.js

@@ -0,0 +1,43 @@
+/**
+ * Custom error class for API-related errors
+ */
+export class ApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ApiError';
+        Object.setPrototypeOf(this, ApiError.prototype);
+    }
+}
+/**
+ * Custom error class for file not found errors
+ */
+export class FileNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FileNotFoundError';
+        Object.setPrototypeOf(this, FileNotFoundError.prototype);
+    }
+}
+/**
+ * Custom error class for validation errors
+ */
+export class ValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * Custom error class for tool execution errors
+ */
+export class ToolExecutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolExecutionError';
+        Object.setPrototypeOf(this, ToolExecutionError.prototype);
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACJ;IAApC,YAAY,OAAe,EAAS,OAAiC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,YAAO,GAAP,OAAO,CAA0B;QAEnE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/build/utils/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Logger utility that writes to stderr and a log file.
+ * Stderr keeps MCP JSON on stdout clean; file provides persistent logs.
+ */
+declare class Logger {
+    private logStream?;
+    constructor(logFilePath?: string);
+    setLogFile(logFilePath: string): void;
+    private safeStringify;
+    private write;
+    info(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    log(message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+/**
+ * Override global console to redirect to stderr
+ * This prevents console output from interfering with MCP JSON protocol
+ */
+export declare function setupConsoleRedirection(): typeof console;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/build/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,cAAM,MAAM;IACV,OAAO,CAAC,SAAS,CAAC,CAAiB;gBAEvB,WAAW,CAAC,EAAE,MAAM;IAMhC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAerC,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,KAAK;IAeb,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAG/C;AAED,eAAO,MAAM,MAAM,QAAe,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,OAAO,CA8BxD"}