cozyclay 3.1.1 → 3.1.3

package/dist/cozyclay-package.json

@@ -1 +1 @@
-{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"3.1.1\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"65554e5162b89f817b066016390471333bfcabcee80e0ae0ee46939bdc759599\"}","signature":"M4R6haq7YzLWxDPcdy5h4zI/w7nVEBubTszIj4UzgWEKB4XZgZYtrjsQJmjt2rF3IooyCKnvMlzNiYB/arAGDg=="}
+{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"3.1.3\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"9c94e22b92abbaaee2aefc22fdf0e2a5fe5de745d82739751ae08884b1f655bd\"}","signature":"sY+Pss1UzGZHXmVNKQRKwpxGLw6xN1iMtej6DnUUrBusSndF/2SePRXbdL0PO1CiM6Y6nsECF9EeuIZo125ZDQ=="}

package/dist/index.html

@@ -394,7 +394,7 @@
         <div class="wrap start">
           <div class="start-head">
             <h2>Quick start</h2>
-            <p>Node.js 22.13+ and a Chromium browser.</p>
+            <p>Node.js 22.19+ and a Chromium browser.</p>
             <a href="#controls" id="controls-link">Full control list</a>
           </div>
           <div class="start-body">

package/dist/sitemap.xml

@@ -2,7 +2,7 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://cozyclay.org/</loc>
-    <lastmod>2026-10-21</lastmod>
+    <lastmod>2026-10-23</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/greybox-to-video/</loc>

package/dist/workflow/index.html

@@ -8,13 +8,13 @@
     <meta name="theme-color" content="#101116" />
     <meta name="description" content="CozyClay visual workflow builder" />
     <title>CozyClay Workflow</title>
-    <script type="module" crossorigin src="/assets/workflow-zQM-EKW1.js"></script>
+    <script type="module" crossorigin src="/assets/workflow-BMJGd_gZ.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
     <link rel="modulepreload" crossorigin href="/assets/modulepreload-polyfill-P2Xu9kJm.js">
-    <link rel="modulepreload" crossorigin href="/assets/task-board-ErQvfoaz.js">
+    <link rel="modulepreload" crossorigin href="/assets/task-board-DFfNa0xg.js">
     <link rel="modulepreload" crossorigin href="/assets/fflate.module-KbGj5-H6.js">
-    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-Cgdtr1Yw.js">
-    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-CBx7XRti.css">
+    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-Bz59Ghdz.js">
+    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-BEjjhNEo.css">
     <link rel="stylesheet" crossorigin href="/assets/workflow-DRdwoDBT.css">
   </head>
   <body>

package/mcp/README.md

@@ -35,7 +35,7 @@ Then point a client at it. For Claude Desktop, in `claude_desktop_config.json`:
 }
 ```
 
-Restart the client; 28 tools appear.
+Restart the client; 27 tools appear.
 
 Prefer a long-lived endpoint? `node server.mjs --http 5183` serves Streamable HTTP at
 `http://127.0.0.1:5183/mcp` (one isolated session per client), with a plain status page at `/`.

package/mcp/live-hub.mjs

@@ -436,10 +436,12 @@ export class LiveHub {
 				void this.serveController(socket, frame);
 				return;
 			}
