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

package/dist/agents/model.js

@@ -0,0 +1,295 @@
+import "../constants.js";
+import { MASTRA_GATEWAY_PREFIX, normalizeLegacyModelId, remapOpenAIModelForCodexOAuth, stripMastraGatewayPrefix } from "../providers/model-ids.js";
+import { isThinkingLevelSetting } from "../thinking.js";
+import { ProviderAuthRequiredError } from "../auth/provider-auth-error.js";
+import { toMemoryModelId } from "../onboarding/packs.js";
+import { loadSettings, resolveDefaultThinkingLevel, stripMastraCodeCustomProviderPrefix } from "../onboarding/settings.js";
+import { hasCredentialStoreProvider, hasCredentialTenantResolver, prepareCredentialTenant, resolveCredentialScope, resolveCredentialStore, resolveTenantFromRequestContext, setCredentialStoreProvider } from "./credential-resolver.js";
+import { getRequestAccountSelection, isRequestAccountRoutingExhausted } from "../auth/account-routing-context.js";
+import { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from "../providers/amazon-bedrock-gateway.js";
+import { hasCustomProvidersSource, resolveCustomProviders, setCustomProvidersSource } from "./custom-provider-source.js";
+import { MASTRACODE_GATEWAY_ID, MastraCodeGateway, getAnthropicApiKey, getGlobalAuthStorage, getOpenAIApiKey, reloadAuthStorage, resolveAuth } from "./mastracode-gateway.js";
+import { ModelRouterLanguageModel } from "@mastra/core/llm";
+import { RequestContext } from "@mastra/core/request-context";
+//#region src/agents/model.ts
+function getAgentControllerHeaders(requestContext) {
+	const agentControllerContext = requestContext?.get("controller");
+	const headers = {
+		...agentControllerContext?.threadId ? { "x-thread-id": agentControllerContext.threadId } : {},
+		...agentControllerContext?.resourceId ? { "x-resource-id": agentControllerContext.resourceId } : {}
+	};
+	return Object.keys(headers).length > 0 ? headers : void 0;
+}
+function accountCredential(account) {
+	const { type: _type, id: _id, label: _label, addedAt: _addedAt, active: _active, ...credential } = account;
+	return {
+		type: "oauth",
+		...credential
+	};
+}
+function createRequestScopedCredentialStore(base, requestContext) {
+	const selectedId = (providerId) => getRequestAccountSelection(requestContext, providerId);
+	const selectedAccount = (providerId) => {
+		const accountInstanceId = selectedId(providerId);
+		return accountInstanceId ? base.listAccounts?.(providerId).find((account) => account.id === accountInstanceId) : void 0;
+	};
+	const rejectAll = (providerId) => isRequestAccountRoutingExhausted(requestContext, providerId);
+	return {
+		allowEnvironmentFallback: base.allowEnvironmentFallback,
+		reload: () => base.reload(),
+		get: (providerId) => {
+			if (rejectAll(providerId)) return void 0;
+			if (selectedId(providerId) === void 0) return base.get(providerId);
+			const selected = selectedAccount(providerId);
+			return selected ? accountCredential(selected) : void 0;
+		},
+		getStoredApiKey: (providerId) => {
+			if (rejectAll(providerId)) return void 0;
+			if (selectedId(providerId) !== void 0) return void 0;
+			return base.getStoredApiKey(providerId);
+		},
+		getApiKey: (providerId) => rejectAll(providerId) ? Promise.resolve(void 0) : base.getApiKey(providerId, selectedId(providerId)),
+		getOAuthCredential: base.getOAuthCredential ? (providerId) => rejectAll(providerId) ? Promise.resolve(void 0) : base.getOAuthCredential(providerId, selectedId(providerId)) : void 0,
+		listAccounts: base.listAccounts ? (providerId) => base.listAccounts(providerId) : void 0,
+		getActiveAccount: base.getActiveAccount ? (providerId) => base.getActiveAccount(providerId) : void 0,
+		activateAccount: base.activateAccount ? (providerId, accountInstanceId) => base.activateAccount(providerId, accountInstanceId) : void 0,
+		removeAccount: base.removeAccount ? (providerId, accountInstanceId) => base.removeAccount(providerId, accountInstanceId) : void 0
+	};
+}
+function createMastraCodeGateway(options) {
+	return new MastraCodeGateway(options);
+}
+function createMastraCodeModelCatalogProvider(gateway) {
+	return gateway instanceof MastraCodeGateway ? gateway.createModelCatalogProvider() : MastraCodeGateway.createModelCatalogProvider(gateway);
+}
+/**
+* Placeholder for future model ID normalization.
+* Currently returns the input unchanged, but exists as a seam
+* for aliasing, casing fixes, or validation in the future.
+*/
+function resolveModelId(modelId) {
+	return modelId;
+}
+/**
+* Resolve a model ID to the correct provider instance.
+* Shared by the main agent, observer, and reflector.
+*
+* - For anthropic/* models: Uses stored OAuth credentials when present, otherwise direct API key
+* - For openai/* models: Uses OAuth when configured, otherwise direct API key from AuthStorage
+* - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint
+* - For all other providers: Uses Mastra's model router (models.dev gateway)
+*/
+function resolveModel(modelId, options) {
+	if (!hasCredentialTenantResolver()) return resolveModelForRequest(modelId, options);
+	const createRequestModel = () => {
+		const requestContext = options?.requestContext ? new RequestContext(options.requestContext.entries()) : void 0;
+		return new ModelRouterLanguageModel({ id: `${MASTRACODE_GATEWAY_ID}/${modelId}` }, [{
+			id: MASTRACODE_GATEWAY_ID,
+			name: "Request-scoped MastraCode",
+			fetchProviders: async () => ({}),
+			buildUrl: () => void 0,
+			getApiKey: async () => "",
+			resolveAuth: () => ({ apiKey: "request-scoped" }),
+			resolveLanguageModel: async () => {
+				await prepareCredentialTenant(requestContext);
+				return resolveModelForRequest(modelId, {
+					...options,
+					requestContext
+				});
+			}
+		}]);
+	};
+	let currentModel = createRequestModel();
+	return new Proxy(currentModel, { get(_target, property) {
+		if (property === "supportedUrls") return createRequestModel().supportedUrls;
+		if (property === "doStream" || property === "doGenerate") return async (...args) => {
+			const refreshed = createRequestModel();
+			currentModel = refreshed;
+			return Reflect.apply(Reflect.get(refreshed, property), refreshed, args);
+		};
+		const value = Reflect.get(currentModel, property, currentModel);
+		return typeof value === "function" ? value.bind(currentModel) : value;
+	} });
+}
+function resolveModelForRequest(modelId, options) {
+	reloadAuthStorage();
+	const headers = getAgentControllerHeaders(options?.requestContext);
+	const settings = loadSettings();
+	const legacyNormalizedInput = normalizeLegacyModelId(modelId);
+	const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;
+	const normalizedInput = stripMastraCodeCustomProviderPrefix(legacyNormalizedInput, customProviders);
+	const isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);
+	const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);
+	const [providerId, ...modelParts] = normalizedModelId.split("/");
+	const bareModelId = modelParts.join("/");
+	if (!providerId || !bareModelId) throw new Error(`Invalid model id: ${modelId}`);
+	const tenantCredentialStore = resolveCredentialStore(options?.requestContext);
+	const baseCredentialStore = tenantCredentialStore ?? getGlobalAuthStorage();
+	if (providerId === "amazon-bedrock") {
+		if (tenantCredentialStore?.allowEnvironmentFallback === false && !tenantCredentialStore.allowsDeploymentCredentials?.("amazon-bedrock")) throw new ProviderAuthRequiredError("Amazon Bedrock is not enabled for this Factory deployment. The operator must provide AWS credentials to the server and set FACTORY_DEPLOYMENT_MODEL_PROVIDERS=amazon-bedrock.");
+		const bedrockGateway = createAmazonBedrockGateway();
+		const routerId = `${AMAZON_BEDROCK_GATEWAY_ID}/${bareModelId}`;
+		const auth = bedrockGateway.resolveAuth({
+			gatewayId: AMAZON_BEDROCK_GATEWAY_ID,
+			providerId: AMAZON_BEDROCK_GATEWAY_ID,
+			modelId: bareModelId,
+			routerId
+		});
+		return bedrockGateway.resolveLanguageModel({
+			providerId: AMAZON_BEDROCK_GATEWAY_ID,
+			modelId: bareModelId,
+			apiKey: auth?.apiKey ?? "",
+			headers
+		});
+	}
+	const routerId = `${MASTRACODE_GATEWAY_ID}/${normalizedModelId}`;
+	const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();
+	const rawGatewayBase = settings.memoryGateway?.baseUrl ?? process.env["MASTRA_GATEWAY_URL"] ?? "https://gateway-api.mastra.ai";
+	const credentialStore = createRequestScopedCredentialStore(baseCredentialStore, options?.requestContext);
+	const gateway = createMastraCodeGateway({
+		mastraGatewayBaseUrl: rawGatewayBase.replace(/\/+$/, "").replace(/\/v1$/, ""),
+		mastraGatewayApiKey: mgApiKey,
+		routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),
+		thinkingLevel: options?.thinkingLevel,
+		anthropicPromptCacheScope: options?.anthropicPromptCacheScope,
+		customProviders,
+		credentialStore
+	});
+	const auth = gateway.resolveAuth({
+		gatewayId: MASTRACODE_GATEWAY_ID,
+		providerId,
+		modelId: bareModelId,
+		routerId
+	});
+	if (!auth && credentialStore?.allowEnvironmentFallback === false) throw new ProviderAuthRequiredError(resolveCredentialScope(options?.requestContext) === "factory" ? `No usable ${providerId} credential is available. This Factory uses organization credentials only, so personal provider sign-ins don't apply. Add an organization credential, then try again.` : `No usable ${providerId} credential is available. This Factory uses personal credentials only, so organization credentials don't apply. Connect the provider, then try again.`);
+	return gateway.resolveLanguageModel({
+		providerId,
+		modelId: bareModelId,
+		apiKey: auth?.apiKey ?? "",
+		headers
+	});
+}
+/**
+* Resolve the effective thinking level for the current request.
+*
+* Precedence:
+*   1. Session override (`state.thinkingLevel`, set via /think or the session
+*      settings panel).
+*   2. Per-mode default from settings (`models.modeThinkingDefaults[mode]`),
+*      only when the context carries a session mode.
+*   3. Global default (`preferences.thinkingLevel`).
+*
+* Resolved per-request (not seeded at session start) so configuration changes
+* apply to the next request of every session — including automated
+* (rule-driven) Factory runs that nobody ever opens interactively.
+*/
+function resolveRequestThinkingLevel(agentControllerContext, settingsPath) {
+	const override = agentControllerContext?.state?.thinkingLevel;
+	if (isThinkingLevelSetting(override)) return override;
+	const modeId = agentControllerContext?.session?.modeId;
+	return resolveDefaultThinkingLevel(loadSettings(settingsPath), modeId).level;
+}
+/**
+* Dynamic model function that reads the current model and optional ordered
+* fallback route from controller state. Route entry ids are opaque host-owned
+* identifiers; repeated ids receive occurrence suffixes because core tracks the
+* active fallback index by id across agentic steps.
+*/
+function getDynamicModel({ requestContext }, settingsPath, { modeless = false } = {}) {
+	const controller = requestContext.get("controller");
+	const state = controller?.getState?.();
+	const pendingState = state?.mastracodePendingModelFallback;
+	const pendingFallback = pendingState && (pendingState.threadId === void 0 || typeof pendingState.threadId === "string" && pendingState.threadId === controller?.threadId) ? pendingState : void 0;
+	const modelId = (pendingFallback && typeof pendingFallback.toModelId === "string" && pendingFallback.toModelId.length > 0 ? pendingFallback.toModelId : void 0) ?? controller?.session?.modelId;
+	if (!modelId) {
+		if (!controller) throw new Error("No model available: this run started without a controller session context, so no model selection could be resolved.");
+		throw new Error("No model selected. Use /models to select a model first.");
+	}
+	const resolveOptions = {
+		thinkingLevel: resolveRequestThinkingLevel(modeless ? { state: controller?.state } : controller, settingsPath),
+		remapForCodexOAuth: true,
+		requestContext
+	};
+	const primary = identifyModel(modelId, resolveModel(modelId, resolveOptions));
+	const route = state?.modelRoute?.entries?.slice(0, 32);
+	const pendingEntryId = pendingFallback && typeof pendingFallback.toEntryId === "string" ? pendingFallback.toEntryId : void 0;
+	const startIndex = pendingEntryId ? route?.findIndex((entry) => entry.id === pendingEntryId) : 0;
+	const activeRoute = route && startIndex !== void 0 && startIndex >= 0 ? route.slice(startIndex) : void 0;
+	if (!activeRoute || activeRoute.length < 2 || activeRoute[0]?.modelId !== modelId) return primary;
+	const firstId = typeof activeRoute[0]?.id === "string" && activeRoute[0].id.length > 0 ? activeRoute[0].id : void 0;
+	if (!firstId) return primary;
+	const entries = [{
+		id: firstId,
+		model: primary
+	}];
+	const appearances = /* @__PURE__ */ new Map([[firstId, 1]]);
+	for (const routeEntry of activeRoute.slice(1)) {
+		if (typeof routeEntry.id !== "string" || routeEntry.id.length === 0 || typeof routeEntry.modelId !== "string" || routeEntry.modelId.length === 0) break;
+		let entryModel;
+		try {
+			entryModel = resolveModel(routeEntry.modelId, resolveOptions);
+		} catch {
+			break;
+		}
+		const occurrence = (appearances.get(routeEntry.id) ?? 0) + 1;
+		appearances.set(routeEntry.id, occurrence);
+		entries.push({
+			id: occurrence === 1 ? routeEntry.id : `${routeEntry.id}#${occurrence}`,
+			model: identifyModel(routeEntry.modelId, entryModel)
+		});
+	}
+	return entries.length < 2 ? primary : entries;
+}
+function identifyModel(modelId, model) {
+	return {
+		model,
+		id: toMemoryModelId(modelId)
+	};
+}
+/**
+* The active model route for memory: the session route, starting at a pending
+* fallback hop captured for this thread.
+*/
+function getActiveMemoryRoute(state, threadId) {
+	const pending = state?.mastracodePendingModelFallback;
+	const sameThreadPending = pending && (pending.threadId === void 0 || pending.threadId === threadId) ? pending : void 0;
+	const routeEntries = state?.modelRoute?.entries?.slice(0, 32) ?? [];
+	const pendingIndex = sameThreadPending ? routeEntries.findIndex((entry) => entry.id === sameThreadPending.toEntryId) : -1;
+	return pendingIndex >= 0 ? routeEntries.slice(pendingIndex) : routeEntries;
+}
+/**
+* The memory model the active route applies to both OM roles: `'auto'`, the
+* first concrete memory model, or `undefined` when the route sets none (both
+* roles then follow their `/om` settings).
+*/
+function getActiveRouteMemoryModelId(state, threadId) {
+	const route = getActiveMemoryRoute(state, threadId);
+	if (route[0]?.memoryModelId === "auto") return "auto";
+	return route.find((candidate) => typeof candidate.memoryModelId === "string" && candidate.memoryModelId && candidate.memoryModelId !== "auto")?.memoryModelId;
+}
+/**
+* Goal judge model resolver for the agent's `goal.judge` config. Resolves the
+* configured goal judge model through mastracode's gateway so provider
+* credentials (stored in auth storage, not just env) are injected — a bare model
+* id handed to core's default model router would fail to find the API key.
+*
+* Returns `undefined` when no judge model is configured, which keeps the goal
+* step a complete no-op (the goal mechanism requires a judge to do anything).
+*
+* `settingsPath` must be the same source `createMastraCode()` reads from so the
+* judge model and the goal budget (`goalMaxTurns`) come from one config — with a
+* custom `settingsPath` a bare `loadSettings()` here could read a different file
+* and silently turn the goal step into a no-op.
+*/
+function getGoalJudgeModel({ requestContext }, settingsPath) {
+	const judgeModelId = loadSettings(settingsPath).models.goalJudgeModel;
+	if (!judgeModelId) return void 0;
+	return resolveModel(judgeModelId, {
+		remapForCodexOAuth: true,
+		requestContext
+	});
+}
+//#endregion
+export { MASTRACODE_GATEWAY_ID, MastraCodeGateway, createMastraCodeGateway, createMastraCodeModelCatalogProvider, createRequestScopedCredentialStore, getActiveMemoryRoute, getActiveRouteMemoryModelId, getAnthropicApiKey, getDynamicModel, getGoalJudgeModel, getOpenAIApiKey, hasCredentialStoreProvider, hasCustomProvidersSource, remapOpenAIModelForCodexOAuth, resolveAuth, resolveCustomProviders, resolveModel, resolveModelId, resolveRequestThinkingLevel, resolveTenantFromRequestContext, setCredentialStoreProvider, setCustomProvidersSource };
+
+//# sourceMappingURL=model.js.map

