@mastra/server 1.14.0 → 1.15.0-alpha.1

package/dist/{chunk-2CWSPVQF.cjs → chunk-ZHKXVTMQ.cjs}

@@ -2,10 +2,10 @@
 
 var chunkP2ZMGGHF_cjs = require('./chunk-P2ZMGGHF.cjs');
 var chunkY2BKW5ND_cjs = require('./chunk-Y2BKW5ND.cjs');
-var chunkEFSXF23C_cjs = require('./chunk-EFSXF23C.cjs');
+var chunkYJLDMFSE_cjs = require('./chunk-YJLDMFSE.cjs');
 var fs = require('fs');
 
-var GET_SYSTEM_PACKAGES_ROUTE = chunkEFSXF23C_cjs.createRoute({
+var GET_SYSTEM_PACKAGES_ROUTE = chunkYJLDMFSE_cjs.createRoute({
   method: "GET",
   path: "/system/packages",
   responseType: "json",
@@ -34,5 +34,5 @@ var GET_SYSTEM_PACKAGES_ROUTE = chunkEFSXF23C_cjs.createRoute({
 });
 
 exports.GET_SYSTEM_PACKAGES_ROUTE = GET_SYSTEM_PACKAGES_ROUTE;
-//# sourceMappingURL=chunk-2CWSPVQF.cjs.map
-//# sourceMappingURL=chunk-2CWSPVQF.cjs.map
+//# sourceMappingURL=chunk-ZHKXVTMQ.cjs.map
+//# sourceMappingURL=chunk-ZHKXVTMQ.cjs.map

package/dist/{chunk-2CWSPVQF.cjs.map → chunk-ZHKXVTMQ.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/handlers/system.ts"],"names":["createRoute","systemPackagesResponseSchema","readFileSync","handleError"],"mappings":";;;;;;;AAOO,IAAM,4BAA4BA,6BAAA,CAAY;AAAA,EACnD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgBC,8CAAA;AAAA,EAChB,OAAA,EAAS,+BAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAM;AAC7B,IAAA,IAAI;AACF,MAAA,MAAM,gBAAA,GAAmB,QAAQ,GAAA,CAAI,oBAAA;AAErC,MAAA,IAAI,WAA4B,EAAC;AAEjC,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,IAAI;AACF,UAAA,MAAM,WAAA,GAAcC,eAAA,CAAa,gBAAA,EAAkB,OAAO,CAAA;AAC1D,UAAA,QAAA,GAAW,IAAA,CAAK,MAAM,WAAW,CAAA;AAAA,QACnC,CAAA,CAAA,MAAQ;AACN,UAAA,QAAA,GAAW,EAAC;AAAA,QACd;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,UAAA,KAAe,MAAA,EAAQ,UAAA,EAAY,CAAC,CAAC,MAAA,CAAO,SAAA,EAAU,EAAE;AAAA,IAChG,SAAS,KAAA,EAAO;AACd,MAAA,OAAOC,6BAAA,CAAY,OAAO,+BAA+B,CAAA;AAAA,IAC3D;AAAA,EACF;AACF,CAAC","file":"chunk-2CWSPVQF.cjs","sourcesContent":["import { readFileSync } from 'node:fs';\n\nimport type { MastraPackage } from '../schemas/system';\nimport { systemPackagesResponseSchema } from '../schemas/system';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\n\nexport const GET_SYSTEM_PACKAGES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/packages',\n  responseType: 'json',\n  responseSchema: systemPackagesResponseSchema,\n  summary: 'Get installed Mastra packages',\n  description: 'Returns a list of all installed Mastra packages and their versions from the project',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const packagesFilePath = process.env.MASTRA_PACKAGES_FILE;\n\n      let packages: MastraPackage[] = [];\n\n      if (packagesFilePath) {\n        try {\n          const fileContent = readFileSync(packagesFilePath, 'utf-8');\n          packages = JSON.parse(fileContent);\n        } catch {\n          packages = [];\n        }\n      }\n\n      return { packages, isDev: process.env.MASTRA_DEV === 'true', cmsEnabled: !!mastra.getEditor() };\n    } catch (error) {\n      return handleError(error, 'Error getting system packages');\n    }\n  },\n});\n"]}
+{"version":3,"sources":["../src/server/handlers/system.ts"],"names":["createRoute","systemPackagesResponseSchema","readFileSync","handleError"],"mappings":";;;;;;;AAOO,IAAM,4BAA4BA,6BAAA,CAAY;AAAA,EACnD,MAAA,EAAQ,KAAA;AAAA,EACR,IAAA,EAAM,kBAAA;AAAA,EACN,YAAA,EAAc,MAAA;AAAA,EACd,cAAA,EAAgBC,8CAAA;AAAA,EAChB,OAAA,EAAS,+BAAA;AAAA,EACT,WAAA,EAAa,qFAAA;AAAA,EACb,IAAA,EAAM,CAAC,QAAQ,CAAA;AAAA,EACf,YAAA,EAAc,IAAA;AAAA,EACd,OAAA,EAAS,OAAO,EAAE,MAAA,EAAO,KAAM;AAC7B,IAAA,IAAI;AACF,MAAA,MAAM,gBAAA,GAAmB,QAAQ,GAAA,CAAI,oBAAA;AAErC,MAAA,IAAI,WAA4B,EAAC;AAEjC,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,IAAI;AACF,UAAA,MAAM,WAAA,GAAcC,eAAA,CAAa,gBAAA,EAAkB,OAAO,CAAA;AAC1D,UAAA,QAAA,GAAW,IAAA,CAAK,MAAM,WAAW,CAAA;AAAA,QACnC,CAAA,CAAA,MAAQ;AACN,UAAA,QAAA,GAAW,EAAC;AAAA,QACd;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,UAAA,KAAe,MAAA,EAAQ,UAAA,EAAY,CAAC,CAAC,MAAA,CAAO,SAAA,EAAU,EAAE;AAAA,IAChG,SAAS,KAAA,EAAO;AACd,MAAA,OAAOC,6BAAA,CAAY,OAAO,+BAA+B,CAAA;AAAA,IAC3D;AAAA,EACF;AACF,CAAC","file":"chunk-ZHKXVTMQ.cjs","sourcesContent":["import { readFileSync } from 'node:fs';\n\nimport type { MastraPackage } from '../schemas/system';\nimport { systemPackagesResponseSchema } from '../schemas/system';\nimport { createRoute } from '../server-adapter/routes/route-builder';\nimport { handleError } from './error';\n\nexport const GET_SYSTEM_PACKAGES_ROUTE = createRoute({\n  method: 'GET',\n  path: '/system/packages',\n  responseType: 'json',\n  responseSchema: systemPackagesResponseSchema,\n  summary: 'Get installed Mastra packages',\n  description: 'Returns a list of all installed Mastra packages and their versions from the project',\n  tags: ['System'],\n  requiresAuth: true,\n  handler: async ({ mastra }) => {\n    try {\n      const packagesFilePath = process.env.MASTRA_PACKAGES_FILE;\n\n      let packages: MastraPackage[] = [];\n\n      if (packagesFilePath) {\n        try {\n          const fileContent = readFileSync(packagesFilePath, 'utf-8');\n          packages = JSON.parse(fileContent);\n        } catch {\n          packages = [];\n        }\n      }\n\n      return { packages, isDev: process.env.MASTRA_DEV === 'true', cmsEnabled: !!mastra.getEditor() };\n    } catch (error) {\n      return handleError(error, 'Error getting system packages');\n    }\n  },\n});\n"]}

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.14.0"
+  version: "1.15.0-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.14.0",
+  "version": "1.15.0-alpha.1",
   "package": "@mastra/server",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-server-routes.md

@@ -4,14 +4,34 @@ Server adapters register these routes when you call `server.init()`. All routes
 
 ## Agents
 
-| Method | Path                                         | Description             |
-| ------ | -------------------------------------------- | ----------------------- |
-| `GET`  | `/api/agents`                                | List all agents         |
-| `GET`  | `/api/agents/:agentId`                       | Get agent by ID         |
-| `POST` | `/api/agents/:agentId/generate`              | Generate agent response |
-| `POST` | `/api/agents/:agentId/stream`                | Stream agent response   |
-| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools        |
-| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool      |
+| Method | Path                                         | Description                                     |
+| ------ | -------------------------------------------- | ----------------------------------------------- |
+| `GET`  | `/api/agents`                                | List all agents                                 |
+| `GET`  | `/api/agents/:agentId`                       | Get agent by ID (supports version query params) |
+| `POST` | `/api/agents/:agentId/generate`              | Generate agent response                         |
+| `POST` | `/api/agents/:agentId/stream`                | Stream agent response                           |
+| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools                                |
+| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool                              |
+
+### Get agent query parameters
+
+`GET /api/agents/:agentId` accepts optional query parameters to control which stored config version is applied as overrides to code-defined agents:
+
+| Parameter   | Type                     | Default   | Description                                                                                                            |
+| ----------- | ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `status`    | `'draft' \| 'published'` | `'draft'` | Which stored version to resolve. `draft` returns the latest version, `published` returns the active published version. |
+| `versionId` | `string`                 | —         | A specific version ID to resolve. Takes precedence over `status`.                                                      |
+
+```bash
+# Get agent with latest draft overrides (default)
+GET /api/agents/my-agent
+
+# Get agent with published overrides
+GET /api/agents/my-agent?status=published
+
+# Get agent with a specific version's overrides
+GET /api/agents/my-agent?versionId=abc123
+```
 
 ### Generate request body
 

package/dist/{observational-memory-UEDVTWS2-TU3KK4ZG.cjs → observational-memory-5NFPG6M3-L7EU4ABW.cjs}

@@ -1,68 +1,68 @@
 'use strict';
 
-var chunkA6HL3JRC_cjs = require('./chunk-A6HL3JRC.cjs');
+var chunkKH7BZQVQ_cjs = require('./chunk-KH7BZQVQ.cjs');
 
 
 
 Object.defineProperty(exports, "OBSERVATIONAL_MEMORY_DEFAULTS", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.OBSERVATIONAL_MEMORY_DEFAULTS; }
+  get: function () { return chunkKH7BZQVQ_cjs.OBSERVATIONAL_MEMORY_DEFAULTS; }
 });
 Object.defineProperty(exports, "OBSERVATION_CONTEXT_INSTRUCTIONS", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.OBSERVATION_CONTEXT_INSTRUCTIONS; }
+  get: function () { return chunkKH7BZQVQ_cjs.OBSERVATION_CONTEXT_INSTRUCTIONS; }
 });
 Object.defineProperty(exports, "OBSERVATION_CONTEXT_PROMPT", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.OBSERVATION_CONTEXT_PROMPT; }
+  get: function () { return chunkKH7BZQVQ_cjs.OBSERVATION_CONTEXT_PROMPT; }
 });
 Object.defineProperty(exports, "OBSERVATION_CONTINUATION_HINT", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.OBSERVATION_CONTINUATION_HINT; }
