@hugpy/video-intelligence-ui 0.3.3 → 0.3.4

package/src/stations/studio/StudioMovieComposer.tsx

@@ -67,6 +67,7 @@ import {
 } from "../../video/contract";
 import { getSessionId } from "../../session";
 import { addToLibrary, useMediaLibrary } from "../../video/mediaLibrary";
+import { subscribeJobStream } from "../../video/jobStream";
 import { UnnamedWarnPanel, WarnUnnamedToggle, useWarnUnnamedPref } from "../../video/UnnamedWarn";
 import { LengthRow } from "../../video/LengthRow";
 import { GoalComposer } from "../GoalComposer";
@@ -109,6 +110,7 @@ import {
   type CoordinationReport,
 } from "../../video/coordinationReport";
 import { CoordinationBadge, CoordinationSummary, decisionKey } from "./coordinationBadge";
+import { planStudioSettings, planStudioMovie } from "../../video/studioOracle";
 // B3: the visual spliced row + branch-frame scrubber (the picture half). Pure math
 // lives in movieTimeline.ts; both are new files beside this composer.
 import { StudioSplicedRow, StudioPendingRow } from "./StudioSplicedRow";
@@ -316,6 +318,40 @@ interface GoalRow {
   frames: string;
 }
 
+/** A single Clip prompt promoted into the existing sequential Cinema composer. */
+export interface ClipSequenceDraft {
+  id: number;
+  prompt: string;
+  negative: string;
+  stdNegative: boolean;
+  startImage: MediaRef | null;
+  width: number;
+  height: number;
+  fps: number;
+  seed: number;
+  frames: string;
+  modelId: string;
+  steps: string;
+  cfg: string;
+  vramBudget: string;
+  project: string;
+  plannedSegments?: Array<{
+    prompt: string;
+    negative: string;
+    joint: "still" | "cut";
+    settings?: {
+      model_id?: string; steps?: number; cfg?: number;
+      seed?: number; frames?: number; width?: number;
+      height?: number; fps?: number;
+    };
+  }>;
+}
+
+interface CinemaImportBackup extends Omit<ClipSequenceDraft, "id" | "prompt" | "negative" | "stdNegative"> {
+  goals: GoalRow[];
+  movieTitle: string;
+}
+
 // The counter is SESSION-persisted (not a module `let`) now that the goal rows
 // themselves survive a reload: a module counter restarts at 0 while the restored
 // rows keep their old keys, so `goal_1` could be minted twice — and this key
@@ -342,6 +378,16 @@ const producerPlanSchema = z.object({
         negative: z.string().optional(),
         seconds: z.number(),
         joint: z.string(),
+        settings: z.object({
+          model_id: z.string().optional(),
+          width: z.number().optional(),
+          height: z.number().optional(),
+          fps: z.number().optional(),
+          frames: z.number().optional(),
+          steps: z.number().optional(),
+          cfg: z.number().optional(),
+          seed: z.number().optional(),
+        }).optional(),
       }),
     )
     .min(1),
@@ -391,13 +437,15 @@ function useStudioMovieJob(): StudioMovieJobApi {
   const [running, setRunning] = useState(false);
 
   const mounted = useRef(true);
-  const timer = useRef<number | null>(null);
+  // Unsubscribe from the shared job stream while this movie job runs (replaces
+  // the retired 2.5s poll interval — a transition re-reads on push).
+  const unsub = useRef<null | (() => void)>(null);
   const jobRef = useRef<string | null>(null);
 
   const stopPoll = useCallback(() => {
-    if (timer.current != null) {
-      window.clearInterval(timer.current);
-      timer.current = null;
+    if (unsub.current != null) {
+      unsub.current();
+      unsub.current = null;
     }
   }, []);
 
@@ -469,7 +517,8 @@ function useStudioMovieJob(): StudioMovieJobApi {
         jobRef.current = id;
         setStatus("queued");
         void poll();
-        timer.current = window.setInterval(() => void poll(), 2500);
+        if (unsub.current != null) unsub.current();
+        unsub.current = subscribeJobStream(() => void poll());
       });
     },
     [poll, stopPoll],
