create-mastra 0.0.0-unified-sidebar-20251010130811 → 0.0.0-unified-workspace-snapshot-20260128233410

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 +381 -1
  2. package/README.md +10 -32
  3. package/dist/index.js +894 -473
  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,6 +1,386 @@
1
1
  # create-mastra
2
2
 
3
- ## 0.0.0-unified-sidebar-20251010130811
3
+ ## 0.0.0-unified-workspace-snapshot-20260128233410
4
+
5
+ ### Patch Changes
6
+
7
+ - fix workflow run input caching bug in studio UI ([#11784](https://github.com/mastra-ai/mastra/pull/11784))
8
+
9
+ ## 1.0.1
10
+
11
+ ## 1.0.1-alpha.0
12
+
13
+ ## 1.0.0
14
+
15
+ ### Major Changes
16
+
17
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
18
+
19
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
20
+
21
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
22
+
23
+ ### Minor Changes
24
+
25
+ - 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))
26
+
27
+ ### Patch Changes
28
+
29
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
30
+
31
+ ```diff
32
+ + const run = await workflow.createRun({ runId: '123' });
33
+ - const stream = await run.streamVNext({ inputData: { ... } });
34
+ + const stream = await run.stream({ inputData: { ... } });
35
+ ```
36
+
37
+ - Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
38
+
39
+ - Fix select options overflow when list is long by adding maximum height ([#10813](https://github.com/mastra-ai/mastra/pull/10813))
40
+
41
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
42
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
43
+
44
+ - dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
45
+ - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
46
+
47
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
48
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
49
+
50
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
51
+
52
+ - Fix default value showing on workflow form after user submits ([#10983](https://github.com/mastra-ai/mastra/pull/10983))
53
+
54
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
55
+
56
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
57
+
58
+ ```typescript
59
+ const agent = new Agent({
60
+ //...agent information,
61
+ defaultAgentOptions: {
62
+ autoResumeSuspendedTools: true,
63
+ },
64
+ });
65
+ ```
66
+
67
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
68
+
69
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
70
+ - Add suspend/resume capabilities to agent network
71
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
72
+
73
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
74
+
75
+ - 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))
76
+ - Updated `dotenv` from `^17.2.1` to `^16.4.5`
77
+ - Updated `zod` from `^3.25.76` to `^3.25.67`
78
+
79
+ This ensures `npx create-mastra@latest --template browsing-agent` can be installed and run without peer dependency errors.
80
+
81
+ - Detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
82
+
83
+ - 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))
84
+ With this change, run methods cannot be called directly on workflow instance anymore
85
+
86
+ ```diff
87
+ - const result = await workflow.stream({ runId: '123', inputData: { ... } });
88
+ + const run = await workflow.createRun({ runId: '123' });
89
+ + const stream = await run.stream({ inputData: { ... } });
90
+ ```
91
+
92
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
93
+
94
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
95
+
96
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
97
+
98
+ ```typescript
99
+ await workflow.deleteWorkflowRunById(runId);
100
+ ```
101
+
102
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
103
+
104
+ - Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
105
+
106
+ - Fix discriminatedUnion schema information lost when json schema is converted to zod ([#10500](https://github.com/mastra-ai/mastra/pull/10500))
107
+
108
+ - Move useScorers down to trace page to trigger it once for all trace spans ([#10985](https://github.com/mastra-ai/mastra/pull/10985))
109
+
110
+ - 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))
111
+
112
+ - Fix workflow trigger form overflow ([#10986](https://github.com/mastra-ai/mastra/pull/10986))
113
+
114
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
115
+
116
+ - Hide time travel on map steps in Studio ([#10631](https://github.com/mastra-ai/mastra/pull/10631))
117
+
118
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
119
+
120
+ - 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))
121
+
122
+ - 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))
123
+
124
+ ## 1.0.0-beta.19
125
+
126
+ ## 1.0.0-beta.18
127
+
128
+ ## 1.0.0-beta.17
129
+
130
+ ## 1.0.0-beta.16
131
+
132
+ ## 1.0.0-beta.15
133
+
134
+ ### Patch Changes
135
+
136
+ - Add human-in-the-loop (HITL) support to agent networks ([#11678](https://github.com/mastra-ai/mastra/pull/11678))
137
+ - Add suspend/resume capabilities to agent network
138
+ - Enable auto-resume for suspended network execution via `autoResumeSuspendedTools`
139
+
140
+ `agent.resumeNetwork`, `agent.approveNetworkToolCall`, `agent.declineNetworkToolCall`
141
+
142
+ ## 1.0.0-beta.14
143
+
144
+ ### Patch Changes
145
+
146
+ - Replace deprecated client.getTraces with a client.listTraces ([#11711](https://github.com/mastra-ai/mastra/pull/11711))
147
+
148
+ - dependencies updates: ([#11642](https://github.com/mastra-ai/mastra/pull/11642))
149
+ - Updated dependency [`fs-extra@^11.3.3` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.3) (from `^11.3.2`, in `dependencies`)
150
+
151
+ - Make initialState optional in studio ([#11744](https://github.com/mastra-ai/mastra/pull/11744))
152
+
153
+ ## 1.0.0-beta.13
154
+
155
+ ### Patch Changes
156
+
157
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
158
+
159
+ ```diff
160
+ + const run = await workflow.createRun({ runId: '123' });
161
+ - const stream = await run.streamVNext({ inputData: { ... } });
162
+ + const stream = await run.stream({ inputData: { ... } });
163
+ ```
164
+
165
+ - 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))
166
+ - Updated `dotenv` from `^17.2.1` to `^16.4.5`
167
+ - Updated `zod` from `^3.25.76` to `^3.25.67`
168
+
169
+ This ensures `npx create-mastra@latest --template browsing-agent` can be installed and run without peer dependency errors.
170
+
171
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
172
+
173
+ - 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))
174
+
175
+ ## 1.0.0-beta.12
176
+
177
+ ### Minor Changes
178
+
179
+ - 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))
180
+
181
+ ### Patch Changes
182
+
183
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
184
+
185
+ ## 1.0.0-beta.11
186
+
187
+ ## 1.0.0-beta.10
188
+
189
+ ### Patch Changes
190
+
191
+ - Auto resume suspended tools if `autoResumeSuspendedTools: true` ([#11157](https://github.com/mastra-ai/mastra/pull/11157))
192
+
193
+ The flag can be added to `defaultAgentOptions` when creating the agent or to options in `agent.stream` or `agent.generate`
194
+
195
+ ```typescript
196
+ const agent = new Agent({
197
+ //...agent information,
198
+ defaultAgentOptions: {
199
+ autoResumeSuspendedTools: true,
200
+ },
201
+ });
202
+ ```
203
+
204
+ - 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))
205
+ With this change, run methods cannot be called directly on workflow instance anymore
206
+
207
+ ```diff
208
+ - const result = await workflow.stream({ runId: '123', inputData: { ... } });
209
+ + const run = await workflow.createRun({ runId: '123' });
210
+ + const stream = await run.stream({ inputData: { ... } });
211
+ ```
212
+
213
+ - 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))
214
+
215
+ ## 1.0.0-beta.9
216
+
217
+ ## 1.0.0-beta.8
218
+
219
+ ### Patch Changes
220
+
221
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
222
+
223
+ ```typescript
224
+ await workflow.deleteWorkflowRunById(runId);
225
+ ```
226
+
227
+ ## 1.0.0-beta.7
228
+
229
+ ### Patch Changes
230
+
231
+ - Fix default value showing on workflow form after user submits ([#10983](https://github.com/mastra-ai/mastra/pull/10983))
232
+
233
+ - Move useScorers down to trace page to trigger it once for all trace spans ([#10985](https://github.com/mastra-ai/mastra/pull/10985))
234
+
235
+ - 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))
236
+
237
+ - Fix workflow trigger form overflow ([#10986](https://github.com/mastra-ai/mastra/pull/10986))
238
+
239
+ ## 1.0.0-beta.6
240
+
241
+ ### Patch Changes
242
+
243
+ - Fix select options overflow when list is long by adding maximum height ([#10813](https://github.com/mastra-ai/mastra/pull/10813))
244
+
245
+ ## 1.0.0-beta.5
246
+
247
+ ### Patch Changes
248
+
249
+ - Fix discriminatedUnion schema information lost when json schema is converted to zod ([#10500](https://github.com/mastra-ai/mastra/pull/10500))
250
+
251
+ - Hide time travel on map steps in Studio ([#10631](https://github.com/mastra-ai/mastra/pull/10631))
252
+
253
+ ## 1.0.0-beta.4
254
+
255
+ ### Patch Changes
256
+
257
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
258
+
259
+ ## 1.0.0-beta.3
260
+
261
+ ### Patch Changes
262
+
263
+ - fix: detect bun runtime and cleanup on failure ([#10242](https://github.com/mastra-ai/mastra/pull/10242))
264
+
265
+ ## 1.0.0-beta.2
266
+
267
+ ### Patch Changes
268
+
269
+ - dependencies updates: ([#10111](https://github.com/mastra-ai/mastra/pull/10111))
270
+ - Updated dependency [`pino@^10.1.0` ↗︎](https://www.npmjs.com/package/pino/v/10.1.0) (from `^9.7.0`, in `dependencies`)
271
+
272
+ - dependencies updates: ([#9781](https://github.com/mastra-ai/mastra/pull/9781))
273
+ - Updated dependency [`posthog-node@^5.11.2` ↗︎](https://www.npmjs.com/package/posthog-node/v/5.11.2) (from `^4.18.0`, in `dependencies`)
274
+
275
+ - Fix scorer filtering for SpanScoring, add error and info message for user ([#10160](https://github.com/mastra-ai/mastra/pull/10160))
276
+
277
+ - Fix double scroll on agent chat container ([#10253](https://github.com/mastra-ai/mastra/pull/10253))
278
+
279
+ ## 1.0.0-beta.1
280
+
281
+ ### Patch Changes
282
+
283
+ - Make MainSidebar toggle button sticky to bottom, always visible ([#9682](https://github.com/mastra-ai/mastra/pull/9682))
284
+
285
+ ## 1.0.0-beta.0
286
+
287
+ ### Major Changes
288
+
289
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
290
+
291
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
292
+
293
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
294
+
295
+ ### Patch Changes
296
+
297
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9318](https://github.com/mastra-ai/mastra/pull/9318))
298
+
299
+ ## 0.17.3
300
+
301
+ ## 0.17.3-alpha.0
302
+
303
+ ## 0.17.2
304
+
305
+ ## 0.17.2-alpha.0
306
+
307
+ ## 0.17.1
308
+
309
+ ### Patch Changes
310
+
311
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
312
+
313
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
314
+
315
+ ## 0.17.1-alpha.1
316
+
317
+ ### Patch Changes
318
+
319
+ - Add scorers to the default weather agent in the create command. ([#9042](https://github.com/mastra-ai/mastra/pull/9042))
320
+
321
+ - Fix tool result in playground ([#9087](https://github.com/mastra-ai/mastra/pull/9087))
322
+
323
+ ## 0.17.1-alpha.0
324
+
325
+ ## 0.17.0
326
+
327
+ ### Patch Changes
328
+
329
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
330
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
331
+ - Have more control over the versions in the future to not have breakages over night
332
+
333
+ ## 0.17.0-alpha.0
334
+
335
+ ### Patch Changes
336
+
337
+ - Pin `@rollup/*` dependencies to fixed versions (instead of using `^`) to: ([#8900](https://github.com/mastra-ai/mastra/pull/8900))
338
+ - Hotfix a bug inside `@rollup/plugin-commonjs`
339
+ - Have more control over the versions in the future to not have breakages over night
340
+
341
+ ## 0.16.0
342
+
343
+ ### Patch Changes
344
+
345
+ - Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
346
+
347
+ - 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))
348
+
349
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
350
+
351
+ - Adds reset button to model picker to reset to original model set on the agent. ([#8633](https://github.com/mastra-ai/mastra/pull/8633))
352
+
353
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
354
+
355
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
356
+
357
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
358
+
359
+ - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
360
+
361
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
362
+
363
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
364
+
365
+ ## 0.16.0-alpha.1
366
+
367
+ ### Patch Changes
368
+
369
+ - 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))
370
+
371
+ - Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
372
+
373
+ - Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
374
+
375
+ - Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
376
+
377
+ - Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
378
+
379
+ - Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
380
+
381
+ - Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
382
+
383
+ ## 0.15.2-alpha.0
4
384
 
5
385
  ### Patch Changes
6
386
 
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).