@contractspec/lib.ai-providers 3.7.6 → 3.7.8

package/README.md

@@ -1,103 +1,76 @@
 # @contractspec/lib.ai-providers
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-**Unified AI provider abstraction** for ContractSpec applications.
+**Unified AI provider abstraction layer.**
 
-## Overview
+## What It Provides
 
-This library provides a consistent interface for working with multiple LLM providers across ContractSpec. It's used by:
+- **Layer**: lib.
+- **Consumers**: ai-agent, content-gen, image-gen, voice.
+- Related ContractSpec packages include `@contractspec/lib.provider-ranking`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.provider-ranking`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
-- `@contractspec/module.ai-chat` - Vibe coding chat
-- `@contractspec/bundle.workspace` - CLI AI features
-- `@contractspec/lib.ai-agent` - Agent orchestration
+## Installation
 
-## Supported Providers
+`npm install @contractspec/lib.ai-providers`
 
-| Provider      | Local | BYOK | Managed |
-| ------------- | ----- | ---- | ------- |
-| Ollama        | ✅    | -    | -       |
-| OpenAI        | -     | ✅   | ✅      |
-| Anthropic     | -     | ✅   | ✅      |
-| Mistral       | -     | ✅   | ✅      |
-| Google Gemini | -     | ✅   | ✅      |
+or
 
-### Mistral model presets
-
-The bundled Mistral model catalog includes current families used in ContractSpec flows:
-
-- `mistral-large-latest`
-- `mistral-medium-latest`
-- `mistral-small-latest`
-- `codestral-latest`
-- `devstral-small-latest`
-- `magistral-medium-latest`
-- `pixtral-large-latest`
+`bun add @contractspec/lib.ai-providers`
 
 ## 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
+Import the root entrypoint from `@contractspec/lib.ai-providers`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/factory.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/legacy.ts` is part of the package's public or composition surface.
+- `src/models.test.ts` is part of the package's public or composition surface.
+- `src/models.ts` is part of the package's public or composition surface.
+- `src/selector-types.ts` is part of the package's public or composition surface.
+- `src/selector.ts` is part of the package's public or composition surface.
+- `src/types.ts` is shared public type definitions.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./factory` resolves through `./src/factory.ts`.
+- Export `./legacy` resolves through `./src/legacy.ts`.
+- Export `./models` resolves through `./src/models.ts`.
+- Export `./selector` resolves through `./src/selector.ts`.
+- Export `./selector-types` resolves through `./src/selector-types.ts`.
+- Export `./types` resolves through `./src/types.ts`.
+- Export `./validation` resolves through `./src/validation.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Add latest models and align defaults.
+- Resolve lint, build, and type errors across nine packages.
+- Add first-class transport, auth, versioning, and BYOK support across all integrations.
+- Add AI provider ranking system with ranking-driven model selection.
+- Add first-class mistral provider support.
+
+## Notes
+
+- Provider interface is consumed by all AI-powered libs; breaking changes cascade widely.
+- Adding new providers must not break existing factory signatures.

package/dist/browser/index.js

@@ -671,61 +671,73 @@ function getAvailableProviders() {
   });
   return providers;
 }
-// src/validation.ts
-async function validateProvider(config) {
-  const provider = createProvider(config);
-  return provider.validate();
-}
-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);
+
+// src/legacy.ts
+function mapLegacyProvider(legacy) {
+  switch (legacy) {
+    case "claude":
+      return "anthropic";
+    case "custom":
+      return "openai";
     default:
-      return false;
+      return legacy;
   }
 }
-function getEnvVarName(provider) {
+function getAIProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  let apiKey;
   switch (provider) {
-    case "ollama":
-      return null;
     case "openai":
-      return "OPENAI_API_KEY";
+      apiKey = process.env.OPENAI_API_KEY;
+      break;
     case "anthropic":
-      return "ANTHROPIC_API_KEY";
+      apiKey = process.env.ANTHROPIC_API_KEY;
+      break;
     case "mistral":
-      return "MISTRAL_API_KEY";
+      apiKey = process.env.MISTRAL_API_KEY;
+      break;
     case "gemini":
-      return "GOOGLE_API_KEY";
-    default:
-      return null;
+      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+      break;
   }
+  const instance = createProvider({
+    provider,
+    model: config.aiModel,
+    apiKey,
+    baseUrl: config.customEndpoint
+  });
+  return instance.getModel();
 }