package/dist/agents/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","names":[],"sources":["../../src/agents/model.ts"],"sourcesContent":["import type { ModelWithRetries } from '@mastra/core/agent';\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport { ModelRouterLanguageModel } from '@mastra/core/llm';\nimport type { GatewayLanguageModel, IdentifiedModelConfig, MastraModelGatewayInterface } from '@mastra/core/llm';\nimport { RequestContext } from '@mastra/core/request-context';\nimport { getRequestAccountSelection, isRequestAccountRoutingExhausted } from '../auth/account-routing-context.js';\nimport { ProviderAuthRequiredError } from '../auth/provider-auth-error.js';\nimport type { CredentialStore, OAuthAccountRecord } from '../auth/types.js';\nimport { MODEL_ROUTE_MAX_ENTRIES } from '../constants.js';\nimport { toMemoryModelId } from '../onboarding/packs.js';\nimport {\n  loadSettings,\n  resolveDefaultThinkingLevel,\n  stripMastraCodeCustomProviderPrefix,\n} from '../onboarding/settings.js';\nimport { AMAZON_BEDROCK_GATEWAY_ID, createAmazonBedrockGateway } from '../providers/amazon-bedrock-gateway.js';\nimport type { AnthropicPromptCacheScope } from '../providers/anthropic-prompt-cache.js';\nimport { normalizeLegacyModelId } from '../providers/model-ids.js';\nimport { isThinkingLevelSetting } from '../thinking.js';\nimport type { ThinkingLevelSetting } from '../thinking.js';\nimport {\n  hasCredentialTenantResolver,\n  prepareCredentialTenant,\n  resolveCredentialScope,\n  resolveCredentialStore,\n} from './credential-resolver.js';\nimport { resolveCustomProviders } from './custom-provider-source.js';\nimport {\n  MASTRA_GATEWAY_PREFIX,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  getGlobalAuthStorage,\n  reloadAuthStorage,\n  stripMastraGatewayPrefix,\n} from './mastracode-gateway.js';\nimport type { MastraCodeGatewayOptions } from './mastracode-gateway.js';\n\nexport {\n  getAnthropicApiKey,\n  getOpenAIApiKey,\n  MASTRACODE_GATEWAY_ID,\n  MastraCodeGateway,\n  remapOpenAIModelForCodexOAuth,\n  resolveAuth,\n} from './mastracode-gateway.js';\nexport type { MastraCodeCustomProvider, MastraCodeGatewayOptions } from './mastracode-gateway.js';\nexport {\n  setCredentialStoreProvider,\n  hasCredentialStoreProvider,\n  resolveTenantFromRequestContext,\n} from './credential-resolver.js';\nexport type { CredentialTenant, CredentialStoreProvider } from './credential-resolver.js';\nexport {\n  setCustomProvidersSource,\n  hasCustomProvidersSource,\n  resolveCustomProviders,\n} from './custom-provider-source.js';\nexport type { CustomProvidersSource } from './custom-provider-source.js';\n\ntype ResolvedModel = GatewayLanguageModel | ModelRouterLanguageModel;\ntype ModelRequestHeaders = Record<string, string>;\n\nfunction getAgentControllerHeaders(requestContext?: RequestContext): ModelRequestHeaders | undefined {\n  const agentControllerContext = requestContext?.get('controller') as AgentControllerRequestContext<any> | undefined;\n  const headers = {\n    ...(agentControllerContext?.threadId ? { 'x-thread-id': agentControllerContext.threadId } : {}),\n    ...(agentControllerContext?.resourceId ? { 'x-resource-id': agentControllerContext.resourceId } : {}),\n  };\n\n  return Object.keys(headers).length > 0 ? headers : undefined;\n}\n\nfunction accountCredential(account: OAuthAccountRecord) {\n  const { type: _type, id: _id, label: _label, addedAt: _addedAt, active: _active, ...credential } = account;\n  return { type: 'oauth' as const, ...credential };\n}\n\nexport function createRequestScopedCredentialStore(\n  base: CredentialStore,\n  requestContext?: RequestContext,\n): CredentialStore {\n  const selectedId = (providerId: string) => getRequestAccountSelection(requestContext, providerId);\n  const selectedAccount = (providerId: string) => {\n    const accountInstanceId = selectedId(providerId);\n    return accountInstanceId\n      ? base.listAccounts?.(providerId).find(account => account.id === accountInstanceId)\n      : undefined;\n  };\n  // Routing rejected every account for this provider on this request. Fail\n  // closed on every credential read: falling through to `base` would use the\n  // provider's active account — the exhausted one routing just refused.\n  const rejectAll = (providerId: string) => isRequestAccountRoutingExhausted(requestContext, providerId);\n\n  return {\n    allowEnvironmentFallback: base.allowEnvironmentFallback,\n    reload: () => base.reload(),\n    get: providerId => {\n      if (rejectAll(providerId)) return undefined;\n      // A selection that no longer resolves (the account was removed between\n      // routing and the credential read) must not fall through to the active\n      // account — that is the account routing deliberately passed over.\n      const accountInstanceId = selectedId(providerId);\n      if (accountInstanceId === undefined) return base.get(providerId);\n      const selected = selectedAccount(providerId);\n      return selected ? accountCredential(selected) : undefined;\n    },\n    getStoredApiKey: providerId => {\n      if (rejectAll(providerId)) return undefined;\n      // The provider-wide `apikey:` slot is never the credential routing\n      // selected, so serving it to a routed request is an OAuth -> API-key\n      // fallback of the same provider — the one combination this feature\n      // forbids. Unlike `get`, this read has no account argument to pass\n      // through, so a selection fails it closed instead.\n      if (selectedId(providerId) !== undefined) return undefined;\n      return base.getStoredApiKey(providerId);\n    },\n    getApiKey: providerId =>\n      rejectAll(providerId) ? Promise.resolve(undefined) : base.getApiKey(providerId, selectedId(providerId)),\n    getOAuthCredential: base.getOAuthCredential\n      ? providerId =>\n          rejectAll(providerId)\n            ? Promise.resolve(undefined)\n            : base.getOAuthCredential!(providerId, selectedId(providerId))\n      : undefined,\n    listAccounts: base.listAccounts ? providerId => base.listAccounts!(providerId) : undefined,\n    getActiveAccount: base.getActiveAccount ? providerId => base.getActiveAccount!(providerId) : undefined,\n    activateAccount: base.activateAccount\n      ? (providerId, accountInstanceId) => base.activateAccount!(providerId, accountInstanceId)\n      : undefined,\n    removeAccount: base.removeAccount\n      ? (providerId, accountInstanceId) => base.removeAccount!(providerId, accountInstanceId)\n      : undefined,\n  };\n}\n\nexport function createMastraCodeGateway(options: MastraCodeGatewayOptions): MastraCodeGateway {\n  return new MastraCodeGateway(options);\n}\n\nexport function createMastraCodeModelCatalogProvider(gateway: MastraModelGatewayInterface) {\n  return gateway instanceof MastraCodeGateway\n    ? gateway.createModelCatalogProvider()\n    : MastraCodeGateway.createModelCatalogProvider(gateway);\n}\n\n/**\n * Placeholder for future model ID normalization.\n * Currently returns the input unchanged, but exists as a seam\n * for aliasing, casing fixes, or validation in the future.\n */\nexport function resolveModelId(modelId: string): string {\n  return modelId;\n}\n\n/**\n * Resolve a model ID to the correct provider instance.\n * Shared by the main agent, observer, and reflector.\n *\n * - For anthropic/* models: Uses stored OAuth credentials when present, otherwise direct API key\n * - For openai/* models: Uses OAuth when configured, otherwise direct API key from AuthStorage\n * - For moonshotai/* models: Uses Moonshot AI Anthropic-compatible endpoint\n * - For all other providers: Uses Mastra's model router (models.dev gateway)\n */\nexport function resolveModel(\n  modelId: string,\n  options?: {\n    thinkingLevel?: ThinkingLevelSetting;\n    remapForCodexOAuth?: boolean;\n    requestContext?: RequestContext;\n    anthropicPromptCacheScope?: AnthropicPromptCacheScope;\n  },\n): ResolvedModel {\n  if (!hasCredentialTenantResolver()) return resolveModelForRequest(modelId, options);\n  const createRequestModel = () => {\n    const requestContext = options?.requestContext ? new RequestContext(options.requestContext.entries()) : undefined;\n    // The router supplies stable SDK metadata and adapts whichever provider the refreshed policy selects.\n    // Each invocation owns its policy context and model cache, including concurrent OM and subagent calls.\n    return new ModelRouterLanguageModel({ id: `${MASTRACODE_GATEWAY_ID}/${modelId}` }, [\n      {\n        id: MASTRACODE_GATEWAY_ID,\n        name: 'Request-scoped MastraCode',\n        fetchProviders: async () => ({}),\n        buildUrl: () => undefined,\n        getApiKey: async () => '',\n        resolveAuth: () => ({ apiKey: 'request-scoped' }),\n        resolveLanguageModel: async () => {\n          await prepareCredentialTenant(requestContext);\n          return resolveModelForRequest(modelId, { ...options, requestContext });\n        },\n      },\n    ]);\n  };\n  let currentModel = createRequestModel();\n  return new Proxy(currentModel, {\n    get(_target, property) {\n      if (property === 'supportedUrls') return createRequestModel().supportedUrls;\n      if (property === 'doStream' || property === 'doGenerate') {\n        return async (...args: unknown[]) => {\n          const refreshed = createRequestModel();\n          currentModel = refreshed;\n          return Reflect.apply(Reflect.get(refreshed, property), refreshed, args);\n        };\n      }\n      const value = Reflect.get(currentModel, property, currentModel);\n      return typeof value === 'function' ? value.bind(currentModel) : value;\n    },\n  });\n}\n\nfunction resolveModelForRequest(modelId: string, options?: Parameters<typeof resolveModel>[1]): GatewayLanguageModel {\n  reloadAuthStorage();\n  const headers = getAgentControllerHeaders(options?.requestContext);\n  const settings = loadSettings();\n  // Older versions cataloged Bedrock, Copilot and Kimi under the MastraCode\n  // gateway namespace, and Kimi under its own `kimi-for-coding` provider. Map\n  // already-saved ids (packs, OM settings, thread metadata) to current ids.\n  const legacyNormalizedInput = normalizeLegacyModelId(modelId);\n  // Deployed web registers a custom providers source (DB-backed, tenant\n  // scoped); when registered it is authoritative and settings.json custom\n  // providers are ignored. Undefined = local settings-based behavior.\n  const customProviders = resolveCustomProviders(options?.requestContext) ?? settings.customProviders;\n  // Ids selected from the shared /models catalog were previously persisted in\n  // the gateway-qualified `mastracode/<customProviderId>/<model>` form, which\n  // parses the provider as `mastracode` and breaks provider config lookup.\n  // Normalize at resolution time (in addition to stripping at selection time)\n  // so already-saved ids and any surface that persists the raw catalog id\n  // still resolve to the custom provider.\n  const normalizedInput = stripMastraCodeCustomProviderPrefix(legacyNormalizedInput, customProviders);\n  const isMastraGatewayModel = normalizedInput.startsWith(MASTRA_GATEWAY_PREFIX);\n  const normalizedModelId = stripMastraGatewayPrefix(normalizedInput);\n  const [providerId, ...modelParts] = normalizedModelId.split('/');\n  const bareModelId = modelParts.join('/');\n  if (!providerId || !bareModelId) {\n    throw new Error(`Invalid model id: ${modelId}`);\n  }\n\n  // Deployed hosts resolve exactly the trusted policy's credential scope.\n  // Only local mode falls back to global AuthStorage.\n  const tenantCredentialStore = resolveCredentialStore(options?.requestContext);\n  const baseCredentialStore = tenantCredentialStore ?? getGlobalAuthStorage();\n\n  if (providerId === AMAZON_BEDROCK_GATEWAY_ID) {\n    // Bedrock authenticates through the server process's AWS credential chain,\n    // never a tenant credential. A tenant store only lets it through when the\n    // operator opted the deployment in.\n    if (\n      tenantCredentialStore?.allowEnvironmentFallback === false &&\n      !tenantCredentialStore.allowsDeploymentCredentials?.(AMAZON_BEDROCK_GATEWAY_ID)\n    ) {\n      throw new ProviderAuthRequiredError(\n        'Amazon Bedrock is not enabled for this Factory deployment. The operator must provide AWS credentials to the server and set FACTORY_DEPLOYMENT_MODEL_PROVIDERS=amazon-bedrock.',\n      );\n    }\n    const bedrockGateway = createAmazonBedrockGateway();\n    const routerId = `${AMAZON_BEDROCK_GATEWAY_ID}/${bareModelId}`;\n    const auth = bedrockGateway.resolveAuth({\n      gatewayId: AMAZON_BEDROCK_GATEWAY_ID,\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      routerId,\n    });\n    return bedrockGateway.resolveLanguageModel({\n      providerId: AMAZON_BEDROCK_GATEWAY_ID,\n      modelId: bareModelId,\n      apiKey: auth?.apiKey ?? '',\n      headers,\n    });\n  }\n\n  const routerId = `${MASTRACODE_GATEWAY_ID}/${normalizedModelId}`;\n\n  const mgApiKey = MastraCodeGateway.getMastraGatewayApiKey();\n  const rawGatewayBase =\n    settings.memoryGateway?.baseUrl ?? process.env['MASTRA_GATEWAY_URL'] ?? 'https://gateway-api.mastra.ai';\n  const credentialStore = createRequestScopedCredentialStore(baseCredentialStore, options?.requestContext);\n  const gateway = createMastraCodeGateway({\n    mastraGatewayBaseUrl: rawGatewayBase.replace(/\\/+$/, '').replace(/\\/v1$/, ''),\n    mastraGatewayApiKey: mgApiKey,\n    routeThroughMastraGateway: Boolean(mgApiKey && isMastraGatewayModel),\n    thinkingLevel: options?.thinkingLevel,\n    anthropicPromptCacheScope: options?.anthropicPromptCacheScope,\n    customProviders,\n    credentialStore,\n  });\n\n  const auth = gateway.resolveAuth({\n    gatewayId: MASTRACODE_GATEWAY_ID,\n    providerId,\n    modelId: bareModelId,\n    routerId,\n  });\n\n  if (!auth && credentialStore?.allowEnvironmentFallback === false) {\n    // Scopes are exclusive, so name the one in effect: otherwise a user with a\n    // personal sign-in can't tell why an organization-scoped Factory fails.\n    throw new ProviderAuthRequiredError(\n      resolveCredentialScope(options?.requestContext) === 'factory'\n        ? `No usable ${providerId} credential is available. This Factory uses organization credentials only, so personal provider sign-ins don't apply. Add an organization credential, then try again.`\n        : `No usable ${providerId} credential is available. This Factory uses personal credentials only, so organization credentials don't apply. Connect the provider, then try again.`,\n    );\n  }\n\n  return gateway.resolveLanguageModel({\n    providerId,\n    modelId: bareModelId,\n    apiKey: auth?.apiKey ?? '',\n    headers,\n  });\n}\n\nexport interface ThinkingRequestContext {\n  state?: { thinkingLevel?: unknown };\n  session?: { modeId?: string };\n}\n/**\n * Resolve the effective thinking level for the current request.\n *\n * Precedence:\n *   1. Session override (`state.thinkingLevel`, set via /think or the session\n *      settings panel).\n *   2. Per-mode default from settings (`models.modeThinkingDefaults[mode]`),\n *      only when the context carries a session mode.\n *   3. Global default (`preferences.thinkingLevel`).\n *\n * Resolved per-request (not seeded at session start) so configuration changes\n * apply to the next request of every session — including automated\n * (rule-driven) Factory runs that nobody ever opens interactively.\n */\nexport function resolveRequestThinkingLevel(\n  agentControllerContext: ThinkingRequestContext | undefined,\n  settingsPath?: string,\n): ThinkingLevelSetting {\n  const override = agentControllerContext?.state?.thinkingLevel;\n  if (isThinkingLevelSetting(override)) return override;\n  const modeId = agentControllerContext?.session?.modeId;\n  return resolveDefaultThinkingLevel(loadSettings(settingsPath), modeId).level;\n}\n\n/**\n * Dynamic model function that reads the current model and optional ordered\n * fallback route from controller state. Route entry ids are opaque host-owned\n * identifiers; repeated ids receive occurrence suffixes because core tracks the\n * active fallback index by id across agentic steps.\n */\nexport function getDynamicModel(\n  { requestContext }: { requestContext: RequestContext },\n  settingsPath?: string,\n  { modeless = false }: { modeless?: boolean } = {},\n): IdentifiedModelConfig | ModelWithRetries[] {\n  const controller = requestContext.get('controller') as AgentControllerRequestContext<any> | undefined;\n  const state = controller?.getState?.() as\n    | {\n        modelRoute?: {\n          entries?: Array<{ id?: unknown; modelId?: unknown }>;\n        };\n        mastracodePendingModelFallback?: { toEntryId?: unknown; toModelId?: unknown; threadId?: unknown } | null;\n      }\n    | undefined;\n  const pendingState = state?.mastracodePendingModelFallback;\n  const pendingFallback =\n    pendingState &&\n    (pendingState.threadId === undefined ||\n      (typeof pendingState.threadId === 'string' && pendingState.threadId === controller?.threadId))\n      ? pendingState\n      : undefined;\n  const pendingModelId =\n    pendingFallback && typeof pendingFallback.toModelId === 'string' && pendingFallback.toModelId.length > 0\n      ? pendingFallback.toModelId\n      : undefined;\n  const modelId = pendingModelId ?? controller?.session?.modelId;\n  if (!modelId) {\n    if (!controller) {\n      throw new Error(\n        'No model available: this run started without a controller session context, so no model selection could be resolved.',\n      );\n    }\n    throw new Error('No model selected. Use /models to select a model first.');\n  }\n\n  const thinkingLevel = resolveRequestThinkingLevel(modeless ? { state: controller?.state } : controller, settingsPath);\n  const resolveOptions = { thinkingLevel, remapForCodexOAuth: true, requestContext } as const;\n  // Label each resolved model with its full ID: the resolved gateway model only\n  // knows its bare provider model, and Memory's `'auto'` reads this label.\n  const primary = identifyModel(modelId, resolveModel(modelId, resolveOptions));\n  const route = state?.modelRoute?.entries?.slice(0, MODEL_ROUTE_MAX_ENTRIES);\n  const pendingEntryId =\n    pendingFallback && typeof pendingFallback.toEntryId === 'string' ? pendingFallback.toEntryId : undefined;\n  const startIndex = pendingEntryId ? route?.findIndex(entry => entry.id === pendingEntryId) : 0;\n  const activeRoute = route && startIndex !== undefined && startIndex >= 0 ? route.slice(startIndex) : undefined;\n  if (!activeRoute || activeRoute.length < 2 || activeRoute[0]?.modelId !== modelId) return primary;\n\n  const firstId =\n    typeof activeRoute[0]?.id === 'string' && activeRoute[0].id.length > 0 ? activeRoute[0].id : undefined;\n  if (!firstId) return primary;\n\n  const entries: ModelWithRetries[] = [{ id: firstId, model: primary }];\n  const appearances = new Map<string, number>([[firstId, 1]]);\n  for (const routeEntry of activeRoute.slice(1)) {\n    if (\n      typeof routeEntry.id !== 'string' ||\n      routeEntry.id.length === 0 ||\n      typeof routeEntry.modelId !== 'string' ||\n      routeEntry.modelId.length === 0\n    ) {\n      break;\n    }\n    let entryModel: ResolvedModel;\n    try {\n      entryModel = resolveModel(routeEntry.modelId, resolveOptions);\n    } catch {\n      break;\n    }\n    const occurrence = (appearances.get(routeEntry.id) ?? 0) + 1;\n    appearances.set(routeEntry.id, occurrence);\n    entries.push({\n      id: occurrence === 1 ? routeEntry.id : `${routeEntry.id}#${occurrence}`,\n      model: identifyModel(routeEntry.modelId, entryModel),\n    });\n  }\n\n  return entries.length < 2 ? primary : entries;\n}\n\nfunction identifyModel(modelId: string, model: ResolvedModel): IdentifiedModelConfig {\n  return { model, id: toMemoryModelId(modelId) };\n}\n\ntype MemoryRouteState = {\n  modelRoute?: { entries?: Array<{ id?: unknown; memoryModelId?: unknown }> };\n  mastracodePendingModelFallback?: { toEntryId?: unknown; threadId?: unknown } | null;\n};\n\n/**\n * The active model route for memory: the session route, starting at a pending\n * fallback hop captured for this thread.\n */\nexport function getActiveMemoryRoute<TEntry extends { id?: unknown; memoryModelId?: unknown }>(\n  state:\n    | {\n        modelRoute?: { entries?: TEntry[] };\n        mastracodePendingModelFallback?: MemoryRouteState['mastracodePendingModelFallback'];\n      }\n    | undefined,\n  threadId?: string | null,\n): TEntry[] {\n  const pending = state?.mastracodePendingModelFallback;\n  const sameThreadPending =\n    pending && (pending.threadId === undefined || pending.threadId === threadId) ? pending : undefined;\n  const routeEntries = state?.modelRoute?.entries?.slice(0, MODEL_ROUTE_MAX_ENTRIES) ?? [];\n  const pendingIndex = sameThreadPending\n    ? routeEntries.findIndex(entry => entry.id === sameThreadPending.toEntryId)\n    : -1;\n  return pendingIndex >= 0 ? routeEntries.slice(pendingIndex) : routeEntries;\n}\n\n/**\n * The memory model the active route applies to both OM roles: `'auto'`, the\n * first concrete memory model, or `undefined` when the route sets none (both\n * roles then follow their `/om` settings).\n */\nexport function getActiveRouteMemoryModelId(\n  state: Readonly<Record<string, unknown>> | undefined,\n  threadId?: string | null,\n): string | undefined {\n  const route = getActiveMemoryRoute(state as MemoryRouteState | undefined, threadId);\n  if (route[0]?.memoryModelId === 'auto') return 'auto';\n  const entry = route.find(\n    candidate =>\n      typeof candidate.memoryModelId === 'string' && candidate.memoryModelId && candidate.memoryModelId !== 'auto',\n  );\n  return entry?.memoryModelId as string | undefined;\n}\n\n/**\n * Goal judge model resolver for the agent's `goal.judge` config. Resolves the\n * configured goal judge model through mastracode's gateway so provider\n * credentials (stored in auth storage, not just env) are injected — a bare model\n * id handed to core's default model router would fail to find the API key.\n *\n * Returns `undefined` when no judge model is configured, which keeps the goal\n * step a complete no-op (the goal mechanism requires a judge to do anything).\n *\n * `settingsPath` must be the same source `createMastraCode()` reads from so the\n * judge model and the goal budget (`goalMaxTurns`) come from one config — with a\n * custom `settingsPath` a bare `loadSettings()` here could read a different file\n * and silently turn the goal step into a no-op.\n */\nexport function getGoalJudgeModel(\n  { requestContext }: { requestContext: RequestContext },\n  settingsPath?: string,\n): ResolvedModel | undefined {\n  const judgeModelId = loadSettings(settingsPath).models.goalJudgeModel;\n  if (!judgeModelId) return undefined;\n  return resolveModel(judgeModelId, { remapForCodexOAuth: true, requestContext });\n}\n"],"mappings":"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"}

package/dist/agents/modes/build.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build mode — interactive task execution with write capabilities.
+ *
+ * The default top-level mode for implementing features, fixing bugs, and
+ * making changes directly in conversation with the user. Full read/write
+ * access within the task's scope. (Not to be confused with the separate
+ * `executeSubagent`, which has its own concise, parent-reporting
+ * instructions for when work is delegated to a sub-agent.)
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+export declare const buildMode: AgentControllerMode;
+//# sourceMappingURL=build.d.ts.map

