jobarbiter 0.3.2 → 0.3.4

package/src/lib/onboard.ts

@@ -20,6 +20,12 @@ import {
 	type DetectedTool,
 	type ToolCategory,
 } from "./detect-tools.js";
+import {
+	loadProviderKeys,
+	saveProviderKey,
+	validateProviderKey,
+	getSupportedProviders,
+} from "./providers.js";
 
 // ── ANSI Colors ────────────────────────────────────────────────────────
 
@@ -139,13 +145,44 @@ interface OnboardState {
 export async function runOnboardWizard(opts: { force?: boolean; baseUrl?: string }): Promise<void> {
 	const baseUrl = opts.baseUrl || "https://jobarbiter-api-production.up.railway.app";
 	
-	// Check for existing config
+	// Check for existing config — resume if onboarding incomplete
 	const existingConfig = loadConfig();
 	if (existingConfig && !opts.force) {
-		console.log(`\n${sym.warning}  ${c.warning("You already have a JobArbiter account configured.")}`);
-		console.log(`\n   Run ${c.highlight("jobarbiter status")} to check your account.`);
-		console.log(`   Run ${c.highlight("jobarbiter onboard --force")} to start fresh.\n`);
-		process.exit(0);
+		if (existingConfig.onboardingComplete) {
+			console.log(`\n${sym.check}  ${c.success("You're already onboarded!")}`);
+			console.log(`\n   Run ${c.highlight("jobarbiter status")} to check your account.`);
+			console.log(`   Run ${c.highlight("jobarbiter onboard --force")} to start fresh.\n`);
+			process.exit(0);
+		}
+		// Onboarding incomplete — resume
+		const resumeStep = (existingConfig.onboardingStep ?? 1) + 1;
+		console.log(`\n${sym.rocket}  ${c.bold("Resuming onboarding")} from step ${resumeStep}/7\n`);
+		console.log(c.dim(`   Account: ${existingConfig.userType} | API key configured`));
+		console.log(c.dim(`   Run ${c.highlight("jobarbiter onboard --force")} to start over.\n`));
+		
+		const prompt = new Prompt();
+		const state: Partial<OnboardState> = {
+			baseUrl,
+			apiKey: existingConfig.apiKey,
+			userType: existingConfig.userType as "worker" | "employer",
+			userId: "",
+			email: "",
+		};
+		try {
+			if (existingConfig.userType === "worker" || existingConfig.userType === "seeker") {
+				await runWorkerFlow(prompt, state as OnboardState, resumeStep);
+			} else {
+				await runEmployerFlow(prompt, state as OnboardState);
+			}
+			prompt.close();
+		} catch (err) {
+			prompt.close();
+			if (err instanceof Error) {
+				console.log(`\n${sym.cross} ${c.error(err.message)}`);
+			}
+			process.exit(1);
+		}
+		return;
 	}
 
 	const prompt = new Prompt();
@@ -163,11 +200,13 @@ export async function runOnboardWizard(opts: { force?: boolean; baseUrl?: string
 		state.apiKey = apiKey;
 		state.userId = userId;
 
-		// Save config immediately after verification
+		// Save config immediately after verification (with step progress)
 		saveConfig({
 			apiKey,
 			baseUrl,
 			userType,
+			onboardingStep: 1,
+			onboardingComplete: false,
 		});
 
 		if (userType === "worker") {
@@ -224,9 +263,9 @@ async function handleEmailVerification(
 	baseUrl: string,
 	userType: "worker" | "employer"
 ): Promise<{ email: string; apiKey: string; userId: string }> {
-	// Workers: 1) Account, 2) Tool Detection, 3) Domains, 4) GitHub, 5) LinkedIn, 6) Done
-	// Employers: 1) Account, 2) (skip verification), 3) Company, 4) Domain, 5) What You Need, 6) Done
-	const totalSteps = 6;
+	// Workers: 1) Account, 2) Tool Detection, 3) AI Accounts, 4) Domains, 5) GitHub, 6) LinkedIn, 7) Done
+	// Employers: 1) Account, 2) (skip verification), 3) Company, 4) Domain, 5) What You Need, 6) Done (stays at 6)
+	const totalSteps = userType === "employer" ? 6 : 7;
 	
 	console.log(`\n${sym.email} ${c.bold(`Step 1/${totalSteps} — Create Your Account`)}\n`);
 
@@ -306,85 +345,108 @@ async function handleEmailVerification(
 
 // ── Worker Flow ────────────────────────────────────────────────────────
 
-async function runWorkerFlow(prompt: Prompt, state: OnboardState): Promise<void> {
+async function runWorkerFlow(prompt: Prompt, state: OnboardState, startStep = 2): Promise<void> {
 	const config: Config = {
 		apiKey: state.apiKey,
 		baseUrl: state.baseUrl,
 		userType: "worker",
 	};
 
-	// Step 2: Auto-detect AI Tools
-	const detectedToolsResult = await runToolDetectionStep(prompt, config);
-	state.tools = detectedToolsResult.tools;
-
-	// Step 3: Domains
-	console.log(`${sym.target} ${c.bold("Step 3/6 — Your Domains")}\n`);
-	console.log(`What domains do you work in? ${c.dim("(comma-separated)")}`);
-	console.log(c.dim("Examples: full-stack dev, data engineering, trading, content creation\n"));
-	const domainsInput = await prompt.question(`${sym.arrow} `);
-	const domains = domainsInput.split(",").map(s => s.trim()).filter(Boolean);
-	state.domains = domains;
+	const saveProgress = (step: number) => {
+		saveConfig({ ...config, onboardingStep: step });
+	};
 
-	// Create/update profile
-	console.log(c.dim("\nSaving profile..."));
+	// Step 2: Auto-detect AI Tools
+	if (startStep <= 2) {
+		const detectedToolsResult = await runToolDetectionStep(prompt, config);
+		state.tools = detectedToolsResult.tools;
+		saveProgress(2);
+	}
 
-	try {
-		await api(config, "POST", "/v1/profile", {
-			domains,
-			tools: {
-				primary: state.tools,
-			},
-		});
-		console.log(`${sym.check} Profile saved\n`);
-	} catch (err) {
-		console.log(`${sym.warning} ${c.warning("Could not save profile details — you can update later with 'jobarbiter profile create'")}\n`);
+	// Step 3: Connect AI Accounts (optional)
+	if (startStep <= 3) {
+		await runConnectAIAccountsStep(prompt);
+		saveProgress(3);
 	}
 
-	// Step 4: Connect GitHub (optional)
-	console.log(`${sym.link} ${c.bold("Step 4/6 — Connect GitHub")} ${c.dim("(optional)")}\n`);
-	console.log(`Connecting your GitHub lets us analyze your AI-assisted work patterns.`);
-	console.log(`This significantly boosts your proficiency score.\n`);
+	// Step 4: Domains
+	if (startStep <= 4) {
+		console.log(`${sym.target} ${c.bold("Step 4/7 — Your Domains")}\n`);
+		console.log(`What domains do you work in? ${c.dim("(comma-separated)")}`);
+		console.log(c.dim("Examples: full-stack dev, data engineering, trading, content creation\n"));
+		const domainsInput = await prompt.question(`${sym.arrow} `);
+		const domains = domainsInput.split(",").map(s => s.trim()).filter(Boolean);
+		state.domains = domains;
+
+		// Create/update profile
+		console.log(c.dim("\nSaving profile..."));
 
-	const githubUsername = await prompt.question(`GitHub username ${c.dim("(press Enter to skip)")}: `);
-	
-	if (githubUsername) {
-		console.log(c.dim("\nConnecting GitHub..."));
 		try {
-			await api(config, "POST", "/v1/attestations/git/connect", {
-				provider: "github",
-				username: githubUsername,
+			await api(config, "POST", "/v1/profile", {
+				domains,
+				tools: {
+					primary: state.tools,
+				},
 			});
-			console.log(`${sym.check} GitHub connected: ${c.highlight(githubUsername)}\n`);
-			state.githubUsername = githubUsername;
+			console.log(`${sym.check} Profile saved\n`);
 		} catch (err) {
-			console.log(`${sym.warning} ${c.warning("Could not connect GitHub — you can try later with 'jobarbiter git connect'")}\n`);
+			console.log(`${sym.warning} ${c.warning("Could not save profile details — you can update later with 'jobarbiter profile create'")}\n`);
 		}
-	} else {
-		console.log(`${c.dim("Skipped — you can connect later with 'jobarbiter git connect'")}\n`);
+		saveProgress(4);
 	}
 
-	// Step 5: Connect LinkedIn (optional)
-	console.log(`${sym.link} ${c.bold("Step 5/6 — Connect LinkedIn")} ${c.dim("(optional)")}\n`);
-	console.log(`Your LinkedIn profile strengthens identity verification.`);
-	console.log(c.dim("We never post on your behalf or access your connections.\n"));
+	// Step 5: Connect GitHub (optional)
+	if (startStep <= 5) {
+		console.log(`${sym.link} ${c.bold("Step 5/7 — Connect GitHub")} ${c.dim("(optional)")}\n`);
+		console.log(`Connecting your GitHub lets us analyze your AI-assisted work patterns.`);
+		console.log(`This significantly boosts your proficiency score.\n`);
 
-	const linkedinUrl = await prompt.question(`LinkedIn URL ${c.dim("(press Enter to skip)")}: `);
-	
-	if (linkedinUrl) {
-		console.log(c.dim("\nSubmitting for verification..."));
-		try {
-			await api(config, "POST", "/v1/verification/linkedin", {
-				linkedinUrl: linkedinUrl.trim(),
-			});
-			console.log(`${sym.check} LinkedIn submitted for verification\n`);
-		} catch (err) {
-			console.log(`${sym.warning} ${c.warning("Could not submit LinkedIn — you can try later with 'jobarbiter identity linkedin <url>'")}\n`);
+		const githubUsername = await prompt.question(`GitHub username ${c.dim("(press Enter to skip)")}: `);
+		
+		if (githubUsername) {
+			console.log(c.dim("\nConnecting GitHub..."));
+			try {
+				await api(config, "POST", "/v1/attestations/git/connect", {
+					provider: "github",
+					username: githubUsername,
+				});
+				console.log(`${sym.check} GitHub connected: ${c.highlight(githubUsername)}\n`);
+				state.githubUsername = githubUsername;
+			} catch (err) {
+				console.log(`${sym.warning} ${c.warning("Could not connect GitHub — you can try later with 'jobarbiter git connect'")}\n`);
+			}
+		} else {
+			console.log(`${c.dim("Skipped — you can connect later with 'jobarbiter git connect'")}\n`);
 		}
-	} else {
-		console.log(`${c.dim("Skipped — you can connect later with 'jobarbiter identity linkedin <url>'")}\n`);
+		saveProgress(5);
 	}
 
-	// Step 6: Done!
+	// Step 6: Connect LinkedIn (optional)
+	if (startStep <= 6) {
+		console.log(`${sym.link} ${c.bold("Step 6/7 — Connect LinkedIn")} ${c.dim("(optional)")}\n`);
+		console.log(`Your LinkedIn profile strengthens identity verification.`);
+		console.log(c.dim("We never post on your behalf or access your connections.\n"));
+
+		const linkedinUrl = await prompt.question(`LinkedIn URL ${c.dim("(press Enter to skip)")}: `);
+		
+		if (linkedinUrl) {
+			console.log(c.dim("\nSubmitting for verification..."));
+			try {
+				await api(config, "POST", "/v1/verification/linkedin", {
+					linkedinUrl: linkedinUrl.trim(),
+				});
+				console.log(`${sym.check} LinkedIn submitted for verification\n`);
+			} catch (err) {
+				console.log(`${sym.warning} ${c.warning("Could not submit LinkedIn — you can try later with 'jobarbiter identity linkedin <url>'")}\n`);
+			}
+		} else {
+			console.log(`${c.dim("Skipped — you can connect later with 'jobarbiter identity linkedin <url>'")}\n`);
+		}
+		saveProgress(6);
+	}
+
+	// Step 7: Done!
+	saveConfig({ ...config, onboardingComplete: true, onboardingStep: 7 });
 	showWorkerCompletion(state);
 }
 
@@ -394,15 +456,15 @@ async function runToolDetectionStep(
 	prompt: Prompt,
 	config: Config,
 ): Promise<{ tools: string[] }> {
-	console.log(`🔍 ${c.bold("Step 2/6 — Detecting AI Tools")}\n`);
+	console.log(`🔍 ${c.bold("Step 2/7 — Detecting AI Tools")}\n`);
 	console.log(c.dim("  Scanning your machine...\n"));
 
 	const allTools = detectAllTools();
 	const installed = allTools.filter((t) => t.installed);
-	const notInstalled = allTools.filter((t) => !t.installed && t.category === "coding-agent");
+	const notInstalled = allTools.filter((t) => !t.installed && t.category === "ai-agent");
 
 	// Group by category
-	const codingAgents = installed.filter((t) => t.category === "coding-agent");
+	const codingAgents = installed.filter((t) => t.category === "ai-agent");
 	const chatTools = installed.filter((t) => t.category === "chat");
 	const orchestration = installed.filter((t) => t.category === "orchestration");
 	const apiProviders = installed.filter((t) => t.category === "api-provider");
@@ -416,7 +478,7 @@ async function runToolDetectionStep(
 
 	console.log(`  ${c.bold("Found:")}`);
 
-	// Show coding agents with observer status
+	// Show AI agents with observer status
 	for (const tool of codingAgents) {
 		const display = formatToolDisplay(tool);
 		if (tool.observerAvailable) {
@@ -441,7 +503,7 @@ async function runToolDetectionStep(
 		console.log(`    ${sym.check} ${tool.name} ${c.dim("configured")}`);
 	}
 
-	// Show not-detected coding agents
+	// Show not-detected AI agents
 	if (notInstalled.length > 0) {
 		console.log(`\n  ${c.dim("Not detected (install to track):")}`);
 		for (const tool of notInstalled.slice(0, 5)) {
@@ -455,12 +517,12 @@ async function runToolDetectionStep(
 	// Collect tool names for profile
 	const toolNames = installed.map((t) => t.name);
 
-	// Observer installation for coding agents
+	// Observer installation for AI agents
 	const needsObserver = codingAgents.filter((t) => t.observerAvailable && !t.observerActive);
 
 	if (needsObserver.length > 0) {
 		console.log(`\n  ${c.bold("Observers")}`);
-		console.log(`  JobArbiter observes your coding sessions to build your`);
+		console.log(`  JobArbiter observes your AI sessions to build your`);
 		console.log(`  proficiency profile. ${c.bold("No code or prompts leave your machine")} —`);
 		console.log(`  only aggregate scores (tool usage, session counts, token volume).\n`);
 		console.log(c.dim(`  Data stored locally: ~/.config/jobarbiter/observer/observations.json`));
@@ -517,8 +579,99 @@ async function runToolDetectionStep(
 	return { tools: toolNames };
 }
 
+// ── Connect AI Accounts Step ───────────────────────────────────────────
+
+async function runConnectAIAccountsStep(prompt: Prompt): Promise<void> {
+	console.log(`${sym.link} ${c.bold("Step 3/7 — Connect AI Accounts")} ${c.dim("(optional)")}\n`);
+	
+	console.log(`  Connecting your AI provider accounts lets us analyze usage depth,`);
+	console.log(`  not just tool presence. The more we can see, the stronger your`);
+	console.log(`  verified proficiency profile.\n`);
+	
+	console.log(`  ${c.bold("What we can pull:")}`);
+	console.log(`    ${sym.bullet} Token usage volume and patterns ${c.dim("(how much you use AI)")}`);
+	console.log(`    ${sym.bullet} Model preferences ${c.dim("(which models you reach for)")}`);
+	console.log(`    ${sym.bullet} Session frequency and consistency over time`);
+	console.log(`    ${sym.bullet} API spend patterns ${c.dim("(demonstrates serious usage)")}\n`);
+	
+	console.log(`  ${c.bold("What we NEVER access:")}`);
+	console.log(`    ${sym.bullet} Your conversation content`);
+	console.log(`    ${sym.bullet} Prompts or responses`);
+	console.log(`    ${sym.bullet} Any proprietary or sensitive data\n`);
+
+	// Check for already connected providers
+	const existingProviders = loadProviderKeys();
+	if (existingProviders.length > 0) {
+		console.log(`  ${c.bold("Already connected:")}`);
+		for (const p of existingProviders) {
+			console.log(`    ${sym.check} ${p.provider}`);
+		}
+		console.log();
+	}
+
+	// Show available connections
+	let continueConnecting = true;
+	
+	while (continueConnecting) {
+		console.log(`  ${c.bold("Available connections:")}\n`);
+		console.log(`    ${c.highlight("1.")} Anthropic API key  — Pull Claude usage stats`);
+		console.log(`    ${c.highlight("2.")} OpenAI API key     — Pull GPT/ChatGPT usage stats`);
+		console.log(`    ${c.highlight("3.")} Skip for now\n`);
+		console.log(c.dim(`  You can connect accounts later with 'jobarbiter tokens connect'\n`));
+
+		const choice = await prompt.question(`  Your choice ${c.dim("[1/2/3]")}: `);
+		
+		if (choice === "3" || choice.toLowerCase() === "skip" || choice === "") {
+			console.log(`\n${c.dim("  Skipped — you can connect providers later with 'jobarbiter tokens connect'")}\n`);
+			continueConnecting = false;
+		} else if (choice === "1") {
+			await connectProvider(prompt, "anthropic", "Anthropic");
+			// Ask if they want to connect another
+			continueConnecting = await prompt.confirm(`\n  Connect another provider?`, false);
+			console.log();
+		} else if (choice === "2") {
+			await connectProvider(prompt, "openai", "OpenAI");
+			// Ask if they want to connect another
+			continueConnecting = await prompt.confirm(`\n  Connect another provider?`, false);
+			console.log();
+		} else {
+			console.log(c.error("  Please enter 1, 2, or 3"));
+		}
+	}
+}
+
+async function connectProvider(prompt: Prompt, providerId: string, providerName: string): Promise<void> {
+	console.log(`\n  ${sym.lock} ${c.bold("Privacy Notice")}`);
+	console.log(`  ${c.dim("─".repeat(50))}`);
+	console.log(`  Your API key is stored ${c.bold("locally only")} at:`);
+	console.log(`  ${c.dim("~/.config/jobarbiter/providers.json")}\n`);
+	console.log(`  ${sym.bullet} Keys are ${c.bold("NEVER")} sent to JobArbiter's servers`);
+	console.log(`  ${sym.bullet} Only aggregate stats (token counts, model usage) are submitted`);
+	console.log(`  ${sym.bullet} Revoke anytime: ${c.highlight(`jobarbiter tokens disconnect ${providerId}`)}`);
+	console.log(`  ${c.dim("─".repeat(50))}\n`);
+
+	const apiKey = await prompt.question(`  ${providerName} API key: `);
+	
+	if (!apiKey || apiKey.trim() === "") {
+		console.log(`  ${c.dim("Skipped")}`);
+		return;
+	}
+
+	console.log(c.dim("\n  Validating API key..."));
+	
+	const result = await validateProviderKey(providerId, apiKey.trim());
+	
+	if (result.valid) {
+		saveProviderKey(providerId, apiKey.trim());
+		console.log(`  ${sym.check} ${c.success(`${providerName} connected`)} — ${result.summary}`);
+	} else {
+		console.log(`  ${sym.cross} ${c.error(`Invalid key: ${result.error}`)}`);
+		console.log(`  ${c.dim("You can try again later with 'jobarbiter tokens connect'")}`);
+	}
+}
+
 function showWorkerCompletion(state: OnboardState): void {
-	console.log(`${sym.done} ${c.bold("Step 6/6 — You're In!")}\n`);
+	console.log(`${sym.done} ${c.bold("Step 7/7 — You're In!")}\n`);
 	console.log(`Your profile is live. Here's what happens next:\n`);
 	
 	console.log(`  📊 Your proficiency score builds automatically from:`);

package/src/lib/providers.ts

@@ -0,0 +1,205 @@
+/**
+ * Provider Key Management Module
+ * 
+ * Securely manages API keys for AI providers (Anthropic, OpenAI, etc.)
+ * Keys are stored locally ONLY and never sent to JobArbiter's servers.
+ * Only aggregate usage stats are submitted for proficiency scoring.
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// ── Types ──────────────────────────────────────────────────────────────
+
+export interface ProviderConfig {
+	provider: string;       // "anthropic" | "openai" | "google"
+	apiKey: string;         // stored locally only
+	connectedAt: string;    // ISO timestamp
+	lastSync?: string;      // last time usage data was pulled
+}
+
+export interface ProvidersFile {
+	version: number;
+	providers: ProviderConfig[];
+}
+
+export interface ValidationResult {
+	valid: boolean;
+	error?: string;
+	summary?: string;  // e.g., "1.2M tokens used this month"
+}
+
+// ── Paths ──────────────────────────────────────────────────────────────
+
+const CONFIG_DIR = join(homedir(), ".config", "jobarbiter");
+const PROVIDERS_FILE = join(CONFIG_DIR, "providers.json");
+
+export function getProvidersPath(): string {
+	return PROVIDERS_FILE;
+}
+
+// ── Load / Save ────────────────────────────────────────────────────────
+
+export function loadProviderKeys(): ProviderConfig[] {
+	if (!existsSync(PROVIDERS_FILE)) {
+		return [];
+	}
+
+	try {
+		const raw = readFileSync(PROVIDERS_FILE, "utf-8");
+		const data = JSON.parse(raw) as ProvidersFile;
+		return data.providers || [];
+	} catch {
+		return [];
+	}
+}
+
+export function saveProviderKey(provider: string, apiKey: string): void {
+	mkdirSync(CONFIG_DIR, { recursive: true });
+
+	const existing = loadProviderKeys();
+	
+	// Remove any existing entry for this provider
+	const filtered = existing.filter((p) => p.provider !== provider);
+	
+	// Add new entry
+	filtered.push({
+		provider,
+		apiKey,
+		connectedAt: new Date().toISOString(),
+	});
+
+	const data: ProvidersFile = {
+		version: 1,
+		providers: filtered,
+	};
+
+	writeFileSync(PROVIDERS_FILE, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+}
+
+export function removeProviderKey(provider: string): boolean {
+	const existing = loadProviderKeys();
+	const filtered = existing.filter((p) => p.provider !== provider);
+	
+	if (filtered.length === existing.length) {
+		return false; // Provider not found
+	}
+
+	const data: ProvidersFile = {
+		version: 1,
+		providers: filtered,
+	};
+
+	writeFileSync(PROVIDERS_FILE, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+	return true;
+}
+
+export function getProviderKey(provider: string): ProviderConfig | null {
+	const providers = loadProviderKeys();
+	return providers.find((p) => p.provider === provider) || null;
+}
+
+// ── Validation ─────────────────────────────────────────────────────────
+
+/**
+ * Validate an Anthropic API key by making a test API call.
+ * Returns validation result with usage summary if available.
+ */
+export async function validateAnthropicKey(apiKey: string): Promise<ValidationResult> {
+	try {
+		const response = await fetch("https://api.anthropic.com/v1/models", {
+			method: "GET",
+			headers: {
+				"x-api-key": apiKey,
+				"anthropic-version": "2023-06-01",
+			},
+		});
+
+		if (response.status === 401) {
+			return { valid: false, error: "Invalid API key" };
+		}
+
+		if (response.status === 403) {
+			return { valid: false, error: "API key doesn't have required permissions" };
+		}
+
+		if (!response.ok) {
+			return { valid: false, error: `API error: ${response.status}` };
+		}
+
+		// Key is valid - we can't get usage from this endpoint, 
+		// but we can confirm the key works
+		return {
+			valid: true,
+			summary: "API key validated",
+		};
+	} catch (err) {
+		if (err instanceof Error) {
+			return { valid: false, error: `Connection error: ${err.message}` };
+		}
+		return { valid: false, error: "Unknown error" };
+	}
+}
+
+/**
+ * Validate an OpenAI API key by making a test API call.
+ * Returns validation result with usage summary if available.
+ */
+export async function validateOpenAIKey(apiKey: string): Promise<ValidationResult> {
+	try {
+		const response = await fetch("https://api.openai.com/v1/models", {
+			method: "GET",
+			headers: {
+				"Authorization": `Bearer ${apiKey}`,
+			},
+		});
+
+		if (response.status === 401) {
+			return { valid: false, error: "Invalid API key" };
+		}
+
+		if (response.status === 403) {
+			return { valid: false, error: "API key doesn't have required permissions" };
+		}
+
+		if (!response.ok) {
+			return { valid: false, error: `API error: ${response.status}` };
+		}
+
+		// Key is valid
+		return {
+			valid: true,
+			summary: "API key validated",
+		};
+	} catch (err) {
+		if (err instanceof Error) {
+			return { valid: false, error: `Connection error: ${err.message}` };
+		}
+		return { valid: false, error: "Unknown error" };
+	}
+}
+
+/**
+ * Get list of supported providers.
+ */
+export function getSupportedProviders(): Array<{ id: string; name: string }> {
+	return [
+		{ id: "anthropic", name: "Anthropic" },
+		{ id: "openai", name: "OpenAI" },
+	];
+}
+
+/**
+ * Validate a key for any supported provider.
+ */
+export async function validateProviderKey(provider: string, apiKey: string): Promise<ValidationResult> {
+	switch (provider) {
+		case "anthropic":
+			return validateAnthropicKey(apiKey);
+		case "openai":
+			return validateOpenAIKey(apiKey);
+		default:
+			return { valid: false, error: `Unknown provider: ${provider}` };
+	}
+}