@mastra/client-js 1.47.0-alpha.2 → 1.47.0-alpha.4

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 (46) hide show
  1. package/dist/client.d.ts +45 -201
  2. package/dist/client.d.ts.map +1 -1
  3. package/dist/docs/SKILL.md +1 -1
  4. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  5. package/dist/docs/references/reference-client-js-mastra-client.md +1 -1
  6. package/dist/index.cjs +57 -35
  7. package/dist/index.cjs.map +1 -1
  8. package/dist/index.d.ts +1 -1
  9. package/dist/index.d.ts.map +1 -1
  10. package/dist/index.js +58 -36
  11. package/dist/index.js.map +1 -1
  12. package/dist/resources/a2a.d.ts +5 -1
  13. package/dist/resources/a2a.d.ts.map +1 -1
  14. package/dist/resources/agent-builder.d.ts +25 -40
  15. package/dist/resources/agent-builder.d.ts.map +1 -1
  16. package/dist/resources/agent-controller.d.ts +5 -4
  17. package/dist/resources/agent-controller.d.ts.map +1 -1
  18. package/dist/resources/agent.d.ts +32 -70
  19. package/dist/resources/agent.d.ts.map +1 -1
  20. package/dist/resources/channels.d.ts +13 -31
  21. package/dist/resources/channels.d.ts.map +1 -1
  22. package/dist/resources/conversations.d.ts +6 -3
  23. package/dist/resources/conversations.d.ts.map +1 -1
  24. package/dist/resources/mcp-tool.d.ts +3 -5
  25. package/dist/resources/mcp-tool.d.ts.map +1 -1
  26. package/dist/resources/memory-thread.d.ts +6 -11
  27. package/dist/resources/memory-thread.d.ts.map +1 -1
  28. package/dist/resources/observability-route-types.d.ts +88 -0
  29. package/dist/resources/observability-route-types.d.ts.map +1 -0
  30. package/dist/resources/observability.d.ts +6 -9
  31. package/dist/resources/observability.d.ts.map +1 -1
  32. package/dist/resources/responses.d.ts +5 -2
  33. package/dist/resources/responses.d.ts.map +1 -1
  34. package/dist/resources/run.d.ts +21 -57
  35. package/dist/resources/run.d.ts.map +1 -1
  36. package/dist/resources/tool.d.ts +6 -4
  37. package/dist/resources/tool.d.ts.map +1 -1
  38. package/dist/resources/vector.d.ts +5 -10
  39. package/dist/resources/vector.d.ts.map +1 -1
  40. package/dist/resources/workflow.d.ts +8 -10
  41. package/dist/resources/workflow.d.ts.map +1 -1
  42. package/dist/route-types.generated.d.ts +2750 -2127
  43. package/dist/route-types.generated.d.ts.map +1 -1
  44. package/dist/types.d.ts +230 -1598
  45. package/dist/types.d.ts.map +1 -1
  46. package/package.json +5 -5
package/dist/index.d.ts CHANGED
@@ -10,6 +10,6 @@ export { RequestContext } from '@mastra/core/request-context';
10
10
  export type { ObservabilityCollector } from './observability/types.js';
11
11
  export type { QueryTraceThreadsInput, QueryTraceThreadsResult, QueryTracesInput } from './resources/observability.js';
12
12
  export type { UIMessageWithMetadata } from '@mastra/core/agent';
13
- export type { GetMetricTimeSeriesResponse } from '@mastra/core/storage';
13
+ export type { GetMetricTimeSeriesResponse } from './types.js';
14
14
  export type { Body, Client, ClientMethod, ClientPath, ClientRequest, ClientResponse, ClientResponseKind, ClientRoute, PathParams, QueryParams, RouteKey, RouteRequest, RouteResponse, RouteResponseType, RouteTypes, } from './route-types.generated.js';
15
15
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACvG,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACnH,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EACV,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kCAAkC,EAClC,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACvG,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,2BAA2B,EAC3B,UAAU,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACnH,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC"}
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import { standardSchemaToJSONSchema, toStandardSchema } from "@mastra/schema-com
5
5
  import { RequestContext, RequestContext as RequestContext$1 } from "@mastra/core/request-context";
6
6
  import { zodToJsonSchema } from "@mastra/schema-compat/zod-to-json";
7
7
  import { MastraA2AError } from "@mastra/core/a2a/client";
8
- import { AgentCard, CancelTaskRequest, GetTaskRequest, ListTasksRequest, ListTasksResponse, SendMessageRequest, SendMessageResponse, StreamResponse, SubscribeToTaskRequest, Task } from "@mastra/core/a2a/v1";
8
+ import { AgentCard, CancelTaskRequest, DeleteTaskPushNotificationConfigRequest, GetTaskPushNotificationConfigRequest, GetTaskRequest, ListTaskPushNotificationConfigsRequest, ListTaskPushNotificationConfigsResponse, ListTasksRequest, ListTasksResponse, SendMessageRequest, SendMessageResponse, StreamResponse, SubscribeToTaskRequest, Task, TaskPushNotificationConfig } from "@mastra/core/a2a/v1";
9
9
  import canonicalize from "canonicalize";
