mastra-ai/mastra

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

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

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

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

Улучшена надёжность агентов, добавлены атомарные обновления памяти в PostgreSQL и автовыбор модели для Observational Memory.

• Added: Внедрена система владения запусками агентов с защитой от конфликтов и корректным восстановлением после сбоев.
• Added: В PostgreSQL добавлены атомарные слияния рабочей памяти через транзакции с блокировкой строк.
• Added: Observational Memory теперь по умолчанию использует модель 'auto' для автоматического выбора провайдера.
• Added: Добавлена обработка файлов через песочницу и улучшена устойчивость агентов к ошибкам провайдеров.
• Added: Расширены возможности трассировки: вложенность спанов и поиск по словам в метаданных.
• Breaking: Изменены дефолтные настройки Observational Memory и удалены устаревшие компоненты в @mastra/playground-ui.

Инструменты получили доступ к истории чата, улучшен поиск по памяти, обновлены UI-компоненты и устранены ломающие изменения в Playground.

• Added: Инструменты теперь могут читать полную историю диалога через context.agent.getMessages(), включая запомненные сообщения и промежуточные ответы.
• Added: Поиск по истории наблюдательной памяти получил фильтрацию по groupId, сортировку и прямой доступ по recordId для всех поддерживаемых адаптеров.
• Added: Механизм Recall теперь поддерживает пагинацию групп наблюдений вокруг найденных совпадений, что улучшает навигацию по контексту.
• Added: В Playground UI добавлены новые доступные компоненты форм (Field, Form, SearchInput), стандартизирующие работу с метками и ошибками.
• Fixed: Исправлена ошибка, из-за которой агенты в чатах переставали реагировать на упоминания после переименования бота.
• Breaking: В @mastra/playground-ui удалены устаревшие свойства пагинации; теперь для управления загрузкой старых сообщений нужно использовать pageSize и onLoadOlder.

Динамические каналы, lease-блоки для фоновых задач, улучшенная надёжность агентов и новые интеграции Microsoft Teams.

• Added: Динамическое разрешение каналов: подключения Mastra Platform теперь подхватываются на лету без передеплоя.
• Added: Безопасность фоновых задач: добавлены истекающие lease-блоки владения для предотвращения дублирования и перезаписи результатов.
• Fixed: Повышена надёжность агентов и воркфлоу: улучшено восстановление после сбоев и обработка таймаутов.
• Added: Новый провайдер Microsoft Teams и 25 инструментов в @mastra/connect с поддержкой мульти-подключений.
• Breaking: session.respondToToolApproval теперь обязателен с toolCallId; в @mastra/playground-ui изменены API компонентов.

Mastra 1.71: улучшена наблюдаемость, добавлен Discord-интеграция и автоматические эмбеддинги в MongoDB.

• Added: Серверы теперь сообщают о возможностях хранилищ наблюдаемости, позволяя клиентам вызывать только поддерживаемые API.
• Added: Появился API планирования агрегации трасс для валидации запросов и обеспечения согласованности между бэкендами.
• Added: Инструменты запускаются сразу после готовности аргументов, что ускоряет потоковые вычисления.
• Added: Добавлен пакет @mastra/discord для интеграции с Discord и поддержка автоматических эмбеддингов в MongoDB.
• Breaking: В @mastra/playground-ui удалены свойства title, TaskListHeader и hideWhenEmpty из компонента TaskList.

Mastra 1.66: расширены фильтры трассировок, добавлено удаление фидбэка, улучшена стабильность стриминга и память.

• Added: Расширены возможности фильтрации трассировок: добавлены предикаты для метаданных, фидбэка, оценок и атрибутов спанов.
• Added: Добавлены методы deleteFeedback() и deleteScores() для безопасного удаления сигналов наблюдаемости с поддержкой скропинга по организации.
• Added: Внедрены хуки трансформации в Observational Memory для фильтрации и редактирования сообщений до сохранения.
• Added: Улучшена надежность стриминга: добавлен таймаут первой чанка и снижено влияние трассировки на производительность.
• Added: Внедрена типизация входных и выходных данных для ключевых типов спанов (AGENT_RUN, MODEL_GENERATION и др.).

Mastra 1.65: продвинутые запросы к трейсам, каскадное удаление, метаданные workflow и новые доски Factory.

