microdao-daarion/docs/cursor/22_agent_only_interface_tasks.md

22 — Agent-Only Interface Tasks (MicroDAO)

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

Цей документ містить детальні технічні задачі для поетапної реалізації агентського інтерфейсу MicroDAO. Кожну задачу можна давати Cursor окремо для поступової розробки.

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

---

Task 1 — UI-Agents-List (People / Agents / Robots панель)

Мета

Зробити лівий блок "Учасники", де видно Людей, Агентів і (поки що) плейсхолдер Роботів. Клік по елементу відкриває відповідний чат/сторінку.

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

1. Розташування

• Лівий сайдбар, нижче/поруч з блоком "Простори (microDAO)".

• Заголовок: Учасники.

• Вкладки або груповані секції:

  • Люди
  • Агенти
  • Роботи (поки список порожній, з текстом "Скоро").

2. Дані

• People:

  • id, display_name, avatar_url, online_status.

• Agents:

  • id, name, role, avatar, maybe type (system/custom).

• Robots:

  • поки просто статичний текст: "Роботи поки не під'єднані".

На бекенді: можна зробити:

• GET /participants?team_id=... → { people: [...], agents: [...] } або окремі запити GET /members, GET /agents.

3. UI-поведінка

• Клік по Людині:

  • відкриває DM-чат /t/:teamId/dm/:userId.

• Клік по Агенту:

  • відкриває сторінку агента /t/:teamId/agent/:agentId або агент-чат.

• Список скролиться, якщо елементів багато.

4. Інтеграція з існуючим кодом

• Використати загальні компоненти Sidebar, Avatar, ListItem.
• Типи/інтерфейси привести до стандартів з 05_coding_standards.md.

Acceptance Criteria

• У лівому сайдбарі є блок "Учасники" з секціями Люди, Агенти, Роботи.
• Для Людей і Агентів рендеряться реальні дані з API (або mock, якщо API ще нема).
• Клік по Людині відкриває приватний чат (навіть якщо поки stub).
• Клік по Агенту відкриває сторінку/чат агента.
• "Роботи" відображаються як порожній список з плейсхолдером.

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

Implement the Participants panel (People / Agents / Robots) in the left sidebar using:

- 21_agent_only_interface.md
- 10_agent_ui_system.md
- 03_api_core_snapshot.md
- 05_coding_standards.md

Deliverables:

- Sidebar section "Учасники" with groups: Люди, Агенти, Роботи.
- Click on a Person opens DM route `/t/:teamId/dm/:userId` (stub if needed).
- Click on an Agent opens `/t/:teamId/agent/:agentId`.

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

---

# Task 2 — Invite-Agent-Flow (модалка прав + web3-тригери)

## Мета

Дати можливість додавати агентів до каналів/чатів з налаштуванням прав. Web3 — на першому етапі Stub (просто підготувати місце для виклику Governance/Web3-агента).

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

### 1. Де викликається

- У header каналу/чату — кнопка `+ Додати учасника`.
- Доступна тільки для користувача з правами `admin`/`owner` (поки можна не перевіряти, просто буде кнопка).

### 2. Модалка

- Заголовок: "Додати учасника".
- Tabs:

  - `Люди`
  - `Агенти`
- Із них нас цікавить вкладка `Агенти`.

### 3. Вкладка "Агенти"

- Список доступних агентів з пошуком.
- По кліку на агента або чекбоксом обираємо 1–N агентів.

### 4. Налаштування прав

- Секція "Права в цьому каналі":

  - `[ ] Читати`
  - `[ ] Писати`
  - `[ ] Створювати задачі / follow-ups`
- За замовчуванням: `Читати` увімкнено, інші вимкнено.

### 5. API / Entitlements

- On Submit:

  - `POST /entitlements` (або аналог) із даними:

    - `agent_id`
    - `resource_kind: "channel"`
    - `resource_id: channelId`
    - `scopes: ["read", "write", "tasks"]` (залежить від чекбоксів)