+  get: function () { return chunkKH7BZQVQ_cjs.OBSERVATION_CONTINUATION_HINT; }
 });
 Object.defineProperty(exports, "OBSERVER_SYSTEM_PROMPT", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.OBSERVER_SYSTEM_PROMPT; }
+  get: function () { return chunkKH7BZQVQ_cjs.OBSERVER_SYSTEM_PROMPT; }
 });
 Object.defineProperty(exports, "ObservationalMemory", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.ObservationalMemory; }
+  get: function () { return chunkKH7BZQVQ_cjs.ObservationalMemory; }
 });
 Object.defineProperty(exports, "TokenCounter", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.TokenCounter; }
+  get: function () { return chunkKH7BZQVQ_cjs.TokenCounter; }
 });
 Object.defineProperty(exports, "buildObserverPrompt", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.buildObserverPrompt; }
+  get: function () { return chunkKH7BZQVQ_cjs.buildObserverPrompt; }
 });
 Object.defineProperty(exports, "buildObserverSystemPrompt", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.buildObserverSystemPrompt; }
+  get: function () { return chunkKH7BZQVQ_cjs.buildObserverSystemPrompt; }
 });
 Object.defineProperty(exports, "extractCurrentTask", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.extractCurrentTask; }
+  get: function () { return chunkKH7BZQVQ_cjs.extractCurrentTask; }
 });
 Object.defineProperty(exports, "formatMessagesForObserver", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.formatMessagesForObserver; }