package/dist/agents/modes/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,eAAO,MAAM,SAAS,EAAE,mBAiCvB,CAAC"}

package/dist/agents/modes/build.js

@@ -0,0 +1,36 @@
+//#region src/agents/modes/build.ts
+const buildMode = {
+	id: "build",
+	name: "Build",
+	description: "Task execution with write capabilities. Use for 'implement feature X', 'fix bug Y', 'refactor module Z'.",
+	instructions: `You are a focused execution agent. Your job is to complete a specific, well-defined task by making the necessary changes to the codebase.
+
+## Rules
+- You have FULL ACCESS to read, write, and execute within your task scope.
+- Stay focused on the specific task given. Do not make unrelated changes.
+- Read files before modifying them — use view first, then string_replace_lsp or write_file.
+- Verify your changes work by running relevant tests or checking for errors.
+
+## Tool Strategy
+- **Read first**: Always view a file before editing it
+- **Edit precisely**: Use string_replace_lsp with enough context to match uniquely
+- **Use specialized tools**: Prefer view/search_content/find_files over shell commands for reading
+- **Parallelize**: Make independent tool calls together (e.g., view multiple files at once)
+
+## Workflow
+. Understand the task and explore relevant code
+. For complex tasks (3+ steps): track progress internally and summarize it in your final answer
+. Make changes incrementally — verify each change before moving on
+. Run tests or type-check to verify
+
+## Workflows
+- To build a workflow: call \`create-workflow\` with the user's request verbatim. A focused sub-agent handles discovery, composition, and saving — don't try to do it inline.
+- To run an existing workflow: call \`run-workflow\` with { workflowId, inputData }. Returns { status, result, error? }.
+- To inspect or manage: \`list-workflows\`, \`get-workflow\`, \`delete-workflow\`.`,
+	defaultModelId: "openai/gpt-5.5",
+	metadata: { default: true }
+};
+//#endregion
+export { buildMode };
+
+//# sourceMappingURL=build.js.map