-			if (frame?.type === "event" && typeof frame.name === "string" && frame.payload && typeof frame.payload === "object") {
-				const workspaceHandle = [...this.editors.entries()].find(([, editor]) => editor === socket)?.[0];
+			// Meta and event frames both act for this socket's workspace. A meta frame
+			// relabels the tab after it opens another project; the handle stays.
+			const workspaceHandle = [...this.editors.entries()].find(([, editor]) => editor === socket)?.[0];
+			if (frame?.type === "meta" && workspaceHandle && frame.meta && typeof frame.meta === "object") this.workspaceMeta.set(workspaceHandle, frame.meta);
+			else if (frame?.type === "event" && typeof frame.name === "string" && frame.payload && typeof frame.payload === "object") {
 				if (workspaceHandle) this.onEvent?.({ workspaceHandle, workspaceId: this.workspaceId(workspaceHandle), name: frame.name, payload: frame.payload });
-				return;
 			}
 			if (frame?.type !== "result" || typeof frame.id !== "string") return;
 			const pending = this.pending.get(frame.id);

package/mcp/tool-handlers.mjs

@@ -71,6 +71,7 @@ import {
 import { classifyMove, captureFraming, moveSlate } from "../src/camera-move.js";
 import { DEFAULT_PREVIS_MODE, PREVIS_MODES, createProjectDocument, readProjectDocument } from "../src/project.js";
 import { kindRefusal } from "../src/character-kind.js";
+import { documentWithCamera, splitSavedCamera } from "./project-camera.mjs";
 
 /** The authoring state. One scene document, one camera, one project name. */
 export const state = {
@@ -1697,7 +1698,7 @@ export const createToolHandlers = ({ projectRootPromise } = {}) => {
 				// the current stage shape rather than trusted as-is.
 				const scenes = readSceneDocument(serializeSceneDocument(result.project.scenesDocument));
 				if (!scenes.document) return text(`That project was written by a newer CozyClay: ${full}`);
-				const nextDocument = scenes.document;
+				const { document: nextDocument, camera: savedCamera } = splitSavedCamera(scenes.document);
 				if (liveHub?.connected) {
 					try {
 						const loaded = await executeStudioCommand({ ...admission, action: "load_scenes", args: { document: nextDocument } });
@@ -1713,11 +1714,10 @@ export const createToolHandlers = ({ projectRootPromise } = {}) => {
 					}
 				}
 				state.doc = nextDocument;
+				Object.assign(state.camera, savedCamera);
 				state.previsMode = result.project.previsMode ?? DEFAULT_PREVIS_MODE;
 				state.name = result.project.name;
-				state.focus = null;
-				state.focusLocked = false;
-				state.markedFraming = null;
+				Object.assign(state, { focus: null, focusLocked: false, markedFraming: null });
 				return text(`Opened ${full}.\n\n${sceneReport()}`);
 			},
 		),
@@ -1753,7 +1753,7 @@ export const createToolHandlers = ({ projectRootPromise } = {}) => {
 					return text(`Could not write project: ${error.message}`);
 				}
 				const project = createProjectDocument({
-					scenesDocument: state.doc,
+					scenesDocument: documentWithCamera(state.doc, state.camera),
 					workspaceLayout: null,
 					customPoses: [],
 					name: state.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozyclay",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "description": "Open source previs software in the browser: block a scene, pose characters, author camera moves and cuts, then take the same shots to an AI video model.",
   "scripts": {
     "dev": "node tools/dev-full.mjs --host 127.0.0.1 --port 5180",
@@ -61,9 +61,11 @@
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "dependencies": {
-    "@earendil-works/pi-agent-core": "0.85.1",
-    "@earendil-works/pi-ai": "0.85.1",
-    "@earendil-works/pi-codemode": "1.1.0"
+    "@anthropic-ai/claude-agent-sdk": "^0.3.306",
+    "@earendil-works/pi-agent-core": "1.4.0",
+    "@earendil-works/pi-ai": "1.4.0",
+    "@earendil-works/pi-codemode": "1.4.0",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/src/App.jsx

@@ -151,7 +151,8 @@ import {
 	trackActivation,
 	trackFeature,
 } from "./analytics.js";
-import { ko, isKo } from "./locale.js";
+import { ko, isKo, isZh } from "./locale.js";
+import { saveExport } from "./export-workspace.js";
 import { characterCapabilities, kindRefusal, proxyFigureBounds } from "./character-kind.js";
 import { STARTER_SCENES, resolveSceneParam } from "./starter-scenes.js";
 import { PART_COLOURS } from "./part-colours.js";
@@ -1146,7 +1147,7 @@ export default function App() {
 	// A capsule figure has no rig at all, so it gets its own reason rather than
 	// the "load a character" one, which would read as a loading problem.
 	const activeCapabilities = characterCapabilities(activeChar);
-	const poseRefusal = !activeCapabilities.pose ? kindRefusal("pose", isKo) : ikChains ? null : ko("Load a character to pose it — Pose mode edits its rig with IK", "캐릭터를 불러와야 포즈를 잡을 수 있어요 — 포즈 모드는 IK로 리그를 편집합니다");
+	const poseRefusal = !activeCapabilities.pose ? kindRefusal("pose", isKo, isZh) : ikChains ? null : ko("Load a character to pose it — Pose mode edits its rig with IK", "캐릭터를 불러와야 포즈를 잡을 수 있어요 — 포즈 모드는 IK로 리그를 편집합니다", "加载角色后才能摆姿势 — 姿势模式用 IK 编辑其骨骼");
 	function selectWorkflowMode(next) {
 		if (next === "pose" && poseRefusal) {
 			setToast(poseRefusal);
@@ -1154,7 +1155,7 @@ export default function App() {
 		}
 		// A storyboard is stills: there is no Motion department to open.
 		if (next === "motion" && storyboardProject) {
-			setToast(ko(STORYBOARD_MOTION_REFUSAL.en, STORYBOARD_MOTION_REFUSAL.ko));
+			setToast(ko(STORYBOARD_MOTION_REFUSAL.en, STORYBOARD_MOTION_REFUSAL.ko, STORYBOARD_MOTION_REFUSAL.zh));
 			return;
 		}
 		setWorkflowMode(next);
@@ -1257,7 +1258,7 @@ export default function App() {
 			setSculptBlueprint((current) => ({ ...current, state: "idle", sheet: null, error: null }));
 			setSculptReference(await objectsDomain.storeSculptReference(file));
 		} catch (error) {
-			setToast(ko(`Could not read that image: ${error.message}`, `이미지를 읽지 못했어요: ${error.message}`));
+			setToast(ko(`Could not read that image: ${error.message}`, `이미지를 읽지 못했어요: ${error.message}`, `无法读取该图片：${error.message}`));
 		}
 	}
 	function startSculptRun() {
@@ -1477,7 +1478,7 @@ export default function App() {
 
 	const rejectUnsupportedDrop = (count) => setToast(ko(
 		`${count} file${count > 1 ? "s" : ""} not supported — use PNG, JPG, WebP, GIF or a .glb / .obj / .fbx (iPhone HEIC photos need converting first)`,
-		`지원하지 않는 파일 ${count}개 — PNG, JPG, WebP, GIF 또는 .glb / .obj / .fbx만 가능해요 (아이폰 HEIC 사진은 먼저 변환해 주세요)`,
+		`지원하지 않는 파일 ${count}개 — PNG, JPG, WebP, GIF 또는 .glb / .obj / .fbx만 가능해요 (아이폰 HEIC 사진은 먼저 변환해 주세요)`, `不支持 ${count} 个文件 — 请使用 PNG、JPG、WebP、GIF 或 .glb / .obj / .fbx（iPhone HEIC 照片需先转换）`,
 	));
 	const stageDrop = {
 		onImages: (files) => importCutouts(files),
@@ -1785,7 +1786,7 @@ export default function App() {
 	// so run_action can give the agent the reason the user was shown.
 	const toastSinkRef = useRef(new Set());
 	const setToast = useCallback((value, english) => {
-		const toast = resolveStudioToast(value, isKo, ko);
+		const toast = resolveStudioToast(value, isKo, ko, isZh);
 		if (english !== undefined) toast.message = english;
 		if (typeof toast.uiMessage === "string" && toast.uiMessage) for (const sink of toastSinkRef.current) sink(toast);
 		showToast(toast.uiMessage);
@@ -1947,7 +1948,7 @@ export default function App() {
 			deleted = true;
 			return true;
 		} catch (error) {
-			setToast(isKo ? `이미지를 삭제하지 못했어요 — ${error.message}` : `Could not delete that image — ${error.message}`);
+			setToast(ko(`Could not delete that image — ${error.message}`, `이미지를 삭제하지 못했어요 — ${error.message}`, `无法删除该图片 — ${error.message}`));
 			return false;
 		} finally {
 			db?.close?.();
@@ -1970,9 +1971,9 @@ export default function App() {
 			setAssetTrash((current) => current.filter((asset) => asset.id !== record.id));
 			setAssetUndoOffered(false);
 			restored = true;
-			setToast(isKo ? `${record.name || "이미지"} 복원됨` : `${record.name || "Image"} restored`);
+			setToast(ko(`${record.name || "Image"} restored`, `${record.name || "이미지"} 복원됨`, `${record.name || "图片"}已恢复`));
 		} catch (error) {
-			setToast(isKo ? `이미지를 복원하지 못했어요 — ${error.message}` : `Could not restore that image — ${error.message}`);
+			setToast(ko(`Could not restore that image — ${error.message}`, `이미지를 복원하지 못했어요 — ${error.message}`, `无法恢复该图片 — ${error.message}`));
 		} finally {
 			if (restored) await refreshAssetShelf();
 			setDeletingAssetId(null);
@@ -2463,6 +2464,17 @@ export default function App() {
 			capture_plan_png: (args = {}) => appContext.live.state.capturePlanPng(requestedCaptureOutput(args) ?? undefined),
 	};
 
+	const liveSceneName = scenes.find((entry) => entry.id === activeSceneId)?.name ?? "";
+	const liveMeta = () => ({
+		project: projectName ?? "Untitled", scene: liveSceneName, cast: appContext.live.characters.length,
+		// The Workflow page's embedded preview is a live editor too; mark it apart from the authoring tab.
+		// Commands: what this editor answers; a stale tab from an older build answers a different set.
+		...(embedMode ? { embed: true } : {}), commands: [...Object.keys(liveQueries), ...Object.keys(studioBindingRef.current.handlers)],
+	});
+	// The client is created once; opening a project must still relabel the tab
+	// in live status and the --workspace <project> selector (#864).
+	useEffect(() => { liveControlRef.current?.setMeta(liveMeta()); }, [projectName, liveSceneName, appContext.live.characters.length]);
+
 	useEffect(() => {
 		const enabled = import.meta.env.DEV || window.__COZYCLAY_LIVE__ === true;
 		if (!enabled) return undefined;
@@ -2474,19 +2486,7 @@ export default function App() {
 					// Tapped so a sculpt run hears the agent's object.sculpt / sculpt.compare.
 					handlers: sculptTap.wrap({ ...liveQueries, ...studioBindingRef.current.handlers }),
 					workspaceId: liveWorkspaceIdRef.current,
-					meta: {
-						project: projectName ?? "Untitled",
-						scene: scenes.find((entry) => entry.id === activeSceneId)?.name ?? "",
-						cast: appContext.live.characters.length,
-						// The Workflow page embeds this same Studio as a preview. It is a
-						// live editor too, so an agent choosing a workspace must be able to
-						// tell the preview apart from the tab the user is authoring in.
-						...(embedMode ? { embed: true } : {}),
-						// Which live commands this editor answers. A stale tab from an
-						// older build (or a different app on the same port) answers a
-						// different set; the agent picks a workspace that has what it needs.
-						commands: [...Object.keys(liveQueries), ...Object.keys(studioBindingRef.current.handlers)],
-					},
+					meta: liveMeta(),
 					// The shared client intentionally has no disconnect UI callback.
 					// Observe only this owned socket; a stale handle must never be sent.
 					WebSocketImpl: class extends WebSocket {
@@ -2776,7 +2776,7 @@ export default function App() {
 			case "unsupported_codec": return ko("MP4 encoding is unavailable. Use a current browser with H.264 WebCodecs support (such as Chrome or Edge), enable hardware acceleration, then retry.", "MP4 인코딩을 사용할 수 없어요. H.264 WebCodecs를 지원하는 최신 Chrome·Edge 등에서 하드웨어 가속을 켠 뒤 다시 시도하세요.");
 			case "encode_failed": return ko("Video encoding failed. Retry the same request. If resources are tight, shorten the shot range or lower output resolution before starting a new export.", "영상 인코딩에 실패했어요. 같은 요청을 다시 시도하세요. 리소스가 부족하면 샷 범위를 줄이거나 출력 해상도를 낮춘 뒤 새로 내보내세요.");
 			case "render_failed": return ko("Frame rendering failed. Let the scene finish loading, then retry. If it repeats, shorten the range or reduce output resolution for a new export.", "프레임 렌더링에 실패했어요. 장면 로딩이 끝난 뒤 다시 시도하세요. 반복되면 범위나 출력 해상도를 줄여 새로 내보내세요.");
-			case "aborted": return ko("Export cancelled. No further downloads will be requested.", "내보내기를 취소했어요. 추가 다운로드는 요청하지 않아요.");
+			case "aborted": return ko("Export cancelled. No further files will be handed off.", "내보내기를 취소했어요. 추가 파일은 전달하지 않아요.");
 			default: return ko("Export could not finish. Retry the same request. For memory or resource problems, close other heavy tabs or use a shorter range / lower output resolution in a new export.", "내보내기를 완료하지 못했어요. 같은 요청을 다시 시도하세요. 메모리·리소스 문제라면 무거운 탭을 닫거나 범위·출력 해상도를 줄여 새로 내보내세요.");
 		}
 	}
@@ -2821,7 +2821,7 @@ export default function App() {
 			job.controller.signal.throwIfAborted();
 			attempt?.succeed();
 			updateExportStatus(job, "completed", { message: request.download
-				? ko("Export completed. Download requested; check your browser's downloads. The OS save is not confirmed.", "내보내기를 완료하고 다운로드를 요청했어요. 브라우저 다운로드를 확인하세요. OS 저장 완료는 확인할 수 없어요.")
+				? ko("Export completed. Check your export folder or browser downloads; the OS save is not confirmed.", "내보내기를 완료했어요. 내보내기 폴더나 브라우저 다운로드를 확인하세요. OS 저장 완료는 확인할 수 없어요.")
 				: ko("Export pipeline completed. The requesting tool handles the file handoff.", "내보내기 처리를 완료했어요. 요청한 도구에서 파일 전달을 처리합니다.") });
 			if (!request.external) {
 				if (request.kind === "video") { track("export:video_succeeded", { format: "mp4" }); trackFeature("export_video"); }
@@ -3010,11 +3010,9 @@ export default function App() {
 			const slate = (moveSequence?.slate ?? "shot").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "shot";
 			// Default plate filename: const name = `cozyclay-${slate}.mp4`
 			const name = fileName ?? `cozyclay-${slate}.mp4`;
-			const url = URL.createObjectURL(result.blob);
-			try { saveDownload(url, name); }
-			finally { setTimeout(() => URL.revokeObjectURL(url), 10_000); }
+			await saveExport(result.blob, name);
 			setRecordedVideoName(name);
-			setToast((isKo, ko) => isKo ? `${name} 다운로드 요청 · ${result.frameCount}프레임` : `Download requested: ${name} · ${result.frameCount} frames`);
+			setToast((isKo, ko) => ko(`${name} exported · ${result.frameCount} frames`, `${name} 내보내기 완료 · ${result.frameCount}프레임`, `${name} 已导出 · ${result.frameCount} 帧`));
 			return { ...result, fileName: name };
 		}
 		return result;
@@ -3079,13 +3077,13 @@ export default function App() {
 				{busy && !message && <p>{stage === "mux"
 					? ko("Finalizing MP4. Progress is indeterminate; this stage cannot be interrupted.", "MP4 마무리 중이에요. 진행률은 알 수 없으며 이 단계는 중단할 수 없어요.")
 					: stage === "flush" ? ko("Finishing encoder output. Progress is indeterminate.", "인코더 출력을 마무리하고 있어요. 진행률은 알 수 없어요.")
-					: kind === "frame" ? ko("Handing off existing PNGs. Synchronous downloads cannot be cancelled.", "기존 PNG를 전달하고 있어요. 동기 다운로드는 취소할 수 없어요.")
-					: stage === "archive" ? ko("Building the ZIP. Cancel takes effect after the current work unit, before download.", "ZIP을 만드는 중이에요. 취소는 현재 작업이 끝난 뒤 다운로드 전에 적용돼요.")
-					: stage === "depth" || stage === "frames" ? ko("Cancel stops at the next frame boundary, before download.", "취소하면 다운로드 전 다음 프레임 경계에서 멈춰요.")
+					: kind === "frame" ? ko("Handing off existing PNGs. The file handoff cannot be cancelled.", "기존 PNG를 전달하고 있어요. 파일 전달은 취소할 수 없어요.")
+					: stage === "archive" ? ko("Building the ZIP. Cancel takes effect after the current work unit, before the file handoff.", "ZIP을 만드는 중이에요. 취소는 현재 작업이 끝난 뒤 파일 전달 전에 적용돼요.")
+					: stage === "depth" || stage === "frames" ? ko("Cancel stops at the next frame boundary, before the file handoff.", "취소하면 파일 전달 전 다음 프레임 경계에서 멈춰요.")
 					: phase === "preparing" ? ko("Preparing the renderer and checking MP4 support…", "렌더러를 준비하고 MP4 지원을 확인하고 있어요…")
 					: ko("Encoding the requested frames, not yet a completed file.", "요청한 프레임을 인코딩 중이에요. 아직 파일이 완성되지 않았어요.")}</p>}
 				{retryable && <p>{ko("Retry keeps the original shot, camera, range and settings; it does not change your edits.", "다시 시도하면 원래 샷·카메라·범위·설정을 사용하며 편집 내용은 바꾸지 않아요.")}</p>}
-				{handedOff > 0 && <p>{ko(`${handedOff} file(s) already handed off. Retry skips those downloads; check browser downloads because OS saves cannot be confirmed.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 다운로드는 건너뛰어요. OS 저장은 확인할 수 없으니 브라우저 다운로드를 확인하세요.`)}</p>}
+				{handedOff > 0 && <p>{ko(`${handedOff} file(s) already handed off. Retry skips those files; check your export folder or browser downloads because OS saves cannot be confirmed.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 파일은 건너뛰어요. OS 저장은 확인할 수 없으니 내보내기 폴더나 브라우저 다운로드를 확인하세요.`, `已交付 ${handedOff} 个文件。重试时会跳过这些文件；由于无法确认系统保存，请检查导出文件夹或浏览器下载。`)}</p>}
 				<div className="export-status-actions">
 					{busy && cancellable && <button type="button" data-testid="export-cancel" onClick={stopShotRecording}>{ko("Cancel export", "내보내기 취소")}</button>}
 					{retryable && <button type="button" data-testid="export-retry" disabled={recState === "recording"} onClick={() => void retryExport()}>{ko("Retry same export", "같은 내보내기 재시도")}</button>}
@@ -3094,7 +3092,7 @@ export default function App() {
 		);
 	}
 
-	function downloadOtioCutList() {
+	async function downloadOtioCutList() {
 		if (!shots.length) {
 			setToast(ko("Add at least one Shot before exporting OTIO", "OTIO를 내보내려면 샷을 하나 이상 추가하세요"));
 			return;
@@ -3113,20 +3111,15 @@ export default function App() {
 			};
 			const serialized = serializeOtio(exportScene, shots);
 			const blob = new Blob([serialized], { type: "application/json" });
-			const url = URL.createObjectURL(blob);
-			const anchor = document.createElement("a");
 			const slug = (activeScene?.name ?? "cut-list")
 				.toLowerCase()
 				.replace(/[^a-z0-9]+/g, "-")
 				.replace(/^-+|-+$/g, "") || "cut-list";
-			anchor.href = url;
-			anchor.download = `cozyclay-${slug}.otio`;
-			anchor.click();
-			setTimeout(() => URL.revokeObjectURL(url), 10_000);
+			await saveExport(blob, `cozyclay-${slug}.otio`);
 			const frameCount = shots.reduce((total, shot) => total + shot.endFrame - shot.startFrame + 1, 0);
-			setToast(isKo
-				? `OTIO 저장됨 · ${shots.length}샷 · ${frameCount}프레임`
-				: `OTIO saved · ${shots.length} shots · ${frameCount} frames`);
+			setToast(ko(`OTIO saved · ${shots.length} shots · ${frameCount} frames`,
+				`OTIO 저장됨 · ${shots.length}샷 · ${frameCount}프레임`,
+				`OTIO 已保存 · ${shots.length} 个镜头 · ${frameCount} 帧`));
 		} catch (error) {
 			setToast(error?.message || String(error));
 		}
@@ -3141,15 +3134,6 @@ export default function App() {
 	 *   - a storyboard contact sheet of the whole cut.
 	 */
 
-	function saveDownload(href, name) {
-		const anchor = document.createElement("a");
-		anchor.href = href;
-		anchor.download = name;
-		document.body.appendChild(anchor);
-		anchor.click();
-		anchor.remove();
-	}
-
 	function loadImage(dataUrl) {
 		return new Promise((resolve, reject) => {
 			const image = new Image();
@@ -3217,13 +3201,13 @@ export default function App() {
 		updateExportStatus(job, "preparing", { stage: "frames", cancellable: true });
 		await exportBoundary(job);
 		const packShot = { title: entry.name, index: index + 1, startFrame: entry.startFrame, endFrame: entry.endFrame };
-		onProgress?.(ko(`Rendering frames for "${entry.name}"`, `"${entry.name}" 프레임 렌더링 중`));
+		onProgress?.(ko(`Rendering frames for "${entry.name}"`, `"${entry.name}" 프레임 렌더링 중`, `正在渲染“${entry.name}”的帧`));
 		const firstUrl = captureShotFramePng(entry.startFrame);
 		if (!firstUrl) throw Object.assign(new Error(ko("The shot renderer is not ready", "샷 렌더러가 아직 준비되지 않았어요")), { exportFailureCode: "render_failed" });
 		await exportBoundary(job);
 		const lastUrl = entry.endFrame > entry.startFrame ? captureShotFramePng(entry.endFrame) : null;
 		await exportBoundary(job);
-		onProgress?.(ko(`Recording the clip for "${entry.name}"`, `"${entry.name}" 클립 녹화 중`));
+		onProgress?.(ko(`Recording the clip for "${entry.name}"`, `"${entry.name}" 클립 녹화 중`, `正在录制“${entry.name}”的片段`));
 		const recorded = await runShotExport({ startFrame: entry.startFrame, endFrame: entry.endFrame, download: false }, job);
 		updateExportStatus(job, "finalizing", { stage: "archive", cancellable: true });
 		await exportBoundary(job);
@@ -3276,24 +3260,23 @@ export default function App() {
 			if (!job.request.context.shots.length) throw new Error(ko("Add at least one Shot before exporting a keyframe pack", "키프레임 팩을 내보내려면 샷을 하나 이상 추가하세요"));
 			for (const [order, index] of targets.entries()) {
 				if (job.request.handedOff.has(index)) continue;
-				job.label = ko(`Shot ${order + 1} of ${targets.length}`, `샷 ${order + 1} / ${targets.length}`);
+				job.label = ko(`Shot ${order + 1} of ${targets.length}`, `샷 ${order + 1} / ${targets.length}`, `镜头 ${order + 1} / ${targets.length}`);
 				const pack = await buildShotKeyframePack(job.request.context.shots[index], index, null, job);
 				job.controller.signal.throwIfAborted();
-				const url = URL.createObjectURL(new Blob([pack.bytes], { type: "application/zip" }));
-				try { saveDownload(url, pack.name); job.request.handedOff.add(index); }
-				finally { setTimeout(() => URL.revokeObjectURL(url), 10_000); }
-				setToast(isKo ? `${pack.name} 다운로드 요청 · 파일 ${pack.entries.length}개` : `Download requested: ${pack.name} · ${pack.entries.length} files`);
+				await saveExport(new Blob([pack.bytes], { type: "application/zip" }), pack.name);
+				job.request.handedOff.add(index);
+				setToast(ko(`${pack.name} exported · ${pack.entries.length} files`, `${pack.name} 내보내기 완료 · 파일 ${pack.entries.length}개`, `${pack.name} 已导出 · ${pack.entries.length} 个文件`));
 				await exportBoundary(job);
 			}
 		}));
 	}
 
 	/** Depth and normal conditioning passes of the framing on screen now. */
-	function exportRenderPasses() {
+	async function exportRenderPasses() {
 		try {
 			const dataUrls = renderPassDataUrls();
-			for (const kind of ["depth", "normal"]) saveDownload(dataUrls[kind], passFileName(kind));
-			setToast(ko("Depth and normal passes downloaded", "뎁스·노멀 패스를 다운로드했어요"));
+			for (const kind of ["depth", "normal"]) await saveExport(dataUrls[kind], passFileName(kind));
+			setToast(ko("Depth and normal passes exported", "뎁스·노멀 패스를 내보냈어요"));
 			trackFeature("export_render_pass");
 		} catch (error) {
 			setToast(error?.message || String(error));
@@ -3352,8 +3335,8 @@ export default function App() {
 				cell: { width: 480, height: 300 },
 				createCanvas: storyboardCanvas,
 			});
-			saveDownload(canvas.toDataURL("image/png"), "cozyclay-storyboard.png");
-			setToast(isKo ? `스토리보드 저장됨 · ${cells.length}샷` : `Storyboard saved · ${cells.length} shots`);
+			await saveExport(canvas.toDataURL("image/png"), "cozyclay-storyboard.png");
+			setToast(ko(`Storyboard saved · ${cells.length} shots`, `스토리보드 저장됨 · ${cells.length}샷`, `故事板已保存 · ${cells.length} 个镜头`));
 			trackFeature("export_storyboard");
 		} catch (error) {
 			setToast(error?.message || String(error));
@@ -3443,8 +3426,8 @@ export default function App() {
 			}
 			const canvas = composeStoryboard({ shots: cells, columns: Math.min(3, cells.length), cell: { width: 480, height: 300 }, createCanvas: storyboardCanvas });
 			job.controller.signal.throwIfAborted();
-			saveDownload(canvas.toDataURL("image/png"), "cozyclay-storyboard.png");
-			setToast(isKo ? `콘택트 시트 다운로드 요청 · 패널 ${cells.length}개` : `Download requested: contact sheet · ${cells.length} panels`);
+			await saveExport(canvas.toDataURL("image/png"), "cozyclay-storyboard.png");
+			setToast(ko(`Contact sheet exported · ${cells.length} panels`, `콘택트 시트 내보내기 완료 · 패널 ${cells.length}개`, `缩略图总览已导出 · ${cells.length} 个面板`));
 			return { fileName: "cozyclay-storyboard.png", panelCount: cells.length };
 		}));
 	}
@@ -3487,7 +3470,7 @@ export default function App() {
 			updateExportStatus(job, "preparing", { stage: "frames", cancellable: true });
 			const packs = [];
 			for (const [step, entry] of targets.entries()) {
-				job.label = ko(`Panel ${step + 1} of ${targets.length}`, `패널 ${step + 1} / ${targets.length}`);
+				job.label = ko(`Panel ${step + 1} of ${targets.length}`, `패널 ${step + 1} / ${targets.length}`, `面板 ${step + 1} / ${targets.length}`);
 				packs.push(await panelPackArgs(entry, contextPanels.indexOf(entry), all));
 				await exportBoundary(job);
 			}
@@ -3497,10 +3480,8 @@ export default function App() {
 			const bytes = every ? buildZip(entries) : buildKeyframePack(packs[0]);
 			const name = every ? "cozyclay-panels.zip" : `cozyclay-${packs[0].folder}-${slugifyTitle(target.name)}.zip`;
 			await exportBoundary(job);
-			const url = URL.createObjectURL(new Blob([bytes], { type: "application/zip" }));
-			try { saveDownload(url, name); }
-			finally { setTimeout(() => URL.revokeObjectURL(url), 10_000); }
-			setToast(isKo ? `${name} 다운로드 요청 · 파일 ${entries.length}개` : `Download requested: ${name} · ${entries.length} files`);
+			await saveExport(new Blob([bytes], { type: "application/zip" }), name);
+			setToast(ko(`${name} exported · ${entries.length} files`, `${name} 내보내기 완료 · 파일 ${entries.length}개`, `${name} 已导出 · ${entries.length} 个文件`));
 			return { fileName: name, entries: entries.map((entry) => entry.name) };
 		}));
 	}
@@ -3819,7 +3800,7 @@ export default function App() {
 				if (!result.ok) return result;
 				await rehydrateProjectAssets(result.project, result.warnings);
 				applyProject(result.project);
-				setToast(`${isKo ? `프로젝트 열림: ${result.project.name}` : `Project opened: ${result.project.name}`}${projectProblemsNotice(result.problems)}`);
+				setToast(`${ko(`Project opened: ${result.project.name}`, `프로젝트 열림: ${result.project.name}`, `项目已打开：${result.project.name}`)}${projectProblemsNotice(result.problems)}`);
 				return result;
 			},
 			manifest: () => projectManifest,
@@ -4186,27 +4167,24 @@ export default function App() {
 		}
 		const snapshot = structuredClone(result);
 		const frameJob = { source: result, done: false, request: null };
-		frameJob.request = exportRequest("frame", (job) => {
+		frameJob.request = exportRequest("frame", async (job) => {
 			if (!snapshot?.frame) throw Object.assign(new Error("The captured frame is not ready"), { exportFailureCode: "render_failed" });
 			updateExportStatus(job, "finalizing", { stage: "download", cancellable: false });
-			const save = (href, name) => {
+			const save = async (source, name) => {
 				if (job.request.handedOff.has(name)) return;
-				saveDownload(href, name);
+				await saveExport(source, name);
 				job.request.handedOff.add(name);
 			};
 			if (snapshot.partColours && !job.request.handedOff.has("blocking-frame-palette.json")) {
-				const blob = new Blob([JSON.stringify({ partColours: snapshot.partColours }, null, 2)], { type: "application/json" });
-				const url = URL.createObjectURL(blob);
-				try { save(url, "blocking-frame-palette.json"); }
-				finally { setTimeout(() => URL.revokeObjectURL(url), 1000); }
+				await save(new Blob([JSON.stringify({ partColours: snapshot.partColours }, null, 2)], { type: "application/json" }), "blocking-frame-palette.json");
 			}
 			if (snapshot.frameB) {
-				save(snapshot.frame, "blocking-frame-A-start.png");
-				save(snapshot.frameB, "blocking-frame-B-end.png");
-			} else save(snapshot.frame, "blocking-frame.png");
+				await save(snapshot.frame, "blocking-frame-A-start.png");
+				await save(snapshot.frameB, "blocking-frame-B-end.png");
+			} else await save(snapshot.frame, "blocking-frame.png");
 			frameJob.done = true;
 			setResult((current) => current === frameJob.source ? { ...current, downloaded: true } : current);
-			setToast(ko("Frame download requested. Check your browser's downloads.", "프레임 다운로드를 요청했어요. 브라우저 다운로드를 확인하세요."));
+			setToast(ko("Frame export finished. Check your export folder or browser downloads.", "프레임 내보내기가 끝났어요. 내보내기 폴더나 브라우저 다운로드를 확인하세요."));
 		});
 		frameExportRef.current = frameJob;
 		return executeExportRequest(frameJob.request);
@@ -5006,9 +4984,9 @@ export default function App() {
 									setPathPointIndex(null);
 									setPathDraw(false);
 									const metrics = pathMetrics(createObjectPath({ points }));
-									setToast(isKo
-										? `이동 경로 완성 — ${metrics.length.toFixed(1)} m, 점 ${points.length}개`
-										: `Travel path drawn — ${metrics.length.toFixed(1)} m, ${points.length} points`);
+									setToast(ko(`Travel path drawn — ${metrics.length.toFixed(1)} m, ${points.length} points`,
+										`이동 경로 완성 — ${metrics.length.toFixed(1)} m, 점 ${points.length}개`,
+										`移动路径已完成 — ${metrics.length.toFixed(1)} m，${points.length} 个点`));
 								}}
 								onCameraChange={commitManualCameraFraming}
 							/>
@@ -5328,7 +5306,7 @@ export default function App() {
 			<FirstSuccessGuide open={firstSuccessGuideOpen} previsMode={scenesDomain.previsMode} onDismiss={() => setFirstSuccessGuideOpen(false)} />
 			<UseCaseQuestion
 				open={useCaseAskOpen}
-				isKo={isKo}
+				isKo={isKo} isZh={isZh}
 				onAnswer={(useCase, team) => {
 					recordUseCase(useCase, team);
 					setUseCaseAskOpen(false);
@@ -5365,7 +5343,7 @@ export default function App() {
 			)}
 			{restoreOffer && (
 				<div className="asset-delete-toast" role="status">
-					<span>{isKo ? `마지막 프로젝트 복원${restoreOffer.name ? `: ${restoreOffer.name}` : ""}` : `Restore last project${restoreOffer.name ? `: ${restoreOffer.name}` : ""}`}</span>
+					<span>{ko(`Restore last project${restoreOffer.name ? `: ${restoreOffer.name}` : ""}`, `마지막 프로젝트 복원${restoreOffer.name ? `: ${restoreOffer.name}` : ""}`, `恢复上次项目${restoreOffer.name ? `：${restoreOffer.name}` : ""}`)}</span>
 					<button
 						type="button"
 						onClick={async () => {

package/src/agent-image-client.js

@@ -76,7 +76,7 @@ export function stylizeErrorMessage(error) {
 	if (error?.code === "entitlement") return ko("This account cannot generate images.", "이 계정은 이미지를 생성할 수 없어요.");
 	if (error?.status === 401 || error?.code === "auth") return ko("Sign in with ChatGPT in the Agent panel first.", "먼저 Agent 패널에서 ChatGPT로 로그인하세요.");
 	const reason = error?.message || ko("unknown error", "알 수 없는 오류");
-	return ko(`Stylize failed — ${reason}`, `스타일화 실패 — ${reason}`);
+	return ko(`Stylize failed — ${reason}`, `스타일화 실패 — ${reason}`, `风格化失败 — ${reason}`);
 }
 
 /** The generated PNG's bytes, refused past `maxBytes` with a reason. */
@@ -86,7 +86,7 @@ export function stylizedPngBytes(dataUrl, maxBytes) {
 	const binary = atob(match[1]);
 	if (binary.length > maxBytes) {
 		const mb = Math.round(maxBytes / (1024 * 1024));
-		throw new Error(ko(`The stylized image is larger than ${mb} MB, so it was not added.`, `스타일화된 이미지가 ${mb} MB보다 커서 추가하지 않았어요.`));
+		throw new Error(ko(`The stylized image is larger than ${mb} MB, so it was not added.`, `스타일화된 이미지가 ${mb} MB보다 커서 추가하지 않았어요.`, `风格化图像超过 ${mb} MB，因此未添加。`));
 	}
 	const bytes = new Uint8Array(binary.length);
 	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);