@mastra/client-js 0.0.0-taofeeqInngest-20250603090617 → 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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/client-js",
3
- "version": "0.0.0-taofeeqInngest-20250603090617",
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",
@@ -19,31 +19,36 @@
19
19
  },
20
20
  "./package.json": "./package.json"
21
21
  },
22
- "repository": "github:mastra-ai/client-js",
23
- "license": "Elastic-2.0",
22
+ "repository": {
23
+ "type": "git",
24
+ "url": "https://github.com/mastra-ai/mastra.git",
25
+ "directory": "client-sdks/client-js"
26
+ },
27
+ "homepage": "https://github.com/mastra-ai/mastra/tree/main/client-sdks/client-js#readme",
28
+ "license": "Apache-2.0",
24
29
  "dependencies": {
25
30
  "@ag-ui/client": "^0.0.27",
26
- "@ai-sdk/ui-utils": "^1.1.19",
31
+ "@ai-sdk/ui-utils": "^1.2.11",
32
+ "@lukeed/uuid": "^2.0.1",
27
33
  "json-schema": "^0.4.0",
28
34
  "rxjs": "7.8.1",
29
- "zod": "^3.24.3",
30
- "zod-to-json-schema": "^3.24.5"
35
+ "zod": "^3.25.67",
36
+ "zod-to-json-schema": "^3.24.5",
37
+ "@mastra/core": "0.0.0-transpile-packages-20250724123433"
31
38
  },
32
39
  "peerDependencies": {
33
- "zod": "^3.0.0",
34
- "@mastra/core": "^0.10.0-alpha.0"
40
+ "zod": "^3.0.0"
35
41
  },
36
42
  "devDependencies": {
37
- "@babel/preset-env": "^7.26.9",
38
- "@babel/preset-typescript": "^7.27.0",
39
- "@tsconfig/recommended": "^1.0.8",
43
+ "@babel/preset-env": "^7.27.2",
44
+ "@babel/preset-typescript": "^7.27.1",
45
+ "@tsconfig/recommended": "^1.0.9",
40
46
  "@types/json-schema": "^7.0.15",
41
- "@types/node": "^20.17.27",
42
- "tsup": "^8.4.0",
43
- "typescript": "^5.8.2",
44
- "vitest": "^3.1.2",
45
- "@internal/lint": "0.0.0-taofeeqInngest-20250603090617",
46
- "@mastra/core": "0.0.0-taofeeqInngest-20250603090617"
47
+ "@types/node": "^20.19.0",
48
+ "tsup": "^8.5.0",
49
+ "typescript": "^5.8.3",
50
+ "vitest": "^3.2.4",
51
+ "@internal/lint": "0.0.0-transpile-packages-20250724123433"
47
52
  },
