@goodandready/dsh-image-gen 0.8.8 → 0.8.9

package/lib/client.js

@@ -18,6 +18,24 @@ window.__ModuleLoader__.load({
     let react_jsx_runtime = require('react/jsx-runtime')
     let runtime = require('@deepseek-ai/dsh-client-runtime/client')
 
+    // Ядровый шеврон раскрытия; в урезанной сборке — запасной SVG той же формы.
+    let ChevronIcon = null
+    try {
+      const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
+      ChevronIcon = primitives && primitives.IconChevronDownOutline14
+    } catch (noPrimitives) {
+      ChevronIcon = null
+    }
+    const ChevronIconNode = ChevronIcon || react.createElement('svg', {
+      width: 14, height: 14, viewBox: '0 0 14 14', 'aria-hidden': true,
+      style: { display: 'block' },
+    }, react.createElement('path', {
+      d: 'M3 5.5 L7 9.5 L11 5.5',
+      fill: 'none', stroke: 'currentColor', strokeWidth: 1.5,
+      strokeLinecap: 'round', strokeLinejoin: 'round',
+    }))
+
+
     // ---------------------------------------------------------------- css
     const css =
       '.fal_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none}' +
@@ -55,7 +73,12 @@ 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_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}'
     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')
@@ -92,6 +115,11 @@ 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
@@ -134,7 +162,7 @@ window.__ModuleLoader__.load({
                 ],
               }),
               state.dirty ? react_jsx_runtime.jsx('span', { className: cssDefault.pending, children: props.t('settings.unsaved') }) : null,
-              react_jsx_runtime.jsx('span', { className: cssDefault.chevron + (open ? ' ' + cssDefault.chevronOpen : ''), children: '\u25be' }),
+              react_jsx_runtime.jsx('span', { className: cssDefault.chevron + (open ? ' ' + cssDefault.chevronOpen : ''), children: ChevronIconNode }),
             ],
           }),
           open
