@contractspec/lib.ai-providers 3.0.0 → 3.1.1

package/dist/browser/factory.js

@@ -288,22 +288,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) {
@@ -343,81 +351,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}`);
     }
@@ -499,13 +459,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() {
@@ -513,35 +477,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/dist/browser/index.js

@@ -288,22 +288,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) {
@@ -343,81 +351,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}`);
     }
@@ -499,13 +459,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() {
@@ -513,35 +477,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;
 }
@@ -601,6 +575,174 @@ async function listOllamaModels(baseUrl = "http://localhost:11434") {
     return [];
   }
 }
+// src/selector.ts
+function createModelSelector(options) {
+  const { store, fallbackModels, defaultConstraints } = options;
+  const catalog = fallbackModels ?? MODELS;
+  return {
+    async select(context) {
+      const merged = mergeConstraints(defaultConstraints, context.constraints);
+      if (context.priorities?.length) {
+        return selectMultiObjective(store, catalog, context.priorities, merged);
+      }
+      const dimension = context.taskDimension ?? "reasoning";
+      return selectByDimension(store, catalog, dimension, merged);
+    },
+    async selectAndCreate(context) {
+      const selection = await this.select(context);
+      const model = createProvider({
+        provider: selection.providerKey,
+        model: selection.modelId
+      }).getModel();
+      return { model, selection };
+    }
+  };
+}
+async function selectByDimension(store, catalog, dimension, constraints) {
+  const { rankings } = await store.listModelRankings({ dimension, limit: 50 });
+  const eligible = filterRankings(rankings, catalog, constraints);
+  const topCandidate = eligible[0];
+  if (topCandidate) {
+    const dimScore = topCandidate.dimensionScores[dimension]?.score ?? topCandidate.compositeScore;
+    return {
+      modelId: topCandidate.modelId,
+      providerKey: topCandidate.providerKey,
+      score: dimScore,
+      reason: `Top-ranked for "${dimension}" (score ${Math.round(dimScore)})`,
+      alternatives: eligible.slice(1, 4).map((r) => ({
+        modelId: r.modelId,
+        providerKey: r.providerKey,
+        score: r.dimensionScores[dimension]?.score ?? r.compositeScore
+      }))
+    };
+  }
+  return fallbackFromCatalog(catalog, constraints, dimension);
+}
+async function selectMultiObjective(store, catalog, priorities, constraints) {
+  const { rankings } = await store.listModelRankings({ limit: 100 });
+  const eligible = filterRankings(rankings, catalog, constraints);
+  if (eligible.length === 0) {
+    const primaryDim = priorities.reduce((a, b) => b.weight > a.weight ? b : a).dimension;
+    return fallbackFromCatalog(catalog, constraints, primaryDim);
+  }
+  const totalWeight = priorities.reduce((sum, p) => sum + p.weight, 0) || 1;
+  const scored = eligible.map((r) => {
+    let weightedScore = 0;
+    for (const p of priorities) {
+      const dimScore = r.dimensionScores[p.dimension]?.score ?? 0;
+      weightedScore += dimScore * (p.weight / totalWeight);
+    }
+    return { ranking: r, weightedScore };
+  });
+  scored.sort((a, b) => b.weightedScore - a.weightedScore);
+  const best = scored[0];
+  if (!best) {
+    const primaryDim = priorities.reduce((a, b) => b.weight > a.weight ? b : a).dimension;
+    return fallbackFromCatalog(catalog, constraints, primaryDim);
+  }
+  const dims = priorities.map((p) => p.dimension).join(", ");
+  return {
+    modelId: best.ranking.modelId,
+    providerKey: best.ranking.providerKey,
+    score: Math.round(best.weightedScore * 100) / 100,
+    reason: `Multi-objective optimum across [${dims}]`,
+    alternatives: scored.slice(1, 4).map((s) => ({
+      modelId: s.ranking.modelId,
+      providerKey: s.ranking.providerKey,
+      score: Math.round(s.weightedScore * 100) / 100
+    }))
+  };
+}
+function filterRankings(rankings, catalog, constraints) {
+  return rankings.filter((r) => {
+    if (constraints.allowedProviders?.length) {
+      if (!constraints.allowedProviders.includes(r.providerKey))
+        return false;
+    }
+    if (constraints.excludeModels?.length) {
+      if (constraints.excludeModels.includes(r.modelId))
+        return false;
+    }
+    const info = getModelInfo(r.modelId) ?? catalog.find((m) => m.id === r.modelId);
+    if (!info)
+      return true;
+    if (constraints.minContextWindow && info.contextWindow < constraints.minContextWindow) {
+      return false;
+    }
+    if (constraints.maxCostPerMillionInput && info.costPerMillion) {
+      if (info.costPerMillion.input > constraints.maxCostPerMillionInput)
+        return false;
+    }
+    if (constraints.maxCostPerMillionOutput && info.costPerMillion) {
+      if (info.costPerMillion.output > constraints.maxCostPerMillionOutput)
+        return false;
+    }
+    if (constraints.requiredCapabilities?.length) {
+      for (const cap of constraints.requiredCapabilities) {
+        if (!info.capabilities[cap])
+          return false;
+      }
+    }
+    return true;
+  });
+}
+function fallbackFromCatalog(catalog, constraints, dimension) {
+  let eligible = catalog.filter((m) => m.costPerMillion != null);
+  const {
+    allowedProviders,
+    excludeModels,
+    minContextWindow,
+    requiredCapabilities
+  } = constraints;
+  if (allowedProviders?.length) {
+    eligible = eligible.filter((m) => allowedProviders.includes(m.provider));
+  }
+  if (excludeModels?.length) {
+    eligible = eligible.filter((m) => !excludeModels.includes(m.id));
+  }
+  if (minContextWindow) {
+    eligible = eligible.filter((m) => m.contextWindow >= minContextWindow);
+  }
+  if (requiredCapabilities?.length) {
+    eligible = eligible.filter((m) => requiredCapabilities.every((cap) => m.capabilities[cap]));
+  }
+  if (eligible.length === 0) {
+    eligible = catalog.slice(0, 5);
+  }
+  eligible.sort((a, b) => {
+    const costA = a.costPerMillion ? (a.costPerMillion.input + a.costPerMillion.output) / 2 : 999;
+    const costB = b.costPerMillion ? (b.costPerMillion.input + b.costPerMillion.output) / 2 : 999;
+    return b.contextWindow / 1e5 - costB - (a.contextWindow / 1e5 - costA);
+  });
+  const best = eligible[0];
+  if (!best) {
+    return {
+      modelId: "unknown",
+      providerKey: "openai",
+      score: 0,
+      reason: `No eligible models found for "${dimension}"`,
+      alternatives: []
+    };
+  }
+  return {
+    modelId: best.id,
+    providerKey: best.provider,
+    score: 0,
+    reason: `Fallback from catalog (no ranking data for "${dimension}")`,
+    alternatives: eligible.slice(1, 4).map((m) => ({
+      modelId: m.id,
+      providerKey: m.provider,
+      score: 0
+    }))
+  };
+}
+function mergeConstraints(defaults, overrides) {
+  if (!defaults)
+    return overrides ?? {};
+  if (!overrides)
+    return defaults;
+  return { ...defaults, ...overrides };
+}
 
 // src/legacy.ts
 function mapLegacyProvider(legacy) {
@@ -684,6 +826,7 @@ export {
   getAIProvider,
   createProviderFromEnv,
   createProvider,
+  createModelSelector,
   MODELS,
   DEFAULT_MODELS
 };