Mastra

Mastra — TypeScript-фреймворк для AI-приложений и агентов на современном стеке.

MAMastra Фреймворк агентов ★ 29.6k

Что это

Mastra — TypeScript-фреймворк для AI-приложений и агентов на современном стеке.

Возможности

  • Model routing: 40+ провайдеров через единый интерфейс
  • Agents: автономные агенты на LLM и tools
  • Workflows: явный контроль порядка выполнения
  • Human-in-the-loop: пауза для утверждения
  • Управление контекстом, включая историю диалога
  • Интеграция в React, Next.js, Node.js или standalone

Установка

1Установить пакет
npx bgproc start -n <project-name> -w -- npm run dev
2Быстрый старт
npm create mastra@latest cd <project-name> npm run dev

Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.

Что нового в версиях

@mastra/core@1.84.018 ноября 2026 г.Ломает совместимость

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/core@1.83.013 ноября 2026 г.Ломает совместимость

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.
@mastra/core@1.82.04 ноября 2026 г.Ломает совместимость

Knowledge v2 с деревом страниц, устойчивые агенты, фоновые задачи с MCP и улучшения наблюдаемости.

  • НовоеKnowledge v2: модель дерева страниц, серверная синхронизация и новые инструменты чтения.
  • НовоеУстойчивость агентов при перезапуске API через fencing и общее хранилище.
  • НовоеФоновые задачи: возобновление приостановленных вызовов инструментов и интеграция с MCP.
  • НовоеЧтение-только API для Knowledge Explorer и SSE-поток событий в Mastra Server.
  • НовоеМетрики задержки стриминга и расширенные фильтры трассировок по requestId и experimentId.
  • Ломает совместимостьУдалены reindex(), экспериментальные memory-опции и API claimKey в factory.
@mastra/core@1.81.02 ноября 2026 г.Ломает совместимость

Релиз Mastra 1.81.0: добавлены MCP-задачи с сохранением состояния, улучшена наблюдаемость, обновлены дашборды и работа с файлами.

  • НовоеПоявились экспериментальные MCP-задачи с хранением в хранилище, обеспечивающие перезапускаемость и отслеживание долгих процессов.
  • НовоеФоновые задачи теперь поддерживают не-агентные владельцы с настройками очередей, параллелизма и сроков хранения.
  • НовоеНаблюдаемость расширена: добавлены метрики TTFT, причины остановки моделей и детализация по провайдерам для анализа затрат.
  • НовоеКанальные агенты теперь могут скачивать и сохранять аутентифицированные бинарные вложения в рабочее пространство.
  • Ломает совместимостьВ @mastra/playground-ui удалены старые компоненты графиков, утилиты наведения и API для старых типов досок.
@mastra/core@1.80.028 октября 2026 г.Ломает совместимость

Персональные подключения пользователей, агрегация спанов, классификация ошибок и запуск экспериментов с произвольной моделью.

  • НовоеВ @mastra/connect добавлены пользовательские OAuth-подключения и встроенный инструмент запроса соединения для UI.
  • НовоеПоявился API агрегации спанов (ClickHouse/Postgres/DuckDB) для быстрой оценки метрик и стоимости.
  • НовоеВ @mastra/core/error внедрена классификация ошибок провайдеров для улучшения UX и логики повторов.
  • НовоеВ dataset.startExperiment() добавлен параметр agentModel для тестов агента без изменения его версии.
  • Ломает совместимостьqueryTraceThreads() больше не возвращает model/provider, а лимит page.limit ограничен 100 записями.
@mastra/core@1.79.021 октября 2026 г.Ломает совместимость

Магистральные события MCP, агрегация спанов, сессии агентов по ID и нативная файловая система в песочницах.

  • Ломает совместимостьСессии контроллера агентов теперь идентифицируются по sessionId, что позволяет создавать несколько сессий на один resourceId.
  • НовоеДобавлены экспериментальные события MCP (SEP-3415) с поддержкой стриминга, опроса и вебхуков, а также API инспекции в Studio.
  • НовоеВведена новая контрактная функция aggregateSpans() для аналитики по спанам и улучшены возможности запросов трасс и спанов.
  • НовоеПесочницы WorkspaceSandbox получили нативный файловый API для ускорения операций чтения и записи без вызова оболочки.
  • НовоеВ @mastra/connect добавлено ограничение интеграций на уровне конечных пользователей и поддержка канала Microsoft Teams.
@mastra/core@1.78.016 октября 2026 г.Ломает совместимость

В Mastra 1.78.0 добавлены агенты с областями видимости, агрегация трасс, очереди сигналов и улучшена надежность рабочих процессов.

  • НовоеАгенты теперь поддерживают scopes для многопользовательской идентификации и маршрутизации памяти.
  • НовоеПоявилась полная трассировка агрегации: серверный API, клиентский метод и React-хук.
  • НовоеДобавлен queueSignal для постановки типизированных сигналов в очередь без деградации в обычное сообщение.
  • НовоеСписки трасс и спанов теперь возвращают превью ввода/вывода/ошибок, что ускоряет запросы.
  • ИсправленоУлучшена надежность длительных рабочих процессов: исправлены ошибки в foreach и корректное сохранение suspendData.
  • Ломает совместимостьУдалены режимы Plan/Explore у фабричных сессий и изменено поведение фолбэка учетных данных.
@mastra/core@1.77.014 октября 2026 г.Ломает совместимость

Релиз 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 → Пересказ на русском — по заметкам к релизам и коммитам.