solfaces 1.0.0

package/dist/chunk-RX6D5FGH.js

@@ -0,0 +1,211 @@
+import { renderSolFaceSVG, describeAppearance, agentAppearancePrompt } from './chunk-KSGFMW33.js';
+import { generateTraits, getTraitLabels, traitHash } from './chunk-WURY4QGH.js';
+import { getPresetTheme, PRESET_THEMES } from './chunk-LQWJRHGC.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.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      size: {
+        type: "number",
+        description: "SVG width/height in pixels. Default: 64"
+      },
+      theme: {
+        type: "string",
+        description: "Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle",
+        enum: ["solana", "dark", "light", "mono", "neon", "jupiter", "phantom", "circle"]
+      },
+      enableBlink: {
+        type: "boolean",
+        description: "Enable CSS blink animation on the eyes. Default: false"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const size = params.size ?? 64;
+    const enableBlink = params.enableBlink ?? false;
+    const themeName = params.theme;
+    const theme = themeName ? getPresetTheme(themeName) : void 0;
+    return renderSolFaceSVG(wallet, { size, theme, enableBlink });
+  }
+};
+var describeSolface = {
+  name: "describe_solface",
+  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      format: {
+        type: "string",
+        description: "Output format: paragraph (flowing text), structured (labeled lines), compact (short comma-separated). Default: paragraph",
+        enum: ["paragraph", "structured", "compact"]
+      },
+      perspective: {
+        type: "string",
+        description: 'Narrative perspective: "first" for self-description ("I have..."), "third" for external ("This SolFace has..."). Default: third',
+        enum: ["first", "third"]
+      },
+      name: {
+        type: "string",
+        description: 'Optional name to use instead of "This SolFace" or "I". E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return describeAppearance(params.wallet, {
+      format: params.format ?? "paragraph",
+      perspective: params.perspective ?? "third",
+      name: params.name
+    });
+  }
+};
+var getSolfaceTraits = {
+  name: "get_solface_traits",
+  description: "Get the raw numeric trait values, human-readable labels, and deterministic hash for a wallet's SolFace avatar. Returns structured data useful for programmatic decisions about appearance.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const traits = generateTraits(wallet);
+    const labels = getTraitLabels(traits);
+    const hash = traitHash(wallet);
+    return { traits, labels, hash };
+  }
+};
+var getAgentIdentity = {
+  name: "get_agent_identity",
+  description: "Generate a system prompt snippet that gives an AI agent a visual identity based on its Solana wallet. The snippet describes the agent's appearance in first person and explains the deterministic nature of SolFace avatars.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "The agent's Solana wallet address (base58 public key)"
+      },
+      agentName: {
+        type: "string",
+        description: 'Optional agent name to personalize the description. E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return agentAppearancePrompt(
+      params.wallet,
+      params.agentName
+    );
+  }
+};
+var THEME_DESCRIPTIONS = {
+  solana: "Vibrant Solana brand colors (#14F195, #9945FF)",
+  dark: "Dark backgrounds with muted tones",
+  light: "Soft pastel backgrounds",
+  mono: "Full grayscale \u2014 all colors replaced with grays",
+  neon: "Cyberpunk high-contrast with neon accents and green border",
+  jupiter: "Jupiter aggregator dark blue palette with subtle border",
+  phantom: "Phantom wallet purple tones with subtle border",
+  circle: "Full circular border-radius (999px) for round avatars"
+};
+var listSolfaceThemes = {
+  name: "list_solface_themes",
+  description: "List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
+  handler() {
+    return Object.keys(PRESET_THEMES).map((name) => ({
+      name,
+      description: THEME_DESCRIPTIONS[name] ?? ""
+    }));
+  }
+};
+var SOLFACE_TOOLS = [
+  generateSolfaceSvg,
+  describeSolface,
+  getSolfaceTraits,
+  getAgentIdentity,
+  listSolfaceThemes
+];
+
+// src/agent/index.ts
+async function handleToolCall(name, params) {
+  const tool = SOLFACE_TOOLS.find((t) => t.name === name);
+  if (!tool) {
+    throw new Error(`Unknown SolFace tool: "${name}". Available: ${SOLFACE_TOOLS.map((t) => t.name).join(", ")}`);
+  }
+  return tool.handler(params);
+}
+function toMCP(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.parameters
+  };
+}
+function allToolsMCP() {
+  return SOLFACE_TOOLS.map(toMCP);
+}
+function toOpenAI(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: tool.parameters
+    }
+  };
+}
+function allToolsOpenAI() {
+  return SOLFACE_TOOLS.map(toOpenAI);
+}
+function toAnthropic(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    input_schema: tool.parameters
+  };
+}
+function allToolsAnthropic() {
+  return SOLFACE_TOOLS.map(toAnthropic);
+}
+function toVercelAI(tool) {
+  return {
+    description: tool.description,
+    parameters: tool.parameters,
+    execute: async (params) => tool.handler(params)
+  };
+}
+function allToolsVercelAI() {
+  const result = {};
+  for (const tool of SOLFACE_TOOLS) {
+    result[tool.name] = toVercelAI(tool);
+  }
+  return result;
+}
+
+export { SOLFACE_TOOLS, allToolsAnthropic, allToolsMCP, allToolsOpenAI, allToolsVercelAI, handleToolCall, toAnthropic, toMCP, toOpenAI, toVercelAI };
+//# sourceMappingURL=chunk-RX6D5FGH.js.map
+//# sourceMappingURL=chunk-RX6D5FGH.js.map

