Extensibility
Evalution is built around a few small interfaces, so you can swap in your own prompt storage, model SDKs, and trace backends without changing its source code. Each interface below is fully documented in the API reference, generated from the published TypeScript types.
Register your extensions in your project’s .evalution/config.ts —
see Configuration.
Prompt providers
PromptProvider implementations
enable listing, reading, watching, and editing prompts in Evalution. The built-in
FilePromptProvider
works with files from disk (or any FileProvider implementation).
Implement PromptProvider yourself to work with
prompts from a different source, such as a database or an API.
SDK adapters
An SDKAdapter maps a
normalized prompt onto a concrete model SDK. Evalution ships
VercelAISDK (the default) and
GeminiInteractionsSDK (currently experimental).
Implement your own SDKAdapter to work with a different
AI SDK.
Trace providers
A TraceProvider stores and
streams the spans produced when a prompt runs. The in-process
MemoryTraceProvider is
the default; implement the interface to persist traces to your own backend.
See also
The full, type-accurate reference — every exported interface, class, and type — is generated from the source and published alongside these docs:
- Configuration — register your providers and adapters.
- API reference