@@ -635,6 +684,9 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
     blankGoal(),
     blankGoal(),
   ]);
+  const [clipSequenceDraft, setClipSequenceDraft] = useSessionState<ClipSequenceDraft | null>(
+    "studio.movie.clipSequenceDraft", null,
+  );
   // Rows restored from a session written BEFORE the per-segment knob round
   // (2026-08-12) lack modelId/steps/cfg/contextFrames — normalize to the blank
   // ("inherit") value so `.trim()` never meets undefined. useMemo, not a write:
@@ -684,6 +736,26 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
   // surface's idiom. The movie route validates these at the movie level (studio_movie_schema
   // _check_steps_cfg: steps int [1,100], cfg number [0,20]) — mirrored in buildBody below.
   const [modelId, setModelId] = useSessionState("studio.movie.modelId", "");
+  const [settingsMode, setSettingsMode] = useSessionState<"oracle" | "manual">(
+    "studio.movie.settingsMode", "oracle",
+  );
+  const manualSettings = useSessionRef<string[]>("studio.movie.manualSettings", []);
+  const goalManualSettings = useSessionRef<Record<string, string[]>>(
+    "studio.movie.goalManualSettings", {},
+  );
+  const markManual = (field: string) => {
+    if (!manualSettings.current.includes(field)) {
+      manualSettings.current = [...manualSettings.current, field];
+    }
+  };
+  const markGoalManual = (key: string, field: string) => {
+    const current = goalManualSettings.current[key] || [];
+    if (!current.includes(field)) {
+      goalManualSettings.current = {
+        ...goalManualSettings.current, [key]: [...current, field],
+      };
+    }
+  };
   const [steps, setSteps] = useSessionState("studio.movie.steps", "");
   const [cfg, setCfg] = useSessionState("studio.movie.cfg", "");
   // MERGE-NOT-OVERWRITE bookkeeping — true once the OPERATOR has typed a budget. A
@@ -1151,6 +1223,77 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
   // "extend motion" stays that way as it grows. No upper cap: the count takes
   // any integer ≥ 1.
   const [goalStash, setGoalStash] = useSessionState<GoalRow[]>("studio.movie.goalStash", () => []);
+  const [clipImportBackup, setClipImportBackup] = useSessionState<CinemaImportBackup | null>(
+    "studio.movie.clipImportBackup", null,
+  );
+  const importedClipDraftRef = useRef<number | null>(null);
+  useEffect(() => {
+    const draft = clipSequenceDraft;
+    if (!draft || importedClipDraftRef.current === draft.id) return;
+    importedClipDraftRef.current = draft.id;
+    // A Clip import starts a new sequence. Preserve the previous Cinema draft
+    // separately so the goal-count stash cannot inject old rows into this one.
+    if (goalsRaw.some((g) => g.prompt.trim() !== "")) {
+      setClipImportBackup({ goals: goalsRaw, startImage, width, height, fps, seed,
+        frames: framesDefault, modelId, steps, cfg, vramBudget, project, movieTitle });
+    }
+    setGoals(draft.plannedSegments?.length
+      ? draft.plannedSegments.map((s, i) => ({
+          ...blankGoal(i === 0 ? "still" : s.joint),
+          prompt: s.prompt, negative: s.negative,
+          stdNegative: draft.stdNegative,
+          modelId: s.settings?.model_id || "",
+          steps: s.settings?.steps == null ? "" : String(s.settings.steps),
+          cfg: s.settings?.cfg == null ? "" : String(s.settings.cfg),
+          seed: s.settings?.seed == null ? "" : String(s.settings.seed),
+          frames: s.settings?.frames == null ? "" : String(s.settings.frames),
+        }))
+      : [
+          { ...blankGoal(), prompt: draft.prompt, negative: draft.negative,
+            stdNegative: draft.stdNegative },
+          blankGoal("still"),
+        ]);
+    setStartImage(draft.startImage);
+    setWidth(draft.width);
+    setHeight(draft.height);
+    setFps(draft.fps);
+    setSeed(draft.seed);
+    setFramesDefault(draft.frames);
+    setModelId(draft.modelId);
+    setSteps(draft.steps);
+    setCfg(draft.cfg);
+    setVramBudget(draft.vramBudget);
+    setProject(draft.project);
+    setMovieTitle(draft.project);
+    setFormMsg(draft.plannedSegments?.length
+      ? `Oracle generated ${draft.plannedSegments.length} sequential prompt cards. Review them, then Generate movie.`
+      : "Clip prompt is goal 1. Add the next prompt in goal 2; it continues from goal 1's last frame by default.");
+    setClipSequenceDraft(null);
+  }, [clipSequenceDraft, goalsRaw, startImage, width, height, fps, seed,
+      framesDefault, modelId, steps, cfg, vramBudget, project, movieTitle,
+      setClipSequenceDraft, setClipImportBackup, setGoals,
+      setStartImage, setWidth, setHeight, setFps, setSeed, setFramesDefault,
+      setModelId, setSteps, setCfg, setVramBudget, setProject, setMovieTitle]);
+
+  function restorePreviousCinemaDraft() {
+    const prior = clipImportBackup;
+    if (!prior) return;
+    setGoals(prior.goals);
+    setStartImage(prior.startImage);
+    setWidth(prior.width);
+    setHeight(prior.height);
+    setFps(prior.fps);
+    setSeed(prior.seed);
+    setFramesDefault(prior.frames);
+    setModelId(prior.modelId);
+    setSteps(prior.steps);
+    setCfg(prior.cfg);
+    setVramBudget(prior.vramBudget);
+    setProject(prior.project);
+    setMovieTitle(prior.movieTitle);
+    setClipImportBackup(null);
+    setFormMsg("Previous Cinema draft restored.");
+  }
 
   // ── 🎬 PRODUCER (k120 slice 1) — premise → /video/producer/plan → rows. ──
   // The plan's per-segment seconds convert to frames against the CURRENT movie
