@mastra/observability 1.16.6-alpha.2 → 1.16.6-alpha.4

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @mastra/observability
 
+## 1.16.6-alpha.4
+
+### Patch Changes
+
+- Added automatic quota pause to MastraPlatformExporter. When the Mastra platform reports that an organization's observability quota is exhausted (by rejecting publish requests with `402 Payment Required` and the `x-mastra-observability: disabled` header), the exporter now stops uploading telemetry, drops events locally instead of retrying, and periodically probes the platform (honoring the `x-mastra-observability-retry-after` hint, defaulting to every 5 minutes). Exports resume automatically once the platform re-enables observability, with warnings logged on pause and resume. ([#21160](https://github.com/mastra-ai/mastra/pull/21160))
+
+  No quota-specific configuration is needed — any existing exporter setup gets this behavior automatically:
+
+  ```typescript
+  import { MastraPlatformExporter } from '@mastra/observability';
+
+  const exporter = new MastraPlatformExporter({
+    accessToken: process.env.MASTRA_PLATFORM_ACCESS_TOKEN,
+  });
+  ```
+
+- Updated dependencies [[`210cb7a`](https://github.com/mastra-ai/mastra/commit/210cb7a167998c7bbf72cb3b93e6eb0563330239), [`5f798b3`](https://github.com/mastra-ai/mastra/commit/5f798b3362e9bdf4d690f85245606e146eef60b9), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437), [`25ca73d`](https://github.com/mastra-ai/mastra/commit/25ca73d25dee7ce9f0ca72939e3a505c4db7257e), [`e1cead1`](https://github.com/mastra-ai/mastra/commit/e1cead17b5f3653cf00d2f90cc19b113119c02ba), [`01a2943`](https://github.com/mastra-ai/mastra/commit/01a2943a7d886edefdff072bfa51f055bab54437)]:
+  - @mastra/core@1.58.0-alpha.14
+
+## 1.16.6-alpha.3
+
+### Patch Changes
+
+- Preserved the provider response model on completed model inference spans. ([#21154](https://github.com/mastra-ai/mastra/pull/21154))
+
+- Updated dependencies [[`2e4624e`](https://github.com/mastra-ai/mastra/commit/2e4624edb6917e61249cb60ee377735e7af7e4a9), [`e6534fa`](https://github.com/mastra-ai/mastra/commit/e6534fab031216f6cb48c4c9907cbfdce9d60bc6), [`7fdcaa6`](https://github.com/mastra-ai/mastra/commit/7fdcaa66105d64290f9b14432a12ec99f39c4d3a), [`cfd0d9e`](https://github.com/mastra-ai/mastra/commit/cfd0d9ec77ec3c69dd96f79cdb579e03d79f22ce), [`d9d93b2`](https://github.com/mastra-ai/mastra/commit/d9d93b25e4a65ad5fa153fa35be7ed149c8d587f)]:
+  - @mastra/core@1.58.0-alpha.12
+
 ## 1.16.6-alpha.2
 
 ### Patch Changes

package/dist/exporters/auth-failure-cooldown.d.ts

@@ -4,7 +4,7 @@ export declare class AuthFailureError extends Error {
     constructor(status: number, cause?: unknown);
 }
 export declare function isAuthFailureError(error: unknown): error is AuthFailureError;
-export declare function fetchWithAuthFailureHandling(url: string, options: RequestInit, maxRetries: number): Promise<void>;
+export declare function fetchWithAuthFailureHandling(url: string, options: RequestInit, maxRetries: number, callerShouldRetry?: (response: Response) => boolean): Promise<Response>;
 export declare class AuthFailureCooldown {
     private readonly exporterName;
     private readonly getLogger;

package/dist/exporters/auth-failure-cooldown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-failure-cooldown.d.ts","sourceRoot":"","sources":["../../src/exporters/auth-failure-cooldown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK5C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAMD,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,2BAA2B,CAAK;gBAGrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,aAAa;IAGjD,OAAO,CAAC,gBAAgB;IAIxB,sBAAsB,IAAI,OAAO;IAIjC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS/C,KAAK,IAAI,MAAM;IAUf,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAwBjG"}
+{"version":3,"file":"auth-failure-cooldown.d.ts","sourceRoot":"","sources":["../../src/exporters/auth-failure-cooldown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK5C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAMD,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,GAClD,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAED,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,2BAA2B,CAAK;gBAGrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,aAAa;IAGjD,OAAO,CAAC,gBAAgB;IAIxB,sBAAsB,IAAI,OAAO;IAIjC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS/C,KAAK,IAAI,MAAM;IAUf,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAwBjG"}

package/dist/exporters/mastra-platform.d.ts

@@ -21,6 +21,10 @@ export declare class MastraPlatformExporter extends BaseExporter {
     private buffer;
     private flushTimer;
     private inFlightFlushes;
+    private quotaPaused;
+    private quotaProbeTimer;
+    private quotaProbeIntervalSeconds;
+    private shuttingDown;
     constructor(config?: MastraPlatformExporterConfig);
     protected _exportTracingEvent(event: TracingEvent): Promise<void>;
     onLogEvent(event: LogEvent): Promise<void>;
@@ -45,7 +49,24 @@ export declare class MastraPlatformExporter extends BaseExporter {
     /**
      * Uploads a signal batch to the configured Mastra Observability API using fetchWithRetry.
      */
+    private buildPublishHeaders;
+    private buildPublishBody;
     private batchUpload;
+    /**
+     * Enter the quota-exhausted paused state: drop buffered events, stop the
+     * flush timer, and start probing until the collector stops rejecting with
+     * 402. The gate is per-org, so a signal on any publish route pauses all
+     * five signal types.
+     */
+    private enterQuotaPause;
+    private scheduleQuotaProbe;
+    /**
+     * Send an empty spans batch as a free probe. The collector treats an empty
+     * batch as a no-op, and an exhausted org still gets the 402 on it. A 402
+     * throws out of fetchWithRetry without the Response, so the retry predicate
+     * captures it to keep the retry-after hint.
+     */
+    private probeQuotaStatus;
     private flushSignalBatch;
     private resetBuffer;
     /**

package/dist/exporters/mastra-platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mastra-platform.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,WAAW,4BAA6B,SAAQ,kBAAkB;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+LD,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,IAAI,SAA8B;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAA4B;gBAEvC,MAAM,GAAE,4BAAiC;cAyErC,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;YAMR,mBAAmB;IAYjC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,aAAa;YAoBP,WAAW;IAuEzB;;OAEG;YACW,WAAW;YAuBX,gBAAgB;IAmC9B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC"}
+{"version":3,"file":"mastra-platform.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACd,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,WAAW,4BAA6B,SAAQ,kBAAkB;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkOD,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,IAAI,SAA8B;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,yBAAyB,CAAwC;IACzE,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,GAAE,4BAAiC;cAyErC,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjE,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;YAMR,mBAAmB;IAYjC,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,aAAa;YAoBP,WAAW;IA4EzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,gBAAgB;YAIV,WAAW;IAoDzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,kBAAkB;IAkB1B;;;;;OAKG;YACW,gBAAgB;YAoDhB,gBAAgB;IAmC9B,OAAO,CAAC,WAAW;IAUnB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsChC"}

package/dist/index.cjs

@@ -2081,13 +2081,15 @@ var ModelSpanTracker = class {
 		if (!this.#currentInferenceSpan) return;
 		const { usage: rawUsage, ...otherOutput } = payload.output;
 		const usage = extractUsageMetrics(rawUsage, payload.metadata?.providerMetadata);
+		const responseModel = typeof payload.metadata?.modelId === "string" ? payload.metadata.modelId : void 0;
 		this.#currentInferenceSpan.end({
 			output: otherOutput,
 			attributes: {
 				usage,
 				finishReason: payload.stepResult.reason,
 				warnings: payload.stepResult.warnings,
-				completionStartTime: this.#completionStartTime
+				completionStartTime: this.#completionStartTime,
+				...responseModel?.trim() ? { responseModel } : {}
 			}
 		});
 		this.#currentInferenceSpan = void 0;
@@ -5201,15 +5203,15 @@ function isAuthFailureError(error) {
 function isAuthFailureStatus(status) {
 	return AUTH_FAILURE_STATUSES.has(status);
 }
-async function fetchWithAuthFailureHandling(url, options, maxRetries) {
+async function fetchWithAuthFailureHandling(url, options, maxRetries, callerShouldRetry) {
 	let authFailureStatus;
 	try {
-		await (0, _mastra_core_utils.fetchWithRetry)(url, options, maxRetries, { shouldRetryResponse: (response) => {
+		return await (0, _mastra_core_utils.fetchWithRetry)(url, options, maxRetries, { shouldRetryResponse: (response) => {
 			if (isAuthFailureStatus(response.status)) {
 				authFailureStatus = response.status;
 				return false;
 			}
-			return true;
+			return callerShouldRetry?.(response) ?? true;
 		} });
 	} catch (error) {
 		if (authFailureStatus !== void 0) throw new AuthFailureError(authFailureStatus, error);
@@ -6339,6 +6341,25 @@ const SIGNAL_PUBLISH_SUFFIXES = {
 	feedback: "/feedback/publish"
 };
 const DEFAULT_PLATFORM_SPAN_FILTER = (span) => span.type !== _mastra_core_observability.SpanType.MODEL_CHUNK;
+const QUOTA_EXCEEDED_STATUS = 402;
+const OBSERVABILITY_STATUS_HEADER = "x-mastra-observability";
+const OBSERVABILITY_DISABLED_VALUE = "disabled";
+const OBSERVABILITY_RETRY_AFTER_HEADER = "x-mastra-observability-retry-after";
+const DEFAULT_QUOTA_PROBE_INTERVAL_SECONDS = 300;
+const MAX_QUOTA_PROBE_INTERVAL_SECONDS = Math.floor(2147483647 / 1e3);
+function isObservabilityDisabled(response) {
+	return response.headers.get(OBSERVABILITY_STATUS_HEADER) === OBSERVABILITY_DISABLED_VALUE;
+}
+function isQuotaExceededResponse(response) {
+	return response.status === QUOTA_EXCEEDED_STATUS || isObservabilityDisabled(response);
+}
+function parseQuotaRetryAfterSeconds(response) {
+	const raw = response.headers.get(OBSERVABILITY_RETRY_AFTER_HEADER);
+	if (!raw || !/^\d+$/.test(raw.trim())) return DEFAULT_QUOTA_PROBE_INTERVAL_SECONDS;
+	const parsed = Number.parseInt(raw, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) return DEFAULT_QUOTA_PROBE_INTERVAL_SECONDS;
+	return Math.min(parsed, MAX_QUOTA_PROBE_INTERVAL_SECONDS);
+}
 const SIGNAL_PUBLISH_SEGMENTS = {
 	traces: "spans",
 	logs: "logs",
@@ -6428,6 +6449,10 @@ var MastraPlatformExporter = class extends BaseExporter {
 	buffer;
 	flushTimer = null;
 	inFlightFlushes = /* @__PURE__ */ new Set();
+	quotaPaused = false;
+	quotaProbeTimer = null;
+	quotaProbeIntervalSeconds = DEFAULT_QUOTA_PROBE_INTERVAL_SECONDS;
+	shuttingDown = false;
 	constructor(config = {}) {
 		super(config);
 		if (config.projectId !== void 0 && !VALID_PROJECT_ID.test(config.projectId)) throw createInvalidProjectIdError(config.projectId);
@@ -6476,31 +6501,31 @@ var MastraPlatformExporter = class extends BaseExporter {
 	async _exportTracingEvent(event) {
 		if (event.type !== _mastra_core_observability.TracingEventType.SPAN_ENDED) return;
 		if (!DEFAULT_PLATFORM_SPAN_FILTER(event.exportedSpan)) return;
-		if (this.authFailureCooldown.dropEventIfCoolingDown()) return;
+		if (this.quotaPaused || this.authFailureCooldown.dropEventIfCoolingDown()) return;
 		this.addToBuffer(event);
 		await this.handleBufferedEvent();
 	}
 	async onLogEvent(event) {
 		if (this.isDisabled) return;
-		if (this.authFailureCooldown.dropEventIfCoolingDown()) return;
+		if (this.quotaPaused || this.authFailureCooldown.dropEventIfCoolingDown()) return;
 		this.addLogToBuffer(event);
 		await this.handleBufferedEvent();
 	}
 	async onMetricEvent(event) {
 		if (this.isDisabled) return;
-		if (this.authFailureCooldown.dropEventIfCoolingDown()) return;
+		if (this.quotaPaused || this.authFailureCooldown.dropEventIfCoolingDown()) return;
 		this.addMetricToBuffer(event);
 		await this.handleBufferedEvent();
 	}
 	async onScoreEvent(event) {
 		if (this.isDisabled) return;
-		if (this.authFailureCooldown.dropEventIfCoolingDown()) return;
+		if (this.quotaPaused || this.authFailureCooldown.dropEventIfCoolingDown()) return;
 		this.addScoreToBuffer(event);
 		await this.handleBufferedEvent();
 	}
 	async onFeedbackEvent(event) {
 		if (this.isDisabled) return;
-		if (this.authFailureCooldown.dropEventIfCoolingDown()) return;
+		if (this.quotaPaused || this.authFailureCooldown.dropEventIfCoolingDown()) return;
 		this.addFeedbackToBuffer(event);
 		await this.handleBufferedEvent();
 	}
@@ -6590,6 +6615,10 @@ var MastraPlatformExporter = class extends BaseExporter {
 			this.flushTimer = null;
 		}
 		if (this.buffer.totalSize === 0) return;
+		if (this.quotaPaused) {
+			this.resetBuffer();
+			return;
+		}
 		if (this.authFailureCooldown.dropEventsIfCoolingDown(this.buffer.totalSize)) {
 			this.resetBuffer();
 			return;
@@ -6639,11 +6668,16 @@ var MastraPlatformExporter = class extends BaseExporter {
 	/**
 	* Uploads a signal batch to the configured Mastra Observability API using fetchWithRetry.
 	*/
-	async batchUpload(signal, records) {
-		const headers = {
+	buildPublishHeaders() {
+		return {
 			Authorization: `Bearer ${this.platformConfig.accessToken}`,
 			"Content-Type": "application/json"
 		};
+	}
+	buildPublishBody(signal, records) {
+		return JSON.stringify({ [SIGNAL_PUBLISH_SEGMENTS[signal]]: records });
+	}
+	async batchUpload(signal, records) {
 		const endpointMap = {
 			traces: this.platformConfig.tracesEndpoint,
 			logs: this.platformConfig.logsEndpoint,
@@ -6653,10 +6687,85 @@ var MastraPlatformExporter = class extends BaseExporter {
 		};
 		const options = {
 			method: "POST",
-			headers,
-			body: JSON.stringify({ [SIGNAL_PUBLISH_SEGMENTS[signal]]: records })
+			headers: this.buildPublishHeaders(),
+			body: this.buildPublishBody(signal, records)
 		};
-		await fetchWithAuthFailureHandling(endpointMap[signal], options, this.platformConfig.maxRetries);
+		let quotaResponse;
+		let response;
+		try {
+			response = await fetchWithAuthFailureHandling(endpointMap[signal], options, this.platformConfig.maxRetries, (res) => {
+				if (isQuotaExceededResponse(res)) {
+					quotaResponse = res;
+					return false;
+				}
+				return true;
+			});
+		} catch (error) {
+			if (quotaResponse) {
+				this.enterQuotaPause(parseQuotaRetryAfterSeconds(quotaResponse));
+				return;
+			}
+			throw error;
+		}
+		if (isObservabilityDisabled(response)) this.enterQuotaPause(parseQuotaRetryAfterSeconds(response));
+	}
+	/**
+	* Enter the quota-exhausted paused state: drop buffered events, stop the
+	* flush timer, and start probing until the collector stops rejecting with
+	* 402. The gate is per-org, so a signal on any publish route pauses all
+	* five signal types.
+	*/
+	enterQuotaPause(retryAfterSeconds) {
+		this.quotaProbeIntervalSeconds = retryAfterSeconds;
+		if (this.quotaPaused) return;
+		this.quotaPaused = true;
+		if (this.flushTimer) {
+			clearTimeout(this.flushTimer);
+			this.flushTimer = null;
+		}
+		this.resetBuffer();
+		this.logger.warn(`Mastra observability paused: quota exhausted, dropping telemetry and probing every ${retryAfterSeconds}s`);
+		this.scheduleQuotaProbe();
+	}
+	scheduleQuotaProbe() {
+		if (this.shuttingDown) return;
+		if (this.quotaProbeTimer) clearTimeout(this.quotaProbeTimer);
+		this.quotaProbeTimer = setTimeout(() => {
+			this.quotaProbeTimer = null;
+			this.probeQuotaStatus();
+		}, this.quotaProbeIntervalSeconds * 1e3);
+		this.quotaProbeTimer.unref?.();
+	}
+	/**
+	* Send an empty spans batch as a free probe. The collector treats an empty
+	* batch as a no-op, and an exhausted org still gets the 402 on it. A 402
+	* throws out of fetchWithRetry without the Response, so the retry predicate
+	* captures it to keep the retry-after hint.
+	*/
+	async probeQuotaStatus() {
+		if (this.shuttingDown || !this.quotaPaused) return;
+		let quotaResponse;
+		try {
+			const response = await (0, _mastra_core_utils.fetchWithRetry)(this.platformConfig.tracesEndpoint, {
+				method: "POST",
+				headers: this.buildPublishHeaders(),
+				body: this.buildPublishBody("traces", [])
+			}, 1, { shouldRetryResponse: (res) => {
+				if (isQuotaExceededResponse(res)) quotaResponse = res;
+				return false;
+			} });
+			if (this.shuttingDown) return;
+			if (!isObservabilityDisabled(response)) {
+				this.quotaPaused = false;
+				this.quotaProbeIntervalSeconds = DEFAULT_QUOTA_PROBE_INTERVAL_SECONDS;
+				this.logger.warn("Mastra observability resumed: quota restored, exports re-enabled");
+				return;
+			}
+			this.quotaProbeIntervalSeconds = parseQuotaRetryAfterSeconds(response);
+		} catch {
+			if (quotaResponse) this.quotaProbeIntervalSeconds = parseQuotaRetryAfterSeconds(quotaResponse);
+		}
+		this.scheduleQuotaProbe();
 	}
 	async flushSignalBatch(signal, records) {
 		if (records.length === 0) return {
@@ -6724,11 +6833,16 @@ var MastraPlatformExporter = class extends BaseExporter {
 		}
 	}
 	async shutdown() {
+		this.shuttingDown = true;
 		if (this.isDisabled) return;
 		if (this.flushTimer) {
 			clearTimeout(this.flushTimer);
 			this.flushTimer = null;
 		}
+		if (this.quotaProbeTimer) {
+			clearTimeout(this.quotaProbeTimer);
+			this.quotaProbeTimer = null;
+		}
 		try {
 			await this.flush();
 		} catch (error) {