@cyber-dash-tech/revela 0.3.0 → 0.4.0

package/package.json

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

package/plugin.ts

@@ -47,6 +47,9 @@ import { handlePdf } from "./lib/commands/pdf"
 import { handlePptx } from "./lib/commands/pptx"
 import designsTool from "./tools/designs"
 import domainsTool from "./tools/domains"
+import mediaBatchSaveTool from "./tools/media-batch-save"
+import mediaSaveTool from "./tools/media-save"
+import researchImagesListTool from "./tools/research-images-list"
 import researchSaveTool from "./tools/research-save"
 import workspaceScanTool from "./tools/workspace-scan"
 import extractDocumentMaterialsTool from "./tools/extract-document-materials"
@@ -229,6 +232,9 @@ const server: Plugin = (async (pluginCtx) => {
     tool: {
       "revela-designs": designsTool,
       "revela-domains": domainsTool,
+      "revela-media-batch-save": mediaBatchSaveTool,
+      "revela-media-save": mediaSaveTool,
+      "revela-research-images-list": researchImagesListTool,
       "revela-research-save": researchSaveTool,
       "revela-workspace-scan": workspaceScanTool,
       "revela-extract-document-materials": extractDocumentMaterialsTool,

package/skill/SKILL.md

@@ -427,6 +427,12 @@ element selector list, and `window.getEditedHTML()` definition.
 
 ### Image Rules
 
+- When research findings contain image leads that should appear in the final deck,
+  first call `revela-research-images-list` to inspect structured candidates from
+  `researches/{slug}/*.md`. When multiple images are needed, prefer
+  `revela-media-batch-save` to save the selected candidates in one call. Use
+  `revela-media-save` for one-off cases. Then reference the returned local file
+  path in HTML. Do not use remote image URLs directly in final slides.
 - Use direct file paths (`src="assets/logo.png"`) in HTML — not base64
 - Always use the **original** file path in HTML `<img src>` for full-quality rendering
 - Never repeat the same image on multiple slides (logos: title + closing only)
@@ -493,4 +499,4 @@ The active design name is in the HTML comment at the top of this prompt:
 The active design's complete visual specification — Component Library, Layout
 Primitives, Composition Guide, and Data Visualization rules — is injected
 below after the `---` separator. This is your sole visual reference for
-generating slides.
+generating slides.

package/tools/extract-document-materials.ts

@@ -4,12 +4,12 @@ import { extractDocumentMaterials } from "../lib/document-materials/extract"
 export default tool({
   description:
     "Extract reusable materials from a workspace document into a workspace-local cache. " +
-    "Supports pptx, docx, and xlsx. Produces a manifest plus extracted text, embedded images, and available slide/sheet mappings. " +
+    "Supports pdf, pptx, docx, and xlsx. Produces a manifest plus extracted text, embedded images, and available page/slide/sheet mappings. " +
     "Unsupported file types are skipped instead of failing.",
   args: {
     file: tool.schema
       .string()
-      .describe("Document path relative to workspace root. Supports pptx, docx, and xlsx; other file types are skipped."),
+      .describe("Document path relative to workspace root. Supports pdf, pptx, docx, and xlsx; other file types are skipped."),
   },
   async execute(args, context) {
     const workspaceDir = context.directory ?? process.cwd()

package/tools/media-batch-save.ts

@@ -0,0 +1,25 @@
+import { tool } from "@opencode-ai/plugin"
+import { batchSaveMediaAssets } from "../lib/media/batch-save"
+
+export default tool({
+  description:
+    "Save a selected batch of research-found image leads into workspace assets and update the media manifest. " +
+    "Use this after the primary agent has chosen multiple images from researches/{topic}/*.md.",
+  args: {
+    topic: tool.schema.string().describe("Topic slug shared by one presentation, e.g. 'ev-market'."),
+    items: tool.schema.array(tool.schema.object({
+      candidateId: tool.schema.string().describe("Stable candidate id returned by revela-research-images-list."),
+      description: tool.schema.string().describe("Candidate description from research findings."),
+      url: tool.schema.string().describe("Remote image URL to save."),
+      alt: tool.schema.string().optional().describe("Optional alt text."),
+      use: tool.schema.enum(["logo", "portrait", "screenshot"]).describe("Structured image use from research findings."),
+      sourceFile: tool.schema.string().optional().describe("Optional source research file path."),
+      intendedSection: tool.schema.string().optional().describe("Optional section override for this one item."),
+    })).describe("Explicitly selected image leads to save. This tool does not auto-select candidates."),
+    intendedSection: tool.schema.string().optional().describe("Optional default narrative section for all items in this batch."),
+  },
+  async execute(args, context) {
+    const workspaceDir = context.directory ?? process.cwd()
+    return JSON.stringify(await batchSaveMediaAssets(args, workspaceDir), null, 2)
+  },
+})

package/tools/media-save.ts

@@ -0,0 +1,40 @@
+import { tool } from "@opencode-ai/plugin"
+import { saveMediaAsset } from "../lib/media/save"
+
+export default tool({
+  description:
+    "Save one image asset into the workspace assets/ directory and update a media manifest. " +
+    "Supports either a sourceUrl or a sourcePath. Records both success and failure states. " +
+    "Use this when a research-found image or an existing local image should become a formal project asset.",
+  args: {
+    topic: tool.schema.string().describe("Topic slug shared by one presentation, e.g. 'ev-market'."),
+    id: tool.schema.string().describe("Stable asset id within the topic, e.g. 'tesla-logo-01'."),
+    type: tool.schema.enum(["image"]).describe("Asset type. Stage 1 only supports 'image'."),
+    purpose: tool.schema
+      .enum(["hero", "illustration", "portrait", "logo", "screenshot"])
+      .describe("Image purpose in the deck."),
+    brief: tool.schema.string().describe("One-sentence reason this image is needed."),
+    status: tool.schema
+      .enum(["success", "cannot-download", "invalid-url", "cannot-generate"])
+      .describe("'success' saves an image asset; other statuses record a failed attempt in the manifest."),
+    intendedSection: tool.schema.string().optional().describe("Optional narrative section such as 'market-overview'."),
+    sourcePath: tool.schema
+      .string()
+      .optional()
+      .describe("Optional local image path, relative to the workspace root. Preferred when both sourcePath and sourceUrl are present."),
+    sourceUrl: tool.schema
+      .string()
+      .optional()
+      .describe("Optional remote image URL to download when sourcePath is not provided."),
+    alt: tool.schema.string().optional().describe("Optional alt text for the image."),
+    notes: tool.schema.string().optional().describe("Optional usage notes for future slide generation."),
+    failureReason: tool.schema
+      .string()
+      .optional()
+      .describe("Required when status is not 'success'. Briefly explain why the image is unavailable."),
+  },
+  async execute(args, context) {
+    const workspaceDir = context.directory ?? process.cwd()
+    return JSON.stringify(await saveMediaAsset(args, workspaceDir), null, 2)
+  },
+})

package/tools/research-images-list.ts

@@ -0,0 +1,34 @@
+import { tool } from "@opencode-ai/plugin"
+import { listResearchImageLeads } from "../lib/research/image-leads"
+
+export default tool({
+  description:
+    "List structured image leads from researches/{topic}/*.md. " +
+    "Parses ## Images sections and returns candidate image records for the primary agent to review.",
+  args: {
+    topic: tool.schema.string().describe("Topic slug shared by one presentation, e.g. 'ev-market'."),
+    uses: tool.schema
+      .array(tool.schema.enum(["logo", "portrait", "screenshot", "unknown"]))
+      .optional()
+      .describe("Optional use filter, e.g. ['logo', 'portrait', 'screenshot']"),
+    axis: tool.schema
+      .array(tool.schema.string())
+      .optional()
+      .describe("Optional axis filter, e.g. ['tesla-profile', 'market-data']"),
+  },
+  async execute(args, context) {
+    const workspaceDir = context.directory ?? process.cwd()
+    const result = listResearchImageLeads(args.topic, workspaceDir, {
+      uses: args.uses,
+      axis: args.axis,
+    })
+
+    return JSON.stringify({
+      ok: true,
+      topic: result.topic,
+      count: result.items.length,
+      items: result.items,
+      warnings: result.warnings,
+    }, null, 2)
+  },
+})