@mastra/server 1.63.3-alpha.0 → 1.64.0-alpha.2

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-server
 description: Documentation for @mastra/server. Use when working with @mastra/server APIs, configuration, or implementation.
 metadata:
   package: "@mastra/server"
-  version: "1.63.3-alpha.0"
+  version: "1.64.0-alpha.2"
 ---
 
 ## When to use
@@ -16,16 +16,16 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Docs
 
-- [A2A (Agent-to-Agent)](references/docs-connections-a2a.md) - Expose and call remote Mastra agents over the Agent-to-Agent protocol.
-- [Custom adapters](references/docs-server-custom-adapters.md) - Create a custom server adapter for frameworks other than Hono or Express.
-- [Custom API routes](references/docs-server-custom-api-routes.md) - Expose additional HTTP endpoints from your Mastra server.
-- [Middleware](references/docs-server-middleware.md) - Apply custom middleware functions to intercept requests.
+- [A2A (Agent-to-Agent)](references/docs-connections-a2a.md) - Expose Mastra agents through the Agent-to-Agent protocol and consume remote A2A agents as subagents or call them directly with the client SDK.
+- [Custom adapters](references/docs-server-custom-adapters.md) - Implement a custom Mastra server adapter for unsupported web frameworks by mapping routes, middleware, request parameters, responses, and streams.
+- [Custom API routes](references/docs-server-custom-api-routes.md) - Add custom HTTP endpoints to a Mastra server with schema validation, middleware, authentication, OpenAPI documentation, and control over disconnect behavior.
+- [Middleware](references/docs-server-middleware.md) - Add Mastra server middleware for authentication, authorization, CORS, request logging, route blocking, and request-specific context injection.
 
 ### Reference
 
-- [Reference: createRoute()](references/reference-server-create-route.md) - API reference for createRoute() function used to define type-safe routes with validation and OpenAPI generation.
-- [Reference: MastraServer](references/reference-server-mastra-server.md) - API reference for the MastraServer abstract class used to create server adapters.
-- [Reference: Server routes](references/reference-server-routes.md) - API reference for HTTP routes registered by Mastra server adapters.
+- [Reference: createRoute()](references/reference-server-create-route.md) - Use createRoute() to define type-safe Mastra server routes with Zod validation for requests and responses, plus handler context and OpenAPI metadata.
+- [Reference: MastraServer](references/reference-server-mastra-server.md) - The MastraServer abstract class is the base for all server adapters. Extend this class to create adapters for frameworks other than Hono or Express.
+- [Reference: Server routes](references/reference-server-routes.md) - Server adapters register these routes when you call server.init(). All routes are prefixed with the prefix option if configured.
 
 
 Read [assets/SOURCE_MAP.json](assets/SOURCE_MAP.json) for source code references.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.63.3-alpha.0",
+  "version": "1.64.0-alpha.2",
   "package": "@mastra/server",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-server-create-route.md

@@ -80,7 +80,7 @@ Returns a `ServerRoute` object that can be registered with an adapter or passed
 
 ### Register through `server.apiRoutes`
 
-Routes created with `createRoute()` can be passed to `server.apiRoutes`. The adapter registers them with runtime validation, typed handler parameters, and generated OpenAPI metadata. See [Custom API routes](https://mastra.ai/docs/server/custom-api-routes) for details.
+Routes created with `createRoute()` can be passed to `server.apiRoutes`, where the adapter adds runtime validation and typed handler parameters while generating OpenAPI metadata. See [Custom API routes](https://mastra.ai/docs/server/custom-api-routes) for details.
 
 ```typescript
 import { Mastra } from '@mastra/core'

package/dist/server/handlers/agent-builder.cjs

@@ -30,7 +30,7 @@ var agent_builder_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll
 });
 let agentBuilderWorkflowsPromise;
 async function loadAgentBuilderWorkflows() {
-	agentBuilderWorkflowsPromise ??= Promise.resolve().then(() => require("../../dist-fQ5zEP_z.cjs")).then((mod) => mod.agentBuilderWorkflows);
+	agentBuilderWorkflowsPromise ??= Promise.resolve().then(() => require("../../dist-BuyLBfu3.cjs")).then((mod) => mod.agentBuilderWorkflows);
 	return agentBuilderWorkflowsPromise;
 }
 async function registerAgentBuilderWorkflows(mastra) {

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

@@ -29,7 +29,7 @@ var agent_builder_exports = /* @__PURE__ */ __exportAll({
 });
 let agentBuilderWorkflowsPromise;
 async function loadAgentBuilderWorkflows() {
-	agentBuilderWorkflowsPromise ??= import("../../dist-DmVdNrSg.js").then((mod) => mod.agentBuilderWorkflows);
+	agentBuilderWorkflowsPromise ??= import("../../dist-JaHKn7NU.js").then((mod) => mod.agentBuilderWorkflows);
 	return agentBuilderWorkflowsPromise;
 }
 async function registerAgentBuilderWorkflows(mastra) {

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

@@ -614,10 +614,16 @@ const AGENT_CONTROLLER_TOOL_SUSPENSION_ROUTE = require_route_builder.createRoute
 	requiresPermission: "agent-controller:execute",
 	handler: async ({ mastra, controllerId, resourceId, sessionScope, toolCallId, resumeData, requestContext }) => {
 		try {
-			await (await getSession(getAgentControllerOrThrow(mastra, controllerId), resourceId, { scope: sessionScope }, requestContext)).respondToToolSuspension({
-				toolCallId,
-				resumeData,
-				requestContext
+			const session = await getSession(getAgentControllerOrThrow(mastra, controllerId), resourceId, { scope: sessionScope }, requestContext);
+			ackBackgroundSessionWork({
+				work: session.respondToToolSuspension({
+					toolCallId,
+					resumeData,
+					requestContext
+				}),
+				session,
+				mastra,
+				operation: "respondToToolSuspension"
 			});
 			return { ok: true };
 		} catch (error) {