• Added: Добавлен строгий контракт для сложных запросов к трейсам с поддержкой временных диапазонов, рекурсии и пагинации.
• Added: Реализовано каскадное удаление трейсов и связанных данных с ограничением до 1000 записей за запрос.
• Added: Блоки управления workflow (параллельные, циклы, sleep) теперь поддерживают стабильные id и метаданные.
• Added: Появился API для обработки действий в интерфейсе агентов через handlers.onAction.
• Added: Factory добавила типизированный defineBoard() с собственной политикой переходов и правилами.
• Breaking: Удален глобальный объект правил в Factory, изменены фазы defineBoard() и структура ответов API.

В Mastra 1.64.0 добавлены шаблоны песочниц, единая рабочая директория, серверная обработка вывода клиентских инструментов и ревью фидбека.

• Added: Появились переиспользуемые шаблоны песочниц и быстрая проверка репозиториев, что значительно сокращает время холодного старта.
• Added: Добавлена опция workingDirectory, унифицирующая рабочую директорию для всех провайдеров песочниц (E2B, Docker, Vercel и др.).
• Added: Клиентские инструменты теперь поддерживают серверный toModelOutput для преобразования результатов в формат, понятный модели.
• Added: Введён рабочий процесс ревью для наблюдаемости: статусы reviewStatus, фильтрация и новый API-эндпоинт для обновления статуса.
• Added: Появилась интеграция @mastra/evals/vitest для запуска оценок как тестов Vitest с поддержкой CI.
• Breaking: В @mastra/factory конфигурация sandbox теперь передаётся как функция, а не объект; удалены workdir, maxSandboxes и модель флота.

В Mastra 1.63.0 улучшена трассировка логов, добавлена интеграция с Pino и исправлены ошибки планировщика.

• Added: Внедрен контракт AdaptableLogger для стандартизации корреляции трассировки через trace_id и span_id.
• Added: PinoLogger теперь поддерживает адаптер, добавляя контекст трассировки во все транспорты через миксин.
• Fixed: Исправлено связывание логов с родительскими спанами, устранена ошибка 'Span not found' в Studio.
• Added: Добавлен эндпоинт /health для воркеров, позволяющий платформам проверять готовность перед развертыванием.
• Fixed: Планировщик теперь обнаруживает новые расписания без перезапуска, исправлено возобновление задач с ложными значениями.
• Breaking: В @mastra/playground-ui удалены устаревшие свойства DataList, заменено использование MonoCell.

Mastra 1.61.0: внешние оркестраторы управляют экспериментами, улучшено управление жизненным циклом сервера и сессиями.

• Added: Caller-driven experiments: внешние оркестраторы (например, Temporal) могут управлять циклом экспериментов, а Mastra выступает системой записи.
• Added: Graceful shutdown: добавлены настройки для генерируемых серверов, включая контроль времени ожидания (drainTimeout) и отключение встроенных обработчиков сигналов.
• Added: While-Active delivery: сообщения, отправленные во время работы агента, теперь автоматически маркируются, упрощая работу сессий и транскриптов.
• Added: Безопасность параллельного запуска: добавлена атомарная блокировка для resume() с возвратом HTTP 409 при конфликтах.
• Added: Evals: новая функция createMultiTurnJudgeScorer для оценки многооборотных диалогов с помощью LLM-судьи.

Mastra 1.60: durable-исполнение агентов, облачный Sandbox от Cloudflare, обновления MCP и RAG, а также новые возможности PubSub и управления процессами.

• Added: Агенты теперь поддерживают durable-исполнение (durable: true) без необходимости деплоя нового кода, с наследованием кэша и pubsub для работы в мультирепликах.
• Added: Добавлен провайдер @mastra/cloudflare-sandbox для запуска команд и работы с файлами через Sandbox Bridge Worker в удаленных рабочих пространствах.
• Added: Обновлен MCP-протокол: добавлена опциональная поддержка версии 2026-07-28 и улучшена элиситация через механизм многоэтапных раундов.
• Added: Sandbox-окружения теперь поддерживают чекпоинты (supportsCheckpoints), позволяя сохранять и восстанавливать снимки файловой системы для быстрого старта.
• Added: В RAG добавлены методы serialize() и GraphRAG.deserialize() для сохранения и восстановления графов знаний, что снижает затраты на запуск.
• Added: В ProcessHandle добавлен метод closeStdin() для корректного завершения ввода в локальных и Docker-песочницах, а также улучшена работа хуков onOutput для клиентских инструментов.

Переименование CostGuard в TokenCostControl, интроспекция активных запусков и фиксы трассировки.

