@mastra/client-js 1.60.0-alpha.1 → 1.60.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -16,5 +16,5 @@ export type { GetMetricTimeSeriesResponse } from './types.js';
16
16
  export type { AggregateTracesArgs, AggregateTracesResponse, AggregateSpansArgs, AggregateSpansResponse, TraceAggregateDiscovery, GetTraceQueryFieldsArgs, GetTraceQueryFieldsResponse, GetTraceQueryValuesArgs, GetTraceQueryValuesResponse, TraceQueryCanonicalFieldDescriptor, TraceQueryGroupResponse, TraceQueryKeysetTraceResponse, TraceQueryObservedFieldDescriptor, TraceQueryOperator, TraceQueryPredicateScope, TraceQueryResponse, TraceQueryTraceResponse, TraceQueryValueKind, } from './resources/observability-route-types.js';
17
17
  export type { Body, Client, ClientMethod, ClientPath, ClientRequest, ClientResponse, ClientResponseKind, ClientRoute, PathParams, QueryParams, RouteKey, RouteRequest, RouteResponse, RouteResponseType, RouteTypes, } from './route-types.generated.js';
18
18
  export type { SignalWriteOptions } from './resources/signal-writes.js';
19
- export type { CreateFeedbackBody, CreateFeedbackResponse, CreateScoreBody, CreateScoreResponse, ReplaceFeedbackBody, } from './resources/observability-route-types.js';
19
+ export type { CreateFeedbackBody, CreateFeedbackResponse, CreateScoreBody, CreateScoreResponse, DeleteFeedbackResponse, DeleteScoresResponse, DeleteTracesResponse, ReplaceFeedbackBody, } from './resources/observability-route-types.js';
20
20
  //# 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,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,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,EACV,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,6BAA6B,EAC7B,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,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;AAEpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uCAAuC,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,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,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,EACV,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,uBAAuB,EACvB,6BAA6B,EAC7B,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,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;AAEpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC"}
package/dist/index.js CHANGED
@@ -1315,11 +1315,13 @@ async function executeClientToolWithObservability({ clientTool, args, toolName,
1315
1315
  }
1316
1316
  };
1317
1317
  }
