microdao-daarion/docs/cursor/20_integrations_bridges_agent.md

20 — Integrations & Bridges Agent (MicroDAO)

Агент мостів, міжпросторових зв'язків та зовнішньої взаємодії

Integrations & Bridges Agent — це модуль, який забезпечує обмін інформацією між microDAO та зовнішнім світом: іншими платформами, месенджерами, інструментами, сервісами, даними та іншими агентськими екосистемами.

Це "протокольний шар" агентської ОС DAARION.city.

---

1. Призначення

Bridges Agent виконує функції:

• інтеграції із зовнішніми платформами,
• маршрутизації даних,
• синхронізації контекстів,
• взаємодії між різними агентськими системами,
• побудови міжпросторових каналів (cross-microDAO),
• підключення до сторонніх інструментів (пошта, календар, API),
• реалізації безпечних каналів входу/виходу з екосистеми.

Основна ідея — microDAO не живе в ізоляції, а існує у зв'язку зі світом.

---

2. Види інтеграцій

2.1. Месенджери та комунікаційні сервіси

• Telegram (вхідні повідомлення, вихідні, канали, боти)
• WhatsApp / Signal (через API-адаптери)
• Email
• SMS (опційно)

2.2. Робочі інструменти

• Google Calendar / iCal
• Google Drive / Dropbox (для файлів)
• GitHub (issues, PRs, CI)
• Notion / Confluence (документи)

2.3. API зовнішніх сервісів

• Webhooks
• REST / GraphQL
• OAuth2 інтеграції

2.4. Cross-microDAO зв'язки

• "міст" між microDAO для:

  • спільних агентів,
  • спільних проєктів,
  • спільної пам'яті,

• міжміські зв'язки DAARION.city.

2.5. Web3-протоколи

• підписані повідомлення,
• capability-токени доступу,
• безпечна автентифікація.

---

3. Агенти інтеграцій

Модуль складається із під-агентів:

3.1. Bridges Agent (основний)

Роль: "bridges_core"

Він:

• керує списком інтеграцій,
• маршрутизує дані між контекстами,
• керує підключенням зовнішніх API.

3.2. Connector Agents (адаптери)

Ролі: "telegram_connector", "email_connector", "calendar_connector", "github_connector" тощо.

Кожен Connector:

• має свої ключі/аутентифікацію,
• вміє читати/писати події,
• перетворює зовнішній формат → внутрішній формат events у microDAO.

3.3. CrossDAO Agent

Роль: "crossdao_bridge"

Відповідає за:

• між-microDAO синхронізацію,
• передачу фактів/документів,
• спільних агентів,
• правила та ритуали між DAO.

---

4. Модель інтеграції

4.1. Таблиця інтеграцій

integrations:

• id
• team_id
• type (telegram, email, calendar, github, …)
• config_json
• status (active, disabled)
• created_at

4.2. Модель подій

Всі зовнішні події конвертуються у універсальний формат:

event: {
id,
team_id,
source,        // telegram | email | github | ...
type,          // message | file | issue | event | calendar_update ...
payload,       // JSON
ts
}

Цей формат потім обробляється:

• Messenger Agent,
• Projects Agent,
• Followups Agent,
• Attention Agent,
• Memory Agent.

---

5. Основні сценарії

5.1. Telegram → microDAO

• повідомлення з каналу/групи → вхідний event,
• Bridges Agent передає їх Messenger Agent'у,
• агент може відповідати назад у Telegram (якщо дозволено).

5.2. microDAO → Email

• агент може відправити email через Email Connector:

  "Сформуй лист-запит у партнерську організацію."

5.3. GitHub → Projects Agent

• issue → створення задачі,
• PR → оновлення статусів,
• label changes → пріоритизація.

5.4. Calendar → Followups Agent

• події календаря → нагадування,
• синхронізація дедлайнів.

5.5. Cross-microDAO

• передача фактів між двома DAO:

  "Поділись цим визначенням з іншим microDAO".

• спільна робота агента у двох DAO.

---

6. Інтеграція з Runtime Core (12)

Основний агент:

const bridgesAgentConfig: AgentConfig = {
  id: "ag_bridges_core",
  teamId: "...",
  name: "Bridges Agent",
  role: "bridges_core",
  systemPrompt: systemBridgesPrompt,
  memoryScope: "team",
  tools: [
    "sync_event",
    "push_notification",
    "pull_updates",
    "register_integration",
    "update_integration",
    "disable_integration"
  ]
};

Адаптери — це окремі агенти з вузькими tools.

---

7. Tools (для Runtime Core)

7.1. register_integration

Реєструє інтеграцію (тип, ключі доступу, конфіг).

7.2. update_integration

Оновлює конфіг інтеграції.

7.3. disable_integration

Вимикає інтеграцію.

7.4. sync_event

Приймає подію від зовнішнього джерела і конвертує у внутрішню подію.

7.5. push_notification

Відправляє повідомлення у зовнішній світ (Telegram, Email тощо).

7.6. pull_updates

Регулярно опитує зовнішній сервіс (GitHub, Calendar).

---

8. UI

8.1. Sidebar → Інтеграції

• список інтеграцій,
• кнопка "Підключити інтеграцію".

8.2. Модалка підключення інтеграції

• вибір сервісу: Telegram / Email / Calendar / GitHub / Custom API,
• ввод даних підключення,
• тестування підключення,
• збереження.

8.3. Профіль інтеграції

• історія подій,
• статус,
• налаштування,
• кнопка "Вимкнути".

8.4. Cross-microDAO панель

• список підключених DAO,
• права та контексти,
• статуси синхронізації.

---

9. API

Інтеграції

GET /integrations?team_id POST /integrations PATCH /integrations/:id DELETE /integrations/:id

Події

POST /integrations/events GET /events?team_id&type=external

Cross-DAO

POST /crossdao/share_fact POST /crossdao/share_document

---

10. Інструкції для Cursor

Implement the Integrations & Bridges Agent using:

- 20_integrations_bridges_agent.md
- 12_agent_runtime_core.md
- 13_agent_memory_system.md
- 14_messenger_agent_module.md
- 15_projects_agent_module.md
- 16_followups_reminders_agent.md
- 17_comemory_knowledge_space.md
- 18_governance_access_agent.md
- 10_agent_ui_system.md
- 05_coding_standards.md

Tasks:

1) Create backend models for integrations and external events.

2) Implement API for listing, creating, updating, disabling integrations.

3) Register Bridges Agent and connector agents.

4) Implement adapters:

   - Telegram (stub)

   - Email (stub)

   - Calendar (stub)

   - GitHub (stub)

5) Create UI:

   - Integrations list in sidebar

   - Integration setup modal

   - Integration profile page

6) Implement event syncing logic (sync_event tool → Messenger/Projects/Followups/Attention Agents)

Output:

- list of modified files
- diff
- summary

---

11. Результат

Після впровадження:

• microDAO стає мережевим вузлом,
• агенти можуть діяти в кількох просторах,
• знання й події можуть перетікати між DAO,
• зовнішні інструменти інтегруються легко та безпечно,
• DAARION.city отримує основу для єдиного агентського всесвіту.