@mastra/server 1.60.0-alpha.1 → 1.60.0-alpha.11

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

@@ -20,11 +20,22 @@ import { z } from "zod/v4";
 * usage). They share the flat thread `metadata` bag with user-provided session
 * scoping tags, so they must never be treated as tags here.
 *
-* Mirrors core's `isReservedThreadMetadataKey`; kept local because importing the
-* value from `@mastra/core` would exceed this package's peer-dependency floor.
+* Importing core's list as a value would exceed this package's peer-dependency
+* floor, so it is mirrored under `satisfies`: tsc rejects a missing or extra key.
 */
+const RESERVED_THREAD_METADATA_KEYS = {
+	currentModelId: true,
+	currentModeId: true,
+	observerModelId: true,
+	reflectorModelId: true,
+	observationThreshold: true,
+	reflectionThreshold: true,
+	tokenUsage: true,
+	thinkingLevel: true,
+	notifications: true
+};
 function isReservedThreadMetadataKey(key) {
-	return key === "currentModelId" || key === "currentModeId" || key === "observerModelId" || key === "reflectorModelId" || key === "observationThreshold" || key === "reflectionThreshold" || key === "tokenUsage" || key.startsWith("modeModelId_");
+	return Object.hasOwn(RESERVED_THREAD_METADATA_KEYS, key) || key.startsWith("modeModelId_");
 }
 /**
 * Resolves a controller by id via the canonical `mastra.getAgentController`
@@ -93,6 +104,7 @@ const sessionPathParams = z.object({
 * on session routes; named to avoid colliding with the model-switch `scope`.
 */
 const sessionScopeQuerySchema = z.object({ sessionScope: z.string().optional() });
