solfaces 1.0.2 → 2.1.0

package/dist/chunk-6QRDULAO.cjs

@@ -0,0 +1,191 @@
+'use strict';
+
+// src/themes/presets.ts
+var defaultTheme = {};
+var darkTheme = {
+  bgColors: [
+    "#1a1b23",
+    "#1e1428",
+    "#0a1e38",
+    "#1b2838",
+    "#201028",
+    "#141a28",
+    "#18122a",
+    "#1a2020",
+    "#221822",
+    "#1e1020"
+  ],
+  eyeWhiteColor: "#d8d0c8",
+  bgOpacity: 1,
+  bgRadius: 4,
+  border: { color: "#333340", width: 0.5 }
+};
+var lightTheme = {
+  bgColors: [
+    "#f5e8ea",
+    "#f0f0d8",
+    "#e4f0e6",
+    "#d8f0e8",
+    "#e0ece8",
+    "#dce8f0",
+    "#e0e4f0",
+    "#e0d8f0",
+    "#f0e0ee",
+    "#f0d8e4"
+  ],
+  bgOpacity: 1,
+  bgRadius: 8
+};
+var monoTheme = {
+  skinColors: [
+    "#e8e8e8",
+    "#d4d4d4",
+    "#c0c0c0",
+    "#a8a8a8",
+    "#909090",
+    "#787878",
+    "#606060",
+    "#505050",
+    "#404040",
+    "#303030"
+  ],
+  eyeColors: ["#333", "#555", "#777", "#999", "#bbb"],
+  hairColors: [
+    "#1a1a1a",
+    "#2a2a2a",
+    "#404040",
+    "#555",
+    "#707070",
+    "#888",
+    "#a0a0a0",
+    "#b8b8b8",
+    "#d0d0d0",
+    "#e0e0e0"
+  ],
+  bgColors: [
+    "#e8e0e0",
+    "#e0e0d0",
+    "#d8e0d8",
+    "#d0e0d8",
+    "#d8e0e0",
+    "#d0d8e0",
+    "#d4d4e0",
+    "#d4d0e0",
+    "#e0d8e0",
+    "#e0d0d8"
+  ],
+  mouthColor: "#666",
+  eyebrowColor: "#555",
+  accessoryColor: "#777",
+  eyeWhiteColor: "#f0f0f0",
+  bgOpacity: 0.5,
+  bgRadius: 4
+};
+var flatTheme = {
+  flat: true
+};
+var transparentTheme = {
+  flat: true,
+  bgOpacity: 0
+};
+var glassTheme = {
+  bgOpacity: 0.15,
+  bgRadius: 16,
+  _glass: true,
+  _blurRadius: 12,
+  _saturate: 1.8,
+  _tintOpacity: 0.12,
+  _tintColor: "rgba(255,255,255,1)",
+  _borderOpacity: 0.25,
+  _borderWidth: 1,
+  _borderColor: "rgba(255,255,255,0.25)",
+  _specularOpacity: 0.25,
+  _specularColor: "rgba(255,255,255,1)",
+  _specularEnd: 50,
+  _lightAngle: 135,
+  _rimIntensity: 0.08,
+  _shadow: "0 8px 32px rgba(0,0,0,0.12)"
+};
+var glassDarkTheme = {
+  bgOpacity: 0.2,
+  bgRadius: 16,
+  _glass: true,
+  _blurRadius: 16,
+  _saturate: 2,
+  _tintOpacity: 0.08,
+  _tintColor: "rgba(0,0,0,1)",
+  _borderOpacity: 0.15,
+  _borderWidth: 1,
+  _borderColor: "rgba(255,255,255,0.15)",
+  _specularOpacity: 0.15,
+  _specularColor: "rgba(255,255,255,1)",
+  _specularEnd: 40,
+  _lightAngle: 135,
+  _rimIntensity: 0.05,
+  _shadow: "0 8px 32px rgba(0,0,0,0.25)"
+};
+var pixelTheme = {
+  flat: true,
+  _pixel: true,
+  _pixelDensity: 16,
+  _pixelRounded: true,
+  _pixelOutline: true,
+  _pixelOutlineColor: "#222",
+  _pixelOutlineWidth: 2
+};
+var pixelRetroTheme = {
+  flat: true,
+  _pixel: true,
+  _pixelDensity: 12,
+  _pixelRounded: false,
+  _pixelOutline: true,
+  _pixelOutlineColor: "#000",
+  _pixelOutlineWidth: 2,
+  _pixelScanlines: true,
+  _pixelScanlineOpacity: 0.1,
+  _pixelScanlineSpacing: 2,
+  _pixelShadow: true,
+  _pixelShadowColor: "rgba(0,0,0,0.4)",
+  _pixelShadowOffset: 3
+};
+var pixelCleanTheme = {
+  flat: true,
+  _pixel: true,
+  _pixelDensity: 24,
+  _pixelRounded: true,
+  _pixelOutline: false
+};
+var PRESET_THEMES = {
+  default: defaultTheme,
+  dark: darkTheme,
+  light: lightTheme,
+  mono: monoTheme,
+  flat: flatTheme,
+  transparent: transparentTheme,
+  glass: glassTheme,
+  glassDark: glassDarkTheme,
+  pixel: pixelTheme,
+  pixelRetro: pixelRetroTheme,
+  pixelClean: pixelCleanTheme
+};
+function getPresetTheme(name, overrides) {
+  const base = PRESET_THEMES[name];
+  if (!base) return overrides ?? {};
+  return overrides ? { ...base, ...overrides } : base;
+}
+
+exports.PRESET_THEMES = PRESET_THEMES;
+exports.darkTheme = darkTheme;
+exports.defaultTheme = defaultTheme;
+exports.flatTheme = flatTheme;
+exports.getPresetTheme = getPresetTheme;
+exports.glassDarkTheme = glassDarkTheme;
+exports.glassTheme = glassTheme;
+exports.lightTheme = lightTheme;
+exports.monoTheme = monoTheme;
+exports.pixelCleanTheme = pixelCleanTheme;
+exports.pixelRetroTheme = pixelRetroTheme;
+exports.pixelTheme = pixelTheme;
+exports.transparentTheme = transparentTheme;
+//# sourceMappingURL=chunk-6QRDULAO.cjs.map
+//# sourceMappingURL=chunk-6QRDULAO.cjs.map

