@veolab/discoverylab 1.4.4 → 1.6.5

package/dist/{chunk-2UUMLAVR.js → chunk-V6RREMYD.js}

@@ -3,6 +3,7 @@ import {
   createNotionPage
 } from "./chunk-34GGYFXX.js";
 import {
+  getCachedRender,
   getRenderJob,
   startRender
 } from "./chunk-6GK5K6CS.js";
@@ -66,6 +67,7 @@ import {
 import {
   DATA_DIR,
   EXPORTS_DIR,
+  FRAMES_DIR,
   PROJECTS_DIR,
   frames,
   getDatabase,
@@ -3706,7 +3708,7 @@ app.post("/api/upload", async (c) => {
     const { exec: exec2 } = await import("child_process");
     const { promisify } = await import("util");
     const execAsync = promisify(exec2);
-    const { PROJECTS_DIR: PROJECTS_DIR2, FRAMES_DIR } = await import("./db-5ECN3O7F.js");
+    const { PROJECTS_DIR: PROJECTS_DIR2, FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
     const id = crypto.randomUUID();
     const now = /* @__PURE__ */ new Date();
     const projectDir = join6(PROJECTS_DIR2, id);
@@ -3735,7 +3737,7 @@ app.post("/api/upload", async (c) => {
     let framePaths = [];
     try {
       if (isVideo) {
-        const projectFramesDir = join6(FRAMES_DIR, id);
+        const projectFramesDir = join6(FRAMES_DIR2, id);
         if (!fsExists(projectFramesDir)) {
           mkdirSync5(projectFramesDir, { recursive: true });
         }
@@ -4502,8 +4504,8 @@ app.post("/api/analyze/:id", async (c) => {
           const { promisify } = await import("util");
           const { mkdirSync: mkdirSync5, readdirSync: readdirSync5 } = await import("fs");
           const execAsync = promisify(exec2);
-          const { FRAMES_DIR } = await import("./db-5ECN3O7F.js");
-          const projectFramesDir = join6(FRAMES_DIR, id);
+          const { FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
+          const projectFramesDir = join6(FRAMES_DIR2, id);
           if (!existsSync5(projectFramesDir)) {
             mkdirSync5(projectFramesDir, { recursive: true });
           }
@@ -5006,11 +5008,11 @@ app.get("/api/grid/project-frames/:id", async (c) => {
       return c.json({ error: "Project not found" }, 404);
     }
     const project = result[0];
-    const { FRAMES_DIR } = await import("./db-5ECN3O7F.js");
+    const { FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
     const { readdirSync: readdirSync5 } = await import("fs");
     const availableFrames = [];
     const { isBlankFrame } = await import("./frames-2NFCSKXQ.js");
-    const projectFramesDir = join6(FRAMES_DIR, id);
+    const projectFramesDir = join6(FRAMES_DIR2, id);
     if (existsSync5(projectFramesDir)) {
       const frameFiles = readdirSync5(projectFramesDir).filter((f) => /\.(png|jpg|jpeg)$/i.test(f)).sort();
       for (const f of frameFiles) {
@@ -5137,18 +5139,43 @@ function resolveProjectBundleRecordingDir(originalVideoPath, resolvedVideoPath)
   }
   return null;
 }
-function copyProjectExportArtifacts(sourceDir, destinationDir) {
-  if (!existsSync5(sourceDir) || !statSync3(sourceDir).isDirectory()) {
-    return 0;
+function collectProjectExportFramePaths(projectId, recordingBaseDir) {
+  const candidateDirs = [
+    join6(FRAMES_DIR, projectId),
+    join6(PROJECTS_DIR, projectId, "frames"),
+    recordingBaseDir ? join6(recordingBaseDir, "screenshots") : null,
+    recordingBaseDir
+  ].filter((value, index, items) => !!value && items.indexOf(value) === index);
+  const framePaths = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const dirPath of candidateDirs) {
+    if (!existsSync5(dirPath) || !statSync3(dirPath).isDirectory()) {
+      continue;
+    }
+    const files = readdirSync4(dirPath).filter((entry) => /\.(png|jpg|jpeg|webp)$/i.test(entry)).filter((entry) => !entry.startsWith("._")).sort();
+    for (const entry of files) {
+      const absolutePath = join6(dirPath, entry);
+      if (seen.has(absolutePath)) {
+        continue;
+      }
+      seen.add(absolutePath);
+      framePaths.push(absolutePath);
+    }
   }
-  let copiedCount = 0;
-  for (const entry of readdirSync4(sourceDir)) {
-    if (/\.(applab|esvp)$/i.test(entry)) continue;
-    if (copyPathIntoExportBundle(join6(sourceDir, entry), join6(destinationDir, entry))) {
-      copiedCount += 1;
+  return framePaths;
+}
+function resolveAppLabBundleIconPath() {
+  const candidates = [
+    join6(__dirname, "..", "..", "assets", "applab-bundle-icon.png"),
+    join6(__dirname, "..", "assets", "applab-bundle-icon.png"),
+    join6(process.cwd(), "assets", "applab-bundle-icon.png")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync5(candidate)) {
+      return candidate;
     }
   }
-  return copiedCount;
+  return null;
 }
 async function runExportCommand(command, args, cwd) {
   await new Promise((resolve, reject) => {
@@ -5281,7 +5308,6 @@ app.post("/api/export", async (c) => {
       const projectFrames = await db.select().from(frames).where(eq(frames.projectId, projectId)).orderBy(frames.frameNumber);
       const exportRecords = await db.select().from(projectExports).where(eq(projectExports.projectId, projectId)).orderBy(desc(projectExports.createdAt));
       const recordingBaseDir = resolveProjectBundleRecordingDir(rawProject.videoPath, resolvedVideoPath);
-      const exportArtifactsDir = join6(EXPORTS_DIR, projectId);
       const sessionPath = recordingBaseDir ? join6(recordingBaseDir, "session.json") : null;
       let sessionData = null;
       let networkEntries = [];
@@ -5306,8 +5332,7 @@ app.post("/api/export", async (c) => {
         const summaryPath = rawProject.aiSummary ? "analysis/app-intelligence.md" : null;
         const ocrPath = rawProject.ocrText ? "analysis/ocr.txt" : null;
         const thumbnailName = rawProject.thumbnailPath ? basename3(rawProject.thumbnailPath) : null;
-        const resolvedMediaName = resolvedVideoPath ? basename3(resolvedVideoPath) : null;
-        const bundledFrames = projectFrames.map((frame) => {
+        let bundledFrames = projectFrames.map((frame) => {
           const extensionMatch = basename3(frame.imagePath).match(/(\.[^.]+)$/);
           const extension = extensionMatch ? extensionMatch[1] : ".png";
           const relativeImagePath = `frames/frame-${String(frame.frameNumber).padStart(4, "0")}${extension}`;
@@ -5317,19 +5342,39 @@ app.post("/api/export", async (c) => {
             imagePath: relativeImagePath
           };
         });
-        const mediaFiles = [];
-        if (resolvedVideoPath && existsSync5(resolvedVideoPath) && !statSync3(resolvedVideoPath).isDirectory()) {
-          const relativePath = `media/${resolvedMediaName}`;
-          copyPathIntoExportBundle(resolvedVideoPath, join6(bundleRoot, relativePath));
-          mediaFiles.push({ role: "primary-media", path: relativePath });
+        if (bundledFrames.length === 0) {
+          const fallbackFramePaths = collectProjectExportFramePaths(projectId, recordingBaseDir);
+          bundledFrames = fallbackFramePaths.map((framePath, index) => {
+            const extensionMatch = basename3(framePath).match(/(\.[^.]+)$/);
+            const extension = extensionMatch ? extensionMatch[1] : ".png";
+            const relativeImagePath = `frames/frame-${String(index + 1).padStart(4, "0")}${extension}`;
+            copyPathIntoExportBundle(framePath, join6(bundleRoot, relativeImagePath));
+            return {
+              id: `${projectId}-fallback-frame-${index + 1}`,
+              projectId,
+              frameNumber: index + 1,
+              imagePath: relativeImagePath,
+              ocrText: null,
+              timestamp,
+              createdAt: new Date(timestamp),
+              isKeyFrame: null
+            };
+          });
         }
+        const mediaFiles = [];
         if (rawProject.thumbnailPath && existsSync5(rawProject.thumbnailPath) && thumbnailName) {
           const relativePath = `media/${thumbnailName}`;
           copyPathIntoExportBundle(rawProject.thumbnailPath, join6(bundleRoot, relativePath));
           mediaFiles.push({ role: "thumbnail", path: relativePath });
         }
-        const recordingIncluded = recordingBaseDir ? copyPathIntoExportBundle(recordingBaseDir, join6(bundleRoot, "recording")) : false;
-        const exportArtifactCount = copyProjectExportArtifacts(exportArtifactsDir, join6(bundleRoot, "exports"));
+        const canonicalBundleIconPath = resolveAppLabBundleIconPath();
+        const bundleIconRelativePath = canonicalBundleIconPath ? "media/icon.png" : null;
+        if (canonicalBundleIconPath && bundleIconRelativePath) {
+          copyPathIntoExportBundle(canonicalBundleIconPath, join6(bundleRoot, bundleIconRelativePath));
+          mediaFiles.push({ role: "icon", path: bundleIconRelativePath });
+        }
+        const recordingIncluded = false;
+        const exportArtifactCount = 0;
         const esvpSessionId = resolveProjectESVPSessionId(esvp);
         const esvpServerUrl = resolveProjectESVPServerUrl(esvp);
         let esvpSnapshot = null;
@@ -5351,9 +5396,13 @@ app.post("/api/export", async (c) => {
         }
         const packagedProject = {
           ...normalizedProject,
-          videoPath: resolvedMediaName ? `media/${resolvedMediaName}` : normalizedProject.videoPath,
+          videoPath: null,
           thumbnailPath: thumbnailName ? `media/${thumbnailName}` : normalizedProject.thumbnailPath,
-          frames: bundledFrames
+          frames: bundledFrames,
+          icon: bundleIconRelativePath ? {
+            path: bundleIconRelativePath,
+            kind: "app-icon"
+          } : null
         };
         writeExportJson(join6(bundleRoot, "manifest.json"), {
           bundleVersion: 1,
@@ -5367,6 +5416,10 @@ app.post("/api/export", async (c) => {
             id: rawProject.id,
             name: rawProject.name,
             platform: rawProject.platform || null,
+            icon: bundleIconRelativePath ? {
+              path: bundleIconRelativePath,
+              kind: "app-icon"
+            } : null,
             frameCount: bundledFrames.length,
             hasRecordingFolder: recordingIncluded,
             hasNetworkTrace: networkEntries.length > 0 || !!networkCapture,
@@ -5418,6 +5471,11 @@ app.post("/api/export", async (c) => {
         if (esvpSnapshot) {
           writeExportJson(join6(bundleRoot, "esvp", "snapshot.json"), esvpSnapshot);
         }
+        const templateContentPath = join6(PROJECTS_DIR, projectId, "template-content.json");
+        if (existsSync5(templateContentPath)) {
+          mkdirSync4(join6(bundleRoot, "templates"), { recursive: true });
+          cpSync(templateContentPath, join6(bundleRoot, "templates", "content.json"));
+        }
         writeExportText(join6(bundleRoot, "README.txt"), [
           `${rawProject.name}`,
           `Exported from DiscoveryLab ${APP_VERSION} on ${new Date(timestamp).toISOString()}.`,
@@ -5425,12 +5483,16 @@ app.post("/api/export", async (c) => {
           "This package bundles the local project context for sharing or re-analysis.",
           "",
           "Included when available:",
-          "- original media and thumbnail",
-          "- recording folder with session data, screenshots, and test script",
+          "- selected thumbnail and analyzed frames",
+          "- lightweight project/session metadata",
           "- OCR text and app intelligence summary",
           "- network trace, capture metadata, and ESVP snapshot",
-          "- previously generated export assets such as grids and renders",
-          "- Task Hub links, requirements, and test map"
+          "- Task Hub links, requirements, and test map",
+          "",
+          "Excluded by default to keep the bundle Claude-friendly:",
+          "- original long-form media",
+          "- recording folder",
+          "- generated export assets and renders"
         ].join("\n"));
         outputPath = join6(exportDir, `export-${timestamp}.${format}`);
         mimeType = "application/zip";
@@ -5591,8 +5653,8 @@ app.get("/api/visualization/:projectId/:templateId", async (c) => {
     const db = getDatabase();
     const [project] = await db.select().from(projects).where(eq(projects.id, projectId)).limit(1);
     if (!project) return c.json({ error: "Project not found" }, 404);
-    const { FRAMES_DIR } = await import("./db-5ECN3O7F.js");
-    const projectFramesDir = join6(FRAMES_DIR, projectId);
+    const { FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
+    const projectFramesDir = join6(FRAMES_DIR2, projectId);
     const dbFrames = await db.select().from(frames).where(eq(frames.projectId, projectId)).orderBy(frames.frameNumber).limit(10);
     let frameImages = [];
     if (dbFrames.length > 0) {
@@ -5913,6 +5975,72 @@ app.post("/api/visualization/screenshot", async (c) => {
     return c.json({ error: message }, 500);
   }
 });
+app.post("/api/export/infographic", async (c) => {
+  try {
+    const body = await c.req.json();
+    const { projectId, open } = body;
+    if (!projectId) return c.json({ error: "projectId required" }, 400);
+    const db = getDatabase();
+    const [project] = await db.select().from(projects).where(eq(projects.id, projectId)).limit(1);
+    if (!project) return c.json({ error: "Project not found" }, 404);
+    const { FRAMES_DIR: fDir, EXPORTS_DIR: eDir, PROJECTS_DIR: pDir } = await import("./db-5ECN3O7F.js");
+    const { collectFrameImages, buildInfographicData, generateInfographicHtml } = await import("./infographic-GQAHEOAA.js");
+    const dbFrames = await db.select().from(frames).where(eq(frames.projectId, projectId)).orderBy(frames.frameNumber).limit(20);
+    let frameFiles;
+    let frameOcr;
+    if (dbFrames.length > 0) {
+      frameFiles = dbFrames.map((f) => f.imagePath);
+      frameOcr = dbFrames;
+    } else {
+      frameFiles = collectFrameImages(join6(fDir, projectId), project.videoPath, pDir, projectId);
+      frameOcr = frameFiles.map(() => ({ ocrText: null }));
+    }
+    if (frameFiles.length === 0) {
+      return c.json({ error: "No frames found. Run analyzer first." }, 400);
+    }
+    const cached = annotationCache.get(projectId);
+    const annotations = cached?.steps?.map((s) => ({ label: s }));
+    const data = buildInfographicData(project, frameFiles, frameOcr, annotations);
+    const slug = (project.marketingTitle || project.name || projectId).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+    const outputPath = join6(eDir, `${slug}-infographic.html`);
+    const result = generateInfographicHtml(data, outputPath);
+    if (!result.success) return c.json({ error: result.error }, 500);
+    if (open) {
+      const { exec: exec2 } = await import("child_process");
+      exec2(`open "${result.outputPath}"`);
+    }
+    return c.json({
+      success: true,
+      path: result.outputPath,
+      downloadUrl: `/api/file?path=${encodeURIComponent(result.outputPath)}&download=true`,
+      size: result.size,
+      frameCount: result.frameCount
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return c.json({ error: message }, 500);
+  }
+});
+app.post("/api/import", async (c) => {
+  try {
+    const body = await c.req.json();
+    const { filePath } = body;
+    if (!filePath) return c.json({ error: "filePath required" }, 400);
+    const { importApplabBundle } = await import("./import-W2JEW254.js");
+    const { FRAMES_DIR: fDir, PROJECTS_DIR: pDir } = await import("./db-5ECN3O7F.js");
+    const db = getDatabase();
+    const result = await importApplabBundle(filePath, db, { projects, frames }, {
+      dataDir: DATA_DIR,
+      framesDir: fDir,
+      projectsDir: pDir
+    });
+    if (!result.success) return c.json({ error: result.error }, 400);
+    return c.json(result);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return c.json({ error: message }, 500);
+  }
+});
 app.get("/api/export/document/:projectId", async (c) => {
   try {
     const projectId = c.req.param("projectId");
@@ -5922,9 +6050,9 @@ app.get("/api/export/document/:projectId", async (c) => {
     const projectFrames = await db.select().from(frames).where(eq(frames.projectId, projectId)).orderBy(frames.frameNumber).limit(20);
     let frameData = projectFrames.map((f) => ({ imagePath: f.imagePath, ocrText: f.ocrText }));
     if (frameData.length === 0 && project.videoPath) {
-      const { FRAMES_DIR } = await import("./db-5ECN3O7F.js");
+      const { FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
       const dirs = [
-        join6(FRAMES_DIR, projectId),
+        join6(FRAMES_DIR2, projectId),
         join6(project.videoPath, "screenshots"),
         join6(PROJECTS_DIR, "maestro-recordings", projectId, "screenshots"),
         join6(PROJECTS_DIR, "web-recordings", projectId, "screenshots")
@@ -6001,7 +6129,7 @@ app.post("/api/export/batch", async (c) => {
     if (!manifest.destination?.type) {
       return c.json({ error: "Destination type required" }, 400);
     }
-    const { FRAMES_DIR } = await import("./db-5ECN3O7F.js");
+    const { FRAMES_DIR: FRAMES_DIR2 } = await import("./db-5ECN3O7F.js");
     const dataProvider = {
       async getProject(projectId) {
         const db2 = getDatabase();
@@ -6009,7 +6137,7 @@ app.post("/api/export/batch", async (c) => {
         return p || null;
       },
       getFramesDir(projectId) {
-        return join6(FRAMES_DIR, projectId);
+        return join6(FRAMES_DIR2, projectId);
       }
     };
     const result = await executeBatchExport(manifest, dataProvider, (progress) => {
@@ -6253,6 +6381,158 @@ app.get("/api/testing/status", async (c) => {
     return c.json({ error: message }, 500);
   }
 });
+function getClaudeDesktopConfigPath() {
+  const home = homedir3();
+  return process.platform === "win32" ? join6(process.env.APPDATA || join6(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json") : join6(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+}
+function getClaudeDesktopAppCandidates() {
+  const home = homedir3();
+  if (process.platform === "darwin") {
+    return [
+      "/Applications/Claude.app",
+      join6(home, "Applications", "Claude.app")
+    ];
+  }
+  if (process.platform === "win32") {
+    return [
+      process.env.LOCALAPPDATA ? join6(process.env.LOCALAPPDATA, "Programs", "Claude", "Claude.exe") : "",
+      process.env.PROGRAMFILES ? join6(process.env.PROGRAMFILES, "Claude", "Claude.exe") : "",
+      process.env["PROGRAMFILES(X86)"] ? join6(process.env["PROGRAMFILES(X86)"], "Claude", "Claude.exe") : "",
+      process.env.APPDATA ? join6(process.env.APPDATA, "Claude", "Claude.exe") : ""
+    ].filter(Boolean);
+  }
+  return [];
+}
+function findClaudeDesktopApp() {
+  if (process.platform === "darwin") {
+    try {
+      execSync2('open -Ra "Claude"', { stdio: "pipe", timeout: 2e3 });
+      return {
+        detected: true,
+        launchTarget: "Claude",
+        installPath: getClaudeDesktopAppCandidates().find((candidate2) => existsSync5(candidate2)) || null
+      };
+    } catch {
+      const candidate2 = getClaudeDesktopAppCandidates().find((path) => existsSync5(path));
+      return {
+        detected: Boolean(candidate2),
+        launchTarget: candidate2 ? "Claude" : null,
+        installPath: candidate2 || null
+      };
+    }
+  }
+  const candidate = getClaudeDesktopAppCandidates().find((path) => existsSync5(path));
+  return {
+    detected: Boolean(candidate),
+    launchTarget: candidate || null,
+    installPath: candidate || null
+  };
+}
+function detectDiscoveryLabClaudeDesktopMcp() {
+  const configPath = getClaudeDesktopConfigPath();
+  if (!existsSync5(configPath)) {
+    return {
+      configured: false,
+      serverName: null,
+      source: "none",
+      configPath
+    };
+  }
+  try {
+    const raw = readFileSync2(configPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const servers = parsed?.mcpServers;
+    if (!servers || typeof servers !== "object") {
+      return {
+        configured: false,
+        serverName: null,
+        source: "none",
+        configPath
+      };
+    }
+    for (const [name, config] of Object.entries(servers)) {
+      const configString = [
+        name,
+        config?.command || "",
+        ...Array.isArray(config?.args) ? config.args : [],
+        config?.url || ""
+      ].join(" ").toLowerCase();
+      if (name === "discoverylab" || configString.includes("@veolab/discoverylab") || configString.includes("discoverylab") || configString.includes("applab-discovery")) {
+        return {
+          configured: true,
+          serverName: name || "discoverylab",
+          source: "settings",
+          configPath
+        };
+      }
+    }
+  } catch {
+  }
+  return {
+    configured: false,
+    serverName: null,
+    source: "none",
+    configPath
+  };
+}
+app.get("/api/integrations/claude-desktop/status", async (c) => {
+  try {
+    const { platform } = await import("os");
+    const app2 = findClaudeDesktopApp();
+    const mcp = detectDiscoveryLabClaudeDesktopMcp();
+    const launcherSupported = platform() === "darwin" || platform() === "win32";
+    const ready = app2.detected && launcherSupported && mcp.configured;
+    let message = "Claude Desktop launcher unavailable on this platform.";
+    if (platform() === "darwin" || platform() === "win32") {
+      if (!app2.detected) {
+        message = "Claude Desktop was not detected on this machine.";
+      } else if (!mcp.configured) {
+        message = "Claude Desktop is installed, but the DiscoveryLab local MCP is not configured yet.";
+      } else {
+        message = "Claude Desktop is ready to open this project with the local DiscoveryLab MCP.";
+      }
+    }
+    return c.json({
+      ready,
+      appDetected: app2.detected,
+      launcherSupported,
+      launchTarget: app2.launchTarget,
+      installPath: app2.installPath,
+      mcpConfigured: mcp.configured,
+      serverName: mcp.serverName,
+      source: mcp.source,
+      configPath: mcp.configPath,
+      installCommand: "npx -y @veolab/discoverylab@latest install --target desktop",
+      message
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return c.json({ error: message }, 500);
+  }
+});
+app.post("/api/integrations/claude-desktop/launch", async (c) => {
+  try {
+    const { platform } = await import("os");
+    const { exec: exec2 } = await import("child_process");
+    const { promisify } = await import("util");
+    const app2 = findClaudeDesktopApp();
+    if (!app2.detected || !app2.launchTarget) {
+      return c.json({ success: false, error: "Claude Desktop was not detected on this machine." }, 404);
+    }
+    const execAsync = promisify(exec2);
+    if (platform() === "darwin") {
+      await execAsync(`open -a "${app2.launchTarget}"`);
+    } else if (platform() === "win32") {
+      await execAsync(`cmd /c start "" "${app2.launchTarget}"`);
+    } else {
+      return c.json({ success: false, error: "Claude Desktop launcher is not supported on this platform." }, 400);
+    }
+    return c.json({ success: true });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return c.json({ success: false, error: message }, 500);
+  }
+});
 app.get("/api/integrations/jira-mcp/status", async (c) => {
   try {
     const { execSync: execSync3 } = await import("child_process");
@@ -9876,7 +10156,7 @@ app.get("/api/mobile-chat/providers", async (c) => {
 });
 app.get("/api/setup/status", async (c) => {
   try {
-    const { setupStatusTool } = await import("./setup-6JJYKKBS.js");
+    const { setupStatusTool } = await import("./setup-SMN7FJNZ.js");
     const result = await setupStatusTool.handler({});
     const data = JSON.parse(result.content[0].text);
     const idbInstalled = await isIdbInstalled().catch(() => false);
@@ -11286,6 +11566,20 @@ app.post("/api/templates/render", async (c) => {
       return c.json({ error: templateState.eligibility.reason || `Templates are limited to videos up to ${TEMPLATE_MAX_DURATION_SECONDS} seconds.` }, 400);
     }
     const { props } = templateState;
+    const forceRender = body.force === true;
+    if (!forceRender) {
+      const cached = getCachedRender(projectId, templateId);
+      if (cached && existsSync5(cached)) {
+        return c.json({
+          jobId: "cached",
+          status: "completed",
+          outputPath: cached,
+          downloadUrl: `/api/file?path=${encodeURIComponent(cached)}&download=true`,
+          previewUrl: `/api/file?path=${encodeURIComponent(cached)}`,
+          cached: true
+        });
+      }
+    }
     const job = await startRender(projectId, templateId, props, (progress) => {
       broadcastToClients({
         type: "templateRenderProgress",