- Web3 Stub:

  - В коді робимо виклик функції `governance.issueAccessToken(...)` або логування TODO;
  - Реальної транзакції поки не робимо.

### 6. UX

- Після успіху модалка закривається.
- У хедері каналу в списку учасників зʼявляється новий агент.

## Acceptance Criteria

- У кожному каналі/чаті є кнопка "Додати учасника".
- В модалці є вкладка "Агенти" зі списком наявних агентів.
- Можна обрати агента, налаштувати права, натиснути "Запросити".
- На бекенді зберігаються entitlements (навіть якщо прості JSON у БД).
- Після додавання агент показується як учасник каналу.
- В коді є очевидний Stub для майбутньої web3 інтеграції.

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

```text
Implement the "Invite Agent" flow for channels using:

- 21_agent_only_interface.md
- microdao — RBAC and Entitlements (MVP)
- 10_agent_ui_system.md
- 05_coding_standards.md

Deliverables:

1) "Add participant" button in channel header.
2) Modal with tabs People / Agents, focusing on Agents tab.
3) Permissions UI for agent (read / write / tasks).
4) POST entitlements call to store agent-channel permissions (web3 as stub hook).

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

---

# Task 3 — Share-Resource-Flow (проєкт / БД / knowledge space)

## Мета

Реалізувати базову можливість "поділитися ресурсом" (спочатку — Проєктом), з видачею прав людям/агентам. БД / knowledge space можна підключати далі за тим самим патерном.

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

### 1. Ресурси для MVP

- Почати з `Проєктів` (Projects Agent з документу 15).
- Інтерфейс у правому сайдбарі для активного контексту:

  - розділ "Проєкти цього контексту",
  - кожен проєкт має кнопку `⋯` → `Поділитися`.

### 2. Модалка "Поділитися проєктом"

- Заголовок: "Поділитися проєктом".
- Tabs:

  - `Люди`
  - `Агенти`
- Список одержувачів з пошуком.

### 3. Права доступу

- Радіо-кнопки або чекбокси:

  - `Тільки читати`
  - `Читати і оновлювати задачі`
  - `Адмініструвати проєкт`
- Для MVP:

  - мапимо на `["read"]`, `["read","write"]`, `["admin"]`.

### 4. API / Entitlements

- `POST /entitlements`:

  - `resource_kind: "project"`
  - `resource_id: projectId`
  - `subject_kind: "user" | "agent"`
  - `subject_id: ...`
  - `scopes: [...]`

- Web3 Stub:

  - так само, як у Task 2 — залишити хук/функцію для майбутньої транзакції.

### 5. Відображення

- У правому сайдбарі для вибраного проєкту:

  - короткий список: хто має доступ (іконки + тип: людина/агент).
  - посилання "Керувати доступами" (можна виводити ту ж саму модалку).

## Acceptance Criteria

- У правому сайдбарі є список проєктів для контексту (навіть якщо один).
- Для кожного проєкту доступна дія "Поділитися".
- Модалка дозволяє вибрати людей/агентів і рівень доступу.
- Після підтвердження зʼявляються записи entitlements.
- У правій панелі видно, що проєкт поділено з конкретними субʼєктами.

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

```text
Implement the "Share Project" flow as the first Resource Sharing feature using:

- 21_agent_only_interface.md
- 15_projects_agent_module.md (if present)
- microdao — RBAC and Entitlements (MVP)
- 05_coding_standards.md

Deliverables:

1) In the right sidebar, show list of projects for the current context.
2) Add "Share" action for a project → opens modal.
3) Modal lets the user pick People or Agents and assign access level (read / read+write / admin).
4) POST entitlements to persist access.
5) Show who has access in the sidebar (avatars + type).

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

---

# Task 4 — Agent-Hub-Home (стартовий екран "все через агента")

