@lalalic/markcut 2.8.0 → 2.9.0

package/src/player/components/EditControls.tsx

@@ -17,11 +17,14 @@ interface EditControlsProps {
   currentTime?: number;
   /** Active scene name (sent with edit request for context) */
   activeScene?: string;
+  /** UI locale */
+  locale?: "en" | "zh";
 }
 
-export function EditControls({ onStatusChange, suppressReloadRef, currentTime, activeScene }: EditControlsProps) {
+export function EditControls({ onStatusChange, suppressReloadRef, currentTime, activeScene, locale = "en" }: EditControlsProps) {
   const [busy, setBusy] = React.useState(false);
   const inputRef = React.useRef<HTMLInputElement>(null);
+  const isZh = locale === "zh";
 
   // ── Edit submit ──────────────────────────────────────────────────────
   const handleApplyEdit = React.useCallback(
@@ -75,12 +78,12 @@ export function EditControls({ onStatusChange, suppressReloadRef, currentTime, a
       <input
         ref={inputRef}
         id="edit-input"
-        placeholder="What should change? e.g. make text bigger"
+        placeholder={isZh ? "想改什么？例如：把文字放大一些" : "What should change? e.g. make text bigger"}
         onKeyDown={handleKeyDown}
       />
       <button
         id="edit-btn"
-        title="Apply edit"
+        title={isZh ? "应用修改" : "Apply edit"}
         disabled={busy}
         onClick={() => handleApplyEdit(inputRef.current?.value || "")}
       >

package/src/player/components/EditMessagePanel.tsx

@@ -0,0 +1,96 @@
+/**
+ * EditMessagePanel — displays edit session messages chronologically.
+ *
+ * Shows user edit requests and assistant responses in a scrollable panel
+ * that can be minimized to a compact bar. Replaces the old one-line
+ * edit-status in the header.
+ */
+import * as React from "react";
+
+export interface EditEntry {
+  id: number;
+  request: string;
+  /** Accumulated assistant response text */
+  progress: string;
+  status: "thinking" | "done" | "error";
+  error?: string;
+}
+
+interface EditMessagePanelProps {
+  entries: EditEntry[];
+  minimized: boolean;
+  locale?: "en" | "zh";
+  onToggleMinimize: () => void;
+}
+
+export function EditMessagePanel({ entries, minimized, locale = "en", onToggleMinimize }: EditMessagePanelProps) {
+  const listRef = React.useRef<HTMLDivElement>(null);
+  const isZh = locale === "zh";
+
+  // Auto-scroll to bottom when entries change
+  React.useEffect(() => {
+    if (listRef.current) {
+      listRef.current.scrollTop = listRef.current.scrollHeight;
+    }
+  }, [entries]);
+
+  // Minimized bar: show count + latest status
+  if (minimized) {
+    const latest = entries[entries.length - 1];
+    const label =
+      entries.length === 0
+        ? (isZh ? "✨ 编辑" : "✨ Edit")
+        : isZh
+          ? `✨ ${entries.length} 条编辑${latest?.status === "thinking" ? " ⏳" : ""}`
+          : `✨ ${entries.length} edit${entries.length > 1 ? "s" : ""}${latest?.status === "thinking" ? " ⏳" : ""}`;
+    return (
+      <button id="edit-message-bar" onClick={onToggleMinimize} title={isZh ? "显示编辑历史" : "Show edit history"}>
+        {label}
+      </button>
+    );
+  }
+
+  return (
+    <div id="edit-message-panel">
+      <div id="edit-message-header">
+        <span>{isZh ? "✨ 编辑历史" : "✨ Edit History"}</span>
+        <button
+          id="edit-message-minimize"
+          onClick={onToggleMinimize}
+          title={isZh ? "最小化" : "Minimize"}
+          aria-label={isZh ? "最小化编辑面板" : "Minimize edit panel"}
+        >
+          ─
+        </button>
+      </div>
+      <div id="edit-message-list" ref={listRef}>
+        {entries.length === 0 && (
+          <div className="edit-message-empty">{isZh ? "暂无编辑记录。请在下方输入修改请求。" : "No edits yet. Type a request below."}</div>
+        )}
+        {entries.map((entry) => (
+          <div key={entry.id} className={`edit-message-entry ${entry.status}`}>
+            <div className="edit-message-request">
+              <span className="edit-role">{isZh ? "你:" : "You:"}</span> {entry.request}
+            </div>
+            {entry.status === "thinking" && (
+              <div className="edit-message-thinking">
+                <span className="edit-role">{isZh ? "助手:" : "Assistant:"}</span> {isZh ? "思考中" : "Thinking"}
+                <span className="edit-dots"><span>.</span><span>.</span><span>.</span></span>
+              </div>
+            )}
+            {entry.status === "done" && entry.progress && (
+              <div className="edit-message-response">
+                <span className="edit-role">{isZh ? "助手:" : "Assistant:"}</span> {entry.progress}
+              </div>
+            )}
+            {entry.status === "error" && (
+              <div className="edit-message-error">
+                <span className="edit-role">{isZh ? "错误:" : "Error:"}</span> {entry.error || entry.progress || (isZh ? "编辑失败" : "Edit failed")}
+              </div>
+            )}
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}

package/src/player/components/HeaderBar.tsx

@@ -12,18 +12,19 @@ interface HeaderBarProps {
   mode: string;
   /** Label mode scene info text (e.g. "slide1 (1.2s)") */
   sceneInfo?: string;
-  /** Edit mode status text (e.g. "✅ done", "⏳ editing...") */
-  editStatus?: string;
-  /** Edit mode: whether SSE is connected */
+  /** Whether SSE is connected */
   sseConnected?: boolean;
+  /** UI locale */
+  locale?: "en" | "zh";
 }
 
-export function HeaderBar({ mode, sceneInfo, editStatus, sseConnected }: HeaderBarProps) {
+export function HeaderBar({ mode, sceneInfo, sseConnected, locale = "en" }: HeaderBarProps) {
+  const isZh = locale === "zh";
   const handleClose = React.useCallback(() => {
     navigator.sendBeacon("/api/shutdown", "{}");
     document.body.innerHTML =
-      "<div style='display:flex;align-items:center;justify-content:center;height:100vh;background:#0a0a0a;color:#555;font-family:sans-serif;font-size:16px'>\u2B61 player closed \u2014 return to terminal</div>";
-  }, []);
+      `<div style='display:flex;align-items:center;justify-content:center;height:100vh;background:#0a0a0a;color:#555;font-family:sans-serif;font-size:16px'>\u2B61 ${isZh ? "播放器已关闭，返回终端" : "player closed — return to terminal"}</div>`;
+  }, [isZh]);
 
   return (
     <div id="header">
@@ -32,13 +33,10 @@ export function HeaderBar({ mode, sceneInfo, editStatus, sseConnected }: HeaderB
         {mode === "label" && sceneInfo && (
           <span id="scene-info">{sceneInfo}</span>
         )}
-        {mode === "edit" && editStatus && (
-          <span id="edit-status">{editStatus}</span>
-        )}
         {/* SSE indicator — shown in all modes */}
         <span
           id="sse-indicator"
-          title={sseConnected ? "Connected — auto-reload ready" : "Disconnected"}
+          title={sseConnected ? (isZh ? "已连接，可自动刷新" : "Connected — auto-reload ready") : (isZh ? "连接断开" : "Disconnected")}
           style={{
             display: "inline-block",
             width: 8,
@@ -51,7 +49,7 @@ export function HeaderBar({ mode, sceneInfo, editStatus, sseConnected }: HeaderB
       </span>
       {/* Right: close button */}
       <div id="header-actions">
-        <button id="close-btn" title="Close player and return to terminal" onClick={handleClose}>
+        <button id="close-btn" title={isZh ? "关闭播放器并返回终端" : "Close player and return to terminal"} onClick={handleClose}>
           ✕
         </button>
       </div>

package/src/player/components/index.ts

@@ -1,5 +1,6 @@
 export { HeaderBar } from "./HeaderBar";
 export { EditControls } from "./EditControls";
+export { EditMessagePanel } from "./EditMessagePanel";
 export { LabelControls } from "./LabelControls";
 export { SceneThumbnails } from "./SceneThumbnails";
 export { VariantBar } from "./VariantBar";

package/src/player/pipeline.mjs

@@ -338,6 +338,8 @@ function compileLeaf(node2, ctx, parentKind) {
         zoom: node2.zoom ?? 10,
         center: node2.center,
         mapType: node2.mapType ?? "roadmap",
+        language: node2.language,
+        region: node2.region,
         travelMode: node2.travelMode ?? "DRIVING",
         routeMarker: node2.routeMarker ?? "\u{1F697}",
         googleMapsApiKey: ctx.googleMapsApiKey
@@ -1062,8 +1064,8 @@ var MAX_VIDEO_DURATION = Number(process.env.MARKCUT_MAX_VIDEO_DURATION) || 60;
 var MAX_VIDEO_DIMENSION = Number(process.env.MARKCUT_MAX_VIDEO_DIMENSION) || 360;
 var GOOGLE_MAPS_API_KEY = process.env.GOOGLE_MAPS_API_KEY || "";
 var DEFAULT_VTT_SAMPLE_INTERVAL = Number(process.env.MARKCUT_VTT_SAMPLE_INTERVAL) || 5;
-var DEFAULT_STT_CLI = args.cliOverrides.stt || process.env.MARKCUT_STT_CLI || 'uvx --from openai-whisper whisper "{input}" --output_format vtt --output_dir "{output}"';
-var DEFAULT_TTS_CLI = args.cliOverrides.tts || process.env.MARKCUT_TTS_CLI || 'uvx edge-tts --voice "en-US-GuyNeural" --text "{input}" --write-media "{output}"';
+var DEFAULT_STT_CLI = args.cliOverrides.stt || process.env.MARKCUT_STT_CLI || 'uvx --from openai-whisper whisper "{input}" --output_format vtt --output_dir "{output}" --word_timestamps True --max_line_count 1 --max_line_width 14';
+var DEFAULT_TTS_CLI = args.cliOverrides.tts || process.env.MARKCUT_TTS_CLI || 'uvx edge-tts --voice "zh-CN-YunxiNeural" --text "{input}" --write-media "{output}"';
 var DEFAULT_AGENT_CLI = args.cliOverrides.agent || process.env.MARKCUT_AGENT_CLI || "npx pi -p {prompt}";
 var DEFAULT_EDIT_CLI = args.cliOverrides.editCli || process.env.MARKCUT_EDIT_CLI || "npx pi --session-id {sessionid} --system-prompt {systemprompt} -p {prompt}";
 var DEFAULT_TTI_CLI = args.cliOverrides.tti || process.env.MARKCUT_TTI_CLI || 'uvx --from mflux mflux-generate-flux2 --model flux2-klein-4b --steps 2 --prompt "{input}" --output "{output}" --seed {seed}';
@@ -10413,6 +10415,8 @@ function parseNodeLine(content3, lineNum) {
         zoom: attrs.zoom,
         center: attrs.center,
         mapType: attrs.mapType,
+        language: attrs.language ?? attrs.lang,
+        region: attrs.region,
         instruction: attrs.instruction,
         visible: attrs.visible,
         isBackground: attrs.isBackground,

package/src/player/server-shared.mjs

@@ -128,7 +128,10 @@ export function serveFile(req, res, filePath) {
   const ext = extname(filePath).toLowerCase();
   const mime = MIME[ext] || "application/octet-stream";
   const fileSize = statSync(filePath).size;
-  const cacheControl = (ext === ".js" || ext === ".html") ? "no-cache" : "public, max-age=3600";
+  // Dynamic authoring assets (vtt/json/html/js) must not be cached,
+  // otherwise subtitle edits can appear stale after refresh.
+  const noStoreExt = new Set([".js", ".html", ".json", ".vtt"]);
+  const cacheControl = noStoreExt.has(ext) ? "no-store" : "public, max-age=3600";
   const range = req.headers.range;
 
   if (range) {

package/src/player/server.mjs

@@ -4,7 +4,7 @@
  *
  * Modes:
  *   --label   – playback with label input overlay; labels map to media timestamps
- *   --edit    – auto-reload when the JSON file changes (agent edits file, player refreshes)
+ *   --edit    – edit input mode with AI-assisted changes
  *
  * Usage:
  *   node src/player/server.mjs <video.json> [--label] [--edit] [--port 3001]
@@ -17,7 +17,7 @@ import { fileURLToPath } from "node:url";
 import { isDescriptiveRoot, resolveAndCompile, resolveAndCompileMarkdown, parseImportsBlock, extractDependencySpecs } from "./pipeline.mjs";
 import { bundleFromEntries } from "./bundler.mjs";
 import { extractScenes, MIME, serveFile, handleShutdown } from "./server-shared.mjs";
-import { DEFAULT_EDIT_CLI } from "../config.mjs";
+import { DEFAULT_EDIT_CLI, DEFAULT_STT_CLI, GOOGLE_MAPS_API_KEY } from "../config.mjs";
 
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -79,6 +79,14 @@ const VARIANT_CONFIGS = parseVariantConfigs();
 const sseClients = new Set();
 let shutdownTimer = null;
 
+/** Push a JSON event to all connected SSE clients. */
+function ssePush(data) {
+  const text = `data: ${JSON.stringify(data)}\n\n`;
+  for (const client of sseClients) {
+    try { client.write(text); } catch { sseClients.delete(client); }
+  }
+}
+
 // ─── Label store for label mode ───────────────────────────────────────────
 let labels = [];
 
@@ -128,16 +136,24 @@ function handleAgentLine(obj) {
   const t = obj.type;
   if (t === "message_end") {
     const txt = extractAssistantText(obj.message);
-    if (txt) agentTurnText += (agentTurnText ? "\n" : "") + txt;
+    if (txt) {
+      agentTurnText += (agentTurnText ? "\n" : "") + txt;
+      // Push incremental assistant text to SSE clients
+      ssePush({ type: "edit:progress", text: agentTurnText });
+    }
     return;
   }
   if (t === "agent_settled" && pendingEditResolver) {
+    ssePush({ type: "edit:done", summary: agentTurnText.substring(0, 120) });
     finishAgentTurn({ ok: true });
     return;
   }
   if (t === "response" && obj.command === "prompt" && pendingEditResolver) {
     // Preflight result: success means "accepted, events incoming"; failure aborts.
-    if (obj.success === false) finishAgentTurn({ ok: false, error: obj.error || "prompt rejected" });
+    if (obj.success === false) {
+      ssePush({ type: "edit:error", error: obj.error || "prompt rejected" });
+      finishAgentTurn({ ok: false, error: obj.error || "prompt rejected" });
+    }
     return;
   }
   if (t === "extension_error" && obj.error) {
@@ -447,11 +463,14 @@ async function compileVariant(config, parsed, raw) {
       scriptOutputDir: TTS_OUTPUT_DIR,
       mediaOutputDir: MEDIA_OUTPUT_DIR,
       includeOutputDir: INCLUDE_CACHE_DIR,
+      sttCli: DEFAULT_STT_CLI,
       subtitleOutputDir: subtitleDir,
       storyboard: MODE_STORYBOARD,
       variants: config.chain.length > 0 ? config.chain : undefined,
     });
-    compiled = compileDescriptiveRoot(resolved);
+    compiled = compileDescriptiveRoot(resolved, {
+      googleMapsApiKey: GOOGLE_MAPS_API_KEY || "",
+    });
   } else {
     const parsedJson = JSON.parse(raw);
     const root = parsedJson.root || parsedJson;
@@ -471,6 +490,7 @@ async function compileVariant(config, parsed, raw) {
         scriptOutputDir: TTS_OUTPUT_DIR,
         mediaOutputDir: MEDIA_OUTPUT_DIR,
         includeOutputDir: INCLUDE_CACHE_DIR,
+        sttCli: DEFAULT_STT_CLI,
         subtitleOutputDir: subtitleDir,
         storyboard: MODE_STORYBOARD,
         variants: config.chain.length > 0 ? config.chain : undefined,
@@ -667,40 +687,36 @@ function getScenes(label) {
 // Will be awaited before announcing "Player ready"
 const initScenesPromise = compileAndExtractScenes();
 
-// ─── Watch file for changes (--edit mode) ───────────────────────────────
-if (MODE_EDIT) {
-  let lastContent = readFileSync(VIDEO_JSON, "utf-8");
-  watchFile(VIDEO_JSON, { interval: 1000 }, async (curr, prev) => {
-    if (curr.mtimeMs === prev.mtimeMs) return;
-    if (pipelineRunning) return;
-    const newContent = readFileSync(VIDEO_JSON, "utf-8");
-    if (newContent === lastContent) return;
-    lastContent = newContent;
-    pipelineRunning = true;
-    console.log(`  📁 ${VIDEO_JSON} changed, re-running all variants...`);
+// ─── Watch source file for changes (all modes) ──────────────────────────
+let lastContent = readFileSync(VIDEO_JSON, "utf-8");
+watchFile(VIDEO_JSON, { interval: 1000 }, async (curr, prev) => {
+  if (curr.mtimeMs === prev.mtimeMs) return;
+  if (pipelineRunning) return;
+  const newContent = readFileSync(VIDEO_JSON, "utf-8");
+  if (newContent === lastContent) return;
+  lastContent = newContent;
+  pipelineRunning = true;
+  console.log(`  📁 ${VIDEO_JSON} changed, re-running all variants...`);
 
-    try {
-      compiledRootCache.clear();
-      scenesCache.clear();
-      await compileAllVariants();
-
-      for (const config of VARIANT_CONFIGS) {
-        try {
-          const root = await loadCompiledRoot(config.label);
-          scenesCache.set(config.label, extractScenes(root));
-        } catch {}
-      }
+  try {
+    compiledRootCache.clear();
+    scenesCache.clear();
+    await compileAllVariants();
 
-      for (const client of sseClients) {
-        client.write("data: " + JSON.stringify({ type: "reload" }) + "\n\n");
-      }
-    } catch (e) {
-      console.error("  ⚠️  Failed to re-process after change:", e.message);
-    } finally {
-      pipelineRunning = false;
+    for (const config of VARIANT_CONFIGS) {
+      try {
+        const root = await loadCompiledRoot(config.label);
+        scenesCache.set(config.label, extractScenes(root));
+      } catch {}
     }
-  });
-}
+
+    ssePush({ type: "reload" });
+  } catch (e) {
+    console.error("  ⚠️  Failed to re-process after change:", e.message);
+  } finally {
+    pipelineRunning = false;
+  }
+});
 // ─── MIME imported from ./server-shared.mjs ──────────────────────────────
 
 // ─── Variant detection from URL path ─────────────────────────────────────
@@ -762,7 +778,7 @@ function getHtml(variantLabel) {
   html, body { width: 100%; height: 100%; overflow: hidden; background: #0a0a0a; }
   body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; display: flex; flex-direction: column; align-items: center; }
   #header { display: flex; align-items: center; justify-content: flex-end; width: 100%; max-width: 500px; padding: 8px 12px; flex-shrink: 0; gap: 8px; }
-  #header-status, #edit-status { font-size: 11px; color: rgba(255,255,255,.4); flex: 1; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+  #header-status { font-size: 11px; color: rgba(255,255,255,.4); flex: 1; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
   #scene-info { font-size: 11px; color: rgba(255,255,255,.4); flex: 1; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
   #header-actions { display: flex; gap: 6px; align-items: center; flex-shrink: 0; }
   #close-btn { width: 22px; height: 22px; border-radius: 50%; border: 1px solid rgba(255,255,255,.15); background: rgba(0,0,0,.3); color: rgba(255,255,255,.4); font-size: 10px; cursor: pointer; display: flex; align-items: center; justify-content: center; transition: all .15s; }
@@ -771,7 +787,7 @@ function getHtml(variantLabel) {
   .variant-link { font-size: 11px; padding: 3px 10px; border-radius: 12px; background: rgba(255,255,255,.06); color: rgba(255,255,255,.4); text-decoration: none; white-space: nowrap; transition: all .15s; }
   .variant-link:hover { background: rgba(255,255,255,.12); color: rgba(255,255,255,.7); }
   .variant-link.active { background: rgba(74,158,255,.2); color: #4a9eff; }
-  #player-frame { flex: 1; width: 100%; max-width: 480px; min-height: 0; border-radius: 16px; overflow: hidden; border: 1px solid rgba(255,255,255,.08); background: #000; box-shadow: 0 4px 40px rgba(0,0,0,.6); margin: 0 12px; }
+  #player-frame { flex: 1; width: 100%; max-width: 480px; min-height: 0; border-radius: 16px; overflow: hidden; border: 1px solid rgba(255,255,255,.08); background: #000; box-shadow: 0 4px 40px rgba(0,0,0,.6); margin: 0 12px; position: relative; }
   #root { width: 100%; height: 100%; }
   #reload-toast { position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%); background: rgba(74,158,255,.9); color: #fff; padding: 12px 24px; border-radius: 10px; font-size: 14px; font-weight: 600; opacity: 0; transition: opacity .3s; pointer-events: none; z-index: 200; backdrop-filter: blur(8px); }
   #reload-toast.show { opacity: 1; }
@@ -805,6 +821,136 @@ function getHtml(variantLabel) {
   .scene-pill { flex-shrink: 0; padding: 4px 12px; border-radius: 12px; cursor: pointer; border: 1px solid transparent; transition: all .15s; background: rgba(255,255,255,.06); color: rgba(255,255,255,.45); font-size: 11px; white-space: nowrap; }
   .scene-pill:hover { border-color: rgba(74,158,255,.4); color: rgba(255,255,255,.7); }
   .scene-pill.active { background: rgba(74,158,255,.2); border-color: #4a9eff; color: #4a9eff; }
+
+  .subtitle-overlay>*{width:100%}
+
+  /* ── Edit message panel ───────────────────────────────────────────── */
+  #edit-message-overlay {
+    position: absolute;
+    left: 8px;
+    right: 8px;
+    top: 8px;
+    z-index: 30;
+    pointer-events: none;
+  }
+  #edit-message-panel {
+    width: 100%;
+    max-width: 100%;
+    flex-shrink: 0;
+    background: rgba(12,12,12,.78);
+    border: 1px solid rgba(255,255,255,.08);
+    border-radius: 10px;
+    margin: 0;
+    overflow: hidden;
+    backdrop-filter: blur(8px);
+    pointer-events: auto;
+  }
+  #edit-message-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 6px 10px;
+    font-size: 11px;
+    color: rgba(255,255,255,.5);
+    border-bottom: 1px solid rgba(255,255,255,.06);
+  }
+  #edit-message-minimize {
+    width: 20px;
+    height: 20px;
+    padding: 0;
+    background: rgba(255,255,255,.06);
+    color: rgba(255,255,255,.4);
+    border: 1px solid rgba(255,255,255,.1);
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: 10px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all .15s;
+  }
+  #edit-message-minimize:hover {
+    background: rgba(74,158,255,.2);
+    border-color: rgba(74,158,255,.4);
+    color: #4a9eff;
+  }
+  #edit-message-list {
+    max-height: 150px;
+    overflow-y: auto;
+    padding: 6px 10px;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    scrollbar-width: thin;
+  }
+  #edit-message-list::-webkit-scrollbar { width: 4px; }
+  #edit-message-list::-webkit-scrollbar-thumb { background: rgba(255,255,255,.15); border-radius: 2px; }
+  .edit-message-empty {
+    font-size: 11px;
+    color: rgba(255,255,255,.25);
+    padding: 8px 0;
+    text-align: center;
+  }
+  .edit-message-entry {
+    font-size: 11px;
+    line-height: 1.5;
+    padding: 4px 6px;
+    border-radius: 6px;
+    background: rgba(255,255,255,.03);
+  }
+  .edit-message-entry.error {
+    background: rgba(255,60,60,.08);
+  }
+  .edit-role {
+    font-weight: 600;
+    color: rgba(255,255,255,.5);
+    margin-right: 4px;
+  }
+  .edit-message-request {
+    color: rgba(255,255,255,.6);
+  }
+  .edit-message-thinking {
+    color: rgba(74,158,255,.7);
+  }
+  .edit-dots span {
+    animation: editDotPulse 1.4s infinite;
+    opacity: 0;
+  }
+  .edit-dots span:nth-child(1) { animation-delay: 0s; }
+  .edit-dots span:nth-child(2) { animation-delay: 0.2s; }
+  .edit-dots span:nth-child(3) { animation-delay: 0.4s; }
+  @keyframes editDotPulse {
+    0%   { opacity: 0; }
+    50%  { opacity: 1; }
+    100% { opacity: 0; }
+  }
+  .edit-message-response {
+    color: rgba(74,222,128,.8);
+    white-space: pre-wrap;
+    word-break: break-word;
+  }
+  .edit-message-error {
+    color: rgba(255,100,100,.8);
+  }
+  #edit-message-bar {
+    display: block;
+    width: auto;
+    padding: 4px 12px;
+    margin: 4px 12px;
+    border-radius: 14px;
+    border: 1px solid rgba(255,255,255,.1);
+    background: rgba(74,158,255,.12);
+    color: rgba(74,158,255,.8);
+    font-size: 11px;
+    cursor: pointer;
+    transition: all .15s;
+    flex-shrink: 0;
+    white-space: nowrap;
+  }
+  #edit-message-bar:hover {
+    background: rgba(74,158,255,.2);
+    border-color: rgba(74,158,255,.4);
+  }
 </style>
 </head>
 <body>
@@ -963,6 +1109,9 @@ Edit request: ${text}`;
 
           console.log(`  🤖 edit: ${text}  (${currentTime !== undefined ? currentTime.toFixed(1) + "s" : ""} ${activeScene || ""})`);
 
+          // Push start event to SSE clients for real-time UI feedback
+          ssePush({ type: "edit:start", request: text });
+
           // Send to the persistent rpc agent (one cold start; conversation kept in memory)
           const result = await sendToAgent(userPrompt);
 
@@ -988,10 +1137,12 @@ Edit request: ${text}`;
           } else {
             const msg = result.error || "failed";
             console.error(`  ❌ edit ${msg}: ${(result.output || "").trim().substring(0, 100)}`);
+            ssePush({ type: "edit:error", error: msg });
             res.writeHead(500, { "Content-Type": "application/json" });
             res.end(JSON.stringify({ error: msg, output: (result.output || "").trim().substring(0, 200) }));
           }
         } catch (e) {
+          ssePush({ type: "edit:error", error: e.message });
           res.writeHead(500, { "Content-Type": "application/json" });
           res.end(JSON.stringify({ error: e.message }));
         }
@@ -1032,7 +1183,10 @@ Edit request: ${text}`;
       try {
         const root = await loadCompiledRoot(variantLabel);
         const rootOut = resolveAssetPaths(root);
-        res.writeHead(200, { "Content-Type": "application/json" });
+        res.writeHead(200, {
+          "Content-Type": "application/json",
+          "Cache-Control": "no-store",
+        });
         res.end(JSON.stringify(rootOut));
       } catch (e) {
         res.writeHead(500, { "Content-Type": "application/json" });
@@ -1044,7 +1198,10 @@ Edit request: ${text}`;
     // API: Get scenes with media info for a specific variant
     if (path === "/api/scenes") {
       const { scenes, totalDuration } = getScenes(variantLabel);
-      res.writeHead(200, { "Content-Type": "application/json" });
+      res.writeHead(200, {
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+      });
       res.end(JSON.stringify(scenes));
       return;
     }
@@ -1052,7 +1209,10 @@ Edit request: ${text}`;
     // API: Get current video info for a specific variant
     if (path === "/api/video-info") {
       const { scenes, totalDuration } = getScenes(variantLabel);
-      res.writeHead(200, { "Content-Type": "application/json" });
+      res.writeHead(200, {
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+      });
       res.end(JSON.stringify({
         scenes,
         totalDuration,
@@ -1115,6 +1275,6 @@ server.listen(PORT, async () => {
       console.log(`   ${config.label}: ${url}`);
     }
   }
-  if (MODE_EDIT) console.log(`   Watching: ${VIDEO_JSON.split("/").pop()}`);
+  console.log(`   Watching: ${VIDEO_JSON.split("/").pop()}`);
   console.log("");
 });

package/src/render/cli.mjs

@@ -496,7 +496,7 @@ function hasScript(root) {
 
       // Compile to validate
       const compiled = compileDescriptiveRoot(descriptive);
-      emitSuccess(`Valid. Duration: ~${compiled.durationInSeconds ?? "?"}s, Scenes: ${compiled.children?.length ?? 0}`);
+      emitSuccess(`Valid`);
       process.exit(0);
 
     } catch (err) {

package/src/schema/index.ts

@@ -228,6 +228,8 @@ export const mapStream = base.extend({
   zoom: z.number().default(10),
   center: z.object({ lat: z.number(), lng: z.number() }).optional().describe("map view center (defaults to first waypoint)"),
   mapType: z.enum(["roadmap", "satellite", "hybrid", "terrain"]).default("roadmap").describe("Google Maps style"),
+  language: z.string().optional().describe("Google Maps UI/label language, e.g. zh-CN"),
+  region: z.string().optional().describe("Google Maps region code, e.g. CN"),
   travelMode: z.enum(["DRIVING", "WALKING", "BICYCLING", "TRANSIT"]).default("DRIVING").describe("Directions API travel mode"),
   routeMarker: z.string().default("🚗").describe("emoji/character for the animated traveling marker"),
   googleMapsApiKey: z.string().optional().describe("injected by compiler from GOOGLE_MAPS_API_KEY env var"),