@@ -1171,13 +1314,17 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
     false,
   );
   const produceMovie = useCallback(async () => {
-    const p = premise.trim();
+    const p = premise.trim() || movieQuery.trim();
     if (!p || producing) return;
     setProducing(true);
     setProduceError(null);
     const res = await request<unknown>(hugpyConfig.producerPlanUrl, {
       method: "POST",
-      body: JSON.stringify({ premise: p }),
+      body: JSON.stringify({
+        premise: p,
+        model: assist.assistModel || undefined,
+        start_image: startImage?.uri,
+      }),
       headers: { "Content-Type": "application/json" },
       meta: { specKey: "studio", operation: "studio.producer.plan" },
     });
@@ -1197,23 +1344,34 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
       const joint: JointMode =
         i === 0
           ? "still"
-          : s.joint === "cut" || s.joint === "still" || s.joint === "vace_extend"
+          : s.joint === "cut" || s.joint === "still"
             ? (s.joint as JointMode)
-            : "vace_extend";
+            : "still";
       return {
         ...blankGoal(joint),
         prompt: s.prompt,
         negative: s.negative ?? "",
-        frames: String(Math.max(1, Math.round(s.seconds * effFps))),
+        modelId: s.settings?.model_id ?? "",
+        frames: String(s.settings?.frames ?? Math.max(1, Math.round(s.seconds * effFps))),
+        steps: s.settings?.steps == null ? "" : String(s.settings.steps),
+        cfg: s.settings?.cfg == null ? "" : String(s.settings.cfg),
+        seed: s.settings?.seed == null ? "" : String(s.settings.seed),
       };
     });
     if (goals.some((g) => g.prompt.trim() !== "")) {
       setGoalStash((st) => [...goals, ...st]);
     }
     setGoals(rows);
+    const first = plan.segments[0]?.settings;
+    if (first) {
+      if (first.width != null && !manualSettings.current.includes("width")) setWidth(first.width);
+      if (first.height != null && !manualSettings.current.includes("height")) setHeight(first.height);
+      if (first.fps != null && !manualSettings.current.includes("fps")) setFps(first.fps);
+    }
     setProducerNote([plan.title, plan.logline].filter(Boolean).join(" — "));