package/dist/chunk-RX6D5FGH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":[],"mappings":"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","file":"chunk-RX6D5FGH.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — 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 { 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 that can be embedded in HTML, saved as a file, or converted to a data URI. The same wallet always produces the same face.\",\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\",\n      },\n      theme: {\n        type: \"string\",\n        description:\n          \"Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle\",\n        enum: [\"solana\", \"dark\", \"light\", \"mono\", \"neon\", \"jupiter\", \"phantom\", \"circle\"],\n      },\n      enableBlink: {\n        type: \"boolean\",\n        description: \"Enable CSS blink animation on the eyes. Default: false\",\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 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 });\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.\",\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    return describeAppearance(params.wallet as string, {\n      format: (params.format as \"paragraph\" | \"structured\" | \"compact\") ?? \"paragraph\",\n      perspective: (params.perspective as \"first\" | \"third\") ?? \"third\",\n      name: params.name as string | undefined,\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    return { traits, labels, hash };\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    return agentAppearancePrompt(\n      params.wallet as string,\n      params.agentName as string | undefined,\n    );\n  },\n};\n\n// ─── Tool: list_solface_themes ───────────────────\n\nconst THEME_DESCRIPTIONS: Record<string, string> = {\n  solana: \"Vibrant Solana brand colors (#14F195, #9945FF)\",\n  dark: \"Dark backgrounds with muted tones\",\n  light: \"Soft pastel backgrounds\",\n  mono: \"Full grayscale — all colors replaced with grays\",\n  neon: \"Cyberpunk high-contrast with neon accents and green border\",\n  jupiter: \"Jupiter aggregator dark blue palette with subtle border\",\n  phantom: \"Phantom wallet purple tones with subtle border\",\n  circle: \"Full circular border-radius (999px) for round avatars\",\n};\n\nconst listSolfaceThemes: SolFaceTool = {\n  name: \"list_solface_themes\",\n  description:\n    \"List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.\",\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    }));\n  },\n};\n\n// ─── Export All Tools ────────────────────────────\n\nexport const SOLFACE_TOOLS: SolFaceTool[] = [\n  generateSolfaceSvg,\n  describeSolface,\n  getSolfaceTraits,\n  getAgentIdentity,\n  listSolfaceThemes,\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-SNJABBAT.js

@@ -0,0 +1,107 @@
+import { renderSolFaceSVG } from './chunk-KSGFMW33.js';
+
+// src/core/rasterize.ts
+async function renderSolFacePNG(walletAddress, options) {
+  const { pngSize = 256, ...renderOpts } = options ?? {};
+  const svg = renderSolFaceSVG(walletAddress, {
+    ...renderOpts,
+    size: pngSize
+  });
+  const svgBuffer = Buffer.from(svg);
+  try {
+    const sharp = await import('sharp');
+    return await sharp.default(svgBuffer).resize(pngSize, pngSize).png().toBuffer();
+  } catch {
+  }
+  try {
+    const { Resvg } = await import('@resvg/resvg-js');
+    const resvg = new Resvg(svg, {
+      fitTo: { mode: "width", value: pngSize }
+    });
+    const pngData = resvg.render();
+    return Buffer.from(pngData.asPng());
+  } catch {
+  }
+  throw new Error(
+    "[SolFaces] PNG rasterization requires either `sharp` or `@resvg/resvg-js`. Install one: npm install sharp  OR  npm install @resvg/resvg-js"
+  );
+}
+async function renderSolFacePNGBrowser(walletAddress, options) {
+  const { pngSize = 256, ...renderOpts } = options ?? {};
+  const svg = renderSolFaceSVG(walletAddress, {
+    ...renderOpts,
+    size: pngSize
+  });
+  const svgBlob = new Blob([svg], { type: "image/svg+xml;charset=utf-8" });
+  const url = URL.createObjectURL(svgBlob);
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      let canvas;
+      let ctx;
+      if (typeof OffscreenCanvas !== "undefined") {
+        canvas = new OffscreenCanvas(pngSize, pngSize);
+        ctx = canvas.getContext("2d");
+      } else {
+        canvas = document.createElement("canvas");
+        canvas.width = pngSize;
+        canvas.height = pngSize;
+        ctx = canvas.getContext("2d");
+      }
+      if (!ctx) {
+        URL.revokeObjectURL(url);
+        reject(new Error("[SolFaces] Could not get canvas context"));
+        return;
+      }
+      ctx.drawImage(img, 0, 0, pngSize, pngSize);
+      URL.revokeObjectURL(url);
+      if (canvas instanceof OffscreenCanvas) {
+        canvas.convertToBlob({ type: "image/png" }).then(resolve).catch(reject);
+      } else {
+        canvas.toBlob((blob) => {
+          if (blob) resolve(blob);
+          else reject(new Error("[SolFaces] Canvas toBlob failed"));
+        }, "image/png");
+      }
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(url);
+      reject(new Error("[SolFaces] Failed to load SVG into image"));
+    };
+    img.src = url;
+  });
+}
+async function renderSolFacePNGDataURL(walletAddress, options) {
+  const { pngSize = 256, ...renderOpts } = options ?? {};
+  const svg = renderSolFaceSVG(walletAddress, {
+    ...renderOpts,
+    size: pngSize
+  });
+  const svgBlob = new Blob([svg], { type: "image/svg+xml;charset=utf-8" });
+  const url = URL.createObjectURL(svgBlob);
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      const canvas = document.createElement("canvas");
+      canvas.width = pngSize;
+      canvas.height = pngSize;
+      const ctx = canvas.getContext("2d");
+      if (!ctx) {
+        reject(new Error("[SolFaces] No canvas context"));
+        return;
+      }
+      ctx.drawImage(img, 0, 0, pngSize, pngSize);
+      URL.revokeObjectURL(url);
+      resolve(canvas.toDataURL("image/png"));
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(url);
+      reject(new Error("[SolFaces] SVG load failed"));
+    };
+    img.src = url;
+  });
+}
+
+export { renderSolFacePNG, renderSolFacePNGBrowser, renderSolFacePNGDataURL };
+//# sourceMappingURL=chunk-SNJABBAT.js.map
+//# sourceMappingURL=chunk-SNJABBAT.js.map

