Mastra
Mastra — TypeScript-фреймворк для AI-приложений и агентов на современном стеке.
Что это
Mastra — TypeScript-фреймворк для AI-приложений и агентов на современном стеке.
Возможности
- Model routing: 40+ провайдеров через единый интерфейс
- Agents: автономные агенты на LLM и tools
- Workflows: явный контроль порядка выполнения
- Human-in-the-loop: пауза для утверждения
- Управление контекстом, включая историю диалога
- Интеграция в React, Next.js, Node.js или standalone
Установка
Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.
Что нового в версиях
Mastra 1.84: Storage v2 для агентов, авто-восстановление воркфлоу, API для Knowledge и новые клиенты платформы.
- НовоеStorage Version 2 для агентов и evented-воркфлоу: уменьшение размера записей и ускорение работы за счет хранения дельт.
- НовоеАвтоматическое восстановление упавших воркфлоу через цикл в startWorkers() с учетом брокера сообщений для предотвращения дублирования.
- НовоеНовые API для Knowledge: movePage() для перемещения страниц без потери ID и reembed() для переэмбеддинга контента батчами.
- НовоеПакет @mastra/platform: клиенты для Platform Memory, Knowledge и Browser Sessions для работы с управляемыми ресурсами.
- НовоеMCP-приложения для наблюдаемости: встроенный MCP-сервер теперь рендерит интерактивные Studio-вью (Trace Viewer) в клиентах.
- Ломает совместимостьИзменено сопоставление scope в Knowledge: параметр $param теперь совпадает точно, двоеточие требует кодирования через encodeKnowledgeScopeId.
Mastra 1.83.0: возобновляемые стримы агентов, встроенный MCP-сервер с OAuth, хранилище Workflow v2 и новые расписания.
- НовоеВсе агенты теперь поддерживают возобновляемые стримы с кэшированием реплея, наблюдением и возможностью отмены через observe/abort.
- НовоеВ @mastra/server добавлен встроенный MCP-сервер на /api/mcp с поддержкой OAuth-дискавери и проверкой audience.
- НовоеЭкспериментальное хранилище Workflow Storage Version 2 (дельта-записи) теперь доступно для Postgres и libSQL.
- НовоеМаршруты чата AI SDK поддерживают возобновление (resumable), а расписания — однократное и ограниченное по времени выполнение.
- Ломает совместимостьОпция durable у Agent теперь управляет только стримами; для долговечного выполнения нужно использовать createDurableAgent.
Knowledge v2 с деревом страниц, устойчивые агенты, фоновые задачи с MCP и улучшения наблюдаемости.
- НовоеKnowledge v2: модель дерева страниц, серверная синхронизация и новые инструменты чтения.
- НовоеУстойчивость агентов при перезапуске API через fencing и общее хранилище.
- НовоеФоновые задачи: возобновление приостановленных вызовов инструментов и интеграция с MCP.
- НовоеЧтение-только API для Knowledge Explorer и SSE-поток событий в Mastra Server.
- НовоеМетрики задержки стриминга и расширенные фильтры трассировок по requestId и experimentId.
- Ломает совместимостьУдалены reindex(), экспериментальные memory-опции и API claimKey в factory.
Релиз Mastra 1.81.0: добавлены MCP-задачи с сохранением состояния, улучшена наблюдаемость, обновлены дашборды и работа с файлами.
- НовоеПоявились экспериментальные MCP-задачи с хранением в хранилище, обеспечивающие перезапускаемость и отслеживание долгих процессов.
- НовоеФоновые задачи теперь поддерживают не-агентные владельцы с настройками очередей, параллелизма и сроков хранения.
- НовоеНаблюдаемость расширена: добавлены метрики TTFT, причины остановки моделей и детализация по провайдерам для анализа затрат.
- НовоеКанальные агенты теперь могут скачивать и сохранять аутентифицированные бинарные вложения в рабочее пространство.
- Ломает совместимостьВ @mastra/playground-ui удалены старые компоненты графиков, утилиты наведения и API для старых типов досок.
Персональные подключения пользователей, агрегация спанов, классификация ошибок и запуск экспериментов с произвольной моделью.
- НовоеВ @mastra/connect добавлены пользовательские OAuth-подключения и встроенный инструмент запроса соединения для UI.
- НовоеПоявился API агрегации спанов (ClickHouse/Postgres/DuckDB) для быстрой оценки метрик и стоимости.
- НовоеВ @mastra/core/error внедрена классификация ошибок провайдеров для улучшения UX и логики повторов.
- НовоеВ dataset.startExperiment() добавлен параметр agentModel для тестов агента без изменения его версии.
- Ломает совместимостьqueryTraceThreads() больше не возвращает model/provider, а лимит page.limit ограничен 100 записями.
Магистральные события MCP, агрегация спанов, сессии агентов по ID и нативная файловая система в песочницах.
- Ломает совместимостьСессии контроллера агентов теперь идентифицируются по sessionId, что позволяет создавать несколько сессий на один resourceId.
- НовоеДобавлены экспериментальные события MCP (SEP-3415) с поддержкой стриминга, опроса и вебхуков, а также API инспекции в Studio.
- НовоеВведена новая контрактная функция aggregateSpans() для аналитики по спанам и улучшены возможности запросов трасс и спанов.
- НовоеПесочницы WorkspaceSandbox получили нативный файловый API для ускорения операций чтения и записи без вызова оболочки.
- НовоеВ @mastra/connect добавлено ограничение интеграций на уровне конечных пользователей и поддержка канала Microsoft Teams.
В Mastra 1.78.0 добавлены агенты с областями видимости, агрегация трасс, очереди сигналов и улучшена надежность рабочих процессов.
- НовоеАгенты теперь поддерживают scopes для многопользовательской идентификации и маршрутизации памяти.
- НовоеПоявилась полная трассировка агрегации: серверный API, клиентский метод и React-хук.
- НовоеДобавлен queueSignal для постановки типизированных сигналов в очередь без деградации в обычное сообщение.
- НовоеСписки трасс и спанов теперь возвращают превью ввода/вывода/ошибок, что ускоряет запросы.
- ИсправленоУлучшена надежность длительных рабочих процессов: исправлены ошибки в foreach и корректное сохранение suspendData.
- Ломает совместимостьУдалены режимы Plan/Explore у фабричных сессий и изменено поведение фолбэка учетных данных.
Релиз Mastra 1.77.0: новые провайдеры песочниц, улучшенная безопасность агентов, наблюдательная память и исправления.
- НовоеПоявился контракт FactorySandbox и новые провайдеры для Docker, E2B и Mastra Platform, поддерживающие предварительную сборку окружений.
- НовоеДобавлена поддержка файловых вложений для методов steer и followUp в AgentController.
- НовоеРеализовано run fencing для множества бэкендов хранения, предотвращающее перезапись состояния при восстановлении после сбоев.
- НовоеУлучшена Observational Memory: добавлена защита от конфликтов генераций и новые API для фиксации наблюдений.
- НовоеSpans получили поддержку ссылок (links) и W3C traceparent, а MCP-клиенты теперь двунаправленно связываются с серверными спанами.
- Ломает совместимостьHTTP-маршруты workflow в @mastra/server больше не позволяют запускать внутренние воркфлоу, возвращая ошибку 404.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.