solfaces 1.0.0

package/dist/agent/mcp-server.cjs

@@ -0,0 +1,836 @@
+#!/usr/bin/env node
+#!/usr/bin/env node
+"use strict";
+
+// src/core/traits.ts
+var SKIN_COLORS = [
+  "#ffd5b0",
+  "#f4c794",
+  "#e0a370",
+  "#c68642",
+  "#8d5524",
+  "#4a2c17"
+];
+var EYE_COLORS = [
+  "#3d2b1f",
+  // dark brown
+  "#4a80c4",
+  // blue
+  "#5a9a5a",
+  // green
+  "#c89430",
+  // amber
+  "#8a8a8a"
+  // gray
+];
+var HAIR_COLORS = [
+  "#1a1a1a",
+  // black
+  "#6b3a2a",
+  // brown
+  "#d4a844",
+  // blonde
+  "#c44a20",
+  // ginger
+  "#c8e64a",
+  // neon lime
+  "#6090e0",
+  // neon blue
+  "#14F195",
+  // neon mint
+  "#e040c0"
+  // neon magenta
+];
+var BG_COLORS = [
+  "#c8e64a",
+  "#6090e0",
+  "#14F195",
+  "#e8dcc8",
+  "#f85149"
+];
+function djb2(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) + hash + str.charCodeAt(i) | 0;
+  }
+  return hash >>> 0;
+}
+function mulberry32(seed) {
+  let s = seed | 0;
+  return () => {
+    s = s + 1831565813 | 0;
+    let t = Math.imul(s ^ s >>> 15, 1 | s);
+    t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
+}
+function generateTraits(walletAddress, overrides) {
+  const seed = djb2(walletAddress);
+  const rand = mulberry32(seed);
+  const traits = {
+    faceShape: Math.floor(rand() * 4),
+    skinColor: Math.floor(rand() * 6),
+    eyeStyle: Math.floor(rand() * 8),
+    eyeColor: Math.floor(rand() * 5),
+    eyebrows: Math.floor(rand() * 5),
+    nose: Math.floor(rand() * 4),
+    mouth: Math.floor(rand() * 6),
+    hairStyle: Math.floor(rand() * 8),
+    hairColor: Math.floor(rand() * 8),
+    accessory: Math.floor(rand() * 6),
+    bgColor: Math.floor(rand() * 5)
+  };
+  return overrides ? { ...traits, ...overrides } : traits;
+}
+var FACE_LABELS = ["Round", "Square", "Oval", "Hexagon"];
+var SKIN_LABELS = ["Light Peach", "Warm Tan", "Golden Brown", "Medium Brown", "Deep Brown", "Rich Dark Brown"];
+var EYE_STYLE_LABELS = ["Round", "Dots", "Almond", "Wide", "Sleepy", "Winking", "Lashes", "Narrow"];
+var EYE_COLOR_LABELS = ["Dark Brown", "Blue", "Green", "Amber", "Gray"];
+var BROW_LABELS = ["None", "Thin", "Thick", "Arched", "Angled"];
+var NOSE_LABELS = ["None", "Dot", "Triangle", "Button"];
+var MOUTH_LABELS = ["Smile", "Neutral", "Grin", "Open", "Smirk", "Wide Smile"];
+var HAIR_STYLE_LABELS = ["Bald", "Short", "Spiky", "Swept", "Mohawk", "Long", "Bob", "Buzz"];
+var HAIR_COLOR_LABELS = ["Black", "Brown", "Blonde", "Ginger", "Neon Lime", "Neon Blue", "Solana Mint", "Neon Magenta"];
+var ACCESSORY_LABELS = ["None", "None", "Round Glasses", "Square Glasses", "Earring", "Bandana"];
+var BG_COLOR_LABELS = ["Lime", "Blue", "Mint", "Sand", "Red"];
+function getTraitLabels(traits) {
+  return {
+    faceShape: FACE_LABELS[traits.faceShape] ?? "Round",
+    skinColor: SKIN_LABELS[traits.skinColor] ?? "Warm Tan",
+    eyeStyle: EYE_STYLE_LABELS[traits.eyeStyle] ?? "Round",
+    eyeColor: EYE_COLOR_LABELS[traits.eyeColor] ?? "Dark Brown",
+    eyebrows: BROW_LABELS[traits.eyebrows] ?? "None",
+    nose: NOSE_LABELS[traits.nose] ?? "None",
+    mouth: MOUTH_LABELS[traits.mouth] ?? "Smile",
+    hairStyle: HAIR_STYLE_LABELS[traits.hairStyle] ?? "Bald",
+    hairColor: HAIR_COLOR_LABELS[traits.hairColor] ?? "Black",
+    accessory: ACCESSORY_LABELS[traits.accessory] ?? "None",
+    bgColor: BG_COLOR_LABELS[traits.bgColor] ?? "Lime"
+  };
+}
+function traitHash(walletAddress) {
+  return (djb2(walletAddress) >>> 0).toString(16).padStart(8, "0");
+}
+
+// src/core/renderer.ts
+function renderFace(t, skin) {
+  if (t.faceShape === 0) return `<circle cx="32" cy="34" r="20" fill="${skin}"/>`;
+  if (t.faceShape === 1) return `<rect x="12" y="14" width="40" height="40" rx="8" ry="8" fill="${skin}"/>`;
+  if (t.faceShape === 2) return `<ellipse cx="32" cy="34" rx="18" ry="22" fill="${skin}"/>`;
+  if (t.faceShape === 3) return `<path d="M32 12 L50 24 L50 44 L32 56 L14 44 L14 24 Z" fill="${skin}" stroke-linejoin="round"/>`;
+  return `<circle cx="32" cy="34" r="20" fill="${skin}"/>`;
+}
+function renderEyes(t, c, w = "white") {
+  const l = 24, r = 40, y = 30;
+  switch (t.eyeStyle) {
+    case 0:
+      return `<circle cx="${l}" cy="${y}" r="3.5" fill="${w}"/><circle cx="${l + 1}" cy="${y}" r="2" fill="${c}"/><circle cx="${r}" cy="${y}" r="3.5" fill="${w}"/><circle cx="${r + 1}" cy="${y}" r="2" fill="${c}"/>`;
+    case 1:
+      return `<circle cx="${l}" cy="${y}" r="2" fill="${c}"/><circle cx="${r}" cy="${y}" r="2" fill="${c}"/>`;
+    case 2:
+      return `<ellipse cx="${l}" cy="${y}" rx="4" ry="2.5" fill="${w}"/><circle cx="${l + 0.5}" cy="${y}" r="1.5" fill="${c}"/><ellipse cx="${r}" cy="${y}" rx="4" ry="2.5" fill="${w}"/><circle cx="${r + 0.5}" cy="${y}" r="1.5" fill="${c}"/>`;
+    case 3:
+      return `<circle cx="${l}" cy="${y}" r="4.5" fill="${w}"/><circle cx="${l}" cy="${y + 0.5}" r="2.5" fill="${c}"/><circle cx="${r}" cy="${y}" r="4.5" fill="${w}"/><circle cx="${r}" cy="${y + 0.5}" r="2.5" fill="${c}"/>`;
+    case 4:
+      return `<ellipse cx="${l}" cy="${y + 1}" rx="3.5" ry="2" fill="${w}"/><circle cx="${l}" cy="${y + 1}" r="1.5" fill="${c}"/><line x1="${l - 4}" y1="${y - 0.5}" x2="${l + 4}" y2="${y - 0.5}" stroke="${c}" stroke-width="1" stroke-linecap="round"/><ellipse cx="${r}" cy="${y + 1}" rx="3.5" ry="2" fill="${w}"/><circle cx="${r}" cy="${y + 1}" r="1.5" fill="${c}"/><line x1="${r - 4}" y1="${y - 0.5}" x2="${r + 4}" y2="${y - 0.5}" stroke="${c}" stroke-width="1" stroke-linecap="round"/>`;
+    case 5:
+      return `<path d="M${l - 3} ${y} Q${l} ${y + 3} ${l + 3} ${y}" fill="none" stroke="${c}" stroke-width="1.5" stroke-linecap="round"/><circle cx="${r}" cy="${y}" r="3.5" fill="${w}"/><circle cx="${r + 1}" cy="${y}" r="2" fill="${c}"/>`;
+    case 6:
+      return `<circle cx="${l}" cy="${y}" r="3" fill="${w}"/><circle cx="${l + 0.5}" cy="${y}" r="1.5" fill="${c}"/><line x1="${l + 2}" y1="${y - 3}" x2="${l + 3.5}" y2="${y - 4.5}" stroke="${c}" stroke-width="0.8" stroke-linecap="round"/><line x1="${l + 3}" y1="${y - 2}" x2="${l + 4.5}" y2="${y - 3}" stroke="${c}" stroke-width="0.8" stroke-linecap="round"/><circle cx="${r}" cy="${y}" r="3" fill="${w}"/><circle cx="${r + 0.5}" cy="${y}" r="1.5" fill="${c}"/><line x1="${r + 2}" y1="${y - 3}" x2="${r + 3.5}" y2="${y - 4.5}" stroke="${c}" stroke-width="0.8" stroke-linecap="round"/><line x1="${r + 3}" y1="${y - 2}" x2="${r + 4.5}" y2="${y - 3}" stroke="${c}" stroke-width="0.8" stroke-linecap="round"/>`;
+    case 7:
+      return `<ellipse cx="${l}" cy="${y}" rx="4" ry="1.2" fill="${w}"/><ellipse cx="${l + 0.5}" cy="${y}" rx="2" ry="1" fill="${c}"/><ellipse cx="${r}" cy="${y}" rx="4" ry="1.2" fill="${w}"/><ellipse cx="${r + 0.5}" cy="${y}" rx="2" ry="1" fill="${c}"/>`;
+    default:
+      return `<circle cx="${l}" cy="${y}" r="3" fill="${w}"/><circle cx="${l + 1}" cy="${y}" r="2" fill="${c}"/><circle cx="${r}" cy="${y}" r="3" fill="${w}"/><circle cx="${r + 1}" cy="${y}" r="2" fill="${c}"/>`;
+  }
+}
+function renderEyebrows(t, col = "#2a2020") {
+  const l = 24, r = 40, y = 25;
+  switch (t.eyebrows) {
+    case 0:
+      return "";
+    case 1:
+      return `<line x1="${l - 3}" y1="${y}" x2="${l + 3}" y2="${y}" stroke="${col}" stroke-width="0.8" stroke-linecap="round"/><line x1="${r - 3}" y1="${y}" x2="${r + 3}" y2="${y}" stroke="${col}" stroke-width="0.8" stroke-linecap="round"/>`;
+    case 2:
+      return `<line x1="${l - 3.5}" y1="${y}" x2="${l + 3.5}" y2="${y}" stroke="${col}" stroke-width="2" stroke-linecap="round"/><line x1="${r - 3.5}" y1="${y}" x2="${r + 3.5}" y2="${y}" stroke="${col}" stroke-width="2" stroke-linecap="round"/>`;
+    case 3:
+      return `<path d="M${l - 3.5} ${y + 1} Q${l} ${y - 2} ${l + 3.5} ${y + 1}" fill="none" stroke="${col}" stroke-width="1" stroke-linecap="round"/><path d="M${r - 3.5} ${y + 1} Q${r} ${y - 2} ${r + 3.5} ${y + 1}" fill="none" stroke="${col}" stroke-width="1" stroke-linecap="round"/>`;
+    case 4:
+      return `<line x1="${l - 3}" y1="${y - 1}" x2="${l + 3}" y2="${y + 1}" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/><line x1="${r - 3}" y1="${y + 1}" x2="${r + 3}" y2="${y - 1}" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/>`;
+    default:
+      return "";
+  }
+}
+function renderNose(t, skin, noseCol) {
+  const cx = 32, y = 36;
+  const sh = noseCol ?? skin + "aa";
+  switch (t.nose) {
+    case 0:
+      return "";
+    case 1:
+      return `<circle cx="${cx}" cy="${y}" r="1.5" fill="${sh}"/>`;
+    case 2:
+      return `<path d="M${cx} ${y - 1.5} L${cx + 2.5} ${y + 2} L${cx - 2.5} ${y + 2} Z" fill="${sh}"/>`;
+    case 3:
+      return `<circle cx="${cx - 1.5}" cy="${y}" r="1" fill="${sh}"/><circle cx="${cx + 1.5}" cy="${y}" r="1" fill="${sh}"/>`;
+    default:
+      return "";
+  }
+}
+function renderMouth(t, col = "#c05050", teethCol = "white") {
+  const cx = 32, y = 42;
+  switch (t.mouth) {
+    case 0:
+      return `<path d="M${cx - 4} ${y} Q${cx} ${y + 4} ${cx + 4} ${y}" fill="none" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/>`;
+    case 1:
+      return `<line x1="${cx - 3}" y1="${y + 1}" x2="${cx + 3}" y2="${y + 1}" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/>`;
+    case 2:
+      return `<path d="M${cx - 6} ${y} Q${cx} ${y + 5} ${cx + 6} ${y}" fill="none" stroke="${col}" stroke-width="1.5" stroke-linecap="round"/>`;
+    case 3:
+      return `<ellipse cx="${cx}" cy="${y + 1}" rx="3" ry="2.5" fill="${col}" opacity="0.8"/>`;
+    case 4:
+      return `<path d="M${cx - 4} ${y + 1} Q${cx - 1} ${y + 1} ${cx + 4} ${y - 1}" fill="none" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/>`;
+    case 5:
+      return `<path d="M${cx - 6} ${y} Q${cx} ${y + 6} ${cx + 6} ${y}" fill="${teethCol}" stroke="${col}" stroke-width="1"/>`;
+    default:
+      return `<path d="M${cx - 4} ${y} Q${cx} ${y + 4} ${cx + 4} ${y}" fill="none" stroke="${col}" stroke-width="1.2" stroke-linecap="round"/>`;
+  }
+}
+function renderHair(t, col) {
+  switch (t.hairStyle) {
+    case 0:
+      return "";
+    // Bald
+    case 1:
+      return `<rect x="14" y="12" width="36" height="12" rx="6" ry="6" fill="${col}"/>`;
+    case 2:
+      return `<g fill="${col}"><rect x="14" y="16" width="36" height="8" rx="2"/><polygon points="18,16 22,6 26,16"/><polygon points="26,16 30,4 34,16"/><polygon points="34,16 38,6 42,16"/><polygon points="42,16 46,10 48,16"/></g>`;
+    case 3:
+      return `<g fill="${col}"><rect x="14" y="14" width="36" height="10" rx="4"/><path d="M14 18 Q8 14 10 8 Q14 10 20 14 Z"/></g>`;
+    case 4:
+      return `<rect x="26" y="4" width="12" height="20" rx="4" ry="2" fill="${col}"/>`;
+    case 5:
+      return `<g fill="${col}"><rect x="14" y="12" width="36" height="10" rx="4"/><rect x="10" y="18" width="8" height="24" rx="3"/><rect x="46" y="18" width="8" height="24" rx="3"/></g>`;
+    case 6:
+      return `<path d="M12 22 Q12 10 32 10 Q52 10 52 22 L52 38 Q52 42 48 42 L48 26 Q48 16 32 16 Q16 16 16 26 L16 42 Q12 42 12 38 Z" fill="${col}"/>`;
+    case 7:
+      return `<rect x="15" y="13" width="34" height="9" rx="8" ry="4" fill="${col}" opacity="0.7"/>`;
+    default:
+      return "";
+  }
+}
+function renderAccessory(t, col = "#444") {
+  if (t.accessory <= 1) return "";
+  if (t.accessory === 2) return `<g fill="none" stroke="${col}" stroke-width="1"><circle cx="24" cy="30" r="5"/><circle cx="40" cy="30" r="5"/><line x1="29" y1="30" x2="35" y2="30"/><line x1="19" y1="30" x2="14" y2="28"/><line x1="45" y1="30" x2="50" y2="28"/></g>`;
+  if (t.accessory === 3) return `<g fill="none" stroke="${col}" stroke-width="1"><rect x="19" y="26" width="10" height="8" rx="1"/><rect x="35" y="26" width="10" height="8" rx="1"/><line x1="29" y1="30" x2="35" y2="30"/><line x1="19" y1="30" x2="14" y2="28"/><line x1="45" y1="30" x2="50" y2="28"/></g>`;
+  if (t.accessory === 4) return `<circle cx="11" cy="36" r="2" fill="${col}" stroke="${col}" stroke-width="0.5"/>`;
+  if (t.accessory === 5) return `<g><rect x="12" y="20" width="40" height="4" rx="1" fill="${col}"/><path d="M12 22 L8 26 L12 24 Z" fill="${col}"/></g>`;
+  return "";
+}
+function renderSolFaceSVG(walletAddress, options) {
+  const { size = 64, theme, traitOverrides, enableBlink, className, colorOverrides } = options ?? {};
+  const traits = generateTraits(walletAddress, traitOverrides);
+  const skinColors = theme?.skinColors ?? SKIN_COLORS;
+  const eyeColors = theme?.eyeColors ?? EYE_COLORS;
+  const hairColors = theme?.hairColors ?? HAIR_COLORS;
+  const bgColors = theme?.bgColors ?? BG_COLORS;
+  const skin = colorOverrides?.skin ?? skinColors[traits.skinColor % skinColors.length];
+  const eyeCol = colorOverrides?.eyes ?? eyeColors[traits.eyeColor % eyeColors.length];
+  const hairCol = colorOverrides?.hair ?? hairColors[traits.hairColor % hairColors.length];
+  const bgCol = colorOverrides?.bg ?? bgColors[traits.bgColor % bgColors.length];
+  const bgOpacity = theme?.bgOpacity ?? 0.15;
+  const bgRadius = theme?.bgRadius ?? 4;
+  const mouthCol = colorOverrides?.mouth ?? theme?.mouthColor ?? "#c05050";
+  const browCol = colorOverrides?.eyebrow ?? theme?.eyebrowColor ?? "#2a2020";
+  const accCol = colorOverrides?.accessory ?? theme?.accessoryColor ?? "#444";
+  const eyeWhite = colorOverrides?.eyeWhite ?? theme?.eyeWhiteColor ?? "white";
+  const noseCol = colorOverrides?.nose ?? theme?.noseColor;
+  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}>`;
+  svg += `<rect x="0" y="0" width="64" height="64" fill="${bgCol}" opacity="${bgOpacity}" rx="${bgRadius}"/>`;
+  const blinkEnabled = !!enableBlink;
+  const blinkDuration = typeof enableBlink === "object" ? enableBlink.duration ?? 4 : 4;
+  const blinkDelay = typeof enableBlink === "object" ? enableBlink.delay ?? 0 : 0;
+  if (blinkEnabled) {
+    const uid = `sf-${walletAddress.slice(0, 8)}`;
+    const delayStr = blinkDelay ? ` ${blinkDelay}s` : "";
+    svg += `<style>@keyframes ${uid}-blink{0%,90%,100%{transform:scaleY(1)}95%{transform:scaleY(0.1)}}.${uid}-eyes{animation:${uid}-blink ${blinkDuration}s ease-in-out${delayStr} infinite;transform-origin:32px 30px}</style>`;
+  }
+  svg += renderHair(traits, hairCol);
+  svg += renderFace(traits, skin);
+  if (blinkEnabled) {
+    const uid = `sf-${walletAddress.slice(0, 8)}`;
+    svg += `<g class="${uid}-eyes">`;
+  }
+  svg += renderEyes(traits, eyeCol, eyeWhite);
+  if (blinkEnabled) svg += `</g>`;
+  svg += renderEyebrows(traits, browCol);
+  svg += renderNose(traits, skin, noseCol);
+  svg += renderMouth(traits, mouthCol, eyeWhite);
+  svg += renderAccessory(traits, accCol);
+  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}"/>`;
+  }
+  svg += `</svg>`;
+  return svg;
+}
+
+// src/core/describe.ts
+var FACE_SHAPES = {
+  0: "round",
+  1: "square with softly rounded corners",
+  2: "oval",
+  3: "angular, hexagonal"
+};
+var SKIN_TONES = {
+  0: "light peach",
+  1: "warm tan",
+  2: "golden brown",
+  3: "medium brown",
+  4: "deep brown",
+  5: "rich dark brown"
+};
+var EYE_STYLES = {
+  0: "round, wide-open",
+  1: "small and dot-like",
+  2: "almond-shaped",
+  3: "wide and expressive",
+  4: "sleepy, half-lidded",
+  5: "playfully winking",
+  6: "adorned with lashes",
+  7: "narrow and observant"
+};
+var EYE_COLORS_DESC = {
+  0: "dark brown",
+  1: "blue",
+  2: "green",
+  3: "amber",
+  4: "gray"
+};
+var EYEBROW_STYLES = {
+  0: "",
+  // none — omitted from description
+  1: "thin",
+  2: "thick, prominent",
+  3: "elegantly arched",
+  4: "sharply angled"
+};
+var NOSE_STYLES = {
+  0: "",
+  // none
+  1: "a small dot nose",
+  2: "a triangular nose",
+  3: "a button nose with visible nostrils"
+};
+var MOUTH_STYLES = {
+  0: "a gentle smile",
+  1: "a neutral, straight expression",
+  2: "a wide grin",
+  3: "a small, open mouth",
+  4: "a confident smirk",
+  5: "a broad, toothy smile"
+};
+var HAIR_STYLES = {
+  0: "bald, with no hair",
+  1: "short, neatly cropped hair",
+  2: "tall, spiky hair",
+  3: "side-swept hair",
+  4: "a bold mohawk",
+  5: "long hair that falls past the shoulders",
+  6: "a clean bob cut",
+  7: "a close buzz cut"
+};
+var HAIR_COLORS_DESC = {
+  0: "jet black",
+  1: "brown",
+  2: "blonde",
+  3: "ginger red",
+  4: "neon lime green",
+  5: "neon blue",
+  6: "Solana mint green",
+  7: "neon magenta"
+};
+var ACCESSORY_DESC = {
+  0: "",
+  1: "",
+  2: "round glasses",
+  3: "square-framed glasses",
+  4: "a gold earring",
+  5: "a red bandana"
+};
+var BG_COLORS_DESC = {
+  0: "lime green",
+  1: "blue",
+  2: "Solana mint green",
+  3: "warm sand",
+  4: "red"
+};
+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 subject = perspective === "first" ? name ? `I'm ${name}. I have` : "I have" : name ? `${name} has` : "This SolFace has";
+  const have = perspective === "first" ? "have" : "has";
+  const my = perspective === "first" ? "my" : "their";
+  const im = perspective === "first" ? "I'm" : "They're";
+  parts.push(`${subject} a ${FACE_SHAPES[t.faceShape] ?? "round"} 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("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[t.accessory];
+  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 lines = [
+    `Face: ${FACE_SHAPES[t.faceShape] ?? "round"}`,
+    `Skin: ${SKIN_TONES[t.skinColor] ?? "warm"}`,
+    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? "round"}, ${EYE_COLORS_DESC[t.eyeColor] ?? "dark"}`
+  ];
+  const brows = EYEBROW_STYLES[t.eyebrows];
+  if (brows) lines.push(`Eyebrows: ${brows}`);
+  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[t.accessory];
+  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 parts = [];
+  parts.push(`${FACE_SHAPES[t.faceShape] ?? "round"} 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 hs = (HAIR_STYLES[t.hairStyle] ?? "hair").replace(/,.*/, "");
+    const hc = HAIR_COLORS_DESC[t.hairColor] ?? "";
+    parts.push(`${hc} ${hs.startsWith("a ") ? hs.slice(2) : hs}`);
+  }
+  const acc = ACCESSORY_DESC[t.accessory];
+  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/themes/presets.ts
+var solanaTheme = {
+  bgColors: ["#14F195", "#9945FF", "#00C2FF", "#FFD700", "#FF6B6B"],
+  bgOpacity: 0.2,
+  bgRadius: 4
+};
+var darkTheme = {
+  bgColors: ["#1a1b23", "#2d1b69", "#0a2463", "#1b2838", "#2a0a3a"],
+  mouthColor: "#e06070",
+  eyebrowColor: "#aaa",
+  accessoryColor: "#888",
+  eyeWhiteColor: "#e0e0e0",
+  bgOpacity: 1,
+  bgRadius: 4
+};
+var lightTheme = {
+  bgColors: ["#f0f4ff", "#fff0f5", "#f0fff0", "#fffff0", "#f5f0ff"],
+  bgOpacity: 1,
+  bgRadius: 8
+};
+var monoTheme = {
+  skinColors: ["#e0e0e0", "#c0c0c0", "#a0a0a0", "#808080", "#606060", "#404040"],
+  eyeColors: ["#333", "#555", "#777", "#999", "#bbb"],
+  hairColors: ["#1a1a1a", "#333", "#555", "#777", "#999", "#bbb", "#ddd", "#eee"],
+  bgColors: ["#f0f0f0", "#e0e0e0", "#d0d0d0", "#c0c0c0", "#b0b0b0"],
+  mouthColor: "#666",
+  eyebrowColor: "#555",
+  accessoryColor: "#777",
+  eyeWhiteColor: "#f0f0f0",
+  bgOpacity: 0.3,
+  bgRadius: 4
+};
+var neonTheme = {
+  bgColors: ["#0d0d0d", "#1a0a2e", "#0a1628", "#0d1a0d", "#1a0a0a"],
+  hairColors: ["#ff00ff", "#00ffff", "#ff6600", "#39ff14", "#ff3366", "#6600ff", "#ffff00", "#00ff99"],
+  eyeColors: ["#ff00ff", "#00ffff", "#39ff14", "#ff6600", "#ffff00"],
+  mouthColor: "#ff3366",
+  eyebrowColor: "#ccc",
+  accessoryColor: "#00ffff",
+  eyeWhiteColor: "#1a1a1a",
+  bgOpacity: 1,
+  bgRadius: 4,
+  border: { color: "#39ff14", width: 1 }
+};
+var jupiterTheme = {
+  bgColors: ["#131b2e", "#1b2540", "#0f1926", "#1e2d4a", "#162033"],
+  mouthColor: "#c7d4e8",
+  eyebrowColor: "#8899aa",
+  accessoryColor: "#6882a0",
+  eyeWhiteColor: "#d0d8e8",
+  bgOpacity: 1,
+  bgRadius: 6,
+  border: { color: "#3a5a8c", width: 0.5 }
+};
+var phantomTheme = {
+  bgColors: ["#1c0e30", "#2a1548", "#1e0f36", "#251240", "#20103a"],
+  mouthColor: "#d4a0e8",
+  eyebrowColor: "#9966cc",
+  accessoryColor: "#ab8dd6",
+  eyeWhiteColor: "#d8c8e8",
+  bgOpacity: 1,
+  bgRadius: 6,
+  border: { color: "#ab8dd6", width: 0.5 }
+};
+var circleTheme = {
+  bgRadius: 999
+};
+var PRESET_THEMES = {
+  solana: solanaTheme,
+  dark: darkTheme,
+  light: lightTheme,
+  mono: monoTheme,
+  neon: neonTheme,
+  jupiter: jupiterTheme,
+  phantom: phantomTheme,
+  circle: circleTheme
+};
+function getPresetTheme(name, overrides) {
+  const base = PRESET_THEMES[name];
+  if (!base) return overrides ?? {};
+  return overrides ? { ...base, ...overrides } : base;
+}
+
+// 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 that can be embedded in HTML, saved as a file, or converted to a data URI. The same wallet always produces the same face.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      size: {
+        type: "number",
+        description: "SVG width/height in pixels. Default: 64"
+      },
+      theme: {
+        type: "string",
+        description: "Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle",
+        enum: ["solana", "dark", "light", "mono", "neon", "jupiter", "phantom", "circle"]
+      },
+      enableBlink: {
+        type: "boolean",
+        description: "Enable CSS blink animation on the eyes. Default: false"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const size = params.size ?? 64;
+    const enableBlink = params.enableBlink ?? false;
+    const themeName = params.theme;
+    const theme = themeName ? getPresetTheme(themeName) : void 0;
+    return renderSolFaceSVG(wallet, { size, theme, enableBlink });
+  }
+};
+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.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      format: {
+        type: "string",
+        description: "Output format: paragraph (flowing text), structured (labeled lines), compact (short comma-separated). Default: paragraph",
+        enum: ["paragraph", "structured", "compact"]
+      },
+      perspective: {
+        type: "string",
+        description: 'Narrative perspective: "first" for self-description ("I have..."), "third" for external ("This SolFace has..."). Default: third',
+        enum: ["first", "third"]
+      },
+      name: {
+        type: "string",
+        description: 'Optional name to use instead of "This SolFace" or "I". E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return describeAppearance(params.wallet, {
+      format: params.format ?? "paragraph",
+      perspective: params.perspective ?? "third",
+      name: params.name
+    });
+  }
+};
+var getSolfaceTraits = {
+  name: "get_solface_traits",
+  description: "Get the raw numeric trait values, human-readable labels, and deterministic hash for a wallet's SolFace avatar. Returns structured data useful for programmatic decisions about appearance.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const traits = generateTraits(wallet);
+    const labels = getTraitLabels(traits);
+    const hash = traitHash(wallet);
+    return { traits, labels, hash };
+  }
+};
+var getAgentIdentity = {
+  name: "get_agent_identity",
+  description: "Generate a system prompt snippet that gives an AI agent a visual identity based on its Solana wallet. The snippet describes the agent's appearance in first person and explains the deterministic nature of SolFace avatars.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "The agent's Solana wallet address (base58 public key)"
+      },
+      agentName: {
+        type: "string",
+        description: 'Optional agent name to personalize the description. E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return agentAppearancePrompt(
+      params.wallet,
+      params.agentName
+    );
+  }
+};
+var THEME_DESCRIPTIONS = {
+  solana: "Vibrant Solana brand colors (#14F195, #9945FF)",
+  dark: "Dark backgrounds with muted tones",
+  light: "Soft pastel backgrounds",
+  mono: "Full grayscale \u2014 all colors replaced with grays",
+  neon: "Cyberpunk high-contrast with neon accents and green border",
+  jupiter: "Jupiter aggregator dark blue palette with subtle border",
+  phantom: "Phantom wallet purple tones with subtle border",
+  circle: "Full circular border-radius (999px) for round avatars"
+};
+var listSolfaceThemes = {
+  name: "list_solface_themes",
+  description: "List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
+  handler() {
+    return Object.keys(PRESET_THEMES).map((name) => ({
+      name,
+      description: THEME_DESCRIPTIONS[name] ?? ""
+    }));
+  }
+};
+var SOLFACE_TOOLS = [
+  generateSolfaceSvg,
+  describeSolface,
+  getSolfaceTraits,
+  getAgentIdentity,
+  listSolfaceThemes
+];
+
+// src/agent/mcp-server.ts
+function send(response) {
+  const json = JSON.stringify(response);
+  const msg = `Content-Length: ${Buffer.byteLength(json)}\r
+\r
+${json}`;
+  process.stdout.write(msg);
+}
+function handleRequest(req) {
+  const { id, method, params } = req;
+  if (method === "initialize") {
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: {
+          name: "solfaces",
+          version: "1.0.0"
+        }
+      }
+    };
+  }
+  if (method === "notifications/initialized") {
+    return null;
+  }
+  if (method === "tools/list") {
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: {
+        tools: SOLFACE_TOOLS.map((t) => ({
+          name: t.name,
+          description: t.description,
+          inputSchema: t.parameters
+        }))
+      }
+    };
+  }
+  if (method === "tools/call") {
+    const p = params;
+    if (!p || typeof p.name !== "string") {
+      return {
+        jsonrpc: "2.0",
+        id,
+        error: { code: -32602, message: "Missing required 'name' parameter in tools/call" }
+      };
+    }
+    const toolName = p.name;
+    const toolArgs = p.arguments ?? {};
+    const tool = SOLFACE_TOOLS.find((t) => t.name === toolName);
+    if (!tool) {
+      return {
+        jsonrpc: "2.0",
+        id,
+        error: { code: -32601, message: `Unknown tool: ${toolName}` }
+      };
+    }
+    try {
+      const result = tool.handler(toolArgs);
+      const text = typeof result === "string" ? result : JSON.stringify(result, null, 2);
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: {
+          content: [{ type: "text", text }]
+        }
+      };
+    } catch (err) {
+      return {
+        jsonrpc: "2.0",
+        id,
+        error: {
+          code: -32603,
+          message: err instanceof Error ? err.message : String(err)
+        }
+      };
+    }
+  }
+  return {
+    jsonrpc: "2.0",
+    id,
+    error: { code: -32601, message: `Method not found: ${method}` }
+  };
+}
+var buffer = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+  buffer += chunk;
+  while (true) {
+    const headerEnd = buffer.indexOf("\r\n\r\n");
+    if (headerEnd === -1) break;
+    const header = buffer.slice(0, headerEnd);
+    const match = header.match(/Content-Length:\s*(\d+)/i);
+    if (!match) {
+      buffer = buffer.slice(headerEnd + 4);
+      continue;
+    }
+    const contentLength = parseInt(match[1], 10);
+    const bodyStart = headerEnd + 4;
+    if (buffer.length < bodyStart + contentLength) break;
+    const body = buffer.slice(bodyStart, bodyStart + contentLength);
+    buffer = buffer.slice(bodyStart + contentLength);
+    try {
+      const req = JSON.parse(body);
+      const res = handleRequest(req);
+      if (res && req.id !== void 0) {
+        send(res);
+      }
+    } catch {
+    }
+  }
+});
+process.stderr.write("SolFaces MCP server started\n");