mastra-ai/mastra

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.