@mastra/client-js 1.47.0-alpha.9 → 1.47.0

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { agentControllerMessageText, isKnownAgentControllerEvent } from './resou
 export type { MastraDBMessage, MastraMessageContentV2, MastraMessagePart, AgentControllerEvent, KnownAgentControllerEvent, OtherAgentControllerEvent, AgentControllerRequestOptions, SubscribeAgentControllerSessionOptions, AgentControllerSubscription, PlanResume, } from './resources/agent-controller.js';
 export { RequestContext } from '@mastra/core/request-context';
 export type { ObservabilityCollector } from './observability/types.js';
-export type { QueryTraceThreadsInput, QueryTraceThreadsResult, QueryTracesInput } from './resources/observability.js';
+export type { QueryTraceThreadsInput, QueryTraceThreadsResult, QueryTracesInput, QueryTracesDeltaInput, QueryTracesKeysetInput, QueryTracesPaginatedInput, } from './resources/observability.js';
 export type { UIMessageWithMetadata } from '@mastra/core/agent';
 export type { GetMetricTimeSeriesResponse } from './types.js';
 export type { GetTraceQueryFieldsArgs, GetTraceQueryFieldsResponse, GetTraceQueryValuesArgs, GetTraceQueryValuesResponse, TraceQueryCanonicalFieldDescriptor, TraceQueryObservedFieldDescriptor, TraceQueryOperator, TraceQueryPredicateScope, TraceQueryValueKind, } from './resources/observability-route-types.js';

package/dist/index.d.ts.map

@@ -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,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,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACnH,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,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"}
+{"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,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,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,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,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,iCAAiC,EACjC,kBAAkB,EAClB,wBAAwB,EACxB,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"}

package/dist/index.js