-async function isOllamaRunning(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    return response.ok;
-  } catch {
-    return false;
+async function validateProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  if (provider === "ollama") {
+    return { success: true };
   }
-}
-async function listOllamaModels(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    if (!response.ok)
-      return [];
-    const data = await response.json();
-    return (data.models ?? []).map((m) => m.name);
-  } catch {
-    return [];
+  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 };
 }
 // src/selector.ts
 function createModelSelector(options) {
@@ -895,77 +907,65 @@ function mergeConstraints(defaults, overrides) {
     return defaults;
   return { ...defaults, ...overrides };
 }
-
-// src/legacy.ts
-function mapLegacyProvider(legacy) {
-  switch (legacy) {
-    case "claude":
-      return "anthropic";
-    case "custom":
-      return "openai";
+// src/validation.ts
+async function validateProvider2(config) {
+  const provider = createProvider(config);
+  return provider.validate();
+}
+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 legacy;
+      return false;
   }
 }
-function getAIProvider(config) {
-  const provider = mapLegacyProvider(config.aiProvider);
-  let apiKey;
+function getEnvVarName(provider) {
   switch (provider) {
+    case "ollama":
+      return null;
     case "openai":
-      apiKey = process.env.OPENAI_API_KEY;
-      break;
+      return "OPENAI_API_KEY";
     case "anthropic":
-      apiKey = process.env.ANTHROPIC_API_KEY;
-      break;
+      return "ANTHROPIC_API_KEY";
     case "mistral":
-      apiKey = process.env.MISTRAL_API_KEY;
-      break;
+      return "MISTRAL_API_KEY";
     case "gemini":
-      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
-      break;
+      return "GOOGLE_API_KEY";
+    default:
+      return null;
   }
-  const instance = createProvider({
-    provider,
-    model: config.aiModel,
-    apiKey,
-    baseUrl: config.customEndpoint
-  });
-  return instance.getModel();
 }
-async function validateProvider2(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"
-    };
+async function isOllamaRunning(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    return response.ok;
+  } catch {
+    return false;
   }
-  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"
-    };
+}
+async function listOllamaModels(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    if (!response.ok)
+      return [];
+    const data = await response.json();
+    return (data.models ?? []).map((m) => m.name);
+  } catch {
+    return [];
   }
-  return { success: true };
 }
 export {
-  validateProvider,
-  validateProvider2 as validateLegacyProvider,
+  validateProvider2 as validateProvider,
+  validateProvider as validateLegacyProvider,
   listOllamaModels,
   isOllamaRunning,
   hasCredentials,

package/dist/factory.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Provider factory and creation utilities
+ */
 import type { Provider, ProviderAvailability, ProviderConfig } from './types';
 /**
  * Create a provider from configuration

package/dist/index.d.ts

@@ -3,11 +3,11 @@
  *
  * Unified AI provider abstraction for ContractSpec applications.
  */
-export * from './types';
 export * from './factory';
+export { getAIProvider, validateProvider as validateLegacyProvider, } from './legacy';
 export * from './models';
-export * from './validation';
-export * from './selector-types';
-export { createModelSelector } from './selector';
 export type { ModelSelectorOptions } from './selector';
-export { getAIProvider, validateProvider as validateLegacyProvider, } from './legacy';
+export { createModelSelector } from './selector';
+export * from './selector-types';
+export * from './types';
+export * from './validation';

package/dist/index.js

@@ -672,61 +672,73 @@ function getAvailableProviders() {
   });
   return providers;
 }
-// src/validation.ts
-async function validateProvider(config) {
-  const provider = createProvider(config);
-  return provider.validate();
-}
-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);
+
+// src/legacy.ts
+function mapLegacyProvider(legacy) {
+  switch (legacy) {
+    case "claude":
+      return "anthropic";
+    case "custom":
+      return "openai";
     default:
-      return false;
+      return legacy;
   }
 }
-function getEnvVarName(provider) {
+function getAIProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  let apiKey;
   switch (provider) {
-    case "ollama":
-      return null;
     case "openai":
-      return "OPENAI_API_KEY";
+      apiKey = process.env.OPENAI_API_KEY;
+      break;
     case "anthropic":
-      return "ANTHROPIC_API_KEY";
+      apiKey = process.env.ANTHROPIC_API_KEY;
+      break;
     case "mistral":
-      return "MISTRAL_API_KEY";
+      apiKey = process.env.MISTRAL_API_KEY;
+      break;
     case "gemini":
-      return "GOOGLE_API_KEY";
-    default:
-      return null;
+      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+      break;
   }
+  const instance = createProvider({
+    provider,
+    model: config.aiModel,
+    apiKey,
+    baseUrl: config.customEndpoint
+  });
+  return instance.getModel();
 }
