microdao-daarion/docs/cursor/24_agent_cards_tasks.md

24 — Agent Cards and Console Tasks (MicroDAO)

Структурований список задач для реалізації Agent Cards та Console

Цей документ містить детальні технічні задачі для поетапної реалізації системи карток агентів та Agent Console.

Базовий документ: 23_agent_cards_and_console.md

---

Task 1 — Agent-Cards-Grid (плитки агентів)

Мета

Створити компонент AgentCard та AgentGrid для відображення агентів у вигляді "живих карток" з метриками досвіду, репутації та присутності.

Специфікація

1. Компонент AgentCard

• Розмір: 280x360px (рекомендовано)

• Структура:

  • Верхній блок: Аватар + відео-аватар (64x64px)
  • Імʼя та роль
  • Метрики: Вік, Досвід 1T, Репутація
  • Присутність: бейджі каналів/проєктів
  • Статус підключення

2. Компонент AgentGrid

• Сітка карток (responsive: 1-4 колонки)
• Фільтри: "Всі", "Підключені", "Доступні"
• Пошук по імені/ролі

3. Дані

• API: GET /agents?team_id=...
• Метрики: GET /agents/{id}/metrics
• Присутність: GET /agents/{id}/presence

4. Hover ефект

• Напівпрозорий оверлей з кнопками:
  • "Почати взаємодію"
  • "Підключити до каналу"
  • "Деталі агента"

5. Клік

• Відкриває Agent Console (Task 2)

Acceptance Criteria

• Картки агентів відображаються у сітці
• Показуються метрики (вік, 1T, репутація)
• Hover показує опції взаємодії
• Клік відкриває Agent Console
• Фільтри та пошук працюють

Приклад промта для Cursor

Implement Agent Cards Grid using:

- 23_agent_cards_and_console.md
- 10_agent_ui_system.md
- 05_coding_standards.md

Deliverables:

1) AgentCard component with avatar, name, role, metrics (age, 1T, reputation).
2) AgentGrid component with responsive layout (1-4 columns).
3) Hover overlay with action buttons.
4) Filters: All / Connected / Available.
5) Search by name/role.

Output: list of files + diff + summary.
```text

---

# Task 2 — Agent-Console-UI (повний інтерфейс)

## Мета

Створити Agent Console — повний інтерфейс для взаємодії з агентом з 5 вкладками.

## Специфікація

### 1. Структура Agent Console

- Верхня панель: Аватар, імʼя, метрики
- Вкладки: Чат, Файли, Памʼять, Присутність, Еволюція
- Контент вкладок (деталі нижче)

### 2. Вкладка "Чат"

- Використовує `AgentChatWindow` з `10_agent_ui_system.md`
- Додатково: кнопка "Голосовий діалог" (stub для MVP)
- Показ поточного контексту

### 3. Вкладка "Файли та Документи"

- Список файлів (з API або stub)
- Кнопка "Завантажити файл"
- Індикатор: "Документи зберігаються в просторі вашої microDAO"

### 4. Вкладка "Памʼять і Знання"

- Використовує компоненти з `13_agent_memory_system.md`
- Короткострокова та довгострокова памʼять
- Кнопки управління памʼяттю

### 5. Вкладка "Присутність / Права доступу"

- Таблиця просторів (канали, проєкти)
- Перемикачі підключення
- Рівні доступу
- Кнопка "Додати до нового каналу/проєкту"

### 6. Вкладка "Еволюція та дух спільноти"

- Лог внеску агента
- Статистика запитів
- Репутація від спільноти
- Без фінансових термінів

## Acceptance Criteria

- Agent Console відкривається при кліку на картку
- Всі 5 вкладок працюють
- Чат інтегрований з Agent Runtime Core
- Файли показуються (stub дані OK)
- Памʼять інтегрована з Memory System
- Присутність показує реальні дані
- Еволюція показує лог (stub OK)

## Приклад промта для Cursor

```text
Implement Agent Console UI using:

- 23_agent_cards_and_console.md
- 10_agent_ui_system.md
- 13_agent_memory_system.md
- 12_agent_runtime_core.md
- 05_coding_standards.md

Deliverables:

1) AgentConsole component with 5 tabs.
2) Chat tab: integrate AgentChatWindow.
3) Files tab: file list + upload button (stub).
4) Memory tab: integrate memory components.
5) Presence tab: table with connect/disconnect toggles.
6) Evolution tab: log display (stub data OK).

