Configuration Schema

Fairvisor validates policy bundles as JSON objects at load time.

There is no public hosted JSON Schema URL in the current OSS runtime. The canonical validation logic is in the runtime loader and limiter validators.

Runtime sources of truth

  • src/fairvisor/bundle_loader.lua
  • src/fairvisor/token_bucket.lua
  • src/fairvisor/cost_budget.lua
  • src/fairvisor/llm_limiter.lua

Canonical references on this site

Validation behavior

Bundle loading fails when required fields are missing or invalid, for example:

  • invalid/absent bundle_version
  • invalid policies structure
  • invalid limiter configuration for token_bucket, cost_based, or token_bucket_llm
  • invalid kill_switches