-    setContinuityRefresh(true);
-  }, [premise, producing, goals, fps]);
+    setContinuityRefresh(false);
+  }, [premise, movieQuery, producing, goals, fps, assist.assistModel, startImage,
+      setWidth, setHeight, setFps, setContinuityRefresh]);
 
   const setSegmentCount = useCallback(
     (n: number) => {
@@ -1328,6 +1486,42 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
   // name this ref minted may be replaced by the next Generate (operator
   // 2026-08-13: "purely a product of the same generation method").
   const autoTitleRef = useRef("");
+  const planGoalPrompt = useCallback(async (
+    i: number, text: string,
+    coordinated?: { seed?: number; frames?: number; joint_mode?: string },
+  ) => {
+    if (settingsMode !== "oracle") return;
+    const g = goals[i];
+    if (!g) return;
+    const capability = i === 0
+      ? (startImage ? "i2v" : "t2v")
+      : ((coordinated?.joint_mode || g.joint) === "cut" ? "t2v" : "i2v");
+    const explicit = [...new Set([
+      ...manualSettings.current,
+      ...(goalManualSettings.current[g.key] || []),
+      ...(coordinated?.seed != null ? ["seed"] : []),
+      ...(coordinated?.frames != null ? ["frames"] : []),
+    ])];
+    const planned = await planStudioSettings(capability, text, {
+      model_id: g.modelId || undefined,
+      width, height, fps,
+      frames: coordinated?.frames ?? (g.frames ? Number(g.frames) : framesDefault ? Number(framesDefault) : undefined),
+      steps: g.steps ? Number(g.steps) : steps ? Number(steps) : undefined,
+      cfg: g.cfg ? Number(g.cfg) : cfg ? Number(cfg) : undefined,
+      seed: coordinated?.seed ?? (g.seed ? Number(g.seed) : seed),
+    }, explicit);
+    setGoalField(i, {
+      modelId: planned.model_id || "",
+      frames: planned.frames == null ? g.frames : String(planned.frames),
+      steps: planned.steps == null ? g.steps : String(planned.steps),
+      cfg: planned.cfg == null ? g.cfg : String(planned.cfg),
+      seed: planned.seed == null ? g.seed : String(planned.seed),
+    });
+    if (planned.width != null) setWidth(planned.width);
+    if (planned.height != null) setHeight(planned.height);
+    if (planned.fps != null) setFps(planned.fps);
+  }, [settingsMode, goals, startImage, width, height, fps, framesDefault, steps, cfg,
+      seed, setGoalField, setWidth, setHeight, setFps]);
 
   const runRowAssist = useCallback(
     (i: number, mode: "detail" | "generate") => {
@@ -1335,10 +1529,14 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
       if (!g) return;
       void (async () => {
         let fresh = "";
-        await assist.runAssist(mode, g.prompt, (p) => {
+        await assist.runAssist(mode, mode === "generate" ? "" : g.prompt, (p) => {
           fresh = p;
           setGoalField(i, { prompt: p });
         }, { context: rowContext(i) });
+        if (fresh.trim() && settingsMode === "oracle") {
+          try { await planGoalPrompt(i, fresh); }
+          catch (err) { setFormMsg(err instanceof Error ? err.message : "Oracle planning failed."); }
+        }
         if (mode !== "generate" || !fresh.trim()) return;
         // NEGATIVE RIDES ALONG (operator 2026-08-13): the generated exclusion
         // list APPENDS to this goal's typed negative, never clobbers it
@@ -1371,7 +1569,8 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
       intentText.current[g.key] = "";
       setIntents((prev) => ({ ...prev, [g.key]: null }));
     },
-    [assist, goals, rowContext, setGoalField, movieTitle, setMovieTitle],
+    [assist, goals, rowContext, setGoalField, movieTitle, setMovieTitle,
+      settingsMode, planGoalPrompt],
   );
 
   // ── negative generation (§1b) — an exclusion list for THIS shot ──
@@ -1444,6 +1643,25 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
         };
       }),
     );
+    let oracleNotice: string | null = null;
+    if (settingsMode === "oracle") {
+      for (const key of applied) {
+        const index = goals.findIndex((g) => g.key === key);
+        const hit = bySeg.get(key);
+        if (index < 0 || !hit) continue;
+        try {
+          const k = hit.knobs || {};
+          await planGoalPrompt(index, hit.prompt, {
+            seed: typeof k.seed === "number" ? k.seed : undefined,
+            frames: typeof k.frames === "number" ? k.frames : undefined,
+            joint_mode: typeof k.joint_mode === "string" ? k.joint_mode : undefined,
+          });
+        } catch (err) {
+          oracleNotice = err instanceof Error ? err.message : "Oracle planning failed.";
+          break;
+        }
+      }
+    }
     for (const key of applied) {
       intentText.current[key] = "";
     }
@@ -1458,7 +1676,10 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
     // this one.
     setCoordination(readCoordinationReport(res.coordination));
     setCoordSettled(new Set());
-    setSpreadNotice(spreadNoticeLines(res, applied));
+    setSpreadNotice([
+      ...spreadNoticeLines(res, applied),
+      ...(oracleNotice ? [`Oracle settings: ${oracleNotice}`] : []),
+    ]);
   }, [
     assist,
     goalInputs,
@@ -1470,6 +1691,8 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
     selectedKeys,
     selectedProfile,
     steeringSeed,
+    settingsMode,
+    planGoalPrompt,
   ]);
 
   // ── GROUP ACTION: negatives for the selected rows ──
