@mastra/client-js 0.0.0-tool-call-parts-20250630193309 → 0.0.0-transpile-packages-20250724123433
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/.turbo/turbo-build.log +8 -8
- package/CHANGELOG.md +256 -3
- package/LICENSE.md +11 -42
- package/README.md +1 -0
- package/dist/index.cjs +415 -276
- package/dist/index.d.cts +133 -42
- package/dist/index.d.ts +133 -42
- package/dist/index.js +416 -277
- package/package.json +6 -5
- package/src/client.ts +48 -2
- package/src/example.ts +45 -17
- package/src/index.test.ts +53 -5
- package/src/resources/agent.ts +309 -254
- package/src/resources/base.ts +4 -1
- package/src/resources/memory-thread.ts +18 -0
- package/src/resources/vNextNetwork.ts +22 -5
- package/src/resources/workflow.ts +42 -5
- package/src/types.ts +40 -4
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/client-js",
|
|
3
|
-
"version": "0.0.0-
|
|
3
|
+
"version": "0.0.0-transpile-packages-20250724123433",
|
|
4
4
|
"description": "The official TypeScript library for the Mastra Client API",
|
|
5
5
|
"author": "",
|
|
6
6
|
"type": "module",
|
|
@@ -25,15 +25,16 @@
|
|
|
25
25
|
"directory": "client-sdks/client-js"
|
|
26
26
|
},
|
|
27
27
|
"homepage": "https://github.com/mastra-ai/mastra/tree/main/client-sdks/client-js#readme",
|
|
28
|
-
"license": "
|
|
28
|
+
"license": "Apache-2.0",
|
|
29
29
|
"dependencies": {
|
|
30
30
|
"@ag-ui/client": "^0.0.27",
|
|
31
31
|
"@ai-sdk/ui-utils": "^1.2.11",
|
|
32
|
+
"@lukeed/uuid": "^2.0.1",
|
|
32
33
|
"json-schema": "^0.4.0",
|
|
33
34
|
"rxjs": "7.8.1",
|
|
34
35
|
"zod": "^3.25.67",
|
|
35
36
|
"zod-to-json-schema": "^3.24.5",
|
|
36
|
-
"@mastra/core": "0.0.0-
|
|
37
|
+
"@mastra/core": "0.0.0-transpile-packages-20250724123433"
|
|
37
38
|
},
|
|
38
39
|
"peerDependencies": {
|
|
39
40
|
"zod": "^3.0.0"
|
|
@@ -46,8 +47,8 @@
|
|
|
46
47
|
"@types/node": "^20.19.0",
|
|
47
48
|
"tsup": "^8.5.0",
|
|
48
49
|
"typescript": "^5.8.3",
|
|
49
|
-
"vitest": "^3.2.
|
|
50
|
-
"@internal/lint": "0.0.0-
|
|
50
|
+
"vitest": "^3.2.4",
|
|
51
|
+
"@internal/lint": "0.0.0-transpile-packages-20250724123433"
|
|
51
52
|
},
|
|
52
53
|
"scripts": {
|
|
53
54
|
"build": "tsup src/index.ts --format esm,cjs --dts --clean --treeshake=smallest --splitting",
|
package/src/client.ts
CHANGED
|
@@ -13,6 +13,8 @@ import {
|
|
|
13
13
|
MCPTool,
|
|
14
14
|
LegacyWorkflow,
|
|
15
15
|
} from './resources';
|
|
16
|
+
import { NetworkMemoryThread } from './resources/network-memory-thread';
|
|
17
|
+
import { VNextNetwork } from './resources/vNextNetwork';
|
|
16
18
|
import type {
|
|
17
19
|
ClientOptions,
|
|
18
20
|
CreateMemoryThreadParams,
|
|
@@ -38,8 +40,6 @@ import type {
|
|
|
38
40
|
CreateNetworkMemoryThreadParams,
|
|
39
41
|
SaveNetworkMessageToMemoryParams,
|
|
40
42
|
} from './types';
|
|
41
|
-
import { VNextNetwork } from './resources/vNextNetwork';
|
|
42
|
-
import { NetworkMemoryThread } from './resources/network-memory-thread';
|
|
43
43
|
|
|
44
44
|
export class MastraClient extends BaseResource {
|
|
45
45
|
constructor(options: ClientOptions) {
|
|
@@ -477,4 +477,50 @@ export class MastraClient extends BaseResource {
|
|
|
477
477
|
public getA2A(agentId: string) {
|
|
478
478
|
return new A2A(this.options, agentId);
|
|
479
479
|
}
|
|
480
|
+
|
|
481
|
+
/**
|
|
482
|
+
* Retrieves the working memory for a specific thread (optionally resource-scoped).
|
|
483
|
+
* @param agentId - ID of the agent.
|
|
484
|
+
* @param threadId - ID of the thread.
|
|
485
|
+
* @param resourceId - Optional ID of the resource.
|
|
486
|
+
* @returns Working memory for the specified thread or resource.
|
|
487
|
+
*/
|
|
488
|
+
public getWorkingMemory({
|
|
489
|
+
agentId,
|
|
490
|
+
threadId,
|
|
491
|
+
resourceId,
|
|
492
|
+
}: {
|
|
493
|
+
agentId: string;
|
|
494
|
+
threadId: string;
|
|
495
|
+
resourceId?: string;
|
|
496
|
+
}) {
|
|
497
|
+
return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}&resourceId=${resourceId}`);
|
|
498
|
+
}
|
|
499
|
+
|
|
500
|
+
/**
|
|
501
|
+
* Updates the working memory for a specific thread (optionally resource-scoped).
|
|
502
|
+
* @param agentId - ID of the agent.
|
|
503
|
+
* @param threadId - ID of the thread.
|
|
504
|
+
* @param workingMemory - The new working memory content.
|
|
505
|
+
* @param resourceId - Optional ID of the resource.
|
|
506
|
+
*/
|
|
507
|
+
public updateWorkingMemory({
|
|
508
|
+
agentId,
|
|
509
|
+
threadId,
|
|
510
|
+
workingMemory,
|
|
511
|
+
resourceId,
|
|
512
|
+
}: {
|
|
513
|
+
agentId: string;
|
|
514
|
+
threadId: string;
|
|
515
|
+
workingMemory: string;
|
|
516
|
+
resourceId?: string;
|
|
517
|
+
}) {
|
|
518
|
+
return this.request(`/api/memory/threads/${threadId}/working-memory?agentId=${agentId}`, {
|
|
519
|
+
method: 'POST',
|
|
520
|
+
body: {
|
|
521
|
+
workingMemory,
|
|
522
|
+
resourceId,
|
|
523
|
+
},
|
|
524
|
+
});
|
|
525
|
+
}
|
|
480
526
|
}
|
package/src/example.ts
CHANGED
|
@@ -14,25 +14,53 @@ import z from 'zod';
|
|
|
14
14
|
const agent = client.getAgent('weatherAgent');
|
|
15
15
|
const response = await agent.stream({
|
|
16
16
|
messages: 'what is the weather in new york?',
|
|
17
|
+
output: z.object({
|
|
18
|
+
weather: z.string(),
|
|
19
|
+
temperature: z.number(),
|
|
20
|
+
humidity: z.number(),
|
|
21
|
+
windSpeed: z.number(),
|
|
22
|
+
windDirection: z.string(),
|
|
23
|
+
windGust: z.number(),
|
|
24
|
+
windChill: z.number(),
|
|
25
|
+
}),
|
|
17
26
|
});
|
|
18
27
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
28
|
+
// Process data stream - unstructured output
|
|
29
|
+
|
|
30
|
+
// response.processDataStream({
|
|
31
|
+
// onTextPart: text => {
|
|
32
|
+
// process.stdout.write(text);
|
|
33
|
+
// },
|
|
34
|
+
// onFilePart: file => {
|
|
35
|
+
// console.log(file);
|
|
36
|
+
// },
|
|
37
|
+
// onDataPart: data => {
|
|
38
|
+
// console.log(data);
|
|
39
|
+
// },
|
|
40
|
+
// onErrorPart: error => {
|
|
41
|
+
// console.error(error);
|
|
42
|
+
// },
|
|
43
|
+
// onToolCallPart(streamPart) {
|
|
44
|
+
// console.log(streamPart);
|
|
45
|
+
// },
|
|
46
|
+
// });
|
|
47
|
+
|
|
48
|
+
// Process text stream - structured output
|
|
49
|
+
|
|
50
|
+
// response.processTextStream({
|
|
51
|
+
// onTextPart: text => {
|
|
52
|
+
// process.stdout.write(text);
|
|
53
|
+
// },
|
|
54
|
+
// });
|
|
55
|
+
|
|
56
|
+
// read the response body directly
|
|
57
|
+
|
|
58
|
+
// const reader = response.body!.getReader();
|
|
59
|
+
// while (true) {
|
|
60
|
+
// const { done, value } = await reader.read();
|
|
61
|
+
// if (done) break;
|
|
62
|
+
// console.log(new TextDecoder().decode(value));
|
|
63
|
+
// }
|
|
36
64
|
} catch (error) {
|
|
37
65
|
console.error(error);
|
|
38
66
|
}
|
package/src/index.test.ts
CHANGED
|
@@ -27,7 +27,13 @@ describe('MastraClient Resources', () => {
|
|
|
27
27
|
} else {
|
|
28
28
|
responseBody = new ReadableStream({
|
|
29
29
|
start(controller) {
|
|
30
|
-
|
|
30
|
+
if (typeof data === 'string') {
|
|
31
|
+
controller.enqueue(new TextEncoder().encode(data));
|
|
32
|
+
} else if (typeof data === 'object' && data !== null) {
|
|
33
|
+
controller.enqueue(new TextEncoder().encode(JSON.stringify(data)));
|
|
34
|
+
} else {
|
|
35
|
+
controller.enqueue(new TextEncoder().encode(String(data)));
|
|
36
|
+
}
|
|
31
37
|
controller.close();
|
|
32
38
|
},
|
|
33
39
|
});
|
|
@@ -279,7 +285,7 @@ describe('MastraClient Resources', () => {
|
|
|
279
285
|
});
|
|
280
286
|
|
|
281
287
|
it('should stream responses', async () => {
|
|
282
|
-
const mockChunk =
|
|
288
|
+
const mockChunk = `0:"test response"\n`;
|
|
283
289
|
mockFetchResponse(mockChunk, { isStream: true });
|
|
284
290
|
|
|
285
291
|
const response = await agent.stream({
|
|
@@ -298,7 +304,7 @@ describe('MastraClient Resources', () => {
|
|
|
298
304
|
if (reader) {
|
|
299
305
|
const { value, done } = await reader.read();
|
|
300
306
|
expect(done).toBe(false);
|
|
301
|
-
expect(new TextDecoder().decode(value)).toBe(
|
|
307
|
+
expect(new TextDecoder().decode(value)).toBe(mockChunk);
|
|
302
308
|
}
|
|
303
309
|
});
|
|
304
310
|
|
|
@@ -582,6 +588,48 @@ describe('MastraClient Resources', () => {
|
|
|
582
588
|
}),
|
|
583
589
|
);
|
|
584
590
|
});
|
|
591
|
+
|
|
592
|
+
it('should get paginated thread messages', async () => {
|
|
593
|
+
const mockResponse = {
|
|
594
|
+
messages: [
|
|
595
|
+
{
|
|
596
|
+
id: '1',
|
|
597
|
+
content: 'test message',
|
|
598
|
+
threadId,
|
|
599
|
+
role: 'user',
|
|
600
|
+
type: 'text',
|
|
601
|
+
resourceId: 'test-resource',
|
|
602
|
+
createdAt: new Date(),
|
|
603
|
+
},
|
|
604
|
+
],
|
|
605
|
+
total: 5,
|
|
606
|
+
page: 1,
|
|
607
|
+
perPage: 2,
|
|
608
|
+
hasMore: true,
|
|
609
|
+
};
|
|
610
|
+
mockFetchResponse(mockResponse);
|
|
611
|
+
|
|
612
|
+
const selectBy = {
|
|
613
|
+
pagination: {
|
|
614
|
+
page: 1,
|
|
615
|
+
perPage: 2,
|
|
616
|
+
},
|
|
617
|
+
};
|
|
618
|
+
|
|
619
|
+
const result = await memoryThread.getMessagesPaginated({
|
|
620
|
+
resourceId: 'test-resource',
|
|
621
|
+
format: 'v2',
|
|
622
|
+
selectBy,
|
|
623
|
+
});
|
|
624
|
+
|
|
625
|
+
expect(result).toEqual(mockResponse);
|
|
626
|
+
expect(global.fetch).toHaveBeenCalledWith(
|
|
627
|
+
`${clientOptions.baseUrl}/api/memory/threads/${threadId}/messages/paginated?resourceId=test-resource&format=v2&selectBy=${encodeURIComponent(JSON.stringify(selectBy))}`,
|
|
628
|
+
expect.objectContaining({
|
|
629
|
+
headers: expect.objectContaining(clientOptions.headers),
|
|
630
|
+
}),
|
|
631
|
+
);
|
|
632
|
+
});
|
|
585
633
|
});
|
|
586
634
|
|
|
587
635
|
describe('Tool Resource', () => {
|
|
@@ -662,14 +710,14 @@ describe('MastraClient Resources', () => {
|
|
|
662
710
|
};
|
|
663
711
|
mockFetchResponse(mockResponse);
|
|
664
712
|
|
|
665
|
-
const result = await workflow.startAsync({
|
|
713
|
+
const result = await workflow.startAsync({ inputData: { test: 'test' } });
|
|
666
714
|
expect(result).toEqual(mockResponse);
|
|
667
715
|
expect(global.fetch).toHaveBeenCalledWith(
|
|
668
716
|
`${clientOptions.baseUrl}/api/workflows/test-workflow/start-async?`,
|
|
669
717
|
expect.objectContaining({
|
|
670
718
|
method: 'POST',
|
|
671
719
|
headers: expect.objectContaining(clientOptions.headers),
|
|
672
|
-
body: JSON.stringify({ test: 'test' }),
|
|
720
|
+
body: JSON.stringify({ inputData: { test: 'test' } }),
|
|
673
721
|
}),
|
|
674
722
|
);
|
|
675
723
|
});
|