# 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

```text
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.