Reference

Manifest reference

Every field you can declare in an agent.yml manifest.

Field	Description
`apiVersion`	Currently vesper/v1.
`kind`	Currently Agent.
`name`	Unique identifier for the agent.
`model`	For example gpt-4o-mini, claude-3-5-sonnet, or gemini-1.5-pro. Routes to the provider automatically.
`entryPoint`	Path to a Python file whose `@vesper.tool` functions are loaded. Optional.
`tools`	Whitelist of tool names the model may call (built-in or from entryPoint).
`memory.scope`	`session` (per-session thread) or `project` (one persistent thread per agent).
`memory.retentionDays`	History older than this many days is pruned before each run.
`budget.maxCostPerRun`	Hard USD cap per run. A run that would exceed it stops with `BudgetExceededError`.
`budget.alertAt`	Soft USD threshold. Crossing it flags `RunResult.alerted` without stopping the run.