@fased/fased 0.1.57 → 0.1.59

package/dist/channels/plugins/catalog.js

@@ -2,6 +2,7 @@ import { CONFIG_DIR, isRecord, resolveUserPath } from "../../utils.js";
 import { resolveFasedAgentPackageRootSync } from "../../infra/fased-root.js";
 import { getPackageManifestMetadata } from "../../plugins/manifest.js";
 import { discoverFasedAgentPlugins } from "../../plugins/discovery.js";
+import { channelDeliveryAllowsInstall, getChannelDelivery } from "../delivery.js";
 import fs from "node:fs";
 import path from "node:path";
 
@@ -152,20 +153,22 @@ function buildCatalogEntry(candidate) {
 	if (!meta) {
 		return null;
 	}
+	const delivery = candidate.catalogSource === "official-catalog" ? "official-addon" : getChannelDelivery(id);
 	const install = resolveInstallInfo({
 		manifest,
 		packageName: candidate.packageName,
 		packageDir: candidate.packageDir,
 		workspaceDir: candidate.workspaceDir
 	});
-	if (!install) {
+	if (!install && channelDeliveryAllowsInstall(delivery)) {
 		return null;
 	}
 	return {
 		id,
 		meta,
+		delivery,
 		catalogSource: candidate.catalogSource,
-		install
+		install: channelDeliveryAllowsInstall(delivery) ? install ?? {} : {}
 	};
 }
 function buildExternalCatalogEntry(entry, catalogSource) {
@@ -201,7 +204,7 @@ function formatChannelPluginCatalogSource(source) {
 	}
 }
 function formatChannelPluginCatalogInstallBits(entry) {
-	const bits = [formatChannelPluginCatalogSource(entry.catalogSource)];
+	const bits = [entry.delivery, formatChannelPluginCatalogSource(entry.catalogSource)];
 	if (entry.install.expectedIntegrity) {
 		bits.push("integrity pinned");
 	}
@@ -211,10 +214,12 @@ function formatChannelPluginCatalogInstallBits(entry) {
 	return bits;
 }
 function formatChannelPluginCatalogSelectionHint(entry) {
-	return [...formatChannelPluginCatalogInstallBits(entry), "install"].join(" · ");
+	const action = entry.delivery === "official-addon" ? "install" : entry.delivery === "bundled" ? "enable bundled" : "docs required";
+	return [...formatChannelPluginCatalogInstallBits(entry), action].join(" · ");
 }
 function formatChannelPluginCatalogStatusLine(entry) {
-	return `${entry.meta.label}: ${formatChannelPluginCatalogInstallBits(entry).join(", ")}, install plugin to enable`;
+	const next = entry.delivery === "official-addon" ? "install add-on to enable" : entry.delivery === "bundled" ? "enable bundled integration" : `follow ${entry.meta.docsPath}`;
+	return `${entry.meta.label}: ${formatChannelPluginCatalogInstallBits(entry).join(", ")}, ${next}`;
 }
 function buildChannelUiCatalog(plugins) {
 	const entries = plugins.map((plugin) => {

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/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/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/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.");
 	}