@mastra/server 1.66.0-alpha.3 → 1.66.0

package/dist/server/handlers/agent-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-controller.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/agent-controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-controller.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/agent-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/handlers/agent-controller.js

@@ -1,6 +1,8 @@
 import { t as HTTPException } from "../../http-exception-CyfxZB6W.js";
 import { n as createRoute } from "../../route-builder-BveLN9LU.js";
 import { handleError } from "./error.js";
+import { t as enforceThreadAccess } from "../../utils-Hz8Hc2cd.js";
+import { E as includeSchema, F as messageOrderBySchema, h as filterSchema } from "../../memory-CjWJYFVI.js";
 import { z } from "zod/v4";
 //#region src/server/handlers/agent-controller.ts
 /**
@@ -161,9 +163,28 @@ const cloneThreadBodySchema = z.object({
 	sourceThreadId: z.string().optional(),
 	title: z.string().optional()
 });
+const controllerPaginationNumber = z.coerce.number().int().min(0);
 const listMessagesQuerySchema = z.object({
-	limit: z.coerce.number().optional(),
+	/** @deprecated Use page and perPage instead. */
+	limit: controllerPaginationNumber.optional(),
+	page: controllerPaginationNumber.optional(),
+	perPage: z.preprocess((value) => value === "false" ? false : value, z.union([z.literal(false), controllerPaginationNumber])).optional(),
+	orderBy: messageOrderBySchema,
+	include: includeSchema,
+	filter: filterSchema,
 	sessionScope: z.string().optional()
+}).superRefine((value, ctx) => {
+	if (value.limit === void 0) return;
+	for (const field of [
+		"perPage",
+		"orderBy",
+		"include",
+		"filter"
+	]) if (value[field] !== void 0) ctx.addIssue({
+		code: "custom",
+		message: `limit cannot be combined with ${field}; use perPage instead`,
+		path: ["limit"]
+	});
 });
 /**
 * `tags` arrives as a JSON-encoded object in the query string (query params are
@@ -308,21 +329,27 @@ const messageContentV2Schema = z.object({
 	format: z.literal(2),
 	parts: z.array(messagePartSchema)
 }).passthrough();
-const listMessagesResponseSchema = z.object({ messages: z.array(z.object({
-	id: z.string(),
-	role: z.enum([
-		"user",
-		"assistant",
-		"system",
-		"tool",
-		"signal"
-	]),
-	content: messageContentV2Schema,
-	createdAt: z.string().optional(),
-	threadId: z.string().optional(),
-	resourceId: z.string().optional(),
-	type: z.string().optional()
-})) });
+const listMessagesResponseSchema = z.object({
+	messages: z.array(z.object({
+		id: z.string(),
+		role: z.enum([
+			"user",
+			"assistant",
+			"system",
+			"tool",
+			"signal"
+		]),
+		content: messageContentV2Schema,
+		createdAt: z.string().optional(),
+		threadId: z.string().optional(),
+		resourceId: z.string().optional(),
+		type: z.string().optional()
+	})),
+	total: z.number(),
+	page: z.number(),
+	perPage: z.union([z.number(), z.literal(false)]),
+	hasMore: z.boolean()
+});
 const listModelsResponseSchema = z.object({ models: z.array(z.object({
 	id: z.string(),
 	provider: z.string(),
@@ -429,7 +456,7 @@ function carriesError(event) {
 * An `Error`'s `message`/`name` are non-enumerable, so flatten it before JSON
 * serialization. Streamed message events intentionally retain the controller's
 * live accumulated message; consumers requiring temporal isolation must copy or
-* serialize at their own ownership boundary.
+* serialize the value there.
 */
 function toWireEvent(event) {
 	if ("displayState" in event) return {
@@ -1058,27 +1085,55 @@ const LIST_AGENT_CONTROLLER_THREAD_MESSAGES_ROUTE = createRoute({
 	queryParamSchema: listMessagesQuerySchema,
 	responseSchema: listMessagesResponseSchema,
 	summary: "List thread messages",
-	description: "Lists messages for a specific thread. Returns most recent messages first.",
+	description: "Returns a paginated list of messages in a specific thread. The deprecated limit parameter may only be combined with page.",
 	tags: ["AgentController", "Threads"],
 	requiresAuth: true,
 	requiresPermission: "agent-controller:read",
-	handler: async ({ mastra, controllerId, resourceId, threadId, limit }) => {
+	handler: async ({ mastra, controllerId, resourceId, threadId, limit, page, perPage, orderBy, include, filter, requestContext }) => {
 		try {
+			if (limit !== void 0 && (perPage !== void 0 || orderBy !== void 0 || include !== void 0 || filter !== void 0)) throw new HTTPException(400, { message: "limit can only be combined with page; use perPage instead" });
 			const controller = getAgentControllerOrThrow(mastra, controllerId);
 			const thread = await controller.queryThreadById({ threadId });
-			if (!thread || thread.resourceId !== resourceId) throw new Error(`Thread not found: ${threadId}`);
-			return { messages: (await controller.queryThreadMessages({
+			if (!thread || resourceId && thread.resourceId && thread.resourceId !== resourceId) throw new HTTPException(404, { message: "Thread not found" });
+			await enforceThreadAccess({
+				mastra,
+				requestContext,
 				threadId,
-				limit
-			})).map((m) => ({
-				id: m.id,
-				role: m.role,
-				content: m.content,
-				createdAt: m.createdAt instanceof Date ? m.createdAt.toISOString() : void 0,
-				threadId: m.threadId,
-				resourceId: m.resourceId,
-				type: m.type
-			})) };
+				thread,
+				effectiveResourceId: resourceId
+			});
+			const isLegacyLimitQuery = limit !== void 0;
+			const result = await controller.queryThreadMessages(limit !== void 0 ? {
+				threadId,
+				resourceId,
+				perPage: limit,
+				page: page ?? 0,
+				orderBy: {
+					field: "createdAt",
+					direction: "DESC"
+				}
+			} : {
+				threadId,
+				resourceId,
+				...perPage !== void 0 ? { perPage } : {},
+				...page !== void 0 ? { page } : {},
+				...orderBy !== void 0 ? { orderBy } : {},
+				...include !== void 0 ? { include } : {},
+				...filter !== void 0 ? { filter } : {}
+			});
+			const messages = isLegacyLimitQuery ? result.messages.reverse() : result.messages;
+			return {
+				...result,
+				messages: messages.map((m) => ({
+					id: m.id,
+					role: m.role,
+					content: m.content,
+					createdAt: m.createdAt instanceof Date ? m.createdAt.toISOString() : void 0,
+					threadId: m.threadId,
+					resourceId: m.resourceId,
+					type: m.type
+				}))
+			};
 		} catch (error) {
 			return handleError(error, "error listing controller thread messages");
 		}