@fased/fased 0.1.58 → 0.1.60

package/dist/cli/components-cli.js

@@ -16,20 +16,23 @@ function registerComponentsCli(program) {
 		renderComponentReport(options);
 	});
 	components.command("install").description("Install a cataloged optional component").argument("<id>", "Component id from `fased components`").action(async (id) => {
-		const result = await installCapabilityComponent({
-			id,
-			config: loadConfig()
-		});
-		await writeConfigFile(result.config);
-		for (const warning of result.slotWarnings) {
-			defaultRuntime.log(theme.warn(warning));
-		}
-		defaultRuntime.log(`Installed component: ${result.entry.label} (${result.entry.packageName})`);
-		if (result.entry.restartRequired !== false) {
-			defaultRuntime.log("Restart the gateway to apply the component.");
-		}
+		await installComponentCommand(id);
 	});
 }
+async function installComponentCommand(id) {
+	const result = await installCapabilityComponent({
+		id,
+		config: loadConfig()
+	});
+	await writeConfigFile(result.config);
+	for (const warning of result.slotWarnings) {
+		defaultRuntime.log(theme.warn(warning));
+	}
+	defaultRuntime.log(`Installed component: ${result.entry.label} (${result.entry.packageName})`);
+	if (result.entry.restartRequired !== false) {
+		defaultRuntime.log("Restart the gateway to apply the component.");
+	}
+}
 function renderComponentReport(options) {
 	const report = buildCapabilityReadinessReport();
 	if (options.json) {
@@ -80,4 +83,4 @@ function renderComponentReport(options) {
 }
 
 //#endregion
-export { registerComponentsCli };
+export { installComponentCommand, registerComponentsCli, renderComponentReport };

package/dist/cli/daemon-cli/install.js

@@ -9,6 +9,7 @@ import { resolveGatewayService } from "../../daemon/service.js";
 import { resolveGatewayAuth } from "../../gateway/auth.js";
 import { buildGatewayInstallPlan } from "../../commands/daemon-install-helpers.js";
 import { DEFAULT_GATEWAY_DAEMON_RUNTIME, isGatewayDaemonRuntime } from "../../commands/daemon-runtime.js";
+import { ensureManagedRuntimeBootstrap } from "../../infra/managed-runtime-bootstrap.js";
 import { buildDaemonServiceSnapshot, createDaemonActionContext } from "./response.js";
 import { parsePort } from "../shared/parse-port.js";
 import "./shared.js";
@@ -46,6 +47,15 @@ async function runDaemonInstall(opts) {
 		fail("--system is supported on Linux VPS Hosting installs only.");
 		return;
 	}
+	try {
+		await ensureManagedRuntimeBootstrap({
+			profile: systemInstall ? "hosting" : "local",
+			env: process.env
+		});
+	} catch (err) {
+		fail(`Managed updater bootstrap failed: ${String(err)}`);
+		return;
+	}
 	let loaded = false;
 	try {
 		loaded = await service.isLoaded({ env: process.env });

package/dist/cli/program/register.subclis.js

@@ -327,6 +327,15 @@ const entries = [
 			mod.registerComponentsCli(program);
 		}
 	},
+	{
+		name: "services",
+		description: "Inspect and connect optional services and runtimes",
+		hasSubcommands: true,
+		register: async (program) => {
+			const mod = await import("../services-cli.js");
+			mod.registerServicesCli(program);
+		}
+	},
 	{
 		name: "update",
 		description: "Update FasedAgent and inspect update channel status",

package/dist/cli/providers-cli.js

@@ -1,11 +1,14 @@
 import { theme } from "../terminal/theme.js";
-import { listAgentIds, resolveAgentDir } from "../agents/agent-scope.js";
+import { defaultRuntime } from "../runtime.js";
+import { listAgentIds, resolveAgentDir, resolveDefaultAgentId } from "../agents/agent-scope.js";
 import { getProviderBrandManifestForRoute } from "../providers/registry.js";
-import { loadAuthProfileStoreForRuntime } from "../agents/auth-profiles/store.js";
+import { ensureAuthProfileStore, loadAuthProfileStoreForRuntime } from "../agents/auth-profiles/store.js";
 import { loadConfig, writeConfigFile } from "../config/io.js";
 import "../config/config.js";
 import "../agents/auth-profiles.js";
+import { ensureFasedModelsJson } from "../agents/models-config.js";
 import { applyProviderRefreshToRegistrySource, buildProviderCapabilityOverridesSource, buildProviderRefreshEnvFromCredentials, buildProviderRefreshReport, buildProviderRegistryReviewPatch, fetchOfficialProviderRefreshSnapshot, loadProviderRefreshSnapshotFromFile } from "../providers/refresh.js";
+import { buildAuthChoiceGroups } from "../commands/auth-choice-options.js";
 import { createClackPrompter } from "../wizard/clack-prompter.js";
 import path from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -106,11 +109,13 @@ async function providersModelsAddCommand(options) {
 		...options.api?.trim() ? { api: options.api.trim() } : {},
 		models: nextModels
 	};
-	await writeConfigFile(upsertProviderModelConfig({
+	const nextConfig = upsertProviderModelConfig({
 		cfg,
 		providerId,
 		providerConfig: nextProvider
-	}));
+	});
+	await writeConfigFile(nextConfig);
+	await ensureFasedModelsJson(nextConfig);
 	console.log(`${theme.success("Model saved:")} ${providerId}/${model.id}`);
 }
 async function providersModelsRemoveCommand(options) {
@@ -125,14 +130,16 @@ async function providersModelsRemoveCommand(options) {
 	if (nextModels.length === (existing.models ?? []).length) {
 		throw new Error(`Model "${providerId}/${modelId}" is not configured.`);
 	}
-	await writeConfigFile(upsertProviderModelConfig({
+	const nextConfig = upsertProviderModelConfig({
 		cfg,
 		providerId,
 		providerConfig: {
 			...existing,
 			models: nextModels
 		}
-	}));
+	});
+	await writeConfigFile(nextConfig);
+	await ensureFasedModelsJson(nextConfig);
 	console.log(`${theme.success("Model removed:")} ${providerId}/${modelId}`);
 }
 async function providersModelsListCommand(options) {
@@ -353,6 +360,13 @@ async function providersRefreshCommand(options) {
 }
 function registerProvidersCli(program) {
 	const providers = program.command("providers").description("Review provider manifests and model catalogs");
+	providers.command("connect").description("Connect a model provider using the same auth flow as onboarding and the UI").argument("[provider]", "Public provider id, for example openai or anthropic").option("--method <id>", "Credential method id").option("--set-default", "Apply the provider's recommended default model", false).action(async (provider, options) => {
+		await providersConnectCommand({
+			provider,
+			method: options.method,
+			setDefault: options.setDefault === true
+		});
+	});
 	providers.command("refresh").description("Compare provider registry against official/source catalogs").option("--from-file <path>", "Use a provider refresh snapshot JSON file").option("--json", "Output JSON", false).option("--write-review [path]", "Write a review patch instead of applying changes").option("--apply", "Apply model-list updates to src/providers/registry.ts", false).option("--wizard", "Choose report/review/apply from an interactive wizard", false).option("--no-network", "Do not fetch official provider docs; report local registry only").action(async (opts) => {
 		await providersRefreshCommand({
 			fromFile: opts.fromFile,
@@ -392,6 +406,65 @@ function registerProvidersCli(program) {
 		});
 	});
 }
+async function providersConnectCommand(options) {
+	if (!process.stdin.isTTY) {
+		throw new Error("providers connect requires an interactive TTY.");
+	}
+	const config = loadConfig();
+	const [{ applyAuthChoice }, { openUrl }] = await Promise.all([import("../commands/auth-choice.js"), import("../commands/onboard-helpers.js")]);
+	const agentId = resolveDefaultAgentId(config);
+	const agentDir = resolveAgentDir(config, agentId);
+	const store = ensureAuthProfileStore(agentDir, { allowKeychainPrompt: false });
+	const { groups } = buildAuthChoiceGroups({
+		store,
+		includeSkip: false
+	});
+	const requestedProvider = options.provider?.trim().toLowerCase();
+	const prompter = createClackPrompter();
+	let selectedGroup = requestedProvider ? groups.find((candidate) => String(candidate.value).toLowerCase() === requestedProvider || candidate.label.toLowerCase() === requestedProvider) : undefined;
+	if (!requestedProvider) {
+		const selectedProvider = await prompter.select({
+			message: "Model provider",
+			options: groups.map((candidate) => ({
+				value: candidate.value,
+				label: candidate.label,
+				hint: candidate.hint
+			}))
+		});
+		selectedGroup = groups.find((candidate) => String(candidate.value) === String(selectedProvider));
+	}
+	if (!selectedGroup) {
+		throw new Error(`Unknown provider: ${options.provider}. Run \`fased providers connect\` to choose.`);
+	}
+	const requestedMethod = options.method?.trim();
+	let method = requestedMethod ? selectedGroup.options.find((candidate) => String(candidate.value) === requestedMethod) : selectedGroup.options.length === 1 ? selectedGroup.options[0] : undefined;
+	if (!requestedMethod && selectedGroup.options.length > 1) {
+		const selectedMethod = await prompter.select({
+			message: `${selectedGroup.label} auth method`,
+			options: selectedGroup.options
+		});
+		method = selectedGroup.options.find((candidate) => String(candidate.value) === String(selectedMethod));
+	}
+	if (!method) {
+		throw new Error(`Unknown auth method for ${selectedGroup.label}: ${options.method ?? "(none)"}`);
+	}
+	const result = await applyAuthChoice({
+		authChoice: method.value,
+		config,
+		prompter,
+		runtime: defaultRuntime,
+		openUrl: async (url) => {
+			await openUrl(url);
+		},
+		agentDir,
+		agentId,
+		setDefaultModel: options.setDefault === true,
+		opts: {}
+	});
+	await writeConfigFile(result.config);
+	await ensureFasedModelsJson(result.config, agentDir);
+	defaultRuntime.log(`${theme.success("Provider connected:")} ${selectedGroup.label}`);
+}
 
 //#endregion
 export { registerProvidersCli };

package/dist/cli/services-cli.js

@@ -0,0 +1,28 @@
+import { theme } from "../terminal/theme.js";
+import { defaultRuntime } from "../runtime.js";
+import { formatDocsLink } from "../terminal/links.js";
+import { buildCapabilityReadinessReport } from "../capabilities/catalog.js";
+import { installComponentCommand, renderComponentReport } from "./components-cli.js";
+
+//#region src/cli/services-cli.ts
+function registerServicesCli(program) {
+	const services = program.command("services").description("Inspect and connect optional services and runtimes");
+	services.command("status").description("Show service and component readiness").option("--json", "Output JSON", false).action((options) => renderComponentReport(options));
+	services.command("install").description("Install an official optional component").argument("<id>", "Component id from `fased services status`").action(async (id) => installComponentCommand(id));
+	services.command("connect").description("Install when supported, or show the canonical connection surface").argument("<id>", "Component id from `fased services status`").action(async (id) => {
+		const entry = buildCapabilityReadinessReport().entries.find((candidate) => candidate.id === id.trim());
+		if (!entry) {
+			throw new Error(`Unknown service component: ${id}. Run \`fased services status\`.`);
+		}
+		if (entry.delivery === "npm-addon" && entry.state === "not-installed") {
+			await installComponentCommand(entry.id);
+			return;
+		}
+		defaultRuntime.log(`${theme.heading(entry.label)}: ${entry.detail}`);
+		defaultRuntime.log(`Connect from: ${entry.surface}`);
+		defaultRuntime.log(`Docs: ${formatDocsLink(entry.docsPath, `docs.fased.ai${entry.docsPath}`)}`);
+	});
+}
+
+//#endregion
+export { registerServicesCli };

package/dist/cli/update-cli/update-command.js

@@ -15,6 +15,7 @@ import { DEFAULT_GIT_CHANNEL, DEFAULT_PACKAGE_CHANNEL, channelToNpmTag, normaliz
 import { cleanupGlobalRenameDirs, globalInstallArgs, resolveGlobalPackageRoot, resolveNodeModulesRootForPackageRoot } from "../../infra/update-global.js";
 import { checkUpdateStatus, compareSemverStrings, resolveNpmChannelTag } from "../../infra/update-check.js";
 import { probeGateway } from "../../gateway/probe.js";
+import { ensureManagedRuntimeBootstrap } from "../../infra/managed-runtime-bootstrap.js";
 import { runDaemonInstall } from "../daemon-cli/install.js";
 import { renderRestartDiagnostics, terminateStaleGatewayPids, waitForGatewayHealthyRestart } from "../daemon-cli/restart-health.js";
 import { runDaemonRestart } from "../daemon-cli/lifecycle.js";
@@ -202,7 +203,7 @@ async function refreshGatewayServiceEnv(params) {
 		args.push("--json");
 	}
 	const failures = [];
-	for (const candidate of resolveGatewayInstallEntrypointCandidates(params.result.root)) {
+	for (const candidate of resolveGatewayInstallEntrypointCandidates(params.root)) {
 		if (!await pathExists(candidate)) {
 			continue;
 		}
@@ -211,7 +212,7 @@ async function refreshGatewayServiceEnv(params) {
 			candidate,
 			...args
 		], {
-			cwd: params.result.root,
+			cwd: params.root,
 			timeoutMs: SERVICE_REFRESH_TIMEOUT_MS
 		});
 		if (res.code === 0) {
@@ -548,7 +549,7 @@ async function maybeRestartService(params) {
 			if (params.refreshServiceEnv) {
 				try {
 					const refresh = await measureUpdateStage(timings, "service environment refresh", () => refreshGatewayServiceEnv({
-						result: params.result,
+						root: params.result.root,
 						jsonMode: Boolean(params.opts.json)
 					}));
 					if (refresh.status === "daemon-install-fallback" && refresh.failures.length > 0 && !params.opts.json) {
@@ -698,6 +699,57 @@ async function updateCommand(opts) {
 		return;
 	}
 	const installKind = updateStatus.installKind;
+	if (installKind === "package" && !opts.dryRun && requestedChannel !== "dev") {
+		try {
+			const managed = await ensureManagedRuntimeBootstrap({
+				packageRoot: root,
+				env: process.env
+			});
+			if (managed.updaterPath) {
+				const managedArgs = [managed.updaterPath, "update"];
+				if (opts.json) {
+					managedArgs.push("--json");
+				}
+				if (opts.restart === false) {
+					managedArgs.push("--no-restart");
+				}
+				if (opts.channel) {
+					managedArgs.push("--channel", opts.channel);
+				}
+				if (opts.tag) {
+					managedArgs.push("--tag", opts.tag);
+				}
+				if (opts.timeout) {
+					managedArgs.push("--timeout", opts.timeout);
+				}
+				if (opts.yes) {
+					managedArgs.push("--yes");
+				}
+				if (opts.safeFallback) {
+					managedArgs.push("--safe-fallback");
+				}
+				const result = await runCommandWithTimeout([process.execPath, ...managedArgs], {
+					cwd: path.dirname(managed.updaterPath),
+					env: process.env,
+					timeoutMs: timeoutMs ?? 20 * 6e4
+				});
+				if (result.stdout) {
+					process.stdout.write(result.stdout);
+				}
+				if (result.stderr) {
+					process.stderr.write(result.stderr);
+				}
+				if (result.code !== 0) {
+					defaultRuntime.exit(result.code ?? 1);
+				}
+				return;
+			}
+		} catch (error) {
+			defaultRuntime.error(`Managed updater bootstrap failed: ${String(error)}`);
+			defaultRuntime.exit(1);
+			return;
+		}
+	}
 	const switchToGit = requestedChannel === "dev" && installKind !== "git";
 	const switchToPackage = requestedChannel !== null && requestedChannel !== "dev" && installKind === "git";
 	const updateInstallKind = switchToGit ? "git" : switchToPackage ? "package" : installKind;
@@ -840,7 +892,9 @@ async function updateCommand(opts) {
 			}
 		}
 		const runningRuntime = await probeRunningGatewayRuntimeIdentity({ timeoutMs: 750 });
-		if (runningRuntime.reachable && runningRuntime.version !== currentVersion) {
+		const managedRuntimeSources = new Set(["managed-package", "packaged-runtime"]);
+		const gatewayRuntimeNeedsRepair = runningRuntime.reachable && (runningRuntime.version !== currentVersion || !managedRuntimeSources.has(runningRuntime.runtimeSource ?? ""));
+		if (gatewayRuntimeNeedsRepair) {
 			if (!shouldRestart) {
 				defaultRuntime.error(`Installed version is ${currentVersion}, but the running gateway reports ${runningRuntime.version ?? "an older runtime without identity"}. Re-run without --no-restart.`);
 				defaultRuntime.exit(1);
@@ -856,6 +910,18 @@ async function updateCommand(opts) {
 			if (!opts.json) {
 				defaultRuntime.log(theme.warn(`Installed files are current, but gateway runtime is ${runningRuntime.version ?? "legacy/unknown"}. Refreshing the managed service...`));
 			}
+			try {
+				await refreshGatewayServiceEnv({
+					root,
+					jsonMode: Boolean(opts.json)
+				});
+			} catch (error) {
+				const repairCommand = error instanceof GatewayServiceRefreshError ? error.repairCommand : `${formatCliCommand("fased gateway install --force")} && ${formatCliCommand("fased gateway restart")}`;
+				defaultRuntime.error(`Gateway service refresh failed: ${String(error)}`);
+				defaultRuntime.error(`Repair command: ${repairCommand}`);
+				defaultRuntime.exit(1);
+				return;
+			}
 			if (serviceTarget.scope === "system") {
 				await serviceTarget.service.restart({
 					env: process.env,
@@ -930,7 +996,7 @@ async function updateCommand(opts) {
 	const { progress, stop } = createUpdateProgress(showProgress);
 	const startedAt = Date.now();
 	let restartScriptPath = null;
-	let refreshGatewayServiceEnv = false;
+	let shouldRefreshGatewayServiceEnv = false;
 	let serviceLoaded = false;
 	const serviceTarget = await resolveUpdateGatewayServiceTarget();
 	if (shouldRestart) {
@@ -939,7 +1005,7 @@ async function updateCommand(opts) {
 			if (serviceLoaded) {
 				if (serviceTarget.scope === "platform") {
 					restartScriptPath = await prepareRestartScript(process.env);
-					refreshGatewayServiceEnv = true;
+					shouldRefreshGatewayServiceEnv = true;
 				}
 			}
 		} catch {}
@@ -998,7 +1064,7 @@ async function updateCommand(opts) {
 		shouldRestart,
 		result,
 		opts,
-		refreshServiceEnv: refreshGatewayServiceEnv,
+		refreshServiceEnv: shouldRefreshGatewayServiceEnv,
 		gatewayPort,
 		restartScriptPath,
 		serviceTarget,

package/dist/commands/auth-choice.js

@@ -2,4 +2,4 @@ import { applyAuthChoice } from "./auth-choice.apply.js";
 import { warnIfModelConfigLooksOff } from "./auth-choice.model-check.js";
 import { resolvePreferredProviderForAuthChoice } from "./auth-choice.preferred-provider.js";
 
-export {  };
+export { applyAuthChoice, resolvePreferredProviderForAuthChoice, warnIfModelConfigLooksOff };

package/dist/commands/daemon-install-helpers.js

@@ -42,7 +42,8 @@ async function buildGatewayInstallPlan(params) {
 		dev: devMode,
 		runtime: params.runtime,
 		nodePath,
-		startupMode
+		startupMode,
+		env: params.env
 	});
 	await emitNodeRuntimeWarning({
 		env: params.env,

package/dist/commands/models/list.auth-overview.js

@@ -10,6 +10,11 @@ import { formatRemainingShort } from "../../agents/auth-health.js";
 import "./list.format.js";
 
 //#region src/commands/models/list.auth-overview.ts
+const LOCAL_PROVIDER_IDS = new Set([
+	"ollama",
+	"lmstudio",
+	"vllm"
+]);
 function formatProfileSecretLabel(params) {
 	const value = typeof params.value === "string" ? params.value.trim() : "";
 	if (value) {
@@ -69,6 +74,13 @@ function resolveProviderAuthOverview(params) {
 	const envKey = resolveEnvApiKey(provider);
 	const customKey = getCustomProviderApiKey(cfg, provider);
 	const effective = (() => {
+		const providerConfig = cfg.models?.providers?.[provider];
+		if (LOCAL_PROVIDER_IDS.has(provider) && providerConfig?.baseUrl?.trim()) {
+			return {
+				kind: "local",
+				detail: providerConfig.baseUrl.trim()
+			};
+		}
 		if (profiles.length > 0) {
 			return {
 				kind: "profiles",

package/dist/commands/onboard-channels.js

@@ -6,6 +6,7 @@ import { getChannelPlugin, listChannelPlugins } from "../channels/plugins/index.
 import { formatChannelPrimerLine, formatChannelSelectionLine, listChatChannels } from "../channels/registry.js";
 import { enablePluginInConfig } from "../plugins/enable.js";
 import { formatDocsLink } from "../terminal/links.js";
+import { channelDeliveryAllowsInstall, formatChannelDelivery } from "../channels/delivery.js";
 import { formatChannelPluginCatalogSelectionHint, formatChannelPluginCatalogStatusLine, listChannelPluginCatalogEntries } from "../channels/plugins/catalog.js";
 import { isChannelConfigured } from "../config/plugin-auto-enable.js";
 import { resolveChannelDefaultAccountId } from "../channels/plugins/helpers.js";
@@ -492,6 +493,10 @@ async function setupChannels(cfg, runtime, prompter, options) {
 		const { catalogById } = getChannelEntries();
 		const catalogEntry = catalogById.get(channel);
 		if (catalogEntry) {
+			if (!channelDeliveryAllowsInstall(catalogEntry.delivery)) {
+				await prompter.note(`${catalogEntry.meta.label} is ${formatChannelDelivery(catalogEntry.delivery).toLowerCase()}. Follow ${catalogEntry.meta.docsPath}; onboarding cannot install it from npm.`, "Channel delivery");
+				return;
+			}
 			const workspaceDir = resolveAgentWorkspaceDir(next, resolveDefaultAgentId(next));
 			const result = await ensureOnboardingPluginInstalled({
 				cfg: next,

package/dist/commands/onboard-helpers.js

@@ -460,4 +460,4 @@ function resolveControlUiLinks(params) {
 }
 
 //#endregion
-export { DEFAULT_WORKSPACE, applyWizardMetadata, detectBinary, detectBrowserOpenSupport, ensureWorkspaceAndSessions, formatControlUiSshHint, guardCancel, handleOnboardingRepair, handleReset, moveToTrash, normalizeGatewayTokenInput, openUrl, printWizardHeader, probeGatewayReachable, randomToken, resolveControlUiLinks, resolveNodeManagerOptions, summarizeExistingConfig, validateGatewayPasswordInput, waitForGatewayReachable };
+export { DEFAULT_WORKSPACE, applyWizardMetadata, detectBinary, detectBrowserOpenSupport, ensureWorkspaceAndSessions, formatControlUiSshHint, guardCancel, handleOnboardingRepair, handleReset, moveToTrash, normalizeGatewayTokenInput, openUrl, openUrlInBackground, printWizardHeader, probeGatewayReachable, randomToken, resolveBrowserOpenCommand, resolveControlUiLinks, resolveNodeManagerOptions, summarizeExistingConfig, validateGatewayPasswordInput, waitForGatewayReachable };

package/dist/commands/vllm-setup.js

@@ -20,6 +20,15 @@ function resolveLmStudioBaseUrl(value) {
 	const trimmed = value.trim().replace(/\/+$/, "");
 	return /\/v1$/i.test(trimmed) ? trimmed : `${trimmed}/v1`;
 }
+function normalizeLocalProviderModelId(provider, value) {
+	const normalizedProvider = provider.trim().toLowerCase();
+	let modelId = value.trim();
+	const prefix = `${normalizedProvider}/`;
+	while (normalizedProvider && modelId.toLowerCase().startsWith(prefix)) {
+		modelId = modelId.slice(prefix.length).trim();
+	}
+	return modelId;
+}
 function localModelDefinition(params) {
 	const modelId = params.id.trim();
 	const lower = modelId.toLowerCase();
@@ -37,7 +46,7 @@ function localModelDefinition(params) {
 async function configureVllmProvider(params) {
 	const baseUrl = params.baseUrl.trim().replace(/\/+$/, "");
 	const apiKey = params.apiKey.trim();
-	const modelId = params.modelId.trim();
+	const modelId = normalizeLocalProviderModelId("vllm", params.modelId);
 	if (!baseUrl || !apiKey || !modelId) {
 		throw new Error("vLLM setup requires base URL, API key or placeholder, and model ID.");
 	}
@@ -77,7 +86,7 @@ async function configureVllmProvider(params) {
 async function configureOllamaProvider(params) {
 	const baseUrl = resolveOllamaBaseUrl(params.baseUrl || OLLAMA_DEFAULT_BASE_URL);
 	const apiKey = params.apiKey?.trim() || "ollama-local";
-	const modelId = params.modelId.trim();
+	const modelId = normalizeLocalProviderModelId("ollama", params.modelId);
 	if (!baseUrl || !modelId) {
 		throw new Error("Ollama setup requires base URL and model ID.");
 	}
@@ -117,7 +126,7 @@ async function configureOllamaProvider(params) {
 async function configureLmStudioProvider(params) {
 	const baseUrl = resolveLmStudioBaseUrl(params.baseUrl || LMSTUDIO_DEFAULT_BASE_URL);
 	const apiKey = params.apiKey?.trim() || "lmstudio-local";
-	const modelId = params.modelId.trim();
+	const modelId = normalizeLocalProviderModelId("lmstudio", params.modelId);
 	if (!baseUrl || !modelId) {
 		throw new Error("LM Studio setup requires base URL and model ID.");
 	}