@mastra/client-js 1.31.2-alpha.2 → 1.31.2-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # @mastra/client-js
2
2
 
3
+ ## 1.31.2-alpha.4
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`a5c6337`](https://github.com/mastra-ai/mastra/commit/a5c6337d23c7686c81a32ce62f550f610543a240), [`8b97958`](https://github.com/mastra-ai/mastra/commit/8b979589f9aa59ba67cac565949475f2ffeb4ac3), [`8410541`](https://github.com/mastra-ai/mastra/commit/84105412c60ecd3bb33a9838146f59c4b588228f), [`01b338c`](https://github.com/mastra-ai/mastra/commit/01b338c56271f0219606710e3e8b26dee27ac6c2), [`8b7361d`](https://github.com/mastra-ai/mastra/commit/8b7361d35de68b80d05d30a74e0c69e7218fd612), [`c43f3a9`](https://github.com/mastra-ai/mastra/commit/c43f3a9d1efde99b38789364ba4d0ba670f430e3)]:
8
+ - @mastra/core@1.51.0-alpha.4
9
+
10
+ ## 1.31.2-alpha.3
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`177010f`](https://github.com/mastra-ai/mastra/commit/177010ff096d2e4b28d89803be5b1a4cad2a0d6b), [`54a51e0`](https://github.com/mastra-ai/mastra/commit/54a51e0a484fe1ebad3fb1f7ef5282a075709eb7)]:
15
+ - @mastra/core@1.51.0-alpha.3
16
+
3
17
  ## 1.31.2-alpha.2
4
18
 
5
19
  ### Patch Changes
@@ -3,7 +3,7 @@ name: mastra-client-js
3
3
  description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
4
4
  metadata:
5
5
  package: "@mastra/client-js"
6
- version: "1.31.2-alpha.2"
6
+ version: "1.31.2-alpha.4"
7
7
  ---
8
8
 
9
9
  ## When to use
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.31.2-alpha.2",
2
+ "version": "1.31.2-alpha.4",
3
3
  "package": "@mastra/client-js",
4
4
  "exports": {
5
5
  "RequestContext": {
@@ -64,9 +64,7 @@ export const mastra = new Mastra({
64
64
  })
65
65
  ```
66
66
 
67
- Once registered, you can manage agents through [Studio](https://mastra.ai/docs/studio/overview) or programmatically through the server API and Client SDK.
68
-
69
- > **Note:** See the [MastraEditor reference](https://mastra.ai/reference/editor/mastra-editor) for all configuration options.
67
+ Once registered, you can manage agents through [Studio](https://mastra.ai/docs/studio/overview) or programmatically through the server API and Client SDK. See the [MastraEditor reference](https://mastra.ai/reference/editor/mastra-editor) for all configuration options.
70
68
 
71
69
  ## Code and database sources
72
70
 
@@ -173,9 +171,7 @@ Because stored agents are data, you can build automation loops that tune agents
173
171
  - Re-run the experiment against the draft and compare scores to the baseline.
174
172
  - Promote the draft to the published version when the scores improve.
175
173
 
176
- This turns agent tuning into a closed feedback loop. One agent owns the production configuration, another agent iterates on it, and every change is versioned so you can roll back if a round of automated edits makes things worse. Combine this with [version targeting](#version-targeting-and-experimentation) to keep production traffic on the published version while the draft is being tested.
177
-
178
- > **Note:** See the [MastraEditor reference](https://mastra.ai/reference/editor/mastra-editor) for the full namespace API.
174
+ This turns agent tuning into a closed feedback loop. One agent owns the production configuration, another agent iterates on it, and every change is versioned so you can roll back if a round of automated edits makes things worse. Combine this with [version targeting](#version-targeting-and-experimentation) to keep production traffic on the published version while the draft is being tested. See the [MastraEditor reference](https://mastra.ai/reference/editor/mastra-editor) for the full namespace API.
179
175
 
180
176
  ## What can be overridden
181
177
 
@@ -112,9 +112,7 @@ const result = agent.sendSignal(
112
112
  await result.persisted
113
113
  ```
114
114
 
115
- Pass `ifIdle.streamOptions` when the idle wake-up stream needs options such as model settings, tools, or runtime context.
116
-
117
- > **Note:** Visit [`Agent.sendSignal()` reference](https://mastra.ai/reference/agents/agent) for `ifActive`, `ifIdle`, branch attributes, and `streamOptions`.
115
+ Pass `ifIdle.streamOptions` when the idle wake-up stream needs options such as model settings, tools, or runtime context. Visit [`Agent.sendSignal()` reference](https://mastra.ai/reference/agents/agent) for `ifActive`, `ifIdle`, branch attributes, and `streamOptions`.
118
116
 
119
117
  ### Send notification context
120
118
 
@@ -199,9 +197,7 @@ Awaiting `sendSignal()` preserves stream echo ordering when a subscribed thread
199
197
 
200
198
  ### Conditional attributes
201
199
 
202
- Use `ifActive.attributes` and `ifIdle.attributes` to tag input with context that depends on whether the agent is active or idle at delivery time. Top-level `attributes` always apply, and Mastra merges the selected branch's `attributes` into them when the input is accepted.
203
-
204
- > **Note:** Visit [`Agent.sendMessage()` reference](https://mastra.ai/reference/agents/agent) and [`Agent.sendSignal()` reference](https://mastra.ai/reference/agents/agent) for branch-specific attributes.
200
+ Use `ifActive.attributes` and `ifIdle.attributes` to tag input with context that depends on whether the agent is active or idle at delivery time. Top-level `attributes` always apply, and Mastra merges the selected branch's `attributes` into them when the input is accepted. Visit [`Agent.sendMessage()` reference](https://mastra.ai/reference/agents/agent) and [`Agent.sendSignal()` reference](https://mastra.ai/reference/agents/agent) for branch-specific attributes.
205
201
 
206
202
  ## State and notification signals
207
203
 
@@ -276,9 +272,7 @@ Notification signals represent external events such as GitHub activity, email, S
276
272
 
277
273
  Notification delivery has two phases. During ingress, `agent.sendNotificationSignal()` stores a notification record and resolves the agent's delivery policy. During dispatch, Mastra consumes due records and emits full notification or summary signals.
278
274
 
279
- The default delivery policy is priority-aware. Urgent notifications deliver immediately, while lower-priority notifications may be batched into summaries or wait until the thread is idle.
280
-
281
- > **Note:** Visit [`Agent.sendNotificationSignal()` reference](https://mastra.ai/reference/agents/agent) for notification fields, [`Agent` constructor reference](https://mastra.ai/reference/agents/agent) for `notifications.deliveryPolicy` configuration, and [`createNotificationInboxTool()` reference](https://mastra.ai/reference/signals/create-notification-inbox-tool) for inbox tool actions.
275
+ The default delivery policy is priority-aware. Urgent notifications deliver immediately, while lower-priority notifications may be batched into summaries or wait until the thread is idle. Visit [`Agent.sendNotificationSignal()` reference](https://mastra.ai/reference/agents/agent) for notification fields, [`Agent` constructor reference](https://mastra.ai/reference/agents/agent) for `notifications.deliveryPolicy` configuration, and [`createNotificationInboxTool()` reference](https://mastra.ai/reference/signals/create-notification-inbox-tool) for inbox tool actions.
282
276
 
283
277
  ```typescript
284
278
  await agent.sendNotificationSignal(
@@ -314,15 +308,11 @@ Notification summaries tell the model that inbox records are waiting:
314
308
 
315
309
  When Mastra emits a summary, it clears `summaryAt` and sets `summarySignalId` on each summarized record. The records stay pending and readable. When Mastra emits a full notification, it sets `deliveredSignalId` and marks the record `delivered`. If the inbox tool reads a notification first, it can inject the full notification signal and mark the record `seen`, which prevents duplicate full delivery.
316
310
 
317
- Configure a delivery policy on the agent when some notifications should wait for a different dispatch window or summary rollup. Enable scheduled dispatch at the Mastra level when deferred notifications and summary rollups should be delivered automatically.
318
-
319
- > **Note:** Visit [`Agent` constructor reference](https://mastra.ai/reference/agents/agent) for `notifications.deliveryPolicy` and [`Mastra` class reference](https://mastra.ai/reference/core/mastra-class) for runtime notification dispatch configuration.
311
+ Configure a delivery policy on the agent when some notifications should wait for a different dispatch window or summary rollup. Enable scheduled dispatch at the Mastra level when deferred notifications and summary rollups should be delivered automatically. Visit [`Agent` constructor reference](https://mastra.ai/reference/agents/agent) for `notifications.deliveryPolicy` and [`Mastra` class reference](https://mastra.ai/reference/core/mastra-class) for runtime notification dispatch configuration.
320
312
 
321
313
  #### Notification inbox tool
322
314
 
323
- Use `createNotificationInboxTool()` to give agents one tool for inbox actions instead of many CRUD tools. Use `read` after a `<notification-summary>` signal when the agent needs the full records behind the summary. The notification contents are delivered as signals, not as normal tool output.
324
-
325
- > **Note:** Visit [`createNotificationInboxTool()` reference](https://mastra.ai/reference/signals/create-notification-inbox-tool) for the setup example, input schema, and action behavior.
315
+ Use `createNotificationInboxTool()` to give agents one tool for inbox actions instead of many CRUD tools. Use `read` after a `<notification-summary>` signal when the agent needs the full records behind the summary. The notification contents are delivered as signals, not as normal tool output. Visit [`createNotificationInboxTool()` reference](https://mastra.ai/reference/signals/create-notification-inbox-tool) for the setup example, input schema, and action behavior.
326
316
 
327
317
  `sendNotificationSignal()` requires a storage domain with `notifications` support. Use `sendSignal({ type: 'notification' })` only for lower-level notification-shaped context that should bypass inbox storage.
328
318
 
@@ -358,15 +348,11 @@ Mastra still accepts legacy signal payloads such as `type: 'user-message'` and `
358
348
  - `type: 'user-message'`: Normalizes to `type: 'user'` and `tagName: 'user'`
359
349
  - `type: 'system-reminder'`: Normalizes to `type: 'reactive'` and `tagName: 'system-reminder'`
360
350
 
361
- Existing stored signal rows and older clients continue to load through the compatibility layer. New clients call the message routes when the server supports them; React's thread signal path falls back to the legacy `/signals` route when it detects an older server.
362
-
363
- > **Note:** Visit [Agent signals reference](https://mastra.ai/reference/agents/agent) for the full message, signal, and subscription types.
351
+ Existing stored signal rows and older clients continue to load through the compatibility layer. New clients call the message routes when the server supports them; React's thread signal path falls back to the legacy `/signals` route when it detects an older server. Visit [Agent signals reference](https://mastra.ai/reference/agents/agent) for the full message, signal, and subscription types.
364
352
 
365
353
  ### Approve tool calls
366
354
 
367
- When a subscribed run pauses for tool approval, approve or decline the tool call with the subscription-native methods. The resumed chunks arrive through the existing thread subscription.
368
-
369
- > **Note:** Visit [`client.getAgent().sendToolApproval()` reference](https://mastra.ai/reference/client-js/agents) and [server agent routes](https://mastra.ai/reference/server/routes) for request and response shapes.
355
+ When a subscribed run pauses for tool approval, approve or decline the tool call with the subscription-native methods. The resumed chunks arrive through the existing thread subscription. Visit [`client.getAgent().sendToolApproval()` reference](https://mastra.ai/reference/client-js/agents) and [server agent routes](https://mastra.ai/reference/server/routes) for request and response shapes.
370
356
 
371
357
  ### Use HTTP routes
372
358
 
@@ -105,7 +105,7 @@ const auth0Provider = new MastraAuthAuth0({
105
105
  })
106
106
  ```
107
107
 
108
- > **Info:** Visit [MastraAuthAuth0](https://mastra.ai/reference/auth/auth0) for all available configuration options.
108
+ Visit [MastraAuthAuth0](https://mastra.ai/reference/auth/auth0) for all available configuration options.
109
109
 
110
110
  ## Client-side setup
111
111
 
@@ -88,7 +88,7 @@ export const useClerkAuth = () => {
88
88
  }
89
89
  ```
90
90
 
91
- > **Info:** Refer to the [Clerk documentation](https://clerk.com/docs) for more information.
91
+ Refer to the [Clerk documentation](https://clerk.com/docs) for more information.
92
92
 
93
93
  ## Configuring `MastraClient`
94
94
 
@@ -118,7 +118,7 @@ const firebaseAuth = new MastraAuthFirebase({
118
118
  })
119
119
  ```
120
120
 
121
- > **Info:** Visit [MastraAuthFirebase](https://mastra.ai/reference/auth/firebase) for all available configuration options.
121
+ Visit [MastraAuthFirebase](https://mastra.ai/reference/auth/firebase) for all available configuration options.
122
122
 
123
123
  ## Client-side setup
124
124
 
@@ -61,7 +61,7 @@ export const mastra = new Mastra({
61
61
  })
62
62
  ```
63
63
 
64
- > **Info:** Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
64
+ Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
65
65
 
66
66
  Inside [Studio](https://mastra.ai/docs/studio/overview), go to **Settings** and under **Headers** select the **"Add Header"** button. Enter `Authorization` as the header name and `Bearer <your-jwt>` as the value.
67
67
 
@@ -80,7 +80,7 @@ export const mastraClient = new MastraClient({
80
80
  })
81
81
  ```
82
82
 
83
- > **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
83
+ Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
84
84
 
85
85
  ### Making authenticated requests
86
86
 
@@ -149,7 +149,7 @@ const workosAuth = new AdminOnlyWorkosAuth({
149
149
  })
150
150
  ```
151
151
 
152
- > **Info:** Visit [MastraAuthWorkos](https://mastra.ai/reference/auth/workos) for all available configuration options.
152
+ Visit [MastraAuthWorkos](https://mastra.ai/reference/auth/workos) for all available configuration options.
153
153
 
154
154
  ## Client-side setup
155
155
 
@@ -134,7 +134,7 @@ export const mastraClient = new MastraClient({
134
134
  })
135
135
  ```
136
136
 
137
- > **Info:** Visit [MastraClient](https://mastra.ai/reference/client-js/mastra-client) for more configuration options.
137
+ Visit [MastraClient](https://mastra.ai/reference/client-js/mastra-client) for more configuration options.
138
138
 
139
139
  ## Credentials and session cookies
140
140
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/client-js",
3
- "version": "1.31.2-alpha.2",
3
+ "version": "1.31.2-alpha.4",
4
4
  "description": "The official TypeScript library for the Mastra Client API",
5
5
  "author": "",
6
6
  "type": "module",
@@ -39,7 +39,7 @@
39
39
  "canonicalize": "^1.0.8",
40
40
  "jose": "^6.2.1",
41
41
  "json-schema": "^0.4.0",
42
- "@mastra/core": "1.51.0-alpha.2",
42
+ "@mastra/core": "1.51.0-alpha.4",
43
43
  "@mastra/schema-compat": "1.3.4-alpha.1"
44
44
  },
45
45
  "peerDependencies": {