-async function isOllamaRunning(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    return response.ok;
-  } catch {
-    return false;
+async function validateProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  if (provider === "ollama") {
+    return { success: true };
   }
-}
-async function listOllamaModels(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    if (!response.ok)
-      return [];
-    const data = await response.json();
-    return (data.models ?? []).map((m) => m.name);
-  } catch {
-    return [];
+  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 };
 }
 // src/selector.ts
 function createModelSelector(options) {
@@ -896,77 +908,65 @@ function mergeConstraints(defaults, overrides) {
     return defaults;
   return { ...defaults, ...overrides };
 }
-
-// src/legacy.ts
-function mapLegacyProvider(legacy) {
-  switch (legacy) {
-    case "claude":
-      return "anthropic";
-    case "custom":
-      return "openai";
+// src/validation.ts
+async function validateProvider2(config) {
+  const provider = createProvider(config);
+  return provider.validate();
+}
+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 legacy;
+      return false;
   }
 }
-function getAIProvider(config) {
-  const provider = mapLegacyProvider(config.aiProvider);
-  let apiKey;
+function getEnvVarName(provider) {
   switch (provider) {
+    case "ollama":
+      return null;
     case "openai":
-      apiKey = process.env.OPENAI_API_KEY;
-      break;
+      return "OPENAI_API_KEY";
     case "anthropic":
-      apiKey = process.env.ANTHROPIC_API_KEY;
-      break;
+      return "ANTHROPIC_API_KEY";
     case "mistral":
-      apiKey = process.env.MISTRAL_API_KEY;
-      break;
+      return "MISTRAL_API_KEY";
     case "gemini":
-      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
-      break;
+      return "GOOGLE_API_KEY";
+    default:
+      return null;
   }
-  const instance = createProvider({
-    provider,
-    model: config.aiModel,
-    apiKey,
-    baseUrl: config.customEndpoint
-  });
-  return instance.getModel();
 }
-async function validateProvider2(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"
-    };
+async function isOllamaRunning(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    return response.ok;
+  } catch {
+    return false;
   }
-  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"
-    };
+}
+async function listOllamaModels(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    if (!response.ok)
+      return [];
+    const data = await response.json();
+    return (data.models ?? []).map((m) => m.name);
+  } catch {
+    return [];
   }