package/dist/agents/modes/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","names":[],"sources":["../../../src/agents/modes/build.ts"],"sourcesContent":["/**\n * Build mode — interactive task execution with write capabilities.\n *\n * The default top-level mode for implementing features, fixing bugs, and\n * making changes directly in conversation with the user. Full read/write\n * access within the task's scope. (Not to be confused with the separate\n * `executeSubagent`, which has its own concise, parent-reporting\n * instructions for when work is delegated to a sub-agent.)\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\n\nexport const buildMode: AgentControllerMode = {\n  id: 'build',\n  name: 'Build',\n  description:\n    \"Task execution with write capabilities. Use for 'implement feature X', 'fix bug Y', 'refactor module Z'.\",\n  instructions: `You are a focused execution agent. Your job is to complete a specific, well-defined task by making the necessary changes to the codebase.\n\n## Rules\n- You have FULL ACCESS to read, write, and execute within your task scope.\n- Stay focused on the specific task given. Do not make unrelated changes.\n- Read files before modifying them — use view first, then string_replace_lsp or write_file.\n- Verify your changes work by running relevant tests or checking for errors.\n\n## Tool Strategy\n- **Read first**: Always view a file before editing it\n- **Edit precisely**: Use string_replace_lsp with enough context to match uniquely\n- **Use specialized tools**: Prefer view/search_content/find_files over shell commands for reading\n- **Parallelize**: Make independent tool calls together (e.g., view multiple files at once)\n\n## Workflow\n. Understand the task and explore relevant code\n. For complex tasks (3+ steps): track progress internally and summarize it in your final answer\n. Make changes incrementally — verify each change before moving on\n. Run tests or type-check to verify\n\n## Workflows\n- To build a workflow: call \\`create-workflow\\` with the user's request verbatim. A focused sub-agent handles discovery, composition, and saving — don't try to do it inline.\n- To run an existing workflow: call \\`run-workflow\\` with { workflowId, inputData }. Returns { status, result, error? }.\n- To inspect or manage: \\`list-workflows\\`, \\`get-workflow\\`, \\`delete-workflow\\`.`,\n  defaultModelId: 'openai/gpt-5.5',\n  metadata: {\n    default: true,\n  },\n};\n"],"mappings":";AAWA,MAAa,YAAiC;CAC5C,IAAI;CACJ,MAAM;CACN,aACE;CACF,cAAc;;;;;;;;;;;;;;;;;;;;;;;;CAwBd,gBAAgB;CAChB,UAAU,EACR,SAAS,KACX;AACF"}

package/dist/agents/modes/explore.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Explore mode — interactive, read-only codebase exploration.
+ *
+ * The top-level mode for questions like "find all usages of X" or "how
+ * does module Y work". Read-only; answers the user directly in
+ * conversation rather than reporting back to a parent agent.
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+export declare const fastMode: AgentControllerMode;
+//# sourceMappingURL=explore.d.ts.map

package/dist/agents/modes/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/explore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,eAAO,MAAM,QAAQ,EAAE,mBAuBtB,CAAC"}

package/dist/agents/modes/explore.js

@@ -0,0 +1,28 @@
+import { EXPLORE_MODE_AVAILABLE_TOOLS } from "../tool-availability.js";
+//#region src/agents/modes/explore.ts
+const fastMode = {
+	id: "fast",
+	name: "Explore",
+	description: "Read-only codebase exploration. Use for questions like 'find all usages of X', 'how does module Y work'.",
+	defaultModelId: "openai/gpt-5.4-mini",
+	instructions: `You are an expert code explorer. Your job is to investigate a codebase and answer a specific question or gather specific information.
+
+## Rules
+- You have READ-ONLY access. You cannot modify files or run commands.
+- Be thorough — search broadly first, then drill into relevant files.
+- After gathering enough information, produce a clear, concise summary of your findings.
+
+## Tool Strategy
+- **Start broad**: Use find_files (glob) to understand project structure
+- **Search smart**: Use search_content (grep) with specific patterns — avoid overly broad searches
+- **Read efficiently**: Use view with view_range for large files — don't read entire files if you only need a section
+- **Parallelize**: Make multiple independent tool calls in one round when exploring different areas
+
+## Workflows
+- You can use \`list-workflows\` and \`get-workflow\` to inspect saved workflows. You cannot create, run, or delete in this mode.`,
+	availableTools: [...EXPLORE_MODE_AVAILABLE_TOOLS]
+};
+//#endregion
+export { fastMode };
+
+//# sourceMappingURL=explore.js.map

package/dist/agents/modes/explore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.js","names":[],"sources":["../../../src/agents/modes/explore.ts"],"sourcesContent":["/**\n * Explore mode — interactive, read-only codebase exploration.\n *\n * The top-level mode for questions like \"find all usages of X\" or \"how\n * does module Y work\". Read-only; answers the user directly in\n * conversation rather than reporting back to a parent agent.\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\nimport { EXPLORE_MODE_AVAILABLE_TOOLS } from '../tool-availability.js';\n\nexport const fastMode: AgentControllerMode = {\n  id: 'fast',\n  name: 'Explore',\n  description:\n    \"Read-only codebase exploration. Use for questions like 'find all usages of X', 'how does module Y work'.\",\n  defaultModelId: 'openai/gpt-5.4-mini',\n  instructions: `You are an expert code explorer. Your job is to investigate a codebase and answer a specific question or gather specific information.\n\n## Rules\n- You have READ-ONLY access. You cannot modify files or run commands.\n- Be thorough — search broadly first, then drill into relevant files.\n- After gathering enough information, produce a clear, concise summary of your findings.\n\n## Tool Strategy\n- **Start broad**: Use find_files (glob) to understand project structure\n- **Search smart**: Use search_content (grep) with specific patterns — avoid overly broad searches\n- **Read efficiently**: Use view with view_range for large files — don't read entire files if you only need a section\n- **Parallelize**: Make multiple independent tool calls in one round when exploring different areas\n\n## Workflows\n- You can use \\`list-workflows\\` and \\`get-workflow\\` to inspect saved workflows. You cannot create, run, or delete in this mode.`,\n\n  availableTools: [...EXPLORE_MODE_AVAILABLE_TOOLS],\n};\n"],"mappings":";;AAUA,MAAa,WAAgC;CAC3C,IAAI;CACJ,MAAM;CACN,aACE;CACF,gBAAgB;CAChB,cAAc;;;;;;;;;;;;;;;CAgBd,gBAAgB,CAAC,GAAG,4BAA4B;AAClD"}

package/dist/agents/modes/plan.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plan mode — read-only analysis and planning.
+ */
+import type { AgentControllerMode } from '@mastra/core/agent-controller';
+/** Plan mode; pass `false` when the host removed `submit_plan` so the mode never asks for it. */
+export declare function createPlanMode(submitPlanAvailable?: boolean): AgentControllerMode;
+export declare const planMode: AgentControllerMode;
+//# sourceMappingURL=plan.d.ts.map

