Skip to main content

veryfront/provider

Provider registry. Maps “provider/model” strings to framework-compatible model runtimes. Auto-initializes built-in providers from environment variables on first use.

Import

import {
  registerModelProvider,
  resolveModel,
  hasModelProvider,
  getRegisteredModelProviders,
  clearModelProviders,
  ensureModelReady,
} from "veryfront/provider";

Examples

Resolve a model

import { resolveModel } from "veryfront/provider";

const model = resolveModel("veryfront-cloud/openai/gpt-5.2");

API

registerModelProvider(name, factory)

Register a custom model provider factory for the current project. Returns: void

resolveModel(modelString)

Resolve a “provider/model” string to a framework-compatible model runtime. Returns: ModelRuntime

hasModelProvider(name)

Check if a model provider is registered (project-scoped or shared). Returns: boolean

getRegisteredModelProviders()

Get list of registered model provider names (project-scoped + shared). Returns: string[]

clearModelProviders()

Clear all registered model providers (for testing). Returns: void

Exports

Functions

NameDescription
clearModelProvidersClear all registered model providers (for testing).
ensureModelReadyEagerly verify that the resolved model’s runtime is available.
findAvailableCloudModelFind the first cloud provider with a valid API key.
getRegisteredModelProvidersGet list of registered model provider names (project-scoped + shared).
hasModelProviderCheck if a model provider is registered (project-scoped or shared).
registerModelProviderRegister a custom model provider factory for the current project.
resolveModelResolve a “provider/model” string to a framework-compatible model runtime.
runWithVeryfrontCloudContext
runWithVeryfrontCloudContextAsync

Types

NameDescription
ModelProviderFactory(modelId: string) => LanguageModel
ModelRuntime
VeryfrontCloudContext