Output: list of files + diff + summary.
```text

---

# Task 3 — Agent-Experience-Metrics (1T + репутація)

## Мета

Реалізувати систему метрик досвіду агентів: вік, досвід 1T, репутація спільноти.

## Специфікація

### 1. Вік агента

- Розрахунок: `created_at` до поточної дати
- Формат: "3 тижні", "6 місяців", "1 рік 2 місяці"
- API: `GET /agents/{id}/metrics` → `{ age: { weeks, months, years } }`

### 2. Досвід 1T

- Лічильник: велике число з розділювачами (12 340 1T)
- Tooltip: "1T — це внутрішня одиниця обчислень і досвіду агента"
- API: `GET /agents/{id}/metrics` → `{ experience1T: number }`
- Візуалізація: великий текст з іконкою

### 3. Репутація спільноти

- Шкала: 0-100 або 0-5 зірок
- Розрахунок: на основі фідбеку від учасників
- API: `GET /agents/{id}/metrics` → `{ reputation: { score, type } }`
- Візуалізація: прогрес-бар або зірки

### 4. Компонент AgentMetrics

```tsx
interface AgentMetricsProps {
  agentId: string;
  compact?: boolean; // для картки vs консолі
}

export function AgentMetrics({ agentId, compact }: AgentMetricsProps) {
  // Відображення метрик
}
```text

## Acceptance Criteria

- Вік агента розраховується правильно
- 1T показується з tooltip
- Репутація відображається візуально
- Метрики оновлюються при зміні даних

## Приклад промта для Cursor

```text
Implement Agent Experience Metrics using:

- 23_agent_cards_and_console.md
- 03_api_core_snapshot.md
- 05_coding_standards.md

Deliverables:

1) Calculate agent age from created_at.
2) Display 1T experience with tooltip explanation.
3) Display reputation (0-100 scale or 0-5 stars).
4) AgentMetrics component for reuse in Card and Console.
5) API integration: GET /agents/{id}/metrics.

Output: list of files + diff + summary.
```text

---

# Task 4 — Agent-Connections-Toggles (підключення/відключення)

## Мета

Реалізувати управління підключеннями агентів до просторів (канали, проєкти) з перемикачами.

## Специфікація

### 1. На картці агента

- Бейджі: "Публічні простори: 2", "Конфіденційні: 1"
- При кліку — модалка зі списком просторів
- Перемикачі для кожного простору

### 2. У Agent Console (вкладка "Присутність")

- Таблиця просторів:
  - Простір / Тип / Доступ / Статус / Дії
- Перемикач "Підключено/Відʼєднано"
- Кнопка "Додати до нового простору"

### 3. API

- `GET /agents/{id}/presence` → список просторів
- `POST /agents/{id}/presence/connect` → підключити
- `POST /agents/{id}/presence/disconnect` → відключити

### 4. UX

- При відключенні: підтвердження
- При підключенні: вибір прав доступу
- Оновлення UI після зміни

## Acceptance Criteria

- Бейджі на картці показують кількість просторів
- Модалка зі списком просторів працює
- Перемикачі в консолі працюють
- API виклики зберігають зміни
- UI оновлюється після змін

## Приклад промта для Cursor

```text
Implement Agent Connections Management using:

- 23_agent_cards_and_console.md
- 21_agent_only_interface.md
- 03_api_core_snapshot.md
- 05_coding_standards.md

Deliverables:

1) Badges on agent card showing presence count.
2) Modal with list of spaces (channels/projects) for agent.
3) Toggle switches in Agent Console Presence tab.
4) Connect/disconnect API calls.
5) UI updates after connection changes.

Output: list of files + diff + summary.
```text

---

# Порядок виконання задач

Рекомендований порядок:

1. **Task 1** — Agent-Cards-Grid (базова структура карток)
2. **Task 3** — Agent-Experience-Metrics (метрики для карток)
3. **Task 2** — Agent-Console-UI (повний інтерфейс)
4. **Task 4** — Agent-Connections-Toggles (управління підключеннями)

---

# Залежності між задачами

- **Task 1** не залежить від інших
- **Task 3** може використовуватися в Task 1
- **Task 2** потребує Task 1 (відкриття консолі з картки)
- **Task 4** потребує Task 2 (вкладка "Присутність")

---

# Загальні вимоги

## Термінологія

**Важливо:** Використовувати тільки людську термінологію:

✅ Дозволено:
- "досвід"
- "шлях агента"
- "довіра спільноти"
- "внесок у колективний розум"
- "репутація"

❌ Заборонено:
- "інвестиції"
- "юніти вартості"
- "ROI"
- "прибуток"
- будь-які фінансові терміни

## Зберігання даних

- Всі файли/документи зберігаються в сховищі microDAO
- Показувати індикатор: "Документи зберігаються в просторі вашої microDAO"
- DAGI використовується як "мозок", але не як сховище

---

**Готово.**  
Це **структурований список задач для Agent Cards та Console**, готовий до використання в Cursor.