pabal-resource-mcp 1.8.12 → 1.9.1

package/README.md

@@ -6,7 +6,7 @@ Build synced websites from App Store Connect and Google Play Console data.
 
 > 💡 **Example**: [labs.quartz.best](https://labs.quartz.best/)
 
-[![Documentation](https://img.shields.io/badge/docs-English-blue)](https://pabal.quartz.best/docs/en-US/pabal-store-api-mcp/README) [![한국어](https://img.shields.io/badge/docs-한국어-green)](https://pabal.quartz.best/docs/ko-KR/pabal-store-api-mcp/README)
+[![Documentation](https://img.shields.io/badge/docs-English-blue)](https://pabal.quartz.best/en-US/docs/pabal-resource-mcp/README) [![한국어](https://img.shields.io/badge/docs-한국어-green)](https://pabal.quartz.best/ko-KR/docs/pabal-resource-mcp/README)
 
 ## Installation
 
@@ -61,7 +61,7 @@ Set `dataDir` in `~/.config/pabal-mcp/config.json`:
 | App Icon    | `generate-app-icons`                                                                   |
 | Content     | `create-blog-html`                                                                     |
 
-See [documentation](./docs/en-US/README.md) for details.
+See [documentation](https://pabal.quartz.best/en-US/docs/pabal-resource-mcp/README) for details.
 
 ## License
 

package/dist/bin/mcp-server.js

@@ -3398,8 +3398,8 @@ Context around ${pos}: ${context}`
 // src/tools/screenshots/translate-screenshots.ts
 import { z as z7 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema7 } from "zod-to-json-schema";
-import fs11 from "fs";
-import path11 from "path";
+import fs12 from "fs";
+import path12 from "path";
 
 // src/tools/screenshots/utils/scan-screenshots.util.ts
 import fs9 from "fs";
@@ -3481,10 +3481,161 @@ function scanRawScreenshots(slug, locale) {
 }
 
 // src/tools/screenshots/utils/gemini-image-translator.util.ts
+import fs11 from "fs";
+import path11 from "path";
+import sharp from "sharp";
+
+// src/utils/gemini-image-model.util.ts
+var GEMINI_IMAGE_MODEL_PRESETS = {
+  flash: "gemini-3.1-flash-image-preview",
+  pro: "gemini-3-pro-image-preview"
+};
+var GEMINI_IMAGE_MODEL_VALUES = Object.keys(
+  GEMINI_IMAGE_MODEL_PRESETS
+);
+var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 503, 504]);
+function parseCsv(value) {
+  if (!value) {
+    return [];
+  }
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function getStatusCode(error) {
+  if (typeof error !== "object" || error === null) {
+    return void 0;
+  }
+  const status = error.status;
+  return typeof status === "number" ? status : void 0;
+}
+function getDefaultModelOrder(preference) {
+  if (preference === "pro") {
+    return [
+      GEMINI_IMAGE_MODEL_PRESETS.pro,
+      GEMINI_IMAGE_MODEL_PRESETS.flash
+    ];
+  }
+  return [
+    GEMINI_IMAGE_MODEL_PRESETS.flash,
+    GEMINI_IMAGE_MODEL_PRESETS.pro
+  ];
+}
+function getGeminiImageModelCandidates(preference = "flash") {
+  const defaultOrder = getDefaultModelOrder(preference);
+  const preferredModel = defaultOrder[0];
+  const envModelOverride = process.env.GEMINI_IMAGE_MODEL?.trim();
+  const fallbackModels = parseCsv(process.env.GEMINI_IMAGE_FALLBACK_MODELS);
+  const orderedModels = [
+    preferredModel,
+    ...envModelOverride ? [envModelOverride] : [],
+    ...defaultOrder,
+    ...fallbackModels
+  ];
+  return Array.from(
+    new Set(orderedModels.filter((model) => Boolean(model)))
+  );
+}
+function getGeminiErrorMessage(error) {
+  const defaultMessage = error instanceof Error ? error.message : String(error);
+  const normalizedMessage = defaultMessage.replace(/^exception\s*/i, "").trim();
+  try {
+    const parsed = JSON.parse(normalizedMessage);
+    const apiMessage = parsed?.error?.message;
+    if (typeof apiMessage === "string" && apiMessage.trim()) {
+      return apiMessage.trim();
+    }
+  } catch {
+  }
+  return normalizedMessage || "Unknown Gemini API error";
+}
+function shouldTryNextGeminiImageModel(error) {
+  const status = getStatusCode(error);
+  if (status && RETRYABLE_STATUS_CODES.has(status)) {
+    return true;
+  }
+  const message = getGeminiErrorMessage(error).toLowerCase();
+  return message.includes("high demand") || message.includes("temporarily unavailable") || message.includes("try again later") || message.includes("overloaded") || message.includes("resource_exhausted") || message.includes("unavailable");
+}
+
+// src/utils/gemini-client.util.ts
 import { GoogleGenAI } from "@google/genai";
+function createGeminiClient() {
+  const apiKey = getGeminiApiKey();
+  return new GoogleGenAI({ apiKey });
+}
+
+// src/utils/image-file.util.ts
 import fs10 from "fs";
 import path10 from "path";
-import sharp from "sharp";
+function readImageAsBase64(imagePath) {
+  const buffer = fs10.readFileSync(imagePath);
+  const base64 = buffer.toString("base64");
+  const ext = path10.extname(imagePath).toLowerCase();
+  let mimeType = "image/png";
+  if (ext === ".jpg" || ext === ".jpeg") {
+    mimeType = "image/jpeg";
+  } else if (ext === ".webp") {
+    mimeType = "image/webp";
+  }
+  return { data: base64, mimeType };
+}
+
+// src/utils/gemini-image-generation.util.ts
+async function generateImageWithFallback(input) {
+  const models = getGeminiImageModelCandidates(input.imageModel);
+  let lastError;
+  for (const model of models) {
+    try {
+      const chat = input.client.chats.create({
+        model,
+        config: {
+          responseModalities: ["TEXT", "IMAGE"]
+        }
+      });
+      const response = await chat.sendMessage({
+        message: [
+          { text: input.prompt },
+          {
+            inlineData: {
+              mimeType: input.image.mimeType,
+              data: input.image.data
+            }
+          }
+        ],
+        config: {
+          responseModalities: ["TEXT", "IMAGE"],
+          ...input.aspectRatio ? {
+            imageConfig: {
+              aspectRatio: input.aspectRatio
+            }
+          } : {}
+        }
+      });
+      const parts = response.candidates?.[0]?.content?.parts;
+      if (!parts) {
+        throw new Error("No content parts in Gemini response");
+      }
+      for (const part of parts) {
+        if (part.inlineData?.data) {
+          return {
+            model,
+            imageBase64: part.inlineData.data
+          };
+        }
+      }
+      throw new Error("No image data in Gemini response");
+    } catch (error) {
+      lastError = error;
+      if (!shouldTryNextGeminiImageModel(error)) {
+        break;
+      }
+    }
+  }
+  throw new Error(
+    `All Gemini image models failed (${models.join(", ")}): ${getGeminiErrorMessage(lastError)}`
+  );
+}
+
+// src/tools/screenshots/utils/gemini-image-translator.util.ts
 var GEMINI_ASPECT_RATIOS = {
   "1:1": { ratio: 1 / 1, width: 2048, height: 2048 },
   "2:3": { ratio: 2 / 3, width: 1696, height: 2528 },
@@ -3524,35 +3675,18 @@ function getLanguageName(locale) {
   }
   return locale;
 }
-function getGeminiClient() {
-  const apiKey = getGeminiApiKey();
-  return new GoogleGenAI({ apiKey });
-}
-function readImageAsBase64(imagePath) {
-  const buffer = fs10.readFileSync(imagePath);
-  const base64 = buffer.toString("base64");
-  const ext = path10.extname(imagePath).toLowerCase();
-  let mimeType = "image/png";
-  if (ext === ".jpg" || ext === ".jpeg") {
-    mimeType = "image/jpeg";
-  } else if (ext === ".webp") {
-    mimeType = "image/webp";
-  }
-  return { data: base64, mimeType };
-}
 function getAspectRatioForDevice(deviceType) {
   return DEVICE_ASPECT_RATIOS[deviceType];
 }
-async function translateImage(sourcePath, sourceLocale, targetLocale, outputPaths, deviceType, preserveWords) {
-  try {
-    const client = getGeminiClient();
-    const sourceLanguage = getLanguageName(sourceLocale);
-    const targetLanguage = getLanguageName(targetLocale);
-    const aspectRatio = getAspectRatioForDevice(deviceType);
-    const { data: imageData, mimeType } = readImageAsBase64(sourcePath);
-    const preserveInstruction = preserveWords && preserveWords.length > 0 ? `
+async function translateImage(sourcePath, sourceLocale, targetLocale, outputPaths, deviceType, preserveWords, imageModel = "flash") {
+  const client = createGeminiClient();
+  const sourceLanguage = getLanguageName(sourceLocale);
+  const targetLanguage = getLanguageName(targetLocale);
+  const aspectRatio = getAspectRatioForDevice(deviceType);
+  const { data: imageData, mimeType } = readImageAsBase64(sourcePath);
+  const preserveInstruction = preserveWords && preserveWords.length > 0 ? `
 - Do NOT translate these words, keep them exactly as-is: ${preserveWords.join(", ")}` : "";
-    const prompt = `This is an app screenshot with text in ${sourceLanguage}.
+  const prompt = `This is an app screenshot with text in ${sourceLanguage}.
 Please translate ONLY the text/words in this image to ${targetLanguage}.
 
 IMPORTANT INSTRUCTIONS:
@@ -3562,73 +3696,38 @@ IMPORTANT INSTRUCTIONS:
 - Do NOT add any new elements or remove existing design elements
 - The output should look identical except the text language is ${targetLanguage}
 - Preserve all icons, images, and graphical elements exactly as they are${preserveInstruction}`;
-    const chat = client.chats.create({
-      model: "gemini-3-pro-image-preview",
-      config: {
-        responseModalities: ["TEXT", "IMAGE"]
-      }
-    });
-    const response = await chat.sendMessage({
-      message: [
-        { text: prompt },
-        {
-          inlineData: {
-            mimeType,
-            data: imageData
-          }
-        }
-      ],
-      config: {
-        responseModalities: ["TEXT", "IMAGE"],
-        imageConfig: {
-          aspectRatio
-        }
-      }
+  try {
+    const generated = await generateImageWithFallback({
+      client,
+      prompt,
+      image: {
+        mimeType,
+        data: imageData
+      },
+      aspectRatio,
+      imageModel
     });
-    const candidates = response.candidates;
-    if (!candidates || candidates.length === 0) {
-      return {
-        success: false,
-        error: "No response from Gemini API"
-      };
-    }
-    const parts = candidates[0].content?.parts;
-    if (!parts) {
-      return {
-        success: false,
-        error: "No content parts in response"
-      };
-    }
-    for (const part of parts) {
-      if (part.inlineData?.data) {
-        const imageBuffer = Buffer.from(part.inlineData.data, "base64");
-        for (const outputPath of outputPaths) {
-          const outputDir = path10.dirname(outputPath);
-          if (!fs10.existsSync(outputDir)) {
-            fs10.mkdirSync(outputDir, { recursive: true });
-          }
-          await sharp(imageBuffer).png().toFile(outputPath);
-        }
-        return {
-          success: true,
-          outputPath: outputPaths[0]
-          // Return primary path
-        };
+    const imageBuffer = Buffer.from(generated.imageBase64, "base64");
+    for (const outputPath of outputPaths) {
+      const outputDir = path11.dirname(outputPath);
+      if (!fs11.existsSync(outputDir)) {
+        fs11.mkdirSync(outputDir, { recursive: true });
       }
+      await sharp(imageBuffer).png().toFile(outputPath);
     }
     return {
-      success: false,
-      error: "No image data in Gemini response"
+      success: true,
+      outputPath: outputPaths[0]
+      // Return primary path
     };
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
     return {
       success: false,
-      error: message
+      error: error instanceof Error ? error.message : String(error)
     };
   }
 }
-async function translateImagesWithProgress(translations, onProgress, preserveWords) {
+async function translateImagesWithProgress(translations, onProgress, preserveWords, imageModel = "flash") {
   let successful = 0;
   let failed = 0;
   const errors = [];
@@ -3652,7 +3751,8 @@ async function translateImagesWithProgress(translations, onProgress, preserveWor
       translation.targetLocale,
       translation.outputPaths,
       translation.deviceType,
-      preserveWords
+      preserveWords,
+      imageModel
     );
     if (result.success) {
       successful++;
@@ -3671,6 +3771,9 @@ async function translateImagesWithProgress(translations, onProgress, preserveWor
   }
   return { successful, failed, errors };
 }
+function getImageModelLabel(imageModel) {
+  return `${imageModel} (${GEMINI_IMAGE_MODEL_PRESETS[imageModel]})`;
+}
 
 // src/tools/screenshots/utils/locale-mapping.constants.ts
 var GEMINI_LOCALE_GROUPS = {
@@ -3773,6 +3876,9 @@ var translateScreenshotsInputSchema = z7.object({
   ),
   preserveWords: z7.array(z7.string()).optional().describe(
     'Words to keep untranslated (e.g., brand names, product names). Example: ["Pabal", "Pro", "AI"]'
+  ),
+  imageModel: z7.enum(GEMINI_IMAGE_MODEL_VALUES).optional().default("flash").describe(
+    "Gemini image model preference. 'flash' (default) is faster/cheaper, 'pro' prioritizes quality."
   )
 });
 var jsonSchema7 = zodToJsonSchema7(translateScreenshotsInputSchema, {
@@ -3798,6 +3904,10 @@ Use \`resize-screenshots\` after this tool to resize images to final dimensions.
 - Screenshots must be in: public/products/{slug}/screenshots/{locale}/phone/ and /tablet/
 - Locale files must exist in: public/products/{slug}/locales/
 
+**Model Selection:**
+- \`imageModel: "flash"\` (default) for speed/cost
+- \`imageModel: "pro"\` for higher instruction fidelity
+
 **Example output structure:**
 \`\`\`
 public/products/my-app/screenshots/
@@ -3873,14 +3983,14 @@ function buildTranslationTasks(slug, screenshots, primaryLocale, targetLocales,
     for (const screenshot of screenshots) {
       const outputPaths = [];
       for (const locale of outputLocales) {
-        const outputPath = path11.join(
+        const outputPath = path12.join(
           screenshotsDir,
           locale,
           screenshot.type,
           "raw",
           screenshot.filename
         );
-        if (!skipExisting || !fs11.existsSync(outputPath)) {
+        if (!skipExisting || !fs12.existsSync(outputPath)) {
           outputPaths.push(outputPath);
         }
       }
@@ -3907,7 +4017,8 @@ async function handleTranslateScreenshots(input) {
     dryRun = false,
     skipExisting = true,
     screenshotNumbers,
-    preserveWords
+    preserveWords,
+    imageModel = "flash"
   } = input;
   const results = [];
   let appInfo;
@@ -3960,6 +4071,7 @@ async function handleTranslateScreenshots(input) {
     };
   }
   results.push(`\u{1F3AF} Target locales to translate: ${targetLocales.join(", ")}`);
+  results.push(`\u{1F9E0} Image model: ${getImageModelLabel(imageModel)}`);
   if (groupedLocales.length > 0) {
     results.push(
       `\u{1F4CB} Grouped locales (saved together): ${groupedLocales.join(", ")}`
@@ -4087,9 +4199,9 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
   }
   for (const task of tasks) {
     for (const outputPath of task.outputPaths) {
-      const outputDir = path11.dirname(outputPath);
-      if (!fs11.existsSync(outputDir)) {
-        fs11.mkdirSync(outputDir, { recursive: true });
+      const outputDir = path12.dirname(outputPath);
+      if (!fs12.existsSync(outputDir)) {
+        fs12.mkdirSync(outputDir, { recursive: true });
       }
     }
   }
@@ -4111,7 +4223,8 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
         );
       }
     },
-    preserveWords
+    preserveWords,
+    imageModel
   );
   results.push(`
 \u{1F4CA} Translation Results:`);
@@ -4121,7 +4234,7 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
     results.push(`
 \u26A0\uFE0F Errors:`);
     for (const err of translationResult.errors.slice(0, 5)) {
-      results.push(`   - ${path11.basename(err.path)}: ${err.error}`);
+      results.push(`   - ${path12.basename(err.path)}: ${err.error}`);
     }
     if (translationResult.errors.length > 5) {
       results.push(
@@ -4149,12 +4262,12 @@ ${screenshotsDir2}/${primaryLocale}/tablet/1.png, 2.png, ...`
 // src/tools/screenshots/resize-screenshots.ts
 import { z as z8 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema8 } from "zod-to-json-schema";
-import fs13 from "fs";
-import path12 from "path";
+import fs14 from "fs";
+import path13 from "path";
 
 // src/tools/screenshots/utils/image-resizer.util.ts
 import sharp2 from "sharp";
-import fs12 from "fs";
+import fs13 from "fs";
 var SCREENSHOT_DIMENSIONS = {
   phone: { width: 1242, height: 2688 },
   tablet: { width: 2048, height: 2732 }
@@ -4253,7 +4366,7 @@ async function resizeImage(inputPath, outputPath, targetDimensions, bgColor) {
     kernel: "lanczos3"
     // High-quality downscaling algorithm
   }).flatten({ background: backgroundColor }).png().toFile(outputPath + ".tmp");
-  fs12.renameSync(outputPath + ".tmp", outputPath);
+  fs13.renameSync(outputPath + ".tmp", outputPath);
 }
 
 // src/tools/screenshots/resize-screenshots.ts
@@ -4349,6 +4462,10 @@ function buildResizeTasks(slug, sourceScreenshots, rawLocales, deviceTypes, scre
     const key = `${screenshot.type}/${screenshot.filename}`;
     sourceRefMap.set(key, screenshot.fullPath);
   }
+  const sourceHasByDevice = {
+    phone: sourceScreenshots.some((s) => s.type === "phone"),
+    tablet: sourceScreenshots.some((s) => s.type === "tablet")
+  };
   for (const locale of rawLocales) {
     const rawScreenshots = scanRawScreenshots(slug, locale);
     let filteredScreenshots = rawScreenshots.filter(
@@ -4372,16 +4489,16 @@ function buildResizeTasks(slug, sourceScreenshots, rawLocales, deviceTypes, scre
     for (const screenshot of filteredScreenshots) {
       const key = `${screenshot.type}/${screenshot.filename}`;
       const sourceReferencePath = sourceRefMap.get(key);
-      if (!sourceReferencePath) {
+      if (!sourceReferencePath && sourceHasByDevice[screenshot.type]) {
         continue;
       }
-      const outputPath = path12.join(
+      const outputPath = path13.join(
         screenshotsDir,
         locale,
         screenshot.type,
         screenshot.filename
       );
-      if (skipExisting && fs13.existsSync(outputPath)) {
+      if (skipExisting && fs14.existsSync(outputPath)) {
         continue;
       }
       tasks.push({
@@ -4413,7 +4530,7 @@ async function batchResizeFromRaw(tasks, bgColor, onProgress) {
     };
     onProgress?.(progress);
     try {
-      if (!fs13.existsSync(task.rawPath)) {
+      if (!fs14.existsSync(task.rawPath)) {
         progress.status = "skipped";
         onProgress?.(progress);
         skippedCount++;
@@ -4421,9 +4538,9 @@ async function batchResizeFromRaw(tasks, bgColor, onProgress) {
       }
       const targetDimensions = SCREENSHOT_DIMENSIONS[task.deviceType];
       const rawDimensions = await getImageDimensions(task.rawPath);
-      const outputDir = path12.dirname(task.outputPath);
-      if (!fs13.existsSync(outputDir)) {
-        fs13.mkdirSync(outputDir, { recursive: true });
+      const outputDir = path13.dirname(task.outputPath);
+      if (!fs14.existsSync(outputDir)) {
+        fs14.mkdirSync(outputDir, { recursive: true });
       }
       await resizeImage(task.rawPath, task.outputPath, targetDimensions, bgColor);
       progress.status = "completed";
@@ -4650,7 +4767,7 @@ Available locales with raw/: ${allRawLocales.join(", ")}`
     results.push(`
 \u26A0\uFE0F Errors:`);
     for (const err of resizeResult.errors.slice(0, 5)) {
-      results.push(`   - ${path12.basename(err.path)}: ${err.error}`);
+      results.push(`   - ${path13.basename(err.path)}: ${err.error}`);
     }
     if (resizeResult.errors.length > 5) {
       results.push(`   ... and ${resizeResult.errors.length - 5} more errors`);
@@ -4674,10 +4791,9 @@ Available locales with raw/: ${allRawLocales.join(", ")}`
 // src/tools/screenshots/phone-to-tablet.ts
 import { z as z9 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema9 } from "zod-to-json-schema";
-import fs14 from "fs";
-import path13 from "path";
+import fs15 from "fs";
+import path14 from "path";
 import sharp3 from "sharp";
-import { GoogleGenAI as GoogleGenAI2 } from "@google/genai";
 var TOOL_NAME5 = "phone-to-tablet";
 var TABLET_ASPECT_RATIO = "3:4";
 var phoneToTabletInputSchema = z9.object({
@@ -4698,6 +4814,9 @@ var phoneToTabletInputSchema = z9.object({
   ),
   preserveWords: z9.array(z9.string()).optional().describe(
     'Words to keep exactly as-is in the generated image (e.g., brand names). Example: ["Pabal", "Pro", "AI"]'
+  ),
+  imageModel: z9.enum(GEMINI_IMAGE_MODEL_VALUES).optional().default("flash").describe(
+    "Gemini image model preference. 'flash' (default) is faster/cheaper, 'pro' prioritizes quality."
   )
 });
 var jsonSchema9 = zodToJsonSchema9(phoneToTabletInputSchema, {
@@ -4711,8 +4830,8 @@ var phoneToTabletTool = {
 
 **PURPOSE:** Generate tablet-sized screenshots from existing phone screenshots by:
 1. Reading phone screenshots from the source locale
-2. Using Gemini to regenerate the UI with a tablet-friendly wider layout
-3. Adjusting internal device frame and UI components for larger screen
+2. Using Gemini to keep the same UI while adapting to a tablet canvas
+3. Preserving original content/layout without creating new UI
 
 **OUTPUT:** Saves generated tablet images to raw/ folder: \`{locale}/tablet/raw/{filename}\`
 
@@ -4728,6 +4847,10 @@ Run \`resize-screenshots --deviceTypes tablet\` after this tool to resize images
 - Phone screenshots must exist in: public/products/{slug}/screenshots/{locale}/phone/
 - Locale files must exist in: public/products/{slug}/locales/
 
+**Model Selection:**
+- \`imageModel: "flash"\` (default) for speed/cost
+- \`imageModel: "pro"\` for higher instruction fidelity
+
 **Example output structure:**
 \`\`\`
 public/products/my-app/screenshots/
@@ -4779,14 +4902,14 @@ function buildConversionTasks(slug, phoneScreenshots, locale, screenshotNumbers,
     });
   }
   for (const screenshot of filteredScreenshots) {
-    const tabletRawPath = path13.join(
+    const tabletRawPath = path14.join(
       screenshotsDir,
       locale,
       "tablet",
       "raw",
       screenshot.filename
     );
-    if (skipExisting && fs14.existsSync(tabletRawPath)) {
+    if (skipExisting && fs15.existsSync(tabletRawPath)) {
       continue;
     }
     tasks.push({
@@ -4798,103 +4921,51 @@ function buildConversionTasks(slug, phoneScreenshots, locale, screenshotNumbers,
   }
   return tasks;
 }
-function getGeminiClient2() {
-  const apiKey = getGeminiApiKey();
-  return new GoogleGenAI2({ apiKey });
-}
-function readImageAsBase642(imagePath) {
-  const buffer = fs14.readFileSync(imagePath);
-  const base64 = buffer.toString("base64");
-  const ext = path13.extname(imagePath).toLowerCase();
-  let mimeType = "image/png";
-  if (ext === ".jpg" || ext === ".jpeg") {
-    mimeType = "image/jpeg";
-  } else if (ext === ".webp") {
-    mimeType = "image/webp";
-  }
-  return { data: base64, mimeType };
-}
-async function convertPhoneToTablet(phonePath, tabletRawPath, preserveWords) {
-  try {
-    const client = getGeminiClient2();
-    const { data: imageData, mimeType } = readImageAsBase642(phonePath);
-    const preserveInstruction = preserveWords && preserveWords.length > 0 ? `
+async function convertPhoneToTablet(phonePath, tabletRawPath, preserveWords, imageModel = "flash") {
+  const client = createGeminiClient();
+  const { data: imageData, mimeType } = readImageAsBase64(phonePath);
+  const preserveInstruction = preserveWords && preserveWords.length > 0 ? `
 - Do NOT change these words, keep them exactly as-is: ${preserveWords.join(", ")}` : "";
-    const prompt = `This is a phone app screenshot. Please recreate this screenshot as a TABLET version.
+  const prompt = `Convert this PHONE app screenshot into a TABLET screenshot.
 
 IMPORTANT INSTRUCTIONS:
-- Convert this phone UI layout to a tablet-friendly WIDER layout
-- The tablet screen has a 3:4 aspect ratio (wider than phone's 9:16)
-- Expand the UI horizontally to take advantage of the wider screen
-- If there's a device frame mockup, change it to a tablet device frame
-- Maintain the same visual style, colors, and design language
-- Keep all the same content and text, just adjust the layout
-- Use tablet-appropriate spacing and element sizes
-- If the phone shows a single column, consider using wider cards or side-by-side layouts
-- Keep the same app functionality visible, just optimized for tablet${preserveInstruction}
-
-Generate a new tablet screenshot that represents the same app screen but optimized for tablet display.`;
-    const chat = client.chats.create({
-      model: "gemini-3-pro-image-preview",
-      config: {
-        responseModalities: ["TEXT", "IMAGE"]
-      }
-    });
-    const response = await chat.sendMessage({
-      message: [
-        { text: prompt },
-        {
-          inlineData: {
-            mimeType,
-            data: imageData
-          }
-        }
-      ],
-      config: {
-        responseModalities: ["TEXT", "IMAGE"],
-        imageConfig: {
-          aspectRatio: TABLET_ASPECT_RATIO
-        }
-      }
+- Preserve the original UI exactly: same components, text, icons, colors, and visual hierarchy
+- Do NOT redesign, recompose, or invent any new UI
+- Do NOT add/remove/reorder elements
+- Do NOT create side-by-side layouts, new panels, or alternative arrangements
+- Keep the same screen content and structure from the phone screenshot
+- Only adapt to tablet aspect ratio (3:4) by extending canvas width as needed
+- Keep the original content centered and unchanged as much as possible
+- Use matching background fill/empty space for extra horizontal area
+- If a device frame exists, keep the same frame style and avoid changing its design${preserveInstruction}
+
+Output one tablet screenshot that looks like the original phone screenshot placed on a wider tablet canvas.`;
+  try {
+    const generated = await generateImageWithFallback({
+      client,
+      prompt,
+      image: {
+        mimeType,
+        data: imageData
+      },
+      aspectRatio: TABLET_ASPECT_RATIO,
+      imageModel
     });
-    const candidates = response.candidates;
-    if (!candidates || candidates.length === 0) {
-      return {
-        success: false,
-        error: "No response from Gemini API"
-      };
-    }
-    const parts = candidates[0].content?.parts;
-    if (!parts) {
-      return {
-        success: false,
-        error: "No content parts in response"
-      };
+    const imageBuffer = Buffer.from(generated.imageBase64, "base64");
+    const outputDir = path14.dirname(tabletRawPath);
+    if (!fs15.existsSync(outputDir)) {
+      fs15.mkdirSync(outputDir, { recursive: true });
     }
-    for (const part of parts) {
-      if (part.inlineData?.data) {
-        const imageBuffer = Buffer.from(part.inlineData.data, "base64");
-        const outputDir = path13.dirname(tabletRawPath);
-        if (!fs14.existsSync(outputDir)) {
-          fs14.mkdirSync(outputDir, { recursive: true });
-        }
-        await sharp3(imageBuffer).png().toFile(tabletRawPath);
-        return { success: true };
-      }
-    }
-    return {
-      success: false,
-      error: "No image data in Gemini response"
-    };
+    await sharp3(imageBuffer).png().toFile(tabletRawPath);
+    return { success: true };
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
     return {
       success: false,
-      error: message
+      error: error instanceof Error ? error.message : String(error)
     };
   }
 }
-async function convertWithProgress(tasks, onProgress, preserveWords) {
+async function convertWithProgress(tasks, onProgress, preserveWords, imageModel = "flash") {
   let successful = 0;
   let failed = 0;
   const errors = [];
@@ -4913,7 +4984,8 @@ async function convertWithProgress(tasks, onProgress, preserveWords) {
     const result = await convertPhoneToTablet(
       task.phonePath,
       task.tabletRawPath,
-      preserveWords
+      preserveWords,
+      imageModel
     );
     if (result.success) {
       successful++;
@@ -4939,7 +5011,8 @@ async function handlePhoneToTablet(input) {
     screenshotNumbers,
     dryRun = false,
     skipExisting = true,
-    preserveWords
+    preserveWords,
+    imageModel = "flash"
   } = input;
   const results = [];
   let appInfo;
@@ -4989,6 +5062,9 @@ async function handlePhoneToTablet(input) {
     }
   }
   results.push(`\u{1F3AF} Locales to process: ${localesToProcess.join(", ")}`);
+  results.push(
+    `\u{1F9E0} Image model: ${imageModel} (${GEMINI_IMAGE_MODEL_PRESETS[imageModel]})`
+  );
   const allTasks = [];
   for (const locale of localesToProcess) {
     const phoneScreenshots = scanLocaleScreenshots(appInfo.slug, locale).filter(
@@ -5086,7 +5162,8 @@ Expected phone screenshots in: ${screenshotsDir2}/{locale}/phone/`
         );
       }
     },
-    preserveWords
+    preserveWords,
+    imageModel
   );
   results.push(`
 \u{1F4CA} Conversion Results:`);
@@ -5096,7 +5173,7 @@ Expected phone screenshots in: ${screenshotsDir2}/{locale}/phone/`
     results.push(`
 \u26A0\uFE0F Errors:`);
     for (const err of conversionResult.errors.slice(0, 5)) {
-      results.push(`   - ${path13.basename(err.path)}: ${err.error}`);
+      results.push(`   - ${path14.basename(err.path)}: ${err.error}`);
     }
     if (conversionResult.errors.length > 5) {
       results.push(
@@ -5126,12 +5203,12 @@ Expected phone screenshots in: ${screenshotsDir2}/{locale}/phone/`
 // src/tools/app-icon/generate-app-icons.ts
 import { z as z10 } from "zod";
 import { zodToJsonSchema as zodToJsonSchema10 } from "zod-to-json-schema";
-import fs15 from "fs";
-import path15 from "path";
+import fs16 from "fs";
+import path16 from "path";
 import sharp5 from "sharp";
 
 // src/tools/app-icon/utils/icon-specs.util.ts
-import path14 from "path";
+import path15 from "path";
 var ICON_FILENAMES = {
   BASE: "icon.png",
   IOS_LIGHT: "ios-light.png",
@@ -5172,14 +5249,14 @@ var ALL_ICON_TYPES = Object.keys(
 );
 function getIconsDir(slug, styleFolder) {
   const productsDir = getProductsDir();
-  const baseDir = path14.join(productsDir, slug, "icons");
-  return styleFolder ? path14.join(baseDir, styleFolder) : baseDir;
+  const baseDir = path15.join(productsDir, slug, "icons");
+  return styleFolder ? path15.join(baseDir, styleFolder) : baseDir;
 }
 function getBaseIconPath(slug, styleFolder) {
-  return path14.join(getIconsDir(slug, styleFolder), ICON_FILENAMES.BASE);
+  return path15.join(getIconsDir(slug, styleFolder), ICON_FILENAMES.BASE);
 }
 function getIconOutputPath(slug, iconType, styleFolder) {
-  return path14.join(getIconsDir(slug, styleFolder), ICON_SPECS[iconType].filename);
+  return path15.join(getIconsDir(slug, styleFolder), ICON_SPECS[iconType].filename);
 }
 
 // src/tools/app-icon/utils/icon-resizer.util.ts
@@ -5489,11 +5566,11 @@ function validateApp4(appName) {
     );
   }
   const productsDir = getProductsDir();
-  const configPath = path15.join(productsDir, app.slug, "config.json");
+  const configPath = path16.join(productsDir, app.slug, "config.json");
   let config;
-  if (fs15.existsSync(configPath)) {
+  if (fs16.existsSync(configPath)) {
     try {
-      const configData = fs15.readFileSync(configPath, "utf-8");
+      const configData = fs16.readFileSync(configPath, "utf-8");
       config = JSON.parse(configData);
     } catch (error) {
       console.warn(
@@ -5512,7 +5589,7 @@ function buildGenerationTasks(slug, iconTypes, skipExisting, styleFolder) {
   const tasks = [];
   const baseIconPath = getBaseIconPath(slug, styleFolder);
   const iconsDir = getIconsDir(slug, styleFolder);
-  if (!fs15.existsSync(baseIconPath)) {
+  if (!fs16.existsSync(baseIconPath)) {
     throw new Error(
       `Base icon not found: ${baseIconPath}
 
@@ -5521,7 +5598,7 @@ Please place your base icon at this location first.`
   }
   for (const iconType of iconTypes) {
     const outputPath = getIconOutputPath(slug, iconType, styleFolder);
-    if (skipExisting && fs15.existsSync(outputPath)) {
+    if (skipExisting && fs16.existsSync(outputPath)) {
       continue;
     }
     tasks.push({
@@ -5547,9 +5624,9 @@ async function generateIcons(tasks, backgroundColor, logoAlignment, onProgress)
     };
     onProgress?.(progress);
     try {
-      const outputDir = path15.dirname(task.outputPath);
-      if (!fs15.existsSync(outputDir)) {
-        fs15.mkdirSync(outputDir, { recursive: true });
+      const outputDir = path16.dirname(task.outputPath);
+      if (!fs16.existsSync(outputDir)) {
+        fs16.mkdirSync(outputDir, { recursive: true });
       }
       if (task.iconType === "android-notification-icon") {
         const whiteMask = await convertToWhiteMask(task.inputPath);
@@ -5753,24 +5830,8 @@ import path17 from "path";
 import sharp6 from "sharp";
 
 // src/tools/app-icon/utils/gemini.util.ts
-import fs16 from "fs";
-import path16 from "path";
-import { GoogleGenAI as GoogleGenAI3 } from "@google/genai";
-function getGeminiClient3() {
-  const apiKey = getGeminiApiKey();
-  return new GoogleGenAI3({ apiKey });
-}
-function readImageAsBase643(imagePath) {
-  const buffer = fs16.readFileSync(imagePath);
-  const base64 = buffer.toString("base64");
-  const ext = path16.extname(imagePath).toLowerCase();
-  let mimeType = "image/png";
-  if (ext === ".jpg" || ext === ".jpeg") {
-    mimeType = "image/jpeg";
-  } else if (ext === ".webp") {
-    mimeType = "image/webp";
-  }
-  return { data: base64, mimeType };
+function getGeminiClient() {
+  return createGeminiClient();
 }
 
 // src/tools/app-icon/stylize-app-icon.ts
@@ -5788,6 +5849,9 @@ var stylizeAppIconInputSchema = z11.object({
   preserveShape: z11.boolean().optional().default(true).describe(
     "Preserve the original icon shape and structure (default: true). When true, only applies style elements without changing the core design."
   ),
+  imageModel: z11.enum(GEMINI_IMAGE_MODEL_VALUES).optional().default("flash").describe(
+    "Gemini image model preference. 'flash' (default) is faster/cheaper, 'pro' prioritizes quality."
+  ),
   dryRun: z11.boolean().optional().default(false).describe(
     "Preview mode - shows what would be generated without actually calling API or saving files"
   )
@@ -5816,6 +5880,10 @@ var stylizeAppIconTool = {
 - GEMINI_API_KEY or GOOGLE_API_KEY environment variable
 - Base icon exists at {slug}/icons/icon.png
 
+**Model Selection:**
+- \`imageModel: "flash"\` (default) for speed/cost
+- \`imageModel: "pro"\` for higher instruction fidelity
+
 **Example Flow:**
 \`\`\`
 Step 1: Stylize icon
@@ -5850,10 +5918,10 @@ function validateApp5(appName) {
     name: app.name || app.slug
   };
 }
-async function stylizeIconWithAI(inputPath, outputPath, stylePrompt, preserveShape) {
+async function stylizeIconWithAI(inputPath, outputPath, stylePrompt, preserveShape, imageModel = "flash") {
   try {
-    const client = getGeminiClient3();
-    const { data: imageData, mimeType } = readImageAsBase643(inputPath);
+    const client = getGeminiClient();
+    const { data: imageData, mimeType } = readImageAsBase64(inputPath);
     const shapeInstruction = preserveShape ? "IMPORTANT: Preserve the original icon's shape, structure, and core design elements. Only add style-specific decorations and color adjustments." : "You can modify the icon structure as needed to achieve the style.";
     const fullPrompt = `You are an expert app icon designer. Transform this app icon with the following style:
 
@@ -5870,56 +5938,23 @@ Requirements:
 6. Ensure the result is visually appealing and brand-appropriate
 
 Generate the stylized icon with transparent background now.`;
-    const chat = client.chats.create({
-      model: "gemini-3-pro-image-preview",
-      config: {
-        responseModalities: ["TEXT", "IMAGE"]
-      }
-    });
-    const response = await chat.sendMessage({
-      message: [
-        { text: fullPrompt },
-        {
-          inlineData: {
-            mimeType,
-            data: imageData
-          }
-        }
-      ],
-      config: {
-        responseModalities: ["TEXT", "IMAGE"]
-      }
+    const generated = await generateImageWithFallback({
+      client,
+      prompt: fullPrompt,
+      image: {
+        mimeType,
+        data: imageData
+      },
+      imageModel
     });
-    const candidates = response.candidates;
-    if (!candidates || candidates.length === 0) {
-      return {
-        success: false,
-        error: "No response from Gemini API"
-      };
-    }
-    const parts = candidates[0].content?.parts;
-    if (!parts) {
-      return {
-        success: false,
-        error: "No content parts in response"
-      };
-    }
-    for (const part of parts) {
-      if (part.inlineData?.data) {
-        const imageBuffer = Buffer.from(part.inlineData.data, "base64");
-        const outputDir = path17.dirname(outputPath);
-        if (!fs17.existsSync(outputDir)) {
-          fs17.mkdirSync(outputDir, { recursive: true });
-        }
-        const processedImage = await sharp6(imageBuffer).ensureAlpha().png().toBuffer();
-        await sharp6(processedImage).toFile(outputPath);
-        return { success: true };
-      }
-    }
-    return {
-      success: false,
-      error: "No image data in Gemini response"
-    };
+    const imageBuffer = Buffer.from(generated.imageBase64, "base64");
+    const outputDir = path17.dirname(outputPath);
+    if (!fs17.existsSync(outputDir)) {
+      fs17.mkdirSync(outputDir, { recursive: true });
+    }
+    const processedImage = await sharp6(imageBuffer).ensureAlpha().png().toBuffer();
+    await sharp6(processedImage).toFile(outputPath);
+    return { success: true };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     return {
@@ -5934,6 +5969,7 @@ async function handleStylizeAppIcon(input) {
     styleFolder,
     stylePrompt,
     preserveShape = true,
+    imageModel = "flash",
     dryRun = false
   } = input;
   const results = [];
@@ -5975,6 +6011,9 @@ Please place your base icon at this location first.`
   results.push(
     `\u{1F527} Shape preservation: ${preserveShape ? "enabled" : "disabled"}`
   );
+  results.push(
+    `\u{1F9E0} Image model: ${imageModel} (${GEMINI_IMAGE_MODEL_PRESETS[imageModel]})`
+  );
   if (dryRun) {
     results.push(`
 \u{1F50D} DRY RUN - No actual generation will be performed`);
@@ -5997,7 +6036,7 @@ Next step: Run generate-app-icons with styleFolder='${styleFolder}' to create pl
     };
   }
   try {
-    getGeminiClient3();
+    getGeminiClient();
   } catch (error) {
     return {
       content: [
@@ -6014,7 +6053,8 @@ Next step: Run generate-app-icons with styleFolder='${styleFolder}' to create pl
     baseIconPath,
     outputPath,
     stylePrompt,
-    preserveShape
+    preserveShape,
+    imageModel
   );
   if (!stylizeResult.success) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-resource-mcp",
-  "version": "1.8.12",
+  "version": "1.9.1",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",