@cyber-dash-tech/revela 0.19.3 → 0.19.4

package/README.md

@@ -39,7 +39,7 @@ npm_config_cache=/tmp/revela-npm-cache bun run smoke:mcp-pack
 Install Revela through the Codex Git marketplace:
 
 ```bash
-codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.19.3
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.19.4
 codex plugin add revela@revela
 ```
 
@@ -121,7 +121,7 @@ Revela includes built-in deck designs. Design previews are generated from the bu
 
 To switch designs in Codex, ask:
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), use summit as the design.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), use summit as the design.
 
 In Codex, ask Revela to list or switch designs; the plugin uses the active design when making decks.
 
@@ -129,7 +129,7 @@ In Codex, ask Revela to list or switch designs; the plugin uses the active desig
 
 Domains add topic-specific communication guidance, such as consulting, product, or investor communication. Use them when you want Revela to adapt deck framing to a specific context.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), list available domains.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), list available domains.
 
 In Codex, ask Revela to list or switch domains; the active domain guides deck framing during init, research, and planning.
 
@@ -139,35 +139,35 @@ Use these prompts in Codex from the workspace that contains your source material
 
 1. Choose the narrative domain before authoring so Revela frames the audience, decision, risks, and objections for your context.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), use consulting as the domain.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), use consulting as the domain.
 
 2. Choose the deck design before rendering so generated artifacts use the intended visual language.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), use summit as the design.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), use summit as the design.
 
 3. Create a custom design when you want a different visual direction.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), create a new design named neon-finance with a crisp financial-dashboard style: dark surfaces, precise grids, and bright green accents.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), create a new design named neon-finance with a crisp financial-dashboard style: dark surfaces, precise grids, and bright green accents.
 
 Revela may ask for references or constraints, then creates a workspace draft with `DESIGN.md`, `design.css`, and any local `assets/**`. It generates a preview from the built-in page-template fixture plus that CSS so you can review cover, agenda, timelines, charts, tables, cards, and visual slots before installing. When it is ready, switch to it:
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), use neon-finance as the design.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), use neon-finance as the design.
 
 4. Initialize local material intake. Init scans, extracts, and reviews workspace sources; it does not create a Narrative Vault.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), help me init this workspace from the local materials.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), help me init this workspace from the local materials.
 
 5. Research source-linked deck inputs and save findings.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), research the public evidence and examples needed for this deck.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), research the public evidence and examples needed for this deck.
 
 6. Create or update the deck plan before generating HTML so slide order, chapter structure, source links, unresolved inputs, source limitations, and visual intent are explicit.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), create or update the deck plan before generating HTML.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), create or update the deck plan before generating HTML.
 
 7. Make an HTML deck from the current deck plan.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), make the deck from the current deck plan.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), make the deck from the current deck plan.
 
 8. Review and annotate the generated deck from the localhost website card after make-deck completes.
 
@@ -175,15 +175,15 @@ Revela serves the deck from `http://127.0.0.1:<port>/decks/<file>.html` so you c
 
 9. Export a PDF after deck QA passes.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), export the deck to PDF.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), export the deck to PDF.
 
 10. Export an editable PPTX after deck QA passes.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), export the deck to PPTX.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), export the deck to PPTX.
 
 11. Export per-slide PNG files after deck QA passes.
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md), export the deck to PNG.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md), export the deck to PNG.
 
 ## Annotate A Deck
 

package/README.zh-CN.md

@@ -39,7 +39,7 @@ npm_config_cache=/tmp/revela-npm-cache bun run smoke:mcp-pack
 通过 Codex Git marketplace 安装 Revela：
 
 ```bash
-codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.19.3
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.19.4
 codex plugin add revela@revela
 ```
 
@@ -121,7 +121,7 @@ Revela 内置多个 deck design。Design preview 由内置 page-template preview
 
 在 Codex 中切换 design，可以这样问：
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，use summit as design.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，use summit as design.
 
 在 Codex 中，可以直接让 Revela 列出或切换 design；生成 deck 时会使用 active design。
 
@@ -129,7 +129,7 @@ Revela 内置多个 deck design。Design preview 由内置 page-template preview
 
 Domain 提供特定场景的沟通 guidance，例如 consulting、product 或 investor communication。需要让 Revela 按具体沟通场景调整 deck framing 时使用。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，列出 available domains。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，列出 available domains。
 
 在 Codex 中，可以直接让 Revela 列出或切换 domain；active domain 会用于 init、research 和 deck planning 阶段的 framing。
 
