noosphere 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,257 @@
+type Modality = 'llm' | 'image' | 'video' | 'tts';
+interface BaseOptions {
+    provider?: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ChatOptions extends BaseOptions {
+    messages: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>;
+    temperature?: number;
+    maxTokens?: number;
+    jsonMode?: boolean;
+}
+interface ImageOptions extends BaseOptions {
+    prompt: string;
+    negativePrompt?: string;
+    width?: number;
+    height?: number;
+    seed?: number;
+    steps?: number;
+    guidanceScale?: number;
+}
+interface VideoOptions extends BaseOptions {
+    prompt: string;
+    imageUrl?: string;
+    duration?: number;
+    fps?: number;
+    width?: number;
+    height?: number;
+}
+interface SpeakOptions extends BaseOptions {
+    text: string;
+    voice?: string;
+    language?: string;
+    speed?: number;
+    format?: 'mp3' | 'wav' | 'ogg';
+}
+interface NoosphereResult {
+    content?: string;
+    thinking?: string;
+    url?: string;
+    buffer?: Buffer;
+    provider: string;
+    model: string;
+    modality: Modality;
+    latencyMs: number;
+    usage: {
+        cost: number;
+        input?: number;
+        output?: number;
+        unit?: string;
+    };
+    media?: {
+        width?: number;
+        height?: number;
+        duration?: number;
+        format?: string;
+        fps?: number;
+    };
+}
+interface StreamEvent {
+    type: 'text_delta' | 'thinking_delta' | 'done' | 'error';
+    delta?: string;
+    error?: Error;
+    result?: NoosphereResult;
+}
+interface NoosphereStream extends AsyncIterable<StreamEvent> {
+    result(): Promise<NoosphereResult>;
+    abort(): void;
+}
+interface ModelInfo {
+    id: string;
+    provider: string;
+    name: string;
+    modality: Modality;
+    local: boolean;
+    cost: {
+        price: number;
+        unit: string;
+    };
+    capabilities?: {
+        contextWindow?: number;
+        maxTokens?: number;
+        supportsVision?: boolean;
+        supportsReasoning?: boolean;
+        supportsFunctionCalling?: boolean;
+        supportsStreaming?: boolean;
+        maxWidth?: number;
+        maxHeight?: number;
+        supportsNegativePrompt?: boolean;
+        maxDuration?: number;
+        supportsImageToVideo?: boolean;
+        voices?: string[];
+        languages?: string[];
+        supportsVoiceCloning?: boolean;
+    };
+}
+interface ProviderInfo {
+    id: string;
+    name: string;
+    modalities: Modality[];
+    local: boolean;
+    status: 'online' | 'offline' | 'degraded';
+    modelCount: number;
+}
+interface UsageEvent {
+    modality: Modality;
+    provider: string;
+    model: string;
+    cost: number;
+    latencyMs: number;
+    input?: number;
+    output?: number;
+    unit?: string;
+    timestamp: string;
+    success: boolean;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UsageQueryOptions {
+    since?: string | Date;
+    until?: string | Date;
+    provider?: string;
+    modality?: Modality;
+}
+interface UsageSummary {
+    totalCost: number;
+    totalRequests: number;
+    byProvider: Record<string, number>;
+    byModality: Record<Modality, number>;
+}
+interface SyncResult {
+    synced: number;
+    byProvider: Record<string, number>;
+    errors: string[];
+}
+type NoosphereErrorCode = 'PROVIDER_UNAVAILABLE' | 'MODEL_NOT_FOUND' | 'AUTH_FAILED' | 'RATE_LIMITED' | 'TIMEOUT' | 'GENERATION_FAILED' | 'INVALID_INPUT' | 'NO_PROVIDER';
+interface LocalServiceConfig {
+    enabled?: boolean;
+    host?: string;
+    port?: number;
+    type?: string;
+}
+interface NoosphereConfig {
+    keys?: {
+        openai?: string;
+        anthropic?: string;
+        google?: string;
+        fal?: string;
+        openrouter?: string;
+        huggingface?: string;
+        groq?: string;
+        mistral?: string;
+        xai?: string;
+    };
+    local?: {
+        ollama?: LocalServiceConfig;
+        comfyui?: LocalServiceConfig;
+        piper?: LocalServiceConfig;
+        kokoro?: LocalServiceConfig;
+        custom?: LocalServiceConfig[];
+    };
+    defaults?: {
+        llm?: {
+            provider: string;
+            model: string;
+        };
+        image?: {
+            provider: string;
+            model: string;
+        };
+        video?: {
+            provider: string;
+            model: string;
+        };
+        tts?: {
+            provider: string;
+            model: string;
+        };
+    };
+    autoDetectLocal?: boolean;
+    discoveryCacheTTL?: number;
+    retry?: {
+        maxRetries?: number;
+        backoffMs?: number;
+        retryableErrors?: NoosphereErrorCode[];
+        failover?: boolean;
+    };
+    timeout?: {
+        llm?: number;
+        image?: number;
+        video?: number;
+        tts?: number;
+    };
+    onUsage?: (usage: UsageEvent) => void | Promise<void>;
+}
+
+interface NoosphereProvider {
+    readonly id: string;
+    readonly name: string;
+    readonly modalities: Modality[];
+    readonly isLocal: boolean;
+    ping(): Promise<boolean>;
+    listModels(modality?: Modality): Promise<ModelInfo[]>;
+    chat?(options: ChatOptions): Promise<NoosphereResult>;
+    stream?(options: ChatOptions): NoosphereStream;
+    image?(options: ImageOptions): Promise<NoosphereResult>;
+    video?(options: VideoOptions): Promise<NoosphereResult>;
+    speak?(options: SpeakOptions): Promise<NoosphereResult>;
+    dispose?(): Promise<void>;
+}
+
+declare class Noosphere {
+    private config;
+    private registry;
+    private tracker;
+    private initialized;
+    constructor(config?: NoosphereConfig);
+    /** Register a custom provider adapter */
+    registerProvider(provider: NoosphereProvider): void;
+    chat(options: ChatOptions): Promise<NoosphereResult>;
+    stream(options: ChatOptions): NoosphereStream;
+    image(options: ImageOptions): Promise<NoosphereResult>;
+    video(options: VideoOptions): Promise<NoosphereResult>;
+    speak(options: SpeakOptions): Promise<NoosphereResult>;
+    getProviders(modality?: Modality): Promise<ProviderInfo[]>;
+    getModels(modality?: Modality): Promise<ModelInfo[]>;
+    getModel(provider: string, modelId: string): Promise<ModelInfo | null>;
+    syncModels(): Promise<SyncResult>;
+    getUsage(options?: UsageQueryOptions): UsageSummary;
+    dispose(): Promise<void>;
+    private init;
+    private resolveProviderForModality;
+    private executeWithRetry;
+    private trackUsage;
+    private trackError;
+}
+
+declare class NoosphereError extends Error {
+    readonly code: NoosphereErrorCode;
+    readonly provider: string;
+    readonly modality: Modality;
+    readonly model?: string;
+    readonly cause?: Error;
+    constructor(message: string, options: {
+        code: NoosphereErrorCode;
+        provider: string;
+        modality: Modality;
+        model?: string;
+        cause?: 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 };