@mastra/deployer 1.48.0 → 1.49.0-alpha.2

package/dist/chunk-WLW5IRHY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build/utils.ts"],"names":["join","relative","basename","builtinModules"],"mappings":"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","file":"chunk-WLW5IRHY.cjs","sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { builtinModules } from 'node:module';\nimport { basename, join, relative } from 'node:path';\nimport type { RollupNodeResolveOptions } from '@rollup/plugin-node-resolve';\n\n/** The detected JavaScript runtime environment */\nexport type RuntimePlatform = 'node' | 'bun';\n\n/**\n * The esbuild/bundler platform setting.\n * - 'node': Assumes Node.js environment, externalizes built-in modules\n * - 'browser': Assumes browser environment, polyfills Node APIs\n * - 'neutral': Runtime-agnostic, preserves all globals as-is (used for Bun)\n */\nexport type BundlerPlatform = 'node' | 'browser' | 'neutral';\n\n/**\n * Get nodeResolve plugin options based on the target platform.\n *\n * For 'browser' platform (e.g., Cloudflare Workers), uses browser-compatible\n * export conditions so packages like the Cloudflare SDK resolve to their\n * web runtime instead of Node.js-specific code.\n *\n * For 'node' and 'neutral' (Bun) platforms, uses Node.js module resolution.\n */\nexport function getNodeResolveOptions(platform: BundlerPlatform): RollupNodeResolveOptions {\n  if (platform === 'browser') {\n    return {\n      preferBuiltins: false,\n      browser: true,\n      exportConditions: ['browser', 'worker', 'default'],\n    };\n  }\n  return {\n    preferBuiltins: true,\n    exportConditions: ['node'],\n  };\n}\n\n/**\n * Detect the current JavaScript runtime environment.\n *\n * This is used by the bundler to determine the appropriate esbuild platform\n * setting. When running under Bun, we need to use 'neutral' platform to\n * preserve Bun-specific globals (like Bun.s3).\n */\nexport function detectRuntime(): RuntimePlatform {\n  if (process.versions?.bun) {\n    return 'bun';\n  }\n  return 'node';\n}\n\nexport function upsertMastraDir({ dir = process.cwd() }: { dir?: string }) {\n  const dirPath = join(dir, '.mastra');\n\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n    execSync(`echo \".mastra\" >> .gitignore`);\n  }\n}\n\nexport function isDependencyPartOfPackage(dep: string, packageName: string) {\n  if (dep === packageName) {\n    return true;\n  }\n\n  return dep.startsWith(`${packageName}/`);\n}\n\n/**\n * Get the package name from a module ID\n */\nexport function getPackageName(id: string) {\n  const parts = id.split('/');\n\n  if (id.startsWith('@')) {\n    return parts.slice(0, 2).join('/');\n  }\n\n  return parts[0];\n}\n\n/**\n * Check if an import specifier uses a protocol scheme rather than a package name.\n * Examples: `cloudflare:workers`, `data:text/javascript,...`, `node:fs`.\n */\nexport function hasImportProtocol(specifier: string): boolean {\n  // Avoid treating Windows absolute paths like `C:\\foo` as protocol imports.\n  if (/^[A-Za-z]:[\\\\/]/.test(specifier)) {\n    return false;\n  }\n\n  return /^[A-Za-z][A-Za-z\\d+.-]*:/.test(specifier);\n}\n\nconst DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST = ['node:'] as const;\n\n/**\n * Check if a specifier uses a non-builtin protocol that should be preserved at\n * runtime instead of being treated as an installable dependency.\n */\nexport function isExternalProtocolImport(\n  specifier: string,\n  excludeList: readonly string[] = DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST,\n): boolean {\n  if (!hasImportProtocol(specifier)) {\n    return false;\n  }\n\n  return !excludeList.some(prefix => specifier.startsWith(prefix));\n}\n\nfunction isRelativeImportSpecifier(specifier: string): boolean {\n  return specifier === '.' || specifier === '..' || specifier.startsWith('./') || specifier.startsWith('../');\n}\n\nfunction isAbsolutePathSpecifier(specifier: string): boolean {\n  return specifier.startsWith('/') || specifier.startsWith('\\\\\\\\') || /^[A-Za-z]:[\\\\/]/.test(specifier);\n}\n\n/**\n * During `mastra dev` we are compiling TS files to JS (inside workspaces) so that users can just their workspace packages.\n * We store these compiled files inside `node_modules/.cache` for each workspace package.\n */\nexport function getCompiledDepCachePath(rootPath: string, packageName: string) {\n  return slash(join(rootPath, 'node_modules', '.cache', packageName));\n}\n\n/**\n * Convert windows backslashes to posix slashes\n *\n * @example\n * ```ts\n * slash('C:\\\\Users\\\\user\\\\code\\\\mastra') // 'C:/Users/user/code/mastra'\n * ```\n */\nexport function slash(path: string) {\n  const isExtendedLengthPath = path.startsWith('\\\\\\\\?\\\\');\n\n  if (isExtendedLengthPath) {\n    return path;\n  }\n\n  return path.replaceAll('\\\\', '/');\n}\n\n/**\n * Make a Rollup-safe name: pathless, POSIX, and without parent/absolute segments\n */\nexport function rollupSafeName(name: string, rootDir: string) {\n  const rel = relative(rootDir, name);\n  let entry = slash(rel);\n  entry = entry.replace(/^(\\.\\.\\/)+/, '');\n  entry = entry.replace(/^\\/+/, '');\n  entry = entry.replace(/^[A-Za-z]:\\//, '');\n  if (!entry) {\n    entry = slash(basename(name));\n  }\n  return entry;\n}\n\n/**\n * Native binding loaders and infrastructure packages that should be ignored when identifying the actual package that requires native bindings\n */\nconst NATIVE_BINDING_LOADERS = [\n  'node-gyp-build',\n  'prebuild-install',\n  'bindings',\n  'node-addon-api',\n  'node-pre-gyp',\n  'nan', // Native Abstractions for Node.js\n] as const;\n\n/**\n * Finds the first real package from node_modules that likely contains native bindings, filtering out virtual modules and native binding loader infrastructure.\n *\n * @param moduleIds - Array of module IDs from a Rollup chunk\n * @returns The module ID of the actual native package, or undefined if not found\n *\n * @example\n * const moduleIds = [\n *   '\\x00/path/node_modules/bcrypt/bcrypt.js?commonjs-module',\n *   '/path/node_modules/node-gyp-build/index.js',\n *   '/path/node_modules/bcrypt/bcrypt.js',\n * ];\n * findNativePackageModule(moduleIds); // Returns '/path/node_modules/bcrypt/bcrypt.js'\n */\nexport function findNativePackageModule(moduleIds: string[]): string | undefined {\n  return moduleIds.find(id => {\n    // Skip virtual modules (Rollup plugin-generated)\n    if (id.startsWith('\\x00')) {\n      return false;\n    }\n\n    // Must be from node_modules\n    if (!id.includes('/node_modules/')) {\n      return false;\n    }\n\n    // Skip native binding loader infrastructure\n    for (const loader of NATIVE_BINDING_LOADERS) {\n      if (id.includes(`/${loader}/`) || id.includes(`/${loader}@`)) {\n        return false;\n      }\n    }\n\n    return true;\n  });\n}\n\n/**\n * Ensures that server.studioBase is normalized:\n * - Adds leading slash if missing (e.g., 'admin' → '/admin')\n * - Removes trailing slashes (e.g., '/admin/' → '/admin')\n * - Normalizes multiple slashes to single slash (e.g., '//api' → '/api')\n * - Returns empty string for root paths ('/' or '')\n *\n * @param studioBase - The studioBase path to normalize\n * @returns Normalized studioBase path string\n * @throws Error if path contains invalid characters ('..', '?', '#')\n */\nexport function normalizeStudioBase(studioBase: string): string {\n  studioBase = studioBase.trim();\n\n  // Validate: no path traversal, no query params, no special chars\n  if (studioBase.includes('..') || studioBase.includes('?') || studioBase.includes('#')) {\n    throw new Error(`Invalid base path: \"${studioBase}\". Base path cannot contain '..', '?', or '#'`);\n  }\n\n  // Normalize multiple slashes to single slash\n  studioBase = studioBase.replace(/\\/+/g, '/');\n\n  // Handle default value cases\n  if (studioBase === '/' || studioBase === '') {\n    return '';\n  }\n\n  // Remove trailing slash\n  if (studioBase.endsWith('/')) {\n    studioBase = studioBase.slice(0, -1);\n  }\n\n  // Add leading slash if missing\n  if (!studioBase.startsWith('/')) {\n    studioBase = `/${studioBase}`;\n  }\n\n  return studioBase;\n}\n\n/**\n * Configuration values for Studio's index.html placeholder injection.\n *\n * Each value is the **exact JavaScript expression** that replaces the\n * corresponding `'%%PLACEHOLDER%%'` token (including surrounding quotes).\n *\n * For literal strings pass `\"'value'\"` (quoted).\n * For runtime expressions pass the raw JS, e.g. `\"window.location.hostname\"`.\n */\nexport interface StudioInjectionConfig {\n  host: string;\n  port: string;\n  protocol: string;\n  apiPrefix: string;\n  basePath: string;\n  hideCloudCta: string;\n  cloudApiEndpoint: string;\n  experimentalFeatures: string;\n  templates: string;\n  telemetryDisabled: string;\n  requestContextPresets: string;\n  experimentalUI: string;\n  agentSignals: string;\n  signalsUI: string;\n  autoDetectUrl?: string;\n}\n\n/**\n * Replace all `%%MASTRA_*%%` placeholders in the Studio `index.html` with the\n * supplied configuration values.\n *\n * The `<base href>` tag and the `window.MASTRA_STUDIO_BASE_PATH` assignment\n * use `basePath` as a plain string (no surrounding quotes), while all other\n * placeholders replace `'%%TOKEN%%'` (with surrounding single-quotes in the\n * source HTML) with the provided expression verbatim.\n */\nexport function injectStudioHtmlConfig(html: string, config: StudioInjectionConfig): string {\n  // `String.prototype.replace`/`replaceAll` treat `$` sequences ($$, $&, $`,\n  // $', $n) in the replacement string as special patterns. Config values are\n  // dynamic (e.g. request context presets), so use a replacement function to\n  // insert them verbatim.\n  const replace = (token: string, value: string) => {\n    html = html.replace(token, () => value);\n  };\n\n  replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);\n  replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);\n  replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);\n  replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);\n  replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);\n  replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);\n  replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);\n  replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);\n  replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);\n  replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);\n  replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);\n  replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);\n  replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);\n  if (config.autoDetectUrl) {\n    replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);\n  }\n  html = html.replaceAll('%%MASTRA_STUDIO_BASE_PATH%%', () => config.basePath);\n\n  return html;\n}\n\n/**\n * Check if a module is a Node.js builtin module\n * @param specifier - Module specifier\n * @returns True if it's a builtin module\n */\nexport function isBuiltinModule(specifier: string): boolean {\n  return (\n    builtinModules.includes(specifier) ||\n    specifier.startsWith('node:') ||\n    builtinModules.includes(specifier.replace(/^node:/, ''))\n  );\n}\n\n/**\n * Check whether a module specifier is a bare module import rather than a path,\n * virtual module, or Node builtin.\n */\nexport function isBareModuleSpecifier(specifier: string): boolean {\n  if (!specifier || specifier.startsWith('#')) {\n    return false;\n  }\n\n  if (isRelativeImportSpecifier(specifier) || isAbsolutePathSpecifier(specifier)) {\n    return false;\n  }\n\n  if (isBuiltinModule(specifier)) {\n    return false;\n  }\n\n  if (isExternalProtocolImport(specifier)) {\n    return false;\n  }\n\n  return true;\n}\n"]}

package/dist/{chunk-V6F2NMS2.js → chunk-Z3DC47CH.js}

@@ -92,23 +92,26 @@ function normalizeStudioBase(studioBase) {
   return studioBase;
 }
 function injectStudioHtmlConfig(html, config) {
-  html = html.replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);
-  html = html.replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);
-  html = html.replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);
-  html = html.replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);
-  html = html.replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);
-  html = html.replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);
-  html = html.replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);
-  html = html.replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);
-  html = html.replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);
-  html = html.replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);
-  html = html.replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);
-  html = html.replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);
-  html = html.replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);
+  const replace = (token, value) => {
+    html = html.replace(token, () => value);
+  };
+  replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);
+  replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);
+  replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);
+  replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);
+  replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);
+  replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);
+  replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);
+  replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);
+  replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);
+  replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);
+  replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);
+  replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);
+  replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);
   if (config.autoDetectUrl) {
-    html = html.replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);
+    replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);
   }