48
53
  "scripts": {
49
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,
@@ -33,6 +35,10 @@ import type {
33
35
  McpServerListResponse,
34
36
  McpServerToolListResponse,
35
37
  GetLegacyWorkflowResponse,
38
+ GetVNextNetworkResponse,
39
+ GetNetworkMemoryThreadParams,
40
+ CreateNetworkMemoryThreadParams,
41
+ SaveNetworkMessageToMemoryParams,
36
42
  } from './types';
37
43
 
38
44
  export class MastraClient extends BaseResource {
@@ -123,6 +129,53 @@ export class MastraClient extends BaseResource {
123
129
  return this.request(`/api/memory/status?agentId=${agentId}`);
124
130
  }
125
131
 
132
+ /**
133
+ * Retrieves memory threads for a resource
134
+ * @param params - Parameters containing the resource ID
135
+ * @returns Promise containing array of memory threads
136
+ */
137
+ public getNetworkMemoryThreads(params: GetNetworkMemoryThreadParams): Promise<GetMemoryThreadResponse> {
138
+ return this.request(`/api/memory/network/threads?resourceid=${params.resourceId}&networkId=${params.networkId}`);
139
+ }
140
+
141
+ /**
142
+ * Creates a new memory thread
143
+ * @param params - Parameters for creating the memory thread
144
+ * @returns Promise containing the created memory thread
145
+ */
146
+ public createNetworkMemoryThread(params: CreateNetworkMemoryThreadParams): Promise<CreateMemoryThreadResponse> {
147
+ return this.request(`/api/memory/network/threads?networkId=${params.networkId}`, { method: 'POST', body: params });
148
+ }
149
+
150
+ /**
151
+ * Gets a memory thread instance by ID
152
+ * @param threadId - ID of the memory thread to retrieve
153
+ * @returns MemoryThread instance
154
+ */
155
+ public getNetworkMemoryThread(threadId: string, networkId: string) {
156
+ return new NetworkMemoryThread(this.options, threadId, networkId);
157
+ }
158
+
159
+ /**
160
+ * Saves messages to memory
161
+ * @param params - Parameters containing messages to save
162
+ * @returns Promise containing the saved messages
163
+ */
164
+ public saveNetworkMessageToMemory(params: SaveNetworkMessageToMemoryParams): Promise<SaveMessageToMemoryResponse> {
165
+ return this.request(`/api/memory/network/save-messages?networkId=${params.networkId}`, {
166
+ method: 'POST',
167
+ body: params,
168
+ });
169
+ }
170
+
171
+ /**
172
+ * Gets the status of the memory system
173
+ * @returns Promise containing memory system status
174
+ */
175
+ public getNetworkMemoryStatus(networkId: string): Promise<{ result: boolean }> {
176
+ return this.request(`/api/memory/network/status?networkId=${networkId}`);
177
+ }
178
+
126
179
  /**
127
180
  * Retrieves all available tools
128
181
  * @returns Promise containing map of tool IDs to tool details
@@ -189,7 +242,43 @@ export class MastraClient extends BaseResource {
189
242
  * @returns Promise containing array of log messages
190
243
  */
191
244
  public getLogs(params: GetLogsParams): Promise<GetLogsResponse> {
192
- return this.request(`/api/logs?transportId=${params.transportId}`);
245
+ const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
246
+ const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
247
+
248
+ const searchParams = new URLSearchParams();
249
+ if (transportId) {
250
+ searchParams.set('transportId', transportId);
251
+ }
252
+ if (fromDate) {
253
+ searchParams.set('fromDate', fromDate.toISOString());
254
+ }
255
+ if (toDate) {
256
+ searchParams.set('toDate', toDate.toISOString());
257
+ }
258
+ if (logLevel) {
259
+ searchParams.set('logLevel', logLevel);
260
+ }
261
+ if (page) {
262
+ searchParams.set('page', String(page));
263
+ }
264
+ if (perPage) {
265
+ searchParams.set('perPage', String(perPage));
266
+ }
267
+ if (_filters) {
268
+ if (Array.isArray(_filters)) {
269
+ for (const filter of _filters) {
270
+ searchParams.append('filters', filter);
271
+ }
272
+ } else {
273
+ searchParams.set('filters', _filters);
274
+ }
275
+ }
276
+
277
+ if (searchParams.size) {
278
+ return this.request(`/api/logs?${searchParams}`);
279
+ } else {
280
+ return this.request(`/api/logs`);
281
+ }
193
282
  }
194
283
 
195
284
  /**
@@ -198,7 +287,47 @@ export class MastraClient extends BaseResource {
198
287
  * @returns Promise containing array of log messages
199
288
  */
200
289
  public getLogForRun(params: GetLogParams): Promise<GetLogsResponse> {
201
- return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
290
+ const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
291
+
292
+ const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
293
+ const searchParams = new URLSearchParams();
294
+ if (runId) {
295
+ searchParams.set('runId', runId);
296
+ }
297
+ if (transportId) {
298
+ searchParams.set('transportId', transportId);
299
+ }
300
+ if (fromDate) {
301
+ searchParams.set('fromDate', fromDate.toISOString());
302
+ }
303
+ if (toDate) {
304
+ searchParams.set('toDate', toDate.toISOString());
305
+ }
306
+ if (logLevel) {
307
+ searchParams.set('logLevel', logLevel);
308
+ }
309
+ if (page) {
310
+ searchParams.set('page', String(page));
311
+ }
312
+ if (perPage) {
313
+ searchParams.set('perPage', String(perPage));
314
+ }
315
+
316
+ if (_filters) {
317
+ if (Array.isArray(_filters)) {
318
+ for (const filter of _filters) {
319
+ searchParams.append('filters', filter);
320
+ }
321
+ } else {
322
+ searchParams.set('filters', _filters);
323
+ }
324
+ }
325
+
326
+ if (searchParams.size) {
327
+ return this.request(`/api/logs/${runId}?${searchParams}`);
328
+ } else {
329
+ return this.request(`/api/logs/${runId}`);
330
+ }
202
331
  }
203
332
 
204
333
  /**
@@ -258,10 +387,18 @@ export class MastraClient extends BaseResource {
258
387
  * Retrieves all available networks
259
388
  * @returns Promise containing map of network IDs to network details
260
389
  */
261
- public getNetworks(): Promise<Record<string, GetNetworkResponse>> {
390
+ public getNetworks(): Promise<Array<GetNetworkResponse>> {
262
391
  return this.request('/api/networks');
263
392
  }
264
393
 
394
+ /**
395
+ * Retrieves all available vNext networks
396
+ * @returns Promise containing map of vNext network IDs to vNext network details
397
+ */
398
+ public getVNextNetworks(): Promise<Array<GetVNextNetworkResponse>> {
399
+ return this.request('/api/networks/v-next');
400
+ }
401
+
265
402
  /**
266
403
  * Gets a network instance by ID
267
404
  * @param networkId - ID of the network to retrieve
@@ -271,6 +408,15 @@ export class MastraClient extends BaseResource {
271
408
  return new Network(this.options, networkId);
272
409
  }
273
410
 
411
+ /**
412
+ * Gets a vNext network instance by ID
413
+ * @param networkId - ID of the vNext network to retrieve
414
+ * @returns vNext Network instance
415
+ */
416
+ public getVNextNetwork(networkId: string) {
417
+ return new VNextNetwork(this.options, networkId);
418
+ }
419
+
274
420
  /**
275
421
  * Retrieves a list of available MCP servers.
276
422
  * @param params - Optional parameters for pagination (limit, offset).
@@ -331,4 +477,50 @@ export class MastraClient extends BaseResource {
331
477
  public getA2A(agentId: string) {
332
478
  return new A2A(this.options, agentId);
333
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
+ }
334
526
  }
package/src/example.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  import { MastraClient } from './client';
2
+ import z from 'zod';
2
3
  // import type { WorkflowRunResult } from './types';
3
4
 
4
5
  // Agent
5
-
6
6
  (async () => {
7
7
  const client = new MastraClient({
8
8
  baseUrl: 'http://localhost:4111',
@@ -14,22 +14,53 @@ import { MastraClient } from './client';
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
- response.processDataStream({
20
- onTextPart: text => {
21
- process.stdout.write(text);
22
- },
23
- onFilePart: file => {
24
- console.log(file);
25
- },
26
- onDataPart: data => {
27
- console.log(data);
28
- },
29
- onErrorPart: error => {
30
- console.error(error);
31
- },
32
- });
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
+ // }
33
64
  } catch (error) {
34
65
  console.error(error);
35
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
- controller.enqueue(new TextEncoder().encode(JSON.stringify(data)));
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 = { content: 'test response' };
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(JSON.stringify(mockChunk));
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({ triggerData: { test: 'test' } });
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
  });