@mastra/client-js 1.31.2-alpha.0 → 1.31.2-alpha.2
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 +16 -0
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/docs-agents-a2a.md +2 -1
- package/dist/docs/references/docs-long-running-agents-schedules.md +1 -1
- package/dist/docs/references/docs-long-running-agents-signals.md +5 -2
- package/package.json +4 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @mastra/client-js
|
|
2
2
|
|
|
3
|
+
## 1.31.2-alpha.2
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`e955965`](https://github.com/mastra-ai/mastra/commit/e955965dce575a903e37cf054d28ea99aa48785e), [`bc1121a`](https://github.com/mastra-ai/mastra/commit/bc1121a7bb98f7cd73e82e3a7913a667a9fa9911), [`860ef7e`](https://github.com/mastra-ai/mastra/commit/860ef7e77d92b63469cbe5857aa1e626197e43e9), [`17e818c`](https://github.com/mastra-ai/mastra/commit/17e818c51a958ba90641b1a959dc38faf8c034e9), [`4451dfe`](https://github.com/mastra-ai/mastra/commit/4451dfe857428e7abcc0261a507a2e186dae6d47), [`1d39058`](https://github.com/mastra-ai/mastra/commit/1d39058e548efd691799985d5c8af2737f1c3bd2)]:
|
|
8
|
+
- @mastra/core@1.51.0-alpha.2
|
|
9
|
+
- @mastra/schema-compat@1.3.4-alpha.1
|
|
10
|
+
|
|
11
|
+
## 1.31.2-alpha.1
|
|
12
|
+
|
|
13
|
+
### Patch Changes
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`6789ab4`](https://github.com/mastra-ai/mastra/commit/6789ab4191ddcd32a932898b360b191e80cee1a9)]:
|
|
16
|
+
- @mastra/schema-compat@1.3.4-alpha.0
|
|
17
|
+
- @mastra/core@1.50.2-alpha.1
|
|
18
|
+
|
|
3
19
|
## 1.31.2-alpha.0
|
|
4
20
|
|
|
5
21
|
### Patch Changes
|
package/dist/docs/SKILL.md
CHANGED
|
@@ -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.
|
|
6
|
+
version: "1.31.2-alpha.2"
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
## When to use
|
|
@@ -261,4 +261,5 @@ Use this hook to enforce expected providers, expected endpoints, certificate-bou
|
|
|
261
261
|
- [Agent reference](https://mastra.ai/reference/agents/agent)
|
|
262
262
|
- [JavaScript client agents reference](https://mastra.ai/reference/client-js/agents)
|
|
263
263
|
- [A2A core concepts](https://a2a-protocol.org/latest/topics/key-concepts/)
|
|
264
|
-
- [A2A discovery guide](https://a2a-protocol.org/latest/topics/agent-discovery/)
|
|
264
|
+
- [A2A discovery guide](https://a2a-protocol.org/latest/topics/agent-discovery/)
|
|
265
|
+
- 📹 [Agent-to-agent with Mastra workshop](https://www.youtube.com/watch?v=LQDzyNGm-aw)
|
|
@@ -10,7 +10,7 @@ A schedule runs an agent on a cron cadence. On each fire, Mastra sends a prompt
|
|
|
10
10
|
|
|
11
11
|
Schedules are persisted, so they survive restarts and redeploys. Manage them at runtime through [`mastra.schedules`](https://mastra.ai/reference/schedules/overview), the canonical create, read, update, and delete (CRUD) surface. The same surface also manages [workflow schedules](https://mastra.ai/docs/workflows/scheduled-workflows) (pass `workflowId` instead of `agentId` to schedule a workflow).
|
|
12
12
|
|
|
13
|
-
> **Note:** Schedules require a [storage](https://mastra.ai/docs/
|
|
13
|
+
> **Note:** Schedules require a [storage](https://mastra.ai/docs/storage/overview) adapter that implements the schedules domain. See the [`mastra.schedules` reference](https://mastra.ai/reference/schedules/overview) for supported adapters and API behavior.
|
|
14
14
|
|
|
15
15
|
## Quickstart
|
|
16
16
|
|
|
@@ -10,6 +10,8 @@ Signals are a way to interact with an agent through a thread. Instead of startin
|
|
|
10
10
|
|
|
11
11
|
Use message APIs for user-authored input. Use `sendSignal()` for lower-level system context, such as background task notifications, policy reminders, or processor-generated context.
|
|
12
12
|
|
|
13
|
+
> **📹 Watch:** Watch [Mastra signals overview](https://www.youtube.com/watch?v=7It2y89TVP4) to see how signals wake and steer long-running agents.
|
|
14
|
+
|
|
13
15
|
## When to use signals
|
|
14
16
|
|
|
15
17
|
Use signals when an agent thread needs new input or context outside the original `stream()` call. Signals are useful when users send follow-up messages while a run is active, when background systems need to add context to a thread, or when external events should wake, update, or notify the agent.
|
|
@@ -345,7 +347,7 @@ export const mastra = new Mastra({
|
|
|
345
347
|
})
|
|
346
348
|
```
|
|
347
349
|
|
|
348
|
-
`RedisStreamsPubSub` implements both the event delivery contract and distributed leasing, so a single backend handles cross-instance signal delivery and lease ownership. Vercel's
|
|
350
|
+
`RedisStreamsPubSub` implements both the event delivery contract and distributed leasing, so a single backend handles cross-instance signal delivery and lease ownership. Vercel's managed Redis integration and Upstash Redis both work well. For more on when a distributed pub/sub is needed, see the [PubSub guide](https://mastra.ai/docs/server/pubsub) and the [`RedisStreamsPubSub` reference](https://mastra.ai/reference/pubsub/redis-streams).
|
|
349
351
|
|
|
350
352
|
## Compatibility and APIs
|
|
351
353
|
|
|
@@ -430,4 +432,5 @@ Use heartbeats together with client-side reconnect logic. Heartbeats reduce idle
|
|
|
430
432
|
- [Server agent routes](https://mastra.ai/reference/server/routes)
|
|
431
433
|
- [`client.getAgent().subscribeToThread()`](https://mastra.ai/reference/client-js/agents)
|
|
432
434
|
- [`client.getAgent().sendToolApproval()`](https://mastra.ai/reference/client-js/agents)
|
|
433
|
-
- [`RedisStreamsPubSub`](https://mastra.ai/reference/pubsub/redis-streams)
|
|
435
|
+
- [`RedisStreamsPubSub`](https://mastra.ai/reference/pubsub/redis-streams)
|
|
436
|
+
- 📹 [Mastra signals workshop](https://www.youtube.com/watch?v=KLg6uFKz9aw\&t=3020s)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/client-js",
|
|
3
|
-
"version": "1.31.2-alpha.
|
|
3
|
+
"version": "1.31.2-alpha.2",
|
|
4
4
|
"description": "The official TypeScript library for the Mastra Client API",
|
|
5
5
|
"author": "",
|
|
6
6
|
"type": "module",
|
|
@@ -39,8 +39,8 @@
|
|
|
39
39
|
"canonicalize": "^1.0.8",
|
|
40
40
|
"jose": "^6.2.1",
|
|
41
41
|
"json-schema": "^0.4.0",
|
|
42
|
-
"@mastra/core": "1.
|
|
43
|
-
"@mastra/schema-compat": "1.3.
|
|
42
|
+
"@mastra/core": "1.51.0-alpha.2",
|
|
43
|
+
"@mastra/schema-compat": "1.3.4-alpha.1"
|
|
44
44
|
},
|
|
45
45
|
"peerDependencies": {
|
|
46
46
|
"zod": "^3.25.0 || ^4.0.0"
|
|
@@ -57,8 +57,8 @@
|
|
|
57
57
|
"vitest": "4.1.9",
|
|
58
58
|
"zod": "^4.4.3",
|
|
59
59
|
"@internal/ai-sdk-v4": "0.0.60",
|
|
60
|
-
"@internal/lint": "0.0.113",
|
|
61
60
|
"@internal/ai-sdk-v5": "0.0.60",
|
|
61
|
+
"@internal/lint": "0.0.113",
|
|
62
62
|
"@internal/types-builder": "0.0.88"
|
|
63
63
|
},
|
|
64
64
|
"engines": {
|