WebKurierCore is the main entry point for all user interactions across the WebKurier ecosystem.
It provides the Web portal, agent selection interface, terminal environment, SecondSelf Council routing, and cross-domain orchestration between VehicleHub, PhoneCore, Chain, and Security.
Core is responsible for:
- User-facing UI (web)
- Terminal and command router
- SecondSelf Council reasoning engine
- Engineering & creative agent interfaces
- Administration panels
- Authentication and entitlement logic
- Linking user inputs to appropriate domain hubs
This repository is the central interaction layer between human users and machine intelligence.
Level 0 — WebKurierHybrid (orchestrator)
Level 1 — WebKurierCore (THIS REPOSITORY)
Level 2 — Domain Hubs:
• WebKurierVehicleHub
• WebKurierPhoneCore
• WebKurierChain
• WebKurierSecurity
Level 3 — Mobile Apps (iOS/Android)
Level 4 — Public Site
Level 5 — Future/X Labs
WebKurierCore acts as the global router:
User → Web / Bots / Mobile
→ WebKurierCore (Gateway)
→ Domain Hub (VehicleHub / PhoneCore / Chain / Security)
→ Core returns unified answer (text, voice, media)
⸻
2. Repository Structure (High-Level)
WebKurierCore/
├── index.html # Main agent portal (tiles)
├── admin/
│ ├── terminal.html # Admin terminal
│ └── logs.html # System logs viewer
├── engine/
│ ├── config/
│ │ ├── agents_map.json # Agent groups & routing map
│ │ ├── entitlements.json # Access tiers & roles
│ │ └── secrets.json # Local-only secrets (not in git)
│ ├── api/
│ │ ├── secondself_rest.py # REST endpoint: /secondself/query
│ │ └── secondself_ws.py # WS endpoint: /secondself/stream
│ ├── perception/
│ │ ├── stereo_input_adapter.js # Wearable stereo camera input
│ │ ├── mic_stream_adapter.js # Microphone input handler
│ │ └── translator_rt.js # Real-time subtitles/translation
│ ├── terminal/
│ │ ├── terminal_agent.js # Main terminal logic
│ │ └── commands_map.json # Command → agent routing
│ ├── agents/
│ │ ├── geodesy/ # Geodesy interface
│ │ ├── drone/ # Drone interface
│ │ ├── autopilot/ # Autopilot interface
│ │ ├── pilot/
│ │ ├── geoviz3d/
│ │ ├── pv-planner/
│ │ ├── geo-report/
│ │ ├── translator/
│ │ ├── voice/
│ │ ├── phone/
│ │ ├── lessons/
│ │ ├── wallet/
│ │ ├── accountant/
│ │ ├── tax-return/
│ │ ├── hr/
│ │ ├── marketing/
│ │ ├── romantic/
│ │ ├── engineer/
│ │ ├── programmer/
│ │ ├── designer/
│ │ ├── editor/
│ │ ├── tools/
│ │ ├── dream/
│ │ ├── security/
│ │ ├── legal/
│ │ ├── memory/
│ │ ├── admin-terminal/
│ │ ├── master/
│ │ ├── second-self/ # SecondSelf Council UI
│ │ └── cafe/ # Cafe/Menu/Booking
│ └── js/
│ └── agents-menu.js # Dynamic UI tile loader
└── docs/
└── *.html # Documentation pages
⸻
3. Core Responsibilities
3.1. User Interaction Layer
• Agent selection portal (index.html)
• i18n support (25+ languages)
• Mobile/Web adaptive layouts
• Secure session flow
3.2. Terminal Command Engine
• Unified CLI for all agents
• Owner-level commands (not stored in repo)
• Integration with VehicleHub mission commands, PhoneCore translation/voice, Chain ledger, Security scanner
3.3. SecondSelf Council
• High-level multi-agent reasoning
• Debate accelerators
• Consensus or specialist-mode routing
• Adjustable by entitlement tier
3.4. Engineering & Admin Agents
• Programmer, Engineer, Designer, Editor
• Tools panel (HTML/ZIP generators)
• Admin terminal
• MasterAgent (system-level control)
3.5. System Routing
WebKurierCore makes the decision:
Does the task belong to:
• VehicleHub (navigation, geodesy, PV, missions)?
• PhoneCore (translation, voice, chats, telephony)?
• Chain (ledgers, tokens, integrity)?
• Security (scan, validation)?
⸻
4. Cross-Repository Data Flow
Example: Drone Request
User → Core Terminal → VehicleHub/autopilot → Core → User
Example: Translation Request
User → Core Portal → PhoneCore/translator → Core → User
Example: Blockchain Transaction
Core → Chain → Core
Example: Security Scan
Core → SecurityAgent → Core
Core is the router, not the executor.
⸻
5. CI/CD Integration
• Core builds are initiated via Hybrid
• No secrets stored in this repository
• Local-only secrets in engine/config/secrets.json
• Frontend build optimized for Cloud Run & static hosting
• Code style and routing maps validated during CI
⸻
6. Agent Glossary (EN + RU translation only)
GeodesyAgent — Геодезист
DroneAgent — Агент дрона
AutopilotAgent — Автопилот
PilotAgent — Пилот
GeoViz3DAgent — Гео-визуализатор 3D
PVPlannerAgent — ПВ-планировщик
GeoReportAgent — Генератор геоотчётов
TranslatorAgent — Переводчик
VoiceAgent — Голосовой ассистент
PhoneAgent — Телефония
LessonsAgent — Уроки A1–C1
RomanticAgent — Романтический собеседник
HRAgent — HR-агент
MarketingAgent — Маркетолог
MemoryAgent — Память
DreamAgent — Генератор медиа
CafeAgent — Кафе/меню/бронь
WalletAgent — WebCoin-кошелёк
EngineerAgent — Инженер
ProgrammerAgent — Программист
DesignerAgent — Дизайнер
EditorAgent — Редактор
ToolsAgent — Панель инструментов
MasterAgent — Управляющий
AdminTerminalAgent — Админ-терминал
AccountantAgent — Бухгалтер
TaxReturnAgent — Налоговая декларация
LegalAgent — Юрист
SecurityAgent — Антивирус/антифишинг
CouncilAgent (SecondSelf) — Совет Второго Я
⸻
7. Security & Entitlements
• Access levels defined in entitlements.json
• Sensitive actions require elevated role
• SecondSelf Council behavior changes per tier (Free → Premium)
⸻
8. Contact & Governance
WebKurierCore is maintained by
Vladyslav Hushchyn (VladoExport)
Germany, EU.
⸻