@contractspec/lib.ai-providers 2.9.0 → 3.1.1

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export type ProviderName = 'ollama' | 'openai' | 'anthropic' | 'mistral' | 'gemi
 /**
  * Legacy provider names (for backwards compatibility)
  */
-export type LegacyProviderName = 'claude' | 'openai' | 'ollama' | 'custom';
+export type LegacyProviderName = 'claude' | 'openai' | 'ollama' | 'custom' | 'mistral';
 /**
  * Provider mode determines how API keys are resolved
  */
@@ -30,6 +30,14 @@ export interface ProviderConfig {
     proxyUrl?: string;
     /** Organization/tenant ID for managed mode */
     organizationId?: string;
+    /** Transport mode for the provider connection. */
+    transport?: 'rest' | 'mcp' | 'sdk';
+    /** Auth method used for this provider connection. */
+    authMethod?: 'api-key' | 'oauth2' | 'bearer';
+    /** Provider API version to target. */
+    apiVersion?: string;
+    /** Custom headers to include in requests. */
+    customHeaders?: Record<string, string>;
 }
 /**
  * Model capability flags
@@ -98,6 +106,10 @@ export interface ProviderAvailability {
     available: boolean;
     mode: ProviderMode;
     reason?: string;
+    /** Transports available for this provider. */
+    transports?: ('rest' | 'mcp' | 'sdk')[];
+    /** Auth methods available for this provider. */
+    authMethods?: ('api-key' | 'oauth2' | 'bearer')[];
 }
 /**
  * Legacy Config type for backwards compatibility

package/dist/validation.js

@@ -160,11 +160,23 @@ var MODELS = [
     },
     costPerMillion: { input: 2, output: 6 }
   },
+  {
+    id: "mistral-medium-latest",
+    name: "Mistral Medium",
+    provider: "mistral",
+    contextWindow: 128000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    }
+  },
   {
     id: "codestral-latest",
     name: "Codestral",
     provider: "mistral",
-    contextWindow: 32000,
+    contextWindow: 256000,
     capabilities: {
       vision: false,
       tools: true,
@@ -173,6 +185,42 @@ var MODELS = [
     },
     costPerMillion: { input: 0.2, output: 0.6 }
   },
+  {
+    id: "devstral-small-latest",
+    name: "Devstral Small",
+    provider: "mistral",
+    contextWindow: 128000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: true,
+      streaming: true
+    }
+  },
+  {
+    id: "magistral-medium-latest",
+    name: "Magistral Medium",
+    provider: "mistral",
+    contextWindow: 128000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: true,
+      streaming: true
+    }
+  },
+  {
+    id: "pixtral-large-latest",
+    name: "Pixtral Large",
+    provider: "mistral",
+    contextWindow: 128000,
+    capabilities: {
+      vision: true,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    }
+  },
   {
     id: "mistral-small-latest",
     name: "Mistral Small",
@@ -241,22 +289,30 @@ function getDefaultModel(provider) {
 }
 
 // src/factory.ts
-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";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createMistral } from "@ai-sdk/mistral";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createOllama } from "ollama-ai-provider";
 class BaseProvider {
   name;
   model;
   mode;
   config;
+  transport;
+  authMethod;
+  apiVersion;
+  customHeaders;
   cachedModel = null;
   constructor(config) {
     this.name = config.provider;
     this.model = config.model ?? DEFAULT_MODELS[config.provider];
     this.mode = this.determineMode(config);
     this.config = config;
+    this.transport = config.transport;
+    this.authMethod = config.authMethod;
+    this.apiVersion = config.apiVersion;
+    this.customHeaders = config.customHeaders;
   }
   getModel() {
     if (!this.cachedModel) {
@@ -296,81 +352,33 @@ class BaseProvider {
     return "managed";
   }
   createModel() {
-    const { baseUrl, proxyUrl } = this.config;
+    const { baseUrl, proxyUrl, apiKey } = this.config;
+    const headers = this.customHeaders;
+    if (this.name === "ollama") {
+      const provider = createOllama({ baseURL: baseUrl, headers });
+      return provider(this.model);
+    }
+    if (this.mode === "managed" && proxyUrl) {
+      const provider = createOpenAI({ baseURL: proxyUrl, apiKey, headers });
+      return provider(this.model);
+    }
     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 !== undefined) {
-          process.env.OLLAMA_BASE_URL = originalBaseUrl;
-        } else if (baseUrl && baseUrl !== "http://localhost:11434") {
-          delete process.env.OLLAMA_BASE_URL;
-        }
-        return ollamaModel;
+      case "openai": {
+        const provider = createOpenAI({ apiKey, headers });
+        return provider(this.model);
+      }
+      case "anthropic": {
+        const provider = createAnthropic({ apiKey, headers });
+        return provider(this.model);
+      }
+      case "mistral": {
+        const provider = createMistral({ apiKey, headers });
+        return provider(this.model);
+      }
+      case "gemini": {
+        const provider = createGoogleGenerativeAI({ apiKey, headers });
+        return provider(this.model);
       }
-      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 !== undefined) {
-            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 !== undefined) {
-            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 !== undefined) {
-            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 !== undefined) {
-            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}`);
     }
@@ -452,13 +460,17 @@ function createProviderFromEnv() {
     case "ollama":
       break;
   }
+  const transport = process.env.CONTRACTSPEC_AI_TRANSPORT;
+  const apiVersion = process.env.CONTRACTSPEC_AI_API_VERSION;
   return createProvider({
     provider,
     model,
     apiKey,
     baseUrl: process.env.OLLAMA_BASE_URL,
     proxyUrl: process.env.CONTRACTSPEC_AI_PROXY_URL,
-    organizationId: process.env.CONTRACTSPEC_ORG_ID
+    organizationId: process.env.CONTRACTSPEC_ORG_ID,
+    transport,
+    apiVersion
   });
 }
 function getAvailableProviders() {
@@ -466,35 +478,45 @@ function getAvailableProviders() {
   providers.push({
     provider: "ollama",
     available: true,
-    mode: "local"
+    mode: "local",
+    transports: ["rest", "sdk"],
+    authMethods: []
   });
   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" : undefined
+    reason: !openaiKey ? "Set OPENAI_API_KEY for BYOK mode" : undefined,
+    transports: ["rest", "sdk"],
+    authMethods: ["api-key"]
   });
   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" : undefined
+    reason: !anthropicKey ? "Set ANTHROPIC_API_KEY for BYOK mode" : undefined,
+    transports: ["rest", "sdk"],
+    authMethods: ["api-key"]
   });
   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" : undefined
+    reason: !mistralKey ? "Set MISTRAL_API_KEY for BYOK mode" : undefined,
+    transports: ["rest", "sdk"],
+    authMethods: ["api-key"]
   });
   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" : undefined
+    reason: !geminiKey ? "Set GOOGLE_API_KEY for BYOK mode" : undefined,
+    transports: ["rest", "sdk"],
+    authMethods: ["api-key"]
   });
   return providers;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.ai-providers",
-  "version": "2.9.0",
+  "version": "3.1.1",
   "description": "Unified AI provider abstraction layer",
   "keywords": [
     "contractspec",
@@ -33,18 +33,19 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "3.0.46",
-    "@ai-sdk/google": "3.0.30",
-    "@ai-sdk/mistral": "3.0.20",
-    "@ai-sdk/openai": "3.0.31",
-    "ai": "6.0.97",
+    "@ai-sdk/anthropic": "3.0.58",
+    "@ai-sdk/google": "3.0.43",
+    "@ai-sdk/mistral": "3.0.24",
+    "@ai-sdk/openai": "3.0.41",
+    "@contractspec/lib.provider-ranking": "0.1.1",
+    "ai": "6.0.116",
     "ollama-ai-provider": "^1.2.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "2.9.0",
+    "@contractspec/tool.typescript": "3.1.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "2.9.0"
+    "@contractspec/tool.bun": "3.1.0"
   },
   "exports": {
     ".": {
@@ -75,6 +76,20 @@
       "browser": "./dist/browser/models.js",
       "default": "./dist/models.js"
     },
+    "./selector": {
+      "types": "./dist/selector.d.ts",
+      "bun": "./dist/selector.js",
+      "node": "./dist/node/selector.js",
+      "browser": "./dist/browser/selector.js",
+      "default": "./dist/selector.js"
+    },
+    "./selector-types": {
+      "types": "./dist/selector-types.d.ts",
+      "bun": "./dist/selector-types.js",
+      "node": "./dist/node/selector-types.js",
+      "browser": "./dist/browser/selector-types.js",
+      "default": "./dist/selector-types.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "bun": "./dist/types.js",
@@ -121,6 +136,20 @@
         "browser": "./dist/browser/models.js",
         "default": "./dist/models.js"
       },
+      "./selector": {
+        "types": "./dist/selector.d.ts",
+        "bun": "./dist/selector.js",
+        "node": "./dist/node/selector.js",
+        "browser": "./dist/browser/selector.js",
+        "default": "./dist/selector.js"
+      },
+      "./selector-types": {
+        "types": "./dist/selector-types.d.ts",
+        "bun": "./dist/selector-types.js",
+        "node": "./dist/node/selector-types.js",
+        "browser": "./dist/browser/selector-types.js",
+        "default": "./dist/selector-types.js"
+      },
       "./types": {
         "types": "./dist/types.d.ts",
         "bun": "./dist/types.js",