package/dist/agents/modes/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/agents/modes/plan.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,mBAAmB,UAAO,GAAG,mBAAmB,CA0C9E;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAsC,CAAC"}

package/dist/agents/modes/plan.js

@@ -0,0 +1,46 @@
+import { PLAN_MODE_AVAILABLE_TOOLS } from "../tool-availability.js";
+//#region src/agents/modes/plan.ts
+/** Plan mode; pass `false` when the host removed `submit_plan` so the mode never asks for it. */
+function createPlanMode(submitPlanAvailable = true) {
+	return {
+		id: "plan",
+		name: "Plan",
+		transitionsTo: "build",
+		defaultModelId: "openai/gpt-5.5",
+		description: "Read-only analysis and planning. Use for 'create an implementation plan for X', 'analyze the architecture of Y'.",
+		instructions: `You are an expert software architect and planner. Your job is to analyze a codebase and produce a detailed implementation plan for a given task.
+
+## Rules
+- You have READ-ONLY access to the project. You cannot modify project files or run commands.
+- The one exception is plan files: you can create and edit markdown files inside the session-specific plan directory identified in your system prompt using \`write_file\`, \`view\`, and \`string_replace_lsp\`. You may not write anywhere else.
+- First, explore the codebase to understand existing patterns, architecture, and conventions.
+- Produce a concrete, actionable plan — not vague suggestions.
+
+## Tool Strategy
+- **Discover structure**: Use find_files (glob) to understand project layout and find relevant files
+- **Find patterns**: Use search_content (grep) to locate existing implementations, imports, and conventions
+- **Understand deeply**: Use view with view_range to read specific sections of key files
+- **Parallelize**: Make multiple independent tool calls when exploring different areas
+
+## Plan Delivery
+- Write your plan to a markdown file in the session-specific plan directory identified in your system prompt using \`write_file\`, ${submitPlanAvailable ? "then call `submit_plan({ path })` with the path to that file (never the plan body)." : "then hand off the plan file as described in your system prompt (never the plan body)."}
+- Start the file with a \`# Title\` heading describing the plan.
+- Reuse the same file while iterating on the same plan; only create a new file for a genuinely different plan so each plan stays available to review.
+- Do NOT output the plan as text — it MUST live in the plan file.
+- Be concise: reference files by path and line number, don't include raw contents.
+- Focus on actionable details, not general observations.
+- To revise after "Request changes", edit the same file in place with \`string_replace_lsp\`, ${submitPlanAvailable ? "and call `submit_plan` again with the same path." : "then hand off the same file again."}
+
+## Workflows
+- You can INSPECT saved workflows via \`list-workflows\` and \`get-workflow\`.
+- You CANNOT build, run, or delete workflows in this mode.
+- If the user asks for a workflow design, include it in the implementation plan stored at the session-specific plan path, ${submitPlanAvailable ? "then call `submit_plan({ path })` as required above. After approval, build mode can save and run it." : "then hand off the plan file as described in your system prompt."}`,
+		metadata: { default: false },
+		availableTools: [...PLAN_MODE_AVAILABLE_TOOLS]
+	};
+}
+const planMode = createPlanMode();
+//#endregion
+export { createPlanMode, planMode };
+
+//# sourceMappingURL=plan.js.map

