@mastra/client-js 1.18.0-alpha.12 → 1.18.0-alpha.14
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 +59 -0
- package/dist/_types/@internal_ai-sdk-v5/dist/index.d.ts +8 -11
- package/dist/docs/SKILL.md +2 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/docs-agents-signals.md +151 -0
- package/dist/docs/references/reference-client-js-agents.md +89 -0
- package/dist/index.cjs +52 -35
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +52 -35
- package/dist/index.js.map +1 -1
- package/dist/resources/agent-builder.d.ts +1 -1
- package/dist/resources/agent-builder.d.ts.map +1 -1
- package/dist/resources/agent.d.ts +16 -1
- package/dist/resources/agent.d.ts.map +1 -1
- package/dist/route-types.generated.d.ts +2154 -3
- package/dist/route-types.generated.d.ts.map +1 -1
- package/dist/types.d.ts +21 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/process-mastra-stream.d.ts +4 -2
- package/dist/utils/process-mastra-stream.d.ts.map +1 -1
- package/package.json +5 -5
package/dist/index.js
CHANGED
|
@@ -130,11 +130,15 @@ function processClientTools(clientTools) {
|
|
|
130
130
|
// src/utils/process-mastra-stream.ts
|
|
131
131
|
async function sharedProcessMastraStream({
|
|
132
132
|
stream,
|
|
133
|
-
onChunk
|
|
133
|
+
onChunk,
|
|
134
|
+
signal
|
|
134
135
|
}) {
|
|
135
136
|
const reader = stream.getReader();
|
|
136
137
|
const decoder = new TextDecoder();
|
|
137
138
|
let buffer = "";
|
|
139
|
+
const abort = () => void reader.cancel();
|
|
140
|
+
if (signal?.aborted) abort();
|
|
141
|
+
else signal?.addEventListener("abort", abort, { once: true });
|
|
138
142
|
try {
|
|
139
143
|
while (true) {
|
|
140
144
|
const { done, value } = await reader.read();
|
|
@@ -162,25 +166,30 @@ async function sharedProcessMastraStream({
|
|
|
162
166
|
}
|
|
163
167
|
}
|
|
164
168
|
} finally {
|
|
169
|
+
signal?.removeEventListener("abort", abort);
|
|
165
170
|
reader.releaseLock();
|
|
166
171
|
}
|
|
167
172
|
}
|
|
168
173
|
async function processMastraNetworkStream({
|
|
169
174
|
stream,
|
|
170
|
-
onChunk
|
|
175
|
+
onChunk,
|
|
176
|
+
signal
|
|
171
177
|
}) {
|
|
172
178
|
return sharedProcessMastraStream({
|
|
173
179
|
stream,
|
|
174
|
-
onChunk
|
|
180
|
+
onChunk,
|
|
181
|
+
signal
|
|
175
182
|
});
|
|
176
183
|
}
|
|
177
184
|
async function processMastraStream({
|
|
178
185
|
stream,
|
|
179
|
-
onChunk
|
|
186
|
+
onChunk,
|
|
187
|
+
signal
|
|
180
188
|
}) {
|
|
181
189
|
return sharedProcessMastraStream({
|
|
182
190
|
stream,
|
|
183
|
-
onChunk
|
|
191
|
+
onChunk,
|
|
192
|
+
signal
|
|
184
193
|
});
|
|
185
194
|
}
|
|
186
195
|
|
|
@@ -343,8 +352,6 @@ var AgentVoice = class extends BaseResource {
|
|
|
343
352
|
this.version = version;
|
|
344
353
|
this.agentId = agentId;
|
|
345
354
|
}
|
|
346
|
-
agentId;
|
|
347
|
-
version;
|
|
348
355
|
getQueryString(requestContext, delimiter = "?") {
|
|
349
356
|
const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
|
|
350
357
|
if (this.version) {
|
|
@@ -414,8 +421,6 @@ var Agent = class extends BaseResource {
|
|
|
414
421
|
this.version = version;
|
|
415
422
|
this.voice = new AgentVoice(options, this.agentId, this.version);
|
|
416
423
|
}
|
|
417
|
-
agentId;
|
|
418
|
-
version;
|
|
419
424
|
voice;
|
|
420
425
|
getQueryString(requestContext, delimiter = "?") {
|
|
421
426
|
const searchParams = new URLSearchParams(requestContextQueryString(requestContext).slice(1));
|
|
@@ -441,6 +446,38 @@ var Agent = class extends BaseResource {
|
|
|
441
446
|
body: { instructions, comment }
|
|
442
447
|
});
|
|
443
448
|
}
|
|
449
|
+
/**
|
|
450
|
+
* @experimental Agent signals are experimental and may change in a future release.
|
|
451
|
+
*/
|
|
452
|
+
sendSignal(params) {
|
|
453
|
+
return this.request(`/agents/${this.agentId}/signals`, {
|
|
454
|
+
method: "POST",
|
|
455
|
+
body: params
|
|
456
|
+
});
|
|
457
|
+
}
|
|
458
|
+
/**
|
|
459
|
+
* @experimental Agent signals are experimental and may change in a future release.
|
|
460
|
+
*/
|
|
461
|
+
async subscribeToThread(params) {
|
|
462
|
+
const streamResponse = await this.request(`/agents/${this.agentId}/threads/subscribe`, {
|
|
463
|
+
method: "POST",
|
|
464
|
+
body: params,
|
|
465
|
+
stream: true
|
|
466
|
+
});
|
|
467
|
+
if (!streamResponse.body) {
|
|
468
|
+
throw new Error("No response body");
|
|
469
|
+
}
|
|
470
|
+
streamResponse.processDataStream = async ({
|
|
471
|
+
onChunk
|
|
472
|
+
}) => {
|
|
473
|
+
await processMastraStream({
|
|
474
|
+
stream: streamResponse.body,
|
|
475
|
+
onChunk,
|
|
476
|
+
signal: this.options.abortSignal
|
|
477
|
+
});
|
|
478
|
+
};
|
|
479
|
+
return streamResponse;
|
|
480
|
+
}
|
|
444
481
|
/**
|
|
445
482
|
* Clones this agent to a new stored agent in the database
|
|
446
483
|
* @param params - Clone parameters including optional newId, newName, metadata, authorId, and requestContext
|
|
@@ -1900,8 +1937,6 @@ var MemoryThread = class extends BaseResource {
|
|
|
1900
1937
|
this.threadId = threadId;
|
|
1901
1938
|
this.agentId = agentId;
|
|
1902
1939
|
}
|
|
1903
|
-
threadId;
|
|
1904
|
-
agentId;
|
|
1905
1940
|
/**
|
|
1906
1941
|
* Builds the query string for agentId (if provided)
|
|
1907
1942
|
*/
|
|
@@ -2034,7 +2069,6 @@ var Vector = class extends BaseResource {
|
|
|
2034
2069
|
super(options);
|
|
2035
2070
|
this.vectorName = vectorName;
|
|
2036
2071
|
}
|
|
2037
|
-
vectorName;
|
|
2038
2072
|
/**
|
|
2039
2073
|
* Retrieves details about a specific vector index
|
|
2040
2074
|
* @param indexName - Name of the index to get details for
|
|
@@ -2107,7 +2141,6 @@ var Tool = class extends BaseResource {
|
|
|
2107
2141
|
super(options);
|
|
2108
2142
|
this.toolId = toolId;
|
|
2109
2143
|
}
|
|
2110
|
-
toolId;
|
|
2111
2144
|
/**
|
|
2112
2145
|
* Retrieves details about the tool
|
|
2113
2146
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -2143,7 +2176,6 @@ var Processor = class extends BaseResource {
|
|
|
2143
2176
|
super(options);
|
|
2144
2177
|
this.processorId = processorId;
|
|
2145
2178
|
}
|
|
2146
|
-
processorId;
|
|
2147
2179
|
/**
|
|
2148
2180
|
* Retrieves details about the processor
|
|
2149
2181
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -2225,8 +2257,6 @@ var Run = class extends BaseResource {
|
|
|
2225
2257
|
this.workflowId = workflowId;
|
|
2226
2258
|
this.runId = runId;
|
|
2227
2259
|
}
|
|
2228
|
-
workflowId;
|
|
2229
|
-
runId;
|
|
2230
2260
|
/**
|
|
2231
2261
|
* Creates a transform stream that parses RECORD_SEPARATOR-delimited JSON chunks
|
|
2232
2262
|
*/
|
|
@@ -2619,7 +2649,6 @@ var Workflow = class extends BaseResource {
|
|
|
2619
2649
|
super(options);
|
|
2620
2650
|
this.workflowId = workflowId;
|
|
2621
2651
|
}
|
|
2622
|
-
workflowId;
|
|
2623
2652
|
/**
|
|
2624
2653
|
* Retrieves details about the workflow
|
|
2625
2654
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -2982,7 +3011,6 @@ var A2A = class extends BaseResource {
|
|
|
2982
3011
|
super(options);
|
|
2983
3012
|
this.agentId = agentId;
|
|
2984
3013
|
}
|
|
2985
|
-
agentId;
|
|
2986
3014
|
/**
|
|
2987
3015
|
* Get the agent card with metadata about the agent.
|
|
2988
3016
|
* @param options - Optional Agent Card verification settings
|
|
@@ -3231,7 +3259,6 @@ var AgentBuilder = class extends BaseResource {
|
|
|
3231
3259
|
super(options);
|
|
3232
3260
|
this.actionId = actionId;
|
|
3233
3261
|
}
|
|
3234
|
-
actionId;
|
|
3235
3262
|
// Helper function to transform workflow result to action result
|
|
3236
3263
|
transformWorkflowResult(result) {
|
|
3237
3264
|
if (result.status === "success") {
|
|
@@ -3418,13 +3445,14 @@ var AgentBuilder = class extends BaseResource {
|
|
|
3418
3445
|
* This calls `/agent-builder/:actionId/stream`.
|
|
3419
3446
|
*/
|
|
3420
3447
|
async stream(params, runId) {
|
|
3421
|
-
|
|
3422
|
-
|
|
3423
|
-
searchParams.set("runId", runId);
|
|
3448
|
+
if (!runId) {
|
|
3449
|
+
throw new Error("runId is required to stream an agent builder action");
|
|
3424
3450
|
}
|
|
3451
|
+
const searchParams = new URLSearchParams();
|
|
3452
|
+
searchParams.set("runId", runId);
|
|
3425
3453
|
const requestContext = parseClientRequestContext(params.requestContext);
|
|
3426
3454
|
const { requestContext: _, ...actionParams } = params;
|
|
3427
|
-
const url = `/agent-builder/${this.actionId}/stream
|
|
3455
|
+
const url = `/agent-builder/${this.actionId}/stream?${searchParams.toString()}`;
|
|
3428
3456
|
const response = await this.request(url, {
|
|
3429
3457
|
method: "POST",
|
|
3430
3458
|
body: { ...actionParams, requestContext },
|
|
@@ -3958,7 +3986,6 @@ var StoredAgent = class extends BaseResource {
|
|
|
3958
3986
|
super(options);
|
|
3959
3987
|
this.storedAgentId = storedAgentId;
|
|
3960
3988
|
}
|
|
3961
|
-
storedAgentId;
|
|
3962
3989
|
/**
|
|
3963
3990
|
* Retrieves details about the stored agent
|
|
3964
3991
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -4118,7 +4145,6 @@ var StoredPromptBlock = class extends BaseResource {
|
|
|
4118
4145
|
super(options);
|
|
4119
4146
|
this.storedPromptBlockId = storedPromptBlockId;
|
|
4120
4147
|
}
|
|
4121
|
-
storedPromptBlockId;
|
|
4122
4148
|
/**
|
|
4123
4149
|
* Retrieves details about the stored prompt block
|
|
4124
4150
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -4278,7 +4304,6 @@ var StoredMCPClient = class extends BaseResource {
|
|
|
4278
4304
|
super(options);
|
|
4279
4305
|
this.storedMCPClientId = storedMCPClientId;
|
|
4280
4306
|
}
|
|
4281
|
-
storedMCPClientId;
|
|
4282
4307
|
/**
|
|
4283
4308
|
* Retrieves details about the stored MCP client
|
|
4284
4309
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -4325,7 +4350,6 @@ var StoredScorer = class extends BaseResource {
|
|
|
4325
4350
|
super(options);
|
|
4326
4351
|
this.storedScorerId = storedScorerId;
|
|
4327
4352
|
}
|
|
4328
|
-
storedScorerId;
|
|
4329
4353
|
/**
|
|
4330
4354
|
* Retrieves details about the stored scorer definition
|
|
4331
4355
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -4486,7 +4510,6 @@ var ToolProvider = class extends BaseResource {
|
|
|
4486
4510
|
super(options);
|
|
4487
4511
|
this.providerId = providerId;
|
|
4488
4512
|
}
|
|
4489
|
-
providerId;
|
|
4490
4513
|
/**
|
|
4491
4514
|
* Lists available toolkits from this provider
|
|
4492
4515
|
* @returns Promise containing list of toolkits
|
|
@@ -4536,7 +4559,6 @@ var ProcessorProvider = class extends BaseResource {
|
|
|
4536
4559
|
super(options);
|
|
4537
4560
|
this.providerId = providerId;
|
|
4538
4561
|
}
|
|
4539
|
-
providerId;
|
|
4540
4562
|
/**
|
|
4541
4563
|
* Gets details about this processor provider and its available processors
|
|
4542
4564
|
* @returns Promise containing provider info and processor list
|
|
@@ -4556,9 +4578,6 @@ var WorkspaceSkillResource = class extends BaseResource {
|
|
|
4556
4578
|
this.basePath = `/workspaces/${encodeURIComponent(this.workspaceId)}/skills/${encodeURIComponent(this.skillName)}`;
|
|
4557
4579
|
this.pathQuery = this.skillPath ? `?path=${encodeURIComponent(this.skillPath)}` : "";
|
|
4558
4580
|
}
|
|
4559
|
-
workspaceId;
|
|
4560
|
-
skillName;
|
|
4561
|
-
skillPath;
|
|
4562
4581
|
basePath;
|
|
4563
4582
|
pathQuery;
|
|
4564
4583
|
/**
|
|
@@ -4778,7 +4797,6 @@ var StoredSkill = class extends BaseResource {
|
|
|
4778
4797
|
super(options);
|
|
4779
4798
|
this.storedSkillId = storedSkillId;
|
|
4780
4799
|
}
|
|
4781
|
-
storedSkillId;
|
|
4782
4800
|
/**
|
|
4783
4801
|
* Retrieves details about the stored skill
|
|
4784
4802
|
* @param requestContext - Optional request context to pass as query parameter
|
|
@@ -4875,7 +4893,6 @@ var ResponsesStream = class {
|
|
|
4875
4893
|
constructor(response) {
|
|
4876
4894
|
this.response = response;
|
|
4877
4895
|
}
|
|
4878
|
-
response;
|
|
4879
4896
|
asResponse() {
|
|
4880
4897
|
return this.response;
|
|
4881
4898
|
}
|
|
@@ -5285,7 +5302,7 @@ var MastraClient = class extends BaseResource {
|
|
|
5285
5302
|
* @returns Promise containing map of action IDs to action details
|
|
5286
5303
|
*/
|
|
5287
5304
|
getAgentBuilderActions() {
|
|
5288
|
-
return this.request("/agent-builder
|
|
5305
|
+
return this.request("/agent-builder");
|
|
5289
5306
|
}
|
|
5290
5307
|
/**
|
|
5291
5308
|
* Gets an agent builder instance for executing agent-builder workflows
|