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)`

`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

Components

Name	Description	Source
`DEFAULT_VERYFRONT_CLOUD_MODEL_ID`	Default value for Veryfront Cloud model ID.	source
`VERYFRONT_CLOUD_CHAT_MODELS`	Shared Veryfront Cloud chat models value.	source
`VERYFRONT_CLOUD_MODEL_PREFIX`	Shared Veryfront Cloud model prefix value.	source

Functions

Name	Description	Source
`clearModelProviders`	Clear all registered model providers (for testing).	source
`ensureModelReady`	Eagerly verify that the resolved model’s runtime is available.	source
`findAvailableCloudModel`	Find the first cloud provider with a valid API key.	source
`findVeryfrontCloudModel`	Find Veryfront Cloud model.	source
`findVeryfrontCloudModelByModelId`	Find Veryfront Cloud model by model ID.	source
`getRegisteredModelProviders`	Get list of registered model provider names (project-scoped + shared).	source
`getVeryfrontCloudProviderFromModelId`	Return Veryfront Cloud provider from model ID.	source
`groupVeryfrontCloudModelsByProvider`	Group Veryfront Cloud models by provider.	source
`hasModelProvider`	Check if a model provider is registered (project-scoped or shared).	source
`normalizeVeryfrontCloudModelId`	Normalizes Veryfront Cloud model ID.	source
`registerModelProvider`	Register a custom model provider factory for the current project.	source
`resolveModel`	Resolve a “provider/model” string to a framework-compatible model runtime.	source
`resolveVeryfrontCloudGatewayModelId`	Resolves Veryfront Cloud gateway model ID.	source
`resolveVeryfrontCloudModelId`	Resolves Veryfront Cloud model ID.	source
`resolveVeryfrontCloudModelThinking`	Resolves Veryfront Cloud model thinking.	source
`resolveVeryfrontCloudThinkingProviderOptions`	Options accepted by resolve Veryfront Cloud thinking provider.	source
`runWithVeryfrontCloudContext`	Context for run with Veryfront Cloud.	source
`runWithVeryfrontCloudContextAsync`	Run with Veryfront Cloud context async.	source
`tryGetVeryfrontCloudProviderFromModelId`	Try to get Veryfront Cloud provider from model ID.	source

Types

Name	Description	Source
`ModelProviderFactory`	Public API contract for model provider factory.	source
`ModelRuntime`	Public API contract for model runtime.	source
`VeryfrontCloudChatModel`	Public API contract for Veryfront Cloud chat model.	source
`VeryfrontCloudContext`	Context for Veryfront Cloud.	source
`VeryfrontCloudModelThinkingConfig`	Configuration used by Veryfront Cloud model thinking.	source
`VeryfrontCloudProviderId`	Public API contract for Veryfront Cloud provider ID.	source

Constants

Name	Description	Source
`resolveHostedVeryfrontCloudModelId`	Resolves hosted Veryfront Cloud model ID.	source

Deep imports

These import paths group focused functionality under this module. Each is a separate barrel; import only what you need.