@goodandready/dsh-image-gen 0.10.7 → 0.10.8

package/README.md

@@ -1,3 +1,9 @@
+
+## 🚀 Updates v0.10.8: Lossless JSON Unification, Dual-Output & Strict Validation (#199)
+- **Lossless JSON & Dual-Output Unification**: `upscale_image`, `remove_background`, `blend_images`, and `vectorize_image` now consistently return `toLosslessJson` and formatted markdown `summary` for text-only LLMs.
+- **Strict Input Image Validation**: `extract_design_tokens`, `image_to_css_gradient`, and `check_image_contrast` explicitly validate source image readability instead of silent fallback.
+- **Unit Testing Suite**: Added `test/tool-consistency.test.mjs` covering tokenization, gradient generator, and PWA suite.
+
 # 📦 @goodandready/dsh-image-gen
 
 <div align="center">

package/README.ru.md

@@ -116,6 +116,12 @@ graph LR
 ---
 
 
+
+## 🚀 Обновления v0.10.8: унификация Lossless JSON, Dual-Output и строгая валидация (#199)
+- **Унификация Lossless JSON и Dual-Output**: Инструменты `upscale_image`, `remove_background`, `blend_images`, `vectorize_image` теперь гарантированно возвращают валидный `toLosslessJson` и генерируют структурированный `summary` с превью для текстовых LLM.
+- **Строгая валидация входных изображений**: В инструментах `extract_design_tokens`, `image_to_css_gradient` и `check_image_contrast` добавлена явная проверка существования файла с информативной ошибкой (`Image not found or unreadable: <path>`).
+- **Сквозное модульное тестирование**: Добавлен тест-сьют `test/tool-consistency.test.mjs` для проверки отказоустойчивости дизайн- и PWA-инструментов.
+
 ## 🚀 Обновления v0.10.4: жизненный цикл Cordis, полнота настроек и интернационализация
 - **Жизненный цикл Cordis (#136)**: регистрация всех 7 инструментов обёрнута в `ctx.effect` для штатной отписки при перезагрузке плагина.
 - **Полнота настроек в GUI (#137)**: в карточку настроек добавлены поля для Replicate, SeaDream, Gemini, Local ComfyUI/A1111, пресетов стилей и LLM-улучшителя.

package/lib/index.js

@@ -1070,14 +1070,25 @@ export function apply(ctx, config) {
         const filePath = path.join(outDir, name)
         await writeFile(filePath, res.bytes)
         const localUrl = '/dsh-image-gen/image?id=' + encodeURIComponent(attachment.attachmentId)
-        return {
+        const summary = buildDualOutputMarkdown({
+          action: 'background removed',
+          filePath,
+          width: res.width || attachment.width,
+          height: res.height || attachment.height,
+          mediaType: 'image/png',
+          provider: 'fal',
+          model: args.model || 'fal-ai/birefnet',
+          attachmentId: attachment.attachmentId,
+        })
+        return toLosslessJson({
+          summary,
           path: filePath,
           url: localUrl,
           width: res.width || attachment.width,
           height: res.height || attachment.height,
           format: 'png',
           attachment,
-        }
+        })
       },
     }),
   )
@@ -1128,14 +1139,25 @@ export function apply(ctx, config) {
         const filePath = path.join(outDir, name)
         await writeFile(filePath, res.bytes)
         const localUrl = '/dsh-image-gen/image?id=' + encodeURIComponent(attachment.attachmentId)
-        return {
+        const summary = buildDualOutputMarkdown({
+          action: `upscaled (${args.scale || 2}x)`,
+          filePath,
+          width: res.width || attachment.width,
+          height: res.height || attachment.height,
+          mediaType: 'image/png',
+          provider: 'fal',
+          model: 'fal-ai/clarity-upscaler',
+          attachmentId: attachment.attachmentId,
+        })
+        return toLosslessJson({
+          summary,
           path: filePath,
           url: localUrl,
           scale: args.scale || 2,
           width: res.width || attachment.width,
           height: res.height || attachment.height,
           attachment,
-        }
+        })
       },
     }),
   )
