@contractspec/lib.ai-providers 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @contractspec/lib.ai-providers
+
+Website: https://contractspec.io/
+
+
+**Unified AI provider abstraction** for ContractSpec applications.
+
+## Overview
+
+This library provides a consistent interface for working with multiple LLM providers across ContractSpec. It's used by:
+
+- `@contractspec/module.ai-chat` - Vibe coding chat
+- `@contractspec/bundle.workspace` - CLI AI features
+- `@contractspec/lib.ai-agent` - Agent orchestration
+
+## Supported Providers
+
+| Provider | Local | BYOK | Managed |
+|----------|-------|------|---------|
+| Ollama | ✅ | - | - |
+| OpenAI | - | ✅ | ✅ |
+| Anthropic | - | ✅ | ✅ |
+| Mistral | - | ✅ | ✅ |
+| Google Gemini | - | ✅ | ✅ |
+
+## Usage
+
+### Basic Provider Creation
+
+```typescript
+import { createProvider, type ProviderConfig } from '@contractspec/lib.ai-providers';
+
+// Ollama (local)
+const ollamaProvider = createProvider({
+  provider: 'ollama',
+  model: 'llama3.2',
+});
+
+// OpenAI (BYOK)
+const openaiProvider = createProvider({
+  provider: 'openai',
+  apiKey: process.env.OPENAI_API_KEY,
+  model: 'gpt-4o',
+});
+
+// Use the model
+const model = openaiProvider.getModel();
+```
+
+### From Environment
+
+```typescript
+import { createProviderFromEnv } from '@contractspec/lib.ai-providers';
+
+// Reads from CONTRACTSPEC_AI_PROVIDER, OPENAI_API_KEY, etc.
+const provider = createProviderFromEnv();
+```
+
+### Legacy Config Support
+
+```typescript
+import { getAIProvider } from '@contractspec/lib.ai-providers';
+import type { Config } from '@contractspec/bundle.workspace';
+
+// Backwards compatible with existing Config type
+const model = getAIProvider(config);
+```
+
+## Provider Modes
+
+- **Local**: Run models locally (Ollama only)
+- **BYOK**: Bring Your Own Key for cloud providers
+- **Managed**: Use ContractSpec-managed keys via API proxy
+
+## API
+
+### Types
+
+- `ProviderName` - Supported provider names
+- `ProviderMode` - local | byok | managed
+- `ProviderConfig` - Configuration for creating a provider
+- `Provider` - Provider interface with getModel()
+- `ModelInfo` - Model metadata (context window, capabilities)
+
+### Functions
+
+- `createProvider(config)` - Create a provider instance
+- `createProviderFromEnv()` - Create from environment variables
+- `getAIProvider(config)` - Legacy compatibility function
+- `validateProvider(config)` - Check if provider is properly configured
+- `getRecommendedModels(provider)` - Get recommended models for a provider
+- `getAvailableProviders()` - List available providers with status
+

package/dist/factory.d.ts

@@ -0,0 +1,19 @@
+import { Provider, ProviderAvailability, ProviderConfig } from "./types.js";
+
+//#region src/factory.d.ts
+
+/**
+ * Create a provider from configuration
+ */
+declare function createProvider(config: ProviderConfig): Provider;
+/**
+ * Create a provider from environment variables
+ */
+declare function createProviderFromEnv(): Provider;
+/**
+ * Get all available providers with their status
+ */
+declare function getAvailableProviders(): ProviderAvailability[];
+//#endregion
+export { createProvider, createProviderFromEnv, getAvailableProviders };
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","names":[],"sources":["../src/factory.ts"],"sourcesContent":[],"mappings":";;;;;;AAuQA;AAOgB,iBAPA,cAAA,CAOyB,MAAA,EAPF,cAOU,CAAA,EAPO,QAOP;AAqCjD;;;iBArCgB,qBAAA,CAAA,GAAyB;;;;iBAqCzB,qBAAA,CAAA,GAAyB"}

package/dist/factory.js

