noosphere 0.2.1 → 0.3.0

package/README.md

@@ -63,6 +63,56 @@ const audio = await ai.speak({
 
 Noosphere **automatically discovers the latest models from EVERY provider's API at runtime** — across **all 4 modalities** (LLM, image, video, TTS). When Google releases a new Gemini model, when OpenAI drops GPT-5, when FAL adds a new video model, when a new image model trends on HuggingFace — **you get them immediately**, without updating Noosphere or any dependency.
 
+### Provider Logos — SVG & PNG for Every Model
+
+Every model returned by the auto-fetch includes a `logo` field with the provider's official logo in SVG and PNG formats. For aggregator providers (OpenRouter, HuggingFace), logos are resolved to the **real upstream provider** — so an `x-ai/grok-4` model gets the xAI logo, not OpenRouter's.
+
+```typescript
+const models = await ai.getModels('llm');
+
+for (const model of models) {
+  console.log(model.id, model.logo);
+  // "gpt-5" { svg: "https://cdn.simpleicons.org/openai", png: "https://cdn.brandfetch.io/.../icon.png" }
+  // "claude-opus-4-6" { svg: "https://cdn.simpleicons.org/anthropic", png: "https://cdn.brandfetch.io/.../icon.png" }
+  // "gemini-2.5-pro" { svg: "https://cdn.simpleicons.org/google", png: "https://cdn.brandfetch.io/.../icon.png" }
+}
+
+// Providers also have logos:
+const providers = await ai.getProviders();
+providers.forEach(p => console.log(p.id, p.logo));
+
+// Use in your UI:
+// <img src={model.logo.svg} alt={model.provider} />
+```
+
+**Covered providers:** OpenAI, Anthropic, Google, Groq, Mistral, xAI, OpenRouter, Cerebras, Meta, DeepSeek, Microsoft, NVIDIA, Qwen, Cohere, Perplexity, Amazon, FAL, HuggingFace, ComfyUI, Piper, Kokoro, Ollama, SambaNova, Together, Fireworks, Replicate, Nebius, Novita.
+
+You can also import the logo registry directly:
+
+```typescript
+import { getProviderLogo, PROVIDER_LOGOS } from 'noosphere';
+
+const logo = getProviderLogo('anthropic');
+// { svg: "https://cdn.simpleicons.org/anthropic", png: "https://cdn.brandfetch.io/.../icon.png" }
+
+// Or access the full map:
+console.log(Object.keys(PROVIDER_LOGOS));
+// ['openai', 'anthropic', 'google', 'groq', 'mistral', 'xai', 'openrouter', ...]
+```
+
+For HuggingFace models with multiple inference providers, per-provider logos are available in `capabilities.inferenceProviderLogos`:
+
+```typescript
+const hfModels = await ai.getModels('llm');
+const qwen = hfModels.find(m => m.id === 'Qwen/Qwen2.5-72B-Instruct');
+
+console.log(qwen.capabilities.inferenceProviderLogos);
+// {
+//   "together": { svg: "https://cdn.simpleicons.org/togetherai", png: "..." },
+//   "fireworks-ai": { png: "https://cdn.brandfetch.io/.../icon.png" },
+// }
+```
+
 ### The Problem It Solves
 
 Traditional AI libraries rely on **static model catalogs** hardcoded at build time. The `@mariozechner/pi-ai` dependency ships with ~246 LLM models in a pre-generated `models.generated.js` file. HuggingFace providers typically hardcode 3-5 default models. When a provider releases a new model, you'd have to wait for the library maintainer to update, publish, and then you'd `npm update`. This lag can be days or weeks.

package/dist/index.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Noosphere: () => Noosphere,
-  NoosphereError: () => NoosphereError
+  NoosphereError: () => NoosphereError,
+  PROVIDER_LOGOS: () => PROVIDER_LOGOS,
+  getProviderLogo: () => getProviderLogo
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -53,6 +55,16 @@ var NoosphereError = class extends Error {
 };
 
 // src/config.ts
+var _envLoaded = false;
+function loadEnv() {
+  if (_envLoaded) return;
+  _envLoaded = true;
+  try {
+    const dotenvx = require("@dotenvx/dotenvx");
+    dotenvx.config({ quiet: true });
+  } catch {
+  }
+}
 var ENV_KEY_MAP = {
   openai: "OPENAI_API_KEY",
   anthropic: "ANTHROPIC_API_KEY",
@@ -76,6 +88,7 @@ var DEFAULT_RETRYABLE = [
   "TIMEOUT"
 ];
 function resolveConfig(input) {
+  loadEnv();
   const keys = {};
   for (const [name, envVar] of Object.entries(ENV_KEY_MAP)) {
     keys[name] = input.keys?.[name] ?? process.env[envVar];
@@ -117,6 +130,132 @@ function resolveConfig(input) {
   };
 }
 
+// src/logos.ts
+var PROVIDER_LOGOS = {
+  // --- Cloud LLM Providers ---
+  openai: {
+    svg: "https://cdn.simpleicons.org/openai",
+    png: "https://cdn.brandfetch.io/idR3duQxYl/w/512/h/512/theme/dark/icon.png"
+  },
+  anthropic: {
+    svg: "https://cdn.simpleicons.org/anthropic",
+    png: "https://cdn.brandfetch.io/id2S-kXbuM/w/512/h/512/theme/dark/icon.png"
+  },
+  google: {
+    svg: "https://cdn.simpleicons.org/google",
+    png: "https://cdn.brandfetch.io/id6O2oGzv-/w/512/h/512/theme/dark/icon.png"
+  },
+  groq: {
+    svg: "https://cdn.simpleicons.org/groq",
+    png: "https://cdn.brandfetch.io/idTEBPz5KO/w/512/h/512/theme/dark/icon.png"
+  },
+  mistral: {
+    svg: "https://cdn.simpleicons.org/mistral",
+    png: "https://cdn.brandfetch.io/idnBOFq5eF/w/512/h/512/theme/dark/icon.png"
+  },
+  xai: {
+    svg: "https://cdn.simpleicons.org/x",
+    png: "https://cdn.brandfetch.io/idS5WhqBbM/w/512/h/512/theme/dark/icon.png"
+  },
+  openrouter: {
+    svg: "https://openrouter.ai/favicon.svg",
+    png: "https://openrouter.ai/favicon.png"
+  },
+  cerebras: {
+    svg: "https://cdn.simpleicons.org/cerebras",
+    png: "https://cdn.brandfetch.io/idGa4PRFP0/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Media Providers ---
+  fal: {
+    svg: "https://fal.ai/favicon.svg",
+    png: "https://fal.ai/favicon.png"
+  },
+  huggingface: {
+    svg: "https://cdn.simpleicons.org/huggingface",
+    png: "https://cdn.brandfetch.io/idnrPPHe87/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Local Providers ---
+  comfyui: {
+    svg: "https://raw.githubusercontent.com/comfyanonymous/ComfyUI/master/web/assets/icon.svg",
+    png: "https://raw.githubusercontent.com/comfyanonymous/ComfyUI/master/web/assets/icon.png"
+  },
+  piper: {
+    png: "https://raw.githubusercontent.com/rhasspy/piper/master/logo.png"
+  },
+  kokoro: {
+    png: "https://raw.githubusercontent.com/hexgrad/kokoro/main/assets/icon.png"
+  },
+  ollama: {
+    svg: "https://cdn.simpleicons.org/ollama",
+    png: "https://cdn.brandfetch.io/idtesMoSFj/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- Model Org Providers (from OpenRouter model prefixes) ---
+  meta: {
+    svg: "https://cdn.simpleicons.org/meta",
+    png: "https://cdn.brandfetch.io/idmKk_rq7Y/w/512/h/512/theme/dark/icon.png"
+  },
+  deepseek: {
+    png: "https://cdn.brandfetch.io/id1BWKUVWI/w/512/h/512/theme/dark/icon.png"
+  },
+  microsoft: {
+    svg: "https://cdn.simpleicons.org/microsoft",
+    png: "https://cdn.brandfetch.io/idchmboHEZ/w/512/h/512/theme/dark/icon.png"
+  },
+  nvidia: {
+    svg: "https://cdn.simpleicons.org/nvidia",
+    png: "https://cdn.brandfetch.io/id1JcGHuZN/w/512/h/512/theme/dark/icon.png"
+  },
+  qwen: {
+    png: "https://img.alicdn.com/imgextra/i1/O1CN01BUp2gU1sRZigvazUo_!!6000000005764-2-tps-228-228.png"
+  },
+  cohere: {
+    svg: "https://cdn.simpleicons.org/cohere",
+    png: "https://cdn.brandfetch.io/idiDnz1fvB/w/512/h/512/theme/dark/icon.png"
+  },
+  perplexity: {
+    svg: "https://cdn.simpleicons.org/perplexity",
+    png: "https://cdn.brandfetch.io/idwWX3Neii/w/512/h/512/theme/dark/icon.png"
+  },
+  amazon: {
+    svg: "https://cdn.simpleicons.org/amazonaws",
+    png: "https://cdn.brandfetch.io/idawORoPJZ/w/512/h/512/theme/dark/icon.png"
+  },
+  // --- HuggingFace Inference Providers ---
+  "hf-inference": {
+    svg: "https://cdn.simpleicons.org/huggingface",
+    png: "https://cdn.brandfetch.io/idnrPPHe87/w/512/h/512/theme/dark/icon.png"
+  },
+  "sambanova": {
+    png: "https://cdn.brandfetch.io/id__2e5yMY/w/512/h/512/theme/dark/icon.png"
+  },
+  "together": {
+    svg: "https://cdn.simpleicons.org/togetherai",
+    png: "https://cdn.brandfetch.io/idH5EoFVaH/w/512/h/512/theme/dark/icon.png"
+  },
+  "fireworks-ai": {
+    png: "https://cdn.brandfetch.io/idj1VQ2O4C/w/512/h/512/theme/dark/icon.png"
+  },
+  "replicate": {
+    svg: "https://cdn.simpleicons.org/replicate",
+    png: "https://cdn.brandfetch.io/idWKE4rRaH/w/512/h/512/theme/dark/icon.png"
+  },
+  "nebius": {
+    png: "https://cdn.brandfetch.io/idiUqSQ52b/w/512/h/512/theme/dark/icon.png"
+  },
+  "novita": {
+    png: "https://novita.ai/favicon.png"
+  }
+};
+function getProviderLogo(providerId) {
+  if (!providerId) return void 0;
+  if (PROVIDER_LOGOS[providerId]) return PROVIDER_LOGOS[providerId];
+  const normalized = providerId.toLowerCase().replace(/[-_\s]/g, "");
+  for (const [key, logo] of Object.entries(PROVIDER_LOGOS)) {
+    if (key.replace(/[-_\s]/g, "") === normalized) return logo;
+  }
+  return void 0;
+}
+
 // src/registry.ts
 var Registry = class {
   providers = /* @__PURE__ */ new Map();
@@ -220,7 +359,8 @@ var Registry = class {
         local: provider.isLocal,
         status: "online",
         // ping-based status is set externally
-        modelCount: cached?.models.length ?? 0
+        modelCount: cached?.models.length ?? 0,
+        logo: getProviderLogo(provider.id)
       });
     }
     return infos;
@@ -279,7 +419,6 @@ var UsageTracker = class {
 // src/providers/pi-ai.ts
 var import_pi_ai = require("@mariozechner/pi-ai");
 var KNOWN_PROVIDERS = ["anthropic", "google", "openai", "xai", "groq", "cerebras", "openrouter", "zai"];
-var LOCAL_PROVIDERS = /* @__PURE__ */ new Set(["ollama"]);
 var FETCH_TIMEOUT_MS = 8e3;
 var OPENAI_CHAT_PREFIXES = ["gpt-", "o1", "o3", "o4", "chatgpt-", "codex-"];
 var OPENAI_REASONING_PREFIXES = ["o1", "o3", "o4"];
@@ -420,35 +559,9 @@ var PiAiProvider = class {
     if (modality && modality !== "llm") return [];
     await this.ensureDynamicModels();
     const models = [];
-    const seenIds = /* @__PURE__ */ new Set();
-    for (const provider of KNOWN_PROVIDERS) {
-      try {
-        const providerModels = (0, import_pi_ai.getModels)(provider);
-        for (const m of providerModels) {
-          seenIds.add(m.id);
-          models.push({
-            id: m.id,
-            provider: "pi-ai",
-            name: m.name || m.id,
-            modality: "llm",
-            local: LOCAL_PROVIDERS.has(String(m.provider)),
-            cost: {
-              price: m.cost.input ?? 0,
-              unit: m.cost.input > 0 ? "per_1m_tokens" : "free"
-            },
-            capabilities: {
-              contextWindow: m.contextWindow,
-              maxTokens: m.maxTokens,
-              supportsVision: m.input.includes("image"),
-              supportsStreaming: true
-            }
-          });
-        }
-      } catch {
-      }
-    }
-    for (const [id, m] of this.dynamicModels) {
-      if (seenIds.has(id)) continue;
+    for (const [, m] of this.dynamicModels) {
+      const providerName = String(m.provider);
+      const logoProvider = this.inferLogoProvider(m.id, providerName);
       models.push({
         id: m.id,
         provider: "pi-ai",
@@ -459,6 +572,7 @@ var PiAiProvider = class {
           price: m.cost.input ?? 0,
           unit: m.cost.input > 0 ? "per_1m_tokens" : "free"
         },
+        logo: getProviderLogo(logoProvider),
         capabilities: {
           contextWindow: m.contextWindow,
           maxTokens: m.maxTokens,
@@ -583,24 +697,15 @@ var PiAiProvider = class {
   async ensureDynamicModels() {
     if (this.dynamicModelsFetched) return;
     this.dynamicModelsFetched = true;
-    const staticIds = /* @__PURE__ */ new Set();
-    for (const provider of KNOWN_PROVIDERS) {
-      try {
-        for (const m of (0, import_pi_ai.getModels)(provider)) {
-          staticIds.add(m.id);
-        }
-      } catch {
-      }
-    }
     const fetchPromises = [];
     for (const [providerKey, configFactory] of Object.entries(PROVIDER_APIS)) {
       const apiKey = this.keys[providerKey];
       if (!apiKey) continue;
-      fetchPromises.push(this.fetchProviderModels(configFactory(apiKey), apiKey, staticIds));
+      fetchPromises.push(this.fetchProviderModels(configFactory(apiKey), apiKey));
     }
     await Promise.allSettled(fetchPromises);
   }
-  async fetchProviderModels(config, apiKey, staticIds) {
+  async fetchProviderModels(config, apiKey) {
     try {
       const controller = new AbortController();
       const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
@@ -613,11 +718,11 @@ var PiAiProvider = class {
         if (!res.ok) return;
         const data = await res.json();
         const entries = config.extractEntries(data);
-        const templateModel = this.findStaticTemplate(config.providerName);
+        const staticTemplate = this.findStaticTemplate(config.providerName);
         for (const entry of entries) {
           const id = entry.id;
           if (!config.filterChat(id)) continue;
-          if (staticIds.has(id)) continue;
+          const staticMatch = this.findStaticModel(config.providerName, id);
           this.dynamicModels.set(id, {
             id,
             name: entry.name ?? id,
@@ -625,10 +730,10 @@ var PiAiProvider = class {
             provider: config.providerName,
             baseUrl: config.piBaseUrl,
             reasoning: config.isReasoning(id),
-            input: ["text", "image"],
-            cost: templateModel?.cost ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-            contextWindow: entry.contextWindow ?? templateModel?.contextWindow ?? 128e3,
-            maxTokens: entry.maxTokens ?? templateModel?.maxTokens ?? 16384
+            input: staticMatch?.input ?? ["text", "image"],
+            cost: staticMatch?.cost ?? staticTemplate?.cost ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: entry.contextWindow ?? staticMatch?.contextWindow ?? staticTemplate?.contextWindow ?? 128e3,
+            maxTokens: entry.maxTokens ?? staticMatch?.maxTokens ?? staticTemplate?.maxTokens ?? 16384
           });
         }
       } finally {
@@ -645,25 +750,75 @@ var PiAiProvider = class {
       return null;
     }
   }
+  findStaticModel(providerName, modelId) {
+    try {
+      const models = (0, import_pi_ai.getModels)(providerName);
+      return models.find((m) => m.id === modelId) ?? null;
+    } catch {
+      return null;
+    }
+  }
   /** Force re-fetch of dynamic models from provider APIs */
   async refreshDynamicModels() {
     this.dynamicModelsFetched = false;
     this.dynamicModels.clear();
     await this.ensureDynamicModels();
   }
+  /**
+   * Infer the real provider from model ID for logo resolution.
+   * e.g. "x-ai/grok-4" → "xai", "anthropic/claude-4" → "anthropic"
+   */
+  inferLogoProvider(modelId, fallback) {
+    const MODEL_PREFIX_TO_PROVIDER = {
+      "openai/": "openai",
+      "gpt-": "openai",
+      "o1-": "openai",
+      "o3-": "openai",
+      "o4-": "openai",
+      "chatgpt-": "openai",
+      "anthropic/": "anthropic",
+      "claude-": "anthropic",
+      "google/": "google",
+      "gemini-": "google",
+      "gemma-": "google",
+      "x-ai/": "xai",
+      "grok-": "xai",
+      "meta-llama/": "meta",
+      "mistralai/": "mistral",
+      "mistral-": "mistral",
+      "deepseek/": "deepseek",
+      "microsoft/": "microsoft",
+      "nvidia/": "nvidia",
+      "qwen/": "qwen",
+      "cohere/": "cohere",
+      "perplexity/": "perplexity",
+      "amazon/": "amazon"
+    };
+    const lower = modelId.toLowerCase();
+    for (const [prefix, provider] of Object.entries(MODEL_PREFIX_TO_PROVIDER)) {
+      if (lower.startsWith(prefix)) return provider;
+    }
+    return fallback;
+  }
   findModel(modelId) {
+    if (modelId) {
+      const dynamic = this.dynamicModels.get(modelId);
+      if (dynamic) return { model: dynamic, provider: String(dynamic.provider) };
+    }
+    if (!modelId) {
+      const first = this.dynamicModels.values().next();
+      if (!first.done && first.value) {
+        return { model: first.value, provider: String(first.value.provider) };
+      }
+    }
     for (const provider of KNOWN_PROVIDERS) {
       try {
         const models = (0, import_pi_ai.getModels)(provider);
-        const found = modelId ? models.find((m) => m.id === modelId) : models[0];
+        const found = modelId ? models.find((m) => m.id === modelId) : void 0;
         if (found) return { model: found, provider };
       } catch {
       }
     }
-    if (modelId) {
-      const dynamic = this.dynamicModels.get(modelId);
-      if (dynamic) return { model: dynamic, provider: String(dynamic.provider) };
-    }
     return { model: null, provider: null };
   }
 };
@@ -704,7 +859,8 @@ var FalProvider = class {
           name: entry.modelId.replace("fal-ai/", ""),
           modality: inferredModality,
           local: false,
-          cost: { price: entry.price, unit: entry.unit }
+          cost: { price: entry.price, unit: entry.unit },
+          logo: getProviderLogo("fal")
         });
       }
       return models;
@@ -857,6 +1013,7 @@ var ComfyUIProvider = class {
       const res = await fetch(`${this.baseUrl}/object_info`);
       if (!res.ok) return [];
       const models = [];
+      const logo = getProviderLogo("comfyui");
       if (!modality || modality === "image") {
         models.push({
           id: "comfyui-txt2img",
@@ -865,6 +1022,7 @@ var ComfyUIProvider = class {
           modality: "image",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxWidth: 2048, maxHeight: 2048, supportsNegativePrompt: true }
         });
       }
@@ -876,6 +1034,7 @@ var ComfyUIProvider = class {
           modality: "video",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxDuration: 10, supportsImageToVideo: true }
         });
       }
@@ -987,6 +1146,7 @@ var LocalTTSProvider = class {
           voices = data.data ?? [];
         }
       }
+      const logo = getProviderLogo(this.id);
       return voices.map((v) => ({
         id: v.id,
         provider: this.id,
@@ -994,6 +1154,7 @@ var LocalTTSProvider = class {
         modality: "tts",
         local: true,
         cost: { price: 0, unit: "free" },
+        logo,
         capabilities: { voices: voices.map((vv) => vv.id) }
       }));
     } catch {
@@ -1044,11 +1205,6 @@ var PIPELINE_TAG_MAP = {
   "text-to-image": { modality: "image", limit: 50 },
   "text-to-speech": { modality: "tts", limit: 30 }
 };
-var DEFAULT_MODELS = [
-  { id: "stabilityai/stable-diffusion-xl-base-1.0", provider: "huggingface", name: "SDXL Base", modality: "image", local: false, cost: { price: 0, unit: "free" } },
-  { id: "facebook/mms-tts-eng", provider: "huggingface", name: "MMS TTS English", modality: "tts", local: false, cost: { price: 0, unit: "free" } },
-  { id: "meta-llama/Llama-3.1-8B-Instruct", provider: "huggingface", name: "Llama 3.1 8B", modality: "llm", local: false, cost: { price: 0, unit: "free" } }
-];
 var HuggingFaceProvider = class {
   id = "huggingface";
   name = "HuggingFace Inference";
@@ -1068,17 +1224,13 @@ var HuggingFaceProvider = class {
     if (!this.dynamicModels) {
       await this.fetchHubModels();
     }
-    const all = this.dynamicModels ?? DEFAULT_MODELS;
+    const all = this.dynamicModels ?? [];
     if (modality) return all.filter((m) => m.modality === modality);
     return all;
   }
   async fetchHubModels() {
     const seenIds = /* @__PURE__ */ new Set();
     const models = [];
-    for (const d of DEFAULT_MODELS) {
-      seenIds.add(d.id);
-      models.push(d);
-    }
     const fetches = Object.entries(PIPELINE_TAG_MAP).map(
       ([tag, { modality, limit }]) => this.fetchByPipelineTag(tag, modality, limit)
     );
@@ -1113,7 +1265,13 @@ var HuggingFaceProvider = class {
         const data = await res.json();
         return data.filter((entry) => entry.id || entry.modelId).map((entry) => {
           const id = entry.id ?? entry.modelId;
-          const providers = (entry.inferenceProviderMapping ?? []).filter((p) => p.status === "live").map((p) => p.provider);
+          const liveProviders = (entry.inferenceProviderMapping ?? []).filter((p) => p.status === "live");
+          const providers = liveProviders.map((p) => p.provider);
+          const inferenceProviderLogos = {};
+          for (const p of liveProviders) {
+            const pLogo = getProviderLogo(p.provider);
+            if (pLogo) inferenceProviderLogos[p.provider] = pLogo;
+          }
           const pricingProvider = (entry.inferenceProviderMapping ?? []).find((p) => p.providerDetails?.pricing);
           const pricing = pricingProvider?.providerDetails?.pricing;
           const contextLength = (entry.inferenceProviderMapping ?? []).find((p) => p.providerDetails?.context_length)?.providerDetails?.context_length;
@@ -1127,12 +1285,14 @@ var HuggingFaceProvider = class {
               price: pricing?.input ?? 0,
               unit: pricing ? "per_1m_tokens" : "free"
             },
+            logo: getProviderLogo("huggingface"),
             capabilities: {
               ...modality === "llm" ? {
                 contextWindow: contextLength,
                 supportsStreaming: true
               } : {},
-              ...providers.length > 0 ? { inferenceProviders: providers } : {}
+              ...providers.length > 0 ? { inferenceProviders: providers } : {},
+              ...Object.keys(inferenceProviderLogos).length > 0 ? { inferenceProviderLogos } : {}
             }
           };
         });
@@ -1584,6 +1744,8 @@ var Noosphere = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Noosphere,
-  NoosphereError
+  NoosphereError,
+  PROVIDER_LOGOS,
+  getProviderLogo
 });
 //# sourceMappingURL=index.cjs.map