┌─────────────────────────────────────────────────────────────────┐
│                      Agent Application                          │
│  (LangChain / AutoGen / CrewAI / Custom Agent)                 │
└───────────────────────┬─────────────────────────────────────────┘
                        │ tool_call(request)
                        ▼
┌─────────────────────────────────────────────────────────────────┐
│                     AegisAgent Gateway                           │
│  ┌─────────────┐  ┌──────────────┐  ┌───────────────────────┐  │
│  │  Provenance │  │   Policy     │  │   Detection Engine    │  │
│  │  Attestation│→ │   Engine     │→ │   (Signatures + ML)   │  │
│  └─────────────┘  └──────┬───────┘  └───────────┬───────────┘  │
│                          │                       │              │
│  ┌─────────────┐  ┌──────▼───────┐  ┌───────────▼───────────┐  │
│  │  Sandbox    │  │   HITL       │  │   Audit & Logging     │  │
│  │  Isolator   │  │   Approval   │  │   (Tamper-Evident)    │  │
│  └─────────────┘  └──────────────┘  └───────────────────────┘  │
└───────────────────────┬─────────────────────────────────────────┘
                        │ verified_tool_call
                        ▼
┌─────────────────────────────────────────────────────────────────┐
│              MCP Servers / Tool Executors                        │
│  (authenticated, audited, sandboxed)                            │
└─────────────────────────────────────────────────────────────────┘

# базовая установка (без зависимостей, только стандартная библиотека)
pip install aegisagent

# полная установка (включая server, storage, crypto, providers)
pip install aegisagent[all]

# установка для разработки
pip install aegisagent[all,dev]

# сгенерировать конфигурацию по умолчанию
aegis init

# запустить службу шлюза
aegis serve --host 0.0.0.0 --port 8901

# проверить состояние здоровья
curl http://localhost:8901/health

from aegis import AegisClient

client = AegisClient(policy="default")
result = client.evaluate_and_execute(
    tool="shell.exec",
    args={"command": "ls -la"},
    provenance={"model": "gpt-4", "trace_id": "abc-123"}
)
print(result.status)  # "allowed" | "denied" | "needs_approval"

aegis init                    # инициализация каталога конфигурации
aegis serve [--port 8901]     # запуск службы шлюза
aegis policy validate         # проверка синтаксиса файла политик
aegis policy simulate         # симуляция политик (what-if)
aegis detect scan             # сканирование текущих правил обнаружения
aegis sandbox exec <cmd>      # выполнение команды в песочнице
aegis audit export            # экспорт журналов аудита
aegis redteam run <suite>     # запуск набора тестов red team
aegis version                 # отображение информации о версии

docker build -t aegisagent:latest .
docker run -p 8901:8901 -p 8902:8902 aegisagent:latest

docker compose up -d

kubectl apply -f deploy/k8s/

aegisagent/
├── aegis/                  # основная библиотека времени выполнения
│   ├── attestation/        # модуль подтверждения происхождения
│   ├── policy/             # механизм политик
│   ├── detect/             # уровень обнаружения
│   ├── sandbox/            # изоляция песочницы
│   ├── approval/           # ручное утверждение
│   ├── mcp/                # безопасный прокси для MCP
│   ├── gateway/            # LLM-шлюз
│   ├── audit/              # журналы аудита
│   ├── redteam/            # тесты red team
│   └── cli/                # инструменты командной строки
├── docs/                   # документация
├── examples/               # примеры кода
├── tests/                  # тесты
├── deploy/                 # конфигурации развертывания
├── pyproject.toml
├── Dockerfile
├── docker-compose.yaml
└── Makefile