@@ -0,0 +1,226 @@
+import { DEFAULT_MODELS, getModelsForProvider } from "./models.js";
+import { anthropic } from "@ai-sdk/anthropic";
+import { google } from "@ai-sdk/google";
+import { mistral } from "@ai-sdk/mistral";
+import { openai } from "@ai-sdk/openai";
+import { ollama } from "ollama-ai-provider";
+
+//#region src/factory.ts
+/**
+* Base provider implementation
+*/
+var BaseProvider = class {
+	name;
+	model;
+	mode;
+	config;
+	cachedModel = null;
+	constructor(config) {
+		this.name = config.provider;
+		this.model = config.model ?? DEFAULT_MODELS[config.provider];
+		this.mode = this.determineMode(config);
+		this.config = config;
+	}
+	getModel() {
+		if (!this.cachedModel) this.cachedModel = this.createModel();
+		return this.cachedModel;
+	}
+	async listModels() {
+		if (this.name === "ollama") return this.listOllamaModels();
+		return getModelsForProvider(this.name);
+	}
+	async validate() {
+		if (this.name === "ollama") return this.validateOllama();
+		if (this.mode === "byok" && !this.config.apiKey) return {
+			valid: false,
+			error: `API key required for ${this.name}`
+		};
+		if (this.mode === "managed" && !this.config.proxyUrl && !this.config.organizationId) return {
+			valid: false,
+			error: "Managed mode requires proxyUrl or organizationId"
+		};
+		return { valid: true };
+	}
+	determineMode(config) {
+		if (config.provider === "ollama") return "local";
+		if (config.apiKey) return "byok";
+		return "managed";
+	}
+	createModel() {
+		const { baseUrl, proxyUrl } = this.config;
+		switch (this.name) {
+			case "ollama": {
+				const originalBaseUrl = process.env.OLLAMA_BASE_URL;
+				if (baseUrl && baseUrl !== "http://localhost:11434") process.env.OLLAMA_BASE_URL = baseUrl;
+				const ollamaModel = ollama(this.model);
+				if (originalBaseUrl !== void 0) process.env.OLLAMA_BASE_URL = originalBaseUrl;
+				else if (baseUrl && baseUrl !== "http://localhost:11434") delete process.env.OLLAMA_BASE_URL;
+				return ollamaModel;
+			}
+			case "openai":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return openai(this.model);
+			case "anthropic":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return anthropic(this.model);
+			case "mistral":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return mistral(this.model);
+			case "gemini":
+				if (this.mode === "managed") {
+					const originalBaseUrl = process.env.OPENAI_BASE_URL;
+					if (proxyUrl) process.env.OPENAI_BASE_URL = proxyUrl;
+					const model = openai(this.model);
+					if (originalBaseUrl !== void 0) process.env.OPENAI_BASE_URL = originalBaseUrl;
+					else if (proxyUrl) delete process.env.OPENAI_BASE_URL;
+					return model;
+				}
+				return google(this.model);
+			default: throw new Error(`Unknown provider: ${this.name}`);
+		}
+	}
+	async listOllamaModels() {
+		try {
+			const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+			const response = await fetch(`${baseUrl}/api/tags`);
+			if (!response.ok) return getModelsForProvider("ollama");
+			return ((await response.json()).models ?? []).map((m) => ({
+				id: m.name,
+				name: m.name,
+				provider: "ollama",
+				contextWindow: 8e3,
+				capabilities: {
+					vision: false,
+					tools: false,
+					reasoning: false,
+					streaming: true
+				}
+			}));
+		} catch {
+			return getModelsForProvider("ollama");
+		}
+	}
+	async validateOllama() {
+		try {
+			const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+			const response = await fetch(`${baseUrl}/api/tags`);
+			if (!response.ok) return {
+				valid: false,
+				error: `Ollama server returned ${response.status}`
+			};
+			const models = (await response.json()).models ?? [];
+			if (!models.some((m) => m.name === this.model)) return {
+				valid: false,
+				error: `Model "${this.model}" not found. Available: ${models.map((m) => m.name).join(", ")}`
+			};
+			return { valid: true };
+		} catch (error) {
+			return {
+				valid: false,
+				error: `Cannot connect to Ollama at ${this.config.baseUrl ?? "http://localhost:11434"}: ${error instanceof Error ? error.message : String(error)}`
+			};
+		}
+	}
+};
+/**
+* Create a provider from configuration
+*/
+function createProvider(config) {
+	return new BaseProvider(config);
+}
+/**
+* Create a provider from environment variables
+*/
+function createProviderFromEnv() {
+	const provider = process.env.CONTRACTSPEC_AI_PROVIDER ?? "openai";
+	const model = process.env.CONTRACTSPEC_AI_MODEL;
+	let apiKey;
+	switch (provider) {
+		case "openai":
+			apiKey = process.env.OPENAI_API_KEY;
+			break;
+		case "anthropic":
+			apiKey = process.env.ANTHROPIC_API_KEY;
+			break;
+		case "mistral":
+			apiKey = process.env.MISTRAL_API_KEY;
+			break;
+		case "gemini":
+			apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+			break;
+		case "ollama": break;
+	}
+	return createProvider({
+		provider,
+		model,
+		apiKey,
+		baseUrl: process.env.OLLAMA_BASE_URL,
+		proxyUrl: process.env.CONTRACTSPEC_AI_PROXY_URL,
+		organizationId: process.env.CONTRACTSPEC_ORG_ID
+	});
+}
+/**
+* Get all available providers with their status
+*/
+function getAvailableProviders() {
+	const providers = [];
+	providers.push({
+		provider: "ollama",
+		available: true,
+		mode: "local"
+	});
+	const openaiKey = process.env.OPENAI_API_KEY;
+	providers.push({
+		provider: "openai",
+		available: Boolean(openaiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: openaiKey ? "byok" : "managed",
+		reason: !openaiKey ? "Set OPENAI_API_KEY for BYOK mode" : void 0
+	});
+	const anthropicKey = process.env.ANTHROPIC_API_KEY;
+	providers.push({
+		provider: "anthropic",
+		available: Boolean(anthropicKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: anthropicKey ? "byok" : "managed",
+		reason: !anthropicKey ? "Set ANTHROPIC_API_KEY for BYOK mode" : void 0
+	});
+	const mistralKey = process.env.MISTRAL_API_KEY;
+	providers.push({
+		provider: "mistral",
+		available: Boolean(mistralKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: mistralKey ? "byok" : "managed",
+		reason: !mistralKey ? "Set MISTRAL_API_KEY for BYOK mode" : void 0
+	});
+	const geminiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+	providers.push({
+		provider: "gemini",
+		available: Boolean(geminiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),
+		mode: geminiKey ? "byok" : "managed",
+		reason: !geminiKey ? "Set GOOGLE_API_KEY for BYOK mode" : void 0
+	});
+	return providers;
+}
+
+//#endregion
+export { createProvider, createProviderFromEnv, getAvailableProviders };
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","names":["apiKey: string | undefined","providers: ProviderAvailability[]"],"sources":["../src/factory.ts"],"sourcesContent":["/**\n * Provider factory and creation utilities\n */\nimport type { LanguageModel } from 'ai';\nimport { anthropic } from '@ai-sdk/anthropic';\nimport { google } from '@ai-sdk/google';\nimport { mistral } from '@ai-sdk/mistral';\nimport { openai } from '@ai-sdk/openai';\nimport { ollama } from 'ollama-ai-provider';\nimport type {\n  ModelInfo,\n  Provider,\n  ProviderAvailability,\n  ProviderConfig,\n  ProviderMode,\n  ProviderName,\n} from './types';\nimport { DEFAULT_MODELS, getModelsForProvider } from './models';\n\n/**\n * Base provider implementation\n */\nclass BaseProvider implements Provider {\n  readonly name: ProviderName;\n  readonly model: string;\n  readonly mode: ProviderMode;\n\n  private readonly config: ProviderConfig;\n  private cachedModel: LanguageModel | null = null;\n\n  constructor(config: ProviderConfig) {\n    this.name = config.provider;\n    this.model = config.model ?? DEFAULT_MODELS[config.provider];\n    this.mode = this.determineMode(config);\n    this.config = config;\n  }\n\n  getModel(): LanguageModel {\n    if (!this.cachedModel) {\n      this.cachedModel = this.createModel();\n    }\n    return this.cachedModel;\n  }\n\n  async listModels(): Promise<ModelInfo[]> {\n    if (this.name === 'ollama') {\n      return this.listOllamaModels();\n    }\n    return getModelsForProvider(this.name);\n  }\n\n  async validate(): Promise<{ valid: boolean; error?: string }> {\n    if (this.name === 'ollama') {\n      return this.validateOllama();\n    }\n\n    if (this.mode === 'byok' && !this.config.apiKey) {\n      return {\n        valid: false,\n        error: `API key required for ${this.name}`,\n      };\n    }\n\n    if (\n      this.mode === 'managed' &&\n      !this.config.proxyUrl &&\n      !this.config.organizationId\n    ) {\n      return {\n        valid: false,\n        error: 'Managed mode requires proxyUrl or organizationId',\n      };\n    }\n\n    return { valid: true };\n  }\n\n  private determineMode(config: ProviderConfig): ProviderMode {\n    if (config.provider === 'ollama') return 'local';\n    if (config.apiKey) return 'byok';\n    return 'managed';\n  }\n\n  private createModel(): LanguageModel {\n    const { baseUrl, proxyUrl } = this.config;\n\n    switch (this.name) {\n      case 'ollama': {\n        // For Ollama, set the base URL via environment variable\n        const originalBaseUrl = process.env.OLLAMA_BASE_URL;\n        if (baseUrl && baseUrl !== 'http://localhost:11434') {\n          process.env.OLLAMA_BASE_URL = baseUrl;\n        }\n\n        const ollamaModel = ollama(this.model);\n\n        // Restore original environment variable\n        if (originalBaseUrl !== undefined) {\n          process.env.OLLAMA_BASE_URL = originalBaseUrl;\n        } else if (baseUrl && baseUrl !== 'http://localhost:11434') {\n          delete process.env.OLLAMA_BASE_URL;\n        }\n\n        return ollamaModel as unknown as LanguageModel;\n      }\n\n      case 'openai':\n        if (this.mode === 'managed') {\n          // For managed mode, use proxy URL via environment variable\n          const originalBaseUrl = process.env.OPENAI_BASE_URL;\n          if (proxyUrl) {\n            process.env.OPENAI_BASE_URL = proxyUrl;\n          }\n\n          const model = openai(this.model);\n\n          // Restore original environment variable\n          if (originalBaseUrl !== undefined) {\n            process.env.OPENAI_BASE_URL = originalBaseUrl;\n          } else if (proxyUrl) {\n            delete process.env.OPENAI_BASE_URL;\n          }\n\n          return model;\n        }\n        return openai(this.model);\n\n      case 'anthropic':\n        if (this.mode === 'managed') {\n          // For managed mode with Anthropic, we use the proxy via openai\n          const originalBaseUrl = process.env.OPENAI_BASE_URL;\n          if (proxyUrl) {\n            process.env.OPENAI_BASE_URL = proxyUrl;\n          }\n\n          const model = openai(this.model);\n\n          // Restore original environment variable\n          if (originalBaseUrl !== undefined) {\n            process.env.OPENAI_BASE_URL = originalBaseUrl;\n          } else if (proxyUrl) {\n            delete process.env.OPENAI_BASE_URL;\n          }\n\n          return model;\n        }\n        return anthropic(this.model);\n\n      case 'mistral':\n        if (this.mode === 'managed') {\n          // For managed mode with Mistral, we use the proxy via openai\n          const originalBaseUrl = process.env.OPENAI_BASE_URL;\n          if (proxyUrl) {\n            process.env.OPENAI_BASE_URL = proxyUrl;\n          }\n\n          const model = openai(this.model);\n\n          // Restore original environment variable\n          if (originalBaseUrl !== undefined) {\n            process.env.OPENAI_BASE_URL = originalBaseUrl;\n          } else if (proxyUrl) {\n            delete process.env.OPENAI_BASE_URL;\n          }\n\n          return model;\n        }\n        return mistral(this.model);\n\n      case 'gemini':\n        if (this.mode === 'managed') {\n          // For managed mode with Gemini, we use the proxy via openai\n          const originalBaseUrl = process.env.OPENAI_BASE_URL;\n          if (proxyUrl) {\n            process.env.OPENAI_BASE_URL = proxyUrl;\n          }\n\n          const model = openai(this.model);\n\n          // Restore original environment variable\n          if (originalBaseUrl !== undefined) {\n            process.env.OPENAI_BASE_URL = originalBaseUrl;\n          } else if (proxyUrl) {\n            delete process.env.OPENAI_BASE_URL;\n          }\n\n          return model;\n        }\n        return google(this.model);\n\n      default:\n        throw new Error(`Unknown provider: ${this.name}`);\n    }\n  }\n\n  private async listOllamaModels(): Promise<ModelInfo[]> {\n    try {\n      const baseUrl = this.config.baseUrl ?? 'http://localhost:11434';\n      const response = await fetch(`${baseUrl}/api/tags`);\n      if (!response.ok) {\n        return getModelsForProvider('ollama');\n      }\n\n      const data = (await response.json()) as {\n        models?: { name: string; size?: number }[];\n      };\n      const models = data.models ?? [];\n\n      return models.map((m) => ({\n        id: m.name,\n        name: m.name,\n        provider: 'ollama' as const,\n        contextWindow: 8000,\n        capabilities: {\n          vision: false,\n          tools: false,\n          reasoning: false,\n          streaming: true,\n        },\n      }));\n    } catch {\n      return getModelsForProvider('ollama');\n    }\n  }\n\n  private async validateOllama(): Promise<{ valid: boolean; error?: string }> {\n    try {\n      const baseUrl = this.config.baseUrl ?? 'http://localhost:11434';\n      const response = await fetch(`${baseUrl}/api/tags`);\n      if (!response.ok) {\n        return {\n          valid: false,\n          error: `Ollama server returned ${response.status}`,\n        };\n      }\n\n      const data = (await response.json()) as {\n        models?: { name: string }[];\n      };\n      const models = data.models ?? [];\n      const hasModel = models.some((m) => m.name === this.model);\n\n      if (!hasModel) {\n        return {\n          valid: false,\n          error: `Model \"${this.model}\" not found. Available: ${models.map((m) => m.name).join(', ')}`,\n        };\n      }\n\n      return { valid: true };\n    } catch (error) {\n      const baseUrl = this.config.baseUrl ?? 'http://localhost:11434';\n      return {\n        valid: false,\n        error: `Cannot connect to Ollama at ${baseUrl}: ${error instanceof Error ? error.message : String(error)}`,\n      };\n    }\n  }\n}\n\n/**\n * Create a provider from configuration\n */\nexport function createProvider(config: ProviderConfig): Provider {\n  return new BaseProvider(config);\n}\n\n/**\n * Create a provider from environment variables\n */\nexport function createProviderFromEnv(): Provider {\n  const provider =\n    (process.env.CONTRACTSPEC_AI_PROVIDER as ProviderName) ?? 'openai';\n  const model = process.env.CONTRACTSPEC_AI_MODEL;\n\n  let apiKey: string | undefined;\n  switch (provider) {\n    case 'openai':\n      apiKey = process.env.OPENAI_API_KEY;\n      break;\n    case 'anthropic':\n      apiKey = process.env.ANTHROPIC_API_KEY;\n      break;\n    case 'mistral':\n      apiKey = process.env.MISTRAL_API_KEY;\n      break;\n    case 'gemini':\n      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;\n      break;\n    case 'ollama':\n      // No API key needed\n      break;\n  }\n\n  return createProvider({\n    provider,\n    model,\n    apiKey,\n    baseUrl: process.env.OLLAMA_BASE_URL,\n    proxyUrl: process.env.CONTRACTSPEC_AI_PROXY_URL,\n    organizationId: process.env.CONTRACTSPEC_ORG_ID,\n  });\n}\n\n/**\n * Get all available providers with their status\n */\nexport function getAvailableProviders(): ProviderAvailability[] {\n  const providers: ProviderAvailability[] = [];\n\n  // Ollama (local)\n  providers.push({\n    provider: 'ollama',\n    available: true,\n    mode: 'local',\n  });\n\n  // OpenAI\n  const openaiKey = process.env.OPENAI_API_KEY;\n  providers.push({\n    provider: 'openai',\n    available:\n      Boolean(openaiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),\n    mode: openaiKey ? 'byok' : 'managed',\n    reason: !openaiKey ? 'Set OPENAI_API_KEY for BYOK mode' : undefined,\n  });\n\n  // Anthropic\n  const anthropicKey = process.env.ANTHROPIC_API_KEY;\n  providers.push({\n    provider: 'anthropic',\n    available:\n      Boolean(anthropicKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),\n    mode: anthropicKey ? 'byok' : 'managed',\n    reason: !anthropicKey ? 'Set ANTHROPIC_API_KEY for BYOK mode' : undefined,\n  });\n\n  // Mistral\n  const mistralKey = process.env.MISTRAL_API_KEY;\n  providers.push({\n    provider: 'mistral',\n    available:\n      Boolean(mistralKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),\n    mode: mistralKey ? 'byok' : 'managed',\n    reason: !mistralKey ? 'Set MISTRAL_API_KEY for BYOK mode' : undefined,\n  });\n\n  // Gemini\n  const geminiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;\n  providers.push({\n    provider: 'gemini',\n    available:\n      Boolean(geminiKey) || Boolean(process.env.CONTRACTSPEC_AI_PROXY_URL),\n    mode: geminiKey ? 'byok' : 'managed',\n    reason: !geminiKey ? 'Set GOOGLE_API_KEY for BYOK mode' : undefined,\n  });\n\n  return providers;\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { LegacyConfig, LegacyProviderName, ModelCapabilities, ModelInfo, Provider, ProviderAvailability, ProviderConfig, ProviderMode, ProviderName } from "./types.js";
+import { createProvider, createProviderFromEnv, getAvailableProviders } from "./factory.js";
+import { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels } from "./models.js";
+import { ValidationResult, getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider as validateProvider$1 } from "./validation.js";
+import { getAIProvider, validateProvider } from "./legacy.js";
+export { DEFAULT_MODELS, LegacyConfig, LegacyProviderName, MODELS, ModelCapabilities, ModelInfo, Provider, ProviderAvailability, ProviderConfig, ProviderMode, ProviderName, ValidationResult, createProvider, createProviderFromEnv, getAIProvider, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider as validateLegacyProvider, validateProvider$1 as validateProvider };

package/dist/index.js

@@ -0,0 +1,6 @@
+import { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels } from "./models.js";
+import { createProvider, createProviderFromEnv, getAvailableProviders } from "./factory.js";
+import { getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider as validateProvider$1 } from "./validation.js";
+import { getAIProvider, validateProvider } from "./legacy.js";
+
+export { DEFAULT_MODELS, MODELS, createProvider, createProviderFromEnv, getAIProvider, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider as validateLegacyProvider, validateProvider$1 as validateProvider };

package/dist/legacy.d.ts

@@ -0,0 +1,24 @@
+import { LegacyConfig } from "./types.js";
+import { getRecommendedModels } from "./models.js";
+import { LanguageModel } from "ai";
+
+//#region src/legacy.d.ts
+
+/**
+ * Get AI provider from legacy Config type
+ *
+ * @deprecated Use createProvider() instead
+ */
+declare function getAIProvider(config: LegacyConfig): LanguageModel;
+/**
+ * Validate provider from legacy Config type
+ *
+ * @deprecated Use validateProvider() from './validation' instead
+ */
+declare function validateProvider(config: LegacyConfig): Promise<{
+  success: boolean;
+  error?: string;
+}>;
+//#endregion
+export { getAIProvider, getRecommendedModels, validateProvider };
+//# sourceMappingURL=legacy.d.ts.map

package/dist/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","names":[],"sources":["../src/legacy.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;iBA8BgB,aAAA,SAAsB,eAAe;;;;;;iBAmC/B,gBAAA,SACZ,eACP"}

package/dist/legacy.js

@@ -0,0 +1,73 @@
+import { getRecommendedModels } from "./models.js";
+import { createProvider } from "./factory.js";
+
+//#region src/legacy.ts
+/**
+* Map legacy provider names to new ones
+*/
+function mapLegacyProvider(legacy) {
+	switch (legacy) {
+		case "claude": return "anthropic";
+		case "custom": return "openai";
+		default: return legacy;
+	}
+}
+/**
+* Get AI provider from legacy Config type
+*
+* @deprecated Use createProvider() instead
+*/
+function getAIProvider(config) {
+	const provider = mapLegacyProvider(config.aiProvider);
+	let apiKey;
+	switch (provider) {
+		case "openai":
+			apiKey = process.env.OPENAI_API_KEY;
+			break;
+		case "anthropic":
+			apiKey = process.env.ANTHROPIC_API_KEY;
+			break;
+		case "mistral":
+			apiKey = process.env.MISTRAL_API_KEY;
+			break;
+		case "gemini":
+			apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+			break;
+	}
+	return createProvider({
+		provider,
+		model: config.aiModel,
+		apiKey,
+		baseUrl: config.customEndpoint
+	}).getModel();
+}
+/**
+* Validate provider from legacy Config type
+*
+* @deprecated Use validateProvider() from './validation' instead
+*/
+async function validateProvider(config) {
+	const provider = mapLegacyProvider(config.aiProvider);
+	if (provider === "ollama") return { success: true };
+	if (provider === "anthropic" && !process.env.ANTHROPIC_API_KEY) return {
+		success: false,
+		error: "ANTHROPIC_API_KEY environment variable not set"
+	};
+	if (provider === "openai" && !process.env.OPENAI_API_KEY) return {
+		success: false,
+		error: "OPENAI_API_KEY environment variable not set"
+	};
+	if (provider === "mistral" && !process.env.MISTRAL_API_KEY) return {
+		success: false,
+		error: "MISTRAL_API_KEY environment variable not set"
+	};
+	if (provider === "gemini" && !process.env.GOOGLE_API_KEY && !process.env.GEMINI_API_KEY) return {
+		success: false,
+		error: "GOOGLE_API_KEY or GEMINI_API_KEY environment variable not set"
+	};
+	return { success: true };
+}
+
+//#endregion
+export { getAIProvider, getRecommendedModels, validateProvider };
+//# sourceMappingURL=legacy.js.map

package/dist/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","names":["apiKey: string | undefined"],"sources":["../src/legacy.ts"],"sourcesContent":["/**\n * Legacy compatibility layer\n *\n * Provides backwards-compatible functions for existing code\n * that uses the old provider API from contractspec-workspace.\n */\nimport type { LanguageModel } from 'ai';\nimport type { LegacyConfig, ProviderName } from './types';\nimport { createProvider } from './factory';\nimport { getRecommendedModels as getModels } from './models';\n\n/**\n * Map legacy provider names to new ones\n */\nfunction mapLegacyProvider(legacy: LegacyConfig['aiProvider']): ProviderName {\n  switch (legacy) {\n    case 'claude':\n      return 'anthropic';\n    case 'custom':\n      return 'openai'; // Custom endpoints use OpenAI-compatible API\n    default:\n      return legacy as ProviderName;\n  }\n}\n\n/**\n * Get AI provider from legacy Config type\n *\n * @deprecated Use createProvider() instead\n */\nexport function getAIProvider(config: LegacyConfig): LanguageModel {\n  const provider = mapLegacyProvider(config.aiProvider);\n\n  // Get API key from environment\n  let apiKey: string | undefined;\n  switch (provider) {\n    case 'openai':\n      apiKey = process.env.OPENAI_API_KEY;\n      break;\n    case 'anthropic':\n      apiKey = process.env.ANTHROPIC_API_KEY;\n      break;\n    case 'mistral':\n      apiKey = process.env.MISTRAL_API_KEY;\n      break;\n    case 'gemini':\n      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;\n      break;\n  }\n\n  const instance = createProvider({\n    provider,\n    model: config.aiModel,\n    apiKey,\n    baseUrl: config.customEndpoint,\n  });\n\n  return instance.getModel();\n}\n\n/**\n * Validate provider from legacy Config type\n *\n * @deprecated Use validateProvider() from './validation' instead\n */\nexport async function validateProvider(\n  config: LegacyConfig\n): Promise<{ success: boolean; error?: string }> {\n  const provider = mapLegacyProvider(config.aiProvider);\n\n  // For Ollama, we can't easily validate without making a request\n  if (provider === 'ollama') {\n    return { success: true };\n  }\n\n  // For cloud providers, check API key exists\n  if (provider === 'anthropic' && !process.env.ANTHROPIC_API_KEY) {\n    return {\n      success: false,\n      error: 'ANTHROPIC_API_KEY environment variable not set',\n    };\n  }\n\n  if (provider === 'openai' && !process.env.OPENAI_API_KEY) {\n    return {\n      success: false,\n      error: 'OPENAI_API_KEY environment variable not set',\n    };\n  }\n\n  if (provider === 'mistral' && !process.env.MISTRAL_API_KEY) {\n    return {\n      success: false,\n      error: 'MISTRAL_API_KEY environment variable not set',\n    };\n  }\n\n  if (\n    provider === 'gemini' &&\n    !process.env.GOOGLE_API_KEY &&\n    !process.env.GEMINI_API_KEY\n  ) {\n    return {\n      success: false,\n      error: 'GOOGLE_API_KEY or GEMINI_API_KEY environment variable not set',\n    };\n  }\n\n  return { success: true };\n}\n\n/**\n * Get recommended models for legacy provider name\n *\n * @deprecated Use getModelsForProvider() instead\n */\nexport { getModels as getRecommendedModels };\n"],"mappings":";;;;;;;AAcA,SAAS,kBAAkB,QAAkD;AAC3E,SAAQ,QAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,QACE,QAAO;;;;;;;;AASb,SAAgB,cAAc,QAAqC;CACjE,MAAM,WAAW,kBAAkB,OAAO,WAAW;CAGrD,IAAIA;AACJ,SAAQ,UAAR;EACE,KAAK;AACH,YAAS,QAAQ,IAAI;AACrB;EACF,KAAK;AACH,YAAS,QAAQ,IAAI;AACrB;EACF,KAAK;AACH,YAAS,QAAQ,IAAI;AACrB;EACF,KAAK;AACH,YAAS,QAAQ,IAAI,kBAAkB,QAAQ,IAAI;AACnD;;AAUJ,QAPiB,eAAe;EAC9B;EACA,OAAO,OAAO;EACd;EACA,SAAS,OAAO;EACjB,CAAC,CAEc,UAAU;;;;;;;AAQ5B,eAAsB,iBACpB,QAC+C;CAC/C,MAAM,WAAW,kBAAkB,OAAO,WAAW;AAGrD,KAAI,aAAa,SACf,QAAO,EAAE,SAAS,MAAM;AAI1B,KAAI,aAAa,eAAe,CAAC,QAAQ,IAAI,kBAC3C,QAAO;EACL,SAAS;EACT,OAAO;EACR;AAGH,KAAI,aAAa,YAAY,CAAC,QAAQ,IAAI,eACxC,QAAO;EACL,SAAS;EACT,OAAO;EACR;AAGH,KAAI,aAAa,aAAa,CAAC,QAAQ,IAAI,gBACzC,QAAO;EACL,SAAS;EACT,OAAO;EACR;AAGH,KACE,aAAa,YACb,CAAC,QAAQ,IAAI,kBACb,CAAC,QAAQ,IAAI,eAEb,QAAO;EACL,SAAS;EACT,OAAO;EACR;AAGH,QAAO,EAAE,SAAS,MAAM"}

package/dist/models.d.ts

@@ -0,0 +1,31 @@
+import { ModelInfo, ProviderName } from "./types.js";
+
+//#region src/models.d.ts
+
+/**
+ * Default models per provider
+ */
+declare const DEFAULT_MODELS: Record<ProviderName, string>;
+/**
+ * All recommended models with metadata
+ */
+declare const MODELS: ModelInfo[];
+/**
+ * Get models for a specific provider
+ */
+declare function getModelsForProvider(provider: ProviderName): ModelInfo[];
+/**
+ * Get model info by ID
+ */
+declare function getModelInfo(modelId: string): ModelInfo | undefined;
+/**
+ * Get recommended models for a provider (legacy format)
+ */
+declare function getRecommendedModels(provider: ProviderName | 'claude' | 'custom'): string[];
+/**
+ * Get default model for a provider
+ */
+declare function getDefaultModel(provider: ProviderName): string;
+//#endregion
+export { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels };
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","names":[],"sources":["../src/models.ts"],"sourcesContent":[],"mappings":";;;;AAmBA;AAwOA;AAOA;AAOgB,cAjQH,cAiQuB,EAjQP,MAkQjB,CAlQwB,YAkQZ,EAAA,MAAA,CAAA;AAkBxB;;;cAzQa,QAAQ;;;;iBAwOL,oBAAA,WAA+B,eAAe;;;;iBAO9C,YAAA,mBAA+B;;;;iBAO/B,oBAAA,WACJ;;;;iBAkBI,eAAA,WAA0B"}

package/dist/models.js

@@ -0,0 +1,300 @@
+//#region src/models.ts
+/**
+* Default models per provider
+*/
+const DEFAULT_MODELS = {
+	ollama: "llama3.2",
+	openai: "gpt-4o",
+	anthropic: "claude-sonnet-4-20250514",
+	mistral: "mistral-large-latest",
+	gemini: "gemini-2.0-flash"
+};
+/**
+* All recommended models with metadata
+*/
+const MODELS = [
+	{
+		id: "llama3.2",
+		name: "Llama 3.2",
+		provider: "ollama",
+		contextWindow: 128e3,
+		capabilities: {
+			vision: false,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		}
+	},
+	{
+		id: "codellama",
+		name: "Code Llama",
+		provider: "ollama",
+		contextWindow: 16e3,
+		capabilities: {
+			vision: false,
+			tools: false,
+			reasoning: false,
+			streaming: true
+		}
+	},
+	{
+		id: "deepseek-coder",
+		name: "DeepSeek Coder",
+		provider: "ollama",
+		contextWindow: 16e3,
+		capabilities: {
+			vision: false,
+			tools: false,
+			reasoning: false,
+			streaming: true
+		}
+	},
+	{
+		id: "mistral",
+		name: "Mistral 7B",
+		provider: "ollama",
+		contextWindow: 32e3,
+		capabilities: {
+			vision: false,
+			tools: false,
+			reasoning: false,
+			streaming: true
+		}
+	},
+	{
+		id: "gpt-4o",
+		name: "GPT-4o",
+		provider: "openai",
+		contextWindow: 128e3,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 2.5,
+			output: 10
+		}
+	},
+	{
+		id: "gpt-4o-mini",
+		name: "GPT-4o Mini",
+		provider: "openai",
+		contextWindow: 128e3,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .15,
+			output: .6
+		}
+	},
+	{
+		id: "o1",
+		name: "o1",
+		provider: "openai",
+		contextWindow: 2e5,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: true,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 15,
+			output: 60
+		}
+	},
+	{
+		id: "o1-mini",
+		name: "o1 Mini",
+		provider: "openai",
+		contextWindow: 128e3,
+		capabilities: {
+			vision: false,
+			tools: true,
+			reasoning: true,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 3,
+			output: 12
+		}
+	},
+	{
+		id: "claude-sonnet-4-20250514",
+		name: "Claude Sonnet 4",
+		provider: "anthropic",
+		contextWindow: 2e5,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: true,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 3,
+			output: 15
+		}
+	},
+	{
+		id: "claude-3-5-sonnet-20241022",
+		name: "Claude 3.5 Sonnet",
+		provider: "anthropic",
+		contextWindow: 2e5,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 3,
+			output: 15
+		}
+	},
+	{
+		id: "claude-3-5-haiku-20241022",
+		name: "Claude 3.5 Haiku",
+		provider: "anthropic",
+		contextWindow: 2e5,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .8,
+			output: 4
+		}
+	},
+	{
+		id: "mistral-large-latest",
+		name: "Mistral Large",
+		provider: "mistral",
+		contextWindow: 128e3,
+		capabilities: {
+			vision: false,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 2,
+			output: 6
+		}
+	},
+	{
+		id: "codestral-latest",
+		name: "Codestral",
+		provider: "mistral",
+		contextWindow: 32e3,
+		capabilities: {
+			vision: false,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .2,
+			output: .6
+		}
+	},
+	{
+		id: "mistral-small-latest",
+		name: "Mistral Small",
+		provider: "mistral",
+		contextWindow: 32e3,
+		capabilities: {
+			vision: false,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .2,
+			output: .6
+		}
+	},
+	{
+		id: "gemini-2.0-flash",
+		name: "Gemini 2.0 Flash",
+		provider: "gemini",
+		contextWindow: 1e6,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: false,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .075,
+			output: .3
+		}
+	},
+	{
+		id: "gemini-2.5-pro-preview-06-05",
+		name: "Gemini 2.5 Pro",
+		provider: "gemini",
+		contextWindow: 1e6,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: true,
+			streaming: true
+		},
+		costPerMillion: {
+			input: 1.25,
+			output: 10
+		}
+	},
+	{
+		id: "gemini-2.5-flash-preview-05-20",
+		name: "Gemini 2.5 Flash",
+		provider: "gemini",
+		contextWindow: 1e6,
+		capabilities: {
+			vision: true,
+			tools: true,
+			reasoning: true,
+			streaming: true
+		},
+		costPerMillion: {
+			input: .15,
+			output: .6
+		}
+	}
+];
+/**
+* Get models for a specific provider
+*/
+function getModelsForProvider(provider) {
+	return MODELS.filter((m) => m.provider === provider);
+}
+/**
+* Get model info by ID
+*/
+function getModelInfo(modelId) {
+	return MODELS.find((m) => m.id === modelId);
+}
+/**
+* Get recommended models for a provider (legacy format)
+*/
+function getRecommendedModels(provider) {
+	return getModelsForProvider(provider === "claude" ? "anthropic" : provider === "custom" ? "openai" : provider).map((m) => m.id);
+}
+/**
+* Get default model for a provider
+*/
+function getDefaultModel(provider) {
+	return DEFAULT_MODELS[provider];
+}
+
+//#endregion
+export { DEFAULT_MODELS, MODELS, getDefaultModel, getModelInfo, getModelsForProvider, getRecommendedModels };
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","names":["DEFAULT_MODELS: Record<ProviderName, string>","MODELS: ModelInfo[]"],"sources":["../src/models.ts"],"sourcesContent":["/**\n * Model definitions and recommendations\n */\nimport type { ModelInfo, ProviderName } from './types';\n\n/**\n * Default models per provider\n */\nexport const DEFAULT_MODELS: Record<ProviderName, string> = {\n  ollama: 'llama3.2',\n  openai: 'gpt-4o',\n  anthropic: 'claude-sonnet-4-20250514',\n  mistral: 'mistral-large-latest',\n  gemini: 'gemini-2.0-flash',\n};\n\n/**\n * All recommended models with metadata\n */\nexport const MODELS: ModelInfo[] = [\n  // Ollama\n  {\n    id: 'llama3.2',\n    name: 'Llama 3.2',\n    provider: 'ollama',\n    contextWindow: 128000,\n    capabilities: {\n      vision: false,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n  },\n  {\n    id: 'codellama',\n    name: 'Code Llama',\n    provider: 'ollama',\n    contextWindow: 16000,\n    capabilities: {\n      vision: false,\n      tools: false,\n      reasoning: false,\n      streaming: true,\n    },\n  },\n  {\n    id: 'deepseek-coder',\n    name: 'DeepSeek Coder',\n    provider: 'ollama',\n    contextWindow: 16000,\n    capabilities: {\n      vision: false,\n      tools: false,\n      reasoning: false,\n      streaming: true,\n    },\n  },\n  {\n    id: 'mistral',\n    name: 'Mistral 7B',\n    provider: 'ollama',\n    contextWindow: 32000,\n    capabilities: {\n      vision: false,\n      tools: false,\n      reasoning: false,\n      streaming: true,\n    },\n  },\n\n  // OpenAI\n  {\n    id: 'gpt-4o',\n    name: 'GPT-4o',\n    provider: 'openai',\n    contextWindow: 128000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 2.5, output: 10 },\n  },\n  {\n    id: 'gpt-4o-mini',\n    name: 'GPT-4o Mini',\n    provider: 'openai',\n    contextWindow: 128000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.15, output: 0.6 },\n  },\n  {\n    id: 'o1',\n    name: 'o1',\n    provider: 'openai',\n    contextWindow: 200000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: true,\n      streaming: true,\n    },\n    costPerMillion: { input: 15, output: 60 },\n  },\n  {\n    id: 'o1-mini',\n    name: 'o1 Mini',\n    provider: 'openai',\n    contextWindow: 128000,\n    capabilities: {\n      vision: false,\n      tools: true,\n      reasoning: true,\n      streaming: true,\n    },\n    costPerMillion: { input: 3, output: 12 },\n  },\n\n  // Anthropic\n  {\n    id: 'claude-sonnet-4-20250514',\n    name: 'Claude Sonnet 4',\n    provider: 'anthropic',\n    contextWindow: 200000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: true,\n      streaming: true,\n    },\n    costPerMillion: { input: 3, output: 15 },\n  },\n  {\n    id: 'claude-3-5-sonnet-20241022',\n    name: 'Claude 3.5 Sonnet',\n    provider: 'anthropic',\n    contextWindow: 200000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 3, output: 15 },\n  },\n  {\n    id: 'claude-3-5-haiku-20241022',\n    name: 'Claude 3.5 Haiku',\n    provider: 'anthropic',\n    contextWindow: 200000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.8, output: 4 },\n  },\n\n  // Mistral\n  {\n    id: 'mistral-large-latest',\n    name: 'Mistral Large',\n    provider: 'mistral',\n    contextWindow: 128000,\n    capabilities: {\n      vision: false,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 2, output: 6 },\n  },\n  {\n    id: 'codestral-latest',\n    name: 'Codestral',\n    provider: 'mistral',\n    contextWindow: 32000,\n    capabilities: {\n      vision: false,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.2, output: 0.6 },\n  },\n  {\n    id: 'mistral-small-latest',\n    name: 'Mistral Small',\n    provider: 'mistral',\n    contextWindow: 32000,\n    capabilities: {\n      vision: false,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.2, output: 0.6 },\n  },\n\n  // Gemini\n  {\n    id: 'gemini-2.0-flash',\n    name: 'Gemini 2.0 Flash',\n    provider: 'gemini',\n    contextWindow: 1000000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: false,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.075, output: 0.3 },\n  },\n  {\n    id: 'gemini-2.5-pro-preview-06-05',\n    name: 'Gemini 2.5 Pro',\n    provider: 'gemini',\n    contextWindow: 1000000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: true,\n      streaming: true,\n    },\n    costPerMillion: { input: 1.25, output: 10 },\n  },\n  {\n    id: 'gemini-2.5-flash-preview-05-20',\n    name: 'Gemini 2.5 Flash',\n    provider: 'gemini',\n    contextWindow: 1000000,\n    capabilities: {\n      vision: true,\n      tools: true,\n      reasoning: true,\n      streaming: true,\n    },\n    costPerMillion: { input: 0.15, output: 0.6 },\n  },\n];\n\n/**\n * Get models for a specific provider\n */\nexport function getModelsForProvider(provider: ProviderName): ModelInfo[] {\n  return MODELS.filter((m) => m.provider === provider);\n}\n\n/**\n * Get model info by ID\n */\nexport function getModelInfo(modelId: string): ModelInfo | undefined {\n  return MODELS.find((m) => m.id === modelId);\n}\n\n/**\n * Get recommended models for a provider (legacy format)\n */\nexport function getRecommendedModels(\n  provider: ProviderName | 'claude' | 'custom'\n): string[] {\n  // Handle legacy provider names\n  const normalizedProvider =\n    provider === 'claude'\n      ? 'anthropic'\n      : provider === 'custom'\n        ? 'openai'\n        : provider;\n\n  return getModelsForProvider(normalizedProvider as ProviderName).map(\n    (m) => m.id\n  );\n}\n\n/**\n * Get default model for a provider\n */\nexport function getDefaultModel(provider: ProviderName): string {\n  return DEFAULT_MODELS[provider];\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,113 @@
+import { LanguageModel } from "ai";
+
+//#region src/types.d.ts
+
+/**
+ * Supported AI providers
+ */
+type ProviderName = 'ollama' | 'openai' | 'anthropic' | 'mistral' | 'gemini';
+/**
+ * Legacy provider names (for backwards compatibility)
+ */
+type LegacyProviderName = 'claude' | 'openai' | 'ollama' | 'custom';
+/**
+ * Provider mode determines how API keys are resolved
+ */
+type ProviderMode = 'local' | 'byok' | 'managed';
+/**
+ * Configuration for creating a provider
+ */
+interface ProviderConfig {
+  /** Which provider to use */
+  provider: ProviderName;
+  /** Specific model to use (optional, uses provider default) */
+  model?: string;
+  /** API key for BYOK mode */
+  apiKey?: string;
+  /** Custom base URL (for Ollama or custom endpoints) */
+  baseUrl?: string;
+  /** API proxy URL for managed mode */
+  proxyUrl?: string;
+  /** Organization/tenant ID for managed mode */
+  organizationId?: string;
+}
+/**
+ * Model capability flags
+ */
+interface ModelCapabilities {
+  /** Supports image/vision input */
+  vision: boolean;
+  /** Supports tool/function calling */
+  tools: boolean;
+  /** Supports extended thinking/reasoning */
+  reasoning: boolean;
+  /** Supports streaming */
+  streaming: boolean;
+}
+/**
+ * Model information
+ */
+interface ModelInfo {
+  /** Model identifier */
+  id: string;
+  /** Human-readable name */
+  name: string;
+  /** Provider this model belongs to */
+  provider: ProviderName;
+  /** Context window size in tokens */
+  contextWindow: number;
+  /** Model capabilities */
+  capabilities: ModelCapabilities;
+  /** Approximate cost per million tokens (input, output) */
+  costPerMillion?: {
+    input: number;
+    output: number;
+  };
+}
+/**
+ * AI Provider interface
+ */
+interface Provider {
+  /** Provider name */
+  readonly name: ProviderName;
+  /** Current model ID */
+  readonly model: string;
+  /** Provider mode */
+  readonly mode: ProviderMode;
+  /**
+   * Get the underlying AI SDK language model
+   */
+  getModel(): LanguageModel;
+  /**
+   * List available models for this provider
+   */
+  listModels(): Promise<ModelInfo[]>;
+  /**
+   * Validate the provider configuration/credentials
+   */
+  validate(): Promise<{
+    valid: boolean;
+    error?: string;
+  }>;
+}
+/**
+ * Provider availability info
+ */
+interface ProviderAvailability {
+  provider: ProviderName;
+  available: boolean;
+  mode: ProviderMode;
+  reason?: string;
+}
+/**
+ * Legacy Config type for backwards compatibility
+ * This matches the Config type from contractspec-workspace
+ */
+interface LegacyConfig {
+  aiProvider: LegacyProviderName;
+  aiModel?: string;
+  customEndpoint?: string;
+}
+//#endregion
+export { LegacyConfig, LegacyProviderName, ModelCapabilities, ModelInfo, Provider, ProviderAvailability, ProviderConfig, ProviderMode, ProviderName };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;AAkBA;AAKA;AAQA;AAkBiB,KAzCL,YAAA,GAyCsB,QAAA,GAAA,QAAA,GAAA,WAAA,GAAA,SAAA,GAAA,QAAA;AAclC;AAkBA;;AAMiB,KArEL,kBAAA,GAqEK,QAAA,GAAA,QAAA,GAAA,QAAA,GAAA,QAAA;;;;AAeH,KA/EF,YAAA,GA+EE,OAAA,GAAA,MAAA,GAAA,SAAA;;AAMd;AAWA;UAxFiB,cAAA;;YAEL;;;;;;;;;;;;;;;UAgBK,iBAAA;;;;;;;;;;;;;UAcA,SAAA;;;;;;YAML;;;;gBAII;;;;;;;;;;UAQC,QAAA;;iBAEA;;;;iBAIA;;;;cAKH;;;;gBAKE,QAAQ;;;;cAKV;;;;;;;;UAMG,oBAAA;YACL;;QAEJ;;;;;;;UAQS,YAAA;cACH"}

package/dist/validation.d.ts

@@ -0,0 +1,35 @@
+import { ProviderConfig, ProviderName } from "./types.js";
+
+//#region src/validation.d.ts
+
+/**
+ * Validation result
+ */
+interface ValidationResult {
+  valid: boolean;
+  error?: string;
+  warnings?: string[];
+}
+/**
+ * Validate a provider configuration
+ */
+declare function validateProvider(config: ProviderConfig): Promise<ValidationResult>;
+/**
+ * Check if a provider has required credentials
+ */
+declare function hasCredentials(provider: ProviderName): boolean;
+/**
+ * Get the environment variable name for a provider's API key
+ */
+declare function getEnvVarName(provider: ProviderName): string | null;
+/**
+ * Check if Ollama is running
+ */
+declare function isOllamaRunning(baseUrl?: string): Promise<boolean>;
+/**
+ * List available Ollama models
+ */
+declare function listOllamaModels(baseUrl?: string): Promise<string[]>;
+//#endregion
+export { ValidationResult, getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider };
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","names":[],"sources":["../src/validation.ts"],"sourcesContent":[],"mappings":";;;;AAkBA;;;AAEG,UAXc,gBAAA,CAWd;EAAO,KAAA,EAAA,OAAA;EAQM,KAAA,CAAA,EAAA,MAAA;EAoBA,QAAA,CAAA,EAAA,MAAa,EAAA;AAoB7B;AAcA;;;iBAhEsB,gBAAA,SACZ,iBACP,QAAQ;;;;iBAQK,cAAA,WAAyB;;;;iBAoBzB,aAAA,WAAwB;;;;iBAoBlB,eAAA,oBAEnB;;;;iBAYmB,gBAAA,oBAEnB"}

package/dist/validation.js

@@ -0,0 +1,61 @@
+import { createProvider } from "./factory.js";
+
+//#region src/validation.ts
+/**
+* Validate a provider configuration
+*/
+async function validateProvider(config) {
+	return createProvider(config).validate();
+}
+/**
+* Check if a provider has required credentials
+*/
+function hasCredentials(provider) {
+	switch (provider) {
+		case "ollama": return true;
+		case "openai": return Boolean(process.env.OPENAI_API_KEY);
+		case "anthropic": return Boolean(process.env.ANTHROPIC_API_KEY);
+		case "mistral": return Boolean(process.env.MISTRAL_API_KEY);
+		case "gemini": return Boolean(process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY);
+		default: return false;
+	}
+}
+/**
+* Get the environment variable name for a provider's API key
+*/
+function getEnvVarName(provider) {
+	switch (provider) {
+		case "ollama": return null;
+		case "openai": return "OPENAI_API_KEY";
+		case "anthropic": return "ANTHROPIC_API_KEY";
+		case "mistral": return "MISTRAL_API_KEY";
+		case "gemini": return "GOOGLE_API_KEY";
+		default: return null;
+	}
+}
+/**
+* Check if Ollama is running
+*/
+async function isOllamaRunning(baseUrl = "http://localhost:11434") {
+	try {
+		return (await fetch(`${baseUrl}/api/tags`)).ok;
+	} catch {
+		return false;
+	}
+}
+/**
+* List available Ollama models
+*/
+async function listOllamaModels(baseUrl = "http://localhost:11434") {
+	try {
+		const response = await fetch(`${baseUrl}/api/tags`);
+		if (!response.ok) return [];
+		return ((await response.json()).models ?? []).map((m) => m.name);
+	} catch {
+		return [];
+	}
+}
+
+//#endregion
+export { getEnvVarName, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider };
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","names":[],"sources":["../src/validation.ts"],"sourcesContent":["/**\n * Provider validation utilities\n */\nimport type { ProviderName, ProviderConfig } from './types';\nimport { createProvider } from './factory';\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n  warnings?: string[];\n}\n\n/**\n * Validate a provider configuration\n */\nexport async function validateProvider(\n  config: ProviderConfig\n): Promise<ValidationResult> {\n  const provider = createProvider(config);\n  return provider.validate();\n}\n\n/**\n * Check if a provider has required credentials\n */\nexport function hasCredentials(provider: ProviderName): boolean {\n  switch (provider) {\n    case 'ollama':\n      return true; // No credentials needed\n    case 'openai':\n      return Boolean(process.env.OPENAI_API_KEY);\n    case 'anthropic':\n      return Boolean(process.env.ANTHROPIC_API_KEY);\n    case 'mistral':\n      return Boolean(process.env.MISTRAL_API_KEY);\n    case 'gemini':\n      return Boolean(process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY);\n    default:\n      return false;\n  }\n}\n\n/**\n * Get the environment variable name for a provider's API key\n */\nexport function getEnvVarName(provider: ProviderName): string | null {\n  switch (provider) {\n    case 'ollama':\n      return null;\n    case 'openai':\n      return 'OPENAI_API_KEY';\n    case 'anthropic':\n      return 'ANTHROPIC_API_KEY';\n    case 'mistral':\n      return 'MISTRAL_API_KEY';\n    case 'gemini':\n      return 'GOOGLE_API_KEY';\n    default:\n      return null;\n  }\n}\n\n/**\n * Check if Ollama is running\n */\nexport async function isOllamaRunning(\n  baseUrl = 'http://localhost:11434'\n): Promise<boolean> {\n  try {\n    const response = await fetch(`${baseUrl}/api/tags`);\n    return response.ok;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * List available Ollama models\n */\nexport async function listOllamaModels(\n  baseUrl = 'http://localhost:11434'\n): Promise<string[]> {\n  try {\n    const response = await fetch(`${baseUrl}/api/tags`);\n    if (!response.ok) return [];\n\n    const data = (await response.json()) as {\n      models?: { name: string }[];\n    };\n    return (data.models ?? []).map((m) => m.name);\n  } catch {\n    return [];\n  }\n}\n"],"mappings":";;;;;;AAkBA,eAAsB,iBACpB,QAC2B;AAE3B,QADiB,eAAe,OAAO,CACvB,UAAU;;;;;AAM5B,SAAgB,eAAe,UAAiC;AAC9D,SAAQ,UAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO,QAAQ,QAAQ,IAAI,eAAe;EAC5C,KAAK,YACH,QAAO,QAAQ,QAAQ,IAAI,kBAAkB;EAC/C,KAAK,UACH,QAAO,QAAQ,QAAQ,IAAI,gBAAgB;EAC7C,KAAK,SACH,QAAO,QAAQ,QAAQ,IAAI,kBAAkB,QAAQ,IAAI,eAAe;EAC1E,QACE,QAAO;;;;;;AAOb,SAAgB,cAAc,UAAuC;AACnE,SAAQ,UAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,YACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,QACE,QAAO;;;;;;AAOb,eAAsB,gBACpB,UAAU,0BACQ;AAClB,KAAI;AAEF,UADiB,MAAM,MAAM,GAAG,QAAQ,WAAW,EACnC;SACV;AACN,SAAO;;;;;;AAOX,eAAsB,iBACpB,UAAU,0BACS;AACnB,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,WAAW;AACnD,MAAI,CAAC,SAAS,GAAI,QAAO,EAAE;AAK3B,WAHc,MAAM,SAAS,MAAM,EAGtB,UAAU,EAAE,EAAE,KAAK,MAAM,EAAE,KAAK;SACvC;AACN,SAAO,EAAE"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@contractspec/lib.ai-providers",
+  "version": "1.44.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "3.0.1",
+    "@ai-sdk/google": "3.0.1",
+    "@ai-sdk/mistral": "3.0.1",
+    "@ai-sdk/openai": "3.0.1",
+    "ai": "6.0.3",
+    "ollama-ai-provider": "^1.2.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./factory": "./dist/factory.js",
+    "./legacy": "./dist/legacy.js",
+    "./models": "./dist/models.js",
+    "./types": "./dist/types.js",
+    "./validation": "./dist/validation.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./factory": "./dist/factory.js",
+      "./legacy": "./dist/legacy.js",
+      "./models": "./dist/models.js",
+      "./types": "./dist/types.js",
+      "./validation": "./dist/validation.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/ai-providers"
+  },
+  "homepage": "https://contractspec.io"
+}