## Мета

Зробити "Agent Hub" як домашню точку входу в microDAO: користувач відкриває `/t/:teamId/home` і бачить чат з головним агентом + базові віджети стану.

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

### 1. Новий маршрут

- `GET /t/:teamId/home` (frontend route).
- Відображає `AgentHubPage`.

### 2. AgentHubPage структура

- Верх:

  - заголовок: `microDAO: {team.name}`
  - короткі віджети (можуть бути stub):

    - "Учасники: X людей, Y агентів"
    - "Активні проєкти: N"

- Центр:

  - чат з головним агентом (Team Assistant або спеціальний OS Agent):

    - використовує вже існуючий `AgentChatWindow`.
    - агент_id береться з конфіг (наприклад, "team_assistant" для цієї команди).

- Праворуч:

  - контекст (список проєктів / каналів / ресурсів — поки можна stub).

### 3. Поведінка чату

- Перший запуск:

  - агент вітається, якщо немає історії:

    > "Привіт, це твій Agent Hub. Я допоможу керувати твоєю microDAO."

- Далі:

  - користувач може написати запит, наприклад:

    - "Покажи активні проєкти"
    - "Відкрий канал #dev-mvp"
    - "Хочу створити новий проєкт"
  - Поки що можна зробити stub-відповіді, якщо Projects/Messenger Agents ще не реалізовані.

### 4. Навігація

- Кнопка/посилання "Головна" у лівому сайдбарі веде на `/t/:teamId/home`.
- Після успішного онбордингу (з `08_agent_first_onboarding.md`) редірект також може йти на Agent Hub.

## Acceptance Criteria

- Існує маршрут `/t/:teamId/home`, який рендерить Agent Hub.
- У центрі — робочий чат з Team Assistant (через `/agents/{id}/chat` endpoint).
- У сайдбарі є посилання "Головна" / "Agent Hub", що веде на цей екран.
- Якщо історії немає — агент показує вітальний меседж.
- Екран виглядає як "головна консоль" microDAO, а не просто черговий канал.

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

```text
Implement the Agent Hub Home screen using:

- 21_agent_only_interface.md
- 10_agent_ui_system.md
- 11_llm_integration.md
- 12_agent_runtime_core.md
- 05_coding_standards.md

Deliverables:

1) New route `/t/:teamId/home` rendering AgentHubPage.
2) AgentHubPage:
   - header with team name and basic stats (stub).
   - central chat with Team Assistant agent (AgentChatWindow).
   - optional right sidebar context (stub).
3) "Home / Agent Hub" entry in left sidebar that routes to `/t/:teamId/home`.

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

---

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

Рекомендований порядок реалізації:

1. **Task 1** — UI-Agents-List (базова структура учасників)
2. **Task 4** — Agent-Hub-Home (стартовий екран)
3. **Task 2** — Invite-Agent-Flow (додавання агентів до каналів)
4. **Task 3** — Share-Resource-Flow (поділ ресурсів)

Альтернативний порядок (якщо потрібно спочатку базовий функціонал):

1. **Task 4** — Agent-Hub-Home
2. **Task 1** — UI-Agents-List
3. **Task 2** — Invite-Agent-Flow
4. **Task 3** — Share-Resource-Flow

---

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

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

---

# Загальні вимоги для всіх задач

## Технічні вимоги

- Дотримуватися `05_coding_standards.md`
- Використовувати типи з `03_api_core_snapshot.md`
- Інтегрувати з існуючими компонентами з `10_agent_ui_system.md`
- Дотримуватися UI/UX з `04_ui_ux_onboarding_chat.md`

## Тестування

- Кожна задача має мінімальні unit tests
- Перевірити наявність помилок TypeScript
- Перевірити відповідність acceptance criteria

## Документація

- Оновити `src/README.md` з описом нових компонентів
- Додати коментарі до складних частин коду

---

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