@mastra/client-js 0.0.0-cloud-transporter-20250513033346 → 0.0.0-cloud-storage-adapter-20251106204059

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.
Files changed (70) hide show
  1. package/CHANGELOG.md +2743 -2
  2. package/LICENSE.md +11 -42
  3. package/README.md +12 -15
  4. package/dist/client.d.ts +254 -0
  5. package/dist/client.d.ts.map +1 -0
  6. package/dist/example.d.ts +2 -0
  7. package/dist/example.d.ts.map +1 -0
  8. package/dist/index.cjs +2679 -797
  9. package/dist/index.cjs.map +1 -0
  10. package/dist/index.d.ts +5 -800
  11. package/dist/index.d.ts.map +1 -0
  12. package/dist/index.js +2680 -800
  13. package/dist/index.js.map +1 -0
  14. package/dist/resources/a2a.d.ts +41 -0
  15. package/dist/resources/a2a.d.ts.map +1 -0
  16. package/dist/resources/agent-builder.d.ts +175 -0
  17. package/dist/resources/agent-builder.d.ts.map +1 -0
  18. package/dist/resources/agent.d.ts +181 -0
  19. package/dist/resources/agent.d.ts.map +1 -0
  20. package/dist/resources/base.d.ts +13 -0
  21. package/dist/resources/base.d.ts.map +1 -0
  22. package/dist/resources/index.d.ts +11 -0
  23. package/dist/resources/index.d.ts.map +1 -0
  24. package/dist/resources/mcp-tool.d.ts +28 -0
  25. package/dist/resources/mcp-tool.d.ts.map +1 -0
  26. package/dist/resources/memory-thread.d.ts +53 -0
  27. package/dist/resources/memory-thread.d.ts.map +1 -0
  28. package/dist/resources/observability.d.ts +35 -0
  29. package/dist/resources/observability.d.ts.map +1 -0
  30. package/dist/resources/tool.d.ts +24 -0
  31. package/dist/resources/tool.d.ts.map +1 -0
  32. package/dist/resources/vector.d.ts +51 -0
  33. package/dist/resources/vector.d.ts.map +1 -0
  34. package/dist/resources/workflow.d.ts +204 -0
  35. package/dist/resources/workflow.d.ts.map +1 -0
  36. package/dist/tools.d.ts +22 -0
  37. package/dist/tools.d.ts.map +1 -0
  38. package/dist/types.d.ts +451 -0
  39. package/dist/types.d.ts.map +1 -0
  40. package/dist/utils/index.d.ts +11 -0
  41. package/dist/utils/index.d.ts.map +1 -0
  42. package/dist/utils/process-client-tools.d.ts +3 -0
  43. package/dist/utils/process-client-tools.d.ts.map +1 -0
  44. package/dist/utils/process-mastra-stream.d.ts +11 -0
  45. package/dist/utils/process-mastra-stream.d.ts.map +1 -0
  46. package/dist/utils/zod-to-json-schema.d.ts +3 -0
  47. package/dist/utils/zod-to-json-schema.d.ts.map +1 -0
  48. package/package.json +41 -20
  49. package/dist/index.d.cts +0 -800
  50. package/eslint.config.js +0 -6
  51. package/src/adapters/agui.test.ts +0 -180
  52. package/src/adapters/agui.ts +0 -239
  53. package/src/client.ts +0 -268
  54. package/src/example.ts +0 -65
  55. package/src/index.test.ts +0 -740
  56. package/src/index.ts +0 -2
  57. package/src/resources/a2a.ts +0 -88
  58. package/src/resources/agent.ts +0 -196
  59. package/src/resources/base.ts +0 -70
  60. package/src/resources/index.ts +0 -9
  61. package/src/resources/memory-thread.ts +0 -63
  62. package/src/resources/network.ts +0 -86
  63. package/src/resources/tool.ts +0 -44
  64. package/src/resources/vector.ts +0 -83
  65. package/src/resources/vnext-workflow.ts +0 -261
  66. package/src/resources/workflow.ts +0 -251
  67. package/src/types.ts +0 -270
  68. package/src/utils/zod-to-json-schema.ts +0 -10
  69. package/tsconfig.json +0 -5
  70. package/vitest.config.js +0 -8
package/dist/index.js CHANGED
@@ -1,199 +1,134 @@
1
- import { AbstractAgent, EventType } from '@ag-ui/client';
2
- import { Observable } from 'rxjs';
3
- import { processDataStream } from '@ai-sdk/ui-utils';
4
- import { ZodSchema } from 'zod';
1
+ import { processDataStream, parsePartialJson } from '@ai-sdk/ui-utils';
2
+ import { v4 } from '@lukeed/uuid';
3
+ import { getErrorFromUnknown } from '@mastra/core/error';
4
+ import { RequestContext } from '@mastra/core/request-context';
5
+ import { isVercelTool } from '@mastra/core/tools/is-vercel-tool';
6
+ import { z } from 'zod';
5
7
  import originalZodToJsonSchema from 'zod-to-json-schema';
6
8
 
