@hugpy/video-intelligence-ui 0.3.3 → 0.3.5

package/src/stations/studio/StudioGenerateTab.tsx

@@ -13,9 +13,8 @@
 // uniform panel:
 //
 //   • t2v shape       — image inputs are hidden entirely (text-only note);
-//   • i2v "needs a start image" shape — the START IMAGE input becomes the dominant
-//     element near the top, with the source-clip picker offered as the "or extend a
-//     clip" alternative;
+//   • i2v shape — the prompt card accepts an optional start image, and the
+//     source-clip picker offers extension from a clip;
 //   • v2v (restyle) shape — the SOURCE CLIP picker gets that hero prominence;
 //   • id_lock (identity lock) shape — the REFERENCE-IMAGE slot list (1–4, ordered) is
 //     the dominant accent-bordered element, with an OPTIONAL composition-control input
@@ -28,7 +27,7 @@
 // Every affordance reuses an EXISTING pattern: presets from useStudioPresets; the
 // image UPLOAD path is the Generate station's upload→ingest→guard-kind flow
 // (POST /uploads → POST /video/ingest → MediaRef) and the hero drop surface is the
-// shared DropReceptacle; the LIBRARY pick reads useMediaLibrary; the source-clip pick
+// prompt-card file input; the LIBRARY pick reads useMediaLibrary; the source-clip pick
 // reads the plane's clip list; "Send to Studio" / "use as source" staging arrives via
 // studioBridge as the `source` prop; the enqueue body uses the exact route field names,
 // dropped by JSON.stringify when unset.
@@ -52,8 +51,8 @@ import { addToLibrary, useMediaLibrary } from "../../video/mediaLibrary";
 import { UnnamedWarnPanel, WarnUnnamedToggle, useWarnUnnamedPref, deriveNameFrom } from "../../video/UnnamedWarn";
 import { LengthRow } from "../../video/LengthRow";
 import { enqueueResultSchema, mediaRefSchema, uploadResultSchema } from "../../video/contract";
+import { trackJob, useJobTracker } from "../../video/jobTracker";
 import type { MediaRef } from "../../video/contract";
-import { DropReceptacle } from "../../video/DropReceptacle";
 import type { GoalComposerAttach, GoalComposerAttached } from "../GoalComposer";
 import { usePromptAssist } from "../../video/usePromptAssist";
 import { PromptAssistButtons } from "../../video/PromptAssistButtons";
@@ -80,7 +79,7 @@ import {
 } from "./studioShared";
 // B2: the Movie authoring surface the mode switch renders. Self-contained (owns its
 // own goal state, enqueue + poll, and playback) — see StudioMovieComposer.tsx.
-import { StudioMovieComposer } from "./StudioMovieComposer";
+import { StudioMovieComposer, type ClipSequenceDraft } from "./StudioMovieComposer";
 // IDENTITY PROFILES (stage a): the shared "Identity" control block (From profile /
 // Save as identity profile) — one additive row in the reference area below.
 import { IdentityProfileControls, type SelectedProfile } from "./IdentityProfileControls";