1318
- async function executeToolCallAndRespond({ response, params, agentId, resourceId, threadId, requestContext, respondFn }) {
1318
+ async function executeToolCallAndRespond({ response, params, agentId, resourceId, threadId, requestContext, respondFn, abortSignal }) {
1319
1319
  if (response.finishReason === "tool-calls") {
1320
1320
  const toolCalls = response.toolCalls;
1321
1321
  if (!toolCalls || !Array.isArray(toolCalls)) return response;
1322
+ const toolResults = [];
1322
1323
  for (const toolCall of toolCalls) {
1324
+ if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
1323
1325
  const clientTool = params.clientTools?.[toolCall.payload.toolName];
1324
1326
  if (clientTool && clientTool.execute) {
1325
1327
  const { result, observability } = await executeClientToolWithObservability({
@@ -1349,19 +1351,22 @@ async function executeToolCallAndRespond({ response, params, agentId, resourceId
1349
1351
  ...modelOutput != null ? { providerOptions: { mastra: { modelOutput } } } : {}
1350
1352
  };
1351
1353
  if (observability) toolResultContent.__mastraObservability = observability;
1352
- const newMessages = [...response.response.messages || [], {
1353
- role: "tool",
1354
- content: [toolResultContent]
1355
- }];
1356
- const updatedMessages = threadId ? newMessages : [...Array.isArray(params.messages) ? params.messages : [], ...newMessages];
1357
- const respondOptions = {
1358
- ...params,
1359
- clientTools: params.clientToolsResolver?.() ?? params.clientTools
1360
- };
1361
- delete respondOptions.messages;
1362
- return respondFn(updatedMessages, respondOptions);
1354
+ toolResults.push(toolResultContent);
1363
1355
  }
1364
1356
  }
1357
+ if (toolResults.length > 0) {
1358
+ const newMessages = [...response.response.messages || [], {
1359
+ role: "tool",
1360
+ content: toolResults
1361
+ }];
1362
+ const updatedMessages = threadId ? newMessages : [...Array.isArray(params.messages) ? params.messages : [], ...newMessages];
1363
+ const respondOptions = {
1364
+ ...params,
1365
+ clientTools: params.clientToolsResolver?.() ?? params.clientTools
1366
+ };
1367
+ delete respondOptions.messages;
1368
+ return respondFn(updatedMessages, respondOptions);
1369
+ }
1365
1370
  }
1366
1371
  return response;
1367
1372
  }
@@ -2058,7 +2063,9 @@ var Agent = class extends BaseResource {
2058
2063
  if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
2059
2064
  const toolCalls = response.toolCalls;
2060
2065
  if (!toolCalls || !Array.isArray(toolCalls)) return response;
2066
+ const toolResults = [];
2061
2067
  for (const toolCall of toolCalls) {
2068
+ if (abortSignal?.aborted) throw abortSignal.reason ?? new DOMException("This operation was aborted", "AbortError");
2062
2069
  const clientTool = processedParams.clientTools?.[toolCall.toolName];
2063
2070
  if (clientTool && clientTool.execute) {
2064
2071
  const { result, observability } = await executeClientToolWithObservability({
@@ -2079,22 +2086,25 @@ var Agent = class extends BaseResource {
2079
2086
  }
2080
2087
  }
2081
2088
  });
2082
- const updatedMessages = [...response.response.messages, {
2083
- role: "tool",
2084
- content: [{
2085
- type: "tool-result",
2086
- toolCallId: toolCall.toolCallId,
2087
- toolName: toolCall.toolName,
2088
- result,
2089
- ...observability ? { __mastraObservability: observability } : {}
2090
- }]
2091
- }];
2092
- return this.generateLegacy({
2093
- ...params,
2094
- messages: updatedMessages
2089
+ toolResults.push({
2090
+ type: "tool-result",
2091
+ toolCallId: toolCall.toolCallId,
2092
+ toolName: toolCall.toolName,
2093
+ result,
2094
+ ...observability ? { __mastraObservability: observability } : {}
2095
2095
  });
2096
2096
  }
2097
2097
  }
2098
+ if (toolResults.length > 0) {
2099
+ const updatedMessages = [...response.response.messages, {
2100
+ role: "tool",
2101
+ content: toolResults
2102
+ }];
2103
+ return this.generateLegacy({
2104
+ ...params,
2105
+ messages: updatedMessages
2106
+ });
2107
+ }
2098
2108
  }
2099
2109
  return response;
2100
2110
  }
@@ -2136,7 +2146,8 @@ var Agent = class extends BaseResource {
2136
2146
  resourceId,
2137
2147
  threadId,
2138
2148
  requestContext,
2139
- respondFn: this.generate.bind(this)
2149
+ respondFn: this.generate.bind(this),
2150
+ abortSignal
2140
2151
  });
2141
2152
  }
2142
2153
  return response;
@@ -5629,7 +5640,9 @@ var Observability = class extends BaseResource {
5629
5640
  * On ClickHouse-backed stores, reads may briefly return deleted rows until
5630
5641
  * the lightweight delete is fully applied.
5631
5642
  * @param params - IDs of the traces to delete
5632
- * @returns Promise resolving to `{ success: true }` once the delete is issued
5643
+ * @returns `{ success: true }` after OSS deletion, or `{ accepted: true }`
5644
+ * when a supporting Platform backend queues cleanup. Acceptance does not
5645
+ * mean records have disappeared from reads.
5633
5646
  */
5634
5647
  deleteTraces(params) {
5635
5648
  return this.request(`/observability/traces/delete`, {
@@ -5682,6 +5695,8 @@ var Observability = class extends BaseResource {
5682
5695
  * Deletes score records by scoreId, optionally scoped to a tenant.
5683
5696
  * Idempotent: deleting missing ids succeeds. Depending on the storage
5684
5697
  * backend (e.g. ClickHouse), deletion may be eventually consistent.
5698
+ * A supporting Platform backend returns `{ accepted: true }` after queueing
5699
+ * cleanup; OSS returns `{ success: boolean }` after deletion.
5685
5700
  */
5686
5701
  deleteScores(params) {
5687
5702
  return this.request(`/observability/scores`, {
@@ -5770,6 +5785,8 @@ var Observability = class extends BaseResource {
5770
5785
  * Deletes feedback records by feedbackId, optionally scoped to a tenant.
5771
5786
  * Idempotent: deleting missing ids succeeds. Depending on the storage
5772
5787
  * backend (e.g. ClickHouse), deletion may be eventually consistent.
5788
+ * A supporting Platform backend returns `{ accepted: true }` after queueing
5789
+ * cleanup; OSS returns `{ success: boolean }` after deletion.
5773
5790
  */
5774
5791
  deleteFeedback(params) {
5775
5792
  return this.request(`/observability/feedback`, {
@@ -8503,7 +8520,8 @@ var MastraClient = class extends BaseResource {
8503
8520
  * Deletes traces by ID, cascading to all associated spans and trace-linked
8504
8521
  * signal events (scores, feedback, metrics, logs). Signals without a trace ID
8505
8522
  * are untouched. On ClickHouse-backed stores, reads may briefly return
8506
- * deleted rows until the delete is fully applied.
8523
+ * deleted rows until the delete is fully applied. A supporting Platform backend
8524
+ * returns `{ accepted: true }` after queueing cleanup, before records disappear.
8507
8525
  */
8508
8526
  deleteTraces(params) {
8509
8527
  return this.observability.deleteTraces(params);
@@ -8528,7 +8546,10 @@ var MastraClient = class extends BaseResource {
8528
8546
  createScore(params, options) {
8529
8547
  return this.observability.createScore(params, options);
8530
8548
  }
8531
- /** Deletes score records by scoreId, optionally scoped to a tenant. */
8549
+ /**
8550
+ * Deletes score records by scoreId, optionally scoped to a tenant.
8551
+ * Returns OSS success or Platform acceptance; accepted cleanup is asynchronous.
8552
+ */
8532
8553
  deleteScores(params) {
8533
8554
  return this.observability.deleteScores(params);
8534
8555
  }
@@ -8564,7 +8585,10 @@ var MastraClient = class extends BaseResource {
8564
8585
  replaceFeedback(params, options) {
8565
8586
  return this.observability.replaceFeedback(params, options);
8566
8587
  }
8567
- /** Deletes feedback records by feedbackId, optionally scoped to a tenant. */
8588
+ /**
8589
+ * Deletes feedback records by feedbackId, optionally scoped to a tenant.
8590
+ * Returns OSS success or Platform acceptance; accepted cleanup is asynchronous.
8591
+ */
8568
8592
  deleteFeedback(params) {
8569
8593
  return this.observability.deleteFeedback(params);
8570
8594
  }
@@ -9339,6 +9363,7 @@ var MastraClient = class extends BaseResource {
9339
9363
  if (options?.page !== void 0) searchParams.set("page", String(options.page));
9340
9364
  if (options?.perPage !== void 0) searchParams.set("perPage", String(options.perPage));
9341
9365
  for (const tag of options?.tags ?? []) searchParams.append("tags", tag);
9366
+ if (options?.status) searchParams.set("status", options.status);
9342
9367
  if (options?.orderBy) {
9343
9368
  searchParams.set("orderBy[field]", options.orderBy.field);
9344
9369
  searchParams.set("orderBy[direction]", options.orderBy.direction);