create-mastra 1.37.0-alpha.2 → 1.37.0-alpha.3

package/dist/{api-CV5-CXEm-Cpd49bi2.js → api-CV5-CXEm-CueiBLg3.js}

@@ -1,4 +1,4 @@
-import { a as throwApiError, r as createApiClient } from "./client-JZw8MfpM-zeD5gOhK.js";
+import { i as createApiClient, s as throwApiError } from "./client-JZw8MfpM-BPeyQaUL.js";
 // ../cli/dist/api-CV5-CXEm.js
 async function fetchOrgs(token) {
 	const { data, error, response } = await createApiClient(token).GET("/v1/auth/orgs");

package/dist/api-Cdahi7Yf-BlGW3U7e.js

@@ -0,0 +1 @@
+export { t as fetchOrgs } from "./api-CV5-CXEm-CueiBLg3.js";

package/dist/{client-JZw8MfpM-zeD5gOhK.js → client-JZw8MfpM-BPeyQaUL.js}

@@ -388,7 +388,7 @@ function removeTrailingSlash(url) {
 }
 // ../cli/dist/client-JZw8MfpM.js
 const MASTRA_PLATFORM_API_URL = process.env.MASTRA_PLATFORM_API_URL || "https://platform.mastra.ai";
-process.env.MASTRA_PROJECTS_URL;
+const MASTRA_PROJECTS_URL = process.env.MASTRA_PROJECTS_URL || "https://projects.mastra.ai";
 /**
 * Derive the gateway URL from the platform URL when not explicitly set.
 * If the platform points at staging, the gateway defaults to staging too.
@@ -420,6 +420,22 @@ function throwApiError(message, status, detail) {
 	if (detail) throw new Error(detail);
 	throw new Error(`${message}: ${status}`);
 }
+/** Best-effort message from platform JSON error bodies (RFC 7807 `detail`, etc.). */
+function extractApiErrorDetail(error) {
+	if (!error || typeof error !== "object") return void 0;
+	const o = error;
+	let detail;
+	if (typeof o.detail === "string" && o.detail.trim()) detail = o.detail;
+	else if (typeof o.message === "string" && o.message.trim()) detail = o.message;
+	else if (typeof o.error === "string" && o.error.trim()) detail = o.error;
+	const fieldErrors = Array.isArray(o.errors) ? o.errors.map((e) => {
+		if (!e || typeof e !== "object") return "";
+		const fe = e;
+		return [typeof fe.field === "string" ? fe.field : "", typeof fe.message === "string" ? fe.message : ""].filter(Boolean).join(" — ");
+	}).filter(Boolean).join("; ") : "";
+	if (detail && fieldErrors) return `${detail}: ${fieldErrors}`;
+	return detail ?? (fieldErrors || void 0);
+}
 let _currentToken = null;
 let _refreshInFlight = null;
 /**
@@ -444,7 +460,7 @@ async function authenticatedFetch(input, init) {
 	if (response.status !== 401 || !_currentToken) return response;
 	if (!_refreshInFlight) _refreshInFlight = (async () => {
 		try {
-			const { tryRefreshToken, loadCredentials } = await import("./credentials-CdkRA-3T--5O17XQq.js");
+			const { tryRefreshToken, loadCredentials } = await import("./credentials-CdkRA-3T-Cagpr0K5.js");
 			const creds = await loadCredentials();
 			if (!creds) throw new Error("No credentials");
 			const newToken = await tryRefreshToken(creds);
@@ -502,4 +518,4 @@ function authHeaders(token, orgId) {
 function platformFetch(input, init) {
 	return authenticatedFetch(input, init);
 }
-export { throwApiError as a, platformFetch as i, authHeaders as n, createApiClient as r, MASTRA_PLATFORM_API_URL as t };
+export { extractApiErrorDetail as a, createApiClient as i, MASTRA_PROJECTS_URL as n, platformFetch as o, authHeaders as r, throwApiError as s, MASTRA_PLATFORM_API_URL as t };

package/dist/credentials-CdkRA-3T-Cagpr0K5.js

@@ -0,0 +1 @@
+export { i as loadCredentials, s as tryRefreshToken } from "./credentials-HeXP-kY2-89ktsX3S.js";

package/dist/{credentials-HeXP-kY2-jky92lr5.js → credentials-HeXP-kY2-89ktsX3S.js}

@@ -1,4 +1,4 @@
-import { t as MASTRA_PLATFORM_API_URL } from "./client-JZw8MfpM-zeD5gOhK.js";
+import { t as MASTRA_PLATFORM_API_URL } from "./client-JZw8MfpM-BPeyQaUL.js";
 import { createRequire } from "node:module";
 import "node:path";
 import process$1, { stdin, stdout } from "node:process";
@@ -1448,4 +1448,4 @@ async function getToken(signal, options = {}) {
 	if (options.allowLogin === false || !isInteractive()) throw new Error("Session expired. Run `mastra auth login` interactively or set MASTRA_API_TOKEN.");
 	return (await login(signal, options)).token;
 }
-export { __require as _, setCurrentOrgId as a, log as c, password as d, select as f, __commonJSMin as g, isCancel as h, loadCredentials as i, note as l, text as m, getCurrentOrgId as n, tryRefreshToken as o, spinner as p, getToken as r, cancel as s, LoginCancelledError as t, outro as u, __toESM as v };
+export { __commonJSMin as _, openBrowser as a, cancel as c, outro as d, password as f, isCancel as g, text as h, loadCredentials as i, log as l, spinner as m, getCurrentOrgId as n, setCurrentOrgId as o, select as p, getToken as r, tryRefreshToken as s, LoginCancelledError as t, note as u, __require as v, __toESM as y };

package/dist/index.js

@@ -1,7 +1,7 @@
 #! /usr/bin/env node
-import { _ as __require, a as setCurrentOrgId, c as log, d as password, f as select, g as __commonJSMin, h as isCancel, l as note, m as text, n as getCurrentOrgId, p as spinner, r as getToken, s as cancel, t as LoginCancelledError, u as outro, v as __toESM } from "./credentials-HeXP-kY2-jky92lr5.js";
-import { i as platformFetch, n as authHeaders, t as MASTRA_PLATFORM_API_URL } from "./client-JZw8MfpM-zeD5gOhK.js";
-import { t as fetchOrgs } from "./api-CV5-CXEm-Cpd49bi2.js";
+import { _ as __commonJSMin, a as openBrowser, c as cancel, d as outro, f as password, g as isCancel, h as text, l as log, m as spinner, n as getCurrentOrgId, o as setCurrentOrgId, p as select, r as getToken, t as LoginCancelledError, u as note, v as __require, y as __toESM } from "./credentials-HeXP-kY2-89ktsX3S.js";
+import { a as extractApiErrorDetail, n as MASTRA_PROJECTS_URL, o as platformFetch, r as authHeaders, t as MASTRA_PLATFORM_API_URL } from "./client-JZw8MfpM-BPeyQaUL.js";
+import { t as fetchOrgs } from "./api-CV5-CXEm-CueiBLg3.js";
 import { EventEmitter, addAbortListener, on, once, setMaxListeners } from "node:events";
 import { ChildProcess, execFile, spawn, spawnSync } from "node:child_process";
 import path, { basename, delimiter, dirname, isAbsolute, normalize, resolve } from "node:path";
@@ -17628,8 +17628,13 @@ var require_yocto_spinner = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 		return new YoctoSpinner(options);
 	};
 }));
-// ../cli/dist/analytics-BN1VDbPp.js
+// ../cli/dist/analytics-CTFP7R1h.js
 const CREATE_LLM_PROVIDERS = [
+	{
+		value: "mastra",
+		label: "Mastra Gateway",
+		hint: "every model with one key, sign in to get it"
+	},
 	{
 		value: "openai",
 		label: "OpenAI"
@@ -19354,7 +19359,7 @@ var require_semver = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		rcompareIdentifiers: identifiers.rcompareIdentifiers
 	};
 }));
-// ../cli/dist/create-BGnzr-Pz.js
+// ../cli/dist/create-4eqEFmGM.js
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
 var import_yocto_spinner = /* @__PURE__ */ __toESM(require_yocto_spinner(), 1);
 var import_semver = /* @__PURE__ */ __toESM(require_semver(), 1);
@@ -19512,6 +19517,117 @@ function findTemplateByName(templates, templateName) {
 	if (template) return template;
 	return null;
 }
+const GATEWAY_API_KEY_ENV = "MASTRA_GATEWAY_API_KEY";
+const STARTER_CREDIT_POOL = "gateway_credits";
+var GatewayApiError = class extends Error {
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+		this.name = "GatewayApiError";
+	}
+};
+async function request(token, orgId, path, init = {}, signal) {
+	const res = await platformFetch(`${MASTRA_PLATFORM_API_URL}${path}`, {
+		...init,
+		signal,
+		headers: {
+			...authHeaders(token, orgId),
+			...init.body ? { "Content-Type": "application/json" } : {}
+		}
+	});
+	if (!res.ok) {
+		const body = await res.json().catch(() => void 0);
+		throw new GatewayApiError(extractApiErrorDetail(body) ?? `Request failed (${res.status})`, res.status);
+	}
+	return await res.json();
+}
+/**
+* Create a Gateway API key in the organization. Uses the organization key service and falls back
+* to provisioning a Gateway project with a key only where that service doesn't exist (404). A 503
+* means the service failed, so it surfaces instead of leaving a stray project behind.
+*/
+async function createGatewayApiKey(token, orgId, label, signal) {
+	try {
+		const result = await request(token, orgId, "/v1/gateway/organization/v2/keys", {
+			method: "POST",
+			body: JSON.stringify({ label })
+		}, signal);
+		return {
+			apiKey: result.apiKey,
+			keyId: result.keyId
+		};
+	} catch (error) {
+		if (!(error instanceof GatewayApiError) || error.status !== 404) throw error;
+	}
+	return { apiKey: (await request(token, orgId, "/v1/gateway/projects/provision", {
+		method: "POST",
+		body: JSON.stringify({
+			name: label,
+			keyLabel: label
+		})
+	}, signal)).apiKey };
+}
+/** Revoke an organization key, e.g. one created for a project that was never written. */
+async function revokeGatewayApiKey(token, orgId, keyId) {
+	await request(token, orgId, `/v1/gateway/organization/v2/keys/${encodeURIComponent(keyId)}`, { method: "DELETE" });
+}
+async function getGatewayCredits(token, orgId, signal) {
+	const { customer } = await request(token, orgId, "/v1/billing/customer", {}, signal);
+	const featureId = customer?.creditPool?.featureId ?? STARTER_CREDIT_POOL;
+	const balance = findBalance(customer?.balances, featureId);
+	return {
+		remaining: remainingCredits(balance),
+		unlimited: balance?.unlimited === true
+	};
+}
+function findBalance(balances, featureId) {
+	if (!balances) return void 0;
+	return Object.values(balances).find((entry) => entry?.featureId === featureId) ?? balances[featureId];
+}
+function remainingCredits(balance) {
+	if (balance?.remaining != null) return Math.max(0, balance.remaining);
+	if (balance?.granted != null) return Math.max(0, balance.granted - (balance.usage ?? 0));
+	return 0;
+}
+/** The dashboard's Add credits page for the organization, where credits and auto top-up are bought. */
+function creditsPageUrl(orgId) {
+	return `${MASTRA_PROJECTS_URL}/add-credits/${orgId}`;
+}
+function formatCredits(amount) {
+	return `$${amount.toFixed(2)}`;
+}
+/**
+* Offer to add credits when the organization has none. Credits (and auto top-up) are bought in the
+* dashboard, which opens in the browser; setup carries on without waiting for the purchase.
+* Resolves to whether the dashboard was opened.
+*/
+async function offerGatewayCredits({ orgId, credits, signal }) {
+	if (credits.unlimited || credits.remaining > 0) return false;
+	const choice = await select({
+		message: `Your Gateway balance is ${formatCredits(credits.remaining)}. Model calls are paid per token from credits.`,
+		options: [{
+			value: "buy",
+			label: "Add credits",
+			hint: "opens the Mastra dashboard"
+		}, {
+			value: "skip",
+			label: "Skip for now"
+		}],
+		initialValue: "buy",
+		showInstructions: false,
+		signal
+	});
+	if (isCancel(choice) || choice === "skip") return false;
+	const url = creditsPageUrl(orgId);
+	try {
+		openBrowser(url);
+		log.info(`Opened the Mastra dashboard. Add credits there. If it didn't open, go to:\n${import_picocolors.default.cyan(url)}`);
+	} catch {
+		log.info(`Add credits in the Mastra dashboard:\n${import_picocolors.default.cyan(url)}`);
+	}
+	return true;
+}
 const DEFAULT_PLATFORM_API_URL = "https://platform.mastra.ai";
 /**
 * Walk the user through enabling Mastra Observability for a freshly-scaffolded
@@ -19860,6 +19976,10 @@ async function writeEmptyScaffold({ projectPath, projectName, versionTag, packag
 	await Promise.all(writes);
 }
 const MANAGED_PROVIDER_CONFIGS = {
+	mastra: {
+		displayName: "Mastra Gateway",
+		apiKeyEnv: "MASTRA_GATEWAY_API_KEY"
+	},
 	openai: {
 		displayName: "OpenAI",
 		apiKeyEnv: "OPENAI_API_KEY"
@@ -19954,6 +20074,21 @@ function adaptAgentSource(source, provider, config) {
 		applied: true,
 		content: source
 	};
+	if (provider === "mastra") {
+		if (findMatches(source, PRIMARY_OPENAI_MODEL).length !== 1) return {
+			applied: false,
+			content: source
+		};
+		if (findMatches(source, OBSERVATIONAL_OPENAI_MODEL).length !== 1) return {
+			applied: false,
+			content: source
+		};
+		const toGateway = (match) => match.replace(/(['"])openai\//, "$1mastra/openai/");
+		return {
+			applied: true,
+			content: source.replace(PRIMARY_OPENAI_MODEL, toGateway).replace(OBSERVATIONAL_OPENAI_MODEL, toGateway)
+		};
+	}
 	if (!config.primaryModel || !config.observationalModel) return {
 		applied: false,
 		content: source
@@ -20005,6 +20140,22 @@ async function writeSecureEnv(envPath, content) {
 		return false;
 	}
 }
+/**
+* Write an API key that arrived after the template was adapted (the Gateway key is created
+* while the template clones). Starts from `.env`, or `.env.example` when there is no `.env` yet.
+*/
+async function writeManagedApiKey({ projectPath, apiKeyEnv, apiKey }) {
+	const envPath = path$1.join(projectPath, ".env");
+	let source = "";
+	for (const candidate of [envPath, path$1.join(projectPath, ".env.example")]) try {
+		source = await fsPromises.readFile(candidate, "utf8");
+		break;
+	} catch (error) {
+		if (error.code !== "ENOENT") return false;
+	}
+	const result = setEnvValue(source, apiKeyEnv, apiKey);
+	return writeSecureEnv(envPath, result.applied ? result.content : `${source}${source && !source.endsWith("\n") ? "\n" : ""}${apiKeyEnv}=${apiKey}\n`);
+}
 async function adaptDefaultTemplate({ projectPath, projectName, packageManager, provider, apiKey, versionTag }) {
 	const config = MANAGED_PROVIDER_CONFIGS[provider];
 	let adaptationFailed = false;
@@ -20232,6 +20383,7 @@ const create = async (args) => {
 	let llmApiKey = options.llmApiKey;
 	let providerSelectionMethod;
 	let observabilityEnabled = false;
+	let needsGatewayKey = false;
 	let platformSetupController;
 	let platformSetupPromise;
 	if (mode === "managed") {
@@ -20241,7 +20393,8 @@ const create = async (args) => {
 			llmProvider = await promptForProvider();
 			providerSelectionMethod = "interactive";
 		}
-		if (llmApiKey === void 0 && !providerProvidedByCli) llmApiKey = await promptForApiKey(llmProvider);
+		if (llmApiKey === void 0 && !providerProvidedByCli && llmProvider !== "mastra") llmApiKey = await promptForApiKey(llmProvider);
+		needsGatewayKey = llmProvider === "mastra" && llmApiKey === void 0;
 		if (options.projectName === void 0 || options.llmProvider === void 0) {
 			observabilityEnabled = await promptForObservabilityOptIn();
 			analytics?.trackEvent("cli_observability_selected", {
@@ -20250,32 +20403,40 @@ const create = async (args) => {
 				answer: observabilityEnabled ? "yes" : "no",
 				selection_method: "interactive"
 			});
-			if (observabilityEnabled) {
-				platformSetupController = new AbortController();
-				platformSetupPromise = (async () => {
-					try {
-						const token = await getToken(platformSetupController.signal, {
-							skipOnInput: true,
-							source: args.loginSource
-						});
-						return {
-							status: "ready",
+		}
+		if (observabilityEnabled || needsGatewayKey) {
+			platformSetupController = new AbortController();
+			const signal = platformSetupController.signal;
+			platformSetupPromise = (async () => {
+				try {
+					const token = await getToken(signal, {
+						skipOnInput: true,
+						source: args.loginSource
+					});
+					const org = await resolveCurrentOrg(token, {
+						forcePrompt: true,
+						exitOnCancel: false,
+						signal
+					});
+					return {
+						status: "ready",
+						token,
+						org,
+						gateway: needsGatewayKey ? await setUpGateway({
 							token,
-							org: await resolveCurrentOrg(token, {
-								forcePrompt: true,
-								exitOnCancel: false,
-								signal: platformSetupController.signal
-							})
-						};
-					} catch (error) {
-						if (error instanceof LoginCancelledError || error instanceof OrgSelectionCancelledError) return { status: "cancelled" };
-						return {
-							status: "failed",
-							error
-						};
-					}
-				})();
-			}
+							org,
+							projectName,
+							signal
+						}) : void 0
+					};
+				} catch (error) {
+					if (error instanceof LoginCancelledError || error instanceof OrgSelectionCancelledError) return { status: "cancelled" };
+					return {
+						status: "failed",
+						error
+					};
+				}
+			})();
 		}
 	}
 	const selectedTemplate = mode === "empty" ? void 0 : await resolveTemplate(mode, options.template);
@@ -20327,7 +20488,7 @@ const create = async (args) => {
 					targetDir: staging.rootPath,
 					branch,
 					signal: materializationController.signal,
-					...observabilityEnabled ? { silent: true } : {}
+					...platformSetupPromise ? { silent: true } : {}
 				});
 				if (isManaged) {
 					const providerConfig = await adaptDefaultTemplate({
@@ -20345,7 +20506,7 @@ const create = async (args) => {
 				}
 			}
 			if (options.install) {
-				if (observabilityEnabled) await installDependencies(staging.projectPath, packageManager, options.timeout, materializationController.signal, true);
+				if (platformSetupPromise) await installDependencies(staging.projectPath, packageManager, options.timeout, materializationController.signal, true);
 				else await installDependencies(staging.projectPath, packageManager, options.timeout, materializationController.signal);
 			}
 			materializationController.signal.throwIfAborted();
@@ -20370,7 +20531,7 @@ const create = async (args) => {
 	if (platformSetupPromise) {
 		platformSetup = await platformSetupPromise;
 		if (platformSetup.status === "cancelled" && !interruptionSignal) {
-			analytics?.trackEvent("cli_observability_outcome", {
+			if (observabilityEnabled) analytics?.trackEvent("cli_observability_outcome", {
 				command: "create",
 				outcome: "skipped"
 			});
@@ -20384,6 +20545,7 @@ const create = async (args) => {
 	} else await materializationPromise;
 	process.removeListener("SIGINT", handleSigint);
 	process.removeListener("SIGTERM", handleSigterm);
+	if (interruptionSignal || materializationError) await discardUnusedGatewayKey(platformSetup);
 	if (interruptionSignal === "SIGINT") {
 		if (observabilityEnabled) analytics?.trackEvent("cli_observability_outcome", {
 			command: "create",
@@ -20407,10 +20569,16 @@ const create = async (args) => {
 	const setupSummary = formatPostCreateSetup(postSetup);
 	if (postSetup.hasFailure) log.warn(setupSummary);
 	else log.success(setupSummary);
+	let gatewaySummary;
+	if (needsGatewayKey) gatewaySummary = await finishGatewaySetup({
+		projectPath: targetPath,
+		platformSetup,
+		analytics
+	});
 	let observabilitySummary;
 	let platformEnvWritten = false;
-	let platformError = platformSetup?.status === "failed" ? platformSetup.error : void 0;
-	if (platformSetup?.status === "ready") try {
+	let platformError = observabilityEnabled && platformSetup?.status === "failed" ? platformSetup.error : void 0;
+	if (observabilityEnabled && platformSetup?.status === "ready") try {
 		const result = await provisionObservabilityProject({
 			defaultProjectName: projectName,
 			mode: "create",
@@ -20446,7 +20614,7 @@ const create = async (args) => {
 		observabilitySummary = `${import_picocolors.default.yellow("Could not connect this project to Mastra platform automatically:")} ${message}\n\n${placeholderSummary}1. Visit ${import_picocolors.default.cyan("https://projects.mastra.ai")} to create a project and an access token.\n2. Paste the token into ${import_picocolors.default.cyan("MASTRA_PLATFORM_ACCESS_TOKEN")} and the project id into ${import_picocolors.default.cyan("MASTRA_PROJECT_ID")}.`;
 	}
 	if (mode === "managed") {
-		const apiKeySummary = llmApiKey ? selectedApiKeyWritten ? `Your ${selectedApiKeyEnv} value was written to ${import_picocolors.default.cyan(".env")}.` : `Set ${selectedApiKeyEnv} in ${import_picocolors.default.cyan(".env")} before starting.` : platformEnvWritten ? `Set ${selectedApiKeyEnv} in ${import_picocolors.default.cyan(".env")} before starting.` : `Copy ${import_picocolors.default.cyan(".env.example")} to ${import_picocolors.default.cyan(".env")} and set ${selectedApiKeyEnv} before starting.`;
+		const apiKeySummary = gatewaySummary ? gatewaySummary : llmApiKey ? selectedApiKeyWritten ? `Your ${selectedApiKeyEnv} value was written to ${import_picocolors.default.cyan(".env")}.` : `Set ${selectedApiKeyEnv} in ${import_picocolors.default.cyan(".env")} before starting.` : platformEnvWritten ? `Set ${selectedApiKeyEnv} in ${import_picocolors.default.cyan(".env")} before starting.` : `Copy ${import_picocolors.default.cyan(".env.example")} to ${import_picocolors.default.cyan(".env")} and set ${selectedApiKeyEnv} before starting.`;
 		note(`${import_picocolors.default.green("Success!")}\n\n${apiKeySummary}${observabilitySummary ? `\n\n${observabilitySummary}` : ""}`);
 	} else if (mode === "template") note(`${import_picocolors.default.green("Success!")}\n\nCreate a ${import_picocolors.default.cyan(".env")} file if the template requires environment variables.`);
 	postCreate({
@@ -20454,6 +20622,109 @@ const create = async (args) => {
 		packageManager
 	});
 };
+async function setUpGateway({ token, org, projectName, signal }) {
+	const spinner$2 = spinner();
+	spinner$2.start("Setting up your Gateway key...");
+	let spinning = true;
+	let key;
+	try {
+		key = await createGatewayApiKey(token, org.orgId, projectName, signal);
+		let credits;
+		try {
+			credits = await getGatewayCredits(token, org.orgId, signal);
+		} catch (error) {
+			if (signal.aborted) throw error;
+		}
+		spinner$2.stop(`Created a Gateway key in ${org.orgName}.`);
+		spinning = false;
+		let openedDashboard = false;
+		if (credits) try {
+			openedDashboard = await offerGatewayCredits({
+				orgId: org.orgId,
+				credits,
+				signal
+			});
+		} catch (error) {
+			if (signal.aborted) throw error;
+		}
+		return {
+			status: "ready",
+			apiKey: key.apiKey,
+			keyId: key.keyId,
+			orgName: org.orgName,
+			creditsUrl: creditsPageUrl(org.orgId),
+			remaining: credits?.remaining,
+			unlimited: credits?.unlimited,
+			openedDashboard
+		};
+	} catch (error) {
+		if (spinning) spinner$2.stop("Could not set up a Gateway key.");
+		if (signal.aborted) {
+			await discardGatewayKey({
+				token,
+				orgId: org.orgId,
+				keyId: key?.keyId
+			});
+			throw error;
+		}
+		return {
+			status: "failed",
+			error
+		};
+	}
+}
+/** Revoke a key no project ended up with. Best effort: a failure here shouldn't hide the real one. */
+async function discardGatewayKey({ token, orgId, keyId }) {
+	if (!keyId) return;
+	try {
+		await revokeGatewayApiKey(token, orgId, keyId);
+	} catch {}
+}
+/** The Gateway key that was created but won't be written to a project. */
+async function discardUnusedGatewayKey(platformSetup) {
+	if (platformSetup?.status !== "ready" || platformSetup.gateway?.status !== "ready") return;
+	await discardGatewayKey({
+		token: platformSetup.token,
+		orgId: platformSetup.org.orgId,
+		keyId: platformSetup.gateway.keyId
+	});
+}
+async function finishGatewaySetup({ projectPath, platformSetup, analytics }) {
+	const envName = import_picocolors.default.cyan(GATEWAY_API_KEY_ENV);
+	const manualSteps = `Get a key at ${import_picocolors.default.cyan("https://gateway.mastra.ai")} and set ${envName} in ${import_picocolors.default.cyan(".env")}.`;
+	const gateway = platformSetup?.status === "ready" ? platformSetup.gateway : void 0;
+	if (gateway?.status !== "ready") {
+		const error = gateway?.status === "failed" ? gateway.error : platformSetup?.status === "failed" ? platformSetup.error : void 0;
+		analytics?.trackEvent("cli_gateway_outcome", {
+			command: "create",
+			outcome: error ? "failed" : "skipped"
+		});
+		return `${error instanceof Error ? `${import_picocolors.default.yellow("Could not create a Gateway key:")} ${error.message}\n\n` : ""}${manualSteps}`;
+	}
+	if (!await writeManagedApiKey({
+		projectPath,
+		apiKeyEnv: "MASTRA_GATEWAY_API_KEY",
+		apiKey: gateway.apiKey
+	})) {
+		await discardUnusedGatewayKey(platformSetup);
+		analytics?.trackEvent("cli_gateway_outcome", {
+			command: "create",
+			outcome: "failed"
+		});
+		return `${import_picocolors.default.yellow("Could not write the Gateway key to .env.")}\n\n${manualSteps}`;
+	}
+	analytics?.trackEvent("cli_gateway_outcome", {
+		command: "create",
+		outcome: "completed",
+		opened_dashboard: gateway.openedDashboard ?? false
+	});
+	const written = `Your Gateway key was written to ${import_picocolors.default.cyan(".env")} as ${envName}.`;
+	const creditsUrl = import_picocolors.default.cyan(gateway.creditsUrl);
+	if (gateway.unlimited) return `${written}\n${gateway.orgName} has unlimited Gateway credits.`;
+	if (gateway.remaining === void 0) return `${written}\nModel calls are paid per token from Gateway credits. Check your balance in the Mastra dashboard: ${creditsUrl}`;
+	if (gateway.remaining === 0) return `${written}\n${import_picocolors.default.yellow("Model calls fail until you add Gateway credits:")} ${creditsUrl}`;
+	return `${written}\nBalance: ${formatCredits(gateway.remaining)} in ${gateway.orgName}. Model calls are paid per token from these credits.`;
+}
 async function runPostCreateSetup({ projectPath, installSkills, initializeGit, invocationIsGitWorktree }) {
 	let skillsAgents = [];
 	let skillsOutcome = "opted_out";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mastra",
-  "version": "1.37.0-alpha.2",
+  "version": "1.37.0-alpha.3",
   "description": "Create Mastra apps with one command",
   "license": "Apache-2.0",
   "type": "module",
@@ -37,7 +37,7 @@
     "typescript": "^7.0.2",
     "vitest": "4.1.12",
     "@internal/lint": "0.0.146",
-    "mastra": "^1.37.0-alpha.2"
+    "mastra": "^1.37.0-alpha.3"
   },
   "engines": {
     "node": ">=22.13.0"

package/dist/api-Cdahi7Yf-BbwhMVLL.js

@@ -1 +0,0 @@
-export { t as fetchOrgs } from "./api-CV5-CXEm-Cpd49bi2.js";

package/dist/credentials-CdkRA-3T--5O17XQq.js

@@ -1 +0,0 @@
-export { i as loadCredentials, o as tryRefreshToken } from "./credentials-HeXP-kY2-jky92lr5.js";