@@ -97,6 +96,7 @@ import { AboutExpander, PromptCard, PromptCardSettings, PromptFieldTabs, compose
 // authoritative, and every consumer below falls back to its prior list while
 // `renderLoaded` is false, so a slow discovery GET can never empty a picker.
 import { useRenderPresets } from "../../video/useRenderPresets";
+import { planStudioSettings, type OracleSettings } from "../../video/studioOracle";
 import {
   CLIP_CAPABILITIES,
   MOVIE_CAPABILITY,
@@ -165,6 +165,7 @@ export interface StudioGenerateSurfaceProps {
    *  its own internal switcher + useState. "movie" is the Cinema surface (label only — the
    *  wire/tester value stays "movie"). */
   lockedSurfaceMode?: "clip" | "movie";
+  onSelectSurfaceMode?: (mode: "clip" | "movie") => void;
 }
 
 // Labels now come from renderCompat (ONE table both studio surfaces read) so a
@@ -243,6 +244,7 @@ export function StudioGenerateSurface({
   onEnqueued,
   settingsHost,
   lockedSurfaceMode,
+  onSelectSurfaceMode,
 }: StudioGenerateSurfaceProps) {
   // ── SUB-TAB INPUT MEMORY (operator ask 2026-08-06) ──────────────────────────
   // Every OPERATOR-AUTHORED field below is `useSessionState` rather than
@@ -264,10 +266,13 @@ export function StudioGenerateSurface({
     "clip",
   );
   const surfaceMode = lockedSurfaceMode ?? internalSurfaceMode;
+  const [, setClipSequenceDraft] = useSessionState<ClipSequenceDraft | null>(
+    "studio.movie.clipSequenceDraft", null,
+  );
 
   const [capability, setCapability] = useSessionState<Capability>(
     "studio.clip.capability",
-    "i2v",
+    "t2v",
   );
   const [presetId, setPresetId] = useSessionState("studio.clip.presetId", "");
 
@@ -295,6 +300,15 @@ export function StudioGenerateSurface({
   const [steps, setSteps] = useSessionState("studio.clip.steps", "");
   const [cfg, setCfg] = useSessionState("studio.clip.cfg", "");
   const [modelId, setModelId] = useSessionState("studio.clip.modelId", "");
+  const [settingsMode, setSettingsMode] = useSessionState<"oracle" | "manual">(
+    "studio.clip.settingsMode", "oracle",
+  );
+  const manualSettings = useSessionRef<string[]>("studio.clip.manualSettings", []);
+  const markManual = (field: string) => {
+    if (!manualSettings.current.includes(field)) {
+      manualSettings.current = [...manualSettings.current, field];
+    }
+  };
   // Showroom flavor (?demo=1 only): open with a cinematic example prompt (matches
   // the sunset sample gens) so the brochure's Studio surface tells a coherent story
   // out of the box. Seed lives in src/demo/ and is injected ONLY behind isCanned() —
@@ -310,11 +324,13 @@ export function StudioGenerateSurface({
   // k89: the bottom "[▸ Tester]" collapsible that now hosts the cross-model sweep
   // (the run row's ghost 🧪 button is retired).
   const [clipTesterOpen, setClipTesterOpen] = useState(false);
+  const [sequenceMsg, setSequenceMsg] = useState<string | null>(null);
+  const [produceBusy, setProduceBusy] = useState(false);
   // LLM PROMPT-ASSIST (Enhance / Generate) — the same shared hook + button cluster the
   // Generate station uses (POSTs promptAssistUrl). Here the draft is the single clip
   // prompt and apply replaces it wholesale. context.kind = "scene" (a clip is a short
   // motion sequence, so the assistant leans into camera/motion phrasing).
-  const assist = usePromptAssist({ kind: "scene", specKey: "studio" });
+  const assist = usePromptAssist({ kind: "clip", specKey: "studio" });
   // Optional human PROJECT name (choose-or-type). Threaded into the enqueue as
   // `project` (auto-archive NAME); blank = auto-named (the default). The list of
   // existing names backs the Settings datalist; free-typing a new one creates it.
@@ -393,6 +409,11 @@ export function StudioGenerateSurface({
 
   const [genBusy, setGenBusy] = useState(false);
   const [genMsg, setGenMsg] = useState<string | null>(null);
+  const [activeClipJobId, setActiveClipJobId] = useSessionState<string | null>(
+    "studio.clip.activeJobId", null,
+  );
+  const clipJobs = useJobTracker();
+  const activeClipJob = clipJobs.find((row) => row.jobId === activeClipJobId);
 
   // STUDIO TESTER (operator 2026-08-05) — fan the CURRENT prompt across every
   // servable model of this surface's type (clip/movie) via POST studioTesterUrl.
@@ -486,6 +507,27 @@ export function StudioGenerateSurface({
   const isV2V = capability === "v2v";
   const isIdLock = capability === "id_lock";
   const isMotion = capability === "motion";
+  const clipRoute = isI2V && (startImages[0] || source?.uri || source?.asset_id) ? "i2v" : isI2V ? "t2v" : capability;
+  const oraclePlan = async (text: string): Promise<OracleSettings> => {
+    if (clipRoute !== "t2v" && clipRoute !== "i2v") {
+      throw new Error("Oracle has no executable model for this Clip capability.");
+    }
+    const planned = await planStudioSettings(clipRoute, text, {
+      model_id: modelId || undefined, width, height, fps,
+      frames: requestedFrames === "" ? undefined : Number(requestedFrames),
+      steps: steps === "" ? undefined : Number(steps),
+      cfg: cfg === "" ? undefined : Number(cfg), seed,
+    }, manualSettings.current);
+    if (planned.model_id != null) setModelId(planned.model_id);
+    if (planned.width != null) setWidth(planned.width);
+    if (planned.height != null) setHeight(planned.height);
+    if (planned.fps != null) setFps(planned.fps);
+    if (planned.frames != null) setRequestedFrames(String(planned.frames));
+    if (planned.steps != null) setSteps(String(planned.steps));
+    if (planned.cfg != null) setCfg(String(planned.cfg));
+    if (planned.seed != null) setSeed(planned.seed);
+    return planned;
+  };
 
   // ── the fleet's measured render table + everything derived from it ───────────────
   // One session-cached GET shared with the Movie composer (module singleton in the
@@ -938,19 +980,16 @@ export function StudioGenerateSurface({
 
   // ── required-input gate + preformed SHAPE ──
   // v2v: a source clip is REQUIRED (nothing to repaint otherwise) — always the hero.
-  // i2v with a requires_source preset: a START IMAGE or a SOURCE CLIP (extend) is
-  //   required — the start image is the hero, the source clip the alternative.
+  // i2v offers a start image; without one the orbit route uses text-to-video.
   // id_lock: >=1 REFERENCE image is required (the route 400s otherwise) — reference
   //   slots are the hero; the composition control is optional + both-or-neither.
   // t2v / synthetic i2v / custom: no required input; inputs stay inline + optional.
-  const presetNeedsInput = preset?.requires_source === true;
   const hasImage = startImages.length > 0;
   const hasSource = !!source;
   const hasReference = referenceImages.length > 0;
   const canAddImage = startImages.length < MAX_START_IMAGES;
   const canAddReference = referenceImages.length < MAX_REFERENCE_IMAGES;
   const needSource = isV2V;
-  const needImageOrSource = isI2V && presetNeedsInput;
   const needReference = isIdLock;
   // MOTION requires a control still and it IS the capability — the exact mirror of
   // id_lock's reference rule (video_routes: "a motion request with no control carries NO
@@ -966,40 +1005,26 @@ export function StudioGenerateSurface({
   const controlAndSource = isMotion && hasControl && hasSource;
   const missingRequired =
     (needSource && !hasSource) ||
-    (needImageOrSource && !hasImage && !hasSource) ||
     (needReference && !hasReference) ||
     (needControl && !hasControl) ||
     controlAndSource ||
     controlHalfSet;
 
-  const hero: "start-image" | "source" | "reference" | "control" | null = isMotion
+  const hero: "source" | "reference" | "control" | null = isMotion
     ? "control"
     : isIdLock
       ? "reference"
       : isV2V
         ? "source"
-        : needImageOrSource
-          ? "start-image"
-          : null;
-  const startImageAttention = needImageOrSource && !hasImage && !hasSource;
+        : null;
   const sourceAttention =
-    (needSource && !hasSource) || (needImageOrSource && !hasImage && !hasSource);
+    needSource && !hasSource;
   const referenceAttention = needReference && !hasReference;
 
   // ── Composer attach idiom (operator ask 2026-07-11, option A) ──
-  // The prompt composer's inline attach toolbar + chips and the hero shape editor below
-  // are TWO ACCESS PATHS TO THE SAME STATE — one source of truth, two views. We adopt
-  // GoalComposer's documented attach idiom (attachments = toolbar buttons, attached =
-  // removable chips) and wire its callbacks to THIS file's OWN pickers / MediaRef flows,
-  // offering only the inputs the ACTIVE shape accepts (mirroring the render* predicates
-  // above). The buttons open the SAME `showLibPicker` / `showSourcePicker` the hero uses,
-  // so the library pick routes to start (i2v) or reference (v2v / id_lock) exactly as the
-  // hero's own lib-picker routing does; the chips reflect the SAME startImages / source /
-  // referenceImages / controlImage state the hero renders, and reuse the hero's existing
-  // removes. Applicability decides whether a button EXISTS (t2v gets no toolbar — omitted
-  // cleanly by GoalComposer when the array is empty); capacity decides whether it is
-  // DISABLED (a filled slot mirrors the hero's "you're at the cap" note, not a vanished
-  // affordance). The negative composer stays plain.
+  // The prompt card owns the start-image upload, library pick, and removable chip.
+  // Other route-specific inputs use their existing pickers below. All callbacks
+  // update the same MediaRef state consumed by the enqueue route.
   //
   // 2026-07-29: these three are no longer hand-written capability unions — they are the
   // route's own input gates, transcribed once in renderCompat's ACCEPTS matrix and read
@@ -1103,7 +1128,7 @@ export function StudioGenerateSurface({
             ? "Composition control is both-or-neither — add a control image AND a kind, or clear both."
             : needSource && !hasSource
               ? "Restyle (v2v) needs a source clip — add one above."
-              : "This generator needs a start image (or a source clip to extend) — add one above.";
+              : "Add the required input above.";
 
   // v2v stays a HARD block (the router refuses an out-of-envelope restyle outright). The
   // envelope itself is now the ratified preset's rather than a mirrored constant.
@@ -1190,14 +1215,18 @@ export function StudioGenerateSurface({
       // on motion (required, definitional) — `slots.controlImage` is that gate.
       const controlReady = (isIdLock || isMotion) && !!controlImage && controlKind !== "";
       const body: Record<string, unknown> = {
-        capability,
+        capability: clipRoute,
+        settings_mode: settingsMode,
+        explicit_settings: manualSettings.current,
         resolution: { width, height, fps },
         seed,
         vram_budget_gb: budgetNum,
         steps: stepsNum,
         cfg: cfgNum,
         requested_frames: requestedFrames.trim() !== "" ? Number(requestedFrames) : undefined,
-        model_id: modelId.trim() ? modelId.trim() : undefined,
+        // A chosen model is an explicit pin. The engine validates it against the
+        // task picked from inputs; silently dropping it would change the request.
+        model_id: modelId.trim() || undefined,
         // Optional auto-archive NAME (choose-or-type). Blank = auto-named (default).
         project: project.trim() ? project.trim() : undefined,
         prompt: prompt.trim() ? prompt : undefined,
@@ -1230,6 +1259,15 @@ export function StudioGenerateSurface({
         control_image: controlReady ? (controlImage as MediaRef).uri : undefined,
         control_kind: controlReady ? controlKind : undefined,
       };
+      if (settingsMode === "oracle") {
+        const planned = await oraclePlan(prompt);
+        body.resolution = { width: planned.width, height: planned.height, fps: planned.fps };
+        body.model_id = planned.model_id;
+        body.steps = planned.steps;
+        body.cfg = planned.cfg;
+        body.seed = planned.seed;
+        body.requested_frames = planned.frames;
+      }
       const res = await request<unknown>(hugpyConfig.studioI2VEnqueueUrl, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -1241,28 +1279,34 @@ export function StudioGenerateSurface({
         setGenMsg(`Enqueue failed: ${describeAppError(errorOf(res))}`);
         return;
       }
+      const enq = enqueueResultSchema.safeParse(okValue(res));
+      if (!enq.success) {
+        setGenMsg("The server accepted the request but returned no job id to track.");
+        return;
+      }
+      const routedCapability = enq.data.capability === "i2v" || enq.data.capability === "t2v"
+        ? enq.data.capability : clipRoute;
+      trackJob({
+        jobId: enq.data.job_id, kind: "studio_i2v", station: "studio",
+        label: routedCapability === "i2v" ? "Studio image-to-video" : "Studio text-to-video",
+        libLabel: "studio clip", enqueuedAt: Date.now(),
+      });
+      setActiveClipJobId(enq.data.job_id);
       // Subject-clip auto-stage (armed by onGenerateNewSubject): the FIRST successful
       // enqueue after "Generate new clip" arms the wait on ITS job id — later manual
       // generates (pendingSubjectStage already false by then) are plain renders.
       if (pendingSubjectStage) {
         setPendingSubjectStage(false);
-        const enq = enqueueResultSchema.safeParse(okValue(res));
-        if (enq.success) {
-          setAwaitingSubjectJobId(enq.data.job_id);
-          setGenMsg(
-            "Enqueued — once this clip is produced it becomes the staged subject automatically.",
-          );
-        } else {
-          setGenMsg(
-            "Enqueued, but no job id came back to track — stage the produced clip as the subject manually (From library) once it's done.",
-          );
-        }
+        setAwaitingSubjectJobId(enq.data.job_id);
+        setGenMsg("Enqueued — once this clip is produced it becomes the staged subject automatically.");
       } else {
-        setGenMsg("Enqueued — once the clip is produced it plays in the viewer above and lands in the Session Library.");
+        setGenMsg(`${routedCapability === "i2v" ? "Image-to-video" : "Text-to-video"} queued — follow the job below or in Active Processes.`);
       }
       onEnqueued();
       // A project name coined here should appear in the combobox next time.
       if (project.trim()) refreshProjects();
+    } catch (err) {
+      setGenMsg(err instanceof Error ? err.message : "Oracle planning failed.");
     } finally {
       if (mounted.current) setGenBusy(false);
     }
@@ -1271,6 +1315,7 @@ export function StudioGenerateSurface({
     v2vBadGeom,
     missingReason,
     capability,
+    clipRoute,
     width,
     height,
     fps,
@@ -1295,7 +1340,72 @@ export function StudioGenerateSurface({
     pendingSubjectStage,
     onEnqueued,
     project,
-    refreshProjects,, warnUnnamed, project]);
+    refreshProjects,
+    warnUnnamed,
+    settingsMode,
+    oraclePlan,
+    setActiveClipJobId]);
+
+  function addNextPrompt() {
+    // Cinema's existing sequential route owns last-frame carry. Preserve every
+    // Clip input we can transfer; refuse shapes it cannot represent as its root.
+    if (source || isV2V || isIdLock || isMotion || referenceImages.length || controlImage) {
+      setSequenceMsg("This Clip has a source or control input that Cinema cannot use as its first frame. Finish this clip, then start a sequence from its result; no attachment was discarded.");
+      return;
+    }
+    setSequenceMsg(null);
+    setClipSequenceDraft({
+      id: nextSessionSeq("studio.movie.clipSequenceDraftSeq"),
+      prompt, negative, stdNegative,
+      startImage: startImages[0] ?? null,
+      width, height, fps, seed, frames: requestedFrames,
+      modelId, steps, cfg, vramBudget, project,
+    });
+    setInternalSurfaceMode("movie");
+    onSelectSurfaceMode?.("movie");
+  }
+
+  async function generateProductionFromClip() {
+    if (source || isV2V || isIdLock || isMotion || referenceImages.length || controlImage) {
+      setSequenceMsg("Cinema cannot carry this Clip's source or control inputs into a new production.");
+      return;
+    }
+    setProduceBusy(true);
+    setSequenceMsg(null);
+    try {
+      const res = await request<unknown>(hugpyConfig.producerPlanUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          premise: prompt.trim() || "Create an original short cinematic sequence.",
+          model: assist.assistModel || undefined,
+          start_image: startImages[0]?.uri,
+        }),
+        meta: { specKey: "studio", operation: "studio.oracle.production" },
+      });
+      if (!res.ok) throw new Error(describeAppError(errorOf(res)));
+      const result = okValue(res) as {
+        segments?: ClipSequenceDraft["plannedSegments"];
+      };
+      if (!result?.segments?.length) throw new Error("Oracle returned no production segments.");
+      const first = result.segments[0]?.settings;
+      setClipSequenceDraft({
+        id: nextSessionSeq("studio.movie.clipSequenceDraftSeq"),
+        prompt, negative, stdNegative,
+        startImage: startImages[0] ?? null,
+        width: first?.width ?? width, height: first?.height ?? height,
+        fps: first?.fps ?? fps, seed, frames: requestedFrames,
+        modelId, steps, cfg, vramBudget, project,
+        plannedSegments: result.segments,
+      });
+      setInternalSurfaceMode("movie");
+      onSelectSurfaceMode?.("movie");
+    } catch (err) {
+      setSequenceMsg(err instanceof Error ? err.message : "Oracle production generation failed.");
+    } finally {
+      setProduceBusy(false);
+    }
+  }
 
   const synthPresets = presets.filter((p) => isSyntheticPreset(p));
   const realPresets = presets.filter((p) => !isSyntheticPreset(p));
@@ -1358,106 +1468,6 @@ export function StudioGenerateSurface({
     );
   }
 
-  // ── start-image input (variant-driven: hero = dominant/accented; inline = subdued) ──
-  function renderStartImage(variant: "hero" | "inline") {
-    const isHero = variant === "hero";
-    const drawEye = isHero && startImageAttention;
-    const thumb = isHero ? "9rem" : "5rem";
-    return (
-      <section aria-label="Start image" style={{ marginTop: isHero ? 0 : "0.9rem" }}>
-        <p
-          className="vi-comfy-label"
-          style={{ marginBottom: "0.35rem", opacity: isHero ? 1 : 0.75 }}
-        >
-          Start image{isHero ? " — required for this generator" : " (optional)"}
-        </p>
-        {drawEye && (
-          <p className="vi-input-callout" role="note">
-            This generator needs a start image — the subject is carried from it. Drop one below
-            (or extend a source clip instead).
-          </p>
-        )}
-        {hasImage && (
-          <div style={{ display: "flex", flexWrap: "wrap", gap: "0.5rem", marginBottom: "0.5rem" }}>
-            {startImages.map((img, idx) => (
-              <div key={img.uri} style={{ display: "flex", flexDirection: "column", gap: "0.2rem" }}>
-                <img
-                  src={mediaBytesUrl(img.uri)}
-                  alt="start"
-                  style={{
-                    width: thumb,
-                    height: thumb,
-                    objectFit: "cover",
-                    borderRadius: "0.4rem",
-                    background: "#000",
-                    border: "1px solid var(--vi-border)",
-                  }}
-                />
-                <button
-                  type="button"
-                  className="vi-btn vi-btn-sm vi-btn-ghost"
-                  onClick={() => removeStartImage(idx)}
-                >
-                  Remove
-                </button>
-              </div>
-            ))}
-          </div>
-        )}
-        {canAddImage ? (
-          isHero && !hasImage ? (
-            <DropReceptacle
-              onFile={(f) => void onPickImageFile(f, "start")}
-              accept="image/*"
-              busy={imageBusy}
-              title="Drop a start image or click to browse"
-              hint="This generator carries the subject from this still."
-              className={drawEye ? "vi-dropzone--required" : undefined}
-            />
-          ) : (
-            <div style={{ display: "flex", gap: "0.5rem", flexWrap: "wrap", alignItems: "center" }}>
-              <label className="vi-btn vi-btn-accent vi-file-label">
-                {imageBusy ? "Working…" : "Upload a still"}
-                <input
-                  type="file"
-                  accept="image/*"
-                  className="vi-file-input"
-                  disabled={imageBusy}
-                  onChange={(e) => {
-                    const f = e.target.files?.[0];
-                    if (f) void onPickImageFile(f, "start");
-                    e.target.value = "";
-                  }}
-                />
-              </label>
-              <button
-                type="button"
-                className="vi-btn vi-btn-ghost"
-                onClick={() => setShowLibPicker((v) => !v)}
-                aria-expanded={showLibPicker}
-              >
-                {showLibPicker ? "Hide library" : `Pick from library (${libraryImages.length})`}
-              </button>
-            </div>
-          )
-        ) : (
-          <p className="vi-comfy-hint" role="note">
-            Multi-image conditioning here is identity lock — switch capability to Identity lock to
-            add 1–4 reference images.
-          </p>
-        )}
-        {imageError && (
-          <p className="vi-error" role="alert" style={{ marginTop: "0.4rem" }}>
-            {imageError}
-          </p>
-        )}
-        {showLibPicker && canAddImage && (
-          <LibraryImageGrid images={libraryImages} onPick={(ref) => addStartImage(ref)} />
-        )}
-      </section>
-    );
-  }
-
   // ── reference-image SLOT LIST: 1–4 ordered stills, reorderable. The SAME list feeds
   //    two shapes — id_lock (variant "required": the identity to lock, accent-gated) and
   //    v2v scene-continuity (variant "optional": an identity held across the restyle). ──
@@ -1723,15 +1733,11 @@ export function StudioGenerateSurface({
     );
   }
 
-  // ── source-clip input (hero = dominant/accented; inline = subdued; inline-alt =
-  //    the "or extend a clip" alternative under a hero start image) ──
-  function renderSource(variant: "hero" | "inline" | "inline-alt") {
+  // ── source-clip input (hero = dominant/accented; inline = subdued) ──
+  function renderSource(variant: "hero" | "inline") {
     const isHero = variant === "hero";
-    const isAlt = variant === "inline-alt";
     const drawEye = isHero && sourceAttention;
-    const label = isAlt
-      ? "…or use a source clip (extend from its last frame)"
-      : isHero
+    const label = isHero
         ? "Source clip — required (the clip to repaint)"
         : isV2V
           ? "Source clip — required"
@@ -1974,20 +1980,26 @@ export function StudioGenerateSurface({
 
   const knobGrid = (
     <div className="vi-studio-knobs">
+      <div className="vi-knob vi-studio-knob-wide">
+        <label htmlFor="vi-clip-settings-mode">settings</label>
+        <select id="vi-clip-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>
       {/* ABOUT — the condensed what-is-this / how-to prose (k89), collapsed at the
           top of the Settings-tab content. Absorbs the descriptive halves of the old
           inline callouts; the conditional required-input warnings stay on the form. */}
       <div className="vi-studio-knob-wide" style={{ flex: "1 1 100%" }}>
         <AboutExpander title="About Clip">
           <p>
-            Generates ONE studio clip from a prompt plus whatever inputs the chosen
-            generator needs.
+            Generates one clip from your prompt and the inputs you provide.
           </p>
           <p>
-            Pick a template or capability here and the form morphs to that shape:
-            text→video needs nothing, image→video a start image (or a source clip to
-            extend), restyle a source clip, identity lock 1–4 reference images, and
-            pose/structure a control still.
+            A prompt alone uses text-to-video. Add a start image or source clip to
+            use image-to-video; a source clip continues from its last frame.
           </p>
           <p>
             A missing required input is flagged on the card and gates Generate until
@@ -2138,6 +2150,7 @@ export function StudioGenerateSurface({
           title={isV2V ? geomLockTitle : geomEnvelopeTitle}
           onChange={(e) => {
             geomTouched.current = true;
+            markManual("width");
             setWidth(Number(e.target.value) || 0);
           }}
         />
@@ -2155,6 +2168,7 @@ export function StudioGenerateSurface({
           title={isV2V ? geomLockTitle : geomEnvelopeTitle}
           onChange={(e) => {
             geomTouched.current = true;
+            markManual("height");
             setHeight(Number(e.target.value) || 0);
           }}
         />
@@ -2172,6 +2186,7 @@ export function StudioGenerateSurface({
           title={isV2V ? geomLockTitle : geomEnvelopeTitle}
           onChange={(e) => {
             geomTouched.current = true;
+            markManual("fps");
             setFps(Number(e.target.value) || 0);
           }}
         />
@@ -2190,7 +2205,7 @@ export function StudioGenerateSurface({
           type="number"
           min={0}
           value={seed}
-          onChange={(e) => setSeed(Number(e.target.value) || 0)}
+          onChange={(e) => { markManual("seed"); setSeed(Number(e.target.value) || 0); }}
         />
       </div>
       <div className="vi-knob">
@@ -2226,7 +2241,7 @@ export function StudioGenerateSurface({
           max={100}
           value={steps}
           placeholder="model default"
-          onChange={(e) => setSteps(e.target.value)}
+          onChange={(e) => { markManual("steps"); setSteps(e.target.value); }}
         />
       </div>
       <div className="vi-knob">
@@ -2240,7 +2255,7 @@ export function StudioGenerateSurface({
           step={0.5}
           value={cfg}
           placeholder="model default"
-          onChange={(e) => setCfg(e.target.value)}
+          onChange={(e) => { markManual("cfg"); setCfg(e.target.value); }}
         />
       </div>
       {/* MODEL PIN — FILTERED BY CAPABILITY (2026-07-29).
@@ -2261,9 +2276,12 @@ export function StudioGenerateSurface({
           id="vi-studio-model"
           className="vi-knob-select"
           value={modelId}
-          onChange={(e) => setModelId(e.target.value)}
+          onChange={(e) => { markManual("model_id"); setModelId(e.target.value); }}
         >
           <option value="">Auto — router picks by budget + resolution</option>
+          {modelId && !STUDIO_MODEL_IDS.includes(modelId) && (
+            <option value={modelId}>{modelId} · current bound model</option>
+          )}
           {capModels.length > 0 && (
             <optgroup label={`Ratified for ${CAP_LABELS[capability]}`}>
               {capModels.map((id) => (
@@ -2468,21 +2486,35 @@ export function StudioGenerateSurface({
               onStdNegativeChange={setStdNegative}
             />
             {/* PROMPT ASSIST — Enhance enriches the clip prompt, Generate writes a fresh
-                one (seeded by any current text). Same shared cluster as the Generate
+                one. Both update the same field. Same shared cluster as the Generate
                 station; errors surface inline and never clobber the existing prompt. */}
             <PromptAssistButtons
               busy={assist.assistBusy}
               error={assist.assistError}
               onDismissError={assist.dismissError}
-              onEnhance={() => void assist.runAssist("detail", prompt, setPrompt)}
+              onEnhance={() => void (async () => {
+                let enhanced = "";
+                await assist.runAssist("detail", prompt, (p) => {
+                  enhanced = p;
+                  setPrompt(p);
+                });
+                if (enhanced && settingsMode === "oracle") {
+                  try { await oraclePlan(enhanced); }
+                  catch (err) { setGenMsg(err instanceof Error ? err.message : "Oracle planning failed."); }
+                }
+              })()}
               onGenerate={() =>
                 void (async () => {
                   let fresh = "";
-                  await assist.runAssist("generate", prompt, (p) => {
+                  await assist.runAssist("generate", "", (p) => {
                     fresh = p;
                     setPrompt(p);
                   });
                   if (!fresh.trim()) return;
+                  if (settingsMode === "oracle") {
+                    try { await oraclePlan(fresh); }
+                    catch (err) { setGenMsg(err instanceof Error ? err.message : "Oracle planning failed."); }
+                  }
                   // NEGATIVE RIDES ALONG (operator 2026-08-13): generated
                   // exclusions APPEND to any typed negative; std tick untouched.
                   await assist.runNegative({ subject: fresh }, (neg) => {
@@ -2543,6 +2575,22 @@ export function StudioGenerateSurface({
             )}
             {promptAttachments.length > 0 && (
               <div className="vi-gen-part-attach">
+                {acceptsStartImage && canAddImage && (
+                  <label className="vi-btn vi-btn-sm vi-btn-ghost vi-file-label">
+                    {imageBusy ? "Adding image…" : "＋ image file"}
+                    <input
+                      type="file"
+                      accept="image/*"
+                      className="vi-file-input"
+                      disabled={imageBusy}
+                      onChange={(e) => {
+                        const file = e.target.files?.[0];
+                        if (file) void onPickImageFile(file, "start");
+                        e.target.value = "";
+                      }}
+                    />
+                  </label>
+                )}
                 {promptAttachments.map((a, i) => (
                   <button
                     key={`${a.label}-${i}`}
@@ -2557,6 +2605,12 @@ export function StudioGenerateSurface({
                 ))}
               </div>
             )}
+            {acceptsStartImage && imageError && (
+              <p className="vi-error" role="alert">{imageError}</p>
+            )}
+            {acceptsStartImage && showLibPicker && canAddImage && (
+              <LibraryImageGrid images={libraryImages} onPick={addStartImage} />
+            )}
 
             {/* SETTINGS EXPANDER (operator ask 2026-08-13): the clip prompt
                 component hosts the FULL knob set, same as Scene/Movie/Cinema
@@ -2567,15 +2621,27 @@ export function StudioGenerateSurface({
                 on the Settings tab only: it morphs the form shape (required
                 inputs), it is not a render knob. */}
             <PromptCardSettings label="settings — model · size · steps · cfg · seed · budget">
+              <div className="vi-knob vi-studio-knob-wide">
+                <label htmlFor="vi-clipcard-settings-mode">settings</label>
+                <select id="vi-clipcard-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-clipcard-model">model pin</label>
                 <select
                   id="vi-clipcard-model"
                   className="vi-knob-select"
                   value={modelId}
-                  onChange={(e) => setModelId(e.target.value)}
+                  onChange={(e) => { markManual("model_id"); setModelId(e.target.value); }}
                 >
                   <option value="">Auto — router picks by budget + resolution</option>
+                  {modelId && !STUDIO_MODEL_IDS.includes(modelId) && (
+                    <option value={modelId}>{modelId} · current bound model</option>
+                  )}
                   {capModels.length > 0 && (
                     <optgroup label={`Ratified for ${CAP_LABELS[capability]}`}>
                       {capModels.map((id) => (
@@ -2600,36 +2666,36 @@ export function StudioGenerateSurface({
               <div className="vi-knob" style={{ maxWidth: "7rem" }}>
                 <label htmlFor="vi-clipcard-width">width</label>
                 <input id="vi-clipcard-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-clipcard-height">height</label>
                 <input id="vi-clipcard-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 | seconds — any two
                   set the third; the dimmed one is derived, last-touched wins. */}
               <LengthRow
                 idPrefix="vi-clipcard-len"
                 fps={fps}
-                onFps={(n) => setFps(n)}
+                onFps={(n) => { markManual("fps"); setFps(n); }}
                 frames={requestedFrames}
-                onFrames={setRequestedFrames}
+                onFrames={(n) => { markManual("frames"); setRequestedFrames(n); }}
               />
               <div className="vi-knob" style={{ maxWidth: "7rem" }}>
                 <label htmlFor="vi-clipcard-steps">steps</label>
                 <input id="vi-clipcard-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-clipcard-cfg">cfg</label>
                 <input id="vi-clipcard-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: "8rem" }}>
                 <label htmlFor="vi-clipcard-seed">seed</label>
                 <input id="vi-clipcard-seed" className="vi-knob-input" type="number" min={0}
-                       value={seed} onChange={(e) => setSeed(Number(e.target.value) || 0)} />
+                       value={seed} onChange={(e) => { markManual("seed"); setSeed(Number(e.target.value) || 0); }} />
               </div>
               <div className="vi-knob" style={{ maxWidth: "9rem" }}>
                 <label htmlFor="vi-clipcard-vram">VRAM budget GB</label>
@@ -2645,6 +2711,15 @@ export function StudioGenerateSurface({
             </PromptCardSettings>
           </PromptCard>
         </ol>
+        <button type="button" className="vi-btn vi-btn-sm" onClick={addNextPrompt}>
+          + Add next prompt
+        </button>
+        <button type="button" className="vi-btn vi-btn-sm"
+                disabled={produceBusy}
+                onClick={() => void generateProductionFromClip()}>
+          {produceBusy ? "Generating production…" : "✨ Generate production"}
+        </button>
+        {sequenceMsg && <p className="vi-knob-hint" role="status">{sequenceMsg}</p>}
       </section>
 
       {/* Required-input callout — surfaces the missing prerequisite PROMINENTLY next to
@@ -2658,16 +2733,6 @@ export function StudioGenerateSurface({
 
       {/* ── 3) SHAPE EDITOR (heroes) — morphs per preformed shape; stays dominant when
              required (accent gating) even though it now sits below the knob grid. ── */}
-      {hero === "start-image" && (
-        <section
-          aria-label="Required input"
-          className="vi-studio-shape"
-          style={{ display: "flex", flexDirection: "column", gap: "0.5rem" }}
-        >
-          {renderStartImage("hero")}
-          {renderSource("inline-alt")}
-        </section>
-      )}
       {hero === "source" && (
         <section
           aria-label="Required input"
@@ -2703,7 +2768,6 @@ export function StudioGenerateSurface({
       )}
 
       {/* LOWER inputs — only when NOT a hero shape (custom / synthetic / t2v). */}
-      {!hero && isI2V && <div className="vi-studio-shape">{renderStartImage("inline")}</div>}
       {!hero && !isT2V && !isIdLock && <div className="vi-studio-shape">{renderSource("inline")}</div>}
       {!hero && isT2V && (
         <p className="vi-knob-hint" role="note" style={{ marginTop: "0.9rem" }}>
@@ -2763,6 +2827,12 @@ export function StudioGenerateSurface({
               {genMsg}
             </p>
           )}
+          {activeClipJob && (
+            <p className="vi-knob-hint" role="status" style={{ margin: 0 }}>
+              Clip {activeClipJob.status ?? "queued"} · {activeClipJob.jobId.slice(0, 8)}
+              {activeClipJob.error ? ` — ${activeClipJob.error}` : ""}
+            </p>
+          )}
         </div>
         {nameWarn && (
           <UnnamedWarnPanel
@@ -2792,7 +2862,7 @@ export function StudioGenerateSurface({
                   : isMotion
                     ? "Generate (pose / structure)"
                     : isI2V
-                      ? "Generate (i2v)"
+                      ? clipRoute === "i2v" ? "Generate (i2v)" : "Generate (t2v)"
                       : "Generate (t2v)"}
           </button>
           {/* (The cross-model "🧪 Test all models" ghost that sat here moved into