10
10
  import { base64url, compactVerify, decodeProtectedHeader, importJWK, importSPKI, importX509 } from "jose";
11
11
  //#region src/observability/collector.ts
@@ -895,6 +895,11 @@ var Agent = class extends BaseResource {
895
895
  * depending on the toolset's scope).
896
896
  *
897
897
  * @param threadId - Optional thread ID for thread-scoped browser sessions
898
+ *
899
+ * @remarks This is a browser-stream adapter compatibility endpoint, not a
900
+ * `SERVER_ROUTES` route. Its historical deployer implementation returns
901
+ * `{ success: true }`; no generated contract exists while the adapter owns it.
902
+ * The public `boolean` result remains broad for backwards compatibility.
898
903
  */
899
904
  closeBrowser(threadId) {
900
905
  return this.request(`/agents/${this.agentId}/browser/close`, {
@@ -3211,7 +3216,7 @@ var Run = class extends BaseResource {
3211
3216
  resourceId: params.resourceId,
3212
3217
  perStep: params.perStep
3213
3218
  }
3214
- }).then(deserializeWorkflowError);
3219
+ }).then((result) => deserializeWorkflowError(result));
3215
3220
  }
3216
3221
  /**
3217
3222
  * Starts a workflow run and returns a stream
@@ -3293,7 +3298,7 @@ var Run = class extends BaseResource {
3293
3298
  perStep: params.perStep,
3294
3299
  forEachIndex: params.forEachIndex
3295
3300
  }
3296
- }).then(deserializeWorkflowError);
3301
+ }).then((result) => deserializeWorkflowError(result));
3297
3302
  }
3298
3303
  /**
3299
3304
  * Resumes a suspended workflow step without waiting for the workflow to complete (fire-and-forget)
@@ -3377,7 +3382,7 @@ var Run = class extends BaseResource {
3377
3382
  requestContext,
3378
3383
  tracingOptions: params?.tracingOptions
3379
3384
  }
3380
- }).then(deserializeWorkflowError);
3385
+ }).then((result) => deserializeWorkflowError(result));
3381
3386
  }
3382
3387
  /**
3383
3388
  * Time travels a workflow run synchronously without waiting for the workflow to complete
@@ -3407,7 +3412,7 @@ var Run = class extends BaseResource {
3407
3412
  ...params,
3408
3413
  requestContext
3409
3414
  }
3410
- }).then(deserializeWorkflowError);
3415
+ }).then((result) => deserializeWorkflowError(result));
3411
3416
  }
3412
3417
  /**
3413
3418
  * Time travels a workflow run and returns a stream
@@ -3919,12 +3924,27 @@ var A2AV1 = class extends BaseResource {
3919
3924
  }
3920
3925
  }));
3921
3926
  }
3927
+ async createTaskPushNotificationConfig(params) {
3928
+ const result = await this.rpc("CreateTaskPushNotificationConfig", TaskPushNotificationConfig.toJSON(params));
3929
+ return TaskPushNotificationConfig.fromJSON(result);
3930
+ }
3931
+ async getTaskPushNotificationConfig(params) {
3932
+ const result = await this.rpc("GetTaskPushNotificationConfig", GetTaskPushNotificationConfigRequest.toJSON(params));
3933
+ return TaskPushNotificationConfig.fromJSON(result);
3934
+ }
3935
+ async listTaskPushNotificationConfigs(params) {
3936
+ const result = await this.rpc("ListTaskPushNotificationConfigs", ListTaskPushNotificationConfigsRequest.toJSON(params));
3937
+ return ListTaskPushNotificationConfigsResponse.fromJSON(result);
3938
+ }
3939
+ async deleteTaskPushNotificationConfig(params) {
3940
+ await this.rpc("DeleteTaskPushNotificationConfig", DeleteTaskPushNotificationConfigRequest.toJSON(params));
3941
+ }
3922
3942
  async getAgentCard() {
3923
3943
  const card = await this.request(`/.well-known/${this.agentId}/agent-card.json`, { headers: { "A2A-Version": "1.0" } });
3924
3944
  return AgentCard.fromJSON(card);
3925
3945
  }
3926
3946
  async sendMessage(params) {
3927
- const result = await this.rpc("message/send", SendMessageRequest.toJSON(params));
3947
+ const result = await this.rpc("SendMessage", SendMessageRequest.toJSON(params));
3928
3948
  return SendMessageResponse.fromJSON(result);
3929
3949
  }
3930
3950
  async *sendMessageStream(params) {
@@ -3934,7 +3954,7 @@ var A2AV1 = class extends BaseResource {
3934
3954
  body: {
3935
3955
  jsonrpc: "2.0",
3936
3956
  id: crypto.randomUUID(),
3937
- method: "message/stream",
3957
+ method: "SendStreamingMessage",
3938
3958
  params: SendMessageRequest.toJSON(params)
3939
3959
  },
3940
3960
  stream: true
@@ -3942,15 +3962,15 @@ var A2AV1 = class extends BaseResource {
3942
3962
  for await (const event of processA2AStream(await requireResponseBody(response, "message/stream"))) yield StreamResponse.fromJSON(event);
3943
3963
  }
3944
3964
  async getTask(params) {
3945
- const result = await this.rpc("tasks/get", GetTaskRequest.toJSON(params));
3965
+ const result = await this.rpc("GetTask", GetTaskRequest.toJSON(params));
3946
3966
  return Task.fromJSON(result);
3947
3967
  }
3948
3968
  async listTasks(params) {
3949
- const result = await this.rpc("tasks/list", ListTasksRequest.toJSON(params));
3969
+ const result = await this.rpc("ListTasks", ListTasksRequest.toJSON(params));
3950
3970
  return ListTasksResponse.fromJSON(result);
3951
3971
  }
3952
3972
  async cancelTask(params) {
3953
- const result = await this.rpc("tasks/cancel", CancelTaskRequest.toJSON(params));
3973
+ const result = await this.rpc("CancelTask", CancelTaskRequest.toJSON(params));
3954
3974
  return Task.fromJSON(result);
3955
3975
  }
3956
3976
  async *resubscribeTask(params) {
@@ -3960,7 +3980,7 @@ var A2AV1 = class extends BaseResource {
3960
3980
  body: {
3961
3981
  jsonrpc: "2.0",
3962
3982
  id: crypto.randomUUID(),
3963
- method: "tasks/resubscribe",
3983
+ method: "SubscribeToTask",
3964
3984
  params: SubscribeToTaskRequest.toJSON(params)
3965
3985
  },
3966
3986
  stream: true
@@ -3999,12 +4019,8 @@ var MCPTool = class extends BaseResource {
3999
4019
  * @returns Promise containing `{ result }`, or the suspended shape described above.
4000
4020
  */
