@mastra/client-js 0.0.0-generate-message-id-20250512171942 → 0.0.0-http-transporter-20250702160118

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/dist/index.d.cts CHANGED
@@ -1,12 +1,15 @@
1
1
  import { AbstractAgent } from '@ag-ui/client';
2
+ import { ServerInfo, MCPToolType, ServerDetailInfo } from '@mastra/core/mcp';
2
3
  import { processDataStream } from '@ai-sdk/ui-utils';
3
- import { CoreMessage, AiMessageType, StorageThreadType, MessageType, StepAction, StepGraph, WorkflowRuns, WorkflowRunResult as WorkflowRunResult$1, QueryResult, BaseLogMessage, GenerateReturn } from '@mastra/core';
4
+ import { CoreMessage, AiMessageType, StorageThreadType, MastraMessageV1, LegacyWorkflowRuns, WorkflowRuns, WorkflowRun, QueryResult, GenerateReturn } from '@mastra/core';
4
5
  import { JSONSchema7 } from 'json-schema';
5
6
  import { ZodSchema } from 'zod';
6
- import { AgentGenerateOptions, AgentStreamOptions } from '@mastra/core/agent';
7
- import { NewWorkflow, WorkflowResult, WatchEvent } from '@mastra/core/workflows/vNext';
8
- import { RuntimeContext } from '@mastra/core/di';
9
- import { RuntimeContext as RuntimeContext$1 } from '@mastra/core/runtime-context';
7
+ import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
8
+ import { LogLevel, BaseLogMessage } from '@mastra/core/logger';
9
+ import { RuntimeContext } from '@mastra/core/runtime-context';
10
+ import { Workflow as Workflow$1, WatchEvent, WorkflowResult } from '@mastra/core/workflows';
11
+ import { StepAction, StepGraph, LegacyWorkflowRunResult as LegacyWorkflowRunResult$1 } from '@mastra/core/workflows/legacy';
12
+ import * as stream_web from 'stream/web';
10
13
  import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
11
14
 
12
15
  interface ClientOptions {
@@ -28,19 +31,35 @@ interface RequestOptions {
28
31
  stream?: boolean;
29
32
  signal?: AbortSignal;
30
33
  }
34
+ type WithoutMethods<T> = {
35
+ [K in keyof T as T[K] extends (...args: any[]) => any ? never : T[K] extends {
36
+ (): any;
37
+ } ? never : T[K] extends undefined | ((...args: any[]) => any) ? never : K]: T[K];
38
+ };
31
39
  interface GetAgentResponse {
32
40
  name: string;
33
41
  instructions: string;
34
42
  tools: Record<string, GetToolResponse>;
43
+ workflows: Record<string, GetWorkflowResponse>;
35
44
  provider: string;
36
45
  modelId: string;
46
+ defaultGenerateOptions: WithoutMethods<AgentGenerateOptions>;
47
+ defaultStreamOptions: WithoutMethods<AgentStreamOptions>;
37
48
  }
38
49
  type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
39
50
  messages: string | string[] | CoreMessage[] | AiMessageType[];
40
- } & Partial<Omit<AgentGenerateOptions<T>, 'experimental_generateMessageId'>>;
51
+ output?: T;
52
+ experimental_output?: T;
53
+ runtimeContext?: RuntimeContext | Record<string, any>;
54
+ clientTools?: ToolsInput;
55
+ } & WithoutMethods<Omit<AgentGenerateOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
41
56
  type StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
42
57
  messages: string | string[] | CoreMessage[] | AiMessageType[];