@@ -424,18 +452,18 @@ window.__ModuleLoader__.load({
     /** Field specs in display order. */
     const FIELDS = [
       { field: 'provider', spec: selectField('provider', PROVIDERS), kind: 'select', options: PROVIDERS, labelKey: 'f.provider', hintKey: 'f.providerHint', providerNeeds: { fal: 'ключ FAL', custom: 'адрес + ключ', codex: 'подписка ChatGPT', grok: 'подписка Grok', local: 'адрес сервера' } },
-      { field: 'model', spec: textField('model'), kind: 'text', labelKey: 'f.model', hintKey: 'f.modelHint', placeholderKey: 'p.model' },
-      { field: 'apiKeyEnv', spec: textField('apiKeyEnv'), kind: 'text', labelKey: 'f.apiKeyEnv', hintKey: 'f.apiKeyEnvHint', placeholderKey: 'p.apiKeyEnv' },
-      { field: 'baseURL', spec: textField('baseURL'), kind: 'text', labelKey: 'f.baseURL', hintKey: 'f.baseURLHint', placeholderKey: 'p.baseURL' },
+      { field: 'model', spec: textField('model'), kind: 'text', labelKey: 'f.model', hintKey: 'f.modelHint', placeholderKey: 'p.model', when: ['fal'] },
+      { field: 'apiKeyEnv', spec: textField('apiKeyEnv'), kind: 'text', labelKey: 'f.apiKeyEnv', hintKey: 'f.apiKeyEnvHint', placeholderKey: 'p.apiKeyEnv', when: ['fal'] },
+      { field: 'baseURL', spec: textField('baseURL'), kind: 'text', labelKey: 'f.baseURL', hintKey: 'f.baseURLHint', placeholderKey: 'p.baseURL', when: ['fal'] },
       { field: 'defaultSize', spec: selectField('defaultSize', IMAGE_SIZES), kind: 'select', options: IMAGE_SIZES, labelKey: 'f.defaultSize', hintKey: 'f.defaultSizeHint', sizePixels: SIZE_PIXELS },
       { field: 'defaultFormat', spec: selectField('defaultFormat', OUTPUT_FORMATS), kind: 'select', options: OUTPUT_FORMATS, labelKey: 'f.defaultFormat', hintKey: 'f.defaultFormatHint' },
-      { field: 'pollIntervalMs', spec: numberField('pollIntervalMs'), kind: 'number', labelKey: 'f.pollIntervalMs', hintKey: 'f.pollIntervalMsHint', placeholderKey: 'p.pollIntervalMs' },
-      { field: 'timeoutMs', spec: numberField('timeoutMs'), kind: 'number', labelKey: 'f.timeoutMs', hintKey: 'f.timeoutMsHint', placeholderKey: 'p.timeoutMs' },
+      { field: 'pollIntervalMs', spec: numberField('pollIntervalMs'), kind: 'number', labelKey: 'f.pollIntervalMs', hintKey: 'f.pollIntervalMsHint', placeholderKey: 'p.pollIntervalMs', when: ['fal'] },
+      { field: 'timeoutMs', spec: numberField('timeoutMs'), kind: 'number', labelKey: 'f.timeoutMs', hintKey: 'f.timeoutMsHint', placeholderKey: 'p.timeoutMs', when: ['fal'] },
       { field: 'deliverAs', spec: selectField('deliverAs', DELIVERY_MODES), kind: 'select', options: DELIVERY_MODES, labelKey: 'f.deliverAs', hintKey: 'f.deliverAsHint' },
-      { field: 'customBaseURL', spec: textField('customBaseURL'), kind: 'text', labelKey: 'f.customBaseURL', hintKey: 'f.customBaseURLHint', placeholderKey: 'p.customBaseURL' },
-      { field: 'customModel', spec: textField('customModel'), kind: 'text', labelKey: 'f.customModel', hintKey: 'f.customModelHint', placeholderKey: 'p.customModel' },
-      { field: 'customKeyEnv', spec: textField('customKeyEnv'), kind: 'text', labelKey: 'f.customKeyEnv', hintKey: 'f.customKeyEnvHint', placeholderKey: 'p.customKeyEnv' },
-      { field: 'customSize', spec: textField('customSize'), kind: 'text', labelKey: 'f.customSize', hintKey: 'f.customSizeHint', placeholderKey: 'p.customSize' },
+      { field: 'customBaseURL', spec: textField('customBaseURL'), kind: 'text', labelKey: 'f.customBaseURL', hintKey: 'f.customBaseURLHint', placeholderKey: 'p.customBaseURL', when: ['custom'] },
+      { field: 'customModel', spec: textField('customModel'), kind: 'text', labelKey: 'f.customModel', hintKey: 'f.customModelHint', placeholderKey: 'p.customModel', when: ['custom'] },
+      { field: 'customKeyEnv', spec: textField('customKeyEnv'), kind: 'text', labelKey: 'f.customKeyEnv', hintKey: 'f.customKeyEnvHint', placeholderKey: 'p.customKeyEnv', when: ['custom'] },
+      { field: 'customSize', spec: textField('customSize'), kind: 'text', labelKey: 'f.customSize', hintKey: 'f.customSizeHint', placeholderKey: 'p.customSize', when: ['custom'] },
       { field: 'outputDir', spec: textField('outputDir'), kind: 'text', labelKey: 'f.outputDir', hintKey: 'f.outputDirHint', placeholderKey: 'p.outputDir' },
     ]
 
@@ -465,10 +493,68 @@ window.__ModuleLoader__.load({
     }
 
     /** 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 disabled = !state.writable
+      const currentProvider = (state.provider && state.provider.text) || 'fal'
+      const visibleFields = FIELDS.filter((entry) => !entry.when || entry.when.includes(currentProvider))
       const fieldProps = {
         overriddenLabel: t('settings.overridden'),
         resetLabel: t('settings.reset'),
@@ -484,7 +570,7 @@ window.__ModuleLoader__.load({
         onDiscard: props.discard,
         children: [
           react_jsx_runtime.jsx('p', { className: cssDefault.hint, children: t('settings.credentialHint') }),
-          FIELDS.map((entry) =>
+          visibleFields.map((entry) =>
             react_jsx_runtime.jsx(
               Field,
               {
@@ -498,6 +584,9 @@ window.__ModuleLoader__.load({
               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' }),
         ],
       })
     }
@@ -583,6 +672,10 @@ window.__ModuleLoader__.load({
       'p.customKeyEnv': 'Example: OPENAI_API_KEY',
       'p.customSize': 'Example: 1024x1024',
       'p.outputDir': 'Example: generated/images',
+      'history.title': 'Generation history',
+      'history.all': 'All providers',
+      'history.empty': 'No generations yet',
+      'history.loading': 'Loading…',
     }
 
     const ru = {
@@ -642,6 +735,10 @@ window.__ModuleLoader__.load({
       'p.customKeyEnv': 'Пример: OPENAI_API_KEY',
       'p.customSize': 'Пример: 1024x1024',
       'p.outputDir': 'Пример: generated/images',
+      'history.title': 'История генераций',
+      'history.all': 'Все провайдеры',
+      'history.empty': 'Ещё нет генераций',
+      'history.loading': 'Загрузка…',
     }
 
     // ── карточка результата generate_image ────────────────────────────────
@@ -701,6 +798,8 @@ window.__ModuleLoader__.load({
       const running = !('kind' in (block || {}))
       const failed = block && (block.isError || block.error !== undefined)
       const parsed = readResult(block)
+      const [editing, setEditing] = react.useState(false)
+      const [editText, setEditText] = react.useState('')
       let prompt = ''
       try {
         const raw = (block && (block.call ? block.call.argsRaw : block.argsRaw)) || ''
@@ -805,6 +904,43 @@ window.__ModuleLoader__.load({
           onClick: repeat,
         }, 'Повторить генерацию'))
       }
+      if (!running && !failed) {
+        if (editing) {
+          body.push(react.createElement('input', {
+            key: 'editinput',
+            type: 'text',
+            className: 'fal-input',
+            value: editText,
+            placeholder: prompt || 'Новый промпт',
+            onChange: (e) => setEditText(e.target.value),
+          }))
+          body.push(react.createElement('button', {
+            key: 'editsend',
+            type: 'button',
+            className: 'fal-repeat',
+            onClick: async () => {
+              const text = (editText || prompt || '').trim()
+              if (!text) return
+              try {
+                const sessions = props.sessions
+                const current = sessions && sessions.list && sessions.list.current
+                const binding = current && sessions.binding(current)
+                const session = binding && binding.session
+                if (session && session.prompt) await session.prompt([{ type: 'text', text }], 'queue')
+              } catch (e) { /* контур сам покажет */ }
+              setEditing(false)
+              setEditText('')
+            },
+          }, 'Отправить'))
+        } else {
+          body.push(react.createElement('button', {
+            key: 'edit',
+            type: 'button',
+            className: 'fal-repeat',
+            onClick: () => { setEditText(prompt || ''); setEditing(true) },
+          }, 'Изменить промпт'))
+        }
+      }
       if (!running && !failed && downloadUrl) {
         body.push(react.createElement('a', {
           key: 'download',

package/lib/index.js

@@ -24,6 +24,8 @@ import {
   PROVIDER_KEYS,
   buildSidecar,
   makeProviders,
+  ASPECT_RATIOS,
+  pixelDiff,
   normalizeCount,
   tryGenerate,
   fallbackOrder,
@@ -153,6 +155,10 @@ export const Config = z.object({
     .number()
     .description('How many recent generations to keep in the in-memory history list.')
     .default(50),
+  pruneDays: z
+    .number()
+    .description('Delete generated files and history entries older than this many days. 0 (default) disables pruning.')
+    .default(0),
   enhancePrompt: z
     .boolean()
     .description('Expand a short prompt into a detailed one through the chat model before generating. Off by default.')
@@ -173,6 +179,10 @@ export const Config = z.object({
     .boolean()
     .description('If the same seed+prompt was already generated (present in history), return the cached result instead of generating again. Off by default.')
     .default(false),
+  cacheByPrompt: z
+    .boolean()
+    .description('If the same prompt was already generated (present in history), return the cached result instead of generating again. Off by default.')
+    .default(false),
 })
 
 /** Keep a file stem safe for the filesystem. */
@@ -246,6 +256,11 @@ export function historyFile() {
 
 /** Прочитать историю из файла (пусто, если файла нет). */
 /** Найти запись истории по seed+prompt, если файл ещё существует. */
+/** Найти запись истории по промпту (без учёта seed), если файл существует. */
+export async function findCachedByPrompt(entries, prompt) {
+  return entries.find((e) => e.prompt === prompt)
+}
+
 export async function findCached(entries, seed, prompt) {
   if (seed === undefined) return undefined
   return entries.find((e) => e.seed === seed && e.prompt === prompt)
@@ -268,6 +283,22 @@ export async function cachedResult(entry) {
   }
 }
 
+/** Удалить файлы и записи истории старше pruneDays дней. */
+export async function pruneHistory(entries, pruneDays) {
+  if (!pruneDays || pruneDays <= 0) return entries
+  const cutoff = Date.now() - pruneDays * 86400000
+  const kept = []
+  for (const e of entries) {
+    const created = e.createdAt ? Date.parse(e.createdAt) : NaN
+    if (Number.isFinite(created) && created < cutoff) {
+      try { require('node:fs').unlinkSync(e.path) } catch (err) { /* файл уже удалён */ }
+      continue
+    }
+    kept.push(e)
+  }
+  return kept
+}
+
 export async function readHistory() {
   try {
     const raw = await readFile(historyFile(), 'utf-8')
@@ -447,6 +478,11 @@ export function apply(ctx, config) {
           type: 'string',
           description: `One of: ${IMAGE_SIZES.join(', ')}. Default: ${config.defaultSize}.`,
         },
+        aspect_ratio: {
+          type: 'string',
+          enum: ['1:1', '16:9', '9:16', '4:3', '3:4'],
+          description: 'Optional aspect ratio; overrides image_size when both are given. Sent as width/height to providers that accept pixels.',
+        },
         seed: {
           type: 'integer',
           description: 'Optional seed for reproducible output.',
@@ -466,8 +502,13 @@ export function apply(ctx, config) {
         },
         prompts: {
           type: 'array',
-          items: { type: 'string' },
-          description: 'Optional list of prompts; one image is generated per prompt. When set, overrides count and the single prompt.',
+          items: {
+            oneOf: [
+              { type: 'string' },
+              { type: 'object', additionalProperties: false, properties: { text: { type: 'string' } } },
+            ],
+          },
+          description: 'Optional list of prompts (strings or {text}); one image is generated per prompt. When set, overrides count and the single prompt.',
         },
         negative_prompt: {
           type: 'string',
@@ -482,6 +523,10 @@ export function apply(ctx, config) {
           enum: ['low', 'medium', 'high'],
           description: 'Optional quality for providers that support it (seedream, gemini). Ignored otherwise.',
         },
+        style: {
+          type: 'string',
+          description: 'Optional style preset for providers that support it (seedream, gemini). Ignored otherwise.',
+        },
         source_image: {
           type: 'string',
           description: 'Optional path to an image file or an attachment id (sha256:...) to edit instead of drawing from scratch. Only providers that support image editing accept it; others refuse with a clear reason.',
@@ -556,10 +601,11 @@ export function apply(ctx, config) {
         const cfg = live()
         const provider = PROVIDER_KEYS.includes(cfg.provider) ? cfg.provider : 'fal'
         const deliverAs = cfg.deliverAs
-        const size = args.image_size ?? cfg.defaultSize
-        if (!IMAGE_SIZES.includes(size)) {
+        const size = args.aspect_ratio ? 'custom' : (args.image_size ?? cfg.defaultSize)
+        if (!args.aspect_ratio && !IMAGE_SIZES.includes(size)) {
           throw new Error(`Invalid image_size "${size}". One of: ${IMAGE_SIZES.join(', ')}`)
         }
+        const aspectPixels = args.aspect_ratio ? ASPECT_RATIOS[args.aspect_ratio] : undefined
         const format = args.output_format ?? cfg.defaultFormat
         if (!OUTPUT_FORMATS.includes(format)) {
           throw new Error(`Invalid output_format "${format}". One of: ${OUTPUT_FORMATS.join(', ')}`)
@@ -576,7 +622,7 @@ export function apply(ctx, config) {
         const effectivePrompt = enhanced.prompt + styleSuffix
         const providers = makeProviders(
           { fetchImpl: fetch, resolveKey: (ref) => resolveApiKey(ctx, ref), cfg, subscriptionImages },
-          { prompt: effectivePrompt, size, format, seed: args.seed, signal: exec.signal, negativePrompt: args.negative_prompt, guidanceScale: args.guidance_scale, source, mask, strength: args.strength, quality: args.quality },
+          { prompt: effectivePrompt, size, format, seed: args.seed, signal: exec.signal, negativePrompt: args.negative_prompt, guidanceScale: args.guidance_scale, source, mask, strength: args.strength, quality: args.quality, style: args.style, aspectPixels },
         )
         // Подписочные провайдеры (codex/grok) отдают {ok:false, reason} вместо исключения:
         // отказ должен дойти до модели текстом. Без проверки execute шёл дальше с пустыми
@@ -639,7 +685,8 @@ export function apply(ctx, config) {
             createdAt: new Date().toISOString(),
             attachmentId: attachment.attachmentId,
           }
-          const current = await readHistory()
+          let current = await readHistory()
+          current = await pruneHistory(current, cfg.pruneDays)
           current.unshift(entry)
           if (current.length > (cfg.historyLimit || 50)) current.length = cfg.historyLimit || 50
           await writeHistory(current)
@@ -671,17 +718,19 @@ export function apply(ctx, config) {
         const order = fallbackOrder(provider)
         const generators = Object.fromEntries(PROVIDER_KEYS.map((k) => [k, (s, p) => one(s, k, p)]))
         const images = []
-        const historyEntries = cfg.cacheBySeed ? await readHistory() : []
+        const historyEntries = (cfg.cacheBySeed || cfg.cacheByPrompt) ? await readHistory() : []
         const batchPrompts = Array.isArray(args.prompts) && args.prompts.length ? args.prompts : null
         if (batchPrompts) {
           for (let i = 0; i < batchPrompts.length; i += 1) {
-            const cached = cfg.cacheBySeed ? await cachedResult(findCached(historyEntries, seedBase + i, batchPrompts[i])) : undefined
-            images.push(cached || await tryGenerate(generators, order, seedBase + i, batchPrompts[i]))
+            const item = batchPrompts[i]
+            const text = typeof item === 'string' ? item : (item && item.text) || ''
+            const cached = cfg.cacheBySeed ? await cachedResult(findCached(historyEntries, seedBase + i, text)) : (cfg.cacheByPrompt ? await cachedResult(findCachedByPrompt(historyEntries, text)) : undefined)
+            images.push(cached || await tryGenerate(generators, order, seedBase + i, text))
           }
         } else {
           const count = normalizeCount(args.count)
           for (let i = 0; i < count; i += 1) {
-            const cached = cfg.cacheBySeed ? await cachedResult(findCached(historyEntries, seedBase + i, effectivePrompt)) : undefined
+            const cached = cfg.cacheBySeed ? await cachedResult(findCached(historyEntries, seedBase + i, effectivePrompt)) : (cfg.cacheByPrompt ? await cachedResult(findCachedByPrompt(historyEntries, effectivePrompt)) : undefined)
             images.push(cached || await tryGenerate(generators, order, seedBase + i))
           }
         }
@@ -690,4 +739,31 @@ export function apply(ctx, config) {
       },
     }),
   )
+
+  // Сравнение двух изображений: доля различающихся пикселей.
+  ctx.tools.register(
+    defineTool({
+      name: 'compare_images',
+      description: 'Compare two images (paths or attachment ids) and report the fraction of differing pixels. Use to check how much an edit changed the original.',
+      parameters: {
+        image_a: { type: 'string', required: true, description: 'Path or attachment id of the first image.' },
+        image_b: { type: 'string', required: true, description: 'Path or attachment id of the second image.' },
+      },
+      output: {
+        schema: {
+          type: 'object',
+          additionalProperties: false,
+          properties: {
+            diffRatio: { type: 'number' },
+            error: { type: 'string' },
+          },
+        },
+      },
+      async execute(args, exec) {
+        const a = await resolveSource(ctx, exec, args.image_a)
+        const b = await resolveSource(ctx, exec, args.image_b)
+        return pixelDiff(a && a.bytes, b && b.bytes)
+      },
+    }),
+  )
 }

package/lib/providers.js

@@ -159,6 +159,21 @@ export async function pollStatus(fetchImpl, statusUrl, key, signal, pollInterval
  */
 
 /** Именованный размер -> [width, height] для локальных API. */
+/** Соотношения сторон -> [w,h] (в пикселях, по базовой стороне 1024). */
+export const ASPECT_RATIOS = {
+  '1:1': [1024, 1024],
+  '16:9': [1344, 768],
+  '9:16': [768, 1344],
+  '4:3': [1152, 896],
+  '3:4': [896, 1152],
+}
+
+/** Размер в пикселях: aspectPixels (если задан) или из именованного размера. */
+export function pxSize(aspectPixels, size) {
+  if (aspectPixels) return aspectPixels
+  return sizeToPixels(size)
+}
+
 export function sizeToPixels(size) {
   const px = SIZE_PIXELS[size]
   if (!px) return [1024, 1024]
@@ -177,9 +192,20 @@ export function buildEditForm({ source, mask, prompt, size, strength }) {
   return form
 }
 
+/** Сравнить два изображения: доля различающихся пикселей (0..1). */
+export async function pixelDiff(a, b) {
+  if (!a || !b) return { error: 'missing image' }
+  if (a.length !== b.length) return { error: 'size mismatch', diffRatio: 1 }
+  let diff = 0
+  for (let i = 0; i < a.length; i += 1) {
+    if (a[i] !== b[i]) diff += 1
+  }
+  return { diffRatio: diff / a.length }
+}
+
 export function makeProviders(deps, job) {
   const { fetchImpl, resolveKey, cfg } = deps
-  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality } = job
+  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality, style, aspectPixels } = job
 
   async function fal(seedArg = seed, promptArg = prompt) {
     const key = await resolveKey(cfg.apiKeyEnv)
@@ -236,12 +262,12 @@ export function makeProviders(deps, job) {
       method: 'POST',
       headers,
       body: source
-        ? buildEditForm({ source, mask, prompt: promptArg, size: cfg.customSize || SIZE_PIXELS[size] || size, strength })
+        ? buildEditForm({ source, mask, prompt: promptArg, size: cfg.customSize || (aspectPixels ? aspectPixels.join('x') : SIZE_PIXELS[size]) || size, strength })
         : JSON.stringify({
             model: cfg.customModel,
             prompt: promptArg,
             n: 1,
-            size: cfg.customSize || SIZE_PIXELS[size] || size,
+            size: cfg.customSize || (aspectPixels ? aspectPixels.join('x') : SIZE_PIXELS[size]) || size,
             ...(negativePrompt !== undefined ? { negative_prompt: negativePrompt } : {}),
             ...(guidanceScale !== undefined ? { guidance_scale: guidanceScale } : {}),
           }),
@@ -336,7 +362,7 @@ export function makeProviders(deps, job) {
   async function local(seedArg = seed, promptArg = prompt) {
     const base = String(cfg.localBaseURL || '').replace(/\/+$/, '')
     if (!base) throw new Error('Local image provider: server address is not configured (Settings → Image generation)')
-    const [width, height] = sizeToPixels(size)
+    const [width, height] = pxSize(aspectPixels, size)
     const kind = cfg.localKind === 'a1111' ? 'a1111' : 'comfyui'
 
     if (kind === 'a1111') {
@@ -440,9 +466,10 @@ export function makeProviders(deps, job) {
         model: cfg.seedreamModel || 'seedream-4.0',
         prompt: promptArg,
         n: 1,
-        size: SIZE_PIXELS[size] || size,
+        size: (aspectPixels ? aspectPixels.join('x') : SIZE_PIXELS[size]) || size,
         ...(negativePrompt !== undefined ? { negative_prompt: negativePrompt } : {}),
         ...(quality !== undefined ? { quality } : {}),
+        ...(style !== undefined ? { style } : {}),
       }),
       signal,
     })
@@ -471,7 +498,7 @@ export function makeProviders(deps, job) {
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
         contents: [{ parts: [{ text: promptArg }] }],
-        generationConfig: { responseModalities: ['IMAGE'], ...(quality !== undefined ? { imageConfig: { imageQuality: quality } } : {}) },
+        generationConfig: { responseModalities: ['IMAGE'], ...(quality !== undefined ? { imageConfig: { imageQuality: quality } } : {}), ...(style !== undefined ? { imageConfig: { imageStyle: style } } : {}) },
       }),
       signal,
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-image-gen",
-  "version": "0.8.8",
+  "version": "0.8.9",
   "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",