@oh-my-pi/pi-ai 16.2.1 → 16.2.3

package/src/registry/oauth/openai-codex.ts

@@ -3,6 +3,7 @@
  */
 
 import { OPENAI_HEADER_VALUES } from "@oh-my-pi/pi-catalog/wire/codex";
+import * as AIError from "../../error";
 import type { FetchImpl } from "../../types";
 import { isRecord } from "../../utils";
 import { OAuthCallbackFlow, type OAuthCallbackFlowOptions } from "./callback-server";
@@ -175,7 +176,10 @@ async function exchangeCodeForToken(
 
 	if (!tokenResponse.ok) {
 		const bodyText = await tokenResponse.text();
-		throw new Error(`Token exchange failed: ${formatOpenAICodexTokenEndpointError(tokenResponse.status, bodyText)}`);
+		throw new AIError.OAuthError(
+			`Token exchange failed: ${formatOpenAICodexTokenEndpointError(tokenResponse.status, bodyText)}`,
+			{ kind: "token-exchange", status: tokenResponse.status },
+		);
 	}
 
 	const tokenData = (await tokenResponse.json()) as {
@@ -185,12 +189,12 @@ async function exchangeCodeForToken(
 	};
 
 	if (!tokenData.access_token || !tokenData.refresh_token || typeof tokenData.expires_in !== "number") {
-		throw new Error("Token response missing required fields");
+		throw new AIError.OAuthError("Token response missing required fields", { kind: "validation" });
 	}
 
 	const { accountId, email } = getTokenProfile(tokenData.access_token);
 	if (!accountId) {
-		throw new Error("Failed to extract accountId from token");
+		throw new AIError.OAuthError("Failed to extract accountId from token", { kind: "validation" });
 	}
 
 	return {
@@ -235,7 +239,10 @@ export async function loginOpenAICodexDevice(ctrl: OAuthController): Promise<OAu
 	});
 
 	if (!initResponse.ok) {
-		throw new Error(`Device authorization initiation failed: ${initResponse.status}`);
+		throw new AIError.OAuthError(`Device authorization initiation failed: ${initResponse.status}`, {
+			kind: "device-auth",
+			status: initResponse.status,
+		});
 	}
 
 	const initData = (await initResponse.json()) as {
@@ -245,7 +252,7 @@ export async function loginOpenAICodexDevice(ctrl: OAuthController): Promise<OAu
 	};
 
 	if (!initData.device_auth_id || !initData.user_code) {
-		throw new Error("Device authorization response missing required fields");
+		throw new AIError.OAuthError("Device authorization response missing required fields", { kind: "validation" });
 	}
 
 	const userCode = initData.user_code;
@@ -267,7 +274,7 @@ export async function loginOpenAICodexDevice(ctrl: OAuthController): Promise<OAu
 		await Bun.sleep(poll === 0 ? Math.min(pollIntervalMs, DEVICE_POLL_INTERVAL_MS) : pollIntervalMs);
 
 		if (ctrl.signal?.aborted) {
-			throw new Error("Device authorization cancelled");
+			throw new AIError.LoginCancelledError("Device authorization cancelled");
 		}
 
 		const pollResponse = await fetch(DEVICE_TOKEN_URL, {
@@ -286,7 +293,10 @@ export async function loginOpenAICodexDevice(ctrl: OAuthController): Promise<OAu
 		}
 
 		if (!pollResponse.ok) {
-			throw new Error(`Device token polling failed: ${pollResponse.status}`);
+			throw new AIError.OAuthError(`Device token polling failed: ${pollResponse.status}`, {
+				kind: "polling",
+				status: pollResponse.status,
+			});
 		}
 
 		const pollData = (await pollResponse.json()) as {
@@ -295,14 +305,18 @@ export async function loginOpenAICodexDevice(ctrl: OAuthController): Promise<OAu
 		};
 
 		if (!pollData.authorization_code || !pollData.code_verifier) {
-			throw new Error("Device token response missing authorization_code or code_verifier");
+			throw new AIError.OAuthError("Device token response missing authorization_code or code_verifier", {
+				kind: "validation",
+			});
 		}
 
 		ctrl.onProgress?.("Exchanging authorization code for tokens…");
 		return exchangeCodeForToken(pollData.authorization_code, pollData.code_verifier, DEVICE_REDIRECT_URI);
 	}
 
-	throw new Error("Device authorization timed out — user did not complete login in time");
+	throw new AIError.OAuthError("Device authorization timed out — user did not complete login in time", {
+		kind: "timeout",
+	});
 }
 
 /**
@@ -322,8 +336,9 @@ export async function refreshOpenAICodexToken(refreshToken: string): Promise<OAu
 
 	if (!response.ok) {
 		const bodyText = await response.text();
-		throw new Error(
+		throw new AIError.OAuthError(
 			`OpenAI Codex token refresh failed: ${formatOpenAICodexTokenEndpointError(response.status, bodyText)}`,
+			{ kind: "token-refresh", status: response.status },
 		);
 	}
 
@@ -334,7 +349,7 @@ export async function refreshOpenAICodexToken(refreshToken: string): Promise<OAu
 	};
 
 	if (!tokenData.access_token || !tokenData.refresh_token || typeof tokenData.expires_in !== "number") {
-		throw new Error("Token response missing required fields");
+		throw new AIError.OAuthError("Token response missing required fields", { kind: "validation" });
 	}
 
 	const { accountId, email } = getTokenProfile(tokenData.access_token);

package/src/registry/oauth/opencode.ts

@@ -9,6 +9,7 @@
  * 3. User pastes the API key back into the CLI
  */
 