43
- } & Omit<AgentStreamOptions<T>, 'onFinish' | 'onStepFinish' | 'telemetry' | 'experimental_generateMessageId'>;
58
+ output?: T;
59
+ experimental_output?: T;
60
+ runtimeContext?: RuntimeContext | Record<string, any>;
61
+ clientTools?: ToolsInput;
62
+ } & WithoutMethods<Omit<AgentStreamOptions<T>, 'output' | 'experimental_output' | 'runtimeContext' | 'clientTools'>>;
44
63
  interface GetEvalsByAgentIdResponse extends GetAgentResponse {
45
64
  evals: any[];
46
65
  instructions: string;
@@ -53,7 +72,7 @@ interface GetToolResponse {
53
72
  inputSchema: string;
54
73
  outputSchema: string;
55
74
  }
56
- interface GetWorkflowResponse {
75
+ interface GetLegacyWorkflowResponse {
57
76
  name: string;
58
77
  triggerSchema: string;
59
78
  steps: Record<string, StepAction<any, any, any, any>>;
@@ -68,19 +87,23 @@ interface GetWorkflowRunsParams {
68
87
  offset?: number;
69
88
  resourceId?: string;
70
89
  }
90
+ type GetLegacyWorkflowRunsResponse = LegacyWorkflowRuns;
71
91
  type GetWorkflowRunsResponse = WorkflowRuns;
72
- type WorkflowRunResult = {
92
+ type GetWorkflowRunByIdResponse = WorkflowRun;
93
+ type GetWorkflowRunExecutionResultResponse = WatchEvent['payload']['workflowState'];
94
+ type LegacyWorkflowRunResult = {
73
95
  activePaths: Record<string, {
74
96
  status: string;
75
97
  suspendPayload?: any;
76
98
  stepPath: string[];
77
99
  }>;
78
- results: WorkflowRunResult$1<any, any, any>['results'];
100
+ results: LegacyWorkflowRunResult$1<any, any, any>['results'];
79
101
  timestamp: number;
80
102
  runId: string;
81
103
  };
82
- interface GetVNextWorkflowResponse {
104
+ interface GetWorkflowResponse {
83
105
  name: string;
106
+ description?: string;
84
107
  steps: {
85
108
  [key: string]: {
86
109
  id: string;
@@ -91,14 +114,25 @@ interface GetVNextWorkflowResponse {
91
114
  suspendSchema: string;
92
115
  };
93
116
  };
94
- stepGraph: NewWorkflow['serializedStepGraph'];
117
+ allSteps: {
118
+ [key: string]: {
119
+ id: string;
120
+ description: string;
121
+ inputSchema: string;
122
+ outputSchema: string;
123
+ resumeSchema: string;
124
+ suspendSchema: string;
125
+ isWorkflow: boolean;
126
+ };
127
+ };
128
+ stepGraph: Workflow$1['serializedStepGraph'];
95
129
  inputSchema: string;
96
130
  outputSchema: string;
97
131
  }
98
- type VNextWorkflowWatchResult = WatchEvent & {
132
+ type WorkflowWatchResult = WatchEvent & {
99
133
  runId: string;
100
134
  };
101
- type VNextWorkflowRunResult = WorkflowResult<any, any>;
135
+ type WorkflowRunResult = WorkflowResult<any, any>;
102
136
  interface UpsertVectorParams {
103
137
  indexName: string;
104
138
  vectors: number[][];
@@ -126,40 +160,79 @@ interface GetVectorIndexResponse {
126
160
  count: number;
127
161
  }
128
162
  interface SaveMessageToMemoryParams {
129
- messages: MessageType[];
163
+ messages: MastraMessageV1[];
130
164
  agentId: string;
131
165
  }
132
- type SaveMessageToMemoryResponse = MessageType[];
166
+ interface SaveNetworkMessageToMemoryParams {
167
+ messages: MastraMessageV1[];
168
+ networkId: string;
169
+ }
170
+ type SaveMessageToMemoryResponse = MastraMessageV1[];
133
171
  interface CreateMemoryThreadParams {
134
- title: string;
135
- metadata: Record<string, any>;
172
+ title?: string;
173
+ metadata?: Record<string, any>;
136
174
  resourceId: string;
137
- threadId: string;
175
+ threadId?: string;
138
176
  agentId: string;
139
177
  }
178
+ interface CreateNetworkMemoryThreadParams {
179
+ title?: string;
180
+ metadata?: Record<string, any>;
181
+ resourceId: string;
182
+ threadId?: string;
183
+ networkId: string;
184
+ }
140
185
  type CreateMemoryThreadResponse = StorageThreadType;
141
186
  interface GetMemoryThreadParams {
142
187
  resourceId: string;
143
188
  agentId: string;
144
189
  }
190
+ interface GetNetworkMemoryThreadParams {
191
+ resourceId: string;
192
+ networkId: string;
193
+ }
145
194
  type GetMemoryThreadResponse = StorageThreadType[];
146
195
  interface UpdateMemoryThreadParams {
147
196
  title: string;
148
197
  metadata: Record<string, any>;
149
198
  resourceId: string;
150
199
  }
200
+ interface GetMemoryThreadMessagesParams {
201
+ /**
202
+ * Limit the number of messages to retrieve (default: 40)
203
+ */
204
+ limit?: number;
205
+ }
151
206
  interface GetMemoryThreadMessagesResponse {
152
207
  messages: CoreMessage[];
153
208
  uiMessages: AiMessageType[];
154
209
  }
155
210
  interface GetLogsParams {
156
211
  transportId: string;
212
+ fromDate?: Date;
213
+ toDate?: Date;
214
+ logLevel?: LogLevel;
215
+ filters?: Record<string, string>;
216
+ page?: number;
217
+ perPage?: number;
157
218
  }
158
219
  interface GetLogParams {
159
220
  runId: string;
160
221
  transportId: string;
222
+ fromDate?: Date;
223
+ toDate?: Date;
224
+ logLevel?: LogLevel;
225
+ filters?: Record<string, string>;
226
+ page?: number;
227
+ perPage?: number;
161
228
  }
162
- type GetLogsResponse = BaseLogMessage[];
229
+ type GetLogsResponse = {
230
+ logs: BaseLogMessage[];
231
+ total: number;
232
+ page: number;
233
+ perPage: number;
234
+ hasMore: boolean;
235
+ };
163
236
  type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;
164
237
  type SpanStatus = {
165
238
  code: number;
@@ -211,6 +284,7 @@ interface GetTelemetryParams {
211
284
  toDate?: Date;
212
285
  }
213
286
  interface GetNetworkResponse {
287
+ id: string;
214
288
  name: string;
215
289
  instructions: string;
216
290
  agents: Array<{
@@ -224,6 +298,69 @@ interface GetNetworkResponse {
224
298
  };
225
299
  state?: Record<string, any>;
226
300
  }
301
+ interface GetVNextNetworkResponse {
302
+ id: string;
303
+ name: string;
304
+ instructions: string;
305
+ agents: Array<{
306
+ name: string;
307
+ provider: string;
308
+ modelId: string;
309
+ }>;
310
+ routingModel: {
311
+ provider: string;
312
+ modelId: string;
313
+ };
314
+ workflows: Array<{
315
+ name: string;
316
+ description: string;
317
+ inputSchema: string | undefined;
318
+ outputSchema: string | undefined;
319
+ }>;
320
+ tools: Array<{
321
+ id: string;
322
+ description: string;
323
+ }>;
324
+ }
325
+ interface GenerateVNextNetworkResponse {
326
+ task: string;
327
+ result: string;
328
+ resourceId: string;
329
+ resourceType: 'none' | 'tool' | 'agent' | 'workflow';
330
+ }
331
+ interface GenerateOrStreamVNextNetworkParams {
332
+ message: string;
333
+ threadId?: string;
334
+ resourceId?: string;
335
+ }
336
+ interface LoopStreamVNextNetworkParams {
337
+ message: string;
338
+ threadId?: string;
339
+ resourceId?: string;
340
+ maxIterations?: number;
341
+ }
342
+ interface LoopVNextNetworkResponse {
343
+ status: 'success';
344
+ result: {
345
+ text: string;
346
+ };
347
+ steps: WorkflowResult<any, any>['steps'];
348
+ }
349
+ interface McpServerListResponse {
350
+ servers: ServerInfo[];
351
+ next: string | null;
352
+ total_count: number;
353
+ }
354
+ interface McpToolInfo {
355
+ id: string;
356
+ name: string;
357
+ description?: string;
358
+ inputSchema: string;
359
+ toolType?: MCPToolType;
360
+ }
361
+ interface McpServerToolListResponse {
362
+ tools: McpToolInfo[];
363
+ }
227
364
 
228
365
  declare class BaseResource {
229
366
  readonly options: ClientOptions;
@@ -256,7 +393,9 @@ declare class AgentVoice extends BaseResource {
256
393
  * @param options - Optional provider-specific options
257
394
  * @returns Promise containing the transcribed text
258
395
  */
259
- listen(audio: Blob, options?: Record<string, any>): Promise<Response>;
396
+ listen(audio: Blob, options?: Record<string, any>): Promise<{
397
+ text: string;
398
+ }>;
260
399
  /**
261
400
  * Get available speakers for the agent's voice provider
262
401
  * @returns Promise containing list of available speakers
@@ -265,6 +404,13 @@ declare class AgentVoice extends BaseResource {
265
404
  voiceId: string;
266
405
  [key: string]: any;
267
406
  }>>;
407
+ /**
408
+ * Get the listener configuration for the agent's voice provider
409
+ * @returns Promise containing a check if the agent has listening capabilities
410
+ */
411
+ getListener(): Promise<{
412
+ enabled: boolean;
413
+ }>;
268
414
  }
269
415
  declare class Agent extends BaseResource {
270
416
  private agentId;
@@ -280,7 +426,19 @@ declare class Agent extends BaseResource {
280
426
  * @param params - Generation parameters including prompt
281
427
  * @returns Promise containing the generated response
282
428
  */
283
- generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T>): Promise<GenerateReturn<T>>;
429
+ generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
430
+ output?: never;
431
+ experimental_output?: never;
432
+ }): Promise<GenerateReturn<T>>;
433
+ generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
434
+ output: T;
435
+ experimental_output?: never;
436
+ }): Promise<GenerateReturn<T>>;
437
+ generate<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: GenerateParams<T> & {
438
+ output?: never;
439
+ experimental_output: T;
440
+ }): Promise<GenerateReturn<T>>;
441
+ private processChatResponse;
284
442
  /**
285
443
  * Streams a response from the agent
286
444
  * @param params - Stream parameters including prompt
@@ -289,6 +447,10 @@ declare class Agent extends BaseResource {
289
447
  stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: StreamParams<T>): Promise<Response & {
290
448
  processDataStream: (options?: Omit<Parameters<typeof processDataStream>[0], 'stream'>) => Promise<void>;
291
449
  }>;
450
+ /**
451
+ * Processes the stream response and handles tool calls
452
+ */
453
+ private processStreamResponse;
292
454
  /**
293
455
  * Gets details about a specific tool available to the agent
294
456
  * @param toolId - ID of the tool to retrieve
@@ -365,9 +527,10 @@ declare class MemoryThread extends BaseResource {
365
527
  }>;
366
528
  /**
367
529
  * Retrieves messages associated with the thread
530
+ * @param params - Optional parameters including limit for number of messages to retrieve
368
531
  * @returns Promise containing thread messages and UI messages
369
532
  */
370
- getMessages(): Promise<GetMemoryThreadMessagesResponse>;
533
+ getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse>;
371
534
  }
372
535
 
373
536
  declare class Vector extends BaseResource {
@@ -416,29 +579,22 @@ declare class Vector extends BaseResource {
416
579
  query(params: QueryVectorParams): Promise<QueryVectorResponse>;
417
580
  }
418
581
 
419
- declare class Workflow extends BaseResource {
582
+ declare class LegacyWorkflow extends BaseResource {
420
583
  private workflowId;
421
584
  constructor(options: ClientOptions, workflowId: string);
422
585
  /**
423
- * Retrieves details about the workflow
424
- * @returns Promise containing workflow details including steps and graphs
586
+ * Retrieves details about the legacy workflow
587
+ * @returns Promise containing legacy workflow details including steps and graphs
425
588
  */
426
- details(): Promise<GetWorkflowResponse>;
589
+ details(): Promise<GetLegacyWorkflowResponse>;
427
590
  /**
428
- * Retrieves all runs for a workflow
591
+ * Retrieves all runs for a legacy workflow
429
592
  * @param params - Parameters for filtering runs
430
- * @returns Promise containing workflow runs array
431
- */
432
- runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
433
- /**
434
- * @deprecated Use `startAsync` instead
435
- * Executes the workflow with the provided parameters
436
- * @param params - Parameters required for workflow execution
437
- * @returns Promise containing the workflow execution results
593
+ * @returns Promise containing legacy workflow runs array
438
594
  */
439
- execute(params: Record<string, any>): Promise<WorkflowRunResult>;
595
+ runs(params?: GetWorkflowRunsParams): Promise<GetLegacyWorkflowRunsResponse>;
440
596
  /**
441
- * Creates a new workflow run
597
+ * Creates a new legacy workflow run
442
598
  * @returns Promise containing the generated run ID
443
599
  */
444
600
  createRun(params?: {
@@ -447,7 +603,7 @@ declare class Workflow extends BaseResource {
447
603
  runId: string;
448
604
  }>;
449
605
  /**
450
- * Starts a workflow run synchronously without waiting for the workflow to complete
606
+ * Starts a legacy workflow run synchronously without waiting for the workflow to complete
451
607
  * @param params - Object containing the runId and triggerData
452
608
  * @returns Promise containing success message
453
609
  */
@@ -458,11 +614,11 @@ declare class Workflow extends BaseResource {
458
614
  message: string;
459
615
  }>;
460
616
  /**
461
- * Resumes a suspended workflow step synchronously without waiting for the workflow to complete
617
+ * Resumes a suspended legacy workflow step synchronously without waiting for the workflow to complete
462
618
  * @param stepId - ID of the step to resume
463
- * @param runId - ID of the workflow run
464
- * @param context - Context to resume the workflow with
465
- * @returns Promise containing the workflow resume results
619
+ * @param runId - ID of the legacy workflow run
620
+ * @param context - Context to resume the legacy workflow with
621
+ * @returns Promise containing the legacy workflow resume results
466
622
  */
467
623
  resume({ stepId, runId, context, }: {
468
624
  stepId: string;
@@ -479,9 +635,9 @@ declare class Workflow extends BaseResource {
479
635
  startAsync(params: {
480
636
  runId?: string;
481
637
  triggerData: Record<string, any>;
482
- }): Promise<WorkflowRunResult>;
638
+ }): Promise<LegacyWorkflowRunResult>;
483
639
  /**
484
- * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
640
+ * Resumes a suspended legacy workflow step asynchronously and returns a promise that resolves when the workflow is complete
485
641
  * @param params - Object containing the runId, stepId, and context
486
642
  * @returns Promise containing the workflow resume results
487
643
  */
@@ -489,7 +645,7 @@ declare class Workflow extends BaseResource {
489
645
  runId: string;
490
646
  stepId: string;
491
647
  context: Record<string, any>;
492
- }): Promise<WorkflowRunResult>;
648
+ }): Promise<LegacyWorkflowRunResult>;
493
649
  /**
494
650
  * Creates an async generator that processes a readable stream and yields records
495
651
  * separated by the Record Separator character (\x1E)
@@ -499,13 +655,13 @@ declare class Workflow extends BaseResource {
499
655
  */
500
656
  private streamProcessor;
501
657
  /**
502
- * Watches workflow transitions in real-time
658
+ * Watches legacy workflow transitions in real-time
503
659
  * @param runId - Optional run ID to filter the watch stream
504
- * @returns AsyncGenerator that yields parsed records from the workflow watch stream
660
+ * @returns AsyncGenerator that yields parsed records from the legacy workflow watch stream
505
661
  */
506
662
  watch({ runId }: {
507
663
  runId?: string;
508
- }, onRecord: (record: WorkflowRunResult) => void): Promise<void>;
664
+ }, onRecord: (record: LegacyWorkflowRunResult) => void): Promise<void>;
509
665
  }
510
666
 
511
667
  declare class Tool extends BaseResource {
@@ -524,15 +680,15 @@ declare class Tool extends BaseResource {
524
680
  execute(params: {
525
681
  data: any;
526
682
  runId?: string;
527
- runtimeContext?: RuntimeContext;
683
+ runtimeContext?: RuntimeContext | Record<string, any>;
528
684
  }): Promise<any>;
529
685
  }
530
686
 
531
- declare class VNextWorkflow extends BaseResource {
687
+ declare class Workflow extends BaseResource {
532
688
  private workflowId;
533
689
  constructor(options: ClientOptions, workflowId: string);
534
690
  /**
535
- * Creates an async generator that processes a readable stream and yields vNext workflow records
691
+ * Creates an async generator that processes a readable stream and yields workflow records
536
692
  * separated by the Record Separator character (\x1E)
537
693
  *
538
694
  * @param stream - The readable stream to process
@@ -540,18 +696,50 @@ declare class VNextWorkflow extends BaseResource {
540
696
  */
541
697
  private streamProcessor;
542
698
  /**
543
- * Retrieves details about the vNext workflow
544
- * @returns Promise containing vNext workflow details including steps and graphs
699
+ * Retrieves details about the workflow
700
+ * @returns Promise containing workflow details including steps and graphs
545
701
  */
546
- details(): Promise<GetVNextWorkflowResponse>;
702
+ details(): Promise<GetWorkflowResponse>;
547
703
  /**
548
- * Retrieves all runs for a vNext workflow
704
+ * Retrieves all runs for a workflow
549
705
  * @param params - Parameters for filtering runs
550
- * @returns Promise containing vNext workflow runs array
706
+ * @returns Promise containing workflow runs array
551
707
  */
552
708
  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
553
709
  /**
554
- * Creates a new vNext workflow run
710
+ * Retrieves a specific workflow run by its ID
711
+ * @param runId - The ID of the workflow run to retrieve
712
+ * @returns Promise containing the workflow run details
713
+ */
714
+ runById(runId: string): Promise<GetWorkflowRunByIdResponse>;
715
+ /**
716
+ * Retrieves the execution result for a specific workflow run by its ID
717
+ * @param runId - The ID of the workflow run to retrieve the execution result for
718
+ * @returns Promise containing the workflow run execution result
719
+ */
720
+ runExecutionResult(runId: string): Promise<GetWorkflowRunExecutionResultResponse>;
721
+ /**
722
+ * Cancels a specific workflow run by its ID
723
+ * @param runId - The ID of the workflow run to cancel
724
+ * @returns Promise containing a success message
725
+ */
726
+ cancelRun(runId: string): Promise<{
727
+ message: string;
728
+ }>;
729
+ /**
730
+ * Sends an event to a specific workflow run by its ID
731
+ * @param params - Object containing the runId, event and data
732
+ * @returns Promise containing a success message
733
+ */
734
+ sendRunEvent(params: {
735
+ runId: string;
736
+ event: string;
737
+ data: unknown;
738
+ }): Promise<{
739
+ message: string;
740
+ }>;
741
+ /**
742
+ * Creates a new workflow run
555
743
  * @param params - Optional object containing the optional runId
556
744
  * @returns Promise containing the runId of the created run
557
745
  */
@@ -561,19 +749,19 @@ declare class VNextWorkflow extends BaseResource {
561
749
  runId: string;
562
750
  }>;
563
751
  /**
564
- * Starts a vNext workflow run synchronously without waiting for the workflow to complete
752
+ * Starts a workflow run synchronously without waiting for the workflow to complete
565
753
  * @param params - Object containing the runId, inputData and runtimeContext
566
754
  * @returns Promise containing success message
567
755
  */
568
756
  start(params: {
569
757
  runId: string;
570
758
  inputData: Record<string, any>;
571
- runtimeContext?: RuntimeContext$1;
759
+ runtimeContext?: RuntimeContext | Record<string, any>;
572
760
  }): Promise<{
573
761
  message: string;
574
762
  }>;
575
763
  /**
576
- * Resumes a suspended vNext workflow step synchronously without waiting for the vNext workflow to complete
764
+ * Resumes a suspended workflow step synchronously without waiting for the workflow to complete
577
765
  * @param params - Object containing the runId, step, resumeData and runtimeContext
578
766
  * @returns Promise containing success message
579
767
  */
@@ -581,39 +769,60 @@ declare class VNextWorkflow extends BaseResource {
581
769
  step: string | string[];
582
770
  runId: string;
583
771
  resumeData?: Record<string, any>;
584
- runtimeContext?: RuntimeContext$1;
772
+ runtimeContext?: RuntimeContext | Record<string, any>;
585
773
  }): Promise<{
586
774
  message: string;
587
775
  }>;
588
776
  /**
589
- * Starts a vNext workflow run asynchronously and returns a promise that resolves when the vNext workflow is complete
777
+ * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
590
778
  * @param params - Object containing the optional runId, inputData and runtimeContext
591
- * @returns Promise containing the vNext workflow execution results
779
+ * @returns Promise containing the workflow execution results
592
780
  */
593
781
  startAsync(params: {
594
782
  runId?: string;
595
783
  inputData: Record<string, any>;
596
- runtimeContext?: RuntimeContext$1;
597
- }): Promise<VNextWorkflowRunResult>;
784
+ runtimeContext?: RuntimeContext | Record<string, any>;
785
+ }): Promise<WorkflowRunResult>;
598
786
  /**
599
- * Resumes a suspended vNext workflow step asynchronously and returns a promise that resolves when the vNext workflow is complete
787
+ * Starts a workflow run and returns a stream
788
+ * @param params - Object containing the optional runId, inputData and runtimeContext
789
+ * @returns Promise containing the workflow execution results
790
+ */
791
+ stream(params: {
792
+ runId?: string;
793
+ inputData: Record<string, any>;
794
+ runtimeContext?: RuntimeContext;
795
+ }): Promise<stream_web.ReadableStream<{
796
+ type: string;
797
+ payload: any;
798
+ }>>;
799
+ /**
800
+ * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
600
801
  * @param params - Object containing the runId, step, resumeData and runtimeContext
601
- * @returns Promise containing the vNext workflow resume results
802
+ * @returns Promise containing the workflow resume results
602
803
  */
603
804
  resumeAsync(params: {
604
805
  runId: string;
605
806
  step: string | string[];
606
807
  resumeData?: Record<string, any>;
607
- runtimeContext?: RuntimeContext$1;
608
- }): Promise<VNextWorkflowRunResult>;
808
+ runtimeContext?: RuntimeContext | Record<string, any>;
809
+ }): Promise<WorkflowRunResult>;
609
810
  /**
610
- * Watches vNext workflow transitions in real-time
811
+ * Watches workflow transitions in real-time
611
812
  * @param runId - Optional run ID to filter the watch stream
612
- * @returns AsyncGenerator that yields parsed records from the vNext workflow watch stream
813
+ * @returns AsyncGenerator that yields parsed records from the workflow watch stream
613
814
  */
614
815
  watch({ runId }: {
615
816
  runId?: string;
616
- }, onRecord: (record: VNextWorkflowWatchResult) => void): Promise<void>;
817
+ }, onRecord: (record: WorkflowWatchResult) => void): Promise<void>;
818
+ /**
819
+ * Creates a new ReadableStream from an iterable or async iterable of objects,
820
+ * serializing each as JSON and separating them with the record separator (\x1E).
821
+ *
822
+ * @param records - An iterable or async iterable of objects to stream
823
+ * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
824
+ */
825
+ static createRecordStream(records: Iterable<any> | AsyncIterable<any>): ReadableStream;
617
826
  }
618
827
 
619
828
  /**
@@ -657,6 +866,97 @@ declare class A2A extends BaseResource {
657
866
  sendAndSubscribe(params: TaskSendParams): Promise<Response>;
658
867
  }
659
868
 
869
+ /**
870
+ * Represents a specific tool available on a specific MCP server.
871
+ * Provides methods to get details and execute the tool.
872
+ */
873
+ declare class MCPTool extends BaseResource {
874
+ private serverId;
875
+ private toolId;
876
+ constructor(options: ClientOptions, serverId: string, toolId: string);
877
+ /**
878
+ * Retrieves details about this specific tool from the MCP server.
879
+ * @returns Promise containing the tool's information (name, description, schema).
880
+ */
881
+ details(): Promise<McpToolInfo>;
882
+ /**
883
+ * Executes this specific tool on the MCP server.
884
+ * @param params - Parameters for tool execution, including data/args and optional runtimeContext.
885
+ * @returns Promise containing the result of the tool execution.
886
+ */
887
+ execute(params: {
888
+ data?: any;
889
+ runtimeContext?: RuntimeContext;
890
+ }): Promise<any>;
891
+ }
892
+
893
+ declare class VNextNetwork extends BaseResource {
894
+ private networkId;
895
+ constructor(options: ClientOptions, networkId: string);
896
+ /**
897
+ * Retrieves details about the network
898
+ * @returns Promise containing vNext network details
899
+ */
900
+ details(): Promise<GetVNextNetworkResponse>;
901
+ /**
902
+ * Generates a response from the v-next network
903
+ * @param params - Generation parameters including message
904
+ * @returns Promise containing the generated response
905
+ */
906
+ generate(params: GenerateOrStreamVNextNetworkParams): Promise<GenerateVNextNetworkResponse>;
907
+ /**
908
+ * Generates a response from the v-next network using multiple primitives
909
+ * @param params - Generation parameters including message
910
+ * @returns Promise containing the generated response
911
+ */
912
+ loop(params: {
913
+ message: string;
914
+ }): Promise<LoopVNextNetworkResponse>;
915
+ private streamProcessor;
916
+ /**
917
+ * Streams a response from the v-next network
918
+ * @param params - Stream parameters including message
919
+ * @returns Promise containing the results
920
+ */
921
+ stream(params: GenerateOrStreamVNextNetworkParams, onRecord: (record: WatchEvent) => void): Promise<void>;
922
+ /**
923
+ * Streams a response from the v-next network loop
924
+ * @param params - Stream parameters including message
925
+ * @returns Promise containing the results
926
+ */
927
+ loopStream(params: LoopStreamVNextNetworkParams, onRecord: (record: WatchEvent) => void): Promise<void>;
928
+ }
929
+
930
+ declare class NetworkMemoryThread extends BaseResource {
931
+ private threadId;
932
+ private networkId;
933
+ constructor(options: ClientOptions, threadId: string, networkId: string);
934
+ /**
935
+ * Retrieves the memory thread details
936
+ * @returns Promise containing thread details including title and metadata
937
+ */
938
+ get(): Promise<StorageThreadType>;
939
+ /**
940
+ * Updates the memory thread properties
941
+ * @param params - Update parameters including title and metadata
942
+ * @returns Promise containing updated thread details
943
+ */
944
+ update(params: UpdateMemoryThreadParams): Promise<StorageThreadType>;
945
+ /**
946
+ * Deletes the memory thread
947
+ * @returns Promise containing deletion result
948
+ */
949
+ delete(): Promise<{
950
+ result: string;
951
+ }>;
952
+ /**
953
+ * Retrieves messages associated with the thread
954
+ * @param params - Optional parameters including limit for number of messages to retrieve
955
+ * @returns Promise containing thread messages and UI messages
956
+ */
957
+ getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse>;
958
+ }
959
+
660
960
  declare class MastraClient extends BaseResource {
661
961
  constructor(options: ClientOptions);
662
962
  /**
@@ -704,6 +1004,37 @@ declare class MastraClient extends BaseResource {
704
1004
  getMemoryStatus(agentId: string): Promise<{
705
1005
  result: boolean;
706
1006
  }>;
1007
+ /**
1008
+ * Retrieves memory threads for a resource
1009
+ * @param params - Parameters containing the resource ID
1010
+ * @returns Promise containing array of memory threads
1011
+ */
1012
+ getNetworkMemoryThreads(params: GetNetworkMemoryThreadParams): Promise<GetMemoryThreadResponse>;
1013
+ /**
1014
+ * Creates a new memory thread
1015
+ * @param params - Parameters for creating the memory thread
1016
+ * @returns Promise containing the created memory thread
1017
+ */
1018
+ createNetworkMemoryThread(params: CreateNetworkMemoryThreadParams): Promise<CreateMemoryThreadResponse>;
1019
+ /**
1020
+ * Gets a memory thread instance by ID
1021
+ * @param threadId - ID of the memory thread to retrieve
1022
+ * @returns MemoryThread instance
1023
+ */
1024
+ getNetworkMemoryThread(threadId: string, networkId: string): NetworkMemoryThread;
1025
+ /**
1026
+ * Saves messages to memory
1027
+ * @param params - Parameters containing messages to save
1028
+ * @returns Promise containing the saved messages
1029
+ */
1030
+ saveNetworkMessageToMemory(params: SaveNetworkMessageToMemoryParams): Promise<SaveMessageToMemoryResponse>;
1031
+ /**
1032
+ * Gets the status of the memory system
1033
+ * @returns Promise containing memory system status
1034
+ */
1035
+ getNetworkMemoryStatus(networkId: string): Promise<{
1036
+ result: boolean;
1037
+ }>;
707
1038
  /**
708
1039
  * Retrieves all available tools
709
1040
  * @returns Promise containing map of tool IDs to tool details
@@ -715,6 +1046,17 @@ declare class MastraClient extends BaseResource {
715
1046
  * @returns Tool instance
716
1047
  */
717
1048
  getTool(toolId: string): Tool;
1049
+ /**
1050
+ * Retrieves all available legacy workflows
1051
+ * @returns Promise containing map of legacy workflow IDs to legacy workflow details
1052
+ */
1053
+ getLegacyWorkflows(): Promise<Record<string, GetLegacyWorkflowResponse>>;
1054
+ /**
1055
+ * Gets a legacy workflow instance by ID
1056
+ * @param workflowId - ID of the legacy workflow to retrieve
1057
+ * @returns Legacy Workflow instance
1058
+ */
1059
+ getLegacyWorkflow(workflowId: string): LegacyWorkflow;
718
1060
  /**
719
1061
  * Retrieves all available workflows
720
1062
  * @returns Promise containing map of workflow IDs to workflow details
@@ -726,17 +1068,6 @@ declare class MastraClient extends BaseResource {
726
1068
  * @returns Workflow instance
727
1069
  */
728
1070
  getWorkflow(workflowId: string): Workflow;
729
- /**
730
- * Retrieves all available vNext workflows
731
- * @returns Promise containing map of vNext workflow IDs to vNext workflow details
732
- */
733
- getVNextWorkflows(): Promise<Record<string, GetVNextWorkflowResponse>>;
734
- /**
735
- * Gets a vNext workflow instance by ID
736
- * @param workflowId - ID of the vNext workflow to retrieve
737
- * @returns vNext Workflow instance
738
- */
739
- getVNextWorkflow(workflowId: string): VNextWorkflow;
740
1071
  /**
741
1072
  * Gets a vector instance by name
742
1073
  * @param vectorName - Name of the vector to retrieve
@@ -772,13 +1103,56 @@ declare class MastraClient extends BaseResource {
772
1103
  * Retrieves all available networks
773
1104
  * @returns Promise containing map of network IDs to network details
774
1105
  */
775
- getNetworks(): Promise<Record<string, GetNetworkResponse>>;
1106
+ getNetworks(): Promise<Array<GetNetworkResponse>>;
1107
+ /**
1108
+ * Retrieves all available vNext networks
1109
+ * @returns Promise containing map of vNext network IDs to vNext network details
1110
+ */
1111
+ getVNextNetworks(): Promise<Array<GetVNextNetworkResponse>>;
776
1112
  /**
777
1113
  * Gets a network instance by ID
778
1114
  * @param networkId - ID of the network to retrieve
779
1115
  * @returns Network instance
780
1116
  */
781
1117
  getNetwork(networkId: string): Network;
1118
+ /**
1119
+ * Gets a vNext network instance by ID
1120
+ * @param networkId - ID of the vNext network to retrieve
1121
+ * @returns vNext Network instance
1122
+ */
1123
+ getVNextNetwork(networkId: string): VNextNetwork;
1124
+ /**
1125
+ * Retrieves a list of available MCP servers.
1126
+ * @param params - Optional parameters for pagination (limit, offset).
1127
+ * @returns Promise containing the list of MCP servers and pagination info.
1128
+ */
1129
+ getMcpServers(params?: {
1130
+ limit?: number;
1131
+ offset?: number;
1132
+ }): Promise<McpServerListResponse>;
1133
+ /**
1134
+ * Retrieves detailed information for a specific MCP server.
1135
+ * @param serverId - The ID of the MCP server to retrieve.
1136
+ * @param params - Optional parameters, e.g., specific version.
1137
+ * @returns Promise containing the detailed MCP server information.
1138
+ */
1139
+ getMcpServerDetails(serverId: string, params?: {
1140
+ version?: string;
1141
+ }): Promise<ServerDetailInfo>;
1142
+ /**
1143
+ * Retrieves a list of tools for a specific MCP server.
1144
+ * @param serverId - The ID of the MCP server.
1145
+ * @returns Promise containing the list of tools.
1146
+ */
1147
+ getMcpServerTools(serverId: string): Promise<McpServerToolListResponse>;
1148
+ /**
1149
+ * Gets an MCPTool resource instance for a specific tool on an MCP server.
1150
+ * This instance can then be used to fetch details or execute the tool.
1151
+ * @param serverId - The ID of the MCP server.
1152
+ * @param toolId - The ID of the tool.
1153
+ * @returns MCPTool instance.
1154
+ */
1155
+ getMcpServerTool(serverId: string, toolId: string): MCPTool;
782
1156
  /**
783
1157
  * Gets an A2A client for interacting with an agent via the A2A protocol
784
1158
  * @param agentId - ID of the agent to interact with
@@ -787,4 +1161,4 @@ declare class MastraClient extends BaseResource {
787
1161
  getA2A(agentId: string): A2A;
788
1162
  }
789
1163
 
790
- export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };
1164
+ export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type CreateNetworkMemoryThreadParams, type GenerateOrStreamVNextNetworkParams, type GenerateParams, type GenerateVNextNetworkResponse, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLegacyWorkflowResponse, type GetLegacyWorkflowRunsResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesParams, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkMemoryThreadParams, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextNetworkResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunByIdResponse, type GetWorkflowRunExecutionResultResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, type LegacyWorkflowRunResult, type LoopStreamVNextNetworkParams, type LoopVNextNetworkResponse, MastraClient, type McpServerListResponse, type McpServerToolListResponse, type McpToolInfo, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type SaveNetworkMessageToMemoryParams, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type WorkflowRunResult, type WorkflowWatchResult };