@mastra/client-js 1.59.0 → 1.60.0-alpha.0

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
@@ -15,4 +15,6 @@ export type { DashboardColumn, DashboardDefaults, DashboardDefinition, Dashboard
15
15
  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
+ export type { SignalWriteOptions } from './resources/signal-writes.js';
19
+ export type { CreateFeedbackBody, CreateFeedbackResponse, CreateScoreBody, CreateScoreResponse, ReplaceFeedbackBody, } from './resources/observability-route-types.js';
18
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"}
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"}
package/dist/index.js CHANGED
@@ -2909,7 +2909,10 @@ var Agent = class extends BaseResource {
2909
2909
  toolCallId: toolCall.toolCallId,
2910
2910
  toolName: toolCall.toolName,
2911
2911
  input: toolCall.args,
2912
- result,
2912
+ output: {
2913
+ type: "json",
2914
+ value: result
2915
+ },
2913
2916
  ...modelOutput != null ? { providerOptions: { mastra: { modelOutput } } } : {},
2914
2917
  ...observability ? { __mastraObservability: observability } : {}
2915
2918
  });
@@ -5327,6 +5330,59 @@ var AgentBuilder = class extends BaseResource {
5327
5330
  return this.request(url, { method: "POST" });
5328
5331
  }
5329
5332
  };
5333
+ // src/resources/signal-writes.ts
5334
+ function isMissingAnchor(error) {
5335
+ if (!(error instanceof MastraClientError) || error.status !== 404) return false;
5336
+ const code = error.body?.code;
5337
+ return code === "TRACE_NOT_FOUND" || code === "SPAN_NOT_FOUND";
5338
+ }
5339
+ /** Adds bounded anchor retries to the normal transport retries, with one immutable payload. */
5340
+ async function writeSignal(resource, path, method, body, options = {}) {
5341
+ const { anchorRetryTimeoutMs = 3e4, ...requestOptions } = options;
5342
+ if (!Number.isSafeInteger(anchorRetryTimeoutMs) || anchorRetryTimeoutMs < 0 || anchorRetryTimeoutMs > 3e4) throw new RangeError("anchorRetryTimeoutMs must be an integer between 0 and 30000");
5343
+ const payload = JSON.parse(JSON.stringify(body));
5344
+ const deadline = new AbortController();
5345
+ const signal = mergeAbortSignals(resource.options.abortSignal, options.signal, deadline.signal);
5346
+ let timer;
5347
+ let lastAnchorError;
5348
+ let delay = Math.max(1, resource.options.backoffMs ?? 100);
5349
+ try {
5350
+ for (;;) {
5351
+ try {
5352
+ return await resource.request(path, {
5353
+ ...requestOptions,
5354
+ method,
5355
+ body: payload,
5356
+ signal
5357
+ });
5358
+ } catch (error) {
5359
+ if (signal.aborted) throw error;
5360
+ if (!isMissingAnchor(error) || anchorRetryTimeoutMs === 0) throw error;
5361
+ lastAnchorError = error;
5362
+ timer ??= setTimeout(() => deadline.abort(), anchorRetryTimeoutMs);
5363
+ }
5364
+ await new Promise((resolve, reject) => {
5365
+ const onAbort = () => {
5366
+ clearTimeout(wait);
5367
+ reject(signal.reason);
5368
+ };
5369
+ const wait = setTimeout(() => {
5370
+ signal.removeEventListener("abort", onAbort);
5371
+ resolve();
5372
+ }, delay);
5373
+ signal.addEventListener("abort", onAbort, { once: true });
5374
+ if (signal.aborted) onAbort();
5375
+ });
5376
+ delay = Math.max(1, Math.min(delay * 2, resource.options.maxBackoffMs ?? 1e3));
5377
+ }
5378
+ } catch (error) {
5379
+ if (deadline.signal.aborted && !options.signal?.aborted && !resource.options.abortSignal?.aborted && (error === deadline.signal.reason || error instanceof Error && error.name === "AbortError")) throw lastAnchorError ?? error;
5380
+ throw error;
5381
+ } finally {
5382
+ clearTimeout(timer);
5383
+ deadline.abort();
5384
+ }
5385
+ }
5330
5386
  // src/resources/observability.ts
