Add admin settings API for AI key configuration #56

New issue

Closed

opened 2026-02-17 15:33:36 +00:00 by mik-tf · 0 comments

mik-tf commented

2026-02-17 15:33:36 +00:00

Owner

Context

AI keys (Groq, OpenRouter, SambaNova) are only configurable via env vars sourced from ~/hero/cfg/env/env.sh. No runtime API exists to read or update them.

Goals

admin.settings.get RPC: returns masked key status per provider and embedder URL
admin.settings.set RPC: updates keys, persists to ~/hero/var/hero_books/settings.toml, applies to process env
Load saved settings on startup with env var fallback
Enables a settings UI in the books archipelago island (tracked in hero_archipelagos #15)

## Context AI keys (Groq, OpenRouter, SambaNova) are only configurable via env vars sourced from `~/hero/cfg/env/env.sh`. No runtime API exists to read or update them. ## Goals - `admin.settings.get` RPC: returns masked key status per provider and embedder URL - `admin.settings.set` RPC: updates keys, persists to `~/hero/var/hero_books/settings.toml`, applies to process env - Load saved settings on startup with env var fallback - Enables a settings UI in the books archipelago island (tracked in hero_archipelagos #15)