package/dist/chunk-6QRDULAO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/themes/presets.ts"],"names":[],"mappings":"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","file":"chunk-6QRDULAO.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — Preset Themes\n// ═══════════════════════════════════════════════════════════════\n\nimport type { SolFaceTheme } from \"../core/traits\";\n\n// ─── Default (base look — gradients, no overrides) ─\n\nexport const defaultTheme: SolFaceTheme = {};\n\n// ─── Base Themes ────────────────────────────────\n\nexport const darkTheme: SolFaceTheme = {\n  bgColors: [\"#1a1b23\", \"#1e1428\", \"#0a1e38\", \"#1b2838\", \"#201028\",\n             \"#141a28\", \"#18122a\", \"#1a2020\", \"#221822\", \"#1e1020\"],\n  eyeWhiteColor: \"#d8d0c8\",\n  bgOpacity: 1,\n  bgRadius: 4,\n  border: { color: \"#333340\", width: 0.5 },\n};\n\nexport const lightTheme: SolFaceTheme = {\n  bgColors: [\"#f5e8ea\", \"#f0f0d8\", \"#e4f0e6\", \"#d8f0e8\", \"#e0ece8\",\n             \"#dce8f0\", \"#e0e4f0\", \"#e0d8f0\", \"#f0e0ee\", \"#f0d8e4\"],\n  bgOpacity: 1,\n  bgRadius: 8,\n};\n\nexport const monoTheme: SolFaceTheme = {\n  skinColors: [\"#e8e8e8\", \"#d4d4d4\", \"#c0c0c0\", \"#a8a8a8\", \"#909090\",\n               \"#787878\", \"#606060\", \"#505050\", \"#404040\", \"#303030\"],\n  eyeColors: [\"#333\", \"#555\", \"#777\", \"#999\", \"#bbb\"],\n  hairColors: [\"#1a1a1a\", \"#2a2a2a\", \"#404040\", \"#555\", \"#707070\",\n               \"#888\", \"#a0a0a0\", \"#b8b8b8\", \"#d0d0d0\", \"#e0e0e0\"],\n  bgColors: [\"#e8e0e0\", \"#e0e0d0\", \"#d8e0d8\", \"#d0e0d8\", \"#d8e0e0\",\n             \"#d0d8e0\", \"#d4d4e0\", \"#d4d0e0\", \"#e0d8e0\", \"#e0d0d8\"],\n  mouthColor: \"#666\",\n  eyebrowColor: \"#555\",\n  accessoryColor: \"#777\",\n  eyeWhiteColor: \"#f0f0f0\",\n  bgOpacity: 0.5,\n  bgRadius: 4,\n};\n\nexport const flatTheme: SolFaceTheme = {\n  flat: true,\n};\n\nexport const transparentTheme: SolFaceTheme = {\n  flat: true,\n  bgOpacity: 0,\n};\n\n// ─── React-Only: Liquid Glass ───────────────────\n\nexport const glassTheme: SolFaceTheme = {\n  bgOpacity: 0.15,\n  bgRadius: 16,\n  _glass: true,\n  _blurRadius: 12,\n  _saturate: 1.8,\n  _tintOpacity: 0.12,\n  _tintColor: \"rgba(255,255,255,1)\",\n  _borderOpacity: 0.25,\n  _borderWidth: 1,\n  _borderColor: \"rgba(255,255,255,0.25)\",\n  _specularOpacity: 0.25,\n  _specularColor: \"rgba(255,255,255,1)\",\n  _specularEnd: 50,\n  _lightAngle: 135,\n  _rimIntensity: 0.08,\n  _shadow: \"0 8px 32px rgba(0,0,0,0.12)\",\n};\n\nexport const glassDarkTheme: SolFaceTheme = {\n  bgOpacity: 0.2,\n  bgRadius: 16,\n  _glass: true,\n  _blurRadius: 16,\n  _saturate: 2.0,\n  _tintOpacity: 0.08,\n  _tintColor: \"rgba(0,0,0,1)\",\n  _borderOpacity: 0.15,\n  _borderWidth: 1,\n  _borderColor: \"rgba(255,255,255,0.15)\",\n  _specularOpacity: 0.15,\n  _specularColor: \"rgba(255,255,255,1)\",\n  _specularEnd: 40,\n  _lightAngle: 135,\n  _rimIntensity: 0.05,\n  _shadow: \"0 8px 32px rgba(0,0,0,0.25)\",\n};\n\n// ─── React-Only: Pixel Art ──────────────────────\n\nexport const pixelTheme: SolFaceTheme = {\n  flat: true,\n  _pixel: true,\n  _pixelDensity: 16,\n  _pixelRounded: true,\n  _pixelOutline: true,\n  _pixelOutlineColor: \"#222\",\n  _pixelOutlineWidth: 2,\n};\n\nexport const pixelRetroTheme: SolFaceTheme = {\n  flat: true,\n  _pixel: true,\n  _pixelDensity: 12,\n  _pixelRounded: false,\n  _pixelOutline: true,\n  _pixelOutlineColor: \"#000\",\n  _pixelOutlineWidth: 2,\n  _pixelScanlines: true,\n  _pixelScanlineOpacity: 0.1,\n  _pixelScanlineSpacing: 2,\n  _pixelShadow: true,\n  _pixelShadowColor: \"rgba(0,0,0,0.4)\",\n  _pixelShadowOffset: 3,\n};\n\nexport const pixelCleanTheme: SolFaceTheme = {\n  flat: true,\n  _pixel: true,\n  _pixelDensity: 24,\n  _pixelRounded: true,\n  _pixelOutline: false,\n};\n\n// ─── Theme Map ──────────────────────────────────\n\nexport const PRESET_THEMES: Record<string, SolFaceTheme> = {\n  default: defaultTheme,\n  dark: darkTheme,\n  light: lightTheme,\n  mono: monoTheme,\n  flat: flatTheme,\n  transparent: transparentTheme,\n  glass: glassTheme,\n  glassDark: glassDarkTheme,\n  pixel: pixelTheme,\n  pixelRetro: pixelRetroTheme,\n  pixelClean: pixelCleanTheme,\n};\n\nexport function getPresetTheme(\n  name: string,\n  overrides?: Partial<SolFaceTheme>,\n): SolFaceTheme {\n  const base = PRESET_THEMES[name];\n  if (!base) return (overrides as SolFaceTheme) ?? {};\n  return overrides ? { ...base, ...overrides } : base;\n}\n"]}

