@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

package/dist/analytics.js

@@ -0,0 +1,162 @@
+import path from "path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import os from "os";
+import { PostHog } from "posthog-node";
+//#region src/analytics.ts
+const POSTHOG_API_KEY = "phc_SBLpZVAB6jmHOct9CABq3PF0Yn5FU3G2FgT4xUr2XrT";
+const POSTHOG_HOST = "https://us.posthog.com";
+const MASTRA_SOURCE = "mastracode";
+const TRUTHY_DISABLED_VALUES = /* @__PURE__ */ new Set([
+	"1",
+	"true",
+	"yes",
+	"on"
+]);
+const ANALYTICS_CONFIG_PATH = path.join(os.homedir(), ".mastracode", "analytics.json");
+function createMastraAnalyticsDistinctId() {
+	return `mastra-${globalThis.crypto.randomUUID()}`;
+}
+function isHostnameDerivedDistinctId(distinctId, hostname = os.hostname()) {
+	return distinctId === `mastra-${hostname}`;
+}
+function isValidMastraAnalyticsDistinctId(distinctId) {
+	return /^mastra-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(distinctId);
+}
+function writeAnalyticsConfig(distinctId, configPath = ANALYTICS_CONFIG_PATH) {
+	try {
+		mkdirSync(path.dirname(configPath), { recursive: true });
+		writeFileSync(configPath, JSON.stringify({ distinctId }));
+	} catch {}
+}
+function getMastraAnalyticsDistinctId(configPath = ANALYTICS_CONFIG_PATH) {
+	try {
+		if (existsSync(configPath)) {
+			const config = JSON.parse(readFileSync(configPath, "utf-8"));
+			if (config.distinctId && isValidMastraAnalyticsDistinctId(config.distinctId) && !isHostnameDerivedDistinctId(config.distinctId)) return config.distinctId;
+		}
+	} catch {}
+	const distinctId = createMastraAnalyticsDistinctId();
+	writeAnalyticsConfig(distinctId, configPath);
+	return distinctId;
+}
+function isAnalyticsDebugEnabled() {
+	return TRUTHY_DISABLED_VALUES.has(process.env.MASTRACODE_ANALYTICS_DEBUG?.trim().toLowerCase() ?? "");
+}
+function debugAnalytics(message, properties) {
+	if (!isAnalyticsDebugEnabled()) return;
+	const suffix = properties ? ` ${JSON.stringify(properties)}` : "";
+	process.stderr.write(`[mastracode analytics] ${message}${suffix}\n`);
+}
+var NoopMastraCodeAnalytics = class {
+	capture(event) {
+		debugAnalytics("capture skipped: telemetry disabled", { event });
+	}
+	trackCommand(command) {
+		debugAnalytics("command skipped: telemetry disabled", { command });
+	}
+	trackInteractivePrompt(promptType) {
+		debugAnalytics("interactive prompt skipped: telemetry disabled", { promptType });
+	}
+	async shutdown() {
+		debugAnalytics("shutdown skipped: telemetry disabled");
+	}
+	isEnabled() {
+		return false;
+	}
+};
+var PostHogMastraCodeAnalytics = class {
+	client;
+	distinctId;
+	sessionId = globalThis.crypto.randomUUID();
+	version;
+	constructor({ version, apiKey = POSTHOG_API_KEY, host = POSTHOG_HOST }) {
+		this.version = version;
+		this.distinctId = getMastraAnalyticsDistinctId();
+		this.client = new PostHog(apiKey, {
+			host,
+			flushAt: 1,
+			flushInterval: 0,
+			disableGeoip: false
+		});
+		this.client.register({ mastraSource: MASTRA_SOURCE });
+		debugAnalytics("enabled", {
+			host,
+			distinctId: this.distinctId,
+			version
+		});
+	}
+	capture(event, properties) {
+		try {
+			const eventProperties = {
+				...this.getBaseProperties(),
+				...properties
+			};
+			debugAnalytics("capture", {
+				event,
+				properties: eventProperties
+			});
+			this.client.capture({
+				distinctId: this.distinctId,
+				event,
+				properties: eventProperties
+			});
+		} catch (error) {
+			debugAnalytics("capture failed", {
+				event,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	trackCommand(command, properties) {
+		this.capture("mastracode_command_used", {
+			command,
+			...properties
+		});
+	}
+	trackInteractivePrompt(promptType, properties) {
+		this.capture("mastracode_interactive_prompt_shown", {
+			promptType,
+			...properties
+		});
+	}
+	async shutdown() {
+		try {
+			debugAnalytics("shutdown start");
+			await this.client.shutdown();
+			debugAnalytics("shutdown complete");
+		} catch (error) {
+			debugAnalytics("shutdown failed", { error: error instanceof Error ? error.message : String(error) });
+		}
+	}
+	isEnabled() {
+		return true;
+	}
+	getBaseProperties() {
+		return {
+			mastraSource: MASTRA_SOURCE,
+			sessionId: this.sessionId,
+			version: this.version,
+			os: process.platform,
+			osVersion: os.release(),
+			nodeVersion: process.version,
+			platform: process.arch,
+			machineId: os.hostname()
+		};
+	}
+};
+function isTelemetryDisabled(env = process.env) {
+	const value = env.MASTRA_TELEMETRY_DISABLED;
+	if (!value) return false;
+	return TRUTHY_DISABLED_VALUES.has(value.trim().toLowerCase());
+}
+function createMastraCodeAnalytics(options) {
+	if (isTelemetryDisabled()) {
+		debugAnalytics("disabled by MASTRA_TELEMETRY_DISABLED", { value: process.env.MASTRA_TELEMETRY_DISABLED });
+		return new NoopMastraCodeAnalytics();
+	}
+	return new PostHogMastraCodeAnalytics(options);
+}
+//#endregion
+export { createMastraCodeAnalytics, getMastraAnalyticsDistinctId, isTelemetryDisabled };
+
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","names":[],"sources":["../src/analytics.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { PostHog } from 'posthog-node';\n\nconst POSTHOG_API_KEY = 'phc_SBLpZVAB6jmHOct9CABq3PF0Yn5FU3G2FgT4xUr2XrT';\nconst POSTHOG_HOST = 'https://us.posthog.com';\nconst MASTRA_SOURCE = 'mastracode';\nconst TRUTHY_DISABLED_VALUES = new Set(['1', 'true', 'yes', 'on']);\nconst ANALYTICS_CONFIG_PATH = path.join(os.homedir(), '.mastracode', 'analytics.json');\n\ninterface AnalyticsConfig {\n  distinctId?: string;\n}\n\nfunction createMastraAnalyticsDistinctId(): string {\n  return `mastra-${globalThis.crypto.randomUUID()}`;\n}\n\nfunction isHostnameDerivedDistinctId(distinctId: string, hostname = os.hostname()): boolean {\n  return distinctId === `mastra-${hostname}`;\n}\n\nfunction isValidMastraAnalyticsDistinctId(distinctId: string): boolean {\n  return /^mastra-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(distinctId);\n}\n\nfunction writeAnalyticsConfig(distinctId: string, configPath = ANALYTICS_CONFIG_PATH): void {\n  try {\n    mkdirSync(path.dirname(configPath), { recursive: true });\n    writeFileSync(configPath, JSON.stringify({ distinctId }));\n  } catch {\n    // swallow analytics persistence errors\n  }\n}\n\nexport function getMastraAnalyticsDistinctId(configPath = ANALYTICS_CONFIG_PATH): string {\n  try {\n    if (existsSync(configPath)) {\n      const config = JSON.parse(readFileSync(configPath, 'utf-8')) as AnalyticsConfig;\n      if (\n        config.distinctId &&\n        isValidMastraAnalyticsDistinctId(config.distinctId) &&\n        !isHostnameDerivedDistinctId(config.distinctId)\n      ) {\n        return config.distinctId;\n      }\n    }\n  } catch {\n    // regenerate below\n  }\n\n  const distinctId = createMastraAnalyticsDistinctId();\n  writeAnalyticsConfig(distinctId, configPath);\n  return distinctId;\n}\n\nfunction isAnalyticsDebugEnabled(): boolean {\n  return TRUTHY_DISABLED_VALUES.has(process.env.MASTRACODE_ANALYTICS_DEBUG?.trim().toLowerCase() ?? '');\n}\n\nfunction debugAnalytics(message: string, properties?: Record<string, unknown>): void {\n  if (!isAnalyticsDebugEnabled()) {\n    return;\n  }\n\n  const suffix = properties ? ` ${JSON.stringify(properties)}` : '';\n  process.stderr.write(`[mastracode analytics] ${message}${suffix}\\n`);\n}\n\nexport type MastraCodeAnalyticsEvent =\n  | 'mastracode_session_started'\n  | 'mastracode_prompt_submitted'\n  | 'mastracode_thread_changed'\n  | 'mastracode_model_changed'\n  | 'mastracode_command_used'\n  | 'mastracode_interactive_prompt_shown';\n\nexport interface MastraCodeAnalytics {\n  capture(event: MastraCodeAnalyticsEvent, properties?: Record<string, unknown>): void;\n  trackCommand(command: string, properties?: Record<string, unknown>): void;\n  trackInteractivePrompt(promptType: string, properties?: Record<string, unknown>): void;\n  shutdown(): Promise<void>;\n  isEnabled(): boolean;\n}\n\ninterface MastraCodeAnalyticsOptions {\n  version: string;\n  host?: string;\n  apiKey?: string;\n}\n\nclass NoopMastraCodeAnalytics implements MastraCodeAnalytics {\n  capture(event: MastraCodeAnalyticsEvent): void {\n    debugAnalytics('capture skipped: telemetry disabled', { event });\n  }\n  trackCommand(command: string): void {\n    debugAnalytics('command skipped: telemetry disabled', { command });\n  }\n  trackInteractivePrompt(promptType: string): void {\n    debugAnalytics('interactive prompt skipped: telemetry disabled', { promptType });\n  }\n  async shutdown(): Promise<void> {\n    debugAnalytics('shutdown skipped: telemetry disabled');\n  }\n  isEnabled(): boolean {\n    return false;\n  }\n}\n\nclass PostHogMastraCodeAnalytics implements MastraCodeAnalytics {\n  private readonly client: PostHog;\n  private readonly distinctId: string;\n  private readonly sessionId = globalThis.crypto.randomUUID();\n  private readonly version: string;\n\n  constructor({ version, apiKey = POSTHOG_API_KEY, host = POSTHOG_HOST }: MastraCodeAnalyticsOptions) {\n    this.version = version;\n    this.distinctId = getMastraAnalyticsDistinctId();\n    this.client = new PostHog(apiKey, {\n      host,\n      flushAt: 1,\n      flushInterval: 0,\n      disableGeoip: false,\n    });\n    this.client.register({ mastraSource: MASTRA_SOURCE });\n    debugAnalytics('enabled', { host, distinctId: this.distinctId, version });\n  }\n\n  capture(event: MastraCodeAnalyticsEvent, properties?: Record<string, unknown>): void {\n    try {\n      const eventProperties = {\n        ...this.getBaseProperties(),\n        ...properties,\n      };\n      debugAnalytics('capture', { event, properties: eventProperties });\n      this.client.capture({\n        distinctId: this.distinctId,\n        event,\n        properties: eventProperties,\n      });\n    } catch (error) {\n      debugAnalytics('capture failed', { event, error: error instanceof Error ? error.message : String(error) });\n      // swallow analytics errors\n    }\n  }\n\n  trackCommand(command: string, properties?: Record<string, unknown>): void {\n    this.capture('mastracode_command_used', { command, ...properties });\n  }\n\n  trackInteractivePrompt(promptType: string, properties?: Record<string, unknown>): void {\n    this.capture('mastracode_interactive_prompt_shown', { promptType, ...properties });\n  }\n\n  async shutdown(): Promise<void> {\n    try {\n      debugAnalytics('shutdown start');\n      await this.client.shutdown();\n      debugAnalytics('shutdown complete');\n    } catch (error) {\n      debugAnalytics('shutdown failed', { error: error instanceof Error ? error.message : String(error) });\n      // swallow analytics errors\n    }\n  }\n\n  isEnabled(): boolean {\n    return true;\n  }\n\n  private getBaseProperties(): Record<string, unknown> {\n    return {\n      mastraSource: MASTRA_SOURCE,\n      sessionId: this.sessionId,\n      version: this.version,\n      os: process.platform,\n      osVersion: os.release(),\n      nodeVersion: process.version,\n      platform: process.arch,\n      machineId: os.hostname(),\n    };\n  }\n}\n\nexport function isTelemetryDisabled(env: NodeJS.ProcessEnv = process.env): boolean {\n  const value = env.MASTRA_TELEMETRY_DISABLED;\n  if (!value) {\n    return false;\n  }\n\n  return TRUTHY_DISABLED_VALUES.has(value.trim().toLowerCase());\n}\n\nexport function createMastraCodeAnalytics(options: MastraCodeAnalyticsOptions): MastraCodeAnalytics {\n  if (isTelemetryDisabled()) {\n    debugAnalytics('disabled by MASTRA_TELEMETRY_DISABLED', { value: process.env.MASTRA_TELEMETRY_DISABLED });\n    return new NoopMastraCodeAnalytics();\n  }\n\n  return new PostHogMastraCodeAnalytics(options);\n}\n"],"mappings":"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"}

package/dist/auth/account-rotation-processor.d.ts

@@ -0,0 +1,182 @@
+import type { ProcessAPIErrorArgs, ProcessInputArgs, ProcessInputResult, Processor } from '@mastra/core/processors';
+import type { CredentialStore } from './types.js';
+export declare const ACCOUNT_SWITCH_PART_TYPE = "data-mastracode-account-switch";
+/** Labels and instance ids only — never token material (do-not list). */
+export interface AccountSwitchPartData {
+    provider: string;
+    from: {
+        id: string;
+        label: string;
+    } | null;
+    to: {
+        id: string;
+        label: string;
+    } | null;
+    reason: 'rate-limit' | 'quota-exhausted' | 'auth-failed' | 'pool-exhausted' | 'persistent-outage' | 'preferred-routing';
+    at: string;
+    /**
+     * Set on a `to: null` part when a route pinned to a single account reported
+     * that account unusable. The provider's other subscriptions were never
+     * consulted (A12), so "all accounts unavailable" would misreport what
+     * happened.
+     */
+    exclusive?: boolean;
+}
+/** The store surface rotation needs; `AuthStorage` satisfies it structurally. */
+export type RotationCredentialStore = CredentialStore & {
+    /**
+     * Force one refresh of the active account's tokens regardless of expiry
+     * (401/403 path — a rejected-but-unexpired token usually means clock skew
+     * or a refresh race). `AuthStorage` provides it; deployed per-tenant stores
+     * don't, and the auth path degrades to plain rotation (which itself no-ops
+     * without registry methods).
+     */
+    forceRefreshActiveAccount?(providerId: string, accountInstanceId?: string): Promise<string | undefined>;
+};
+/** Persisted data-part type for a model-route hop. */
+export declare const MODEL_FALLBACK_PART_TYPE: "data-mastracode-model-fallback";
+/** Non-secret transcript payload for a model-route hop. */
+export interface ModelFallbackPartData {
+    from: {
+        entryId: string;
+        label: string;
+    };
+    to: {
+        entryId: string;
+        label: string;
+    };
+    reason: 'pool-exhausted' | 'persistent-outage';
+    at: string;
+}
+/** Session-state key set when account rotation advances the model route. */
+export declare const MODEL_FALLBACK_STATE_KEY: "mastracodePendingModelFallback";
+/** Payload written to session state under MODEL_FALLBACK_STATE_KEY. */
+export interface PendingModelFallback {
+    fromEntryId: string;
+    toEntryId: string;
+    toModelId: string;
+    threadId?: string;
+    reason: 'pool-exhausted' | 'persistent-outage';
+    at: string;
+}
+export type RotationClassification = {
+    kind: 'rotate';
+    reason: 'rate-limit' | 'quota-exhausted' | 'auth-failed';
+} | {
+    kind: 'hop';
+} | {
+    kind: 'never';
+};
+/**
+ * The locked Q7 taxonomy. 429/402/usage-limit rotate immediately (429 is not
+ * covered by any transient matcher, so it arrives here on first occurrence);
+ * 401/403 and `ProviderAuthRequiredError` rotate after one forced refresh;
+ * 5xx/network hop only when the transient retry budget is already spent (they
+ * reach this processor because `StreamErrorRetryProcessor` declined); 400 and
+ * everything unknown never touch the registry.
+ */
+export declare function classifyRotationError(error: unknown): RotationClassification;
+/** Provider id off a router model id: `mastracode/<provider>/<model>` or `<provider>/<model>`. */
+export declare function providerFromModelId(modelId: string): string | undefined;
+/**
+ * Identify the provider an error came from: the request URL's hostname
+ * (`APICallError.url`, cause chain included), falling back to the router
+ * model id. Unknown → undefined (caller treats as never-rotate).
+ */
+export declare function providerFromError(error: unknown): string | undefined;
+/** Friendly names for the part/notice copy (display only — never auth data). */
+export declare const PROVIDER_DISPLAY_NAMES: Record<string, string>;
+/** Validates untrusted `reason` values (e.g. persisted message parts). */
+export declare function isAccountSwitchReason(value: unknown): value is AccountSwitchPartData['reason'];
+/**
+ * One-line transcript copy for a switch part. Shared by the live `info`
+ * controller event (the TUI shows controller `info` events as transcript
+ * lines, and no message event carries data parts mid-run) and by the TUI's
+ * history rendering of the persisted part — one formatter, identical text.
+ */
+export declare function accountSwitchNoticeText(data: AccountSwitchPartData): string;
+/** Transcript line for a model-route hop; shared by the live info event and the TUI's history render. */
+export declare function modelFallbackNoticeText(data: ModelFallbackPartData): string;
+/**
+ * Whether a persisted model-fallback reason is one this build understands.
+ * `REASON_TEXT` also covers the account-switch reasons, so the notice text
+ * alone would happily render a foreign value such as `rate-limit` as a
+ * model-fallback reason; history parsed from another build's part must be
+ * rejected instead.
+ */
+export declare function isModelFallbackReason(value: unknown): value is ModelFallbackPartData['reason'];
+export type RoutingControllerContext = {
+    session?: {
+        modelId?: unknown;
+        modeId?: unknown;
+    };
+    threadId?: unknown;
+    getState?: () => Record<string, unknown>;
+    setState?: (updates: Record<string, unknown>) => Promise<void>;
+    getThreadSetting?: (key: string) => Promise<unknown>;
+    setThreadSetting?: (setting: {
+        key: string;
+        value: unknown;
+    }) => Promise<void>;
+    isThreadActive?: () => boolean;
+};
+export declare class AccountRotationProcessor implements Processor {
+    private readonly options;
+    readonly id: "mastracode-account-rotation";
+    constructor(options: {
+        credentialStore: RotationCredentialStore;
+        maxProcessorRetries: number;
+        settingsPath?: string;
+        /** The host has no modes, so per-mode thinking defaults never apply. */
+        modeless?: boolean;
+    });
+    processAPIError(args: ProcessAPIErrorArgs): Promise<{
+        retry: boolean;
+    }>;
+    /**
+     * Resolve the request's host-supplied model route once and cache the reachable
+     * prefix in processor state. Resolution mirrors getDynamicModel so a hop is
+     * never announced for an entry core cannot reach.
+     */
+    private getModelRouteCascade;
+    /**
+     * Q14 gate: 400/unknown/unattributable errors never advance routes. Core's
+     * fallback array advances on ANY thrown error except TripWire
+     * (llm-execution-step.ts), so when the session route has another entry and the
+     * current entry is non-last, a bare `retry: false` would silently hop on an
+     * error class the user excluded from hop triggers. TripWire is the only
+     * no-advance escape: the runner rethrows it and the fallback loop declines
+     * to advance. No chain (or already on the last entry) → return and let the
+     * plain `retry: false` surface the error exactly as before.
+     */
+    private gateChainHop;
+    /** Announce and persist the next model-route hop before core advances. */
+    private emitModelFallbackPart;
+    /**
+     * Pool done for this request: every instance recorded in the tried-set and
+     * a `to: null` part emitted. Returns `retry: false` so core's fallback
+     * array can hop to the next route entry (announced by `emitModelFallbackPart`).
+     * Silent on the account part when the provider has no registry at all —
+     * there are no accounts to declare unavailable, but the hop still applies.
+     */
+    private declarePoolUnavailable;
+}
+/**
+ * Applies the pack's preferred account route once per request, before the
+ * first model call. Without a route it only reloads the credential store so
+ * the request sees accounts changed by other processes.
+ *
+ * TYPE CONSTRAINT: this class must NEVER implement `processAPIError`. It
+ * lives in `inputProcessors`; the runner walks input processors first when
+ * running `processAPIError`, so adding the method here would classify and
+ * rotate errors BEFORE `StreamErrorRetryProcessor`'s transient retries run.
+ */
+export declare class AccountStartNoticeProcessor implements Processor {
+    private readonly options;
+    readonly id: "mastracode-account-start-notice";
+    constructor(options: {
+        credentialStore: CredentialStore;
+    });
+    processInput(args: ProcessInputArgs): Promise<ProcessInputResult>;
+}
+//# sourceMappingURL=account-rotation-processor.d.ts.map

package/dist/auth/account-rotation-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-rotation-processor.d.ts","sourceRoot":"","sources":["../../src/auth/account-rotation-processor.ts"],"names":[],"mappings":"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"}