solfaces 2.1.1 → 2.2.0

package/README.md

@@ -4,6 +4,8 @@
 [![npm downloads](https://img.shields.io/npm/dw/solfaces)](https://www.npmjs.com/package/solfaces)
 [![license](https://img.shields.io/npm/l/solfaces)](https://github.com/jorger3301/SolFaces/blob/main/LICENSE)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/solfaces)](https://bundlephobia.com/package/solfaces)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
+[![CI](https://github.com/jorger3301/SolFaces/actions/workflows/ci.yml/badge.svg)](https://github.com/jorger3301/SolFaces/actions/workflows/ci.yml)
 
 **Deterministic wallet avatars and names for the Solana ecosystem.**
 
@@ -19,10 +21,10 @@ Built for dApps, AI agents, social features, leaderboards, and anywhere a wallet
 
 ## Why SolFaces?
 
-- **Deterministic** — Same wallet always produces the same avatar. No database needed.
+- **Deterministic** — Same wallet address always produces a unique avatar and name. No database needed.
 - **Zero dependencies** — Core engine has no runtime dependencies.
 - **~2.56B unique faces** — 11 traits with expanded ranges = massive combination space.
-- **SolNames** — Every wallet gets a deterministic, human-friendly name derived via SHA-256 (e.g. "SunnyIcon"). ~1M display names, ~65.5B unique tags.
+- **SolNames** — Every wallet gets a deterministic, human-friendly name derived via SHA-256 (e.g. "Sunny Icon"). ~1M display names, ~65.5B unique tags.
 - **11 built-in themes** — Default, Dark, Light, Mono, Flat, Transparent, plus 3 Pixel and 2 Glass themes (React).
 - **Gradient-rich rendering** — Skin-luminance-driven colors, specular highlights, cheek blush, gradient hair, glow overlays.
 - **Works everywhere** — React, vanilla JS, Node, Python, CDN script tag, edge functions.
@@ -121,13 +123,13 @@ mountSolFace("#avatar", "7xKXqR...", { size: 48 });
 import { deriveName, deriveIdentity } from "solfaces";
 
 deriveName("7xKXqR...");
-// → "SunnyIcon" (deterministic, SHA-256 derived)
+// → "Sunny Icon" (deterministic, SHA-256 derived)
 
 deriveName("7xKXqR...", "tag");
-// → "SunnyIcon#2f95" (unique identifier)
+// → "Sunny Icon#2f95" (unique identifier)
 
 deriveName("7xKXqR...", "full");
-// → "SunnyIcon-InfiniteOre" (formal contexts)
+// → "Sunny Icon-Infinite Ore" (formal contexts)
 
 const id = deriveIdentity("7xKXqR...");
 // → { short, name, tag, full, adjective, noun, hash, discriminator }
@@ -168,8 +170,8 @@ SHA-256("solnames-v1:" + wallet) → 32 bytes
         ├─→ Bytes 0-3: seed PRNG → adjective + noun
         └─→ Bytes 8-9: hex discriminator → "2f95"
 
-Display:  WavingMistral
-Tag:      WavingMistral#2f95
+Display:  Waving Mistral
+Tag:      Waving Mistral#2f95
 ```
 
 ### Name Formats
@@ -177,9 +179,9 @@ Tag:      WavingMistral#2f95
 | Format  | Example                      | Unique Names | Use Case                    |
 |---------|------------------------------|-------------|-----------------------------|
 | short   | "Waving"                     | 1,000       | Tight UIs, badges           |
-| display | "WavingMistral"              | ~1,000,000  | Default — profiles, feeds   |
-| tag     | "WavingMistral#2f95"         | ~65.5B      | Unique identifier           |
-| full    | "WavingMistral-InfiniteOre"  | ~1T         | Formal contexts             |
+| display | "Waving Mistral"             | ~1,000,000  | Default — profiles, feeds   |
+| tag     | "Waving Mistral#2f95"        | ~65.5B      | Unique identifier           |
+| full    | "Waving Mistral-Infinite Ore" | ~1T        | Formal contexts             |
 
 ### Usage
 
@@ -187,10 +189,10 @@ Tag:      WavingMistral#2f95
 import { deriveName, deriveIdentity } from "solfaces";
 // or: import { deriveName } from "solfaces/names";
 
-deriveName("7xKXqR...");           // → "SunnyIcon" (display format)
+deriveName("7xKXqR...");           // → "Sunny Icon" (display format)
 deriveName("7xKXqR...", "short");  // → "Sunny"
-deriveName("7xKXqR...", "tag");    // → "SunnyIcon#2f95"
-deriveName("7xKXqR...", "full");   // → "SunnyIcon-InfiniteOre"
+deriveName("7xKXqR...", "tag");    // → "Sunny Icon#2f95"
+deriveName("7xKXqR...", "full");   // → "Sunny Icon-Infinite Ore"
 
 const id = deriveIdentity("7xKXqR...");
 // → { short, name, tag, full, adjective, noun, hash, discriminator }
@@ -222,9 +224,9 @@ import { SolFace } from "solfaces/react";
 ```ts
 import { isValidSolName, parseSolName } from "solfaces/names";
 
-isValidSolName("SunnyIcon");         // true
-isValidSolName("SunnyIcon#2f95");    // true
-parseSolName("SunnyIcon#2f95");
+isValidSolName("Sunny Icon");         // true
+isValidSolName("Sunny Icon#2f95");    // true
+parseSolName("Sunny Icon#2f95");
 // → { adjective: "Sunny", noun: "Icon", discriminator: "2f95" }
 ```
 

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: solfaces
-description: Generates deterministic avatars and names for Solana wallet addresses. Use when the user mentions wallet avatars, profile pictures, visual identity, SolFaces, or needs to represent a Solana wallet visually. Provides SVG rendering, natural language descriptions, SHA-256 name derivation, and AI agent identity prompts. 6 tools available.
+description: Generates deterministic avatars and names for Solana wallet addresses. Use when the user mentions wallet avatars, profile pictures, visual identity, SolFaces, Solana PFP, deterministic identity, wallet names, or needs to represent a Solana wallet visually or with a human-readable name. Provides SVG rendering, natural language descriptions, SHA-256 name derivation, and AI agent identity prompts. 6 tools available.
 ---
 
 # SolFaces
@@ -43,6 +43,8 @@ Returns: description string. Auto-populates `name` from `deriveName(wallet, "dis
 ### `get_solface_traits`
 Raw trait data with human-readable labels and hash.
 
+**When to use:** User wants to inspect raw trait values, compare wallets, or build custom rendering logic.
+
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `wallet` | string | Yes | Solana wallet address |
@@ -52,6 +54,8 @@ Returns: `{ traits: SolFaceTraits, labels: Record<string, string>, hash: string,
 ### `get_agent_identity`
 System prompt snippet giving an AI agent a visual identity.
 
+**When to use:** User is building an AI agent and wants to give it a visual identity tied to a wallet.
+
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `wallet` | string | Yes | Agent's wallet address |
@@ -74,6 +78,8 @@ Returns: Without format: `SolNameIdentity` object (short/name/tag/full/adjective
 ### `list_solface_themes`
 List available preset themes with descriptions.
 
+**When to use:** User wants to see available themes or choose a visual style.
+
 No parameters. Returns: Array of `{ name, description, reactOnly }`.
 
 ---
@@ -124,8 +130,8 @@ const svg = renderSolFaceSVG("7xKXtg...", { size: 256 });
 ### Name derivation
 ```ts
 import { deriveName, deriveIdentity } from "solfaces";
-deriveName("7xKXtg...");           // "SunnyIcon"
-deriveName("7xKXtg...", "tag");    // "SunnyIcon#2f95"
+deriveName("7xKXtg...");           // "Sunny Icon"
+deriveName("7xKXtg...", "tag");    // "Sunny Icon#2f95"
 const id = deriveIdentity("7xKXtg...");  // full identity object
 ```
 

package/dist/agent/index.cjs

@@ -1,52 +1,52 @@
 'use strict';
 
-var chunk4YFZ4W2Y_cjs = require('../chunk-4YFZ4W2Y.cjs');
+var chunkPVJR3SFG_cjs = require('../chunk-PVJR3SFG.cjs');
 require('../chunk-TYTBYDQU.cjs');
 require('../chunk-F54WHRCE.cjs');
 require('../chunk-6QRDULAO.cjs');
-require('../chunk-XXJJH56O.cjs');
+require('../chunk-YGD7EQEX.cjs');
 
 
 
 Object.defineProperty(exports, "SOLFACE_TOOLS", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.SOLFACE_TOOLS; }
+  get: function () { return chunkPVJR3SFG_cjs.SOLFACE_TOOLS; }
 });
 Object.defineProperty(exports, "allToolsAnthropic", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.allToolsAnthropic; }
+  get: function () { return chunkPVJR3SFG_cjs.allToolsAnthropic; }
 });
 Object.defineProperty(exports, "allToolsMCP", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.allToolsMCP; }
+  get: function () { return chunkPVJR3SFG_cjs.allToolsMCP; }
 });
 Object.defineProperty(exports, "allToolsOpenAI", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.allToolsOpenAI; }
+  get: function () { return chunkPVJR3SFG_cjs.allToolsOpenAI; }
 });
 Object.defineProperty(exports, "allToolsVercelAI", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.allToolsVercelAI; }
+  get: function () { return chunkPVJR3SFG_cjs.allToolsVercelAI; }
 });
 Object.defineProperty(exports, "handleToolCall", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.handleToolCall; }
+  get: function () { return chunkPVJR3SFG_cjs.handleToolCall; }
 });
 Object.defineProperty(exports, "toAnthropic", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.toAnthropic; }
+  get: function () { return chunkPVJR3SFG_cjs.toAnthropic; }
 });
 Object.defineProperty(exports, "toMCP", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.toMCP; }
+  get: function () { return chunkPVJR3SFG_cjs.toMCP; }
 });
 Object.defineProperty(exports, "toOpenAI", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.toOpenAI; }
+  get: function () { return chunkPVJR3SFG_cjs.toOpenAI; }
 });
 Object.defineProperty(exports, "toVercelAI", {
   enumerable: true,
-  get: function () { return chunk4YFZ4W2Y_cjs.toVercelAI; }
+  get: function () { return chunkPVJR3SFG_cjs.toVercelAI; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/agent/index.js

@@ -1,7 +1,7 @@
-export { SOLFACE_TOOLS, allToolsAnthropic, allToolsMCP, allToolsOpenAI, allToolsVercelAI, handleToolCall, toAnthropic, toMCP, toOpenAI, toVercelAI } from '../chunk-66PSL4YO.js';
+export { SOLFACE_TOOLS, allToolsAnthropic, allToolsMCP, allToolsOpenAI, allToolsVercelAI, handleToolCall, toAnthropic, toMCP, toOpenAI, toVercelAI } from '../chunk-74CSG63X.js';
 import '../chunk-CKHLRORB.js';
 import '../chunk-3CE7Q44S.js';
 import '../chunk-DRUSCLEF.js';
-import '../chunk-N5DDJ3WQ.js';
+import '../chunk-UTT764K6.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/agent/mcp-server.cjs

@@ -2972,7 +2972,7 @@ var NOUNS = Object.freeze([
 var BLOCKED_COMBOS = Object.freeze(
   /* @__PURE__ */ new Set([
     // Add any discovered offensive adj+noun combinations here.
-    // Format: "AdjectiveNoun" (PascalCase, concatenated)
+    // Format: "Adjective Noun" (space-separated)
   ])
 );
 
@@ -3018,11 +3018,12 @@ function deriveIdentity(wallet, options) {
   const adj2 = adjectives[Math.floor(rng() * adjectives.length)];
   const noun2 = nouns[Math.floor(rng() * nouns.length)];
   const discriminator = hex.slice(16, 20);
+  const sep = options?.separator ?? " ";
   return {
     short: adj1,
-    name: adj1 + noun1,
-    tag: adj1 + noun1 + "#" + discriminator,
-    full: adj1 + noun1 + "-" + adj2 + noun2,
+    name: adj1 + sep + noun1,
+    tag: adj1 + sep + noun1 + "#" + discriminator,
+    full: adj1 + sep + noun1 + "-" + adj2 + sep + noun2,
     adjective: adj1,
     noun: noun1,
     hash: hex,
@@ -3358,7 +3359,7 @@ var listSolfaceThemes = {
 };
 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.",
+  description: "Derive a deterministic name from a Solana wallet address using SHA-256 hashing. Returns human-friendly names like 'Sunny Icon'. Same wallet always produces the same name. ~1M display name combinations, ~65.5B unique tag combinations.",
   parameters: {
     type: "object",
     properties: {
@@ -3368,7 +3369,7 @@ var deriveSolname = {
       },
       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.",
+        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"]
       }
     },

package/dist/{chunk-66PSL4YO.js → chunk-74CSG63X.js}

@@ -1,7 +1,7 @@
 import { describeAppearance, agentAppearancePrompt } from './chunk-CKHLRORB.js';
 import { renderSolFaceSVG, generateTraits, getTraitLabels, traitHash } from './chunk-3CE7Q44S.js';
 import { getPresetTheme, PRESET_THEMES } from './chunk-DRUSCLEF.js';
-import { deriveName, deriveIdentity } from './chunk-N5DDJ3WQ.js';
+import { deriveName, deriveIdentity } from './chunk-UTT764K6.js';
 
 // src/agent/tools.ts
 var generateSolfaceSvg = {
@@ -157,7 +157,7 @@ var listSolfaceThemes = {
 };
 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.",
+  description: "Derive a deterministic name from a Solana wallet address using SHA-256 hashing. Returns human-friendly names like 'Sunny Icon'. Same wallet always produces the same name. ~1M display name combinations, ~65.5B unique tag combinations.",
   parameters: {
     type: "object",
     properties: {
@@ -167,7 +167,7 @@ var deriveSolname = {
       },
       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.",
+        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"]
       }
     },
@@ -248,5 +248,5 @@ function allToolsVercelAI() {
 }
 
 export { SOLFACE_TOOLS, allToolsAnthropic, allToolsMCP, allToolsOpenAI, allToolsVercelAI, handleToolCall, toAnthropic, toMCP, toOpenAI, toVercelAI };
-//# sourceMappingURL=chunk-66PSL4YO.js.map
-//# sourceMappingURL=chunk-66PSL4YO.js.map
+//# sourceMappingURL=chunk-74CSG63X.js.map
+//# sourceMappingURL=chunk-74CSG63X.js.map

package/dist/{chunk-66PSL4YO.js.map → chunk-74CSG63X.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":[],"mappings":"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","file":"chunk-66PSL4YO.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"]}
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":[],"mappings":"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","file":"chunk-74CSG63X.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 'Sunny Icon'. 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"]}

package/dist/{chunk-4YFZ4W2Y.cjs → chunk-PVJR3SFG.cjs}

@@ -3,7 +3,7 @@
 var chunkTYTBYDQU_cjs = require('./chunk-TYTBYDQU.cjs');
 var chunkF54WHRCE_cjs = require('./chunk-F54WHRCE.cjs');
 var chunk6QRDULAO_cjs = require('./chunk-6QRDULAO.cjs');
-var chunkXXJJH56O_cjs = require('./chunk-XXJJH56O.cjs');
+var chunkYGD7EQEX_cjs = require('./chunk-YGD7EQEX.cjs');
 
 // src/agent/tools.ts
 var generateSolfaceSvg = {
@@ -76,7 +76,7 @@ var describeSolface = {
   },
   handler(params) {
     const wallet = params.wallet;
-    const name = params.name ?? chunkXXJJH56O_cjs.deriveName(wallet, "display");
+    const name = params.name ?? chunkYGD7EQEX_cjs.deriveName(wallet, "display");
     return chunkTYTBYDQU_cjs.describeAppearance(wallet, {
       format: params.format ?? "paragraph",
       perspective: params.perspective ?? "third",
@@ -102,7 +102,7 @@ var getSolfaceTraits = {
     const traits = chunkF54WHRCE_cjs.generateTraits(wallet);
     const labels = chunkF54WHRCE_cjs.getTraitLabels(traits);
     const hash = chunkF54WHRCE_cjs.traitHash(wallet);
-    const name = chunkXXJJH56O_cjs.deriveName(wallet, "display");
+    const name = chunkYGD7EQEX_cjs.deriveName(wallet, "display");
     return { traits, labels, hash, name };
   }
 };
@@ -125,7 +125,7 @@ var getAgentIdentity = {
   },
   handler(params) {
     const wallet = params.wallet;
-    const agentName = params.agentName ?? chunkXXJJH56O_cjs.deriveName(wallet, "display");
+    const agentName = params.agentName ?? chunkYGD7EQEX_cjs.deriveName(wallet, "display");
     return chunkTYTBYDQU_cjs.agentAppearancePrompt(wallet, agentName);
   }
 };
@@ -159,7 +159,7 @@ var listSolfaceThemes = {
 };
 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.",
+  description: "Derive a deterministic name from a Solana wallet address using SHA-256 hashing. Returns human-friendly names like 'Sunny Icon'. Same wallet always produces the same name. ~1M display name combinations, ~65.5B unique tag combinations.",
   parameters: {
     type: "object",
     properties: {
@@ -169,7 +169,7 @@ var deriveSolname = {
       },
       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.",
+        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"]
       }
     },
@@ -179,9 +179,9 @@ var deriveSolname = {
     const wallet = params.wallet;
     const format = params.format;
     if (format) {
-      return chunkXXJJH56O_cjs.deriveName(wallet, format);
+      return chunkYGD7EQEX_cjs.deriveName(wallet, format);
     }
-    return chunkXXJJH56O_cjs.deriveIdentity(wallet);
+    return chunkYGD7EQEX_cjs.deriveIdentity(wallet);
   }
 };
 var SOLFACE_TOOLS = [
@@ -259,5 +259,5 @@ exports.toAnthropic = toAnthropic;
 exports.toMCP = toMCP;
 exports.toOpenAI = toOpenAI;
 exports.toVercelAI = toVercelAI;
-//# sourceMappingURL=chunk-4YFZ4W2Y.cjs.map
-//# sourceMappingURL=chunk-4YFZ4W2Y.cjs.map
+//# sourceMappingURL=chunk-PVJR3SFG.cjs.map
+//# sourceMappingURL=chunk-PVJR3SFG.cjs.map

package/dist/{chunk-4YFZ4W2Y.cjs.map → chunk-PVJR3SFG.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":["getPresetTheme","renderSolFaceSVG","deriveName","describeAppearance","generateTraits","getTraitLabels","traitHash","agentAppearancePrompt","PRESET_THEMES","deriveIdentity"],"mappings":"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","file":"chunk-4YFZ4W2Y.cjs","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"]}
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":["getPresetTheme","renderSolFaceSVG","deriveName","describeAppearance","generateTraits","getTraitLabels","traitHash","agentAppearancePrompt","PRESET_THEMES","deriveIdentity"],"mappings":"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","file":"chunk-PVJR3SFG.cjs","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 'Sunny Icon'. 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"]}