model-catalog

Configuration

Config file catalog.config.json (in the plugin root; overridable with --config FILE; all fields optional):

{
  "baseUrl": "https://api.deepseek.com",
  "apiKeyEnv": "DEEPSEEK_API_KEY",
  "probe": "auto",
  "externalUrl": "https://example.com/mirror.json",
  "outputDir": "out",
  "cacheDir": "var",
  "httpTimeoutMs": 10000
}

Field	Default	Description
baseUrl	none	Host address; also --base-url on the CLI
apiKeyEnv	auto	Key environment variable name; auto-detects MODELCAT_API_KEY / DEEPSEEK_API_KEY / OPENAI_API_KEY
kindHint	none	Force host type (bare/augmented/quota/flag/ollama/vllm)
probe	auto	Capability probe mode
catalogTtlSec	900	Catalog freshness (reused by the plugin list tool)
probeTtlSec	86400	Probe result cache TTL
detectTtlSec	3600	Host classification cache TTL
externalUrl	none	External price mirror URL (structure in data/mirror.example.json)
outputDir / cacheDir	out / var	Output and cache directories
concurrency	4	Fetch concurrency (e.g. Ollama /api/show)
httpTimeoutMs	10000	HTTP timeout

Keys are only passed via environment variables (--api-key is for transient CLI use only); no artifact file ever contains a plaintext key.