@prometheusavatar/core 0.3.0 → 0.8.0

package/dist/index.d.ts

@@ -84,6 +84,22 @@ interface AvatarEventMap {
     };
     'destroy': void;
 }
+/** Standard chat message format (OpenAI-compatible) */
+interface ILLMMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** LLM Provider interface — implement this to plug in any LLM */
+interface ILLMProvider {
+    /** Provider name (e.g. "gemini", "groq", "deepseek") */
+    readonly name: string;
+    /** Whether this provider is available (has API key etc.) */
+    available(): boolean;
+    /** Generate a streaming response. Returns an async iterator of text tokens. */
+    stream(messages: ILLMMessage[]): AsyncIterable<string>;
+    /** Generate a non-streaming response. */
+    generate?(messages: ILLMMessage[]): Promise<string>;
+}
 
 /**
  * PrometheusAvatar — Main orchestrator class
@@ -346,4 +362,100 @@ declare class EmotionAnalyzer {
     analyze(text: string): EmotionResult;
 }
 
-export { type AvatarEventMap, type AvatarOptions, type Emotion, EmotionAnalyzer, type EmotionResult, type ITTSEngine, LipSyncEngine, type LipSyncFrame, Live2DRenderer, PrometheusAvatar, type PrometheusConfig, type TTSOptions, WebSpeechTTS, createAvatar };
+/**
+ * Prometheus AssetManager
+ *
+ * Handles loading, applying, and managing ALL marketplace asset categories:
+ * - Skins: Live2D .model3.json + textures
+ * - Voices: TTS voice config or audio samples
+ * - Motions: Live2D .motion3.json animations
+ * - Expressions: Live2D .exp3.json facial expressions
+ * - Effects: Particle/shader overlays (JSON config)
+ * - Scenes: Background images/videos
+ * - Personas: Personality prompt/behavior JSON
+ * - Accessories: Additional Live2D attachments
+ * - Bundles: Multi-asset packages
+ */
+type AssetCategory = "skins" | "voices" | "motions" | "expressions" | "effects" | "scenes" | "personas" | "accessories" | "bundles";
+interface AssetManifest {
+    id: string;
+    name: string;
+    category: AssetCategory;
+    fileUrl: string;
+    /** For bundles: list of sub-asset URLs */
+    files?: {
+        category: AssetCategory;
+        url: string;
+        name: string;
+    }[];
+    /** For voices: voice config */
+    voiceConfig?: {
+        lang?: string;
+        rate?: number;
+        pitch?: number;
+        voiceId?: string;
+    };
+    /** For personas: system prompt */
+    persona?: {
+        systemPrompt: string;
+        traits?: string[];
+        greeting?: string;
+    };
+    /** For effects: particle config */
+    effectConfig?: {
+        type: string;
+        color?: string;
+        density?: number;
+        speed?: number;
+    };
+    /** For scenes: scene config */
+    sceneConfig?: {
+        type: "image" | "video" | "gradient";
+        loop?: boolean;
+    };
+}
+interface AssetManagerCallbacks {
+    onSkinLoaded?: (modelUrl: string) => void;
+    onVoiceChanged?: (config: AssetManifest["voiceConfig"]) => void;
+    onMotionPlay?: (motionUrl: string) => void;
+    onExpressionLoaded?: (expressionUrl: string) => void;
+    onEffectApplied?: (config: AssetManifest["effectConfig"]) => void;
+    onSceneChanged?: (sceneUrl: string, config: AssetManifest["sceneConfig"]) => void;
+    onPersonaLoaded?: (persona: AssetManifest["persona"]) => void;
+    onAccessoryAdded?: (accessoryUrl: string) => void;
+    onError?: (error: Error, category: AssetCategory) => void;
+}
+declare class AssetManager {
+    private appliedAssets;
+    private callbacks;
+    private sceneElement;
+    private effectCanvas;
+    constructor(callbacks?: AssetManagerCallbacks);
+    /**
+     * Apply an asset from the marketplace.
+     * Fetches the file, determines category, and applies it.
+     */
+    applyAsset(manifest: AssetManifest): Promise<void>;
+    private applySkin;
+    private applyVoice;
+    private applyMotion;
+    private applyExpression;
+    private applyEffect;
+    private applyScene;
+    private applyPersona;
+    private applyAccessory;
+    private applyBundle;
+    private parseVoiceFromUrl;
+    /** Get all currently applied assets */
+    getApplied(): Map<AssetCategory, AssetManifest>;
+    /** Remove an applied asset */
+    removeAsset(category: AssetCategory): void;
+    /** Get file format requirements for each category */
+    static getFormatRequirements(): Record<AssetCategory, {
+        formats: string[];
+        maxSize: string;
+        description: string;
+    }>;
+}
+
+export { type AssetCategory, AssetManager, type AssetManagerCallbacks, type AssetManifest, type AvatarEventMap, type AvatarOptions, type Emotion, EmotionAnalyzer, type EmotionResult, type ILLMMessage, type ILLMProvider, type ITTSEngine, LipSyncEngine, type LipSyncFrame, Live2DRenderer, PrometheusAvatar, type PrometheusConfig, type TTSOptions, WebSpeechTTS, createAvatar };