• Breaking: CostGuardProcessor переименован в TokenCostControl с новыми опциями бюджетирования и scopes.
• Added: Добавлены методы listActiveThreadRuns для отслеживания активных запусков агентов в памяти.
• Fixed: Исправлено отображение внешних родительских трасс как корней в Mastra Studio.
• Added: SensitiveDataFilter получил стиль redaction 'indexed' для стабильных токенов вместо [REDACTED].
• Added: Memory recall поддерживает continuation через nextCharOffset для больших сообщений.

В Mastra 1.57.0 добавлены гварды для результатов инструментов, транзитные сигналы агентов и интеграция с DeepEval.

• Added: Добавлен хук processToolResult для проверки результатов инструментов на инъекции и чувствительные данные до их попадания в историю.
• Added: Реализована поддержка транзитных сигналов (transient: true) для передачи контекста без сохранения в памяти.
• Added: Выпущен экспортер @mastra/deepeval для отправки трасс в Confident AI (DeepEval) для оценки и мониторинга.
• Added: В спаны MODEL_GENERATION добавлены полные определения инструментов, а PostHog теперь передает их как $ai_tools.
• Fixed: Исправлена утечка памяти при приостановке работы агентов: теперь они хранятся ограниченное время (по умолчанию 30 минут).

Mastra 1.56.0: декларативные сохраняемые воркфлоу, HTTP API для их управления и улучшенные инструменты оценки.

• Added: Появились декларативные сохраняемые воркфлоу: графы теперь можно сериализовать в JSON, сохранять в БД и восстанавливать после перезапусков.
• Added: Добавлено HTTP API и клиентский SDK для управления сохраненными воркфлоу, а также поддержка условных переходов и циклов в сериализуемом виде.
• Added: Улучшены эксперименты и оценки: появилась выборка скореров на уровне элементов датасета, контроль сохранения запусков и политика безопасности инструментов.
• Added: Обновлена система наблюдаемости: добавлена пакетная фильтрация трасс, идентификаторы вызовов инструментов и улучшена стабильность потоковой передачи.
• Breaking: В @mastra/platform-workspace удалена авторизация через MASTRA_PLATFORM_SECRET_KEY; теперь требуется использовать MASTRA_PLATFORM_ACCESS_TOKEN.

Запуск кода в V8-изоляторе без песочницы, встроенный веб-поиск и черновики агентов.

• Added: Появился пакет @mastra/isolated-vm для выполнения кода в изолированном V8-окружении без песочницы.
• Added: В ядро добавлен встроенный инструмент webSearchTool для поиска в интернете через провайдеров.
• Added: Реализовано создание черновиков агентов через параметр autoPublish без немедленной публикации.
• Added: Канальные обработчики теперь могут изменять контекст запроса перед запуском выполнения.
• Breaking: Параметр ctx в ChannelHandler стал обязательным, что требует обновления вызовов функций.

Релиз Mastra 1.49.0: добавлено управление хранением, многопользовательская изоляция, оценка трейсов и улучшена работа с агентами.

• Added: Добавлена опциональная политика хранения данных с возможностью безопасной очистки старых записей через storage.prune().
• Added: Реализована изоляция по организациям и проектам для датасетов, экспериментов и оценок.
• Added: Появились API для оценки сохраненных трейсов (scoreTrace) с поддержкой пакетной обработки и отслеживания происхождения данных.
• Added: Улучшена авторизация агентов: поддержка вложенных подагентов, исправления потоковой передачи и защита роутера моделей.
• Added: Добавлены новые провайдеры для рабочих пространств: Apple Container, Mesa, Railway и E2B.
• Breaking: В @mastra/playground-ui удалены корневые экспорты и компонент Searchbar, требуется импорт из подпутей.

Добавлены cron-агенты, файловые агенты, улучшена память и Inngest, переименованы API интервалов.

• Added: Появились Heartbeats: планирование агентов по cron с сохранением расписания.
• Added: Файловые агенты: авто-регистрация через структуру директорий и поддержку подагентов.
• Added: Human-in-the-loop: обнаружение приостановленных запусков через хранилище для надежности.
• Added: Observational Memory: публичный Extractor API и автоматическое управление рабочей памятью.
• Added: Inngest: паритет с DurableAgent, реплей событий и поддержка FGA actor.
• Breaking: API интервалов переименовано: heartbeatHandlers стали intervalHandlers.