@elizaos/app-core 2.0.0-alpha.74 → 2.0.0-alpha.76

package/src/components/CharacterView.tsx

@@ -1,1575 +0,0 @@
-/**
- * Character view — roster-first character selection with optional customization.
- */
-
-import {
-  type CharacterData,
-  client,
-  type StylePreset,
-  type VoiceConfig,
-} from "@elizaos/app-core/api";
-import { AvatarSelector } from "./AvatarSelector";
-import {
-  dispatchWindowEvent,
-  VOICE_CONFIG_UPDATED_EVENT,
-} from "@elizaos/app-core/events";
-import { COMPANION_ENABLED } from "@elizaos/app-core/navigation";
-import { normalizeGeneratedMessageExamples } from "../actions/character";
-import { useApp } from "@elizaos/app-core/state";
-import {
-  CharacterRoster,
-  type CharacterRosterEntry,
-  resolveRosterEntries,
-} from "./CharacterRoster";
-import {
-  PREMADE_VOICES,
-  sanitizeApiKey,
-  type VoicePreset,
-} from "@elizaos/app-core/voice";
-import { Button, Input, Textarea, ThemedSelect } from "@elizaos/ui";
-import { BookOpen, FileText, Lock, LockOpen, Palette, Volume2, VolumeX } from "lucide-react";
-import { useCallback, useEffect, useState } from "react";
-
-const DEFAULT_ELEVEN_FAST_MODEL = "eleven_flash_v2_5";
-
-type StyleSectionKey = "all" | "chat" | "post";
-type CustomizeStep = "core" | "examples";
-type ActiveSection = "aboutMe" | "directions" | "styleRules";
-const STYLE_SECTION_KEYS: StyleSectionKey[] = ["all", "chat", "post"];
-const STYLE_SECTION_PLACEHOLDERS: Record<StyleSectionKey, string> = {
-  all: "Add shared rule",
-  chat: "Add chat rule",
-  post: "Add post rule",
-};
-const STYLE_SECTION_EMPTY_STATES: Record<StyleSectionKey, string> = {
-  all: "No shared rules yet.",
-  chat: "No chat rules yet.",
-  post: "No post rules yet.",
-};
-const VOICE_SELECT_GROUPS = [
-  {
-    label: "Female",
-    items: PREMADE_VOICES.filter((preset) => preset.gender === "female").map(
-      (preset) => ({
-        id: preset.id,
-        text: preset.name,
-      }),
-    ),
-  },
-  {
-    label: "Male",
-    items: PREMADE_VOICES.filter((preset) => preset.gender === "male").map(
-      (preset) => ({
-        id: preset.id,
-        text: preset.name,
-      }),
-    ),
-  },
-  {
-    label: "Character",
-    items: PREMADE_VOICES.filter((preset) => preset.gender === "character").map(
-      (preset) => ({
-        id: preset.id,
-        text: preset.name,
-      }),
-    ),
-  },
-];
-
-function replaceCharacterToken(value: string, name: string) {
-  return value.replaceAll("{{name}}", name).replaceAll("{{agentName}}", name);
-}
-
-function buildCharacterFromPreset(
-  preset: StylePreset,
-  name: string,
-): CharacterData {
-  return {
-    name,
-    username: name,
-    bio: preset.bio.map((line) => replaceCharacterToken(line, name)),
-    system: replaceCharacterToken(preset.system, name),
-    adjectives: [...preset.adjectives],
-    style: {
-      all: [...preset.style.all],
-      chat: [...preset.style.chat],
-      post: [...preset.style.post],
-    },
-    messageExamples: preset.messageExamples.map((conversation) => ({
-      examples: conversation.map((message) => ({
-        name:
-          message.user === "{{agentName}}"
-            ? name
-            : replaceCharacterToken(message.user, name),
-        content: {
-          text: replaceCharacterToken(message.content.text, name),
-        },
-      })),
-    })),
-    postExamples: preset.postExamples.map((example) =>
-      replaceCharacterToken(example, name),
-    ),
-  };
-}
-
-function buildCharacterDraftFromPreset(
-  entry: CharacterRosterEntry,
-): CharacterData {
-  const character = buildCharacterFromPreset(entry.preset, entry.name);
-  return {
-    name: character.name ?? "",
-    username: character.username ?? "",
-    bio: Array.isArray(character.bio)
-      ? character.bio.join("\n")
-      : (character.bio ?? ""),
-    system: character.system ?? "",
-    adjectives: character.adjectives ?? [],
-    style: {
-      all: character.style?.all ?? [],
-      chat: character.style?.chat ?? [],
-      post: character.style?.post ?? [],
-    },
-    messageExamples: character.messageExamples ?? [],
-    postExamples: character.postExamples ?? [],
-  };
-}
-
-function normalizeCharacterDraftForComparison(
-  character: CharacterData | null | undefined,
-) {
-  return {
-    name: (character?.name ?? "").trim(),
-    username: (character?.username ?? "").trim(),
-    bio:
-      typeof character?.bio === "string"
-        ? character.bio.trim()
-        : Array.isArray(character?.bio)
-          ? character.bio.join("\n").trim()
-          : "",
-    system: (character?.system ?? "").trim(),
-    adjectives: [...(character?.adjectives ?? [])],
-    style: {
-      all: [...(character?.style?.all ?? [])],
-      chat: [...(character?.style?.chat ?? [])],
-      post: [...(character?.style?.post ?? [])],
-    },
-    messageExamples: (character?.messageExamples ?? []).map((conversation) => ({
-      examples: (conversation.examples ?? []).map((message) => ({
-        name: message.name,
-        content: {
-          text: message.content?.text ?? "",
-        },
-      })),
-    })),
-    postExamples: [...(character?.postExamples ?? [])],
-  };
-}
-
-function characterDraftMatchesPreset(
-  character: CharacterData | null | undefined,
-  avatarIndex: number,
-  entry: CharacterRosterEntry,
-) {
-  if (avatarIndex !== entry.avatarIndex) return false;
-  const normalizedCurrent = normalizeCharacterDraftForComparison(character);
-  const normalizedPreset = normalizeCharacterDraftForComparison(
-    buildCharacterDraftFromPreset(entry),
-  );
-  return JSON.stringify(normalizedCurrent) === JSON.stringify(normalizedPreset);
-}
-
-
-function findMatchingRosterEntry(
-  character: CharacterData | null,
-  avatarIndex: number,
-  roster: CharacterRosterEntry[],
-) {
-  if (!character) return null;
-  const currentName =
-    typeof character.name === "string" ? character.name.trim() : "";
-  const exactNameMatch = roster.find((entry) => entry.name === currentName);
-  if (exactNameMatch) return exactNameMatch.id;
-
-  let bestMatch: { id: string; score: number } | null = null;
-  for (const entry of roster) {
-    let score = 0;
-    if (entry.avatarIndex === avatarIndex) score += 3;
-
-    const draftAdjectives = new Set(character.adjectives ?? []);
-    for (const adjective of entry.preset.adjectives) {
-      if (draftAdjectives.has(adjective)) score += 1;
-    }
-
-    if (
-      typeof character.system === "string" &&
-      character.system.includes(entry.preset.catchphrase)
-    ) {
-      score += 1;
-    }
-
-    if (!bestMatch || score > bestMatch.score) {
-      bestMatch = { id: entry.id, score };
-    }
-  }
-
-  return bestMatch && bestMatch.score >= 4 ? bestMatch.id : null;
-}
-
-function findExactRosterEntry(
-  character: CharacterData | null,
-  roster: CharacterRosterEntry[],
-) {
-  if (!character) return null;
-  const currentName =
-    typeof character.name === "string" ? character.name.trim() : "";
-  return roster.find((entry) => entry.name === currentName) ?? null;
-}
-
-function hasCharacterContent(character: CharacterData | null | undefined) {
-  return Boolean(character && Object.keys(character).length > 0);
-}
-
-function resolveActiveRosterEntry(
-  character: CharacterData | null | undefined,
-  avatarIndex: number,
-  selectedCharacterId: string | null,
-  roster: CharacterRosterEntry[],
-) {
-  if (selectedCharacterId) {
-    const selectedEntry =
-      roster.find((entry) => entry.id === selectedCharacterId) ?? null;
-    if (selectedEntry) return selectedEntry;
-  }
-
-  const exactEntry = findExactRosterEntry(character ?? null, roster);
-  if (exactEntry) return exactEntry;
-
-  const matchedId = findMatchingRosterEntry(
-    character ?? null,
-    avatarIndex,
-    roster,
-  );
-  if (!matchedId) return null;
-  return roster.find((entry) => entry.id === matchedId) ?? null;
-}
-
-function getStyleEntryRenderKey(
-  section: StyleSectionKey,
-  items: string[],
-  item: string,
-  index: number,
-) {
-  let occurrence = 0;
-  for (const current of items.slice(0, index + 1)) {
-    if (current === item) occurrence += 1;
-  }
-  return `${section}:${item}:${occurrence}`;
-}
-
-/* ── CharacterView ──────────────────────────────────────────────────── */
-
-export function CharacterView({
-  inModal,
-  sceneOverlay = false,
-}: {
-  inModal?: boolean;
-  sceneOverlay?: boolean;
-} = {}) {
-  const {
-    tab,
-    setTab,
-    characterData,
-    characterDraft,
-    characterLoading,
-    characterSaving,
-    characterSaveSuccess,
-    characterSaveError,
-    handleCharacterFieldInput,
-    handleCharacterArrayInput,
-    handleCharacterStyleInput,
-    handleSaveCharacter,
-    loadCharacter,
-    setState,
-    onboardingOptions,
-    selectedVrmIndex,
-    t,
-    // Registry / Drop
-    registryStatus,
-    registryLoading,
-    registryRegistering,
-    registryError,
-    dropStatus,
-    loadRegistryStatus,
-    registerOnChain,
-    syncRegistryProfile,
-    loadDropStatus,
-    walletConfig,
-  } = useApp();
-
-  useEffect(() => {
-    void loadCharacter();
-    void loadRegistryStatus();
-    void loadDropStatus();
-  }, [loadCharacter, loadRegistryStatus, loadDropStatus]);
-
-  const handleFieldEdit = useCallback(
-    <K extends keyof CharacterData>(field: K, value: CharacterData[K]) => {
-      handleCharacterFieldInput(field, value);
-    },
-    [handleCharacterFieldInput],
-  );
-
-  const handleStyleEdit = useCallback(
-    (key: "all" | "chat" | "post", value: string) => {
-      handleCharacterStyleInput(key, value);
-    },
-    [handleCharacterStyleInput],
-  );
-
-  /* ── Character generation state ─────────────────────────────────── */
-  const [generating, setGenerating] = useState<string | null>(null);
-  const [pendingStyleEntries, setPendingStyleEntries] = useState<
-    Record<StyleSectionKey, string>
-  >({
-    all: "",
-    chat: "",
-    post: "",
-  });
-  const [styleEntryDrafts, setStyleEntryDrafts] = useState<
-    Record<StyleSectionKey, string[]>
-  >({
-    all: [],
-    chat: [],
-    post: [],
-  });
-  const [customizeStep, setCustomizeStep] = useState<CustomizeStep>("core");
-  const [activeSection, setActiveSection] = useState<ActiveSection>("aboutMe");
-  const [customOverridesEnabled, setCustomOverridesEnabled] = useState(false);
-  const [selectedCharacterId, setSelectedCharacterId] = useState<string | null>(
-    null,
-  );
-  const [rosterStyles, setRosterStyles] = useState<StylePreset[]>(
-    onboardingOptions?.styles ?? [],
-  );
-
-  /* ── Voice config state ─────────────────────────────────────────── */
-  const [voiceConfig, setVoiceConfig] = useState<VoiceConfig>({});
-  const [voiceLoading, setVoiceLoading] = useState(false);
-  const [voiceSaving, setVoiceSaving] = useState(false);
-  const [voiceSaveError, setVoiceSaveError] = useState<string | null>(null);
-  const [voiceTesting, setVoiceTesting] = useState(false);
-  const [voiceTestAudio, setVoiceTestAudio] = useState<HTMLAudioElement | null>(
-    null,
-  );
-  const [selectedVoicePresetId, setSelectedVoicePresetId] = useState<
-    string | null
-  >(null);
-  const [voiceSelectionLocked, setVoiceSelectionLocked] = useState(false);
-
-  useEffect(() => {
-    if (onboardingOptions?.styles?.length) {
-      setRosterStyles(onboardingOptions.styles);
-      return;
-    }
-
-    let cancelled = false;
-    void client
-      .getOnboardingOptions()
-      .then((options) => {
-        if (!cancelled) {
-          setRosterStyles(options.styles ?? []);
-        }
-      })
-      .catch(() => {
-        /* ignore */
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [onboardingOptions?.styles]);
-
-  const characterRoster = resolveRosterEntries(rosterStyles);
-  const visibleCharacterRoster = characterRoster;
-  const currentCharacter = hasCharacterContent(characterDraft)
-    ? characterDraft
-    : characterData;
-  const activeRosterEntry = resolveActiveRosterEntry(
-    currentCharacter,
-    selectedVrmIndex,
-    selectedCharacterId,
-    characterRoster,
-  );
-  const detailedEditMode = tab === "character";
-
-  /* Load voice config on mount */
-  useEffect(() => {
-    void (async () => {
-      setVoiceLoading(true);
-      try {
-        const cfg = await client.getConfig();
-        const messages = cfg.messages as
-          | Record<string, Record<string, unknown>>
-          | undefined;
-        const tts = messages?.tts as VoiceConfig | undefined;
-        if (tts) {
-          setVoiceConfig(tts);
-          if (tts.elevenlabs?.voiceId) {
-            const preset = PREMADE_VOICES.find(
-              (p) => p.voiceId === tts.elevenlabs?.voiceId,
-            );
-            setSelectedVoicePresetId(preset?.id ?? null);
-          }
-        }
-      } catch {
-        /* ignore */
-      }
-      setVoiceLoading(false);
-    })();
-  }, []);
-
-  const handleSelectPreset = useCallback((preset: VoicePreset) => {
-    setSelectedVoicePresetId(preset.id);
-    setVoiceConfig((prev) => ({
-      ...prev,
-      elevenlabs: { ...(prev.elevenlabs ?? {}), voiceId: preset.voiceId },
-    }));
-  }, []);
-
-  const applyVoicePresetForEntry = useCallback(
-    (entry: CharacterRosterEntry) => {
-      setVoiceSaveError(null);
-      if (!entry.voicePresetId) return;
-      const voicePreset = PREMADE_VOICES.find(
-        (preset) => preset.id === entry.voicePresetId,
-      );
-      if (voicePreset) handleSelectPreset(voicePreset);
-    },
-    [handleSelectPreset],
-  );
-
-  const applyCharacterDefaults = useCallback(
-    (entry: CharacterRosterEntry) => {
-      const nextCharacter = buildCharacterDraftFromPreset(entry);
-      handleFieldEdit("name", nextCharacter.name ?? "");
-      handleFieldEdit("username", nextCharacter.username ?? "");
-      handleFieldEdit("bio", nextCharacter.bio ?? "");
-      handleFieldEdit("system", nextCharacter.system ?? "");
-      handleFieldEdit("adjectives", nextCharacter.adjectives ?? []);
-      handleFieldEdit(
-        "style",
-        nextCharacter.style ?? { all: [], chat: [], post: [] },
-      );
-      handleFieldEdit("messageExamples", nextCharacter.messageExamples ?? []);
-      handleFieldEdit("postExamples", nextCharacter.postExamples ?? []);
-    },
-    [handleFieldEdit],
-  );
-
-  const commitCharacterSelection = useCallback(
-    (entry: CharacterRosterEntry, applyDefaults: boolean) => {
-      setSelectedCharacterId(entry.id);
-      setState("selectedVrmIndex", entry.avatarIndex);
-      if (!voiceSelectionLocked && selectedCharacterId !== entry.id) {
-        applyVoicePresetForEntry(entry);
-      }
-      if (applyDefaults) {
-        applyCharacterDefaults(entry);
-      }
-    },
-    [
-      applyCharacterDefaults,
-      applyVoicePresetForEntry,
-      selectedCharacterId,
-      setState,
-      voiceSelectionLocked,
-    ],
-  );
-
-  const handleTestVoice = useCallback(
-    (previewUrl: string) => {
-      if (voiceTestAudio) {
-        voiceTestAudio.pause();
-        voiceTestAudio.currentTime = 0;
-      }
-      setVoiceTesting(true);
-      const audio = new Audio(previewUrl);
-      setVoiceTestAudio(audio);
-      audio.onended = () => setVoiceTesting(false);
-      audio.onerror = () => setVoiceTesting(false);
-      audio.play().catch(() => setVoiceTesting(false));
-    },
-    [voiceTestAudio],
-  );
-
-  const handleStopTest = useCallback(() => {
-    if (voiceTestAudio) {
-      voiceTestAudio.pause();
-      voiceTestAudio.currentTime = 0;
-    }
-    setVoiceTesting(false);
-  }, [voiceTestAudio]);
-
-  const persistVoiceConfig = useCallback(async () => {
-    setVoiceSaveError(null);
-    const normalizedElevenlabs = {
-      ...voiceConfig.elevenlabs,
-      modelId: voiceConfig.elevenlabs?.modelId ?? DEFAULT_ELEVEN_FAST_MODEL,
-    };
-    const sanitizedKey = sanitizeApiKey(normalizedElevenlabs?.apiKey);
-    if (sanitizedKey) normalizedElevenlabs.apiKey = sanitizedKey;
-    else delete normalizedElevenlabs.apiKey;
-
-    const normalizedVoiceConfig: VoiceConfig = {
-      ...voiceConfig,
-      provider: voiceConfig.provider ?? "elevenlabs",
-      elevenlabs: normalizedElevenlabs,
-    };
-
-    await client.updateConfig({
-      messages: {
-        tts: normalizedVoiceConfig,
-      },
-    });
-    dispatchWindowEvent(VOICE_CONFIG_UPDATED_EVENT, normalizedVoiceConfig);
-  }, [voiceConfig]);
-
-  const d = characterDraft ?? ({} as Record<string, unknown>);
-  const bioText =
-    typeof d.bio === "string"
-      ? d.bio
-      : Array.isArray(d.bio)
-        ? (d.bio as string[]).join("\n")
-        : "";
-
-  const getCharContext = useCallback(
-    () => ({
-      name: d.name ?? "",
-      system: d.system ?? "",
-      bio: bioText,
-      style: d.style ?? { all: [], chat: [], post: [] },
-      postExamples: d.postExamples ?? [],
-    }),
-    [d, bioText],
-  );
-
-  useEffect(() => {
-    setStyleEntryDrafts({
-      all: [...(d.style?.all ?? [])],
-      chat: [...(d.style?.chat ?? [])],
-      post: [...(d.style?.post ?? [])],
-    });
-  }, [d.style]);
-
-  const handleGenerate = useCallback(
-    async (field: string, mode: "append" | "replace" = "replace") => {
-      setGenerating(field);
-      try {
-        const { generated } = await client.generateCharacterField(
-          field,
-          getCharContext(),
-          mode,
-        );
-        if (field === "bio") {
-          handleFieldEdit("bio", generated.trim());
-        } else if (field === "system") {
-          handleFieldEdit("system", generated.trim());
-        } else if (field === "style") {
-          try {
-            const parsed = JSON.parse(generated);
-            if (mode === "append") {
-              handleStyleEdit(
-                "all",
-                [...(d.style?.all ?? []), ...(parsed.all ?? [])].join("\n"),
-              );
-              handleStyleEdit(
-                "chat",
-                [...(d.style?.chat ?? []), ...(parsed.chat ?? [])].join("\n"),
-              );
-              handleStyleEdit(
-                "post",
-                [...(d.style?.post ?? []), ...(parsed.post ?? [])].join("\n"),
-              );
-            } else {
-              if (parsed.all) handleStyleEdit("all", parsed.all.join("\n"));
-              if (parsed.chat) handleStyleEdit("chat", parsed.chat.join("\n"));
-              if (parsed.post) handleStyleEdit("post", parsed.post.join("\n"));
-            }
-          } catch {
-            /* raw text fallback */
-          }
-        } else if (field === "chatExamples") {
-          const formatted = normalizeGeneratedMessageExamples(
-            generated,
-            d.name?.trim() || "Agent",
-          );
-          if (formatted.length > 0) {
-            setState("characterSaveError", null);
-            handleFieldEdit("messageExamples", formatted);
-          } else {
-            setState(
-              "characterSaveError",
-              "Generated chat examples could not be parsed. Try again.",
-            );
-          }
-        } else if (field === "postExamples") {
-          try {
-            const parsed = JSON.parse(generated);
-            if (Array.isArray(parsed)) {
-              if (mode === "append") {
-                handleCharacterArrayInput(
-                  "postExamples",
-                  [...(d.postExamples ?? []), ...parsed].join("\n"),
-                );
-              } else {
-                handleCharacterArrayInput("postExamples", parsed.join("\n"));
-              }
-            }
-          } catch {
-            /* raw text fallback */
-          }
-        }
-      } catch (err) {
-        if (field === "chatExamples") {
-          setState(
-            "characterSaveError",
-            err instanceof Error
-              ? `Failed to generate chat examples: ${err.message}`
-              : "Failed to generate chat examples.",
-          );
-        }
-      }
-      setGenerating(null);
-    },
-    [
-      getCharContext,
-      d,
-      handleFieldEdit,
-      handleStyleEdit,
-      handleCharacterArrayInput,
-      setState,
-    ],
-  );
-
-  const handlePendingStyleEntryChange = useCallback(
-    (key: StyleSectionKey, value: string) => {
-      setPendingStyleEntries((prev) => ({ ...prev, [key]: value }));
-    },
-    [],
-  );
-
-  const handleAddStyleEntry = useCallback(
-    (key: StyleSectionKey) => {
-      const value = pendingStyleEntries[key].trim();
-      if (!value) return;
-
-      const nextItems = [...(d.style?.[key] ?? [])];
-      if (!nextItems.includes(value)) {
-        nextItems.push(value);
-        handleStyleEdit(key, nextItems.join("\n"));
-      }
-
-      setPendingStyleEntries((prev) => ({ ...prev, [key]: "" }));
-    },
-    [d.style, handleStyleEdit, pendingStyleEntries],
-  );
-
-  const handleRemoveStyleEntry = useCallback(
-    (key: StyleSectionKey, index: number) => {
-      const nextItems = [...(d.style?.[key] ?? [])];
-      nextItems.splice(index, 1);
-      handleStyleEdit(key, nextItems.join("\n"));
-    },
-    [d.style, handleStyleEdit],
-  );
-
-  const handleStyleEntryDraftChange = useCallback(
-    (key: StyleSectionKey, index: number, value: string) => {
-      setStyleEntryDrafts((prev) => {
-        const nextItems = [...(prev[key] ?? [])];
-        nextItems[index] = value;
-        return { ...prev, [key]: nextItems };
-      });
-    },
-    [],
-  );
-
-  const handleCommitStyleEntry = useCallback(
-    (key: StyleSectionKey, index: number) => {
-      const nextValue = styleEntryDrafts[key]?.[index]?.trim() ?? "";
-      const nextItems = [...(d.style?.[key] ?? [])];
-
-      if (!nextValue) {
-        nextItems.splice(index, 1);
-      } else {
-        nextItems[index] = nextValue;
-      }
-
-      handleStyleEdit(key, nextItems.join("\n"));
-    },
-    [d.style, handleStyleEdit, styleEntryDrafts],
-  );
-
-  const handleSelectCharacter = useCallback(
-    (entry: CharacterRosterEntry) => {
-      const shouldApplyDefaults =
-        !customOverridesEnabled &&
-        (!currentCharacter ||
-          !activeRosterEntry ||
-          characterDraftMatchesPreset(
-            currentCharacter,
-            selectedVrmIndex,
-            activeRosterEntry,
-          ));
-      commitCharacterSelection(entry, shouldApplyDefaults);
-    },
-    [
-      activeRosterEntry,
-      commitCharacterSelection,
-      currentCharacter,
-      customOverridesEnabled,
-      selectedVrmIndex,
-    ],
-  );
-
-  const handleCustomOverridesChange = useCallback(
-    (enabled: boolean) => {
-      setTab(enabled ? "character" : "character-select");
-      setCustomOverridesEnabled(enabled);
-      setCustomizeStep("core");
-      if (enabled) return;
-
-      const activeEntry = resolveActiveRosterEntry(
-        currentCharacter,
-        selectedVrmIndex,
-        selectedCharacterId,
-        characterRoster,
-      );
-      if (activeEntry) {
-        setSelectedCharacterId(activeEntry.id);
-      }
-    },
-    [
-      characterRoster,
-      currentCharacter,
-      selectedCharacterId,
-      selectedVrmIndex,
-      setTab,
-    ],
-  );
-
-  useEffect(() => {
-    setCustomOverridesEnabled(detailedEditMode);
-    if (detailedEditMode) {
-      setCustomizeStep("core");
-    }
-  }, [detailedEditMode]);
-
-  useEffect(() => {
-    if (
-      characterLoading ||
-      selectedCharacterId ||
-      !characterRoster.length ||
-      !currentCharacter
-    ) {
-      return;
-    }
-
-    const activeEntry =
-      resolveActiveRosterEntry(
-        currentCharacter,
-        selectedVrmIndex,
-        selectedCharacterId,
-        characterRoster,
-      ) ??
-      characterRoster[0] ??
-      null;
-    if (!activeEntry) return;
-    const matchesFactory = characterDraftMatchesPreset(
-      currentCharacter,
-      selectedVrmIndex,
-      activeEntry,
-    );
-    setSelectedCharacterId(activeEntry.id);
-    setCustomOverridesEnabled(detailedEditMode);
-    if (matchesFactory) {
-      commitCharacterSelection(activeEntry, true);
-    }
-  }, [
-    characterLoading,
-    characterRoster,
-    commitCharacterSelection,
-    currentCharacter,
-    detailedEditMode,
-    selectedCharacterId,
-    selectedVrmIndex,
-  ]);
-
-  const handleSaveAll = useCallback(async () => {
-    const trimmedName =
-      typeof characterDraft?.name === "string" ? characterDraft.name.trim() : "";
-    if (!trimmedName) {
-      setVoiceSaveError(null);
-      setState("characterSaveSuccess", null);
-      setState("characterSaveError", "Character name is required before saving.");
-      return;
-    }
-
-    setVoiceSaveError(null);
-    try {
-      await handleSaveCharacter();
-    } catch {
-      return;
-    }
-
-    setVoiceSaving(true);
-    let voiceSaveFailed = false;
-    try {
-      await persistVoiceConfig();
-    } catch (err) {
-      voiceSaveFailed = true;
-      setVoiceSaveError(
-        err instanceof Error ? err.message : "Failed to save voice settings.",
-      );
-    } finally {
-      setVoiceSaving(false);
-    }
-    if (!voiceSaveFailed) {
-      setTab(COMPANION_ENABLED ? "companion" : "chat");
-    }
-  }, [
-    characterDraft?.name,
-    handleSaveCharacter,
-    persistVoiceConfig,
-    setState,
-    setTab,
-  ]);
-
-  /* ── Helpers ────────────────────────────────────────────────────── */
-  const cardCls = sceneOverlay
-    ? "p-5 border border-white/10 bg-black/15 backdrop-blur-md rounded-2xl shadow-[0_18px_48px_rgba(0,0,0,0.28)]"
-    : "p-5 border border-border/40 bg-card/40 backdrop-blur-xl rounded-2xl shadow-sm";
-  const sectionCls =
-    sceneOverlay && !inModal ? "relative z-10 mt-4 px-1" : `mt-4 ${cardCls}`;
-  const scrollPaneCls =
-    "min-h-0 overflow-y-auto pr-1 [scrollbar-gutter:stable] custom-scrollbar";
-
-  const SIDEBAR_TABS: { key: ActiveSection; icon: typeof FileText; labelKey: string }[] = [
-    { key: "aboutMe", icon: FileText, labelKey: "characterview.aboutMe" },
-    { key: "directions", icon: BookOpen, labelKey: "characterview.directionsAndThing" },
-    { key: "styleRules", icon: Palette, labelKey: "characterview.StyleRules" },
-  ];
-
-  const bookPageCls = sceneOverlay
-    ? "relative overflow-hidden bg-[linear-gradient(180deg,rgba(255,251,242,0.98)_0%,rgba(243,233,214,0.96)_100%)] backdrop-blur-md dark:bg-[linear-gradient(180deg,rgba(46,43,38,0.98)_0%,rgba(31,28,25,0.96)_100%)]"
-    : "relative overflow-hidden bg-[linear-gradient(180deg,#fffaf1_0%,#f4ead7_100%)] dark:bg-[linear-gradient(180deg,hsl(35,14%,18%)_0%,hsl(35,10%,13%)_100%)]";
-  const bookSidebarCls =
-    "relative overflow-hidden bg-[linear-gradient(180deg,#333842_0%,#23272f_42%,#191c22_100%)] dark:bg-[linear-gradient(180deg,hsl(220,14%,15%)_0%,hsl(220,16%,10%)_42%,hsl(220,20%,7%)_100%)]";
-  const notebookShellCls =
-    "relative isolate flex h-[34.75rem] w-full max-w-[29rem] overflow-visible";
-  const notebookFrameCls = sceneOverlay
-    ? "relative flex h-full w-full overflow-hidden rounded-[1.75rem] border border-[#2f261b]/20 bg-[#f8f0df]/70 dark:border-white/10 dark:bg-[#1c1c1e]/90 shadow-[0_24px_60px_rgba(0,0,0,0.34),inset_0_1px_0_rgba(255,255,255,0.5)]"
-    : "relative flex h-full w-full overflow-hidden rounded-[1.75rem] border border-[#2f261b]/14 bg-[#f8f0df] dark:border-white/10 dark:bg-[#1c1c1e] shadow-[0_26px_60px_rgba(36,28,18,0.2),inset_0_1px_0_rgba(255,255,255,0.58)]";
-
-  const handleCustomVrmUpload = useCallback(
-    (file: File) => {
-      const url = URL.createObjectURL(file);
-      setState("customVrmUrl", url);
-      setState("selectedVrmIndex", 0);
-    },
-    [setState],
-  );
-
-  if (characterLoading && !characterData) {
-    return (
-      <div className={sectionCls}>
-        <div className="text-center py-6 text-[var(--muted)] text-[13px]">
-          {t("characterview.loadingCharacterDa")}
-        </div>
-      </div>
-    );
-  }
-
-  const hasWallet = Boolean(walletConfig?.evmAddress);
-  const isRegistered = registryStatus?.registered === true;
-  const dropLive =
-    dropStatus?.dropEnabled &&
-    dropStatus?.publicMintOpen &&
-    !dropStatus?.mintedOut;
-  const userMinted = dropStatus?.userHasMinted === true;
-  const activeVoicePreset =
-    PREMADE_VOICES.find((preset) => preset.id === selectedVoicePresetId) ??
-    null;
-  const voiceSelectValue = selectedVoicePresetId ?? null;
-  const combinedSaveError = characterSaveError;
-  const saveAdvisory =
-    characterSaveSuccess && voiceSaveError
-      ? `Character saved. Voice settings still need attention: ${voiceSaveError}`
-      : null;
-  const customizationActionLabel = customOverridesEnabled
-    ? t("characterview.backToCharacterSelect")
-    : t("characterview.customize");
-  const rootCls =
-    sceneOverlay && !inModal
-      ? "relative z-10 flex min-h-full flex-col justify-end pb-4"
-      : `${inModal || sceneOverlay ? "pb-8" : ""} ${sceneOverlay ? "relative z-10" : ""
-      }`;
-
-  return (
-    <div className={rootCls}>
-      {/* ═══ ON-CHAIN IDENTITY ═══ */}
-      {hasWallet && (
-        <div className={sectionCls}>
-          {!isRegistered && !dropLive && (
-            <div className="flex flex-col gap-3">
-              <div className="text-[12px] text-[var(--muted)]">
-                {t("characterview.RegisterYourAgent")}
-              </div>
-              <div className="flex items-center gap-2">
-                <button
-                  type="button"
-                  className="btn text-xs py-[5px] px-4 !mt-0 cursor-pointer"
-                  disabled={registryRegistering || registryLoading}
-                  onClick={() => void registerOnChain()}
-                >
-                  {registryRegistering ? "registering..." : "register now"}
-                </button>
-                {registryError && (
-                  <span className="text-xs text-[var(--danger,#e74c3c)]">
-                    {registryError}
-                  </span>
-                )}
-              </div>
-            </div>
-          )}
-        </div>
-      )}
-
-      {isRegistered &&
-        (() => {
-          const currentName = characterDraft?.name || d.name || "";
-          const onChainName = registryStatus.agentName || "";
-          const nameOutOfSync =
-            currentName && onChainName && currentName !== onChainName;
-          return (
-            <div className={sectionCls}>
-              <div className="flex flex-col gap-2">
-                <div className="flex items-center gap-2 text-[12px]">
-                  <span className="text-green-400 font-bold tracking-wide">
-                    {t("characterview.Registered")}
-                  </span>
-                  <span className="text-muted/50">|</span>
-                  <span className="text-muted font-medium">
-                    {t("characterview.Token")}
-                    {registryStatus.tokenId}
-                  </span>
-                  <span className="text-muted/50">|</span>
-                  <span className="text-txt font-semibold">{onChainName}</span>
-                </div>
-                {nameOutOfSync && (
-                  <div className="flex items-center gap-3 bg-amber-400/10 border border-amber-400/20 px-3 py-2 rounded-lg">
-                    <span className="text-[11px] text-amber-400/80 font-medium tracking-wide">
-                      {t("characterview.OnChainName")}{" "}
-                      <strong className="text-amber-400">{onChainName}</strong>{" "}
-                      {t("characterview.DiffersFrom")}{" "}
-                      <strong className="text-amber-400">{currentName}"</strong>
-                    </span>
-                    <Button
-                      variant="outline"
-                      size="sm"
-                      className="text-[10px] h-6 px-2.5 border-amber-400/50 text-amber-400 hover:bg-amber-400/20 transition-all font-bold"
-                      disabled={registryRegistering}
-                      onClick={() => void syncRegistryProfile()}
-                    >
-                      {registryRegistering ? "syncing..." : "sync to chain"}
-                    </Button>
-                  </div>
-                )}
-                {registryError && (
-                  <span className="text-xs text-[var(--danger,#e74c3c)]">
-                    {registryError}
-                  </span>
-                )}
-                <a
-                  href={`https://etherscan.io/token/${registryStatus.walletAddress}`}
-                  target="_blank"
-                  rel="noopener noreferrer"
-                  className="text-[11px] underline text-[var(--accent)]"
-                >
-                  {t("characterview.viewOnEtherscan")}
-                </a>
-              </div>
-            </div>
-          );
-        })()}
-
-      {hasWallet && userMinted && !isRegistered && (
-        <div className={sectionCls}>
-          <div className="text-[12px] text-[var(--ok,#16a34a)]">
-            {t("characterview.MintedFromCollecti")}
-          </div>
-        </div>
-      )}
-
-      {!customOverridesEnabled ? (
-        <CharacterRoster
-          entries={visibleCharacterRoster}
-          selectedId={selectedCharacterId}
-          onSelect={handleSelectCharacter}
-          variant={sceneOverlay ? "onboarding" : "editor"}
-          testIdPrefix="character"
-        />
-      ) : null}
-
-      {customOverridesEnabled && (
-        <div className="mt-3 flex justify-end">
-          {/* ── Book container ── */}
-          <div
-            className={notebookShellCls}
-            data-testid="character-notebook"
-          >
-            <div className="pointer-events-none absolute inset-x-5 bottom-[-1.2rem] top-6 rounded-[1.9rem] bg-[linear-gradient(180deg,rgba(35,27,18,0.12)_0%,rgba(16,12,9,0.32)_100%)] dark:bg-[linear-gradient(180deg,rgba(0,0,0,0.3)_0%,rgba(0,0,0,0.5)_100%)] blur-xl" />
-            <div className="pointer-events-none absolute inset-[0.35rem] translate-x-2 translate-y-2 rounded-[1.9rem] border border-[#d7c5a4]/50 bg-[linear-gradient(180deg,rgba(251,246,235,0.86)_0%,rgba(236,224,198,0.7)_100%)] dark:border-white/10 dark:bg-[linear-gradient(180deg,rgba(38,38,40,0.9)_0%,rgba(28,28,30,0.8)_100%)] shadow-[0_12px_26px_rgba(62,44,21,0.12)]" />
-            <div className="pointer-events-none absolute bottom-[-0.95rem] left-8 h-14 w-4 rounded-b-sm bg-[linear-gradient(180deg,#ddb45e_0%,#be8530_100%)] [clip-path:polygon(0_0,100%_0,100%_78%,50%_100%,0_78%)] shadow-[0_10px_20px_rgba(141,97,34,0.28)]" />
-            <div className={notebookFrameCls}>
-              <div className="pointer-events-none absolute left-4 top-4 h-2 w-2 rounded-full border border-[#d8c295]/70 bg-[#fff9eb]/85 shadow-[0_0_0_2px_rgba(150,116,61,0.08)] dark:border-white/20 dark:bg-white/10 dark:shadow-[0_0_0_2px_rgba(255,255,255,0.05)]" />
-              <div className="pointer-events-none absolute bottom-4 left-4 h-2 w-2 rounded-full border border-[#d8c295]/70 bg-[#fff9eb]/85 shadow-[0_0_0_2px_rgba(150,116,61,0.08)] dark:border-white/20 dark:bg-white/10 dark:shadow-[0_0_0_2px_rgba(255,255,255,0.05)]" />
-              <div className="pointer-events-none absolute right-4 top-4 h-2 w-2 rounded-full border border-white/10 bg-white/10 shadow-[0_0_0_2px_rgba(255,255,255,0.03)]" />
-              <div className="pointer-events-none absolute bottom-4 right-4 h-2 w-2 rounded-full border border-white/10 bg-white/10 shadow-[0_0_0_2px_rgba(255,255,255,0.03)]" />
-              <div className="pointer-events-none absolute inset-x-0 bottom-0 h-14 bg-[linear-gradient(180deg,rgba(0,0,0,0)_0%,rgba(104,77,39,0.07)_100%)] dark:bg-[linear-gradient(180deg,rgba(0,0,0,0)_0%,rgba(0,0,0,0.15)_100%)]" />
-              <div className="pointer-events-none absolute bottom-3 right-[4.95rem] top-3 w-[0.7rem] rounded-full bg-[linear-gradient(90deg,rgba(116,92,55,0.16)_0%,rgba(255,255,255,0.5)_45%,rgba(112,88,52,0.2)_100%)] shadow-[inset_0_0_7px_rgba(89,67,37,0.16),0_0_18px_rgba(255,246,220,0.16)] dark:bg-[linear-gradient(90deg,rgba(255,255,255,0.05)_0%,rgba(255,255,255,0.15)_45%,rgba(255,255,255,0.05)_100%)] dark:shadow-[inset_0_0_7px_rgba(0,0,0,0.3),0_0_18px_rgba(255,255,255,0.05)]" />
-              {/* ── Book page (left) ── */}
-              <div
-                className={`${bookPageCls} flex flex-1 flex-col rounded-l-[1.75rem] border-r border-[#cdbb98]/60 text-[#1e2329] dark:border-white/[0.08] dark:text-[hsl(40,10%,84%)]`}
-              >
-                <div className="pointer-events-none absolute inset-[0.7rem] rounded-[1.25rem] border border-[#efe3cc]/85 shadow-[inset_0_0_0_1px_rgba(207,184,141,0.24)] dark:border-white/5 dark:shadow-[inset_0_0_0_1px_rgba(255,255,255,0.03)]" />
-                <div className="pointer-events-none absolute inset-0 bg-[radial-gradient(circle_at_top_left,rgba(255,255,255,0.72)_0%,rgba(255,255,255,0)_36%),linear-gradient(180deg,rgba(255,255,255,0.14)_0%,rgba(255,255,255,0)_24%),repeating-linear-gradient(0deg,rgba(168,139,87,0.035)_0px,rgba(168,139,87,0.035)_1px,transparent_1px,transparent_11px)] opacity-85 dark:opacity-25" />
-                <div className="pointer-events-none absolute bottom-0 right-0 top-0 w-5 bg-[linear-gradient(90deg,rgba(123,98,61,0)_0%,rgba(123,98,61,0.08)_55%,rgba(255,255,255,0.14)_100%)] dark:bg-[linear-gradient(90deg,rgba(255,255,255,0)_0%,rgba(255,255,255,0.03)_60%,rgba(255,255,255,0.08)_100%)]" />
-                {/* Mode toggle: Core / Examples */}
-                <div className="relative z-10 flex items-end gap-2 bg-[linear-gradient(180deg,rgba(255,255,255,0.26)_0%,rgba(255,255,255,0)_100%)] px-5 pb-3 pt-4 dark:bg-[linear-gradient(180deg,rgba(255,255,255,0.06)_0%,rgba(255,255,255,0)_100%)]">
-                  <button
-                    type="button"
-                    className={`relative h-9 rounded-b-md rounded-t-[1rem] border px-3.5 text-[10px] font-bold uppercase tracking-[0.18em] transition-all ${customizeStep === "core"
-                      ? "border-[#c59b47] bg-[linear-gradient(180deg,#f4cf79_0%,#d69f45_100%)] text-[#2d2418] shadow-[0_10px_18px_rgba(137,97,36,0.22)]"
-                      : "border-[#d4c6ad]/90 bg-[linear-gradient(180deg,rgba(255,252,245,0.96)_0%,rgba(243,235,222,0.82)_100%)] text-[#7b7365] shadow-[inset_0_1px_0_rgba(255,255,255,0.75)] hover:bg-[linear-gradient(180deg,rgba(255,255,255,0.98)_0%,rgba(248,240,226,0.9)_100%)] dark:border-white/10 dark:bg-[linear-gradient(180deg,rgba(255,255,255,0.1)_0%,rgba(255,255,255,0.04)_100%)] dark:text-muted dark:shadow-none dark:hover:bg-[linear-gradient(180deg,rgba(255,255,255,0.14)_0%,rgba(255,255,255,0.05)_100%)]"
-                      }`}
-                    onClick={() => setCustomizeStep("core")}
-                  >
-                    {t("characterview.core")}
-                  </button>
-                  {activeSection !== "styleRules" && (
-                    <button
-                      type="button"
-                      className={`relative h-9 rounded-b-md rounded-t-[1rem] border px-3.5 text-[10px] font-bold uppercase tracking-[0.18em] transition-all ${customizeStep === "examples"
-                        ? "border-[#c59b47] bg-[linear-gradient(180deg,#f4cf79_0%,#d69f45_100%)] text-[#2d2418] shadow-[0_10px_18px_rgba(137,97,36,0.22)]"
-                        : "border-[#d4c6ad]/90 bg-[linear-gradient(180deg,rgba(255,252,245,0.96)_0%,rgba(243,235,222,0.82)_100%)] text-[#7b7365] shadow-[inset_0_1px_0_rgba(255,255,255,0.75)] hover:bg-[linear-gradient(180deg,rgba(255,255,255,0.98)_0%,rgba(248,240,226,0.9)_100%)] dark:border-white/10 dark:bg-[linear-gradient(180deg,rgba(255,255,255,0.1)_0%,rgba(255,255,255,0.04)_100%)] dark:text-muted dark:shadow-none dark:hover:bg-[linear-gradient(180deg,rgba(255,255,255,0.14)_0%,rgba(255,255,255,0.05)_100%)]"
-                        }`}
-                      onClick={() => setCustomizeStep("examples")}
-                    >
-                      {t("characterview.examples")}
-                    </button>
-                  )}
-                  <div className="pointer-events-none absolute inset-x-4 bottom-0 h-px bg-[linear-gradient(90deg,rgba(209,193,165,0)_0%,rgba(209,193,165,0.92)_10%,rgba(209,193,165,0.92)_90%,rgba(209,193,165,0)_100%)] dark:bg-[linear-gradient(90deg,rgba(255,255,255,0)_0%,rgba(255,255,255,0.08)_10%,rgba(255,255,255,0.08)_90%,rgba(255,255,255,0)_100%)]" />
-                </div>
-
-                {/* Content area */}
-                <div className="relative z-10 flex flex-1 flex-col overflow-y-auto p-5 custom-scrollbar" role="tabpanel" aria-labelledby={`notebook-tab-${activeSection}`}>
-                  {/* ── About Me (Core) ── */}
-                  {activeSection === "aboutMe" && customizeStep === "core" && (
-                    <div className="flex flex-1 flex-col gap-3" data-testid="character-core-editor">
-                      {/* Name */}
-                      <div className="flex flex-col gap-1.5">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">Name</span>
-                        <Input
-                          type="text"
-                          value={d.name ?? ""}
-                          placeholder="Agent name"
-                          onChange={(e) => handleFieldEdit("name", e.target.value)}
-                          className="h-8 rounded-lg border-[#d6d3c6] dark:border-border/40 bg-white/60 dark:bg-white/5 text-sm text-[#1e2329] dark:text-[hsl(40,10%,84%)] focus-visible:border-accent focus-visible:ring-accent/50"
-                        />
-                      </div>
-
-                      {/* Avatar */}
-                      <div className="flex flex-col gap-1.5">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">Avatar</span>
-                        <AvatarSelector
-                          selected={selectedVrmIndex}
-                          onSelect={(index: number) => setState("selectedVrmIndex", index)}
-                          onUpload={handleCustomVrmUpload}
-                          showUpload={true}
-                          fullWidth={true}
-                        />
-                      </div>
-
-                      <div className="flex items-center justify-between">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">{t("characterview.aboutMe")}</span>
-                        <Button
-                          variant="ghost"
-                          size="sm"
-                          className="h-6 rounded-md px-2 text-[10px] font-bold text-accent"
-                          onClick={() => void handleGenerate("bio")}
-                          disabled={generating === "bio"}
-                        >
-                          {generating === "bio" ? "generating..." : "regenerate"}
-                        </Button>
-                      </div>
-                      <Textarea
-                        value={bioText}
-                        placeholder={t("characterview.describeWhoYourAg")}
-                        onChange={(e) => handleFieldEdit("bio", e.target.value)}
-                        className="flex-1 resize-none overflow-y-auto rounded-lg border-[#d6d3c6] dark:border-border/40 bg-white/60 dark:bg-white/5 p-3 font-mono text-xs leading-relaxed text-[#1e2329] dark:text-[hsl(40,10%,84%)] focus-visible:border-accent focus-visible:ring-accent/50"
-                      />
-                    </div>
-                  )}
-
-                  {/* ── Directions (Core) ── */}
-                  {activeSection === "directions" && customizeStep === "core" && (
-                    <div className="flex flex-1 flex-col gap-3">
-                      <div className="flex items-center justify-between">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">{t("characterview.directionsAndThing")}</span>
-                        <Button
-                          variant="ghost"
-                          size="sm"
-                          className="h-6 rounded-md px-2 text-[10px] font-bold text-accent"
-                          onClick={() => void handleGenerate("system")}
-                          disabled={generating === "system"}
-                        >
-                          {generating === "system" ? "generating..." : "regenerate"}
-                        </Button>
-                      </div>
-                      <Textarea
-                        value={d.system ?? ""}
-                        maxLength={10000}
-                        placeholder={t("characterview.writeInFirstPerso")}
-                        onChange={(e) => handleFieldEdit("system", e.target.value)}
-                        className="flex-1 resize-none overflow-y-auto rounded-lg border-[#d6d3c6] dark:border-border/40 bg-white/60 dark:bg-white/5 p-3 font-mono text-xs leading-relaxed text-[#1e2329] dark:text-[hsl(40,10%,84%)] focus-visible:border-accent focus-visible:ring-accent/50"
-                      />
-                    </div>
-                  )}
-
-                  {/* ── Style Rules (Core) ── */}
-                  {activeSection === "styleRules" && customizeStep === "core" && (
-                    <div className="flex flex-col gap-3" data-testid="character-style-editor">
-                      <div className="flex items-center justify-between">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">{t("characterview.StyleRules")}</span>
-                        <Button
-                          variant="ghost"
-                          size="sm"
-                          className="h-6 rounded-md px-2 text-[10px] font-bold text-accent"
-                          onClick={() => void handleGenerate("style", "replace")}
-                          disabled={generating === "style"}
-                        >
-                          {generating === "style" ? "generating..." : "regenerate"}
-                        </Button>
-                      </div>
-                      {STYLE_SECTION_KEYS.map((key) => {
-                        const items = d.style?.[key] ?? [];
-                        return (
-                          <div
-                            key={key}
-                            className="flex flex-col gap-1.5"
-                            data-testid={`style-section-${key}`}
-                          >
-                            <div className="flex items-center gap-2 border-b border-[#d6d3c6]/60 dark:border-border/30 pb-1">
-                              <span className="text-[10px] font-bold uppercase tracking-widest text-[#6d737a] dark:text-muted">{key}</span>
-                              <span className="text-[9px] font-medium uppercase tracking-wider text-[#9ca3af] dark:text-muted/60">
-                                {items.length} rule{items.length === 1 ? "" : "s"}
-                              </span>
-                            </div>
-                            <div className={`${scrollPaneCls} max-h-[12rem]`}>
-                              <div className="flex flex-col gap-1">
-                                {items.length > 0 ? (
-                                  items.map((item, index) => (
-                                    <div
-                                      key={getStyleEntryRenderKey(key, items, item, index)}
-                                      className="group flex items-start gap-2 rounded-md border border-[#d6d3c6]/40 dark:border-border/20 bg-white/50 dark:bg-white/3 px-2.5 py-2"
-                                      data-testid={`style-entry-${key}-${index}`}
-                                    >
-                                      <span className="mt-0.5 shrink-0 text-[10px] font-bold text-accent">
-                                        {index + 1}
-                                      </span>
-                                      <Textarea
-                                        value={styleEntryDrafts[key]?.[index] ?? item}
-                                        rows={1}
-                                        onChange={(e) => handleStyleEntryDraftChange(key, index, e.target.value)}
-                                        onBlur={() => handleCommitStyleEntry(key, index)}
-                                        className="min-h-[2rem] min-w-0 flex-1 resize-none rounded border-0 bg-transparent p-0 font-mono text-xs leading-relaxed text-[#1e2329] dark:text-[hsl(40,10%,84%)] focus-visible:ring-0"
-                                        data-testid={`style-entry-editor-${key}-${index}`}
-                                      />
-                                      <button
-                                        type="button"
-                                        className="mt-0.5 shrink-0 text-[#9ca3af] opacity-0 transition-opacity group-hover:opacity-100 hover:text-red-500"
-                                        onClick={() => handleRemoveStyleEntry(key, index)}
-                                        title={t("characterview.remove")}
-                                      >
-                                        <svg width="10" height="10" viewBox="0 0 10 10" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"><path d="M2 2l6 6M8 2l-6 6" /></svg>
-                                      </button>
-                                    </div>
-                                  ))
-                                ) : (
-                                  <div className="rounded-md border border-dashed border-[#d6d3c6]/60 dark:border-border/30 px-3 py-2 text-[11px] text-[#9ca3af] dark:text-muted">
-                                    {STYLE_SECTION_EMPTY_STATES[key]}
-                                  </div>
-                                )}
-                              </div>
-                            </div>
-                            <div className="flex items-center gap-2">
-                              <Input
-                                type="text"
-                                value={pendingStyleEntries[key]}
-                                placeholder={STYLE_SECTION_PLACEHOLDERS[key]}
-                                onChange={(e) => handlePendingStyleEntryChange(key, e.target.value)}
-                                onKeyDown={(e) => {
-                                  if (e.key === "Enter") {
-                                    e.preventDefault();
-                                    handleAddStyleEntry(key);
-                                  }
-                                }}
-                                className="h-7 min-w-0 flex-1 rounded-md border-[#d6d3c6]/60 dark:border-border/30 bg-white/50 dark:bg-white/5 text-xs text-[#1e2329] dark:text-[hsl(40,10%,84%)] focus-visible:border-accent focus-visible:ring-accent/50"
-                                data-testid={`style-entry-input-${key}`}
-                              />
-                              <Button
-                                variant="ghost"
-                                size="sm"
-                                className="h-7 shrink-0 rounded-md px-2 text-[10px] font-bold text-accent"
-                                onClick={() => handleAddStyleEntry(key)}
-                                disabled={!pendingStyleEntries[key].trim()}
-                              >
-                                + add
-                              </Button>
-                            </div>
-                          </div>
-                        );
-                      })}
-                    </div>
-                  )}
-
-                  {/* ── Chat Examples (About Me + Examples mode) ── */}
-                  {activeSection === "aboutMe" && customizeStep === "examples" && (
-                    <div className="flex flex-col gap-2" data-testid="character-chat-examples-card">
-                      <div className="flex items-center justify-between">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">{t("characterview.chatExamples")}</span>
-                        <Button
-                          variant="ghost"
-                          size="sm"
-                          className="h-6 rounded-md px-2 text-[10px] font-bold text-accent"
-                          onClick={() => void handleGenerate("chatExamples", "replace")}
-                          disabled={generating === "chatExamples"}
-                        >
-                          {generating === "chatExamples" ? "generating..." : "generate"}
-                        </Button>
-                      </div>
-                      <div className={`${scrollPaneCls} flex flex-col gap-2`}>
-                        {(d.messageExamples ?? []).map((convo, ci) => (
-                          <div
-                            key={convo.examples.map((msg) => `${msg.name}:${msg.content?.text ?? ""}`).join("|")}
-                            className="rounded-lg border border-[#d6d3c6]/40 dark:border-border/30 p-2.5"
-                          >
-                            <div className="mb-2 flex items-center justify-between">
-                              <span className="text-[9px] font-bold uppercase tracking-widest text-[#9ca3af] dark:text-muted/60">
-                                {t("characterview.conversation")} {ci + 1}
-                              </span>
-                              <button
-                                type="button"
-                                className="text-[#9ca3af] hover:text-red-500 transition-colors"
-                                onClick={() => {
-                                  const updated = [...(d.messageExamples ?? [])];
-                                  updated.splice(ci, 1);
-                                  handleFieldEdit("messageExamples", updated);
-                                }}
-                              >
-                                <svg width="10" height="10" viewBox="0 0 10 10" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"><path d="M2 2l6 6M8 2l-6 6" /></svg>
-                              </button>
-                            </div>
-                            <div className="flex flex-col gap-1.5">
-                              {convo.examples.map((msg, mi) => (
-                                <div key={`${msg.name}:${msg.content?.text ?? ""}`} className="flex items-center gap-2">
-                                  <span className={`w-10 shrink-0 text-right text-[9px] font-bold uppercase tracking-wider ${msg.name === "{{user1}}" ? "text-[#9ca3af] dark:text-muted" : "text-accent"}`}>
-                                    {msg.name === "{{user1}}" ? "user" : "agent"}
-                                  </span>
-                                  <input
-                                    type="text"
-                                    value={msg.content?.text ?? ""}
-                                    onChange={(e) => {
-                                      const updated = [...(d.messageExamples ?? [])];
-                                      const convoClone = { examples: [...updated[ci].examples] };
-                                      convoClone.examples[mi] = { ...convoClone.examples[mi], content: { text: e.target.value } };
-                                      updated[ci] = convoClone;
-                                      handleFieldEdit("messageExamples", updated);
-                                    }}
-                                    className="h-7 flex-1 rounded-md border border-[#d6d3c6]/40 dark:border-border/30 bg-white/60 dark:bg-white/5 px-2 font-mono text-[11px] text-[#1e2329] dark:text-[hsl(40,10%,84%)] outline-none focus:border-accent"
-                                  />
-                                </div>
-                              ))}
-                            </div>
-                          </div>
-                        ))}
-                        {(d.messageExamples ?? []).length === 0 && (
-                          <div className="rounded-md border border-dashed border-[#d6d3c6]/60 dark:border-border/30 py-2 text-center text-[11px] text-[#9ca3af] dark:text-muted">
-                            {t("characterview.noChatExamplesYet")}
-                          </div>
-                        )}
-                      </div>
-                    </div>
-                  )}
-
-                  {/* ── Post Examples (Directions + Examples mode) ── */}
-                  {activeSection === "directions" && customizeStep === "examples" && (
-                    <div className="flex flex-col gap-2" data-testid="character-post-examples-card">
-                      <div className="flex items-center justify-between">
-                        <span className="text-xs font-medium text-[#6d737a] dark:text-muted">{t("characterview.postExamples")}</span>
-                        <Button
-                          variant="ghost"
-                          size="sm"
-                          className="h-6 rounded-md px-2 text-[10px] font-bold text-accent"
-                          onClick={() => void handleGenerate("postExamples", "replace")}
-                          disabled={generating === "postExamples"}
-                        >
-                          {generating === "postExamples" ? "generating..." : "generate"}
-                        </Button>
-                      </div>
-                      <div className={`${scrollPaneCls} flex flex-col gap-1.5`}>
-                        {(d.postExamples ?? []).map((post: string, pi: number) => (
-                          <div key={post || `post-${pi}`} className="group flex items-center gap-1.5">
-                            <input
-                              type="text"
-                              value={post}
-                              onChange={(e) => {
-                                const updated = [...(d.postExamples ?? [])];
-                                updated[pi] = e.target.value;
-                                handleFieldEdit("postExamples", updated);
-                              }}
-                              className="h-7 flex-1 rounded-md border border-[#d6d3c6]/40 dark:border-border/30 bg-white/60 dark:bg-white/5 px-2 font-mono text-[11px] text-[#1e2329] dark:text-[hsl(40,10%,84%)] outline-none focus:border-accent"
-                            />
-                            <button
-                              type="button"
-                              className="shrink-0 text-[#9ca3af] opacity-0 transition-opacity group-hover:opacity-100 hover:text-red-500"
-                              onClick={() => {
-                                const updated = [...(d.postExamples ?? [])];
-                                updated.splice(pi, 1);
-                                handleFieldEdit("postExamples", updated);
-                              }}
-                            >
-                              <svg width="10" height="10" viewBox="0 0 10 10" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"><path d="M2 2l6 6M8 2l-6 6" /></svg>
-                            </button>
-                          </div>
-                        ))}
-                        {(d.postExamples ?? []).length === 0 && (
-                          <div className="rounded-md border border-dashed border-[#d6d3c6]/60 dark:border-border/30 py-2 text-center text-[11px] text-[#9ca3af] dark:text-muted">
-                            {t("characterview.noPostExamplesYet")}
-                          </div>
-                        )}
-                      </div>
-                      <div className="border-t border-[#d6d3c6]/40 dark:border-border/30 pt-2">
-                        <button
-                          type="button"
-                          className="text-[10px] font-bold text-accent hover:underline"
-                          onClick={() => {
-                            const updated = [...(d.postExamples ?? []), ""];
-                            handleFieldEdit("postExamples", updated);
-                          }}
-                        >
-                          {t("characterview.AddPost")}
-                        </button>
-                      </div>
-                    </div>
-                  )}
-                </div>
-              </div>
-
-              {/* ── Sidebar (right) ── */}
-              <div
-                className={`${bookSidebarCls} flex w-20 flex-col items-center rounded-r-[1.75rem] border-l border-white/[0.08] py-3`}
-                role="tablist"
-                aria-orientation="vertical"
-              >
-                <div className="pointer-events-none absolute inset-x-2 top-2 h-10 rounded-full bg-[linear-gradient(180deg,rgba(255,255,255,0.12)_0%,rgba(255,255,255,0)_100%)] blur-sm" />
-                <div className="pointer-events-none absolute inset-y-0 left-0 w-px bg-white/[0.08]" />
-                <div className="pointer-events-none absolute inset-y-0 right-0 w-px bg-black/35" />
-                {SIDEBAR_TABS.map(({ key, icon: Icon, labelKey }) => {
-                  const isActive = activeSection === key;
-                  return (
-                    <button
-                      key={key}
-                      type="button"
-                      role="tab"
-                      aria-selected={isActive}
-                      className={`relative flex w-full items-center justify-center px-2 py-3.5 transition-colors border-b border-white/[0.06] last:border-b-0 ${isActive ? "text-[#f7e7bf]" : "text-[#999da7] hover:text-white/80"
-                        }`}
-                      onClick={() => {
-                        setActiveSection(key);
-                        if (key === "styleRules" && customizeStep === "examples") {
-                          setCustomizeStep("core");
-                        }
-                      }}
-                      onKeyDown={(e) => {
-                        const keys = SIDEBAR_TABS.map((tab) => tab.key);
-                        const idx = keys.indexOf(key);
-                        if (e.key === "ArrowDown") {
-                          e.preventDefault();
-                          const next = keys[(idx + 1) % keys.length];
-                          setActiveSection(next);
-                        } else if (e.key === "ArrowUp") {
-                          e.preventDefault();
-                          const prev = keys[(idx - 1 + keys.length) % keys.length];
-                          setActiveSection(prev);
-                        }
-                      }}
-                      id={`notebook-tab-${key}`}
-                      data-testid={`notebook-tab-${key}`}
-                    >
-                      {isActive && (
-                        <div className="absolute inset-y-2 left-0 w-[4px] rounded-r-full bg-[#d4a14c] shadow-[0_0_12px_rgba(212,161,76,0.45)]" />
-                      )}
-                      <div className="relative z-10 flex flex-col items-center gap-1.5">
-                        <div
-                          className={`flex h-10 w-10 items-center justify-center rounded-full border transition-all ${isActive
-                            ? "border-[#f0ce85]/55 bg-[radial-gradient(circle_at_30%_30%,rgba(255,236,195,0.28)_0%,rgba(255,236,195,0.05)_42%,rgba(255,255,255,0)_100%)] shadow-[0_0_18px_rgba(220,176,90,0.22)]"
-                            : "border-white/10 bg-white/[0.03]"
-                            }`}
-                        >
-                          <Icon className="h-4.5 w-4.5" />
-                        </div>
-                        <span className="max-w-[4.1rem] text-center text-[8px] font-semibold uppercase tracking-[0.16em] leading-[1.22]">
-                          {t(labelKey)}
-                        </span>
-                      </div>
-                    </button>
-                  );
-                })}
-              </div>
-            </div>
-          </div>
-        </div>
-      )}
-
-      <div className={`${sectionCls} relative z-10 ${sceneOverlay ? "character-action-bar" : ""}`}>
-        {(characterSaveSuccess || combinedSaveError || saveAdvisory) && (
-          <div className="mb-3 flex flex-wrap items-center justify-center gap-2">
-            {characterSaveSuccess && (
-              <span className="rounded-lg border border-green-400/20 bg-green-400/10 px-3 py-1.5 text-xs font-bold text-green-400">
-                {characterSaveSuccess}
-              </span>
-            )}
-            {saveAdvisory && (
-              <span className="rounded-lg border border-amber-400/20 bg-amber-400/10 px-3 py-1.5 text-xs font-medium text-amber-300">
-                {saveAdvisory}
-              </span>
-            )}
-            {combinedSaveError && (
-              <span className="rounded-lg border border-danger/20 bg-danger/10 px-3 py-1.5 text-xs font-medium text-danger">
-                {combinedSaveError}
-              </span>
-            )}
-          </div>
-        )}
-
-        <div className="flex min-h-10 flex-row items-center justify-between gap-2">
-          <div className="flex items-center justify-start">
-            <div
-              className="flex min-w-0 items-center gap-2"
-              data-testid="character-voice-picker"
-            >
-              <Button
-                type="button"
-                variant={voiceSelectionLocked ? "default" : "outline"}
-                size="icon"
-                className="h-8 w-8 rounded-full border-border/50 bg-bg/65 p-0 shadow-inner backdrop-blur-sm"
-                onClick={() => setVoiceSelectionLocked((value) => !value)}
-                aria-label={
-                  voiceSelectionLocked
-                    ? "Unlock voice selection"
-                    : "Lock voice selection"
-                }
-                title={
-                  voiceSelectionLocked
-                    ? "Voice stays pinned when switching characters"
-                    : "Lock current voice"
-                }
-              >
-                {voiceSelectionLocked ? (
-                  <Lock className="h-3.5 w-3.5" />
-                ) : (
-                  <LockOpen className="h-3.5 w-3.5" />
-                )}
-              </Button>
-              <ThemedSelect
-                value={voiceSelectValue}
-                groups={VOICE_SELECT_GROUPS}
-                onChange={(id) => {
-                  const preset = PREMADE_VOICES.find(
-                    (voicePreset) => voicePreset.id === id,
-                  );
-                  if (preset) handleSelectPreset(preset);
-                }}
-                placeholder={t("characterview.selectAVoice")}
-                menuPlacement="top"
-                className="min-w-0 w-[7rem] sm:w-[11rem]"
-                triggerClassName="h-8 rounded-full border-border/50 bg-bg/65 px-4 py-0 text-[11px] shadow-inner backdrop-blur-sm"
-                menuClassName="border-border/60 bg-bg/92 shadow-2xl backdrop-blur-md"
-              />
-              <Button
-                type="button"
-                variant={voiceTesting ? "destructive" : "outline"}
-                size="icon"
-                className="h-8 w-8 rounded-full border-border/50 bg-bg/65 p-0 shadow-inner backdrop-blur-sm"
-                onClick={() =>
-                  voiceTesting
-                    ? handleStopTest()
-                    : activeVoicePreset
-                      ? handleTestVoice(activeVoicePreset.previewUrl)
-                      : undefined
-                }
-                aria-label={voiceTesting ? "Stop voice preview" : "Preview voice"}
-                title={voiceTesting ? "Stop voice preview" : "Preview voice"}
-                disabled={!activeVoicePreset || voiceLoading}
-              >
-                {voiceTesting ? (
-                  <VolumeX className="h-3.5 w-3.5" />
-                ) : (
-                  <Volume2 className="h-3.5 w-3.5" />
-                )}
-              </Button>
-            </div>
-          </div>
-
-          <div className="flex items-center">
-            <Button
-              size="lg"
-              className="ce-save-btn"
-              disabled={characterSaving || voiceSaving}
-              onClick={() => void handleSaveAll()}
-            >
-              {characterSaving || voiceSaving ? (
-                "saving..."
-              ) : (
-                <>
-                  <span className="hidden sm:inline">Save Character</span>
-                  <span className="sm:hidden">Save</span>
-                </>
-              )}
-            </Button>
-          </div>
-
-          <div className="flex items-center justify-end">
-            <Button
-              type="button"
-              variant={customOverridesEnabled ? "outline" : "default"}
-              size="sm"
-              className={`ce-customize-btn ${customOverridesEnabled
-                ? "border-border/40 bg-bg/40 text-txt"
-                : ""
-                }`}
-              onClick={() =>
-                handleCustomOverridesChange(!customOverridesEnabled)
-              }
-              data-testid="character-customize-toggle"
-            >
-              {customizationActionLabel}
-            </Button>
-          </div>
-        </div>
-      </div>
-    </div>
-  );
-}