@llmops/core 0.5.0-beta.2 → 0.5.0-beta.4

package/dist/index.cjs

@@ -92,6 +92,171 @@ let SupportedProviders = /* @__PURE__ */ function(SupportedProviders$1) {
 	return SupportedProviders$1;
 }({});
 
+//#endregion
+//#region src/providers/default-providers.ts
+/**
+* Top providers with simple API key authentication.
+* Providers requiring additional config (Azure, Bedrock, Vertex) are excluded
+* as they need endpoint/region info that can't be auto-detected.
+*/
+const DEFAULT_PROVIDER_MAPPINGS = [
+	{
+		provider: SupportedProviders.OPENAI,
+		slug: "openai",
+		envVar: "OPENAI_API_KEY"
+	},
+	{
+		provider: SupportedProviders.ANTHROPIC,
+		slug: "anthropic",
+		envVar: "ANTHROPIC_API_KEY"
+	},
+	{
+		provider: SupportedProviders.GOOGLE,
+		slug: "google",
+		envVar: "GOOGLE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.MISTRAL_AI,
+		slug: "mistral",
+		envVar: "MISTRAL_API_KEY"
+	},
+	{
+		provider: SupportedProviders.GROQ,
+		slug: "groq",
+		envVar: "GROQ_API_KEY"
+	},
+	{
+		provider: SupportedProviders.COHERE,
+		slug: "cohere",
+		envVar: "COHERE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.TOGETHER_AI,
+		slug: "together",
+		envVar: "TOGETHER_API_KEY"
+	},
+	{
+		provider: SupportedProviders.PERPLEXITY_AI,
+		slug: "perplexity",
+		envVar: "PERPLEXITY_API_KEY"
+	},
+	{
+		provider: SupportedProviders.DEEPSEEK,
+		slug: "deepseek",
+		envVar: "DEEPSEEK_API_KEY"
+	},
+	{
+		provider: SupportedProviders.FIREWORKS_AI,
+		slug: "fireworks",
+		envVar: "FIREWORKS_API_KEY"
+	},
+	{
+		provider: SupportedProviders.OPENROUTER,
+		slug: "openrouter",
+		envVar: "OPENROUTER_API_KEY"
+	},
+	{
+		provider: SupportedProviders.X_AI,
+		slug: "xai",
+		envVar: "XAI_API_KEY"
+	},
+	{
+		provider: SupportedProviders.CEREBRAS,
+		slug: "cerebras",
+		envVar: "CEREBRAS_API_KEY"
+	},
+	{
+		provider: SupportedProviders.SAMBANOVA,
+		slug: "sambanova",
+		envVar: "SAMBANOVA_API_KEY"
+	},
+	{
+		provider: SupportedProviders.HUGGINGFACE,
+		slug: "huggingface",
+		envVar: "HUGGINGFACE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.REPLICATE,
+		slug: "replicate",
+		envVar: "REPLICATE_API_TOKEN"
+	},
+	{
+		provider: SupportedProviders.AI21,
+		slug: "ai21",
+		envVar: "AI21_API_KEY"
+	},
+	{
+		provider: SupportedProviders.DEEPINFRA,
+		slug: "deepinfra",
+		envVar: "DEEPINFRA_API_KEY"
+	}
+];
+/**
+* Get default provider configurations from environment variables.
+*
+* Scans for known API key environment variables and creates
+* InlineProviderConfig entries for each one found.
+*
+* @param env - Environment variables object (defaults to process.env)
+* @returns Array of auto-configured providers
+*
+* @example
+* ```typescript
+* // With OPENAI_API_KEY and ANTHROPIC_API_KEY set in environment:
+* const defaults = getDefaultProviders();
+* // Returns:
+* // [
+* //   { provider: 'openai', slug: 'openai', apiKey: '...' },
+* //   { provider: 'anthropic', slug: 'anthropic', apiKey: '...' }
+* // ]
+* ```
+*/
+function getDefaultProviders(env = process.env) {
+	const providers = [];
+	for (const mapping of DEFAULT_PROVIDER_MAPPINGS) {
+		const apiKey = env[mapping.envVar];
+		if (apiKey) providers.push({
+			provider: mapping.provider,
+			slug: mapping.slug,
+			apiKey
+		});
+	}
+	return providers;
+}
+/**
+* Merge user-provided providers with default providers.
+*
+* User-provided providers take precedence:
+* - If a user specifies a provider with the same slug, the default is ignored
+* - If a user specifies the same provider type with a different slug, both are kept
+*
+* @param userProviders - User-configured providers (may be undefined)
+* @param env - Environment variables object (defaults to process.env)
+* @returns Merged array of providers (user configs + non-conflicting defaults)
+*
+* @example
+* ```typescript
+* // User overrides openai with custom slug
+* const merged = mergeWithDefaultProviders([
+*   { provider: 'openai', slug: 'my-openai', apiKey: 'custom-key' }
+* ]);
+* // Default 'openai' slug is still added if OPENAI_API_KEY is set,
+* // user's 'my-openai' is kept as separate config
+* ```
+*/
+function mergeWithDefaultProviders(userProviders, env = process.env) {
+	const defaults = getDefaultProviders(env);
+	if (!userProviders || userProviders.length === 0) return defaults;
+	const userSlugs = new Set(userProviders.map((p) => p.slug));
+	const nonConflictingDefaults = defaults.filter((d) => !userSlugs.has(d.slug));
+	return [...userProviders, ...nonConflictingDefaults];
+}
+/**
+* List of supported default provider environment variables.
+* Useful for documentation or debugging.
+*/
+const DEFAULT_PROVIDER_ENV_VARS = DEFAULT_PROVIDER_MAPPINGS.map((m) => m.envVar);
+
 //#endregion
 //#region src/schemas/openai.ts
 const chatCompletionContentPartTextSchema = require_db.object({
@@ -451,12 +616,19 @@ const inlineProviderConfigSchema = require_db.object({
 * Schema for providers array
 */
 const providersConfigSchema = require_db.array(inlineProviderConfigSchema).optional();
-const llmopsConfigSchema = require_db.object({
+/**
+* Base schema without refinements (used for transform)
+*/
+const llmopsConfigBaseSchema = require_db.object({
 	database: require_db.any().optional(),
 	basePath: require_db.string().min(1, "Base path is required and cannot be empty").refine((path) => path.startsWith("/"), "Base path must start with a forward slash"),
 	schema: require_db.string().optional().default("llmops"),
 	providers: providersConfigSchema
-}).refine((config) => config.database !== void 0 || config.providers && config.providers.length > 0, "Either database or providers must be configured");
+});
+const llmopsConfigSchema = llmopsConfigBaseSchema.transform((config) => ({
+	...config,
+	providers: mergeWithDefaultProviders(config.providers)
+})).refine((config) => config.database !== void 0 || config.providers && config.providers.length > 0, "Either database or providers must be configured. Set a database connection, configure providers explicitly, or set API key environment variables (e.g., OPENAI_API_KEY).");
 function validateLLMOpsConfig(config) {
 	const result = llmopsConfigSchema.safeParse(config);
 	if (!result.success) {
@@ -3756,6 +3928,7 @@ var ManifestRouter = class {
 
 //#endregion
 exports.CacheService = CacheService;
+exports.DEFAULT_PROVIDER_ENV_VARS = DEFAULT_PROVIDER_ENV_VARS;
 exports.FileCacheBackend = FileCacheBackend;
 exports.MS = MS;
 exports.ManifestBuilder = ManifestBuilder;
@@ -3808,12 +3981,14 @@ Object.defineProperty(exports, 'gateway', {
 exports.generateId = generateId;
 exports.getAuthClientOptions = require_db.getAuthClientOptions;
 exports.getDefaultPricingProvider = getDefaultPricingProvider;
+exports.getDefaultProviders = getDefaultProviders;
 exports.getMigrations = require_db.getMigrations;
 exports.guardrailConfigsSchema = require_db.guardrailConfigsSchema;
 exports.llmRequestsSchema = require_db.llmRequestsSchema;
 exports.llmopsConfigSchema = llmopsConfigSchema;
 exports.logger = require_db.logger;
 exports.matchType = require_db.matchType;
+exports.mergeWithDefaultProviders = mergeWithDefaultProviders;
 exports.microDollarsToDollars = microDollarsToDollars;
 exports.parsePartialTableData = require_db.parsePartialTableData;
 exports.parseTableData = require_db.parseTableData;

package/dist/index.d.cts

@@ -418,8 +418,58 @@ interface InlineProviderConfig extends Partial<BaseProviderConfig> {
 /** Array of inline provider configurations */
 type InlineProvidersConfig = InlineProviderConfig[];
 //#endregion
+//#region src/providers/default-providers.d.ts
+/**
+ * Get default provider configurations from environment variables.
+ *
+ * Scans for known API key environment variables and creates
+ * InlineProviderConfig entries for each one found.
+ *
+ * @param env - Environment variables object (defaults to process.env)
+ * @returns Array of auto-configured providers
+ *
+ * @example
+ * ```typescript
+ * // With OPENAI_API_KEY and ANTHROPIC_API_KEY set in environment:
+ * const defaults = getDefaultProviders();
+ * // Returns:
+ * // [
+ * //   { provider: 'openai', slug: 'openai', apiKey: '...' },
+ * //   { provider: 'anthropic', slug: 'anthropic', apiKey: '...' }
+ * // ]
+ * ```
+ */
+declare function getDefaultProviders(env?: Record<string, string | undefined>): InlineProviderConfig[];
+/**
+ * Merge user-provided providers with default providers.
+ *
+ * User-provided providers take precedence:
+ * - If a user specifies a provider with the same slug, the default is ignored
+ * - If a user specifies the same provider type with a different slug, both are kept
+ *
+ * @param userProviders - User-configured providers (may be undefined)
+ * @param env - Environment variables object (defaults to process.env)
+ * @returns Merged array of providers (user configs + non-conflicting defaults)
+ *
+ * @example
+ * ```typescript
+ * // User overrides openai with custom slug
+ * const merged = mergeWithDefaultProviders([
+ *   { provider: 'openai', slug: 'my-openai', apiKey: 'custom-key' }
+ * ]);
+ * // Default 'openai' slug is still added if OPENAI_API_KEY is set,
+ * // user's 'my-openai' is kept as separate config
+ * ```
+ */
+declare function mergeWithDefaultProviders(userProviders: InlineProviderConfig[] | undefined, env?: Record<string, string | undefined>): InlineProviderConfig[];
+/**
+ * List of supported default provider environment variables.
+ * Useful for documentation or debugging.
+ */
+declare const DEFAULT_PROVIDER_ENV_VARS: string[];
+//#endregion
 //#region src/schemas/config.d.ts
-declare const llmopsConfigSchema: z.ZodObject<{
+declare const llmopsConfigSchema: z.ZodPipe<z.ZodObject<{
   database: z.ZodOptional<z.ZodAny>;
   basePath: z.ZodString;
   schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -431,7 +481,25 @@ declare const llmopsConfigSchema: z.ZodObject<{
     requestTimeout: z.ZodOptional<z.ZodNumber>;
     forwardHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$loose>>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+  providers: InlineProviderConfig[];
+  basePath: string;
+  schema: string;
+  database?: any;
+}, {
+  basePath: string;
+  schema: string;
+  database?: any;
+  providers?: {
+    [x: string]: unknown;
+    provider: string;
+    slug: string;
+    apiKey?: string | undefined;
+    customHost?: string | undefined;
+    requestTimeout?: number | undefined;
+    forwardHeaders?: string[] | undefined;
+  }[] | undefined;
+}>>;
 /**
  * Validated LLMOps configuration
  *
@@ -3848,4 +3916,4 @@ declare class ManifestRouter {
   routeWithWeights(configIdOrSlug: string, environmentId: string, context?: RoutingContext): RoutingResult | null;
 }
 //#endregion
-export { type AnthropicProviderConfig, type AnyProviderConfig, AuthClientDatabaseConfig, AuthClientOptions, type AzureAIProviderConfig, type AzureOpenAIProviderConfig, BaseCacheConfig, type BaseProviderConfig, type BedrockProviderConfig, CacheBackend, CacheBackendType, CacheConfig, CacheEntry, CacheOptions, CacheService, CacheStats, ChatCompletionCreateParamsBase, Config, ConfigVariant, ConfigVariantsDataLayer, ConfigVariantsTable, ConfigsDataLayer, ConfigsTable, type CortexProviderConfig, CostResult, DataLayer, Database, DatabaseConnection, DatabaseOptions, DatabaseType, Dataset, DatasetRecord, DatasetRecordsTable, DatasetVersion, DatasetVersionRecord, DatasetVersionRecordsTable, DatasetVersionsTable, DatasetsDataLayer, DatasetsTable, Environment, EnvironmentSecret, EnvironmentSecretsDataLayer, EnvironmentSecretsTable, EnvironmentsDataLayer, EnvironmentsTable, FileCacheBackend, FileCacheConfig, type FireworksAIProviderConfig, GatewayManifest, type GoogleProviderConfig, GuardrailConfig, GuardrailConfigsDataLayer, GuardrailConfigsTable, GuardrailResult, GuardrailResults, type HuggingFaceProviderConfig, type InlineProviderConfig, type InlineProvidersConfig, Insertable, LLMOpsClient, LLMOpsConfig, type LLMOpsConfigInput, LLMRequest, LLMRequestInsert, LLMRequestsDataLayer, LLMRequestsTable, MS, ManifestBuilder, ManifestConfig, ManifestEnvironment, ManifestGuardrail, ManifestProviderGuardrailOverride, ManifestRouter, ManifestService, ManifestTargetingRule, ManifestVariantVersion, MemoryCacheBackend, MemoryCacheConfig, MigrationOptions, MigrationResult, type MistralAIProviderConfig, ModelPricing, ModelsDevPricingProvider, type OpenAIProviderConfig, type OracleProviderConfig, Playground, PlaygroundColumn, PlaygroundResult, PlaygroundResultsDataLayer, PlaygroundResultsTable, PlaygroundRun, PlaygroundRunsDataLayer, PlaygroundRunsTable, PlaygroundsDataLayer, PlaygroundsTable, Prettify, PricingProvider, ProviderConfig, type ProviderConfigMap, ProviderConfigsDataLayer, ProviderConfigsTable, ProviderGuardrailOverride, ProviderGuardrailOverridesDataLayer, ProviderGuardrailOverridesTable, type ProvidersConfig, RoutingContext, RoutingResult, SCHEMA_METADATA, type SagemakerProviderConfig, Selectable, type StabilityAIProviderConfig, SupportedProviders, TableName, TargetingRule, TargetingRulesDataLayer, TargetingRulesTable, Updateable, UsageData, type ValidatedLLMOpsConfig, Variant, VariantJsonData, VariantVersion, VariantVersionsDataLayer, VariantVersionsTable, VariantsDataLayer, VariantsTable, type VertexAIProviderConfig, type WorkersAIProviderConfig, WorkspaceSettings, WorkspaceSettingsDataLayer, WorkspaceSettingsTable, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };
+export { type AnthropicProviderConfig, type AnyProviderConfig, AuthClientDatabaseConfig, AuthClientOptions, type AzureAIProviderConfig, type AzureOpenAIProviderConfig, BaseCacheConfig, type BaseProviderConfig, type BedrockProviderConfig, CacheBackend, CacheBackendType, CacheConfig, CacheEntry, CacheOptions, CacheService, CacheStats, ChatCompletionCreateParamsBase, Config, ConfigVariant, ConfigVariantsDataLayer, ConfigVariantsTable, ConfigsDataLayer, ConfigsTable, type CortexProviderConfig, CostResult, DEFAULT_PROVIDER_ENV_VARS, DataLayer, Database, DatabaseConnection, DatabaseOptions, DatabaseType, Dataset, DatasetRecord, DatasetRecordsTable, DatasetVersion, DatasetVersionRecord, DatasetVersionRecordsTable, DatasetVersionsTable, DatasetsDataLayer, DatasetsTable, Environment, EnvironmentSecret, EnvironmentSecretsDataLayer, EnvironmentSecretsTable, EnvironmentsDataLayer, EnvironmentsTable, FileCacheBackend, FileCacheConfig, type FireworksAIProviderConfig, GatewayManifest, type GoogleProviderConfig, GuardrailConfig, GuardrailConfigsDataLayer, GuardrailConfigsTable, GuardrailResult, GuardrailResults, type HuggingFaceProviderConfig, type InlineProviderConfig, type InlineProvidersConfig, Insertable, LLMOpsClient, LLMOpsConfig, type LLMOpsConfigInput, LLMRequest, LLMRequestInsert, LLMRequestsDataLayer, LLMRequestsTable, MS, ManifestBuilder, ManifestConfig, ManifestEnvironment, ManifestGuardrail, ManifestProviderGuardrailOverride, ManifestRouter, ManifestService, ManifestTargetingRule, ManifestVariantVersion, MemoryCacheBackend, MemoryCacheConfig, MigrationOptions, MigrationResult, type MistralAIProviderConfig, ModelPricing, ModelsDevPricingProvider, type OpenAIProviderConfig, type OracleProviderConfig, Playground, PlaygroundColumn, PlaygroundResult, PlaygroundResultsDataLayer, PlaygroundResultsTable, PlaygroundRun, PlaygroundRunsDataLayer, PlaygroundRunsTable, PlaygroundsDataLayer, PlaygroundsTable, Prettify, PricingProvider, ProviderConfig, type ProviderConfigMap, ProviderConfigsDataLayer, ProviderConfigsTable, ProviderGuardrailOverride, ProviderGuardrailOverridesDataLayer, ProviderGuardrailOverridesTable, type ProvidersConfig, RoutingContext, RoutingResult, SCHEMA_METADATA, type SagemakerProviderConfig, Selectable, type StabilityAIProviderConfig, SupportedProviders, TableName, TargetingRule, TargetingRulesDataLayer, TargetingRulesTable, Updateable, UsageData, type ValidatedLLMOpsConfig, Variant, VariantJsonData, VariantVersion, VariantVersionsDataLayer, VariantVersionsTable, VariantsDataLayer, VariantsTable, type VertexAIProviderConfig, type WorkersAIProviderConfig, WorkspaceSettings, WorkspaceSettingsDataLayer, WorkspaceSettingsTable, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getDefaultProviders, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, mergeWithDefaultProviders, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };

package/dist/index.d.mts

@@ -418,8 +418,58 @@ interface InlineProviderConfig extends Partial<BaseProviderConfig> {
 /** Array of inline provider configurations */
 type InlineProvidersConfig = InlineProviderConfig[];
 //#endregion
+//#region src/providers/default-providers.d.ts
+/**
+ * Get default provider configurations from environment variables.
+ *
+ * Scans for known API key environment variables and creates
+ * InlineProviderConfig entries for each one found.
+ *
+ * @param env - Environment variables object (defaults to process.env)
+ * @returns Array of auto-configured providers
+ *
+ * @example
+ * ```typescript
+ * // With OPENAI_API_KEY and ANTHROPIC_API_KEY set in environment:
+ * const defaults = getDefaultProviders();
+ * // Returns:
+ * // [
+ * //   { provider: 'openai', slug: 'openai', apiKey: '...' },
+ * //   { provider: 'anthropic', slug: 'anthropic', apiKey: '...' }
+ * // ]
+ * ```
+ */
+declare function getDefaultProviders(env?: Record<string, string | undefined>): InlineProviderConfig[];
+/**
+ * Merge user-provided providers with default providers.
+ *
+ * User-provided providers take precedence:
+ * - If a user specifies a provider with the same slug, the default is ignored
+ * - If a user specifies the same provider type with a different slug, both are kept
+ *
+ * @param userProviders - User-configured providers (may be undefined)
+ * @param env - Environment variables object (defaults to process.env)
+ * @returns Merged array of providers (user configs + non-conflicting defaults)
+ *
+ * @example
+ * ```typescript
+ * // User overrides openai with custom slug
+ * const merged = mergeWithDefaultProviders([
+ *   { provider: 'openai', slug: 'my-openai', apiKey: 'custom-key' }
+ * ]);
+ * // Default 'openai' slug is still added if OPENAI_API_KEY is set,
+ * // user's 'my-openai' is kept as separate config
+ * ```
+ */
+declare function mergeWithDefaultProviders(userProviders: InlineProviderConfig[] | undefined, env?: Record<string, string | undefined>): InlineProviderConfig[];
+/**
+ * List of supported default provider environment variables.
+ * Useful for documentation or debugging.
+ */
+declare const DEFAULT_PROVIDER_ENV_VARS: string[];
+//#endregion
 //#region src/schemas/config.d.ts
-declare const llmopsConfigSchema: z.ZodObject<{
+declare const llmopsConfigSchema: z.ZodPipe<z.ZodObject<{
   database: z.ZodOptional<z.ZodAny>;
   basePath: z.ZodString;
   schema: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -431,7 +481,25 @@ declare const llmopsConfigSchema: z.ZodObject<{
     requestTimeout: z.ZodOptional<z.ZodNumber>;
     forwardHeaders: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$loose>>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+  providers: InlineProviderConfig[];
+  basePath: string;
+  schema: string;
+  database?: any;
+}, {
+  basePath: string;
+  schema: string;
+  database?: any;
+  providers?: {
+    [x: string]: unknown;
+    provider: string;
+    slug: string;
+    apiKey?: string | undefined;
+    customHost?: string | undefined;
+    requestTimeout?: number | undefined;
+    forwardHeaders?: string[] | undefined;
+  }[] | undefined;
+}>>;
 /**
  * Validated LLMOps configuration
  *
@@ -3848,4 +3916,4 @@ declare class ManifestRouter {
   routeWithWeights(configIdOrSlug: string, environmentId: string, context?: RoutingContext): RoutingResult | null;
 }
 //#endregion
-export { type AnthropicProviderConfig, type AnyProviderConfig, AuthClientDatabaseConfig, AuthClientOptions, type AzureAIProviderConfig, type AzureOpenAIProviderConfig, BaseCacheConfig, type BaseProviderConfig, type BedrockProviderConfig, CacheBackend, CacheBackendType, CacheConfig, CacheEntry, CacheOptions, CacheService, CacheStats, ChatCompletionCreateParamsBase, type Config, type ConfigVariant, type ConfigVariantsDataLayer, type ConfigVariantsTable, type ConfigsDataLayer, type ConfigsTable, type CortexProviderConfig, CostResult, type DataLayer, type Database, DatabaseConnection, DatabaseOptions, DatabaseType, type Dataset, type DatasetRecord, DatasetRecordsTable, type DatasetVersion, type DatasetVersionRecord, DatasetVersionRecordsTable, DatasetVersionsTable, type DatasetsDataLayer, DatasetsTable, type Environment, type EnvironmentSecret, type EnvironmentSecretsDataLayer, type EnvironmentSecretsTable, type EnvironmentsDataLayer, type EnvironmentsTable, FileCacheBackend, FileCacheConfig, type FireworksAIProviderConfig, type GatewayManifest, type GoogleProviderConfig, type GuardrailConfig, type GuardrailConfigsDataLayer, GuardrailConfigsTable, type GuardrailResult, type GuardrailResults, type HuggingFaceProviderConfig, type InlineProviderConfig, type InlineProvidersConfig, Insertable, LLMOpsClient, LLMOpsConfig, type LLMOpsConfigInput, type LLMRequest, type LLMRequestInsert, type LLMRequestsDataLayer, LLMRequestsTable, MS, ManifestBuilder, type ManifestConfig, type ManifestEnvironment, type ManifestGuardrail, type ManifestProviderGuardrailOverride, ManifestRouter, ManifestService, type ManifestTargetingRule, type ManifestVariantVersion, MemoryCacheBackend, MemoryCacheConfig, MigrationOptions, MigrationResult, type MistralAIProviderConfig, ModelPricing, ModelsDevPricingProvider, type OpenAIProviderConfig, type OracleProviderConfig, type Playground, type PlaygroundColumn, type PlaygroundResult, type PlaygroundResultsDataLayer, PlaygroundResultsTable, type PlaygroundRun, type PlaygroundRunsDataLayer, PlaygroundRunsTable, type PlaygroundsDataLayer, PlaygroundsTable, Prettify, PricingProvider, type ProviderConfig, type ProviderConfigMap, type ProviderConfigsDataLayer, ProviderConfigsTable, type ProviderGuardrailOverride, type ProviderGuardrailOverridesDataLayer, ProviderGuardrailOverridesTable, type ProvidersConfig, type RoutingContext, type RoutingResult, SCHEMA_METADATA, type SagemakerProviderConfig, Selectable, type StabilityAIProviderConfig, SupportedProviders, type TableName, type TargetingRule, type TargetingRulesDataLayer, type TargetingRulesTable, Updateable, UsageData, type ValidatedLLMOpsConfig, type Variant, VariantJsonData, type VariantVersion, type VariantVersionsDataLayer, VariantVersionsTable, type VariantsDataLayer, type VariantsTable, type VertexAIProviderConfig, type WorkersAIProviderConfig, type WorkspaceSettings, type WorkspaceSettingsDataLayer, WorkspaceSettingsTable, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };
+export { type AnthropicProviderConfig, type AnyProviderConfig, AuthClientDatabaseConfig, AuthClientOptions, type AzureAIProviderConfig, type AzureOpenAIProviderConfig, BaseCacheConfig, type BaseProviderConfig, type BedrockProviderConfig, CacheBackend, CacheBackendType, CacheConfig, CacheEntry, CacheOptions, CacheService, CacheStats, ChatCompletionCreateParamsBase, type Config, type ConfigVariant, type ConfigVariantsDataLayer, type ConfigVariantsTable, type ConfigsDataLayer, type ConfigsTable, type CortexProviderConfig, CostResult, DEFAULT_PROVIDER_ENV_VARS, type DataLayer, type Database, DatabaseConnection, DatabaseOptions, DatabaseType, type Dataset, type DatasetRecord, DatasetRecordsTable, type DatasetVersion, type DatasetVersionRecord, DatasetVersionRecordsTable, DatasetVersionsTable, type DatasetsDataLayer, DatasetsTable, type Environment, type EnvironmentSecret, type EnvironmentSecretsDataLayer, type EnvironmentSecretsTable, type EnvironmentsDataLayer, type EnvironmentsTable, FileCacheBackend, FileCacheConfig, type FireworksAIProviderConfig, type GatewayManifest, type GoogleProviderConfig, type GuardrailConfig, type GuardrailConfigsDataLayer, GuardrailConfigsTable, type GuardrailResult, type GuardrailResults, type HuggingFaceProviderConfig, type InlineProviderConfig, type InlineProvidersConfig, Insertable, LLMOpsClient, LLMOpsConfig, type LLMOpsConfigInput, type LLMRequest, type LLMRequestInsert, type LLMRequestsDataLayer, LLMRequestsTable, MS, ManifestBuilder, type ManifestConfig, type ManifestEnvironment, type ManifestGuardrail, type ManifestProviderGuardrailOverride, ManifestRouter, ManifestService, type ManifestTargetingRule, type ManifestVariantVersion, MemoryCacheBackend, MemoryCacheConfig, MigrationOptions, MigrationResult, type MistralAIProviderConfig, ModelPricing, ModelsDevPricingProvider, type OpenAIProviderConfig, type OracleProviderConfig, type Playground, type PlaygroundColumn, type PlaygroundResult, type PlaygroundResultsDataLayer, PlaygroundResultsTable, type PlaygroundRun, type PlaygroundRunsDataLayer, PlaygroundRunsTable, type PlaygroundsDataLayer, PlaygroundsTable, Prettify, PricingProvider, type ProviderConfig, type ProviderConfigMap, type ProviderConfigsDataLayer, ProviderConfigsTable, type ProviderGuardrailOverride, type ProviderGuardrailOverridesDataLayer, ProviderGuardrailOverridesTable, type ProvidersConfig, type RoutingContext, type RoutingResult, SCHEMA_METADATA, type SagemakerProviderConfig, Selectable, type StabilityAIProviderConfig, SupportedProviders, type TableName, type TargetingRule, type TargetingRulesDataLayer, type TargetingRulesTable, Updateable, UsageData, type ValidatedLLMOpsConfig, type Variant, VariantJsonData, type VariantVersion, type VariantVersionsDataLayer, VariantVersionsTable, type VariantsDataLayer, type VariantsTable, type VertexAIProviderConfig, type WorkersAIProviderConfig, type WorkspaceSettings, type WorkspaceSettingsDataLayer, WorkspaceSettingsTable, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getDefaultProviders, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, mergeWithDefaultProviders, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };

package/dist/index.mjs

@@ -88,6 +88,171 @@ let SupportedProviders = /* @__PURE__ */ function(SupportedProviders$1) {
 	return SupportedProviders$1;
 }({});
 
+//#endregion
+//#region src/providers/default-providers.ts
+/**
+* Top providers with simple API key authentication.
+* Providers requiring additional config (Azure, Bedrock, Vertex) are excluded
+* as they need endpoint/region info that can't be auto-detected.
+*/
+const DEFAULT_PROVIDER_MAPPINGS = [
+	{
+		provider: SupportedProviders.OPENAI,
+		slug: "openai",
+		envVar: "OPENAI_API_KEY"
+	},
+	{
+		provider: SupportedProviders.ANTHROPIC,
+		slug: "anthropic",
+		envVar: "ANTHROPIC_API_KEY"
+	},
+	{
+		provider: SupportedProviders.GOOGLE,
+		slug: "google",
+		envVar: "GOOGLE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.MISTRAL_AI,
+		slug: "mistral",
+		envVar: "MISTRAL_API_KEY"
+	},
+	{
+		provider: SupportedProviders.GROQ,
+		slug: "groq",
+		envVar: "GROQ_API_KEY"
+	},
+	{
+		provider: SupportedProviders.COHERE,
+		slug: "cohere",
+		envVar: "COHERE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.TOGETHER_AI,
+		slug: "together",
+		envVar: "TOGETHER_API_KEY"
+	},
+	{
+		provider: SupportedProviders.PERPLEXITY_AI,
+		slug: "perplexity",
+		envVar: "PERPLEXITY_API_KEY"
+	},
+	{
+		provider: SupportedProviders.DEEPSEEK,
+		slug: "deepseek",
+		envVar: "DEEPSEEK_API_KEY"
+	},
+	{
+		provider: SupportedProviders.FIREWORKS_AI,
+		slug: "fireworks",
+		envVar: "FIREWORKS_API_KEY"
+	},
+	{
+		provider: SupportedProviders.OPENROUTER,
+		slug: "openrouter",
+		envVar: "OPENROUTER_API_KEY"
+	},
+	{
+		provider: SupportedProviders.X_AI,
+		slug: "xai",
+		envVar: "XAI_API_KEY"
+	},
+	{
+		provider: SupportedProviders.CEREBRAS,
+		slug: "cerebras",
+		envVar: "CEREBRAS_API_KEY"
+	},
+	{
+		provider: SupportedProviders.SAMBANOVA,
+		slug: "sambanova",
+		envVar: "SAMBANOVA_API_KEY"
+	},
+	{
+		provider: SupportedProviders.HUGGINGFACE,
+		slug: "huggingface",
+		envVar: "HUGGINGFACE_API_KEY"
+	},
+	{
+		provider: SupportedProviders.REPLICATE,
+		slug: "replicate",
+		envVar: "REPLICATE_API_TOKEN"
+	},
+	{
+		provider: SupportedProviders.AI21,
+		slug: "ai21",
+		envVar: "AI21_API_KEY"
+	},
+	{
+		provider: SupportedProviders.DEEPINFRA,
+		slug: "deepinfra",
+		envVar: "DEEPINFRA_API_KEY"
+	}
+];
+/**
+* Get default provider configurations from environment variables.
+*
+* Scans for known API key environment variables and creates
+* InlineProviderConfig entries for each one found.
+*
+* @param env - Environment variables object (defaults to process.env)
+* @returns Array of auto-configured providers
+*
+* @example
+* ```typescript
+* // With OPENAI_API_KEY and ANTHROPIC_API_KEY set in environment:
+* const defaults = getDefaultProviders();
+* // Returns:
+* // [
+* //   { provider: 'openai', slug: 'openai', apiKey: '...' },
+* //   { provider: 'anthropic', slug: 'anthropic', apiKey: '...' }
+* // ]
+* ```
+*/
+function getDefaultProviders(env = process.env) {
+	const providers = [];
+	for (const mapping of DEFAULT_PROVIDER_MAPPINGS) {
+		const apiKey = env[mapping.envVar];
+		if (apiKey) providers.push({
+			provider: mapping.provider,
+			slug: mapping.slug,
+			apiKey
+		});
+	}
+	return providers;
+}
+/**
+* Merge user-provided providers with default providers.
+*
+* User-provided providers take precedence:
+* - If a user specifies a provider with the same slug, the default is ignored
+* - If a user specifies the same provider type with a different slug, both are kept
+*
+* @param userProviders - User-configured providers (may be undefined)
+* @param env - Environment variables object (defaults to process.env)
+* @returns Merged array of providers (user configs + non-conflicting defaults)
+*
+* @example
+* ```typescript
+* // User overrides openai with custom slug
+* const merged = mergeWithDefaultProviders([
+*   { provider: 'openai', slug: 'my-openai', apiKey: 'custom-key' }
+* ]);
+* // Default 'openai' slug is still added if OPENAI_API_KEY is set,
+* // user's 'my-openai' is kept as separate config
+* ```
+*/
+function mergeWithDefaultProviders(userProviders, env = process.env) {
+	const defaults = getDefaultProviders(env);
+	if (!userProviders || userProviders.length === 0) return defaults;
+	const userSlugs = new Set(userProviders.map((p) => p.slug));
+	const nonConflictingDefaults = defaults.filter((d) => !userSlugs.has(d.slug));
+	return [...userProviders, ...nonConflictingDefaults];
+}
+/**
+* List of supported default provider environment variables.
+* Useful for documentation or debugging.
+*/
+const DEFAULT_PROVIDER_ENV_VARS = DEFAULT_PROVIDER_MAPPINGS.map((m) => m.envVar);
+
 //#endregion
 //#region src/schemas/openai.ts
 const chatCompletionContentPartTextSchema = object({
@@ -447,12 +612,19 @@ const inlineProviderConfigSchema = object({
 * Schema for providers array
 */
 const providersConfigSchema = array(inlineProviderConfigSchema).optional();
-const llmopsConfigSchema = object({
+/**
+* Base schema without refinements (used for transform)
+*/
+const llmopsConfigBaseSchema = object({
 	database: any().optional(),
 	basePath: string().min(1, "Base path is required and cannot be empty").refine((path$1) => path$1.startsWith("/"), "Base path must start with a forward slash"),
 	schema: string().optional().default("llmops"),
 	providers: providersConfigSchema
-}).refine((config) => config.database !== void 0 || config.providers && config.providers.length > 0, "Either database or providers must be configured");
+});
+const llmopsConfigSchema = llmopsConfigBaseSchema.transform((config) => ({
+	...config,
+	providers: mergeWithDefaultProviders(config.providers)
+})).refine((config) => config.database !== void 0 || config.providers && config.providers.length > 0, "Either database or providers must be configured. Set a database connection, configure providers explicitly, or set API key environment variables (e.g., OPENAI_API_KEY).");
 function validateLLMOpsConfig(config) {
 	const result = llmopsConfigSchema.safeParse(config);
 	if (!result.success) {
@@ -3751,4 +3923,4 @@ var ManifestRouter = class {
 };
 
 //#endregion
-export { CacheService, FileCacheBackend, MS, ManifestBuilder, ManifestRouter, ManifestService, MemoryCacheBackend, ModelsDevPricingProvider, SCHEMA_METADATA, SupportedProviders, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };
+export { CacheService, DEFAULT_PROVIDER_ENV_VARS, FileCacheBackend, MS, ManifestBuilder, ManifestRouter, ManifestService, MemoryCacheBackend, ModelsDevPricingProvider, SCHEMA_METADATA, SupportedProviders, calculateCost, chatCompletionCreateParamsBaseSchema, configVariantsSchema, configsSchema, createConfigDataLayer, createConfigVariantDataLayer, createDataLayer, createDatabase, createDatabaseFromConnection, createDatasetsDataLayer, createEnvironmentDataLayer, createEnvironmentSecretDataLayer, createGuardrailConfigsDataLayer, createLLMRequestsDataLayer, createNeonDialect, createPlaygroundDataLayer, createPlaygroundResultsDataLayer, createPlaygroundRunsDataLayer, createProviderConfigsDataLayer, createProviderGuardrailOverridesDataLayer, createTargetingRulesDataLayer, createVariantDataLayer, createVariantVersionsDataLayer, createWorkspaceSettingsDataLayer, datasetRecordsSchema, datasetVersionRecordsSchema, datasetVersionsSchema, datasetsSchema, detectDatabaseType, dollarsToMicroDollars, environmentSecretsSchema, environmentsSchema, executeWithSchema, formatCost, gateway, generateId, getAuthClientOptions, getDefaultPricingProvider, getDefaultProviders, getMigrations, guardrailConfigsSchema, llmRequestsSchema, llmopsConfigSchema, logger, matchType, mergeWithDefaultProviders, microDollarsToDollars, parsePartialTableData, parseTableData, playgroundColumnSchema, playgroundResultsSchema, playgroundRunsSchema, playgroundsSchema, providerConfigsSchema, providerGuardrailOverridesSchema, runAutoMigrations, schemas, targetingRulesSchema, validateLLMOpsConfig, validatePartialTableData, validateTableData, variantJsonDataSchema, variantVersionsSchema, variantsSchema, workspaceSettingsSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmops/core",
-  "version": "0.5.0-beta.2",
+  "version": "0.5.0-beta.4",
   "description": "Core LLMOps functionality and utilities",
   "type": "module",
   "license": "Apache-2.0",
@@ -55,7 +55,7 @@
     "kysely": "^0.28.8",
     "kysely-neon": "^2.0.2",
     "pino": "^10.1.0",
-    "@llmops/gateway": "^0.5.0-beta.2"
+    "@llmops/gateway": "^0.5.0-beta.4"
   },
   "devDependencies": {
     "@types/json-logic-js": "^2.0.8",