Strata

Переносимая память агента. Записи только с добавлением, проверенное происхождение, инструменты MCP и самостоятельный хостинг.

Strata даёт команде одну долговечную память, которую любой агент может читать и обновлять, не смешивая проекты, не допуская утечки секретов и не переписывая историю. Она создана для работы, которая перемещается между людьми, сессиями, машинами и средами выполнения.

Зачем она существует

Локальная память агента ломается, когда работа перемещается между машинами, людьми, инструментами или старыми сессиями. Strata хранит факты, которые должны пережить один запуск агента:

• результаты экспериментов и решения;

• заметки о наборах данных, контрольные суммы источников и статус извлечения;

• процедуры, которые сработали, и ошибки, которых следует избегать;

• передача проектов агентам, подключающимся позже.

Strata не хранит секреты, сырые транскрипты, цепочки рассуждений, ключи API или настройки провайдеров.

Related MCP server: memhippo

Что входит в состав

Быстрый старт

git clone https://github.com/rx6ru/strata.git
cd strata
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
strata --help

Запустите локальный шлюз:

strata serve --root /tmp/strata-demo --host 127.0.0.1 --port 8787

Проверьте его из другого терминала:

curl -fsS http://127.0.0.1:8787/healthz
curl -fsS -H 'X-Strata-Client: 1' http://127.0.0.1:8787/v1/status

Если вы работаете из исходного кода до установки пакета:

PYTHONPATH=. python -m strata --help
PYTHONPATH=. python -m strata root-hash --root /tmp/strata-demo

Полное руководство по настройке — в docs/getting-started.md.

Как агенты его используют

1. Скопируйте skills/strata/ в каталог навыков среды выполнения агента.

2. Передайте агенту только несекретные значения среды выполнения, такие как URL шлюза, пространство имён, текущая задача, SSH-алиас и необязательный путь к обёртке жизненного цикла.

3. Агент получает политику, готовит ограниченный контекст, читает канонические записи и записывает только проверенные долговечные знания.

4. Исправления добавляют замещающие записи. Реорганизация добавляет события перемещения, разделения, слияния или инвалидации. Обычные агенты никогда не редактируют историю на месте.

Навык не содержит жёстко заданных имен хостов, IP-адресов, идентификаторов EC2-инстансов, имён пользователей, ключей API, пространств имён проектов, хешей политик, корней или идентификаторов записей. См. docs/agent-skill.md.

Как записи остаются чистыми

Strata проверяет каждую запись перед фиксацией:

• текущий хеш политики подтверждается перед фиксацией;

• схемы проверяют запись;

• ключи идемпотентности предотвращают повторные попытки;

• триггеры SQLite только с добавлением блокируют редактирование истории на месте;

• хеши содержимого и корневые манифесты делают экспорт проверяемым;

• сканеры секретов и сырых транскриптов отклоняют небезопасные полезные нагрузки;

• производное припоминание помечается как навигация, а не истина.

Самостоятельный хостинг

Для стека Docker:

./scripts/configure.sh
./scripts/control.sh start

Для системного сервиса используйте руководство по установке и ограниченную обёртку жизненного цикла в deploy/. Удалённые агенты должны вызывать только эту обёртку для status, start, stop или restart.

Развёртывание по умолчанию не имеет пользователей уровня приложения. Держите его на loopback, в частной сети, SSH, VPN, за брандмауэром или собственным прокси/слоем аутентификации. Прочтите docs/security-model.md и SECURITY.md перед командным хостингом.

REST и MCP

REST-шлюз предоставляет конечные точки health, policy, status, search, recall, record, append, supersede, relocate, split, merge и invalidate по пути /v1.

Мост MCP предоставляет соответствующие инструменты, такие как memory_policy, memory_prepare_context, memory_search, memory_get, memory_capture_verified и memory_status.

Оценка

PYTHONPATH=. python -m strata eval --input tests/fixtures/strata_eval/cases.json

Фикстура проверяет изоляцию пространств имён, происхождение, поведение продвижения и отклонения, метки производного припоминания и утечку запрещённых значений.

Лицензия

MIT. См. LICENSE. Примечания о сторонних компонентах — в THIRD_PARTY_NOTICES.md.