@mastra/client-js 1.0.0-beta.2 → 1.0.0-beta.21

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 (51) hide show
  1. package/CHANGELOG.md +583 -0
  2. package/README.md +2 -0
  3. package/dist/_types/@ai-sdk_ui-utils/dist/index.d.ts +820 -0
  4. package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts +8511 -0
  5. package/dist/client.d.ts +67 -12
  6. package/dist/client.d.ts.map +1 -1
  7. package/dist/docs/README.md +33 -0
  8. package/dist/docs/SKILL.md +34 -0
  9. package/dist/docs/SOURCE_MAP.json +6 -0
  10. package/dist/docs/ai-sdk/01-reference.md +358 -0
  11. package/dist/docs/client-js/01-reference.md +1139 -0
  12. package/dist/docs/server/01-mastra-client.md +273 -0
  13. package/dist/docs/server/02-jwt.md +100 -0
  14. package/dist/docs/server/03-clerk.md +140 -0
  15. package/dist/docs/server/04-supabase.md +126 -0
  16. package/dist/docs/server/05-firebase.md +284 -0
  17. package/dist/docs/server/06-workos.md +199 -0
  18. package/dist/docs/server/07-auth0.md +231 -0
  19. package/dist/index.cjs +1718 -475
  20. package/dist/index.cjs.map +1 -1
  21. package/dist/index.js +1716 -469
  22. package/dist/index.js.map +1 -1
  23. package/dist/resources/a2a.d.ts.map +1 -1
  24. package/dist/resources/agent-builder.d.ts +13 -35
  25. package/dist/resources/agent-builder.d.ts.map +1 -1
  26. package/dist/resources/agent.d.ts +1 -1
  27. package/dist/resources/agent.d.ts.map +1 -1
  28. package/dist/resources/base.d.ts.map +1 -1
  29. package/dist/resources/index.d.ts +1 -0
  30. package/dist/resources/index.d.ts.map +1 -1
  31. package/dist/resources/memory-thread.d.ts +18 -3
  32. package/dist/resources/memory-thread.d.ts.map +1 -1
  33. package/dist/resources/observability.d.ts +58 -15
  34. package/dist/resources/observability.d.ts.map +1 -1
  35. package/dist/resources/run.d.ts +210 -0
  36. package/dist/resources/run.d.ts.map +1 -0
  37. package/dist/resources/stored-agent.d.ts +26 -0
  38. package/dist/resources/stored-agent.d.ts.map +1 -0
  39. package/dist/resources/workflow.d.ts +19 -161
  40. package/dist/resources/workflow.d.ts.map +1 -1
  41. package/dist/tools.d.ts +2 -2
  42. package/dist/tools.d.ts.map +1 -1
  43. package/dist/types.d.ts +171 -31
  44. package/dist/types.d.ts.map +1 -1
  45. package/dist/utils/index.d.ts +26 -0
  46. package/dist/utils/index.d.ts.map +1 -1
  47. package/dist/utils/process-mastra-stream.d.ts +1 -1
  48. package/dist/utils/process-mastra-stream.d.ts.map +1 -1
  49. package/dist/utils/zod-to-json-schema.d.ts +9 -1
  50. package/dist/utils/zod-to-json-schema.d.ts.map +1 -1
  51. package/package.json +15 -16
package/CHANGELOG.md CHANGED
@@ -1,5 +1,588 @@
1
1
  # @mastra/client-js
2
2
 
