@goodandready/dsh-image-gen 0.11.8 → 0.11.10

package/README.md

@@ -167,6 +167,9 @@
 * **Cache & History Consistency**: Ensured content-addressed disk cache hits synchronize seamlessly with generation history and sidecar metadata.
 * **Test Suite Expansion**: Added `test/batch4-hardening.test.mjs`, expanding test coverage to **128 automated unit tests (100% pass)**.
 
+### 🚀 What's New in v0.11.9
+* **ComfyUI Local Backend Payload Fix (#322, GitHub #7)**: Eliminated redundant nesting in `lib/providers/backends/local.js` that wrapped workflows as `{ prompt: { prompt: workflowGraph } }`, resolving `missing_node_type: Node 'ID #prompt' has no class_type` HTTP 400 errors during local ComfyUI generations. Added node shape validation before submission.
+
 ### 🚀 What's New in v0.11.8
 * **Bounded Config Payloads (#313)**: `PUT /dsh-image-gen/config` now uses bounded request streaming (`readBoundedRequestBody`) with a 64 KB cap, returning HTTP 413 `Payload Too Large` on oversized bodies to prevent memory exhaustion DoS.
 * **Build Parity Gate (#316)**: `scripts/build-client.mjs` supports `--check` mode, enforcing client distribution parity in `npm test`.

package/README.ru.md

@@ -34,6 +34,9 @@
 </div>
 
 ---
+## 🚀 Обновления v0.11.9: Исправление структуры запроса ComfyUI (#322, GitHub #7)
+* **Устранение двойного вложения промпта в ComfyUI**: В `lib/providers/backends/local.js` устранена лишняя обёртка `{ prompt: workflow }`, приводившая к отправке `{ prompt: { prompt: workflowGraph } }` и ошибке ComfyUI `missing_node_type: Node 'ID #prompt' has no class_type`. Добавлена превентивная валидация графа нод перед отправкой.
+
 ## 🚀 Обновления v0.11.8: Защита конфигурационных маршрутов, паритет сборки и модульная архитектура
 * **Ограничение размера тела настроек (#313)**: Маршрут `PUT /dsh-image-gen/config` защищён лимитом 64 КБ с возвратом HTTP 413 `Payload Too Large` при превышении, исключая DoS ядра через исчерпание кучи.
 * **Контроль паритета сборки клиента (#316)**: В `scripts/build-client.mjs` добавлен режим `--check`, встроенный в `npm test` для предотвращения рассинхронизации `lib/client.js` с фрагментами `src/client/*`.

package/README.zh.md

@@ -38,6 +38,7 @@
 ## ⚡ 核心功能与架构提升 (v0.10.0)
 
 **`@goodandready/dsh-image-gen`** 为 DeepSeek Harness 提供工业级高可用的图像生成与视觉处理工具链：
+* **ComfyUI 本地后端工作流形状修复 (#322, GitHub #7)**：修复 `lib/providers/backends/local.js` 中多包一层 `{ prompt: workflow }` 导致 ComfyUI 报 `missing_node_type: Node 'ID #prompt' has no class_type` 的缺陷；增加节点结构自检。
 * **8大后端全面支持**: FAL.ai、Replicate、OpenAI/SiliconFlow、ChatGPT Plus (OAuth)、Grok Imagine (OAuth)、ComfyUI/A1111 本地生成、ByteDance SeaDream 与 Google Imagen 3。
 * **指数退避与 Jitter 队列防爆**: 针对 FAL 与 Replicate 异步队列引入智能 Backoff 轮询，彻底杜绝 429 报错。
 * **确定性哈希缓存 (Deterministic Cache)**: 相同 Prompt 与 Seed 的重复请求直接从本地秒级返回，零 API 消耗。

package/lib/providers/backends/local.js

@@ -97,11 +97,20 @@ export function createLocalGenerator(deps, job) {
       })
     }
 
-    const workflow = { prompt: workflowGraph }
+    // Validate workflow node shape before submitting to ComfyUI (GH#7)
+    if (!workflowGraph || typeof workflowGraph !== 'object' || Array.isArray(workflowGraph)) {
+      throw new Error('Local ComfyUI workflow graph must be a valid node object')
+    }
+    for (const [nodeId, node] of Object.entries(workflowGraph)) {
+      if (!node || typeof node !== 'object' || Array.isArray(node) || !node.class_type) {
+        throw new Error(`Local ComfyUI workflow node "${nodeId}" is invalid or missing required "class_type" property`)
+      }
+    }
+
     const submit = await fetchImpl(`${base}/prompt`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ prompt: workflow, client_id: promptId }),
+      body: JSON.stringify({ prompt: workflowGraph, client_id: promptId }),
       signal,
     })
     if (!submit.ok) {

package/lib/tools/generation.js

@@ -178,16 +178,33 @@ export function registerGenerationTools(ctx, deps) {
           type: 'object',
           additionalProperties: true,
           properties: {
+            summary: { type: 'string' },
+            channel: { type: 'string' },
+            provider: { type: 'string' },
+            model: { type: 'string' },
+            _fallback: { type: 'string' },
             path: { type: 'string' },
             url: { type: 'string' },
             width: { type: 'integer' },
             height: { type: 'integer' },
             seed: { type: 'integer' },
             prompt: { type: 'string' },
+            originalPrompt: { type: 'string' },
             format: { type: 'string' },
+            cost: { type: 'number' },
+            fromCache: { type: 'boolean' },
+            qualityReport: { type: 'object', additionalProperties: true },
+            anchor: {
+              type: 'object',
+              additionalProperties: true,
+              properties: {
+                label: { type: 'string' },
+                mode: { type: 'string' },
+              },
+            },
             attachment: {
               type: 'object',
-              additionalProperties: false,
+              additionalProperties: true,
               properties: {
                 attachmentId: { type: 'string' },
                 mediaType: { type: 'string' },
@@ -201,7 +218,7 @@ export function registerGenerationTools(ctx, deps) {
               type: 'array',
               items: {
                 type: 'object',
-                additionalProperties: false,
+                additionalProperties: true,
                 properties: {
                   path: { type: 'string' },
                   url: { type: 'string' },
@@ -209,7 +226,26 @@ export function registerGenerationTools(ctx, deps) {
                   height: { type: 'integer' },
                   seed: { type: 'integer' },
                   prompt: { type: 'string' },
+                  originalPrompt: { type: 'string' },
                   format: { type: 'string' },
+                  cost: { type: 'number' },
+                  fromCache: { type: 'boolean' },
+                  qualityReport: { type: 'object', additionalProperties: true },
+                  _fallback: { type: 'string' },
+                  provider: { type: 'string' },
+                  model: { type: 'string' },
+                  attachment: {
+                    type: 'object',
+                    additionalProperties: true,
+                    properties: {
+                      attachmentId: { type: 'string' },
+                      mediaType: { type: 'string' },
+                      bytes: { type: 'integer' },
+                      width: { type: 'integer' },
+                      height: { type: 'integer' },
+                      name: { type: 'string' },
+                    },
+                  },
                 },
               },
             },

package/lib/tools/inspect.js

@@ -22,7 +22,7 @@ export function registerInspectTools(ctx, deps) {
           render: (_args, value) => renderToolOutput(value),
           schema: {
             type: 'object',
-            additionalProperties: false,
+            additionalProperties: true,
             properties: {
               diffRatio: { type: 'number' },
               error: { type: 'string' },
@@ -50,7 +50,7 @@ export function registerInspectTools(ctx, deps) {
           render: (_args, value) => renderToolOutput(value),
           schema: {
             type: 'object',
-            additionalProperties: false,
+            additionalProperties: true,
             properties: {
               qualityScore: { type: 'number' },
               passed: { type: 'boolean' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodandready/dsh-image-gen",
-  "version": "0.11.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).",
+  "version": "0.11.10",
+  "description": "Image generation for DeepSeek Harness: a generate_image tool with pluggable providers \u2014 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",
     "dsh",