daarion-admin/microdao-daarion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fb4f4a16d58d2096ce8b0b0f4bf2ddcce6e2130b
microdao-daarion/site/tasks/TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1/index.html
Apple fb4f4a16d5 🔧 Fix GitHub Actions docs workflow 
- Update mkdocs dependencies to latest versions
- Add permissions for GitHub Pages deployment
- Add workflow_dispatch for manual trigger
- Fix build command with fallback
2026-01-10 07:57:36 -08:00

1048 lines
31 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="canonical" href="https://IvanTytar.github.io/microdao-daarion/tasks/TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1/">
<link rel="icon" href="../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.18">
<title>TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1 - DAARION Documentation</title>
<link rel="stylesheet" href="../../assets/stylesheets/main.66ac8b77.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#task_phase_matrix_gateway_integration_v1" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header md-header--shadow" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../.." title="DAARION Documentation" class="md-header__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
DAARION Documentation
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1
</span>
</div>
</div>
</div>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../.." title="DAARION Documentation" class="md-nav__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
</a>
DAARION Documentation
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../public/" class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/getting-started/" class="md-nav__link">
<span class="md-ellipsis">
Getting Started
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/architecture-overview/" class="md-nav__link">
<span class="md-ellipsis">
Architecture
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../public/daiS_daos_overview/" class="md-nav__link">
<span class="md-ellipsis">
DAIS & DAOS
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
<span class="md-ellipsis">
Internal
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Internal
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
<label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
<span class="md-ellipsis">
Infra
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5_1">
<span class="md-nav__icon md-icon"></span>
Infra
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../internal/infra/INFRA_AUTOMATION_PACK_V1/" class="md-nav__link">
<span class="md-ellipsis">
Infra Automation Pack v1
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/infra/monitoring_overview/" class="md-nav__link">
<span class="md-ellipsis">
Monitoring Overview
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/infra/nodes_registry_v0/" class="md-nav__link">
<span class="md-ellipsis">
Nodes Registry v0
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
<label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
<span class="md-ellipsis">
Specs
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5_2">
<span class="md-nav__icon md-icon"></span>
Specs
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../internal/specs/matrix_presence_aggregator/" class="md-nav__link">
<span class="md-ellipsis">
Matrix Presence Aggregator
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/specs/city_map_spec/" class="md-nav__link">
<span class="md-ellipsis">
City Map Spec
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../internal/specs/node_join_protocol_draft/" class="md-nav__link">
<span class="md-ellipsis">
Node Join Protocol (Draft)
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#1" class="md-nav__link">
<span class="md-ellipsis">
1. МЕТА
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#2-scope" class="md-nav__link">
<span class="md-ellipsis">
2. ОБСЯГ РОБОТ (SCOPE)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#3" class="md-nav__link">
<span class="md-ellipsis">
3. ВИМОГИ ТА ІНВАРІАНТИ
</span>
</a>
<nav class="md-nav" aria-label="3. ВИМОГИ ТА ІНВАРІАНТИ">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#31-rooms" class="md-nav__link">
<span class="md-ellipsis">
3.1. Для кожної кімнати в rooms:
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#32" class="md-nav__link">
<span class="md-ellipsis">
3.2. Для кожного публічного агента:
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#33" class="md-nav__link">
<span class="md-ellipsis">
3.3. Для кожної ноди:
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#4-1-matrix-gateway" class="md-nav__link">
<span class="md-ellipsis">
4. МОДУЛЬ 1 — MATRIX-GATEWAY
</span>
</a>
<nav class="md-nav" aria-label="4. МОДУЛЬ 1 — MATRIX-GATEWAY">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#41-endpoints-internal" class="md-nav__link">
<span class="md-ellipsis">
4.1. Нові endpoints (internal)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#42" class="md-nav__link">
<span class="md-ellipsis">
4.2. Конфігурація
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#5-2-city-service-room-sync" class="md-nav__link">
<span class="md-ellipsis">
5. МОДУЛЬ 2 — CITY-SERVICE (ROOM SYNC)
</span>
</a>
<nav class="md-nav" aria-label="5. МОДУЛЬ 2 — CITY-SERVICE (ROOM SYNC)">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#51-repository-" class="md-nav__link">
<span class="md-ellipsis">
5.1. Repository-логіку
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#52-" class="md-nav__link">
<span class="md-ellipsis">
5.2. Сервіс-логіку синхронізації
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#6-3-agent-chat-flow" class="md-nav__link">
<span class="md-ellipsis">
6. МОДУЛЬ 3 — AGENT CHAT FLOW
</span>
</a>
<nav class="md-nav" aria-label="6. МОДУЛЬ 3 — AGENT CHAT FLOW">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#61-backend-api" class="md-nav__link">
<span class="md-ellipsis">
6.1. Backend API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#62-frontend-appsweb" class="md-nav__link">
<span class="md-ellipsis">
6.2. Frontend (apps/web)
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#7-4-node-microdao-chat-flow" class="md-nav__link">
<span class="md-ellipsis">
7. МОДУЛЬ 4 — NODE / MICRODAO CHAT FLOW
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#8-message-flow-nats" class="md-nav__link">
<span class="md-ellipsis">
8. MESSAGE FLOW &amp; NATS (опціонально)
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#9-tests-smoke-checklist" class="md-nav__link">
<span class="md-ellipsis">
9. TESTS / SMOKE CHECKLIST
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#10-prompt-cursor" class="md-nav__link">
<span class="md-ellipsis">
10. PROMPT ДЛЯ CURSOR
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="task_phase_matrix_gateway_integration_v1">TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1<a class="headerlink" href="#task_phase_matrix_gateway_integration_v1" title="Permanent link">&para;</a></h1>
<p>Version: 1.0
Status: Ready
Priority: Critical (Rooms &amp; Chat Layer)</p>
<hr />
<h2 id="1">1. МЕТА<a class="headerlink" href="#1" title="Permanent link">&para;</a></h2>
<p>Повністю інтегрувати Matrix у DAARION.city так, щоб:</p>
<ul>
<li>усі кімнати (City / MicroDAO / Node / Agent) мали <code>matrix_room_id</code>;</li>
<li>gateway умів створювати кімнати та додавати агентів;</li>
<li>чат-виджети на /agents /nodes /microdao працювали з реальними повідомленнями;</li>
<li>з'явилися online-статуси та події для Agent Presence.</li>
</ul>
<p>Цей таск спирається на вже виконаний:
- <code>TASK_PHASE_ROOMS_LAYER_RESTORE_AND_MATRIX_INTEGRATION.md</code>
(rooms seeded у БД, citizens працюють, але Matrix ще не прив'язаний).</p>
<hr />
<h2 id="2-scope">2. ОБСЯГ РОБОТ (SCOPE)<a class="headerlink" href="#2-scope" title="Permanent link">&para;</a></h2>
<ol>
<li><strong>Matrix Room Creation API</strong> у <code>matrix-gateway</code></li>
<li><strong>Room ↔ Matrix синхронізація</strong> у <code>city-service</code></li>
<li><strong>Agent / Node / MicroDAO join-логіка</strong> через gateway</li>
<li><strong>Message flow</strong>: frontend → city-service → gateway → Matrix → back</li>
<li><strong>Статуси чату</strong>: <code>chat_available</code>, online/offline</li>
<li><strong>Мінімальні тести + smoke-перевірки</strong></li>
</ol>
<hr />
<h2 id="3">3. ВИМОГИ ТА ІНВАРІАНТИ<a class="headerlink" href="#3" title="Permanent link">&para;</a></h2>
<h3 id="31-rooms">3.1. Для кожної кімнати в <code>rooms</code>:<a class="headerlink" href="#31-rooms" title="Permanent link">&para;</a></h3>
<ul>
<li><code>rooms.id</code> існує</li>
<li><code>rooms.matrix_room_id</code> НЕ NULL</li>
<li>запис у <code>matrix_rooms</code> з посиланням на Matrix room</li>
</ul>
<h3 id="32">3.2. Для кожного публічного агента:<a class="headerlink" href="#32" title="Permanent link">&para;</a></h3>
<ul>
<li>є хоча б одна кімната, де агент учасник (через <code>room_agents</code> або аналог)</li>
<li>чат-виджет показує <code>chat_available = true</code> (якщо Matrix OK)</li>
</ul>
<h3 id="33">3.3. Для кожної ноди:<a class="headerlink" href="#33" title="Permanent link">&para;</a></h3>
<ul>
<li>є support room <code>node-{slug}-support</code></li>
<li>у ній учасники: guardian + steward + технічні агенти</li>
</ul>
<hr />
<h2 id="4-1-matrix-gateway">4. МОДУЛЬ 1 — MATRIX-GATEWAY<a class="headerlink" href="#4-1-matrix-gateway" title="Permanent link">&para;</a></h2>
<h3 id="41-endpoints-internal">4.1. Нові endpoints (internal)<a class="headerlink" href="#41-endpoints-internal" title="Permanent link">&para;</a></h3>
<p>У сервісі <code>matrix-gateway</code> (Python/FastAPI або Node, залежно від репо):</p>
<ol>
<li><code>POST /internal/matrix/room/create</code></li>
</ol>
<p>Вхід:
<code>json
{
"room_alias": "string", // наприклад "city-general"
"room_name": "string", // "General"
"visibility": "public|private",
"topic": "string|null"
}</code></p>
<p>Вихід:
<code>json
{
"room_id": "!abcdefg:matrix.daarion.city",
"room_alias": "#city-general:matrix.daarion.city"
}</code></p>
<p>Дії:
- викликає Matrix API <code>/_matrix/client/v3/createRoom</code>
- задає canonical alias, name, topic
- повертає <code>room_id</code> для збереження в БД</p>
<ol>
<li><code>POST /internal/matrix/room/join</code></li>
</ol>
<p>Вхід:
<code>json
{
"room_id": "!room:matrix.daarion.city",
"user_id": "@agent_daarwizz:matrix.daarion.city"
}</code></p>
<p>Дії:
- викликає Matrix API <code>join</code> для <code>user_id</code>
- обробляє помилки (already joined / banned / unknown)</p>
<ol>
<li><code>POST /internal/matrix/message/send</code></li>
</ol>
<p>Вхід:
<code>json
{
"room_id": "!room:matrix.daarion.city",
"sender": "@agent_x:matrix.daarion.city",
"body": "string"
}</code></p>
<p>Дії:
- відправляє текстове повідомлення від імені бота/агента
- повертає event_id</p>
<h3 id="42">4.2. Конфігурація<a class="headerlink" href="#42" title="Permanent link">&para;</a></h3>
<ul>
<li>додати ENV:</li>
<li><code>MATRIX_HOMESERVER_URL</code></li>
<li><code>MATRIX_ACCESS_TOKEN</code> (service/bot user)</li>
<li>
<p><code>MATRIX_DEFAULT_SENDER</code> (наприклад, <code>@daarion-bot:matrix.daarion.city</code>)</p>
</li>
<li>
<p>healthcheck:</p>
</li>
<li><code>GET /health</code> → перевірка <code>/versions</code> на Matrix HS</li>
</ul>
<hr />
<h2 id="5-2-city-service-room-sync">5. МОДУЛЬ 2 — CITY-SERVICE (ROOM SYNC)<a class="headerlink" href="#5-2-city-service-room-sync" title="Permanent link">&para;</a></h2>
<p>У <code>services/city-service</code> додати:</p>
<h3 id="51-repository-">5.1. Repository-логіку<a class="headerlink" href="#51-repository-" title="Permanent link">&para;</a></h3>
<ul>
<li>новий модуль, наприклад <code>repo_rooms_matrix.py</code>:</li>
<li><code>get_rooms_without_matrix_id()</code></li>
<li><code>update_room_matrix_id(room_id, matrix_room_id)</code></li>
<li><code>get_agent_matrix_user(agent_id)</code></li>
<li><code>get_node_guardian_and_steward(node_id)</code></li>
</ul>
<h3 id="52-">5.2. Сервіс-логіку синхронізації<a class="headerlink" href="#52-" title="Permanent link">&para;</a></h3>
<ol>
<li><code>POST /api/v1/rooms/sync/matrix</code></li>
</ol>
<p>Задача:
- знайти всі кімнати, де <code>matrix_room_id IS NULL</code>
- викликати <code>matrix-gateway /room/create</code>
- зберегти <code>matrix_room_id</code>
- (для city/microdao rooms) додати публічних агентів як учасників:
- City: DARIO, DARIA, Atlas, Greeter
- MicroDAO: orchestrator + core team
- Node: guardian + steward
- Agent: сам агент</p>
<ol>
<li>Авто-виклик:</li>
<li>опційно: при створенні нової кімнати (event-based)</li>
<li>але для MVP достатньо ручного endpoint + одноразового запуску</li>
</ol>
<hr />
<h2 id="6-3-agent-chat-flow">6. МОДУЛЬ 3 — AGENT CHAT FLOW<a class="headerlink" href="#6-3-agent-chat-flow" title="Permanent link">&para;</a></h2>
<h3 id="61-backend-api">6.1. Backend API<a class="headerlink" href="#61-backend-api" title="Permanent link">&para;</a></h3>
<p>У <code>city-service</code>:</p>
<ul>
<li><code>GET /api/v1/agents/{agent_id}/chat-room</code></li>
</ul>
<p>Доповнити:
- якщо <code>matrix_room_id IS NULL</code> → створити кімнату через gateway
- повернути:
<code>json
{
"room_id": "&lt;uuid&gt;",
"matrix_room_id": "!room:matrix...",
"agent_id": "&lt;uuid&gt;",
"chat_available": true|false
}</code></p>
<ul>
<li>опційно: <code>POST /api/v1/agents/{agent_id}/message</code>
(для проксінгу повідомлень з frontend до gateway)</li>
</ul>
<h3 id="62-frontend-appsweb">6.2. Frontend (apps/web)<a class="headerlink" href="#62-frontend-appsweb" title="Permanent link">&para;</a></h3>
<p>Компонент <code>AgentChatWidget</code>:</p>
<ul>
<li>якщо <code>chat_available === false</code> → показувати "тимчасово недоступний"</li>
<li>якщо <code>chat_available === true</code>:</li>
<li>використовувати Matrix JS SDK АБО власний lightweight client:<ul>
<li><code>GET /api/v1/agents/{id}/chat-room</code></li>
<li><code>WS</code> або <code>long-poll</code> на gateway</li>
<li><code>POST /internal/matrix/message/send</code> через city-service</li>
</ul>
</li>
</ul>
<p>Для MVP можна обмежитись:
- односторонній відправлення повідомлень (log history локально)
- завантаження останніх N повідомлень із Matrix через gateway</p>
<hr />
<h2 id="7-4-node-microdao-chat-flow">7. МОДУЛЬ 4 — NODE / MICRODAO CHAT FLOW<a class="headerlink" href="#7-4-node-microdao-chat-flow" title="Permanent link">&para;</a></h2>
<p>Аналогічно до агента:</p>
<ul>
<li><code>GET /api/v1/nodes/{node_id}/chat-room</code></li>
<li><code>GET /api/v1/microdaos/{slug}/chat-room</code></li>
</ul>
<p>Логіка:
- якщо нема Matrix room → створити
- додати відповідних агентів:
- Node: guardian + steward
- MicroDAO: orchestrator + core team</p>
<p>Frontend вже має <code>AgentChatWidget</code>, достатньо змінити пропси:
- <code>entityType: "agent" | "node" | "microdao"</code>
- <code>entityId</code> / <code>slug</code></p>
<hr />
<h2 id="8-message-flow-nats">8. MESSAGE FLOW &amp; NATS (опціонально)<a class="headerlink" href="#8-message-flow-nats" title="Permanent link">&para;</a></h2>
<p>Якщо є час у межах таска:</p>
<ul>
<li><code>matrix-gateway</code> → NATS subject <code>integration.matrix.message</code></li>
<li><code>city-service</code> підписаний і логує <code>event_outbox</code></li>
<li>Agents можуть реагувати на події.</li>
</ul>
<p>Якщо ні — відкласти у окремий таск.</p>
<hr />
<h2 id="9-tests-smoke-checklist">9. TESTS / SMOKE CHECKLIST<a class="headerlink" href="#9-tests-smoke-checklist" title="Permanent link">&para;</a></h2>
<p>Після завершення:</p>
<ol>
<li><code>POST /api/v1/rooms/sync/matrix</code> → всі <code>rooms.matrix_room_id</code> заповнені.</li>
<li><code>GET /city</code>:</li>
<li>список кімнат завантажується у режимі "Мапа" і "Список".</li>
<li><code>/agents/daarwizz</code>:</li>
<li>чат-виджет відкривається,</li>
<li>можна надіслати повідомлення,</li>
<li>у Matrix-клієнті видно це повідомлення.</li>
<li><code>/nodes/node-1-hetzner-gex44</code>:</li>
<li>чат з guardian/steward доступний.</li>
<li><code>/microdao/daarion</code>:</li>
<li>чат MicroDAO працює.</li>
</ol>
<hr />
<h2 id="10-prompt-cursor">10. PROMPT ДЛЯ CURSOR<a class="headerlink" href="#10-prompt-cursor" title="Permanent link">&para;</a></h2>
<div class="codehilite"><pre><span></span><code>Виконай TASK_PHASE_MATRIX_GATEWAY_INTEGRATION_v1.md.
Фокус:
1) matrix-gateway (internal API: room/create, room/join, message/send)
2) city-service (room sync, agent/node/microdao chat-room API)
3) apps/web (AgentChatWidget інтеграція з Matrix)
4) мінімальний smoke-тест, як описано в розділі 9.
Використовуй існуючі foundation-документи у docs/foundation/ як джерело істини.
Після кожного завершеного модуля роби окремий git commit.
Не змінюй інші підсистеми, які не стосуються Rooms/Matrix/Chat.
</code></pre></div>
<hr />
<p><strong>Target Date</strong>: Immediate
<strong>Priority</strong>: Critical
<strong>Dependencies</strong>: Rooms Layer seeded, Matrix Synapse running</p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.instant", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../assets/javascripts/bundle.3220b9d7.min.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink