@bonginkan/maria-lite 8.0.2 → 9.0.0

package/dist/desktop-client.js

@@ -403,6 +403,7 @@ var init_helpers = __esm({
       "dev-adviser": "user-check",
       "dev-decision": "compass",
       estimate: "ruler",
+      analytics: "bar-chart-big",
       // CXO Agents
       ceo: "crown",
       coo: "target",
@@ -498,6 +499,7 @@ var init_helpers = __esm({
       config: "settings",
       "notification-router": "bell-ring",
       events: "radio",
+      vui: "mic",
       "task-manager": "activity",
       // Games
       minesweeper: "bomb",
@@ -660,7 +662,7 @@ var init_state = __esm({
         label: "Daily Intelligence",
         emoji: "\u{1F4CA}",
         serverCategories: ["daily"],
-        commandIds: ["daily-report", "daily-news", "daily-papers", "daily-insights", "weekly-report", "discord-setup", "billing-pl"]
+        commandIds: ["daily-report", "daily-news", "daily-papers", "daily-insights", "weekly-report", "discord-setup", "billing-pl", "analytics"]
       },
       {
         id: "gtm",
@@ -767,7 +769,7 @@ var init_state = __esm({
         label: "System",
         emoji: "\u2699\uFE0F",
         serverCategories: [],
-        commandIds: ["help", "version", "gui", "desktop", "login", "logout", "account", "vup", "schedule", "config", "notification-router", "events"]
+        commandIds: ["help", "version", "gui", "desktop", "login", "logout", "account", "vup", "schedule", "config", "notification-router", "events", "vui"]
       }
     ];
     state = {
@@ -2428,6 +2430,54 @@ var init_uni_editor = __esm({
   }
 });
 
+// services/desktop/client/modules/desktop-upload.ts
+function normalizeUploadRelativePath(rawPath, fallbackName) {
+  const parts = String(rawPath || "").replace(/\\/g, "/").split("/").map((part) => part.trim()).filter((part) => part && part !== "." && part !== "..");
+  if (parts.length === 0) {
+    return { dir: "", filename: fallbackName };
+  }
+  const filename = parts.pop() || fallbackName;
+  return { dir: parts.join("/"), filename };
+}
+function joinDesktopDirs(...parts) {
+  return parts.map((part) => String(part || "").replace(/\\/g, "/").replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
+}
+async function uploadFileToDesktopAtWithPath(dir, file, relativePath = "") {
+  const normalized = normalizeUploadRelativePath(relativePath, file.name || "upload.bin");
+  const targetDir = joinDesktopDirs(dir, normalized.dir);
+  const formData = new FormData();
+  formData.append("file", file, normalized.filename);
+  if (targetDir) formData.append("dir", targetDir);
+  try {
+    const res = await api("/api/desktop/upload", { method: "POST", body: formData });
+    if (!res.ok) {
+      const body = await res.text().catch(() => "");
+      console.error(`[upload] failed for ${file.name}: HTTP ${res.status}`, body);
+      return "";
+    }
+    const json = await res.json().catch(() => null);
+    if (json?.ok && json.files?.[0]?.path) return json.files[0].path;
+    return "";
+  } catch (err) {
+    console.error(`[upload] error for ${file.name}:`, err);
+    return "";
+  }
+}
+async function uploadFileListToDesktopAt(dir, files, options) {
+  const out = [];
+  for (const file of files) {
+    const relativePath = options?.preserveRelativePaths ? file.webkitRelativePath || file.name : file.name;
+    const uploaded = await uploadFileToDesktopAtWithPath(dir, file, relativePath);
+    if (uploaded) out.push(uploaded);
+  }
+  return out;
+}
+var init_desktop_upload = __esm({
+  "services/desktop/client/modules/desktop-upload.ts"() {
+    init_helpers();
+  }
+});
+
 // services/desktop/client/modules/file-manager.ts
 function fmHistoryPush(dir) {
   if (state.fmHistoryIdx < state.fmHistory.length - 1) {
@@ -2516,6 +2566,7 @@ function renderFileManagerContent(win) {
   html += '<button class="fm-refresh-btn" title="Refresh">\u21BB</button>';
   html += '<button class="fm-newdir-btn" title="New folder">\u{1F4C1}+</button>';
   html += '<label class="fm-upload-btn" title="Upload">\u2B06\uFE0F<input type="file" class="fm-upload-input" multiple style="display:none" /></label>';
+  html += '<label class="fm-upload-btn" title="Upload folder">\u{1F4C1}\u2B06\uFE0F<input type="file" class="fm-upload-dir-input" webkitdirectory directory multiple style="display:none" /></label>';
   html += "</div>";
   html += "</div>";
   html += '<div class="fm-list">';
@@ -2632,9 +2683,19 @@ function attachFileManagerListeners(win) {
     uploadInput.addEventListener("change", () => {
       const files = Array.from(uploadInput.files || []);
       void (async () => {
-        for (const file of files) {
-          await uploadFileToDesktop(file);
-        }
+        await uploadFileListToDesktopAt(state.currentDir, files);
+        await loadDesktopFiles(state.currentDir);
+        refreshFileManagerContent(win);
+        renderDesktopFiles();
+      })();
+    });
+  }
+  const uploadDirInput = el.querySelector(".fm-upload-dir-input");
+  if (uploadDirInput) {
+    uploadDirInput.addEventListener("change", () => {
+      const files = Array.from(uploadDirInput.files || []);
+      void (async () => {
+        await uploadFileListToDesktopAt(state.currentDir, files, { preserveRelativePaths: true });
         await loadDesktopFiles(state.currentDir);
         refreshFileManagerContent(win);
         renderDesktopFiles();
@@ -2733,6 +2794,7 @@ function showFileManagerContextMenu(x, y, name, kind, win) {
   } else {
     html += `<div class="ctx-item" data-action="fm-newdir"><span class="ctx-icon">\u{1F4C1}</span><span>New Folder</span></div>`;
     html += `<div class="ctx-item" data-action="fm-upload"><span class="ctx-icon">\u{1F4C4}</span><span>Upload File</span></div>`;
+    html += `<div class="ctx-item" data-action="fm-upload-folder"><span class="ctx-icon">\u{1F4C1}</span><span>Upload Folder</span></div>`;
     html += '<div class="ctx-sep"></div>';
     html += `<div class="ctx-item" data-action="fm-refresh"><span class="ctx-icon">\u{1F504}</span><span>Refresh</span></div>`;
   }
@@ -2825,6 +2887,27 @@ function showFileManagerContextMenu(x, y, name, kind, win) {
           inp.click();
           break;
         }
+        case "fm-upload-folder": {
+          const inp = document.createElement("input");
+          inp.type = "file";
+          inp.multiple = true;
+          inp.style.display = "none";
+          inp.setAttribute("webkitdirectory", "");
+          inp.setAttribute("directory", "");
+          document.body.appendChild(inp);
+          inp.addEventListener("change", () => {
+            const files = Array.from(inp.files || []);
+            void (async () => {
+              await uploadFileListToDesktopAt(state.currentDir, files, { preserveRelativePaths: true });
+              inp.remove();
+              await loadDesktopFiles(state.currentDir);
+              refreshFileManagerContent(win);
+              renderDesktopFiles();
+            })();
+          });
+          inp.click();
+          break;
+        }
         case "fm-refresh":
           void loadDesktopFiles(state.currentDir).then(() => {
             refreshFileManagerContent(win);
@@ -3668,25 +3751,6 @@ async function uploadFileToDesktop(file) {
 async function uploadFileToDesktopAt(dir, file) {
   await uploadFileToDesktopAtWithPath(dir, file);
 }
-async function uploadFileToDesktopAtWithPath(dir, file) {
-  const formData = new FormData();
-  formData.append("file", file);
-  if (dir) formData.append("dir", dir);
-  try {
-    const res = await api("/api/desktop/upload", { method: "POST", body: formData });
-    if (!res.ok) {
-      const body = await res.text().catch(() => "");
-      console.error(`[upload] failed for ${file.name}: HTTP ${res.status}`, body);
-      return "";
-    }
-    const json = await res.json().catch(() => null);
-    if (json?.ok && json.files?.[0]?.path) return json.files[0].path;
-    return "";
-  } catch (err) {
-    console.error(`[upload] error for ${file.name}:`, err);
-    return "";
-  }
-}
 async function createFolder(name) {
   await createFolderAt(state.currentDir, name);
 }
@@ -3728,6 +3792,7 @@ var init_file_manager = __esm({
     init_context_menu();
     init_slide_viewer();
     init_uni_editor();
+    init_desktop_upload();
     OFFICE_BASE_CSS = `
   * { margin: 0; padding: 0; box-sizing: border-box; }
   body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: #1e293b; background: #f8fafc; }
@@ -3816,6 +3881,482 @@ function buildPreview(style, layout) {
   html += `</div>`;
   return html;
 }
+function fieldId(winId, key) {
+  return `settings_${winId}_${key}`;
+}
+function fieldEl(winId, key) {
+  return document.getElementById(fieldId(winId, key));
+}
+function renderOptionTags(options, selectedValue, emptyLabel) {
+  if (!Array.isArray(options) || options.length === 0) {
+    return `<option value="">${esc(emptyLabel)}</option>`;
+  }
+  return options.map((option) => `<option value="${esc(option.id)}"${option.id === selectedValue ? " selected" : ""}>${esc(option.label || option.id)}</option>`).join("");
+}
+function filteredAvatarModels(models, source) {
+  return (models || []).filter((model) => model.source === source);
+}
+function selectedAvatarModelId(models, preferredId) {
+  return models.find((model) => model.id === preferredId)?.id || models[0]?.id || "";
+}
+function renderVuiSettingsMarkup(winId, settings, meta) {
+  const vui = settings || {};
+  const tts = vui.tts || {};
+  const avatar = vui.avatar || {};
+  const vrmSource = avatar.vrm?.source === "custom" ? "custom" : "desktop";
+  const vrmaSource = avatar.vrm?.animationSource === "custom" ? "custom" : "desktop";
+  const live2dSource = avatar.live2d?.source === "custom" ? "custom" : "desktop";
+  const vrmModels = filteredAvatarModels(meta.avatar?.vrm?.models, vrmSource);
+  const vrmaModels = filteredAvatarModels(meta.avatar?.vrm?.animations, vrmaSource);
+  const live2dModels = filteredAvatarModels(meta.avatar?.live2d?.models, live2dSource);
+  const vrmSelected = selectedAvatarModelId(vrmModels, avatar.vrm?.selectedId || meta.avatar?.vrm?.current?.optionId || "");
+  const vrmaSelected = selectedAvatarModelId(vrmaModels, avatar.vrm?.selectedAnimationId || meta.avatar?.vrm?.currentAnimation?.optionId || "");
+  const live2dSelected = selectedAvatarModelId(live2dModels, avatar.live2d?.selectedId || meta.avatar?.live2d?.current?.optionId || "");
+  const provider = tts.provider || "browser";
+  const providerOptions = [
+    { id: "browser", label: "Browser" },
+    { id: "openai", label: meta.presets?.openai?.label || "OpenAI" },
+    { id: "google", label: meta.presets?.google?.label || "Google" },
+    { id: "elevenlabs", label: meta.presets?.elevenlabs?.label || "ElevenLabs" }
+  ];
+  const modelOptions = meta.presets?.[provider]?.models || [];
+  const outputFormatOptions = meta.presets?.elevenlabs?.outputFormats || [];
+  const outputFormat = tts.outputFormat || meta.presets?.elevenlabs?.defaults?.outputFormat || "mp3_44100_128";
+  const elevenDefaults = meta.presets?.elevenlabs?.defaults || {};
+  const hasPersonalElevenLabsApiKey = tts.hasPersonalElevenLabsApiKey === true;
+  return [
+    `<div class="uid-vui-stack">`,
+    `<div class="uid-vui-note">Voice, language, and avatar defaults for /vui. Put personal VRM files under <code>~/.maria/desktop/vrm</code>, VRMA motion files under <code>~/.maria/desktop/vrma</code>, and Live2D models under <code>~/.maria/desktop/live2d</code>.</div>`,
+    `<div class="uid-vui-grid">`,
+    `<label class="uid-vui-field"><span>Recognition language</span><select id="${fieldId(winId, "vui-language")}">${renderOptionTags(meta.languages || [], vui.language || "ja-JP", "(no languages)")}</select></label>`,
+    `<label class="uid-vui-field"><span>Default avatar mode</span><select id="${fieldId(winId, "avatar-default-mode")}">${renderOptionTags(meta.avatarModes || [], avatar.defaultMode || meta.avatar?.defaultMode || "orb", "(no modes)")}</select></label>`,
+    `</div>`,
+    `<div class="uid-vui-card">`,
+    `<div class="uid-vui-card-title">Voice Reply</div>`,
+    `<div class="uid-vui-grid">`,
+    `<label class="uid-vui-toggle"><input id="${fieldId(winId, "tts-enabled")}" type="checkbox"${tts.enabled !== false ? " checked" : ""}><span>Enabled</span></label>`,
+    `<label class="uid-vui-field"><span>Provider</span><select id="${fieldId(winId, "tts-provider")}">${renderOptionTags(providerOptions, provider, "(no providers)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "tts-model-wrap")}"><span>Model</span><select id="${fieldId(winId, "tts-model")}">${renderOptionTags(modelOptions, tts.model || "", "(no models)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "tts-language-wrap")}"><span>TTS language</span><select id="${fieldId(winId, "tts-language-code")}">${renderOptionTags(meta.languages || [], tts.languageCode || vui.language || "ja-JP", "(no languages)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "tts-voice-select-wrap")}"><span>Voice</span><select id="${fieldId(winId, "tts-voice-select")}"><option value="">Loading...</option></select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "tts-voice-custom-wrap")}"><span>Custom voice ID or share URL</span><input id="${fieldId(winId, "tts-voice-custom")}" type="text" value="" placeholder="Optional override for shared/private voices"></label>`,
+    `<label class="uid-vui-field uid-vui-span"><span>Instructions</span><input id="${fieldId(winId, "tts-instructions")}" type="text" value="${esc(tts.instructions || "")}" placeholder="Optional speaking style instructions"></label>`,
+    `</div>`,
+    `<div id="${fieldId(winId, "elevenlabs-panel")}" class="uid-vui-grid uid-vui-subgrid">`,
+    `<label class="uid-vui-field uid-vui-span"><span>Personal ElevenLabs API key (optional)</span><input id="${fieldId(winId, "tts-eleven-api-key")}" type="password" value="" autocomplete="off" placeholder="${esc(hasPersonalElevenLabsApiKey ? "Stored locally on this device. Enter a new key to replace it." : "Set your own key to use private/shared voices in your account.")}"></label>`,
+    `<div class="uid-vui-hint uid-vui-span" id="${fieldId(winId, "tts-eleven-api-key-status")}">${esc(hasPersonalElevenLabsApiKey ? "A personal ElevenLabs API key is already stored locally on this device." : "Optional. Use this when a private or shared voice is not available from the shared MARIA server key.")}</div>`,
+    `<label class="uid-vui-field"><span>Output format</span><select id="${fieldId(winId, "tts-eleven-output")}">${renderOptionTags(outputFormatOptions, outputFormat, "(no formats)")}</select></label>`,
+    `<label class="uid-vui-field"><span>Stability</span><input id="${fieldId(winId, "tts-eleven-stability")}" type="number" min="0" max="1" step="0.01" value="${String(tts.elevenLabsSettings?.stability ?? elevenDefaults.stability ?? 0.5)}"></label>`,
+    `<label class="uid-vui-field"><span>Similarity</span><input id="${fieldId(winId, "tts-eleven-similarity")}" type="number" min="0" max="1" step="0.01" value="${String(tts.elevenLabsSettings?.similarityBoost ?? elevenDefaults.similarityBoost ?? 0.75)}"></label>`,
+    `<label class="uid-vui-field"><span>Style</span><input id="${fieldId(winId, "tts-eleven-style")}" type="number" min="0" max="1" step="0.01" value="${String(tts.elevenLabsSettings?.style ?? elevenDefaults.style ?? 0)}"></label>`,
+    `<label class="uid-vui-field"><span>Speed</span><input id="${fieldId(winId, "tts-eleven-speed")}" type="number" min="0.7" max="1.2" step="0.01" value="${String(tts.elevenLabsSettings?.speed ?? elevenDefaults.speed ?? 1)}"></label>`,
+    `<label class="uid-vui-toggle"><input id="${fieldId(winId, "tts-eleven-boost")}" type="checkbox"${tts.elevenLabsSettings?.useSpeakerBoost !== false ? " checked" : ""}><span>Speaker boost</span></label>`,
+    `</div>`,
+    `</div>`,
+    `<div class="uid-vui-card">`,
+    `<div class="uid-vui-card-title">VRM</div>`,
+    `<div class="uid-vui-grid">`,
+    `<label class="uid-vui-field"><span>Source</span><select id="${fieldId(winId, "vrm-source")}"><option value="desktop"${vrmSource === "desktop" ? " selected" : ""}>MARIA OS library</option><option value="custom"${vrmSource === "custom" ? " selected" : ""}>Custom path</option></select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "vrm-select-wrap")}"><span>Model</span><select id="${fieldId(winId, "vrm-select")}">${renderOptionTags(vrmModels, vrmSelected, "(no VRM models)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "vrm-custom-wrap")}"><span>Custom VRM path</span><input id="${fieldId(winId, "vrm-custom-path")}" type="text" value="${esc(avatar.vrm?.customPath || meta.avatar?.vrm?.current?.customPath || "")}" placeholder="/absolute/path/model.vrm"></label>`,
+    `<label class="uid-vui-field"><span>Scale</span><input id="${fieldId(winId, "vrm-scale")}" type="number" min="0.5" max="3" step="0.05" value="${String(avatar.vrm?.scale ?? meta.avatar?.vrm?.scale ?? 1.5)}"></label>`,
+    `<div class="uid-vui-actions uid-vui-span"><button type="button" class="uid-vui-btn" id="${fieldId(winId, "vrm-upload")}">Upload VRM</button><span class="uid-vui-hint">Copies selected .vrm files into <code>~/.maria/desktop/vrm</code>.</span></div>`,
+    `<label class="uid-vui-field"><span>Idle / Motion source</span><select id="${fieldId(winId, "vrma-source")}"><option value="desktop"${vrmaSource === "desktop" ? " selected" : ""}>MARIA OS library</option><option value="custom"${vrmaSource === "custom" ? " selected" : ""}>Custom path</option></select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "vrma-select-wrap")}"><span>VRMA motion</span><select id="${fieldId(winId, "vrma-select")}">${renderOptionTags(vrmaModels, vrmaSelected, "(procedural fallback)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "vrma-custom-wrap")}"><span>Custom VRMA path</span><input id="${fieldId(winId, "vrma-custom-path")}" type="text" value="${esc(avatar.vrm?.customAnimationPath || meta.avatar?.vrm?.currentAnimation?.customPath || "")}" placeholder="/absolute/path/idle.vrma"></label>`,
+    `<div class="uid-vui-actions uid-vui-span"><button type="button" class="uid-vui-btn" id="${fieldId(winId, "vrma-upload")}">Upload VRMA</button><span class="uid-vui-hint">Optional. When absent, MARIA OS falls back to procedural idle motion.</span></div>`,
+    `</div>`,
+    `</div>`,
+    `<div class="uid-vui-card">`,
+    `<div class="uid-vui-card-title">Live2D</div>`,
+    `<div class="uid-vui-grid">`,
+    `<label class="uid-vui-field"><span>Source</span><select id="${fieldId(winId, "live2d-source")}"><option value="desktop"${live2dSource === "desktop" ? " selected" : ""}>MARIA OS library</option><option value="custom"${live2dSource === "custom" ? " selected" : ""}>Custom directory</option></select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "live2d-select-wrap")}"><span>Model</span><select id="${fieldId(winId, "live2d-select")}">${renderOptionTags(live2dModels, live2dSelected, "(no Live2D models)")}</select></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "live2d-custom-dir-wrap")}"><span>Custom model dir/file</span><input id="${fieldId(winId, "live2d-custom-dir")}" type="text" value="${esc(avatar.live2d?.customModelDir || meta.avatar?.live2d?.current?.customModelDir || "")}" placeholder="/absolute/path/modeldir or *.model3.json"></label>`,
+    `<label class="uid-vui-field" id="${fieldId(winId, "live2d-custom-name-wrap")}"><span>Custom model name</span><input id="${fieldId(winId, "live2d-custom-name")}" type="text" value="${esc(avatar.live2d?.customModelName || meta.avatar?.live2d?.current?.customModelName || "")}" placeholder="Optional model name"></label>`,
+    `<label class="uid-vui-field"><span>Scale</span><input id="${fieldId(winId, "live2d-scale")}" type="number" min="0.5" max="3" step="0.05" value="${String(avatar.live2d?.scale ?? meta.avatar?.live2d?.scale ?? 2.1)}"></label>`,
+    `<label class="uid-vui-field"><span>Offset X</span><input id="${fieldId(winId, "live2d-offset-x")}" type="number" min="-4" max="4" step="0.05" value="${String(avatar.live2d?.offsetX ?? meta.avatar?.live2d?.offsetX ?? 0)}"></label>`,
+    `<label class="uid-vui-field"><span>Offset Y</span><input id="${fieldId(winId, "live2d-offset-y")}" type="number" min="-4" max="4" step="0.05" value="${String(avatar.live2d?.offsetY ?? meta.avatar?.live2d?.offsetY ?? 1.1)}"></label>`,
+    `<div class="uid-vui-actions uid-vui-span"><button type="button" class="uid-vui-btn" id="${fieldId(winId, "live2d-upload")}">Upload Live2D Folder</button><span class="uid-vui-hint">Preserves subdirectories under <code>~/.maria/desktop/live2d</code>.</span></div>`,
+    `</div>`,
+    `</div>`,
+    `<div id="${fieldId(winId, "vui-status")}" class="uid-vui-status">Changes save automatically.</div>`,
+    `</div>`
+  ].join("");
+}
+function toFiniteNumber(raw, fallback) {
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : fallback;
+}
+function notifyVuiSettingsChanged() {
+  const detail = { updatedAt: Date.now() };
+  try {
+    localStorage.setItem("maria.desktop.vui.settings.updatedAt", String(detail.updatedAt));
+  } catch {
+  }
+  try {
+    const channel = new BroadcastChannel("maria.desktop.vui.settings");
+    channel.postMessage(detail);
+    channel.close();
+  } catch {
+  }
+  try {
+    window.dispatchEvent(new CustomEvent("maria:vui-settings-updated", { detail }));
+  } catch {
+  }
+}
+function pickLocalFiles(options) {
+  return new Promise((resolve) => {
+    const input = document.createElement("input");
+    input.type = "file";
+    input.style.display = "none";
+    input.multiple = options?.multiple !== false;
+    if (options?.accept) input.accept = options.accept;
+    if (options?.directory) {
+      input.setAttribute("webkitdirectory", "");
+      input.setAttribute("directory", "");
+    }
+    document.body.appendChild(input);
+    input.addEventListener("change", () => {
+      const files = Array.from(input.files || []);
+      input.remove();
+      resolve(files);
+    }, { once: true });
+    input.click();
+  });
+}
+async function loadVoiceOptionsForSettings(winId, meta, selectedVoice) {
+  const provider = fieldEl(winId, "tts-provider")?.value || "browser";
+  const model = fieldEl(winId, "tts-model")?.value || "";
+  const languageCode = fieldEl(winId, "tts-language-code")?.value || "";
+  const voiceSelectWrap = fieldEl(winId, "tts-voice-select-wrap");
+  const voiceCustomWrap = fieldEl(winId, "tts-voice-custom-wrap");
+  const voiceSelect = fieldEl(winId, "tts-voice-select");
+  const voiceCustom = fieldEl(winId, "tts-voice-custom");
+  if (!voiceSelectWrap || !voiceCustomWrap || !voiceSelect || !voiceCustom) return;
+  if (provider === "browser") {
+    voiceSelectWrap.style.display = "none";
+    voiceCustomWrap.style.display = "none";
+    return;
+  }
+  const presetVoices = meta.presets?.[provider]?.voices || [];
+  let voices = presetVoices;
+  try {
+    const params = new URLSearchParams();
+    params.set("provider", provider);
+    if (model) params.set("model", model);
+    if (languageCode) params.set("languageCode", languageCode);
+    const result = await apiJson(`/api/vui/tts/voices?${params.toString()}`);
+    if (Array.isArray(result.voices) && result.voices.length > 0) {
+      voices = result.voices.map((voice) => ({
+        id: voice.id,
+        label: voice.label || voice.name || voice.id
+      }));
+    }
+  } catch {
+  }
+  if (!voices.length) {
+    voiceSelectWrap.style.display = "none";
+    voiceCustomWrap.style.display = "grid";
+    if (selectedVoice) voiceCustom.value = selectedVoice;
+    return;
+  }
+  voiceSelect.innerHTML = renderOptionTags(voices, selectedVoice || voiceCustom.value || "", "(no voices)");
+  voiceSelectWrap.style.display = "grid";
+  voiceCustomWrap.style.display = "grid";
+  if (selectedVoice && voices.some((voice) => voice.id === selectedVoice)) {
+    voiceCustom.value = "";
+  } else if (selectedVoice && !voices.some((voice) => voice.id === selectedVoice)) {
+    voiceCustom.value = selectedVoice;
+  }
+}
+function syncVuiSettingsVisibility(winId, meta) {
+  const provider = fieldEl(winId, "tts-provider")?.value || "browser";
+  const isBrowser = provider === "browser";
+  const isGoogle = provider === "google";
+  const isElevenLabs = provider === "elevenlabs";
+  const ttsModelWrap = fieldEl(winId, "tts-model-wrap");
+  const ttsLanguageWrap = fieldEl(winId, "tts-language-wrap");
+  const ttsVoiceSelectWrap = fieldEl(winId, "tts-voice-select-wrap");
+  const ttsVoiceCustomWrap = fieldEl(winId, "tts-voice-custom-wrap");
+  const elevenPanel = fieldEl(winId, "elevenlabs-panel");
+  if (ttsModelWrap) ttsModelWrap.style.display = isBrowser ? "none" : "grid";
+  if (ttsLanguageWrap) ttsLanguageWrap.style.display = isGoogle ? "grid" : "none";
+  if (ttsVoiceSelectWrap) ttsVoiceSelectWrap.style.display = isBrowser ? "none" : "grid";
+  if (ttsVoiceCustomWrap) ttsVoiceCustomWrap.style.display = isBrowser ? "none" : "grid";
+  if (elevenPanel) elevenPanel.style.display = isElevenLabs ? "grid" : "none";
+  const modelOptions = meta.presets?.[provider]?.models || [];
+  const modelSelect = fieldEl(winId, "tts-model");
+  if (modelSelect) {
+    const currentModel = modelSelect.value;
+    modelSelect.innerHTML = renderOptionTags(modelOptions, currentModel, "(no models)");
+  }
+  const vrmSource = fieldEl(winId, "vrm-source")?.value || "desktop";
+  const vrmaSource = fieldEl(winId, "vrma-source")?.value || "desktop";
+  const live2dSource = fieldEl(winId, "live2d-source")?.value || "desktop";
+  const vrmSelectWrap = fieldEl(winId, "vrm-select-wrap");
+  const vrmCustomWrap = fieldEl(winId, "vrm-custom-wrap");
+  const vrmaSelectWrap = fieldEl(winId, "vrma-select-wrap");
+  const vrmaCustomWrap = fieldEl(winId, "vrma-custom-wrap");
+  const live2dSelectWrap = fieldEl(winId, "live2d-select-wrap");
+  const live2dCustomDirWrap = fieldEl(winId, "live2d-custom-dir-wrap");
+  const live2dCustomNameWrap = fieldEl(winId, "live2d-custom-name-wrap");
+  if (vrmSelectWrap) vrmSelectWrap.style.display = vrmSource === "custom" ? "none" : "grid";
+  if (vrmCustomWrap) vrmCustomWrap.style.display = vrmSource === "custom" ? "grid" : "none";
+  if (vrmaSelectWrap) vrmaSelectWrap.style.display = vrmaSource === "custom" ? "none" : "grid";
+  if (vrmaCustomWrap) vrmaCustomWrap.style.display = vrmaSource === "custom" ? "grid" : "none";
+  if (live2dSelectWrap) live2dSelectWrap.style.display = live2dSource === "custom" ? "none" : "grid";
+  if (live2dCustomDirWrap) live2dCustomDirWrap.style.display = live2dSource === "custom" ? "grid" : "none";
+  if (live2dCustomNameWrap) live2dCustomNameWrap.style.display = live2dSource === "custom" ? "grid" : "none";
+  const vrmSelect = fieldEl(winId, "vrm-select");
+  if (vrmSelect && vrmSource !== "custom") {
+    const models = filteredAvatarModels(meta.avatar?.vrm?.models, vrmSource);
+    vrmSelect.innerHTML = renderOptionTags(models, vrmSelect.value, "(no VRM models)");
+  }
+  const vrmaSelect = fieldEl(winId, "vrma-select");
+  if (vrmaSelect && vrmaSource !== "custom") {
+    const models = filteredAvatarModels(meta.avatar?.vrm?.animations, vrmaSource);
+    vrmaSelect.innerHTML = renderOptionTags(models, vrmaSelect.value, "(procedural fallback)");
+  }
+  const live2dSelect = fieldEl(winId, "live2d-select");
+  if (live2dSelect && live2dSource !== "custom") {
+    const models = filteredAvatarModels(meta.avatar?.live2d?.models, live2dSource);
+    live2dSelect.innerHTML = renderOptionTags(models, live2dSelect.value, "(no Live2D models)");
+  }
+}
+async function hydrateVuiSettingsSection(winId) {
+  const mount = document.getElementById(fieldId(winId, "vui-root"));
+  if (!mount) return;
+  mount.innerHTML = `<div class="uid-vui-note">Loading VUI settings...</div>`;
+  try {
+    const [settingsRes, metaRes] = await Promise.all([
+      apiJson("/api/vui/settings"),
+      apiJson("/api/vui/settings/meta")
+    ]);
+    mount.innerHTML = renderVuiSettingsMarkup(winId, settingsRes.vui, metaRes);
+    const providerSelect = fieldEl(winId, "tts-provider");
+    const modelSelect = fieldEl(winId, "tts-model");
+    const languageSelect = fieldEl(winId, "tts-language-code");
+    const vrmSourceSelect = fieldEl(winId, "vrm-source");
+    const live2dSourceSelect = fieldEl(winId, "live2d-source");
+    const statusEl = fieldEl(winId, "vui-status");
+    let saveTimer = 0;
+    let saveSerial = 0;
+    const selectedVoiceValue = () => {
+      const voiceSelect = fieldEl(winId, "tts-voice-select");
+      const voiceCustom = fieldEl(winId, "tts-voice-custom");
+      return (voiceCustom?.value || "").trim() || (voiceSelect?.value || "");
+    };
+    const setStatus = (text, state2 = "idle") => {
+      if (!statusEl) return;
+      statusEl.textContent = text;
+      statusEl.dataset.state = state2;
+    };
+    const setElevenLabsApiKeyStatus = (stored) => {
+      const input = fieldEl(winId, "tts-eleven-api-key");
+      const status = fieldEl(winId, "tts-eleven-api-key-status");
+      if (input) {
+        input.value = "";
+        input.placeholder = stored ? "Stored locally on this device. Enter a new key to replace it." : "Set your own key to use private/shared voices in your account.";
+      }
+      if (status) {
+        status.textContent = stored ? "A personal ElevenLabs API key is stored locally on this device." : "Optional. Use this when a private or shared voice is not available from the shared MARIA server key.";
+      }
+    };
+    const sync = async (selectedVoice) => {
+      syncVuiSettingsVisibility(winId, metaRes);
+      await loadVoiceOptionsForSettings(winId, metaRes, selectedVoice || settingsRes.vui?.tts?.voice || "");
+    };
+    const saveNow = async () => {
+      const serial = ++saveSerial;
+      setStatus("Saving\u2026", "saving");
+      const voiceSelect = fieldEl(winId, "tts-voice-select");
+      const voiceCustom = fieldEl(winId, "tts-voice-custom");
+      const personalElevenLabsApiKeyRaw = (fieldEl(winId, "tts-eleven-api-key")?.value || "").trim();
+      const customVoice = (voiceCustom?.value || "").trim();
+      const selectedVoice = customVoice || (voiceSelect?.value || "");
+      const providerValue = providerSelect?.value || "browser";
+      const personalElevenLabsApiKey = providerValue === "elevenlabs" ? personalElevenLabsApiKeyRaw : "";
+      const payload = {
+        vui: {
+          language: fieldEl(winId, "vui-language")?.value || "ja-JP",
+          tts: {
+            enabled: Boolean(fieldEl(winId, "tts-enabled")?.checked),
+            provider: providerValue,
+            voice: selectedVoice,
+            model: modelSelect?.value || "",
+            languageCode: languageSelect?.value || "",
+            instructions: fieldEl(winId, "tts-instructions")?.value || "",
+            outputFormat: fieldEl(winId, "tts-eleven-output")?.value || "",
+            ...personalElevenLabsApiKey ? { personalElevenLabsApiKey } : {},
+            elevenLabsSettings: {
+              stability: toFiniteNumber(fieldEl(winId, "tts-eleven-stability")?.value || "", 0.5),
+              similarityBoost: toFiniteNumber(fieldEl(winId, "tts-eleven-similarity")?.value || "", 0.75),
+              style: toFiniteNumber(fieldEl(winId, "tts-eleven-style")?.value || "", 0),
+              speed: toFiniteNumber(fieldEl(winId, "tts-eleven-speed")?.value || "", 1),
+              useSpeakerBoost: Boolean(fieldEl(winId, "tts-eleven-boost")?.checked)
+            }
+          },
+          avatar: {
+            defaultMode: fieldEl(winId, "avatar-default-mode")?.value || "orb",
+            vrm: {
+              source: vrmSourceSelect?.value || "desktop",
+              selectedId: fieldEl(winId, "vrm-select")?.value || "",
+              customPath: fieldEl(winId, "vrm-custom-path")?.value || "",
+              scale: toFiniteNumber(fieldEl(winId, "vrm-scale")?.value || "", 1.5),
+              animationSource: fieldEl(winId, "vrma-source")?.value || "desktop",
+              selectedAnimationId: fieldEl(winId, "vrma-select")?.value || "",
+              customAnimationPath: fieldEl(winId, "vrma-custom-path")?.value || ""
+            },
+            live2d: {
+              source: live2dSourceSelect?.value || "desktop",
+              selectedId: fieldEl(winId, "live2d-select")?.value || "",
+              customModelDir: fieldEl(winId, "live2d-custom-dir")?.value || "",
+              customModelName: fieldEl(winId, "live2d-custom-name")?.value || "",
+              scale: toFiniteNumber(fieldEl(winId, "live2d-scale")?.value || "", 2.1),
+              offsetX: toFiniteNumber(fieldEl(winId, "live2d-offset-x")?.value || "", 0),
+              offsetY: toFiniteNumber(fieldEl(winId, "live2d-offset-y")?.value || "", 1.1)
+            }
+          }
+        }
+      };
+      try {
+        await apiJson("/api/vui/settings", {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(payload)
+        });
+        if (personalElevenLabsApiKey) {
+          setElevenLabsApiKeyStatus(true);
+          await loadVoiceOptionsForSettings(winId, metaRes, selectedVoice);
+        }
+        notifyVuiSettingsChanged();
+        if (serial === saveSerial) setStatus("Saved.", "saved");
+      } catch (error) {
+        if (serial === saveSerial) {
+          setStatus(`Save failed: ${error instanceof Error ? error.message : String(error)}`, "error");
+        }
+      }
+    };
+    const queueSave = (delayMs = 180) => {
+      if (saveTimer) window.clearTimeout(saveTimer);
+      saveTimer = window.setTimeout(() => {
+        void saveNow();
+      }, delayMs);
+    };
+    providerSelect?.addEventListener("change", () => {
+      const selectedVoice = selectedVoiceValue();
+      void sync(selectedVoice).then(() => queueSave(0));
+    });
+    modelSelect?.addEventListener("change", () => {
+      const selectedVoice = selectedVoiceValue();
+      void loadVoiceOptionsForSettings(winId, metaRes, selectedVoice).then(() => queueSave(0));
+    });
+    languageSelect?.addEventListener("change", () => {
+      const selectedVoice = selectedVoiceValue();
+      void loadVoiceOptionsForSettings(winId, metaRes, selectedVoice).then(() => queueSave(0));
+    });
+    fieldEl(winId, "tts-voice-select")?.addEventListener("change", () => {
+      const custom = fieldEl(winId, "tts-voice-custom");
+      if (custom) custom.value = "";
+      queueSave(0);
+    });
+    vrmSourceSelect?.addEventListener("change", () => {
+      syncVuiSettingsVisibility(winId, metaRes);
+      queueSave(0);
+    });
+    fieldEl(winId, "vrma-source")?.addEventListener("change", () => {
+      syncVuiSettingsVisibility(winId, metaRes);
+      queueSave(0);
+    });
+    live2dSourceSelect?.addEventListener("change", () => {
+      syncVuiSettingsVisibility(winId, metaRes);
+      queueSave(0);
+    });
+    [
+      "vui-language",
+      "avatar-default-mode",
+      "tts-enabled",
+      "tts-eleven-output",
+      "tts-eleven-boost",
+      "vrm-select",
+      "vrma-select",
+      "live2d-select"
+    ].forEach((key) => fieldEl(winId, key)?.addEventListener("change", () => queueSave(0)));
+    [
+      "tts-voice-custom",
+      "tts-instructions",
+      "tts-eleven-api-key",
+      "tts-eleven-stability",
+      "tts-eleven-similarity",
+      "tts-eleven-style",
+      "tts-eleven-speed",
+      "vrm-custom-path",
+      "vrma-custom-path",
+      "vrm-scale",
+      "live2d-custom-dir",
+      "live2d-custom-name",
+      "live2d-scale",
+      "live2d-offset-x",
+      "live2d-offset-y"
+    ].forEach((key) => fieldEl(winId, key)?.addEventListener("input", () => queueSave(240)));
+    fieldEl(winId, "vrm-upload")?.addEventListener("click", () => {
+      void (async () => {
+        const files = await pickLocalFiles({ accept: ".vrm", multiple: true });
+        if (!files.length) return;
+        setStatus("Uploading VRM files\u2026", "saving");
+        const uploaded = [];
+        for (const file of files) {
+          const relPath = await uploadFileToDesktopAtWithPath("vrm", file);
+          if (relPath) uploaded.push(relPath);
+        }
+        if (!uploaded.length) {
+          setStatus("VRM upload failed.", "error");
+          return;
+        }
+        await hydrateVuiSettingsSection(winId);
+      })();
+    });
+    fieldEl(winId, "live2d-upload")?.addEventListener("click", () => {
+      void (async () => {
+        const files = await pickLocalFiles({ directory: true, multiple: true });
+        if (!files.length) return;
+        const hasRelativePath = files.some((file) => Boolean(file.webkitRelativePath && file.webkitRelativePath.includes("/")));
+        if (!hasRelativePath) {
+          setStatus("Folder upload is not supported in this browser.", "error");
+          return;
+        }
+        setStatus("Uploading Live2D folder\u2026", "saving");
+        const uploaded = await uploadFileListToDesktopAt("live2d", files, { preserveRelativePaths: true });
+        if (!uploaded.length) {
+          setStatus("Live2D folder upload failed.", "error");
+          return;
+        }
+        await hydrateVuiSettingsSection(winId);
+      })();
+    });
+    fieldEl(winId, "vrma-upload")?.addEventListener("click", () => {
+      void (async () => {
+        const files = await pickLocalFiles({ accept: ".vrma", multiple: true });
+        if (!files.length) return;
+        setStatus("Uploading VRMA files\u2026", "saving");
+        const uploaded = [];
+        for (const file of files) {
+          const relPath = await uploadFileToDesktopAtWithPath("vrma", file);
+          if (relPath) uploaded.push(relPath);
+        }
+        if (!uploaded.length) {
+          setStatus("VRMA upload failed.", "error");
+          return;
+        }
+        await hydrateVuiSettingsSection(winId);
+      })();
+    });
+    await sync();
+  } catch (error) {
+    mount.innerHTML = `<div class="uid-vui-note" style="color:var(--danger);">Failed to load VUI settings: ${esc(error instanceof Error ? error.message : String(error))}</div>`;
+  }
+}
 function updateAllWindowIcons() {
   const useLucide = state.iconStyle === "modern" || state.iconStyle === "minimal";
   for (const win of state.windows) {
@@ -3896,18 +4437,28 @@ function updateAllWindowIcons() {
 function openUiDesign() {
   const useLucide = state.iconStyle === "modern" || state.iconStyle === "minimal";
   const winIcon = useLucide ? lucideIcon(LUCIDE_SYSTEM_ICONS["ui-design"] || "paintbrush", "di-lucide") : "\u{1F3A8}";
+  const viewportWidth = Math.max(640, window.innerWidth || 1280);
+  const viewportHeight = Math.max(520, window.innerHeight || 900);
+  const width = Math.min(720, Math.max(520, viewportWidth - 96));
+  const height = Math.min(760, Math.max(520, viewportHeight - 140));
   const win = createWindow({
     appId: "__ui-design",
-    title: "UI Design",
+    title: "Settings",
     icon: winIcon,
     content: "app",
-    width: 520,
-    height: 520
+    width,
+    height
   });
+  win.x = Math.max(16, Math.min(win.x, viewportWidth - width - 16));
+  win.y = Math.max(16, Math.min(win.y, viewportHeight - height - 64));
+  const el = getWinEl(win.id);
+  if (el) applyWindowStyles(el, win);
   renderUiDesignContent(win.id);
 }
 function renderUiDesignContent(winId) {
   const body = getWinBody(winId);
+  body.style.overflowY = "auto";
+  body.style.paddingRight = "4px";
   const curStyle = state.iconStyle;
   const curLayout = state.iconLayout;
   let html = '<div class="uid-container">';
@@ -3938,6 +4489,10 @@ function renderUiDesignContent(winId) {
   html += `<div class="uid-preview-wrap" id="uidPreview_${winId}">`;
   html += buildPreview(curStyle, curLayout);
   html += "</div></div>";
+  html += '<div class="uid-section">';
+  html += '<div class="uid-section-title">VUI</div>';
+  html += `<div id="${fieldId(winId, "vui-root")}"><div style="font-size:12px; color:#667085;">Loading VUI settings...</div></div>`;
+  html += "</div>";
   html += "</div>";
   body.innerHTML = html;
   body.querySelectorAll(".uid-option").forEach((btn) => {
@@ -3960,6 +4515,7 @@ function renderUiDesignContent(winId) {
       renderUiDesignContent(winId);
     });
   });
+  void hydrateVuiSettingsSection(winId);
 }
 var _renderDesktopIcons, _renderStartMenu, _renderTaskbarPins, _renderTaskbarWindows, _refreshOpenFolderWindows, _renderDesktopFiles, _refreshAllFileManagerWindows, ICON_STYLES, ICON_LAYOUTS, LOGO_ASSETS;
 var init_ui_design = __esm({
@@ -3967,6 +4523,7 @@ var init_ui_design = __esm({
     init_helpers();
     init_state();
     init_window_manager();
+    init_desktop_upload();
     _renderDesktopIcons = null;
     _renderStartMenu = null;
     _renderTaskbarPins = null;
@@ -17556,7 +18113,7 @@ function openCategoryFolder(folderId) {
     } else {
       settingsIcon = "\u{1F3A8}";
     }
-    html += `<div class="folder-app-item" data-app-id="__ui-design" title="Icon style &amp; layout settings">`;
+    html += `<div class="folder-app-item" data-app-id="__ui-design" title="Desktop, VUI, and appearance settings">`;
     html += `<div class="folder-app-icon">${settingsIcon}</div>`;
     html += `<div class="folder-app-label">Settings</div>`;
     html += `</div>`;
@@ -17878,7 +18435,7 @@ function refreshOpenFolderWindows() {
       } else {
         settingsIcon = "\u{1F3A8}";
       }
-      html += `<div class="folder-app-item" data-app-id="__ui-design" title="Icon style &amp; layout settings">`;
+      html += `<div class="folder-app-item" data-app-id="__ui-design" title="Desktop, VUI, and appearance settings">`;
       html += `<div class="folder-app-icon">${settingsIcon}</div>`;
       html += `<div class="folder-app-label">Settings</div>`;
       html += `</div>`;
@@ -18439,7 +18996,7 @@ function injectTaskbarDeps(deps) {
 function getInternalApps() {
   return [
     { id: "__file_manager", label: "Files", description: "File Manager", lucideIcon: LUCIDE_SYSTEM_ICONS["file-manager"] || "folder-open", emoji: "\u{1F4C2}", open: () => _openFileManager?.() },
-    { id: "__ui-design", label: "Settings", description: "Icon style & layout", lucideIcon: LUCIDE_SYSTEM_ICONS["ui-design"] || "paintbrush", emoji: "\u{1F3A8}", open: () => _openUiDesign?.() },
+    { id: "__ui-design", label: "Settings", description: "Desktop, VUI, and appearance settings", lucideIcon: LUCIDE_SYSTEM_ICONS["ui-design"] || "paintbrush", emoji: "\u{1F3A8}", open: () => _openUiDesign?.() },
     { id: "__task_manager", label: "Concurrency", description: "View running jobs", lucideIcon: "activity", emoji: "\u{1F4CA}", open: () => _openTaskManager3?.() }
   ];
 }
@@ -19292,6 +19849,45 @@ function attachChatPanelListeners() {
   renderMessages();
 }
 
+// services/desktop/client/modules/vui-panel.ts
+var _panelOpen2 = false;
+var _iframeLoaded = false;
+function toggleVuiPanel() {
+  if (_panelOpen2) closeVuiPanel();
+  else openVuiPanel();
+}
+function openVuiPanel() {
+  _panelOpen2 = true;
+  const panel = document.getElementById("vuiPanel");
+  if (panel) panel.classList.add("open");
+  document.getElementById("desktop")?.classList.add("vui-panel-open");
+  if (!_iframeLoaded) {
+    const frame = document.getElementById("vuiFrame");
+    if (frame) {
+      frame.src = "/vui";
+      _iframeLoaded = true;
+    }
+  }
+  document.getElementById("vuiToggleBtn")?.classList.add("active");
+}
+function closeVuiPanel() {
+  _panelOpen2 = false;
+  const panel = document.getElementById("vuiPanel");
+  if (panel) panel.classList.remove("open");
+  document.getElementById("desktop")?.classList.remove("vui-panel-open");
+  document.getElementById("vuiToggleBtn")?.classList.remove("active");
+}
+function attachVuiPanelListeners() {
+  const closeBtn = document.getElementById("vuiPanelClose");
+  if (closeBtn) closeBtn.addEventListener("click", closeVuiPanel);
+  document.addEventListener("keydown", (e) => {
+    if (e.altKey && e.code === "KeyV") {
+      e.preventDefault();
+      toggleVuiPanel();
+    }
+  });
+}
+
 // services/desktop/client/desktop-client.ts
 init_dialogs();
 setUpdateRunBtnState(updateRunBtnState);
@@ -19469,6 +20065,10 @@ function attachGlobalListeners() {
   if (chatToggleBtn) {
     chatToggleBtn.addEventListener("click", () => toggleChatPanel());
   }
+  const vuiToggleBtn = document.getElementById("vuiToggleBtn");
+  if (vuiToggleBtn) {
+    vuiToggleBtn.addEventListener("click", () => toggleVuiPanel());
+  }
   document.addEventListener("click", (e) => {
     const target = e.target;
     if (state.startMenuOpen) {
@@ -19732,6 +20332,7 @@ async function boot() {
   attachDesktopDragDrop();
   attachDesktopIconDrag();
   attachChatPanelListeners();
+  attachVuiPanelListeners();
   void requestNotificationPermission();
 }
 void boot();