@cyber-dash-tech/revela 0.5.0 → 0.6.0

package/README.md

@@ -114,7 +114,7 @@ Before the agent writes `decks/humanoid-robotics.html`, it must update `DECKS.js
 /revela review humanoid-robotics
 ```
 
-Export when needed:
+Export when needed, either manually or by asking the agent to export:
 
 ```text
 /revela pdf decks/humanoid-robotics.html
@@ -600,13 +600,17 @@ PDF export:
 /revela pdf decks/my-deck.html
 ```
 
+LLM tool equivalent: `revela-pdf` with `{ "file": "decks/my-deck.html" }`.
+
 Editable PPTX export:
 
 ```text
 /revela pptx decks/my-deck.html
 ```
 
-Both commands write output beside the source HTML deck.
+LLM tool equivalent: `revela-pptx` with `{ "file": "decks/my-deck.html" }`.
+
+Both commands and tools write output beside the source HTML deck. Use the tools when you want the agent to run export as part of the deck workflow instead of asking the user to invoke `/revela pdf` or `/revela pptx` manually.
 
 ---
 

package/README.zh-CN.md

@@ -113,7 +113,7 @@ Create a 6-slide HTML deck on humanoid robotics supply chains. Cite the main mar
 /revela review humanoid-robotics
 ```
 
-需要导出时：
+需要导出时，可以手动调用，也可以让 agent 直接导出：
 
 ```text
 /revela pdf decks/humanoid-robotics.html