@@ -139,35 +139,35 @@ Domain 提供特定场景的沟通 guidance，例如 consulting、product 或 in
 
 1. 先选择 domain，让 Revela 按你的沟通场景 framing 受众、决策、风险和潜在质疑。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，use consulting as domain.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，use consulting as domain.
 
 2. 再选择 design，让后续生成的 deck 使用指定视觉风格。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，use summit as design.
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，use summit as design.
 
 3. 如果需要不同的视觉方向，可以创建一个自定义 design。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，创建一个名为 neon-finance 的新 design：金融仪表盘风格，深色界面、精密网格、亮绿色重点色。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，创建一个名为 neon-finance 的新 design：金融仪表盘风格，深色界面、精密网格、亮绿色重点色。
 
 Revela 可能会继续询问参考图、风格约束或禁忌项，然后在 workspace draft 中创建 `DESIGN.md`、`design.css` 和需要的本地 `assets/**`。它会用内置 page-template fixture 加上这份 CSS 生成 preview，让你在 install 前先检查 cover、agenda、timeline、chart、table、card 和 visual slot。创建完成后再切换使用：
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，使用 neon-finance 作为 design。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，使用 neon-finance 作为 design。
 
 4. 初始化本地 material intake。Init 会扫描、抽取并审阅 workspace source；它不会创建 Narrative Vault。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，帮我 init 这个 workspace，先读本地材料。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，帮我 init 这个 workspace，先读本地材料。
 
 5. 针对 deck 所需输入做 research，并保存带来源的 findings。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，research 这个 deck 需要的公开证据、案例和 source。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，research 这个 deck 需要的公开证据、案例和 source。
 
 6. 先创建或更新 deck plan，明确 slide 顺序、章节结构、source links、unresolved inputs、source limitations 和 visual intent，再生成 HTML。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，生成 HTML 前先 create or update deck plan。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，生成 HTML 前先 create or update deck plan。
 
 7. 基于当前 deck plan 生成 HTML deck。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，基于当前 deck plan make deck。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，基于当前 deck plan make deck。
 
 8. make-deck 完成后，从 localhost website card 打开生成的 deck，并在 Codex Browser 中做 annotation 和定向修改。
 
@@ -175,15 +175,15 @@ Revela 会通过 `http://127.0.0.1:<port>/decks/<file>.html` 服务 deck，你
 
 9. QA 通过后导出 PDF。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，把 deck export 成 PDF。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，把 deck export 成 PDF。
 
 10. QA 通过后导出可编辑 PPTX。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，把 deck export 成 PPTX。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，把 deck export 成 PPTX。
 
 11. QA 通过后导出每页 PNG。
 
-> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.3/skills/revela/SKILL.md)，把 deck export 成 PNG。
+> [$revela:revela](/Users/mengdigao/.codex/plugins/cache/revela/revela/0.19.4/skills/revela/SKILL.md)，把 deck export 成 PNG。
 
 ## Annotate Deck
 

package/lib/browser/chrome.ts

@@ -1,5 +1,7 @@
 import puppeteer, { type Browser } from "puppeteer-core"
