noosphere 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -70,6 +70,10 @@ interface NoosphereStream extends AsyncIterable<StreamEvent> {
     result(): Promise<NoosphereResult>;
     abort(): void;
 }
+interface ProviderLogo$1 {
+    svg?: string;
+    png?: string;
+}
 interface ModelInfo {
     id: string;
     provider: string;
@@ -80,6 +84,7 @@ interface ModelInfo {
         price: number;
         unit: string;
     };
+    logo?: ProviderLogo$1;
     capabilities?: {
         contextWindow?: number;
         maxTokens?: number;
@@ -104,6 +109,7 @@ interface ProviderInfo {
     local: boolean;
     status: 'online' | 'offline' | 'degraded';
     modelCount: number;
+    logo?: ProviderLogo$1;
 }
 interface UsageEvent {
     modality: Modality;
@@ -254,4 +260,19 @@ declare class NoosphereError extends Error {
     isRetryable(): boolean;
 }
 
-export { type BaseOptions, type ChatOptions, type ImageOptions, type LocalServiceConfig, type Modality, type ModelInfo, Noosphere, type NoosphereConfig, NoosphereError, type NoosphereErrorCode, type NoosphereProvider, type NoosphereResult, type NoosphereStream, type ProviderInfo, type SpeakOptions, type StreamEvent, type SyncResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions };
+interface ProviderLogo {
+    svg?: string;
+    png?: string;
+}
+/**
+ * Known provider logos from official brand assets and CDNs.
+ * Keys match provider IDs used throughout noosphere.
+ */
+declare const PROVIDER_LOGOS: Record<string, ProviderLogo>;
+/**
+ * Get logo for a provider by its ID.
+ * Tries exact match first, then case-insensitive partial match.
+ */
+declare function getProviderLogo(providerId: string | undefined | null): ProviderLogo | undefined;
+
+export { type BaseOptions, type ChatOptions, type ImageOptions, type LocalServiceConfig, type Modality, type ModelInfo, Noosphere, type NoosphereConfig, NoosphereError, type NoosphereErrorCode, type NoosphereProvider, type NoosphereResult, type NoosphereStream, PROVIDER_LOGOS, type ProviderInfo, type ProviderLogo$1 as ProviderLogo, type SpeakOptions, type StreamEvent, type SyncResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions, getProviderLogo };

package/dist/index.js

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/errors.ts
 var RETRYABLE_CODES = /* @__PURE__ */ new Set([
   "PROVIDER_UNAVAILABLE",
@@ -26,6 +33,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",
@@ -49,6 +66,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];
@@ -90,6 +108,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();
@@ -193,7 +337,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;
@@ -252,7 +397,6 @@ var UsageTracker = class {
 // src/providers/pi-ai.ts
 import { getModels, getProviders, complete, stream, setApiKey } from "@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"];
@@ -393,35 +537,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 = 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",
@@ -432,6 +550,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,
@@ -556,24 +675,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 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);
@@ -586,11 +696,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,
@@ -598,10 +708,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 {
@@ -618,25 +728,75 @@ var PiAiProvider = class {
       return null;
     }
   }
+  findStaticModel(providerName, modelId) {
+    try {
+      const models = 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 = 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 };
   }
 };
@@ -677,7 +837,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;
@@ -830,6 +991,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",
@@ -838,6 +1000,7 @@ var ComfyUIProvider = class {
           modality: "image",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxWidth: 2048, maxHeight: 2048, supportsNegativePrompt: true }
         });
       }
@@ -849,6 +1012,7 @@ var ComfyUIProvider = class {
           modality: "video",
           local: true,
           cost: { price: 0, unit: "free" },
+          logo,
           capabilities: { maxDuration: 10, supportsImageToVideo: true }
         });
       }
@@ -960,6 +1124,7 @@ var LocalTTSProvider = class {
           voices = data.data ?? [];
         }
       }
+      const logo = getProviderLogo(this.id);
       return voices.map((v) => ({
         id: v.id,
         provider: this.id,
@@ -967,6 +1132,7 @@ var LocalTTSProvider = class {
         modality: "tts",
         local: true,
         cost: { price: 0, unit: "free" },
+        logo,
         capabilities: { voices: voices.map((vv) => vv.id) }
       }));
     } catch {
@@ -1017,11 +1183,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";
@@ -1041,17 +1202,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)
     );
@@ -1086,7 +1243,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;
@@ -1100,12 +1263,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 } : {}
             }
           };
         });
@@ -1556,6 +1721,8 @@ var Noosphere = class {
 };
 export {
   Noosphere,
-  NoosphereError
+  NoosphereError,
+  PROVIDER_LOGOS,
+  getProviderLogo
 };
 //# sourceMappingURL=index.js.map