# Agents_Interface_Architecture_v1.md

## DAARION.city — Agent-Centric Interface Architecture

**Version:** 1.0  
**Status:** Foundation Spec (MVP)  
**Scope:** Архітектура інтерфейсу агентів: primary_agent, team_agents, кабінети, ролі, кімнати, взаємодія з MicroDAO, Nodes, City.

---

# 0. Мета документа

Описати агентно-центровану модель інтерфейсу DAARION.space:

* кожна сторінка має агента-власника,
* первинні/командні агенти,
* кабінети агентів,
* категорії агентів,
* кімнати та віжети,
* інтеграцію з MicroDAO/City/Nodes.

---

# 1. Принцип

> **Усі сторінки, сцени й кімнати належать агентам (primary_agent).**

Структура сторінки:

```json
{
  "primary_agent": "agent_id",
  "team_agents": ["agent_id_2","agent_id_3"]
}
```

---

# 2. Типи агентів

1. Personal Agents (агенти користувачів).
2. Organizational Agents (належать MicroDAO).
3. Core-Team Agents (CEO/CTO/LegaI/Architect).
4. Public City Agents (DARIO, DARIA, DAARWIZZ, City Info).
5. Service/Infrastructure Agents (monitoring, bridge, summarizer).
6. District/Platform Agents (Helion, ERP GREENFOOD).

---

# 3. Primary vs Team Agents

* **Primary agent** — господар сцени (City Square → DARIO; MicroDAO Dashboard → Orchestrator).
* **Team agents** — асистують (DARIA, Security agent, DevOps agent тощо).

---

# 4. Кабінет агента

* **Profile** — ім’я, DAIS, роль, MicroDAO.
* **Activity** — події, дії, лог.
* **Rooms** — кімнати агента.
* **Workspaces** — проєкти, задачі.
* **Nodes** — home node, active session node.
* **Tools** — моделі, інтеграції.
* **Assignments** — MicroDAO / District / City scope.

---

# 5. Agent Rooms

* Personal room (DM з людиною).
* Workspace room (внутрішні).
* Public front room (у місті).
* Service room (інфраструктура).
* District room (платформи).

---

# 6. Зв’язки

* **Agent → MicroDAO**: ролі, дозволи, кімнати, проєкти.
* **Agent → Node**: home/active node, ресурси.
* **Agent → City**: публічні агенти, кіоски, City Square.

---

# 7. Widgets & Actions

* Кожен віджет має `agent_owner`.
* Будь-яка дія (створити MicroDAO, зареєструвати ноду) здійснюється агентом.

---

# 8. Agent Lifecycle

1. Creation (DAIS onboarding).
2. Assignment до MicroDAO.
3. Node placement.
4. Room creation.
5. Activity.
6. Promotion (core-team/orchestrator).
7. Archival.

---

# 9. MVP Scope

* Кабінет агента.
* Primary/team agent модель.
* Списки персональних/організаційних/публічних агентів.
* Agent rooms, projects, nodes.
* Присутність агента в City Square.

---

# 10. Підсумок

Агенти — центральні суб’єкти DAARION.space.  
Цей документ закріплює інтерфейсну модель, у якій кожна сцена має primary_agent та команду агента, а всі функції (місто, MicroDAO, ноди) розгортаються через агентів.