-import { existsSync } from "fs"
+import { existsSync, mkdtempSync, rmSync } from "fs"
+import { tmpdir } from "os"
+import { join } from "path"
 
 export const CHROME_PATHS = [
   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
@@ -10,13 +12,26 @@ export const CHROME_PATHS = [
   "/usr/bin/chromium",
 ]
 
+export const CHROME_PATH_ENV_VARS = ["REVELA_CHROME_PATH", "PUPPETEER_EXECUTABLE_PATH"] as const
+
 export function findChromePath(): string {
+  for (const envName of CHROME_PATH_ENV_VARS) {
+    const override = process.env[envName]?.trim()
+    if (!override) continue
+    if (existsSync(override)) return override
+    throw new Error(
+      `Chrome executable configured by ${envName} does not exist: ${override}\n` +
+      "Set REVELA_CHROME_PATH to a valid Chrome/Chromium binary, or unset the override to use auto-detection."
+    )
+  }
+
   for (const p of CHROME_PATHS) {
     if (existsSync(p)) return p
   }
   throw new Error(
     "Could not find a Chrome/Chromium installation.\n" +
-    "Tried:\n" + CHROME_PATHS.map((p) => `  ${p}`).join("\n")
+    "Tried:\n" + CHROME_PATHS.map((p) => `  ${p}`).join("\n") + "\n" +
+    "You can set REVELA_CHROME_PATH=/path/to/chromium or PUPPETEER_EXECUTABLE_PATH=/path/to/chrome."
   )
 }
 
@@ -26,23 +41,92 @@ export interface LaunchChromeOptions {
   allowFileAccess?: boolean
 }
 
+export function createChromeUserDataDir(): string {
+  return mkdtempSync(join(tmpdir(), "revela-chrome-"))
+}
+
+export function cleanupChromeUserDataDir(userDataDir: string): void {
+  rmSync(userDataDir, { recursive: true, force: true })
+}
+
+function withProfileCleanup(browser: Browser, userDataDir: string): Browser {
+  const originalClose = browser.close.bind(browser)
+  browser.close = async () => {
+    try {
+      await originalClose()
+    } finally {
+      try {
+        cleanupChromeUserDataDir(userDataDir)
+      } catch (error) {
+        console.warn(`Could not clean up Chrome profile ${userDataDir}: ${String(error)}`)
+      }
+    }
+  }
+  return browser
+}
+
+function formatLaunchError(error: unknown, executablePath: string, userDataDir: string): Error {
+  const message = error instanceof Error ? error.message : String(error)
+  return new Error(
+    "Failed to launch Chrome/Chromium for Revela browser-backed checks.\n" +
+    `Executable: ${executablePath}\n` +
+    `Platform: ${process.platform} ${process.arch}\n` +
+    `Temporary profile: ${userDataDir}\n` +
+    `REVELA_CHROME_PATH: ${process.env.REVELA_CHROME_PATH || "(unset)"}\n` +
+    `PUPPETEER_EXECUTABLE_PATH: ${process.env.PUPPETEER_EXECUTABLE_PATH || "(unset)"}\n` +
+    "If this happens in Codex/macOS, set REVELA_CHROME_PATH to a Chrome/Chromium binary that can run headless, " +
+    "or run browser-backed tests in an environment that allows Chrome to start.\n" +
+    `Original error: ${message}`
+  )
+}
+
 export async function launchChrome(options: LaunchChromeOptions = {}): Promise<Browser> {
   const width = options.width ?? 1920
   const height = options.height ?? 1080
+  const executablePath = findChromePath()
+  const userDataDir = createChromeUserDataDir()
   const args = [
     "--no-sandbox",
     "--disable-setuid-sandbox",
     "--disable-dev-shm-usage",
+    "--no-first-run",
+    "--no-default-browser-check",
+    "--disable-background-networking",
+    "--disable-background-timer-throttling",
+    "--disable-client-side-phishing-detection",
+    "--disable-component-update",
+    "--disable-default-apps",
+    "--disable-extensions",
+    "--disable-hang-monitor",
+    "--disable-popup-blocking",
+    "--disable-prompt-on-repost",
+    "--disable-sync",
+    "--disable-translate",
+    "--metrics-recording-only",
+    "--mute-audio",
+    "--safebrowsing-disable-auto-update",
+    "--disable-features=Translate,OptimizationHints,MediaRouter",
     `--window-size=${width},${height}`,
   ]
 
   if (options.allowFileAccess) {
-    args.splice(3, 0, "--allow-file-access-from-files")
+    args.push("--allow-file-access-from-files")
   }
 
-  return await puppeteer.launch({
-    executablePath: findChromePath(),
-    headless: true,
-    args,
-  })
+  try {
+    const browser = await puppeteer.launch({
+      executablePath,
+      headless: true,
+      userDataDir,
+      args,
+    })
+    return withProfileCleanup(browser, userDataDir)
+  } catch (error) {
+    try {
+      cleanupChromeUserDataDir(userDataDir)
+    } catch (cleanupError) {
+      console.warn(`Could not clean up Chrome profile ${userDataDir}: ${String(cleanupError)}`)
+    }
+    throw formatLaunchError(error, executablePath, userDataDir)
+  }
 }

package/lib/pdf/export.ts

@@ -187,6 +187,54 @@ async function toDataUrlFromRef(ref: string, baseDir: string): Promise<string |
   }
 }
 