package/dist/chunk-SNJABBAT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/rasterize.ts"],"names":[],"mappings":"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","file":"chunk-SNJABBAT.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — PNG Rasterizer\n// Converts SolFace SVGs to PNG buffers for use in bots, APIs,\n// Discord embeds, Telegram, emails, and non-SVG contexts.\n//\n// Works in:\n//   - Node.js (via sharp or canvas fallback)\n//   - Browser (via OffscreenCanvas or <canvas>)\n//   - Edge functions (via resvg-wasm)\n// ═══════════════════════════════════════════════════════════════\n\nimport { renderSolFaceSVG, type RenderOptions } from \"./renderer\";\n\nexport interface PNGOptions extends RenderOptions {\n  /** Output pixel size (both width and height). Default: 256 */\n  pngSize?: number;\n  /** PNG quality (0-1, only affects some renderers). Default: 1 */\n  quality?: number;\n}\n\n// ─── Node.js Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Buffer using `sharp`.\n * Requires: `npm install sharp`\n *\n * @returns PNG buffer\n *\n * @example\n * ```ts\n * import { renderSolFacePNG } from \"solfaces/core/rasterize\";\n *\n * const png = await renderSolFacePNG(\"7xKXq...\", { pngSize: 256 });\n * fs.writeFileSync(\"avatar.png\", png);\n * ```\n */\nexport async function renderSolFacePNG(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Buffer> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  // Generate SVG at the target resolution\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n  const svgBuffer = Buffer.from(svg);\n\n  // Try sharp first (best quality, most common in Node)\n  try {\n    const sharp = await import(\"sharp\");\n    return await sharp\n      .default(svgBuffer)\n      .resize(pngSize, pngSize)\n      .png()\n      .toBuffer();\n  } catch {\n    // sharp not installed — fall through\n  }\n\n  // Try @resvg/resvg-js (good for edge/serverless)\n  try {\n    const { Resvg } = await import(\"@resvg/resvg-js\");\n    const resvg = new Resvg(svg, {\n      fitTo: { mode: \"width\", value: pngSize },\n    });\n    const pngData = resvg.render();\n    return Buffer.from(pngData.asPng());\n  } catch {\n    // resvg not installed\n  }\n\n  throw new Error(\n    \"[SolFaces] PNG rasterization requires either `sharp` or `@resvg/resvg-js`. \" +\n    \"Install one: npm install sharp  OR  npm install @resvg/resvg-js\"\n  );\n}\n\n// ─── Browser Rasterization ───────────────────────────────────\n\n/**\n * Render a SolFace as a PNG Blob in the browser.\n * Uses Canvas API — works in all modern browsers.\n *\n * @returns PNG Blob\n *\n * @example\n * ```ts\n * const blob = await renderSolFacePNGBrowser(\"7xKXq...\", { pngSize: 256 });\n * const url = URL.createObjectURL(blob);\n * img.src = url;\n * ```\n */\nexport async function renderSolFacePNGBrowser(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<Blob> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  // Create image from SVG data URI\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<Blob>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      // Use OffscreenCanvas if available (better perf)\n      let canvas: HTMLCanvasElement | OffscreenCanvas;\n      let ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D | null;\n\n      if (typeof OffscreenCanvas !== \"undefined\") {\n        canvas = new OffscreenCanvas(pngSize, pngSize);\n        ctx = canvas.getContext(\"2d\");\n      } else {\n        canvas = document.createElement(\"canvas\");\n        canvas.width = pngSize;\n        canvas.height = pngSize;\n        ctx = canvas.getContext(\"2d\");\n      }\n\n      if (!ctx) {\n        URL.revokeObjectURL(url);\n        reject(new Error(\"[SolFaces] Could not get canvas context\"));\n        return;\n      }\n\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n\n      if (canvas instanceof OffscreenCanvas) {\n        canvas.convertToBlob({ type: \"image/png\" }).then(resolve).catch(reject);\n      } else {\n        canvas.toBlob((blob) => {\n          if (blob) resolve(blob);\n          else reject(new Error(\"[SolFaces] Canvas toBlob failed\"));\n        }, \"image/png\");\n      }\n    };\n\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] Failed to load SVG into image\"));\n    };\n\n    img.src = url;\n  });\n}\n\n/**\n * Render a SolFace as a PNG data URL in the browser.\n * Convenient for directly setting img.src without blob URLs.\n */\nexport async function renderSolFacePNGDataURL(\n  walletAddress: string,\n  options?: PNGOptions\n): Promise<string> {\n  const { pngSize = 256, ...renderOpts } = options ?? {};\n\n  const svg = renderSolFaceSVG(walletAddress, {\n    ...renderOpts,\n    size: pngSize,\n  });\n\n  const svgBlob = new Blob([svg], { type: \"image/svg+xml;charset=utf-8\" });\n  const url = URL.createObjectURL(svgBlob);\n\n  return new Promise<string>((resolve, reject) => {\n    const img = new Image();\n    img.onload = () => {\n      const canvas = document.createElement(\"canvas\");\n      canvas.width = pngSize;\n      canvas.height = pngSize;\n      const ctx = canvas.getContext(\"2d\");\n      if (!ctx) {\n        reject(new Error(\"[SolFaces] No canvas context\"));\n        return;\n      }\n      ctx.drawImage(img, 0, 0, pngSize, pngSize);\n      URL.revokeObjectURL(url);\n      resolve(canvas.toDataURL(\"image/png\"));\n    };\n    img.onerror = () => {\n      URL.revokeObjectURL(url);\n      reject(new Error(\"[SolFaces] SVG load failed\"));\n    };\n    img.src = url;\n  });\n}\n"]}