package/dist/index.js

@@ -815,7 +815,162 @@ async function createAvatar(options) {
   await avatar.init();
   return avatar;
 }
+
+// src/asset-manager.ts
+var AssetManager = class {
+  constructor(callbacks = {}) {
+    this.appliedAssets = /* @__PURE__ */ new Map();
+    this.sceneElement = null;
+    this.effectCanvas = null;
+    this.callbacks = callbacks;
+  }
+  /**
+   * Apply an asset from the marketplace.
+   * Fetches the file, determines category, and applies it.
+   */
+  async applyAsset(manifest) {
+    try {
+      switch (manifest.category) {
+        case "skins":
+          await this.applySkin(manifest);
+          break;
+        case "voices":
+          this.applyVoice(manifest);
+          break;
+        case "motions":
+          await this.applyMotion(manifest);
+          break;
+        case "expressions":
+          await this.applyExpression(manifest);
+          break;
+        case "effects":
+          this.applyEffect(manifest);
+          break;
+        case "scenes":
+          this.applyScene(manifest);
+          break;
+        case "personas":
+          this.applyPersona(manifest);
+          break;
+        case "accessories":
+          await this.applyAccessory(manifest);
+          break;
+        case "bundles":
+          await this.applyBundle(manifest);
+          break;
+      }
+      this.appliedAssets.set(manifest.category, manifest);
+    } catch (error) {
+      this.callbacks.onError?.(error, manifest.category);
+      throw error;
+    }
+  }
+  // ═══ Category-specific apply methods ═══
+  async applySkin(manifest) {
+    this.callbacks.onSkinLoaded?.(manifest.fileUrl);
+  }
+  applyVoice(manifest) {
+    const config = manifest.voiceConfig || this.parseVoiceFromUrl(manifest.fileUrl);
+    this.callbacks.onVoiceChanged?.(config);
+  }
+  async applyMotion(manifest) {
+    this.callbacks.onMotionPlay?.(manifest.fileUrl);
+  }
+  async applyExpression(manifest) {
+    this.callbacks.onExpressionLoaded?.(manifest.fileUrl);
+  }
+  applyEffect(manifest) {
+    const config = manifest.effectConfig || { type: "particles", color: "#00d4aa", density: 50, speed: 1 };
+    this.callbacks.onEffectApplied?.(config);
+  }
+  applyScene(manifest) {
+    const config = manifest.sceneConfig || { type: "image" };
+    this.callbacks.onSceneChanged?.(manifest.fileUrl, config);
+  }
+  applyPersona(manifest) {
+    const persona = manifest.persona || { systemPrompt: "", traits: [] };
+    this.callbacks.onPersonaLoaded?.(persona);
+  }
+  async applyAccessory(manifest) {
+    this.callbacks.onAccessoryAdded?.(manifest.fileUrl);
+  }
+  async applyBundle(manifest) {
+    if (manifest.files) {
+      for (const file of manifest.files) {
+        await this.applyAsset({
+          id: `${manifest.id}_${file.category}`,
+          name: file.name,
+          category: file.category,
+          fileUrl: file.url
+        });
+      }
+    }
+  }
+  // ═══ Helpers ═══
+  parseVoiceFromUrl(url) {
+    return { lang: "en-US", rate: 1, pitch: 1 };
+  }
+  /** Get all currently applied assets */
+  getApplied() {
+    return new Map(this.appliedAssets);
+  }
+  /** Remove an applied asset */
+  removeAsset(category) {
+    this.appliedAssets.delete(category);
+  }
+  /** Get file format requirements for each category */
+  static getFormatRequirements() {
+    return {
+      skins: {
+        formats: [".model3.json", ".zip (with textures)"],
+        maxSize: "50MB",
+        description: "Live2D model package \u2014 includes .model3.json, textures (.png), and physics config"
+      },
+      voices: {
+        formats: [".json (voice config)", ".mp3", ".wav"],
+        maxSize: "20MB",
+        description: "Voice pack \u2014 TTS config JSON with lang/rate/pitch or audio sample files"
+      },
+      motions: {
+        formats: [".motion3.json", ".zip"],
+        maxSize: "10MB",
+        description: "Motion animations \u2014 Live2D motion3.json files for dance, idle, wave, etc."
+      },
+      expressions: {
+        formats: [".exp3.json", ".json"],
+        maxSize: "5MB",
+        description: "Expression presets \u2014 Live2D exp3.json or parameter preset JSON"
+      },
+      effects: {
+        formats: [".json (config)", ".zip"],
+        maxSize: "10MB",
+        description: "Visual effects \u2014 particle/shader config JSON with optional texture assets"
+      },
+      scenes: {
+        formats: [".png", ".jpg", ".webp", ".mp4", ".webm"],
+        maxSize: "30MB",
+        description: "Background scene \u2014 static image or looping video behind the avatar"
+      },
+      personas: {
+        formats: [".json"],
+        maxSize: "1MB",
+        description: "Persona config \u2014 JSON with systemPrompt, personalityTraits, and optional greeting"
+      },
+      accessories: {
+        formats: [".model3.json", ".png", ".zip"],
+        maxSize: "20MB",
+        description: "Accessories \u2014 Live2D overlay model or sprite images (ears, hats, glasses, etc.)"
+      },
+      bundles: {
+        formats: [".zip"],
+        maxSize: "100MB",
+        description: "Bundle \u2014 ZIP containing multiple assets with a manifest.json listing each item"
+      }
+    };
+  }
+};
 export {
+  AssetManager,
   EmotionAnalyzer,
   LipSyncEngine,
   Live2DRenderer,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@prometheusavatar/core",
-    "version": "0.3.0",
+    "version": "0.8.0",
     "description": "Give your AI agent an embodied avatar — Live2D rendering, TTS, lip-sync, and emotion analysis in one SDK",
     "type": "module",
     "main": "./dist/index.js",
@@ -19,16 +19,20 @@
     "scripts": {
         "build": "tsup src/index.ts --format esm --dts --clean",
         "dev": "tsup src/index.ts --format esm --dts --watch",
+        "test": "vitest run",
+        "test:watch": "vitest",
         "clean": "rm -rf dist",
         "lint": "tsc --noEmit"
     },
     "dependencies": {
-        "pixi.js": "^6.5.10",
-        "pixi-live2d-display": "^0.4.0"
+        "pixi-live2d-display": "^0.4.0",
+        "pixi.js": "^6.5.10"
     },
     "devDependencies": {
         "tsup": "^8.0.0",
-        "typescript": "^5.4.0"
+        "typedoc": "^0.28.17",
+        "typescript": "^5.4.0",
+        "vitest": "^4.0.18"
     },
     "keywords": [
         "live2d",
@@ -45,6 +49,6 @@
     "author": "Myths Labs (JC)",
     "repository": {
         "type": "git",
-        "url": "https://github.com/myths-labs/prometheus"
+        "url": "https://github.com/myths-labs/prometheus-avatar"
     }
 }