7
- // src/adapters/agui.ts
8
- var AGUIAdapter = class extends AbstractAgent {
9
- agent;
10
- resourceId;
11
- constructor({ agent, agentId, resourceId, ...rest }) {
12
- super({
13
- agentId,
14
- ...rest
15
- });
16
- this.agent = agent;
17
- this.resourceId = resourceId;
18
- }
19
- run(input) {
20
- return new Observable((subscriber) => {
21
- const convertedMessages = convertMessagesToMastraMessages(input.messages);
22
- subscriber.next({
23
- type: EventType.RUN_STARTED,
24
- threadId: input.threadId,
25
- runId: input.runId
26
- });
27
- this.agent.stream({
28
- threadId: input.threadId,
29
- resourceId: this.resourceId ?? "",
30
- runId: input.runId,
31
- messages: convertedMessages,
32
- clientTools: input.tools.reduce(
33
- (acc, tool) => {
34
- acc[tool.name] = {
35
- id: tool.name,
36
- description: tool.description,
37
- inputSchema: tool.parameters
38
- };
39
- return acc;
40
- },
41
- {}
42
- )
43
- }).then((response) => {
44
- let currentMessageId = void 0;
45
- let isInTextMessage = false;
46
- return response.processDataStream({
47
- onTextPart: (text) => {
48
- if (currentMessageId === void 0) {
49
- currentMessageId = generateUUID();
50
- const message2 = {
51
- type: EventType.TEXT_MESSAGE_START,
52
- messageId: currentMessageId,
53
- role: "assistant"
54
- };
55
- subscriber.next(message2);
56
- isInTextMessage = true;
57
- }
58
- const message = {
59
- type: EventType.TEXT_MESSAGE_CONTENT,
60
- messageId: currentMessageId,
61
- delta: text
62
- };
63
- subscriber.next(message);
64
- },
65
- onFinishMessagePart: () => {
66
- if (currentMessageId !== void 0) {
67
- const message = {
68
- type: EventType.TEXT_MESSAGE_END,
69
- messageId: currentMessageId
70
- };
71
- subscriber.next(message);
72
- isInTextMessage = false;
73
- }
74
- subscriber.next({
75
- type: EventType.RUN_FINISHED,
76
- threadId: input.threadId,
77
- runId: input.runId
78
- });
79
- subscriber.complete();
80
- },
81
- onToolCallPart(streamPart) {
82
- const parentMessageId = currentMessageId || generateUUID();
83
- if (isInTextMessage) {
84
- const message = {
85
- type: EventType.TEXT_MESSAGE_END,
86
- messageId: parentMessageId
87
- };
88
- subscriber.next(message);
89
- isInTextMessage = false;
90
- }
91
- subscriber.next({
92
- type: EventType.TOOL_CALL_START,
93
- toolCallId: streamPart.toolCallId,
94
- toolCallName: streamPart.toolName,
95
- parentMessageId
96
- });
97
- subscriber.next({
98
- type: EventType.TOOL_CALL_ARGS,
99
- toolCallId: streamPart.toolCallId,
100
- delta: JSON.stringify(streamPart.args),
101
- parentMessageId
102
- });
103
- subscriber.next({
104
- type: EventType.TOOL_CALL_END,
105
- toolCallId: streamPart.toolCallId,
106
- parentMessageId
107
- });
108
- }
109
- });
110
- }).catch((error) => {
111
- console.error("error", error);
112
- subscriber.error(error);
113
- });
114
- return () => {
115
- };
116
- });
117
- }
118
- };
119
- function generateUUID() {
120
- if (typeof crypto !== "undefined") {
121
- if (typeof crypto.randomUUID === "function") {
122
- return crypto.randomUUID();
123
- }
124
- if (typeof crypto.getRandomValues === "function") {
125
- const buffer = new Uint8Array(16);
126
- crypto.getRandomValues(buffer);
127
- buffer[6] = buffer[6] & 15 | 64;
128
- buffer[8] = buffer[8] & 63 | 128;
129
- let hex = "";
130
- for (let i = 0; i < 16; i++) {
131
- hex += buffer[i].toString(16).padStart(2, "0");
132
- if (i === 3 || i === 5 || i === 7 || i === 9) hex += "-";
133
- }
134
- return hex;
9
+ // src/resources/agent.ts
10
+ function parseClientRequestContext(requestContext) {
11
+ if (requestContext) {
12
+ if (requestContext instanceof RequestContext) {
13
+ return Object.fromEntries(requestContext.entries());
135
14
  }
15
+ return requestContext;
136
16
  }
137
- return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
138
- const r = Math.random() * 16 | 0;
139
- const v = c === "x" ? r : r & 3 | 8;
140
- return v.toString(16);
141
- });
17
+ return void 0;
142
18
  }
143
- function convertMessagesToMastraMessages(messages) {
144
- const result = [];
145
- for (const message of messages) {
146
- if (message.role === "assistant") {
147
- const parts = message.content ? [{ type: "text", text: message.content }] : [];
148
- for (const toolCall of message.toolCalls ?? []) {
149
- parts.push({
150
- type: "tool-call",
151
- toolCallId: toolCall.id,
152
- toolName: toolCall.function.name,
153
- args: JSON.parse(toolCall.function.arguments)
154
- });
155
- }
156
- result.push({
157
- role: "assistant",
158
- content: parts
159
- });
160
- if (message.toolCalls?.length) {
161
- result.push({
162
- role: "tool",
163
- content: message.toolCalls.map((toolCall) => ({
164
- type: "tool-result",
165
- toolCallId: toolCall.id,
166
- toolName: toolCall.function.name,
167
- result: JSON.parse(toolCall.function.arguments)
168
- }))
169
- });
170
- }
171
- } else if (message.role === "user") {
172
- result.push({
173
- role: "user",
174
- content: message.content || ""
175
- });
176
- } else if (message.role === "tool") {
177
- result.push({
178
- role: "tool",
179
- content: [
180
- {
181
- type: "tool-result",
182
- toolCallId: message.toolCallId,
183
- toolName: "unknown",
184
- result: message.content
185
- }
186
- ]
187
- });
188
- }
19
+ function base64RequestContext(requestContext) {
20
+ if (requestContext) {
21
+ return btoa(JSON.stringify(requestContext));
189
22
  }
190
- return result;
23
+ return void 0;
24
+ }
25
+ function requestContextQueryString(requestContext, delimiter = "?") {
26
+ const requestContextParam = base64RequestContext(parseClientRequestContext(requestContext));
27
+ if (!requestContextParam) return "";
28
+ const searchParams = new URLSearchParams();
29
+ searchParams.set("requestContext", requestContextParam);
30
+ const queryString = searchParams.toString();
31
+ return queryString ? `${delimiter}${queryString}` : "";
32
+ }
33
+ function isZodType(value) {
34
+ return typeof value === "object" && value !== null && "_def" in value && "parse" in value && typeof value.parse === "function" && "safeParse" in value && typeof value.safeParse === "function";
191
35
  }
192
36
  function zodToJsonSchema(zodSchema) {
193
- if (!(zodSchema instanceof ZodSchema)) {
37
+ if (!isZodType(zodSchema)) {
194
38
  return zodSchema;
195
39
  }
196
- return originalZodToJsonSchema(zodSchema, { $refStrategy: "none" });
40
+ if ("toJSONSchema" in z) {
41
+ const fn = "toJSONSchema";
42
+ return z[fn].call(z, zodSchema);
43
+ }
44
+ return originalZodToJsonSchema(zodSchema, { $refStrategy: "relative" });
45
+ }
46
+
47
+ // src/utils/process-client-tools.ts
48
+ function processClientTools(clientTools) {
49
+ if (!clientTools) {
50
+ return void 0;
51
+ }
52
+ return Object.fromEntries(
53
+ Object.entries(clientTools).map(([key, value]) => {
54
+ if (isVercelTool(value)) {
55
+ return [
56
+ key,
57
+ {
58
+ ...value,
59
+ parameters: value.parameters ? zodToJsonSchema(value.parameters) : void 0
60
+ }
61
+ ];
62
+ } else {
63
+ return [
64
+ key,
65
+ {
66
+ ...value,
67
+ inputSchema: value.inputSchema ? zodToJsonSchema(value.inputSchema) : void 0,
68
+ outputSchema: value.outputSchema ? zodToJsonSchema(value.outputSchema) : void 0
69
+ }
70
+ ];
71
+ }
72
+ })
73
+ );
74
+ }
75
+
76
+ // src/utils/process-mastra-stream.ts
77
+ async function sharedProcessMastraStream({
78
+ stream,
79
+ onChunk
80
+ }) {
81
+ const reader = stream.getReader();
82
+ const decoder = new TextDecoder();
83
+ let buffer = "";
84
+ try {
85
+ while (true) {
86
+ const { done, value } = await reader.read();
87
+ if (done) break;
88
+ buffer += decoder.decode(value, { stream: true });
89
+ const lines = buffer.split("\n\n");
90
+ buffer = lines.pop() || "";
91
+ for (const line of lines) {
92
+ if (line.startsWith("data: ")) {
93
+ const data = line.slice(6);
94
+ if (data === "[DONE]") {
95
+ console.info("\u{1F3C1} Stream finished");
96
+ return;
97
+ }
98
+ let json;
99
+ try {
100
+ json = JSON.parse(data);
101
+ } catch (error) {
102
+ console.error("\u274C JSON parse error:", error, "Data:", data);
103
+ continue;
104
+ }
105
+ if (json) {
106
+ await onChunk(json);
107
+ }
108
+ }
109
+ }
110
+ }
111
+ } finally {
112
+ reader.releaseLock();
113
+ }
114
+ }
115
+ async function processMastraNetworkStream({
116
+ stream,
117
+ onChunk
118
+ }) {
119
+ return sharedProcessMastraStream({
120
+ stream,
121
+ onChunk
122
+ });
123
+ }
124
+ async function processMastraStream({
125
+ stream,
126
+ onChunk
127
+ }) {
128
+ return sharedProcessMastraStream({
129
+ stream,
130
+ onChunk
131
+ });
197
132
  }
198
133
 
199
134
  // src/resources/base.ts
@@ -210,18 +145,21 @@ var BaseResource = class {
210
145
  */
211
146
  async request(path, options = {}) {
212
147
  let lastError = null;
213
- const { baseUrl, retries = 3, backoffMs = 100, maxBackoffMs = 1e3, headers = {} } = this.options;
148
+ const { baseUrl, retries = 3, backoffMs = 100, maxBackoffMs = 1e3, headers = {}, credentials } = this.options;
214
149
  let delay = backoffMs;
215
150
  for (let attempt = 0; attempt <= retries; attempt++) {
216
151
  try {
217
- const response = await fetch(`${baseUrl}${path}`, {
152
+ const response = await fetch(`${baseUrl.replace(/\/$/, "")}${path}`, {
218
153
  ...options,
219
154
  headers: {
155
+ ...options.body && !(options.body instanceof FormData) && (options.method === "POST" || options.method === "PUT") ? { "content-type": "application/json" } : {},
220
156
  ...headers,
221
157
  ...options.headers
222
158
  // TODO: Bring this back once we figure out what we/users need to do to make this work with cross-origin requests
223
159
  // 'x-mastra-client-type': 'js',
224
160
  },
161
+ signal: this.options.abortSignal,
162
+ credentials: options.credentials ?? credentials,
225
163
  body: options.body instanceof FormData ? options.body : options.body ? JSON.stringify(options.body) : void 0
226
164
  });
227
165
  if (!response.ok) {
@@ -256,6 +194,56 @@ var BaseResource = class {
256
194
  };
257
195
 
258
196
  // src/resources/agent.ts
197
+ async function executeToolCallAndRespond({
198
+ response,
199
+ params,
200
+ resourceId,
201
+ threadId,
202
+ requestContext,
203
+ respondFn
204
+ }) {
205
+ if (response.finishReason === "tool-calls") {
206
+ const toolCalls = response.toolCalls;
207
+ if (!toolCalls || !Array.isArray(toolCalls)) {
208
+ return response;
209
+ }
210
+ for (const toolCall of toolCalls) {
211
+ const clientTool = params.clientTools?.[toolCall.toolName];
212
+ if (clientTool && clientTool.execute) {
213
+ const result = await clientTool.execute(toolCall?.args, {
214
+ requestContext,
215
+ tracingContext: { currentSpan: void 0 },
216
+ agent: {
217
+ messages: response.messages,
218
+ toolCallId: toolCall?.toolCallId,
219
+ suspend: async () => {
220
+ },
221
+ threadId,
222
+ resourceId
223
+ }
224
+ });
225
+ const updatedMessages = [
226
+ ...response.response.messages || [],
227
+ {
228
+ role: "tool",
229
+ content: [
230
+ {
231
+ type: "tool-result",
232
+ toolCallId: toolCall.toolCallId,
233
+ toolName: toolCall.toolName,
234
+ result
235
+ }
236
+ ]
237
+ }
238
+ ];
239
+ return respondFn({
240
+ ...params,
241
+ messages: updatedMessages
242
+ });
243
+ }
244
+ }
245
+ }
246
+ }
259
247
  var AgentVoice = class extends BaseResource {
260
248
  constructor(options, agentId) {
261
249
  super(options);
@@ -297,10 +285,21 @@ var AgentVoice = class extends BaseResource {
297
285
  }
298
286
  /**
299
287
  * Get available speakers for the agent's voice provider
288
+ * @param requestContext - Optional request context to pass as query parameter
289
+ * @param requestContext - Optional request context to pass as query parameter
300
290
  * @returns Promise containing list of available speakers
301
291
  */
302
- getSpeakers() {
303
- return this.request(`/api/agents/${this.agentId}/voice/speakers`);
292
+ getSpeakers(requestContext) {
293
+ return this.request(`/api/agents/${this.agentId}/voice/speakers${requestContextQueryString(requestContext)}`);
294
+ }
295
+ /**
296
+ * Get the listener configuration for the agent's voice provider
297
+ * @param requestContext - Optional request context to pass as query parameter
298
+ * @param requestContext - Optional request context to pass as query parameter
299
+ * @returns Promise containing a check if the agent has listening capabilities
300
+ */
301
+ getListener(requestContext) {
302
+ return this.request(`/api/agents/${this.agentId}/voice/listener${requestContextQueryString(requestContext)}`);
304
303
  }
305
304
  };
306
305
  var Agent = class extends BaseResource {
@@ -312,215 +311,1168 @@ var Agent = class extends BaseResource {
312
311
  voice;
313
312
  /**
314
313
  * Retrieves details about the agent
314
+ * @param requestContext - Optional request context to pass as query parameter
315
315
  * @returns Promise containing agent details including model and instructions
316
316
  */
317
- details() {
318
- return this.request(`/api/agents/${this.agentId}`);
317
+ details(requestContext) {
318
+ return this.request(`/api/agents/${this.agentId}${requestContextQueryString(requestContext)}`);
319
319
  }
320
- /**
321
- * Generates a response from the agent
322
- * @param params - Generation parameters including prompt
323
- * @returns Promise containing the generated response
324
- */
325
- generate(params) {
326
- const processedParams = {
327
- ...params,
328
- output: zodToJsonSchema(params.output),
329
- experimental_output: zodToJsonSchema(params.experimental_output),
330
- runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
331
- };
332
- return this.request(`/api/agents/${this.agentId}/generate`, {
320
+ enhanceInstructions(instructions, comment) {
321
+ return this.request(`/api/agents/${this.agentId}/instructions/enhance`, {
333
322
  method: "POST",
334
- body: processedParams
323
+ body: { instructions, comment }
335
324
  });
336
325
  }
337
- /**
338
- * Streams a response from the agent
339
- * @param params - Stream parameters including prompt
340
- * @returns Promise containing the enhanced Response object with processDataStream method
341
- */
342
- async stream(params) {
326
+ async generateLegacy(params) {
343
327
  const processedParams = {
344
328
  ...params,
345
- output: zodToJsonSchema(params.output),
346
- experimental_output: zodToJsonSchema(params.experimental_output),
347
- runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
329
+ output: params.output ? zodToJsonSchema(params.output) : void 0,
330
+ experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
331
+ requestContext: parseClientRequestContext(params.requestContext),
332
+ clientTools: processClientTools(params.clientTools)
348
333
  };
349
- const response = await this.request(`/api/agents/${this.agentId}/stream`, {
350
- method: "POST",
351
- body: processedParams,
352
- stream: true
353
- });
354
- if (!response.body) {
355
- throw new Error("No response body");
334
+ const { resourceId, threadId, requestContext } = processedParams;
335
+ const response = await this.request(
336
+ `/api/agents/${this.agentId}/generate-legacy`,
337
+ {
338
+ method: "POST",
339
+ body: processedParams
340
+ }
341
+ );
342
+ if (response.finishReason === "tool-calls") {
343
+ const toolCalls = response.toolCalls;
344
+ if (!toolCalls || !Array.isArray(toolCalls)) {
345
+ return response;
346
+ }
347
+ for (const toolCall of toolCalls) {
348
+ const clientTool = params.clientTools?.[toolCall.toolName];
349
+ if (clientTool && clientTool.execute) {
350
+ const result = await clientTool.execute(toolCall?.args, {
351
+ requestContext,
352
+ tracingContext: { currentSpan: void 0 },
353
+ agent: {
354
+ messages: response.messages,
355
+ toolCallId: toolCall?.toolCallId,
356
+ suspend: async () => {
357
+ },
358
+ threadId,
359
+ resourceId
360
+ }
361
+ });
362
+ const updatedMessages = [
363
+ ...response.response.messages,
364
+ {
365
+ role: "tool",
366
+ content: [
367
+ {
368
+ type: "tool-result",
369
+ toolCallId: toolCall.toolCallId,
370
+ toolName: toolCall.toolName,
371
+ result
372
+ }
373
+ ]
374
+ }
375
+ ];
376
+ return this.generate({
377
+ ...params,
378
+ messages: updatedMessages
379
+ });
380
+ }
381
+ }
356
382
  }
357
- response.processDataStream = async (options = {}) => {
358
- await processDataStream({
359
- stream: response.body,
383
+ return response;
384
+ }
385
+ async generate(messagesOrParams, options) {
386
+ let params;
387
+ if (typeof messagesOrParams === "object" && "messages" in messagesOrParams) {
388
+ params = messagesOrParams;
389
+ } else {
390
+ params = {
391
+ messages: messagesOrParams,
360
392
  ...options
361
- });
393
+ };
394
+ }
395
+ const processedParams = {
396
+ ...params,
397
+ requestContext: parseClientRequestContext(params.requestContext),
398
+ clientTools: processClientTools(params.clientTools),
399
+ structuredOutput: params.structuredOutput ? {
400
+ ...params.structuredOutput,
401
+ schema: zodToJsonSchema(params.structuredOutput.schema)
402
+ } : void 0
362
403
  };
404
+ const { resourceId, threadId, requestContext } = processedParams;
405
+ const response = await this.request(
406
+ `/api/agents/${this.agentId}/generate`,
407
+ {
408
+ method: "POST",
409
+ body: processedParams
410
+ }
411
+ );
412
+ if (response.finishReason === "tool-calls") {
413
+ return executeToolCallAndRespond({
414
+ response,
415
+ params,
416
+ resourceId,
417
+ threadId,
418
+ requestContext,
419
+ respondFn: this.generate.bind(this)
420
+ });
421
+ }
363
422
  return response;
364
423
  }
365
- /**
366
- * Gets details about a specific tool available to the agent
367
- * @param toolId - ID of the tool to retrieve
368
- * @returns Promise containing tool details
369
- */
370
- getTool(toolId) {
371
- return this.request(`/api/agents/${this.agentId}/tools/${toolId}`);
372
- }
373
- /**
374
- * Executes a tool for the agent
375
- * @param toolId - ID of the tool to execute
376
- * @param params - Parameters required for tool execution
377
- * @returns Promise containing the tool execution results
378
- */
379
- executeTool(toolId, params) {
380
- const body = {
381
- data: params.data,
382
- runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
424
+ async processChatResponse({
425
+ stream,
426
+ update,
427
+ onToolCall,
428
+ onFinish,
429
+ getCurrentDate = () => /* @__PURE__ */ new Date(),
430
+ lastMessage
431
+ }) {
432
+ const replaceLastMessage = lastMessage?.role === "assistant";
433
+ let step = replaceLastMessage ? 1 + // find max step in existing tool invocations:
434
+ (lastMessage.toolInvocations?.reduce((max, toolInvocation) => {
435
+ return Math.max(max, toolInvocation.step ?? 0);
436
+ }, 0) ?? 0) : 0;
437
+ const message = replaceLastMessage ? structuredClone(lastMessage) : {
438
+ id: v4(),
439
+ createdAt: getCurrentDate(),
440
+ role: "assistant",
441
+ content: "",
442
+ parts: []
383
443
  };
384
- return this.request(`/api/agents/${this.agentId}/tools/${toolId}/execute`, {
385
- method: "POST",
386
- body
387
- });
388
- }
389
- /**
390
- * Retrieves evaluation results for the agent
391
- * @returns Promise containing agent evaluations
392
- */
393
- evals() {
394
- return this.request(`/api/agents/${this.agentId}/evals/ci`);
395
- }
396
- /**
397
- * Retrieves live evaluation results for the agent
398
- * @returns Promise containing live agent evaluations
399
- */
400
- liveEvals() {
401
- return this.request(`/api/agents/${this.agentId}/evals/live`);
402
- }
403
- };
404
- var Network = class extends BaseResource {
405
- constructor(options, networkId) {
406
- super(options);
407
- this.networkId = networkId;
408
- }
409
- /**
410
- * Retrieves details about the network
411
- * @returns Promise containing network details
412
- */
413
- details() {
414
- return this.request(`/api/networks/${this.networkId}`);
415
- }
416
- /**
417
- * Generates a response from the agent
418
- * @param params - Generation parameters including prompt
419
- * @returns Promise containing the generated response
420
- */
421
- generate(params) {
422
- const processedParams = {
423
- ...params,
424
- output: zodToJsonSchema(params.output),
425
- experimental_output: zodToJsonSchema(params.experimental_output)
444
+ let currentTextPart = void 0;
445
+ let currentReasoningPart = void 0;
446
+ let currentReasoningTextDetail = void 0;
447
+ function updateToolInvocationPart(toolCallId, invocation) {
448
+ const part = message.parts.find(
449
+ (part2) => part2.type === "tool-invocation" && part2.toolInvocation.toolCallId === toolCallId
450
+ );
451
+ if (part != null) {
452
+ part.toolInvocation = invocation;
453
+ } else {
454
+ message.parts.push({
455
+ type: "tool-invocation",
456
+ toolInvocation: invocation
457
+ });
458
+ }
459
+ }
460
+ const data = [];
461
+ let messageAnnotations = replaceLastMessage ? lastMessage?.annotations : void 0;
462
+ const partialToolCalls = {};
463
+ let usage = {
464
+ completionTokens: NaN,
465
+ promptTokens: NaN,
466
+ totalTokens: NaN
426
467
  };
427
- return this.request(`/api/networks/${this.networkId}/generate`, {
428
- method: "POST",
429
- body: processedParams
468
+ let finishReason = "unknown";
469
+ function execUpdate() {
470
+ const copiedData = [...data];
471
+ if (messageAnnotations?.length) {
472
+ message.annotations = messageAnnotations;
473
+ }
474
+ const copiedMessage = {
475
+ // deep copy the message to ensure that deep changes (msg attachments) are updated
476
+ // with SolidJS. SolidJS uses referential integration of sub-objects to detect changes.
477
+ ...structuredClone(message),
478
+ // add a revision id to ensure that the message is updated with SWR. SWR uses a
479
+ // hashing approach by default to detect changes, but it only works for shallow
480
+ // changes. This is why we need to add a revision id to ensure that the message
481
+ // is updated with SWR (without it, the changes get stuck in SWR and are not
482
+ // forwarded to rendering):
483
+ revisionId: v4()
484
+ };
485
+ update({
486
+ message: copiedMessage,
487
+ data: copiedData,
488
+ replaceLastMessage
489
+ });
490
+ }
491
+ await processDataStream({
492
+ stream,
493
+ onTextPart(value) {
494
+ if (currentTextPart == null) {
495
+ currentTextPart = {
496
+ type: "text",
497
+ text: value
498
+ };
499
+ message.parts.push(currentTextPart);
500
+ } else {
501
+ currentTextPart.text += value;
502
+ }
503
+ message.content += value;
504
+ execUpdate();
505
+ },
506
+ onReasoningPart(value) {
507
+ if (currentReasoningTextDetail == null) {
508
+ currentReasoningTextDetail = { type: "text", text: value };
509
+ if (currentReasoningPart != null) {
510
+ currentReasoningPart.details.push(currentReasoningTextDetail);
511
+ }
512
+ } else {
513
+ currentReasoningTextDetail.text += value;
514
+ }
515
+ if (currentReasoningPart == null) {
516
+ currentReasoningPart = {
517
+ type: "reasoning",
518
+ reasoning: value,
519
+ details: [currentReasoningTextDetail]
520
+ };
521
+ message.parts.push(currentReasoningPart);
522
+ } else {
523
+ currentReasoningPart.reasoning += value;
524
+ }
525
+ message.reasoning = (message.reasoning ?? "") + value;
526
+ execUpdate();
527
+ },
528
+ onReasoningSignaturePart(value) {
529
+ if (currentReasoningTextDetail != null) {
530
+ currentReasoningTextDetail.signature = value.signature;
531
+ }
532
+ },
533
+ onRedactedReasoningPart(value) {
534
+ if (currentReasoningPart == null) {
535
+ currentReasoningPart = {
536
+ type: "reasoning",
537
+ reasoning: "",
538
+ details: []
539
+ };
540
+ message.parts.push(currentReasoningPart);
541
+ }
542
+ currentReasoningPart.details.push({
543
+ type: "redacted",
544
+ data: value.data
545
+ });
546
+ currentReasoningTextDetail = void 0;
547
+ execUpdate();
548
+ },
549
+ onFilePart(value) {
550
+ message.parts.push({
551
+ type: "file",
552
+ mimeType: value.mimeType,
553
+ data: value.data
554
+ });
555
+ execUpdate();
556
+ },
557
+ onSourcePart(value) {
558
+ message.parts.push({
559
+ type: "source",
560
+ source: value
561
+ });
562
+ execUpdate();
563
+ },
564
+ onToolCallStreamingStartPart(value) {
565
+ if (message.toolInvocations == null) {
566
+ message.toolInvocations = [];
567
+ }
568
+ partialToolCalls[value.toolCallId] = {
569
+ text: "",
570
+ step,
571
+ toolName: value.toolName,
572
+ index: message.toolInvocations.length
573
+ };
574
+ const invocation = {
575
+ state: "partial-call",
576
+ step,
577
+ toolCallId: value.toolCallId,
578
+ toolName: value.toolName,
579
+ args: void 0
580
+ };
581
+ message.toolInvocations.push(invocation);
582
+ updateToolInvocationPart(value.toolCallId, invocation);
583
+ execUpdate();
584
+ },
585
+ onToolCallDeltaPart(value) {
586
+ const partialToolCall = partialToolCalls[value.toolCallId];
587
+ partialToolCall.text += value.argsTextDelta;
588
+ const { value: partialArgs } = parsePartialJson(partialToolCall.text);
589
+ const invocation = {
590
+ state: "partial-call",
591
+ step: partialToolCall.step,
592
+ toolCallId: value.toolCallId,
593
+ toolName: partialToolCall.toolName,
594
+ args: partialArgs
595
+ };
596
+ message.toolInvocations[partialToolCall.index] = invocation;
597
+ updateToolInvocationPart(value.toolCallId, invocation);
598
+ execUpdate();
599
+ },
600
+ async onToolCallPart(value) {
601
+ const invocation = {
602
+ state: "call",
603
+ step,
604
+ ...value
605
+ };
606
+ if (partialToolCalls[value.toolCallId] != null) {
607
+ message.toolInvocations[partialToolCalls[value.toolCallId].index] = invocation;
608
+ } else {
609
+ if (message.toolInvocations == null) {
610
+ message.toolInvocations = [];
611
+ }
612
+ message.toolInvocations.push(invocation);
613
+ }
614
+ updateToolInvocationPart(value.toolCallId, invocation);
615
+ execUpdate();
616
+ if (onToolCall) {
617
+ const result = await onToolCall({ toolCall: value });
618
+ if (result != null) {
619
+ const invocation2 = {
620
+ state: "result",
621
+ step,
622
+ ...value,
623
+ result
624
+ };
625
+ message.toolInvocations[message.toolInvocations.length - 1] = invocation2;
626
+ updateToolInvocationPart(value.toolCallId, invocation2);
627
+ execUpdate();
628
+ }
629
+ }
630
+ },
631
+ onToolResultPart(value) {
632
+ const toolInvocations = message.toolInvocations;
633
+ if (toolInvocations == null) {
634
+ throw new Error("tool_result must be preceded by a tool_call");
635
+ }
636
+ const toolInvocationIndex = toolInvocations.findIndex((invocation2) => invocation2.toolCallId === value.toolCallId);
637
+ if (toolInvocationIndex === -1) {
638
+ throw new Error("tool_result must be preceded by a tool_call with the same toolCallId");
639
+ }
640
+ const invocation = {
641
+ ...toolInvocations[toolInvocationIndex],
642
+ state: "result",
643
+ ...value
644
+ };
645
+ toolInvocations[toolInvocationIndex] = invocation;
646
+ updateToolInvocationPart(value.toolCallId, invocation);
647
+ execUpdate();
648
+ },
649
+ onDataPart(value) {
650
+ data.push(...value);
651
+ execUpdate();
652
+ },
653
+ onMessageAnnotationsPart(value) {
654
+ if (messageAnnotations == null) {
655
+ messageAnnotations = [...value];
656
+ } else {
657
+ messageAnnotations.push(...value);
658
+ }
659
+ execUpdate();
660
+ },
661
+ onFinishStepPart(value) {
662
+ step += 1;
663
+ currentTextPart = value.isContinued ? currentTextPart : void 0;
664
+ currentReasoningPart = void 0;
665
+ currentReasoningTextDetail = void 0;
666
+ },
667
+ onStartStepPart(value) {
668
+ if (!replaceLastMessage) {
669
+ message.id = value.messageId;
670
+ }
671
+ message.parts.push({ type: "step-start" });
672
+ execUpdate();
673
+ },
674
+ onFinishMessagePart(value) {
675
+ finishReason = value.finishReason;
676
+ if (value.usage != null) {
677
+ usage = value.usage;
678
+ }
679
+ },
680
+ onErrorPart(error) {
681
+ throw new Error(error);
682
+ }
430
683
  });
684
+ onFinish?.({ message, finishReason, usage });
431
685
  }
432
686
  /**
433
687
  * Streams a response from the agent
434
688
  * @param params - Stream parameters including prompt
435
689
  * @returns Promise containing the enhanced Response object with processDataStream method
436
690
  */
437
- async stream(params) {
691
+ async streamLegacy(params) {
438
692
  const processedParams = {
439
693
  ...params,
440
- output: zodToJsonSchema(params.output),
441
- experimental_output: zodToJsonSchema(params.experimental_output)
694
+ output: params.output ? zodToJsonSchema(params.output) : void 0,
695
+ experimental_output: params.experimental_output ? zodToJsonSchema(params.experimental_output) : void 0,
696
+ requestContext: parseClientRequestContext(params.requestContext),
697
+ clientTools: processClientTools(params.clientTools)
442
698
  };
443
- const response = await this.request(`/api/networks/${this.networkId}/stream`, {
444
- method: "POST",
445
- body: processedParams,
446
- stream: true
699
+ const { readable, writable } = new TransformStream();
700
+ const response = await this.processStreamResponseLegacy(processedParams, writable);
701
+ const streamResponse = new Response(readable, {
702
+ status: response.status,
703
+ statusText: response.statusText,
704
+ headers: response.headers
447
705
  });
448
- if (!response.body) {
449
- throw new Error("No response body");
450
- }
451
- response.processDataStream = async (options = {}) => {
706
+ streamResponse.processDataStream = async (options = {}) => {
452
707
  await processDataStream({
453
- stream: response.body,
708
+ stream: streamResponse.body,
454
709
  ...options
455
710
  });
456
711
  };
457
- return response;
458
- }
459
- };
460
-
461
- // src/resources/memory-thread.ts
462
- var MemoryThread = class extends BaseResource {
463
- constructor(options, threadId, agentId) {
464
- super(options);
465
- this.threadId = threadId;
466
- this.agentId = agentId;
467
- }
468
- /**
469
- * Retrieves the memory thread details
470
- * @returns Promise containing thread details including title and metadata
471
- */
472
- get() {
473
- return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`);
474
- }
475
- /**
476
- * Updates the memory thread properties
477
- * @param params - Update parameters including title and metadata
478
- * @returns Promise containing updated thread details
479
- */
480
- update(params) {
481
- return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
482
- method: "PATCH",
483
- body: params
484
- });
485
- }
486
- /**
487
- * Deletes the memory thread
488
- * @returns Promise containing deletion result
489
- */
490
- delete() {
491
- return this.request(`/api/memory/threads/${this.threadId}?agentId=${this.agentId}`, {
492
- method: "DELETE"
493
- });
494
- }
495
- /**
496
- * Retrieves messages associated with the thread
497
- * @param params - Optional parameters including limit for number of messages to retrieve
498
- * @returns Promise containing thread messages and UI messages
499
- */
500
- getMessages(params) {
501
- const query = new URLSearchParams({
502
- agentId: this.agentId,
503
- ...params?.limit ? { limit: params.limit.toString() } : {}
504
- });
505
- return this.request(`/api/memory/threads/${this.threadId}/messages?${query.toString()}`);
506
- }
507
- };
508
-
509
- // src/resources/vector.ts
510
- var Vector = class extends BaseResource {
511
- constructor(options, vectorName) {
512
- super(options);
513
- this.vectorName = vectorName;
514
- }
515
- /**
516
- * Retrieves details about a specific vector index
517
- * @param indexName - Name of the index to get details for
518
- * @returns Promise containing vector index details
519
- */
520
- details(indexName) {
521
- return this.request(`/api/vector/${this.vectorName}/indexes/${indexName}`);
522
- }
523
- /**
712
+ return streamResponse;
713
+ }
714
+ async processChatResponse_vNext({
715
+ stream,
716
+ update,
717
+ onToolCall,
718
+ onFinish,
719
+ getCurrentDate = () => /* @__PURE__ */ new Date(),
720
+ lastMessage
721
+ }) {
722
+ const replaceLastMessage = lastMessage?.role === "assistant";
723
+ let step = replaceLastMessage ? 1 + // find max step in existing tool invocations:
724
+ (lastMessage.toolInvocations?.reduce((max, toolInvocation) => {
725
+ return Math.max(max, toolInvocation.step ?? 0);
726
+ }, 0) ?? 0) : 0;
727
+ const message = replaceLastMessage ? structuredClone(lastMessage) : {
728
+ id: v4(),
729
+ createdAt: getCurrentDate(),
730
+ role: "assistant",
731
+ content: "",
732
+ parts: []
733
+ };
734
+ let currentTextPart = void 0;
735
+ let currentReasoningPart = void 0;
736
+ let currentReasoningTextDetail = void 0;
737
+ function updateToolInvocationPart(toolCallId, invocation) {
738
+ const part = message.parts.find(
739
+ (part2) => part2.type === "tool-invocation" && part2.toolInvocation.toolCallId === toolCallId
740
+ );
741
+ if (part != null) {
742
+ part.toolInvocation = invocation;
743
+ } else {
744
+ message.parts.push({
745
+ type: "tool-invocation",
746
+ toolInvocation: invocation
747
+ });
748
+ }
749
+ }
750
+ const data = [];
751
+ let messageAnnotations = replaceLastMessage ? lastMessage?.annotations : void 0;
752
+ const partialToolCalls = {};
753
+ let usage = {
754
+ completionTokens: NaN,
755
+ promptTokens: NaN,
756
+ totalTokens: NaN
757
+ };
758
+ let finishReason = "unknown";
759
+ function execUpdate() {
760
+ const copiedData = [...data];
761
+ if (messageAnnotations?.length) {
762
+ message.annotations = messageAnnotations;
763
+ }
764
+ const copiedMessage = {
765
+ // deep copy the message to ensure that deep changes (msg attachments) are updated
766
+ // with SolidJS. SolidJS uses referential integration of sub-objects to detect changes.
767
+ ...structuredClone(message),
768
+ // add a revision id to ensure that the message is updated with SWR. SWR uses a
769
+ // hashing approach by default to detect changes, but it only works for shallow
770
+ // changes. This is why we need to add a revision id to ensure that the message
771
+ // is updated with SWR (without it, the changes get stuck in SWR and are not
772
+ // forwarded to rendering):
773
+ revisionId: v4()
774
+ };
775
+ update({
776
+ message: copiedMessage,
777
+ data: copiedData,
778
+ replaceLastMessage
779
+ });
780
+ }
781
+ await processMastraStream({
782
+ stream,
783
+ // TODO: casting as any here because the stream types were all typed as any before in core.
784
+ // but this is completely wrong and this fn is probably broken. Remove ":any" and you'll see a bunch of type errors
785
+ onChunk: async (chunk) => {
786
+ switch (chunk.type) {
787
+ case "tripwire": {
788
+ message.parts.push({
789
+ type: "text",
790
+ text: chunk.payload.tripwireReason
791
+ });
792
+ execUpdate();
793
+ break;
794
+ }
795
+ case "step-start": {
796
+ if (!replaceLastMessage) {
797
+ message.id = chunk.payload.messageId;
798
+ }
799
+ message.parts.push({ type: "step-start" });
800
+ execUpdate();
801
+ break;
802
+ }
803
+ case "text-delta": {
804
+ if (currentTextPart == null) {
805
+ currentTextPart = {
806
+ type: "text",
807
+ text: chunk.payload.text
808
+ };
809
+ message.parts.push(currentTextPart);
810
+ } else {
811
+ currentTextPart.text += chunk.payload.text;
812
+ }
813
+ message.content += chunk.payload.text;
814
+ execUpdate();
815
+ break;
816
+ }
817
+ case "reasoning-delta": {
818
+ if (currentReasoningTextDetail == null) {
819
+ currentReasoningTextDetail = { type: "text", text: chunk.payload.text };
820
+ if (currentReasoningPart != null) {
821
+ currentReasoningPart.details.push(currentReasoningTextDetail);
822
+ }
823
+ } else {
824
+ currentReasoningTextDetail.text += chunk.payload.text;
825
+ }
826
+ if (currentReasoningPart == null) {
827
+ currentReasoningPart = {
828
+ type: "reasoning",
829
+ reasoning: chunk.payload.text,
830
+ details: [currentReasoningTextDetail]
831
+ };
832
+ message.parts.push(currentReasoningPart);
833
+ } else {
834
+ currentReasoningPart.reasoning += chunk.payload.text;
835
+ }
836
+ message.reasoning = (message.reasoning ?? "") + chunk.payload.text;
837
+ execUpdate();
838
+ break;
839
+ }
840
+ case "file": {
841
+ message.parts.push({
842
+ type: "file",
843
+ mimeType: chunk.payload.mimeType,
844
+ data: chunk.payload.data
845
+ });
846
+ execUpdate();
847
+ break;
848
+ }
849
+ case "source": {
850
+ message.parts.push({
851
+ type: "source",
852
+ source: chunk.payload.source
853
+ });
854
+ execUpdate();
855
+ break;
856
+ }
857
+ case "tool-call": {
858
+ const invocation = {
859
+ state: "call",
860
+ step,
861
+ ...chunk.payload
862
+ };
863
+ if (partialToolCalls[chunk.payload.toolCallId] != null) {
864
+ message.toolInvocations[partialToolCalls[chunk.payload.toolCallId].index] = invocation;
865
+ } else {
866
+ if (message.toolInvocations == null) {
867
+ message.toolInvocations = [];
868
+ }
869
+ message.toolInvocations.push(invocation);
870
+ }
871
+ updateToolInvocationPart(chunk.payload.toolCallId, invocation);
872
+ execUpdate();
873
+ if (onToolCall) {
874
+ const result = await onToolCall({ toolCall: chunk.payload });
875
+ if (result != null) {
876
+ const invocation2 = {
877
+ state: "result",
878
+ step,
879
+ ...chunk.payload,
880
+ result
881
+ };
882
+ message.toolInvocations[message.toolInvocations.length - 1] = invocation2;
883
+ updateToolInvocationPart(chunk.payload.toolCallId, invocation2);
884
+ execUpdate();
885
+ }
886
+ }
887
+ }
888
+ case "tool-call-input-streaming-start": {
889
+ if (message.toolInvocations == null) {
890
+ message.toolInvocations = [];
891
+ }
892
+ partialToolCalls[chunk.payload.toolCallId] = {
893
+ text: "",
894
+ step,
895
+ toolName: chunk.payload.toolName,
896
+ index: message.toolInvocations.length
897
+ };
898
+ const invocation = {
899
+ state: "partial-call",
900
+ step,
901
+ toolCallId: chunk.payload.toolCallId,
902
+ toolName: chunk.payload.toolName,
903
+ args: chunk.payload.args
904
+ };
905
+ message.toolInvocations.push(invocation);
906
+ updateToolInvocationPart(chunk.payload.toolCallId, invocation);
907
+ execUpdate();
908
+ break;
909
+ }
910
+ case "tool-call-delta": {
911
+ const partialToolCall = partialToolCalls[chunk.payload.toolCallId];
912
+ partialToolCall.text += chunk.payload.argsTextDelta;
913
+ const { value: partialArgs } = parsePartialJson(partialToolCall.text);
914
+ const invocation = {
915
+ state: "partial-call",
916
+ step: partialToolCall.step,
917
+ toolCallId: chunk.payload.toolCallId,
918
+ toolName: partialToolCall.toolName,
919
+ args: partialArgs
920
+ };
921
+ message.toolInvocations[partialToolCall.index] = invocation;
922
+ updateToolInvocationPart(chunk.payload.toolCallId, invocation);
923
+ execUpdate();
924
+ break;
925
+ }
926
+ case "tool-result": {
927
+ const toolInvocations = message.toolInvocations;
928
+ if (toolInvocations == null) {
929
+ throw new Error("tool_result must be preceded by a tool_call");
930
+ }
931
+ const toolInvocationIndex = toolInvocations.findIndex(
932
+ (invocation2) => invocation2.toolCallId === chunk.payload.toolCallId
933
+ );
934
+ if (toolInvocationIndex === -1) {
935
+ throw new Error("tool_result must be preceded by a tool_call with the same toolCallId");
936
+ }
937
+ const invocation = {
938
+ ...toolInvocations[toolInvocationIndex],
939
+ state: "result",
940
+ ...chunk.payload
941
+ };
942
+ toolInvocations[toolInvocationIndex] = invocation;
943
+ updateToolInvocationPart(chunk.payload.toolCallId, invocation);
944
+ execUpdate();
945
+ break;
946
+ }
947
+ case "error": {
948
+ throw getErrorFromUnknown(chunk.payload.error, {
949
+ fallbackMessage: "Unknown error in stream",
950
+ supportSerialization: false
951
+ });
952
+ }
953
+ case "data": {
954
+ data.push(...chunk.payload.data);
955
+ execUpdate();
956
+ break;
957
+ }
958
+ case "step-finish": {
959
+ step += 1;
960
+ currentTextPart = chunk.payload.stepResult.isContinued ? currentTextPart : void 0;
961
+ currentReasoningPart = void 0;
962
+ currentReasoningTextDetail = void 0;
963
+ execUpdate();
964
+ break;
965
+ }
966
+ case "finish": {
967
+ finishReason = chunk.payload.stepResult.reason;
968
+ if (chunk.payload.usage != null) {
969
+ usage = chunk.payload.usage;
970
+ }
971
+ break;
972
+ }
973
+ }
974
+ }
975
+ });
976
+ onFinish?.({ message, finishReason, usage });
977
+ }
978
+ async processStreamResponse(processedParams, writable, route = "stream") {
979
+ const response = await this.request(`/api/agents/${this.agentId}/${route}`, {
980
+ method: "POST",
981
+ body: processedParams,
982
+ stream: true
983
+ });
984
+ if (!response.body) {
985
+ throw new Error("No response body");
986
+ }
987
+ try {
988
+ let toolCalls = [];
989
+ let messages = [];
990
+ const [streamForWritable, streamForProcessing] = response.body.tee();
991
+ streamForWritable.pipeTo(
992
+ new WritableStream({
993
+ async write(chunk) {
994
+ let writer;
995
+ try {
996
+ writer = writable.getWriter();
997
+ const text = new TextDecoder().decode(chunk);
998
+ const lines = text.split("\n\n");
999
+ const readableLines = lines.filter((line) => line !== "[DONE]").join("\n\n");
1000
+ await writer.write(new TextEncoder().encode(readableLines));
1001
+ } catch {
1002
+ await writer?.write(chunk);
1003
+ } finally {
1004
+ writer?.releaseLock();
1005
+ }
1006
+ }
1007
+ }),
1008
+ {
1009
+ preventClose: true
1010
+ }
1011
+ ).catch((error) => {
1012
+ console.error("Error piping to writable stream:", error);
1013
+ });
1014
+ this.processChatResponse_vNext({
1015
+ stream: streamForProcessing,
1016
+ update: ({ message }) => {
1017
+ const existingIndex = messages.findIndex((m) => m.id === message.id);
1018
+ if (existingIndex !== -1) {
1019
+ messages[existingIndex] = message;
1020
+ } else {
1021
+ messages.push(message);
1022
+ }
1023
+ },
1024
+ onFinish: async ({ finishReason, message }) => {
1025
+ if (finishReason === "tool-calls") {
1026
+ const toolCall = [...message?.parts ?? []].reverse().find((part) => part.type === "tool-invocation")?.toolInvocation;
1027
+ if (toolCall) {
1028
+ toolCalls.push(toolCall);
1029
+ }
1030
+ let shouldExecuteClientTool = false;
1031
+ for (const toolCall2 of toolCalls) {
1032
+ const clientTool = processedParams.clientTools?.[toolCall2.toolName];
1033
+ if (clientTool && clientTool.execute) {
1034
+ shouldExecuteClientTool = true;
1035
+ const result = await clientTool.execute(toolCall2?.args, {
1036
+ requestContext: processedParams.requestContext,
1037
+ // TODO: Pass proper tracing context when client-js supports tracing
1038
+ tracingContext: { currentSpan: void 0 },
1039
+ agent: {
1040
+ messages: response.messages,
1041
+ toolCallId: toolCall2?.toolCallId,
1042
+ suspend: async () => {
1043
+ },
1044
+ threadId: processedParams.threadId,
1045
+ resourceId: processedParams.resourceId
1046
+ }
1047
+ });
1048
+ const lastMessageRaw = messages[messages.length - 1];
1049
+ const lastMessage = lastMessageRaw != null ? JSON.parse(JSON.stringify(lastMessageRaw)) : void 0;
1050
+ const toolInvocationPart = lastMessage?.parts?.find(
1051
+ (part) => part.type === "tool-invocation" && part.toolInvocation?.toolCallId === toolCall2.toolCallId
1052
+ );
1053
+ if (toolInvocationPart) {
1054
+ toolInvocationPart.toolInvocation = {
1055
+ ...toolInvocationPart.toolInvocation,
1056
+ state: "result",
1057
+ result
1058
+ };
1059
+ }
1060
+ const toolInvocation = lastMessage?.toolInvocations?.find(
1061
+ (toolInvocation2) => toolInvocation2.toolCallId === toolCall2.toolCallId
1062
+ );
1063
+ if (toolInvocation) {
1064
+ toolInvocation.state = "result";
1065
+ toolInvocation.result = result;
1066
+ }
1067
+ const updatedMessages = lastMessage != null ? [...messages.filter((m) => m.id !== lastMessage.id), lastMessage] : [...messages];
1068
+ this.processStreamResponse(
1069
+ {
1070
+ ...processedParams,
1071
+ messages: updatedMessages
1072
+ },
1073
+ writable
1074
+ ).catch((error) => {
1075
+ console.error("Error processing stream response:", error);
1076
+ });
1077
+ }
1078
+ }
1079
+ if (!shouldExecuteClientTool) {
1080
+ setTimeout(() => {
1081
+ writable.close();
1082
+ }, 0);
1083
+ }
1084
+ } else {
1085
+ setTimeout(() => {
1086
+ writable.close();
1087
+ }, 0);
1088
+ }
1089
+ },
1090
+ lastMessage: void 0
1091
+ }).catch((error) => {
1092
+ console.error("Error processing stream response:", error);
1093
+ });
1094
+ } catch (error) {
1095
+ console.error("Error processing stream response:", error);
1096
+ }
1097
+ return response;
1098
+ }
1099
+ async network(params) {
1100
+ const response = await this.request(`/api/agents/${this.agentId}/network`, {
1101
+ method: "POST",
1102
+ body: params,
1103
+ stream: true
1104
+ });
1105
+ if (!response.body) {
1106
+ throw new Error("No response body");
1107
+ }
1108
+ const streamResponse = new Response(response.body, {
1109
+ status: response.status,
1110
+ statusText: response.statusText,
1111
+ headers: response.headers
1112
+ });
1113
+ streamResponse.processDataStream = async ({
1114
+ onChunk
1115
+ }) => {
1116
+ await processMastraNetworkStream({
1117
+ stream: streamResponse.body,
1118
+ onChunk
1119
+ });
1120
+ };
1121
+ return streamResponse;
1122
+ }
1123
+ async stream(messagesOrParams, options) {
1124
+ let params;
1125
+ if (typeof messagesOrParams === "object" && "messages" in messagesOrParams) {
1126
+ params = messagesOrParams;
1127
+ } else {
1128
+ params = {
1129
+ messages: messagesOrParams,
1130
+ ...options
1131
+ };
1132
+ }
1133
+ const processedParams = {
1134
+ ...params,
1135
+ requestContext: parseClientRequestContext(params.requestContext),
1136
+ clientTools: processClientTools(params.clientTools),
1137
+ structuredOutput: params.structuredOutput ? {
1138
+ ...params.structuredOutput,
1139
+ schema: zodToJsonSchema(params.structuredOutput.schema)
1140
+ } : void 0
1141
+ };
1142
+ const { readable, writable } = new TransformStream();
1143
+ const response = await this.processStreamResponse(processedParams, writable);
1144
+ const streamResponse = new Response(readable, {
1145
+ status: response.status,
1146
+ statusText: response.statusText,
1147
+ headers: response.headers
1148
+ });
1149
+ streamResponse.processDataStream = async ({
1150
+ onChunk
1151
+ }) => {
1152
+ await processMastraStream({
1153
+ stream: streamResponse.body,
1154
+ onChunk
1155
+ });
1156
+ };
1157
+ return streamResponse;
1158
+ }
1159
+ async approveToolCall(params) {
1160
+ const { readable, writable } = new TransformStream();
1161
+ const response = await this.processStreamResponse(params, writable, "approve-tool-call");
1162
+ const streamResponse = new Response(readable, {
1163
+ status: response.status,
1164
+ statusText: response.statusText,
1165
+ headers: response.headers
1166
+ });
1167
+ streamResponse.processDataStream = async ({
1168
+ onChunk
1169
+ }) => {
1170
+ await processMastraStream({
1171
+ stream: streamResponse.body,
1172
+ onChunk
1173
+ });
1174
+ };
1175
+ return streamResponse;
1176
+ }
1177
+ async declineToolCall(params) {
1178
+ const { readable, writable } = new TransformStream();
1179
+ const response = await this.processStreamResponse(params, writable, "decline-tool-call");
1180
+ const streamResponse = new Response(readable, {
1181
+ status: response.status,
1182
+ statusText: response.statusText,
1183
+ headers: response.headers
1184
+ });
1185
+ streamResponse.processDataStream = async ({
1186
+ onChunk
1187
+ }) => {
1188
+ await processMastraStream({
1189
+ stream: streamResponse.body,
1190
+ onChunk
1191
+ });
1192
+ };
1193
+ return streamResponse;
1194
+ }
1195
+ /**
1196
+ * Processes the stream response and handles tool calls
1197
+ */
1198
+ async processStreamResponseLegacy(processedParams, writable) {
1199
+ const response = await this.request(`/api/agents/${this.agentId}/stream-legacy`, {
1200
+ method: "POST",
1201
+ body: processedParams,
1202
+ stream: true
1203
+ });
1204
+ if (!response.body) {
1205
+ throw new Error("No response body");
1206
+ }
1207
+ try {
1208
+ let toolCalls = [];
1209
+ let messages = [];
1210
+ const [streamForWritable, streamForProcessing] = response.body.tee();
1211
+ streamForWritable.pipeTo(writable, {
1212
+ preventClose: true
1213
+ }).catch((error) => {
1214
+ console.error("Error piping to writable stream:", error);
1215
+ });
1216
+ this.processChatResponse({
1217
+ stream: streamForProcessing,
1218
+ update: ({ message }) => {
1219
+ const existingIndex = messages.findIndex((m) => m.id === message.id);
1220
+ if (existingIndex !== -1) {
1221
+ messages[existingIndex] = message;
1222
+ } else {
1223
+ messages.push(message);
1224
+ }
1225
+ },
1226
+ onFinish: async ({ finishReason, message }) => {
1227
+ if (finishReason === "tool-calls") {
1228
+ const toolCall = [...message?.parts ?? []].reverse().find((part) => part.type === "tool-invocation")?.toolInvocation;
1229
+ if (toolCall) {
1230
+ toolCalls.push(toolCall);
1231
+ }
1232
+ for (const toolCall2 of toolCalls) {
1233
+ const clientTool = processedParams.clientTools?.[toolCall2.toolName];
1234
+ if (clientTool && clientTool.execute) {
1235
+ const result = await clientTool.execute(toolCall2?.args, {
1236
+ requestContext: processedParams.requestContext,
1237
+ // TODO: Pass proper tracing context when client-js supports tracing
1238
+ tracingContext: { currentSpan: void 0 },
1239
+ agent: {
1240
+ messages: response.messages,
1241
+ toolCallId: toolCall2?.toolCallId,
1242
+ suspend: async () => {
1243
+ },
1244
+ threadId: processedParams.threadId,
1245
+ resourceId: processedParams.resourceId
1246
+ }
1247
+ });
1248
+ const lastMessage = JSON.parse(JSON.stringify(messages[messages.length - 1]));
1249
+ const toolInvocationPart = lastMessage?.parts?.find(
1250
+ (part) => part.type === "tool-invocation" && part.toolInvocation?.toolCallId === toolCall2.toolCallId
1251
+ );
1252
+ if (toolInvocationPart) {
1253
+ toolInvocationPart.toolInvocation = {
1254
+ ...toolInvocationPart.toolInvocation,
1255
+ state: "result",
1256
+ result
1257
+ };
1258
+ }
1259
+ const toolInvocation = lastMessage?.toolInvocations?.find(
1260
+ (toolInvocation2) => toolInvocation2.toolCallId === toolCall2.toolCallId
1261
+ );
1262
+ if (toolInvocation) {
1263
+ toolInvocation.state = "result";
1264
+ toolInvocation.result = result;
1265
+ }
1266
+ const writer = writable.getWriter();
1267
+ try {
1268
+ await writer.write(
1269
+ new TextEncoder().encode(
1270
+ "a:" + JSON.stringify({
1271
+ toolCallId: toolCall2.toolCallId,
1272
+ result
1273
+ }) + "\n"
1274
+ )
1275
+ );
1276
+ } finally {
1277
+ writer.releaseLock();
1278
+ }
1279
+ this.processStreamResponseLegacy(
1280
+ {
1281
+ ...processedParams,
1282
+ messages: [...messages.filter((m) => m.id !== lastMessage.id), lastMessage]
1283
+ },
1284
+ writable
1285
+ ).catch((error) => {
1286
+ console.error("Error processing stream response:", error);
1287
+ });
1288
+ }
1289
+ }
1290
+ } else {
1291
+ setTimeout(() => {
1292
+ writable.close();
1293
+ }, 0);
1294
+ }
1295
+ },
1296
+ lastMessage: void 0
1297
+ }).catch((error) => {
1298
+ console.error("Error processing stream response:", error);
1299
+ });
1300
+ } catch (error) {
1301
+ console.error("Error processing stream response:", error);
1302
+ }
1303
+ return response;
1304
+ }
1305
+ /**
1306
+ * Gets details about a specific tool available to the agent
1307
+ * @param toolId - ID of the tool to retrieve
1308
+ * @param requestContext - Optional request context to pass as query parameter
1309
+ * @returns Promise containing tool details
1310
+ */
1311
+ getTool(toolId, requestContext) {
1312
+ return this.request(`/api/agents/${this.agentId}/tools/${toolId}${requestContextQueryString(requestContext)}`);
1313
+ }
1314
+ /**
1315
+ * Executes a tool for the agent
1316
+ * @param toolId - ID of the tool to execute
1317
+ * @param params - Parameters required for tool execution
1318
+ * @returns Promise containing the tool execution results
1319
+ */
1320
+ executeTool(toolId, params) {
1321
+ const body = {
1322
+ data: params.data,
1323
+ requestContext: parseClientRequestContext(params.requestContext)
1324
+ };
1325
+ return this.request(`/api/agents/${this.agentId}/tools/${toolId}/execute`, {
1326
+ method: "POST",
1327
+ body
1328
+ });
1329
+ }
1330
+ /**
1331
+ * Updates the model for the agent
1332
+ * @param params - Parameters for updating the model
1333
+ * @returns Promise containing the updated model
1334
+ */
1335
+ updateModel(params) {
1336
+ return this.request(`/api/agents/${this.agentId}/model`, {
1337
+ method: "POST",
1338
+ body: params
1339
+ });
1340
+ }
1341
+ /**
1342
+ * Resets the agent's model to the original model that was set during construction
1343
+ * @returns Promise containing a success message
1344
+ */
1345
+ resetModel() {
1346
+ return this.request(`/api/agents/${this.agentId}/model/reset`, {
1347
+ method: "POST"
1348
+ });
1349
+ }
1350
+ /**
1351
+ * Updates the model for the agent in the model list
1352
+ * @param params - Parameters for updating the model
1353
+ * @returns Promise containing the updated model
1354
+ */
1355
+ updateModelInModelList({ modelConfigId, ...params }) {
1356
+ return this.request(`/api/agents/${this.agentId}/models/${modelConfigId}`, {
1357
+ method: "POST",
1358
+ body: params
1359
+ });
1360
+ }
1361
+ /**
1362
+ * Reorders the models for the agent
1363
+ * @param params - Parameters for reordering the model list
1364
+ * @returns Promise containing the updated model list
1365
+ */
1366
+ reorderModelList(params) {
1367
+ return this.request(`/api/agents/${this.agentId}/models/reorder`, {
1368
+ method: "POST",
1369
+ body: params
1370
+ });
1371
+ }
1372
+ };
1373
+
1374
+ // src/resources/memory-thread.ts
1375
+ var MemoryThread = class extends BaseResource {
1376
+ constructor(options, threadId, agentId) {
1377
+ super(options);
1378
+ this.threadId = threadId;
1379
+ this.agentId = agentId;
1380
+ }
1381
+ /**
1382
+ * Retrieves the memory thread details
1383
+ * @param requestContext - Optional request context to pass as query parameter
1384
+ * @returns Promise containing thread details including title and metadata
1385
+ */
1386
+ get(requestContext) {
1387
+ return this.request(
1388
+ `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${requestContextQueryString(requestContext, "&")}`
1389
+ );
1390
+ }
1391
+ /**
1392
+ * Updates the memory thread properties
1393
+ * @param params - Update parameters including title, metadata, and optional request context
1394
+ * @returns Promise containing updated thread details
1395
+ */
1396
+ update(params) {
1397
+ return this.request(
1398
+ `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${requestContextQueryString(params.requestContext, "&")}`,
1399
+ {
1400
+ method: "PATCH",
1401
+ body: params
1402
+ }
1403
+ );
1404
+ }
1405
+ /**
1406
+ * Deletes the memory thread
1407
+ * @param requestContext - Optional request context to pass as query parameter
1408
+ * @returns Promise containing deletion result
1409
+ */
1410
+ delete(requestContext) {
1411
+ return this.request(
1412
+ `/api/memory/threads/${this.threadId}?agentId=${this.agentId}${requestContextQueryString(requestContext, "&")}`,
1413
+ {
1414
+ method: "DELETE"
1415
+ }
1416
+ );
1417
+ }
1418
+ /**
1419
+ * Retrieves paginated messages associated with the thread with filtering and ordering options
1420
+ * @param params - Pagination parameters including page, perPage, orderBy, filter, include options, and request context
1421
+ * @returns Promise containing paginated thread messages with pagination metadata (total, page, perPage, hasMore)
1422
+ */
1423
+ listMessages(params = {}) {
1424
+ const { page, perPage, orderBy, filter, include, resourceId, requestContext } = params;
1425
+ const queryParams = {};
1426
+ if (resourceId) queryParams.resourceId = resourceId;
1427
+ if (page !== void 0) queryParams.page = String(page);
1428
+ if (perPage !== void 0) queryParams.perPage = String(perPage);
1429
+ if (orderBy) queryParams.orderBy = JSON.stringify(orderBy);
1430
+ if (filter) queryParams.filter = JSON.stringify(filter);
1431
+ if (include) queryParams.include = JSON.stringify(include);
1432
+ const query = new URLSearchParams(queryParams);
1433
+ const queryString = query.toString();
1434
+ const url = `/api/memory/threads/${this.threadId}/messages${queryString ? `?${queryString}` : ""}${requestContextQueryString(requestContext, queryString ? "&" : "?")}`;
1435
+ return this.request(url);
1436
+ }
1437
+ /**
1438
+ * Deletes one or more messages from the thread
1439
+ * @param messageIds - Can be a single message ID (string), array of message IDs,
1440
+ * message object with id property, or array of message objects
1441
+ * @param requestContext - Optional request context to pass as query parameter
1442
+ * @returns Promise containing deletion result
1443
+ */
1444
+ deleteMessages(messageIds, requestContext) {
1445
+ const query = new URLSearchParams({
1446
+ agentId: this.agentId
1447
+ });
1448
+ return this.request(
1449
+ `/api/memory/messages/delete?${query.toString()}${requestContextQueryString(requestContext, "&")}`,
1450
+ {
1451
+ method: "POST",
1452
+ body: { messageIds }
1453
+ }
1454
+ );
1455
+ }
1456
+ };
1457
+
1458
+ // src/resources/vector.ts
1459
+ var Vector = class extends BaseResource {
1460
+ constructor(options, vectorName) {
1461
+ super(options);
1462
+ this.vectorName = vectorName;
1463
+ }
1464
+ /**
1465
+ * Retrieves details about a specific vector index
1466
+ * @param indexName - Name of the index to get details for
1467
+ * @param requestContext - Optional request context to pass as query parameter
1468
+ * @returns Promise containing vector index details
1469
+ */
1470
+ details(indexName, requestContext) {
1471
+ return this.request(
1472
+ `/api/vector/${this.vectorName}/indexes/${indexName}${requestContextQueryString(requestContext)}`
1473
+ );
1474
+ }
1475
+ /**
524
1476
  * Deletes a vector index
525
1477
  * @param indexName - Name of the index to delete
526
1478
  * @returns Promise indicating deletion success
@@ -532,10 +1484,11 @@ var Vector = class extends BaseResource {
532
1484
  }
533
1485
  /**
534
1486
  * Retrieves a list of all available indexes
1487
+ * @param requestContext - Optional request context to pass as query parameter
535
1488
  * @returns Promise containing array of index names
536
1489
  */
537
- getIndexes() {
538
- return this.request(`/api/vector/${this.vectorName}/indexes`);
1490
+ getIndexes(requestContext) {
1491
+ return this.request(`/api/vector/${this.vectorName}/indexes${requestContextQueryString(requestContext)}`);
539
1492
  }
540
1493
  /**
541
1494
  * Creates a new vector index
@@ -556,151 +1509,808 @@ var Vector = class extends BaseResource {
556
1509
  upsert(params) {
557
1510
  return this.request(`/api/vector/${this.vectorName}/upsert`, {
558
1511
  method: "POST",
559
- body: params
1512
+ body: params
1513
+ });
1514
+ }
1515
+ /**
1516
+ * Queries vectors in an index
1517
+ * @param params - Query parameters including query vector and search options
1518
+ * @returns Promise containing query results
1519
+ */
1520
+ query(params) {
1521
+ return this.request(`/api/vector/${this.vectorName}/query`, {
1522
+ method: "POST",
1523
+ body: params
1524
+ });
1525
+ }
1526
+ };
1527
+
1528
+ // src/resources/tool.ts
1529
+ var Tool = class extends BaseResource {
1530
+ constructor(options, toolId) {
1531
+ super(options);
1532
+ this.toolId = toolId;
1533
+ }
1534
+ /**
1535
+ * Retrieves details about the tool
1536
+ * @param requestContext - Optional request context to pass as query parameter
1537
+ * @returns Promise containing tool details including description and schemas
1538
+ */
1539
+ details(requestContext) {
1540
+ return this.request(`/api/tools/${this.toolId}${requestContextQueryString(requestContext)}`);
1541
+ }
1542
+ /**
1543
+ * Executes the tool with the provided parameters
1544
+ * @param params - Parameters required for tool execution
1545
+ * @returns Promise containing the tool execution results
1546
+ */
1547
+ execute(params) {
1548
+ const url = new URLSearchParams();
1549
+ if (params.runId) {
1550
+ url.set("runId", params.runId);
1551
+ }
1552
+ const body = {
1553
+ data: params.data,
1554
+ requestContext: parseClientRequestContext(params.requestContext)
1555
+ };
1556
+ return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
1557
+ method: "POST",
1558
+ body
1559
+ });
1560
+ }
1561
+ };
1562
+
1563
+ // src/resources/workflow.ts
1564
+ var RECORD_SEPARATOR = "";
1565
+ var Workflow = class extends BaseResource {
1566
+ constructor(options, workflowId) {
1567
+ super(options);
1568
+ this.workflowId = workflowId;
1569
+ }
1570
+ /**
1571
+ * Retrieves details about the workflow
1572
+ * @param requestContext - Optional request context to pass as query parameter
1573
+ * @returns Promise containing workflow details including steps and graphs
1574
+ */
1575
+ details(requestContext) {
1576
+ return this.request(`/api/workflows/${this.workflowId}${requestContextQueryString(requestContext)}`);
1577
+ }
1578
+ /**
1579
+ * Retrieves all runs for a workflow
1580
+ * @param params - Parameters for filtering runs
1581
+ * @param requestContext - Optional request context to pass as query parameter
1582
+ * @returns Promise containing workflow runs array
1583
+ */
1584
+ runs(params, requestContext) {
1585
+ const requestContextParam = base64RequestContext(parseClientRequestContext(requestContext));
1586
+ const searchParams = new URLSearchParams();
1587
+ if (params?.fromDate) {
1588
+ searchParams.set("fromDate", params.fromDate.toISOString());
1589
+ }
1590
+ if (params?.toDate) {
1591
+ searchParams.set("toDate", params.toDate.toISOString());
1592
+ }
1593
+ if (params?.perPage !== null && params?.perPage !== void 0) {
1594
+ if (params.perPage === false) {
1595
+ searchParams.set("perPage", "false");
1596
+ } else if (typeof params.perPage === "number" && params.perPage > 0 && Number.isInteger(params.perPage)) {
1597
+ searchParams.set("perPage", String(params.perPage));
1598
+ }
1599
+ }
1600
+ if (params?.page !== null && params?.page !== void 0 && !isNaN(Number(params?.page))) {
1601
+ searchParams.set("page", String(params.page));
1602
+ }
1603
+ if (params?.resourceId) {
1604
+ searchParams.set("resourceId", params.resourceId);
1605
+ }
1606
+ if (requestContextParam) {
1607
+ searchParams.set("requestContext", requestContextParam);
1608
+ }
1609
+ if (searchParams.size) {
1610
+ return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
1611
+ } else {
1612
+ return this.request(`/api/workflows/${this.workflowId}/runs`);
1613
+ }
1614
+ }
1615
+ /**
1616
+ * Retrieves a specific workflow run by its ID
1617
+ * @param runId - The ID of the workflow run to retrieve
1618
+ * @param requestContext - Optional request context to pass as query parameter
1619
+ * @returns Promise containing the workflow run details
1620
+ */
1621
+ runById(runId, requestContext) {
1622
+ return this.request(`/api/workflows/${this.workflowId}/runs/${runId}${requestContextQueryString(requestContext)}`);
1623
+ }
1624
+ /**
1625
+ * Retrieves the execution result for a specific workflow run by its ID
1626
+ * @param runId - The ID of the workflow run to retrieve the execution result for
1627
+ * @param requestContext - Optional request context to pass as query parameter
1628
+ * @returns Promise containing the workflow run execution result
1629
+ */
1630
+ runExecutionResult(runId, requestContext) {
1631
+ return this.request(
1632
+ `/api/workflows/${this.workflowId}/runs/${runId}/execution-result${requestContextQueryString(requestContext)}`
1633
+ );
1634
+ }
1635
+ /**
1636
+ * Cancels a specific workflow run by its ID
1637
+ * @param runId - The ID of the workflow run to cancel
1638
+ * @returns Promise containing a success message
1639
+ */
1640
+ cancelRun(runId) {
1641
+ return this.request(`/api/workflows/${this.workflowId}/runs/${runId}/cancel`, {
1642
+ method: "POST"
1643
+ });
1644
+ }
1645
+ /**
1646
+ * Creates a new workflow run
1647
+ * @param params - Optional object containing the optional runId
1648
+ * @returns Promise containing the runId of the created run with methods to control execution
1649
+ */
1650
+ async createRun(params) {
1651
+ const searchParams = new URLSearchParams();
1652
+ if (!!params?.runId) {
1653
+ searchParams.set("runId", params.runId);
1654
+ }
1655
+ const res = await this.request(
1656
+ `/api/workflows/${this.workflowId}/create-run?${searchParams.toString()}`,
1657
+ {
1658
+ method: "POST"
1659
+ }
1660
+ );
1661
+ const runId = res.runId;
1662
+ return {
1663
+ runId,
1664
+ start: async (p) => {
1665
+ return this.start({
1666
+ runId,
1667
+ inputData: p.inputData,
1668
+ requestContext: p.requestContext,
1669
+ tracingOptions: p.tracingOptions
1670
+ });
1671
+ },
1672
+ startAsync: async (p) => {
1673
+ return this.startAsync({
1674
+ runId,
1675
+ inputData: p.inputData,
1676
+ requestContext: p.requestContext,
1677
+ tracingOptions: p.tracingOptions
1678
+ });
1679
+ },
1680
+ stream: async (p) => {
1681
+ return this.stream({ runId, inputData: p.inputData, requestContext: p.requestContext });
1682
+ },
1683
+ resume: async (p) => {
1684
+ return this.resume({
1685
+ runId,
1686
+ step: p.step,
1687
+ resumeData: p.resumeData,
1688
+ requestContext: p.requestContext,
1689
+ tracingOptions: p.tracingOptions
1690
+ });
1691
+ },
1692
+ resumeAsync: async (p) => {
1693
+ return this.resumeAsync({
1694
+ runId,
1695
+ step: p.step,
1696
+ resumeData: p.resumeData,
1697
+ requestContext: p.requestContext,
1698
+ tracingOptions: p.tracingOptions
1699
+ });
1700
+ },
1701
+ resumeStreamVNext: async (p) => {
1702
+ return this.resumeStreamVNext({
1703
+ runId,
1704
+ step: p.step,
1705
+ resumeData: p.resumeData,
1706
+ requestContext: p.requestContext
1707
+ });
1708
+ }
1709
+ };
1710
+ }
1711
+ /**
1712
+ * Starts a workflow run synchronously without waiting for the workflow to complete
1713
+ * @param params - Object containing the runId, inputData and requestContext
1714
+ * @returns Promise containing success message
1715
+ */
1716
+ start(params) {
1717
+ const requestContext = parseClientRequestContext(params.requestContext);
1718
+ return this.request(`/api/workflows/${this.workflowId}/start?runId=${params.runId}`, {
1719
+ method: "POST",
1720
+ body: { inputData: params?.inputData, requestContext, tracingOptions: params.tracingOptions }
1721
+ });
1722
+ }
1723
+ /**
1724
+ * Resumes a suspended workflow step synchronously without waiting for the workflow to complete
1725
+ * @param params - Object containing the runId, step, resumeData and requestContext
1726
+ * @returns Promise containing success message
1727
+ */
1728
+ resume({
1729
+ step,
1730
+ runId,
1731
+ resumeData,
1732
+ tracingOptions,
1733
+ ...rest
1734
+ }) {
1735
+ const requestContext = parseClientRequestContext(rest.requestContext);
1736
+ return this.request(`/api/workflows/${this.workflowId}/resume?runId=${runId}`, {
1737
+ method: "POST",
1738
+ body: {
1739
+ step,
1740
+ resumeData,
1741
+ requestContext,
1742
+ tracingOptions
1743
+ }
1744
+ });
1745
+ }
1746
+ /**
1747
+ * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
1748
+ * @param params - Object containing the optional runId, inputData and requestContext
1749
+ * @returns Promise containing the workflow execution results
1750
+ */
1751
+ startAsync(params) {
1752
+ const searchParams = new URLSearchParams();
1753
+ if (!!params?.runId) {
1754
+ searchParams.set("runId", params.runId);
1755
+ }
1756
+ const requestContext = parseClientRequestContext(params.requestContext);
1757
+ return this.request(`/api/workflows/${this.workflowId}/start-async?${searchParams.toString()}`, {
1758
+ method: "POST",
1759
+ body: { inputData: params.inputData, requestContext, tracingOptions: params.tracingOptions }
1760
+ });
1761
+ }
1762
+ /**
1763
+ * Starts a workflow run and returns a stream
1764
+ * @param params - Object containing the optional runId, inputData and requestContext
1765
+ * @returns Promise containing the workflow execution results
1766
+ */
1767
+ async stream(params) {
1768
+ const searchParams = new URLSearchParams();
1769
+ if (!!params?.runId) {
1770
+ searchParams.set("runId", params.runId);
1771
+ }
1772
+ const requestContext = parseClientRequestContext(params.requestContext);
1773
+ const response = await this.request(
1774
+ `/api/workflows/${this.workflowId}/stream?${searchParams.toString()}`,
1775
+ {
1776
+ method: "POST",
1777
+ body: { inputData: params.inputData, requestContext, tracingOptions: params.tracingOptions },
1778
+ stream: true
1779
+ }
1780
+ );
1781
+ if (!response.ok) {
1782
+ throw new Error(`Failed to stream workflow: ${response.statusText}`);
1783
+ }
1784
+ if (!response.body) {
1785
+ throw new Error("Response body is null");
1786
+ }
1787
+ let failedChunk = void 0;
1788
+ const transformStream = new TransformStream({
1789
+ start() {
1790
+ },
1791
+ async transform(chunk, controller) {
1792
+ try {
1793
+ const decoded = new TextDecoder().decode(chunk);
1794
+ const chunks = decoded.split(RECORD_SEPARATOR);
1795
+ for (const chunk2 of chunks) {
1796
+ if (chunk2) {
1797
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
1798
+ try {
1799
+ const parsedChunk = JSON.parse(newChunk);
1800
+ controller.enqueue(parsedChunk);
1801
+ failedChunk = void 0;
1802
+ } catch {
1803
+ failedChunk = newChunk;
1804
+ }
1805
+ }
1806
+ }
1807
+ } catch {
1808
+ }
1809
+ }
1810
+ });
1811
+ return response.body.pipeThrough(transformStream);
1812
+ }
1813
+ /**
1814
+ * Observes workflow stream for a workflow run
1815
+ * @param params - Object containing the runId
1816
+ * @returns Promise containing the workflow execution results
1817
+ */
1818
+ async observeStream(params) {
1819
+ const searchParams = new URLSearchParams();
1820
+ searchParams.set("runId", params.runId);
1821
+ const response = await this.request(
1822
+ `/api/workflows/${this.workflowId}/observe-stream?${searchParams.toString()}`,
1823
+ {
1824
+ method: "POST",
1825
+ stream: true
1826
+ }
1827
+ );
1828
+ if (!response.ok) {
1829
+ throw new Error(`Failed to observe workflow stream: ${response.statusText}`);
1830
+ }
1831
+ if (!response.body) {
1832
+ throw new Error("Response body is null");
1833
+ }
1834
+ let failedChunk = void 0;
1835
+ const transformStream = new TransformStream({
1836
+ start() {
1837
+ },
1838
+ async transform(chunk, controller) {
1839
+ try {
1840
+ const decoded = new TextDecoder().decode(chunk);
1841
+ const chunks = decoded.split(RECORD_SEPARATOR);
1842
+ for (const chunk2 of chunks) {
1843
+ if (chunk2) {
1844
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
1845
+ try {
1846
+ const parsedChunk = JSON.parse(newChunk);
1847
+ controller.enqueue(parsedChunk);
1848
+ failedChunk = void 0;
1849
+ } catch {
1850
+ failedChunk = newChunk;
1851
+ }
1852
+ }
1853
+ }
1854
+ } catch {
1855
+ }
1856
+ }
1857
+ });
1858
+ return response.body.pipeThrough(transformStream);
1859
+ }
1860
+ /**
1861
+ * Starts a workflow run and returns a stream
1862
+ * @param params - Object containing the optional runId, inputData and requestContext
1863
+ * @returns Promise containing the workflow execution results
1864
+ */
1865
+ async streamVNext(params) {
1866
+ const searchParams = new URLSearchParams();
1867
+ if (!!params?.runId) {
1868
+ searchParams.set("runId", params.runId);
1869
+ }
1870
+ const requestContext = parseClientRequestContext(params.requestContext);
1871
+ const response = await this.request(
1872
+ `/api/workflows/${this.workflowId}/streamVNext?${searchParams.toString()}`,
1873
+ {
1874
+ method: "POST",
1875
+ body: {
1876
+ inputData: params.inputData,
1877
+ requestContext,
1878
+ closeOnSuspend: params.closeOnSuspend,
1879
+ tracingOptions: params.tracingOptions
1880
+ },
1881
+ stream: true
1882
+ }
1883
+ );
1884
+ if (!response.ok) {
1885
+ throw new Error(`Failed to stream vNext workflow: ${response.statusText}`);
1886
+ }
1887
+ if (!response.body) {
1888
+ throw new Error("Response body is null");
1889
+ }
1890
+ let failedChunk = void 0;
1891
+ const transformStream = new TransformStream({
1892
+ start() {
1893
+ },
1894
+ async transform(chunk, controller) {
1895
+ try {
1896
+ const decoded = new TextDecoder().decode(chunk);
1897
+ const chunks = decoded.split(RECORD_SEPARATOR);
1898
+ for (const chunk2 of chunks) {
1899
+ if (chunk2) {
1900
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
1901
+ try {
1902
+ const parsedChunk = JSON.parse(newChunk);
1903
+ controller.enqueue(parsedChunk);
1904
+ failedChunk = void 0;
1905
+ } catch {
1906
+ failedChunk = newChunk;
1907
+ }
1908
+ }
1909
+ }
1910
+ } catch {
1911
+ }
1912
+ }
1913
+ });
1914
+ return response.body.pipeThrough(transformStream);
1915
+ }
1916
+ /**
1917
+ * Observes workflow vNext stream for a workflow run
1918
+ * @param params - Object containing the runId
1919
+ * @returns Promise containing the workflow execution results
1920
+ */
1921
+ async observeStreamVNext(params) {
1922
+ const searchParams = new URLSearchParams();
1923
+ searchParams.set("runId", params.runId);
1924
+ const response = await this.request(
1925
+ `/api/workflows/${this.workflowId}/observe-streamVNext?${searchParams.toString()}`,
1926
+ {
1927
+ method: "POST",
1928
+ stream: true
1929
+ }
1930
+ );
1931
+ if (!response.ok) {
1932
+ throw new Error(`Failed to observe stream vNext workflow: ${response.statusText}`);
1933
+ }
1934
+ if (!response.body) {
1935
+ throw new Error("Response body is null");
1936
+ }
1937
+ let failedChunk = void 0;
1938
+ const transformStream = new TransformStream({
1939
+ start() {
1940
+ },
1941
+ async transform(chunk, controller) {
1942
+ try {
1943
+ const decoded = new TextDecoder().decode(chunk);
1944
+ const chunks = decoded.split(RECORD_SEPARATOR);
1945
+ for (const chunk2 of chunks) {
1946
+ if (chunk2) {
1947
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
1948
+ try {
1949
+ const parsedChunk = JSON.parse(newChunk);
1950
+ controller.enqueue(parsedChunk);
1951
+ failedChunk = void 0;
1952
+ } catch {
1953
+ failedChunk = newChunk;
1954
+ }
1955
+ }
1956
+ }
1957
+ } catch {
1958
+ }
1959
+ }
1960
+ });
1961
+ return response.body.pipeThrough(transformStream);
1962
+ }
1963
+ /**
1964
+ * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
1965
+ * @param params - Object containing the runId, step, resumeData and requestContext
1966
+ * @returns Promise containing the workflow resume results
1967
+ */
1968
+ resumeAsync(params) {
1969
+ const requestContext = parseClientRequestContext(params.requestContext);
1970
+ return this.request(`/api/workflows/${this.workflowId}/resume-async?runId=${params.runId}`, {
1971
+ method: "POST",
1972
+ body: {
1973
+ step: params.step,
1974
+ resumeData: params.resumeData,
1975
+ requestContext,
1976
+ tracingOptions: params.tracingOptions
1977
+ }
1978
+ });
1979
+ }
1980
+ /**
1981
+ * Resumes a suspended workflow step that uses streamVNext asynchronously and returns a promise that resolves when the workflow is complete
1982
+ * @param params - Object containing the runId, step, resumeData and requestContext
1983
+ * @returns Promise containing the workflow resume results
1984
+ */
1985
+ async resumeStreamVNext(params) {
1986
+ const searchParams = new URLSearchParams();
1987
+ searchParams.set("runId", params.runId);
1988
+ const requestContext = parseClientRequestContext(params.requestContext);
1989
+ const response = await this.request(
1990
+ `/api/workflows/${this.workflowId}/resume-stream?${searchParams.toString()}`,
1991
+ {
1992
+ method: "POST",
1993
+ body: {
1994
+ step: params.step,
1995
+ resumeData: params.resumeData,
1996
+ requestContext,
1997
+ tracingOptions: params.tracingOptions
1998
+ },
1999
+ stream: true
2000
+ }
2001
+ );
2002
+ if (!response.ok) {
2003
+ throw new Error(`Failed to stream vNext workflow: ${response.statusText}`);
2004
+ }
2005
+ if (!response.body) {
2006
+ throw new Error("Response body is null");
2007
+ }
2008
+ let failedChunk = void 0;
2009
+ const transformStream = new TransformStream({
2010
+ start() {
2011
+ },
2012
+ async transform(chunk, controller) {
2013
+ try {
2014
+ const decoded = new TextDecoder().decode(chunk);
2015
+ const chunks = decoded.split(RECORD_SEPARATOR);
2016
+ for (const chunk2 of chunks) {
2017
+ if (chunk2) {
2018
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
2019
+ try {
2020
+ const parsedChunk = JSON.parse(newChunk);
2021
+ controller.enqueue(parsedChunk);
2022
+ failedChunk = void 0;
2023
+ } catch {
2024
+ failedChunk = newChunk;
2025
+ }
2026
+ }
2027
+ }
2028
+ } catch {
2029
+ }
2030
+ }
2031
+ });
2032
+ return response.body.pipeThrough(transformStream);
2033
+ }
2034
+ /**
2035
+ * Creates a new ReadableStream from an iterable or async iterable of objects,
2036
+ * serializing each as JSON and separating them with the record separator (\x1E).
2037
+ *
2038
+ * @param records - An iterable or async iterable of objects to stream
2039
+ * @returns A ReadableStream emitting the records as JSON strings separated by the record separator
2040
+ */
2041
+ static createRecordStream(records) {
2042
+ const encoder = new TextEncoder();
2043
+ return new ReadableStream({
2044
+ async start(controller) {
2045
+ try {
2046
+ for await (const record of records) {
2047
+ const json = JSON.stringify(record) + RECORD_SEPARATOR;
2048
+ controller.enqueue(encoder.encode(json));
2049
+ }
2050
+ controller.close();
2051
+ } catch (err) {
2052
+ controller.error(err);
2053
+ }
2054
+ }
2055
+ });
2056
+ }
2057
+ };
2058
+
2059
+ // src/resources/a2a.ts
2060
+ var A2A = class extends BaseResource {
2061
+ constructor(options, agentId) {
2062
+ super(options);
2063
+ this.agentId = agentId;
2064
+ }
2065
+ /**
2066
+ * Get the agent card with metadata about the agent
2067
+ * @returns Promise containing the agent card information
2068
+ */
2069
+ async getCard() {
2070
+ return this.request(`/.well-known/${this.agentId}/agent-card.json`);
2071
+ }
2072
+ /**
2073
+ * Send a message to the agent and gets a message or task response
2074
+ * @param params - Parameters for the task
2075
+ * @returns Promise containing the response
2076
+ */
2077
+ async sendMessage(params) {
2078
+ const response = await this.request(`/a2a/${this.agentId}`, {
2079
+ method: "POST",
2080
+ body: {
2081
+ method: "message/send",
2082
+ params
2083
+ }
2084
+ });
2085
+ return response;
2086
+ }
2087
+ /**
2088
+ * Sends a message to an agent to initiate/continue a task and subscribes
2089
+ * the client to real-time updates for that task via Server-Sent Events (SSE).
2090
+ * @param params - Parameters for the task
2091
+ * @returns A stream of Server-Sent Events. Each SSE `data` field contains a `SendStreamingMessageResponse`
2092
+ */
2093
+ async sendStreamingMessage(params) {
2094
+ const response = await this.request(`/a2a/${this.agentId}`, {
2095
+ method: "POST",
2096
+ body: {
2097
+ method: "message/stream",
2098
+ params
2099
+ }
2100
+ });
2101
+ return response;
2102
+ }
2103
+ /**
2104
+ * Get the status and result of a task
2105
+ * @param params - Parameters for querying the task
2106
+ * @returns Promise containing the task response
2107
+ */
2108
+ async getTask(params) {
2109
+ const response = await this.request(`/a2a/${this.agentId}`, {
2110
+ method: "POST",
2111
+ body: {
2112
+ method: "tasks/get",
2113
+ params
2114
+ }
560
2115
  });
2116
+ return response;
561
2117
  }
562
2118
  /**
563
- * Queries vectors in an index
564
- * @param params - Query parameters including query vector and search options
565
- * @returns Promise containing query results
2119
+ * Cancel a running task
2120
+ * @param params - Parameters identifying the task to cancel
2121
+ * @returns Promise containing the task response
566
2122
  */
567
- query(params) {
568
- return this.request(`/api/vector/${this.vectorName}/query`, {
2123
+ async cancelTask(params) {
2124
+ return this.request(`/a2a/${this.agentId}`, {
569
2125
  method: "POST",
570
- body: params
2126
+ body: {
2127
+ method: "tasks/cancel",
2128
+ params
2129
+ }
571
2130
  });
572
2131
  }
573
2132
  };
574
2133
 
575
- // src/resources/workflow.ts
576
- var RECORD_SEPARATOR = "";
577
- var Workflow = class extends BaseResource {
578
- constructor(options, workflowId) {
2134
+ // src/resources/mcp-tool.ts
2135
+ var MCPTool = class extends BaseResource {
2136
+ serverId;
2137
+ toolId;
2138
+ constructor(options, serverId, toolId) {
579
2139
  super(options);
580
- this.workflowId = workflowId;
2140
+ this.serverId = serverId;
2141
+ this.toolId = toolId;
581
2142
  }
582
2143
  /**
583
- * Retrieves details about the workflow
584
- * @returns Promise containing workflow details including steps and graphs
2144
+ * Retrieves details about this specific tool from the MCP server.
2145
+ * @param requestContext - Optional request context to pass as query parameter
2146
+ * @returns Promise containing the tool's information (name, description, schema).
585
2147
  */
586
- details() {
587
- return this.request(`/api/workflows/${this.workflowId}`);
2148
+ details(requestContext) {
2149
+ return this.request(`/api/mcp/${this.serverId}/tools/${this.toolId}${requestContextQueryString(requestContext)}`);
588
2150
  }
589
2151
  /**
590
- * Retrieves all runs for a workflow
591
- * @param params - Parameters for filtering runs
592
- * @returns Promise containing workflow runs array
2152
+ * Executes this specific tool on the MCP server.
2153
+ * @param params - Parameters for tool execution, including data/args and optional requestContext.
2154
+ * @returns Promise containing the result of the tool execution.
593
2155
  */
594
- runs(params) {
595
- const searchParams = new URLSearchParams();
596
- if (params?.fromDate) {
597
- searchParams.set("fromDate", params.fromDate.toISOString());
598
- }
599
- if (params?.toDate) {
600
- searchParams.set("toDate", params.toDate.toISOString());
601
- }
602
- if (params?.limit) {
603
- searchParams.set("limit", String(params.limit));
604
- }
605
- if (params?.offset) {
606
- searchParams.set("offset", String(params.offset));
607
- }
608
- if (params?.resourceId) {
609
- searchParams.set("resourceId", params.resourceId);
2156
+ execute(params) {
2157
+ const body = {};
2158
+ if (params.data !== void 0) body.data = params.data;
2159
+ if (params.requestContext !== void 0) {
2160
+ body.requestContext = params.requestContext;
610
2161
  }
611
- if (searchParams.size) {
612
- return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
2162
+ return this.request(`/api/mcp/${this.serverId}/tools/${this.toolId}/execute`, {
2163
+ method: "POST",
2164
+ body: Object.keys(body).length > 0 ? body : void 0
2165
+ });
2166
+ }
2167
+ };
2168
+
2169
+ // src/resources/agent-builder.ts
2170
+ var RECORD_SEPARATOR2 = "";
2171
+ var AgentBuilder = class extends BaseResource {
2172
+ constructor(options, actionId) {
2173
+ super(options);
2174
+ this.actionId = actionId;
2175
+ }
2176
+ // Helper function to transform workflow result to action result
2177
+ transformWorkflowResult(result) {
2178
+ if (result.status === "success") {
2179
+ return {
2180
+ success: result.result.success || false,
2181
+ applied: result.result.applied || false,
2182
+ branchName: result.result.branchName,
2183
+ message: result.result.message || "Agent builder action completed",
2184
+ validationResults: result.result.validationResults,
2185
+ error: result.result.error,
2186
+ errors: result.result.errors,
2187
+ stepResults: result.result.stepResults
2188
+ };
2189
+ } else if (result.status === "failed") {
2190
+ return {
2191
+ success: false,
2192
+ applied: false,
2193
+ message: `Agent builder action failed: ${result.error.message}`,
2194
+ error: result.error.message
2195
+ };
613
2196
  } else {
614
- return this.request(`/api/workflows/${this.workflowId}/runs`);
2197
+ return {
2198
+ success: false,
2199
+ applied: false,
2200
+ message: "Agent builder action was suspended",
2201
+ error: "Workflow suspended - manual intervention required"
2202
+ };
615
2203
  }
616
2204
  }
617
2205
  /**
618
- * @deprecated Use `startAsync` instead
619
- * Executes the workflow with the provided parameters
620
- * @param params - Parameters required for workflow execution
621
- * @returns Promise containing the workflow execution results
2206
+ * Creates a transform stream that parses binary chunks into JSON records.
622
2207
  */
623
- execute(params) {
624
- return this.request(`/api/workflows/${this.workflowId}/execute`, {
625
- method: "POST",
626
- body: params
2208
+ createRecordParserTransform() {
2209
+ let failedChunk = void 0;
2210
+ return new TransformStream({
2211
+ start() {
2212
+ },
2213
+ async transform(chunk, controller) {
2214
+ try {
2215
+ const decoded = new TextDecoder().decode(chunk);
2216
+ const chunks = decoded.split(RECORD_SEPARATOR2);
2217
+ for (const chunk2 of chunks) {
2218
+ if (chunk2) {
2219
+ const newChunk = failedChunk ? failedChunk + chunk2 : chunk2;
2220
+ try {
2221
+ const parsedChunk = JSON.parse(newChunk);
2222
+ controller.enqueue(parsedChunk);
2223
+ failedChunk = void 0;
2224
+ } catch {
2225
+ failedChunk = newChunk;
2226
+ }
2227
+ }
2228
+ }
2229
+ } catch {
2230
+ }
2231
+ }
627
2232
  });
628
2233
  }
629
2234
  /**
630
- * Creates a new workflow run
631
- * @returns Promise containing the generated run ID
2235
+ * Creates a new agent builder action run and returns the runId.
2236
+ * This calls `/api/agent-builder/:actionId/create-run`.
632
2237
  */
633
- createRun(params) {
2238
+ async createRun(params) {
634
2239
  const searchParams = new URLSearchParams();
635
2240
  if (!!params?.runId) {
636
2241
  searchParams.set("runId", params.runId);
637
2242
  }
638
- return this.request(`/api/workflows/${this.workflowId}/createRun?${searchParams.toString()}`, {
2243
+ const url = `/api/agent-builder/${this.actionId}/create-run${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
2244
+ return this.request(url, {
639
2245
  method: "POST"
640
2246
  });
641
2247
  }
642
2248
  /**
643
- * Starts a workflow run synchronously without waiting for the workflow to complete
644
- * @param params - Object containing the runId and triggerData
645
- * @returns Promise containing success message
2249
+ * Starts agent builder action asynchronously and waits for completion.
2250
+ * This calls `/api/agent-builder/:actionId/start-async`.
646
2251
  */
647
- start(params) {
648
- return this.request(`/api/workflows/${this.workflowId}/start?runId=${params.runId}`, {
2252
+ async startAsync(params, runId) {
2253
+ const searchParams = new URLSearchParams();
2254
+ if (runId) {
2255
+ searchParams.set("runId", runId);
2256
+ }
2257
+ const requestContext = parseClientRequestContext(params.requestContext);
2258
+ const { requestContext: _, ...actionParams } = params;
2259
+ const url = `/api/agent-builder/${this.actionId}/start-async${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
2260
+ const result = await this.request(url, {
649
2261
  method: "POST",
650
- body: params?.triggerData
2262
+ body: { ...actionParams, requestContext }
651
2263
  });
2264
+ return this.transformWorkflowResult(result);
652
2265
  }
653
2266
  /**
654
- * Resumes a suspended workflow step synchronously without waiting for the workflow to complete
655
- * @param stepId - ID of the step to resume
656
- * @param runId - ID of the workflow run
657
- * @param context - Context to resume the workflow with
658
- * @returns Promise containing the workflow resume results
2267
+ * Starts an existing agent builder action run.
2268
+ * This calls `/api/agent-builder/:actionId/start`.
659
2269
  */
660
- resume({
661
- stepId,
662
- runId,
663
- context
664
- }) {
665
- return this.request(`/api/workflows/${this.workflowId}/resume?runId=${runId}`, {
2270
+ async startActionRun(params, runId) {
2271
+ const searchParams = new URLSearchParams();
2272
+ searchParams.set("runId", runId);
2273
+ const requestContext = parseClientRequestContext(params.requestContext);
2274
+ const { requestContext: _, ...actionParams } = params;
2275
+ const url = `/api/agent-builder/${this.actionId}/start?${searchParams.toString()}`;
2276
+ return this.request(url, {
666
2277
  method: "POST",
667
- body: {
668
- stepId,
669
- context
670
- }
2278
+ body: { ...actionParams, requestContext }
671
2279
  });
672
2280
  }
673
2281
  /**
674
- * Starts a workflow run asynchronously and returns a promise that resolves when the workflow is complete
675
- * @param params - Object containing the optional runId and triggerData
676
- * @returns Promise containing the workflow execution results
2282
+ * Resumes a suspended agent builder action step.
2283
+ * This calls `/api/agent-builder/:actionId/resume`.
677
2284
  */
678
- startAsync(params) {
2285
+ async resume(params, runId) {
679
2286
  const searchParams = new URLSearchParams();
680
- if (!!params?.runId) {
681
- searchParams.set("runId", params.runId);
682
- }
683
- return this.request(`/api/workflows/${this.workflowId}/start-async?${searchParams.toString()}`, {
2287
+ searchParams.set("runId", runId);
2288
+ const requestContext = parseClientRequestContext(params.requestContext);
2289
+ const { requestContext: _, ...resumeParams } = params;
2290
+ const url = `/api/agent-builder/${this.actionId}/resume?${searchParams.toString()}`;
2291
+ return this.request(url, {
684
2292
  method: "POST",
685
- body: params?.triggerData
2293
+ body: { ...resumeParams, requestContext }
686
2294
  });
687
2295
  }
688
2296
  /**
689
- * Resumes a suspended workflow step asynchronously and returns a promise that resolves when the workflow is complete
690
- * @param params - Object containing the runId, stepId, and context
691
- * @returns Promise containing the workflow resume results
2297
+ * Resumes a suspended agent builder action step asynchronously.
2298
+ * This calls `/api/agent-builder/:actionId/resume-async`.
692
2299
  */
693
- resumeAsync(params) {
694
- return this.request(`/api/workflows/${this.workflowId}/resume-async?runId=${params.runId}`, {
2300
+ async resumeAsync(params, runId) {
2301
+ const searchParams = new URLSearchParams();
2302
+ searchParams.set("runId", runId);
2303
+ const requestContext = parseClientRequestContext(params.requestContext);
2304
+ const { requestContext: _, ...resumeParams } = params;
2305
+ const url = `/api/agent-builder/${this.actionId}/resume-async?${searchParams.toString()}`;
2306
+ const result = await this.request(url, {
695
2307
  method: "POST",
696
- body: {
697
- stepId: params.stepId,
698
- context: params.context
699
- }
2308
+ body: { ...resumeParams, requestContext }
700
2309
  });
2310
+ return this.transformWorkflowResult(result);
701
2311
  }
702
2312
  /**
703
- * Creates an async generator that processes a readable stream and yields records
2313
+ * Creates an async generator that processes a readable stream and yields action records
704
2314
  * separated by the Record Separator character (\x1E)
705
2315
  *
706
2316
  * @param stream - The readable stream to process
@@ -717,7 +2327,7 @@ var Workflow = class extends BaseResource {
717
2327
  if (done && !value) continue;
718
2328
  try {
719
2329
  const decoded = value ? new TextDecoder().decode(value) : "";
720
- const chunks = (buffer + decoded).split(RECORD_SEPARATOR);
2330
+ const chunks = (buffer + decoded).split(RECORD_SEPARATOR2);
721
2331
  buffer = chunks.pop() || "";
722
2332
  for (const chunk of chunks) {
723
2333
  if (chunk) {
@@ -745,346 +2355,307 @@ var Workflow = class extends BaseResource {
745
2355
  }
746
2356
  }
747
2357
  /**
748
- * Watches workflow transitions in real-time
749
- * @param runId - Optional run ID to filter the watch stream
750
- * @returns AsyncGenerator that yields parsed records from the workflow watch stream
2358
+ * Streams agent builder action progress in real-time.
2359
+ * This calls `/api/agent-builder/:actionId/stream`.
751
2360
  */
752
- async watch({ runId }, onRecord) {
753
- const response = await this.request(`/api/workflows/${this.workflowId}/watch?runId=${runId}`, {
2361
+ async stream(params, runId) {
2362
+ const searchParams = new URLSearchParams();
2363
+ if (runId) {
2364
+ searchParams.set("runId", runId);
2365
+ }
2366
+ const requestContext = parseClientRequestContext(params.requestContext);
2367
+ const { requestContext: _, ...actionParams } = params;
2368
+ const url = `/api/agent-builder/${this.actionId}/stream${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
2369
+ const response = await this.request(url, {
2370
+ method: "POST",
2371
+ body: { ...actionParams, requestContext },
754
2372
  stream: true
755
2373
  });
756
2374
  if (!response.ok) {
757
- throw new Error(`Failed to watch workflow: ${response.statusText}`);
2375
+ throw new Error(`Failed to stream agent builder action: ${response.statusText}`);
758
2376
  }
759
2377
  if (!response.body) {
760
2378
  throw new Error("Response body is null");
761
2379
  }
762
- for await (const record of this.streamProcessor(response.body)) {
763
- onRecord(record);
764
- }
765
- }
766
- };
767
-
768
- // src/resources/tool.ts
769
- var Tool = class extends BaseResource {
770
- constructor(options, toolId) {
771
- super(options);
772
- this.toolId = toolId;
773
- }
774
- /**
775
- * Retrieves details about the tool
776
- * @returns Promise containing tool details including description and schemas
777
- */
778
- details() {
779
- return this.request(`/api/tools/${this.toolId}`);
2380
+ return response.body.pipeThrough(this.createRecordParserTransform());
780
2381
  }
781
2382
  /**
782
- * Executes the tool with the provided parameters
783
- * @param params - Parameters required for tool execution
784
- * @returns Promise containing the tool execution results
2383
+ * Streams agent builder action progress in real-time using VNext streaming.
2384
+ * This calls `/api/agent-builder/:actionId/streamVNext`.
785
2385
  */
786
- execute(params) {
787
- const url = new URLSearchParams();
788
- if (params.runId) {
789
- url.set("runId", params.runId);
2386
+ async streamVNext(params, runId) {
2387
+ const searchParams = new URLSearchParams();
2388
+ if (runId) {
2389
+ searchParams.set("runId", runId);
790
2390
  }
791
- const body = {
792
- data: params.data,
793
- runtimeContext: params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0
794
- };
795
- return this.request(`/api/tools/${this.toolId}/execute?${url.toString()}`, {
2391
+ const requestContext = parseClientRequestContext(params.requestContext);
2392
+ const { requestContext: _, ...actionParams } = params;
2393
+ const url = `/api/agent-builder/${this.actionId}/streamVNext${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
2394
+ const response = await this.request(url, {
796
2395
  method: "POST",
797
- body
2396
+ body: { ...actionParams, requestContext },
2397
+ stream: true
798
2398
  });
799
- }
800
- };
801
- var RECORD_SEPARATOR2 = "";
802
- var VNextWorkflow = class extends BaseResource {
803
- constructor(options, workflowId) {
804
- super(options);
805
- this.workflowId = workflowId;
806
- }
807
- /**
808
- * Creates an async generator that processes a readable stream and yields vNext workflow records
809
- * separated by the Record Separator character (\x1E)
810
- *
811
- * @param stream - The readable stream to process
812
- * @returns An async generator that yields parsed records
813
- */
814
- async *streamProcessor(stream) {
815
- const reader = stream.getReader();
816
- let doneReading = false;
817
- let buffer = "";
818
- try {
819
- while (!doneReading) {
820
- const { done, value } = await reader.read();
821
- doneReading = done;
822
- if (done && !value) continue;
823
- try {
824
- const decoded = value ? new TextDecoder().decode(value) : "";
825
- const chunks = (buffer + decoded).split(RECORD_SEPARATOR2);
826
- buffer = chunks.pop() || "";
827
- for (const chunk of chunks) {
828
- if (chunk) {
829
- if (typeof chunk === "string") {
830
- try {
831
- const parsedChunk = JSON.parse(chunk);
832
- yield parsedChunk;
833
- } catch {
834
- }
835
- }
836
- }
837
- }
838
- } catch {
839
- }
840
- }
841
- if (buffer) {
842
- try {
843
- yield JSON.parse(buffer);
844
- } catch {
845
- }
846
- }
847
- } finally {
848
- reader.cancel().catch(() => {
849
- });
850
- }
851
- }
852
- /**
853
- * Retrieves details about the vNext workflow
854
- * @returns Promise containing vNext workflow details including steps and graphs
855
- */
856
- details() {
857
- return this.request(`/api/workflows/v-next/${this.workflowId}`);
858
- }
859
- /**
860
- * Retrieves all runs for a vNext workflow
861
- * @param params - Parameters for filtering runs
862
- * @returns Promise containing vNext workflow runs array
863
- */
864
- runs(params) {
865
- const searchParams = new URLSearchParams();
866
- if (params?.fromDate) {
867
- searchParams.set("fromDate", params.fromDate.toISOString());
868
- }
869
- if (params?.toDate) {
870
- searchParams.set("toDate", params.toDate.toISOString());
871
- }
872
- if (params?.limit) {
873
- searchParams.set("limit", String(params.limit));
874
- }
875
- if (params?.offset) {
876
- searchParams.set("offset", String(params.offset));
877
- }
878
- if (params?.resourceId) {
879
- searchParams.set("resourceId", params.resourceId);
2399
+ if (!response.ok) {
2400
+ throw new Error(`Failed to stream agent builder action VNext: ${response.statusText}`);
880
2401
  }
881
- if (searchParams.size) {
882
- return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
883
- } else {
884
- return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
2402
+ if (!response.body) {
2403
+ throw new Error("Response body is null");
885
2404
  }
2405
+ return response.body.pipeThrough(this.createRecordParserTransform());
886
2406
  }
887
2407
  /**
888
- * Creates a new vNext workflow run
889
- * @param params - Optional object containing the optional runId
890
- * @returns Promise containing the runId of the created run
2408
+ * Observes an existing agent builder action run stream.
2409
+ * Replays cached execution from the beginning, then continues with live stream.
2410
+ * This is the recommended method for recovery after page refresh/hot reload.
2411
+ * This calls `/api/agent-builder/:actionId/observe` (which delegates to observeStreamVNext).
891
2412
  */
892
- createRun(params) {
2413
+ async observeStream(params) {
893
2414
  const searchParams = new URLSearchParams();
894
- if (!!params?.runId) {
895
- searchParams.set("runId", params.runId);
896
- }
897
- return this.request(`/api/workflows/v-next/${this.workflowId}/create-run?${searchParams.toString()}`, {
898
- method: "POST"
899
- });
900
- }
901
- /**
902
- * Starts a vNext workflow run synchronously without waiting for the workflow to complete
903
- * @param params - Object containing the runId, inputData and runtimeContext
904
- * @returns Promise containing success message
905
- */
906
- start(params) {
907
- const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
908
- return this.request(`/api/workflows/v-next/${this.workflowId}/start?runId=${params.runId}`, {
909
- method: "POST",
910
- body: { inputData: params?.inputData, runtimeContext }
911
- });
912
- }
913
- /**
914
- * Resumes a suspended vNext workflow step synchronously without waiting for the vNext workflow to complete
915
- * @param params - Object containing the runId, step, resumeData and runtimeContext
916
- * @returns Promise containing success message
917
- */
918
- resume({
919
- step,
920
- runId,
921
- resumeData,
922
- ...rest
923
- }) {
924
- const runtimeContext = rest.runtimeContext ? Object.fromEntries(rest.runtimeContext.entries()) : void 0;
925
- return this.request(`/api/workflows/v-next/${this.workflowId}/resume?runId=${runId}`, {
2415
+ searchParams.set("runId", params.runId);
2416
+ const url = `/api/agent-builder/${this.actionId}/observe?${searchParams.toString()}`;
2417
+ const response = await this.request(url, {
926
2418
  method: "POST",
927
- stream: true,
928
- body: {
929
- step,
930
- resumeData,
931
- runtimeContext
932
- }
2419
+ stream: true
933
2420
  });
2421
+ if (!response.ok) {
2422
+ throw new Error(`Failed to observe agent builder action stream: ${response.statusText}`);
2423
+ }
2424
+ if (!response.body) {
2425
+ throw new Error("Response body is null");
2426
+ }
2427
+ return response.body.pipeThrough(this.createRecordParserTransform());
934
2428
  }
935
2429
  /**
936
- * Starts a vNext workflow run asynchronously and returns a promise that resolves when the vNext workflow is complete
937
- * @param params - Object containing the optional runId, inputData and runtimeContext
938
- * @returns Promise containing the vNext workflow execution results
2430
+ * Observes an existing agent builder action run stream using VNext streaming API.
2431
+ * Replays cached execution from the beginning, then continues with live stream.
2432
+ * This calls `/api/agent-builder/:actionId/observe-streamVNext`.
939
2433
  */
940
- startAsync(params) {
2434
+ async observeStreamVNext(params) {
941
2435
  const searchParams = new URLSearchParams();
942
- if (!!params?.runId) {
943
- searchParams.set("runId", params.runId);
944
- }
945
- const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
946
- return this.request(`/api/workflows/v-next/${this.workflowId}/start-async?${searchParams.toString()}`, {
2436
+ searchParams.set("runId", params.runId);
2437
+ const url = `/api/agent-builder/${this.actionId}/observe-streamVNext?${searchParams.toString()}`;
2438
+ const response = await this.request(url, {
947
2439
  method: "POST",
948
- body: { inputData: params.inputData, runtimeContext }
2440
+ stream: true
949
2441
  });
2442
+ if (!response.ok) {
2443
+ throw new Error(`Failed to observe agent builder action stream VNext: ${response.statusText}`);
2444
+ }
2445
+ if (!response.body) {
2446
+ throw new Error("Response body is null");
2447
+ }
2448
+ return response.body.pipeThrough(this.createRecordParserTransform());
950
2449
  }
951
2450
  /**
952
- * Resumes a suspended vNext workflow step asynchronously and returns a promise that resolves when the vNext workflow is complete
953
- * @param params - Object containing the runId, step, resumeData and runtimeContext
954
- * @returns Promise containing the vNext workflow resume results
2451
+ * Observes an existing agent builder action run stream using legacy streaming API.
2452
+ * Replays cached execution from the beginning, then continues with live stream.
2453
+ * This calls `/api/agent-builder/:actionId/observe-stream-legacy`.
955
2454
  */
956
- resumeAsync(params) {
957
- const runtimeContext = params.runtimeContext ? Object.fromEntries(params.runtimeContext.entries()) : void 0;
958
- return this.request(`/api/workflows/v-next/${this.workflowId}/resume-async?runId=${params.runId}`, {
959
- method: "POST",
960
- body: {
961
- step: params.step,
962
- resumeData: params.resumeData,
963
- runtimeContext
964
- }
2455
+ async observeStreamLegacy(params) {
2456
+ const searchParams = new URLSearchParams();
2457
+ searchParams.set("runId", params.runId);
2458
+ const url = `/api/agent-builder/${this.actionId}/observe-stream-legacy?${searchParams.toString()}`;
2459
+ const response = await this.request(url, {
2460
+ method: "POST",
2461
+ stream: true
965
2462
  });
2463
+ if (!response.ok) {
2464
+ throw new Error(`Failed to observe agent builder action stream legacy: ${response.statusText}`);
2465
+ }
2466
+ if (!response.body) {
2467
+ throw new Error("Response body is null");
2468
+ }
2469
+ return response.body.pipeThrough(this.createRecordParserTransform());
966
2470
  }
967
2471
  /**
968
- * Watches vNext workflow transitions in real-time
969
- * @param runId - Optional run ID to filter the watch stream
970
- * @returns AsyncGenerator that yields parsed records from the vNext workflow watch stream
2472
+ * Resumes a suspended agent builder action and streams the results.
2473
+ * This calls `/api/agent-builder/:actionId/resume-stream`.
971
2474
  */
972
- async watch({ runId }, onRecord) {
973
- const response = await this.request(`/api/workflows/v-next/${this.workflowId}/watch?runId=${runId}`, {
2475
+ async resumeStream(params) {
2476
+ const searchParams = new URLSearchParams();
2477
+ searchParams.set("runId", params.runId);
2478
+ const requestContext = parseClientRequestContext(params.requestContext);
2479
+ const { runId: _, requestContext: __, ...resumeParams } = params;
2480
+ const url = `/api/agent-builder/${this.actionId}/resume-stream?${searchParams.toString()}`;
2481
+ const response = await this.request(url, {
2482
+ method: "POST",
2483
+ body: { ...resumeParams, requestContext },
974
2484
  stream: true
975
2485
  });
976
2486
  if (!response.ok) {
977
- throw new Error(`Failed to watch vNext workflow: ${response.statusText}`);
2487
+ throw new Error(`Failed to resume agent builder action stream: ${response.statusText}`);
978
2488
  }
979
2489
  if (!response.body) {
980
2490
  throw new Error("Response body is null");
981
2491
  }
982
- for await (const record of this.streamProcessor(response.body)) {
983
- onRecord(record);
984
- }
2492
+ return response.body.pipeThrough(this.createRecordParserTransform());
985
2493
  }
986
- };
987
-
988
- // src/resources/a2a.ts
989
- var A2A = class extends BaseResource {
990
- constructor(options, agentId) {
991
- super(options);
992
- this.agentId = agentId;
2494
+ /**
2495
+ * Gets a specific action run by its ID.
2496
+ * This calls `/api/agent-builder/:actionId/runs/:runId`.
2497
+ */
2498
+ async runById(runId) {
2499
+ const url = `/api/agent-builder/${this.actionId}/runs/${runId}`;
2500
+ return this.request(url, {
2501
+ method: "GET"
2502
+ });
993
2503
  }
994
2504
  /**
995
- * Get the agent card with metadata about the agent
996
- * @returns Promise containing the agent card information
2505
+ * Gets details about this agent builder action.
2506
+ * This calls `/api/agent-builder/:actionId`.
997
2507
  */
998
- async getCard() {
999
- return this.request(`/.well-known/${this.agentId}/agent.json`);
2508
+ async details() {
2509
+ const result = await this.request(`/api/agent-builder/${this.actionId}`);
2510
+ return result;
1000
2511
  }
1001
2512
  /**
1002
- * Send a message to the agent and get a response
1003
- * @param params - Parameters for the task
1004
- * @returns Promise containing the task response
2513
+ * Gets all runs for this agent builder action.
2514
+ * This calls `/api/agent-builder/:actionId/runs`.
1005
2515
  */
1006
- async sendMessage(params) {
1007
- const response = await this.request(`/a2a/${this.agentId}`, {
1008
- method: "POST",
1009
- body: {
1010
- method: "tasks/send",
1011
- params
1012
- }
2516
+ async runs(params) {
2517
+ const searchParams = new URLSearchParams();
2518
+ if (params?.fromDate) {
2519
+ searchParams.set("fromDate", params.fromDate.toISOString());
2520
+ }
2521
+ if (params?.toDate) {
2522
+ searchParams.set("toDate", params.toDate.toISOString());
2523
+ }
2524
+ if (params?.perPage !== void 0) {
2525
+ searchParams.set("perPage", String(params.perPage));
2526
+ }
2527
+ if (params?.page !== void 0) {
2528
+ searchParams.set("page", String(params.page));
2529
+ }
2530
+ if (params?.resourceId) {
2531
+ searchParams.set("resourceId", params.resourceId);
2532
+ }
2533
+ const url = `/api/agent-builder/${this.actionId}/runs${searchParams.toString() ? `?${searchParams.toString()}` : ""}`;
2534
+ return this.request(url, {
2535
+ method: "GET"
1013
2536
  });
1014
- return { task: response.result };
1015
2537
  }
1016
2538
  /**
1017
- * Get the status and result of a task
1018
- * @param params - Parameters for querying the task
1019
- * @returns Promise containing the task response
2539
+ * Gets the execution result of an agent builder action run.
2540
+ * This calls `/api/agent-builder/:actionId/runs/:runId/execution-result`.
1020
2541
  */
1021
- async getTask(params) {
1022
- const response = await this.request(`/a2a/${this.agentId}`, {
1023
- method: "POST",
1024
- body: {
1025
- method: "tasks/get",
1026
- params
1027
- }
2542
+ async runExecutionResult(runId) {
2543
+ const url = `/api/agent-builder/${this.actionId}/runs/${runId}/execution-result`;
2544
+ return this.request(url, {
2545
+ method: "GET"
1028
2546
  });
1029
- return response.result;
1030
2547
  }
1031
2548
  /**
1032
- * Cancel a running task
1033
- * @param params - Parameters identifying the task to cancel
1034
- * @returns Promise containing the task response
2549
+ * Cancels an agent builder action run.
2550
+ * This calls `/api/agent-builder/:actionId/runs/:runId/cancel`.
1035
2551
  */
1036
- async cancelTask(params) {
1037
- return this.request(`/a2a/${this.agentId}`, {
1038
- method: "POST",
1039
- body: {
1040
- method: "tasks/cancel",
1041
- params
1042
- }
2552
+ async cancelRun(runId) {
2553
+ const url = `/api/agent-builder/${this.actionId}/runs/${runId}/cancel`;
2554
+ return this.request(url, {
2555
+ method: "POST"
1043
2556
  });
1044
2557
  }
2558
+ };
2559
+
2560
+ // src/resources/observability.ts
2561
+ var Observability = class extends BaseResource {
2562
+ constructor(options) {
2563
+ super(options);
2564
+ }
1045
2565
  /**
1046
- * Send a message and subscribe to streaming updates (not fully implemented)
1047
- * @param params - Parameters for the task
1048
- * @returns Promise containing the task response
2566
+ * Retrieves a specific trace by ID
2567
+ * @param traceId - ID of the trace to retrieve
2568
+ * @returns Promise containing the trace with all its spans
1049
2569
  */
1050
- async sendAndSubscribe(params) {
1051
- return this.request(`/a2a/${this.agentId}`, {
2570
+ getTrace(traceId) {
2571
+ return this.request(`/api/observability/traces/${traceId}`);
2572
+ }
2573
+ /**
2574
+ * Retrieves paginated list of traces with optional filtering
2575
+ * @param params - Parameters for pagination and filtering
2576
+ * @returns Promise containing paginated traces and pagination info
2577
+ */
2578
+ getTraces(params) {
2579
+ const { pagination, filters } = params;
2580
+ const { page, perPage, dateRange } = pagination || {};
2581
+ const { name, spanType, entityId, entityType } = filters || {};
2582
+ const searchParams = new URLSearchParams();
2583
+ if (page !== void 0) {
2584
+ searchParams.set("page", String(page));
2585
+ }
2586
+ if (perPage !== void 0) {
2587
+ searchParams.set("perPage", String(perPage));
2588
+ }
2589
+ if (name) {
2590
+ searchParams.set("name", name);
2591
+ }
2592
+ if (spanType !== void 0) {
2593
+ searchParams.set("spanType", String(spanType));
2594
+ }
2595
+ if (entityId && entityType) {
2596
+ searchParams.set("entityId", entityId);
2597
+ searchParams.set("entityType", entityType);
2598
+ }
2599
+ if (dateRange) {
2600
+ const dateRangeStr = JSON.stringify({
2601
+ start: dateRange.start instanceof Date ? dateRange.start.toISOString() : dateRange.start,
2602
+ end: dateRange.end instanceof Date ? dateRange.end.toISOString() : dateRange.end
2603
+ });
2604
+ searchParams.set("dateRange", dateRangeStr);
2605
+ }
2606
+ const queryString = searchParams.toString();
2607
+ return this.request(`/api/observability/traces${queryString ? `?${queryString}` : ""}`);
2608
+ }
2609
+ /**
2610
+ * Retrieves scores by trace ID and span ID
2611
+ * @param params - Parameters containing trace ID, span ID, and pagination options
2612
+ * @returns Promise containing scores and pagination info
2613
+ */
2614
+ listScoresBySpan(params) {
2615
+ const { traceId, spanId, page, perPage } = params;
2616
+ const searchParams = new URLSearchParams();
2617
+ if (page !== void 0) {
2618
+ searchParams.set("page", String(page));
2619
+ }
2620
+ if (perPage !== void 0) {
2621
+ searchParams.set("perPage", String(perPage));
2622
+ }
2623
+ const queryString = searchParams.toString();
2624
+ return this.request(
2625
+ `/api/observability/traces/${encodeURIComponent(traceId)}/${encodeURIComponent(spanId)}/scores${queryString ? `?${queryString}` : ""}`
2626
+ );
2627
+ }
2628
+ score(params) {
2629
+ return this.request(`/api/observability/traces/score`, {
1052
2630
  method: "POST",
1053
- body: {
1054
- method: "tasks/sendSubscribe",
1055
- params
1056
- },
1057
- stream: true
2631
+ body: { ...params }
1058
2632
  });
1059
2633
  }
1060
2634
  };
1061
2635
 
1062
2636
  // src/client.ts
1063
2637
  var MastraClient = class extends BaseResource {
2638
+ observability;
1064
2639
  constructor(options) {
1065
2640
  super(options);
2641
+ this.observability = new Observability(options);
1066
2642
  }
1067
2643
  /**
1068
2644
  * Retrieves all available agents
2645
+ * @param requestContext - Optional request context to pass as query parameter
1069
2646
  * @returns Promise containing map of agent IDs to agent details
1070
2647
  */
1071
- getAgents() {
1072
- return this.request("/api/agents");
1073
- }
1074
- async getAGUI({ resourceId }) {
1075
- const agents = await this.getAgents();
1076
- return Object.entries(agents).reduce(
1077
- (acc, [agentId]) => {
1078
- const agent = this.getAgent(agentId);
1079
- acc[agentId] = new AGUIAdapter({
1080
- agentId,
1081
- agent,
1082
- resourceId
1083
- });
1084
- return acc;
1085
- },
1086
- {}
1087
- );
2648
+ listAgents(requestContext) {
2649
+ const requestContextParam = base64RequestContext(parseClientRequestContext(requestContext));
2650
+ const searchParams = new URLSearchParams();
2651
+ if (requestContextParam) {
2652
+ searchParams.set("requestContext", requestContextParam);
2653
+ }
2654
+ const queryString = searchParams.toString();
2655
+ return this.request(`/api/agents${queryString ? `?${queryString}` : ""}`);
2656
+ }
2657
+ listAgentsModelProviders() {
2658
+ return this.request(`/api/agents/providers`);
1088
2659
  }
1089
2660
  /**
1090
2661
  * Gets an agent instance by ID
@@ -1095,53 +2666,118 @@ var MastraClient = class extends BaseResource {
1095
2666
  return new Agent(this.options, agentId);
1096
2667
  }
1097
2668
  /**
1098
- * Retrieves memory threads for a resource
1099
- * @param params - Parameters containing the resource ID
1100
- * @returns Promise containing array of memory threads
2669
+ * Lists memory threads for a resource with pagination support
2670
+ * @param params - Parameters containing resource ID, pagination options, and optional request context
2671
+ * @returns Promise containing paginated array of memory threads with metadata
2672
+ */
2673
+ async listMemoryThreads(params) {
2674
+ const queryParams = new URLSearchParams({
2675
+ resourceId: params.resourceId,
2676
+ resourceid: params.resourceId,
2677
+ agentId: params.agentId,
2678
+ ...params.page !== void 0 && { page: params.page.toString() },
2679
+ ...params.perPage !== void 0 && { perPage: params.perPage.toString() },
2680
+ ...params.orderBy && { orderBy: params.orderBy },
2681
+ ...params.sortDirection && { sortDirection: params.sortDirection }
2682
+ });
2683
+ const response = await this.request(
2684
+ `/api/memory/threads?${queryParams.toString()}${requestContextQueryString(params.requestContext, "&")}`
2685
+ );
2686
+ const actualResponse = "threads" in response ? response : {
2687
+ threads: response,
2688
+ total: response.length,
2689
+ page: params.page ?? 0,
2690
+ perPage: params.perPage ?? 100,
2691
+ hasMore: false
2692
+ };
2693
+ return actualResponse;
2694
+ }
2695
+ /**
2696
+ * Retrieves memory config for a resource
2697
+ * @param params - Parameters containing the resource ID and optional request context
2698
+ * @returns Promise containing memory configuration
1101
2699
  */
1102
- getMemoryThreads(params) {
1103
- return this.request(`/api/memory/threads?resourceid=${params.resourceId}&agentId=${params.agentId}`);
2700
+ getMemoryConfig(params) {
2701
+ return this.request(
2702
+ `/api/memory/config?agentId=${params.agentId}${requestContextQueryString(params.requestContext, "&")}`
2703
+ );
1104
2704
  }
1105
2705
  /**
1106
2706
  * Creates a new memory thread
1107
- * @param params - Parameters for creating the memory thread
2707
+ * @param params - Parameters for creating the memory thread including optional request context
1108
2708
  * @returns Promise containing the created memory thread
1109
2709
  */
1110
2710
  createMemoryThread(params) {
1111
- return this.request(`/api/memory/threads?agentId=${params.agentId}`, { method: "POST", body: params });
2711
+ return this.request(
2712
+ `/api/memory/threads?agentId=${params.agentId}${requestContextQueryString(params.requestContext, "&")}`,
2713
+ { method: "POST", body: params }
2714
+ );
1112
2715
  }
1113
2716
  /**
1114
2717
  * Gets a memory thread instance by ID
1115
2718
  * @param threadId - ID of the memory thread to retrieve
1116
2719
  * @returns MemoryThread instance
1117
2720
  */
1118
- getMemoryThread(threadId, agentId) {
2721
+ getMemoryThread({ threadId, agentId }) {
1119
2722
  return new MemoryThread(this.options, threadId, agentId);
1120
2723
  }
2724
+ listThreadMessages(threadId, opts = {}) {
2725
+ if (!opts.agentId && !opts.networkId) {
2726
+ throw new Error("Either agentId or networkId must be provided");
2727
+ }
2728
+ let url = "";
2729
+ if (opts.agentId) {
2730
+ url = `/api/memory/threads/${threadId}/messages?agentId=${opts.agentId}${requestContextQueryString(opts.requestContext, "&")}`;
2731
+ } else if (opts.networkId) {
2732
+ url = `/api/memory/network/threads/${threadId}/messages?networkId=${opts.networkId}${requestContextQueryString(opts.requestContext, "&")}`;
2733
+ }
2734
+ return this.request(url);
2735
+ }
2736
+ deleteThread(threadId, opts = {}) {
2737
+ let url = "";
2738
+ if (opts.agentId) {
2739
+ url = `/api/memory/threads/${threadId}?agentId=${opts.agentId}${requestContextQueryString(opts.requestContext, "&")}`;
2740
+ } else if (opts.networkId) {
2741
+ url = `/api/memory/network/threads/${threadId}?networkId=${opts.networkId}${requestContextQueryString(opts.requestContext, "&")}`;
2742
+ }
2743
+ return this.request(url, { method: "DELETE" });
2744
+ }
1121
2745
  /**
1122
2746
  * Saves messages to memory
1123
- * @param params - Parameters containing messages to save
2747
+ * @param params - Parameters containing messages to save and optional request context
1124
2748
  * @returns Promise containing the saved messages
1125
2749
  */
1126
2750
  saveMessageToMemory(params) {
1127
- return this.request(`/api/memory/save-messages?agentId=${params.agentId}`, {
1128
- method: "POST",
1129
- body: params
1130
- });
2751
+ return this.request(
2752
+ `/api/memory/save-messages?agentId=${params.agentId}${requestContextQueryString(params.requestContext, "&")}`,
2753
+ {
2754
+ method: "POST",
2755
+ body: params
2756
+ }
2757
+ );
1131
2758
  }
1132
2759
  /**
1133
2760
  * Gets the status of the memory system
2761
+ * @param agentId - The agent ID
2762
+ * @param requestContext - Optional request context to pass as query parameter
1134
2763
  * @returns Promise containing memory system status
1135
2764
  */
1136
- getMemoryStatus(agentId) {
1137
- return this.request(`/api/memory/status?agentId=${agentId}`);
2765
+ getMemoryStatus(agentId, requestContext) {
2766
+ return this.request(`/api/memory/status?agentId=${agentId}${requestContextQueryString(requestContext, "&")}`);
1138
2767
  }
1139
2768
  /**
1140
2769
  * Retrieves all available tools
2770
+ * @param requestContext - Optional request context to pass as query parameter
1141
2771
  * @returns Promise containing map of tool IDs to tool details
1142
2772
  */
1143
- getTools() {
1144
- return this.request("/api/tools");
2773
+ listTools(requestContext) {
2774
+ const requestContextParam = base64RequestContext(parseClientRequestContext(requestContext));
2775
+ const searchParams = new URLSearchParams();
2776
+ if (requestContextParam) {
2777
+ searchParams.set("requestContext", requestContextParam);
2778
+ }
2779
+ const queryString = searchParams.toString();
2780
+ return this.request(`/api/tools${queryString ? `?${queryString}` : ""}`);
1145
2781
  }
1146
2782
  /**
1147
2783
  * Gets a tool instance by ID
@@ -1153,10 +2789,17 @@ var MastraClient = class extends BaseResource {
1153
2789
  }
1154
2790
  /**
1155
2791
  * Retrieves all available workflows
2792
+ * @param requestContext - Optional request context to pass as query parameter
1156
2793
  * @returns Promise containing map of workflow IDs to workflow details
1157
2794
  */
1158
- getWorkflows() {
1159
- return this.request("/api/workflows");
2795
+ listWorkflows(requestContext) {
2796
+ const requestContextParam = base64RequestContext(parseClientRequestContext(requestContext));
2797
+ const searchParams = new URLSearchParams();
2798
+ if (requestContextParam) {
2799
+ searchParams.set("requestContext", requestContextParam);
2800
+ }
2801
+ const queryString = searchParams.toString();
2802
+ return this.request(`/api/workflows${queryString ? `?${queryString}` : ""}`);
1160
2803
  }
1161
2804
  /**
1162
2805
  * Gets a workflow instance by ID
@@ -1167,19 +2810,18 @@ var MastraClient = class extends BaseResource {
1167
2810
  return new Workflow(this.options, workflowId);
1168
2811
  }
1169
2812
  /**
1170
- * Retrieves all available vNext workflows
1171
- * @returns Promise containing map of vNext workflow IDs to vNext workflow details
2813
+ * Gets all available agent builder actions
2814
+ * @returns Promise containing map of action IDs to action details
1172
2815
  */
1173
- getVNextWorkflows() {
1174
- return this.request("/api/workflows/v-next");
2816
+ getAgentBuilderActions() {
2817
+ return this.request("/api/agent-builder/");
1175
2818
  }
1176
2819
  /**
1177
- * Gets a vNext workflow instance by ID
1178
- * @param workflowId - ID of the vNext workflow to retrieve
1179
- * @returns vNext Workflow instance
2820
+ * Gets an agent builder instance for executing agent-builder workflows
2821
+ * @returns AgentBuilder instance
1180
2822
  */
1181
- getVNextWorkflow(workflowId) {
1182
- return new VNextWorkflow(this.options, workflowId);
2823
+ getAgentBuilderAction(actionId) {
2824
+ return new AgentBuilder(this.options, actionId);
1183
2825
  }
1184
2826
  /**
1185
2827
  * Gets a vector instance by name
@@ -1194,8 +2836,42 @@ var MastraClient = class extends BaseResource {
1194
2836
  * @param params - Parameters for filtering logs
1195
2837
  * @returns Promise containing array of log messages
1196
2838
  */
1197
- getLogs(params) {
1198
- return this.request(`/api/logs?transportId=${params.transportId}`);
2839
+ listLogs(params) {
2840
+ const { transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
2841
+ const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
2842
+ const searchParams = new URLSearchParams();
2843
+ if (transportId) {
2844
+ searchParams.set("transportId", transportId);
2845
+ }
2846
+ if (fromDate) {
2847
+ searchParams.set("fromDate", fromDate.toISOString());
2848
+ }
2849
+ if (toDate) {
2850
+ searchParams.set("toDate", toDate.toISOString());
2851
+ }
2852
+ if (logLevel) {
2853
+ searchParams.set("logLevel", logLevel);
2854
+ }
2855
+ if (page) {
2856
+ searchParams.set("page", String(page));
2857
+ }
2858
+ if (perPage) {
2859
+ searchParams.set("perPage", String(perPage));
2860
+ }
2861
+ if (_filters) {
2862
+ if (Array.isArray(_filters)) {
2863
+ for (const filter of _filters) {
2864
+ searchParams.append("filters", filter);
2865
+ }
2866
+ } else {
2867
+ searchParams.set("filters", _filters);
2868
+ }
2869
+ }
2870
+ if (searchParams.size) {
2871
+ return this.request(`/api/logs?${searchParams}`);
2872
+ } else {
2873
+ return this.request(`/api/logs`);
2874
+ }
1199
2875
  }
1200
2876
  /**
1201
2877
  * Gets logs for a specific run
@@ -1203,29 +2879,23 @@ var MastraClient = class extends BaseResource {
1203
2879
  * @returns Promise containing array of log messages
1204
2880
  */
1205
2881
  getLogForRun(params) {
1206
- return this.request(`/api/logs/${params.runId}?transportId=${params.transportId}`);
1207
- }
1208
- /**
1209
- * List of all log transports
1210
- * @returns Promise containing list of log transports
1211
- */
1212
- getLogTransports() {
1213
- return this.request("/api/logs/transports");
1214
- }
1215
- /**
1216
- * List of all traces (paged)
1217
- * @param params - Parameters for filtering traces
1218
- * @returns Promise containing telemetry data
1219
- */
1220
- getTelemetry(params) {
1221
- const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
1222
- const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
2882
+ const { runId, transportId, fromDate, toDate, logLevel, filters, page, perPage } = params;
2883
+ const _filters = filters ? Object.entries(filters).map(([key, value]) => `${key}:${value}`) : [];
1223
2884
  const searchParams = new URLSearchParams();
1224
- if (name) {
1225
- searchParams.set("name", name);
2885
+ if (runId) {
2886
+ searchParams.set("runId", runId);
2887
+ }
2888
+ if (transportId) {
2889
+ searchParams.set("transportId", transportId);
2890
+ }
2891
+ if (fromDate) {
2892
+ searchParams.set("fromDate", fromDate.toISOString());
2893
+ }
2894
+ if (toDate) {
2895
+ searchParams.set("toDate", toDate.toISOString());
1226
2896
  }
1227
- if (scope) {
1228
- searchParams.set("scope", scope);
2897
+ if (logLevel) {
2898
+ searchParams.set("logLevel", logLevel);
1229
2899
  }
1230
2900
  if (page) {
1231
2901
  searchParams.set("page", String(page));
@@ -1233,41 +2903,75 @@ var MastraClient = class extends BaseResource {
1233
2903
  if (perPage) {
1234
2904
  searchParams.set("perPage", String(perPage));
1235
2905
  }
1236
- if (_attribute) {
1237
- if (Array.isArray(_attribute)) {
1238
- for (const attr of _attribute) {
1239
- searchParams.append("attribute", attr);
2906
+ if (_filters) {
2907
+ if (Array.isArray(_filters)) {
2908
+ for (const filter of _filters) {
2909
+ searchParams.append("filters", filter);
1240
2910
  }
1241
2911
  } else {
1242
- searchParams.set("attribute", _attribute);
2912
+ searchParams.set("filters", _filters);
1243
2913
  }
1244
2914
  }
1245
- if (fromDate) {
1246
- searchParams.set("fromDate", fromDate.toISOString());
1247
- }
1248
- if (toDate) {
1249
- searchParams.set("toDate", toDate.toISOString());
1250
- }
1251
2915
  if (searchParams.size) {
1252
- return this.request(`/api/telemetry?${searchParams}`);
2916
+ return this.request(`/api/logs/${runId}?${searchParams}`);
1253
2917
  } else {
1254
- return this.request(`/api/telemetry`);
2918
+ return this.request(`/api/logs/${runId}`);
2919
+ }
2920
+ }
2921
+ /**
2922
+ * List of all log transports
2923
+ * @returns Promise containing list of log transports
2924
+ */
2925
+ listLogTransports() {
2926
+ return this.request("/api/logs/transports");
2927
+ }
2928
+ /**
2929
+ * Retrieves a list of available MCP servers.
2930
+ * @param params - Optional parameters for pagination (perPage, page).
2931
+ * @returns Promise containing the list of MCP servers and pagination info.
2932
+ */
2933
+ getMcpServers(params) {
2934
+ const searchParams = new URLSearchParams();
2935
+ if (params?.perPage !== void 0) {
2936
+ searchParams.set("perPage", String(params.perPage));
2937
+ }
2938
+ if (params?.page !== void 0) {
2939
+ searchParams.set("page", String(params.page));
2940
+ }
2941
+ const queryString = searchParams.toString();
2942
+ return this.request(`/api/mcp/v0/servers${queryString ? `?${queryString}` : ""}`);
2943
+ }
2944
+ /**
2945
+ * Retrieves detailed information for a specific MCP server.
2946
+ * @param serverId - The ID of the MCP server to retrieve.
2947
+ * @param params - Optional parameters, e.g., specific version.
2948
+ * @returns Promise containing the detailed MCP server information.
2949
+ */
2950
+ getMcpServerDetails(serverId, params) {
2951
+ const searchParams = new URLSearchParams();
2952
+ if (params?.version) {
2953
+ searchParams.set("version", params.version);
1255
2954
  }
2955
+ const queryString = searchParams.toString();
2956
+ return this.request(`/api/mcp/v0/servers/${serverId}${queryString ? `?${queryString}` : ""}`);
1256
2957
  }
1257
2958
  /**
1258
- * Retrieves all available networks
1259
- * @returns Promise containing map of network IDs to network details
2959
+ * Retrieves a list of tools for a specific MCP server.
2960
+ * @param serverId - The ID of the MCP server.
2961
+ * @returns Promise containing the list of tools.
1260
2962
  */
1261
- getNetworks() {
1262
- return this.request("/api/networks");
2963
+ getMcpServerTools(serverId) {
2964
+ return this.request(`/api/mcp/${serverId}/tools`);
1263
2965
  }
1264
2966
  /**
1265
- * Gets a network instance by ID
1266
- * @param networkId - ID of the network to retrieve
1267
- * @returns Network instance
2967
+ * Gets an MCPTool resource instance for a specific tool on an MCP server.
2968
+ * This instance can then be used to fetch details or execute the tool.
2969
+ * @param serverId - The ID of the MCP server.
2970
+ * @param toolId - The ID of the tool.
2971
+ * @returns MCPTool instance.
1268
2972
  */
1269
- getNetwork(networkId) {
1270
- return new Network(this.options, networkId);
2973
+ getMcpServerTool(serverId, toolId) {
2974
+ return new MCPTool(this.options, serverId, toolId);
1271
2975
  }
1272
2976
  /**
1273
2977
  * Gets an A2A client for interacting with an agent via the A2A protocol
@@ -1277,6 +2981,182 @@ var MastraClient = class extends BaseResource {
1277
2981
  getA2A(agentId) {
1278
2982
  return new A2A(this.options, agentId);
1279
2983
  }
2984
+ /**
2985
+ * Retrieves the working memory for a specific thread (optionally resource-scoped).
2986
+ * @param agentId - ID of the agent.
2987
+ * @param threadId - ID of the thread.
2988
+ * @param resourceId - Optional ID of the resource.
2989
+ * @returns Working memory for the specified thread or resource.
2990
+ */
2991
+ getWorkingMemory({
2992
+ agentId,
2993
+ threadId,
2994
+ resourceId,
2995
+ requestContext
2996
+ }) {
2997
+ return this.request(
2998
+ `/api/memory/threads/${threadId}/working-memory?agentId=${agentId}&resourceId=${resourceId}${requestContextQueryString(requestContext, "&")}`
2999
+ );
3000
+ }
3001
+ searchMemory({
3002
+ agentId,
3003
+ resourceId,
3004
+ threadId,
3005
+ searchQuery,
3006
+ memoryConfig,
3007
+ requestContext
3008
+ }) {
3009
+ const params = new URLSearchParams({
3010
+ searchQuery,
3011
+ resourceId,
3012
+ agentId
3013
+ });
3014
+ if (threadId) {
3015
+ params.append("threadId", threadId);
3016
+ }
3017
+ if (memoryConfig) {
3018
+ params.append("memoryConfig", JSON.stringify(memoryConfig));
3019
+ }
3020
+ return this.request(`/api/memory/search?${params}${requestContextQueryString(requestContext, "&")}`);
3021
+ }
3022
+ /**
3023
+ * Updates the working memory for a specific thread (optionally resource-scoped).
3024
+ * @param agentId - ID of the agent.
3025
+ * @param threadId - ID of the thread.
3026
+ * @param workingMemory - The new working memory content.
3027
+ * @param resourceId - Optional ID of the resource.
3028
+ */
3029
+ updateWorkingMemory({
3030
+ agentId,
3031
+ threadId,
3032
+ workingMemory,
3033
+ resourceId,
3034
+ requestContext
3035
+ }) {
3036
+ return this.request(
3037
+ `/api/memory/threads/${threadId}/working-memory?agentId=${agentId}${requestContextQueryString(requestContext, "&")}`,
3038
+ {
3039
+ method: "POST",
3040
+ body: {
3041
+ workingMemory,
3042
+ resourceId
3043
+ }
3044
+ }
3045
+ );
3046
+ }
3047
+ /**
3048
+ * Retrieves all available scorers
3049
+ * @returns Promise containing list of available scorers
3050
+ */
3051
+ listScorers() {
3052
+ return this.request("/api/scores/scorers");
3053
+ }
3054
+ /**
3055
+ * Retrieves a scorer by ID
3056
+ * @param scorerId - ID of the scorer to retrieve
3057
+ * @returns Promise containing the scorer
3058
+ */
3059
+ getScorer(scorerId) {
3060
+ return this.request(`/api/scores/scorers/${encodeURIComponent(scorerId)}`);
3061
+ }
3062
+ listScoresByScorerId(params) {
3063
+ const { page, perPage, scorerId, entityId, entityType } = params;
3064
+ const searchParams = new URLSearchParams();
3065
+ if (entityId) {
3066
+ searchParams.set("entityId", entityId);
3067
+ }
3068
+ if (entityType) {
3069
+ searchParams.set("entityType", entityType);
3070
+ }
3071
+ if (page !== void 0) {
3072
+ searchParams.set("page", String(page));
3073
+ }
3074
+ if (perPage !== void 0) {
3075
+ searchParams.set("perPage", String(perPage));
3076
+ }
3077
+ const queryString = searchParams.toString();
3078
+ return this.request(`/api/scores/scorer/${encodeURIComponent(scorerId)}${queryString ? `?${queryString}` : ""}`);
3079
+ }
3080
+ /**
3081
+ * Retrieves scores by run ID
3082
+ * @param params - Parameters containing run ID and pagination options
3083
+ * @returns Promise containing scores and pagination info
3084
+ */
3085
+ listScoresByRunId(params) {
3086
+ const { runId, page, perPage } = params;
3087
+ const searchParams = new URLSearchParams();
3088
+ if (page !== void 0) {
3089
+ searchParams.set("page", String(page));
3090
+ }
3091
+ if (perPage !== void 0) {
3092
+ searchParams.set("perPage", String(perPage));
3093
+ }
3094
+ const queryString = searchParams.toString();
3095
+ return this.request(`/api/scores/run/${encodeURIComponent(runId)}${queryString ? `?${queryString}` : ""}`);
3096
+ }
3097
+ /**
3098
+ * Retrieves scores by entity ID and type
3099
+ * @param params - Parameters containing entity ID, type, and pagination options
3100
+ * @returns Promise containing scores and pagination info
3101
+ */
3102
+ listScoresByEntityId(params) {
3103
+ const { entityId, entityType, page, perPage } = params;
3104
+ const searchParams = new URLSearchParams();
3105
+ if (page !== void 0) {
3106
+ searchParams.set("page", String(page));
3107
+ }
3108
+ if (perPage !== void 0) {
3109
+ searchParams.set("perPage", String(perPage));
3110
+ }
3111
+ const queryString = searchParams.toString();
3112
+ return this.request(
3113
+ `/api/scores/entity/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}${queryString ? `?${queryString}` : ""}`
3114
+ );
3115
+ }
3116
+ /**
3117
+ * Saves a score
3118
+ * @param params - Parameters containing the score data to save
3119
+ * @returns Promise containing the saved score
3120
+ */
3121
+ saveScore(params) {
3122
+ return this.request("/api/scores", {
3123
+ method: "POST",
3124
+ body: params
3125
+ });
3126
+ }
3127
+ getTrace(traceId) {
3128
+ return this.observability.getTrace(traceId);
3129
+ }
3130
+ getTraces(params) {
3131
+ return this.observability.getTraces(params);
3132
+ }
3133
+ listScoresBySpan(params) {
3134
+ return this.observability.listScoresBySpan(params);
3135
+ }
3136
+ score(params) {
3137
+ return this.observability.score(params);
3138
+ }
1280
3139
  };
1281
3140
 
1282
- export { MastraClient };
3141
+ // src/tools.ts
3142
+ var ClientTool = class {
3143
+ id;
3144
+ description;
3145
+ inputSchema;
3146
+ outputSchema;
3147
+ execute;
3148
+ constructor(opts) {
3149
+ this.id = opts.id;
3150
+ this.description = opts.description;
3151
+ this.inputSchema = opts.inputSchema;
3152
+ this.outputSchema = opts.outputSchema;
3153
+ this.execute = opts.execute;
3154
+ }
3155
+ };
3156
+ function createTool(opts) {
3157
+ return new ClientTool(opts);
3158
+ }
3159
+
3160
+ export { ClientTool, MastraClient, createTool };
3161
+ //# sourceMappingURL=index.js.map
3162
+ //# sourceMappingURL=index.js.map