package/dist/chunk-VMNATBH3.cjs

@@ -0,0 +1,222 @@
+'use strict';
+
+var chunkH3SK3MNX_cjs = require('./chunk-H3SK3MNX.cjs');
+var chunk2DIKGLXZ_cjs = require('./chunk-2DIKGLXZ.cjs');
+var chunkCVFO7YHY_cjs = require('./chunk-CVFO7YHY.cjs');
+
+// src/agent/tools.ts
+var generateSolfaceSvg = {
+  name: "generate_solface_svg",
+  description: "Generate a deterministic SVG avatar for a Solana wallet address. Returns an SVG string that can be embedded in HTML, saved as a file, or converted to a data URI. The same wallet always produces the same face.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      size: {
+        type: "number",
+        description: "SVG width/height in pixels. Default: 64"
+      },
+      theme: {
+        type: "string",
+        description: "Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle",
+        enum: ["solana", "dark", "light", "mono", "neon", "jupiter", "phantom", "circle"]
+      },
+      enableBlink: {
+        type: "boolean",
+        description: "Enable CSS blink animation on the eyes. Default: false"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const size = params.size ?? 64;
+    const enableBlink = params.enableBlink ?? false;
+    const themeName = params.theme;
+    const theme = themeName ? chunkCVFO7YHY_cjs.getPresetTheme(themeName) : void 0;
+    return chunkH3SK3MNX_cjs.renderSolFaceSVG(wallet, { size, theme, enableBlink });
+  }
+};
+var describeSolface = {
+  name: "describe_solface",
+  description: "Generate a natural language description of a wallet's SolFace avatar. Useful for alt text, profile bios, system prompts, and accessibility.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      },
+      format: {
+        type: "string",
+        description: "Output format: paragraph (flowing text), structured (labeled lines), compact (short comma-separated). Default: paragraph",
+        enum: ["paragraph", "structured", "compact"]
+      },
+      perspective: {
+        type: "string",
+        description: 'Narrative perspective: "first" for self-description ("I have..."), "third" for external ("This SolFace has..."). Default: third',
+        enum: ["first", "third"]
+      },
+      name: {
+        type: "string",
+        description: 'Optional name to use instead of "This SolFace" or "I". E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return chunkH3SK3MNX_cjs.describeAppearance(params.wallet, {
+      format: params.format ?? "paragraph",
+      perspective: params.perspective ?? "third",
+      name: params.name
+    });
+  }
+};
+var getSolfaceTraits = {
+  name: "get_solface_traits",
+  description: "Get the raw numeric trait values, human-readable labels, and deterministic hash for a wallet's SolFace avatar. Returns structured data useful for programmatic decisions about appearance.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "Solana wallet address (base58 public key)"
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    const wallet = params.wallet;
+    const traits = chunk2DIKGLXZ_cjs.generateTraits(wallet);
+    const labels = chunk2DIKGLXZ_cjs.getTraitLabels(traits);
+    const hash = chunk2DIKGLXZ_cjs.traitHash(wallet);
+    return { traits, labels, hash };
+  }
+};
+var getAgentIdentity = {
+  name: "get_agent_identity",
+  description: "Generate a system prompt snippet that gives an AI agent a visual identity based on its Solana wallet. The snippet describes the agent's appearance in first person and explains the deterministic nature of SolFace avatars.",
+  parameters: {
+    type: "object",
+    properties: {
+      wallet: {
+        type: "string",
+        description: "The agent's Solana wallet address (base58 public key)"
+      },
+      agentName: {
+        type: "string",
+        description: 'Optional agent name to personalize the description. E.g. "Atlas"'
+      }
+    },
+    required: ["wallet"]
+  },
+  handler(params) {
+    return chunkH3SK3MNX_cjs.agentAppearancePrompt(
+      params.wallet,
+      params.agentName
+    );
+  }
+};
+var THEME_DESCRIPTIONS = {
+  solana: "Vibrant Solana brand colors (#14F195, #9945FF)",
+  dark: "Dark backgrounds with muted tones",
+  light: "Soft pastel backgrounds",
+  mono: "Full grayscale \u2014 all colors replaced with grays",
+  neon: "Cyberpunk high-contrast with neon accents and green border",
+  jupiter: "Jupiter aggregator dark blue palette with subtle border",
+  phantom: "Phantom wallet purple tones with subtle border",
+  circle: "Full circular border-radius (999px) for round avatars"
+};
+var listSolfaceThemes = {
+  name: "list_solface_themes",
+  description: "List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.",
+  parameters: {
+    type: "object",
+    properties: {}
+  },
+  handler() {
+    return Object.keys(chunkCVFO7YHY_cjs.PRESET_THEMES).map((name) => ({
+      name,
+      description: THEME_DESCRIPTIONS[name] ?? ""
+    }));
+  }
+};
+var SOLFACE_TOOLS = [
+  generateSolfaceSvg,
+  describeSolface,
+  getSolfaceTraits,
+  getAgentIdentity,
+  listSolfaceThemes
+];
+
+// src/agent/index.ts
+async function handleToolCall(name, params) {
+  const tool = SOLFACE_TOOLS.find((t) => t.name === name);
+  if (!tool) {
+    throw new Error(`Unknown SolFace tool: "${name}". Available: ${SOLFACE_TOOLS.map((t) => t.name).join(", ")}`);
+  }
+  return tool.handler(params);
+}
+function toMCP(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.parameters
+  };
+}
+function allToolsMCP() {
+  return SOLFACE_TOOLS.map(toMCP);
+}
+function toOpenAI(tool) {
+  return {
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: tool.parameters
+    }
+  };
+}
+function allToolsOpenAI() {
+  return SOLFACE_TOOLS.map(toOpenAI);
+}
+function toAnthropic(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    input_schema: tool.parameters
+  };
+}
+function allToolsAnthropic() {
+  return SOLFACE_TOOLS.map(toAnthropic);
+}
+function toVercelAI(tool) {
+  return {
+    description: tool.description,
+    parameters: tool.parameters,
+    execute: async (params) => tool.handler(params)
+  };
+}
+function allToolsVercelAI() {
+  const result = {};
+  for (const tool of SOLFACE_TOOLS) {
+    result[tool.name] = toVercelAI(tool);
+  }
+  return result;
+}
+
+exports.SOLFACE_TOOLS = SOLFACE_TOOLS;
+exports.allToolsAnthropic = allToolsAnthropic;
+exports.allToolsMCP = allToolsMCP;
+exports.allToolsOpenAI = allToolsOpenAI;
+exports.allToolsVercelAI = allToolsVercelAI;
+exports.handleToolCall = handleToolCall;
+exports.toAnthropic = toAnthropic;
+exports.toMCP = toMCP;
+exports.toOpenAI = toOpenAI;
+exports.toVercelAI = toVercelAI;
+//# sourceMappingURL=chunk-VMNATBH3.cjs.map
+//# sourceMappingURL=chunk-VMNATBH3.cjs.map

