@tashiscool/providers 0.1.0

package/dist/registry.js

@@ -0,0 +1,290 @@
+/**
+ * Provider Registry
+ * Central registry for managing LLM providers and their configurations
+ */
+import { openaiModels, anthropicModels, googleModels, mistralModels, groqModels, deepseekModels, xaiModels, } from './models.js';
+/**
+ * Provider configurations
+ */
+const providerConfigs = {
+    openai: {
+        name: 'OpenAI',
+        description: 'OpenAI GPT models including GPT-4o and o1 series',
+        baseUrl: 'https://api.openai.com/v1',
+        requiredEnvVars: ['OPENAI_API_KEY'],
+        optionalEnvVars: ['OPENAI_ORG_ID', 'OPENAI_PROJECT_ID'],
+        supportsStreaming: true,
+        docsUrl: 'https://platform.openai.com/docs',
+        models: openaiModels,
+    },
+    anthropic: {
+        name: 'Anthropic',
+        description: 'Claude models including Claude 3.5 Sonnet and Opus',
+        baseUrl: 'https://api.anthropic.com',
+        requiredEnvVars: ['ANTHROPIC_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.anthropic.com',
+        models: anthropicModels,
+    },
+    'azure-openai': {
+        name: 'Azure OpenAI',
+        description: 'OpenAI models hosted on Microsoft Azure',
+        baseUrl: 'https://{resource}.openai.azure.com',
+        requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+        optionalEnvVars: ['AZURE_OPENAI_API_VERSION'],
+        supportsStreaming: true,
+        docsUrl: 'https://learn.microsoft.com/azure/ai-services/openai/',
+        models: openaiModels.map((m) => ({ ...m, provider: 'azure-openai' })),
+    },
+    google: {
+        name: 'Google AI',
+        description: 'Gemini models from Google',
+        baseUrl: 'https://generativelanguage.googleapis.com/v1',
+        requiredEnvVars: ['GOOGLE_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://ai.google.dev/docs',
+        models: googleModels,
+    },
+    'aws-bedrock': {
+        name: 'AWS Bedrock',
+        description: 'Foundation models on AWS Bedrock',
+        baseUrl: 'https://bedrock-runtime.{region}.amazonaws.com',
+        requiredEnvVars: ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'],
+        optionalEnvVars: ['AWS_REGION', 'AWS_SESSION_TOKEN'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.aws.amazon.com/bedrock/',
+        models: [...anthropicModels, ...mistralModels].map((m) => ({
+            ...m,
+            provider: 'aws-bedrock',
+        })),
+    },
+    mistral: {
+        name: 'Mistral AI',
+        description: 'Mistral models including Mistral Large and Codestral',
+        baseUrl: 'https://api.mistral.ai/v1',
+        requiredEnvVars: ['MISTRAL_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.mistral.ai/',
+        models: mistralModels,
+    },
+    cohere: {
+        name: 'Cohere',
+        description: 'Cohere Command and Embed models',
+        baseUrl: 'https://api.cohere.ai/v1',
+        requiredEnvVars: ['COHERE_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.cohere.com/',
+        models: [],
+    },
+    groq: {
+        name: 'Groq',
+        description: 'Ultra-fast inference for open models',
+        baseUrl: 'https://api.groq.com/openai/v1',
+        requiredEnvVars: ['GROQ_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://console.groq.com/docs',
+        models: groqModels,
+    },
+    ollama: {
+        name: 'Ollama',
+        description: 'Local LLM inference with Ollama',
+        baseUrl: 'http://localhost:11434/api',
+        requiredEnvVars: [],
+        optionalEnvVars: ['OLLAMA_HOST'],
+        supportsStreaming: true,
+        docsUrl: 'https://ollama.com/',
+        models: [],
+    },
+    huggingface: {
+        name: 'Hugging Face',
+        description: 'Hugging Face Inference API',
+        baseUrl: 'https://api-inference.huggingface.co',
+        requiredEnvVars: ['HUGGINGFACE_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://huggingface.co/docs/api-inference',
+        models: [],
+    },
+    'together-ai': {
+        name: 'Together AI',
+        description: 'Together AI inference platform',
+        baseUrl: 'https://api.together.xyz/v1',
+        requiredEnvVars: ['TOGETHER_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.together.ai/',
+        models: [],
+    },
+    replicate: {
+        name: 'Replicate',
+        description: 'Replicate model hosting platform',
+        baseUrl: 'https://api.replicate.com/v1',
+        requiredEnvVars: ['REPLICATE_API_TOKEN'],
+        supportsStreaming: true,
+        docsUrl: 'https://replicate.com/docs',
+        models: [],
+    },
+    deepseek: {
+        name: 'DeepSeek',
+        description: 'DeepSeek AI models including V3 and R1',
+        baseUrl: 'https://api.deepseek.com',
+        requiredEnvVars: ['DEEPSEEK_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://platform.deepseek.com/docs',
+        models: deepseekModels,
+    },
+    xai: {
+        name: 'xAI',
+        description: 'Grok models from xAI',
+        baseUrl: 'https://api.x.ai/v1',
+        requiredEnvVars: ['XAI_API_KEY'],
+        supportsStreaming: true,
+        docsUrl: 'https://docs.x.ai/',
+        models: xaiModels,
+    },
+};
+/**
+ * Get provider configuration by ID
+ */
+export function getProvider(id) {
+    const config = providerConfigs[id];
+    if (!config) {
+        throw new Error(`Unknown provider: ${id}`);
+    }
+    return { id, ...config };
+}
+/**
+ * Get all provider configurations
+ */
+export function getAllProviders() {
+    return Object.entries(providerConfigs).map(([id, config]) => ({
+        id: id,
+        ...config,
+    }));
+}
+/**
+ * Check if provider credentials are configured from environment
+ */
+export function isProviderConfigured(id) {
+    const config = getProvider(id);
+    return config.requiredEnvVars.every((envVar) => !!process.env[envVar]);
+}
+/**
+ * Get credentials from environment for a provider
+ */
+export function getCredentialsFromEnv(id) {
+    const config = getProvider(id);
+    const credentials = {};
+    // Map common env var patterns to credentials
+    for (const envVar of [
+        ...config.requiredEnvVars,
+        ...(config.optionalEnvVars || []),
+    ]) {
+        const value = process.env[envVar];
+        if (!value)
+            continue;
+        if (envVar.includes('API_KEY') || envVar.includes('API_TOKEN')) {
+            credentials.apiKey = value;
+        }
+        else if (envVar.includes('ENDPOINT') || envVar.includes('BASE_URL')) {
+            credentials.baseUrl = value;
+        }
+        else if (envVar.includes('ORG')) {
+            credentials.organizationId = value;
+        }
+        else if (envVar.includes('PROJECT')) {
+            credentials.projectId = value;
+        }
+        else if (envVar.includes('REGION')) {
+            credentials.region = value;
+        }
+    }
+    return credentials;
+}
+/**
+ * Create a provider instance with credentials
+ */
+export function createProviderInstance(id, credentials) {
+    const config = getProvider(id);
+    const creds = credentials || getCredentialsFromEnv(id);
+    return {
+        config,
+        credentials: creds,
+        isConfigured() {
+            return config.requiredEnvVars.length === 0 || !!creds.apiKey;
+        },
+        getModel(modelId) {
+            return config.models.find((m) => m.id === modelId);
+        },
+        listModels() {
+            return [...config.models];
+        },
+        listModelsWithCapability(capability) {
+            return config.models.filter((m) => m.capabilities[capability]);
+        },
+    };
+}
+/**
+ * Provider registry class for managing multiple providers
+ */
+export class ProviderRegistry {
+    instances = new Map();
+    /**
+     * Register a provider with credentials
+     */
+    register(id, credentials) {
+        this.instances.set(id, createProviderInstance(id, credentials));
+    }
+    /**
+     * Register all providers with credentials from environment
+     */
+    registerFromEnv() {
+        for (const id of Object.keys(providerConfigs)) {
+            if (isProviderConfigured(id)) {
+                this.register(id);
+            }
+        }
+    }
+    /**
+     * Get a provider instance
+     */
+    get(id) {
+        return this.instances.get(id);
+    }
+    /**
+     * Get all registered providers
+     */
+    getAll() {
+        return Array.from(this.instances.values());
+    }
+    /**
+     * Check if a provider is registered
+     */
+    has(id) {
+        return this.instances.has(id);
+    }
+    /**
+     * Find models across all providers with a capability
+     */
+    findModelsWithCapability(capability) {
+        const models = [];
+        for (const instance of this.instances.values()) {
+            models.push(...instance.listModelsWithCapability(capability));
+        }
+        return models;
+    }
+    /**
+     * Find a model by ID across all providers
+     */
+    findModel(modelId) {
+        for (const instance of this.instances.values()) {
+            const model = instance.getModel(modelId);
+            if (model)
+                return model;
+        }
+        return undefined;
+    }
+}
+/**
+ * Default global registry instance
+ */
+export const defaultRegistry = new ProviderRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * LLM Provider Types
+ * Core type definitions for providers, models, and capabilities
+ */
+/**
+ * Supported LLM provider identifiers
+ */
+export type ProviderId = 'openai' | 'anthropic' | 'azure-openai' | 'google' | 'aws-bedrock' | 'mistral' | 'cohere' | 'groq' | 'ollama' | 'huggingface' | 'together-ai' | 'replicate' | 'deepseek' | 'xai';
+/**
+ * Model capabilities
+ */
+export interface ModelCapabilities {
+    /** Supports text generation */
+    chat: boolean;
+    /** Supports vision/image input */
+    vision: boolean;
+    /** Supports function/tool calling */
+    toolCalling: boolean;
+    /** Supports JSON mode output */
+    jsonMode: boolean;
+    /** Supports structured output with schemas */
+    structuredOutput: boolean;
+    /** Supports streaming responses */
+    streaming: boolean;
+    /** Supports embeddings generation */
+    embeddings: boolean;
+    /** Supports image generation */
+    imageGeneration: boolean;
+    /** Supports audio input/output */
+    audio: boolean;
+}
+/**
+ * Token pricing information
+ */
+export interface TokenPricing {
+    /** Cost per 1M input tokens in USD */
+    inputPerMillion: number;
+    /** Cost per 1M output tokens in USD */
+    outputPerMillion: number;
+    /** Cost per 1M cached input tokens (if supported) */
+    cachedInputPerMillion?: number;
+}
+/**
+ * Model metadata
+ */
+export interface ModelMetadata {
+    /** Unique model identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Provider this model belongs to */
+    provider: ProviderId;
+    /** Maximum context window in tokens */
+    contextWindow: number;
+    /** Maximum output tokens (if different from context) */
+    maxOutputTokens?: number;
+    /** Model capabilities */
+    capabilities: ModelCapabilities;
+    /** Token pricing (if available) */
+    pricing?: TokenPricing;
+    /** Whether this model is deprecated */
+    deprecated?: boolean;
+    /** Recommended replacement model if deprecated */
+    replacement?: string;
+    /** Release date */
+    releaseDate?: string;
+    /** Additional model-specific metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    /** Provider identifier */
+    id: ProviderId;
+    /** Display name */
+    name: string;
+    /** Provider description */
+    description: string;
+    /** Base API URL */
+    baseUrl: string;
+    /** Required environment variables */
+    requiredEnvVars: string[];
+    /** Optional environment variables */
+    optionalEnvVars?: string[];
+    /** Whether provider supports streaming */
+    supportsStreaming: boolean;
+    /** API documentation URL */
+    docsUrl?: string;
+    /** Available models for this provider */
+    models: ModelMetadata[];
+}
+/**
+ * Credential configuration for a provider
+ */
+export interface ProviderCredentials {
+    /** API key or token */
+    apiKey?: string;
+    /** Base URL override */
+    baseUrl?: string;
+    /** Organization ID (for providers that support it) */
+    organizationId?: string;
+    /** Project ID (for providers that support it) */
+    projectId?: string;
+    /** Region (for cloud providers) */
+    region?: string;
+    /** Additional provider-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Provider instance with credentials
+ */
+export interface ProviderInstance {
+    /** Provider configuration */
+    config: ProviderConfig;
+    /** Active credentials */
+    credentials: ProviderCredentials;
+    /** Check if provider is properly configured */
+    isConfigured: () => boolean;
+    /** Get a specific model by ID */
+    getModel: (modelId: string) => ModelMetadata | undefined;
+    /** List all available models */
+    listModels: () => ModelMetadata[];
+    /** List models with specific capability */
+    listModelsWithCapability: (capability: keyof ModelCapabilities) => ModelMetadata[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * LLM Provider Types
+ * Core type definitions for providers, models, and capabilities
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@tashiscool/providers",
+  "version": "0.1.0",
+  "description": "LLM provider registry with model metadata and capabilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "llm",
+    "ai",
+    "providers",
+    "openai",
+    "anthropic",
+    "models",
+    "registry"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tashiscool/llm-utils.git",
+    "directory": "packages/providers"
+  }
+}