package/dist/{chunk-RX6D5FGH.js → chunk-77SPWQU5.js}

@@ -1,11 +1,12 @@
-import { renderSolFaceSVG, describeAppearance, agentAppearancePrompt } from './chunk-KSGFMW33.js';
-import { generateTraits, getTraitLabels, traitHash } from './chunk-WURY4QGH.js';
-import { getPresetTheme, PRESET_THEMES } from './chunk-LQWJRHGC.js';
+import { describeAppearance, agentAppearancePrompt } from './chunk-CQWXUU7P.js';
+import { renderSolFaceSVG, generateTraits, getTraitLabels, traitHash } from './chunk-SWML743U.js';
+import { getPresetTheme, PRESET_THEMES } from './chunk-DRUSCLEF.js';
+import { deriveName, deriveIdentity } from './chunk-SX3FQDKM.js';
 
 // 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.",
+  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.",
   parameters: {
     type: "object",
     properties: {
@@ -15,16 +16,21 @@ var generateSolfaceSvg = {
       },
       size: {
         type: "number",
-        description: "SVG width/height in pixels. Default: 64"
+        description: "SVG width/height in pixels. Default: 64. Sizes >= 48 use full detail (gradients, specular highlights, cheek blush)."
       },
       theme: {
         type: "string",
-        description: "Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle",
-        enum: ["solana", "dark", "light", "mono", "neon", "jupiter", "phantom", "circle"]
+        description: "Preset theme name. 'flat' and 'transparent' work everywhere. 'glass', 'glassDark', 'pixel', 'pixelRetro', 'pixelClean' are React-only.",
+        enum: ["default", "dark", "light", "mono", "flat", "transparent", "glass", "glassDark", "pixel", "pixelRetro", "pixelClean"]
       },
       enableBlink: {
         type: "boolean",
         description: "Enable CSS blink animation on the eyes. Default: false"
+      },
+      detail: {
+        type: "string",
+        description: "Detail level: 'full' (gradients, cheeks, specular), 'simplified' (flat shapes), 'auto' (full if size >= 48). Default: auto",
+        enum: ["full", "simplified", "auto"]
       }
     },
     required: ["wallet"]
@@ -33,14 +39,15 @@ var generateSolfaceSvg = {
     const wallet = params.wallet;
     const size = params.size ?? 64;
     const enableBlink = params.enableBlink ?? false;
+    const detail = params.detail ?? "auto";
     const themeName = params.theme;
     const theme = themeName ? getPresetTheme(themeName) : void 0;
-    return renderSolFaceSVG(wallet, { size, theme, enableBlink });
+    return renderSolFaceSVG(wallet, { size, theme, enableBlink, detail });
   }
 };
 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.",
