create-mastra 0.0.0-roamin-openaivoice-speak-options-passing-20250926163614 → 0.0.0-salesman-20260127182805

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/CHANGELOG.md +581 -1
  2. package/README.md +10 -32
  3. package/dist/index.js +953 -541
  4. package/dist/index.js.map +1 -1
  5. package/dist/starter-files/tools.ts +2 -2
  6. package/dist/templates/dev.entry.js +3 -46
  7. package/package.json +20 -21
package/CHANGELOG.md CHANGED
@@ -1,15 +1,595 @@
1
1
  # create-mastra
2
2
 
3
- ## 0.0.0-roamin-openaivoice-speak-options-passing-20250926163614
3
+ ## 0.0.0-salesman-20260127182805
4
+
5
+ ## 1.0.1
6
+
7
+ ## 1.0.1-alpha.0
8
+
9
+ ## 1.0.0
10
+
11
+ ### Major Changes
12
+
13
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
14
+
15
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
16
+
17
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
18
+
19
+ ### Minor Changes
20
+
21
+ - Add Antigravity IDE support to create-mastra CLI. Users can now select Antigravity during project initialization and automatically configure the global Mastra MCP server for the IDE, reducing manual setup and enabling immediate use of Mastra agents. ([#11374](https://github.com/mastra-ai/mastra/pull/11374))
22
+
23
+ ### Patch Changes
24
+
25
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
26
+
27
+ ```diff
28
+ + const run = await workflow.createRun({ runId: '123' });
29
+ - const stream = await run.streamVNext({ inputData: { ... } });
30
+ + const stream = await run.stream({ inputData: { ... } });
31
+ ```
32
+
33
+ - Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
34
+
35
+ - Fix select options overflow when list is long by adding maximum height ([#10813](https://github.com/mastra-ai/mastra/pull/10813))
36
+
37
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
38
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
39
+
40
+ - dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
41
+ - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
42
+
43
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
44
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
45
+
46
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
47
+
48
+ - Fix default value showing on workflow form after user submits ([#10983](https://github.com/mastra-ai/mastra/pull/10983))
49
+
50
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
51
+
52
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
53
+
54
+ ```typescript
55
+ const agent = new Agent({
56
+ //...agent information,
57
+ defaultAgentOptions: {
58
+ autoResumeSuspendedTools: true,
59
+ },
60
+ });
61
+ ```
62
+
63
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
64
+
65
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
66
+ - Add suspend/resume capabilities to agent network
67
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
68
+
69
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
70
+
71
+ - Fix peer dependency conflicts in browsing-agent template. Updated template dependencies to align with @browserbasehq/stagehand@2.5.6 requirements: ([#11346](https://github.com/mastra-ai/mastra/pull/11346))
72
+ - Updated `dotenv` from `^17.2.1` to `^16.4.5`
73
+ - Updated `zod` from `^3.25.76` to `^3.25.67`
74
+
75
+ This ensures `npx create-mastra@latest --template browsing-agent` can be installed and run without peer dependency errors.
76
+
77
+ - Detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
78
+
79
+ - Add `Run` instance to client-js. `workflow.createRun` returns the `Run` instance which can be used for the different run methods. ([#11207](https://github.com/mastra-ai/mastra/pull/11207))
80
+ With this change, run methods cannot be called directly on workflow instance anymore
81
+
82
+ ```diff
83
+ - const result = await workflow.stream({ runId: '123', inputData: { ... } });
84
+ + const run = await workflow.createRun({ runId: '123' });
85
+ + const stream = await run.stream({ inputData: { ... } });
86
+ ```
87
+
88
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
89
+
90
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
91
+
92
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
93
+
94
+ ```typescript
95
+ await workflow.deleteWorkflowRunById(runId);
96
+ ```
97
+
98
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
99
+
100
+ - Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
101
+
102
+ - Fix discriminatedUnion schema information lost when json schema is converted to zod ([#10500](https://github.com/mastra-ai/mastra/pull/10500))
103
+
104
+ - Move useScorers down to trace page to trigger it once for all trace spans ([#10985](https://github.com/mastra-ai/mastra/pull/10985))
105
+
106
+ - Update Observability Trace Spans list UI, so a user can expand/collapse span children/descendants and can filter the list by span type or name ([#10378](https://github.com/mastra-ai/mastra/pull/10378))
107
+
108
+ - Fix workflow trigger form overflow ([#10986](https://github.com/mastra-ai/mastra/pull/10986))
109
+
110
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
111
+
112
+ - Hide time travel on map steps in Studio ([#10631](https://github.com/mastra-ai/mastra/pull/10631))
113
+
114
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
115
+
116
+ - Display network completion validation results and scorer feedback in the Playground when viewing agent network runs, letting users see pass/fail status and actionable feedback from completion scorers ([#11562](https://github.com/mastra-ai/mastra/pull/11562))
117
+
118
+ - fix isTopLevelSpan value definition on SpanScoring to properly recognize lack of span?.parentSpanId value (null or empty string) ([#11083](https://github.com/mastra-ai/mastra/pull/11083))
119
+
120
+ ## 1.0.0-beta.19
121
+
122
+ ## 1.0.0-beta.18
123
+
124
+ ## 1.0.0-beta.17
125
+
126
+ ## 1.0.0-beta.16
127
+
128
+ ## 1.0.0-beta.15
129
+
130
+ ### Patch Changes
131
+
132
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
133
+ - Add suspend/resume capabilities to agent network
134
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
135
+
136
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
137
+
138
+ ## 1.0.0-beta.14
139
+
140
+ ### Patch Changes
141
+
142
+ - Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
143
+
144
+ - dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
145
+ - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
146
+
147
+ - Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
148
+
149
+ ## 1.0.0-beta.13
150
+
151
+ ### Patch Changes
152
+
153
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
154
+
155
+ ```diff
156
+ + const run = await workflow.createRun({ runId: '123' });
157
+ - const stream = await run.streamVNext({ inputData: { ... } });
158
+ + const stream = await run.stream({ inputData: { ... } });
159
+ ```
160
+
161
+ - Fix peer dependency conflicts in browsing-agent template. Updated template dependencies to align with @browserbasehq/stagehand@2.5.6 requirements: ([#11346](https://github.com/mastra-ai/mastra/pull/11346))
162
+ - Updated `dotenv` from `^17.2.1` to `^16.4.5`
163
+ - Updated `zod` from `^3.25.76` to `^3.25.67`
164
+
165
+ This ensures `npx create-mastra@latest --template browsing-agent` can be installed and run without peer dependency errors.
166
+
167
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
168
+
169
+ - Display network completion validation results and scorer feedback in the Playground when viewing agent network runs, letting users see pass/fail status and actionable feedback from completion scorers ([#11562](https://github.com/mastra-ai/mastra/pull/11562))
170
+
171
+ ## 1.0.0-beta.12
172
+
173
+ ### Minor Changes
174
+
175
+ - Add Antigravity IDE support to create-mastra CLI. Users can now select Antigravity during project initialization and automatically configure the global Mastra MCP server for the IDE, reducing manual setup and enabling immediate use of Mastra agents. ([#11374](https://github.com/mastra-ai/mastra/pull/11374))
176
+
177
+ ### Patch Changes
178
+
179
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
180
+
181
+ ## 1.0.0-beta.11
182
+
183
+ ## 1.0.0-beta.10
184
+
185
+ ### Patch Changes
186
+
187
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
188
+
189
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
190
+
191
+ ```typescript
192
+ const agent = new Agent({
193
+ //...agent information,
194
+ defaultAgentOptions: {
195
+ autoResumeSuspendedTools: true,
196
+ },
197
+ });
198
+ ```
199
+
200
+ - Add `Run` instance to client-js. `workflow.createRun` returns the `Run` instance which can be used for the different run methods. ([#11207](https://github.com/mastra-ai/mastra/pull/11207))
201
+ With this change, run methods cannot be called directly on workflow instance anymore
202
+
203
+ ```diff
204
+ - const result = await workflow.stream({ runId: '123', inputData: { ... } });
205
+ + const run = await workflow.createRun({ runId: '123' });
206
+ + const stream = await run.stream({ inputData: { ... } });
207
+ ```
208
+
209
+ - fix isTopLevelSpan value definition on SpanScoring to properly recognize lack of span?.parentSpanId value (null or empty string) ([#11083](https://github.com/mastra-ai/mastra/pull/11083))
210
+
211
+ ## 1.0.0-beta.9
212
+
213
+ ## 1.0.0-beta.8
214
+
215
+ ### Patch Changes
216
+
217
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
218
+
219
+ ```typescript
220
+ await workflow.deleteWorkflowRunById(runId);
221
+ ```
222
+
223
+ ## 1.0.0-beta.7
224
+
225
+ ### Patch Changes
226
+
227
+ - Fix default value showing on workflow form after user submits ([#10983](https://github.com/mastra-ai/mastra/pull/10983))
228
+
229
+ - Move useScorers down to trace page to trigger it once for all trace spans ([#10985](https://github.com/mastra-ai/mastra/pull/10985))
230
+
231
+ - Update Observability Trace Spans list UI, so a user can expand/collapse span children/descendants and can filter the list by span type or name ([#10378](https://github.com/mastra-ai/mastra/pull/10378))
232
+
233
+ - Fix workflow trigger form overflow ([#10986](https://github.com/mastra-ai/mastra/pull/10986))
234
+
235
+ ## 1.0.0-beta.6
236
+
237
+ ### Patch Changes
238
+
239
+ - Fix select options overflow when list is long by adding maximum height ([#10813](https://github.com/mastra-ai/mastra/pull/10813))
240
+
241
+ ## 1.0.0-beta.5
242
+
243
+ ### Patch Changes
244
+
245
+ - Fix discriminatedUnion schema information lost when json schema is converted to zod ([#10500](https://github.com/mastra-ai/mastra/pull/10500))
246
+
247
+ - Hide time travel on map steps in Studio ([#10631](https://github.com/mastra-ai/mastra/pull/10631))
248
+
249
+ ## 1.0.0-beta.4
250
+
251
+ ### Patch Changes
252
+
253
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
254
+
255
+ ## 1.0.0-beta.3
256
+
257
+ ### Patch Changes
258
+
259
+ - fix: detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
260
+
261
+ ## 1.0.0-beta.2
262
+
263
+ ### Patch Changes
264
+
265
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
266
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
267
+
268
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
269
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
270
+
271
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
272
+
273
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
274
+
275
+ ## 1.0.0-beta.1
276
+
277
+ ### Patch Changes
278
+
279
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
280
+
281
+ ## 1.0.0-beta.0
282
+
283
+ ### Major Changes
284
+
285
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
286
+
287
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
288
+
289
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
290
+
291
+ ### Patch Changes
292
+
293
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
294
+
295
+ ## 0.17.3
296
+
297
+ ## 0.17.3-alpha.0
298
+
299
+ ## 0.17.2
300
+
301
+ ## 0.17.2-alpha.0
302
+
303
+ ## 0.17.1
304
+
305
+ ### Patch Changes
306
+
307
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
308
+
309
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
310
+
311
+ ## 0.17.1-alpha.1
312
+
313
+ ### Patch Changes
314
+
315
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
316
+
317
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
318
+
319
+ ## 0.17.1-alpha.0
320
+
321
+ ## 0.17.0
322
+
323
+ ### Patch Changes
324
+
325
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
326
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
327
+ - Have more control over the versions in the future to not have breakages over night
328
+
329
+ ## 0.17.0-alpha.0
330
+
331
+ ### Patch Changes
332
+
333
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
334
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
335
+ - Have more control over the versions in the future to not have breakages over night
336
+
337
+ ## 0.16.0
338
+
339
+ ### Patch Changes
340
+
341
+ - Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
342
+
343
+ - Fix auto tab for model picker in playground-ui, the UI no longer auto tabs to the next selector when selecting a model/provider. ([#8680](https://github.com/mastra-ai/mastra/pull/8680))
344
+
345
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
346
+
347
+ - Adds reset button to model picker to reset to original model set on the agent. ([#8633](https://github.com/mastra-ai/mastra/pull/8633))
348
+
349
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
350
+
351
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
352
+
353
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
354
+
355
+ - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
356
+
357
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
358
+
359
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
360
+
361
+ ## 0.16.0-alpha.1
362
+
363
+ ### Patch Changes
364
+
365
+ - Fix auto tab for model picker in playground-ui, the UI no longer auto tabs to the next selector when selecting a model/provider. ([#8680](https://github.com/mastra-ai/mastra/pull/8680))
366
+
367
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
368
+
369
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
370
+
371
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
372
+
373
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
374
+
375
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
376
+
377
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
378
+
379
+ ## 0.15.2-alpha.0
380
+
381
+ ### Patch Changes
382
+
383
+ - Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
384
+
385
+ - Adds reset button to model picker to reset to original model set on the agent. ([#8633](https://github.com/mastra-ai/mastra/pull/8633))
386
+
387
+ - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
388
+
389
+ ## 0.15.1
390
+
391
+ ### Patch Changes
392
+
393
+ - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
394
+
395
+ ## 0.15.1-alpha.1
396
+
397
+ ## 0.15.1-alpha.0
398
+
399
+ ### Patch Changes
400
+
401
+ - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
402
+
403
+ ## 0.15.0
404
+
405
+ ### Patch Changes
406
+
407
+ - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
408
+
409
+ - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
410
+
411
+ - avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
412
+
413
+ - add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
414
+
415
+ - Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
416
+
417
+ - Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
418
+
419
+ - Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
420
+
421
+ - Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
422
+ fixed an issue with provider ID rendering in playground UI
423
+
424
+ - Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
425
+
426
+ ## 0.15.0-alpha.3
427
+
428
+ ### Patch Changes
429
+
430
+ - Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
431
+ fixed an issue with provider ID rendering in playground UI
432
+
433
+ ## 0.14.2-alpha.2
434
+
435
+ ### Patch Changes
436
+
437
+ - Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
438
+
439
+ ## 0.14.2-alpha.1
440
+
441
+ ### Patch Changes
442
+
443
+ - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
444
+
445
+ - avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
446
+
447
+ - add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
448
+
449
+ - Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
450
+
451
+ - Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
452
+
453
+ ## 0.14.2-alpha.0
454
+
455
+ ### Patch Changes
456
+
457
+ - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
458
+
459
+ - Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
460
+
461
+ ## 0.14.1
462
+
463
+ ### Patch Changes
464
+
465
+ - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
466
+
467
+ ## 0.14.1-alpha.0
468
+
469
+ ### Patch Changes
470
+
471
+ - Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
472
+
473
+ ## 0.14.0
474
+
475
+ ### Minor Changes
476
+
477
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
478
+
479
+ ### Patch Changes
480
+
481
+ - Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
482
+
483
+ - add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
484
+
485
+ - better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
486
+
487
+ - fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
488
+
489
+ - Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
490
+
491
+ **Documentation generation (`@mastra/core`):**
492
+ - Fixed inverted dynamic model selection logic in provider examples
493
+ - Improved copy: replaced marketing language with action-oriented descriptions
494
+ - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
495
+
496
+ **Playground UI model picker (`@mastra/playground-ui`):**
497
+ - Fixed provider field clearing when typing in model input
498
+ - Added responsive layout (stacks on mobile, side-by-side on desktop)
499
+ - Improved general styling of provider/model pickers
500
+
501
+ **Environment variables (`@mastra/deployer`):**
502
+ - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
503
+ - Added correct singular/plural handling for "environment variable(s)"
504
+
505
+ - show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
506
+
507
+ - Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
508
+
509
+ - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
510
+
511
+ ## 0.14.0-alpha.0
512
+
513
+ ### Minor Changes
514
+
515
+ - Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
4
516
 
5
517
  ### Patch Changes
6
518
 
519
+ - Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
520
+
521
+ - add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
522
+
523
+ - better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
524
+
525
+ - fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
526
+
527
+ - Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
528
+
529
+ **Documentation generation (`@mastra/core`):**
530
+ - Fixed inverted dynamic model selection logic in provider examples
531
+ - Improved copy: replaced marketing language with action-oriented descriptions
532
+ - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
533
+
534
+ **Playground UI model picker (`@mastra/playground-ui`):**
535
+ - Fixed provider field clearing when typing in model input
536
+ - Added responsive layout (stacks on mobile, side-by-side on desktop)
537
+ - Improved general styling of provider/model pickers
538
+
539
+ **Environment variables (`@mastra/deployer`):**
540
+ - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
541
+ - Added correct singular/plural handling for "environment variable(s)"
542
+
543
+ - show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
544
+
545
+ - Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
546
+
547
+ - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
548
+
549
+ ## 0.13.4
550
+
551
+ ### Patch Changes
552
+
553
+ - disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
554
+
555
+ - Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
556
+
557
+ ## 0.13.4-alpha.1
558
+
559
+ ### Patch Changes
560
+
561
+ - disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
562
+
563
+ ## 0.13.4-alpha.0
564
+
565
+ ### Patch Changes
566
+
567
+ - Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
568
+
569
+ ## 0.13.3
570
+
571
+ ### Patch Changes
572
+
573
+ - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
574
+
7
575
  - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
8
576
 
577
+ - Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
578
+
9
579
  - Add types in the streamVNext codepath, fixes for various issues across multiple packages surfaced from type issues, align return types. ([#8010](https://github.com/mastra-ai/mastra/pull/8010))
10
580
 
11
581
  - Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
12
582
 
583
+ ## 0.13.3-alpha.1
584
+
585
+ ### Patch Changes
586
+
587
+ - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
588
+
589
+ - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
590
+
591
+ - Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
592
+
13
593
  ## 0.13.3-alpha.0
14
594
 
15
595
  ### Patch Changes
package/README.md CHANGED
@@ -1,9 +1,16 @@
1
- # Create Mastra
1
+ # create-mastra
2
2
 
3
- The easiest way to get started with Mastra is by using `create-mastra`. This CLI tool enables you to quickly start building a new Mastra application, with everything set up for you.
3
+ Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
4
+
5
+ It includes everything you need to go from early prototypes to production-ready applications. Mastra integrates with frontend and backend frameworks like React, Next.js, and Node, or you can deploy it anywhere as a standalone server. It's the easiest way to build, tune, and scale reliable AI products.
6
+
7
+ `create-mastra` is the **recommended** way to get started with Mastra. This CLI tool enables you to quickly start building a new Mastra application, with everything set up for you.
4
8
 
5
9
  ## Usage
6
10
 
11
+ > [!IMPORTANT]
12
+ > Make sure that you have Node.js 22.13.0 or later installed on your system.
13
+
7
14
  Using npm:
8
15
 
9
16
  ```bash
@@ -22,33 +29,4 @@ Using pnpm:
22
29
  pnpm create mastra
23
30
  ```
24
31
 
25
- ## Options
26
-
27
- - `--default` - Quick start with defaults (src directory, OpenAI, no examples)
28
- - `-c, --components <components>` - Comma-separated list of components (agents, tools, workflows)
29
- - `-l, --llm <model-provider>` - Default model provider (openai, anthropic, groq, google, or cerebras)
30
- - `-e, --example` - Include example code
31
-
32
- ## Examples
33
-
34
- Create a new project with default settings
35
- npx create-mastra@latest --default
36
- Create a project with specific components and LLM provider
37
- npx create-mastra@latest -c agents,tools -l anthropic
38
- Create a project with example code
39
- npx create-mastra@latest --example
40
-
41
- ## What's included?
42
-
43
- The generated project will have:
44
-
45
- - A configured Mastra setup in the src directory
46
- - Selected components (agents, tools, workflows)
47
- - Environment configuration for your chosen LLM provider
48
- - TypeScript configuration
49
- - Example code (if selected)
50
-
51
- ## System Requirements
52
-
53
- - Node.js 20 or later
54
- - MacOS, Windows, and Linux are supported
32
+ Learn more about `create-mastra` in the [CLI reference documentation](https://mastra.ai/reference/cli/create-mastra).