noosphere 0.4.1 → 0.7.0

package/dist/index.d.cts

@@ -1,4 +1,18 @@
-type Modality = 'llm' | 'image' | 'video' | 'tts';
+type Modality = 'llm' | 'image' | 'video' | 'tts' | 'stt' | 'music' | 'embedding';
+type ModelStatus = 'installed' | 'available' | 'downloading' | 'running' | 'error';
+interface LocalModelInfo {
+    sizeBytes: number;
+    family?: string;
+    parameterSize?: string;
+    quantization?: string;
+    format?: string;
+    digest?: string;
+    modifiedAt?: string;
+    running?: boolean;
+    vramRequired?: number;
+    diskPath?: string;
+    runtime: string;
+}
 interface BaseOptions {
     provider?: string;
     model?: string;
@@ -85,6 +99,8 @@ interface ModelInfo {
         unit: string;
     };
     logo?: ProviderLogo$1;
+    status?: ModelStatus;
+    localInfo?: LocalModelInfo;
     capabilities?: {
         contextWindow?: number;
         maxTokens?: number;
@@ -202,6 +218,25 @@ interface NoosphereConfig {
     };
     onUsage?: (usage: UsageEvent) => void | Promise<void>;
 }
+interface TranscriptionOptions extends BaseOptions {
+    audio: string;
+    language?: string;
+    task?: 'transcribe' | 'translate';
+}
+interface TranscriptionResult {
+    text: string;
+    language: string;
+    duration: number;
+    segments?: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+interface MusicOptions extends BaseOptions {
+    prompt: string;
+    duration?: number;
+}
 
 interface NoosphereProvider {
     readonly id: string;
@@ -218,6 +253,54 @@ interface NoosphereProvider {
     dispose?(): Promise<void>;
 }
 
+interface OllamaPullProgress {
+    status: string;
+    digest?: string;
+    total?: number;
+    completed?: number;
+}
+interface OllamaModelDetail {
+    modelfile: string;
+    parameters: string;
+    template: string;
+    details: {
+        parent_model: string;
+        format: string;
+        family: string;
+        families: string[];
+        parameter_size: string;
+        quantization_level: string;
+    };
+}
+interface OllamaRunningModel {
+    name: string;
+    model: string;
+    size: number;
+    digest: string;
+    expires_at: string;
+    size_vram: number;
+}
+declare class OllamaProvider implements NoosphereProvider {
+    readonly id = "ollama";
+    readonly name = "Ollama (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private baseUrl;
+    constructor(config?: {
+        host?: string;
+        port?: number;
+    });
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    private toModelInfo;
+    chat(options: ChatOptions): Promise<NoosphereResult>;
+    stream(options: ChatOptions): NoosphereStream;
+    pullModel(name: string): AsyncGenerator<OllamaPullProgress>;
+    deleteModel(name: string): Promise<void>;
+    showModel(name: string): Promise<OllamaModelDetail>;
+    getRunningModels(): Promise<OllamaRunningModel[]>;
+}
+
 declare class Noosphere {
     private config;
     private registry;
@@ -236,6 +319,12 @@ declare class Noosphere {
     getModel(provider: string, modelId: string): Promise<ModelInfo | null>;
     syncModels(): Promise<SyncResult>;
     getUsage(options?: UsageQueryOptions): UsageSummary;
+    installModel(name: string): Promise<AsyncGenerator<OllamaPullProgress>>;
+    uninstallModel(name: string): Promise<void>;
+    getHardware(): Promise<{
+        ollama: boolean;
+        runningModels: OllamaRunningModel[];
+    }>;
     dispose(): Promise<void>;
     private init;
     private resolveProviderForModality;
@@ -260,6 +349,63 @@ declare class NoosphereError extends Error {
     isRetryable(): boolean;
 }
 
+declare class HfLocalProvider implements NoosphereProvider {
+    readonly id = "hf-local";
+    readonly name = "HuggingFace Local Models";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private cachedModels;
+    ping(): Promise<boolean>;
+    listModels(modality?: Modality): Promise<ModelInfo[]>;
+    private fetchCatalog;
+    private scanLocalCache;
+}
+
+declare class WhisperLocalProvider implements NoosphereProvider {
+    readonly id = "whisper-local";
+    readonly name = "Whisper (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private runtime;
+    ping(): Promise<boolean>;
+    private detectRuntime;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    private isModelCached;
+    transcribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+
+declare class AudioCraftProvider implements NoosphereProvider {
+    readonly id = "audiocraft";
+    readonly name = "AudioCraft (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private detected;
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+}
+
+interface OpenAICompatConfig {
+    baseUrl: string;
+    apiKey?: string;
+    name?: string;
+    id?: string;
+}
+declare class OpenAICompatProvider implements NoosphereProvider {
+    readonly id: string;
+    readonly name: string;
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private baseUrl;
+    private headers;
+    constructor(config: OpenAICompatConfig);
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    chat(options: ChatOptions): Promise<NoosphereResult>;
+    stream(options: ChatOptions): NoosphereStream;
+}
+/** Auto-detect running OpenAI-compatible servers on common ports */
+declare function detectOpenAICompatServers(): Promise<OpenAICompatProvider[]>;
+
 interface ProviderLogo {
     svg?: string;
     png?: string;
@@ -269,8 +415,7 @@ interface ProviderLogo {
  */
 declare const PROVIDER_IDS: readonly ["openai", "anthropic", "google", "groq", "mistral", "xai", "openrouter", "cerebras", "pi-ai", "fal", "huggingface", "comfyui", "piper", "kokoro", "ollama", "meta", "deepseek", "microsoft", "nvidia", "qwen", "cohere", "perplexity", "amazon", "zai", "minimax", "baidu", "bytedance", "tencent", "xiaomi", "ibm", "ai21", "inflection", "upstage", "sambanova", "together", "fireworks-ai", "replicate", "nebius", "novita"];
 /**
- * Get local file paths to a provider's logo assets.
- * Returns absolute paths to SVG and/or PNG files in assets/logos/.
+ * Get CDN URLs for a provider's logo.
  */
 declare function getProviderLogo(providerId: string | undefined | null): ProviderLogo | undefined;
 /**
@@ -279,4 +424,4 @@ declare function getProviderLogo(providerId: string | undefined | null): Provide
 declare function getAllProviderLogos(): Record<string, ProviderLogo>;
 declare const PROVIDER_LOGOS: Record<string, ProviderLogo>;
 
-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_IDS, PROVIDER_LOGOS, type ProviderInfo, type ProviderLogo$1 as ProviderLogo, type SpeakOptions, type StreamEvent, type SyncResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions, getAllProviderLogos, getProviderLogo };
+export { AudioCraftProvider, type BaseOptions, type ChatOptions, HfLocalProvider, type ImageOptions, type LocalModelInfo, type LocalServiceConfig, type Modality, type ModelInfo, type ModelStatus, type MusicOptions, Noosphere, type NoosphereConfig, NoosphereError, type NoosphereErrorCode, type NoosphereProvider, type NoosphereResult, type NoosphereStream, type OllamaModelDetail, OllamaProvider, type OllamaPullProgress, type OllamaRunningModel, type OpenAICompatConfig, OpenAICompatProvider, PROVIDER_IDS, PROVIDER_LOGOS, type ProviderInfo, type ProviderLogo$1 as ProviderLogo, type SpeakOptions, type StreamEvent, type SyncResult, type TranscriptionOptions, type TranscriptionResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions, WhisperLocalProvider, detectOpenAICompatServers, getAllProviderLogos, getProviderLogo };

package/dist/index.d.ts

@@ -1,4 +1,18 @@
-type Modality = 'llm' | 'image' | 'video' | 'tts';
+type Modality = 'llm' | 'image' | 'video' | 'tts' | 'stt' | 'music' | 'embedding';
+type ModelStatus = 'installed' | 'available' | 'downloading' | 'running' | 'error';
+interface LocalModelInfo {
+    sizeBytes: number;
+    family?: string;
+    parameterSize?: string;
+    quantization?: string;
+    format?: string;
+    digest?: string;
+    modifiedAt?: string;
+    running?: boolean;
+    vramRequired?: number;
+    diskPath?: string;
+    runtime: string;
+}
 interface BaseOptions {
     provider?: string;
     model?: string;
@@ -85,6 +99,8 @@ interface ModelInfo {
         unit: string;
     };
     logo?: ProviderLogo$1;
+    status?: ModelStatus;
+    localInfo?: LocalModelInfo;
     capabilities?: {
         contextWindow?: number;
         maxTokens?: number;
@@ -202,6 +218,25 @@ interface NoosphereConfig {
     };
     onUsage?: (usage: UsageEvent) => void | Promise<void>;
 }
+interface TranscriptionOptions extends BaseOptions {
+    audio: string;
+    language?: string;
+    task?: 'transcribe' | 'translate';
+}
+interface TranscriptionResult {
+    text: string;
+    language: string;
+    duration: number;
+    segments?: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+interface MusicOptions extends BaseOptions {
+    prompt: string;
+    duration?: number;
+}
 
 interface NoosphereProvider {
     readonly id: string;
@@ -218,6 +253,54 @@ interface NoosphereProvider {
     dispose?(): Promise<void>;
 }
 
+interface OllamaPullProgress {
+    status: string;
+    digest?: string;
+    total?: number;
+    completed?: number;
+}
+interface OllamaModelDetail {
+    modelfile: string;
+    parameters: string;
+    template: string;
+    details: {
+        parent_model: string;
+        format: string;
+        family: string;
+        families: string[];
+        parameter_size: string;
+        quantization_level: string;
+    };
+}
+interface OllamaRunningModel {
+    name: string;
+    model: string;
+    size: number;
+    digest: string;
+    expires_at: string;
+    size_vram: number;
+}
+declare class OllamaProvider implements NoosphereProvider {
+    readonly id = "ollama";
+    readonly name = "Ollama (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private baseUrl;
+    constructor(config?: {
+        host?: string;
+        port?: number;
+    });
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    private toModelInfo;
+    chat(options: ChatOptions): Promise<NoosphereResult>;
+    stream(options: ChatOptions): NoosphereStream;
+    pullModel(name: string): AsyncGenerator<OllamaPullProgress>;
+    deleteModel(name: string): Promise<void>;
+    showModel(name: string): Promise<OllamaModelDetail>;
+    getRunningModels(): Promise<OllamaRunningModel[]>;
+}
+
 declare class Noosphere {
     private config;
     private registry;
@@ -236,6 +319,12 @@ declare class Noosphere {
     getModel(provider: string, modelId: string): Promise<ModelInfo | null>;
     syncModels(): Promise<SyncResult>;
     getUsage(options?: UsageQueryOptions): UsageSummary;
+    installModel(name: string): Promise<AsyncGenerator<OllamaPullProgress>>;
+    uninstallModel(name: string): Promise<void>;
+    getHardware(): Promise<{
+        ollama: boolean;
+        runningModels: OllamaRunningModel[];
+    }>;
     dispose(): Promise<void>;
     private init;
     private resolveProviderForModality;
@@ -260,6 +349,63 @@ declare class NoosphereError extends Error {
     isRetryable(): boolean;
 }
 
+declare class HfLocalProvider implements NoosphereProvider {
+    readonly id = "hf-local";
+    readonly name = "HuggingFace Local Models";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private cachedModels;
+    ping(): Promise<boolean>;
+    listModels(modality?: Modality): Promise<ModelInfo[]>;
+    private fetchCatalog;
+    private scanLocalCache;
+}
+
+declare class WhisperLocalProvider implements NoosphereProvider {
+    readonly id = "whisper-local";
+    readonly name = "Whisper (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private runtime;
+    ping(): Promise<boolean>;
+    private detectRuntime;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    private isModelCached;
+    transcribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+
+declare class AudioCraftProvider implements NoosphereProvider {
+    readonly id = "audiocraft";
+    readonly name = "AudioCraft (Local)";
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private detected;
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+}
+
+interface OpenAICompatConfig {
+    baseUrl: string;
+    apiKey?: string;
+    name?: string;
+    id?: string;
+}
+declare class OpenAICompatProvider implements NoosphereProvider {
+    readonly id: string;
+    readonly name: string;
+    readonly modalities: Modality[];
+    readonly isLocal = true;
+    private baseUrl;
+    private headers;
+    constructor(config: OpenAICompatConfig);
+    ping(): Promise<boolean>;
+    listModels(_modality?: Modality): Promise<ModelInfo[]>;
+    chat(options: ChatOptions): Promise<NoosphereResult>;
+    stream(options: ChatOptions): NoosphereStream;
+}
+/** Auto-detect running OpenAI-compatible servers on common ports */
+declare function detectOpenAICompatServers(): Promise<OpenAICompatProvider[]>;
+
 interface ProviderLogo {
     svg?: string;
     png?: string;
@@ -269,8 +415,7 @@ interface ProviderLogo {
  */
 declare const PROVIDER_IDS: readonly ["openai", "anthropic", "google", "groq", "mistral", "xai", "openrouter", "cerebras", "pi-ai", "fal", "huggingface", "comfyui", "piper", "kokoro", "ollama", "meta", "deepseek", "microsoft", "nvidia", "qwen", "cohere", "perplexity", "amazon", "zai", "minimax", "baidu", "bytedance", "tencent", "xiaomi", "ibm", "ai21", "inflection", "upstage", "sambanova", "together", "fireworks-ai", "replicate", "nebius", "novita"];
 /**
- * Get local file paths to a provider's logo assets.
- * Returns absolute paths to SVG and/or PNG files in assets/logos/.
+ * Get CDN URLs for a provider's logo.
  */
 declare function getProviderLogo(providerId: string | undefined | null): ProviderLogo | undefined;
 /**
@@ -279,4 +424,4 @@ declare function getProviderLogo(providerId: string | undefined | null): Provide
 declare function getAllProviderLogos(): Record<string, ProviderLogo>;
 declare const PROVIDER_LOGOS: Record<string, ProviderLogo>;
 
-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_IDS, PROVIDER_LOGOS, type ProviderInfo, type ProviderLogo$1 as ProviderLogo, type SpeakOptions, type StreamEvent, type SyncResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions, getAllProviderLogos, getProviderLogo };
+export { AudioCraftProvider, type BaseOptions, type ChatOptions, HfLocalProvider, type ImageOptions, type LocalModelInfo, type LocalServiceConfig, type Modality, type ModelInfo, type ModelStatus, type MusicOptions, Noosphere, type NoosphereConfig, NoosphereError, type NoosphereErrorCode, type NoosphereProvider, type NoosphereResult, type NoosphereStream, type OllamaModelDetail, OllamaProvider, type OllamaPullProgress, type OllamaRunningModel, type OpenAICompatConfig, OpenAICompatProvider, PROVIDER_IDS, PROVIDER_LOGOS, type ProviderInfo, type ProviderLogo$1 as ProviderLogo, type SpeakOptions, type StreamEvent, type SyncResult, type TranscriptionOptions, type TranscriptionResult, type UsageEvent, type UsageQueryOptions, type UsageSummary, type VideoOptions, WhisperLocalProvider, detectOpenAICompatServers, getAllProviderLogos, getProviderLogo };