+  get: function () { return chunkKH7BZQVQ_cjs.formatMessagesForObserver; }
 });
 Object.defineProperty(exports, "getObservationsAsOf", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.getObservationsAsOf; }
+  get: function () { return chunkKH7BZQVQ_cjs.getObservationsAsOf; }
 });
 Object.defineProperty(exports, "hasCurrentTaskSection", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.hasCurrentTaskSection; }
+  get: function () { return chunkKH7BZQVQ_cjs.hasCurrentTaskSection; }
 });
 Object.defineProperty(exports, "optimizeObservationsForContext", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.optimizeObservationsForContext; }
+  get: function () { return chunkKH7BZQVQ_cjs.optimizeObservationsForContext; }
 });
 Object.defineProperty(exports, "parseObserverOutput", {
   enumerable: true,
-  get: function () { return chunkA6HL3JRC_cjs.parseObserverOutput; }
+  get: function () { return chunkKH7BZQVQ_cjs.parseObserverOutput; }
 });
-//# sourceMappingURL=observational-memory-UEDVTWS2-TU3KK4ZG.cjs.map
-//# sourceMappingURL=observational-memory-UEDVTWS2-TU3KK4ZG.cjs.map
+//# sourceMappingURL=observational-memory-5NFPG6M3-L7EU4ABW.cjs.map
+//# sourceMappingURL=observational-memory-5NFPG6M3-L7EU4ABW.cjs.map

