Архитектура

AdaOS построен как local-first runtime с многослойной Python-кодовой базой и небольшим управляющим surface:

• CLI поднимает и использует общий AgentContext
• FastAPI-сервер открывает тот же runtime по HTTP
• сервисы управляют навыками, сценариями, состоянием узла и Yjs webspace
• адаптеры изолируют файловую систему, базу данных, git, аудио, секреты и внешние интеграции

Основные строительные блоки

• src/adaos/apps: CLI, API, launcher и process entry points
• src/adaos/services: orchestration и runtime-логика
• src/adaos/sdk: публичные helper-модули для навыков и сценариев
• src/adaos/adapters: реализации IO
• src/adaos/ports: контракты для инфраструктурных зависимостей
• src/adaos/domain: базовые типы и доменные helper'ы

Модель runtime

В текущей реализации:

• узел работает как hub или member
• локальный API публикует маршруты для node, skill, scenario, observe, subnet, join и services
• service-type skills управляются через supervisor и health-aware API
• Yjs-backed webspace дают синхронизированное состояние сценариев и desktop
• autostart и core-update встроены в lifecycle runtime