ima2-gen 1.1.21 → 1.1.23

package/routes/sessions.ts

@@ -1,317 +0,0 @@
-import type { Express, Request, Response } from "express";
-import {
-  createSession,
-  listSessions,
-  getSession,
-  renameSession,
-  deleteSession,
-  saveGraph,
-  getStyleSheet,
-  setStyleSheet,
-  setStyleSheetEnabled,
-} from "../lib/sessionStore.js";
-import { extractStyleSheet } from "../lib/styleSheet.js";
-import { logError, logEvent } from "../lib/logger.js";
-
-import { errInfo } from "../lib/errInfo.js";
-import { requireRuntimeContext, type RouteRuntimeContext } from "../lib/runtimeContext.js";
-function safeJsonChars(value: unknown): number {
-  try {
-    return JSON.stringify(value ?? null).length;
-  } catch {
-    return 0;
-  }
-}
-
-type IdParams = { id: string };
-
-export function registerSessionRoutes(app: Express, ctxRaw: RouteRuntimeContext) {
-  const ctx = requireRuntimeContext(ctxRaw);
-  app.get("/api/sessions", (_req: Request, res: Response) => {
-    try {
-      res.json({ sessions: listSessions() });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.post("/api/sessions", (req: Request, res: Response) => {
-    try {
-      const body = (req.body ?? {}) as { title?: unknown };
-      const titleRaw = typeof body.title === "string" ? body.title : "Untitled";
-      const title = (titleRaw || "Untitled").slice(0, 200);
-      const session = createSession({ title });
-      logEvent("session", "create", {
-        sessionId: session.id,
-        titleChars: session.title.length,
-      });
-      res.status(201).json({ session });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.get("/api/sessions/:id", (req: Request<IdParams>, res: Response) => {
-    try {
-      const session = getSession(req.params.id);
-      if (!session) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      res.json({ session });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.patch("/api/sessions/:id", (req: Request<IdParams>, res: Response) => {
-    try {
-      const body = (req.body ?? {}) as { title?: unknown };
-      const title = body.title;
-      if (typeof title !== "string" || !title.trim()) {
-        return res.status(400).json({
-          error: { code: "INVALID_TITLE", message: "Title required" },
-        });
-      }
-      const ok = renameSession(req.params.id, title.slice(0, 200));
-      if (!ok) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "rename", {
-        sessionId: req.params.id,
-        titleChars: title.slice(0, 200).length,
-      });
-      res.json({ ok: true });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.delete("/api/sessions/:id", (req: Request<IdParams>, res: Response) => {
-    try {
-      const ok = deleteSession(req.params.id);
-      if (!ok) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "delete", { sessionId: req.params.id });
-      res.json({ ok: true });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.get("/api/sessions/:id/style-sheet", (req: Request<IdParams>, res: Response) => {
-    try {
-      const data = getStyleSheet(req.params.id);
-      if (!data) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "stylesheet_get", {
-        sessionId: req.params.id,
-        enabled: data.enabled,
-        hasSheet: !!data.styleSheet,
-        sheetChars: safeJsonChars(data.styleSheet),
-      });
-      res.json(data);
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.put("/api/sessions/:id/style-sheet", (req: Request<IdParams>, res: Response) => {
-    try {
-      const body = (req.body ?? {}) as { styleSheet?: unknown; enabled?: unknown };
-      const { styleSheet, enabled } = body;
-      if (styleSheet !== null && (typeof styleSheet !== "object" || Array.isArray(styleSheet))) {
-        return res.status(400).json({
-          error: { code: "INVALID_SHEET", message: "styleSheet must be an object or null" },
-        });
-      }
-      if (enabled !== undefined && typeof enabled !== "boolean") {
-        return res.status(400).json({
-          error: { code: "INVALID_ENABLED", message: "enabled must be boolean when provided" },
-        });
-      }
-      const ok = setStyleSheet(req.params.id, styleSheet);
-      if (!ok) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      if (typeof enabled === "boolean") setStyleSheetEnabled(req.params.id, enabled);
-      logEvent("session", "stylesheet_save", {
-        sessionId: req.params.id,
-        enabled: typeof enabled === "boolean" ? enabled : undefined,
-        hasSheet: !!styleSheet,
-        sheetChars: safeJsonChars(styleSheet),
-      });
-      res.json({ ok: true });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.patch("/api/sessions/:id/style-sheet/enabled", (req: Request<IdParams>, res: Response) => {
-    try {
-      const body = (req.body ?? {}) as { enabled?: unknown };
-      const { enabled } = body;
-      if (typeof enabled !== "boolean") {
-        return res.status(400).json({
-          error: { code: "INVALID_ENABLED", message: "enabled must be boolean" },
-        });
-      }
-      const ok = setStyleSheetEnabled(req.params.id, enabled);
-      if (!ok) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "stylesheet_toggle", {
-        sessionId: req.params.id,
-        enabled,
-      });
-      res.json({ ok: true, enabled });
-    } catch (e) {
-      const err = errInfo(e);
-      res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
-    }
-  });
-
-  app.post("/api/sessions/:id/style-sheet/extract", async (req: Request<IdParams>, res: Response) => {
-    try {
-      if (!ctx.openai) {
-        return res.status(400).json({
-          error: {
-            code: "STYLE_SHEET_NO_KEY",
-            message: "Style-sheet extraction requires an OpenAI API key. Connect one via setup.",
-          },
-        });
-      }
-      const body = (req.body ?? {}) as { prompt?: unknown; referenceDataUrl?: unknown };
-      const { prompt, referenceDataUrl } = body;
-      if (typeof prompt !== "string" || !prompt.trim()) {
-        return res.status(400).json({
-          error: { code: "STYLE_SHEET_BAD_INPUT", message: "prompt required" },
-        });
-      }
-      if (!getSession(req.params.id)) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "stylesheet_extract_start", {
-        sessionId: req.params.id,
-        promptChars: prompt.length,
-        hasReference: typeof referenceDataUrl === "string" && referenceDataUrl.length > 0,
-      });
-      const sheet = await extractStyleSheet(ctx.openai, {
-        prompt: prompt.slice(0, 4000),
-        referenceDataUrl: typeof referenceDataUrl === "string" ? referenceDataUrl : undefined,
-      });
-      const persisted = setStyleSheet(req.params.id, sheet);
-      if (!persisted) {
-        return res.status(404).json({
-          error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
-        });
-      }
-      logEvent("session", "stylesheet_extract_done", {
-        sessionId: req.params.id,
-        sheetChars: safeJsonChars(sheet),
-      });
-      res.json({ styleSheet: sheet });
-    } catch (e) {
-      const err = errInfo(e);
-      const code = err.code || "STYLE_SHEET_ERROR";
-      const status =
-        code === "STYLE_SHEET_NO_KEY" || code === "STYLE_SHEET_BAD_INPUT"
-          ? 400
-          : code === "STYLE_SHEET_EMPTY" || code === "STYLE_SHEET_PARSE" || code === "STYLE_SHEET_SHAPE"
-            ? 422
-            : 500;
-      logError("session", "stylesheet_extract_error", err.raw, { sessionId: req.params.id, code });
-      res.status(status).json({ error: { code, message: err.message } });
-    }
-  });
-
-  app.put("/api/sessions/:id/graph", (req: Request<IdParams>, res: Response) => {
-    try {
-      const body = (req.body ?? {}) as { nodes?: unknown; edges?: unknown };
-      const { nodes, edges } = body;
-      const rawIfMatch = req.get("If-Match");
-      if (!Array.isArray(nodes) || !Array.isArray(edges)) {
-        return res.status(400).json({
-          error: { code: "INVALID_GRAPH", message: "nodes and edges arrays required" },
-        });
-      }
-      if (!rawIfMatch) {
-        return res.status(428).json({
-          error: { code: "GRAPH_VERSION_REQUIRED", message: "If-Match header required" },
-        });
-      }
-      if (nodes.length > 500 || edges.length > 1000) {
-        return res.status(413).json({
-          error: {
-            code: "GRAPH_TOO_LARGE",
-            message: `Graph too large (max 500 nodes / 1000 edges), got ${nodes.length}/${edges.length}`,
-          },
-        });
-      }
-      const expectedVersion = Number(String(rawIfMatch).replace(/"/g, ""));
-      if (!Number.isFinite(expectedVersion)) {
-        return res.status(400).json({
-          error: { code: "INVALID_GRAPH_VERSION", message: "If-Match must be a finite integer" },
-        });
-      }
-      const saveId = req.get("X-Ima2-Graph-Save-Id") || null;
-      const saveReason = req.get("X-Ima2-Graph-Save-Reason") || null;
-      const tabId = req.get("X-Ima2-Tab-Id") || null;
-      const result = saveGraph(req.params.id, { nodes, edges, expectedVersion });
-      logEvent("session", "graph_save", {
-        sessionId: req.params.id,
-        saveId,
-        saveReason,
-        tabId,
-        nodes: nodes.length,
-        edges: edges.length,
-        graphVersion: result.graphVersion,
-      });
-      res.json({ ok: true, nodes: nodes.length, edges: edges.length, graphVersion: result.graphVersion });
-    } catch (e) {
-      const err = errInfo(e);
-      const ext = (err.raw && typeof err.raw === "object" ? err.raw as Record<string, unknown> : {});
-      const code = err.code || "DB_ERROR";
-      const payload: { error: { code: string; message: string }; currentVersion?: number } = { error: { code, message: err.message } };
-      if (typeof ext.currentVersion === "number") payload.currentVersion = ext.currentVersion;
-      if (code === "GRAPH_VERSION_CONFLICT") {
-        const reqBody = (req.body ?? {}) as { nodes?: unknown; edges?: unknown };
-        logEvent("session", "graph_conflict", {
-          sessionId: req.params.id,
-          saveId: req.get("X-Ima2-Graph-Save-Id") || null,
-          saveReason: req.get("X-Ima2-Graph-Save-Reason") || null,
-          tabId: req.get("X-Ima2-Tab-Id") || null,
-          expectedVersion: Number(String(req.get("If-Match") || "").replace(/"/g, "")),
-          currentVersion: ext.currentVersion ?? null,
-          nodes: Array.isArray(reqBody.nodes) ? reqBody.nodes.length : null,
-          edges: Array.isArray(reqBody.edges) ? reqBody.edges.length : null,
-        });
-      } else {
-        logError("session", "graph_error", err.raw, { sessionId: req.params.id, code });
-      }
-      res.status(err.status || 500).json(payload);
-    }
-  });
-}

package/routes/storage.ts

@@ -1,47 +0,0 @@
-import type { Express, Request, Response } from "express";
-import { inspectGeneratedStorage } from "../lib/storageMigration.js";
-import { openDirectory } from "../lib/openDirectory.js";
-import { requireRuntimeContext, type RouteRuntimeContext } from "../lib/runtimeContext.js";
-
-type StorageStatus = Awaited<ReturnType<typeof inspectGeneratedStorage>>;
-
-export function registerStorageRoutes(app: Express, ctxRaw: RouteRuntimeContext) {
-  const ctx = requireRuntimeContext(ctxRaw);
-  app.get("/api/storage/status", async (_req: Request, res: Response) => {
-    const status = await inspectGeneratedStorage(ctx);
-    res.json({
-      ok: true,
-      data: toPublicStorageStatus(status),
-    });
-  });
-
-  app.post("/api/storage/open-generated-dir", async (_req: Request, res: Response) => {
-    const result = (await openDirectory(ctx.config.storage.generatedDir)) as {
-      ok: boolean;
-      error?: string;
-    };
-    if (result.ok) return res.json({ ok: true });
-    return res.status(500).json({
-      ok: false,
-      error: {
-        code: "OPEN_GENERATED_DIR_FAILED",
-        message: result.error || "Could not open generated image folder.",
-      },
-    });
-  });
-}
-
-function toPublicStorageStatus(status: StorageStatus) {
-  return {
-    generatedDirLabel: status.generatedDirLabel,
-    generatedCount: status.targetFileCount,
-    legacyCandidatesScanned: status.legacyCandidatesScanned,
-    legacySourcesFound: status.legacySourcesFound,
-    legacyFilesFound: status.legacyFilesFound,
-    state: status.state,
-    messageKind: status.messageKind,
-    recoveryDocsPath: status.recoveryDocsPath,
-    doctorCommand: status.doctorCommand,
-    overrides: status.overrides,
-  };
-}

package/routes/video.ts

@@ -1,300 +0,0 @@
-import { mkdir, readFile, unlink, writeFile } from "fs/promises";
-import { join } from "path";
-import { randomBytes } from "crypto";
-import type { Express, Request, Response } from "express";
-import { startJob, finishJob, registerJobAbortController, isJobCanceled, setJobPhase } from "../lib/inflight.js";
-import { isGenerationCanceledError, makeGenerationCanceledError } from "../lib/generationCancel.js";
-import { logEvent, logError } from "../lib/logger.js";
-import { invalidateHistoryIndex } from "../lib/historyIndex.js";
-import { generateVideoViaGrok, type GrokVideoEvent } from "../lib/grokVideoAdapter.js";
-import { getVideoSeriesChain } from "../lib/videoSeriesChain.js";
-import {
-  ACTIVE_VIDEO_PROMPT_GUIDANCE,
-  appendVideoContinuityEntry,
-  lineageFromVideoMetadata,
-  normalizeVideoContinuityLineage,
-  readVideoSidecar,
-  requireActiveVideoPrompt,
-  safeGeneratedVideoFilename,
-  type VideoContinuityLineage,
-} from "../lib/videoContinuity.js";
-import { extractGeneratedVideoFrameB64 } from "../lib/videoFrameExtract.js";
-import {
-  normalizeGrokVideoModel,
-  normalizeVideoResolution,
-  normalizeVideoAspectRatio,
-  normalizeVideoDuration,
-  deriveVideoMode,
-  clampVideoDuration,
-  MAX_REF2V_REFERENCES,
-  type VideoMode,
-} from "../lib/imageModels.js";
-import { errInfo } from "../lib/errInfo.js";
-import { requireRuntimeContext, type RouteRuntimeContext, type RuntimeContext } from "../lib/runtimeContext.js";
-
-function sendSse(res: Response, event: string, data: unknown) {
-  res.write(`event: ${event}\n`);
-  res.write(`data: ${JSON.stringify(data)}\n\n`);
-}
-
-function toArray(v: unknown): unknown[] {
-  return Array.isArray(v) ? v : [];
-}
-
-type NormalizeError = { error: string; code: string; status: number };
-
-function isNormalizeError(x: unknown): x is NormalizeError {
-  return typeof x === "object" && x !== null && typeof (x as { error?: unknown }).error === "string";
-}
-
-export async function saveGeneratedVideoArtifact(ctx: RuntimeContext, filename: string, buffer: Buffer, metadata: unknown): Promise<void> {
-  const filePath = join(ctx.config.storage.generatedDir, filename);
-  await writeFile(filePath, buffer);
-  try {
-    await writeFile(`${filePath}.json`, JSON.stringify(metadata));
-  } catch (err) {
-    await unlink(filePath).catch(() => {});
-    throw err;
-  }
-}
-
-async function resolveSourceImage(
-  ctx: RuntimeContext,
-  sourceImage: unknown,
-  sourceFilename: unknown,
-): Promise<{ b64: string | null; filename: string | null }> {
-  if (typeof sourceFilename === "string" && sourceFilename) {
-    const safe = sourceFilename.replace(/^\/+/, "");
-    if (safe.includes("..")) throw { status: 400, code: "GROK_VIDEO_INVALID_MODE", message: "invalid source filename" };
-    if (/\.mp4$/i.test(safe)) throw { status: 400, code: "GROK_VIDEO_INVALID_MODE", message: "use continueFromVideo for generated video continuation" };
-    const buf = await readFile(join(ctx.config.storage.generatedDir, safe));
-    return { b64: buf.toString("base64"), filename: safe };
-  }
-  if (typeof sourceImage === "string" && sourceImage) {
-    return { b64: sourceImage, filename: null };
-  }
-  return { b64: null, filename: null };
-}
-
-export function registerVideoRoutes(app: Express, ctxRaw: RouteRuntimeContext) {
-  const ctx = requireRuntimeContext(ctxRaw);
-  app.post("/api/video/generate", async (req: Request, res: Response) => {
-    const requestId =
-      typeof req.body?.requestId === "string"
-        ? req.body.requestId
-        : typeof req.body?.clientRequestId === "string"
-          ? req.body.clientRequestId
-          : req.id;
-    let finishStatus = "completed";
-    let finishHttpStatus = 200;
-    let finishErrorCode: string | undefined;
-    let finishMeta: Record<string, unknown> = {};
-    let finishCanceled = false;
-    const cancelController = new AbortController();
-
-    res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
-    res.setHeader("Cache-Control", "no-cache, no-transform");
-    res.setHeader("Connection", "keep-alive");
-    res.flushHeaders?.();
-
-    const fail = (status: number | undefined, code: string, error: string, extra: Record<string, unknown> = {}) => {
-      const httpStatus = status ?? 500;
-      finishStatus = "error";
-      finishHttpStatus = httpStatus;
-      finishErrorCode = code;
-      sendSse(res, "error", { error, code, status: httpStatus, requestId, ...extra });
-    };
-
-    try {
-      const { prompt, provider = "grok", model: rawModel } = req.body || {};
-      const sessionId = typeof req.body?.sessionId === "string" ? req.body.sessionId : null;
-      const clientNodeId = typeof req.body?.clientNodeId === "string" ? req.body.clientNodeId : null;
-      const topic = typeof req.body?.topic === "string" ? req.body.topic.trim() : "";
-
-      if (provider !== "grok") return fail(400, "VIDEO_PROVIDER_UNSUPPORTED", "video generation requires provider 'grok'");
-      const activePrompt = requireActiveVideoPrompt(prompt);
-      if (!activePrompt) return fail(400, "PROMPT_REQUIRED", "Prompt is required", { guidance: ACTIVE_VIDEO_PROMPT_GUIDANCE });
-
-      const modelCheck = normalizeGrokVideoModel(rawModel);
-      if (isNormalizeError(modelCheck)) return fail(modelCheck.status, modelCheck.code, modelCheck.error);
-      const durationCheck = normalizeVideoDuration(req.body?.duration);
-      if (isNormalizeError(durationCheck)) return fail(durationCheck.status, durationCheck.code, durationCheck.error);
-      const resolutionCheck = normalizeVideoResolution(req.body?.resolution);
-      if (isNormalizeError(resolutionCheck)) return fail(resolutionCheck.status, resolutionCheck.code, resolutionCheck.error);
-      const aspectCheck = normalizeVideoAspectRatio(req.body?.aspectRatio);
-      if (isNormalizeError(aspectCheck)) return fail(aspectCheck.status, aspectCheck.code, aspectCheck.error);
-
-      // Resolve reference inputs: base64 list + existing-file list + legacy single source.
-      let parentLineage: VideoContinuityLineage | null = null;
-      let continueFromVideoFilename: string | null = null;
-      if (typeof req.body?.continueFromVideo === "string" && req.body.continueFromVideo.trim()) {
-        try {
-          continueFromVideoFilename = safeGeneratedVideoFilename(req.body.continueFromVideo);
-          const parentMeta = await readVideoSidecar(ctx.config.storage.generatedDir, continueFromVideoFilename);
-          parentLineage = lineageFromVideoMetadata(continueFromVideoFilename, parentMeta);
-        } catch (e: any) {
-          return fail(e?.status || 400, "GROK_VIDEO_INVALID_MODE", e?.message || "invalid continuation video");
-        }
-      } else {
-        parentLineage = normalizeVideoContinuityLineage(req.body?.continuityLineage);
-      }
-
-      const refInputs: Array<{ image?: unknown; filename?: unknown }> = [
-        ...toArray(req.body?.referenceImages).map((image) => ({ image })),
-        ...toArray(req.body?.referenceFilenames).map((filename) => ({ filename })),
-        ...(req.body?.sourceImage || req.body?.sourceFilename
-          ? [{ image: req.body?.sourceImage, filename: req.body?.sourceFilename }]
-          : []),
-      ];
-      if (continueFromVideoFilename && !req.body?.sourceImage && !req.body?.sourceFilename) {
-        try {
-          refInputs.push({ image: await extractGeneratedVideoFrameB64(ctx.config.storage.generatedDir, continueFromVideoFilename) });
-        } catch (e: any) {
-          return fail(e?.status || 500, "GROK_VIDEO_FRAME_FAILED", e?.message || "failed to extract continuation frame");
-        }
-      }
-      let resolved: Array<{ b64: string; filename: string | null }>;
-      try {
-        const all = await Promise.all(refInputs.map((r) => resolveSourceImage(ctx, r.image, r.filename)));
-        resolved = all.filter((r): r is { b64: string; filename: string | null } => Boolean(r.b64));
-      } catch (e: any) {
-        return fail(e?.status || 400, e?.code || "GROK_VIDEO_INVALID_MODE", e?.message || "invalid reference image");
-      }
-      if (resolved.length > MAX_REF2V_REFERENCES) return fail(400, "GROK_VIDEO_REF_TOO_MANY", `at most ${MAX_REF2V_REFERENCES} reference images`);
-      const mode: VideoMode = deriveVideoMode(resolved.length);
-      const duration = clampVideoDuration(durationCheck.duration, mode);
-      const referenceImages = mode === "reference-to-video" ? resolved.map((r) => r.b64) : undefined;
-      const sourceB64 = mode === "image-to-video" ? resolved[0]?.b64 : undefined;
-      const sourceFilename = resolved[0]?.filename ?? null;
-
-      startJob({
-        requestId,
-        kind: "video",
-        prompt: activePrompt,
-        meta: { kind: "video", sessionId, clientNodeId, model: modelCheck.model, mode, duration, resolution: resolutionCheck.resolution },
-      });
-      registerJobAbortController(requestId, cancelController);
-      await mkdir(ctx.config.storage.generatedDir, { recursive: true });
-
-      logEvent("video", "request", { requestId, mode, duration, resolution: resolutionCheck.resolution, aspectRatio: aspectCheck.aspectRatio });
-      const startTime = Date.now();
-
-      const onEvent = (ev: GrokVideoEvent) => {
-        if (ev.phase === "submitted") {
-          setJobPhase(requestId, "streaming");
-          sendSse(res, "submitted", {
-            requestId,
-            xaiVideoRequestId: ev.xaiVideoRequestId,
-            requestedModel: ev.requestedModel,
-            effectiveModel: ev.effectiveModel,
-            modelFallback: ev.modelFallback ?? null,
-          });
-        } else if (ev.phase === "progress") {
-          sendSse(res, "progress", { requestId, progress: typeof ev.progress === "number" ? ev.progress / 100 : null, stalled: Boolean(ev.stalled) });
-        } else {
-          setJobPhase(requestId, "planning");
-          sendSse(res, "planning", { requestId });
-        }
-      };
-
-      // Build prompt with series chain context
-      const chain = !parentLineage && topic ? await getVideoSeriesChain(ctx.config.storage.generatedDir, topic) : [];
-      const effectivePrompt = chain.length > 0
-        ? `[Series topic: ${topic}]\n[Previous prompts in series:\n${chain.map((p, i) => `${i + 1}. ${p}`).join("\n")}\n]\n\n${activePrompt}`
-        : activePrompt;
-
-      const result = await generateVideoViaGrok(effectivePrompt, ctx, {
-        model: modelCheck.model,
-        mode,
-        duration,
-        resolution: resolutionCheck.resolution,
-        aspectRatio: aspectCheck.aspectRatio,
-        sourceImage: sourceB64,
-        referenceImages,
-        signal: cancelController.signal,
-        requestId,
-        continuityLineage: parentLineage,
-        onEvent,
-      });
-
-      const rand = randomBytes(ctx.config.ids.generatedHexBytes).toString("hex");
-      const filename = `${Date.now()}_${rand}.mp4`;
-      const elapsed = +((Date.now() - startTime) / 1000).toFixed(1);
-      const videoContinuity = appendVideoContinuityEntry(parentLineage, {
-        filename,
-        userPrompt: activePrompt,
-        revisedPrompt: result.revisedPrompt,
-        createdAt: Date.now(),
-      });
-      const meta = {
-        kind: "video",
-        mediaType: "video",
-        requestId,
-        sessionId,
-        clientNodeId,
-        prompt: activePrompt,
-        userPrompt: activePrompt,
-        revisedPrompt: result.revisedPrompt,
-        provider: "grok",
-        model: result.effectiveModel,
-        requestedModel: result.requestedModel,
-        effectiveModel: result.effectiveModel,
-        modelFallback: result.modelFallback,
-        createdAt: Date.now(),
-        elapsed,
-        usage: result.usage,
-        webSearchCalls: result.webSearchCalls,
-        video: {
-          duration: result.duration,
-          resolution: result.resolution,
-          aspectRatio: result.aspectRatio,
-          sourceImageFilename: sourceFilename,
-          xaiVideoRequestId: result.xaiVideoRequestId,
-          requestedModel: result.requestedModel,
-          effectiveModel: result.effectiveModel,
-          modelFallback: result.modelFallback,
-        },
-        videoContinuity,
-        ...(topic ? { videoSeries: { topic, chainIndex: chain.length } } : {}),
-      };
-      await saveGeneratedVideoArtifact(ctx, filename, result.videoBuffer, meta);
-      invalidateHistoryIndex();
-
-      finishMeta = { filename, xaiVideoRequestId: result.xaiVideoRequestId };
-      logEvent("video", "saved", { requestId, filename, bytes: result.videoBuffer.length, elapsedMs: Date.now() - startTime });
-      sendSse(res, "done", {
-        requestId,
-        filename,
-        url: `/generated/${encodeURIComponent(filename)}`,
-        mediaType: "video",
-        revisedPrompt: result.revisedPrompt,
-        elapsed,
-        usage: result.usage,
-        requestedModel: result.requestedModel,
-        effectiveModel: result.effectiveModel,
-        modelFallback: result.modelFallback,
-        video: meta.video,
-        videoContinuity,
-        ...(meta.videoSeries ? { videoSeries: meta.videoSeries } : {}),
-      });
-    } catch (e) {
-      const err = errInfo(e);
-      if (isGenerationCanceledError(err.raw) || isJobCanceled(requestId)) {
-        const canceled = makeGenerationCanceledError();
-        finishCanceled = true;
-        finishHttpStatus = canceled.status;
-        finishErrorCode = canceled.code;
-        sendSse(res, "error", { error: canceled.message, code: canceled.code, status: canceled.status, requestId });
-      } else {
-        finishStatus = "error";
-        finishHttpStatus = err.status || 500;
-        finishErrorCode = err.code || "GROK_VIDEO_FAILED";
-        logError("video", "error", err.raw, { requestId, code: finishErrorCode });
-        sendSse(res, "error", { error: err.message, code: finishErrorCode, status: finishHttpStatus, requestId });
-      }
-    } finally {
-      finishJob(requestId, { canceled: finishCanceled, status: finishStatus, httpStatus: finishHttpStatus, errorCode: finishErrorCode, meta: finishMeta });
-      res.end();
-    }
-  });
-}