@mastra/client-js 1.44.0-alpha.1 → 1.44.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/client.d.ts +54 -2
- package/dist/client.d.ts.map +1 -1
- package/dist/docs/SKILL.md +2 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/docs/references/reference-client-js-datasets.md +56 -1
- package/dist/docs/references/reference-client-js-mastra-client.md +3 -1
- package/dist/docs/references/reference-client-js-observability.md +43 -0
- package/dist/docs/references/reference-editor-versioning.md +1 -1
- package/dist/docs/references/reference-observability-tracing-trace-query.md +179 -0
- package/dist/index.cjs +73 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +73 -0
- package/dist/index.js.map +1 -1
- package/dist/resources/observability.d.ts +23 -2
- package/dist/resources/observability.d.ts.map +1 -1
- package/dist/route-types.generated.d.ts +832 -515
- package/dist/route-types.generated.d.ts.map +1 -1
- package/dist/types.d.ts +3 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +5 -5
package/dist/index.js
CHANGED
|
@@ -4304,6 +4304,18 @@ var Observability = class extends BaseResource {
|
|
|
4304
4304
|
return this.request(`/observability/traces${queryString ? `?${queryString}` : ""}`);
|
|
4305
4305
|
}
|
|
4306
4306
|
/**
|
|
4307
|
+
* Queries completed logical traces using recursive trace and related-record predicates.
|
|
4308
|
+
*
|
|
4309
|
+
* @param params - Advanced trace query, including its required time range
|
|
4310
|
+
* @returns Matching lightweight traces or distinct thread groups
|
|
4311
|
+
*/
|
|
4312
|
+
queryTraces(params) {
|
|
4313
|
+
return this.request("/observability/traces/query", {
|
|
4314
|
+
method: "POST",
|
|
4315
|
+
body: params
|
|
4316
|
+
});
|
|
4317
|
+
}
|
|
4318
|
+
/**
|
|
4307
4319
|
* Retrieves paginated list of traces carrying only the fields a trace list renders.
|
|
4308
4320
|
*
|
|
4309
4321
|
* Same filtering, ordering and delta-polling contract as {@link listTraces}, but rows
|
|
@@ -4376,6 +4388,21 @@ var Observability = class extends BaseResource {
|
|
|
4376
4388
|
});
|
|
4377
4389
|
}
|
|
4378
4390
|
/**
|
|
4391
|
+
* Deletes traces by ID, cascading to all associated data: spans, trace
|
|
4392
|
+
* roots/branches, and signal events (scores, feedback, metrics, logs) that
|
|
4393
|
+
* reference the deleted traces. Signals without a trace ID are untouched.
|
|
4394
|
+
* On ClickHouse-backed stores, reads may briefly return deleted rows until
|
|
4395
|
+
* the lightweight delete is fully applied.
|
|
4396
|
+
* @param params - IDs of the traces to delete
|
|
4397
|
+
* @returns Promise resolving to `{ success: true }` once the delete is issued
|
|
4398
|
+
*/
|
|
4399
|
+
deleteTraces(params) {
|
|
4400
|
+
return this.request(`/observability/traces/delete`, {
|
|
4401
|
+
method: "POST",
|
|
4402
|
+
body: { traceIds: params.traceIds }
|
|
4403
|
+
});
|
|
4404
|
+
}
|
|
4405
|
+
/**
|
|
4379
4406
|
* Retrieves a paginated list of logs with optional filtering and sorting.
|
|
4380
4407
|
*/
|
|
4381
4408
|
listLogs(params = {}) {
|
|
@@ -6785,6 +6812,10 @@ var MastraClient = class extends BaseResource {
|
|
|
6785
6812
|
listTraces(params = {}) {
|
|
6786
6813
|
return this.observability.listTraces(params);
|
|
6787
6814
|
}
|
|
6815
|
+
/** Queries completed logical traces using recursive trace and related-record predicates. */
|
|
6816
|
+
queryTraces(params) {
|
|
6817
|
+
return this.observability.queryTraces(params);
|
|
6818
|
+
}
|
|
6788
6819
|
/**
|
|
6789
6820
|
* Retrieves paginated list of traces carrying only the fields a trace list renders.
|
|
6790
6821
|
* Same contract as {@link listTraces}, but rows omit the `attributes`/`input`/`output`
|
|
@@ -6815,6 +6846,15 @@ var MastraClient = class extends BaseResource {
|
|
|
6815
6846
|
listScoresBySpan(params) {
|
|
6816
6847
|
return this.observability.listScoresBySpan(params);
|
|
6817
6848
|
}
|
|
6849
|
+
/**
|
|
6850
|
+
* Deletes traces by ID, cascading to all associated spans and trace-linked
|
|
6851
|
+
* signal events (scores, feedback, metrics, logs). Signals without a trace ID
|
|
6852
|
+
* are untouched. On ClickHouse-backed stores, reads may briefly return
|
|
6853
|
+
* deleted rows until the delete is fully applied.
|
|
6854
|
+
*/
|
|
6855
|
+
deleteTraces(params) {
|
|
6856
|
+
return this.observability.deleteTraces(params);
|
|
6857
|
+
}
|
|
6818
6858
|
/** Scores one or more traces using a specified scorer (fire-and-forget). */
|
|
6819
6859
|
score(params) {
|
|
6820
6860
|
return this.observability.score(params);
|
|
@@ -7423,6 +7463,13 @@ var MastraClient = class extends BaseResource {
|
|
|
7423
7463
|
return this.request(`/datasets/${encodeURIComponent(datasetId)}/items/${encodeURIComponent(itemId)}`, { method: "DELETE" });
|
|
7424
7464
|
}
|
|
7425
7465
|
/**
|
|
7466
|
+
* Permanently scrubs a dataset item's data from all versions and linked experiment results
|
|
7467
|
+
*/
|
|
7468
|
+
purgeDatasetItem(datasetId, itemId, tenancy) {
|
|
7469
|
+
const qs = buildTenancyQuery(tenancy);
|
|
7470
|
+
return this.request(`/datasets/${encodeURIComponent(datasetId)}/items/${encodeURIComponent(itemId)}/purge${qs}`, { method: "DELETE" });
|
|
7471
|
+
}
|
|
7472
|
+
/**
|
|
7426
7473
|
* Batch inserts items to a dataset
|
|
7427
7474
|
*/
|
|
7428
7475
|
batchInsertDatasetItems(params) {
|
|
@@ -7524,6 +7571,32 @@ var MastraClient = class extends BaseResource {
|
|
|
7524
7571
|
return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments/${encodeURIComponent(experimentId)}`);
|
|
7525
7572
|
}
|
|
7526
7573
|
/**
|
|
7574
|
+
* Deletes a dataset experiment and its results. Tenancy fields, when provided,
|
|
7575
|
+
* scope the dataset lookup on the server side.
|
|
7576
|
+
*
|
|
7577
|
+
* The server also attempts to delete the experiment's observability traces,
|
|
7578
|
+
* cascading to their spans and trace-linked signals. Stores without
|
|
7579
|
+
* observability or trace deletion support leave the traces in place.
|
|
7580
|
+
*/
|
|
7581
|
+
deleteDatasetExperiment(datasetId, experimentId, tenancy) {
|
|
7582
|
+
const qs = buildTenancyQuery(tenancy);
|
|
7583
|
+
return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments/${encodeURIComponent(experimentId)}${qs}`, { method: "DELETE" });
|
|
7584
|
+
}
|
|
7585
|
+
/**
|
|
7586
|
+
* Deletes an experiment and its results regardless of dataset association
|
|
7587
|
+
* (including experiments orphaned by dataset deletion). When tenancy fields
|
|
7588
|
+
* are supplied, the server only deletes the experiment if it belongs to the
|
|
7589
|
+
* given tenant (silent no-op otherwise).
|
|
7590
|
+
*
|
|
7591
|
+
* The server also attempts to delete the experiment's observability traces,
|
|
7592
|
+
* cascading to their spans and trace-linked signals. Stores without
|
|
7593
|
+
* observability or trace deletion support leave the traces in place.
|
|
7594
|
+
*/
|
|
7595
|
+
deleteExperiment(experimentId, options) {
|
|
7596
|
+
const qs = buildTenancyQuery(options);
|
|
7597
|
+
return this.request(`/experiments/${encodeURIComponent(experimentId)}${qs}`, { method: "DELETE" });
|
|
7598
|
+
}
|
|
7599
|
+
/**
|
|
7527
7600
|
* Updates a dataset experiment's name, description or metadata
|
|
7528
7601
|
*/
|
|
7529
7602
|
updateDatasetExperiment(params) {
|