mcp-hydrocoder-image 1.1.1 → 1.2.0

package/dist/business/multiImagePrompt.js

@@ -0,0 +1,135 @@
+import { Err, Ok } from '../types/result.js';
+import { InputValidationError } from '../utils/errors.js';
+const EXPLICIT_MULTI_IMAGE_PATTERNS = [
+    /第\s*[0-9一二三四五六七八九十百千]+\s*张/iu,
+    /\bimage\s*[1-9]\d*\b/iu,
+    /\bshot\s*[1-9]\d*\b/iu,
+    /\bvariation\s*[1-9]\d*\b/iu,
+    /\b(first|second|third|fourth|fifth|sixth|seventh|eighth|ninth|tenth)\s+image\b/iu,
+];
+const EXPLICIT_MULTI_IMAGE_SECTION_REGEX = /((?:第[\s　]*[0-9一二三四五六七八九十百千]+[\s　]*(?:张|幅|个)(?:图|图片)?)(?:[\s　]*(?:是|为))?|Image[_\s]*[1-9]\d*(?:\s*\([^)]*\))?(?:\s+(?:is|should\s+be))?|(?:First|Second|Third|Fourth|Fifth|Sixth|Seventh|Eighth|Ninth|Tenth)\s+Image(?:\s+(?:is|should\s+be))?|(?:For\s+)?Image[_\s]*[1-9]\d*\s*,|Shot[_\s]*[1-9]\d*(?:\s+(?:is|should\s+be))?|Variation[_\s]*[1-9]\d*(?:\s+(?:is|should\s+be))?)\s*[:：，,；;、]?/giu;
+const CHINESE_NUMBER_MAP = {
+    两: 2,
+    二: 2,
+    三: 3,
+    四: 4,
+    五: 5,
+    六: 6,
+    七: 7,
+    八: 8,
+    九: 9,
+    十: 10,
+    十一: 11,
+    十二: 12,
+    十三: 13,
+    十四: 14,
+    十五: 15,
+};
+function trimNonEmpty(value) {
+    return value.trim();
+}
+function buildAutomaticImageRequest(index) {
+    return `在满足总体要求的前提下，生成第${index}张独立图片；允许构图、景别、姿态或细节自然变化，但不要输出拼图，也不要缺少图片。`;
+}
+function buildNormalizedMultiImagePrompt(sharedPrompt, imageRequests) {
+    const total = imageRequests.length;
+    const sections = [
+        `总体要求：${sharedPrompt.trim()}`,
+        `请一次性生成${total}张彼此独立的图片。必须返回${total}张单独图片，不要合并成拼图，不要只返回1张。`,
+        ...imageRequests.map((request, index) => `第${index + 1}张：${request.trim()}`),
+        `最终输出要求：严格返回${total}张独立图片，并分别对应第1张到第${total}张的描述。`,
+    ];
+    return sections.join('\n');
+}
+export function hasExplicitMultiImageStructure(prompt) {
+    return EXPLICIT_MULTI_IMAGE_PATTERNS.some((pattern) => pattern.test(prompt));
+}
+export function inferRequestedImageCount(prompt) {
+    const arabicMatch = prompt.match(/(?:生成|创建|做|出|给我|提供|返回|输出|一组|组|共|total)?\s*([2-9]|1[0-5])\s*(?:张|幅|个|套)\s*(?:图|图片|图像|海报|产品图)?/iu);
+    if (arabicMatch?.[1]) {
+        return Number.parseInt(arabicMatch[1], 10);
+    }
+    const englishMatch = prompt.match(/\b([2-9]|1[0-5])\s*(?:images?|variations?|shots?|posters?|renders?)\b/iu);
+    if (englishMatch?.[1]) {
+        return Number.parseInt(englishMatch[1], 10);
+    }
+    const chineseMatch = prompt.match(/(?:生成|创建|做|出|给我|提供|返回|输出|一组|组)?\s*(两|二|三|四|五|六|七|八|九|十|十一|十二|十三|十四|十五)\s*(?:张|幅|个|套)\s*(?:图|图片|图像|海报|产品图)?/iu);
+    if (chineseMatch?.[1]) {
+        return CHINESE_NUMBER_MAP[chineseMatch[1]];
+    }
+    return undefined;
+}
+export function extractExplicitImageRequests(prompt) {
+    const matches = Array.from(prompt.matchAll(EXPLICIT_MULTI_IMAGE_SECTION_REGEX));
+    if (!matches.length) {
+        return { imageRequests: [] };
+    }
+    const imageRequests = [];
+    for (let index = 0; index < matches.length; index++) {
+        const currentMatch = matches[index];
+        if (!currentMatch) {
+            continue;
+        }
+        const nextMatch = matches[index + 1];
+        const currentIndex = currentMatch.index;
+        if (currentIndex === undefined) {
+            continue;
+        }
+        const segmentStart = currentIndex + currentMatch[0].length;
+        const segmentEnd = nextMatch?.index ?? prompt.length;
+        const segment = prompt.slice(segmentStart, segmentEnd).trim();
+        if (segment) {
+            imageRequests.push(segment);
+        }
+    }
+    const firstMatchIndex = matches[0]?.index;
+    const sharedPrompt = firstMatchIndex !== undefined ? prompt.slice(0, firstMatchIndex).trim() || undefined : undefined;
+    return {
+        ...(sharedPrompt ? { sharedPrompt } : {}),
+        imageRequests,
+    };
+}
+export function buildIndependentImagePrompt(sharedPrompt, imageRequest) {
+    const parts = [
+        sharedPrompt?.trim(),
+        '只生成1张独立图片，不要拼图，不要四宫格，不要在同一画面中合成多张子图。',
+        imageRequest.trim(),
+    ].filter(Boolean);
+    return parts.join('\n\n');
+}
+export function prepareGenerateMultiImageParams(params) {
+    const inferredCount = params.outputCount ?? params.imageRequests?.length ?? inferRequestedImageCount(params.prompt);
+    if (inferredCount === undefined || inferredCount < 2) {
+        return Err(new InputValidationError('generate_multi_image requires a multi-image request with outputCount >= 2, imageRequests, or an explicit image count in the prompt', 'Provide outputCount, imageRequests, or mention an explicit count such as "4张图" or "4 images".'));
+    }
+    return Ok({
+        ...params,
+        outputCount: params.outputCount ?? inferredCount,
+    });
+}
+export function normalizeMultiImageParams(params) {
+    const imageRequests = params.imageRequests?.map(trimNonEmpty).filter(Boolean);
+    const requestedCount = imageRequests?.length ?? params.outputCount;
+    let prompt = params.prompt;
+    let promptWasNormalized = false;
+    if (imageRequests?.length) {
+        prompt = buildNormalizedMultiImagePrompt(params.prompt, imageRequests);
+        promptWasNormalized = true;
+    }
+    else if (params.outputCount && params.outputCount > 1 && !hasExplicitMultiImageStructure(params.prompt)) {
+        prompt = buildNormalizedMultiImagePrompt(params.prompt, Array.from({ length: params.outputCount }, (_, index) => buildAutomaticImageRequest(index + 1)));
+        promptWasNormalized = true;
+    }
+    const shouldPreserveMultiImagePrompt = params.skipPromptEnhancement === undefined &&
+        requestedCount !== undefined &&
+        requestedCount > 1 &&
+        (promptWasNormalized || hasExplicitMultiImageStructure(prompt));
+    return {
+        ...params,
+        prompt,
+        ...(imageRequests?.length ? { imageRequests } : {}),
+        ...(imageRequests?.length && params.outputCount === undefined ? { outputCount: imageRequests.length } : {}),
+        ...(shouldPreserveMultiImagePrompt ? { skipPromptEnhancement: true } : {}),
+    };
+}
+//# sourceMappingURL=multiImagePrompt.js.map

