One endpoint
Everything flows through a single streaming endpoint:Quick actions vs. free chat
The client sends anaction with every message. When the student taps a quick action it is set explicitly; when they just type, it defaults to free-chat and the router decides the lane.
| Action | Meaning |
|---|---|
free-chat | The student just typed. The router classifies the message and may upgrade it to one of the lanes below. |
explain-concept | Explain a concept, topic, or piece of course material. |
submission-guide | Help with the mechanics of submitting assessed work. |
advisor | The student wants a human — advice, escalation, or to book a meeting. |
Today all four lanes answer through the conversational engine.
submission-guide (a guided workflow) and advisor (an escalation to a human) get their own dedicated flows as the authenticated-student profile becomes available.Where to go next
Architecture
The full path of a message: quota, guardrails, routing, the conversational graph, streaming, and resumption.
Streaming
How SSE works, why we chose it over WebSockets, and how the frontend consumes it.
Chat API
The
POST /v1/mind/chat reference — request body and the SSE event contract.