@@ -1655,6 +1878,8 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
     });
 
     const body: Record<string, unknown> = {
+      settings_mode: settingsMode,
+      explicit_settings: manualSettings.current,
       resolution: { width, height, fps },
       frames: framesDefNum,
       seed,
@@ -1690,7 +1915,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
       continuity_refresh: continuityRefresh || undefined,
     };
     return { body };
-  }, [goals, width, height, fps, seed, vramBudget, modelId, steps, cfg, negative, project, movieTitle, startImage, references, selectedProfile, continuityRefresh]);
+  }, [goals, width, height, fps, seed, vramBudget, modelId, steps, cfg, negative, project, movieTitle, startImage, references, selectedProfile, continuityRefresh, settingsMode]);
 
   // NAME NUDGE (k91) — set when a submit was held back only because the movie has no
   // name. It is a warning, not a gate: the run row then offers "Generate without a
@@ -1701,7 +1926,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
   const [warnUnnamed, setWarnUnnamed] = useWarnUnnamedPref("cinema");
 
   const onGenerate = useCallback(
-    (skipNameCheck = false, titleOverride?: string) => {
+    async (skipNameCheck = false, titleOverride?: string) => {
       const built = buildBody(titleOverride);
       if ("err" in built) {
         setFormMsg(built.err);
@@ -1718,9 +1943,36 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
       setNameWarn(false);
       setFormMsg(null);
       if (titleOverride && titleOverride.trim()) setMovieTitle(titleOverride.trim());
-      job.run(built.body);
+      let body = built.body;
+      if (settingsMode === "oracle") {
+        try {
+          body = await planStudioMovie(body);
+          const resolution = body.resolution as { width?: number; height?: number; fps?: number } | undefined;
+          if (resolution?.width != null) setWidth(resolution.width);
+          if (resolution?.height != null) setHeight(resolution.height);
+          if (resolution?.fps != null) setFps(resolution.fps);
+          const plannedGoals = body.goals as Array<Record<string, unknown>> | undefined;
+          if (plannedGoals) setGoals((prev) => prev.map((g, i) => {
+            const p = plannedGoals[i];
+            if (!p) return g;
+            return {
+              ...g,
+              modelId: typeof p.model_id === "string" ? p.model_id : g.modelId,
+              steps: typeof p.steps === "number" ? String(p.steps) : g.steps,
+              cfg: typeof p.cfg === "number" ? String(p.cfg) : g.cfg,
+              seed: typeof p.seed === "number" ? String(p.seed) : g.seed,
+              frames: typeof p.frames === "number" ? String(p.frames) : g.frames,
+            };
+          }));
+        } catch (err) {
+          setFormMsg(err instanceof Error ? err.message : "Oracle planning failed.");
+          return;
+        }
+      }
+      job.run(body);
     },
-    [buildBody, job, movieTitle, setMovieTitle, warnUnnamed],
+    [buildBody, job, movieTitle, setMovieTitle, warnUnnamed, settingsMode,
+      setWidth, setHeight, setFps, setGoals],
   );
 
   // SESSION LIBRARY PUSH (operator 2026-08-13): a finished movie's outputs
@@ -1920,9 +2172,12 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           className="vi-knob-select"
           value={modelId}
           disabled={disableSubmit}
-          onChange={(e) => setModelId(e.target.value)}
+          onChange={(e) => { markManual("model_id"); setModelId(e.target.value); }}
         >
           <option value="">Auto — router picks by capability/budget</option>
+          {modelId && !STUDIO_MODEL_IDS.includes(modelId) && (
+            <option value={modelId}>{modelId} · current bound model</option>
+          )}
           {movieModels.length > 0 && (
             <optgroup label="Bound by a ratified movie segment">
               {movieModels.map((id) => (
@@ -1973,7 +2228,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           value={steps}
           placeholder="model default"
           disabled={disableSubmit}
-          onChange={(e) => setSteps(e.target.value)}
+          onChange={(e) => { markManual("steps"); setSteps(e.target.value); }}
         />
       </div>
       <div className="vi-knob">
@@ -1988,7 +2243,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           value={cfg}
           placeholder="model default"
           disabled={disableSubmit}
-          onChange={(e) => setCfg(e.target.value)}
+          onChange={(e) => { markManual("cfg"); setCfg(e.target.value); }}
         />
       </div>
 
@@ -2004,7 +2259,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           step={8}
           value={width}
           disabled={disableSubmit}
-          onChange={(e) => setWidth(Number(e.target.value) || 0)}
+          onChange={(e) => { markManual("width"); setWidth(Number(e.target.value) || 0); }}
         />
       </div>
       <div className="vi-knob">
@@ -2017,7 +2272,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           step={8}
           value={height}
           disabled={disableSubmit}
-          onChange={(e) => setHeight(Number(e.target.value) || 0)}
+          onChange={(e) => { markManual("height"); setHeight(Number(e.target.value) || 0); }}
         />
       </div>
       <div className="vi-knob">
@@ -2035,7 +2290,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
               ? `Ratified movie envelope: ${movieGeometry.width}×${movieGeometry.height} @ ${movieGeometry.fps}fps (“${movieGeometry.presetTitle}”).`
               : undefined
           }
-          onChange={(e) => setFps(Number(e.target.value) || 0)}
+          onChange={(e) => { markManual("fps"); setFps(Number(e.target.value) || 0); }}
         />
         {movieGeomOutOfEnvelope && (
           <span className="vi-knob-flag">
@@ -2056,7 +2311,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
           min={0}
           value={seed}
           disabled={disableSubmit}
-          onChange={(e) => setSeed(Number(e.target.value) || 0)}
+          onChange={(e) => { markManual("seed"); setSeed(Number(e.target.value) || 0); }}
         />
         <span className="vi-knob-hint">A segment with no seed uses base seed + its index.</span>
       </div>
@@ -2101,6 +2356,12 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
 
   return (
     <div className="vi-studio-generate">
+      {clipImportBackup && (
+        <button type="button" className="vi-btn vi-btn-sm vi-btn-ghost"
+                onClick={restorePreviousCinemaDraft}>
+          Restore previous Cinema draft
+        </button>
+      )}
       {/* The movie Settings panel lives in the left-sidebar Settings tab (portaled into
           settingsHost, like the Clip surface's knobGrid): templates + model pin + sampler
           + geometry/seed/budget/project; null until that panel mounts. */}
@@ -2147,6 +2408,15 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
              miss (and absent when no host mounts). This expander mirrors the
              SAME state — two views, one truth, like the Clip card. ── */}
       <PromptCardSettings label="movie settings — model · size · fps · steps · cfg · budget">
+        <div className="vi-knob vi-studio-knob-wide">
+          <label htmlFor="vi-movie-settings-mode">settings</label>
+          <select id="vi-movie-settings-mode" className="vi-knob-select"
+                  value={settingsMode}
+                  onChange={(e) => setSettingsMode(e.target.value as "oracle" | "manual")}>
+            <option value="oracle">Oracle-generated (default)</option>
+            <option value="manual">Manual</option>
+          </select>
+        </div>
         <div className="vi-knob vi-studio-knob-wide" style={{ minWidth: "16rem" }}>
           <label htmlFor="vi-moviecol-model">model — whole movie</label>
           <select
@@ -2154,9 +2424,12 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
             className="vi-knob-select"
             value={modelId}
             disabled={disableSubmit}
-            onChange={(e) => setModelId(e.target.value)}
+            onChange={(e) => { markManual("model_id"); setModelId(e.target.value); }}
           >
             <option value="">Auto — router picks by capability/budget</option>
+            {modelId && !STUDIO_MODEL_IDS.includes(modelId) && (
+              <option value={modelId}>{modelId} · current bound model</option>
+            )}
             {movieModels.length > 0 && (
               <optgroup label="Bound by a ratified movie segment">
                 {movieModels.map((id) => (
@@ -2176,12 +2449,12 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
         <div className="vi-knob" style={{ maxWidth: "7rem" }}>
           <label htmlFor="vi-moviecol-width">width</label>
           <input id="vi-moviecol-width" className="vi-knob-input" type="number" min={64} step={8}
-                 value={width} onChange={(e) => setWidth(Number(e.target.value) || 0)} />
+                 value={width} onChange={(e) => { markManual("width"); setWidth(Number(e.target.value) || 0); }} />
         </div>
         <div className="vi-knob" style={{ maxWidth: "7rem" }}>
           <label htmlFor="vi-moviecol-height">height</label>
           <input id="vi-moviecol-height" className="vi-knob-input" type="number" min={64} step={8}
-                 value={height} onChange={(e) => setHeight(Number(e.target.value) || 0)} />
+                 value={height} onChange={(e) => { markManual("height"); setHeight(Number(e.target.value) || 0); }} />
         </div>
         {/* LENGTH ROW (operator 2026-08-13): fps | frames/segment | seconds —
             any two set the third; dimmed = derived, last-touched wins. This is
@@ -2189,20 +2462,20 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
         <LengthRow
           idPrefix="vi-moviecol-len"
           fps={fps}
-          onFps={(n) => setFps(n)}
+          onFps={(n) => { markManual("fps"); setFps(n); }}
           frames={framesDefault}
-          onFrames={setFramesDefault}
+          onFrames={(v) => { markManual("frames"); setFramesDefault(v); }}
           framesPlaceholder="model default (81) / segment"
         />
         <div className="vi-knob" style={{ maxWidth: "7rem" }}>
           <label htmlFor="vi-moviecol-steps">steps</label>
           <input id="vi-moviecol-steps" className="vi-knob-input" type="number" min={1} max={100}
-                 value={steps} placeholder="model default" onChange={(e) => setSteps(e.target.value)} />
+                 value={steps} placeholder="model default" onChange={(e) => { markManual("steps"); setSteps(e.target.value); }} />
         </div>
         <div className="vi-knob" style={{ maxWidth: "7rem" }}>
           <label htmlFor="vi-moviecol-cfg">cfg</label>
           <input id="vi-moviecol-cfg" className="vi-knob-input" type="number" min={0} max={20} step={0.5}
-                 value={cfg} placeholder="model default" onChange={(e) => setCfg(e.target.value)} />
+                 value={cfg} placeholder="model default" onChange={(e) => { markManual("cfg"); setCfg(e.target.value); }} />
         </div>
         <div className="vi-knob" style={{ maxWidth: "9rem" }}>
           <label htmlFor="vi-moviecol-vram">VRAM budget GB</label>
@@ -2237,7 +2510,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
               className="vi-knob-input"
               rows={2}
               style={{ flex: "1 1 24rem", resize: "vertical" }}
-              placeholder="Premise / logline — the producer writes the whole script: segments, prompts, lengths, joins"
+              placeholder="Describe the whole production — Oracle creates the needed sequential prompt cards and settings"
               value={premise}
               onChange={(e) => setPremise(e.target.value)}
               disabled={producing}
@@ -2245,25 +2518,24 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
             <button
               type="button"
               className="vi-btn vi-btn-accent"
-              disabled={producing || premise.trim() === ""}
+              disabled={producing || (premise.trim() === "" && movieQuery.trim() === "")}
               onClick={() => void produceMovie()}
               title="Generate a full script from the premise: segment count, per-segment prompts, negatives, lengths and joins. Current rows are parked in the stash."
             >
-              {producing ? "Producing…" : "🎬 Produce"}
+              {producing ? "Generating production…" : "✨ Generate production"}
             </button>
           </div>
           <label
             className="vi-comfy-hint"
             style={{ display: "inline-flex", alignItems: "center", gap: "0.35rem" }}
-            title="During the render, a vision model reads the frame each segment actually ended on and a text model rewrites the next segment's prompt to open from that state — true segment-to-segment continuity. Advisory: any failure keeps the authored prompt."
+              title="Render-time continuity refresh is not yet available on the orbit route. The default still joint continues from the previous last frame."
           >
             <input
               type="checkbox"
-              checked={continuityRefresh}
-              onChange={(e) => setContinuityRefresh(e.target.checked)}
+              checked={false}
+              disabled
             />
-            continuity refresh — rewrite each next segment from the previous segment's rendered
-            last frame
+            render-time continuity refresh unavailable; still joints carry the last frame
           </label>
           {producerNote ? <span className="vi-knob-hint">{producerNote}</span> : null}
           {produceError ? (
@@ -2831,7 +3103,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
                   min={0}
                   value={g.seed}
                   placeholder="movie seed + index"
-                  onChange={(e) => setGoalField(i, { seed: e.target.value })}
+                  onChange={(e) => { markGoalManual(g.key, "seed"); setGoalField(i, { seed: e.target.value }); }}
                 />
               </div>
               <div className="vi-knob" style={{ maxWidth: "16rem" }}>
@@ -2840,11 +3112,14 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
                   id={`vi-movie-goalmodel-${g.key}`}
                   className="vi-knob-select"
                   value={g.modelId}
-                  onChange={(e) => setGoalField(i, { modelId: e.target.value })}
+                  onChange={(e) => { markGoalManual(g.key, "model_id"); setGoalField(i, { modelId: e.target.value }); }}
                 >
                   <option value="">
                     {modelId.trim() ? `Inherit — ${modelId.trim()}` : "Inherit — router picks"}
                   </option>
+                  {g.modelId && !STUDIO_MODEL_IDS.includes(g.modelId) && (
+                    <option value={g.modelId}>{g.modelId} · current bound model</option>
+                  )}
                   {movieModels.length > 0 && (
                     <optgroup label="Bound by a ratified movie segment">
                       {movieModels.map((id) => (
@@ -2880,7 +3155,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
                   max={100}
                   value={g.steps}
                   placeholder={steps.trim() || "inherit"}
-                  onChange={(e) => setGoalField(i, { steps: e.target.value })}
+                  onChange={(e) => { markGoalManual(g.key, "steps"); setGoalField(i, { steps: e.target.value }); }}
                 />
                 <span className="vi-knob-hint">1–100 · blank = movie/model default</span>
               </div>
@@ -2895,7 +3170,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
                   step={0.5}
                   value={g.cfg}
                   placeholder={cfg.trim() || "inherit"}
-                  onChange={(e) => setGoalField(i, { cfg: e.target.value })}
+                  onChange={(e) => { markGoalManual(g.key, "cfg"); setGoalField(i, { cfg: e.target.value }); }}
                 />
                 <span className="vi-knob-hint">0–20 · blank = movie/model default</span>
               </div>
@@ -2906,7 +3181,7 @@ export function StudioMovieComposer({ settingsHost }: StudioMovieComposerProps =
                 fps={fps}
                 fpsFixedReason="Movie-level — one fps per movie; change it in movie settings above."
                 frames={g.frames}
-                onFrames={(v) => setGoalField(i, { frames: v })}
+                onFrames={(v) => { markGoalManual(g.key, "frames"); setGoalField(i, { frames: v }); }}
                 framesPlaceholder={framesDefault.trim() || "movie default (81)"}
               />
               {Number(g.frames.trim() || framesDefault.trim()) > MODEL_FRAME_CEILING && (