@mastra/client-js 0.16.9 → 1.0.0-beta.1

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.
package/CHANGELOG.md CHANGED
@@ -1,108 +1,335 @@
1
1
  # @mastra/client-js
2
2
 
3
- ## 0.16.9
3
+ ## 1.0.0-beta.1
4
4
 
5
5
  ### Patch Changes
6
6
 
7
- - update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
7
+ - Fix clientTools execution in client js ([#9880](https://github.com/mastra-ai/mastra/pull/9880))
8
8
 
9
- - Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
9
+ - Updated dependencies [[`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d)]:
10
+ - @mastra/core@1.0.0-beta.1
10
11
 
11
- - Remove unused /model-providers API ([#9554](https://github.com/mastra-ai/mastra/pull/9554))
12
+ ## 1.0.0-beta.0
12
13
 
13
- - Fix undefined runtimeContext using memory from playground ([#9548](https://github.com/mastra-ai/mastra/pull/9548))
14
+ ### Major Changes
14
15
 
15
- - Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712)]:
16
- - @mastra/core@0.24.0
16
+ - Moving scorers under the eval domain, api method consistency, prebuilt evals, scorers require ids. ([#9589](https://github.com/mastra-ai/mastra/pull/9589))
17
17
 
18
- ## 0.16.9-alpha.0
18
+ - Update handlers to use `listWorkflowRuns` instead of `getWorkflowRuns`. Fix type names from `StoragelistThreadsByResourceIdInput/Output` to `StorageListThreadsByResourceIdInput/Output`. ([#9507](https://github.com/mastra-ai/mastra/pull/9507))
19
19
 
20
- ### Patch Changes
20
+ - **BREAKING:** Remove `getMessagesPaginated()` and add `perPage: false` support ([#9670](https://github.com/mastra-ai/mastra/pull/9670))
21
21
 
22
- - update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
22
+ Removes deprecated `getMessagesPaginated()` method. The `listMessages()` API and score handlers now support `perPage: false` to fetch all records without pagination limits.
23
23
 
24
- - Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
24
+ **Storage changes:**
25
+ - `StoragePagination.perPage` type changed from `number` to `number | false`
26
+ - All storage implementations support `perPage: false`:
27
+ - Memory: `listMessages()`
28
+ - Scores: `listScoresBySpan()`, `listScoresByRunId()`, `listScoresByExecutionId()`
29
+ - HTTP query parser accepts `"false"` string (e.g., `?perPage=false`)
25
30
 
26
- - Remove unused /model-providers API ([#9554](https://github.com/mastra-ai/mastra/pull/9554))
31
+ **Memory changes:**
32
+ - `memory.query()` parameter type changed from `StorageGetMessagesArg` to `StorageListMessagesInput`
33
+ - Uses flat parameters (`page`, `perPage`, `include`, `filter`, `vectorSearchString`) instead of `selectBy` object
27
34
 
28
- - Fix undefined runtimeContext using memory from playground ([#9548](https://github.com/mastra-ai/mastra/pull/9548))
35
+ **Stricter validation:**
36
+ - `listMessages()` requires non-empty, non-whitespace `threadId` (throws error instead of returning empty results)
29
37
 
30
- - Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712)]:
31
- - @mastra/core@0.24.0-alpha.0
38
+ **Migration:**
32
39
 
33
- ## 0.16.8
40
+ ```typescript
41
+ // Storage/Memory: Replace getMessagesPaginated with listMessages
42
+ - storage.getMessagesPaginated({ threadId, selectBy: { pagination: { page: 0, perPage: 20 } } })
43
+ + storage.listMessages({ threadId, page: 0, perPage: 20 })
44
+ + storage.listMessages({ threadId, page: 0, perPage: false }) // Fetch all
34
45
 
35
- ### Patch Changes
46
+ // Memory: Replace selectBy with flat parameters
47
+ - memory.query({ threadId, selectBy: { last: 20, include: [...] } })
48
+ + memory.query({ threadId, perPage: 20, include: [...] })
36
49
 
37
- - Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
50
+ // Client SDK
51
+ - thread.getMessagesPaginated({ selectBy: { pagination: { page: 0 } } })
52
+ + thread.listMessages({ page: 0, perPage: 20 })
53
+ ```
38
54
 
39
- - Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
55
+ - # Major Changes ([#9695](https://github.com/mastra-ai/mastra/pull/9695))
40
56
 
41
- - Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
42
- - @mastra/core@0.23.3
57
+ ## Storage Layer
43
58
 
44
- ## 0.16.8-alpha.0
59
+ ### BREAKING: Removed `storage.getMessages()`
45
60
 
46
- ### Patch Changes
61
+ The `getMessages()` method has been removed from all storage implementations. Use `listMessages()` instead, which provides pagination support.
47
62
 
48
- - Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
63
+ **Migration:**
49
64
 
50
- - Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
65
+ ```typescript
66
+ // Before
67
+ const messages = await storage.getMessages({ threadId: 'thread-1' });
51
68
 
52
- - Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
53
- - @mastra/core@0.23.3-alpha.0
69
+ // After
70
+ const result = await storage.listMessages({
71
+ threadId: 'thread-1',
72
+ page: 0,
73
+ perPage: 50,
74
+ });
75
+ const messages = result.messages; // Access messages array
76
+ console.log(result.total); // Total count
77
+ console.log(result.hasMore); // Whether more pages exist
78
+ ```
54
79
 
55
- ## 0.16.7
80
+ ### Message ordering default
56
81
 
57
- ### Patch Changes
82
+ `listMessages()` defaults to ASC (oldest first) ordering by `createdAt`, matching the previous `getMessages()` behavior.
58
83
 
59
- - Updated dependencies [[`f57a81e`](https://github.com/mastra-ai/mastra/commit/f57a81e6ce644e45bf1c9618778cc54c50a84ad4), [`2afd345`](https://github.com/mastra-ai/mastra/commit/2afd3450825b76e41f7973baddf13867ea042e40), [`fc79af3`](https://github.com/mastra-ai/mastra/commit/fc79af3915d1c456729cbd753673b0c0564340d8), [`eefc89e`](https://github.com/mastra-ai/mastra/commit/eefc89ee69f05bb71661473a807fc7dc03d56f17), [`60bd45d`](https://github.com/mastra-ai/mastra/commit/60bd45de021f0dfbe6583928f6da5169cb5585ba), [`a30093d`](https://github.com/mastra-ai/mastra/commit/a30093de98c1836dcd5dfddf09649010712b8c95), [`0fe7adb`](https://github.com/mastra-ai/mastra/commit/0fe7adb0f20f59a6bb41f235d01f8b7a880ea6e7), [`a42e496`](https://github.com/mastra-ai/mastra/commit/a42e49686a7486e2e9e9397fa98e5ff7a71dc1b0), [`3670db7`](https://github.com/mastra-ai/mastra/commit/3670db7e8e798f9d65fac5bfb732134a1f26ba7b), [`e40d4d0`](https://github.com/mastra-ai/mastra/commit/e40d4d0a0971b4505e7c9de73c656066c7565653), [`fc843ff`](https://github.com/mastra-ai/mastra/commit/fc843ff4d1d149317b6324553ce5ad7972062a78), [`ff16f9b`](https://github.com/mastra-ai/mastra/commit/ff16f9b9dbc701b26b6c4e9872f759f3880f9327), [`35e6cf7`](https://github.com/mastra-ai/mastra/commit/35e6cf722fef16ea0301eb9cf5a32fe9ccb12d22), [`30a2e36`](https://github.com/mastra-ai/mastra/commit/30a2e369485e0e59c4faa1d83c5635c2260b304c)]:
60
- - @mastra/core@0.23.2
84
+ **To use DESC ordering (newest first):**
61
85
 
62
- ## 0.16.7-alpha.1
86
+ ```typescript
87
+ const result = await storage.listMessages({
88
+ threadId: 'thread-1',
89
+ orderBy: { field: 'createdAt', direction: 'DESC' },
90
+ });
91
+ ```
63
92
 
64
- ### Patch Changes
93
+ ## Client SDK
65
94
 
66
- - Updated dependencies [[`f57a81e`](https://github.com/mastra-ai/mastra/commit/f57a81e6ce644e45bf1c9618778cc54c50a84ad4), [`fc79af3`](https://github.com/mastra-ai/mastra/commit/fc79af3915d1c456729cbd753673b0c0564340d8), [`60bd45d`](https://github.com/mastra-ai/mastra/commit/60bd45de021f0dfbe6583928f6da5169cb5585ba), [`a30093d`](https://github.com/mastra-ai/mastra/commit/a30093de98c1836dcd5dfddf09649010712b8c95), [`e40d4d0`](https://github.com/mastra-ai/mastra/commit/e40d4d0a0971b4505e7c9de73c656066c7565653), [`ff16f9b`](https://github.com/mastra-ai/mastra/commit/ff16f9b9dbc701b26b6c4e9872f759f3880f9327), [`35e6cf7`](https://github.com/mastra-ai/mastra/commit/35e6cf722fef16ea0301eb9cf5a32fe9ccb12d22), [`30a2e36`](https://github.com/mastra-ai/mastra/commit/30a2e369485e0e59c4faa1d83c5635c2260b304c)]:
67
- - @mastra/core@0.23.2-alpha.1
95
+ ### BREAKING: Renamed `client.getThreadMessages()` `client.listThreadMessages()`
68
96
 
69
- ## 0.16.7-alpha.0
97
+ **Migration:**
70
98
 
71
- ### Patch Changes
99
+ ```typescript
100
+ // Before
101
+ const response = await client.getThreadMessages(threadId, { agentId });
72
102
 
73
- - Updated dependencies [[`2afd345`](https://github.com/mastra-ai/mastra/commit/2afd3450825b76e41f7973baddf13867ea042e40), [`eefc89e`](https://github.com/mastra-ai/mastra/commit/eefc89ee69f05bb71661473a807fc7dc03d56f17), [`0fe7adb`](https://github.com/mastra-ai/mastra/commit/0fe7adb0f20f59a6bb41f235d01f8b7a880ea6e7), [`a42e496`](https://github.com/mastra-ai/mastra/commit/a42e49686a7486e2e9e9397fa98e5ff7a71dc1b0), [`3670db7`](https://github.com/mastra-ai/mastra/commit/3670db7e8e798f9d65fac5bfb732134a1f26ba7b), [`fc843ff`](https://github.com/mastra-ai/mastra/commit/fc843ff4d1d149317b6324553ce5ad7972062a78)]:
74
- - @mastra/core@0.23.2-alpha.0
103
+ // After
104
+ const response = await client.listThreadMessages(threadId, { agentId });
105
+ ```
75
106
 
76
- ## 0.16.6
107
+ The response format remains the same.
77
108
 
78
- ### Patch Changes
109
+ ## Type Changes
79
110
 
80
- - Fix peerdependencies ([`eb7c1c8`](https://github.com/mastra-ai/mastra/commit/eb7c1c8c592d8fb16dfd250e337d9cdc73c8d5de))
111
+ ### BREAKING: Removed `StorageGetMessagesArg` type
81
112
 
82
- - Updated dependencies []:
83
- - @mastra/core@0.23.1
113
+ Use `StorageListMessagesInput` instead:
84
114
 
85
- ## 0.16.5
115
+ ```typescript
116
+ // Before
117
+ import type { StorageGetMessagesArg } from '@mastra/core';
86
118
 
87
- ### Patch Changes
119
+ // After
120
+ import type { StorageListMessagesInput } from '@mastra/core';
121
+ ```
88
122
 
89
- - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
123
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
124
+
125
+ - Replace `getThreadsByResourceIdPaginated` with `listThreadsByResourceId` across memory handlers. Update client SDK to use `listThreads()` with `offset`/`limit` parameters instead of deprecated `getMemoryThreads()`. Consolidate `/api/memory/threads` routes to single paginated endpoint. ([#9508](https://github.com/mastra-ai/mastra/pull/9508))
126
+
127
+ - Rename RuntimeContext to RequestContext ([#9511](https://github.com/mastra-ai/mastra/pull/9511))
128
+
129
+ - Rename `defaultVNextStreamOptions` to `defaultOptions`. Add "Legacy" suffix to v1 option properties and methods (`defaultGenerateOptions` → `defaultGenerateOptionsLegacy`, `defaultStreamOptions` → `defaultStreamOptionsLegacy`). ([#9535](https://github.com/mastra-ai/mastra/pull/9535))
130
+
131
+ - Remove deprecated methods from client-js ([#9480](https://github.com/mastra-ai/mastra/pull/9480))
132
+
133
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
134
+
135
+ - **Breaking Change**: Remove legacy v1 watch events and consolidate on v2 implementation. ([#9252](https://github.com/mastra-ai/mastra/pull/9252))
136
+
137
+ This change simplifies the workflow watching API by removing the legacy v1 event system and promoting v2 as the standard (renamed to just `watch`).
138
+
139
+ ### What's Changed
140
+ - Removed legacy v1 watch event handlers and types
141
+ - Renamed `watch-v2` to `watch` throughout the codebase
142
+ - Removed `.watch()` method from client-js SDK (`Workflow` and `AgentBuilder` classes)
143
+ - Removed `/watch` HTTP endpoints from server and deployer
144
+ - Removed `WorkflowWatchResult` and v1 `WatchEvent` types
145
+
146
+ - **BREAKING CHANGE**: Pagination APIs now use `page`/`perPage` instead of `offset`/`limit` ([#9592](https://github.com/mastra-ai/mastra/pull/9592))
147
+
148
+ All storage and memory pagination APIs have been updated to use `page` (0-indexed) and `perPage` instead of `offset` and `limit`, aligning with standard REST API patterns.
149
+
150
+ **Affected APIs:**
151
+ - `Memory.listThreadsByResourceId()`
152
+ - `Memory.listMessages()`
153
+ - `Storage.listWorkflowRuns()`
154
+
155
+ **Migration:**
156
+
157
+ ```typescript
158
+ // Before
159
+ await memory.listThreadsByResourceId({
160
+ resourceId: 'user-123',
161
+ offset: 20,
162
+ limit: 10,
163
+ });
164
+
165
+ // After
166
+ await memory.listThreadsByResourceId({
167
+ resourceId: 'user-123',
168
+ page: 2, // page = Math.floor(offset / limit)
169
+ perPage: 10,
170
+ });
171
+
172
+ // Before
173
+ await memory.listMessages({
174
+ threadId: 'thread-456',
175
+ offset: 20,
176
+ limit: 10,
177
+ });
178
+
179
+ // After
180
+ await memory.listMessages({
181
+ threadId: 'thread-456',
182
+ page: 2,
183
+ perPage: 10,
184
+ });
185
+
186
+ // Before
187
+ await storage.listWorkflowRuns({
188
+ workflowName: 'my-workflow',
189
+ offset: 20,
190
+ limit: 10,
191
+ });
90
192
 
91
- - Fix error handling and serialization in agent streaming to ensure errors are consistently exposed and preserved. ([#9192](https://github.com/mastra-ai/mastra/pull/9192))
193
+ // After
194
+ await storage.listWorkflowRuns({
195
+ workflowName: 'my-workflow',
196
+ page: 2,
197
+ perPage: 10,
198
+ });
199
+ ```
92
200
 
93
- - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
94
- - @mastra/core@0.23.0
201
+ **Additional improvements:**
202
+ - Added validation for negative `page` values in all storage implementations
203
+ - Improved `perPage` validation to handle edge cases (negative values, `0`, `false`)
204
+ - Added reusable query parser utilities for consistent validation in handlers
95
205
 
96
- ## 0.16.5-alpha.0
206
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
207
+ import { Mastra } from '@mastra/core';
208
+ import { Observability } from '@mastra/observability'; // Explicit import
209
+
210
+ const mastra = new Mastra({
211
+ ...other_config,
212
+ observability: new Observability({
213
+ default: { enabled: true }
214
+ }) // Instance
215
+ });
216
+ ```
217
+
218
+ Instead of:
219
+
220
+ ```
221
+ import { Mastra } from '@mastra/core';
222
+ import '@mastra/observability/init'; // Explicit import
223
+
224
+ const mastra = new Mastra({
225
+ ...other_config,
226
+ observability: {
227
+ default: { enabled: true }
228
+ }
229
+ });
230
+ ```
231
+
232
+ Also renamed a bunch of:
233
+ - `Tracing` things to `Observability` things.
234
+ - `AI-` things to just things.
235
+
236
+ - Changing getAgents -> listAgents, getTools -> listTools, getWorkflows -> listWorkflows ([#9495](https://github.com/mastra-ai/mastra/pull/9495))
237
+
238
+ - Removed old tracing code based on OpenTelemetry ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
239
+
240
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
241
+
242
+ - Renamed `MastraMessageV2` to `MastraDBMessage` ([#9255](https://github.com/mastra-ai/mastra/pull/9255))
243
+ Made the return format of all methods that return db messages consistent. It's always `{ messages: MastraDBMessage[] }` now, and messages can be converted after that using `@mastra/ai-sdk/ui`'s `toAISdkV4/5Messages()` function
244
+
245
+ - moved ai-tracing code into @mastra/observability ([#9661](https://github.com/mastra-ai/mastra/pull/9661))
246
+
247
+ - Remove legacy evals from Mastra ([#9491](https://github.com/mastra-ai/mastra/pull/9491))
248
+
249
+ ### Minor Changes
250
+
251
+ - Add observeStream support for agent-builder template installation ([#9372](https://github.com/mastra-ai/mastra/pull/9372))
252
+ - Add observeStream, observeStreamVNext, observeStreamLegacy, and resumeStream methods to agent-builder client SDK
253
+ - Add corresponding server handlers and deployer routes for observe streaming
254
+ - Add tracingOptions parameter to existing agent-builder handlers for parity with workflows
255
+ - Update template installation processor to support both legacy and VNext streaming event formats
97
256
 
98
257
  ### Patch Changes
99
258
 
259
+ - Make step optional in all resume APIs ([#9454](https://github.com/mastra-ai/mastra/pull/9454))
260
+
261
+ - Update tool execution signature ([#9587](https://github.com/mastra-ai/mastra/pull/9587))
262
+
263
+ Consolidated the 3 different execution contexts to one
264
+
265
+ ```typescript
266
+ // before depending on the context the tool was executed in
267
+ tool.execute({ context: data });
268
+ tool.execute({ context: { inputData: data } });
269
+ tool.execute(data);
270
+
271
+ // now, for all contexts
272
+ tool.execute(data, context);
273
+ ```
274
+
275
+ **Before:**
276
+
277
+ ```typescript
278
+ inputSchema: z.object({ something: z.string() }),
279
+ execute: async ({ context, tracingContext, runId, ... }) => {
280
+ return doSomething(context.string);
281
+ }
282
+ ```
283
+
284
+ **After:**
285
+
286
+ ```typescript
287
+ inputSchema: z.object({ something: z.string() }),
288
+ execute: async (inputData, context) => {
289
+ const { agent, mcp, workflow, ...sharedContext } = context
290
+
291
+ // context that only an agent would get like toolCallId, messages, suspend, resume, etc
292
+ if (agent) {
293
+ doSomething(inputData.something, agent)
294
+ // context that only a workflow would get like runId, state, suspend, resume, etc
295
+ } else if (workflow) {
296
+ doSomething(inputData.something, workflow)
297
+ // context that only a workflow would get like "extra", "elicitation"
298
+ } else if (mcp) {
299
+ doSomething(inputData.something, mcp)
300
+ } else {
301
+ // Running a tool in no execution context
302
+ return doSomething(inputData.something);
303
+ }
304
+ }
305
+ ```
306
+
307
+ - Add search memory in client-js ([#9326](https://github.com/mastra-ai/mastra/pull/9326))
308
+
100
309
  - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
101
310
 
102
- - Fix error handling and serialization in agent streaming to ensure errors are consistently exposed and preserved. ([#9192](https://github.com/mastra-ai/mastra/pull/9192))
311
+ - Fix error handling and serialization in agent streaming to ensure errors are consistently exposed and preserved. ([#9144](https://github.com/mastra-ai/mastra/pull/9144))
312
+
313
+ - Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9481](https://github.com/mastra-ai/mastra/pull/9481))
314
+
315
+ - Move the enhance instruction fetch call to client-js ([#9302](https://github.com/mastra-ai/mastra/pull/9302))
316
+
317
+ - fix list memory ([#9751](https://github.com/mastra-ai/mastra/pull/9751))
318
+
319
+ - Remove unused /model-providers API ([#9533](https://github.com/mastra-ai/mastra/pull/9533))
320
+
321
+ - Backward compat for list threads ([#9758](https://github.com/mastra-ai/mastra/pull/9758))
322
+
323
+ - add client-js function to fetch model providers ([#9376](https://github.com/mastra-ai/mastra/pull/9376))
324
+
325
+ - Fix undefined runtimeContext using memory from playground ([#9328](https://github.com/mastra-ai/mastra/pull/9328))
326
+
327
+ - Make step optional in resumeStreamVNext API ([#9453](https://github.com/mastra-ai/mastra/pull/9453))
328
+
329
+ - Remove `waitForEvent` from workflows. `waitForEvent` is now removed, please use suspend & resume flow instead. See https://mastra.ai/en/docs/workflows/suspend-and-resume for more details on suspend & resume flow. ([#9214](https://github.com/mastra-ai/mastra/pull/9214))
103
330
 
104
- - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
105
- - @mastra/core@0.23.0-alpha.0
331
+ - Updated dependencies [[`39c9743`](https://github.com/mastra-ai/mastra/commit/39c97432d084294f8ba85fbf3ef28098ff21459e), [`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`0491e7c`](https://github.com/mastra-ai/mastra/commit/0491e7c9b714cb0ba22187ee062147ec2dd7c712), [`f6f4903`](https://github.com/mastra-ai/mastra/commit/f6f4903397314f73362061dc5a3e8e7c61ea34aa), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`2f897df`](https://github.com/mastra-ai/mastra/commit/2f897df208508f46f51b7625e5dd20c37f93e0e3), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`aaa40e7`](https://github.com/mastra-ai/mastra/commit/aaa40e788628b319baa8e889407d11ad626547fa), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`ca8041c`](https://github.com/mastra-ai/mastra/commit/ca8041cce0379fda22ed293a565bcb5b6ddca68a), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`903f67d`](https://github.com/mastra-ai/mastra/commit/903f67d184504a273893818c02b961f5423a79ad), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`398fde3`](https://github.com/mastra-ai/mastra/commit/398fde3f39e707cda79372cdae8f9870e3b57c8d), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`b2e45ec`](https://github.com/mastra-ai/mastra/commit/b2e45eca727a8db01a81ba93f1a5219c7183c839), [`d6d49f7`](https://github.com/mastra-ai/mastra/commit/d6d49f7b8714fa19a52ff9c7cf7fb7e73751901e), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`3f2faf2`](https://github.com/mastra-ai/mastra/commit/3f2faf2e2d685d6c053cc5af1bf9fedf267b2ce5), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`e59e0d3`](https://github.com/mastra-ai/mastra/commit/e59e0d32afb5fcf2c9f3c00c8f81f6c21d3a63fa), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
332
+ - @mastra/core@1.0.0-beta.0
106
333
 
107
334
  ## 0.16.4
108
335
 
package/README.md CHANGED
@@ -50,7 +50,7 @@ const client = new MastraClient({
50
50
 
51
51
  ### Agents
52
52
 
53
- - `getAgents()`: Get all available agents
53
+ - `listAgents()`: Get all available agents
54
54
  - `getAgent(agentId)`: Get a specific agent instance
55
55
  - `agent.details()`: Get agent details
56
56
  - `agent.generate(params)`: Generate a response
@@ -63,29 +63,27 @@ const client = new MastraClient({
63
63
 
64
64
  ### Memory
65
65
 
66
- - `getMemoryThreads(params)`: Get memory threads
66
+ - `listMemoryThreads(params)`: Get memory threads
67
67
  - `createMemoryThread(params)`: Create a new memory thread
68
- - `getMemoryThread(threadId)`: Get a memory thread instance
68
+ - `getMemoryThread({ threadId, agentId })`: Get a memory thread instance
69
69
  - `saveMessageToMemory(params)`: Save messages to memory
70
70
  - `getMemoryStatus()`: Get memory system status
71
71
 
72
72
  ### Tools
73
73
 
74
- - `getTools()`: Get all available tools
74
+ - `listTools()`: Get all available tools
75
75
  - `getTool(toolId)`: Get a tool instance
76
76
  - `tool.details()`: Get tool details
77
77
  - `tool.execute(params)`: Execute the tool
78
78
 
79
79
  ### Workflows
80
80
 
81
- - `getWorkflows()`: Get all workflows
81
+ - `listWorkflows()`: Get all workflows
82
82
  - `getWorkflow(workflowId)`: Get a workflow instance
83
83
  - `workflow.details()`: Get workflow details
84
- - `workflow.createRunAsync()`: Create workflow run
85
- - `workflow.createRun()`: Deprecated - use createRunAsync() instead
84
+ - `workflow.createRun()`: Create workflow run
86
85
  - `workflow.startAsync(params)`: Execute the workflow and wait for execution results
87
86
  - `workflow.resumeAsync(params)`: Resume suspended workflow step async
88
- - `workflow.watch({runId},(record)=>{})`: Watch the step transitions of the workflow run
89
87
  - `workflow.start({runId, triggerData})`: Start a workflow run sync
90
88
  - `workflow.resume(params)`: Resume the workflow run sync
91
89
 
@@ -101,9 +99,9 @@ const client = new MastraClient({
101
99
 
102
100
  ### Logs
103
101
 
104
- - `getLogs(params)`: Get system logs
102
+ - `listLogs(params)`: Get system logs
105
103
  - `getLog(params)`: Get specific log entry
106
- - `getLogTransports()`: Get configured Log transports
104
+ - `listLogTransports()`: Get configured Log transports
107
105
 
108
106
  ### Telemetry
109
107