@@ -565,13 +565,17 @@ PDF 导出：
 /revela pdf decks/my-deck.html
 ```
 
+对应的 LLM tool：`revela-pdf`，参数为 `{ "file": "decks/my-deck.html" }`。
+
 可编辑 PPTX 导出：
 
 ```text
 /revela pptx decks/my-deck.html
 ```
 
-两种导出都会把结果写到源 HTML deck 同目录。
+对应的 LLM tool：`revela-pptx`，参数为 `{ "file": "decks/my-deck.html" }`。
+
+命令和 tool 都会把结果写到源 HTML deck 同目录。如果希望 agent 在 deck 工作流中自动完成导出，可以让它调用 tool，而不需要用户手动执行 `/revela pdf` 或 `/revela pptx`。
 
 ---
 

package/lib/pdf/export.ts

@@ -57,6 +57,18 @@ const MIME_TO_EXT: Record<string, string> = {
   "image/avif": ".avif",
 }
 
+const IMAGE_EXTS = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg", ".avif", ".bmp"])
+const EXT_TO_MIME: Record<string, string> = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".avif": "image/avif",
+  ".bmp": "image/bmp",
+}
+
 // ── Helpers ──────────────────────────────────────────────────────────────────
 
 function findChromePath(): string {
@@ -149,6 +161,72 @@ async function localizeExternalImages(
   return patched
 }
 
+function isLocalImageRef(ref: string): boolean {
+  const pathPart = ref.split(/[?#]/)[0]
+  return IMAGE_EXTS.has(extname(pathPart).toLowerCase())
+}
+
+export function extractImageAssetRefsForPdf(htmlContent: string): string[] {
+  const assetRefPattern = /\bsrc\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))|url\(\s*(?:"([^"]*)"|'([^']*)'|([^\s)]+))\s*\)/g
+  const refs = new Set<string>()
+  let match: RegExpExecArray | null
+
+  while ((match = assetRefPattern.exec(htmlContent)) !== null) {
+    const ref = match.slice(1).find((value): value is string => value !== undefined)
+    if (ref) refs.add(ref.trim())
+  }
+
+  return Array.from(refs)
+}
+
+async function toDataUrlFromRef(ref: string, baseDir: string): Promise<string | null> {
+  if (!ref || ref.startsWith("data:") || ref.startsWith("blob:") || ref.startsWith("#")) {
+    return null
+  }
+
+  try {
+    if (ref.startsWith("http://") || ref.startsWith("https://") || ref.startsWith("//") || ref.startsWith("file://")) {
+      return null
+    }
+
+    let filePath: string | null = null
+    if (isLocalImageRef(ref)) {
+      filePath = resolve(baseDir, decodeURI(ref.split(/[?#]/)[0]))
+    }
+
+    if (!filePath || !existsSync(filePath)) return null
+    const ext = extname(filePath).toLowerCase()
+    const mime = EXT_TO_MIME[ext]
+    if (!mime) return null
+    const buf = readFileSync(filePath)
+    return `data:${mime};base64,${buf.toString("base64")}`
+  } catch {
+    return null
+  }
+}
+
+export async function inlineImageAssetsForPdf(htmlContent: string, htmlFilePath: string): Promise<string> {
+  const baseDir = dirname(resolve(htmlFilePath))
+  const refs = extractImageAssetRefsForPdf(htmlContent)
+
+  if (refs.length === 0) return htmlContent
+
+  const replacements = new Map<string, string>()
+  await Promise.allSettled(
+    refs.map(async (ref) => {
+      const dataUrl = await toDataUrlFromRef(ref, baseDir)
+      if (dataUrl) replacements.set(ref, dataUrl)
+    })
+  )
+
+  let patched = htmlContent
+  for (const [original, replacement] of replacements) {
+    const escaped = original.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+    patched = patched.replace(new RegExp(escaped, "g"), replacement)
+  }
+  return patched
+}
+
 // ── Main export ──────────────────────────────────────────────────────────────
 
 export interface ExportResult {
@@ -185,7 +263,8 @@ export async function exportToPdf(htmlFilePath: string): Promise<ExportResult> {
   let tmpHtmlPath: string
   try {
     const originalHtml = readFileSync(abs, "utf-8")
-    const patchedHtml = await localizeExternalImages(originalHtml, tmpDir)
+    const localizedHtml = await localizeExternalImages(originalHtml, tmpDir)
+    const patchedHtml = await inlineImageAssetsForPdf(localizedHtml, abs)
     tmpHtmlPath = join(tmpDir, "index.html")
     writeFileSync(tmpHtmlPath, patchedHtml, "utf-8")
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "OpenCode plugin that turns AI into an HTML slide deck generator",
   "type": "module",
   "main": "./index.ts",

package/plugin.ts

@@ -82,6 +82,8 @@ import researchSaveTool from "./tools/research-save"
 import workspaceScanTool from "./tools/workspace-scan"
 import extractDocumentMaterialsTool from "./tools/extract-document-materials"
 import qaTool from "./tools/qa"
+import pdfTool from "./tools/pdf"
+import pptxTool from "./tools/pptx"
 import { RESEARCH_PROMPT, RESEARCH_AGENT_SIGNATURE } from "./lib/agents/research-prompt"
 import { runQA, formatReport } from "./lib/qa"
 import { extractDesignClasses } from "./lib/design/designs"
@@ -331,6 +333,8 @@ const server: Plugin = (async (pluginCtx) => {
       "revela-workspace-scan": workspaceScanTool,
       "revela-extract-document-materials": extractDocumentMaterialsTool,
       "revela-qa": qaTool,
+      "revela-pdf": pdfTool,
+      "revela-pptx": pptxTool,
     },
 
     // ── chat.message: intercept @-referenced / pasted binary files ────────

package/tools/pdf.ts

@@ -0,0 +1,43 @@
+/**
+ * tools/pdf.ts
+ *
+ * revela-pdf — Export a Revela HTML slide deck to PDF.
+ */
+
+import { tool } from "@opencode-ai/plugin"
+import { existsSync } from "fs"
+import { resolve } from "path"
+import { exportToPdf } from "../lib/pdf/export"
+
+export default tool({
+  description:
+    "Export a Revela-generated HTML slide deck to PDF. " +
+    "Use this after the deck HTML has been written and layout QA has passed. " +
+    "Output is written beside the input file with the same basename and a .pdf extension.",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Path to the HTML slide file to export. " +
+        "Can be absolute or relative to the current working directory."
+      ),
+  },
+  async execute({ file }, { directory }) {
+    const filePath = resolve(directory || process.cwd(), file)
+
+    if (!existsSync(filePath)) {
+      return JSON.stringify({ ok: false, error: `File not found: ${filePath}` })
+    }
+
+    if (!/\.html?$/i.test(filePath)) {
+      return JSON.stringify({ ok: false, error: `File must be an HTML file: ${filePath}` })
+    }
+
+    try {
+      const result = await exportToPdf(filePath)
+      return JSON.stringify({ ok: true, ...result }, null, 2)
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e?.message ?? String(e) })
+    }
+  },
+})

package/tools/pptx.ts

@@ -0,0 +1,49 @@
+/**
+ * tools/pptx.ts
+ *
+ * revela-pptx — Export a Revela HTML slide deck to editable PPTX.
+ */
+
+import { tool } from "@opencode-ai/plugin"
+import { existsSync } from "fs"
+import { resolve } from "path"
+import { exportToPptx } from "../lib/pptx/export"
+
+export default tool({
+  description:
+    "Export a Revela-generated HTML slide deck to editable PPTX. " +
+    "Use this after the deck HTML has been written and layout QA has passed. " +
+    "Output is written beside the input file with the same basename and a .pptx extension.",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Path to the HTML slide file to export. " +
+        "Can be absolute or relative to the current working directory."
+      ),
+  },
+  async execute({ file }, { directory }) {
+    const filePath = resolve(directory || process.cwd(), file)
+
+    if (!existsSync(filePath)) {
+      return JSON.stringify({ ok: false, error: `File not found: ${filePath}` })
+    }
+
+    if (!/\.html?$/i.test(filePath)) {
+      return JSON.stringify({ ok: false, error: `File must be an HTML file: ${filePath}` })
+    }
+
+    const progress: string[] = []
+
+    try {
+      const result = await exportToPptx(filePath, {
+        onProgress: (event) => {
+          progress.push(event.message)
+        },
+      })
+      return JSON.stringify({ ok: true, ...result, progress }, null, 2)
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e?.message ?? String(e), progress })
+    }
+  },
+})