@mastra/code-sdk 0.0.0-esbuild-bundle-worker-20260807173433

package/dist/utils/update-check.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Check for newer versions of mastracode on npm.
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+/**
+ * Detect which package manager was used to install mastracode globally.
+ *
+ * Uses a multi-tier approach:
+ * 1. npm_config_user_agent env var (set when run via `pnpm run`, `npm run`, etc.)
+ * 2. npm_execpath env var (fallback for script-based invocation)
+ * 3. NODE_PATH env var (set by pnpm global bin stubs)
+ * 4. Resolved path of the running script (process.argv[1])
+ * 5. Shell-out to `pnpm list -g` to check if pnpm manages the package
+ * 6. Falls back to 'npm'
+ */
+export declare function detectPackageManager(): Promise<PackageManager>;
+/**
+ * Build the shell command string a user would run to install/update globally.
+ */
+export declare function getInstallCommand(pm: PackageManager, version?: string): string;
+/**
+ * Read the current version, injected at build time by tsdown's `define` option.
+ * Falls back to reading package.json at runtime (e.g. when running from source with tsx).
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * Fetch the latest published version from npm.
+ * Returns null if the fetch fails (network error, timeout, etc.).
+ */
+export declare function fetchLatestVersion(): Promise<string | null>;
+/**
+ * Simple semver comparison: returns true if `latest` is newer than `current`.
+ * Handles standard x.y.z versions. Ignores pre-release tags.
+ */
+export declare function isNewerVersion(current: string, latest: string): boolean;
+/**
+ * Fetch the CHANGELOG.md for a specific published version from the npm CDN
+ * and extract a human-readable summary of changes.
+ * Returns null if the fetch fails or the changelog can't be parsed.
+ */
+export declare function fetchChangelog(version: string): Promise<string | null>;
+/**
+ * Extract the changelog section for a specific version and format it
+ * as a concise bullet list suitable for terminal display.
+ */
+export declare function parseChangelog(markdown: string, version: string): string | null;
+/** Result of attempting an auto-update: exit status plus captured stderr. */
+export interface UpdateResult {
+    ok: boolean;
+    stderr?: string;
+}
+/**
+ * Run the appropriate global install command to update mastracode.
+ * Exit code 0 does not prove the running binary changed (the install may land
+ * in a location the PATH shim doesn't use) — verify with {@link locateOwnInstall}.
+ */
+export declare function runUpdate(pm: PackageManager, targetVersion: string): Promise<UpdateResult>;
+/**
+ * Find the installed mastracode package the running binary belongs to (walking
+ * up from `process.argv[1]`) and read its version fresh from disk. Returns
+ * null when it can't be determined, e.g. when running from source.
+ */
+export declare function locateOwnInstall(): {
+    dir: string;
+    version: string | null;
+} | null;
+export type UpdateOutcome = {
+    status: 'updated';
+    message: string;
+} | {
+    status: 'unchanged';
+    message: string;
+} | {
+    status: 'failed';
+    message: string;
+};
+/**
+ * Decide what to tell the user after {@link runUpdate}: `updated` when the
+ * on-disk version matches the target (or can't be determined), `unchanged`
+ * when the package manager succeeded but the running install didn't change,
+ * `failed` on error (with the package manager's stderr).
+ */
+export declare function resolveUpdateOutcome(opts: {
+    pm: PackageManager;
+    targetVersion: string;
+    result: UpdateResult;
+    install: {
+        dir: string;
+        version: string | null;
+    } | null;
+    /** Overrides the suggested manual command, e.g. when the update was delegated to the owning tool. */
+    manualCommand?: string;
+}): UpdateOutcome;
+/**
+ * Update mastracode and verify the result: delegates to the tool that owns the
+ * running install when we recognize it, skips the install when it isn't
+ * managed by `pm`, otherwise runs the package manager. Every executed update
+ * is verified against the on-disk version.
+ */
+export declare function performUpdate(pm: PackageManager, targetVersion: string): Promise<UpdateOutcome>;
+//# sourceMappingURL=update-check.d.ts.map

package/dist/utils/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../src/utils/update-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAW7D;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CA+CpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAevE;AAKD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiD/E;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAE1F;AA0CD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CA6BjF;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,cAAc,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,aAAa,CAsBhB;AAuDD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAoCrG"}

package/dist/utils/update-check.js

