Spaces
A space is a group of chats that share the same context. When you link conversations to a space, the platform summarizes those conversations and feeds the context back into new chats. This means agents understand the project background without you having to explain it every time.
Spaces are completely separate from workspaces. Workspaces are about files. Spaces are about shared conversation context.
How spaces work
Section titled “How spaces work”Each space maintains:
- A set of related conversations
- Auto-generated context summaries (compacted periodically)
When you start a conversation in a space, the agent sees the summarized context from previous conversations in that space alongside your message.
Space compaction
Section titled “Space compaction”The platform automatically compacts space context at regular intervals (default: every hour, configurable via FRONA_SCHEDULER_SPACE_COMPACTION_SECS).
Compaction summarizes recent conversations in the space into a condensed context block. This keeps the space context useful and current without growing unbounded.
Managing spaces
Section titled “Managing spaces”Spaces are managed through the API:
| Endpoint | Description |
|---|---|
GET /api/spaces | List spaces |
POST /api/spaces | Create a space |
GET /api/spaces/{id} | Get space details |
PUT /api/spaces/{id} | Update a space |
DELETE /api/spaces/{id} | Delete a space |
Linking chats to spaces
Section titled “Linking chats to spaces”When creating a chat, you can specify a space_id to link it to a space. All messages in that chat will contribute to the space’s context during compaction.
Use cases
Section titled “Use cases”- Project work: create a space for each project so agents have ongoing context
- Topic organization: group related conversations by topic
- Team collaboration: share context across multiple conversations about the same subject