Reload Scope • AI Agent SDK

ReloadScope: Canonical classification of a changed config “path“'s reload scope.

ReloadScope

Defined in the config module.

AI Agent

Canonical classification of a changed config `path`’s reload scope.

Values are plain strings so wrapper/runtime code can compare without importing this class. `FULL` is the fail-safe default for unknown or structural changes.

  • `HOT: apply in place, no restart (see :func:is_hot_appliable`).
  • `CHANNEL: a change under channels.<name>` — restart only that one
  • channel; other channels keep their connections and in-flight turns.
  • `AGENTS`: an agent/provider/guardrails change — recreate agents only,
  • without bouncing channels.
  • `FULL`: unknown or structural change — full restart (fail-safe).

Source

View on GitHub

praisonaiagents/gateway/config.py at line 352