@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.
- package/CHANGELOG.md +583 -0
- package/README.md +2 -0
- package/dist/_types/@ai-sdk_ui-utils/dist/index.d.ts +820 -0
- package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts +8511 -0
- package/dist/client.d.ts +67 -12
- package/dist/client.d.ts.map +1 -1
- package/dist/docs/README.md +33 -0
- package/dist/docs/SKILL.md +34 -0
- package/dist/docs/SOURCE_MAP.json +6 -0
- package/dist/docs/ai-sdk/01-reference.md +358 -0
- package/dist/docs/client-js/01-reference.md +1139 -0
- package/dist/docs/server/01-mastra-client.md +273 -0
- package/dist/docs/server/02-jwt.md +100 -0
- package/dist/docs/server/03-clerk.md +140 -0
- package/dist/docs/server/04-supabase.md +126 -0
- package/dist/docs/server/05-firebase.md +284 -0
- package/dist/docs/server/06-workos.md +199 -0
- package/dist/docs/server/07-auth0.md +231 -0
- package/dist/index.cjs +1718 -475
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +1716 -469
- package/dist/index.js.map +1 -1
- package/dist/resources/a2a.d.ts.map +1 -1
- package/dist/resources/agent-builder.d.ts +13 -35
- package/dist/resources/agent-builder.d.ts.map +1 -1
- package/dist/resources/agent.d.ts +1 -1
- package/dist/resources/agent.d.ts.map +1 -1
- package/dist/resources/base.d.ts.map +1 -1
- package/dist/resources/index.d.ts +1 -0
- package/dist/resources/index.d.ts.map +1 -1
- package/dist/resources/memory-thread.d.ts +18 -3
- package/dist/resources/memory-thread.d.ts.map +1 -1
- package/dist/resources/observability.d.ts +58 -15
- package/dist/resources/observability.d.ts.map +1 -1
- package/dist/resources/run.d.ts +210 -0
- package/dist/resources/run.d.ts.map +1 -0
- package/dist/resources/stored-agent.d.ts +26 -0
- package/dist/resources/stored-agent.d.ts.map +1 -0
- package/dist/resources/workflow.d.ts +19 -161
- package/dist/resources/workflow.d.ts.map +1 -1
- package/dist/tools.d.ts +2 -2
- package/dist/tools.d.ts.map +1 -1
- package/dist/types.d.ts +171 -31
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/index.d.ts +26 -0
- package/dist/utils/index.d.ts.map +1 -1
- package/dist/utils/process-mastra-stream.d.ts +1 -1
- package/dist/utils/process-mastra-stream.d.ts.map +1 -1
- package/dist/utils/zod-to-json-schema.d.ts +9 -1
- package/dist/utils/zod-to-json-schema.d.ts.map +1 -1
- 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
|
|