@goodandready/dsh-image-gen 0.11.26 → 0.11.27

package/lib/attachment-helper.js

@@ -112,3 +112,28 @@ export function renderToolOutput(value) {
   }
   return blocks
 }
+
+export function buildPresentationMeta(value) {
+  if (!value || typeof value !== 'object') return null
+  const meta = {
+    url: value.url,
+    path: value.path,
+    width: value.width,
+    height: value.height,
+    seed: value.seed,
+    prompt: value.prompt,
+    provider: value.provider,
+    model: value.model,
+    attachment: value.attachment,
+    attachmentId: value.attachment?.attachmentId || value.attachmentId,
+  }
+  if (value.images) meta.images = value.images
+  if (value.cells) meta.cells = value.cells
+  if (value.base_prompt) meta.base_prompt = value.base_prompt
+  if (value.blind_mode !== undefined) meta.blind_mode = value.blind_mode
+  if (value.light) meta.light = value.light
+  if (value.dark) meta.dark = value.dark
+  if (value.html_snippet) meta.html_snippet = value.html_snippet
+  if (value.css_snippet) meta.css_snippet = value.css_snippet
+  return meta
+}

package/lib/client.js

@@ -145,11 +145,15 @@ window.__ModuleLoader__.load({
 .ig-progress-meta{display:flex;justify-content:space-between;align-items:center;font-size:11px;color:var(--dsw-alias-label-secondary);font-weight:500}
 .ig-progress-track{height:6px;width:100%;background:var(--dsw-alias-bg-layer-1);border-radius:3px;overflow:hidden;position:relative}
 .ig-progress-fill{height:100%;background:var(--dsw-alias-state-brand);border-radius:3px;transition:width 0.25s ease-in-out}
+.ig-progress-indeterminate{width:40%;animation:ig-indeterminate-slide 1.5s infinite ease-in-out}
+@keyframes ig-indeterminate-slide{0%{transform:translateX(-100%)}50%{transform:translateX(150%)}100%{transform:translateX(300%)}}
 
 .ig-draft-overlay{position:absolute;bottom:8px;left:8px;padding:3px 8px;border-radius:4px;background:color-mix(in srgb, var(--dsw-alias-bg-layer-1) 80%, transparent);font-size:11px;font-weight:600;color:var(--dsw-alias-label-primary);display:flex;align-items:center;gap:6px;backdrop-filter:blur(4px)}
 
 @media (prefers-reduced-motion: reduce){
   .ig-draft-img,.ig-final-img{transition:none !important}
+  .ig-progress-fill{transition:none !important;animation:none !important}
+  .ig-progress-indeterminate{animation:none !important;width:100%;opacity:0.6}
 }
 
 /* Asset Vault & Studio (#158, #159) */
@@ -1369,17 +1373,53 @@ window.__ModuleLoader__.load({
     }
 
     // -------------------------------------------------------------- Toolview Component
-    const IMAGE_URL_RE = /https?:\/\/[^\s)]+\.(png|jpg|jpeg|webp|gif)(\?[^\s)]*)?/i
+    const HTTP_IMAGE_URL_RE = /https?:\/\/[^\s)]+\.(png|jpg|jpeg|webp|gif)(\?[^\s)]*)?/i
+    const RELATIVE_IMAGE_URL_RE = /(\/dsh-image-gen\/image\?[^\s)"'<>]+)/i
+    const MARKDOWN_IMAGE_RE = /!\[.*?\]\(((\/|https?:\/\/)[^\s)]+)\)/i
+    const MARKDOWN_LINK_RE = /\[.*?\]\(((\/|https?:\/\/)[^\s)]+)\)/i
 
     function readResult(block) {
       if (!block) return { text: '', url: '', attachment: null }
       const text = block.output || block.text || ''
-      const attachment = block.attachment || (block.attachments && block.attachments[0]) || null
-      const linked = text.match(IMAGE_URL_RE)
+      const meta = block.presentationMeta || block.meta || block.data || block.result || null
+
+      let attachment = block.attachment
+        || (Array.isArray(block.attachments) && block.attachments[0])
+        || meta?.attachment
+        || null
+
+      let url = meta?.url || block.url || ''
+
+      if (!url && attachment) {
+        url = attachmentImageUrl(attachment)
+      }
+
+      let cleanText = text
+      if (!url && text) {
+        const mdImg = text.match(MARKDOWN_IMAGE_RE)
+        const relUrl = text.match(RELATIVE_IMAGE_URL_RE)
+        const httpUrl = text.match(HTTP_IMAGE_URL_RE)
+        const mdLink = text.match(MARKDOWN_LINK_RE)
+
+        if (mdImg) {
+          url = mdImg[1]
+          cleanText = text.replace(mdImg[0], '').trim()
+        } else if (relUrl) {
+          url = relUrl[1]
+          cleanText = text.replace(relUrl[0], '').trim()
+        } else if (httpUrl) {
+          url = httpUrl[0]
+          cleanText = text.replace(httpUrl[0], '').trim()
+        } else if (mdLink) {
+          url = mdLink[1]
+          cleanText = text.replace(mdLink[0], '').trim()
+        }
+      }
+
       return {
         attachment,
-        url: linked ? linked[0] : '',
-        text: linked ? text.replace(linked[0], '').trim() : text,
+        url,
+        text: cleanText,
       }
     }
 