@@ -2779,6 +2779,22 @@ var Agent = class extends BaseResource {
 //#endregion
 //#region src/resources/memory-thread.ts
 /**
+* Serializes the message-listing filters both memory message routes accept. The network route
+* takes the same filters under a different path, so the two callers share one serializer.
+*/
+const memoryMessagesQuery = ({ agentId, resourceId, page, perPage, orderBy, filter, include, includeSystemReminders }) => {
+	const query = new URLSearchParams();
+	if (agentId) query.set("agentId", agentId);
+	if (resourceId) query.set("resourceId", resourceId);
+	if (page !== void 0) query.set("page", String(page));
+	if (perPage !== void 0) query.set("perPage", String(perPage));
+	if (orderBy) query.set("orderBy", JSON.stringify(orderBy));
+	if (filter) query.set("filter", JSON.stringify(filter));
+	if (include) query.set("include", JSON.stringify(include));
+	if (includeSystemReminders !== void 0) query.set("includeSystemReminders", String(includeSystemReminders));
+	return query;
+};
+/**
 * MemoryThread resource for interacting with memory threads.
 *
 * `agentId` is optional for read operations (`get`, `listMessages`) — when omitted the server
@@ -2854,18 +2870,11 @@ var MemoryThread = class extends BaseResource {
 	* @returns Promise containing paginated thread messages with pagination metadata (total, page, perPage, hasMore)
 	*/
 	listMessages(params = {}) {
-		const { page, perPage, orderBy, filter, include, resourceId, requestContext, includeSystemReminders } = params;
-		const queryParams = {};
-		if (this.agentId) queryParams.agentId = this.agentId;
-		if (resourceId) queryParams.resourceId = resourceId;
-		if (page !== void 0) queryParams.page = String(page);
-		if (perPage !== void 0) queryParams.perPage = String(perPage);
-		if (orderBy) queryParams.orderBy = JSON.stringify(orderBy);
-		if (filter) queryParams.filter = JSON.stringify(filter);
-		if (include) queryParams.include = JSON.stringify(include);
-		if (includeSystemReminders !== void 0) queryParams.includeSystemReminders = String(includeSystemReminders);
-		const queryString = new URLSearchParams(queryParams).toString();
-		const url = `/memory/threads/${this.threadId}/messages${queryString ? `?${queryString}` : ""}${requestContextQueryString(requestContext, queryString ? "&" : "?")}`;
+		const query = memoryMessagesQuery({
+			...params,
+			agentId: params.agentId ?? this.agentId
+		}).toString();
+		const url = `/memory/threads/${this.threadId}/messages${query ? `?${query}` : ""}${requestContextQueryString(params.requestContext, query ? "&" : "?")}`;
 		return this.request(url);
 	}
 	/**
@@ -4484,12 +4493,6 @@ 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
-	*/
 	queryTraces(params) {
 		return this.request("/observability/traces/query", {
 			method: "POST",
@@ -6662,12 +6665,15 @@ var MastraClient = class extends BaseResource {
 	* @returns Promise containing the thread messages
 	*/
 	listThreadMessages(threadId, opts = {}) {
-		let url = "";
-		const includeSystemRemindersQuery = opts.includeSystemReminders === void 0 ? "" : `includeSystemReminders=${opts.includeSystemReminders}`;
-		if (opts.networkId) url = `/memory/network/threads/${threadId}/messages?networkId=${opts.networkId}${includeSystemRemindersQuery ? `&${includeSystemRemindersQuery}` : ""}${requestContextQueryString(opts.requestContext, includeSystemRemindersQuery ? "&" : "&")}`;
-		else if (opts.agentId) url = `/memory/threads/${threadId}/messages?agentId=${opts.agentId}${includeSystemRemindersQuery ? `&${includeSystemRemindersQuery}` : ""}${requestContextQueryString(opts.requestContext, "&")}`;
-		else url = `/memory/threads/${threadId}/messages${includeSystemRemindersQuery ? `?${includeSystemRemindersQuery}` : ""}${requestContextQueryString(opts.requestContext, includeSystemRemindersQuery ? "&" : "?")}`;
-		return this.request(url);
+		if (opts.networkId) {
+			const query = memoryMessagesQuery(opts);
+			query.set("networkId", opts.networkId);
+			return this.request(`/memory/network/threads/${threadId}/messages?${query.toString()}${requestContextQueryString(opts.requestContext, "&")}`);
+		}
+		return this.getMemoryThread({
+			threadId,
+			agentId: opts.agentId
+		}).listMessages(opts);
 	}
 	deleteThread(threadId, opts) {
 		if (!opts || !!opts.agentId === !!opts.networkId) throw new Error("MastraClient.deleteThread() requires exactly one of agentId or networkId. The server cannot resolve which memory store owns the thread without one, and passing both is ambiguous.");
@@ -7088,7 +7094,6 @@ 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);
 	}
@@ -7676,6 +7681,10 @@ var MastraClient = class extends BaseResource {
 		if (params?.perPage !== void 0) searchParams.set("perPage", String(params.perPage));
 		if (params?.targetType !== void 0) searchParams.set("targetType", params.targetType);
 		for (const id of params?.targetIds ?? []) searchParams.append("targetIds", id);
+		if (params?.orderBy) {
+			searchParams.set("orderBy[field]", params.orderBy.field);
+			searchParams.set("orderBy[direction]", params.orderBy.direction);
+		}
 		const qs = searchParams.toString();
 		return this.request(`/datasets${qs ? `?${qs}` : ""}`);
 	}
@@ -7731,6 +7740,10 @@ var MastraClient = class extends BaseResource {
 		if (params?.perPage !== void 0) searchParams.set("perPage", String(params.perPage));
 		if (params?.search) searchParams.set("search", params.search);
 		if (params?.version != null) searchParams.set("version", String(params.version));
+		if (params?.orderBy) {
+			searchParams.set("orderBy[field]", params.orderBy.field);
+			searchParams.set("orderBy[direction]", params.orderBy.direction);
+		}
 		const qs = searchParams.toString();
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/items${qs ? `?${qs}` : ""}`);
 	}
@@ -7847,6 +7860,10 @@ var MastraClient = class extends BaseResource {
 		if (params?.trialIndex !== void 0) searchParams.set("trialIndex", String(params.trialIndex));
 		if (params?.targetType !== void 0) searchParams.set("targetType", params.targetType);
 		if (params?.targetId !== void 0) searchParams.set("targetId", params.targetId);
+		if (params?.orderBy) {
+			searchParams.set("orderBy[field]", params.orderBy.field);
+			searchParams.set("orderBy[direction]", params.orderBy.direction);
+		}
 		const qs = searchParams.toString();
 		return this.request(`/experiments${qs ? `?${qs}` : ""}`);
 	}
@@ -7869,6 +7886,10 @@ var MastraClient = class extends BaseResource {
 		if (params?.trialIndex !== void 0) searchParams.set("trialIndex", String(params.trialIndex));
 		if (params?.targetType !== void 0) searchParams.set("targetType", params.targetType);
 		if (params?.targetId !== void 0) searchParams.set("targetId", params.targetId);
+		if (params?.orderBy) {
+			searchParams.set("orderBy[field]", params.orderBy.field);
+			searchParams.set("orderBy[direction]", params.orderBy.direction);
+		}
 		const qs = searchParams.toString();
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments${qs ? `?${qs}` : ""}`);
 	}
@@ -7923,6 +7944,10 @@ var MastraClient = class extends BaseResource {
 		if (options?.page !== void 0) searchParams.set("page", String(options.page));
 		if (options?.perPage !== void 0) searchParams.set("perPage", String(options.perPage));
 		for (const tag of options?.tags ?? []) searchParams.append("tags", tag);
+		if (options?.orderBy) {
+			searchParams.set("orderBy[field]", options.orderBy.field);
+			searchParams.set("orderBy[direction]", options.orderBy.direction);
+		}
 		const qs = searchParams.toString();
 		return this.request(`/datasets/${encodeURIComponent(datasetId)}/experiments/${encodeURIComponent(experimentId)}/results${qs ? `?${qs}` : ""}`);
 	}