Architecture and flow
How a conversation message becomes a durable run and final answer.
A conversation run starts with a stored user message.
Events stream while the runtime works, then the final result returns to the thread.
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
How a conversation message becomes a durable run and final answer.
| 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. |
| 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. |