@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/client.d.ts +6 -3
- package/dist/client.d.ts.map +1 -1
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +33 -2
- package/dist/docs/references/reference-client-js-observability.md +67 -2
- package/dist/index.cjs +91 -17
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +91 -17
- package/dist/index.js.map +1 -1
- package/dist/resources/observability-route-types.d.ts +7 -0
- package/dist/resources/observability-route-types.d.ts.map +1 -1
- package/dist/resources/observability.d.ts +8 -5
- package/dist/resources/observability.d.ts.map +1 -1
- package/dist/resources/signal-writes.d.ts +9 -0
- package/dist/resources/signal-writes.d.ts.map +1 -0
- package/dist/route-types.generated.d.ts +33 -9
- package/dist/route-types.generated.d.ts.map +1 -1
- package/package.json +2 -2
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
|
package/dist/index.d.ts.map
CHANGED
|
@@ -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
|
-
|
|
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
|
-
*
|
|
5657
|
+
* Missing IDs and timestamps are generated once, before retries.
|
|
5602
5658
|
*/
|
|
5603
|
-
createScore(params) {
|
|
5604
|
-
|
|
5605
|
-
|
|
5606
|
-
|
|
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
|
-
*
|
|
5730
|
+
* Missing IDs and timestamps are generated once, before retries.
|
|
5670
5731
|
*/
|
|
5671
|
-
createFeedback(params) {
|
|
5672
|
-
|
|
5673
|
-
|
|
5674
|
-
|
|
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) {
|