+function withExportBaseHref(html: string, htmlFilePath: string): string {
+  const baseHref = pathToFileURL(`${dirname(resolve(htmlFilePath))}/`).href
+  const baseTag = `<base href="${baseHref}">`
+  if (/<base\b/i.test(html)) return html
+  if (/<head[^>]*>/i.test(html)) {
+    return html.replace(/<head([^>]*)>/i, `<head$1>\n${baseTag}`)
+  }
+  return `${baseTag}\n${html}`
+}
+
+async function prepareSlidesForExport(page: any): Promise<void> {
+  await page.evaluate((canvasWidth: number, canvasHeight: number) => {
+    document.documentElement.style.scrollSnapType = "none"
+    document.documentElement.style.overflow = "visible"
+    document.body.style.overflow = "visible"
+    document.body.style.margin = "0"
+
+    const style = document.createElement("style")
+    style.setAttribute("data-revela-export-style", "true")
+    style.textContent = `
+      html, body { scroll-snap-type: none !important; overflow: visible !important; }
+      .slide {
+        width: ${canvasWidth}px !important;
+        min-width: ${canvasWidth}px !important;
+        height: ${canvasHeight}px !important;
+        min-height: ${canvasHeight}px !important;
+        display: flex !important;
+        align-items: center !important;
+        justify-content: center !important;
+        overflow: hidden !important;
+        scroll-snap-align: none !important;
+      }
+      .slide-canvas {
+        width: ${canvasWidth}px !important;
+        height: ${canvasHeight}px !important;
+        transform: none !important;
+        transform-origin: center center !important;
+      }
+    `
+    document.head.appendChild(style)
+
+    document.querySelectorAll<HTMLElement>(".slide-canvas").forEach((canvas) => {
+      canvas.style.transform = "none"
+      canvas.style.transformOrigin = "center center"
+    })
+  }, CANVAS_W, CANVAS_H)
+}
+
 export async function inlineImageAssetsForPdf(htmlContent: string, htmlFilePath: string): Promise<string> {
   const baseDir = dirname(resolve(htmlFilePath))
   const refs = extractImageAssetRefsForPdf(htmlContent)
@@ -358,7 +406,7 @@ async function screenshotDeckSlides(htmlFilePath: string, label: "pdf" | "png"):
   try {
     const originalHtml = readFileSync(abs, "utf-8")
     const localizedHtml = await localizeExternalImages(originalHtml, tmpDir)
-    const patchedHtml = await inlineImageAssetsForPdf(localizedHtml, abs)
+    const patchedHtml = withExportBaseHref(await inlineImageAssetsForPdf(localizedHtml, abs), abs)
     tmpHtmlPath = join(tmpDir, "index.html")
     writeFileSync(tmpHtmlPath, patchedHtml, "utf-8")
   } catch (err) {
@@ -386,13 +434,7 @@ async function screenshotDeckSlides(htmlFilePath: string, label: "pdf" | "png"):
     // Wait for fonts (Google Fonts may still be external) and CSS animations to settle
     await new Promise((r) => setTimeout(r, 2000))
 
-    // Disable scroll-snap so offsetParent-based clip coords are accurate.
-    // Also ensure html/body are tall enough to contain all slides without clipping.
-    await page.evaluate(() => {
-      document.documentElement.style.scrollSnapType = "none"
-      document.documentElement.style.overflow = "visible"
-      document.body.style.overflow = "visible"
-    })
+    await prepareSlidesForExport(page)
 
     const slideCount: number = await page.evaluate(
       () => document.querySelectorAll(".slide").length
@@ -417,32 +459,16 @@ async function screenshotDeckSlides(htmlFilePath: string, label: "pdf" | "png"):
       // Wait for CSS transitions and JS rendering (ECharts animations, etc.)
       await new Promise((r) => setTimeout(r, 800))
 
-      // Compute screenshot target absolute position by walking the offsetParent chain.
-      // getBoundingClientRect() returns viewport-relative coords (always near 0,0) —
-      // unusable as screenshot clip coordinates without adding scrollY.
-      // offsetParent walk gives document-absolute coords that Puppeteer clip expects.
-      const clipRect = await page.evaluate((i: number) => {
-        const slide = document.querySelectorAll(".slide")[i] as HTMLElement | null
-        if (!slide) return null
-        const target = (slide.querySelector(".slide-canvas") as HTMLElement | null) ?? slide
-        let top = 0
-        let left = 0
-        let el: HTMLElement | null = target
-        while (el) {
-          top += el.offsetTop
-          left += el.offsetLeft
-          el = el.offsetParent as HTMLElement | null
-        }
-        return { x: left, y: top, width: target.offsetWidth, height: target.offsetHeight }
-      }, idx)
+      const target = await page.$(`.slide:nth-of-type(${idx + 1}) > .slide-canvas`)
+        ?? await page.$(`.slide:nth-of-type(${idx + 1})`)
+      const box = target ? await target.boundingBox() : null
 
-      if (clipRect && clipRect.width > 0 && clipRect.height > 0) {
-        const buf = await page.screenshot({ type: "png", clip: clipRect })
-        screenshots.push(buf as Buffer)
+      if (target && box && box.width > 0 && box.height > 0) {
+        const buf = await target.screenshot({ type: "png" })
+        screenshots.push(Buffer.from(buf as Uint8Array))
       } else {
-        // Fallback: screenshot full viewport
         const buf = await page.screenshot({ type: "png" })
-        screenshots.push(buf as Buffer)
+        screenshots.push(Buffer.from(buf as Uint8Array))
       }
     }
   } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.19.3",
+  "version": "0.19.4",
   "description": "Codex-first CLI/MCP workspace for trusted narrative artifacts from local sources, research, and evidence",
   "type": "module",
   "main": "./index.ts",

package/plugins/revela/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "revela",
-  "version": "0.19.3",
+  "version": "0.19.4",
   "description": "Use Revela in Codex to specify, research, plan, make, and export trusted narrative decision artifacts.",
   "author": {
     "name": "cyber-dash-tech",