package/dist/agents/modes/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","names":[],"sources":["../../../src/agents/modes/plan.ts"],"sourcesContent":["/**\n * Plan mode — read-only analysis and planning.\n */\nimport type { AgentControllerMode } from '@mastra/core/agent-controller';\nimport { PLAN_MODE_AVAILABLE_TOOLS } from '../tool-availability.js';\n\n/** Plan mode; pass `false` when the host removed `submit_plan` so the mode never asks for it. */\nexport function createPlanMode(submitPlanAvailable = true): AgentControllerMode {\n  return {\n    id: 'plan',\n    name: 'Plan',\n    transitionsTo: 'build',\n    defaultModelId: 'openai/gpt-5.5',\n    description:\n      \"Read-only analysis and planning. Use for 'create an implementation plan for X', 'analyze the architecture of Y'.\",\n    instructions: `You are an expert software architect and planner. Your job is to analyze a codebase and produce a detailed implementation plan for a given task.\n\n## Rules\n- You have READ-ONLY access to the project. You cannot modify project files or run commands.\n- The one exception is plan files: you can create and edit markdown files inside the session-specific plan directory identified in your system prompt using \\`write_file\\`, \\`view\\`, and \\`string_replace_lsp\\`. You may not write anywhere else.\n- First, explore the codebase to understand existing patterns, architecture, and conventions.\n- Produce a concrete, actionable plan — not vague suggestions.\n\n## Tool Strategy\n- **Discover structure**: Use find_files (glob) to understand project layout and find relevant files\n- **Find patterns**: Use search_content (grep) to locate existing implementations, imports, and conventions\n- **Understand deeply**: Use view with view_range to read specific sections of key files\n- **Parallelize**: Make multiple independent tool calls when exploring different areas\n\n## Plan Delivery\n- Write your plan to a markdown file in the session-specific plan directory identified in your system prompt using \\`write_file\\`, ${submitPlanAvailable ? 'then call `submit_plan({ path })` with the path to that file (never the plan body).' : 'then hand off the plan file as described in your system prompt (never the plan body).'}\n- Start the file with a \\`# Title\\` heading describing the plan.\n- Reuse the same file while iterating on the same plan; only create a new file for a genuinely different plan so each plan stays available to review.\n- Do NOT output the plan as text — it MUST live in the plan file.\n- Be concise: reference files by path and line number, don't include raw contents.\n- Focus on actionable details, not general observations.\n- To revise after \"Request changes\", edit the same file in place with \\`string_replace_lsp\\`, ${submitPlanAvailable ? 'and call `submit_plan` again with the same path.' : 'then hand off the same file again.'}\n\n## Workflows\n- You can INSPECT saved workflows via \\`list-workflows\\` and \\`get-workflow\\`.\n- You CANNOT build, run, or delete workflows in this mode.\n- If the user asks for a workflow design, include it in the implementation plan stored at the session-specific plan path, ${submitPlanAvailable ? 'then call `submit_plan({ path })` as required above. After approval, build mode can save and run it.' : 'then hand off the plan file as described in your system prompt.'}`,\n\n    metadata: {\n      default: false,\n    },\n\n    availableTools: [...PLAN_MODE_AVAILABLE_TOOLS],\n  };\n}\n\nexport const planMode: AgentControllerMode = createPlanMode();\n"],"mappings":";;;AAOA,SAAgB,eAAe,sBAAsB,MAA2B;CAC9E,OAAO;EACL,IAAI;EACJ,MAAM;EACN,eAAe;EACf,gBAAgB;EAChB,aACE;EACF,cAAc;;;;;;;;;;;;;;;qIAemH,sBAAsB,wFAAwF,wFAAwF;;;;;;gGAM3O,sBAAsB,qDAAqD,qCAAqC;;;;;4HAKpF,sBAAsB,yGAAyG;EAEvP,UAAU,EACR,SAAS,MACX;EAEA,gBAAgB,CAAC,GAAG,yBAAyB;CAC/C;AACF;AAEA,MAAa,WAAgC,eAAe"}