-  html = html.replaceAll("%%MASTRA_STUDIO_BASE_PATH%%", config.basePath);
+  html = html.replaceAll("%%MASTRA_STUDIO_BASE_PATH%%", () => config.basePath);
   return html;
 }
 function isBuiltinModule(specifier) {
@@ -131,5 +134,5 @@ function isBareModuleSpecifier(specifier) {
 }
 
 export { detectRuntime, getCompiledDepCachePath, getNodeResolveOptions, getPackageName, injectStudioHtmlConfig, isBareModuleSpecifier, isBuiltinModule, isDependencyPartOfPackage, isExternalProtocolImport, normalizeStudioBase, rollupSafeName, slash };
-//# sourceMappingURL=chunk-V6F2NMS2.js.map
-//# sourceMappingURL=chunk-V6F2NMS2.js.map
+//# sourceMappingURL=chunk-Z3DC47CH.js.map
+//# sourceMappingURL=chunk-Z3DC47CH.js.map

package/dist/chunk-Z3DC47CH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/build/utils.ts"],"names":[],"mappings":"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","file":"chunk-Z3DC47CH.js","sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { builtinModules } from 'node:module';\nimport { basename, join, relative } from 'node:path';\nimport type { RollupNodeResolveOptions } from '@rollup/plugin-node-resolve';\n\n/** The detected JavaScript runtime environment */\nexport type RuntimePlatform = 'node' | 'bun';\n\n/**\n * The esbuild/bundler platform setting.\n * - 'node': Assumes Node.js environment, externalizes built-in modules\n * - 'browser': Assumes browser environment, polyfills Node APIs\n * - 'neutral': Runtime-agnostic, preserves all globals as-is (used for Bun)\n */\nexport type BundlerPlatform = 'node' | 'browser' | 'neutral';\n\n/**\n * Get nodeResolve plugin options based on the target platform.\n *\n * For 'browser' platform (e.g., Cloudflare Workers), uses browser-compatible\n * export conditions so packages like the Cloudflare SDK resolve to their\n * web runtime instead of Node.js-specific code.\n *\n * For 'node' and 'neutral' (Bun) platforms, uses Node.js module resolution.\n */\nexport function getNodeResolveOptions(platform: BundlerPlatform): RollupNodeResolveOptions {\n  if (platform === 'browser') {\n    return {\n      preferBuiltins: false,\n      browser: true,\n      exportConditions: ['browser', 'worker', 'default'],\n    };\n  }\n  return {\n    preferBuiltins: true,\n    exportConditions: ['node'],\n  };\n}\n\n/**\n * Detect the current JavaScript runtime environment.\n *\n * This is used by the bundler to determine the appropriate esbuild platform\n * setting. When running under Bun, we need to use 'neutral' platform to\n * preserve Bun-specific globals (like Bun.s3).\n */\nexport function detectRuntime(): RuntimePlatform {\n  if (process.versions?.bun) {\n    return 'bun';\n  }\n  return 'node';\n}\n\nexport function upsertMastraDir({ dir = process.cwd() }: { dir?: string }) {\n  const dirPath = join(dir, '.mastra');\n\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n    execSync(`echo \".mastra\" >> .gitignore`);\n  }\n}\n\nexport function isDependencyPartOfPackage(dep: string, packageName: string) {\n  if (dep === packageName) {\n    return true;\n  }\n\n  return dep.startsWith(`${packageName}/`);\n}\n\n/**\n * Get the package name from a module ID\n */\nexport function getPackageName(id: string) {\n  const parts = id.split('/');\n\n  if (id.startsWith('@')) {\n    return parts.slice(0, 2).join('/');\n  }\n\n  return parts[0];\n}\n\n/**\n * Check if an import specifier uses a protocol scheme rather than a package name.\n * Examples: `cloudflare:workers`, `data:text/javascript,...`, `node:fs`.\n */\nexport function hasImportProtocol(specifier: string): boolean {\n  // Avoid treating Windows absolute paths like `C:\\foo` as protocol imports.\n  if (/^[A-Za-z]:[\\\\/]/.test(specifier)) {\n    return false;\n  }\n\n  return /^[A-Za-z][A-Za-z\\d+.-]*:/.test(specifier);\n}\n\nconst DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST = ['node:'] as const;\n\n/**\n * Check if a specifier uses a non-builtin protocol that should be preserved at\n * runtime instead of being treated as an installable dependency.\n */\nexport function isExternalProtocolImport(\n  specifier: string,\n  excludeList: readonly string[] = DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST,\n): boolean {\n  if (!hasImportProtocol(specifier)) {\n    return false;\n  }\n\n  return !excludeList.some(prefix => specifier.startsWith(prefix));\n}\n\nfunction isRelativeImportSpecifier(specifier: string): boolean {\n  return specifier === '.' || specifier === '..' || specifier.startsWith('./') || specifier.startsWith('../');\n}\n\nfunction isAbsolutePathSpecifier(specifier: string): boolean {\n  return specifier.startsWith('/') || specifier.startsWith('\\\\\\\\') || /^[A-Za-z]:[\\\\/]/.test(specifier);\n}\n\n/**\n * During `mastra dev` we are compiling TS files to JS (inside workspaces) so that users can just their workspace packages.\n * We store these compiled files inside `node_modules/.cache` for each workspace package.\n */\nexport function getCompiledDepCachePath(rootPath: string, packageName: string) {\n  return slash(join(rootPath, 'node_modules', '.cache', packageName));\n}\n\n/**\n * Convert windows backslashes to posix slashes\n *\n * @example\n * ```ts\n * slash('C:\\\\Users\\\\user\\\\code\\\\mastra') // 'C:/Users/user/code/mastra'\n * ```\n */\nexport function slash(path: string) {\n  const isExtendedLengthPath = path.startsWith('\\\\\\\\?\\\\');\n\n  if (isExtendedLengthPath) {\n    return path;\n  }\n\n  return path.replaceAll('\\\\', '/');\n}\n\n/**\n * Make a Rollup-safe name: pathless, POSIX, and without parent/absolute segments\n */\nexport function rollupSafeName(name: string, rootDir: string) {\n  const rel = relative(rootDir, name);\n  let entry = slash(rel);\n  entry = entry.replace(/^(\\.\\.\\/)+/, '');\n  entry = entry.replace(/^\\/+/, '');\n  entry = entry.replace(/^[A-Za-z]:\\//, '');\n  if (!entry) {\n    entry = slash(basename(name));\n  }\n  return entry;\n}\n\n/**\n * Native binding loaders and infrastructure packages that should be ignored when identifying the actual package that requires native bindings\n */\nconst NATIVE_BINDING_LOADERS = [\n  'node-gyp-build',\n  'prebuild-install',\n  'bindings',\n  'node-addon-api',\n  'node-pre-gyp',\n  'nan', // Native Abstractions for Node.js\n] as const;\n\n/**\n * Finds the first real package from node_modules that likely contains native bindings, filtering out virtual modules and native binding loader infrastructure.\n *\n * @param moduleIds - Array of module IDs from a Rollup chunk\n * @returns The module ID of the actual native package, or undefined if not found\n *\n * @example\n * const moduleIds = [\n *   '\\x00/path/node_modules/bcrypt/bcrypt.js?commonjs-module',\n *   '/path/node_modules/node-gyp-build/index.js',\n *   '/path/node_modules/bcrypt/bcrypt.js',\n * ];\n * findNativePackageModule(moduleIds); // Returns '/path/node_modules/bcrypt/bcrypt.js'\n */\nexport function findNativePackageModule(moduleIds: string[]): string | undefined {\n  return moduleIds.find(id => {\n    // Skip virtual modules (Rollup plugin-generated)\n    if (id.startsWith('\\x00')) {\n      return false;\n    }\n\n    // Must be from node_modules\n    if (!id.includes('/node_modules/')) {\n      return false;\n    }\n\n    // Skip native binding loader infrastructure\n    for (const loader of NATIVE_BINDING_LOADERS) {\n      if (id.includes(`/${loader}/`) || id.includes(`/${loader}@`)) {\n        return false;\n      }\n    }\n\n    return true;\n  });\n}\n\n/**\n * Ensures that server.studioBase is normalized:\n * - Adds leading slash if missing (e.g., 'admin' → '/admin')\n * - Removes trailing slashes (e.g., '/admin/' → '/admin')\n * - Normalizes multiple slashes to single slash (e.g., '//api' → '/api')\n * - Returns empty string for root paths ('/' or '')\n *\n * @param studioBase - The studioBase path to normalize\n * @returns Normalized studioBase path string\n * @throws Error if path contains invalid characters ('..', '?', '#')\n */\nexport function normalizeStudioBase(studioBase: string): string {\n  studioBase = studioBase.trim();\n\n  // Validate: no path traversal, no query params, no special chars\n  if (studioBase.includes('..') || studioBase.includes('?') || studioBase.includes('#')) {\n    throw new Error(`Invalid base path: \"${studioBase}\". Base path cannot contain '..', '?', or '#'`);\n  }\n\n  // Normalize multiple slashes to single slash\n  studioBase = studioBase.replace(/\\/+/g, '/');\n\n  // Handle default value cases\n  if (studioBase === '/' || studioBase === '') {\n    return '';\n  }\n\n  // Remove trailing slash\n  if (studioBase.endsWith('/')) {\n    studioBase = studioBase.slice(0, -1);\n  }\n\n  // Add leading slash if missing\n  if (!studioBase.startsWith('/')) {\n    studioBase = `/${studioBase}`;\n  }\n\n  return studioBase;\n}\n\n/**\n * Configuration values for Studio's index.html placeholder injection.\n *\n * Each value is the **exact JavaScript expression** that replaces the\n * corresponding `'%%PLACEHOLDER%%'` token (including surrounding quotes).\n *\n * For literal strings pass `\"'value'\"` (quoted).\n * For runtime expressions pass the raw JS, e.g. `\"window.location.hostname\"`.\n */\nexport interface StudioInjectionConfig {\n  host: string;\n  port: string;\n  protocol: string;\n  apiPrefix: string;\n  basePath: string;\n  hideCloudCta: string;\n  cloudApiEndpoint: string;\n  experimentalFeatures: string;\n  templates: string;\n  telemetryDisabled: string;\n  requestContextPresets: string;\n  experimentalUI: string;\n  agentSignals: string;\n  signalsUI: string;\n  autoDetectUrl?: string;\n}\n\n/**\n * Replace all `%%MASTRA_*%%` placeholders in the Studio `index.html` with the\n * supplied configuration values.\n *\n * The `<base href>` tag and the `window.MASTRA_STUDIO_BASE_PATH` assignment\n * use `basePath` as a plain string (no surrounding quotes), while all other\n * placeholders replace `'%%TOKEN%%'` (with surrounding single-quotes in the\n * source HTML) with the provided expression verbatim.\n */\nexport function injectStudioHtmlConfig(html: string, config: StudioInjectionConfig): string {\n  // `String.prototype.replace`/`replaceAll` treat `$` sequences ($$, $&, $`,\n  // $', $n) in the replacement string as special patterns. Config values are\n  // dynamic (e.g. request context presets), so use a replacement function to\n  // insert them verbatim.\n  const replace = (token: string, value: string) => {\n    html = html.replace(token, () => value);\n  };\n\n  replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);\n  replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);\n  replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);\n  replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);\n  replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);\n  replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);\n  replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);\n  replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);\n  replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);\n  replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);\n  replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);\n  replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);\n  replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);\n  if (config.autoDetectUrl) {\n    replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);\n  }\n  html = html.replaceAll('%%MASTRA_STUDIO_BASE_PATH%%', () => config.basePath);\n\n  return html;\n}\n\n/**\n * Check if a module is a Node.js builtin module\n * @param specifier - Module specifier\n * @returns True if it's a builtin module\n */\nexport function isBuiltinModule(specifier: string): boolean {\n  return (\n    builtinModules.includes(specifier) ||\n    specifier.startsWith('node:') ||\n    builtinModules.includes(specifier.replace(/^node:/, ''))\n  );\n}\n\n/**\n * Check whether a module specifier is a bare module import rather than a path,\n * virtual module, or Node builtin.\n */\nexport function isBareModuleSpecifier(specifier: string): boolean {\n  if (!specifier || specifier.startsWith('#')) {\n    return false;\n  }\n\n  if (isRelativeImportSpecifier(specifier) || isAbsolutePathSpecifier(specifier)) {\n    return false;\n  }\n\n  if (isBuiltinModule(specifier)) {\n    return false;\n  }\n\n  if (isExternalProtocolImport(specifier)) {\n    return false;\n  }\n\n  return true;\n}\n"]}

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-deployer
 description: Documentation for @mastra/deployer. Use when working with @mastra/deployer APIs, configuration, or implementation.
 metadata:
   package: "@mastra/deployer"
-  version: "1.48.0"
+  version: "1.49.0-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.48.0",
+  "version": "1.49.0-alpha.2",
   "package": "@mastra/deployer",
   "exports": {
     "Deps": {

package/dist/index.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkCHZ76N6R_cjs = require('./chunk-CHZ76N6R.cjs');
-var chunkVZYB4EVX_cjs = require('./chunk-VZYB4EVX.cjs');
+var chunkHMT7QCMZ_cjs = require('./chunk-HMT7QCMZ.cjs');
+var chunk7RR5PJRM_cjs = require('./chunk-7RR5PJRM.cjs');
 var chunkVXLIM7FD_cjs = require('./chunk-VXLIM7FD.cjs');
 
 // src/deploy/base.ts
-var Deployer = class extends chunkCHZ76N6R_cjs.Bundler {
+var Deployer = class extends chunkHMT7QCMZ_cjs.Bundler {
   deps = new chunkVXLIM7FD_cjs.DepsService();
   constructor(args) {
     super(args.name, "DEPLOYER");
@@ -25,7 +25,7 @@ var Deployer = class extends chunkCHZ76N6R_cjs.Bundler {
 
 // src/build/deployer.ts
 async function getDeployer(entryFile, outputDir, logger) {
-  const result = await chunkVZYB4EVX_cjs.extractMastraOption("deployer", entryFile, outputDir, logger);
+  const result = await chunk7RR5PJRM_cjs.extractMastraOption("deployer", entryFile, outputDir, logger);
   if (!result) {
     return null;
   }

package/dist/index.js

@@ -1,5 +1,5 @@
-import { Bundler } from './chunk-T6LS4OKA.js';
-import { extractMastraOption } from './chunk-MPEFRVWJ.js';
+import { Bundler } from './chunk-BYRFFGSN.js';
+import { extractMastraOption } from './chunk-CGDATNET.js';
 import { DepsService, FileService } from './chunk-5GX66TF5.js';
 export { Deps, FileService, createChildProcessLogger, createPinoStream } from './chunk-5GX66TF5.js';
 

package/dist/server/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7PMC7SBC_cjs = require('../chunk-7PMC7SBC.cjs');
+var chunkWLW5IRHY_cjs = require('../chunk-WLW5IRHY.cjs');
 var promises = require('fs/promises');
 var https = require('https');
 var path = require('path');
@@ -4329,7 +4329,7 @@ async function createHonoServer(mastra, options = {
     );
   }
   const serverOptions = mastra.getServer();
-  const studioBasePath = chunk7PMC7SBC_cjs.normalizeStudioBase(serverOptions?.studioBase ?? "/");
+  const studioBasePath = chunkWLW5IRHY_cjs.normalizeStudioBase(serverOptions?.studioBase ?? "/");
   if (options?.studio) {
     app.get(
       `${studioBasePath}/refresh-events`,
@@ -4409,7 +4409,7 @@ async function createHonoServer(mastra, options = {
         return json.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
       };
       const autoDetectUrl = process.env.MASTRA_AUTO_DETECT_URL === "true";
-      indexHtml = chunk7PMC7SBC_cjs.injectStudioHtmlConfig(indexHtml, {
+      indexHtml = chunkWLW5IRHY_cjs.injectStudioHtmlConfig(indexHtml, {
         host: `'${studioHost}'`,
         port: `'${studioPort}'`,
         protocol: `'${studioProtocol}'`,
@@ -4481,7 +4481,7 @@ async function createNodeServer(mastra, options = { tools: {} }) {
       const logger2 = mastra.getLogger();
       logger2.info("Mastra API running", { url: `${protocol}://${host}:${port}${apiPrefix}` });
       if (options?.studio) {
-        const studioBasePath = chunk7PMC7SBC_cjs.normalizeStudioBase(serverOptions?.studioBase ?? "/");
+        const studioBasePath = chunkWLW5IRHY_cjs.normalizeStudioBase(serverOptions?.studioBase ?? "/");
         const studioUrl = `${studioProtocol}://${studioHost}:${studioPort}${studioBasePath}`;
         logger2.info("Studio available", { url: studioUrl });
       }

package/dist/server/index.js

@@ -1,4 +1,4 @@
-import { normalizeStudioBase, injectStudioHtmlConfig } from '../chunk-V6F2NMS2.js';
+import { normalizeStudioBase, injectStudioHtmlConfig } from '../chunk-Z3DC47CH.js';
 import { readFile } from 'fs/promises';
 import * as https from 'https';
 import { join, dirname } from 'path';

package/dist/validator/custom-resolver.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7PMC7SBC_cjs = require('../chunk-7PMC7SBC.cjs');
+var chunkWLW5IRHY_cjs = require('../chunk-WLW5IRHY.cjs');
 var fs = require('fs');
 var promises = require('fs/promises');
 var module$1 = require('module');
@@ -43,7 +43,7 @@ async function getParentPath(specifier, url) {
   if (!importers) {
     return null;
   }
-  const matchedPackage = Object.keys(importers).find((external) => chunk7PMC7SBC_cjs.isDependencyPartOfPackage(specifier, external));
+  const matchedPackage = Object.keys(importers).find((external) => chunkWLW5IRHY_cjs.isDependencyPartOfPackage(specifier, external));
   if (!matchedPackage) {
     return null;
   }
@@ -59,7 +59,7 @@ async function resolve(specifier, context, nextResolve) {
   }
   const stubbedExternals = getStubbedExternals();
   if (stubbedExternals.length > 0) {
-    const isStubbed = stubbedExternals.some((ext) => chunk7PMC7SBC_cjs.isDependencyPartOfPackage(specifier, ext));
+    const isStubbed = stubbedExternals.some((ext) => chunkWLW5IRHY_cjs.isDependencyPartOfPackage(specifier, ext));
     if (isStubbed) {
       return { url: `${STUB_PREFIX}${specifier}`, shortCircuit: true };
     }

package/dist/validator/custom-resolver.js

@@ -1,4 +1,4 @@
-import { isDependencyPartOfPackage } from '../chunk-V6F2NMS2.js';
+import { isDependencyPartOfPackage } from '../chunk-Z3DC47CH.js';
 import { existsSync } from 'fs';
 import { readFile } from 'fs/promises';
 import { builtinModules } from 'module';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/deployer",
-  "version": "1.48.0",
+  "version": "1.49.0-alpha.2",
   "description": "",
   "type": "module",
   "files": [
@@ -113,7 +113,7 @@
     "tinyglobby": "^0.2.17",
     "typescript-paths": "^1.5.2",
     "ws": "^8.20.0",
-    "@mastra/server": "1.48.0"
+    "@mastra/server": "1.49.0-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -134,13 +134,13 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.8",
     "zod": "^4.4.3",
-    "@internal/lint": "0.0.110",
-    "@mastra/agent-browser": "0.4.0",
     "@internal/types-builder": "0.0.85",
-    "@mastra/hono": "1.5.3",
-    "@mastra/mcp": "^1.12.1",
-    "@mastra/server": "1.48.0",
-    "@mastra/core": "1.48.0"
+    "@mastra/agent-browser": "0.4.0",
+    "@internal/lint": "0.0.110",
+    "@mastra/core": "1.49.0-alpha.2",
+    "@mastra/hono": "1.5.4-alpha.2",
+    "@mastra/server": "1.49.0-alpha.2",
+    "@mastra/mcp": "^1.13.0-alpha.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.47.0-0 <2.0.0-0"

package/dist/chunk-7PMC7SBC.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/build/utils.ts"],"names":["join","relative","basename","builtinModules"],"mappings":"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","file":"chunk-7PMC7SBC.cjs","sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { builtinModules } from 'node:module';\nimport { basename, join, relative } from 'node:path';\nimport type { RollupNodeResolveOptions } from '@rollup/plugin-node-resolve';\n\n/** The detected JavaScript runtime environment */\nexport type RuntimePlatform = 'node' | 'bun';\n\n/**\n * The esbuild/bundler platform setting.\n * - 'node': Assumes Node.js environment, externalizes built-in modules\n * - 'browser': Assumes browser environment, polyfills Node APIs\n * - 'neutral': Runtime-agnostic, preserves all globals as-is (used for Bun)\n */\nexport type BundlerPlatform = 'node' | 'browser' | 'neutral';\n\n/**\n * Get nodeResolve plugin options based on the target platform.\n *\n * For 'browser' platform (e.g., Cloudflare Workers), uses browser-compatible\n * export conditions so packages like the Cloudflare SDK resolve to their\n * web runtime instead of Node.js-specific code.\n *\n * For 'node' and 'neutral' (Bun) platforms, uses Node.js module resolution.\n */\nexport function getNodeResolveOptions(platform: BundlerPlatform): RollupNodeResolveOptions {\n  if (platform === 'browser') {\n    return {\n      preferBuiltins: false,\n      browser: true,\n      exportConditions: ['browser', 'worker', 'default'],\n    };\n  }\n  return {\n    preferBuiltins: true,\n    exportConditions: ['node'],\n  };\n}\n\n/**\n * Detect the current JavaScript runtime environment.\n *\n * This is used by the bundler to determine the appropriate esbuild platform\n * setting. When running under Bun, we need to use 'neutral' platform to\n * preserve Bun-specific globals (like Bun.s3).\n */\nexport function detectRuntime(): RuntimePlatform {\n  if (process.versions?.bun) {\n    return 'bun';\n  }\n  return 'node';\n}\n\nexport function upsertMastraDir({ dir = process.cwd() }: { dir?: string }) {\n  const dirPath = join(dir, '.mastra');\n\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n    execSync(`echo \".mastra\" >> .gitignore`);\n  }\n}\n\nexport function isDependencyPartOfPackage(dep: string, packageName: string) {\n  if (dep === packageName) {\n    return true;\n  }\n\n  return dep.startsWith(`${packageName}/`);\n}\n\n/**\n * Get the package name from a module ID\n */\nexport function getPackageName(id: string) {\n  const parts = id.split('/');\n\n  if (id.startsWith('@')) {\n    return parts.slice(0, 2).join('/');\n  }\n\n  return parts[0];\n}\n\n/**\n * Check if an import specifier uses a protocol scheme rather than a package name.\n * Examples: `cloudflare:workers`, `data:text/javascript,...`, `node:fs`.\n */\nexport function hasImportProtocol(specifier: string): boolean {\n  // Avoid treating Windows absolute paths like `C:\\foo` as protocol imports.\n  if (/^[A-Za-z]:[\\\\/]/.test(specifier)) {\n    return false;\n  }\n\n  return /^[A-Za-z][A-Za-z\\d+.-]*:/.test(specifier);\n}\n\nconst DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST = ['node:'] as const;\n\n/**\n * Check if a specifier uses a non-builtin protocol that should be preserved at\n * runtime instead of being treated as an installable dependency.\n */\nexport function isExternalProtocolImport(\n  specifier: string,\n  excludeList: readonly string[] = DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST,\n): boolean {\n  if (!hasImportProtocol(specifier)) {\n    return false;\n  }\n\n  return !excludeList.some(prefix => specifier.startsWith(prefix));\n}\n\nfunction isRelativeImportSpecifier(specifier: string): boolean {\n  return specifier === '.' || specifier === '..' || specifier.startsWith('./') || specifier.startsWith('../');\n}\n\nfunction isAbsolutePathSpecifier(specifier: string): boolean {\n  return specifier.startsWith('/') || specifier.startsWith('\\\\\\\\') || /^[A-Za-z]:[\\\\/]/.test(specifier);\n}\n\n/**\n * During `mastra dev` we are compiling TS files to JS (inside workspaces) so that users can just their workspace packages.\n * We store these compiled files inside `node_modules/.cache` for each workspace package.\n */\nexport function getCompiledDepCachePath(rootPath: string, packageName: string) {\n  return slash(join(rootPath, 'node_modules', '.cache', packageName));\n}\n\n/**\n * Convert windows backslashes to posix slashes\n *\n * @example\n * ```ts\n * slash('C:\\\\Users\\\\user\\\\code\\\\mastra') // 'C:/Users/user/code/mastra'\n * ```\n */\nexport function slash(path: string) {\n  const isExtendedLengthPath = path.startsWith('\\\\\\\\?\\\\');\n\n  if (isExtendedLengthPath) {\n    return path;\n  }\n\n  return path.replaceAll('\\\\', '/');\n}\n\n/**\n * Make a Rollup-safe name: pathless, POSIX, and without parent/absolute segments\n */\nexport function rollupSafeName(name: string, rootDir: string) {\n  const rel = relative(rootDir, name);\n  let entry = slash(rel);\n  entry = entry.replace(/^(\\.\\.\\/)+/, '');\n  entry = entry.replace(/^\\/+/, '');\n  entry = entry.replace(/^[A-Za-z]:\\//, '');\n  if (!entry) {\n    entry = slash(basename(name));\n  }\n  return entry;\n}\n\n/**\n * Native binding loaders and infrastructure packages that should be ignored when identifying the actual package that requires native bindings\n */\nconst NATIVE_BINDING_LOADERS = [\n  'node-gyp-build',\n  'prebuild-install',\n  'bindings',\n  'node-addon-api',\n  'node-pre-gyp',\n  'nan', // Native Abstractions for Node.js\n] as const;\n\n/**\n * Finds the first real package from node_modules that likely contains native bindings, filtering out virtual modules and native binding loader infrastructure.\n *\n * @param moduleIds - Array of module IDs from a Rollup chunk\n * @returns The module ID of the actual native package, or undefined if not found\n *\n * @example\n * const moduleIds = [\n *   '\\x00/path/node_modules/bcrypt/bcrypt.js?commonjs-module',\n *   '/path/node_modules/node-gyp-build/index.js',\n *   '/path/node_modules/bcrypt/bcrypt.js',\n * ];\n * findNativePackageModule(moduleIds); // Returns '/path/node_modules/bcrypt/bcrypt.js'\n */\nexport function findNativePackageModule(moduleIds: string[]): string | undefined {\n  return moduleIds.find(id => {\n    // Skip virtual modules (Rollup plugin-generated)\n    if (id.startsWith('\\x00')) {\n      return false;\n    }\n\n    // Must be from node_modules\n    if (!id.includes('/node_modules/')) {\n      return false;\n    }\n\n    // Skip native binding loader infrastructure\n    for (const loader of NATIVE_BINDING_LOADERS) {\n      if (id.includes(`/${loader}/`) || id.includes(`/${loader}@`)) {\n        return false;\n      }\n    }\n\n    return true;\n  });\n}\n\n/**\n * Ensures that server.studioBase is normalized:\n * - Adds leading slash if missing (e.g., 'admin' → '/admin')\n * - Removes trailing slashes (e.g., '/admin/' → '/admin')\n * - Normalizes multiple slashes to single slash (e.g., '//api' → '/api')\n * - Returns empty string for root paths ('/' or '')\n *\n * @param studioBase - The studioBase path to normalize\n * @returns Normalized studioBase path string\n * @throws Error if path contains invalid characters ('..', '?', '#')\n */\nexport function normalizeStudioBase(studioBase: string): string {\n  studioBase = studioBase.trim();\n\n  // Validate: no path traversal, no query params, no special chars\n  if (studioBase.includes('..') || studioBase.includes('?') || studioBase.includes('#')) {\n    throw new Error(`Invalid base path: \"${studioBase}\". Base path cannot contain '..', '?', or '#'`);\n  }\n\n  // Normalize multiple slashes to single slash\n  studioBase = studioBase.replace(/\\/+/g, '/');\n\n  // Handle default value cases\n  if (studioBase === '/' || studioBase === '') {\n    return '';\n  }\n\n  // Remove trailing slash\n  if (studioBase.endsWith('/')) {\n    studioBase = studioBase.slice(0, -1);\n  }\n\n  // Add leading slash if missing\n  if (!studioBase.startsWith('/')) {\n    studioBase = `/${studioBase}`;\n  }\n\n  return studioBase;\n}\n\n/**\n * Configuration values for Studio's index.html placeholder injection.\n *\n * Each value is the **exact JavaScript expression** that replaces the\n * corresponding `'%%PLACEHOLDER%%'` token (including surrounding quotes).\n *\n * For literal strings pass `\"'value'\"` (quoted).\n * For runtime expressions pass the raw JS, e.g. `\"window.location.hostname\"`.\n */\nexport interface StudioInjectionConfig {\n  host: string;\n  port: string;\n  protocol: string;\n  apiPrefix: string;\n  basePath: string;\n  hideCloudCta: string;\n  cloudApiEndpoint: string;\n  experimentalFeatures: string;\n  templates: string;\n  telemetryDisabled: string;\n  requestContextPresets: string;\n  experimentalUI: string;\n  agentSignals: string;\n  signalsUI: string;\n  autoDetectUrl?: string;\n}\n\n/**\n * Replace all `%%MASTRA_*%%` placeholders in the Studio `index.html` with the\n * supplied configuration values.\n *\n * The `<base href>` tag and the `window.MASTRA_STUDIO_BASE_PATH` assignment\n * use `basePath` as a plain string (no surrounding quotes), while all other\n * placeholders replace `'%%TOKEN%%'` (with surrounding single-quotes in the\n * source HTML) with the provided expression verbatim.\n */\nexport function injectStudioHtmlConfig(html: string, config: StudioInjectionConfig): string {\n  html = html.replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);\n  html = html.replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);\n  html = html.replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);\n  html = html.replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);\n  html = html.replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);\n  html = html.replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);\n  html = html.replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);\n  html = html.replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);\n  html = html.replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);\n  html = html.replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);\n  html = html.replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);\n  html = html.replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);\n  html = html.replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);\n  if (config.autoDetectUrl) {\n    html = html.replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);\n  }\n  html = html.replaceAll('%%MASTRA_STUDIO_BASE_PATH%%', config.basePath);\n\n  return html;\n}\n\n/**\n * Check if a module is a Node.js builtin module\n * @param specifier - Module specifier\n * @returns True if it's a builtin module\n */\nexport function isBuiltinModule(specifier: string): boolean {\n  return (\n    builtinModules.includes(specifier) ||\n    specifier.startsWith('node:') ||\n    builtinModules.includes(specifier.replace(/^node:/, ''))\n  );\n}\n\n/**\n * Check whether a module specifier is a bare module import rather than a path,\n * virtual module, or Node builtin.\n */\nexport function isBareModuleSpecifier(specifier: string): boolean {\n  if (!specifier || specifier.startsWith('#')) {\n    return false;\n  }\n\n  if (isRelativeImportSpecifier(specifier) || isAbsolutePathSpecifier(specifier)) {\n    return false;\n  }\n\n  if (isBuiltinModule(specifier)) {\n    return false;\n  }\n\n  if (isExternalProtocolImport(specifier)) {\n    return false;\n  }\n\n  return true;\n}\n"]}

package/dist/chunk-V6F2NMS2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/build/utils.ts"],"names":[],"mappings":"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","file":"chunk-V6F2NMS2.js","sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync } from 'node:fs';\nimport { builtinModules } from 'node:module';\nimport { basename, join, relative } from 'node:path';\nimport type { RollupNodeResolveOptions } from '@rollup/plugin-node-resolve';\n\n/** The detected JavaScript runtime environment */\nexport type RuntimePlatform = 'node' | 'bun';\n\n/**\n * The esbuild/bundler platform setting.\n * - 'node': Assumes Node.js environment, externalizes built-in modules\n * - 'browser': Assumes browser environment, polyfills Node APIs\n * - 'neutral': Runtime-agnostic, preserves all globals as-is (used for Bun)\n */\nexport type BundlerPlatform = 'node' | 'browser' | 'neutral';\n\n/**\n * Get nodeResolve plugin options based on the target platform.\n *\n * For 'browser' platform (e.g., Cloudflare Workers), uses browser-compatible\n * export conditions so packages like the Cloudflare SDK resolve to their\n * web runtime instead of Node.js-specific code.\n *\n * For 'node' and 'neutral' (Bun) platforms, uses Node.js module resolution.\n */\nexport function getNodeResolveOptions(platform: BundlerPlatform): RollupNodeResolveOptions {\n  if (platform === 'browser') {\n    return {\n      preferBuiltins: false,\n      browser: true,\n      exportConditions: ['browser', 'worker', 'default'],\n    };\n  }\n  return {\n    preferBuiltins: true,\n    exportConditions: ['node'],\n  };\n}\n\n/**\n * Detect the current JavaScript runtime environment.\n *\n * This is used by the bundler to determine the appropriate esbuild platform\n * setting. When running under Bun, we need to use 'neutral' platform to\n * preserve Bun-specific globals (like Bun.s3).\n */\nexport function detectRuntime(): RuntimePlatform {\n  if (process.versions?.bun) {\n    return 'bun';\n  }\n  return 'node';\n}\n\nexport function upsertMastraDir({ dir = process.cwd() }: { dir?: string }) {\n  const dirPath = join(dir, '.mastra');\n\n  if (!existsSync(dirPath)) {\n    mkdirSync(dirPath, { recursive: true });\n    execSync(`echo \".mastra\" >> .gitignore`);\n  }\n}\n\nexport function isDependencyPartOfPackage(dep: string, packageName: string) {\n  if (dep === packageName) {\n    return true;\n  }\n\n  return dep.startsWith(`${packageName}/`);\n}\n\n/**\n * Get the package name from a module ID\n */\nexport function getPackageName(id: string) {\n  const parts = id.split('/');\n\n  if (id.startsWith('@')) {\n    return parts.slice(0, 2).join('/');\n  }\n\n  return parts[0];\n}\n\n/**\n * Check if an import specifier uses a protocol scheme rather than a package name.\n * Examples: `cloudflare:workers`, `data:text/javascript,...`, `node:fs`.\n */\nexport function hasImportProtocol(specifier: string): boolean {\n  // Avoid treating Windows absolute paths like `C:\\foo` as protocol imports.\n  if (/^[A-Za-z]:[\\\\/]/.test(specifier)) {\n    return false;\n  }\n\n  return /^[A-Za-z][A-Za-z\\d+.-]*:/.test(specifier);\n}\n\nconst DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST = ['node:'] as const;\n\n/**\n * Check if a specifier uses a non-builtin protocol that should be preserved at\n * runtime instead of being treated as an installable dependency.\n */\nexport function isExternalProtocolImport(\n  specifier: string,\n  excludeList: readonly string[] = DEFAULT_PROTOCOL_IMPORT_EXCLUDE_LIST,\n): boolean {\n  if (!hasImportProtocol(specifier)) {\n    return false;\n  }\n\n  return !excludeList.some(prefix => specifier.startsWith(prefix));\n}\n\nfunction isRelativeImportSpecifier(specifier: string): boolean {\n  return specifier === '.' || specifier === '..' || specifier.startsWith('./') || specifier.startsWith('../');\n}\n\nfunction isAbsolutePathSpecifier(specifier: string): boolean {\n  return specifier.startsWith('/') || specifier.startsWith('\\\\\\\\') || /^[A-Za-z]:[\\\\/]/.test(specifier);\n}\n\n/**\n * During `mastra dev` we are compiling TS files to JS (inside workspaces) so that users can just their workspace packages.\n * We store these compiled files inside `node_modules/.cache` for each workspace package.\n */\nexport function getCompiledDepCachePath(rootPath: string, packageName: string) {\n  return slash(join(rootPath, 'node_modules', '.cache', packageName));\n}\n\n/**\n * Convert windows backslashes to posix slashes\n *\n * @example\n * ```ts\n * slash('C:\\\\Users\\\\user\\\\code\\\\mastra') // 'C:/Users/user/code/mastra'\n * ```\n */\nexport function slash(path: string) {\n  const isExtendedLengthPath = path.startsWith('\\\\\\\\?\\\\');\n\n  if (isExtendedLengthPath) {\n    return path;\n  }\n\n  return path.replaceAll('\\\\', '/');\n}\n\n/**\n * Make a Rollup-safe name: pathless, POSIX, and without parent/absolute segments\n */\nexport function rollupSafeName(name: string, rootDir: string) {\n  const rel = relative(rootDir, name);\n  let entry = slash(rel);\n  entry = entry.replace(/^(\\.\\.\\/)+/, '');\n  entry = entry.replace(/^\\/+/, '');\n  entry = entry.replace(/^[A-Za-z]:\\//, '');\n  if (!entry) {\n    entry = slash(basename(name));\n  }\n  return entry;\n}\n\n/**\n * Native binding loaders and infrastructure packages that should be ignored when identifying the actual package that requires native bindings\n */\nconst NATIVE_BINDING_LOADERS = [\n  'node-gyp-build',\n  'prebuild-install',\n  'bindings',\n  'node-addon-api',\n  'node-pre-gyp',\n  'nan', // Native Abstractions for Node.js\n] as const;\n\n/**\n * Finds the first real package from node_modules that likely contains native bindings, filtering out virtual modules and native binding loader infrastructure.\n *\n * @param moduleIds - Array of module IDs from a Rollup chunk\n * @returns The module ID of the actual native package, or undefined if not found\n *\n * @example\n * const moduleIds = [\n *   '\\x00/path/node_modules/bcrypt/bcrypt.js?commonjs-module',\n *   '/path/node_modules/node-gyp-build/index.js',\n *   '/path/node_modules/bcrypt/bcrypt.js',\n * ];\n * findNativePackageModule(moduleIds); // Returns '/path/node_modules/bcrypt/bcrypt.js'\n */\nexport function findNativePackageModule(moduleIds: string[]): string | undefined {\n  return moduleIds.find(id => {\n    // Skip virtual modules (Rollup plugin-generated)\n    if (id.startsWith('\\x00')) {\n      return false;\n    }\n\n    // Must be from node_modules\n    if (!id.includes('/node_modules/')) {\n      return false;\n    }\n\n    // Skip native binding loader infrastructure\n    for (const loader of NATIVE_BINDING_LOADERS) {\n      if (id.includes(`/${loader}/`) || id.includes(`/${loader}@`)) {\n        return false;\n      }\n    }\n\n    return true;\n  });\n}\n\n/**\n * Ensures that server.studioBase is normalized:\n * - Adds leading slash if missing (e.g., 'admin' → '/admin')\n * - Removes trailing slashes (e.g., '/admin/' → '/admin')\n * - Normalizes multiple slashes to single slash (e.g., '//api' → '/api')\n * - Returns empty string for root paths ('/' or '')\n *\n * @param studioBase - The studioBase path to normalize\n * @returns Normalized studioBase path string\n * @throws Error if path contains invalid characters ('..', '?', '#')\n */\nexport function normalizeStudioBase(studioBase: string): string {\n  studioBase = studioBase.trim();\n\n  // Validate: no path traversal, no query params, no special chars\n  if (studioBase.includes('..') || studioBase.includes('?') || studioBase.includes('#')) {\n    throw new Error(`Invalid base path: \"${studioBase}\". Base path cannot contain '..', '?', or '#'`);\n  }\n\n  // Normalize multiple slashes to single slash\n  studioBase = studioBase.replace(/\\/+/g, '/');\n\n  // Handle default value cases\n  if (studioBase === '/' || studioBase === '') {\n    return '';\n  }\n\n  // Remove trailing slash\n  if (studioBase.endsWith('/')) {\n    studioBase = studioBase.slice(0, -1);\n  }\n\n  // Add leading slash if missing\n  if (!studioBase.startsWith('/')) {\n    studioBase = `/${studioBase}`;\n  }\n\n  return studioBase;\n}\n\n/**\n * Configuration values for Studio's index.html placeholder injection.\n *\n * Each value is the **exact JavaScript expression** that replaces the\n * corresponding `'%%PLACEHOLDER%%'` token (including surrounding quotes).\n *\n * For literal strings pass `\"'value'\"` (quoted).\n * For runtime expressions pass the raw JS, e.g. `\"window.location.hostname\"`.\n */\nexport interface StudioInjectionConfig {\n  host: string;\n  port: string;\n  protocol: string;\n  apiPrefix: string;\n  basePath: string;\n  hideCloudCta: string;\n  cloudApiEndpoint: string;\n  experimentalFeatures: string;\n  templates: string;\n  telemetryDisabled: string;\n  requestContextPresets: string;\n  experimentalUI: string;\n  agentSignals: string;\n  signalsUI: string;\n  autoDetectUrl?: string;\n}\n\n/**\n * Replace all `%%MASTRA_*%%` placeholders in the Studio `index.html` with the\n * supplied configuration values.\n *\n * The `<base href>` tag and the `window.MASTRA_STUDIO_BASE_PATH` assignment\n * use `basePath` as a plain string (no surrounding quotes), while all other\n * placeholders replace `'%%TOKEN%%'` (with surrounding single-quotes in the\n * source HTML) with the provided expression verbatim.\n */\nexport function injectStudioHtmlConfig(html: string, config: StudioInjectionConfig): string {\n  html = html.replace(`'%%MASTRA_SERVER_HOST%%'`, config.host);\n  html = html.replace(`'%%MASTRA_SERVER_PORT%%'`, config.port);\n  html = html.replace(`'%%MASTRA_SERVER_PROTOCOL%%'`, config.protocol);\n  html = html.replace(`'%%MASTRA_API_PREFIX%%'`, config.apiPrefix);\n  html = html.replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, config.hideCloudCta);\n  html = html.replace(`'%%MASTRA_CLOUD_API_ENDPOINT%%'`, config.cloudApiEndpoint);\n  html = html.replace(`'%%MASTRA_EXPERIMENTAL_FEATURES%%'`, config.experimentalFeatures);\n  html = html.replace(`'%%MASTRA_TEMPLATES%%'`, config.templates);\n  html = html.replace(`'%%MASTRA_TELEMETRY_DISABLED%%'`, config.telemetryDisabled);\n  html = html.replace(`'%%MASTRA_REQUEST_CONTEXT_PRESETS%%'`, config.requestContextPresets);\n  html = html.replace(`'%%MASTRA_EXPERIMENTAL_UI%%'`, config.experimentalUI);\n  html = html.replace(`'%%MASTRA_AGENT_SIGNALS%%'`, config.agentSignals);\n  html = html.replace(`'%%MASTRA_SIGNALS_UI%%'`, config.signalsUI);\n  if (config.autoDetectUrl) {\n    html = html.replace(`'%%MASTRA_AUTO_DETECT_URL%%'`, config.autoDetectUrl);\n  }\n  html = html.replaceAll('%%MASTRA_STUDIO_BASE_PATH%%', config.basePath);\n\n  return html;\n}\n\n/**\n * Check if a module is a Node.js builtin module\n * @param specifier - Module specifier\n * @returns True if it's a builtin module\n */\nexport function isBuiltinModule(specifier: string): boolean {\n  return (\n    builtinModules.includes(specifier) ||\n    specifier.startsWith('node:') ||\n    builtinModules.includes(specifier.replace(/^node:/, ''))\n  );\n}\n\n/**\n * Check whether a module specifier is a bare module import rather than a path,\n * virtual module, or Node builtin.\n */\nexport function isBareModuleSpecifier(specifier: string): boolean {\n  if (!specifier || specifier.startsWith('#')) {\n    return false;\n  }\n\n  if (isRelativeImportSpecifier(specifier) || isAbsolutePathSpecifier(specifier)) {\n    return false;\n  }\n\n  if (isBuiltinModule(specifier)) {\n    return false;\n  }\n\n  if (isExternalProtocolImport(specifier)) {\n    return false;\n  }\n\n  return true;\n}\n"]}