Skip to content

# 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).

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

    {
      "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, ноди) розгортаються через агентів.