+import * as AIError from "../../error";
 import type { OAuthController } from "./types";
 
 const AUTH_URL = "https://opencode.ai/auth";
@@ -21,7 +22,7 @@ const AUTH_URL = "https://opencode.ai/auth";
  */
 export async function loginOpenCode(options: OAuthController): Promise<string> {
 	if (!options.onPrompt) {
-		throw new Error("OpenCode Zen login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("OpenCode Zen");
 	}
 
 	// Open browser to auth page
@@ -37,12 +38,12 @@ export async function loginOpenCode(options: OAuthController): Promise<string> {
 	});
 
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("API key is required");
+		throw new AIError.ApiKeyRequiredError();
 	}
 
 	return trimmed;

package/src/registry/oauth/perplexity.ts

@@ -14,6 +14,7 @@
 import * as os from "node:os";
 import { $env } from "@oh-my-pi/pi-utils";
 import { $ } from "bun";
+import * as AIError from "../../error";
 import type { OAuthController, OAuthCredentials } from "./types";
 
 const API_VERSION = "2.18";
@@ -87,15 +88,19 @@ async function extractFromNativeApp(): Promise<string | null> {
  */
 async function httpEmailLogin(ctrl: OAuthController): Promise<OAuthCredentials> {
 	if (!ctrl.onPrompt) {
-		throw new Error("Perplexity login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("Perplexity");
 	}
 	const email = await ctrl.onPrompt({
 		message: "Enter your Perplexity email address",
 		placeholder: "user@example.com",
 	});
 	const trimmedEmail = email.trim();
-	if (!trimmedEmail) throw new Error("Email is required for Perplexity login");
-	if (ctrl.signal?.aborted) throw new Error("Login cancelled");
+	if (!trimmedEmail)
+		throw new AIError.OAuthError("Email is required for Perplexity login", {
+			kind: "validation",
+			provider: "perplexity",
+		});
+	if (ctrl.signal?.aborted) throw new AIError.LoginCancelledError();
 
 	ctrl.onProgress?.("Fetching Perplexity CSRF token...");
 	const csrfResponse = await fetch("https://www.perplexity.ai/api/auth/csrf", {
@@ -107,12 +112,18 @@ async function httpEmailLogin(ctrl: OAuthController): Promise<OAuthCredentials>
 	});
 
 	if (!csrfResponse.ok) {
-		throw new Error(`Perplexity CSRF request failed: ${csrfResponse.status}`);
+		throw new AIError.ProviderHttpError(
+			`Perplexity CSRF request failed: ${csrfResponse.status}`,
+			csrfResponse.status,
+		);
 	}
 
 	const csrfData = (await csrfResponse.json()) as { csrfToken?: string };
 	if (!csrfData.csrfToken) {
-		throw new Error("Perplexity CSRF response missing csrfToken");
+		throw new AIError.OAuthError("Perplexity CSRF response missing csrfToken", {
+			kind: "validation",
+			provider: "perplexity",
+		});
 	}
 	ctrl.onProgress?.("Sending login code to your email...");
 	const sendResponse = await fetch("https://www.perplexity.ai/api/auth/signin-email", {
@@ -131,15 +142,19 @@ async function httpEmailLogin(ctrl: OAuthController): Promise<OAuthCredentials>
 
 	if (!sendResponse.ok) {
 		const body = await sendResponse.text();
-		throw new Error(`Perplexity send login code failed (${sendResponse.status}): ${body}`);
+		throw new AIError.ProviderHttpError(
+			`Perplexity send login code failed (${sendResponse.status}): ${body}`,
+			sendResponse.status,
+		);
 	}
 	const otp = await ctrl.onPrompt({
 		message: "Enter the code sent to your email",
 		placeholder: "123456",
 	});
 	const trimmedOtp = otp.trim();
-	if (!trimmedOtp) throw new Error("OTP code is required");
-	if (ctrl.signal?.aborted) throw new Error("Login cancelled");
+	if (!trimmedOtp)
+		throw new AIError.OAuthError("OTP code is required", { kind: "validation", provider: "perplexity" });
+	if (ctrl.signal?.aborted) throw new AIError.LoginCancelledError();
 	ctrl.onProgress?.("Verifying login code...");
 	const verifyResponse = await fetch("https://www.perplexity.ai/api/auth/signin-otp", {
 		method: "POST",
@@ -165,11 +180,18 @@ async function httpEmailLogin(ctrl: OAuthController): Promise<OAuthCredentials>
 
 	if (!verifyResponse.ok) {
 		const reason = verifyData.text ?? verifyData.error_code ?? verifyData.status ?? "OTP verification failed";
-		throw new Error(`Perplexity OTP verification failed: ${reason}`);
+		throw new AIError.OAuthError(`Perplexity OTP verification failed: ${reason}`, {
+			kind: "validation",
+			provider: "perplexity",
+			status: verifyResponse.status,
+		});
 	}
 
 	if (!verifyData.token) {
-		throw new Error("Perplexity OTP verification response missing token");
+		throw new AIError.OAuthError("Perplexity OTP verification response missing token", {
+			kind: "validation",
+			provider: "perplexity",
+		});
 	}
 
 	return jwtToCredentials(verifyData.token, trimmedEmail);
@@ -188,7 +210,7 @@ async function httpEmailLogin(ctrl: OAuthController): Promise<OAuthCredentials>
  */
 export async function loginPerplexity(ctrl: OAuthController): Promise<OAuthCredentials> {
 	if (!ctrl.onPrompt) {
-		throw new Error("Perplexity login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("Perplexity");
 	}
 
 	// Path 1: Native macOS app JWT (skip if PI_AUTH_NO_BORROW=1)

package/src/registry/oauth/xai-oauth.ts

@@ -10,6 +10,7 @@
  * rejected on every call site, not just the first.
  */
 
+import * as AIError from "../../error";
 import type { FetchImpl } from "../../types";
 import { OAuthCallbackFlow, type OAuthCallbackFlowOptions } from "./callback-server";
 import { generatePKCE } from "./pkce";
@@ -54,14 +55,14 @@ export function validateXAIEndpoint(url: string, field: string): string {
 	try {
 		parsed = new URL(url);
 	} catch {
-		throw new Error(`Invalid xAI ${field}: ${url}`);
+		throw new AIError.OAuthError(`Invalid xAI ${field}: ${url}`, { kind: "validation", provider: "xai" });
 	}
 	if (parsed.protocol !== "https:") {
-		throw new Error(`Invalid xAI ${field}: ${url}`);
+		throw new AIError.OAuthError(`Invalid xAI ${field}: ${url}`, { kind: "validation", provider: "xai" });
 	}
 	const host = parsed.hostname.toLowerCase();
 	if (!host || (host !== "x.ai" && !host.endsWith(".x.ai"))) {
-		throw new Error(`Invalid xAI ${field}: ${url}`);
+		throw new AIError.OAuthError(`Invalid xAI ${field}: ${url}`, { kind: "validation", provider: "xai" });
 	}
 	return url;
 }
@@ -84,28 +85,46 @@ async function xaiOAuthDiscovery(
 			signal: AbortSignal.timeout(timeoutMs),
 		});
 	} catch (error) {
-		throw new Error(`xAI OIDC discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+		throw new AIError.OAuthError(
+			`xAI OIDC discovery failed: ${error instanceof Error ? error.message : String(error)}`,
+			{
+				kind: "discovery",
+				provider: "xai",
+				cause: error,
+			},
+		);
 	}
 	if (response.status !== 200) {
-		throw new Error(`xAI OIDC discovery returned status ${response.status}.`);
+		throw new AIError.OAuthError(`xAI OIDC discovery returned status ${response.status}.`, {
+			kind: "discovery",
+			provider: "xai",
+			status: response.status,
+		});
 	}
 	let payload: unknown;
 	try {
 		payload = await response.json();
 	} catch (error) {
-		throw new Error(
+		throw new AIError.OAuthError(
 			`xAI OIDC discovery returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`,
+			{ kind: "validation", provider: "xai", cause: error },
 		);
 	}
 	if (!payload || typeof payload !== "object") {
-		throw new Error("xAI OIDC discovery response was not a JSON object.");
+		throw new AIError.OAuthError("xAI OIDC discovery response was not a JSON object.", {
+			kind: "validation",
+			provider: "xai",
+		});
 	}
 	const obj = payload as Record<string, unknown>;
 	const authorizationEndpoint =
 		typeof obj.authorization_endpoint === "string" ? obj.authorization_endpoint.trim() : "";
 	const tokenEndpoint = typeof obj.token_endpoint === "string" ? obj.token_endpoint.trim() : "";
 	if (!authorizationEndpoint || !tokenEndpoint) {
-		throw new Error("xAI OIDC discovery response was missing required endpoints.");
+		throw new AIError.OAuthError("xAI OIDC discovery response was missing required endpoints.", {
+			kind: "validation",
+			provider: "xai",
+		});
 	}
 	validateXAIEndpoint(authorizationEndpoint, "authorization_endpoint");
 	validateXAIEndpoint(tokenEndpoint, "token_endpoint");
@@ -245,26 +264,40 @@ export class XAIOAuthFlow extends OAuthCallbackFlow {
 			} catch {
 				// Ignore body-read failures; the status code is the diagnostic.
 			}
-			throw new Error(`xAI token exchange failed: ${response.status}${detail ? ` ${detail}` : ""}`);
+			throw new AIError.OAuthError(`xAI token exchange failed: ${response.status}${detail ? ` ${detail}` : ""}`, {
+				kind: "token-exchange",
+				provider: "xai",
+				status: response.status,
+			});
 		}
 
 		let tokenData: { access_token?: unknown; refresh_token?: unknown; expires_in?: unknown };
 		try {
 			tokenData = (await response.json()) as typeof tokenData;
 		} catch (error) {
-			throw new Error(
+			throw new AIError.OAuthError(
 				`xAI token exchange returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`,
+				{ kind: "validation", provider: "xai", cause: error },
 			);
 		}
 
 		if (typeof tokenData.access_token !== "string" || !tokenData.access_token) {
-			throw new Error("xAI token exchange response missing access_token");
+			throw new AIError.OAuthError("xAI token exchange response missing access_token", {
+				kind: "validation",
+				provider: "xai",
+			});
 		}
 		if (typeof tokenData.refresh_token !== "string" || !tokenData.refresh_token) {
-			throw new Error("xAI token exchange response missing refresh_token");
+			throw new AIError.OAuthError("xAI token exchange response missing refresh_token", {
+				kind: "validation",
+				provider: "xai",
+			});
 		}
 		if (typeof tokenData.expires_in !== "number" || !Number.isFinite(tokenData.expires_in)) {
-			throw new Error("xAI token exchange response missing expires_in");
+			throw new AIError.OAuthError("xAI token exchange response missing expires_in", {
+				kind: "validation",
+				provider: "xai",
+			});
 		}
 
 		return {
@@ -292,7 +325,7 @@ export async function loginXAIOAuth(ctrl: OAuthController): Promise<OAuthCredent
 export async function refreshXAIOAuthToken(refreshToken: string, fetchOverride?: FetchImpl): Promise<OAuthCredentials> {
 	const fetchImpl = fetchOverride ?? fetch;
 	if (typeof refreshToken !== "string" || !refreshToken.trim()) {
-		throw new Error("missing refresh_token");
+		throw new AIError.OAuthError("missing refresh_token", { kind: "validation", provider: "xai" });
 	}
 
 	const discovery = await xaiOAuthDiscovery(DISCOVERY_TIMEOUT_MS, fetchImpl);
@@ -321,23 +354,34 @@ export async function refreshXAIOAuthToken(refreshToken: string, fetchOverride?:
 		} catch {
 			// Ignore body-read failures; the status code is the diagnostic.
 		}
-		throw new Error(`xAI token refresh failed: ${response.status}${detail ? ` ${detail}` : ""}`);
+		throw new AIError.OAuthError(`xAI token refresh failed: ${response.status}${detail ? ` ${detail}` : ""}`, {
+			kind: "token-refresh",
+			provider: "xai",
+			status: response.status,
+		});
 	}
 
 	let data: { access_token?: unknown; refresh_token?: unknown; expires_in?: unknown };
 	try {
 		data = (await response.json()) as typeof data;
 	} catch (error) {
-		throw new Error(
+		throw new AIError.OAuthError(
 			`xAI token refresh returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`,
+			{ kind: "validation", provider: "xai", cause: error },
 		);
 	}
 
 	if (typeof data.access_token !== "string" || !data.access_token) {
-		throw new Error("xAI token refresh response missing access_token");
+		throw new AIError.OAuthError("xAI token refresh response missing access_token", {
+			kind: "validation",
+			provider: "xai",
+		});
 	}
 	if (typeof data.expires_in !== "number" || !Number.isFinite(data.expires_in)) {
-		throw new Error("xAI token refresh response missing expires_in");
+		throw new AIError.OAuthError("xAI token refresh response missing expires_in", {
+			kind: "validation",
+			provider: "xai",
+		});
 	}
 
 	const newRefresh = typeof data.refresh_token === "string" && data.refresh_token ? data.refresh_token : refreshToken;

package/src/registry/oauth/xiaomi.ts

@@ -8,6 +8,7 @@
  * login opens plan management so users copy the regional `tp-...` key.
  */
 
+import * as AIError from "../../error";
 import type { FetchImpl } from "../../types";
 import type { OAuthController } from "./types";
 
@@ -103,10 +104,11 @@ async function validateXiaomiApiKey(
 				} catch {
 					// ignore body parse errors, status is enough
 				}
-				lastError = new Error(
+				lastError = new AIError.OAuthError(
 					details
 						? `${PROVIDER_NAME} API key validation failed (${response.status}): ${details}`
 						: `${PROVIDER_NAME} API key validation failed (${response.status})`,
+					{ kind: "validation", provider: PROVIDER_ID, status: response.status },
 				);
 				continue;
 			}
@@ -121,7 +123,11 @@ async function validateXiaomiApiKey(
 			const message = details
 				? `${PROVIDER_NAME} API key validation failed (${response.status}): ${details}`
 				: `${PROVIDER_NAME} API key validation failed (${response.status})`;
-			throw new Error(message);
+			throw new AIError.OAuthError(message, {
+				kind: "validation",
+				provider: PROVIDER_ID,
+				status: response.status,
+			});
 		} catch (e) {
 			// Only re-throw AbortError when the caller explicitly cancelled.
 			// Timeout aborts (from AbortSignal.timeout) should fall through to
@@ -132,7 +138,13 @@ async function validateXiaomiApiKey(
 			lastError = e instanceof Error ? e : new Error(String(e));
 		}
 	}
-	throw lastError ?? new Error(`${PROVIDER_NAME} API key validation failed`);
+	throw (
+		lastError ??
+		new AIError.OAuthError(`${PROVIDER_NAME} API key validation failed`, {
+			kind: "validation",
+			provider: PROVIDER_ID,
+		})
+	);
 }
 
 /**
@@ -144,7 +156,7 @@ async function validateXiaomiApiKey(
 export async function loginXiaomi(options: OAuthController): Promise<string> {
 	const fetchImpl = options.fetch ?? fetch;
 	if (!options.onPrompt) {
-		throw new Error(`${PROVIDER_NAME} login requires onPrompt callback`);
+		throw new AIError.OnPromptRequiredError(PROVIDER_NAME);
 	}
 	options.onAuth?.({
 		url: STANDARD_AUTH_URL,
@@ -155,11 +167,11 @@ export async function loginXiaomi(options: OAuthController): Promise<string> {
 		placeholder: "sk-... or tp-...",
 	});
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("API key is required");
+		throw new AIError.ApiKeyRequiredError();
 	}
 
 	options.onProgress?.(`Validating ${PROVIDER_ID} API key...`);
@@ -175,7 +187,7 @@ export async function loginXiaomi(options: OAuthController): Promise<string> {
 export async function loginXiaomiTokenPlan(options: OAuthController, region: XiaomiTokenPlanRegion): Promise<string> {
 	const fetchImpl = options.fetch ?? fetch;
 	if (!options.onPrompt) {
-		throw new Error(`Xiaomi Token Plan (${TOKEN_PLAN_REGION_NAMES[region]}) login requires onPrompt callback`);
+		throw new AIError.OnPromptRequiredError(`Xiaomi Token Plan (${TOKEN_PLAN_REGION_NAMES[region]})`);
 	}
 	options.onAuth?.({
 		url: TOKEN_PLAN_AUTH_URL,
@@ -186,11 +198,11 @@ export async function loginXiaomiTokenPlan(options: OAuthController, region: Xia
 		placeholder: "tp-...",
 	});
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("API key is required");
+		throw new AIError.ApiKeyRequiredError();
 	}
 
 	options.onProgress?.(`Validating Xiaomi Token Plan (${TOKEN_PLAN_REGION_NAMES[region]}) API key...`);

package/src/registry/ollama-cloud.ts

@@ -1,3 +1,4 @@
+import * as AIError from "../error";
 import type { OAuthController, OAuthLoginCallbacks } from "./oauth/types";
 import type { ProviderDefinition } from "./types";
 
@@ -5,10 +6,10 @@ const OLLAMA_CLOUD_KEYS_URL = "https://ollama.com/settings/keys";
 
 export async function loginOllamaCloud(options: OAuthController): Promise<string> {
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 	if (!options.onPrompt) {
-		throw new Error("Interactive prompt is required for Ollama Cloud login");
+		throw new AIError.ConfigurationError("Interactive prompt is required for Ollama Cloud login");
 	}
 	options.onAuth?.({
 		url: OLLAMA_CLOUD_KEYS_URL,
@@ -19,11 +20,11 @@ export async function loginOllamaCloud(options: OAuthController): Promise<string
 		placeholder: "ollama-cloud-api-key",
 	});
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("Ollama Cloud API key is required");
+		throw new AIError.ApiKeyRequiredError("Ollama Cloud API key is required");
 	}
 	return trimmed;
 }

package/src/registry/ollama.ts

@@ -1,3 +1,4 @@
+import * as AIError from "../error";
 import type { OAuthController } from "./oauth/types";
 import type { ProviderDefinition } from "./types";
 
@@ -10,7 +11,7 @@ const OLLAMA_DOCS_URL = "https://github.com/ollama/ollama/blob/main/docs/api.md"
  */
 export async function loginOllama(options: OAuthController): Promise<string> {
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 	if (!options.onPrompt) {
 		return "";
@@ -29,7 +30,7 @@ export async function loginOllama(options: OAuthController): Promise<string> {
 	});
 
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 
 	return apiKey.trim();

package/src/registry/parallel.ts

@@ -1,3 +1,4 @@
+import * as AIError from "../error";
 import type { OAuthController, OAuthLoginCallbacks } from "./oauth/types";
 import type { ProviderDefinition } from "./types";
 
@@ -11,7 +12,7 @@ const AUTH_URL = "https://platform.parallel.ai/settings?tab=api-keys";
  */
 export async function loginParallel(options: OAuthController): Promise<string> {
 	if (!options.onPrompt) {
-		throw new Error("Parallel login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("Parallel");
 	}
 
 	options.onAuth?.({
@@ -25,12 +26,12 @@ export async function loginParallel(options: OAuthController): Promise<string> {
 	});
 
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("API key is required");
+		throw new AIError.ApiKeyRequiredError();
 	}
 
 	return trimmed;

package/src/registry/qwen-portal.ts

@@ -1,3 +1,4 @@
+import * as AIError from "../error";
 import { validateOpenAICompatibleApiKey } from "./api-key-validation";
 import type { OAuthController, OAuthLoginCallbacks } from "./oauth/types";
 import type { ProviderDefinition } from "./types";
@@ -8,7 +9,7 @@ const VALIDATION_MODEL = "coder-model";
 
 export async function loginQwenPortal(options: OAuthController): Promise<string> {
 	if (!options.onPrompt) {
-		throw new Error("Qwen Portal login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("Qwen Portal");
 	}
 
 	options.onAuth?.({
@@ -22,12 +23,12 @@ export async function loginQwenPortal(options: OAuthController): Promise<string>
 	});
 
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 
 	const trimmed = token.trim();
 	if (!trimmed) {
-		throw new Error("Qwen token/API key is required");
+		throw new AIError.ApiKeyRequiredError("Qwen token/API key is required");
 	}
 
 	options.onProgress?.("Validating credentials...");

package/src/registry/tavily.ts

@@ -1,3 +1,4 @@
+import * as AIError from "../error";
 import type { OAuthLoginCallbacks } from "./oauth/types";
 import type { ProviderDefinition } from "./types";
 
@@ -11,7 +12,7 @@ const AUTH_URL = "https://app.tavily.com/home";
  */
 export async function loginTavily(options: OAuthLoginCallbacks): Promise<string> {
 	if (!options.onPrompt) {
-		throw new Error("Tavily login requires onPrompt callback");
+		throw new AIError.OnPromptRequiredError("Tavily");
 	}
 
 	options.onAuth?.({
@@ -25,12 +26,12 @@ export async function loginTavily(options: OAuthLoginCallbacks): Promise<string>
 	});
 
 	if (options.signal?.aborted) {
-		throw new Error("Login cancelled");
+		throw new AIError.LoginCancelledError();
 	}
 
 	const trimmed = apiKey.trim();
 	if (!trimmed) {
-		throw new Error("API key is required");
+		throw new AIError.ApiKeyRequiredError();
 	}
 
 	return trimmed;