3
+ ## 1.0.0-beta.21
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`08766f1`](https://github.com/mastra-ai/mastra/commit/08766f15e13ac0692fde2a8bd366c2e16e4321df), [`ae8baf7`](https://github.com/mastra-ai/mastra/commit/ae8baf7d8adcb0ff9dac11880400452bc49b33ff), [`cfabdd4`](https://github.com/mastra-ai/mastra/commit/cfabdd4aae7a726b706942d6836eeca110fb6267), [`3bf08bf`](https://github.com/mastra-ai/mastra/commit/3bf08bf9c7c73818ac937b5a69d90e205653115f), [`a0e437f`](https://github.com/mastra-ai/mastra/commit/a0e437fac561b28ee719e0302d72b2f9b4c138f0), [`bec5efd`](https://github.com/mastra-ai/mastra/commit/bec5efde96653ccae6604e68c696d1bc6c1a0bf5), [`9eedf7d`](https://github.com/mastra-ai/mastra/commit/9eedf7de1d6e0022a2f4e5e9e6fe1ec468f9b43c)]:
8
+ - @mastra/core@1.0.0-beta.21
9
+ - @mastra/schema-compat@1.0.0-beta.6
10
+
11
+ ## 1.0.0-beta.20
12
+
13
+ ### Minor Changes
14
+
15
+ - Unified `getWorkflowRunById` and `getWorkflowRunExecutionResult` into a single API that returns `WorkflowState` with both metadata and execution state. ([#11429](https://github.com/mastra-ai/mastra/pull/11429))
16
+
17
+ **What changed:**
18
+ - `getWorkflowRunById` now returns a unified `WorkflowState` object containing metadata (runId, workflowName, resourceId, createdAt, updatedAt) along with processed execution state (status, result, error, payload, steps)
19
+ - Added optional `fields` parameter to request only specific fields for better performance
20
+ - Added optional `withNestedWorkflows` parameter to control nested workflow step inclusion
21
+ - Removed `getWorkflowRunExecutionResult` - use `getWorkflowRunById` instead (breaking change)
22
+ - Removed `/execution-result` API endpoints from server (breaking change)
23
+ - Removed `runExecutionResult()` method from client SDK (breaking change)
24
+ - Removed `GetWorkflowRunExecutionResultResponse` type from client SDK (breaking change)
25
+
26
+ **Before:**
27
+
28
+ ```typescript
29
+ // Had to call two different methods for different data
30
+ const run = await workflow.getWorkflowRunById(runId); // Returns raw WorkflowRun with snapshot
31
+ const result = await workflow.getWorkflowRunExecutionResult(runId); // Returns processed execution state
32
+ ```
33
+
34
+ **After:**
35
+
36
+ ```typescript
37
+ // Single method returns everything
38
+ const run = await workflow.getWorkflowRunById(runId);
39
+ // Returns: { runId, workflowName, resourceId, createdAt, updatedAt, status, result, error, payload, steps }
40
+
41
+ // Request only specific fields for better performance (avoids expensive step fetching)
42
+ const status = await workflow.getWorkflowRunById(runId, { fields: ['status'] });
43
+
44
+ // Skip nested workflow steps for faster response
45
+ const run = await workflow.getWorkflowRunById(runId, { withNestedWorkflows: false });
46
+ ```
47
+
48
+ **Why:** The previous API required calling two separate methods to get complete workflow run information. This unification simplifies the API surface and gives users control over performance - fetching all steps (especially nested workflows) can be expensive, so the `fields` and `withNestedWorkflows` options let users request only what they need.
49
+
50
+ ### Patch Changes
51
+
52
+ - Add embedded documentation support for Mastra packages ([#11472](https://github.com/mastra-ai/mastra/pull/11472))
53
+
54
+ Mastra packages now include embedded documentation in the published npm package under `dist/docs/`. This enables coding agents and AI assistants to understand and use the framework by reading documentation directly from `node_modules`.
55
+
56
+ Each package includes:
57
+ - **SKILL.md** - Entry point explaining the package's purpose and capabilities
58
+ - **SOURCE_MAP.json** - Machine-readable index mapping exports to types and implementation files
59
+ - **Topic folders** - Conceptual documentation organized by feature area
60
+
61
+ Documentation is driven by the `packages` frontmatter field in MDX files, which maps docs to their corresponding packages. CI validation ensures all docs include this field.
62
+
63
+ - Remove `streamVNext`, `resumeStreamVNext`, and `observeStreamVNext` methods, call `stream`, `resumeStream` and `observeStream` directly ([#11499](https://github.com/mastra-ai/mastra/pull/11499))
64
+
65
+ ```diff
66
+ + const run = await workflow.createRun({ runId: '123' });
67
+ - const stream = await run.streamVNext({ inputData: { ... } });
68
+ + const stream = await run.stream({ inputData: { ... } });
69
+ ```
70
+
71
+ - Add initial state input to workflow form in studio ([#11560](https://github.com/mastra-ai/mastra/pull/11560))
72
+
73
+ - Adds thread cloning to create independent copies of conversations that can diverge. ([#11517](https://github.com/mastra-ai/mastra/pull/11517))
74
+
75
+ ```typescript
76
+ // Clone a thread
77
+ const { thread, clonedMessages } = await memory.cloneThread({
78
+ sourceThreadId: 'thread-123',
79
+ title: 'My Clone',
80
+ options: {
81
+ messageLimit: 10, // optional: only copy last N messages
82
+ },
83
+ });
84
+
85
+ // Check if a thread is a clone
86
+ if (memory.isClone(thread)) {
87
+ const source = await memory.getSourceThread(thread.id);
88
+ }
89
+
90
+ // List all clones of a thread
91
+ const clones = await memory.listClones('thread-123');
92
+ ```
93
+
94
+ Includes:
95
+ - Storage implementations for InMemory, PostgreSQL, LibSQL, Upstash
96
+ - API endpoint: `POST /api/memory/threads/:threadId/clone`
97
+ - Embeddings created for cloned messages (semantic recall)
98
+ - Clone button in playground UI Memory tab
99
+
100
+ - Make agentId optional for memory read operations (getThread, listThreads, listMessages) ([#11540](https://github.com/mastra-ai/mastra/pull/11540))
101
+
102
+ When workflows use multiple agents sharing the same threadId/resourceId, users can now retrieve threads and messages without specifying an agentId. The server falls back to using storage directly when agentId is not provided.
103
+
104
+ - Updated dependencies [[`d2d3e22`](https://github.com/mastra-ai/mastra/commit/d2d3e22a419ee243f8812a84e3453dd44365ecb0), [`bc72b52`](https://github.com/mastra-ai/mastra/commit/bc72b529ee4478fe89ecd85a8be47ce0127b82a0), [`05b8bee`](https://github.com/mastra-ai/mastra/commit/05b8bee9e50e6c2a4a2bf210eca25ee212ca24fa), [`c042bd0`](https://github.com/mastra-ai/mastra/commit/c042bd0b743e0e86199d0cb83344ca7690e34a9c), [`940a2b2`](https://github.com/mastra-ai/mastra/commit/940a2b27480626ed7e74f55806dcd2181c1dd0c2), [`e0941c3`](https://github.com/mastra-ai/mastra/commit/e0941c3d7fc75695d5d258e7008fd5d6e650800c), [`0c0580a`](https://github.com/mastra-ai/mastra/commit/0c0580a42f697cd2a7d5973f25bfe7da9055038a), [`28f5f89`](https://github.com/mastra-ai/mastra/commit/28f5f89705f2409921e3c45178796c0e0d0bbb64), [`e601b27`](https://github.com/mastra-ai/mastra/commit/e601b272c70f3a5ecca610373aa6223012704892), [`3d3366f`](https://github.com/mastra-ai/mastra/commit/3d3366f31683e7137d126a3a57174a222c5801fb), [`5a4953f`](https://github.com/mastra-ai/mastra/commit/5a4953f7d25bb15ca31ed16038092a39cb3f98b3), [`eb9e522`](https://github.com/mastra-ai/mastra/commit/eb9e522ce3070a405e5b949b7bf5609ca51d7fe2), [`20e6f19`](https://github.com/mastra-ai/mastra/commit/20e6f1971d51d3ff6dd7accad8aaaae826d540ed), [`4f0b3c6`](https://github.com/mastra-ai/mastra/commit/4f0b3c66f196c06448487f680ccbb614d281e2f7), [`74c4f22`](https://github.com/mastra-ai/mastra/commit/74c4f22ed4c71e72598eacc346ba95cdbc00294f), [`81b6a8f`](https://github.com/mastra-ai/mastra/commit/81b6a8ff79f49a7549d15d66624ac1a0b8f5f971), [`e4d366a`](https://github.com/mastra-ai/mastra/commit/e4d366aeb500371dd4210d6aa8361a4c21d87034), [`a4f010b`](https://github.com/mastra-ai/mastra/commit/a4f010b22e4355a5fdee70a1fe0f6e4a692cc29e), [`73b0bb3`](https://github.com/mastra-ai/mastra/commit/73b0bb394dba7c9482eb467a97ab283dbc0ef4db), [`5627a8c`](https://github.com/mastra-ai/mastra/commit/5627a8c6dc11fe3711b3fa7a6ffd6eb34100a306), [`3ff45d1`](https://github.com/mastra-ai/mastra/commit/3ff45d10e0c80c5335a957ab563da72feb623520), [`251df45`](https://github.com/mastra-ai/mastra/commit/251df4531407dfa46d805feb40ff3fb49769f455), [`f894d14`](https://github.com/mastra-ai/mastra/commit/f894d148946629af7b1f452d65a9cf864cec3765), [`c2b9547`](https://github.com/mastra-ai/mastra/commit/c2b9547bf435f56339f23625a743b2147ab1c7a6), [`580b592`](https://github.com/mastra-ai/mastra/commit/580b5927afc82fe460dfdf9a38a902511b6b7e7f), [`58e3931`](https://github.com/mastra-ai/mastra/commit/58e3931af9baa5921688566210f00fb0c10479fa), [`08bb631`](https://github.com/mastra-ai/mastra/commit/08bb631ae2b14684b2678e3549d0b399a6f0561e), [`4fba91b`](https://github.com/mastra-ai/mastra/commit/4fba91bec7c95911dc28e369437596b152b04cd0), [`12b0cc4`](https://github.com/mastra-ai/mastra/commit/12b0cc4077d886b1a552637dedb70a7ade93528c)]:
105
+ - @mastra/core@1.0.0-beta.20
106
+
107
+ ## 1.0.0-beta.19
108
+
109
+ ### Patch Changes
110
+
111
+ - Updated dependencies [[`e54953e`](https://github.com/mastra-ai/mastra/commit/e54953ed8ce1b28c0d62a19950163039af7834b4), [`7d56d92`](https://github.com/mastra-ai/mastra/commit/7d56d9213886e8353956d7d40df10045fd12b299), [`fdac646`](https://github.com/mastra-ai/mastra/commit/fdac646033a0930a1a4e00d13aa64c40bb7f1e02), [`d07b568`](https://github.com/mastra-ai/mastra/commit/d07b5687819ea8cb1dffa776d0c1765faf4aa1ae), [`70b300e`](https://github.com/mastra-ai/mastra/commit/70b300ebc631dfc0aa14e61547fef7994adb4ea6), [`68ec97d`](https://github.com/mastra-ai/mastra/commit/68ec97d4c07c6393fcf95c2481fc5d73da99f8c8), [`4aa55b3`](https://github.com/mastra-ai/mastra/commit/4aa55b383cf06043943359ea316572fd969861a7)]:
112
+ - @mastra/core@1.0.0-beta.19
113
+ - @mastra/schema-compat@1.0.0-beta.5
114
+
115
+ ## 1.0.0-beta.18
116
+
117
+ ### Patch Changes
118
+
119
+ - Updated dependencies [[`5947fcd`](https://github.com/mastra-ai/mastra/commit/5947fcdd425531f29f9422026d466c2ee3113c93)]:
120
+ - @mastra/core@1.0.0-beta.18
121
+
122
+ ## 1.0.0-beta.17
123
+
124
+ ### Patch Changes
125
+
126
+ - Updated dependencies [[`b5dc973`](https://github.com/mastra-ai/mastra/commit/b5dc9733a5158850298dfb103acb3babdba8a318), [`af56599`](https://github.com/mastra-ai/mastra/commit/af56599d73244ae3bf0d7bcade656410f8ded37b)]:
127
+ - @mastra/core@1.0.0-beta.17
128
+ - @mastra/schema-compat@1.0.0-beta.4
129
+
130
+ ## 1.0.0-beta.16
131
+
132
+ ### Patch Changes
133
+
134
+ - Add `cancel()` method as an alias for `cancelRun()` in the Run class. The new method provides a more concise API while maintaining backward compatibility. Includes comprehensive documentation about abort signals and how steps can respond to cancellation. ([#11417](https://github.com/mastra-ai/mastra/pull/11417))
135
+
136
+ - Updated dependencies [[`3d93a15`](https://github.com/mastra-ai/mastra/commit/3d93a15796b158c617461c8b98bede476ebb43e2), [`efe406a`](https://github.com/mastra-ai/mastra/commit/efe406a1353c24993280ebc2ed61dd9f65b84b26), [`119e5c6`](https://github.com/mastra-ai/mastra/commit/119e5c65008f3e5cfca954eefc2eb85e3bf40da4), [`74e504a`](https://github.com/mastra-ai/mastra/commit/74e504a3b584eafd2f198001c6a113bbec589fd3), [`e33fdbd`](https://github.com/mastra-ai/mastra/commit/e33fdbd07b33920d81e823122331b0c0bee0bb59), [`929f69c`](https://github.com/mastra-ai/mastra/commit/929f69c3436fa20dd0f0e2f7ebe8270bd82a1529), [`8a73529`](https://github.com/mastra-ai/mastra/commit/8a73529ca01187f604b1f3019d0a725ac63ae55f)]:
137
+ - @mastra/core@1.0.0-beta.16
138
+
139
+ ## 1.0.0-beta.15
140
+
141
+ ### Minor Changes
142
+
143
+ - Unified observability schema with entity-based span identification ([#11132](https://github.com/mastra-ai/mastra/pull/11132))
144
+
145
+ ## What changed
146
+
147
+ Spans now use a unified identification model with `entityId`, `entityType`, and `entityName` instead of separate `agentId`, `toolId`, `workflowId` fields.
148
+
149
+ **Before:**
150
+
151
+ ```typescript
152
+ // Old span structure
153
+ span.agentId; // 'my-agent'
154
+ span.toolId; // undefined
155
+ span.workflowId; // undefined
156
+ ```
157
+
158
+ **After:**
159
+
160
+ ```typescript
161
+ // New span structure
162
+ span.entityType; // EntityType.AGENT
163
+ span.entityId; // 'my-agent'
164
+ span.entityName; // 'My Agent'
165
+ ```
166
+
167
+ ## New `listTraces()` API
168
+
169
+ Query traces with filtering, pagination, and sorting:
170
+
171
+ ```typescript
172
+ const { spans, pagination } = await storage.listTraces({
173
+ filters: {
174
+ entityType: EntityType.AGENT,
175
+ entityId: 'my-agent',
176
+ userId: 'user-123',
177
+ environment: 'production',
178
+ status: TraceStatus.SUCCESS,
179
+ startedAt: { start: new Date('2024-01-01'), end: new Date('2024-01-31') },
180
+ },
181
+ pagination: { page: 0, perPage: 50 },
182
+ orderBy: { field: 'startedAt', direction: 'DESC' },
183
+ });
184
+ ```
185
+
186
+ **Available filters:** date ranges (`startedAt`, `endedAt`), entity (`entityType`, `entityId`, `entityName`), identity (`userId`, `organizationId`), correlation IDs (`runId`, `sessionId`, `threadId`), deployment (`environment`, `source`, `serviceName`), `tags`, `metadata`, and `status`.
187
+
188
+ ## New retrieval methods
189
+ - `getSpan({ traceId, spanId })` - Get a single span
190
+ - `getRootSpan({ traceId })` - Get the root span of a trace
191
+ - `getTrace({ traceId })` - Get all spans for a trace
192
+
193
+ ## Backward compatibility
194
+
195
+ The legacy `getTraces()` method continues to work. When you pass `name: "agent run: my-agent"`, it automatically transforms to `entityId: "my-agent", entityType: AGENT`.
196
+
197
+ ## Migration
198
+
199
+ **Automatic:** SQL-based stores (PostgreSQL, LibSQL, MSSQL) automatically add new columns to existing `spans` tables on initialization. Existing data is preserved with new columns set to `NULL`.
200
+
201
+ **No action required:** Your existing code continues to work. Adopt the new fields and `listTraces()` API at your convenience.
202
+
203
+ ### Patch Changes
204
+
205
+ - Add debugger-like click-through UI to workflow graph ([#11350](https://github.com/mastra-ai/mastra/pull/11350))
206
+
207
+ - Add `getSystemPackages()` method to retrieve installed Mastra packages and their versions from the server ([#11211](https://github.com/mastra-ai/mastra/pull/11211))
208
+
209
+ - Fix error parsing json body for reset agent endpoint ([#11379](https://github.com/mastra-ai/mastra/pull/11379))
210
+
211
+ - Updated dependencies [[`33a4d2e`](https://github.com/mastra-ai/mastra/commit/33a4d2e4ed8af51f69256232f00c34d6b6b51d48), [`4aaa844`](https://github.com/mastra-ai/mastra/commit/4aaa844a4f19d054490f43638a990cc57bda8d2f), [`4a1a6cb`](https://github.com/mastra-ai/mastra/commit/4a1a6cb3facad54b2bb6780b00ce91d6de1edc08), [`31d13d5`](https://github.com/mastra-ai/mastra/commit/31d13d5fdc2e2380e2e3ee3ec9fb29d2a00f265d), [`4c62166`](https://github.com/mastra-ai/mastra/commit/4c621669f4a29b1f443eca3ba70b814afa286266), [`7bcbf10`](https://github.com/mastra-ai/mastra/commit/7bcbf10133516e03df964b941f9a34e9e4ab4177), [`4353600`](https://github.com/mastra-ai/mastra/commit/43536005a65988a8eede236f69122e7f5a284ba2), [`6986fb0`](https://github.com/mastra-ai/mastra/commit/6986fb064f5db6ecc24aa655e1d26529087b43b3), [`053e979`](https://github.com/mastra-ai/mastra/commit/053e9793b28e970086b0507f7f3b76ea32c1e838), [`e26dc9c`](https://github.com/mastra-ai/mastra/commit/e26dc9c3ccfec54ae3dc3e2b2589f741f9ae60a6), [`55edf73`](https://github.com/mastra-ai/mastra/commit/55edf7302149d6c964fbb7908b43babfc2b52145), [`27c0009`](https://github.com/mastra-ai/mastra/commit/27c0009777a6073d7631b0eb7b481d94e165b5ca), [`dee388d`](https://github.com/mastra-ai/mastra/commit/dee388dde02f2e63c53385ae69252a47ab6825cc), [`3f3fc30`](https://github.com/mastra-ai/mastra/commit/3f3fc3096f24c4a26cffeecfe73085928f72aa63), [`d90ea65`](https://github.com/mastra-ai/mastra/commit/d90ea6536f7aa51c6545a4e9215b55858e98e16d), [`d171e55`](https://github.com/mastra-ai/mastra/commit/d171e559ead9f52ec728d424844c8f7b164c4510), [`10c2735`](https://github.com/mastra-ai/mastra/commit/10c27355edfdad1ee2b826b897df74125eb81fb8), [`1924cf0`](https://github.com/mastra-ai/mastra/commit/1924cf06816e5e4d4d5333065ec0f4bb02a97799), [`b339816`](https://github.com/mastra-ai/mastra/commit/b339816df0984d0243d944ac2655d6ba5f809cde)]:
212
+ - @mastra/core@1.0.0-beta.15
213
+
214
+ ## 1.0.0-beta.14
215
+
216
+ ### Patch Changes
217
+
218
+ - feat: Add field filtering and nested workflow control to workflow execution result endpoint ([#11246](https://github.com/mastra-ai/mastra/pull/11246))
219
+
220
+ Adds two optional query parameters to `/api/workflows/:workflowId/runs/:runId/execution-result` endpoint:
221
+ - `fields`: Request only specific fields (e.g., `status`, `result`, `error`)
222
+ - `withNestedWorkflows`: Control whether to fetch nested workflow data
223
+
224
+ This significantly reduces response payload size and improves response times for large workflows.
225
+
226
+ ## Server Endpoint Usage
227
+
228
+ ```http
229
+ # Get only status (minimal payload - fastest)
230
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status
231
+
232
+ # Get status and result
233
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status,result
234
+
235
+ # Get all fields but without nested workflow data (faster)
236
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?withNestedWorkflows=false
237
+
238
+ # Get only specific fields without nested workflow data
239
+ GET /api/workflows/:workflowId/runs/:runId/execution-result?fields=status,steps&withNestedWorkflows=false
240
+
241
+ # Get full data (default behavior)
242
+ GET /api/workflows/:workflowId/runs/:runId/execution-result
243
+ ```
244
+
245
+ ## Client SDK Usage
246
+
247
+ ```typescript
248
+ import { MastraClient } from '@mastra/client-js';
249
+
250
+ const client = new MastraClient({ baseUrl: 'http://localhost:4111' });
251
+ const workflow = client.getWorkflow('myWorkflow');
252
+
253
+ // Get only status (minimal payload - fastest)
254
+ const statusOnly = await workflow.runExecutionResult(runId, {
255
+ fields: ['status'],
256
+ });
257
+ console.log(statusOnly.status); // 'success' | 'failed' | 'running' | etc.
258
+
259
+ // Get status and result
260
+ const statusAndResult = await workflow.runExecutionResult(runId, {
261
+ fields: ['status', 'result'],
262
+ });
263
+
264
+ // Get all fields but without nested workflow data (faster)
265
+ const resultWithoutNested = await workflow.runExecutionResult(runId, {
266
+ withNestedWorkflows: false,
267
+ });
268
+
269
+ // Get specific fields without nested workflow data
270
+ const optimized = await workflow.runExecutionResult(runId, {
271
+ fields: ['status', 'steps'],
272
+ withNestedWorkflows: false,
273
+ });
274
+
275
+ // Get full execution result (default behavior)
276
+ const fullResult = await workflow.runExecutionResult(runId);
277
+ ```
278
+
279
+ ## Core API Changes
280
+
281
+ The `Workflow.getWorkflowRunExecutionResult` method now accepts an options object:
282
+
283
+ ```typescript
284
+ await workflow.getWorkflowRunExecutionResult(runId, {
285
+ withNestedWorkflows: false, // default: true, set to false to skip nested workflow data
286
+ fields: ['status', 'result'], // optional field filtering
287
+ });
288
+ ```
289
+
290
+ ## Inngest Compatibility
291
+
292
+ The `@mastra/inngest` package has been updated to use the new options object API. This is a non-breaking internal change - no action required from inngest workflow users.
293
+
294
+ ## Performance Impact
295
+
296
+ For workflows with large step outputs:
297
+ - Requesting only `status`: ~99% reduction in payload size
298
+ - Requesting `status,result,error`: ~95% reduction in payload size
299
+ - Using `withNestedWorkflows=false`: Avoids expensive nested workflow data fetching
300
+ - Combining both: Maximum performance optimization
301
+
302
+ - Fix delayed promises rejecting when stream suspends on tool-call-approval ([#11278](https://github.com/mastra-ai/mastra/pull/11278))
303
+
304
+ When a stream ends in suspended state (e.g., requiring tool approval), the delayed promises like `toolResults`, `toolCalls`, `text`, etc. now resolve with partial results instead of rejecting with an error. This allows consumers to access data that was produced before the suspension.
305
+
306
+ Also improves generic type inference for `LLMStepResult` and related types throughout the streaming infrastructure.
307
+
308
+ - Updated dependencies [[`4f94ed8`](https://github.com/mastra-ai/mastra/commit/4f94ed8177abfde3ec536e3574883e075423350c), [`ac3cc23`](https://github.com/mastra-ai/mastra/commit/ac3cc2397d1966bc0fc2736a223abc449d3c7719), [`a86f4df`](https://github.com/mastra-ai/mastra/commit/a86f4df0407311e0d2ea49b9a541f0938810d6a9), [`029540c`](https://github.com/mastra-ai/mastra/commit/029540ca1e582fc2dd8d288ecd4a9b0f31a954ef), [`66741d1`](https://github.com/mastra-ai/mastra/commit/66741d1a99c4f42cf23a16109939e8348ac6852e), [`01b20fe`](https://github.com/mastra-ai/mastra/commit/01b20fefb7c67c2b7d79417598ef4e60256d1225), [`0dbf199`](https://github.com/mastra-ai/mastra/commit/0dbf199110f22192ce5c95b1c8148d4872b4d119), [`a7ce182`](https://github.com/mastra-ai/mastra/commit/a7ce1822a8785ce45d62dd5c911af465e144f7d7)]:
309
+ - @mastra/core@1.0.0-beta.14
310
+
311
+ ## 1.0.0-beta.13
312
+
313
+ ### Patch Changes
314
+
315
+ - Updated dependencies [[`919a22b`](https://github.com/mastra-ai/mastra/commit/919a22b25876f9ed5891efe5facbe682c30ff497)]:
316
+ - @mastra/core@1.0.0-beta.13
317
+
318
+ ## 1.0.0-beta.12
319
+
320
+ ### Patch Changes
321
+
322
+ - Embed AI types to fix peerdeps mismatches ([`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808))
323
+
324
+ - Add resourceId to workflow routes ([#11166](https://github.com/mastra-ai/mastra/pull/11166))
325
+
326
+ - 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))
327
+ With this change, run methods cannot be called directly on workflow instance anymore
328
+
329
+ ```diff
330
+ - const result = await workflow.stream({ runId: '123', inputData: { ... } });
331
+ + const run = await workflow.createRun({ runId: '123' });
332
+ + const stream = await run.stream({ inputData: { ... } });
333
+ ```
334
+
335
+ - Deserialize workflow errors on the client side ([#10992](https://github.com/mastra-ai/mastra/pull/10992))
336
+
337
+ When workflows fail, the server sends error data as JSON over HTTP. This change deserializes those errors back to proper `Error` instances on the client.
338
+
339
+ **Before:**
340
+
341
+ ```typescript
342
+ const result = await workflow.startAsync({ input });
343
+ if (result.status === 'failed') {
344
+ // result.error was a plain object, couldn't use instanceof
345
+ console.log(result.error.message); // TypeScript error
346
+ }
347
+ ```
348
+
349
+ **After:**
350
+
351
+ ```typescript
352
+ const result = await workflow.startAsync({ input });
353
+ if (result.status === 'failed') {
354
+ // result.error is now a proper Error instance
355
+ if (result.error instanceof MyCustomError) {
356
+ console.log(result.error.statusCode); // Works!
357
+ }
358
+ }
359
+ ```
360
+
361
+ This enables proper error handling and type checking in client applications, allowing developers to implement error-specific recovery logic based on custom error types and properties.
362
+
363
+ Features:
364
+ - `instanceof Error` checks
365
+ - Access to `error.message`, `error.name`, `error.stack`
366
+ - Preservation of custom error properties (e.g., `statusCode`, `responseHeaders`)
367
+ - Nested error tracking via `error.cause`
368
+
369
+ Affected methods:
370
+ - `startAsync()`
371
+ - `resumeAsync()`
372
+ - `restartAsync()`
373
+ - `timeTravelAsync()`
374
+
375
+ - Add missing status parameter to workflow.runs() method ([#11095](https://github.com/mastra-ai/mastra/pull/11095))
376
+
377
+ The `status` parameter was supported by the server API but was missing from the TypeScript types in @mastra/client-js.
378
+
379
+ Now you can filter workflow runs by status:
380
+
381
+ ```typescript
382
+ // Get only running workflows
383
+ const runningRuns = await workflow.runs({ status: 'running' });
384
+
385
+ // Get completed workflows
386
+ const completedRuns = await workflow.runs({ status: 'success' });
387
+ ```
388
+
389
+ - Updated dependencies [[`d5ed981`](https://github.com/mastra-ai/mastra/commit/d5ed981c8701c1b8a27a5f35a9a2f7d9244e695f), [`9650cce`](https://github.com/mastra-ai/mastra/commit/9650cce52a1d917ff9114653398e2a0f5c3ba808), [`932d63d`](https://github.com/mastra-ai/mastra/commit/932d63dd51be9c8bf1e00e3671fe65606c6fb9cd), [`b760b73`](https://github.com/mastra-ai/mastra/commit/b760b731aca7c8a3f041f61d57a7f125ae9cb215), [`695a621`](https://github.com/mastra-ai/mastra/commit/695a621528bdabeb87f83c2277cf2bb084c7f2b4), [`2b459f4`](https://github.com/mastra-ai/mastra/commit/2b459f466fd91688eeb2a44801dc23f7f8a887ab), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`24b76d8`](https://github.com/mastra-ai/mastra/commit/24b76d8e17656269c8ed09a0c038adb9cc2ae95a), [`243a823`](https://github.com/mastra-ai/mastra/commit/243a8239c5906f5c94e4f78b54676793f7510ae3), [`486352b`](https://github.com/mastra-ai/mastra/commit/486352b66c746602b68a95839f830de14c7fb8c0), [`c61fac3`](https://github.com/mastra-ai/mastra/commit/c61fac3add96f0dcce0208c07415279e2537eb62), [`6f14f70`](https://github.com/mastra-ai/mastra/commit/6f14f706ccaaf81b69544b6c1b75ab66a41e5317), [`09e4bae`](https://github.com/mastra-ai/mastra/commit/09e4bae18dd5357d2ae078a4a95a2af32168ab08), [`4524734`](https://github.com/mastra-ai/mastra/commit/45247343e384717a7c8404296275c56201d6470f), [`2a53598`](https://github.com/mastra-ai/mastra/commit/2a53598c6d8cfeb904a7fc74e57e526d751c8fa6), [`c7cd3c7`](https://github.com/mastra-ai/mastra/commit/c7cd3c7a187d7aaf79e2ca139de328bf609a14b4), [`847c212`](https://github.com/mastra-ai/mastra/commit/847c212caba7df0d6f2fc756b494ac3c75c3720d), [`6f941c4`](https://github.com/mastra-ai/mastra/commit/6f941c438ca5f578619788acc7608fc2e23bd176)]:
390
+ - @mastra/core@1.0.0-beta.12
391
+ - @mastra/schema-compat@1.0.0-beta.3
392
+
393
+ ## 1.0.0-beta.11
394
+
395
+ ### Patch Changes
396
+
397
+ - Support new Workflow tripwire run status. Tripwires that are thrown from within a workflow will now bubble up and return a graceful state with information about tripwires. ([#10947](https://github.com/mastra-ai/mastra/pull/10947))
398
+
399
+ When a workflow contains an agent step that triggers a tripwire, the workflow returns with `status: 'tripwire'` and includes tripwire details:
400
+
401
+ ```typescript showLineNumbers copy
402
+ const run = await workflow.createRun();
403
+ const result = await run.start({ inputData: { message: 'Hello' } });
404
+
405
+ if (result.status === 'tripwire') {
406
+ console.log('Workflow terminated by tripwire:', result.tripwire?.reason);
407
+ console.log('Processor ID:', result.tripwire?.processorId);
408
+ console.log('Retry requested:', result.tripwire?.retry);
409
+ }
410
+ ```
411
+
412
+ Adds new UI state for tripwire in agent chat and workflow UI.
413
+
414
+ This is distinct from `status: 'failed'` which indicates an unexpected error. A tripwire status means a processor intentionally stopped execution (e.g., for content moderation).
415
+
416
+ - Updated dependencies [[`38380b6`](https://github.com/mastra-ai/mastra/commit/38380b60fca905824bdf6b43df307a58efb1aa15), [`798d0c7`](https://github.com/mastra-ai/mastra/commit/798d0c740232653b1d754870e6b43a55c364ffe2), [`ffe84d5`](https://github.com/mastra-ai/mastra/commit/ffe84d54f3b0f85167fe977efd027dba027eb998), [`2c212e7`](https://github.com/mastra-ai/mastra/commit/2c212e704c90e2db83d4109e62c03f0f6ebd2667), [`4ca4306`](https://github.com/mastra-ai/mastra/commit/4ca430614daa5fa04730205a302a43bf4accfe9f), [`3bf6c5f`](https://github.com/mastra-ai/mastra/commit/3bf6c5f104c25226cd84e0c77f9dec15f2cac2db)]:
417
+ - @mastra/core@1.0.0-beta.11
418
+
419
+ ## 1.0.0-beta.10
420
+
421
+ ### Patch Changes
422
+
423
+ - Add delete workflow run API ([#10991](https://github.com/mastra-ai/mastra/pull/10991))
424
+
425
+ ```typescript
426
+ await workflow.deleteWorkflowRunById(runId);
427
+ ```
428
+
429
+ - Updated dependencies [[`edb07e4`](https://github.com/mastra-ai/mastra/commit/edb07e49283e0c28bd094a60e03439bf6ecf0221), [`b7e17d3`](https://github.com/mastra-ai/mastra/commit/b7e17d3f5390bb5a71efc112204413656fcdc18d), [`261473a`](https://github.com/mastra-ai/mastra/commit/261473ac637e633064a22076671e2e02b002214d), [`5d7000f`](https://github.com/mastra-ai/mastra/commit/5d7000f757cd65ea9dc5b05e662fd83dfd44e932), [`4f0331a`](https://github.com/mastra-ai/mastra/commit/4f0331a79bf6eb5ee598a5086e55de4b5a0ada03), [`8a000da`](https://github.com/mastra-ai/mastra/commit/8a000da0c09c679a2312f6b3aa05b2ca78ca7393)]:
430
+ - @mastra/core@1.0.0-beta.10
431
+
432
+ ## 1.0.0-beta.9
433
+
434
+ ### Patch Changes
435
+
436
+ - Fix `saveMessageToMemory` return type to match API response. The method now correctly returns `{ messages: (MastraMessageV1 | MastraDBMessage)[] }` instead of `(MastraMessageV1 | MastraDBMessage)[]` to align with the server endpoint response schema. ([#10996](https://github.com/mastra-ai/mastra/pull/10996))
437
+
438
+ - Updated dependencies [[`72df8ae`](https://github.com/mastra-ai/mastra/commit/72df8ae595584cdd7747d5c39ffaca45e4507227), [`9198899`](https://github.com/mastra-ai/mastra/commit/91988995c427b185c33714b7f3be955367911324), [`653e65a`](https://github.com/mastra-ai/mastra/commit/653e65ae1f9502c2958a32f47a5a2df11e612a92), [`c6fd6fe`](https://github.com/mastra-ai/mastra/commit/c6fd6fedd09e9cf8004b03a80925f5e94826ad7e), [`0bed332`](https://github.com/mastra-ai/mastra/commit/0bed332843f627202c6520eaf671771313cd20f3)]:
439
+ - @mastra/core@1.0.0-beta.9
440
+
441
+ ## 1.0.0-beta.8
442
+
443
+ ### Patch Changes
444
+
445
+ - Updated dependencies [[`0d41fe2`](https://github.com/mastra-ai/mastra/commit/0d41fe245355dfc66d61a0d9c85d9400aac351ff), [`6b3ba91`](https://github.com/mastra-ai/mastra/commit/6b3ba91494cc10394df96782f349a4f7b1e152cc), [`7907fd1`](https://github.com/mastra-ai/mastra/commit/7907fd1c5059813b7b870b81ca71041dc807331b)]:
446
+ - @mastra/core@1.0.0-beta.8
447
+
448
+ ## 1.0.0-beta.7
449
+
450
+ ### Patch Changes
451
+
452
+ - fix: standardize pagination params to page/perPage with backwards compatibility for limit/offset ([#10790](https://github.com/mastra-ai/mastra/pull/10790))
453
+ - Server now accepts both `page`/`perPage` and legacy `limit`/`offset` params for workflow runs and MCP server listing endpoints
454
+ - Client SDK sends both param formats to support older server versions
455
+ - Added `createCombinedPaginationSchema` helper for endpoints needing backwards compatibility
456
+ - Marked `limit` and `offset` as deprecated in client types
457
+
458
+ - feat: Add partial response support for agent and workflow list endpoints ([#10886](https://github.com/mastra-ai/mastra/pull/10886))
459
+
460
+ Add optional `partial` query parameter to `/api/agents` and `/api/workflows` endpoints to return minimal data without schemas, reducing payload size for list views:
461
+ - When `partial=true`: tool schemas (inputSchema, outputSchema) are omitted
462
+ - When `partial=true`: workflow steps are replaced with stepCount integer
463
+ - When `partial=true`: workflow root schemas (inputSchema, outputSchema) are omitted
464
+ - Maintains backward compatibility when partial parameter is not provided
465
+
466
+ ## Server Endpoint Usage
467
+
468
+ ```http
469
+ # Get partial agent data (no tool schemas)
470
+ GET /api/agents?partial=true
471
+
472
+ # Get full agent data (default behavior)
473
+ GET /api/agents
474
+
475
+ # Get partial workflow data (stepCount instead of steps, no schemas)
476
+ GET /api/workflows?partial=true
477
+
478
+ # Get full workflow data (default behavior)
479
+ GET /api/workflows
480
+ ```
481
+
482
+ ## Client SDK Usage
483
+
484
+ ```typescript
485
+ import { MastraClient } from '@mastra/client-js';
486
+
487
+ const client = new MastraClient({ baseUrl: 'http://localhost:4111' });
488
+
489
+ // Get partial agent list (smaller payload)
490
+ const partialAgents = await client.listAgents({ partial: true });
491
+
492
+ // Get full agent list with tool schemas
493
+ const fullAgents = await client.listAgents();
494
+
495
+ // Get partial workflow list (smaller payload)
496
+ const partialWorkflows = await client.listWorkflows({ partial: true });
497
+
498
+ // Get full workflow list with steps and schemas
499
+ const fullWorkflows = await client.listWorkflows();
500
+ ```
501
+
502
+ - Updated dependencies [[`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
503
+ - @mastra/core@1.0.0-beta.7
504
+
505
+ ## 1.0.0-beta.6
506
+
507
+ ### Minor Changes
508
+
509
+ - Add support for custom fetch function in MastraClient to enable environments like Tauri that require custom fetch implementations to avoid timeout errors. ([#10677](https://github.com/mastra-ai/mastra/pull/10677))
510
+
511
+ You can now pass a custom fetch function when creating a MastraClient:
512
+
513
+ ```typescript
514
+ import { MastraClient } from '@mastra/client-js';
515
+
516
+ // Before: Only global fetch was available
517
+ const client = new MastraClient({
518
+ baseUrl: 'http://your-api-url',
519
+ });
520
+
521
+ // After: Custom fetch can be passed
522
+ const client = new MastraClient({
523
+ baseUrl: 'http://your-api-url',
524
+ fetch: customFetch, // Your custom fetch implementation
525
+ });
526
+ ```
527
+
528
+ If no custom fetch is provided, it falls back to the global fetch function, maintaining backward compatibility.
529
+
530
+ Fixes #10673
531
+
532
+ ### Patch Changes
533
+
534
+ - The client-js package had its own simpler zodToJsonSchema implementation that was missing critical features from schema-compat. This could cause issues when users pass Zod schemas with `z.record()` or `z.date()` through the MastraClient. ([#10730](https://github.com/mastra-ai/mastra/pull/10730))
535
+
536
+ Now the client uses the same implementation as the rest of the codebase, which includes the Zod v4 `z.record()` bug fix, date-time format conversion for `z.date()`, and proper handling of unrepresentable types.
537
+
538
+ Also removes the now-unused `zod-to-json-schema` dependency from client-js.
539
+
540
+ - Fix wrong arguments type in list workflow runs ([#10755](https://github.com/mastra-ai/mastra/pull/10755))
541
+
542
+ - Adjust the generate / stream types to accept tracingOptions ([#10742](https://github.com/mastra-ai/mastra/pull/10742))
543
+
544
+ - fix(a2a): fix streaming and memory support for A2A protocol ([#10653](https://github.com/mastra-ai/mastra/pull/10653))
545
+
546
+ **Client (`@mastra/client-js`):**
547
+ - Fixed `sendStreamingMessage` to properly return a streaming response instead of attempting to parse it as JSON
548
+
549
+ **Server (`@mastra/server`):**
550
+ - Fixed A2A message handler to pass `contextId` as `threadId` for memory persistence across conversations
551
+ - Added support for user-provided `resourceId` via `params.metadata.resourceId` or `message.metadata.resourceId`, falling back to `agentId`
552
+
553
+ - Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
554
+ - @mastra/core@1.0.0-beta.6
555
+ - @mastra/schema-compat@1.0.0-beta.2
556
+
557
+ ## 1.0.0-beta.5
558
+
559
+ ### Patch Changes
560
+
561
+ - Add timeTravel APIs and add timeTravel feature to studio ([#10361](https://github.com/mastra-ai/mastra/pull/10361))
562
+
563
+ - Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
564
+ - @mastra/core@1.0.0-beta.5
565
+
566
+ ## 1.0.0-beta.4
567
+
568
+ ### Patch Changes
569
+
570
+ - Include agentId parameter in listMessages API call ([#10270](https://github.com/mastra-ai/mastra/pull/10270))
571
+
572
+ - Added optional `description` field to `GetAgentResponse` to support richer agent metadata ([#10300](https://github.com/mastra-ai/mastra/pull/10300))
573
+
574
+ - Updated dependencies [[`352a5d6`](https://github.com/mastra-ai/mastra/commit/352a5d625cfe09849b21e8f52a24c9f0366759d5), [`a0a5b4b`](https://github.com/mastra-ai/mastra/commit/a0a5b4bbebe6c701ebbadf744873aa0d5ca01371), [`69ea758`](https://github.com/mastra-ai/mastra/commit/69ea758358edd7117f191c2e69c8bb5fc79e7a1a), [`993ad98`](https://github.com/mastra-ai/mastra/commit/993ad98d7ad3bebda9ecef5fec5c94349a0d04bc), [`3ff2c17`](https://github.com/mastra-ai/mastra/commit/3ff2c17a58e312fad5ea37377262c12d92ca0908)]:
575
+ - @mastra/core@1.0.0-beta.4
576
+
577
+ ## 1.0.0-beta.3
578
+
579
+ ### Patch Changes
580
+
581
+ - Remove unused dependencies ([#10019](https://github.com/mastra-ai/mastra/pull/10019))
582
+
583
+ - Updated dependencies [[`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4)]:
584
+ - @mastra/core@1.0.0-beta.3
585
+
3
586
  ## 1.0.0-beta.2
4
587
 
5
588
  ### Patch Changes
package/README.md CHANGED
@@ -68,6 +68,8 @@ const client = new MastraClient({
68
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
+ - `getWorkingMemory({ agentId, threadId, resourceId? })`: Get working memory for a thread
72
+ - `updateWorkingMemory({ agentId, threadId, workingMemory, resourceId? })`: Update working memory for a thread
71
73
 
72
74
  ### Tools
73
75