@@ -1173,11 +1195,13 @@ export function apply(ctx, config) {
         await mkdir(outDir, { recursive: true })
         const filePath = path.join(outDir, name)
         await writeFile(filePath, res.bytes)
-        return {
+        const summary = `### Vectorized SVG Export\n- **File**: ${filePath}\n- **Format**: SVG (XML vector)\n- **Color mode**: ${args.color_mode || 'color'}\n- **Palette size**: ${res.palette ? res.palette.length : 16} colors\n`
+        return toLosslessJson({
+          summary,
           path: filePath,
           svg: res.svg,
           format: 'svg',
-        }
+        })
       },
     }),
   )
@@ -1232,13 +1256,24 @@ export function apply(ctx, config) {
         const filePath = path.join(outDir, name)
         await writeFile(filePath, res.bytes)
         const localUrl = '/dsh-image-gen/image?id=' + encodeURIComponent(attachment.attachmentId)
-        return {
+        const summary = buildDualOutputMarkdown({
+          action: 'blended composition',
+          filePath,
+          width: res.width || attachment.width,
+          height: res.height || attachment.height,
+          mediaType: 'image/png',
+          provider: 'fal',
+          model: 'fal-ai/image-blend',
+          attachmentId: attachment.attachmentId,
+        })
+        return toLosslessJson({
+          summary,
           path: filePath,
           url: localUrl,
           width: res.width || attachment.width,
           height: res.height || attachment.height,
           attachment,
-        }
+        })
       },
     }),
   )
@@ -1610,12 +1645,13 @@ export function apply(ctx, config) {
         if (!colors || colors.length === 0) {
           if (args.image) {
             const source = await resolveSource(ctx, exec, args.image)
-            if (source && source.bytes) {
-              colors = extractSampleColorsFromBuffer(source.bytes)
+            if (!source || !source.bytes) {
+              throw new Error('Image not found or unreadable: ' + args.image)
             }
+            colors = extractSampleColorsFromBuffer(source.bytes)
           }
         }
-        return extractDesignTokens(colors, { prefix: args.prefix })
+        return toLosslessJson(extractDesignTokens(colors, { prefix: args.prefix }))
       },
     }),
   )
@@ -1648,12 +1684,13 @@ export function apply(ctx, config) {
         if (!colors || colors.length === 0) {
           if (args.image) {
             const source = await resolveSource(ctx, exec, args.image)
-            if (source && source.bytes) {
-              colors = extractSampleColorsFromBuffer(source.bytes)
+            if (!source || !source.bytes) {
+              throw new Error('Image not found or unreadable: ' + args.image)
             }
+            colors = extractSampleColorsFromBuffer(source.bytes)
           }
         }
-        return generateCssGradient(colors, args.type || 'mesh')
+        return toLosslessJson(generateCssGradient(colors, args.type || 'mesh'))
       },
     }),
   )
@@ -1689,12 +1726,13 @@ export function apply(ctx, config) {
         if (!colors || colors.length === 0) {
           if (args.image) {
             const source = await resolveSource(ctx, exec, args.image)
-            if (source && source.bytes) {
-              colors = extractSampleColorsFromBuffer(source.bytes)
+            if (!source || !source.bytes) {
+              throw new Error('Image not found or unreadable: ' + args.image)
             }
+            colors = extractSampleColorsFromBuffer(source.bytes)
           }
         }
-        return checkWcagContrast(colors, args.text_color || '#ffffff')
+        return toLosslessJson(checkWcagContrast(colors, args.text_color || '#ffffff'))
       },
     }),
   )
@@ -1769,7 +1807,7 @@ export function apply(ctx, config) {
         },
       },
       async execute(args, exec) {
-        return generatePwaIconSuite({
+        const res = await generatePwaIconSuite({
           name: args.name || 'App',
           shortName: args.short_name || args.name || 'App',
           themeColor: args.theme_color || '#0f172a',
@@ -1777,6 +1815,7 @@ export function apply(ctx, config) {
           iconsDir: args.icons_dir || 'icons',
           sourcePath: args.image || null,
         })
+        return toLosslessJson(res)
       },
     }),
   )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-image-gen",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "Image generation for DeepSeek Harness: a generate_image tool with pluggable providers — the FAL queue, any OpenAI-compatible images API, or a ChatGPT/Grok subscription with no API key at all. The picture is shown inline in the conversation; the model receives either a link (works with any chat model) or the image itself (needs dsh-vision-bridge or a vision-capable model).",
   "keywords": [
     "deepseek-harness",