solfaces 2.2.0 → 2.3.0

package/dist/agent/mcp-server.cjs

@@ -19,7 +19,10 @@ var EYE_COLORS = [
   "#3868A8",
   "#38784C",
   "#808838",
-  "#586878"
+  "#586878",
+  "#A06830",
+  "#685898",
+  "#889898"
 ];
 var HAIR_COLORS = [
   "#1A1A24",
@@ -43,7 +46,9 @@ var BG_COLORS = [
   "#7f8bbd",
   "#8869ab",
   "#b785b3",
-  "#ab6984"
+  "#ab6984",
+  "#a07ab5",
+  "#74b5a0"
 ];
 function djb2(str) {
   let hash = 5381;
@@ -67,22 +72,20 @@ function generateTraits(walletAddress, overrides) {
   const traits = {
     faceShape: Math.floor(rand() * 4),
     skinColor: Math.floor(rand() * 10),
-    eyeStyle: Math.floor(rand() * 8),
-    eyeColor: Math.floor(rand() * 5),
-    eyebrows: Math.floor(rand() * 5),
-    nose: Math.floor(rand() * 4),
+    eyeStyle: Math.floor(rand() * 9),
+    eyeColor: Math.floor(rand() * 8),
+    eyebrows: Math.floor(rand() * 8),
+    nose: Math.floor(rand() * 8),
     mouth: Math.floor(rand() * 8),
     hairStyle: Math.floor(rand() * 10),
     hairColor: Math.floor(rand() * 10),
-    accessory: Math.floor(rand() * 10),
-    bgColor: Math.floor(rand() * 10)
+    accessory: Math.floor(rand() * 12),
+    bgColor: Math.floor(rand() * 12)
   };
   return overrides ? { ...traits, ...overrides } : traits;
 }
 function effectiveAccessory(traits) {
-  const ai = traits.accessory % 10;
-  const hi = traits.hairStyle % 10;
-  if ((ai === 4 || ai === 7) && (hi === 5 || hi === 6)) return 0;
+  const ai = traits.accessory % 12;
   return ai;
 }
 var FACE_LABELS = ["Squircle"];
@@ -98,22 +101,22 @@ var SKIN_LABELS = [
   "Brown",
   "Deep"
 ];
-var EYE_STYLE_LABELS = ["Round", "Minimal", "Almond", "Wide", "Relaxed", "Joyful", "Bright", "Gentle"];
-var EYE_COLOR_LABELS = ["Chocolate", "Sky", "Emerald", "Hazel", "Storm"];
-var BROW_LABELS = ["Wispy", "Straight", "Natural", "Arched", "Angled"];
-var NOSE_LABELS = ["Shadow", "Button", "Soft", "Nostrils"];
+var EYE_STYLE_LABELS = ["Round", "Minimal", "Almond", "Wide", "Relaxed", "Joyful", "Bright", "Gentle", "Side-look"];
+var EYE_COLOR_LABELS = ["Chocolate", "Sky", "Emerald", "Hazel", "Storm", "Amber", "Violet", "Gray"];
+var BROW_LABELS = ["Wispy", "Straight", "Natural", "Arched", "Angled", "Worried", "Bushy", "Thin"];
+var NOSE_LABELS = ["Shadow", "Button", "Soft", "Nostrils", "Pointed", "Wide", "Bridge", "Snub"];
 var MOUTH_LABELS = ["Smile", "Calm", "Happy", "Oh", "Smirk", "Grin", "Flat", "Pout"];
 var HAIR_STYLE_LABELS = [
   "Bald",
-  "Short",
+  "Crew",
   "Curly",
-  "Side Sweep",
-  "Puff",
+  "Side Part",
   "Long",
-  "Bob",
   "Buzz",
-  "Wavy",
-  "Topknot"
+  "Beanie",
+  "Cap",
+  "Mohawk",
+  "Bun"
 ];
 var HAIR_COLOR_LABELS = [
   "Black",
@@ -137,7 +140,9 @@ var ACCESSORY_LABELS = [
   "Freckles",
   "Stud Earrings",
   "Aviators",
-  "Band-Aid"
+  "Band-Aid",
+  "Left Eyebrow Slit",
+  "Right Eyebrow Slit"
 ];
 var BG_COLOR_LABELS = [
   "Rose",
@@ -149,7 +154,9 @@ var BG_COLOR_LABELS = [
   "Sky",
   "Lavender",
   "Orchid",
-  "Blush"
+  "Blush",
+  "Lilac",
+  "Seafoam"
 ];
 function getTraitLabels(traits) {
   return {
@@ -203,7 +210,21 @@ function blend(a, b, t = 0.5) {
 }
 function luminance(hex) {
   const [r, g, b] = hexToRgb(hex);
-  return (r + g + b) / 3;
+  return 0.299 * r + 0.587 * g + 0.114 * b;
+}
+function relativeLuminance(hex) {
+  const [r, g, b] = hexToRgb(hex).map((c) => {
+    const s = c / 255;
+    return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+  });
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+function contrastRatio(hex1, hex2) {
+  const l1 = relativeLuminance(hex1);
+  const l2 = relativeLuminance(hex2);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
 }
 function deriveSkinColors(skin) {
   const sL = luminance(skin);
@@ -237,11 +258,20 @@ function deriveSkinColors(skin) {
   const lipRaw = blend(skin, lipBase, Math.min(0.82, lipBlend));
   const [lr, lg, lb] = hexToRgb(lipRaw);
   const lipD = Math.abs(sr - lr) + Math.abs(sg - lg) + Math.abs(sb - lb);
-  const lipColor = lipD < 60 ? blend(skin, lipBase, 0.78) : lipRaw;
-  const browColor = isDark ? lighten(skin, sL < 80 ? 0.35 : 0.25) : darken(skin, 0.55);
-  const noseFill = isDark ? lighten(skin, 0.2) : darken(skin, 0.2);
+  let lipColor = lipD < 60 ? blend(skin, lipBase, 0.78) : lipRaw;
+  let attempts = 0;
+  while (contrastRatio(lipColor, skin) < 1.8 && attempts < 12) {
+    lipColor = darken(lipColor, 0.06);
+    attempts++;
+  }
+  const browColor = isDark ? lighten(skin, sL < 80 ? 0.35 : sL < 100 ? 0.32 : 0.25) : darken(skin, 0.55);
+  const noseShift = 0.2 + 0.06 * (1 - Math.abs(sL - 100) / 140);
+  const noseFill = isDark ? lighten(skin, noseShift) : darken(skin, noseShift);
   const earT = Math.max(0, Math.min(1, (sL - 100) / 60));
-  const earFill = blend(lighten(skin, 0.08), skinMid, earT);
+  let earFill = blend(lighten(skin, 0.08), skinMid, earT);
+  if (contrastRatio(earFill, skin) < 1.05) {
+    earFill = isDark ? lighten(earFill, 0.06) : darken(earFill, 0.06);
+  }
   const earShadow = darken(skin, 0.1 + 0.06 * (1 - Math.min(1, sL / 160)));
   const lidColor = isDark ? lighten(skin, 0.18) : darken(skin, 0.15);
   const ewT = Math.max(0, Math.min(1, (sL - 60) / 180));
@@ -265,10 +295,198 @@ function deriveSkinColors(skin) {
     accessoryColor
   };
 }
-function buzzOpacity(hairCol, skin) {
-  const [hr, hg, hb] = hexToRgb(hairCol);
-  const [sr, sg, sb] = hexToRgb(skin);
-  return Math.abs(hr - sr) + Math.abs(hg - sg) + Math.abs(hb - sb) < 80 ? 0.7 : 0.5;
+
+// src/core/describe.ts
+var SKIN_TONES = {
+  0: "porcelain",
+  1: "ivory",
+  2: "fair",
+  3: "light",
+  4: "sand",
+  5: "golden",
+  6: "warm",
+  7: "caramel",
+  8: "brown",
+  9: "deep"
+};
+var EYE_STYLES = {
+  0: "round, wide-open",
+  1: "small and minimal",
+  2: "almond-shaped",
+  3: "wide and expressive",
+  4: "relaxed, half-lidded",
+  5: "joyful, crescent-shaped",
+  6: "bright and sparkling",
+  7: "gentle and narrow",
+  8: "side-looking, shifted"
+};
+var EYE_COLORS_DESC = {
+  0: "dark brown",
+  1: "blue",
+  2: "green",
+  3: "hazel",
+  4: "gray",
+  5: "amber",
+  6: "violet",
+  7: "steel gray"
+};
+var EYEBROW_STYLES = {
+  0: "wispy",
+  1: "straight",
+  2: "natural",
+  3: "elegantly arched",
+  4: "sharply angled",
+  5: "worried, furrowed",
+  6: "bushy",
+  7: "thin, delicate"
+};
+var NOSE_STYLES = {
+  0: "a subtle shadow nose",
+  1: "a small button nose",
+  2: "a soft curved nose",
+  3: "a button nose with visible nostrils",
+  4: "a pointed nose",
+  5: "a wide, broad nose",
+  6: "a nose with a visible bridge",
+  7: "a small snub nose"
+};
+var MOUTH_STYLES = {
+  0: "a gentle smile",
+  1: "a calm, neutral expression",
+  2: "a happy grin",
+  3: "a surprised O-shaped mouth",
+  4: "a confident smirk",
+  5: "a wide, toothy grin",
+  6: "a flat, straight expression",
+  7: "a soft pout"
+};
+var ACCESSORY_DESC = {
+  0: "",
+  1: "a beauty mark",
+  2: "round glasses",
+  3: "rectangular glasses",
+  4: "a dangling earring",
+  5: "a headband",
+  6: "freckles",
+  7: "stud earrings",
+  8: "aviator sunglasses",
+  9: "a band-aid",
+  10: "a left eyebrow slit",
+  11: "a right eyebrow slit"
+};
+var BG_COLORS_DESC = {
+  0: "rose",
+  1: "olive",
+  2: "sage",
+  3: "fern",
+  4: "mint",
+  5: "ocean",
+  6: "sky",
+  7: "lavender",
+  8: "orchid",
+  9: "blush",
+  10: "lilac",
+  11: "seafoam"
+};
+function describeAppearance(walletAddress, options) {
+  const traits = generateTraits(walletAddress);
+  const {
+    includeBackground = true,
+    format = "paragraph",
+    perspective = "third",
+    name
+  } = options ?? {};
+  if (format === "structured") return buildStructured(traits, includeBackground);
+  if (format === "compact") return buildCompact(traits);
+  return buildParagraph(traits, perspective, name, includeBackground);
+}
+function buildParagraph(t, perspective, name, includeBg) {
+  const parts = [];
+  const ai = effectiveAccessory(t);
+  const subject = perspective === "first" ? name ? `I'm ${name}. I have` : "I have" : name ? `${name} has` : "This SolFace has";
+  const im = perspective === "first" ? "I'm" : "They're";
+  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
+  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? "round";
+  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? "dark";
+  parts.push(`${eyeStyle} ${eyeColor} eyes`);
+  const brows = EYEBROW_STYLES[t.eyebrows];
+  if (brows) parts.push(`${brows} eyebrows`);
+  parts.push(perspective === "first" ? "and am bald" : "and is bald");
+  let desc = parts[0];
+  if (parts.length > 2) {
+    desc += ", " + parts.slice(1, -1).join(", ") + ", " + parts[parts.length - 1];
+  } else if (parts.length === 2) {
+    desc += " and " + parts[1];
+  }
+  desc += ".";
+  const nose = NOSE_STYLES[t.nose];
+  if (nose) {
+    const noseSubject = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
+    desc += ` ${noseSubject} ${nose}.`;
+  }
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) {
+    desc += ` ${im} wearing ${acc}.`;
+  }
+  const mouth = MOUTH_STYLES[t.mouth] ?? "a smile";
+  const mouthVerb = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
+  desc += ` ${mouthVerb} ${mouth}.`;
+  if (includeBg) {
+    const bg = BG_COLORS_DESC[t.bgColor] ?? "colorful";
+    desc += ` The background is ${bg}.`;
+  }
+  return desc;
+}
+function buildStructured(t, includeBg) {
+  const ai = effectiveAccessory(t);
+  const lines = [
+    `Face: squircle`,
+    `Skin: ${SKIN_TONES[t.skinColor] ?? "warm"}`,
+    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? "round"}, ${EYE_COLORS_DESC[t.eyeColor] ?? "dark"}`,
+    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? "wispy"}`
+  ];
+  const nose = NOSE_STYLES[t.nose];
+  if (nose) lines.push(`Nose: ${nose.replace(/^a /, "")}`);
+  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? "smile"}`);
+  lines.push("Hair: bald");
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) lines.push(`Accessory: ${acc}`);
+  if (includeBg) {
+    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? "colorful"}`);
+  }
+  return lines.join("\n");
+}
+function buildCompact(t) {
+  const ai = effectiveAccessory(t);
+  const parts = [];
+  parts.push(`squircle face`);
+  parts.push(`${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
+  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? "dark"} ${EYE_STYLES[t.eyeStyle] ?? "round"} eyes`);
+  parts.push("bald");
+  const acc = ACCESSORY_DESC[ai];
+  if (acc) parts.push(acc);
+  parts.push((MOUTH_STYLES[t.mouth] ?? "smiling").replace(/^a /, ""));
+  return parts.join(", ");
+}
+function solFaceAltText(walletAddress) {
+  return `SolFace avatar: ${describeAppearance(walletAddress, { format: "compact", includeBackground: false })}`;
+}
+function agentAppearancePrompt(walletAddress, agentName) {
+  const desc = describeAppearance(walletAddress, {
+    perspective: "first",
+    name: agentName,
+    includeBackground: false,
+    format: "paragraph"
+  });
+  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, "0");
+  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic \u2014 anyone who looks up my wallet will see the same face.`;
+}
+function djb2Simple(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) + hash + str.charCodeAt(i) | 0;
+  }
+  return hash >>> 0;
 }
 
 // src/core/renderer.ts
@@ -284,12 +502,9 @@ function buildDefs(id, skin, skinHi, skinLo, hairCol, bgCol, cheekColor, cheekOp
   let d = "<defs>";
   d += `<linearGradient id="${id}sg" x1="0" y1="0" x2="0" y2="1">`;
   d += `<stop offset="0%" stop-color="${skinHi}"/>`;
+  d += `<stop offset="50%" stop-color="${skin}"/>`;
   d += `<stop offset="100%" stop-color="${skinLo}"/>`;
   d += `</linearGradient>`;
-  d += `<linearGradient id="${id}hg" x1="0" y1="0" x2="0" y2="1">`;
-  d += `<stop offset="0%" stop-color="${lighten(hairCol, 0.15)}"/>`;
-  d += `<stop offset="100%" stop-color="${darken(hairCol, 0.15)}"/>`;
-  d += `</linearGradient>`;
   d += `<linearGradient id="${id}bg" x1="0" y1="0" x2="1" y2="1">`;
   d += `<stop offset="0%" stop-color="${lighten(bgCol, 0.12)}"/>`;
   d += `<stop offset="100%" stop-color="${darken(bgCol, 0.12)}"/>`;
@@ -315,18 +530,8 @@ function buildDefs(id, skin, skinHi, skinLo, hairCol, bgCol, cheekColor, cheekOp
   d += "</defs>";
   return d;
 }
-function renderHairBack(hi, id, flat) {
-  const fill = flat ? "currentColor" : `url(#${id}hg)`;
-  switch (hi) {
-    case 5:
-      return `<g fill="${fill}"><rect x="10" y="14" width="44" height="42" rx="6"/></g>`;
-    case 6:
-      return `<g fill="${fill}"><rect x="12" y="14" width="40" height="32" rx="8"/></g>`;
-    case 8:
-      return `<g fill="${fill}"><rect x="11" y="14" width="42" height="38" rx="8"/></g>`;
-    default:
-      return "";
-  }
+function renderHairBack(_hi, _id, _flat) {
+  return "";
 }
 function renderEars(earFill, earShadow) {
   return `<ellipse cx="11" cy="34" rx="4" ry="5" fill="${earFill}"/><ellipse cx="11" cy="34" rx="2.5" ry="3.5" fill="${earShadow}" opacity="0.3"/><ellipse cx="53" cy="34" rx="4" ry="5" fill="${earFill}"/><ellipse cx="53" cy="34" rx="2.5" ry="3.5" fill="${earShadow}" opacity="0.3"/>`;
@@ -340,35 +545,8 @@ function renderFaceOverlays(id, flat) {
   if (flat) return "";
   return `<rect x="14" y="16" width="36" height="38" rx="12" ry="12" fill="url(#${id}glow)"/><rect x="14" y="16" width="36" height="38" rx="12" ry="12" fill="url(#${id}chin)"/><ellipse cx="22" cy="42" rx="5" ry="3.5" fill="url(#${id}cL)"/><ellipse cx="42" cy="42" rx="5" ry="3.5" fill="url(#${id}cR)"/><line x1="20" y1="50" x2="44" y2="50" stroke="currentColor" stroke-width="0.3" opacity="0.08" stroke-linecap="round"/>`;
 }
-function renderHairFront(hi, id, hairCol, skin, flat) {
-  const fill = flat ? hairCol : `url(#${id}hg)`;
-  switch (hi) {
-    case 0:
-      return "";
-    // Bald
-    case 1:
-      return `<path d="M14 28 Q14 14 32 12 Q50 14 50 28 L50 22 Q50 12 32 10 Q14 12 14 22 Z" fill="${fill}"/>`;
-    case 2:
-      return `<g fill="${fill}"><circle cx="20" cy="14" r="5"/><circle cx="28" cy="11" r="5.5"/><circle cx="36" cy="11" r="5.5"/><circle cx="44" cy="14" r="5"/><circle cx="16" cy="20" r="4"/><circle cx="48" cy="20" r="4"/></g>`;
-    case 3:
-      return `<path d="M14 26 Q14 12 32 10 Q50 12 50 26 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><path d="M14 20 Q8 16 10 8 Q14 10 20 16 Z" fill="${fill}"/>`;
-    case 4:
-      return `<ellipse cx="32" cy="10" rx="14" ry="8" fill="${fill}"/>`;
-    case 5:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/>`;
-    case 6:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><rect x="10" y="28" width="8" height="14" rx="4" fill="${fill}"/><rect x="46" y="28" width="8" height="14" rx="4" fill="${fill}"/>`;
-    case 7: {
-      const bOp = buzzOpacity(hairCol, skin);
-      return `<rect x="15" y="13" width="34" height="16" rx="10" ry="8" fill="${hairCol}" opacity="${bOp.toFixed(2)}"/>`;
-    }
-    case 8:
-      return `<path d="M14 28 Q14 12 32 10 Q50 12 50 28 L50 20 Q50 10 32 8 Q14 10 14 20 Z" fill="${fill}"/><path d="M12 30 Q10 20 14 16" fill="none" stroke="${fill}" stroke-width="4" stroke-linecap="round"/><path d="M52 30 Q54 20 50 16" fill="none" stroke="${fill}" stroke-width="4" stroke-linecap="round"/>`;
-    case 9:
-      return `<path d="M14 28 Q14 14 32 12 Q50 14 50 28 L50 22 Q50 12 32 10 Q14 12 14 22 Z" fill="${fill}"/><ellipse cx="32" cy="6" rx="6" ry="5" fill="${fill}"/>`;
-    default:
-      return "";
-  }
+function renderHairFront(_hi, _id, _hairCol, _skin, _flat) {
+  return "";
 }
 function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
   const lx = 25, rx = 39, y = 33;
@@ -383,8 +561,10 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       if (full) s += `<circle cx="${rx + 1.5}" cy="${y - 1}" r="0.7" fill="white" opacity="0.8"/>`;
       break;
     case 1:
-      s += `<circle cx="${lx}" cy="${y}" r="2" fill="${eyeCol}"/>`;
-      s += `<circle cx="${rx}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      s += `<circle cx="${lx}" cy="${y}" r="2.2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${lx + 0.5}" cy="${y - 0.5}" r="0.5" fill="white" opacity="0.4"/>`;
+      s += `<circle cx="${rx}" cy="${y}" r="2.2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${rx + 0.5}" cy="${y - 0.5}" r="0.5" fill="white" opacity="0.4"/>`;
       break;
     case 2:
       s += `<ellipse cx="${lx}" cy="${y}" rx="4.5" ry="2.8" fill="${eyeWhite}"/>`;
@@ -411,24 +591,16 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       if (full) s += `<line x1="${rx - 4.5}" y1="${y - 0.5}" x2="${rx + 4.5}" y2="${y - 0.5}" stroke="${lidColor}" stroke-width="0.8" stroke-linecap="round"/>`;
       break;
     case 5:
-      s += `<path d="M${lx - 4} ${y} Q${lx} ${y + 4} ${lx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="1.8" stroke-linecap="round"/>`;
-      s += `<path d="M${rx - 4} ${y} Q${rx} ${y + 4} ${rx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="1.8" stroke-linecap="round"/>`;
+      s += `<path d="M${lx - 4} ${y} Q${lx} ${y + 4.5} ${lx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="2" stroke-linecap="round"/>`;
+      s += `<path d="M${rx - 4} ${y} Q${rx} ${y + 4.5} ${rx + 4} ${y}" fill="none" stroke="${eyeCol}" stroke-width="2" stroke-linecap="round"/>`;
       break;
     case 6:
       s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${lx + 0.5}" cy="${y}" r="2" fill="${eyeCol}"/>`;
       s += `<circle cx="${lx + 1.5}" cy="${y - 1}" r="1" fill="white" opacity="0.9"/>`;
-      if (full) {
-        s += `<line x1="${lx + 2.5}" y1="${y - 3.5}" x2="${lx + 4}" y2="${y - 5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-        s += `<line x1="${lx + 3.5}" y1="${y - 2.5}" x2="${lx + 5}" y2="${y - 3.5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-      }
       s += `<circle cx="${rx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${rx + 0.5}" cy="${y}" r="2" fill="${eyeCol}"/>`;
       s += `<circle cx="${rx + 1.5}" cy="${y - 1}" r="1" fill="white" opacity="0.9"/>`;
-      if (full) {
-        s += `<line x1="${rx + 2.5}" y1="${y - 3.5}" x2="${rx + 4}" y2="${y - 5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-        s += `<line x1="${rx + 3.5}" y1="${y - 2.5}" x2="${rx + 5}" y2="${y - 3.5}" stroke="${eyeCol}" stroke-width="0.8" stroke-linecap="round"/>`;
-      }
       break;
     case 7:
       s += `<ellipse cx="${lx}" cy="${y}" rx="4.5" ry="1.5" fill="${eyeWhite}"/>`;
@@ -436,6 +608,14 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
       s += `<ellipse cx="${rx}" cy="${y}" rx="4.5" ry="1.5" fill="${eyeWhite}"/>`;
       s += `<ellipse cx="${rx + 0.5}" cy="${y}" rx="2.2" ry="1.2" fill="${eyeCol}"/>`;
       break;
+    case 8:
+      s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
+      s += `<circle cx="${lx - 1}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${lx - 0.3}" cy="${y - 0.8}" r="0.7" fill="white" opacity="0.8"/>`;
+      s += `<circle cx="${rx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
+      s += `<circle cx="${rx - 1}" cy="${y}" r="2" fill="${eyeCol}"/>`;
+      if (full) s += `<circle cx="${rx - 0.3}" cy="${y - 0.8}" r="0.7" fill="white" opacity="0.8"/>`;
+      break;
     default:
       s += `<circle cx="${lx}" cy="${y}" r="3.5" fill="${eyeWhite}"/>`;
       s += `<circle cx="${lx + 0.8}" cy="${y}" r="2" fill="${eyeCol}"/>`;
@@ -448,7 +628,7 @@ function renderEyes(ei, eyeCol, eyeWhite, lidColor, full) {
   }
   return s;
 }
-function renderEyebrows(bi, browColor) {
+function renderEyebrows(bi, browColor, full = true) {
   const lx = 25, rx = 39, y = 27;
   switch (bi) {
     case 0:
@@ -461,6 +641,14 @@ function renderEyebrows(bi, browColor) {
       return `<path d="M${lx - 4} ${y + 1} Q${lx} ${y - 3} ${lx + 4} ${y + 1}" fill="none" stroke="${browColor}" stroke-width="1" stroke-linecap="round"/><path d="M${rx - 4} ${y + 1} Q${rx} ${y - 3} ${rx + 4} ${y + 1}" fill="none" stroke="${browColor}" stroke-width="1" stroke-linecap="round"/>`;
     case 4:
       return `<polyline points="${lx - 3},${y + 1} ${lx},${y - 2} ${lx + 3},${y}" fill="none" stroke="${browColor}" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/><polyline points="${rx - 3},${y} ${rx},${y - 2} ${rx + 3},${y + 1}" fill="none" stroke="${browColor}" stroke-width="1.2" stroke-linecap="round" stroke-linejoin="round"/>`;
+    case 5:
+      return `<line x1="${lx - 3}" y1="${y - 1}" x2="${lx + 3}" y2="${y + 1}" stroke="${browColor}" stroke-width="1.1" stroke-linecap="round"/><line x1="${rx - 3}" y1="${y + 1}" x2="${rx + 3}" y2="${y - 1}" stroke="${browColor}" stroke-width="1.1" stroke-linecap="round"/>`;
+    case 6: {
+      const bw = full ? "2.0" : "1.5";
+      return `<path d="M${lx - 4} ${y + 0.5} Q${lx} ${y - 2} ${lx + 4} ${y + 0.5}" fill="none" stroke="${browColor}" stroke-width="${bw}" stroke-linecap="round"/><path d="M${rx - 4} ${y + 0.5} Q${rx} ${y - 2} ${rx + 4} ${y + 0.5}" fill="none" stroke="${browColor}" stroke-width="${bw}" stroke-linecap="round"/>`;
+    }
+    case 7:
+      return `<path d="M${lx - 3.5} ${y} Q${lx} ${y - 1.5} ${lx + 3.5} ${y}" fill="none" stroke="${browColor}" stroke-width="0.5" stroke-linecap="round"/><path d="M${rx - 3.5} ${y} Q${rx} ${y - 1.5} ${rx + 3.5} ${y}" fill="none" stroke="${browColor}" stroke-width="0.5" stroke-linecap="round"/>`;
     default:
       return "";
   }
@@ -476,6 +664,14 @@ function renderNose(ni, noseFill) {
       return `<path d="M${cx - 2} ${y + 1} Q${cx} ${y - 2} ${cx + 2} ${y + 1}" fill="none" stroke="${noseFill}" stroke-width="1" stroke-linecap="round" opacity="0.5"/>`;
     case 3:
       return `<circle cx="${cx - 1.8}" cy="${y}" r="1.2" fill="${noseFill}" opacity="0.4"/><circle cx="${cx + 1.8}" cy="${y}" r="1.2" fill="${noseFill}" opacity="0.4"/>`;
+    case 4:
+      return `<path d="M${cx} ${y - 2} L${cx - 2} ${y + 1.5} L${cx + 2} ${y + 1.5} Z" fill="${noseFill}" opacity="0.4"/>`;
+    case 5:
+      return `<ellipse cx="${cx}" cy="${y}" rx="3.5" ry="1.5" fill="${noseFill}" opacity="0.35"/>`;
+    case 6:
+      return `<line x1="${cx}" y1="${y - 3}" x2="${cx}" y2="${y + 1}" stroke="${noseFill}" stroke-width="1.2" stroke-linecap="round" opacity="0.4"/>`;
+    case 7:
+      return `<circle cx="${cx}" cy="${y + 0.5}" r="2" fill="${noseFill}" opacity="0.35"/><ellipse cx="${cx}" cy="${y - 0.5}" rx="1" ry="0.5" fill="${noseFill}" opacity="0.15"/>`;
     default:
       return `<ellipse cx="${cx}" cy="${y}" rx="2" ry="1.2" fill="${noseFill}" opacity="0.35"/>`;
   }
@@ -497,20 +693,20 @@ function renderMouth(mi, lipColor, isDark) {
     case 5:
       return `<path d="M${cx - 5} ${y} Q${cx} ${y + 6} ${cx + 5} ${y}" fill="${teethCol}" stroke="${lipColor}" stroke-width="1"/><line x1="${cx - 4}" y1="${y + 1.5}" x2="${cx + 4}" y2="${y + 1.5}" stroke="${lipColor}" stroke-width="0.3" opacity="0.3"/>`;
     case 6:
-      return `<line x1="${cx - 4}" y1="${y + 1}" x2="${cx + 4}" y2="${y + 1}" stroke="${lipColor}" stroke-width="1.5" stroke-linecap="round"/>`;
+      return `<path d="M${cx - 4} ${y + 0.5} Q${cx} ${y + 1.5} ${cx + 4} ${y + 0.5}" fill="none" stroke="${lipColor}" stroke-width="1.4" stroke-linecap="round"/>`;
     case 7:
       return `<ellipse cx="${cx}" cy="${y + 1}" rx="3.5" ry="2" fill="${lipColor}" opacity="0.25"/><path d="M${cx - 3} ${y} Q${cx} ${y + 2.5} ${cx + 3} ${y}" fill="none" stroke="${lipColor}" stroke-width="1.2" stroke-linecap="round"/>`;
     default:
       return `<path d="M${cx - 4} ${y} Q${cx} ${y + 4} ${cx + 4} ${y}" fill="none" stroke="${lipColor}" stroke-width="1.4" stroke-linecap="round"/>`;
   }
 }
-function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headbandColor) {
+function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headbandColor, beautyMarkColor = "#3a2a2a", freckleColor = "#a0785a", skinColor = "#E8BA8B") {
   switch (ai) {
     case 0:
       return "";
     // None
     case 1:
-      return `<circle cx="40" cy="44" r="0.8" fill="#3a2a2a"/>`;
+      return `<circle cx="40" cy="44" r="0.8" fill="${beautyMarkColor}"/>`;
     case 2:
       return `<g fill="none" stroke="${glassesColor}" stroke-width="1"><circle cx="25" cy="33" r="5.5"/><circle cx="39" cy="33" r="5.5"/><line x1="30.5" y1="33" x2="33.5" y2="33"/><line x1="19.5" y1="33" x2="14" y2="31"/><line x1="44.5" y1="33" x2="50" y2="31"/></g>`;
     case 3:
@@ -520,13 +716,17 @@ function renderAccessory(ai, accessoryColor, glassesColor, earringColor, headban
     case 5:
       return `<rect x="13" y="20" width="38" height="3.5" rx="1.5" fill="${headbandColor}" opacity="0.85"/>`;
     case 6:
-      return `<g fill="#a0785a" opacity="0.35"><circle cx="21" cy="40" r="0.6"/><circle cx="23" cy="42" r="0.5"/><circle cx="19" cy="41.5" r="0.5"/><circle cx="43" cy="40" r="0.6"/><circle cx="41" cy="42" r="0.5"/><circle cx="45" cy="41.5" r="0.5"/></g>`;
+      return `<g fill="${freckleColor}" opacity="0.35"><circle cx="21" cy="40" r="0.6"/><circle cx="23" cy="42" r="0.5"/><circle cx="19" cy="41.5" r="0.5"/><circle cx="43" cy="40" r="0.6"/><circle cx="41" cy="42" r="0.5"/><circle cx="45" cy="41.5" r="0.5"/></g>`;
     case 7:
       return `<circle cx="10" cy="37" r="1.2" fill="${earringColor}"/><circle cx="54" cy="37" r="1.2" fill="${earringColor}"/>`;
     case 8:
       return `<g fill="none" stroke="${glassesColor}" stroke-width="1.2"><path d="M19 30 Q19 28 25 28 Q31 28 31 33 Q31 38 25 38 Q19 38 19 33 Z" fill="${glassesColor}" fill-opacity="0.15"/><path d="M33 30 Q33 28 39 28 Q45 28 45 33 Q45 38 39 38 Q33 38 33 33 Z" fill="${glassesColor}" fill-opacity="0.15"/><line x1="31" y1="32" x2="33" y2="32"/><line x1="19" y1="31" x2="14" y2="29"/><line x1="45" y1="31" x2="50" y2="29"/></g>`;
     case 9:
-      return `<g><rect x="38" y="38" width="8" height="4" rx="1" fill="#f0d0a0" transform="rotate(-15 42 40)"/><line x1="40" y1="39" x2="40" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/><line x1="42" y1="39" x2="42" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/><line x1="44" y1="39" x2="44" y2="41" stroke="#c0a080" stroke-width="0.4" transform="rotate(-15 42 40)"/></g>`;
+      return `<g><rect x="38" y="38" width="9" height="4.5" rx="1.2" fill="#f0d0a0" transform="rotate(-15 42 40)"/><rect x="39.5" y="38.5" width="6" height="3.5" rx="0.8" fill="#f5ddb5" transform="rotate(-15 42 40)"/><circle cx="42.5" cy="40.25" r="0.5" fill="#d4b898" transform="rotate(-15 42 40)"/></g>`;
+    case 10:
+      return `<line x1="23" y1="24.8" x2="23.8" y2="29.2" stroke="${skinColor}" stroke-width="1.3" stroke-linecap="butt"/>`;
+    case 11:
+      return `<line x1="41" y1="24.8" x2="40.2" y2="29.2" stroke="${skinColor}" stroke-width="1.3" stroke-linecap="butt"/>`;
     default:
       return "";
   }
@@ -556,6 +756,8 @@ function renderSolFaceSVG(walletAddress, options) {
   const glassesColor = theme?.glassesColor ?? "#4a4a5a";
   const earringColor = theme?.earringColor ?? blend(skin, "#d4a840", 0.4);
   const headbandColor = theme?.headbandColor ?? blend(hairCol, "#c04040", 0.5);
+  const beautyMarkColor = theme?.beautyMarkColor ?? "#3a2a2a";
+  const freckleColor = theme?.freckleColor ?? "#a0785a";
   const id = "sf" + djb22(walletAddress).toString(36);
   const cheekEnabled = theme?.cheekEnabled ?? true;
   const cheekColor = theme?.cheekColor ?? derived.cheekColor;
@@ -563,7 +765,8 @@ function renderSolFaceSVG(walletAddress, options) {
   const hi = traits.hairStyle % 10;
   const ai = effectiveAccessory(traits);
   const classAttr = className ? ` class="${className}"` : "";
-  let svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="${size}" height="${size}"${classAttr}>`;
+  const altText = solFaceAltText(walletAddress).replace(/"/g, "&quot;");
+  let svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="${size}" height="${size}"${classAttr} role="img" aria-label="${altText}">`;
   const glowIntensity = theme?.glowIntensity ?? 0.1;
   svg += buildDefs(id, skin, derived.skinHi, derived.skinLo, hairCol, bgCol, cheekColor, cheekOpacity, flat, full && cheekEnabled, glowIntensity);
   const blinkEnabled = !!enableBlink;
@@ -576,29 +779,29 @@ function renderSolFaceSVG(walletAddress, options) {
   }
   const bgFill = flat ? bgCol : `url(#${id}bg)`;
   svg += `<rect x="0" y="0" width="64" height="64" fill="${bgFill}" opacity="${bgOpacity}" rx="${bgRadius}"/>`;
-  svg += renderHairBack(hi, id, flat);
-  svg += renderEars(derived.earFill, derived.earShadow);
+  if (theme?.hairEnabled !== false) svg += renderHairBack(hi, id, flat);
+  if (theme?.earsEnabled !== false) svg += renderEars(theme?.earColor ?? derived.earFill, derived.earShadow);
   const skinOpacity = theme?.skinOpacity ?? 1;
   svg += renderFace(id, skin, flat, skinOpacity);
   const shadowEnabled = theme?.shadowEnabled ?? true;
   if (full && cheekEnabled && shadowEnabled) {
     svg += renderFaceOverlays(id, flat);
   }
-  if (ai === 5) {
-    svg += renderAccessory(5, accColor, glassesColor, earringColor, headbandColor);
+  if (theme?.hairEnabled !== false) svg += renderHairFront(hi, id, hairCol, skin, flat);
+  if (ai === 5 && theme?.accessoriesEnabled !== false) {
+    svg += renderAccessory(5, accColor, glassesColor, earringColor, headbandColor, beautyMarkColor, freckleColor, skin);
   }
-  svg += renderHairFront(hi, id, hairCol, skin, flat);
   if (blinkEnabled) {
     const uid = `sf-${walletAddress.slice(0, 8)}`;
     svg += `<g class="${uid}-eyes">`;
   }
-  svg += renderEyes(traits.eyeStyle % 8, eyeCol, eyeWhite, derived.lidColor, full);
+  svg += renderEyes(traits.eyeStyle % 9, eyeCol, eyeWhite, theme?.lidColor ?? derived.lidColor, full);
   if (blinkEnabled) svg += `</g>`;
-  svg += renderEyebrows(traits.eyebrows % 5, browColor);
-  svg += renderNose(traits.nose % 4, noseFill);
+  if (theme?.eyebrowsEnabled !== false) svg += renderEyebrows(traits.eyebrows % 8, browColor, full);
+  if (theme?.noseEnabled !== false) svg += renderNose(traits.nose % 8, noseFill);
   svg += renderMouth(traits.mouth % 8, lipColor, derived.isDark);
-  if (ai !== 0 && ai !== 5) {
-    svg += renderAccessory(ai, accColor, glassesColor, earringColor, headbandColor);
+  if (ai !== 0 && ai !== 5 && theme?.accessoriesEnabled !== false) {
+    svg += renderAccessory(ai, accColor, glassesColor, earringColor, headbandColor, beautyMarkColor, freckleColor, skin);
   }
   if (theme?.border) {
     svg += `<rect x="0" y="0" width="64" height="64" fill="none" stroke="${theme.border.color}" stroke-width="${theme.border.width}" rx="${bgRadius}"/>`;
@@ -607,226 +810,6 @@ function renderSolFaceSVG(walletAddress, options) {
   return svg;
 }
 
-// src/core/describe.ts
-var SKIN_TONES = {
-  0: "porcelain",
-  1: "ivory",
-  2: "fair",
-  3: "light",
-  4: "sand",
-  5: "golden",
-  6: "warm",
-  7: "caramel",
-  8: "brown",
-  9: "deep"
-};
-var EYE_STYLES = {
-  0: "round, wide-open",
-  1: "small and minimal",
-  2: "almond-shaped",
-  3: "wide and expressive",
-  4: "relaxed, half-lidded",
-  5: "joyful, crescent-shaped",
-  6: "bright and sparkling",
-  7: "gentle and narrow"
-};
-var EYE_COLORS_DESC = {
-  0: "dark brown",
-  1: "blue",
-  2: "green",
-  3: "hazel",
-  4: "gray"
-};
-var EYEBROW_STYLES = {
-  0: "wispy",
-  1: "straight",
-  2: "natural",
-  3: "elegantly arched",
-  4: "sharply angled"
-};
-var NOSE_STYLES = {
-  0: "a subtle shadow nose",
-  1: "a small button nose",
-  2: "a soft curved nose",
-  3: "a button nose with visible nostrils"
-};
-var MOUTH_STYLES = {
-  0: "a gentle smile",
-  1: "a calm, neutral expression",
-  2: "a happy grin",
-  3: "a surprised O-shaped mouth",
-  4: "a confident smirk",
-  5: "a wide, toothy grin",
-  6: "a flat, straight expression",
-  7: "a soft pout"
-};
-var HAIR_STYLES = {
-  0: "bald, with no hair",
-  1: "short, neatly cropped hair",
-  2: "bouncy, curly hair",
-  3: "side-swept hair",
-  4: "a voluminous puff",
-  5: "long hair that falls past the shoulders",
-  6: "a clean bob cut",
-  7: "a close buzz cut",
-  8: "flowing, wavy hair",
-  9: "a neat topknot"
-};
-var HAIR_COLORS_DESC = {
-  0: "jet black",
-  1: "espresso brown",
-  2: "walnut",
-  3: "honey blonde",
-  4: "copper red",
-  5: "silver",
-  6: "charcoal",
-  7: "burgundy",
-  8: "strawberry",
-  9: "ginger"
-};
-var ACCESSORY_DESC = {
-  0: "",
-  1: "a beauty mark",
-  2: "round glasses",
-  3: "rectangular glasses",
-  4: "a dangling earring",
-  5: "a headband",
-  6: "freckles",
-  7: "stud earrings",
-  8: "aviator sunglasses",
-  9: "a band-aid"
-};
-var BG_COLORS_DESC = {
-  0: "rose",
-  1: "olive",
-  2: "sage",
-  3: "fern",
-  4: "mint",
-  5: "ocean",
-  6: "sky",
-  7: "lavender",
-  8: "orchid",
-  9: "blush"
-};
-function describeAppearance(walletAddress, options) {
-  const traits = generateTraits(walletAddress);
-  const {
-    includeBackground = true,
-    format = "paragraph",
-    perspective = "third",
-    name
-  } = options ?? {};
-  if (format === "structured") return buildStructured(traits, includeBackground);
-  if (format === "compact") return buildCompact(traits);
-  return buildParagraph(traits, perspective, name, includeBackground);
-}
-function buildParagraph(t, perspective, name, includeBg) {
-  const parts = [];
-  const ai = effectiveAccessory(t);
-  const subject = perspective === "first" ? name ? `I'm ${name}. I have` : "I have" : name ? `${name} has` : "This SolFace has";
-  const im = perspective === "first" ? "I'm" : "They're";
-  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
-  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? "round";
-  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? "dark";
-  parts.push(`${eyeStyle} ${eyeColor} eyes`);
-  const brows = EYEBROW_STYLES[t.eyebrows];
-  if (brows) parts.push(`${brows} eyebrows`);
-  const hairStyle = HAIR_STYLES[t.hairStyle] ?? "";
-  const hairColor = HAIR_COLORS_DESC[t.hairColor] ?? "";
-  if (t.hairStyle === 0) {
-    parts.push(perspective === "first" ? "and am bald" : "and is bald");
-  } else if (hairStyle.startsWith("a ")) {
-    parts.push(`and a ${hairColor} ${hairStyle.slice(2)}`);
-  } else {
-    parts.push(`and ${hairColor} ${hairStyle}`);
-  }
-  let desc = parts[0];
-  if (parts.length > 2) {
-    desc += ", " + parts.slice(1, -1).join(", ") + ", " + parts[parts.length - 1];
-  } else if (parts.length === 2) {
-    desc += " and " + parts[1];
-  }
-  desc += ".";
-  const nose = NOSE_STYLES[t.nose];
-  if (nose) {
-    const noseSubject = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
-    desc += ` ${noseSubject} ${nose}.`;
-  }
-  const acc = ACCESSORY_DESC[ai];
-  if (acc) {
-    desc += ` ${im} wearing ${acc}.`;
-  }
-  const mouth = MOUTH_STYLES[t.mouth] ?? "a smile";
-  const mouthVerb = perspective === "first" ? "I have" : (name ?? "They") + (name ? " has" : " have");
-  desc += ` ${mouthVerb} ${mouth}.`;
-  if (includeBg) {
-    const bg = BG_COLORS_DESC[t.bgColor] ?? "colorful";
-    desc += ` The background is ${bg}.`;
-  }
-  return desc;
-}
-function buildStructured(t, includeBg) {
-  const ai = effectiveAccessory(t);
-  const lines = [
-    `Face: squircle`,
-    `Skin: ${SKIN_TONES[t.skinColor] ?? "warm"}`,
-    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? "round"}, ${EYE_COLORS_DESC[t.eyeColor] ?? "dark"}`,
-    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? "wispy"}`
-  ];
-  const nose = NOSE_STYLES[t.nose];
-  if (nose) lines.push(`Nose: ${nose.replace(/^a /, "")}`);
-  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? "smile"}`);
-  if (t.hairStyle === 0) {
-    lines.push("Hair: bald");
-  } else {
-    const hs = HAIR_STYLES[t.hairStyle] ?? "";
-    const hc = HAIR_COLORS_DESC[t.hairColor] ?? "";
-    lines.push(`Hair: ${hc} ${hs.startsWith("a ") ? hs.slice(2) : hs}`);
-  }
-  const acc = ACCESSORY_DESC[ai];
-  if (acc) lines.push(`Accessory: ${acc}`);
-  if (includeBg) {
-    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? "colorful"}`);
-  }
-  return lines.join("\n");
-}
-function buildCompact(t) {
-  const ai = effectiveAccessory(t);
-  const parts = [];
-  parts.push(`squircle face`);
-  parts.push(`${SKIN_TONES[t.skinColor] ?? "warm"} skin`);
-  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? "dark"} ${EYE_STYLES[t.eyeStyle] ?? "round"} eyes`);
-  if (t.hairStyle === 0) {
-    parts.push("bald");
-  } else {
-    const raw = HAIR_STYLES[t.hairStyle] ?? "hair";
-    const hs = raw.includes(",") ? raw.replace(/.*,\s*/, "") : raw;
-    const hc = HAIR_COLORS_DESC[t.hairColor] ?? "";
-    parts.push(`${hc} ${hs.startsWith("a ") ? hs.slice(2) : hs}`);
-  }
-  const acc = ACCESSORY_DESC[ai];
-  if (acc) parts.push(acc);
-  parts.push((MOUTH_STYLES[t.mouth] ?? "smiling").replace(/^a /, ""));
-  return parts.join(", ");
-}
-function agentAppearancePrompt(walletAddress, agentName) {
-  const desc = describeAppearance(walletAddress, {
-    perspective: "first",
-    name: agentName,
-    includeBackground: false,
-    format: "paragraph"
-  });
-  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, "0");
-  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic \u2014 anyone who looks up my wallet will see the same face.`;
-}
-function djb2Simple(str) {
-  let hash = 5381;
-  for (let i = 0; i < str.length; i++) {
-    hash = (hash << 5) + hash + str.charCodeAt(i) | 0;
-  }
-  return hash >>> 0;
-}
-
 // src/names/sha256.ts
 var K = [
   1116352408,
@@ -3044,7 +3027,9 @@ var darkTheme = {
     "#18122a",
     "#1a2020",
     "#221822",
-    "#1e1020"
+    "#1e1020",
+    "#1c1228",
+    "#0e201a"
   ],
   eyeWhiteColor: "#d8d0c8",
   bgOpacity: 1,
@@ -3062,7 +3047,9 @@ var lightTheme = {
     "#e0e4f0",
     "#e0d8f0",
     "#f0e0ee",
-    "#f0d8e4"
+    "#f0d8e4",
+    "#e8d8f0",
+    "#d8f0e8"
   ],
   bgOpacity: 1,
   bgRadius: 8
@@ -3103,7 +3090,9 @@ var monoTheme = {
     "#d4d4e0",
     "#d4d0e0",
     "#e0d8e0",
-    "#e0d0d8"
+    "#e0d0d8",
+    "#d8d0e0",
+    "#d0e0d8"
   ],
   mouthColor: "#666",
   eyebrowColor: "#555",
@@ -3135,7 +3124,9 @@ var glassTheme = {
   _specularEnd: 50,
   _lightAngle: 135,
   _rimIntensity: 0.08,
-  _shadow: "0 8px 32px rgba(0,0,0,0.12)"
+  _shadowY: 8,
+  _shadowBlur: 32,
+  _shadowOpacity: 0.12
 };
 var glassDarkTheme = {
   bgOpacity: 0.2,
@@ -3153,7 +3144,9 @@ var glassDarkTheme = {
   _specularEnd: 40,
   _lightAngle: 135,
   _rimIntensity: 0.05,
-  _shadow: "0 8px 32px rgba(0,0,0,0.25)"
+  _shadowY: 8,
+  _shadowBlur: 32,
+  _shadowOpacity: 0.25
 };
 var pixelTheme = {
   flat: true,
@@ -3208,7 +3201,7 @@ function getPresetTheme(name, overrides) {
 // src/agent/tools.ts
 var generateSolfaceSvg = {
   name: "generate_solface_svg",
-  description: "Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string with gradient-rich rendering, skin-luminance-driven colors, and 10 accessory types. The same wallet always produces the same face. ~2.56 billion unique combinations.",
+  description: "Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string with gradient-rich rendering, skin-luminance-driven colors, and 12 accessory types. The same wallet always produces the same face. ~53 million unique combinations.",
   parameters: {
     type: "object",
     properties: {
@@ -3249,7 +3242,7 @@ var generateSolfaceSvg = {
 };
 var describeSolface = {
   name: "describe_solface",
-  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility. Describes squircle face, skin tone, eye style/color, hair, accessories, and expression.",
+  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility. Describes squircle face, skin tone, eye style/color, eyebrows, nose, accessories, and expression.",
   parameters: {
     type: "object",
     properties: {