Flow
| Step | What happens |
|---|---|
| 1 | A user message is stored in the conversation. |
| 2 | A run starts to produce the assistant response. |
| 3 | Events record streaming output, tool calls, state, and terminal status. |
| 4 | The final answer is stored as an assistant message. |
What persists
| Object | Stores |
|---|---|
| Conversation | Thread metadata, project scope, active branch, and message count. |
| Message | User prompts, assistant answers, tool output, files, citations, and typed parts. |
| Run | Execution identity, owner, status, lineage, and terminal state. |
| Agent run | Conversation-specific execution state and assistant message link. |
| Run event | Ordered execution history for streaming output, tool calls, state, errors, and completion. |
| Input request | Structured input needed while a run is waiting. |