package/dist/business/multiImagePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiImagePrompt.js","sourceRoot":"","sources":["../../src/business/multiImagePrompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,6BAA6B,GAAG;IACpC,8BAA8B;IAC9B,wBAAwB;IACxB,uBAAuB;IACvB,4BAA4B;IAC5B,kFAAkF;CACnF,CAAA;AACD,MAAM,kCAAkC,GACtC,mYAAmY,CAAA;AAErY,MAAM,kBAAkB,GAA2B;IACjD,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE;IACL,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE;CACP,CAAA;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa;IAC/C,OAAO,kBAAkB,KAAK,0CAA0C,CAAA;AAC1E,CAAC;AAED,SAAS,+BAA+B,CAAC,YAAoB,EAAE,aAAuB;IACpF,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAA;IAClC,MAAM,QAAQ,GAAG;QACf,QAAQ,YAAY,CAAC,IAAI,EAAE,EAAE;QAC7B,SAAS,KAAK,gBAAgB,KAAK,wBAAwB;QAC3D,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5E,cAAc,KAAK,mBAAmB,KAAK,OAAO;KACnD,CAAA;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAc;IAC3D,OAAO,6BAA6B,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;AAC9E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAC9B,gGAAgG,CACjG,CAAA;IACD,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAA;IAC5G,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAC/B,8GAA8G,CAC/G,CAAA;IACD,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,CAAA;IAC/E,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;IAC9B,CAAC;IAED,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACpC,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAA;QACvC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,SAAQ;QACV,CAAC;QAED,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC1D,MAAM,UAAU,GAAG,SAAS,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAA;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7D,IAAI,OAAO,EAAE,CAAC;YACZ,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAA;IACzC,MAAM,YAAY,GAChB,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IAElG,OAAO;QACL,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,aAAa;KACd,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,YAAgC,EAAE,YAAoB;IAChG,MAAM,KAAK,GAAG;QACZ,YAAY,EAAE,IAAI,EAAE;QACpB,sCAAsC;QACtC,YAAY,CAAC,IAAI,EAAE;KACpB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAA2B;IAE3B,MAAM,aAAa,GACjB,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,IAAI,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAE/F,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,GAAG,CACR,IAAI,oBAAoB,CACtB,oIAAoI,EACpI,+FAA+F,CAChG,CACF,CAAA;IACH,CAAC;IAED,OAAO,EAAE,CAAC;QACR,GAAG,MAAM;QACT,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa;KACjD,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAA2B;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7E,MAAM,cAAc,GAAG,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC,WAAW,CAAA;IAClE,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC1B,IAAI,mBAAmB,GAAG,KAAK,CAAA;IAE/B,IAAI,aAAa,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,+BAA+B,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;QACtE,mBAAmB,GAAG,IAAI,CAAA;IAC5B,CAAC;SAAM,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1G,MAAM,GAAG,+BAA+B,CACtC,MAAM,CAAC,MAAM,EACb,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAChG,CAAA;QACD,mBAAmB,GAAG,IAAI,CAAA;IAC5B,CAAC;IAED,MAAM,8BAA8B,GAClC,MAAM,CAAC,qBAAqB,KAAK,SAAS;QAC1C,cAAc,KAAK,SAAS;QAC5B,cAAc,GAAG,CAAC;QAClB,CAAC,mBAAmB,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAA;IAEjE,OAAO;QACL,GAAG,MAAM;QACT,MAAM;QACN,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAA;AACH,CAAC"}