-  return { success: true };
 }
 export {
-  validateProvider,
-  validateProvider2 as validateLegacyProvider,
+  validateProvider2 as validateProvider,
+  validateProvider as validateLegacyProvider,
   listOllamaModels,
   isOllamaRunning,
   hasCredentials,

package/dist/legacy.d.ts

@@ -5,8 +5,8 @@
  * that uses the old provider API from contractspec-workspace.
  */
 import type { LanguageModel } from 'ai';
-import type { LegacyConfig } from './types';
 import { getRecommendedModels as getModels } from './models';
+import type { LegacyConfig } from './types';
 /**
  * Get AI provider from legacy Config type
  *

package/dist/node/index.js

@@ -671,61 +671,73 @@ function getAvailableProviders() {
   });
   return providers;
 }
-// src/validation.ts
-async function validateProvider(config) {
-  const provider = createProvider(config);
-  return provider.validate();
-}
-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);
+
+// src/legacy.ts
+function mapLegacyProvider(legacy) {
+  switch (legacy) {
+    case "claude":
+      return "anthropic";
+    case "custom":
+      return "openai";
     default:
-      return false;
+      return legacy;
   }
 }
-function getEnvVarName(provider) {
+function getAIProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  let apiKey;
   switch (provider) {
-    case "ollama":
-      return null;
     case "openai":
-      return "OPENAI_API_KEY";
+      apiKey = process.env.OPENAI_API_KEY;
+      break;
     case "anthropic":
-      return "ANTHROPIC_API_KEY";
+      apiKey = process.env.ANTHROPIC_API_KEY;
+      break;
     case "mistral":
-      return "MISTRAL_API_KEY";
+      apiKey = process.env.MISTRAL_API_KEY;
+      break;
     case "gemini":
-      return "GOOGLE_API_KEY";
-    default:
-      return null;
+      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
+      break;
   }
+  const instance = createProvider({
+    provider,
+    model: config.aiModel,
+    apiKey,
+    baseUrl: config.customEndpoint
+  });
+  return instance.getModel();
 }
-async function isOllamaRunning(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    return response.ok;
-  } catch {
-    return false;
+async function validateProvider(config) {
+  const provider = mapLegacyProvider(config.aiProvider);
+  if (provider === "ollama") {
+    return { success: true };
   }
-}
-async function listOllamaModels(baseUrl = "http://localhost:11434") {
-  try {
-    const response = await fetch(`${baseUrl}/api/tags`);
-    if (!response.ok)
-      return [];
-    const data = await response.json();
-    return (data.models ?? []).map((m) => m.name);
-  } catch {
-    return [];
+  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 };
 }
 // src/selector.ts
 function createModelSelector(options) {
@@ -895,77 +907,65 @@ function mergeConstraints(defaults, overrides) {
     return defaults;
   return { ...defaults, ...overrides };
 }
-
-// src/legacy.ts
-function mapLegacyProvider(legacy) {
-  switch (legacy) {
-    case "claude":
-      return "anthropic";
-    case "custom":
-      return "openai";
+// src/validation.ts
+async function validateProvider2(config) {
+  const provider = createProvider(config);
+  return provider.validate();
+}
+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 legacy;
+      return false;
   }
 }
-function getAIProvider(config) {
-  const provider = mapLegacyProvider(config.aiProvider);
-  let apiKey;
+function getEnvVarName(provider) {
   switch (provider) {
+    case "ollama":
+      return null;
     case "openai":
-      apiKey = process.env.OPENAI_API_KEY;
-      break;
+      return "OPENAI_API_KEY";
     case "anthropic":
-      apiKey = process.env.ANTHROPIC_API_KEY;
-      break;
+      return "ANTHROPIC_API_KEY";
     case "mistral":
-      apiKey = process.env.MISTRAL_API_KEY;
-      break;
+      return "MISTRAL_API_KEY";
     case "gemini":
-      apiKey = process.env.GOOGLE_API_KEY ?? process.env.GEMINI_API_KEY;
-      break;
+      return "GOOGLE_API_KEY";
+    default:
+      return null;
   }
-  const instance = createProvider({
-    provider,
-    model: config.aiModel,
-    apiKey,
-    baseUrl: config.customEndpoint
-  });
-  return instance.getModel();
 }
-async function validateProvider2(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"
-    };
+async function isOllamaRunning(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    return response.ok;
+  } catch {
+    return false;
   }
-  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"
-    };
+}
+async function listOllamaModels(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    if (!response.ok)
+      return [];
+    const data = await response.json();
+    return (data.models ?? []).map((m) => m.name);
+  } catch {
+    return [];
   }
-  return { success: true };
 }
 export {
-  validateProvider,
-  validateProvider2 as validateLegacyProvider,
+  validateProvider2 as validateProvider,
+  validateProvider as validateLegacyProvider,
   listOllamaModels,
   isOllamaRunning,
   hasCredentials,

package/dist/selector-types.d.ts

@@ -1,6 +1,6 @@
+import type { BenchmarkDimension, DimensionWeightConfig } from '@contractspec/lib.provider-ranking';
 import type { LanguageModel } from 'ai';
 import type { ModelCapabilities, ProviderName } from './types';
-import type { BenchmarkDimension, DimensionWeightConfig } from '@contractspec/lib.provider-ranking';
 export interface ModelConstraints {
     maxCostPerMillionInput?: number;
     maxCostPerMillionOutput?: number;

package/dist/selector.d.ts

@@ -1,6 +1,6 @@
 import type { ProviderRankingStore } from '@contractspec/lib.provider-ranking';
-import type { ModelInfo } from './types';
 import type { ModelConstraints, ModelSelectionContext, ModelSelectionResult, ModelSelector } from './selector-types';
+import type { ModelInfo } from './types';
 export interface ModelSelectorOptions {
     store: ProviderRankingStore;
     fallbackModels?: ModelInfo[];
@@ -13,4 +13,4 @@ export interface ModelSelectorOptions {
  * MultiObjectiveSelector when `priorities` are set.
  */
 export declare function createModelSelector(options: ModelSelectorOptions): ModelSelector;
-export type { ModelSelector, ModelSelectionContext, ModelSelectionResult, ModelConstraints, };
+export type { ModelConstraints, ModelSelectionContext, ModelSelectionResult, ModelSelector, };

package/dist/validation.d.ts

@@ -1,7 +1,7 @@
 /**
  * Provider validation utilities
  */
-import type { ProviderName, ProviderConfig } from './types';
+import type { ProviderConfig, ProviderName } from './types';
 /**
  * Validation result
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.ai-providers",
-  "version": "3.7.6",
+  "version": "3.7.8",
   "description": "Unified AI provider abstraction layer",
   "keywords": [
     "contractspec",
@@ -26,8 +26,8 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test --pass-with-no-tests",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
@@ -37,15 +37,15 @@
     "@ai-sdk/google": "3.0.43",
     "@ai-sdk/mistral": "3.0.24",
     "@ai-sdk/openai": "3.0.41",
-    "@contractspec/lib.provider-ranking": "0.7.6",
+    "@contractspec/lib.provider-ranking": "0.7.8",
     "ai": "6.0.116",
     "ollama-ai-provider": "^1.2.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "exports": {
     ".": {