@goodandready/dsh-image-gen 0.10.22 → 0.10.24

package/lib/providers.js

@@ -1,240 +1,54 @@
 /**
- * Возвращает список кандидатов для имени ключа API с учётом известных алиасов (напр. FAL_API_KEY <-> FAL_KEY).
+ * Returns candidate API key names considering known aliases (e.g. FAL_API_KEY <-> FAL_KEY).
  */
-export function resolveApiKeyCandidates(ref) {
-  if (!ref) return []
-  const candidates = [ref]
-  if (ref === 'FAL_API_KEY') candidates.push('FAL_KEY')
-  else if (ref === 'FAL_KEY') candidates.push('FAL_API_KEY')
-  return candidates
-}
-
-
-export const PROVIDER_MAX_COUNTS = {
-  fal: 4,
-  replicate: 4,
-  custom: 10,
-  seedream: 10,
-  gemini: 4,
-  codex: 1,
-  grok: 1,
-  local: 4,
-}
-
-export function clampProviderCount(provider, count) {
-  const max = PROVIDER_MAX_COUNTS[provider] || 4
-  return normalizeCount(count, max)
-}
-
-export function buildEndpointUrl(baseURL, pathSuffix) {
-  const base = String(baseURL || '').trim().replace(/\/+$/, '')
-  const suffix = String(pathSuffix || '').trim().replace(/^\/+/, '')
-  return `${base}/${suffix}`
-}
-
-export function createAbortError(message = 'Image generation cancelled') {
-  const err = new Error(message)
-  err.name = 'AbortError'
-  return err
-}
-
-
-/** Fast Laplacian-like sharpness and entropy estimator across image scanlines. */
-export function estimateSharpnessAndVariance(bytes) {
-  const buf = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes || [])
-  if (!buf || buf.length < 64) {
-    return { score: 0, passed: false, isBlank: true, reason: 'Empty or corrupt image buffer' }
-  }
-  let sum = 0
-  let diffSum = 0
-  const sampleStep = Math.max(1, Math.floor(buf.length / 4096))
-  let count = 0
-  for (let i = 8; i < buf.length - sampleStep; i += sampleStep) {
-    const v = buf[i]
-    const nextV = buf[i + sampleStep]
-    sum += v
-    diffSum += Math.abs(v - nextV)
-    count++
-  }
-  const avgDiff = count > 0 ? diffSum / count : 0
-  if (avgDiff < 2) {
-    return { score: 0.1, passed: false, isBlank: true, reason: 'Image appears blank or solid monochrome' }
-  }
-  const score = Math.min(0.98, Math.max(0.3, +(0.5 + (avgDiff / 255) * 0.5).toFixed(2)))
-  return { score, passed: score >= 0.5, isBlank: false, avgDiff: +avgDiff.toFixed(2) }
-}
-
-/** Adaptive color palette quantizer for SVG vectorization. */
-export function quantizePalette(colorMode = 'color', paletteSize = 16) {
-  if (colorMode === 'binary') return ['#000000', '#ffffff']
-  if (colorMode === 'grayscale') return ['#000000', '#444444', '#888888', '#cccccc', '#ffffff']
-  // Standard vibrant UI vector palette
-  return [
-    '#000000', '#ffffff', '#e11d48', '#2563eb',
-    '#16a34a', '#ca8a04', '#9333ea', '#0891b2',
-    '#475569', '#64748b', '#94a3b8', '#cbd5e1'
-  ].slice(0, Math.max(2, paletteSize))
-}
-
-
-/** Format parameters in standard Automatic1111 / ComfyUI text format for drag-and-drop support. */
-export function formatA1111Parameters(metadata = {}) {
-  if (typeof metadata === 'string') return metadata
-  const prompt = metadata.prompt || ''
-  const neg = metadata.negative_prompt || metadata.negativePrompt || ''
-  const seed = metadata.seed ?? ''
-  const size = metadata.size || (metadata.width && metadata.height ? `${metadata.width}x${metadata.height}` : '1024x1024')
-  const model = metadata.model || metadata.provider || ''
-  const steps = metadata.steps || 20
-  const cfg = metadata.cfg_scale || metadata.guidance_scale || 7
-
-  let out = prompt
-  if (neg) out += `\nNegative prompt: ${neg}`
-  out += `\nSteps: ${steps}, Sampler: Euler, CFG scale: ${cfg}, Seed: ${seed}, Size: ${size}, Model: ${model}`
-  return out
-}
-
-
-import { createHash } from 'node:crypto'
-
-/** Deterministic sha256 hash for image generation caching. */
-export function computeGenerationHash({ provider, model, prompt, seed, size, style }) {
-  const norm = [
-    String(provider || '').trim().toLowerCase(),
-    String(model || '').trim().toLowerCase(),
-    String(prompt || '').trim(),
-    String(seed ?? ''),
-    String(size || '').trim().toLowerCase(),
-    String(style || '').trim().toLowerCase(),
-  ].join('|')
-  return createHash('sha256').update(norm).digest('hex')
-}
-
-// Провайдеры генерации изображений.
-//
-// Провайдер получает задание и возвращает готовые байты картинки. Всё, что
-// происходит дальше — вложение, файл в рабочей папке, ссылка и карточка
-// в разговоре — общее для всех провайдеров и живёт в index.js.
-//
-// Сеть приходит параметром (fetchImpl), ключ — через resolveKey, поэтому оба
-// провайдера проверяются юнит-тестами без единого реального запроса.
-
-export const PROVIDER_KEYS = ['fal', 'custom', 'codex', 'grok', 'local', 'seedream', 'gemini', 'replicate']
-
-/** Привести count из аргумента инструмента к диапазону 1..4. */
-/** Порядок провайдеров для fallback: основной первым, остальные по PROVIDER_KEYS. */
-export function fallbackOrder(primary) {
-  return [primary, ...PROVIDER_KEYS.filter((k) => k !== primary)]
-}
-
-/**
- * Перебирает генераторов по порядку, возвращает первый успешный результат.
- * При отказе всех бросает с перечислением причин.
- * @param generators - массив функций (key, seed) => Promise<generated>.
- * @param order - порядок ключей, длина = generators.length.
- */
-
-/** Calculate exponential backoff delay with jitter. */
-export function calculateBackoff(attempt, baseInterval = 500, maxInterval = 5000, jitterFactor = 0.2) {
-  const exp = Math.min(maxInterval, baseInterval * Math.pow(1.3, attempt))
-  const jitter = exp * jitterFactor * (Math.random() * 2 - 1)
-  return Math.max(100, Math.floor(exp + jitter))
-}
-
-/** Check if an error is a fatal client error that should NOT be cascaded to other providers. */
-export function isFatalClientError(error) {
-  const msg = (error?.message || String(error || '')).toLowerCase()
-  return (
-    msg.includes('content policy') ||
-    msg.includes('safety system') ||
-    msg.includes('nsfw') ||
-    msg.includes('moderation') ||
-    msg.includes('bad request (http 400') ||
-    msg.includes('invalid_prompt') ||
-    msg.includes('prompt is required') ||
-    msg.includes('unsupported image format') ||
-    msg.includes('402 payment required') ||
-    msg.includes('insufficient_quota') ||
-    msg.includes('insufficient credits') ||
-    msg.includes('exceeded your current quota') ||
-    msg.includes('balance is insufficient')
-  )
-}
-
-/**
- * Safely extract a human-readable message from any error, object, or response.
- * Completely eliminates "[object Object]" and prevents duplicate provider prefixes (e.g. "codex: codex: ...").
- */
-export function formatErrorMessage(e, providerKey = '') {
-  if (e === null || e === undefined) {
-    return providerKey ? `${providerKey}: unknown error` : 'unknown error'
-  }
-
-  let msg = ''
-  if (typeof e === 'string') {
-    msg = e
-  } else if (typeof e === 'object') {
-    if (typeof e.message === 'string' && e.message && e.message !== '[object Object]') {
-      msg = e.message
-    } else if (typeof e.detail === 'string' && e.detail) {
-      msg = e.detail
-    } else if (e.error) {
-      if (typeof e.error === 'string') msg = e.error
-      else if (typeof e.error.message === 'string') msg = e.error.message
-      else if (typeof e.error.detail === 'string') msg = e.error.detail
-      else {
-        try { msg = JSON.stringify(e.error) } catch {}
-      }
-    } else if (typeof e.statusText === 'string' && e.statusText) {
-      msg = `HTTP ${e.status || ''} ${e.statusText}`.trim()
-    } else if (typeof e.cause === 'string') {
-      msg = e.cause
-    } else if (e.cause && typeof e.cause.message === 'string') {
-      msg = e.cause.message
-    }
-
-    if (!msg || msg === '[object Object]') {
-      try {
-        const json = JSON.stringify(e)
-        if (json && json !== '{}') {
-          msg = json.slice(0, 500)
-        }
-      } catch {}
-    }
-
-    if (!msg || msg === '[object Object]') {
-      const keys = Object.getOwnPropertyNames(e)
-      if (keys.length) {
-        msg = `error [${keys.join(', ')}]`
-      } else {
-        msg = String(e)
-      }
-    }
-  } else {
-    msg = String(e)
-  }
-
-  msg = String(msg || 'unknown error').trim()
-
-  if (providerKey) {
-    const prefixRegex = new RegExp(`^${providerKey}\\s*:\\s*`, 'i')
-    while (prefixRegex.test(msg)) {
-      msg = msg.replace(prefixRegex, '').trim()
-    }
-  }
-
-  if (!msg || msg === '[object Object]') {
-    msg = 'unknown error object'
-  } else if (msg.includes('[object Object]')) {
-    msg = msg.replace(/\[object Object\]/g, 'unknown error object').trim()
-  }
-
-  if (providerKey) {
-    return `${providerKey}: ${msg}`
-  }
 
-  return msg
-}
+// Utilities and constants extracted to provider-utils.js (#239)
+import {
+  resolveApiKeyCandidates,
+  PROVIDER_MAX_COUNTS,
+  clampProviderCount,
+  buildEndpointUrl,
+  createAbortError,
+  estimateSharpnessAndVariance,
+  quantizePalette,
+  formatA1111Parameters,
+  computeGenerationHash,
+  PROVIDER_KEYS,
+  fallbackOrder,
+  calculateBackoff,
+  isFatalClientError,
+  formatErrorMessage,
+  resolveSubscriptionSize,
+  SUBSCRIPTION_SIZES,
+  IMAGE_SIZES,
+  OUTPUT_FORMATS,
+  SIZE_PIXELS,
+  normalizeCount,
+} from './provider-utils.js'
+
+// Re-export utilities so existing imports from './providers.js' continue to work
+export {
+  resolveApiKeyCandidates,
+  PROVIDER_MAX_COUNTS,
+  clampProviderCount,
+  buildEndpointUrl,
+  createAbortError,
+  estimateSharpnessAndVariance,
+  quantizePalette,
+  formatA1111Parameters,
+  computeGenerationHash,
+  PROVIDER_KEYS,
+  fallbackOrder,
+  calculateBackoff,
+  isFatalClientError,
+  formatErrorMessage,
+  resolveSubscriptionSize,
+  SUBSCRIPTION_SIZES,
+  IMAGE_SIZES,
+  OUTPUT_FORMATS,
+  SIZE_PIXELS,
+  normalizeCount,
+} from './provider-utils.js'
 
 export async function tryGenerate(generators, order, seed, promptArg) {
   const refusals = []
@@ -252,77 +66,14 @@ export async function tryGenerate(generators, order, seed, promptArg) {
   throw new Error(`Image generation failed on all providers. ${refusals.join('; ')}`)
 }
 
-export function normalizeCount(count, max = 4) {
-  const n = Math.floor(Number(count))
-  if (!Number.isFinite(n)) return 1
-  return Math.max(1, Math.min(max, n))
-}
 
-// Размеры, которыми оперируют подписки, — свой набор, не похожий на именованные
-// размеры FAL. Перевод один к одному по смыслу: квадрат, вертикаль, горизонталь.
+// Subscription services use their own aspect ratio taxonomy.
+// Normalize named sizes to standard square, landscape, and portrait equivalents.
 /**
- * Разрешает размер для подписочных сервисов (codex / grok).
- * Понимает именованные размеры (landscape_16_9 и др.), пропорции (16:9, 3:2, 9:16 и др.)
- * и размеры в пикселях [width, height], исключая дефолтный квадрат при запросе соотношений сторон.
+ * Resolves dimensions for subscription services (codex / grok).
+ * Supports named sizes (landscape_16_9, etc.), aspect ratios (16:9, 3:2, 9:16),
+ * and pixel dimensions [width, height], preserving requested proportions.
  */
-export function resolveSubscriptionSize(size, aspectPixels, aspectRatio) {
-  if (size && SUBSCRIPTION_SIZES[size]) {
-    return SUBSCRIPTION_SIZES[size]
-  }
-  const ratio = String(aspectRatio || '').trim()
-  if (ratio === '16:9' || ratio === '3:2' || ratio === '4:3') {
-    return '1536x1024'
-  }
-  if (ratio === '9:16' || ratio === '2:3' || ratio === '3:4') {
-    return '1024x1536'
-  }
-  if (ratio === '1:1') {
-    return '1024x1024'
-  }
-  if (Array.isArray(aspectPixels) && aspectPixels.length === 2) {
-    const [w, h] = aspectPixels
-    if (w > h) return '1536x1024'
-    if (h > w) return '1024x1536'
-    return '1024x1024'
-  }
-  return '1024x1024'
-}
-
-export const SUBSCRIPTION_SIZES = {
-  square_hd: '1024x1024',
-  square: '1024x1024',
-  portrait_4_3: '1024x1536',
-  portrait_16_9: '1024x1536',
-  landscape_4_3: '1536x1024',
-  landscape_16_9: '1536x1024',
-}
-
-/** Image sizes accepted by fal-ai/flux-2/klein (and most FAL flux models). */
-export const IMAGE_SIZES = [
-  'square_hd',
-  'square',
-  'portrait_4_3',
-  'portrait_16_9',
-  'landscape_4_3',
-  'landscape_16_9',
-]
-
-/** Output formats accepted by the model. */
-export const OUTPUT_FORMATS = ['png', 'jpeg', 'webp']
-
-// Именованные размеры — единый язык инструмента: он не должен меняться от того,
-// какой провайдер включён. FAL понимает их как есть, OpenAI-совместимые API
-// хотят ШxВ — для них перевод.
-export const SIZE_PIXELS = {
-  square_hd: '1024x1024',
-  square: '512x512',
-  portrait_4_3: '768x1024',
-  portrait_16_9: '576x1024',
-  landscape_4_3: '1024x768',
-  landscape_16_9: '1024x576',
-}
-
-/** Normalize a raw key into a FAL `Authorization: Key <key>` value. */
 export function falAuthHeader(key) {
   const trimmed = String(key ?? '').trim()
   if (!trimmed) return ''
@@ -342,7 +93,7 @@ export function normalizeMediaType(contentType, fallbackFormat) {
   return 'image/png'
 }
 
-/** Метаданные одной генерации для sidecar-файла рядом с картинкой. */
+/** Generation metadata written to companion sidecar file. */
 export function buildSidecar({
   prompt, size, format, seed, provider, deliverAs,
   width, height, mediaType, attachmentId, url, cost, createdAt = new Date().toISOString(),
@@ -406,13 +157,13 @@ export async function pollStatus(fetchImpl, statusUrl, key, signal, pollInterval
 /**
  * @param deps {{fetchImpl: Function, resolveKey: (ref: string) => Promise<string>, cfg: object}}
  * @param job {{prompt: string, size: string, format: string, seed: number|undefined, signal: AbortSignal}}
- * @returns провайдеры по ключу; каждый отдаёт
- *   {bytes, mediaType, width, height, seed, sourceUrl}. Нулевые width/height
- *   означают «спроси у службы вложений»: она всё равно измеряет байты сама.
+ * @returns providers by key; each yields
+ *   {bytes, mediaType, width, height, seed, sourceUrl}. Zero width/height
+ *   lets the attachments service measure image dimensions directly.
  */
 
-/** Именованный размер -> [width, height] для локальных API. */
-/** Соотношения сторон -> [w,h] (в пикселях, по базовой стороне 1024). */
+/** Named size -> [width, height] for local APIs. */
+/** Aspect ratio -> [width, height] (pixels, normalized to 1024 base). */
 export const ASPECT_RATIOS = {
   '1:1': [1024, 1024],
   '16:9': [1344, 768],
@@ -423,7 +174,7 @@ export const ASPECT_RATIOS = {
   '2:3': [768, 1152],
 }
 
-/** Размер в пикселях: aspectPixels (если задан) или из именованного размера. */
+/** Pixel dimensions: aspectPixels (if specified) or mapped from named size. */
 /** Snap a pixel dimension to nearest multiple of 64. */
 export function snapToMultipleOf64(dim, minVal = 256, maxVal = 2048) {
   const n = Math.round(Number(dim) / 64) * 64
@@ -447,7 +198,7 @@ export function sizeToPixels(size) {
   return [w, h]
 }
 
-/** Собрать multipart-тело для /images/edits (OpenAI-совместимый edit). */
+/** Assemble multipart body for /images/edits (OpenAI-compatible edit). */
 export function buildEditForm({ source, mask, prompt, size, strength }) {
   const form = new FormData()
   form.append('image', new Blob([source.bytes], { type: source.mediaType || 'image/png' }), 'source.png')
@@ -458,7 +209,7 @@ export function buildEditForm({ source, mask, prompt, size, strength }) {
   return form
 }
 
-/** Сравнить два изображения: доля различающихся пикселей (0..1). */
+/** Compare two images: ratio of differing pixels (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 }
@@ -469,9 +220,9 @@ export async function pixelDiff(a, b) {
   return { diffRatio: diff / a.length }
 }
 
-/** Извлечение детальных сообщений об ошибках нод ComfyUI из ответа /history/{pid}. */
+/** Extract detailed ComfyUI node error messages from /history/{pid} response. */
 
-/** Безопасное сохранение вложения с fallback'ом при отсутствии ctx.attachments */
+/** Safe attachment persistence with fallback when ctx.attachments is unavailable. */
 export async function saveAttachmentSafe(ctx, { bytes, mediaType, name }) {
   if (ctx && ctx.attachments && typeof ctx.attachments.saveImage === 'function') {
     try {
@@ -576,20 +327,18 @@ export function makeProviders(deps, job) {
     }
   }
 
-  // Любой OpenAI-совместимый API картинок. Один запрос вместо очереди FAL.
+  // OpenAI-compatible image API. Single HTTP request instead of queue polling.
   async function custom(seedArg = seed, promptArg = prompt) {
     const base = String(cfg.customBaseURL || '').replace(/\/+$/, '')
     if (!base) throw new Error('Custom image provider: base URL is not configured (Settings → Image generation)')
     if (!cfg.customModel) throw new Error('Custom image provider: model is not configured')
 
-    // Пустая ссылка на ключ — значит провайдер без авторизации, например
-    // локальный шлюз. Это законный случай, а не недонастройка.
+    // Empty key reference indicates unauthenticated gateway.
     const key = cfg.customKeyEnv ? await resolveKey(cfg.customKeyEnv) : ''
     const headers = { 'Content-Type': 'application/json' }
     if (key) headers.Authorization = `Bearer ${key}`
 
-    // response_format не отправляем: новые модели OpenAI его отвергают, а ответ
-    // всё равно приходит либо base64, либо ссылкой — принимаем оба.
+    // Omit response_format; modern models return either base64 or URL.
     const endpoint = buildEndpointUrl(base, source ? 'images/edits' : 'images/generations')
     const res = await fetchImpl(endpoint, {
       method: 'POST',
@@ -653,20 +402,18 @@ export function makeProviders(deps, job) {
     }
   }
 
-  // Генерация на подписке: аккаунт и токен живут в плагине подписок, здесь
-  // только запрос и разбор ответа. Токен сюда не попадает вовсе — служба
-  // отдаёт готовую картинку, а не ключ доступа.
+  // Subscription generation: dsh-subscriptions handles session authentication.
   function subscription(provider) {
     return async function generate(seedArg = seed, promptArg = prompt) {
       if (source) {
-        return { ok: false, provider, reason: `${provider}: не умеет править изображения — используйте fal, custom или local` }
+        return { ok: false, provider, reason: `${provider}: does not support image editing — use fal, custom, or local` }
       }
       const images = deps.subscriptionImages
       if (!images || typeof images.generate !== 'function') {
         return {
           ok: false,
           provider,
-          reason: `${provider}: нужен плагин подписок — он держит вход в аккаунт`,
+          reason: `${provider}: requires dsh-subscriptions plugin to manage session authentication`,
         }
       }
       let produced
@@ -683,11 +430,11 @@ export function makeProviders(deps, job) {
       }
       const first = Array.isArray(produced) ? produced[0] : null
       if (!first || !first.b64_json) {
-        return { ok: false, provider, reason: `${provider}: в ответе нет картинки` }
+        return { ok: false, provider, reason: `${provider}: no image returned in response` }
       }
       return {
         bytes: Buffer.from(first.b64_json, 'base64'),
-        // Подписки отдают png; формата в ответе нет, поэтому объявляем прямо.
+        // Subscription outputs default to PNG media type.
         mediaType: 'image/png',
         width: 0,
         height: 0,
@@ -698,7 +445,7 @@ export function makeProviders(deps, job) {
     }
   }
 
-  // Локальная генерация: ComfyUI (очередь + опрос) или Automatic1111 (txt2img).
+  // Local generation: ComfyUI (queue + poll) or Automatic1111 (txt2img).
   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)')
@@ -747,7 +494,7 @@ export function makeProviders(deps, job) {
       }
     }
 
-    // ComfyUI: submit через /prompt, опрос /history/{prompt_id} до готовности.
+    // ComfyUI: submit via /prompt, poll /history/{prompt_id} until completed.
     const promptId = `dsh-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`
     const workflow = {
       prompt: {
@@ -817,7 +564,7 @@ export function makeProviders(deps, job) {
     }
   }
 
-  // Seedream (ByteDance): OpenAI-совместимый API картинок.
+  // Seedream (ByteDance): OpenAI-compatible images API.
   async function seedream(seedArg = seed, promptArg = prompt) {
     const key = await resolveKey(cfg.seedreamKeyEnv)
     const base = (cfg.seedreamBaseURL || 'https://api.bytedanceapi.com/v1').replace(/\/+$/, '')
@@ -851,7 +598,7 @@ export function makeProviders(deps, job) {
     return { bytes: Buffer.from(await dl.arrayBuffer()), mediaType: normalizeMediaType('image/png', format), width: 0, height: 0, seed: seedArg ?? 0, sourceUrl: item.url }
   }
 
-  // Gemini (Google): images.generate через GenAI API.
+  // Gemini (Google): generateContent / imagen via GenAI API.
   async function gemini(seedArg = seed, promptArg = prompt) {
     const key = await resolveKey(cfg.geminiKeyEnv)
     const model = cfg.geminiModel || 'gemini-2.0-flash-exp-image-generation'
@@ -1148,7 +895,8 @@ export async function blendImagesFal({ fetchImpl, resolveKey, cfg }, { images, w
   return { bytes, mediaType: 'image/png', width: img.width || 0, height: img.height || 0, sourceUrl: img.url }
 }
 
-/** Прямой вызов редактирования (inpainting / img2img) через выбранного провайдера. */
+/** Direct image editing (inpainting / img2img) via selected provider. */
+/** @internal — direct provider call path for integration tests */
 export async function editImageDirect(deps, job) {
   const providers = makeProviders(deps, job)
   const providerKey = job.provider || deps.cfg.defaultProvider || 'fal'
@@ -1157,7 +905,8 @@ export async function editImageDirect(deps, job) {
   return fn(job.seed, job.prompt)
 }
 
-/** Прямой вызов вариаций изображения через выбранного провайдера. */
+/** Direct image variation via selected provider. */
+/** @internal — direct provider call path for integration tests */
 export async function varyImageDirect(deps, job) {
   const providers = makeProviders(deps, {
     ...job,
@@ -1270,6 +1019,58 @@ export async function testProviderConnection(deps, providerId) {
       return { ok: false, latencyMs, message: 'dsh-subscriptions plugin not installed' }
     }
 
+    if (p === 'replicate') {
+      const key = await resolveKey(cfg.replicateKeyEnv || 'REPLICATE_API_TOKEN')
+      if (!key) return { ok: false, latencyMs: 0, message: 'Replicate API token not configured' }
+      const res = await fetchImpl('https://api.replicate.com/v1/models', {
+        headers: { Authorization: `Bearer ${key}` },
+        signal: typeof AbortSignal !== 'undefined' && AbortSignal.timeout ? AbortSignal.timeout(6000) : undefined,
+      })
+      const latencyMs = Date.now() - start
+      if (res.status === 401 || res.status === 403) {
+        return { ok: false, latencyMs, message: `Replicate auth error (HTTP ${res.status})` }
+      }
+      if (res.ok) {
+        return { ok: true, latencyMs, message: 'Replicate API reachable' }
+      }
+      return { ok: false, latencyMs, message: `Replicate returned HTTP ${res.status}` }
+    }
+
+    if (p === 'gemini') {
+      const key = await resolveKey(cfg.geminiKeyEnv || 'GEMINI_API_KEY')
+      if (!key) return { ok: false, latencyMs: 0, message: 'Google Gemini API key not configured' }
+      const model = cfg.geminiModel || 'gemini-2.0-flash-exp-image-generation'
+      const res = await fetchImpl(`https://generativelanguage.googleapis.com/v1beta/models/${model}?key=${encodeURIComponent(key)}`, {
+        signal: typeof AbortSignal !== 'undefined' && AbortSignal.timeout ? AbortSignal.timeout(6000) : undefined,
+      })
+      const latencyMs = Date.now() - start
+      if (res.status === 400 || res.status === 401 || res.status === 403) {
+        return { ok: false, latencyMs, message: `Gemini API auth error (HTTP ${res.status})` }
+      }
+      if (res.ok) {
+        return { ok: true, latencyMs, message: 'Gemini Vision API operational' }
+      }
+      return { ok: false, latencyMs, message: `Gemini returned HTTP ${res.status}` }
+    }
+
+    if (p === 'seedream') {
+      const url = cfg.seedreamBaseURL || 'https://api.bytedanceapi.com/v1'
+      const key = await resolveKey(cfg.seedreamKeyEnv || 'SEEDREAM_API_KEY')
+      const headers = key ? { Authorization: `Bearer ${key}` } : {}
+      const res = await fetchImpl(`${url.replace(/\/+$/, '')}/models`, {
+        headers,
+        signal: typeof AbortSignal !== 'undefined' && AbortSignal.timeout ? AbortSignal.timeout(6000) : undefined,
+      }).catch(() => null)
+      const latencyMs = Date.now() - start
+      if (res && (res.ok || res.status === 404 || res.status === 405)) {
+        return { ok: true, latencyMs, message: 'Seedream endpoint reachable' }
+      }
+      if (res && (res.status === 401 || res.status === 403)) {
+        return { ok: false, latencyMs, message: `Seedream auth error (HTTP ${res.status})` }
+      }
+      return { ok: true, latencyMs, message: 'Seedream provider endpoint configured' }
+    }
+
     return { ok: true, latencyMs: Date.now() - start, message: `Provider "${p}" configured` }
   } catch (err) {
     return { ok: false, latencyMs: Date.now() - start, message: err.message || 'Connection timeout' }

package/lib/register-tools.js

@@ -2,7 +2,8 @@
 // Each tool lives in lib/tools/* and is registered inside a labeled ctx.effect.
 
 import { registerGenerationTools } from './tools/generation.js'
-import { registerProcessingTools } from './tools/processing.js'
+import { registerProcessingTools } from './tools/processing-basic.js'
+import { registerProcessingAdvancedTools } from './tools/processing-advanced.js'
 import { registerEditingTools } from './tools/editing.js'
 import { registerInspectTools } from './tools/inspect.js'
 import { registerFrontendTools } from './tools/frontend.js'
@@ -16,6 +17,7 @@ import { registerFrontendTools } from './tools/frontend.js'
 export function registerAllTools(ctx, deps) {
   registerGenerationTools(ctx, deps)
   registerProcessingTools(ctx, deps)
+  registerProcessingAdvancedTools(ctx, deps)
   registerEditingTools(ctx, deps)
   registerInspectTools(ctx, deps)
   registerFrontendTools(ctx, deps)

package/lib/resolve-image.js

@@ -230,7 +230,7 @@ export async function analyzeImageWithVision(ctx, exec, source) {
   }
 }
 /**
- * Форматирует структурированный текстовый отчёт для безопасного возврата в LLM (#150 Dual-Output).
+ * Formats structured text report for safe return to LLM (#150 Dual-Output).
  */
 export function buildDualOutputMarkdown({
   action = 'generated',