4001
4021
  execute(params) {
4002
- const body = {};
4003
- if (params.data !== void 0) body.data = params.data;
4004
- if (params.requestContext !== void 0) body.requestContext = params.requestContext;
4005
- if (params.resumeData !== void 0) body.resumeData = params.resumeData;
4006
- if (params.suspendPayload !== void 0) body.suspendPayload = params.suspendPayload;
4007
- return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute`, {
4022
+ const { requestContext, ...body } = params;
4023
+ return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute${requestContextQueryString(requestContext)}`, {
4008
4024
  method: "POST",
4009
4025
  body
4010
4026
  });
@@ -4022,23 +4038,29 @@ var AgentBuilder = class extends BaseResource {
4022
4038
  this.actionId = actionId;
4023
4039
  }
4024
4040
  transformWorkflowResult(result) {
4025
- if (result.status === "success") return {
4026
- success: result.result.success || false,
4027
- applied: result.result.applied || false,
4028
- branchName: result.result.branchName,
4029
- message: result.result.message || "Agent builder action completed",
4030
- validationResults: result.result.validationResults,
4031
- error: result.result.error,
4032
- errors: result.result.errors,
4033
- stepResults: result.result.stepResults
4034
- };
4035
- else if (result.status === "failed") return {
4036
- success: false,
4037
- applied: false,
4038
- message: `Agent builder action failed: ${result.error.message}`,
4039
- error: result.error.message
4040
- };
4041
- else return {
4041
+ if (result.status === "success") {
4042
+ const actionResult = result.result;
4043
+ return {
4044
+ success: actionResult?.success ?? false,
4045
+ applied: actionResult?.applied ?? false,
4046
+ branchName: actionResult?.branchName,
4047
+ message: actionResult?.message ?? "Agent builder action completed",
4048
+ validationResults: actionResult?.validationResults,
4049
+ error: actionResult?.error,
4050
+ errors: actionResult?.errors,
4051
+ stepResults: actionResult?.stepResults
4052
+ };
4053
+ }
4054
+ if (result.status === "failed") {
4055
+ const message = result.error?.message ?? "Agent builder action failed";
4056
+ return {
4057
+ success: false,
4058
+ applied: false,
4059
+ message: `Agent builder action failed: ${message}`,
4060
+ error: message
4061
+ };
4062
+ }
4063
+ return {
4042
4064
  success: false,
4043
4065
  applied: false,
4044
4066
  message: "Agent builder action was suspended",
@@ -4234,7 +4256,7 @@ var AgentBuilder = class extends BaseResource {
4234
4256
  * This calls `/agent-builder/:actionId`.
4235
4257
  */
4236
4258
  async details() {
4237
- return await this.request(`/agent-builder/${this.actionId}`);
4259
+ return this.request(`/agent-builder/${this.actionId}`);
4238
4260
  }
4239
4261
  /**
4240
4262
  * Gets all runs for this agent builder action.
@@ -4463,7 +4485,7 @@ var Observability = class extends BaseResource {
4463
4485
  deleteTraces(params) {
4464
4486
  return this.request(`/observability/traces/delete`, {
4465
4487
  method: "POST",
4466
- body: { traceIds: params.traceIds }
4488
+ body: params
4467
4489
  });
4468
4490
  }
4469
4491
  /**