package/dist/business/responseBuilder.d.ts

@@ -2,7 +2,7 @@
  * Response Builder for MCP structured content responses
  * Converts generation results and errors into MCP-compatible response format
  */
-import type { GeneratedImageResult } from '../api/geminiClient.js';
+import type { GeneratedImageResult } from '../api/imageProvider.js';
 import type { McpToolResponse } from '../types/mcp.js';
 import { type BaseError } from '../utils/errors.js';
 /**
@@ -10,7 +10,8 @@ import { type BaseError } from '../utils/errors.js';
  */
 export interface ResponseBuilder {
     buildSuccessResponse(generationResult: GeneratedImageResult, filePath: string): McpToolResponse;
-    buildBase64SuccessResponse(generationResult: GeneratedImageResult, filePath: string, base64Data: string): McpToolResponse;
+    buildMultiSuccessResponse(generationResult: GeneratedImageResult, filePaths: string[]): McpToolResponse;
+    buildBase64SuccessResponse(generationResult: GeneratedImageResult, filePaths: string[]): McpToolResponse;
     buildErrorResponse(error: BaseError | Error): McpToolResponse;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"responseBuilder.d.ts","sourceRoot":"","sources":["../../src/business/responseBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,iBAAiB,CAAA;AACzE,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,oBAAoB,CAAA;AAmB3B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;IAC/F,0BAA0B,CACxB,gBAAgB,EAAE,oBAAoB,EACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,eAAe,CAAA;IAClB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,eAAe,CAAA;CAC9D;AA+DD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CA0GvD"}
+{"version":3,"file":"responseBuilder.d.ts","sourceRoot":"","sources":["../../src/business/responseBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAA4C,MAAM,iBAAiB,CAAA;AAChG,OAAO,EACL,KAAK,SAAS,EAQf,MAAM,oBAAoB,CAAA;AA6E3B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;IAC/F,yBAAyB,CACvB,gBAAgB,EAAE,oBAAoB,EACtC,SAAS,EAAE,MAAM,EAAE,GAClB,eAAe,CAAA;IAClB,0BAA0B,CACxB,gBAAgB,EAAE,oBAAoB,EACtC,SAAS,EAAE,MAAM,EAAE,GAClB,eAAe,CAAA;IAClB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,eAAe,CAAA;CAC9D;AAgED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAgFvD"}

package/dist/business/responseBuilder.js

@@ -3,7 +3,8 @@
  * Converts generation results and errors into MCP-compatible response format
  */
 import * as path from 'node:path';
-import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, SecurityError, } from '../utils/errors.js';
+import { pathToFileURL } from 'node:url';
+import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, SecurityError, VolcengineAPIError, } from '../utils/errors.js';
 // Constants for MIME types and error handling
 const MIME_TYPES = {
     PNG: 'image/png',
@@ -18,6 +19,53 @@ const FILE_EXTENSIONS = {
 const DEFAULT_MIME_TYPE = MIME_TYPES.PNG;
 const UNKNOWN_ERROR_CODE = 'UNKNOWN_ERROR';
 const DEFAULT_ERROR_SUGGESTION = 'Please try again or contact support if the problem persists';
+function toFileUri(filePath) {
+    return pathToFileURL(path.resolve(filePath)).toString();
+}
+function createMetadata(generationResult, imageCount) {
+    return {
+        model: generationResult.metadata.model,
+        processingTime: 0,
+        contextMethod: 'structured_prompt',
+        timestamp: generationResult.metadata.timestamp.toISOString(),
+        imageCount,
+    };
+}
+function createFileDescriptor(filePath, index, total) {
+    const fileName = path.basename(filePath);
+    const ordinal = total > 1 ? ` ${index + 1}` : '';
+    return {
+        uri: toFileUri(filePath),
+        name: fileName,
+        title: fileName,
+        mimeType: getMimeTypeFromPath(filePath),
+        description: `Generated image${ordinal}`,
+    };
+}
+function toResourceLinkContent(file) {
+    return {
+        type: 'resource_link',
+        ...file,
+    };
+}
+function createStructuredContent(generationResult, filePaths, base64Included = false) {
+    return {
+        type: 'image_result',
+        files: filePaths.map((filePath, index) => createFileDescriptor(filePath, index, filePaths.length)),
+        ...(base64Included ? { base64Included: true } : {}),
+        metadata: createMetadata(generationResult, filePaths.length),
+    };
+}
+function getGeneratedVariants(generationResult) {
+    return generationResult.images?.length
+        ? generationResult.images
+        : [
+            {
+                imageData: generationResult.imageData,
+                mimeType: generationResult.metadata.mimeType,
+            },
+        ];
+}
 /**
  * Determines MIME type based on file extension
  * @param filePath Path to the image file
@@ -48,6 +96,7 @@ function convertErrorToStructured(error) {
     if (error instanceof InputValidationError ||
         error instanceof FileOperationError ||
         error instanceof GeminiAPIError ||
+        error instanceof VolcengineAPIError ||
         error instanceof NetworkError ||
         error instanceof ConfigError ||
         error instanceof SecurityError) {
@@ -79,31 +128,18 @@ export function createResponseBuilder() {
          * @returns MCP tool response with structured content containing file path
          */
         buildSuccessResponse(generationResult, filePath) {
-            // File-based implementation: Always return file path, never base64
-            // This avoids MCP token limit issues (25,000 tokens max)
-            const mimeType = getMimeTypeFromPath(filePath);
-            const fileName = path.basename(filePath);
-            const structuredContent = {
-                type: 'resource',
-                resource: {
-                    uri: `file://${filePath}`,
-                    name: fileName,
-                    mimeType,
-                },
-                metadata: {
-                    model: generationResult.metadata.model,
-                    processingTime: 0, // Not tracked in simplified version
-                    contextMethod: 'structured_prompt',
-                    timestamp: generationResult.metadata.timestamp.toISOString(),
-                },
+            const structuredContent = createStructuredContent(generationResult, [filePath]);
+            return {
+                content: structuredContent.files.map((file) => toResourceLinkContent(file)),
+                structuredContent,
+                isError: false,
             };
+        },
+        buildMultiSuccessResponse(generationResult, filePaths) {
+            const structuredContent = createStructuredContent(generationResult, filePaths);
             return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(structuredContent),
-                    },
-                ],
+                content: structuredContent.files.map((file) => toResourceLinkContent(file)),
+                structuredContent,
                 isError: false,
             };
         },