5331
5387
  /** Client resource for interacting with the Mastra observability API (traces, logs, scores, feedback, and metrics). */
5332
5388
  var Observability = class extends BaseResource {
@@ -5598,13 +5654,18 @@ var Observability = class extends BaseResource {
5598
5654
  }
5599
5655
  /**
5600
5656
  * Creates a single score record in the observability store.
5601
- * Timestamp is set server-side.
5657
+ * Missing IDs and timestamps are generated once, before retries.
5602
5658
  */
5603
- createScore(params) {
5604
- return this.request(`/observability/scores`, {
5605
- method: "POST",
5606
- body: params
5607
- });
5659
+ createScore(params, options) {
5660
+ const body = {
5661
+ ...params,
5662
+ ...params?.score && { score: {
5663
+ ...params.score,
5664
+ scoreId: params.score.scoreId ?? v4(),
5665
+ timestamp: params.score.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
5666
+ } }
5667
+ };
5668
+ return writeSignal(this, "/observability/scores", "POST", body, options);
5608
5669
  }
5609
5670
  /**
5610
5671
  * Deletes score records by scoreId, optionally scoped to a tenant.
@@ -5666,13 +5727,22 @@ var Observability = class extends BaseResource {
5666
5727
  }
5667
5728
  /**
5668
5729
  * Creates a single feedback record in the observability store.
5669
- * Timestamp is set server-side.
5730
+ * Missing IDs and timestamps are generated once, before retries.
5670
5731
  */
5671
- createFeedback(params) {
5672
- return this.request(`/observability/feedback`, {
5673
- method: "POST",
5674
- body: params
5675
- });
5732
+ createFeedback(params, options) {
5733
+ const body = {
5734
+ ...params,
5735
+ ...params?.feedback && { feedback: {
5736
+ ...params.feedback,
5737
+ feedbackId: params.feedback.feedbackId ?? v4(),
5738
+ timestamp: params.feedback.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
5739
+ } }
5740
+ };
5741
+ return writeSignal(this, "/observability/feedback", "POST", body, options);
5742
+ }
5743
+ /** Replaces Platform feedback using its original identity and timestamp. Each accepted PUT retry is a new replacement. */
5744
+ replaceFeedback(params, options) {
5745
+ return writeSignal(this, `/observability/feedback/${encodeURIComponent(params.feedback.feedbackId)}`, "PUT", params, options);
5676
5746
  }
5677
5747
  /** Updates a feedback record's review workflow status. */
5678
5748
  updateFeedbackReviewStatus(params) {
@@ -8436,8 +8506,8 @@ var MastraClient = class extends BaseResource {
8436
8506
  return this.observability.listScores(params);
8437
8507
  }
8438
8508
  /** Creates a single score record in the observability store. */
8439
- createScore(params) {
8440
- return this.observability.createScore(params);
8509
+ createScore(params, options) {
8510
+ return this.observability.createScore(params, options);
8441
8511
  }
8442
8512
  /** Deletes score records by scoreId, optionally scoped to a tenant. */
8443
8513
  deleteScores(params) {
@@ -8464,8 +8534,12 @@ var MastraClient = class extends BaseResource {
8464
8534
  return this.observability.listFeedback(params);
8465
8535
  }
8466
8536
  /** Creates a single feedback record in the observability store. */
8467
- createFeedback(params) {
8468
- return this.observability.createFeedback(params);
8537
+ createFeedback(params, options) {
8538
+ return this.observability.createFeedback(params, options);
8539
+ }
8540
+ /** Full replacement on Platform. Preserve the original identity/timestamp; each accepted retry is a new replacement. */
8541
+ replaceFeedback(params, options) {
8542
+ return this.observability.replaceFeedback(params, options);
8469
8543
  }
8470
8544
  /** Deletes feedback records by feedbackId, optionally scoped to a tenant. */
8471
8545
  deleteFeedback(params) {