@mastra/server 1.62.0-alpha.10 → 1.62.0-alpha.12

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.62.0-alpha.10"
+  version: "1.62.0-alpha.12"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.62.0-alpha.10",
+  "version": "1.62.0-alpha.12",
   "package": "@mastra/server",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-server-middleware.md

@@ -58,6 +58,32 @@ registerApiRoute('/my-custom-route', {
 
 ## Common examples
 
+### Block built-in route groups
+
+Mastra doesn't provide a configuration option to remove or allowlist built-in routes. On Hono-based serving paths, you can make selected route groups unavailable by returning a response without calling `next()`:
+
+```typescript
+import { Mastra } from '@mastra/core'
+
+const notFound = async () => new Response('Not Found', { status: 404 })
+
+export const mastra = new Mastra({
+  server: {
+    middleware: [
+      { path: '/api/memory/*', handler: notFound },
+      { path: '/api/logs/*', handler: notFound },
+      { path: '/api/observability/*', handler: notFound },
+    ],
+  },
+})
+```
+
+Each wildcard pattern blocks both the route group itself and its nested routes. For example, `/api/logs/*` blocks `/api/logs` and `/api/logs/transports`. Other route groups remain available.
+
+Generated servers pass `server.apiPrefix` to the Hono adapter's [`prefix` constructor option](https://mastra.ai/reference/server/hono-adapter), which prefixes built-in routes. Middleware paths are registered unchanged, so they must explicitly include the configured prefix. For example, with `apiPrefix: '/api/v2'`, use `/api/v2/memory/*`. Custom API routes must live outside the configured API prefix and aren't blocked by these patterns.
+
+This approach can't block routes declared public with `requiresAuth: false`, because Mastra skips user middleware for those routes. With a non-Hono server adapter, register equivalent middleware through the server framework instead.
+
 ### Using `RequestContext`
 
 You can populate `RequestContext` in a runtime server middleware by extracting information from the request. In this example, the `temperature-unit` is set based on the Cloudflare `CF-IPCountry` header to ensure responses match the user's locale.

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-Czh_Btxb.cjs")).then((mod) => mod.agentBuilderWorkflows);
+	agentBuilderWorkflowsPromise ??= Promise.resolve().then(() => require("../../dist-Xj9TvH1A.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-DkFSqWZ7.js").then((mod) => mod.agentBuilderWorkflows);
+	agentBuilderWorkflowsPromise ??= import("../../dist-L0EogwX_.js").then((mod) => mod.agentBuilderWorkflows);
 	return agentBuilderWorkflowsPromise;
 }
 async function registerAgentBuilderWorkflows(mastra) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/server",
-  "version": "1.62.0-alpha.10",
+  "version": "1.62.0-alpha.12",
   "description": "",
   "type": "module",
   "files": [
@@ -117,13 +117,13 @@
     "zod": "^4.4.3",
     "zod-to-ts": "^2.1.0",
     "@internal/lint": "0.0.125",
-    "@internal/core": "0.1.2",
     "@internal/test-utils": "0.0.61",
     "@internal/storage-test-utils": "0.0.121",
-    "@mastra/agent-builder": "1.1.14-alpha.3",
-    "@internal/types-builder": "0.0.100",
+    "@internal/core": "0.1.2",
     "@internal/voice": "0.0.23",
-    "@mastra/core": "1.62.0-alpha.10",
+    "@internal/types-builder": "0.0.100",
+    "@mastra/core": "1.62.0-alpha.12",
+    "@mastra/agent-builder": "1.1.14-alpha.4",
     "@mastra/schema-compat": "1.3.7"
   },
   "homepage": "https://mastra.ai",