@contractspec/lib.ai-providers 1.57.0 → 1.58.0

package/dist/index.d.ts

@@ -1,6 +1,11 @@
-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 };
+/**
+ * @contractspec/lib.ai-providers
+ *
+ * Unified AI provider abstraction for ContractSpec applications.
+ */
+export * from './types';
+export * from './factory';
+export * from './models';
+export * from './validation';
+export { getAIProvider, validateProvider as validateLegacyProvider, } from './legacy';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,gBAAgB,IAAI,sBAAsB,GAC3C,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,642 @@
-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";
+// @bun
+// src/models.ts
+var DEFAULT_MODELS = {
+  ollama: "llama3.2",
+  openai: "gpt-4o",
+  anthropic: "claude-sonnet-4-20250514",
+  mistral: "mistral-large-latest",
+  gemini: "gemini-2.0-flash"
+};
+var MODELS = [
+  {
+    id: "llama3.2",
+    name: "Llama 3.2",
+    provider: "ollama",
+    contextWindow: 128000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    }
+  },
+  {
+    id: "codellama",
+    name: "Code Llama",
+    provider: "ollama",
+    contextWindow: 16000,
+    capabilities: {
+      vision: false,
+      tools: false,
+      reasoning: false,
+      streaming: true
+    }
+  },
+  {
+    id: "deepseek-coder",
+    name: "DeepSeek Coder",
+    provider: "ollama",
+    contextWindow: 16000,
+    capabilities: {
+      vision: false,
+      tools: false,
+      reasoning: false,
+      streaming: true
+    }
+  },
+  {
+    id: "mistral",
+    name: "Mistral 7B",
+    provider: "ollama",
+    contextWindow: 32000,
+    capabilities: {
+      vision: false,
+      tools: false,
+      reasoning: false,
+      streaming: true
+    }
+  },
+  {
+    id: "gpt-4o",
+    name: "GPT-4o",
+    provider: "openai",
+    contextWindow: 128000,
+    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: 128000,
+    capabilities: {
+      vision: true,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    },
+    costPerMillion: { input: 0.15, output: 0.6 }
+  },
+  {
+    id: "o1",
+    name: "o1",
+    provider: "openai",
+    contextWindow: 200000,
+    capabilities: {
+      vision: true,
+      tools: true,
+      reasoning: true,
+      streaming: true
+    },
+    costPerMillion: { input: 15, output: 60 }
+  },
+  {
+    id: "o1-mini",
+    name: "o1 Mini",
+    provider: "openai",
+    contextWindow: 128000,
+    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: 200000,
+    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: 200000,
+    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: 200000,
+    capabilities: {
+      vision: true,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    },
+    costPerMillion: { input: 0.8, output: 4 }
+  },
+  {
+    id: "mistral-large-latest",
+    name: "Mistral Large",
+    provider: "mistral",
+    contextWindow: 128000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    },
+    costPerMillion: { input: 2, output: 6 }
+  },
+  {
+    id: "codestral-latest",
+    name: "Codestral",
+    provider: "mistral",
+    contextWindow: 32000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    },
+    costPerMillion: { input: 0.2, output: 0.6 }
+  },
+  {
+    id: "mistral-small-latest",
+    name: "Mistral Small",
+    provider: "mistral",
+    contextWindow: 32000,
+    capabilities: {
+      vision: false,
+      tools: true,
+      reasoning: false,
+      streaming: true
+    },
+    costPerMillion: { input: 0.2, output: 0.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: 0.075, output: 0.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: 0.15, output: 0.6 }
+  }
+];
+function getModelsForProvider(provider) {
+  return MODELS.filter((m) => m.provider === provider);
+}
+function getModelInfo(modelId) {
+  return MODELS.find((m) => m.id === modelId);
+}
+function getRecommendedModels(provider) {
+  const normalizedProvider = provider === "claude" ? "anthropic" : provider === "custom" ? "openai" : provider;
+  return getModelsForProvider(normalizedProvider).map((m) => m.id);
+}
+function getDefaultModel(provider) {
+  return DEFAULT_MODELS[provider];
+}
 
