@effectnode/media 0.5.0 → 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 @wonglok831 x.com, github.com/wonglok
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/backend/movie-backend/agent/agent-backend.d.ts

@@ -4,7 +4,7 @@ import { type Application } from "express";
  * Persists the result to studio/:projectId/data/*.json and returns the parsed
  * result. Used both by the HTTP route below and by the generation queue worker.
  */
-export declare function generateMovieStudioBible(projectId: string, idea: string, model?: string): Promise<{
+export declare function generateMovieStudioBible(projectId: string, idea: string, model?: string, onProgress?: (statusText: string, current: number, total: number) => void): Promise<{
     characters: any[];
     places: any[];
     scenes: any[];

package/dist/backend/movie-backend/agent/agent-backend.js

@@ -48,7 +48,7 @@ function toOpenAIMessages(messages) {
 function buildSystemPrompt() {
     const toolList = TOOLS.map((t) => `- ${t.name}: ${t.description}`).join("\n");
     return [
-        "You are a media assistant that helps the user edit images or render videos in their workspace.",
+        "You are a media assistant that helps the user render videos in their workspace.",
         "",
         "Available tools:",
         toolList,
@@ -56,34 +56,16 @@ function buildSystemPrompt() {
         "Rules:",
         "- Call a tool only when you actually need its result. Once you have enough information, answer the user directly WITHOUT calling any tool.",
         "- Do not call the same tool twice with the same arguments.",
-        "- ALWAYS confirm with the user before generating or editing. Never call `image_to_video_generation`, `text_to_video_generation`, or `edit_image` until the user has explicitly said yes.",
+        "- ALWAYS confirm with the user before generating. Never call `image_to_video_generation` or `text_to_video_generation` until the user has explicitly said yes.",
         "",
         "## Getting started",
         "",
         'When the user greets you (e.g. says "hi" or "hello") or asks for help, FIRST ask them what they want to do:',
-        "1. Edit an image",
-        "2. Render a video from text",
-        "3. Render a video from an image",
+        "1. Render a video from text",
+        "2. Render a video from an image",
         "",
         "Then follow the matching workflow below.",
         "",
-        "## Workflow: Edit an image",
-        "",
-        "### Step 1 — Image",
-        "- Call `list_files` to see what is in the agent workspace.",
-        '- List every image file (files whose `kind` is "image") to the user as a numbered list so they can pick one.',
-        "- You may call `show_image` to preview an image before the user decides.",
-        "- If there are no images, tell the user and ask them to upload one first.",
-        "",
-        "### Step 2 — Edit instruction",
-        "- Plan the edit together with the user. Ask what they want to change: background, style, color, lighting, expression, object, and so on.",
-        "- Confirm the wording of the edit prompt before moving on.",
-        "",
-        "### Step 3 — Summary and confirmation",
-        "- Prepare a short summary containing the image and the edit instruction, and ask the user to confirm.",
-        "- Do NOT start editing yet. Wait for the user to say yes.",
-        "- Only after the user confirms, call `edit_image` with the image and prompt.",
-        "",
         "## Workflow: Render a video",
         "",
         "To generate a video you need a motion PROMPT and a DURATION. An IMAGE is optional but recommended.",
@@ -151,53 +133,83 @@ function sanitizeTrace(messages) {
     });
 }
 // ========== Movie Studio ==========
-const MOVIE_STUDIO_CHARACTERS_PROMPT = [
+const MOVIE_STUDIO_CHARACTERS_PLAN_PROMPT = [
     "You are a movie pre-production planner. Given a movie or story idea, identify the characters.",
     "",
     "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
     "",
-    '{"artStyle":"string","characters":[{"slug":"string","name":"string","imagePrompt":"string"}]}',
+    '{"artStyle":"string","characters":[{"slug":"string","name":"string"}]}',
     "",
     "Rules:",
     '- "slug" is a short lowercase hyphenated identifier (e.g. "the-lamb").',
     '- "artStyle" is ONE consistent art style for the entire film (e.g. cinematic photorealistic, 3D animation, hand-painted watercolor, anime).',
     '- If the idea does not mention an art style, set "artStyle" to "photo realistic render".',
-    "- A character's imagePrompt is a standalone text-to-image prompt that begins with the character's name and fully describes their appearance (age, face, build, outfit, distinctive features) together with their cultural background — the era/age, culture, ethnicity, and region the character belongs to — so the generated image is historically and culturally accurate and consistent.",
-    "- Apply the same artStyle to every character imagePrompt.",
-    "- Write prompts as natural-language English sentences, never comma-separated keyword tags.",
 ].join("\n");
-const MOVIE_STUDIO_PLACES_PROMPT = [
+const CHARACTER_IMAGE_PROMPT = [
+    "You are a movie pre-production planner. Given a movie idea, its art style, and one character, write that character's standalone character-reference image prompt.",
+    "",
+    "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
+    "",
+    '{"imagePrompt":"string"}',
+    "",
+    "Rules:",
+    "- The imagePrompt describes a close-up portrait shot of the character's face on a plain solid white background, framed head and shoulders, facing the camera, evenly lit with soft neutral studio lighting and no props, scenery or background elements.",
+    "- The imagePrompt begins with the character's name and then concentrates on the face: age, face shape, skin tone and texture, eyes, eyebrows, nose, mouth, facial hair, hairstyle and hair colour, expression, and any distinctive facial features such as scars, freckles or markings.",
+    "- Include the character's cultural background — the era/age, culture, ethnicity, and region they belong to — so the face is historically and culturally accurate and consistent.",
+    "- Mention clothing only as far as the collar or neckline is visible in a head-and-shoulders crop; do not describe the full outfit, body build, pose, or action.",
+    "- Apply the given artStyle.",
+    "- Write the prompt as natural-language English sentences, never comma-separated keyword tags.",
+].join("\n");
+const MOVIE_STUDIO_PLACES_PLAN_PROMPT = [
     "You are a movie pre-production planner. Given a movie idea, its art style, and its characters, identify the places/locations.",
     "",
     "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
     "",
-    '{"places":[{"slug":"string","name":"string","imagePrompt":"string"}]}',
+    '{"places":[{"slug":"string","name":"string"}]}',
     "",
     "Rules:",
     '- "slug" is a short lowercase hyphenated identifier (e.g. "sunny-meadow").',
-    "- A place's imagePrompt is a standalone text-to-image prompt that fully describes the location/environment (time of day, lighting, atmosphere, visual style).",
-    "- Apply the given artStyle to every place imagePrompt so it matches the characters.",
-    "- Write prompts as natural-language English sentences, never comma-separated keyword tags.",
 ].join("\n");
-const MOVIE_STUDIO_SCENES_PROMPT = [
+const PLACE_IMAGE_PROMPT = [
+    "You are a movie pre-production planner. Given a movie idea, its art style, and one place, write that place's standalone image prompt.",
+    "",
+    "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
+    "",
+    '{"imagePrompt":"string"}',
+    "",
+    "Rules:",
+    "- The imagePrompt fully describes the location/environment (time of day, lighting, atmosphere, visual style).",
+    "- Apply the given artStyle.",
+    "- Write the prompt as natural-language English sentences, never comma-separated keyword tags.",
+].join("\n");
+const MOVIE_STUDIO_SCENES_PLAN_PROMPT = [
     "You are a movie pre-production planner. Given a movie idea, its art style, its characters, and its places, break the story into scenes.",
     "",
     "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
     "",
-    '{"scenes":[{"slug":"string","duration":number,"description":"string","characterSlugs":["string"],"placeSlug":"string","scriptLines":[{"characterSlug":"string","line":"string"}],"voiceOver":"string","imagePrompt":"string"}]}',
+    '{"scenes":[{"slug":"string","duration":number,"characterSlugs":["string"],"placeSlug":"string"}]}',
     "",
     "Rules:",
-    "- Break the story into many small scenes: each scene is a single camera moment with one action beat.",
-    "- Generate as many scenes as possible: maximize the scene count. Every distinct beat, camera change, or exchange of dialogue should become its own scene — when in doubt, split into more scenes rather than fewer.",
-    "- Never reduce or summarize the dialogue: distribute every single spoken line across the resulting small scenes so no line is lost.",
-    "- Preserve as much detail as possible in every description and imagePrompt.",
+    '- "slug" is a short lowercase hyphenated identifier (e.g. "opening-meadow").',
+    "- Break the story into a natural number of scenes. Group related action beats and dialogue together — do not inflate the scene count by splitting every moment into its own scene.",
+    "- Never reduce or summarize the dialogue: keep every spoken line, grouping multiple lines into a scene where it reads naturally.",
     "- Each scene references the characters and the place involved via their slugs (characterSlugs is a list; placeSlug is a single slug).",
-    "- A scene's imagePrompt is ONE coherent shot that combines the referenced characters AND the place together, using the given artStyle.",
-    "- scriptLines is one entry per spoken line, each with the speaking character's slug and the exact spoken line. Include every single line of dialogue in the scene.",
-    "- voiceOver is the narration/voiceover for that scene (use an empty string when there is none).",
     "- Each scene has a duration in seconds (typically 3-20) matching how long the shot should last.",
-    "- Apply the same artStyle to every scene imagePrompt.",
-    "- Write prompts and dialogue as natural-language English sentences, never comma-separated keyword tags.",
+].join("\n");
+const SCENE_DETAIL_PROMPT = [
+    "You are a movie pre-production planner. Given a movie idea, its art style, its characters, its places, and one scene, write that scene's full details.",
+    "",
+    "Return ONLY valid JSON (no markdown fences, no commentary) matching this exact shape:",
+    "",
+    '{"description":"string","scriptLines":[{"characterSlug":"string","line":"string"}],"voiceOver":"string","imagePrompt":"string"}',
+    "",
+    "Rules:",
+    "- description is a short description of the scene's action.",
+    "- scriptLines is one entry per spoken line, each with the speaking character's slug and the exact spoken line. Include every line of dialogue that belongs to this scene.",
+    "- voiceOver is the narration/voiceover for that scene (use an empty string when there is none).",
+    "- imagePrompt is ONE coherent shot that combines the referenced characters AND the place together, using the given artStyle.",
+    "- Apply the given artStyle to the imagePrompt.",
+    "- Write descriptions, prompts and dialogue as natural-language English sentences, never comma-separated keyword tags.",
 ].join("\n");
 /** Extract the first JSON object from a model response (handles code fences). */
 function extractJsonObject(text) {
@@ -217,7 +229,7 @@ function extractJsonObject(text) {
  * Persists the result to studio/:projectId/data/*.json and returns the parsed
  * result. Used both by the HTTP route below and by the generation queue worker.
  */
-export async function generateMovieStudioBible(projectId, idea, model) {
+export async function generateMovieStudioBible(projectId, idea, model, onProgress) {
     const resolvedModel = typeof model === "string" && model.trim() ? model.trim() : DEFAULT_MODEL;
     const client = new OpenAI({
         baseURL: "http://localhost:8881/v1",
@@ -229,51 +241,127 @@ export async function generateMovieStudioBible(projectId, idea, model) {
         return Number.isFinite(n) ? n : 0;
     };
     const ask = async (systemPrompt, userContent) => {
-        const completion = await client.chat.completions.create({
-            model: resolvedModel,
-            messages: [
-                { role: "system", content: systemPrompt },
-                { role: "user", content: userContent },
-            ],
-            temperature: 0.7,
-        });
-        const text = completion.choices?.[0]?.message?.content ?? "";
-        return extractJsonObject(text);
+        let prompt = systemPrompt;
+        let lastError = null;
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const completion = await client.chat.completions.create({
+                    model: resolvedModel,
+                    messages: [
+                        { role: "system", content: prompt },
+                        { role: "user", content: userContent },
+                    ],
+                    temperature: 0.7,
+                    max_tokens: 8192,
+                });
+                const text = completion.choices?.[0]?.message?.content ?? "";
+                return extractJsonObject(text);
+            }
+            catch (e) {
+                lastError = e;
+                // The model likely truncated its JSON — retry with an explicit
+                // instruction to emit one complete, valid JSON object.
+                prompt = `${systemPrompt}\n\nIMPORTANT: Return the complete JSON object in a single response. Do not truncate; close every string, object, and array.`;
+            }
+        }
+        throw lastError instanceof Error
+            ? lastError
+            : new Error("Failed to parse model JSON response");
+    };
+    // Generate one item through the model, falling back to `fallback` on failure
+    // (after the ask-level retries) so a single bad item never fails the whole
+    // production bible.
+    const generateItem = async (systemPrompt, userContent, fallback) => {
+        try {
+            return await ask(systemPrompt, userContent);
+        }
+        catch {
+            return fallback;
+        }
+    };
+    // Progress reporting (SSE-synced to the UI by the queue worker).
+    let current = 0;
+    let total = 0;
+    const addTotal = (n) => {
+        total += n;
     };
-    // 1. Characters + art style.
-    const charData = await ask(MOVIE_STUDIO_CHARACTERS_PROMPT, idea.trim());
-    const artStyle = toStr(charData?.artStyle);
-    const characters = (Array.isArray(charData.characters) ? charData.characters : []).map((c) => ({
-        slug: toStr(c?.slug),
-        name: toStr(c?.name),
-        imagePrompt: toStr(c?.imagePrompt),
-    }));
-    // 2. Places (with art style + characters as context).
-    const placeData = await ask(MOVIE_STUDIO_PLACES_PROMPT, `Art style: ${artStyle || "photo realistic render"}\n\nIdea: ${idea.trim()}\n\nCharacters:\n${JSON.stringify(characters)}`);
-    const places = (Array.isArray(placeData.places) ? placeData.places : []).map((p) => ({
-        slug: toStr(p?.slug),
-        name: toStr(p?.name),
-        imagePrompt: toStr(p?.imagePrompt),
-    }));
-    // 3. Scenes (with art style + characters + places as context).
-    const sceneData = await ask(MOVIE_STUDIO_SCENES_PROMPT, `Art style: ${artStyle || "photo realistic render"}\n\nIdea: ${idea.trim()}\n\nCharacters:\n${JSON.stringify(characters)}\n\nPlaces:\n${JSON.stringify(places)}`);
-    const scenes = (Array.isArray(sceneData.scenes) ? sceneData.scenes : []).map((s) => ({
+    const note = (statusText) => onProgress?.(statusText, current, total);
+    const advance = (statusText) => {
+        current += 1;
+        onProgress?.(statusText, current, total);
+    };
+    // 1. Character plan — a compact list of slugs/names + the film's art style.
+    note("Identifying characters…");
+    const charPlan = await ask(MOVIE_STUDIO_CHARACTERS_PLAN_PROMPT, idea.trim());
+    const artStyle = toStr(charPlan?.artStyle) || "photo realistic render";
+    const charList = (Array.isArray(charPlan.characters) ? charPlan.characters : [])
+        .map((c) => ({ slug: toStr(c?.slug), name: toStr(c?.name) }))
+        .filter((c) => c.slug);
+    addTotal(charList.length);
+    // 2. Character details — one image prompt per character (agentic loop).
+    const characters = [];
+    for (const c of charList) {
+        advance(`Generating character image: ${c.name || c.slug}`);
+        const detail = await generateItem(CHARACTER_IMAGE_PROMPT, `Art style: ${artStyle}\n\nIdea: ${idea.trim()}\n\nCharacter slug: ${c.slug}\nCharacter name: ${c.name}`, { imagePrompt: "" });
+        characters.push({
+            slug: c.slug,
+            name: c.name,
+            imagePrompt: toStr(detail?.imagePrompt),
+        });
+    }
+    // 3. Place plan + details.
+    note("Identifying places…");
+    const placePlan = await ask(MOVIE_STUDIO_PLACES_PLAN_PROMPT, `Art style: ${artStyle}\n\nIdea: ${idea.trim()}\n\nCharacters:\n${JSON.stringify(characters.map((c) => ({ slug: c.slug, name: c.name })))}`);
+    const placeList = (Array.isArray(placePlan.places) ? placePlan.places : [])
+        .map((p) => ({ slug: toStr(p?.slug), name: toStr(p?.name) }))
+        .filter((p) => p.slug);
+    addTotal(placeList.length);
+    const places = [];
+    for (const p of placeList) {
+        advance(`Generating place image: ${p.name || p.slug}`);
+        const detail = await generateItem(PLACE_IMAGE_PROMPT, `Art style: ${artStyle}\n\nIdea: ${idea.trim()}\n\nPlace slug: ${p.slug}\nPlace name: ${p.name}`, { imagePrompt: "" });
+        places.push({
+            slug: p.slug,
+            name: p.name,
+            imagePrompt: toStr(detail?.imagePrompt),
+        });
+    }
+    // 4. Scene plan + details — one scene's full details per request.
+    note("Planning scenes…");
+    const scenePlan = await ask(MOVIE_STUDIO_SCENES_PLAN_PROMPT, `Art style: ${artStyle}\n\nIdea: ${idea.trim()}\n\nCharacters:\n${JSON.stringify(characters.map((c) => ({ slug: c.slug, name: c.name })))}\n\nPlaces:\n${JSON.stringify(places.map((p) => ({ slug: p.slug, name: p.name })))}`);
+    const sceneList = (Array.isArray(scenePlan.scenes) ? scenePlan.scenes : [])
+        .map((s) => ({
         slug: toStr(s?.slug),
         duration: toNum(s?.duration),
-        description: toStr(s?.description),
         characterSlugs: Array.isArray(s?.characterSlugs)
             ? s.characterSlugs.map(toStr).filter(Boolean)
             : [],
         placeSlug: toStr(s?.placeSlug),
-        scriptLines: Array.isArray(s?.scriptLines)
-            ? s.scriptLines.map((l) => ({
-                characterSlug: toStr(l?.characterSlug),
-                line: toStr(l?.line),
-            }))
-            : [],
-        voiceOver: toStr(s?.voiceOver),
-        imagePrompt: toStr(s?.imagePrompt),
-    }));
+    }))
+        .filter((s) => s.slug);
+    addTotal(sceneList.length);
+    const scenes = [];
+    for (const s of sceneList) {
+        advance(`Writing scene: ${s.slug}`);
+        const detail = await generateItem(SCENE_DETAIL_PROMPT, `Art style: ${artStyle}\n\nIdea: ${idea.trim()}\n\nCharacters:\n${JSON.stringify(characters.map((c) => ({ slug: c.slug, name: c.name })))}\n\nPlaces:\n${JSON.stringify(places.map((p) => ({ slug: p.slug, name: p.name })))}\n\nScene slug: ${s.slug}\nDuration: ${s.duration}s\nCharacter slugs: ${s.characterSlugs.join(", ")}\nPlace slug: ${s.placeSlug}`, { description: "", scriptLines: [], voiceOver: "", imagePrompt: "" });
+        scenes.push({
+            slug: s.slug,
+            duration: s.duration,
+            description: toStr(detail?.description),
+            characterSlugs: s.characterSlugs,
+            placeSlug: s.placeSlug,
+            scriptLines: Array.isArray(detail?.scriptLines)
+                ? detail.scriptLines
+                    .map((l) => ({
+                    characterSlug: toStr(l?.characterSlug),
+                    line: toStr(l?.line),
+                }))
+                    .filter((l) => l.line)
+                : [],
+            voiceOver: toStr(detail?.voiceOver),
+            imagePrompt: toStr(detail?.imagePrompt),
+        });
+    }
     // Persist the generated production bible to studio/:projectId/data/*.json
     const dataDir = movieStudioDataDir(projectId);
     ensureDir(dataDir);
@@ -684,7 +772,7 @@ export async function agentBackend({ app, getUvPath: _getUvPath, backendPort, })
         }
     });
     app.post("/api/movie-studio/state", (req, res) => {
-        const { projectId, idea, result, assets, videos, sceneImages } = req.body || {};
+        const { projectId, idea, result, assets, videos, sceneImages, renderedScenes, } = req.body || {};
         if (!projectId || !/^[a-zA-Z0-9_-]{1,64}$/.test(String(projectId))) {
             res.status(400).json({ error: "Invalid project ID" });
             return;
@@ -697,6 +785,7 @@ export async function agentBackend({ app, getUvPath: _getUvPath, backendPort, })
             assets: Array.isArray(assets) ? assets : [],
             videos: Array.isArray(videos) ? videos : [],
             sceneImages: Array.isArray(sceneImages) ? sceneImages : [],
+            renderedScenes: Array.isArray(renderedScenes) ? renderedScenes : [],
         }, null, 2), "utf-8");
         res.json({ ok: true });
     });

package/dist/backend/movie-backend/agent/tools/index.js

@@ -7,7 +7,6 @@ import removeFileTool from "./remove-file.js";
 import renameFileTool from "./rename-file.js";
 import grepFilesTool from "./grep-files.js";
 import showImageTool from "./show-image.js";
-import editImageTool from "./edit-image.js";
 import imageToVideoGenerationTool from "./image-to-video-generation.js";
 import textToVideoGenerationTool from "./text-to-video-generation.js";
 import stitchVideosTool from "./stitch-videos.js";
@@ -21,7 +20,6 @@ export const TOOLS = [
     renameFileTool,
     grepFilesTool,
     showImageTool,
-    editImageTool,
     imageToVideoGenerationTool,
     textToVideoGenerationTool,
     stitchVideosTool,

package/dist/backend/movie-backend/core.js

@@ -866,7 +866,7 @@ async function streamProcessOutput(readable, prefix, send) {
 //       "--model",
 //       "dgrauet/ltx-2.3-mlx-q4",
 //       "--prompt",
-//       `${JSON.stringify("No text on screen. a 5 years old cute lamb wanting to have a hug, he says: Hi! Thank you for using Lambobo Studio!")}`,
+//       `${JSON.stringify("No text on screen. a 5 years old cute lamb wanting to have a hug, he says: Hi! Thank you for using EffectNode Media!")}`,
 //       "--distilled",
 //       "--low-ram",
 //       "--frames",

package/dist/backend/movie-backend/generation-queue.d.ts

@@ -1,5 +1,5 @@
 import { type Application } from "express";
-export type QueueTaskType = "generate" | "render" | "render-assets" | "render-videos" | "render-scene-images" | "regenerate-asset" | "regenerate-video" | "regenerate-scene-image";
+export type QueueTaskType = "generate" | "render" | "render-assets" | "render-videos" | "render-scene-images" | "render-asset" | "render-scene-image" | "render-video" | "regenerate-asset" | "regenerate-video" | "regenerate-scene-image";
 export type QueueTaskStatus = "pending" | "running" | "completed" | "failed" | "cancelled" | "paused";
 export interface QueueTask {
     id: string;

package/dist/backend/movie-backend/generation-queue.js

@@ -1,4 +1,4 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
 import { randomUUID } from "node:crypto";
@@ -78,10 +78,18 @@ const sseClients = new Set();
 /** Push an event to every SSE client watching the given project. */
 function broadcast(projectId, event, data) {
     for (const client of sseClients) {
-        if (client.projectId !== projectId)
+        if (client.projectId !== null && client.projectId !== projectId)
             continue;
+        let payload = data;
+        // Global watchers need to know which project each task belongs to.
+        if (client.projectId === null &&
+            event === "task" &&
+            data &&
+            typeof data === "object") {
+            payload = { ...data, projectId };
+        }
         try {
-            client.res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+            client.res.write(`event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`);
         }
         catch {
             sseClients.delete(client);
@@ -130,6 +138,24 @@ function loadState(projectId) {
         void pump();
     return state;
 }
+/** Load every persisted project queue into memory so it is visible and resumed. */
+function loadAllStates() {
+    let entries = [];
+    try {
+        entries = existsSync(TASKS_DIR) ? readdirSync(TASKS_DIR) : [];
+    }
+    catch {
+        entries = [];
+    }
+    entries.sort();
+    for (const entry of entries) {
+        if (!isValidProjectId(entry))
+            continue;
+        if (!existsSync(queueFile(entry)))
+            continue;
+        loadState(entry);
+    }
+}
 function persist(projectId) {
     const state = queues.get(projectId);
     if (!state)
@@ -379,7 +405,9 @@ const handlers = {
             throw new Error("Idea is required");
         }
         ctx.log(`Planning production bible (characters → places → scenes)…\n`);
-        const result = await generateMovieStudioBible(ctx.projectId, idea.trim(), typeof model === "string" && model.trim() ? model.trim() : undefined);
+        const result = await generateMovieStudioBible(ctx.projectId, idea.trim(), typeof model === "string" && model.trim() ? model.trim() : undefined, (statusText, current, total) => {
+            ctx.update({ statusText, progress: { current, total } });
+        });
         ctx.log("Production bible ready.\n");
         return result;
     },
@@ -398,6 +426,78 @@ const handlers = {
         const { characters, places, scenes } = ctx.task.payload || {};
         return runFullRender(ctx, await getUvPath(), characters, places, scenes);
     },
+    // Generate a single character/place image, skipping if it already exists.
+    "render-asset": async (ctx) => {
+        const { kind, slug, prompt } = ctx.task.payload || {};
+        if (kind !== "character" && kind !== "place") {
+            throw new Error("kind must be 'character' or 'place'");
+        }
+        const s = slugify(slug);
+        const p = String(prompt || "").trim();
+        if (!s || !p)
+            throw new Error("slug and prompt are required");
+        const existing = existingOutput(ctx.projectId, `${kind}-${s}.png`);
+        if (existing) {
+            ctx.log(`Already generated: ${kind}-${s}.png — skipping\n`);
+            return { kind, slug: s, ...existing };
+        }
+        const r = await generateAssetImage(ctx.projectId, kind, s, p, ctx.log);
+        if ("error" in r)
+            throw new Error(r.error);
+        return {
+            kind,
+            slug: s,
+            filename: r.filename,
+            url: r.url,
+            updatedAt: Date.now(),
+        };
+    },
+    // Generate a single scene image, skipping if it already exists.
+    "render-scene-image": async (ctx) => {
+        const { scene } = ctx.task.payload || {};
+        if (!scene || typeof scene !== "object")
+            throw new Error("scene is required");
+        const s = slugify(scene?.slug);
+        if (!s)
+            throw new Error("Invalid scene slug");
+        const existing = existingOutput(ctx.projectId, `scene-${s}.png`);
+        if (existing) {
+            ctx.log(`Already generated: scene-${s}.png — skipping\n`);
+            return { slug: s, ...existing };
+        }
+        const r = await generateSceneImage(ctx.projectId, scene, ctx.log);
+        if ("error" in r)
+            throw new Error(r.error);
+        return {
+            slug: s,
+            filename: r.filename,
+            url: r.url,
+            updatedAt: Date.now(),
+        };
+    },
+    // Generate a single scene video, skipping if it already exists.
+    "render-video": async (ctx, getUvPath) => {
+        const { scene, characters } = ctx.task.payload || {};
+        if (!scene || typeof scene !== "object")
+            throw new Error("scene is required");
+        const s = slugify(scene?.slug);
+        if (!s)
+            throw new Error("Invalid scene slug");
+        const existing = existingOutput(ctx.projectId, `scene-${s}.mp4`);
+        if (existing) {
+            ctx.log(`Already generated: scene-${s}.mp4 — skipping\n`);
+            return { slug: s, ...existing };
+        }
+        const r = await generateSceneVideo(await getUvPath(), ctx.projectId, scene, Array.isArray(characters) ? characters : [], ctx.log);
+        if ("error" in r)
+            throw new Error(r.error);
+        return {
+            slug: s,
+            filename: r.filename,
+            url: r.url,
+            updatedAt: Date.now(),
+        };
+    },
     "regenerate-asset": async (ctx) => {
         const { kind, slug, prompt } = ctx.task.payload || {};
         if (kind !== "character" && kind !== "place") {
@@ -574,7 +674,12 @@ function syncToMovieStudioState(projectId, type, result) {
     if (type === "render-videos" || type === "render") {
         state.videos = Array.isArray(result?.videos) ? result.videos : state.videos ?? [];
     }
-    if (type === "regenerate-asset" && result) {
+    if (type === "render") {
+        state.renderedScenes = Array.isArray(result?.renderedScenes)
+            ? result.renderedScenes
+            : state.renderedScenes ?? [];
+    }
+    if ((type === "render-asset" || type === "regenerate-asset") && result) {
         const key = `${result.kind}:${result.slug}`;
         const arr = Array.isArray(state.assets) ? state.assets : [];
         state.assets = [
@@ -582,14 +687,15 @@ function syncToMovieStudioState(projectId, type, result) {
             result,
         ];
     }
-    if (type === "regenerate-video" && result) {
+    if ((type === "render-video" || type === "regenerate-video") && result) {
         const arr = Array.isArray(state.videos) ? state.videos : [];
         state.videos = [
             ...arr.filter((v) => v.slug !== result.slug),
             result,
         ];
     }
-    if (type === "regenerate-scene-image" && result) {
+    if ((type === "render-scene-image" || type === "regenerate-scene-image") &&
+        result) {
         const arr = Array.isArray(state.sceneImages) ? state.sceneImages : [];
         state.sceneImages = [
             ...arr.filter((i) => i.slug !== result.slug),
@@ -638,6 +744,18 @@ export function generationQueueSetup({ app, getUvPath, }) {
             paused: pausedProjects.has(projectId),
         });
     });
+    // List every task across all projects, each tagged with its project id.
+    app.get("/api/queue/all", (_req, res) => {
+        loadAllStates();
+        const tasks = [];
+        for (const [projectId, state] of queues) {
+            for (const t of state.tasks) {
+                tasks.push({ ...t, projectId });
+            }
+        }
+        tasks.sort((a, b) => a.createdAt - b.createdAt);
+        res.json({ tasks });
+    });
     // Read a project's persisted terminal log (tail, so large logs stay bounded).
     app.get("/api/logs", (req, res) => {
         const projectId = String(req.query.projectId ?? "");
@@ -663,7 +781,8 @@ export function generationQueueSetup({ app, getUvPath, }) {
     // Server-Sent Events: push queue/task and log updates to a watching client.
     app.get("/api/events", (req, res) => {
         const projectId = String(req.query.projectId ?? "");
-        if (!isValidProjectId(projectId)) {
+        const all = projectId === "*";
+        if (!all && !isValidProjectId(projectId)) {
             res.status(400).json({ error: "Invalid project ID" });
             return;
         }
@@ -674,7 +793,7 @@ export function generationQueueSetup({ app, getUvPath, }) {
             "X-Accel-Buffering": "no",
         });
         res.write(`event: hello\ndata: {}\n\n`);
-        const client = { res, projectId };
+        const client = { res, projectId: all ? null : projectId };
         sseClients.add(client);
         req.on("close", () => {
             sseClients.delete(client);