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

package/dist/index.cjs

@@ -4328,6 +4328,18 @@ var Observability = class extends BaseResource {
 		return this.request(`/observability/traces${queryString ? `?${queryString}` : ""}`);
 	}
 	/**
+	* Queries completed logical traces using recursive trace and related-record predicates.
+	*
+	* @param params - Advanced trace query, including its required time range
+	* @returns Matching lightweight traces or distinct thread groups
+	*/
+	queryTraces(params) {
+		return this.request("/observability/traces/query", {
+			method: "POST",
+			body: params
+		});
+	}
+	/**
 	* Retrieves paginated list of traces carrying only the fields a trace list renders.
 	*
 	* Same filtering, ordering and delta-polling contract as {@link listTraces}, but rows
@@ -4400,6 +4412,21 @@ var Observability = class extends BaseResource {
 		});
 	}
 	/**
+	* Deletes traces by ID, cascading to all associated data: spans, trace
+	* roots/branches, and signal events (scores, feedback, metrics, logs) that
+	* reference the deleted traces. Signals without a trace ID are untouched.
+	* On ClickHouse-backed stores, reads may briefly return deleted rows until
+	* the lightweight delete is fully applied.
+	* @param params - IDs of the traces to delete
+	* @returns Promise resolving to `{ success: true }` once the delete is issued
+	*/
+	deleteTraces(params) {
+		return this.request(`/observability/traces/delete`, {
+			method: "POST",
+			body: { traceIds: params.traceIds }
+		});
+	}
+	/**
 	* Retrieves a paginated list of logs with optional filtering and sorting.
 	*/
 	listLogs(params = {}) {
@@ -6809,6 +6836,10 @@ var MastraClient = class extends BaseResource {
 	listTraces(params = {}) {
 		return this.observability.listTraces(params);
 	}
+	/** Queries completed logical traces using recursive trace and related-record predicates. */
+	queryTraces(params) {
+		return this.observability.queryTraces(params);
+	}
 	/**
 	* Retrieves paginated list of traces carrying only the fields a trace list renders.
 	* Same contract as {@link listTraces}, but rows omit the `attributes`/`input`/`output`
@@ -6839,6 +6870,15 @@ var MastraClient = class extends BaseResource {
 	listScoresBySpan(params) {
 		return this.observability.listScoresBySpan(params);
 	}
+	/**
+	* Deletes traces by ID, cascading to all associated spans and trace-linked
+	* signal events (scores, feedback, metrics, logs). Signals without a trace ID
+	* are untouched. On ClickHouse-backed stores, reads may briefly return
+	* deleted rows until the delete is fully applied.
+	*/
+	deleteTraces(params) {
+		return this.observability.deleteTraces(params);
+	}
 	/** Scores one or more traces using a specified scorer (fire-and-forget). */
 	score(params) {
 		return this.observability.score(params);
@@ -7447,6 +7487,13 @@ var MastraClient = class extends BaseResource {
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/items/${encodeURIComponent(itemId)}`, { method: "DELETE" });
 	}
 	/**
+	* Permanently scrubs a dataset item's data from all versions and linked experiment results
+	*/
+	purgeDatasetItem(datasetId, itemId, tenancy) {
+		const qs = buildTenancyQuery(tenancy);
+		return this.request(`/datasets/${encodeURIComponent(datasetId)}/items/${encodeURIComponent(itemId)}/purge${qs}`, { method: "DELETE" });
+	}
+	/**
 	* Batch inserts items to a dataset
 	*/
 	batchInsertDatasetItems(params) {
@@ -7548,6 +7595,32 @@ var MastraClient = class extends BaseResource {
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments/${encodeURIComponent(experimentId)}`);
 	}
 	/**
+	* Deletes a dataset experiment and its results. Tenancy fields, when provided,
+	* scope the dataset lookup on the server side.
+	*
+	* The server also attempts to delete the experiment's observability traces,
+	* cascading to their spans and trace-linked signals. Stores without
+	* observability or trace deletion support leave the traces in place.
+	*/
+	deleteDatasetExperiment(datasetId, experimentId, tenancy) {
+		const qs = buildTenancyQuery(tenancy);
+		return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments/${encodeURIComponent(experimentId)}${qs}`, { method: "DELETE" });
+	}
+	/**
+	* Deletes an experiment and its results regardless of dataset association
+	* (including experiments orphaned by dataset deletion). When tenancy fields
+	* are supplied, the server only deletes the experiment if it belongs to the
+	* given tenant (silent no-op otherwise).
+	*
+	* The server also attempts to delete the experiment's observability traces,
+	* cascading to their spans and trace-linked signals. Stores without
+	* observability or trace deletion support leave the traces in place.
+	*/
+	deleteExperiment(experimentId, options) {
+		const qs = buildTenancyQuery(options);
+		return this.request(`/experiments/${encodeURIComponent(experimentId)}${qs}`, { method: "DELETE" });
+	}
+	/**
 	* Updates a dataset experiment's name, description or metadata
 	*/
 	updateDatasetExperiment(params) {