@@ -114,31 +150,16 @@ export function createResponseBuilder() {
          * @param base64Data Base64 encoded image data
          * @returns MCP tool response with both file URI and base64 data
          */
-        buildBase64SuccessResponse(generationResult, filePath, base64Data) {
-            const mimeType = getMimeTypeFromPath(filePath);
-            const fileName = path.basename(filePath);
-            const responseData = {
-                type: 'resource',
-                resource: {
-                    uri: `file://${filePath}`,
-                    name: fileName,
-                    mimeType,
-                },
-                base64Data,
-                metadata: {
-                    model: generationResult.metadata.model,
-                    processingTime: 0,
-                    contextMethod: 'structured_prompt',
-                    timestamp: generationResult.metadata.timestamp.toISOString(),
-                },
-            };
+        buildBase64SuccessResponse(generationResult, filePaths) {
+            const structuredContent = createStructuredContent(generationResult, filePaths, true);
+            const imageContents = getGeneratedVariants(generationResult).map((variant) => ({
+                type: 'image',
+                data: variant.imageData.toString('base64'),
+                mimeType: variant.mimeType,
+            }));
             return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(responseData),
-                    },
-                ],
+                content: [...imageContents, ...structuredContent.files.map((file) => toResourceLinkContent(file))],
+                structuredContent,
                 isError: false,
             };
         },