+  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.",
   parameters: {
     type: "object",
     properties: {
@@ -66,10 +73,12 @@ var describeSolface = {
     required: ["wallet"]
   },
   handler(params) {
-    return describeAppearance(params.wallet, {
+    const wallet = params.wallet;
+    const name = params.name ?? deriveName(wallet, "display");
+    return describeAppearance(wallet, {
       format: params.format ?? "paragraph",
       perspective: params.perspective ?? "third",
-      name: params.name
+      name
     });
   }
 };
@@ -91,7 +100,8 @@ var getSolfaceTraits = {
     const traits = generateTraits(wallet);
     const labels = getTraitLabels(traits);
     const hash = traitHash(wallet);
-    return { traits, labels, hash };
+    const name = deriveName(wallet, "display");
+    return { traits, labels, hash, name };
   }
 };
 var getAgentIdentity = {
@@ -112,25 +122,27 @@ var getAgentIdentity = {
     required: ["wallet"]
   },
   handler(params) {
-    return agentAppearancePrompt(
-      params.wallet,
-      params.agentName
-    );
+    const wallet = params.wallet;
+    const agentName = params.agentName ?? deriveName(wallet, "display");
+    return agentAppearancePrompt(wallet, agentName);
   }
 };
 var THEME_DESCRIPTIONS = {
-  solana: "Vibrant Solana brand colors (#14F195, #9945FF)",
-  dark: "Dark backgrounds with muted tones",
-  light: "Soft pastel backgrounds",
+  default: "Base look with gradient-rich rendering \u2014 no overrides",
+  dark: "Dark backgrounds with muted tones and subtle border",
+  light: "Soft pastel backgrounds with rounded corners",
   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"
+  flat: "Disables all gradients \u2014 uses flat fill colors only",
+  transparent: "Transparent background with flat rendering",
+  glass: "Liquid glass effect with backdrop blur and specular highlights (React-only)",
+  glassDark: "Dark variant of liquid glass with deeper blur (React-only)",
+  pixel: "Pixel art mode at 16px density with rounded corners (React-only)",
+  pixelRetro: "Retro pixel art with scanlines and drop shadow (React-only)",
+  pixelClean: "Clean pixel art at 24px density (React-only)"
 };
 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.",
+  description: "List all available SolFace preset themes with descriptions. Themes control colors, gradients, borders, and rendering modes. Some themes (glass, pixel) are React-only.",
   parameters: {
     type: "object",
     properties: {}
@@ -138,16 +150,45 @@ var listSolfaceThemes = {
   handler() {
     return Object.keys(PRESET_THEMES).map((name) => ({
       name,
-      description: THEME_DESCRIPTIONS[name] ?? ""
+      description: THEME_DESCRIPTIONS[name] ?? "",
+      reactOnly: name.startsWith("glass") || name.startsWith("pixel")
     }));
   }
 };
+var deriveSolname = {
+  name: "derive_solname",
+  description: "Derive a deterministic name from a Solana wallet address using SHA-256 hashing. Returns human-friendly names like 'SunnyIcon'. Same wallet always produces the same name. ~1M display name combinations, ~65.5B unique tag combinations.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      format: {
+        type: "string",
+        description: "Name format: 'short' (adjective only), 'display' (adj+noun, default), 'tag' (adj+noun+#hex, unique), 'full' (adj+noun-adj+noun). Omit for full identity bundle.",
+        enum: ["short", "display", "tag", "full"]
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const format = params.format;
+    if (format) {
+      return deriveName(wallet, format);
+    }
+    return deriveIdentity(wallet);
+  }
+};
 var SOLFACE_TOOLS = [
   generateSolfaceSvg,
   describeSolface,
   getSolfaceTraits,
   getAgentIdentity,
-  listSolfaceThemes
+  listSolfaceThemes,
+  deriveSolname
 ];
 
 // src/agent/index.ts
@@ -207,5 +248,5 @@ function allToolsVercelAI() {
 }
 
 export { SOLFACE_TOOLS, allToolsAnthropic, allToolsMCP, allToolsOpenAI, allToolsVercelAI, handleToolCall, toAnthropic, toMCP, toOpenAI, toVercelAI };
-//# sourceMappingURL=chunk-RX6D5FGH.js.map
-//# sourceMappingURL=chunk-RX6D5FGH.js.map
+//# sourceMappingURL=chunk-77SPWQU5.js.map
+//# sourceMappingURL=chunk-77SPWQU5.js.map

package/dist/chunk-77SPWQU5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":[],"mappings":"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","file":"chunk-77SPWQU5.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES v2 — AI Agent Tool Definitions\n// Canonical, framework-agnostic tool schemas with handlers.\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG } from \"../core/renderer\";\nimport { describeAppearance, agentAppearancePrompt } from \"../core/describe\";\nimport {\n  generateTraits,\n  getTraitLabels,\n  traitHash,\n} from \"../core/traits\";\nimport { deriveName, deriveIdentity } from \"../names\";\nimport type { NameFormat } from \"../names\";\nimport { PRESET_THEMES, getPresetTheme } from \"../themes/presets\";\nimport type { SolFaceTheme } from \"../core/traits\";\n\n// ─── Types ───────────────────────────────────────\n\nexport interface JSONSchema {\n  type: string;\n  properties?: Record<string, JSONSchema & { description?: string; enum?: string[] }>;\n  required?: string[];\n  items?: JSONSchema;\n  description?: string;\n  enum?: string[];\n  default?: unknown;\n}\n\nexport interface SolFaceTool {\n  name: string;\n  description: string;\n  parameters: JSONSchema;\n  handler: (params: Record<string, unknown>) => unknown;\n}\n\n// ─── Tool: generate_solface_svg ──────────────────\n\nconst generateSolfaceSvg: SolFaceTool = {\n  name: \"generate_solface_svg\",\n  description:\n    \"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.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n      size: {\n        type: \"number\",\n        description: \"SVG width/height in pixels. Default: 64. Sizes >= 48 use full detail (gradients, specular highlights, cheek blush).\",\n      },\n      theme: {\n        type: \"string\",\n        description:\n          \"Preset theme name. 'flat' and 'transparent' work everywhere. 'glass', 'glassDark', 'pixel', 'pixelRetro', 'pixelClean' are React-only.\",\n        enum: [\"default\", \"dark\", \"light\", \"mono\", \"flat\", \"transparent\", \"glass\", \"glassDark\", \"pixel\", \"pixelRetro\", \"pixelClean\"],\n      },\n      enableBlink: {\n        type: \"boolean\",\n        description: \"Enable CSS blink animation on the eyes. Default: false\",\n      },\n      detail: {\n        type: \"string\",\n        description: \"Detail level: 'full' (gradients, cheeks, specular), 'simplified' (flat shapes), 'auto' (full if size >= 48). Default: auto\",\n        enum: [\"full\", \"simplified\", \"auto\"],\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const size = (params.size as number) ?? 64;\n    const enableBlink = (params.enableBlink as boolean) ?? false;\n    const detail = (params.detail as \"full\" | \"simplified\" | \"auto\") ?? \"auto\";\n    const themeName = params.theme as string | undefined;\n    const theme: SolFaceTheme | undefined = themeName\n      ? getPresetTheme(themeName)\n      : undefined;\n\n    return renderSolFaceSVG(wallet, { size, theme, enableBlink, detail });\n  },\n};\n\n// ─── Tool: describe_solface ──────────────────────\n\nconst describeSolface: SolFaceTool = {\n  name: \"describe_solface\",\n  description:\n    \"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.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n      format: {\n        type: \"string\",\n        description:\n          \"Output format: paragraph (flowing text), structured (labeled lines), compact (short comma-separated). Default: paragraph\",\n        enum: [\"paragraph\", \"structured\", \"compact\"],\n      },\n      perspective: {\n        type: \"string\",\n        description:\n          'Narrative perspective: \"first\" for self-description (\"I have...\"), \"third\" for external (\"This SolFace has...\"). Default: third',\n        enum: [\"first\", \"third\"],\n      },\n      name: {\n        type: \"string\",\n        description:\n          'Optional name to use instead of \"This SolFace\" or \"I\". E.g. \"Atlas\"',\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const name = (params.name as string | undefined) ?? deriveName(wallet, \"display\");\n    return describeAppearance(wallet, {\n      format: (params.format as \"paragraph\" | \"structured\" | \"compact\") ?? \"paragraph\",\n      perspective: (params.perspective as \"first\" | \"third\") ?? \"third\",\n      name,\n    });\n  },\n};\n\n// ─── Tool: get_solface_traits ────────────────────\n\nconst getSolfaceTraits: SolFaceTool = {\n  name: \"get_solface_traits\",\n  description:\n    \"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.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const traits = generateTraits(wallet);\n    const labels = getTraitLabels(traits);\n    const hash = traitHash(wallet);\n    const name = deriveName(wallet, \"display\");\n    return { traits, labels, hash, name };\n  },\n};\n\n// ─── Tool: get_agent_identity ────────────────────\n\nconst getAgentIdentity: SolFaceTool = {\n  name: \"get_agent_identity\",\n  description:\n    \"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.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"The agent's Solana wallet address (base58 public key)\",\n      },\n      agentName: {\n        type: \"string\",\n        description: 'Optional agent name to personalize the description. E.g. \"Atlas\"',\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const agentName = (params.agentName as string | undefined) ?? deriveName(wallet, \"display\");\n    return agentAppearancePrompt(wallet, agentName);\n  },\n};\n\n// ─── Tool: list_solface_themes ───────────────────\n\nconst THEME_DESCRIPTIONS: Record<string, string> = {\n  default: \"Base look with gradient-rich rendering — no overrides\",\n  dark: \"Dark backgrounds with muted tones and subtle border\",\n  light: \"Soft pastel backgrounds with rounded corners\",\n  mono: \"Full grayscale — all colors replaced with grays\",\n  flat: \"Disables all gradients — uses flat fill colors only\",\n  transparent: \"Transparent background with flat rendering\",\n  glass: \"Liquid glass effect with backdrop blur and specular highlights (React-only)\",\n  glassDark: \"Dark variant of liquid glass with deeper blur (React-only)\",\n  pixel: \"Pixel art mode at 16px density with rounded corners (React-only)\",\n  pixelRetro: \"Retro pixel art with scanlines and drop shadow (React-only)\",\n  pixelClean: \"Clean pixel art at 24px density (React-only)\",\n};\n\nconst listSolfaceThemes: SolFaceTool = {\n  name: \"list_solface_themes\",\n  description:\n    \"List all available SolFace preset themes with descriptions. Themes control colors, gradients, borders, and rendering modes. Some themes (glass, pixel) are React-only.\",\n  parameters: {\n    type: \"object\",\n    properties: {},\n  },\n  handler() {\n    return Object.keys(PRESET_THEMES).map((name) => ({\n      name,\n      description: THEME_DESCRIPTIONS[name] ?? \"\",\n      reactOnly: name.startsWith(\"glass\") || name.startsWith(\"pixel\"),\n    }));\n  },\n};\n\n// ─── Tool: derive_solname ────────────────────────\n\nconst deriveSolname: SolFaceTool = {\n  name: \"derive_solname\",\n  description:\n    \"Derive a deterministic name from a Solana wallet address using SHA-256 hashing. Returns human-friendly names like 'SunnyIcon'. Same wallet always produces the same name. ~1M display name combinations, ~65.5B unique tag combinations.\",\n  parameters: {\n    type: \"object\",\n    properties: {\n      wallet: {\n        type: \"string\",\n        description: \"Solana wallet address (base58 public key)\",\n      },\n      format: {\n        type: \"string\",\n        description:\n          \"Name format: 'short' (adjective only), 'display' (adj+noun, default), 'tag' (adj+noun+#hex, unique), 'full' (adj+noun-adj+noun). Omit for full identity bundle.\",\n        enum: [\"short\", \"display\", \"tag\", \"full\"],\n      },\n    },\n    required: [\"wallet\"],\n  },\n  handler(params) {\n    const wallet = params.wallet as string;\n    const format = params.format as NameFormat | undefined;\n    if (format) {\n      return deriveName(wallet, format);\n    }\n    return deriveIdentity(wallet);\n  },\n};\n\n// ─── Export All Tools ────────────────────────────\n\nexport const SOLFACE_TOOLS: SolFaceTool[] = [\n  generateSolfaceSvg,\n  describeSolface,\n  getSolfaceTraits,\n  getAgentIdentity,\n  listSolfaceThemes,\n  deriveSolname,\n];\n","// ═══════════════════════════════════════════════════════════════\n// SOLFACES — Agent Integration Barrel + Format Adapters\n// Convert SolFace tools to any AI agent framework format.\n// ═══════════════════════════════════════════════════════════════\n\nexport { SOLFACE_TOOLS } from \"./tools\";\nexport type { SolFaceTool, JSONSchema } from \"./tools\";\n\nimport { SOLFACE_TOOLS } from \"./tools\";\nimport type { SolFaceTool, JSONSchema } from \"./tools\";\n\n// ─── Unified Dispatcher ─────────────────────────\n\n/**\n * Handle a tool call by name. Works as a universal dispatcher for\n * any framework — just pass the tool name and parameters.\n *\n * @example\n * ```ts\n * const svg = await handleToolCall(\"generate_solface_svg\", {\n *   wallet: \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\"\n * });\n * ```\n */\nexport async function handleToolCall(\n  name: string,\n  params: Record<string, unknown>,\n): Promise<unknown> {\n  const tool = SOLFACE_TOOLS.find((t) => t.name === name);\n  if (!tool) {\n    throw new Error(`Unknown SolFace tool: \"${name}\". Available: ${SOLFACE_TOOLS.map((t) => t.name).join(\", \")}`);\n  }\n  return tool.handler(params);\n}\n\n// ─── MCP Format ─────────────────────────────────\n// Model Context Protocol (Claude Code, Cursor, Windsurf)\n\nexport interface MCPTool {\n  name: string;\n  description: string;\n  inputSchema: JSONSchema;\n}\n\nexport function toMCP(tool: SolFaceTool): MCPTool {\n  return {\n    name: tool.name,\n    description: tool.description,\n    inputSchema: tool.parameters,\n  };\n}\n\nexport function allToolsMCP(): MCPTool[] {\n  return SOLFACE_TOOLS.map(toMCP);\n}\n\n// ─── OpenAI Format ──────────────────────────────\n// OpenAI function calling / GPT Actions\n\nexport interface OpenAITool {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: JSONSchema;\n  };\n}\n\nexport function toOpenAI(tool: SolFaceTool): OpenAITool {\n  return {\n    type: \"function\",\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.parameters,\n    },\n  };\n}\n\nexport function allToolsOpenAI(): OpenAITool[] {\n  return SOLFACE_TOOLS.map(toOpenAI);\n}\n\n// ─── Anthropic Format ───────────────────────────\n// Anthropic tool use (Claude API)\n\nexport interface AnthropicTool {\n  name: string;\n  description: string;\n  input_schema: JSONSchema;\n}\n\nexport function toAnthropic(tool: SolFaceTool): AnthropicTool {\n  return {\n    name: tool.name,\n    description: tool.description,\n    input_schema: tool.parameters,\n  };\n}\n\nexport function allToolsAnthropic(): AnthropicTool[] {\n  return SOLFACE_TOOLS.map(toAnthropic);\n}\n\n// ─── Vercel AI SDK Format ───────────────────────\n// For use with Vercel AI SDK's `tool()` helper\n\nexport interface VercelAITool {\n  description: string;\n  parameters: JSONSchema;\n  execute: (params: Record<string, unknown>) => Promise<unknown>;\n}\n\nexport function toVercelAI(tool: SolFaceTool): VercelAITool {\n  return {\n    description: tool.description,\n    parameters: tool.parameters,\n    execute: async (params) => tool.handler(params),\n  };\n}\n\nexport function allToolsVercelAI(): Record<string, VercelAITool> {\n  const result: Record<string, VercelAITool> = {};\n  for (const tool of SOLFACE_TOOLS) {\n    result[tool.name] = toVercelAI(tool);\n  }\n  return result;\n}\n"]}