@@ -0,0 +1,383 @@
+import { readFileSync, realpathSync } from "fs";
+import { homedir } from "os";
+import { dirname, join, resolve, sep } from "path";
+import { execFile } from "child_process";
+import { fileURLToPath } from "url";
+//#region src/utils/update-check.ts
+/**
+* Check for newer versions of mastracode on npm.
+*/
+const PACKAGE_NAME = "mastracode";
+const NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+/** Timeout for the npm registry fetch (ms). */
+const FETCH_TIMEOUT_MS = 5e3;
+const USE_SHELL = process.platform === "win32";
+function matchPM(str) {
+	if (/pnpm/i.test(str)) return "pnpm";
+	if (/\byarn\b/i.test(str)) return "yarn";
+	if (/\bbun\b/i.test(str)) return "bun";
+	if (/\bnpm\b/i.test(str)) return "npm";
+	return null;
+}
+/**
+* Detect which package manager was used to install mastracode globally.
+*
+* Uses a multi-tier approach:
+* 1. npm_config_user_agent env var (set when run via `pnpm run`, `npm run`, etc.)
+* 2. npm_execpath env var (fallback for script-based invocation)
+* 3. NODE_PATH env var (set by pnpm global bin stubs)
+* 4. Resolved path of the running script (process.argv[1])
+* 5. Shell-out to `pnpm list -g` to check if pnpm manages the package
+* 6. Falls back to 'npm'
+*/
+async function detectPackageManager() {
+	const userAgent = process.env.npm_config_user_agent;
+	if (userAgent) {
+		const pm = matchPM(userAgent);
+		if (pm) return pm;
+	}
+	const execPath = process.env.npm_execpath;
+	if (execPath) {
+		const pm = matchPM(execPath);
+		if (pm) return pm;
+	}
+	const nodePath = process.env.NODE_PATH;
+	if (nodePath) {
+		if (/[/\\]\.pnpm[/\\]/.test(nodePath) || /[/\\]pnpm[/\\]/.test(nodePath)) return "pnpm";
+		if (/[/\\]\.yarn[/\\]/.test(nodePath)) return "yarn";
+		if (/[/\\]\.bun[/\\]/.test(nodePath)) return "bun";
+	}
+	try {
+		const scriptPath = realpathSync(process.argv[1] ?? "");
+		if (/[/\\]\.?pnpm[/\\]/.test(scriptPath)) return "pnpm";
+		if (/[/\\]\.?yarn[/\\]/.test(scriptPath)) return "yarn";
+		if (/[/\\]\.?bun[/\\]/.test(scriptPath)) return "bun";
+	} catch {}
+	if (await new Promise((resolve) => {
+		execFile("pnpm", [
+			"list",
+			"-g",
+			"--depth=0",
+			PACKAGE_NAME
+		], {
+			timeout: 3e3,
+			shell: USE_SHELL
+		}, (error, stdout) => {
+			resolve(!error && stdout.includes(PACKAGE_NAME));
+		});
+	})) return "pnpm";
+	return "npm";
+}
+/**
+* Build the shell command string a user would run to install/update globally.
+*/
+function getInstallCommand(pm, version) {
+	const pkg = version ? `${PACKAGE_NAME}@${version}` : `${PACKAGE_NAME}@latest`;
+	switch (pm) {
+		case "pnpm": return `pnpm add -g ${pkg}`;
+		case "yarn": return `yarn global add ${pkg}`;
+		case "bun": return `bun add -g ${pkg}`;
+		default: return `npm install -g ${pkg}`;
+	}
+}
+/**
+* Read the current version, injected at build time by tsdown's `define` option.
+* Falls back to reading package.json at runtime (e.g. when running from source with tsx).
+*/
+function getCurrentVersion() {
+	if (typeof MASTRACODE_VERSION !== "undefined") return MASTRACODE_VERSION;
+	const pkgPath = resolve(dirname(fileURLToPath(import.meta.url)), "../../package.json");
+	return JSON.parse(readFileSync(pkgPath, "utf-8")).version;
+}
+/**
+* Fetch the latest published version from npm.
+* Returns null if the fetch fails (network error, timeout, etc.).
+*/
+async function fetchLatestVersion() {
+	if (process.env.MASTRACODE_UPDATE_LATEST_VERSION) return process.env.MASTRACODE_UPDATE_LATEST_VERSION;
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+		const res = await fetch(NPM_REGISTRY_URL, { signal: controller.signal });
+		clearTimeout(timeout);
+		if (!res.ok) return null;
+		return (await res.json()).version ?? null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Simple semver comparison: returns true if `latest` is newer than `current`.
+* Handles standard x.y.z versions. Ignores pre-release tags.
+*/
+function isNewerVersion(current, latest) {
+	const parse = (v) => v.replace(/^v/, "").split("-")[0].split(".").map((s) => {
+		const n = Number(s);
+		return Number.isFinite(n) ? n : 0;
+	});
+	const [cMajor = 0, cMinor = 0, cPatch = 0] = parse(current);
+	const [lMajor = 0, lMinor = 0, lPatch = 0] = parse(latest);
+	if (lMajor !== cMajor) return lMajor > cMajor;
+	if (lMinor !== cMinor) return lMinor > cMinor;
+	return lPatch > cPatch;
+}
+/** Max entries to show in the changelog summary. */
+const MAX_CHANGELOG_ENTRIES = 20;
+/**
+* Fetch the CHANGELOG.md for a specific published version from the npm CDN
+* and extract a human-readable summary of changes.
+* Returns null if the fetch fails or the changelog can't be parsed.
+*/
+async function fetchChangelog(version) {
+	if (process.env.MASTRACODE_UPDATE_CHANGELOG) return process.env.MASTRACODE_UPDATE_CHANGELOG;
+	try {
+		const url = `https://unpkg.com/${PACKAGE_NAME}@${version}/CHANGELOG.md`;
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+		const res = await fetch(url, { signal: controller.signal });
+		clearTimeout(timeout);
+		if (!res.ok) return null;
+		return parseChangelog(await res.text(), version);
+	} catch {
+		return null;
+	}
+}
+/**
+* Extract the changelog section for a specific version and format it
+* as a concise bullet list suitable for terminal display.
+*/
+function parseChangelog(markdown, version) {
+	const versionHeader = `## ${version}`;
+	const startIdx = markdown.indexOf(versionHeader);
+	if (startIdx === -1) return null;
+	const afterHeader = startIdx + versionHeader.length;
+	const nextHeaderIdx = markdown.indexOf("\n## ", afterHeader);
+	const lines = (nextHeaderIdx === -1 ? markdown.slice(afterHeader) : markdown.slice(afterHeader, nextHeaderIdx)).split("\n");
+	const entries = [];
+	let skipIndented = false;
+	for (let i = 0; i < lines.length; i++) {
+		const raw = lines[i];
+		const trimmed = raw.trim();
+		if (!(raw === trimmed && trimmed.startsWith("- "))) {
+			if (skipIndented && /^\s+-\s/.test(raw)) continue;
+			skipIndented = false;
+			continue;
+		}
+		if (/^- Updated dependenc/i.test(trimmed)) {
+			skipIndented = true;
+			continue;
+		}
+		skipIndented = false;
+		let entry = trimmed.slice(2);
+		entry = entry.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+		entry = entry.replace(/\s*\(#\d+\)\s*/g, " ");
+		entry = entry.replace(/\s*\(`[a-f0-9]+`\)\s*/g, " ");
+		entry = entry.replace(/\.\s*$/, "");
+		entry = entry.trim();
+		if (entry) entries.push(entry);
+		if (entries.length >= MAX_CHANGELOG_ENTRIES) break;
+	}
+	if (entries.length === 0) return null;
+	return entries.map((e) => `  • ${e}`).join("\n");
+}
+/**
+* Run the appropriate global install command to update mastracode.
+* Exit code 0 does not prove the running binary changed (the install may land
+* in a location the PATH shim doesn't use) — verify with {@link locateOwnInstall}.
+*/
+function runUpdate(pm, targetVersion) {
+	return execUpdate(pm, buildInstallArgs(pm, targetVersion));
+}
+function execUpdate(cmd, args) {
+	return new Promise((resolve) => {
+		execFile(cmd, args, {
+			timeout: 6e4,
+			shell: USE_SHELL
+		}, (error, _stdout, stderr) => {
+			const captured = (stderr ?? "").trim();
+			if (error) resolve({
+				ok: false,
+				stderr: captured || error.message
+			});
+			else resolve({
+				ok: true,
+				stderr: captured || void 0
+			});
+		});
+	});
+}
+function buildInstallArgs(pm, version) {
+	const pkg = `${PACKAGE_NAME}@${version}`;
+	switch (pm) {
+		case "pnpm": return [
+			"add",
+			"-g",
+			pkg
+		];
+		case "yarn": return [
+			"global",
+			"add",
+			pkg
+		];
+		case "bun": return [
+			"add",
+			"-g",
+			pkg
+		];
+		default: return [
+			"install",
+			"-g",
+			pkg
+		];
+	}
+}
+function formatUpdaterError(stderr) {
+	if (!stderr) return null;
+	const lines = stderr.split("\n").map((line) => line.trimEnd()).filter((line) => line.trim().length > 0);
+	if (lines.length === 0) return null;
+	return lines.slice(-5).join("\n");
+}
+/**
+* Find the installed mastracode package the running binary belongs to (walking
+* up from `process.argv[1]`) and read its version fresh from disk. Returns
+* null when it can't be determined, e.g. when running from source.
+*/
+function locateOwnInstall() {
+	const entry = process.argv[1];
+	if (!entry) return null;
+	let dir;
+	try {
+		dir = dirname(realpathSync(entry));
+	} catch {
+		return null;
+	}
+	let previous = "";
+	while (dir && dir !== previous) {
+		try {
+			const pkg = JSON.parse(readFileSync(resolve(dir, "package.json"), "utf-8"));
+			if (pkg.name === PACKAGE_NAME) return {
+				dir,
+				version: typeof pkg.version === "string" ? pkg.version : null
+			};
+		} catch {}
+		previous = dir;
+		dir = dirname(dir);
+	}
+	return null;
+}
+/**
+* Decide what to tell the user after {@link runUpdate}: `updated` when the
+* on-disk version matches the target (or can't be determined), `unchanged`
+* when the package manager succeeded but the running install didn't change,
+* `failed` on error (with the package manager's stderr).
+*/
+function resolveUpdateOutcome(opts) {
+	const { pm, targetVersion, result, install } = opts;
+	const cmd = opts.manualCommand ?? getInstallCommand(pm, targetVersion);
+	if (!result.ok) {
+		const details = formatUpdaterError(result.stderr);
+		let message = `Auto-update failed. Run \`${cmd}\` manually.`;
+		if (details) message += `\n\n${details}`;
+		return {
+			status: "failed",
+			message
+		};
+	}
+	if (install?.version != null && install.version !== targetVersion) return {
+		status: "unchanged",
+		message: opts.manualCommand ? `The update ran, but the Mastra Code you are running (at ${install.dir}) is still v${install.version}. Try \`${cmd}\` manually.` : `The update installed, but the Mastra Code you are running (at ${install.dir}) is still v${install.version} — it looks like it is managed by another tool. Update it with that tool, or try \`${cmd}\`.`
+	};
+	return {
+		status: "updated",
+		message: `Updated to v${targetVersion}. Please restart Mastra Code.`
+	};
+}
+/** Global node_modules directory the package manager installs into, or null when unknown. */
+function getGlobalRoot(pm) {
+	const args = pm === "yarn" ? ["global", "dir"] : ["root", "-g"];
+	return new Promise((res) => {
+		execFile(pm, args, {
+			timeout: 1e4,
+			shell: USE_SHELL
+		}, (error, stdout) => {
+			const out = (stdout ?? "").trim().split("\n").pop()?.trim();
+			if (error || !out) return res(null);
+			res(pm === "yarn" ? resolve(out, "node_modules") : out);
+		});
+	});
+}
+/**
+* Whether updating via `pm` would touch the install the running binary uses.
+* Fail-open: returns true when either side can't be determined, so the update
+* proceeds and the post-install verification has the final word.
+*/
+async function isOwnInstallManagedBy(pm, install) {
+	if (!install) return true;
+	const root = await getGlobalRoot(pm);
+	if (!root) return true;
+	try {
+		return realpathSync(resolve(root, PACKAGE_NAME)) === install.dir;
+	} catch {
+		return false;
+	}
+}
+function findInstallOwner(dir, version) {
+	if (dir.startsWith(join(homedir(), ".vite-plus") + sep)) return {
+		name: "vite-plus",
+		exec: {
+			cmd: "vp",
+			args: [
+				"install",
+				"-g",
+				`${PACKAGE_NAME}@${version}`
+			]
+		},
+		command: `vp install -g ${PACKAGE_NAME}@${version}`
+	};
+	if (dir.split(sep).includes("Cellar")) return {
+		name: "Homebrew",
+		command: `brew upgrade ${PACKAGE_NAME}`
+	};
+	return null;
+}
+/**
+* Update mastracode and verify the result: delegates to the tool that owns the
+* running install when we recognize it, skips the install when it isn't
+* managed by `pm`, otherwise runs the package manager. Every executed update
+* is verified against the on-disk version.
+*/
+async function performUpdate(pm, targetVersion) {
+	if (!/^[\w.+-]+$/.test(targetVersion)) return {
+		status: "failed",
+		message: `Auto-update aborted: unexpected version "${targetVersion}".`
+	};
+	const install = locateOwnInstall();
+	const owner = install ? findInstallOwner(install.dir, targetVersion) : null;
+	if (owner) {
+		if (!owner.exec) return {
+			status: "unchanged",
+			message: `Your Mastra Code install (at ${install.dir}) is managed by ${owner.name}. Update it with \`${owner.command}\`.`
+		};
+		return resolveUpdateOutcome({
+			pm,
+			targetVersion,
+			result: await execUpdate(owner.exec.cmd, owner.exec.args),
+			install: locateOwnInstall(),
+			manualCommand: owner.command
+		});
+	}
+	if (!await isOwnInstallManagedBy(pm, install)) return {
+		status: "unchanged",
+		message: `Your Mastra Code install (at ${install.dir}) is not managed by ${pm} — it looks like it was installed by another tool. Update it with that tool, or try \`${getInstallCommand(pm, targetVersion)}\`.`
+	};
+	return resolveUpdateOutcome({
+		pm,
+		targetVersion,
+		result: await runUpdate(pm, targetVersion),
+		install: locateOwnInstall()
+	});
+}
+//#endregion
+export { detectPackageManager, fetchChangelog, fetchLatestVersion, getCurrentVersion, getInstallCommand, isNewerVersion, locateOwnInstall, parseChangelog, performUpdate, resolveUpdateOutcome, runUpdate };
+
+//# sourceMappingURL=update-check.js.map

package/dist/utils/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","names":[],"sources":["../../src/utils/update-check.ts"],"sourcesContent":["/**\n * Check for newer versions of mastracode on npm.\n */\n\nimport { execFile } from 'node:child_process';\nimport { readFileSync, realpathSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { dirname, join, resolve, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\ndeclare const MASTRACODE_VERSION: string | undefined;\n\nconst PACKAGE_NAME = 'mastracode';\nconst NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;\n\n/** Timeout for the npm registry fetch (ms). */\nconst FETCH_TIMEOUT_MS = 5_000;\n\n// Package managers and vp are .cmd shims on Windows; execFile can't spawn those without a shell (EINVAL).\nconst USE_SHELL = process.platform === 'win32';\n\nexport type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';\n\nfunction matchPM(str: string): PackageManager | null {\n  // Order matters: check pnpm before npm since \"npm\" is a substring of some paths\n  if (/pnpm/i.test(str)) return 'pnpm';\n  if (/\\byarn\\b/i.test(str)) return 'yarn';\n  if (/\\bbun\\b/i.test(str)) return 'bun';\n  if (/\\bnpm\\b/i.test(str)) return 'npm';\n  return null;\n}\n\n/**\n * Detect which package manager was used to install mastracode globally.\n *\n * Uses a multi-tier approach:\n * 1. npm_config_user_agent env var (set when run via `pnpm run`, `npm run`, etc.)\n * 2. npm_execpath env var (fallback for script-based invocation)\n * 3. NODE_PATH env var (set by pnpm global bin stubs)\n * 4. Resolved path of the running script (process.argv[1])\n * 5. Shell-out to `pnpm list -g` to check if pnpm manages the package\n * 6. Falls back to 'npm'\n */\nexport async function detectPackageManager(): Promise<PackageManager> {\n  // Tier 1: npm_config_user_agent (most reliable when available)\n  const userAgent = process.env.npm_config_user_agent;\n  if (userAgent) {\n    const pm = matchPM(userAgent);\n    if (pm) return pm;\n  }\n\n  // Tier 2: npm_execpath\n  const execPath = process.env.npm_execpath;\n  if (execPath) {\n    const pm = matchPM(execPath);\n    if (pm) return pm;\n  }\n\n  // Tier 3: NODE_PATH (pnpm global stubs set this to paths containing .pnpm)\n  const nodePath = process.env.NODE_PATH;\n  if (nodePath) {\n    if (/[/\\\\]\\.pnpm[/\\\\]/.test(nodePath) || /[/\\\\]pnpm[/\\\\]/.test(nodePath)) return 'pnpm';\n    if (/[/\\\\]\\.yarn[/\\\\]/.test(nodePath)) return 'yarn';\n    if (/[/\\\\]\\.bun[/\\\\]/.test(nodePath)) return 'bun';\n  }\n\n  // Tier 4: Resolved script path\n  try {\n    const scriptPath = realpathSync(process.argv[1] ?? '');\n    if (/[/\\\\]\\.?pnpm[/\\\\]/.test(scriptPath)) return 'pnpm';\n    if (/[/\\\\]\\.?yarn[/\\\\]/.test(scriptPath)) return 'yarn';\n    if (/[/\\\\]\\.?bun[/\\\\]/.test(scriptPath)) return 'bun';\n  } catch {\n    // realpathSync can fail if argv[1] is missing/broken — fall through\n  }\n\n  // Tier 5: Check if the package is in pnpm's global store (non-blocking)\n  const pnpmResult = await new Promise<boolean>(resolve => {\n    execFile(\n      'pnpm',\n      ['list', '-g', '--depth=0', PACKAGE_NAME],\n      { timeout: 3_000, shell: USE_SHELL },\n      (error, stdout) => {\n        resolve(!error && stdout.includes(PACKAGE_NAME));\n      },\n    );\n  });\n  if (pnpmResult) return 'pnpm';\n\n  return 'npm';\n}\n\n/**\n * Build the shell command string a user would run to install/update globally.\n */\nexport function getInstallCommand(pm: PackageManager, version?: string): string {\n  const pkg = version ? `${PACKAGE_NAME}@${version}` : `${PACKAGE_NAME}@latest`;\n  switch (pm) {\n    case 'pnpm':\n      return `pnpm add -g ${pkg}`;\n    case 'yarn':\n      return `yarn global add ${pkg}`;\n    case 'bun':\n      return `bun add -g ${pkg}`;\n    default:\n      return `npm install -g ${pkg}`;\n  }\n}\n\n/**\n * Read the current version, injected at build time by tsdown's `define` option.\n * Falls back to reading package.json at runtime (e.g. when running from source with tsx).\n */\nexport function getCurrentVersion(): string {\n  if (typeof MASTRACODE_VERSION !== 'undefined') {\n    return MASTRACODE_VERSION;\n  }\n  // Fallback for running from source (e.g. pnpx tsx mastracode/src/main.ts)\n  const dir = dirname(fileURLToPath(import.meta.url));\n  const pkgPath = resolve(dir, '../../package.json');\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n  return pkg.version;\n}\n\n/**\n * Fetch the latest published version from npm.\n * Returns null if the fetch fails (network error, timeout, etc.).\n */\nexport async function fetchLatestVersion(): Promise<string | null> {\n  if (process.env.MASTRACODE_UPDATE_LATEST_VERSION) return process.env.MASTRACODE_UPDATE_LATEST_VERSION;\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    const res = await fetch(NPM_REGISTRY_URL, { signal: controller.signal });\n    clearTimeout(timeout);\n    if (!res.ok) return null;\n    const data = (await res.json()) as { version?: string };\n    return data.version ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Simple semver comparison: returns true if `latest` is newer than `current`.\n * Handles standard x.y.z versions. Ignores pre-release tags.\n */\nexport function isNewerVersion(current: string, latest: string): boolean {\n  const parse = (v: string) =>\n    v\n      .replace(/^v/, '')\n      .split('-')[0]!\n      .split('.')\n      .map(s => {\n        const n = Number(s);\n        return Number.isFinite(n) ? n : 0;\n      });\n  const [cMajor = 0, cMinor = 0, cPatch = 0] = parse(current);\n  const [lMajor = 0, lMinor = 0, lPatch = 0] = parse(latest);\n  if (lMajor !== cMajor) return lMajor > cMajor;\n  if (lMinor !== cMinor) return lMinor > cMinor;\n  return lPatch > cPatch;\n}\n\n/** Max entries to show in the changelog summary. */\nconst MAX_CHANGELOG_ENTRIES = 20;\n\n/**\n * Fetch the CHANGELOG.md for a specific published version from the npm CDN\n * and extract a human-readable summary of changes.\n * Returns null if the fetch fails or the changelog can't be parsed.\n */\nexport async function fetchChangelog(version: string): Promise<string | null> {\n  if (process.env.MASTRACODE_UPDATE_CHANGELOG) return process.env.MASTRACODE_UPDATE_CHANGELOG;\n\n  try {\n    const url = `https://unpkg.com/${PACKAGE_NAME}@${version}/CHANGELOG.md`;\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n    const res = await fetch(url, { signal: controller.signal });\n    clearTimeout(timeout);\n    if (!res.ok) return null;\n    const text = await res.text();\n    return parseChangelog(text, version);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract the changelog section for a specific version and format it\n * as a concise bullet list suitable for terminal display.\n */\nexport function parseChangelog(markdown: string, version: string): string | null {\n  const versionHeader = `## ${version}`;\n  const startIdx = markdown.indexOf(versionHeader);\n  if (startIdx === -1) return null;\n\n  const afterHeader = startIdx + versionHeader.length;\n  const nextHeaderIdx = markdown.indexOf('\\n## ', afterHeader);\n  const section = nextHeaderIdx === -1 ? markdown.slice(afterHeader) : markdown.slice(afterHeader, nextHeaderIdx);\n\n  const lines = section.split('\\n');\n  const entries: string[] = [];\n  let skipIndented = false;\n\n  for (let i = 0; i < lines.length; i++) {\n    const raw = lines[i]!;\n    const trimmed = raw.trim();\n\n    // Only match top-level entries (no leading whitespace before \"- \")\n    const isTopLevel = raw === trimmed && trimmed.startsWith('- ');\n    if (!isTopLevel) {\n      // Skip indented sub-items (e.g. dependency list entries)\n      if (skipIndented && /^\\s+-\\s/.test(raw)) continue;\n      skipIndented = false;\n      continue;\n    }\n\n    // Skip dependency update entries and their sub-items\n    if (/^- Updated dependenc/i.test(trimmed)) {\n      skipIndented = true;\n      continue;\n    }\n    skipIndented = false;\n\n    let entry = trimmed.slice(2);\n    // Strip markdown links: [text](url) → text\n    entry = entry.replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, '$1');\n    // Strip PR references like (#15760)\n    entry = entry.replace(/\\s*\\(#\\d+\\)\\s*/g, ' ');\n    // Strip commit SHA references like (`abc123`)\n    entry = entry.replace(/\\s*\\(`[a-f0-9]+`\\)\\s*/g, ' ');\n    // Trim trailing periods for cleaner bullet display\n    entry = entry.replace(/\\.\\s*$/, '');\n    entry = entry.trim();\n    if (entry) entries.push(entry);\n    if (entries.length >= MAX_CHANGELOG_ENTRIES) break;\n  }\n\n  if (entries.length === 0) return null;\n  return entries.map(e => `  • ${e}`).join('\\n');\n}\n\n/** Result of attempting an auto-update: exit status plus captured stderr. */\nexport interface UpdateResult {\n  ok: boolean;\n  stderr?: string;\n}\n\n/**\n * Run the appropriate global install command to update mastracode.\n * Exit code 0 does not prove the running binary changed (the install may land\n * in a location the PATH shim doesn't use) — verify with {@link locateOwnInstall}.\n */\nexport function runUpdate(pm: PackageManager, targetVersion: string): Promise<UpdateResult> {\n  return execUpdate(pm, buildInstallArgs(pm, targetVersion));\n}\n\nfunction execUpdate(cmd: string, args: string[]): Promise<UpdateResult> {\n  return new Promise(resolve => {\n    execFile(cmd, args, { timeout: 60_000, shell: USE_SHELL }, (error, _stdout, stderr) => {\n      const captured = (stderr ?? '').trim();\n      if (error) {\n        resolve({ ok: false, stderr: captured || error.message });\n      } else {\n        resolve({ ok: true, stderr: captured || undefined });\n      }\n    });\n  });\n}\n\nfunction buildInstallArgs(pm: PackageManager, version: string): string[] {\n  const pkg = `${PACKAGE_NAME}@${version}`;\n  switch (pm) {\n    case 'pnpm':\n      return ['add', '-g', pkg];\n    case 'yarn':\n      return ['global', 'add', pkg];\n    case 'bun':\n      return ['add', '-g', pkg];\n    default:\n      return ['install', '-g', pkg];\n  }\n}\n\n/** Max stderr lines to surface when an update fails. */\nconst MAX_UPDATE_ERROR_LINES = 5;\n\nfunction formatUpdaterError(stderr: string | undefined): string | null {\n  if (!stderr) return null;\n  const lines = stderr\n    .split('\\n')\n    .map(line => line.trimEnd())\n    .filter(line => line.trim().length > 0);\n  if (lines.length === 0) return null;\n  return lines.slice(-MAX_UPDATE_ERROR_LINES).join('\\n');\n}\n\n/**\n * Find the installed mastracode package the running binary belongs to (walking\n * up from `process.argv[1]`) and read its version fresh from disk. Returns\n * null when it can't be determined, e.g. when running from source.\n */\nexport function locateOwnInstall(): { dir: string; version: string | null } | null {\n  const entry = process.argv[1];\n  if (!entry) return null;\n\n  let dir: string;\n  try {\n    dir = dirname(realpathSync(entry));\n  } catch {\n    return null;\n  }\n\n  let previous = '';\n  while (dir && dir !== previous) {\n    try {\n      const pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf-8')) as {\n        name?: string;\n        version?: string;\n      };\n      if (pkg.name === PACKAGE_NAME) {\n        return { dir, version: typeof pkg.version === 'string' ? pkg.version : null };\n      }\n    } catch {\n      // Not a readable manifest — keep walking up.\n    }\n    previous = dir;\n    dir = dirname(dir);\n  }\n\n  return null;\n}\n\nexport type UpdateOutcome =\n  | { status: 'updated'; message: string }\n  | { status: 'unchanged'; message: string }\n  | { status: 'failed'; message: string };\n\n/**\n * Decide what to tell the user after {@link runUpdate}: `updated` when the\n * on-disk version matches the target (or can't be determined), `unchanged`\n * when the package manager succeeded but the running install didn't change,\n * `failed` on error (with the package manager's stderr).\n */\nexport function resolveUpdateOutcome(opts: {\n  pm: PackageManager;\n  targetVersion: string;\n  result: UpdateResult;\n  install: { dir: string; version: string | null } | null;\n  /** Overrides the suggested manual command, e.g. when the update was delegated to the owning tool. */\n  manualCommand?: string;\n}): UpdateOutcome {\n  const { pm, targetVersion, result, install } = opts;\n  const cmd = opts.manualCommand ?? getInstallCommand(pm, targetVersion);\n\n  if (!result.ok) {\n    const details = formatUpdaterError(result.stderr);\n    let message = `Auto-update failed. Run \\`${cmd}\\` manually.`;\n    if (details) message += `\\n\\n${details}`;\n    return { status: 'failed', message };\n  }\n\n  if (install?.version != null && install.version !== targetVersion) {\n    const message = opts.manualCommand\n      ? `The update ran, but the Mastra Code you are running (at ${install.dir}) is still ` +\n        `v${install.version}. Try \\`${cmd}\\` manually.`\n      : `The update installed, but the Mastra Code you are running (at ${install.dir}) is still ` +\n        `v${install.version} — it looks like it is managed by another tool. Update it with that tool, ` +\n        `or try \\`${cmd}\\`.`;\n    return { status: 'unchanged', message };\n  }\n\n  return { status: 'updated', message: `Updated to v${targetVersion}. Please restart Mastra Code.` };\n}\n\n/** Global node_modules directory the package manager installs into, or null when unknown. */\nfunction getGlobalRoot(pm: PackageManager): Promise<string | null> {\n  const args = pm === 'yarn' ? ['global', 'dir'] : ['root', '-g'];\n  return new Promise(res => {\n    execFile(pm, args, { timeout: 10_000, shell: USE_SHELL }, (error, stdout) => {\n      const out = (stdout ?? '').trim().split('\\n').pop()?.trim();\n      if (error || !out) return res(null);\n      res(pm === 'yarn' ? resolve(out, 'node_modules') : out);\n    });\n  });\n}\n\n/**\n * Whether updating via `pm` would touch the install the running binary uses.\n * Fail-open: returns true when either side can't be determined, so the update\n * proceeds and the post-install verification has the final word.\n */\nasync function isOwnInstallManagedBy(pm: PackageManager, install: { dir: string } | null): Promise<boolean> {\n  if (!install) return true;\n  const root = await getGlobalRoot(pm);\n  if (!root) return true;\n  try {\n    return realpathSync(resolve(root, PACKAGE_NAME)) === install.dir;\n  } catch {\n    // Package absent from the pm's global root: installing there can't affect the running binary.\n    return false;\n  }\n}\n\n/** A tool other than a package manager that owns the running install, matched by path. */\ninterface InstallOwner {\n  name: string;\n  /** Command to run to delegate the update; omitted when we only suggest `command` to the user. */\n  exec?: { cmd: string; args: string[] };\n  command: string;\n}\n\nfunction findInstallOwner(dir: string, version: string): InstallOwner | null {\n  if (dir.startsWith(join(homedir(), '.vite-plus') + sep)) {\n    return {\n      name: 'vite-plus',\n      exec: { cmd: 'vp', args: ['install', '-g', `${PACKAGE_NAME}@${version}`] },\n      command: `vp install -g ${PACKAGE_NAME}@${version}`,\n    };\n  }\n  // Homebrew keeps formulas under <prefix>/Cellar/ whatever the prefix, so match the path segment.\n  if (dir.split(sep).includes('Cellar')) {\n    // Suggest-only: brew formulas lag npm, and `brew upgrade` can pull unrelated updates.\n    return { name: 'Homebrew', command: `brew upgrade ${PACKAGE_NAME}` };\n  }\n  return null;\n}\n\n/**\n * Update mastracode and verify the result: delegates to the tool that owns the\n * running install when we recognize it, skips the install when it isn't\n * managed by `pm`, otherwise runs the package manager. Every executed update\n * is verified against the on-disk version.\n */\nexport async function performUpdate(pm: PackageManager, targetVersion: string): Promise<UpdateOutcome> {\n  // The registry-provided version reaches shell commands on Windows — accept only version tokens.\n  if (!/^[\\w.+-]+$/.test(targetVersion)) {\n    return { status: 'failed', message: `Auto-update aborted: unexpected version \"${targetVersion}\".` };\n  }\n\n  const install = locateOwnInstall();\n\n  const owner = install ? findInstallOwner(install.dir, targetVersion) : null;\n  if (owner) {\n    if (!owner.exec) {\n      const message =\n        `Your Mastra Code install (at ${install!.dir}) is managed by ${owner.name}. ` +\n        `Update it with \\`${owner.command}\\`.`;\n      return { status: 'unchanged', message };\n    }\n    const result = await execUpdate(owner.exec.cmd, owner.exec.args);\n    return resolveUpdateOutcome({\n      pm,\n      targetVersion,\n      result,\n      install: locateOwnInstall(),\n      manualCommand: owner.command,\n    });\n  }\n\n  if (!(await isOwnInstallManagedBy(pm, install))) {\n    const message =\n      `Your Mastra Code install (at ${install!.dir}) is not managed by ${pm} — it looks like it was ` +\n      `installed by another tool. Update it with that tool, or try \\`${getInstallCommand(pm, targetVersion)}\\`.`;\n    return { status: 'unchanged', message };\n  }\n\n  const result = await runUpdate(pm, targetVersion);\n  // Re-locate so the version reflects what the install just wrote to disk.\n  return resolveUpdateOutcome({ pm, targetVersion, result, install: locateOwnInstall() });\n}\n"],"mappings":"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"}

package/dist/voice/stt-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Speech-to-text (STT) model registry for push-to-talk voice input.
+ *
+ * This is the single source of truth shared by the `/voice` settings picker,
+ * settings validation, and the cloud transcription resolver. Entries are
+ * derived from models.dev (https://models.dev/api.json): a model is treated as
+ * STT when its modalities are audio-in / text-out with no text input.
+ *
+ * Most cloud providers here speak the OpenAI `/audio/transcriptions` shape, so
+ * the cloud engine resolves them through Mastra's `OpenAIVoice` (`MastraVoice`)
+ * built on the OpenAI client — `openai` uses the default endpoint, every other
+ * OpenAI-compatible host supplies its `baseURL`. Deepgram is the exception: it
+ * is not OpenAI-compatible, so it resolves through `@mastra/voice-deepgram`
+ * (`DeepgramVoice`). Deepgram is not in the models.dev STT snapshot but is a
+ * first-class hosted STT provider, so it is added deliberately.
+ *
+ * The accompanying snapshot test (`__tests__/stt-registry.test.ts`) re-derives
+ * the models.dev-backed entries from a checked-in snapshot so this list stays
+ * honest and can be refreshed deliberately rather than drifting by hand.
+ */
+/**
+ * How a provider's transcription model is constructed.
+ * - `openai`: `OpenAIVoice` with the default OpenAI endpoint.
+ * - `openai-compatible`: `OpenAIVoice` pointed at the host's `baseURL`
+ *   (its `/audio/transcriptions` endpoint follows the OpenAI shape).
+ * - `deepgram`: `DeepgramVoice` from `@mastra/voice-deepgram` (not
+ *   OpenAI-compatible; uses the Deepgram SDK).
+ */
+export type STTResolver = 'openai' | 'openai-compatible' | 'deepgram';
+export interface STTModel {
+    /** models.dev provider id (also the AuthStorage key for the API key). */
+    provider: string;
+    /** Bare model id passed to the provider's transcription factory. */
+    model: string;
+    /** Human-friendly label for the picker. */
+    label: string;
+    /** How to build the transcription model. */
+    resolver: STTResolver;
+    /** Base URL for `openai-compatible` providers (from models.dev `api`). */
+    baseURL?: string;
+}
+/**
+ * The curated STT catalog. Order matters: the first entry for a provider is its
+ * default model, and the first overall entry (`openai`/`whisper-1`) is the
+ * global default.
+ */
+export declare const STT_MODELS: readonly STTModel[];
+/** The global default STT model (first registry entry). */
+export declare const DEFAULT_STT_MODEL: STTModel;
+/** The default STT provider when none is configured. */
+export declare const DEFAULT_STT_PROVIDER: string;
+/** Unique provider ids in registry order. */
+export declare function sttProviders(): string[];
+/** All models offered for a provider, in registry order. */
+export declare function sttModelsForProvider(provider: string): STTModel[];
+/** The default (first) model for a provider, or undefined if unknown. */
+export declare function defaultModelForProvider(provider: string): STTModel | undefined;
+/**
+ * Resolve a provider/model pair to a concrete registry entry.
+ * Falls back to the provider default (then the global default) so callers
+ * always get a usable entry even if settings name an unknown model.
+ */
+export declare function resolveSTTModel(provider?: string, model?: string): STTModel;
+//# sourceMappingURL=stt-registry.d.ts.map

package/dist/voice/stt-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-registry.d.ts","sourceRoot":"","sources":["../../src/voice/stt-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,mBAAmB,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAqFhC,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,QAAyB,CAAC;AAE1D,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAE/D,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAUvC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEjE;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAU3E"}