agent-zero/plugins/_onboarding/AGENTS.md
frdel 15a2b553be Unify global model presets
Make model presets a single global collection and treat presets as reusable setups (main, utility, embedding). Persisted scope configs now store only a preset name (Default is always present and immutable); project-scoped preset definitions were removed and attempts to edit/reset project presets are rejected. Add embedding-model support throughout: include embedding slot in presets, surface embedding in the switcher and override APIs, and notify extensions when the effective embedding model changes. Implement rename/retire propagation to update plugin configs, saved chats, and live AgentContext objects when preset names change or presets are removed. Update CLI/integration commands to use an "inherit" action for returning to the scoped preset and to report the effective scoped-or-chat preset. Add startup migration/bootstrap to initialize presets from remote or bundled fallback and numerous docs/UI text updates to reflect the new preset model. Extra: refactor config resolution helpers and add safety checks (validation, atomic writes) when saving presets.
2026-07-17 12:16:10 +02:00

975 B

Onboarding Plugin DOX

Purpose

  • Own the built-in first-time onboarding wizard for model configuration.

Ownership

  • plugin.yaml owns metadata and always-enabled status.
  • webui/ owns onboarding providers, wizard store, modal/page markup, and thumbnail.

Local Contracts

  • Keep onboarding provider choices synchronized with model configuration and provider metadata.
  • Do not ask for or expose API keys outside approved settings/API flows.
  • Avoid blocking already-configured users with unnecessary onboarding prompts.
  • Completion updates the selected global model preset (normally immutable-name Default); advanced setup opens that preset in the shared editor.

Work Guidance

  • Coordinate provider changes with _model_config and _oauth when account-backed providers are involved.

Verification

  • Smoke-test first-run onboarding, provider selection, completion, and skip/close behavior after changes.

Child DOX Index

No child DOX files.