@mastra/client-js 0.0.0-trigger-playground-ui-package-20250506151043 → 0.0.0-tsconfig-compile-20250703214351

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.ts CHANGED
@@ -1,11 +1,16 @@
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';
7
+ import { AgentGenerateOptions, AgentStreamOptions, ToolsInput } from '@mastra/core/agent';
8
+ import { LogLevel, BaseLogMessage } from '@mastra/core/logger';
8
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';
13
+ import { AgentCard, TaskSendParams, Task, TaskQueryParams, TaskIdParams } from '@mastra/core/a2a';
9
14
 
10
15
  interface ClientOptions {
11
16
  /** Base URL for API requests */
@@ -26,19 +31,35 @@ interface RequestOptions {
26
31
  stream?: boolean;
27
32
  signal?: AbortSignal;
28
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
+ };
29
39
  interface GetAgentResponse {
30
40
  name: string;
31
41
  instructions: string;
32
42
  tools: Record<string, GetToolResponse>;
43
+ workflows: Record<string, GetWorkflowResponse>;
33
44
  provider: string;
34
45
  modelId: string;
46
+ defaultGenerateOptions: WithoutMethods<AgentGenerateOptions>;
47
+ defaultStreamOptions: WithoutMethods<AgentStreamOptions>;
35
48
  }
36
49
  type GenerateParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
37
50
  messages: string | string[] | CoreMessage[] | AiMessageType[];
38
- } & Partial<AgentGenerateOptions<T>>;
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'>>;
39
56
  type StreamParams<T extends JSONSchema7 | ZodSchema | undefined = undefined> = {
40
57
  messages: string | string[] | CoreMessage[] | AiMessageType[];
41
- } & Omit<AgentStreamOptions<T>, 'onFinish' | 'onStepFinish' | 'telemetry'>;
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'>>;
42
63
  interface GetEvalsByAgentIdResponse extends GetAgentResponse {
43
64
  evals: any[];
44
65
  instructions: string;
@@ -51,7 +72,7 @@ interface GetToolResponse {
51
72
  inputSchema: string;
52
73
  outputSchema: string;
53
74
  }
54
- interface GetWorkflowResponse {
75
+ interface GetLegacyWorkflowResponse {
55
76
  name: string;
56
77
  triggerSchema: string;
57
78
  steps: Record<string, StepAction<any, any, any, any>>;
@@ -66,19 +87,23 @@ interface GetWorkflowRunsParams {
66
87
  offset?: number;
67
88
  resourceId?: string;
68
89
  }
90
+ type GetLegacyWorkflowRunsResponse = LegacyWorkflowRuns;
69
91
  type GetWorkflowRunsResponse = WorkflowRuns;
70
- type WorkflowRunResult = {
92
+ type GetWorkflowRunByIdResponse = WorkflowRun;
93
+ type GetWorkflowRunExecutionResultResponse = WatchEvent['payload']['workflowState'];
94
+ type LegacyWorkflowRunResult = {
71
95
  activePaths: Record<string, {
72
96
  status: string;
73
97
  suspendPayload?: any;
74
98
  stepPath: string[];
75
99
  }>;
76
- results: WorkflowRunResult$1<any, any, any>['results'];
100
+ results: LegacyWorkflowRunResult$1<any, any, any>['results'];
77
101
  timestamp: number;
78
102
  runId: string;
79
103
  };
80
- interface GetVNextWorkflowResponse {
104
+ interface GetWorkflowResponse {
81
105
  name: string;
106
+ description?: string;
82
107
  steps: {
83
108
  [key: string]: {
84
109
  id: string;
@@ -89,14 +114,25 @@ interface GetVNextWorkflowResponse {
89
114
  suspendSchema: string;
90
115
  };
91
116
  };
92
- 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'];
93
129
  inputSchema: string;
94
130
  outputSchema: string;
95
131
  }
96
- type VNextWorkflowWatchResult = WatchEvent & {
132
+ type WorkflowWatchResult = WatchEvent & {
97
133
  runId: string;
98
134
  };
99
- type VNextWorkflowRunResult = WorkflowResult<any, any>;
135
+ type WorkflowRunResult = WorkflowResult<any, any>;
100
136
  interface UpsertVectorParams {
101
137
  indexName: string;
102
138
  vectors: number[][];
@@ -124,40 +160,79 @@ interface GetVectorIndexResponse {
124
160
  count: number;
125
161
  }
126
162
  interface SaveMessageToMemoryParams {
127
- messages: MessageType[];
163
+ messages: MastraMessageV1[];
128
164
  agentId: string;
129
165
  }
130
- type SaveMessageToMemoryResponse = MessageType[];
166
+ interface SaveNetworkMessageToMemoryParams {
167
+ messages: MastraMessageV1[];
168
+ networkId: string;
169
+ }
170
+ type SaveMessageToMemoryResponse = MastraMessageV1[];
131
171
  interface CreateMemoryThreadParams {
132
- title: string;
133
- metadata: Record<string, any>;
172
+ title?: string;
173
+ metadata?: Record<string, any>;
134
174
  resourceId: string;
135
- threadId: string;
175
+ threadId?: string;
136
176
  agentId: string;
137
177
  }
178
+ interface CreateNetworkMemoryThreadParams {
179
+ title?: string;
180
+ metadata?: Record<string, any>;
181
+ resourceId: string;
182
+ threadId?: string;
183
+ networkId: string;
184
+ }
138
185
  type CreateMemoryThreadResponse = StorageThreadType;
139
186
  interface GetMemoryThreadParams {
140
187
  resourceId: string;
141
188
  agentId: string;
142
189
  }
190
+ interface GetNetworkMemoryThreadParams {
191
+ resourceId: string;
192
+ networkId: string;
193
+ }
143
194
  type GetMemoryThreadResponse = StorageThreadType[];
144
195
  interface UpdateMemoryThreadParams {
145
196
  title: string;
146
197
  metadata: Record<string, any>;
147
198
  resourceId: string;
148
199
  }
200
+ interface GetMemoryThreadMessagesParams {
201
+ /**
202
+ * Limit the number of messages to retrieve (default: 40)
203
+ */
204
+ limit?: number;
205
+ }
149
206
  interface GetMemoryThreadMessagesResponse {
150
207
  messages: CoreMessage[];
151
208
  uiMessages: AiMessageType[];
152
209
  }
153
210
  interface GetLogsParams {
154
211
  transportId: string;
212
+ fromDate?: Date;
213
+ toDate?: Date;
214
+ logLevel?: LogLevel;
215
+ filters?: Record<string, string>;
216
+ page?: number;
217
+ perPage?: number;
155
218
  }
156
219
  interface GetLogParams {
157
220
  runId: string;
158
221
  transportId: string;
222
+ fromDate?: Date;
223
+ toDate?: Date;
224
+ logLevel?: LogLevel;
225
+ filters?: Record<string, string>;
226
+ page?: number;
227
+ perPage?: number;
159
228
  }
160
- type GetLogsResponse = BaseLogMessage[];
229
+ type GetLogsResponse = {
230
+ logs: BaseLogMessage[];
231
+ total: number;
232
+ page: number;
233
+ perPage: number;
234
+ hasMore: boolean;
235
+ };
161
236
  type RequestFunction = (path: string, options?: RequestOptions) => Promise<any>;
162
237
  type SpanStatus = {
163
238
  code: number;
@@ -209,6 +284,7 @@ interface GetTelemetryParams {
209
284
  toDate?: Date;
210
285
  }
211
286
  interface GetNetworkResponse {
287
+ id: string;
212
288
  name: string;
213
289
  instructions: string;
214
290
  agents: Array<{
@@ -222,6 +298,69 @@ interface GetNetworkResponse {
222
298
  };
223
299
  state?: Record<string, any>;
224
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
+ }
225
364
 
226
365
  declare class BaseResource {
227
366
  readonly options: ClientOptions;
@@ -254,7 +393,9 @@ declare class AgentVoice extends BaseResource {
254
393
  * @param options - Optional provider-specific options
255
394
  * @returns Promise containing the transcribed text
256
395
  */
257
- listen(audio: Blob, options?: Record<string, any>): Promise<Response>;
396
+ listen(audio: Blob, options?: Record<string, any>): Promise<{
397
+ text: string;
398
+ }>;
258
399
  /**
259
400
  * Get available speakers for the agent's voice provider
260
401
  * @returns Promise containing list of available speakers
@@ -263,6 +404,13 @@ declare class AgentVoice extends BaseResource {
263
404
  voiceId: string;
264
405
  [key: string]: any;
265
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
+ }>;
266
414
  }
267
415
  declare class Agent extends BaseResource {
268
416
  private agentId;
@@ -278,7 +426,19 @@ declare class Agent extends BaseResource {
278
426
  * @param params - Generation parameters including prompt
279
427
  * @returns Promise containing the generated response
280
428
  */
281
- 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;
282
442
  /**
283
443
  * Streams a response from the agent
284
444
  * @param params - Stream parameters including prompt
@@ -287,12 +447,26 @@ declare class Agent extends BaseResource {
287
447
  stream<T extends JSONSchema7 | ZodSchema | undefined = undefined>(params: StreamParams<T>): Promise<Response & {
288
448
  processDataStream: (options?: Omit<Parameters<typeof processDataStream>[0], 'stream'>) => Promise<void>;
289
449
  }>;
450
+ /**
451
+ * Processes the stream response and handles tool calls
452
+ */
453
+ private processStreamResponse;
290
454
  /**
291
455
  * Gets details about a specific tool available to the agent
292
456
  * @param toolId - ID of the tool to retrieve
293
457
  * @returns Promise containing tool details
294
458
  */
295
459
  getTool(toolId: string): Promise<GetToolResponse>;
460
+ /**
461
+ * Executes a tool for the agent
462
+ * @param toolId - ID of the tool to execute
463
+ * @param params - Parameters required for tool execution
464
+ * @returns Promise containing the tool execution results
465
+ */
466
+ executeTool(toolId: string, params: {
467
+ data: any;
468
+ runtimeContext?: RuntimeContext;
469
+ }): Promise<any>;
296
470
  /**
297
471
  * Retrieves evaluation results for the agent
298
472
  * @returns Promise containing agent evaluations
@@ -353,9 +527,10 @@ declare class MemoryThread extends BaseResource {
353
527
  }>;
354
528
  /**
355
529
  * Retrieves messages associated with the thread
530
+ * @param params - Optional parameters including limit for number of messages to retrieve
356
531
  * @returns Promise containing thread messages and UI messages
357
532
  */
358
- getMessages(): Promise<GetMemoryThreadMessagesResponse>;
533
+ getMessages(params?: GetMemoryThreadMessagesParams): Promise<GetMemoryThreadMessagesResponse>;
359
534
  }
360
535
 
361
536
  declare class Vector extends BaseResource {
@@ -404,29 +579,22 @@ declare class Vector extends BaseResource {
404
579
  query(params: QueryVectorParams): Promise<QueryVectorResponse>;
405
580
  }
406
581
 
407
- declare class Workflow extends BaseResource {
582
+ declare class LegacyWorkflow extends BaseResource {
408
583
  private workflowId;
409
584
  constructor(options: ClientOptions, workflowId: string);
410
585
  /**
411
- * Retrieves details about the workflow
412
- * @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
413
588
  */
414
- details(): Promise<GetWorkflowResponse>;
589
+ details(): Promise<GetLegacyWorkflowResponse>;
415
590
  /**
416
- * Retrieves all runs for a workflow
591
+ * Retrieves all runs for a legacy workflow
417
592
  * @param params - Parameters for filtering runs
418
- * @returns Promise containing workflow runs array
419
- */
420
- runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
421
- /**
422
- * @deprecated Use `startAsync` instead
423
- * Executes the workflow with the provided parameters
424
- * @param params - Parameters required for workflow execution
425
- * @returns Promise containing the workflow execution results
593
+ * @returns Promise containing legacy workflow runs array
426
594
  */
427
- execute(params: Record<string, any>): Promise<WorkflowRunResult>;
595
+ runs(params?: GetWorkflowRunsParams): Promise<GetLegacyWorkflowRunsResponse>;
428
596
  /**
429
- * Creates a new workflow run
597
+ * Creates a new legacy workflow run
430
598
  * @returns Promise containing the generated run ID
431
599
  */
432
600
  createRun(params?: {
@@ -435,7 +603,7 @@ declare class Workflow extends BaseResource {
435
603
  runId: string;
436
604
  }>;
437
605
  /**
438
- * 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
439
607
  * @param params - Object containing the runId and triggerData
440
608
  * @returns Promise containing success message
441
609
  */
@@ -446,11 +614,11 @@ declare class Workflow extends BaseResource {
446
614
  message: string;
447
615
  }>;
448
616
  /**
449
- * 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
450
618
  * @param stepId - ID of the step to resume
451
- * @param runId - ID of the workflow run
452
- * @param context - Context to resume the workflow with
453
- * @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
454
622
  */
455
623
  resume({ stepId, runId, context, }: {
456
624
  stepId: string;
@@ -467,9 +635,9 @@ declare class Workflow extends BaseResource {
467
635
  startAsync(params: {
468
636
  runId?: string;
469
637
  triggerData: Record<string, any>;
470
- }): Promise<WorkflowRunResult>;
638
+ }): Promise<LegacyWorkflowRunResult>;
471
639
  /**
472
- * 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
473
641
  * @param params - Object containing the runId, stepId, and context
474
642
  * @returns Promise containing the workflow resume results
475
643
  */
@@ -477,7 +645,7 @@ declare class Workflow extends BaseResource {
477
645
  runId: string;
478
646
  stepId: string;
479
647
  context: Record<string, any>;
480
- }): Promise<WorkflowRunResult>;
648
+ }): Promise<LegacyWorkflowRunResult>;
481
649
  /**
482
650
  * Creates an async generator that processes a readable stream and yields records
483
651
  * separated by the Record Separator character (\x1E)
@@ -487,13 +655,13 @@ declare class Workflow extends BaseResource {
487
655
  */
488
656
  private streamProcessor;
489
657
  /**
490
- * Watches workflow transitions in real-time
658
+ * Watches legacy workflow transitions in real-time
491
659
  * @param runId - Optional run ID to filter the watch stream
492
- * @returns AsyncGenerator that yields parsed records from the workflow watch stream
660
+ * @returns AsyncGenerator that yields parsed records from the legacy workflow watch stream
493
661
  */
494
662
  watch({ runId }: {
495
663
  runId?: string;
496
- }, onRecord: (record: WorkflowRunResult) => void): Promise<void>;
664
+ }, onRecord: (record: LegacyWorkflowRunResult) => void): Promise<void>;
497
665
  }
498
666
 
499
667
  declare class Tool extends BaseResource {
@@ -512,14 +680,15 @@ declare class Tool extends BaseResource {
512
680
  execute(params: {
513
681
  data: any;
514
682
  runId?: string;
683
+ runtimeContext?: RuntimeContext | Record<string, any>;
515
684
  }): Promise<any>;
516
685
  }
517
686
 
518
- declare class VNextWorkflow extends BaseResource {
687
+ declare class Workflow extends BaseResource {
519
688
  private workflowId;
520
689
  constructor(options: ClientOptions, workflowId: string);
521
690
  /**
522
- * 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
523
692
  * separated by the Record Separator character (\x1E)
524
693
  *
525
694
  * @param stream - The readable stream to process
@@ -527,18 +696,50 @@ declare class VNextWorkflow extends BaseResource {
527
696
  */
528
697
  private streamProcessor;
529
698
  /**
530
- * Retrieves details about the vNext workflow
531
- * @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
532
701
  */
533
- details(): Promise<GetVNextWorkflowResponse>;
702
+ details(): Promise<GetWorkflowResponse>;
534
703
  /**
535
- * Retrieves all runs for a vNext workflow
704
+ * Retrieves all runs for a workflow
536
705
  * @param params - Parameters for filtering runs
537
- * @returns Promise containing vNext workflow runs array
706
+ * @returns Promise containing workflow runs array
538
707
  */
539
708
  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
540
709
  /**
541
- * 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
542
743
  * @param params - Optional object containing the optional runId
543
744
  * @returns Promise containing the runId of the created run
544
745
  */
@@ -548,59 +749,212 @@ declare class VNextWorkflow extends BaseResource {
548
749
  runId: string;
549
750
  }>;
550
751
  /**
551
- * 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
552
753
  * @param params - Object containing the runId, inputData and runtimeContext
553
754
  * @returns Promise containing success message
554
755
  */
555
756
  start(params: {
556
757
  runId: string;
557
758
  inputData: Record<string, any>;
558
- runtimeContext?: RuntimeContext;
759
+ runtimeContext?: RuntimeContext | Record<string, any>;
559
760
  }): Promise<{
560
761
  message: string;
561
762
  }>;
562
763
  /**
563
- * 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
564
765
  * @param params - Object containing the runId, step, resumeData and runtimeContext
565
766
  * @returns Promise containing success message
566
767
  */
567
- resume({ step, runId, resumeData, runtimeContext, }: {
768
+ resume({ step, runId, resumeData, ...rest }: {
568
769
  step: string | string[];
569
770
  runId: string;
570
771
  resumeData?: Record<string, any>;
571
- runtimeContext?: RuntimeContext;
772
+ runtimeContext?: RuntimeContext | Record<string, any>;
572
773
  }): Promise<{
573
774
  message: string;
574
775
  }>;
575
776
  /**
576
- * 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
577
778
  * @param params - Object containing the optional runId, inputData and runtimeContext
578
- * @returns Promise containing the vNext workflow execution results
779
+ * @returns Promise containing the workflow execution results
579
780
  */
580
781
  startAsync(params: {
782
+ runId?: string;
783
+ inputData: Record<string, any>;
784
+ runtimeContext?: RuntimeContext | Record<string, any>;
785
+ }): Promise<WorkflowRunResult>;
786
+ /**
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: {
581
792
  runId?: string;
582
793
  inputData: Record<string, any>;
583
794
  runtimeContext?: RuntimeContext;
584
- }): Promise<VNextWorkflowRunResult>;
795
+ }): Promise<stream_web.ReadableStream<{
796
+ type: string;
797
+ payload: any;
798
+ }>>;
585
799
  /**
586
- * Resumes a suspended vNext workflow step asynchronously and returns a promise that resolves when the vNext workflow is complete
800
+ * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
587
801
  * @param params - Object containing the runId, step, resumeData and runtimeContext
588
- * @returns Promise containing the vNext workflow resume results
802
+ * @returns Promise containing the workflow resume results
589
803
  */
590
804
  resumeAsync(params: {
591
805
  runId: string;
592
806
  step: string | string[];
593
807
  resumeData?: Record<string, any>;
594
- runtimeContext?: RuntimeContext;
595
- }): Promise<VNextWorkflowRunResult>;
808
+ runtimeContext?: RuntimeContext | Record<string, any>;
809
+ }): Promise<WorkflowRunResult>;
596
810
  /**
597
- * Watches vNext workflow transitions in real-time
811
+ * Watches workflow transitions in real-time
598
812
  * @param runId - Optional run ID to filter the watch stream
599
- * @returns AsyncGenerator that yields parsed records from the vNext workflow watch stream
813
+ * @returns AsyncGenerator that yields parsed records from the workflow watch stream
600
814
  */
601
815
  watch({ runId }: {
602
816
  runId?: string;
603
- }, 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;
826
+ }
827
+
828
+ /**
829
+ * Class for interacting with an agent via the A2A protocol
830
+ */
831
+ declare class A2A extends BaseResource {
832
+ private agentId;
833
+ constructor(options: ClientOptions, agentId: string);
834
+ /**
835
+ * Get the agent card with metadata about the agent
836
+ * @returns Promise containing the agent card information
837
+ */
838
+ getCard(): Promise<AgentCard>;
839
+ /**
840
+ * Send a message to the agent and get a response
841
+ * @param params - Parameters for the task
842
+ * @returns Promise containing the task response
843
+ */
844
+ sendMessage(params: TaskSendParams): Promise<{
845
+ task: Task;
846
+ }>;
847
+ /**
848
+ * Get the status and result of a task
849
+ * @param params - Parameters for querying the task
850
+ * @returns Promise containing the task response
851
+ */
852
+ getTask(params: TaskQueryParams): Promise<Task>;
853
+ /**
854
+ * Cancel a running task
855
+ * @param params - Parameters identifying the task to cancel
856
+ * @returns Promise containing the task response
857
+ */
858
+ cancelTask(params: TaskIdParams): Promise<{
859
+ task: Task;
860
+ }>;
861
+ /**
862
+ * Send a message and subscribe to streaming updates (not fully implemented)
863
+ * @param params - Parameters for the task
864
+ * @returns Promise containing the task response
865
+ */
866
+ sendAndSubscribe(params: TaskSendParams): Promise<Response>;
867
+ }
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>;
604
958
  }
605
959
 
606
960
  declare class MastraClient extends BaseResource {
@@ -650,6 +1004,37 @@ declare class MastraClient extends BaseResource {
650
1004
  getMemoryStatus(agentId: string): Promise<{
651
1005
  result: boolean;
652
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
+ }>;
653
1038
  /**
654
1039
  * Retrieves all available tools
655
1040
  * @returns Promise containing map of tool IDs to tool details
@@ -661,6 +1046,17 @@ declare class MastraClient extends BaseResource {
661
1046
  * @returns Tool instance
662
1047
  */
663
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;
664
1060
  /**
665
1061
  * Retrieves all available workflows
666
1062
  * @returns Promise containing map of workflow IDs to workflow details
@@ -672,17 +1068,6 @@ declare class MastraClient extends BaseResource {
672
1068
  * @returns Workflow instance
673
1069
  */
674
1070
  getWorkflow(workflowId: string): Workflow;
675
- /**
676
- * Retrieves all available vNext workflows
677
- * @returns Promise containing map of vNext workflow IDs to vNext workflow details
678
- */
679
- getVNextWorkflows(): Promise<Record<string, GetVNextWorkflowResponse>>;
680
- /**
681
- * Gets a vNext workflow instance by ID
682
- * @param workflowId - ID of the vNext workflow to retrieve
683
- * @returns vNext Workflow instance
684
- */
685
- getVNextWorkflow(workflowId: string): VNextWorkflow;
686
1071
  /**
687
1072
  * Gets a vector instance by name
688
1073
  * @param vectorName - Name of the vector to retrieve
@@ -718,13 +1103,62 @@ declare class MastraClient extends BaseResource {
718
1103
  * Retrieves all available networks
719
1104
  * @returns Promise containing map of network IDs to network details
720
1105
  */
721
- 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>>;
722
1112
  /**
723
1113
  * Gets a network instance by ID
724
1114
  * @param networkId - ID of the network to retrieve
725
1115
  * @returns Network instance
726
1116
  */
727
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;
1156
+ /**
1157
+ * Gets an A2A client for interacting with an agent via the A2A protocol
1158
+ * @param agentId - ID of the agent to interact with
1159
+ * @returns A2A client instance
1160
+ */
1161
+ getA2A(agentId: string): A2A;
728
1162
  }
729
1163
 
730
- 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 };