🚀 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

---

⚡ Overview

@goodandready/dsh-image-gen is a premier graphic generation and visual processing suite for DeepSeek Harness. It equips autonomous agents with an extensible set of tools for image generation, transformation, background removal, upscaling, vectorization, multi-reference blending, and quality inspection across 8 generative backends.

---

🛡️ Reliability, Performance & Quality (v0.10.0)

• Exponential Backoff with Jitter: Adaptive polling for FAL, Replicate, and ComfyUI queues protects against HTTP 429 rate limits.
• Error Classification in Fallback Cascade: Client-side errors (Content Policy, 400 Bad Request, NSFW) fail fast without wasting API credits on other providers.
• Deterministic Hash Caching: Exact matches of prompt, model, and seed return instantly from local storage with zero API expense.
• ComfyUI & Automatic1111 Drag-and-Drop: Metadata is packed into PNG Parameters chunks in standard format.
• Dimension Snapping: Automatic normalization to multiples of 64 guarantees VAE bucket compatibility.
• Enhanced Style Presets: Built-in styles include tailor-made negative prompts and optimal guidance scale settings.

---

🛠️ Complete Tools Reference

• generate_image: Generate images with pluggable providers, seeds, aspect ratios, and style presets.
• edit_image: Targeted inpainting and modification with automatic session reference resolution (#142, #144, #145).
• vary_image: Controlled variation generation preserving composition (#143, #144).
• remove_background: Extract subject with transparent PNG output (FAL BiRefNet / Rembg).
• upscale_image: 2x / 4x super-resolution with clarity reconstruction.
• vectorize_image: Convert raster graphics to clean scalable SVG vectors with palette quantization.
• blend_images: Multi-reference composition mixing.
• generate_image_pack: Simultaneous multi-aspect ratio rendering with graceful partial recovery.
• compare_images: Pixel-level visual difference ratio comparison.
• inspect_image_quality: Automated visual audit, Laplacian sharpness scoring, and defect detection.
• extract_design_tokens: Extract CSS Variables, Tailwind color palettes, and W3C Design Tokens from concept art (#172).
• image_to_css_gradient: Generate lightweight pure CSS Mesh / Radial / Linear gradients (< 1KB) from image colors (#174).
• check_image_contrast: Evaluate background luminance and WCAG 2.1 AA/AAA contrast for text with scrim suggestions (#175).
• optimize_vector_svg: Clean and sanitize SVG, normalize viewBox, and export ready-to-use React TSX components (#176).
• generate_pwa_icon_suite: Generate full PWA icon sets, HTML meta tags, and web app manifest.json (#190).

---

🚀 Updates in v0.10.4: Cordis Lifecycle, Full Settings GUI, and i18n

• Cordis Lifecycle (#136): wrapped all 7 tool registrations in ctx.effect for proper disposal on reload.
• Settings GUI Completeness (#137): exposed fields for Replicate, SeaDream, Gemini, Local ComfyUI/A1111, style presets, and LLM enhancer.
• Package Manifest (#138): declared kernel peerDependencies (host-webserver, settings, llm, system-prompt).
• React Cleanup (#139): removed dead state hooks from FalImageCard.
• Complete Localization (#140): eliminated hardcoded strings, wiring comprehensive dictionaries for en, ru, and zh.

🚀 What's New in v0.10.7 (#197)

• Robust Error Formatting: completely prevents [object Object] from appearing in provider refusal chains, extracting deep .message, .detail, and .error objects cleanly.
• Deduplicated Provider Prefixes: eliminates redundant codex: codex: ... prefixes.
• 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.14

• dsh-clinebot Unified Visual Overhaul (#210): Redesigned client settings card following the high-end dsh-clinebot unified design system. Added top quick stats row (.ig-grid-4, .ig-stat-box) showing active provider, default specs, safety/loop guard, and daily budget/cache status. Integrated status badges (.ig-badge-ok/warn/bad).
• 5 Categorized Settings Tabs: Settings fields organized into intuitive tabs: ⚙️ General, 🔌 Provider, ✨ Prompt & Styles, 🛡️ Safety & Budget, ⚡ Cache & Storage.
• Client ErrorBoundary Protection: Wrapped all settings forms and toolviews in an ErrorBoundary with retry capability, preventing any component render crash from affecting DSH core UI.
• Full Host Config ↔ Client Fields Synchronization: Synchronized all 40 config properties between Config schema in lib/index.js, staged FIELDS in lib/client.js, and localization dictionaries (en/ru). Exposes controls: qualityGate, dailyBudgetUsd, loopGuardLimit, diskCache, subscriptionQuality, cacheBySeed, cacheByPrompt.
• Complete Toolview Registration: Registered tool.call.toolview for all 8 visual tools (generate_image, edit_image, vary_image, blend_images, generate_image_pack, remove_background, upscale_image, vectorize_image).
• Safety, Budget & Loop Guard Hardening: Extended trackAndAssertLoopGuard, assertBudgetAvailable, and sanitizeErrorAndLogs error masking across edit_image, vary_image, blend_images, remove_background, and upscale_image. Added seedreamBaseURL support.

🚀 What's New in v0.10.13

• Plugin Settings Location (#208): Moved settings card exclusively into the standard Settings → Plugins → Plugin settings section (settings.plugin.item slot). Removed the legacy fallback to settings.section that previously caused duplicate entries in the top-level sidebar navigation.
• Deferred Slot Injection (registerSlotWhenReady): Implemented robust deferred injection via ctx.slots.inject ensuring the settings card safely mounts when the parent settings container is rendered, eliminating timing collisions at startup.

🚀 What's New in v0.10.12

• Fix Syntax Error (#208): Resolved variable redeclaration collision (const hPrompt) in checkCache within lib/index.js which could prevent plugin initialization on strict Node.js runtimes. Added automated syntax check across all source modules to test suite.

🚀 What's New in v0.10.11 (#165, #166, #167, #168, #169, #170)

• Negative Prompt Sanitizer (#165): Automatic defect filtering and deduplication for diffusion models (SDXL, ComfyUI, Seedream, Local) with style-conflict protection (preserves intentional grainy, vintage, or dark aesthetics).
• Automated Quality Gate & Silent Re-roll (#166): Heuristic variance and sharpness inspection combined with dsh-vision-bridge hook; performs silent re-rolls (up to 2 attempts) for blank, corrupted, or solid frames before returning results.
• Cost Metering & Daily Budget (#167): Full rate card pricing per provider and resolution, spend tracking in ~/.dsh/storages/dsh-image-gen-spend.json, dispatch to dsh-cost-meter, and hard daily budget enforcement via dailyBudgetUsd.
• Fail-Fast Loop Guard (#168): Session-scoped circuit breaker prevents runaway agent retry loops (default max 3 consecutive generations without user interaction).
• Secure Credential Masking (#169): Comprehensive masking of tokens in logs, URLs, and errors (Bearer sk-...abcd), with 0600 file permission enforcement.
• Content-Addressed Disk Cache (#170): Instant retrieval (<50ms, zero API cost) for identical requests by SHA-256 hash, with automated LRU disk eviction (500 MB limit) and force: true bypass.

🚀 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.
• replicate: FLUX and SDXL models via Replicate API.
• custom: OpenAI-compatible endpoint (DALL-E 3, SiliconFlow, Together AI, local gateways).
• codex: ChatGPT Plus/Pro subscription generation via dsh-subscriptions (OAuth).
• grok: Grok Imagine subscription generation via dsh-subscriptions (OAuth).
• local: Local ComfyUI workflow execution or Automatic1111 web API.
• seedream: ByteDance SeaDream generative API.
• gemini: Google Imagen 3 via GenAI API.

---

📦 Quick Installation

dsh plugin --profile web add @goodandready/dsh-image-gen

---

📄 License

MIT © GooDAnDReaDY