@mastra/client-js 1.47.0-alpha.1 → 1.47.0-alpha.3

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 (50) hide show
  1. package/dist/_types/@ai-sdk_provider/package.json +1 -0
  2. package/dist/_types/@ai-sdk_provider-utils/dist/index.d.ts +1 -1
  3. package/dist/_types/@ai-sdk_provider-utils/package.json +1 -0
  4. package/dist/_types/@ai-sdk_ui-utils/dist/index.d.ts +3 -3
  5. package/dist/_types/@ai-sdk_ui-utils/package.json +1 -0
  6. package/dist/client.d.ts +45 -201
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/docs/SKILL.md +1 -1
  9. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  10. package/dist/docs/references/docs-connections-a2a.md +4 -3
  11. package/dist/docs/references/reference-client-js-mastra-client.md +1 -1
  12. package/dist/index.cjs +40 -28
  13. package/dist/index.cjs.map +1 -1
  14. package/dist/index.d.ts +1 -1
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +40 -28
  17. package/dist/index.js.map +1 -1
  18. package/dist/resources/agent-builder.d.ts +25 -40
  19. package/dist/resources/agent-builder.d.ts.map +1 -1
  20. package/dist/resources/agent-controller.d.ts +5 -4
  21. package/dist/resources/agent-controller.d.ts.map +1 -1
  22. package/dist/resources/agent.d.ts +34 -72
  23. package/dist/resources/agent.d.ts.map +1 -1
  24. package/dist/resources/channels.d.ts +13 -31
  25. package/dist/resources/channels.d.ts.map +1 -1
  26. package/dist/resources/conversations.d.ts +6 -3
  27. package/dist/resources/conversations.d.ts.map +1 -1
  28. package/dist/resources/mcp-tool.d.ts +9 -6
  29. package/dist/resources/mcp-tool.d.ts.map +1 -1
  30. package/dist/resources/memory-thread.d.ts +6 -11
  31. package/dist/resources/memory-thread.d.ts.map +1 -1
  32. package/dist/resources/observability-route-types.d.ts +88 -0
  33. package/dist/resources/observability-route-types.d.ts.map +1 -0
  34. package/dist/resources/observability.d.ts +6 -9
  35. package/dist/resources/observability.d.ts.map +1 -1
  36. package/dist/resources/responses.d.ts +5 -2
  37. package/dist/resources/responses.d.ts.map +1 -1
  38. package/dist/resources/run.d.ts +21 -57
  39. package/dist/resources/run.d.ts.map +1 -1
  40. package/dist/resources/tool.d.ts +6 -4
  41. package/dist/resources/tool.d.ts.map +1 -1
  42. package/dist/resources/vector.d.ts +5 -10
  43. package/dist/resources/vector.d.ts.map +1 -1
  44. package/dist/resources/workflow.d.ts +8 -10
  45. package/dist/resources/workflow.d.ts.map +1 -1
  46. package/dist/route-types.generated.d.ts +3108 -2558
  47. package/dist/route-types.generated.d.ts.map +1 -1
  48. package/dist/types.d.ts +236 -1599
  49. package/dist/types.d.ts.map +1 -1
  50. package/package.json +3 -3
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
@@ -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
@@ -3993,13 +3998,14 @@ var MCPTool = class extends BaseResource {
3993
3998
  /**
3994
3999
  * Executes this specific tool on the MCP server.
3995
4000
  * @param params - Parameters for tool execution, including data/args and optional requestContext.
3996
- * @returns Promise containing the result of the tool execution.
4001
+ * On a 2026-07-28 server a tool can answer `{ status: 'suspended', suspendPayload, resumeSchema }`;
4002
+ * call again with the same `data` plus `resumeData` (matching `resumeSchema`) and the echoed
4003
+ * `suspendPayload` to continue it.
4004
+ * @returns Promise containing `{ result }`, or the suspended shape described above.
3997
4005
  */
3998
4006
  execute(params) {
3999
- const body = {};
4000
- if (params.data !== void 0) body.data = params.data;
4001
- if (params.requestContext !== void 0) body.requestContext = params.requestContext;
4002
- return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute`, {
4007
+ const { requestContext, ...body } = params;
4008
+ return this.request(`/mcp/${encodeURIComponent(this.serverId)}/tools/${encodeURIComponent(this.toolId)}/execute${requestContextQueryString(requestContext)}`, {
4003
4009
  method: "POST",
4004
4010
  body
4005
4011
  });
@@ -4017,23 +4023,29 @@ var AgentBuilder = class extends BaseResource {
4017
4023
  this.actionId = actionId;
4018
4024
  }
4019
4025
  transformWorkflowResult(result) {
4020
- if (result.status === "success") return {
4021
- success: result.result.success || false,
4022
- applied: result.result.applied || false,
4023
- branchName: result.result.branchName,
4024
- message: result.result.message || "Agent builder action completed",
4025
- validationResults: result.result.validationResults,
4026
- error: result.result.error,
4027
- errors: result.result.errors,
4028
- stepResults: result.result.stepResults
4029
- };
4030
- else if (result.status === "failed") return {
4031
- success: false,
4032
- applied: false,
4033
- message: `Agent builder action failed: ${result.error.message}`,
4034
- error: result.error.message
4035
- };
4036
- else return {
4026
+ if (result.status === "success") {
4027
+ const actionResult = result.result;
4028
+ return {
4029
+ success: actionResult?.success ?? false,
4030
+ applied: actionResult?.applied ?? false,
4031
+ branchName: actionResult?.branchName,
4032
+ message: actionResult?.message ?? "Agent builder action completed",
4033
+ validationResults: actionResult?.validationResults,
4034
+ error: actionResult?.error,
4035
+ errors: actionResult?.errors,
4036
+ stepResults: actionResult?.stepResults
4037
+ };
4038
+ }
4039
+ if (result.status === "failed") {
4040
+ const message = result.error?.message ?? "Agent builder action failed";
4041
+ return {
4042
+ success: false,
4043
+ applied: false,
4044
+ message: `Agent builder action failed: ${message}`,
4045
+ error: message
4046
+ };
4047
+ }
4048
+ return {
4037
4049
  success: false,
4038
4050
  applied: false,
4039
4051
  message: "Agent builder action was suspended",
@@ -4229,7 +4241,7 @@ var AgentBuilder = class extends BaseResource {
4229
4241
  * This calls `/agent-builder/:actionId`.
4230
4242
  */
4231
4243
  async details() {
4232
- return await this.request(`/agent-builder/${this.actionId}`);
4244
+ return this.request(`/agent-builder/${this.actionId}`);
4233
4245
  }
4234
4246
  /**
4235
4247
  * Gets all runs for this agent builder action.
@@ -4458,7 +4470,7 @@ var Observability = class extends BaseResource {
4458
4470
  deleteTraces(params) {
4459
4471
  return this.request(`/observability/traces/delete`, {
4460
4472
  method: "POST",
4461
- body: { traceIds: params.traceIds }
4473
+ body: params
4462
4474
  });
4463
4475
  }
4464
4476
  /**