@clinebot/core 0.0.0

package/src/storage/provider-settings-legacy-migration.ts

@@ -0,0 +1,637 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { models, providers } from "@clinebot/llms";
+import { resolveClineDataDir } from "@clinebot/shared/storage";
+import type { ProviderSettings } from "../types/provider-settings";
+import { emptyStoredProviderSettings } from "../types/provider-settings";
+import type { ProviderSettingsManager } from "./provider-settings-manager";
+
+type LegacyMode = "plan" | "act";
+
+interface LegacyGlobalState {
+	mode?: LegacyMode;
+	planModeApiProvider?: string;
+	actModeApiProvider?: string;
+	planModeApiModelId?: string;
+	actModeApiModelId?: string;
+	planModeReasoningEffort?: string;
+	actModeReasoningEffort?: string;
+	planModeThinkingBudgetTokens?: number;
+	actModeThinkingBudgetTokens?: number;
+	geminiPlanModeThinkingLevel?: string;
+	geminiActModeThinkingLevel?: string;
+	anthropicBaseUrl?: string;
+	openAiBaseUrl?: string;
+	ollamaBaseUrl?: string;
+	lmStudioBaseUrl?: string;
+	liteLlmBaseUrl?: string;
+	geminiBaseUrl?: string;
+	requestyBaseUrl?: string;
+	asksageApiUrl?: string;
+	difyBaseUrl?: string;
+	ocaBaseUrl?: string;
+	aihubmixBaseUrl?: string;
+	openAiHeaders?: Record<string, string>;
+	requestTimeoutMs?: number;
+	awsRegion?: string;
+	awsAuthentication?: "iam" | "api-key" | "profile";
+	awsUseProfile?: boolean;
+	awsProfile?: string;
+	awsUseCrossRegionInference?: boolean;
+	awsUseGlobalInference?: boolean;
+	awsBedrockUsePromptCache?: boolean;
+	awsBedrockEndpoint?: string;
+	planModeAwsBedrockCustomModelBaseId?: string;
+	actModeAwsBedrockCustomModelBaseId?: string;
+	vertexProjectId?: string;
+	vertexRegion?: string;
+	azureApiVersion?: string;
+	azureIdentity?: boolean;
+	sapAiCoreTokenUrl?: string;
+	sapAiCoreBaseUrl?: string;
+	sapAiResourceGroup?: string;
+	sapAiCoreUseOrchestrationMode?: boolean;
+	ocaMode?: "internal" | "external";
+	qwenApiLine?: "china" | "international";
+	moonshotApiLine?: "china" | "international";
+	zaiApiLine?: "china" | "international";
+	minimaxApiLine?: "china" | "international";
+	planModeOpenRouterModelId?: string;
+	actModeOpenRouterModelId?: string;
+	planModeClineModelId?: string;
+	actModeClineModelId?: string;
+	planModeOpenAiModelId?: string;
+	actModeOpenAiModelId?: string;
+	planModeOllamaModelId?: string;
+	actModeOllamaModelId?: string;
+	planModeLmStudioModelId?: string;
+	actModeLmStudioModelId?: string;
+	planModeLiteLlmModelId?: string;
+	actModeLiteLlmModelId?: string;
+	planModeRequestyModelId?: string;
+	actModeRequestyModelId?: string;
+	planModeTogetherModelId?: string;
+	actModeTogetherModelId?: string;
+	planModeFireworksModelId?: string;
+	actModeFireworksModelId?: string;
+	planModeSapAiCoreModelId?: string;
+	actModeSapAiCoreModelId?: string;
+	planModeSapAiCoreDeploymentId?: string;
+	actModeSapAiCoreDeploymentId?: string;
+	planModeGroqModelId?: string;
+	actModeGroqModelId?: string;
+	planModeBasetenModelId?: string;
+	actModeBasetenModelId?: string;
+	planModeHuggingFaceModelId?: string;
+	actModeHuggingFaceModelId?: string;
+	planModeHuaweiCloudMaasModelId?: string;
+	actModeHuaweiCloudMaasModelId?: string;
+	planModeOcaModelId?: string;
+	actModeOcaModelId?: string;
+	planModeAihubmixModelId?: string;
+	actModeAihubmixModelId?: string;
+	planModeHicapModelId?: string;
+	actModeHicapModelId?: string;
+	planModeNousResearchModelId?: string;
+	actModeNousResearchModelId?: string;
+	planModeVercelAiGatewayModelId?: string;
+	actModeVercelAiGatewayModelId?: string;
+}
+
+interface LegacySecrets {
+	apiKey?: string;
+	clineApiKey?: string;
+	"cline:clineAccountId"?: string;
+	clineAccountId?: string;
+	openRouterApiKey?: string;
+	awsAccessKey?: string;
+	awsSecretKey?: string;
+	awsSessionToken?: string;
+	awsBedrockApiKey?: string;
+	openAiApiKey?: string;
+	geminiApiKey?: string;
+	openAiNativeApiKey?: string;
+	ollamaApiKey?: string;
+	deepSeekApiKey?: string;
+	requestyApiKey?: string;
+	togetherApiKey?: string;
+	fireworksApiKey?: string;
+	qwenApiKey?: string;
+	doubaoApiKey?: string;
+	mistralApiKey?: string;
+	liteLlmApiKey?: string;
+	asksageApiKey?: string;
+	xaiApiKey?: string;
+	moonshotApiKey?: string;
+	zaiApiKey?: string;
+	huggingFaceApiKey?: string;
+	nebiusApiKey?: string;
+	sambanovaApiKey?: string;
+	cerebrasApiKey?: string;
+	sapAiCoreClientId?: string;
+	sapAiCoreClientSecret?: string;
+	groqApiKey?: string;
+	huaweiCloudMaasApiKey?: string;
+	basetenApiKey?: string;
+	vercelAiGatewayApiKey?: string;
+	difyApiKey?: string;
+	minimaxApiKey?: string;
+	hicapApiKey?: string;
+	aihubmixApiKey?: string;
+	nousResearchApiKey?: string;
+	ocaApiKey?: string;
+	ocaRefreshToken?: string;
+	"openai-codex-oauth-credentials"?: string;
+}
+
+interface LegacyProviderStorage {
+	globalState: LegacyGlobalState;
+	secrets: LegacySecrets;
+}
+
+export interface MigrateLegacyProviderSettingsOptions {
+	providerSettingsManager: ProviderSettingsManager;
+	dataDir?: string;
+	globalStatePath?: string;
+	secretsPath?: string;
+}
+
+export interface MigrateLegacyProviderSettingsResult {
+	migrated: boolean;
+	providerCount: number;
+	lastUsedProvider?: string;
+}
+
+function trimNonEmpty(value: string | undefined): string | undefined {
+	const trimmed = value?.trim();
+	return trimmed ? trimmed : undefined;
+}
+
+function readJsonObject<T extends object>(filePath: string): T | undefined {
+	if (!existsSync(filePath)) {
+		return undefined;
+	}
+	try {
+		const raw = readFileSync(filePath, "utf8");
+		const parsed = JSON.parse(raw) as unknown;
+		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+			return parsed as T;
+		}
+	} catch {
+		// Invalid legacy file should not block startup.
+	}
+	return undefined;
+}
+
+function resolveLegacyStorage(
+	options: MigrateLegacyProviderSettingsOptions,
+): LegacyProviderStorage | undefined {
+	const dataDir = options.dataDir ?? resolveClineDataDir();
+	const globalStatePath =
+		options.globalStatePath ?? join(dataDir, "globalState.json");
+	const secretsPath = options.secretsPath ?? join(dataDir, "secrets.json");
+	const globalState = readJsonObject<LegacyGlobalState>(globalStatePath);
+	const secrets = readJsonObject<LegacySecrets>(secretsPath);
+	if (!globalState && !secrets) {
+		return undefined;
+	}
+	return {
+		globalState: globalState ?? {},
+		secrets: secrets ?? {},
+	};
+}
+
+function resolveModelForProvider(
+	legacy: LegacyGlobalState,
+	providerId: string,
+	mode: LegacyMode,
+	activeProviderForMode: string | undefined,
+): string | undefined {
+	const modePrefix = mode === "plan" ? "planMode" : "actMode";
+	const fallbackModel =
+		providerId === activeProviderForMode
+			? trimNonEmpty(
+					mode === "plan"
+						? legacy.planModeApiModelId
+						: legacy.actModeApiModelId,
+				)
+			: undefined;
+	const providerModelKeyById: Record<string, keyof LegacyGlobalState> = {
+		openrouter: `${modePrefix}OpenRouterModelId` as keyof LegacyGlobalState,
+		cline: `${modePrefix}ClineModelId` as keyof LegacyGlobalState,
+		openai: `${modePrefix}OpenAiModelId` as keyof LegacyGlobalState,
+		ollama: `${modePrefix}OllamaModelId` as keyof LegacyGlobalState,
+		lmstudio: `${modePrefix}LmStudioModelId` as keyof LegacyGlobalState,
+		litellm: `${modePrefix}LiteLlmModelId` as keyof LegacyGlobalState,
+		requesty: `${modePrefix}RequestyModelId` as keyof LegacyGlobalState,
+		together: `${modePrefix}TogetherModelId` as keyof LegacyGlobalState,
+		fireworks: `${modePrefix}FireworksModelId` as keyof LegacyGlobalState,
+		sapaicore: `${modePrefix}SapAiCoreModelId` as keyof LegacyGlobalState,
+		groq: `${modePrefix}GroqModelId` as keyof LegacyGlobalState,
+		baseten: `${modePrefix}BasetenModelId` as keyof LegacyGlobalState,
+		huggingface: `${modePrefix}HuggingFaceModelId` as keyof LegacyGlobalState,
+		"huawei-cloud-maas":
+			`${modePrefix}HuaweiCloudMaasModelId` as keyof LegacyGlobalState,
+		oca: `${modePrefix}OcaModelId` as keyof LegacyGlobalState,
+		aihubmix: `${modePrefix}AihubmixModelId` as keyof LegacyGlobalState,
+		hicap: `${modePrefix}HicapModelId` as keyof LegacyGlobalState,
+		nousResearch: `${modePrefix}NousResearchModelId` as keyof LegacyGlobalState,
+		"vercel-ai-gateway":
+			`${modePrefix}VercelAiGatewayModelId` as keyof LegacyGlobalState,
+	};
+	const providerModelKey = providerModelKeyById[providerId];
+	const providerModel = providerModelKey
+		? trimNonEmpty(
+				typeof legacy[providerModelKey] === "string"
+					? (legacy[providerModelKey] as string)
+					: undefined,
+			)
+		: undefined;
+	return providerModel ?? fallbackModel;
+}
+
+function resolveReasoning(
+	legacy: LegacyGlobalState,
+	providerId: string,
+	mode: LegacyMode,
+): ProviderSettings["reasoning"] | undefined {
+	const effortCandidate =
+		mode === "plan"
+			? legacy.planModeReasoningEffort
+			: legacy.actModeReasoningEffort;
+	const geminiLevel =
+		mode === "plan"
+			? legacy.geminiPlanModeThinkingLevel
+			: legacy.geminiActModeThinkingLevel;
+	const budgetTokens =
+		mode === "plan"
+			? legacy.planModeThinkingBudgetTokens
+			: legacy.actModeThinkingBudgetTokens;
+	const rawEffort =
+		(providerId === "gemini" ? geminiLevel : undefined) ?? effortCandidate;
+	const effort =
+		rawEffort === "none" ||
+		rawEffort === "low" ||
+		rawEffort === "medium" ||
+		rawEffort === "high"
+			? rawEffort
+			: undefined;
+	const normalizedBudget =
+		typeof budgetTokens === "number" &&
+		Number.isInteger(budgetTokens) &&
+		budgetTokens > 0
+			? budgetTokens
+			: undefined;
+	if (!effort && normalizedBudget === undefined) {
+		return undefined;
+	}
+	return {
+		...(effort ? { effort } : {}),
+		...(normalizedBudget !== undefined
+			? { budgetTokens: normalizedBudget }
+			: {}),
+	};
+}
+
+function resolveLegacyCodexAuth(
+	legacySecrets: LegacySecrets,
+): Pick<ProviderSettings, "apiKey" | "auth"> | undefined {
+	const raw = legacySecrets["openai-codex-oauth-credentials"];
+	if (!raw) {
+		return undefined;
+	}
+	try {
+		const parsed = JSON.parse(raw) as {
+			access_token?: string;
+			refresh_token?: string;
+			accountId?: string;
+		};
+		const access = trimNonEmpty(parsed.access_token);
+		const refresh = trimNonEmpty(parsed.refresh_token);
+		const accountId = trimNonEmpty(parsed.accountId);
+		if (!access && !refresh && !accountId) {
+			return undefined;
+		}
+		return {
+			...(access ? { apiKey: access } : {}),
+			auth: {
+				...(access ? { accessToken: access } : {}),
+				...(refresh ? { refreshToken: refresh } : {}),
+				...(accountId ? { accountId } : {}),
+			},
+		};
+	} catch {
+		return undefined;
+	}
+}
+
+function getDefaultModelForProvider(providerId: string): string | undefined {
+	const builtInModels = models.getGeneratedModelsForProvider(providerId);
+	const firstModelId = Object.keys(builtInModels)[0];
+	return firstModelId ?? undefined;
+}
+
+function buildLegacyProviderSettings(
+	providerId: string,
+	legacyGlobalState: LegacyGlobalState,
+	legacySecrets: LegacySecrets,
+	mode: LegacyMode,
+): ProviderSettings | undefined {
+	const activeProviderForMode = trimNonEmpty(
+		mode === "plan"
+			? legacyGlobalState.planModeApiProvider
+			: legacyGlobalState.actModeApiProvider,
+	);
+	const model =
+		resolveModelForProvider(
+			legacyGlobalState,
+			providerId,
+			mode,
+			activeProviderForMode,
+		) ?? getDefaultModelForProvider(providerId);
+	const reasoning = resolveReasoning(legacyGlobalState, providerId, mode);
+	const timeout =
+		typeof legacyGlobalState.requestTimeoutMs === "number" &&
+		Number.isInteger(legacyGlobalState.requestTimeoutMs) &&
+		legacyGlobalState.requestTimeoutMs > 0
+			? legacyGlobalState.requestTimeoutMs
+			: undefined;
+
+	const secretByProvider: Record<string, string | undefined> = {
+		anthropic: legacySecrets.apiKey,
+		cline: legacySecrets.clineApiKey,
+		openai: legacySecrets.openAiApiKey,
+		"openai-native": legacySecrets.openAiNativeApiKey,
+		openrouter: legacySecrets.openRouterApiKey,
+		bedrock: legacySecrets.awsBedrockApiKey,
+		gemini: legacySecrets.geminiApiKey,
+		ollama: legacySecrets.ollamaApiKey,
+		deepseek: legacySecrets.deepSeekApiKey,
+		requesty: legacySecrets.requestyApiKey,
+		together: legacySecrets.togetherApiKey,
+		fireworks: legacySecrets.fireworksApiKey,
+		qwen: legacySecrets.qwenApiKey,
+		doubao: legacySecrets.doubaoApiKey,
+		mistral: legacySecrets.mistralApiKey,
+		litellm: legacySecrets.liteLlmApiKey,
+		asksage: legacySecrets.asksageApiKey,
+		xai: legacySecrets.xaiApiKey,
+		moonshot: legacySecrets.moonshotApiKey,
+		zai: legacySecrets.zaiApiKey,
+		huggingface: legacySecrets.huggingFaceApiKey,
+		nebius: legacySecrets.nebiusApiKey,
+		sambanova: legacySecrets.sambanovaApiKey,
+		cerebras: legacySecrets.cerebrasApiKey,
+		groq: legacySecrets.groqApiKey,
+		"huawei-cloud-maas": legacySecrets.huaweiCloudMaasApiKey,
+		baseten: legacySecrets.basetenApiKey,
+		"vercel-ai-gateway": legacySecrets.vercelAiGatewayApiKey,
+		dify: legacySecrets.difyApiKey,
+		minimax: legacySecrets.minimaxApiKey,
+		hicap: legacySecrets.hicapApiKey,
+		aihubmix: legacySecrets.aihubmixApiKey,
+		nousResearch: legacySecrets.nousResearchApiKey,
+		oca: legacySecrets.ocaApiKey,
+		sapaicore: legacySecrets.sapAiCoreClientId,
+	};
+
+	const providerSpecific: Partial<ProviderSettings> = {};
+	if (providerId === "openai-codex") {
+		Object.assign(providerSpecific, resolveLegacyCodexAuth(legacySecrets));
+	}
+	if (providerId === "cline") {
+		const accountId = trimNonEmpty(
+			legacySecrets["cline:clineAccountId"] ?? legacySecrets.clineAccountId,
+		);
+		if (accountId) {
+			providerSpecific.auth = {
+				...(providerSpecific.auth ?? {}),
+				accountId,
+			};
+		}
+	}
+	if (providerId === "openai" && legacyGlobalState.openAiHeaders) {
+		providerSpecific.headers = legacyGlobalState.openAiHeaders;
+	}
+	if (providerId === "bedrock") {
+		providerSpecific.aws = {
+			accessKey: trimNonEmpty(legacySecrets.awsAccessKey),
+			secretKey: trimNonEmpty(legacySecrets.awsSecretKey),
+			sessionToken: trimNonEmpty(legacySecrets.awsSessionToken),
+			region: trimNonEmpty(legacyGlobalState.awsRegion),
+			authentication: legacyGlobalState.awsAuthentication,
+			profile: legacyGlobalState.awsUseProfile
+				? trimNonEmpty(legacyGlobalState.awsProfile)
+				: undefined,
+			usePromptCache: legacyGlobalState.awsBedrockUsePromptCache,
+			useCrossRegionInference: legacyGlobalState.awsUseCrossRegionInference,
+			useGlobalInference: legacyGlobalState.awsUseGlobalInference,
+			endpoint: trimNonEmpty(legacyGlobalState.awsBedrockEndpoint),
+			customModelBaseId: trimNonEmpty(
+				mode === "plan"
+					? legacyGlobalState.planModeAwsBedrockCustomModelBaseId
+					: legacyGlobalState.actModeAwsBedrockCustomModelBaseId,
+			),
+		};
+	}
+	if (providerId === "vertex") {
+		providerSpecific.gcp = {
+			projectId: trimNonEmpty(legacyGlobalState.vertexProjectId),
+			region: trimNonEmpty(legacyGlobalState.vertexRegion),
+		};
+	}
+	if (
+		providerId === "openai" &&
+		(legacyGlobalState.azureApiVersion ||
+			legacyGlobalState.azureIdentity !== undefined)
+	) {
+		providerSpecific.azure = {
+			apiVersion: trimNonEmpty(legacyGlobalState.azureApiVersion),
+			useIdentity: legacyGlobalState.azureIdentity,
+		};
+	}
+	if (providerId === "sapaicore") {
+		providerSpecific.sap = {
+			clientId: trimNonEmpty(legacySecrets.sapAiCoreClientId),
+			clientSecret: trimNonEmpty(legacySecrets.sapAiCoreClientSecret),
+			tokenUrl: trimNonEmpty(legacyGlobalState.sapAiCoreTokenUrl),
+			resourceGroup: trimNonEmpty(legacyGlobalState.sapAiResourceGroup),
+			deploymentId: trimNonEmpty(
+				mode === "plan"
+					? legacyGlobalState.planModeSapAiCoreDeploymentId
+					: legacyGlobalState.actModeSapAiCoreDeploymentId,
+			),
+			useOrchestrationMode: legacyGlobalState.sapAiCoreUseOrchestrationMode,
+		};
+	}
+	if (providerId === "oca") {
+		providerSpecific.oca = {
+			mode: legacyGlobalState.ocaMode,
+		};
+		const refreshToken = trimNonEmpty(legacySecrets.ocaRefreshToken);
+		if (refreshToken) {
+			providerSpecific.auth = {
+				...(providerSpecific.auth ?? {}),
+				refreshToken,
+			};
+		}
+	}
+	if (providerId === "qwen") {
+		providerSpecific.apiLine = legacyGlobalState.qwenApiLine;
+	}
+	if (providerId === "moonshot") {
+		providerSpecific.apiLine = legacyGlobalState.moonshotApiLine;
+	}
+	if (providerId === "zai") {
+		providerSpecific.apiLine = legacyGlobalState.zaiApiLine;
+	}
+	if (providerId === "minimax") {
+		providerSpecific.apiLine = legacyGlobalState.minimaxApiLine;
+	}
+
+	const baseUrlByProvider: Record<string, string | undefined> = {
+		anthropic: legacyGlobalState.anthropicBaseUrl,
+		openai: legacyGlobalState.openAiBaseUrl,
+		ollama: legacyGlobalState.ollamaBaseUrl,
+		lmstudio: legacyGlobalState.lmStudioBaseUrl,
+		litellm: legacyGlobalState.liteLlmBaseUrl,
+		gemini: legacyGlobalState.geminiBaseUrl,
+		requesty: legacyGlobalState.requestyBaseUrl,
+		asksage: legacyGlobalState.asksageApiUrl,
+		dify: legacyGlobalState.difyBaseUrl,
+		oca: legacyGlobalState.ocaBaseUrl,
+		aihubmix: legacyGlobalState.aihubmixBaseUrl,
+		sapaicore: legacyGlobalState.sapAiCoreBaseUrl,
+	};
+
+	const apiKey = trimNonEmpty(secretByProvider[providerId]);
+	const baseUrl = trimNonEmpty(baseUrlByProvider[providerId]);
+
+	const settings: ProviderSettings = {
+		provider: providerId as ProviderSettings["provider"],
+		...(apiKey ? { apiKey } : {}),
+		...(model ? { model } : {}),
+		...(baseUrl ? { baseUrl } : {}),
+		...(reasoning ? { reasoning } : {}),
+		...(timeout ? { timeout } : {}),
+		...providerSpecific,
+	};
+	const parsed = providers.ProviderSettingsSchema.safeParse(settings);
+	if (!parsed.success) {
+		return undefined;
+	}
+	const hasNonProviderFields =
+		Object.keys(settings).filter((key) => key !== "provider").length > 0;
+	return hasNonProviderFields ? parsed.data : undefined;
+}
+
+function collectCandidateProviderIds(
+	legacyGlobalState: LegacyGlobalState,
+	legacySecrets: LegacySecrets,
+): Set<string> {
+	const candidates = new Set<string>();
+	for (const maybeProvider of [
+		legacyGlobalState.actModeApiProvider,
+		legacyGlobalState.planModeApiProvider,
+	]) {
+		const provider = trimNonEmpty(maybeProvider);
+		if (provider) {
+			candidates.add(provider);
+		}
+	}
+	if (trimNonEmpty(legacySecrets.apiKey)) candidates.add("anthropic");
+	if (trimNonEmpty(legacySecrets.openRouterApiKey))
+		candidates.add("openrouter");
+	if (trimNonEmpty(legacySecrets.openAiApiKey)) candidates.add("openai");
+	if (trimNonEmpty(legacySecrets.openAiNativeApiKey))
+		candidates.add("openai-native");
+	if (trimNonEmpty(legacySecrets["openai-codex-oauth-credentials"]))
+		candidates.add("openai-codex");
+	if (trimNonEmpty(legacySecrets.geminiApiKey)) candidates.add("gemini");
+	if (trimNonEmpty(legacySecrets.ollamaApiKey)) candidates.add("ollama");
+	if (
+		trimNonEmpty(legacySecrets.awsAccessKey) ||
+		trimNonEmpty(legacySecrets.awsBedrockApiKey)
+	)
+		candidates.add("bedrock");
+	if (
+		trimNonEmpty(legacyGlobalState.vertexProjectId) ||
+		trimNonEmpty(legacyGlobalState.vertexRegion)
+	) {
+		candidates.add("vertex");
+	}
+	if (trimNonEmpty(legacySecrets.clineApiKey)) candidates.add("cline");
+	if (trimNonEmpty(legacySecrets.ocaApiKey)) candidates.add("oca");
+	return candidates;
+}
+
+export function migrateLegacyProviderSettings(
+	options: MigrateLegacyProviderSettingsOptions,
+): MigrateLegacyProviderSettingsResult {
+	const existing = options.providerSettingsManager.read();
+	const legacyStorage = resolveLegacyStorage(options);
+	if (!legacyStorage) {
+		return {
+			migrated: false,
+			providerCount: Object.keys(existing.providers).length,
+			lastUsedProvider: existing.lastUsedProvider,
+		};
+	}
+
+	const { globalState, secrets } = legacyStorage;
+	const mode: LegacyMode = globalState.mode === "plan" ? "plan" : "act";
+	const candidates = collectCandidateProviderIds(globalState, secrets);
+	const next = emptyStoredProviderSettings();
+	next.providers = { ...existing.providers };
+	next.lastUsedProvider = existing.lastUsedProvider;
+	const now = new Date().toISOString();
+	let addedProviderCount = 0;
+
+	for (const providerId of candidates) {
+		if (next.providers[providerId]) {
+			continue;
+		}
+		const settings = buildLegacyProviderSettings(
+			providerId,
+			globalState,
+			secrets,
+			mode,
+		);
+		if (!settings) {
+			continue;
+		}
+		next.providers[providerId] = {
+			settings,
+			updatedAt: now,
+			tokenSource: "migration",
+		};
+		addedProviderCount += 1;
+	}
+
+	if (addedProviderCount === 0) {
+		return {
+			migrated: false,
+			providerCount: Object.keys(existing.providers).length,
+			lastUsedProvider: existing.lastUsedProvider,
+		};
+	}
+
+	const preferredProvider = trimNonEmpty(
+		mode === "plan"
+			? globalState.planModeApiProvider
+			: globalState.actModeApiProvider,
+	);
+	next.lastUsedProvider =
+		existing.lastUsedProvider ??
+		(preferredProvider && next.providers[preferredProvider]
+			? preferredProvider
+			: Object.keys(next.providers)[0]);
+
+	options.providerSettingsManager.write(next);
+
+	return {
+		migrated: true,
+		providerCount: Object.keys(next.providers).length,
+		lastUsedProvider: next.lastUsedProvider,
+	};
+}