solfaces 1.0.2 → 2.1.0

package/dist/chunk-CQWXUU7P.js

@@ -0,0 +1,239 @@
+import { generateTraits, effectiveAccessory } from './chunk-SWML743U.js';
+
+// 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 describeTraits(traits, options) {
+  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 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;
+}
+
+export { agentAppearancePrompt, describeAppearance, describeTraits, solFaceAltText };
+//# sourceMappingURL=chunk-CQWXUU7P.js.map
+//# sourceMappingURL=chunk-CQWXUU7P.js.map

package/dist/chunk-CQWXUU7P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/describe.ts"],"names":[],"mappings":"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","file":"chunk-CQWXUU7P.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — AI Agent Description Generator\n// Produces natural language descriptions of a wallet's SolFace\n// for use in system prompts, bios, and self-reference.\n// ═══════════════════════════════════════════════════════════════\n\nimport { generateTraits, effectiveAccessory, type SolFaceTraits } from \"./traits\";\n\n// ─── Vocabulary Maps ─────────────────────────────────────────\n\nconst SKIN_TONES: Record<number, string> = {\n  0: \"porcelain\",\n  1: \"ivory\",\n  2: \"fair\",\n  3: \"light\",\n  4: \"sand\",\n  5: \"golden\",\n  6: \"warm\",\n  7: \"caramel\",\n  8: \"brown\",\n  9: \"deep\",\n};\n\nconst EYE_STYLES: Record<number, string> = {\n  0: \"round, wide-open\",\n  1: \"small and minimal\",\n  2: \"almond-shaped\",\n  3: \"wide and expressive\",\n  4: \"relaxed, half-lidded\",\n  5: \"joyful, crescent-shaped\",\n  6: \"bright and sparkling\",\n  7: \"gentle and narrow\",\n};\n\nconst EYE_COLORS_DESC: Record<number, string> = {\n  0: \"dark brown\",\n  1: \"blue\",\n  2: \"green\",\n  3: \"hazel\",\n  4: \"gray\",\n};\n\nconst EYEBROW_STYLES: Record<number, string> = {\n  0: \"wispy\",\n  1: \"straight\",\n  2: \"natural\",\n  3: \"elegantly arched\",\n  4: \"sharply angled\",\n};\n\nconst NOSE_STYLES: Record<number, string> = {\n  0: \"a subtle shadow nose\",\n  1: \"a small button nose\",\n  2: \"a soft curved nose\",\n  3: \"a button nose with visible nostrils\",\n};\n\nconst MOUTH_STYLES: Record<number, string> = {\n  0: \"a gentle smile\",\n  1: \"a calm, neutral expression\",\n  2: \"a happy grin\",\n  3: \"a surprised O-shaped mouth\",\n  4: \"a confident smirk\",\n  5: \"a wide, toothy grin\",\n  6: \"a flat, straight expression\",\n  7: \"a soft pout\",\n};\n\nconst HAIR_STYLES: Record<number, string> = {\n  0: \"bald, with no hair\",\n  1: \"short, neatly cropped hair\",\n  2: \"bouncy, curly hair\",\n  3: \"side-swept hair\",\n  4: \"a voluminous puff\",\n  5: \"long hair that falls past the shoulders\",\n  6: \"a clean bob cut\",\n  7: \"a close buzz cut\",\n  8: \"flowing, wavy hair\",\n  9: \"a neat topknot\",\n};\n\nconst HAIR_COLORS_DESC: Record<number, string> = {\n  0: \"jet black\",\n  1: \"espresso brown\",\n  2: \"walnut\",\n  3: \"honey blonde\",\n  4: \"copper red\",\n  5: \"silver\",\n  6: \"charcoal\",\n  7: \"burgundy\",\n  8: \"strawberry\",\n  9: \"ginger\",\n};\n\nconst ACCESSORY_DESC: Record<number, string> = {\n  0: \"\",\n  1: \"a beauty mark\",\n  2: \"round glasses\",\n  3: \"rectangular glasses\",\n  4: \"a dangling earring\",\n  5: \"a headband\",\n  6: \"freckles\",\n  7: \"stud earrings\",\n  8: \"aviator sunglasses\",\n  9: \"a band-aid\",\n};\n\nconst BG_COLORS_DESC: Record<number, string> = {\n  0: \"rose\",\n  1: \"olive\",\n  2: \"sage\",\n  3: \"fern\",\n  4: \"mint\",\n  5: \"ocean\",\n  6: \"sky\",\n  7: \"lavender\",\n  8: \"orchid\",\n  9: \"blush\",\n};\n\n// ─── Description Builder ─────────────────────────────────────\n\nexport interface DescribeOptions {\n  includeBackground?: boolean;\n  format?: \"paragraph\" | \"structured\" | \"compact\";\n  perspective?: \"first\" | \"third\";\n  name?: string;\n}\n\nexport function describeAppearance(\n  walletAddress: string,\n  options?: DescribeOptions,\n): string {\n  const traits = generateTraits(walletAddress);\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\nexport function describeTraits(\n  traits: SolFaceTraits,\n  options?: DescribeOptions,\n): string {\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\n// ─── Builders ────────────────────────────────────────────────\n\nfunction buildParagraph(\n  t: SolFaceTraits,\n  perspective: \"first\" | \"third\",\n  name?: string,\n  includeBg?: boolean,\n): string {\n  const parts: string[] = [];\n  const ai = effectiveAccessory(t);\n\n  const subject = perspective === \"first\"\n    ? (name ? `I'm ${name}. I have` : \"I have\")\n    : (name ? `${name} has` : \"This SolFace has\");\n\n  const im = perspective === \"first\" ? \"I'm\" : \"They're\";\n\n  // Face + skin (all squircle now)\n  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n\n  // Eyes\n  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? \"round\";\n  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? \"dark\";\n  parts.push(`${eyeStyle} ${eyeColor} eyes`);\n\n  // Eyebrows\n  const brows = EYEBROW_STYLES[t.eyebrows];\n  if (brows) parts.push(`${brows} eyebrows`);\n\n  // Hair\n  const hairStyle = HAIR_STYLES[t.hairStyle] ?? \"\";\n  const hairColor = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n  if (t.hairStyle === 0) {\n    parts.push(perspective === \"first\" ? \"and am bald\" : \"and is bald\");\n  } else if (hairStyle.startsWith(\"a \")) {\n    parts.push(`and a ${hairColor} ${hairStyle.slice(2)}`);\n  } else {\n    parts.push(`and ${hairColor} ${hairStyle}`);\n  }\n\n  // Build main sentence\n  let desc = parts[0];\n  if (parts.length > 2) {\n    desc += \", \" + parts.slice(1, -1).join(\", \") + \", \" + parts[parts.length - 1];\n  } else if (parts.length === 2) {\n    desc += \" and \" + parts[1];\n  }\n  desc += \".\";\n\n  // Nose\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) {\n    const noseSubject = perspective === \"first\"\n      ? \"I have\"\n      : (name ?? \"They\") + (name ? \" has\" : \" have\");\n    desc += ` ${noseSubject} ${nose}.`;\n  }\n\n  // Accessory\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) {\n    desc += ` ${im} wearing ${acc}.`;\n  }\n\n  // Mouth\n  const mouth = MOUTH_STYLES[t.mouth] ?? \"a smile\";\n  const mouthVerb = perspective === \"first\"\n    ? \"I have\"\n    : (name ?? \"They\") + (name ? \" has\" : \" have\");\n  desc += ` ${mouthVerb} ${mouth}.`;\n\n  // Background\n  if (includeBg) {\n    const bg = BG_COLORS_DESC[t.bgColor] ?? \"colorful\";\n    desc += ` The background is ${bg}.`;\n  }\n\n  return desc;\n}\n\nfunction buildStructured(t: SolFaceTraits, includeBg: boolean): string {\n  const ai = effectiveAccessory(t);\n  const lines: string[] = [\n    `Face: squircle`,\n    `Skin: ${SKIN_TONES[t.skinColor] ?? \"warm\"}`,\n    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? \"round\"}, ${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"}`,\n    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? \"wispy\"}`,\n  ];\n\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) lines.push(`Nose: ${nose.replace(/^a /, \"\")}`);\n\n  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? \"smile\"}`);\n\n  if (t.hairStyle === 0) {\n    lines.push(\"Hair: bald\");\n  } else {\n    const hs = HAIR_STYLES[t.hairStyle] ?? \"\";\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    lines.push(`Hair: ${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) lines.push(`Accessory: ${acc}`);\n\n  if (includeBg) {\n    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? \"colorful\"}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction buildCompact(t: SolFaceTraits): string {\n  const ai = effectiveAccessory(t);\n  const parts: string[] = [];\n\n  parts.push(`squircle face`);\n  parts.push(`${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"} ${EYE_STYLES[t.eyeStyle] ?? \"round\"} eyes`);\n\n  if (t.hairStyle === 0) {\n    parts.push(\"bald\");\n  } else {\n    const raw = HAIR_STYLES[t.hairStyle] ?? \"hair\";\n    const hs = raw.includes(\",\") ? raw.replace(/.*,\\s*/, \"\") : raw;\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    parts.push(`${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) parts.push(acc);\n\n  parts.push((MOUTH_STYLES[t.mouth] ?? \"smiling\").replace(/^a /, \"\"));\n\n  return parts.join(\", \");\n}\n\n// ─── Alt Text Helper ─────────────────────────────────────────\n\nexport function solFaceAltText(walletAddress: string): string {\n  return `SolFace avatar: ${describeAppearance(walletAddress, { format: \"compact\", includeBackground: false })}`;\n}\n\n// ─── System Prompt Helper ────────────────────────────────────\n\nexport function agentAppearancePrompt(\n  walletAddress: string,\n  agentName?: string,\n): string {\n  const desc = describeAppearance(walletAddress, {\n    perspective: \"first\",\n    name: agentName,\n    includeBackground: false,\n    format: \"paragraph\",\n  });\n\n  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, \"0\");\n\n  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic — anyone who looks up my wallet will see the same face.`;\n}\n\n// Inline djb2 to avoid circular dependency\nfunction djb2Simple(str: string): number {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash + str.charCodeAt(i)) | 0;\n  }\n  return hash >>> 0;\n}\n"]}