package/dist/business/responseBuilder.js.map

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

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * - skills install  → bin/install-skills.js
  * - (default)       → MCP server startup
  */
-export type { GeneratedImageResult } from './api/geminiClient.js';
+export type { GeneratedImageResult } from './api/imageProvider.js';
 export { createMCPServer, MCPServerImpl } from './server/mcpServer.js';
 export type { GenerateImageParams, MCPServerConfig } from './types/mcp.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAwBH,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAwBH,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/server/errorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/server/errorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAA;AAM3B;;;;GAIG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAqBlD;AAED;;;;;GAKG;AACH,iBAAe,kBAAkB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAa3B;AA2DD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAA"}
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/server/errorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAOL,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAA;AAM3B;;;;GAIG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAqBlD;AAED;;;;;GAKG;AACH,iBAAe,kBAAkB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAa3B;AA4DD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAA"}

package/dist/server/errorHandler.js

@@ -2,7 +2,7 @@
  * Error Handler utility for unified error processing
  * Provides centralized error handling and Result type wrapping
  */
-import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, } from '../utils/errors.js';
+import { ConfigError, FileOperationError, GeminiAPIError, InputValidationError, NetworkError, VolcengineAPIError, } from '../utils/errors.js';
 import { Logger } from '../utils/logger.js';
 // Create logger instance for error handling
 const logger = new Logger();
