@goodandready/dsh-image-gen 0.8.0 → 0.8.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 dsh-fal-image-gen contributors
+Copyright (c) 2026 dsh-image-gen contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/lib/client.js

@@ -796,30 +796,46 @@ window.__ModuleLoader__.load({
           FalImageCard,
         ),
       )
-      // Свой раздел в боковом списке настроек, а не карточка во вкладке
-      // «Настройки плагинов».
+      // Карточка во вкладке «Настройки плагинов» вместо строки в боковом
+      // списке: список плоский и перестал помещаться, а карточки вкладки
+      // сворачиваются. Ключ слота обязан равняться пространству настроек:
+      // вкладка перебирает именно их, с чужим ключом карточка исчезла бы молча.
+      // Заголовок, пояснение и сворачивание рисует сама карточка — ядро даёт
+      // только рамку списка.
       //
-      // Ту вкладку рисует ядро, и в ней карточка появляется только если
-      // namespace успел попасть в общий вид настроек. У части установок эта
-      // вкладка остаётся пустой — плагины при этом грузятся штатно, ошибок нет,
-      // и повлиять на неё из плагина нечем. Собственный раздел рисуем мы сами,
-      // рядом с Vision и Голосом, и он от этой вкладки не зависит.
-      //
-      // Заодно отпадает возня с keyed-слотом: settings.section принимает id на
-      // всех версиях ядра, и держать сразу id и key больше не нужно.
-      ctx.slots.inject('settings.section', () =>
+      // Запасной путь: слот объявлен пакетом настроек ядра. Если в сборке его
+      // нет, регистрация бросает — тогда остаётся прежний раздел в боковом
+      // списке, чтобы настройки не пропали.
+      let placedInPluginsTab = false
+      try {
         ctx.slots.register(
           {
-            name: 'settings.section',
-            id: '@goodandready/dsh-image-gen',
-            order: 34,
+            name: 'settings.plugin.item',
+            key: SETTINGS_NS,
             locale: NS,
-            label: () => t('settings.navLabel'),
             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,
+          ),
+        )
+      }
     }
     exports.apply = apply
     exports.inject = inject

package/lib/index.js

@@ -21,11 +21,12 @@ import {
   IMAGE_SIZES,
   OUTPUT_FORMATS,
   PROVIDER_KEYS,
+  buildSidecar,
   makeProviders,
   normalizeMediaType,
 } from './providers.js'
 
-export { IMAGE_SIZES, OUTPUT_FORMATS, PROVIDER_KEYS, normalizeMediaType }
+export { IMAGE_SIZES, OUTPUT_FORMATS, PROVIDER_KEYS, buildSidecar, normalizeMediaType }
 
 export const name = 'dsh-image-gen'
 
@@ -335,6 +336,10 @@ export function apply(ctx, config) {
           { prompt: args.prompt, size, format, seed: args.seed, signal: exec.signal },
         )
         const generated = await providers[provider]()
+        // Подписочные провайдеры (codex/grok) отдают {ok:false, reason} вместо исключения:
+        // отказ должен дойти до модели текстом. Без проверки execute шёл дальше с пустыми
+        // байтами, и пользователь получал битую карточку вместо внятного отказа.
+        if (generated && generated.ok === false) throw new Error(generated.reason)
         const bytes = generated.bytes
 
         const mediaType = generated.mediaType
@@ -355,6 +360,24 @@ export function apply(ctx, config) {
         await mkdir(outDir, { recursive: true })
         const filePath = path.join(outDir, name)
         await writeFile(filePath, bytes)
+        // Sidecar: рядом с картинкой — метаданные генерации. Каталог становится
+        // самодокументируемым (галерея/повтор/диагностика читают их без БД).
+        await writeFile(
+          path.join(outDir, `${stem}.json`),
+          JSON.stringify(buildSidecar({
+            prompt: args.prompt,
+            size,
+            format,
+            seed: generated.seed,
+            provider,
+            deliverAs,
+            width: generated.width || attachment.width,
+            height: generated.height || attachment.height,
+            mediaType,
+            attachmentId: attachment.attachmentId,
+            url: deliverAs === 'image' && generated.sourceUrl ? generated.sourceUrl : localUrl,
+          }), null, 2),
+        )
 
         // The plugin's own route outlives the fal.media link, and the card
         // needs the reference anyway to verify the bytes.

package/lib/providers.js

@@ -65,6 +65,14 @@ export function normalizeMediaType(contentType, fallbackFormat) {
   return 'image/png'
 }
 
+/** Метаданные одной генерации для sidecar-файла рядом с картинкой. */
+export function buildSidecar({
+  prompt, size, format, seed, provider, deliverAs,
+  width, height, mediaType, attachmentId, url, createdAt = new Date().toISOString(),
+}) {
+  return { prompt, size, format, seed, provider, deliverAs, width, height, mediaType, attachmentId, url, createdAt }
+}
+
 /** Submit a generation job to the FAL queue. */
 export async function submitJob(fetchImpl, baseURL, model, key, body, signal) {
   const res = await fetchImpl(`${baseURL}/${model}`, {

package/package.json

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