Cloud study guides: what the first cloud AI feature must do¶
Technical version: WING-193 cloud study-guide provider vertical
What it is¶
POST /api/cloud/study-guide is the first cloud path that calls an AI provider on a shared surface used by desktop, YC, and Flow. You send a topic, goals, source material, and an explicit consent that cloud processing is allowed.
Safety before anything leaves¶
The service only uses an explicitly configured key-based provider for this feature. It will not quietly fall back to a desktop command-line AI, a local model, or “whatever default the user set on their machine.”
Missing configuration returns not configured without sending your content. Server edition needs a real tenant session plus CSRF protection — there is no shared browser API-key back door.
Before a call:
- consent and authentication checks
- size and estimated cost ceilings
- a per-tenant daily spend reservation so concurrent requests cannot blow the budget
- rate limits (a small number of calls per minute per tenant)
Usage metering records counts and model names, not the text of your prompt or the generated guide.
Fail closed¶
Unconfigured, over budget, unavailable, or provider failure means a clear failure — never a local imitation presented as if it came from the cloud.