package/dist/{observational-memory-UEDVTWS2-TU3KK4ZG.cjs.map → observational-memory-5NFPG6M3-L7EU4ABW.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-UEDVTWS2-TU3KK4ZG.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-5NFPG6M3-L7EU4ABW.cjs"}

package/dist/{observational-memory-UEDVTWS2-COV6JJZK.js → observational-memory-5NFPG6M3-MG2OMRFW.js}

@@ -1,3 +1,3 @@
-export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, optimizeObservationsForContext, parseObserverOutput } from './chunk-KZAB4IB3.js';
-//# sourceMappingURL=observational-memory-UEDVTWS2-COV6JJZK.js.map
-//# sourceMappingURL=observational-memory-UEDVTWS2-COV6JJZK.js.map
+export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTEXT_INSTRUCTIONS, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTINUATION_HINT, OBSERVER_SYSTEM_PROMPT, ObservationalMemory, TokenCounter, buildObserverPrompt, buildObserverSystemPrompt, extractCurrentTask, formatMessagesForObserver, getObservationsAsOf, hasCurrentTaskSection, optimizeObservationsForContext, parseObserverOutput } from './chunk-HPJ2CRVK.js';
+//# sourceMappingURL=observational-memory-5NFPG6M3-MG2OMRFW.js.map
+//# sourceMappingURL=observational-memory-5NFPG6M3-MG2OMRFW.js.map

package/dist/{observational-memory-UEDVTWS2-COV6JJZK.js.map → observational-memory-5NFPG6M3-MG2OMRFW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-UEDVTWS2-COV6JJZK.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"observational-memory-5NFPG6M3-MG2OMRFW.js"}

package/dist/{probe-image-size-NW5AOXWX.cjs → probe-image-size-7HF7Q24F.cjs}

@@ -2734,9 +2734,9 @@ var require_cookies = chunkO7I5CWRX_cjs.__commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/sax@1.5.0/node_modules/sax/lib/sax.js
+// ../../node_modules/.pnpm/sax@1.4.4/node_modules/sax/lib/sax.js
 var require_sax = chunkO7I5CWRX_cjs.__commonJS({
-  "../../node_modules/.pnpm/sax@1.5.0/node_modules/sax/lib/sax.js"(exports$1) {
+  "../../node_modules/.pnpm/sax@1.4.4/node_modules/sax/lib/sax.js"(exports$1) {
     (function(sax) {
       sax.parser = function(strict, opt) {
         return new SAXParser(strict, opt);
@@ -2790,9 +2790,6 @@ var require_sax = chunkO7I5CWRX_cjs.__commonJS({
         parser.opt = opt || {};
         parser.opt.lowercase = parser.opt.lowercase || parser.opt.lowercasetags;
         parser.looseCase = parser.opt.lowercase ? "toLowerCase" : "toUpperCase";
-        parser.opt.maxEntityCount = parser.opt.maxEntityCount || 512;
-        parser.opt.maxEntityDepth = parser.opt.maxEntityDepth || 4;
-        parser.entityCount = parser.entityDepth = 0;
         parser.tags = [];
         parser.closed = parser.closedRoot = parser.sawRoot = false;
         parser.tag = parser.error = null;
@@ -4145,22 +4142,9 @@ var require_sax = chunkO7I5CWRX_cjs.__commonJS({
               if (c === ";") {
                 var parsedEntity = parseEntity(parser);
                 if (parser.opt.unparsedEntities && !Object.values(sax.XML_ENTITIES).includes(parsedEntity)) {
-                  if ((parser.entityCount += 1) > parser.opt.maxEntityCount) {
-                    error(
-                      parser,
-                      "Parsed entity count exceeds max entity count"
-                    );
-                  }
-                  if ((parser.entityDepth += 1) > parser.opt.maxEntityDepth) {
-                    error(
-                      parser,
-                      "Parsed entity depth exceeds max entity depth"
-                    );
-                  }
                   parser.entity = "";
                   parser.state = returnState;
                   parser.write(parsedEntity);
-                  parser.entityDepth -= 1;
                 } else {
                   parser[buffer] += parsedEntity;
                   parser.entity = "";
@@ -9822,13 +9806,13 @@ var require_probe_image_size = chunkO7I5CWRX_cjs.__commonJS({
     module.exports.Error = require_common().ProbeError;
   }
 });
-var probeImageSizeNW5AOXWX = require_probe_image_size();
+var probeImageSize7HF7Q24F = require_probe_image_size();
 /*! Bundled license information:
 
 sax/lib/sax.js:
   (*! http://mths.be/fromcodepoint v0.1.0 by @mathias *)
 */
 
-module.exports = probeImageSizeNW5AOXWX;
-//# sourceMappingURL=probe-image-size-NW5AOXWX.cjs.map
-//# sourceMappingURL=probe-image-size-NW5AOXWX.cjs.map
+module.exports = probeImageSize7HF7Q24F;
+//# sourceMappingURL=probe-image-size-7HF7Q24F.cjs.map
+//# sourceMappingURL=probe-image-size-7HF7Q24F.cjs.map