@goodandready/dsh-image-gen 0.10.7 → 0.10.10

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">
@@ -77,6 +83,13 @@
 * **FAL Credential Aliasing**: seamless fallback between `FAL_API_KEY` and `FAL_KEY` in credentials and environment.
 * **Subscription Aspect Ratio Mapping**: maps aspect ratios (`16:9`, `3:2`, `9:16`, `2:3`) to appropriate subscription dimensions (`1536x1024` / `1024x1536`) instead of falling back to default square `1024x1024`.
 
+
+### 🚀 What's New in v0.10.10 (#201, #203)
+* **Settings GUI Stabilization (#201)**: Fixed `booleanField` spec in client runtime that prevented the settings configuration pane from rendering in DSH Web UI. All configuration fields (providers, model identifiers, API credentials, style presets, LLM enhancer, timeouts, cache retention) render cleanly.
+* **Streamlined Settings UI (#203)**: Removed the bulky in-settings history gallery to keep the configuration panel focused, fast, and organized.
+* **Comprehensive Localization (#201)**: Added 100% dictionary coverage for all provider credentials, endpoints, and field hints in English and Russian.
+* **Robust Slot Mounting**: Implemented `registerFirst` helper with graceful fallback between `settings.plugin.item` and `settings.section`.
+
 ## 🎨 Supported Generation Backends
 
 * **`fal`** (Default): FAL.ai queue for FLUX.1, SDXL, Clarity Upscaler, and BiRefNet.

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-улучшителя.
@@ -123,6 +129,13 @@ graph LR
 - **Оптимизация компонентов (#139)**: из `FalImageCard` удалён неиспользуемый мёртвый стейт.
 - **100% интернационализация (#140)**: устранены захардкоженные русские строки, добавлены переводы на русский, английский и китайский языки.
 
+
+### 🚀 Что нового в v0.10.10 (#201, #203)
+* **Стабилизация окна настроек GUI (#201)**: Исправлена спецификация `booleanField` в клиентском коде, вызывавшая падение рендера карточки настроек плагина в DSH Web UI. Форма настроек теперь открывается штатно со всеми полями, селекторами провайдеров, моделями, ссылками на ключи и пресетами.
+* **Очистка интерфейса настроек (#203)**: Из окна настроек убрана встроенная галерея истории генераций, загромождавшая карточку настроек.
+* **Полная локализация (#201)**: Добавлены все недостающие строки переводов и подсказок на русском и английском языках для всех поддерживаемых провайдеров.
+* **Надёжная регистрация слотов**: Реализован `registerFirst` с плавным откатом между `settings.plugin.item` и `settings.section`.
+
 ## 🎨 Поддерживаемые провайдеры генерации
 
 * **`fal`** *(дефолт)*: Сверхбыстрая очередь FAL.ai (`FLUX.1-schnell`, `FLUX-dev`, `SDXL`, BiRefNet, Clarity Upscaler).

package/lib/client.js

@@ -82,12 +82,7 @@ window.__ModuleLoader__.load({
       '.fal_input:disabled,.fal_select:disabled{opacity:.6}' +
       '.fal_hint{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px}' +
       '.fal_invalid{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px}' +
-      '.fal_sep{height:1px;background:var(--dsw-alias-border-l2);margin:2px 0 0}' +
-      '.fal_gallery{display:grid;grid-template-columns:repeat(auto-fill,minmax(120px,1fr));gap:10px;margin-top:12px}' +
-      '.fal_galleryItem{display:flex;flex-direction:column;gap:4px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;overflow:hidden}' +
-      '.fal_galleryImg{width:100%;height:90px;object-fit:cover;display:block}' +
-      '.fal_galleryMeta{font-size:11px;color:var(--dsw-alias-label-secondary);padding:4px 6px}' +
-      '.fal_galleryEmpty{color:var(--dsw-alias-label-secondary);font-size:12px;margin-top:12px}'
+      '.fal_sep{height:1px;background:var(--dsw-alias-border-l2);margin:2px 0 0}'
     const tagId = 'dsh-image-gen/settings-card.module.css'
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=' + JSON.stringify(tagId) + ']') === null) {
       const tag = document.createElement('style')
@@ -124,11 +119,6 @@ window.__ModuleLoader__.load({
       save: 'fal_save',
       select: 'fal_select',
       sep: 'fal_sep',
-      gallery: 'fal_gallery',
-      galleryItem: 'fal_galleryItem',
-      galleryImg: 'fal_galleryImg',
-      galleryMeta: 'fal_galleryMeta',
-      galleryEmpty: 'fal_galleryEmpty',
     }
 
     // -------------------------------------------------------------- chrome
@@ -136,7 +126,7 @@ window.__ModuleLoader__.load({
     function PluginSettingsCard(props) {
       // Карточка живёт в собственном разделе настроек и на странице одна, так
       // что открыта сразу: свёрнутая выглядела бы как пустая страница.
-      const [open, setOpen] = react.useState(false)
+      const [open, setOpen] = react.useState(props.defaultOpen ?? true)
       const { state } = props
       // Раньше здесь было `return null`, и раздел оказывался пустым, если хост
       // ещё не объявил настройки. Пустая страница ничего не объясняет — лучше
@@ -464,7 +454,17 @@ window.__ModuleLoader__.load({
     const PROVIDERS = ['fal', 'custom', 'codex', 'grok', 'local', 'seedream', 'gemini', 'replicate']
 
     /** Field specs in display order. */
-    const booleanField = (name) => ({ name, type: 'boolean', parse: (v) => v === 'true' || v === true, format: (v) => String(!!v) })
+    const booleanField = (field) => ({
+      field,
+      type: 'boolean',
+      format: (value) => (typeof value === 'boolean' ? String(value) : (value === 'true' || value === 'false' ? value : '')),
+      parse: (text) => {
+        if (text === '') return { kind: 'clear' }
+        if (text === 'true') return { kind: 'set', value: true }
+        if (text === 'false') return { kind: 'set', value: false }
+        return void 0
+      },
+    })
     const STYLE_PRESET_OPTIONS = ['', 'cinematic', 'anime', 'digital_art', 'photographic', 'fantasy', 'isometric', 'cyberpunk', 'watercolor', 'origami', 'oil_painting', 'pixel_art', 'logo']
 
     const FIELDS = [
@@ -511,7 +511,6 @@ window.__ModuleLoader__.load({
       { field: 'deliverAs', spec: selectField('deliverAs', DELIVERY_MODES), kind: 'select', options: DELIVERY_MODES, labelKey: 'f.deliverAs', hintKey: 'f.deliverAsHint' },
       { field: 'outputDir', spec: textField('outputDir'), kind: 'text', labelKey: 'f.outputDir', hintKey: 'f.outputDirHint', placeholderKey: 'p.outputDir' },
       { field: 'cacheTtlDays', spec: numberField('cacheTtlDays'), kind: 'number', labelKey: 'f.cacheTtlDays', hintKey: 'f.cacheTtlDaysHint', placeholderKey: 'p.cacheTtlDays' },
-      { field: 'maxHistoryEntries', spec: numberField('maxHistoryEntries'), kind: 'number', labelKey: 'f.maxHistoryEntries', hintKey: 'f.maxHistoryEntriesHint', placeholderKey: 'p.maxHistoryEntries' },
     ]
 
     function Field(props) {
@@ -539,66 +538,11 @@ window.__ModuleLoader__.load({
       return react_jsx_runtime.jsx(ValueField, { ...base, numeric: entry.kind === 'number', placeholder: entry.placeholderKey ? t(entry.placeholderKey) : '' })
     }
 
-    /** Render the plugin settings card. */
-    /** Галерея истории генераций: тянет /history и рендерит миниатюры. */
-    function HistoryGallery(props) {
-      const [entries, setEntries] = react.useState([])
-      const [loading, setLoading] = react.useState(true)
-      const [filter, setFilter] = react.useState('')
-      react.useEffect(() => {
-        let cancelled = false
-        fetch('/dsh-image-gen/history')
-          .then((r) => r.json())
-          .then((data) => { if (!cancelled) { setEntries(Array.isArray(data) ? data : []); setLoading(false) } })
-          .catch(() => { if (!cancelled) setLoading(false) })
-        return () => { cancelled = true }
-      }, [])
-      const t = props.t
-      if (loading) return react_jsx_runtime.jsx('p', { className: cssDefault.galleryEmpty, children: t('history.loading') })
-      if (!entries.length) return react_jsx_runtime.jsx('p', { className: cssDefault.galleryEmpty, children: t('history.empty') })
-      const providers = [...new Set(entries.map((e) => e.provider).filter(Boolean))]
-      const filtered = filter ? entries.filter((e) => e.provider === filter) : entries
-      return react_jsx_runtime.jsxs('div', {
-        className: cssDefault.gallery,
-        children: [
-          react_jsx_runtime.jsx('select', {
-            className: cssDefault.select,
-            value: filter,
-            onChange: (e) => setFilter(e.target.value),
-            children: [
-              react_jsx_runtime.jsx('option', { value: '', children: t('history.all') }),
-              providers.map((p) => react_jsx_runtime.jsx('option', { value: p, children: p }, p)),
-            ],
-          }),
-          filtered.map((e) =>
-          react_jsx_runtime.jsxs('a', {
-            className: cssDefault.galleryItem,
-            key: e.path,
-            href: e.thumbnailUrl || '#',
-            target: '_blank',
-            rel: 'noreferrer',
-            children: [
-              e.thumbnailUrl ? react_jsx_runtime.jsx('img', { className: cssDefault.galleryImg, src: e.thumbnailUrl, alt: e.prompt || '', loading: 'lazy' }) : null,
-              react_jsx_runtime.jsx('div', { className: cssDefault.galleryMeta, children: `${e.provider || ''} · ${e.size || ''}` }),
-              e.seed !== undefined ? react_jsx_runtime.jsx('button', {
-                type: 'button',
-                className: 'fal-repeat',
-                onClick: (ev) => {
-                  ev.preventDefault()
-                  ev.stopPropagation()
-                  try { navigator.clipboard.writeText(String(e.seed)) } catch (err) { /* нет доступа к буферу */ }
-                },
-              }, `seed ${e.seed}`) : null,
-            ],
-          }),
-          ),
-        ],
-      })
-    }
-
     function FalSettingsCard(props) {
-      const { t } = props
-      const state = props.useFalSettingsCard((snapshot) => snapshot)
+      const t = props.t || ((k) => k)
+      const state = (typeof props.useFalSettingsCard === 'function'
+        ? props.useFalSettingsCard((snapshot) => snapshot)
+        : null) || props.state || { available: true, writable: true, provider: { text: 'fal' } }
       const disabled = !state.writable
       const currentProvider = (state.provider && state.provider.text) || 'fal'
       const visibleFields = FIELDS.filter((entry) => !entry.when || entry.when.includes(currentProvider))
@@ -616,7 +560,7 @@ window.__ModuleLoader__.load({
         onSave: props.save,
         onDiscard: props.discard,
         children: [
-          react_jsx_runtime.jsx('p', { className: cssDefault.hint, children: t('settings.credentialHint') }),
+          react_jsx_runtime.jsx('p', { className: cssDefault.hint, key: 'credHint', children: t('settings.credentialHint') }),
           visibleFields.map((entry) =>
             react_jsx_runtime.jsx(
               Field,
@@ -625,15 +569,12 @@ window.__ModuleLoader__.load({
                 state: state[entry.field] ?? { text: '', overridden: false, invalid: false },
                 fieldProps,
                 t,
-                onEdit: (text) => props.edit(entry.field, text),
-                onReset: () => props.resetField(entry.field),
+                onEdit: (text) => props.edit && props.edit(entry.field, text),
+                onReset: () => props.resetField && props.resetField(entry.field),
               },
               entry.field,
             ),
           ),
-          react_jsx_runtime.jsx('div', { className: cssDefault.sep, key: 'hsep' }),
-          react_jsx_runtime.jsx('p', { className: cssDefault.hint, key: 'hlabel', children: t('history.title') }),
-          react_jsx_runtime.jsx(HistoryGallery, { t, key: 'history' }),
         ],
       })
     }
@@ -680,6 +621,53 @@ window.__ModuleLoader__.load({
       'settings.saving': 'Saving…',
       'settings.saveFailed': 'Save failed',
       'f.inherit': 'Inherit (default)',
+      'f.enabled': 'Enabled',
+      'f.enabledHint': 'Master switch: enable or disable the generate_image tool.',
+      'f.needFal': 'requires FAL API key',
+      'f.needCustom': 'requires custom endpoint URL',
+      'f.needCodex': 'uses Codex subscription session',
+      'f.needGrok': 'uses Grok subscription session',
+      'f.needLocal': 'connects to local ComfyUI/A1111',
+      'f.needSeedream': 'requires SeaDream API key',
+      'f.needGemini': 'requires Gemini API key',
+      'f.needReplicate': 'requires Replicate API token',
+      'f.replicateModel': 'Model (Replicate)',
+      'f.replicateModelHint': 'Replicate model identifier, e.g. black-forest-labs/flux-schnell.',
+      'f.replicateKeyEnv': 'API key reference (Replicate)',
+      'f.replicateKeyEnvHint': 'Credential reference / env var holding the Replicate API token.',
+      'p.replicateModel': 'Example: black-forest-labs/flux-schnell',
+      'p.replicateKeyEnv': 'Example: REPLICATE_API_TOKEN',
+      'f.seedreamModel': 'Model (SeaDream)',
+      'f.seedreamModelHint': 'SeaDream model identifier.',
+      'f.seedreamKeyEnv': 'API key reference (SeaDream)',
+      'f.seedreamKeyEnvHint': 'Credential reference / env var holding the SeaDream API key.',
+      'f.seedreamBaseURL': 'Base URL (SeaDream)',
+      'f.seedreamBaseURLHint': 'SeaDream endpoint URL (Volcengine Ark API).',
+      'p.seedreamModel': 'Example: Doubao-SeaDream-3.0',
+      'p.seedreamKeyEnv': 'Example: SEADREAM_API_KEY',
+      'p.seedreamBaseURL': 'Example: https://ark.cn-beijing.volces.com/api/v3',
+      'f.geminiModel': 'Model (Gemini)',
+      'f.geminiModelHint': 'Gemini Imagen model identifier.',
+      'f.geminiKeyEnv': 'API key reference (Gemini)',
+      'f.geminiKeyEnvHint': 'Credential reference / env var holding the Gemini API key.',
+      'p.geminiModel': 'Example: imagen-3.0-generate-002',
+      'p.geminiKeyEnv': 'Example: GEMINI_API_KEY',
+      'f.localComfyUrl': 'ComfyUI URL',
+      'f.localComfyUrlHint': 'Base URL of local ComfyUI server.',
+      'p.localComfyUrl': 'Example: http://127.0.0.1:8188',
+      'f.localA1111Url': 'Automatic1111 URL',
+      'f.localA1111UrlHint': 'Base URL of local Automatic1111 / SD WebUI.',
+      'p.localA1111Url': 'Example: http://127.0.0.1:7860',
+      'f.stylePreset': 'Default style preset',
+      'f.stylePresetHint': 'Style preset automatically applied if the tool call does not specify one.',
+      'f.enableLlmEnhancer': 'LLM prompt enhancer',
+      'f.enableLlmEnhancerHint': 'Automatically refine and expand prompts before generation using session LLM.',
+      'f.cacheTtlDays': 'Cache retention (days)',
+      'f.cacheTtlDaysHint': 'How many days downloaded images are stored in cache before cleanup.',
+      'p.cacheTtlDays': 'Example: 7',
+      'f.maxHistoryEntries': 'Max history entries',
+      'f.maxHistoryEntriesHint': 'Maximum number of items shown in generation history gallery.',
+      'p.maxHistoryEntries': 'Example: 50',
       'f.provider': 'Provider',
       'f.providerHint': 'fal — the FAL queue configured below. custom — any OpenAI-compatible API, configured further down. '
         + 'codex and grok — through a subscription you are logged into, no key needed here.',
@@ -743,6 +731,53 @@ window.__ModuleLoader__.load({
       'settings.saving': 'Сохранение…',
       'settings.saveFailed': 'Не удалось сохранить',
       'f.inherit': 'Унаследовать (по умолчанию)',
+      'f.enabled': 'Включено',
+      'f.enabledHint': 'Главный переключатель: включить или отключить инструмент generate_image.',
+      'f.needFal': 'требуется ключ API FAL',
+      'f.needCustom': 'требуется базовый URL API',
+      'f.needCodex': 'использует сессию подписки Codex',
+      'f.needGrok': 'использует сессию подписки Grok',
+      'f.needLocal': 'подключается к локальному ComfyUI/A1111',
+      'f.needSeedream': 'требуется ключ API SeaDream',
+      'f.needGemini': 'требуется ключ API Gemini',
+      'f.needReplicate': 'требуется токен API Replicate',
+      'f.replicateModel': 'Модель (Replicate)',
+      'f.replicateModelHint': 'Идентификатор модели Replicate, например black-forest-labs/flux-schnell.',
+      'f.replicateKeyEnv': 'Ссылка на ключ (Replicate)',
+      'f.replicateKeyEnvHint': 'Имя credential-ссылки / переменной окружения с токеном Replicate.',
+      'p.replicateModel': 'Пример: black-forest-labs/flux-schnell',
+      'p.replicateKeyEnv': 'Пример: REPLICATE_API_TOKEN',
+      'f.seedreamModel': 'Модель (SeaDream)',
+      'f.seedreamModelHint': 'Идентификатор модели SeaDream.',
+      'f.seedreamKeyEnv': 'Ссылка на ключ (SeaDream)',
+      'f.seedreamKeyEnvHint': 'Имя credential-ссылки / переменной окружения с ключом SeaDream.',
+      'f.seedreamBaseURL': 'Базовый URL (SeaDream)',
+      'f.seedreamBaseURLHint': 'Базовый URL API SeaDream (Volcengine Ark).',
+      'p.seedreamModel': 'Пример: Doubao-SeaDream-3.0',
+      'p.seedreamKeyEnv': 'Пример: SEADREAM_API_KEY',
+      'p.seedreamBaseURL': 'Пример: https://ark.cn-beijing.volces.com/api/v3',
+      'f.geminiModel': 'Модель (Gemini)',
+      'f.geminiModelHint': 'Идентификатор модели Gemini Imagen.',
+      'f.geminiKeyEnv': 'Ссылка на ключ (Gemini)',
+      'f.geminiKeyEnvHint': 'Имя credential-ссылки / переменной окружения с ключом Gemini.',
+      'p.geminiModel': 'Пример: imagen-3.0-generate-002',
+      'p.geminiKeyEnv': 'Пример: GEMINI_API_KEY',
+      'f.localComfyUrl': 'URL ComfyUI',
+      'f.localComfyUrlHint': 'Базовый URL локального сервера ComfyUI.',
+      'p.localComfyUrl': 'Пример: http://127.0.0.1:8188',
+      'f.localA1111Url': 'URL Automatic1111',
+      'f.localA1111UrlHint': 'Базовый URL локального SD WebUI / Automatic1111.',
+      'p.localA1111Url': 'Пример: http://127.0.0.1:7860',
+      'f.stylePreset': 'Стилевой пресет по умолчанию',
+      'f.stylePresetHint': 'Пресет стилизации, применяемый если инструмент вызван без указания стиля.',
+      'f.enableLlmEnhancer': 'Улучшение промпта через LLM',
+      'f.enableLlmEnhancerHint': 'Автоматически детализировать и улучшать промпты через чат-модель перед генерацией.',
+      'f.cacheTtlDays': 'Срок хранения кэша (дней)',
+      'f.cacheTtlDaysHint': 'Сколько дней скачанные картинки хранятся в кэше до очистки.',
+      'p.cacheTtlDays': 'Пример: 7',
+      'f.maxHistoryEntries': 'Максимум записей в истории',
+      'f.maxHistoryEntriesHint': 'Максимальное количество картинок в галерее истории генераций.',
+      'p.maxHistoryEntries': 'Пример: 50',
       'f.provider': 'Провайдер',
       'f.providerHint': 'fal — очередь FAL, настроенная ниже. custom — любой OpenAI-совместимый API, настраивается дальше. '
         + 'codex и grok — через подписку, в которую вы вошли; ключ здесь не нужен.',
@@ -1226,36 +1261,40 @@ function FalImageCard(props) {
       // Запасной путь: слот объявлен пакетом настроек ядра. Если в сборке его
       // нет, регистрация бросает — тогда остаётся прежний раздел в боковом
       // списке, чтобы настройки не пропали.
-      let placedInPluginsTab = false
-      try {
-        ctx.slots.register(
-          {
-            name: 'settings.plugin.item',
-            key: SETTINGS_NS,
-            locale: NS,
-            inject: () => cardOnce().inject(),
-          },
-          FalSettingsCard,
-        )
-        placedInPluginsTab = true
-      } catch (noPluginItemSlot) {
-        placedInPluginsTab = false
-      }
-      if (!placedInPluginsTab) {
-        ctx.slots.inject('settings.section', () =>
-          ctx.slots.register(
-            {
-              name: 'settings.section',
-              id: '@goodandready/dsh-image-gen',
-              order: 34,
-              locale: NS,
-              label: () => t('settings.navLabel'),
-              inject: () => cardOnce().inject(),
-            },
-            FalSettingsCard,
-          ),
-        )
+    function registerFirst(ctx, candidates, component) {
+      if (!ctx || !ctx.slots) return undefined
+      for (const entry of candidates) {
+        try {
+          if (typeof ctx.slots?.has === 'function' && !ctx.slots.has(entry.name)) {
+            continue
+          }
+          let ok = false
+          ctx.slots.inject(entry.name, () => {
+            ctx.slots.register(entry, component)
+            ok = true
+          })
+          if (ok) return entry.name
+        } catch {}
       }
+      return undefined
+    }
+
+    registerFirst(ctx, [
+      {
+        name: 'settings.plugin.item',
+        key: SETTINGS_NS,
+        locale: NS,
+        inject: () => cardOnce().inject(),
+      },
+      {
+        name: 'settings.section',
+        id: '@goodandready/dsh-image-gen',
+        order: 34,
+        locale: NS,
+        label: () => t('settings.navLabel'),
+        inject: () => cardOnce().inject(),
+      },
+    ], FalSettingsCard)
     }
     exports.apply = apply
     exports.inject = inject

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.10",
   "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",