package/dist/chunk-CXRVPOTI.cjs

@@ -0,0 +1,244 @@
+'use strict';
+
+var chunkHVPGR6G5_cjs = require('./chunk-HVPGR6G5.cjs');
+
+// 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 = chunkHVPGR6G5_cjs.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 describeTraits(traits, options) {
+  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 = chunkHVPGR6G5_cjs.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 = chunkHVPGR6G5_cjs.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 = chunkHVPGR6G5_cjs.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 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;
+}
+
+exports.agentAppearancePrompt = agentAppearancePrompt;
+exports.describeAppearance = describeAppearance;
+exports.describeTraits = describeTraits;
+exports.solFaceAltText = solFaceAltText;
+//# sourceMappingURL=chunk-CXRVPOTI.cjs.map
+//# sourceMappingURL=chunk-CXRVPOTI.cjs.map

package/dist/chunk-CXRVPOTI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/describe.ts"],"names":["generateTraits","effectiveAccessory"],"mappings":";;;;;AAUA,IAAM,UAAA,GAAqC;AAAA,EACzC,CAAA,EAAG,WAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,QAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,SAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,UAAA,GAAqC;AAAA,EACzC,CAAA,EAAG,kBAAA;AAAA,EACH,CAAA,EAAG,mBAAA;AAAA,EACH,CAAA,EAAG,eAAA;AAAA,EACH,CAAA,EAAG,qBAAA;AAAA,EACH,CAAA,EAAG,sBAAA;AAAA,EACH,CAAA,EAAG,yBAAA;AAAA,EACH,CAAA,EAAG,sBAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,eAAA,GAA0C;AAAA,EAC9C,CAAA,EAAG,YAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,cAAA,GAAyC;AAAA,EAC7C,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,UAAA;AAAA,EACH,CAAA,EAAG,SAAA;AAAA,EACH,CAAA,EAAG,kBAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,WAAA,GAAsC;AAAA,EAC1C,CAAA,EAAG,sBAAA;AAAA,EACH,CAAA,EAAG,qBAAA;AAAA,EACH,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,YAAA,GAAuC;AAAA,EAC3C,CAAA,EAAG,gBAAA;AAAA,EACH,CAAA,EAAG,4BAAA;AAAA,EACH,CAAA,EAAG,cAAA;AAAA,EACH,CAAA,EAAG,4BAAA;AAAA,EACH,CAAA,EAAG,mBAAA;AAAA,EACH,CAAA,EAAG,qBAAA;AAAA,EACH,CAAA,EAAG,6BAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,WAAA,GAAsC;AAAA,EAC1C,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG,4BAAA;AAAA,EACH,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG,iBAAA;AAAA,EACH,CAAA,EAAG,mBAAA;AAAA,EACH,CAAA,EAAG,yCAAA;AAAA,EACH,CAAA,EAAG,iBAAA;AAAA,EACH,CAAA,EAAG,kBAAA;AAAA,EACH,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,gBAAA,GAA2C;AAAA,EAC/C,CAAA,EAAG,WAAA;AAAA,EACH,CAAA,EAAG,gBAAA;AAAA,EACH,CAAA,EAAG,QAAA;AAAA,EACH,CAAA,EAAG,cAAA;AAAA,EACH,CAAA,EAAG,YAAA;AAAA,EACH,CAAA,EAAG,QAAA;AAAA,EACH,CAAA,EAAG,UAAA;AAAA,EACH,CAAA,EAAG,UAAA;AAAA,EACH,CAAA,EAAG,YAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,cAAA,GAAyC;AAAA,EAC7C,CAAA,EAAG,EAAA;AAAA,EACH,CAAA,EAAG,eAAA;AAAA,EACH,CAAA,EAAG,eAAA;AAAA,EACH,CAAA,EAAG,qBAAA;AAAA,EACH,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG,YAAA;AAAA,EACH,CAAA,EAAG,UAAA;AAAA,EACH,CAAA,EAAG,eAAA;AAAA,EACH,CAAA,EAAG,oBAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAEA,IAAM,cAAA,GAAyC;AAAA,EAC7C,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,MAAA;AAAA,EACH,CAAA,EAAG,OAAA;AAAA,EACH,CAAA,EAAG,KAAA;AAAA,EACH,CAAA,EAAG,UAAA;AAAA,EACH,CAAA,EAAG,QAAA;AAAA,EACH,CAAA,EAAG;AACL,CAAA;AAWO,SAAS,kBAAA,CACd,eACA,OAAA,EACQ;AACR,EAAA,MAAM,MAAA,GAASA,iCAAe,aAAa,CAAA;AAC3C,EAAA,MAAM;AAAA,IACJ,iBAAA,GAAoB,IAAA;AAAA,IACpB,MAAA,GAAS,WAAA;AAAA,IACT,WAAA,GAAc,OAAA;AAAA,IACd;AAAA,GACF,GAAI,WAAW,EAAC;AAEhB,EAAA,IAAI,MAAA,KAAW,YAAA,EAAc,OAAO,eAAA,CAAgB,QAAQ,iBAAiB,CAAA;AAC7E,EAAA,IAAI,MAAA,KAAW,SAAA,EAAW,OAAO,YAAA,CAAa,MAAM,CAAA;AACpD,EAAA,OAAO,cAAA,CAAe,MAAA,EAAQ,WAAA,EAAa,IAAA,EAAM,iBAAiB,CAAA;AACpE;AAEO,SAAS,cAAA,CACd,QACA,OAAA,EACQ;AACR,EAAA,MAAM;AAAA,IACJ,iBAAA,GAAoB,IAAA;AAAA,IACpB,MAAA,GAAS,WAAA;AAAA,IACT,WAAA,GAAc,OAAA;AAAA,IACd;AAAA,GACF,GAAI,WAAW,EAAC;AAEhB,EAAA,IAAI,MAAA,KAAW,YAAA,EAAc,OAAO,eAAA,CAAgB,QAAQ,iBAAiB,CAAA;AAC7E,EAAA,IAAI,MAAA,KAAW,SAAA,EAAW,OAAO,YAAA,CAAa,MAAM,CAAA;AACpD,EAAA,OAAO,cAAA,CAAe,MAAA,EAAQ,WAAA,EAAa,IAAA,EAAM,iBAAiB,CAAA;AACpE;AAIA,SAAS,cAAA,CACP,CAAA,EACA,WAAA,EACA,IAAA,EACA,SAAA,EACQ;AACR,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,MAAM,EAAA,GAAKC,qCAAmB,CAAC,CAAA;AAE/B,EAAA,MAAM,OAAA,GAAU,WAAA,KAAgB,OAAA,GAC3B,IAAA,GAAO,CAAA,IAAA,EAAO,IAAI,CAAA,QAAA,CAAA,GAAa,QAAA,GAC/B,IAAA,GAAO,CAAA,EAAG,IAAI,CAAA,IAAA,CAAA,GAAS,kBAAA;AAE5B,EAAA,MAAM,EAAA,GAAK,WAAA,KAAgB,OAAA,GAAU,KAAA,GAAQ,SAAA;AAG7C,EAAA,KAAA,CAAM,IAAA,CAAK,GAAG,OAAO,CAAA,sBAAA,EAAyB,WAAW,CAAA,CAAE,SAAS,CAAA,IAAK,MAAM,CAAA,KAAA,CAAO,CAAA;AAGtF,EAAA,MAAM,QAAA,GAAW,UAAA,CAAW,CAAA,CAAE,QAAQ,CAAA,IAAK,OAAA;AAC3C,EAAA,MAAM,QAAA,GAAW,eAAA,CAAgB,CAAA,CAAE,QAAQ,CAAA,IAAK,MAAA;AAChD,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,QAAQ,CAAA,CAAA,EAAI,QAAQ,CAAA,KAAA,CAAO,CAAA;AAGzC,EAAA,MAAM,KAAA,GAAQ,cAAA,CAAe,CAAA,CAAE,QAAQ,CAAA;AACvC,EAAA,IAAI,KAAA,EAAO,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,KAAK,CAAA,SAAA,CAAW,CAAA;AAGzC,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,CAAA,CAAE,SAAS,CAAA,IAAK,EAAA;AAC9C,EAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,CAAA,CAAE,SAAS,CAAA,IAAK,EAAA;AACnD,EAAA,IAAI,CAAA,CAAE,cAAc,CAAA,EAAG;AACrB,IAAA,KAAA,CAAM,IAAA,CAAK,WAAA,KAAgB,OAAA,GAAU,aAAA,GAAgB,aAAa,CAAA;AAAA,EACpE,CAAA,MAAA,IAAW,SAAA,CAAU,UAAA,CAAW,IAAI,CAAA,EAAG;AACrC,IAAA,KAAA,CAAM,IAAA,CAAK,SAAS,SAAS,CAAA,CAAA,EAAI,UAAU,KAAA,CAAM,CAAC,CAAC,CAAA,CAAE,CAAA;AAAA,EACvD,CAAA,MAAO;AACL,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,IAAA,EAAO,SAAS,CAAA,CAAA,EAAI,SAAS,CAAA,CAAE,CAAA;AAAA,EAC5C;AAGA,EAAA,IAAI,IAAA,GAAO,MAAM,CAAC,CAAA;AAClB,EAAA,IAAI,KAAA,CAAM,SAAS,CAAA,EAAG;AACpB,IAAA,IAAA,IAAQ,IAAA,GAAO,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA,GAAI,IAAA,GAAO,KAAA,CAAM,KAAA,CAAM,SAAS,CAAC,CAAA;AAAA,EAC9E,CAAA,MAAA,IAAW,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG;AAC7B,IAAA,IAAA,IAAQ,OAAA,GAAU,MAAM,CAAC,CAAA;AAAA,EAC3B;AACA,EAAA,IAAA,IAAQ,GAAA;AAGR,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,CAAA,CAAE,IAAI,CAAA;AAC/B,EAAA,IAAI,IAAA,EAAM;AACR,IAAA,MAAM,cAAc,WAAA,KAAgB,OAAA,GAChC,YACC,IAAA,IAAQ,MAAA,KAAW,OAAO,MAAA,GAAS,OAAA,CAAA;AACxC,IAAA,IAAA,IAAQ,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,CAAA;AAAA,EACjC;AAGA,EAAA,MAAM,GAAA,GAAM,eAAe,EAAE,CAAA;AAC7B,EAAA,IAAI,GAAA,EAAK;AACP,IAAA,IAAA,IAAQ,CAAA,CAAA,EAAI,EAAE,CAAA,SAAA,EAAY,GAAG,CAAA,CAAA,CAAA;AAAA,EAC/B;AAGA,EAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,CAAA,CAAE,KAAK,CAAA,IAAK,SAAA;AACvC,EAAA,MAAM,YAAY,WAAA,KAAgB,OAAA,GAC9B,YACC,IAAA,IAAQ,MAAA,KAAW,OAAO,MAAA,GAAS,OAAA,CAAA;AACxC,EAAA,IAAA,IAAQ,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,CAAA;AAG9B,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,MAAM,EAAA,GAAK,cAAA,CAAe,CAAA,CAAE,OAAO,CAAA,IAAK,UAAA;AACxC,IAAA,IAAA,IAAQ,sBAAsB,EAAE,CAAA,CAAA,CAAA;AAAA,EAClC;AAEA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,eAAA,CAAgB,GAAkB,SAAA,EAA4B;AACrE,EAAA,MAAM,EAAA,GAAKA,qCAAmB,CAAC,CAAA;AAC/B,EAAA,MAAM,KAAA,GAAkB;AAAA,IACtB,CAAA,cAAA,CAAA;AAAA,IACA,CAAA,MAAA,EAAS,UAAA,CAAW,CAAA,CAAE,SAAS,KAAK,MAAM,CAAA,CAAA;AAAA,IAC1C,CAAA,MAAA,EAAS,UAAA,CAAW,CAAA,CAAE,QAAQ,CAAA,IAAK,OAAO,CAAA,EAAA,EAAK,eAAA,CAAgB,CAAA,CAAE,QAAQ,CAAA,IAAK,MAAM,CAAA,CAAA;AAAA,IACpF,CAAA,UAAA,EAAa,cAAA,CAAe,CAAA,CAAE,QAAQ,KAAK,OAAO,CAAA;AAAA,GACpD;AAEA,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,CAAA,CAAE,IAAI,CAAA;AAC/B,EAAA,IAAI,IAAA,QAAY,IAAA,CAAK,CAAA,MAAA,EAAS,KAAK,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAC,CAAA,CAAE,CAAA;AAEvD,EAAA,KAAA,CAAM,KAAK,CAAA,OAAA,EAAU,YAAA,CAAa,EAAE,KAAK,CAAA,IAAK,OAAO,CAAA,CAAE,CAAA;AAEvD,EAAA,IAAI,CAAA,CAAE,cAAc,CAAA,EAAG;AACrB,IAAA,KAAA,CAAM,KAAK,YAAY,CAAA;AAAA,EACzB,CAAA,MAAO;AACL,IAAA,MAAM,EAAA,GAAK,WAAA,CAAY,CAAA,CAAE,SAAS,CAAA,IAAK,EAAA;AACvC,IAAA,MAAM,EAAA,GAAK,gBAAA,CAAiB,CAAA,CAAE,SAAS,CAAA,IAAK,EAAA;AAC5C,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,MAAA,EAAS,EAAE,CAAA,CAAA,EAAI,EAAA,CAAG,UAAA,CAAW,IAAI,CAAA,GAAI,EAAA,CAAG,KAAA,CAAM,CAAC,CAAA,GAAI,EAAE,CAAA,CAAE,CAAA;AAAA,EACpE;AAEA,EAAA,MAAM,GAAA,GAAM,eAAe,EAAE,CAAA;AAC7B,EAAA,IAAI,GAAA,EAAK,KAAA,CAAM,IAAA,CAAK,CAAA,WAAA,EAAc,GAAG,CAAA,CAAE,CAAA;AAEvC,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,KAAA,CAAM,KAAK,CAAA,YAAA,EAAe,cAAA,CAAe,EAAE,OAAO,CAAA,IAAK,UAAU,CAAA,CAAE,CAAA;AAAA,EACrE;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAEA,SAAS,aAAa,CAAA,EAA0B;AAC9C,EAAA,MAAM,EAAA,GAAKA,qCAAmB,CAAC,CAAA;AAC/B,EAAA,MAAM,QAAkB,EAAC;AAEzB,EAAA,KAAA,CAAM,KAAK,CAAA,aAAA,CAAe,CAAA;AAC1B,EAAA,KAAA,CAAM,KAAK,CAAA,EAAG,UAAA,CAAW,EAAE,SAAS,CAAA,IAAK,MAAM,CAAA,KAAA,CAAO,CAAA;AACtD,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,eAAA,CAAgB,CAAA,CAAE,QAAQ,CAAA,IAAK,MAAM,CAAA,CAAA,EAAI,UAAA,CAAW,CAAA,CAAE,QAAQ,CAAA,IAAK,OAAO,CAAA,KAAA,CAAO,CAAA;AAE/F,EAAA,IAAI,CAAA,CAAE,cAAc,CAAA,EAAG;AACrB,IAAA,KAAA,CAAM,KAAK,MAAM,CAAA;AAAA,EACnB,CAAA,MAAO;AACL,IAAA,MAAM,GAAA,GAAM,WAAA,CAAY,CAAA,CAAE,SAAS,CAAA,IAAK,MAAA;AACxC,IAAA,MAAM,EAAA,GAAK,IAAI,QAAA,CAAS,GAAG,IAAI,GAAA,CAAI,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAA,GAAI,GAAA;AAC3D,IAAA,MAAM,EAAA,GAAK,gBAAA,CAAiB,CAAA,CAAE,SAAS,CAAA,IAAK,EAAA;AAC5C,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAG,EAAE,CAAA,CAAA,EAAI,EAAA,CAAG,UAAA,CAAW,IAAI,CAAA,GAAI,EAAA,CAAG,KAAA,CAAM,CAAC,CAAA,GAAI,EAAE,CAAA,CAAE,CAAA;AAAA,EAC9D;AAEA,EAAA,MAAM,GAAA,GAAM,eAAe,EAAE,CAAA;AAC7B,EAAA,IAAI,GAAA,EAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAEvB,EAAA,KAAA,CAAM,IAAA,CAAA,CAAM,aAAa,CAAA,CAAE,KAAK,KAAK,SAAA,EAAW,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAC,CAAA;AAElE,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAIO,SAAS,eAAe,aAAA,EAA+B;AAC5D,EAAA,OAAO,CAAA,gBAAA,EAAmB,mBAAmB,aAAA,EAAe,EAAE,QAAQ,SAAA,EAAW,iBAAA,EAAmB,KAAA,EAAO,CAAC,CAAA,CAAA;AAC9G;AAIO,SAAS,qBAAA,CACd,eACA,SAAA,EACQ;AACR,EAAA,MAAM,IAAA,GAAO,mBAAmB,aAAA,EAAe;AAAA,IAC7C,WAAA,EAAa,OAAA;AAAA,IACb,IAAA,EAAM,SAAA;AAAA,IACN,iBAAA,EAAmB,KAAA;AAAA,IACnB,MAAA,EAAQ;AAAA,GACT,CAAA;AAED,EAAA,MAAM,IAAA,GAAA,CAAQ,UAAA,CAAW,aAAa,CAAA,KAAM,CAAA,EAAG,SAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG,CAAA;AAE3E,EAAA,OAAO,CAAA,4CAAA,EAA+C,IAAI,CAAA,kCAAA,EAAqC,IAAI,CAAA,8FAAA,CAAA;AACrG;AAGA,SAAS,WAAW,GAAA,EAAqB;AACvC,EAAA,IAAI,IAAA,GAAO,IAAA;AACX,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACnC,IAAA,IAAA,GAAA,CAAS,QAAQ,CAAA,IAAK,IAAA,GAAO,GAAA,CAAI,UAAA,CAAW,CAAC,CAAA,GAAK,CAAA;AAAA,EACpD;AACA,EAAA,OAAO,IAAA,KAAS,CAAA;AAClB","file":"chunk-CXRVPOTI.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — AI Agent Description Generator\n// Produces natural language descriptions of a wallet's SolFace\n// for use in system prompts, bios, and self-reference.\n// ═══════════════════════════════════════════════════════════════\n\nimport { generateTraits, effectiveAccessory, type SolFaceTraits } from \"./traits\";\n\n// ─── Vocabulary Maps ─────────────────────────────────────────\n\nconst SKIN_TONES: Record<number, string> = {\n  0: \"porcelain\",\n  1: \"ivory\",\n  2: \"fair\",\n  3: \"light\",\n  4: \"sand\",\n  5: \"golden\",\n  6: \"warm\",\n  7: \"caramel\",\n  8: \"brown\",\n  9: \"deep\",\n};\n\nconst EYE_STYLES: Record<number, string> = {\n  0: \"round, wide-open\",\n  1: \"small and minimal\",\n  2: \"almond-shaped\",\n  3: \"wide and expressive\",\n  4: \"relaxed, half-lidded\",\n  5: \"joyful, crescent-shaped\",\n  6: \"bright and sparkling\",\n  7: \"gentle and narrow\",\n};\n\nconst EYE_COLORS_DESC: Record<number, string> = {\n  0: \"dark brown\",\n  1: \"blue\",\n  2: \"green\",\n  3: \"hazel\",\n  4: \"gray\",\n};\n\nconst EYEBROW_STYLES: Record<number, string> = {\n  0: \"wispy\",\n  1: \"straight\",\n  2: \"natural\",\n  3: \"elegantly arched\",\n  4: \"sharply angled\",\n};\n\nconst NOSE_STYLES: Record<number, string> = {\n  0: \"a subtle shadow nose\",\n  1: \"a small button nose\",\n  2: \"a soft curved nose\",\n  3: \"a button nose with visible nostrils\",\n};\n\nconst MOUTH_STYLES: Record<number, string> = {\n  0: \"a gentle smile\",\n  1: \"a calm, neutral expression\",\n  2: \"a happy grin\",\n  3: \"a surprised O-shaped mouth\",\n  4: \"a confident smirk\",\n  5: \"a wide, toothy grin\",\n  6: \"a flat, straight expression\",\n  7: \"a soft pout\",\n};\n\nconst HAIR_STYLES: Record<number, string> = {\n  0: \"bald, with no hair\",\n  1: \"short, neatly cropped hair\",\n  2: \"bouncy, curly hair\",\n  3: \"side-swept hair\",\n  4: \"a voluminous puff\",\n  5: \"long hair that falls past the shoulders\",\n  6: \"a clean bob cut\",\n  7: \"a close buzz cut\",\n  8: \"flowing, wavy hair\",\n  9: \"a neat topknot\",\n};\n\nconst HAIR_COLORS_DESC: Record<number, string> = {\n  0: \"jet black\",\n  1: \"espresso brown\",\n  2: \"walnut\",\n  3: \"honey blonde\",\n  4: \"copper red\",\n  5: \"silver\",\n  6: \"charcoal\",\n  7: \"burgundy\",\n  8: \"strawberry\",\n  9: \"ginger\",\n};\n\nconst ACCESSORY_DESC: Record<number, string> = {\n  0: \"\",\n  1: \"a beauty mark\",\n  2: \"round glasses\",\n  3: \"rectangular glasses\",\n  4: \"a dangling earring\",\n  5: \"a headband\",\n  6: \"freckles\",\n  7: \"stud earrings\",\n  8: \"aviator sunglasses\",\n  9: \"a band-aid\",\n};\n\nconst BG_COLORS_DESC: Record<number, string> = {\n  0: \"rose\",\n  1: \"olive\",\n  2: \"sage\",\n  3: \"fern\",\n  4: \"mint\",\n  5: \"ocean\",\n  6: \"sky\",\n  7: \"lavender\",\n  8: \"orchid\",\n  9: \"blush\",\n};\n\n// ─── Description Builder ─────────────────────────────────────\n\nexport interface DescribeOptions {\n  includeBackground?: boolean;\n  format?: \"paragraph\" | \"structured\" | \"compact\";\n  perspective?: \"first\" | \"third\";\n  name?: string;\n}\n\nexport function describeAppearance(\n  walletAddress: string,\n  options?: DescribeOptions,\n): string {\n  const traits = generateTraits(walletAddress);\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\nexport function describeTraits(\n  traits: SolFaceTraits,\n  options?: DescribeOptions,\n): string {\n  const {\n    includeBackground = true,\n    format = \"paragraph\",\n    perspective = \"third\",\n    name,\n  } = options ?? {};\n\n  if (format === \"structured\") return buildStructured(traits, includeBackground);\n  if (format === \"compact\") return buildCompact(traits);\n  return buildParagraph(traits, perspective, name, includeBackground);\n}\n\n// ─── Builders ────────────────────────────────────────────────\n\nfunction buildParagraph(\n  t: SolFaceTraits,\n  perspective: \"first\" | \"third\",\n  name?: string,\n  includeBg?: boolean,\n): string {\n  const parts: string[] = [];\n  const ai = effectiveAccessory(t);\n\n  const subject = perspective === \"first\"\n    ? (name ? `I'm ${name}. I have` : \"I have\")\n    : (name ? `${name} has` : \"This SolFace has\");\n\n  const im = perspective === \"first\" ? \"I'm\" : \"They're\";\n\n  // Face + skin (all squircle now)\n  parts.push(`${subject} a squircle face with ${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n\n  // Eyes\n  const eyeStyle = EYE_STYLES[t.eyeStyle] ?? \"round\";\n  const eyeColor = EYE_COLORS_DESC[t.eyeColor] ?? \"dark\";\n  parts.push(`${eyeStyle} ${eyeColor} eyes`);\n\n  // Eyebrows\n  const brows = EYEBROW_STYLES[t.eyebrows];\n  if (brows) parts.push(`${brows} eyebrows`);\n\n  // Hair\n  const hairStyle = HAIR_STYLES[t.hairStyle] ?? \"\";\n  const hairColor = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n  if (t.hairStyle === 0) {\n    parts.push(perspective === \"first\" ? \"and am bald\" : \"and is bald\");\n  } else if (hairStyle.startsWith(\"a \")) {\n    parts.push(`and a ${hairColor} ${hairStyle.slice(2)}`);\n  } else {\n    parts.push(`and ${hairColor} ${hairStyle}`);\n  }\n\n  // Build main sentence\n  let desc = parts[0];\n  if (parts.length > 2) {\n    desc += \", \" + parts.slice(1, -1).join(\", \") + \", \" + parts[parts.length - 1];\n  } else if (parts.length === 2) {\n    desc += \" and \" + parts[1];\n  }\n  desc += \".\";\n\n  // Nose\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) {\n    const noseSubject = perspective === \"first\"\n      ? \"I have\"\n      : (name ?? \"They\") + (name ? \" has\" : \" have\");\n    desc += ` ${noseSubject} ${nose}.`;\n  }\n\n  // Accessory\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) {\n    desc += ` ${im} wearing ${acc}.`;\n  }\n\n  // Mouth\n  const mouth = MOUTH_STYLES[t.mouth] ?? \"a smile\";\n  const mouthVerb = perspective === \"first\"\n    ? \"I have\"\n    : (name ?? \"They\") + (name ? \" has\" : \" have\");\n  desc += ` ${mouthVerb} ${mouth}.`;\n\n  // Background\n  if (includeBg) {\n    const bg = BG_COLORS_DESC[t.bgColor] ?? \"colorful\";\n    desc += ` The background is ${bg}.`;\n  }\n\n  return desc;\n}\n\nfunction buildStructured(t: SolFaceTraits, includeBg: boolean): string {\n  const ai = effectiveAccessory(t);\n  const lines: string[] = [\n    `Face: squircle`,\n    `Skin: ${SKIN_TONES[t.skinColor] ?? \"warm\"}`,\n    `Eyes: ${EYE_STYLES[t.eyeStyle] ?? \"round\"}, ${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"}`,\n    `Eyebrows: ${EYEBROW_STYLES[t.eyebrows] ?? \"wispy\"}`,\n  ];\n\n  const nose = NOSE_STYLES[t.nose];\n  if (nose) lines.push(`Nose: ${nose.replace(/^a /, \"\")}`);\n\n  lines.push(`Mouth: ${MOUTH_STYLES[t.mouth] ?? \"smile\"}`);\n\n  if (t.hairStyle === 0) {\n    lines.push(\"Hair: bald\");\n  } else {\n    const hs = HAIR_STYLES[t.hairStyle] ?? \"\";\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    lines.push(`Hair: ${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) lines.push(`Accessory: ${acc}`);\n\n  if (includeBg) {\n    lines.push(`Background: ${BG_COLORS_DESC[t.bgColor] ?? \"colorful\"}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction buildCompact(t: SolFaceTraits): string {\n  const ai = effectiveAccessory(t);\n  const parts: string[] = [];\n\n  parts.push(`squircle face`);\n  parts.push(`${SKIN_TONES[t.skinColor] ?? \"warm\"} skin`);\n  parts.push(`${EYE_COLORS_DESC[t.eyeColor] ?? \"dark\"} ${EYE_STYLES[t.eyeStyle] ?? \"round\"} eyes`);\n\n  if (t.hairStyle === 0) {\n    parts.push(\"bald\");\n  } else {\n    const raw = HAIR_STYLES[t.hairStyle] ?? \"hair\";\n    const hs = raw.includes(\",\") ? raw.replace(/.*,\\s*/, \"\") : raw;\n    const hc = HAIR_COLORS_DESC[t.hairColor] ?? \"\";\n    parts.push(`${hc} ${hs.startsWith(\"a \") ? hs.slice(2) : hs}`);\n  }\n\n  const acc = ACCESSORY_DESC[ai];\n  if (acc) parts.push(acc);\n\n  parts.push((MOUTH_STYLES[t.mouth] ?? \"smiling\").replace(/^a /, \"\"));\n\n  return parts.join(\", \");\n}\n\n// ─── Alt Text Helper ─────────────────────────────────────────\n\nexport function solFaceAltText(walletAddress: string): string {\n  return `SolFace avatar: ${describeAppearance(walletAddress, { format: \"compact\", includeBackground: false })}`;\n}\n\n// ─── System Prompt Helper ────────────────────────────────────\n\nexport function agentAppearancePrompt(\n  walletAddress: string,\n  agentName?: string,\n): string {\n  const desc = describeAppearance(walletAddress, {\n    perspective: \"first\",\n    name: agentName,\n    includeBackground: false,\n    format: \"paragraph\",\n  });\n\n  const hash = (djb2Simple(walletAddress) >>> 0).toString(16).padStart(8, \"0\");\n\n  return `My visual identity is a SolFace avatar (ID: ${hash}) derived from my wallet address. ${desc} This appearance is deterministic — anyone who looks up my wallet will see the same face.`;\n}\n\n// Inline djb2 to avoid circular dependency\nfunction djb2Simple(str: string): number {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash + str.charCodeAt(i)) | 0;\n  }\n  return hash >>> 0;\n}\n"]}