@@ -1586,6 +1626,7 @@ window.__ModuleLoader__.load({
         const draftSrc = block && (block.draftUrl || block.previewUrl || '')
         body.push(react.createElement(ProgressiveImagePreview, {
           key: 'prog-img',
+          callId: block && (block.id || block.callId || block.toolCallId || ''),
           src: displaySrc,
           draftSrc,
           isRunning: running,
@@ -1694,8 +1735,9 @@ window.__ModuleLoader__.load({
         react,
         t,
         parsed,
-        imgUrl: parsed.imageUrl || parsed.url || parsed.attachment?.url,
-        targetRef: parsed.attachmentId || parsed.attachment?.attachmentId || parsed.imageUrl || parsed.url,
+        imgUrl: parsed.url || (parsed.attachment ? attachmentImageUrl(parsed.attachment) : ''),
+        targetRef: (parsed.attachment && (parsed.attachment.attachmentId || parsed.attachment.id)) || parsed.url || 'latest',
+        sendActionPrompt,
         onClose: () => setInpaintOpen(false),
       }) : null
 
@@ -1761,23 +1803,76 @@ window.__ModuleLoader__.load({
           current.seed !== undefined ? `seed: ${current.seed}` : (current.timestamp ? new Date(current.timestamp).toLocaleTimeString() : '')
         )
       )
-    }    // -------------------------------------------------------------- Progressive Draft & Live Progress Preview (#147, #329)
+    }    // -------------------------------------------------------------- Progressive Draft & Live Progress Preview (#147, #329, #379)
     function ProgressiveImagePreview(props) {
       const src = props.src
-      const draftSrc = props.draftSrc
       const isRunning = props.isRunning
-      const progress = typeof props.progress === 'number' ? Math.min(100, Math.max(0, props.progress)) : undefined
-      const step = props.step
-      const stage = props.stage || (progress !== undefined && progress < 100 ? 'Rendering...' : 'Complete')
+      const callId = props.callId
       const alt = props.alt || 'Generated image'
       const t = props.t || ((k) => k)
 
       const [loaded, setLoaded] = react.useState(false)
+      const [liveState, setLiveState] = react.useState({
+        progress: undefined,
+        step: undefined,
+        stage: undefined,
+        draftSrc: '',
+      })
 
       react.useEffect(() => {
         setLoaded(false)
       }, [src])
 
+      // Subscribe to live events transport when running and callId is present (#379)
+      react.useEffect(() => {
+        const EventSourceImpl = typeof window !== 'undefined' ? window.EventSource : undefined
+        if (!isRunning || !callId || !EventSourceImpl) {
+          return
+        }
+        let es
+        try {
+          es = new EventSourceImpl('/dsh-image-gen/live-events?callId=' + encodeURIComponent(callId))
+          es.onmessage = (e) => {
+            try {
+              const data = JSON.parse(e.data)
+              if (!data) return
+              setLiveState((prev) => ({
+                progress: typeof data.progress === 'number' ? Math.min(100, Math.max(0, data.progress)) : prev.progress,
+                step: data.step !== undefined ? data.step : prev.step,
+                stage: data.stage !== undefined ? data.stage : prev.stage,
+                draftSrc: data.draftUrl || prev.draftSrc,
+              }))
+            } catch (_err) {
+              // Ignore event parsing errors
+            }
+          }
+          es.onerror = () => {
+            // EventSource handles retries or terminates on close
+          }
+        } catch (_err) {
+          // Ignore EventSource creation errors
+        }
+
+        return () => {
+          if (es) {
+            try {
+              es.close()
+            } catch (_err) {
+              // Ignore EventSource close errors
+            }
+          }
+        }
+      }, [isRunning, callId])
+
+      const draftSrc = liveState.draftSrc || props.draftSrc
+      const progress = liveState.progress !== undefined
+        ? liveState.progress
+        : (typeof props.progress === 'number' ? Math.min(100, Math.max(0, props.progress)) : undefined)
+      const step = liveState.step !== undefined ? liveState.step : props.step
+      const stage = liveState.stage
+        || props.stage
+        || (progress !== undefined && progress < 100 ? (t('card.rendering') || 'Rendering...') : (isRunning ? (t('card.generating') || 'Generating...') : 'Complete'))
+
       const showProgress = isRunning || (progress !== undefined && progress < 100)
 
       const progressElement = showProgress ? react.createElement(
@@ -1793,8 +1888,8 @@ window.__ModuleLoader__.load({
           'div',
           { className: 'ig-progress-track' },
           react.createElement('div', {
-            className: 'ig-progress-fill',
-            style: { width: (progress !== undefined ? progress : 45) + '%' },
+            className: 'ig-progress-fill' + (progress === undefined ? ' ig-progress-indeterminate' : ''),
+            style: progress !== undefined ? { width: progress + '%' } : undefined,
           })
         )
       ) : null
@@ -1842,10 +1937,17 @@ window.__ModuleLoader__.load({
         progressElement
       )
     }
-// 105-inpaint-canvas.js — Interactive in-chat canvas drawing overlay for inpainting (#285, #301, #328).
+// 105-inpaint-canvas.js — Interactive in-chat canvas drawing overlay for inpainting (#285, #301, #328, #380).
+
+    function buildEditInstruction(opts) {
+      const p = (opts && opts.prompt ? opts.prompt.trim() : '') || 'inpaint masked region'
+      const img = (opts && opts.image) || 'latest'
+      const m = (opts && opts.mask) || ''
+      return 'Use edit_image with prompt: "' + p + '", image: "' + img + '", mask: "' + m + '"'
+    }
 
     function InpaintCanvas(props) {
-      const { imgUrl, targetRef, parsed, onClose, t } = props
+      const { imgUrl, targetRef, parsed, onClose, sendActionPrompt, t } = props
       const canvasRef = react.useRef(null)
       const isDrawingRef = react.useRef(false)
       const undoStackRef = react.useRef([])
@@ -1856,8 +1958,12 @@ window.__ModuleLoader__.load({
       const [inpaintPrompt, setInpaintPrompt] = react.useState('')
       const [canvasDims, setCanvasDims] = react.useState({ width: 512, height: 512, ratio: '1/1' })
 
-      const effectiveImgUrl = imgUrl || parsed?.imageUrl || parsed?.url || parsed?.attachment?.url || ''
-      const effectiveTargetRef = targetRef || parsed?.attachmentId || parsed?.attachment?.attachmentId || parsed?.imageUrl || parsed?.url || 'current image'
+      const effectiveImgUrl = imgUrl || (parsed?.attachment ? attachmentImageUrl(parsed.attachment) : (parsed?.url || ''))
+      const effectiveTargetRef = targetRef
+        || (parsed?.attachment && (parsed.attachment.attachmentId || parsed.attachment.id))
+        || parsed?.attachmentId
+        || parsed?.url
+        || 'latest'
 
       const initCanvas = react.useCallback(() => {
         const canvas = canvasRef.current
@@ -1877,11 +1983,8 @@ window.__ModuleLoader__.load({
         if (e.target && e.target.naturalWidth && e.target.naturalHeight) {
           const nw = e.target.naturalWidth
           const nh = e.target.naturalHeight
-          // Scale dimensions down to manageable working canvas size (max 768)
-          const scale = Math.min(1, 768 / Math.max(nw, nh))
-          const cw = Math.round(nw * scale)
-          const ch = Math.round(nh * scale)
-          setCanvasDims({ width: cw, height: ch, ratio: `${cw}/${ch}` })
+          // Preserve 1:1 intrinsic source dimensions for accurate mask generation (#380)
+          setCanvasDims({ width: nw, height: nh, ratio: `${nw}/${nh}` })
         }
       }
 
@@ -1889,11 +1992,12 @@ window.__ModuleLoader__.load({
         const rect = canvas.getBoundingClientRect()
         const clientX = e.touches ? e.touches[0].clientX : e.clientX
         const clientY = e.touches ? e.touches[0].clientY : e.clientY
-        const scaleX = canvas.width / rect.width
-        const scaleY = canvas.height / rect.height
+        const scaleX = canvas.width / (rect.width || canvas.width)
+        const scaleY = canvas.height / (rect.height || canvas.height)
         return {
           x: (clientX - rect.left) * scaleX,
           y: (clientY - rect.top) * scaleY,
+          scale: (scaleX + scaleY) / 2,
         }
       }
 
@@ -1905,16 +2009,17 @@ window.__ModuleLoader__.load({
         if (!ctx) return
         isDrawingRef.current = true
         const pos = getPos(e, canvas)
+        const actualBrush = brushSize * (pos.scale || 1)
         ctx.beginPath()
         ctx.moveTo(pos.x, pos.y)
-        ctx.lineWidth = brushSize
+        ctx.lineWidth = actualBrush
         ctx.lineCap = 'round'
         ctx.lineJoin = 'round'
         const color = toolMode === 'eraser' ? 'black' : 'white'
         ctx.strokeStyle = color
         ctx.fillStyle = color
 
-        ctx.arc(pos.x, pos.y, brushSize / 2, 0, Math.PI * 2)
+        ctx.arc(pos.x, pos.y, actualBrush / 2, 0, Math.PI * 2)
         ctx.fill()
         ctx.beginPath()
         ctx.moveTo(pos.x, pos.y)
@@ -1929,25 +2034,26 @@ window.__ModuleLoader__.load({
         const ctx = canvas.getContext('2d')
         if (!ctx) return
         const pos = getPos(e, canvas)
-        ctx.lineWidth = brushSize
+        const actualBrush = brushSize * (pos.scale || 1)
+        ctx.lineWidth = actualBrush
         ctx.lineCap = 'round'
         ctx.lineJoin = 'round'
         const color = toolMode === 'eraser' ? 'black' : 'white'
         ctx.strokeStyle = color
         ctx.lineTo(pos.x, pos.y)
         ctx.stroke()
-        setHasStrokes(true)
+        ctx.beginPath()
+        ctx.moveTo(pos.x, pos.y)
       }
 
-      function stopDraw(e) {
+      function stopDraw() {
         if (!isDrawingRef.current) return
         isDrawingRef.current = false
         const canvas = canvasRef.current
         if (!canvas) return
         const ctx = canvas.getContext('2d')
         if (!ctx) return
-        ctx.closePath()
-
+        ctx.beginPath()
         if (undoStackRef.current.length >= 15) {
           undoStackRef.current.shift()
         }
@@ -2000,7 +2106,15 @@ window.__ModuleLoader__.load({
         if (!canvas) return
         const maskDataUrl = canvas.toDataURL('image/png')
         const promptText = inpaintPrompt.trim() || 'inpaint masked region'
-        const instruction = 'Use edit_image with prompt: "' + promptText + '", source_image: "' + effectiveTargetRef + '", mask: "' + maskDataUrl + '"'
+        const instruction = buildEditInstruction({
+          prompt: promptText,
+          image: effectiveTargetRef,
+          mask: maskDataUrl,
+        })
+
+        if (typeof sendActionPrompt === 'function') {
+          sendActionPrompt(instruction)
+        }
 
         if (typeof navigator !== 'undefined' && navigator.clipboard) {
           navigator.clipboard.writeText(instruction)
@@ -2188,7 +2302,18 @@ window.__ModuleLoader__.load({
       const t = props.t || ((k) => k)
       const block = props.block || {}
       const parsed = react.useMemo(() => {
+        const meta = block.presentationMeta || block.meta || block.data || block.result
+        if (meta && Array.isArray(meta.cells) && meta.cells.length) {
+          return meta
+        }
         const raw = block.output || block.text || ''
+        const tagMatch = raw.match(/<dsh-image-gen-matrix>([\s\S]*?)<\/dsh-image-gen-matrix>/)
+        if (tagMatch) {
+          const fromTag = tryParseJsonObject(tagMatch[1])
+          if (fromTag && Array.isArray(fromTag.cells) && fromTag.cells.length) {
+            return fromTag
+          }
+        }
         const obj = tryParseJsonObject(raw)
         return obj || { base_prompt: '', blind_mode: false, cells: [] }
       }, [block])
@@ -2307,12 +2432,27 @@ window.__ModuleLoader__.load({
       let args = {}
       try { if (raw) args = JSON.parse(raw) } catch (_) { /* invalid json */ }
 
-      let data = {}
-      try {
-        const out = block && (block.output || block.result || block.text || '')
-        if (typeof out === 'object') data = out
-        else if (typeof out === 'string') data = JSON.parse(out)
-      } catch (_) { /* invalid json */ }
+      let data = block && (block.presentationMeta || block.meta || block.data || block.result)
+      if (!data || (!data.light && !data.dark)) {
+        const out = block && (block.output || block.text || '')
+        const tagMatch = typeof out === 'string' ? out.match(/<dsh-image-gen-theme-pair>([\s\S]*?)<\/dsh-image-gen-theme-pair>/) : null
+        if (tagMatch) {
+          try {
+            data = JSON.parse(tagMatch[1])
+          } catch (_err) {
+            // Malformed XML payload
+          }
+        }
+        if (!data || (!data.light && !data.dark)) {
+          try {
+            if (typeof out === 'object') data = out
+            else if (typeof out === 'string') data = JSON.parse(out)
+          } catch (_err) {
+            // Malformed fallback output
+          }
+        }
+      }
+      data = data || {}
 
       const light = data.light || {}
       const dark = data.dark || {}

package/lib/index.js

@@ -44,6 +44,7 @@ import { registerImageCommand } from './commands.js'
 import { registerAllTools } from './register-tools.js'
 import { registerPluginUpdater } from './updater.js'
 import { registerVaultRoutes } from './vault.js'
+import { registerLiveProgressRoutes } from './live-progress.js'
 import { registerSettingsRoutes } from './settings-route.js'
 import { clearAllAnchors } from './anchor-helpers.js'
 import { resetLoopGuard, getLoopGuardState } from './loop-guard.js'
@@ -418,6 +419,9 @@ export function apply(ctx, rawConfig) {
   // Vault route (#159)
   registerVaultRoutes(ctx)
 
+  // Live events route (#379)
+  registerLiveProgressRoutes(ctx)
+
   // Reset loop guard when user sends a new message (#370)
   if (typeof ctx.on === 'function') {
     ctx.on('chat/message', (session) => {

package/lib/live-progress.js

@@ -0,0 +1,278 @@
+// lib/live-progress.js — Live progress event hub & presentation transport (#147, #329, #379)
+
+import { isTrustedLocalRequest } from './security.js'
+
+const activeSessions = new Map()
+
+/**
+ * Creates or resets a live progress session for a tool call.
+ *
+ * @param {string} callId
+ * @param {{ signal?: AbortSignal, onProgress?: Function }} [options]
+ * @returns {object}
+ */
+export function createLiveProgressSession(callId, options = {}) {
+  if (!callId) return null
+  const existing = activeSessions.get(callId)
+  if (existing) {
+    existing.listeners.clear()
+  }
+
+  const session = {
+    callId,
+    stage: 'Starting...',
+    step: undefined,
+    progress: undefined,
+    draftUrl: undefined,
+    done: false,
+    error: undefined,
+    timestamp: Date.now(),
+    listeners: new Set(),
+  }
+
+  if (options.signal) {
+    options.signal.addEventListener(
+      'abort',
+      () => {
+        abortLiveProgress(callId, 'Execution aborted')
+      },
+      { once: true },
+    )
+  }
+
+  activeSessions.set(callId, session)
+  return session
+}
+
+/**
+ * Publishes an incremental update to a live progress session.
+ *
+ * @param {string} callId
+ * @param {{ stage?: string, step?: string, progress?: number, draftUrl?: string }} update
+ */
+export function publishLiveProgress(callId, update = {}) {
+  if (!callId) return
+  let session = activeSessions.get(callId)
+  if (!session) {
+    session = createLiveProgressSession(callId)
+  }
+  if (session.done) return
+
+  if (update.stage !== undefined) session.stage = update.stage
+  if (update.step !== undefined) session.step = update.step
+  if (update.progress !== undefined) {
+    session.progress = typeof update.progress === 'number'
+      ? Math.min(100, Math.max(0, Math.round(update.progress)))
+      : undefined
+  }
+  if (update.draftUrl !== undefined) session.draftUrl = update.draftUrl
+  session.timestamp = Date.now()
+
+  const payload = {
+    callId,
+    stage: session.stage,
+    step: session.step,
+    progress: session.progress,
+    draftUrl: session.draftUrl,
+    done: false,
+  }
+
+  for (const listener of session.listeners) {
+    try {
+      listener(payload)
+    } catch (_err) {
+      // Listener notification failure ignored
+    }
+  }
+}
+
+/**
+ * Marks a session as complete and notifies subscribers.
+ *
+ * @param {string} callId
+ * @param {object} [finalData]
+ */
+export function completeLiveProgress(callId, finalData = {}) {
+  if (!callId) return
+  const session = activeSessions.get(callId)
+  if (!session || session.done) return
+
+  session.done = true
+  session.stage = 'Complete'
+  session.progress = 100
+  session.timestamp = Date.now()
+
+  const payload = {
+    callId,
+    stage: 'Complete',
+    progress: 100,
+    draftUrl: session.draftUrl,
+    done: true,
+    ...finalData,
+  }
+
+  for (const listener of session.listeners) {
+    try {
+      listener(payload)
+    } catch (_err) {
+      // Listener notification failure ignored
+    }
+  }
+  session.listeners.clear()
+
+  // Retain briefly for trailing SSE disconnects, then purge
+  setTimeout(() => {
+    activeSessions.delete(callId)
+  }, 15000)
+}
+
+/**
+ * Marks a session as aborted or errored.
+ *
+ * @param {string} callId
+ * @param {string} [reason]
+ */
+export function abortLiveProgress(callId, reason = 'Cancelled') {
+  if (!callId) return
+  const session = activeSessions.get(callId)
+  if (!session || session.done) return
+
+  session.done = true
+  session.error = reason
+  session.timestamp = Date.now()
+
+  const payload = {
+    callId,
+    error: reason,
+    done: true,
+  }
+
+  for (const listener of session.listeners) {
+    try {
+      listener(payload)
+    } catch (_err) {
+      // Listener notification failure ignored
+    }
+  }
+  session.listeners.clear()
+
+  setTimeout(() => {
+    activeSessions.delete(callId)
+  }, 10000)
+}
+
+/**
+ * Returns current snapshot of a live progress session.
+ *
+ * @param {string} callId
+ * @returns {object|null}
+ */
+export function getLiveProgress(callId) {
+  if (!callId) return null
+  const session = activeSessions.get(callId)
+  if (!session) return null
+  return {
+    callId: session.callId,
+    stage: session.stage,
+    step: session.step,
+    progress: session.progress,
+    draftUrl: session.draftUrl,
+    done: session.done,
+    error: session.error,
+  }
+}
+
+/**
+ * Subscribes a listener to progress events for a callId.
+ * Calls listener with current state immediately if present.
+ *
+ * @param {string} callId
+ * @param {Function} listener
+ * @returns {Function} unsubscribe
+ */
+export function subscribeLiveProgress(callId, listener) {
+  if (!callId || typeof listener !== 'function') return () => {}
+  let session = activeSessions.get(callId)
+  if (!session) {
+    session = createLiveProgressSession(callId)
+  }
+
+  session.listeners.add(listener)
+
+  // Initial event replay
+  listener({
+    callId: session.callId,
+    stage: session.stage,
+    step: session.step,
+    progress: session.progress,
+    draftUrl: session.draftUrl,
+    done: session.done,
+    error: session.error,
+  })
+
+  return () => {
+    session.listeners.delete(listener)
+  }
+}
+
+/**
+ * Registers the /dsh-image-gen/live-events SSE route on DSH web server.
+ *
+ * @param {object} ctx cordis context
+ */
+export function registerLiveProgressRoutes(ctx) {
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-image-gen/live-events',
+    handler: async (req, res) => {
+      if (req.method !== 'GET' && req.method !== 'HEAD') {
+        res.writeHead(405, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ error: 'GET only' }))
+        return
+      }
+      if (!isTrustedLocalRequest(req)) {
+        res.writeHead(403, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ error: 'forbidden' }))
+        return
+      }
+
+      const u = new URL(req.url, 'http://localhost')
+      const callId = u.searchParams.get('callId') || ''
+      if (!callId) {
+        res.writeHead(400, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ error: 'callId query parameter required' }))
+        return
+      }
+
+      res.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache, no-transform',
+        'Connection': 'keep-alive',
+        'Access-Control-Allow-Origin': '*',
+      })
+
+      res.write(': connected\n\n')
+
+      const unsubscribe = subscribeLiveProgress(callId, (data) => {
+        try {
+          res.write(`data: ${JSON.stringify(data)}\n\n`)
+          if (data.done) {
+            setTimeout(() => {
+              try {
+                res.end()
+              } catch (_err) {
+                // Response end failure ignored
+              }
+            }, 300)
+          }
+        } catch (_err) {
+          // SSE write failure ignored
+        }
+      })
+
+      req.on('close', () => {
+        unsubscribe()
+      })
+    },
+  }), 'dsh-image-gen: live events route')
+}

package/lib/providers/backends/custom.js

@@ -1,6 +1,7 @@
 import {
   normalizeMediaType,
   buildEditForm,
+  normalizeMaskAlpha,
   SIZE_PIXELS,
   formatErrorMessage,
   buildEndpointUrl,
@@ -32,6 +33,11 @@ export function createCustomGenerator(deps, job) {
     if (key) headers.Authorization = `Bearer ${key}`
 
     // Omit response_format; modern models return either base64 or URL.
+    let effectiveMask = mask
+    if (isEdit && mask && mask.bytes) {
+      const normBytes = await normalizeMaskAlpha(mask.bytes)
+      effectiveMask = { ...mask, bytes: normBytes, mediaType: 'image/png' }
+    }
     const endpoint = buildEndpointUrl(base, isEdit ? 'images/edits' : 'images/generations')
     const res = await fetchImpl(endpoint, {
       method: 'POST',
@@ -40,7 +46,7 @@ export function createCustomGenerator(deps, job) {
         ? buildEditForm({
             model: cfg.customModel,
             source,
-            mask,
+            mask: effectiveMask,
             prompt: promptArg,
             size: cfg.customSize || (aspectPixels ? aspectPixels.join('x') : SIZE_PIXELS[size]) || size,
             strength,

package/lib/providers/backends/fal.js

@@ -9,11 +9,11 @@ import {
  * @param {fetchImpl: Function, resolveKey: Function, cfg: object} deps
  * @param {prompt?: string, size?: string, format?: string, seed?: number, signal?: AbortSignal,
  *   negativePrompt?: string, guidanceScale?: number, source?: object, mask?: object, strength?: number,
- *   quality?: string, style?: string, aspectPixels?: number[], aspectRatio?: string} job
+ *   quality?: string, style?: string, aspectPixels?: number[], aspectRatio?: string, onProgress?: Function, callId?: string} job
  */
 export function createFalGenerator(deps, job) {
   const { fetchImpl, resolveKey, cfg } = deps
-  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality, style, aspectPixels, aspectRatio } = job
+  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality, style, aspectPixels, aspectRatio, onProgress } = job
 
   async function fal(seedArg = seed, promptArg = prompt) {
     const key = await resolveKey(cfg.apiKeyEnv)
@@ -36,9 +36,13 @@ export function createFalGenerator(deps, job) {
       }
     }
 
+    if (typeof onProgress === 'function') {
+      onProgress({ stage: 'Submitting job...', progress: undefined })
+    }
+
     const submit = await submitJob(fetchImpl, cfg.baseURL, targetModel, key, body, signal)
     const statusUrl = submit.status_url || `${cfg.baseURL}/${cfg.model}/requests/${submit.request_id}/status`
-    const statusBody = await pollStatus(fetchImpl, statusUrl, key, signal, cfg.pollIntervalMs, cfg.timeoutMs)
+    const statusBody = await pollStatus(fetchImpl, statusUrl, key, signal, cfg.pollIntervalMs, cfg.timeoutMs, onProgress)
 
     const resultRes = await fetchImpl(statusBody.response_url, {
       headers: { Authorization: falAuthHeader(key) },

package/lib/providers/backends/local.js

@@ -10,15 +10,24 @@ import {
   buildDefaultComfyWorkflow,
 } from '../../comfy-workflow-helpers.js'
 
+function resolveWebSocket() {
+  if (typeof window !== 'undefined' && window.WebSocket) return window.WebSocket
+  try {
+    return (new Function('return typeof WebSocket !== "undefined" ? WebSocket : undefined'))()
+  } catch (_) {
+    return undefined
+  }
+}
+
 /**
  * @param {fetchImpl: Function, resolveKey: Function, cfg: object} deps
  * @param {prompt?: string, size?: string, format?: string, seed?: number, signal?: AbortSignal,
  *   negativePrompt?: string, guidanceScale?: number, source?: object, mask?: object, strength?: number,
- *   quality?: string, style?: string, aspectPixels?: number[], aspectRatio?: string} job
+ *   quality?: string, style?: string, aspectPixels?: number[], aspectRatio?: string, onProgress?: Function, callId?: string} job
  */
 export function createLocalGenerator(deps, job) {
   const { fetchImpl, resolveKey, cfg } = deps
-  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality, style, aspectPixels, aspectRatio } = job
+  const { prompt, size, format, seed, signal, negativePrompt, guidanceScale, source, mask, strength, quality, style, aspectPixels, aspectRatio, onProgress } = job
 
   async function local(seedArg = seed, promptArg = prompt) {
     const base = String(cfg.localBaseURL || '').replace(/\/+$/, '')
@@ -34,6 +43,9 @@ export function createLocalGenerator(deps, job) {
     }
 
     if (kind === 'a1111') {
+      if (typeof onProgress === 'function') {
+        onProgress({ stage: 'Generating...', progress: undefined })
+      }
       const isImg2Img = Boolean(source && source.bytes)
       const endpoint = `${base}${isImg2Img ? '/sdapi/v1/img2img' : '/sdapi/v1/txt2img'}`
       const body = {
@@ -114,61 +126,138 @@ export function createLocalGenerator(deps, job) {
       }
     }
 
-    const submit = await fetchImpl(`${base}/prompt`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ prompt: workflowGraph, client_id: promptId }),
-      signal,
-    })
-    if (!submit.ok) {
-      throw new Error(`Local ComfyUI submit failed (HTTP ${submit.status}): ${String(await submit.text().catch(() => '')).slice(0, 300)}`)
+    let ws
+    let wsClosed = false
+    const closeWs = () => {
+      if (!wsClosed && ws) {
+        wsClosed = true
+        try {
+          ws.close()
+        } catch (_err) {
+          // Socket close failure ignored
+        }
+      }
     }
-    const submitData = await submit.json().catch(() => ({}))
-    const pid = submitData.prompt_id
-    if (!pid) throw new Error('Local ComfyUI did not return a prompt_id')
 
-    const deadline = Date.now() + cfg.timeoutMs
-    let attempt = 0
-    for (;;) {
-      if (signal?.aborted) throw new Error('Local ComfyUI generation cancelled')
-      if (Date.now() > deadline) throw new Error(`Local ComfyUI timed out after ${cfg.timeoutMs} ms`)
-      if (attempt > 0) {
-        const cDelay = calculateBackoff(attempt - 1, cfg.pollIntervalMs || 1000, 5000)
-        await new Promise((resolve) => {
-          const timer = setTimeout(resolve, cDelay)
+    try {
+      const WebSocketClass = resolveWebSocket()
+      if (WebSocketClass) {
+        const wsUrl = `${base.replace(/^http/, 'ws')}/ws?clientId=${encodeURIComponent(promptId)}`
+        try {
+          ws = new WebSocketClass(wsUrl)
           if (signal) {
-            signal.addEventListener('abort', () => { clearTimeout(timer); resolve() }, { once: true })
+            signal.addEventListener('abort', closeWs, { once: true })
           }
-        })
-      }
-      attempt++
-      const hist = await fetchImpl(`${base}/history/${pid}`, { signal })
-      if (!hist.ok) continue
-      const histData = await hist.json().catch(() => ({}))
-      const entry = histData[pid]
-      if (entry) {
-        const comfyErr = extractComfyNodeErrors(entry)
-        if (comfyErr) {
-          throw new Error(`Local ComfyUI execution failed: ${comfyErr}`)
+          ws.onmessage = (event) => {
+            if (wsClosed) return
+            try {
+              if (typeof event.data === 'string') {
+                const msg = JSON.parse(event.data)
+                if (msg.type === 'progress') {
+                  const { value, max } = msg.data || {}
+                  const progress = (max > 0) ? Math.min(100, Math.max(0, Math.round((value / max) * 100))) : undefined
+                  if (typeof onProgress === 'function') {
+                    onProgress({ stage: 'Rendering...', step: `${value}/${max}`, progress })
+                  }
+                } else if (msg.type === 'executing') {
+                  const node = msg.data?.node
+                  if (typeof onProgress === 'function') {
+                    onProgress({ stage: node ? `Executing node ${node}` : 'Finishing...' })
+                  }
+                } else if (msg.type === 'status') {
+                  const q = msg.data?.status?.exec_info?.queue_remaining
+                  if (q !== undefined && q > 0 && typeof onProgress === 'function') {
+                    onProgress({ stage: `In queue (${q} remaining)` })
+                  }
+                }
+              } else if (event.data) {
+                const rawBuf = Buffer.isBuffer(event.data) ? event.data : Buffer.from(event.data)
+                let imgBuf = rawBuf
+                if (rawBuf.length > 8 && (rawBuf[0] === 0 || rawBuf[0] === 1 || rawBuf[0] === 2)) {
+                  imgBuf = rawBuf.subarray(8)
+                }
+                if (imgBuf.length > 4) {
+                  const isPng = imgBuf[0] === 0x89 && imgBuf[1] === 0x50
+                  const mime = isPng ? 'image/png' : 'image/jpeg'
+                  const draftUrl = `data:${mime};base64,${imgBuf.toString('base64')}`
+                  if (typeof onProgress === 'function') {
+                    onProgress({ draftUrl })
+                  }
+                }
+              }
+            } catch (_err) {
+              // Frame parse failure ignored
+            }
+          }
+          ws.onerror = () => {}
+          ws.onclose = () => {}
+        } catch (_err) {
+          // Websocket handshake failure ignored
         }
       }
-      if (entry && entry.outputs) {
-        const outputs = entry.outputs
-        const img = Object.values(outputs).flatMap((o) => o.images || []).find((i) => i && i.filename)
-        if (img) {
-          const dl = await fetchImpl(`${base}/view?filename=${encodeURIComponent(img.filename)}&subfolder=${encodeURIComponent(img.subfolder || '')}&type=${encodeURIComponent(img.type || 'output')}`, { signal })
-          if (!dl.ok) throw new Error(`Local ComfyUI download failed (HTTP ${dl.status})`)
-          return {
-            bytes: Buffer.from(await dl.arrayBuffer()),
-            mediaType: normalizeMediaType('image/png', format),
-            width,
-            height,
-            seed: seedArg ?? 0,
-            sourceUrl: '',
+
+      if (typeof onProgress === 'function') {
+        onProgress({ stage: 'Submitting prompt...', progress: undefined })
+      }
+
+      const submit = await fetchImpl(`${base}/prompt`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ prompt: workflowGraph, client_id: promptId }),
+        signal,
+      })
+      if (!submit.ok) {
+        throw new Error(`Local ComfyUI submit failed (HTTP ${submit.status}): ${String(await submit.text().catch(() => '')).slice(0, 300)}`)
+      }
+      const submitData = await submit.json().catch(() => ({}))
+      const pid = submitData.prompt_id
+      if (!pid) throw new Error('Local ComfyUI did not return a prompt_id')
+
+      const deadline = Date.now() + cfg.timeoutMs
+      let attempt = 0
+      for (;;) {
+        if (signal?.aborted) throw new Error('Local ComfyUI generation cancelled')
+        if (Date.now() > deadline) throw new Error(`Local ComfyUI timed out after ${cfg.timeoutMs} ms`)
+        if (attempt > 0) {
+          const cDelay = calculateBackoff(attempt - 1, cfg.pollIntervalMs || 1000, 5000)
+          await new Promise((resolve) => {
+            const timer = setTimeout(resolve, cDelay)
+            if (signal) {
+              signal.addEventListener('abort', () => { clearTimeout(timer); resolve() }, { once: true })
+            }
+          })
+        }
+        attempt++
+        const hist = await fetchImpl(`${base}/history/${pid}`, { signal })
+        if (!hist.ok) continue
+        const histData = await hist.json().catch(() => ({}))
+        const entry = histData[pid]
+        if (entry) {
+          const comfyErr = extractComfyNodeErrors(entry)
+          if (comfyErr) {
+            throw new Error(`Local ComfyUI execution failed: ${comfyErr}`)
+          }
+        }
+        if (entry && entry.outputs) {
+          const outputs = entry.outputs
+          const img = Object.values(outputs).flatMap((o) => o.images || []).find((i) => i && i.filename)
+          if (img) {
+            const dl = await fetchImpl(`${base}/view?filename=${encodeURIComponent(img.filename)}&subfolder=${encodeURIComponent(img.subfolder || '')}&type=${encodeURIComponent(img.type || 'output')}`, { signal })
+            if (!dl.ok) throw new Error(`Local ComfyUI download failed (HTTP ${dl.status})`)
+            return {
+              bytes: Buffer.from(await dl.arrayBuffer()),
+              mediaType: normalizeMediaType('image/png', format),
+              width,
+              height,
+              seed: seedArg ?? 0,
+              sourceUrl: '',
+            }
           }
         }
       }
+    } finally {
+      closeWs()
     }
   }
   return local
-}
+}

package/lib/providers/shared-helpers.js

@@ -115,7 +115,7 @@ export async function submitJob(fetchImpl, baseURL, model, key, body, signal) {
   return data
 }
 
-export async function pollStatus(fetchImpl, statusUrl, key, signal, pollIntervalMs = 500, timeoutMs = 180000) {
+export async function pollStatus(fetchImpl, statusUrl, key, signal, pollIntervalMs = 500, timeoutMs = 180000, onProgress) {
   const deadline = Date.now() + timeoutMs
   let attempt = 0
   for (;;) {
@@ -138,6 +138,21 @@ export async function pollStatus(fetchImpl, statusUrl, key, signal, pollInterval
     const res = await fetchImpl(statusUrl, { headers: { Authorization: falAuthHeader(key) }, signal })
     const data = await res.json().catch(() => ({}))
     const status = data.status
+    if (typeof onProgress === 'function') {
+      if (status === 'IN_QUEUE') {
+        const pos = data.queue_position
+        onProgress({
+          stage: pos !== undefined ? `In queue (#${pos})` : 'In queue',
+          progress: undefined, // honest status: do NOT simulate fake percentage
+        })
+      } else if (status === 'IN_PROGRESS') {
+        const rawProg = typeof data.progress === 'number' ? Math.round(data.progress * 100) : undefined
+        onProgress({
+          stage: 'Generating...',
+          progress: rawProg,
+        })
+      }
+    }
     if (status === 'COMPLETED') return data
     if (status === 'ERROR' || data.error || data.detail) {
       throw new Error(`FAL generation failed: ${JSON.stringify(data).slice(0, 600)}`)
@@ -148,6 +163,53 @@ export async function pollStatus(fetchImpl, statusUrl, key, signal, pollInterval
   }
 }
 
+/**
+ * Normalizes mask bytes for OpenAI/Custom inpainting where transparent alpha (0) indicates edit region.
+ * If the incoming mask has an alpha channel with transparent areas, it is preserved.
+ * If the incoming mask is opaque black & white (e.g. from Canvas), white pixels are converted to transparent (alpha 0)
+ * and black pixels to opaque (alpha 255).
+ *
+ * @param {Buffer|Uint8Array} maskBytes
+ * @returns {Promise<Buffer>}
+ */
+export async function normalizeMaskAlpha(maskBytes) {
+  if (!maskBytes || maskBytes.length === 0) return maskBytes
+  try {
+    const img = sharp(maskBytes)
+    const { data, info } = await img.raw().ensureAlpha().toBuffer({ resolveWithObject: true })
+    const { width, height, channels } = info
+
+    let hasTransparency = false
+    for (let i = 3; i < data.length; i += channels) {
+      if (data[i] < 250) {
+        hasTransparency = true
+        break
+      }
+    }
+
+    if (hasTransparency) {
+      return await sharp(data, { raw: { width, height, channels } }).png().toBuffer()
+    }
+
+    const out = Buffer.from(data)
+    for (let i = 0; i < out.length; i += channels) {
+      const r = out[i]
+      const g = out[i + 1]
+      const b = out[i + 2]
+      const lum = 0.299 * r + 0.587 * g + 0.114 * b
+      if (lum > 128) {
+        out[i + 3] = 0
+      } else {
+        out[i + 3] = 255
+      }
+    }
+
+    return await sharp(out, { raw: { width, height, channels } }).png().toBuffer()
+  } catch (_) {
+    return maskBytes
+  }
+}
+
 export function buildEditForm({ source, mask, prompt, size, strength, model }) {
   const form = new FormData()
   if (model) form.append('model', model)

package/lib/register-tools.js

@@ -19,6 +19,12 @@ import { registerThemePairTools } from './tools/theme-pair.js'
 import { registerCharacterSheetTools } from './tools/character-sheet.js'
 import { registerVisionOcrTools } from './tools/vision-ocr.js'
 import { registerDiagramTools } from './tools/diagram.js'
+import {
+  createLiveProgressSession,
+  publishLiveProgress,
+  completeLiveProgress,
+  abortLiveProgress,
+} from './live-progress.js'
 
 /**
  * Registers every image-gen tool on the host tools service according to toolsetProfile (#337, #384).
@@ -43,7 +49,19 @@ export function registerAllTools(ctx, deps) {
             if (currentCfg && currentCfg.enabled === false) {
               throw new Error('Image generation is disabled in settings (dsh-image-gen.enabled is false); enable it in Settings → Image generation.')
             }
-            return originalExecute(args, exec)
+            const callId = exec?.callId || exec?.rootCallId
+            if (callId) {
+              createLiveProgressSession(callId, { signal: exec.signal })
+              exec.onProgress = (update) => publishLiveProgress(callId, update)
+            }
+            try {
+              const res = await originalExecute(args, exec)
+              if (callId) completeLiveProgress(callId)
+              return res
+            } catch (err) {
+              if (callId) abortLiveProgress(callId, err.message)
+              throw err
+            }
           },
         }
         const res = originalToolsRegister(wrappedDef)

package/lib/tools/editing.js

@@ -98,6 +98,21 @@ export function registerEditingTools(ctx, deps, options = {}) {
             const source = await resolveConversationImage(ctx, exec, args.image)
           const maskRef = args.mask_image || args.mask
           const mask = maskRef ? await resolveSource(ctx, exec, maskRef) : undefined
+          if (mask && mask.bytes && source && source.bytes) {
+            try {
+              const sharpMod = await import('sharp')
+              const sharp = sharpMod.default || sharpMod
+              const srcMeta = await sharp(source.bytes).metadata()
+              const maskMeta = await sharp(mask.bytes).metadata()
+              if (srcMeta.width && srcMeta.height && (maskMeta.width !== srcMeta.width || maskMeta.height !== srcMeta.height)) {
+                const resized = await sharp(mask.bytes).resize(srcMeta.width, srcMeta.height, { fit: 'fill' }).png().toBuffer()
+                mask.bytes = resized
+                mask.mediaType = 'image/png'
+              }
+            } catch (_err) {
+              // Mask dimension normalization failure ignored
+            }
+          }
           const vision = await analyzeImageWithVision(ctx, exec, source)
 
           let effectivePrompt = args.prompt
@@ -127,6 +142,8 @@ export function registerEditingTools(ctx, deps, options = {}) {
             strength,
             provider,
             signal: exec?.signal,
+            onProgress: exec?.onProgress,
+            callId: exec?.callId,
           }
 
           const gen = await editImageDirect(deps, job)

package/lib/tools/generation.js

@@ -1,3 +1,4 @@
+import { buildPresentationMeta } from '../attachment-helper.js'
 import { registerGenerationPackTool } from './generation-pack.js'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import path from 'node:path'
@@ -282,12 +283,16 @@ export function registerGenerationTools(ctx, deps, options = {}) {
           const summary = lines.join('\n')
           if (live().deliverAs !== 'image') {
             const urls = list.map((img) => img.url).filter(Boolean)
-            return [{ type: 'text', text: urls.length ? `${summary}\n${urls.join('\n')}` : summary }]
+            const mdLinks = list.map((img) => `![Generated Image](${img.url})`).join('\n')
+            return [{ type: 'text', text: urls.length ? `${summary}\n${mdLinks}` : summary }]
           }
           const blocks = [{ type: 'text', text: summary }]
           for (const img of list) if (img.attachment) blocks.push({ type: 'image', attachment: img.attachment })
           return blocks
         },
+        presentationMeta(args, value) {
+          return buildPresentationMeta(value)
+        },
       },
       isConcurrencySafe: () => false,
       timeoutMs: (config?.timeoutMs || 180000) + 30000,
@@ -334,7 +339,7 @@ export function registerGenerationTools(ctx, deps, options = {}) {
         assertBudgetAvailable(estimatedCost, cfg.dailyBudgetUsd)
         const providers = makeProviders(
           { fetchImpl: fetch, resolveKey: (ref) => resolveApiKey(ctx, ref), cfg, subscriptionImages },
-          { prompt: effectivePrompt, size, format, seed: args.seed, signal: exec.signal, negativePrompt: effectiveNegative, guidanceScale: effectiveGuidance, source, mask, strength: args.strength, quality: args.quality, style: args.style, aspectPixels, aspectRatio: args.aspect_ratio, faceReference: resolvedFaceRef },
+          { prompt: effectivePrompt, size, format, seed: args.seed, signal: exec.signal, negativePrompt: effectiveNegative, guidanceScale: effectiveGuidance, source, mask, strength: args.strength, quality: args.quality, style: args.style, aspectPixels, aspectRatio: args.aspect_ratio, faceReference: resolvedFaceRef, onProgress: exec?.onProgress, callId: exec?.callId },
         )
         // Subscription providers return {ok:false, reason} instead of throwing:
         // rejection reaches the model as text. Without this guard,

package/lib/tools/style-matrix.js

@@ -107,7 +107,15 @@ export function registerStyleMatrixTools(ctx, deps) {
               blindMode: value.blind_mode,
               cells: value.cells || [],
             })
-            return [{ type: 'text', text: summary }]
+            const metaTag = `<dsh-image-gen-matrix>${JSON.stringify({ cells: value.cells, base_prompt: value.base_prompt, blind_mode: value.blind_mode })}</dsh-image-gen-matrix>`
+            return [{ type: 'text', text: `${summary}\n\n${metaTag}` }]
+          },
+          presentationMeta(args, value) {
+            return {
+              base_prompt: value.base_prompt,
+              blind_mode: value.blind_mode,
+              cells: value.cells || [],
+            }
           },
         },
         isConcurrencySafe: () => false,

package/lib/tools/theme-pair.js

@@ -99,7 +99,25 @@ export function registerThemePairTools(ctx, deps) {
             },
           },
           render(_args, value) {
-            return renderToolOutput(value)
+            const blocks = renderToolOutput(value)
+            const metaTag = `<dsh-image-gen-theme-pair>${JSON.stringify({
+              light: value.light,
+              dark: value.dark,
+              html_snippet: value.html_snippet,
+              css_snippet: value.css_snippet,
+            })}</dsh-image-gen-theme-pair>`
+            if (blocks[0] && blocks[0].type === 'text') {
+              blocks[0].text += `\n\n${metaTag}`
+            }
+            return blocks
+          },
+          presentationMeta(_args, value) {
+            return {
+              light: value.light,
+              dark: value.dark,
+              html_snippet: value.html_snippet,
+              css_snippet: value.css_snippet,
+            }
           },
         },
         isConcurrencySafe: () => false,

package/package.json

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