package/dist/chunk-VMNATBH3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/tools.ts","../src/agent/index.ts"],"names":["getPresetTheme","renderSolFaceSVG","describeAppearance","generateTraits","getTraitLabels","traitHash","agentAppearancePrompt","PRESET_THEMES"],"mappings":"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","file":"chunk-VMNATBH3.cjs","sourcesContent":["// ═══════════════════════════════════════════════════════════════\n// SOLFACES — 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 { 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 that can be embedded in HTML, saved as a file, or converted to a data URI. The same wallet always produces the same face.\",\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\",\n      },\n      theme: {\n        type: \"string\",\n        description:\n          \"Preset theme name: solana, dark, light, mono, neon, jupiter, phantom, circle\",\n        enum: [\"solana\", \"dark\", \"light\", \"mono\", \"neon\", \"jupiter\", \"phantom\", \"circle\"],\n      },\n      enableBlink: {\n        type: \"boolean\",\n        description: \"Enable CSS blink animation on the eyes. Default: false\",\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 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 });\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.\",\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    return describeAppearance(params.wallet as string, {\n      format: (params.format as \"paragraph\" | \"structured\" | \"compact\") ?? \"paragraph\",\n      perspective: (params.perspective as \"first\" | \"third\") ?? \"third\",\n      name: params.name as string | undefined,\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    return { traits, labels, hash };\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    return agentAppearancePrompt(\n      params.wallet as string,\n      params.agentName as string | undefined,\n    );\n  },\n};\n\n// ─── Tool: list_solface_themes ───────────────────\n\nconst THEME_DESCRIPTIONS: Record<string, string> = {\n  solana: \"Vibrant Solana brand colors (#14F195, #9945FF)\",\n  dark: \"Dark backgrounds with muted tones\",\n  light: \"Soft pastel backgrounds\",\n  mono: \"Full grayscale — all colors replaced with grays\",\n  neon: \"Cyberpunk high-contrast with neon accents and green border\",\n  jupiter: \"Jupiter aggregator dark blue palette with subtle border\",\n  phantom: \"Phantom wallet purple tones with subtle border\",\n  circle: \"Full circular border-radius (999px) for round avatars\",\n};\n\nconst listSolfaceThemes: SolFaceTool = {\n  name: \"list_solface_themes\",\n  description:\n    \"List all available SolFace preset themes with descriptions. Themes control colors, borders, backgrounds, and border-radius of generated avatars.\",\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    }));\n  },\n};\n\n// ─── Export All Tools ────────────────────────────\n\nexport const SOLFACE_TOOLS: SolFaceTool[] = [\n  generateSolfaceSvg,\n  describeSolface,\n  getSolfaceTraits,\n  getAgentIdentity,\n  listSolfaceThemes,\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"]}