@@ -62,6 +62,7 @@ function convertErrorToStructured(error) {
     if (error instanceof InputValidationError ||
         error instanceof FileOperationError ||
         error instanceof GeminiAPIError ||
+        error instanceof VolcengineAPIError ||
         error instanceof NetworkError ||
         error instanceof ConfigError) {
         const errorResponse = {
@@ -71,7 +72,7 @@ function convertErrorToStructured(error) {
             suggestion: error.suggestion,
         };
         // Include context details for GeminiAPIError to provide better debugging info
-        if (error instanceof GeminiAPIError && error.context) {
+        if ((error instanceof GeminiAPIError || error instanceof VolcengineAPIError) && error.context) {
             // Add non-sensitive context information
             const { suggestion, ...otherContext } = error.context;
             if (Object.keys(otherContext).length > 0) {

package/dist/server/errorHandler.js.map

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

package/dist/server/mcpServer.d.ts

@@ -1,12 +1,9 @@
 /**
  * MCP Server implementation
- * Simplified architecture with direct Gemini integration
+ * Supports multiple image providers with Gemini prompt enhancement when applicable
  */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { MCPServerConfig } from '../types/mcp.js';
-/**
- * Simplified MCP server
- */
 export declare class MCPServerImpl {
     private config;
     private server;
@@ -17,17 +14,12 @@ export declare class MCPServerImpl {
     private structuredPromptGenerator;
     private geminiTextClient;
     private geminiClient;
+    private volcengineClient;
     constructor(config?: Partial<MCPServerConfig>);
-    /**
-     * Get server info
-     */
     getServerInfo(): {
         name: string;
         version: string;
     };
-    /**
-     * Get list of registered tools
-     */
     getToolsList(): {
         tools: {
             name: string;
@@ -39,6 +31,11 @@ export declare class MCPServerImpl {
                         type: "string";
                         description: string;
                     };
+                    provider: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
                     fileName: {
                         type: "string";
                         description: string;
@@ -122,6 +119,22 @@ export declare class MCPServerImpl {
                         description: string;
                         enum: string[];
                     };
+                    outputFormat: {
+                        type: "string";
+                        description: string;
+                        enum: string[];
+                    };
+                    outputCount: {
+                        type: "integer";
+                        description: string;
+                    };
+                    imageRequests: {
+                        type: "array";
+                        description: string;
+                        items: {
+                            type: "string";
+                        };
+                    };
                     skipPromptEnhancement: {
                         type: "boolean";
                         description: string;
@@ -129,31 +142,79 @@ export declare class MCPServerImpl {
                 };
                 required: string[];
             };
+            outputSchema: {
+                type: "object";
+                properties: {
+                    type: {
+                        type: "string";
+                        const: string;
+                    };
+                    files: {
+                        type: "array";
+                        items: {
+                            type: "object";
+                            properties: {
+                                uri: {
+                                    type: "string";
+                                };
+                                name: {
+                                    type: "string";
+                                };
+                                title: {
+                                    type: "string";
+                                };
+                                mimeType: {
+                                    type: "string";
+                                };
+                                description: {
+                                    type: "string";
+                                };
+                            };
+                            required: string[];
+                        };
+                    };
+                    base64Included: {
+                        type: "boolean";
+                    };
+                    metadata: {
+                        type: "object";
+                        properties: {
+                            model: {
+                                type: "string";
+                            };
+                            processingTime: {
+                                type: "number";
+                            };
+                            contextMethod: {
+                                type: "string";
+                            };
+                            timestamp: {
+                                type: "string";
+                            };
+                            imageCount: {
+                                type: "integer";
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                required: string[];
+            };
         }[];
     };
-    /**
-     * Tool execution
-     */
     callTool(name: string, args: unknown): Promise<import("../types/mcp.js").McpToolResponse>;
-    /**
-     * Initialize Gemini clients lazily
-     */
-    private initializeClients;
-    /**
-     * Simplified image generation handler
-     */
+    private initializeGeminiSupport;
+    private initializeVolcengineSupport;
+    private getProviderClient;
+    private prepareInputImages;
+    private maybeEnhancePrompt;
+    private buildSuccessResponse;
+    private getGeneratedVariants;
+    private generateAndSave;
+    private handleGenerateMultiImage;
     private handleGenerateImage;
-    /**
-     * Initialize MCP server with tool handlers
-     */
     initialize(): Server;
-    /**
-     * Setup MCP protocol handlers
-     */
     private setupHandlers;
 }
-/**
- * Factory function to create MCP server
- */
 export declare function createMCPServer(config?: Partial<MCPServerConfig>): MCPServerImpl;
 //# sourceMappingURL=mcpServer.d.ts.map

package/dist/server/mcpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../src/server/mcpServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAoBlE,OAAO,KAAK,EAAuB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAiB3E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,yBAAyB,CAAyC;IAC1E,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,YAAY,CAA4B;gBAEpC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD;;OAEG;IACI,aAAa;;;;IAOpB;;OAEG;IACI,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwJnB;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAYjD;;OAEG;YACW,iBAAiB;IAkC/B;;OAEG;YACW,mBAAmB;IA2KjC;;OAEG;IACI,UAAU,IAAI,MAAM;IAmB3B;;OAEG;IACH,OAAO,CAAC,aAAa;CA0BtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,iBAEpE"}
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../src/server/mcpServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAyBlE,OAAO,KAAK,EAAsC,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAqM1F,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,yBAAyB,CAAyC;IAC1E,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQ1C,aAAa;;;;IAOb,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqBN,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;YAenC,uBAAuB;YA6BvB,2BAA2B;IAgBzC,OAAO,CAAC,iBAAiB;YAcX,kBAAkB;YA8ClB,kBAAkB;IAyDhC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;YAMd,eAAe;YA2Ff,wBAAwB;YA4ExB,mBAAmB;IAiB1B,UAAU,IAAI,MAAM;IAkB3B,OAAO,CAAC,aAAa;CAwBtB;AAED,wBAAgB,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,iBAEpE"}