{"full_name":"mastra-ai/mastra","owner":"mastra-ai","name":"mastra","shard":"1","url":"https://github.com/mastra-ai/mastra","description":"Mastra is the modern TypeScript framework for AI-powered applications and agents.","homepage":"https://mastra.ai","topics":["agents","ai","chatbots","javascript","llm","nextjs","nodejs","reactjs","typescript","workflows","evals","mcp","tts"],"tag_pages":["agents","ai","chatbots","javascript","llm","mcp","nextjs","nodejs","reactjs","tts","typescript","workflows"],"language":"TypeScript","license":"NOASSERTION","avatar":"https://avatars.githubusercontent.com/u/149120496?v=4","created_at":"2024-08-06T20:44:31Z","pushed_at":"2026-11-15T19:17:07Z","metrics":{"stars":29533,"forks":3102,"watchers":102,"issues":7404,"prs":22204,"releases":134,"issues_open":439,"issues_closed":6965,"prs_open":332,"prs_closed":4415,"prs_merged":17457,"discussions":0},"growth":{"day":{"stars":12,"forks":5,"base_day":"2026-11-15"},"week":{"stars":220,"forks":30,"base_day":"2026-11-04"}},"history":{"dates":["2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[28830,28834,28856,28868,28917,28952,28982,29012,29036,29050,29093,29125,29155,29194,29214,29283,29313,29443,29474,29483,29488,29509,29521,29533],"forks":[2985,2987,2991,2998,3013,3020,3028,3033,3038,3039,3048,3053,3057,3060,3062,3069,3072,3087,3092,3098,3097,3095,3097,3102],"watchers":[106,106,106,106,106,107,107,107,107,102,102,103,103,103,103,102,102,null,102,102,102,102,102,102],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,440,422,426,433,435,439],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,332,329,316,325,331,332]},"boards":{},"same_owner":[],"issues":[{"number":5093,"title":"[FEATURE] Support for message branching","comments":15,"created_at":"2025-06-12T14:27:51Z"},{"number":20603,"title":"Custom Tool Suspension, Studio Resume UI, and Invalid resumeData Schema","comments":9,"created_at":"2026-08-02T22:22:02Z"},{"number":23516,"title":"[FEATURE] Support per-phase model and reasoning configuration in Mastra Factory","comments":8,"created_at":"2026-09-10T13:38:32Z"},{"number":17065,"title":"[FEATURE] Cancel a running agent execution from a Channel (e.g. Slack \"stop\" reply)","comments":8,"created_at":"2026-05-26T12:01:46Z"},{"number":28932,"title":"[BUG] EventedAgent with Postgres stalls after tool resume: next loop occurrence rejected by step guard","comments":7,"created_at":"2026-10-30T00:57:11Z"},{"number":23309,"title":"feat: add Observational Memory support to @mastra/mssql","comments":7,"created_at":"2026-09-08T08:34:16Z"},{"number":14503,"title":"[BUG] @mastra/core 1.11+ breaks Cloudflare Workers: AJV v8 uses new Function() blocked by V8 isolate","comments":7,"created_at":"2026-03-19T16:24:17Z"},{"number":28565,"title":"[BUG] Working memory state signal moves the previous turn's assistant message into the new turn's response","comments":6,"created_at":"2026-10-27T10:08:55Z"}],"discussions":[],"latest_release":{"name":"November 12, 2026","tag":"@mastra/core@1.83.0","published_at":"2026-11-13T14:32:29Z","body":"## Highlights\r\n\r\n### Resumable Agent streams (now for every Agent)\r\nEvery `Agent` can now publish a resumable run stream with replay caching, cross-instance observe/abort (`agent.observe(runId)`, `observe().abort()`, `agent.abortRunStream(runId)`), and ownership/TTL enforcement—so clients can reconnect without killing the run by default.\r\n\r\n### Built-in MCP server at `/api/mcp` + OAuth discovery\r\n`@mastra/server` now ships a built-in MCP endpoint (enabled by default when `server.auth` is configured) so MCP clients can call your agents/workflows/tools without defining an `MCPServer`, plus OAuth discovery/audience checks via `server.mcp.oauth` and a new introspection route `GET /api/mcp/builtin`.\r\n\r\n### Workflow Storage Version 2 (delta writes) now supported on Postgres + libSQL\r\nExperimental `storageVersion: 2` reduces writes by persisting only per-step changes (instead of rewriting the whole run) and now works with `@mastra/pg` and `@mastra/libsql`, with results that can lazily load step history via an async `steps()` function.\r\n\r\n### Resumable AI SDK chat routes (`useChat({ resume: true })` support)\r\n`chatRoute({ resumable: true })` now generates a POST + reconnect GET endpoint pair that replays/follows active runs via `agent.observe(runId)`, with explicit route-array configuration support (`server.apiRoutes: [routes]`).\r\n\r\n### One-off and bounded schedules for agents & workflows\r\nSchedules now support one-time execution (`runAt`) and bounded recurring execution (`endAt`), with TypeScript updates (`cron` is optional) across server, client, and multiple storage backends.\r\n\r\n### Breaking Changes\r\n- `Agent`’s `durable` option now controls **resumable streams only** (not checkpoint-backed durable execution); migrate durable execution to `createDurableAgent({ agent })`, and note plain-agent disconnect behavior differs when streams are enabled.\r\n\r\n## Changelog\r\n\r\n### [@mastra/core@1.83.0](https://github.com/mastra-ai/mastra/blob/@mastra/core@1.83.0/packages/core/CHANGELOG.md)\r\n#### Minor Changes\r\n\r\n- Added resumable streams to every `Agent`, not just durable agents. An agent registered on `Mastra` now publishes each run on its stream topic and keeps a replay cache, so a client can reconnect after a disconnect, another reader can follow the run with `agent.observe(runId)`, and any reader can stop it with `observe().abort()` or `agent.abortRunStream(runId)`. (#28424)\r\n\r\n  _Also in: @mastra/server@1.83.0_\r\n\r\n- Avoid blocking the event loop while loading instruction files from a trusted Git ref and while discovering tool-result instruction reminders. Keep missing and untrusted-ref behavior unchanged. (#30104)\r\n\r\n  _Also in: @mastra/code-sdk@1.19.0_\r\n\r\n- Add model and provider as span query sort fields. (#30096)\r\n\r\n- Added `server.mcp.oauth` (`resource`, `requireAudience`, `authorizationServers`, `scopesSupported`) to configure OAuth discovery and token audience checks for the built-in MCP server. Auth providers can implement the new optional `getOAuthMetadata()` and `verifyAudience()` methods to advertise their authorization server and check the token audience. `CompositeAuth` combines the authorization servers of its providers and checks the audience with the provider that accepted the token. The new `CompositeAuth.getAuthenticatedProvider(user)` returns that provider. (#29930)\r\n\r\n- Added the `server.mcp` option for configuring the built-in MCP server at `/api/mcp`: turn it on or off, change its path, choose toolsets, feature agents and workflows, serve only read-only tools, and include or exclude agents, workflows, and tools by id. (#29929)\r\n\r\n- Added `memory`, `observability`, `observability_analytics`, and `stored_agents` to the toolsets accepted by `server.mcp.toolsets`. (#29931)\r\n\r\n- Chat SDK logs from channels now use your Mastra logger, so they follow its format, level, and redact settings. These logs no longer print with the `[chat-sdk]` console prefix. To filter them, use `component: 'chat-sdk'`. Use the new `toChatLogger` ex","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}