-export { DEFAULT_MODELS, MODELS, createProvider, createProviderFromEnv, getAIProvider, getAvailableProviders, getDefaultModel, getEnvVarName, getModelInfo, getModelsForProvider, getRecommendedModels, hasCredentials, isOllamaRunning, listOllamaModels, validateProvider as validateLegacyProvider, validateProvider$1 as validateProvider };
+// 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";
+class BaseProvider {
+  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 !== undefined) {
+          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 !== 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}`);
+    }
+  }
+  async listOllamaModels() {
+    try {
+      const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+      const response = await fetch(`${baseUrl}/api/tags`);
+      if (!response.ok) {
+        return getModelsForProvider("ollama");
+      }
+      const data = await response.json();
+      const models = data.models ?? [];
+      return models.map((m) => ({
+        id: m.name,
+        name: m.name,
+        provider: "ollama",
+        contextWindow: 8000,
+        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 data = await response.json();
+      const models = data.models ?? [];
+      const hasModel = models.some((m) => m.name === this.model);
+      if (!hasModel) {
+        return {
+          valid: false,
+          error: `Model "${this.model}" not found. Available: ${models.map((m) => m.name).join(", ")}`
+        };
+      }
+      return { valid: true };
+    } catch (error) {
+      const baseUrl = this.config.baseUrl ?? "http://localhost:11434";
+      return {
+        valid: false,
+        error: `Cannot connect to Ollama at ${baseUrl}: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+  }
+}
+function createProvider(config) {
+  return new BaseProvider(config);
+}
+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
+  });
+}
+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" : undefined
+  });
+  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
+  });
+  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
+  });
+  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
+  });
+  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);
+    default:
+      return false;
+  }
+}
+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;
+  }
+}
+async function isOllamaRunning(baseUrl = "http://localhost:11434") {
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+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 [];
+  }
+}
+
+// src/legacy.ts
+function mapLegacyProvider(legacy) {
+  switch (legacy) {
+    case "claude":
+      return "anthropic";
+    case "custom":
+      return "openai";
+    default:
+      return legacy;
+  }
+}
+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;
+  }
+  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"
+    };
+  }
+  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 };
+}
+export {
+  validateProvider,
+  validateProvider2 as validateLegacyProvider,
+  listOllamaModels,
+  isOllamaRunning,
+  hasCredentials,
+  getRecommendedModels,
+  getModelsForProvider,
+  getModelInfo,
+  getEnvVarName,
+  getDefaultModel,
+  getAvailableProviders,
+  getAIProvider,
+  createProviderFromEnv,
+  createProvider,
+  MODELS,
+  DEFAULT_MODELS
+};

package/dist/legacy.d.ts

@@ -1,23 +1,31 @@
-import { LegacyConfig } from "./types.js";
-import { getRecommendedModels } from "./models.js";
-import { LanguageModel } from "ai";
-
-//#region src/legacy.d.ts
+/**
+ * Legacy compatibility layer
+ *
+ * Provides backwards-compatible functions for existing code
+ * 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';
 /**
  * Get AI provider from legacy Config type
  *
  * @deprecated Use createProvider() instead
  */
-declare function getAIProvider(config: LegacyConfig): LanguageModel;
+export 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;
+export declare function validateProvider(config: LegacyConfig): Promise<{
+    success: boolean;
+    error?: string;
 }>;
-//#endregion
-export { getAIProvider, getRecommendedModels, validateProvider };
+/**
+ * Get recommended models for legacy provider name
+ *
+ * @deprecated Use getModelsForProvider() instead
+ */
+export { getModels as getRecommendedModels };
 //# sourceMappingURL=legacy.d.ts.map