diff --git a/docs/AGENT_HUB_SPEC.md b/docs/AGENT_HUB_SPEC.md index 629369f0..ae1377ab 100644 --- a/docs/AGENT_HUB_SPEC.md +++ b/docs/AGENT_HUB_SPEC.md @@ -11,7 +11,7 @@ Agent Hub — це центральний UI для управління агентами DAARION. Надає візуальний інтерфейс для перегляду, моніторингу та налаштування агентів. -### Features: +### Features - ✅ Gallery view — перегляд усіх агентів в grid layout - ✅ Agent Cabinet — детальна сторінка агента з табами - ✅ Metrics Dashboard — статистика використання LLM/tools @@ -24,7 +24,7 @@ Agent Hub — це центральний UI для управління аге ## 🏗️ Architecture -``` +```text ┌─────────────────────────────────────────────────────────────┐ │ Agent Hub UI │ │ (React + TypeScript + Tailwind CSS) │ @@ -52,13 +52,13 @@ Agent Hub — це центральний UI для управління аге │orchestrator│ │ (metrics) │ │ (authz) │ │ :7008 │ │ :7013 │ │ :7012 │ └───────────┘ └───────────────┘ └──────────────┘ -``` +```text --- ## 📁 File Structure -``` +```text src/ ├── api/ │ └── agents.ts ✅ API client (11 functions) @@ -99,7 +99,7 @@ src/ - Refresh button **Layout:** -``` +```text ┌────────────────────────────────────────────────────┐ │ 🤖 Agent Hub [🔄 Оновити] │ │ Керуйте агентами вашого MicroDAO │ @@ -133,7 +133,7 @@ src/ - Click → navigate to `/agent/{id}` **Visual:** -``` +```text ┌────────────────────────────────┐ │ 🟢 Активний │ │ ┌──┐ │ @@ -166,7 +166,7 @@ src/ - Actions: [🔄 Оновити] [💬 Чат] **Layout:** -``` +```text ┌────────────────────────────────────────────────────┐ │ ← Назад до Agent Hub │ │ │ @@ -202,7 +202,7 @@ src/ - Time-series bar charts for tool calls **Visual:** -``` +```text ┌────────────────────────────────────────────────────┐ │ 📊 Метрики [24год][7днів][30днів] │ │ │ @@ -246,7 +246,7 @@ src/ - Updated at **Visual:** -``` +```text ┌────────────────────────────────────────────────────┐ │ ⚙️ Налаштування │ │ │ @@ -262,7 +262,7 @@ src/ │ ☐ Пошук в пам'яті (Memory) │ │ [Зберегти інструменти] │ └────────────────────────────────────────────────────┘ -``` +```text --- @@ -458,7 +458,7 @@ npm run dev ### 3. Navigate to Agent Hub -``` +```text http://localhost:3000/agent-hub ``` @@ -466,10 +466,10 @@ http://localhost:3000/agent-hub ## 🧪 Testing -### Manual Testing Flow: +### Manual Testing Flow 1. **Start services** (docker-compose.phase5.yml) -2. **Open frontend** (http://localhost:3000) +2. **Open frontend** ([http://localhost:3000](http://localhost:3000)) 3. **Navigate to `/agent-hub`** 4. **Verify gallery loads** (should show Sofia, Alex, Guardian) 5. **Click on an agent card** → should open `/agent/{id}` @@ -481,7 +481,7 @@ http://localhost:3000/agent-hub 8. **Test filter** (select "DAARION") 9. **Test refresh** button -### API Testing: +### API Testing ```bash # Health check @@ -504,7 +504,7 @@ curl http://localhost:7014/agents/agent:sofia/context ## 📊 Mock Data -### Current mock agents (from backend): +### Current mock agents (from backend) ```json [ @@ -565,18 +565,18 @@ curl http://localhost:7014/agents/agent:sofia/context ## 📝 Notes -### Known Limitations: +### Known Limitations 1. **Mock data only** — agents-service використовує hardcoded mock data (Phase 6 додасть database) 2. **No WebSocket** — статус оновлюється тільки при refetch (Phase 6.5 додасть live updates) 3. **Limited events** — events endpoint пустий (Phase 6 додасть event store) 4. **Basic context** — контекст не повністю інтегрований з memory-orchestrator (Phase 6 покращить) -### Performance: +### Performance - All API calls cached in React state - Lazy loading for metrics/context - Optimistic UI updates for settings -### Accessibility: +### Accessibility - Semantic HTML - Keyboard navigation - ARIA labels (planned) @@ -619,4 +619,3 @@ curl http://localhost:7014/agents/agent:sofia/context --- **END OF AGENT HUB SPEC** 🤖 - diff --git a/docs/MESSENGER_TESTING_GUIDE.md b/docs/MESSENGER_TESTING_GUIDE.md index 1ca92254..3616500f 100644 --- a/docs/MESSENGER_TESTING_GUIDE.md +++ b/docs/MESSENGER_TESTING_GUIDE.md @@ -42,7 +42,7 @@ npm run dev ### Scenario 1: Basic Messaging (DAARION UI) **Steps:** -1. Navigate to http://localhost:8899/messenger +1. Navigate to [http://localhost:8899/messenger](http://localhost:8899/messenger) 2. You should see the Messenger page with channel list 3. Select the "#general" channel 4. Type a message: "Hello DAARION!" @@ -71,11 +71,11 @@ npm run dev ### Scenario 3: Element Compatibility -**Prerequisite:** Install Element Desktop or use Element Web (https://app.element.io) +**Prerequisite:** Install Element Desktop or use Element Web ([https://app.element.io](https://app.element.io)) **Steps:** 1. Login to Element with Matrix credentials: - - Homeserver: http://localhost:8008 + - Homeserver: [http://localhost:8008](http://localhost:8008) - Username: @admin:daarion.city - Password: (use Matrix admin password) @@ -402,19 +402,3 @@ VALUES (gen_random_uuid(), '', 'agent:sofia', 'agent', '@sofia-agent **Version:** 1.0.0 **Last Updated:** 2025-11-24 **Maintainer:** DAARION Platform Team - - - - - - - - - - - - - - - - diff --git a/docs/standards/lint_scope.txt b/docs/standards/lint_scope.txt index 50db4b55..5d4bad75 100644 --- a/docs/standards/lint_scope.txt +++ b/docs/standards/lint_scope.txt @@ -37,6 +37,8 @@ docs/hardcode_vs_config.md docs/NODE2_DIAGNOSTIC_REPORT.md docs/FINAL_INTEGRATION_SUMMARY.md docs/AGENTS_TOOLS_AND_MONITORING_REPORT.md +docs/AGENT_HUB_SPEC.md +docs/MESSENGER_TESTING_GUIDE.md docs/consolidation/README.md docs/consolidation/SOURCES.md docs/runbooks/DOCS_SERVICES_AUTOMATION_RUNBOOK.md