+const sessionStateQuerySchema = sessionScopeQuerySchema.extend({ threadId: z.string().optional() });
 const createSessionBodySchema = z.object({
 	resourceId: z.string(),
 	tags: z.record(z.string(), z.string()).optional(),
@@ -218,6 +230,17 @@ const omProgressSummarySchema = z.object({
 	/** Tokens the next reflection is projected to save. */
 	projectedReflectionSavings: z.number()
 });
+const tokenUsageSchema = z.object({
+	promptTokens: z.number(),
+	completionTokens: z.number(),
+	totalTokens: z.number(),
+	reasoningTokens: z.number().optional(),
+	cachedInputTokens: z.number().optional(),
+	cacheCreationInputTokens: z.number().optional(),
+	cacheCreationInputTokens5m: z.number().optional(),
+	cacheCreationInputTokens1h: z.number().optional(),
+	raw: z.unknown().optional()
+});
 const sessionSettingsSchema = z.object({
 	yolo: z.boolean(),
 	/** Session override only — absent when the session inherits a configured default. */
@@ -237,6 +260,16 @@ const sessionSettingsSchema = z.object({
 	]),
 	smartEditing: z.boolean()
 });
+const taskSnapshotSchema = z.object({
+	id: z.string(),
+	content: z.string(),
+	status: z.enum([
+		"pending",
+		"in_progress",
+		"completed"
+	]),
+	activeForm: z.string()
+});
 const sessionStateResponseSchema = z.object({
 	controllerId: z.string(),
 	resourceId: z.string(),
@@ -245,8 +278,9 @@ const sessionStateResponseSchema = z.object({
 	modelId: z.string(),
 	/** Whether the agent is currently executing a run (for initial UI hydration). */
 	running: z.boolean().optional(),
+	tasks: z.array(taskSnapshotSchema).optional(),
 	omProgress: omProgressSummarySchema.optional(),
-	tokenUsage: z.record(z.string(), z.unknown()).optional(),
+	tokenUsage: tokenUsageSchema.optional(),
 	settings: sessionSettingsSchema.optional()
 });
 const listModesResponseSchema = z.object({ modes: z.array(z.object({
@@ -374,31 +408,24 @@ const CREATE_AGENT_CONTROLLER_SESSION_ROUTE = createRoute({
 	}
 });
 /**
-* Session `error` events carry an `Error` instance whose `message`/`name` are
-* non-enumerable, so JSON serialization in the SSE adapter would send
-* `"error": {}` and clients could only render a generic "Error". Flatten the
-* Error into a plain object so the actual failure reaches the client.
+* An `Error`'s `message`/`name` are non-enumerable, so JSON serialization in the
+* SSE adapter would send `"error": {}` and clients could only render a generic
+* "Error". Flatten it so the actual failure reaches the client, on every event
+* that carries one (`error`, `workspace_error`, `workspace_status_changed`).
 *
 * `display_state_changed` Maps JSON-serialize to `{}`; convert them to plain
 * records so wire clients get the tool state the in-process TUI sees.
 */
 function toWireEvent(event) {
-	if (typeof event !== "object" || event === null) return event;
-	const { type } = event;
-	if (type === "error" && event.error instanceof Error) {
-		const error = event.error;
-		return {
-			...event,
-			error: {
-				name: error.name,
-				message: error.message
-			}
-		};
-	}
-	if (type === "display_state_changed") {
-		const { displayState } = event;
-		if (typeof displayState !== "object" || displayState === null) return event;
-		const wireDisplayState = { ...displayState };
+	if ("error" in event && event.error instanceof Error) return {
+		...event,
+		error: {
+			name: event.error.name,
+			message: event.error.message
+		}
+	};
+	if (event.type === "display_state_changed") {
+		const wireDisplayState = { ...event.displayState };
 		for (const [key, value] of Object.entries(wireDisplayState)) if (value instanceof Map) wireDisplayState[key] = Object.fromEntries(value);
 		return {
 			...event,
@@ -692,17 +719,32 @@ const GET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = createRoute({
 	path: "/agent-controller/:controllerId/sessions/:resourceId",
 	responseType: "json",
 	pathParamSchema: sessionPathParams,
-	queryParamSchema: sessionScopeQuerySchema,
+	queryParamSchema: sessionStateQuerySchema,
 	responseSchema: sessionStateResponseSchema,
 	summary: "Get session state",
-	description: "Returns the current mode, model, and thread for the session (for initial UI hydration).",
+	description: "Returns the current mode, model, thread, and durable tasks for initial UI hydration.",
 	tags: ["AgentController"],
 	requiresAuth: true,
 	requiresPermission: "agent-controller:read",
-	handler: async ({ mastra, controllerId, resourceId, sessionScope, requestContext }) => {
+	handler: async ({ mastra, controllerId, resourceId, sessionScope, threadId: requestedThreadId, requestContext }) => {
 		try {
 			const session = await getSession(getAgentControllerOrThrow(mastra, controllerId), resourceId, { scope: sessionScope }, requestContext);
 			const ds = session.displayState.get();
+			const threadId = requestedThreadId ?? session.thread.getId() ?? void 0;
+			const storage = mastra.getStorage();
+			if (requestedThreadId) {
+				if (!await (await storage?.getStore("memory"))?.getThreadById({
+					threadId: requestedThreadId,
+					resourceId
+				})) throw new HTTPException(404, { message: `thread "${requestedThreadId}" not found` });
+			}
+			const threadState = threadId ? await storage?.getStore("threadState") : void 0;
+			const storedTasks = threadId ? await threadState?.getState({
+				threadId,
+				type: "task"
+			}) : void 0;
+			const parsedTasks = taskSnapshotSchema.array().safeParse(storedTasks);
+			const tasks = parsedTasks.success ? parsedTasks.data : [];
 			const om = ds.omProgress;
 			const reflectionSavings = om.buffered.reflection.inputObservationTokens - om.buffered.reflection.observationTokens;
 			const st = session.state.get();
@@ -711,10 +753,11 @@ const GET_AGENT_CONTROLLER_SESSION_STATE_ROUTE = createRoute({
 			return {
 				controllerId,
 				resourceId,
-				threadId: session.thread.getId() ?? void 0,
+				threadId,
 				modeId: session.mode.get(),
 				modelId: session.model.get(),
 				running: ds.isRunning === true,
+				tasks,
 				omProgress: {
 					status: om.status,
 					pendingTokens: om.pendingTokens,